2월 5일 개발일지 - 프로젝트 "Sdokucat"

📅 2026년 2월 5일 개발일지 - 프로젝트 "Sdokucat" 🛠️

🎯 오늘의 목표

• 코드 구조 개선: 로직(Controller)과 뷰(UI)의 역할을 명확히 분리하여 유지보수성 향상.
• 리소스 정리: 산재된 프리팹 파일들을 정리하고 올바른 폴더 구조(Assets/Prefabs)로 이관.
• 스테이지 고도화: 단순한 난이도 시스템을 플레이어의 성장을 자극하는 세분화된 곡선으로 개선.

---

🛠️ 주요 작업 내용

1. 로직과 UI의 분리 (Refactoring) 🧠/👁️

기존에는 UI 스크립트가 게임 데이터까지 관리하는 비효율적인 구조였습니다. 이를 MVC 패턴에 가깝게 분리했습니다.

• MainMenuScene: MainMenuController(로직)와 MainMenuUI(뷰)로 분리.
• GameScene: SudokuGameController(로직)와 SudokuGameUI(뷰)로 분리.
• 이로써 UI 디자인을 수정해도 게임 로직이 깨지지 않고, 반대로 로직을 수정해도 UI 연결이 끊어지지 않게 되었습니다.

2. 프리팹 대청소 🧹

프로젝트 초기에 Resources 폴더에 임시로 저장했던 프리팹들을 정식 폴더로 이사시켰습니다.

• Cleanup Tool 제작: CleanupPrefabsTool을 만들어 SudokuCell 등 사용 중인 에셋은 Assets/Prefabs/UI로 안전하게 옮기고, 구버전 파일은 Legacy 폴더로 격리했습니다.
• 이제 Resources 폴더를 가볍게 유지하여 빌드 사이즈와 로딩 속도 최적화의 기반을 마련했습니다.

3. 자동 복구 도구 완성 🤖

씬 컴포넌트 연결이 자꾸 끊기는 문제를 영구적으로 해결하기 위해 원클릭 복구 툴을 만들었습니다.

• FinalSetupTool: 메뉴에서 클릭 한 번으로 MainMenu와 GameScene의 컨트롤러 생성, UI 연결, 프리팹 연동을 수행합니다. 이제 수동으로 인스펙터를 뒤적거릴 필요가 없습니다.

4. 스테이지 난이도 세분화 (Difficulty Curve) 📈

단순히 Easy/Normal/Hard 3단계로만 나뉘던 시스템을, 스테이지 레벨에 따라 점진적으로 어려워지도록 개선했습니다.

• Easy (1~30): 구멍 30개에서 시작 → 38개까지 증가.
• Normal (31~60): 구멍 40개에서 시작 → 48개까지 증가.
• Hard (61~): 구멍 50개에서 시작 → 58개까지 증가.
• 검증: VerifyDifficultyCurve 툴을 통해 난이도 곡선이 의도대로 그려지는지 시뮬레이션했습니다.

5. 메타게임 완성: 플레이 동기 부여 🏆

게임의 수명을 늘리기 위한 장치들을 구현했습니다.

• 통계 시스템 (Statistics):
  • 난이도별(Easy/Medium/Hard) 승리 횟수, 최고 기록(Best Time), 총 플레이 시간을 저장하고 보여줍니다.
  • 메인 메뉴의 "Statistics" 버튼을 통해 팝업으로 확인할 수 있습니다.
• 일일 도전 (Daily Challenge):
  • 매일 자정마다 변경되는 '오늘의 퍼즐'을 구현했습니다.
  • 날짜(YYYYMMDD)를 시드(Seed)로 사용하여, 전 세계 모든 유저가 동일한 퍼즐을 풀게 됩니다.

6. 긴급 복구 및 유지보수 🏥

작업 중 발생한 UI 유실 및 중복 생성 문제를 해결했습니다.

• MainMenuBuilder 개선: '청소 후 생성(Clean & Build)' 패턴을 적용하여 중복 생성을 방지했습니다.
• SudokuSceneBuilder 안전장치: Canvas 유실 시 자동 복구 기능을 추가하고, 레이아웃 앵커를 미세 조정하여 시각적 완성도를 높였습니다.

---

📝 회고

"자동화"와 "구조화", 그리고 "안정성"의 날이었습니다.
단순히 기능을 만드는 것을 넘어, 에디터 툴(Builder/SetupTool)들이 언제든지 깨진 씬을 "안전하게 다시 만드는(Idempotents)" 능력을 갖추도록 개선했습니다. 덕분에 구조 변경이나 리팩토링 후에도 버튼 한 번으로 1초 만에 복구할 수 있는 자신감이 생겼습니다.
또한 난이도 곡선 세분화와 통계 시스템 도입으로 게임의 깊이를 한 층 더했습니다. 🐱

---

역대급으로 짜증난 날이였네요. 게임씬과 메인메뉴씬을 계속 돌아가면서 날려먹는데... 초창기부터 UI를 프리팹으로 완전 빼는걸 전제로 작업을 해야됐는데 계속 반복작업하고 원인찾는데 시간을 많이 날려먹는 날이네요...

 

추가적으로 안티그래비티가 1월달에 스킬 업데이트가 되었었네요!! 이건 바로 반영하여서 썼는데 만족스럽습니다. ㅎㅎ