[Docs] 문서 구조 정리 및 프로젝트 제목 통일 (#88)

* docs 정리

* 사용자 시나리오 문서 복구

Author: learncold

.github/ISSUE_TEMPLATE/lightweight-task.yml

@@ -53,7 +53,7 @@ body:
       label: Deliverable
       description: State what concrete output or change should exist when the task is done.
       placeholder: |
-        - Add `docs/GitHub Project.md`
+        - Add `docs/process/GitHub Project.md`
         - Capture the expected team workflow
     validations:
       required: true

AGENTS.md

@@ -68,7 +68,7 @@
   - `Epic` for larger parent work
   - `Implementation Task` for `Engine` / `Domain` / `Application` / `Build` work
   - `Lightweight Task` for `Docs` / `Chore` / `Analysis` work
-- GitHub Project guidance is documented in `docs/GitHub Project.md`.
+- GitHub Project guidance is documented in `docs/process/GitHub Project.md`.
 - PR titles must follow `[Area] short summary`.
 - Allowed PR areas:
   - `Engine`
@@ -93,9 +93,10 @@
 
 ## Docs
 - After any changes to the project, ensure the documents remain consistent.
-- Architecture notes: `docs/프로젝트 구조.md`
-- Project workflow notes: `docs/GitHub Project.md`
-- Requirements and overview docs are under `docs/`.
+- Architecture notes: `docs/architecture/프로젝트 구조.md`
+- Project workflow notes: `docs/process/GitHub Project.md`
+- Requirements and overview docs are under `docs/product/`.
+- Use `docs/README.md` as the entry point for the document map.
 
 ## Review Priorities
 - Broken build or preset mismatch

README.md

@@ -0,0 +1,55 @@
+# SafeCrowd
+
+SafeCrowd는 ECS 기반 군중 시뮬레이션과 안전 의사결정 지원을 목표로 하는 Qt 데스크톱 애플리케이션입니다.  
+건물, 행사장, 대피 시나리오 같은 실제 운영 환경을 가정해 군중 흐름, 병목, 위험 징후를 비교 가능한 형태로 분석하는 것을 목표로 합니다.
+
+## 핵심 목표
+
+- 실제 공간 구조를 바탕으로 시뮬레이션 가능한 레이아웃을 구성한다.
+- 여러 운영 대안을 시나리오로 비교해 위험 차이를 확인한다.
+- Qt 기반 UI와 분리된 ECS 엔진 구조를 유지한다.
+
+## 아키텍처
+
+프로젝트는 `application -> domain -> engine` 계층을 유지합니다.
+
+- `src/application`: Qt UI와 애플리케이션 조립
+- `src/domain`: SafeCrowd 도메인 로직
+- `src/engine`: 재사용 가능한 ECS 엔진
+
+상세 구조는 [docs/architecture/프로젝트 구조.md](docs/architecture/프로젝트 구조.md)를 기준 문서로 사용합니다.
+
+## 빠른 시작
+
+전체 앱 빌드:
+
+```powershell
+cmake --preset windows-debug
+cmake --build --preset build-debug
+ctest --preset test-debug
+```
+
+Qt 앱 없이 빠르게 검증:
+
+```powershell
+cmake --preset windows-debug-no-app
+cmake --build --preset build-engine-debug
+cmake --build --preset build-engine-domain-debug
+cmake --build --preset build-no-app-debug
+ctest --preset test-no-app-debug
+```
+
+앱 빌드에는 `vcpkg.json`의 `qtbase` 의존성이 필요합니다.
+
+## 문서
+
+- [docs/README.md](docs/README.md): 문서 전체 안내
+- [docs/product/개요서.md](docs/product/개요서.md): 프로젝트 개요와 이해당사자
+- [docs/product/사용자 시나리오.md](docs/product/사용자 시나리오.md): 대표 사용자 흐름
+- [docs/product/위험 정의.md](docs/product/위험 정의.md): 위험 및 사고 모델 정의
+- [docs/process/GitHub Project.md](docs/process/GitHub Project.md): 이슈, 프로젝트, PR 운영 규칙
+
+## 기여 방식
+
+기본 흐름은 `issue -> branch -> PR -> merge`입니다.  
+문서와 저장소 운영 규칙은 [CONTRIBUTING.md](CONTRIBUTING.md)를 따릅니다.

docs/README.md

@@ -0,0 +1,28 @@
+# SafeCrowd 문서 안내
+
+`docs/`는 기준 문서를 모아 두는 위치다. 진행 중 메모, 임시 TODO, 작업 상태 추적은 GitHub Issues와 Project에서 관리한다.
+
+## 문서 구조
+
+- `architecture/`: 계층 구조, 책임, 디렉터리 규칙 같은 오래 유지할 설계 기준
+- `process/`: GitHub Project, 이슈/PR 규칙 같은 협업 절차
+- `product/`: 개요, 사용자 시나리오, 위험 정의, 백로그 같은 제품 요구와 범위
+- `references/`: 외부 조사 자료와 튜토리얼. 기준 문서의 보조 근거로만 사용
+- `제출용/`: 학교 제출 산출물. 저장소 운영 기준 문서와 분리해 보관
+
+## 시작점
+
+- [architecture/프로젝트 구조.md](architecture/프로젝트 구조.md)
+- [process/GitHub Project.md](process/GitHub Project.md)
+- [product/개요서.md](product/개요서.md)
+- [product/사용자 시나리오.md](product/사용자 시나리오.md)
+- [product/위험 정의.md](product/위험 정의.md)
+- [product/Product Backlog.md](product/Product Backlog.md)
+
+## 유지 규칙
+
+- 한 사실은 한 문서만 기준으로 삼는다.
+- 구조 변경은 `architecture/`, 협업 규칙 변경은 `process/`, 요구 변경은 `product/`를 먼저 갱신한다.
+- 외부 링크, 조사 메모, 튜토리얼은 `references/`로 보낸다.
+- 제출 양식과 산출물은 `제출용/`에 두고 기준 문서처럼 직접 참조하지 않는다.
+- 이 저장소는 별도 `adr/` 폴더를 두지 않는다. 구조 결정은 `architecture/프로젝트 구조.md`에, 협업 규칙 결정은 `process/GitHub Project.md`와 `CONTRIBUTING.md`에 반영한다.

docs/설계 구조.md docs/architecture/프로젝트 구조.mddocs/설계 구조.md renamed to docs/architecture/프로젝트 구조.md

@@ -1,7 +1,7 @@
 # Product Backlog
 
 ## Project Name
-**SafeCrowd: ECS 게임 엔진 기반 군중 행동 시뮬레이션 및 의사결정 지원 시스템**
+**SafeCrowd: 군중 안전 시뮬레이터**
 
 02조  
 202002520 은민수  
@@ -21,7 +21,7 @@
 
 | 항목 | 내용 |
 | --- | --- |
-| Project Name | SafeCrowd: ECS 게임 엔진 기반 군중 행동 시뮬레이션 및 의사결정 지원 시스템 |
+| Project Name | SafeCrowd: 군중 안전 시뮬레이터 |
 | Version | v1.0 |
 | 작성일 / 수정일 | 2026/04/01 / 2026/04/03 |
 | Product Owner (PO) | 02조 공동 |

docs/GitHub Project.md docs/process/GitHub Project.mddocs/GitHub Project.md renamed to docs/process/GitHub Project.md

@@ -1,6 +1,6 @@
 # SafeCrowd 개요 
 ## SafeCrowd란?
-ECS 게임 엔진 기반 군중 행동 시뮬레이션 및 의사 결정 지원 시스템 
+SafeCrowd: 군중 안전 시뮬레이터
 
 ## 대상 이해당사자 (stakeholder)
 - 건물 관리자 및 안전 관리자