Các câu trích dẫn đã được rút gọn từ biên bản hội thoại để dễ đọc nhưng giữ nguyên ý của người nói.

Giải pháp kỹ thuật

MoveInMate là nền tảng dành cho cư dân và ban quản lý trong một khu đô thị, với thiết kế dữ liệu sẵn sàng mở rộng cho nhiều khu. Lõi hệ thống gồm ba thành phần, và ranh giới giữa chúng là phần quan trọng nhất.

1. Trả lời có dẫn nguồn — không có nguồn thì không trả lời.

Hệ thống sử dụng RAG trên tập tri thức đã được ban quản lý công bố. Mỗi câu trả lời đều kèm trích dẫn về tài liệu gốc. Khi không tìm được nguồn phù hợp, hệ thống không tự suy đoán mà chuyển sang người thật và ghi lại lý do chuyển tiếp.

2. Thủ tục được quản lý bằng state machine, không phụ thuộc vào một prompt dài.

Luồng đăng ký xe là một máy trạng thái thực sự trong backend: thu thập thông tin qua nhiều lượt, đối chiếu ảnh cà-vẹt, sinh PDF đúng mẫu, chờ cư dân xác nhận rồi mới tạo service request. Nếu cư dân tạm dừng để hỏi việc khác rồi quay lại, hệ thống vẫn giữ đúng bước đang thực hiện.

3. AI chuẩn bị hồ sơ, con người phê duyệt.

AI không tự phê duyệt hành động được bảo vệ. AI chuẩn bị thông tin, cư dân xác nhận, sau đó ban quản lý đưa ra quyết định. Các quyết định đều được ghi nhận bằng status event, audit trail và notification trong ứng dụng. Các kênh gửi thông báo ra ngoài như email hoặc push vẫn là phần mở rộng tiếp theo.

Ba ranh giới này được thực thi ở backend, không chỉ ở giao diện:

Ngữ cảnh cư dân
→ checklist được sinh theo hồ sơ hộ
→ trả lời có dẫn nguồn
→ hành động chỉ chạy sau khi cư dân xác nhận
→ ban quản lý phê duyệt phần cần con người
→ tiến độ, thông báo và audit trail

Phân quyền do server quyết định. Nhân sự BQL của khu khác hoặc tài khoản sai vai trò sẽ bị từ chối trước khi chạm tới tầng service. Hồ sơ của hộ khác cũng được xử lý như hồ sơ không tồn tại để tránh làm lộ dữ liệu hoặc sự tồn tại của hồ sơ đó.

Kiến trúc: FastAPI và Pydantic v2 cho backend, Next.js cho app cư dân và console ban quản lý, Supabase/PostgreSQL cho dữ liệu, LangChain/LangGraph cho tầng agent và OpenTelemetry cho telemetry. Traces, metrics và logs hiện được xuất qua OTLP tới hệ thống observability production.

Tính khả thi

Hệ thống đang chạy thật và có thể kiểm tra qua các địa chỉ công khai:

Snapshot kiểm thử gần nhất trên main:

backend        3.082 test pass, 28 skipped
console BQL    214 test pass
app cư dân     459 test pass

Frontend admin đã được build production thành công. Cả ba service trên Railway đều đang online, backend health check trả về 200 OK, và /health/telemetry xác nhận OTLP traces, metrics và logs đã sẵn sàng, không ghi nhận lỗi export.

Database production hiện có 54 migration và 8 RPC đã được ghi nhận. Kiểm tra có thể thực hiện bằng:

python scripts/check_migrations.py

Dự án đã hoàn tất Sprint 11 với các phần chính:

• Cổng đánh giá chất lượng AI giữa baseline và candidate.
• So sánh regression theo từng case.
• Cẩm nang vận hành tiếng Việt cho Platform Admin.
• Theo dõi traces, metrics và logs qua OpenTelemetry/OTLP.
• Giao diện admin được polish để sử dụng như một sản phẩm thực tế hơn.

Token usage hiện được ghi nhận khi provider trả về dữ liệu sử dụng. Chi phí chỉ được tính khi có đủ thông tin token và đơn giá; trường hợp chưa có dữ liệu sẽ hiển thị rõ là chưa có dữ liệu thay vì điền số giả.

Các giới hạn vẫn cần nói rõ:

• Provider quota, đặc biệt ở free tier, vẫn giới hạn tốc độ sử dụng AI.
• Sáu biến SMTP hiện đã được cấu hình trên Railway, nhưng vẫn nên thực hiện một lượt mời cư dân thật để xác nhận email được gửi thành công.
• Bộ test mặc định không đại diện đầy đủ cho live model behavior; các integration test và live-provider test cần được chạy riêng.
• Notification outbox và việc gửi thông báo ra ngoài chưa được nối hoàn chỉnh.
• Android hiện vẫn là bản beta development-signed; Flow 3 với backend thật, production signing và end-to-end acceptance vẫn còn mở.
• Hai frontend vẫn có các cảnh báo npm mức high liên quan đến chuỗi dependency sharp/libvips.
• Bảy trường dữ liệu đăng ký xe cần được ratify trong canonical API contract.
• Luồng huỷ sau trạng thái PENDING_SIGNATURE vẫn là phần nợ kỹ thuật.

Hướng phát triển

Ngắn hạn — hoàn thiện cho pilot.

Thực hiện một lượt kiểm thử provisioning email trên production, rà lại các integration test, hoàn thiện notification outbox, tiếp tục ghi nhận token usage và mở rộng các chỉ số như Recall@k, grounded-answer rate, P95 latency và escalation accuracy.

Hoàn tất Phase 1.

Phát hành Android production-signed, kết nối đầy đủ với backend thật, hoàn thiện luồng thành viên hộ, mở rộng các biểu mẫu động thay cho PDF tĩnh và bổ sung thêm workflow ngoài đăng ký xe.

Cùng một lõi, nhiều dịch vụ hơn.

Ngữ cảnh, quy trình và kiểm soát là ba thành phần có thể tái sử dụng. Đặt tiện ích, bảo trì, khách ra vào, thanh toán, bưu kiện và smart home đều có cùng hình dạng bài toán: hiểu ngữ cảnh hộ, chạy đúng quy trình và dừng lại ở nơi cần người phê duyệt.

Từ một khu đô thị đến nền tảng vận hành.

Phân quyền theo khu đã được thực thi ở backend và có kiểm thử cho các trường hợp bị từ chối. Mở rộng sang khu thứ hai là bài toán vận hành và cấu hình nhiều hơn là viết lại toàn bộ hệ thống. Các bước tiếp theo là điều phối đúng bộ phận — lễ tân, an ninh, bảo trì, tài chính — và đo chất lượng liên tục thay vì chỉ đo một lần trong demo.

Mọi con số trong tài liệu này đều có thể kiểm tra lại từ repository, kết quả test, deployment health check và tài liệu sprint. Những phần là giới hạn, ước lượng hoặc kế hoạch tương lai đều được ghi rõ.