新增:资料页真实化 + 编辑页——/me 读写、PATCH 三态、获赞与作品统计(T3.5-08)

资料页头部三项(展示名 / 头像 / 数字)自此全部来自服务端,176 行硬编码
demo(「萌宠新手(豆豆家长)」/ 24 / 1.8k / 2)退役。

- `PatchField<T>` 承载契约 v1.4.0 的 PATCH 三态(absent 不落键 / clear 落
  显式 null / value 落值)。三态必须由类型承载而非 `T?` 加约定:把「不改」
  也编码成 null,用户只改昵称就会连头像一起被服务端清掉。
- `UserProfile` 补 nickname / avatarUrl,展示回退 `nickname ?? username`
  **做在客户端展示层**——服务端 /me 刻意返回 DB 原值,编辑页因此只用原值
  预填,避免把展示约定固化成真实昵称。
- `ProfileController`:`/me` 主链路四态 + 两块统计独立三态(统计失败只降级
  这一块,不为两个数字丢掉整页);登出 reset 防跨账号泄漏。
- 编辑页维护三态意图而非「当前值整体提交」:昵称 / 头像各有显式清除入口,
  未改字段的键根本不进 JSON;空 patch 直接短路(服务端对空 patch 答 400)。
- 昵称校验按**码点**计 1~32 且先 btrim,与 `ck_users_nickname` 对齐;
  纯空白是校验失败而非隐式清空。
- `MediaUploader` 的 purpose 参数化 + 复用其六态编排的 `AvatarUploadSheet`
  (单图、预览确认后才交付 ready assetId,孤儿防护不变)。
- 修复 `/api/v1/me` 端口线路:该端点由 user 服务(:8082)提供,`ApiAuthRepository`
  此前只挂 auth(:8081)会得到 404。此前无人消费 me(),故这条错线一直没被
  触发;本单是第一个真实消费者,桌面实测即暴露。

测试 526 → 588(+62)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-11 15:37:00 +08:00
parent 7d5c84d06d
commit a4a97c03c2
22 changed files with 2489 additions and 47 deletions
+9 -2
View File
@@ -131,6 +131,7 @@ class MediaUploader extends ChangeNotifier {
MediaImageCompressor? compressor,
MediaDirectUploadClient? directUpload,
this._analytics,
this.purpose = MediaPurpose.postImage,
this.maxImages = 9,
this.maxConcurrentUploads = 2,
this.maxByteSize = 10 * 1024 * 1024,
@@ -151,7 +152,13 @@ class MediaUploader extends ChangeNotifier {
final DateTime Function() _now;
/// 九宫格上限(05 号规范 §3.2)。
/// 上传用途(决定服务端 objectKey 前缀,也是引用侧的类型检查依据):
/// 发布页 `post_image`、资料页头像 `user_avatar`、宠物头像 `pet_avatar`。
/// 用途不符的 asset 在引用时被答 404/40405,所以这个值必须由调用方
/// 按场景显式给对(M3.5-08/09 起本类不再只服务发布页)。
final MediaPurpose purpose;
/// 九宫格上限(05 号规范 §3.2);头像场景传 1。
final int maxImages;
final int maxConcurrentUploads;
@@ -467,7 +474,7 @@ class MediaUploader extends ChangeNotifier {
return _repository.createMediaUpload(
CreateMediaUploadRequest(
kind: MediaKind.image,
purpose: MediaPurpose.postImage,
purpose: purpose,
mimeType: compressed.mimeType,
byteSize: compressed.byteSize,
),