POP 내역 총 보유 · 예약 · 사용 가능 3구분 · 온보딩 추천인 코드

app/lib/features/my/my_data.dart

@@ -322,6 +322,7 @@ class MyProfile {
     this.userLevel = 1,
     this.passportTier = PassportTier.silver,
     required this.balancePop,
+    this.reservedPop = 0,
     required this.steps,
     required this.completedQuests,
     required this.planetTiers,
@@ -346,9 +347,15 @@ class MyProfile {
   /// 대표 팬덤의 Passport Tier(B-65 · 10/3 #10 사용자 × 팬덤). 팬덤별 값은 [planetTiers].
   final PassportTier passportTier;
 
-  /// 보유 POP(활동).
+  /// 총 보유 POP — 일반 + 기여 + 예약(G-05 `총 보유 = 예약 + 사용 가능`).
   final int balancePop;
 
+  /// 예약 — 검토 대기 보상처럼 묶여 있어 아직 쓸 수 없는 몫(서버 `pendingActivity`).
+  final int reservedPop;
+
+  /// 사용 가능 = 총 보유 − 예약.
+  int get availablePop => balancePop - reservedPop;
+
   /// 누적 걸음. 명세 `549:22058` 의 프로필 카드 항목.
   final int steps;
   final int completedQuests;

app/lib/features/my/my_repository_firestore.dart

@@ -23,7 +23,7 @@ import '../../core/i18n/app_locale.dart';
 /// - Passport `users/{uid}/passports/{fandomId}.tier` — **팬덤별**(10/3 #10 · 9/21 5절). 없으면 SILVER.
 ///   탈퇴한 팬덤의 Passport 도 지우지 않고 보인다(ARCHIVED).
 /// - Badge `users/{uid}/badges`(상세정의 4장 · 별첨 1 ②-5)
-/// - 잔액 `users/{uid}/wallet/main.activityBalance`
+/// - 잔액 `users/{uid}/wallet/main` — 사용 가능 = `activityBalance + supportBalance`, 예약 = `pendingActivity`(G-05)
 /// - 행성별 기여 `fandoms/{fandomId}` + `fandoms/{fandomId}/members/{uid}.contributedPop`
 /// - POP 원장 `users/{uid}/popTransactions` (최신순 · 커서 `createdAt`)
 /// - 공지 `notices`
@@ -126,7 +126,8 @@ class FirestoreMyRepository extends SampleMyRepository {
       userExp: user.intOr('userExp'),
       userLevel: user.intOr('userLevel').clamp(1, 1 << 31),
       passportTier: primaryTier,
-      balancePop: wallet.intOr('activityBalance'),
+      balancePop: wallet.intOr('activityBalance') + wallet.intOr('supportBalance') + wallet.intOr('pendingActivity'),
+      reservedPop: wallet.intOr('pendingActivity'),
       steps: user.intOr('steps'),
       completedQuests: await completedF,
       planetTiers: tiers,

app/lib/features/my/pop_history_screen.dart

@@ -109,7 +109,7 @@ class _PopHistoryScreenState extends State<PopHistoryScreen> {
         itemCount:
             1 + (_entries.isEmpty ? 1 : _entries.length) + (_hasMore ? 1 : 0),
         itemBuilder: (context, i) {
-          if (i == 0) return _Balance(pop: profile.balancePop);
+          if (i == 0) return _Balance(profile: profile);
           i -= 1;
           if (_entries.isEmpty && i == 0) {
             return ColoredBox(
@@ -148,11 +148,14 @@ class _PopHistoryScreenState extends State<PopHistoryScreen> {
   }
 }
 
-/// 보유 POP — 번개 20 + 「POP」 18/500 민트 · 값 36/900.
+/// 보유 POP — 번개 20 + 「POP」 18/500 민트 · 값 36/900(명세 `554:23714` 현재 보유 POP = 총 보유).
+///
+/// 그 아래 「총 보유 · 예약 · 사용 가능」 세 값(정책 설계서 잔액 구분 · G-05 · QA 2-29).
+/// Figma 에는 이 줄이 없어 배치는 해석 확인 대상이다.
 class _Balance extends StatelessWidget {
-  const _Balance({required this.pop});
+  const _Balance({required this.profile});
 
-  final int pop;
+  final MyProfile profile;
 
   @override
   Widget build(BuildContext context) => Container(
@@ -182,7 +185,7 @@ class _Balance extends StatelessWidget {
           child: OverflowBox(
             maxHeight: 48,
             child: Text(
-              formatPop(pop),
+              formatPop(profile.balancePop),
               style: const TextStyle(
                 fontFamily: AppFonts.body,
                 fontSize: 36,
@@ -193,6 +196,25 @@ class _Balance extends StatelessWidget {
             ),
           ),
         ),
+        const SizedBox(height: 24),
+        Row(
+          children: [
+            for (final (label, value) in [
+              (context.l10n.popTotal, profile.balancePop),
+              (context.l10n.popReserved, profile.reservedPop),
+              (context.l10n.popAvailable, profile.availablePop),
+            ])
+              Expanded(
+                child: Column(
+                  children: [
+                    Text(label, style: myText(12, FontWeight.w500, color: MyColors.muted)),
+                    const SizedBox(height: 4),
+                    Text(formatPop(value), style: myText(14, FontWeight.w700)),
+                  ],
+                ),
+              ),
+          ],
+        ),
       ],
     ),
   );