배너 목록 (왼쪽 세로 탭 4개 · 종료 시각 오름차순 · 상시 배너는 맨 아래 · NEW 점은 열면 끔 · 전환 200 ms)
Gacha banner list: vertical tabs sorted by end time, permanent banner last, seen-flag NEW dot and 200 ms content swap
뽑기 화면의 배너 탭을 무엇으로 정렬하고 탭을 누르면 무엇이 바뀌는지 정하는 카드다. 서버 응답 banners[]를 종료 시각 오름차순으로 세우고 종료가 없는 상시 배너를 맨 끝에 두면 곧 끝나는 배너가 늘 위에 있고, NEW 점은 그 탭을 한 번 열 때 seen을 저장해 끈다. 정렬 기준이 없으면 운영이 배너를 추가할 때마다 탭 순서가 뒤섞이고, 점이 꺼지는 조건이 없으면 영영 남는다.
프롬프트
가상의 수집형 RPG 뽑기 화면 왼쪽에 폭 50 · 높이 28의 세로 탭 4개를 두고 서버 banners[]를 endAt 오름차순(endAt이 null인 상시 배너는 맨 끝)으로 정렬해 탭마다 이름 · 남은 기간(N일 N시간, 24시간 이하면 주황)을 보여줘. 탭을 누르면 오른쪽 큰 그림 · 확률 한 줄(가상 예시) · 1회 160 / 10회 1,600 젬 버튼이 100 ms 사라졌다 100 ms 나타나는 순서로 바뀌고, NEW 점은 그 탭을 처음 열 때 seen을 서버에 저장하며 꺼지게 해줘.
라이브 데모 열기 — 배너 목록 (왼쪽 세로 탭 4개 · 종료 시각 오름차순 · 상시 배너는 맨 아래 · NEW 점은 열면 끔 · 전환 200 ms)
배너 종료 처리 (24시간 전 주황 "곧 종료" · 서버 시각 0이면 버튼 잠금 · 보던 사람은 안내 뒤 목록 갱신 · 종료 뒤 요청 410)
Banner end handling: 24-hour warning, server-time lock at zero, in-place notice and list refresh, 410 after end
배너가 끝나는 순간 화면을 열어 둔 사람에게 무엇이 일어나는지 정하는 카드다. 남은 시간을 endAt − serverNow(기기 시계 + 서버 오프셋)로 1초마다 계산해 24시간 이하면 주황 표시, 0이면 버튼을 잠그고 안내 시트를 띄운 뒤 목록을 다시 받는다. 기기 시계로 계산하거나 화면이 그대로 남으면 끝난 배너에 뽑기를 눌러 서버 거절(410)을 만나게 된다.
프롬프트
뽑기 배너 화면에서 남은 시간 R = endAt − (기기 시각 + 서버 오프셋)을 1초마다 계산해 1일 이상 "N일 N시간", 1시간 이상 "N시간 N분", 그 아래 mm:ss로 표시하고 R ≤ 24시간이면 주황 "곧 종료" 칩을 붙여줘. R이 0이 되면 1회 · 10회 버튼을 즉시 잠금(회색 "잠김")으로 바꾸고 "이 배너는 종료됐어요 · 목록으로" 시트를 띄워 누르면 목록을 다시 받아 그 배너를 빼고, 시계가 어긋나 종료 뒤 요청이 가도 서버가 410 BANNER_ENDED로 거절하면 같은 시트를 띄우게 해줘.
라이브 데모 열기 — 배너 종료 처리 (24시간 전 주황 "곧 종료" · 서버 시각 0이면 버튼 잠금 · 보던 사람은 안내 뒤 목록 갱신 · 종료 뒤 요청 410)
배너 그림 불러오기 (틀 · 글자 · 버튼은 데이터 도착 즉시 · 그림은 도착하면 120 ms 페이드 · 10 s 실패면 글자 배너)
Banner art loading: frame, text and pull button render on data, art fades in at 120 ms, 10 s failure falls back to a text banner
배너 큰 그림이 늦거나 실패할 때 화면을 어떻게 그릴지 정하는 카드다. 배너 데이터(이름 · 기간 · 비용)가 오면 그림 자리를 배너 대표색으로 채운 틀과 글자 · 버튼을 바로 그리고, 그림은 도착하는 대로 120 ms 페이드로 덮으며 10초 안에 못 받으면 글자 배너로 남긴다. 그림을 기다렸다 한꺼번에 그리면 늦은 그림이 다른 배너를 밀어내고, 그림이 실패한 배너는 아예 뽑을 수 없게 된다.
프롬프트
배너 목록 카드(88 × 36)를 데이터 응답 즉시 대표색 바탕 + 이름 · 남은 기간 · 뽑기 버튼으로 그리고, 그림은 비동기로 받아 도착하면 120 ms 페이드인, 10 s 타임아웃이면 대표색 그라디언트 위 큰 이름의 글자 배너와 "그림 없음" 칩으로 바꿔줘. 그림 로딩 여부와 관계없이 버튼은 처음부터 누를 수 있고 카드 높이는 고정이라 늦게 온 그림이 아래 카드를 밀지 않게 해줘.
라이브 데모 열기 — 배너 그림 불러오기 (틀 · 글자 · 버튼은 데이터 도착 즉시 · 그림은 도착하면 120 ms 페이드 · 10 s 실패면 글자 배너)
1회 · 10회 버튼 비용 줄 (티켓 먼저 · 모자란 만큼 젬 160씩 · 티켓 3장이면 10회 = 티켓 3 + 젬 1,120 · 젬이 모자라면 부족분만)
Pull button cost line: tickets first, gems for the rest at 160 each, mixed cost display and shortfall amount
1회 · 10회 버튼 아래 비용 줄을 보유 티켓과 젬으로 어떻게 조립할지 정하는 카드다. 티켓 사용 = min(보유, 회수), 젬 = (회수 − 티켓 사용) × 160으로 계산해 티켓 3장이면 10회 버튼에 "티켓 ×3 + 젬 1,120"을 보여 주고, 젬이 모자라면 비용 대신 부족분과 상점 안내를 단다. 늘 젬 가격만 쓰면 티켓이 있어도 비싸 보이고, 최종 차감은 서버가 같은 규칙으로 다시 정한다.
프롬프트
뽑기 화면 1회 · 10회 버튼(64 × 40) 아래에 비용 줄을 만들어줘: ticketUse = min(보유 티켓, n), gem = (n − ticketUse) × 160, 표시는 티켓 아이콘 ×N과 젬 아이콘 숫자를 "+"로 잇고, 보유 젬이 모자라면 버튼 테두리를 빨강으로 바꾸고 "젬 700 부족 → 상점 충전"(1,600 − 900)을 보여줘. 보유 값이 바뀔 때마다 두 버튼을 다시 계산하고, 화면 계산은 표시용일 뿐 실제 차감은 서버 응답 값을 쓰게 해줘.
라이브 데모 열기 — 1회 · 10회 버튼 비용 줄 (티켓 먼저 · 모자란 만큼 젬 160씩 · 티켓 3장이면 10회 = 티켓 3 + 젬 1,120 · 젬이 모자라면 부족분만)
뽑기 요청 한 번 (탭 → 버튼 잠금 → 서버가 차감 · 결과 10개 · 천장 · 잔액을 한 응답으로 → 잔액 덮어쓰기 → 그 뒤 연출)
One pull request: lock, server-side deduction and roll, one response with results, pity and balance, then the reveal
뽑기 버튼을 눌렀을 때 화면과 서버가 일하는 순서를 정하는 카드다. 탭 한 번에 멱등 키 하나로 요청을 보내고 버튼을 잠근 채 기다리면 서버가 젬 차감 → 결과 10개 → 기록 → 천장 갱신을 끝내고 결과 · 천장 · 잔액을 한 응답으로 돌려주며, 화면은 잔액을 그 값으로 덮어쓴 뒤에야 연출을 시작한다. 화면이 먼저 결과를 굴리거나 잔액을 미리 빼면 연출과 실제 지급이 어긋난다.
프롬프트
뽑기 10회 버튼을 누르면 즉시 submitting(스피너, 폭 고정)으로 잠그고 POST /gacha/pull {bannerId, count:10, idemKey}를 한 번 보내, 응답 {pullId, results[10], pity, gem}을 받은 뒤 재화 바를 서버 잔액(예: 3,940 → 2,340)으로 300 ms 롤다운하고 그다음 연출 화면으로 results를 넘겨줘. 화면 쪽 난수는 쓰지 않고, 응답 전에는 연출 · 재화 변화가 없으며, 응답이 없을 때 같은 키로 조회하는 처리는 상점 결과 모름 규칙을 그대로 따르게 해줘.
라이브 데모 열기 — 뽑기 요청 한 번 (탭 → 버튼 잠금 → 서버가 차감 · 결과 10개 · 천장 · 잔액을 한 응답으로 → 잔액 덮어쓰기 → 그 뒤 연출)
연출 중 끊김 복구 (결과는 이미 서버 기록 · 재접속하면 미확인 결과 시트 · 다시 뽑기 요청 0회 · 재화는 이미 차감)
Recovering a pull interrupted mid-reveal: server-recorded result, unseen-pull sheet on relaunch, no re-roll
연출 도중 앱이 꺼지거나 연결이 끊겼을 때 다음 접속에서 무엇을 보여 줄지 정하는 카드다. 뽑기 응답을 받은 순간 기기에는 pullId만 pendingPull로 저장하고, 재접속하면 GET /gacha/pulls?unseen=1로 서버 기록을 받아 "확인하지 않은 뽑기 결과" 시트로 열 칸을 보여 준 뒤 지운다. 다시 뽑기를 요청하거나 결과를 기기에만 두면 재화가 두 번 빠지거나 결과를 잃는다.
프롬프트
뽑기 응답을 받으면 기기 저장소에 pendingPull = pullId와 shown = 0/10만 기록하고 연출이 끝나면 지워줘. 앱 시작 · 재로그인 때 pendingPull이 있거나 GET /gacha/pulls?unseen=1이 결과를 돌려주면 "확인하지 않은 뽑기 결과가 있어요" 시트(10칸 5 × 2, 시각 · 배너 이름, "기록 보기" / "확인")를 280 ms로 올리고, 이때 재화 · 천장은 서버 값으로 덮어쓰며 뽑기 요청은 다시 보내지 않게 해줘.
라이브 데모 열기 — 연출 중 끊김 복구 (결과는 이미 서버 기록 · 재접속하면 미확인 결과 시트 · 다시 뽑기 요청 0회 · 재화는 이미 차감)
천장 표시 (응답 pity 값 그대로 57/80 · 확정까지 80 − n · 79면 "다음 1회 확정" · 전설 뒤 0 · 화면에서 +1 하지 않음)
Pity counter display bound to the server value: n/80 bar, remaining pulls, next-pull guarantee, reset after the top rarity
천장(확정까지 남은 횟수) 막대를 어떤 값으로 언제 움직일지 정하는 카드다. 막대는 뽑기 응답의 pity 값으로만 갱신하고(요청 중엔 그대로), 남은 횟수는 80 − n, 79에서는 "다음 1회 확정", 최고 등급이 나오면 서버가 돌려준 0으로 비운다. 화면에서 1씩 더하면 끊김 · 다른 기기 뽑기 뒤 숫자가 어긋나며, 천장 수치는 모두 가상 예시이고 표기 규정은 나라와 스토어마다 다르다.
프롬프트
배너 화면에 "전설 확정까지 N회"와 n / 80 막대(10회마다 눈금)를 두고, 값은 뽑기 응답의 pity로만 220 ms 갱신해 요청 중에는 막대를 움직이지 말아줘. 79면 문구를 주황 "다음 1회 확정"으로 바꾸고, 전설이 나온 응답(pity 0)에서는 "전설 획득 · 80회째" 카드 뒤 막대를 비우며, 아래 한 줄로 "같은 픽업 배너끼리 이어짐 · 상시와 따로"처럼 천장이 어디까지 이어지는지 밝혀줘(80은 가상 예시).
라이브 데모 열기 — 천장 표시 (응답 pity 값 그대로 57/80 · 확정까지 80 − n · 79면 "다음 1회 확정" · 전설 뒤 0 · 화면에서 +1 하지 않음)
확률표 숫자 처리 (0.001 % 단위 정수로 저장 · 소수 셋째 자리 표시 · 나머지는 마지막 항목 · 합계 100.000 % 줄 · 등급 줄 펼침)
Odds table data handling: integer milli-percent storage, 3-decimal display, remainder on the last item and a 100.000 % total row
확률표 화면에 숫자를 어떤 형태로 받아 그릴지 정하는 카드다. 확률을 0.001 % 단위 정수(100 % = 100,000)로 저장해 등급 합계 → 펼친 개별 항목을 그대로 보여 주고, 3개로 나누는 8 %처럼 떨어지지 않는 몫은 2.667 · 2.667 · 2.666으로 나머지를 마지막 항목에 둔다. 항목마다 반올림한 실수를 그대로 쓰면 합계가 100.001 %가 되고, 확률 수치는 모두 가상 예시이며 공개 규정은 나라와 스토어마다 다르다.
프롬프트
뽑기 확률표 시트를 만들어 등급 5줄(색 + 꼭짓점 점 1–5개, 확률 소수 셋째 자리)과 맨 아래 "합계 100.000 %" 줄을 두고, 등급 줄을 누르면 280 ms로 펼쳐 개별 항목 확률을 보여줘. 값은 서버가 0.001 % 단위 정수로 보내고(전설 2000 · 영웅 8000 → 2667 · 2667 · 2666), 화면은 나누기 없이 정수 ÷ 1000만 하며, 합계 검증은 정수 합이 100,000인지로 하고 맨 위에 적용 버전(v3)과 "가상 예시"를 표시해줘.
라이브 데모 열기 — 확률표 숫자 처리 (0.001 % 단위 정수로 저장 · 소수 셋째 자리 표시 · 나머지는 마지막 항목 · 합계 100.000 % 줄 · 등급 줄 펼침)
10회 결과 정리 화면 (5 × 2 · 응답 순서 그대로 · 처음 얻음 NEW · 중복은 조각 +10 · 합계 한 줄 · 패드 포커스는 순서대로)
10-pull summary grid: 5 × 2 in response order, NEW and duplicate shard tags, totals line and pad focus order
연출이 끝난 뒤 남는 정리 화면에 열 개를 어떤 순서와 표시로 놓을지 정하는 카드다. results[]의 인덱스 순서 그대로 5 × 2에 놓고 서버가 준 isNew면 NEW, 중복이면 칸 아래 조각 +10을 붙이며 아래에 "새 캐릭터 2 · 조각 +30" 합계를 둔다. 등급 순으로 다시 정렬하면 기록 · 연출과 칸 위치가 어긋나 "몇 번째에 나온 것"을 찾을 수 없다.
프롬프트
10회 뽑기 정리 화면에 칸 24 · 간격 6의 5 × 2 격자를 results[0..9] 순서대로(위 줄 0–4, 아래 줄 5–9) 60 ms 간격으로 놓고, 등급은 색과 꼭짓점 점 1–5개로, isNew면 칸 위 NEW, 중복이면 칸 아래 조각 아이콘 +10을 붙여줘. 아래 합계 줄 "새 캐릭터 N · 조각 +M(중복 K)"과 "다시 10회" / "확인" 버튼을 두고, 패드 포커스는 인덱스 순서로 이동하게 해줘(공개 연출은 다루지 않음).
라이브 데모 열기 — 10회 결과 정리 화면 (5 × 2 · 응답 순서 그대로 · 처음 얻음 NEW · 중복은 조각 +10 · 합계 한 줄 · 패드 포커스는 순서대로)
뽑기 기록 (20줄씩 · 최근 90일 · 5줄 남으면 다음 20줄 · 10회는 머리줄 + 10줄 · 종류 필터 바꾸면 목록 · 커서 초기화)
Gacha history paging: 20-row pages within 90 days, prefetch at 5 rows left, 10-pull group headers and per-type filter reset
뽑기 기록 화면을 어떤 단위로 받고 어떻게 묶어 보여 줄지 정하는 카드다. 결과 한 개를 한 줄로 20줄씩 커서로 받고, 10회 뽑기는 시각 · 배너 머리줄 아래 10줄로 묶으며, 캐릭터 · 무기 · 상시 필터를 바꾸면 목록과 커서를 버리고 처음부터 받는다. 보관은 최근 90일이라 끝에는 "90일 이전 기록은 보관하지 않아요"를 둔다.
프롬프트
뽑기 기록 목록을 GET /gacha/history?type=char&limit=20&cursor=… 로 받아 줄 높이 11에 등급 색 막대 · 등급명 · 이름 · #순번을 그리고, 같은 pullId 10개 앞에 "11-19 21:04 · 서리검 · 10회" 머리줄을 넣어줘. 남은 줄이 5개가 되면 다음 쪽을 미리 요청하고, 필터 칩(캐릭터 · 무기 · 상시)을 바꾸면 목록 · 커서를 초기화해 다시 받으며, hasMore가 false면 끝에 "90일 이전 기록은 보관하지 않아요"를 보여줘.
라이브 데모 열기 — 뽑기 기록 (20줄씩 · 최근 90일 · 5줄 남으면 다음 20줄 · 10회는 머리줄 + 10줄 · 종류 필터 바꾸면 목록 · 커서 초기화)
우편 한 통의 자리 배정 (보낸 곳 그림 · 발신처 위 작은 글씨 · 제목 말줄임 · 첨부 셋 + N · 남은 날 우상단 · 안 읽음 점)
Game mail list item layout: sender emblem, sender caption, truncated subject, three attachment glyphs plus overflow count, expiry in the corner and unread dot
우편함 한 줄에 무엇을 어디에 둘지 정하는 카드다. 390 pt 폭 기준 높이 72에 왼쪽 16 여백 · 보낸 곳 아이콘 48, 그 오른쪽에 보낸 곳 작은 글씨와 제목 1줄(넘치면 말줄임), 첨부는 17 pt 칸 3개까지 + N, 남은 기간은 오른쪽 위(3일 이하 빨강), 안 읽음 점은 아이콘 오른쪽 위에 둔다. 자리가 정해지지 않으면 첨부가 많은 우편 · 긴 제목에서 줄 높이와 정렬이 흔들린다.
프롬프트
게임 우편함 목록의 줄을 390 pt 폭 · 높이 72로 만들어줘: 왼쪽 16 여백에 48 × 48 보낸 곳 아이콘(안 읽음이면 오른쪽 위 점 8), 아이콘 오른쪽 12에 보낸 곳(13) · 제목(16, 1줄 말줄임, 읽으면 보통 굵기), 아래 줄에 첨부 아이콘 17 칸 3개 + "+N", 오른쪽 위에 남은 기간(3일 이하 빨강). 첨부를 이미 받았으면 아이콘 대신 "받음"을 쓰고 줄 높이는 내용과 관계없이 72로 고정해줘.
라이브 데모 열기 — 우편 한 통의 자리 배정 (보낸 곳 그림 · 발신처 위 작은 글씨 · 제목 말줄임 · 첨부 셋 + N · 남은 날 우상단 · 안 읽음 점)
우편 만료 (보관 30일 · 3일 이하 빨강 + 시계 · 1일 미만 N시간 N분 · 0이면 줄 200 ms 페이드 뒤 위로 · 만료 임박 순 정렬)
Mail expiry: 30-day retention, red under 3 days, hour-minute format under a day, row removal at zero and an expiring-first sort
우편의 남은 기간을 어떻게 표기하고 0이 될 때 줄을 어떻게 빼는지 정하는 카드다. expiresAt = 받은 시각 + 30일을 서버 시각과 비교해 1일 이상 "N일 N시간", 3일 이하 빨강, 1일 미만 "N시간 N분", 1시간 미만 mm:ss로 바꾸고, 0이 되면 줄을 200 ms 페이드한 뒤 아래 줄을 200 ms 끌어올린다. 삭제는 서버가 하고 화면은 판정만 하며, 정렬 칩으로 받은 순 · 만료 임박 순을 고른다.
프롬프트
우편함 줄마다 남은 기간을 expiresAt − serverNow로 계산해 1일 이상 "N일 N시간", 72시간 이하면 빨강 + 시계 아이콘, 24시간 미만 "N시간 N분", 1시간 미만 mm:ss(1초마다)로 표시해줘. 0이 되면 그 줄을 200 ms 페이드아웃하고 아래 줄들이 200 ms로 올라오며, 상단 칩 "받은 순 / 만료 임박 순"을 누르면 남은 시간 오름차순으로 200 ms 재배치하게 해줘(보관 30일, 실제 삭제는 서버).
라이브 데모 열기 — 우편 만료 (보관 30일 · 3일 이하 빨강 + 시계 · 1일 미만 N시간 N분 · 0이면 줄 200 ms 페이드 뒤 위로 · 만료 임박 순 정렬)
우편 모두 받기와 가방 여유 (우편 1통 = 전부 받거나 남김 · 만료 임박 순 검사 · 못 넣는 우편은 건너뜀 · "12통 중 9통 받음")
Mail claim-all against bag space: whole-mail atomic claim, expiring-first order, skip what does not fit, partial result summary
모두 받기를 눌렀는데 가방 여유가 모자랄 때 어떤 우편을 받고 어떤 우편을 남길지 정하는 카드다. 서버가 만료 임박 순으로 우편을 하나씩 검사해 재화만 든 우편은 늘 받고, 아이템 우편은 필요한 칸이 남았을 때만 통째로 받으며 넣을 수 없는 우편은 건너뛰고 다음 우편을 본다. 결과는 "12통 중 9통 받음 · 3통은 가방이 가득 차 남았어요"와 가방 정리 버튼으로 끝내고, 우편을 쪼개 받으면 첨부 일부만 사라진 것처럼 보인다.
프롬프트
우편함 "모두 받기"를 요청 1번으로 보내고 서버는 만료 임박 순으로 우편마다 필요한 가방 칸을 검사해 재화 우편은 항상, 아이템 우편은 칸이 남을 때만 통째로 지급하고 못 넣는 우편은 건너뛰어 다음 우편을 보게 해줘(가방 115/120 → 5칸으로 12통 중 9통). 응답이 오면 줄마다 120 ms 간격으로 "받음" / 주황 "가방 부족"을 표시하고, "12통 중 9통 받음 · 3통은 가방이 가득 차 남았어요" 카드에 "가방 정리" 버튼을 띄워줘(남은 우편의 보관 기간은 그대로).
라이브 데모 열기 — 우편 모두 받기와 가방 여유 (우편 1통 = 전부 받거나 남김 · 만료 임박 순 검사 · 못 넣는 우편은 건너뜀 · "12통 중 9통 받음")
우편함 상한 (100통 · 90통부터 경고 줄 · 101번째가 오면 첨부 없는 가장 오래된 우편 삭제 · 첨부 남은 우편은 보호 · 전부 보호면 서버 대기)
Mailbox cap: 100 mails, warning from 90, evict the oldest attachment-free mail, protect unclaimed attachments, server queue when all are protected
우편함이 가득 찼을 때 새 우편이 오면 무엇을 지울지 정하는 카드다. 90통부터 목록 위에 경고 줄을 띄우고, 100통을 넘는 순간 서버가 첨부가 없거나 이미 받은 우편 중 가장 오래된 것을 지우며, 받지 않은 첨부가 있는 우편은 건너뛴다. 모두 보호 대상이면 새 우편을 서버 대기열에 두고 도착만 알리며, 규칙이 없으면 보상 우편이 조용히 사라진다.
프롬프트
우편함 머리에 "n / 100" 숫자와 막대(90 눈금)를 두고 90통부터 주황 경고 줄 "거의 찼어요 · 오래된 우편이 자동 삭제돼요"를 띄워줘. 새 우편은 맨 위에 200 ms로 들어오고, 101번째가 오면 서버가 (첨부 없음 또는 받음) 우편 중 가장 오래된 것을 지워 100을 유지하며 첨부가 남은 우편에는 "보호" 칩을 붙여 건너뛰게 하고, 전부 보호면 새 우편을 서버 대기열에 넣고 "우편함이 가득 차 N통이 기다리는 중" 안내를 보여줘.
라이브 데모 열기 — 우편함 상한 (100통 · 90통부터 경고 줄 · 101번째가 오면 첨부 없는 가장 오래된 우편 삭제 · 첨부 남은 우편은 보호 · 전부 보호면 서버 대기)
읽은 우편 정리 (읽음 + 첨부 없음/받음만 삭제 · 첨부 남음 · 안 읽음은 보호 · "14통 삭제" 확인 창에 남는 수까지)
Bulk delete of read mail: only read mails without pending attachments, protected rows skipped, confirmation with counts
"읽은 우편 삭제" 한 번에 무엇을 지우고 무엇을 남길지 정하는 카드다. 삭제 대상은 읽음이면서 첨부가 없거나 이미 받은 우편뿐이고, 받지 않은 첨부가 있거나 안 읽은 우편은 보호해 건너뛰며, 확인 창에 지울 개수와 남는 개수와 이유를 함께 보여 준다. 판정 없이 "읽음"만 보면 받지 않은 보상까지 지워지고, 서버도 같은 조건으로 다시 확인한다.
프롬프트
우편함 상단 "읽은 우편 삭제"를 누르면 줄마다 0.1초 간격으로 "삭제 대상"(읽음 && (첨부 없음 || 받음)) / "보호"(첨부 남음 · 안 읽음) 칩을 붙이고, 목록을 어둡게 한 뒤 "읽은 우편 14통을 삭제할까요? 받지 않은 첨부 3통 · 안 읽은 2통은 남아요 · 되돌릴 수 없어요" 확인 창을 띄워줘. "14통 삭제"를 누르면 대상 줄을 200 ms 페이드하고 남은 줄을 200 ms 모아 머리 숫자를 19 → 5로 바꾸며, 서버는 같은 조건으로 다시 걸러 지운 id 목록을 돌려주게 해줘.
라이브 데모 열기 — 읽은 우편 정리 (읽음 + 첨부 없음/받음만 삭제 · 첨부 남음 · 안 읽음은 보호 · "14통 삭제" 확인 창에 남는 수까지)
28칸 출석판 (7 × 4 · 칸 상태는 받은 수 claimed와 canClaim으로 계산 · 오늘 칸만 누름 · 도장은 서버 응답 뒤 · 7 · 14 · 21 · 28일 큰 보상)
28-day attendance board: cell states derived from claimed count and canClaim, server-confirmed stamp, milestone days
출석판 28칸의 상태를 무엇으로 계산하고 오늘 칸을 누르면 어떤 순서로 바뀌는지 정하는 카드다. 칸 i는 i ≤ claimed면 받음, i = claimed + 1이고 canClaim이면 오늘, 그 밖은 잠김이며 달력 날짜는 쓰지 않는다. 오늘 칸을 누르면 스피너 뒤 서버 응답(claimed 11 → 12)이 오고 나서 도장을 찍고, 잠긴 칸을 누르면 흔들림과 "내일 05:00 이후" 이유를 보여 준다.
프롬프트
7 × 4 출석판(칸 18 · 간격 3, 7 · 14 · 21 · 28일은 금색 테두리 상자)을 서버 값 claimed와 canClaim만으로 그려줘: i ≤ claimed 받음(도장 원 + 체크), i = claimed + 1 && canClaim 오늘(테두리 맥동), 그 밖 잠김. 오늘 칸을 누르면 칸에 스피너를 띄우고 POST /attend(멱등 키 a_YYMMDD) 응답이 오면 도장을 1.6배에서 180 ms로 찍고, 잠긴 칸을 누르면 ±1.6 px 300 ms 흔들림과 "13일차는 내일 05:00 이후 받을 수 있어요" 토스트 4 s를 띄워줘.
라이브 데모 열기 — 28칸 출석판 (7 × 4 · 칸 상태는 받은 수 claimed와 canClaim으로 계산 · 오늘 칸만 누름 · 도장은 서버 응답 뒤 · 7 · 14 · 21 · 28일 큰 보상)
출석 날짜 판정 (dayKey = 서버 시각 − 5시간의 날짜 · 04:59는 전날 · 하루 1칸 · 쉰 날은 비우지 않고 다음 칸 · 기기 시계 무시)
Attendance day key: server time minus five hours, one cell per day key, cumulative cells and device-clock independence
출석 "하루"를 어떻게 자르는지 정하는 카드다. dayKey = date(서버 시각 − 5시간)으로 계산해 11-18 04:59 접속은 11-17, 05:01은 11-18이 되고, 같은 dayKey에서는 한 칸만 받으며 사흘 쉬고 와도 다음 칸 하나가 열린다(누적형). 기기 시계를 쓰면 시계를 바꿔 하루에 여러 칸을 받을 수 있으니 판정은 서버에서만 한다.
프롬프트
출석 판정 함수를 서버에 두어 dayKey = toDate(serverNow − 5h, 서버 시간대)로 계산하고, 마지막 받은 dayKey와 같으면 "이미 받음", 다르면 claimed + 1 칸을 지급하게 해줘(빠진 날은 건너뛰지 않는 누적형, 28칸). 화면에는 접속 기록 표(서버 시각 · dayKey · 결과)와 05:00 경계 확대(04:59 → 전날, 05:01 → 새날)를 보여 주고, 기기 시계가 하루 앞서도 결과가 바뀌지 않음을 한 줄로 확인시켜줘.
라이브 데모 열기 — 출석 날짜 판정 (dayKey = 서버 시각 − 5시간의 날짜 · 04:59는 전날 · 하루 1칸 · 쉰 날은 비우지 않고 다음 칸 · 기기 시계 무시)
패스 트랙 첫 위치 (50단계 · 단계 폭 56 pt · 받을 것 중 가장 낮은 단계, 없으면 내 단계를 가운데 · clamp 0–2,410 · 320 ms)
Pass track initial scroll: center the lowest claimable tier or the current tier, clamped scroll offset, 320 ms slide
50단계 가로 트랙을 열었을 때 어디를 먼저 보여 줄지 정하는 카드다. 받을 보상이 있으면 그중 가장 낮은 단계, 없으면 내 단계를 화면 가운데에 오게 scrollX = clamp((단계 − 0.5) × 56 − 195, 0, 50 × 56 − 390)으로 계산하고 320 ms로 미끄러져 간다. 늘 1단계에서 열리면 23단계까지 직접 밀어야 하고, 받을 것을 지나쳐 가운데에 두면 받지 않은 보상을 놓친다.
프롬프트
390 pt 폭 화면에 50단계 가로 패스 트랙(단계 폭 56 pt, 위 무료 · 아래 유료 칸 30, 왼쪽에 고정 줄 이름)을 만들고, 열 때 목표 단계 = 받을 수 있는 칸 중 최소 단계(없으면 내 단계)로 정해 scrollX = clamp((목표 − 0.5) × 56 − 195, 0, 2,410)으로 320 ms cubic-bezier(.2,.8,.2,1) 이동해줘(23 → 1,065, 18 → 785). 아래에 1–50 미니맵과 보이는 범위 사각형, 내 단계 · 받을 것 점을 두고, 내 단계 열은 옅은 배경으로 표시해줘.
라이브 데모 열기 — 패스 트랙 첫 위치 (50단계 · 단계 폭 56 pt · 받을 것 중 가장 낮은 단계, 없으면 내 단계를 가운데 · clamp 0–2,410 · 320 ms)
패스 수령 (유료 줄은 구매 전 자물쇠 · 구매 확인 뒤 지난 23단계가 한꺼번에 열림 · 열림과 받기는 따로 · 모두 받기 요청 1번)
Pass claiming: premium row locked until purchase is confirmed, retroactive unlock of past tiers, separate claim-all request
유료 패스를 산 순간 이미 지난 단계의 유료 보상을 어떻게 다룰지 정하는 카드다. 결제가 서버에서 확인되어 premium이 true가 되면 1–23단계 유료 칸 자물쇠가 한꺼번에 풀려 "받기" 상태가 되고(받을 것 = 내 단계 − 받은 유료 수), 실제 지급은 "모두 받기" 요청 한 번으로 따로 한다. 사는 즉시 자동 지급하면 가방 여유 · 결과 화면 처리가 꼬이고, 결제 흐름 자체는 상점 인앱 규칙을 따른다.
프롬프트
시즌 패스 화면에 무료 · 유료 두 줄 트랙을 두고 유료 칸은 premium이 false인 동안 자물쇠로 그려줘. "구매"를 누르면 결제 확인 중 스피너를 띄우고 서버가 premium = true를 돌려준 뒤에만 내 단계(23)까지의 유료 칸을 40 ms 간격으로 "받기"로 바꾸며 "모두 받기 (23)" 버튼을 켜고, 누르면 ids 23개를 요청 1번으로 보내 응답 뒤 칸마다 체크로 바꿔줘(24단계부터는 단계 도달 시 열림).
라이브 데모 열기 — 패스 수령 (유료 줄은 구매 전 자물쇠 · 구매 확인 뒤 지난 23단계가 한꺼번에 열림 · 열림과 받기는 따로 · 모두 받기 요청 1번)
시즌 종료 처리 (3일 전부터 안내 줄 · 종료 시각에 트랙 읽기 전용 · 받지 않은 보상 7개를 우편 1통으로 · 보관 30일)
Season end for a pass: 3-day notice, read-only track at end, unclaimed rewards bundled into one 30-day mail
패스 시즌이 끝날 때 트랙과 받지 않은 보상을 어떻게 정리할지 정하는 카드다. 종료 3일 전부터 트랙 위에 "곧 시즌이 끝나요 · 받지 않은 보상 7개" 줄을 띄우고, 종료 시각에 서버가 트랙을 잠가(받기 요청 410) 화면을 읽기 전용으로 바꾼 뒤 미수령 보상을 모아 우편 1통(첨부 7, 보관 30일)으로 보낸다. 끝난 트랙에 받기 버튼이 남거나 보상이 그냥 사라지면 문의가 몰린다.
프롬프트
패스 화면에서 종료 3일 전부터 상단에 "곧 시즌이 끝나요 · 받지 않은 보상 N개" 줄과 남은 시간(N일 N시간 → mm:ss)을 보여 주고, 종료 시각(서버)에 트랙을 회색 읽기 전용으로 바꿔 받기 버튼을 모두 감춰줘. 서버 작업은 ① 트랙 잠금(이후 받기 요청 410) ② 무료 4 + 유료 3 미수령 수집 ③ 첨부 7개 우편 1통 발송(보관 30일) ④ 다음 시즌 05:00 시작 순서로 하고, 화면은 우편함 점과 "시즌 3 받지 않은 보상 7개" 우편 줄을 보여줘.
라이브 데모 열기 — 시즌 종료 처리 (3일 전부터 안내 줄 · 종료 시각에 트랙 읽기 전용 · 받지 않은 보상 7개를 우편 1통으로 · 보관 30일)
우편 상세 시트 (줄 탭 = 시트 280 ms · 읽음은 먼저 반영하고 실패면 점 복구 · 받기는 응답 뒤 · 받으면 줄 흐림 · 만료는 날짜 + 남은 날)
Mail detail sheet: optimistic read flag with rollback, pessimistic attachment claim, dimmed row and absolute expiry date
우편 줄을 눌러 상세를 열 때 두 요청의 순서를 다르게 잡는 카드다. 읽음 표시는 되돌릴 수 있는 값이라 시트를 여는 순간 점을 끄고 PATCH를 보내며 실패하면 250 ms 안에 점을 되살리고, 첨부 받기는 재화가 오가니 버튼을 잠근 채 서버 응답 뒤에만 줄을 흐리게 바꾼다. 둘을 같은 방식으로 처리하면 읽음이 느리게 반응하거나, 받지도 못한 첨부가 받은 것처럼 보인다.
프롬프트
가상의 수집형 RPG 우편함에서 줄(높이 19)을 누르면 하단 시트가 280 ms(닫힘 210 ms)로 올라와 보낸 곳 · 제목 · 본문 · 첨부 3칸(아이콘 + 수량) · "만료 12-19 05:00 · 남은 30일" · 받기 버튼을 보여 주게 해줘. 시트가 열리는 즉시 안 읽음 점을 끄고 PATCH /mail/{id}/read를 보내되 실패하면 점을 250 ms 안에 다시 켜고 토스트를 띄우고, 받기는 idle → submitting(폭 고정 스피너) → 200 응답 뒤 "받음 · 가방 +3"과 줄 50 % 흐림, 실패면 받기로 돌아가 첨부를 그대로 두게 해줘.
라이브 데모 열기 — 우편 상세 시트 (줄 탭 = 시트 280 ms · 읽음은 먼저 반영하고 실패면 점 복구 · 받기는 응답 뒤 · 받으면 줄 흐림 · 만료는 날짜 + 남은 날)
모두 받기는 화면의 id만 (요청에 ids[6] · 처리 중 도착한 새 우편은 받지 않고 맨 위에 남김 · 응답 claimed[]로 줄 갱신)
Claim-all scoped to the ids on screen: new mail arriving mid-request is left unclaimed at the top
모두 받기 요청이 무엇을 받을지 정하는 범위를 화면 기준으로 고정하는 카드다. 버튼을 누른 순간 목록에 보이던 우편 id 묶음을 요청에 실어 서버가 그 id만 처리하게 하면, 요청이 도는 사이 도착한 우편은 안 읽음 점과 함께 맨 위에 남아 다음에 사용자가 직접 본다. "지금 서버에 있는 전부"로 받으면 사용자가 본 적도 없는 우편까지 사라지고 가방 칸 계산도 화면과 어긋난다.
프롬프트
우편함 모두 받기 버튼을 누르면 그 순간 목록에 있던 첨부 있는 우편 id 배열을 { ids: [m41 … m46] }로 POST /mail/claim-all에 보내고, 요청 중 실시간으로 들어온 우편(m47)은 200 ms로 맨 위에 삽입하되 요청 대상에서 빼줘. 응답의 claimed[]에 든 줄만 "받음"으로 흐리게 바꾸고 m47은 점과 받기 버튼을 그대로 두며 "6통 받음 · 새 우편 1통은 남겼어요" 토스트를 4 s 띄워줘.
라이브 데모 열기 — 모두 받기는 화면의 id만 (요청에 ids[6] · 처리 중 도착한 새 우편은 받지 않고 맨 위에 남김 · 응답 claimed[]로 줄 갱신)
우편 종류 탭 (전체 · 보상 · 친구 · 공지 · 탭마다 줄 모양 · 모두 받기는 지금 탭 안만 · 친구 선물 하루 30개 · 공지는 첨부 없이 7일)
Mailbox type tabs: per-tab row layouts, tab-scoped claim-all, 30-a-day friend gift cap and attachment-free notices
우편함을 종류별 탭으로 나눌 때 탭마다 무엇이 달라지는지 정하는 카드다. 보상 탭은 첨부 아이콘과 남은 날, 친구 탭은 보낸 사람과 스태미나 5에 하루 받기 30개 한도 줄, 공지 탭은 첨부 없이 7일 보관에 모두 받기 버튼이 없고, 모두 받기는 지금 보고 있는 탭 안에서만 돈다. 탭 하나에 모든 종류를 같은 줄로 섞으면 친구 선물 한도에 막힌 이유가 보이지 않고 공지가 받기 대상처럼 보인다.
프롬프트
우편함 상단에 전체 18 · 보상 9 · 친구 6 · 공지 3 탭(폭 34, 개수는 서버 값)을 두고 탭마다 줄을 다르게 그려줘: 보상은 첨부 아이콘 3개 + 남은 날, 친구는 아바타 · 이름 · 스태미나 5 · 받기 버튼과 맨 위 "오늘 받은 선물 25 / 30" 막대, 공지는 종 아이콘 · "첨부 없음 · 보관 7일" · 읽기. 모두 받기는 현재 탭 id만 보내고, 친구 탭에서 6개 중 한도 남은 5개만 받으면 마지막 줄은 "내일 05:00"으로 남기며 버튼은 "5개 받음 · 1개는 내일"로 바꿔줘.
라이브 데모 열기 — 우편 종류 탭 (전체 · 보상 · 친구 · 공지 · 탭마다 줄 모양 · 모두 받기는 지금 탭 안만 · 친구 선물 하루 30개 · 공지는 첨부 없이 7일)
스태미나 우편 (자연 회복은 120까지 · 우편 · 아이템은 999까지 · 넘는 우편은 409로 거절하고 남김 · 120 이상이면 회복 시계 멈춤)
Stamina mail over the natural cap: claims allowed past 120 up to 999, over-limit mail rejected and kept, regen paused above 120
스태미나가 든 우편을 받을 때 상한을 어떻게 적용할지 정하는 카드다. 시간 회복은 120에서 멈추지만 우편 · 아이템으로 얻는 양은 999까지 넘겨 받게 하고, 받은 뒤 값이 999를 넘는 우편은 서버가 거절해 우편함에 그대로 남기며 모두 받기에서도 건너뛴다. 120에서 잘라 버리면 보상이 사라지고, 상한이 없으면 숫자가 끝없이 쌓여 표시 칸과 경제가 깨진다.
프롬프트
스태미나 막대를 0–120 구간(청록)과 120 초과분(금색)으로 나눠 그리고, 120 이상이면 "자연 회복 멈춤 (120 이상)", 아래면 "다음 +1 · mm:ss"를 보여줘. 스태미나 우편 받기는 서버가 현재값 + 수량 ≤ 999일 때만 지급하고(110 + 60 = 170 → 받음), 넘으면 409 STAMINA_LIMIT으로 거절(170 + 900 = 1,070)해 우편을 남기고 줄 아래 "170 + 900 = 1,070 > 999"와 토스트를 띄우며, 모두 받기도 이 우편을 건너뛰게 해줘.
라이브 데모 열기 — 스태미나 우편 (자연 회복은 120까지 · 우편 · 아이템은 999까지 · 넘는 우편은 409로 거절하고 남김 · 120 이상이면 회복 시계 멈춤)
놓친 칸 채우기 (오늘 칸을 받은 뒤 · 남은 칸 − 남은 날이 0보다 클 때만 · 다음 칸 하나에 채움 버튼 · 채움권 월 3회 · 요청 1칸 1번)
Attendance makeup: a makeup cell offered only after today's claim when remaining cells exceed remaining days, 3 per month
누적 칸 출석판에서 쉰 날 때문에 월말까지 28칸을 못 채우는 사람에게 채움권을 쓰게 하는 조건을 정하는 카드다. 서버가 모자람 = (28 − 받은 칸) − 남은 날을 계산해 0보다 크고 오늘 칸을 이미 받았을 때만 다음 칸에 채움 버튼을 띄우고, 한 번에 한 칸 · 월 3회까지 따로 요청한다. 조건 없이 채움을 열어 두면 첫날에 판을 미리 다 채울 수 있고, 오늘 칸보다 먼저 쓰면 오늘 칸이 밀린다.
프롬프트
28칸 출석판(칸 15 · 간격 3)에서 오늘 칸을 받은 뒤 서버가 남은 칸 28 − 18 = 10, 남은 날(24–30일) 7, 모자람 3을 계산해 응답하면 다음 칸 하나에만 금색 "채움" 띠를 붙여줘. 채움을 누르면 POST /attend/makeup {board:2611, cell:19}로 채움권 1장을 쓰고 응답 뒤 표 모양 도장을 찍으며 "이번 달 사용 1 / 3"과 모자람을 2로 줄이고, 모자람이 0이거나 월 3회를 다 쓰면 버튼을 감춰줘.
라이브 데모 열기 — 놓친 칸 채우기 (오늘 칸을 받은 뒤 · 남은 칸 − 남은 날이 0보다 클 때만 · 다음 칸 하나에 채움 버튼 · 채움권 월 3회 · 요청 1칸 1번)
달이 바뀔 때 출석판 (출석 요청에 board id · 05:00 뒤 옛 판 2611 요청은 409 BOARD_CLOSED · 못 받은 27 · 28칸은 사라짐 안내 1번 · 새 판 2612)
Attendance month rollover: board id on every claim, 409 for the closed board, one notice about lapsed cells and a fresh board
출석판을 연 채 달이 바뀌는 05:00을 넘겼을 때 화면과 요청을 어떻게 맞출지 정하는 카드다. 출석 요청마다 판 id를 실어 보내 서버가 끝난 판의 요청을 409로 막고, 화면은 못 받은 칸이 사라진다는 안내를 한 번 보여 준 뒤 새 달 판을 받아 320 ms로 바꾼다. 판 id 없이 칸 번호만 보내면 지난달 27번 칸 요청이 새 판 1번 칸에 잘못 찍히거나 지난 판 보상이 지급된다.
프롬프트
출석판 화면의 받기 요청을 POST /attend {board:2611, cell:27}처럼 판 id와 칸 번호로 보내고, 서버가 dayKey(서버 시각 − 5시간)로 이미 새 달이면 409 BOARD_CLOSED(지급 0)로 거절하게 해줘. 화면은 그 응답에 "11월 출석판이 끝났어요 · 받지 못한 27 · 28칸은 사라져요" 안내와 "12월 출석판 보기" 버튼을 띄우고, 누르면 GET /attend로 2612 판을 받아 320 ms 크로스페이드 뒤 1번 칸을 오늘 칸으로 열어줘.
라이브 데모 열기 — 달이 바뀔 때 출석판 (출석 요청에 board id · 05:00 뒤 옛 판 2611 요청은 409 BOARD_CLOSED · 못 받은 27 · 28칸은 사라짐 안내 1번 · 새 판 2612)
복귀 출석판 (14일 이상 미접속이면 로그인 때 7칸 판 생성 · 생성 뒤 14일 만료 · 끝나고 30일 지나야 다시 · 출석 요청 1번이 두 판을 함께 채움)
Returning-player attendance board: created at login after 14 days away, 7 cells, 14-day expiry, 30-day cooldown, one claim fills both boards
오래 쉬고 돌아온 사람에게 별도 7칸 출석판을 열지 서버가 판정하는 카드다. 로그인 때 마지막 접속과 오늘의 차이가 14일 이상이고 지난 복귀판이 끝난 지 30일이 지났으면 만료 시각이 박힌 판을 만들고, 출석 요청 한 번의 응답 boards[]로 일반 판과 복귀 판을 같이 채운다. 화면이 날짜를 직접 계산하면 기기 시계로 대상이 바뀌고, 요청을 판마다 따로 보내면 하나만 성공하는 반쪽 상태가 생긴다.
프롬프트
로그인 처리에서 absent = 오늘 − 마지막 접속(11-19 − 10-28 = 22일)이 14 이상이고 마지막 복귀판 종료 후 30일이 지났으면 7칸 복귀판(만료 = 생성 + 14일, 12-03 05:00)을 만들고, 9일처럼 모자라면 만들지 마. 출석 화면은 응답 boards[]만 그려 일반 판 12/28 막대 아래 복귀 7칸(7번째 상자)을 두고, 받기 1번(POST /attend)의 응답 normal 13 · return 1로 두 판에 함께 도장을 찍게 해줘.
라이브 데모 열기 — 복귀 출석판 (14일 이상 미접속이면 로그인 때 7칸 판 생성 · 생성 뒤 14일 만료 · 끝나고 30일 지나야 다시 · 출석 요청 1번이 두 판을 함께 채움)
패스 경험치 줄 (단계당 1,000 · 주간 상한 10,000 · 서버가 상한까지만 반영해 applied 반환 · 넘친 100은 버림 · 상한이면 막대 회색 줄무늬 + "+0")
Pass XP bar with a weekly cap: server-applied gain, multi-tier fill, discarded overflow and a striped capped state
패스 경험치가 들어올 때 화면이 무엇을 기준으로 막대를 채우는지 정하는 카드다. 서버가 주간 상한 10,000까지만 반영한 applied · tier · xp · weekly를 돌려주면 화면은 그 값으로 단계 막대를 여러 번 넘기며 한 번에 채우고, 상한에 닿으면 주간 막대를 회색 줄무늬로 바꿔 이후 획득을 "+0 · 주간 상한"으로 보여 준다. 화면이 획득량을 그대로 더하면 상한 뒤에도 단계가 오른 것처럼 보였다가 다음 접속에 되돌아간다.
프롬프트
패스 화면에 단계 배지 · "다음 단계까지 N / 1,000" 막대 · "이번 주 N / 10,000" 막대를 두고, 미션 완료 이벤트 응답 {gain 1,500, applied 1,400, capped 100, tier 23 → 24, xp 740, weekly 10,000}을 받으면 340에서 1,000을 넘겨 0으로 감았다가 740까지 800 ms로 채우고 "+1,400" 칩을 띄워줘. weekly가 상한이면 주간 막대를 회색 줄무늬로, 문구를 "상한 도달 · 월 05:00 초기화까지 N일 N시간"으로 바꾸고 이후 applied 0 응답에는 "+0 · 주간 상한" 칩만 보여줘.
라이브 데모 열기 — 패스 경험치 줄 (단계당 1,000 · 주간 상한 10,000 · 서버가 상한까지만 반영해 applied 반환 · 넘친 100은 버림 · 상한이면 막대 회색 줄무늬 + "+0")
패스 단계 구매 (슬라이더 +N · 단계당 젬 150 · 최대 = min(50 − 23, ⌊2,340 ÷ 150⌋) = 15 · 열릴 보상 밝게 · 요청에 from · add · price)
Pass level purchase slider: per-tier price, max bounded by remaining tiers and gems, live reward preview and a priced request
패스 단계를 젬으로 사는 슬라이더의 범위와 미리보기를 정하는 카드다. 최대값을 남은 단계(50 − 현재)와 살 수 있는 수(보유 젬 ÷ 150) 중 작은 쪽으로 두고 그 너머는 빗금으로 막으며, 밀어 둔 만큼 열릴 무료 · 유료 보상 칸을 밝혀 비용과 남는 젬을 함께 보여 준다. 최대를 50단계로만 두면 살 수 없는 값까지 밀리고, 요청에 출발 단계와 가격이 없으면 그 사이 단계가 올라간 경우 엉뚱한 값이 차감된다.
프롬프트
패스 단계 구매 창에 +1 – +27 슬라이더를 두고 최대 = min(50 − 23, ⌊2,340 ÷ 150⌋) = 15에 빨간 경계선과 "젬으로 최대 +15" 표시, 그 너머는 빗금으로 막아 손잡이가 경계에서 튕기게 해줘. 값이 바뀔 때마다 24단계부터 무료 · 유료 두 줄 칸을 +N만큼 밝히고 "N × 150 = 비용 → 남는 젬"을 갱신하며, 구매는 { from: 23, add: 5, price: 750 }으로 보내 응답 tier 28 · gem 1,590으로 덮고 from이 다르면 409로 다시 계산하게 해줘.
라이브 데모 열기 — 패스 단계 구매 (슬라이더 +N · 단계당 젬 150 · 최대 = min(50 − 23, ⌊2,340 ÷ 150⌋) = 15 · 열릴 보상 밝게 · 요청에 from · add · price)
끝 보상 고정 카드 (트랙 오른쪽에 50단계 보상 폭 34 고정 · 진짜 50칸이 다 보이면 120 ms 페이드로 숨김 · 누르면 그 칸으로 320 ms)
Pinned final-tier reward: sticky card at the track edge, hidden once the real tier-50 cell is fully visible, tap to scroll there
긴 패스 트랙 어디를 보고 있어도 마지막 보상이 보이게 하는 고정 카드의 표시 조건을 정하는 카드다. 50번째 칸의 왼쪽 위치가 보이는 영역 오른쪽 − 칸 폭보다 크면 고정 카드를 띄우고, 진짜 칸이 다 들어오면 숨겨 같은 보상이 두 번 보이거나 고정 카드가 칸을 가리지 않게 하며, 고정 카드를 누르면 끝으로 미끄러진다. 숨김 조건이 없으면 끝까지 스크롤했을 때 고정 카드가 진짜 50칸을 덮는다.
프롬프트
패스 트랙(칸 폭 26, 보이는 폭 260, scrollX 최대 = 50 × 26 − 260 = 1,040) 오른쪽 끝에 50단계 무료 · 유료 보상을 폭 34 카드로 고정하고, 그 밑에 깔릴 칸은 그리지 않게 해줘. 50칸 왼쪽 x가 (보이는 오른쪽 − 26)보다 크면 고정 카드를 보이고 그 안으로 들어오면 120 ms 페이드로 숨기며, 고정 카드를 누르면 scrollX를 1,040까지 320 ms cubic-bezier(.2,.8,.2,1)로 옮기고 되돌아가면 다시 나타나게 해줘.
라이브 데모 열기 — 끝 보상 고정 카드 (트랙 오른쪽에 50단계 보상 폭 34 고정 · 진짜 50칸이 다 보이면 120 ms 페이드로 숨김 · 누르면 그 칸으로 320 ms)
배너 대상 상세와 체험 (상세는 배너 응답 preview로 그림 · 체험 전투는 고정 편성 · 보상 · 기록 없음 · 돌아오면 같은 배너 · 탭 · 스크롤 · 다시 받기 0)
Pickup detail and trial: detail drawn from the banner preview, rewardless trial battle and full banner state restore on back
배너에서 대상 캐릭터 상세와 체험 전투로 들어갔다 나올 때 어떤 상태를 남겨 둘지 정하는 카드다. 상세는 배너 목록 응답에 같이 온 preview 데이터로 바로 그리고, 체험 전투는 고정 편성으로 보상과 기록 없이 돌며, 화면 스택의 뽑기 항목에 배너 id · 탭 · 스크롤을 저장해 돌아오면 목록을 다시 받지 않고 그대로 복원한다. 복원이 없으면 체험 뒤 첫 배너로 튀어 사용자가 보던 배너를 다시 찾아야 한다.
프롬프트
뽑기 화면에서 "상세"를 누르면 { screen:"gacha", bannerId:"b2", tab:1, scroll:0 }을 스택에 남기고 배너 응답의 preview(이름 · 스킬 3줄 · 무기)로 상세를 320 ms 슬라이드로 열어줘. "체험 전투"는 고정 편성 4명 · 보상 없음 · 기록 저장 없음 화면으로 push하고, 나가기와 B(뒤로)로 pop할 때마다 저장한 상태를 복원해 뽑기로 돌아오면 b2 탭이 선택된 채 남게 하고 5분 캐시 안에서는 목록 요청을 다시 보내지 않게 해줘.
라이브 데모 열기 — 배너 대상 상세와 체험 (상세는 배너 응답 preview로 그림 · 체험 전투는 고정 편성 · 보상 · 기록 없음 · 돌아오면 같은 배너 · 탭 · 스크롤 · 다시 받기 0)
하루 1회 무료 뽑기 (1회 버튼만 · 비용 순서 무료 → 티켓 → 젬 · 쓰면 "젬 160 + 무료까지 18시간 42분" · 05:00 서버 초기화 뒤 다시 무료 · 10회는 대상 아님)
Daily free single pull: free-ticket-gem cost order, countdown label after use, server reset at 05:00, ten-pull excluded
하루 한 번 무료 뽑기를 버튼에 어떻게 얹을지 정하는 카드다. 1회 버튼의 비용을 무료 남음 → 티켓 → 젬 순으로 고르고 서버 freeLeft가 1이면 "무료 1회"로, 쓰고 나면 젬 가격과 다음 05:00까지 남은 시간을 함께 보여 주며 10회 버튼은 무료와 무관하다. 기기 시계로 무료를 되살리면 시계를 바꿔 무료를 여러 번 누르는 화면이 생기고, 서버가 거절하는 요청을 보내게 된다.
프롬프트
뽑기 1회 버튼 비용을 1. freeLeft > 0 → 무료, 2. 티켓 > 0 → 티켓 1, 3. 젬 160 순으로 골라 "무료 1회"(초록) 또는 "◆ 160" + 아래 "무료까지 N시간 N분"(1시간 미만은 mm:ss)으로 그려줘. 무료로 누르면 POST /gacha/pull {count:1, pay:"free"} 응답의 freeLeft 0 · nextFreeAt 11-20 05:00으로 버튼을 바꾸고, 05:00 일일 초기화 신호 뒤에만 다시 무료로 돌리며 10회 버튼은 "10회 · 무료 대상 아님"으로 그대로 두게 해줘.
라이브 데모 열기 — 하루 1회 무료 뽑기 (1회 버튼만 · 비용 순서 무료 → 티켓 → 젬 · 쓰면 "젬 160 + 무료까지 18시간 42분" · 05:00 서버 초기화 뒤 다시 무료 · 10회는 대상 아님)
연령 확인 뒤 뽑기 (미확인은 버튼 자리에 안내 · 생년월만 보내고 나이는 서버 계산 · 결과는 계정에 1번 저장 · 지역 규칙이면 보호자 동의 안내 · 미확인 요청 403)
Age verification before gacha: guidance in place of pull buttons, server-side age and regional rule, stored once per account
연령 확인이 필요한 지역에서 뽑기 버튼을 언제 열지 정하는 카드다. 확인 전 계정은 버튼 자리에 이유와 "확인하기"를 두고, 생년월만 서버로 보내 서버가 지역 설정의 기준 나이로 성인 · 보호자 동의 필요를 판정해 계정에 한 번 저장하며, 서버도 미확인 계정의 뽑기 요청을 403으로 거절한다. 기준 나이와 문구는 나라 · 스토어마다 다르므로 코드가 아니라 지역 설정 키로 둔다(이 카드의 규칙은 가상 예시).
프롬프트
뽑기 배너에서 서버 ageStatus가 unverified면 1회 · 10회 버튼 대신 자물쇠 아이콘 + "뽑기 전에 연령 확인이 필요해요" + 확인하기 버튼을 그리고, 누르면 280 ms 시트에 년 · 월 휠 두 개를 띄워 확인 시 {birth:"2001-05"}만 보내줘. 상태를 unverified → verifying → adult | guardian_required로 두고 adult면 버튼을 열어 다시 묻지 않으며, guardian_required면 "이 지역 기준 보호자 동의가 필요해요" 패널과 동의 요청 버튼을 두고, 기준 나이 · 문구는 지역 설정 키에서 읽어줘.
라이브 데모 열기 — 연령 확인 뒤 뽑기 (미확인은 버튼 자리에 안내 · 생년월만 보내고 나이는 서버 계산 · 결과는 계정에 1번 저장 · 지역 규칙이면 보호자 동의 안내 · 미확인 요청 403)
뽑기 확인 창의 젬 내역 (10회 1,600 = 무상 1,200 + 유상 400 · 뽑은 뒤 남는 양 · 무상 먼저는 가상 예시 · 취소가 먼저 · 응답 지갑으로 덮기)
Pull confirmation with a free/paid gem breakdown, post-pull balances and server wallet overwrite
유상 · 무상 젬을 따로 관리하는 게임에서 뽑기 확인 창에 무엇을 보여 줄지 정하는 카드다. 차감 순서(예시: 무상 먼저)로 이번 뽑기에서 각각 얼마가 빠지는지와 뽑은 뒤 남는 양을 줄로 나눠 보여 주고, 실제 차감은 서버가 해 응답 지갑으로 두 값을 덮는다. 합계만 보여 주면 유상 젬이 쓰였는지 알 수 없고, 화면에서 빼기 계산을 하면 다른 기기 구매와 어긋난다. 차감 순서와 표시 의무는 나라 · 스토어마다 다르다.
프롬프트
10회 뽑기 확인 창에 "쓸 젬" 아래 무상 젬 · 유상 젬 두 줄을 min(무상, 1,600)과 나머지로 나눠(예: 무상 1,200 + 유상 400, 무상 3,000이면 1,600 + 0) 오른쪽 정렬 쉼표 숫자로 쓰고, 합계 1,600 줄과 "뽑은 뒤 남는 양: 무상 0 · 유상 1,600"을 보여줘. 버튼은 취소(왼쪽)와 뽑기를 같은 크기로 두고 바깥 탭도 취소로 하며, 뽑기 응답의 wallet {free, paid}로 두 막대를 400 ms 보간해 덮고 순서 문구는 "가상 예시 · 나라마다 다름"으로 표기해줘.
라이브 데모 열기 — 뽑기 확인 창의 젬 내역 (10회 1,600 = 무상 1,200 + 유상 400 · 뽑은 뒤 남는 양 · 무상 먼저는 가상 예시 · 취소가 먼저 · 응답 지갑으로 덮기)
목표 지정 (픽업 2개 중 하나 · 서버 저장 응답 뒤에 배너에 표시 · 지정 전 뽑기 버튼 잠금 · 뽑기 요청 중 변경 잠금 · 포인트는 응답 값)
Pickup target selection: server-saved target shown after confirmation, pull locked until set, changes locked during a pull
픽업 대상이 둘인 배너에서 목표를 고르는 흐름의 상태를 정하는 카드다. 시트에서 고른 목표는 PUT 응답이 온 뒤에야 배너에 이름이 뜨고, 지정 전에는 뽑기 버튼을 이유와 함께 잠그며, 뽑기 요청이 도는 동안에는 목표 바꾸기를 잠가 요청과 목표가 어긋나지 않게 한다. 포인트 규칙은 서버가 정하므로 화면은 응답의 points만 그린다.
프롬프트
무기 픽업 배너에 "목표: 지정 안 됨 · 바꾸기" 줄을 두고 누르면 280 ms 시트에 두 무기 카드(선택 시 테두리)와 저장 버튼을 띄워, 저장은 PUT /gacha/b9/target {id} → 200 뒤에만 "목표 화염창 · 포인트 0 / 2"로 표시해줘. 상태를 미지정 → 저장 중 → 지정됨 ⇄ 뽑는 중 잠금으로 두고 미지정이면 10회 버튼을 잠근 채 "목표를 먼저 정해 주세요", 뽑기 요청 중에는 바꾸기 자리에 자물쇠를 두고 응답의 points(0 → 1)를 그대로 그려줘.
라이브 데모 열기 — 목표 지정 (픽업 2개 중 하나 · 서버 저장 응답 뒤에 배너에 표시 · 지정 전 뽑기 버튼 잠금 · 뽑기 요청 중 변경 잠금 · 포인트는 응답 값)
확률표 버전 (보던 표 rateVer를 요청에 실음 · 표가 바뀌었으면 409 RATE_CHANGED · 차감 0 · 바뀐 줄 먼저 보여 주고 다시 요청 · 기록 줄마다 rateVer)
Odds table version on the pull request: 409 on a changed table with no deduction, diff shown first, version stored per history row
사용자가 본 확률표와 실제로 뽑힌 확률표가 같았음을 보장하는 카드다. 배너 화면이 받은 확률표 버전을 뽑기 요청에 같이 보내 서버의 현재 버전과 다르면 차감 없이 409로 돌려보내고, 화면은 바뀐 줄을 보여 준 뒤 새 버전으로 다시 요청하며 기록에는 줄마다 버전을 남긴다. 버전 확인이 없으면 공지 없이 바뀐 확률로 뽑히고, 나중에 어떤 표로 뽑혔는지 증명할 수 없다. 확률 숫자는 모두 가상 예시다.
프롬프트
뽑기 배너의 "확률 보기 v3" 칩에 서버 rateVer를 표시하고 뽑기 요청에 {rateVer:3}을 실어, 서버 현재 버전이 4면 409 RATE_CHANGED {now:4}로 차감 0 거절하게 해줘. 화면은 "확률표가 바뀌었어요 (v3 → v4)" 창에 바뀐 줄(서리검 1.000 → 1.200 %, 그 외 4명 각 0.250 → 0.200 %, 전설 합계 2.000 그대로, 0.001 % 정수 저장)과 "재화는 빠지지 않았어요"를 보여 주고, "v4로 뽑기"는 새 멱등 키로 다시 보내 기록 줄에 rateVer 4를 남겨줘.
라이브 데모 열기 — 확률표 버전 (보던 표 rateVer를 요청에 실음 · 표가 바뀌었으면 409 RATE_CHANGED · 차감 0 · 바뀐 줄 먼저 보여 주고 다시 요청 · 기록 줄마다 rateVer)
배너 링크로 들어오기 (gacha?banner=b7 · 배너 목록 응답 status로 판정 · 진행 중 = 그 탭 · 종료 = 첫 배너 + 토스트 · 시작 전 = 시작 시각 토스트 · 없음 = 조용히 첫 화면)
Deep link into a gacha banner resolved by server banner status: live, ended, upcoming and unknown destinations
공지 · 푸시의 배너 링크가 어디로 데려갈지 정하는 카드다. 링크의 배너 id를 기기 시계가 아니라 배너 목록 응답의 상태로 판정해 진행 중이면 그 탭을 고르고, 끝났거나 아직 시작 전이면 첫 배너를 보여 주며 이유와 시작 시각을 토스트로, 모르는 id면 조용히 뽑기 첫 화면을 연다. 판정 없이 링크 그대로 열면 끝난 배너 화면에 갇히거나 빈 화면이 뜬다.
프롬프트
앱이 gacha?banner=b7 링크로 열리면 로그인 · 배너 목록 응답을 기다린 뒤 b7의 status로 분기해줘: live → b7 탭 선택, ended → 첫 배너 + "종료된 배너예요 · 지금 배너를 보여 드려요" 토스트 4 s, upcoming → 첫 배너 + "11-22 05:00에 시작해요" 토스트, 목록에 없음 → 첫 화면만. 같은 링크를 두 번 열어도 결과가 같게 상태를 남기지 말고, 뒤로는 링크 이전 화면이 아니라 허브로 보내줘.
라이브 데모 열기 — 배너 링크로 들어오기 (gacha?banner=b7 · 배너 목록 응답 status로 판정 · 진행 중 = 그 탭 · 종료 = 첫 배너 + 토스트 · 시작 전 = 시작 시각 토스트 · 없음 = 조용히 첫 화면)
결과 화면 "한 번 더" 비용 줄 (첫 뽑기 전 줄 재사용 금지 · 응답 지갑 티켓 0 · 젬 880으로 다시 계산 → 젬 1,600 · 720 부족 · 확인 창 다시 거침)
Pull-again button on the result screen: cost line rebuilt from the response wallet, shortfall shown, confirmation repeated
10회 결과 정리 화면의 "한 번 더" 버튼이 어떤 지갑으로 비용 줄을 만들지 정하는 카드다. 첫 뽑기 전에 만든 "티켓 3 + 젬 1,120" 줄을 재사용하지 않고, 결과 응답에 같이 온 지갑(티켓 0 · 젬 880)으로 다시 계산해 "젬 1,600 · 720 부족"처럼 보여 주며, 누르면 확인 창을 다시 거친다. 옛 줄을 쓰면 서버 가격과 다른 버튼을 누르게 되어 409를 맞거나 사용자가 예상과 다른 차감을 본다.
프롬프트
10회 결과 화면(5 × 2 칸) 아래 "한 번 더 10회" 버튼의 비용 줄을 결과 응답 wallet {tickets 0, gems 880}로 다시 계산해 티켓 먼저 → 젬 160씩 규칙으로 "젬 1,600"을 쓰고, 모자라면 "젬 720 부족"(1,600 − 880)을 붙여 누르면 부족 안내로 보내줘. 첫 뽑기 전 줄(티켓 3 + 7 × 160 = 젬 1,120)은 버리고, 한 번 더도 같은 확인 창과 새 멱등 키를 거치게 해줘.
라이브 데모 열기 — 결과 화면 "한 번 더" 비용 줄 (첫 뽑기 전 줄 재사용 금지 · 응답 지갑 티켓 0 · 젬 880으로 다시 계산 → 젬 1,600 · 720 부족 · 확인 창 다시 거침)
점검 전 잠금 (서버 공지 startAt 04:00 기준 · 5분 전 뽑기 잠금 · 1분 전 우편 · 출석 · 패스 받기 잠금 · 시작 뒤 요청 503 · 차감 0)
Pre-maintenance locks: pulls locked 5 minutes and claims 1 minute before a server-announced start, 503 with no deduction afterwards
정기 점검 직전에 무엇을 언제 잠글지 정하는 카드다. 서버 공지의 시작 시각을 기준으로 결과 · 연출이 점검을 넘지 않게 5분 전 뽑기를, 1분 전 우편 · 출석 · 패스 받기를 잠그고 카운트다운을 보이며, 잠금 전에 들어온 요청은 서버가 끝까지 처리하고 시작 뒤 요청은 503에 차감 없이 거절한다. 잠금이 없으면 점검 시작과 동시에 날아간 뽑기가 결과 모름 상태로 남아 문의가 몰린다.
프롬프트
로비 상단에 "04:00 점검 · mm:ss 남음" 띠를 서버 공지 startAt과 서버 시각 오프셋으로 계산해 보여 주고, startAt − 5분부터 뽑기 버튼을 "잠김 · 점검 5분 전부터"로, startAt − 1분부터 우편 모두 받기 · 출석 · 패스 받기 버튼을 잠가줘. startAt이 되면 "점검 중이에요 · 04:00 – 06:00" 화면으로 바꾸고, 서버는 그 뒤 요청을 503 MAINTENANCE · 차감 0으로 거절하며 끝나면 자동 재연결 뒤 다시 시도하게 해줘.
라이브 데모 열기 — 점검 전 잠금 (서버 공지 startAt 04:00 기준 · 5분 전 뽑기 잠금 · 1분 전 우편 · 출석 · 패스 받기 잠금 · 시작 뒤 요청 503 · 차감 0)
출석 알림 예약 (안 받은 날만 21:00 로컬 알림 1개 · 받으면 오늘 것 취소 + 내일 21:00 예약 · 앱 열 때 다시 계산 · 알림 끄면 모두 취소 · 방해 금지 시간 밖)
Attendance reminder scheduling: one local notification at 21:00 only on unclaimed days, rescheduled on claim, app open and settings change
출석을 잊은 날에만 알림이 오도록 로컬 알림 예약을 관리하는 카드다. 출석을 받은 직후 오늘 21:00 예약을 지우고 내일 21:00을 걸며, 앱을 열 때 오늘 안 받았고 21:00 전이면 오늘 것을 다시 걸고, 알림 설정을 끄면 모두 지운다. 매일 같은 시각에 고정 반복 알림을 걸면 이미 받은 날에도 알림이 와서 사람들이 알림을 끈다.
프롬프트
출석 보상 수령 성공 콜백에서 오늘 21:00 로컬 알림(id attend_1119)을 취소하고 내일 21:00 "오늘 출석을 아직 안 받았어요 · 13일차 · 젬 50" 알림을 예약해줘. 앱 시작 때 오늘 안 받았고 지금이 21:00 전이면 오늘 21:00을 다시 예약하고, 알림 설정에서 출석 알림을 끄면 예약을 모두 취소하며, 예약은 하루 1개만 두고 방해 금지 22:00–08:00과 겹치지 않게 해줘. 알림을 누르면 출석판으로 바로 열어줘.
라이브 데모 열기 — 출석 알림 예약 (안 받은 날만 21:00 로컬 알림 1개 · 받으면 오늘 것 취소 + 내일 21:00 예약 · 앱 열 때 다시 계산 · 알림 끄면 모두 취소 · 방해 금지 시간 밖)