Admin
88dc9fef53
All checks were successful
continuous-integration/drone/push Build is passing
- 添加生产数据库 new_platform_prod 配置 - 添加 Drone API Token - 更新 README 环境地址
138 lines
3.9 KiB
Markdown
138 lines
3.9 KiB
Markdown
# AI 对话启动指南
|
||
|
||
> 本文档用于快速让新 AI 了解项目背景和当前状态
|
||
|
||
---
|
||
|
||
## 项目概述
|
||
|
||
这是一个多租户 AI 应用平台，包含：
|
||
|
||
| 项目 | 说明 | 技术栈 |
|
||
|------|------|--------|
|
||
| 000-platform | 统一管理平台（Admin UI） | Python FastAPI + Vue 3 |
|
||
| 001-tools | PHP+n8n 工具迁移 | Python FastAPI + Vue 3 |
|
||
| 011-ai-interview | AI 面试应用 | Python FastAPI + Vue 3 |
|
||
|
||
---
|
||
|
||
## 当前状态
|
||
|
||
### 已完成
|
||
- DevOps: Gitea + Drone CI/CD + Docker 自动部署
|
||
- 多租户鉴权: URL 参数签名验证 (tid, aid, ts, sign)
|
||
- 应用管理: Admin UI 可配置应用和生成签名链接
|
||
- 5 个工具迁移: 头脑风暴、高情商回复、面诊方案、客户画像、医疗合规
|
||
- AI 调用统计: 记录到 platform_ai_call_events
|
||
|
||
### 待完成
|
||
- 企业微信 JS-SDK 集成
|
||
- n8n 返回 token 统计
|
||
- 生产环境部署
|
||
|
||
---
|
||
|
||
## 关键文件位置
|
||
|
||
```
|
||
AgentWD/
|
||
├── _shared/ # 共享文档
|
||
│ ├── AI对话启动指南.md # 本文件
|
||
│ ├── 项目进度/ # 进度文档
|
||
│ │ ├── 整体进度汇总.md
|
||
│ │ ├── 000-platform进度.md
|
||
│ │ └── 001-tools迁移进度.md
|
||
│ └── 数据库/
|
||
│ └── 测试环境配置.md # 服务器/数据库信息
|
||
├── 框架/
|
||
│ └── CICD配置.md # CI/CD 说明
|
||
├── projects/
|
||
│ ├── 000-platform/ # 管理平台
|
||
│ ├── 001-tools/ # 工具集
|
||
│ └── 011-ai-interview/ # AI 面试
|
||
└── scripts/ # 数据库脚本
|
||
```
|
||
|
||
---
|
||
|
||
## 服务器信息
|
||
|
||
| 服务 | 地址 | 说明 |
|
||
|------|------|------|
|
||
| 测试服务器 | 47.107.172.23 | root / Nj861021 |
|
||
| MySQL | 47.107.71.55 | scrm_reader / ScrmReader2024Pass |
|
||
| n8n | https://n8n.ireborn.com.cn | 工作流引擎 |
|
||
| Gitea | https://git.ai.ireborn.com.cn | 代码托管 |
|
||
| Drone CI | https://ci.ai.ireborn.com.cn | 自动部署 |
|
||
|
||
---
|
||
|
||
## 环境地址
|
||
|
||
| 服务 | 测试环境 | 生产环境 |
|
||
|------|----------|----------|
|
||
| 管理平台 | http://47.107.172.23:3003 | http://47.107.172.23:4003 |
|
||
| 后端 API | http://47.107.172.23:8001 | http://47.107.172.23:9001 |
|
||
|
||
---
|
||
|
||
## 数据库配置
|
||
|
||
| 环境 | 数据库 | Drone Secret |
|
||
|------|--------|--------------|
|
||
| 测试 | `new_qiqi` | `database_url` |
|
||
| 生产 | `new_platform_prod` | `database_url_prod` |
|
||
|
||
---
|
||
|
||
## 鉴权机制
|
||
|
||
### 001-tools 租户鉴权
|
||
```
|
||
URL: https://tools.test.ai.ireborn.com.cn/brainstorm?tid=test&aid=tools
|
||
```
|
||
|
||
- `tid`: 租户ID（必须）
|
||
- `aid`: 应用代码（必须，默认 tools）
|
||
- `ts`: 时间戳（需签名的租户必须）
|
||
- `sign`: HMAC-SHA256(tid+aid+ts, token_secret)
|
||
|
||
### 测试租户
|
||
- `test`: 免签名，直接 `?tid=test&aid=tools`
|
||
- `qiqi`: 需签名，通过 Admin UI 生成链接
|
||
|
||
---
|
||
|
||
## 开发规范
|
||
|
||
1. **分支策略**: develop → 测试环境, main → 生产环境
|
||
2. **代码提交**: 推送后自动触发 Drone CI/CD
|
||
3. **样式保留**: 001-tools 各工具保持原 PHP 样式，不统一
|
||
4. **数据库表**: 统一使用 `platform_` 前缀
|
||
|
||
---
|
||
|
||
## 常用命令
|
||
|
||
```bash
|
||
# 检查构建状态
|
||
curl "https://ci.ai.ireborn.com.cn/api/repos/admin/000-platform/builds?per_page=1"
|
||
|
||
# SSH 到服务器
|
||
ssh root@47.107.172.23 # 密码: Nj861021
|
||
|
||
# 执行 MySQL
|
||
mysql -h 47.107.71.55 -u scrm_reader -pScrmReader2024Pass new_qiqi
|
||
```
|
||
|
||
---
|
||
|
||
## 详细进度
|
||
|
||
请阅读以下文件获取更多信息：
|
||
|
||
1. `_shared/项目进度/整体进度汇总.md` - 整体架构和状态
|
||
2. `_shared/项目进度/001-tools迁移进度.md` - 工具迁移详情
|
||
3. `_shared/项目进度/000-platform进度.md` - 平台服务详情
|
||
4. `_shared/数据库/测试环境配置.md` - 环境配置详情
|