CLAUDE.md
이 워크스페이스에서 일할 때의 규칙. 구성과 빠른 시작은 README.md.
이 워크스페이스는 cob 커널에서 만들어졌다. 기능 SDK는 backend/<project_name>_client/lib/src/module/<기능>/protocol에 직접 생성한다.
기능별 client 패키지를 다시 만들지 않는다. 생성 명령은 tool/serverpod/cli.sh를 사용하며
unified: 경로 표지를 보존한다(생성기 유지보수).
기능은 feature(모듈)로 더하고, 모듈은 slots.yaml 의 자리에만
꽂는다. 커널 저장소(coco-de/kernel) 자체를 고치는 중이라면 KERNEL.md 를 먼저 읽을 것 — 커널에만 있는
규칙(포장 · 도너 흔적 · compose 계약 시험)이 거기 있고, 생성 프로젝트에는 그 파일이 없다.
반드시 지킬 것
1. 정체성은 지정 파일에만 (Identity-Free)
앱 이름 · 번들 ID · 조직 값은 identity.yaml 의 files 밖에 쓰지 않는다. 필요하면 참조한다:
| 자리 | 참조 |
|---|---|
| Dart (앱) | AppIdentity (shared/env_config) |
| Dart (서버) | ServerIdentity (backend/demo_exchange_remittance_server/lib/src/server_identity.dart) |
| iOS · macOS | $(APP_DISPLAY_NAME) · $(APP_BUNDLE_ID) (AppInfo.xcconfig) |
| Android | identity.properties → applicationId · ${appName} |
project_name(서버 · 클라이언트 패키지 이름)과 app_link_domain(유니버설 · 앱 링크)도 정체성 값이다.
project_name 만은 import · 경로 · serverpod 생성물에 두루 들어가 지정 파일 제한이 없다(포장이 모든 파일에서
치환한다) — 대신 중립 이름 backend_* 와 카멜 표기를 게이트가 막는다.
Android namespace 와 Kotlin 패키지는 정체성과 무관한 고정값 app.shell 이다. 테스트 타깃 번들 ID 도
app.shell.RunnerTests 로 고정한다. 새 플랫폼 파일에 정체성이 꼭 들어가야 하면 identity.yaml 의
files 에 올린다.
2. 마커는 계약이다
slots.yaml 의 마커 문구는 cob 레지스트라가 문자열 그대로 찾는다. 문구를 바꾸거나 지우면 compose 가
멈춘다. 새 슬롯은 slots.yaml 에 선언하고 파일에 한 번만 둔다(check_slots.py).
- 라우트:
app_routes.dart의 목록 — cobRouteRegistrar가<Name>RouteName.base,를 꽂는다. - DI:
register_app_dependencies.dart— cobDiRegistrar가register<Name>Module();과 import 를 꽂는다. 이 파일에 import 가 하나도 없으면 compose 가 파일 맨 앞에 import 를 넣으므로library지시문을 두지 말 것. - 모듈 계약: README 「모듈 계약」 표가 정본이다. compose 가 만든 feature 는 그 심볼 · 경로를 가정하므로, core · dependencies 의 재수출을 줄이면 feature 가 깨진다.
3. 생성물은 커밋하고, 손대지 않는다
| 생성물 | 다시 만들기 |
|---|---|
shared/i10n/lib/src/translations/*.g.dart |
cd shared/i10n && dart run slang |
feature/<domain>/{app,console}/lib/src/i18n/*.g.dart |
tool/feature_modules flutter-codegen (기능 소유 slang) |
backend/demo_exchange_remittance_server/lib/src/generated/** · backend/demo_exchange_remittance_client/lib/src/protocol/** · test/integration/test_tools/ |
tool/serverpod/cli.sh generate |
**/*.g.dart(go_router_builder) · test/src/bdd/*.widget_test.dart(co_bdd) |
tool/bdd/generate.sh |
골든 기준 이미지 test/golden/goldens/** |
CI(조직 셀프호스트 macOS 러너) — 커밋 메시지 [update-goldens] 로 push |
커밋하지 않는 생성물: envied 의 shared/env_config/lib/src/env/*.g.dart(난독화 값) — tool/dev/write_env.sh.
CI 가 생성기를 다시 돌려 작업 트리가 그대로인지 본다. 생성물에 dart format 을 돌리지 말 것 — 생성기
출력과 달라져 CI 가 빨개진다. 포맷은 생성물을 뺀 파일에만 한다(CI 의 포맷 단계 참고). co_bdd 생성물
(*.widget_test.dart · *.patrol_test.dart)은 co-package a66629f(#101)부터 생성기가 format 된 바이트로 내므로
CI 포맷 검사에 포함된다 — 맞지 않으면 손으로 고치지 말고 tool/bdd/generate.sh 로 다시 만든다.
번역 접근자는 JSON 키 그대로 snake_case 다(key_case: snake). 기존 모듈 코드가 그 표기를 쓰므로 바꾸지
않는다. 기본 로케일 밖은 지연 로딩이라 테스트에서는 await locale.build() 로 읽는다(위젯 테스트의 가짜 시계
안에서는 끝나지 않으니 setUpAll(LocaleSettings.instance.loadAllLocales) 뒤 getTranslations).
번역은 11개 로케일 전부(ko en zh-Hans ja de fr es pt it ru ar — 데모 표준 S-18). 키를 더하면 모든 로케일에 더하고
python3 tool/i18n/check_parity.py --strict 로 확인한다(게이트). 새 글자(한자 · 아랍 문자 등)가 들면
tool/gates/check_locale_fallback_font.py 가 알려 준다 — tool/fonts/build_locale_fallback.py 로 글꼴을 다시 만든다.
4. 화면 · 파일 · 라우트 규약 (게이트가 막는다)
- 한 파일 = 공개 타입 하나, 파일 이름 = 타입 이름 snake_case —
check_one_class_per_file.py. 유즈케이스 여러 개를 한 파일에 두지 않는다. 예외(생성물 · part · 테스트 · private 보조 타입 · sealed 가족 · 사유 주석)는 그 게이트 머리 주석이 정본이다. - StatefulWidget 금지 — 화면 · 위젯은
HookWidget+ signals_hooks(useSignal·useComputed·useFutureSignal)로. 불가피하면tool/gates/stateful_widget_allowlist.txt에 사유와 함께 —check_no_stateful_widget.py. - 라우트는
@TypedGoRoute— 문자열 경로로context.go('/x')하지 말고const XRoute().go(context). 모듈 라우트는<Name>RouteName.base로AppRoutes.routes마커에 꽂힌다(계약 유지). 웹은 경로 URL 이라 같은 경로가 유니버설 링크 · 앱 링크로도 열린다(app_link_domain). - 새 feature 는 BDD 시나리오와 골든을 함께 —
test/src/bdd/*.feature(co_bdd) ·test/golden/(co_golden). 폴더 규약은 README 「feature 가 따를 규약」. - 사내 패키지를 먼저 찾는다 — 그리기 · 주석은 co-package
open_board, 뷰어는open_epub등. 직접 CustomPainter 로 다시 짜기 전에gh api repos/coco-de/co-package/contents/packages를 본다.
5. 비밀은 저장소 밖
앱 환경변수 shared/env_config/.env.<flavor> 는 커밋하지 않는다(.env.example 만) —
tool/dev/write_env.sh 가 만든다. 키 목록 · 우선순위는 shared/env_config/KEYS.md.
backend/demo_exchange_remittance_server/config/passwords.yaml 도 커밋하지 않는다. 로컬·CI 는 tool/dev/write_passwords.sh
로 만들고, 운영은 같은 키를 SERVERPOD_PASSWORD_<키> 환경변수로 넣는다. 서버가 부팅 때 읽는 키는 그
스크립트 주석에 있다.
명령
flutter pub get
tool/dev/write_env.sh # .env.<flavor> + envied 생성(처음 한 번 · 키를 바꾼 뒤)
dart analyze --fatal-infos
tool/gates/check_all.sh
tool/feature_modules check
tool/serverpod/cli.sh generate # 모듈 → 호스트 DAG
tool/feature_modules flutter-codegen # slang · 모든 workspace 생성기
# 테스트 — 루트 workspace 의 모든 패키지 (서버는 내장 Postgres — write_passwords.sh 먼저)
tool/dev/test_all.sh # SKIP_SERVER=1 이면 서버 제외
(cd app/app && flutter build web --no-wasm-dry-run --dart-define=FLAVOR=production)
bash tool/pages/build.sh # Pages 사이트 → build/pages/
(cd tool/pages/smoke && npm ci && node smoke.mjs --base https://<Pages 주소>/<저장소>/ --local-root ../../../build/pages)
python3 tool/i18n/check_parity.py --strict # 11개 로케일 번역 패리티
tool/bdd/generate.sh # .feature · @TypedGoRoute 생성물
tool/golden/capture.sh && tool/golden/gallery.sh # 골든 캡처 → build/golden-gallery/index.html
python3 tool/serverpod/profile.py show # serverpod 버전 · 프로필
알아 둘 것
-
신규 feature 는 bundle —
.cob/feature-layout.json을 보존하고feature/<domain>/{app,console,server,widgetbook}에 둔다.bundle.json은 조립 선언이고, 이름 예외·호스트 포트·식별자/legacy 계약은host-integration.json이 소유한다. 번역은 기능의lib/src/i18n/에 두고featureTranslations로 셸 로케일에 연결한다(README 계약 절). -
계층 래칫은 올리지 않는다 —
dependency_layers.json은 미분류 패키지·런타임 역방향·순환을 막는다.check_package_layers.py --update-baseline은 감소만 허용한다. Widgetbook 은 기능 소유 전시 패키지 +app/app_widgetbooksink 로 분리하고 운영 역할이 전시 코드를 의존하지 않는다. -
검증 스크립트의 종료 코드 77 은 「검증 못 함」이다.
tool/golden/compare.sh는 Darwin/arm64(셀프호스트 macOS 러너 렌더러)가 아니면(GOLDEN_LOCAL=1이 아니면),tool/bdd/generate.sh --check는 git 작업 트리가 아니면 비교하지 않고 77 로 끝내며 마지막 줄에 사유를 남긴다.cob verify는 이것을 통과가 아니라⏭ … — skip(사유)로 보고한다. 스크립트를 이어 부를 때 77 을 통과로 삼키지 말 것(0 · 77 밖의 코드는 실패). -
Flutter 3.47 은
pub get때 Flutter 패키지의analysis_options.yaml에build/**(앱은 플랫폼 디렉토리까지) 제외를 스스로 넣는다. 커밋본에 이미 들어 있어야 매번 바뀌지 않는다 — 새 Flutter 패키지를 만들면 기존 패키지의 형태를 따를 것. -
간결 생성자 문법(Dart 3.13)을 쓰지 않는다.
unnecessary_type_name_in_constructor·empty_container_bodies를 루트analysis_options.yaml에서 껐다. 모듈과 코드젠(serverpod_cli · build_runner)이 고전 문법에 머물러 있어서다. 생태계가 옮겨 가면 함께 켠다. -
서버의
Serverpod는 생성된 클래스다.lib/src/generated/serverpod.dart가package:serverpod/serverpod.dart를Serverpod만 숨겨 다시 내보낸다.server.dart에서package:serverpod/serverpod.dart를 함께 import 하면 이름이 겹친다. -
coui 는 비공개 저장소 태그(coui_flutter-v0.159.2
1b3838db· coui_core-v0.158.1e48a3568— baseline v2 최종)로 고정한다 — 루트dependency_overrides. 두 패키지는 반드시 함께 올린다(짝 태그 규칙은 루트 pubspec 주석).tool/gates/check_coui_pin.py가 원격 최신 태그와 비교해 5개 이상 뒤처지면 경고한다(CI 는 경고만,--strict면 실패). coui 0.148 부터 file_picker 12 를 직접 써서 예전의 file_picker · win32 · device_info_plus 덮어쓰기는 지웠다 — 다시 넣지 말 것. coui 를 올리면 웹 빌드뿐 아니라 CI 의 Android 빌드 잡까지 초록인지 볼 것(네이티브 층 깨짐은 웹·테스트로 드러나지 않는다). -
Android 는 Gradle 8.14 · AGP 8.12 에 머문다(
android/settings.gradle.kts). coui 0.131 이 끌던 irondash_engine_context(cargokit) 가 Gradle 9 에서 없어진project.exec를 불러 APK 빌드가 깨졌다(coui 0.151 에서는 그 의존이 빠졌다 — Gradle 9 로 올릴 때 Android 빌드 잡으로 확인할 것). 웹 빌드와 테스트는 네이티브 층을 컴파일하지 않아 이런 깨짐을 못 잡는다 — CI 의 Android 빌드 잡이 그 자리를 지킨다. -
core 를 import 한 파일에는 material 을 함께 import 하지 않는다. coui 가
Scaffold·Theme·ThemeData·Colors를 따로 정의해 겹친다. 커널 화면도 coui 로 쓴다(테스트는buildFeatureTestApp또는CoUIApp아래에서 — coui 위젯은 couiTheme이 없으면 어서션한다). -
한글 글꼴은 번들한다 — coui 본문 글꼴
Pretendard(OFL)를 KS X 1001 2350자 서브셋(굵기 4종 · 각 ~410KB)으로package/resources/lib/fonts/에 두고 앱 pubspec 이 가족 이름Pretendard로 선언한다. 웹 첫 로드에 CDN 글꼴을 기다리며 □ 가 보이거나 라벨이 잘리지 않는다. 목록 밖 글자는 엔진 폴백이 받는다. 브랜드 글꼴로 바꾸면 같은 자리를 바꾼다(골든 하네스도 이 파일을 읽는다). -
flutter build web에는 늘--no-wasm-dry-run— release 웹 빌드의 wasm 시험 컴파일이 호스티드 러너(2vCPU · 8GB)를 메모리로 죽인다(실측, CI · Pages 모두). -
시계는
AppClock.now()—DateTime.now()를 화면에서 직접 읽으면 골든이 날마다 바뀐다. 골든 하네스가goldenNow로 고정한다. 나이 계산처럼 기준 시각이 필요한 곳도 이것을 쓴다. 렌더 결함을 당장 못 고치면kernelGoldenMatrix(knownDefect: '사유')로 표시하고 비교는 계속한다. -
서버 없는 데모(localOnly) —
COB_RUNTIME_MODE=localOnly면 부트스트랩이 원격 연결 대신DemoWorld(core)를 등록하고, 모듈은register_demo_world.dart의AUTO-REGISTER(demo-seed)자리에 시드를 꽂는다. 모듈의 localOnly 저장소는DemoWorld를 읽고 쓴다. 변경 신호는 실제 쓰기에만(읽기에서 신호를 내면 구독자가 다시 읽어 브라우저가 멈춘다), 시드 이력은isSeed항목에만. 데모 전용 앱은--dart-define=COB_DEMO_ONLY=true로 빌드해 localOnly 가 아니면 "서버 없음" 으로 끝낸다(조용한 폴백 금지). -
언어 · 테마는 셸 상태 하나 —
AppPresentation(core) — 앱 · 콘솔 · 위젯북 셸이runApp전에 URL (?lang=·?theme=)을 첫 값으로 싣고, localOnly 는 데모 포털 미리보기 iframe 의sync를DemoEmbedSync(allowLocalhost: kDebugMode)로 받는다. 언어 전환은DemoLocaleSwitcher(마지막 요청 우선)의 확정 한 단계에서 slang ·DisplayProjector·<html lang dir>이 함께 바뀐다. 받은 값은 저장하지 않는다. 화면에서LocaleSettings.setLocale을 직접 부르지 말 것 —sl<AppPresentation>().requestLocale(...). -
웹 첫 프레임 전 배경(pre-boot) —
app/*/web/index.html의 블록은 생성물이다(원천tool/web/pre_boot.js+AppTheme.scaffoldBackgroundOf). 손으로 고치지 말고app/app에서UPDATE_PRE_BOOT=1 flutter test test/web/pre_boot_test.dart. 판정 규칙은tool/web/pre_boot_cases.json을 Dart · JS 테스트가 함께 본다. -
다국어 폴백 글꼴 — 웹 호스트가
LocaleFallback-*.ttf를Roboto가족으로 선언한다(엔진의 전역 폴백 자리). 이름을 바꾸면 엔진이 아랍 · 한중일 글꼴을 fonts.gstatic.com 에서 받는다(공개 스모크가 잡는다). -
Pages 사이트 —
tool/pages/build.sh가build/pages/(랜딩 +/app/+tool/pages/surfaces/*.sh산출물, 커널은/console/·/widgetbook/·/golden/·/docs/— 6표면)를 만들고pages.yml이 main 에서 배포한다. Pages 는 SPA 폴백이 없어 데모 빌드는WEB_URL_STRATEGY=hash, 실서비스는 경로 URL(기본). 새 산출물은 surface 스크립트 하나 +catalog.tsv한 줄. -
serverpod 버전은
tool/serverpod/serverpod.yaml한 곳에서 정한다(현재 stable 4.0.3). pubspec 을 손으로 고치지 말고python3 tool/serverpod/profile.py apply stable --version <x> --run—check_serverpod_version.py가 어긋남을 막고 최신보다 뒤처지면 경고한다. CLI 는tool/serverpod/cli.sh …(별도 pub 루트tool/serverpod/cli— serverpod_cli 의 analyzer <11 이 워크스페이스 코드젠을 묶지 않게), 전역 설치를 쓰지 않는다. 오프라인 동기화는apply offline-sync(베타 + co-serverpod 포크). 버전을 바꿀 때는 라이선스를 확인할 것 — 4.x 일부 발행본이 SSPL-1.0 이다. -
서버 · 클라이언트 이름은 identity.yaml
project_name에서 온다(backend/<project_name>_server). 그래서 이 두 패키지와 serverpod_service 는 import · pubspec 정렬 린트를 끈다(이름마다 알파벳 위치가 다르다). -
내장 Postgres 는 첫 실행 때 바이너리를 내려받아 사용자 캐시에 둔다. 데이터는
backend/demo_exchange_remittance_server/.serverpod/(커밋하지 않음).
CI
워크플로: ci.yml(게이트 · 생성물 · 분석 · 테스트 · 웹 · 백엔드 통합 · Android) · golden.yml(골든) ·
pages.yml(6표면 빌드 · 배포 · 공개 스모크). 무엇을 언제 도는지는 각 파일 머리 주석.
러너는 조직 셀프호스트 macOS 러너뿐이다(#637 S6 — 비용: 호스티드 Linux 분이 조직 Actions 청구의 대부분).
모든 잡이 runs-on: [self-hosted, macOS, ARM64, flutter](Docker 가 필요한 잡은 docker 추가) — ubuntu-latest
를 다시 쓰지 말 것. 러너(Default 그룹 · M2 Ultra 9 · M4 Max 8)는 coui · unibook · good-teacher · cocode 와 함께
쓰고 한 기계에서 여러 잡이 동시에 돈다. 그래서:
- 골든 기준은 조직 셀프호스트 macOS 러너로만 만든다 — 같은 러너 풀이 비교도 하므로 렌더러가 같다. 로컬
Mac 에서 만든 기준 이미지를 커밋하지 말 것(
[update-goldens]로 CI 가 만든다). - 잡은 checkout 뒤
.github/actions/selfhost-prep(Python ≥ 3.10 — 러너 PATH 는 macOS 내장 3.9 · tool 캐시의 Flutter · pub 캐시 — 베이스$HOME/actions/_cache637/pub에서pub-cache-isolate가 러너별pub-<러너>로 격리하고 hosted/ 만pub-shared로 함께 쓴다, 캐시 디렉터리는 지우지 않는다)로 준비하고, 끝에if: always()로.github/actions/selfhost-cleanup(이 잡의 작업 디렉터리 · 내장 Postgres 만)을 둔다. - 포트를 고정하지 않는다 —
services:는 macOS 러너에 없어 PostgreSQL 은 잡 안의docker run -p 127.0.0.1::5432(잡마다 고유 이름,if: always()로 제거), 시험 API 블록은REMIT_API_PORT_BASE, withServerpod 내장 Postgres 는SERVERPOD_DATABASE_PORT로tool/ci/free_ports.py가 고른 빈 포트를 쓴다. - 러너 설정 · 라벨 · 그룹 · 기계 전역 설치는 바꾸지 않는다(필요하면 조직 담당에게). 기계에 없는 도구는 잡 안에서
대신한다(예:
upload-pages-artifact의 gtar → bsdtar 로 같은github-pages아티팩트).
| 이벤트 | CI | Golden | Pages |
|---|---|---|---|
| PR | 변경 범위로 가른다(문서만이면 계약 게이트 만, Android 는 네이티브 · 의존성 변경 때만) |
골든 (compare) |
사이트 빌드(배포 전 스모크 포함) |
| main push | 전부(변경 범위 판정 없음 · Android 포함) | 골든 (compare) |
사이트 빌드 → 배포 (GitHub Pages) → 공개 스모크 |
workflow_dispatch evidence=true(기본) |
전부(false 면 Android 만 뺀다) | 골든 (compare) |
빌드 · 배포 · 공개 스모크(false 면 빌드만) |
[update-goldens] 커밋(main 밖 브랜치) · dispatch update_goldens=true(main 밖 브랜치) |
— | 골든 (update) — 기준 이미지를 다시 만들어 그 브랜치에 커밋 |
— |
main push · dispatch 의 run 은 서로 취소하지 않는다(PR 만 새 push 가 앞선 run 을 취소한다).
CI 증거 게이트 ↔ 잡 이름
데모 증거 대장(#637)은 게이트마다 (run, 잡 이름)을 적고, main HEAD 와 같은 SHA 의 성공한 run 안에서 그
이름의 잡 하나가 성공했는지만 본다(PR run · 다른 SHA 는 인정하지 않는다). 그래서 main push 에서 위 표대로 전부 돌고,
같은 SHA 를 다시 돌릴 때는 gh workflow run ci.yml --ref main -f evidence=true(golden.yml · pages.yml 도 같은 입력).
잡 이름은 고정이다 — 정본은 tool/ci/evidence_jobs.json, 이름 · matrix 레그를 바꾸면 이 표와 함께 바꾼다
(tool/gates/check_evidence_jobs.py 가 어긋남 · 중복 · 식이 남은 이름을 막는다).
| 게이트 | 워크플로 | 잡 이름(문자열 그대로) | 무엇 · 대장 조건 |
|---|---|---|---|
fr |
CI | FR 대조 (fr) |
PRD §7 FR/AC 고정 스냅샷(tool/fr/prd_snapshot.json — 본문 sha256) ↔ 대조표(tool/fr/coverage.json)의 테스트를 이 잡이 직접 돌려 묶인 테스트 하나하나의 통과를 같은 실행에서 확인(tool/gates/check_fr_coverage.py --run). 누락 · skip · 빈 본문 · TODO · 미실행 · 실패는 실패 |
unit |
CI | 검증 (tests-1) (+ 검증 (tests-2) · 검증 (tests-modules)) |
모든 패키지 테스트(패키지 라운드로빈 샤드) · 기능 서버 단위(TZ=UTC) — run 전체 성공이 다른 샤드를 보증 |
widget |
CI | 검증 (tests-1) (+ 검증 (tests-2)) |
같은 샤드의 위젯 테스트(실제 mount · 서버 모드 셸 · 데모 초기화) |
golden |
Golden | 골든 (compare) |
셀프호스트 macOS 러너 렌더러 기준 비교 — 대장은 mode=compare 만 인정(골든 (update) 는 증거가 아니다) |
widgetbook |
CI | 검증 (widgetbook) |
Widgetbook 패키지 테스트(TEST_SUITE=widgetbook) — 웹 산출물은 사이트 빌드 의 /widgetbook/ |
bdd |
CI | 검증 (bdd) |
co_bdd widget 시나리오(TEST_SUITE=bdd) — 생성물 최신은 검증 (generated) |
patrol |
CI | Patrol (chrome) |
실행 앱 여정 — co_bdd *.patrol_test.dart(PRD §20 10편 · 시나리오 29)를 patrol CLI 가 Chrome(Playwright)에서 돈다. device: chrome |
locale |
Pages | 언어 전환 (locale) |
같은 커밋 배포본의 업무 화면(A-03) iframe 실시간 전환 ko → en → ja → ar → ko · 빠른 연속 · 다크 — 다시 불러오지 않고 UI 문구 · 표시 데이터(B) · lang/dir 이 바뀌고 마지막 언어만 남는다 + ?lang=ar&theme=dark 첫 프레임(runtime localOnly) |
backend |
CI | 백엔드 통합 (server · PostgreSQL) (+ 검증 (tests-server)) |
생성 SDK → 호스트 dispatcher → 기능 모듈 → PostgreSQL(잡 안의 docker 컨테이너, runtime server) + 계약 동등성(localOnly ≡ 생성 SDK 저장소). 내장 Postgres 판은 tests-server |
surfaces |
Pages | 사이트 빌드 |
6표면(랜딩 · app · console · widgetbook · golden · docs) 빌드 · 산출물 확인 + 배포 전 스모크 · 자격 증명 검사 |
smoke |
Pages | 공개 스모크 |
같은 커밋(pages-commit) 배포본의 6표면 · 첫 프레임 전 상태 · iframe 전환 · 업무 화면 딥 링크(업무 네트워크 0 · runtime localOnly) |
그 밖의 고정 이름: 변경 범위 · 계약 게이트 · 번들 모듈 → 호스트 코드 생성 · 검증 (generated) ·
검증 (analyze) · 검증 (web) · Android 빌드 (debug) · 배포 (GitHub Pages).
커밋
한국어 Conventional Commits + gitmoji: <type>(<scope>): <gitmoji> <설명>.
예: feat(app): ✨ 부트스트랩 단계 마커 추가, fix(gates): 🐛 정체성 게이트가 바이너리를 읽던 문제.