新增:资料页真实化 + 编辑页——/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
+29 -2
View File
@@ -60,9 +60,14 @@ enum MediaKind {
_enumFromJson(values, value, 'kind');
}
/// 上传用途白名单(M3 定型仅 post_image决定 objectKey 前缀)。
/// 上传用途白名单(契约 v1.4.0 三值;决定 objectKey 前缀)。
///
/// **用途即引用侧的类型检查**:引用时服务端校验 purpose 相符,故帖图不能
/// 当头像、两种头像也互不通用(不符者 404/40405)。
enum MediaPurpose {
postImage('post_image');
postImage('post_image'),
userAvatar('user_avatar'),
petAvatar('pet_avatar');
const MediaPurpose(this.wire);
@@ -628,3 +633,25 @@ class FollowStats {
final int followingCount;
final bool followedByMe;
}
/// 我的社区数字(`GET /api/v1/me/community-stats`,契约 v1.4.0 新增)。
///
/// 两数同一集合:本人的、已发布的、未软删的帖(草稿 / 软删 / hidden /
/// archived 均不计;自己赞自己**计入**,与帖子详情的 likeCount 同口径)。
/// 空数据为 `0` 而非 null,且该端点**永不 404**——任何已认证用户都有 stats。
class CommunityStats {
const CommunityStats({
required this.receivedLikeCount,
required this.publishedPostCount,
});
factory CommunityStats.fromJson(Map<String, dynamic> json) {
return CommunityStats(
receivedLikeCount: json['receivedLikeCount'] as int,
publishedPostCount: json['publishedPostCount'] as int,
);
}
final int receivedLikeCount;
final int publishedPostCount;
}
@@ -55,6 +55,9 @@ abstract class CommunityRepository {
Future<FollowState> followUser(String userId);
Future<FollowState> unfollowUser(String userId);
Future<FollowStats> getFollowStats(String userId);
// ---- 我的社区数字(主体恒为调用者,路径上无 userId)----
Future<CommunityStats> getMyCommunityStats();
}
/// 基于 [ApiClient] 的实现。全部端点走 Bearer 鉴权(复用既有 token
@@ -301,4 +304,12 @@ class ApiCommunityRepository implements CommunityRepository {
final data = await _request('/api/v1/users/$userId/follow-stats');
return FollowStats.fromJson(_asMap(data));
}
// ---- 我的社区数字 ----
@override
Future<CommunityStats> getMyCommunityStats() async {
final data = await _request('/api/v1/me/community-stats');
return CommunityStats.fromJson(_asMap(data));
}
}
+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,
),