digital-psychology/.ai/architecture.md

Architecture

Go 包边界（冻结）：architecture/go-services.md
Domain / ERD：domain/domain-map.md · domain/erd.md

Allowed call graph

UI (user-h5 / mini-program / admin-h5)
  → packages/sdk（或 admin 薄 api 客户端）
  → API Handler
  → Service
  → Repository
  → Database

Admin 路由挂 /api/v1/admin/*，鉴权与终端 DeviceAuth 隔离（见 feature-spec/ops-admin.md）。

Forbidden

• Handler → Database (skip Service/Repository)
• UI → Database
• UI direct fetch to raw URLs (must use @yuxingu/sdk or src/api thin wrapper)
• Service importing Handler
• Circular package imports
• Giant utils / common dump packages

Monorepo map

Path	Role
apps/api	Only backend
apps/user-h5	Primary client (Vue3+TS)
apps/mini-program	Scaffold only until tasked
apps/admin-h5	Ops Phase A（ECR-006）
packages/sdk	Multi-platform HTTP client
packages/types	Shared TS types
packages/utils	Pure helpers
packages/ui	Design tokens
Root HTML / server.py	Legacy — do not extend

Feature flow (mandatory when adding a feature)

API route + handler
  → service
  → repository (if persistence)
  → migration (if schema change)
  → SDK / types update
  → UI page or component
  → test for money/scoring/auth paths
  → OpenAPI touch if public API changed
  → self-review

Missing migration or skipping service layer = incomplete.