E1. Thiết lập và cấu hình
User stories của epic E1. Thiết lập và cấu hình.
Nguồn: PRD Core Flow đặt hàng v0.4 (30/09/2026, cập nhật 01/10/2026). Người soạn: Hoàng Trọng Thanh Tùng (Product Manager PrintUp). Người duyệt: Nguyễn Hoàng Nam (CEO PrintUp). Mã BR-xx, QT-xx trong mục User stories là mã của PRD v0.4, khác mã cùng tên ở trang Trạng thái & quy tắc và danh mục FR lưu trữ.
Mỗi story mở đầu bằng câu “Là …, tôi muốn …, để …”. Story Must có dòng Liên kết và tiêu chí Cho – Khi – Thì; story Should/Could ở dạng ngắn. Mã S-xx, E-xx, ST-xx, TH-xx, CFG.xxx tra ở Dữ liệu & trạng thái, Copy, Email.
US-01 · SA cấu hình nhóm sản phẩm, quy cách và bộ file bắt buộc (Must)
Là Super Admin, tôi muốn khai báo nhóm sản phẩm, quy cách và bộ file bắt buộc theo từng tùy chọn, để khách chỉ chọn được cấu hình PrintUp làm được và gửi đủ file ngay từ đầu.
Liên kết: S-01, S-02, S-03 · design.required.*
- Cho SA tạo hoặc sửa nhóm sản phẩm và quy cách, khi lưu, thì danh mục (S-01) và màn cấu hình (S-02) của KH cập nhật theo; đơn đã gửi giữ nguyên quy cách lúc gửi.
- Cho SA đang sửa một loại sản phẩm, khi SA gắn danh sách file bắt buộc, file mẫu và hướng dẫn cho từng quy cách, thì màn cấu hình của KH hiện đúng danh sách đó theo tùy chọn KH chọn (ví dụ thêm UV thì thêm file vùng UV).
- Cho một sản phẩm đang ẩn, khi KH mở danh mục, thì sản phẩm không hiện và link trực tiếp báo không tìm thấy.
US-02 · SA cấu hình bảng giá, bậc số lượng, số lượng tối thiểu (Must)
Là Super Admin, tôi muốn cấu hình bảng giá theo bậc số lượng, số lượng tối thiểu và bước nhảy, để KH thấy giá đúng ngay khi chọn mà không cần báo giá tay.
Liên kết: S-02 · các mã config.price và config.qty · BR-03, BR-13
- Cho SA nhập đơn giá theo từng bậc số lượng, khi KH nhập số lượng thuộc một bậc, thì đơn giá lấy theo bậc đó và hiện ngay ở S-02.
- Cho một đơn đã gửi, khi SA đổi đơn giá của quy cách trong đơn, thì giá và tổng của đơn đó không đổi; chỉ đơn gửi sau thời điểm đổi dùng giá mới.
- Cho SA lưu số lượng tối thiểu và bước nhảy, khi KH nhập số lượng, thì hệ thống áp TH-11.
US-03 · SA tạo tài khoản nội bộ và gán role (Must)
Là Super Admin, tôi muốn tạo tài khoản cho nhân viên và gán đúng role, để mỗi người chỉ thấy và làm phần việc của mình, thông tin khách không lộ ra ngoài role cần dùng.
Liên kết: BR-20 · Requirement Quản trị 5 vai trò
- Cho SA ở màn Tài khoản, khi nhập email, họ tên, chọn một role và lưu, thì tài khoản được tạo và nhân viên nhận email đặt mật khẩu (cách kích hoạt cần xác nhận).
- Cho email đã có tài khoản, khi SA lưu, thì hệ thống báo email đã được dùng và không tạo tài khoản mới.
- Cho một tài khoản đang hoạt động, khi SA đổi role hoặc khóa tài khoản, thì thay đổi áp dụng từ lần tải trang tiếp theo; tài khoản bị khóa không đăng nhập được, các đơn đã xử lý vẫn giữ tên người xử lý.
- Cho người dùng không phải SA, khi mở màn Tài khoản, thì không truy cập được.
- Cho một tài khoản role Thiết kế, khi mở đơn, thì không thấy tên, số điện thoại, địa chỉ khách; chỉ thấy mã đơn, cấu hình, file và khung trao đổi.
- Cho mỗi role, khi đăng nhập, thì menu, màn và nút thao tác đúng theo bảng phân quyền trong Requirement Quản trị 5 vai trò; mở màn không được phép thì hiện “Không có quyền truy cập”.
US-04 · SA tạo tài khoản và mã giới thiệu cho đại lý (Must)
Là Super Admin, tôi muốn tạo tài khoản và mã giới thiệu riêng cho từng đại lý, để ghi nhận đúng đơn do đại lý giới thiệu và tính hoa hồng.
- Cho SA nhập tên, email, số điện thoại của đại lý và lưu, thì hệ thống tạo tài khoản role Đại lý gắn với một mã giới thiệu; đại lý nhận email đặt mật khẩu.
- Cho SA tạo đại lý, khi lưu, thì hệ thống cấp một mã duy nhất; trùng mã thì báo lỗi và không lưu.
- Cho SA tắt một mã, thì mã đó không còn hợp lệ ở bước đặt hàng (checkout.ref.invalid); đơn đã gắn mã trước đó không đổi.
US-06 · SA cấu hình phí giao, ngày giao và các tham số chính sách (Must)
Là Super Admin, tôi muốn tự chỉnh phí giao, ngày giao và các tham số chính sách, để thay đổi vận hành mà không cần sửa code và không ảnh hưởng đơn đã gửi.
Liên kết: Phụ lục A, mục A.4 (tham số CFG) và A.5
- Cho SA mở màn cấu hình, khi sửa bất kỳ tham số CFG nào, thì giá trị mới chỉ áp dụng cho đơn gửi sau thời điểm lưu, và lịch sử thay đổi ghi người sửa, thời điểm, giá trị cũ và mới.
- Cho bảng phí giao theo tỉnh/thành (CFG.shipping_fee_table), khi KH nhập địa chỉ, thì phí giao và ngày dự kiến lấy theo tỉnh/thành trong địa chỉ. Khi có công thức hoặc API vận chuyển (P0-1), nguồn phí giao đổi mà luồng không đổi.
| Mã | Story | Ưu tiên | AC ngắn |
|---|---|---|---|
| US-05 | SA bật/tắt module mẫu thử, tự xuất hóa đơn; cấu hình tỷ lệ hoa hồng — Là Super Admin, tôi muốn bật/tắt module mẫu thử, tự xuất hóa đơn và cấu hình tỷ lệ hoa hồng, để điều chỉnh vận hành mà không cần sửa code. | Should | Có hiệu lực cho đơn mới. |
Cập nhật lần cuối 01/10/2026 bởi Hoàng Tùng · 6b3bfefc · Lịch sử thay đổi