Đặc tả yêu cầu phần mềm (SRS) — Beyond The Deed Hub
| Mục | Nội dung |
|---|---|
| Sản phẩm | Beyond The Deed Hub: website công khai + CMS, Học viện (LMS), Sandy CRM, Go API |
| Phiên bản tài liệu | 1.0 — 18/11/2026 |
| Căn cứ | Mã nguồn nhánh main (commit dd926c3), api-contract.md, system-architecture.md, kế hoạch nền tảng |
| Tài liệu đi kèm | Hướng dẫn sử dụng |
| Trạng thái | Đã triển khai trên staging; chưa ra mắt production (xem §9) |
Tài liệu theo bố cục ISO/IEC/IEEE 29148. Mỗi yêu cầu có mã để truy vết: FR-<phân hệ>-<số> cho
yêu cầu chức năng, NFR-<nhóm>-<số> cho yêu cầu phi chức năng. Mức ưu tiên: B (bắt buộc cho ra
mắt), N (nên có, đã làm), T (tuỳ chọn, bật khi có khoá dịch vụ).
1. Giới thiệu
1.1 Mục đích
Mô tả đầy đủ những gì nền tảng Beyond The Deed Hub phải làm, cho ai, trong ràng buộc nào, để khách hàng (Beyond The Deed / Sandy Bình), đội phát triển và người kiểm thử dùng chung một nguồn khi nghiệm thu, vận hành và mở rộng.
1.2 Phạm vi sản phẩm
Nền tảng phục vụ người Việt mua nhà và đầu tư bất động sản tại Hoa Kỳ (50 bang + DC, tiền USD), giao diện song ngữ Tiếng Việt / English, gồm bốn thành phần dùng chung một tài khoản:
| Thành phần | Địa chỉ production dự kiến | Người dùng chính |
|---|---|---|
| Website công khai + CMS (Payload) | beyondthedeedhub.com, CMS tại /cms |
Khách truy cập, biên tập viên |
| Học viện (LMS) | academy.beyondthedeedhub.com |
Học viên, đại sứ |
| Sandy CRM | crm.beyondthedeedhub.com |
Nhân viên kinh doanh, marketing, quản trị, đối tác |
| Go API + CLI | api.beyondthedeedhub.com (sau proxy) |
Ba ứng dụng trên, tác vụ nền |
Ngoài phạm vi: thanh toán trực tiếp tiền mua nhà, tích hợp MLS/IDX tự động, quay số tự động/robocall, DRM video, ứng dụng di động gốc.
1.3 Thuật ngữ
| Thuật ngữ | Nghĩa |
|---|---|
| Lead | Người để lại thông tin qua biểu mẫu, chưa thành khách hàng |
| Lifecycle (giai đoạn) | Vị trí trong phễu: subscriber → lead → mql → sql → opportunity → customer, thêm referrer |
| MQL / SQL | Lead đủ điều kiện marketing / đủ điều kiện bán hàng |
| SLA 24 giờ | Hạn phản hồi đầu tiên cho lead từ website |
| Pipeline / Giao dịch (deal) | Quy trình bán hàng gồm các giai đoạn; mỗi deal thuộc một pipeline |
| DSCR | Debt Service Coverage Ratio, tỷ lệ dòng tiền cho thuê trên nợ vay |
| NTBS | Đơn vị quản lý cho thuê nhận bàn giao sau khi mua |
| Đại sứ (ambassador) | Người giới thiệu khoá học/dịch vụ, nhận hoa hồng |
| Đối tác (partner) | Môi giới/chuyên gia có giấy phép, nhận khách được phân |
| W-9 / 1099-NEC | Biểu mẫu thuế Mỹ của người nhận tiền / tờ khai thu nhập không phải lương |
| CAN-SPAM, TCPA, RESPA §8 | Luật Mỹ về email thương mại, gọi/nhắn tin, phí giới thiệu bất động sản |
| GPC | Global Privacy Control, tín hiệu từ chối theo dõi của trình duyệt |
1.4 Tài liệu tham chiếu
- api-contract.md: hợp đồng API, mã lỗi, trạng thái (nguồn sự thật cho chi tiết kỹ thuật).
- system-architecture.md, deployment-guide.md, design-guidelines.md, code-standards.md.
- project-overview-pdr.md, project-roadmap.md.
2. Mô tả tổng quan
2.1 Bối cảnh sản phẩm
flowchart LR B[Trình duyệt] --> W[Website + CMS] B --> AC[Học viện] B --> C[Sandy CRM] W & AC & C -->|/api/v1 cùng origin| A[Go API] A --> P[(PostgreSQL 18 + pgvector)] W --> PC[(CSDL CMS)] A --> X[Stripe · Resend/SMTP · Google Calendar · Claude · Voyage · Cloudflare · S3]
- Ba ứng dụng Next.js chuyển tiếp
/api/v1/*về Go API trên cùng origin, nên cookie phiên là httpOnly và first-party, không cần CORS. - Go API giữ mọi quy tắc nghiệp vụ và phân quyền; giao diện chỉ ẩn phần người dùng không được dùng.
- Email được ghi vào hàng đợi (outbox) trong cùng giao dịch với dữ liệu gây ra nó, gửi bởi tác vụ nền có thử lại.
2.2 Chức năng chính
- Tài khoản dùng chung: đăng ký, xác nhận email, đăng nhập, quên/đổi mật khẩu, phiên trên mọi subdomain.
- Website: nội dung do CMS quản lý, kiến thức/podcast, dịch vụ, sách và đặt trước, công cụ tính, phong thuỷ hướng nhà, tin đăng nhà đất và yêu cầu VIP, đặt lịch tư vấn, đối tác và đại sứ, tài liệu miễn phí, bản tin, trắc nghiệm lộ trình, tìm kiếm, trợ lý AI.
- Học viện: danh mục khoá học, ghi danh/thanh toán, học bài video/văn bản, trắc nghiệm, ghi chú, chứng nhận có mã xác minh, trợ lý học tập AI, chương trình đại sứ.
- Sandy CRM: khách hàng và đồng ý liên lạc, chấm điểm, hộp thư lead, pipeline, việc cần làm, lịch hẹn, mẫu nội dung, email marketing, tự động hoá, dữ liệu (nhập, trùng, danh sách động), bất động sản, báo cáo, đối tác/phí giới thiệu, đại sứ/chi trả/thuế, khoá học và doanh thu, người dùng, cài đặt, AI hỗ trợ, khu làm việc cho đối tác.
2.3 Lớp người dùng và vai trò
Một người có thể giữ nhiều vai trò; quyền được cấp nếu bất kỳ vai trò nào cho phép. Vai trò được đọc lại từ CSDL ở mỗi request (claim trong token chỉ là gợi ý giao diện).
| Vai trò | Key | Phạm vi |
|---|---|---|
| Quản trị viên | admin |
Toàn quyền; quản lý người dùng, đối tác, phí giới thiệu, đại sứ, chi trả, thuế, KPI; xuất CSV và xoá khách hàng |
| Kinh doanh | sales |
Khách mình phụ trách + khách chưa phân công; nhận khách; hộp thư lead |
| Marketing | marketing |
Mọi khách hàng; CMS; email marketing; tự động hoá; khoá học; nhập dữ liệu |
| Kỹ thuật | tech |
Nhân sự nội bộ; chỉ đọc bất động sản; không xem dữ liệu cá nhân |
| Đối tác | partner |
Chỉ khu /workspace của CRM với khách được giao; đăng nhập bằng mã email |
| Đại sứ | ambassador |
Bảng theo dõi đại sứ ở học viện/website |
| Học viên | student |
Học viện; tài khoản mặc định khi tự đăng ký |
2.4 Môi trường vận hành
- Trình duyệt hiện đại (Chrome, Edge, Safari, Firefox — hai phiên bản gần nhất), máy tính và điện thoại (bố cục đáp ứng, kiểm thử ở 390 px).
- Máy chủ: Docker Compose (Go API, ba ứng dụng Next.js, PostgreSQL 18 + pgvector), sau reverse proxy
TLS. Staging hiện chạy tại
*.beyond-the-deed.portpairguide.app.
2.5 Ràng buộc thiết kế
- Tiền lưu bằng cent USD; số điện thoại E.164 (mặc định vùng US); tin đăng theo mô hình RESO.
- Giao diện dùng thành phần shadcn/ui, theme navy/royal/gold, font Be Vietnam Pro.
- Dịch vụ ngoài chỉ chạy khi có cấu hình; thiếu khoá thì tính năng ẩn hoặc giảm cấp, không giả lập.
- Không đặt nội dung bên thứ ba trên bất kỳ subdomain nào (do cookie dùng chung domain cha).
2.6 Giả định và phụ thuộc
- Khách hàng cung cấp địa chỉ bưu chính, văn bản pháp lý đã duyệt và khoá dịch vụ production (§9).
- Nội dung mẫu CMS lấy từ đặc tả, gắn "Chờ duyệt" cho tới khi biên tập viên duyệt.
3. Yêu cầu chức năng
3.1 Tài khoản và phiên (AUTH)
| Mã | Yêu cầu | Ưu tiên |
|---|---|---|
| FR-AUTH-01 | Khách tự đăng ký với họ tên, email, số điện thoại (không bắt buộc), mật khẩu 8–128 ký tự; có kiểm tra Turnstile. Tài khoản mới có vai trò student, chưa xác nhận |
B |
| FR-AUTH-02 | Hệ thống gửi email xác nhận (liên kết hiệu lực 24 giờ); cho phép gửi lại. Đăng ký trùng email không tiết lộ việc email đã tồn tại | B |
| FR-AUTH-03 | Đăng nhập bằng email + mật khẩu. Tài khoản chưa xác nhận bị chặn kèm hướng dẫn | B |
| FR-AUTH-04 | Tài khoản chỉ có vai trò đối tác đăng nhập bằng mã 6 số gửi qua email; sai 5 lần huỷ mã, sai 20 lần/24 giờ khoá đăng nhập bằng mã 24 giờ | B |
| FR-AUTH-05 | Quên mật khẩu: gửi liên kết đặt lại hiệu lực 30 phút; phản hồi giống nhau dù email có tồn tại hay không | B |
| FR-AUTH-06 | Người dùng đã đăng nhập đổi mật khẩu tại trang Tài khoản | B |
| FR-AUTH-07 | Một lần đăng nhập dùng được cho website, học viện, CRM và CMS | B |
| FR-AUTH-08 | Trang Tài khoản hiển thị vai trò, việc được làm và giới hạn, lối tắt sang Học viện/CRM, nút Đăng xuất | N |
3.2 Website công khai (WEB)
| Mã | Yêu cầu | Ưu tiên |
|---|---|---|
| FR-WEB-01 | Mọi trang có tiền tố ngôn ngữ (/vi/..., /en/...), đường dẫn theo ngôn ngữ; nút đổi ngôn ngữ đi tới trang tương ứng |
B |
| FR-WEB-02 | Menu chính: Giới thiệu, Nhà đất, Dịch vụ, Công cụ, Học viện, Insights, Đối tác; thanh trên cùng có Gợi ý của bạn, Gửi câu hỏi, Tìm kiếm, Ngôn ngữ, Đăng nhập/Tài khoản | B |
| FR-WEB-03 | Trang chủ, giới thiệu, dịch vụ, trang tiểu bang, kiến thức/podcast (lọc theo danh mục, chủ đề), sách lấy nội dung từ CMS; chỉ hiển thị bản đã xuất bản | B |
| FR-WEB-04 | Biểu mẫu Liên hệ (chủ đề, họ tên, email hoặc điện thoại, tiểu bang, nội dung, các ô đồng ý để trống mặc định) tạo hoặc khớp khách hàng trong CRM, nguồn website_form, bắt đầu SLA 24 giờ |
B |
| FR-WEB-05 | Bản tin: chọn 1–3 chủ đề (Đầu tư, Mua nhà để ở, Học bài bản); xác nhận 2 bước qua email (liên kết 7 ngày); trang quản lý chủ đề và huỷ đăng ký | B |
| FR-WEB-06 | Tài liệu miễn phí: tài liệu có điều kiện cần email để nhận liên kết tải có chữ ký, hết hạn sau 15 phút | B |
| FR-WEB-07 | Trắc nghiệm lộ trình 4 câu, chấm điểm theo phân khúc (nhà đầu tư, người mua nhà, học viên), gợi ý nội dung; tuỳ chọn gửi kết quả qua email | N |
| FR-WEB-08 | Sách: trang sách, đặt trước ở chế độ giữ chỗ (không thu tiền) hoặc thanh toán Stripe; trang QR độc giả nhận gói tài liệu | B |
| FR-WEB-09 | Công cụ tính: thẩm định nhanh, dòng tiền & DSCR, bài toán một căn nhà, vay mua nhà; số mặc định theo tiểu bang, nút đặt lại; gửi báo cáo PDF qua email | B |
| FR-WEB-10 | Phong thuỷ hướng nhà: tính cung mệnh theo năm sinh (Tết âm lịch), hướng nhà theo la bàn từ (bắc từ) | N |
| FR-WEB-11 | Nhà đất: danh sách tin đang bán và căn minh hoạ, bộ lọc (bang, thành phố, loại nhà, giá, phòng ngủ, thời gian trên thị trường, sắp xếp), xem danh sách/bản đồ, trang chi tiết, hỏi về căn nhà | B |
| FR-WEB-12 | Tìm nhà theo yêu cầu (property finder) mở một giao dịch bất động sản ở giai đoạn 1 trong CRM; deal VIP/wholesale cần gửi yêu cầu VIP để được duyệt | N |
| FR-WEB-13 | Đặt lịch tư vấn 3 bước: chọn loại buổi → chọn ngày giờ theo múi giờ trình duyệt → thông tin, câu hỏi, đồng ý. Buổi có phí thanh toán qua Stripe; email xác nhận kèm tệp .ics, nhắc trước 24 giờ và 1 giờ; liên kết có chữ ký để dời/huỷ |
B |
| FR-WEB-14 | Thư mục đối tác (lọc theo tiểu bang, lĩnh vực), yêu cầu giới thiệu chuyên gia, đăng ký làm đối tác (thông tin, giấy phép, ký thoả thuận, tải W-9) | N |
| FR-WEB-15 | Chương trình đại sứ: tham gia, ký thoả thuận, mã giới thiệu, bảng theo dõi lượt nhấp/đăng ký/hoa hồng | N |
| FR-WEB-16 | Tìm kiếm toàn website (từ khoá; tìm ngữ nghĩa khi có Voyage) | N |
| FR-WEB-17 | Trợ lý AI trả lời câu hỏi, chuyển thành lead khi khách muốn được liên hệ; không có khoá AI thì trả lời từ câu hỏi thường gặp | T |
| FR-WEB-18 | Văn bản pháp lý (quyền riêng tư, điều khoản, cookie, miễn trừ) hiển thị nhãn bản nháp cho tới khi được duyệt | B |
| FR-WEB-19 | Biểu ngữ cookie (Đồng ý / Từ chối / Cài đặt); GA4 và Clarity chỉ tải sau khi đồng ý; GPC luôn được coi là từ chối | B |
3.3 Quản trị nội dung (CMS)
| Mã | Yêu cầu | Ưu tiên |
|---|---|---|
| FR-CMS-01 | CMS tại /cms, đăng nhập bằng tài khoản nền tảng; chỉ admin và marketing được vào; mất quyền có hiệu lực trong 30 giây |
B |
| FR-CMS-02 | Cấu hình chung: Đầu trang, Chân trang, Cài đặt website (liên hệ, mạng xã hội, nội dung đồng ý và phiên bản), Trắc nghiệm lộ trình, Giả định công cụ tính, Catalog khoá học | B |
| FR-CMS-03 | Nội dung: Trang (dựng từ khối), Kiến thức & Podcast, Dịch vụ, Trang tiểu bang, Sách, Tài liệu miễn phí; Thư viện: Câu hỏi thường gặp, Tác giả, Ảnh/tệp, Tệp tải về có điều kiện; Phân loại: Danh mục, Chủ đề | B |
| FR-CMS-04 | Song ngữ vi (mặc định)/en, không tự lấy bản tiếng Việt thay bản tiếng Anh còn thiếu; slug riêng theo ngôn ngữ | B |
| FR-CMS-05 | Bản nháp, xem trước trực tiếp (390 px và 1440 px), xuất bản làm mới trang ngay (không cần triển khai lại) | B |
| FR-CMS-06 | Liên kết biên tập viên nhập chỉ nhận /…, https://…, mailto:, tel: |
B |
| FR-CMS-07 | Biên tập viên marketing chỉ thấy tên biên tập viên khác; email và vai trò chỉ admin thấy |
N |
3.4 Học viện (ACA)
| Mã | Yêu cầu | Ưu tiên |
|---|---|---|
| FR-ACA-01 | Danh mục: "Lộ trình 4 bước" và "Khoá bổ trợ", mỗi thẻ có số bài, giá hoặc Miễn phí, số bài học thử | B |
| FR-ACA-02 | Trang khoá học: giới thiệu, đề cương, giảng viên, chính sách; xem bài học thử; mã giới thiệu đại sứ | B |
| FR-ACA-03 | Ghi danh miễn phí hoặc thanh toán Stripe Checkout; quay lại trang khoá học với kết quả thanh toán | B |
| FR-ACA-04 | Trình học: mục lục và % hoàn thành, video có watermark email người học, bài văn bản, tab Tổng quan / Tài liệu / Ghi chú / Bản ghi lời / Trợ lý học tập; nút bài trước/tiếp theo | B |
| FR-ACA-05 | Bài video hoàn thành khi xem ≥ 90%; tiếp tục từ vị trí đã xem; khoá tuần tự mở bài sau khi xong bài trước | B |
| FR-ACA-06 | Trắc nghiệm có thời gian, một hoặc nhiều đáp án, điểm đạt, làm lại, giải thích; đáp án không gửi về trình duyệt trước khi được phép | B |
| FR-ACA-07 | Hoàn thành khoá học cấp chứng nhận PDF với mã BTD-XXXX-XXXX-XXXX; trang xác minh công khai /verify/{mã} |
B |
| FR-ACA-08 | Khoá học của tôi: tiến độ, Tiếp tục học, Xem lại, Tải chứng nhận | B |
| FR-ACA-09 | Video tải lên dùng URL có chữ ký (mặc định 2 giờ) kiểm tra lại quyền ở mỗi request; hoàn tiền thu hồi quyền ngay | B |
| FR-ACA-10 | Trợ lý học tập AI (Tóm tắt, Phân tích, Hỏi đáp, Tự kiểm tra) kèm lưu ý "không phải tư vấn pháp lý, thuế hay đầu tư" | T |
| FR-ACA-11 | Nhân viên xem bài học không cần ghi danh; tiến độ của nhân viên không được ghi nhận | N |
3.5 Sandy CRM — khách hàng và bán hàng (CRM)
| Mã | Yêu cầu | Ưu tiên |
|---|---|---|
| FR-CRM-01 | Tổng quan: tổng khách, khách mới tháng, chưa có người phụ trách, quá hạn SLA 24 giờ, khách nóng, lead MQL, dự báo pipeline, tiền cọc khoá học, doanh thu tháng theo mảng; biểu đồ theo khoảng 7/30/90 ngày hoặc tuỳ chọn | B |
| FR-CRM-02 | Danh sách khách hàng: tìm theo mã, tên, email, SĐT; lọc theo giai đoạn, nhóm, kênh, phân khúc, nguồn, bang, người phụ trách, thẻ, hạn phản hồi; danh sách đã lưu; sắp xếp; phân trang; chế độ "Chưa phân công" | B |
| FR-CRM-03 | Tạo/sửa khách hàng: họ tên bắt buộc, cần email hoặc điện thoại; email và điện thoại là duy nhất trong khách đang hoạt động (trùng báo người đang phụ trách) | B |
| FR-CRM-04 | Mã khách tự sinh BTD-000001, không đổi |
B |
| FR-CRM-05 | Hồ sơ khách: thông tin, điểm và lý do điểm, dòng hoạt động (ghi chú, cuộc gọi, email, tư vấn…), giao dịch, việc cần làm, lịch hẹn, đồng ý liên lạc theo kênh, gửi email theo mẫu, mẫu SMS | B |
| FR-CRM-06 | Sales chỉ thấy khách mình và khách chưa phân công, chỉ tạo khách cho mình, được "Nhận khách" chưa phân công; khách ngoài phạm vi trả 404 | B |
| FR-CRM-07 | Xuất CSV và xoá (mềm) khách hàng chỉ dành cho admin; mọi lần xem, xuất, sửa được ghi nhật ký kiểm toán (chỉ tên trường) | B |
| FR-CRM-08 | Hộp thư lead: tab Chưa xử lý / Tất cả / Đã xử lý; giao cho nhân viên; đánh dấu đã xử lý, mở lại; hiển thị SLA; admin nhận bản tổng hợp quá hạn | B |
| FR-CRM-09 | Pipeline: các quy trình Tuyển sinh khoá học, Giao dịch bất động sản, Thẩm định và tư vấn đầu tư, Đối tác và doanh nghiệp, Đầu tư cho thuê, Giới thiệu sang bang khác; xem dạng bảng (kéo thả) hoặc danh sách; tìm, lọc theo người phụ trách; sửa giai đoạn; tạo giao dịch | B |
| FR-CRM-10 | Ràng buộc chuyển giai đoạn: deal bất động sản chỉ admin hoặc sales có giấy phép được sửa; khách cư trú Việt Nam phải xác minh nguồn tiền sau giai đoạn 1; 7 mốc giao dịch bắt buộc ở giai đoạn 2–6; đóng cần giá bán; khoá học giai đoạn 4 cần tiền cọc; thất bại cần lý do | B |
| FR-CRM-11 | Hoa hồng môi giới = giá bán × tỷ lệ cấu hình (mặc định 2,5%) | N |
| FR-CRM-12 | Việc cần làm: tab Quá hạn / Hôm nay / Sắp tới / Đã xong, lọc người được giao, tạo việc gắn khách/giao dịch, nhắc việc, mở lại | B |
| FR-CRM-13 | Lịch hẹn: lịch tuần và danh sách, tạo/dời/huỷ, đánh dấu hoàn thành/vắng mặt sau giờ hẹn, mở lại; lọc theo loại, người tiếp, trạng thái | B |
| FR-CRM-14 | Cài đặt đặt lịch: loại buổi tư vấn (thời lượng, phí, hình thức, người tư vấn — admin), giờ làm việc, ngày ngoại lệ, múi giờ, đồng bộ Google Calendar | B |
| FR-CRM-15 | Bàn giao cho thuê (NTBS), yêu cầu VIP (duyệt/từ chối), hành trình khách (theo sản phẩm, vòng đời, đối tác) | N |
| FR-CRM-16 | Mẫu nội dung: ghi chú cuộc gọi, ghi chú tư vấn, email, SMS; biến điền sẵn theo khách | N |
| FR-CRM-17 | Bất động sản: danh sách, lọc, thêm/sửa/xoá, nhập CSV, ảnh, trạng thái hiển thị trên website | B |
| FR-CRM-18 | Dữ liệu: nhập khách hàng từ CSV (khớp cột, báo kết quả), gợi ý hồ sơ trùng và gộp, danh sách động lưu từ bộ lọc | B |
3.6 Sandy CRM — marketing (MKT)
| Mã | Yêu cầu | Ưu tiên |
|---|---|---|
| FR-MKT-01 | Chiến dịch email: draft → scheduled → sending → sent (hoặc cancelled, skipped); nội dung vi và en bằng khối (tiêu đề, văn bản, ảnh, nút, đường kẻ, thẻ); người nhận theo bộ lọc; gửi thử; duyệt; hẹn giờ; huỷ |
B |
| FR-MKT-02 | Bản tin tuần theo chủ đề: mặc định thứ Năm 08:00 America/Chicago, gom bản nháp trước 72 giờ, cần duyệt trước khi gửi | B |
| FR-MKT-03 | Chuỗi email (draft/active/paused) kích hoạt khi xác nhận bản tin, độc giả sách, tải tài liệu, ghi danh khoá học | N |
| FR-MKT-04 | Liên kết UTM: tạo liên kết có nguồn/kênh/chiến dịch, sao chép, thống kê nguồn | N |
| FR-MKT-05 | Tự động hoá: email tự động theo sự kiện (độ trễ, mẫu, trạng thái), hộp thư đi, nhắc học phí 48 giờ | N |
| FR-MKT-06 | Chỉ gửi email marketing cho người có đồng ý; mọi email marketing có địa chỉ bưu chính và liên kết huỷ đăng ký | B |
| FR-MKT-07 | Nội dung trang chủ (Hub 6 mảng) sửa từ CRM, lưu về CMS | N |
3.7 Sandy CRM — đối tác, đại sứ, tài chính (PRT)
| Mã | Yêu cầu | Ưu tiên |
|---|---|---|
| FR-PRT-01 | Đối tác: applied → screening → interview → approved (hoặc rejected), approved ↔ suspended; môi giới bất động sản bắt buộc giấy phép còn hạn |
B |
| FR-PRT-02 | Phân khách tự động cho môi giới đối tác (chạy theo lịch hoặc "Chạy phân khách"); admin giao/thu hồi thủ công | N |
| FR-PRT-03 | Phí giới thiệu: chiều vào expected → invoiced → received, chiều ra paid; cancelled/waived; tính theo % hoặc cố định; chỉ cho môi giới có giấy phép (RESPA §8) |
B |
| FR-PRT-04 | Đại sứ: pending/active/suspended/rejected; hoa hồng mặc định 10%, ghi nhận trong 30 ngày, chỉ trên khoá học/dịch vụ; chi trả hằng tháng; xuất CSV |
B |
| FR-PRT-05 | Thuế 1099-NEC: tổng hợp theo năm thuế cho đại sứ và đối tác, trạng thái W-9, xuất CSV | B |
| FR-PRT-06 | Khu làm việc đối tác /workspace: khách được giao, danh bạ, pipeline, nhắc việc, lịch hẹn, mạng lưới, báo cáo, trợ lý AI, nhập/xuất dữ liệu, hồ sơ & quyền riêng tư; dữ liệu cô lập theo đối tác |
N |
| FR-PRT-07 | Sản phẩm & lớp học, đặt trước sách, ghi danh học viện, doanh thu (thêm khoản thủ công theo dòng), soạn khoá học (bài học, video, trắc nghiệm) | B |
3.8 Báo cáo (RPT)
| Mã | Yêu cầu | Ưu tiên |
|---|---|---|
| FR-RPT-01 | Phễu & nguồn: theo tháng/quý/từ đầu năm hoặc khoảng ngày; lọc quy trình, người phụ trách, bang; quy nguồn theo lần chạm đầu/cuối; tab mạng lưới đối tác và doanh thu | B |
| FR-RPT-02 | Hiệu suất người phụ trách (admin, sales) | B |
| FR-RPT-03 | Bộ 8 chỉ số dự án theo tháng, sửa mục tiêu và mốc triển khai (admin) | B |
3.9 AI trong CRM (AI)
| Mã | Yêu cầu | Ưu tiên |
|---|---|---|
| FR-AI-01 | Việc nên làm hôm nay, trợ lý dữ liệu (hỏi đáp trên dữ liệu trong phạm vi người dùng), cảnh báo bất thường, báo cáo tuần (admin) | T |
| FR-AI-02 | Trên hồ sơ khách: đánh giá mức sẵn sàng, tóm tắt trước cuộc gọi, soạn nháp trả lời email/SMS song ngữ, tóm tắt buổi tư vấn (bắt buộc xác nhận đồng ý ghi âm) | T |
| FR-AI-03 | AI chỉ soạn nháp/gợi ý; nhân viên bấm chấp nhận mới ghi vào dòng hoạt động, việc hoặc giai đoạn | B |
| FR-AI-04 | Thiếu khoá của nhà cung cấp đang chọn thì CRM chạy chế độ quy tắc: trợ lý, ưu tiên, agents vẫn hoạt động; tính năng cần mô hình báo "chưa được cấu hình" | B |
| FR-AI-05 | Thẻ hành động: trợ lý đề xuất thao tác cho chức năng người dùng được phép; chỉ thực hiện khi người dùng xác nhận; thao tác không hoàn tác được, hoặc đề xuất sau khi đọc dữ liệu đã lưu, cần gõ XAC NHAN; thẻ hết hạn sau 15 phút; ghi nhật ký kiểm toán |
B |
| FR-AI-06 | Hộp duyệt tin và 4 agent (khách nguội, khách mới, chuẩn bị lịch hẹn, rà soát pipeline) chỉ soạn nháp và đặt việc; gửi email cần đồng ý marketing | N |
| FR-AI-07 | Nhà cung cấp AI chọn bằng AI_PROVIDER (Anthropic, OpenAI, OpenRouter); admin đổi mô hình cho 6 mục đích trong Cài đặt CRM, có kiểm tra mô hình trước khi lưu |
N |
Chi tiết từng chức năng AI: Chức năng AI trong Sandy CRM.
4. Yêu cầu giao diện ngoài
4.1 Giao diện người dùng
- Song ngữ vi/en, cookie ngôn ngữ
NEXT_LOCALEdùng chung giữa các ứng dụng. - CRM: thanh điều hướng trái theo nhóm (Công việc, Báo cáo, Trợ lý AI, Dữ liệu khách hàng, Email marketing, Kinh doanh & tài chính, Học viện, Quản trị), đường dẫn breadcrumb, chip phạm vi dữ liệu, nút ngôn ngữ, menu tài khoản; trạng thái rỗng và trạng thái tải thống nhất.
- Thông báo lỗi tiếng Việt rõ ràng gắn với từng trường (API trả lỗi RFC 9457 kèm danh sách trường).
- Ảnh minh hoạ giao diện: Hướng dẫn sử dụng.
4.2 Giao diện phần mềm
| Hệ thống | Mục đích | Bật bằng |
|---|---|---|
| Stripe | Đặt trước sách (chế độ thu tiền), khoá học, buổi tư vấn có phí, hoàn tiền | STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET |
| Resend hoặc SMTP | Email giao dịch và marketing | MAIL_TRANSPORT, RESEND_API_KEY / SMTP_* |
| Google Calendar | Đồng bộ lịch hai chiều, link Meet | GOOGLE_SERVICE_ACCOUNT_JSON, GOOGLE_CALENDAR_IMPERSONATE |
| Cloudflare Turnstile | Chống bot cho biểu mẫu và đăng ký | TURNSTILE_SECRET, NEXT_PUBLIC_TURNSTILE_SITE_KEY |
| Cloudflare Stream | Video học viện HLS có token ký | VIDEO_PROVIDER=cloudflare, CLOUDFLARE_STREAM_* |
| Anthropic, OpenAI hoặc OpenRouter | Mọi tính năng AI | AI_PROVIDER + ANTHROPIC_API_KEY / OPENAI_API_KEY / OPENROUTER_API_KEY |
| Voyage | Tìm kiếm ngữ nghĩa | VOYAGE_API_KEY |
| Speech-to-text | Phụ đề bài học | STT_* hoặc CLOUDFLARE_ACCOUNT_ID + CLOUDFLARE_API_TOKEN |
| S3 | Ảnh tin đăng, media CMS | LISTING_MEDIA_S3_*, S3_BUCKET |
| GA4, Microsoft Clarity | Phân tích (sau đồng ý) | NEXT_PUBLIC_GA_ID, NEXT_PUBLIC_CLARITY_ID |
| Google Maps | Bản đồ tin đăng | NEXT_PUBLIC_GOOGLE_MAPS_API_KEY |
4.3 Giao diện truyền thông
- HTTPS bắt buộc ở production; API REST JSON tại
/api/v1, lỗi theo RFC 9457. - Webhook vào: Stripe, Resend (chữ ký được kiểm tra).
- Email ra kèm tệp lịch
invite.ics/cancel.ics.
5. Yêu cầu phi chức năng
5.1 Bảo mật (SEC)
| Mã | Yêu cầu |
|---|---|
| NFR-SEC-01 | Access token JWT EdDSA 15 phút; refresh token mờ, băm, xoay vòng, 7 ngày; dùng lại token cũ sau 30 giây ân hạn thu hồi cả họ phiên |
| NFR-SEC-02 | Cookie access_token, refresh_token: HttpOnly, SameSite=Lax, Secure ở production, domain cha |
| NFR-SEC-03 | Mật khẩu 8–128 ký tự, băm argon2id (19 MiB, t=2, p=1), hàng đợi băm giới hạn (quá tải trả 429) |
| NFR-SEC-04 | Chống CSRF (Go CrossOriginProtection); header bảo mật; X-Frame-Options: SAMEORIGIN, CSP frame-ancestors 'self' |
| NFR-SEC-05 | Giới hạn đăng nhập sai theo email (10) và IP (30); giới hạn email gửi 5/giờ/địa chỉ; biểu mẫu 10/giờ/email và 20/phút/IP; honeypot trên mọi biểu mẫu công khai |
| NFR-SEC-06 | Liên kết tải, huỷ đăng ký, quản lý lịch hẹn, video đều có chữ ký HMAC và hạn dùng |
| NFR-SEC-07 | W-9 mã hoá AES-256-GCM khi lưu; tải lên bị tắt nếu thiếu khoá mã hoá |
| NFR-SEC-08 | Production từ chối khởi động nếu thiếu TRUST_PROXY/TRUSTED_PROXY_CIDRS, URL https, địa chỉ bưu chính, hoặc dùng khoá Turnstile thử |
| NFR-SEC-09 | Phân quyền thực thi ở API; vai trò đọc lại từ CSDL mỗi request |
5.2 Quyền riêng tư và tuân thủ (PRV)
| Mã | Yêu cầu |
|---|---|
| NFR-PRV-01 | Sổ đồng ý theo khách và theo kênh (email, SMS, gọi), lưu đúng như khách tick, kèm phiên bản nội dung đồng ý |
| NFR-PRV-02 | Bản tin xác nhận 2 bước; đồng ý marketing chỉ được ghi khi xác nhận |
| NFR-PRV-03 | Cookie phân tích và giới thiệu chỉ đặt khi đồng ý; GPC = từ chối |
| NFR-PRV-04 | Nhật ký kiểm toán chỉ ghi tên trường, không ghi giá trị; access log không có đường dẫn thô, nội dung hay danh tính |
| NFR-PRV-05 | Hội thoại AI lưu tối đa AI_CHAT_RETENTION_DAYS (mặc định 30 ngày) |
| NFR-PRV-06 | CAN-SPAM (địa chỉ bưu chính trong email marketing), TCPA (chỉ quay số thủ công), RESPA §8 (phí giới thiệu bán nhà chỉ cho môi giới có giấy phép) |
| NFR-PRV-07 | Yêu cầu truy xuất/xoá dữ liệu cá nhân hiện xử lý thủ công (chưa có chức năng tự động) |
5.3 Hiệu năng và khả năng mở rộng (PRF)
| Mã | Yêu cầu |
|---|---|
| NFR-PRF-01 | Trang công khai được dựng tĩnh/ISR, xuất bản CMS làm mới theo tag, không cần triển khai lại |
| NFR-PRF-02 | Email, đồng bộ lịch, gửi marketing, chấm điểm, phân khách, AI chạy nền; request người dùng không chờ dịch vụ ngoài |
| NFR-PRF-03 | Bảng Kanban tối đa 200 giao dịch mỗi cột; danh sách phân trang 10/20/50/100 dòng |
| NFR-PRF-04 | Ngân sách token AI toàn hệ thống theo ngày (AI_DAILY_TOKEN_BUDGET, mặc định 2.000.000); CRM 10 request/phút và 200.000 token/ngày mỗi người |
5.4 Khả dụng và vận hành (OPS)
| Mã | Yêu cầu |
|---|---|
| NFR-OPS-01 | /healthz, /readyz; khi tắt máy /readyz trả 503 trước rồi dừng trong SHUTDOWN_TIMEOUT |
| NFR-OPS-02 | Email không mất khi dịch vụ gửi lỗi (outbox + thử lại) |
| NFR-OPS-03 | Migration CSDL đi kèm binary, áp dụng trước khi API chạy; sao lưu CSDL trước mọi thay đổi schema |
| NFR-OPS-04 | Mọi tác vụ nền có lệnh CLI tương ứng để chạy bằng cron |
5.5 Khả năng sử dụng, ngôn ngữ, SEO (USE)
| Mã | Yêu cầu |
|---|---|
| NFR-USE-01 | Toàn bộ giao diện có bản vi và en; tiếng Việt là mặc định |
| NFR-USE-02 | Đáp ứng điện thoại (kiểm thử ở 390 px), không cuộn ngang |
| NFR-USE-03 | Có liên kết "Bỏ qua điều hướng", nhãn cho mọi trường, điều khiển được bằng bàn phím, màu chữ đạt tương phản WCAG AA (vàng thương hiệu không dùng làm chữ trên nền sáng) |
| NFR-USE-04 | sitemap.xml, robots.txt, hreflang; trang tài khoản và tìm kiếm noindex; JSON-LD cho khoá học |
| NFR-USE-05 | Thời gian hiển thị theo múi giờ người xem (đặt lịch) hoặc múi giờ cấu hình (bản tin) |
6. Mô hình trạng thái nghiệp vụ
| Đối tượng | Trạng thái và chuyển tiếp |
|---|---|
| Khách hàng (lifecycle) | subscriber → lead → mql → sql → opportunity → customer (chỉ tiến, nhân viên được sửa); referrer. Điểm nóng tự nâng lên mql |
| Nhóm khách | first_home, new_investor, portfolio, vietnam, legacy, unassigned |
| Phân khúc / Nguồn | investor, homebuyer, learner, referral / website_form, calculator, book, book_qr, newsletter, social, udemy, partner, referral, event, import, other |
| Giao dịch | open → won (giai đoạn thắng) hoặc lost (cần lý do); mở lại được |
| Lịch hẹn | pending_payment → confirmed → completed | no_show; cancelled, expired; mở lại được nếu chưa bắt đầu |
| Chiến dịch email | draft → scheduled → sending → sent; cancelled, skipped |
| Chuỗi email | draft, active, paused |
| Đối tác | applied → screening → interview → approved; rejected; approved ↔ suspended |
| Phí giới thiệu | vào: expected → invoiced → received; ra: paid; cancelled, waived |
| Đại sứ / hoa hồng / chi trả | pending, active, suspended, rejected / pending, reversed, in_payout, paid / pending, paid, cancelled |
| Việc cần làm | open → done, mở lại được |
Pipeline mặc định: Tuyển sinh khoá học (5 giai đoạn), Giao dịch bất động sản (6), Thẩm định và tư vấn đầu tư (5), Đối tác và doanh nghiệp (5), Đầu tư cho thuê (6), Giới thiệu sang bang khác (6). Tên giai đoạn là dữ liệu, admin sửa được.
7. Ma trận phân quyền (tóm tắt)
| Chức năng | admin | sales | marketing | tech | partner | ambassador | student |
|---|---|---|---|---|---|---|---|
| Tài khoản, đổi mật khẩu, học viện | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| CMS | ✓ | – | ✓ | – | – | – | – |
| Khách hàng, hoạt động, đồng ý, tổng quan | tất cả | của mình + chưa giao | tất cả | – | – | – | – |
| Xuất CSV / xoá khách hàng | ✓ | – | – | – | – | – | – |
| Hộp thư lead | ✓ | ✓ | – | – | – | – | – |
| Pipeline, việc, lịch hẹn, mẫu, hành trình | ✓ | ✓ | ✓ | – | – | – | – |
| Bất động sản (xem / sửa) | ✓/✓ | ✓/✓ | ✓/✓ | ✓/– | – | – | – |
| Email marketing, tự động hoá, nhập dữ liệu | ✓ | – | ✓ | – | – | – | – |
| Khoá học, ghi danh, đặt trước, trang chủ | ✓ | – | ✓ | – | – | – | – |
| Sản phẩm & lớp học | ✓ | ✓ | ✓ | – | – | – | – |
| Báo cáo phễu / hiệu suất / 8 KPI | ✓/✓/✓ | ✓/✓/– | ✓/–/– | – | – | – | – |
| Đối tác, phí giới thiệu, đại sứ, chi trả, thuế, doanh thu, người dùng | ✓ | – | – | – | – | – | – |
Khu làm việc /workspace |
– | – | – | – | ✓ | – | – |
| Bảng đại sứ | – | – | – | – | – | ✓ | – |
Nguồn: apps/crm/src/components/layout/nav-items.ts, packages/auth/src/roles.ts,
api-contract.md §3.
8. Tiêu chí nghiệm thu chung
- Mỗi yêu cầu B có kiểm thử tự động (Go integration, Playwright) hoặc bằng chứng trong
plans/reports/. - Kiểm thử phân quyền: mỗi vai trò chỉ thấy và gọi được đúng chức năng ở §7 (API trả 403/404 cho phần còn lại).
- Mọi biểu mẫu công khai: Turnstile, honeypot, giới hạn tần suất, ô đồng ý để trống mặc định.
- Toàn bộ màn hình có bản vi/en, hiển thị đúng trên 390 px và 1440 px.
- Khi thiếu khoá dịch vụ, tính năng tương ứng ẩn hoặc báo "chưa khả dụng", không lỗi trang.
9. Điều kiện ra mắt và thông tin chờ khách hàng
Chặn ra mắt:
- Địa chỉ bưu chính công ty (
COMPANY_POSTAL_ADDRESS, CAN-SPAM) — API từ chối chạy production khi thiếu. - Luật sư duyệt chính sách quyền riêng tư, điều khoản, thoả thuận đối tác và đại sứ.
- Khoá production: Stripe, Resend, Google, Anthropic, Voyage, Cloudflare (Turnstile, Stream),
DOCUMENT_ENCRYPTION_KEY.
Cần quyết định: giá và ngày giao sách; múi giờ của Sandy; chính sách huỷ/hoàn tiền lịch hẹn; tên, giấy phép và các bang hoạt động của công ty môi giới; danh mục đối tác; ngưỡng 1099 ($600 hay $2.000); xoá EXIF ảnh tải lên; email NTBS; cửa sổ khách nóng; 5 nguồn lead và mục tiêu 8 KPI; người nhận báo cáo AI hằng tuần; các bang yêu cầu mọi bên đồng ý ghi âm; mã giảm giá; xáo trộn câu hỏi trắc nghiệm; khiếu nại spam có thu hồi đồng ý; ghi danh chuỗi email trước khi xác nhận 2 bước; khoá Google Maps; nexus thuế bán hàng (CPA); giấy phép marketing wholesale; tỷ lệ chia phí RESPA.
Danh sách cập nhật: plan.md — Open client inputs.
10. Truy vết yêu cầu → hướng dẫn sử dụng
| Nhóm yêu cầu | Chương hướng dẫn |
|---|---|
| FR-AUTH | 01 — Tài khoản |
| FR-WEB | 02 — Website |
| FR-ACA | 03 — Học viện |
| FR-CMS | 04 — CMS |
| FR-CRM, FR-RPT | 05 — Sandy CRM: bán hàng |
| FR-AI | Chức năng AI trong Sandy CRM |
| FR-MKT, FR-PRT, quản trị | 06 — Sandy CRM: marketing, tài chính, quản trị |
1. Tài khoản: đăng ký, đăng nhập, mật khẩu
Một tài khoản Beyond The Deed dùng chung cho website, học viện, CMS và Sandy CRM.
1.1 Thanh điều hướng website
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Menu chính | Giới thiệu, Nhà đất, Dịch vụ, Công cụ, Học viện, Insights, Đối tác. Di chuột hoặc bấm để mở danh mục con |
| ② | Tìm kiếm | Mở trang tìm kiếm toàn website |
| ③ | Ngôn ngữ | Đổi giữa Tiếng Việt (VI) và English (EN); bạn ở lại đúng trang tương ứng |
| ④ | Đăng nhập | Mở trang đăng nhập. Sau khi đăng nhập, nút đổi thành menu Tài khoản |
| ⑤ | Gửi câu hỏi | Mở biểu mẫu liên hệ đội ngũ tư vấn |
| ⑥ | Gợi ý của bạn | Nội dung gợi ý theo lộ trình bạn chọn |
| ⑦ | Hỏi trợ lý | Mở trợ lý trò chuyện (xem 2.10) |
| ⑧ | Bắt đầu hành trình | Đi tới trắc nghiệm tìm lộ trình phù hợp |
1.2 Đăng ký tài khoản
- Bấm Đăng nhập (Hình 1.1 ④), chọn Đăng ký, hoặc mở
/vi/register. - Nhập Họ và tên (①) và Email (②).
- Số điện thoại (③) không bắt buộc; nhập số Mỹ dạng
(512) 555-0147hoặc số quốc tế có+. - Đặt Mật khẩu (④) từ 8 đến 128 ký tự, nhập lại ở ⑤.
- Bấm Tạo tài khoản (⑥). Hệ thống tự kiểm tra chống bot (Cloudflare Turnstile).
- Mở email "Xác nhận email" và bấm liên kết trong 24 giờ. Trang báo "Email đã được xác nhận. Bạn có thể đăng nhập."
- Đã có tài khoản thì bấm Đăng nhập (⑦).
Không nhận được email? Ở trang đăng nhập, nếu tài khoản chưa xác nhận, bấm Gửi lại email xác nhận. Mỗi địa chỉ được gửi tối đa 5 email mỗi giờ. Kiểm tra cả thư mục Spam.
1.3 Đăng nhập
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tab Mật khẩu | Đăng nhập bằng email và mật khẩu (mặc định) |
| ② | Tab Đăng nhập bằng email | Nhận mã 6 số qua email. Tài khoản chỉ có vai trò đối tác dùng cách này |
| ③ | Email đã đăng ký | |
| ④ | Mật khẩu | Mật khẩu của bạn |
| ⑤ | Quên mật khẩu? | Xem 1.4 |
| ⑥ | Đăng nhập | Gửi thông tin |
| ⑦ | Đăng ký | Chưa có tài khoản |
Các bước:
- Nhập email (③) và mật khẩu (④), bấm Đăng nhập (⑥).
- Bạn được đưa về trang đang xem trước đó, hoặc trang Tài khoản.
- Đăng nhập bằng mã: chọn tab ②, nhập email, bấm gửi mã, nhập mã 6 số trong email. Nhập sai 5 lần thì mã bị huỷ; sai 20 lần trong 24 giờ thì phải chờ 24 giờ.
Đăng nhập sai nhiều lần liên tiếp sẽ bị tạm chặn để bảo vệ tài khoản. Chờ vài phút rồi thử lại hoặc đặt lại mật khẩu.
1.4 Quên mật khẩu
- Ở trang đăng nhập bấm Quên mật khẩu?.
- Nhập email (①), bấm Gửi liên kết (②). Thông báo luôn giống nhau dù email có tồn tại hay không, để bảo vệ quyền riêng tư.
- Mở email, bấm liên kết trong 30 phút, nhập mật khẩu mới, bấm Lưu mật khẩu mới.
- Liên kết hết hạn: bấm Gửi liên kết mới.
- Nhớ lại mật khẩu thì quay về Đăng nhập (③).
1.5 Trang Tài khoản
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Menu Tài khoản | Mở nhanh trang tài khoản, đăng xuất |
| ② | Mở học viện | Sang Học viện (đã đăng nhập sẵn) |
| ③ | Mở Sandy CRM | Chỉ hiện với nhân viên và đối tác |
| ④ | Bạn được làm | Danh sách việc vai trò của bạn cho phép |
| ⑤ | Giới hạn | Những gì vai trò của bạn không được làm |
| ⑥ | Đăng xuất | Thoát khỏi mọi ứng dụng cùng lúc |
1.6 Đổi mật khẩu
- Mở trang Tài khoản, cuộn tới phần đổi mật khẩu.
- Nhập Mật khẩu hiện tại (①), Mật khẩu mới (②) và nhập lại (③).
- Bấm Đổi mật khẩu (④).
1.7 Ngôn ngữ
Nút VI/EN có ở mọi ứng dụng. Lựa chọn được nhớ và dùng chung cho website, học viện và CRM.
2. Website: tìm hiểu, công cụ, đặt lịch, đăng ký
Website dành cho mọi khách truy cập, không cần đăng nhập. Mọi biểu mẫu đều có kiểm tra chống bot tự động; các ô đồng ý nhận email/SMS/cuộc gọi luôn để trống — bạn chỉ tick khi thật sự muốn.
2.1 Gửi câu hỏi cho đội ngũ (Liên hệ)
Đường dẫn: menu Gửi câu hỏi hoặc /vi/lien-he.
- Chọn chủ đề ở Bạn cần tư vấn về (①): Đầu tư bất động sản, Mua nhà để ở, Học bài bản, Khác.
- Nhập Họ và tên (②).
- Nhập Email (③) hoặc Số điện thoại (④) — cần ít nhất một trong hai.
- Chọn Tiểu bang quan tâm (⑤) nếu đã có.
- Viết câu hỏi ở Nội dung (⑥), tối đa 5.000 ký tự.
- Tick các ô đồng ý liên lạc nếu muốn, rồi bấm Gửi yêu cầu (⑦).
Sau khi gửi: yêu cầu vào Hộp thư lead của CRM; đội ngũ phản hồi trong vòng 24 giờ.
2.2 Đăng ký bản tin
Đường dẫn: /vi/ban-tin. Bản tin tiếng Việt gửi sáng thứ Năm hằng tuần.
- Nhập Email (①); Họ và tên (②) không bắt buộc.
- Chọn 1–3 chủ đề (③): Đầu tư cho thuê, Mua nhà để ở, Học bài bản.
- Tick ô đồng ý nhận email (④) — bắt buộc để đăng ký.
- Bấm Đăng ký (⑤).
- Mở email xác nhận và bấm liên kết trong 7 ngày. Chỉ sau bước này bạn mới nhận bản tin.
Mỗi email bản tin có liên kết Quản lý chủ đề và Huỷ đăng ký ở cuối thư.
2.3 Trắc nghiệm "Bạn đang ở chặng nào?"
Đường dẫn: nút Bắt đầu hành trình ở trang chủ hoặc /vi/tim-lo-trinh.
- Trả lời 4 câu: bạn đang sống ở đâu (①), đã sở hữu bao nhiêu căn (②), số vốn sẵn có (③), mục tiêu chính (④).
- Bấm Xem kết quả. Hệ thống xếp bạn vào nhóm nhà đầu tư, người mua nhà hoặc người học và gợi ý khoá học/bài viết phù hợp.
- Muốn nhận lộ trình qua email, nhập email và bấm Gửi lộ trình cho tôi. Bấm Làm lại để trả lời lại.
2.4 Xem nhà đang bán
Đường dẫn: menu Nhà đất → Nhà đang niêm yết hoặc /vi/nha-dat.
- Mỗi thẻ (①②③) cho biết khu vực, loại nhà, giá, dòng tiền ước tính. Bấm vào thẻ để xem chi tiết: ảnh, thông số, phân tích dòng tiền, nút hỏi về căn nhà và đặt lịch xem nhà.
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tin đang bán | Căn thật đang rao bán |
| ② | Căn minh hoạ | Căn mẫu để học cách phân tích |
| ③ | Bang | Lọc theo tiểu bang |
| ④ | Thành phố | Gõ tên thành phố, ví dụ Houston |
| ⑤ | Loại nhà | Nhà đơn lập, condo, nhà phố, duplex… |
| ⑥ | Giá | Khoảng giá |
| ⑦ | Phòng ngủ | Số phòng ngủ tối thiểu |
| ⑧ | Sắp xếp | Dòng tiền cao trước, tỷ suất vốn hoá, giá thấp trước… |
| ⑨ | Nguồn | Lọc theo nguồn tin (ví dụ Zillow) |
Không tìm được căn phù hợp? Dùng Tìm nhà giúp tôi (/vi/nha-dat/tim-nha) để gửi tiêu chí; đội
ngũ sẽ gửi danh sách căn phù hợp. Deal wholesale/off-market cần gửi Yêu cầu VIP và được duyệt
mới xem được.
2.5 Công cụ tính dòng tiền và DSCR
Đường dẫn: menu Công cụ hoặc /vi/cong-cu. Có 4 công cụ: Thẩm định nhanh, Dòng tiền & DSCR,
Bài toán một căn nhà, Vay mua nhà; thêm Hướng nhà và phong thuỷ.
- Chọn Tiểu bang (①) để điền sẵn thuế nhà đất và bảo hiểm trung bình của bang.
- Nhập Giá mua (②) và các ô còn lại theo nhóm: Mua nhà, Khoản vay, Thu nhập cho thuê, Chi phí vận hành, Nắm giữ và bán.
- Khung Kết quả (④) cập nhật ngay khi bạn gõ: Dòng tiền tháng (⑤; số đỏ là âm, bạn phải bù tiền), DSCR (⑥; ngân hàng cho vay DSCR thường cần từ 1,0, từ 1,2–1,25 là tốt), Cap rate, lợi nhuận trên vốn, biểu đồ thu chi và bảng chi tiết.
- Bấm Đặt lại số mặc định (③) để làm lại từ đầu.
- Muốn lưu, nhập email ở cuối trang để nhận báo cáo PDF.
Kết quả chỉ mang tính ước tính để học tập, không phải tư vấn tài chính.
2.6 Đặt lịch tư vấn
Đường dẫn: /vi/dat-lich, hoặc nút đặt lịch ở trang dịch vụ.
Bước 1 — Chọn buổi tư vấn. Mỗi thẻ ghi thời lượng, phí và hình thức (ví dụ Google Meet). Ví dụ: Tư vấn đầu tư bất động sản (①), Tư vấn khoá học (②), Tư vấn nhanh 30 phút (③).
Bước 2 — Chọn giờ hẹn (①). Giờ hiển thị theo múi giờ của trình duyệt bạn (ghi ngay dưới tiêu đề). Dùng mũi tên (②) để đổi tháng, chọn một ngày còn trống trên lịch (③); ngày mờ là ngày không nhận hẹn. Ngày đang chọn được tô đậm (④), bên phải hiện các khung giờ trống — bấm một khung giờ (⑤).
Bước 3 — Thông tin của bạn. Nhập họ tên, email, điện thoại, nội dung muốn trao đổi, tick đồng ý rồi bấm Xác nhận đặt lịch (buổi miễn phí) hoặc Thanh toán … và đặt lịch (buổi có phí, chuyển sang trang thanh toán Stripe).
Sau khi đặt:
- Trang báo Đã đặt lịch thành công; email xác nhận kèm tệp lịch
.icsđể thêm vào Google/Outlook. - Email nhắc trước 24 giờ và 1 giờ.
- Muốn đổi giờ hoặc huỷ: bấm liên kết Quản lý lịch hẹn trong email, chọn Đổi giờ hoặc Huỷ lịch hẹn.
2.7 Tài liệu miễn phí
Đường dẫn: /vi/tai-lieu.
- Nhập Email (①), họ tên (② — không bắt buộc).
- Tick đồng ý nhận email (③) nếu muốn nhận thêm nội dung.
- Bấm Nhận liên kết tải (④). Liên kết tải được gửi qua email và hiện ngay trên trang; liên kết hết hạn sau 15 phút, cần thì yêu cầu lại.
- Tài liệu đi kèm gói được liệt kê bên phải (⑤).
Thư viện bên dưới lọc theo loại: Tất cả (①), Ebook (②), Bảng tính (③)… Bấm vào tên tài liệu (④) để xem mô tả và tải.
2.8 Đặt trước sách "Survive, then Thrive"
Đường dẫn: /vi/book (dẫn tới trang sách chính).
- Ở khung Đặt trước sách (①), xem giá và chọn Số lượng (②).
- Nhập họ và tên, email, số điện thoại (không bắt buộc).
- Tick Địa chỉ giao hàng (③) nếu muốn nhập địa chỉ tại Mỹ ngay — không bắt buộc ở bước giữ chỗ.
- Tick đồng ý liên hệ nếu muốn, rồi bấm nút đặt (④):
- Chế độ Giữ chỗ (chưa thanh toán): không cần thẻ, bạn nhận email xác nhận giữ chỗ.
- Chế độ thanh toán: chuyển sang Stripe, trang kết quả hiện mã đơn.
- Độc giả đã có sách quét mã QR trong sách (trang
/vi/doc-gia) để nhận gói tài liệu độc giả.
2.9 Tìm đối tác chuyên gia
Đường dẫn: menu Đối tác hoặc /vi/doi-tac.
- Chọn Tiểu bang (①) và Lĩnh vực (②), bấm Lọc (③).
- Bấm vào một đối tác để xem hồ sơ.
- Cần giới thiệu chuyên gia: điền Yêu cầu giới thiệu chuyên gia và bấm Gửi yêu cầu; đội ngũ sẽ kết nối, thông tin liên hệ của đối tác không công khai.
- Bạn là môi giới/chuyên gia muốn tham gia: vào Đăng ký làm đối tác (
/vi/doi-tac/dang-ky), đăng nhập, điền thông tin, giấy phép, ký thoả thuận, tải W-9, bấm Nộp đơn.
Chương trình đại sứ (/vi/dai-su): đăng nhập, bấm Tham gia chương trình đại sứ, ký thoả
thuận, nhận mã giới thiệu để chia sẻ; theo dõi lượt nhấp, đăng ký và hoa hồng ở Bảng theo dõi
đại sứ. Hoa hồng chỉ áp dụng cho khoá học và dịch vụ.
2.10 Trợ lý AI
- Bấm Hỏi trợ lý ở góc phải dưới mọi trang; khung trò chuyện (①) mở ra.
- Bấm một gợi ý nhanh (Mua nhà lần đầu, Đầu tư nhà cho thuê, Tôi ở Việt Nam, DSCR là gì?…) hoặc gõ câu hỏi vào ô (②), bấm nút gửi (③). Bấm Đóng trợ lý ở góc trên để thu lại.
- Muốn được tư vấn trực tiếp, trả lời "có" khi trợ lý hỏi; trợ lý mở sẵn biểu mẫu liên hệ với thông tin bạn đã cung cấp.
Câu trả lời mang tính giáo dục, không phải tư vấn pháp lý, thuế hay đầu tư. Nội dung trò chuyện được lưu tối đa 30 ngày.
2.11 Cookie và quyền riêng tư
- Lần đầu truy cập, biểu ngữ cookie cho phép Đồng ý, Từ chối hoặc Cài đặt cookie.
- Công cụ phân tích chỉ chạy khi bạn đồng ý. Trình duyệt bật Global Privacy Control luôn được coi là từ chối.
- Văn bản pháp lý ở chân trang: Chính sách quyền riêng tư, Điều khoản sử dụng, Thông báo cookie, Miễn trừ trách nhiệm.
3. Học viện: ghi danh, học bài, trắc nghiệm, chứng nhận
Học viện dùng chung tài khoản với website. Mở từ menu Học viện trên website, nút Mở học viện
ở trang Tài khoản, hoặc địa chỉ academy.… trực tiếp.
3.1 Danh mục khoá học
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Lộ trình 4 bước | Các khoá học theo thứ tự nên học, từ nền tảng tới nâng cao. Bên dưới là Khoá bổ trợ |
| ② | Thẻ khoá học | Tên, mô tả ngắn, số bài học, học phí hoặc Miễn phí, số bài học thử. Bấm để mở trang khoá học |
| ③ | Tài khoản | Menu tài khoản; chưa đăng nhập thì là nút Đăng nhập |
Thanh trên cùng còn có Khoá học, Khoá học của tôi, Đại sứ, liên kết về website và nút đổi ngôn ngữ.
3.2 Trang khoá học và ghi danh
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tên khoá học | Kèm giới thiệu, chính sách học |
| ② | Đề cương | Danh sách chương và bài học; bài có nhãn học thử mở được ngay |
| ③ | Nút ghi danh | Ghi danh miễn phí, Đăng ký học · giá, Bắt đầu học hoặc Tiếp tục học tuỳ trạng thái |
| ④ | Học thử | Xem bài học thử không cần ghi danh |
| ⑤ | Giảng viên | Thông tin người dạy |
Các bước ghi danh:
- Chưa đăng nhập: bấm Đăng nhập để ghi danh, đăng nhập rồi quay lại trang khoá học.
- Có mã giới thiệu từ đại sứ: nhập ở Mã giới thiệu (nếu có) (khoá có phí).
- Khoá miễn phí: bấm Ghi danh miễn phí — ghi danh ngay.
- Khoá có phí: bấm Đăng ký học · $…, thanh toán trên trang Stripe (phiên thanh toán giữ 30 phút). Thành công thì quay lại trang khoá học và nút chuyển thành Bắt đầu học.
3.3 Khoá học của tôi
- Danh sách khoá đã ghi danh (①) với tiến độ, nút Tiếp tục học, Xem lại (đã xong) và Tải chứng nhận khi hoàn thành khoá.
- Chưa ghi danh khoá nào: bấm Xem danh mục khoá học (②).
3.4 Học bài
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Chương | Mục lục theo chương; học viên đã ghi danh thấy thêm % hoàn thành |
| ② | Bài học | Bài đang mở được tô nền; vòng tròn chuyển thành dấu tích khi xong; ổ khoá là bài chưa mở (khoá học tuần tự); bên phải là thời lượng |
| ③ | Tên khoá học | Quay về trang khoá học |
| ④ | Thông báo quyền nhân viên | Chỉ nhân viên thấy: xem bài không cần ghi danh, tiến độ không được ghi nhận |
| ⑤ | Tiêu đề bài học | Bài đang học |
| ⑥ | Nội dung bài | Video hoặc bài đọc |
| ⑦⑧ | Bài trước / Bài tiếp theo | Chuyển bài |
| ⑨ | Tài liệu | Tệp đính kèm để Tải về; học viên còn có tab Ghi chú, Bản ghi lời, Trợ lý học tập |
Lưu ý khi học:
- Bài video được tính hoàn thành khi bạn xem hết ít nhất 90%. Mở lại bài sẽ tiếp tục từ vị trí đã xem ("Tiếp tục từ …"). Video có hình mờ email của bạn để chống chia sẻ.
- Bài đọc: đọc xong bấm Đánh dấu đã học.
- Tab Ghi chú (chỉ học viên đã ghi danh): Thêm ghi chú riêng cho từng bài.
- Tab Bản ghi lời: lời thoại video dạng văn bản (khi có).
- Tab Trợ lý học tập (khi bật AI): Tóm tắt, Phân tích, Hỏi đáp, Tự kiểm tra dựa trên nội dung bài.
3.5 Làm bài trắc nghiệm
- Mở bài trắc nghiệm (①) trong mục lục.
- Xem điều kiện: số câu hỏi và điểm đạt (②), số lần đã làm, giới hạn lượt, thời gian làm bài (③).
- Bấm Bắt đầu làm bài. Đang làm dở thì nút là Tiếp tục làm bài. Chưa ghi danh (hoặc đang xem bằng tài khoản nhân viên như trong ảnh) thì trang báo Ghi danh khoá học để làm bài trắc nghiệm (④) thay cho nút.
- Câu Chọn một đáp án chỉ chọn một; câu Chọn tất cả đáp án đúng chọn nhiều. Đồng hồ Còn … đếm ngược nếu bài có giới hạn thời gian; hết giờ bài tự nộp.
- Bấm Nộp bài. Kết quả: "Đạt! Bạn được …%" hoặc "Chưa đạt: …% (cần …%)" kèm Giải thích (nếu khoá học cho phép xem đáp án). Bấm Làm lại khi còn lượt.
- Bài kiểm tra cuối khoá xếp bạn vào trình độ nền tảng, trung cấp hoặc nâng cao.
3.6 Chứng nhận và xác minh
- Hoàn thành mọi bài (và đạt bài kiểm tra cuối) để nhận thông báo "Chúc mừng! Bạn đã hoàn thành khoá học." cùng email có mã xác minh.
- Tải PDF ở Khoá học của tôi → Tải chứng nhận, hoặc nút Tải chứng nhận (PDF) trong trình học.
- Người khác kiểm tra chứng nhận tại
/verify/<mã>(mã dạngBTD-XXXX-XXXX-XXXX).
Trang xác minh hiển thị Chứng nhận hợp lệ (người nhận, khoá học, ngày cấp, mã), Chứng nhận đã bị thu hồi (khi khoá học bị hoàn tiền) hoặc Không tìm thấy chứng nhận (①, mã sai như trong ảnh).
3.7 Chương trình đại sứ trong học viện
Menu Đại sứ: bấm Tham gia chương trình, nhập mã giới thiệu mong muốn (không bắt buộc), nhập Họ và tên người ký rồi Ký và tham gia. Sau khi được duyệt, bảng đại sứ hiện liên kết giới thiệu (nút Sao chép), lượt nhấp, đăng ký, hoa hồng và lịch Chi trả hằng tháng. Tải W-9 bằng nút Tải lên để nhận chi trả.
4. CMS: quản lý nội dung website
Dành cho vai trò admin và marketing. CMS (Payload) nằm tại /cms trên website, đăng nhập
bằng chính tài khoản Beyond The Deed — không có mật khẩu CMS riêng. Người bị bỏ quyền mất quyền vào
CMS trong vòng 30 giây.
4.1 Bảng điều khiển
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Cấu hình chung (globals) | Nội dung dùng toàn site: Đầu trang, Chân trang, Cài đặt website, Trắc nghiệm lộ trình, Giả định công cụ tính, Catalog khoá học |
| ② | Nội dung | Trang, Kiến thức & Podcast, Dịch vụ, Trang tiểu bang, Sách, Tài liệu miễn phí. Bên dưới: Thư viện (Câu hỏi thường gặp, Tác giả, Ảnh/tệp, Tệp tải về có điều kiện), Phân loại (Danh mục, Chủ đề), Hệ thống (Biên tập viên) |
| ③ | Thẻ bộ sưu tập | Bấm để mở danh sách bài |
| ④ | Nút + | Tạo nhanh một mục mới trong bộ sưu tập |
| ⑤ | Ngôn ngữ | Chọn ngôn ngữ nội dung đang sửa: Tiếng Việt (mặc định) hoặc English |
| ⑥ | Menu | Mở thanh điều hướng bên trái, nút Đăng xuất ở cuối |
4.2 Danh sách bài
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tạo mới | Tạo bài mới |
| ② | Tìm kiếm | Tìm theo tiêu đề |
| ③ | Hiển thị cột | Chọn cột hiển thị |
| ④ | Bộ lọc | Lọc theo trạng thái, loại, ngày… |
| ⑤ | Bảng | Cột Trạng thái (Bản nháp/Đã xuất bản) và Duyệt nội dung (Chờ duyệt/Đã duyệt). Bấm tiêu đề để sửa; tick ô đầu dòng để thao tác hàng loạt |
Nội dung mẫu lấy từ đặc tả được gắn Chờ duyệt. Đọc lại, sửa, rồi chọn Đã duyệt trước khi ra mắt. Văn bản pháp lý hiện nhãn "Bản nháp — chờ luật sư duyệt" cho tới khi được duyệt.
4.3 Soạn và xuất bản bài
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tiêu đề | Tên bài đang sửa |
| ② | Tab Bài viết | Nội dung, ảnh, danh mục, chủ đề, tác giả, ngày đăng |
| ③ | Tab SEO | Tiêu đề và mô tả khi chia sẻ/tìm kiếm; nút Tự động tạo |
| ④ | Ngôn ngữ | Chuyển giữa bản Tiếng Việt và English của cùng một bài |
| ⑤ | Danh sách phiên bản | Xem và khôi phục phiên bản cũ |
| ⑥ | Xem trước (biểu tượng con mắt) | Mở bản xem trực tiếp ở khổ điện thoại (390 px) và máy tính (1440 px) |
| ⑦ | Xuất bản tài liệu | Đưa bản hiện tại lên website ngay, không cần triển khai lại |
Các bước:
- Ở danh sách, bấm Tạo mới hoặc bấm tên bài cần sửa.
- Nhập tiêu đề và nội dung ở tab Bài viết (②). Đường dẫn (slug) tự sinh từ tiêu đề, sửa được.
- Chuyển Ngôn ngữ (④) sang English và nhập bản tiếng Anh. Bản tiếng Anh để trống sẽ không tự lấy nội dung tiếng Việt; trang tiếng Anh sẽ chưa hiển thị.
- Điền tab SEO (③).
- Lưu bản nháp bằng mũi tên cạnh Xuất bản tài liệu, hoặc Ctrl/⌘ + S. Bản nháp chỉ biên tập viên thấy. Dòng dưới tiêu đề cho biết Trạng thái, lần chỉnh sửa cuối và ngày tạo.
- Bấm Xem trước (⑥) để kiểm tra trên giao diện thật.
- Bấm Xuất bản tài liệu (⑦). Trang website cập nhật trong vài giây.
Quy định liên kết: chỉ nhận đường dẫn nội bộ bắt đầu bằng /, liên kết https://…, mailto: và
tel:. Các dạng khác bị từ chối khi lưu.
4.4 Việc thường gặp
| Việc | Vào đâu |
|---|---|
| Đổi menu trên cùng | Cấu hình chung → Đầu trang |
| Đổi chân trang, liên kết pháp lý | Cấu hình chung → Chân trang |
| Đổi email/điện thoại liên hệ, mạng xã hội, nội dung ô đồng ý | Cài đặt website (mục "Biểu mẫu & đồng ý"; tăng phiên bản khi đổi lời đồng ý) |
| Sửa câu hỏi, điểm, gợi ý trắc nghiệm lộ trình | Trắc nghiệm lộ trình |
| Sửa số mặc định của công cụ tính theo bang | Giả định công cụ tính |
| Thêm tài liệu cần email mới tải | Tải tệp lên Tệp tải về (có điều kiện), rồi tạo mục trong Tài liệu miễn phí trỏ tới tệp |
| Thêm câu hỏi thường gặp (trợ lý AI cũng dùng) | Câu hỏi thường gặp |
| Sửa khối "Hub 6 mảng" trang chủ | Sandy CRM → Trang chủ (6.8) |
| Đổi giá, chế độ, ngày giao sách đặt trước | Mở bài Sách, khung Sản phẩm đặt trước bên phải (admin) |
5. Sandy CRM: khách hàng và bán hàng
Dành cho kinh doanh (sales), marketing và quản trị viên (admin). Sales chỉ thấy khách mình phụ trách và khách chưa phân công; marketing và admin thấy mọi khách.
5.1 Bố cục màn hình
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Thanh điều hướng | Nhóm Công việc, Báo cáo, Trợ lý AI, Dữ liệu khách hàng, Email marketing, Kinh doanh & tài chính, Học viện, Quản trị. Chỉ hiện mục vai trò của bạn được dùng. Số đỏ cạnh Việc cần làm là số việc quá hạn |
| ② | Thu gọn/mở rộng | Ẩn thanh điều hướng để có thêm chỗ |
| ③ | Đường dẫn | Vị trí hiện tại; bấm để quay lại cấp trên |
| ④ | Phạm vi dữ liệu | "toàn bộ khách" (admin, marketing) hoặc "khách của tôi + chưa phân công" (sales) |
| ⑤ | Ngôn ngữ | VI/EN |
| ⑥ | Tài khoản | Tên, vai trò, đổi mật khẩu, đăng xuất |
5.2 Tổng quan
| Số | Chỉ số | Ý nghĩa |
|---|---|---|
| ① | Tổng khách hàng | Số khách trong phạm vi của bạn; bên cạnh là Khách mới tháng này |
| ② | Chưa có người phụ trách | Khách cần giao; bấm để mở danh sách |
| ③ | Quá hạn SLA 24 giờ | Lead website chưa được phản hồi đúng hạn — ưu tiên xử lý |
| ④ | Dự báo pipeline | Tổng giá trị × xác suất của các giao dịch đang mở |
| ⑤ | Doanh thu tháng theo mảng | Khoá học, Môi giới, Tư vấn/thẩm định, Quản lý tài sản, Sách, Đối tác doanh nghiệp |
| ⑥ | Đặt mục tiêu tháng | Mở cài đặt mục tiêu doanh thu |
Cuộn xuống để xem dự báo theo quy trình, khách theo kênh nguồn, theo nhóm, biểu đồ theo thời gian (chọn 7 ngày / 30 ngày / 90 ngày / Tùy chọn) và danh sách Khách nóng.
5.3 Danh sách khách hàng
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tất cả khách | Mọi khách trong phạm vi |
| ② | Chưa phân công | Khách chưa có người phụ trách; sales bấm Nhận khách trên dòng để nhận |
| ③ | Tìm kiếm | Theo mã BTD-…, tên, email, số điện thoại |
| ④ | Danh sách đã lưu | Áp nhanh một bộ lọc đã lưu |
| ⑤ | Hạn phản hồi | Lọc khách sắp/đã quá hạn SLA |
| ⑥ | Bộ lọc khác | Giai đoạn, nhóm, kênh, phân khúc, nguồn, bang, người phụ trách, thẻ. Bên cạnh là Sắp xếp |
| ⑦ | Lưu thành danh sách | Lưu bộ lọc hiện tại thành danh sách động |
| ⑧ | Xuất CSV | Chỉ admin; xuất theo bộ lọc hiện tại (được ghi nhật ký) |
| ⑨ | Thêm khách hàng | Tạo khách mới |
| ⑩ | Tên khách | Mở hồ sơ khách |
Mỗi dòng có nhãn giai đoạn (Khách tiềm năng, Cơ hội…), cảnh báo như Còn 23 giờ (SLA) hoặc Chưa xác minh nguồn tiền, và nút ⋯ để thao tác nhanh. Tick ô đầu dòng để gắn/bỏ thẻ hàng loạt.
5.4 Thêm khách hàng
- Bấm Thêm khách hàng (Hình 5.3 ⑨).
- Nhập Họ tên (①, bắt buộc).
- Nhập Email (②) và/hoặc Số điện thoại (③) — cần ít nhất một. Chọn quốc gia trước khi nhập số (mặc định Hoa Kỳ +1).
- Chọn Ngôn ngữ giao tiếp (④): Tiếng Việt hoặc English — email gửi khách dùng ngôn ngữ này.
- Chọn Phân khúc (⑤, bắt buộc): Nhà đầu tư, Người mua nhà, Học viên, Giới thiệu.
- Chọn Bang quan tâm (⑥, chọn nhiều) và Ngân sách (⑦ tối thiểu / tối đa, USD).
- Chọn Thời gian dự kiến mua (①), Giai đoạn hành trình (②: Học bài bản, Mua & đầu tư, Gìn giữ) và ghi Mục tiêu (③).
- Chọn Giai đoạn (④, mặc định Khách tiềm năng) và Nhóm khách (⑤: Mua nhà lần đầu, Nhà đầu tư mới, Nhà đầu tư có danh mục, Người ở Việt Nam…).
- Chọn Nguồn (⑥) và Người phụ trách (⑦). Sales tạo khách thì luôn là người phụ trách.
- Bấm nút lưu (⑧).
Email hoặc số điện thoại đã thuộc một khách khác: hệ thống báo trùng và cho biết ai đang phụ trách. Mở khách đó thay vì tạo mới, hoặc dùng Hồ sơ trùng để gộp (6.6).
5.5 Hồ sơ khách hàng
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tên khách | Kèm giai đoạn, phân khúc, nhóm, điểm, điện thoại, email (bấm để gọi/gửi) |
| ② | Mã khách | BTD-000001, không đổi |
| ③ | Gửi email | Soạn email (chọn mẫu, tự điền tên…); email được lưu vào dòng hoạt động |
| ④ | Mẫu SMS | Chép nhanh tin nhắn mẫu để gửi bằng điện thoại của bạn |
| ⑤ | Chỉnh sửa | Sửa thông tin khách |
| ⑥ | Xóa | Chỉ admin (xoá mềm) |
| ⑦ | Thông tin khách hàng | Người phụ trách, nhóm, nơi sống, kênh, nguồn, thời gian mua, ngân sách, bang, thẻ, mục tiêu… |
| ⑧ | Thêm hoạt động | Ghi chú, cuộc gọi, tư vấn… |
| ⑨ | Hoạt động | Dòng thời gian mọi tương tác, mới nhất ở trên |
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Vì sao có điểm này | Các yếu tố cộng/trừ điểm. Điểm đạt ngưỡng thì khách thành khách nóng và tự lên MQL |
| ② | Đã xác minh nguồn tiền | Admin bật khi đã kiểm tra nguồn tiền (bắt buộc với khách ở Việt Nam trước khi giao dịch bất động sản qua giai đoạn 1) |
| ③④ | Trợ lý AI | Tóm tắt khách, Soạn tin trả lời, Phân tích ghi chú (khi bật AI). AI chỉ soạn nháp, bạn bấm chấp nhận mới được lưu |
| ⑤ | Tạo giao dịch | Mở giao dịch mới cho khách; danh sách giao dịch hiện bên dưới |
| ⑥ | Tạo công việc | Việc cần làm gắn với khách |
| ⑦ | Ô hoàn thành | Tick để đánh dấu việc đã xong |
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Biểu mẫu đã gửi | Các biểu mẫu website khách đã điền (nội dung, trang nguồn, UTM) |
| ② | Ghi nhận đồng ý | Ghi đồng ý cho từng kênh (email, SMS, gọi) khi khách đồng ý bằng lời/văn bản |
| ③ | Ghi nhận từ chối | Khách yêu cầu ngừng liên lạc qua kênh đó |
| ④ | Lịch sử ghi nhận | Ai ghi, lúc nào, bằng chứng gì |
Chỉ gửi email marketing và SMS khi kênh đó có đồng ý. Gọi điện chỉ quay số thủ công.
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Email đã gửi | Email đã gửi cho khách, trạng thái mở/nhấp |
| ② | Tạo lịch hẹn | Đặt lịch tư vấn cho khách |
| ③ | Lịch hẹn | Lịch hẹn của khách; bấm để xem, dời, huỷ |
| ④⑤ | Môi giới | Admin chọn môi giới đối tác và bấm Giao cho môi giới |
Thêm hoạt động
- Bấm Thêm hoạt động (Hình 5.6 ⑧); hộp thoại (①) mở ra.
- Chọn Loại hoạt động (②): cuộc gọi, tin nhắn, buổi tư vấn, dẫn khách xem nhà, ghi chú…; chỉnh Thời gian nếu hoạt động đã diễn ra trước đó.
- Gắn Bất động sản liên quan (không bắt buộc) và chọn Dùng mẫu để điền sẵn nội dung.
- Nhập Nội dung (③, bắt buộc, tối đa 5.000 ký tự).
- Bấm Lưu hoạt động (④). Hoạt động đầu tiên với lead website được tính là phản hồi đầu tiên cho SLA.
5.6 Hộp thư lead
Mọi biểu mẫu website (liên hệ, trắc nghiệm, hỏi về căn nhà, trợ lý AI…) vào đây. Hạn phản hồi đầu tiên là 24 giờ (tính cả ngoài giờ làm việc).
| Số | Thành phần | Công dụng |
|---|---|---|
| ①②③ | Tab | Chưa xử lý, Tất cả, Đã xử lý |
| ④ | Lọc người phụ trách | Xem tin đã giao cho ai |
| ⑤ | Giao cho | Chọn nhân viên phụ trách tin này |
| ⑥ | Đã xử lý | Đánh dấu xong; ở tab Đã xử lý có Mở lại |
| ⑦ | Hồ sơ | Mở hồ sơ khách để liên hệ |
| ⑧ | SLA | Thời gian còn lại; đỏ khi quá hạn |
| ⑨ | Khách hàng | Tên và mã khách gửi tin |
Quy trình đề xuất: mở tin ở Chưa xử lý → Giao cho người phụ trách → người đó liên hệ khách và ghi hoạt động → bấm Đã xử lý. Admin nhận email tổng hợp tin quá hạn.
5.7 Quy trình bán hàng (pipeline)
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tab quy trình | Tuyển sinh khoá học, Giao dịch bất động sản, Thẩm định và tư vấn đầu tư, Đối tác và doanh nghiệp, Đầu tư cho thuê, Giới thiệu sang bang khác |
| ②③ | Bảng / Danh sách | Kanban theo giai đoạn hoặc bảng có cột (giao dịch thất bại chỉ thấy ở Danh sách) |
| ④ | Tìm giao dịch | Theo tên, mã hoặc khách |
| ⑤ | Người phụ trách | Lọc giao dịch của một người |
| ⑥ | Sửa giai đoạn | Admin đổi tên, xác suất các giai đoạn (nhãn "Cần duyệt" là tên mẫu chưa được duyệt) |
| ⑦ | Tạo giao dịch | Mở giao dịch mới |
| ⑧ | Tay kéo | Kéo thẻ sang cột khác để chuyển giai đoạn |
| ⑨ | Chuyển | Chuyển giai đoạn bằng hộp thoại (dùng khi không kéo được, hoặc trên điện thoại) |
Đầu mỗi cột là số giao dịch và tổng giá trị.
Tạo giao dịch
- Bấm Tạo giao dịch (Hình 5.12 ⑦); hộp thoại (①) mở ra.
- Chọn Quy trình (bắt buộc) và Giai đoạn (bỏ trống thì bắt đầu ở giai đoạn đầu tiên).
- Chọn Khách hàng và nhập Tên giao dịch (bắt buộc, ví dụ "Mua nhà ở Austin, TX").
- Nhập Giá trị (USD), Ngày dự kiến chốt, Người phụ trách, Ghi chú nếu có.
- Bấm Tạo (②). Thẻ mới hiện ở cột giai đoạn đã chọn.
Chi tiết giao dịch
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tên giao dịch | Kèm nút Xóa (admin) |
| ②③④ | Thông tin | Tên, giá trị (USD), người phụ trách; cùng ngày dự kiến chốt và ghi chú |
| ⑤ | Lưu thay đổi | Lưu phần thông tin |
| ⑥ | Chuyển đến… | Chọn giai đoạn mới |
| ⑦ | 7 mốc giao dịch | Tick từng mốc: thoả thuận đại diện người mua, thư tiền duyệt vay, bên bán chấp nhận, kiểm tra nhà, thẩm định giá, ngân hàng phê duyệt, ký đóng. Mỗi mốc ghi "Cần trước bước …" |
| ⑧ | Đánh dấu thất bại | Chọn lý do thất bại |
| ⑨ | Khách hàng | Mở hồ sơ khách |
Quy tắc khi chuyển giai đoạn (hệ thống chặn và báo lý do nếu chưa đủ):
- Giao dịch bất động sản chỉ admin hoặc sales có giấy phép được chuyển.
- Khách ở Việt Nam phải xác minh nguồn tiền trước khi qua giai đoạn 1.
- Mốc nào ghi "Cần trước bước X" phải được tick trước khi vào bước X.
- Đóng giao dịch phải nhập giá bán; hoa hồng tính = giá bán × tỷ lệ cấu hình (mặc định 2,5%).
- Khoá học ở giai đoạn đặt cọc phải nhập tiền cọc.
- Thất bại phải chọn lý do. Giao dịch đã đóng/thất bại có thể mở lại.
5.8 Việc cần làm
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Quá hạn | Việc trễ hạn (số cạnh tab) |
| ② | Hôm nay | Việc đến hạn hôm nay |
| ③ | Sắp tới | Việc các ngày sau |
| ④ | Đã xong | Việc hoàn thành; mở lại được |
| ⑤ | Người được giao | Admin xem việc của người khác |
| ⑥ | Tạo công việc | Tạo việc: tiêu đề, mô tả, hạn, nhắc lúc, ưu tiên, người được giao, khách/giao dịch |
| ⑦ | Hoàn thành | Tick để xong việc |
Hệ thống tự tạo một số việc, ví dụ "Gọi chào … trong 2 giờ" khi có khách mới. Việc có nhắc lúc sẽ được nhắc đúng thời điểm đó; số việc quá hạn hiện ở chấm đỏ cạnh menu Việc cần làm.
5.9 Lịch hẹn
| Số | Thành phần | Công dụng |
|---|---|---|
| ①②③ | Điều hướng tuần | Tuần trước, Hôm nay, tuần sau |
| ④⑤ | Tuần / Danh sách | Lịch theo ngày hoặc danh sách |
| ⑥ | Lọc | Theo loại hẹn, người tiếp, trạng thái |
| ⑦ | Lịch hẹn | Giờ, khách, loại buổi, trạng thái; bấm để mở |
| ⑧ | Tạo lịch hẹn | Đặt lịch cho khách (nhân viên không bị giới hạn giờ đặt trước như khách) |
| ⑨ | Cài đặt đặt lịch | Loại buổi, giờ làm việc (5.10) |
Dòng thông báo phía trên cho biết đã kết nối Google Calendar hay chưa. Chưa kết nối thì lịch dùng
giờ làm việc nội bộ và gửi tệp .ics qua email.
- Bấm vào lịch hẹn; khung chi tiết (①) mở bên phải với mã
BTD-A-…, trạng thái, khách (② — bấm để mở hồ sơ), thời gian, người tiếp, ghi chú. - Đổi giờ (③): chọn giờ mới; khách nhận email cập nhật kèm
.ics. - Hủy lịch (④): nhập lý do; khách nhận email huỷ kèm
cancel.ics. - Sau giờ hẹn: đánh dấu Hoàn thành hoặc Vắng mặt. Lịch đã huỷ/hoàn thành mà chưa diễn ra có thể Mở lại.
- Bấm Đóng (⑤).
Trạng thái: Chờ thanh toán → Đã xác nhận → Hoàn thành / Vắng mặt; hoặc Đã huỷ, Hết hạn (chưa thanh toán).
5.10 Cài đặt đặt lịch
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Loại buổi tư vấn | Danh sách buổi khách đặt được trên website |
| ② | Giờ làm việc | Giờ làm theo ngày, ngày nghỉ/ngoại lệ, múi giờ, lịch Google của từng người tư vấn |
| ③ | Thêm loại buổi | Admin: tên vi/en, thời lượng, phí, hình thức (Google Meet, điện thoại, gặp trực tiếp), người tư vấn, câu hỏi cho khách |
| ④ | Bảng | Tên, thời lượng, phí, hình thức, người tư vấn, trạng thái |
| ⑤ | Sửa | Sửa loại buổi; Xóa bên cạnh |
Buổi có phí cần cấu hình Stripe; chưa có thì website báo "chưa nhận đặt trực tuyến".
5.11 Bất động sản
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tìm | Theo mã, địa chỉ |
| ②③④ | Lọc | Loại hình, bang, khoảng giá; còn có trạng thái, phòng ngủ, loại deal, hiển thị |
| ⑤ | Nhập CSV | Nhập nhiều căn một lúc |
| ⑥ | Thêm bất động sản | Tạo tin mới |
| ⑦ | Mã tin | Mở chi tiết BTD-L-… |
| ⑧ | ⋯ | Sửa, ẩn/hiện trên website, xoá (admin) |
Chi tiết (①) gồm ảnh, giá niêm yết, phòng ngủ/tắm, diện tích, trạng thái, dữ liệu phân tích dòng tiền và trạng thái hiển thị trên website. Bấm Chỉnh sửa (②) để sửa. Vai trò kỹ thuật chỉ xem.
5.12 Báo cáo
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Phễu & nguồn | Báo cáo phễu |
| ② | Doanh thu | Doanh thu theo mảng |
| ③ | Mạng lưới đối tác | Khách giới thiệu qua đối tác |
| ④ | Khoảng thời gian | Tháng này, Quý này, Từ đầu năm |
| ⑤ | Từ ngày / Đến ngày | Khoảng tuỳ chọn |
| ⑥⑦⑧ | Lọc | Quy trình, người phụ trách, bang quan tâm |
| ⑨ | Gán nguồn theo | Lần chạm đầu hoặc lần chạm cuối (UTM) |
Hiệu suất người phụ trách (admin, sales): chọn kỳ (①), bảng (②) so sánh số khách, tỷ lệ phản hồi đúng SLA, giao dịch thắng, doanh thu của từng người.
8 chỉ số dự án (admin): chọn Tháng (①), Sửa mốc triển khai (②), bấm biểu tượng sửa ở mỗi thẻ để đặt mục tiêu (③). Chỉ số: khách tiềm năng mới, phản hồi trong hạn SLA, khách nóng được liên hệ trong 24 giờ, tỷ lệ thành khách hàng, doanh thu 6 mảng, đơn đặt trước sách, ghi danh học viện, người đăng ký email mới.
5.13 Trợ lý AI trong CRM
Hướng dẫn đầy đủ (thẻ hành động, agents, AI trong hồ sơ khách, cấu hình mô hình): Chức năng AI trong Sandy CRM.
Chỉ hiện khi hệ thống đã bật AI.
Việc nên làm hôm nay (①): khung Nên làm tiếp theo liệt kê khách cần liên hệ, lý do lấy từ dữ liệu CRM (việc quá hạn, hạn SLA, lead mới…) và hành động gợi ý; số bên phải là mức ưu tiên (đỏ là gấp nhất). Bấm vào khách để mở hồ sơ.
Trợ lý dữ liệu (①): gõ câu hỏi bằng tiếng Việt vào ô (②), ví dụ "Có bao nhiêu khách nóng ở Texas tuần này?". Trợ lý chỉ đọc dữ liệu trong phạm vi quyền của bạn.
Admin còn có Cảnh báo bất thường và Báo cáo tuần. Mọi gợi ý của AI phải được nhân viên duyệt trước khi ghi vào hồ sơ, công việc hay giai đoạn.
5.14 Các màn hình khác
Bàn giao cho thuê: lọc theo trạng thái (①); bảng (②) liệt kê khách, bất động sản, trạng thái hồ sơ và ngày đã gửi NTBS.
Yêu cầu VIP: lọc theo trạng thái (①); bảng (②) gồm người yêu cầu, lời nhắn, bang quan tâm, ngày gửi và nút quyết định duyệt/từ chối.
| Màn hình | Công dụng |
|---|---|
| Bàn giao cho thuê | Khi khách mua nhà để cho thuê: điền địa chỉ, tiền thuê, hợp đồng, checklist, tài liệu; gửi cho đơn vị quản lý (NTBS) |
| Yêu cầu VIP | Duyệt hoặc từ chối khách xin xem deal wholesale/off-market |
| Hành trình | Bản đồ các bước chăm sóc khách theo sản phẩm, vòng đời, đối tác (6.10) |
| Mẫu ghi chú & email | Mẫu dùng khi ghi hoạt động, gửi email, SMS |
6. Sandy CRM: marketing, đối tác, tài chính, quản trị
Các màn hình trong chương này dành cho marketing và quản trị viên; mục ghi "(admin)" chỉ quản trị viên thấy.
6.1 Chiến dịch email
Menu Email marketing → Chiến dịch.
| Số | Thành phần | Công dụng |
|---|---|---|
| ①②③④ | Tab | Chiến dịch, Bản tin tuần, Chuỗi email, Liên kết & nguồn |
| ⑤ | Lọc theo loại | Chiến dịch thường hoặc bản tin |
| ⑥ | Lọc theo trạng thái | Nháp, Đã hẹn giờ, Đang gửi, Đã gửi, Đã huỷ, Bỏ qua |
| ⑦ | Tạo chiến dịch | Tạo chiến dịch mới |
| ⑧ | Tên chiến dịch | Mở để soạn; cột bên phải là số đã gửi, tỷ lệ mở, nhấp |
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Lưu nháp | Lưu nội dung đang soạn |
| ② | Gửi thử | Gửi tới các liên hệ được đánh dấu "Liên hệ thử nghiệm" |
| ③ | Duyệt / Hẹn giờ | Bản tin cần Duyệt bản tin; chiến dịch thường chọn Hẹn giờ / gửi ngay |
| ④ | Huỷ chiến dịch | Huỷ (khi đã hẹn giờ là Huỷ lịch gửi) |
| ⑤ | Nội dung | Tên nội bộ, mã utm_campaign, tiêu đề, dòng xem trước, khối nội dung |
| ⑥ | Người nhận | Chọn đối tượng theo giai đoạn, phân khúc, chủ đề, bang, thẻ, danh sách động; xem ước tính số người nhận (vi/en) |
| ⑦ | Tiếng Việt / English | Mỗi chiến dịch cần cả hai bản; khách nhận theo ngôn ngữ giao tiếp |
| ⑧ | Thêm khối | Tiêu đề, văn bản, ảnh, nút, đường kẻ, thẻ |
| ⑨ | Đưa lên / xuống / Xoá khối | Sắp xếp khối |
Các bước:
- Tạo chiến dịch, đặt tên nội bộ và mã chiến dịch.
- Soạn tiêu đề, dòng xem trước và các khối cho Tiếng Việt, rồi English.
- Chọn Người nhận. Chỉ khách đã đồng ý nhận email mới được tính.
- Gửi thử và kiểm tra hộp thư.
- Hẹn giờ hoặc gửi ngay. Sau khi gửi, tab Hiệu quả hiện số gửi, mở, nhấp, huỷ đăng ký.
Mọi email marketing tự động có địa chỉ bưu chính công ty và liên kết huỷ đăng ký (luật CAN-SPAM).
6.2 Bản tin tuần
- Mỗi chủ đề (Đầu tư, Mua nhà để ở, Học bài bản) có một khung Lịch gửi theo chủ đề (①).
- Bật/tắt chủ đề (②), chọn Thứ gửi (③), Giờ gửi (④), Múi giờ (⑤). Mặc định thứ Năm 08:00 America/Chicago.
- Hệ thống gom bài mới thành bản nháp trước giờ gửi (mặc định 72 giờ). Bản nháp xuất hiện trong danh sách chiến dịch; cần Duyệt bản tin mới được gửi.
- Bấm Lưu lịch (⑥). Tạo bản nháp ngay (⑦) để tạo bản nháp không chờ lịch.
6.3 Chuỗi email
Chuỗi email (①) gửi tự động nhiều email cách nhau theo ngày, kích hoạt khi khách xác nhận bản tin, quét QR độc giả sách, tải tài liệu hoặc ghi danh khoá học. Bấm tên chuỗi để sửa các bước; trạng thái Nháp / Đang chạy / Tạm dừng. Bấm Tạo chuỗi (②) để tạo mới.
6.4 Liên kết & nguồn (UTM)
- Nhập Tên (①) và Đường dẫn đích (②, ví dụ
/vi). - Chọn kênh; nhập Nguồn (③, ví dụ facebook), kênh (medium), Chiến dịch (④), nội dung, từ khoá.
- Bấm Lưu liên kết (⑤), rồi Sao chép (⑥) để dán vào bài đăng/quảng cáo.
- Khách đến từ liên kết được ghi nguồn lần chạm đầu/cuối; xem ở Báo cáo → Phễu & nguồn.
6.5 Tự động hoá
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Email tự động | Email gửi theo sự kiện (xác nhận bản tin, ghi danh, đặt lịch…) |
| ② | Hộp thư đi | Mọi email đang chờ/đã gửi/lỗi, có thử lại tự động |
| ③ | Bảng | Sự kiện, độ trễ, mẫu, hành trình, trạng thái, số đã gửi, lần cuối |
| ④ | Chạy nhắc học phí 48 giờ | Chạy ngay việc nhắc khách còn nợ học phí |
6.6 Dữ liệu: nhập, trùng, danh sách động
Nhập dữ liệu (admin, marketing):
- Menu Nhập dữ liệu → Nhập tệp CSV (①). Trình nhập có 3 bước: Chọn tệp → Ghép cột → Xem trước.
- Chọn tệp (②): CSV mã UTF-8, dòng đầu là tiêu đề cột, phân cách bằng dấu phẩy hoặc chấm phẩy, tối đa 5.000 dòng và 2 MB. Bấm Tải tệp mẫu nếu cần khuôn.
- Ghép cột: hệ thống gợi ý theo tên cột; mỗi dòng cần họ tên và email hoặc số điện thoại. Cột không dùng để Không nhập.
- Chọn cách xử lý khi dòng trùng khách đã có (theo email/điện thoại): Bỏ qua (giữ nguyên), Cập nhật (ghi đè trường đã ghép, cộng thêm thẻ và bang) hoặc Gợi ý gộp (không đổi gì, đưa cặp nghi trùng sang trang Hồ sơ trùng).
- Xem trước rồi bắt đầu nhập. Trang kết quả ghi số Tạo, Cập nhật, Bỏ qua, Gợi ý, Lỗi và lý do từng dòng lỗi.
Khách hàng trùng lặp (①): hệ thống gợi ý các cặp có thể là cùng một người (cùng email, số điện thoại, hoặc tên gần giống cùng bang); Tín hiệu mạnh hiện trước Gợi ý yếu. Ảnh trên là trạng thái chưa có cặp nào.
- Gộp (admin, hoặc sales phụ trách cả hai khách): 3 bước Hồ sơ giữ lại → Chọn giá trị → Xác nhận. Hồ sơ giữ lại giữ mã khách; thẻ, bang quan tâm, chủ đề bản tin được cộng lại; hoạt động, giao dịch, việc chuyển sang hồ sơ giữ lại.
- Không phải trùng lặp: bỏ qua cặp đó, hệ thống không gợi ý lại.
Danh sách động: tạo từ trang Khách hàng bằng nút Lưu thành danh sách (Hình 5.3 ⑦). Danh sách tự cập nhật theo bộ lọc; dùng để lọc nhanh và chọn người nhận chiến dịch.
6.7 Đối tác, phí giới thiệu, đại sứ, chi trả, thuế (admin)
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Đối tác | Đơn đăng ký và đối tác đang hoạt động |
| ② | Chuyên gia dùng CRM | Đối tác dùng khu làm việc /workspace |
| ③ | Tìm đối tác | Theo tên, doanh nghiệp |
| ④⑤ | Lọc | Trạng thái, loại đối tác (và bang) |
| ⑥ | Chạy phân khách | Chia ngay khách chờ cho môi giới đối tác phù hợp |
Duyệt đơn: mở đối tác → xem thông tin, giấy phép, W-9 → chuyển Sàng lọc → Phỏng vấn → Duyệt (hoặc Từ chối). Môi giới bất động sản phải có giấy phép còn hạn. Đối tác đã duyệt có thể Tạm ngưng. Trong hồ sơ đối tác chỉnh hiển thị danh bạ công khai, nhận khách giới thiệu, thứ tự phân khách, ghi chú phí.
Phí giới thiệu: lọc theo Trạng thái (①) và Chiều (② vào/ra), bấm Ghi nhận phí (③): chọn đối tác, khách, chiều, ngày hoàn tất, giá bán, hoa hồng gốc và tỷ lệ (hoặc số tiền cố định). Chiều Nhận về (đối tác trả): Đã thỏa thuận → Đã gửi yêu cầu thanh toán → Đã thanh toán; chiều Chi ra (trả đối tác): Đã thanh toán; phí còn mở có thể Đã hủy hoặc Miễn phí. Cách tính: Phần trăm hoa hồng hoặc Số tiền cố định. Chỉ ghi phí cho môi giới có giấy phép (RESPA §8).
Đại sứ: tab Đại sứ (①) duyệt/tạm ngưng đại sứ, xem mã, lượt nhấp, đăng ký, doanh số, hoa hồng; tab Chương trình (②) chỉnh tỷ lệ hoa hồng (mặc định 10%) và thời hạn ghi nhận (30 ngày); tab Hoa hồng (③) xem từng khoản. Ô Tìm đại sứ (④). Hoa hồng chỉ tính trên khoá học/dịch vụ.
Chi trả đại sứ: chọn Kỳ (①), bấm Lập danh sách kỳ này (②) để gom hoa hồng đủ điều kiện; sau khi chuyển tiền bấm Đã chi trả và ghi mã giao dịch để đối soát; Xuất CSV (③) cho kế toán. Trạng thái: Chờ chi trả → Đã chi trả (hoặc Đã huỷ). Người chưa nộp W-9 được đánh dấu.
Thuế 1099-NEC: chọn Năm thuế (①) để xem tổng tiền trả mỗi người nhận (đại sứ + phí giới thiệu), trạng thái W-9; Xuất CSV (②) để lập tờ khai.
6.8 Nội dung trang chủ
- Chọn Ngôn ngữ nội dung (①).
- Mỗi mục của khối Hub 6 mảng có tên, đường dẫn, mô tả, liên kết. Ẩn (②) để tạm ẩn mục, Lên/Xuống (③) để đổi thứ tự.
- Xem trang chủ (④) để kiểm tra, rồi bấm Lưu (⑤). Nội dung được lưu vào CMS.
6.9 Người dùng và phân quyền
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tìm người dùng | Theo tên, email |
| ② | Lọc theo vai trò | Xem người theo từng vai trò |
| ③ | Thêm người dùng | Tạo tài khoản nhân viên/đối tác |
| ④ | ⋯ | Đổi vai trò, Vô hiệu hóa, Kích hoạt lại |
- Bấm Thêm người dùng.
- Nhập Email (①) và Họ tên (②); chọn ngôn ngữ, số điện thoại (không bắt buộc).
- Tick Vai trò (③): nhóm Nhân viên (④: Quản trị viên, Kinh doanh, Marketing, Kỹ thuật) hoặc Bên ngoài (⑤: Đối tác, Đại sứ, Học viên). Một người có thể giữ nhiều vai trò.
- Đặt Mật khẩu tạm (⑥, tối thiểu 8 ký tự) và gửi riêng cho người đó; nhắc họ đổi mật khẩu.
- Bấm Tạo tài khoản (⑦). Tài khoản do admin tạo được xác nhận email sẵn.
Đổi vai trò hoặc vô hiệu hoá có hiệu lực ngay ở request tiếp theo (CMS trong vòng 30 giây).
6.10 Cài đặt, mẫu, hành trình
| Số | Tab | Nội dung |
|---|---|---|
| ① | Doanh nghiệp | Tên hiển thị, tên miền, thương hiệu khoá học |
| ② | Chấm điểm & SLA | Điểm cho từng hành vi, ngưỡng khách nóng/MQL, hạn phản hồi |
| ③ | Lý do thất bại | Danh sách lý do khi đánh dấu giao dịch thất bại |
| ④ | Kết nối | Trạng thái Stripe, email, Google Calendar, AI… |
| ⑤ | Tuân thủ | Hai quy tắc hệ thống áp dụng: khách ở Việt Nam chưa xác minh nguồn tiền thì giao dịch bất động sản dừng ở "Chốt tiêu chí mua", tư vấn đầu tư dừng ở "Sàng lọc"; chỉ môi giới có giấy phép phụ trách giao dịch và nhận phí giới thiệu |
Các tab khác: Người dùng & vai trò, Đặt lịch, Phân tuyến realtor, Hoa hồng (tỷ lệ môi giới), Mục tiêu tháng, Import CSV.
Mẫu nội dung: tab Ghi chú cuộc gọi (①), Ghi chú tư vấn, Email (②), SMS (③). Bấm Tạo mẫu (④); mẫu có biến tự điền như tên khách. Dùng khi thêm hoạt động, gửi email, chép SMS.
Hành trình: tab 5a · Theo sản phẩm (①), 5b · Vòng đời (②), 5c · Đối tác (③). Mỗi bảng (④) liệt kê bước, mục tiêu, kênh, người phụ trách, tự động hoá CRM tương ứng và hạn.
6.11 Học viện, sản phẩm, doanh thu
Khoá học (admin, marketing): lọc trạng thái (①), Tạo khoá học (②), bấm tên khoá (③) để soạn.
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tên khoá học | Kèm trạng thái, đường dẫn, số học viên |
| ② | Thông tin | Tên vi/en, mô tả, chính sách, cấp độ, lộ trình (bước 1–7 hoặc bổ trợ), học phí, giảng viên, ảnh bìa, học tuần tự, cấp chứng nhận, đặt cọc |
| ③ | Nội dung | Chương và bài học |
| ④ | Xuất bản | Danh sách việc còn thiếu (chưa có bài, thiếu video, thiếu thời lượng, thiếu trắc nghiệm) và nút xuất bản/lưu trữ |
| ⑤ | Xem trên Học viện | Mở trang khoá học công khai |
| ⑥ | Chương | Mũi tên để sắp xếp, bút để đổi tên, thùng rác để xoá chương trống; Thêm bài học ở cuối chương |
| ⑦ | Bài học | Loại (bài đọc, video, trắc nghiệm), thời lượng, nhãn Học thử. Bấm Soạn bài để sửa: video (tải lên hoặc Cloudflare Stream), nội dung, tệp đính kèm, câu hỏi trắc nghiệm |
| ⑧ | Thêm chương | Tạo chương mới |
Khoá đã có học viên không thể trở lại nháp; chỉ khoá nháp chưa có học viên mới xoá được.
Ghi danh học viện: tab Ghi danh (①), Theo khoá học (②: tỷ lệ hoàn thành, trình độ, doanh thu), Đơn hàng (③: hoàn tiền — admin). Tìm học viên (④), lọc tiến độ (⑤).
Sản phẩm & lớp học (①): bảng giá, phiếu CRM, tiền cọc, ngày khai giảng của khoá học, lớp, dịch vụ.
Đặt trước sách: tìm đơn (①), lọc trạng thái (②), mã sản phẩm (③), khoảng ngày đặt (④), Xuất CSV (⑤) danh sách giao hàng.
Doanh thu (admin): chọn kỳ (①), xem doanh thu 6 mảng; Thêm khoản (②) để ghi doanh thu ngoài hệ thống (ví dụ hoa hồng môi giới đã nhận), lọc theo dòng (③).
6.12 Khu làm việc của đối tác
Tài khoản chỉ có vai trò đối tác đăng nhập bằng mã email và chỉ thấy khu /workspace:
| Mục | Công dụng |
|---|---|
| Trang chủ | Khách mới được giao, việc đến hạn |
| Khách tiềm năng, Hồ sơ/giao dịch | Pipeline riêng; cập nhật giai đoạn, checklist, ghi chú (ghi chú đầu tiên tính là phản hồi) |
| Danh bạ | Khách của riêng đối tác |
| Nhắc việc, Lịch hẹn | Việc và lịch của đối tác |
| Mạng lưới | Chia sẻ khách với Beyond The Deed hoặc giới thiệu sang đối tác khác (cần đồng ý của khách) |
| Báo cáo, Hiệu suất của tôi | Kết quả của đối tác |
| Trợ lý AI | Chỉ đọc dữ liệu của chính đối tác |
| Nhập và xuất dữ liệu, Hồ sơ và quyền riêng tư | Quản lý dữ liệu và hồ sơ công khai |
Dữ liệu mỗi đối tác được tách riêng; đối tác không thấy khách của người khác.
Hướng dẫn sử dụng — Beyond The Deed Hub
Tài liệu hướng dẫn từng bước cho mọi người dùng nền tảng Beyond The Deed: khách truy cập website, học viên, biên tập viên nội dung và nhân viên dùng Sandy CRM. Yêu cầu chi tiết của hệ thống nằm trong Đặc tả yêu cầu phần mềm (SRS).
Ảnh chụp từ môi trường staging ngày 18/11/2026, giao diện tiếng Việt, màn hình 1440 × 900. Dữ liệu khách hàng trong ảnh là dữ liệu minh hoạ (email
@example.com, thẻdemo), không phải khách thật.
Cách đọc ảnh
Mỗi ảnh có các khung đỏ đánh số ①②③… đặt đúng lên nút, ô nhập hoặc vùng cần chú ý. Danh sách ngay dưới ảnh giải thích từng số theo cùng thứ tự. Các bước thao tác được đánh số 1, 2, 3… và nhắc lại số trên ảnh trong ngoặc, ví dụ "bấm Thêm khách hàng (⑨)".
Địa chỉ truy cập
| Ứng dụng | Production | Staging |
|---|---|---|
| Website | https://beyondthedeedhub.com |
https://beyond-the-deed.portpairguide.app |
| CMS | https://beyondthedeedhub.com/cms |
https://beyond-the-deed.portpairguide.app/cms |
| Học viện | https://academy.beyondthedeedhub.com |
https://academy.beyond-the-deed.portpairguide.app |
| Sandy CRM | https://crm.beyondthedeedhub.com |
https://crm.beyond-the-deed.portpairguide.app |
Một tài khoản đăng nhập được tất cả ứng dụng. Đăng nhập ở một nơi là đã đăng nhập ở các nơi còn lại.
Mục lục
| Chương | Dành cho |
|---|---|
| 1. Tài khoản: đăng ký, đăng nhập, mật khẩu | Mọi người |
| 2. Website: tìm hiểu, công cụ, đặt lịch, đăng ký | Khách truy cập |
| 3. Học viện: ghi danh, học bài, trắc nghiệm, chứng nhận | Học viên |
| 4. CMS: quản lý nội dung website | Biên tập viên (admin, marketing) |
| 5. Sandy CRM: khách hàng và bán hàng | Kinh doanh, marketing, admin |
| 6. Sandy CRM: marketing, đối tác, tài chính, quản trị | Marketing, admin |
| Chức năng AI trong Sandy CRM (tài liệu riêng) | Kinh doanh, marketing, admin |
Vai trò và những gì bạn thấy
| Vai trò | Thấy gì |
|---|---|
| Học viên | Website, Học viện, trang Tài khoản |
| Đại sứ | Thêm bảng theo dõi đại sứ |
| Đối tác | Khu làm việc riêng trong CRM (/workspace), chỉ khách được giao |
| Kinh doanh | CRM: khách của mình và khách chưa phân công, hộp thư lead, pipeline, việc, lịch hẹn, báo cáo |
| Marketing | CRM: mọi khách, email marketing, tự động hoá, nhập dữ liệu, khoá học; CMS |
| Quản trị viên | Toàn bộ, thêm người dùng, đối tác, phí giới thiệu, đại sứ, chi trả, thuế, KPI |
| Kỹ thuật | Chỉ xem danh sách bất động sản, không thấy dữ liệu khách |
Menu chỉ hiện chức năng bạn được dùng. Nếu cần thêm quyền, liên hệ quản trị viên (xem 6.9 Người dùng).
Hỗ trợ
Chức năng AI trong Sandy CRM
| Mục | Nội dung |
|---|---|
| Phạm vi | Mọi chức năng AI trong Sandy CRM: trợ lý dữ liệu, thẻ hành động, agents, AI trong hồ sơ khách, cảnh báo, báo cáo tuần, cấu hình mô hình |
| Phiên bản | 1.1 — 18/11/2026, mã nguồn main sau bản sửa rà soát AI (ngôn ngữ lý do, không lưu trích dẫn, người nhận báo cáo tuần, nhà cung cấp AI) |
| Người đọc | Nhân viên kinh doanh, marketing, quản trị viên; đội vận hành |
| Liên quan | SRS §3.9, Hướng dẫn sử dụng, api-contract.md §17 |
Ảnh chụp trên staging ngày 18/11/2026, AI đang bật (nhà cung cấp Anthropic). Khách hàng trong ảnh là dữ liệu minh hoạ (
@example.com) đã xoá sau khi chụp. Số đỏ trên ảnh khớp với số trong bảng bên dưới.
1. Nguyên tắc chung
- AI chỉ soạn nháp và đề xuất. AI không tự gửi email, không tự chuyển giai đoạn, không tự giao
việc hay sửa hồ sơ. Một gợi ý chỉ thành dữ liệu khi nhân viên bấm chấp nhận, dưới tên của nhân viên
đó. Ghi chú do AI soạn mà được duyệt sẽ bắt đầu bằng
[AI · đã được nhân viên duyệt]. - AI chỉ đọc dữ liệu bạn được phép xem. Trợ lý gọi công cụ bằng chính quyền của người đang đăng nhập: sales chỉ thấy khách mình và khách chưa phân công; marketing thấy mọi khách nhưng không thấy doanh thu; admin thấy tất cả.
- Có nguồn để kiểm tra. Mỗi kết quả kèm "Nguồn" hoặc "Số liệu trích dẫn" dẫn về danh sách gốc. Điểm theo quy tắc của CRM vẫn là điểm chính thức; tín hiệu AI chỉ để tham khảo.
- Tôn trọng quyền riêng tư và Fair Housing. Không đưa đặc điểm được pháp luật bảo vệ vào AI. Tên, email, điện thoại, địa chỉ trong biểu mẫu bị lọc trước khi gửi cho mô hình (xem §10).
- Không có khoá AI vẫn chạy. Khi máy chủ chưa có khoá, CRM chuyển sang chế độ quy tắc: trợ lý và agents vẫn trả lời và soạn nháp theo quy tắc cố định; các tính năng cần mô hình bị ẩn hoặc báo "Tính năng AI chưa được cấu hình".
Tổng quan chức năng
| Chức năng | Nơi dùng | Ai dùng | Cần khoá AI |
|---|---|---|---|
| Việc nên làm hôm nay | Menu Trợ lý AI → Việc nên làm hôm nay | admin, sales, marketing | Phần "Nên làm tiếp theo" không cần; danh sách AI cần |
| Trợ lý dữ liệu (hỏi đáp) | Trợ lý AI → Trợ lý dữ liệu | admin, sales, marketing | Không (chế độ quy tắc khi thiếu khoá) |
| Thẻ hành động | Trong câu trả lời của trợ lý | Theo quyền của từng chức năng | Không |
| Hộp duyệt tin, AI agents | Trang Trợ lý dữ liệu | admin, sales, marketing | Không |
| AI trong hồ sơ khách | Hồ sơ khách, khung Trợ lý AI | admin, sales, marketing (trong phạm vi khách) | Có |
| Trợ lý cho khách này | Hồ sơ khách | admin, sales, marketing | Không |
| Cảnh báo bất thường | Trợ lý AI → Cảnh báo bất thường | admin, sales, marketing | Có |
| Báo cáo tuần | Trợ lý AI → Báo cáo tuần | admin | Có |
| Cá nhân hoá bản tin | Màn soạn chiến dịch bản tin | admin, marketing | Có |
| Đọc hồ sơ đối tác | Hồ sơ đối tác | admin | Có |
| AI soạn trắc nghiệm, phụ đề | Soạn bài học | admin, marketing | Có |
| Trợ lý của đối tác | Khu làm việc /workspace/ai |
đối tác | Không |
| Mô hình AI | Cài đặt CRM → Mô hình AI | admin | Có |
2. Việc nên làm hôm nay
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tiêu đề trang | Danh sách khách cần liên hệ hôm nay |
| ② | Làm mới danh sách | Yêu cầu AI viết lại danh sách (tốn hạn mức AI) |
| ③ | Nên làm tiếp theo | Xếp hạng theo quy tắc, không cần AI: lead sắp/đã quá hạn phản hồi, khách nóng chưa được chạm, việc quá hạn hoặc đến hạn hôm nay, giao dịch đứng yên 14 ngày |
| ④ | Tên khách | Mở hồ sơ khách |
| ⑤ | Điểm ưu tiên | Từ 60 trở lên là nóng, 35–59 là ấm, dưới 35 là nguội |
Bên dưới (cuộn xuống) là danh sách do AI viết: một câu mở đầu và tối đa 15 thẻ khách, mỗi thẻ có mã khách, nhãn lý do (ví dụ "Việc quá hạn", "Việc đến hạn hôm nay"), hạn, Gợi ý hành động do AI viết và nút Mở hồ sơ. Danh sách chỉ đọc: AI không tự làm gì.
Mỗi sáng lúc 07:00 (AI_DAILY_LIST_HOUR), hệ thống gửi email danh sách này cho người dùng chưa xem
trong ngày; ngày không có việc thì không gửi.
3. Trợ lý dữ liệu
3.1 Màn hình
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Thông báo AI | Nhắc kiểm tra nội dung trước khi dùng |
| ② | Câu hỏi gợi ý | Bấm để hỏi nhanh: "Hôm nay tôi nên gọi ai trước?", "Khách nào đã đặt cọc nhưng chưa đóng giao dịch?", "Có bao nhiêu khách nóng chưa được giao?", "Tuần này có bao nhiêu khách mới theo nguồn?" |
| ③ | Ô hỏi | Hỏi bằng tiếng Việt hoặc tiếng Anh, tối đa 4.000 ký tự |
| ④ | Đính kèm tệp | Tối đa 5 tệp văn bản, mỗi tệp ≤ 20 MB. Chỉ tên tệp được gửi cho AI, nội dung tệp ở lại trình duyệt |
| ⑤ | Hỏi | Gửi câu hỏi; khi đang trả lời có nút Dừng |
| ⑥ | Hộp duyệt tin của tôi | Bản nháp tin nhắn từ trợ lý và agents chờ bạn duyệt (§5) |
| ⑦ | AI agents | 4 agent tự động soạn nháp và đặt việc |
| ⑧ | Bật/tắt agent | Bật hoặc tắt từng agent |
| ⑨ | Chạy ngay | Chạy agent ngay, không chờ lịch |
| ⑩ | Nguyên tắc AI trong CRM | Tóm tắt các nguyên tắc ở §1 |
3.2 Hỏi đáp
- Gõ câu hỏi vào ô (③) rồi bấm Hỏi. Câu hỏi của bạn hiện bên phải (①).
- Trợ lý tra dữ liệu (tối đa 5 lượt tra cứu cho một câu) và trả lời bên trái, ví dụ danh sách khách nên gọi theo thứ tự ưu tiên (②) kèm lý do.
- Bên dưới câu trả lời có Số liệu trích dẫn: bấm để mở đúng danh sách đã dùng (ví dụ "Danh sách khách hàng: 1").
- Hỏi tiếp ở ô (③) — trợ lý nhớ 10 lượt gần nhất trong trang. Tải lại trang thì cuộc trò chuyện mất; máy chủ không lưu hội thoại.
Trợ lý tra được: quy trình bán hàng, khách hàng, giao dịch, việc, khách mới theo thời gian, doanh thu (chỉ admin), chi tiết khách, ưu tiên hôm nay, tổng quan pipeline, hạn chót, khách nguội, lịch hẹn sắp tới, hộp thư lead (admin, sales).
Thông báo có thể gặp:
| Thông báo | Ý nghĩa |
|---|---|
| (Đã dừng sau nhiều bước tra cứu; hãy hỏi cụ thể hơn.) | Câu hỏi cần quá 5 lượt tra cứu |
| Bạn đã dùng hết hạn mức AI hôm nay… | Hết 200.000 token trong ngày của bạn; trợ lý chuyển sang trả lời theo quy tắc |
| Chế độ quy tắc: câu trả lời lấy từ dữ liệu của bạn theo quy tắc cố định… | Máy chủ chưa có khoá AI |
| Trợ lý gặp lỗi | Lỗi kết nối nhà cung cấp AI; thử lại sau |
4. Thẻ hành động
Trợ lý có thể chuẩn bị thao tác cho hầu hết chức năng bạn được dùng trong CRM: tạo việc, chuyển giai đoạn, ghi hoạt động, đặt lịch hẹn, soạn chiến dịch… Thao tác hiện thành thẻ. Không có gì được lưu, gửi hay xoá cho tới khi bạn xác nhận thẻ.
4.1 Thẻ thường
- Yêu cầu bằng lời thường (①), ví dụ "Tạo việc gọi lại cho Nguyễn Minh Anh lúc 10 giờ sáng mai".
- Trợ lý tìm đúng khách, giải thích bối cảnh (giai đoạn, mục tiêu, lưu ý về đồng ý liên lạc) và hiện thẻ Đề xuất việc (②) với tên khách, nội dung và hạn.
- Kiểm tra thẻ. Các trường trên thẻ sửa được trước khi xác nhận.
- Bấm nút trên thẻ (③, ví dụ Tạo việc). Thẻ chuyển sang Đã thực hiện và việc xuất hiện trong Việc cần làm.
- Số liệu trích dẫn (④) cho biết trợ lý đã dựa vào danh sách nào.
4.2 Mức rủi ro và xác nhận hai bước
Mỗi thẻ có nhãn rủi ro:
| Nhãn | Ví dụ | Cách xác nhận |
|---|---|---|
| Thay đổi thường | Tạo việc, ghi hoạt động, tạo giao dịch | Một lần bấm |
| Cần chú ý | Chuyển giai đoạn, đánh dấu thất bại, ghi nhận đồng ý, đổi cài đặt | Một lần bấm, thẻ hiện mục Hậu quả |
| Không hoàn tác được | Xoá, gửi email, gộp hồ sơ, gắn thẻ hàng loạt, hoàn tiền, xuất dữ liệu | Hộp thoại, gõ XAC NHAN |
Thẻ được đề xuất sau khi AI đọc dữ liệu đã lưu (ghi chú, tin nhắn, tài liệu, tên tệp) luôn cần xác nhận hai bước, kể cả thao tác thường, để chặn trường hợp một đoạn văn bản trong dữ liệu "ra lệnh" cho AI.
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Không hoàn tác được | Nhãn rủi ro; dòng bên dưới cảnh báo thẻ được đề xuất sau khi AI đọc dữ liệu đã lưu |
| ② | Hậu quả | Điều sẽ xảy ra, ví dụ "Bản ghi bị xoá vĩnh viễn; không hoàn tác được." Mục Chi tiết kỹ thuật cho biết lệnh sẽ gọi |
| ③ | Xác nhận | Mở hộp thoại xác nhận hai bước |
- Hộp thoại Xác nhận thao tác (①) nhắc lại hậu quả và nội dung thao tác.
- Gõ đúng
XAC NHANvào ô (②). Nút Xác nhận (③) chỉ bật khi gõ đúng. - Bấm Xác nhận để thực hiện, hoặc Huỷ (④) để bỏ.
4.3 Các trường hợp đặc biệt
| Thông báo trên thẻ | Ý nghĩa và cách xử lý |
|---|---|
| Thẻ đã hết hạn, hãy yêu cầu AI tạo lại. | Thẻ có hiệu lực 15 phút (AI_CHAT_CARD_TTL) |
| Dữ liệu đã thay đổi từ lúc AI đề xuất… | Bản ghi đã bị ai đó sửa; xem lại rồi yêu cầu thẻ mới |
| Thẻ không hợp lệ, hãy yêu cầu AI tạo lại. | Thẻ sai cấu trúc |
| Không rõ kết quả… Đừng xác nhận lại | Mất kết nối khi đang thực hiện. Thẻ bị khoá, không tự thử lại; kiểm tra dữ liệu thủ công |
Mọi thao tác qua thẻ đi qua đúng API và kiểm tra quyền như khi bạn bấm trên màn hình, và được ghi nhật ký kiểm toán kèm dấu "chat". Một câu trả lời có tối đa 10 thẻ.
4.4 Nhóm thao tác trợ lý đề xuất được
Danh mục đầy đủ (348 thao tác: 142 đọc, 206 ghi) nằm trong
apps/crm/src/features/chat-actions/registry.generated.json. Tóm tắt nhóm ghi của nhân viên:
| Nhóm | Thao tác (ví dụ) |
|---|---|
| Khách hàng | Tạo, sửa, ghi hoạt động, ghi nhận đồng ý, gửi email, gộp, gắn thẻ hàng loạt, giao/thu hồi môi giới (admin), xác minh nguồn tiền (admin), xoá và xuất (admin) |
| Giao dịch, việc | Tạo, sửa, chuyển giai đoạn, mốc, thất bại, mở lại, xoá |
| Lịch hẹn | Tạo, dời, huỷ, kết quả, mở lại, giờ làm việc, loại buổi |
| Marketing | Chiến dịch (tạo, sửa, xem trước, gửi thử, duyệt, hẹn giờ, huỷ, xoá), chuỗi email, liên kết UTM, lịch bản tin |
| Học viện | Khoá học, chương, bài, trắc nghiệm, đợt học, hoàn tiền đơn (admin) |
| Bất động sản | Tạo, sửa, ảnh, nhà mở cửa, nhập CSV, xoá |
| Đối tác, đại sứ, tài chính (admin) | Trạng thái đối tác, phân khách, phí giới thiệu, chương trình đại sứ, chi trả, 1099, doanh thu |
| Cài đặt (admin) | Cài đặt CRM, danh sách lựa chọn, phân tuyến, chấm điểm, mô hình AI |
| AI | Chạy agent, tóm tắt khách, soạn nháp, quyết định bản nháp, chạy cảnh báo, báo cáo tuần |
61 thao tác bị loại khỏi trợ lý có chủ đích (ví dụ đăng nhập, mật khẩu, webhook, tải tệp nhạy cảm).
Admin có thể tắt thêm từng thao tác bằng AI_CHAT_DISABLED_ACTIONS hoặc tắt toàn bộ thẻ bằng
AI_CHAT_ACTIONS=false.
5. Hộp duyệt tin và AI agents
Hộp duyệt tin của tôi (①) chứa bản nháp do trợ lý và agents soạn cho khách bạn phụ trách (admin thấy thêm bản nháp của khách chưa phân công). Mỗi bản nháp ghi tên khách, kênh (Email/SMS), nguồn ("Từ agent") và thời điểm.
| Số | Thành phần | Công dụng |
|---|---|---|
| ② | Duyệt và gửi | Gửi email qua đường gửi marketing (kiểm tra đồng ý và danh sách chặn) và đóng bản nháp |
| ③ | Sửa | Sửa tiêu đề, nội dung rồi Lưu |
| ④ | Bỏ | Bỏ bản nháp |
| ⑤ | Khách chưa đồng ý nhận tin này | Khách chưa có đồng ý email marketing, nên nút Duyệt và gửi bị khoá. Ghi nhận đồng ý trong hồ sơ khách trước |
| ⑥ | Chạy ngay | Chạy agent (ở đây là Agent chuẩn bị lịch hẹn) |
Bản nháp SMS không gửi từ CRM: bạn tự gửi bằng điện thoại rồi bấm Đã gửi tay để ghi lại. Chọn nhiều bản nháp rồi bấm Gửi các thư đã chọn để gửi hàng loạt.
Bốn agent (chỉ soạn nháp và đặt việc, mỗi khách chỉ được xử lý một lần mỗi ngày):
| Agent | Lịch | Việc làm |
|---|---|---|
| Agent chăm sóc khách nguội | Thứ Hai 08:00 | Soạn tối đa 5 tin hỏi thăm cho khách lâu chưa liên hệ (từ 21 ngày) |
| Agent tiếp nhận khách mới | Khi có khách mới | Soạn tin chào (tối đa 10) và đặt việc "Gọi chào … trong 2 giờ" |
| Agent chuẩn bị lịch hẹn | Hằng ngày 18:00 | Đặt việc chuẩn bị và soạn tin nhắc cho lịch hẹn hôm nay và ngày mai (tối đa 10) |
| Agent rà soát pipeline | Thứ Sáu 17:00 | Đặt bước tiếp theo cho giao dịch đứng yên từ 14 ngày (tối đa 6) |
Khi có khoá AI, mỗi lần chạy AI viết tối đa 5 bản nháp và chỉ khi còn hạn mức. Đang chạy mà bấm lại sẽ báo "Agent đang chạy". Dưới mỗi agent có lịch, lần chạy gần nhất và số lần chạy.
6. AI trong hồ sơ khách
Mở hồ sơ khách, cuộn tới khung Trợ lý AI (nhãn AI). Chỉ dùng được với khách trong phạm vi của bạn.
6.1 Mức sẵn sàng
| Số | Thành phần | Công dụng |
|---|---|---|
| ①–④ | Bốn tab | Mức sẵn sàng, Trước cuộc gọi, Soạn trả lời, Tóm tắt tư vấn |
| ⑤ | Điểm theo quy tắc (chính thức) | Điểm CRM tính theo quy tắc; quyết định khách nóng và thứ tự ưu tiên |
| ⑥ | Tín hiệu sẵn sàng từ AI | AI chỉ đọc lời khách viết trong biểu mẫu và mục tiêu đã nêu, không đọc thông tin định danh hay đặc điểm được bảo vệ |
| ⑦ | Phân tích bằng AI / Tạo lại | Chạy phân tích (mô hình nhanh). Dữ liệu chưa đổi thì dùng lại kết quả cũ, không tốn hạn mức |
| ⑧ | Mức và độ tin cậy | Điểm 0–100, mức (thấp, trung bình, cao), độ tin cậy |
| ⑨⑩ | Lý do Tăng / Giảm | Lý do viết theo ngôn ngữ giao diện (tiếng Việt hoặc tiếng Anh); mỗi lý do kèm trích dẫn đúng lời khách. Đổi ngôn ngữ giao diện rồi bấm Tạo lại để có bản theo ngôn ngữ mới |
Tín hiệu AI không thay thế và không ghi đè điểm chính thức, cũng không lưu thành dữ liệu khách.
6.2 Trước cuộc gọi
- Mở tab Trước cuộc gọi (①), bấm Tạo tóm tắt.
- AI đọc hồ sơ, biểu mẫu, 40 hoạt động gần nhất, giao dịch và việc đang mở, rồi viết: Tóm tắt, Nhu cầu chính (⑤), 3 câu hỏi nên hỏi (⑥) và Nguồn (⑦) đã dùng.
- Chuyển Tiếng Việt (②) / English (③) để xem bản tiếng Anh. Tạo lại (④) để viết lại.
- Bấm Lưu vào dòng thời gian (cuối khung) để lưu thành ghi chú, hoặc bỏ qua.
6.3 Soạn trả lời
- Mở tab Soạn trả lời (①), chọn kênh Email (②) hoặc Tin nhắn SMS (③).
- Dán Tin nhắn của khách cần trả lời (④, không bắt buộc, ≤ 5.000 ký tự) và Ghi chú cho AI (⑤, ví dụ "nhắc lịch hẹn thứ Năm", ≤ 1.000 ký tự).
- Bấm Soạn nháp song ngữ (⑥). AI viết bản tiếng Việt và tiếng Anh.
- Email: sửa nội dung, bấm Gửi email. Email đi qua đường gửi 1:1 thông thường với mục đích "trả lời", nên chỉ gửi được khi khách đã từng gửi yêu cầu. SMS: tự gửi bằng điện thoại rồi bấm Tôi đã gửi tin này để ghi lại. AI không bao giờ tự gửi.
6.4 Tóm tắt buổi tư vấn
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tóm tắt tư vấn | Tab tóm tắt bản ghi buổi tư vấn (Zoom, Google Meet, điện thoại, gặp trực tiếp) |
| ② | Bản ghi | Dán nội dung bản ghi, 50 đến 200.000 ký tự |
| ③ | Ghi chú lưu trữ | Bản ghi gốc không được lưu, chỉ lưu mã băm và bằng chứng đồng ý |
| ④ | Nền tảng | Nơi diễn ra buổi tư vấn |
| ⑤ | Bang của khách | Một số bang yêu cầu mọi bên đồng ý ghi âm |
| ⑥ | Cách khách đồng ý ghi âm | Bằng lời ngay trong bản ghi, bằng văn bản, hoặc thông báo ghi âm của nền tảng; kèm ghi chú |
| ⑦ | Xác nhận đồng ý | Bắt buộc tick; thiếu thì báo "Bắt buộc xác nhận sự đồng ý" |
| ⑧ | Tạo tóm tắt | Gửi cho AI |
Kết quả gồm tóm tắt, ý chính, danh sách việc cần làm (hạn 0–30 ngày, chọn được từng việc), gợi ý chuyển giai đoạn (chỉ áp dụng khi bạn chọn). Bấm Lưu tóm tắt và tạo việc đã chọn để lưu một hoạt động "tư vấn" và tạo các việc giao cho bạn.
Lưu ý về lưu trữ: AI diễn đạt lại bằng lời của mình và không chép nguyên văn đoạn nào của bản ghi, nên kết quả được lưu không chứa câu trích từ bản ghi. Đúng với dòng chữ "Bản ghi không được lưu lại" trên màn hình.
6.5 Trợ lý cho khách này (không cần khoá AI)
Khung Trợ lý cho khách này (①) chạy theo quy tắc, dùng được cả khi chưa có khoá AI:
- Tóm tắt (②): bấm Tóm tắt khách để có bản tóm tắt nhanh từ dữ liệu CRM.
- Soạn tin (③): chọn Mục đích (⑤: Hỏi thăm, Nhắc lịch hẹn, Chúc sinh nhật, Chúc kỷ niệm, Chào khách mới, Giới thiệu bản thân, Theo sau trao đổi, Cảm ơn) và Kênh, bấm Soạn tin (⑥). Bấm Đưa vào hộp duyệt để chuyển bản nháp sang Hộp duyệt tin.
- Phân tích ghi chú (④): dán ghi chú cuộc gọi; hệ thống đề xuất một việc tiếp theo và gợi ý giai đoạn.
Khi dữ liệu khách thay đổi sau lần phân tích, khung hiện "Dữ liệu khách đã thay đổi sau lần phân tích này" — hãy chạy lại.
7. Cảnh báo bất thường
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tiêu đề | Danh sách cảnh báo |
| ② | Kiểm tra ngay | Admin chạy kiểm tra ngay (bình thường hệ thống tự kiểm tra 5 phút một lần) |
| ③④ | Đang mở / Đã xử lý | Lọc cảnh báo; bấm Đã xử lý trên cảnh báo khi đã giải quyết |
Ba loại cảnh báo:
| Loại | Điều kiện mặc định |
|---|---|
| Khách nóng bị bỏ quên | Khách nóng quá 24 giờ chưa có hoạt động của nhân viên |
| Đối tác phản hồi chậm | Đối tác quá 12 giờ chưa phản hồi khách được giao (nghiêm trọng khi quá hạn cam kết) |
| Kênh giảm mạnh | Một kênh nguồn giảm từ 40% so với 7 ngày trước, với ít nhất 5 khách |
Mức độ: Thông tin, Cảnh báo, Nghiêm trọng. AI viết thêm lời giải thích cho từng cảnh báo. Cảnh báo mới được email cho admin. Người không phải admin chỉ thấy cảnh báo "khách nóng bị bỏ quên" của khách mình hoặc khách chưa phân công. Ảnh trên là trạng thái "Không có cảnh báo."
8. Báo cáo tuần (admin)
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Tạo báo cáo tuần trước | Tạo ngay báo cáo của tuần trước (đã có thì mở bản cũ) |
| ② | Điểm nổi bật | Những gì tốt lên |
| ③ | Cần lưu ý | Những gì xấu đi hoặc đáng lo |
| ④ | Đề xuất | Việc nên làm tuần này |
| ⑤ | Số liệu | Bảng so sánh tuần qua và tuần trước: khách mới, giao dịch mới, thắng, thất bại, giá trị, khách nóng… |
Số liệu do CRM tính bằng truy vấn cố định; AI chỉ viết phần nhận xét. Báo cáo tự tạo sáng thứ Hai 07:00
và gửi email cho AI_WEEKLY_REPORT_TO (để trống thì gửi mọi admin).
9. AI ở các nơi khác
| Chức năng | Nơi dùng | Cách dùng |
|---|---|---|
| Cá nhân hoá bản tin (admin, marketing) | Màn soạn chiến dịch bản tin chưa gửi | Bật Bật cá nhân hóa, bấm Xem trước người nhận. Khi gửi, mỗi người nhận được tối đa 3 bài viết và 2 khoá học phù hợp; khối tin đăng nhà không bị thay |
| Đọc hồ sơ bằng AI (admin) | Hồ sơ đối tác | Tải giấy phép (PDF/PNG/JPEG, không bắt buộc), bấm Kiểm tra hồ sơ. AI đối chiếu W-9 và giấy phép với hồ sơ, báo các cờ như thiếu W-9, tên không khớp, giấy phép hết hạn. Số W-9 bị xoá trước khi gửi AI; W-9 dạng ảnh quét chỉ được đánh dấu để kiểm tra tay |
| Câu hỏi do AI soạn | Soạn bài học (Khoá học) | Soạn bản nháp câu hỏi trắc nghiệm, xem lại, Duyệt và thêm vào bài |
| Phụ đề và bản ghi lời | Soạn bài học video | Tạo phụ đề bằng nhận dạng giọng nói hoặc tải WebVTT, Dịch sang tiếng Anh/Việt, Xuất bản; nhãn "Do AI tạo" |
| Trợ lý của đối tác | /workspace/ai |
Đối tác hỏi đáp, ưu tiên, hộp duyệt và agents trên dữ liệu của riêng mình; agents cần đối tác đã được duyệt |
10. Quyền riêng tư và an toàn
| Chủ đề | Cách hệ thống xử lý |
|---|---|
| Thông tin định danh | Tên, email, điện thoại, địa chỉ trong biểu mẫu bị lọc trước khi gửi AI. Trong trợ lý, email, số điện thoại, địa chỉ được thay bằng mã giữ chỗ (ví dụ [[EMAIL_3fa9c1]]) rồi khôi phục khi hiển thị. Tên người vẫn có thể đến AI trong kết quả tra cứu |
| Dữ liệu không bao giờ gửi AI | IP và user agent, chữ số W-9 và mã số thuế, dòng dữ liệu thuế, nội dung tệp đính kèm trong trợ lý, tệp xuất |
| Phạm vi | Mọi tra cứu chạy bằng quyền của người dùng; đối tác chỉ đọc dữ liệu của mình |
| Chống "ra lệnh qua dữ liệu" | Lời dặn hệ thống coi tin nhắn, ghi chú, tài liệu là dữ liệu chứ không phải lệnh; thẻ đề xuất sau khi đọc dữ liệu đã lưu luôn cần xác nhận hai bước; mọi thẻ được máy chủ kiểm tra lại |
| Nhật ký | Nhật ký sử dụng AI chỉ ghi số token, mô hình, tính năng; không ghi nội dung câu hỏi hay câu trả lời |
| Lưu trữ | Không lưu hội thoại trợ lý. Kết quả AI (tóm tắt, nháp, tín hiệu) được lưu cho tới khi được xử lý; hiện chưa có tác vụ tự xoá |
| Fair Housing | Mọi lời dặn hệ thống cấm dùng đặc điểm được bảo vệ |
Giới hạn sử dụng:
| Giới hạn | Mặc định | Khi vượt |
|---|---|---|
| Yêu cầu mỗi người mỗi phút | 10 (AI_USER_REQUESTS_PER_MINUTE) |
"Bạn đã thử quá nhiều lần, vui lòng thử lại sau" |
| Token mỗi người mỗi ngày | 200.000 (AI_USER_DAILY_TOKENS) |
"Bạn đã dùng hết hạn mức AI hôm nay"; trợ lý chuyển sang quy tắc, agents bỏ qua |
| Token toàn hệ thống mỗi ngày | 2.000.000 (AI_DAILY_TOKEN_BUDGET) |
"Dịch vụ AI tạm thời không phản hồi…" |
| Thời gian một yêu cầu | 25 giây, thử lại 2 lần; trả lời dạng luồng tối đa 120 giây | Báo lỗi, không ghi gì |
11. Quản trị: nhà cung cấp và mô hình AI
11.1 Chọn nhà cung cấp (đội vận hành)
Đặt trong dotenv của máy chủ rồi khởi động lại API:
| Biến | Giá trị |
|---|---|
AI_PROVIDER |
anthropic (mặc định), openai hoặc openrouter |
ANTHROPIC_API_KEY / OPENAI_API_KEY / OPENROUTER_API_KEY |
Khoá của nhà cung cấp đang chọn; chỉ khoá đó được dùng |
*_BASE_URL |
Đổi địa chỉ API (bắt buộc https ở production) |
Thiếu khoá của nhà cung cấp đang chọn thì toàn bộ AI tắt và CRM chạy chế độ quy tắc.
11.2 Đổi mô hình ngay trong CRM (admin)
| Số | Thành phần | Công dụng |
|---|---|---|
| ① | Mô hình AI | Tab trong Cài đặt CRM, chỉ admin thấy |
| ② | Nhà cung cấp | Nhà cung cấp đang dùng (Anthropic, OpenAI, OpenRouter) |
| ③ | Mục đích | Sáu mục đích dùng AI (bảng dưới) |
| ④ | Mô hình | Ô nhập mã mô hình cho mục đích đó; dòng dưới ghi mô hình mặc định |
| ⑤ | Trạng thái | Mặc định hoặc Đã đổi |
| ⑥ | Về mặc định | Trả mục đích đó về mô hình mặc định |
| ⑦ | Lưu mô hình | Lưu các thay đổi |
| Mục đích | Dùng cho | Mặc định Anthropic | OpenRouter | OpenAI |
|---|---|---|---|---|
| Trò chuyện | Trợ lý website, học viện, nhận xét công cụ tính | claude-sonnet-5-5 | anthropic/claude-sonnet-5.5 | gpt-5.6-terra |
| Trích xuất | Phân loại, bộ lọc tìm kiếm bằng ngôn ngữ tự nhiên | claude-haiku-5-5 | anthropic/claude-haiku-5.5 | gpt-5.6-luna |
| Biên tập | Bản dịch, bài viết, câu đố, phụ đề | claude-sonnet-5-5 | anthropic/claude-sonnet-5.5 | gpt-5.6-terra |
| Suy luận | Trợ lý dữ liệu CRM (thẻ hành động), giải thích cảnh báo | claude-opus-5-5 | anthropic/claude-opus-5.5 | gpt-5.6-sol |
| Soạn thảo | Tóm tắt, bản nháp, danh sách hằng ngày, báo cáo tuần | claude-sonnet-5-5 | anthropic/claude-sonnet-5.5 | gpt-5.6-terra |
| Nhanh | Mức sẵn sàng, gắn nhãn thẻ, đọc tài liệu | claude-haiku-5-5 | anthropic/claude-haiku-5.5 | gpt-5.6-luna |
Các bước:
- Mở Cài đặt CRM → Mô hình AI.
- Nhập mã mô hình mới vào ô của mục đích cần đổi (chỉ gồm chữ, số và
. _ : / @ -, tối đa 100 ký tự). - Bấm Lưu mô hình. Hệ thống gửi một yêu cầu rất nhỏ tới nhà cung cấp để kiểm tra mô hình. Mô hình bị từ chối thì báo lỗi ngay ở dòng đó ("Nhà cung cấp … không chạy được model này") và không lưu.
- Thay đổi có hiệu lực từ yêu cầu kế tiếp, không cần triển khai lại, và được ghi nhật ký kiểm toán.
Thiết lập lưu riêng cho từng nhà cung cấp, nên đổi
AI_PROVIDERsau này không dùng nhầm mã mô hình của nhà khác.
Admin cũng có thể yêu cầu trợ lý đổi mô hình; thao tác hiện thành thẻ "Cần chú ý".
12. Trạng thái và thông báo lỗi
| Đối tượng | Trạng thái |
|---|---|
| Kết quả AI (tóm tắt, nháp, tín hiệu) | generated → accepted hoặc discarded, chỉ một lần ("Gợi ý này đã được xử lý"); có cờ "dữ liệu đã thay đổi" |
| Bản nháp tin nhắn | Đang chờ → Đã gửi hoặc Đã bỏ |
| Cảnh báo | Đang mở, Đã xử lý; mức Thông tin, Cảnh báo, Nghiêm trọng |
| Thẻ hành động | Chờ, Đang chạy, Đã thực hiện, Hết hạn, Dữ liệu đã đổi, Không rõ kết quả |
| Thông báo | Ý nghĩa |
|---|---|
| Tính năng AI chưa được cấu hình | Máy chủ chưa có khoá AI |
| Dịch vụ AI tạm thời không phản hồi, vui lòng thử lại sau | Nhà cung cấp lỗi hoặc hết ngân sách toàn hệ thống |
| Bạn đã dùng hết hạn mức AI hôm nay | Hết hạn mức cá nhân, đặt lại lúc 0 giờ theo giờ công ty |
| Bắt buộc xác nhận sự đồng ý | Tóm tắt tư vấn chưa tick xác nhận |
| Agent đang chạy | Agent đang chạy dở, chờ xong |
| Khách chưa đồng ý nhận email tiếp thị | Không gửi được bản nháp vì thiếu đồng ý |
| Không tạo được gợi ý AI / Trợ lý gặp lỗi | Lỗi tạm thời, thử lại |
13. Hạng mục còn mở
| Hạng mục | Tình trạng |
|---|---|
| Đánh giá độ chính xác tiếng Việt với mô hình thật (cổng G1, ngưỡng 90%) | Chưa chạy; bộ 176 câu mới chỉ chạy với mô hình giả |
Danh sách bang yêu cầu mọi bên đồng ý ghi âm (AI_ALL_PARTY_CONSENT_STATES) |
Chờ luật sư xác nhận |
| Tự xoá kết quả AI, cảnh báo, nhật ký sử dụng theo thời hạn | Chưa có |
| Kết quả tóm tắt tư vấn cũ (tạo trước bản sửa) vẫn còn trường trích dẫn trong cơ sở dữ liệu | Bản mới không lưu nữa; xoá dữ liệu cũ nếu cần |
| Gọi OpenAI trực tiếp | Chưa thử với khoá thật; tên mô hình mặc định lấy từ danh mục OpenRouter |
| Tab Mô hình AI | Đã chụp được trên staging; chưa thử lưu một mô hình khác |
| Giới hạn tần suất | Tính riêng theo từng máy chủ API, chưa dùng chung khi chạy nhiều máy |