新增:资料页真实化 + 编辑页——/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
+47
View File
@@ -0,0 +1,47 @@
import 'package:patbond_flutter/core/network/api_exception.dart';
/// 资料页/编辑页的错误文案映射(沿 `petLoadErrorMessage` 先例:
/// 服务端原始 message 一律不上屏)。
String profileLoadErrorMessage(ApiException? error) => switch (error) {
ApiNetworkException _ => '网络异常,请检查网络后重试',
ApiRateLimitException _ => '请求过于频繁,请稍后再试',
_ => '加载失败,请稍后重试',
};
/// 保存资料的失败文案,按契约 v1.4.0 的 `PATCH /api/v1/me` 错误谱分层:
///
/// | 码 | 成因 | 文案取向 |
/// | --- | --- | --- |
/// | 40000 | 昵称长度/纯空白、空 patch、非法 UUID | 指向输入本身可改 |
/// | 40405 | 头像 asset 不存在/非本人/已删/用途不符 | 引导重新上传 |
/// | 42203 | 本人头像 asset 仍在 uploading/failed | 明说「还没传完」,可重试 |
///
/// 40000 的三种成因在客户端已各自前置拦截(长度校验 / 空 patch 短路 /
/// assetId 来自服务端),真收到 40000 说明校验与服务端有偏差,
/// 故文案不写死「昵称」,只指向「填写内容」。
String profileSaveErrorMessage(ApiException? error) => switch (error) {
ApiBusinessException(code: ApiCodes.paramError) => '填写内容不符合要求,请检查后重试',
ApiBusinessException(code: ApiCodes.mediaNotFound) => '头像已失效,请重新上传',
ApiBusinessException(code: ApiCodes.mediaNotReady) => '头像还没上传完,请稍后重试',
ApiNetworkException _ => '网络异常,请检查网络后重试',
ApiRateLimitException _ => '请求过于频繁,请稍后再试',
_ => '保存失败,请稍后重试',
};
/// 昵称的客户端校验,与后端 `ck_users_nickname`btrim + 1~32)对齐。
///
/// **长度按码点计**`String.characters` 的等价物 `runes`):数据库
/// `char_length` 数的是码点,若按 UTF-16 `String.length` 校验,32 个 emoji
/// 的合法昵称(UTF-16 长度 64)会被客户端误拒。
///
/// 返回 null 即通过;非空即字段级 errorText。
String? validateNickname(String raw) {
// btrim 对齐:服务端先 btrim 再判长度,故校验也先 trim。
final trimmed = raw.trim();
if (trimmed.isEmpty) {
// 纯空白是 400/40000 而非隐式清空——清空走「清除昵称」显式入口。
return '昵称不能为空,如需清除请用下方「清除昵称」';
}
if (trimmed.runes.length > 32) return '昵称最多 32 个字';
return null;
}