Files
ProjectSS/docs/ProjectSS 유저플로우.md
kyoung5seo 31558edcb2 Part A (연대기 ↔ 내러티브 태그 개념 분리) — 문서 6개 반영
시스템 기획서: 내러티브 태그 항목에서 연대기 서술 제거, 연대기를 독립 항목으로 신설
스토리 바이블: "연대기의 편찬" 테마를 '결정 장부' 관점으로 재서술
텍스트 와이어프레임: 팝업을 '세계의 상흔'(태그) / '연대기'(결재 이력) 2종으로 분리, 엔딩 화면에 연대기 요약 블록 추가
비전 문서 / PRD / 유저플로우 / 개발순서: 각각 정의 분리 및 분리 저장 명시
Part B (스니펫 시스템) — B-4 결정사항(은근한 헌신 농도, 고정 마침 도장 리스트) 반영

narrative_tags.json 10종 전체에 snippet(1문장, 숫자 1개, 거리감 있는 관료체) + snippet_type 필드 추가 — 시스템형 7 : 사람형 3 비율. update_csv_tags.js는 이 파일을 생성/가공하지 않아 스크립트 변경 불필요했습니다.
빌드(vite build) 정상 확인.
2026-07-13 21:22:42 +09:00

6.2 KiB

제공해 주신 시스템 기획서를 바탕으로, 플레이어가 게임에 진입하여 종료(엔딩)에 이르기까지 겪게 되는 모든 논리적 흐름과 분기점을 정리한 유저 플로우(User Flow) 문서를 작성했습니다.

이 문서는 프로그래머가 게임의 상태 머신(State Machine)과 화면 전환 로직을 구현할 때 핵심 지도로 활용됩니다.

🔄 유저 플로우 (User Flow)

1. 거시적 게임 루프 플로우 (Macro Game Loop)

플레이어가 게임 앱을 실행하고 다회차 플레이를 반복하는 전체적인 흐름입니다.

  1. 게임 실행 및 메인 타이틀
    • [새 게임 시작] / [도감 확인] / [설정] 선택.
  2. 게임 초기화 세팅
    • 무작위 사건(내러티브) 덱 생성.
    • 무작위 글로벌 지부장(5명) 배치 및 상임 이사회(8명) 포함 총 13명의 그림자 위원회 구성.
    • 국장 취임 (파라미터 0%, 기본 자원 지급).
  3. 핵심 플레이 페이즈 (반복)
    • 결재 루프: 딜레마 카드 드로우 및 스와이프 결정 (토큰 관리, 덱 빌딩).
    • 스토리 페이징 검사: 획득한 [내러티브 태그] 개수(03, 47, 8 이상)에 따라 페이즈 1~3 실시간 전환 및 카드 풀(Pool) 변경.
    • 주간 의회 루프: 일정 턴(결재 횟수) 도달 시 주간 의회 단계 진입하여 법안/탄핵 방어.
  4. 종료 조건 검사 (매 액션 직후)
    • [내부 저항], [엔트로피], [대중 공황] 중 하나라도 5단계(100%) 도달 시 즉시 게임 오버 (붕괴 엔딩).
    • 특정 내러티브 연쇄 달성 또는 파라미터 극단화 시 조기 엔딩 발동.
  5. 결산 및 루프
    • 수집한 파생 엔딩 도감 기록.
    • 다음 회차(1번 단계)로 루프.

2. 결재 단계 미시 플로우 (Micro Flow: Swipe Decision)

화면 중앙의 딜레마 카드를 처리하는 순간의 상세한 논리적 흐름입니다.

  1. 카드 드로우 및 표시
    • 현재 페이즈와 덱의 상태(오염도)에 따라 딜레마 카드 1장이 화면에 등장.
  2. 자동화 엔진(자산) 개입 검사
    • Condition: 인벤토리에 파이프라인 연쇄 반응 자산이 있고, 등장한 카드가 해당 자산의 [트리거]에 부합하는가?
      • Yes -> 자산 효과(입력-변환-출력) 자동 발동 -> 오염 카드 파쇄 또는 자원 획득 등 처리 후 다음 카드 드로우.
      • No -> 플레이어의 조작 대기.
  3. 플레이어 스와이프 조작
    • 플레이어가 카드를 누르고 방향을 지정하여 결과를 미리보기 함.
  4. 선택에 따른 분기 및 결과 적용
    • [일상 딜레마] 선택: 좌/우 방향에 따른 특정 토큰 획득 및 덱에 오염 카드 셔플.
    • [위기 딜레마] 선택: (좌) 토큰 획득+오염 카드 셔플 / (우) 토큰 소모하여 위기 회피.
    • [작전] 선택: (좌) 자원 태그 획득+오염 카드 셔플 / (우) 토큰 소모하여 더 많은 자원 태그 획득.
    • [극비 프로젝트] 선택: (좌/우) 토큰 소모하여 보상(자원/자산) 획득 / (위) 보류 및 버리기.
    • [위기 강타(오염 카드)] 등장: (좌) 토큰/자원 차감 페널티 / (우) 4대 위험 단계(엔트로피, 내부 저항, 대중 공황, 위험 수용 계수) 중 하나 상승.
    • [뉴스 이벤트] 등장: (좌) 보유 자산 제거 페널티 / (우) 4대 위험 단계 중 하나 상승.
  5. 공통 스택 누적
    • 결과에 따라 내러티브 태그(연대기 누적) 및 성향 태그(파벌 우호도 연동) 획득.
  6. 다음 턴 진행

3. 주간 의회 단계 플로우 (Weekly Council Flow)

의회 이벤트 발생 시 국장이 개입하여 위기를 넘기는 흐름입니다.

  1. 의회 이벤트 발생
    • 현재 파벌 우호도 및 국장의 상태 계산.
  2. 안건 상정 분기 검사
    • Condition 1: 적대적 파벌 임원이 2/3(9명) 이상인가?
      • Yes -> [정치적 탄핵안 상정]
      • No -> Condition 2: 현재 의회의 주도권이 동맹인가 파국인가?
        • 동맹 -> [이득 규약 법안 상정] (+자원 태그)
        • 파국 -> [표적 규약 법안 상정] (-자원 태그)
  3. 예상 표결 표시
    • 13명 임원의 우호도에 따른 예상 투표(찬성/반대/미정) 현황 출력.
  4. 국장의 개입 액션 (선택적)
    • 플레이어는 자원을 소모하여 개입하거나 개입 없이 투표 진행 가능.
    • [매수 액션]: 예산 대량 소모 -> 임원 1~2명 강제 찬성 / 위험 수용 계수 +20%.
    • [장부 조작 액션]: 정보 대량 소모 -> 법안 상정 무효화 및 이월 / 엔트로피 +20%.
    • [내부 감사 액션]: 인력 대량 소모 -> 적대 임원 투표권 박탈(기권) / 내부 저항 +20%.
  5. 최종 투표 및 결과 적용
    • 개입이 반영된 최종 투표 결과 출력.
    • 법안 통과 시 자원 태그 증감 적용, 탄핵 가결 시 즉시 [정치적 탄핵 붕괴 엔딩]으로 게임 오버 분기.

4. 엔딩 분기 및 도감 플로우 (Ending Branch Flow)

게임 오버 조건이 충족되었을 때, 어떤 엔딩을 출력할지 결정하는 흐름입니다.

  1. 엔딩 트리거 발동
    • 파라미터 5단계 도달, 탄핵 가결, 특정 내러티브 달성 등 종료 조건 진입.
  2. 엔딩 매트릭스 조건 검사 (우선순위 판별)
    • Check 1: [의회 정치 엔딩] 조건(탄핵+수장 성향 조건)에 부합하는가?
    • Check 2: [내러티브 연쇄 엔딩] 조건(특정 스토리 순서 달성)에 부합하는가?
    • Check 3: [변주된 붕괴 엔딩] 조건(기본 붕괴 + 특정 보유 토큰/자원 태그 조합)에 부합하는가?
    • Check 4: [기본 붕괴 엔딩] (사임, 세계 멸망, 문명 붕괴, 정치적 탄핵) 중 어느 것인가?
  3. 엔딩 결과 화면 출력
    • 조건에 부합하는 가장 높은 우선순위의 텍스트와 연출 출력.
  4. 도감 동기화
    • 출력된 엔딩을 계정 도감 데이터에 '해금(Unlocked)' 처리.
    • 이번 회차의 [연대기](결재 결정 이력)와 [내러티브 태그](세계 상흔) 목록을 각각 분리 저장.