54 lines
1.7 KiB
Markdown
54 lines
1.7 KiB
Markdown
# 프로젝트 구조
|
|
|
|
이 문서는 현재 저장소의 큰 구조만 빠르게 확인하기 위한 기준 문서입니다. `Docs` 화면도 이 문서만 기본으로 읽으며, 채팅/자동화용 세부 context는 각 관리 화면에서 개별 항목으로 관리합니다.
|
|
|
|
## 최상위 구조
|
|
|
|
```text
|
|
src/
|
|
docs/
|
|
etc/
|
|
public/
|
|
scripts/
|
|
```
|
|
|
|
- `src`: 메인 프런트엔드 소스
|
|
- `docs`: 작업 템플릿과 작업일지 같은 보조 문서
|
|
- `etc`: work-server, DB, 운영 보조 리소스
|
|
- `public`: 정적 파일과 채팅 세션 리소스
|
|
- `scripts`: 개발/운영 스크립트
|
|
|
|
## 프런트엔드 구조
|
|
|
|
```text
|
|
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는 공용 문서가 아니라 각 관리 데이터에서 직접 관리합니다.
|