101 lines
3.1 KiB
Markdown
Executable File
101 lines
3.1 KiB
Markdown
Executable File
# 프로젝트 구성 개요
|
|
|
|
## 목적
|
|
|
|
현재 저장소의 화면 구조와 문서 체계를 빠르게 파악하기 위한 최신 개요 문서입니다.
|
|
|
|
## 기술 스택
|
|
|
|
- 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 검수, 차트처럼 화면이 분리된 기능은 개별 문서를 유지
|