Du Lịch Việt
Mô Tả Dự Án
Nền tảng chia sẻ và khám phá địa điểm du lịch Việt Nam với AI Trip Planner (Google Genkit): quản lý địa điểm theo địa chỉ hành chính 3 cấp, quy trình kiểm duyệt nội dung dạng state machine nhiều bước, SSR bằng Next.js 15 App Router, hỗ trợ PWA và thông báo thời gian thực qua Firebase.
Tổng quan
Du Lịch Việt (VietExplore) là nền tảng cộng đồng để khám phá và chia sẻ địa điểm du lịch Việt Nam, tích hợp AI Trip Planner. Nó dành cho du khách muốn tìm địa điểm theo vùng miền và sở thích, cộng đồng đóng góp nội dung, và đội kiểm duyệt cần quy trình rõ ràng. Người dùng khám phá hàng nghìn địa điểm, đóng góp địa điểm mới qua hệ thống kiểm duyệt, và lên lịch trình cá nhân hóa theo thời gian, ngân sách và số người đi.
Kiến trúc & quyết định kỹ thuật
Frontend là Next.js 15 App Router với TypeScript, TailwindCSS, Radix UI, TipTap và Recharts; SSR và compound URL phục vụ SEO. Phía backend chọn Firebase làm BaaS: Authentication (email + Google OAuth), Firestore, Storage cho ảnh/video, Realtime Database cho thông báo thời gian thực, và Cloud Functions cho compute serverless — một lựa chọn "managed-first" giúp không phải vận hành server riêng. AI Trip Planner dùng Google Genkit với Vertex AI, xuất itinerary sang PDF/Excel. Điểm kiến trúc đáng chú ý nhất là state machine kiểm duyệt nội dung bốn bước: pending → claimed → in_review → approved/rejected/needs_revision, kèm priority queue (Partner > Contributor > Traveler), claim timeout hai giờ, auto-archive sau 30 ngày và rollback trong 30 ngày. Phân quyền sáu cấp (Guest đến Admin) gắn trust label, và dashboard theo dõi hiệu suất moderator cùng SLA.
Tính năng nổi bật
- AI Trip Planner tạo lịch trình theo thời gian, ngân sách, sở thích và số người
- State machine kiểm duyệt 4 bước với priority queue và claim timeout
- Cấu trúc địa chỉ hành chính Việt Nam (Tỉnh/Huyện/Xã) và 5 loại địa điểm
- Thông báo thời gian thực qua Firebase Realtime Database, 8+ loại sự kiện
- Dashboard phân tích: thống kê theo tỉnh, xu hướng vùng miền, SLA moderator
- PWA hỗ trợ offline; upload ảnh tự resize 1200x800
Trạng thái
README tuyên bố production-ready, phiên bản 3.0.0. Kiểm tra link 09/10/2026: homepage viet-explore-ai.vercel.app còn sống; tên miền demo dulichviet.tech nêu trong README không truy cập được — trạng thái production của tên miền này chưa xác minh lại được.