```
feat: 添加公司AI管理平台基础架构 添加了完整的FastAPI后端项目结构,包括: - 环境配置文件(.env.example)和项目说明文档(README.md、AGENTS.md) - Dockerfile用于容器化部署 - 核心基础设施:配置管理、数据库连接、调度器、安全认证 - 模块化设计:AI代理、审批流程、审计日志、业务台账等功能模块 - 支持多数据库连接(主库和遗留系统只读库) - AI适配器支持OpenClaw、Hermes、OpenAI兼容接口 - 飞书集成、报表生成、风险监控等企业级功能 - 完整的依赖管理和测试指南 ```
This commit is contained in:
94
docs/mysql_integration.md
Normal file
94
docs/mysql_integration.md
Normal file
@@ -0,0 +1,94 @@
|
||||
# 现有 MySQL 接入说明
|
||||
|
||||
## 推荐方式
|
||||
|
||||
先创建只读账号:
|
||||
|
||||
```sql
|
||||
CREATE USER 'company_ai_ro'@'%' IDENTIFIED BY 'strong_password';
|
||||
GRANT SELECT ON existing_project_system.* TO 'company_ai_ro'@'%';
|
||||
FLUSH PRIVILEGES;
|
||||
```
|
||||
|
||||
配置:
|
||||
|
||||
```text
|
||||
LEGACY_DATABASE_URL=mysql+pymysql://company_ai_ro:strong_password@host:3306/existing_project_system?charset=utf8mb4
|
||||
```
|
||||
|
||||
## 表结构探查
|
||||
|
||||
```text
|
||||
GET /api/v1/integrations/mysql/tables
|
||||
GET /api/v1/integrations/mysql/tables/{table_name}
|
||||
```
|
||||
|
||||
## 只读查询
|
||||
|
||||
```json
|
||||
{
|
||||
"sql": "SELECT id, name, status FROM projects WHERE status != :status",
|
||||
"params": {"status": "closed"},
|
||||
"limit": 100
|
||||
}
|
||||
```
|
||||
|
||||
系统会拒绝:
|
||||
|
||||
```text
|
||||
INSERT
|
||||
UPDATE
|
||||
DELETE
|
||||
DROP
|
||||
ALTER
|
||||
TRUNCATE
|
||||
CREATE
|
||||
```
|
||||
|
||||
## 项目同步
|
||||
|
||||
预览同步:
|
||||
|
||||
```text
|
||||
POST /api/v1/integrations/mysql/projects/sync
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"dry_run": true,
|
||||
"limit": 100,
|
||||
"field_map": {
|
||||
"name": "project_name",
|
||||
"owner": "manager_name",
|
||||
"status": "project_status",
|
||||
"progress_percent": "progress",
|
||||
"budget_amount": "budget",
|
||||
"actual_amount": "actual_cost"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
确认无误后正式同步:
|
||||
|
||||
```json
|
||||
{
|
||||
"dry_run": false,
|
||||
"limit": 100,
|
||||
"actor": "admin"
|
||||
}
|
||||
```
|
||||
|
||||
同步只写入本系统内部 `projects` 表,不写回原项目管理系统。
|
||||
|
||||
## 写回策略
|
||||
|
||||
第一阶段不要写回。
|
||||
|
||||
第二阶段如果必须写回,优先走原项目管理系统 API;没有 API 时,再做受控写回,并必须包含:
|
||||
|
||||
- 权限校验
|
||||
- 参数校验
|
||||
- 审批单号
|
||||
- 事务
|
||||
- 审计日志
|
||||
- 回滚方案
|
||||
Reference in New Issue
Block a user