web (Vite+React19+TS, Cloudflare Pages 배포): - 디자인토큰(세이지틸/테라코타 SSOT), 앱셸, 공통 UI 프리미티브 - 7화면: 로그인/학습자홈/상담세션/회기리뷰/교수자/관리자/설정 - ClientAvatar: SVG 반구상 흉상 4상태 + RMS 립싱크 + 6파라미터 정서 - 회기리뷰는 외부 레퍼런스 디자인을 Vignette 토큰으로 리스킨 api (FastAPI): - 게이트웨이 /v1/generate·/v1/stream 어댑터(상주풀/EngineSession 보존) - services: 페르소나 L0~L6 빌더 / 결정론 상태머신 / 가드레일 / 턴 오케스트레이터 / 회기간 메모리 / 평가AI / 음성 / RAG - store: DB off 폴백(in-memory), sessions 실구현 검증: - web: node22 tsc+vite build 통과(node23 segfault 회피), Pages 배포 200 - api: app.main import 통과 - 핫픽스: Topbar initials undefined-safe (undefined.trim 크래시) - E2E: 서연(P1) 상담 1턴 — 좋은/나쁜 상담에 차등 반응 실증 |
||
|---|---|---|
| .. | ||
| __init__.py | ||
| gateway.py | ||
| README.md | ||
| requirements.txt | ||
엔진 게이트웨이
로컬 claude -p(Opus 4.8) 상주 멀티턴 풀. 컨테이너 밖(호스트) 실행, api가 ENGINE_URL로 호출.
실행
cd apps/api
python -m uvicorn engine_gateway.gateway:app --host 127.0.0.1 --port 9099
API
POST /session {system_prompt, budget_usd}->{session_id}(회기=프로세스 1개)POST /session/{id}/turn {content}->{text, cost_usd, turns}DELETE /session/{id}GET /health
검증 (2026-06-25)
세션 생성+멀티턴 2턴(서연 페르소나) 컨텍스트 유지 + 캐시 재사용 비용절감 실동작 확인.
환경변수: CLAUDE_BIN, ENGINE_MODEL(비우면 Opus4.8), ENGINE_FALLBACK_MODEL, SESSION_BUDGET_USD.