이 저장소의 출처 — 생성 · 가져온 도구 · 우회
이 저장소는 Figma 「Cocode Scaffold App v1.0」 의 한 앱 페이지(49:7)를 Flutter 앱으로 만드는 샘플 앱이다(에픽 #1455 · 이 앱의 이슈 #1461).
coco-de/scaffold-booking(7f28d21)이 먼저 만든 방식을 따랐고, coco-de/scaffold-shop 이 일반화한 도구를 가져와 썼다(세 앱이 같은 도구를 쓴다).
생성
| 항목 | 값 |
|---|---|
| 명령 | 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 → #3 에서 coui_flutter-v0.177.1 / coui_core-v0.175.1 로 올렸다 |
| Serverpod | 4.1.0 |
| 첫 커밋 | 1541106 — 생성 직후 트리에서 정체성 값(표시 이름 · 번들 ID)만 손질했다. 같은 핀으로 만든 scaffold-booking 최초 커밋(fc7c0b5)과 이름만 바꿔 견주면 pub get 이 만드는 파일 · 서식 둘을 빼고 바이트까지 같다 |
가져온 것 (M0)
| 이 저장소 | 가져온 곳 | 바꾼 것 |
|---|---|---|
| #1 Serverpod import 별칭 재생성 | scaffold-booking #7 (3445f76) |
해시는 패키지 이름에서 나오므로 이 앱 값으로 다시 만들었다(client _i79tpxt9 → _iped9c5f · server _icagjaaz → _i4jj5a45) |
| #2 pub 미러 우회(dart-lang/pub#4912) | scaffold-booking #4 (5fdf11a) |
없음 — git apply 그대로(scaffold-shop 이 적용한 diff 와 바이트 단위로 같다) |
| #3 CoUI 핀 올림 | (이 저장소에서 새로) | pubspec.yaml 두 줄 + pubspec.lock 의 coui 두 항목. cob 가 --coui-ref coui_flutter-v0.177.1 로 만드는 pubspec 과 같다 |
| #4 브랜드 테마 | scaffold-shop #3 (scaffold-booking #8 b8e710a 의 일반화) |
Figma Semantic/ Color · Violet 129변수 × 4모드, 시험의 「앱마다 바꾸는 값」 블록 |
| #5 Figma 대조 도구 | scaffold-shop #4 (scaffold-booking #5 ad4900c + 이후 일반 개선 7f28d21 최종본) |
화면 코드 CL, 시험 suite class, 파일럿 CL-S1 |
| #6 화면 대장 + 원본 PNG | scaffold-shop #5 (scaffold-booking #9 06965c8) |
페이지 49:7 · 78프레임 · 접두사 CL |
상류가 닫히면 지울 우회
| 우회 | 상류 이슈 | 지우는 조건 |
|---|---|---|
| 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(#4)의 봇 커밋
20a2624(PNG 120개:kernel_status12 ·console_navigation_*96 ·login_panel12; squash 로 main 에는 #4 의 변경으로 들어왔다). 로컬 capture 를 기준으로 옮기지 않는다. - main push 의 Pages 워크플로는
사이트 빌드까지 성공하고배포 (GitHub Pages)가 404 로 실패한다 — Pages 는 화면이 모두 끝난 뒤에 켠다(오너 지시). - Figma 의 앱 색 확장 컬렉션이 CoUI 라이브러리 변수 149개 중 49개만 덮는다 —
docs/design/figma/tokens/brand-colors.json의couiExtension.notOverriddenDiffering(19개). tool/golden/gallery의 별도 pub 루트(골든 갤러리 실행기)는 CoUI 핀을 올리지 않았다 —coui_core·coui_webv0.173.0 그대로이며 scaffold-booking 도 같다.- 정체성 게이트(
tool/gates/check_identity.py)가 표시 이름 · 조직 문자열을 지정 파일(identity.yaml의files) 밖에서 막는다 — 문서 · 주석 · 시험에는 앱 이름을 쓰지 않고 이슈는 번호만 적는다.