Báo cáo Phase A In-progress
Báo cáo biến dữ liệu giao dịch thành những con số mà chủ dùng để điều hành doanh nghiệp: đối soát tiền mặt cuối ca (báo cáo X/Z), tổng hợp doanh số hằng ngày, mặt hàng nào đang bán, và danh mục với nhà cung cấp so sánh ra sao. Nó chỉ-đọc — tổng hợp trên các đơn đã hoàn tất và ca đã đóng chứ không thay đổi gì.
1. Định danh
| Thuộc tính | Giá trị |
|---|---|
| Module ID | CORE-11 |
| Tier | Core |
| Trạng thái | In-progress |
| Phase | P1 (tổng hợp doanh số hằng ngày) · P2 (báo cáo ca X/Z, phân tích sản phẩm / danh mục / mua hàng) · P3 (phân tích nâng cao) |
| Ưu tiên | MEDIUM |
| Người dùng chính | Chủ · Quản lý · Thu ngân |
2. Mục đích & Phạm vi
| Bao gồm | Loại trừ |
|---|---|
| Báo cáo ca thu ngân — X (giữa ca) và Z (đóng ca) | Phân tích lãi & lỗ (Planned) |
| Đối soát tiền mặt: quỹ đầu, doanh số, thu/chi, kỳ vọng vs. thực tế | Báo cáo định giá tồn kho (Planned) |
| Tổng hợp doanh số hằng ngày theo khoảng ngày | Phân tích khách hàng / giữ chân (Planned) |
| Doanh số sản phẩm (bán chạy nhất theo doanh thu & số lượng) | Xuất ra PDF / CSV / Excel (Planned) |
| Doanh số danh mục + đào sâu một danh mục | Báo cáo tự động theo lịch (Planned) |
| Tổng hợp mua hàng (chi tiêu nhà cung cấp / PO) | Báo cáo kê khai thuế (Thuế & Hóa đơn) |
| Truy vấn theo phạm vi merchant, theo khoảng ngày | Đặc tả API kỹ thuật (xem tài liệu nhà phát triển) |
3. Năng lực
| Năng lực | Người dùng có thể làm gì | Trạng thái |
|---|---|---|
| Tổng hợp doanh số hằng ngày | Xem tổng gộp, thuế, chiết khấu, thuần và số đơn theo ngày trên một khoảng ngày | Built |
| Doanh số sản phẩm | Xem sản phẩm bán chạy nhất xếp hạng theo doanh thu và số lượng | Built |
| Doanh số danh mục | Phân rã doanh số theo danh mục sản phẩm | Built |
| Đào sâu danh mục | Khảo sát hiệu suất của một danh mục đơn | Built |
| Tổng hợp mua hàng | Rà soát chi tiêu đơn-mua-hàng / nhà-cung-cấp để so sánh chi phí | Built |
| Đối soát ca (báo cáo Z) | Đóng một ca và nhận tiền mặt kỳ-vọng-vs-thực-tế cùng một bản chụp ca đã khóa | Built |
| Báo cáo X (giữa ca) | Lấy một tổng hợp giữa ca trong khi ca vẫn mở | In-progress |
| Phân rã phương thức thanh toán | Xem tổng tách theo tiền mặt / thẻ / ví điện tử | In-progress |
| Phân tích lợi nhuận | So sánh chi phí vs. doanh thu (biên lợi nhuận) | Planned |
| Định giá tồn kho | Định giá hàng tồn (AVCO / FIFO) | Planned |
| Phân tích khách hàng | Giữ chân, giá trị vòng đời, phân khúc | Planned |
| Xuất & lên lịch | Xuất PDF / CSV / Excel và báo cáo tự động | Planned |
Các phát hiện về dữ-liệu-mô-phỏng và xuất-stub từ những đánh giá QE trước áp dụng cho một API báo cáo quản trị cũ. Báo cáo doanh số đã build nay chạy trên
SalesReportServicecủa@nx/sale, đẩy mọi tổng hợp xuống SQL có index trên các đơn đã hoàn tất — xem Test Cases cho hành vi đã xác minh.
4. Phụ thuộc Module
| Phụ thuộc vào | Vì sao |
|---|---|
| Đơn hàng | Đơn hàng đã hoàn tất và phiên POS là nguồn của mọi con số doanh số và ca |
| Sản phẩm | Tên sản phẩm và danh mục dẫn dắt phân rã sản phẩm / danh mục |
| Payment | Bản ghi thanh toán hậu thuẫn cho đối soát tiền mặt và tách phương thức thanh toán |
| Tồn kho | Đơn mua hàng cấp nguồn cho tổng hợp mua hàng (so sánh chi phí) |
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 các dịch vụ cấp nguồn cho nó.
| Package | Vai trò | Tài liệu nhà phát triển |
|---|---|---|
@nx/sale | Tổng hợp doanh số (SalesReportService) và báo cáo ca X/Z (ShiftService, PosSessionReport) | sale |
6. Luồng người dùng chính
Báo cáo doanh số hằng ngày
Báo cáo ca X / Z
7. Vai trò & Quyền hạn
| Vai trò | Có thể | Không thể |
|---|---|---|
| Thu ngân | Lấy báo cáo X cho ca đang mở của mình; đóng ca của mình để tạo báo cáo Z | Xem phân tích doanh số liên-merchant hoặc toàn-doanh-nghiệp |
| Quản lý | Xem mọi báo cáo doanh số / sản phẩm / danh mục / mua hàng của merchant mình; rà soát bất kỳ ca nào | Xem dữ liệu của merchant khác |
| Chủ | Mọi báo cáo quản lý trên các merchant của mình | — |
Báo cáo luôn theo phạm vi quyền truy cập merchant của người dùng; một người dùng không bao giờ thấy được con số của merchant khác.
8. Trạng thái & Lộ trình
| Phase | Năng lực |
|---|---|
| P1 | Tổng hợp doanh số hằng ngày theo khoảng ngày (gộp, thuần, thuế, chiết khấu, số đếm) |
| P2 | Báo cáo ca X/Z với đối soát tiền mặt, doanh số sản phẩm, doanh số danh mục + đào sâu, tổng hợp mua hàng, phân rã phương thức thanh toán |
| P3 | Phân tích lợi nhuận, định giá tồn kho, phân tích khách hàng, xuất PDF/CSV/Excel, báo cáo theo lịch, widget KPI dashboard |
9. Trang liên quan
- URD
- Test Cases
- PRDs
- Đơn hàng · Sản phẩm · Payment · Tồn kho
- Tài liệu nhà phát triển: Sales Report · Shift / POS Session