How huyhoang292/doantotnghiep works
This is a traffic-violation management platform: officers review camera/AI detections, verify or reject violations, and issue invoices; citizens use the web app to manage vehicles and view violations and invoices. The architecture combines a React frontend, Express API, AI plate-recognition service, and MySQL storage. The README documents the major workflow and service boundaries; source excerpts show selected routes, controller actions, and recognition logic, but not every frontend/API call or database configuration detail.
Main entry points: officerController.js Officer operations · violationController.js Violation processing · database.config.js MySQL data · officerRoutes.js Officer routes
Components 20
Web application
- Web client
frontend/src/main.tsx - Route tree
frontend/src/routeTree.gen.ts - Officer workspace
frontend/src/routes/officer/scan.tsx - Citizen workspace
frontend/src/routes/citizen/dashboard.tsx - API client
frontend/src/lib/api.ts
Backend API
- HTTP server
backend/src/server.js - Officer routes
backend/src/routes/officerRoutes.js - Citizen routes
backend/src/routes/citizenRoutes.js - Authentication
backend/src/middlewares/authMiddleware.js - Officer operations
backend/src/controllers/officerController.js - Violation processing
backend/src/controllers/violationController.js - Citizen operations
backend/src/controllers/citizenController.js - Response mapping
backend/src/utils/mappers.js - Recognition adapter
backend/src/services/plateRecognition.js
Plate recognition
- AI detection API
ai-service/main.py - Plate text assembly
ai-service/plate_utils.py
Operational data
- MySQL data
backend/src/db/database.config.js
Other components
- Traffic officer
- Citizen
- Camera system
Connections 27
- Traffic officer → Web client: uses
- Citizen → Web client: uses
- Camera system → AI detection API: submits frames
- Web client → Route tree: loads routes
frontend/src/main.tsx - Officer workspace → API client: requests data
- Citizen workspace → API client: requests data
- API client → HTTP server: calls API
- HTTP server → Officer routes: mounts
backend/src/server.js - HTTP server → Citizen routes: mounts
backend/src/server.js - Officer routes → Authentication: checks token
backend/src/routes/officerRoutes.js - Citizen routes → Authentication: checks token
backend/src/routes/citizenRoutes.js - Officer routes → Officer operations: dispatches
backend/src/routes/officerRoutes.js - Officer routes → Violation processing: dispatches
backend/src/routes/officerRoutes.js - Citizen routes → Citizen operations: dispatches
backend/src/routes/citizenRoutes.js - Officer operations → MySQL data: reads and writes
- Violation processing → MySQL data: reads and writes
- Citizen operations → MySQL data: reads and writes
- Officer operations → Recognition adapter: recognizes plates
backend/src/controllers/officerController.js - Officer operations → Response mapping: maps records
backend/src/controllers/officerController.js - Violation processing → Response mapping: maps records
backend/src/controllers/violationController.js - Citizen operations → Response mapping: maps records
backend/src/controllers/citizenController.js - Recognition adapter → AI detection API: calls service
- AI detection API → Plate text assembly: assembles text
ai-service/main.py - AI detection API → MySQL data: stores detections
- Officer operations → Violation processing: promotes detections
- Violation processing → MySQL data: creates invoices
- Citizen workspace → Officer operations: views violations