Files
AI-Secretary/docs/checklists/联调验收清单.md
T
2026-06-22 17:30:59 +08:00

81 lines
3.7 KiB
Markdown

# 联调验收清单
联调验收看闭环是否真实可用,不看页面数量。
## 1. 身份和入口
- [ ] 用户可以通过飞书扫码登录 / 身份登录进入平台。
- [ ] 飞书登录可以匹配到平台用户和角色。
- [ ] 未匹配用户或停用用户不能进入平台,并有失败记录。
- [ ] 老板可以通过飞书机器人私聊提交一句话。
- [ ] 老板消息统一进入 `POST /api/secretary/handle-message`
- [ ] 非老板私聊机器人不会触发 AI,并有未授权访问记录。
## 2. AI 草稿
- [ ] AI 可以把老板一句话解析为结构化草稿。
- [ ] AI 草稿可以展示原始输入、类型、内容、接收人候选、时间、反馈要求和缺失字段。
- [ ] 草稿必须人工确认后才创建事项或提醒。
- [ ] 普通聊天、普通记录、实时问答兜底、`note``unknown` 不会创建事项、提醒或通知。
- [ ] 老板可以确认、补充/重说、取消草稿。
- [ ] 补充/重说 30 分钟上下文可以生效并过期。
- [ ] 补充/重说后旧确认卡片失效,新草稿能追溯 `parent_draft_id`
- [ ] PostgreSQL 中可以查看 `secretary_messages` 和当前 `BotContext`
- [ ] 实时问答不会创建事项、提醒或通知。
## 3. 事项闭环
- [ ] 简单事项可以从草稿生成。
- [ ] 复杂事项在老板确认后创建 `pending_manager_confirm` 事项壳。
- [ ] 程经理收到飞书提醒后进入平台确认。
- [ ] 程经理补齐事项壳后才通知最终接收人。
- [ ] 事项可以飞书通知接收人。
- [ ] 接收人可以反馈已收到、处理中、已完成、有问题。
- [ ] 有问题反馈必须留下原因。
- [ ] 发起人或程经理可以看到事项结果。
## 4. 定时提醒闭环
- [ ] 手动创建一次性提醒。
- [ ] 从草稿创建提醒。
- [ ] 支持每天、每周、每月固定周期提醒。
- [ ] 到点触发飞书通知。
- [ ] 自己提醒自己默认不需要反馈。
- [ ] 老板 / 程经理给别人设置的提醒默认需要反馈。
- [ ] 暂停、恢复、取消按状态约定生效。
- [ ] 同一提醒同一触发时间同一接收人同一渠道不会重复触发同一通知。
- [ ] 演示 / 联调环境同一应用库只启动一个 scheduler 进程。
## 5. 飞书通知和回调
- [ ] 飞书个人消息可以发送。
- [ ] 飞书交互卡片可以发送。
- [ ] 卡片按钮回调可以被平台接收。
- [ ] 回调验签失败不会执行业务动作。
- [ ] 重复点击卡片不会重复创建反馈或转换草稿。
- [ ] 没有稳定 `event_id` 的回调使用 `idempotency_key` 幂等。
- [ ] 旧卡片、失效卡片、已替代草稿和已过期通知只记录事件,不写业务对象。
- [ ] 飞书手机端平台反馈页可以提交“有问题”原因,并拒绝过期或失效链接。
- [ ] 通知成功和失败都有记录。
## 6. 失败复盘
- [ ] AI 解析失败有记录。
- [ ] PostgreSQL AI 记忆读写失败有记录。
- [ ] 人员映射缺失有记录。
- [ ] 飞书登录失败有记录。
- [ ] 飞书通知失败有记录。
- [ ] 回调失败有记录。
- [ ] 定时提醒触发失败有记录。
- [ ] 管理员 / AI 团队可以处理失败并留下处理结果。
## 7. 安全边界
- [ ] 飞书通知只发摘要和链接。
- [ ] 普通日志不含 API Key、App Secret、飞书 token。
- [ ] 普通日志不含完整手机号和完整邮箱。
- [ ] 普通日志不含 OAuth code/state、回调验签密钥和一次性操作 token 明文。
- [ ] 模型原始请求/响应和飞书原始 payload 只对管理员 / AI 团队开放排查。
- [ ] 不自动操作交易系统、历史数据库、后台管理系统或其他外部业务系统。
- [ ] 第一版明确不做的功能没有混入主线。