Thiết kế chi tiết hệ thống CRM 2.0

1. Tổng quan hệ thống và triết lý thiết kế

1.1 Định vị hệ thống

Hệ thống này là nền tảng quản lý bán hàng CRM 2.0 được xây dựng trên nền tảng no-code NocoBase. Mục tiêu cốt lõi là:

Để bán hàng tập trung vào việc xây dựng quan hệ khách hàng, không phải nhập liệu và phân tích lặp lại

Hệ thống tự động xử lý các tác vụ thường xuyên thông qua Workflow, đồng thời nhờ AI hỗ trợ hoàn thành chấm điểm Lead, phân tích Cơ hội, giúp đội bán hàng nâng cao hiệu quả.

1.2 Triết lý thiết kế

Triết lý 1: Phễu bán hàng đầy đủ

Quy trình bán hàng end-to-end: design-2026-02-24-00-05-26

Tại sao thiết kế như vậy?

Cách truyền thốngCRM tích hợp
Dùng nhiều hệ thống cho các giai đoạn khác nhauMột hệ thống bao phủ toàn bộ vòng đời
Truyền dữ liệu thủ công giữa các hệ thốngTự động luân chuyển và chuyển đổi dữ liệu
View Khách hàng không nhất quánView Khách hàng 360 độ thống nhất
Phân tích dữ liệu phân tánPhân tích pipeline bán hàng end-to-end

Triết lý 2: Pipeline bán hàng có thể cấu hình

design-2026-02-24-00-06-04

Các ngành khác nhau có thể tùy chỉnh giai đoạn pipeline bán hàng mà không cần sửa code.

Triết lý 3: Thiết kế dạng module

  • Module cốt lõi (Khách hàng + Cơ hội) bắt buộc, các module khác có thể bật theo nhu cầu
  • Vô hiệu hóa module không cần sửa code, cấu hình qua giao diện NocoBase là được
  • Mỗi module được thiết kế độc lập, giảm độ ghép cặp

2. Kiến trúc module và tùy biến

2.1 Tổng quan module

Hệ thống CRM áp dụng thiết kế kiến trúc dạng module—mỗi module có thể bật hoặc tắt độc lập theo nhu cầu nghiệp vụ. design-2026-02-24-00-06-14

2.2 Quan hệ phụ thuộc giữa các module

ModuleCó bắt buộcPhụ thuộcĐiều kiện vô hiệu
Quản lý Khách hàng✅ Có-Không thể vô hiệu (cốt lõi)
Quản lý Cơ hội✅ CóQuản lý Khách hàngKhông thể vô hiệu (cốt lõi)
Quản lý LeadTùy chọn-Không cần thu thập Lead
Quản lý Báo giáTùy chọnCơ hội, Sản phẩmGiao dịch đơn giản không cần báo giá chính thức
Quản lý Đơn hàngTùy chọnCơ hội (hoặc Báo giá)Không cần theo dõi Đơn hàng/thanh toán
Quản lý Sản phẩmTùy chọn-Không cần danh mục Sản phẩm
Tích hợp EmailTùy chọnKhách hàng, Liên hệDùng hệ thống Email bên ngoài

2.3 Phiên bản đã cấu hình sẵn

Phiên bảnModule bao gồmTình huống dùngSố lượng bảng dữ liệu
Bản nhẹKhách hàng + Cơ hộiTheo dõi giao dịch đơn giản6
Bản tiêu chuẩnBản nhẹ + Lead + Báo giá + Đơn hàng + Sản phẩmChu kỳ bán hàng đầy đủ15
Bản doanh nghiệpBản tiêu chuẩn + Tích hợp EmailTính năng đầy đủ kèm Email17

2.4 Ánh xạ Module - Bảng dữ liệu

Bảng dữ liệu module cốt lõi (luôn bắt buộc)

Bảng dữ liệuModuleMô tả
nb_crm_customersQuản lý Khách hàngBản ghi Khách hàng/công ty
nb_crm_contactsQuản lý Khách hàngLiên hệ
nb_crm_customer_sharesQuản lý Khách hàngQuyền chia sẻ Khách hàng
nb_crm_opportunitiesQuản lý Cơ hộiCơ hội bán hàng
nb_crm_opportunity_stagesQuản lý Cơ hộiCấu hình giai đoạn
nb_crm_opportunity_usersQuản lý Cơ hộiCộng tác viên Cơ hội
nb_crm_activitiesQuản lý hoạt độngBản ghi hoạt động
nb_crm_commentsQuản lý hoạt độngComment/ghi chú
nb_crm_tagsCốt lõiTag chung
nb_cbo_currenciesDữ liệu cơ bảnTừ điển tiền tệ
nb_cbo_regionsDữ liệu cơ bảnTừ điển quốc gia/khu vực

2.5 Cách vô hiệu hóa module

Trong trang quản trị NocoBase chỉ cần ẩn điểm vào menu của module đó là được, không cần sửa code hoặc xóa bảng dữ liệu.


3. Thực thể cốt lõi và mô hình dữ liệu

3.1 Tổng quan quan hệ thực thể

design-2026-02-24-00-06-40

3.2 Chi tiết bảng dữ liệu cốt lõi

3.2.1 Bảng Lead (nb_crm_leads)

Quản lý Lead áp dụng workflow 4 giai đoạn đơn giản hóa.

Quy trình giai đoạn:

Mới → Đang theo dõi → Đã xác nhận → Chuyển đổi thành Khách hàng/Cơ hội
         ↓          ↓
       Không đạt   Không đạt

Trường chính:

TrườngKiểuMô tả
idBIGINTKhóa chính
lead_noVARCHARSố Lead (tự sinh)
nameVARCHARTên Liên hệ
companyVARCHARTên công ty
titleVARCHARChức danh
emailVARCHAREmail
phoneVARCHARĐiện thoại
mobile_phoneVARCHARDi động
websiteTEXTWebsite
addressTEXTĐịa chỉ
sourceVARCHARNguồn Lead: website/ads/referral/exhibition/telemarketing/email/social
industryVARCHARNgành
annual_revenueVARCHARQuy mô doanh thu năm
number_of_employeesVARCHARQuy mô số nhân viên
statusVARCHARTrạng thái: new/working/qualified/unqualified
ratingVARCHARĐánh giá: hot/warm/cold
owner_idBIGINTNgười phụ trách (FK → users)
ai_scoreINTEGERAI chấm điểm chất lượng 0-100
ai_convert_probDECIMALAI xác suất chuyển đổi
ai_best_contact_timeVARCHARAI gợi ý thời gian liên hệ
ai_tagsJSONBTag do AI sinh
ai_scored_atTIMESTAMPThời gian AI chấm điểm
ai_next_best_actionTEXTAI gợi ý hành động tốt nhất tiếp theo
ai_nba_generated_atTIMESTAMPThời gian AI sinh gợi ý
is_convertedBOOLEANĐánh dấu đã chuyển đổi
converted_atTIMESTAMPThời gian chuyển đổi
converted_customer_idBIGINTID Khách hàng được chuyển đổi
converted_contact_idBIGINTID Liên hệ được chuyển đổi
converted_opportunity_idBIGINTID Cơ hội được chuyển đổi
lost_reasonTEXTLý do thua
disqualification_reasonTEXTLý do không đạt
descriptionTEXTMô tả

3.2.2 Bảng Khách hàng (nb_crm_customers)

Quản lý Khách hàng/công ty hỗ trợ nghiệp vụ xuất khẩu.

Trường chính:

TrườngKiểuMô tả
idBIGINTKhóa chính
nameVARCHARTên Khách hàng (bắt buộc)
account_numberVARCHARMã Khách hàng (tự sinh, duy nhất)
phoneVARCHARĐiện thoại
websiteTEXTWebsite
addressTEXTĐịa chỉ
industryVARCHARNgành
typeVARCHARLoại: prospect/customer/partner/competitor
number_of_employeesVARCHARQuy mô số nhân viên
annual_revenueVARCHARQuy mô doanh thu năm
levelVARCHARCấp độ: normal/important/vip
statusVARCHARTrạng thái: potential/active/dormant/churned
countryVARCHARQuốc gia
region_idBIGINTKhu vực (FK → nb_cbo_regions)
preferred_currencyVARCHARTiền tệ ưu tiên: CNY/USD/EUR
owner_idBIGINTNgười phụ trách (FK → users)
parent_idBIGINTCông ty mẹ (FK → self)
source_lead_idBIGINTID Lead nguồn
ai_health_scoreINTEGERAI điểm sức khỏe 0-100
ai_health_gradeVARCHARAI cấp độ sức khỏe: A/B/C/D
ai_churn_riskDECIMALAI rủi ro mất khách 0-100%
ai_churn_risk_levelVARCHARAI cấp độ rủi ro mất khách: low/medium/high
ai_health_dimensionsJSONBAI điểm các chiều sức khỏe
ai_recommendationsJSONBAI danh sách đề xuất
ai_health_assessed_atTIMESTAMPThời gian AI đánh giá sức khỏe
ai_tagsJSONBTag do AI sinh
ai_best_contact_timeVARCHARAI gợi ý thời gian liên hệ
ai_next_best_actionTEXTAI gợi ý hành động tốt nhất tiếp theo
ai_nba_generated_atTIMESTAMPThời gian AI sinh gợi ý
descriptionTEXTMô tả
is_deletedBOOLEANĐánh dấu xóa mềm

3.2.3 Bảng Cơ hội (nb_crm_opportunities)

Quản lý Cơ hội bán hàng với các giai đoạn pipeline có thể cấu hình.

Trường chính:

TrườngKiểuMô tả
idBIGINTKhóa chính
opportunity_noVARCHARSố Cơ hội (tự sinh, duy nhất)
nameVARCHARTên Cơ hội (bắt buộc)
amountDECIMALSố tiền dự kiến
currencyVARCHARTiền tệ
exchange_rateDECIMALTỷ giá
amount_usdDECIMALSố tiền tương đương USD
customer_idBIGINTKhách hàng (FK)
contact_idBIGINTLiên hệ chính (FK)
stageVARCHARMã giai đoạn (FK → stages.code)
stage_sortINTEGERSắp xếp giai đoạn (dư thừa, tiện sắp xếp)
stage_entered_atTIMESTAMPThời gian vào giai đoạn hiện tại
days_in_stageINTEGERSố ngày ở giai đoạn hiện tại
win_probabilityDECIMALTỷ lệ thắng thủ công
ai_win_probabilityDECIMALAI dự đoán tỷ lệ thắng
ai_analyzed_atTIMESTAMPThời gian AI phân tích
ai_confidenceDECIMALAI mức độ tin cậy dự đoán
ai_trendVARCHARAI dự đoán xu hướng: up/stable/down
ai_risk_factorsJSONBAI nhận diện yếu tố rủi ro
ai_recommendationsJSONBAI danh sách đề xuất
ai_predicted_closeDATEAI dự đoán ngày chốt
ai_next_best_actionTEXTAI gợi ý hành động tốt nhất tiếp theo
ai_nba_generated_atTIMESTAMPThời gian AI sinh gợi ý
expected_close_dateDATENgày chốt dự kiến
actual_close_dateDATENgày chốt thực tế
owner_idBIGINTNgười phụ trách (FK → users)
last_activity_atTIMESTAMPThời gian hoạt động cuối
stagnant_daysINTEGERSố ngày không hoạt động
loss_reasonTEXTLý do thua đơn
competitor_idBIGINTĐối thủ cạnh tranh (FK)
lead_sourceVARCHARNguồn Lead
campaign_idBIGINTID chiến dịch marketing
expected_revenueDECIMALDoanh thu dự kiến = amount × probability
descriptionTEXTMô tả

3.2.4 Bảng Báo giá (nb_crm_quotations)

Quản lý báo giá hỗ trợ đa tiền tệ và quy trình duyệt.

Quy trình trạng thái:

Nháp → Chờ duyệt → Đã duyệt → Đã gửi → Đã chấp nhận/Đã từ chối/Đã hết hạn

       Bị bác → Sửa → Nháp

Trường chính:

TrườngKiểuMô tả
idBIGINTKhóa chính
quotation_noVARCHARSố phiếu báo giá (tự sinh, duy nhất)
nameVARCHARTên phiếu báo giá
versionINTEGERSố phiên bản
opportunity_idBIGINTCơ hội (FK, bắt buộc)
customer_idBIGINTKhách hàng (FK)
contact_idBIGINTLiên hệ (FK)
owner_idBIGINTNgười phụ trách (FK → users)
currency_idBIGINTTiền tệ (FK → nb_cbo_currencies)
exchange_rateDECIMALTỷ giá
subtotalDECIMALTổng phụ
discount_rateDECIMALTỷ lệ chiết khấu
discount_amountDECIMALSố tiền chiết khấu
shipping_handlingDECIMALPhí vận chuyển/xử lý
tax_rateDECIMALThuế suất
tax_amountDECIMALSố thuế
total_amountDECIMALTổng cộng
total_amount_usdDECIMALSố tiền tương đương USD
statusVARCHARTrạng thái: draft/pending_approval/approved/sent/accepted/rejected/expired
submitted_atTIMESTAMPThời gian nộp
approved_byBIGINTNgười duyệt (FK → users)
approved_atTIMESTAMPThời gian duyệt
rejected_atTIMESTAMPThời gian bác
sent_atTIMESTAMPThời gian gửi
customer_response_atTIMESTAMPThời gian Khách hàng phản hồi
expired_atTIMESTAMPThời gian hết hạn
valid_untilDATEHiệu lực đến
payment_termsTEXTĐiều khoản thanh toán
terms_conditionTEXTĐiều khoản và điều kiện
addressTEXTĐịa chỉ giao hàng
descriptionTEXTMô tả

3.2.5 Bảng Đơn hàng (nb_crm_orders)

Quản lý Đơn hàng kèm theo dõi thu hồi công nợ.

Trường chính:

TrườngKiểuMô tả
idBIGINTKhóa chính
order_noVARCHARSố Đơn hàng (tự sinh, duy nhất)
customer_idBIGINTKhách hàng (FK)
contact_idBIGINTLiên hệ (FK)
opportunity_idBIGINTCơ hội (FK)
quotation_idBIGINTBáo giá (FK)
owner_idBIGINTNgười phụ trách (FK → users)
currencyVARCHARTiền tệ
exchange_rateDECIMALTỷ giá
order_amountDECIMALSố tiền Đơn hàng
paid_amountDECIMALSố tiền đã thanh toán
unpaid_amountDECIMALSố tiền chưa thanh toán
statusVARCHARTrạng thái: pending/confirmed/in_progress/shipped/delivered/completed/cancelled
payment_statusVARCHARTrạng thái thanh toán: unpaid/partial/paid
order_dateDATENgày đặt hàng
delivery_dateDATENgày giao dự kiến
actual_delivery_dateDATENgày giao thực tế
shipping_addressTEXTĐịa chỉ giao hàng
logistics_companyVARCHARCông ty vận chuyển
tracking_noVARCHARMã vận đơn
terms_conditionTEXTĐiều khoản và điều kiện
descriptionTEXTMô tả

3.3 Tổng hợp bảng dữ liệu

Bảng nghiệp vụ CRM

STTTên bảngMô tảLoại
1nb_crm_leadsQuản lý LeadNghiệp vụ
2nb_crm_customersKhách hàng/công tyNghiệp vụ
3nb_crm_contactsLiên hệNghiệp vụ
4nb_crm_opportunitiesCơ hội bán hàngNghiệp vụ
5nb_crm_opportunity_stagesCấu hình giai đoạnCấu hình
6nb_crm_opportunity_usersCộng tác viên Cơ hội (đội bán hàng)Liên kết
7nb_crm_quotationsPhiếu báo giáNghiệp vụ
8nb_crm_quotation_itemsChi tiết báo giáNghiệp vụ
9nb_crm_quotation_approvalsBản ghi duyệtNghiệp vụ
10nb_crm_ordersĐơn hàngNghiệp vụ
11nb_crm_order_itemsChi tiết Đơn hàngNghiệp vụ
12nb_crm_paymentsBản ghi thu hồi công nợNghiệp vụ
13nb_crm_productsDanh mục Sản phẩmNghiệp vụ
14nb_crm_product_categoriesPhân loại Sản phẩmCấu hình
15nb_crm_price_tiersĐịnh giá theo bậcCấu hình
16nb_crm_activitiesBản ghi hoạt độngNghiệp vụ
17nb_crm_commentsComment/ghi chúNghiệp vụ
18nb_crm_competitorsĐối thủ cạnh tranhNghiệp vụ
19nb_crm_tagsTagCấu hình
20nb_crm_lead_tagsLiên kết Lead-TagLiên kết
21nb_crm_contact_tagsLiên kết Liên hệ-TagLiên kết
22nb_crm_customer_sharesQuyền chia sẻ Khách hàngLiên kết
23nb_crm_exchange_ratesLịch sử tỷ giáCấu hình

Bảng dữ liệu cơ bản (module chung)

STTTên bảngMô tảLoại
1nb_cbo_currenciesTừ điển tiền tệCấu hình
2nb_cbo_regionsTừ điển quốc gia/khu vựcCấu hình

3.4 Bảng phụ trợ

3.4.1 Bảng Comment (nb_crm_comments)

Bảng comment/ghi chú dùng chung, có thể liên kết đến nhiều loại đối tượng nghiệp vụ.

TrườngKiểuMô tả
idBIGINTKhóa chính
contentTEXTNội dung comment
lead_idBIGINTLead liên kết (FK)
customer_idBIGINTKhách hàng liên kết (FK)
opportunity_idBIGINTCơ hội liên kết (FK)
order_idBIGINTĐơn hàng liên kết (FK)

3.4.2 Bảng chia sẻ Khách hàng (nb_crm_customer_shares)

Hiện thực hóa cộng tác đa người và chia sẻ quyền của Khách hàng.

TrườngKiểuMô tả
idBIGINTKhóa chính
customer_idBIGINTKhách hàng (FK, bắt buộc)
shared_with_user_idBIGINTUser được chia sẻ (FK, bắt buộc)
shared_by_user_idBIGINTUser khởi tạo chia sẻ (FK)
permission_levelVARCHARCấp độ quyền: read/write/full
shared_atTIMESTAMPThời gian chia sẻ

3.4.3 Bảng Cộng tác viên Cơ hội (nb_crm_opportunity_users)

Hỗ trợ cộng tác đội bán hàng cho Cơ hội.

TrườngKiểuMô tả
opportunity_idBIGINTCơ hội (FK, khóa chính kép)
user_idBIGINTUser (FK, khóa chính kép)
roleVARCHARVai trò: owner/collaborator/viewer

3.4.4 Bảng Khu vực (nb_cbo_regions)

Từ điển dữ liệu cơ bản quốc gia/khu vực.

TrườngKiểuMô tả
idBIGINTKhóa chính
code_alpha2VARCHARMã 2 chữ ISO 3166-1 (duy nhất)
code_alpha3VARCHARMã 3 chữ ISO 3166-1 (duy nhất)
code_numericVARCHARMã số ISO 3166-1
nameVARCHARTên quốc gia/khu vực
is_activeBOOLEANCó kích hoạt
sort_orderINTEGERThứ tự sắp xếp

4. Vòng đời Lead

Quản lý Lead áp dụng workflow 4 giai đoạn đơn giản hóa, khi tạo Lead mới có thể tự động kích hoạt AI chấm điểm thông qua workflow, hỗ trợ bán hàng nhanh chóng nhận diện Lead chất lượng cao.

4.1 Định nghĩa trạng thái

Trạng tháiTênMô tả
newMớiVừa tạo, chờ liên hệ
workingĐang theo dõiĐang theo dõi tích cực
qualifiedĐã xác nhậnSẵn sàng chuyển đổi
unqualifiedKhông đạtKhông phù hợp

4.2 Sơ đồ luồng trạng thái

design-2026-02-24-00-25-32

4.3 Quy trình chuyển đổi Lead

Giao diện chuyển đổi đồng thời cung cấp ba lựa chọn, người dùng có thể chọn tạo hoặc liên kết:

  • Khách hàng: Tạo Khách hàng mới hoặc liên kết Khách hàng hiện có
  • Liên hệ: Tạo Liên hệ mới (liên kết đến Khách hàng)
  • Cơ hội: Bắt buộc tạo Cơ hội design-2026-02-24-00-25-22

Bản ghi sau chuyển đổi:

  • converted_customer_id: ID Khách hàng được liên kết
  • converted_contact_id: ID Liên hệ được liên kết
  • converted_opportunity_id: ID Cơ hội được tạo

5. Vòng đời Cơ hội

Quản lý Cơ hội áp dụng các giai đoạn pipeline bán hàng có thể cấu hình. Khi giai đoạn Cơ hội thay đổi có thể tự động kích hoạt AI dự đoán tỷ lệ thắng, giúp bán hàng nhận diện rủi ro và cơ hội.

5.1 Giai đoạn có thể cấu hình

Giai đoạn được lưu trong bảng nb_crm_opportunity_stages, có thể tùy chỉnh:

TênThứ tựTỷ lệ thắng mặc định
prospectingTiếp xúc ban đầu110%
analysisPhân tích nhu cầu230%
proposalĐề xuất phương án360%
negotiationĐàm phán thương mại480%
wonThắng đơn5100%
lostThua đơn60%

5.2 Quy trình pipeline

design-2026-02-24-00-20-31

5.3 Phát hiện ngừng trệ

Cơ hội không có hoạt động sẽ được đánh dấu:

Số ngày không hoạt độngHành động
7 ngàyCảnh báo vàng
14 ngàyNhắc nhở cam đến người phụ trách
30 ngàyNhắc nhở đỏ đến quản lý
-- Tính số ngày ngừng trệ
UPDATE nb_crm_opportunities
SET stagnant_days = EXTRACT(DAY FROM NOW() - last_activity_at)
WHERE stage NOT IN ('won', 'lost');

5.4 Xử lý thắng/thua đơn

Khi thắng đơn:

  1. Cập nhật giai đoạn thành 'won'
  2. Ghi lại ngày chốt thực tế
  3. Cập nhật trạng thái Khách hàng thành 'active'
  4. Kích hoạt tạo Đơn hàng (nếu báo giá được chấp nhận)

Khi thua đơn:

  1. Cập nhật giai đoạn thành 'lost'
  2. Ghi lại lý do thua đơn
  3. Ghi lại ID đối thủ cạnh tranh (nếu thua cho đối thủ)
  4. Thông báo cho quản lý

6. Vòng đời Báo giá

6.1 Định nghĩa trạng thái

Trạng tháiTênMô tả
draftNhápĐang chuẩn bị
pending_approvalChờ duyệtĐang chờ duyệt
approvedĐã duyệtCó thể gửi
sentĐã gửiĐã gửi cho Khách hàng
acceptedĐã chấp nhậnKhách hàng đã chấp nhận
rejectedĐã từ chốiKhách hàng đã từ chối
expiredĐã hết hạnQuá hạn hiệu lực

6.2 Quy tắc duyệt (đang hoàn thiện)

Quy trình duyệt được kích hoạt dựa trên các điều kiện sau:

Điều kiệnCấp duyệt
Chiết khấu > 10%Quản lý bán hàng
Chiết khấu > 20%Giám đốc bán hàng
Số tiền > $100KTài chính + Tổng giám đốc

6.3 Hỗ trợ đa tiền tệ

Triết lý thiết kế

Sử dụng USD làm tiền tệ cơ sở thống nhất cho mọi báo cáo và phân tích. Mỗi bản ghi số tiền lưu:

  • Tiền tệ và số tiền gốc (Khách hàng nhìn thấy)
  • Tỷ giá tại thời điểm giao dịch
  • Số tiền tương đương USD (dùng để so sánh nội bộ)

Bảng từ điển tiền tệ (nb_cbo_currencies)

Cấu hình tiền tệ áp dụng bảng dữ liệu cơ bản chung, hỗ trợ quản lý động. Trường current_rate lưu tỷ giá hiện tại, được đồng bộ cập nhật từ bản ghi mới nhất của nb_crm_exchange_rates thông qua tác vụ định kỳ.

TrườngKiểuMô tả
idBIGINTKhóa chính
codeVARCHARMã tiền tệ (duy nhất): USD/CNY/EUR/GBP/JPY
nameVARCHARTên tiền tệ
symbolVARCHARKý hiệu tiền tệ
decimal_placesINTEGERSố chữ số thập phân
current_rateDECIMALTỷ giá hiện tại với USD (đồng bộ định kỳ từ bảng lịch sử tỷ giá)
is_activeBOOLEANCó kích hoạt
sort_orderINTEGERThứ tự sắp xếp

Bảng lịch sử tỷ giá (nb_crm_exchange_rates)

Ghi lại dữ liệu tỷ giá lịch sử, tác vụ định kỳ sẽ đồng bộ tỷ giá mới nhất sang nb_cbo_currencies.current_rate.

TrườngKiểuMô tả
idBIGINTKhóa chính
currency_codeVARCHARMã tiền tệ (CNY/EUR/GBP/JPY)
rate_to_usdDECIMAL(10,6)Tỷ giá với USD
effective_dateDATENgày hiệu lực
sourceVARCHARNguồn tỷ giá: manual/api
createdAtTIMESTAMPThời gian tạo

Lưu ý: Phiếu báo giá liên kết với bảng nb_cbo_currencies qua khóa ngoại currency_id, tỷ giá được lấy trực tiếp từ trường current_rate. Cơ hội và Đơn hàng dùng trường currency VARCHAR để lưu mã tiền tệ.

Mẫu trường số tiền

Các bảng có chứa số tiền tuân theo mẫu này:

TrườngKiểuMô tả
currencyVARCHARTiền tệ giao dịch
amountDECIMALSố tiền tiền tệ gốc
exchange_rateDECIMALTỷ giá với USD tại thời điểm giao dịch
amount_usdDECIMALTương đương USD (tính toán)

Áp dụng cho:

  • nb_crm_opportunities.amountamount_usd
  • nb_crm_quotations.total_amounttotal_amount_usd

Tích hợp Workflow

design-2026-02-24-00-21-00

Logic lấy tỷ giá:

  1. Khi có thao tác nghiệp vụ, lấy trực tiếp tỷ giá từ nb_cbo_currencies.current_rate
  2. Giao dịch USD: tỷ giá = 1.0, không cần tra cứu
  3. current_rate được đồng bộ từ bản ghi mới nhất của nb_crm_exchange_rates thông qua tác vụ định kỳ

6.4 Quản lý phiên bản

Khi báo giá bị từ chối hoặc hết hạn, có thể sao chép thành phiên bản mới:

QT-20260119-001 v1 → Đã từ chối
QT-20260119-001 v2 → Đã gửi
QT-20260119-001 v3 → Đã chấp nhận

7. Vòng đời Đơn hàng

7.1 Tổng quan Đơn hàng

Đơn hàng được tạo khi báo giá được chấp nhận, đại diện cho cam kết kinh doanh đã được xác nhận. design-2026-02-24-00-21-21

7.2 Định nghĩa trạng thái Đơn hàng

Trạng tháiMô tảHành động cho phép
NhápdraftĐơn hàng đã tạo, chưa xác nhậnSửa, xác nhận, hủy
Đã xác nhậnconfirmedĐơn hàng đã xác nhận, chờ thực hiệnBắt đầu thực hiện, hủy
Đang xử lýin_progressĐơn hàng đang xử lý/sản xuấtCập nhật tiến độ, gửi hàng, hủy (cần duyệt)
Đã gửishippedSản phẩm đã gửi cho Khách hàngĐánh dấu đã giao
Đã giaodeliveredKhách hàng đã nhận hàngHoàn thành Đơn hàng
Đã hoàn thànhcompletedĐơn hàng hoàn thành đầy đủKhông có
Đã hủycancelledĐơn hàng đã hủyKhông có

7.3 Mô hình dữ liệu Đơn hàng

nb_crm_orders

TrườngKiểuMô tả
idBIGINTKhóa chính
order_noVARCHARSố Đơn hàng (tự sinh, duy nhất)
customer_idBIGINTKhách hàng (FK)
contact_idBIGINTLiên hệ (FK)
opportunity_idBIGINTCơ hội (FK)
quotation_idBIGINTBáo giá (FK)
owner_idBIGINTNgười phụ trách (FK → users)
statusVARCHARTrạng thái Đơn hàng
payment_statusVARCHARTrạng thái thanh toán: unpaid/partial/paid
order_dateDATENgày đặt hàng
delivery_dateDATENgày giao dự kiến
actual_delivery_dateDATENgày giao thực tế
currencyVARCHARTiền tệ Đơn hàng
exchange_rateDECIMALTỷ giá với USD
order_amountDECIMALTổng số tiền Đơn hàng
paid_amountDECIMALSố tiền đã thanh toán
unpaid_amountDECIMALSố tiền chưa thanh toán
shipping_addressTEXTĐịa chỉ giao hàng
logistics_companyVARCHARCông ty vận chuyển
tracking_noVARCHARMã vận đơn
terms_conditionTEXTĐiều khoản và điều kiện
descriptionTEXTMô tả

nb_crm_order_items

TrườngKiểuMô tả
idBIGINTKhóa chính
order_idFKĐơn hàng cha
product_idFKTham chiếu Sản phẩm
product_nameVARCHARSnapshot tên Sản phẩm
quantityINTSố lượng đặt
unit_priceDECIMALĐơn giá
discount_percentDECIMALPhần trăm chiết khấu
line_totalDECIMALTổng dòng
notesTEXTGhi chú dòng

7.4 Theo dõi thu hồi công nợ

nb_crm_payments

TrườngKiểuMô tả
idBIGINTKhóa chính
order_idBIGINTĐơn hàng liên kết (FK, bắt buộc)
customer_idBIGINTKhách hàng (FK)
payment_noVARCHARSố phiếu thanh toán (tự sinh, duy nhất)
amountDECIMALSố tiền thanh toán (bắt buộc)
currencyVARCHARTiền tệ thanh toán
payment_methodVARCHARPhương thức thanh toán: transfer/check/cash/credit_card/lc
payment_dateDATENgày thanh toán
bank_accountVARCHARTài khoản ngân hàng
bank_nameVARCHARTên ngân hàng
notesTEXTGhi chú thanh toán

8. Vòng đời Khách hàng

8.1 Tổng quan Khách hàng

Khách hàng được tạo khi Lead chuyển đổi hoặc Cơ hội thắng đơn. Hệ thống theo dõi vòng đời đầy đủ từ thu hút khách đến người ủng hộ. design-2026-02-24-00-21-34

8.2 Định nghĩa trạng thái Khách hàng

Trạng tháiSức khỏeMô tả
Tiềm năngprospectKhôngLead đã chuyển đổi, chưa có Đơn hàng
Hoạt độngactive≥70Khách hàng trả phí, tương tác tốt
Tăng trưởnggrowing≥80Khách hàng có cơ hội mở rộng
Rủi roat_risk<50Khách hàng có dấu hiệu mất khách
Mất kháchchurnedKhôngKhách hàng không còn hoạt động
Lấy lạiwin_backKhôngKhách hàng cũ đang được kích hoạt lại
Người ủng hộadvocate≥90Hài lòng cao, cung cấp giới thiệu

8.3 Chấm điểm sức khỏe Khách hàng

Tính sức khỏe Khách hàng dựa trên nhiều yếu tố:

Yếu tốTrọng sốChỉ số đo lường
Mức độ gần đây của mua hàng25%Số ngày kể từ Đơn hàng cuối
Tần suất mua hàng20%Số Đơn hàng mỗi giai đoạn
Giá trị tiền tệ20%Tổng và trung bình giá trị Đơn hàng
Mức độ tương tác15%Tỷ lệ mở email, tham gia họp
Sức khỏe hỗ trợ10%Số lượng và tỷ lệ giải quyết Ticket
Sử dụng Sản phẩm10%Chỉ số sử dụng tích cực (nếu áp dụng)

Ngưỡng sức khỏe:

if (health_score >= 90) status = 'advocate';
else if (health_score >= 70) status = 'active';
else if (health_score >= 50) status = 'growing';
else status = 'at_risk';

8.4 Phân nhóm Khách hàng

Phân nhóm tự động

Phân nhómĐiều kiệnHành động đề xuất
VIPGiá trị vòng đời > $100KPhục vụ cao cấp, sponsor cấp cao
Doanh nghiệpQuy mô công ty > 500 ngườiAccount manager riêng
VừaQuy mô công ty 50-500 ngườiThăm hỏi định kỳ, hỗ trợ quy mô
Khởi nghiệpQuy mô công ty < 50 ngườiTài nguyên tự phục vụ, cộng đồng
Ngủ đông90+ ngày không hoạt độngMarketing kích hoạt lại

9. Tích hợp Email

9.1 Tổng quan

NocoBase cung cấp Plugin tích hợp Email tích hợp sẵn, hỗ trợ Gmail và Outlook. Sau khi Email được đồng bộ vào hệ thống, có thể tự động kích hoạt AI phân tích cảm xúc và ý định email thông qua Workflow, hỗ trợ bán hàng nhanh chóng hiểu thái độ Khách hàng.

9.2 Đồng bộ Email

Hộp thư hỗ trợ:

  • Gmail (qua OAuth 2.0)
  • Outlook/Microsoft 365 (qua OAuth 2.0)

Hành vi đồng bộ:

  • Đồng bộ hai chiều email gửi và nhận
  • Tự động liên kết email với bản ghi CRM (Lead, Liên hệ, Cơ hội)
  • File đính kèm lưu trong hệ thống file của NocoBase

9.3 Liên kết Email-CRM (đang hoàn thiện)

design-2026-02-24-00-21-51

9.4 Template Email

Bán hàng có thể sử dụng template cài sẵn:

Loại templateVí dụ
Tiếp xúc lần đầuEmail lạnh, giới thiệu nhiệt tình, theo dõi sự kiện
Theo dõiTheo dõi cuộc họp, theo dõi phương án, nhắc khi không phản hồi
Báo giáBáo giá đính kèm, sửa đổi báo giá, báo giá sắp hết hạn
Đơn hàngXác nhận Đơn hàng, thông báo gửi hàng, xác nhận đã giao
Thành công Khách hàngChào mừng, thăm hỏi, yêu cầu đánh giá

10. Năng lực hỗ trợ AI

10.1 Đội ngũ AI Employee

Hệ thống CRM tích hợp NocoBase AI Plugin, tái sử dụng các AI Employee tích hợp sẵn sau, và cấu hình tác vụ chuyên biệt cho tình huống CRM:

IDTênVị trí tích hợp sẵnNăng lực mở rộng CRM
vizVizNhà phân tích dữ liệuPhân tích dữ liệu bán hàng, dự báo pipeline
daraDaraChuyên gia biểu đồTrực quan hóa dữ liệu, phát triển biểu đồ báo cáo, thiết kế Dashboard
ellisEllisBiên tậpSoạn trả lời email, tóm tắt giao tiếp, soạn email thương mại
lexiLexiPhiên dịchGiao tiếp Khách hàng đa ngôn ngữ, dịch nội dung
orinOrinNgười tổ chứcƯu tiên hằng ngày, gợi ý bước tiếp theo, kế hoạch theo dõi

10.2 Danh sách tác vụ AI

Năng lực AI chia làm hai loại, độc lập với nhau:

Một, AI Employee (Block frontend kích hoạt)

Thông qua Block AI Employee ở frontend, người dùng tương tác trực tiếp với AI qua hội thoại để nhận phân tích và gợi ý.

EmployeeTác vụMô tả
VizPhân tích dữ liệu bán hàngPhân tích xu hướng pipeline, tỷ lệ chuyển đổi
VizDự báo pipelineDự báo doanh thu dựa trên pipeline có trọng số
DaraSinh biểu đồSinh biểu đồ báo cáo bán hàng
DaraThiết kế DashboardThiết kế bố cục Dashboard dữ liệu
EllisSoạn trả lờiSinh trả lời email chuyên nghiệp
EllisTóm tắt giao tiếpTóm tắt thread email
EllisSoạn email thương mạiEmail mời họp, theo dõi, cảm ơn, v.v.
OrinƯu tiên hằng ngàySinh danh sách tác vụ ưu tiên trong ngày
OrinGợi ý bước tiếp theoGợi ý hành động tiếp theo cho mỗi Cơ hội
LexiDịch nội dungDịch tài liệu marketing, phương án, email

Hai, Workflow LLM Node (backend tự động thực thi)

LLM Node được nhúng trong Workflow, kích hoạt tự động qua sự kiện bảng dữ liệu, sự kiện thao tác, tác vụ định kỳ, không liên quan đến AI Employee.

Tác vụCách kích hoạtMô tảTrường ghi vào
Chấm điểm LeadSự kiện bảng dữ liệu (tạo/cập nhật)Đánh giá chất lượng Leadai_score, ai_convert_prob
Dự đoán tỷ lệ thắngSự kiện bảng dữ liệu (đổi giai đoạn)Dự đoán khả năng thành công của Cơ hộiai_win_probability, ai_risk_factors

Lưu ý: Workflow LLM Node sử dụng prompt và Schema xuất JSON có cấu trúc, sau khi parse ghi vào trường dữ liệu nghiệp vụ, không cần người dùng can thiệp.

10.3 Trường AI trong cơ sở dữ liệu

BảngTrường AIMô tả
nb_crm_leadsai_scoreAI điểm 0-100
ai_convert_probXác suất chuyển đổi
ai_best_contact_timeThời gian liên hệ tốt nhất
ai_tagsTag do AI sinh (JSONB)
ai_scored_atThời gian chấm điểm
ai_next_best_actionGợi ý hành động tốt nhất tiếp theo
ai_nba_generated_atThời gian sinh gợi ý
nb_crm_opportunitiesai_win_probabilityAI dự đoán tỷ lệ thắng
ai_analyzed_atThời gian phân tích
ai_confidenceMức độ tin cậy dự đoán
ai_trendXu hướng: up/stable/down
ai_risk_factorsYếu tố rủi ro (JSONB)
ai_recommendationsDanh sách đề xuất (JSONB)
ai_predicted_closeNgày chốt dự đoán
ai_next_best_actionGợi ý hành động tốt nhất tiếp theo
ai_nba_generated_atThời gian sinh gợi ý
nb_crm_customersai_health_scoreĐiểm sức khỏe 0-100
ai_health_gradeCấp độ sức khỏe: A/B/C/D
ai_churn_riskRủi ro mất khách 0-100%
ai_churn_risk_levelCấp độ rủi ro mất khách: low/medium/high
ai_health_dimensionsĐiểm các chiều (JSONB)
ai_recommendationsDanh sách đề xuất (JSONB)
ai_health_assessed_atThời gian đánh giá sức khỏe
ai_tagsTag do AI sinh (JSONB)
ai_best_contact_timeThời gian liên hệ tốt nhất
ai_next_best_actionGợi ý hành động tốt nhất tiếp theo
ai_nba_generated_atThời gian sinh gợi ý

11. Engine Workflow

11.1 Workflow đã hiện thực

Tên WorkflowLoại kích hoạtTrạng tháiMô tả
Leads CreatedSự kiện bảng dữ liệuBậtKích hoạt khi tạo Lead
CRM Overall AnalyticsSự kiện AI EmployeeBậtPhân tích dữ liệu tổng thể CRM
Lead ConversionSự kiện sau thao tácBậtQuy trình chuyển đổi Lead
Lead AssignmentSự kiện bảng dữ liệuBậtTự động gán Lead
Lead ScoringSự kiện bảng dữ liệuTắtChấm điểm Lead (đang hoàn thiện)
Follow-up ReminderTác vụ định kỳTắtNhắc nhở theo dõi (đang hoàn thiện)

11.2 Workflow chờ hiện thực

WorkflowLoại kích hoạtMô tả
Đẩy giai đoạn Cơ hộiSự kiện bảng dữ liệuKhi đổi giai đoạn cập nhật tỷ lệ thắng, ghi thời gian
Phát hiện Cơ hội ngừng trệTác vụ định kỳPhát hiện Cơ hội không hoạt động, gửi nhắc nhở
Duyệt báo giáSự kiện sau thao tácQuy trình duyệt nhiều cấp
Tạo Đơn hàngSự kiện sau thao tácTự động tạo Đơn hàng sau khi báo giá được chấp nhận

12. Thiết kế menu và giao diện

12.1 Cấu trúc backend

MenuLoạiMô tả
DashboardsGroupDashboard
- DashboardPageDashboard mặc định
- SalesManagerPageView Quản lý bán hàng
- SalesRepPageView Nhân viên bán hàng
- ExecutivePageView điều hành
LeadsPageQuản lý Lead
CustomersPageQuản lý Khách hàng
OpportunitiesPageQuản lý Cơ hội
- TableTabDanh sách Cơ hội
ProductsPageQuản lý Sản phẩm
- CategoriesTabPhân loại Sản phẩm
OrdersPageQuản lý Đơn hàng
SettingsGroupCài đặt
- Stage SettingsPageCấu hình giai đoạn Cơ hội
- Exchange RatePageCài đặt tỷ giá
- ActivityPageBản ghi hoạt động
- EmailsPageQuản lý email
- ContactsPageQuản lý Liên hệ
- Data AnalysisPagePhân tích dữ liệu

12.2 View Dashboard

View Quản lý bán hàng

ComponentLoạiDữ liệu
Giá trị pipelineThẻ KPITổng pipeline các giai đoạn
Bảng xếp hạng độiBảngXếp hạng hiệu suất rep
Cảnh báo rủi roDanh sách cảnh báoCơ hội rủi ro cao
Xu hướng tỷ lệ thắngBiểu đồ đườngTỷ lệ thắng theo tháng
Giao dịch ngừng trệDanh sáchGiao dịch cần chú ý

View Nhân viên bán hàng

ComponentLoạiDữ liệu
Tiến độ chỉ tiêu của tôiThanh tiến độThực tế tháng vs chỉ tiêu
Cơ hội cần xử lýThẻ KPISố Cơ hội cần xử lý của tôi
Sắp đóng tuần nàyDanh sáchGiao dịch sắp đóng
Hoạt động quá hạnCảnh báoTác vụ quá hạn
Thao tác nhanhNútGhi nhận hoạt động, tạo Cơ hội

View điều hành

ComponentLoạiDữ liệu
Doanh thu nămThẻ KPIDoanh thu từ đầu năm đến nay
Giá trị pipelineThẻ KPITổng pipeline
Tỷ lệ thắngThẻ KPITỷ lệ thắng tổng thể
Sức khỏe Khách hàngBiểu đồ phân phốiPhân phối điểm sức khỏe
Dự báoBiểu đồDự báo doanh thu theo tháng

Phiên bản tài liệu: v2.0 | Ngày cập nhật: 2026-02-06