v0.17.6 main 도달 후 문서 이관 기준 갱신 — #1463

• 작업: 앱 #1463 / 앱 분리 PR #1466의 Phase 4. 최종 앱 전달은 HQ의 통합 PR #1484, 목표 릴리스는 v0.17.7이다. 이 문서 PR은 앱 코드·큐·배포 설정을 변경하지 않는다.
• 앱 초기 이관 기준: 84e2d7d3553723d9b11a1a8de18efbc6e910af00.
• 앱 최신 읽기 기준: v0.17.6 main 승격 #1481, df394f77ab0efe16ad018aecf2799a2306b10731.
• 문서 초기 통합 base: dekerd/Barbelic-docs main bb406438a499a519c3e0fa028ddcdeee7c2225ca. 게시 전 최신 main 0417306을 추가 통합해 docs PR #1·#10의 기록도 보존했다.
• 문서 작업 브랜치: docs/1463-sync-app-main. HQ 승인에 따라 이 브랜치의 문서 PR과 문서 전용 CI로 정본에 반영한다. 실제 Vercel 연결 전환은 별도다.
• 정본: 저장소 경계, 문서·관리자 전환 상태, 현재 세션 제목 규칙.

배경과 범위

초기 이관 뒤 앱 v0.17.6에 #1460 명령·워크플로 개정, 날짜·PR 스냅샷 수리 기록, 실제 통계 발행·정리 검증, 소셜 로그인 CASE-059·060 문서가 추가됐다. 이 문서들을 빼고 앱의 문서 삭제를 통합하면 운영 규칙과 수리 근거가 누락된다. 반대로 앱의 docs/를 그대로 덮어쓰면 문서 저장소에서 이미 확정한 독립 배포·제목 규칙·시간 예산·랜딩 소유권이 되돌아간다.

초기 앱 원문을 공통 base로 두고 최신 앱 문서와 최신 문서 저장소를 3-way로 합쳤다. 앱 충돌 checkout의 작업 파일은 읽지 않고 고정 Git commit의 blob만 사용했다. docs/의 변경 20개와 error-cases/ Markdown 변경 7개를 원래 상대 경로로 반영했다. 실행용 case.json·회귀 코드·fixture·support 코드는 앱 소유이므로 이관하지 않았다.

반영한 문서

묶음	반영 내용
명령·운영 9개	branch-workflow, ci-flow, ci-local, deployment-pipeline, migration-landing, release-landing-queue, release-process, rollback, v0-18-0-hq-operations: merge:request·precheck/full 구분과 개명된 워크플로·DB 준비/복구 안내
플랫폼 2개	build-targets, social-auth: 환경별 workflow 명칭과 소셜 점검 경로
테스트 설명 4개	gates/test-audit, 브라우저 E2E 원문·한국어 번역, testing/e2e-crud-roundtrip: 실제 날짜 사용 허용, 잘못된 달력 전제 수정, 원본 요청·저장·재조회 및 발행/정리 보증
새 작업 기록 2개	고정 PR 스냅샷 날짜 수리, 릴리스 큐 명령·워크플로 개정: 당시 구현·수치·미검증·후속 정책 정정을 원문 그대로 보존
문서 지도·기록 형식 3개	.vitepress/config.mts, docs/README.md, updates/README.md: 새 기록 등록과 개정 명령 반영
error-case 설명 7개	CASE-008 README·USER-JOURNEY 갱신, CASE-059 Google·CASE-060 Apple의 README·USER-JOURNEY 추가, error-case 인덱스 등록

3-way 보존과 충돌 해결

• 실제 충돌은 branch-workflow, deployment-pipeline, release-landing-queue, release-process, v0-18-0-hq-operations의 머리 안내 5곳이었다. 문서 저장소의 #1463 분리 안내와 앱에서 추가한 #1460 개명 안내를 모두 남겼다.
• ci-local의 #1468 시간 예산 절과 e2e-master-plan의 연결 문장을 보존했다. #1468은 v0.17.7 적용 예정이라는 상태도 바꾸지 않았다.
• 문서 저장소에서 간소화한 세션 제목 규칙 및 공통 규칙의 제목 문단을 보존했다. 새 제목 상태를 추가하지 않았다.
• 랜딩 저장소 소유권과 랜딩 실행 안내는 그대로 유지했다. 앱 큐에 랜딩을 다시 넣는 지침을 만들지 않았다.
• 앱 AGENTS는 수정하지 않았다. 최신 앱 AGENTS의 유효 변경인 새 통합 명령과 실제 날짜/원본 데이터 보존 원칙만 문서 저장소의 공통 지침에 반영했다. 앱에 남기는 고정 안내 링크의 예외와 "안내 파일을 검사하는 CI를 만들지 않는다"는 규칙을 유지했다.
• 실행·문서가 한 폴더에 있다는 이전 E2E 패키지 설명은 두 저장소에 걸친 같은 CASE라는 범위를 명시했다. 사람용 문서는 이 저장소에서, 실행 코드는 앱에서 갱신하고 PR·커밋을 연결한다.
• 게시 전 docs main의 통계 게시 예약 기록 PR #1과 사후 브라우저 점검 기록 PR #10을 추가 통합했다. 업데이트 목록과 사이드바 두 곳의 충돌은 양쪽 항목을 모두 유지했고, 새 기록·측정 증거·통계 문서·배포 후 점검 절차를 보존했다.

main 도달과 아직 끝나지 않은 전환

df394f77a의 조상에 #1460 통합 커밋 4b726b96c가 있음을 확인했다. 따라서 "v0.17.6이 main에 도달할 때까지 대기"는 더 이상 현재 상태가 아니다. 개명된 명령과 workflow 파일은 main에 존재한다.

당시 main은 docs 설치·빌드와 evidence.docs === true를 요구했지만, 이후 사용자 승인 범위의 최소 2파일이 staging PR #1486 → main PR #1487 / 65a12274671e0daabb23774c7d32cc9ecca85e63으로 반영됐다. docs 부재 후보의 큐 호환은 활성화됐고, 검증된 tree와 한정된 예외 승인 근거는 운영 기록에 남겼다. 기존 선행 패치는 변경 이력이며 전체 v0.17.7 운영 반영의 증거가 아니다.

HQ는 통합 PR #1484의 5c460a14fbd961eb35018e698df3b9235ce8e4d1을 동결하고 사용자가 승인한 통합 full CI 1회를 요청 중이라고 보고했다. 이 문서 게시로 앱 후보를 다시 변경하거나 앱 CI를 추가하지 않는다. 독립 관리자 staging의 HTML·JS 및 대상 도장은 확인됐지만, 새 앱 staging API·CORS 확인과 기존 문서 Git/RootDirectory 전환은 아직 남아 있다. 자동배포용 PAT 부재는 지원되는 기존 CLI 수동 배포와 구분한다.

앱 release/v0.17.7의 최신 base 통합·충돌 해결·실제 검사와 원격 배포 전환은 각 담당 작업에서 확인한다. 이번 문서 통합은 Production 배포 성공을 새로 판정하지 않는다. 과거 수리 기록의 검증 결과는 해당 기록의 시점과 범위로 보존하며, 현재 분리 후보 전체의 통과 증거로 재사용했다고 쓰지 않는다. 별도 테스트 품질 이슈 #1478은 이 작업 범위에서 제외한다.

검증

npm ci --prefix docs --no-audit --no-fund 이후 npm run check, npm run build:docs, npm run check:docs-artifact가 모두 통과했다. 약관 4개 버전과 내부 경로 297개를 확인했고 VitePress 빌드는 29.01초에 완료됐다. 공개/정책 자산 31개도 검증했다. 빌드의 500 kB 초과 chunk 경고 외 오류는 없었다. git diff --check와 3-way 보존 비교도 통과했다. 앱·관리자 빌드와 앱 full CI, 큐 요청, Production 설정 변경은 수행하지 않았다.

위 로컬 빌드는 초기 문서 통합 시점의 증거다. docs main 0417306 통합 후에는 같은 로컬 빌드를 반복하지 않고 문서 PR의 경로 선택 CI 1회로 확인한다. 관리자 실행 코드·워크플로·패키지 입력 변경은 없으며, 문서 CI 성공과 실제 서비스 연결 전환 완료를 구분한다.

2026-09-10 후속 전환 기록

문서 정본은 docs PR #11 / main 63e3ef598fe565c3dcba132e9d5760656aa0326d에 반영됐다. 문서 전용 CI 34364994748는 scope·docs·verify 성공, admin 제외로 1회 완료했다.

같은 docs main에서 독립 관리자 Production 배포를 수행했다. 이전 검증 이후 관리자 코드 변화는 없고, 공개 /admin/ HTML·JavaScript 200과 Production 대상 도장을 확인했다.

앱 staging 213aaeb7 배포 성공 뒤 실제 관리자 API의 양성·음성·CORS·manifest 12개 확인을 통과했고 시험 계정 2개는 삭제 후 각각 404를 확인했다. 기존 docs 프로젝트의 ID·도메인을 유지하면서 Git을 Barbelic-docs, RootDirectory를 루트로 전환했다. 문서 staging의 기존 /admin/ HTML·JavaScript는 두 프로젝트의 정상 보호 인증 아래 독립 관리자와 바이트가 일치했다. 처음 Vercel 로그인 화면이 보인 것은 docs 인증만 제공한 검사 조건이었으며, 보호를 해제하거나 코드를 수리하지 않았다.

앱 main 937042d775049b96ad00438fbe4019e1ec464e0c의 Production 배포·smoke 34375087828 성공 신호 뒤, 최신 docs main 7e19213d01eca078db756f9c94a9fdc1138daea5에서 Production 문서 배포를 게시했다. 기존 관리자 주소·문서 홈·기존 메뉴·JS 및 docs/앱 양쪽 약관·계정 삭제 원문 총 27개 확인이 통과했다. Production API에서도 허용 origin의 preflight·무인증 거부·비허용 origin 거부·no-store를 확인했으며, 관리자 Bearer 양성은 같은 앱 tree의 staging에서 검증했다.

기존 docs와 독립 admin 주소를 복귀 주소로 지정한 Kakao·Google·Apple 로그인 시작은 총 6개 요청 모두 제공자 302 이동을 확인했다. 반환 state에서 최종 복귀 주소는 확인하지 못했으므로 실제 callback 허용·로그인 완료까지 검증했다고 쓰지 않는다. 외부 제공자 로그인이나 Production 시험 계정·권한 생성을 추가하지 않았다.

서비스 연결 전환은 완료했다. 독립 Actions용 VERCEL_TOKEN은 여전히 미설정이며 자동배포는 비활성이다. 기존 CLI로 수행한 실제 게시 성공과 자동배포 설정 완료를 구분한다. 최종 기록은 기존 두 문서의 실제 변경만 HQ에 넘겨 종합 릴리스 기록과 한 문서 PR·CI로 반영한다. 상세 상태는 문서·관리자 운영을 따르며 종합 v0.17.7 릴리스 보고서는 중복 작성하지 않는다.