Provider / Backend Decision

APP mock UX 이후 provider-ready로 승격할 결정 목록

빨간 placeholder는 미구현 화면 목록이 아니라, 실제 backend 또는 native provider가 정해져야 provider-ready로 승격할 영역입니다. 현재 APP은 provider-pending, fallback, disabled reason, retry/offline surface로 사용자가 볼 수 있는 상태까지 닫았습니다.

Policy: docs/MOBILE_PROVIDER_POLICY.md Matrix: docs/MOBILE_FIGMA_NODE_COVERAGE_MATRIX.md Status: decision backlog

Realtime chat

Decision

transport, backend read-state, pagination persistence.

Upload / OCR

Decision

S3/presigned upload, OCR engine, offline queue persistence.

External handoff

Decision

고객센터 URL/auth handoff, phone dialer, map deep link.

Auth / RBAC

Decision

session provider, backend authorization, role approval policy.

현재 APP에서 이미 닫힌 사용자 경험

무동작 CTA 방지

provider가 없는 CTA는 숨기지 않고 provider-pending, disabled reason, fallback 중 하나로 귀결합니다.

mock-first 검증

채팅, 파일/OCR, 지도, 전화, 고객센터는 실제 외부 앱을 열지 않아도 Maestro와 screenshot evidence로 화면 상태를 검증합니다.

backend 계약 대기

Kotlin Spring API, realtime transport, upload body, signed URL, read-state persistence가 정해지면 adapter 구현으로 승격합니다.

구현 금지선

provider 선택 전 임의 deep link, 임의 realtime protocol, 임의 upload body, 임의 auth/session shape는 만들지 않습니다.

화면 evidence

chat provider pending surface — **Chat provider pending**
첨부/전화 provider 없이도 대기 상태와 disabled CTA를 노출.

processor OCR offline state — **Upload/OCR offline**
실제 OCR provider 전에도 offline/retry branch를 설명.

driver OCR result — **Driver OCR result**
운전자 계근 OCR 결과를 mock provider-state로 검증.

customer support provider pending — **Customer support**
고객센터 URL 결정 전 provider-pending screen.

driver map fallback — **Map fallback**
외부 지도 앱 실행 전 fallback surface.

auth RBAC invalid role boundary — **Auth/RBAC boundary**
실제 auth 전에는 invalid role fallback과 boundary 문서가 기준.

provider-ready 승격 전 확인할 계약

영역	현재 APP 상태	승격에 필요한 결정	관련 local report
Realtime chat	`Chat` wrapper, mock room/list/detail/send/read-state, attachment pending	transport protocol, read receipt persistence, backend pagination, upload adapter	`common-chat/index.html`
Upload / OCR	driver/processor proof upload, pending/error/offline/retry, OCR confirm	S3 또는 동등 provider, presigned body, OCR engine, confidence schema, offline queue	`driver-transport/index.html`, `processor-weighing/index.html`
External CTA	고객센터 provider-pending, phone disabled CTA, map fallback	URL/auth handoff, phone masking/audit, map provider/deep link policy	`external-cta-more/index.html`
Backend/Auth/RBAC	role onboarding, invalid role fallback, mock boundary 문서	session provider, approval flow, server authorization, RBAC response envelope	`backend-auth-boundary/index.html`
Operational exceptions	dispatcher conflict/cancel/reassign mock, processor replay/idempotency pending	conflict envelope, idempotency persistence, concurrency/replay policy	`operational-edge-cases/index.html`