작전 진입 마법사와 첫 투입 안내

기본 플레이 동선은 거점 이동 → 작전 게이트에서 F → 작전 설정 → 투입입니다. 개발·자동 시험처럼 거점을 생략하는 실행도 지원하지만, 플레이어가 빈 화면이나 절반만 생성된 작전에 남는 상태는 허용하지 않습니다.

세 단계 결정

단계	플레이어 결정	표시 내용
1. 지역·작전	지역, 난이도, 페널티, 맵 규모	타겟 파밍과 기본 보상
2. 요원·장비	캐릭터, 주·보조 무기, 스킬, 소모품	추가 비용과 출격 가능 여부
3. 검토·투입	최종 계약 확인	총비용, 위험·보상, 데이터 모드, 투입 버튼

화면에는 한 단계만 보입니다. 좌·우 화살표 키 또는 높이 44px 이상의 이전·다음 버튼으로 이동하며, 실제 작전 투입 버튼은 마지막 단계에서만 나타납니다. 설정 화면을 닫았다 다시 열면 1단계부터 시작하되 선택 데이터는 유지합니다.

초기 실행 경로

거점 모듈	설정 모듈	초기 결과
켬	켬	기본 거점. 게이트에서 설정을 연다.
끔	켬	작전 설정 1단계로 직행한다.
켬	끔	설정된 기본 계약으로 작전을 조립한다. 실패하면 거점으로 복구한다.
끔	끔	작전을 직접 조립한다. 실패하면 설정 화면을 열어 복구 선택을 제공한다.

작전 투자 승인 뒤 맵 조립이 실패하면 승인한 비용을 되돌리고, P5 런 유틸리티 상태를 함께 종료하며, 생성 중이던 노드를 제거한 뒤 위 표의 복구 위치로 돌아갑니다. 정산 모듈을 끈 시험 구성에서도 런 ID는 반드시 종료되어 다음 투입을 막지 않습니다.

첫 투입 현장 가이드

한 실행 세션의 첫 작전에서만 화면 상단 중앙에 작은 비차단형 가이드가 나타납니다.

1. 이동과 점멸: 이동 키, 대시 키, 점멸 경로 피해
2. 전투와 자원: 기본 공격, 1·2·3 스킬, 에너지와 쿨타임
3. 방 확보: 진입 스폰, 문 봉쇄, 전멸 뒤 F 보상 회수
4. 탈출: 전투 방 전체 확보, M 전술 지도, 출구의 F

가이드는 플레이를 정지하지 않으며 언제든 건너뛸 수 있습니다. 현재 “첫 투입” 판정은 저장 파일이 아닌 프로세스 세션 기준입니다. 계정별 영구 튜토리얼 기록이 필요해질 때 별도 저장 공급자를 연결할 수 있도록 오버레이 모듈을 분리했습니다.

모듈 경계

• OperationSetupStepFlow: 단계 ID·이동 가능 여부만 소유합니다.
• OperationSetupPresenter: 단계별 표시와 입력 컨트롤만 소유합니다.
• OperationTutorialOverlay: 현장 가이드 내용과 탐색만 소유합니다.
• Game: 기능 플래그에 따라 모듈을 조립하고 진입·실패 복구를 연결합니다.
• 맵 생성, 계약 비용, 장비 선택, 튜토리얼은 서로의 내부 상태를 직접 수정하지 않습니다.

새 아이템·무기·방어구 목록은 필요하지 않아 Google Sheet는 확장하지 않았습니다. 이후 목록형 데이터가 필요한 작업은 기존 실시간 Sheet → 확정 CSV 계약을 그대로 사용합니다.

자동 검증

• 소형·중형·대형 × 표준·베테랑·악몽 9개 조합을 실제 게이트와 최종 투입 버튼으로 실행
• 거점/설정 기능 플래그 조합 4개 초기 경로 확인
• 물리 좌·우 키로 3단계 이동, 마지막 단계 전 투입 버튼 비노출 확인
• 첫 투입 가이드 4단계, 44px 조작 범위, 비차단 상태 확인
• 작전 조립 후 플레이어·맵·계약 일치와 종료 뒤 거점 복귀 확인

실제 플레이 E2E 보기 · 시작 거점 · 모듈 감사