데이터 7상태

일곱 상태

데이터를 보여주는 모든 컴포넌트는 일곱 상태를 서로 다른 모양으로 그린다. 철학 5 “수집한 범위만 설명한다”를 화면에서 지키는 장치다.

데이터 7상태
상태	뜻	모양	CTA	알림
`not-collected`	이 범위는 아직 수집하지 않았다	연결 아이콘 + 출처를 연결하면 여기에 보여요	출처 연결 1개	없음
`loading`	처음 불러오는 중	Skeleton(최종 모양과 같은 구조, 정지). 빈 상태와 다른 모양	없음	aria-busy. 1초 넘으면 status 한 번
`empty`	수집했지만 해당 항목이 없다	컴포넌트별 문장	0–1	없음
`no-results`	검색·필터 결과가 없다	검색어를 되풀이하는 문장 + 필터 해제	필터 지우기	status “결과 없음”
`partial`	일부 범위를 읽지 못했다	받은 데이터 + 고정 행(PartialFailureRow, failedRange)	다시 시도	status 한 번
`error`	지금 불러오지 못했다	오류 아이콘 + 지금 불러오지 못했어요	다시 시도	status (사용자 행동의 결과일 때만 alert)
`stale`	데이터는 있지만 마지막 읽음이 오래됐다	데이터 그대로 + 마지막 읽음 · 3시간 전	없음(자동 재시도)	없음

이렇게 하지 않기“0”을 큰 숫자로 그려 빈 상태를 대신하지 않는다. 미수집 구간을 0으로 그리지 않는다.
이렇게 하지 않기다시 불러올 때(이미 데이터가 있을 때) Skeleton으로 바꾸지 않는다. 데이터를 두고 aria-busy만 켠다.
이렇게세 가지 빈 상태는 다른 문장이다: 아직 읽지 않음(출처 연결) / 읽었지만 결과 없음(읽은 기간과 함께) / 일부 실패(받은 것은 유지).

상태 이름 (카탈로그 상태 토글)
	ko	en	zh-Hans	es
`ready`	정상	Ready	正常	Listo
`not-collected`	아직 읽지 않음	Not scanned yet	尚未读取	Aún sin leer
`loading`	불러오는 중	Loading	正在加载	Cargando
`empty`	비어 있음	Empty	为空	Vacío
`no-results`	결과 없음	No results	无结果	Sin resultados
`partial`	일부만 읽음	Partly scanned	部分读取	Leído en parte
`error`	오류	Error	出错	Error
`stale`	오래됨	Stale	已过时	Desactualizado

공통 상태 문장 (catalog-copy §3)
키	ko	en	zh-Hans	es
`notCollected`	출처를 연결하면 여기에 보여요.	Connect a source to see this.	连接来源后显示在这里。	Conecta una fuente para verlo.
`notCollectedAction`	출처 연결	Connect a source	连接来源	Conectar fuente
`empty`	아직 여기에 보여줄 기록이 없어요.	Nothing to show here yet.	这里还没有可显示的内容。	Aún no hay nada que mostrar aquí.
`noResults`	읽은 기간에는 해당하는 기록이 없어요.	Nothing here in the scanned dates.	已读取的日期范围内没有相关记录。	No hay nada en las fechas leídas.
`partial`	일부 기간을 읽지 못했어요. 받은 기록은 그대로 있어요.	Some dates couldn’t be scanned. What we got is kept.	部分日期未能读取，已获取的记录仍保留。	No pudimos leer algunas fechas. Lo recibido se conserva.
`error`	지금 불러오지 못했어요.	Couldn’t load this right now.	暂时无法加载。	No se pudo cargar ahora.
`retry`	다시 시도	Try again	重试	Reintentar
`stale`	마지막 읽음 · {time}	Last scanned · {time}	上次读取 · {time}	Última lectura · {time}

여러 사실이 동시에 참이면 가장 높은 것 하나가 바탕 상태가 된다. partial과 stale은 바탕이 아니라 데이터 위에 얹는 표시다(ready · empty · no-results 위에서만).

실제 컴포넌트: 실제 StateView (목록 표면)

상태

주의일부만 읽음

일부 기간을 읽지 못했어요. 받은 기록은 그대로 있어요.

partial·stale은 데이터와 함께 그린다. 나머지는 서로 배타적이다. 상태마다 아이콘·문장·CTA가 다르다 — 색만으로 구분하지 않는다.

실제 컴포넌트: deriveDataState() 계산기

src/design/logic/data-state.ts를 그대로 부른다. 데이터가 화면에 있을 때 다시 불러오기가 실패하면 오류가 아니라 “오래됨(refresh-failed)”이다.