[운영] DDL 이 빠졌으면 뜨지 않는다

[RosieOh]

Closes #98

막으려는 것

DB-first 라 prisma/sql/*.sql 을 사람이 적용한다. 코드만 배포되고 DDL 이 빠지면 앱은 멀쩡히 뜨고 조용히 못 한다.

빠진 DDL	조용히 실패하는 것
008 risk_scores.missing_factors	위험도 저장 → 시민 화면에 아무 단계도 안 나온다
007 prediction_evaluations.actual_granularity	예측 대조 배치
009 static_guide_translations	응급대처법이 화면에서 사라진다

기동 로그는 정상이고 실패는 한 시간 뒤 배치에서 처음 드러난다. 그 한 시간은 하필 배포 직후다.

지금 이 저장소에 적용 대기 중인 DDL 이 정확히 그 셋이다.

어떻게

shared/persistence/schema-guard.ts 가 기동 시 점검하고, 없으면 뜨지 않는다.

DB 스키마가 코드보다 뒤쳐져 있습니다 (2건).
  · risk_scores.not_applied_yet 없음 → 테스트용 가짜 요구사항
    적용: mysql -u <user> -p <db> < prisma/sql/010-future.sql
  · table_that_does_not_exist 없음 → 테스트용 가짜 테이블
    적용: mysql -u <user> -p <db> < prisma/sql/011-future.sql
이 상태로 뜨면 앱은 정상으로 보이지만 위 기능이 조용히 실패합니다. 그래서 기동을 막습니다.

무엇이 없고, 무엇이 안 되고, 어떤 파일을 적용해야 하는지가 한 번에 나온다. 막을 때는 다음 행동이 분명해야 한다.

"조용히 열린 채 뜨는 것보다 실패하는 쪽이 낫다" 는 이 저장소의 기준을 스키마에도 적용한다 — CORS_ORIGIN 이 운영에서 기동을 막는 것과 같은 이유다.

⚠️ 두 가지 실패를 다르게 다룬다

없는 것을 확인함	기동을 막는다
확인 자체가 실패함	경고만 남기고 통과

뒤를 통과시키는 이유 — 관리형 DB 에서 information_schema 권한이 제한될 수 있는데, 점검기가 서비스 전면 중단의 원인이 되면 안 된다. 레이트 리밋이 Redis 장애 때 fail-open 하는 것과 같은 기준이다.

검증

lint 0 · unit 1386 · e2e 65 · 실 DB 스모크 174 (신규 2) · build OK
git rebase --exec 'npx tsc --noEmit'  → 3 커밋 전부 단독 통과

• 정상 DB 에서 스키마 점검 통과 (7개 요소) 후 기동
• 없는 컬럼·없는 테이블을 요구 목록에 넣으면 기동이 막히는 것 확인
• SQL 파일명을 틀리게 바꾸면 스모크가 깨지는 것 확인 — 오류가 존재하지 않는 파일을 안내하면 막은 것이 도움이 아니라 방해가 된다

규칙

prisma/sql/ 에 파일을 추가하면 schema-requirements.ts 에도 함께 적는다. 안 적으면 다음 사람이 DDL 을 빠뜨려도 아무도 모른다 — 이 목록의 값은 빠짐없음에 있다. README 에 적었다.

인덱스처럼 "있으면 빠르고 없으면 느린" 것은 넣지 않는다. 기동을 막을 근거가 아니다.