목록 상태 전이도 (loading → success | empty | error · success → refreshing | loadingMore)
List screen state machine: loading → success / empty / error, success → refreshing / loadingMore, and only those transitions
목록 화면을 isLoading · isError · isEmpty 같은 불리언 여러 개로 그리지 않고 loading · success · empty · error · refreshing · loadingMore 여섯 상태와 허용된 전이만 두는 결정이다. 첫 로드 · 새로고침 · 다음 쪽 · 필터 변경이 한 화면에서 모두 일어나는 피드라면 처음부터 이렇게 잡는다. 이게 없으면 새로고침 중에 스켈레톤이 뜨거나 오류 화면 위에 빈 상태 문구가 겹치는 조합이 생긴다.
프롬프트
동네 소식 목록 화면을 loading · success · empty · error · refreshing · loadingMore 여섯 상태의 상태 기계(useReducer)로 만들어줘. loading은 카드 4장 스켈레톤, 응답 n>0이면 success, n=0이면 empty(원인 문구 + 버튼), 오류나 10초 시간 초과면 error(다시 시도), success에서 당기면 refreshing(목록 유지 + 위 표시), 끝 5개 전이면 loadingMore(맨 아래 한 줄)로만 가게 하고, 표에 없는 전이 요청은 무시해줘.
라이브 데모 열기 — 목록 상태 전이도 (loading → success | empty | error · success → refreshing | loadingMore)
새로고침은 내용을 지우지 않는다 (이전 목록 유지 + 위 얇은 표시 · 실패면 그대로 두고 토스트 4초)
Pull-to-refresh that keeps the current list: a thin top progress line while refetching, new items pushed in on success, the list untouched plus a 4 s toast on failure
새로고침 때 목록을 비우고 스피너를 띄우면 응답이 오는 1초 동안 빈 화면이 되고, 실패하면 보던 목록까지 사라진다. 기존 목록은 그대로 두고 위에 2 px 진행 선만 그린 뒤 성공하면 첫 쪽만 갈아 끼우고, 실패하면 목록을 둔 채 토스트로 알린다. 왼쪽 A는 비우는 구현, 가운데 B는 유지하는 구현이고 오른쪽 띠에 사용자가 실제로 본 화면이 쌓인다.
프롬프트
피드 당겨서 새로고침을 구현해줘: 손을 떼면 기존 목록은 그대로 두고 상단 바 아래 2 px 진행 선만 표시, 성공하면 첫 쪽(20개)을 교체하고 새 글은 200 ms로 위에서 밀어 넣어줘. 실패(5xx · 10초 시간 초과)면 목록을 건드리지 말고 "새로고침 실패 · 목록 그대로" 토스트를 4초 띄우고, 새로고침 중에 다시 당기면 요청을 하나 더 보내지 말아줘.
라이브 데모 열기 — 새로고침은 내용을 지우지 않는다 (이전 목록 유지 + 위 얇은 표시 · 실패면 그대로 두고 토스트 4초)
커서 페이지 (마지막 항목 id 다음 20개 · 쪽 번호 방식은 새 글이 끼면 중복)
Cursor pagination vs offset: ?after=<last id>&limit=20 keeps page boundaries when a new post is inserted, ?offset= repeats an item (or skips one after a delete)
최신순 피드에서 1쪽을 받은 뒤 새 글 1개가 들어오면 offset 요청은 경계가 한 칸 밀려 1쪽 마지막 글을 다시 받고, 글이 지워지면 하나를 건너뛴다. 다음 쪽을 "마지막으로 받은 항목 id 다음부터"로 요청하면 글이 끼어들거나 지워져도 경계가 그대로다. 쪽 번호가 꼭 필요한 관리 표가 아니라면 피드 · 댓글 · 알림은 커서로 만든다.
프롬프트
동네 소식 피드 API를 GET /posts?after=<마지막 id>&limit=20 커서 방식으로 만들어줘(정렬 created_at DESC, id DESC, 조건 (created_at, id) < (:c, :id)). 응답은 items와 nextCursor(없으면 null)로 주고 클라이언트는 받은 마지막 항목으로 다음 커서를 만든다. 비교용으로 offset 방식에서 1쪽을 받은 뒤 새 글 1개가 들어오면 #26이 두 번 오는 테스트도 붙여줘.
라이브 데모 열기 — 커서 페이지 (마지막 항목 id 다음 20개 · 쪽 번호 방식은 새 글이 끼면 중복)
받은 쪽 합치기 (id로 중복 제거 · 이미 있으면 내용만 갱신)
Merging fetched pages by id: an order array plus a byId map, new ids appended, known ids updated in place, never two cards for one id
재시도 응답이 늦게 오거나, 새로고침 쪽과 다음 쪽이 겹치거나, 실시간 갱신이 같은 글을 다시 보내면 배열에 그대로 이어 붙인 목록에는 같은 카드가 두 장 생긴다. 받은 항목마다 byId에 있으면 값만 덮어쓰고 없을 때만 order 끝에 붙이면 카드 수는 그대로이고 좋아요 수 같은 값만 최신이 된다. 리스트 key 경고와 "두 번 보이는 글" 버그를 없애는 기본 장치다.
프롬프트
피드 목록 상태를 order: string[]과 byId: Record<string, Post>로 두고 mergePage(page) 함수를 만들어줘: 이미 있는 id는 Object.assign으로 값만 갱신(위치 유지), 새 id만 order 끝에 추가하고 받은 수 · 새 항목 수 · 갱신 수를 반환해줘. 5개 중 2개가 겹치는 쪽 2와 실시간 1건(#29 좋아요 7 → 8)을 넣어 카드가 8장 그대로인지 확인하는 테스트도 써줘.
라이브 데모 열기 — 받은 쪽 합치기 (id로 중복 제거 · 이미 있으면 내용만 갱신)
다음 쪽 미리 받기 (끝에서 5개 남았을 때 · 요청 중이면 다시 안 보냄)
Prefetching the next page when 5 items remain: a 100 ms-throttled scroll check, a single in-flight guard and a stop when there is no next cursor
맨 끝에 닿아야 다음 쪽을 부르면 스피너 줄이 매번 보이고, 문턱만 두고 요청 중 표시가 없으면 스크롤 이벤트마다 같은 쪽 요청이 여러 개 나간다. 보이는 마지막 항목이 "불러온 수 − 5"에 닿으면 요청하되 요청 중인 동안의 검사는 막고, 다음 커서가 없으면 검사를 멈춘다. 오른쪽 띠의 100 ms 검사 눈금 가운데 초록만 요청이 되고 노란 것은 막힌 검사다.
프롬프트
피드에 다음 쪽 미리 받기를 넣어줘: 스크롤 검사는 100 ms 간격으로 하고, 화면에 보이는 마지막 항목 index ≥ 불러온 수 − 5이면 fetchNextPage()를 부르되 isFetchingNextPage면 보내지 말고(막은 횟수 기록), nextCursor가 null이면 검사를 끝내줘. 쪽 크기 20, 가짜 응답 500 ms로 만들고 사용자가 끝에 닿기 전에 새 쪽이 붙어 스피너 줄이 보이지 않는지 확인해줘.
라이브 데모 열기 — 다음 쪽 미리 받기 (끝에서 5개 남았을 때 · 요청 중이면 다시 안 보냄)
다음 쪽 실패 처리 (받은 40개 유지 · 실패한 쪽 커서 보관 · 누를 때만 같은 커서로 한 번)
Next-page request failure: keep the 40 loaded items and the failed page cursor, mark only the loader row, re-request that cursor once on tap with zero automatic attempts
3쪽 요청이 실패했다고 화면 전체를 오류 상태로 바꾸면 이미 읽던 40개가 사라진다. 실패는 맨 아래 불러오기 줄에만 표시하고 커서(#40)는 그대로 두었다가 사용자가 "다시 시도"를 누를 때 같은 커서로 한 번만 다시 보낸다. 바닥에 닿을 때마다 자동으로 다시 부르면 연결이 나쁜 곳에서 요청이 끝없이 쌓이므로 다음 쪽은 자동 재시도를 하지 않는다.
프롬프트
피드 다음 쪽 실패 처리를 만들어줘: 실패해도 이미 받은 쪽은 그대로 두고 목록 맨 아래 줄만 "다음 글을 불러오지 못했어요 · 다시 시도"(높이 24)로 바꾸며, 자동 재시도는 0회, 버튼을 누르면 같은 after=#40 커서로 다시 요청해 성공하면 줄을 지우고 20개를 붙여줘. 실패 줄이 보이는 동안 위로 스크롤해도 목록과 스크롤 위치가 바뀌지 않게 해줘.
라이브 데모 열기 — 다음 쪽 실패 처리 (받은 40개 유지 · 실패한 쪽 커서 보관 · 누를 때만 같은 커서로 한 번)
끝 판정 (받은 수 20 미만 또는 다음 커서 없음 → 끝 줄 · 더 요청 안 함)
End-of-list detection: fewer than 20 items or a null next cursor sets hasNext = false, shows an end row and stops further requests (vs empty requests on every bounce)
마지막 쪽을 받은 뒤에도 끝 판정이 없으면 사용자가 바닥에서 튕길 때마다 빈 응답을 받는 요청이 나가고 스피너가 깜빡인다. 서버가 nextCursor를 null로 주거나 받은 수가 쪽 크기(20)보다 적으면 hasNext = false로 두고 "모두 봤어요 · 47개" 끝 줄을 보여 준 뒤 검사 자체를 멈춘다. 서버 쪽 필터 때문에 20개 미만이 와도 다음이 있을 수 있는 API라면 nextCursor만 기준으로 삼는다.
프롬프트
무한 피드의 끝 판정을 만들어줘: 응답이 { items, nextCursor }일 때 nextCursor === null 또는 items.length < 20이면 hasNext = false로 두고 목록 끝에 "모두 봤어요 · 총 N개 · 맨 위로" 줄을 그린 뒤 더 이상 다음 쪽 요청을 보내지 말아줘. 끝에서 세 번 튕겨도 요청이 0회인지, 비교로 판정이 없을 때 빈 요청 3회가 나가는지 로그로 보여 줘.
라이브 데모 열기 — 끝 판정 (받은 수 20 미만 또는 다음 커서 없음 → 끝 줄 · 더 요청 안 함)
낡은 데이터 먼저 (5분 지난 캐시를 바로 보여 주고 뒤에서 받아 바뀐 카드만 교체)
Stale-while-revalidate list: show the cached list instantly, refetch in the background when it is older than 5 minutes and swap only the cards that changed
탭을 다시 열 때마다 캐시를 버리고 스켈레톤부터 그리면 같은 목록을 보는데도 1.2초씩 빈 화면이 생긴다. 캐시가 있으면 바로 그리고, 받은 지 5분이 지났으면(stale) 뒤에서 다시 받아 값이 바뀐 카드 두 장만 교체하며 스크롤 위치는 건드리지 않는다. 5분 안에 돌아오면 요청 자체를 보내지 않는다.
프롬프트
TanStack Query로 피드 목록을 staleTime 5분, gcTime 30분으로 만들어줘: 캐시가 있으면 스켈레톤 없이 즉시 그리고, stale이면 뒤에서 다시 받아 id별로 비교해 바뀐 카드만 120 ms 교차 페이드(바뀐 카드 테두리 600 ms 강조)로 바꾸며 스크롤 위치는 유지해줘. 상단 바 오른쪽에 '방금 갱신'을 3초 보여 주고, 5분 안에 다시 들어오면 요청을 보내지 않게 해줘.
라이브 데모 열기 — 낡은 데이터 먼저 (5분 지난 캐시를 바로 보여 주고 뒤에서 받아 바뀐 카드만 교체)
상세에서 돌아왔을 때 (목록 · 스크롤 위치 · 불러온 쪽 수 그대로 · 다시 받지 않음)
Back from detail keeps the list state: loaded pages, cursor and an anchor item id + offset survive and nothing is refetched (vs a remount that reloads page 1 at the top)
상세로 갈 때 목록 컴포넌트가 사라지고 돌아올 때 다시 마운트되면 첫 쪽만 새로 받아 맨 위에서 시작하고, 내려서 불러온 2~3쪽은 날아간다. 목록 상태(불러온 쪽 · 다음 커서)는 화면 밖 캐시에 두고 위치는 픽셀이 아니라 "기준 항목 id + 위에서 몇 px"로 저장해, 돌아오면 그대로 그리고 요청은 0회다. 이미지가 늦게 와서 카드 높이가 바뀌어도 기준 항목 덕분에 같은 글이 같은 자리에 온다.
프롬프트
목록 → 상세 → 뒤로 흐름을 만들어줘: 목록 상태(불러온 쪽 3개 · nextCursor)는 쿼리 캐시에 남기고, 떠날 때 화면 맨 위에 걸친 카드 id와 그 카드의 위쪽 오프셋(px)을 저장했다가 돌아오면 그 카드를 같은 오프셋에 놓아줘. 돌아올 때 네트워크 요청은 0회, 상세 전환은 320 ms로 하고, 비교용으로 리마운트 때 1쪽부터 다시 받는 구현도 같이 보여 줘.
라이브 데모 열기 — 상세에서 돌아왔을 때 (목록 · 스크롤 위치 · 불러온 쪽 수 그대로 · 다시 받지 않음)
상세 화면 먼저 채우기 (목록이 가진 제목 · 사진 · 좋아요로 즉시 그림 → 본문만 뒤에 받아 채움)
Seeding the detail screen from the list item: title, thumbnail, author and like count render at 0 ms while body and comments fill in from the detail request
상세 화면이 자기 요청만 기다리면 전환이 끝난 뒤에도 480 ms 동안 빈 화면에 스피너가 돈다. 목록 항목이 이미 가진 제목 · 썸네일 · 작성자 · 좋아요 수로 상세를 바로 그리고, 본문과 댓글 칸만 스켈레톤으로 두었다가 상세 응답으로 채운다. 썸네일은 원본이 오면 교체하되 사진 자리 크기는 처음부터 그대로다.
프롬프트
상세 화면 쿼리에 목록 캐시를 placeholderData로 넣어줘: queryClient에서 id가 같은 목록 항목을 찾아 제목 · 썸네일 · 작성자 · 좋아요 수를 0 ms에 그리고, 본문 4줄과 댓글은 스켈레톤으로 두었다가 상세 응답(가짜 480 ms)으로 채워줘. 썸네일은 흐리게 늘려 쓰다가 원본(980 ms)이 오면 120 ms로 바꾸고, 상세 응답이 오면 목록 항목 값도 같이 갱신해줘.
라이브 데모 열기 — 상세 화면 먼저 채우기 (목록이 가진 제목 · 사진 · 좋아요로 즉시 그림 → 본문만 뒤에 받아 채움)
좋아요 낙관 적용 (즉시 +1 · 실패면 250 ms 되돌림 · 연타는 마지막 상태만 300 ms 뒤 전송)
Optimistic like with coalesced requests: heart and count flip instantly, rapid taps send only the final state 300 ms after the last tap, a failure rolls back within 250 ms with a toast
좋아요를 누를 때마다 요청을 보내면 다섯 번 연타에 요청 다섯 개가 나가고, 응답 순서가 뒤집히면 최종 상태가 틀어진다. 화면은 누르는 즉시 바꾸고 요청은 마지막 탭 뒤 300 ms를 기다려 그때의 상태 하나만 보내며, 그 상태가 서버 값과 같으면 아예 보내지 않는다. 실패하면 250 ms 안에 서버 값으로 되돌리고 토스트로 이유를 말한다.
프롬프트
피드 카드 좋아요를 낙관 적용으로 만들어줘: 탭하면 하트와 숫자를 즉시 바꾸고(120 ms 튀김), 서버 요청은 마지막 탭 후 300 ms 디바운스로 그때의 liked 값만 PUT /posts/:id/like로 보내며 그 값이 서버 값과 같으면 보내지 마. 실패하면 250 ms 안에 서버 값으로 되돌리고 "반영하지 못했어요" 토스트를 4초, 요청이 진행 중일 때 다시 누르면 응답 뒤 최신 상태로 한 번 더 보내줘.
라이브 데모 열기 — 좋아요 낙관 적용 (즉시 +1 · 실패면 250 ms 되돌림 · 연타는 마지막 상태만 300 ms 뒤 전송)
목록 ↔ 상세 값 맞추기 (항목을 id로 한 곳에 저장 · 상세에서 누른 좋아요가 목록 카드에도)
Keeping list and detail in sync with a normalised entity store: queries hold ids, each post lives once by id, a like in the detail updates the list card too (vs per-screen copies)
목록 쿼리와 상세 쿼리가 각자 글 사본을 들고 있으면 상세에서 좋아요를 눌러 42가 돼도 돌아온 목록 카드는 다시 받기 전까지 41이다. 글은 entities.post[id] 한 곳에만 두고 목록 쿼리는 id 배열만 가지게 하면 어느 화면에서 바꿔도 같은 값을 읽는다. 사본을 쓸 수밖에 없는 구조라면 변경 때 setQueryData로 목록 쪽 항목도 함께 고친다.
프롬프트
피드 데이터를 정규화해줘: entities.post[id]에 글을 한 번만 저장하고 목록 쿼리는 id 배열만, 목록 카드 · 상세 화면 · 저장한 글 목록은 useSelector(state => state.entities.post[id])로 읽게 해줘. 상세에서 좋아요를 누르면 store.update(12, {likes: 42, liked: true}) 한 번으로 세 화면이 같이 바뀌는지, 비교용으로 화면마다 사본을 둘 때 목록이 41로 남는 것도 보여 줘.
라이브 데모 열기 — 목록 ↔ 상세 값 맞추기 (항목을 id로 한 곳에 저장 · 상세에서 누른 좋아요가 목록 카드에도)
삭제 뒤 목록 (상세에서 지우면 목록에서 200 ms로 빠짐 · 5초 실행 취소 · 요청은 5초 뒤)
Deleting from the detail screen: the post leaves every cached list with a 200 ms collapse, a 5 s undo toast restores it at its original index, and the DELETE is sent only when the window ends
상세에서 글을 지우고 돌아왔는데 목록에 그 카드가 남아 있다가 다시 받을 때 사라지면 지워지지 않은 것처럼 보인다. 삭제를 누르면 목록 · 상세 · 저장 목록 캐시에서 함께 빼고 원래 자리(index)를 보류 기록에 남긴 뒤, 카드를 200 ms로 접고 5초 실행 취소 토스트를 띄운다. 서버 삭제 요청은 5초가 끝날 때 보내고, 취소하면 요청 없이 보류해 둔 자리로 되돌린다.
프롬프트
글 삭제 흐름을 만들어줘: 상세의 ⋯ 메뉴 → 삭제를 누르면 목록으로 돌아가며(320 ms) 모든 목록 캐시에서 그 id를 빼고 { id, index, until: now + 5s }를 보류 목록에 넣고, 카드는 높이 200 ms로 접히며 "글을 삭제했어요 · 실행 취소" 토스트에 5초 진행 선을 그려줘. 5초가 지나면 DELETE /posts/:id를 보내고, 취소하면 요청 없이 같은 index에 200 ms로 되살리며, DELETE가 실패하면 그 자리로 되돌리고 토스트로 알려줘.
라이브 데모 열기 — 삭제 뒤 목록 (상세에서 지우면 목록에서 200 ms로 빠짐 · 5초 실행 취소 · 요청은 5초 뒤)
가상화 문턱 (100행부터 보이는 범위 ± 5행 · 높이가 다른 카드는 잰 값 캐시)
Virtualisation threshold for a variable-height feed: render everything under 100 rows, then only the visible range ± 5 rows, with a measured-height cache replacing a 30 px estimate
400개를 불러온 피드가 카드를 전부 만들어 두면 만든 카드 수가 불러온 수만큼 늘어 스크롤이 무거워지지만, 100행부터 보이는 범위와 위아래 5행만 만들면 15장 안팎에서 멈춘다. 카드 높이가 24~39 px처럼 제각각이면 처음엔 추정값(30)으로 자리를 잡고, 한 번 그린 카드는 잰 높이를 id별로 캐시해 다시 올라와도 위치가 튀지 않게 한다. 100행 미만이면 가상화 비용이 더 커서 그냥 다 그린다.
프롬프트
피드 목록에 TanStack Virtual을 붙이되 항목이 100개 미만이면 그냥 다 그리고, 100개부터 overscan 5로 가상화해줘. 카드 높이는 estimateSize 30으로 시작해 measureElement로 잰 값을 id별 Map에 캐시하고, 이미지가 늦게 와서 높이가 바뀌면 그 아래 위치만 다시 계산해 보이는 카드가 튀지 않게 해줘. 개발 모드에서 "만든 카드 수 / 불러온 수"를 화면 구석에 표시해줘.
라이브 데모 열기 — 가상화 문턱 (100행부터 보이는 범위 ± 5행 · 높이가 다른 카드는 잰 값 캐시)
빈 응답 판정 순서 (401·403 → 5xx·10초 → 필터 켜짐 → 처음 — 판정 함수 하나가 문구 · 버튼을 고름)
Classifying a zero-item response: test 401 / 403, then 5xx or a 10 s timeout, then active filters, else first-time — one decision function picks the copy and the button
빈 배열을 받았는지만 보고 "아직 소식이 없어요"를 띄우면 403이나 시간 초과, 필터 때문에 비었을 때도 같은 문구가 나와 사용자가 할 일을 모른다. 응답을 권한 오류(401 · 403) → 요청 실패(5xx · 10초) → 필터 · 검색 켜짐 → 그 외 순서로 검사해 원인을 정하고, 원인마다 문구와 버튼(가입 요청 · 다시 시도 · 필터 해제 · 첫 글 쓰기)을 다르게 둔다. 빈 상태 그림이 아니라 원인을 고르는 판정 순서가 이 카드의 핵심이다.
프롬프트
목록의 빈 상태를 원인별로 나눠줘: getEmptyCause(res, filters)를 401 · 403 → 'forbidden', 5xx · 네트워크 오류 · 10초 시간 초과 → 'failed', items.length === 0이고 필터 · 검색이 켜져 있으면 'filtered', 그 외 'none' 순서로 판정하고, 각각 '회원만 볼 수 있어요 · 가입 요청', '불러오지 못했어요 · 다시 시도', "'나눔' 소식이 없어요 · 필터 해제(필터를 풀면 23개)", '아직 소식이 없어요 · 첫 글 쓰기'를 보여 줘. 오류 응답을 빈 배열로 바꿔 넘기는 코드가 없는지도 점검해줘.
라이브 데모 열기 — 빈 응답 판정 순서 (401·403 → 5xx·10초 → 필터 켜짐 → 처음 — 판정 함수 하나가 문구 · 버튼을 고름)
구역별 실패 (추천 줄만 실패 → 그 구역만 다시 시도 · 아래 목록은 정상)
Section-level failure on a feed home: notice, recommendations and the main list load independently, a failed secondary section becomes a same-height inline error with its own retry, only a failed main list fails the screen
홈 피드가 공지 · 추천 · 최신 목록 세 요청을 묶어 하나라도 실패하면 화면 전체 오류를 띄우면, 부가 정보인 추천 하나 때문에 읽을 수 있는 목록까지 막힌다. 구역마다 요청과 상태를 따로 두고, 보조 구역이 실패하면 그 자리에 같은 높이의 오류 카드와 "다시" 버튼을 두어 그 요청만 다시 보낸다. 주 목록이 실패할 때만 화면 전체 오류 상태로 간다.
프롬프트
동네 소식 홈을 공지 배너 · 추천 가로 줄 · 최신 목록 세 구역으로 나눠 각자 useQuery와 ErrorBoundary를 두고, 추천이 503이면 그 자리에 높이 32 그대로 "추천을 불러오지 못했어요 · 다시" 카드를 그려 refetch()만 다시 보내줘. 최신 목록이 실패할 때만 화면 전체를 오류 상태로 바꾸고, 각 구역 스켈레톤은 실제 높이와 같게 해 늦게 와도 아래가 밀리지 않게 해줘.
라이브 데모 열기 — 구역별 실패 (추천 줄만 실패 → 그 구역만 다시 시도 · 아래 목록은 정상)
글쓰기 뒤 반영 (내 글을 맨 위에 "올리는 중"으로 · 성공하면 표시 제거 · 실패면 초안으로)
Showing a just-created post: inserted at the top as a 55 % "posting" card, made solid on success, and on failure removed while the composer reopens with the text and photo intact
올리기를 누른 뒤 응답을 기다려 목록을 다시 받으면 내 글이 늦게 보이고, 실패하면 쓴 글과 사진이 함께 사라져 처음부터 다시 써야 한다. 시트를 닫으며 맨 위에 흐린 "올리는 중" 카드를 넣고, 성공하면 흐림을 걷고 초안을 지우며, 실패하면 카드를 150 ms로 빼고 시트를 다시 열어 글과 사진을 그대로 돌려준다. 초안은 성공 응답 전까지 기기에 보관한다(임시 id 교체 규칙은 채팅 구현 카드가 다룬다).
프롬프트
글쓰기 시트에서 올리기를 누르면 초안(글 · 사진)을 IndexedDB에 저장한 채 시트를 280 ms로 닫고 피드 맨 위에 투명도 55% "올리는 중" 카드를 200 ms로 넣어줘. 201이면 카드를 또렷하게 하고 "게시됨" 칩을 0.7초 보인 뒤 초안을 지우고, 실패(5xx · 10초)면 카드를 150 ms로 빼고 시트를 다시 열어 글과 사진을 그대로 채운 뒤 "올리지 못했어요 · 초안 그대로" 토스트를 4초 보여 줘.
라이브 데모 열기 — 글쓰기 뒤 반영 (내 글을 맨 위에 "올리는 중"으로 · 성공하면 표시 제거 · 실패면 초안으로)
오래 비운 뒤 (5분 안 그대로 · 30분 안 위치 유지 + 뒤에서 갱신 · 30분 넘으면 맨 위로 + 새로 받기)
Returning after time away: under 5 minutes nothing happens, 5–30 minutes keeps the position and revalidates in the background, over 30 minutes jumps to the top and reloads from page 1
앱으로 돌아올 때마다 무조건 새로 받으면 잠깐 다른 앱을 다녀온 사람도 읽던 자리를 잃고, 반대로 아무것도 안 하면 하루 지난 글을 최신인 줄 안다. 화면이 숨겨진 시각을 기록해 두고 돌아왔을 때 5분 안이면 그대로, 5~30분이면 위치를 유지한 채 뒤에서 받아 바뀐 카드만 바꾸고, 30분이 넘으면 맨 위로 올려 첫 쪽부터 다시 받고 뒤쪽 쪽은 버린다.
프롬프트
AppState(웹은 visibilitychange)로 피드 화면이 숨겨진 시각을 저장했다가 돌아오면 비운 시간으로 처리를 나눠줘: 5분 미만은 아무 요청 없이 그대로, 5~30분은 스크롤 위치를 유지하고 뒤에서 첫 쪽을 다시 받아 바뀐 카드만 교체, 30분 이상은 400 ms로 맨 위로 올린 뒤 새로고침 상태로 첫 쪽 20개만 다시 받고 나머지 쪽 캐시는 지워줘.
라이브 데모 열기 — 오래 비운 뒤 (5분 안 그대로 · 30분 안 위치 유지 + 뒤에서 갱신 · 30분 넘으면 맨 위로 + 새로 받기)
사라진 글 (상세가 404 → 안내 + 목록에서도 빼기 · 5xx는 다시 시도 · 목록 유지)
Handling a vanished post: a 404 / 410 on the detail request replaces the body with a deleted notice and removes the id from cached lists, 403 hides it, 5xx keeps it with a retry
목록에 남아 있던 글을 열었는데 이미 삭제됐다면 상세는 빈 화면이나 일반 오류를 띄우고, 돌아간 목록에는 그 카드가 또 있다. 상세 응답이 404 · 410이면 본문 자리에 "삭제된 글이에요 · 목록으로"를 두고 목록 · 저장 목록 · 알림의 같은 id를 캐시에서 함께 지워, 돌아가면 그 자리가 이미 닫혀 있게 한다. 5xx나 시간 초과는 일시 오류이므로 목록에서 지우지 않고 다시 시도만 준다.
프롬프트
상세 화면 오류를 상태 코드로 나눠줘: 404 · 410이면 목록 값으로 그린 머리(제목 · 사진)는 두고 본문 자리에 "삭제된 글이에요 · 작성자가 지웠어요 · 목록으로"를 보여 주며 setQueriesData로 모든 목록 캐시에서 그 id를 빼고, 403이면 "볼 수 없는 글이에요"로 같은 처리, 5xx · 10초 시간 초과면 "다시 시도"만 주고 목록에는 남겨줘. 돌아갈 때 목록에서 그 카드가 깜빡이며 사라지는 일이 없게 해줘.
라이브 데모 열기 — 사라진 글 (상세가 404 → 안내 + 목록에서도 빼기 · 5xx는 다시 시도 · 목록 유지)
사이 끼는 카드 (5번째마다 자리 · 높이 고정 · 못 받으면 화면 밖은 접고 보이는 자리는 자체 카드)
Interleaved slots in a feed: a fixed-height slot after every 5th post by post index, filled when content arrives, collapsed while still off-screen when there is no fill, replaced by an in-house card if already visible
광고나 추천처럼 끼워 넣는 카드를 응답이 올 때 목록에 넣으면 읽던 글이 한 장 높이만큼 밀리고, 못 받으면 빈 칸이 남는다. 자리는 글 번호 기준(5 · 10 · 15번째 뒤)으로 정해 쪽이 붙어도 움직이지 않게 하고 카드 한 장 높이(30)를 미리 비워 두며, 못 받았을 때 아직 화면 밖이면 높이 0으로 접고 이미 보이는 자리면 같은 높이의 자체 카드로 바꾼다. 광고 표시 문구 규정은 나라와 플랫폼마다 다르니 따로 확인한다.
프롬프트
피드 목록을 [글 5개, 자리, 글 5개, 자리 …]로 조립하는 함수를 만들어줘: 자리 위치는 글 index(5 · 10 · 15 뒤)로 정해 다음 쪽이 붙어도 바뀌지 않게 하고 높이는 카드 1장(30)으로 미리 잡아줘. 자리 내용은 화면 1장 앞에서 요청하고 1초 안에 못 받으면, 그 자리가 아직 뷰포트 밖이면 높이 0으로 접고 보이는 중이면 같은 높이의 "우리 동네 소식을 써 보세요" 자체 카드로 바꿔 화면에 보이는 카드가 한 번도 밀리지 않게 해줘.
라이브 데모 열기 — 사이 끼는 카드 (5번째마다 자리 · 높이 고정 · 못 받으면 화면 밖은 접고 보이는 자리는 자체 카드)
늦은 응답은 제 칸에 (요청마다 번호 · 응답 키가 지금 화면 키와 다르면 그 키 캐시에만 저장)
Late responses after a tab switch: each request carries a sequence number and its query key, a response whose key no longer matches the visible tab is stored under its own key and never painted
탭을 빠르게 바꾸면 먼저 보낸 "나눔" 요청이 나중에 도착해 이미 그려진 "소식" 목록을 덮어쓰는 일이 생긴다. 요청마다 번호와 목록 키를 붙이고, 응답 키가 지금 화면 키와 다르면 화면은 건드리지 않고 그 키의 캐시에만 넣는다. 버리지 않고 넣어 두기 때문에 사용자가 나눔 탭으로 돌아오면 요청 없이 바로 그려진다.
프롬프트
동네 소식 피드의 분류 탭(전체 · 나눔 · 소식)을 구현해줘: 요청마다 증가하는 번호와 키(feed?cat=…)를 붙이고, 응답이 오면 키가 지금 보이는 탭 키와 같을 때만 화면에 그리고 다르면 cache[키]에만 저장해줘. 그 키가 5분 안에 다시 열리면 스켈레톤 없이 캐시로 바로 그리고, 같은 키에 더 새 번호의 응답이 이미 있으면 늦게 온 옛 번호 응답은 버려줘.
라이브 데모 열기 — 늦은 응답은 제 칸에 (요청마다 번호 · 응답 키가 지금 화면 키와 다르면 그 키 캐시에만 저장)
필터가 바뀌면 초기화하는 것 (커서 null · 쪽 0 · hasNext true · 스크롤 0 · 펼침 비움 — 좋아요 · 저장은 그대로)
What a filter change resets: cursor, loaded pages, hasNext, scroll offset and per-card UI state go back to zero, the old list dims until the new first page arrives, entity state such as likes survives
필터를 바꾸면 새 목록 키가 생기는 것이므로 커서 · 불러온 쪽 수 · 끝 여부 · 스크롤 위치 · 펼친 글 같은 목록 상태는 전부 처음으로 돌리고, 글 단위 값(좋아요 · 저장)은 엔티티에 있으니 그대로 둔다. 이전 목록은 지우지 않고 흐리게 둔 채 새 첫 쪽이 오는 순간 교체하면서 스크롤을 0으로 보낸다. 하나라도 빠지면 옛 커서로 다음 쪽을 받아 다른 분류 글이 섞이거나, 새 결과가 820 px 아래에서 시작한다.
프롬프트
피드 분류 칩을 누를 때의 초기화 함수를 만들어줘: 목록 키를 feed?cat=<값>으로 바꾸고 cursor = null, pages = [], hasNext = true, expandedIds = 빈 Set으로 돌린 뒤 after 없이 첫 쪽 20개를 한 번 요청해줘. 응답 전까지 이전 목록은 opacity 0.45로 유지하고, 새 결과를 그리는 순간 scrollTop = 0으로 보내며, 글별 좋아요 · 저장 상태는 엔티티 저장소에 있으니 건드리지 말아줘.
라이브 데모 열기 — 필터가 바뀌면 초기화하는 것 (커서 null · 쪽 0 · hasNext true · 스크롤 0 · 펼침 비움 — 좋아요 · 저장은 그대로)
본문 3줄 자르기와 펼침 기억 (그린 줄 수가 3을 넘을 때만 "더 보기" · 펼친 글은 id Set에 저장)
Clamping post bodies at 3 lines: the "more" link appears only when the measured line count exceeds 3, and expansion is stored in a Set of post ids so a recycled row scrolled back into view stays expanded
피드 본문은 3줄에서 자르되, 줄 수는 그려 본 결과로 재서 3줄을 넘는 글에만 "더 보기"를 붙인다. 펼친 상태를 행 컴포넌트의 state에 두면 가상화 목록이 화면 밖 행을 다른 글에 재사용하는 순간 리셋되어, 스크롤해 돌아오면 다시 3줄로 접혀 있다. 그래서 펼침은 목록 화면이 가진 expandedIds(Set<글 id>)에 두고, 펼칠 때 카드 높이만 바꿔 위쪽 글의 위치는 그대로 둔다.
프롬프트
피드 카드 본문을 -webkit-line-clamp: 3으로 자르고, 첫 렌더에서 실제 줄 수를 재서 3줄을 넘을 때만 "… 더 보기"를 보여줘. 펼친 글 id는 목록 상태의 expandedIds Set에 넣고 행은 그 Set만 읽게 해서, 가상화로 행이 재사용되거나 화면 밖에 나갔다 돌아와도 펼친 채로 남게 하고, 펼칠 때 높이 변화는 120 ms로 하되 스크롤 위치는 고정해줘.
라이브 데모 열기 — 본문 3줄 자르기와 펼침 기억 (그린 줄 수가 3을 넘을 때만 "더 보기" · 펼친 글은 id Set에 저장)
저장 토글이 두 목록에 함께 (낙관 · 피드 카드 아이콘과 "저장한 글" 목록 동시에 · 실패면 둘 다 250 ms 되돌림)
Optimistic save toggle across two lists: the feed card icon flips and the post is inserted into (or removed from) the saved-posts list cache at once, a failure rolls both back within 250 ms with a toast
저장은 숫자가 아니라 "저장한 글" 목록의 구성원이 바뀌는 동작이라, 아이콘만 바꾸면 저장 화면에 들어갔을 때 방금 저장한 글이 없거나 해제한 글이 남아 있다. 누르는 순간 피드 캐시의 saved 값과 저장 목록 캐시를 함께 고치고(맨 위에 넣기 · 빼기), 요청이 실패하면 두 곳을 같은 스냅숏으로 되돌린다. 돈 · 자리와 상관없는 되돌릴 수 있는 동작이라 서버를 기다리지 않는다.
프롬프트
피드의 저장(북마크) 버튼을 낙관 적용으로 만들어줘: 누르면 즉시 posts[id].saved를 뒤집고 saved 목록 캐시의 맨 위에 id를 넣거나(해제면 빼고) PUT 또는 DELETE /saves/:id를 보내줘. 실패하면 두 캐시를 요청 전 스냅숏으로 250 ms 안에 되돌리고 "저장 해제 못 했어요" 토스트를 4초 보여 주며, 같은 글을 연타하면 마지막 상태만 300 ms 뒤에 보내줘.
라이브 데모 열기 — 저장 토글이 두 목록에 함께 (낙관 · 피드 카드 아이콘과 "저장한 글" 목록 동시에 · 실패면 둘 다 250 ms 되돌림)
숨기기는 접히는 줄 (요청은 즉시 · 카드가 14 px "숨긴 글이에요 · 취소" 줄로 접혔다가 5초 뒤 사라짐 · 다른 목록 캐시에서도 제외)
Hiding a post: the request goes out immediately, the card collapses into a 14 px "hidden · undo" row for 5 seconds, then disappears, and the id is filtered out of every cached list (latest, popular, next pages)
숨기기는 지우기와 달리 되돌릴 수 있고 돈이 걸리지 않아 요청을 바로 보내고, 카드는 그 자리에서 작은 "숨긴 글이에요 · 취소" 줄로 접는다. 줄이 5초 동안 남아 있어 실수로 눌러도 같은 자리에서 취소(DELETE)할 수 있고, 시간이 지나면 줄까지 접힌다. 숨긴 id는 hiddenIds에 모아 최신 · 인기 등 모든 목록 캐시와 이후에 받는 쪽에서도 빼야 다른 탭에서 다시 튀어나오지 않는다.
프롬프트
피드 카드 ⋯ 메뉴의 "숨기기"를 구현해줘: 누르면 POST /hide/:id를 즉시 보내고 카드를 200 ms 동안 높이 14 px의 "숨긴 글이에요 · 취소" 줄로 접은 뒤 5초 진행 선이 끝나면 줄도 0으로 접어줘. 5초 안에 취소를 누르면 DELETE /hide/:id와 함께 카드를 원래 높이로 되돌리고, 숨긴 id는 hiddenIds Set에 넣어 모든 목록 캐시와 다음 쪽 병합 때 걸러줘.
라이브 데모 열기 — 숨기기는 접히는 줄 (요청은 즉시 · 카드가 14 px "숨긴 글이에요 · 취소" 줄로 접혔다가 5초 뒤 사라짐 · 다른 목록 캐시에서도 제외)
정렬마다 캐시 키와 위치 따로 (최신 · 인기 = 다른 키 · 돌아오면 보던 px 그대로 · 5분 지난 키만 뒤에서 다시)
Sort switch with one cache entry per sort: latest and popular keep separate data and scroll anchors, switching back restores the old offset with no request, and only a key older than 5 minutes is shown and revalidated
최신 · 인기 정렬이 캐시 하나를 같이 쓰면 바꿀 때마다 목록을 비우고 처음부터 받아 보던 자리를 잃는다. 정렬을 목록 키에 넣어(feed?sort=latest · feed?sort=hot) 데이터와 스크롤 위치(맨 위 글 id + 남은 px)를 키마다 따로 두고, 돌아올 때는 그대로 그린다. 받은 지 5분 안이면 요청을 보내지 않고, 넘었으면 보여 준 채 뒤에서 다시 받아 바뀐 카드만 교체한다.
프롬프트
피드 상단의 최신 · 인기 정렬 전환을 구현해줘: 목록 키에 sort를 넣어 키마다 pages · cursor · 스크롤 앵커(맨 위 글 id + 오프셋)를 따로 저장하고, 전환하면 그 키의 캐시와 위치로 즉시 그려줘. 처음 여는 키만 첫 로드(300 ms 뒤 스켈레톤)를 하고, 받은 지 5분이 지난 키는 화면을 그대로 둔 채 위 2 px 진행 선과 함께 뒤에서 다시 받아 바뀐 카드만 바꿔줘.
라이브 데모 열기 — 정렬마다 캐시 키와 위치 따로 (최신 · 인기 = 다른 키 · 돌아오면 보던 px 그대로 · 5분 지난 키만 뒤에서 다시)
주소로 바로 상세 (목록 없이 열림 · 씨앗 없음 → 0.3초 뒤 스켈레톤 · 뒤로 = 합성한 목록의 첫 로드)
Opening a post from a link: the detail renders without a list seed (skeleton after 300 ms), a synthetic list entry sits under it in the back stack, and back performs the list first load with the detail data already in the entity store
메시지 속 /p/4512 링크로 앱이 열리면 목록에서 가져올 씨앗이 없으니 상세는 일반 첫 로드처럼 0.3초 뒤 스켈레톤을 보이고 응답을 받아 그린다. 이때 뒤로 가기 스택 맨 아래에 목록 화면을 끼워 두지 않으면 뒤로를 누르는 순간 앱이 꺼진다. 뒤로 가면 목록을 첫 로드하고, 상세에서 받은 4512의 값(좋아요 23)은 같은 항목 저장소에 있어 목록 응답과 합쳐진다.
프롬프트
/p/:id 딥링크로 들어오는 경로를 만들어줘: 스택을 [목록(아직 안 받음), 상세 id]로 합성해 열고, 상세는 목록 씨앗이 없으니 GET /posts/:id를 보내 300 ms가 지나면 스켈레톤, 응답이 오면 그 값을 항목 저장소에 넣어줘. 뒤로를 누르면 앱을 닫지 말고 목록 화면을 첫 로드(20개)로 열고, 목록 응답에 같은 id가 있으면 저장소의 같은 항목을 갱신하고, 목록에서 한 번 더 뒤로일 때만 앱을 나가게 해줘.
라이브 데모 열기 — 주소로 바로 상세 (목록 없이 열림 · 씨앗 없음 → 0.3초 뒤 스켈레톤 · 뒤로 = 합성한 목록의 첫 로드)
목록 ↔ 격자 보기 전환 앵커 (맨 위 글 id → index 11 → 격자 3열 줄 3 → 384 pt · 픽셀 유지는 #18로 튐)
List / grid view toggle that keeps the top item: anchor by the first visible post id, convert its index into the other layout (index 11 → grid row 3 → 3 × 128 = 384 pt) instead of keeping the pixel offset
같은 데이터를 목록(줄 120 pt)과 격자(3열, 줄 128 pt)로 바꿔 보여 줄 때 scrollTop 픽셀을 그대로 두면 1,320 pt가 격자에서는 10번째 줄이라 보던 #37 대신 #18이 맨 위에 온다. 전환 직전 맨 위에 보이는 글 id를 앵커로 잡고, 새 배치에서 그 글의 줄을 계산해(floor(11 ÷ 3) = 3) 그 줄로 스크롤한다. 돌아올 때도 같은 계산(11 × 120)을 하므로 몇 번을 바꿔도 같은 글이 보인다.
프롬프트
피드 상단에 목록 ↔ 격자 보기 토글을 만들어줘: 바꾸기 직전 첫 번째로 보이는 글의 id와 index를 앵커로 저장하고, 격자(3열, 타일 120 + 간격 8)로 바꾸면 floor(index ÷ 3) × 128로, 목록(줄 120)으로 바꾸면 index × 120으로 scrollTop을 맞춘 뒤 그 글 테두리를 1초 강조해줘. 픽셀 오프셋을 그대로 옮기는 코드는 쓰지 말고, 보기 상태와 앵커는 화면을 다시 열어도 남게 저장해줘.
라이브 데모 열기 — 목록 ↔ 격자 보기 전환 앵커 (맨 위 글 id → index 11 → 격자 3열 줄 3 → 384 pt · 픽셀 유지는 #18로 튐)
당겨서 새로고침 판정 (저항 0.5 · 목록 64 pt 넘겨 놓아야 요청 · 문턱 전에 놓으면 취소 · refreshing 최소 600 ms · 그동안 당김 무시)
Pull-to-refresh decision logic: finger travel × 0.5 resistance, a request only when the list passed 64 pt at release, a cancel back to idle below it, refreshing held for at least 600 ms at 56 pt and further pulls ignored meanwhile
당김 동작은 idle → pulling → armed → refreshing → done 다섯 상태로 두고, 손가락 이동의 0.5배만 목록을 내려 64 pt를 넘긴 채 놓았을 때만 요청을 보낸다. 문턱 전에 놓으면 아무 요청 없이 200 ms로 되돌아가고, 응답이 200 ms 만에 와도 표시는 56 pt 높이에서 최소 600 ms 머물러 깜빡이지 않게 한다. refreshing 중에 다시 당겨도 요청을 하나 더 만들지 않는다.
프롬프트
피드의 당겨서 새로고침을 상태 기계로 구현해줘: 목록 맨 위에서 아래로 끌면 offset = 손가락 이동 × 0.5, offset ≥ 64 pt면 armed(진동 1번 · 원이 가득 참), 그 상태에서 놓으면 refreshing으로 56 pt에 멈추고 요청을 1번만 보내줘. 64 pt 전에 놓으면 요청 없이 200 ms로 idle에 돌아가고, refreshing은 응답과 상관없이 최소 600 ms 유지 뒤 280 ms로 접으며 그동안의 당김은 무시해줘.
라이브 데모 열기 — 당겨서 새로고침 판정 (저항 0.5 · 목록 64 pt 넘겨 놓아야 요청 · 문턱 전에 놓으면 취소 · refreshing 최소 600 ms · 그동안 당김 무시)
팔로우 상태는 작성자 한 곳에 (posts는 작성자 id만 · 한 번 누르면 그 사람 카드 3장이 함께 · 실패면 3장 250 ms 되돌림)
Follow state stored on the author entity: posts hold only an author id, so one tap updates every card by that author at once, optimistically, and a failed unfollow rolls all of them back within 250 ms
팔로우 버튼 상태를 글 카드마다 복사해 두면 같은 사람이 쓴 카드가 셋일 때 누른 카드만 "팔로잉"으로 바뀐다. 글에는 작성자 id만 두고 following · 팔로워 수는 authors[u7] 한 곳에 저장해, 카드 버튼이 그 값을 읽게 하면 한 번의 변경으로 모든 카드가 함께 바뀐다. 팔로우는 되돌릴 수 있어 낙관으로 적용하고, 실패하면 그 한 곳을 되돌려 카드 전부가 원래대로 돌아간다.
프롬프트
피드 응답을 posts(작성자 id만)와 authors(id, 이름, following, 팔로워 수)로 정규화해 저장하고, 카드의 팔로우 버튼은 authors[post.authorId].following만 읽게 해줘. 누르면 그 작성자 값을 즉시 뒤집고 팔로워 수 ±1, POST 또는 DELETE /follow/:authorId를 보내며, 실패하면 250 ms 안에 되돌리고 "팔로우 취소 못 했어요" 토스트를 4초 보여줘.
라이브 데모 열기 — 팔로우 상태는 작성자 한 곳에 (posts는 작성자 id만 · 한 번 누르면 그 사람 카드 3장이 함께 · 실패면 3장 250 ms 되돌림)
숫자 표기 함수 (1,000부터 1.2천 · 10,000부터 1.2만 · 소수 1자리 버림 · .0 생략 · 글자가 안 바뀌는 +1은 색으로)
Compact count formatting in Korean units: 1,000 → 1천, 1,234 → 1.2천, 9,999 → 9.9천 (truncated, never 10.0천), 10,000 → 1만, a +1 that leaves the string unchanged shown by colour, the full number in the accessible label
좋아요 · 댓글 · 조회 수는 화면 전체가 같은 표기 함수 하나를 쓴다: 999까지 그대로, 1,000부터 천, 10,000부터 만 단위로 소수 1자리를 버림하고 끝이 .0이면 생략한다. 반올림하면 9,999가 "10.0천"이 되어 만 단위와 어긋나므로 버림을 쓴다. 1,234 → 1,235처럼 낙관 +1이 표기를 바꾸지 않으면 하트와 숫자 색으로만 반응을 보이고, 낭독용 이름에는 "좋아요 1,235개" 전체 숫자를 넣는다.
프롬프트
피드 숫자 표기 함수 formatCount(n)를 만들어줘: n < 1,000은 그대로, 1,000 ≤ n < 10,000은 floor(n / 100) / 10 + "천", 그 이상은 floor(n / 1,000) / 10 + "만"으로 하고 끝의 .0은 지워줘(999 → 999, 1,000 → 1천, 9,999 → 9.9천, 10,000 → 1만). 좋아요를 누를 때 문자열이 바뀌면 120 ms 위로 굴리고, 같으면 하트와 숫자 색만 바꾸며, aria-label에는 "좋아요 1,235개"처럼 쉼표가 있는 전체 숫자를 넣어줘.
라이브 데모 열기 — 숫자 표기 함수 (1,000부터 1.2천 · 10,000부터 1.2만 · 소수 1자리 버림 · .0 생략 · 글자가 안 바뀌는 +1은 색으로)
피드 키보드 · 낭독 (카드 1장 = 탭 정지점 1 · "글 15 / 20" · 새 쪽은 "20개 더 불러옴" 1번 · 상세에서 돌아오면 그 카드에 포커스)
Feed keyboard and screen-reader contract: one tab stop per card with position and set size, inner buttons tabbable only inside the card, a single polite "20 more loaded" announcement per page, focus returned to the opened card
좋아요 · 댓글 · 저장 · 공유 · 메뉴 버튼이 전부 정지점이면 카드 5장을 지나는 데 Tab이 25번 필요하다. 카드 하나를 정지점 하나(role=article, "글 15 / 20, 모래, 좋아요 9")로 두고 안쪽 버튼은 카드 안에서만 Tab으로 들어가게 하며, aria-setsize는 받은 개수를 따라간다. 다음 쪽이 붙으면 "20개 더 불러옴"을 polite로 한 번만 알리고, 상세에서 돌아오면 연 카드로 포커스를 돌려준다.
프롬프트
피드 목록을 role="feed"로 만들고 카드마다 tabIndex=0인 article 하나(aria-posinset = 순번, aria-setsize = 받은 개수, 이름 = "글 N / 전체, 작성자, 좋아요 수")만 정지점으로 두고 안쪽 버튼은 tabIndex=-1에서 카드에 들어갔을 때만 이동되게 해줘. 포커스가 끝에서 5번째 카드에 오면 다음 쪽을 받고 붙은 뒤 aria-live polite로 "20개 더 불러옴"을 1번만 읽게 하며, 포커스 링은 2 px + 간격 2 px, Enter로 연 상세에서 돌아오면 그 카드에 포커스를 돌려줘.
라이브 데모 열기 — 피드 키보드 · 낭독 (카드 1장 = 탭 정지점 1 · "글 15 / 20" · 새 쪽은 "20개 더 불러옴" 1번 · 상세에서 돌아오면 그 카드에 포커스)
스켈레톤 개수와 높이 (올림(651 ÷ 120) = 6개 · 진짜 카드 112 pt와 같은 높이 · 80 pt 10개는 2개 낭비에 32 pt씩 밀림)
Skeleton count and height for a feed: ceil(viewport 651 pt ÷ (card 112 + gap 8)) = 6 placeholders at the real card height, versus 10 fixed 80 pt placeholders that waste 2 off-screen and push each card 32 pt when data arrives
스켈레톤 개수는 화면 높이(844 − 상태 표시줄 47 − 상단 바 56 − 탭 56 − 아래 34 = 651 pt)를 카드 한 칸(112 + 간격 8)으로 나눠 올림한 6개로 정하고, 높이는 진짜 카드와 똑같이 112로 둔다. 습관처럼 80 pt짜리 10개를 깔면 2개는 화면 밖에서 낭비되고, 데이터가 오는 순간 카드마다 32 pt씩 늘어나 6번째 카드가 160 pt 밀린다. 화면 회전이나 글자 200 %에서는 다시 계산한다.
프롬프트
피드 첫 로드 스켈레톤을 만들어줘: 개수는 Math.ceil(목록 영역 높이 ÷ (카드 높이 + 간격))로 계산해 화면 회전 · 글자 크기 변경 때 다시 구하고, 각 스켈레톤은 실제 카드와 같은 높이(112 pt) · 같은 아바타 · 줄 자리로 그려줘. 데이터가 오면 같은 자리에서 120 ms 교차 페이드로 바꿔 레이아웃 이동이 0이 되게 하고, 고정 개수 배열은 쓰지 말아줘.
라이브 데모 열기 — 스켈레톤 개수와 높이 (올림(651 ÷ 120) = 6개 · 진짜 카드 112 pt와 같은 높이 · 80 pt 10개는 2개 낭비에 32 pt씩 밀림)
자동 재시도는 첫 로드만 (1 → 2 → 4초 ±20 % · 3번 뒤 버튼 · 다음 쪽 · 뒤 갱신 · 좋아요 · 4xx는 자동 재시도 없음)
Which feed requests retry on their own: only the first load, at 1 → 2 → 4 s with ±20 % jitter, three times, then a manual button — next page, background refresh, likes and 4xx responses never retry automatically
재시도 정책을 요청마다 같은 값으로 두면 좋아요가 몰래 세 번 다시 나가거나, 뒤 갱신 실패가 배터리를 쓰며 계속 돈다. 보여 줄 것이 없는 첫 로드만 1 · 2 · 4초(±20 % 흔들림, 예: 1.1 · 1.8 · 4.3초)로 세 번 자동 재시도하고, 그 뒤에는 사람이 "다시 시도"를 누를 때만 보낸다. 다음 쪽은 맨 아래 줄 버튼, 뒤 갱신은 다음 진입 때, 좋아요는 되돌림 + 토스트, 4xx는 바로 원인 안내로 끝낸다.
프롬프트
피드 요청의 재시도 표를 만들어줘: 첫 로드(목록이 비어 있을 때)만 retry 3, 대기 1 · 2 · 4초에 ±20 % 무작위를 곱하고 대기 중에는 "N초 뒤 자동 재시도 (2/4)"를 보여 준 뒤, 4번째 실패면 "계속 실패했어요 · 다시 시도" 버튼으로 바꿔줘. 다음 쪽 · 뒤 갱신 · 좋아요 · 4xx 응답은 retry 0으로 두고 각각 맨 아래 줄 버튼 · 다음 진입 때 다시 · 250 ms 되돌림 + 토스트 · 원인 문구로 처리해줘.
라이브 데모 열기 — 자동 재시도는 첫 로드만 (1 → 2 → 4초 ±20 % · 3번 뒤 버튼 · 다음 쪽 · 뒤 갱신 · 좋아요 · 4xx는 자동 재시도 없음)
같은 키 요청은 하나 (목록 · 탭 배지 · 홈 위젯이 동시에 feed:latest → 요청 1회 · 구독 3 · 5분 안 재마운트는 캐시)
Request de-duplication by key: three components mounting together share one in-flight promise for feed:latest, the response fills all three, and a remount within the 5-minute fresh window reads the cache instead of fetching
목록 화면 · 하단 탭 배지 · 홈 위젯이 각자 fetch를 부르면 같은 첫 쪽을 동시에 세 번 받고, 뒤로 와서 다시 마운트될 때 또 받는다. 요청을 키(feed:latest)로 묶어 진행 중인 Promise가 있으면 새로 보내지 않고 그 Promise를 구독하게 하고, 응답이 오면 진행 중 표에서 지우고 캐시에 넣는다. 5분 안에 다시 마운트되면 캐시로 그리므로 요청은 처음 1번뿐이다.
프롬프트
피드 데이터를 쓰는 세 화면(목록, 탭 배지 "새 글 3", 홈 위젯)이 같은 키 feed:latest를 쓰도록 공용 훅을 만들어줘: inflight Map에 키별 Promise가 있으면 그걸 기다리고 없을 때만 요청을 보내며, 응답이 오면 inflight에서 지우고 cache[키]에 받은 시각과 함께 넣어줘. 받은 지 5분 안의 재마운트는 요청 없이 캐시로 그리고, 화면마다 직접 fetch를 부르는 코드는 없애줘.
라이브 데모 열기 — 같은 키 요청은 하나 (목록 · 탭 배지 · 홈 위젯이 동시에 feed:latest → 요청 1회 · 구독 3 · 5분 안 재마운트는 캐시)
안 보는 캐시는 5분 뒤 정리 (보는 화면 0이 된 때부터 gcTime 5분 · 그 안에 다시 보면 즉시 · 지나면 삭제 → 다시 오면 첫 로드)
Garbage-collecting unobserved list caches: a key with zero observers starts a 5-minute timer, coming back inside it renders instantly and cancels the timer, after it the entry is dropped and the next visit is a first load
탭 · 검색 · 글 상세를 오갈 때마다 생기는 목록 키를 전부 영원히 두면 오래 쓴 앱의 메모리가 계속 는다. 키를 보는 화면 수가 0이 된 때부터 5분을 세어 그 안에 다시 보면 캐시로 바로 그리고 타이머를 취소하며, 5분이 지나면 지워 다음 방문은 첫 로드가 된다. 화면이 보고 있는 키는 몇 분이 지나도 지우지 않는다.
프롬프트
피드 캐시에 키별 observer 수와 gc 타이머를 넣어줘: 화면이 마운트되면 observer +1, 언마운트되면 −1 하고 0이 되는 순간 5분 타이머를 시작해, 그 안에 다시 구독되면 타이머를 취소하고 캐시로 즉시 그려줘. 타이머가 끝나면 그 키의 pages · cursor · 스크롤 앵커를 함께 지우고, 다음 방문은 300 ms 뒤 스켈레톤이 나오는 첫 로드로 처리해줘.
라이브 데모 열기 — 안 보는 캐시는 5분 뒤 정리 (보는 화면 0이 된 때부터 gcTime 5분 · 그 안에 다시 보면 즉시 · 지나면 삭제 → 다시 오면 첫 로드)
피드 영상 자동 재생은 하나만 (50 % 넘게 보이는 것 중 가장 많이 보이는 1개 · 스크롤 멈춘 뒤 200 ms · 소리 끔 · 50 % 밑이면 멈춤 · 위치 기억)
Autoplaying feed videos one at a time: after scrolling settles for 200 ms, play the single most visible video above 50 % muted, pause it the moment it drops under 50 %, remember each position, and skip autoplay under reduced motion or data saver
보이는 영상을 다 재생하면 소리와 데이터가 겹치고, 스크롤 중에 재생 대상이 계속 바뀌며 끊긴다. 스크롤이 멈추고 200 ms 뒤에 50 % 넘게 보이는 영상 중 가장 많이 보이는 한 개만 소리를 끈 채 재생하고, 재생 중인 영상이 50 % 밑으로 내려가면 바로 멈추며 위치를 기억한다. 움직임 줄이기나 데이터 절약이 켜져 있으면 자동 재생 없이 재생 버튼만 둔다.
프롬프트
피드 영상 카드의 자동 재생을 구현해줘: IntersectionObserver(threshold 0 · 0.5 · 1)로 영상마다 보이는 비율을 저장하고, 스크롤이 멈춘 뒤 200 ms가 지나면 비율 ≥ 0.5 중 가장 큰 하나만 muted로 재생하고 나머지는 멈춰줘. 재생 중인 영상이 0.5 밑으로 내려가면 즉시 멈추고 currentTime을 글 id별로 저장해 다시 재생할 때 이어 보게 하고, prefers-reduced-motion이나 데이터 절약 모드면 자동 재생을 끄고 ▶ 버튼만 보여줘. 영상 카드 높이는 고정해 목록이 밀리지 않게 해줘.
라이브 데모 열기 — 피드 영상 자동 재생은 하나만 (50 % 넘게 보이는 것 중 가장 많이 보이는 1개 · 스크롤 멈춘 뒤 200 ms · 소리 끔 · 50 % 밑이면 멈춤 · 위치 기억)