Claim과 reservation은 무엇이 다른가

reservation = 자원을 예약 중이라는 표시
claim       = 자원을 예약 중이라는 표시 + token으로 증명되는 확정 권한

counter-3은 누군가 예약 중이다.

counter-3은 token abc를 가진 작업이 예약 중이다.
최종 배정도 token abc가 맞아야 가능하다.

type CounterClaim = {
  counterId: string;
  customerId: string;
  token: string;
  expiresAt: string;
};

const claim = await claimCounter('counter-3', 'customer-A');
// claim.token = 'abc'

async function finalizeCounterAssignment(claim: CounterClaim) {
  const currentClaim = await getCounterClaim(claim.counterId);
 
  if (!currentClaim) {
    throw new Error('claim expired');
  }
 
  if (currentClaim.token !== claim.token) {
    throw new Error('claim lost');
  }
 
  await assignCustomerToCounter(claim.customerId, claim.counterId);
  await deleteCounterClaim(claim.counterId);
}

내가 예전에 counter-3을 예약했다는 사실만으로는 부족하다.
지금 저장소의 counter-3 claim token이 내가 가진 token과 같아야 확정할 수 있다.

1. A가 counter-3을 claim한다. token = abc
2. A 작업이 오래 걸린다.
3. A의 claim TTL이 만료된다.
4. B가 counter-3을 새로 claim한다. token = xyz
5. A가 뒤늦게 finalize를 시도한다.

counterId: counter-3
customerId: customer-A
token: abc

counterId: counter-3
customerId: customer-B
token: xyz

if (currentClaim.token !== claim.token) {
  throw new Error('claim lost');
}

A: 내가 counter-3 예약했었으니 확정할게.
저장소: 지금 counter-3 claim token은 xyz다. 너의 abc는 오래된 claim이다.

claim 생성 -> 준비 작업 -> token 확인 -> 최종 배정

const claim = await claimCounter('counter-3', 'customer-A');
 
await prepareCounter(claim.counterId);
 
await finalizeCounterAssignment(claim);

claim token이 맞다    -> 최종 배정 성공
claim이 없다          -> TTL 만료 또는 release됨
claim token이 다르다  -> 다른 작업이 새 claim을 획득함

후보 예약 -> 오래 걸리는 작업 -> token이 아직 맞으면 finalize

await updateRow({
  id,
  expectedVersion: version
});

await finalizeAssignment({
  counterId,
  expectedToken: claim.token
});

reservation = 자리 맡음
claim       = 자리 맡음 + 내가 맡은 사람이라는 token 증명 + 그 token으로만 최종 확정 가능