# junn4423/chamcong-nhandien-camera-desktop architecture

> Architecture diagram of the GitHub repository junn4423/chamcong-nhandien-camera-desktop, 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/junn4423/chamcong-nhandien-camera-desktop
- Repository: https://github.com/junn4423/chamcong-nhandien-camera-desktop

## Overview

SOF Face AI Desktop is an Electron/React administration client for face-recognition attendance, employee and camera management, reporting, and ERP synchronization. The main workflow routes users to attendance and management screens, uses the shared API client to reach the deployed SOF gateway, and supports local pending attendance data for later ERP push. Camera discovery and camera-speaker playback are desktop-specific capabilities. The graph follows documented capabilities and shown imports/calls; several page and service implementations were not excerpted, so their internal connections are omitted.

Main entry points: [`src/App.jsx`](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/App.jsx) (Route and module gates), [`src/services/api.js`](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/api.js) (Domain API facade), [`src/pages/Attendance.jsx`](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/Attendance.jsx) (Live attendance), [`electron/main.js`](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/electron/main.js) (Electron shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_app["Route and module gates<br/>[App.jsx]"]
end

subgraph group_workflows["Attendance workflows"]
  node_attendance["Live attendance<br/>[Attendance.jsx]"]
  node_registration["Face registration<br/>[Register.jsx]"]
  node_faces["Face management<br/>[ManageFaces.jsx]"]
  node_cameras["Camera management<br/>[Cameras.jsx]"]
  node_sync["Employee sync verify<br/>[SyncVerify.jsx]"]
  node_reports["Attendance reports<br/>[Report.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
end

subgraph group_services["Client services"]
  node_device[("Device data and queue")]
  node_api["Domain API facade<br/>[api.js]"]
  node_api_modules["Domain API modules"]
  node_request["Gateway request client<br/>[request.js]"]
  node_target["Gateway target config"]
  node_channel["AI channel selection<br/>[channelService.js]"]
  node_settings["Attendance settings"]
  node_module_settings["Module settings<br/>[moduleSettings.js]"]
end

subgraph group_desktop["Camera integrations"]
  node_shell["Electron shell<br/>[main.js]"]
  node_speaker_service["Speaker configuration"]
  node_speaker_modal["Speaker settings UI"]
  node_discovery_ui["Camera discovery UI"]
  node_discovery["Camera discovery"]
  node_speaker_client["RTSP speaker client"]
end

node_user(("Administrator / employee"))
node_gateway[("SOF gateway / backend")]
node_erp[("ERP service")]

node_user -->|"uses"| node_app
node_shell -->|"loads frontend"| node_app
node_app -->|"routes to"| node_attendance
node_app -->|"routes to"| node_registration
node_app -->|"routes to"| node_faces
node_app -->|"routes to"| node_cameras
node_app -->|"routes to"| node_sync
node_app -->|"routes to"| node_reports
node_app -->|"routes to"| node_dashboard
node_app -->|"checks modules"| node_module_settings
node_attendance -->|"requests data"| node_api
node_registration -->|"requests data"| node_api
node_faces -->|"requests data"| node_api
node_cameras -->|"requests data"| node_api
node_sync -->|"requests data"| node_api
node_reports -->|"requests data"| node_api
node_dashboard -->|"requests data"| node_api
node_api -->|"aggregates"| node_api_modules
node_api -->|"uses"| node_request
node_request -->|"resolves gateway"| node_target
node_request -->|"sends requests"| node_gateway
node_device -->|"pushes attendance"| node_api
node_device -->|"syncs pending records"| node_erp
node_channel -->|"checks AI host"| node_request
node_attendance -->|"loads settings"| node_settings
node_attendance -->|"loads speaker config"| node_speaker_service
node_attendance -->|"opens settings"| node_speaker_modal
node_speaker_modal -->|"configures speaker"| node_speaker_service
node_discovery_ui -->|"uses API"| node_api
node_shell -->|"dispatches scans"| node_discovery
node_shell -->|"dispatches playback"| node_speaker_client
node_speaker_service -->|"invokes IPC"| node_shell

click node_shell "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/electron/main.js"
click node_app "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/App.jsx"
click node_attendance "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/Attendance.jsx"
click node_registration "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/Register.jsx"
click node_faces "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/ManageFaces.jsx"
click node_cameras "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/Cameras.jsx"
click node_sync "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/SyncVerify.jsx"
click node_reports "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/Report.jsx"
click node_dashboard "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/Dashboard.jsx"
click node_device "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/deviceDataService.js"
click node_api "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/api.js"
click node_api_modules "https://github.com/junn4423/chamcong-nhandien-camera-desktop/tree/main/src/services/modules"
click node_request "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/request.js"
click node_target "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/connectionTarget.js"
click node_channel "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/channelService.js"
click node_settings "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/attendanceSettings.js"
click node_module_settings "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/moduleSettings.js"
click node_speaker_service "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/cameraSpeakerService.js"
click node_speaker_modal "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/components/CameraSpeakerSettingsModal.jsx"
click node_discovery_ui "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/components/CameraDiscoveryWizard.jsx"
click node_discovery "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/electron/cameraDiscoveryService.js"
click node_speaker_client "https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/electron/cameraSpeakerClient.js"

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_app toneBlue
class node_attendance,node_registration,node_faces,node_cameras,node_sync,node_reports,node_dashboard,node_gateway,node_erp toneAmber
class node_device,node_api,node_api_modules,node_request,node_target,node_channel,node_settings,node_module_settings toneMint
class node_shell,node_speaker_service,node_speaker_modal,node_discovery_ui,node_discovery,node_speaker_client toneRose
class node_user toneIndigo
```

## Components

### Desktop application

- [Route and module gates](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/App.jsx): `src/App.jsx`

### Attendance workflows

- [Live attendance](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/Attendance.jsx): `src/pages/Attendance.jsx`
- [Face registration](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/Register.jsx): `src/pages/Register.jsx`
- [Face management](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/ManageFaces.jsx): `src/pages/ManageFaces.jsx`
- [Camera management](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/Cameras.jsx): `src/pages/Cameras.jsx`
- [Employee sync verify](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/SyncVerify.jsx): `src/pages/SyncVerify.jsx`
- [Attendance reports](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/Report.jsx): `src/pages/Report.jsx`
- [Dashboard](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`

### Client services

- [Device data and queue](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/deviceDataService.js): `src/services/deviceDataService.js`
- [Domain API facade](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/api.js): `src/services/api.js`
- [Domain API modules](https://github.com/junn4423/chamcong-nhandien-camera-desktop/tree/main/src/services/modules): `src/services/modules`
- [Gateway request client](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/request.js): `src/services/request.js`
- [Gateway target config](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/connectionTarget.js): `src/services/connectionTarget.js`
- [AI channel selection](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/channelService.js): `src/services/channelService.js`
- [Attendance settings](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/attendanceSettings.js): `src/services/attendanceSettings.js`
- [Module settings](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/moduleSettings.js): `src/services/moduleSettings.js`

### Camera integrations

- [Electron shell](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/electron/main.js): `electron/main.js`
- [Speaker configuration](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/services/cameraSpeakerService.js): `src/services/cameraSpeakerService.js`
- [Speaker settings UI](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/components/CameraSpeakerSettingsModal.jsx): `src/components/CameraSpeakerSettingsModal.jsx`
- [Camera discovery UI](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/src/components/CameraDiscoveryWizard.jsx): `src/components/CameraDiscoveryWizard.jsx`
- [Camera discovery](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/electron/cameraDiscoveryService.js): `electron/cameraDiscoveryService.js`
- [RTSP speaker client](https://github.com/junn4423/chamcong-nhandien-camera-desktop/blob/main/electron/cameraSpeakerClient.js): `electron/cameraSpeakerClient.js`

### Other components

- **Administrator / employee**
- **SOF gateway / backend**
- **ERP service**

## Connections

- Administrator / employee → Route and module gates: uses
- Electron shell → Route and module gates: loads frontend (evidence: `electron/main.js`)
- Route and module gates → Live attendance: routes to (evidence: `src/App.jsx`)
- Route and module gates → Face registration: routes to (evidence: `src/App.jsx`)
- Route and module gates → Face management: routes to (evidence: `src/App.jsx`)
- Route and module gates → Camera management: routes to (evidence: `src/App.jsx`)
- Route and module gates → Employee sync verify: routes to (evidence: `src/App.jsx`)
- Route and module gates → Attendance reports: routes to (evidence: `src/App.jsx`)
- Route and module gates → Dashboard: routes to (evidence: `src/App.jsx`)
- Route and module gates → Module settings: checks modules (evidence: `src/App.jsx`)
- Live attendance → Domain API facade: requests data (evidence: `src/pages/Attendance.jsx`)
- Face registration → Domain API facade: requests data (evidence: `src/pages/Register.jsx`)
- Face management → Domain API facade: requests data (evidence: `src/pages/ManageFaces.jsx`)
- Camera management → Domain API facade: requests data (evidence: `src/pages/Cameras.jsx`)
- Employee sync verify → Domain API facade: requests data (evidence: `src/pages/SyncVerify.jsx`)
- Attendance reports → Domain API facade: requests data (evidence: `src/pages/Report.jsx`)
- Dashboard → Domain API facade: requests data (evidence: `src/pages/Dashboard.jsx`)
- Domain API facade → Domain API modules: aggregates (evidence: `src/services/api.js`)
- Domain API facade → Gateway request client: uses (evidence: `src/services/api.js`)
- Gateway request client → Gateway target config: resolves gateway (evidence: `src/services/request.js`)
- Gateway request client → SOF gateway / backend: sends requests
- Device data and queue → Domain API facade: pushes attendance (evidence: `src/services/deviceDataService.js`)
- Device data and queue → ERP service: syncs pending records (evidence: `src/services/deviceDataService.js`)
- AI channel selection → Gateway request client: checks AI host (evidence: `src/services/channelService.js`)
- Live attendance → Attendance settings: loads settings (evidence: `src/pages/Attendance.jsx`)
- Live attendance → Speaker configuration: loads speaker config (evidence: `src/pages/Attendance.jsx`)
- Live attendance → Speaker settings UI: opens settings (evidence: `src/pages/Attendance.jsx`)
- Speaker settings UI → Speaker configuration: configures speaker (evidence: `src/components/CameraSpeakerSettingsModal.jsx`)
- Camera discovery UI → Domain API facade: uses API (evidence: `src/components/CameraDiscoveryWizard.jsx`)
- Electron shell → Camera discovery: dispatches scans (evidence: `electron/main.js`)
- Electron shell → RTSP speaker client: dispatches playback (evidence: `electron/main.js`)
- Speaker configuration → Electron shell: invokes IPC (evidence: `src/services/cameraSpeakerService.js`)
