Gói bàn giao (Handoff) — Insight Ghi Âm cho BOD

Phiên bản: 1.0 Ngày: 15/05/2026 Tác giả: PO/BA (NGUYỄN SƠN THỌ) Mục đích: Cửa giao team chính — danh sách file, RACI, timeline, blocker, thứ tự việc.

1) Files bàn giao

Bộ đọc trước (Reading order)

1. decision-brief.md     → bức tranh 5 phút (160 lines)
2. SOURCE_OF_TRUTH.md    → truth canonical, 15 DEC + 10 PD (227 lines)
3. EVIDENCE_PACK.md      → bằng chứng code/screen verified (153 lines)

Bộ triển khai (Execution)

4. prd.md                → hợp đồng nghiệp vụ (Z+A, 435 lines, FORMULA-001 đến 006)
5. ui-spec.md            → hợp đồng màn hình (B sections, 489 lines)
6. dev-spec.md           → data/API/migration/performance (C1-C12, 795 lines)
7. qa-test-plan.md       → test oracle (D sections)
8. go-live-checklist.md  → release gates (E sections, 7 gate groups)
9. handoff.md            → file này (RACI + timeline)

File reference (không phải bàn giao chính)

Design doc gốc: ../../superpowers/specs/2026-05-15-record-bod-insight-design.md (2085 lines)
CLAUDE.md project rules + Diva Pitfalls Map
Permission model: ../../.agents/skills/po-ba-workflow/references/diva-permission-model.md

2) Ma trận RACI (RACI Matrix)

Activity	PO/BA	Tech Lead	FE Dev	BE Dev	QA	DevOps	BOD
Spec & docs	A/R	C	I	I	I	I	I
Pending Decisions resolve	A/R	R	C	R	C	I	C
DB migration (indexes + permission)	C	A	I	R	I	C	I
FE implementation	I	A	R	I	I	I	I
GraphQL queries + Hasura permission	C	A	R	R	I	I	I
Code review	I	A/R	C	C	I	I	I
Unit + Component tests	I	C	R	R	I	I	I
Integration + E2E tests	I	C	C	C	A/R	I	I
Performance benchmark	I	A/R	C	C	R	C	I
Staging deploy	I	C	C	C	C	A/R	I
Production deploy	I	A	C	C	C	R	I
Day-0 smoke test	A/R	R	I	I	R	C	I
BOD demo session	A/R	I	I	I	I	I	C
Bug triage	C	A/R	C	C	C	I	I
Post-go-live review	A/R	R	I	I	I	I	C

Legend: R = Responsible (làm), A = Accountable (chịu trách nhiệm cuối), C = Consulted (tư vấn), I = Informed (được thông báo)

3) Timeline

3.1) Pre-kickoff (Week 0)

Ngày	Activity	Owner	Deliverable
15/05/2026	Spec hoàn thành (9 files)	PO/BA	Files trong `docs/features/record-bod-insight/`
16/05/2026	PO + Tech Lead review docs	PO + TL	Sign-off
17/05/2026	Pending Decisions session — resolve 6 PD critical (PD-001, PD-003, PD-005, PD-007, PD-008, PD-011 NEW)	PO + BE TL	Updated SOURCE_OF_TRUTH.md
18/05/2026	Kickoff meeting (FE + BE + QA + DevOps)	All	Task assignment

3.2) P0 Sprint (Week 1 — ~7 ngày dev)

Ngày	Activity	Owner
19/05 (T2)	BE: Migrate indexes + permission seed; FE: Setup page container + filter bar	BE Dev + FE Dev
20/05 (T3)	BE: EXPLAIN ANALYZE benchmark; FE: KPI Row + Trend Chart	All
21/05 (T4)	FE: Top Staff + Heatmap (custom SVG)	FE Dev
22/05 (T5)	FE: Branch Top + Anomaly Alerts	FE Dev
23/05 (T6)	FE: 2 Modal (MissingRecords + AnomalyMissingTV) với pagination	FE Dev
24/05 (T7)	FE: Extend RecordTable.tsx + module.ts; FE complete	FE Dev
25/05 (CN)	Buffer / Code review	TL
26/05 (T2)	QA: E2E test execution (TC-001 đến TC-011 + TC-CRITICAL)	QA
27/05 (T3)	QA: Performance benchmark trên staging; Bug fix	QA + Dev
28/05 (T4)	DevOps: Production deploy plan + dry-run trên staging	DevOps

3.3) Go-Live (Week 2)

Ngày	Activity	Owner
29/05/2026 (T5)	Go-Live Day-0 — migrations + FE deploy + smoke test + BOD demo	All
30/05/2026 (T6)	Day-1 monitoring + feedback collection	Tech Lead + PO
02-05/06 (Tuần sau)	Bug fix patch nếu cần	Dev
05/06/2026	Week-1 review — adoption + performance + feedback → P1 backlog	PO + BOD

3.4) P1 Sprint (Week 3-4)

Comparison mode (full overlay 2-period) + Hour-of-day filter trong RecordTable + Anomaly banner trên /e/record drill-down + Lazy load chart components (IntersectionObserver)
~1 tuần dev + 0.5 tuần QA

Note: Hasura materialized views + appointment.records relationship đã MOVE LÊN P0 sau code review feedback (B1+B5). Xem dev-spec.md §C4.3 + SOURCE_OF_TRUTH.md DEC-012/DEC-016.

3.5) P2 Sprint (Week 5-6+)

Export Excel/PDF + Schedule email + Full Staff Ranking page + KPI drill-down panel
~1.5 tuần dev + 0.5 tuần QA

4) Blockers & Open Pending Decisions

10 PD trong SOURCE_OF_TRUTH.md §8. Top 5 critical phải resolve trước P0 dev kickoff:

PD	Critical?	Người trả lời	Deadline	Status
PD-003 Appointment baseline cho "Tuân thủ ghi âm" — status/type nào tính?	🔴 Block FR-006 query implementation	PO + BE TL	17/05/2026	⬜ Open
PD-005 Tên action permission chính xác: `view_insight`?	🟠 Block migration seed	BE TL	17/05/2026	⬜ Open
PD-011 (NEW) JWT claim `x-hasura-allowed-branches` chưa có code Diva — BE middleware implement	🔴 Block ship P0 (BE security gap)	BE TL (auth team)	17/05/2026	⬜ Open
PD-008 Performance benchmark plan: chạy ở đâu, với data nào?	🟠 Block go-live gate G-PERF-1/2	DevOps + TL	17/05/2026	⬜ Open
PD-007 `reference_file.url` presigned hay raw S3?	🟡 Affect audio playback edge case	BE TL	17/05/2026	⬜ Open
PD-001 Diva có column region/area trong branch table?	🟡 Affect filter dropdown UX	BE TL	17/05/2026	⬜ Open
PD-002 Audio retention policy	🟢 P0 không block (UI handle)	BE TL + DevOps	P1 OK	⬜ Open
PD-004 Duration coverage % NULL	🟢 P0 không block (view monitor)	BE TL	P1 OK	⬜ Open
PD-006 JWT optimize `view_all` flag	🟢 P0 không block	BE TL + DevOps	P1 OK	⬜ Open
PD-009 PDF export tech	🟢 P2 only	BE TL	P2 OK	⬜ Open
PD-010 Comparison mode scope	🟢 P1 only	PO	P1 OK	⬜ Open

Action item PO: Schedule PD resolution session 17/05/2026 với BE TL.

5) Thứ tự việc (Critical path)

1. PD resolution (5 critical) — 17/05/2026
   ↓
2. BE: Migration indexes (CONCURRENTLY) + permission seed — 19/05/2026 sáng
   ↓
3. BE: EXPLAIN ANALYZE benchmark — 19/05 chiều
   ↓
4. FE: 11 components implementation song song — 19/05 → 24/05
   ↓
5. QA: Test execution — 26/05 → 27/05
   ↓
6. DevOps: Production deploy plan + dry-run — 28/05
   ↓
7. Go-Live: 29/05/2026
   ↓
8. Week-1 review + BOD feedback — 05/06/2026

Dependency map:

FE blocked nếu BE chưa seed permission view_insight
FE blocked nếu BE không confirm PD-003 (compliance baseline) — FR-006 query
QA blocked nếu FE chưa complete
DevOps blocked nếu QA chưa pass exit criteria

6) Communication channels

Channel	Purpose	Members
`#diva-record-insight-dev` Slack	Daily standup, bug triage, code review	All dev + QA + DevOps + PO
`#diva-release` Slack	Release announcements	Cross-team
Email	Formal stakeholder communication	BOD + management
Linear / Jira	Task tracking	All
GitHub PR	Code review	Dev
Sentry / Datadog	Performance + error monitoring	DevOps + TL

7) Success metrics (P0 — review 7 ngày sau go-live)

Metric	Target	Cách đo
BOD adoption	≥ 3/5 BOD weekly	Analytics `record_insight_viewed` event
TTFMP performance	p95 < 3s	Sentry transaction
0 critical bugs	100%	Bug tracker
Drill-down usage	≥ 50% session có ≥ 1 drill-down	Analytics
Permission setup	100% BOD/ITLeader có `view_insight`	DB query

8) Escalation

Severity	Escalate to	SLA response
P0 Critical (data loss / security)	Tech Lead → CTO	< 1h
P1 High (core flow broken)	Tech Lead	< 4h
P2 Medium	Bug triage queue	< 24h
P3 Low	Backlog	Next sprint

Production incident response: Tech Lead + DevOps on-call. PO informed via Slack #diva-release.

9) Post-go-live retrospective (Day+14)

Review timeline accuracy
Review effort estimate accuracy (planned vs actual)
Lessons learned (e.g. PD resolution time, performance gotchas)
P1 backlog priority adjustment based on BOD feedback
Documentation update if needed

10) Sign-off section

Pre-go-live sign-off:

Role	Người	Ngày ký	Status
PO/BA	NGUYỄN SƠN THỌ	___	⬜
Tech Lead	___	___	⬜
FE Dev Lead	___	___	⬜
BE Dev Lead	___	___	⬜
QA Lead	___	___	⬜
DevOps Lead	___	___	⬜

Post-go-live sign-off (Day+7):

Role	Người	Ngày ký	Status
PO/BA	NGUYỄN SƠN THỌ	___	⬜
BOD representative	___	___	⬜
Tech Lead	___	___	⬜

Cross-ref:
Decision Brief: ./decision-brief.md
Source of Truth: ./SOURCE_OF_TRUTH.md
Evidence Pack: ./EVIDENCE_PACK.md
PRD: ./prd.md
UI Spec: ./ui-spec.md
Dev Spec: ./dev-spec.md
QA Test Plan: ./qa-test-plan.md
Go-Live Checklist: ./go-live-checklist.md
Design doc gốc: ../../superpowers/specs/2026-05-15-record-bod-insight-design.md

Gói bàn giao (Handoff) — Insight Ghi Âm cho BOD ​

1) Files bàn giao ​

Bộ đọc trước (Reading order) ​

Bộ triển khai (Execution) ​

File reference (không phải bàn giao chính) ​

2) Ma trận RACI (RACI Matrix) ​

3) Timeline ​

3.1) Pre-kickoff (Week 0) ​

3.2) P0 Sprint (Week 1 — ~7 ngày dev) ​

3.3) Go-Live (Week 2) ​

3.4) P1 Sprint (Week 3-4) ​

3.5) P2 Sprint (Week 5-6+) ​

4) Blockers & Open Pending Decisions ​

5) Thứ tự việc (Critical path) ​

6) Communication channels ​

7) Success metrics (P0 — review 7 ngày sau go-live) ​

8) Escalation ​

9) Post-go-live retrospective (Day+14) ​

10) Sign-off section ​