feat: AI 텍스트 포맷 계약 + 마크다운 렌더러 도입

[Jaeho-Site]

변경 사항

A5. 조사 결과 "전면 렌더러"가 아니라 필드별 포맷 계약이 정답이었다 — 계약상 마크다운은 분석 산출물 1곳뿐이고, highlights("글자 그대로 발췌" 계약)·델타 스트리밍·인라인 합성이 마크다운 렌더와 구조적으로 충돌한다.

계약 (양끝 명문화)

• plain text 계약: 피드백 요약·highlights·studyPlan·패널 detail·질문 텍스트·coachingComment — 프롬프트 5곳에 서식 기호 금지 지시로 강제. HighlightedText·스트리밍 표면 무변경(충돌 원천 차단)
• GFM 마크다운 계약: answerCoaching.modelAnswer/answerRewrite(STAR 골격·코드 가치 실재) + 분석 산출물(documentPath 문서)
• 정본: messaging.md §5.4/§5.11 · frontend-types.md §6.5(신설) · design-system.md §2.14(신설)

렌더러 (frontend/)

• shared/ui/Markdown — react-markdown@10.1.0 + remark-gfm@4.0.1 + rehype-sanitize@6.0.0 (security.md §4.4 지정 조합, exact pin, coding-conventions §6: MIT, 활성 릴리스, remark 생태계 표준 — 대체재 marked+DOMPurify 는 문서 지정 조합이 아니고 sanitize 를 별도 조립해야 해 배제)
• 본체는 React.lazy 청크(160KB)로 분리 — 메인 청크 567,110→572,099B(+4.9KB), 로딩 사이 fallback 은 종전과 동일한 plain text. sanitize 테스트(script/onerror 무해화) 고정
• 적용: 코칭 아코디언·오답노트(모범답안만 — 사용자 입력 미렌더, 중복 패널은 ReviewBlock 공용화)

분석 원문 보기 (backend/ + frontend/)

• 계약상 유일한 마크다운 문서가 어디에도 렌더되지 않던 gap 해소 — 상세 모달 "분석 원문 보기"
• presigned URL 은 내부(MinIO) 호스트라 브라우저 접근 불가(코드 리뷰 릴리스 블로커) → Core 프록시 GET /api/documents/{id}/content 신설(TTS 오디오 프록시 선례, 소유권 검증) + openapi/generated.ts 재생성

검증

• fe: 175 passed (+4), build·lint 클린. 메인 청크 +4.9KB, 렌더러는 async 청크
• backend: 신규 서비스 테스트 3건(스트리밍/404/미분석), 전체 242 passed — 로컬 4건은 Docker 부재 환경 실패(baseline 동일, 신규 0)
• ai: 387 passed·black 클린(프롬프트 문구만)
• frontend-reviewer Critical/Warning 0(Suggestion 반영). 코드 리뷰 6건 판정 → 6건 전부 반영(presigned→프록시, abort signal, th align, 문서 번호 중복, 패널 중복 추출, 인벤토리 등재)