chore(client): 归档原型阶段未提交改动（binding/logic/view 分层与各页迭代）

为什么：客户端原型在 14d7bd3 之后又做了一轮（页面分层、发现页、分类滑动、播放器控件等），
一直留在工作区没入库。下一批账号链路要改其中的 app.dart / home_view / player_view / mine_view，
先归档这批既存改动，本批的实际 diff 才说得清边界。

只归档，不改行为：当前工作区 flutter analyze 0 问题、flutter test 148 全过。

test/catalog/catalog_controller_test.dart

@@ -1,39 +1,131 @@
 import 'package:flutter_test/flutter_test.dart';
-import 'package:nontonki/core/data/repositories/catalog_repository.dart';
 import 'package:nontonki/core/data/models/drama.dart';
+import 'package:nontonki/core/data/models/home_feed.dart';
+import 'package:nontonki/core/data/models/play_ticket.dart';
+import 'package:nontonki/core/data/repositories/catalog_repository.dart';
 import 'package:nontonki/core/data/services/catalog_controller.dart';
 
 void main() {
-  test(
-    'empty catalog is distinct from a failed load, and retry recovers',
-    () async {
-      final repo = ScriptedCatalogRepository();
-      final controller = CatalogController(repo);
-      await controller.load();
-      expect(controller.dramas, isEmpty);
-      expect(controller.error, isNull);
+  test('空目录与加载失败可区分，重试后恢复', () async {
+    final repository = ScriptedCatalogRepository();
+    final controller = CatalogController(repository);
 
-      repo.fail = true;
-      await controller.load();
-      expect(controller.error, isNotNull);
+    await controller.load();
+    expect(controller.dramas, isEmpty);
+    expect(controller.error, isNull);
 
-      repo.fail = false;
-      repo.items = await DemoCatalogRepository().fetchDramas();
-      await controller.load();
-      expect(controller.error, isNull);
-      expect(controller.dramas, hasLength(3));
-      expect(controller.dramas.first.episodes.length, 3);
-    },
-  );
+    repository.fail = true;
+    await controller.load();
+    expect(controller.error, isNotNull);
+
+    repository.fail = false;
+    repository.feed = HomeFeed(
+      sections: [
+        FeedSection(code: 'hot', title: '热门推荐', dramas: [_card('1')]),
+      ],
+    );
+    await controller.load();
+    expect(controller.error, isNull);
+    expect(controller.dramas, hasLength(1));
+    expect(controller.sections.single.title, '热门推荐');
+  });
+
+  test('详情按需加载：同一部短剧只请求一次', () async {
+    final repository = ScriptedCatalogRepository();
+    final controller = CatalogController(repository);
+    repository.feed = HomeFeed(
+      sections: [
+        FeedSection(code: 'hot', title: '热门推荐', dramas: [_card('1')]),
+      ],
+    );
+    await controller.load();
+
+    final card = controller.dramas.single;
+    expect(card.episodes, isEmpty);
+
+    final detail = await controller.requireDetail(card);
+    expect(detail.episodes, hasLength(2));
+    expect(repository.detailCalls, 1);
+
+    // 第二次已经是详情，直接复用，不再请求
+    await controller.requireDetail(detail);
+    expect(repository.detailCalls, 1);
+    expect(controller.dramas.single.episodes, hasLength(2));
+  });
+
+  test('播放票据：可播放写入地址，锁定集保持无地址', () async {
+    final repository = ScriptedCatalogRepository();
+    final controller = CatalogController(repository);
+    repository.tickets['10'] = const PlayTicket(
+      episodeId: '10',
+      accessible: true,
+      accessType: PlayTicket.free,
+      playUrl: '/files/episode/10.mp4',
+    );
+
+    const free = Episode(id: '10', number: 1, title: '免费集', isFree: true);
+    final resolved = await controller.resolvePlay(free);
+    expect(resolved.videoUrl, '/files/episode/10.mp4');
+
+    const locked = Episode(
+      id: '11',
+      number: 2,
+      title: '锁定集',
+      isFree: false,
+      locked: true,
+    );
+    final lockedResolved = await controller.resolvePlay(locked);
+    expect(lockedResolved.videoUrl, isEmpty);
+  });
 }
 
+Drama _card(String id) => Drama(
+  id: id,
+  title: 'Drama $id',
+  synopsis: '简介 $id',
+  posterUrl: '/files/$id.jpg',
+);
+
+Drama _detail(String id) => Drama(
+  id: id,
+  title: 'Drama $id',
+  synopsis: '简介 $id',
+  posterUrl: '/files/$id.jpg',
+  detailLoaded: true,
+  episodes: const [
+    Episode(id: '1', number: 1, title: '第一集', isFree: true),
+    Episode(id: '2', number: 2, title: '第二集', isFree: false),
+  ],
+);
+
 class ScriptedCatalogRepository implements CatalogRepository {
   bool fail = false;
-  List<Drama> items = const [];
+  HomeFeed feed = const HomeFeed();
+  int detailCalls = 0;
+  final Map<String, PlayTicket> tickets = {};
 
   @override
-  Future<List<Drama>> fetchDramas() async {
+  Future<HomeFeed> fetchHomeFeed() async {
     if (fail) throw StateError('offline');
-    return items;
+    return feed;
+  }
+
+  @override
+  Future<HomeFeed> fetchDiscoverFeed() async => feed;
+
+  @override
+  Future<Drama> fetchDrama(String dramaId) async {
+    detailCalls++;
+    return _detail(dramaId);
+  }
+
+  @override
+  Future<PlayTicket> resolvePlay(String episodeId) async {
+    return tickets[episodeId] ??
+        PlayTicket(
+          episodeId: episodeId,
+          accessible: false,
+          accessType: PlayTicket.noMedia,
+        );
   }
 }

test/catalog/demo_media_test.dart

@@ -1,26 +0,0 @@
-import 'package:flutter/services.dart';
-import 'package:flutter_test/flutter_test.dart';
-import 'package:nontonki/core/data/repositories/catalog_repository.dart';
-
-void main() {
-  TestWidgetsFlutterBinding.ensureInitialized();
-
-  test('all mock entries reuse one bundled local demo video', () async {
-    final dramas = await DemoCatalogRepository().fetchDramas();
-    expect(dramas, hasLength(3));
-    expect(dramas.every((drama) => drama.episodes.length == 3), isTrue);
-    final paths = {
-      for (final drama in dramas)
-        for (final episode in drama.episodes) episode.assetPath,
-    };
-    expect(paths, {'assets/media/demo_clip.mp4'});
-    expect(
-      dramas.every(
-        (drama) => drama.episodes.every((episode) => episode.isFree),
-      ),
-      isTrue,
-    );
-    final bytes = await rootBundle.load(paths.single);
-    expect(bytes.lengthInBytes, greaterThan(1000000));
-  });
-}

test/catalog/home_feed_category_test.dart

@@ -1,22 +0,0 @@
-import 'package:flutter_test/flutter_test.dart';
-import 'package:nontonki/pages/home/home_feed_sections.dart';
-import 'package:nontonki/core/data/repositories/catalog_repository.dart';
-
-void main() {
-  test(
-    'home categories filter demo dramas without changing their media',
-    () async {
-      final dramas = await DemoCatalogRepository().fetchDramas();
-      final sections = HomeFeedSections(dramas);
-
-      expect(sections.indicesFor(HomeFeedCategory.recommended), [0, 1, 2]);
-      expect(sections.indicesFor(HomeFeedCategory.animated), [0]);
-      expect(sections.indicesFor(HomeFeedCategory.liveAction), [1, 2]);
-      expect(sections.indicesFor(HomeFeedCategory.following), isEmpty);
-      expect(
-        sections.dramaAt(HomeFeedCategory.liveAction, 0).title,
-        'City Lights & Velvet Nights',
-      );
-    },
-  );
-}