16e791e044
8월 7일까지 워킹트리에만 남아 있던 미커밋 작업을 커밋한다. 여러 사본 폴더(worktree·clone)에 흩어져 있던 중간 스냅샷을 정리하기 전에 원본을 git 이력으로 고정하는 것이 목적이다. - contracts/routes/services: measurement, outcome_trajectory, rupture_repair, deliberate_practice, calibration_transfer, supervision_research, multimodal_alliance, continuous_improvement 계열 신규 모듈과 테스트 - infra/db/init: 07~16 마이그레이션(측정 기반~calibration transfer 실행) - apps/web: 세션 리뷰 카드·관리 화면·E2E 스펙 추가 - docs/ops: G0~G8 라이브 통합·배포·롤백 증거 문서와 evidence JSON/PNG - scripts: smoke·ledger·릴리스 에이전트·NAS 프리뷰 운영 스크립트 engine.public 로그 .bak과 apps/web/test-results 산출물은 커밋에서 제외했다.
285 lines
12 KiB
Python
285 lines
12 KiB
Python
"""Vignette FastAPI 앱 엔트리포인트.
|
|
|
|
Dockerfile CMD: uvicorn app.main:app --host 0.0.0.0 --port 8000
|
|
소유: 상태머신·가드레일·엔진 어댑터 호출부·SSE 스트리머·RBAC (마스터플랜 §5).
|
|
엔진 게이트웨이(engine_gateway/)는 람다 직접 소유 — 여기선 engine_client 로 호출만.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from contextlib import asynccontextmanager
|
|
import logging
|
|
from pathlib import Path
|
|
|
|
from fastapi import FastAPI
|
|
from fastapi.middleware.cors import CORSMiddleware
|
|
from fastapi.staticfiles import StaticFiles
|
|
|
|
from . import __version__
|
|
from .auth_sessions import ensure_runtime_tables
|
|
from .config import settings
|
|
from .db import acquire, close_pool, healthcheck, init_pool
|
|
from .engine_client import engine_client
|
|
from .persona_repository import materialize_seed_personas
|
|
from .session_persistence import ensure_review_tables
|
|
from .runtime_schema import (
|
|
CALIBRATION_TRANSFER_SCHEMA_CONTRACT,
|
|
CONTINUOUS_IMPROVEMENT_SCHEMA_CONTRACT,
|
|
DELIBERATE_PRACTICE_SCHEMA_CONTRACT,
|
|
MEASUREMENT_SCHEMA_CONTRACT,
|
|
MULTIMODAL_ALLIANCE_SCHEMA_CONTRACT,
|
|
OUTCOME_TRAJECTORY_SCHEMA_CONTRACT,
|
|
RUPTURE_REPAIR_SCHEMA_CONTRACT,
|
|
SUPERVISION_RESEARCH_SCHEMA_CONTRACT,
|
|
runtime_schema_bootstrap_required,
|
|
schema_contract_ready,
|
|
)
|
|
from .routes import auth as auth_routes
|
|
from .routes import calibration_transfer as calibration_transfer_routes
|
|
from .routes import continuous_improvement as continuous_improvement_routes
|
|
from .routes import admin as admin_routes
|
|
from .routes import client_diagnostics as client_diagnostics_routes
|
|
from .routes import deliberate_practices as deliberate_practice_routes
|
|
from .routes import eval as eval_routes
|
|
from .routes import kb as kb_routes
|
|
from .routes import multimodal_alliance as multimodal_alliance_routes
|
|
from .routes import measurements as measurement_routes
|
|
from .routes import outcome_trajectories as outcome_trajectory_routes
|
|
from .routes import personas as persona_routes
|
|
from .routes import rupture_repairs as rupture_repair_routes
|
|
from .routes import supervision_research as supervision_research_routes
|
|
from .routes import sessions as session_routes
|
|
from .routes import share as share_routes
|
|
from .routes import teacher as teacher_routes
|
|
from .routes import users as user_routes
|
|
from .routes import voice as voice_routes
|
|
from .services.notifications import ensure_notification_tables
|
|
from .services import (
|
|
alliance_measurement,
|
|
continuous_improvement_producer,
|
|
supervision_research_producer,
|
|
)
|
|
from .services.voice import voice_service
|
|
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
@asynccontextmanager
|
|
async def lifespan(app: FastAPI):
|
|
"""startup: DB 풀 + 엔진 클라이언트 / shutdown: 정리.
|
|
|
|
DB 미가용(Docker off / NAS 연결불가)이면 store 인메모리 폴백으로 degraded 기동한다.
|
|
"""
|
|
measurement_schema_ready = False
|
|
outcome_trajectory_schema_ready = False
|
|
rupture_repair_schema_ready = False
|
|
deliberate_practice_schema_ready = False
|
|
calibration_transfer_schema_ready = False
|
|
supervision_research_schema_ready = False
|
|
continuous_improvement_schema_ready = False
|
|
multimodal_alliance_schema_ready = False
|
|
try:
|
|
await init_pool()
|
|
await ensure_runtime_tables()
|
|
await ensure_review_tables()
|
|
await ensure_notification_tables()
|
|
async with acquire(role="admin") as conn:
|
|
measurement_schema_ready = await schema_contract_ready(
|
|
conn,
|
|
MEASUREMENT_SCHEMA_CONTRACT,
|
|
)
|
|
outcome_trajectory_schema_ready = await schema_contract_ready(
|
|
conn,
|
|
OUTCOME_TRAJECTORY_SCHEMA_CONTRACT,
|
|
)
|
|
rupture_repair_schema_ready = await schema_contract_ready(
|
|
conn,
|
|
RUPTURE_REPAIR_SCHEMA_CONTRACT,
|
|
)
|
|
deliberate_practice_schema_ready = await schema_contract_ready(
|
|
conn,
|
|
DELIBERATE_PRACTICE_SCHEMA_CONTRACT,
|
|
)
|
|
calibration_transfer_schema_ready = await schema_contract_ready(
|
|
conn,
|
|
CALIBRATION_TRANSFER_SCHEMA_CONTRACT,
|
|
)
|
|
supervision_research_schema_ready = await schema_contract_ready(
|
|
conn,
|
|
SUPERVISION_RESEARCH_SCHEMA_CONTRACT,
|
|
)
|
|
continuous_improvement_schema_ready = await schema_contract_ready(
|
|
conn,
|
|
CONTINUOUS_IMPROVEMENT_SCHEMA_CONTRACT,
|
|
)
|
|
multimodal_alliance_schema_ready = await schema_contract_ready(
|
|
conn,
|
|
MULTIMODAL_ALLIANCE_SCHEMA_CONTRACT,
|
|
)
|
|
if runtime_schema_bootstrap_required(
|
|
MEASUREMENT_SCHEMA_CONTRACT,
|
|
ready=measurement_schema_ready,
|
|
):
|
|
logger.warning(
|
|
"Outcome/Alliance 측정 스키마가 불완전해 측정 경로를 시작하지 않음; "
|
|
"infra/db/init/07_measurement_foundation.sql 적용 필요"
|
|
)
|
|
if runtime_schema_bootstrap_required(
|
|
OUTCOME_TRAJECTORY_SCHEMA_CONTRACT,
|
|
ready=outcome_trajectory_schema_ready,
|
|
):
|
|
logger.warning(
|
|
"종단 성과 궤적 스키마가 불완전해 G2 경로가 실패할 수 있음; "
|
|
"infra/db/init/08_outcome_trajectory.sql 적용 필요"
|
|
)
|
|
if runtime_schema_bootstrap_required(
|
|
RUPTURE_REPAIR_SCHEMA_CONTRACT,
|
|
ready=rupture_repair_schema_ready,
|
|
):
|
|
logger.warning(
|
|
"파열·수선 원장 스키마가 불완전해 G3 경로가 실패할 수 있음; "
|
|
"infra/db/init/09_rupture_repair.sql 적용 필요"
|
|
)
|
|
if runtime_schema_bootstrap_required(
|
|
DELIBERATE_PRACTICE_SCHEMA_CONTRACT,
|
|
ready=deliberate_practice_schema_ready,
|
|
):
|
|
logger.warning(
|
|
"숙의 연습 원장 스키마가 불완전해 G4 경로가 실패할 수 있음; "
|
|
"infra/db/init/10_deliberate_practice.sql 적용 필요"
|
|
)
|
|
if runtime_schema_bootstrap_required(
|
|
CALIBRATION_TRANSFER_SCHEMA_CONTRACT,
|
|
ready=calibration_transfer_schema_ready,
|
|
):
|
|
logger.warning(
|
|
"자기보정·전이 원장 스키마가 불완전해 G5 경로가 실패할 수 있음; "
|
|
"infra/db/init/11_calibration_transfer.sql 적용 필요"
|
|
)
|
|
if runtime_schema_bootstrap_required(
|
|
SUPERVISION_RESEARCH_SCHEMA_CONTRACT,
|
|
ready=supervision_research_schema_ready,
|
|
):
|
|
logger.warning(
|
|
"감독·연구 원장 스키마가 불완전해 G6 경로가 실패할 수 있음; "
|
|
"infra/db/init/12_supervision_research.sql 적용 필요"
|
|
)
|
|
if runtime_schema_bootstrap_required(
|
|
CONTINUOUS_IMPROVEMENT_SCHEMA_CONTRACT,
|
|
ready=continuous_improvement_schema_ready,
|
|
):
|
|
logger.warning(
|
|
"지속 개선 승인 원장 스키마가 불완전해 G8 경로가 실패할 수 있음; "
|
|
"infra/db/init/14_continuous_improvement.sql 적용 필요"
|
|
)
|
|
if runtime_schema_bootstrap_required(
|
|
MULTIMODAL_ALLIANCE_SCHEMA_CONTRACT,
|
|
ready=multimodal_alliance_schema_ready,
|
|
):
|
|
logger.warning(
|
|
"멀티모달 동맹 원장 스키마가 불완전해 G7 경로가 실패할 수 있음; "
|
|
"infra/db/init/13_multimodal_alliance.sql 적용 필요"
|
|
)
|
|
if settings.auto_seed_personas:
|
|
await materialize_seed_personas()
|
|
await admin_routes.apply_engine_config_from_store()
|
|
except Exception as exc: # DB 없어도 store 폴백으로 1턴 동작 (dev/로컬)
|
|
if settings.environment != "dev":
|
|
raise
|
|
import logging
|
|
|
|
logging.getLogger("uvicorn.error").warning(
|
|
"DB 풀 초기화 실패 — store 인메모리 폴백으로 degraded 기동: %s", exc
|
|
)
|
|
await engine_client.startup()
|
|
if measurement_schema_ready:
|
|
try:
|
|
recovered = await alliance_measurement.recover_pending_alliance_pulses()
|
|
if recovered:
|
|
logger.info("미완료 Alliance Pulse %d건 재예약", recovered)
|
|
except Exception:
|
|
if settings.environment != "dev":
|
|
raise
|
|
logger.exception("미완료 Alliance Pulse 복구 예약 실패")
|
|
await voice_service.startup()
|
|
session_routes.schedule_missing_session_evaluation_recovery()
|
|
if supervision_research_schema_ready:
|
|
supervision_research_producer.schedule_supervision_research_producer()
|
|
if continuous_improvement_schema_ready:
|
|
continuous_improvement_producer.schedule_continuous_improvement_producer()
|
|
try:
|
|
yield
|
|
finally:
|
|
await continuous_improvement_producer.stop_continuous_improvement_producer()
|
|
await supervision_research_producer.stop_supervision_research_producer()
|
|
session_routes.cancel_missing_session_evaluation_recovery()
|
|
await voice_service.shutdown()
|
|
await engine_client.shutdown()
|
|
try:
|
|
await close_pool()
|
|
except Exception:
|
|
pass
|
|
|
|
|
|
app = FastAPI(
|
|
title="Vignette API",
|
|
version=__version__,
|
|
description="상담 시뮬레이션 훈련 플랫폼 백엔드 (FastAPI · 상태머신 · 가드레일 · RBAC)",
|
|
lifespan=lifespan,
|
|
)
|
|
|
|
# CORS — 정적 프론트(chanpaca.net) + SSE 분리경로(stream.chanpaca.net)
|
|
app.add_middleware(
|
|
CORSMiddleware,
|
|
allow_origins=settings.cors_origins,
|
|
allow_credentials=True, # __Host- HttpOnly 쿠키 전송
|
|
allow_methods=["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"],
|
|
allow_headers=["*"],
|
|
)
|
|
|
|
# TODO: Presidio PII 마스킹 미들웨어 (외부 LLM 경로 진입 전 하드 게이트, R7/F-03)
|
|
|
|
_upload_root = Path(settings.user_upload_dir)
|
|
if not _upload_root.is_absolute():
|
|
_upload_root = Path.cwd() / _upload_root
|
|
_upload_root.mkdir(parents=True, exist_ok=True)
|
|
app.mount("/uploads", StaticFiles(directory=str(_upload_root)), name="uploads")
|
|
|
|
app.include_router(auth_routes.router)
|
|
app.include_router(calibration_transfer_routes.router)
|
|
app.include_router(continuous_improvement_routes.router)
|
|
app.include_router(client_diagnostics_routes.router)
|
|
app.include_router(admin_routes.router)
|
|
app.include_router(persona_routes.router)
|
|
app.include_router(session_routes.router)
|
|
app.include_router(measurement_routes.router)
|
|
app.include_router(multimodal_alliance_routes.router)
|
|
app.include_router(outcome_trajectory_routes.router)
|
|
app.include_router(rupture_repair_routes.router)
|
|
app.include_router(deliberate_practice_routes.router)
|
|
app.include_router(supervision_research_routes.router)
|
|
app.include_router(share_routes.router)
|
|
app.include_router(teacher_routes.router)
|
|
app.include_router(user_routes.router)
|
|
# Features 트랙 스텁 라우터(evaluator/voice/rag 가 채움). 등록만 — import 가능 보장.
|
|
app.include_router(eval_routes.router)
|
|
app.include_router(voice_routes.router)
|
|
app.include_router(kb_routes.router)
|
|
|
|
|
|
@app.get("/health", tags=["meta"])
|
|
async def health() -> dict[str, object]:
|
|
"""liveness + DB + 엔진 게이트웨이 readiness."""
|
|
db_ok = await healthcheck()
|
|
engine = await engine_client.health_detail()
|
|
engine_ok = bool(engine.get("ok"))
|
|
return {
|
|
"status": "ok" if db_ok and engine_ok else "degraded",
|
|
"version": __version__,
|
|
"environment": settings.environment,
|
|
"db": db_ok,
|
|
"engine": engine_ok,
|
|
"engine_detail": engine.get("detail"),
|
|
"engine_mode": settings.engine_mode,
|
|
}
|