문서 / docs/manual-impact.md

매뉴얼 영향 및 릴리스 정합성

기능별 매뉴얼 영향과 릴리스 정합성 기록.

Phase 6·7의 공개 경로, 콘텐츠 gate, 운영 계약 변경을 독자별 매뉴얼과 연결한다. 상태는 검증 완료, 영향 없음, 외부 대기만 사용한다. 코드가 GREEN이어도 외부 배포와 rollback 증거가 필요한 행은 실제 실행 증거가 생길 때까지 완료로 닫지 않는다.

기능·경로 /guide 공개 가이드 README.md 개발자 docs/evidence-maintenance.md 근거 관리자 docs/operations.md 운영자 현재 상태
/ 개요 작업 흐름으로 연결 안정 경로·검증 설명 영향 없음 — snapshot 절차 불변 smoke 대상 검증 완료
/guide 여섯 섹션·열 단계·매뉴얼 gate 기여 흐름과 연결 영향 없음 — 근거 선별 계약 불변 smoke 대상 검증 완료
/5240lab 근거 단계와 연결 콘텐츠 구조·관리 링크 manifest→검증→snapshot 절차 smoke 및 공개 오류 대응 검증 완료
/roadmap 재평가 단계와 연결 콘텐츠 구조 roadmap 참조 전 근거 ID 유지 smoke 대상 검증 완료
/api/health 영향 없음 — 공개 작업법 변경 없음 build/runtime 경계 영향 없음 — snapshot 응답 아님 최소 JSON·release 확인 검증 완료
robots, sitemap, canonical, 404 영향 없음 — 가이드 본문 변경 없음 네 안정 경로 설명 영향 없음 — 근거 스키마 변경 없음 index·smoke·복구 계약 검증 완료
versioned release와 rollback 제품+매뉴얼 통합 release gate 로컬 명령과 검증 설명 공개 snapshot 동봉 구현 인터페이스·훈련 절차 검증 완료
DNS/TLS와 외부 공개 영향 없음 — 작업 가이드 변경 없음 실제 활성 release와 검증 경로 기록 외부 URL 유출 금지 원칙 유지 DNS·TLS 검사와 incident 절차 검증 완료

Phase 8 통합 검증 결과

  • 제품 route와 manual route 목록은 동일한 네 공개 페이지와 /api/health를 사용한다.
  • README의 현재 명령은 package.json script 또는 존재하는 파일과 대조한다.
  • deploy/build-release.sh, deploy/deploy.sh, scripts/smoke.mjs의 실제 명령과 candidate, activation, external smoke failure, rollback 계약을 shell test로 검사한다.
  • 상대 문서 링크, 공개 URL, 권한 표현, health 메시지와 release claim을 integration 및 manual validator로 검사한다.
  • 로컬 fixture candidate와 rollback 훈련을 실행했다.
  • 실제 DNS, systemd/Nginx, TLS, HTTP→HTTPS, HSTS와 외부 smoke를 2026-08-14에 확인했다.
  • 활성 release는 harness-20260814-0b665e7-r2이며 외부 smoke는 PASS다.
  • 제품 경로, 운영 매뉴얼과 실제 배포 계약을 같은 release 기준으로 재검증해 T068을 닫았다.

다음 갱신 시 feature/task ID, 변경 파일, 영향받은 매뉴얼, 검증 명령과 결과를 같은 행에 연결한다. manual-impact: none은 영향 독자·절차·공개 계약이 없다는 구체적 이유가 있을 때만 허용한다.

공개 문서 조회 (2026-08-17)

  • manual-impact: yes
  • 근거: 공개 경로가 네 개에서 다섯 개로 늘고 /docs 아래 문서 상세 경로가 생긴다.
  • 조치: 운영 매뉴얼의 외부 스모크 경로 목록에 /docs를 더하고, 공개 대상 문서는 content/docs-manifest.ts에 선언한 것만이라는 규칙을 운영 매뉴얼에 남긴다.
  • 공개 경로 확인: /docs 목록과 /docs/<묶음>/<문서> 상세가 모두 200으로 응답해야 한다.