QnA Init Docs — UC_4.12.3: The Desk Manager (LIVE Global Shell)
Ngày tạo: 2026-08-12
Phiên bản: v1
BA phụ trách: Trang Nguyen
Ngày BA review: 2026-08-12
Trạng thái: ✅ BA đã trả lời 5/5 câu — LIVE dùng event set gần giống SIM + thêm 2 event LIVE-only DEFENSE_TRIGGERED/POD_DYNAMICS, giữ nguyên rate limit và UI card stack, giữ module Global Shell. ⚠️ 2026-08-14 correction: QN-4.12.3-01 đã bị đảo lại — STAGNATION là event SIM-only, KHÔNG xảy ra ở LIVE (ngược với xác nhận ban đầu 2026-08-12), xem chi tiết trong bảng và Changelog. ✅ 2026-08-16 (round 2): QN-4.12.3-05 chốt — bảng mapping prompt cho 2 event LIVE-only đã được thêm vào BR_4.12.3.4, không còn [PENDING].
- ⚠️ Renumber Note: ID cũ
UC_4.11.3 → renumber thành UC_4.12.3 (WBS update 2026-08-10).
- A-07: The Desk Manager (SIM = UC_4.8.3, LIVE = UC_4.12.3) — BA từng xác nhận thuộc module Overview, KHÔNG thuộc Global Shell. ⚠️ Cần re-confirm: WBS hiện tại (2026-08-12) liệt kê UC_4.12.3 dưới module
Global Shell — cùng vấn đề mismatch như UC_4.12.2, xem QN-4.12.3-04.
docs/BA/UC_4.1-4.17/dashboard_sim/UC_4.8.3/QnA_init_docs.md — spec đầy đủ: 15 trigger event, Token Bucket 10 critiques/giờ/user, Master Prompt (Gordon Gekko persona), card stack UI (2 card visible + scroll, không auto-expire, không giới hạn tổng), vibe field không có enum cố định (map 2 nhóm style), rate-limit im lặng bỏ qua.
References/Customer supplies/v7_full.txt §3.2.1 "The Desk Manager (LLM Commentary Engine)" — engine stateless, Gemini 1.5 Flash 8B, GEKKO_CHATTER channel async.
References/Customer supplies/dashboard_v7_full.txt L896-900 — "An optional LLM-driven 'Chatter' feature... stacked UI cards featuring dynamic 'Discipline pass'/'Discipline fail' tags."
- Ghi chú Phase 2.2 của UC_4.8.3 (SIM) đã flag sẵn: "Cross-ref LIVE UC_4.11.3 (nay UC_4.12.3) — cùng logic Gekko, chỉ khác event set theo môi trường (chưa xác nhận)" — đây chính là câu hỏi trọng tâm cần confirm ở đây (QN-4.12.3-01).
| ID | Câu hỏi | Giả định (BA/QC đề xuất) | BA chốt (ưu tiên cao nhất) | Trạng thái |
|---|
| QN-4.12.3-01 | [QUAN TRỌNG — kế thừa flag từ SIM UC_4.8.3 Phase 2.2] LIVE Desk Manager có dùng đúng 15 trigger event như SIM, hay có event set riêng cho LIVE? SIM đã confirm dùng toàn bộ 15 event (SESSION_START, LOSS_EVENT, PROMOTION, DEFENSE_TRIGGERED, STOP_HIT, NEWS_HOLD, ORDER_CANCELLED, POD_DYNAMICS, PAPER_HANDS, STAGNATION, THE_WHALE, REVENGE_TRADE, THE_CLOCK_WATCHER, SCALP_HUNTER, COMMUNITY_LIVE). | Đề xuất: LIVE dùng đúng 15 trigger event như SIM, khác biệt chỉ là tần suất/khả năng trigger thực tế theo môi trường. | ⚠️ CORRECTION 2026-08-14 — đảo lại xác nhận 2026-08-12: Xác nhận ban đầu (2026-08-12) từng chốt STAGNATION là event LIVE-only, không xảy ra ở SIM. Xác nhận này đã bị đảo lại theo yêu cầu client/BA (2026-08-14): STAGNATION thuộc về SIM, KHÔNG xảy ra ở LIVE. Event set LIVE-only chính xác là DEFENSE_TRIGGERED và POD_DYNAMICS (2 event, không phải STAGNATION) — xem UC_4.8.3 BR_4.8.3.1 và BR_4.8.3.5 (đã thêm STAGNATION vào bảng prompt mapping SIM, dùng "Pending client provides." do không có constraint 1-18 nào map tới). LIVE dùng 13 event chung với SIM cộng thêm DEFENSE_TRIGGERED và POD_DYNAMICS — xem UC_4.12.3 BR_4.12.3.1. Correlation trước đây giữa STAGNATION và Stagnation Deadline (UC_4.12.1, Flow 19) bị rút lại theo correction này, cần re-xác nhận trên SIM nếu còn liên quan. | 🔁 Reversed 2026-08-14 (xem correction — trước đó ✅ Confirmed 2026-08-12) |
| QN-4.12.3-02 | Token Bucket rate limit (10 critiques/giờ/user) — áp dụng cùng ngưỡng cho LIVE, hay LIVE cần ngưỡng riêng? SIM đã confirm 10/giờ/user, rate-limit hit → im lặng bỏ qua (A-02). | Đề xuất: giữ đúng 10 critiques/giờ/user cho LIVE, giữ nguyên hành vi "im lặng bỏ qua". | BA confirm đúng nguyên văn đề xuất — giữ đúng 10 critiques/giờ/user cho LIVE, giữ nguyên hành vi "im lặng bỏ qua" khi đạt rate-limit (kế thừa A-02). | ✅ Confirmed |
| QN-4.12.3-03 | Card stack UI — có giữ đúng "2 card visible + scroll, không tự rớt, không giới hạn tổng" như SIM đã chốt (A-05), hay LIVE cần UX khác? | Đề xuất: giữ nguyên UI behavior đã chốt ở SIM A-05. | BA confirm đúng nguyên văn đề xuất — giữ nguyên UI behavior đã chốt ở SIM A-05 (2 card visible trong viewport, scroll xem card cũ, không auto-expire, không giới hạn tổng số lưu trong stack). Chỉ event source khác (QN-4.12.3-01), không phải UI component khác. | ✅ Confirmed |
| QN-4.12.3-04 | [MODULE MISMATCH — 🟡 non-blocking, giống UC_4.12.2] WBS hiện tại liệt kê UC_4.12.3 dưới module Global Shell, nhưng A-07 (dashboard_common) ghi BA xác nhận Desk Manager thuộc module Overview cho CẢ SIM VÀ LIVE. | Không tự suy diễn — đề xuất trả lời đồng thời với QN-4.12.2-04. | BA confirm: giữ module Global Shell theo WBS mới — cùng quyết định với QN-4.12.2-04 (BA đổi ý khi renumber 2026-08-10). A-07 (dashboard_common) coi như đã được SUPERSEDE bởi quyết định renumber này cho LIVE. | ✅ Confirmed — giữ module Global Shell, A-07 superseded cho LIVE |
| QN-4.12.3-05 | [ROUND 2 — 2026-08-16] Card text (row 2, Screen Description) đang để [PENDING — BA/BE confirmation] cho 2 event LIVE-only DEFENSE_TRIGGERED và POD_DYNAMICS. Cần bảng mapping prompt đầy đủ cho 2 event này, tương tự BR_4.8.3.5 của SIM. | Không tự suy diễn nội dung prompt — chờ BA cung cấp nguyên văn hoặc dùng nguyên văn nguồn gốc RFQ nếu BA không cung cấp riêng. | BA chốt: POD_DYNAMICS (constraint 8) — BA cung cấp nguyên văn thay thế (2026-08-16), ghi đè nội dung gốc RFQ: "Apply the Pod Role constraint. If they are the Leader, tell them they finally earned their keep off the backs of their team. If they are a Member, tell them to thank their leader for dragging them across the finish line." Chỉ nội dung constraint 8 đổi — số thứ tự constraint (8) giữ đúng theo numbering gốc của RFQ (không đổi thành "24" — "24" trong RFQ chỉ là mốc Level scale 1-24, không phải số thứ tự event/constraint). DEFENSE_TRIGGERED (constraint 4) — BA chưa cung cấp nguyên văn riêng cho LIVE; dùng nguyên văn gốc RFQ không đổi: "If event_type is DEFENSE_TRIGGERED, act as the Warden who pulled the plug to save his money." ⚠️ Cần BA re-confirm nếu muốn nguyên văn khác cho event này — hiện tại là placeholder nguồn gốc, không phải BA-instruction riêng như POD_DYNAMICS. | ⚠️ Partially confirmed — POD_DYNAMICS ✅ Confirmed (BA-supplied wording); DEFENSE_TRIGGERED dùng tạm nguyên văn RFQ, chờ BA xác nhận lại |
- CR Conflict Check: Không có CR nào tham chiếu Desk Manager/GEKKO_CHATTER.
- Same-category consistency (
STAGE 2.2: DASHBOARD LIVE): UC_4.12.3 là điểm duy nhất trong LIVE module Global Shell mô tả AI commentary — không có sibling UC nào khác trong LIVE trùng nội dung.
- Cross-category dependency: "AI Chat Toggle" (Settings & Profile Module,
dashboard_v7_full.txt L592-595) — theo A-04 (SIM UC_4.8.3), toggle thuộc 1 UC Settings riêng chưa có trong WBS. LIVE có UC_4.17 (Settings — Market Data Management) nhưng KHÔNG có mục AI Chat Toggle rõ ràng — cần flag tương tự A-04 cho LIVE: toggle vẫn thuộc UC Settings riêng (chưa xác định), không thuộc UC_4.12.3.
- Orphan-UC check: UC_4.12.3 xác nhận tồn tại trong WBS,
status_design: "Done" (đã có thiết kế) nhưng KHÔNG có mapping_design (Figma link) trong lần parse hiện tại — cần verify lại trước khi Architect viết SRS (khác SIM UC_4.8.3 cũng thiếu Figma link tương tự).
| Action | Uniqueness | Cascade | Reversibility | Concurrency |
|---|
| Rate limit 10 critiques/giờ đạt ngưỡng | Theo user | Card mới không render tới khi bucket refill (kế thừa A-02/A-06 từ SIM) | N/A (tự refill theo thời gian) | Không phát hiện race condition trong nguồn |
| Date | Version | Updated item | Before | After | Notes |
|---|
| 2026-08-12 | v1 | Initial creation | — | 4 QnA items (kế thừa spec engine từ SIM UC_4.8.3, mở câu hỏi event-set LIVE-specific + module mismatch) | Init Flow Step 1+2. |
| 2026-08-12 | v1.1 | BA review — trả lời 4/4 câu | Toàn bộ ⏳ Chờ BA | QN-4.12.3-01 ✅ Confirmed (khác đề xuất — LIVE có thêm event STAGNATION LIVE-only, không xảy ra ở SIM); QN-4.12.3-02/03 ✅ Confirmed (đúng đề xuất); QN-4.12.3-04 ✅ Confirmed (giữ module Global Shell) | BA (Trang Nguyen) trả lời trực tiếp 2026-08-12 |
| 2026-08-14 | v1.2 | Correction — đảo lại QN-4.12.3-01 | QN-4.12.3-01: STAGNATION = LIVE-only, không xảy ra ở SIM | QN-4.12.3-01: STAGNATION = SIM-only, KHÔNG xảy ra ở LIVE. LIVE-only event set chính xác là DEFENSE_TRIGGERED + POD_DYNAMICS | Theo yêu cầu đảo lại từ client/BA (2026-08-14). SRS UC_4.12.3_v1.md (Overview, Post-conditions, Basic Flow, BR_4.12.3.1, Screen Description) và SRS UC_4.8.3_v1.md (SIM — thêm STAGNATION vào event list + bảng prompt mapping BR_4.8.3.7) đã được đồng bộ cập nhật. |
| 2026-08-16 | v1.3 | BA review round 2 — thêm bảng mapping prompt LIVE-only (QN-4.12.3-05) | Card text (row 2) = [PENDING — BA/BE confirmation]; không có BR mapping riêng cho DEFENSE_TRIGGERED/POD_DYNAMICS | Thêm BR_4.12.3.4 (bảng 2 dòng: DEFENSE_TRIGGERED constraint 4 nguyên văn RFQ; POD_DYNAMICS constraint 8 với nội dung BA-supplied mới, số thứ tự constraint giữ nguyên = 8). Screen Description row 2 cập nhật trỏ tới BR_4.12.3.4, bỏ [PENDING]. | BA (Trang Nguyen) cung cấp nguyên văn POD_DYNAMICS mới 2026-08-16; DEFENSE_TRIGGERED tạm dùng nguyên văn RFQ gốc — chưa có instruction riêng, cần BA re-confirm. |