# xiaoxigua0503/dangdangvoice architecture

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

- Interactive diagram: https://gitdiagram.com/xiaoxigua0503/dangdangvoice
- Repository: https://github.com/xiaoxigua0503/dangdangvoice

## Overview

Dangdangvoice is a browser-based product-review analysis service. Users submit a product or sample, the browser calls the server analysis API and presents results; accounts, cloud history, and the optional Pro AI report extend that workflow. The AI path plans jobs, processes text/image units in a worker, validates findings, and serves reports and evidence. Groups reflect the product’s main user-facing and processing capabilities. Evidence is limited to the excerpts, source-index references, and explicit documentation available here; unsampled feature links are omitted where ownership is uncertain.

Main entry points: [`server/ai-worker-core.mjs`](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-worker-core.mjs) (Unit processing), [`src/App.tsx`](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/App.tsx) (Analysis workspace), [`server.mjs`](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server.mjs) (HTTP router and collector), [`server/ai-jobs.mjs`](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-jobs.mjs) (Job planning and reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser experience"]
  node_app["Analysis workspace<br/>[App.tsx]"]
  node_client_api["Client API and archive<br/>[api.ts]"]
  node_report_ui["Pro report view<br/>[AIReport.tsx]"]
  node_account_ui["Account and cloud history<br/>[Account.tsx]"]
  node_admin_ui["Admin console<br/>[Admin.tsx]"]
  node_widgets["Analysis visualizations<br/>[widgets.tsx]"]
  node_desk["Review desk<br/>[Desk.tsx]"]
  node_library["Saved library<br/>[Library.tsx]"]
end

subgraph group_server["HTTP and analysis"]
  node_server["HTTP router and collector<br/>[server.mjs]"]
  node_analysis_api["Analysis endpoints<br/>[server.mjs]"]
end

subgraph group_ai["AI reports"]
  node_ai_api["AI job endpoints<br/>[ai-api.mjs]"]
  node_job_planner["Job planning and reports<br/>[ai-jobs.mjs]"]
  node_worker["AI worker loop<br/>[ai-worker.mjs]"]
  node_worker_core["Unit processing<br/>[ai-worker-core.mjs]"]
  node_provider["Model provider<br/>[ai-provider.mjs]"]
  node_evidence["Evidence validation<br/>[ai-evidence.mjs]"]
  node_images["Image download<br/>[ai-images.mjs]"]
  node_ai_config["AI configuration<br/>[ai-config.mjs]"]
end

subgraph group_accounts["Accounts and administration"]
  node_accounts_api["Account services<br/>[accounts.mjs]"]
  node_admin_api["Admin services<br/>[admin-api.mjs]"]
end

subgraph group_storage["Persistence"]
  node_db[("PostgreSQL<br/>[db.mjs]")]
end

node_user(("Product reviewer"))
node_account_user(("Account holder"))
node_model_service{{"AI model service"}}

node_user -->|"submits reviews"| node_app
node_app -->|"requests analysis"| node_client_api
node_app -->|"renders results"| node_widgets
node_app -->|"opens report"| node_report_ui
node_app -->|"opens desk"| node_desk
node_app -->|"opens library"| node_library
node_client_api -->|"sends requests"| node_server
node_server -->|"handles analysis"| node_analysis_api
node_server -->|"dispatches requests"| node_admin_api
node_server -->|"dispatches requests"| node_ai_api
node_account_user -->|"manages account"| node_account_ui
node_account_ui -->|"calls account API"| node_client_api
node_admin_ui -->|"calls admin API"| node_client_api
node_admin_api -->|"reads and writes"| node_db
node_accounts_api -->|"stores account data"| node_db
node_server -->|"dispatches requests"| node_accounts_api
node_report_ui -->|"loads jobs and evidence"| node_ai_api
node_ai_api -->|"uses job services"| node_job_planner
node_job_planner -->|"plans and stores jobs"| node_db
node_worker -->|"runs units"| node_worker_core
node_worker_core -->|"claims and stores units"| node_db
node_worker_core -->|"finalizes jobs"| node_job_planner
node_worker_core -->|"requests inference"| node_provider
node_provider -.->|"sends model requests"| node_model_service
node_worker_core -->|"validates findings"| node_evidence
node_worker_core -->|"downloads images"| node_images
node_worker_core -->|"uses configuration"| node_ai_config
node_job_planner -->|"reads configuration"| node_ai_config

click node_app "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/App.tsx"
click node_client_api "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/api.ts"
click node_report_ui "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/AIReport.tsx"
click node_account_ui "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/Account.tsx"
click node_admin_ui "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/Admin.tsx"
click node_widgets "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/widgets.tsx"
click node_desk "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/Desk.tsx"
click node_library "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/Library.tsx"
click node_server "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server.mjs"
click node_analysis_api "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server.mjs"
click node_ai_api "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-api.mjs"
click node_job_planner "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-jobs.mjs"
click node_worker "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-worker.mjs"
click node_worker_core "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-worker-core.mjs"
click node_provider "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-provider.mjs"
click node_evidence "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-evidence.mjs"
click node_images "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-images.mjs"
click node_ai_config "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-config.mjs"
click node_accounts_api "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/accounts.mjs"
click node_admin_api "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/admin-api.mjs"
click node_db "https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/db.mjs"

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,node_client_api,node_report_ui,node_account_ui,node_admin_ui,node_widgets,node_desk,node_library,node_user toneBlue
class node_server,node_analysis_api toneAmber
class node_ai_api,node_job_planner,node_worker,node_worker_core,node_provider,node_evidence,node_images,node_ai_config toneMint
class node_accounts_api,node_admin_api toneRose
class node_db,node_account_user,node_model_service toneIndigo
```

## Components

### Browser experience

- [Analysis workspace](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/App.tsx): `src/App.tsx`
- [Client API and archive](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/api.ts): `src/api.ts`
- [Pro report view](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/AIReport.tsx): `src/AIReport.tsx`
- [Account and cloud history](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/Account.tsx): `src/Account.tsx`
- [Admin console](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/Admin.tsx): `src/Admin.tsx`
- [Analysis visualizations](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/widgets.tsx): `src/widgets.tsx`
- [Review desk](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/Desk.tsx): `src/Desk.tsx`
- [Saved library](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/src/Library.tsx): `src/Library.tsx`

### HTTP and analysis

- [HTTP router and collector](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server.mjs): `server.mjs`
- [Analysis endpoints](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server.mjs): `server.mjs`

### AI reports

- [AI job endpoints](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-api.mjs): `server/ai-api.mjs`
- [Job planning and reports](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-jobs.mjs): `server/ai-jobs.mjs`
- [AI worker loop](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-worker.mjs): `server/ai-worker.mjs`
- [Unit processing](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-worker-core.mjs): `server/ai-worker-core.mjs`
- [Model provider](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-provider.mjs): `server/ai-provider.mjs`
- [Evidence validation](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-evidence.mjs): `server/ai-evidence.mjs`
- [Image download](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-images.mjs): `server/ai-images.mjs`
- [AI configuration](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/ai-config.mjs): `server/ai-config.mjs`

### Accounts and administration

- [Account services](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/accounts.mjs): `server/accounts.mjs`
- [Admin services](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/admin-api.mjs): `server/admin-api.mjs`

### Persistence

- [PostgreSQL](https://github.com/xiaoxigua0503/dangdangvoice/blob/main/server/db.mjs): `server/db.mjs`

### Other components

- **Product reviewer**
- **Account holder**
- **AI model service**

## Connections

- Product reviewer → Analysis workspace: submits reviews (evidence: `src/App.tsx`)
- Analysis workspace → Client API and archive: requests analysis (evidence: `src/App.tsx`)
- Analysis workspace → Analysis visualizations: renders results (evidence: `src/App.tsx`)
- Analysis workspace → Pro report view: opens report (evidence: `src/App.tsx`)
- Analysis workspace → Review desk: opens desk (evidence: `src/App.tsx`)
- Analysis workspace → Saved library: opens library (evidence: `src/App.tsx`)
- Client API and archive → HTTP router and collector: sends requests (evidence: `src/api.ts`)
- HTTP router and collector → Analysis endpoints: handles analysis (evidence: `server.mjs`)
- HTTP router and collector → Admin services: dispatches requests (evidence: `server.mjs`)
- HTTP router and collector → AI job endpoints: dispatches requests (evidence: `server.mjs`)
- Account holder → Account and cloud history: manages account (evidence: `src/Account.tsx`)
- Account and cloud history → Client API and archive: calls account API (evidence: `src/Account.tsx`)
- Admin console → Client API and archive: calls admin API (evidence: `src/Admin.tsx`)
- Admin services → PostgreSQL: reads and writes (evidence: `server/admin-api.mjs`)
- Account services → PostgreSQL: stores account data (evidence: `server/accounts.mjs`)
- HTTP router and collector → Account services: dispatches requests (evidence: `server.mjs`)
- Pro report view → AI job endpoints: loads jobs and evidence (evidence: `src/AIReport.tsx`)
- AI job endpoints → Job planning and reports: uses job services (evidence: `server/ai-api.mjs`)
- Job planning and reports → PostgreSQL: plans and stores jobs (evidence: `server/ai-jobs.mjs`)
- AI worker loop → Unit processing: runs units (evidence: `server/ai-worker.mjs`)
- Unit processing → PostgreSQL: claims and stores units (evidence: `server/ai-worker-core.mjs`)
- Unit processing → Job planning and reports: finalizes jobs (evidence: `server/ai-worker-core.mjs`)
- Unit processing → Model provider: requests inference (evidence: `server/ai-worker-core.mjs`)
- Model provider → AI model service: sends model requests (evidence: `server/ai-provider.mjs`)
- Unit processing → Evidence validation: validates findings (evidence: `server/ai-worker-core.mjs`)
- Unit processing → Image download: downloads images (evidence: `server/ai-worker-core.mjs`)
- Unit processing → AI configuration: uses configuration (evidence: `server/ai-worker-core.mjs`)
- Job planning and reports → AI configuration: reads configuration (evidence: `server/ai-jobs.mjs`)
