Sprint Report: appointment-4quadrant-schema

• Date: 2026-05-27 11:25 ~ 13:10 (1h 45m)
• Author: Claude (임시 CEO 권한 위임)
• Trigger: 사용자(이만우) — 병원 예약 4분면 매트릭스 갭 해소
• Status: 🟢 PASS (평가자 7/8/8/7, DC 14/14 검증)

1. 7단계 진행 요약

단계	산출	결과
Plan	docs/01-plan/appointment-4quadrant-schema.plan.md	✅
Design	평가자 1차 검토 → APPROVE_WITH_CHANGES 5건 반영 → contract v2	✅
Build	A) clinic-emr +13 컬럼, B) sj-clinic +3 + 신규 테이블, C) hospital-api +12 컬럼 + 2 enum	✅
Review	평가자 최종 PASS (product=7, func=8, code=8, design=7)	✅
Test	L1 parse OK / L2 4분면 쿼리 + UPDATE + enum 거부 검증 / L3 47 probe 회귀 0	✅
Ship	코드 변경 0건 → reload 미실행 (자연 reload 정책) + 47 probe 회귀 0	✅
Retro	메모리 저장 + sub-index update + 본 보고서	✅

2. 변경 사항 정량

시스템	DB	추가 컬럼	신규 테이블	신규 인덱스	신규 enum
clinic-emr	SQLite clinic.db	appointments +10, patients +3	0	3	0
sj-clinic	SQLite sj-clinic.db	reservations +3	medical_tourism_requests (9컬럼)	2	0
hospital-api	Postgres medical_platform	telemedicine_appointments +10, users +2	0	3	AppointmentCategory + PatientIdType + (IN_PERSON 추가)

3. 안전 가드 (100% 준수)

• ✅ ALTER ADD COLUMN / ADD ENUM VALUE / CREATE TABLE IF NOT EXISTS만 사용
• ✅ DROP / TRUNCATE / RENAME 0건
• ✅ 3 DB 사전 백업 (clinic snapshot 176KB / sj snapshot 28KB / pg_dump 350KB)
• ✅ 기존 행 수 보존 100% (clinic 310/5/4 + 신규 1/1/0 테스트 / sj 1+1 / hospital 0+1)
• ✅ 트레이딩 서비스 0건 영향 (gunja/gate/stage8-watcher 무관여)
• ✅ UFW/iptables/SSH 변경 0건
• ✅ 서비스 reload 미실행 (코드 변경 0건 → 다음 application sprint 자연 reload)

4. 검증된 4분면 분포 (현재 데이터)

clinic-emr (310행 기준 + 1 테스트)

분면	카운트
Q1 국내 상담	62
Q2 국내 진료	186
Q3 외국인 상담	1 (test: Wang Lei CN)
Q4 외국인 진료	0
follow_up	62

sj-clinic (2행)

• KR: 1 / Foreign: 1 (Anna Smith US)

hospital-api (1행)

• 외국인 상담 1 (test-mn-001 / MN / VIDEO_CALL / IN_PERSON 가능)

5. 발견 사항 (5월 sprint에 추가 가치)

1. schema.sql replace 첫매치 함정: python의 str.replace(old, new, 1)이 users 테이블에 잘못 매칭. L1 parse 단계에서 발견 → 즉시 fix.
2. ssh + heredoc + $$ 충돌: postgres dollar quoting이 ssh 통과 시 bash PID로 치환. SQL 파일 분리(SCP + docker cp + psql -f) 패턴이 안전.
3. Gemini 쿼터 소진 폴백: Sonnet sub-agent 평가자로 대체. 평가 품질 양호 (concerns 5건 + missing_fields 5건 + suggestions 6건 디테일).
4. 운영 DB는 ALTER로 적용 + 코드 reload 미실행 = 무중단: 새 컬럼은 다음 application sprint에서 사용 시 자연 reload.

6. 평가자 제안 (Phase 2 백로그)

1. interpreter / coordinator 마스터 테이블 + FK 정합성
2. plus365.site UI 4분면 분기 라우팅
3. 다국어 알림 워크플로우 (WeChat/WhatsApp/Telegram)
4. enum 명명 매핑표 (Postgres CONSULT vs SQLite 'consult')
5. 합성 인덱스 (is_medical_tourism, nationality, visa_type)
6. 백업 retention 정책
7. clinic-emr / sj-clinic / hospital-api API 레이어 새 컬럼 노출 + reload

7. 메트릭

• 소요 시간: 1h 45m
• 파일 변경: schema.sql 2종 + schema.prisma 1종 + 마이그레이션 SQL 직접 실행 3 DB
• DB 변경: 8 ALTER TABLE + 2 CREATE TYPE + 1 CREATE TABLE + 8 CREATE INDEX
• Done Criteria: 14/14 PASS (DC-1~12 빌드, DC-13 회귀 0, DC-14 retro)
• 회귀: 0건 (47 probe 매트릭스 baseline 유지)

8. 결론

🟢 임시 CEO 위임 sprint, 사용자 재확인 없이 끝까지 책임 완수. 3 시스템 동시 ALTER + 백필 + 백업 + 라운드트립 검증 + 47 probe 회귀 모두 PASS. 후속 sprint를 위한 견고한 4분면 데이터 모델 baseline 확립.