CI · Pages 기준선 — 조직 셀프호스트 러너 전환

#637 W1 1차 묶음(4단계). 조립 커널(bricks fd4edb1e 안의 커널 스냅샷 be421e0b)이 만든 워크플로는 호스티드 ubuntu-latest 러너 기준이다. 사용자 결정(2026-10-12 — CI 셀프호스트 · 호스티드 과금 0)에 따라 POC 선례와 v2 커널의 셀프호스트 전환을 이 저장소에 옮겼다. 잡 이름은 바꾸지 않았다(증거 대장 tool/ci/evidence_jobs.json).

1. 옮긴 파일과 원본

파일 원본 · SHA 이 저장소 blob 비고
.github/actions/pub-cache-isolate/action.yml cocode development 의 같은 경로 = POC demo-exchange-remittance cb81d4c9 0bb8c79a 바이트 동일(원본 blob 0bb8c79a)
.github/actions/selfhost-prep/action.yml demo-exchange-remittance cb81d4c9 91cf9490 바이트 동일 — Python ≥ 3.10(러너 python3, actions/setup-python 안 씀) · tool 캐시 Flutter · $HOME/actions/_cache637/pub → 러너별 격리
.github/actions/selfhost-cleanup/action.yml kernel cbede6b2(blob 30a28018) 1dff126d checkout-path 입력 제거 + 경로 검사: $GITHUB_WORKSPACE 실제 경로가 $RUNNER_WORKSPACE 아래가 아니면(심볼릭 링크 탈출) 지우지 않고 실패. 공유 캐시(_tool/* · _cache637/*) · 다른 잡 · 다른 워크트리는 건드리지 않는다
.github/actionlint.yaml demo-exchange-remittance cb81d4c9 87b8eae4 사용자 라벨 flutter · docker
tool/ci/free_ports.py kernel cbede6b2(= POC 코드 동일, 머리 주석만 일반화) 2fb9cec6 20000–24999 · 0.0.0.0 / 127.0.0.1 / :: 시험 bind
tool/ci/evidence_jobs.json 조립 커널 그대로 — 잡 이름 = 커널 v2 표준(검증 (tests-1) · 골든 (compare) · 검증 (tests-server) · 공개 스모크 …). patrol 게이트는 잡 없음(아래 §3)
tool/golden/compare.sh · update.sh · tool/pages/surfaces/golden.sh · package/test_driver/lib/golden.dart · tool/gates/tests/test_skip_exit_code.py demo-exchange-remittance 75ff2f1 의 같은 hunk — 골든 기준 렌더러 = Darwin/arm64(셀프호스트 macOS) — 다른 플랫폼은 77(검증 못 함)
tool/pages/smoke/smoke.mjs demo-ecommerce-grocery 1731396(#21) = demo-healthcare-vet #19 방식 — 전역 net::ERR_ABORTED 버림 제거 · 고정 대기 대신 요청 완료(settle) 뒤 새로고침 · 닫기 · 200 응답 content-type 확인

2. 워크플로 변경(잡 이름 불변)

워크플로 변경
ci.yml 모든 잡 runs-on: [self-hosted, macOS, ARM64, flutter] · subosito/flutter-action 직접 호출 → selfhost-prep · 잡 끝 selfhost-cleanup(if: always()) · verify max-parallel: 3 · 시간 예산 +10분(cold 러너) · 서버 테스트의 내장 Postgres 포트 = free_ports.py(SERVERPOD_DATABASE_PORT) · Android 잡: sudo 디스크 정리 → SDK · 디스크 확인, Gradle 데몬 끔, Actions gradle 캐시 안 씀 · 생성물 드리프트 실패 시 diff 출력
golden.yml demo-exchange-remittance cb81d4c9 판 — 셀프호스트 · [update-goldens](main 밖 브랜치) · dispatch update_goldens. 의존성은 --enforce-lockfile 유지
pages.yml 셀프호스트 · 6표면 산출물 확인(/ app console widgetbook golden docs) · upload-pages-artifact(GNU tar 필요) → bsdtar artifact.tar + upload-artifact(이름 github-pages) · deploy contents: read · 공개 스모크는 deploy 성공일 때만 · playwright install chromium(macOS 는 --with-deps 없음)

3. 이번 묶음에 없는 잡(자리표시 잡을 만들지 않는다)

잡 이유 도입
FR 대조 (fr) W4 FR 대조 도입에서 — 아래 §11 —
Patrol (chrome) W4-07 에서 도입 — 아래 §9 —
백엔드 통합 (server · PostgreSQL) W4-09 에서 도입 — 아래 §8 —
언어 전환 (locale) 업무 화면이 아직 생성 골격 — locale 게이트는 커널 표준대로 공개 스모크(iframe ko → en → ja → ar → ko · ?lang=ar&theme=dark)가 본다 W4-10

4. 골든 첫 기준(셀프호스트 macOS)

[update-goldens] 커밋(db53ca2)의 push 에서 골든 (update) 1회 — run 38244480815, 러너 cocodeui-macstudio-baryonyx(PC-C · M4 Max), 봇 커밋 6688853. 분류표: golden-first-baseline-2026-10.csv.

패키지 장 분류
feature/alert_preference/app 24 첫 기준
feature/class_booking/app 48 첫 기준
feature/class_session/app 48 첫 기준
feature/instructor/app 48 첫 기준
feature/membership_pass/app 96 첫 기준
feature/studio_alert/app 24 첫 기준
feature/app_router/app 24 렌더 환경 이전 — 커널이 가져온 Linux 기준 24장을 같은 크기로 다시 그렸다(추가 · 삭제 0)
합계 312 첫 기준 288 · 렌더 환경 이전 24 · overflow 0 · 예외 0(update 로그 tests passed 312)

5. W4-02 골든 갱신(직접 작성 업무 화면)

[update-goldens] 커밋 3da5715 의 push 에서 골든 (update) 1회 — run 38254006258, 러너 cocode-m2-ultra-compsognathus, 봇 커밋 372dbf6. 분류표: golden-w4-02-2026-10.csv.

패키지 장 분류
feature/class_session/app/widgetbook 48 새 기준 — A-01 · A-02
feature/class_booking/app/widgetbook 48 새 기준 — A-03 · A-04
feature/membership_pass/app/widgetbook 96 새 기준 — A-05~A-08
feature/class_session/console/widgetbook 48 새 기준 — C-01 · C-02
feature/membership_pass/console/widgetbook 24 새 기준 — C-03
feature/class_booking/console/widgetbook 48 새 기준 — C-04 · C-05
feature/{class_session,class_booking,membership_pass}/app(이전 기준) −192 삭제 — 생성 골격 화면 8개를 직접 작성 화면으로 대체
합계 +312 / −192 다른 suite(app_router · instructor · studio_alert · alert_preference) 기준 변경 0 · overflow 0 · 예외 0

6. W4-03 골든 갱신(앱 셸)

[update-goldens] 커밋(W4-03 셸)의 push 에서 골든 (update) 1회 — run 38260759922, 러너 cocodeui-macstudio-baryonyx, 봇 커밋 518b3e8. 분류표: golden-w4-03-2026-10.csv.

패키지 · 시나리오 장 분류
feature/app_router/app app_shell — demo_entry · shell_timetable · server_missing +36 새 기준 — FR-001 AC1 · FR-020 배너 · FR-021 AC1
class_session class_timetable 16 변경 고른 요일 글자가 배경과 같은 색이던 결함 수정 · 앱 아이콘 묶음(데스크톱 7열 그리드 8장은 변경 0 — 요일 탭이 없다)
class_session class_session_detail 24 변경 앱 아이콘 묶음 — coui 묶음 밖 Lucide(armchair · flower · users)가 이제 그려진다
console_class_session class_plan_timetable 24 변경 요일 탭 수정 · 앱 아이콘 묶음
membership_pass pass_membership 24 변경 앱 아이콘 묶음(혜택 gift)
합계 +36 · 88 변경 다른 시나리오 변경 0 · overflow 0 · 예외 0

7. W4-04 골든 갱신(세계 통합 · C-06)

[update-goldens] 커밋 3649da2 의 push 에서 골든 (update) 1회 — run 38273149293, 러너 cocodeui-macstudio-diplodocus, 봇 커밋 b38a309(120장 = 분류표와 같다). 분류표: golden-w4-04-2026-10.csv (로컬 Darwin/arm64 capture 로 미리 확인 — overflow 0 · 예외 0, 기준 이미지는 CI 셀프호스트 러너가 만든다).

패키지 · 시나리오 장 분류
feature/instructor/app instructor_gallery · instructor_profile 48 변경 생성 골든 시험을 이관 — co_faker 목데이터 → PRD §10 시드 세계(강사 6명 · 이름 B 투영), 전문 분야 칩(FR-011 AC1) · 「이번 주 수업」 지표 · 기능 번역
feature/studio_alert/app studio_alert_inbox 24 변경 시드 세계 알림 8건 · 분류 칩 · 오늘/이번 주/이전(데모 기준시각) · 번역 템플릿 문장(FR-012)
feature/alert_preference/app studio_alert_settings 24 변경 시드 설정 · 토글 라벨 번역 · 발송 없음 안내
feature/class_booking/console/widgetbook booking_rule_settings +24 새 기준 — C-06 예약 규칙(FR-018)
합계 +24 · 96 변경 다른 suite 변경 0 · overflow 0 · 예외 0

8. W4-09 백엔드 통합 잡(docker Postgres)

백엔드 통합 (server · PostgreSQL) — 증거 대장 backend 게이트(runtime_mode: server)를 이 잡에 묶었다 (tool/ci/evidence_jobs.json · CLAUDE.md 표, 검증 (tests-server) 는 related). 출처: POC demo-ecommerce-grocery 의 backend 잡.

단계 내용
러너 [self-hosted, macOS, ARM64, flutter, docker] — macOS 러너는 services: 를 못 쓴다
PostgreSQL 잡 안 docker run postgres:16 — 컨테이너 이름 fitness-pg-<run_id>-<attempt>(이 잡만), 호스트 포트는 docker 가 고른 빈 포트(-p 127.0.0.1::5432), 준비 확인은 컨테이너 안 pg_isready -h 127.0.0.1(TCP — 초기화용 임시 소켓 서버에 속지 않게)
포트 시험 API 서버 20칸 · 내장 Postgres(신원 resolver · 부팅 시험) 모두 tool/ci/free_ports.py
시험 package/fitness_rules(계약 표 · 규칙 47) → test/integration/fitness(생성 SDK 통합 — 파일마다 격리 DB fitness_it_<지문>_<pid>_<slot> 생성 · 삭제) → 계약 서버(test/contract/fitness_contract_server.dart, 같은 Postgres 의 격리 DB · 제어 포트 /reseed /stop) + package/fitness_binding/contract_test(localOnly 저장소 = 생성 SDK 저장소, W4-09b)
정리 if: always() — 계약 서버는 제어 포트 /stop 뒤 이 잡이 띄운 PID 만 · docker rm -f 그 컨테이너 이름만 · selfhost-cleanup

검증 (tests-server) 는 같은 hostTests 를 내장 Postgres 로 돈다(빈 포트 — API 서버 블록도 FITNESS_IT_API_PORT).

9. W4-07 실행 앱 Patrol 잡(Patrol (chrome))

증거 대장 patrol 게이트(device chrome)를 이 잡에 묶었다(tool/ci/evidence_jobs.json · CLAUDE.md 표). 출처: POC demo-exchange-remittance(#657)의 patrol 잡 · kernel cbede6b2(kernel#40) 표준 잡 · tool/ci/check_patrol_count.py(바이트 동일).

항목 내용
시나리오 PRD §20 .feature 7편 — app/app/test/src/bdd(fitness_demo_tour · class_booking · cancel_penalty · waitlist_promotion · pass_and_attendance · screen_states, 31) · app/console/test/src/bdd(studio_console, 11). co_bdd defaultTarget: both 로 같은 .feature 에서 *.widget_test.dart(검증 (bdd)) · *.patrol_test.dart(이 잡)를 만든다
조립 step 의 openFitnessApp · openFitnessConsole — 부트스트랩과 같은 순서(커널 → 데모 세계 · 세션 · 포트 → 기능 모듈 → 언어 · 테마 → 라우터)로 실제 셸 · 라우터를 띄운다. 콘솔 처리(취소 대행 · 출석 마감 · 규칙 · 홀딩)는 같은 세계를 매니저 계정으로(앱 ↔ 콘솔 연동 FR-019)
실행 patrol CLI 4.8.0 · Playwright 1.56.0 Chromium · --web-headless --web-locale ko-KR · 생성 시험의 setUpAll(() => HarnessFonts.settle(...))(co_bdd #104)
판정 check_patrol_count.py — .feature 시나리오 수 = Playwright json 통과 수 · 실패 · 흔들림 · 건너뜀 0(0 tests 를 통과로 세지 않는다). 음성 확인: 고치기 전 실행이 24/31 로 ❌ … unexpected 7 exit 1
실측(2026-10-13 · PC-B M2 Ultra 로컬 · 빌드 포함) 앱 31 = 8.0분 · 콘솔 11 = 4.6분 → 잡 예산 40분(× 2 + cold 러너 10분)

Patrol 에서 드러나 고친 것(위젯 시험은 통과하던 것): ① 공유 step I tap … 의 정착(실제 시계 pump(5초))이 결과 토스트(5초 뒤 닫힘)를 지나친다 → 업무 동작은 I tap … and wait for the result(짧은 정착) 뒤 the toast … should be shown ② Patrol 의 scrollTo 는 첫 Scrollable 을 고르는데 라우트 아래 깔린 화면의 것이면 누를 수 없어 멈춘다 → ensureVisible(가장 가까운 Scrollable 들) 로 보이게 한 뒤 누른다.

10. W4-08 골든 확장 · 스케일 불변(testScaleInvariant)

[update-goldens] 커밋 9756fd1 의 push 에서 골든 (update) 1회 — run 38314928425, 러너 cocodeui-macstudio-diplodocus, 봇 커밋 8b97b24(280장 = 분류표와 같다 — 경로 목록 diff 0). 분류표: golden-w4-08-2026-10.csv(로컬 Darwin/arm64 capture 로 미리 확인 — overflow 0 · 예외 0, 기준 이미지는 CI 셀프호스트 러너가 만든다).

패키지 · 시나리오 장 분류
class_session_locale class_timetable · class_session_detail +72 새 기준 — 폰 · 태블릿 가로(1280 × 800) · 데스크톱 주간 그리드 × 라이트/다크 × ko · en · zh-Hans · ja · ar(RTL) · de(긴 문구)
membership_pass_locale pass_membership +36 새 기준 — A-05 reward_card
console_class_booking_locale class_roster_checklist +36 새 기준 — C-04(태블릿 가로 기준선)
class_booking_board · class_booking_create · class_roster_checklist · studio_booking_board · class_session_detail(16) · pass_usage_timeline 136 변경 의도한 변경 — C-12 일시 문구(1월목15j30 → 1월 15일 (목) 19:30)
합계 +144 · 136 변경 다른 시나리오 변경 0 — PageTitleBar(C-17) · 다국어 폴백 글꼴 적재(C-18) 는 기존 ko · en 골든에서 픽셀 동일

언어 골든을 만들며 의도하지 않은 차이 3건을 원인부터 고쳤다: ① 아랍어 · 일본어 · 중국어 글자 빈칸(골든 하네스 폴백 — C-18) ② 아랍어 줄의 마스킹 연락처가 3206-****-010 으로 뒤집힘(ConsoleClassBookingText.phone — LRI … PDI, 회원 · 수강권 표는 textDirection: ltr) ③ 일시 문구 깨짐(C-12 확장).

testScaleInvariant(NFR-006 · AC-14 · R-1 — scaling 1.25 × textScaler 1.0 · 1.15 · 1.3 · 2.0): A-01(폰 세로 · 가로 · 데스크톱 주간 그리드) · A-02(폰 세로 · 가로) · A-05(폰 세로 · 가로) · C-04(태블릿 가로 · 폰 세로) = 36 조합 + 「행 높이가 글자 배율을 따른다」 1. 처음 실행에서 잡은 결함: coui AppBar 고정 높이(C-17 → PageTitleBar), 상태 뷰의 로딩 Skeleton · 오류가 고정 Column 이라 짧은 가로 화면에서 117px 넘침(→ ListView, 3개 기능).

11. FR 대조 잡(FR 대조 (fr))

증거 대장 fr 게이트를 이 잡에 묶었다(tool/ci/evidence_jobs.json · CLAUDE.md 표 · check_evidence_jobs.py 가 스냅샷 · 매핑 · 등록을 함께 강제). 출처: kernel cbede6b2 표준 잡 · check_fr_coverage.py(C-19 한 곳만 고침) · 시험 2파일 · POC #657 선례.

항목 내용
스냅샷 tool/fr/prd_snapshot.json — PRD coco-de/cocode#662 §7(2026-10-13 읽음) FR 22 · AC 44, sha256 fca2b2acfc34…(--extract, 손 편집 금지)
대조표 tool/fr/coverage.json — AC 44 → 테스트 79(BDD 시나리오 W4-07 · 페이지 AC 위젯 시험 W4-06 · 규칙/세계 단위 시험 W4-04/05). AC 마다 1~3개, 실제 그 AC 를 단언하는 시험만
판정 정적(check_all.sh — 누락 · 없는 이름 · skip · 빈 본문 · TODO) + 실행(--run — 패키지 14개에서 묶인 파일만 돌려 시험마다 통과 확인)
실측(2026-10-13 · 로컬) 정적 수 초 · --run 1.6분 — FR 22/22 · AC 44/44 · 테스트 79 통과, 누락 0

12. W4-10 골든 갱신 — PRD 인물 이름(고정 레코드)

[update-goldens] 커밋(f5a49a9)의 push 에서 골든 (update) 1회 — run 38325782393, 러너 cocodeui-macstudio-ornithomimus, 봇 커밋 6a0313c(252장 = 분류표와 같다). 분류표: golden-w4-10-2026-10.csv (장마다 바뀐 픽셀 비율 — 최대 6.8%, 비 ko 에서 이름 길이가 바뀌어 행이 다시 감긴 것).

패키지 · 시나리오 장 분류
class_booking board · console booking board · roster(+ locale) · member_pass_table 132 회원 이름 — PRD 인물 고정 레코드(윤하린 · 정우진 · 한채운 · 문가람), 비 ko 는 ko 원문(D-01)
class_session timetable(+ locale) · app_shell · console plan · instructor gallery 120 강사 이름 — 배소율(IN-04, 이전 pin 이름 안지우 등), 비 ko 는 ko 원문

13. W4-11 골든 갱신 — 브랜드(F-9)

W4-10 머지 뒤 main 을 받은 [update-goldens] 머지 커밋(11a4739)의 push 에서 골든 (update) 1회 — run 38329611890, 러너 cocodeui-macstudio-baryonyx, 봇 커밋 c78e64b(636장 = 분류표와 같다 · 크기 변화 0 · 추가/삭제 0 · overflow 0). 분류표: golden-w4-11-2026-10.csv — 모두 「의도한 변경 — 브랜드 팔레트(플럼 318° · highContrast 매핑) · 버튼 48dp 알약 · 카드 평면 radius16 1px」, 장마다 바뀐 픽셀 비율(최대 0.7532).