7강. 프로젝트 구조 설명: 폴더·Scene·모듈·데이터의 역할 정리하기

?1. 이번 강의에서 해결할 문제

파일 목록 전체나 긴 코드를 붙이면 구조가 더 잘 보이지 않습니다. 독자가 핵심 진입점과 책임, 데이터가 이동하는 방향을 빠르게 찾도록 설명합니다.

✓2. 학습 목표

✓이번 강의를 마치면

• 핵심 폴더·Scene·모듈만 선택해 트리로 표현합니다.
• 각 구성 요소의 책임을 한 문장으로 설명합니다.
• 입력부터 결과까지 데이터 흐름을 연결합니다.

◇3. 핵심 개념

구조 설명은 저장소 탐색 지도입니다. 모든 파일을 나열하지 않고 진입점, 핵심 규칙, 데이터, 화면·출력, 테스트가 어디에 있는지 보여 줍니다. 로컬 사용자명과 절대 경로는 제거합니다.

✎4. 단계별 실습

PowerShell · 실행 위치: 프로젝트 루트

Get-ChildItem -Depth 2 | Select-Object FullName

출력을 그대로 공개하지 말고 필요한 상대 경로만 골라 문서에 옮깁니다.

문서 작업 · 산출물: <PROJECT_ROOT>/docs/architecture.md

docs/architecture.md

# 프로젝트 구조

```text
project/
├─ src/ 또는 Assets/_Project/Scripts/  # 핵심 로직
├─ data/ 또는 Assets/_Project/Data/    # 조정 가능한 규칙
├─ tests/ 또는 Docs/                   # 검증 기록
├─ media/                              # 공개용 화면 자료
└─ README.md                           # 진입 문서
```

## 핵심 책임
| 구성 요소 | 책임 | 하지 않는 일 |
| --- | --- | --- |
| 입력 계층 | 사용자 행동을 명령으로 변환 | 점수 직접 변경 |
| 규칙 계층 | 성공·실패와 결과 계산 | 화면 직접 갱신 |
| 표현 계층 | 상태를 화면·콘솔에 표시 | 규칙 결정 |

## 데이터 흐름
입력 → 검증 → 규칙 계산 → 상태 변경 → 화면·콘솔 갱신

Unity Editor 작업: 실제 Scene과 Prefab 이름이 문서와 같은지 Project 창에서 확인합니다. 코드 작업: 진입 함수와 상태 변경 함수의 상대 경로를 표에 링크합니다.

완료 기준: 핵심 경로 5개 이하, 책임 표 3개 이상과 데이터 흐름 한 줄이 실제 프로젝트와 일치합니다.

§5. 작성 방식이 필요한 이유

역할 중심 설명은 코드 양과 관계없이 설계 의도를 보여 줍니다. 독자는 관심 있는 영역으로 바로 이동하고, 작성자는 한 클래스나 GameManager에 책임이 몰렸는지도 발견합니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• 전체 파일 트리를 붙임: 탐색에 필요한 핵심 경로만 남깁니다.
• 코드를 전부 붙여넣음: 책임과 데이터 흐름을 먼저 설명합니다.
• 로컬 절대 경로 노출: 프로젝트 기준 상대 경로로 바꿉니다.
• 한 관리자에 모든 책임을 설명: 현재 결합을 숨기지 말고 알려진 한계와 개선 방향을 씁니다.

✎7. 직접 실습

✎직접 실습

docs/architecture.md를 작성하세요. 완료 기준은 처음 보는 사람이 1분 안에 진입점, 핵심 규칙, 데이터와 출력 위치를 찾고, 표의 파일 링크가 실제 상대 경로로 열리는 것입니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 전체 파일 목록보다 핵심 구조가 유용한 이유는 무엇인가요?
2. “하지 않는 일” 열은 어떤 설계 정보를 주나요?
3. 절대 경로를 공개 문서에 쓰면 안 되는 이유는 무엇인가요?

■9. 핵심 요약

■핵심 요약

핵심 경로, 구성 요소의 책임과 데이터 흐름만으로 프로젝트 지도를 만듭니다. 실제 파일과 맞는 상대 경로를 사용하고 현재 구조의 한계도 숨기지 않습니다.