# zzy443320/ai-dev-work-platform architecture

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

- Interactive diagram: https://gitdiagram.com/zzy443320/ai-dev-work-platform
- Repository: https://github.com/zzy443320/ai-dev-work-platform

## Overview

ONES 前端研发助手 is a local web-based AI engineering copilot. Users ask questions, submit defects, or provide task inputs; the backend generates answers, proposals, or artifacts, while repository changes remain behind explicit human approval. The graph preserves the documented task, long-running multi-agent, knowledge-base, configuration, and usage capabilities. Evidence is limited to the README and sampled/indexed files; links for documented but unsampled internals are identified by README evidence rather than implying source inspection.

Main entry points: [`scripts/pipeline.py`](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/pipeline.py) (Defect pipeline), [`frontend/src/api/client.js`](https://github.com/zzy443320/ai-dev-work-platform/blob/main/frontend/src/api/client.js) (API client), [`web/routers/tasks.py`](https://github.com/zzy443320/ai-dev-work-platform/blob/main/web/routers/tasks.py) (Task endpoints), [`scripts/ai_providers.py`](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/ai_providers.py) (Model providers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web experience"]
  node_app["Vue application<br/>[App.vue]"]
  node_client["API client<br/>[client.js]"]
  node_defect_ui["Defect workflow UI<br/>[useDefect.js]"]
  node_task_ui["Task workflow UI<br/>[useTasks.js]"]
end

subgraph group_api["HTTP services"]
  node_server["Web server<br/>[server.py]"]
  node_pipeline_route["Defect endpoints<br/>[pipeline.py]"]
  node_task_route["Task endpoints<br/>[tasks.py]"]
  node_chat_route["Chat endpoints<br/>[chat.py]"]
  node_review_route["Review endpoints<br/>[review.py]"]
end

subgraph group_workflows["AI workflows"]
  node_defect_pipeline["Defect pipeline<br/>[pipeline.py]"]
  node_analyzer["Defect analysis<br/>[analyzer.py]"]
  node_patch["Patch engine<br/>[patch_engine.py]"]
  node_task_modules["Task generation<br/>[task_modules.py]"]
  node_chat["AI chat<br/>[chat.py]"]
  node_team["Multi-agent runs<br/>[team_run.py]"]
end

subgraph group_safety["Review and safety"]
  node_gate["Acceptance gates<br/>[gate.py]"]
  node_proposals[("Defect proposals<br/>[proposal.py]")]
  node_artifacts[("Task artifacts<br/>[artifact.py]")]
end

subgraph group_operations["Shared services"]
  node_ai["Model providers<br/>[ai_providers.py]"]
  node_usage[("Usage accounting<br/>[usage.py]")]
  node_knowledge[("Knowledge base<br/>[kb.py]")]
end

node_user(("Engineer"))

node_user -->|"uses"| node_app
node_app -->|"requests"| node_client
node_client -->|"calls defect API"| node_pipeline_route
node_client -->|"calls task API"| node_task_route
node_client -->|"calls chat API"| node_chat_route
node_client -->|"calls review API"| node_review_route
node_defect_ui -->|"runs and probes"| node_client
node_task_ui -->|"submits tasks"| node_client
node_server -->|"registers"| node_pipeline_route
node_server -->|"registers"| node_task_route
node_server -->|"registers"| node_chat_route
node_server -->|"registers"| node_review_route
node_pipeline_route -->|"runs pipeline"| node_defect_pipeline
node_defect_pipeline -->|"analyzes defects"| node_analyzer
node_defect_pipeline -->|"builds patches"| node_patch
node_defect_pipeline -->|"checks proposals"| node_gate
node_defect_pipeline -->|"creates proposals"| node_proposals
node_task_route -->|"generates tasks"| node_task_modules
node_task_route -->|"stores outputs"| node_artifacts
node_chat_route -->|"dispatches chat"| node_chat
node_chat -->|"requests completion"| node_ai
node_team -.->|"uses agents"| node_ai
node_task_modules -.->|"generates with AI"| node_ai
node_defect_pipeline -->|"uses models"| node_ai
node_defect_pipeline -->|"uses defect knowledge"| node_knowledge
node_ai -->|"records calls"| node_usage
node_review_route -->|"approves or undoes"| node_proposals
node_review_route -->|"approves or undoes"| node_artifacts
node_artifacts -->|"runs acceptance checks"| node_gate
node_task_route -->|"invokes configured model"| node_ai
node_task_route -->|"accounts task calls"| node_usage
node_user -.->|"starts long task"| node_team

click node_app "https://github.com/zzy443320/ai-dev-work-platform/blob/main/frontend/src/App.vue"
click node_client "https://github.com/zzy443320/ai-dev-work-platform/blob/main/frontend/src/api/client.js"
click node_defect_ui "https://github.com/zzy443320/ai-dev-work-platform/blob/main/frontend/src/composables/useDefect.js"
click node_task_ui "https://github.com/zzy443320/ai-dev-work-platform/blob/main/frontend/src/composables/useTasks.js"
click node_server "https://github.com/zzy443320/ai-dev-work-platform/blob/main/web/server.py"
click node_pipeline_route "https://github.com/zzy443320/ai-dev-work-platform/blob/main/web/routers/pipeline.py"
click node_task_route "https://github.com/zzy443320/ai-dev-work-platform/blob/main/web/routers/tasks.py"
click node_chat_route "https://github.com/zzy443320/ai-dev-work-platform/blob/main/web/routers/chat.py"
click node_review_route "https://github.com/zzy443320/ai-dev-work-platform/blob/main/web/routers/review.py"
click node_defect_pipeline "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/pipeline.py"
click node_analyzer "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/analyzer.py"
click node_patch "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/patch_engine.py"
click node_task_modules "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/task_modules.py"
click node_chat "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/chat.py"
click node_team "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/team_run.py"
click node_ai "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/ai_providers.py"
click node_usage "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/usage.py"
click node_knowledge "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/kb.py"
click node_gate "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/gate.py"
click node_proposals "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/proposal.py"
click node_artifacts "https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/artifact.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_app,node_client,node_defect_ui,node_task_ui toneBlue
class node_server,node_pipeline_route,node_task_route,node_chat_route,node_review_route toneAmber
class node_defect_pipeline,node_analyzer,node_patch,node_task_modules,node_chat,node_team toneMint
class node_gate,node_proposals,node_artifacts toneRose
class node_ai,node_usage,node_knowledge,node_user toneIndigo
```

## Components

### Web experience

- [Vue application](https://github.com/zzy443320/ai-dev-work-platform/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [API client](https://github.com/zzy443320/ai-dev-work-platform/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`
- [Defect workflow UI](https://github.com/zzy443320/ai-dev-work-platform/blob/main/frontend/src/composables/useDefect.js): `frontend/src/composables/useDefect.js`
- [Task workflow UI](https://github.com/zzy443320/ai-dev-work-platform/blob/main/frontend/src/composables/useTasks.js): `frontend/src/composables/useTasks.js`

### HTTP services

- [Web server](https://github.com/zzy443320/ai-dev-work-platform/blob/main/web/server.py): `web/server.py`
- [Defect endpoints](https://github.com/zzy443320/ai-dev-work-platform/blob/main/web/routers/pipeline.py): `web/routers/pipeline.py`
- [Task endpoints](https://github.com/zzy443320/ai-dev-work-platform/blob/main/web/routers/tasks.py): `web/routers/tasks.py`
- [Chat endpoints](https://github.com/zzy443320/ai-dev-work-platform/blob/main/web/routers/chat.py): `web/routers/chat.py`
- [Review endpoints](https://github.com/zzy443320/ai-dev-work-platform/blob/main/web/routers/review.py): `web/routers/review.py`

### AI workflows

- [Defect pipeline](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/pipeline.py): `scripts/pipeline.py`
- [Defect analysis](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/analyzer.py): `scripts/analyzer.py`
- [Patch engine](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/patch_engine.py): `scripts/patch_engine.py`
- [Task generation](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/task_modules.py): `scripts/task_modules.py`
- [AI chat](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/chat.py): `scripts/chat.py`
- [Multi-agent runs](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/team_run.py): `scripts/team_run.py`

### Review and safety

- [Acceptance gates](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/gate.py): `scripts/gate.py`
- [Defect proposals](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/proposal.py): `scripts/proposal.py`
- [Task artifacts](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/artifact.py): `scripts/artifact.py`

### Shared services

- [Model providers](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/ai_providers.py): `scripts/ai_providers.py`
- [Usage accounting](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/usage.py): `scripts/usage.py`
- [Knowledge base](https://github.com/zzy443320/ai-dev-work-platform/blob/main/scripts/kb.py): `scripts/kb.py`

### Other components

- **Engineer**

## Connections

- Engineer → Vue application: uses
- Vue application → API client: requests (evidence: `frontend/src/App.vue`)
- API client → Defect endpoints: calls defect API (evidence: `frontend/src/api/client.js`)
- API client → Task endpoints: calls task API (evidence: `frontend/src/api/client.js`)
- API client → Chat endpoints: calls chat API (evidence: `frontend/src/api/client.js`)
- API client → Review endpoints: calls review API (evidence: `frontend/src/api/client.js`)
- Defect workflow UI → API client: runs and probes (evidence: `frontend/src/composables/useDefect.js`)
- Task workflow UI → API client: submits tasks (evidence: `frontend/src/composables/useTasks.js`)
- Web server → Defect endpoints: registers (evidence: `web/server.py`)
- Web server → Task endpoints: registers (evidence: `web/server.py`)
- Web server → Chat endpoints: registers (evidence: `web/server.py`)
- Web server → Review endpoints: registers (evidence: `web/server.py`)
- Defect endpoints → Defect pipeline: runs pipeline
- Defect pipeline → Defect analysis: analyzes defects (evidence: `scripts/pipeline.py`)
- Defect pipeline → Patch engine: builds patches (evidence: `scripts/pipeline.py`)
- Defect pipeline → Acceptance gates: checks proposals (evidence: `scripts/pipeline.py`)
- Defect pipeline → Defect proposals: creates proposals (evidence: `scripts/pipeline.py`)
- Task endpoints → Task generation: generates tasks (evidence: `web/routers/tasks.py`)
- Task endpoints → Task artifacts: stores outputs (evidence: `web/routers/tasks.py`)
- Chat endpoints → AI chat: dispatches chat (evidence: `web/routers/chat.py`)
- AI chat → Model providers: requests completion (evidence: `scripts/chat.py`)
- Multi-agent runs → Model providers: uses agents
- Task generation → Model providers: generates with AI
- Defect pipeline → Model providers: uses models (evidence: `scripts/pipeline.py`)
- Defect pipeline → Knowledge base: uses defect knowledge (evidence: `scripts/pipeline.py`)
- Model providers → Usage accounting: records calls (evidence: `scripts/ai_providers.py`)
- Review endpoints → Defect proposals: approves or undoes
- Review endpoints → Task artifacts: approves or undoes (evidence: `web/routers/review.py`)
- Task artifacts → Acceptance gates: runs acceptance checks (evidence: `scripts/artifact.py`)
- Task endpoints → Model providers: invokes configured model (evidence: `web/routers/tasks.py`)
- Task endpoints → Usage accounting: accounts task calls (evidence: `web/routers/tasks.py`)
- Engineer → Multi-agent runs: starts long task
