---
document_type: architecture
priority: HIGH
---
# 파일 구조 및 명명 규칙

## 📂 아키텍처 원칙
- **수직 통합:** 프론트엔드(TypeScript)와 백엔드(Python) 파일을 기능/페이지별로 같은 폴더(`A01_`, `B01_` 등)에 격리하여 관리한다. (단일 거대 모듈 금지)
- **루트 `main.py`:** FastAPI의 진입점. 라우터 등록(`include_router`)만 수행하고 비즈니스 로직은 절대 작성하지 않는다.

## 📝 명명 규칙
- **폴더명:**
  - 로그인 전 페이지: `A01_`, `A02_` ...
  - 로그인 후 페이지: `B01_`, `B02_` ...
  - 워크플로우 페이지: `B04_wf1_`, `B05_wf2_` ...
  - 공통/시스템 폴더: `A00_Common`, `common_util`, `config` 등 접두사 없이 영문명 사용.
- **파일명:** `[폴더명(페이지명)]_[기능]_[기타사양].[확장자]` 형태 필수.
  - 예시: `B04_wf1_Surface_UI_Page.ts`, `B04_wf1_Surface_Router.py`
- **공통 모듈:** `common_util` 폴더 내에 `common_util_[기능].[확장자]` 형태로 보관.

## 🏗️ 주요 폴더 구조 요약
- `A00_Common/`: 프론트엔드 공통 인프라 (SPA 라우터, 앱 셸 등)
- `common_util/`: 공통 유틸리티 코드 (검증, 스토리지 제어 등)
- `config/`: 시스템 설정, DB 설정, TS/Vite 환경 설정
- `ui_template/`: 공통 UI 테마, 컴포넌트, 다국어 파일 배열
- `storage/`: 파일 영구 저장소 (DB 경로와 연동됨)
- `B03_FileInput/` ~ `B09_wf6_Estimation/`: 핵심 6단계 워크플로우 페이지 및 API