미해결 결정 · RFC 백로그 (OD-*)

04-delivery/open-decisions-rfc.html · LogiNippon · TRD · 2026-06-13 · 신뢰도 라벨 확인/추정/설계

이 페이지는 본 TRD가 아직 닫지 못한 결정을 표면화하고, 결정 가능한 것은 추천을 명시하며, 외부(법무·파트너·관청) 의존이 남은 것은 그 의존을 명시한다. 각 미해결 결정(OD-*)은 상태·옵션·추천·영향·차단되는 요구사항·오너·기한을 한 표로 고정한다. flagship 결정은 OD-001 — 대시보드 아키텍처 모순의 해소(ADR-0010)로, 본 TRD가 추가하는 6번째 항목(Svelte console vs Flutter Web 대시보드 모순 해소)을 정규 텍스트로 제시한다. 여기 등장하는 모든 수치는 NFR 페이지·SLO 카탈로그가 소유한 진입 단계 초기 확정 목표(설계)이며, 운영 베이스라인으로 조정한다 — 달성치는 기재하지 않는다.

OD-001 · 대시보드 아키텍처 — ADR-0010 (해소-제안)

본 TRD의 flagship 결정이다. ADR-0003 (제품 앱으로 Flutter)은 "드라이버 앱 = Flutter 네이티브, 화주 대시보드 = Flutter Web"으로 결정했으나(상태: 채택됨, 2026-05-31), as-built는 정반대 상태에 있다 — 채택된 Flutter Web 대시보드는 미구현(app/lib/.../main_dashboard.dart 비동작 placeholder)인 반면, 미채택의 Astro+Svelte console은 실제 동작하는 컨트롤 타워다. ADR-0010은 이 "채택된 것은 미구현, 동작하는 것은 미채택"의 모순을 해소한다.

실시간 전송 분리(귀결 상세). 두 대시보드는 같은 진실원(D1·ShipmentDO)을 다른 전송 경로로 본다 — 둘을 혼동하지 않는 것이 ADR-0010의 핵심 운영 규약이다.

마이그레이션 노트. ① console에 거버닝 ADR(ADR-0010)·README 신설(현재 부재) → 레포 권위 확정. ② console/src/lib/types.ts가 server 타입을 손으로 중복 중(파일 상단 // TODO: server 와 공유 패키지(@loginippon/contract)로 추출해 단일 소스화.) → @loginippon/contract 추출 후 console·server·Flutter 단일 소비. ③ Flutter main_dashboard.dart 화주 대시보드 야망 제거, 드라이버 앱 + 선택적 최소 화주 모바일 뷰로 재범위화. ④ ADR-0003 문서에 amend 주석 추가(상태는 "채택됨" 유지, 대시보드 범위만 ADR-0010이 상위 규정).

OD-002 · 브랜드 확정 — 'LogiNippon' 가칭 → 정식명

'LogiNippon'은 전 레포 가칭(working name)이다. web/src/config.ts는 의도적으로 단일 상수로 중앙화했으나(SITE.name = 'LogiNippon', 주석 "WORKING brand name (placeholder) … swapped in one place once the final name is set"), 그 외 레포에는 하드코딩이 흩어져 있어 단일 스왑으로 끝나지 않는다.

• web: web/src/config.ts 단일 상수(스왑 용이) + url: 'https://loginippon-web.pages.dev'·contactEmail: 'hello@loginippon.example' 예시값.
• console: 다수 하드코딩 — console/src/components/LoginForm.svelte, console/src/components/ConsoleApp.svelte(헤더 라벨 LogiNippon + dev 로그인 키 'loginippon-dev'), console/src/pages/index.astro(<title>LogiNippon — Control Tower</title>).
• server: server/wrangler.jsonc 리소스명 하드코딩(name: "loginippon-server", D1 loginippon, R2 loginippon-proof/-exports/-gps-archive, 큐 loginippon-geofence-eval 등, Analytics loginippon_metrics). 리네임 시 리소스명 변경은 마이그레이션(생성된 리소스명은 사후 변경 불가 → 신규 생성·데이터 이전 동반) → pipeline-ops 리소스 확정/리네임 체크리스트와 연동.
• app(Flutter): 브랜드 팔레트 #1F5FA8 계열 공유(주석 기준), 표시 문자열 하드코딩.

OD-003 · 토큰 저장 하드닝 — console localStorage → httpOnly 쿠키

console는 인증 토큰을 localStorage에 저장한다(console/src/lib/auth.ts 상단 // MVP: 토큰을 localStorage 에 둔다(웹). 후속에 httpOnly 쿠키+짧은 수명/회전으로 강화(07 보안).). localStorage 토큰은 XSS 시 탈취 가능(JS 접근 가능)하다. TTL 정책 자체는 FR-AUTH-001(access 3600s, refresh 2592000s 로테이션-only, KV revocation 전파 ≤60s)이 소유하므로 여기서는 저장 매체 전환만 다룬다. 정규 위협·저장 요구는 SR-TOKEN-STORE-001이 소유한다.

OD-004 · CSV 인코딩 — UTF-8 BOM vs Shift_JIS (監督官庁 포맷)

荷待ち 기록·実運送体制管理簿 CSV의 문자 인코딩이 미확정이다. 일본 행정·표계산(Excel) 관행상 Shift_JIS 또는 UTF-8 BOM 요구가 갈린다. 인코딩 규칙(RR-CSV-001)은 regulatory 페이지가 소유하며, 본 결정은 監督官庁 공식 포맷의 사실 확인에 의존한다. 그 사실은 아직 법무 서명 전이므로 RR-LEGAL-001 플래그를 단다 — 추정으로 확정하지 않는다.

OD-005 · 리소스 프로비저닝 — wrangler placeholder ID 실 프로비저닝

server/wrangler.jsonc의 모든 Cloudflare 리소스 ID가 placeholder이며 미프로비저닝이다(파일 헤더 // IDs below are PLACEHOLDERS.). D1 database_id: "00000000-0000-0000-0000-000000000000", KV GEOFENCE_H3=0000000000000000000000000000000a·CONFIG=…000b·AUTH_KEYS=…000c, staging/production은 STAGING_DB_ID·PROD_DB_ID 등 토큰. 실 프로비저닝(wrangler d1 create / kv namespace create / r2 bucket create / queues create)과 인쇄된 ID 환경별 붙여넣기, 그리고 무료 티어 한도 대비 비용 재확인이 필요하다.

OD-006 · 용량 베이스라인 — 런치 후 실측으로 스케일 트리거 확정

스케일·비용 트리거 수치는 현재 운영 데이터 없는 진입 단계의 초기 확정 목표(설계)다. NFR-SCALE-001(동시 활성 DO > 5,000 OR DO active-wall-time 월 임계 초과 → 종료 화물 D1 60s 폴링)과 NFR-COST-001의 임계는 런치 후 실측 pings/sec·D1 쓰기율로 검증·재조정해야 한다. 측정 평면이 전제이지만 현재 METRICS writeDataPoint가 TODO(SLI 미측정)이므로, 용량 베이스라인 확정의 선행 조건은 OBS-METRICS-001(메트릭 방출)이다.

OD-007 · 런타임 config 권위 — D1 vs KV CONFIG

런타임 설정의 권위 출처가 둘로 갈려 있다. KV CONFIG에 ETA 속도(고속 80 / 도심 30 / 기본 50 km/h)·추적손실 임계(45min)·dwell(120)·feature flag가 시드되었으나 런타임 미read이고, 실제로 dwell은 D1 geofence.dwell_threshold_min에서 읽힌다(server/migrations/0001_init.sql: dwell_threshold_min INTEGER NOT NULL DEFAULT 120, 荷待ち 법정 2시간, 테넌트 override). 즉 ETA 룰 파라미터는 KV에서 런타임 read되지 않고(코드 상수 사용), dwell은 D1 권위다. 어느 것이 권위인지 정리하고 feature flag read 경로를 배선해야 한다.

• 현 상태(as-built). ETA 속도/추적손실/dwell/flags 모두 KV CONFIG에 시드 → 그러나 FR-ENG-ETA-001 룰 ETA는 KV에서 런타임 read하지 않음(현재 미read). dwell 임계만 D1 geofence.dwell_threshold_min에서 실제 read(테넌트별 override가 D1에서 자연스러움).
• 모순. 같은 값(dwell 120)이 KV·D1 양쪽에 존재 → 단일 권위 미정. feature flag는 read 경로 자체가 없음.

OD-008 · GS1 흡수 — 대형 화주 GS1(SSCC/GLN) 채택 시 표준 식별자 승격

데이터 모델은 GS1 표준 식별자 흡수 여지를 남겨 둔다. techspec 02-data-model/model.md §미래: GS1 표준 흡수: "GS1 Japan이 SSCC(출하포장 시리얼)·GLN(장소 식별)을 보급 중이나 중소 운송사 도입률은 낮다 추정. 대형 화주가 GS1을 채택하면 shipment.shipper_ref/geofence에 GLN을 흡수해 표준 식별자로 승격할 수 있는 여지를 남겨 둔다." GS1 Japan이 SSCC·GLN 등 물류 표준 식별자를 보급하고 総合物流施策大綱이 GS1 표준 활용 방침을 명시한 것은 확인이나, 중소 운송사 도입률은 추정으로 낮다.

결정 요약 매트릭스