CRM ABBMB: dùng hằng ngày và đọc dữ liệu từ kho BigQuery

01 · Kiến trúc

Các thành phần và vì sao chọn

Mọi thứ chạy trên một máy chủ ảo Google Cloud ở Singapore (asia-southeast1). Không có thành phần nào lưu dữ liệu ngoài vùng này, trừ trợ lý AI đọc theo yêu cầu (pháp chế đã cho phép).

02 · Người dùng

Dùng CRM hằng ngày

Giao diện bằng tiếng Anh; tên nút và menu dưới đây giữ nguyên như trên màn hình. Ứng dụng nằm ở menu trên cùng bên trái: ABB CRM.

Đăng nhập lần đầu

• Tài khoản là của riêng bạn — không dùng chung. Chủ CRM gửi riêng cho bạn tên đăng nhập và mật khẩu tạm; đăng nhập rồi đổi mật khẩu ngay.
• Bật xác thực hai lớp: avatar → My Preferences → Account Security.
• Thông báo hiện trong Odoo (chuông, Discuss), không gửi qua email.

Vai trò

Ghi một cuộc gặp

ABB CRM → Meeting Notes → New. Điền 7 phần theo mẫu ABB — phần in đậm là bắt buộc:

• ABB Attendees (mặc định là bạn) cũng bắt buộc. Phần Contact details ghi thông tin liên hệ mới nhận.
• Người mới (New person) hoặc liên hệ đổi thông tin (Contact update) đều vào Pending Review cho Quản lý duyệt — không có liên hệ nào tự sinh sau lưng bạn.

Việc theo dõi

Trên biên bản bấm Schedule follow-up, chọn người, việc, hạn. Việc hiện ở My Activities (biểu tượng đồng hồ) của người được giao; đánh dấu xong ở đó.

Tìm lại

• Meeting Notes: bộ lọc My notes, This week, nhóm theo Year; tìm theo công ty, người hoặc chữ.
• Companies / Contacts: nút Meeting Notes trên một công ty liệt kê mọi cuộc gặp với công ty đó. Salesperson trên công ty = người phụ trách phía ABB.
• Legacy Deals: deal từ CRM cũ, chỉ đọc.

03 · Dữ liệu cũ

Lịch sử PipelineDeals

Dữ liệu cũ được nạp ngày 12/10/2026 sau 22 cổng kiểm chất lượng và một vòng duyệt 100 bản ghi mẫu (0 lỗi nghiêm trọng).

04 · Trợ lý AI

Claude đọc CRM — không ghi được gì

Claude (ứng dụng Desktop hoặc Claude Code trên máy tính) kết nối CRM qua một máy chủ MCP nhỏ chạy trên chính máy của bạn, đi qua đường hầm bảo mật của Google tới máy chủ CRM. Giao diện web của CRM không mở thêm cổng nào cho việc này.

Hỏi thế nào

05 · Luồng chạy

Từ Odoo tới BigQuery trong năm bước

Toàn bộ chạy trên máy chủ CRM, do một bộ hẹn giờ của hệ điều hành (systemd timer) kích hoạt. Không có máy nào khác tham gia.

06 · Mô hình dữ liệu

Bảng, view và cột

Mọi bảng dữ liệu đều có cột snapshot_date (DATE). Quan hệ nhiều-một (ví dụ công ty của một biên bản) được lưu bằng id số của bản ghi đích. Số dòng là của ảnh chụp 18/10/2026.

Mọi bảng còn có create_date, write_date (TIMESTAMP) và hai cột kỹ thuật của dlt (_dlt_load_id, _dlt_id).

View dựng sẵn — nên dùng thay cho bảng con

07 · Truy vấn

Ba quy tắc để không đếm sai

Thay PROJECT_ID bằng mã project Google Cloud của CRM (hỏi chủ CRM). Mọi ví dụ chạy được trong BigQuery Studio với vùng asia-southeast1.

Ngày chụp hợp lệ mới nhất

-- ngày có đủ 5 bảng và cả 5 đều ok
select snapshot_date
from `PROJECT_ID.abbmb_dwh._snapshot_check`
group by snapshot_date
having count(*) = 5 and logical_and(ok)
order by snapshot_date desc
limit 1;

Số cuộc gặp theo công ty và năm

declare d date default (
  select snapshot_date from `PROJECT_ID.abbmb_dwh._snapshot_check`
  group by 1 having count(*) = 5 and logical_and(ok)
  order by 1 desc limit 1);

select c.name as company,
       extract(year from n.date) as year,
       count(*) as meetings
from `PROJECT_ID.abbmb_dwh.abb_meeting_note` n
join `PROJECT_ID.abbmb_dwh.res_partner` c
  on c.id = n.partner_company_id and c.snapshot_date = d
where n.snapshot_date = d and n.active
group by company, year
order by year desc, meetings desc;

Số công ty trong từng Company Group

declare d date default (
  select snapshot_date from `PROJECT_ID.abbmb_dwh._snapshot_check`
  group by 1 having count(*) = 5 and logical_and(ok)
  order by 1 desc limit 1);

select g.name as company_group, count(distinct b.left_id) as companies
from `PROJECT_ID.abbmb_dwh.bridge__res_partner__abb_company_group_ids` b
join `PROJECT_ID.abbmb_dwh.abb_company_group` g
  on g.id = b.right_id and g.snapshot_date = b.snapshot_date
join `PROJECT_ID.abbmb_dwh.res_partner` p
  on p.id = b.left_id and p.snapshot_date = b.snapshot_date
where b.snapshot_date = d and p.is_company and p.active
group by company_group
order by companies desc;

Biên bản mới hoặc sửa giữa hai ngày chụp

select n.id, n.date, n.name, n.write_date
from `PROJECT_ID.abbmb_dwh.abb_meeting_note` n
where n.snapshot_date = '2026-10-18'
  and n.write_date >= timestamp('2026-10-17 03:30:00', 'Asia/Ho_Chi_Minh')
order by n.write_date desc;

08 · Kiểm tra & bảo mật

Kho tự kiểm mỗi đêm và báo khi sai

Một ảnh chụp chỉ được coi là đúng khi, với từng bảng: số dòng = số id khác nhau = số bản ghi Odoo tự đếm được lúc chụp. Kết quả ghi ở _snapshot_check (cột snapshot_date, table_name, model, rows, distinct_ids, expected, ok, checked_at).

Đã đo trước khi bật trên production

Ai đọc được

• Hiện chỉ chủ dự án. Thêm một người hay một công cụ BI = một quyết định ghi lại, cấp quyền BigQuery Data Viewer ở mức dataset, không bao giờ ở mức project.
• Tài khoản dịch vụ của máy chủ chỉ ghi được vào hai dataset của kho, không có vai trò rộng nào ở mức project.
• Dữ liệu cá nhân được giữ nguyên (không băm, không cắt) theo ý kiến pháp chế; vì thế quyền đọc là lớp bảo vệ chính.

09 · Vận hành

Cho người vận hành CRM

Mọi thay đổi hạ tầng là file trong bộ khung + biến trong file cấu hình tenant, đưa lên bằng script. Không sửa tay trên máy chủ.

10 · Giới hạn

Những gì kho chưa làm

Biết trước để không hỏi kho một câu nó không trả lời được.