Beyond The Deed Hub · Tài liệu hệ thống

Đặc tả yêu cầu, Hướng dẫn sử dụng & AI trong CRM

Website + CMS, Học viện và Sandy CRM. Ảnh chụp từ staging, giao diện tiếng Việt, gán số theo từng thao tác.

1Số đỏ trên ảnh khớp với số ①②③ trong bảng và các bước bên dưới ảnh. Bấm ảnh để phóng to.
Phiên bản1.0 · 18/11/2026Ảnh chụp95 màn hình, 1440 × 900Mã nguồnmain @ d6913b0

Đặ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

  1. 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.
  2. 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.
  3. 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ứ.
  4. 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_LOCALE dù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

  1. 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/.
  2. 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).
  3. 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.
  4. Toàn bộ màn hình có bản vi/en, hiển thị đúng trên 390 px và 1440 px.
  5. 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

Hình 1.1 — Trang chủ và thanh điều hướng
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

Hình 1.2 — Tạo tài khoản
  1. Bấm Đăng nhập (Hình 1.1 ④), chọn Đăng ký, hoặc mở /vi/register.
  2. Nhập Họ và tên (①) và Email (②).
  3. Số điện thoại (③) không bắt buộc; nhập số Mỹ dạng (512) 555-0147 hoặc số quốc tế có +.
  4. Đặt Mật khẩu (④) từ 8 đến 128 ký tự, nhập lại ở ⑤.
  5. Bấm Tạo tài khoản (⑥). Hệ thống tự kiểm tra chống bot (Cloudflare Turnstile).
  6. 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."
  7. Đã 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

Hình 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 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:

  1. Nhập email (③) và mật khẩu (④), bấm Đăng nhập (⑥).
  2. Bạn được đưa về trang đang xem trước đó, hoặc trang Tài khoản.
  3. Đă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

Hình 1.4 — Quên mật khẩu
  1. Ở trang đăng nhập bấm Quên mật khẩu?.
  2. 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ư.
  3. 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.
  4. Liên kết hết hạn: bấm Gửi liên kết mới.
  5. Nhớ lại mật khẩu thì quay về Đăng nhập (③).

1.5 Trang Tài khoản

Hình 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

Hình 1.6 — Đổi mật khẩu
  1. Mở trang Tài khoản, cuộn tới phần đổi mật khẩu.
  2. Nhập Mật khẩu hiện tại (①), Mật khẩu mới (②) và nhập lại (③).
  3. 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.

Hình 2.1 — Biểu mẫu liên hệ
  1. 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.
  2. Nhập Họ và tên (②).
  3. Nhập Email (③) hoặc Số điện thoại (④) — cần ít nhất một trong hai.
  4. Chọn Tiểu bang quan tâm (⑤) nếu đã có.
  5. Viết câu hỏi ở Nội dung (⑥), tối đa 5.000 ký tự.
  6. 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.

Hình 2.2 — Đăng ký bản tin
  1. Nhập Email (①); Họ và tên (②) không bắt buộc.
  2. Chọn 1–3 chủ đề (③): Đầu tư cho thuê, Mua nhà để ở, Học bài bản.
  3. Tick ô đồng ý nhận email (④) — bắt buộc để đăng ký.
  4. Bấm Đăng ký (⑤).
  5. 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.

Hình 2.3 — Trắc nghiệm lộ trình
  1. 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 (④).
  2. 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.
  3. 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.

Hình 2.4 — Danh sách nhà theo số vốn
  • 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à.
Hình 2.5 — Bộ lọc nhà đất
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ỷ.

Hình 2.6 — Công cụ dòng tiền
  1. Chọn Tiểu bang (①) để điền sẵn thuế nhà đất và bảo hiểm trung bình của bang.
  2. 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.
  3. 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.
  4. Bấm Đặt lại số mặc định (③) để làm lại từ đầu.
  5. 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ụ.

Hình 2.7 — Bước 1: chọn buổi tư vấn

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 (③).

Hình 2.8 — Bước 2: chọn ngày giờ

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.

Hình 2.9 — Nhận tài liệu miễn phí
  1. Nhập Email (①), họ tên (② — không bắt buộc).
  2. Tick đồng ý nhận email (③) nếu muốn nhận thêm nội dung.
  3. 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.
  4. Tài liệu đi kèm gói được liệt kê bên phải (⑤).
Hình 2.10 — Thư viện tài liệu

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).

Hình 2.11 — Đặt trước sách
  1. Ở khung Đặt trước sách (①), xem giá và chọn Số lượng (②).
  2. Nhập họ và tên, email, số điện thoại (không bắt buộc).
  3. 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ỗ.
  4. 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.
  5. Độ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.

Hình 2.12 — Thư mục đối tác
  1. Chọn Tiểu bang (①) và Lĩnh vực (②), bấm Lọc (③).
  2. Bấm vào một đối tác để xem hồ sơ.
  3. 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.
  4. 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

Hình 2.13 — Trợ lý trò chuyện
  1. Bấm Hỏi trợ lý ở góc phải dưới mọi trang; khung trò chuyện (①) mở ra.
  2. 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.
  3. 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.

  • 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

Hình 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

Hình 3.2 — Trang khoá học
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:

  1. Chưa đăng nhập: bấm Đăng nhập để ghi danh, đăng nhập rồi quay lại trang khoá học.
  2. Có mã giới thiệu từ đại sứ: nhập ở Mã giới thiệu (nếu có) (khoá có phí).
  3. Khoá miễn phí: bấm Ghi danh miễn phí — ghi danh ngay.
  4. 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

Hình 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

Hình 3.4 — Trình 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

Hình 3.5 — Bài trắc nghiệm
  1. Mở bài trắc nghiệm (①) trong mục lục.
  2. 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 (③).
  3. 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.
  4. 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.
  5. 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.
  6. 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

  1. 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.
  2. 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.
  3. Người khác kiểm tra chứng nhận tại /verify/<mã> (mã dạng BTD-XXXX-XXXX-XXXX).
Hình 3.6 — Trang xác minh chứng nhận

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

Hình 4.1 — Bảng điều khiển CMS
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

Hình 4.2 — Danh sách Kiến thức & Podcast
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

Hình 4.3 — Màn hình soạ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:

  1. Ở danh sách, bấm Tạo mới hoặc bấm tên bài cần sửa.
  2. 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.
  3. 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ị.
  4. Điền tab SEO (③).
  5. 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.
  6. Bấm Xem trước (⑥) để kiểm tra trên giao diện thật.
  7. 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

Hình 5.1 — Bố cục Sandy CRM
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

Hình 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

Hình 5.3 — 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

Hình 5.4 — Thêm khách hàng (phần trên)
  1. Bấm Thêm khách hàng (Hình 5.3 ⑨).
  2. Nhập Họ tên (①, bắt buộc).
  3. 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).
  4. 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.
  5. 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.
  6. Chọn Bang quan tâm (⑥, chọn nhiều) và Ngân sách (⑦ tối thiểu / tối đa, USD).
Hình 5.5 — Thêm khách hàng (phần dưới)
  1. 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 (③).
  2. 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…).
  3. Chọn Nguồn (⑥) và Người phụ trách (⑦). Sales tạo khách thì luôn là người phụ trách.
  4. 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

Hình 5.6 — 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
Hình 5.7 — Điểm, AI, giao dịch, việc
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
Hình 5.8 — Biểu mẫu và đồng ý liên lạc
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.

Hình 5.9 — Email, lịch hẹn, giao cho môi giới
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

Hình 5.10 — Thêm hoạt động
  1. Bấm Thêm hoạt động (Hình 5.6 ⑧); hộp thoại (①) mở ra.
  2. 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 đó.
  3. 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.
  4. Nhập Nội dung (③, bắt buộc, tối đa 5.000 ký tự).
  5. 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).

Hình 5.11 — Hộp thư lead
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)

Hình 5.12 — Bả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

Hình 5.13 — Tạo giao dịch
  1. Bấm Tạo giao dịch (Hình 5.12 ⑦); hộp thoại (①) mở ra.
  2. 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).
  3. Chọn Khách hàng và nhập Tên giao dịch (bắt buộc, ví dụ "Mua nhà ở Austin, TX").
  4. Nhập Giá trị (USD), Ngày dự kiến chốt, Người phụ trách, Ghi chú nếu có.
  5. Bấm Tạo (②). Thẻ mới hiện ở cột giai đoạn đã chọn.

Chi tiết giao dịch

Hình 5.14 — Chi tiết giao dịch bất động sản
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

Hình 5.15 — Công việc của tôi
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

Hình 5.16 — Lịch hẹn tuầ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.

Hình 5.17 — Chi tiết lịch hẹn
  1. 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ú.
  2. Đổi giờ (③): chọn giờ mới; khách nhận email cập nhật kèm .ics.
  3. Hủy lịch (④): nhập lý do; khách nhận email huỷ kèm cancel.ics.
  4. 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.
  5. 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

Hình 5.18 — 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

Hình 5.19 — Danh sách 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)
Hình 5.20 — Chi tiết bất động sản

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

Hình 5.21 — Phễu khách theo phân khúc và nguồn
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)
Hình 5.22 — Hiệu suất người phụ trách

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.

Hình 5.23 — Bộ 8 chỉ số dự án

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.

Hình 5.24 — Việc nên làm hôm nay

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ơ.

Hình 5.25 — Trợ lý dữ liệu

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

Hình 5.26 — Bàn giao cho thuê (NTBS)

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.

Hình 5.27 — Yêu cầu VIP

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.

Hình 6.1 — Danh sách 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
Hình 6.2 — Soạn chiến dịch
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:

  1. Tạo chiến dịch, đặt tên nội bộ và mã chiến dịch.
  2. Soạn tiêu đề, dòng xem trước và các khối cho Tiếng Việt, rồi English.
  3. Chọn Người nhận. Chỉ khách đã đồng ý nhận email mới được tính.
  4. Gửi thử và kiểm tra hộp thư.
  5. 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

Hình 6.3 — Lịch gửi bản tin
  1. Mỗi chủ đề (Đầu tư, Mua nhà để ở, Học bài bản) có một khung Lịch gửi theo chủ đề (①).
  2. 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.
  3. 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.
  4. 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

Hình 6.4 — 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)

Hình 6.5 — Tạo liên kết theo dõi
  1. Nhập Tên (①) và Đường dẫn đích (②, ví dụ /vi).
  2. Chọn kênh; nhập Nguồn (③, ví dụ facebook), kênh (medium), Chiến dịch (④), nội dung, từ khoá.
  3. Bấm Lưu liên kết (⑤), rồi Sao chép (⑥) để dán vào bài đăng/quảng cáo.
  4. 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á

Hình 6.6 — 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

Hình 6.7 — Nhập khách hàng từ CSV

Nhập dữ liệu (admin, marketing):

  1. 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.
  2. 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.
  3. 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.
  4. 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).
  5. 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.
Hình 6.8 — Hồ sơ trùng

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)

Hình 6.9 — Đối tác
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í.

Hình 6.10 — Phí giới thiệu

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).

Hình 6.11 — Đại sứ

Đạ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ụ.

Hình 6.12 — Chi trả đại sứ

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.

Hình 6.13 — Thuế 1099-NEC

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ủ

Hình 6.14 — Nội dung trang chủ
  1. Chọn Ngôn ngữ nội dung (①).
  2. 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ự.
  3. 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

Hình 6.15 — Người dùng
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
Hình 6.16 — Thêm người dùng
  1. Bấm Thêm người dùng.
  2. Nhập Email (①) và Họ tên (②); chọn ngôn ngữ, số điện thoại (không bắt buộc).
  3. 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ò.
  4. Đặ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.
  5. 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

Hình 6.17 — Cài đặt CRM
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.

Hình 6.18 — Mẫu nội dung

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 6.19 — Hành trình khách hàng

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

Hình 6.20 — Danh sách khoá học

Khoá học (admin, marketing): lọc trạng thái (①), Tạo khoá học (②), bấm tên khoá (③) để soạn.

Hình 6.21 — Soạn khoá học
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.

Hình 6.22 — Ghi danh học viện

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 độ (⑤).

Hình 6.23 — Sản phẩm & lớp học

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ụ.

Hình 6.24 — Đặt trước sách

Đặ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.

Hình 6.25 — Doanh thu

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

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ợ

  • Quên mật khẩu: 1.4.
  • Không thấy menu cần dùng: kiểm tra vai trò ở trang Tài khoản (1.5).
  • Lỗi khác: gửi ảnh màn hình và thời điểm xảy ra cho quản trị viên.

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

  1. 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].
  2. 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ả.
  3. 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.
  4. 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).
  5. 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

Hình AI.1 — 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

Hình AI.2 — Trợ lý dữ liệu
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

Hình AI.3 — Câu trả lời của trợ lý
  1. 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 (①).
  2. 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.
  3. 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").
  4. 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

Hình AI.4 — Thẻ đề xuất tạo việc
  1. 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".
  2. 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.
  3. Kiểm tra thẻ. Các trường trên thẻ sửa được trước khi xác nhận.
  4. 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.
  5. 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.

Hình AI.5 — Thẻ không hoàn tác được
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ình AI.6 — Xác nhận hai bước
  1. 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.
  2. Gõ đúng XAC NHAN vào ô (②). Nút Xác nhận (③) chỉ bật khi gõ đúng.
  3. 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ình AI.7 — Hộp duyệt tin

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

Hình AI.8 — 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

Hình AI.9 — Tóm tắt trước cuộc gọi
  1. Mở tab Trước cuộc gọi (①), bấm Tạo tóm tắt.
  2. 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.
  3. Chuyển Tiếng Việt (②) / English (③) để xem bản tiếng Anh. Tạo lại (④) để viết lại.
  4. 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

Hình AI.10 — Soạn trả lời
  1. Mở tab Soạn trả lời (①), chọn kênh Email (②) hoặc Tin nhắn SMS (③).
  2. 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ự).
  3. Bấm Soạn nháp song ngữ (⑥). AI viết bản tiếng Việt và tiếng Anh.
  4. 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

Hình AI.11 — Tóm tắt 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)

Hình AI.12 — Trợ lý cho khách này

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

Hình AI.13 — 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)

Hình AI.14 — Báo cáo tuần
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)

Hình AI.15 — Cài đặt mô hình AI
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:

  1. Mở Cài đặt CRM → Mô hình AI.
  2. 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ự).
  3. 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.
  4. 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_PROVIDER sau 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