송금 데모 — 3단계(S3) 설계 · 레시피 확정 기록

상태 어휘(실행 계약 §2): 구현+검증 = 코드가 있고 AC 를 단언하는 테스트가 있다 · 구현만 = 코드는 있으나 AC 일부를 단언하는 테스트가 없다 · 부분 = AC/§8 규칙 일부가 코드에 없다 · 없음 = TODO · 빈 화면 · 단언 없는 테스트뿐. 파일 존재는 세지 않는다.


0. 요약

항목 결과
FR 24개 — 구현+검증 12 · 구현만 11 · 부분 1(FR-017 상태머신 2) · 없음 0 (main 기준). PR #2 를 채택하면 FR-017 → 구현+검증
작성 코드 TODO · UnimplementedError 0건(git grep — 생성물 제외)
화면 §6 19화면(앱 13 · 콘솔 6) 모두 Page 존재, v3 shape 0
cob plan --prd FR 24 · 결정론 covered 16 · review-pending(semantic) 8(FR-015~022) · orphan 0 · NFR 13(리포트)
cleanbase quick 다이제스트 7de381b869219d3d1ae14a35efd6819deedaf75ad340fc5b5b81376ad9eda7db · 1,527 파일 · 85.4 s — baseline v1 과 동일
5종(main) unit · widget · backend 실재. 기능 골든 0 · 기능 BDD .feature 0/10 · Widgetbook 6/19 화면 — 사이드카의 golden/bdd PASS 는 커널 표본(app_router)만 본 것
재사용 PR #2 채택 · salvage oyster 부분 채택(CI 선행) · salvage local-snapshot 폐기(보존) · story/bundle 완료
upgrade co-package d23a5c42 → c003ca2c(19 pubspec + lock) · coui 는 이미 v0.158.0/v0.157.0 = baseline

1. FR/AC 대조표 (main 872792eb)

경로 약어: F/ = feature/, A/ = app/, B/ = backend/demo_exchange_remittance_server/. 테스트 이름은 실제 test(...) 문자열.

FR 소유 번들 코드 테스트(단언) 상태 빈칸
FR-001 역할별 진입 셸(A/remit_world · A/app) A/remit_world/lib/src/presentation/remit_entry_page.dart · A/app/lib/src/remit/remit_server_missing_app.dart A/app/test/src/remit_app_shell_flow_test.dart 「역할 진입 — 송금인은 진행중 1 · 보류 1 …」 · register_kernel_dependencies_test.dart 「localOnly 가 아니면 데모 세계를 만들지 않는다」 구현만 AC2 「서버 없음」 화면을 mount 해 문구를 단언하는 테스트 없음 · AC1 3초 측정 없음
FR-002 홈 지표 remittance F/remittance/app/.../page/remittance_home_page.dart A/app/test/app_test.dart(진행중 1 · 보류 1 · 32%) · shell flow(빈 홈 「첫 송금 시작」) · local_remittance_repository_test should_summarize_home_tiles_from_seed 구현만 AC1 「보류 타일 → A-09 보류 탭」 이동 단언 없음(코드 remittance_home_page.dart:159)
FR-003 받는 사람 목록 recipient F/recipient/app/.../recipient_list_page.dart recipient_cubits_test should_list_own_recipients_latest_transfer_first · core flow(4명) 구현만 수령 방법 배지 · AC2 EmptyState(코드 recipient_list_page.dart:78) 위젯 단언 없음
FR-004 프로필 recipient recipient_profile_page.dart · RecipientTransferStatsPort should_load_profile_with_stats_when_owned · should_keep_last_four_digits_only(서버) · core flow(프로필 → 견적) 구현+검증 —
FR-005 등록 recipient recipient_create_page.dart · LocalRecipientRepository · RecipientService should_store_masked_name_and_last4_when_creating · should_reject_blank_account_without_writing · recipient_sdk_test 구현+검증 필드 오류 문구의 위젯 단언은 없음(저장소 거부로 단언)
FR-006 견적 분해 remittance_quote remittance_quote_page.dart · ExactRate · RemittanceQuotePolicy core flow(17,850,000동 · 1,003,000원) · remittance_quote_test(NFR-013 5건) · exact_rate_test 6건 구현만 AC2 「견적 만료」 배지 · 다음 비활성(remittance_quote_page.dart:113-127) 위젯 단언 없음(만료 판정은 엔티티 · wizard Cubit 에서 단언)
FR-007 신청 wizard remittance remittance_wizard_page.dart · LocalRemittanceRepository.create · RemittanceService.create core flow(NR-260115-0042 · 「송금 목적을 선택하세요」) · remittance_wizard_cubit_test 5건 · should_submit_tour_transfer_as_next_reference_at_09_12 구현+검증 —
FR-008 한도 · 증빙 remittance(+remit_limit 계약) limit_checklist_page.dart · limit_check_policy.dart should_pass_all_four_limit_checks_for_tour_transfer · remittance_rules_test should_fail_annual_when_used_plus_amount_exceeds_limit 구현만 AC2 「실서비스에서는 접수 거부 — 법규 검토 대상」 문구 단언 없음
FR-009 추적 타임라인 remittance remittance_tracking_page.dart core flow(추적 09:12) · should_walk_review_and_settlement_path_with_side_effects 구현만 AC2 반려 사유 subtitle(remittance_tracking_page.dart:94) 단언 없음
FR-010 내역 상태 보드 remittance remittance_history_page.dart(탭 가로 스크롤 :139) should_open_on_hold_tab_with_the_tuition_transfer · should_show_no_customer_buttons_after_approval 구현+검증 —
FR-011 상세 · 고객 전이 remittance remittance_detail_page.dart shell flow 「접수 송금 취소 — 확인 뒤 canceled」 · should_gate_review_request_on_documents · should_let_customer_cancel_only_before_review 구현+검증 —
FR-012 추가서류 supporting_document supporting_document_create_page.dart · SupportingDocumentService shell flow(학비 고지서 샘플 → 재심사) · should_refuse_sample_outside_bundle · supporting_document_sdk_test 구현+검증 AC2 「업로드 0」 은 구조(번들 샘플 id 만 받음)로 보증 — 네트워크 측정은 공개 스모크 범위 밖
FR-013 알림함 remit_notice remit_notice_inbox_page.dart(분류 칩 :74) shell flow 「알림함 — 안 읽은 「도착했어요」를 열면 읽음 …」 · should_mark_my_unread_notice_read_once 구현만 AC2 「심사」 칩 필터 단언 없음
FR-014 설정 remit_preference remit_preference_settings_page.dart should_save_arrival_toggle_immediately_and_keep_it 구현만 AC2 광고성 안내(consentNoticeKey) 단언 없음
FR-015 심사 큐 remittance(console) review_queue_page.dart · TransferTransitionPolicy remit_review_flow_test 「심사역 승인 → 정산 담당 송금 · 도착 …」 · should_split_reviewer_and_operations_buttons 구현+검증 —
FR-016 보류 · 추가서류 요청 remittance(console) review_note_page.dart · review_queue_page.dart 「보류는 결정 사유가 필요하고 보류하면 송금인 알림을 남긴다」 · should_require_reason_and_document_kind_for_hold 구현+검증 —
FR-017 플래그 표 remit_flag remit_flag_table_page.dart · RemitFlagService should_sort_by_amount_descending_then_ascending · should_drop_resolved_flag_from_unresolved_filter · 투어 7 부분 §8 상태머신 2(해소는 연결 송금이 approved · rejected 일 때만, 되돌림 없음) 미구현 — PR #2 b6688c8 에 구현
FR-018 정산 라인 remit_settlement remit_settlement_page.dart · RemitSettlementService 「정산 담당 — 정산 라인 수량 편집 → setLines 저장 · 합계 갱신」 · should_increment_matching_lines_when_delivery_recorded · remit_settlement_sdk_test 구현+검증 —
FR-019 수취인 대장 recipient(console) recipient_ledger_page.dart(좁은 폭 :130) should_keep_only_country_rows_and_reset_page_when_filtered · should_list_all_40_recipients_in_pages_of_ten 구현만 AC2 폰 폭 목록 행 단언 없음
FR-020 한도 정책 remit_limit remit_limit_policy_page.dart 「운영 관리자 — 연간 한도를 낮추면 A-07 판정이 바뀐다」 · should_save_rule_and_feed_next_judgement 구현만 AC2 「데모 값 — 실제 법정 기준 아님」(:103) 단언 없음
FR-021 전이 주체 분리 remittance(+전 scope) TransferTransitionPolicy(앱 · 서버) · 저장소/서비스 재검사 should_never_offer_review_or_settlement_actions_to_customers · should_deny_customer_review_and_reviewer_settlement · remittance_sdk_test(scope 거부 — 직접 호출) 구현+검증 —
FR-022 화면 간 값 전달 remittance · remittance_quote(hand-author) 견적 id → wizard(TransferQuotePort) core flow(프로필 → 견적 → 4단계, 수취인 채워짐) 구현+검증 AC2 「생성물은 빈 입력기」 갭은 이 문서 §9 · cleanbase 생성물로 기록
FR-023 면책 배너 (→ 2026-10-14 로그인 화면 안내 · demo-chrome-login.md) 셸 remit_demo_banner.dart(liveRegion · 접기) app_test · shell flow(bannerKey 존재) 구현만 AC1 스크린리더 문구 · AC2 「초기화 뒤 다시 펼침」 단언 없음, 콘솔 배너 단언 없음
FR-024 초기화 · 공유 세계 셸(A/remit_world) RemitWorldControl · localStorage demo_exchange_remittance.world.v1 shell flow 「초기화 — 바꾼 세계가 시드로 …」 · console 「콘솔 초기화」 · should_adopt_world_written_by_another_tab 구현+검증 —

합계(main): FR 24 · AC 48 · 구현+검증 12 · 구현만 11 · 부분 1 · 없음 0. 「구현만」 11건은 모두 위젯 단언 1~2줄로 닫히는 빈칸이다(§12 W4-3). §16 체험/품질 AC 중 코드로 닫히지 않은 것: Patrol 투어(remit_demo_tour.feature) · .feature 10편 · 기능 골든 매트릭스 · testScaleInvariant(main 에 없음 — salvage 에 있음) · docs/locale-data.md(PR #2).


2. 도메인 · 역할 · FSM

2.1 엔티티(§8) ↔ 실제 모델

§8 엔티티 localOnly(앱 공용 도메인) 서버 테이블(spy.yaml) 바뀐 점(근거)
remittance F/remittance/app_common TransferRecord remit_transfer appliedRate/receiveAmount: double → minor int + 유리수 환율(rateNumerator/rateDenominator) — NFR-013 · revision 추가
remittance_milestone 같은 곳 remit_milestone actorRole 추가(누가 전이했나)
limit_check DTO(계산 결과) DTO RemitLimitCheck 테이블 두지 않음 — 규칙 × 송금 × 서류의 투영
remittance_quote · quote_line F/remittance_quote/app remit_quote(발급 기록) 라인은 금액의 결정적 투영이라 저장 안 함
recipient F/recipient/app_common remit_recipient 이름 · 은행명은 B 투영(시드에 표시값 없음), 입력값은 C 필드
supporting_document F/supporting_document/app remit_document sampleId(번들 샘플만)
remit_notice · remit_preference 각 번들 같은 이름 —
콘솔: flags · settlement · limit rules · review notes remit_flag · remit_settlement · remit_limit · remittance(console) remit_flag · remit_settlement_line · remit_limit_rule · remit_review_note exchange_invoices 의 두 쓰임(견적 · 정산)을 테이블로 분리 — layout §2

2.2 상태머신

FSM 정의 위치 서버 테스트 판정
1 remittance.status(8상태 · 9전이) F/remittance/app_common/.../transfer_transition_policy.dart F/remittance/server/.../transfer_transition_policy.dart · RemittanceService.transition(행 잠금 FOR UPDATE + revision) 앱 3 · 서버 should_follow_prd_state_machine_one 외 5 · 통합 remittance_sdk_test 15 · 동등성 11 시나리오 구현+검증
2 플래그 해소(resolved false→true, 조건: 연결 송금 approved · rejected, 되돌림 없음) main: 「직원이 해소 여부를 바꾼다」(조건 · 단방향 없음) 같음 should_refuse_resolution_for_settlement_role 만 부분 — PR #2 b6688c8 이 localOnly · 서버 같은 계약으로 구현(+remit_flag_policy_test 17줄 · 통합)

2.3 권한 · 격리 · revision · 멱등 · 불변식 위치

규칙 localOnly 서버 테스트
scope remit.customer/review/ops/admin *ActorPort(데모 세션) <Feature>HostBindings.caller ← 인증 + remit_account should_split_review_and_operations_scopes · demo_accounts_auth_test
소유 격리(남의 것 = not_found) 각 Local 저장소 각 Service should_hide_other_senders_recipient_as_not_found · should_hide_missing_and_foreign_transfers_as_not_found
revision(stale_revision) 송금 송금 · 한도 규칙(+PR #2 c5c31ff: 한도 · 설정 · 정산) should_refuse_stale_revision_and_bump_revision_on_writes
멱등 같은 견적 이중 제출 = 같은 송금 requestKey(수취인 · 서류) · 같은 견적 · 읽음 처리 should_return_same_transfer_when_quote_is_submitted_twice · 통합 「동시 이중 제출 1건」
금액 불변식(NFR-013) ExactRate · RemittanceQuote RemittanceQuotePolicy(정밀도 상한 사전 검사 · 내림) remittance_quote_test 5 · exact_rate_test 6 · 서버 7
원자성(전이 + 알림 + 정산) 한 명령 같은 Transaction 통합 「정산 실패 시 전이 · 알림 롤백」 · 「동시 도착 수량 +2」
재고 해당 없음(송금 도메인에 재고 없음) — —

3. 데이터 A/B/C — L-1 초안

정본 표는 PR #2 의 docs/locale-data.md §1(26행)이다 — 이 절은 그 표를 PRD §8 · §10 과 대조한 판정이다.

분류 필드(요약) co_demo_world 투영 키 비고
A 업무 참조번호 · 소유자/수취인 id · 상태 · revision · 금액 minor · 유리수 환율 · 통화 · 국가 코드 · 목적/출처/사유/서류/규칙 코드 · 시각 · 수량 · 한도 수치 · 읽음 · 토글 — 라벨은 기능 소유 slang(UI 번역), 숫자 · 날짜는 DemoFormat(KST 벽시계)
B 언어별 표시 recipient.name · recipient.bankName · (커널 표본 app_status_contact.name) recipient/<id>/name · recipient/<id>/bankName (entity/id/field, 목록 위치 아님) 기능 생성기 RecipientDisplayFields.generators → 셸 RemitDisplayFields.parts → mergeDisplayFields
C 사용자 입력 등록 수취인 이름 · 은행명 · 송금 메모 · 서류 메모 · 심사 사유 · 심사 메모 투영보다 우선(UserEditOverlay · 저장소 필드) 언어 변경 뒤에도 유지

언어 고정 예외: 수취인 이름(NFR-010 영문 이니셜 마스킹 — 모든 언어 동일), 계좌 끝 4자리 · 참조번호 · 통화 코드(A 식별자), 시간대 표기 KST. 법정 서식 없음(번들 샘플 이름만).

계획 대비 빈칸(L-2): 파트너 표시 이름 「누리 파트너 {국가}(가상)」 과 이벤트 알림 문장은 지금 UI 번역 템플릿이다 — PRD L-1 의 「기관 이름 · 생성 메시지」(B)에 해당하므로 co_faker remit 팩에 partnerNameFictional 이 생기면 B 로 옮길 후보다 (co-package#78 범위 확인 필요). bankName 지원 표는 d23a5c42 기준 ko · en 만 native — §10 상향 후 재측정.


4. 화면 · shape · Widgetbook

ID shape Page(실제) Widgetbook use-case main salvage oyster
A-01 dashboard remittance_home_page.dart 없음 remittance_home_page_use_case.dart
A-02 list recipient_list_page.dart 없음 recipient_list_page_use_case.dart
A-03 profile recipient_profile_page.dart 없음 recipient_profile_page_use_case.dart
A-04 form recipient_create_page.dart 없음 recipient_create_page_use_case.dart
A-05 line_items remittance_quote_page.dart 없음 remittance_quote_page_use_case.dart (+summary)
A-06 wizard remittance_wizard_page.dart 없음 remittance_wizard_page_use_case.dart
A-07 checklist limit_checklist_page.dart 없음 limit_checklist_page_use_case.dart
A-08 timeline remittance_tracking_page.dart 없음 remittance_tracking_page_use_case.dart
A-09 status_board remittance_history_page.dart 없음 remittance_history_page_use_case.dart
A-10 detail remittance_detail_page.dart 없음 remittance_detail_page_use_case.dart (+panel)
A-11 form supporting_document_create_page.dart 있음 상태 knob 보강
A-12 inbox remit_notice_inbox_page.dart 있음 보강
A-13 settings remit_preference_settings_page.dart 있음 보강
C-01 status_board review_queue_page.dart 없음 review_queue_page_use_case.dart(+역할 knob)
C-02 data_table remit_flag_table_page.dart 있음 보강
C-03 form review_note_page.dart 없음 review_note_page_use_case.dart
C-04 line_items remit_settlement_page.dart 있음 보강
C-05 data_table recipient_ledger_page.dart 없음 recipient_ledger_page_use_case.dart
C-06 data_table remit_limit_policy_page.dart 있음 보강

5. 브랜드 (F-9)

항목 상태 근거
docs/brand.md · 7축(색 · 타이포 · 모서리 · 여백 · 표면 · 모션 · 아이콘) 있음 결정 한 곳 package/resources/lib/src/theme/brand_tokens.dart(BrandTokens)
raw 색/스타일 grep 0건 — python3 tool/gates/check_raw_style.py: 「raw 스타일 0건 — 639개 파일(테마 모듈 밖)」, Color(0x…) · Colors.* 기능/앱 코드 0 2026-10-09 실행
WCAG AA 라이트/다크 CoreContrast.auditScheme 24쌍 라이트 0 실패 · 다크 0 실패 brand-contrast.md · package/resources/test/brand_test.dart
골든 라이트/다크 커널 표본만(app_router/kernel_status 24장) — 기능 화면 0 salvage 골든 19건 채택 + [update-goldens] 필요
Widgetbook 브랜드 토큰 전시 없음(전시 패키지 · app_widgetbook 에 brand 참조 0) 4단계 W4-6
정체성 display_name → 「송금 데모」 생성 기본값 그대로 layout §8 남은 것 — 정체성 파일 13개 · Android 잡

6. 5종 검증 인벤토리

기능 unit widget golden capture/compare Widgetbook BDD(co_bdd widget) Patrol(실행 앱)
recipient(app · common · console · server) 저장소 7 · 시드 4 · 유즈케이스 1 · 서버 5 Cubit 5 · 대장 3 · 호스트 여정 0 (salvage 4) 0 (salvage 4) 0 0
remittance_quote 엔티티 5 · 정책 3 · 환율 6 · 저장소 8 · 서버 7 호스트 여정 0 (salvage 1) 0 (salvage 2) 0 0
remittance(app · common · console · server) 저장소 18 · 시드 6 · 정책 3 · 서버 13 내역/상세 6 · wizard 5 · 큐 2 · 메모 1 · 호스트 여정 0 (salvage 8) 0 (salvage 10) 0 0
supporting_document 저장소 9 · 서버 5 호스트 여정 0 (salvage 1) 1 0 0
remit_notice 저장소 9 · 서버 3 호스트 여정 0 (salvage 1) 1 0 0
remit_preference 6 · 서버 4 호스트 여정 0 (salvage 1) 1 0 0
remit_flag 6 · 서버 3 호스트 여정(투어 7) · PR #2 locale 1 0 (salvage 1) 1 0 0
remit_settlement 8 · 서버 5 호스트 여정 0 (salvage 1) 1 0 0
remit_limit 7 · 서버 4 호스트 여정 0 (salvage 1) 1 0 0
셸 · remit_world 시드 · 저장 · 동등성 11 앱 8 파일 · 콘솔 3 파일 커널 표본 24장(compare PASS) registry 1 커널 app_status.feature 1 0

7. backend (FB-3)

층 위치 현황(main)
모듈 단위(DB 없음) F/*/server/test/unit 9 패키지 49 테스트 — CI 검증 (tests-modules)
생성 SDK → 호스트 dispatcher → 모듈 → 격리 DB B/test/integration/*_sdk_test.dart 13 파일 54 + 커널 1 — CI 백엔드 통합 (server · PostgreSQL)(서비스 컨테이너) · 검증 (tests-server)(내장) PASS @872792eb, run 37868377049
계약 동등성 localOnly ≡ 생성 SDK 저장소 A/remit_world/test/contract 11 시나리오
검사 범위 성공 · 권한/타인 거부 · 불법 전이 · 사유 · 서류 게이트 · 입력 오류 · 동시성(이중 제출 1 · 결정 1승 · 도착 +2) · revision · requestKey 멱등 · 원자성 · 미바인딩 fail-closed · 실제 로그인 · DB 정책 상세 layout §9.2
빈칸 상태머신 2 서버 계약(PR #2) · revision 확대(한도 · 설정 · 정산, PR #2 c5c31ff) —

8. 재사용 판정 (판정만 — 머지 · 삭제하지 않음)

대상 head 내용 판정 근거 · 충돌
PR #2 story/cocode-657-locale-verification 81e538d2 4커밋 · 594 파일: 상태머신 2(b6688c8) · kernel#29 S-18 이식(11개 언어 · 6표면 · 공개 스모크 · pre-boot) · revision 확대(c5c31ff) · PageTitleBar(R-1, 81e538d) · docs/locale-data.md 채택 CI run 37885466163 · Golden 37885466095 · Pages 37885466094(사이트 빌드) 모두 success, MERGEABLE. FR-017 · surfaces(widgetbook/ · docs/ 404) · L-1/L-2 를 닫는다. 이 문서 PR 과 파일 충돌 0
salvage/cocode-657-oyster-20261009-wip 9f1e393a PR #2 위 1커밋 · 150 파일(추가 124 · 수정 26): 기능 골든 테스트 19 · Widgetbook use-case 신규 16(페이지 13 → 19/19) + showcase/knob · 전시 테스트 · 앱/콘솔 locale · scale 테스트 · remit_shell_layout.dart 부분 채택 PR #2 를 조상으로 가져 충돌 없음 · 중복 없음. 단 골든 기준 PNG 0장 · CI 미실행(미커밋 트리 보존본) — 새 story 브랜치로 옮겨 CI · [update-goldens](Linux) 후 채택. 셸/페이지 수정 4파일은 R-1/R-3 회귀 확인 필요
salvage/cocode-657-remittance-local-snapshot 8b9a961 10-03 legacy donor 바닥(8cf80b6) 위 미커밋 구현(667 파일, feature/application 레이아웃) 폐기(보존) PR #1 94fa746 이 bundle 레이아웃으로 새로 조립 · 업무를 이식했고 docs/brand*.md · mobbin.md 는 이미 옮겼다. 레이아웃이 달라 병합 불가 · 남은 고유 가치 없음. 브랜치는 기록으로 둔다(삭제 안 함)
story/cocode-657-bundle 34dffcc5 PR #1 head 완료 main 의 조상(머지됨). 정리는 코디네이터 판단

권장 순서: PR #2 머지(코디네이터 승인) → salvage 내용을 story/cocode-657-verification-matrix(가칭)로 옮겨 CI → 골든 update → co-package 상향(§10).


9. 레시피 · cleanbase

9.1 cob plan --prd (baseline v1 cob — $HOME/orca/toolchains/637/pub-cache/bin/cob, cob 0.6.0 @ co-bricks 55ce5e14)

명령: PUB_CACHE=$HOME/orca/toolchains/637/pub-cache cob plan --prd <PRD #657 본문> --proposals <아래 부록 A> → exit 0.

항목 결과
FR 24
결정론 covered(exact) 16 — FR-001~014 · FR-023 · FR-024 (레시피 feature 6 + apply app_router)
review-pending(semantic) 8 — FR-015~020(콘솔 · workflow_runtime 컬렉션, 레시피 밖) · FR-021(전이 주체) · FR-022(초기값 주입)
orphan 0 (gate 통과)
NFR 13(리포트 전용)
hand-author 분류 14 capability 모두 hand-author(비-crud 분류) — 레시피 feature 이름도 crud 로 분류되지 않는다
재사용 제안 co_golden · co_golden_gallery · co_bdd · co_faker 등 18건 — 제안 ref 가 d23a5c42(cob registry 핀, baseline v1 의 c003ca2c 아님)

9.2 cleanbase quick (1회)

명령: python3 -I ~/orca/toolchains/637/xhost/scripts/demo_cleanbase_repro.py --recipe exchange_remittance --checks quick --out <scratch>/report.json (스크립트 = cocode PR #1142 head 9cbfff19 의 scripts/demo_cleanbase_repro.py, SHA-256 9291879a…f0f1716c — 기존 사본과 동일).

항목 값
입력 cob 55ce5e14 · bricks fd4edb1e · coui coui_flutter-v0.158.0 · serverpod 4.0.3 · Flutter 3.47.6(Dart 3.13.5) · project_config sha256 8fd1c0db…
manifest 순서 remittance → remittance_quote → recipient → supporting_document → remit_notice → remit_preference
다이제스트 7de381b869219d3d1ae14a35efd6819deedaf75ad340fc5b5b81376ad9eda7db(sha256-of-sorted-path-content-sha256-json-v1, 조립 직후 · 검사 전)
파일 수 1,527
시간 85.4 s(스크립트) · 88.6 s(wall) — 2026-10-09T08:16:18Z~08:17:47Z, PC-B M2 Ultra
결과 succeeded · module-check exit 0 · 작업 디렉터리 정리됨
baseline v1 대비 PC-A full · PC-B quick(2단계) · PC-C quick 과 동일 — 재현 OK

9.3 레시피 ↔ 이 저장소의 차이 (generation 게이트 판단 근거)


10. upgrade 계획 (baseline v1 — 계획만, 이 PR 에서 올리지 않음)

항목 현재 v1 범위
co-package d23a5c42(co_faker 0.11.1 · co_demo_world 0.1.0 · co_demo_prefs 1.0.1 · co_bdd 0.2.0 · co_golden 0.3.0 · co_golden_gallery 0.2.2) c003ca2c(co_faker 0.13.0 · co_demo_world 0.2.0 · 나머지 같음) main 19 pubspec(app/remit_world · 기능 15 · package/test_driver · tool/golden/gallery · feature/app_router/app) + pubspec.lock — S-9 로 한 PR 일괄
coui coui_flutter-v0.158.0 / coui_core-v0.157.0 = 6b7f7b80 같음 변경 없음
cob · bricks · kernel 조립 때 co-bricks 1f278675 · bricks bd857175 · kernel f4bfa774 cob 55ce5e14 · bricks fd4edb1e · 커널 스냅샷 be421e0b 재조립 diff 확인은 co-bricks#830/#831 뒤(지금은 레이아웃 기록만)

영향(상향 PR 에서 검증할 것):

  1. 번역 · 투영(L-2) — co_faker 0.13.0 은 도메인 팩 11개 언어 native(co-package#57 · #71 · #78). recipient.bankName 의 9개 언어 en-fallback 이 native 로 바뀌어야 한다 → UPDATE_LOCALE_TABLE=1 로 지원 표(PR #2 locale_support_table_test)를 다시 쓴다. recipient.name 은 예외(마스킹) 유지.
  2. 결정성 · 시드 — 업무 스트림(deriveSeed(seed,'co_demo_world/business'))이 쓰는 co_faker 팩 값이 바뀌면 시드 세계가 바뀐다 → A/remit_world should_build_the_same_world_twice… · 서버 시드 스냅샷 demo/remit_world_seed.v1.json(should_match_committed_server_seed_fixture) · 투어 고정 레코드(NR-260115-0042 · T*** M. A. · 1,003,000원) 단언으로 확인. 바뀌면 스냅샷 판(v1 → v2)과 localStorage 키 판을 함께 올린다.
  3. co_demo_world 0.2.0 API — DisplayProjector · DemoLocaleSwitcher · UserEditOverlay 사용처(A/remit_world · F/recipient/app_common)의 시그니처 변화 확인.
  4. 골든 — B 데이터가 화면에 보이는 골든(수취인 · 내역 · 상세)은 언어별 variant 가 바뀐다 → 상향 PR 에서 [update-goldens] 한 번.
  5. 공급 측 핀 — cob registry · compose 출력은 아직 d23a5c42 를 제안한다(§9.1) → 재조립 시 같은 PR 에서 상향(baseline v1 「co-package 상향 경로」).

11. blocker (blocker · issue · next)

# 게이트 blocker issue next
B-1 generation cob demo --layout bundle 실조립이 공급 verification profile 없이 exit 78 coco-de/co-bricks#830 profile 생기면 같은 공급 ref 로 재조립 → diff 0 기록
B-2 recipe exchange_remittance 스탬프 legacy_only — bundle 클린베이스 E2E · 스탬프 파이프라인 없음 coco-de/co-bricks#831 · #764 사슬 머지 뒤 bundle 스탬프
B-3 recipe/FR 콘솔 6화면 · scope 전이가 레시피(workflow_runtime) 밖 → cob plan semantic 8 coco-de/co-bricks#764 fast 팩 remit_* 컬렉션 확장(PRD §18 #2)
B-4 generation kernel + bundle 조립 템플릿 결함 T-1~T-15(analyze 2224 · 포맷 · 라우트 순서 등) coco-de/co-bricks#860 수정 cob 로 재조립 → adapter(tool/feature_codegen.dart 포맷 제외) 제거
B-5 smoke/widget CoUI 웹 SelectionArea + 중첩 라우트 딥링크 RenderBox was not laid out(T-16) — 앱 · 콘솔 enableWebTextSelection:false 우회 coco-de/coui#5348 해소(2026-10-11) — coui_flutter-v0.159.0(#5355)으로 올리고 앱 · 콘솔 · 관문 앱 4곳의 우회를 지웠다(선택 영역 켠 기본 설정에서 Patrol · 스모크 예외 0)
B-6 smoke CoUI Icon 런타임 Iconify HTTP — 저장소가 Lucide 52개 번들로 우회 coco-de/coui#5149 · #5190 CoUI 빌드 시 아이콘 번들 → tool/icons/lucide_bundle.py 제거
B-7 generation(test) 생성 wizard 의 CoUI Stepper 가로 12 px overflow(baseline v1 full test 2 fail) — 이 저장소 wizard 는 작성 코드라 영향 없음 baseline v1 「PC-C coui 후속」 — 전용 이슈 미확인 PC-C 가 coui 이슈 · 수정(공통 UI writer). PC-B 는 새 이슈를 만들지 않음(중복 방지)
B-8 generation/recipe 레시피 bundle 스탬프 전 bricks 쪽 커널 Pages 표면 슬롯 충돌 coco-de/bricks#503 · #430 PC-A 재포장
B-9 patrol 실행 앱 Patrol 러너(기기 · 브라우저) 없음 — patrol 잡 없음 coco-de/cocode#657(데모 남은 일) 4단계 W4-10 에서 웹(Chrome) Patrol 또는 macOS 러너 시도, 안 되면 BLOCKED 유지
B-10 locale(L-2) d23a5c42 의 remit 팩은 ko · en 만 — 9개 언어 en-fallback co-package#57 · #71 · #78(closed — c003ca2c 에 반영) §10 상향으로 해소 → 지원 표 재측정
B-11 부속(Mobbin) Mobbin MCP 미인증(이 세션) — 기존 기록은 19화면 × 2링크(38, 고유 24)로 AC 충족. PRD §13 「못 찾은 것」 3건 추가 수집 불가 — Mobbin 인증 가능한 호스트에서 3건 수집, 그 전에는 BLOCKED. 링크를 지어내지 않는다

새로 만든 upstream 이슈: 없음(위 이슈가 모두 열려 있거나 이미 해결됨).


12. 4단계 작업 분해 (순서 · 크기 S≈½일 · M≈1일 · L≈2일+)

순서 작업 게이트 크기 선행
W4-1 PR #2 머지(코디네이터 승인) — 상태머신 2 · S-18 · 6표면 · revision · R-1 fr · surfaces · locale(일부) S 승인
W4-2 salvage oyster 내용을 새 story 브랜치로 옮겨 CI 녹색 → [update-goldens](Linux)로 기능 골든 19화면 × 매트릭스 생성 → compare golden · widgetbook · widget(locale · scale) L W4-1
W4-3 「구현만」 11 FR 의 위젯 단언 보강(서버 없음 화면 · 보류 타일 이동 · 수령 배지/EmptyState · 견적 만료 배지 · 한도 안내 · 반려 사유 · 알림 칩 · 광고성 안내 · 대장 좁은 폭 · 정책 고지 · 배너 재펼침/스크린리더) fr · widget M W4-1
W4-4 co_bdd .feature 10편(PRD §20) + 생성 widget 테스트 — remit_demo_tour 는 FR-001→024 투어 10단계 bdd L W4-2
W4-5 co-package d23a5c42 → c003ca2c 일괄 상향 + 지원 표 재측정 + 시드 스냅샷 확인 + 골든 update(§10) locale(L-2) · golden M W4-2
W4-6 브랜드: Widgetbook 토큰 전시 · 골든 라이트/다크 기능 화면 확인 · display_name 「송금 데모」(정체성 13파일 + Android 잡) 부속(F-9) M W4-2
W4-7 L-3~L-6 브라우저 증거: 공개 빌드에서 ko→en→ja→ar→ko iframe 전환 · ?lang=ar&theme=dark 첫 프레임 · A/C 불변 · 마지막 언어 — 공개 스모크에 locale 단계(잡 이름 정본에 추가) locale M W4-1 · W4-5
W4-8 레시피 재확인: cob plan --entities(co_faker 커버리지) · semantic 8 을 co-bricks#764 로 연결 · Jev fixture 7건은 PC-A(F-4) recipe S —
W4-9 NFR 증거: testScaleInvariant 6화면(NFR-005) · 폰 vs 와이드 비교(NFR-006) · 성능 3초(NFR-003) · 접근성 48dp(NFR-004) widget · 부속 M W4-2
W4-10 Patrol 실행 앱 투어(웹 Chrome 또는 macOS) — 러너 확보 실패 시 BLOCKED 유지(B-9) patrol L W4-4
W4-11 Mobbin 추가 3건 수집(인증 가능 호스트) 부속 S B-11
W4-12 같은 main SHA 에서 evidence dispatch(ci · golden · pages evidence=true) → 수집기 출력을 PC-A 에 제출 전 게이트(5단계 진입) S W4-1~W4-7
(upstream) B-1~B-8 은 소유자(PC-A · PC-C · co-bricks · coui) 진행에 맞춰 재조립 · adapter 제거 generation · recipe — 공급

부록 A. cob plan 입력 proposals (재현용)

schema_version: 1
generated_by: agent-skill
model_id: claude-opus-5-5
capabilities:
  - {id: remittance, brick: remittance, match: exact, confidence: 0.95, covers: [FR-002, FR-007, FR-008, FR-009, FR-010, FR-011]}
  - {id: remittance_quote, brick: remittance_quote, match: exact, confidence: 0.95, covers: [FR-006]}
  - {id: recipient, brick: recipient, match: exact, confidence: 0.95, covers: [FR-003, FR-004, FR-005]}
  - {id: supporting_document, brick: supporting_document, match: exact, confidence: 0.95, covers: [FR-012]}
  - {id: remit_notice, brick: remit_notice, match: exact, confidence: 0.95, covers: [FR-013]}
  - {id: remit_preference, brick: remit_preference, match: exact, confidence: 0.95, covers: [FR-014]}
  - {id: app_router, brick: app_router, match: exact, confidence: 0.6, covers: [FR-001, FR-023, FR-024]}
  - {id: remit_review_console, match: semantic, confidence: 0.5, covers: [FR-015, FR-016]}
  - {id: remit_flag_console, match: semantic, confidence: 0.5, covers: [FR-017]}
  - {id: remit_settlement_console, match: semantic, confidence: 0.5, covers: [FR-018]}
  - {id: remit_recipient_ledger, match: semantic, confidence: 0.5, covers: [FR-019]}
  - {id: remit_limit_policy, match: semantic, confidence: 0.5, covers: [FR-020]}
  - {id: transition_actor_split, match: semantic, confidence: 0.4, covers: [FR-021]}
  - {id: screen_value_handoff, match: semantic, confidence: 0.4, covers: [FR-022]}

(실행 때는 각 항목에 rationale 을 붙였다 — 판정에는 영향이 없다.)

부록 B. 공개 표면 실측 (2026-10-09T08:18Z, main 배포본)

/ 200 · /app/ 200 · /console/ 200 · /golden/ 200 · /app-widgetbook/ 200 · /widgetbook/ 404 · /docs/ 404 — PRD §15 6표면 중 2개 없음(PR #2 가 6표면 이식).