# IMPLEMENTATION-READINESS — Điều kiện cần xác minh trước khi lập trình production

> Danh sách kiểm, **không phải kế hoạch triển khai** và không bắt đầu Phase 3. Prototype Phase 2 chỉ là thiết kế tĩnh với **dữ liệu minh họa**; không phải mã production, không có backend/xác thực/Gemini thật.

## 1. Nguồn sự thật cần có
- [ ] Tìm và đối chiếu **tài liệu Phase 1 gốc** (không có trong dự án; mọi “quy tắc Phase 1” hiện chỉ lấy từ các brief). Nếu mâu thuẫn thì Phase 1 thắng.
- [ ] Xác nhận `PRODUCT-DECISIONS.md` với chủ sản phẩm; đóng các mục **mức CAO** trong `OPEN-DECISIONS.md`.
- [ ] Danh sách đề/dữ liệu thật và cấu trúc đề TOPIK I, trước kỳ 35 (hiện “Chưa có thông tin”).

## 2. Nghiệp vụ phải chốt trước khi lập trình
- [ ] Chấm điểm, thang điểm, công bố, quyền xem lại, chấm phần Viết (không có AI chấm trong thiết kế).
- [ ] Chính sách khách và liên kết dữ liệu khách với tài khoản.
- [ ] Phân quyền quản trị; quy trình chuyển trạng thái nội dung; vận hành Gemini (kích hoạt, lỗi, phiên bản).
- [ ] Tiếp tục/Làm lại đề thi; định nghĩa “hoàn thành” bộ luyện; lưu/khôi phục tiến độ.

## 3. Kỹ thuật cần xác minh
- [ ] Stack dự kiến (Laravel + MySQL, Firebase Auth, Gemini, shared hosting) chỉ lấy từ `tools/ju/README.md` — xác minh năng lực hosting (âm thanh, hàng đợi, thư gửi).
- [ ] Mô hình dữ liệu: các khái niệm Admin (Question, Question Group, Shared Context, Answer, Explanation, Translation, Media Asset) là khái niệm thông tin, **chưa phải schema**.
- [ ] Máy chủ là nguồn sự thật cho: xác thực, phân quyền, đáp án chỉ trả sau khi được phép, trạng thái “đã xem đáp án”/khóa, kiểm tra `next` sau đăng nhập, điều kiện xuất bản (tiếng Việt cho mọi câu).
- [ ] Media: định dạng, bản quyền, alt, lưu trữ/phân phối, phát âm thanh đúng quy tắc Exam Taking.
- [ ] Routing/SEO production: URL 11 danh mục + Luyện kỹ năng, canonical/hreflang, sitemap XML, noindex cho trang cá nhân/phiên.
- [ ] Hiệu năng phông chữ (hiện dùng Google Fonts; cân nhắc tự host/subset), bundle nhẹ cho shared hosting.

## 4. Nội dung và ngôn ngữ
- [ ] Bản dịch giao diện (5 ngôn ngữ) và nội dung tiếng Hàn minh họa **chưa được người bản ngữ duyệt**.
- [ ] Quy trình duyệt lời giải/bản dịch tiếng Việt (bắt buộc V1) và các ngôn ngữ bổ sung.

## 5. Kiểm thử chưa thực hiện
Trình đọc màn hình; thiết bị thật; Safari/Firefox; cỡ chữ hệ thống lớn; tương phản viền/biểu tượng bằng công cụ ngoài; thứ tự Tab toàn trang bằng phím thật; kiểm thử bảo mật/xác thực; hiệu năng; phiên thi đầy đủ quan sát DOM lúc làm bài. Chỉ dùng Chromium trong ứng dụng.

## 6. Dữ liệu minh họa ≠ production
Đề, câu, số bộ/số câu, điểm, ngày, người dùng, số liệu Dashboard/Admin đều là **minh họa**; cờ đăng nhập/`?auth=`/`?sim=`/`?state=` chỉ là công cụ xem prototype.