# hieutuoitre/pbl4 architecture

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

- Interactive diagram: https://gitdiagram.com/hieutuoitre/pbl4
- Repository: https://github.com/hieutuoitre/pbl4

## Overview

PBL4 is a Windows remote-device control system: a controlled-device client runs a background TCP server, while a manager application is intended to connect and control it. The client workflow dispatches incoming protocol messages to input injection, file browsing/download, and system monitoring, while sending screen and audio data. The README only identifies the two executables; manager-side feature details are therefore represented by their source modules and shared protocol, without inferring unshown call relationships.

Main entry points: [`Client/Core/SessionManager.cpp`](https://github.com/hieutuoitre/pbl4/blob/main/Client/Core/SessionManager.cpp) (Session Manager), [`Manager/Core/ManagerMain.cpp`](https://github.com/hieutuoitre/pbl4/blob/main/Manager/Core/ManagerMain.cpp) (Manager Startup), [`Client/Core/ClientMain.cpp`](https://github.com/hieutuoitre/pbl4/blob/main/Client/Core/ClientMain.cpp) (Client Startup), [`Shared/Network.cpp`](https://github.com/hieutuoitre/pbl4/blob/main/Shared/Network.cpp) (TCP Transport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Controlled Client"]
  node_client_main["Client Startup<br/>[ClientMain.cpp]"]
  node_session["Session Manager<br/>[SessionManager.cpp]"]
  node_tray["System Tray<br/>[TrayIcon.cpp]"]
end

subgraph group_manager["Manager App"]
  node_manager_main["Manager Startup<br/>[ManagerMain.cpp]"]
  node_receiver["Data Receiver<br/>[DataReceiver.cpp]"]
  node_manager_input["Input Handler<br/>[InputHandler.cpp]"]
  node_file_manager["File Saving<br/>[FileManger.cpp]"]
  node_audio_player["Audio Playback<br/>[AudioPlayer.cpp]"]
end

subgraph group_shared["Shared Runtime"]
  node_network["TCP Transport<br/>[Network.cpp]"]
  node_protocol["Message Protocol<br/>[Protocol.h]"]
end

subgraph group_features["Client Capabilities"]
  node_screen["Screen Capture<br/>[ScreenCapture.cpp]"]
  node_audio_capture["Audio Capture<br/>[AudioCapture.cpp]"]
  node_input["Input Injection<br/>[InputInjector.cpp]"]
  node_monitor["System Monitor<br/>[SysMonitor.cpp]"]
  node_file_worker["File Browsing and Read<br/>[FileWorker.cpp]"]
end

node_operator(("Operator"))

node_operator -.->|"starts"| node_manager_main
node_client_main -->|"initializes"| node_network
node_client_main -->|"initializes"| node_tray
node_client_main -->|"starts"| node_session
node_session -->|"serves connections"| node_network
node_session -->|"captures frames"| node_screen
node_session -->|"starts capture"| node_audio_capture
node_session -->|"injects events"| node_input
node_session -->|"requests metrics"| node_monitor
node_session -->|"browses and reads"| node_file_worker
node_manager_main -->|"uses transport"| node_network
node_manager_main -.-> node_receiver
node_manager_main -.-> node_manager_input
node_manager_main -.-> node_file_manager
node_manager_main -.-> node_audio_player

click node_client_main "https://github.com/hieutuoitre/pbl4/blob/main/Client/Core/ClientMain.cpp"
click node_session "https://github.com/hieutuoitre/pbl4/blob/main/Client/Core/SessionManager.cpp"
click node_tray "https://github.com/hieutuoitre/pbl4/blob/main/Client/Core/TrayIcon.cpp"
click node_network "https://github.com/hieutuoitre/pbl4/blob/main/Shared/Network.cpp"
click node_protocol "https://github.com/hieutuoitre/pbl4/blob/main/Shared/Protocol.h"
click node_screen "https://github.com/hieutuoitre/pbl4/blob/main/Client/Media/ScreenCapture.cpp"
click node_audio_capture "https://github.com/hieutuoitre/pbl4/blob/main/Client/Media/AudioCapture.cpp"
click node_input "https://github.com/hieutuoitre/pbl4/blob/main/Client/System/InputInjector.cpp"
click node_monitor "https://github.com/hieutuoitre/pbl4/blob/main/Client/System/SysMonitor.cpp"
click node_file_worker "https://github.com/hieutuoitre/pbl4/blob/main/Client/FileTransfer/FileWorker.cpp"
click node_manager_main "https://github.com/hieutuoitre/pbl4/blob/main/Manager/Core/ManagerMain.cpp"
click node_receiver "https://github.com/hieutuoitre/pbl4/blob/main/Manager/Core/DataReceiver.cpp"
click node_manager_input "https://github.com/hieutuoitre/pbl4/blob/main/Manager/UI/InputHandler.cpp"
click node_file_manager "https://github.com/hieutuoitre/pbl4/blob/main/Manager/FileTransfer/FileManger.cpp"
click node_audio_player "https://github.com/hieutuoitre/pbl4/blob/main/Manager/Media/AudioPlayer.cpp"

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_client_main,node_session,node_tray toneBlue
class node_manager_main,node_receiver,node_manager_input,node_file_manager,node_audio_player toneAmber
class node_network,node_protocol toneMint
class node_screen,node_audio_capture,node_input,node_monitor,node_file_worker toneRose
class node_operator toneIndigo
```

## Components

### Controlled Client

- [Client Startup](https://github.com/hieutuoitre/pbl4/blob/main/Client/Core/ClientMain.cpp): `Client/Core/ClientMain.cpp`
- [Session Manager](https://github.com/hieutuoitre/pbl4/blob/main/Client/Core/SessionManager.cpp): `Client/Core/SessionManager.cpp`
- [System Tray](https://github.com/hieutuoitre/pbl4/blob/main/Client/Core/TrayIcon.cpp): `Client/Core/TrayIcon.cpp`

### Manager App

- [Manager Startup](https://github.com/hieutuoitre/pbl4/blob/main/Manager/Core/ManagerMain.cpp): `Manager/Core/ManagerMain.cpp`
- [Data Receiver](https://github.com/hieutuoitre/pbl4/blob/main/Manager/Core/DataReceiver.cpp): `Manager/Core/DataReceiver.cpp`
- [Input Handler](https://github.com/hieutuoitre/pbl4/blob/main/Manager/UI/InputHandler.cpp): `Manager/UI/InputHandler.cpp`
- [File Saving](https://github.com/hieutuoitre/pbl4/blob/main/Manager/FileTransfer/FileManger.cpp): `Manager/FileTransfer/FileManger.cpp`
- [Audio Playback](https://github.com/hieutuoitre/pbl4/blob/main/Manager/Media/AudioPlayer.cpp): `Manager/Media/AudioPlayer.cpp`

### Shared Runtime

- [TCP Transport](https://github.com/hieutuoitre/pbl4/blob/main/Shared/Network.cpp): `Shared/Network.cpp`
- [Message Protocol](https://github.com/hieutuoitre/pbl4/blob/main/Shared/Protocol.h): `Shared/Protocol.h`

### Client Capabilities

- [Screen Capture](https://github.com/hieutuoitre/pbl4/blob/main/Client/Media/ScreenCapture.cpp): `Client/Media/ScreenCapture.cpp`
- [Audio Capture](https://github.com/hieutuoitre/pbl4/blob/main/Client/Media/AudioCapture.cpp): `Client/Media/AudioCapture.cpp`
- [Input Injection](https://github.com/hieutuoitre/pbl4/blob/main/Client/System/InputInjector.cpp): `Client/System/InputInjector.cpp`
- [System Monitor](https://github.com/hieutuoitre/pbl4/blob/main/Client/System/SysMonitor.cpp): `Client/System/SysMonitor.cpp`
- [File Browsing and Read](https://github.com/hieutuoitre/pbl4/blob/main/Client/FileTransfer/FileWorker.cpp): `Client/FileTransfer/FileWorker.cpp`

### Other components

- **Operator**

## Connections

- Operator → Manager Startup: starts (evidence: `README.md`)
- Client Startup → TCP Transport: initializes (evidence: `Client/Core/ClientMain.cpp`)
- Client Startup → System Tray: initializes (evidence: `Client/Core/ClientMain.cpp`)
- Client Startup → Session Manager: starts (evidence: `Client/Core/ClientMain.cpp`)
- Session Manager → TCP Transport: serves connections (evidence: `Client/Core/SessionManager.cpp`)
- Session Manager → Screen Capture: captures frames (evidence: `Client/Core/SessionManager.cpp`)
- Session Manager → Audio Capture: starts capture (evidence: `Client/Core/SessionManager.cpp`)
- Session Manager → Input Injection: injects events (evidence: `Client/Core/SessionManager.cpp`)
- Session Manager → System Monitor: requests metrics (evidence: `Client/Core/SessionManager.cpp`)
- Session Manager → File Browsing and Read: browses and reads (evidence: `Client/Core/SessionManager.cpp`)
- Manager Startup → TCP Transport: uses transport (evidence: `Manager/Core/ManagerMain.cpp`)
- Manager Startup → Data Receiver
- Manager Startup → Input Handler
- Manager Startup → File Saving
- Manager Startup → Audio Playback
