文档:完善后端协作与AI秘书基线

This commit is contained in:
talesofzes
2026-06-22 16:30:11 +08:00
parent 53a5260cac
commit df0b3fa267
19 changed files with 3700 additions and 0 deletions
+87
View File
@@ -1 +1,88 @@
# 项目总览
## 第一版目标
第一版要跑通一个公司内部 AI 协作最小闭环:
```text
老板一句话
-> AI 草稿
-> 人工确认
-> 创建事项或定时提醒
-> 飞书通知
-> 接收人反馈
-> 页面看到结果和失败记录
```
AI 只负责整理、建议和生成草稿,不直接创建事项、不直接创建提醒、不直接通知别人。所有关键动作都必须经过人工确认。
## 角色
| 角色 | 第一版能力 |
| --- | --- |
| 老板 | 通过飞书机器人或平台输入一句话、确认草稿、创建事项或提醒、查看自己相关记录 |
| 程经理 | 接收复杂事项待确认提醒,在平台确认、修改和分发复杂事项 |
| 普通员工 | 接收事项和提醒,反馈已收到、处理中、已完成或有问题,创建自己的提醒 |
| 管理员 / AI 团队 | 维护人员映射、提示词版本、失败记录和必要日志 |
## 核心模块
1. 老板 AI 秘书:一句话入口、`AiSecretaryAgent`、意图分类、AI 草稿、补充/重说、普通问答兜底、对话记忆和 BotContext。
2. 事项任务:承接确认后的事项、通知、反馈和状态查看。
3. 定时提醒:承接一次性和固定周期提醒,到点通知并记录结果。
4. 飞书集成:身份登录、老板机器人私聊、个人消息、交互卡片和回调。
5. 权限日志失败记录:角色权限、操作日志、失败记录、敏感信息边界。
## 第一版闭环
老板一句话到事项:
```text
老板在飞书机器人私聊或平台输入
-> AI 生成事项草稿
-> 老板确认 / 补充/重说 / 取消
-> 简单事项直接创建,复杂事项转程经理确认
-> 飞书通知接收人
-> 接收人反馈
-> 发起人或程经理查看结果
```
老板一句话到提醒:
```text
老板输入未来提醒
-> AI 生成提醒草稿
-> 老板确认 / 补充/重说 / 取消
-> 创建提醒
-> 到点飞书通知
-> 按需反馈
-> 查看通知结果和失败原因
```
异常复盘:
```text
AI 解析失败 / 通知失败 / 回调失败 / 定时触发失败
-> 写入失败记录
-> AI 团队处理
-> 必要时补发、取消、重新处理或同步程经理
-> 处理结果留痕
```
## 技术栈
| 层级 | 约定 |
| --- | --- |
| 后端 | Python Django + Django REST Framework |
| ORM | Django ORM + Django Migrations |
| 数据库 | PostgreSQL 18.x,作为唯一数据源 |
| AI 对话记忆 | PostgreSQL 表 + `jsonb`,保存老板秘书会话、消息、BotContext 和模型调用快照 |
| 定时任务 | Django management command + 独立 scheduler 进程 |
| 后台管理 | Django Admin |
| AI 接入 | 阿里百炼 API,后端封装薄 `ai_client` |
| 飞书 | 飞书身份登录、机器人私聊、个人消息、交互卡片和回调 |
| 部署 | Docker Compose + Nginx + Gunicorn |
## 第一版不做
不做完整任务系统、完整 AI 工作台、技能市场、文件上传、多模态处理、会议纪要、日报、文档摘要、复杂反馈看板、复杂 BI、成本驾驶舱、完整工作流、完整项目管理、多级子任务、甘特图、复杂审批流、复杂组织架构、cron 表达式、日历系统、自动操作交易系统、自动操作历史数据库、自动读取员工本地文件、手机端网页完整适配,也不把飞书机器人开放为程经理或普通员工通用派活入口。