목데이터 실시간 다국어 — 데이터 분류 · 지원 표 (L-1 · L-2)
정본: coco-de/cocode#1065(F-11) · cocode S-18 · PRD #657 의 L-1~L-6 · co-package co_demo_world(ref c003ca2c).
이 문서는 송금 데모가 화면 언어를 바꿀 때 무엇이 바뀌고 무엇이 남는지를 필드 단위로 정한다.
원칙
| 종류 | 무엇 | 언어를 바꾸면 |
|---|---|---|
| A 업무 | ID · 외래 키(코드 문자열 참조) · 수량 · 기본 순서 · 상태 코드 · 권한(scope) · revision · 금액 · 통화 · 환율 · 시각 · 사용자 행동의 결과 | 그대로 — 코드는 남고 라벨(UI 번역) · 표기(DemoFormat)만 바뀐다 |
| B 언어별 표시 | 가상 인물 · 기관 이름 등 co_faker 로 만든 표시 값 | 기능이 소유한 생성기(entity.field)로 다시 투영 — DisplayProjector |
| C 사용자 입력 | 송금인 · 직원이 입력한 이름 · 메모 · 사유 | 그대로 — 투영보다 우선(overlay 또는 저장소 필드) |
- UI 언어는 업무 국가(KR) · 통화(KRW · 받는 통화) · 시간대(Asia/Seoul)를 바꾸지 않는다 —
DemoWorld.projectConfig(seed 436 · 기준 시각 2026-01-15 09:00 KST ·businessLocaleko · KRW · Asia/Seoul) 한 곳이 정한다. - enum/코드의 라벨(송금 목적 · 상태 · 사유 · 서류 종류 · 한도 종류 · 플래그 사유 …)은 UI 번역이다 — B 가 아니다.
기능 소유 slang 카탈로그 11개 언어(
tool/i18n/check_parity.py --strict)가 맡는다. - 금액 · 숫자는
DemoFormat.decimal(화면 언어의 자릿수 구분 · ASCII 숫자), 날짜 · 시각은DemoFormat.date(업무 시간대 KST 의 벽시계를 화면 언어의 월 이름 · 순서로 —1월 15일 09:12·Jan 15 09:12). 코드에 한국어 날짜 패턴을 두지 않는다.
1. 필드 분류 (PRD §8 데이터 모델 · §10 시드)
| 엔티티(소유 기능) | 필드 | 종류 | 근거 · 표시 |
|---|---|---|---|
remittance(remittance) |
reference(참조번호 NR-YYMMDD-####) · ownerId · recipientId · status · revision |
A | ID · FK · 상태 코드 — 상태 라벨은 UI 번역 |
remittance |
sendMinor · feeMinor · promotionMinor · receiveMinor · rateNumerator/rateDenominator · receiveCurrency · receiveCountry |
A | 금액(정수 minor) · 통화 · 국가 코드 — 표기만 DemoFormat, 통화 · 국가 라벨은 UI 번역 |
remittance |
purpose · fundSource · reasonCode · requestedDocument · evidenceConfirmed |
A | 코드 — 라벨은 UI 번역 |
remittance |
requestedAt · expectedArrivalAt |
A | 시각 — DemoFormat.date(KST) |
remittance |
수취인 이름(표시) | B(참조) | 송금은 recipientId 만 갖는다 — 화면이 recipient.name 투영을 읽는다(RemittanceDisplayPort) |
remittance |
memo |
C | 송금인 입력(시드에는 없다) |
remittance |
보류 · 반려 사유 문구 | A(코드) / C(입력) | 시드는 reasonCode → UI 번역, 심사역이 쓴 사유는 C |
remittance_milestone |
stage · occurredAt · actorRole |
A | 라벨(label · detail)은 단계 코드의 UI 번역 |
remit_review_note |
position · actorRole · 결정 · 시각 |
A | 메모 본문은 C(심사역 입력) |
limit_check(DTO) |
kind · passed · sortOrder · 사용액 · 한도 |
A | 계산 결과 — 라벨 · 설명은 UI 번역 |
remittance_quote |
quoteId · 금액 · 유리수 환율 · validUntil · arrivalBusinessDays |
A | 받는 금액은 내림(NFR-013) |
quote_line(투영) |
lineKind · 단가 · 수량 |
A | 라벨은 UI 번역(저장하지 않는다) |
recipient(recipient) |
id · ownerId · countryCode · payoutMethod · relationship · accountLast4 · createdAt |
A | 계좌는 끝 4자리 외 마스킹(****-**-4821) — 언어 무관 |
recipient |
name |
B | recipient.name — co_faker remit 마스킹 이름. NFR-010 「영문 이니셜 마스킹」이라 모든 언어에서 같다(아래 지원 표의 en-fallback 은 그 뜻이다). 투어 수취인 「T*** M. A.」 고정 |
recipient |
bankName |
B | recipient.bankName — co_faker remit 가상 은행명(ko 「누리파트너은행(가상)」 · en 「Nuri partner bank (fictional)」, 나머지 언어는 영어 폴백 — §4) |
recipient |
enteredName · enteredBankName |
C | 송금인이 등록 때 입력한 값 — 투영보다 우선(UserEditOverlay) · 저장소 필드 |
supporting_document(supporting_document) |
documentId · transferReference · docKind · issuedOn · sampleId · confirmed |
A | 첨부 이름(「학비 고지서(샘플).pdf」)은 샘플 id 의 UI 번역 — 번들 샘플, 업로드 0 |
supporting_document |
note |
C | 송금인 입력 |
remit_notice(remit_notice) |
noticeId · ownerId · reference · kind · category · isRead · postedAt |
A | 제목 · 본문은 종류 코드의 UI 번역 템플릿 |
remit_notice |
사유 문구 | C | 심사역이 쓴 보류 사유(알림에 그대로 실린다) |
remit_preference(remit_preference) |
알림 토글 · defaultPurpose · monthlyReminderDay |
A | 사용자 설정 값(코드 · 숫자) |
remit_flag(remit_flag) |
flagId · transferReference · reason · amountMinor · flaggedAt · resolved · revision |
A | 사유 라벨은 UI 번역 · 해소는 PRD 상태머신 2 |
settlement_line(remit_settlement) |
lineId · day · partnerCode · receiveCountry · lineKind · 단가 · 수량 |
A | 파트너 표시 이름 「누리 파트너 {국가}(가상)」은 partnerCode 의 UI 번역 템플릿 · 일자는 DemoFormat.date |
remit_limit_rule(remit_limit) |
kind · limitMinor · windowDays · active · revision |
A | 라벨 · 「데모 값 — 실제 기준 아님」은 UI 번역 |
| 콘솔 대장의 송금인 | ownerId |
A | 고객 id 의 UI 번역 라벨 |
app_status_contacts(커널 표본, app_router) |
id · sessions |
A | 이름은 B app_status_contact.name(co_faker person.fullName) — 커널 상태 화면의 실시간 전환 표본(공개 스모크의 iframe 전환이 본다) |
2. 예외 — 언어를 따르지 않는 표시
| 필드 | 이유 |
|---|---|
수취인 이름(recipient.name) |
NFR-010 — 이름은 영문 이니셜 마스킹으로만 보인다(가상 인물이어도 실명처럼 보이지 않게). 언어마다 다른 이름을 만들지 않는다 |
| 계좌 끝 4자리 · 참조번호 · 통화 코드 | 업무 식별자(A) — 숫자 · 라틴 문자 그대로 |
| 시간대 표기 「KST」 | 업무 시간대(Asia/Seoul)는 언어와 무관 — 날짜 · 시각은 KST 벽시계를 언어별 표기로 쓴다 |
법정 서식 · 실제 문서는 없다 — 첨부는 번들 샘플의 이름(UI 번역)만 보인다(업로드 0).
3. 표시 필드(B) — 기능 소유 생성기 · 셸 조립
recipient기능(feature/recipient/app_common)의RecipientDisplayFields.generators가recipient.name·recipient.bankName을 낸다. 셸 조립(app/remit_worldRemitDisplayFields.parts)이 기능 목록을 모아 앱 · 콘솔 · Widgetbook 의demo-display자리에 올리고, 셸이mergeDisplayFields로DisplayProjector하나를 만든다 (같은 키가 둘이면 멈춘다). 커널 표본app_status_contact.name은 앱의demo-display자리에 따로 있다.- 시드는 A 만 넣는다(
DemoWorldConfig.businessFaker(key: 'recipient' · 'remittance' …)) — 이름 · 은행명은 세계에 없다. - 화면은 언제나 투영을 읽는다 —
RecipientDisplay.name/bankName(C 가 있으면 C), 송금 · 견적 화면은RemittanceDisplayPort·QuoteDisplayPort(호스트RemitDisplayBridge). 읽기는 순수하다(재시드 · 쓰기 · 알림 없음). - 서버 모드도 같은 투영기를 쓴다 — 서버는 A · C 만 준다(
docs/fullstack-feature-layout.md§9).
4. 실측 지원 표 — DemoLocaleSupport.markdownTable
시드 수취인 40명(recipient-1~recipient-40)의 표시 필드를 11개 언어로 만들어 분류한 결과다(co_faker 0.13.0 ·
c003ca2c). native = 그 언어 데이터, en-fallback = 영어로 떨어짐. recipient.name 의 en-fallback 은 결함이
아니라 §2 의 예외(마스킹 이름이 언어 무관) 다 — 분류기는 영어 값과 같으면 폴백으로 센다.
| field | ko | en | zh-Hans | ja | de | fr | es | pt | it | ru | ar |
|---|---|---|---|---|---|---|---|---|---|---|---|
recipient.name |
en-fallback | native | en-fallback | en-fallback | en-fallback | en-fallback | en-fallback | en-fallback | en-fallback | en-fallback | en-fallback |
recipient.bankName |
native | native | native | native | native | native | native | native | native | native | native |
5. 폴백 · upstream
co-package c003ca2c(co_faker 0.13.0 · co_demo_world 0.2.0 — co-package#57 · #71 · #78 반영)로 올린 뒤
recipient.bankName 은 11개 언어 모두 native 다(2026-10-09 재측정, 위 표). 남은 en-fallback 칸은
recipient.name 뿐이고 이는 §2 의 예외(마스킹 이름은 언어 무관)다.
| 칸 | 상태 | upstream |
|---|---|---|
recipient.bankName — 9개 언어 |
d23a5c42 에서 en-fallback → c003ca2c 에서 native |
co-package#57 · #71 · #78(closed) |
| 파트너 기관명(가상) · 이벤트 알림 문장 | 지금은 코드의 UI 번역 템플릿(A 코드 → 번역) — B 로 옮길 후보 | co_faker remit 팩 역할 보강 시 |
데모에 번역 사전을 두지 않는다 — co_faker ref 를 올리면 코드 변경 없이 위 칸이 바뀌고, 표 시험
(app/remit_world/test/src/locale_support_table_test.dart)이 문서를 다시 쓰라고 알린다.
6. 언어 전환 배선 (L-3 · L-6)
- 셸 상태 하나 —
AppPresentation(core, 커널 #29): 첫 값은runApp전에 URL(?lang=·?theme=), 없으면 기기 언어. 미리보기 iframe 의sync(DemoEmbedSync(allowLocalhost: kDebugMode), localOnly 만)와 Widgetbook 로케일 애드온이 모두requestLocale로 들어오고DemoLocaleSwitcher가 마지막 요청만 확정한다. 확정 한 단계에서 slang(UI 번역 →CoUIApp.locale→ 아랍어 RTL) ·DisplayProjector.locale(B) ·<html lang dir>이 함께 바뀐다. 받은 값은 저장하지 않는다. - 라우트(go_router) · 선택 · 폼 입력 · 진행 상태(wizard 단계) · 필터 · 페이지는 언어와 다른 상태다 — 전환이 건드리지 않는다.
- 첫 프레임 전(L-6):
app/*/web/index.html의 pre-boot 블록(tool/web/pre_boot.js한 원천)이?lang=ar&theme=dark로<html lang="ar" dir="rtl">·color-scheme· 배경(앱 스캐폴드 색 —AppTheme.scaffoldBackgroundOf)을 칠한다.app/app/test/web/pre_boot_test.dart가 블록 · 색 정본 · 판정 표(tool/web/pre_boot_cases.json)를 지킨다. - 다국어 글꼴: 아랍 · 가나 · 한자 · 키릴은 번들
LocaleFallback(Noto 부분집합)이 엔진 전역 폴백 자리(Roboto)에서 받는다 — fonts.gstatic.com 요청 0(tool/gates/check_locale_fallback_font.py).
7. 검증 (L-4 · L-5)
| 종류 | 어디 |
|---|---|
| unit — 매핑 · 결정성 · A 불변(ko → en → ja → ar → ko 전후 세계 스냅샷) · C 유지 · 이전 언어 복귀 · 마지막 요청 우선 | package/core/test/src/presentation/app_presentation_test.dart · app/remit_world/test/src/remit_world_locale_test.dart |
| widget — 화면마다 실제 mount → 언어 전환 → UI · 투영 값 · RTL · 상태 유지 · 연속 변경 | 기능별 test/src/locale/*_locale_test.dart |
| golden — 언어별 variant(ko · en · zh-Hans · ja · ar · de) | 기능별 test/golden/ |
| Widgetbook — 로케일 애드온이 UI 번역과 표시 투영을 함께 | app/app_widgetbook/test/widgetbook_addons_test.dart · 기능 전시 패키지 시험 |
브라우저(L-3 · L-6) — 업무 화면 A-03 의 iframe 실시간 전환(UI 문구 recipient_profile.title · 표시 데이터 recipient_profile.bank_name) · 빠른 연속 · 다크 · ?lang=ar&theme=dark 첫 프레임 |
Pages 언어 전환 (locale) 잡(배포본) · 사이트 빌드 의 같은 단계(배포 전) — tool/pages/smoke LOCALE_SMOKE_ARGS |
8. 브라우저 실측 — 업무 화면 A-03(2026-10-09, 로컬 산출물 · Chromium)
node smoke.mjs … --checks preboot,live --live-path '#/recipients/recipient-1' --live-ids headline=recipient_profile.title,name=recipient_profile.bank_name
(co-package c003ca2c). 문서 load 1번(다시 불러오지 않음) · 빠른 연속(en ja ar ko ja)은 ja 만 남음 · 다크 따라옴 · 바깥 요청 0.
| 단계 | lang · dir | UI 문구(제목) | 표시 데이터 B(가상 은행명) |
|---|---|---|---|
| ko(첫 값) | ko · ltr | 받는 사람 프로필 | 누리파트너은행(가상) |
| en | en · ltr | Recipient profile | Nuri partner bank (fictional) |
| ja | ja · ltr | 受取人プロフィール | はるかぜ提携銀行(架空) |
| ar | ar · rtl | ملف المستلم | البنك الشريك «نوران» (افتراضي) |
| ko(복귀) | ko · ltr | 받는 사람 프로필 | 누리파트너은행(가상) |
preboot:app — 새 창 ?lang=ar&theme=dark 가 DOMContentLoaded 에 lang=ar · dir=rtl · color-scheme dark · 다크 배경이고 첫 프레임 뒤에도 같다.