18 — Repo structure audit (WP-REPO-STRUCTURE-02)

Cập nhật: 2026-08-05 · sau WP-REPO-CLEAN-01 · gom mockup vào design/mockups/

1. Layout chuẩn hiện tại

welife/
  api/           NestJS + Prisma
  mobile/        Expo Consumer
  partner/       Expo Partner
  driver/        Expo Driver
  dashboard/     Vite Admin
  docs/          Ma trận · phase · reports
  scripts/       Audit / smoke / setup
  deploy/        Nginx / VPS
  assets/        Sound pack v1
  design/
    mockups/     39 JPG (committed)
    pdfs/        PDF packs local (gitignore)
  package.json   Root scripts only (không workspaces)

2. Checklist app surfaces

Surface	Path	`src` layout	Status
CON	`mobile/`	features · navigation · services · theme · shared	OK
PAR	`partner/`	features · services · theme	OK (thin)
DRV	`driver/`	features · navigation · services	OK
ADM	`dashboard/`	modules · shared	OK
API	`api/`	modules · common · prisma	OK

3. Hạng mục còn thiếu / deferred

Hạng mục	Status	Ghi chú
Design mockups folder	IMP	`design/mockups/` · index `design-index.md`
Root `dashboard:dev`	IMP	`npm run dashboard:dev`
`packages/shared` (DTO/zod chung FE↔BE)	THIẾU	Docs đã dự kiến; không scaffold runtime trong WP này → WP-SHARED-01 sau
npm workspaces / turbo	THIẾU	DEFERRED — root chỉ orchestration scripts
Nested `mobile/.git`	CẢNH BÁO	Submodule-like; không xóa tự động (mất history local)
`api/.agents` · `.claude` · `.windsurf`	clutter local	Có thể gitignore riêng; không đụng
`api/.env.bak-*`	local backup	Đã nằm ngoài commit nhờ `.env*` ignore
OWNER Pay / SMS / Google Client IDs	OWNER	16-PHASE-P7-HARDEN

4. Quy tắc sau WP này

JPG mới → chỉ thả vào design/mockups/ + dòng design-index.md.
Không thả tmp-* / _patch-* / tarball / JPG rời ở root.
PDF restore → design/pdfs/ (gitignore).

5. Verify

(Get-ChildItem design/mockups -Filter *.jpg).Count   # 39
(Get-ChildItem . -Filter *.jpg).Count                # 0