nhadat.cc
Tài liệu và tài nguyên dự án nhadat.cc — dịch vụ môi giới bất động sản chat-first
tại TP.HCM (Zalo OA + website), khởi điểm thị trường Quận 5.
📘 Bắt đầu từ đâu
docs/ — bộ tài liệu BA đầy đủ. Đây là nguồn sự thật của dự án.
| Tài liệu | Nội dung |
|---|
| 0 | Định hướng | BRD hợp nhất Aioinhadat × nhadat.cc (thương hiệu Aioinhadat / AI Ơi Nhà Đất, trợ lý mỗi khách một tên •ai): sản phẩm hôm nay là gì, nhận gì từ SRD AOND, câu khách hỏi đi về chủ nhà rồi CTV, sao Bắc Đẩu, lộ trình 90 ngày, quyết định treo |
| 0 | Glossary | Từ điển thuật ngữ (B, S, CCRB, NMG, HXH…) |
| 1 | Research | Insight, persona, mô hình KD, ngân sách, rủi ro |
| 2 | Requirements | 9 BR · 225 FR (4 deprecated) · 18 NFR · 5 giả định |
| 3 | User Flow | 13 luồng end-to-end |
| 4 | Information Architecture | Sitemap, URL/SEO, content model |
| 5 | Wireframe | 14 màn hình low-fi |
| 6 | UI Design | Design system + tone giọng chat |
| 7 | SRS | Kiến trúc, data model, API, 13 tiêu chí nghiệm thu |
| 8 | Traceability | Ma trận truy vết BR→FR→UF→WF→SRS→AC |
| 9 | Open Issues | 62 vấn đề — 36 đã chốt hoặc đã đóng (dọn 07/09: 13 mục hướng nhadat.cc 2024 không còn hợp AOND; 09/09 chiều chốt OPEN-32 ảnh vào kho, chốt lại OPEN-39 tên theo khách, OPEN-55 bảng 14 dòng chat Gemini ↔ hệ thống; 09/09 tối chốt OPEN-40 đủ loại BĐS; 10/09 đóng OPEN-45 vì design/ đã xoá), 26 còn chờ chủ dự án (OPEN-56 nguồn dữ liệu dự án 10/09; OPEN-57 mảnh câu xác nhận rơi vào bo_sung 22/09; OPEN-58 tra phường theo số nhà / Google Geocoding 25/09; OPEN-59 một căn vừa bán vừa cho thuê 08/10; OPEN-60 phường số cũ gộp trước 2025, OPEN-61 vai người rao đoán / xác nhận, OPEN-62 chữ in + khen đoán người mua 09/10) (OPEN-26/27/28 chốt một phần; OPEN-51/52 dựng lại từ nhánh cũ 08/09; OPEN-53 ảnh đếm tấm, OPEN-54 ngưỡng fine-tune 09/09) |
| 10 | Kế hoạch kiểm thử | 4 tầng kiểm thử, bộ test chạy tay kèm kết quả mới nhất |
| 11 | Quy trình BA & tester | Hai vòng làm việc, ba cổng, định nghĩa XONG |
Quy ước làm việc và ranh giới bảo mật: CLAUDE.md.
Quy trình cập nhật tài liệu: docs/11-quy-trinh.md
(bản rút gọn cho agent: .claude/skills/ba-pipeline/SKILL.md).
✅ Cổng kiểm
bun run kiem # kiểu dữ liệu + dựng web + 102 kịch bản e2e bot + soát truy vết
Cùng lệnh này chạy trong CI (.github/workflows/kiem.yml)
mỗi PR — ba job web / bot / truyvet phải xanh mới merge.
Chạy trên Windows: nếu tên người dùng Windows có dấu (vd. C:\Users\QuangLêBáDuy),
bun install báo xong nhưng gói bị chép thiếu (không có tsc, next rỗng, bun run chat
báo thiếu @anthropic-ai/sdk/helpers/zod). Nguyên nhân là bộ đệm bun nằm trên đường dẫn
có dấu. Trỏ bộ đệm sang đường dẫn không dấu, xoá node_modules rồi cài lại:
$env:BUN_INSTALL_CACHE_DIR = "C:\bun-cache"
Kiểu xuống dòng được .gitattributes ghim về LF, nên clone trên Windows cũng ra file
giống hệt Linux/CI.
💻 Mã nguồn
Từ 24/08/2026 code nằm trong chính repo này (trước đó ở thư mục riêng):
| Đường dẫn | Là gì |
|---|
app/, components/, lib/, public/ | Web Next.js 15 + Tailwind 4 (App Router), Vercel build từ gốc repo, package manager Bun |
bot/supabase/functions/ | 9 edge function (Deno) — bộ não chat, webhook Zalo, cron nhắc/báo cáo |
bot/supabase/migrations/ | Bản sao tham chiếu của migration đã áp (áp thật qua MCP) |
bot/bridge-zca/ | Bridge Zalo acc clone — chạy trên máy chủ dự án, không deploy |
bot/tests/ | Test hồi quy chạy tay bằng Node (docs/10 §TS-HQ) |
scripts/ | Script vận hành chạy tay: up ảnh, xuất rổ hàng, soát DB |
Chi tiết bot: bot/README.md. Quy ước và ranh giới bảo mật:
CLAUDE.md.
📂 Tài liệu gốc
Tài liệu 2024 (.pdf/.docx/.pptx/.xlsx, SS/, hình samples/) và design/ đã xoá khỏi repo 08/09/2026 (commit 459008d, OPEN-48: ngưng kế thừa nhadat.cc 2024). Nội dung đã chưng cất vào docs/; bản đồ file gốc → tài liệu ở CLAUDE.md §3. Còn lại ở gốc:
| Mục | Mô tả |
|---|
Kịch bản huấn luyện môi giới (Gemini 07-09-2026).md | Kịch bản sếp chốt 07/09 → FR-177 |
Kịch bản AI Ơi Nhà Đất (Gemini 21-06-2026, share).md | Chat Gemini gốc 21/06, chốt 14 dòng OPEN-55 → FR-181…187 |
train/ | Lộ trình fine-tune giọng bot (Qwen/Unsloth), chưa chạy |
.claude/ | Cấu hình Claude Code của dự án |
🚫 Không nằm trong repo
Loại trừ có chủ đích (xem .gitignore):
admin logins/ — credential, tuyệt đối không publicsổ đỏ samples/ — bản scan chứa thông tin cá nhân thậtmasterDB/ — dữ liệu nhà và ảnh (~179MB)ThemeForest/ — theme thương mại có bản quyền (~274MB)
