Skip to content

docs: sync GRC-03 frontend runtime source of truth#25

Merged
alexization merged 4 commits intodevelopfrom
feat/grc-03-runtime-doc-sync
Mar 26, 2026
Merged

docs: sync GRC-03 frontend runtime source of truth#25
alexization merged 4 commits intodevelopfrom
feat/grc-03-runtime-doc-sync

Conversation

@alexization
Copy link
Copy Markdown
Owner

@alexization alexization commented Mar 26, 2026

1) 요약

  • GRC-03 구현 결과에 맞춰 frontend route map, data flow, runtime reference를 proxy.ts, local font, public env helper 기준으로 동기화했습니다.
  • GRC-03 완료 exec plan을 completed로 기록하고 follow-up env fix와 최종 검증 결과를 반영했습니다.

2) 연관 이슈

3) 문제와 목표

  • 문제: workflow source of truth 문서가 middleware.ts, Google Fonts 의존, 암묵적 env fallback 기준에 머물러 있어 실제 client 구현과 어긋났습니다.
  • 운영/문서/하네스 관점의 결과: 후속 GRC-04, GRW-05가 참조할 frontend runtime 기준을 실제 구현과 일치시키고, GRC-03 실행 기록을 completed 상태로 고정합니다.
  • 비목표: workflow runtime 스크립트 추가, client 코드 직접 수정, backend 계약 변경

4) 영향 범위

  • 변경된 문서 / 디렉터리 / 스크립트: docs/architecture/frontend-route-map.md, docs/domain/frontend-data-flows.md, docs/operations/frontend-runtime-reference.md, docs/exec-plans/completed/2026-03-26-grc-03-frontend-build-runtime-harness.md
  • 다른 저장소 영향: 실제 구현은 client PR alexization/git-ranker-client#7에서 반영됨
  • 계약 / 런타임 / evidence 영향: frontend runtime/env/font/proxy source of truth와 exec plan evidence가 최신화됨
  • 보안 / 권한 영향: 문서 변경만 있으며 추가 권한 모델 변경 없음

5) 검증 증거

유형 명령어 / 증거 결과
Docs Structure find docs -maxdepth 3 -type d 성공
Policy / Index 미실행(AGENTS.md, PLANS.md 변경 없음) 범위 외
Generated / Runtime git diff --stat origin/develop...HEAD -- docs/..., client PR #7npm run lint, npx tsc --noEmit, npm run build, npm run dev 결과 참조 확인
GitHub Flow gh issue create --repo alexization/git-ranker-workflow ..., gh pr create --base develop 수행

6) source of truth 반영

  • 업데이트한 문서: docs/architecture/frontend-route-map.md, docs/domain/frontend-data-flows.md, docs/operations/frontend-runtime-reference.md, docs/exec-plans/completed/2026-03-26-grc-03-frontend-build-runtime-harness.md
  • 업데이트하지 않은 문서와 사유: docs/product/*와 roadmap catalog는 기존 GRC-03 정의가 유지되므로 변경하지 않았습니다.

7) AI 리뷰 메모 (선택)

  • Codex: client PR과 workflow PR을 governance에 맞춰 분리해 생성했습니다.

8) 리스크 및 롤백

  • 리스크: client PR #7이 merge되지 않은 상태에서 이 문서만 먼저 merge되면 source of truth와 실제 구현이 잠시 어긋날 수 있습니다.
  • 롤백 계획: 이번 문서 commit을 revert 하고 exec plan 상태를 이전 값으로 되돌리면 됩니다.

9) 체크리스트

  • 연관 이슈가 연결되어 있음
  • 검증 결과가 기입되어 있음
  • source of truth 문서 반영 여부가 적혀 있음
  • 다른 저장소 영향이 있으면 분리 계획 또는 후속 이슈가 적혀 있음
  • develop 기준 브랜치와 PR 정보가 맞게 기입되어 있음

@alexization alexization self-assigned this Mar 26, 2026
Copy link
Copy Markdown
Owner Author

Client PR #7 review follow-up changed runtime semantics slightly, so source of truth was synced in f99bc20.

Updated points:

  • NEXT_PUBLIC_BASE_URL / NEXT_PUBLIC_API_URL now document invalid absolute URL fail-fast behavior and origin-only normalization
  • script-src notes that unsafe-eval is development-only
  • build/runtime section now reflects the stricter public env parsing behavior

Copy link
Copy Markdown
Owner Author

Client PR #7 is merged, so the workflow submodule pointer has now been synced in 91fd597.

Submodule change:

  • git-ranker-client: 5f6a6dd -> 5fff71d

@alexization alexization merged commit 8583f8c into develop Mar 26, 2026
@alexization alexization deleted the feat/grc-03-runtime-doc-sync branch March 26, 2026 07:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant