송금 데모 — 3단계(S3) 설계 · 레시피 확정 기록
- 대상: PRD coco-de/cocode#657 · 프로젝트 #637 3단계(POC 설계) · 실행 호스트 PC-B(M2 Ultra)
- 기준 소스: 이 저장소
main = 872792ebb1115c67b621eeb57493710b741fdd06(PR #1 머지). 판정 대상 브랜치는 §8.
- 정본(읽기): cocode
e354841f 의 docs/projects/637/ — execution-contract · phases · baseline-manifest v1 ·
prd-dependencies · change-requests, 증거 형식 docs/demo-evidence/README.md(v2 13게이트).
- 측정일: 2026-10-09(UTC 08:1x). 이 문서는 설계 · 판정만 한다 — 기능 코드 · 기존 PR · 브랜치 · 공급 ref 는 바꾸지 않았다.
- 겹치는 문서는 링크로 둔다: 소유권 · 계약 · 백엔드는 fullstack-feature-layout.md,
브랜드는 brand.md · brand-contrast.md, Mobbin 은 mobbin.md,
L-1/L-2 상세 표는 PR #2 의
docs/locale-data.md(미머지).
상태 어휘(실행 계약 §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 상향 후 재측정.
| 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 |
있음 |
보강 |
- shape 분포(§16 초고속): dashboard 1 · list 1 · profile 1 · form 2 · line_items 1 · wizard 1 · checklist 1 · timeline 1 · status_board 1 ·
detail 1 · inbox 1 · settings 1 = 13(앱),
empty 0 — 레시피 스탬프 portfolio.shapes 와 같다. v3 shape 0 → hand-author 표시 대상 없음.
- 그러나 모든 Page 는 생성 골격이 아니라 이식 · 작성 코드다(layout §8). 레시피는 앱 6기능만 낳고 콘솔 6화면 · 셸 · 계약 바인딩은 레시피 밖이다(§9).
- Page ↔ use-case 누락(main): 13/19(A-01~A-10 · C-01 · C-03 · C-05). salvage 를 채택하면 0.
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 |
- 사이드카 해석 주의:
docs/demo-evidence/657.json 의 golden · bdd PASS(@872792eb)는 잡 성공이지만 대상은 커널 표본뿐이다.
계약상 「파일 존재 · 표본」은 0 으로 센다 — 기능 골든 · .feature 10편이 들어오기 전에는 FR 단위 golden/bdd 를 완료로 보고하지 않는다.
- BDD: PRD §20 의 10편(
remit_demo_entry … remit_demo_tour) 0/10. Patrol: 기기 · 브라우저 러너 없음 → BLOCKED(§11).
- scale(NFR-005):
testScaleInvariant 하네스는 PR #2(package/test_driver), 화면 적용 테스트는 salvage(remit_app_scale_test · remit_console_scale_test).
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
명령: 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 아님) |
cob plan --entities(co_faker 커버리지)는 레시피의 models.entities 를 펼친 목록이 필요해 이번에 돌리지 않았다(시스템 YAML 파서가 레시피 flow map 을 못 읽음) — 4단계 W4-8 에서 cob 자체로 다시 한다.
- 레시피
recipes/exchange_remittance.yaml(co-bricks 55ce5e14)의 verified: 는 cob 0.4.0 · bricks 09451cac legacy_only 스탬프다 — bundle 보증으로 쓰지 않는다.
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 게이트 판단 근거)
- cleanbase 는 레시피 앱 6기능만 조립한다. 이 저장소는 9 번들 + 콘솔 역할 2(recipient · remittance) + 콘솔 전용 3(remit_flag ·
remit_settlement · remit_limit) + 셸 조립(
app/remit_world) — 콘솔 쪽은 PRD §9(b) workflow_runtime 몫이고 co-bricks#764 사슬 전까지
레시피로 표현되지 않는다. 따라서 이 저장소는 cleanbase 다이제스트로 재현되지 않는다(같은 공급 ref 재생성 diff 0 은 co-bricks#830 · #831 뒤).
- FR-022 AC2(생성물은 빈 입력기)와 FR-021(생성물의 status_board/detail 은 모든 전이를 노출)은 cleanbase 생성물 기준 「알려진 갭」 이다.
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 에서 검증할 것):
- 번역 · 투영(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 은 예외(마스킹) 유지.
- 결정성 · 시드 — 업무 스트림(
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 키 판을 함께 올린다.
- co_demo_world 0.2.0 API —
DisplayProjector · DemoLocaleSwitcher · UserEditOverlay 사용처(A/remit_world · F/recipient/app_common)의 시그니처 변화 확인.
- 골든 — B 데이터가 화면에 보이는 골든(수취인 · 내역 · 상세)은 언어별 variant 가 바뀐다 → 상향 PR 에서
[update-goldens] 한 번.
- 공급 측 핀 — 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표면 이식).