WickedHost Design System / 시작하기

규칙·상태·변경 관리

문서 채택, 코드 존재, 운영 적용, 검증 완료를 별도 상태로 관리합니다.

WickedHost 공통 확정 기준: vPanel/Pterodactyl 디자인을 Blesta까지 동일 적용. 문서·예제 기준이며 운영 서비스 배포와는 별도입니다. 공통 동작 규칙을 재사용하며, 다른 체계의 사례는 비교 근거일 뿐 스타일 상속이 아닙니다.

규칙 강도

  • MUST: 안전·접근성·핵심 업무 계약. 신규·변경 범위에서 필수입니다.
  • SHOULD: 기본 권장. 다르게 구현하면 이유와 검증 방법을 기록합니다.
  • MAY: 선택 사항. 모든 제품에 기능을 추가할 의무는 없습니다.

규칙을 문서화한 것만으로 기존 제품을 합격 처리하지 않습니다. 이번 버전의 공통 규칙은 문서 기준이며, 세 서비스 전체의 준수 평가는 미검증입니다.

증거의 우선순위

현재 동작 검증 → 현재 배포본 소스 → 로컬 소스 스냅샷 → 이전 검증 기록 → 제안 순으로 구분합니다. 상위 근거가 없으면 낮은 단계임을 명시합니다. 서로 다른 시점의 기록을 합쳐 현재 운영 상태라고 주장하지 않습니다.

  • GOV-01 MUST: 변경 PR에는 관련 문서·규칙 ID·영향 제품·검증 결과를 함께 기록합니다.
  • GOV-02 MUST: 기존 컴포넌트를 수정하면 해당 상태·예제·사용처 문서도 갱신합니다.
  • GOV-03 MUST: 기존 업무 API, 권한, CSRF, 폼 필드와 트랜잭션은 디자인 변경의 부수 작업으로 바꾸지 않습니다.
  • GOV-04 SHOULD: 제품 담당자와 디자인/접근성 검토 역할을 지정합니다. 현재 개인 담당자는 미지정입니다.
  • GOV-05 MUST: 승인 없는 운영 배포·전체 테마 교체·데이터 생성 테스트를 하지 않습니다.

예외 기록

예외에는 규칙 ID, 제품·화면, 제약, 사용자 영향, 대안, 확인한 근거, 승인자, 재검토 조건을 남깁니다. 단순히 “레거시”라고만 쓰지 않습니다. 현행 Blesta의 별도 토큰·모서리는 허용된 제품 차이이지 접근성 면제 사유가 아닙니다.

변경 등급

문구·예제 보완은 patch, 새 규칙·컴포넌트는 minor, 기존 계약 폐기·토큰 의미 변경은 major 검토 대상입니다. v0.1은 최초 기준선입니다. 폐기할 때 대체 항목, 영향 화면, 이행 절차를 먼저 문서화합니다.

완료 조건

문서 원본, 출처, 구현 근거, 남은 미검증, 재현 가능한 테스트가 함께 있어야 합니다. 브라우저가 없으면 화면 검증을 미검증으로 남깁니다. 이 규칙은 검증 체크리스트에 연결됩니다.

출처와 적용 범위

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

Markdown 원본 다운로드