TeamWicked Design System / 업무 패턴

대기·빈 상태·실패

데이터가 없는 이유를 구분하고 안전한 다음 행동을 제공합니다.

적용 범위: TeamWicked 자체 브랜드·웹사이트. 호스팅 제품의 외형은 포함하지 않습니다. 공통 동작 규칙을 재사용하며, 다른 체계의 사례는 비교 근거일 뿐 스타일 상속이 아닙니다.

상태 모델

상황 표현 다음 행동
첫 로드 범위에 맞는 skeleton/대기 요청 진행 안내
데이터 0건 처음 사용·모두 삭제 등 이유 허용된 생성/다른 범위
필터 결과 0건 적용된 검색·필터 설명 필터 해제
요청 실패 실패 범위와 복구 안내 안전한 조회 재시도
접근 불가 권한/서비스 상태에 맞는 안내 허용된 이동·문의
오래된 값 마지막 수집 시각·지연 표시 갱신·복구
성공 실제 완료된 작업 이름 결과 보기
  • STATE-01 MUST: API 오류를 “서버가 없습니다”로 표시하지 않습니다.
  • STATE-02 MUST: 0과 알 수 없음, 정지와 연결 실패를 구분합니다.
  • STATE-03 SHOULD: 이미 정상적으로 받은 내용은 재조회 시 유지하되 오래된 값임을 설명합니다.
  • STATE-04 MUST: 재시도가 중복 결제·중복 생성으로 이어지지 않도록 조회와 변경을 구분합니다.
  • STATE-05 MUST: skeleton/장식 예제값을 실제 사용량처럼 표시하지 않습니다.

우리 제품의 연결

Panel ServerRow는 429에서 마지막 정상값을 유지합니다. 따라서 문서의 권장 ‘마지막 갱신 표시’가 실제 구현됐는지는 별도 확인해야 합니다. Blesta 티켓·결제는 HTML 성공 응답만으로 저장 완료라고 판단하지 않습니다.

예시·확인

좋음: “검색 결과가 없습니다. 적용된 필터를 해제해 보세요.” 피함: 요청 실패를 빈 목록으로 처리하고 생성 버튼만 보임.

지연·일부 데이터 실패·새로고침·백그라운드 탭·권한 변경·재시도 후 복구를 확인합니다.

출처와 적용 범위

원본 확인 범위와 운영 적용 여부를 구분합니다. 실행형 예제의 동작 확인은 모든 운영 화면의 접근성 검증을 의미하지 않습니다.

Markdown 원본 다운로드