| doc_id |
title |
version |
status |
owners |
upstream |
downstream |
updated_at |
| DOC-AA-003 |
系统逻辑分层 |
0.1.0 |
reviewed |
|
|
| ./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 API(JSON over HTTP)
- 后端 ↔ 文件系统:直接文件 I/O
- 后端 ↔ LLM:HTTP API 调用(Phase 2)
3. 关键约束
- 前端不直接访问文件系统,所有数据通过后端 API 获取
- 后端无数据库,设计文件本身就是持久化层
- 项目注册信息用 JSON 文件存储(唯一的非设计文件持久化)