# hicool-ml/tp-link-broadband-dialer architecture

> Architecture diagram of the GitHub repository hicool-ml/tp-link-broadband-dialer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hicool-ml/tp-link-broadband-dialer
- Repository: https://github.com/hicool-ml/tp-link-broadband-dialer

## Overview

This repository is a Windows TP-Link broadband dialer with a companion shutdown-cleanup service. The documented user workflow is to configure router credentials, initiate PPPoE connection, then disconnect or rely on shutdown cleanup to clear credentials. The tree does not contain the documented main dialer GUI, so its connection workflow cannot be mapped to source components. The graph focuses on the available configuration, router-cleanup, and service-management code; bundled Playwright copies are runtime dependencies, not product subsystems.

Main entry points: [`config_manager.py`](https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/config_manager.py) (Config manager), [`shutdown_cleanup_service_v2.py`](https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/shutdown_cleanup_service_v2.py) (Shutdown service), [`20260325/service_http.py`](https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/20260325/service_http.py) (HTTP cleanup service), [`tplink_http_cleaner.py`](https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/tplink_http_cleaner.py) (HTTP cleaner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_config["Configuration"]
  node_config_mgr["Config manager<br/>[config_manager.py]"]
  node_config_store[("User config file")]
end

subgraph group_cleanup["Router cleanup"]
  node_http_cleaner["HTTP cleaner"]
  node_http_service["HTTP cleanup service<br/>[service_http.py]"]
end

subgraph group_service["Service management"]
  node_shutdown_service["Shutdown service"]
  node_installer["Service installer"]
  node_browser_mgr["Browser manager<br/>[browser_manager.py]"]
end

node_user(("Dialer user"))
node_shutdown(("Windows shutdown"))
node_router{{"TP-Link router"}}

node_user -->|"configures"| node_config_mgr
node_config_mgr -->|"reads and writes"| node_config_store
node_installer -->|"uses settings"| node_config_mgr
node_http_service -->|"loads settings"| node_config_mgr
node_http_service -->|"uses cleaner"| node_http_cleaner
node_shutdown -.->|"triggers cleanup"| node_shutdown_service
node_shutdown_service -->|"loads settings"| node_config_mgr
node_shutdown_service -->|"uses browser"| node_browser_mgr
node_http_cleaner -.->|"clears credentials"| node_router
node_shutdown_service -.->|"clears credentials"| node_router

click node_config_mgr "https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/config_manager.py"
click node_http_cleaner "https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/tplink_http_cleaner.py"
click node_http_service "https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/20260325/service_http.py"
click node_shutdown_service "https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/shutdown_cleanup_service_v2.py"
click node_installer "https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/service_installer.py"
click node_browser_mgr "https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/browser_manager.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_config_mgr,node_config_store,node_user toneBlue
class node_http_cleaner,node_http_service toneAmber
class node_shutdown_service,node_installer,node_browser_mgr,node_router toneMint
class node_shutdown toneIndigo
```

## Components

### Configuration

- [Config manager](https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/config_manager.py): `config_manager.py`
- **User config file**

### Router cleanup

- [HTTP cleaner](https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/tplink_http_cleaner.py): `tplink_http_cleaner.py`
- [HTTP cleanup service](https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/20260325/service_http.py): `20260325/service_http.py`

### Service management

- [Shutdown service](https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/shutdown_cleanup_service_v2.py): `shutdown_cleanup_service_v2.py`
- [Service installer](https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/service_installer.py): `service_installer.py`
- [Browser manager](https://github.com/hicool-ml/tp-link-broadband-dialer/blob/main/browser_manager.py): `browser_manager.py`

### Other components

- **Dialer user**
- **Windows shutdown**
- **TP-Link router**

## Connections

- Dialer user → Config manager: configures (evidence: `README.md`)
- Config manager → User config file: reads and writes (evidence: `config_manager.py`)
- Service installer → Config manager: uses settings (evidence: `service_installer.py`)
- HTTP cleanup service → Config manager: loads settings (evidence: `20260325/service_http.py`)
- HTTP cleanup service → HTTP cleaner: uses cleaner (evidence: `20260325/service_http.py`)
- Windows shutdown → Shutdown service: triggers cleanup (evidence: `README.md`)
- Shutdown service → Config manager: loads settings (evidence: `shutdown_cleanup_service_v2.py`)
- Shutdown service → Browser manager: uses browser (evidence: `shutdown_cleanup_service_v2.py`)
- HTTP cleaner → TP-Link router: clears credentials
- Shutdown service → TP-Link router: clears credentials (evidence: `README.md`)
