confluence-mdx: Space 계층과 canonical 경로를 동기화합니다 - #1052
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
jk-kim0
force-pushed
the
jk/feat-confluence-folder-mdx
branch
from
July 27, 2026 08:58
d5fada8 to
42dff22
Compare
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 392d58b12f
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
jk-kim0
force-pushed
the
jk/mdx-confluence-space-update-20260727
branch
from
July 27, 2026 09:01
392d58b to
d6ab1f7
Compare
jk-kim0
force-pushed
the
jk/mdx-confluence-space-update-20260727
branch
from
July 28, 2026 05:57
d6ab1f7 to
f9e581c
Compare
QM Confluence Space의 page/folder 계층과 한국어 문서를 최신 상태로 동기화합니다. - MCP folder와 관련 문서, DB privilege mapping, 운영 로그 가이드를 추가합니다. - current가 아닌 Confluence child를 fetch와 navigation에서 제외합니다. - typed catalog와 QM 변환 manifest를 갱신합니다. - OpenSpec 계약과 회귀 테스트를 보강합니다. 🤖 Generated with Codex Co-Authored-By: Atlas <atlas@jk.agent>
## Summary Confluence Space에서 추가된 문서와 navigation 변경을 영어와 일본어에 반영합니다. - MCP Access Control, MCP Server, Audit MCP 문서를 번역합니다. - DB privilege mapping과 운영 로그 수집 가이드를 번역합니다. - Premium Support 이메일과 navigation 순서를 동기화합니다. - 한국어 원본과 Skeleton MDX 구조를 일치시킵니다. 🤖 Generated with Codex Co-Authored-By: Atlas <atlas@jk.agent>
## Summary PR 리뷰 의견에 따라 운영 로그 수집 명령과 다국어 체크리스트를 수정합니다. - Docker 로그의 stdout과 stderr를 같은 파일에 저장합니다. - 영어와 일본어 체크리스트 템플릿을 각 locale로 번역합니다. - 번역된 템플릿의 Skeleton 비교 예외를 명시합니다. 🤖 Generated with Codex
jk-kim0
force-pushed
the
jk/mdx-confluence-space-update-20260727
branch
from
July 28, 2026 06:09
f9e581c to
d58c71d
Compare
## Summary 표시용 영어 제목을 축약하지 않고 기존 public route를 유지합니다. - content ID 기반 canonical slug override 설정을 추가합니다. - parent path를 상속하여 descendant route를 안정적으로 생성합니다. - Web Client 영어 제목과 QM catalog breadcrumb를 복원합니다. - OpenSpec 계약과 repository 설정 회귀 테스트를 보강합니다. ## Test plan - `pytest -q tests/test_fetch_folders.py tests/test_convert_all_folders.py` - `pytest -q -k 'not test_sample_page'` - `npm run build -- --webpack` - `openspec validate confluence-folder-mdx --strict` - `git diff --check` 🤖 Generated with Codex
jk-kim0
changed the title
6 tasks
jk-kim0
added a commit
that referenced
this pull request
Jul 28, 2026
## Summary Confluence Space recent sync를 실행해 최신 문서 상태를 확인하고, 자동 동기화를 막던 catalog와 manifest 문제를 해결합니다. - 빈 `pages.qcp.yaml`을 유효한 YAML list로 초기화해 cross-profile preflight 오류를 제거합니다. - atomic conversion manifest를 `0644`로 저장해 container 다음의 Git 단계가 읽을 수 있도록 합니다. - main의 `pages.*.yaml`이 변경되면 Docker image build가 `--remote --attachments`를 선택해 hierarchy cache를 전체 갱신합니다. - catalog 변경이 없는 push와 PR build는 기존 `--recent --attachments`를 유지합니다. 최근 수정 후보 3개는 모두 main과 동일했으며, 최신 QM catalog 316개 중 root를 제외한 315개 문서를 변환한 결과 실제 ko/en/ja 문서 변경은 없었습니다. ## Test plan - [x] `confluence-mdx/venv/bin/python bin/fetch_cli.py --recent --attachments` - [x] `confluence-mdx/venv/bin/python bin/convert_all.py --sync-code qm` — 315개 문서 변환 성공 - [x] `confluence-mdx/venv/bin/python bin/convert_all.py --verify-translations` - [x] `confluence-mdx/venv/bin/python -m pytest tests/test_convert_all_folders.py -q` — 16 passed - [x] workflow YAML parse 및 catalog 변경/미변경 fetch mode 조건 확인 - [x] `git diff --check` ## Additional notes - 첫 workflow 실행은 빈 QCP catalog가 YAML `null`로 해석되어 실패했습니다. - 두 번째 workflow 실행은 297개 문서 변환까지 성공했지만 root 소유 `0600` manifest를 `git add`가 읽지 못해 실패했습니다. - 기존 Docker image hierarchy가 최신 main보다 뒤처져 생성한 stale 문서 삭제는 반영하지 않았습니다. 이 PR이 main에 병합되면 catalog 변경을 감지한 image build가 full remote fetch를 실행합니다. - 운영 로그 가이드의 `2>&1`은 PR #1052 리뷰로 추가된 수동 보정이며 Confluence 원문에는 아직 반영되지 않았습니다. 재변환으로 발생한 redirection 회귀는 이번 PR에서 제외했습니다. ## Related tickets & links - #1052 - [첫 workflow 실패](https://github.com/querypie/querypie-docs/actions/runs/30336412276) - [두 번째 workflow 실패](https://github.com/querypie/querypie-docs/actions/runs/30336594044) 🤖 Generated with Codex Co-Authored-By: Atlas <atlas@jk.agent> --------- Co-authored-by: Atlas <atlas@jk.agent>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
QM Confluence Space의 전체 page/folder 계층과 다국어 문서를 최신 상태로 동기화하고, 표시용 영어 제목과 canonical route를 독립적으로 유지합니다.
current가 아닌 child를 fetch, catalog, navigation에서 제외합니다.Web Client로 쿠버네티스 클러스터 접속하기의 영어 제목을Connecting to Kubernetes Clusters with Web Client로 복원하면서 경로는web-client로 유지합니다.Test plan
confluence-mdx/bin/fetch_cli.py --remote --attachmentsconfluence-mdx/bin/fetch_cli.py --local --sync-code qmconfluence-mdx/bin/convert_all.py --verify-translationspytest -q tests/test_fetch_folders.py tests/test_convert_all_folders.py(26 passed)pytest -q -k 'not test_sample_page'(1,187 passed, 1 deselected)npm run build -- --webpack(953 URLs)openspec validate confluence-folder-mdx --strictgit diff --checkNotes
confluence-mdx/var/pages.qcp.yaml이 0바이트여서 current cross-profile preflight가 YAMLnull을 거부합니다. QM 전체 변환 검증에서는 이 빈 sibling catalog만 일시적으로 제외한 뒤 원상 복원했으며 QCP 파일은 변경하지 않았습니다.tests/test_unused_attachments.py::TestRealData::test_sample_page는 로컬 실제 데이터에 미사용 첨부파일 1개가 있다고 가정하지만 현재var/1060306945에서는 0개를 반환합니다. 이번 변경과 연결된 테스트는 모두 통과했으며 해당 환경 의존 assertion만 제외해 전체 suite를 재검증했습니다.Related tickets & links
🤖 Generated with Codex
Co-Authored-By: Atlas atlas@jk.agent