Skip to content

[Docs] 카탈로그 단일 장애점과 previewUrl 계약 셋을 기록한다 [ #395 ] - #398

Merged
dldnsgkr merged 1 commit into
developfrom
unhak/docs-catalog-spof
Sep 25, 2026
Merged

dldnsgkr merged 1 commit into
developfrom
unhak/docs-catalog-spof

Conversation

@dldnsgkr

Copy link
Copy Markdown
Collaborator

문서만 변경한다. 코드 변경 없음.

docs/pending-actions.md

절 변경
§0 릴리스 현황 미릴리스 2건(761b14f 7446866). #395 는 V65 를 포함하므로 릴리스 시 백업 필요. 직전 릴리스(PR #394)의 검증 결과도 남겼다
§1-3 오리진 리전 09-26 측정을 세 번째 데이터 포인트로 추가. 사흘 연속이라 일시적 사고로 볼 수 없다
§2-3 #318 FE 갤러리도 프로덕션에 나갔으므로 닫을 수 있다
§2-6 #392 신규 — previewUrl 이 계약 셋이라는 것과 FE 와 합의한 3단계 순서
§2-7 #395 신규 — 코드 완료, 릴리스 남음
§4 FE 현황 #115 #117 #118

§1-3 에 넣은 09-26 측정

릴리스 직후 헬스가 522(46초)로 떨어져서, 배포 탓인지 가리려고 같은 시점에 두 경로를 나란히 쟀다.

오리진 직접 (Cloudflare 우회)   15/15 성공 · ~10ms
Cloudflare 경유                  9/15 성공 · colo=SJC

배포 탓이 아니다.

§2-6 에 넣은 경고

require-access-cookie 가 dev false / 운영 true (Java 기본값, application.yaml 에 키 없음)다. dev 에서 세션 응답의 주소를 iframe 에 넣으면 열리고 운영에서만 401 이다 — 이 자리를 dev 에서 검증하면 반드시 통과한다.

§4 에서 특히 남길 것 — Dvely_FE#118

카탈로그가 실패하면 다섯 화면이 거짓말을 하고 있었다.

화면 나오던 말
/ 랜딩 "해당 업종의 템플릿을 준비 중입니다" — 필터는 "모든 업종"이었다
/project/new "주소가 바뀌었거나 더 이상 제공되지 않는 템플릿입니다"
/home 프롬프트 아무 말 없음 — 얹기가 조용히 없던 일이 됨

/project/new 가 가장 나쁘다. 멀쩡히 있는 템플릿을 내려갔다고 단언해서 사용자를 돌려보낸다. 503 이 몇 초짜리여도 그 몇 초에 들어온 사람은 "이 템플릿 없어졌구나" 하고 나간다.

.notion/ROADMAP.md §1

2026-09-26 항목. #395 두 구멍, jar 폴백을 뺀 이유, @Transactional 로 한 번 틀린 기록, 역검증 6건과 민감도 확인, 그 과정에서 본 거짓 통과("0건 실패"가 실은 낡은 XML), dev 실측.

api.md §17.3 확장 · §17.4 신규는 PR #396 에 함께 나갔다.

🤖 Generated with Claude Code

https://claude.ai/code/session_013y8USoCXTsRTATAhy88M93

pending-actions.md
  §0 릴리스 현황 — 미릴리스 2건(#395, V65 포함이라 백업 필요)으로 갱신하고
     직전 릴리스(PR #394, #391+#390) 검증 결과를 남긴다
  §1-3 오리진 리전 — 09-26 측정을 세 번째 데이터 포인트로 추가. 사흘 연속이라
     일시적 사고로 볼 수 없다. 같은 시점 오리진 15/15 vs 엣지 9/15(SJC)
  §2-3 #318 — FE 갤러리도 프로덕션에 나갔으므로 닫을 수 있다
  §2-6 #392 신규 — previewUrl 이 계약 셋이라는 것과 FE 와 합의한 3단계 순서.
     dev 는 require-access-cookie 가 false 라 검증이 반드시 통과한다는 경고 포함
  §2-7 #395 신규 — 코드 완료, 릴리스 남음
  §4 FE 현황 — #115/#117/#118. 특히 #118 은 카탈로그 실패 시 다섯 화면이
     거짓말하던 것을 고쳤다(/project/new 가 멀쩡한 템플릿을 없어졌다고 단언)

ROADMAP.md §1 — 2026-09-26 항목. #395 두 구멍, jar 폴백을 뺀 이유,
@transactional 로 한 번 틀린 기록, 역검증 6건과 민감도 확인, 그 과정에서 본
거짓 통과("0건 실패"가 실은 낡은 XML), dev 실측.

api.md §17.3 확장 · §17.4 신규는 PR #396 에 함께 나갔다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013y8USoCXTsRTATAhy88M93
@dldnsgkr
dldnsgkr merged commit da37a94 into develop Sep 25, 2026
1 check passed
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