# Phase 1 FollowUpTask 与真实再次预约交付证据

> 日期：2026-08-02  
> 范围：Backend + Admin + Docs/Ontology  
> 状态：Code Complete / Local Gates Passed / Production Not Migrated

## 1. 交付结果

- `ReportLead` 收口为宠主同意与来源事实；新增 `FollowUpTask` 作为门店可执行回访对象。
- 状态机支持领取、未接通/稍后联系改期、无意向/无效联系方式关闭，以及退订取消。
- Admin `/leads` 已切换为任务池；同店员工可实际联系、读取真实号源并代客创建预约。
- `rebooked` 只由真实 Appointment 保存成功触发；容量、客户归属或状态校验失败时不闭环。
- 工作台到期回访改读 FollowUpTask；报告漏斗的回访后预约改读 `rebook_created`。
- 客户事实时间线新增回访创建/领取/改期/完成/取消/再次预约的低敏投影。

## 2. 自动化证据

| Gate | 结果 |
|------|------|
| Backend full test | PASS：217 tests，0 failures，0 errors，0 skipped |
| Admin production build | PASS：Vue type-check + Vite，1671 modules transformed |
| Ontology validation | PASS：290 entries，引用完整 |
| Endpoint drift | PASS：70/70 HTTP，code-only=0，ontology-only=0 |
| Entity drift | PASS：16/16 JPA，missing=0，extra=0 |
| Diff whitespace | PASS：backend/admin/docs `git diff --check` |

关键新增覆盖：`FollowUpTaskMigrationTest`、`FollowUpTaskServiceTest`、`AdminFollowUpTaskControllerTest`，以及 Appointment/BusinessEvent/Workbench/Timeline 的回归用例。反例包含跨店 404、他人领取冲突、未领取关闭拒绝、退订不虚增联系次数、跨店预约拒绝、容量不足不触碰任务。

## 3. Data Model Review

结论：PASS（代码与迁移层面）。

- `t_follow_up_task` 使用随机 `task_id` 对外、自增 ID 内部关联、`@Version` 与悲观锁处理竞争。
- 生产迁移只回填可靠的历史 `pending` 留资；不猜测其他历史结果。
- 31 项生产只读预检中新增五项，覆盖客户 canonical 范围、状态/领取/回执、开放唯一性、真实 Appointment 与 BusinessEvent 引用。
- 迁移为向前兼容新增表；常规应用回滚不得删除表或覆盖已产生任务/事件。

## 4. Privacy Review

结论：PASS（静态契约与自动化层面）。

- 完整手机号仅在本店已认证 boss/staff 的开放回访任务中返回，目的限定为实际联系；终态任务只返回脱敏手机号。
- Workbench、CustomerTimeline、BusinessEvent、AuditLog 不保存或返回完整手机号。
- 事件 metadata 白名单不含手机号、token、openid/unionid、IP、备注、媒体 URL 或原始请求。
- 跨店任务使用 404，降低可枚举性；customer 无任务接口权限。

## 5. 尚未完成的外部证据

- 未在生产或真实试点库执行第八个迁移 `20260802_create_follow_up_task.sql`。
- 未以最终 production 环境运行 schema validate + 31 项只读预检。
- 未完成 boss/staff/customer 三角色真实环境 smoke，尤其是双员工抢领、退订与无号源再次预约。
- 未在 3～5 家试点门店验证任务领取习惯、接通率、再次预约率和约 200 单完整服务样本。

上述项目进入试点 RC 门禁，不因本地自动化通过而标记为上线完成。