70 lines
5.7 KiB
Markdown
70 lines
5.7 KiB
Markdown
# 2026-07-13 한신대 회의 → 구현 액션 스펙
|
|
|
|
> 출처: 2026-07-13(월) 15:30 한신대 회사방문 회의 (경과보고·시연·파일럿 협의).
|
|
> 회의록 원본·전사록: vault `Projects/수업/2026/한신대 SW중심대학 산학협력 2026/회의록/2026-07-13 AI상담실습플랫폼 회의록 (경과보고·파일럿 협의).md`
|
|
> 이 문서는 그 회의의 **트웬티온스(개발) 몫 결정사항을 에이전트가 착수 가능한 스펙으로 변환**한 것.
|
|
> 진행 상태 체크는 `docs/TODO.md` §H가 소유한다. 여기는 요구사항 상세(불변 스펙)만 둔다.
|
|
|
|
## 데드라인 컨텍스트
|
|
|
|
- **7월 내**: 연구팀 페르소나·프로토콜 입력 + 테스트 완료 → 그 전에 아래 P1이 배포돼 있어야 함.
|
|
- **7월 말~8월 초**: 효과성 검증 파일럿 (대학원생 약 20명, 집중 사용).
|
|
- **9~10월**: 개발사→연구팀 점진 이관 (저장소 공유, 추가 개발 인력 합류).
|
|
|
|
---
|
|
|
|
## P1. 회기 종료 — 시간 기반 전환 (최우선, 파일럿 전 필수)
|
|
|
|
**임상 근거(회의 합의)**: 실제 상담은 한 회기에 라포·탐색·개입·정리 4단계가 모두 이뤄지지 않는다. 라포만 여러 회기도 정상. 현행 "4단계 완수 시 종료"(게임 퀘스트식)는 비현실적.
|
|
|
|
**요구사항**:
|
|
1. 세션 종료 조건을 4단계 완수 → **시간 기반(1시간)**으로 전환. 목표 미달이어도 시간 종료 시 종료. (기본 30분이던 것을 1시간으로 — LLM 응답 지연 감안 실대화 40~50분)
|
|
2. **종료 10분 전 알람** (학습자 화면).
|
|
3. **회기 시작 전 준비 페이지**: 이번 회기 목표 체크 — 4개 전부가 아니라 **2개 수준** 선택 후 시작.
|
|
4. 상태머신(라포→탐색→개입→정리)은 **채점·진행 표시용으로 유지** — 종료 조건에서만 분리. 정리 발화 시 자동 종료(기존 동작)는 시간 내 조기 종료 경로로 유지.
|
|
|
|
**완료 기준**: 1시간 경과 시 세션 종료 처리(정리 유도 포함) / 10분 전 알람 UI 노출 / 시작 전 목표 체크 페이지 동작 / 백엔드 pytest + web e2e 기존 스위트 pass / SSOT 대시보드 갱신.
|
|
|
|
## P2. 회기 계획·달성도 게이지 (설계 → 구현)
|
|
|
|
**요구사항(회의 방향)**:
|
|
1. 단계별 **누적 게이지**: 예) 라포 100 중 이번 회기 30 달성 — 회기가 이어질수록 누적. (초심 상담자는 라포를 1회기에 못 만드는 게 정상이라는 학습 신호)
|
|
2. 페르소나 수치값(신뢰/개방도)은 **전 회기 공유** — 장기 메모리 누적(기존 구현)과 정합.
|
|
3. 별도 "치료 계획 탭"은 만들지 않는다(복잡도 우려) — **계획서·프로토콜 파일 첨부 시 자동 반영**이 절충안. 치료계획은 페르소나에 장기/단기 사례 단서로 흡수.
|
|
4. 회기 간 망각 기능: **불필요로 결론** (교육 목적) — 작업 없음.
|
|
|
|
**진행 방식**: 설계 문서(1p) 먼저 → 소유자 확인 → 구현. P1과 독립적으로 진행 가능하나 P1 이후 권장(종료 조건 변경이 게이지 표시에 영향).
|
|
|
|
## P3. 파일럿 인프라 대비 (7월 말 전)
|
|
|
|
1. **20명 동시 사용 부하 검증** — 세션 동시 생성 시 RAG warm 동시성 이슈 이력 있음. 20 동시 세션 시나리오 부하 테스트 + 병목 기록.
|
|
2. **사용 지침·규정 문서** — 파일럿 기간 집중 트래픽 대비 사용 가이드(비교 점수 설계는 연구팀과 협의).
|
|
3. **서버 이관 대비** — 현 윤찬 자택 개인 서버 → 학교 정보처 호스팅/도메인 이관 협의 예정(협의 주체는 연구팀). 개발 몫: Docker Compose 스택의 호스트 이식성 점검(하드코딩 경로·도메인·시크릿 주입 방식), 이관 절차 문서 초안.
|
|
4. 비용 참고: 실사용 지난달 ~$10, 20명 액티브 시 최대 $100 이내 추정(연구팀이 서버·자문 비용 지원).
|
|
|
|
## P4. 데이터 업로드 흐름 검증 (즉시)
|
|
|
|
연구팀이 단톡방 자료를 교수자 페이지에 **자유 양식 엑셀(파란 라벨 방식 그대로)** 업로드 시작함("즉시" 합의). 개발 몫:
|
|
- 자유 양식 엑셀 업로드 → DB 적재 → AI용 변환 → **원본 파기** 흐름이 실데이터로 정상 동작하는지 검증.
|
|
- 실패 케이스(양식 변형·인코딩) 방어 확인. 원본 추고록은 학교 재산 — DB 원본 미적재·암호화 원칙 유지.
|
|
|
|
## P5. 협업 체계 (연구팀 직접 참여 개방)
|
|
|
|
1. **저장소 초대** — 소유자(윤찬) 직접 실행. 연구팀 디자인 담당 학생 포함.
|
|
2. **PR/브랜치 협업 가이드** 문서 작성 — 비개발자(연구팀·학생) 눈높이: 브랜치 생성→수정→PR→리뷰 흐름, 직접 main 덮어쓰기 금지 이유. `docs/guides/`에 배치.
|
|
3. **UI 문구 수정 프로세스** — 연구팀이 문구 수정 목록을 단톡방으로 전달 → 즉시 반영. 반영 작업은 단순 텍스트 치환 수준으로 유지.
|
|
|
|
## 외부 대기 (연구팀 몫 — 구현 착수 금지, 수신 시 반영)
|
|
|
|
| 항목 | 내용 |
|
|
|---|---|
|
|
| '실패(게임 오버)' 정의 | 어떤 발화가 실패이고 무엇이 표시돼야 하는지 — 연구팀 정의 후 구현 |
|
|
| 검수 표준화 항목 | 페르소나·AI 피드백 검수 항목(임상=연구팀 설계, 기술=개발 지원). 논문·상품화 validation 근거 |
|
|
| AI 평가 노출 정책 | 세션 종료 후에만 학생 노출 중 — 노출 범위·시점 정책 확정 대기 |
|
|
| 페르소나 5~6개 추가 | 연구팀 제작(추고록+프로토콜 쌍, 다음 주까지) — 개발 몫 없음 |
|
|
|
|
## 명시적 비(非)작업
|
|
|
|
- 비언어(표정·제스처) 레이블링·채점 — **차기 사업으로 분리** (이번 범위 아님).
|
|
- 회기 간 망각 기능 — 불필요 결론.
|
|
- 치료 계획 별도 탭 — 만들지 않음 (P2 절충안으로 흡수).
|