# 架构说明

## 总体架构

```text
用户 / 管理层 / 财务 / 项目负责人
        |
        v
飞书入口：群聊、私聊、卡片、审批、文档
        |
        v
FastAPI 集成层
        |
        |-- legacy_mysql：读取现有项目管理系统 MySQL
        |-- business：内部业务台账
        |-- reports：日报、周报、经营报告
        |-- risk：延期、超预算、资金风险
        |-- feishu：飞书推送和 Webhook
        |-- ai_agent：OpenClaw / Hermes / 模型适配
        |-- audit：审计日志
        |
        v
MySQL / Redis / OpenClaw / Hermes / Feishu Open Platform
```

## 为什么先做模块化单体

当前最重要的是把流程跑通，而不是上来拆微服务。

模块化单体的好处：

- 开发和部署简单
- 业务边界清晰
- 后期可以按模块拆服务
- 适合已有 MySQL 系统的外挂式增强

后期可以拆分：

```text
ai-service
feishu-service
report-service
risk-service
finance-service
investment-service
```

## 数据边界

```text
现有项目系统 MySQL：事实源，第一阶段只读
新业务库 MySQL：AI 中台自有数据、审计日志、补充台账
飞书：协同入口和消息入口
AI 记忆：偏好、经验、技能，不保存财务事实
```