Aislo/.agent/test/02_Architecture_and_Structure.md

document_type, priority

document_type	priority
architecture	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