이 저장소의 출처 — 생성 · 가져온 도구 · 우회
이 저장소는 Figma 「Cocode Scaffold App v1.0」 의 한 앱 페이지(49:5)를 Flutter 앱으로 만드는 샘플 앱이다(에픽 #1455 · 이 앱의 이슈 #1460).
coco-de/scaffold-booking(7f28d21)이 먼저 만든 방식을 그대로 따랐고, 세 앱(shop · class · clinic)이 같은 도구를 쓰도록 일반화했다.
생성
| 항목 | 값 |
|---|---|
| 명령 | cob generate --base kernel -s project.yaml(project.yaml 은 name · demo 뿐, 생성할 때만 scaffold_only: true) |
| 핀 | kernel cf069bd0ae52715f8604397b8c033d4c985a20b1 · cob 0.6.0 · bricks db4eae51 · --layout bundle |
| CoUI | coui_flutter-v0.176.0 / coui_core-v0.175.0 (생성 시점 최신 릴리스 태그, scaffold-booking 과 같다) |
| CoUI 핀(현재) | coui_flutter-v0.177.1 / coui_core-v0.175.1 — 골든 기준선을 만든 뒤 전용 PR 로 올렸다. 루트 dependency_overrides 의 태그 ref 두 줄과 pubspec.lock 의 coui 두 항목만 바뀌고, 커널 표준 장면 골든 120변형은 한 픽셀도 달라지지 않았다 |
| Serverpod | 4.1.0 |
| 첫 커밋 | 04ec85b — 생성 직후 트리에서 정체성 값(표시 이름 · 번들 ID)만 손질했다. 같은 핀으로 만든 scaffold-booking 최초 커밋(fc7c0b5)과 이름만 바꿔 견주면 pub get 이 만드는 파일 · 서식 둘을 빼고 바이트까지 같다 |
scaffold-booking 에서 가져온 것 (M0)
| 이 저장소 | 가져온 곳 | 바꾼 것 |
|---|---|---|
| #1 Serverpod import 별칭 재생성 | booking #7 (3445f76) |
해시는 패키지 이름에서 나오므로 이 앱 값으로 다시 만들었다 |
| #2 pub 미러 우회(dart-lang/pub#4912) | booking #4 (5fdf11a) |
없음 — git apply 그대로 |
| #3 브랜드 테마 | booking #8 (b8e710a) |
색 도구 일반화: 컬렉션 이름으로 찾기 · 가벼운 토큰 JSON · digest 검산 · 토큰 파일 이름 brand-colors.json · 확장 컬렉션 시험을 요약으로 |
| #4 Figma 대조 도구 | booking #5 (ad4900c) + 이후 일반 개선 #15 · freezeAnimations(7f28d21 최종본) |
화면 코드 SH→MK, 시험 suite shop, 파일럿 MK-S1, 문서의 측정 결과는 booking 문서로 돌림 |
| #5 화면 대장 + 원본 PNG | booking #9 (06965c8) |
대장 검사가 접두사를 첫 화면 코드에서 읽음 · 대장/색을 읽는 레시피 추가(tool/design/figma/export_*.figma.js, build_*.py) |
상류가 닫히면 지울 우회
| 우회 | 상류 이슈 | 지우는 조건 |
|---|---|---|
| Serverpod import 별칭 재생성 커밋(#1) | coco-de/co-bricks#917 | 생성이 서버 코드젠을 한 번 돌려 별칭을 맞추면 새 핀에서 필요 없다 |
pub_git_prefetch.py · selfhost-prep 의 git-token(#2) |
coco-de/kernel#57, dart-lang/pub#4912 | Dart 3.14(pub#4914 포함)를 싣는 Flutter stable 로 FLUTTER_VERSION 을 올린 뒤 |
이 저장소에서 새로 정한 것 · 알아 둘 것
- 골든 기준 이미지는 CI(셀프호스트 macOS · Darwin/arm64)가 만들었다 — 테마 PR(#3)의 봇 커밋
2993edf(PNG 120개). 로컬 capture 를 기준으로 옮기지 않는다. - main push 의 Pages 워크플로는
사이트 빌드까지 성공하고배포 (GitHub Pages)가 404 로 실패한다 — Pages 는 화면이 모두 끝난 뒤에 켠다(오너 지시). scaffold-booking 도 켜기 전까지 같았다. - Figma 의 앱 색 확장 컬렉션이 CoUI 라이브러리 변수 149개 중 49개만 덮는다 —
docs/design/figma/tokens/brand-colors.json의couiExtension.notOverriddenDiffering(디자이너 확인 목록 44). - 정체성 게이트(
tool/gates/check_identity.py)가 표시 이름을 지정 파일(identity.yaml의files) 밖에서 막는다 — 문서 · 주석 · 시험에는 앱 이름을 쓰지 않는다.