---
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 文件存储（唯一的非设计文件持久化）