arch-design-agent-skill-das.../design/application-architecture/02b-solution-layering.md

1.4 KiB
Raw Blame History

doc_id title version status owners upstream downstream updated_at
DOC-AA-003 系统逻辑分层 0.1.0 reviewed
林然
./01-system-context.md
./02-modules.csv
./02a-layered-architecture.md
2026-03-23

系统逻辑分层

1. 三层架构

flowchart TB
    subgraph Frontend["前端 (Browser SPA)"]
        FE-GRAPH["MOD-FE-GRAPH<br/>关系图渲染与交互"]
        FE-PROJECT["MOD-FE-PROJECT<br/>项目切换 UI"]
        FE-EDITOR["MOD-FE-EDITOR<br/>编辑器组件 (Phase 2)"]
    end
    subgraph Backend["后端 (REST API Server)"]
        PROJECT["MOD-PROJECT<br/>项目管理"]
        SCANNER["MOD-SCANNER<br/>扫描与解析"]
        GRAPH["MOD-GRAPH<br/>关系图引擎"]
        EDITOR["MOD-EDITOR<br/>文件编辑 (Phase 2)"]
        IMPL["MOD-IMPL-TRACKER<br/>实现进度 (Phase 2)"]
    end
    subgraph External["外部数据源"]
        FS-DESIGN["设计文件目录"]
        FS-CODE["代码仓库目录"]
        LLM["LLM 服务"]
    end
    Frontend -->|REST API| Backend
    Backend -->|File I/O| External

2. 层间通信

  • 前端 ↔ 后端REST APIJSON over HTTP
  • 后端 ↔ 文件系统:直接文件 I/O
  • 后端 ↔ LLMHTTP API 调用Phase 2

3. 关键约束

  • 前端不直接访问文件系统,所有数据通过后端 API 获取
  • 后端无数据库,设计文件本身就是持久化层
  • 项目注册信息用 JSON 文件存储(唯一的非设计文件持久化)