Aislo/.agent/test/00_Index.md

document_type, priority, version

document_type	priority	version
entrypoint	CRITICAL	2.0

Aislo (아이슬로) 프로젝트 지식 베이스 진입점

이 문서는 AI 코딩 에이전트(Codex, Claude, Antigravity 등)가 프로젝트의 방대한 정보 중 현재 필요한 컨텍스트를 정확하게 로드하기 위한 인덱스입니다. 임의로 구조를 추론하지 말고, 작업할 영역에 맞춰 아래 연결된 상세 명세서를 반드시 읽고 코딩을 진행하십시오.

🧭 컨텍스트 라우팅 (필요한 문서를 로드하는 방법)

작업 성격에 따라 다음 번호의 문서를 확인하십시오. 모든 문서는 이 폴더(.agent/test/) 하위에 존재합니다.

1. [구조/아키텍처 파악] 01_Architecture_and_Structure.md
   • 언제 읽는가: 새로운 페이지를 추가하거나, 파일(프론트/백엔드)을 생성/수정해야 할 때.
   • 내용: A00~B11까지의 전체 디렉토리 트리, 파일 명명 규칙(수직 통합).
2. [DB 연동 및 쿼리 작성] 02_Database_Schema.md
   • 언제 읽는가: DB 테이블 조회, 쿼리문 작성, 관계(FK) 및 데이터 저장이 필요할 때.
   • 내용: 18개 전체 테이블 스키마, 핵심 쿼리 예제, 공간 데이터(JSON) 설계 원칙.
3. [백엔드 로직/저장소 제어] 03_Backend_Logic_and_Storage.md
   • 언제 읽는가: FastAPI 라우터, 비즈니스 엔진 로직, 영구저장소(물리 파일) 입출력을 다룰 때.
   • 내용: Raw SQL 제약, 워크플로우 6단계 폴더 매핑, workflow.json 기반의 Stale 상태 동기화 기법.
4. [프론트엔드 UI/디자인 구현] 04_Frontend_and_Design.md
   • 언제 읽는가: TypeScript 이벤트 핸들러, 화면 레이아웃, 다국어 처리, CSS 스타일링을 수행할 때.
   • 내용: 3단 레이아웃 제약, 다국어(ui_locales) 제약, Wiza 테마(Britti Sans, 색상 토큰) 및 프롬프트 가이드.

---

🛑 범용 제약 사항 (절대 준수)

1. 700줄 제한: 단일 파일 코드 작성/수정 시 700줄이 넘으면 기능별 분할 필수.
2. 코드 포맷팅: 작성 후 반드시 포맷터 적용 (Python: ruff, TS/CSS: prettier).
3. 인코딩: 모든 파일은 UTF-8.
4. DB 원칙: aiomysql 기반 비동기 통신. ORM 사용은 절대 금지하며 무조건 Raw SQL 사용.
5. 다국어 규칙: 프론트엔드 내 UI 텍스트 하드코딩 금지. 반드시 다국어 인덱스 배열 방식 준수.