# 아리(Ari) — AI Life OS 일·삶을 한곳에서 관리하는 한국어 AI 개인비서 **아리**의 MVP. 핵심 철학: **"적을 때는 분류하지 않는다 — 분류·배치·자동화는 아리가."** 모노레포: `frontend/`(Next.js App Router + TS) · `backend/`(FastAPI + SQLite + Ollama). 개발 문서는 `dev/`(진입: `dev/overview.md`), 디자인 기준은 `design-reference/`. ## 빠른 시작 (Phase 0) ```bash # 0) 사전 설치: Node20+/pnpm, Python3.11+/uv, Ollama make install # 프론트+백 의존성 # 1) 환경변수 cp backend/.env.example backend/.env # 필요 시 OLLAMA_MODEL 등 수정 echo 'NEXT_PUBLIC_API_BASE=http://localhost:8000' > frontend/.env.local # 2) (선택) Ollama ollama serve & ollama pull <설치할_모델> # .env 의 OLLAMA_MODEL 과 맞춤 (특정 모델 강제 아님) # 3) 실행 make dev # 프론트 :3000 + 백 :8000 # 4) 스모크 make health # /api/health, /api/llm/health make test # pytest + vitest make lint # ruff + eslint ``` ## 구조 ``` workspace/ ├─ frontend/ Next.js (App Router, TypeScript) ├─ backend/ FastAPI (SQLite, SQLModel, Alembic, Ollama) ├─ dev/ 개발 문서 (overview.md + phase-*.md) └─ design-reference/ 원본 프로토타입 (픽셀 충실 재현 기준) ```