MMX Beta Project Documents 계획, 근거, 댓글이 같은 기록으로 남는 작업 저장소

project_document 개선_report_20260522

개요

2026-05-22 기준 MMX Beta Project Documents 포털 구조와 Release 기록 체계를 개선했다.

오늘 반영한 작업

  1. Project Documents 루트에 Release 섹션을 추가했다.
  2. 기존 Cloud Run 배포 이력을 Release 섹션에 정리했다.
  3. BETA_DOC_POLICY_001에 배포 후 Release 기록 의무를 추가했다.
  4. 루트 화면의 신규 문서 최근 10개를 자동화했다.
  5. Markdown 보고서도 신규 문서 최근 10개 자동 수집 대상에 포함되도록 수정했다.
  6. 루트 신규 문서 최근 10개에 날짜뿐 아니라 시각도 함께 표시하도록 바꿨다.
  7. Release 화면에 서비스별 필터링과 리스트형 배포 이력 표시를 적용했다.
  8. 루트 최신 배포 이력도 카드 나열 대신 하나의 카드 안 리스트형으로 정리했다.
  9. 루트 및 Release 화면에서 revision, sha256 같은 저수준 배포 식별자 노출을 줄이고 작업 설명 중심으로 정리했다.
  10. Release 원본 데이터를 releases/releases.json으로 분리해 동적 대시보드가 안정적으로 읽도록 구조를 정리했다.
  11. 단순 수제 markdown 렌더러를 제거하고 marked 기반 렌더러로 교체했다.
  12. markdown 산출 HTML에 sanitize-html을 적용해 허용 태그와 속성만 통과시키도록 안전화했다.
  13. 댓글 패널을 markdown 본문 article 내부가 아니라 바깥 shell 구조로 분리해 문서 본문 손상과 댓글 UI를 느슨하게 결합하도록 바꿨다.

산출물

  • /project_document/ 루트 동적 요약 화면
  • /project_document/releases/index.html 동적 Release 대시보드
  • /project_document/view/reports/project_document_개선_report_20260522.md 개선 보고서 게시본
  • BETA_DOC_POLICY_001 규정 보강
  • releases/releases.json Release 원본 데이터
  • marked 기반 markdown 렌더링
  • sanitize-html 기반 markdown 출력 안전화
  • 본문 article과 분리된 댓글 패널 shell 구조

Release 기록 규칙 보강

  • 배포 후에는 Release 섹션을 먼저 갱신한다.
  • Release 항목에는 최소한 아래 정보를 남긴다.
    • service
    • revision
    • deployedAtKst
    • image digest
    • task

확인 결과

  • 루트 페이지 정상 노출 확인
  • 루트의 신규 문서 최근 10개에 project_document 개선_report_20260522 노출 확인
  • 신규 문서 최근 10개에 날짜와 시각 함께 표시되는 것 확인
  • 루트 최신 배포 이력이 리스트형으로 정리된 것 확인
  • Release 대시보드 정상 노출 확인
  • Release 화면이 서비스별 리스트형으로 정리된 것 확인
  • 정책 문서 정상 노출 확인
  • VOICE_CHAT_ROOM_수다방/implementation_plan.md 페이지에서 WBS markdown table 렌더링 정상 확인
  • 같은 페이지에서 댓글 등록 UI와 댓글 기능 로드 완료 상태 문구 정상 확인
  • markdown 출력 HTML에서 위험 script/href 패턴이 제거된 것 확인
  • 댓글 섹션이 markdown article 뒤에 분리 배치된 것 확인

후속 권고

  1. 새 배포마다 releases/releases.json에 task 포함 항목을 append하는 스크립트를 만든다.
  2. 최근 문서 10개에서 category index 문서를 제외할지 정책적으로 정한다.
  3. Release task 설명을 과거 이력까지 더 촘촘하게 보강한다.
  4. Release 화면에서는 revision, digest를 운영 확인용 숨김 상세 정보로 둘지 완전히 제거할지 정책을 확정한다.
  5. markdown 회귀 테스트용 샘플 문서를 별도로 두고 table, ordered list, fenced code, image, link, nested list 케이스를 정기 검증한다.
  6. 다음 단계에서는 댓글 패널을 React 컴포넌트로 완전 분리해 dangerouslySetInnerHTML 의존을 더 줄인다.

댓글