54 lines
1.4 KiB
Markdown
54 lines
1.4 KiB
Markdown
---
|
||
doc_id: DOC-AA-003
|
||
title: 系统逻辑分层
|
||
version: 0.1.0
|
||
status: reviewed
|
||
owners:
|
||
- 林然
|
||
upstream:
|
||
- ./01-system-context.md
|
||
downstream:
|
||
- ./02-modules.csv
|
||
- ./02a-layered-architecture.md
|
||
updated_at: 2026-03-23
|
||
---
|
||
|
||
# 系统逻辑分层
|
||
|
||
## 1. 三层架构
|
||
|
||
```mermaid
|
||
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 文件存储（唯一的非设计文件持久化）
|