HOME · GALAXY · 행성·성운 상세 · 팬덤 라운지 · 이클립스 화면

2026-09-29 17:06:48 +09:00
parent c4e9a9430e
commit 5de04ac281
44 changed files with 14898 additions and 16 deletions
@@ -0,0 +1,154 @@
+import 'package:cloud_firestore/cloud_firestore.dart' show QueryDocumentSnapshot;
+
+import '../../core/data/backend.dart';
+import '../planet/planet_data.dart' show rankWithTies;
+import 'galaxy_data.dart';
+
+/// 갤럭시 맵의 실 서버 구현 — 화면 대조 원장 F2.
+///
+/// 순위는 앱에서 정렬하지 않고 서버의 `fpiScore` 내림차순을 그대로 받는다.
+/// 클라이언트가 순위를 다시 매기면 화면마다 값이 갈린다.
+class FirestoreGalaxyRepository implements GalaxyRepository {
+  FirestoreGalaxyRepository(this._backend);
+
+  final Backend _backend;
+
+  /// 한 화면에 띄우는 행성 수. 더 늘리면 궤도가 겹쳐 읽히지 않는다.
+  static const int visibleCount = 12;
+
+  @override
+  Future<GalaxySnapshot> load() async {
+    final uid = _backend.requireUid;
+    final db = _backend.db;
+
+    final userSnap = await db.doc('users/$uid').get();
+    final user = userSnap.data() ?? const <String, dynamic>{};
+    // 대표 팬덤(C-15). `primaryFandomId` 가 없던 계정은 옛 `fandomId` 를 쓴다.
+    final myFandomId = user.strOr('primaryFandomId', user.strOr('fandomId'));
+    // 「가입 또는 생성한 행성/성운」 — 최신 가입순. 시안 그리드가 세 칸이라 셋만 읽는다.
+    // ponytail: 모아보기 리스트 그리드(명세 §2.58-2)를 붙이면 limit 과 페이지를 연다.
+    final membershipsF = db
+        .collection('users/$uid/memberships')
+        .orderBy('joinedAt', descending: true)
+        .limit(3)
+        .get();
+
+    final fandomsF = db
+        .collection('fandoms')
+        .orderBy('fpiScore', descending: true)
+        .limit(visibleCount)
+        .get();
+    final walletF = db.doc('users/$uid/wallet/main').get();
+    final eventF = db
+        .collection('galaxyEvents')
+        .orderBy('createdAt', descending: true)
+        .limit(1)
+        .get();
+
+    // ZAP 단가는 운영값이다(Figma 「Zap 버튼」 = 어드민 설정). 로그인 전에도 읽을 수
+    // 있게 `firestore.rules` 가 `config/{id}` 를 열어 두었다.
+    final policyF = db.doc('config/policy').get();
+
+    final fandoms = (await fandomsF).docs;
+    final wallet = (await walletF).data() ?? const <String, dynamic>{};
+    final events = (await eventF).docs;
+    final policy = (await policyF).data() ?? const <String, dynamic>{};
+
+    // 순위는 1·1·3 공동 순위(C-19). 실값 `fpiScore` 동률만 같은 순위이고 동점 내부는
+    // fandomId 오름차순으로 고정한다 — 쿼리 순서(동점은 ID 내림차순)를 그대로 쓰지 않는다.
+    // Stage0 성운은 순위를 매기기 **전에** 뺀다(B-08 · B-17) — 성운이 끼면 정식 행성의
+    // 순위 번호가 밀린다. 성운은 맨 바깥 궤도 자리(정식 수 + 1)에 둔다.
+    bool isNebula(QueryDocumentSnapshot<Map<String, dynamic>> d) => d.data()['stage'] == 0;
+    final formal = fandoms.where((d) => !isNebula(d)).toList();
+    final planets = <PlanetNode>[
+      for (final (doc, rank) in rankWithTies(
+        formal,
+        (d) => d.data()['fpiScore'] is num ? d.data()['fpiScore'] as num : 0,
+        (d) => d.id,
+      ))
+        _node(doc.id, doc.data(), rank, myFandomId),
+      for (final doc in fandoms.where(isNebula))
+        _node(doc.id, doc.data(), formal.length + 1, myFandomId),
+    ];
+    final byId = {for (final p in planets) p.id: p};
+    final membershipIds = [for (final d in (await membershipsF).docs) d.id];
+    // 맵(FPI 상위 12)에 없는 가입 팬덤만 따로 읽는다.
+    final missing = await Future.wait([
+      for (final id in membershipIds.where((id) => !byId.containsKey(id)))
+        db.doc('fandoms/$id').get(),
+    ]);
+    for (final doc in missing) {
+      final data = doc.data();
+      if (data != null) byId[doc.id] = _node(doc.id, data, formal.length + 1, myFandomId);
+    }
+
+    return GalaxySnapshot(
+      planets: planets,
+      myPop: wallet.intOr('activityBalance'),
+      zapPop: policy.intOr('zapPop', 10),
+      event: events.isEmpty ? null : _event(events.first.data()),
+      // Zap 은 가입·생성한 사용자에게만 보인다(Figma 「Zap 버튼」 규칙).
+      joined: myFandomId.isNotEmpty,
+      memberships: [for (final id in membershipIds) ?byId[id]],
+    );
+  }
+
+  PlanetNode _node(String id, Map<String, dynamic> data, int rank, String myFandomId) => PlanetNode(
+    id: id,
+    stage: switch (data['stage']) {
+      int n when n >= 0 && n <= 6 => n,
+      _ => null,
+    },
+    colorKey: data['colorKey'] is String ? data['colorKey'] as String : null,
+    name: data.strOr('name', id),
+    rank: rank,
+    fpi: data.intOr('fpiScore'),
+    members: data.intOr('memberCount'),
+    online: data.intOr('onlineCount'),
+    isMine: id == myFandomId,
+  );
+
+  @override
+  Future<void> setPrimary(String fandomId) =>
+      _backend.call('fnPrimaryFandomSet', {'fandomId': fandomId});
+
+  /// ZAP — 행성 성장 기여(B-23). 차감은 `fn-pop-spend` 가 한다.
+  ///
+  /// `count` 를 함께 보내 **원장 한 행에 묶음 횟수를 남긴다**. 연타를 한 호출로
+  /// 묶으면 `amount` 만으로는 횟수를 복원할 수 없어, MY 의 「Zap N 회」가 행 수로
+  /// 계산되어 실제보다 작게 나온다.
+  @override
+  Future<ZapResult> zap({
+    required String fandomId,
+    required int count,
+    required String clientSeq,
+  }) async {
+    final snapshot = await _backend.db.doc('config/policy').get();
+    final zapPop = (snapshot.data() ?? const <String, dynamic>{}).intOr('zapPop', 10);
+    final data = await _backend.call('fnPopSpend', {
+      'popType': 'activity',
+      'amount': zapPop * count,
+      'count': count,
+      'reasonCode': 'ZAP_CONTRIBUTION',
+      'idempotencyKey': 'zap:$fandomId:$clientSeq',
+      'fandomId': fandomId,
+      'refPath': 'fandoms/$fandomId',
+    });
+    final lots = data['lotRefs'];
+    final contributedPop = lots is List && lots.isNotEmpty && lots.every(
+      (lot) => lot is Map && lot['delta'] is int && (lot['delta'] as int) < 0,
+    ) ? lots.fold<int>(0, (sum, lot) => sum - (lot['delta'] as int)) : null;
+    return ZapResult(
+      contributedPop: contributedPop,
+      txId: data['txId'] as String? ?? '',
+      balanceAfter: (data['balanceAfter'] as num?)?.toInt() ?? -1,
+    );
+  }
+
+  GalaxyEvent _event(Map<String, dynamic> data) => GalaxyEvent(
+    kind: data.strOr('kind') == 'eclipse'
+        ? GalaxyEventKind.eclipse
+        : GalaxyEventKind.itemUsed,
+    message: data.strOr('message'),
+  );
+}