Skip to content

[Docs] 미완료 작업과 막힌 지점을 한 파일로 정리한다 - #390

Merged
dldnsgkr merged 3 commits into
developfrom
unhak/docs-pending-actions
Sep 25, 2026
Merged

dldnsgkr merged 3 commits into
developfrom
unhak/docs-pending-actions

Conversation

@dldnsgkr

Copy link
Copy Markdown
Collaborator

코드 변경 없음. docs/pending-actions.md 신설.

왜

ROADMAP.md 는 작업 순서를, Issue 는 개별 작업을 다루는데 "무엇이 누구 손에 막혀 있는가" 를 보여 주는 곳이 없었다. 사람만 할 수 있는 것들이 그 틈에 있었다 — 인증서 발급, Cloudflare 대시보드, 오리진 리전 이전.

스냅샷으로 설계했다

SSOT 는 ROADMAP 과 Issue 이고 이 파일은 그 둘이 다루지 않는 축만 담는다. 항목마다 "어떻게 확인하는지" 를 적었다.

낡은 문서가 끝난 일을 가리키면 다음 사람이 그것을 다시 판다. 이번 세션에 네 번 있었다 — #115·#116·#117 이 닫혀 있는데 §3 백로그가 "1순위 후보" 로 적고 있었고, #367·#370·#372·#376 이 main 에 반영된 뒤에도 열려 있었다(Closes #N 이 develop 대상 PR 이면 자동으로 닫히지 않는다).

담은 것

🤖 Generated with Claude Code

https://claude.ai/code/session_013y8USoCXTsRTATAhy88M93

dldnsgkr and others added 3 commits September 25, 2026 12:28
ROADMAP 은 작업 순서를, Issue 는 개별 작업을 다루지만 "무엇이 누구 손에 막혀
있는가" 를 보여 주는 곳이 없었다. 사람만 할 수 있는 것(인증서 발급·Cloudflare
대시보드·오리진 리전)이 그 틈에 있었다.

스냅샷으로 설계했다. SSOT 는 ROADMAP 과 Issue 이고, 이 파일은 그 둘이 다루지
않는 축만 담는다. 항목마다 "어떻게 확인하는지" 를 적었다 — 낡은 문서가 끝난 일을
가리키면 다음 사람이 그것을 다시 판다(이번 세션에 네 번 있었다: #115·#116·#117 이
닫혔는데 §3 이 1순위로 적고 있었고, #367·#370·#372·#376 이 main 에 반영된 뒤에도
열려 있었다).

"검증 안 된 것" 절을 따로 둔 이유는, 검증되지 않은 것을 검증된 것처럼 기억하는
일이 실제로 있었기 때문이다. 하트비트는 dev 실측만 있고 운영 실측이 없으며,
`afterEventId=0` 스트림이 오래 산 것을 하트비트의 증거로 잘못 보고한 적도 있다.
그래서 검증된 것과 안 된 것을 같은 표에 나란히 적었다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013y8USoCXTsRTATAhy88M93
발급·교체·갱신 리허설까지 끝났다. 검증 켠 상태로 오리진에 HTTPS 가 붙는 것으로
확인했다(전에는 code=000).

두 가지를 기록으로 남겼다.

첫 발급 시도가 522 로 실패했다 — Cloudflare 가 오리진에 닿지 못해 HTTP-01 챌린지도
닿지 못했다. 엣지가 불안정할 때 쓰려고 만드는 우회로를 바로 그 불안정 때문에 만들 수
없었다. 비상 대비는 평시에 해 둬야 한다.

그리고 80 포트 블록의 `server` 직속 `return` 이 ACME location 을 삼키고 있었다.
`return` 은 rewrite 단계라 location 선택보다 먼저 실행된다 — `location /` 로 내려야
`^~` 가 이긴다. 이 수정은 90일마다 도는 자동 갱신에도 필요했다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013y8USoCXTsRTATAhy88M93
직전 커밋에서 "애초에 운영에 배포되지 않았다" 로 남겨 뒀는데, 그 사이 PR #389 로
배포했으니 사실이 아니게 됐다. 문서가 스스로 낡는 것을 그 자리에서 고친다.

다만 "배포됨" 과 "효과 관측됨" 은 다르다. ECR lifecycle 은 다음 배포가 ensureRepo 를
부를 때 걸리고 EIP release 는 다음 부트 타임아웃에야 돈다 — 둘 다 사건이 일어나야
보인다. 그래서 확인 방법을 같이 적었다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013y8USoCXTsRTATAhy88M93
@dldnsgkr
dldnsgkr merged commit 2c77be2 into develop Sep 25, 2026
1 check passed
@dldnsgkr
dldnsgkr deleted the unhak/docs-pending-actions branch September 25, 2026 11:40
dldnsgkr added a commit that referenced this pull request Sep 25, 2026
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 에 함께 나갔다.


Claude-Session: https://claude.ai/code/session_013y8USoCXTsRTATAhy88M93

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
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