# 项目总览

## 第一版目标

第一版要跑通一个公司内部 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 表达式、日历系统、自动操作交易系统、自动操作历史数据库、自动读取员工本地文件、手机端网页完整适配，也不把飞书机器人开放为程经理或普通员工通用派活入口。