Báo cáo ma trận · gắn API hồ sơ / avatar (D-USER)

Ngày: 2026-08-06 · WP: WP-USER-AVATAR-01 · WP-FE-USER-AVATAR-01 Nguồn ma trận: docs/01-MATRIX-TRACEABILITY.md Ref BE: D:\APP_DESIGN_BUILD\BE-baotienweb.cloud\src\profile HTTP log: HTTP_DEBUG=1 · Nest api:dev · terminal watch đang chạy (filter [HTTP]|users/me|profile|avatar) Probe raw: _probe-profile-matrix.json

1. Verdict

2. Ma trận Domain (trích) → BE ops thực tế

D-USER (matrix §A)

D-AUTH / D-MEDIA (liên quan)

3. Bảng gắn API (BE ↔ FE) — chi tiết

Prefix: /api/v1

Luồng dữ liệu (đã pin log)

ProfileEdit → UsersApi.uploadAvatar (multipart field avatar)
  → POST /users/me/avatar
  → MediaService.uploadSingle → MinIO
  → User.avatarUrl = publicUrl
  → AuthContext.refreshUser → AccountHome Image

AccountHome focus
  → UsersApi.summary → GET /users/me/summary
  → rewards.rewardPoints hiển thị (thay hardcode 1250)

4. Evidence HTTP log (local · HTTP_DEBUG=1)

Probe lúc 2026-08-06T08:30:40Z (xem JSON đính kèm):

Log Nest mẫu (redacted):

[HTTP] → PATCH /api/v1/users/me b={"fullName":"Consumer Local","bio":"Bao cao matrix probe"}
[HTTP] ← PATCH /api/v1/users/me 200 … "bio":"Bao cao matrix probe"
[HTTP] ← GET /api/v1/users/me/summary 200 … favoritesCount, walletBalance

Cách xem log tiếp: terminal đang Get-Content -Wait file nest log (filter HTTP). Nest gốc: npm run api:dev · HTTP_DEBUG=1 trong api/.env.

5. So baotienweb — còn thiếu gì?

6. Việc cần chỉnh / gắn tiếp (ưu tiên)

Không cần tạo API thứ hai — canonical giữ /users/me/*; /profile/* chỉ alias.

7. File đụng (wave này)

BE

• api/src/modules/users/users.controller.ts
• api/src/modules/users/users.service.ts
• api/src/modules/users/profile-alias.controller.ts
• api/src/modules/users/users.module.ts
• api/src/modules/users/dto/update-profile.dto.ts
• api/src/modules/media/media.service.ts (tryDeleteByPublicUrl)

FE

• mobile/src/services/api.ts (UsersApi · AuthUser)
• mobile/src/features/auth/AuthContext.tsx
• mobile/src/features/profile/screens/ProfileEditScreen.tsx
• mobile/src/features/profile/screens/AccountHomeScreen.tsx

Docs

• docs/01-MATRIX-TRACEABILITY.md (D-USER 8 ops)
• docs/05-PHASE-BACKLOG.md
• docs/reports/WP-USER-AVATAR-01.md
• this file

8. Footer

Domain: D-USER (+ D-AUTH/D-MEDIA liên quan)
WP: WP-USER-AVATAR-01 · WP-FE-USER-AVATAR-01
Surfaces: API · CON (ADM/DRV cover UI chưa)
Status: IMP (core) · PARTIAL (cover UI · prefs)
Local HTTP: PASS (probe JSON)
Prod: DEPLOYED earlier same day
Log watch: ON (HTTP_DEBUG=1)
Next: WP-FE-USER-COVER-01 | WP-USER-PREFS-01