Tổng Quan Hệ Thống & Kiến Trúc Triển Khai
🎯 Bối Cảnh & Mục Tiêu Thực Tế
Trong công tác tín dụng, cán bộ quan hệ khách hàng (RM) và cán bộ thẩm định thường xuyên phải ngoại kiểm tại địa bàn (nơi cư trú, thửa đất, cơ sở sản xuất kinh doanh):
- Chụp ảnh thực địa chất lượng cao: Cần ảnh rõ nét từng con dấu đỏ, chữ ký, số thửa đất, ranh mốc trích lục mà mạng xã hội thường làm vỡ hạt.
- Ghim vị trí vệ tinh Google Maps: Nhớ chính xác tọa độ GPS thửa đất/nhà xưởng để dẫn đường 1-chạm khi lãnh đạo tái kiểm tra.
- Quản lý theo đối tượng khách hàng: Tự động phân tách Khách hàng Cá nhân (CCCD) và Khách hàng Doanh nghiệp (MST / ĐKKD).
- Bàn giao địa bàn không đứt đoạn: Khi chuyển giao nhân sự, toàn bộ dữ liệu KH, folder ảnh và lịch hẹn được chuyển giao trọn vẹn chỉ sau 1 click chuột.
🌐 Thông Số Kết Nối & Hạ Tầng
| Cổng dịch vụ: | Port 9897 (Tên gọi nội bộ: Cổng 97) |
| Mạng nội bộ (LAN): | http://192.168.100.2:9897 |
| Truy cập Internet (WAN / 4G): | http://222.253.52.63:9897 |
| Cơ sở dữ liệu chính: | PostgreSQL 18 (Database: ThongTinKH) |
| Cơ chế dự phòng (Fallback): | Local JSON Dual Storage (local_data.json) |
| Thư mục lưu trữ ảnh thực địa: | Ổ đĩa mạng an toàn e:\SMB\Backup\TTKH\uploads |
Phân Loại Khách Hàng & Quản Lý Thư Mục Ảnh JPG Siêu Nét
👤 Khách Hàng Cá Nhân (KHCN)
- Định danh cốt lõi: Số Căn cước công dân (CCCD) 12 số chuẩn quốc gia.
- Tự động tạo thư mục riêng biệt: Lưu trữ tự động tại đường dẫn:
/uploads/customers/{CCCD_12_SO}/. - Phân nhóm ảnh trực quan:
- Hồ sơ pháp lý: Mặt trước/sau CCCD, Giấy chứng nhận quyền sử dụng đất (Sổ hồng, Sổ đỏ), Hộ khẩu/Xác nhận cư trú.
- Thực địa tài sản: Ngoại quan nhà đất, đường sá trước nhà, nội thất, hiện trạng sử dụng.
🏢 Khách Hàng Doanh Nghiệp (KHDN)
- Định danh cốt lõi: Số Đăng Ký Kinh Doanh (ĐKKD) / Mã số thuế (MST).
- Tự động tạo thư mục riêng biệt: Lưu trữ tự động tại đường dẫn:
/uploads/customers/{SO_DKKD_MST}/. - Phân nhóm ảnh chuyên sâu:
- Pháp lý doanh nghiệp: Giấy phép ĐKKD, Điều lệ, CCCD Người đại diện pháp luật.
- Thực địa cơ sở sản xuất: Nhà xưởng, kho bãi, dây chuyền máy móc thiết bị, tồn kho hàng hóa.
Bản Đồ Số Thực Địa & Dẫn Đường 1-Chạm
📍 Thu Thập Tọa Độ GPS Tự Động Tại Chỗ
Khi cán bộ tác nghiệp ngoại kiểm đứng tại vị trí tài sản bảo đảm:
- Định vị vệ tinh 1-chạm: Nút
Lấy tọa độ hiện tạitự động đọc chip GPS của thiết bị di động với độ chính xác dưới 5 mét. - Lọc địa chỉ tự động: Tự động reverse geocoding điền sẵn Tên đường, Phường/Xã, Quận/Huyện, Tỉnh/Thành phố.
- Lưu trữ vĩnh viễn: Tọa độ vĩ độ (Lat) và kinh độ (Lng) gắn liền với hồ sơ tài sản của khách hàng trong CSDL.
🚗 Tính Năng "Dẫn Đường 1-Chạm" (Google Maps)
Giải quyết triệt để khó khăn khi tìm kiếm các thửa đất ở vùng ven, hẻm sâu hoặc khu công nghiệp:
- Mở trực tiếp Google Maps App: Bấm nút "Dẫn đường", hệ thống tự động mở Google Maps trên điện thoại hoặc máy tính.
- Chỉ đường thời gian thực: Dẫn đường bằng giọng nói cho Lãnh đạo đi kiểm tra thực địa đột xuất hoặc cán bộ Hỗ trợ tín dụng (HTTD) đi công chứng/đăng ký thế chấp.
- Giao diện bản đồ đa chế độ: Hỗ trợ bản đồ Vệ tinh (Satellite), Giao thông (Roadmap) và Chế độ thực địa trực quan.
Đến Hiện Trường
Cán bộ RM đến vị trí nhà đất hoặc cơ sở kinh doanh của khách hàng.
Chụp Ảnh & Bấm GPS
Chụp ảnh ngoại quan sắc nét và bấm nút lấy tọa độ GPS tự động.
Lưu Hồ Sơ Khách Hàng
Hồ sơ, vị trí ghim bản đồ và thư mục ảnh tự động đồng bộ lên máy chủ Chi nhánh.
Sẵn Sàng Dẫn Đường
Cấp quản lý hoặc đồng nghiệp tra cứu và dẫn đường đến hiện trường tức thì.
Tính Năng Bàn Giao Khách Hàng Hàng Loạt
📦 Thao Tác Bàn Giao Hàng Loạt (Bulk Handover)
- Tích chọn linh hoạt: Cho phép chọn 1, nhiều hoặc toàn bộ danh sách khách hàng của cán bộ cũ.
- Chọn Cán bộ tiếp nhận: Dropdown danh sách cán bộ cùng phòng ban hoặc cán bộ phòng ban khác trong Chi nhánh.
- Chuyển giao trọn vẹn 100% tài nguyên:
- Thông tin định danh KH (CCCD / MST, số điện thoại, địa chỉ).
- Tọa độ GPS và vị trí ghim bản đồ đã lưu.
- Toàn bộ thư mục ảnh thực địa đã chụp.
- Lịch hẹn chăm sóc và nhật ký trao đổi công việc.
📜 Lưu Vết Kiểm Toán & Biên Bản Bàn Giao
- Audit Trail minh bạch: Ghi lại chi tiết: Cán bộ bàn giao, Cán bộ tiếp nhận, Thời gian bàn giao, Số lượng KH chuyển giao và Lý do bàn giao.
- Email thông báo tự động: Hệ thống tự động gửi email thông báo danh sách khách hàng mới tới hòm thư của cán bộ tiếp nhận.
- Loại bỏ hoàn toàn rủi ro thất lạc: Cán bộ mới tiếp quản ngay lập tức địa bàn mà không cần đọc lại các file Excel cũ, đảm bảo hoạt động kinh doanh diễn ra liên tục.
Bảng Lịch Song Hành Âm Dương & Ghi Chú Cá Nhân
🌙 Thuật Toán Âm Lịch Thiên Văn Học Việt Nam
Gắn liền với tâm lý kinh doanh của khách hàng Việt (chú trọng ngày tốt, ngày xuất hành, ngày ký HĐTD):
- Hiển thị song hành trên từng ô ngày: Số ngày Dương lịch in đậm lớn bên trái, ngày Âm lịch nhỏ tinh tế bên phải.
- Tô màu nổi bật các ngày quan trọng: Tự động nhận diện và tô màu đỏ may mắn cho ngày Mùng 1, ngày Rằm (15 Âm) và ngày Vía Thần Tài (Mùng 10 tháng Giêng).
- Trực quan hóa lịch hẹn khách hàng: Hiển thị badge khách hàng cần liên hệ, thẩm định thực địa hoặc ngày hẹn giải ngân ngay trên ô lịch.
📌 Phân Hệ Ghi Chú Cá Nhân (Personal Notes)
Dành riêng cho cán bộ ghi nhớ kế hoạch chăm sóc khách hàng và công việc nội bộ:
- Bảo mật 100% riêng tư: Chỉ duy nhất tài khoản người tạo mới nhìn thấy và quản lý ghi chú của mình. Không hiển thị cho đồng nghiệp hay cấp quản lý.
- Huy hiệu tím 📌 trên ô lịch: Giúp cán bộ nhận biết nhanh ngày có việc cần xử lý.
- Tùy chọn nhắc nhở qua Email: Tích hợp tùy chọn gửi email nhắc hẹn vào sáng sớm ngày làm việc qua hệ thống Mail Relay.
Ma Trận Phân Quyền 7 Cấp & Báo Cáo KPI
| Cấp bậc | Vai trò & Chức danh | Phạm vi dữ liệu | Thẩm quyền nghiệp vụ |
|---|---|---|---|
| Level 1 | Quản Trị Hệ Thống SYS_ADMIN |
Toàn hệ thống | Quản trị người dùng, phân quyền, cấu hình thư mục upload ảnh, giám sát Audit Log và sao lưu toàn hệ thống. |
| Level 2 | Quản Trị Chi Nhánh BRANCH_ADMIN |
Toàn Chi nhánh Nam Sài Gòn | Tạo tài khoản, mở khóa người dùng, phân phòng ban, điều phối bàn giao khách hàng trong chi nhánh. |
| Level 3 & 4 | Ban Giám Đốc Chi Nhánh DIRECTOR / HQ |
Toàn Chi nhánh / TSC | Xem toàn bộ dữ liệu KH, theo dõi bản đồ số tài sản bảo đảm, đánh giá báo cáo thực địa của các phòng ban. |
| Level 5 & 6 | Trưởng / Phó Phòng Ban DEPT_HEAD |
Toàn bộ Phòng ban phụ trách | Quản lý danh sách KH toàn phòng, duyệt kết quả thực địa, điều chuyển khách hàng giữa các cán bộ RM trong phòng. |
| Level 7 | Cán Bộ Tín Dụng (RM) OFFICER |
Khách hàng do chính mình quản lý | Thêm mới KH, chụp ảnh thực địa, lấy tọa độ GPS, ghim vị trí bản đồ, đặt lịch hẹn và bàn giao khách hàng. |
Chính Sách Bảo Mật & Quản Trị Tài Khoản
🔒 Khóa Tự Động 14 Ngày Không Đăng Nhập
- Phạm vi áp dụng: Tự động khóa các tài khoản từ Cấp 3 trở lên (Level ≥ 3: Ban Giám đốc, Lãnh đạo phòng, Cán bộ RM) nếu không đăng nhập trong 14 ngày liên tiếp.
- Lịch quét cố định duy nhất lúc 07:00 sáng: Cron job
0 7 * * *(Asia/Ho_Chi_Minh) chỉ chạy đúng 1 lần/ngày. Tuyệt đối không quét ngầm trong ngày hay can thiệp khi cán bộ đang đăng nhập. - Ngoại lệ an toàn: Tuyệt đối KHÔNG BAO GIỜ KHÓA tài khoản Quản trị viên Level 1 (Quản trị hệ thống) và Level 2 (Quản trị chi nhánh).
- Cảnh báo email tức thì: Gửi email cảnh báo danh sách tài khoản bị khóa do quá 14 ngày tới Quản trị viên Level 1 & Level 2.
🔓 Cơ Chế Mở Khóa Nhanh & Gia Hạn Chu Kỳ Mới
- Nút "Mở khóa" 1-Chạm: Bố trí ngay cạnh nút "Reset MK" trong bảng danh sách người dùng, tự động nổi bật khi tài khoản bị khóa để Admin mở khóa tức thì mà không cần mở form sửa.
- Làm mới chu kỳ 14 ngày: Khi Admin bấm Mở khóa, Tạo mới tài khoản, Chuyển sang Hoạt động hoặc Reset MK, hệ thống tự động:
- Thiết lập
active = true. - Xóa bộ đếm sai mật khẩu
fail_count = 0vàlock_until = NULL. - Cập nhật
last_login = NOW(), cấp ngay chu kỳ 14 ngày mới giúp cán bộ đăng nhập bình thường mà không bị khóa lại.
- Thiết lập
Hướng Dẫn Vận Hành & Sao Lưu Dữ Liệu
⚙️ Các Lệnh Vận Hành Cơ Bản
Mã nguồn hệ thống đặt tại thư mục: d:\DuLK\TTKH
# Khởi động thủ công: d: cd \DuLK\TTKH node server.js # Hoặc khởi động lại nhanh chạy ngầm: d:\DuLK\TTKH\khoi_dong_lai_server.bat
📦 Cơ Chế Dual Storage & Lưu Trữ Ảnh An Toàn
- Dual Storage: Cơ sở dữ liệu chính PostgreSQL 18 kèm cơ chế tự động đồng bộ sang file JSON dự phòng
local_data.json. - Lưu trữ ảnh tập trung: Toàn bộ thư mục ảnh chụp thực địa được lưu trữ tập trung tại ổ đĩa mạng chia sẻ
e:\SMB\Backup\TTKH\uploads. - Chạy ngầm thường trực: File
d:\DuLK\DK_CongTac\chay_ngam.vbstự động giám sát và duy trì hoạt động liên tục 24/7 của Cổng 97.
🎉 CỔNG 97 ĐÃ HOẠT ĐỘNG ỔN ĐỊNH & SẴN SÀNG PHỤC VỤ
Mọi thắc mắc và yêu cầu hỗ trợ kỹ thuật, xin vui lòng liên hệ Ban Quản trị CNTT - VietinBank Chi nhánh Nam Sài Gòn.