{"id":25664900,"url":"https://github.com/minhomega/phatnguoi","last_synced_at":"2025-10-12T10:02:33.784Z","repository":{"id":273974139,"uuid":"921490033","full_name":"MinhOmega/phatnguoi","owner":"MinhOmega","description":"Tra Cứu Vi Phạm Giao Thông - 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.","archived":false,"fork":false,"pushed_at":"2025-02-16T06:34:08.000Z","size":527,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-16T13:42:03.513Z","etag":null,"topics":["giaothong","nextjs","nextjs15","phatnguoi","vietnam"],"latest_commit_sha":null,"homepage":"https://phatnguoigiaothong.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MinhOmega.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-24T03:28:18.000Z","updated_at":"2025-02-24T13:55:48.000Z","dependencies_parsed_at":"2025-01-24T05:18:46.759Z","dependency_job_id":"b0769c4f-5866-49e1-a0d9-3e08107e7b16","html_url":"https://github.com/MinhOmega/phatnguoi","commit_stats":null,"previous_names":["minhomega/phatnguoi"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinhOmega%2Fphatnguoi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinhOmega%2Fphatnguoi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinhOmega%2Fphatnguoi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MinhOmega%2Fphatnguoi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MinhOmega","download_url":"https://codeload.github.com/MinhOmega/phatnguoi/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250261811,"owners_count":21401552,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["giaothong","nextjs","nextjs15","phatnguoi","vietnam"],"created_at":"2025-02-24T06:31:02.241Z","updated_at":"2025-10-12T10:02:33.674Z","avatar_url":"https://github.com/MinhOmega.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tra Cứu Vi Phạm Giao Thông\n\nHệ 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.\n\n## 🌟 Tổng Quan\n\n- 🚀 Tra cứu thông tin vi phạm giao thông trực tuyến\n- 🔔 Hệ thống thông báo qua email khi có vi phạm mới\n- 📱 Giao diện responsive, tương thích mọi thiết bị\n- ⚡ Tốc độ tra cứu nhanh chóng\n- 🔒 Bảo mật thông tin người dùng\n\n## ✨ Tính Năng Chi Tiết\n\n### 🔍 Tra Cứu Vi Phạm\n- Hỗ trợ nhiều định dạng biển số xe (VD: 11H1-1111, 11H11111, 11H-1111, 11H1111, 11HH11111, 11HH1111)\n- Hiển thị thông tin chi tiết về vi phạm:\n  - Thời gian và địa điểm vi phạm\n  - Loại phương tiện và màu biển số\n  - Hành vi vi phạm cụ thể\n  - Đơn vị phát hiện vi phạm\n  - Địa điểm giải quyết vi phạm\n  - Trạng thái xử lý vi phạm\n\n### 📧 Hệ Thống Thông Báo\n- Đăng ký nhận thông báo qua email\n- Tự động gửi email khi phát hiện vi phạm mới\n- Xác nhận đăng ký qua email\n- Quản lý đăng ký thông báo dễ dàng\n\n### 💻 Giao Diện Người Dùng\n- Thiết kế hiện đại với Tailwind CSS\n- Responsive trên mọi thiết bị\n- Hiệu ứng chuyển động mượt mà\n- Biểu tượng trực quan với Lucide Icons\n- Loading states và error handling thân thiện\n\n## 🛠️ Công Nghệ Sử Dụng\n\n- **Frontend:**\n  - Next.js 15 - Framework React hiện đại\n  - React 19 - Thư viện JavaScript cho UI\n  - TypeScript - JavaScript với kiểu dữ liệu tĩnh\n  - Tailwind CSS - Framework CSS tiện ích\n  - Lucide Icons - Bộ icon đẹp và nhẹ\n\n- **Backend:**\n  - MongoDB - Cơ sở dữ liệu NoSQL\n  - API Routes - Next.js API endpoints\n  - Email Service - Hệ thống gửi email tự động\n\n## 📦 Cài Đặt\n\n1. Clone dự án:\n```bash\ngit clone https://github.com/minhomega/phatnguoi.git\n```\n\n2. Di chuyển vào thư mục dự án:\n```bash\ncd phatnguoi\n```\n\n3. Cài đặt dependencies:\n```bash\nnpm install\n# hoặc\nyarn install\n# hoặc\npnpm install\n```\n\n4. Tạo file môi trường:\n```bash\ncp .env.example .env\n```\n\n5. Cấu hình các biến môi trường trong file `.env`\n\n6. Chạy dự án:\n\n```bash\n# Môi trường development\nnpm run dev\n# hoặc\nyarn dev\n# hoặc\npnpm dev\n\n# Build cho production\nnpm run build\n# hoặc\nyarn build\n# hoặc\npnpm build\n\n# Chạy production\nnpm run start\n# hoặc\nyarn start\n# hoặc\npnpm start\n```\n## 🌍 Triển Khai\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fminhomega%2Fphatnguoi\u0026env=MONGODB_URI,MAIL_SERVICE,MAIL_HOST,MAIL_PORT,MAIL_USER,MAIL_PASSWORD,NEXT_PUBLIC_API_URL,CRON_SECRET,UNSUBSCRIBE_SECRET,NEXT_PUBLIC_APP_URL\u0026project-name=phatnguoi\u0026repository-name=phatnguoi)\n\nDự án được triển khai trên Vercel. Để triển khai:\n\n1. Nhấn nút \"Deploy\" ở trên để fork và triển khai tự động, hoặc:\n2. Đẩy code lên GitHub\n3. Kết nối repository với Vercel\n4. Vercel sẽ tự động triển khai khi có thay đổi trên nhánh main\n\n\u003e **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:\n\u003e - `MONGODB_URI`: URL kết nối MongoDB\n\u003e - `MAIL_SERVICE`: Dịch vụ email (mặc định: gmail)\n\u003e - `MAIL_HOST`: Host SMTP (mặc định: smtp.gmail.com)\n\u003e - `MAIL_PORT`: Port SMTP (mặc định: 465)\n\u003e - `MAIL_USER`: Email đăng nhập SMTP\n\u003e - `MAIL_PASSWORD`: Mật khẩu email SMTP\n\u003e - `NEXT_PUBLIC_API_URL`: URL API của ứng dụng\n\u003e - `CRON_SECRET`: Khóa bí mật cho Cron Job\n\u003e - `UNSUBSCRIBE_SECRET`: Khóa bí mật cho chức năng hủy đăng ký\n\u003e - `NEXT_PUBLIC_APP_URL`: URL của ứng dụng (mặc định là URL của Vercel sau khi deploy)\n\n## 🔧 Cấu Hình\n\nCác biến môi trường cần thiết trong file `.env`:\n\n```env\n# MongoDB\nMONGODB_URI=your_mongodb_connection_string\n\n# Email Service\nMAIL_SERVICE=your_email_service\nMAIL_HOST=your_smtp_host\nMAIL_PORT=your_smtp_port\nMAIL_USER=your_smtp_username\nMAIL_PASSWORD=your_smtp_password\n\n# API Configuration\nNEXT_PUBLIC_API_URL=your_api_url\n\n# App Configuration\nNEXT_PUBLIC_APP_URL=your_app_url\nUNSUBSCRIBE_SECRET=your_unsubscribe_secret\n\n# Cron Job\nCRON_SECRET=your_cron_secret\n```\n\n## 🔧 Scripts\n\n- `npm run dev` - Chạy môi trường development\n- `npm run build` - Build dự án cho production\n- `npm run start` - Chạy phiên bản production\n- `npm run lint` - Kiểm tra lỗi với ESLint\n\n## 📝 Hướng Dẫn Sử Dụng\n\n### Tra Cứu Vi Phạm\n1. Truy cập trang web\n2. Nhập biển số xe theo một trong các định dạng:\n   - 11H1-1111\n   - 11H11111\n   - 11H-1111\n   - 11H1111\n   - 11HH11111\n   - 11HH1111\n3. Nhấn \"Kiểm tra ngay\"\n4. Xem kết quả hiển thị chi tiết về các vi phạm (nếu có)\n\n### Đăng Ký Thông Báo\n1. Tra cứu biển số xe\n2. Nhấn \"Đăng ký nhận thông báo\"\n3. Nhập email\n4. Xác nhận đăng ký qua email\n\n## 🤝 Đóng Góp\n\nChúng tôi rất hoan nghênh mọi đóng góp! Để đóng góp:\n\n1. Fork dự án\n2. Tạo nhánh tính năng (`git checkout -b feature/TinhNangMoi`)\n3. Commit thay đổi (`git commit -m 'Thêm tính năng mới'`)\n4. Push lên nhánh (`git push origin feature/TinhNangMoi`)\n5. Tạo Pull Request\n\n### Quy Tắc Đóng Góp\n- Tuân thủ coding style của dự án\n- Cập nhật documentation khi cần\n- Tạo issues cho bugs hoặc tính năng mới\n\n## 📄 Giấy Phép\n\nDự án được phân phối dưới giấy phép MIT. Xem `LICENSE` để biết thêm thông tin.\n\n## 👤 Tác Giả\n\n**MinhVo**\n- GitHub: [@minhomega](https://github.com/minhomega)\n\n## ⭐️ Hỗ Trợ Dự Án\n\nNếu dự án này giúp ích cho bạn, hãy:\n- Cho dự án một ngôi sao ⭐️\n- Chia sẻ với bạn bè\n- Đóng góp code hoặc tài liệu\n\n## 📞 Liên Hệ \u0026 Hỗ Trợ\n\n- Tạo issue trên GitHub\n- Email: vnqminh0502@gmail.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminhomega%2Fphatnguoi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fminhomega%2Fphatnguoi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminhomega%2Fphatnguoi/lists"}