ProjectSS/docs/Project SS PRD.md

Project SS 제품 요구 사항 정의서 (PRD)

1. 프로젝트 개요

• 프로젝트명: Project SS (가제: 비밀 결사단)
• 장르: 로그라이크 경영 시뮬레이션 / 엔진 빌딩 / 정치 스릴러
• 타겟 유저: * 'Reigns', 'Papers, Please' 류의 딜레마/내러티브 선택 게임 선호 유저
  • '윙스팬', '테라포밍 마스' 류의 시너지/엔진 빌딩 보드게임 선호 유저
• 플랫폼: 모바일 웹 (웹앱) 및 하이브리드 앱 환경 (Portrait 중심)
• 핵심 가치: * "선택의 딜레마와 기회비용" (정답이 없는 차악의 선택)
  • "자산 시너지 빌드업" (나만의 이득 창출 엔진 구축)
  • "정치적 표적 견제" (플레이어의 엔진을 부수려는 의회의 현실적 압박)

2. 주요 기능 요구사항 (Functional Requirements)

2.1. 동적 데이터베이스 (Live DB) 연동

• Google Sheets 연동: 하드코딩 없이 구글 시트(CSV)를 Fetch하여 게임 데이터로 사용.
• 데이터 정규화 (Smart Parsing): 대소문자, 공백 등 기획자의 입력 오류를 방어하는 파싱 로직 구현.
• 오프라인 폴백 (Fallback): 네트워크 통신 실패 시 내장된 기본 데이터로 자동 전환되어 게임 진행 보장.

2.2. 결재 상호작용 (Swipe Interface)

• Tinder-like 스와이프: 카드를 좌우로 드래그하여 거절(Left) / 승인(Right) 판정.
• 롱프레스 (Override): 법안에 의해 잠긴(Lock) 카드를 0.8초 이상 길게 눌러 신임도(HP)를 대가로 '강제 돌파'.
• 예측 오버레이 (Prediction Feedback): 카드를 드래그하는 동안 수치 증감(예산, 엔트로피, 신임도, 파벌 지분)을 화살표와 색상으로 미리 시각화.

2.3. 자산 시너지 엔진 (Asset Synergy Build)

• 자산 획득 및 인벤토리: 사건 결재 보상으로 '태그(Tag)'가 부여된 자산 획득.
• 패시브 시너지 (Combo System): 보유한 자산의 동일 태그(예: 군사, 오컬트)가 특정 개수 이상 모이면 콤보 스킬(Rule-bending, 예: 거절 패널티 무시) 발동.
• 자산 매각: 자금을 즉시 확보하는 대신 의심도나 엔트로피가 급증하는 매각 리스크 로직 구현.

2.4. 의회 및 정치 시스템 (Parliament & Sabotage)

• 제로섬 라이벌리: 특정 파벌 지분 상승 시, 적대 파벌의 지분이 즉시 하락하는 연결 로직.
• 표적 법안 (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 진행 조건 추가.