72 lines
2.5 KiB
Python
72 lines
2.5 KiB
Python
"""File-backed demo scenarios used by the PoC4 Streamlit screen.
|
|
|
|
Scenario content is deliberately configuration, not executable routing policy.
|
|
Changing this JSON changes only the menu shown to a demo user.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
import json
|
|
from pathlib import Path
|
|
from typing import Any, Mapping
|
|
|
|
|
|
class ScenarioConfigError(RuntimeError):
|
|
"""A safe, user-facing error for invalid scenario configuration."""
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class DemoScenario:
|
|
scenario_id: str
|
|
category: str
|
|
title: str
|
|
question: str
|
|
|
|
# Compatibility aliases keep the Streamlit rendering independent from the
|
|
# storage field names and make a future scenario source interchangeable.
|
|
@property
|
|
def question_id(self) -> str:
|
|
return self.scenario_id
|
|
|
|
@property
|
|
def text(self) -> str:
|
|
return self.question
|
|
|
|
|
|
def load_demo_scenarios(path: Path) -> tuple[DemoScenario, ...]:
|
|
"""Read enabled scenarios and reject malformed or duplicated entries."""
|
|
|
|
try:
|
|
payload: Any = json.loads(path.read_text(encoding="utf-8"))
|
|
except (OSError, UnicodeError, ValueError):
|
|
raise ScenarioConfigError(f"질문 시나리오 설정을 읽지 못했습니다: {path}") from None
|
|
|
|
raw_scenarios = payload.get("scenarios") if isinstance(payload, Mapping) else None
|
|
if not isinstance(raw_scenarios, list):
|
|
raise ScenarioConfigError("질문 시나리오 설정에 scenarios 배열이 필요합니다.")
|
|
|
|
scenarios: list[DemoScenario] = []
|
|
seen_ids: set[str] = set()
|
|
for raw in raw_scenarios:
|
|
if not isinstance(raw, Mapping) or raw.get("enabled", True) is not True:
|
|
continue
|
|
scenario_id = str(raw.get("id") or "").strip().upper()
|
|
category = str(raw.get("category") or "일반").strip()
|
|
title = str(raw.get("title") or "").strip()
|
|
question = str(raw.get("question") or "").strip()
|
|
if not scenario_id or not title or not question:
|
|
raise ScenarioConfigError("각 질문 시나리오에는 id, title, question이 필요합니다.")
|
|
if scenario_id in seen_ids:
|
|
raise ScenarioConfigError(f"중복된 질문 시나리오 ID입니다: {scenario_id}")
|
|
scenarios.append(
|
|
DemoScenario(
|
|
scenario_id=scenario_id,
|
|
category=category,
|
|
title=title,
|
|
question=question,
|
|
)
|
|
)
|
|
seen_ids.add(scenario_id)
|
|
return tuple(scenarios)
|