User Stories — Tokyo Community

Góc nhìn người dùng cho tokyo.conan.school. Mỗi story theo mẫu "Là một Builder, tôi muốn ___ để ___", kèm tiêu chí chấp nhận (AC) và truy vết tới Requirements.

Personas

🧱 Builder mới (trial)

Vừa đăng nhập, đang thử hệ thống trong 7 ngày. Cần thấy giá trị nhanh và biết bắt đầu từ đâu.

🚀 Builder cam kết (paid)

Đang xây doanh nghiệp thật, dùng Tokyo đều đặn. Cần chiều sâu, cộng đồng và bằng chứng tiến bộ.

🕸️ Builder quay lại (free hết trial)

Trial đã hết, chưa nâng cấp. Vẫn xem được nội dung cơ bản, cần lý do rõ ràng để trả phí.

---

Nhóm: Onboarding & Membership

US-01 — Bắt đầu dùng thử · REQ-F-MEM-02, REQ-F-AUTH-03

Là một Builder mới, tôi muốn được tự động vào bản dùng thử đầy đủ khi đăng nhập lần đầu, để trải nghiệm trọn vẹn trước khi trả phí.

• AC: Lần đăng nhập đầu, hệ thống đặt trial 7 ngày; /api/user/me trả entitlement_group=trial, trial_days_left=7.
• AC: Trong trial, tôi truy cập được mọi tính năng như member trả phí.

US-02 — Biết còn bao nhiêu ngày · REQ-F-MEM-08

Là một Builder trial, tôi muốn thấy số ngày còn lại và lối nâng cấp, để chủ động quyết định.

• AC: /membership hiển thị trial_days_left và nút nâng cấp.

US-03 — Nâng cấp bằng chuyển khoản · REQ-F-MEM-06

Là một Builder, tôi muốn nâng cấp bằng chuyển khoản kèm số điện thoại, để được kích hoạt tự động, không chờ duyệt tay.

• AC: Chuyển khoản đạt ngưỡng + memo khớp mobile → tài khoản thành paid tự động.
• AC: Không có chuyển khoản thật thì không kích hoạt (OCR không đủ để duyệt).

US-04 — Không bị chặn cứng khi hết trial · REQ-F-MEM-04

Là một Builder hết trial, tôi muốn vẫn xem được nội dung cơ bản, để không mất kết nối và có thể quay lại.

• AC: Sau khi hết hạn, tài khoản về free hạn chế, không bị khóa; luôn có lời mời nâng cấp.

Nhóm: Học tập & lộ trình

US-10 — Biết việc tiếp theo · REQ-F-LRN-06

Là một Builder, tôi muốn /my-journey cho tôi biết đang ở đâu và làm gì tiếp, để không bị lạc.

• AC: My Journey hiển thị bước hiện tại và hành động kế tiếp gợi ý.

US-11 — Học quanh một câu hỏi · REQ-F-LRN-02

Là một Builder, tôi muốn mỗi khóa nêu rõ Clarity Question và Big Concepts, để học nhằm ra quyết định chứ không học thuộc.

• AC: /courses/:slug hiển thị Clarity Question, Concepts, Units, Artifact cần tạo.

US-12 — Hoàn thành Unit bằng sản phẩm · REQ-F-LRN-05

Là một Builder, tôi muốn hoàn thành Unit bằng cách nộp một artifact thật, để việc học của tôi tạo ra kết quả.

• AC: Unit chỉ chuyển "hoàn thành" khi có artifact; không tính theo "đã xem".

US-13 — Concept đúng ngữ cảnh · REQ-F-LRN-04, REQ-F-LRN-07

Là một Builder, tôi muốn concept gắn với đúng khóa đang học, để không bị nhiễu nghĩa từ khóa khác.

• AC: /concepts/:id hiển thị định nghĩa thuộc course sở hữu; không trộn concept liên khóa.

Nhóm: Thực hành

US-20 — Tham gia thử thách · REQ-F-PRA-01

Là một Builder, tôi muốn nhận đề Challenge và nộp deliverable, để rèn kỹ năng trong hành động.

• AC: /challenges/:slug có đề bài, hạn nộp, và nơi nộp sản phẩm.

US-21 — Đi qua một chương trình dài · REQ-F-PRA-02

Là một Builder cam kết, tôi muốn tham gia Workshop/Program theo bước, để đi từ ý tưởng tới sản phẩm hoàn chỉnh.

• AC: Program hiển thị chuỗi bước và tiến độ của tôi.

US-22 — Tích lũy Proof of Work · REQ-F-PRA-03

Là một Builder, tôi muốn deliverables gom về Portfolio, để có bằng chứng năng lực dùng được bên ngoài.

• AC: /portfolio tổng hợp các artifact tôi đã tạo.

Nhóm: Cộng đồng

US-30 — Tham gia sự kiện · REQ-F-COM-01

Là một Builder, tôi muốn xem và đăng ký sự kiện, để học trực tiếp và kết nối.

• AC: /events, /online-events/:slug, /calendars cho xem lịch và đăng ký.

US-31 — Gửi & nhận phản hồi · REQ-F-COM-02

Là một Builder, tôi muốn gửi phản hồi về sản phẩm của mình, để cải thiện nhờ góc nhìn ngoài.

• AC: /feedback cho gửi phản hồi và theo dõi phản hồi nhận được.

US-32 — Giới thiệu bạn bè · REQ-F-COM-03

Là một Builder hài lòng, tôi muốn giới thiệu người khác qua Affiliate, để nhận quyền lợi và mở rộng cộng đồng.

• AC: /affiliate cấp link giới thiệu và theo dõi kết quả.

Nhóm: Tiến bộ

US-40 — Thấy tiến bộ · REQ-F-PRG-01

Là một Builder, tôi muốn Score và Badges phản ánh nỗ lực, để có động lực và biết mình mạnh ở đâu.

• AC: /score, /badges cập nhật theo hoạt động (hoàn thành Unit, tạo artifact, dự sự kiện).

US-41 — Gợi ý cá nhân hóa · REQ-F-PRG-02

Là một Builder, tôi muốn nhận gợi ý bước tiếp theo dựa trên hành vi của tôi, để lộ trình phù hợp hơn.

• AC: /member-intelligence tổng hợp dữ liệu và đề xuất hành động kế tiếp.

---

Truy vết (traceability)

User Story	Requirement(s)	Feature	SDD
US-01, US-02	REQ-F-MEM-02/03/08, REQ-F-AUTH-03	Membership	§4
US-03	REQ-F-MEM-06/07	Membership	§4
US-04	REQ-F-MEM-04/05	Audience	§4
US-10..13	REQ-F-LRN-*	Học tập	§3
US-20..22	REQ-F-PRA-*	Thực hành	§6
US-30..32	REQ-F-COM-*	Cộng đồng	§6
US-40..41	REQ-F-PRG-*	Tiến bộ	§6