Appearance
v1.2 — 21/04/2026
| Thay đổi | Section | Ảnh hưởng |
|---|---|---|
| Khóa 4 default implementation còn lại để kickoff không phụ thuộc quyết định mở | Header, Defaults, Kickoff, Deploy | PO, TL, FE, BE, QA |
| Đồng bộ version 1.1, nhấn mạnh lifecycle/report-group checks trước kickoff và deploy | Header, Dev Kickoff, Deploy, Go/No-Go | PO, TL, FE, BE, QA |
| Khởi tạo handoff package cho LTV Phase 1 | Toàn file | PO, TL, FE, BE, QA |
Delivery Index — LTV Phase 1
Handoff này gom các file cần đọc, thứ tự kickoff và các default đã khóa trước khi triển khai / deploy.
Nên đọc Files trước, sau đó Defaults Đã Khóa, Dev Kickoff Checklist và Go / No-Go Signals để tránh bỏ sót các gate mới của v1.2.
| Field | Value |
|---|---|
| Feature | LTV Phase 1 |
| Version | 1.2 |
| Date | 21/04/2026 |
| Complexity | M |
| Report placement | customer_cycle_report_group |
Files
| # | File | Audience |
|---|---|---|
| 1 | PRD | PO, TL, Business |
| 2 | UI Spec | FE, QA, PO |
| 3 | Dev Spec | BE, FE, TL |
| 4 | QA Test Plan | QA |
| 5 | Evidence Pack | PO, TL |
| 6 | Source of Truth | All |
| 7 | Design Doc nội bộ: docs/superpowers/specs/2026-04-20-ltv-phase1-design.md | Reference |
| 8 | HTML Proposal nội bộ: docs/guides/ltv-phase1-proposal.html | Business / Sếp |
RACI
| Deliverable / task | PO/BA | TL | Admin/IT | FE Dev | BE Dev | QA |
|---|---|---|---|---|---|---|
| Canonical docs | A | C | I | I | I | I |
| Mapping taxonomy lock | C | I | A | I | I | I |
| DB migration + snapshot layer | I | A | I | I | R | I |
| Mapping admin flow + backfill action | C | A | C | C | R | I |
| Report FE tab + tables | I | C | I | R | C | I |
| QA/UAT | C | I | I | I | I | R |
Timeline đề xuất
| Milestone | Target | Owner | Dependency |
|---|---|---|---|
| 1. Lock mapping taxonomy + version seed v1 | T+1 ngày | PO/BA + Admin/IT | PRD approved |
2. DB migrations ltv_* | T+3 ngày | BE | Milestone 1 |
| 3. Backfill / snapshot services + queries | T+6 ngày | BE | Milestone 2 |
4. FE tab LTV Phase 1 + aggregate tables | T+8 ngày | FE | Query contract ổn định |
| 5. Admin mapping drawer + override dialog | T+9 ngày | FE + BE | Milestone 3 |
| 6. Staging backfill + QA cycle | T+11 ngày | BE + QA | Milestone 4-5 |
| 7. UAT business + sign-off | T+12 ngày | PO/BA | QA pass |
Defaults Đã Khóa
| ID | Default | Owner | Status |
|---|---|---|---|
| D-001 | Seed mapping version v1 từ toàn bộ active master_data(type = customer_source), freeze cả raw_source_id và raw_source_name_snapshot tại thời điểm cutover | PO/BA + Admin/IT + BE | Locked |
| D-002 | Seed report_role mặc định cho customer_cycle_ltv_report = bod, hr_leader, it_leader, đồng bộ với report cycle hiện có | TL + Admin/IT + BE | Locked |
| D-003 | Confidence rubric mặc định: high = manual/direct evidence gần first_paid; medium = đúng 1 raw source hợp lệ, không mâu thuẫn; unknown = trống/nhiều/mâu thuẫn | TL + PO/BA + BE | Locked |
| D-004 | Refresh strategy mặc định là hybrid: event-driven incremental + scheduled reconcile + manual backfill explicit | TL + BE | Locked |
Dev Kickoff Checklist
BE
- [ ] Đọc
PRD,Dev Spec,SOURCE_OF_TRUTH. - [ ] Verify
customer_revenueđang đủ các action type cần dùng. - [ ] Verify nơi loại trừ
wallet_promotionnếu đọc từ revenue events chưa đủ chi tiết. - [ ] Verify
report.group_idseed đúngcustomer_cycle_report_group, không dùng value legacycustomer_cycle_report. - [ ] Seed
report_rolemặc định chocustomer_cycle_ltv_report:bod,hr_leader,it_leader. - [ ] Chốt migration naming + thứ tự deploy.
FE
- [ ] Đọc
PRD,UI Spec. - [ ] Verify
CustomerCycleReport.tsxhiện có có thể extend thêm tab. - [ ] Verify report registry / report roles cho
customer_cycle_report_group. - [ ] Verify flow
Publish version -> quay lại report -> chạy backfill explicithoạt động đúng deeplink và state badges. - [ ] Verify UI phản ánh đúng trạng thái refresh hybrid: incremental cập nhật case mới, cron reconcile không tạo hiểu nhầm là publish auto remap lịch sử.
- [ ] Chuẩn bị pattern export table reuse từ report module hiện có.
QA
- [ ] Đọc
PRD,QA Test Plan. - [ ] Chuẩn bị dataset cho unknown / override / mapping version + full active
customer_sourcecatalog seed v1. - [ ] Chuẩn bị test state transition cho
draft/published/archivedvàqueued/running/done/failed. - [ ] Chuẩn bị sanity checklist cho semantics time/branch/service.
Deploy Checklist
| # | Step | Owner | Verify |
|---|---|---|---|
| 1 | Deploy migrations ltv_* | BE | tables + indexes exist |
| 2 | Seed report_role cho customer_cycle_ltv_report | Admin/IT + BE | role set = bod, hr_leader, it_leader |
| 3 | Seed mapping version v1 từ full active customer_source catalog | Admin/IT + BE | version published, đủ raw_source_id + snapshot label |
| 4 | Deploy query/actions/metadata | BE | Hasura console query pass + report.group_id = customer_cycle_report_group |
| 5 | Deploy FE tab LTV Phase 1 | FE | tab hiển thị trong customer_cycle_report_group |
| 6 | Publish flow smoke | Admin/IT + FE | version published read-only, clone-to-draft hoạt động |
| 7 | Chạy initial backfill staging | Admin/IT + BE | job done, unknown count có log |
| 8 | Verify incremental refresh + scheduled reconcile | BE + QA | case payment/refund mới được cập nhật, reconcile không rewrite lịch sử sai |
| 9 | QA smoke | QA | P0 cases pass |
| 10 | UAT | PO/BA + business | top rows + summary hợp lý |
Go / No-Go Signals
Go
- Mapping version v1 đã lock.
- Published version read-only; thay đổi tiếp theo đi qua
Clone thành draft. - Unknown ratio có thể giải thích.
- P0 tests pass.
- UI wording đã đúng
cohort first paid,chi nhánh first paid,nhóm dịch vụ khởi đầu.
No-Go
- Chưa lock mapping taxonomy đầu tiên.
- Publish version mới tự auto chạy backfill hoặc rewrite snapshot cũ.
- Snapshot cũ bị rewrite khi publish mapping version mới.
- Report đọc trực tiếp raw source hiện tại thay vì snapshot canonical.
- Business vẫn hiểu nhầm đây là
LTV phát sinh trong kỳ.