Hệ thống tra cứu thông tin vi phạm giao thông trực tuyến, cho phép người dùng kiểm tra nhanh chóng các thông tin về phạt nguội và vi phạm giao thông. Dự án sử dụng các công nghệ hiện đại để cung cấp trải nghiệm người dùng tốt nhất và thông tin chính xác về vi phạm giao thông.
- 🚀 Tra cứu thông tin vi phạm giao thông trực tuyến
- 🔔 Hệ thống thông báo qua email khi có vi phạm mới
- 📱 Giao diện responsive, tương thích mọi thiết bị
- ⚡ Tốc độ tra cứu nhanh chóng
- 🔒 Bảo mật thông tin người dùng
- Hỗ trợ nhiều định dạng biển số xe (VD: 11H1-1111, 11H11111, 11H-1111, 11H1111, 11HH11111, 11HH1111)
- Hiển thị thông tin chi tiết về vi phạm:
- Thời gian và địa điểm vi phạm
- Loại phương tiện và màu biển số
- Hành vi vi phạm cụ thể
- Đơn vị phát hiện vi phạm
- Địa điểm giải quyết vi phạm
- Trạng thái xử lý vi phạm
- Đăng ký nhận thông báo qua email
- Tự động gửi email khi phát hiện vi phạm mới
- Xác nhận đăng ký qua email
- Quản lý đăng ký thông báo dễ dàng
- Thiết kế hiện đại với Tailwind CSS
- Responsive trên mọi thiết bị
- Hiệu ứng chuyển động mượt mà
- Biểu tượng trực quan với Lucide Icons
- Loading states và error handling thân thiện
-
Frontend:
- Next.js 15 - Framework React hiện đại
- React 19 - Thư viện JavaScript cho UI
- TypeScript - JavaScript với kiểu dữ liệu tĩnh
- Tailwind CSS - Framework CSS tiện ích
- Lucide Icons - Bộ icon đẹp và nhẹ
-
Backend:
- MongoDB - Cơ sở dữ liệu NoSQL
- API Routes - Next.js API endpoints
- Email Service - Hệ thống gửi email tự động
- Clone dự án:
git clone https://github.com/minhomega/phatnguoi.git- Di chuyển vào thư mục dự án:
cd phatnguoi- Cài đặt dependencies:
npm install
# hoặc
yarn install
# hoặc
pnpm install- Tạo file môi trường:
cp .env.example .env-
Cấu hình các biến môi trường trong file
.env -
Chạy dự án:
# Môi trường development
npm run dev
# hoặc
yarn dev
# hoặc
pnpm dev
# Build cho production
npm run build
# hoặc
yarn build
# hoặc
pnpm build
# Chạy production
npm run start
# hoặc
yarn start
# hoặc
pnpm startDự án được triển khai trên Vercel. Để triển khai:
- Nhấn nút "Deploy" ở trên để fork và triển khai tự động, hoặc:
- Đẩy code lên GitHub
- Kết nối repository với Vercel
- Vercel sẽ tự động triển khai khi có thay đổi trên nhánh main
Lưu ý: Đảm bảo đã cấu hình đầy đủ các biến môi trường trong phần Environment Variables của Vercel:
MONGODB_URI: URL kết nối MongoDBMAIL_SERVICE: Dịch vụ email (mặc định: gmail)MAIL_HOST: Host SMTP (mặc định: smtp.gmail.com)MAIL_PORT: Port SMTP (mặc định: 465)MAIL_USER: Email đăng nhập SMTPMAIL_PASSWORD: Mật khẩu email SMTPNEXT_PUBLIC_API_URL: URL API của ứng dụngCRON_SECRET: Khóa bí mật cho Cron JobUNSUBSCRIBE_SECRET: Khóa bí mật cho chức năng hủy đăng kýNEXT_PUBLIC_APP_URL: URL của ứng dụng (mặc định là URL của Vercel sau khi deploy)
Các biến môi trường cần thiết trong file .env:
# MongoDB
MONGODB_URI=your_mongodb_connection_string
# Email Service
MAIL_SERVICE=your_email_service
MAIL_HOST=your_smtp_host
MAIL_PORT=your_smtp_port
MAIL_USER=your_smtp_username
MAIL_PASSWORD=your_smtp_password
# API Configuration
NEXT_PUBLIC_API_URL=your_api_url
# App Configuration
NEXT_PUBLIC_APP_URL=your_app_url
UNSUBSCRIBE_SECRET=your_unsubscribe_secret
# Cron Job
CRON_SECRET=your_cron_secretnpm run dev- Chạy môi trường developmentnpm run build- Build dự án cho productionnpm run start- Chạy phiên bản productionnpm run lint- Kiểm tra lỗi với ESLint
- Truy cập trang web
- Nhập biển số xe theo một trong các định dạng:
- 11H1-1111
- 11H11111
- 11H-1111
- 11H1111
- 11HH11111
- 11HH1111
- Nhấn "Kiểm tra ngay"
- Xem kết quả hiển thị chi tiết về các vi phạm (nếu có)
- Tra cứu biển số xe
- Nhấn "Đăng ký nhận thông báo"
- Nhập email
- Xác nhận đăng ký qua email
Chúng tôi rất hoan nghênh mọi đóng góp! Để đóng góp:
- Fork dự án
- Tạo nhánh tính năng (
git checkout -b feature/TinhNangMoi) - Commit thay đổi (
git commit -m 'Thêm tính năng mới') - Push lên nhánh (
git push origin feature/TinhNangMoi) - Tạo Pull Request
- Tuân thủ coding style của dự án
- Cập nhật documentation khi cần
- Tạo issues cho bugs hoặc tính năng mới
Dự án được phân phối dưới giấy phép MIT. Xem LICENSE để biết thêm thông tin.
MinhVo
- GitHub: @minhomega
Nếu dự án này giúp ích cho bạn, hãy:
- Cho dự án một ngôi sao ⭐️
- Chia sẻ với bạn bè
- Đóng góp code hoặc tài liệu
- Tạo issue trên GitHub
- Email: vnqminh0502@gmail.com