Files
AI-Secretary/docs/00_项目总览.md
2026-06-22 17:30:59 +08:00

3.4 KiB

项目总览

第一版目标

第一版要跑通一个公司内部 AI 协作最小闭环:

老板一句话
-> AI 草稿
-> 人工确认
-> 创建事项或定时提醒
-> 飞书通知
-> 接收人反馈
-> 页面看到结果和失败记录

AI 只负责整理、建议和生成草稿,不直接创建事项、不直接创建提醒、不直接通知别人。所有关键动作都必须经过人工确认。

角色

角色 第一版能力
老板 通过飞书机器人或平台输入一句话、确认草稿、创建事项或提醒、查看自己相关记录
程经理 接收复杂事项待确认提醒,在平台确认、修改和分发复杂事项
普通员工 接收事项和提醒,反馈已收到、处理中、已完成或有问题,创建自己的提醒
管理员 / AI 团队 维护人员映射、提示词版本、失败记录和必要日志

核心模块

  1. 老板 AI 秘书:一句话入口、AiSecretaryAgent、意图分类、AI 草稿、补充/重说、普通问答兜底、对话记忆和 BotContext。
  2. 事项任务:承接确认后的事项、通知、反馈和状态查看。
  3. 定时提醒:承接一次性和固定周期提醒,到点通知并记录结果。
  4. 飞书集成:身份登录、老板机器人私聊、个人消息、交互卡片和回调。
  5. 权限日志失败记录:角色权限、操作日志、失败记录、敏感信息边界。
  6. 安全权限日志约定:飞书验签、幂等、日志脱敏、访问范围和 tests 真实约束。

第一版闭环

老板一句话到事项:

老板在飞书机器人私聊或平台输入
-> AI 生成事项草稿
-> 老板确认 / 补充/重说 / 取消
-> 简单事项直接创建,复杂事项转程经理确认
-> 飞书通知接收人
-> 接收人反馈
-> 发起人或程经理查看结果

老板一句话到提醒:

老板输入未来提醒
-> AI 生成提醒草稿
-> 老板确认 / 补充/重说 / 取消
-> 创建提醒
-> 到点飞书通知
-> 按需反馈
-> 查看通知结果和失败原因

异常复盘:

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