feat: 重构前后端架构，添加Go后端和Python Agent服务

- 新增 Go 语言后端服务(server/)，包含用户认证、Agent管理、数据库连接等API - 新增 Python Agent 服务(agent/)，实现Agent核心逻辑和工具集 - 前端从原生HTML迁移到Vue.js框架(web/src/) - 添加 Docker Compose 支持(docker-compose.yml) - 添加项目架构文档(docs/ARCHITECTURE.md) - 添加环境变量示例(.env.example)和本地启动脚本(start-local.ps1) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-06 16:39:42 +08:00
parent 6fe3c412f4
commit b2bc9988a9
90 changed files with 9317 additions and 469 deletions
--- a/team-require/api/README.md
+++ b/team-require/api/README.md
@@ -0,0 +1,14 @@
+# API 接口文档
+
+## 目录
+
+### Database 相关
+
+- [检查数据库连接并获取表结构](database-check.md)
+- [创建数据库配置](database-create.md)
+- [获取数据库列表](database-list.md)
+- [获取子表列表](subtable-list.md)
+
+---
+
+> 接口如有更新，请同步更新此文档
--- a/team-require/api/database-check.md
+++ b/team-require/api/database-check.md
@@ -0,0 +1,103 @@
+# 检查数据库连接并获取表结构
+
+## 接口地址
+
+```
+POST /database/check
+```
+
+## 请求参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| db_type | string | 是 | 数据库类型：`mysql`、`postgres` |
+| host | string | 是 | 数据库主机 |
+| port | int | 是 | 数据库端口 |
+| username | string | 是 | 用户名 |
+| password | string | 否 | 密码 |
+| database | string | 是 | 数据库名 |
+| charset | string | 否 | 字符集，默认 `utf8mb4` |
+| ssl_mode | string | 否 | SSL 模式 |
+| database_id | string | 否 | 已存在的数据库ID，用于恢复字段映射 |
+
+## 请求示例
+
+```json
+{
+  "db_type": "mysql",
+  "host": "localhost",
+  "port": 3306,
+  "username": "root",
+  "password": "root",
+  "database": "students",
+  "charset": "utf8mb4",
+  "database_id": "xxx-xxx-xxx"  // 可选，用于恢复字段映射
+}
+```
+
+## 返回参数
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| success | bool | 是否连接成功 |
+| message | string | 消息 |
+| database | string | 数据库名 |
+| tables | array | 表结构列表 |
+
+### tables[] 详情
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| table_name | string | 表名 |
+| table_comment | string | 表注释 |
+| ddl | string | 建表 DDL（带 COMMENT 的映射后 DDL） |
+| columns | array | 列信息列表 |
+
+### columns[] 详情
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| column_name | string | 列名 |
+| data_type | string | 数据类型 |
+| column_type | string | 完整列类型 |
+| is_nullable | string | 是否可空（YES/NO） |
+| default_value | string | 默认值 |
+| column_key | string | 主键标识（PRI/MUL/UNI） |
+| extra | string | 额外信息（如 auto_increment） |
+| column_comment | string | 列注释 |
+| mapped_name | string | 字段中文映射名（已保存的映射） |
+
+## 返回示例
+
+```json
+{
+  "success": true,
+  "message": "connection successful",
+  "database": "students",
+  "tables": [
+    {
+      "table_name": "users",
+      "table_comment": "用户表",
+      "ddl": "CREATE TABLE `users` (\n  `id` int(10) unsigned NOT NULL COMMENT '用户ID'\n  ...\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4",
+      "columns": [
+        {
+          "column_name": "id",
+          "data_type": "int",
+          "column_type": "int(10) unsigned",
+          "is_nullable": "NO",
+          "default_value": "",
+          "column_key": "PRI",
+          "extra": "auto_increment",
+          "column_comment": "",
+          "mapped_name": "用户ID"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## 使用场景
+
+1. **首次连接**：不传 `database_id`，获取实时表结构
+2. **恢复映射**：传入 `database_id`，返回已保存的 `mapped_name` 和 `ddl`
--- a/team-require/api/database-create.md
+++ b/team-require/api/database-create.md
@@ -0,0 +1,104 @@
+# 创建数据库配置
+
+## 接口地址
+
+```
+POST /database/add
+```
+
+## 请求参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| name | string | 是 | 数据库名称 |
+| description | string | 否 | 描述 |
+| db_type | string | 是 | 数据库类型 |
+| host | string | 是 | 主机 |
+| port | int | 是 | 端口 |
+| username | string | 是 | 用户名 |
+| password | string | 否 | 密码 |
+| database | string | 是 | 数据库名 |
+| charset | string | 否 | 字符集 |
+| ssl_mode | string | 否 | SSL 模式 |
+| sub_tables | array | 否 | 子表配置列表 |
+
+### sub_tables[] 详情
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| parent_table | string | 是 | 原始表名 |
+| sub_table_name | string | 是 | 子表别名 |
+| sub_table_comment | string | 否 | 子表注释 |
+| mapping_type | string | 否 | 映射类型 |
+| relation_field | string | 否 | 关联字段 |
+| relation_type | string | 否 | 关联类型 |
+| fields | array | 否 | 字段映射列表 |
+
+### fields[] 详情
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| column_name | string | 是 | 列名 |
+| mapped_name | string | 是 | 中文映射名 |
+
+## 请求示例
+
+```json
+{
+  "name": "学生数据库",
+  "description": "用于存储学生信息",
+  "db_type": "mysql",
+  "host": "localhost",
+  "port": 3306,
+  "username": "root",
+  "password": "root",
+  "database": "students",
+  "charset": "utf8mb4",
+  "sub_tables": [
+    {
+      "parent_table": "users",
+      "sub_table_name": "用户表",
+      "sub_table_comment": "用户信息",
+      "fields": [
+        {"column_name": "id", "mapped_name": "用户ID"},
+        {"column_name": "name", "mapped_name": "用户名"}
+      ]
+    }
+  ]
+}
+```
+
+## 返回参数
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| id | string | 数据库记录ID |
+| name | string | 数据库名称 |
+| db_type | string | 数据库类型 |
+| host | string | 主机 |
+| port | int | 端口 |
+| ... | ... | 其他字段 |
+
+## 返回示例
+
+```json
+{
+  "id": "xxx-xxx-xxx",
+  "name": "学生数据库",
+  "description": "用于存储学生信息",
+  "db_type": "mysql",
+  "host": "localhost",
+  "port": 3306,
+  "username": "root",
+  "password": "root",
+  "database": "students",
+  "table_count": 1,
+  "charset": "utf8mb4",
+  "created_at": "2026-03-06T15:00:00Z"
+}
+```
+
+## 说明
+
+- 创建时会自动连接数据库获取表结构 DDL
+- 如果传入了 `fields`（字段映射），会自动生成带 COMMENT 的新 DDL 并存储
--- a/team-require/api/database-list.md
+++ b/team-require/api/database-list.md
@@ -0,0 +1,51 @@
+# 获取数据库列表
+
+## 接口地址
+
+```
+GET /database/list
+```
+
+## 请求参数
+
+无
+
+## 返回参数
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| list | array | 数据库列表 |
+
+### list[] 详情
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| id | string | 数据库ID |
+| name | string | 数据库名称 |
+| description | string | 描述 |
+| db_type | string | 数据库类型 |
+| host | string | 主机 |
+| port | int | 端口 |
+| database | string | 数据库名 |
+| table_count | int | 子表数量 |
+| created_at | string | 创建时间 |
+
+## 返回示例
+
+```json
+{
+  "list": [
+    {
+      "id": "xxx-xxx",
+      "name": "学生数据库",
+      "description": "用于存储学生信息",
+      "db_type": "mysql",
+      "host": "localhost",
+      "port": 3306,
+      "database": "students",
+      "table_count": 5,
+      "created_at": "2026-03-06T15:00:00Z"
+    }
+  ]
+}
+```
--- a/team-require/api/subtable-list.md
+++ b/team-require/api/subtable-list.md
@@ -0,0 +1,75 @@
+# 获取子表列表
+
+## 接口地址
+
+```
+GET /sub-table/database/:database_id
+```
+
+## 路径参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| database_id | string | 是 | 数据库ID |
+
+## 返回参数
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| list | array | 子表列表 |
+
+### list[] 详情
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| id | string | 子表ID |
+| database_id | string | 关联的数据库ID |
+| parent_table | string | 原始表名 |
+| sub_table_name | string | 子表别名 |
+| sub_table_comment | string | 子表注释 |
+| mapping_type | string | 映射类型 |
+| relation_field | string | 关联字段 |
+| relation_type | string | 关联类型 |
+| fields | array | 字段映射列表 |
+| ddl | string | 建表 DDL（带 COMMENT） |
+| created_at | string | 创建时间 |
+
+### fields[] 详情
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| column_name | string | 列名 |
+| mapped_name | string | 中文映射名 |
+
+## 返回示例
+
+```json
+{
+  "list": [
+    {
+      "id": "xxx-xxx",
+      "database_id": "database-xxx",
+      "parent_table": "users",
+      "sub_table_name": "用户表",
+      "sub_table_comment": "用户信息",
+      "mapping_type": "horizontal",
+      "relation_field": "id",
+      "relation_type": "one_to_many",
+      "fields": [
+        {"column_name": "id", "mapped_name": "用户ID"},
+        {"column_name": "name", "mapped_name": "用户名"}
+      ],
+      "ddl": "CREATE TABLE `users` (\n  `id` int(10) unsigned NOT NULL COMMENT '用户ID'\n  ...\n)",
+      "created_at": "2026-03-06T15:00:00Z"
+    }
+  ]
+}
+```
+
+## 使用场景
+
+用于恢复映射状态：
+1. 用户点击已存在的数据库的 "Map Tables" 按钮
+2. 调用此接口获取已保存的子表信息
+3. 根据 `parent_table` 勾选已选择的表
+4. 根据 `fields` 恢复字段映射