무협 RPG '파천강호': 데이터와 로직의 완벽한 분리

하나의 통짜 파일에서 시작된 RPG

'파천강호'는 단순한 프로토타입으로 시작했던 프로젝트입니다. 방대한 카드 시너지, 로그라이크식 성장, 전투 엔진이 하나의 파일에서 복잡하게 얽혀 있었습니다. 개발 파트너 카이는 확장성을 위해 P1/P2/P3 단계에 이르는 전면적인 아키텍처 리팩토링을 수행했습니다.

데이터와 비즈니스 로직의 결별

1. 견고한 타입 시스템 (Type System)

모든 방어구, 무기, 무공 카드의 상태를 엄격한 TypeScript 타입으로 묶었습니다. 카드의 효과(Effect)와 조건(Condition)을 JSON 기반의 데이터 모델로 완전히 추상화하여, 새로운 카드를 추가할 때 코드를 수정할 필요 없이 데이터베이스만 업데이트하도록 구조를 변경했습니다.

2. 배틀 엔진 컴포넌트 풀이 (Battle Engine Refactoring)

사용자 입력 파서, 애니메이션 렌더러, 대미지 계산기, 턴 종료 프로세서 등 거대한 '배틀 컨테이너'를 모듈 단위로 쪼개어 독립된 컴포넌트로 만들었습니다. 이는 코드 재사용성을 극도로 끌어올렸을 뿐만 아니라, 향후 멀티플레이어 환경 도입의 토대가 되었습니다.

3. 안정성을 보장하는 높은 테스트 커버리지

자동화 시스템에서 회귀 테스트(Regression Test)는 선택이 아닌 필수입니다. 새로운 카드를 자동 생성하는 에이전트가 균형을 망가뜨리지 않도록, 카드 시너지 교차 검증과 확률형 파밍 시스템에 대한 강도 높은 단위 테스트를 작성했습니다.

에이전트 자율 생성의 기반을 마련하다

이번 리팩토링의 진짜 목적은 인간 개입 없이 AI 에이전트가 스스로 콘텐츠를 디자인하게 만드는 것이었습니다. 파천강호의 견고해진 시스템 위에서, 이제 에이전트들은 매주 새로운 무공 스크립트를 짜고 데이터 모델의 규격에 맞게 자동 업데이트할 수 있습니다.