Vocabulary Management Screen Inventory

DomainsDOL EnglishUX1.470 words7 min read

activebyDOL Product Design

Vocabulary Management - Screen Inventory

Purpose

Chuẩn hóa danh sách màn hình cần triển khai cho area Vocabulary Management theo hướng flow-complete skeleton.
Chốt trước khung flow pre-login / post-login, rồi mới polish UI từng màn.
Đảm bảo các CTA học/ôn không tạo guest dead-end và luôn giữ returnTo context.

Source Review Scope (đã rà soát)

Core area docs:
- VOC_00_Overview.md
- VOC_Management_Dashboard.md
Vocab v2 overview + hardening:
UX flow docs:
UI logic mapping docs:
Business / engagement docs:
User management docs:
- Vocab v2/User Management/MANA_Admin_Mangage_Set.md

Assumptions for this inventory

Canonical shell route của area là /domains/dol-english/vocab.
Đây là inventory cho docs UX flow; không khóa cứng layout pixel-level.
Option A / Option B của Pro access chưa chốt sản phẩm cuối, nên cả hai đều cần được hỗ trợ ở mức route/state.
Archive docs trong Vocabulary Management/Archive/** được coi là legacy context, không dùng làm SoT.

Screen Inventory (Recommended)

ID	Layer	Screen	Canonical route	Required state	Priority	Notes
VOC-S01	Hub	Vocabulary entry (auth-aware)	`/domains/dol-english/vocab`	Pre + Post	P0	Entry chính cho toàn area
VOC-S02	Hub	Vocabulary guest landing	`/domains/dol-english/vocab`	Pre	P0	Showcase giá trị + CTA login
VOC-S03	Hub	Vocabulary dashboard	`/domains/dol-english/vocab`	Post	P0	Header + quick actions + lists + stats
VOC-S04	Hub	Member shortcut alias	`/domains/dol-english/vocab/member`	Transition	P1	Login shortcut tương thích link cũ
VOC-S05	Hub tab	Gợi ý (Suggestions) tab view	`/domains/dol-english/vocab?tab=suggestions`	Post	P0	Ưu tiên từ bài làm sai
VOC-S06	Hub tab	Danh sách của bạn tab view	`/domains/dol-english/vocab?tab=my-list`	Post	P0	My Lists theo tiến độ
VOC-S07	Hub tab	Cộng đồng / thư viện tab view	`/domains/dol-english/vocab?tab=community`	Post	P1	Discover + save list
VOC-S08	Hub tab	Thống kê số tab view	`/domains/dol-english/vocab?tab=stats`	Post	P0	KPI + heatmap + trend
VOC-S09	Hub panel	Smart mistakes queue	`/domains/dol-english/vocab?panel=mistakes`	Post	P0	Auto-list từ PRA sai
VOC-S10	Hub panel	Quick actions rail	`/domains/dol-english/vocab?panel=quick-actions`	Post	P1	Jump đến session/list/stats
VOC-S11	List	My list detail	`/domains/dol-english/vocab/lists/:listId`	Post	P0	Item list + progress + CTA học
VOC-S12	List	Course list detail	`/domains/dol-english/vocab/course-lists/:listId`	Post	P0	Sync từ khóa học
VOC-S13	List	Community list detail (preview)	`/domains/dol-english/vocab/library/:listId`	Pre + Post	P1	Pre vẫn xem được list metadata
VOC-S14	List	Create personal list	`/domains/dol-english/vocab/lists/new`	Post	P1	Tạo bộ từ tự quản
VOC-S15	List	Edit list metadata	`/domains/dol-english/vocab/lists/:listId/edit`	Post	P1	Rename/description/visibility
VOC-S16	List	List search/filter state	Same list routes	Post	P1	Filter theo trạng thái/học phần
VOC-S17	Session	Session launcher (start gate)	`/domains/dol-english/vocab/session/start?scope=*`	Pre + Post	P0	Quyết định học/ôn + mode
VOC-S18	Session	Access lock / Pro upsell modal	Same as session start	Pre + Post	P0	Theo Option A/B contract
VOC-S19	Session	Timed session screen	`/domains/dol-english/vocab/session/:sessionId`	Post	P0	Timed 10–20 phút
VOC-S20	Session	Untimed session screen	`/domains/dol-english/vocab/session/:sessionId?mode=untimed`	Post	P1	Học không giới hạn
VOC-S21	Session	Retry / urgent insertion state	Same session route	Post	P1	Item fail quay lại sau 1-2 item
VOC-S22	Session	Pause / exit confirm	Same session route (modal)	Post	P1	Không mất dữ liệu item đã submit
VOC-S23	Recap	Session recap overview	`/domains/dol-english/vocab/recap/:sessionId`	Post	P0	Accuracy/volume/duration + level-up
VOC-S24	Recap	Recap detail drawer/modal	Same recap route	Post	P1	Xem chi tiết từng item
VOC-S25	Recap	Quick-fix mini session	`/domains/dol-english/vocab/recap/:sessionId/quick-fix`	Post	P1	“Sửa nhanh 3 từ cần chăm sóc”
VOC-S26	Garden	Garden progress view	`/domains/dol-english/vocab/garden`	Post	P1	Level distribution + health buckets
VOC-S27	Garden	Garden interaction mode	`/domains/dol-english/vocab/garden?mode=interactive`	Post	P2	Explore/visit/animation mode
VOC-S28	Leaderboard	Leaderboard entry	`/domains/dol-english/vocab/leaderboard`	Post	P1	Hub chọn Set/Course/Global
VOC-S29	Leaderboard	Set leaderboard	`/domains/dol-english/vocab/leaderboard?scope=set&setId=*`	Post	P1	Top Cultivators / Sharpshooters
VOC-S30	Leaderboard	Course leaderboard	`/domains/dol-english/vocab/leaderboard?scope=course&courseId=*`	Post	P1	Class Sprinters / Sun-chasers
VOC-S31	Leaderboard	Global leaderboard	`/domains/dol-english/vocab/leaderboard?scope=global`	Post	P1	4 realms (maintenance/heroism/legacy/fun)
VOC-S32	Social	Visit garden profile	`/domains/dol-english/vocab/garden/:userId`	Post	P2	Social nudge / cheer
VOC-S33	Analytics	Analytics overview	`/domains/dol-english/vocab/analytics`	Post	P1	KPI theo session/item/funnel
VOC-S34	Analytics	Activity heatmap detail	`/domains/dol-english/vocab/analytics?view=heatmap`	Post	P1	Monthly/yearly contribution
VOC-S35	Notification	Reminder inbox / center	`/domains/dol-english/vocab/notifications`	Post	P2	Urgency/social/system notifications
VOC-S36	Settings	Reminder preference & DND	`/domains/dol-english/vocab/settings/reminders`	Post	P2	Frequency cap + quiet hours
VOC-S37	Admin	Admin set moderation list	`/domains/dol-english/admin/vocab/sets`	Admin	P2	View/Warn/Delete user sets
VOC-S38	Admin	Admin warning detail	`/domains/dol-english/admin/vocab/sets/:setId/warn`	Admin	P2	Warning flow + deadline
VOC-S39	Admin	Admin audit log	`/domains/dol-english/admin/vocab/audit-log`	Admin	P2	View actions `VIEW/WARN/DELETE`
VOC-S40	Guardrail	Protected action auth flow	Vocabulary routes with protected CTA	Pre + Transition	P0	Auth-first + returnTo
VOC-S41	Guardrail	Invalid list/session fallback	Invalid `listId/sessionId`	Pre + Post	P0	Fallback deterministic về hub
VOC-S42	Guardrail	Empty states (no list/no urgent/no stats)	Hub/list/analytics routes	Pre + Post	P0	Không dead-end
VOC-S43	Guardrail	Network sync/retry state	Session + recap	Post	P1	Retry save / offline cache hint
VOC-S44	Guardrail	Logout context retention	Current vocabulary route	Transition	P0	Logout vẫn giữ route/context hợp lệ

Suggested Build Sequence (Vocabulary Management)

P0 flow kernel: VOC-S01 → S02/S03 → S05/S06/S08/S09 → S17/S18/S19 → S23 → S40/S41/S42/S44.
P1 product depth: VOC-S11/S12/S13/S14/S15/S16 → S20/S21/S22/S24/S25 → S26/S28/S29/S30/S31 → S33/S34/S43.
P2 ecosystem/admin: VOC-S27/S32/S35/S36/S37/S38/S39 + polish social/community behaviors.

Coverage Check Against UX Contract

Dual-state: đã map rõ entry hub (pre/post) và các action protected.
Auth-first + returnTo: bắt buộc ở VOC-S40 cho mọi CTA học/ôn.
No guest dead-end: guest có landing + preview list; CTA không chặn mù.
Logout giữ route context: chốt thành acceptance gate ở VOC-S44.

Open Gaps (from current docs)

Route contract chính thức cho session, recap, leaderboard, analytics chưa có file canonical riêng.
Chưa chốt dứt điểm Option A vs Option B của VOCV2_Access_Pro.md nên cần flag runtime khi dựng skeleton.
Social/community flow đã có concept nhưng thiếu acceptance matrix rõ cho quyền riêng tư và anti-gaming.
Admin moderation flow có logic nhưng chưa map vào IA shell chung của docs flow.

Next Area Queue

docs/Domains/DOL English/UX Design/Practice Flow/**

Change log

2026-03-15: Chuẩn hóa active route examples sang canonical /domains/dol-english/vocab và các family con liên quan để khớp runtime sitemap/bridge.
2026-02-15: Khởi tạo inventory màn hình cho Vocabulary Management theo docs root + Vocab v2 hardening, ưu tiên flow-complete skeleton.