KBX v9 Production Readiness

목적

v9는 새 화면 문법을 추가하는 버전이 아니라, 기존 KBX 화면이 실제 운영에서 실패·지연·동시수정·네트워크 장애를 만났을 때 사용자에게 거짓 성공이나 불명확한 상태를 보여주지 않도록 하는 운영 UX 계층이다.

정상/지연/실패/읽기전용을 숨기지 않는다. 시스템이 불완전한 상태면 KbxRuntimeBanner로 알려준다.
오래된 값은 최신 값처럼 보이지 않게 한다. 중요한 Projection은 observedAt을 내려주고 KbxFreshnessIndicator로 표현한다.
동시수정은 자동 덮어쓰지 않는다. version conflict는 KbxConflictResolver로 최신 값을 다시 확인하게 한다.
3초 이상 걸리는 대량 업무는 사용자를 화면에 묶어두지 않는다. Operation Run으로 승격하고 작업센터에서 추적한다.
완료·부분실패·운영주의는 Notification Center에 남긴다. Toast만으로 장시간 작업 결과를 전달하지 않는다.
예상치 못한 오류에는 Correlation ID를 제공한다. 사용자는 기술 Stack Trace 대신 지원팀에 전달 가능한 참조번호를 본다.
Mutation 자동 Retry는 Idempotency가 확보된 경우만 허용한다. UI disable은 중복방지 수단이 아니다.

Excel Import, 대량 출고지시, 대량 동기화처럼 foreground 3초를 안정적으로 넘는 작업은 kbx.operation_runs에 등록한다.

사용자가 페이지를 닫더라도 PostgreSQL 상태가 Source of Truth이며, SignalR은 실시간 갱신 채널일 뿐이다.

Read Projection은 업무 중요도에 따라 observedAt과 staleAfterSeconds를 전달할 수 있다. stale 기준은 화면마다 임의 지정하지 않고 업무군 정책으로 관리한다.

권장 출발값:

이 수치는 절대 규칙이 아니라 현장 Telemetry로 조정하는 초기 기준이다.

사용자에게 노출하는 정보:

일반 사용자에게 노출하지 않는 정보:

kbx.operation_runs, kbx.user_notifications, kbx.runtime_incidents는 운영 Projection이다. 주문·재고·피킹과 같은 업무 진실을 이 테이블에서 변경하지 않는다.