입시 컨설팅 CRM

왜 어려웠나

같은 매칭 화면에 정반대 증상 두 개가 섞여 있었어요. 막혀야 할 중복은 통과하고, 지난 시간대 잠금 때문에 정상 매칭은 막혔어요. 시간대를 점유했는지 판단하는 코드도 여러 곳에 흩어져 있었어요.

추적 과정

1. 1. 예약 가능 시간은 무엇을 점유로 볼까?

   예정, 진행 중, 완료 상태의 상담만 점유로 봤어요.

2. 2. 예약 쪽은 무엇을 점유로 볼까?

   결제를 기다리는 중이거나 확정된 예약만 봤어요. 결제는 끝났지만 아직 매칭 전인 상태는 어느 쪽에서도 점유로 세지 않았어요.

3. 3. 매칭을 확정할 때는 확인할까?

   확정 단계에는 충돌 검사 자체가 없었어요.

4. 4. 운영에서 왜 막혔는지 어떻게 보여 줄까?

   막힌 이유를 단계별로 출력하는 읽기 전용 진단 명령을 만들어, 데이터를 바꾸지 않고 원인을 확인했어요.

원인

점유 상태 목록에서 결제 완료부터 매칭 대기까지의 상태가 빠져 있었고, 매칭을 확정할 때 충돌을 검사하지 않았어요.

해결

결제 완료부터 진행 중까지를 점유 상태로 정의하고, 매칭을 확정할 때 같은 컨설턴트의 점유 상담과 살아 있는 예약이 앞뒤 여유 시간을 포함해 겹치는지 검사해요. 겹치면 '이미 예약된 시간'으로 거부해요.

confirm_matching(consultation, consultant, time):
    save()                                  # 충돌 검사 없음

HOLDING = {결제 완료, 설문 단계, 매칭 대기, 매칭됨, 승인, 예정, 진행 중}
conflict = any(other.consultant == consultant
               and other.status in HOLDING
               and overlaps_with_buffer(time, other)
               and other != consultation)
        or any(살아 있는 예약이 겹침, 본인 예약 제외)
if conflict: raise "이미 예약된 시간"

왜 어려웠나

증상은 모두 '예약 정보가 이상하다'로 비슷했지만 원인은 넷이었어요. 특히 시간대 버그는 값은 그대로 두고 표기만 UTC로 바뀌어서, 저장된 값만 봐서는 틀린 줄 알기 어려웠어요.

추적 과정

1. 1. 소요시간을 바꾼 상품은 왜 겹칠까?

   기존 예약에 저장된 옛 소요시간(예: 30분)으로 점유 구간을 계산하고 있었어요.

2. 2. 취소한 주문의 상담은 왜 다시 생길까?

   다시 동기화할 때 '결제된 적이 있다'는 조건이 참이었고, 지운 상담은 기본 조회에서 숨겨져 '상담이 빠졌다'고 판단해 다시 만들었어요.

3. 3. 다른 옵션의 시간은 왜 들어갈까?

   첫 번째 매칭이 상품 코드만 비교했어요. 옵션 필터는 두 번째 대체 단계에만 있어서, 첫 단계에서 다른 옵션의 예약이 잡히면 옵션 검사는 돌지도 않았어요.

4. 4. 결제 시각은 왜 9시간 밀릴까?

   '+09:00'이 붙은 시각을 파싱한 뒤 표기만 UTC로 바꿨어요. 09:22 한국 시간이 09:22 UTC, 즉 한국 시간 18:22가 됐어요.

원인

결제 시각 파서가 시간대가 붙은 값을 변환하지 않고 표기만 UTC로 바꿨어요. 이 결제 시각은 날짜 필터, 정렬, 알림 문구의 결제일에 쓰여서, 한국 시간 오후 3시 이후 결제는 다음 날 결제로 보였어요.

해결

시간대가 없는 값만 UTC로 지정하고, 시간대가 있으면 UTC로 변환해요. 취소된 주문은 결제 여부와 상관없이 상담을 만들지 않아요. 상품과 옵션 필터는 모든 매칭 단계에 걸고, 점유 구간은 저장된 소요시간과 현재 상품 소요시간 중 긴 쪽으로 계산해요.

return parse(s).replace(tz=UTC)      # 09:22+09:00 -> 09:22Z (= 18:22 KST)

p = parse(s)
return p.replace(tz=UTC) if is_naive(p) else p.astimezone(UTC)

effectively_paid = not cancelled and (now_paid or paid_at)
busy_minutes = max(saved_duration, current_product_duration)