7. Quản lý số dư & Dòng tiền#
Mục tiêu#
Cho phép creator xem số dư hoa hồng, lịch sử giao dịch và thông tin tài chính.
Luồng nghiệp vụ#
- Người dùng truy cập trang "Ví / Tài chính".
- Hệ thống hiển thị:
- Số dư hiện tại (đã đối soát, chưa thanh toán, đã thanh toán)
- Lịch sử dòng tiền (cash flow)
- Thông tin thẻ ngân hàng đã liên kết
- Người dùng có thể:
- Thêm / sửa thẻ ngân hàng
- Đặt thẻ mặc định
API đã triển khai#
GET /users/cash-flow— Lịch sử dòng tiềnGET /users/bank-cards— Danh sách thẻ ngân hàngPOST /users/bank-cards— Thêm thẻ ngân hàngPUT /users/bank-cards/:id— Cập nhật thẻPUT /users/bank-cards/:id/set-default— Đặt thẻ mặc định
Phạm vi#
- Giao diện creator hỗ trợ xem số dư, lịch sử dòng tiền và quản lý thẻ ngân hàng.
- Việc tạo lệnh rút tiền và chi trả được xử lý qua luồng Admin (xem §20, §21).
Tiêu chí chấp nhận (Acceptance Criteria)#
| # | Tiêu chí | Điều kiện đạt |
|---|---|---|
| AC-7.1 | Hiển thị số dư | Trang "Ví" hiển thị 3 loại số dư: đã đối soát, chưa thanh toán, đã thanh toán — số liệu khớp với dữ liệu backend |
| AC-7.2 | Lịch sử dòng tiền | Danh sách giao dịch hiển thị: ngày, loại, số tiền, trạng thái — hỗ trợ phân trang |
| AC-7.3 | Thêm thẻ ngân hàng | Nhập thông tin thẻ hợp lệ → lưu thành công, hiển thị trong danh sách |
| AC-7.4 | Đặt thẻ mặc định | Chọn thẻ → đặt mặc định → thẻ cũ mất trạng thái mặc định, thẻ mới hiển thị "Mặc định" |
| AC-7.5 | Validate thẻ ngân hàng | Nhập thiếu thông tin bắt buộc → hiển thị lỗi validation |