규제 출력 명세 (RR-*) — 킬러 피처

요구. 시스템은 한 테넌트·기간에 대해 청부 계층(carrier.tier + carrier.parent_carrier_id 체인)을 元請→실운송 단까지 따라가 실운송 사업자 명칭·계층·실제 운송 차량·기간을 담은 実運送体制管理簿를 반드시 생성해야 한다(MUST). 각 행의 "실제 운송 차량"은 해당 화물에 실시간 위치 핑이 실제로 도착한 차량으로 검증되어야 한다(MUST) — 장부상 청부와 물리적 운송의 불일치를 표면화한다.

수용기준

• Given tier=SUB2이고 parent_carrier_id가 SUB1→PRIME으로 이어지는 화물, When GET /v1/reports/jitsuunso?from=&to= 호출, Then 응답 산출물의 1행은 元請·下請·孫請 3단과 실운송(孫請) 사업자 명칭을 포함한다.
• Given 어떤 화물의 실운송 단에 검증 핑이 0건, When 리포트 생성, Then 그 행은 "위치 미검증" 플래그가 표시되어 수기 대체용으로 그대로 제출 불가 상태를 명시한다(공란 위장 금지).
• Given 타 테넌트 화물, When 호출, Then 결과에 포함되지 않는다(tenant_id 스코프, 비노출 404 일관).
• Given 공식 포맷 미확정, When 산출물 헤더 생성, Then RR-LEGAL-001 법무 확인 전까지 컬럼 집합을 改正物流法 기재 항목 기준 잠정안으로 명시(라벨 추정).

요구. 시스템은 stop.dwell_minutes를 거점·운송·기간 차원으로 집계하고, 각 거점에 대해 평균(mean)과 p90을 산출하며, 법정 임계 120분(FR-ENG-EXC-002 荷待ち 초과; geofence.dwell_threshold_min 테넌트 override)을 초과한 건을 반드시 플래그해야 한다(MUST). 산출물은 Excel(JP)이 日本語 시설명을 깨짐 없이 여는 인코딩이어야 한다(RR-CSV-001).

수용기준

• Given dwell_minutes=143이고 임계 120인 stop, When 荷待ち 리포트 생성, Then 그 행은 threshold_min=120 AND exceeded=1로 표기된다.
• Given 한 거점의 dwell 분포, When 집계, Then 출력은 mean과 p90을 함께 노출한다(평균만으로 꼬리를 숨기지 않음).
• Given captured_at 오프셋이 +09:00 외로 혼재, When 기간 필터, Then datetime() 정규화로 JST 자정 경계 비교가 정확하다(DM-TS-001).
• Given 같은 (tenant, from, to) 재요청, When 생성, Then 결정적 report_id/r2_key로 누적 없이 덮어쓴다.

요구. 시스템은 드라이버/차량별 운행·체류 타임스탬프(event.occurred_at, stop.actual_arrival_at/actual_departure_at)를 연 3,400h/시간외 960h 상한 맥락에서 검토 가능한 구속시간 보조 데이터로 권장 출력한다(SHOULD). 이는 노무관리 산정의 객관 입력이지 산정 자체가 아님을 산출물에 명시해야 한다(MUST — 책임 경계).

수용기준

• Given 한 드라이버의 한 기간 운행, When 구속시간 데이터 export, Then 각 운행의 시작·종료·각 거점 체류(분)가 결손 없이 타임스탬프로 노출된다.
• Given 산출물, When 헤더/주석 생성, Then "전용 노무관리 대체 아님, 보조 데이터" 고지와 3,400h/960h 맥락 라벨을 포함한다.
• Given 타임스탬프 결손 행, When 집계, Then 누락이 명시되어 구속시간이 과소 산정되지 않도록 경고한다.

요구. 시스템은 規制 CSV를 기본 UTF-8 BOM + CRLF로 생성해야 한다(MUST — Excel-JP 호환). 監督官庁 제출 양식이 Shift_JIS를 요구함이 법무로 확인되면, 그 산출물에 한해 Shift_JIS 변형을 권장 추가한다(SHOULD). 어떤 변형이든 셀 formula-injection 가드(^[=+\-@\t\r] 접두 ')와 RFC-4180 인용 규칙을 유지해야 한다(MUST).

수용기준

• Given 日本語 시설명("○○物流センター"), When 화주가 Excel-JP로 산출 CSV를 연다, Then 文字化け(모지바케) 없이 표시된다(BOM 검증).
• Given 셀 값이 =cmd로 시작, When CSV 생성, Then 셀은 '=cmd로 무력화되어 수식 실행되지 않는다.
• Given 監督官庁 양식이 Shift_JIS 요구로 확인(법무), When 해당 kind 생성, Then Shift_JIS 변형이 동일 행 데이터로 제공된다(미확인 시 기본 UTF-8 유지).

요구. 규제 리포트는 명시적 상태머신 PENDING → READY → FAILED를 가져야 한다(MUST): Cron/요청이 생성을 시작하면 PENDING, R2 PUT + D1 메타 커밋 성공 시 READY, 집계·PUT 실패 시 FAILED(사유 기록). 메타는 D1 regulatory_report(kind ∈ {JITSUUNSO_KANRIBO, NIMACHI_RECORD, KOSOKU_TIME})에 저장하고, 파일은 R2 EXPORTS에 r2_key로 저장한다(MUST). 다운로드는 TTL 300s 서명 URL로만 노출한다(MUST — FR-RPT-RANGE-001 정합).

수용기준

• Given 생성 시작, When R2 PUT + D1 INSERT 성공, Then 상태=READY이고 generated_at이 채워지며 다운로드 URL이 반환된다.
• Given 집계 중 예외, When 생성, Then 상태=FAILED로 기록되고(반쪽 산출물을 READY로 노출하지 않음), Cron 루프는 타 테넌트로 계속 진행한다.
• Given Cron 0 17 * * * 발화, When 전 테넌트 순회, Then 각 테넌트의 전일(JST) 荷待ち 리포트가 R2+D1에 적재된다.
• Given READY 리포트, When 다운로드 요청, Then 서명 URL TTL 300s가 적용되어 만료 후 접근 불가하다.

요구. 규제 리포트의 각 집계 행은 그것을 구성한 원천(stop.stop_id / shipment.shipment_id / 관련 event.event_id)으로 되짚을 수 있어야 한다(MUST). 시스템은 어느 stop·event가 어느 regulatory_report 집계에 들어갔는지 감사 추적(audit trail)을 제공해야 한다(MUST). 荷待ち CSV는 이미 행 단위로 shipment_id를 노출하므로 행→화물 역추적이 가능하다.

수용기준

• Given 한 荷待ち 리포트 행, When 감사자가 출처를 질의, Then 그 행의 shipment_id·stop(arrival/departure)·임계가 원천 stop/event로 결정적으로 연결된다.
• Given 동일 (tenant, from, to) 재생성, When 원천 이벤트가 불변(immutable, DM-SCHEMA-001), Then 재생성 산출물이 이전과 동일하다(재현성 = 감사 신뢰).
• Given 집계에 포함된 stop, When 추적, Then 누락·중복 없이 1:1 매핑이 검증된다.

요구. 규제 산출물의 공식 형식이 미확정인 모든 항목(実運送体制管理簿 공식 컬럼 집합, 監督官庁 제출 인코딩/양식, 보존기간 법정 최소)은 출시 전 법무 서명을 받아야 한다(MUST). 법무 확인 전 산출물은 라벨 추정으로 표시되고 "공식 제출 가능"으로 광고되지 않는다(MUST).

수용기준

• Given 実運送体制管理簿 컬럼 집합, When 출시 게이트 점검, Then 改正物流法 公式 기재 항목과 대조한 법무 확인 기록이 존재한다(없으면 추정 유지).
• Given CSV 인코딩(RR-CSV-001·OD-004), When 監督官庁 제출 경로 활성화, Then Shift_JIS/UTF-8 결정이 법무로 확정되어 있다.
• Given 보존기간, When RET-* 적용, Then 規制 산출물 7년(RET-REG-001)이 법정 최소로 법무 서명되어 있다.