# Khai phá Tri thức & Phân loại Hoá đơn (Invoice Taxonomy & Knowledge Discovery)

Đã hoàn thành nâng cấp phân hệ Hoá đơn (Invoices) để hỗ trợ phân loại sâu theo bản chất nghiệp vụ và xây dựng các tính năng khai phá tri thức (Knowledge Discovery) cho DSCons.

## Các thay đổi chính (Changes Made)

1. **Cập nhật Database Schema**:
   - Thêm cột `business_category` và `business_subcategory` vào bảng `erp_invoices`.
   - Tạo Index để tối ưu hiệu suất truy vấn BI/Analytics.
2. **Nâng cấp Logic Phân loại (Invoice Truth Classifier)**:
   - Hệ thống tự động phân tích chi tiết dòng hoá đơn (items) kết hợp với chiều hoá đơn (input/output) để suy luận ra nghiệp vụ.
   - Hỗ trợ loại hình **Hỗn hợp (Mixed)** cho các hoá đơn phức hợp (bao gồm cả vật tư thương mại và dịch vụ).
   - **Cross-referencing (Tham chiếu chéo)**: Đối với các hoá đơn đầu ra dịch vụ thuê thiết bị, hệ thống kiểm tra lịch sử hoá đơn đầu vào (đã từng thuê ca máy thiết bị này chưa). Nếu có, phân loại là Thương mại - Cho thuê lại (Sublease). Nếu không (thuộc sở hữu), phân loại là Dịch vụ - Cho thuê máy móc thiết bị (Equipment Leasing).
3. **Phát triển API Khai phá Tri thức (Analytics APIs)**:
   - `/v1/erp/invoices/analytics/business-breakdown`: Tổng hợp cấu trúc nghiệp vụ (Thương mại vs Dịch vụ vs Hỗn hợp).
   - `/v1/erp/invoices/analytics/machinery-roi`: Phân tích điểm hoà vốn (ROI) giữa chi phí thuê máy và doanh thu cho thuê lại.
   - `/v1/erp/invoices/analytics/cost-anomalies`: Phát hiện bất thường chi phí dựa trên Định mức AEC (AEC Pricing Norms).
4. **Xây dựng Dashboard (Enterprise UI - Dark Slate)**:
   - Giao diện `invoices_knowledge_discovery.html` theo chuẩn thiết kế mật độ cao (Bloomberg style).
   - Hiển thị đầy đủ radar chi phí, ROI thiết bị và tổng quan dòng tiền nghiệp vụ.

## Kiểm thử (Verification)
- Đã bổ sung Unit Test đầy đủ cho:
  - Logic phân loại AI & Cross-referencing: `tests/test_invoice_classifier.py` (100% Passed).
  - API Analytics Endpoint: `tests/test_invoice_analytics_routes.py` (100% Passed).
- Dashboard chạy tốt, tương thích tiêu chuẩn giao diện Dark Slate Enterprise của DSCons. Đã kiểm thử giao diện bằng Playwright.

![Knowledge Discovery UI](/C:/Users/Admin/.gemini/antigravity/brain/12028ecb-5bab-40ba-b1fa-497b280ea919/invoices_knowledge_discovery_ui.png)