feat: 添加公司AI管理平台基础架构

添加了完整的FastAPI后端项目结构,包括:
- 环境配置文件(.env.example)和项目说明文档(README.md、AGENTS.md)
- Dockerfile用于容器化部署
- 核心基础设施:配置管理、数据库连接、调度器、安全认证
- 模块化设计:AI代理、审批流程、审计日志、业务台账等功能模块
- 支持多数据库连接(主库和遗留系统只读库)
- AI适配器支持OpenClaw、Hermes、OpenAI兼容接口
- 飞书集成、报表生成、风险监控等企业级功能
- 完整的依赖管理和测试指南
```
This commit is contained in:
2026-06-21 21:57:28 +08:00
commit 71ca804764
68 changed files with 3662 additions and 0 deletions

55
docs/architecture.md Normal file
View File

@@ -0,0 +1,55 @@
# 架构说明
## 总体架构
```text
用户 / 管理层 / 财务 / 项目负责人
|
v
飞书入口:群聊、私聊、卡片、审批、文档
|
v
FastAPI 集成层
|
|-- legacy_mysql读取现有项目管理系统 MySQL
|-- business内部业务台账
|-- reports日报、周报、经营报告
|-- risk延期、超预算、资金风险
|-- feishu飞书推送和 Webhook
|-- ai_agentOpenClaw / 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事实源第一阶段只读
新业务库 MySQLAI 中台自有数据、审计日志、补充台账
飞书:协同入口和消息入口
AI 记忆:偏好、经验、技能,不保存财务事实
```