thread-master/docs/product/demand-radar/tasks/T587-followup-api-list-done-snooze-escalate.md

T587 — followup-api-list-done-snooze-escalate

Status: done
Milestone: M5
Kind: feat
Est. change: ~170 lines

Goal

完成後系統應：待追蹤清單、完成、延後三個端點可用；通知達 2 次轉 escalated 只建議轉 lost。

Depends on

• T586

Inputs

• Spec：../spec.md §3.5、§4.7.4、§4.7.5、§5.2、§9.4（FU-03、FU-04）

Outputs

程式變更（預期路徑）

路徑	動作	說明
apps/backend/generate/api/crm.api	edit	followups list／done／snooze type
apps/backend/internal/logic/crm/listFollowupsLogic.go	edit	分頁清單（狀態、到期時間排序）
apps/backend/internal/logic/crm/doneFollowupLogic.go	edit	轉 done
apps/backend/internal/logic/crm/snoozeFollowupLogic.go	edit	延後 N 天 → scheduled
apps/backend/internal/module/crm/usecase/followup_scan.go	edit	notified_count >= 2 → escalated

行為變更

• escalated 不自動改階段、不自動關閉，只在回應與 CRM 顯示「建議轉未成交」。
• snooze 天數需為正整數，非法回明確錯誤。
• 清單回 pagination + list，含所屬 Contact 摘要。

Out of scope

• AI 追蹤訊息（T588）
• 前端收件匣（T591）

Acceptance

• FU-03：通知 2 次後 escalated 且階段未變
• FU-04：snooze 5 天 → due_at 後移且狀態回 scheduled
• 指令：

cd apps/backend && make gen-api && go test ./internal/logic/crm/... ./internal/module/crm/... -count=1