슬롯 만들기 (영업 10:00~19:00 · 30분 후보 · 시술 60분 + 정리 10분이 들어가는 칸만)
Slot generation from opening hours: 30-minute candidate starts kept only when service + buffer clears existing bookings and the service ends by closing
예약 칸을 미리 만들어 저장하지 않고 그날의 영업 시간 · 기존 예약 · 메뉴 길이로 그때그때 계산한다. 30분 간격 후보마다 [시작, 시작+60분+정리 10분)이 다른 예약의 [시작, 끝+10분)과 겹치지 않고 시술이 19:00 안에 끝나는지 검사해 통과한 시작 시각만 버튼으로 내보낸다. 정리 시간을 빼먹으면 예약이 붙어 들어오고, 마감 검사를 빼면 18:30 칸에 60분 시술이 잡힌다.
프롬프트
미용실 예약 API에 GET /slots?date=&serviceId=를 만들어줘: 영업 10:00~19:00, 30분 간격 후보 시작마다 [시작, 시작+시술 60분+정리 10분) 구간이 그날 예약들의 [시작, 끝+10분)과 겹치지 않고 시작+60분 ≤ 19:00이면 가능으로 넣고, 응답은 가능한 시작 시각 배열과 후보별 탈락 이유(overlap | after_close)로 줘. 클라이언트는 받은 배열만 버튼으로 그리고 직접 계산하지 않게 해줘.
라이브 데모 열기 — 슬롯 만들기 (영업 10:00~19:00 · 30분 후보 · 시술 60분 + 정리 10분이 들어가는 칸만)
예약 가능 범위 (지금 + 1시간 ~ 30일 뒤 · 첫 칸 = 올림(지금+60분, 30분) · 지난 칸은 숨김)
Bookable window: from one hour ahead (rounded up to the next 30-minute slot) to 30 days out, with past and too-soon slots removed rather than greyed
오늘 화면에서는 지금 시각에 60분을 더해 30분 단위로 올린 시각부터만 칸을 보여 주고, 그보다 이른 칸은 회색으로 남기지 않고 목록에서 빼서 나머지가 자리를 채운다. 끝은 오늘 + 30일이며 자정마다 하루씩 새로 열린다. 지금 시각을 기기 시계로 재면 시계가 틀린 기기에서 이미 지난 칸이 보이므로 서버 시각(오프셋 보정)으로 계산한다.
프롬프트
예약 시간 선택 화면에서 firstStart = ceil((serverNow + 60분) / 30분) × 30분을 계산해 오늘 칸 중 그 이전 것은 목록에서 빼고(150 ms 페이드 후 나머지 칸 200 ms 이동), 1분마다 다시 계산해줘. 날짜 줄은 오늘부터 30일까지만 켜고 31일째부터는 비활성 + "12/20 칸은 11/20 00:00에 열려요" 안내를 붙이고, serverNow는 응답 Date 헤더로 구한 오프셋으로 보정해줘.
라이브 데모 열기 — 예약 가능 범위 (지금 + 1시간 ~ 30일 뒤 · 첫 칸 = 올림(지금+60분, 30분) · 지난 칸은 숨김)
날짜 줄 (14일 · 쉬는 날 흐림 · 0이면 "마감" · 열 때 빈 자리 있는 첫 날 자동 선택)
Date strip: 14 days with closed days dimmed, sold-out days labelled, and the first day with availability auto-selected on open
날짜 줄은 GET /days로 14일의 영업 여부와 남은 칸 수를 한 번에 받아, 열자마자 오늘이 아니라 "영업하고 남은 칸이 있는 첫 날"을 골라 둔다. 쉬는 날은 흐리게 "휴무", 남은 칸 0은 "마감"으로 쓰고 눌러도 날짜를 바꾸지 않고 이유만 알린다. 오늘이 마감인데 오늘을 골라 두면 손님은 빈 격자부터 보고 나간다.
프롬프트
예약 화면에 14일 날짜 줄(칩 폭 64 pt, 요일 · 날짜 · 상태 세 줄)을 만들고 GET /days?from=&n=14 응답 [{date, open, left}]로 쉬는 날은 opacity .5 + "휴무", left 0은 "마감", 나머지는 "N자리"를 그려줘. 처음 열 때 open && left > 0인 첫 날을 자동 선택(작은 "자동 선택" 알약)해 그날 슬롯을 받고, 휴무 · 마감 칩을 누르면 선택은 그대로 두고 "11/24 월요일 정기 휴무" 툴팁을 1초 띄워줘.
라이브 데모 열기 — 날짜 줄 (14일 · 쉬는 날 흐림 · 0이면 "마감" · 열 때 빈 자리 있는 첫 날 자동 선택)
슬롯 버튼 상태 5종 (판정 순서 내 예약 › 마감 › 선택됨 › 1자리 › 가능 · 고른 칸이 마감되면 해제)
Slot button states from one evaluation chain — mine › full › selected › one left › open — where a selected slot that sells out is deselected with a notice
슬롯 버튼의 모양은 데이터 하나로 정해지도록 판정 순서를 고정한다: 내 예약이 있으면 "내 예약", 남은 0이면 "마감", 내가 골랐으면 "선택됨", 남은 1이면 "1자리", 그 외는 "가능"이며 첫 일치만 쓴다. 마감이 선택보다 앞이라서 고른 칸이 다른 손님에게 팔리면 선택을 풀고 토스트로 알린다. 상태마다 색에 더해 글자 · 점선 같은 모양을 붙여 색만으로 구분하지 않는다.
프롬프트
slotState(slot) = slot.mine ? "mine" : slot.left === 0 ? "full" : slot.id === selectedId ? "selected" : slot.left === 1 ? "few" : "open" 한 함수로 버튼 모양을 정해줘(높이 44 pt, 마감은 점선 테두리 + "마감", 1자리는 주황 테두리 + "1자리", 선택은 채움 + 체크). 가용성 응답에서 선택한 칸의 left가 0이 되면 selectedId를 비우고 "16:00이 방금 마감돼 선택을 풀었어요" 토스트 4초를 띄워줘.
라이브 데모 열기 — 슬롯 버튼 상태 5종 (판정 순서 내 예약 › 마감 › 선택됨 › 1자리 › 가능 · 고른 칸이 마감되면 해제)
슬롯 묶음 (오전 · 오후 · 저녁 머리 · 3열 · 버튼 114 × 44 pt · 간격 8 · 빈 묶음은 머리째 숨김)
Grouped slot grid: morning / afternoon / evening headers with counts, three 114 × 44 pt columns and 8 pt gaps, versus a flat four-column grid
하루 18칸을 4열 한 덩어리로 깔면 버튼이 작아지고(30 pt) 원하는 시간을 줄마다 훑어야 한다. 시작 시각으로 오전(< 12:00) · 오후(12:00~17:59) · 저녁(≥ 18:00)으로 나누어 머리에 칸 수를 붙이고 3열 114 × 44 pt 버튼으로 깔면 찾는 시간이 줄고 오탭이 없어진다. 칸이 하나도 없는 묶음은 빈 머리를 남기지 않고 통째로 숨긴다.
프롬프트
시간 선택 격자를 slots를 시작 시각으로 오전 < 12:00 · 오후 12:00~17:59 · 저녁 ≥ 18:00에 묶어 머리("오후 · 12칸", 13 pt)와 3열 그리드(버튼 114 × 44 pt, 간격 8 pt, 좌우 여백 16 pt)로 그려줘. 칸이 없는 묶음은 머리까지 렌더링하지 말고, 묶음 경계는 가게 시간대 기준으로 서버가 준 시각을 그대로 써줘.
라이브 데모 열기 — 슬롯 묶음 (오전 · 오후 · 저녁 머리 · 3열 · 버튼 114 × 44 pt · 간격 8 · 빈 묶음은 머리째 숨김)
메뉴에 따라 달라지는 칸 (커트 30분 14칸 · 펌 120분 8칸 · 메뉴 바꾸면 다시 받기 · 사라진 선택은 해제)
Service-dependent availability: slots are fetched per (date, duration), so switching from a 30-minute to a 120-minute service shrinks the grid and drops a now-invalid selection
가능한 칸은 날짜만이 아니라 메뉴 길이에 따라 달라지므로 (날짜, 메뉴)를 캐시 키로 삼아 메뉴를 바꿀 때마다 다시 받고, 먼저 보낸 요청은 취소한다. 같은 날 커트 30분은 14칸이지만 펌 120분은 13:00 예약 때문에 8칸뿐이라, 커트로 골라 둔 12:00이 펌에선 사라지므로 선택을 풀고 이유를 말한다. 선택을 그대로 넘기면 확정 단계에서야 실패한다.
프롬프트
메뉴 칩(커트 30분 · 펌 120분)을 바꾸면 useQuery 키 ["slots", date, serviceId]로 GET /slots를 다시 받고 이전 요청은 AbortController로 취소해줘. 응답 전에는 기존 격자를 opacity .45로 두고(300 ms 넘으면 스켈레톤), 새 목록에 selectedStart가 없으면 선택을 비우고 "12:00엔 펌 120분이 들어가지 않아 선택을 풀었어요" 토스트 4초를 띄우며 날짜 선택은 유지해줘.
라이브 데모 열기 — 메뉴에 따라 달라지는 칸 (커트 30분 14칸 · 펌 120분 8칸 · 메뉴 바꾸면 다시 받기 · 사라진 선택은 해제)
담당자 "누구나" (담당자별 빈 칸의 합집합 · 선점 때 서버가 배정 · 예약 적은 사람 → 이름순)
"Any staff" availability: the union of each stylist’s free slots, with the server assigning one person at hold time by fewest bookings, then name
담당자를 "누구나"로 두면 칸 목록은 담당자별 가능한 칸의 합집합이고, 두 사람 모두 비어 있는 칸에는 점을 붙인다. 배정은 손님이 고를 때가 아니라 선점 요청을 받은 서버가 그 칸이 빈 사람 중 그날 예약이 적은 사람 → 이름순으로 정하고, 확정 화면에 이름을 보여 준다. 배정을 확정 순간까지 미루면 "누구나" 선점 두 건이 한 사람 자리를 동시에 잡을 수 있다.
프롬프트
담당자 선택에 "누구나"를 추가하고 그때 슬롯은 staff별 가능 시작 시각의 합집합(14:00~17:30 8칸, 가능 인원 수 1~2 포함)으로 내려줘. POST /holds {start, staff: "any"}를 받은 서버는 트랜잭션 안에서 그 시간이 빈 담당자 중 당일 예약 수가 가장 적은 사람(민지 5건 · 서준 3건이면 서준, 같으면 이름순)을 골라 hold에 staffId를 넣고, 응답의 담당자 이름을 확정 화면에 "담당 서준 (자동 배정)"으로 보여 줘.
라이브 데모 열기 — 담당자 "누구나" (담당자별 빈 칸의 합집합 · 선점 때 서버가 배정 · 예약 적은 사람 → 이름순)
임시 선점 10분 (남은 시간 = 서버 만료 시각 − 보정한 지금 · 1분 남으면 주황 + 한 번 알림 · 0이면 선택 화면으로)
Ten-minute slot hold timer computed from the server’s expiresAt and a clock offset, turning orange with one announcement at one minute and returning to slot selection at zero
칸을 고르면 서버가 10분짜리 선점과 만료 시각(expiresAt)을 주고, 결제 화면 위 시계는 그 값에서 보정한 현재 시각을 빼서 매 초 다시 계산한다. 1분 남으면 띠를 주황으로 바꾸고 화면 낭독기에 한 번만 알리며, 0이 되면 결제 버튼을 끄고 "선점 시간이 끝났어요" 창에서 선택 화면으로 돌려보내 슬롯을 새로 받는다. 로컬 카운트다운을 1초씩 빼면 앱이 백그라운드에 있던 시간만큼 시계가 틀어진다.
프롬프트
결제 화면 상단에 선점 띠를 만들고 remaining = hold.expiresAt − (Date.now() + serverOffset)을 1초마다(앱 복귀 때도 즉시) 다시 계산해 "09:58 안에 결제를 마쳐 주세요"로 보여줘. remaining ≤ 60초가 되면 띠를 주황으로 바꾸고 aria-live로 "1분 남았어요"를 한 번만 알리며, 0이 되면 결제 버튼을 비활성화하고 "선점 시간이 끝났어요 · 다시 고르기" 창을 띄운 뒤 누르면 슬롯 화면으로 돌아가 GET /slots를 다시 받게 해줘.
라이브 데모 열기 — 임시 선점 10분 (남은 시간 = 서버 만료 시각 − 보정한 지금 · 1분 남으면 주황 + 한 번 알림 · 0이면 선택 화면으로)
선점 풀기 (뒤로 · 결제 실패는 즉시 DELETE · 앱 종료는 만료 10분에 서버가 · 다른 손님 화면엔 30초 안 반영)
Releasing a hold: explicit DELETE on back navigation or payment failure, server-side expiry when the app dies, and other shoppers seeing the slot reopen within 30 seconds
선점은 풀리는 길이 셋이다: 뒤로 가기와 결제 실패 · 취소는 클라이언트가 바로 DELETE를 보내고, 앱이 꺼지거나 연결이 끊기면 요청을 보낼 수 없으므로 서버가 만료 시각에 스스로 푼다. 풀린 칸은 같은 날짜를 보고 있는 다른 손님에게 푸시(실시간 채널)로 바로 알리고, 놓쳐도 30초 갱신 안에 다시 켜진다. 뒤로 가기 때 아무것도 안 보내면 그 칸은 10분 동안 아무도 못 쓴다.
프롬프트
결제 화면을 떠날 때(뒤로 · 결제 실패 · 사용자 취소) DELETE /holds/{id}를 보내고 응답을 기다리지 않게 하고, 서버는 expires_at이 지난 hold를 1분마다 정리하는 작업으로 released 처리해줘. hold가 풀리면 "slot.released {date, start}" 이벤트를 그 날짜 채널에 보내 다른 손님 화면의 칸을 "잡는 중"에서 "가능"으로 120 ms에 바꾸고, 실시간 연결이 없으면 30초마다 GET /slots로 맞춰줘.
라이브 데모 열기 — 선점 풀기 (뒤로 · 결제 실패는 즉시 DELETE · 앱 종료는 만료 10분에 서버가 · 다른 손님 화면엔 30초 안 반영)
같은 칸을 동시에 (조건부 UPDATE로 먼저 닿은 요청만 성공 · 늦은 쪽 409 → "방금 마감" + 가까운 3칸)
Two shoppers tap the same slot: a conditional update lets only the first request win, and the loser gets a 409 with the three nearest open slots offered
두 손님이 같은 칸을 거의 동시에 누르면 서버는 "아직 열려 있을 때만 바꾸는" 조건부 UPDATE 한 문장으로 판정해, 바뀐 행이 1이면 선점 성공 · 0이면 409를 돌려준다. 늦은 쪽 화면은 그 칸을 "마감"으로 바꾸고 "방금 마감됐어요"와 함께 시간 차이가 작은 순서로 가까운 칸 3개를 제안해 한 번에 다시 고르게 한다. 먼저 읽고 나중에 쓰는 코드는 두 요청을 모두 성공시켜 한 칸에 두 명을 받는다.
프롬프트
선점 API를 UPDATE slots SET held_by = $user, hold_expires = now() + 10분 WHERE id = $slot AND state = 'open' RETURNING id 한 문장으로 만들고, 영향받은 행이 0이면 409 SLOT_TAKEN과 함께 같은 날 열린 칸을 |시작 차이| 오름차순(같으면 이른 시각) 3개 넣어 돌려줘. 클라이언트는 409를 받으면 그 칸을 마감으로 바꾸고 "방금 마감됐어요" 토스트 + "가까운 시간" 시트(15:30 · 16:30 · 15:00)를 280 ms에 올려줘.
라이브 데모 열기 — 같은 칸을 동시에 (조건부 UPDATE로 먼저 닿은 요청만 성공 · 늦은 쪽 409 → "방금 마감" + 가까운 3칸)
가용성 다시 받기 (화면 진입 · 보일 때 30초마다 · 칸을 누르는 순간 선점으로 확인 · 바뀐 칸만 조용히 교체)
Availability refresh policy: fetch on screen entry, every 30 seconds while visible, and verify at tap time through the hold request, swapping only changed slots in place
예약 격자는 다른 손님 때문에 계속 낡으므로 다시 받는 때를 셋으로 정한다: 화면에 들어올 때, 화면이 보이는 동안 30초마다(백그라운드에선 멈춤), 그리고 칸을 누르는 순간 — 이때는 따로 조회하지 않고 선점 요청 자체가 확인이 된다. 다시 받은 결과는 바뀐 칸만 120 ms에 교체하고 줄을 옮기지 않으며, 누른 칸이 이미 팔렸으면 409와 함께 "방금 마감"을 알리고 목록을 새로 받는다. 낡은 캐시 먼저 보여 주기 같은 목록 캐시 원리는 피드 구현 카드를 따른다.
프롬프트
슬롯 조회에 refetchOnMount: true, refetchInterval: 30_000, refetchIntervalInBackground: false, refetchOnWindowFocus: true를 주고, 응답을 slotId로 비교해 상태가 바뀐 버튼만 120 ms 크로스페이드로 바꿔 줘(배열 순서 · 위치는 그대로). 칸을 누르면 별도 GET 없이 POST /holds를 보내 409 SLOT_TAKEN이면 그 칸을 마감으로 바꾸고 "17:00은 방금 마감됐어요 · 목록을 다시 받았어요" 안내 4초와 함께 invalidateQueries로 다시 받아줘.
라이브 데모 열기 — 가용성 다시 받기 (화면 진입 · 보일 때 30초마다 · 칸을 누르는 순간 선점으로 확인 · 바뀐 칸만 조용히 교체)
예약 확정 요청 (비관 · 멱등 키 = 선점 id · 응답 유실 10초 뒤 같은 키로 재요청 · 예약 1건)
Booking confirmation request: pessimistic, with the hold id as the idempotency key so a lost response retried after 10 seconds returns the same booking instead of creating a second one
예약 확정은 자리가 걸린 요청이라 결과를 서버 답이 온 뒤에만 그리고, 멱등 키로는 선점 id를 그대로 쓴다. 응답이 사라져 10초 뒤 같은 키로 다시 보내면 서버는 새 예약을 만들지 않고 이미 만든 BK-2611-0042를 돌려주므로, 연타 · 재전송 · 앱 재시작 어느 쪽에서도 예약은 1건이다. 버튼 상태 기계 자체는 상점 구현의 구매 버튼 카드를 따르고, 여기서는 키를 무엇으로 잡는지와 서버의 중복 처리가 핵심이다.
프롬프트
POST /bookings {holdId: "H-7731", paymentId}에 헤더 Idempotency-Key: H-7731을 넣고, 서버는 bookings.hold_id UNIQUE로 INSERT … ON CONFLICT (hold_id) DO NOTHING RETURNING을 한 뒤 비어 있으면 기존 예약을 조회해 같은 200 {bookingNo: "BK-2611-0042"}를 돌려주게 해줘. 클라이언트는 첫 탭에 버튼을 잠그고 10초 무응답이면 같은 키로 1 → 2 → 4초 재시도(최대 3회)한 뒤 완료 화면에 예약 번호를 보여줘.
라이브 데모 열기 — 예약 확정 요청 (비관 · 멱등 키 = 선점 id · 응답 유실 10초 뒤 같은 키로 재요청 · 예약 1건)
좌석 상태 5종 (판정 판매 › 잡는 중 › 내 선택 › 가능 · 시야 제한은 덧표시 · 모양 + 색)
Seat states for a small theatre: sold › held by others › my selection › open, with restricted view as an overlay flag, each drawn with shape as well as colour
소극장 좌석 한 칸의 모양은 서버 좌석표(판매 · 남의 잠금)와 내 선택 목록, 좌석 속성(시야 제한)을 합쳐 판매 › 잡는 중 › 내 선택 › 가능 순서로 정하고, 시야 제한은 상태가 아니라 모서리 표시로 덧붙여 고를 수는 있게 한다. 잡는 중은 빗금, 판매는 ×, 선택은 체크처럼 모양을 달리해 색만으로 구분하지 않으며, 남의 잠금이 만료되면 변경분을 받아 그 칸만 가능으로 되돌린다. 좌석 맵 그림과 가격 등급은 여행 앱 좌석 카드를 따른다.
프롬프트
좌석 컴포넌트를 seatState = sold ? "sold" : heldByOther ? "held" : mine ? "selected" : "open"으로 정하고 restrictedView는 별도 플래그로 모서리 주황 삼각형을 덧그려줘(판매 = 진회색 + ×, 잡는 중 = 빗금, 선택 = 채움 + 체크, 좌석 최소 크기 확대 후 44 pt). 시야 제한 좌석을 누르면 "기둥이 무대 오른쪽 일부를 가려요 · 그래도 선택" 시트를 띄우고, 좌석표는 version 번호로 변경분만 받아 바뀐 좌석만 120 ms에 교체해줘.
라이브 데모 열기 — 좌석 상태 5종 (판정 판매 › 잡는 중 › 내 선택 › 가능 · 시야 제한은 덧표시 · 모양 + 색)
좌석 잠금 (누르면 바로 잠금 요청 · pending 표시 · 409면 250 ms 안에 되돌림 · 한 번에 최대 4석은 요청 전에 막기)
Per-seat locking: each tap sends a lock request while the seat shows pending, a 409 rolls it back within 250 ms with a reason, and the four-seat cap is enforced before any request
좌석을 누르면 화면은 바로 pending(작은 스피너)으로 바꾸고 좌석마다 잠금 요청을 하나씩 보내, 성공하면 내 선택이 되고 다른 손님 화면에는 "잡는 중"으로 나타난다. 이미 남이 잡은 좌석이면 409를 받아 250 ms 안에 되돌리고 이유를 토스트로 말하며, 한 번에 4석을 넘기는 탭은 서버에 보내지 않고 화면에서 바로 막는다. 결제는 잠금에 성공한 좌석만 가능하고 잠금 시간은 슬롯 선점과 같은 10분 시계를 쓴다.
프롬프트
좌석 탭마다 POST /locks {showId, seatId}를 보내고 응답 전에는 좌석을 pending(채움 45 % + 스피너)으로 그려줘. 200이면 selected, 409 SEAT_LOCKED면 250 ms 안에 원래 상태로 되돌리며 좌석을 0.3초 흔들고 "방금 다른 손님이 잡았어요" 토스트 4초를 띄우고, 잠금 성공은 공연 채널로 "seat.locked"를 보내 다른 화면에서 빗금 "잡는 중"이 되게 해줘. 이미 4석이면 요청 없이 "한 번에 최대 4석이에요"만 보여줘.
라이브 데모 열기 — 좌석 잠금 (누르면 바로 잠금 요청 · pending 표시 · 409면 250 ms 안에 되돌림 · 한 번에 최대 4석은 요청 전에 막기)
한 칸 띄움 금지 (선택 뒤 줄의 빈 칸 묶음 길이 1 → 경고 + 옆으로 옮기기 제안 · 통로 · 벽도 경계)
No-single-gap rule: after selection, any run of exactly one empty seat bounded by sold seats, the selection or the aisle triggers a warning with a one-tap shift suggestion
좌석을 다 고르면 그 줄을 빈 칸 묶음(run)으로 나눠 길이 1인 묶음이 새로 생겼는지 검사하고, 있으면 "3번 좌석이 혼자 남아요"와 함께 선택을 한 칸 옮기는 제안을 띄운다. 통로와 벽도 경계로 세므로 줄 끝 한 칸이 남는 경우도 잡으며, 줄에 1석만 남았거나 요청 인원으로는 피할 수 없을 때는 예외로 둔다. 이 검사가 없으면 혼자 남은 좌석이 공연마다 팔리지 않고 쌓인다.
프롬프트
findRuns(row)로 한 줄을 빈 칸 묶음 [시작, 끝]으로 나누고 선택 직후 길이 1 묶음이 있으면 시트("3번 좌석이 혼자 남아요 · 옆으로 한 칸 옮길까요?", 주 버튼 "3·4번으로 옮기기", 보조 "이대로 다시 고르기")를 280 ms에 올려줘. 통로 · 벽을 경계로 세고, 남은 빈 좌석이 1석뿐이거나 인원 수로 피할 수 없는 경우는 통과시키며, 제안을 누르면 기존 잠금 2석을 풀고 새 2석을 잠그는 요청을 하나로 묶어 보내줘.
라이브 데모 열기 — 한 칸 띄움 금지 (선택 뒤 줄의 빈 칸 묶음 길이 1 → 경고 + 옆으로 옮기기 제안 · 통로 · 벽도 경계)
정원이 있는 수업 (남은 = 정원 − 확정 − 선점 · 인원 최대 = min(남은, 1인 4) · 줄면 자동으로 낮춤 · 0이면 대기)
Capacity-limited class booking: remaining = capacity − booked − held, the party stepper caps at min(remaining, 4), shrinks with a notice when seats vanish and turns into a waitlist button at zero
정원이 있는 수업은 남은 자리를 정원 − 확정 − 다른 손님의 선점으로 계산해 보여 주고, 인원 스테퍼의 최대는 남은 자리와 1인 한도 4 중 작은 값이며 막힌 + 옆에 "남은 자리 3명까지"처럼 이유를 붙인다. 고르는 동안 남은 자리가 줄면 인원을 자동으로 낮추고 알리며, 0이 되면 스테퍼를 끄고 예약 버튼을 "대기 걸기"로 바꾼다. 선점 중인 자리를 빼지 않으면 확정 단계에서야 자리가 없다는 답을 받는다.
프롬프트
수업 상세에 정원 막대(12칸: 확정 = 진회색, 선점 = 빗금, 남은 = 테두리)와 "남은 3 / 12"를 그리고 remaining = capacity − booked − held, maxParty = Math.min(remaining, 4)로 스테퍼를 막아줘. class.updated 이벤트로 remaining이 선택 인원보다 작아지면 인원을 remaining으로 낮추고 "남은 자리가 2로 줄어 인원을 2명으로 바꿨어요" 안내를 2초 띄우며, remaining이 0이면 스테퍼를 비활성화하고 버튼을 "대기 걸기"(외곽선)로 바꿔줘.
라이브 데모 열기 — 정원이 있는 수업 (남은 = 정원 − 확정 − 선점 · 인원 최대 = min(남은, 1인 4) · 줄면 자동으로 낮춤 · 0이면 대기)
취소 수수료 표시 (24시간 전까지 무료 · 이후 결제 × 50 % 원 단위 버림 · 시작 뒤 취소 불가 · 버튼에 금액)
Cancellation fee display: free until 24 hours before, 50 % of the paid amount (truncated to the won) afterwards, no cancellation after start, with the amount on the button and a server-side calculation
취소 창은 지금 시각이 정책 구간 어디에 있는지 띠로 보여 주고, 수수료와 환불 예정액을 계산해 버튼 문구에 금액을 넣는다(무료로 취소하기 → 수수료 19,250원 내고 취소). 계산 기준은 서버가 요청을 받은 시각이며, 창을 열어 둔 채 24시간 경계를 넘으면 화면 금액을 다시 계산하고 확정 금액은 응답 값으로 덮는다. 금액 계산 순서와 끝수 처리 원리는 장바구니 구현 카드를 따르고, 취소 · 환불 규정은 나라와 업종마다 다르며 숫자는 가상 예시다.
프롬프트
예약 취소 시트에 오늘 → 11/21 15:00(24시간 전) → 11/22 15:00(시작) 정책 띠와 현재 시각 표시를 그리고, fee = remaining ≥ 24h ? 0 : remaining > 0 ? Math.floor(paid × 0.5) : null(취소 불가)로 결제 38,500원이면 수수료 19,250원 · 환불 19,250원을 보여줘. 버튼 문구에 금액을 넣고, 1분마다와 경계 시각에 다시 계산해 금액이 바뀌면 그 줄을 0.8초 강조하며, POST /bookings/{id}/cancel 응답의 fee가 화면과 다르면 확인 창을 한 번 더 띄워줘.
라이브 데모 열기 — 취소 수수료 표시 (24시간 전까지 무료 · 이후 결제 × 50 % 원 단위 버림 · 시작 뒤 취소 불가 · 버튼에 금액)
예약 변경 순서 (새 칸 선점 → 한 요청으로 옮기기 → 옛 칸은 서버가 놓음 · 실패하면 옛 예약 유지)
Reschedule ordering: hold the new slot first, then move the booking in one transactional request that releases the old slot, so any failure leaves the original booking intact
변경을 "옛 예약 취소 → 새 칸 예약"으로 만들면 새 칸이 그사이 팔렸을 때 두 자리를 다 잃는다. 새 칸을 먼저 선점하고, 선점에 성공했을 때만 한 요청(트랜잭션 1번)으로 예약의 시간을 새 칸으로 바꾸며 옛 칸은 서버가 같은 트랜잭션에서 놓는다. 새 칸 선점이 409면 옛 예약은 그대로 두고 다른 칸을 고르게 하며, 예약 번호는 바뀌지 않고 상태만 "변경됨"이 된다.
프롬프트
예약 상세의 "변경"을 ① POST /holds {start: 새 칸} → ② PATCH /bookings/BK-2611-0042 {holdId} 순서로 만들고, 서버는 ②를 한 트랜잭션에서 새 hold를 예약으로 바꾸고 옛 슬롯을 open으로 되돌리며 status를 rescheduled로 바꿔줘. ①이 409면 옛 예약은 건드리지 말고 "11:00은 마감됐어요 · 지금 예약은 그대로예요" 안내와 가까운 칸을 보여 주고, 변경 횟수는 예약당 2회까지로 제한해줘.
라이브 데모 열기 — 예약 변경 순서 (새 칸 선점 → 한 요청으로 옮기기 → 옛 칸은 서버가 놓음 · 실패하면 옛 예약 유지)
겹침 방지는 서버에서 (같은 담당자 · [시작, 끝 + 정리 10분) 겹치면 저장 거부 · DB 제외 제약 · 409 + 다음 가능 시각)
Server-side double-booking guard: an exclusion constraint on staff and [start, end + 10-minute buffer) rejects overlapping bookings that each passed a stale screen check
앱 손님과 가게 전화 예약처럼 서로 다른 시작 시각이라도 시간이 겹치면 같은 담당자에게 두 건이 들어갈 수 있고, 각 화면은 몇 분 전 일정을 보고 "비어 있음"이라 판단하므로 화면 검사만으로는 막지 못한다. 담당자와 [시작, 끝 + 정리 10분) 구간이 겹치는 행을 DB 제외 제약으로 거부하면 늦게 온 저장이 409로 실패하고, 서버는 다음 가능 시각(15:10)을 함께 돌려준다. 같은 칸을 동시에 누르는 경쟁과 달리 시작 시각이 다른 겹침까지 잡는다.
프롬프트
PostgreSQL bookings 테이블에 btree_gist를 켜고 EXCLUDE USING gist (staff_id WITH =, tstzrange(start_at, end_at + interval '10 min') WITH &&) WHERE (status <> 'cancelled') 제약을 추가해줘. 앱 예약 · 관리자 전화 예약 · 변경 API가 모두 이 테이블에 쓰게 하고, 제약 위반(23P01)은 409 OVERLAP {nextFree: "15:10"}으로 바꿔 화면이 "민지 님은 14:30~15:00에 예약이 있어요 · 15:10부터 가능"을 보여 주게 해줘.
라이브 데모 열기 — 겹침 방지는 서버에서 (같은 담당자 · [시작, 끝 + 정리 10분) 겹치면 저장 거부 · DB 제외 제약 · 409 + 다음 가능 시각)
내 예약 목록 (다가오는: 시작 빠른 순 · 오늘 것 맨 위 + 남은 시간 · 끝나면 지난 탭으로 · 상태 알약 4종)
My bookings list: upcoming sorted by start with today pinned and counting down, finished bookings moving to the past tab, and four status pills with words
내 예약은 다가오는 · 지난 두 탭으로 나누고, 다가오는 탭은 시작 시각이 빠른 순이되 오늘 예약은 맨 위에 강조하며 "2시간 뒤 → 25분 뒤 → 진행 중"처럼 남은 시간을 붙인다. 끝 시각(시작 + 시술 길이)이 지나면 그 줄을 지난 탭 맨 위로 옮겨 "완료"로 바꾸고, 지난 탭은 최근 순이며 취소도 함께 보여 준다. 상태는 확정 · 변경됨 · 취소 · 완료 네 알약에 글자를 넣어 색만으로 구분하지 않는다.
프롬프트
내 예약 화면을 다가오는 · 지난 탭(개수 표시)으로 만들고, upcoming = end > now를 start 오름차순으로, past = end ≤ now 또는 취소를 start 내림차순으로 정렬해줘. 오늘 예약은 맨 위에 액센트 막대 + 배경 10 %로 강조하고 남은 시간을 1시간 넘으면 "N시간 뒤", 안이면 "N분 뒤", 진행 중이면 "진행 중"으로 1분마다 갱신하며, 끝 시각이 지나면 그 줄을 200 ms에 접어 지난 탭 맨 위에 "완료"로 넣어줘. 상태 알약은 확정 · 변경됨 · 취소 · 완료 네 가지로 글자와 색을 함께 써줘.
라이브 데모 열기 — 내 예약 목록 (다가오는: 시작 빠른 순 · 오늘 것 맨 위 + 남은 시간 · 끝나면 지난 탭으로 · 상태 알약 4종)
휴무 · 휴식 규칙 (임시 휴무 › 특별 영업 › 정기 휴무 › 휴식 › 기본 영업 순 판정 · 휴무가 먼저 맞으면 0칸 · 휴식 13~14시는 칸에서 뺌)
Closures and breaks as layered schedule rules: one-off closures, date overrides, weekly days off, daily breaks and default hours resolved top-down before any slot is generated
영업 시간을 요일별 한 줄로만 두면 임시 휴무 · 특별 영업 · 점심 휴식을 넣을 곳이 없어 결국 칸을 손으로 지우게 된다. 규칙을 임시 휴무 › 특별 영업 › 정기 휴무 › 휴식 › 기본 영업 순으로 쌓고 날짜마다 위에서부터 판정해, 휴무가 먼저 맞으면 그 날은 0칸, 아니면 맞은 영업 시간에서 휴식 구간을 빼고 칸을 만든다. 가상의 미용실 예시로 토요일 16칸, 월요일 정기 휴무 0칸, 12시에 여는 화요일 12칸, 임시 휴무 목요일 0칸이 된다.
프롬프트
미용실 예약 서버에 schedule_rules 테이블(kind: closure | override | weekly_off | break | hours, 날짜 또는 요일, 시작 · 끝, priority)을 만들고, 날짜 하나의 영업 구간을 임시 휴무 → 특별 영업 → 정기 휴무 → 휴식 → 기본 영업(10:00~19:00) 순으로 판정하는 resolveDay(date)를 써줘. 휴무가 먼저 맞으면 칸 0개와 사유("정기 휴무" 등)를 돌려주고, 아니면 영업 구간에서 휴식(13:00~14:00)을 뺀 뒤 30분 간격으로 커트 30분이 들어가는 시작 칸만 만들어 날짜 줄에 사유와 칸 수를 함께 보여줘.
라이브 데모 열기 — 휴무 · 휴식 규칙 (임시 휴무 › 특별 영업 › 정기 휴무 › 휴식 › 기본 영업 순 판정 · 휴무가 먼저 맞으면 0칸 · 휴식 13~14시는 칸에서 뺌)
메뉴 여러 개 (길이 합산 염색 90 + 커트 30 = 120분 · 한 담당자 연속 · 순서 고정 · 가능한 시작 9칸 → 3칸)
Multi-service booking: durations summed into one contiguous block for a single staff member in a fixed order, recomputing start slots from 9 to 3
메뉴를 두 개 고르면 칸은 각 메뉴 길이의 합(염색 90 + 커트 30 = 120분)과 정리 10분이 끊김 없이 들어가는 곳만 남고, 한 담당자가 정해진 순서(염색 → 커트)로 한다. 메뉴마다 따로 가능한 칸을 구해 겹치는 곳을 보여 주면 중간에 다른 예약이 끼어 실제로는 못 하는 시작이 나온다. 가상의 하루에서 커트만일 땐 9칸이던 시작이 두 메뉴를 합치면 14:00 · 14:30 · 15:00 세 칸으로 줄어든다.
프롬프트
예약 화면에서 메뉴를 여러 개 고르면 services 배열(정해진 순서, 각 길이)을 서버에 보내고, 서버가 need = 길이 합 + 정리 10분 연속 구간이 한 담당자의 기존 예약 · 휴식과 겹치지 않는 시작만 30분 간격으로 돌려주게 해줘. 화면은 메뉴 선택 아래에 "합계 120분 · 순서: 염색 → 커트"와 가능한 시작 수를 보여 주고, 메뉴가 바뀌면 칸을 다시 받아 사라진 선택은 해제하며, 응답에는 세그먼트별 시작 · 끝(염색 14:00~15:30, 커트 15:30~16:00)을 함께 담아줘.
라이브 데모 열기 — 메뉴 여러 개 (길이 합산 염색 90 + 커트 30 = 120분 · 한 담당자 연속 · 순서 고정 · 가능한 시작 9칸 → 3칸)
가장 빠른 자리 버튼 (오늘 0칸이면 응답에 next 포함 · 누르면 그 날 · 그 칸에 포커스만 · 30일 안에 없으면 대기 걸기)
Next-available shortcut: an empty day returns the earliest open slot in the same response, and the button jumps the date strip and focuses that slot without holding it
선택한 날이 비었을 때 손님이 날짜를 하나씩 눌러 보게 두지 않고, 그 날 칸 요청의 응답에 같은 메뉴 · 담당 조건의 가장 빠른 자리(next: 11/21 14:30)를 함께 실어 두 번째 요청 없이 "가장 빠른 자리" 버튼을 띄운다. 버튼은 날짜 줄을 그 날로 옮기고 그 칸에 포커스만 줄 뿐 선점은 하지 않아, 손님이 시간을 확인하고 "다음"을 눌러야 10분 선점이 시작된다. 30일 안에 없으면 버튼 대신 대기 걸기를 보여 준다.
프롬프트
GET /slots?date=…&service=…&staff=any 응답이 칸 0개일 때 서버가 30일 안에서 같은 조건의 첫 빈 칸을 찾아 next: {date, start}를 함께 돌려주게 하고, 화면은 "오늘은 빈 자리가 없어요" 아래에 "가장 빠른 자리 · 토 11/21 14:30" 버튼을 보여줘. 누르면 날짜 줄을 그 날로 320 ms에 옮겨 칸을 받고 그 칸을 화면 안으로 스크롤해 포커스 링만 주며(선점은 "다음"에서), next가 null이면 버튼을 "30일 안에 자리 없음 · 대기 걸기"로 바꿔줘.
라이브 데모 열기 — 가장 빠른 자리 버튼 (오늘 0칸이면 응답에 next 포함 · 누르면 그 날 · 그 칸에 포커스만 · 30일 안에 없으면 대기 걸기)
예약 상태 전이 (요청 → 확정 → 방문 완료 · 곁가지 취소 · 노쇼 · 상태가 버튼을 정함 · 전이마다 이력 1행)
Booking status state machine: requested → confirmed → completed with cancelled and no-show exits, buttons derived from the state and one history row per transition
예약 상태를 요청 · 확정 · 방문 완료 · 취소 · 노쇼 다섯으로 두고 허용된 전이(가게 수락, 체크인, 손님 · 가게 취소, 시작 + 15분 자동 노쇼)만 서버가 받는다. 화면의 버튼은 상태에서 나온다 — 요청은 "요청 취소", 확정은 변경 · 취소, 방문 완료는 다시 예약 · 후기, 노쇼는 문의만. 전이마다 누가 · 언제 · 이전 → 이후를 이력 한 줄로 남겨야 분쟁 때 되짚을 수 있다.
프롬프트
예약 상태를 requested | confirmed | completed | cancelled | no_show enum으로 두고, 허용 전이 표(requested→confirmed 가게 수락, confirmed→completed 체크인, requested|confirmed→cancelled, confirmed→no_show 시작+15분 자동)에 없는 요청은 409 INVALID_TRANSITION으로 거부하는 transition(bookingId, to, actor) 함수를 만들어줘. 전이마다 booking_events에 (from, to, actor, at) 한 행을 쓰고, 화면은 상태별 버튼 목록(요청: 요청 취소 / 확정: 변경 · 취소 / 완료: 다시 예약 · 후기 / 취소: 다시 예약 / 노쇼: 가게에 문의)을 한 함수에서 받아 그려줘.
라이브 데모 열기 — 예약 상태 전이 (요청 → 확정 → 방문 완료 · 곁가지 취소 · 노쇼 · 상태가 버튼을 정함 · 전이마다 이력 1행)
변경 한도 · 변경 마감 (2번까지 · 시작 2시간 전까지 · 판정 순서 상태 › 횟수 › 시각 · 잠근 버튼에 이유 한 줄 · 서버도 403)
Reschedule limits: at most two changes and none within two hours of the start, evaluated in order with a reason under the locked button and the same rule enforced by the server
변경을 끝없이 허용하면 인기 칸을 잡아 두고 미루는 일이 생기므로 횟수(2번)와 마감(시작 2시간 전)을 둔다. 버튼은 상태 = 확정 › 변경 횟수 < 2 › 지금 < 시작 − 2시간 순으로 판정해 처음 걸린 규칙을 이유로 버튼 아래 한 줄로 보여 주고, 서버 시계와 가게 시간을 기준으로 같은 규칙을 다시 검사한다. 숫자는 가상 예시이고 업종마다 다르게 정한다.
프롬프트
예약 상세 화면의 [변경] 버튼을 canChange(booking, now) = 상태 확정 && changeCount < 2 && now < start − 2h로 판정하고, 막히면 버튼을 disabled로 두고 아래에 첫 번째로 걸린 이유("변경은 2번까지예요 · 취소 후 새로 예약" / "시작 2시간 전부터는 변경할 수 없어요 · 매장 02-0000-0000")를 보여줘. 변경 성공 때 changeCount를 서버에서 1 올리고 토스트 "변경됨 · 남은 변경 N번"을 4초 띄우며, 서버는 같은 규칙으로 403 CHANGE_LIMIT · CHANGE_CLOSED를 돌려주고 시각은 서버 시계 · 가게 시간대로 계산해줘.
라이브 데모 열기 — 변경 한도 · 변경 마감 (2번까지 · 시작 2시간 전까지 · 판정 순서 상태 › 횟수 › 시각 · 잠근 버튼에 이유 한 줄 · 서버도 403)
노쇼 자동 표시 (시작 + 15분 체크인 없음 → 1분 작업이 노쇼로 · 24시간 안 되돌리기 · 180일 3회면 다음 예약에 예약금)
No-show marking: a one-minute job flags confirmed bookings without check-in 15 minutes after start, the shop can undo within 24 hours, and three in 180 days require a deposit next time
노쇼는 직원이 기억해서 누르게 하지 않고, 1분마다 도는 작업이 "시작 + 15분 < 지금 이고 체크인 없음"인 확정 예약을 노쇼로 바꾸며 이력 한 줄을 남긴다. 실수로 표시된 것은 가게가 24시간 안에 되돌릴 수 있고, 최근 180일 노쇼가 3회가 되면 그 손님의 다음 예약 확인 화면에 예약금 줄이 붙는다. 노쇼 정책과 예약금은 나라 · 업종마다 다르며 숫자는 가상 예시다.
프롬프트
예약 서버에 1분 주기 작업을 만들어 status = confirmed AND start_at + 15분 < now AND checked_in_at IS NULL인 예약을 no_show로 바꾸고 booking_events에 actor = system 한 행을 남겨줘. 관리자 오늘 목록은 확정 줄에 "체크인 없음 · 노쇼까지 mm:ss"를 보여 주다 노쇼 알약(글자 포함)으로 바꾸고 24시간 안 "되돌리기"를 두며, 손님별 최근 180일 no_show 수가 3 이상이면 다음 예약 확인 화면에 "예약금 (20 %) 5,000원 · 노쇼 3회 · 예약금이 필요해요" 줄을 넣어줘.
라이브 데모 열기 — 노쇼 자동 표시 (시작 + 15분 체크인 없음 → 1분 작업이 노쇼로 · 24시간 안 되돌리기 · 180일 3회면 다음 예약에 예약금)
예약금 (시술가 × 20 % · 100원 미만 버림 · 방문 때 차감 · 별도 기록 결제됨 → 차감 | 환불 | 몰수 · 환불액은 예약 때 규정)
Booking deposits: 20 % of the service price rounded down to 100 won, deducted at the visit, kept as a separate record that ends deducted, refunded or forfeited
예약금을 예약 금액에 섞어 두면 방문 때 시술이 바뀌거나 취소 · 노쇼가 생길 때 얼마를 돌려줄지 계산이 꼬이므로, 예약과 연결된 별도 기록(금액 · 상태)으로 둔다. 금액은 시술가 × 20 %에서 100원 미만을 버리고(펌 87,000원 → 17,400원), 방문 정산에서 실제 금액(클리닉 추가 102,000원)에서 차감해 84,600원을 받는다. 환불 · 몰수 규칙은 예약 때 규정표를 기록에 고정하며, 예약금 · 환불 규정은 나라 · 업종마다 다르고 숫자는 가상 예시다.
프롬프트
예약금 deposits 테이블(booking_id, amount, status: paid | applied | refunded | forfeited, policy_snapshot)을 만들고 amount = floor(시술가 × 0.2 / 100) × 100으로 계산해줘. 확인 화면에 "예약금 17,400원 · 방문 때 차감"을, 방문 정산에 "펌 87,000 + 클리닉 15,000 = 102,000 · 예약금 −17,400 · 오늘 결제 84,600원"을 보여 주고, 24시간 전 취소면 refunded, 노쇼면 forfeited로 바꾸되 환불액은 예약 때 저장한 policy_snapshot으로 계산해줘. 결제 자체는 결제 모듈을 쓰고 이 화면은 상태와 금액만 다뤄줘.
라이브 데모 열기 — 예약금 (시술가 × 20 % · 100원 미만 버림 · 방문 때 차감 · 별도 기록 결제됨 → 차감 | 환불 | 몰수 · 환불액은 예약 때 규정)
가게 쪽 하루 표 (담당자 열 × 30분 행 · 예약 블록 + 정리 빗금 · 빈 칸 클릭 = 담당 · 시각 채운 전화 예약 · 같은 서버 겹침 검사)
Shop-side day sheet: staff columns by 30-minute rows with booking blocks, where clicking an empty cell opens a phone-booking panel prefilled with staff and time and saved through the same overlap-checked API
가게 직원은 전화로도 예약을 받으므로 관리자 하루 표를 담당자 열 × 30분 행으로 그리고, 빈 칸을 누르면 담당과 시작 시각이 채워진 전화 예약 패널을 연다. 패널은 메뉴와 손님 번호만 받아 앱과 같은 예약 API(source = phone)로 저장해야 겹침 검사 · 정리 10분 · 상태 이력이 한 곳에서 지켜지고, 따로 만든 관리자 저장 경로가 앱 예약과 겹치는 일을 막는다.
프롬프트
관리자 하루 표를 담당자 열(민지 · 서준 · 하린) × 30분 행(13:00~17:00), 예약은 시작 · 길이만큼의 블록과 뒤에 정리 10분 빗금으로 그려줘. 빈 칸 hover는 옅은 배경, 클릭은 점선 테두리 + "+ 전화 예약"을 보이고 오른쪽 패널(280 ms)에 담당 · 시작을 자동으로 채우며 메뉴 선택 · 손님 번호(마스킹 표시)만 받게 하고, 저장은 앱과 같은 POST /bookings에 source: "phone"을 넣어 보내 409 겹침이면 패널 안에 "다음 가능 15:10"을 보여줘.
라이브 데모 열기 — 가게 쪽 하루 표 (담당자 열 × 30분 행 · 예약 블록 + 정리 빗금 · 빈 칸 클릭 = 담당 · 시각 채운 전화 예약 · 같은 서버 겹침 검사)
관리자 시간 막기 (막은 구간은 칸 생성에서 빠짐 · 손님 화면엔 다음 새로 받기에서 사라짐 · 이미 잡힌 예약은 유지 + 표시)
Admin time blocks: a blocked range is removed from slot generation, disappears from customer screens on the next refresh, and leaves existing bookings in place with a flag
교육 · 외근처럼 가게가 시간을 막으면 그 구간은 휴식처럼 칸 생성에서 빠지고, 손님 화면에서는 "마감"이 아니라 아예 없어진다(다음 새로 받기, 보통 30초 안). 이미 잡힌 예약은 자동 취소하지 않고 그대로 두며 "막은 구간 안 예약 1건"으로 표시해 직원이 따로 연락하게 하고, 막기 전에 잡힌 선점은 확정 때 서버가 거부한다.
프롬프트
관리자 일정 화면에서 담당자 시간을 끌어 고른 뒤 "15:00~16:00 막기"를 누르면 blocks(staff_id, start, end, reason)에 저장하고, 칸 생성 함수가 blocks를 휴식과 같이 빼게 해줘. 막은 구간에 걸친 기존 예약은 그대로 두고 "막은 구간 안 예약 1건 · 유지됨 (따로 연락)" 표시를 붙이며, 손님 화면은 30초 새로 받기에서 해당 칸을 120 ms 페이드로 없애고, 막기 전 선점의 확정 요청은 409 BLOCKED로 거부해줘.
라이브 데모 열기 — 관리자 시간 막기 (막은 구간은 칸 생성에서 빠짐 · 손님 화면엔 다음 새로 받기에서 사라짐 · 이미 잡힌 예약은 유지 + 표시)
자동 좌석 추천 (같은 줄 붙은 N석 · 통로 넘지 않음 · 점수 = 줄 거리 + 0.6 × 가운데 거리 · 한 칸 남기면 탈락 · 1등을 잠금 1번)
Best-available seats: contiguous blocks in one row and section scored by row distance plus 0.6 × centre distance, gap-leaving blocks rejected, and the winner locked in one request
"자동 추천"은 인원 수만큼 같은 줄 · 같은 구역에 붙은 묶음을 모두 만들어 점수(기준 줄과의 거리 + 0.6 × 가운데 열과의 거리)가 낮은 순으로 보고, 묶음 옆에 혼자 남는 빈 칸이 생기면 탈락시킨다. 가상의 소극장 예시에서 E6–E8(1.9)이 D1–D3(2.1)보다 앞서고 C7–C9는 C10 한 칸을 남겨 빠진다. 1등 묶음은 세 좌석을 한 요청으로 잠그고, 하나라도 실패하면 셋 다 풀고 다음 후보로 간다.
프롬프트
좌석 배치(줄 A~G, 열 1~10, 5·6열 사이 통로)와 판매 · 잠금 좌석으로 인원 N의 후보 묶음을 만들고 score = |줄 − D| + 0.6 × |묶음 가운데 열 − 5.5|로 정렬하되, 묶음 양옆 빈 칸 묶음 길이가 1이면 제외하는 bestSeats(n)을 서버에 만들어줘. 화면의 "자동 추천 · 3석" 버튼은 결과 1등을 POST /seat-locks {seats:[E6,E7,E8]} 한 번으로 잠그고(pending 표시), 409면 다음 후보로 최대 3번 다시 시도한 뒤 직접 고르기로 안내해줘.
라이브 데모 열기 — 자동 좌석 추천 (같은 줄 붙은 N석 · 통로 넘지 않음 · 점수 = 줄 거리 + 0.6 × 가운데 거리 · 한 칸 남기면 탈락 · 1등을 잠금 1번)
좌석 확대 두 단계 (전체 보기 좌석 12pt는 구역만 누름 → 구역 보기 ×3.7 = 좌석 44pt · 미니맵 · 돌아가도 선택 유지)
Two-level seat map zoom: the overview at 12 pt seats only opens sections, the section view at ×3.7 makes 44 pt seats tappable, with a minimap and selections kept on zoom-out
큰 공연장 좌석표를 휴대폰 너비에 다 넣으면 좌석이 12pt쯤이 되어 손가락으로 정확히 누를 수 없으므로, 전체 보기에서는 탭이 좌석이 아니라 구역을 열게 하고 구역 보기에서 ×3.7로 키워 좌석이 최소 조작 크기 44pt가 된 뒤에만 잠금 요청을 보낸다. 확대 중에는 미니맵에 지금 보는 범위를 표시하고, 전체로 돌아가도 고른 좌석은 유지한다.
프롬프트
좌석표를 두 단계로 만들어줘: 전체 보기(좌석 약 12pt)에서는 좌석 탭을 무시하고 탭한 구역의 경계로 280 ms cubic-bezier(.2,.8,.2,1) 확대해 배율 = 44 / 12 ≈ 3.7로 맞추고, 구역 보기에서만 좌석 탭 → 잠금 요청을 보내줘. 확대 상태에서는 오른쪽 위 미니맵에 세 구역과 현재 보기 사각형을, 왼쪽 아래에 "← 전체" 버튼을 두고, 핀치도 같은 두 단계로 스냅하며, 줌 아웃해도 선택 좌석은 강조된 채 남게 해줘(동작 줄이기 설정이면 120 ms 페이드).
라이브 데모 열기 — 좌석 확대 두 단계 (전체 보기 좌석 12pt는 구역만 누름 → 구역 보기 ×3.7 = 좌석 44pt · 미니맵 · 돌아가도 선택 유지)
등급 글자 좌석 · 등급별 합계 줄 (색 + 글자 R · S · A · 줄 = 수 × 가격 · 남은 수 · 최대 4석 · 합계는 미리 보기)
Tier letters inside seats with per-tier subtotal lines: colour plus R / S / A letter, count × price per tier, remaining counts and a preview total confirmed by the server quote
등급을 색으로만 나누면 색을 구분하기 어려운 사람이 가격을 알 수 없으므로 좌석 안에 등급 글자(R · S · A)를 넣고, 범례에 가격과 남은 좌석 수를 함께 둔다. 좌석을 고르거나 풀 때마다 오른쪽 합계가 등급별 줄(R 2 × 77,000 = 154,000)과 합계 209,000원으로 다시 계산되며, 이 합계는 미리 보기이고 결제 금액은 서버 견적으로 확정한다.
프롬프트
좌석 컴포넌트에 등급 색 테두리 + 가운데 등급 글자(R · S · A)를 넣고, 선택 좌석은 등급 색 채움 + 흰 글자 + 바깥 링, 판매석은 회색 + ✕로 그려줘. 범례 칩에 등급 · 가격 · 남은 좌석(판매 가능 − 잠긴 좌석)을 보여 주고, 오른쪽 합계 패널은 선택이 바뀔 때마다 등급별 "R 2 × 77,000 = 154,000" 줄과 합계를 120 ms 롤로 갱신하며 "N / 4석"을 표시하고, 결제 단계에서는 서버 견적 금액만 쓰게 해줘.
라이브 데모 열기 — 등급 글자 좌석 · 등급별 합계 줄 (색 + 글자 R · S · A · 줄 = 수 × 가격 · 남은 수 · 최대 4석 · 합계는 미리 보기)
여러 명 한 번에 (2명 = 같은 시각 다른 담당자 | 한 담당자가 이어서 · 둘 다 비어야 표시 · 선점은 한 트랜잭션 · 전부 아니면 0)
Group booking for two: same time with two staff or back-to-back with one, offering only starts where every part fits and holding all parts in one all-or-nothing transaction
두 명을 예약할 때 칸을 한 명씩 고르게 하면 첫 사람만 잡히고 둘째가 실패해 반쪽 예약이 남는다. 화면은 "같은 시각 · 다른 담당자"와 "한 담당자가 이어서" 두 방식으로 두 사람 모두 들어가는 시작만 보여 주고(정리 10분 포함), 선점은 항목 2개를 한 요청 · 한 트랜잭션으로 보내 하나라도 실패하면 아무것도 잡지 않는다.
프롬프트
인원 2명 예약에서 mode = same_time(담당자 2명이 같은 시작에 모두 비어 있음) | back_to_back(한 담당자가 [s, s + 60 + 정리 10) 연속으로 비어 있음)으로 가능한 시작을 서버에서 계산해 화면 세그먼트 토글로 바꿔 보이게 해줘. 고르면 POST /holds {items:[…2개]}를 한 트랜잭션으로 처리해 둘 다 성공하면 같은 만료(10분)로 201, 하나라도 409면 롤백해 0건으로 돌려주고, 화면은 "방금 14:30이 마감됐어요 · 아무 자리도 잡지 않았어요"와 함께 목록을 다시 받게 해줘.
라이브 데모 열기 — 여러 명 한 번에 (2명 = 같은 시각 다른 담당자 | 한 담당자가 이어서 · 둘 다 비어야 표시 · 선점은 한 트랜잭션 · 전부 아니면 0)
슬롯 칸 상태 · 날짜 빨리 바꾸기 (loading · empty · error · success · 날짜 바뀌면 이전 요청 취소 · 300 ms 뒤 스켈레톤 · 빈 날은 원인 + 다음 가능한 날)
Slot panel states under fast date switching: abort the previous request on date change, show a skeleton only after 300 ms, and give empty and error states their cause and next action
날짜를 빨리 바꾸면 늦게 온 이전 날짜의 응답이 지금 날짜의 칸을 덮어쓰는 사고가 나므로, 날짜가 바뀌는 순간 이전 요청을 취소하고 응답의 날짜 키가 선택과 다르면 버린다. 칸 영역은 loading(300 ms 전엔 아무것도, 지나면 스켈레톤) · empty(원인 "전부 예약됨" + 다음 가능한 날 버튼) · error(다시 시도, 날짜 줄은 그대로) · success로 나뉜다.
프롬프트
예약 화면의 칸 영역을 날짜 키(queryKey: ["slots", date, service, staff])로 받고, 날짜가 바뀌면 AbortController로 이전 요청을 취소하며 응답의 date가 지금 선택과 다르면 버려줘. 상태는 loading(300 ms 지나면 칸 모양 스켈레톤, 한 번 뜨면 500 ms 유지) · empty("일요일은 빈 자리가 없어요 · 원인: 전부 예약됨" + "다음 가능한 날 · 11/24 (화)" 버튼) · error("칸을 불러오지 못했어요" + 다시 시도, 10초 타임아웃) · success로 나눠 그리고, 휴무일 칩은 처음부터 누를 수 없게 해줘.
라이브 데모 열기 — 슬롯 칸 상태 · 날짜 빨리 바꾸기 (loading · empty · error · success · 날짜 바뀌면 이전 요청 취소 · 300 ms 뒤 스켈레톤 · 빈 날은 원인 + 다음 가능한 날)
연결 없을 때 (내 예약 · 입장 코드는 캐시로 보임 · 예약 · 변경 · 취소는 잠금 + 이유 · 대기 줄에 넣지 않음 · 연결되면 다시 받아 덮기)
Offline booking app: cached bookings and entry codes stay viewable, booking, change and cancel are locked with a reason rather than queued, and reconnecting refetches and overwrites
매장 앞에서 연결이 끊겨도 내 예약 시간 · 예약 번호 · 입장 코드는 열려야 하므로 마지막으로 받은 내 예약 목록을 기기에 저장해 "14:02에 받은 정보"와 함께 보여 준다. 반대로 자리와 돈이 걸린 예약 · 변경 · 취소는 채팅처럼 대기 줄에 넣었다 나중에 보내지 않고 이유와 함께 잠근다. 다시 연결되면 내 예약을 다시 받아 바뀐 값(가게가 바꾼 시간)을 덮어쓰고 한 번 알린다.
프롬프트
내 예약 목록 응답을 IndexedDB에 저장해 오프라인이면 캐시로 그리고 맨 위에 "연결 없음 · HH:MM에 받은 정보" 띠를 보여줘. 오프라인 동안 변경 · 취소 · 새 예약 버튼은 disabled + "연결되면 할 수 있어요"로 두고 눌러도 요청을 쌓지 말고 토스트만 4초 띄우며, 온라인 이벤트가 오면 GET /me/bookings로 다시 받아 바뀐 예약에 "변경됨" 알약과 "예약 시간이 14:30으로 바뀌었어요" 알림을 한 번만 보여줘.
라이브 데모 열기 — 연결 없을 때 (내 예약 · 입장 코드는 캐시로 보임 · 예약 · 변경 · 취소는 잠금 + 이유 · 대기 줄에 넣지 않음 · 연결되면 다시 받아 덮기)
슬롯 키보드 이동 (Tab 한 번에 격자 진입 · 화살표 = 칸 · 마감 칸도 멈춤 + "마감, 선택할 수 없음" 낭독 · Enter 선택)
Keyboard and screen-reader slot grid: a single Tab stop into the grid, arrow keys between slots, full slots still reachable and announced with their reason, Enter to select
칸 격자의 버튼마다 Tab을 걸면 칸이 40개일 때 다음 버튼까지 40번을 눌러야 하므로, 격자에는 tabindex 0을 한 칸에만 두고 화살표로 칸 사이를 옮긴다. 마감 칸을 disabled로 두면 포커스가 건너뛰어 왜 없는지 알 수 없으니 aria-disabled로 두어 포커스는 멈추고 "15:00, 마감, 선택할 수 없음"을 읽힌다. Enter는 선택, Tab은 다음 버튼으로 나간다.
프롬프트
슬롯 격자를 role="grid" + 로빙 tabindex(선택 칸 또는 첫 칸만 0)로 만들고 ←→↑↓로 칸을 옮기며 줄 끝에서는 멈추고 Home · End로 줄의 처음 · 끝으로 가게 해줘. 마감 칸은 disabled 대신 aria-disabled="true"와 aria-label "15:00, 마감, 선택할 수 없음"을 주고, Enter · Space는 가능한 칸만 선택해 "15:30 선택됨"을 한 번 알리며, 포커스 링은 2 px + 간격 2 px, 화면을 다시 열면 마지막 포커스 칸을 복원해줘.
라이브 데모 열기 — 슬롯 키보드 이동 (Tab 한 번에 격자 진입 · 화살표 = 칸 · 마감 칸도 멈춤 + "마감, 선택할 수 없음" 낭독 · Enter 선택)
지난 예약 다시 (같은 메뉴 · 담당으로 날짜 단계부터 · 채우기 전 지금 값 검사 · 가격 바뀜 표시 · 담당이 없으면 누구나)
Rebook from a past booking: prefill service and staff to start at the date step, validating each prefilled value against current data first
단골은 지난번과 같은 메뉴 · 담당자로 날짜만 다시 고르므로 지난 예약의 "다시 예약"은 메뉴 · 담당 두 단계를 건너뛰고 날짜 줄로 바로 간다. 다만 옛 값을 그대로 쓰면 판매 중단 메뉴 · 바뀐 가격 · 더 이상 예약을 받지 않는 담당자가 섞이므로, 채우기 전에 지금 기준으로 검사해 가격은 새 값으로 바꿔 표시하고 담당자가 없으면 "누구나"로 바꾸며 알린다.
프롬프트
지난 예약 줄의 "다시 예약"이 GET /rebook-draft?from=<예약번호>를 불러 { service, staff | null, priceNow, changes[] }를 받고, 통과한 항목은 단계 표시에 ✓로 채워 ③ 날짜 단계에서 시작하게 해줘. 가격이 바뀌었으면 "펌 120분 · 87,000원 (전 85,000)"처럼 표시하고, 담당자가 예약을 받지 않으면 staff를 any로 바꿔 "서준 님은 더 이상 예약을 받지 않아요"를 한 줄 보이며, 메뉴가 판매 중단이면 메뉴 단계로 보내고, 날짜는 빈 자리 있는 첫 날을 자동 선택해줘.
라이브 데모 열기 — 지난 예약 다시 (같은 메뉴 · 담당으로 날짜 단계부터 · 채우기 전 지금 값 검사 · 가격 바뀜 표시 · 담당이 없으면 누구나)
달 보기 남은 자리 점 (달마다 요약 요청 1번 · ≥50 % ●●● · ≥20 % ●● · >0 ● · 0 마감 · 누른 날만 칸 받기)
Month availability dots: one summary request per month returning open and total per day, mapped to three dot levels, with slots fetched only for the tapped day
달력에 날짜마다 여유를 보여 주려고 30일치 칸을 모두 받으면 요청이 30번이므로, 달마다 요약(날짜별 남은 칸 · 전체 칸) 한 번만 받아 점 3단계(50 % 이상 ●●● · 20 % 이상 ●● · 1칸 이상 ● · 0이면 "마감")로 그린다. 칸 목록은 손님이 누른 날만 받고, 지난 날과 휴무일은 누를 수 없다. 점은 색 하나에 개수로 정도를 나타내 색만으로 구분하지 않는다.
프롬프트
GET /availability/summary?month=2026-11&service=cut&staff=any가 days[{date, open, total}]를 주게 하고(SQL 집계 한 번), 달력 칸 아래 점을 level = open/total ≥ .5 ? 3 : ≥ .2 ? 2 : open > 0 ? 1 : 0으로 그려 0은 "마감", 휴무는 "휴무", 지난 날은 흐리게 해줘. 날을 누르면 그 날만 GET /slots?date=…로 칸을 받아 아래에 펼치고, 요약은 5분 신선 · 달을 넘길 때 다음 달을 미리 받아줘.
라이브 데모 열기 — 달 보기 남은 자리 점 (달마다 요약 요청 1번 · ≥50 % ●●● · ≥20 % ●● · >0 ● · 0 마감 · 누른 날만 칸 받기)
시간대 (UTC로 저장 · 가게 시간으로 크게 · 기기 시간대가 다르면 작게 같이 · 날짜 줄 · 취소 기한은 가게 날짜)
Time zones in booking: store UTC, display shop time as primary and the device time as a secondary line only when zones differ, and compute dates and deadlines in shop time
해외에 있는 손님에게 기기 시간대로만 보여 주면 서울 가게의 10:00이 "전날 20:00"으로 보여 날짜 줄과 영업일이 어긋난다. 저장은 UTC 시각 하나로 하고 표시는 가게 시간대(Asia/Seoul) 기준을 크게, 기기 시간대가 다를 때만 "내 11/20 20:00"을 작게 함께 쓰며, 날짜 줄 · 영업일 · 취소 기한은 모두 가게 날짜로 계산한다. 시간대가 같으면 두 번째 줄은 숨긴다.
프롬프트
예약 시각을 start_at timestamptz(UTC)로 저장하고 가게에 shop_tz = "Asia/Seoul"을 두어, 칸 버튼은 가게 시간(14:30)을 6 px 굵게, 기기 시간대가 다르면 아래 줄에 "내 11/21 00:30"(날짜가 다르면 날짜 포함, 주황)을 작게 함께 그려줘. 날짜 줄 · 영업일 판정 · 취소 기한(시작 24시간 전)은 shop_tz로 계산하고, 확정 화면 · 알림 문구에도 "11/21 (토) 14:30 서울 = 11/21 00:30 내 시간"처럼 두 시각과 시간대 이름을 넣으며, 두 시간대가 같으면 둘째 줄을 숨겨줘.
라이브 데모 열기 — 시간대 (UTC로 저장 · 가게 시간으로 크게 · 기기 시간대가 다르면 작게 같이 · 날짜 줄 · 취소 기한은 가게 날짜)
대기 명단 큐 (취소 → 1번에게 15분 제안 = 선점 · 만료 · 거절 → 다음 pos · 제안 중에도 남에겐 마감 · 1인 3개 · 시작 1시간 전 종료)
Waitlist as an ordered queue: a cancellation becomes a 15-minute held offer to position 1, expiry or decline moves to the next position, and the slot stays full for everyone else
마감된 칸의 대기 명단은 순서(pos) · 상태(대기 · 제안 중 · 만료 · 예약됨) · 제안 만료 시각을 가진 큐로 만든다. 취소가 생기면 칸을 공개하지 않고 1번에게 15분짜리 제안을 보내며 그 동안 칸은 그 사람의 선점이라 다른 손님 화면에선 계속 마감이다. 만료되거나 거절하면 다음 pos로 넘어가고, 확정하면 대기에서 빠져 나머지 순서가 당겨진다.
프롬프트
waitlist(slot_id, user_id, pos, status: waiting | offered | expired | booked | left, offer_expires_at) 테이블과 취소 이벤트 핸들러를 만들어줘: 칸이 비면 공개하지 않고 pos가 가장 작은 waiting에게 offered + 15분 선점(hold)을 걸고 푸시를 보내며, 만료 작업(1분 주기)이나 거절이면 expired로 바꾸고 다음 pos에 같은 제안을 반복해 대기가 없을 때만 칸을 공개해줘. 1인 대기는 3개까지, 시작 1시간 전에는 남은 대기를 left로 정리하고, 관리자 화면에는 순서 · 상태 알약 · 남은 제안 시간(mm:ss)을 보여줘.
라이브 데모 열기 — 대기 명단 큐 (취소 → 1번에게 15분 제안 = 선점 · 만료 · 거절 → 다음 pos · 제안 중에도 남에겐 마감 · 1인 3개 · 시작 1시간 전 종료)