# MỤC LỤC & DANH MỤC TÀI LIỆU KỸ THUẬT DSCONS ERP **Hệ Thống Quản Trị Doanh Nghiệp Ngành Xây Dựng & Công Trình Hạ Tầng (AEC)** Tất cả các tài liệu kỹ thuật, kiến trúc, cẩm nang nghiệp vụ và kế hoạch triển khai của dự án được phân loại khoa học theo 5 phân khu dưới đây: --- ## 🏗️ 01. Kiến Trúc Hệ Thống & Trí Tuệ Nhân Tạo (System & AI Architecture) * [`system-architecture-master.md`](./system-architecture-master.md): Bản vẽ kiến trúc tổng thể toàn diện của hệ thống DSCons ERP. * [`agent-architecture-7x.md`](./agent-architecture-7x.md): Thiết kế 7 vai trò Sub-Agent chuyên trách cho ngành xây dựng. * [`anti-memory-loss-implementation-plan.md`](./anti-memory-loss-implementation-plan.md): Cơ chế chống mất mát ngữ cảnh và bảo tồn tri thức đa phiên. * [`degraded-state-observability-plan.md`](./degraded-state-observability-plan.md): Giám sát và xử lý khi hệ thống rơi vào trạng thái suy thoái/offline tại công trường. * [`desktop-automation-architecture.md`](./desktop-automation-architecture.md): Kiến trúc tự động hóa desktop, CAD và tích hợp Zalo PC. * [`deepseek_harness_integration_guide.md`](./deepseek_harness_integration_guide.md): Hướng dẫn tích hợp mô hình DeepSeek R1/V3 cho bài toán bóc tách BoQ. --- ## ⚖️ 02. Nghiệp Vụ & Pháp Lý Ngành Xây Dựng (Business Domains & Policies) * [`company-business-domains-and-operations-guide.md`](./company-business-domains-and-operations-guide.md): **Cẩm nang cốt lõi phân định 4 Trụ Cột Kinh Doanh** của Công ty Định Sơn. * [`company-people-knowledge.md`](./company-people-knowledge.md): Sơ đồ tổ chức nhân sự, ban chỉ huy công trường và đội thợ thi công. * [`knowledge-taxonomy.md`](./knowledge-taxonomy.md): Phân loại cây tri thức và định danh mã số dự án, hóa đơn, vật tư. * [`policy-operations-playbook.md`](./policy-operations-playbook.md): Cẩm nang chính sách vận hành và quy trình phê duyệt nội bộ. * [`tt91-data-dictionary.md`](./tt91-data-dictionary.md): Từ điển dữ liệu báo cáo kỹ thuật và hồ sơ nghiệm thu theo Thông tư 91. --- ## 📁 03. Hồ Sơ Dự Án Thực Tế & Manifests (Project Dossiers & Data Contracts) * [`duong-ong-nam-hung-khanh-manifest.md`](./duong-ong-nam-hung-khanh-manifest.md): Manifest hồ sơ dự án Tuyến đường ống cấp nước Nam Hưng Khánh. * [`duong-ong-nam-hung-khanh-ho-so-standard.md`](./duong-ong-nam-hung-khanh-ho-so-standard.md): Tiêu chuẩn hồ sơ nghiệm thu kỹ thuật Nam Hưng Khánh. * [`duong-ong-nam-hung-khanh-ho-so-gap-analysis.md`](./duong-ong-nam-hung-khanh-ho-so-gap-analysis.md): Báo cáo phân tích khoảng trống hồ sơ và kế hoạch bổ sung. * [`duong-ong-nam-hung-khanh-work-assignment.md`](./duong-ong-nam-hung-khanh-work-assignment.md): Bảng phân công nhiệm vụ kỹ sư công trường Nam Hưng Khánh. * [`duong-ong-nam-hung-khanh-zalo-contact-log.md`](./duong-ong-nam-hung-khanh-zalo-contact-log.md): Nhật ký liên lạc và đôn đốc hồ sơ qua Zalo. * [`kenh-xay-document-manifest.md`](./kenh-xay-document-manifest.md) & [`.json`](./kenh-xay-document-manifest.json): Manifest hồ sơ dự án Kênh Xây Đa Độ. * [`kenh-xay-gold-reference-metadata-contract.md`](./kenh-xay-gold-reference-metadata-contract.md): Hợp đồng dữ liệu vàng cho mẫu hồ sơ Kênh Xây. * [`project-dossier-manifest-template.md`](./project-dossier-manifest-template.md): Mẫu manifest chuẩn cho các dự án xây dựng mới. --- ## 🛡️ 04. Kế Hoạch Triển Khai & Kiểm Toán Chất Lượng (Audits & Verification) * [`integration-e2e-verification-master-plan.md`](./integration-e2e-verification-master-plan.md): Kế hoạch tổng thể kiểm thử tích hợp E2E trên trình duyệt thực tế. * [`workflow-persistence-transaction-hardening-plan.md`](./workflow-persistence-transaction-hardening-plan.md): Kế hoạch gia cố tính toàn vẹn giao dịch cơ sở dữ liệu PostgreSQL. * [`postgres-schema-drift-remediation-plan.md`](./postgres-schema-drift-remediation-plan.md): Kế hoạch đồng bộ và khắc phục sai lệch schema DB. * [`rag-pilot-rollout-plan.md`](./rag-pilot-rollout-plan.md): Lộ trình triển khai thí nghiệm RAG trích xuất hồ sơ tự động. * [`refactor-audit-docs-tests-verification-plan.md`](./refactor-audit-docs-tests-verification-plan.md): Kế hoạch tái cơ cấu và kiểm toán toàn diện hệ thống. * [`system-health-audit.md`](./system_health_audit_log.md): Nhật ký kiểm tra sức khỏe dịch vụ và cơ chế tự phục hồi. --- ## ⚙️ 05. Cài Đặt, Vận Hành & Tích Hợp (Setup & Integration) * [`api-reference.md`](./api-reference.md): Tài liệu hướng dẫn sử dụng API RESTful của backend FastAPI. * [`dual-platform-windows-mac-setup.md`](./dual-platform-windows-mac-setup.md): Hướng dẫn thiết lập môi trường phát triển đồng bộ Windows - macOS qua Tailscale / SSH. * [`employee-rag-sop.md`](./employee-rag-sop.md): Quy trình chuẩn (SOP) hướng dẫn kỹ sư sử dụng trợ lý AI tra cứu hồ sơ. * [`zalo-pc-contact-playbook.md`](./zalo-pc-contact-playbook.md): Hướng dẫn cấu hình kịch bản tự động nhắc việc qua Zalo PC.