로드맵 · 릴리스 계획
제품 관점의 단계 로드맵이다. 로드맵은 코드가 아니라 제휴(Phase 0)에서 시작한다 — 제휴 없는 MVP는 시드 데이터가 없어 작동하지 않는다(cold-start = 검증된 #1 장벽 H3). Phase 0(제휴·기반)→1(MVP)→2(확장)의 세 단계와, MVP 출시를 막는 5개 STUB 해소 중심의 MVP-exit DoD, 그리고 현재 DONE vs 남은 갭을 정직하게 정리한다. 게이트의 정식 DoD는 TRD가 소유하고 여기서는 제품 릴리스 렌즈로 교차링크한다. 모든 KPI/SLO 수치는 진입 단계 설계 목표(달성치 아님)다.
DONE 라이브 검증 PARTIAL 일부 구현 STUB 골격만 설계 진입 단계 목표 Phase 0 Phase 1 Phase 2
1. 단계 개요 — Phase 0 → 1 → 2
로드맵의 가로지르는 원칙은 제휴가 게이트라는 점이다. Phase 0의 제휴를 확보하지 못하면 Phase 1 착수를 보류한다(PR-01 cold-start). 단계 전환은 다음 두 하드 게이트가 관장한다.
| 릴리스 | 단계 | 게이트 | 핵심 산출물 | 출구 조건(요약) |
|---|---|---|---|---|
REL-0 제휴·기반 |
Phase 0 | GATE-P0 하드 | 제휴 PoC 서명·거점 지오펜스 100~200·규제 항목 정의·event_code_map 시드·리소스 프로비저닝 |
제휴 합의 + 거점 지오펜스 + 규제 항목 정의 완료 |
REL-1 MVP |
Phase 1 | GATE-P1 MVP-exit | 드라이버 앱 GA·컨트롤타워·荷待ち/NIMACHI·룰 ETA·예외 알림·5 STUB 해소 | Tracking Rate ≥85% · 荷待ち 리포트 협상 사용 · 규제 출력 수기 대체 · 무료티어 · 5 STUB 해소 |
REL-2 확장 |
Phase 2 | — | 텔레매틱스·ML ETA·実運送体制管理簿·멀티테넌트 3PL·CARRIER_OPS 셀프·물류×금융 | 가시성 커버리지·ETA 정확도·테넌트 확장 (게이트 미정) |
제휴 하드 게이트(GATE-P0). 자력 온보딩은 수년이 걸린다(Hacobell 6년 후 세이노 자본제휴로 돌파 추정). 두 트랙으로 제휴를 노린다: (A) 대형 화주(特定第一種荷主 ≥9만t — 효율화가 법적 의무라 하청 캐리어에 강제력) (B) 대형 운송사(자사+하청망 일괄, event_code_map 시드 ヤマト/佐川/NX/セイノー). 미서명 시 Phase 1 보류. 자격평가 루브릭은 TRD BIZ-RUBRIC 참조. 여정은 JRN-COLDSTART.
2. Phase 0 산출물 — 제휴·기반 (Pre-build)
목표: 사업 전제(제휴)를 확보하고, 데이터 품질의 분기점을 미리 깐다. 이 단계는 코드 산출이 거의 없고 사업·데이터 자산 중심이다.
| 마일스톤 | 산출물 | 관련 페르소나/여정 | TRD |
|---|---|---|---|
| 제휴 PoC 확보 | 대형 화주(特定第一種荷主) 또는 대형 운송사와 PoC 합의 — 데이터 수신·送り状番号 매핑·동의 책임 서명 | PLATFORM_ADMIN · JRN-COLDSTART | GATE-P0 |
| 거점 지오펜스 선구축 | 주요 DC·납품처 100~200개소 폴리곤(KV 캐시) — 맵 never-empty·dwell 측정의 전제 | PLATFORM_ADMIN | FR-GEO-CRUD-001 · FR-GEO-003 |
| 規制 데이터 항목 정의 | 実運送体制管理簿 기재 항목·荷待ち 기록 포맷 확정 RR-LEGAL-001 미확정 | SHIPPER_ADMIN · PRS-LEGAL | RR-LEGAL-001 · RR-JITSUUNSO-001 |
| 이벤트 매핑 시드 | 대형 운송사(ヤマト·佐川·NX·セイノー) 코드 → event_code_map 시드(정규화 ≥99% 전제) |
PLATFORM_ADMIN | FR-INGEST-003 · SLO-S8 |
| 리소스 프로비저닝 | Cloudflare D1/KV/R2/Queues/DO/Cron 프로비저닝, 무료 티어 가격 재확인 | — | FR-PROV-001 |
RR-LEGAL-001 주의. 公式 규제 출력 포맷(컬럼셋·인코딩 Shift_JIS vs UTF-8 BOM)이 미확정·미서명 상태다. 法務 서명 전까지 "監督官庁 제출 가능"으로 광고하지 않는다(정직 포지셔닝). 미해결 질문은 OQ 참조.
3. Phase 1 MVP 릴리스 — 제품 마일스톤 → EPIC 매핑
MVP의 목적은 망라가 아니라 "페인 한 개를 제휴 파트너 1곳에서 확실히 푼다"이다. 제품 마일스톤을 에픽(epics-stories 소유)에 매핑한다. 현재 상태는 유일 완성 킬러(荷待ち/NIMACHI)가 end-to-end이고, 컨트롤타워·온보딩·컨사이니·Auth·ingest/지오펜스 엔진이 DONE이나, 드라이버 앱이 최대 갭이다.
| 제품 마일스톤 | EPIC | P | 현재 상태 | 남은 갭(MVP-exit까지) |
|---|---|---|---|---|
| 컨트롤타워·실시간 가시성(FleetMap never-empty + ShipmentsTable) | EPIC-CONTROL-TOWER | P0 | DONE | 드라이버 앱 실 GPS 연결 시 실데이터 검증 |
| 荷待ち/NIMACHI CSV(法定2시간 표시·report_id·JST·≤92일·UTF-8 BOM) | EPIC-REGULATORY | P0 | DONE 킬러·유일 완성 | 실 운행 dwell로 협상 사용 실증(出口 조건) |
| 0→1 온보딩(AdminPanel + 일회용 초대코드 + ShipmentFactory) | EPIC-ONBOARDING | P0 | DONE | 초대코드 소비 핸드셰이크(드라이버 앱 측) |
| 캐리어 자산 관리(CarrierManager: 드라이버·차량 CRUD·일정) | EPIC-CARRIER-OPS | P1 | DONE 플랫폼 운영 | CARRIER_OPS 셀프서비스는 Phase 2 |
| 컨사이니 경험(InboundView 라이브 큐 + Dashboard 캐리어 비교) | EPIC-CONSIGNEE | P0 | DONE | 실데이터 KPI(정시%·ETA MAE) 베이스라인 |
| 인증·역할/스코프·테넌트 격리(셀프가입 없음) | EPIC-AUTH-TENANCY | P0 | DONE | 토큰 httpOnly 하드닝은 Later(R12) |
| 드라이버 앱: 案件→수락 자동공유→배경 GPS→서버 지오펜스→완료+증빙→자동OFF | EPIC-DRIVER-APP | P0 | STUB 최대 갭 | 배경 위치·동의·토큰·案件 API·증빙·푸시 풀구현 = GA 핵심 |
| 트래킹 엔진: 룰 ETA(추정치 표기) + Tracking Rate 정직 | EPIC-TRACKING-ENGINE | P1 | PARTIAL | 룰 ETA(handleEtaBatch ack-only) 해소 · tracking-loss sweep |
| 알림·예외 분류(LINE 1순위 + 메일/웹훅) | EPIC-NOTIFY-EXC | P1 | STUB | 웹훅 전달(handleNotifyBatch ack-only) 실배선 |
| APPI 동의·드라이버 위치 프라이버시·受取人 마스킹 | EPIC-CONSENT-PRIVACY | P0 | PARTIAL | ingest consentGate 미배선(APPI 갭) — 라이브 전 하드 게이트 |
MVP-exit DoD (GATE-P1)
MVP를 떠나려면 아래 조건이 모두 충족돼야 한다(TRD가 정식 DoD를 소유). 산출 조건과 5개 STUB 해소를 분리해 둔다.
5개 STUB 해소 — 이 다섯이 MVP exit를 막는 차단 항목이다(§14 as-built 사실).
| # | STUB | 현재 상태 | 해소 = MVP-exit | TRD |
|---|---|---|---|---|
| 1 | 드라이버 앱 핵심(배경 위치·동의·토큰·案件 API) | STUB 배경 위치 주석처리·hasConsent→false·token→null·JobsRepository [] — 최대 갭 | 잡 라이프사이클 풀구현 → 1차 위치 센서 가동 | FR-ACQ-GPS-001 · FR-ACQ-AUTOSHARE-001 · FR-ACQ-API-001 |
| 2 | 웹훅 전달 | STUB handleNotifyBatch ack-only(전달 미실행) | LINE/메일/웹훅 실전달 — 예외 알림 동작 | FR-DLV-NOTIFY-001 · SLO-S3 |
| 3 | 룰 ETA | STUB handleEtaBatch ack-only | 거리+구간 평균속도 룰 ETA(eta_is_estimate 표기) 산출 | FR-ENG-ETA-001 · SLO-S7 |
| 4 | tracking-loss sweep | STUB 빈 cron | 추적손실 예외 감지·Tracking Rate 정직 노출 가동 | FR-ENG-EXC-001 |
| 5a | consent gate(ingest) | STUB consentGate ingest 미호출(APPI 노출 갭) | APPI 동의 하드 게이트를 ingest에 배선 — 라이브 전 필수 | FR-ACQ-CONSENT-001 · RR-LEGAL-001 |
| 5b | rate limit | ABSENT rate limit 없음 | 인제스트/API 레이트 리밋 도입(남용·비용 가드레일) | NFR-RATE-001 |
측정 차단. Tracking Rate를 포함한 SLI는 METRICS.writeDataPoint가 TODO라 현재 미측정이다. MVP-exit ≥85% 판정 전에 계측(OBS-METRICS-001)이 선결돼야 한다. 모든 목표 수치는 진입 단계 설계 라벨이며 베이스라인은 post-launch에 잡는다(OQ).
4. Phase 2 — 확장
목표: 가시성 커버리지·ETA 정확도·테넌트 확장. Phase 1 후반에 누적된 데이터(R2 아카이브)와 제휴 확장이 전제다.
| 마일스톤 | 산출물 | 관련 페르소나/EPIC | TRD |
|---|---|---|---|
| 텔레매틱스·通信型デジタコ 연동 | OEM·デジタコ 벤더 API(source_type=TELEMATICS) — GPS 연속성 보강(R3) |
DRIVER 보완 | FR-ACQ-API-001 |
| ML ETA 전환 | R2 아카이브 학습 → XGBoost+LSTM·Workers AI 추론(MAPE 룰≤25%→ML≤15%). 트리거: 레인 ≥3,000운행 AND 룰 MAPE>20% | EPIC-TRACKING-ENGINE | KPI-ETA-001 |
| 実運送体制管理簿 완성 | 청부 계층 + 실시간 GPS 검증 결합(화이트스페이스). 현재 GET /v1/reports/jitsuunso 501 |
EPIC-REGULATORY | FR-RPT-JITSUUNSO-001 · RR-JITSUUNSO-001 |
| 멀티테넌트 3PL·세분 권한 | 다 화주/캐리어 오케스트레이션·캐리어 데이터 공유 제어·정산 근거 overlay | EPIC-INTEGRATIONS · PRS-3PL | FR-DLV-WH-001 |
| CARRIER_OPS 셀프서비스 | 플랫폼 운영 → 캐리어 자가 운영(자산·일정·자사 차량 가시성) | CARRIER_OPS · EPIC-CARRIER-OPS | FR-AUTH-005 |
| 물류×금융 탐색 | 운임 결제·팩토링 PoC(위치=운행 완료의 객관적 증거). 코어 아님 | SHIPPER_ADMIN · PRS-3PL | BIZ-* |
Leg 다중구간 모델·EDI 214 양방향도 Phase 2 항목이나(국내 트럭은 구간 1~2개로 3계층 시작), 이 페이지는 제품 릴리스 렌즈로 핵심 6개만 표기한다.
5. 비목표 해제 매핑
scope-nongoals가 소유하는 비목표(NG-*) 중 "지금 안 함"이 언제 풀리는지를 단계에 매핑한다. 일부는 영구 범위 밖이다.
| 비목표 | 해제 단계 | 해제 전제/조건 |
|---|---|---|
| 자체 ML ETA 모델 | Phase 1 후반~Phase 2 | 수천 건(레인 ≥3,000운행) 누적 + 룰 MAPE>20% |
| 복합운송 다중 Leg 모델 | Phase 2 | 3계층(Shipment→Stop→Event)에 Leg 계층 추가 |
| 텔레매틱스/デジタコ 연동 | Phase 2 | 벤더 API 가용·보급률 확인(R3·OQ) |
| 멀티테넌트 3PL 세분 권한 | Phase 2 | 캐리어 데이터 공유 제어 모델 확정 |
| 운임 결제·정산·팩토링(물류×금융) | Phase 2+ | 위치 데이터가 "운행 완료 증거"로 신뢰 확보 후 |
| 자체 IoT 하드웨어 트래커 | Phase 2+ | 특수 화물 한정 검토(ADR-0006 스마트폰 우선) |
| 국제 물류·B2C 라스트마일·WMS 자체·온프레/셀프호스팅·자율주행/드론·求荷求車 마켓플레이스 | 범위 밖 | 해제 계획 없음(레퍼런스만) |
6. 런치 준비 체크리스트 (제품 관점)
제품·법무·파트너·앱 차원에서 정식 출시(GA) 전에 충족돼야 할 항목이다. 기술 게이트 DoD는 §3·TRD가 소유하므로 여기서는 제품 출시 가시성에 한정한다.
| 영역 | 항목 | 현재 | 출시 전 완료 조건 |
|---|---|---|---|
| 제품/브랜드 | 가칭 → 정식 제품명 확정 | 미정 'LogiNippon' 가칭 | 정식명·상표·도메인 확정, 콘솔 ja/en/ko 라벨 반영 |
| 법무 | 규제 출력 포맷 서명(RR-LEGAL-001) | 미서명 컬럼셋·인코딩 미확정(R10) | 法務 서명 후 "監督官庁 제출 가능" 표기 허용 |
| 법무 | APPI 동의 배선·서명권자 확인 | PARTIAL consentGate ingest 미배선 | ingest consent gate 라이브 + 受取人 위치 마스킹 확인 |
| 파트너 | Phase 0 제휴 파트너 1곳 확보 | 미지정 최대 사업 의존(R1) | PoC 서명·거점 지오펜스·event_code_map 시드 완료(GATE-P0) |
| 드라이버 앱 | Flutter 드라이버 앱 GA | STUB scaffold(최대 갭) | 잡 라이프사이클·배경 GPS·동의·증빙·푸시 풀구현 + 스토어 배포 |
| 측정 | SLI 계측(OBS-METRICS-001) | 미측정 writeDataPoint TODO | Tracking Rate·dwell·OTD 계측 가동 → MVP-exit 판정 가능 |
| 포지셔닝 | 정직 노출 UI 확인 | DONE ETA 추정치·staleness 노출 | 설계 목표를 달성치로 광고하지 않음(정직=포지셔닝) |
요약. 제품은 킬러 규제 기능(荷待ち/NIMACHI)이 유일 완성이고 컨트롤타워·온보딩·컨사이니·Auth·ingest/지오펜스 엔진이 DONE이다. MVP-exit를 막는 것은 드라이버 앱(최대 갭) + 4개 서버 STUB(웹훅 전달·룰 ETA·tracking-loss sweep·rate limit) + APPI consent gate다. Phase 0 제휴(GATE-P0)가 모든 것의 하드 게이트다.
근거·상호참조
- 마스터 스펙 §9 범위·게이트 / §13 PRD→TRD 링크 규칙 / §14 as-built 제품 사실 / §15 페이지 브리핑 —
prd/.build/master-spec.md - techspec 로드맵(Phase 0/1/2·비목표 해제 매핑·게이트 원칙) —
techspec/roadmap.md - techspec 목표·비목표·MVP 범위·Exit Criteria —
techspec/00-overview/goals-nongoals.md - TRD 단계 게이트·로드맵(게이트 DoD 소유): phase-gates-roadmap — GATE-P0 · GATE-P1
- TRD 기능 요구사항: functional (FR-ACQ-*·FR-ENG-*·FR-RPT-*·FR-DLV-*·FR-GEO-*·FR-PROV-*·FR-INGEST-*)
- TRD 규제: RR-LEGAL-001 · RR-JITSUUNSO-001 · SLO: SLO-S3 / SLO-S7 / SLO-S8 · KPI: KPI-TRACK-001 / KPI-ETA-001 · GTM: monetization-gtm
- PRD 교차: scope-nongoals(GOAL-*/NG-*) · epics-stories(EPIC-*/US-*) · journeys(JRN-*) · success-metrics-kpi · risks-open-questions(PR-*/OQ-*) · gtm-pricing
- 본 페이지 소유 ID:
REL-0·REL-1·REL-2(라이트). 모든 KPI/SLO 목표는 진입 단계 설계(달성치 아님).