# 02. Folder Structure

## 전체 폴더 구조

```text
flownco-exam-annotation-solution/
  README.md
  SOLUTION_MANIFEST.md
  CHANGELOG.md
  docs/
  agents/
  web/
  backend/
  local-agent/
  tests/
  public-assets/
```

## 주요 폴더 역할

- `docs`: 기술설명, 보안정책, Local Agent 가이드, 관리자 데이터 모델, 저작권 산출물 목록
- `agents`: 제품/프론트/백엔드/Local LLM/보안/관리자/export guard 역할 문서
- `web/routes`: 공개, 앱, 관리자 화면의 source-level route component
- `web/static`: 정적 배포에서 실제 실행되는 브라우저 runtime
- `web/lib`: 상수, 라우트, 권한, 검증, Local Backend client, storage/audit/export guard helper
- `web/api`: browser API client facade
- `backend/schema`: Prisma와 SQL 모델 정의
- `backend/services`: 서비스 책임 분리 문서 및 구현 helper
- `backend/controllers`: controller skeleton
- `backend/api`: 기존 Node server에 연결되는 실제 API router
- `local-agent`: 사용자 PC에서 실행하는 FastAPI mock server
- `tests`: unit/integration/e2e 테스트 스크립트와 fixture
- `public-assets`: 이미지, 아이콘, 샘플, 문서 미리보기

## 저작권 신청 시 제출 가능한 산출물

- UI source: `web/routes`, `web/static`, `web/styles`
- backend source: `backend/api`, `backend/services`, `backend/controllers`
- data model: `backend/schema`
- Local Agent source: `local-agent`
- 기술문서: `docs`
- 에이전트 정의: `agents`
- 테스트 산출물: `tests`