Chi phí Phase A In-progress
Chi phí là sổ sách của merchant. Nó theo dõi tiền nằm ở đâu (ngăn kéo tiền mặt, ngân hàng, QR, tài khoản mobile-POS), ghi nhận mọi di chuyển tiền dưới dạng một phiếu ghi-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 được trả tiền, một đơn mua hàng được nhận, hoặc kho di chuyển.
1. Định danh
| Thuộc tính | Giá trị |
|---|---|
| Module ID | CORE-12 |
| Tier | Core |
| Trạng thái | In-progress |
| Phase | P1 (hạch toán tự động) đã ship · P2 (phiếu thủ công, UI tài khoản, chuyển khoản) đang hình thành |
| Ưu tiên | MEDIUM |
| Người dùng chính | Chủ · Kế toán · Quản lý |
2. Mục đích & Phạm vi
| Bao gồm | Loại trừ |
|---|---|
| Tài khoản tiền / ví (Tiền mặt, Ngân hàng, QR, Mobile-POS) | Xử lý cổng thanh toán (module Payment) |
| Phiếu ghi-kép (thu, chi, chuyển khoản, điều chỉnh) | Phát hành hóa đơn thuế (module Invoice) |
| Phân cấp danh mục thu / chi | Tính số lượng & định giá kho (module Tồn kho) |
| Hạch toán tự động từ bán hàng, mua hàng, di chuyển kho | Lập ngân sách, báo cáo P&L, dự báo dòng tiền (tương lai) |
| Hủy phiếu bằng đảo cân bằng | Chi phí định kỳ / theo lịch (tương lai) |
| Cô lập tài khoản theo từng merchant | Chụp ảnh biên lai / OCR (tương lai) |
3. Năng lực
| Năng lực | Người dùng có thể làm gì | Trạng thái |
|---|---|---|
| Tài khoản tiền | Giữ số dư trên ngăn kéo tiền mặt, ngân hàng, QR, và tài khoản mobile-POS; một tài khoản mặc định mỗi loại | In-progress |
| Tự thu khi đơn được trả | Doanh thu bán hàng tự động ghi một phiếu thu, không cần nhập tay | Built |
| Tự hạch toán mua hàng | Nhận một đơn mua hàng tự động ghi một phiếu chi cho nhà cung cấp | Built |
| 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ộ | Built |
| Danh mục | Phân loại di chuyển tiền với 14 danh mục được seed cộng danh mục tùy chỉnh của merchant | Built |
| Phiếu thủ công | Nháp, duyệt, phát hành, và hủy phiếu bằng tay | In-progress |
| Chuyển khoản giữa tài khoản | Di chuyển tiền giữa các tài khoản dưới dạng một phiếu chuyển khoản cân bằng | In-progress |
| Di chuyển tiền mặt theo ca | Ghi nhận thu, chi, và safe drop với một phiên POS | Planned |
4. Phụ thuộc Module
| Phụ thuộc vào | Vì sao |
|---|---|
| Payment | Một thanh toán thành công kích hoạt một phiếu thu tự động cho khoản bán |
| Tồn kho | Nhận một đơn mua hàng, bán kho, và điều chỉnh kho kích hoạt các phiếu tự động |
| Commerce (Merchant) | Một merchant mới có các tài khoản mặc định được điều hòa tự động |
| Báo cáo | Tiêu thụ dữ liệu tài chính cho phân tích tài chí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 dịch vụ cấp nguồn cho nó.
| Package | Vai trò | Tài liệu nhà phát triển |
|---|---|---|
@nx/finance | Engine kế toán ghi-kép: tài khoản, phiếu, dòng sổ cái, danh mục, hạch toán theo sự kiện | finance |
6. Luồng người dùng chính
Tự thu khi một đơn được trả
Chuyển khoản thủ công giữa tài khoản
7. Vai trò & Quyền hạn
| Vai trò | Có thể | Không thể |
|---|---|---|
| Owner | Xem và quản lý tài khoản, phiếu, và danh mục của merchant mình | Xem merchant của organizer khác |
| Kế toán / Quản lý | Ghi phiếu, chuyển khoản, và phân loại di chuyển trong merchant của mình | Quản lý thông tin xác thực cổng thanh toán |
| Super Admin / Admin | Xem tài khoản trên mọi merchant | — |
Khả năng thấy tài khoản theo phạm vi merchant: người không-admin chỉ thấy tài khoản của các merchant họ được cấp. Xem ghi chú tích hợp finance cho hợp đồng phân quyền.
8. Trạng thái & Lộ trình
| Phase | Năng lực |
|---|---|
| P1 | Hạch toán tự động từ thanh toán bán hàng, nhận đơn mua hàng, và di chuyển kho; 14 danh mục được seed; điều hòa tài khoản mặc định khi có merchant mới |
| P2 | UI quản lý tài khoản, vòng đời phiếu nháp→phát-hành thủ công, chuyển khoản, danh mục tùy chỉnh |
| P3 | Di chuyển tiền mặt theo ca (thu / chi / safe drop), lập ngân sách, P&L, dự báo dòng tiền |
Trung thực trạng thái: hạch toán tự động (P1) đã chạy và được xác minh trong code. UI tài khoản/phiếu thủ công và chuyển khoản (P2) đã đấu nối một phần — engine hạch toán hỗ trợ chúng, nhưng các màn hình hướng-merchant và một số chốt chặn vẫn đang chín dần (xem Test Cases cho các mục đã xác minh vs. còn trống).