Vocab Management Dashboard (User Center)
Reading Rule
Phần tiêu đề “Reading Rule”- Nếu cần full navigation canon, mở
../ENG_Navigation_00_Overview.mdtrước. - Nếu cần owner overview của
Từ vựng, mở./VOC_00_Overview.mdtrước. - File này là
page-speccủa dashboard owner, không thay feature-master và không thayVOC_00_Overview.
1. Tổng quan
Phần tiêu đề “1. Tổng quan”Dashboard (hay “Sảnh chờ”) là điểm chạm đầu tiên của User với tính năng Từ vựng. Đây không phải là nơi diễn ra phiên học (Session), mà là trung tâm chỉ huy để User:
- Theo dõi sức khỏe trí nhớ 24/7 (qua Heatmap & Stats).
- Quản lý nguồn từ vựng (Course list, Personal list, Community list).
- Kích hoạt hành động (Học bài mới, Ôn lại bài sai, Khám phá thêm).
Câu hỏi chính của trang là: Hôm nay tôi cần ôn từ nào, và đã nhớ tới đâu?
1.1 Shell fit
Phần tiêu đề “1.1 Shell fit”- Đây là owner page chính của destination
Từ vựngtrongProgram Workspace. - Nếu
Program Workspace root / Hôm nayhoặc aggregate view đủ điều kiện surfacing card nhắc ôn từ, các card đó chỉ là shortcut; review queue, memory health, và session launch vẫn phải đọc từ dashboard/engine củaTừ vựng. - Nếu shortcut dẫn tới vocab item thuộc program khác, app phải đổi sang đúng
Program Workspacemột cách tường minh trước khi mở dashboard/session.
2. Cấu trúc Giao diện
Phần tiêu đề “2. Cấu trúc Giao diện”Dựa trên Concept Design, Dashboard được chia thành 5 khu vực chức năng chính từ trên xuống dưới:
A. Motivation & Status Header
Phần tiêu đề “A. Motivation & Status Header”Khu vực này có vai trò “Welcome” và tạo động lực tức thì.
- User Greeting: Chào theo thời gian (Sáng/Chiều/Tối) + Tên User.
- Daily Progress Widget:
- Thanh tiến độ mục tiêu ngày (Ví dụ: 15/30 từ).
- Streak Counter: Số ngày liên tục (Icon ngọn lửa). Đây là habit signal phụ; ở giai đoạn học thật sự đều,
Today Focus,review due, vàmemory healthphải quan trọng hơn.
- Quick Stats (Optional):
- Rank hiện tại hoặc điểm tuần hiện tại (
Learning Points/ điểm quy đổi theo scope surfacing). - Tổng số từ “Đã thuộc” (Mastered).
- Rank hiện tại hoặc điểm tuần hiện tại (
A1. Daily Vocab Coach (AI Surface)
Phần tiêu đề “A1. Daily Vocab Coach (AI Surface)”Đây là surface AI inline của trang Vocabulary. Nó không thay session học, mà giúp user trả lời nhanh:
Hôm nay tôi nên ôn gì trước?Từ nào đang dễ quên hoặc đáng ưu tiên?Từ nào từ bài hôm qua nên activate tiếp cho Writing/Speaking?
Baseline của Daily Vocab Coach:
- archetype bắt buộc:
queue_guide.review-first, - nằm gần đầu trang, đi cùng Today Focus thay vì tách thành chat riêng,
- tóm tắt ngắn
due words + forget-prone words + source context gần nhất, - CTA chính mặc định:
Ôn nhanh 5 phút, - CTA phụ chỉ khi có giá trị rõ:
Xem từ từ bài hôm qua,Ôn nhóm từ hay quên,Dùng từ này cho Writing/Speaking.
- Vocabulary surface này không nên biến thành strategy panel hay performance report; job chính vẫn là
ôm đúng queue từ cần ôn và activation tiếp theo.
Nếu user mở AI Tutor từ Vocabulary:
- dùng cùng persona AI Tutor của toàn hệ,
- drawer mở on-demand,
- tab mặc định là
Kế hoạch, - context ưu tiên
memory health + today queue + activation task.
A2. Today Focus Queue (Primary Action)
Phần tiêu đề “A2. Today Focus Queue (Primary Action)”Khu vực này là điểm hành động chính để giảm ma sát và tránh user bị ngợp.
- Primary CTA:
Ôn ngay (5 phút)(mặc định cho user có dữ liệu ôn tập). - Today Focus cap: chỉ hiển thị top 20 mục trong ngày.
- Quick-start subset: phiên nhanh mặc định 5 mục.
- Priority nguồn:
- Từ đến hạn cần ôn (due review).
- Từ gợi ý hợp lệ từ kết quả bài tập.
- Từ gợi ý theo chương trình/khóa học.
- Fallback xu hướng theo chương trình.
- Overload governor:
- Nếu backlog > 40: tạm dừng đưa mục mới vào Today Focus (đưa về inbox).
- Khi backlog <= 30: mở lại intake vào Today Focus.
B. Smart Action: “Từ các bài tập bạn làm sai” (Auto-generated Lists)
Phần tiêu đề “B. Smart Action: “Từ các bài tập bạn làm sai” (Auto-generated Lists)”Đây là tính năng thông minh giúp cá nhân hóa lộ trình học. Hệ thống tự động gom nhặt các “lỗ hổng kiến thức” của User.
- Logic nguồn: Khi User làm bài tập Reading, Listening, hay Grammar trên DOL platform và bị sai câu liên quan đến từ vựng -> Hệ thống tự động thêm từ đó vào hàng đợi “Cần xem lại”.
- Quy tắc hiển thị:
- Gom nhóm theo kỹ năng hoặc bài test (Ví dụ: “IELTS Reading Test 1”, “Listening Practice 5”).
- Hiển thị số lượng từ sai cần review.
- Hành động: Nút “Ôn tập ngay” -> Mở một Review Session đặc biệt chỉ chứa các từ này.
C. List Management: “Danh sách của bạn” & “Danh sách từ DOL”
Phần tiêu đề “C. List Management: “Danh sách của bạn” & “Danh sách từ DOL””Khu vực chính để user chọn nội dung học chủ động.
1. Danh sách của bạn (My Lists)
Phần tiêu đề “1. Danh sách của bạn (My Lists)”Các bộ từ vựng user đang theo đuổi.
- List khóa học (Course Lists): Tự động sync từ khóa học User đã mua (Ví dụ: “IELTS 6.0 - Vocab Pack”).
- Personal Lists: User tự tạo (Ví dụ: “Từ vựng Harry Potter”).
- Saved Lists: Lưu từ cộng đồng/thư viện về.
- Card UI:
- Tên bộ từ.
- Progress Bar: % số từ đã thuộc (Mastered/Total).
- Nút CTA: Tiếp tục học (nếu đang dở) hoặc Ôn tập (nếu đã xong nhưng đến hạn SRS).
2. Danh sách từ DOL (DOL Library / Community)
Phần tiêu đề “2. Danh sách từ DOL (DOL Library / Community)”- Khu vực khám phá các bộ từ vựng chuẩn hóa do DOL biên soạn.
- Phân loại theo nhu cầu: IELTS, TOEIC, SAT, Giao tiếp, Chuyên ngành.
- Có thể Preview và “Add to My Lists”.
D. Analytics Dashboard (“Thống kê số của bạn”)
Phần tiêu đề “D. Analytics Dashboard (“Thống kê số của bạn”)”Khu vực Review & Self-reflection (Nhìn lại quá trình).
- Key Metrics:
- Tổng số từ đã học (Total Learned).
- Số từ Mastered (Độ sâu của trí nhớ).
- Tổng giờ học tích lũy.
- Activity Heatmap (Biểu đồ nhiệt):
- Concept: Giống GitHub Contribution Graph.
- Hiển thị: Lưới lịch 365 ngày (hoặc 6 tháng). Các ô đậm màu thể hiện ngày học chăm chỉ (nhiều reviews/new words), ô nhạt màu là học ít.
- Mục đích: User nhìn vào “khoảng trống” để thấy tiếc nuối -> Động lực lấp đầy biểu đồ, không để đứt mạch.
3. User Flows chính
Phần tiêu đề “3. User Flows chính”Flow 1: Daily Maintenance (Duy trì thói quen)
Phần tiêu đề “Flow 1: Daily Maintenance (Duy trì thói quen)”- User vào Dashboard thấy Streak và nhận thông báo chưa hoàn thành mục tiêu ngày.
- Nhìn xuống Heatmap thấy ô hôm nay còn “trắng”.
- Bấm “Ôn ngay (5 phút)” từ Today Focus.
- Hệ thống mở Vocab Learner (V2 Core).
- Hoàn thành phiên -> Quay lại Dashboard -> Heatmap sáng màu, Streak +1.
Flow 2: Fix Mistakes (Vá lỗ hổng kiến thức)
Phần tiêu đề “Flow 2: Fix Mistakes (Vá lỗ hổng kiến thức)”- User vừa làm xong một bài Reading Test và sai nhiều.
- Vào Dashboard, thấy mục “Từ bài tập bạn đã làm sai” xuất hiện list mới: “Reading Test #5 - 12 từ”.
- Bấm “Ôn ngay”.
- Hệ thống mở phiên Review tập trung vào 12 từ này kèm ngữ cảnh câu sai.
Flow 3: High Backlog, No Overwhelm
Phần tiêu đề “Flow 3: High Backlog, No Overwhelm”- User có lượng từ đến hạn lớn (backlog > 40).
- Dashboard vẫn hiển thị Today Focus gọn (top 20), không đẩy toàn bộ backlog ra cùng lúc.
- User tiếp tục học theo phiên nhanh hoặc phiên thường.
- Mục mới tiếp tục ở inbox cho đến khi backlog về ngưỡng <= 30.
4. Tương tác với Vocab V2 Core Logic (Technical Context)
Phần tiêu đề “4. Tương tác với Vocab V2 Core Logic (Technical Context)”Trang Dashboard này đóng vai trò là UI Layer (Presentation), gọi xuống Vocab V2 Engine:
| Dashboard Element | Gọi API / Logic V2 |
|---|---|
| Streak/Stats | Query UserVocabProfile để lấy streak, total_mastered. |
| Progress Bar | Tính toán dựa trên ItemStatus (số lượng item có F > 0 / Total items in set). |
| Nút “Học ngay” | Khởi tạo một Session mới. Truyền tham số set_id và mode (Learn/Review) vào engine. |
| Today Focus Queue | Query queue theo priority + cap (20) + quick-start subset (5) + overload governor (40/30). |
| Heatmap | Query LearningLogs (lịch sử activity) để map ra tần suất. |
References
Phần tiêu đề “References”./VOC_00_Overview.md./Vocab v2/VOCV2_00_Overview.md../Practice Flow/PRA_Result_Impact_Contracts.md../../../../Shared/Shared Capabilities/Smart Search Platform/SSP_00_Overview.md../../../../Shared/Shared Capabilities/Smart Search Platform/contracts/SSP_Context_Pack_Adapter_Contracts.md
Change log
Phần tiêu đề “Change log”- 2026-03-26: Đồng bộ dashboard với navigation shell mới: thêm
Shell fitđể giữ rõ shortcut từ lớp điều phối bên ngoài không thay owner page củaTừ vựng. - 2026-03-19: Repoint Smart Search references sang canonical shared capability path.
- 2026-03-16: Chốt
Daily Vocab Coachtheo archetypequeue_guide.review-first; Vocabulary AI inline ưu tiên due queue + activation step, không đọc như strategy/report surface. - 2026-03-14: Đồng bộ Vocabulary Dashboard theo lifecycle contract:
Streakkhông còn được mô tả như hero gamification cố định;Today Focus,review due, vàmemory healthlà owner signals chính. - 2026-03-13: Bổ sung
Daily Vocab Coachnhư AI surface inline của Vocabulary Dashboard; CTA chínhÔn nhanh 5 phút, drawer mở on-demand với tab mặc địnhKế hoạch. - 2026-03-11: Chốt
main questioncủa Vocab Dashboard làhôm nay cần ôn từ nào và đã nhớ tới đâuđể giữ trọng tâm vào daily review + memory health. - 2026-02-21: Bổ sung Today Focus Queue làm primary action, cap 20 mục/ngày, quick-start 5 mục và overload governor 40/30 để giữ trải nghiệm tinh gọn.
- 2026-03-09: Dọn wording
Rank/LevelsangRank/Pointsđể đồng bộ current rollout points-only.