feat: P1 풀빌드 — React 프론트 7화면 + 백엔드 상담루프·평가·음성·RAG

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턴 — 좋은/나쁜 상담에 차등 반응 실증
This commit is contained in:
Yun Chan 2026-06-25 23:37:22 +09:00
parent 859ab26314
commit 24b1b7a6e1
84 changed files with 19645 additions and 107 deletions

116
apps/api/app/store.py Normal file
View file

@ -0,0 +1,116 @@
"""Docker 없이도 도는 in-memory 세션/턴 스토어 (DB degraded 폴백).
DB(NAS Postgres) 단일 SoR 이지만(db.py), Docker off 개발/시연에서도 엔진만 있으면
상담 1턴이 돌아야 한다. 모듈은 app.sessions / app.session_state / app.turns
*최소 in-proc 미러* 제공한다. DB 붙으면 라우트가 DB 경로로 전환한다(교체 대상).
스레드/동시성: uvicorn 단일 프로세스 가정의 단순 dict. 멀티워커 시엔 DB SoR 이므로 무방.
"""
from __future__ import annotations
import time
from dataclasses import asdict, dataclass, field
from typing import Optional
from uuid import uuid4
from .services.persona import PersonaCard
from .services.state_machine import SessionState
@dataclass(slots=True)
class TurnRecord:
"""발화 1건(② episodic 미러). append-only."""
turn_seq: int
speaker: str # 'counselor' | 'client'
stage: str
text: str # 원문(개발용; 실제 저장은 마스킹본)
text_masked: str
created_at: float = field(default_factory=time.time)
@dataclass(slots=True)
class InProcSession:
"""① working + 메타 + 페르소나 핀(in-proc)."""
session_id: str
case_id: str
learner_id: str
persona_code: str
theory_mode: str
persona: PersonaCard
state: SessionState
session_no: int = 1
turns: list[TurnRecord] = field(default_factory=list)
ended: bool = False
prev_rapport_credit: float = 0.0 # carry-over delta 계산용
def recent_turns(self, k: int = 6) -> list[dict[str, str]]:
"""최근 K턴 버퍼(L6 직전 맥락). 마스킹본 사용."""
return [{"speaker": t.speaker, "text": t.text_masked} for t in self.turns[-k:]]
def masked_turns(self) -> list[dict[str, str]]:
return [{"speaker": t.speaker, "text": t.text_masked} for t in self.turns]
class SessionStore:
"""in-memory 세션 레지스트리. DB degraded 시 SoR 대용."""
def __init__(self) -> None:
self._sessions: dict[str, InProcSession] = {}
def create(
self,
*,
learner_id: str,
persona: PersonaCard,
theory_mode: str,
state: SessionState,
session_no: int = 1,
carry_rapport: float = 0.0,
) -> InProcSession:
session_id = uuid4().hex
case_id = uuid4().hex
s = InProcSession(
session_id=session_id,
case_id=case_id,
learner_id=learner_id,
persona_code=persona.code,
theory_mode=theory_mode,
persona=persona,
state=state,
session_no=session_no,
prev_rapport_credit=carry_rapport,
)
self._sessions[session_id] = s
return s
def get(self, session_id: str) -> Optional[InProcSession]:
return self._sessions.get(session_id)
def append_turn(self, session_id: str, turn: TurnRecord) -> None:
s = self._sessions.get(session_id)
if s is not None:
s.turns.append(turn)
def update_state(self, session_id: str, state: SessionState) -> None:
s = self._sessions.get(session_id)
if s is not None:
s.state = state
def end(self, session_id: str) -> Optional[InProcSession]:
s = self._sessions.get(session_id)
if s is not None:
s.ended = True
return s
def remove(self, session_id: str) -> None:
self._sessions.pop(session_id, None)
# 앱 전역 싱글톤 (DB 없이도 라우트가 바로 쓸 수 있게)
store = SessionStore()
__all__ = ["TurnRecord", "InProcSession", "SessionStore", "store"]