DispatchGuard - 현장 배차 안정성

DispatchGuard는 QA 리스크를 중심에 둔 현장 배차 엔드투엔드 사례입니다. 정상 흐름만 만들지 않고 동시 배정, 오래된 오프라인 작업, 자격 규칙, 재시도, 시간대 경계처럼 실제로 흐름을 깨뜨리기 쉬운 부분부터 다뤘습니다.

완료 v1.0 완료 · v1.1 보강 검증 완료 소스 비공개 · 아키텍처와 검증 근거 공개
  • TypeScript
  • PostgreSQL
  • Playwright
  • 오프라인 동기화
  • 동시성
  • RCA / ADR

서버 검사

185 / 185

이번에 확인한 v1.1 근거 스냅샷에서 모두 통과했습니다.

브라우저 근거

23개 통과

또한 5개 Playwright 프로젝트에서 의도적으로 건너뛴 검사 72개를 별도로 기록하고, 각 항목에 이유를 남겼습니다.

결정 기록

ADR 6건 · RCA 4건

아키텍처 선택과 문제 재현 과정을 따라가며 확인할 수 있습니다.

배포 범위

tailnet 전용

최소 실행 가능한 OCI 배포는 비공개 네트워크에서 확인했으며 공개 운영 서비스로 포장하지 않습니다.

이 프로젝트를 만든 이유

정상 흐름만 보여 주면 배차 소프트웨어는 실제보다 단순해 보입니다. 두 사용자가 거의 동시에 같은 기술자를 배정할 수 있고, 오프라인 기기는 나중에 오래된 상태를 기준으로 한 작업을 다시 보낼 수도 있습니다.

이 실패 경로들을 설계의 중심에 두고 재현, 설계 결정, 수정, 회귀 테스트, RCA를 연결했습니다. 저장소를 공개하지 않아도 검토자가 판단 과정을 따라갈 수 있게 했습니다.

주요 엔지니어링 및 QA 결정

데이터베이스에서 불변 조건 보호

언제든 오래될 수 있는 화면의 가용 상태에 기대지 않고, 동시 쓰기가 실제로 만나는 지점에서 중복 배정을 막습니다.

오프라인 작업 재처리를 명확하게 설계

멱등성 키, 재시도 규칙, 명확한 충돌 결과로 재연결 후 작업이 조용히 중복되거나 덮어쓰이지 않게 했습니다.

이상적인 달력이 아닌 현지 경계 테스트

자격과 배정 규칙뿐 아니라 뉴질랜드 서머타임 전환도 다뤄 날짜·시간 가정이 비즈니스 로직에 새어 들지 않게 했습니다.

설명 가능한 근거

저장소는 비공개이지만 프로젝트 설명을 스크린샷 한 장과 도구 목록으로 끝내지 않습니다.

  • 동시성 결함 4종에 대한 수정 전 실패와 수정 후 통과 근거
  • 일관성, 동기화, 배포 선택을 다룬 아키텍처 결정 기록
  • 증상, 재현, 수정, 회귀 방지를 잇는 원인 분석 기록
  • 실제 실행 항목과 사유가 있는 의도적 skip을 구분한 Playwright 결과

이 사례가 주장하지 않는 것

이 한계는 나중에 붙인 면책 문구가 아니라 사례 자체의 일부입니다.

  • 회사, 현장 데이터, 뉴질랜드 전기 서비스 시나리오는 합성 자료이며 EWRB나 업계의 보증을 뜻하지 않습니다.
  • 배포 근거는 비공개 tailnet에 한정됩니다. 공개 운영 서비스나 실제 고객 사용을 주장하지 않습니다.
  • 세션 인증은 포트폴리오 범위에는 맞지만 운영급 인증 인프라로 소개하지 않습니다.
  • Playwright WebKit 근거는 아직 끝나지 않은 실기기 Safari 매트릭스를 대신하지 않습니다.

소스는 비공개, 작업은 검토 가능

실제 채용 절차에서는 저장소를 공개하지 않고도 아키텍처, RCA, 테스트 근거를 설명할 수 있습니다.