36 lines
2.5 KiB
Markdown
36 lines
2.5 KiB
Markdown
---
|
|
document_type: entrypoint
|
|
priority: CRITICAL
|
|
version: 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 텍스트 하드코딩 금지. 반드시 다국어 인덱스 배열 방식 준수.
|