Phần 叁 · Sản phẩm & lộ trình

Sản phẩm đã có thật — gần tới TestFlight, không phải slide ý tưởng.

App iOS native (SwiftUI) + backend PocketBase đang chạy. HSK1 + bộ chữ có animation đã xong. Còn lại là verify lõi trên máy thật → bật đăng nhập → phát hành.

Đã build

壹Trạng thái hiện tại (thật)

Đây không phải dự phóng — là trạng thái code/nội dung thực tế tới 20/6/2026.

175 từ
HSK1 đầy đủ — 15/15 bài seed production
182 / 182
Chữ có animation viết nét (WebM) + duyệt art
70 thẻ
Khái niệm nền tảng (pinyin, nét, bộ thủ)
Phase 0–3
Đọc · stroke engine + quiz · auth + SRS — xong

✅ Đã xong

  • Đọc nội dung (list cấp → bài → từ → thẻ chữ), cache offline.
  • Stroke engine: animate từng nét + quiz luyện viết (so nét với mẫu).
  • Auth email/mật khẩu (Keychain) + lớp dữ liệu SRS (SM-2) theo từng chữ.
  • Màn ôn tập SRS + flow ghi danh chữ mới vào lịch ôn.
  • App icon con dấu 开, audio phát âm (TTS zh-CN trên máy).

🚧 Còn lại (ngắn)

  • ① Test chấm điểm viết tay trên iPhone thật — cổng quyết định (lõi sản phẩm).
  • ② Bật Google OAuth trên PocketBase production (code app đã sẵn).
  • ③ Phase 4 → TestFlight: Apple Developer ($99/năm) → archive → mời tester.
Ưu tiên

貳Tính năng xếp theo nỗi đau — không làm thừa

Mỗi tính năng phải truy về 1 nỗi đau "quên chữ". Tính năng không phục vụ trực tiếp việc nhớ chữ bị hạ ưu tiên.

Nỗi đauTính năng giảiTrạng thái
Quên cách viếtQuiz luyện viết chấm theo nét + animation mẫu✅ Có (cần test máy thật)
Ôn không đúng lúc → quênSRS (SM-2) đẩy chữ sắp quên lên đúng thời điểm✅ Có
Học chữ không có logicBộ thủ + mnemonic + nền tảng pinyin/nét (70 thẻ)✅ Có
Không biết phát âmAudio TTS zh-CN từng từ + từng chữ✅ Có
Lẫn chữ gần giốngBài tập phân biệt cặp chữ dễ lẫn🔜 Backlog
Mất động lựcStreak, thử thách 30 ngày, thành tích viết🔜 Sau PMF
Nhớ nhờ tiếng ViệtÂm Hán–Việt gắn mỗi chữ (lợi thế độc quyền)✅ Có trong data (sino_viet)
Kỹ thuật

叁Lộ trình kỹ thuật (iOS)

Stack: iOS native SwiftUI · backend PocketBase (DB + auth, live tại pb.kaihanzi.com) · stroke engine port từ hanzi-writer-data · SRS SM-2 đơn giản (unit-tested).

Xong

Phase 0–1 · Nền + đọc nội dung

Scaffold SwiftUI + PBClient (REST), models Codable. UI đọc content read-only, cache offline JSON.

Xong

Phase 2 · Stroke engine + quiz viết

SVG path → CGPath (hệ 1024×1024), animate từng nét, quiz so touch với mẫu (medians).

Xong

Phase 3 · Auth + SRS

Auth PB email/pw (Keychain, auto-refresh), SRS theo character (user_progress + review_logs, owner-only), màn ôn tập + ghi danh chữ mới. Google OAuth code app-side (PKCE) sẵn.

Đang · cổng

Verify lõi trên iPhone thật

Test chấm điểm viết tay trên device: viết đúng/sai/ngược nét, chữ nhiều nét (您 11 nét), màn SRS đếm đúng. Hỏng = chỉnh ngưỡng so khớp trước mọi thứ.

Nội dung

肆Lộ trình nội dung HSK 1→9

Đi sâu trước, rộng sau: HSK1 hoàn chỉnh (đã xong) → HSK2 → HSK3, rồi mở dần tới HSK9 (chuẩn HSK 3.0: 3.000 chữ, 1.200 chữ viết tay).

Đã có

  • Nền tảng (cấp 0): 6 bài, 70 thẻ khái niệm.
  • HSK1: 15 bài, 175 từ, 182 chữ có animation.

Kế tiếp

  • HSK2 → HSK3 (ưu tiên trong các phiên tới).
  • Mở rộng dần HSK4–9 theo tiến độ người dùng.
  • Bổ sung: audio file chất lượng cao, bài phân biệt chữ dễ lẫn.

Mỗi cấp HSK = một "đồng hồ đếm ngược" tự nhiên giữ chân người dùng nhiều tháng (1.200 chữ viết tay không thể nhớ trong vài tuần).

Phát hành

伍Mốc ra mắt

MốcĐiều kiệnKết quả
M0 · Verify lõiChấm viết tay đúng trên iPhone thậtTự tin lõi sản phẩm hoạt động
M1 · TestFlight nội bộOAuth bật + Apple Dev + archiveCô giáo + nhóm nhỏ dùng thật
M2 · Beta cộng đồngThu feedback, sửa lỗi quiz/SRS~100–500 user (xem Marketing)
M3 · App Store + trả phíRetention đạt ngưỡngBật Premium, mở phễu rộng

Mốc theo điều kiện (gate-based), không ép theo ngày — đúng tinh thần "không scale khi chưa có PMF". ~ kế hoạch

Đo lường

陸Chỉ số giữ chân cần đạt

Sản phẩm trí nhớ sống bằng retention. Đây là các chỉ số quyết định có scale hay không.

D1 / D7 / D30
Quay lại — chỉ số sống còn của app học tập
% hoàn thành
Tỷ lệ hoàn thành bài luyện viết mỗi phiên
SRS đúng giờ
% chữ được ôn đúng lúc đến hạn (chất lượng SRS)
Chữ/người/tuần
Số chữ học + ôn — đo độ gắn kết thật

Vòng lặp lõi (core loop)

Học chữ mới → vào lịch SRS → đến hạn ôn → viết lại → nhớ lâu hơn. Vòng này càng mượt, retention càng cao. Mọi tính năng mới phải làm vòng này tốt hơn, không làm nó loãng.