이클립스 흐름 — 배너 진입 · 이벤트 버튼 · 오버레이 · 방어 진행 표시 · 흔들기 감지 통일

app/lib/features/home/widgets/home_hero.dart

@@ -48,8 +48,12 @@ class HomeHero extends StatefulWidget {
     this.onItem,
     this.miniMap,
     this.zapButtonKey,
+    this.eclipseButton,
   });
 
+  /// 이클립스 이벤트 버튼(`516:88124`). 경보 단계부터 행성 아래 가운데에 뜬다.
+  final Widget? eclipseButton;
+
   /// 화면 하단에 떠 있는 ZAP 버튼([HomeZap])의 키 — 기여 연출이 이 자리에서 행성으로 날아간다.
   final GlobalKey? zapButtonKey;
 
@@ -181,35 +185,57 @@ class _HomeHeroState extends State<HomeHero> {
                       builder: (context, box) => SizedBox(
                         width: double.infinity,
                         height: math.min(planet, box.maxHeight),
-                        child: widget.unjoined
-                            ? _EmptyPlanet(
-                                onCreateNebula: widget.onCreateNebula,
-                                onJoin: widget.onJoin,
-                              )
-                            : growth.isNebula
-                            ? _Nebula(
-                                key: _planetKey,
-                                // 탄생은 창립자만(Q-PN-01 A안) — 다른 멤버에게는 안내 · 탭이 없다.
-                                ready: growth.nebulaReady && growth.isFounder,
-                                onBirth: widget.onBirth,
-                              )
-                            : Stack(
-                                clipBehavior: Clip.none,
-                                children: [
-                                  Positioned.fill(
-                                    child: LivePlanet25D(
-                                      onOpenHistory: widget.onOpenHistory,
+                        child: Stack(
+                          clipBehavior: Clip.none,
+                          children: [
+                            Positioned.fill(
+                              child: widget.unjoined
+                                  ? _EmptyPlanet(
+                                      onCreateNebula: widget.onCreateNebula,
+                                      onJoin: widget.onJoin,
+                                    )
+                                  : growth.isNebula
+                                  ? _Nebula(
                                       key: _planetKey,
-                                      fandomId: fandomId,
-                                      watch: watchPlanet,
-                                      stage: growth.stage,
-                                      image: 'assets/figma/planet-home.png',
-                                      size: math.min(planet, box.maxHeight),
-                                      glow: AppColors.neonViolet,
+                                      // 탄생은 창립자만(Q-PN-01 A안) — 다른 멤버에게는 안내 · 탭이 없다.
+                                      ready:
+                                          growth.nebulaReady &&
+                                          growth.isFounder,
+                                      onBirth: widget.onBirth,
+                                    )
+                                  : Stack(
+                                      clipBehavior: Clip.none,
+                                      children: [
+                                        Positioned.fill(
+                                          child: LivePlanet25D(
+                                            onOpenHistory: widget.onOpenHistory,
+                                            key: _planetKey,
+                                            fandomId: fandomId,
+                                            watch: watchPlanet,
+                                            stage: growth.stage,
+                                            image:
+                                                'assets/figma/planet-home.png',
+                                            size: math.min(
+                                              planet,
+                                              box.maxHeight,
+                                            ),
+                                            glow: AppColors.neonViolet,
+                                          ),
+                                        ),
+                                      ],
                                     ),
-                                  ),
-                                ],
+                            ),
+                            // 이클립스 이벤트 버튼 — 명세 `516:88125` 「성운(행성) 아래 중앙 정렬」.
+                            // 사본 `Group 563` 은 행성 상자(212) 안 아래쪽에 겹쳐 놓인다.
+                            if (widget.eclipseButton case final button?)
+                              Positioned(
+                                left: 0,
+                                right: 0,
+                                bottom: 0,
+                                child: Center(child: button),
                               ),
+                          ],
+                        ),
                       ),
                     ),
                   ),