Phần mềm giám sát xe ra vào

TÀI LIỆU MÃ NGUỒN VÀ GIAO DIỆN PHẦN MỀM PHẦN MỀM KIỂMSOÁT XE RA VÀO

Image Description

TNV

I.  THÔNG TIN CƠ BẢN

      Tên phần mềm: Phần mềm kiểm soát xe ra vào

  • Phiên bản: 1.0 (Bản thương mại nâng cấp)
  • Ngày hoàn thành: 15/06/2026
  • Ngày công bố: 16/06/2026
  • Ngôn ngữ lập trình & Công nghệ chính:

      Backend: Node.js (Express.js v4), JavaScript ES2022

  • Frontend: js 18 (Vite), JavaScript/JSX, Tailwind CSS
  • Cơ sở dữ liệu: MongoDB (Mongoose), Redis (Cache & Session)

      Hạ tầng bổ trợ: BullMQ (queue), Socket.IO (realtime), Playwright (PDF)

II.  MÔ TẢ CHỨC NĂNG PHẦN MỀM (THEO MODULE)

Phần mềm kiểm soát xe ra vào

được phân tách thành các module nghiệp vụ hoàn chỉnh nhằm tối ưu hóa công tác quản lý:

  1. Kiểm soát ra vào làn tự động: Tiếp nhận webhook từ camera, so khớp biển số/khuôn mặt và gửi tín hiệu đóng mở barrier tự động.
  2. Đa vendor thiết bị: Tương thích đồng thời chuẩn API của Hikvision (HIK) và BAE
  3. Quản lý kế hoạch công việc: Cho phép hãng vận tải đăng ký trước danh sách người, phương tiện và khoảng thời gian xe qua chốt.
  4. Đồng bộ dữ liệu sinh trắc học: Tự động đẩy dữ liệu khuôn mặt tài xế xuống máy chấm công (MCC) ở các làn tương ứng.
  5. Phân hệ Hải quan & Tờ khai: Quản lý tờ khai hải quan, đối soát lượt xe và xuất báo cáo nén định dạng
  6. Giao diện vận hành thời gian thực (Guard Console): Giám sát camera và can thiệp mở chốt thủ công tức thời dành cho bảo vệ.

III.  SƠ ĐỒ VÀ MÔ TẢ KIẾN TRÚC HỆ THỐNG

Hệ thống được thiết kế theo kiến trúc hướng sự kiện (Event-Driven Architecture) nhằm đáp ứng nhu cầu xử lý thời gian thực từ thiết bị ngoại vi và đồng bộ dữ liệu tức thời lên bảng điều khiển bảo vệ:

Thành phần

Vai trò trong hệ thống

Phương thức kết nối & Giao thức

Thiết bị ngoại vi (Camera AI)

Chụp ảnh làn xe, nhận diện biển số xe (OCR) và khuôn mặt tài xế

Webhook (HTTP POST) dạng JSON hoặc XML Multipart/mixed

Thiết bị ngoại vi (MCC khuôn mặt)

Máy chấm công khuôn mặt kiểm soát làn đi bộ và ra vào chốt gác

HTTP Client (ISAPI API / BAE API) nạp dữ liệu sinh trắc học

Backend API (Express.js)

Tiếp nhận webhook, phân tích payload cấu trúc đa vendor và phân loại sự kiện

 

API RESTful bảo mật, lọc trùng lập dữ liệu

 

BullMQ Queue & Redis

Hàng đợi quản lý các tác vụ phân tích, đối soát bất đồng bộ

Bộ nhớ Cache Redis (In-Memory Database)

 

Worker xử lý đối soát

So khớp thông tin xe/người với kế hoạch công việc đã duyệt và điều khiển barrier

Mongoose ODM kết nối MongoDB / Redis lock chống race condition

SSE / Socket.IO Service

Đẩy thông tin sự kiện và kết quả đối soát thời gian thực lên giao diện

Server-Sent Events (SSE) / WebSockets truyền tải dữ liệu

Guard Console (Frontend)

Giao diện React hiển thị trực quan các làn xe và điều khiển mở cổng thủ công

Trình duyệt Client-side (Desktop / Mobile responsive)
  • Môi trường chạy:
  • js: >= 18.x LTS
  • MongoDB: >= 0
  • Redis: >= 0
  • Hệ điều hành: Linux (Ubuntu 22.04+) / macOS / Docker
  • Cấu hình triển khai:
  • Backend: `cd backend && npm install && npm run start`
  • Frontend: `cd frontend && npm install && npm run build` -> phục vụ từ thư mục `dist/` thông qua
  • Biến môi trường: Cấu hình tệp tin `.env` (PORT, MONGO_URI, REDIS_URL, JWT_SECRET).
  • Hạ tầng bổ trợ:

      Nginx: Reverse proxy, SSL termination.

  • PM2: Quản lý tiến trình (Process manager) cho Node.js

Share:

Các tin khác