confluence-mdx: 2개 이상의 Confluence Space와 동기화합니다 (이슈 #936)

[jk-kim0]

Description

이슈 #936 요구사항을 구현합니다. QM Space에 더해 QCP Space를 추가적으로 동기화할 수 있는 멀티 Space 지원 기능을 추가합니다.

커밋별 변경 내용

R2 — SyncProfile 정의 및 Config에 sync_code 필드 추가

• bin/fetch/sync_profiles.py 신규: SyncProfile 데이터클래스 및 SYNC_PROFILES 딕셔너리 (qm, qcp)
• bin/fetch/config.py: sync_code, root_content_type 필드 추가, pages_yaml_filename property 추가

R1 — pages.yaml 파일명을 Space 코드 기반으로 분리

• bin/fetch/processor.py: pages.{sync_code}.yaml 파일명 사용
• bin/fetch_cli.py: --sync-code 인자 추가 (기본: "qm"), SYNC_PROFILES에서 space_key/start_page_id/root_content_type 기본값 로드
• bin/convert_all.py: --sync-code 인자 추가, --pages-yaml 기본값 자동 도출
• bin/converter/cli.py: --pages-yaml 옵션 추가, subprocess에 catalog 경로 전달

R4 — list.txt 생성 기능 제거

• processor.py: list_lines 수집 및 list.txt 저장 로직 제거
• convert_all.py: --generate-list 플래그 및 generate_list_files() 제거
• .gitignore: /var/list.txt 항목 제거
• README.md: list.txt 관련 설명 제거

R5 — image_status.py fetch_state Space별 분리

• read_fetch_state() → read_fetch_states(): 모든 fetch_state.yaml 순회
• 리포트를 [code / root_id] 형식으로 Space별 구분 출력

R6 — Confluence folder content type 처리

• api_client.py: folder ID 시 /api/v2/folders/{id}/children 및 /api/v2/folders/{id} 호출
• stages.py: folder 루트 첫 실행 시 root_content_type 사용 (pages.v2.yaml 없는 클린 환경 대응)
• stages.py: _build_breadcrumbs의 type == "page" → type in ("page", "folder")

entrypoint + compose 멀티 Space 지원

• scripts/entrypoint.sh: full 커맨드에 --sync-code 파싱 추가, full-all 커맨드 신규 (qm, qcp 순차 실행)
• compose.yml: pages.qm.yaml, pages.qcp.yaml bind mount 추가

보조 도구 일관성 적용

• bin/unused_attachments.py: --sync-code 인자 추가, pages.<code>.yaml 로드
• bin/mdx_to_storage/link_resolver.py: 기본 경로를 pages.<default_code>.yaml로 변경
• bin/find_mdx_with_text.py: --sync-code 인자 추가, pages.<code>.yaml 로드
• README.md: var/pages.yaml → var/pages.<code>.yaml로 업데이트

QCP Space 루트 페이지 ID

• bin/fetch/sync_profiles.py: QCP 루트 887849063 (https://querypie.atlassian.net/wiki/spaces/QCP/folder/887849063), root_content_type="folder" 등록

Added/updated tests?

• Yes
  • tests/test_reverse_sync_cli.py: pages.yaml fixture → pages.qm.yaml로 업데이트
  • tests/test_reverse_sync_e2e.py: fixture가 pages.qm.yaml을 복사하도록 수정

Additional notes

• var/pages.qm.yaml: 기존 var/pages.yaml에서 git mv
• var/pages.qcp.yaml: 빈 placeholder 파일 추가 (Docker bind mount 시 디렉토리 생성 방지)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
querypie-docs	Ready	Preview, Comment	Mar 19, 2026 4:37pm