# DSCons Autonomous Enterprise Todo List & Strategic Roadmap

## 1. Hệ Thống Bộ Nhớ & Nguyên Tắc Chống Quên (Anti-Memory-Loss Architecture)

Hệ thống duy trì 3 tầng lưu trữ bất biến để đảm bảo mọi kế hoạch, quyết định kiến trúc và tiến độ công việc không bao giờ bị mất giữa các phiên làm việc:
1. **Tầng 1 (File-based SSOT)**: `todolist.md`, `workflow.md`, `docs/system-architecture-master.md` - Luôn được nạp vào đầu mỗi phiên làm việc.
2. **Tầng 2 (Operational DB & Event Log)**: PostgreSQL 16 `dscons_operations` (Audit logs, Digital Twin state snapshot `/v1/company/operational-state`).
3. **Tầng 3 (Memory MCP & Qdrant Knowledge Graph)**: Graph thực thể nghiệp vụ và Vector Store BGE-M3 (1024 chiều).

---

## 2. Active Tasks: Kế Hoạch Nâng Cấp Toàn Diện (5 Trục Chiến Lược)

### TRỤC 1: Dữ Liệu Thực & Hybrid Ingestion Engine
- [x] **1.1 Ingest 100% Hồ sơ Dự án Thật từ `HĐ-2026`** (Hoàn thành: 330 chunks từ 116 tài liệu thuộc 26 dự án/thư mục thật được bóc tách và nạp vào Qdrant `dscons_knowledge`).
- [x] **1.2 Nạp Trọn bộ Thư viện Pháp chế & Định mức Xây dựng 2026** (Hoàn thành: 32 chunks từ 12 văn bản luật, nghị định 206, 207, 210, 212/2026/NĐ-CP, định mức ca máy 2026).
- [x] **1.3 Triển khai Hybrid Search (BM25 + Dense Vectors PhoBERT/BGE-M3 + RRF Ranking)** (Hoàn thành: `HybridSearchService` hợp nhất lexical & dense với $k=60$).

### TRỤC 2: Hoàn Thiện Nghiệp Vụ 4 Trụ Cột Kinh Doanh Định Sơn (`0202111150`)
- [x] **2.1 Trụ Cột 1 (Thi công Xây lắp & Thủy lợi - 15 Dự án trọng điểm)** (Hoàn thành: Xuất hồ sơ IPC 03a chuẩn NĐ 206/2026/NĐ-CP & Luật Xây dựng 2025, khấu trừ tạm ứng 10%, retention 5%, đối soát 3-Way Matching).
- [x] **2.2 Trụ Cột 2 (Vận tải Xe Ben & Logistics Cơ Giới - Đối tác: Thoát Nước Hải Phòng `0200149705`)** (Hoàn thành: Quản lý lệnh điều xe Howo 4 chân, đối soát vé cân bùn nạo vét Đình Vũ, giám sát định mức tiêu hao dầu $24\text{L}/\text{h}$).
- [x] **2.3 Trụ Cột 3 (Cho thuê Máy móc & Ca máy - Đối tác: Loan Khải `0201889988`)** (Hoàn thành: Đối soát 3 bên ca máy Kobelco/Komatsu, chấm công thợ lái, hóa đơn cho thuê, tính toán chỉ số hiệu suất OEE $87.4\%$).
- [x] **2.4 Trụ Cột 4 (Mua bán Vật tư & San lấp - Đối tác: Trung Kiên `0201805660`, Xi măng, Thép)** (Hoàn thành: Kiểm toán tỷ lệ hao hụt cát/đá theo ĐM 12/2021/BXD, rà soát điều kiện thanh toán CO/CQ, nén mẫu $R_{28}$, kéo thép).

### TRỤC 3: Multi-Agent Tự Trị, Benchmark Responsiveness & Quản Lý AI Personas
- [x] **Trục 3.1: Hệ thống Benchmark Định lượng & So sánh OpenRouter Free vs Local LM Studio**: Đo lường Latency (TTFT ms), TPS, Điểm chất lượng nghiệp vụ AEC Việt Nam (0-100), Trạng thái kết nối.
- [x] **Trục 3.2: Thuật toán Tự Động Phân Bổ & Gợi Ý Model Tối Ưu Cho 9 Nhân Sự AI**: Tự động ghép Thảo (DeepSeek-R1), Quỳnh (Qwen-Coder-32B), Nam (Gemini-Flash), Phúc (Local LM Studio), v.v. Kèm nút 1-Click Áp Dụng Toàn Bộ.
- [x] **Trục 3.3: Giao Diện Quản Trị AI Models & 9 Nhân Sự Số Chuẩn Enterprise Dark Slate**: Trang `/dashboard/agent-models` hiện đại, trực quan, kiểm thử thực tế Chromium Playwright đạt 100% Passed.
- [x] **Trục 3.4: Vòng Đời Quản Lý Mô Hình Stealth / Promo (`stealth/ox-alpha`) & Tự Động Fallback**: Nhận diện mô hình Stealth miễn phí có thời hạn, đếm ngược ngày hết hạn (`stealth_expires_at`), tự động fallback về mô hình chỉ định (`fallback_model_name`) an toàn và thông suốt khi hết hạn.
- [x] **Trục 3.5: Tích Hợp DeepSeek Harness (`dsh`) Qua Chuẩn Mở Model Context Protocol (MCP)**: Xây dựng `app/mcp/dscons_mcp_server.py` và `dsh_config/dsh.config.json`, kết nối toàn bộ 6 công cụ thực tế (Qdrant 2,510 vectors, PostgreSQL Ledger, 3-Way Matching, BOQ Phụ lục 03a, Ca máy OEE & Vận tải xe ben $24\text{L}/\text{h}$).
- [x] **Trục 3.6: Lịch Làm Việc Phân Ca So Le & Bộ Đệm Chống Rate Limit / Spam OpenRouter**: Phân bổ 8 ca trực theo giờ nghiệp vụ (07:30 - 19:30), tự động chèn Jitter ngẫu nhiên (1.5s - 3.5s), giới hạn 8 RPM trên OpenRouter và tự động chuyển tiếp (failover) sang Local LM Studio khi gặp mã 429.

### TRỤC 4: E2E Playwright Automation & Hiện Trường Offline PWA
- [x] **4.1 Playwright Real Browser Automation Test Suite (Quy tắc #6)** (Hoàn thành: `tests/test_playwright_e2e_ui.py` kiểm thử Chromium tương tác kéo giãn cột, responsive, dark slate UI, modal cấu hình Stealth, kích hoạt điều phối tự trị DHS War Room và kiểm tra bảng lịch phân ca).
- [ ] **4.2 Progressive Web App (PWA Offline-First)**:
  - Hỗ trợ kỹ sư công trường ghi nhật ký, chấm công GPS, chụp ảnh nghiệm thu ngoại tuyến khi mất sóng 4G/WiFi; tự động đồng bộ khi có mạng.


### TRỤC 5: Tài Chính Sâu & Quản Trị Rủi Ro (Financial War Room)
- [x] **5.1 Khấu trừ Tạm ứng & Tiền giữ lại Bảo hành (Retention 3 - 5%)**:
  - Tự động khấu trừ tiền tạm ứng và giữ lại bảo hành trên từng chứng từ IPC theo tỷ lệ cài đặt riêng của hợp đồng. Tự động ghi sổ giao dịch vào bảng `erp_financial_transactions`.
- [x] **5.2 Dự báo Dòng tiền (Cash Flow Forecasting) & Stress Test Tài chính**:
  - Tích hợp số liệu thu chi dự kiến (planned transactions) từ DB. Xây dựng tham số `client_delay_days` để mô phỏng kịch bản CĐT trễ thanh toán, tự động cảnh báo ngày cạn vốn lưu động (Liquidity Risk Alert).

---

## 3. Completed Milestones (Production Baseline - 100% Passed)

- [x] **157/157 Test Cases PASSED (1 skipped, 0 failed)** toàn bộ hệ sinh thái (`pytest tests -v`).

- [x] Khởi tạo cơ sở dữ liệu quan hệ PostgreSQL 16 `dscons_operations` với đầy đủ schema, role `dscons_user`, chuẩn số học `Decimal(18, 4)` và transaction rollback.
- [x] Cài đặt & khởi chạy trực tiếp native Qdrant Vector Engine trên port `6333` / `6334`.
- [x] Tích hợp mô hình `stealth/ox-alpha` (OpenRouter) & LM Studio Local cho toàn bộ 9 AI Personas.
- [x] Xây dựng giao diện Superadmin tùy chỉnh model, tokens, prompt cho từng AI Agent (`/v1/admin/agent-models`).
- [x] Ingest thành công **2,510 vectors** từ hồ sơ dự án thật (`HĐ-2026`).
- [x] Triển khai bộ bóc tách XML Hóa đơn điện tử chuẩn NĐ 123 & MISA kèm kiểm tra rủi ro máy tính tiền MTT.
- [x] Triển khai AI WBS Generator, EVM Calculation Service (BAC, PV, EV, AC, CPI, SPI) và Gantt Chart CPM.
- [x] Triển khai hệ thống xác thực Owner & RBAC 5 vai trò kèm Google OAuth2.
- [x] Hoàn thiện 9 màn hình Dashboard Enterprise Dark Slate (`#0b0f19`).
- [x] Xây dựng Digital Twin Company Operational State và realtime SSE stream `/v1/company/operational-state/stream`.
- [x] Tích hợp Telegram Enterprise Suite & Mobile Site Diary hỗ trợ kỹ sư hiện trường.
- [x] Tạo tài liệu kiến trúc Single Source of Truth `docs/system-architecture-master.md` và `docs/company-business-domains-and-operations-guide.md`.