Initial import

docs/features/project-setup.md

@@ -0,0 +1,100 @@
+# 프로젝트 구성 개요
+
+## 목적
+
+현재 저장소의 화면 구조와 문서 체계를 빠르게 파악하기 위한 최신 개요 문서입니다.
+
+## 기술 스택
+
+- React
+- Vite
+- TypeScript
+- Ant Design
+- Recharts
+- React Router
+
+## 최상위 앱 구조
+
+- `src/app/main`: 메인 앱 프레임, 상단 메뉴, 사이드바, 본문, 검색 연동
+- `src/features`: 프로젝트 전용 기능 화면
+- `src/components`: 재사용 가능한 UI 컴포넌트
+- `src/widgets`: 샘플/위젯 단위 UI
+- `docs`: 기능/컴포넌트/작업일지 문서
+- `etc/servers/work-server`: Plan API 연동 서버 자산
+
+## 현재 주요 기능 축
+
+### Docs
+
+- `docs/**/*.md`를 수집해 문서 화면에 노출
+- 작업일지, 기능 문서, 컴포넌트 문서를 같은 흐름으로 탐색
+- `docs/features` 아래 문서는 `Docs / 기능문서` 메뉴에서 동적으로 확인 가능
+
+### APIs
+
+- 컴포넌트 샘플
+- 위젯 샘플
+
+### Plans
+
+- Plan 자동화 목록/상세
+- release 검수
+- 차트
+- 스케줄
+- 히스토리 확장 영역
+
+### Chat
+
+- Codex Live
+- 에러 로그
+
+`Codex Live`는 현재 프로젝트 환경의 `main_project`를 기준 저장소로 사용합니다. 소스 수정이 필요하면 **현재 프로젝트 루트의 로컬 `main` 작업본을 바로 수정**합니다.
+
+일반 채팅 요청과 작업메모 반영 요청도 같은 기준을 따르며, 별도 브랜치 생성 없이 현재 프로젝트 루트에서 바로 수정하는 것을 기본 동작으로 사용합니다.
+
+채팅에서 제공되는 파일/문서/이미지/코드 리소스와 첨부 파일은 세션별로 `public/.codex_chat/<chat-session-id>/resource/...` 아래에 노출됩니다.
+
+### Play
+
+- Layout Editor
+- 저장된 레이아웃 기록
+
+## Plan 기능 구조
+
+Plan 관련 코드는 `src/features/planBoard`에 집중되어 있습니다.
+
+- `PlanBoardPage.tsx`: 자동화 목록과 상세 편집
+- `ReleaseReviewPage.tsx`: release 검수
+- `PlanSchedulePage.tsx`: 반복 등록 스케줄
+- `charts.tsx`: 작업 추이 차트
+- `api.ts`: API 통신
+- `types.ts`: 상태/타입 정의
+
+## 문서 구조
+
+- `docs/worklogs`: 날짜별 작업 기록
+- `docs/features`: 기능 설명과 운영 가이드
+- `docs/components`: 공통 컴포넌트 설명
+- `docs/templates`: 기능/작업일지 템플릿
+
+현재 `docs/features`의 핵심 문서는 다음과 같습니다.
+
+- `project-setup.md`
+- `search-layer.md`
+- `plan-board-review.md`
+- `plan-automation.md`
+- `plan-schedule.md`
+- `plan-usage.md`
+
+## 검색/문서 연계
+
+- 통합 검색 옵션은 `src/app/main/mainView/searchOptions.ts`에서 구성
+- 문서, Plan 화면, 컴포넌트 샘플, 위젯 샘플을 하나의 검색 엔트리로 제공
+- 선택 시 해당 메뉴와 포커스 대상으로 바로 이동
+
+## 운영 메모
+
+- 기능 문서는 구현 파일명과 메뉴명을 그대로 써서 찾기 쉽게 유지
+- `docs/features` 변경분이 보이지 않으면 현재 선택한 Docs 폴더가 `기능문서`인지 먼저 확인
+- Plan 관련 변경은 문서와 라우팅/검색 옵션을 함께 확인
+- 스케줄, release 검수, 차트처럼 화면이 분리된 기능은 개별 문서를 유지