Bản Đồ Kiến Trúc & Luồng Hệ Thống SYSTEM WORKFLOW v2026

Trung tâm Chăm sóc Khách hàng - VNPT Cà Mau • OUTBOUND_MONITOR + ZALO-TG + CSKHDB

API Online
Dịch vụ Máy chủ dns
5 Services
Web :8080 • Zalo :5555 • SQL
Giao diện Web web
35 Trang
HTML5 + JS Modules
API Endpoints api
105+ Routes
FastAPI + 5 Sub-Routers
Kịch bản ETL / Bot terminal
24 Pipelines
Task Scheduler (.bat / .py)
Cơ sở dữ liệu database
CSKHDB + 4 DB
SQL Server & SQLite Cache
Từ điển Nghiệp vụ menu_book
6 Chuyên đề
BG • HVC • CKD • CKN • GHTT • BRCĐ
verified Chuẩn Thuật Ngữ Nghiệp Vụ Hệ Thống:
BG = Bán gói HVC = Hội Viên Cao CKD = Chu kỳ dài CKN = Chu kỳ ngắn GHTT = Gia hạn trả trước BRCĐ = Băng rộng cố định

hub Kiến Trúc 5 Tầng Toàn Hệ Thống (End-to-End Data & Control Flow)

Luồng đi từ Nguồn dữ liệu ngoài → Scripts ETL nạp file → SQL Server CSKHDB → FastAPI Server → Giao diện & Bot Zalo/Telegram

d:\FAST_SCAN\OUTBOUND_MONITOR & d:\FAST_SCAN\zalo-tg
TẦNG 1 • DATA SOURCES

Nguồn Dữ Liệu Đầu Vào

  • Google Sheets KPI: Kế hoạch, Thực hiện, Giải trình chế tài đơn lẻ (1k81..., 1a3w...)
  • CCOS VideoCall: Đăng nhập SSO + Gmail IMAP OTP lấy năng suất ĐTV
  • OneBSS & BAOHONG: Phiếu tồn GHTT, GQKN SLA 72h, OB Lắp đặt & Báo hỏng
  • Excel Outbound: File xuất AutoCall CKD, BG, CKN, HVC, Digishop
API / Scraping / CSV / XLSX
TẦNG 2 • ETL & CRAWLERS

Tự Động Hóa Nạp File

  • 02:00 AM Auto: run_import_bsc_kpi_auto_2am.bat (Chi tiết + Tổng hợp + Lũy kế)
  • Năng suất N-1: nangsuatDTV.py → import_nangsuat_snapshot.py
  • AutoCall CKD & BG: import_ob_auto_ckd.py, import_ob_auto_bg.py
  • Loại trừ chế tài: exclude_single_pkg_penalties.py
Windows Task Scheduler
TẦNG 3 • STORAGE

Hệ Quản Trị CSDL

  • SQL Server (CSKHDB): BSC_KPI_CHITIET, BSC_KPI_DAILY, OutBound_KetQua_2026, GHTT_PhieuTon_Thang, PORTAL_ACCOUNTS...
  • outbound_monitor.db: Cache phân quyền báo cáo, cấu hình KPI động, lịch sử QA
  • data_shift_snapshot & timeline: SQLite lưu ca trực & timeline realtime PDTT
pyodbc + sqlite3
TẦNG 4 • BACKEND API

FastAPI Server (:8080)

  • Main Gateway: ext_pdtt_watch/server_api.py
  • 5 Sub-Routers: employee_auth_api, kpi_dynamic_api, call_eval_api, survey_ocr_api, kpi_giao_api
  • Cloudflare Tunnel: Public qua api.autocall-monitor.com
Uvicorn ASGI • Port 8080/8787
TẦNG 5 • CLIENTS & BOTS

Giao Diện & Bot Điểm Tin

  • Web Portals: index.html, dashboard_layout.html, employee_portal.html (Cloudflare Pages + Local)
  • Bot Điểm tin Zalo-TG: Chụp ảnh màn hình qua LAN 192.168.x.x đẩy vào nhóm Zalo & Telegram
  • AI Call Evaluator: Gemini Hybrid chấm điểm ghi âm ĐTV
ttcskhcamau.com

shield_person Ma Trận Luồng Đăng Nhập & Phân Quyền Truy Cập (RBAC Matrix)

Kiểm soát bởi public/auth_guard.js, public/employee_login.html và ext_pdtt_watch/employee_auth_api.py

Đã đồng bộ chuẩn RBAC & Quyền Báo cáo Per-User
Vai trò (Role) Trang Đăng nhập Trang Đích sau Login Phạm vi Trang được phép truy cập Cơ chế Phân quyền Đặc biệt
admin employee_login.html index.html Toàn bộ 35+ trang hệ thống, bao gồm admin_accounts.html và admin_system_workflow.html. Cấp quyền role, reset mật khẩu, đồng bộ nhân sự, tích chọn báo cáo per-user (/api/dashboard-permissions).
supervisor employee_login.html index.html Tất cả trang điều hành, báo cáo BSC KPI, AutoCall, HRM, Giao KPI (admin_kpi_giao.html). Trừ admin_accounts.html. Thấy toàn bộ 27 báo cáo trên dashboard_layout.html mà không bị lọc.
sc_all employee_login.html index.html Cổng index.html, dashboard_layout.html, toàn bộ chuyên đề GHTT, Digishop, Thu cước + Hồ sơ cá nhân. Mặc định mở khóa GHTT + Digishop + Thu cước trong Command Center + thêm các báo cáo Admin cấp riêng.
sc_ghtt employee_login.html index.html Chuyên trách Gia hạn trả trước (GHTT): ghtt_phieuton.html, ghtt_dashboard.html, dashboard_layout.html, employee_portal.html. Vừa xem được trang cá nhân/BSC, vừa điều hành phiếu tồn & dashboard GHTT BRCĐ.
sc_digishop employee_login.html index.html Chuyên trách Digishop: digishop_donhang.html, digishop_dashboard.html, dashboard_layout.html, employee_portal.html. Giám sát SLA 72h đơn hàng Digishop và tra cứu BSC cá nhân.
sc_thucuoc employee_login.html index.html Chuyên trách Thu cước: dieuhanh_thucuoc_dashboard.html, dashboard_layout.html, employee_portal.html. Theo dõi điều hành thu cước số hóa và hồ sơ cá nhân.
employee employee_login.html employee_portal.html?hrm=... employee_portal.html, employee_bsc.html, employee_expired.html + Các trang được Admin cấp quyền riêng. auth_guard.js đối chiếu emp_allowed_pages từ /api/dashboard-permissions trước khi chặn.
LAN Bot (192.168.x.x) Bỏ qua Login (Auto-Inject) Mọi trang báo cáo đích Toàn quyền truy cập trực tiếp các trang Dashboard khi gọi từ localhost, 127.0.0.1, 192.168.*. auth_guard.js (L34-41) tự gán emp_role='admin' để Bot điểm tin Zalo-TG chụp màn hình tự động.