新增：资料页真实化 + 编辑页——/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>
2026-09-11 15:37:00 +08:00
parent 7d5c84d06d
commit a4a97c03c2
22 changed files with 2489 additions and 47 deletions
@@ -0,0 +1,71 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:patbond_flutter/core/models/patch_field.dart';
+
+/// PATCH 三态的 JSON 表现（契约 v1.4.0 的 `UpdateMeRequest` /
+/// `UpdatePetRequest.avatarAssetId`）。
+///
+/// 本文件守住的红线只有一条：**absent 绝不落键**。若 absent 落成 `null`，
+/// 用户「只改昵称」会把头像一起清掉（服务端把显式 null 当清空指令）。
+void main() {
+  test('absent 不落键 / clear 落 null / value 落值', () {
+    final json = <String, Object?>{};
+    const PatchField<String>.absent().writeTo(json, 'a');
+    expect(json.containsKey('a'), isFalse, reason: 'absent 必须连键都不出现');
+
+    const PatchField<String>.clear().writeTo(json, 'b');
+    expect(json.containsKey('b'), isTrue);
+    expect(json['b'], isNull);
+
+    const PatchField<String>.value('x').writeTo(json, 'c');
+    expect(json['c'], 'x');
+  });
+
+  test('absent 与 clear 的 valueOrNull 同为 null，只能靠 isPresent 区分', () {
+    const absent = PatchField<String>.absent();
+    const clear = PatchField<String>.clear();
+    expect(absent.valueOrNull, isNull);
+    expect(clear.valueOrNull, isNull);
+    expect(absent.isPresent, isFalse);
+    expect(clear.isPresent, isTrue);
+    expect(absent.isClear, isFalse);
+    expect(clear.isClear, isTrue);
+    expect(const PatchField<String>.value('x').isClear, isFalse);
+  });
+
+  test('encode 只作用于有值态（clear 不调 encode，避免 null 解引用）', () {
+    final json = <String, Object?>{};
+    var encodeCalls = 0;
+    const PatchField<int>.clear().writeTo(
+      json,
+      'n',
+      encode: (value) {
+        encodeCalls += 1;
+        return value.toString();
+      },
+    );
+    expect(json['n'], isNull);
+    expect(encodeCalls, 0);
+
+    const PatchField<int>.value(7).writeTo(
+      json,
+      'm',
+      encode: (value) {
+        encodeCalls += 1;
+        return value.toString();
+      },
+    );
+    expect(json['m'], '7');
+    expect(encodeCalls, 1);
+  });
+
+  test('值相等即相等（absent 与 clear 不相等）', () {
+    expect(
+      const PatchField<String>.value('a'),
+      const PatchField<String>.value('a'),
+    );
+    expect(
+      const PatchField<String>.absent(),
+      isNot(const PatchField<String>.clear()),
+    );
+  });
+}
@@ -0,0 +1,162 @@
+import 'dart:async';
+
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:patbond_flutter/core/theme/app_theme.dart';
+import 'package:patbond_flutter/core/widgets/avatar_upload_sheet.dart';
+import 'package:patbond_flutter/features/community/community_models.dart';
+import 'package:patbond_flutter/features/community/media_direct_upload.dart';
+import 'package:patbond_flutter/features/community/media_uploader.dart';
+
+import '../../helpers/community_test_helpers.dart';
+import '../../helpers/media_test_helpers.dart';
+
+/// 头像上传 sheet 的六态呈现（状态机本身由 MediaUploader 单测覆盖，
+/// 本文件只验「哪个阶段给用户看什么、能点什么」）。
+void main() {
+  late FakeCommunityRepository community;
+  late FakeMediaImagePicker picker;
+  late FakeMediaCompressor compressor;
+  late FakeDirectUploadClient direct;
+
+  setUp(() {
+    community = FakeCommunityRepository();
+    picker = FakeMediaImagePicker([decodablePickedImage()]);
+    compressor = FakeMediaCompressor();
+    direct = FakeDirectUploadClient();
+    community.onCreateMediaUpload = (_) async => credentials();
+    community.onCompleteMediaUpload = (assetId) async =>
+        readyAsset(assetId: assetId);
+  });
+
+  MediaUploader build(MediaPurpose purpose) => MediaUploader(
+    repository: community,
+    purpose: purpose,
+    picker: picker,
+    compressor: compressor,
+    directUpload: direct,
+    maxImages: 1,
+    maxConcurrentUploads: 1,
+  );
+
+  /// 挂一个按钮拉起 sheet，并把 pop 结果记录下来。
+  Future<List<String?>> pumpSheet(
+    WidgetTester tester, {
+    MediaPurpose purpose = MediaPurpose.userAvatar,
+  }) async {
+    final results = <String?>[];
+    await tester.pumpWidget(
+      MaterialApp(
+        theme: buildAppTheme(),
+        home: Builder(
+          builder: (context) => Scaffold(
+            body: Center(
+              child: ElevatedButton(
+                onPressed: () async {
+                  results.add(
+                    await showAvatarUploadSheet(
+                      context,
+                      builder: build,
+                      purpose: purpose,
+                    ),
+                  );
+                },
+                child: const Text('打开'),
+              ),
+            ),
+          ),
+        ),
+      ),
+    );
+    await tester.tap(find.text('打开'));
+    await tester.pump();
+    return results;
+  }
+
+  testWidgets('打开即自动拉起选择器（无需多点一次「选择图片」）', (tester) async {
+    picker.gate = Completer<void>();
+    await pumpSheet(tester);
+    await tester.pump();
+
+    expect(find.text('正在打开相册…'), findsOneWidget);
+    expect(picker.limits, [1], reason: 'maxImages=1 → 只取一张');
+
+    picker.gate!.complete();
+    await tester.pumpAndSettle();
+  });
+
+  testWidgets('上传中：线性进度 + 百分比；ready 后给预览与「使用这张」', (tester) async {
+    direct.manual = true;
+    final results = await pumpSheet(tester);
+    await tester.pumpAndSettle();
+
+    expect(find.byType(LinearProgressIndicator), findsOneWidget);
+    final call = direct.calls.single;
+    call.emitProgress(30, 100);
+    await tester.pump();
+    expect(find.text('上传中 30%'), findsOneWidget);
+
+    call.succeed();
+    await tester.pumpAndSettle();
+
+    expect(find.text('使用这张'), findsOneWidget);
+    expect(find.byType(Image), findsOneWidget, reason: 'ready 态给整幅预览');
+
+    await tester.tap(find.text('使用这张'));
+    await tester.pumpAndSettle();
+
+    expect(results.single, 'a-1', reason: '只交付 ready 态的 assetId（孤儿防护）');
+  });
+
+  testWidgets('purpose 透传到 createUpload（宠物头像 = pet_avatar）', (tester) async {
+    await pumpSheet(tester, purpose: MediaPurpose.petAvatar);
+    await tester.pumpAndSettle();
+
+    expect(community.lastMediaUploadRequest!.purpose, MediaPurpose.petAvatar);
+    expect(community.lastMediaUploadRequest!.purpose.wire, 'pet_avatar');
+  });
+
+  testWidgets('可重试失败：给「重试」+「重新选择」，重试成功后可确认', (tester) async {
+    direct.scriptedOutcomes.add(
+      const MediaDirectUploadException(message: '断网'),
+    );
+    final results = await pumpSheet(tester);
+    await tester.pumpAndSettle();
+
+    expect(find.text('网络中断，上传失败'), findsOneWidget);
+    expect(find.text('重试'), findsOneWidget);
+    expect(find.text('重新选择'), findsOneWidget);
+
+    await tester.tap(find.text('重试'));
+    await tester.pumpAndSettle();
+
+    expect(find.text('使用这张'), findsOneWidget);
+    await tester.tap(find.text('使用这张'));
+    await tester.pumpAndSettle();
+    expect(results.single, 'a-1');
+  });
+
+  testWidgets('不可重试失败（压缩后仍超限）：只给「重新选择」，不给「重试」', (tester) async {
+    compressor.sizePerQuality = {80: 20 * 1024 * 1024, 60: 15 * 1024 * 1024};
+    await pumpSheet(tester);
+    await tester.pumpAndSettle();
+
+    expect(find.text('图片过大，压缩后仍超过 10 MB'), findsOneWidget);
+    expect(find.text('重试'), findsNothing, reason: '重试同一张必然再失败，给重试钮是误导');
+    expect(find.text('重新选择'), findsOneWidget);
+  });
+
+  testWidgets('用户在系统选择器里取消 → 空态可再次选择，pop 结果为 null', (tester) async {
+    picker = FakeMediaImagePicker(const []);
+    final results = await pumpSheet(tester);
+    await tester.pumpAndSettle();
+
+    expect(find.text('还没有选择图片'), findsOneWidget);
+    expect(find.text('选择图片'), findsOneWidget);
+
+    // 关闭 sheet：未走到 ready，不交付任何 assetId。
+    await tester.tapAt(const Offset(10, 10));
+    await tester.pumpAndSettle();
+    expect(results.single, isNull);
+  });
+}