WELIFE � K? ho?ch k? thu?t ho�n ch?nh

Audit t? 39 b? UI mockup + PDF Mobile App UI trong th? m?c g?c.
Stack: BE NestJS + JWT + Swagger | FE React Native | Deploy Ubuntu.

1. K?t lu?n audit (t?ng quan s?n ph?m)

WELIFE l� si�u ?ng d?ng (super-app) lifestyle + ?� th? Vi?t Nam, g?m 3 ph�a client d�ng chung m?t API:

Bottom nav Consumer (th?ng nh?t t? UI): Map � Reels � Social � Contact/Inbox � T�i kho?n

2. Ph�n t�ch BE / FE (ranh gi?i c?ng)

???????????????????????????????????????????????????????????????
? FE (React Native) � ch? UI, state, g?i API/WS, maps SDK    ?
?  apps/mobile          Consumer                              ?
?  apps/partner         Partner (multi-vertical)              ?
?  apps/driver          Driver                                ?
???????????????????????????????????????????????????????????????
                           ? HTTPS REST + WebSocket + JWT
???????????????????????????????????????????????????????????????
? BE (NestJS) � business logic, auth, DB, payment, media      ?
?  apps/api                                                   ?
?  PostgreSQL + PostGIS � Redis � Object Storage � Nginx      ?
???????????????????????????????????????????????????????????????
                           ?
                     Ubuntu Server

FE kh�ng: t�nh gi� c??c, matching t�i x?, tr? v�, OCR bi?n s?, duy?t KYC, aggregation doanh thu.
BE kh�ng: layout m�n h�nh, navigation stack, camera UI (ch? nh?n file/metadata).

3. B?n ?? module theo UI ?� audit

3.1 N?n t?ng d�ng chung (Platform)

3.2 Consumer � d?ch v? d?c (Verticals)

3.3 Partner apps (c�ng API, role kh�c)

3.4 Driver

4. Ki?n tr�c BE NestJS (ho�n thi?n)

4.1 C?u tr�c th? m?c API

apps/api/
  src/
    main.ts                 # Swagger + global pipes/filters
    app.module.ts
    common/                 # guards, decorators, dto, filters
    config/
    modules/
      auth/
      users/
      media/
      places/
      wallet/
      transactions/
      notifications/
      support/
      favorites/
      addresses/
      rides/
      parking/
      fuel/
      atm/
      fnb/
      grocery/
      pharmacy/
      health/
      hotels/
      rentals/
      schools/
      social/
      chat/
      reviews/
      promotions/
      analytics/
      partners/             # onboarding KYC chung
      assistant/
      cms/
    gateway/                # Socket.io realtime
  prisma/  ho?c  typeorm/

4.2 Auth & b?o m?t

• ??ng nh?p: S?T + OTP (primary), Google/Apple/Facebook (optional).
• JWT Access (15m) + Refresh (30d) l?u Redis/DB, rotate khi refresh.
• Roles: USER | DRIVER | PARTNER_OWNER | PARTNER_STAFF | ADMIN | DOCTOR | LANDLORD.
• Guards: JwtAuthGuard, RolesGuard, PartnerScopeGuard (ch? data thu?c c?a h�ng).
• Soft-delete account + OTP confirm (?�ng UI x�a TK).
• Rate-limit OTP / login; Helmet; CORS whitelist app.

4.3 Swagger

• Path: /docs (Bearer JWT).
• Tag theo module: Auth, Users, Places, Rides, Orders, Wallet�
• M?i endpoint: DTO request/response, status codes, v� d? VN.

4.4 Database

Nguy�n t?c model:

• places = POI chung (type: cafe|restaurant|parking|gas|atm|hotel|pharmacy|school|hospital�).
• Vertical tables m? r?ng 1-1 ho?c 1-n t? places.id.
• orders / bookings / trips t�ch theo domain (kh�ng nh?i 1 b?ng kh?ng l?).
• wallet_ledger append-only (kh�ng UPDATE s? d? tr?c ti?p).

4.5 Realtime (b?t bu?c theo UI)

4.6 T�ch h?p ngo�i

5. API surface ?u ti�n (Phase 0�1)

Phase 0 � Foundation (tu?n 1�3)

POST   /api/v1/auth/otp/send
POST   /api/v1/auth/otp/verify
POST   /api/v1/auth/refresh
POST   /api/v1/auth/logout
GET    /api/v1/users/me
PATCH  /api/v1/users/me
POST   /api/v1/media/upload
GET    /api/v1/places/nearby?lat=&lng=&type=&radius=
GET    /api/v1/places/:id
GET    /api/v1/cms/terms
GET    /api/v1/cms/privacy

Phase 1 � Core consumer (tu?n 4�8)

# Addresses / Favorites
CRUD   /api/v1/addresses
CRUD   /api/v1/favorites

# Rides
POST   /api/v1/rides/quotes
POST   /api/v1/rides
GET    /api/v1/rides/:id
POST   /api/v1/rides/:id/cancel
POST   /api/v1/rides/:id/rate
WS     /rides

# Wallet
GET    /api/v1/wallet
POST   /api/v1/wallet/topup
POST   /api/v1/wallet/withdraw
GET    /api/v1/transactions

# F&B + Orders chung pattern
GET    /api/v1/merchants
GET    /api/v1/merchants/:id/menu
POST   /api/v1/orders
GET    /api/v1/orders/:id

# Parking / Fuel / ATM (discovery)
GET    /api/v1/parking/lots/nearby
GET    /api/v1/fuel/stations/nearby
GET    /api/v1/atms/nearby

Phase 2 � Vertical c�n l?i + Partner

Hotels, Rentals, Pharmacy+Prescription, Health, Schools, Social/Reels, Partner dashboards, Driver app, Analytics.

6. K? ho?ch FE React Native

6.1 Repo apps

6.2 Ki?n tr�c FE

src/
  app/                 # navigation (tabs + stacks)
  features/            # auth, map, rides, wallet, ...
  shared/              # ui kit, hooks, api client
  services/api.ts      # axios + interceptors JWT
  services/socket.ts
  store/               # Zustand ho?c RTK Query

• Maps: react-native-maps
• Video Reels: expo-av / react-native-video
• i18n: vi (default), en sau
• Kh�ng nh�ng secret payment; ch? g?i BE.

6.3 Mapping tab Consumer ? feature folders

7. Deploy Ubuntu (production)

Internet ? Nginx (TLS) ? NestJS (PM2 cluster ho?c Docker)
                       ? Socket.io (sticky session)
         ? PostgreSQL + PostGIS
         ? Redis
         ? MinIO / S3

Docker Compose (khuy?n ngh?): api, postgres, redis, minio, nginx.
CI: build ? test ? image ? deploy VPS.
Env: .env kh�ng commit; secret JWT / DB / SMS / payment tr�n server.
Monitoring: health /api/v1/health, logs PM2/Docker, backup Postgres daily.

8. L? tr�nh tri?n khai ?? xu?t

9. Nguy�n t?c ?u ti�n khi code

1. Modular monolith NestJS tr??c � t�ch microservice sau khi traffic l?n.
2. M?i API public qua Swagger tr??c khi FE integrate.
3. M?i ti?n qua ledger wallet + idempotency key.
4. Geo query ch? qua PostGIS (ST_DWithin).
5. Partner data lu�n filter theo storeId / ownership.
6. FE/BE t�ch repo folder r�; contract = OpenAPI t? Swagger.

10. Mapping file thi?t k? (tham chi?u)

PDF WELIFE - Mobile App UI-*.pdf = b?n g?c Figma/export ??y ?? m�n h�nh.