Tài chính Phase A In-progress
Tài liệu nghiệp vụ (BA)
UC — Use Case · SRS — Đặc tả yêu cầu · UI — Đặc tả giao diện
Tài chính là sổ sách của cơ sở sân. Nó theo dõi tiền nằm ở đâu (ngăn kéo tiền mặt tại quầy, ngân hàng, QR, tài khoản mobile-POS), ghi nhận mọi dòng tiền dưới dạng một phiếu ghi sổ kép cân bằng, và phân loại thu và chi theo danh mục - phần lớn được hạch toán tự động khi một đơn (đặt sân hoặc bán hàng) được thanh toán tại POS, hoặc khi nhập hàng FNB/dụng cụ. Dòng tiền được theo dõi theo ca trực và chi nhánh sân.
Trạng thái: In-progress (P2 Sổ đối tác & P&L) · Owner: Việt Võ · Phase: 1-2 · Rà soát: 2026-06-15
Chuỗi Liên kết Roadmap Giai đoạn 2 - Theo tháng Epic BANA-1324 - Sổ đối tác + tài khoản + P&L URD URD - increment mới: LDGPRD PRD-EVT-001 Hạch toán theo sự kiện · PRD-LDG-001 Sổ đối tác & P&L (danh mục) Tài liệu dev @nx/finance Nhật ký giao Ma trận truy vết
1. Định danh
| Thuộc tính | Giá trị |
|---|---|
| Module ID | CORE-12 |
| Hạng | Core |
| Trạng thái | In-progress |
| Giai đoạn | P1 (hạch toán tự động) đã ship · P2 (phiếu thủ công, UI ví thu/chi, chuyển khoản) đang hình thành |
| Ưu tiên | MEDIUM |
| Người dùng chính | Chủ sân · Kế toán · Quản lý ca |
2. Mục đích & Phạm vi
| Bao gồm | Loại trừ |
|---|---|
| Ví thu/chi (Tiền mặt quầy, Ngân hàng, QR, Mobile-POS) | Xử lý cổng thanh toán (module Thanh toán) |
| Phiếu ghi sổ kép (thu, chi, chuyển khoản, điều chỉnh) | Phát hành hoá đơn thuế (module Hoá đơn & Thuế) |
| Phân cấp danh mục thu / chi của cơ sở sân | Tính số lượng & định giá kho FNB/dụng cụ (module Kho) |
| Hạch toán tự động từ đơn sân, đơn bán hàng, nhập kho | Lập ngân sách, báo cáo P&L, dự báo dòng tiền (tương lai) |
| Dòng tiền theo ca trực và theo chi nhánh sân | Chi phí định kỳ / theo lịch (tương lai) |
| Huỷ phiếu bằng bút toán đảo cân bằng | Chụp ảnh biên lai / OCR (tương lai) |
| Tách biệt sổ sách theo từng chi nhánh sân |
3. Năng lực
| Năng lực | Người dùng có thể làm gì |
|---|---|
| Ví thu/chi | Giữ số dư trên ngăn kéo tiền mặt quầy, ngân hàng, QR, và tài khoản mobile-POS; một ví mặc định mỗi loại |
| Tự thu khi đơn được thanh toán | Doanh thu đặt sân và bán hàng tự động ghi một phiếu thu, không cần nhập tay |
| Tự hạch toán nhập hàng | Nhập hàng FNB/dụng cụ tự động ghi một phiếu chi cho nhà cung cấp |
| Tự hạch toán kho | Giá vốn hàng bán và điều chỉnh kho tự động hạch toán vào tài khoản kiểm soát nội bộ |
| Danh mục | Phân loại dòng tiền với danh mục dựng sẵn (doanh thu sân, FNB, thuê dụng cụ, điện nước, lương...) cộng danh mục tuỳ chỉnh |
| Phiếu thủ công | Nháp, duyệt, phát hành, và huỷ phiếu chi/thu bằng tay (ví dụ chi sửa lưới, bảo trì mặt sân) |
| Chuyển khoản giữa ví | Chuyển tiền giữa các ví dưới dạng một phiếu chuyển khoản cân bằng |
| Biến động tiền mặt theo ca | Ghi nhận thu, chi, và safe drop gắn với một ca trực POS, đối soát khi kết ca |
4. Phụ thuộc Module
| Phụ thuộc vào | Vì sao |
|---|---|
| Thanh toán | Một thanh toán thành công (đơn sân hoặc bán hàng) kích hoạt một phiếu thu tự động |
| Kho | Nhập hàng FNB/dụng cụ, bán kho, và điều chỉnh kho đều kích hoạt các phiếu tự động |
| Bán Hàng POS | Mở/kết ca tại POS cấp ngữ cảnh ca và chi nhánh cho biến động tiền mặt |
| Báo cáo | Dùng dữ liệu tài chính cho phân tích dòng tiền theo ca/chi nhánh |
5. Backend Packages
Chi tiết triển khai nằm trong tài liệu nhà phát triển - phần này chỉ ánh xạ module sang service vận hành nó.
| Package | Vai trò | Tài liệu nhà phát triển |
|---|---|---|
@nx/finance | Bộ máy kế toán ghi sổ kép: ví thu/chi, phiếu, dòng sổ cái, danh mục, hạch toán theo sự kiện | finance |
Ánh xạ Kỹ thuật (Tính năng ⇄ Package)
Trục ngang của Feature Spine - mỗi tính năng nghiệp vụ (
<AREA>trong URD) ánh xạ tới nơi triển khai kỹ thuật của nó. Đối ứng: tài liệu package liên kết ngược lại đây.
| Tính năng | Package | Trạng thái |
|---|---|---|
WAL Tài khoản | @nx/finance | In-progress |
VCH Phiếu & Hạch toán | @nx/finance | In-progress |
EVT Hạch toán theo sự kiện | @nx/finance | Built |
TXN Dòng sổ cái | @nx/finance | Built |
CAT Danh mục | @nx/finance | Built |
LDG Sổ đối tác & P&L | @nx/finance | Planned |
6. Luồng người dùng chính
Tự thu khi một đơn được thanh toán
Chuyển khoản thủ công giữa ví
7. Vai trò & Phân quyền
| Vai trò | Được phép | Không được phép |
|---|---|---|
| Chủ sân (Owner) | Xem và quản lý ví, phiếu, và danh mục của cơ sở mình; xem dòng tiền mọi chi nhánh | Xem cơ sở của chủ sân khác |
| Kế toán / Quản lý ca | Ghi phiếu, chuyển khoản, và phân loại dòng tiền trong chi nhánh được phân công | Quản lý thông tin xác thực cổng thanh toán |
| Thu ngân (Cashier) | Ghi nhận thu/chi/safe drop trong ca của mình, đối soát tiền mặt khi kết ca | Quản lý ví, phiếu thủ công ngoài ca, danh mục |
| Viewer | Xem báo cáo dòng tiền (read-only) | Ghi phiếu, chuyển khoản |
Quyền xem ví giới hạn theo chi nhánh: người không phải Chủ sân chỉ thấy ví của các chi nhánh họ được cấp. Xem ghi chú tích hợp finance để biết đặc tả phân quyền.
8. Trạng thái & Lộ trình
| Giai đoạn | Năng lực |
|---|---|
| P1 | Hạch toán tự động từ thanh toán đơn sân/bán hàng, nhập hàng, và biến động kho; danh mục dựng sẵn cho cơ sở sân; tự đối soát ví mặc định khi có chi nhánh mới |
| P2 | Giao diện quản lý ví thu/chi, vòng đời phiếu nháp→phát hành thủ công, chuyển khoản, danh mục tuỳ chỉnh |
| P3 | Biến động tiền mặt theo ca (thu / chi / safe drop), lập ngân sách, P&L theo chi nhánh, dự báo dòng tiền |