WanderViet — Nền Tảng Du Lịch Việt Nam

Full-stack travel platform | Monorepo | AI-powered | 41 trang | Production-ready

Giới Thiệu

WanderViet là nền tảng du lịch toàn diện dành cho thị trường Việt Nam, cho phép người dùng tìm kiếm, đặt tour, khách sạn và chuyến bay. Hệ thống tích hợp AI chatbot hỗ trợ tư vấn du lịch sử dụng mô hình ngôn ngữ chạy hoàn toàn local (Ollama + RAG), không phụ thuộc cloud API.

Dự án được xây dựng với kiến trúc monorepo hiện đại, áp dụng các best practices về security, testing, CI/CD và containerization.

Demo

Trang chủ	Khám phá	AI Planner

41 trang web | 21 API modules | 10 AI endpoints | 12 màn hình mobile

Giao Diện

Trang Chủ

Đăng Nhập & Xác Thực

Chi Tiết Tour — Gallery, Lịch Trình, Đặt Tour

Khám Phá Điểm Đến & Bản Đồ

Khách Sạn & Đặt Phòng

Tìm Chuyến Bay

AI Travel Assistant

Admin Dashboard — Phân Tích & Quản Lý

Tech Stack

Tầng	Công nghệ	Phiên bản
Frontend	Next.js + React 19 + Tailwind CSS	16.x
Backend	NestJS + TypeScript	11.x
Database	PostgreSQL + Prisma ORM	18 / 7.x
AI Service	FastAPI + Ollama + Qdrant	Python 3.12+
Mobile	Flutter + Dart + Riverpod	3.x
Monorepo	pnpm Workspaces + Turborepo	10.x / 2.x
Testing	Vitest + Playwright + k6	Latest
CI/CD	GitHub Actions (7 jobs) + Docker	—
Cache	Redis	7.x
Vector DB	Qdrant	Latest
LLM Runtime	Ollama	Latest

Kiến Trúc Hệ Thống

wanderviet/
├── apps/
│   ├── api/            # NestJS 11 — REST API (21 modules), Swagger tại /api/docs
│   ├── web/            # Next.js 16 — 41 trang, Vietnamese-first UI
│   ├── ai-service/     # FastAPI — Local RAG (Ollama + Qdrant), 10 endpoints
│   └── mobile/         # Flutter — 12 màn hình, offline-first
├── packages/
│   ├── shared/         # Shared TypeScript types & API contracts
│   ├── db/             # Prisma schema, migrations, seed data
│   └── config/         # Shared ESLint, TypeScript, build configs
├── infra/docker/       # Docker Compose (6 services) + Dockerfiles
├── e2e/                # Playwright E2E tests (4 critical flows)
├── load-tests/         # k6 load test scripts
└── docs/               # ADRs, ER diagram, architecture, features

graph TB
    subgraph Client
        Web[Next.js 16 — SSR/SSG<br/>:3001]
        Mobile[Flutter App<br/>Offline-first]
    end
    subgraph API_Layer
        API[NestJS 11 REST API<br/>:4000<br/>21 modules]
        AI[FastAPI AI Service<br/>:8010<br/>RAG Pipeline]
    end
    subgraph Data_Layer
        PG[(PostgreSQL 18<br/>:5432)]
        Redis[(Redis 7<br/>:6379<br/>Cache + Sessions)]
        Qdrant[(Qdrant<br/>:6333<br/>Vector Store)]
    end
    subgraph AI_Runtime
        Ollama[Ollama<br/>:11434<br/>Local LLM]
    end

    Web -->|REST + JWT| API
    Mobile -->|REST + JWT| API
    API --> PG
    API --> Redis
    API -->|/chat, /plan| AI
    AI --> Ollama
    AI --> Qdrant

Điểm Nổi Bật Kỹ Thuật

Khía cạnh	Chi tiết
AI/RAG chạy local	Ollama LLM + Qdrant vector DB — không cần API key, không mất phí, dữ liệu riêng tư
Monorepo thực thụ	pnpm workspaces + Turborepo — shared types, parallel builds, dependency graph
Security	JWT rotation (15 phút access / 7 ngày refresh), rate limiting, CORS, helmet, input validation
Docker production-ready	Multi-stage builds, non-root user, health checks, layer caching
CI/CD 7 jobs	typecheck, lint+test, security audit, gitleaks, E2E, Docker build, mobile
Testing đa tầng	Unit (Vitest) + E2E (Playwright) + Load (k6) + Property-based (fast-check)
Mobile offline-first	Flutter + Riverpod, local cache, sandbox bookings, offline AI fallback
Design System	Custom Tailwind tokens (tv-*), responsive, WCAG accessible
4 ADRs	Ghi chép quyết định: NestJS, Prisma, mock payment, monorepo structure

Tính Năng Chi Tiết

Hệ Thống Đặt Chỗ

Đặt tour với lịch trình chi tiết, gallery ảnh, đánh giá
Đặt khách sạn với bộ lọc giá, tiện nghi, vị trí
Tìm chuyến bay với so sánh giá
Hệ thống thanh toán demo (sandbox, không giao dịch thật)
Mã giảm giá và chương trình loyalty

Tính Năng AI

AI Trip Planner — Lập lịch trình tự động theo số ngày, ngân sách, sở thích
Chat Assistant — Hỏi đáp về du lịch, gợi ý địa điểm, ẩm thực
Budget Estimator — Ước tính chi phí theo điểm đến và thời gian
Personality Quiz — Gợi ý phong cách du lịch phù hợp
Destination Compare — So sánh nhiều điểm đến

Admin Dashboard

Biểu đồ doanh thu (AreaChart), booking status (PieChart)
Top tours ranking (BarChart)
Quản lý: users, tours, hotels, destinations, bookings, coupons, blogs, reviews
AI Knowledge base management
Hệ thống contact/support ticket

Ứng Dụng Mobile (Flutter)

Offline-first architecture với local cache
Sandbox booking (không giao dịch thật)
AI chat fallback khi mất mạng
QR code vé điện tử demo
Wishlist và itinerary planner

Yêu Cầu Hệ Thống

Phần mềm	Phiên bản tối thiểu
Node.js	>= 22.x
pnpm	>= 10.x
Docker & Docker Compose	Latest
PostgreSQL	18 (qua Docker)
Python	>= 3.12 (cho AI service)
Flutter	>= 3.x (cho mobile)

Cài Đặt Nhanh

1. Clone repository

git clone https://github.com/JasonTM17/ChillTravel_NextJS.git wanderviet
cd wanderviet

2. Cài đặt dependencies

pnpm install

3. Cấu hình môi trường

cp .env.example .env
# Chỉnh sửa .env với thông tin database và các config cần thiết

4. Khởi chạy infrastructure (Docker)

docker compose -f infra/docker/docker-compose.yml up -d

Dịch vụ sẽ khởi chạy: PostgreSQL, Redis, Qdrant, Ollama

5. Chạy database migrations & seed

pnpm --filter @vietwander/db prisma migrate dev
pnpm seed

6. Khởi chạy development servers

pnpm dev

Dịch vụ	URL
Web	http://localhost:3001
API	http://localhost:4000/api/v1
Swagger	http://localhost:4000/api/docs
AI Service	http://localhost:8010

Docker

Chạy toàn bộ hệ thống

docker compose -f infra/docker/docker-compose.yml up -d

Docker Images trên Docker Hub

Image	Link
API	nguyenson1710/wanderviet-api
Web	nguyenson1710/wanderviet-web
AI	nguyenson1710/wanderviet-ai

GitHub Packages (ghcr.io)

Image	Link
API	ghcr.io/jasontm17/wanderviet-api
Web	ghcr.io/jasontm17/wanderviet-web
AI	ghcr.io/jasontm17/wanderviet-ai

Build local

docker compose -f infra/docker/docker-compose.yml build

Tài Khoản Demo

Vai trò	Email	Mật khẩu
Admin	`admin@wanderviet.com`	`Admin@123456`
User	`user@wanderviet.com`	`User@123456`

Lưu ý: Hệ thống thanh toán là mock/demo — không xử lý giao dịch thật.

API Documentation

API documentation được tạo tự động bằng Swagger/OpenAPI:

Swagger UI: http://localhost:4000/api/docs
OpenAPI JSON: http://localhost:4000/api/docs-json

API Modules (21)

Module	Mô tả
Auth	Đăng ký, đăng nhập, refresh token, quên mật khẩu
Users	CRUD users, profile, avatar upload
Tours	CRUD tours, tìm kiếm, lọc, phân trang
Hotels	CRUD hotels, phòng, tiện nghi
Flights	Tìm chuyến bay, so sánh giá
Bookings	Đặt tour/hotel/flight, trạng thái, lịch sử
Payments	Mock payment processing, hoàn tiền
Reviews	Đánh giá, rating, kiểm duyệt
Destinations	Điểm đến, danh mục, phổ biến
Coupons	Mã giảm giá, validation, theo dõi sử dụng
Blogs	Bài viết, danh mục, bình luận
Contacts	Liên hệ, support tickets
Notifications	Push notifications, email
Loyalty	Điểm thưởng, hạng thành viên, rewards
Analytics	Dashboard metrics, doanh thu, xu hướng
Upload	Upload file (ảnh, tài liệu)
Health	Health check endpoints
AI Chat	Proxy tới AI service
AI Planner	Lập lịch trình endpoints
AI Budget	Ước tính ngân sách
AI Knowledge	Quản lý RAG knowledge base

Testing

# Unit tests
pnpm test

# Type checking
pnpm typecheck

# Linting
pnpm lint

# E2E tests (cần Playwright browsers)
pnpm e2e

# Load testing
pnpm load-test

# AI service tests
pnpm ai:test

CI Pipeline (7 jobs)

Job	Mô tả
`web-api-ai`	Lint + Unit tests + Build (Node 22 & 24)
`typecheck`	TypeScript strict mode check
`security-audit`	pnpm audit (high/critical)
`gitleaks`	Quét secrets
`mobile`	Flutter analyze + test
`e2e`	Playwright end-to-end tests
`docker-build`	Build Docker images (khi push lên main)

Tài Liệu

Tài liệu	Mô tả
Kiến trúc	Tổng quan kiến trúc hệ thống
Tính năng	Chi tiết 41 trang và tính năng
ADRs	Architecture Decision Records (4 ADRs)
Sơ đồ ER	Sơ đồ quan hệ thực thể
Đóng góp	Hướng dẫn đóng góp
Nhật ký	Lịch sử thay đổi
Release Checklist	Quy trình release

Cấu Trúc Trang

Nhóm	Trang
Booking	Tour listing, Tour detail, Hotel detail, Flight search, Booking form, Payment, Success
AI	AI Planner, Chat, Budget estimator, Personality quiz, Destination compare
User	Login, Register, Profile, Wishlist, My Bookings, Notifications, Loyalty
Admin	Dashboard, Users, Tours, Hotels, Destinations, Bookings, Coupons, Blogs, Reviews, Analytics, AI Knowledge
Explore	Search, Map, Experiences, Trips, Destinations

Scripts

pnpm dev              # Chạy tất cả dev servers (Turborepo)
pnpm build            # Build production
pnpm lint             # ESLint + Prettier check
pnpm typecheck        # TypeScript strict check
pnpm test             # Vitest unit tests
pnpm e2e              # Playwright E2E tests
pnpm docker:up        # Docker Compose up
pnpm docker:down      # Docker Compose down
pnpm docker:logs      # Xem logs
pnpm seed             # Seed database
pnpm ai:test          # Python AI service tests
pnpm load-test        # k6 load testing
pnpm storybook        # Component storybook
pnpm format           # Prettier format all

Packages

Package	Mô tả	Đường dẫn
`@vietwander/web`	Next.js 16 frontend (41 trang)	`apps/web`
`@vietwander/api`	NestJS 11 REST API (21 modules)	`apps/api`
`@vietwander/e2e`	Playwright E2E tests	`e2e`
`@vietwander/shared`	Shared types & API contracts	`packages/shared`
`@vietwander/db`	Prisma schema, migrations, seed	`packages/db`
`@vietwander/config`	Shared ESLint, TS configs	`packages/config`
`ai-service`	FastAPI + Ollama + Qdrant	`apps/ai-service`
`mobile`	Flutter app (wanderviet)	`apps/mobile`

License

Dự án được phân phối dưới giấy phép MIT.

Name		Name	Last commit message	Last commit date
.changeset		.changeset
.github		.github
.husky		.husky
apps		apps
assets		assets
docs		docs
e2e		e2e
infra/docker		infra/docker
load-tests		load-tests
packages		packages
scripts		scripts
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.env.example		.env.example
.gitignore		.gitignore
.gitleaks.toml		.gitleaks.toml
.lintstagedrc.json		.lintstagedrc.json
.prettierignore		.prettierignore
.prettierrc		.prettierrc
CHANGELOG.md		CHANGELOG.md
CHANGELOG.vi.md		CHANGELOG.vi.md
CONTRIBUTING.md		CONTRIBUTING.md
CONTRIBUTING.vi.md		CONTRIBUTING.vi.md
LICENSE		LICENSE
Makefile		Makefile
README.en.md		README.en.md
README.md		README.md
commitlint.config.js		commitlint.config.js
eslint.config.mjs		eslint.config.mjs
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
tsconfig.base.json		tsconfig.base.json
turbo.json		turbo.json

Latest commit

History

Folders and files

Repository files navigation

WanderViet — Nền Tảng Du Lịch Việt Nam

Giới Thiệu

Demo

Giao Diện

Trang Chủ

Đăng Nhập & Xác Thực

Chi Tiết Tour — Gallery, Lịch Trình, Đặt Tour

Khám Phá Điểm Đến & Bản Đồ

Khách Sạn & Đặt Phòng

Tìm Chuyến Bay

AI Travel Assistant

Admin Dashboard — Phân Tích & Quản Lý

Tech Stack

Kiến Trúc Hệ Thống

Điểm Nổi Bật Kỹ Thuật

Tính Năng Chi Tiết

Hệ Thống Đặt Chỗ

Tính Năng AI

Admin Dashboard

Ứng Dụng Mobile (Flutter)

Yêu Cầu Hệ Thống

Cài Đặt Nhanh

1. Clone repository

2. Cài đặt dependencies

3. Cấu hình môi trường

4. Khởi chạy infrastructure (Docker)

5. Chạy database migrations & seed

6. Khởi chạy development servers

Docker

Chạy toàn bộ hệ thống

Docker Images trên Docker Hub

GitHub Packages (ghcr.io)

Build local

Tài Khoản Demo

API Documentation

API Modules (21)

Testing

CI Pipeline (7 jobs)

Tài Liệu

Cấu Trúc Trang

Scripts

Packages

License

About

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages