MiniApp V3 — Full Screen Spec Pack

Purpose

Bộ tài liệu full spec theo từng màn cho miniapp_v2/miniapp, được tổng hợp từ:

1. miniapp_v2/miniapp (code hiện tại)
2. v2/libs/modules/* (backend code truth)
3. OLD_CODE/fit-miniapp-master (legacy behavior)
4. docs_hub_v3/06_BASELINE_ARCHIVE/docs_hub_v2_snapshot/specs/miniapp.md + _miniapp_screenspec_v2

Pack Structure

• 10_AUTH_BOOTSTRAP_AND_GUARDS.md
• 20_COMMERCE_SCREENS.md
• 30_ACCOUNT_SUPPORT_SCREENS.md
• 40_NEWS_SCREENS.md
• 90_ACCEPTANCE_MATRIX.md

Per-Screen Files (20/20)

• screens/S01_HOME.md
• screens/S02_SEARCH.md
• screens/S03_CART.md
• screens/S04_ORDERS.md
• screens/S05_ORDER_DETAIL.md
• screens/S06_PROFILE.md
• screens/S07_PRODUCT_DETAIL.md
• screens/S08_CHECKOUT.md
• screens/S09_CATEGORIES.md
• screens/S10_CATEGORY_PRODUCTS.md
• screens/S11_VOUCHERS.md
• screens/S12_NOTIFICATIONS.md
• screens/S13_SUPPORT.md
• screens/S14_ADDRESSES.md
• screens/S15_WRITE_REVIEW.md
• screens/S16_PRODUCT_REVIEWS.md
• screens/S17_NEWS_HOME.md
• screens/S18_NEWS_DETAIL.md
• screens/S19_NEWS_SEARCH.md
• screens/S20_SAVED_NEWS.md

Auxiliary Sub-Screens (8 files)

• sub_screens/X01_AUTH_GATE_MODAL.md
• sub_screens/X02_ADDRESS_PICKER_MODAL.md
• sub_screens/X03_ADDRESS_FORM_MODAL.md
• sub_screens/X04_CHECKOUT_SUCCESS_STATE.md
• sub_screens/X05_SUPPORT_CATEGORY.md
• sub_screens/X06_QA_CENTER.md
• sub_screens/X07_SEND_QUESTION.md
• sub_screens/X08_CONTACT_SUPPORT.md

Coverage Status

• Route screens: 20/20 complete.
• Auxiliary sub-screens: 8/8 complete.
• Legacy-referenced support/address subflows have dedicated specs for implementation in miniapp_v2.

Current Route Inventory (miniapp_v2)

Route	Screen	Legacy Ref (MA-xxx)	Spec File
/	Home	MA-016	20_COMMERCE_SCREENS.md
/search	Search	MA-029/MA-008	20_COMMERCE_SCREENS.md
/categories	Categories	MA-002	20_COMMERCE_SCREENS.md
/category/:id	CategoryProducts	MA-003	20_COMMERCE_SCREENS.md
/product/:id	ProductDetail	MA-005	20_COMMERCE_SCREENS.md
/cart	Cart	MA-009	20_COMMERCE_SCREENS.md
/checkout	Checkout	MA-014 + MA-010 + MA-034	20_COMMERCE_SCREENS.md
/orders	Orders	MA-011	20_COMMERCE_SCREENS.md
/order/:id	OrderDetail	MA-018	20_COMMERCE_SCREENS.md
/vouchers	Vouchers	MA-015	20_COMMERCE_SCREENS.md
/product/:id/reviews	ProductReviews	MA-053 (comment area)	20_COMMERCE_SCREENS.md
/write-review/:orderId/:productId	WriteReview	MA-021	20_COMMERCE_SCREENS.md
/profile	Profile	MA-039/MA-040	30_ACCOUNT_SUPPORT_SCREENS.md
/notifications	Notifications	MA-028	30_ACCOUNT_SUPPORT_SCREENS.md
/addresses	Addresses	MA-031/MA-033/MA-034	30_ACCOUNT_SUPPORT_SCREENS.md
/support	Support	MA-045/MA-046	30_ACCOUNT_SUPPORT_SCREENS.md
/news	NewsHome	MA-043	40_NEWS_SCREENS.md
/news/:slug	NewsDetail	MA-044	40_NEWS_SCREENS.md
/news/search	NewsSearch	(new in v3)	40_NEWS_SCREENS.md
/news/saved	SavedNews	(new in v3)	40_NEWS_SCREENS.md

Delivery Rules

• Mọi màn phải có: actor/auth, preconditions, API map, state/edge-case, analytics, acceptance.
• Chỗ backend chưa có endpoint trong code v2 sẽ được đánh dấu PROPOSED (MISSING IN V2).
• Tất cả thay đổi phải bám DEC-001/DEC-002 và matrix tại 03_TRACEABILITY/FEATURE_TAG_MATRIX_MINIAPP_V2.md.