프로젝트 구조
이 문서는 현재 저장소의 큰 구조만 빠르게 확인하기 위한 기준 문서입니다. Docs 화면도 이 문서만 기본으로 읽으며, 채팅/자동화용 세부 context는 각 관리 화면에서 개별 항목으로 관리합니다.
최상위 구조
src/
docs/
etc/
public/
scripts/
src: 메인 프런트엔드 소스docs: 작업 템플릿과 작업일지 같은 보조 문서etc: work-server, DB, 운영 보조 리소스public: 정적 파일과 채팅 세션 리소스scripts: 개발/운영 스크립트
프런트엔드 구조
src
├─ app
│ └─ main
├─ components
├─ widgets
├─ features
├─ views
├─ layer
└─ store
src/app/main: 메인 앱 셸, 라우팅, 상단/사이드바, 채팅/문서 진입점src/components: 공통 UI 조각src/widgets: 공통 카드형 블록src/features: 프로젝트 전용 기능src/views: 플레이/샘플 성격의 화면src/layer: 전역 레이어와 검색 같은 횡단 기능src/store: 앱 전역 상태
기능 배치 기준
- 화면 전용 로직은
src/features에 둡니다. - 여러 화면에서 재사용되는 UI는
src/components또는src/widgets에 둡니다. - 문서 렌더링과 샘플 수집 같은 앱 메타 기능은
src/app/main과 매니페스트에서 관리합니다.
문서 노출 기준
- 앱
Docs메뉴는 구조 확인용 문서만 노출합니다. - 작업일지, 템플릿, 과거 설계 메모는 저장소에 남길 수 있어도 기본 문서 목록에서는 제외합니다.
- 채팅 유형 context와 자동화 유형 context는 공용 문서가 아니라 각 관리 데이터에서 직접 관리합니다.