# 병원 공통 비급여 자동 연동

병원 홈페이지의 비급여는 미리닥 API를 기본 자료로 사용한다. ROOT-ADMIN의
`사이트 내용`에서 원본과 확인일을 보고, 병원 수정·추가·숨김만 별도로 저장한다.
원본 조회나 갱신은 CMS 문서를 쓰지 않는다. 병원마다 같은 기능을 제공하되 기관 ID로 구분한다.
`content-area.json`은 편집 계약, `files/`는 고객에게 납품하는 공개 소스다.

## 신규·기존 병원 적용

신규는 `pnpm starter:init <빈 경로> --industry medical --miridoc-id <6자리 기관 ID>`로
생성한다. 미리닥 `/h/<ID>`에서 기관명·주소·연락처를 확인한 뒤 ID를 연결한다.
공개 `/guide/non-covered`, 편집 slug `non-covered-fees`, 빈 보완 초안, 미리보기,
푸터 링크를 Materializer의 manifest·외부 receipt로 추적한다. 생성만으로 운영에 쓰지 않는다.

기존 병원은 기존 주소·디자인·문서를 유지하며 `content-area.json`을 계약의
`contentAreas`에 합친다. table의 `source.institutionId`를 설정하고 `lib/root-admin`의
공개 읽기와 `NonCoveredFees`의 검색·분류·HTML 표를 연결한다. 기존 preview 라우트에는
비급여 분기만 합친다. 고객 저장소는 비공개 플랫폼 패키지를 import하지 않는다.

공통 읽기 정본은 `packages/site-content-contract/src/miridoc-fees.ts`다.
`node scripts/sync-hospital-fees-runtime.mjs`로 이 모듈의 복사본을 동기화한다.
JavaScript 고객은 `--javascript <대상 파일>`, 일치 검사는 `--check`를 쓴다.

## 자동 자료와 병원 수정본

- 읽기 API: `GET https://miridoc.com/api/v1/institutions/<ID>/non-covered`.
  인증정보 없이 공개 기관 스냅샷의 **전체 행**을 읽는다. 화면 더 보기 API를 쓰지 않는다.
- 현재 원천은 심평원의 병원급 비급여 신고 자료다. 의원급·누락 항목은 자동 자료가
  없을 수 있다. `no_source`·`not_loaded`와 503 장애를 구분한다. 보완 금액을 만들지 않는다.
- 원천 행은 `md-…` ID, 자동 분류는 `mdg-…` ID다. 병원 추가 행은 UUIDv7이다.
  원천의 금액·날짜 변경은 행 ID를 유지한다. 명칭·원천 순번 등 정체성이 달라지면
  이전 수정본을 자동 승계하지 않는다. 원천에서 빠진 수정본은 관리자에서 보관·확인하고 공개에서 제외한다.
- 원본의 **수정**을 누르면 해당 행 전체의 병원 수정본을 만든다. 저장 후에는 그 행에
  수정값을 사용한다. **수정본 삭제 · 자동값 복원**을 저장하면 원천을 다시 따른다.
  원천 분류·순서는 그대로 유지한다. 병원 추가 행만 분류 이동·순서를 관리한다.
- 기존 문서는 병원 안내로 보존한다. 원천과 코드·이름이 같아도 임의로 덮지 않는다.
  중복 항목의 정리는 병원이 원문과 새 자료를 대조한 뒤 한다.
- CMS 보완 문서가 없거나 비공개여도 자동 자료는 계속 표시한다. 보완 내용만 제외된다.
  자동 항목의 숨김은 그 행의 수정본에서 관리하고 전체 자동 연결은 계약에서 해제한다.

## 저장·공개 경계

`kind: "table"` 값은 `[{ id, title, rows: [{ id, cells: string[], hidden?: boolean }] }]`
JSON 문자열이다. 금액·코드 앞자리 0·공란·범위·날짜를 보존한다. 병원 수정·추가는
100분류·1,000행, 셀당 2,000자, 문서 값 합계 500,000자까지다. 자동 원본의 한도는 별도다.
셀별 구 문서는 table의 `legacy`에 그룹·행·셀 키를 매핑한다. 첫 저장 때 변환하며,
기존 수정 이력도 같은 방식으로 읽는다. 누락·혼합·중복 입력은 부분 저장하지 않는다.

기존 저장·발행 권한, 동시 수정 검사, 수정 이력·복원, 서명 웹훅을 사용한다.
인증된 preview는 현재 초안과 원천을 합치며 CMS 공개본으로 초안을 덮지 않는다.
no-store·noindex·no-referrer 및 분석 제외를 유지한다. 공개 표의 숨김 행은 서버에서
제거하고 브라우저 데이터에도 보내지 않는다. 수정 행과 자동 출처·확인일은 구분한다.
장애는 예전 로컬 금액이나 정상 빈 표로 바꾸지 않는다.

## 배포 순서

운영 반영은 사용자 승인 후 실행한다. 미리닥 원천 행 ID를 담은 기관 스냅샷 재발행과
API 배포 → ROOT-ADMIN → 기존 계약·보완 문서 백업 및 계약 병합 → 병원 사이트 순서다.
API는 이전 ID 없는 스냅샷을 503으로 처리하므로 선행 배포 없이 사이트만 전환하지 않는다.
기존 초안·발행본은 임의로 덮거나 일괄 발행하지 않는다. 최초 보완 문서도 동일 slug가
없을 때만 `cms/non-covered-fees-page.json`으로 생성한다.

미리닥의 기존 수집 주기를 따르며 API 공유 캐시와 홈페이지 데이터 재검증은 각각 5분이다.
병원 수정은 사이트의 기존 서명 웹훅으로 반영한다. 출시 전에는 실제 기관 식별,
미리보기·저장·숨김·복원·원천 삭제·장애·390px 화면을 확인한다. 미리보기 도메인은 noindex를 유지한다.

## 테스트 실행 위치

MCP 서버의 검사는 `pnpm --filter @roottale/cms-mcp test`로 실행한다.
`files/tests/non-covered.test.tsx`는 고객에게 생성되는 Next.js 테스트이므로 생성된
병원 사이트에서 `pnpm exec vitest run tests/non-covered.test.tsx`로 실행한다.
생성된 사이트의 `pnpm test`와 CI에도 포함되며, MCP 서버에 React 의존성을 추가하지 않는다.
