합동 수호전 화면을 세워 허브의 잠긴 길 하나를 실제로 열었다

입구·편성·판 세 장면을 만들고 허브의 `합동 수호전`을 눌러 들어가게 했다.
이제 잠긴 길은 `장거리 개척` 하나뿐이다.

무대와 명령 슬롯은 **스테이지 수호전과 같은 위젯**을 쓴다. 사본을 만들면
비용·잠금·상성 표시가 언젠가 갈라진다. 그래서 독을 화면에 묶어 두던 것을
풀었다 — 이전에는 `expedition`·`event`·`state`를 통째로 받아 그 안에서
컨트롤러까지 직접 불렀는데, 이제 전투·대원 목록·잠금 여부와 콜백만 받는다.
떼어 낸 직후 앱 459건이 그대로 통과하는 것을 먼저 확인하고 다음으로 갔다.

예고 두 줄은 독이 함께 그린다. 처음에는 화면 쪽에 따로 만들었다가 같은
예고가 두 번 나오는 것을 보고 옮겼다. 잠꼬대는 주 예고 **바로 아래**에
붙고, 스크린리더도 `주 의도` 다음에 `잠꼬대` 순으로 읽는다.

교대는 뒤에서 기다리는 카드를 눌러 시작하고, 누구와 바꿀지 물은 뒤에
보낸다. 지쳐서 물러난 대원은 눌리지 않고 이유를 그대로 적는다. 남은 교대
횟수도 숫자로 보여 준다.

허브 잠금은 지금 보고 있는 지역이 아니라 **계정 단위**로 판단한다. 지역
기준으로 재면 첫 지역을 깬 사람이 다음 지역 지도를 보는 동안 잠긴 것처럼
보인다 — 같은 실수를 `깊은 조사`에서 한 번 했던 자리다.

만들면서 두 가지가 걸렸다. 무대는 자기 자리를 `Positioned`로 잡아서 배경이
Stack을 열어 주지 않으면 화면 전체가 무너진다. 그리고 독 높이를 238로
박아 뒀더니 예고가 한 줄 늘어난 순간 아래가 15px 잘렸다 — 숫자를 키우는
대신 독이 제 키대로 서고 무대가 남는 자리를 가져가게 했다.

깨어난 뒤 화면은 반복 보상이 없다는 것을 숨기지 않는다. 다시 오는 이유가
재화가 아니라 연출과 숙련이라고 처음부터 적어 둔다.

Author: easygap

app/lib/core/routing/app_router.dart

@@ -10,6 +10,7 @@ import '../../features/auth/presentation/signup_screen.dart';
 import '../../features/auth/presentation/splash_screen.dart';
 import '../../features/chat/presentation/chat_screen.dart';
 import '../../features/expedition/presentation/expedition_screen.dart';
+import '../../features/expedition/presentation/joint_guard_screen.dart';
 import '../../features/expedition/presentation/skill_book_screen.dart';
 import '../../features/gallery/presentation/gallery_screen.dart';
 import '../../features/garden/presentation/garden_screen.dart';
@@ -155,6 +156,11 @@ final routerProvider = Provider<GoRouter>((ref) {
         parentNavigatorKey: rootNavigatorKey,
         builder: (context, state) => const ExpeditionScreen(),
       ),
+      GoRoute(
+        path: '/joint-guard',
+        parentNavigatorKey: rootNavigatorKey,
+        builder: (context, state) => const JointGuardScreen(),
+      ),
       GoRoute(
         // 장착은 출발 전과 캐릭터 상세 두 곳에서 연다. 전투 중에는 열지 않는다.
         path: '/skill-books/:plantId',

app/lib/features/expedition/data/joint_guard_repository.dart

@@ -0,0 +1,98 @@
+import 'package:dio/dio.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+import '../../../core/api/api_providers.dart';
+import '../../../core/error/api_exception.dart';
+import '../domain/expedition_combat_models.dart';
+import '../domain/joint_guard_models.dart';
+
+/// 합동 수호전 API.
+///
+/// 판을 **만드는** 요청은 헤더의 `Idempotency-Key`가, 판 **안에서** 일어나는
+/// 행동은 `client_action_id`가 지킨다. 서버의 다른 쓰기 경로와 같은 계약이다.
+class JointGuardRepository {
+  JointGuardRepository(this._dio);
+
+  final Dio _dio;
+
+  Future<JointGuardEntry> getEntry() => guardApi(() async {
+        final response = await _dio.get<Map<String, dynamic>>(
+          '/adventure/joint-guard',
+        );
+        return JointGuardEntry.fromJson(response.data ?? const {});
+      });
+
+  Future<JointGuardRun?> getActive() => guardApi(() async {
+        final response = await _dio.get<Map<String, dynamic>>(
+          '/adventure/joint-guard/active',
+        );
+        final data = response.data;
+        if (data == null || data['run'] == null) return null;
+        return JointGuardRun.fromJson(data);
+      });
+
+  Future<JointGuardRun> start({
+    required String beastCode,
+    required String difficulty,
+    required List<Map<String, Object?>> formation,
+    required String idempotencyKey,
+  }) =>
+      guardApi(() async {
+        final response = await _dio.post<Map<String, dynamic>>(
+          '/adventure/joint-guard',
+          data: {
+            'beast_code': beastCode,
+            'difficulty': difficulty,
+            'formation': formation,
+          },
+          options: Options(headers: {'Idempotency-Key': idempotencyKey}),
+        );
+        return JointGuardRun.fromJson(response.data ?? const {});
+      });
+
+  Future<JointGuardRun> submitTurn({
+    required int runId,
+    required ExpeditionCombatCommand command,
+    required int expectedRevision,
+    required String clientActionId,
+  }) =>
+      guardApi(() async {
+        final response = await _dio.post<Map<String, dynamic>>(
+          '/adventure/joint-guard/$runId/turns',
+          data: {
+            'command': {
+              'member_id': command.memberId,
+              'action': command.action,
+              if (command.choice != null) 'choice': command.choice,
+            },
+            'expected_revision': expectedRevision,
+            'client_action_id': clientActionId,
+          },
+        );
+        return JointGuardRun.fromJson(response.data ?? const {});
+      });
+
+  Future<JointGuardRun> swap({
+    required int runId,
+    required int outMemberId,
+    required int inMemberId,
+    required int expectedRevision,
+    required String clientActionId,
+  }) =>
+      guardApi(() async {
+        final response = await _dio.post<Map<String, dynamic>>(
+          '/adventure/joint-guard/$runId/swap',
+          data: {
+            'out_member_id': outMemberId,
+            'in_member_id': inMemberId,
+            'expected_revision': expectedRevision,
+            'client_action_id': clientActionId,
+          },
+        );
+        return JointGuardRun.fromJson(response.data ?? const {});
+      });
+}
+
+final jointGuardRepositoryProvider = Provider<JointGuardRepository>(
+  (ref) => JointGuardRepository(ref.watch(dioProvider)),
+);

app/lib/features/expedition/domain/expedition_combat_models.dart

@@ -304,6 +304,7 @@ class ExpeditionBattleEnemy {
     required this.weakness,
     required this.weaknessLabel,
     required this.intent,
+    this.extraIntents = const [],
     this.nextIntent,
     this.elite = false,
     this.weakElement,
@@ -323,6 +324,10 @@ class ExpeditionBattleEnemy {
   final String weaknessLabel;
   final ExpeditionBattleIntent intent;
 
+  /// 같은 라운드에 함께 오는 예고들. 합동 수호전의 잠꼬대와 여운이 여기
+  /// 들어오고, 예고가 하나뿐인 전투에서는 비어 있다.
+  final List<ExpeditionBattleIntent> extraIntents;
+
   /// 다음 라운드 예고. `잔향 읽기`를 쓴 전투에서만 서버가 열어 준다.
   ///
   /// 책을 안 썼으면 `null`이라 화면에 아무것도 안 나온다 — 늘 보이면 그 책이
@@ -348,6 +353,10 @@ class ExpeditionBattleEnemy {
         weakness: json['weakness'] as String? ?? 'insight',
         weaknessLabel: json['weakness_label'] as String? ?? '관찰',
         intent: ExpeditionBattleIntent.fromJson(_combatMap(json['intent'])),
+        extraIntents: (json['extra_intents'] as List? ?? const [])
+            .whereType<Map<String, dynamic>>()
+            .map(ExpeditionBattleIntent.fromJson)
+            .toList(growable: false),
         nextIntent: json['next_intent'] is Map<String, dynamic>
             ? ExpeditionBattleIntent.fromJson(
                 json['next_intent'] as Map<String, dynamic>,