PrintUp — Tài liệu yêu cầu & nghiệm thu
Site nghiệp vụ cho dự án PrintUp: toàn bộ yêu cầu chức năng (FR), phi chức năng (NFR), quy tắc trạng thái, kịch bản nghiệm thu và quyết định cần chốt — dùng để thảo luận, kiểm thử và nghiệm thu cùng founder/product owner và testers.
Site này chuyển project brief thảo luận (docs/project-brief-discussion.md, v0.1 — 09/09/2026) thành bộ tài liệu yêu cầu có thể duyệt, kiểm thử và nghiệm thu. Toàn bộ nội dung là baseline đề xuất lấy từ brief; không mục nào tự động trở thành cam kết phạm vi cho tới khi được founder/product owner phê duyệt và các quyết định D-xx liên quan được chốt.
Cách dùng site này
| Bạn là | Bắt đầu từ | Dùng để |
|---|---|---|
| Founder / Product owner | Tổng quan → Quyết định cần chốt → FR, NFR | Chốt D-xx, phê duyệt baseline FR/NFR/BR/AC, ký nghiệm thu phạm vi P0 |
| Tester / QA | Nghiệm thu & kiểm thử → chi tiết từng FR và NFR | Chạy AC-01..AC-12, tra tiêu chí nghiệm thu và gợi ý kiểm thử của từng yêu cầu, ghi nhận kết quả |
| Vận hành / Kế toán / Hotprint | Hành trình nghiệp vụ, Trạng thái & quy tắc, Phụ thuộc | Xác nhận quy trình thực tế, trách nhiệm từng vai trò, phương án khi gián đoạn |
Quy ước đọc (theo brief)
- Đã xác định (B-xx): thông tin mô hình do founder cung cấp — xem Tổng quan.
- Đề xuất: phương án làm cơ sở thảo luận; chưa phải cam kết kinh doanh hay phạm vi được phê duyệt. Toàn bộ FR, NFR, quy tắc trạng thái (BR), mức ưu tiên và ngưỡng nghiệm thu hiện ở trạng thái này.
- Cần chốt (D-xx): quyết định còn mở — xem Quyết định cần chốt.
Bản đồ tài liệu
| Trang | Nội dung |
|---|---|
| Tổng quan | Mô hình, sự thật đã xác định (B-xx), vai trò, mô hình giá, chú giải thuật ngữ |
| Hành trình nghiệp vụ | 10 bước đặt đơn thông thường và 10 tình huống ngoại lệ |
| Phạm vi phát hành | Ma trận tính năng P0 / P1 / P2 |
| Yêu cầu chức năng | FR-01..FR-41 kèm tiêu chí nghiệm thu và gợi ý kiểm thử |
| Trạng thái & quy tắc | 8 trục trạng thái và BR-01..BR-07 |
| Yêu cầu phi chức năng | NFR-01..NFR-16 kèm cách nghiệm thu |
| Nghiệm thu & kiểm thử | AC-01..AC-12, điều kiện mở pilot, biểu mẫu ghi kết quả và phê duyệt |
| Đo lường | 8 chỉ số và kế hoạch thử nghiệm ban đầu |
| Quyết định cần chốt | D-01..D-15 với vai trò chốt, thời điểm và biên bản trống |
| Truy vết | Ma trận AC → FR và D → yêu cầu bị ảnh hưởng |
| Phụ thuộc | Hotprint, SePay, Canva/Drive, hóa đơn, kênh thông báo |
Nguyên tắc fail-closed xuyên suốt
Các kiểm thử dưới đây thất bại nếu hệ thống làm ngược lại — đây là tinh thần chung của mọi kịch bản AC:
- Chưa xác nhận giá/điều khoản thì không thu cọc (BR-01).
- Thiếu đủ cọc, file duyệt, thông số chốt hoặc Hotprint chấp nhận thì không sản xuất (BR-02).
- Giao dịch sai tài khoản/sai nội dung không tự gán vào đơn — vào hàng đợi đối soát (FR-18, FR-23).
- Thiếu bằng chứng giao hoặc còn dòng hàng chưa xử lý thì không hoàn thành (BR-04).
- Thiếu số/tham chiếu chứng từ thì không hiển thị “đã phát hành hóa đơn” (FR-31).
- Chưa đủ điều kiện D-12 thì không duyệt chi hoa hồng; điều chỉnh có dấu vết kể cả đã chi (BR-06, FR-36).
Cập nhật trạng thái yêu cầu/quyết định: sửa trường status trong các file biz-docs/data/*.yaml rồi build lại site
(xem README của biz-docs).