범위 · 비목표 · 단계 게이트
"무엇을 만들지"만큼 "무엇을 만들지 않을지"를 못박는 것이 제휴 1곳·페인 1개를 확실히 푸는 린한 실행의 핵심이다. 이 페이지는 제품 목표(GOAL-*)와 명시적 비목표(NG-*)를 소유하고, In-MVP 범위의 as-built 구현 상태와 단계 게이트(GATE-P0/GATE-P1)를 요약한다. 모든 KPI/SLO 수치는 진입 단계 설계 목표(달성치 아님)이며, 게이트 DoD의 단일 진실원은 TRD phase-gates-roadmap이다.
확인 시장·법령 사실 추정 미검증 시장 사실 설계 우리 목표·결정 DONE / PARTIAL / STUB / ABSENT — as-built 구현 상태
1. 제품 목표 (GOAL-*)
LogiNippon이 화주·컨사이니에게 약속하는 제품 결과(outcome). 각 목표는 페인·규제 우선 전략(비전·전략)에서 도출되며, 위치 데이터는 페인을 푸는 과정의 부산물로 수집된다. 기술적 실현 방식은 TRD로 링크하고 여기서 중복하지 않는다.
화주(SHIPPER_ADMIN/SHIPPER_VIEWER)가 元請→下請→孫請 다단계 하청을 관통해 자사 화물의 현 위치·상태·도착 예정을 단일 컨트롤타워(FleetMap + 화물목록)에서 본다. 핵은 소프트웨어가 아니라 실제 운송 차량을 보는 네트워크(H3 강검증)다.
거점(창고·납품처)별 荷待ち를 지오펜스 dwell로 자동 측정·가시화하고, 法定 2시간 임계 초과를 표시한다. 측정가능 ROI(예: 荷待ち 3–4h→1–2h 추정)가 화주의 납품처 개선 협상 근거가 된다.
드라이버(DRIVER)가 추가 조작 없이 데이터를 발생시킨다 — 案件 수락 시 위치 공유 자동 ON, 주행 중 적응 샘플링, 지오펜스 ENTER/EXIT를 서버가 자동 도출, 완료 시 자동 OFF. 스마트폰 GPS가 1차 위치 센서다. STUB — Flutter 드라이버 앱은 scaffold 단계(배경 위치 주석처리)로 최대 갭이며 MVP exit를 막는다.
규제 의무 산출물(荷待ち 기록·実運送体制管理簿·拘束時間 관련 기록)을 데이터에서 자동 생성·출력한다 — 진입 쐐기이자 유일한 수익 명분. 荷待ち/NIMACHI CSV(法定 2시간 초과 표시·report_id·JST·≤92일·UTF-8 BOM)가 유일하게 end-to-end 완성된 킬러 기능. 実運送体制管理簿(GET /v1/reports/jitsuunso)는 501이며 拘束時間 export는 ABSENT(보조 데이터만).
RR-LEGAL-001 주의 — 공식 컬럼셋·인코딩(Shift_JIS vs UTF-8 BOM)이 미확정·미서명이다. 서명 전 "官庁 제출가능"으로 광고하지 않는다(RR-LEGAL-001 게이트).
화주 시스템(TMS/WMS/ERP)이 LogiNippon 데이터를 소비할 수 있는 퍼블릭 API + 웹훅을 제공한다 — ERP 대체가 아닌 overlay. Phase 2 Enterprise 에디션. STUB — 웹훅 전달은 ack-only, 웹훅 CRUD는 501.
기술 목표는 TRD 소유. 운영 서버 0대·무료 티어·이벤트 정규화 canonical code 등 비기능 목표는 제품 가드레일로만 참조하고 상세는 TRD nonfunctional + SLO-S5(가용성 ≥99.9% 설계)에 둔다.
2. In-MVP 범위 (상당수 console DONE)
MVP의 목적은 망라가 아니라 "페인 한 개를 제휴 파트너 1곳에서 확실히 푼다"이다. 아래 표는 In-MVP 항목과 각 as-built 구현 상태(§14 사실 기준)다. 컨트롤타워·NIMACHI·온보딩·CarrierManager·컨사이니·Auth·H3 엔진은 라이브 console에서 검증된 DONE이고, 드라이버 앱과 5개 서버 항목은 MVP exit를 막는 STUB이다.
| In-MVP 항목 | 페르소나 | 제품 내용 | 구현 상태 |
|---|---|---|---|
| 컨트롤타워·실시간 가시성 | SHIPPER_ADMIN |
FleetMap(never-empty 트럭/stop 핀, /shipments/tracking 6s 폴링) + ShipmentsTable drill-down. EPIC-CONTROL-TOWER |
DONE |
| 荷待ち / NIMACHI CSV 설계 KPI 별도 | SHIPPER_ADMIN |
法定 2시간 초과 표시·report_id·JST 기간(≤92일)·UTF-8 BOM CSV(監督官庁용). 유일 완성 킬러 기능. EPIC-REGULATORY |
DONE |
| 0→1 온보딩(cold-start) | PLATFORM_ADMIN |
AdminPanel: 캐리어 + 일회용 DRIVER 초대코드(max_uses=1, ttl=30d) + 컨사이니/거점/지오펜스 셋업. EPIC-ONBOARDING |
DONE |
| ShipmentFactory(데모 실증) | PLATFORM_ADMIN |
4스텝: ①캐리어+컨사이니 ②드라이버(비번≥8·APPI 동의)+차량 ③멀티스톱 화물(≥1 PICKUP·≥1 DROPOFF·끝=DROPOFF) ④위치 시뮬→ingest. 실 GPS 0에서 전 과정 데모. JRN-FACTORY | DONE |
| CarrierManager | PLATFORM_ADMIN |
드라이버·차량 CRUD·비번 리셋·일정·inline stop·active/history(플랫폼 운영). 캐리어 셀프서비스는 Phase 2. EPIC-CARRIER-OPS | DONE |
| 컨사이니 경험 | CONSIGNEE_ADMIN |
InboundView(다캐리어 라이브 큐) + Dashboard(건수·평균 dwell·정시%·ETA MAE 캐리어 비교). EPIC-CONSIGNEE | DONE |
| Auth · 역할/스코프 · 테넌트 격리 | PLATFORM_ADMIN |
JWT 역할/스코프 + refresh + 테넌트 격리(404) + 셀프가입 없음(ADR-0001). 7역할 + DRIVER. EPIC-AUTH-TENANCY |
DONE |
| H3 지오펜스/dwell 엔진 + ingest | (파이프라인) | ingest(202 ACK→DO→queue→R2) + H3 enter/exit/dwell 히스테리시스 엔진 + Shipment DO/WebSocket fan-out + ja/en/ko i18n. | DONE |
| 드라이버 앱 잡 라이프사이클 최대 갭 | DRIVER |
案件→수락 자동 공유→배경 GPS→서버 지오펜스 이벤트→完了+증빙 사진→자동 OFF. In MVP이나 scaffold STUB(배경 위치 주석처리, hasConsent→false, JobsRepository []). EPIC-DRIVER-APP |
STUB |
| 룰 ETA · Tracking Rate 정직 | SHIPPER_ADMIN |
거리+구간 평균 속도 룰 ETA(eta_is_estimate 표기)·staleness/tracking_rate 정직 노출. ETA 배치는 ack-only. |
STUB |
| 예외 감지 + 알림(LINE 1순위) | CARRIER_OPS |
지연·荷待ち 초과·추적손실·이탈·정차·픽업 예외 → LINE/메일/웹훅. 알림 전달(handleNotifyBatch ack-only)·tracking-loss sweep(빈 cron) STUB. |
STUB |
| APPI consent 게이트(ingest 배선) | PRS-LEGAL |
위치 수신 전 동의 하드 게이트. consentGate가 ingest에서 미호출 — APPI 노출 갭(R9). 受取人 ETA-only(차량 위치 마스킹 個人情報保護法)은 동작. |
STUB |
이연(Out, 후속). MVP에서 제외하고 후속으로 미루는 항목: ML ETA·OEM 텔레매틱스/デジタコ·EDI 양방향·멀티테넌트 3PL 뷰·캐리어 데이터 공유 세분 권한·CO₂ 분석. 아래 4. Later·3. 비목표 참조.
3. 명시적 비목표 (NG-*)
명시적으로 하지 않는 것. 각 항목은 "지금은 안 함"이며, 일부는 후속 단계로 이연되고 일부는 영구 범위 밖이다. 비목표를 못박아 스코프 크리프와 cold-start 마찰을 차단한다.
| ID | 비목표 | 이유 | 재검토 시점 |
|---|---|---|---|
NG-01 | 자체 IoT 하드웨어 트래커 제조·판매 | 스마트폰 GPS 우선 전략(ADR-0006). 하드웨어는 자본·물류·재고 부담이 크다. | Phase 2+ (특수 화물 한정 검토) |
NG-02 | 求荷求車(화물-차량 매칭) 마켓플레이스 | Trabox·Hacobell의 영역. 우리는 매칭이 아니라 가시성으로 진입한다. | 범위 밖(초기) |
NG-03 | 운임 결제·정산·팩토링을 코어로 | 위치 데이터가 "운행 완료의 객관적 증거"가 된 후의 확장 경로(물류×금융). 초기엔 코어로 하지 않음. | Phase 2+ |
NG-04 | WMS(창고관리시스템) 자체 | 트래킹과의 접점만 다룬다. 창고 운영 자체는 범위 밖. | 범위 밖 |
NG-05 | 국제 물류(해상·항공·통관) visibility | 1차 범위는 일본 국내 트럭. 글로벌 RTTVP는 레퍼런스로만 참조. | 범위 밖 |
NG-06 | B2C 라스트마일 배송 플랫폼 | 이식하려는 가시성의 원형일 뿐 사업 대상이 아니다. 자율주행·드론 배송 포함. | 범위 밖 |
NG-07 | 온프레미스·셀프호스팅 배포 옵션 | 엣지 SaaS가 전제. 중소 운송사는 자체 구축 비용이 높아 SaaS를 선호. | 범위 밖 |
NG-08 | 전용 拘束時間 노무관리 시스템 | 2024년문제 대응의 노무 영역. 우리는 GPS 기반 보조 데이터만 제공하고 노무관리 시스템을 대체하지 않는다. | 범위 밖(보조 export는 후속) |
국제물류는 화물보험과 함께 코어 범위 밖이다. 위 8개는 영구·반영구 비목표이며, "지금은 안 함"이지만 단계에 따라 풀리는 항목은 아래 Later에서 별도로 다룬다.
4. Later (후속 — 단계로 이연)
"지금 안 함"이 단계에 따라 풀리는 항목과 해제 조건. 일부는 In-MVP의 STUB 해소(드라이버 앱 풀구현)이고, 일부는 Phase 2 확장이다. ML ETA 등 정량 게이트가 붙은 항목은 조건을 명시한다.
| 후속 항목 | 현재 상태 | 해제 시점 · 조건 |
|---|---|---|
| Flutter 드라이버 앱 풀구현(#1 갭) | STUB | Phase 1 MVP — GATE-P1 exit 전제(1차 위치 센서). 案件 API 합의 선결. |
| 実運送体制管理簿 자동생성(청부체인+GPS 검증) | ABSENT(501) | Phase 2 — 화이트스페이스. RR-LEGAL-001 포맷 서명 게이트. |
| 拘束時間 보조 export | ABSENT | 후속(보조 데이터만, NG-08과 일관). |
| 화주向 캐리어 스코어카드 | ABSENT | Phase 1 후반~2 — FR-RPT-ANALYTICS-001. 컨사이니 Dashboard에 병렬 뷰 존재. |
| 퍼블릭 API + 웹훅 전달 | STUB | Phase 2 — Enterprise 에디션(EPIC-INTEGRATIONS). |
| CARRIER_OPS 셀프서비스 | 플랫폼 운영 대행 | Phase 2 — 현재 PLATFORM_ADMIN이 CarrierManager로 대행. |
| 멀티테넌트 3PL + 세분 공유 권한 | 미착수 | Phase 2 — 다 화주/캐리어 오케스트레이션, 테넌트 분리(JTBD-12). |
| 텔레매틱스/デジタコ 연동(矢崎·富士通) | 미착수 | Phase 2 — source_type=TELEMATICS. 벤더 API 가용/보급률 미확인(R3). |
| ML ETA 전환 | 룰 ETA STUB | 레인 ≥3,000운행 AND 룰 MAPE >20% 시. FR-ENG-ETA-001·SLO-S7. |
| Leg 다중구간 모델 | 3계층(Shipment→Stop→Event) | Phase 2 — 일본 국내 트럭은 구간 1~2개라 단순 시작(ADR-0005). |
| 물류×금융(결제·팩토링 PoC) | 미착수 | Phase 2+ — 위치=운행 증거가 된 후. EDI 214 양방향 포함. |
관측 하드닝(rate limit·OBS-METRICS-001·토큰 httpOnly) | STUB | rate limit·consent gate는 GATE-P1 exit. writeDataPoint(SLI 측정)·토큰 localStorage→httpOnly(R12)는 후속. |
5. 단계 게이트
로드맵은 코드가 아니라 제휴(Phase 0)부터 시작한다 — 제휴 없는 MVP는 시드 데이터가 없어 작동하지 않는다. 두 게이트가 단계 전환을 통제하며, DoD의 단일 진실원은 TRD phase-gates-roadmap이다. 상세 로드맵·릴리스 계획은 로드맵·릴리스가 다룬다.
1순위 리스크는 cold-start(검증된 #1 장벽, R1). 제휴 합의 없이는 Phase 1 착수를 보류한다. 두 트랙(BIZ-RUBRIC): (A) 대형 화주(特定第一種荷主 ≥9만t — 효율화가 법적 의무, 캐리어에 강제력) / (B) 대형 운송사(자사+하청망 일괄).
충족 조건(MUST)
- 제휴 파트너 1곳(대형 화주 또는 운송사)과 PoC 합의 — 데이터 수신·送り状番号 매핑·동의 책임 서명.
- 주요 DC·납품처 거점 폴리곤 지오펜스 100~200개소 선구축(KV 캐시).
- 規制 데이터 항목 정의(実運送体制管理簿 기재 항목·荷待ち 기록 포맷).
- 이벤트 매핑 시드 — 대형 운송사(ヤマト·佐川·NX·セイノー) 코드 →
event_code_map.
"페인 한 개를 제휴 파트너 1곳에서 확실히 푼다"의 완료 증명. 모든 KPI 목표는 설계(진입 단계 초기 목표, 달성치 아님)다.
충족 조건(MUST)
- 제휴 파트너의 실제 운행에서 Tracking Rate ≥85%(MVP exit floor; 정상 지향 ≥92%)로 화물이 추적된다 — North Star, 설계.
- 荷待ち 리포트가 실제 거점 데이터로 생성되어 화주의 개선 협상에 사용된다.
- 規制 출력 v1(NIMACHI CSV)이 수기 작성을 대체한다.
- 인프라 비용이 무료 티어 내에 머문다(서버 0대).
- 5개 STUB 해소: ①웹훅 전달 ②룰 ETA ③tracking-loss sweep ④rate limit ⑤ingest
consentGate(APPI). + 드라이버 앱 풀구현이 Tracking Rate의 전제.
측정 차단. Tracking Rate·OTD·MAPE는 METRICS.writeDataPoint(OBS-METRICS-001) 배선 전까지 미측정이다. 목표 수치는 post-launch 베이스라인으로 확정한다.
근거·상호참조
- 마스터 스펙 §9(범위)·§14(as-built 사실) —
prd/.build/master-spec.md - techspec: 목표·비목표·MVP 범위(
00-overview/goals-nongoals.md) · 로드맵(roadmap.md) - 제품 목표 GOAL-* → EPIC: 에픽·유저스토리 · JTBD: Jobs-to-be-Done · 여정: 여정
- 전략 맥락: 비전·전략 · 문제·기회 · GTM: GTM·가격 · 로드맵: 로드맵·릴리스
- 리스크·질문: 제품 리스크·미해결 질문 · 지표: 성공지표·KPI · 추적성: 추적성 매트릭스
- TRD 게이트 DoD(소유): phase-gates-roadmap · 규제 포맷 게이트: RR-LEGAL-001
- 신뢰도: 시장·법령 사실 확인/추정 · 우리 목표·결정 설계(진입 단계 초기 목표, 달성치 아님). 공식 규제 포맷 미확정은 RR-LEGAL-001 참조.