Tài khoản demo (đăng nhập trực tiếp trên bản đã deploy để trải nghiệm):

• Quản lý: manager03@phudongskygarden.vn / Pd0xzWWE2PG7RDpz!7
• Cư dân: resident03@phudongskygarden.vn / PdnUORWM59Gs6ELf!7

Bài toán

Doanh nghiệp bất động sản vận hành nhiều khu dân cư cùng lúc, mỗi khu có bộ nội quy và quy trình riêng được lưu trong các tài liệu PDF dài hàng chục trang. Cư dân thường không đọc hết toàn bộ sổ tay, nhưng các câu hỏi lặp lại như phí gửi xe, thủ tục đăng ký, giờ mở tiện ích, hay yêu cầu hỗ trợ hành chính chiếm phần lớn khối lượng công việc của Ban Quản Lý (BQL).

Vấn đề không nằm ở việc “gắn ChatGPT vào PDF”, mà ở ba ràng buộc bắt buộc: không rò rỉ dữ liệu chéo giữa các khu dân cư, không bịa câu trả lời khi không có căn cứ, và biết khi nào phải chuyển cho người thật thay vì đoán hoặc đẩy mọi câu khó sang BQL. Hệ thống cần trả lời dựa trên văn bản đang hiệu lực, kèm trích dẫn rõ ràng, và chỉ tạo side effect khi cư dân thực sự yêu cầu hành động hoặc báo sự cố.

Giải pháp kỹ thuật

Project triển khai pipeline RAG hai pha theo mô hình chuẩn.

• Offline: tài liệu được parse từ PDF, phân đoạn theo ngữ nghĩa theo representation semantic-content-v1, sau đó index song song vào Postgres (lexical/exact, có unaccent) và Qdrant (dense vector).
• Online: hệ thống redact PII, chọn ngữ cảnh hội thoại, lên kế hoạch truy vấn bằng AgentTurnPlan, thực hiện hybrid retrieval dense + lexical theo cơ chế RRF, rồi hydrate bằng chứng có thẩm quyền từ Postgres. Trước khi đưa vào generation, hệ thống kiểm tra scope, tenant, hash nguồn và phiên bản tài liệu đang hiệu lực.
• Sau đó, Evidence Assessor chọn tối đa 5 bằng chứng, Answer Generator sinh câu trả lời có trích dẫn, và Answer Verifier kiểm tra literal, entailment và completeness theo quy tắc fail-closed. Nếu thiếu bằng chứng hoặc xảy ra xung đột dữ liệu, hệ thống trả lời an toàn thay vì đoán.

Conversation agent chạy theo bounded LangGraph: chỉ tạo Ticket khi cư dân yêu cầu xử lý một việc cụ thể hoặc mô tả sự cố khẩn cấp; không tự tạo phiếu chỉ vì “AI không tìm được câu trả lời”. Vòng đời tài liệu được kiểm soát rõ ràng theo thứ tự upload → preview → duyệt/từ chối → xuất bản → rollback. Phân quyền multi-tenant được thực thi qua verified JWT + MembershipContext, và PII được che trước mọi ranh giới AI/vector.

Tính khả thi

Project hiện có kiến trúc production thực, không có mock runtime hoặc local-only path trong bundle production. Hệ thống chạy trên backend, worker và frontend thật, với runtime là external-only, sử dụng Supabase, Postgres, Qdrant và OpenAI provider thật. Các thành phần được quản lý theo module rõ ràng, có contract và boundary riêng, và quy trình CI/CD theo chuẩn của repo giúp gate lint, type-check, tests và build.