앱 랜딩 복사본 제거와 독립 저장소 소유권 — v0.17.7 release 반영 (2026-09-10)
- 기간: 2026-09-09 ~ 2026-09-10(담당 세션 1개, HQ 통합 조율). 오너 요청: “앱 repo에 있는 랜딩페이지 관련 내용은 싹 걷어내주고, 17.7 릴리스에 포함시켜줘.”
- 릴리스 반영: 이슈 #1477의 원 변경은 앱 PR #1479, 커밋
e8c90917(42파일, +84/-7,231)이다. HQ가 통합 PR #1484에 포함해 releasee56604cb0ae4d9fcaa361fbd99c3978dabb60535로 병합했다. staging PR #1488도213aaeb7c21598e3023cf47d16ec756feabad80a로 병합됐다. 이 기록의 확정 범위는 release·staging 병합이며 main·Production 완료는 HQ 최종 신호와 구분한다. - 설계서: 없음(독립 저장소 이관 뒤 앱 복사본 제거). 기대 효과와 확인 결과는 5·6절에 적었다.
- 정본: 코드·자산·테스트·CI는 Barbelic-landing, 문서·기획·운영 설명은 랜딩 안내와 저장소 경계.
- 도구: Git 추적 파일·blob 대조, 경로 검색, 기존 아키텍처 분류 검사. 이 제거 범위에는 마이그레이션·Edge·앱 주소·PWA·랜딩 호스팅 변경이 없다.
- 게이트: 초기 앱 check 3,431개 중 통과 3,404·건너뜀 27·실패 0, 분류 행동 7개와 verify-only 8단계 통과(2분 56초). 최종 통합 full CI 34372922344 성공. HQ가 회수한 full 실행 시간은 7분 32초, 사용자 시뮬레이션 56/56·화면 정합성 22/22이며 실패·건너뜀·flaky가 모두 0이다. 개별 작업자가 앱 full이나 큐를 다시 실행하지 않았다.
- 문서 검증: 원 문서 PR의 CI 34353888304는 성공했다. 이 최종 기록 변경은 문서 PR #6의 정상 문서 CI와 병합 결과로 확인한다. 관리자·앱 CI를 호출하지 않는다.
- 버그리포트: 없음(이전한 중복 구현 정리). HQ 전체 릴리스 기록은 HQ가 담당한다.
Phase 현황
| Phase | 내용 | 상태 |
|---|---|---|
| Phase 1 | 앱의 홍보 랜딩 구현·참조 제거, 문서 원본 보존 | 완료 — e8c90917, 행동 7개·앱 check 통과(보고) |
| Phase 2 | 사전 검증·HQ 통합·릴리스 반영 | 완료 — 통합 full CI 성공, PR #1484의 release merge e56604cb에 포함. staging 병합 213aaeb7 확인 |
1. 배경
랜딩 문구·디자인을 고칠 때 앱의 full CI까지 반복하는 결합을 사용자가 지적해 랜딩을 독립 저장소로 옮겼다. 초기 반입은 Barbelic-landing 16c6d32, 소유권 안내는 문서 PR #5로 반영됐다. 이후 앱에 남은 복사본과 참조를 제거해 v0.17.7에 포함하도록 승인됐다.
2. 문제 제기
앱 기준 84e2d7d에는 landing-page/ 31파일이 남아 있었다. 코드·자산·의존성·설정·브라우저 검사와 문서 5개가 중복됐고, 아키텍처 분류·HTML 제외 조건·기존 안내에도 그 경로가 남았다. 작업자가 앱 쪽 복사본을 정본으로 오해할 수 있었다.
3. 해결 방안
원칙
- D1(2026-09-09): 랜딩 코드·자산·전용 CI는 Barbelic-landing으로 분리하고, 문서·기획·이력은 Barbelic-docs가 소유한다.
- D2(2026-09-09): 앱의 중복 랜딩 구현·참조를 v0.17.7에서 제거한다. 병합 자동화의
landing-*는 홍보 사이트와 별개다. - D3(2026-09-09): 오너의 최소 CI 지시에 따라 HQ가 승인된 작업을 한 통합 후보로 모은다. 같은 코드 검사를 반복하거나 개별 full·큐 요청을 추가하지 않는다.
| 선택 | 결과 | 판단 |
|---|---|---|
| 앱 복사본과 전용 참조 제거 | 수정할 정본이 독립 저장소 한 곳으로 명확해짐 | 채택 |
| 앱 폴더를 남기고 CI만 제외 | 두 복사본과 앱 경로 참조가 계속 남음 | 제거 요청을 충족하지 않아 기각 |
4. 적용한 내용
Phase 1 — 제거와 문서 보존
원 변경에서 landing-page/ 31파일과 중복 보고서 docs/updates/2026-09-03-landing-page.md를 삭제했다. 혼합 문서의 홍보 랜딩 문장만 정리하고 문서 저장소의 과거 기록은 보존했다. 랜딩 영역 1개·규칙 12개·HTML 제외 조건을 제거했으며 외부 영역 분류의 행동 검증은 일반 fixture로 유지했다.
랜딩 문서 5개는 문서 저장소 db9bd37 이력에 앱 원본과 같은 blob으로 보존돼 있음을 확인했다. README·PRD의 현재판은 문서 PR #5에서 독립 실행 안내로 갱신됐다. 기획·디자인 문서와 과거 보고서도 정본에 유지했다.
Phase 2 — 사전 검증과 HQ 통합
원 커밋의 check·빌드·산출물·단위 검증은 통과했다. 구 base 84e2d7d의 개별 큐 34353950279는 오너 중단 지시로 취소됐다. 당시 사용자 시뮬레이션은 통과 44·실패 12·flaky 1이었고 화면 정합성 검사는 도중 중단됐다. 대표 관측은 통계 cleanup 완료 대기 오류였으며 원인을 확정하거나 새 통계 수리를 이 작업에 붙이지 않았다. 이 부분 결과는 최종 통합 후보의 결과와 구분한다.
최신 main df394f77 기준으로 ef01038f와 bundle을 준비하면서 build-targets의 최신 백업 workflow 이름을 보존했다. HQ는 이미 원 head를 같은 방식으로 적용하고 #1463의 문서 분리와 통합했으므로 이 준비 커밋을 중복 적용하지 않았다. HQ 526cda17에는 겹치는 문서 삭제와 분류 도구 조정이 반영됐고, 일반 HTML 진입점 및 관리자 API 발견 검증을 함께 보존했다. 원 앱 PR과 문서 PR은 추적 근거로 유지했다.
최종 통합 head 81d980352d44c443b5d8776154a7c44c980748f8의 필수 full CI가 성공한 뒤 검증한 release merge e56604cb로 반영됐다. staging merge는 213aaeb7이다. staging 배포 34374171430와 main·Production 승격은 HQ가 관리하며 이 문서에서 완료를 선행 선언하지 않는다.
작업 중 드러난 것
초기 84e2d7d 비교에서는 독립 장부 미분류 29개·미등록 cron 2개가 전후 동일했고 새 누락·장부 행 누락은 0개였다. 최신 main df394f77의 별도 준비에서는 미분류 32개·미등록 cron 2개가 전후 동일했다. 이 숫자는 각 시점의 비교 증거이며 최종 통합 상태의 실패 수치가 아니다. 장부 문서의 생성부도 초기 작업 스냅샷으로 명시했다. #1463 이후 앱 검증은 문서 생성물과 결합하지 않는다.
초기 base에 새 CLI 별칭이 없어 당시 제공된 ci:local --verify-only·landing:request를 사용했다. 이후 최신 기반의 명령을 따르되, 이번 최종 문서 마무리에서는 앱 full·큐·승격을 다시 실행하지 않았다.
5. 적용 결과
| 항목 | 전 → 후 또는 확인 상태 |
|---|---|
| 앱의 랜딩 복사본 | 31파일 → 제거, 독립 코드 정본 유지 |
| 중복 랜딩 보고서 | 앱 1개 → 제거, 문서 정본 유지 |
| 랜딩 전용 영역·규칙 | 영역 1개·규칙 12개 → 제거 |
| 문서 원본 보존 | 랜딩 5문서의 원본 blob과 과거 보고서 보존 확인 |
| 초기 앱 사전 검증 | check 3,404 pass·27 skip·0 fail, 행동 7개, verify-only 8단계 통과 |
| 최종 통합 full CI | 7분 32초, 사용자 시뮬레이션 56/56·화면 정합성 22/22, fail/skip/flaky 0 |
| release 반영 | PR #1484, e56604cb0ae4d9fcaa361fbd99c3978dabb60535 |
| staging 반영 | PR #1488, 213aaeb7c21598e3023cf47d16ec756feabad80a |
| main·Production | HQ 최종 신호로 별도 확정. 이 기록에서 반영완료로 표시하지 않음 |
| 앱 주소·PWA·랜딩 공개 호스팅 | 이 제거 작업의 변경 범위에 없음 |
6. 이번 개선으로 향상된 것
랜딩 문구·디자인 작업은 독립 코드 저장소 한 곳에서 진행하고 전용 CI·배포로 처리한다. 앱의 중복 구현과 분류 참조를 제거했으며, 문서 원본과 작업 이력은 문서 저장소에 보존했다. 이번 일회성 앱 제거는 다른 승인 작업과 함께 HQ의 통합 full CI 한 번으로 최종 검증했다.
남은 것
앱 main·Production의 최종 신호와 중복 원 앱 PR 정리는 HQ의 승격 결과 후 처리한다. 도메인 분리 #1474는 이 제거 작업의 범위에 포함하지 않는다.