57cd84aebf
Some checks failed
CI / Lint → Typecheck → Test → Build (22) (push) Failing after 5s
CI / E2E Tests (push) Has been skipped
CI / AI Services (Python) — Smoke (push) Failing after 7s
CodeQL Analysis / CodeQL (javascript-typescript) (push) Failing after 23s
Deploy / Build API Image (push) Failing after 10s
Deploy / Build Web Image (push) Failing after 4s
Deploy / Build AI Services Image (push) Failing after 5s
E2E Tests / Playwright E2E (push) Failing after 10s
Security Scanning / Dependency Audit (pnpm) (push) Failing after 3s
Security Scanning / Trivy Scan — API Image (push) Failing after 41s
Security Scanning / Trivy Scan — Web Image (push) Failing after 28s
Security Scanning / Trivy Scan — AI Services Image (push) Failing after 33s
Security Scanning / Trivy Filesystem Scan (push) Failing after 26s
Deploy / Deploy to Staging (push) Has been skipped
Deploy / Smoke Test Staging (push) Has been skipped
Deploy / Deploy to Production (push) Has been skipped
Deploy / Smoke Test Production (push) Has been skipped
Security Scanning / Security Gate (push) Failing after 1s
Deploy / Rollback Staging (push) Has been skipped
Deploy / Rollback Production (push) Has been skipped
98 lines
3.6 KiB
Markdown
98 lines
3.6 KiB
Markdown
# GoodGo Platform
|
|
|
|
Vietnamese real estate platform — monorepo powered by pnpm workspaces + Turborepo.
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
pnpm install
|
|
pnpm db:generate # Generate Prisma client
|
|
pnpm db:migrate:dev # Run migrations (needs PostgreSQL 16 + PostGIS)
|
|
pnpm db:seed # Seed sample data (users, listings, districts)
|
|
pnpm dev # Start all apps (API :3001, Web :3000)
|
|
```
|
|
|
|
## Architecture
|
|
|
|
- **apps/api** — NestJS backend (CQRS, DDD, clean architecture)
|
|
- **apps/web** — Next.js 15 frontend (App Router, Tailwind, Zustand)
|
|
- **libs/ai-services** — Python FastAPI AI/ML services (AVM, content moderation, NLP)
|
|
- **libs/mcp-servers** — MCP tool server library (property search, analytics, valuation)
|
|
- **prisma/** — Schema, migrations, seed scripts
|
|
- **e2e/** — Playwright E2E tests (API + Web projects)
|
|
|
|
## Key Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `pnpm lint` | ESLint (auto-fixable with `--fix`) |
|
|
| `pnpm typecheck` | TypeScript type checking |
|
|
| `pnpm test` | Unit tests via Vitest (API only) |
|
|
| `pnpm build` | Production build (all packages) |
|
|
| `pnpm test:e2e` | Playwright E2E tests |
|
|
| `pnpm db:studio` | Prisma Studio GUI |
|
|
|
|
## Tech Stack
|
|
|
|
- **Runtime**: Node.js >= 22, pnpm 10
|
|
- **Backend**: NestJS, Prisma ORM, PostgreSQL 16 + PostGIS, Redis
|
|
- **Frontend**: Next.js 15, React 18, Tailwind CSS 3, Zustand, Mapbox GL
|
|
- **Testing**: Vitest (unit), Playwright (E2E)
|
|
- **CI**: GitHub Actions (lint → typecheck → test → build)
|
|
|
|
## Project Structure (API)
|
|
|
|
```
|
|
apps/api/src/modules/
|
|
auth/ — Authentication (JWT, OAuth, refresh tokens, CSRF)
|
|
listings/ — Property listings CRUD
|
|
payments/ — VNPay, MoMo, ZaloPay payment integration
|
|
subscriptions/ — Plans, quotas, usage tracking
|
|
admin/ — Moderation, KYC, user management, audit logs
|
|
analytics/ — Market data, heatmaps, price trends, AVM
|
|
search/ — Geo search, full-text search (Typesense), saved searches
|
|
notifications/ — Email, in-app notifications
|
|
agents/ — Agent profiles, quality scores
|
|
inquiries/ — Property inquiry management
|
|
leads/ — Lead tracking and conversion
|
|
reviews/ — Property reviews and ratings
|
|
health/ — Liveness and readiness probes
|
|
metrics/ — Prometheus metrics, web vitals
|
|
mcp/ — MCP tool server endpoints
|
|
shared/ — Domain primitives, guards, pipes, logging
|
|
```
|
|
|
|
Each module follows DDD layers: `domain/` → `application/` → `infrastructure/` → `presentation/`.
|
|
|
|
## Project Structure (Libs)
|
|
|
|
```
|
|
libs/
|
|
ai-services/ — Python FastAPI AI/ML services (AVM, content moderation, NLP)
|
|
mcp-servers/ — MCP tool server library (property search, analytics, valuation)
|
|
```
|
|
|
|
## Database
|
|
|
|
- PostgreSQL 16 with PostGIS extension for geospatial queries
|
|
- 22 models (User, Property, Listing, Payment, Subscription, etc.)
|
|
- Migrations in `prisma/migrations/`
|
|
- Seed data covers: users, agents, Ho Chi Minh City districts/wards, sample properties, subscription plans
|
|
|
|
## Environment Variables
|
|
|
|
Required in `.env`:
|
|
- `DATABASE_URL` — PostgreSQL connection string
|
|
- `JWT_SECRET`, `JWT_REFRESH_SECRET` — Auth tokens
|
|
- `VNPAY_*` — Payment gateway config
|
|
- `MAPBOX_TOKEN` — Map rendering (frontend)
|
|
- `REDIS_URL` — Cache layer (optional for dev)
|
|
|
|
## Conventions
|
|
|
|
- Import order enforced by eslint-plugin-import-x (external → internal → relative)
|
|
- Path aliases: `@modules/*` in API, `@/*` in Web
|
|
- Vietnamese UI text throughout (property types, districts, currency in VND)
|
|
- All handlers return typed `Result<T>` or throw `DomainException`
|
|
- Commit messages follow conventional commits
|