음성 재생과 운영 배포 정리

data/kb/README.md

@@ -0,0 +1,20 @@
+# Vignette live coaching source packs
+
+This directory is runtime input, not generated cache.
+
+Required files:
+
+- `live_coaching_workbook_0615.json`
+- `live_coaching_sources/*.json`
+
+The API image copies `data/` from the repository root.  If these files are not
+committed, the deployment process must provision the same paths before building
+or running the image.  Run this before transplanting the stack:
+
+```powershell
+python scripts\check-deploy-preflight.py --env-file infra\.env
+```
+
+The JSON files should contain licensed or public-summary source-pack metadata
+and short summaries only.  Do not place raw transcripts or long copyrighted
+source text here.

data/kb/live_coaching_sources/dsm5tr_case_formulation.json

@@ -0,0 +1,37 @@
+{
+  "source": {
+    "source_id": "dsm5tr_case_formulation",
+    "title": "DSM-5-TR 사례개념화 참조 요약",
+    "citation": "American Psychiatric Association. Diagnostic and Statistical Manual of Mental Disorders, Fifth Edition, Text Revision (DSM-5-TR), 2022. Official DSM page: https://www.psychiatry.org/psychiatrists/practice/dsm",
+    "kb_kind": "diagnostic",
+    "license_class": "C",
+    "external_llm_ok": true,
+    "source_type": "licensed_reference",
+    "version": "DSM-5-TR",
+    "priority": 80,
+    "note": "사용 권한 확인됨. 라이브 코칭에는 진단기준 원문이 아니라 임상 판단 정렬용 환언 요약만 사용한다."
+  },
+  "chunks": [
+    {
+      "id": "dsm-formulation-not-label",
+      "heading": "진단명보다 증거 기반 사례개념화",
+      "kb_kind": "diagnostic",
+      "summary": "DSM 계열 지식은 수련생에게 진단명을 단정하게 하려는 자료가 아니라, 증상 묶음, 기간, 기능 손상, 감별 가능성, 문화·발달 맥락을 빠뜨리지 않게 하는 점검틀로 쓴다. 라이브 코칭은 내담자에게 붙일 라벨보다 관찰된 말·정서·행동 증거를 더 묻도록 안내한다.",
+      "keywords": ["DSM", "진단", "진단명", "증상", "기간", "기능", "손상", "감별", "라벨", "사례개념화"]
+    },
+    {
+      "id": "dsm-differential-context",
+      "heading": "감별과 맥락 확인",
+      "kb_kind": "diagnostic",
+      "summary": "우울, 불안, 외상, 적응 문제처럼 겹치는 호소가 있을 때는 한 설명으로 서둘러 묶지 않는다. 시작 시점, 악화·완화 요인, 수면·식욕·활력, 학교·가족 기능 변화, 물질·의학적 요인, 이전 에피소드를 순서 있게 확인하도록 코칭한다.",
+      "keywords": ["우울", "불안", "외상", "적응", "수면", "식욕", "활력", "가족", "학교", "물질", "의학", "이전"]
+    },
+    {
+      "id": "dsm-internal-not-client-facing",
+      "heading": "진단학적 엄밀성과 비노출",
+      "kb_kind": "supervisor_pattern",
+      "summary": "훈련 시스템 내부에서는 DSM 차원을 정밀하게 참조할 수 있지만, 회기 중 학습자 코칭은 내담자를 진단하는 문장이 아니라 안전한 탐색 질문, 감정 반영, 기능 손상 확인, 다음 단계 합의로 번역되어야 한다.",
+      "keywords": ["내부", "비노출", "차원", "탐색", "질문", "감정", "기능", "다음 단계"]
+    }
+  ]
+}

data/kb/live_coaching_sources/official_counseling_guideline_seed.json

@@ -0,0 +1,37 @@
+{
+  "source": {
+    "source_id": "official_counseling_guideline_seed",
+    "title": "공식 상담·심리치료 지침 공통 원칙 요약",
+    "citation": "WHO mhGAP intervention guide: https://www.who.int/publications/i/item/9789241549790 ; APA Clinical Practice Guidelines: https://www.apa.org/about/offices/directorates/guidelines/clinical-practice",
+    "kb_kind": "microskill",
+    "license_class": "B",
+    "external_llm_ok": true,
+    "source_type": "official_guideline",
+    "version": "2026-06 reference pack",
+    "priority": 60,
+    "note": "공식 지침의 공통 원칙을 첫 회기 라이브 코칭에 맞게 환언한 스타터 팩이다."
+  },
+  "chunks": [
+    {
+      "id": "shared-decision-and-consent",
+      "heading": "협력적 목표 설정",
+      "kb_kind": "microskill",
+      "summary": "첫 회기 개입은 상담자가 정답을 전달하는 방식보다 내담자의 우선순위, 동의, 선택권을 확인하는 협력적 방식이 안전하다. 목표는 크고 추상적인 변화보다 이번 주에 확인 가능한 작은 행동이나 관찰로 좁힌다.",
+      "keywords": ["동의", "선택권", "협력", "목표", "이번 주", "작은 행동", "우선순위"]
+    },
+    {
+      "id": "measurement-without-score-exposure",
+      "heading": "평가척도는 대화의 보조",
+      "kb_kind": "supervisor_pattern",
+      "summary": "공식 척도와 지침은 면담을 대체하지 않는다. 라이브 코칭은 점수나 정답을 학습자에게 공개하기보다, 어떤 영역을 아직 묻지 않았는지와 다음 질문을 알려주는 방식으로 사용한다.",
+      "keywords": ["척도", "점수", "정답", "면담", "평가", "다음 질문", "영역"]
+    },
+    {
+      "id": "cultural-developmental-context",
+      "heading": "문화·발달·환경 맥락",
+      "kb_kind": "theory",
+      "summary": "청소년·대학생 내담자의 호소는 개인 증상만으로 축소하지 않고 가족, 학교, 또래, 경제·문화적 맥락과 함께 본다. 코칭은 판단보다 맥락을 넓히는 질문으로 이어져야 한다.",
+      "keywords": ["문화", "발달", "청소년", "대학생", "가족", "학교", "또래", "경제", "맥락"]
+    }
+  ]
+}

data/kb/live_coaching_sources/official_suicide_risk_guidelines.json

@@ -0,0 +1,39 @@
+{
+  "source": {
+    "source_id": "official_suicide_risk_guidelines",
+    "title": "자살·자해 위험사정 공식 지침 요약",
+    "citation": "Columbia Lighthouse Project C-SSRS: https://cssrs.columbia.edu/ ; NICE NG225 Self-harm guideline: https://www.nice.org.uk/guidance/ng225",
+    "kb_kind": "supervisor_pattern",
+    "license_class": "B",
+    "external_llm_ok": true,
+    "source_type": "official_guideline",
+    "version": "2026-06 reference pack",
+    "priority": 95,
+    "note": "공식 지침의 실무 원칙을 라이브 코칭용으로 짧게 환언한 요약이다."
+  },
+  "chunks": [
+    {
+      "id": "risk-ideation-plan-intent-behavior",
+      "heading": "사고·계획·의도·행동 구분",
+      "kb_kind": "supervisor_pattern",
+      "citation": "Columbia Lighthouse Project C-SSRS official materials: https://cssrs.columbia.edu/",
+      "summary": "자살 위험 단서가 나오면 생각의 최근성·빈도·강도, 계획 여부, 의도, 과거 행동, 접근 가능한 수단, 보호요인을 차분히 구분해 확인한다. 세부 방법을 자세히 묘사하게 만들기보다 안전 확보에 필요한 범위에서 묻는다.",
+      "keywords": ["자살", "죽고", "자해", "위험", "계획", "의도", "시도", "수단", "보호요인", "최근", "빈도", "강도"]
+    },
+    {
+      "id": "self-harm-psychosocial-assessment",
+      "heading": "자해 이후 심리사회적 평가",
+      "kb_kind": "supervisor_pattern",
+      "citation": "NICE guideline NG225 Self-harm: assessment, management and preventing recurrence: https://www.nice.org.uk/guidance/ng225",
+      "summary": "자해나 자살사고를 단순 관심끌기나 의지 문제로 다루지 않는다. 안전, 즉각적 지지, 심리사회적 맥락, 반복 위험, 연결 가능한 보호체계를 함께 확인하고, 수치심을 키우는 판단적 표현을 피한다.",
+      "keywords": ["자해", "심리사회", "수치심", "판단", "안전", "지지", "반복", "보호체계", "평가"]
+    },
+    {
+      "id": "safety-plan-escalation",
+      "heading": "안전계획과 긴급 연결",
+      "kb_kind": "microskill",
+      "summary": "위험이 현재적이거나 통제 가능성이 낮으면 회기 목표보다 안전계획과 즉각 연결을 우선한다. 혼자 두지 않기, 보호자·지도자·응급 서비스 연결, 지역 위기전화 안내처럼 실제 행동으로 이어지는 선택지를 제시한다.",
+      "keywords": ["안전계획", "긴급", "응급", "보호자", "기관", "위기전화", "혼자", "연결", "109", "112", "119"]
+    }
+  ]
+}

data/kb/live_coaching_workbook_0615.json

@@ -0,0 +1,58 @@
+{
+  "source": {
+    "source_id": "workbook_0615_case_conceptualization",
+    "title": "상담 첫 회기 축어록 기반 사례개념화 및 목표/전략 워크북 0615",
+    "citation": "사용자 제공 PDF: 상담 첫 회기 축어록을 활용한 사례개념화 및 목표, 전략 워크북_분석결과추가_0615.pdf",
+    "kb_kind": "template",
+    "license_class": "D",
+    "external_llm_ok": true,
+    "source_type": "licensed_workbook",
+    "version": "2026-06-15",
+    "priority": 90,
+    "note": "사용 권한 확인됨. 라이브 코칭에는 원문 장문 대신 식별성이 제거된 분석틀 요약과 출처 식별자를 사용한다."
+  },
+  "chunks": [
+    {
+      "id": "workbook-complaint-domains",
+      "heading": "현재 호소문제 5영역",
+      "kb_kind": "template",
+      "summary": "첫 회기에서 내담자 언어로 표현된 호소를 신체/생리, 인지, 정서, 대처행동, 대인관계 영역으로 나누어 탐색한다. 라이브 코칭은 상담자가 한 영역에만 머물 때 빠진 영역을 다음 질문으로 보완하게 돕는다.",
+      "keywords": ["호소", "신체", "수면", "인지", "생각", "정서", "감정", "행동", "대인", "관계"]
+    },
+    {
+      "id": "workbook-trigger-interaction",
+      "heading": "촉발사건과 상호작용 분석",
+      "kb_kind": "supervisor_pattern",
+      "summary": "등교거부, 자퇴 요구, 가족 갈등 같은 촉발사건을 단일 원인으로 단정하지 않고 내담자 요인, 학교/또래/가족 환경, 부모와의 관계가 어떻게 맞물리는지 탐색한다. 성급한 해석보다 구체 사건, 생각, 감정, 행동을 순서대로 확인한다.",
+      "keywords": ["촉발", "자퇴", "등교", "가족", "부모", "학교", "또래", "상호작용", "구체"]
+    },
+    {
+      "id": "workbook-emotion-validation",
+      "heading": "감정 타당화와 욕구 명료화",
+      "kb_kind": "microskill",
+      "summary": "부정 정서를 바로 교정하거나 설득하기보다 감정의 이유, 좌절된 욕구, 1차/2차 감정을 구분해 타당화한다. 내담자가 울거나 멈칫할 때는 감정 표현을 허용하고 속도를 낮춘다.",
+      "keywords": ["타당화", "욕구", "1차 감정", "2차 감정", "눈물", "울", "감정", "속도"]
+    },
+    {
+      "id": "workbook-risk-stabilization",
+      "heading": "위험사정과 안정화",
+      "kb_kind": "supervisor_pattern",
+      "summary": "자살사고가 확인되면 구체적 방법을 유도하지 않고 최근성, 강도, 보호요인, 안전 확보를 차분히 확인한다. 위험 신호가 있으면 회기 목표보다 안전과 생명유지 약속, 보호자/기관 연결을 우선한다.",
+      "keywords": ["자살", "자해", "죽고", "위험", "안전", "보호", "생명", "최근"]
+    },
+    {
+      "id": "workbook-goal-strategy",
+      "heading": "목표와 전략 연결",
+      "kb_kind": "template",
+      "summary": "사례개념화는 목표와 전략으로 연결되어야 한다. 생물 영역은 수면/활력/의학적 평가, 심리 영역은 자기이해/인지조망/감정조절, 사회 영역은 가족 의사소통/지지체계/현실적 진로 행동으로 구체화한다.",
+      "keywords": ["목표", "전략", "수면", "활력", "인지조망", "감정조절", "가족", "지지", "진로"]
+    },
+    {
+      "id": "workbook-session-pacing",
+      "heading": "첫 회기 페이싱",
+      "kb_kind": "supervisor_pattern",
+      "summary": "첫 회기 코칭은 질문을 많이 늘리는 것보다 비밀보장, 호칭 확인, 주호소 재확인, 위험 확인, 감정 허용, 구체적 다음 목표 설정의 순서를 지키는 데 초점을 둔다. 후반부에 새 기법을 무리하게 넣지 않는다.",
+      "keywords": ["비밀보장", "호칭", "주호소", "페이싱", "후반", "기법", "목표", "정리"]
+    }
+  ]
+}