🎯 TIÊU CHÍ 1: ĐỘ HOÀN THIỆN SẢN PHẨM (PRODUCT READINESS) Sản phẩm đã hoàn thiện 100% User Flow End-to-End và sẵn sàng chạy demo trực tiếp mà không gặp bất kỳ lỗi gián đoạn nào. Hệ thống được phát triển với hai phiên bản bổ trợ lẫn nhau, phục vụ linh hoạt các môi trường triển khai khác nhau:

1. Phiên bản Hệ thống Quản trị & AI Agent Đầy đủ (Streamlit + SQLite + Python) • User Flow 1: Tra cứu & Quản lý danh mục: Hỗ trợ tìm kiếm từ khóa đa trường, bộ lọc động theo nhóm chuyên ngành, cấp độ (Cơ bản/Nâng cao/Chuyên sâu), tình trạng tài liệu (Có/Thiếu), và nguồn gốc ban hành. • User Flow 2: Cập nhật thông tin & Số hóa (CRUD): Cho phép chỉnh sửa thông tin chương trình, đính kèm link Drive online, tải lên (upload) và xóa các tệp tài liệu chi tiết lưu trữ cục bộ trong thư mục riêng của từng chương trình. • User Flow 3: Trợ lý AI hỏi đáp CSDL (AI Agent): Chatbot AI tự động chuyển câu hỏi tự nhiên thành SQL để truy vấn trực tiếp cơ sở dữ liệu thực tế, giải quyết triệt để tình trạng AI bịa đặt dữ liệu (hallucination). • User Flow 4: Báo cáo & Xuất bản: Kết xuất cơ sở dữ liệu ngược trở lại file Excel cập nhật mới nhất chỉ với 1 click.
2. Phiên bản Cổng Thông tin & Chatbot Nhúng (HTML5 + Vanilla CSS + Vanilla JS + IndexedDB) • User Flow 1: Trình diễn giao diện tĩnh siêu nhẹ: Hoạt động hoàn toàn trên trình duyệt (thậm chí không cần kết nối mạng qua giao thức file:///), giao diện Light/Dark Mode đồng bộ cao cấp, hiệu ứng glassmorphism thời thượng. • User Flow 2: Đính kèm tài liệu ảo: Sử dụng IndexedDB để lưu trữ tệp cục bộ trực tiếp trong bộ nhớ cát lún (sandbox) của trình duyệt. • User Flow 3: Trợ lý AI Chatbot nhúng: Chatbot nổi ở góc màn hình hỗ trợ cả 2 chế độ: • Offline (Mặc định): Tìm kiếm, thống kê và điều hướng ngay lập tức bằng thuật toán JS. • Online (Gemini API): Gọi trực tiếp mô hình gemini-1.5-flash client-side bằng cách dán API Key. • User Flow 4: Điều hướng liên kết: Nhấp vào liên kết chương trình trong bong bóng chat sẽ tự động mở Modal chi tiết chương trình trên trang chính.

💻 TIÊU CHÍ 2: CHẤT LƯỢNG KỸ THUẬT (TECHNICAL EXCELLENCE)

1. Kiến trúc Hệ thống (System Architecture) Hệ thống sử dụng mô hình lai (Hybrid Architecture) kết hợp giữa sức mạnh tính toán của Backend Python và sự cơ động, bảo mật của Frontend Web tĩnh: graph TD subgraph Streamlit_Backend["Phiên bản Dynamic (Backend Python)"] A[Streamlit UI] <--> B[AI Agent - ai_agent.py] B <-->|Gemini 2.5 Flash| C[Gemini API Client] A <-->|SQL Queries| D[(SQLite Database - documents.db)] D <-->|Import/Export| E[Excel Sheet - Danh mục 2026] A <-->|Storage| F[Uploaded Documents Directory] end

   subgraph Static_Frontend["Phiên bản Portal (Web Tĩnh HTML5)"] G[index.html / style.css / app.js] <--> H[ai-chatbot.js] H <-->|Local Logic| I[data.js - Static JSON] H <-->|Gemini 1.5 Flash| J[Client-Side Gemini API] G <-->|Virtual Storage| K[(IndexedDB - Browser Storage)] end