Backend Server API — Trợ Lý AI CXK

Công nghệ: Python 3.11+ | FastAPI | Pydantic v2 | MSSQL Driver (pyodbc) | ChromaDB / Vector Store
Chạy ngầm sau IIS Reverse Proxy trên Windows Server 2022.

1. Cấu Trúc Ứng Dụng

• app/:
• main.py: Entrypoint khởi tạo FastAPI và middleware.
• config.py: Đọc cấu hình từ biến môi trường (.env).
• routers/:
  • chat.py: Endpoint tiếp nhận hội thoại và streaming phản hồi.
  • search.py: Endpoint tìm kiếm ngữ nghĩa trong kho tri thức.
  • health.py: Endpoint kiểm tra trạng thái dịch vụ (Health check).
• services/:
  • retriever.py: RAG Vector Retriever và metadata filter.
  • safety_engine.py: Bộ kiểm tra Pre-check và Post-check an toàn.
  • citation_engine.py: Trích xuất và định dạng liên kết nguồn tài liệu.
  • llm_service.py: Tương tác với LLM API (Gemini / GPT).
  • conversation.py: Quản lý bộ nhớ ngữ cảnh và phiên hỏi đáp.
  • triage.py: Phân tầng nguy cơ bệnh nhân (GREEN/AMBER/RED).
• models/:
  • schemas.py: Các Pydantic schemas cho Request/Response.
  • enums.py: Các enum định nghĩa trạng thái và phân tầng.
• middleware/:
  • logging.py: Ghi nhật ký truy vấn bảo vệ quyền riêng tư (no PII).
  • privacy.py: Lọc bỏ thông tin định danh cá nhân trước khi xử lý.
• tests/: Bộ kiểm thử tự động API và các module dịch vụ.

2. Chạy Ứng Dụng Cục Bộ

cd backend
uvicorn app.main:app --reload --port 8000

API Documentation sẽ có tại: http://127.0.0.1:8000/docs.