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) |
- 생성 화면 골격의 첫 기준이다 — 업무 화면(W4-06) · 언어 골든(W4-08)이 들어오면 다시 갱신한다.
- 비교 증거는
골든 (compare)만 인정한다(update 는 증거가 아니다).
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 |
- 의도한 변경 근거: 생성 골격(하드코딩 한국어 · co_faker 목록)을 PRD 업무 화면(시드 세계 seed 436 · 투어 수치 — 리포머 10회권 잔여 4/10 · 스탬프 6/10, 10:00 매트 기초 잔여 2/8, 19:30 리포머 마감 · 대기 1)으로 바꿨다.
- 시나리오는 Widgetbook use-case 조립을 그대로 찍는다(실제 Page · Cubit · 포트 바인딩 — mock 없음).
- 첫 capture 에서 잡힌 의도하지 않은 차이 2건은 원인부터 고쳤다: 7열 주간 그리드의 배지 overflow(coui
Badge라벨 비유연 — 결함 후보 C-08,FittedBox(scaleDown)+ 좁은 칸 세로 배치) · 태블릿 2열IntrinsicHeight안의LayoutBuilder(명시compact플래그로 교체).
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 |
- 원인: coui
Icon은 자기 묶음(CoreBundledIcons) 밖 아이콘을 런타임에 Iconify API 에서 받는다 — 시험에선 빈 칸, 웹에선 바깥 요청(공개 스모크 위반).tool/icons/build_app_icons.py가 coui 고정 커밋의 vendor Lucide(ISC)에서 쓰는 아이콘만AppIcons로 만들고 셸 · 시험 하네스가 등록한다(check_all.sh게이트).
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 |
- 의도하지 않은 차이 1건은 capture 단계에서 원인부터 고쳤다: 알림 본문 일시가
1월171230으로 붙었다 —DemoFormat.date가MMMdHm조합 패턴을 내지 않아 날짜(MMMd) · 시각(Hm)을 따로 만들어 잇는다.
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).