추가 시스템

- 스와이프 시 태그 획득
- 파벌 우호도 시스템
- 미스터리 시스템 (미스터리 보드, 퀘스트 방식의 미스터리 해결)
- 우호도에 따른 주간 의회 표결

docs/Project SS PRD.md

@@ -1,49 +1,32 @@
-# Project SS 제품 요구 사항 정의서 (PRD)
 
 ## 1. 프로젝트 개요
-- **프로젝트명:** Project SS (가제: 비밀 결사단)
+- 프로젝트명: Project SS (가제: 비밀 결사단)
-- **장르:** 로그라이크 경영 시뮬레이션 / 엔진 빌딩 / 정치 스릴러
+- 장르: 로그라이트 권력 시뮬레이션 / 엔진 빌딩 / 정치 스릴러
-- **타겟 유저:** * 'Reigns', 'Papers, Please' 류의 딜레마/내러티브 선택 게임 선호 유저
+- 플랫폼: 모바일 웹앱 및 하이브리드 앱 (세로 모드 전용)
-    - '윙스팬', '테라포밍 마스' 류의 시너지/엔진 빌딩 보드게임 선호 유저
+- 핵심 가치 (Core Value):
-- **플랫폼:** 모바일 웹 (웹앱) 및 하이브리드 앱 환경 (Portrait 중심)
+	1. 원하는 자원과 태그를 수집하기 위한 [능동적 딜레마 스와이프]
-- **핵심 가치:** * **"선택의 딜레마와 기회비용"** (정답이 없는 차악의 선택)
+	2. 모은 자원을 폭발시켜 미스터리를 해결하고 자산을 얻는 [엔진 빌딩]
-    - **"자산 시너지 빌드업"** (나만의 이득 창출 엔진 구축)
+	3. 사상적 우호도에 기반하여, 필요할 때만 권력을 개입시키는 [선택적 정치 공작]  
-    - **"정치적 표적 견제"** (플레이어의 엔진을 부수려는 의회의 현실적 압박)
 
 ## 2. 주요 기능 요구사항 (Functional Requirements)
-### 2.1. 동적 데이터베이스 (Live DB) 연동
+### 2.1. 데이터 관리 (Live DB)
-- **Google Sheets 연동:** 하드코딩 없이 구글 시트(CSV)를 Fetch하여 게임 데이터로 사용.
+- Google Sheets Sync: 사건(결재 카드), 파벌, 자산, 미스터리 등 게임 내 모든 수치와 텍스트를 구글 시트에서 Fetch하여 로드하는 구조 필수.
-- **데이터 정규화 (Smart Parsing):** 대소문자, 공백 등 기획자의 입력 오류를 방어하는 파싱 로직 구현.
+- 상태 관리 (State Management): 세션 내 플레이어의 4대 속성, 획득한 태그, 파벌별 우호도 수치를 실시간으로 추적 및 업데이트해야 함.
-- **오프라인 폴백 (Fallback):** 네트워크 통신 실패 시 내장된 기본 데이터로 자동 전환되어 게임 진행 보장.
 
-### 2.2. 결재 상호작용 (Swipe Interface)
+### 2.2. [메인 화면] 결재 시스템 (A vs B Swipe)
-- **Tinder-like 스와이프:** 카드를 좌우로 드래그하여 거절(Left) / 승인(Right) 판정.
+- 기능: 메인 화면 중앙의 카드를 좌/우로 드래그하여 투입할 부서(대응 방식)를 선택.
-- **롱프레스 (Override):** 법안에 의해 잠긴(Lock) 카드를 0.8초 이상 길게 눌러 신임도(HP)를 대가로 '강제 돌파'.
+- 오버레이 피드백: 드래그 중 화면 좌우측 및 상단에 예상되는 획득 자원과 태그 아이콘을 시각적으로 미리 표시(Preview).
-- **예측 오버레이 (Prediction Feedback):** 카드를 드래그하는 동안 수치 증감(예산, 엔트로피, 신임도, 파벌 지분)을 화살표와 색상으로 미리 시각화.
 
-### 2.3. 자산 시너지 엔진 (Asset Synergy Build)
+### 2.3. [미스터리 모달] 미스터리 보드 시스템 (Mystery Dossier)
-- **자산 획득 및 인벤토리:** 사건 결재 보상으로 '태그(Tag)'가 부여된 자산 획득.
+- 조건부 팝업: 조건(엔트로피 달성, 특정 태그 N개 누적 등) 만족 시 보드(별도 UI 모달)에 새로운 미스터리 항목 동적 생성.
-- **패시브 시너지 (Combo System):** 보유한 자산의 동일 태그(예: `군사`, `오컬트`)가 특정 개수 이상 모이면 콤보 스킬(Rule-bending, 예: 거절 패널티 무시) 발동.
+- 상태 이상(디버프) 처리: 미결재 상태의 미스터리가 보드에 존재할 경우, 매 턴(스와이프)마다 지정된 디버프 수치(예: 신임도 -2) 자동 차감 로직 구현.
-- **자산 매각:** 자금을 즉시 확보하는 대신 의심도나 엔트로피가 급증하는 매각 리스크 로직 구현.
+- 해결 및 보상 처리: 플레이어가 요구되는 '빌드업 태그'와 재화를 지불하고 '해결' 버튼 클릭 시, 디버프 제거 및 지정된 '자산(Asset)'을 인벤토리에 추가.
 
+### 2.4. [주간 의회 모달] 정치 및 우호도 시스템 (Affinity & Parliament)
+- 스펙트럼 로직: 플레이어의 '성향 태그'가 변경될 때마다 8개 파벌의 우호도 상태(5단계)를 자동 재계산 및 업데이트.
+- 액션 개입 (Intervention): 주간 의회 페이즈 진입 시, 특정 조건(우호도)을 만족하는 파벌을 대상으로 '정치 자본'을 지불하여 액션(이면 계약, 블랙리스트)을 트리거하는 버튼 활성화.
+- 카운터 입법: 적대 파벌은 플레이어가 가장 많이 보유한 '빌드업 태그'를 파악하여, 해당 기능을 정지시키는 카운터 법안을 상정하는 타겟팅 로직 필요.
 
-### 2.4. 의회 및 정치 시스템 (Parliament & Sabotage)
+## 3. UI/UX 및 비기능 요구사항
-- **제로섬 라이벌리:** 특정 파벌 지분 상승 시, 적대 파벌의 지분이 즉시 하락하는 연결 로직.
+- 뷰포트 최적화: 좁은 모바일 화면에서 카드 스와이프 영역(메인)과 스탯/로그 영역을 침범하지 않도록 dvh 기반의 레이아웃 설계.
-- **표적 법안 (Targeted Sabotage):** 현재 플레이어가 가장 많이 보유한 '자산 태그'를 파악하여, 해당 빌드를 무력화하는 카운터 법안을 의회에서 최우선 상정.
+- 조작 피드백: 미스터리 해결, 정치 액션 실행, 게임 오버 발생 시 강력한 햅틱 진동 및 사운드 효과 필수.
-- **로비 시스템:** 의회 투표(여당안 vs 야당안) 단계에서 비자금을 소모하여 소수 정당(Swing Voter)의 표를 매수하는 인터랙션.
-
-### 2.5. 자원 관리 모델 (Resource Management)
-- **예산 칸막이:** 총 예산과 발신 부서 예산의 이중 체크. 부서 예산 부족 시 '적자' 상태(추후 패널티) 부여.
-- **엔트로피의 역설:** 단순 (승인=해결/거절=위험)을 탈피하여, 각 카드 데이터에 설정된 비선형적 엔트로피 증감값 적용.
-- **감사 의심도 & 비자금:** 횡령과 로비를 위한 이면 자원 시스템 관리.
-
-## 3. 비기능 요구사항 (Non-Functional Requirements)
-- **UI 반응성:** 모바일 환경의 Safe Area를 고려하고, 기기 해상도(vh/vw)에 반응하여 카드가 화면을 벗어나지 않도록 제한 (`dvh` 사용 권장).
-- **조작 피드백:** 롱프레스 성공, 카드 넘김, 법안 잠금 등 주요 액션 시 Haptic Feedback(진동) 적용.
-- **접근성:** 시각적 효과뿐만 아니라 텍스트로도 현재 상황과 잠금 사유가 명확히 인지될 것.
-
-## 4. 마일스톤 및 페이즈
-- **Phase 1 (코어 루프):** DB 파싱, 스와이프 결재, 5대 자원 증감, 주간 결산 기본 루프 완성.
-- **Phase 2 (엔진 빌딩 & 정치):** 자산 태그 시너지 로직 구현, 의회 2단계(선포 및 입법) + 로비 시스템 + 표적 법안 로직 구현.
-- **Phase 3 (폴리싱):** UI 오버레이 연출 고도화, BGM/SFX 연동, 엔딩 및 Act 진행 조건 추가.
-

docs/Project SS 기획서.md

@@ -1,70 +1,88 @@
-# Project SS 게임 기획서 (GDD)
 
-## 1. 게임 개요
+## 코어 루프 (Core Game Loop)
-- **로그라인:** 얇아지는 현실의 장막 속, 초자연적 위협을 막아야 하는 비밀 결사단의 국장이 되어 관료제와 파벌 정치의 틈바구니에서 아슬아슬한 결재 서류에 도장을 찍는 게임.
+게임은 다음 4개의 톱니바퀴가 반복되며 굴러가는 구조를 가집니다.
-- **핵심 재미 요소:**
+1. 사건 대응 (스와이프): 매 턴 사건 카드가 등장하며, 유저는 [어느 부서를 투입할지(A vs B)] 선택합니다. 이를 통해 재화와 태그를 획득합니다.
-    1. 무조건적인 선(善)이 없는 상황에서 자원과 정치를 맞바꾸는 **[고뇌의 스와이프]**
+2. 빌드업 (미스터리 보드): 획득한 태그와 재화가 쌓이면 **[미스터리]**가 해금됩니다. 방치 시 페널티를 받으며, 재화를 소모해 해결하면 시너지를 내는 **[자산(엔진)]**을 획득합니다.
-    2. 태그를 모아 강력한 콤보를 터뜨리는 **[자산 시너지 빌드업]**
+3. 정치적 반작용 (우호도 스펙트럼): 유저의 선택(성향)에 따라 파벌들이 자동적으로 우호/적대 상태로 재편성됩니다.
-    3. 나의 빌드업을 부수려고 달려드는 파벌들의 **[표적 정치 공세(입법)]** 방어
+4. 난관 돌파 (주간 의회): 주말이 되면 적대 파벌이 유저의 엔진을 부수는 **[카운터 법안]**을 냅니다. 유저는 권력을 개입(이면 계약 등)시켜 이를 방어하고 다시 일상 업무로 돌아갑니다.
+
+## 2. 속성 정의 (Attributes Definition)
+이 게임의 모든 행동과 목표, 패배 조건은 다음 속성들에 의해 결정됩니다.
+
+### 2.1. 4대 핵심 재화 (자원)
+- 🧬 변칙 데이터 (Anomaly Data): 연구/포획 시 획득. [미스터리 해결]에 소모되는 필수 성장 재화.
+- 👑 정치 자본 (Political Clout): 은폐/통제 시 획득. [의회 액션]에 소모되는 필수 통제 재화.
+- ⏱️ 엔트로피 (Entropy): 종말 척도 (0~100%).
+	- 효과: 일정 구간마다 시민 패닉 단계 상승 (게임 내 억까 이벤트 등장 확률 증가).
+	- 패배 조건: 100% 도달 시 즉시 [세계 멸망 엔딩 (Game Over)].
+- 🛡️ 신임도 (Trust): 대중과 기구의 지지율. (플레이어의 HP)
+	- 패배 조건: 0에 도달 시 즉시 [국장 숙청 엔딩 (Game Over)].
     
 
-## 2. 코어 게임 루프
+### 3.2. 2대 태그 시스템 (결재 시 이중 획득)
-### 2.1. Micro Loop (일일 업무: 평일 5턴)
+- 🏷️ 빌드업 태그 (군사, 과학, 정보, 오컬트, 자본): 미스터리 해금 조건이자, 보유한 자산(엔진)의 시너지 발동 조건이 되는 실질적 재료.
-1. **아침 브리핑:** 이번 주 아젠다/퀘스트 확인, 보유 자산의 패시브 효과(예산 수급 등) 적용.
+- 🧭 성향 태그 (지배, 순응, 은폐, 혼돈): 파벌의 우호도를 결정짓고, 최종 엔딩의 분기를 나누는 사상적 나침반.
-2. **결재 (스와이프):**
-    - 결재 서류(카드) 등장. (부서/파벌/딜레마/잠금 여부 확인)
-    - 플레이어는 **승인(우측)**, **거절(좌측)**, 또는 신임도를 태워 쇠사슬을 끊는 **강행 돌파(롱프레스)** 중 선택.
-3. **결과 반영:** 예산 소모, 엔트로피 증감, 파벌 지분 변동(라이벌 동반 하락).
 
-### 2.2. Macro Loop (주간 의회: 주말)
+### 3.3. 파벌 우호도 5단계 (성향 태그에 의해 자동 변경)
-1. **지분 갱신:** 평일 동안 모인 배당금(코인)에 따라 8개 파벌의 지분율 재산정.
+1. 👑 핵심 동맹: 태그 공명. 유저의 주력 빌드업 속도 가속화.
-2. **Phase 1 (아젠다 선포):** 제1주주가 다음 한 주의 환경 변수(패시브 룰)와 퀘스트(목표) 강제 하달.
+2. 🤝 우호: 주간 의회 시, 유저에게 유리한 버프 법안 자동 상정.
-3. **Phase 2 (입법 전쟁):** * 플레이어의 빌드업을 저격하는 **여당안(A)**과 경쟁하는 **야당안(B)** 상정.
+3. ⚖️ 중립: 아무 효과 없음. (이면 계약 액션의 타겟)
-    - 플레이어는 **[비자금]**을 소모해 소수 정당을 매수(로비).
+4. ⚔️ 적대: 주간 의회 시, 유저의 주력 태그를 박살 내는 카운터 법안 자동 상정.
-    - 50% 이상 지분을 얻은 법안이 가결되어 다음 주 결재의 **잠금(Lock) 제약**으로 작동.
+5. 🔥 파국: 성향이 극악이거나 블랙리스트 지정 시 도달. 법안 대신 극단적 '사보타주 테러(강제 페널티)' 이벤트 발생.
 
-## 3. 핵심 시스템 기획
+## 4. UI 화면 중심 시스템 정의
+이 게임의 시스템은 크게 3개의 UI 화면을 중심으로 나뉘며, 각 화면에서 할 수 있는 행동이 곧 게임의 규칙입니다.
 
-### 3.1. 결재와 딜레마 (Approval & Dual-Lock)
+### 4.1. [메인 집무실 화면] : 결재 및 태그 수집 시스템
-- **엔트로피의 역설:** 위험한 마법을 허가해 사건을 해결하면 파벌 지분은 얻지만 세계관은 불안정해진다(엔트로피 상승). 사건을 무시하면 엔트로피가 폭등하지만 예산을 아낄 수 있다. 정답이 없는 딜레마의 연속.
+유저가 가장 많은 시간을 보내는 기본 화면입니다.
-- **양방향 잠금 (Dual-Lock):** 발효된 법안(예: _사살 금지법_) 태그가 안건 태그(`kill`)와 겹치면 승인 방향으로 드래그가 쇠사슬에 걸려 막힌다.
+- UI 구조: 중앙에 틴더 형태의 스와이프 카드. 좌/우측에 대응 부서 아이콘 노출.
-- **오버라이드 (강행 돌파):** 국가적 위기 시 0.8초간 카드를 꾹 눌러, 플레이어의 HP인 **[신임도 -20]**을 대가로 쇠사슬을 박살 내고 강제 승인한다.
+- 시스템 규칙:
+	- 카드는 '사건'을 의미하며, 좌우 스와이프는 '투입할 부서'를 의미합니다.
+	- 드래그 방향에 따라 명확히 어떤 자원(데이터, 자본, 신임도 등)과 태그(빌드업, 성향)를 획득/상실할지 미리 보여줍니다. (예산 제약 없음)
+	- 결재 완료 즉시 상단의 4대 재화 수치와 누적 태그 현황판이 업데이트됩니다.
 
-### 3.2. 엔진 빌딩: 자산 시너지 (Asset Synergy)
+### 3.2. [미스터리 결재판 화면] : 퀘스트 및 엔진 빌딩 시스템
-보드게임 '테라포밍 마스', '윙스팬'의 재미를 차용하여 단순 텍스트 게임의 한계를 돌파한다.
+유저가 직접 진척도를 관리하고 보상을 수령하는 서브 모달 창입니다.
-- **태그 수집:** 자산은 고유 태그(`군사`, `오컬트`, `자본` 등)를 가짐.
+- UI 구조: 현재 해금된 미스터리 목록 리스트. 각 항목에 [해결 비용], [방치 페널티], [보상 자산] 명시.
-- **빌드업 (Combo):** 같은 태그를 모을수록 사기적인 능력이 발동됨.
+- 시스템 규칙:
-    - _군사 1개:_ 작전부 비용 -10% / _군사 3개:_ 강행 돌파 시 신임도 패널티 면제.
+	- 해금: 특정 빌드업 태그가 N개 모이거나, 엔트로피가 N%를 넘으면 새로운 미스터리가 리스트에 추가됩니다.
-- **전략성:** 이번 판은 어떤 태그 조합(빌드)으로 갈지 유저 스스로 목표를 설정하게 됨.
+	- 디버프: 리스트에 미스터리가 남아있는 동안, 메인 화면에서 결재를 1회 할 때마다 지속 페널티(예: 엔트로피 자동 +1)가 부과됩니다.
+	- 해결: 유저가 요구되는 '빌드업 태그'와 '변칙 데이터'를 소모해 버튼을 누르면 미스터리가 지워지며, 인벤토리에 **[자산(패시브 엔진)]**이 추가됩니다.
+	- 승리 조건: 세계관급 재앙인 **[종결 미스터리 3종]**을 이 화면에서 모두 해결하면, 누적된 성향에 따른 **[진엔딩]**이 출력되며 승리합니다.
 
-### 3.3. 의회의 표적 견제 (Targeted Sabotage)
+### 3.3. [주간 의회 화면] : 파벌 정치 및 난관 돌파 시스템
-유저가 엔진 빌딩의 단맛을 볼 때쯤, 현실적인 정치 견제가 들어온다.
+일정 턴(예: 7턴) 경과 시 강제로 진입하는 이벤트 화면입니다.
-- **질투와 공포:** 유저가 `군사` 태그 자산을 모아 콤보를 터뜨리면, `군사`를 혐오하는 반대 파벌의 적대감이 극에 달한다.
+- UI 구조:
-- **저격 입법:** 주말 의회에서 의도적으로 **"모든 군사 자산 무효화 및 유지비 부과"** 같은 카운터 법안이 1순위로 상정된다.
+	- 상단: 현재 상정된 법안의 내용과 상정 주체(적대 파벌).
-- **로비의 필요성:** 유저는 공들여 쌓은 엔진이 박살 나는 것을 막기 위해, 비자금을 쏟아부어 로비하거나 싫어하는 정당의 비위(악성 안건 승인)를 맞춰 지분을 방어해야 하는 진흙탕 정치를 경험하게 된다.
+	- 중단: 8개 파벌의 현재 우호도 스펙트럼 현황.
+	- 하단: 유저가 개입할 수 있는 2개의 '액션 버튼(이면 계약, 블랙리스트)'.
+- 시스템 규칙:
+	- 난관 발생: 적대 파벌은 유저 인벤토리에 가장 많은 '빌드업 태그'를 무력화하는 카운터 법안을 상정합니다.
+	- 능동적 방어 (액션): 유저는 상정된 법안을 막기 위해 아래의 선택을 할 수 있습니다.
+		1. 액션 포기: 법안이 통과되어 자산이 정지되는 페널티를 그대로 수용합니다.
+		2. [이면 계약] 실행: 정치 자본을 지불하고 우호도 [중립] 파벌을 선택합니다. 해당 파벌이 거부권을 행사해 법안이 즉시 무효화됩니다.
+		3. [블랙리스트] 실행: 정치 자본 지불 없이 [적대] 파벌을 탄압합니다. 해당 파벌은 [🔥파국] 상태가 되어 테러를 준비하지만, 유저는 다음 주 동안 이 파벌의 안건을 부결시킬 때마다 대량의 신임도와 정치 자본을 보상으로 수확할 수 있습니다.
 
-## 4. 콘텐츠 스펙
+## 4. UI 텍스트 레이아웃 구조 (가이드라인)
-### 4.1. 4대 자원 및 게이지
+AI 및 개발 단계를 위한 최소화된 텍스트 기반 레이아웃 구조입니다.
-1. **총 예산 / 부서 예산:** 합법적 자금. 부서 예산 부족 시 '적자' 상태 돌입.
+### [Header: 대시보드 영역]
-2. **비자금:** 그림자 경제로 획득. 로비 및 급전용. (사용 시 의심도 증가)
+- [🛡️ 신임도: 80%] [⏱️ 엔트로피: 45%]
-3. **신임도 (HP):** 플레이어의 정치 생명. 0% 달성 시 **탄핵 (Game Over)**.
+- [🧬 변칙 데이터: 150] [👑 정치 자본: 30]
-4. **엔트로피:** 종말 타이머. 100% 달성 시 **세계 멸망 (Game Over)**.
+- 우측 상단 햄버거 메뉴: [인벤토리(자산) 및 성향 로그 보기] 버튼
 
-### 4.2. 8대 파벌 매트릭스 (라이벌 구조)
+### [Body: 스와이프 결재 영역 (메인)]
-- **[무력]** 철의 수호당 (사살) ⚔️ 지식 보존당 (생포)
+- (좌측 표시기): ⚔️ 작전부 투입 (군사 태그 / 신임도+ / 변칙 데이터-)
-- **[순수]** 진화 미래당 (개조) ⚔️ 순수 인간당 (순혈)
+- [카드 UI]: <사건 타이틀> 및 <사건 설명 텍스트>
-- **[패권]** 세계 재건당 (양지화) ⚔️ 침묵의 장막당 (은폐)
+- (우측 표시기): 🔬 R&D부 투입 (과학 태그 / 변칙 데이터+ / 신임도-)
-- **[자본]** 차원 무역당 (상업) ⚔️ 고대 공존당 (숭배)
-- _로직:_ 한 쪽의 지분이 상승하면 라이벌의 지분은 반드시 깎이는 제로섬 구조.
 
-### 4.3. 시나리오 (진행도)
+### [Footer: 네비게이션 영역]
-- **1막 (1~4주차):** 균열. 일상적 괴담과 횡령, 자산 빌드업 시작기.
+- [ 📁 미스터리 결재판 (🚨 1) ] 버튼 (알림 배지 표시)
-- **2막 (5~8주차):** 붕괴. S급 위협 등장, 완성되어 가는 엔진과 의회의 본격적인 표적 견제.
+- [ 🏛️ 이번 주 의회 동향 ] 버튼
-- **3막 (9~12주차):** 혼란. 극단적 딜레마 요구, 아젠다의 폭주, 자산의 붕괴.
-- **4막 (13주차~):** 심판. 현재 의회를 장악한 파벌에 따라 결말(멀티 엔딩) 결정.
-
-## 5. UI / UX 방향성
-- **시각 연출 (Diegetic):** 1인칭 국장 시점. 어두운 마호가니 데스크, 붉은색과 푸른색의 잉크 도장. 불길하게 깜빡이는 종말 시계.
-- **예측 오버레이:** 조작 스트레스 방지를 위해, 카드 드래그 시 중앙에 팝업이 떠서 수치 증감과 라이벌 지분 하락을 색상별로 직관적으로 보여줌.
-- **의회 연출:** 거대 양당의 법안(A/B)을 상단에 대치시키고, 하단에는 매수 가능한 소수 정당들을 뱃지(칩) 형태로 나열하여 터치 시 즉각적으로 표가 뒤집히는 애니메이션 제공.
 
+### [Modal: 주간 의회 팝업]
+- [상정된 법안]: <과학 기술 통제법> (효과: 과학 자산 모두 무효화)
+- [파벌 현황표]: (철의 수호당: 우호) / (순수 인간당: 적대) ...
+- [개입 액션 패널]:
+	- [ 🤝 이면 계약 (비용: 👑 50) ] -> 터치 시 중립 파벌 목록 드롭다운
+	- [ 🎯 블랙리스트 지정 (무료) ] -> 터치 시 적대 파벌 목록 드롭다운
+	- [ ⏩ 개입 없이 법안 통과 (방관) ]