ai-code-app/docs/features/project-setup.md

프로젝트 구성 개요

목적

현재 저장소의 화면 구조와 문서 체계를 빠르게 파악하기 위한 최신 개요 문서입니다.

기술 스택

• 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 검수, 차트처럼 화면이 분리된 기능은 개별 문서를 유지