Full Screen · ERD · Mock/API Audit

0. Verdict (1 phút)

1. Sơ đồ màn hình (Consumer shell)

flowchart TB
  Boot[Boot / ready] --> AuthCheck{user JWT?}
  AuthCheck -->|no| AuthGate
  AuthCheck -->|yes| MainTabs
  AuthCheck -->|sessionExpired| SessionExpired

  AuthGate --> Splash --> Onboard --> Location --> Login
  Login --> Register
  Login --> Forgot
  Register --> VerifyEmail
  Login -->|success| MainTabs

  MainTabs --> MapTab
  MainTabs --> ReelsTab
  MainTabs --> SocialTab
  MainTabs --> ChatTab
  MainTabs --> AccountTab

  MapTab --> HomeMap
  HomeMap -->|service tile| navigateService
  navigateService -->|known id| VerticalStacks
  navigateService -->|unknown| ServiceStub
  ServiceStub -->|auto replace| VerticalStacks

  VerticalStacks --> Ride[FNB·Ride·Hotel·Rental·Park…]
  VerticalStacks --> P8[Charging·Transit·HomeSvc·Delivery·Bills·QR]
  VerticalStacks --> Platform[Places·Wallet·Routing·Assistant]

  AccountTab --> AccountHome
  AccountHome --> Wallet[Wallet·Pay]
  AccountHome --> Support[Support·KYC·2FA·Sessions]
  AccountHome --> Profile[Profile·Addr·Fav·Reviews]

Tabs & stacks

Typed route keys: 129 · *Screen.tsx: ~125 unique (dup path Windows)

Auth flow (CON)

Splash → Onboarding → LocationPermission → Login | Register | Forgot | VerifyEmail → Main

Gate: AuthGate (phase machine, không phải React Navigation stack riêng).

2. Kiểm soát link / 404

Cross-stack (audit nav · fix WP-FE-WALLET-MAP-NAV-01):

Orphan false-positive: HotelList / RideMatching / success screens đi qua navigateService / params — không phải 404.

Residual 404-risk

1. navigate động / typo runtime.
2. Deep link chưa whitelist (WelifeMapScreen cast).
3. Catalog id mới quên navigateService → ServiceStub.

Hardening: npm run audit:nav PASS · Root NotFound soft-404.

3. Mock vs API (Consumer features)

Tổng

LIVE (API BE)

addresses · assistant · atm · auth · charging · chat · delivery · favorites · fuel · homeservices · hotels · kyc · medical · notifications · parking · pharmacy · places · promotions · rentals · reviews · rides · routing · schools · social · support · transit

HYBRID — chi tiết

Payment truth

Local: PAYMENTS_MOCK=true → giao dịch giả lập qua BE mock provider (vẫn HTTP thật, không hardcode số dư FE). Production go-live: cần OWNER MoMo/VNPay (WP-PAY-LIVE-01).

4. Surfaces khác

Auth (WP-AUTH-CREDENTIALS-SESSIONS-01): passwordHash · lockout · AuthSession · AuthDevice · AuthLoginEvent.

5. ERD (core) — vẽ lại

Full schema: 86 models trong api/prisma/schema.prisma. Sơ đồ dưới = trục nghiệp vụ (bỏ join nhỏ).

erDiagram
  User ||--o| WalletAccount : has
  User ||--o{ Address : saves
  User ||--o{ AuthSession : sessions
  User ||--o{ AuthDevice : devices
  User ||--o| UserTwoFactor : 2fa
  User ||--o| SocialAccount : oauth
  User ||--o| DriverProfile : may
  User ||--o| PartnerOrg : may
  User ||--o| UserKyc : kyc
  User ||--o| HealthProfile : health
  User ||--o| SocialProfile : social

  WalletAccount ||--o{ WalletLedger : ledger
  User ||--o{ PaymentIntent : pays
  User ||--o{ PaymentMethod : methods

  Merchant ||--o{ MenuCategory : menu
  MenuCategory ||--o{ MenuItem : items
  User ||--o{ Cart : carts
  Cart ||--o{ CartItem : lines
  Cart }o--|| Merchant : at
  User ||--o{ Order : orders
  Order ||--o{ OrderItem : lines
  Order }o--|| Merchant : from

  User ||--o{ RideQuote : quotes
  User ||--o{ Ride : books
  DriverProfile ||--o{ Ride : drives
  Ride ||--o{ RideRating : ratings

  Place ||--o| HotelPlaceDetail : hotel
  Place ||--o| RentalPlaceDetail : rental
  Place ||--o| RestaurantPlaceDetail : fnb
  Hotel ||--o{ HotelRoomType : rooms
  Hotel ||--o{ HotelBooking : bookings
  RentalListing ||--o{ RentalViewing : viewings

  ParkingLot ||--o{ ParkingBooking : bookings
  PharmacyStore ||--o{ PharmacyProduct : catalog
  PharmacyStore ||--o{ PharmacyPrescription : rx
  MedicalFacility ||--o{ Doctor : doctors
  MedicalFacility ||--o{ Appointment : appts
  School ||--o{ SchoolConsultation : consults

  ChargingStation
  TransitStop ||--o{ TransitRoute : routes
  HomeServiceProvider ||--o{ HomeServiceBooking : bookings
  BillProvider ||--o{ BillInvoice : invoices
  DeliveryOrder }o--|| User : buyer

  Conversation ||--o{ ConversationMember : members
  Conversation ||--o{ ChatMessage : messages
  SocialPost ||--o{ PostLike : likes
  SocialPost ||--o{ PostComment : comments
  User ||--o{ Favorite : favorites
  User ||--o{ Review : reviews
  User ||--o{ SupportTicket : tickets
  User ||--o{ AppNotification : notifs

Domain clusters

6. Cấu trúc lại luồng (đề xuất)

Giữ (đã ổn)

1. Map-first hub + navigateService single router.
2. Journey chuẩn vertical: List → Detail → Action → Success → History.
3. Một Nest API cho CON/PAR/DRV/ADM.
4. Auth email OTP + credentials/sessions (WP-AUTH-CREDENTIALS-SESSIONS) làm nền.

Sửa / siết

Không làm

• Clone vertical BE/FE mới khi queue STUB = 0.
• Fake payment/SMS/Google để “xanh” production.
• Merge HomeFix/CRM ngoài monorepo.

7. Hướng phát triển tổng thể (roadmap)

NOW (local stable)
  └─ Audit PASS · smoke PASS · IMP queue empty

NEXT (product depth · agent-safe)
  ├─ Nav CI + NotFound
  ├─ Kill residual fallbacks (health labels · stub hits)
  ├─ Journey polish: Ride map device QA · FNB checkout · Wallet transfer UX
  ├─ Partner thin → forms depth (BOARD-PAR-*)
  └─ Auth credentials/sessions FE polish

OWNER gates (blocked without secrets)
  ├─ WP-PAY-LIVE-01 (MoMo/VNPay)
  ├─ WP-AUTH-SMS-01 (eSMS) — optional nếu giữ email OTP
  ├─ WP-AUTH-GOOGLE-LIVE-01 (Web Client ID)
  └─ EAS cloud builds CON/DRV/PAR

THEN (scale)
  ├─ packages/shared
  ├─ Deep-link matrix + push notification routing
  ├─ Observability / SLO trên VPS
  └─ Figma exact sync khi có edit access

Ưu tiên nghiệp vụ (chức năng → trải nghiệm)

1. Tiền thật chạy được (wallet topup / order pay) — tin cậy siêu ứng dụng.
2. Ride end-to-end device (map + matching + chat) — hero use-case.
3. FNB + Grocery checkout ổn định — tần suất cao.
4. Account security (sessions · 2FA · password) — vừa ship credentials.
5. Partner supply — không có listing/merchant thật thì CON trống.
6. Visual polish — sau function; Figma vẫn BLOCKED_EXTERNAL.

8. File đụng / artifacts

Footer

Domain: TOOLING + D-WALLET
WP: WP-FULL-APP-AUDIT-01 · WP-FE-WALLET-MAP-NAV-01
Surfaces: CON|PAR|DRV|ADM|API
Status: IMP (audit + wallet map-nav fix)
Local: N/A (nav fix compile) · prior smoke PASS
Next: OWNER Pay/SMS/Google (stop-gate)