WickedHost Design System / 업무 패턴

폼 검증·저장·복구

오류 위치, 지속 안내, 재제출과 실제 저장 결과를 하나의 계약으로 묶습니다.

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

작업 흐름

입력 → 클라이언트 보조 검증 → 서버 검증 → 실제 저장 → 결과 안내. 저장 성공 메시지는 서버의 업무 성공을 확인한 뒤 표시합니다.

  • VAL-01 MUST: 필요한 데이터만 요청하고 관련 필드는 제목과 설명으로 묶습니다.
  • VAL-02 MUST: 필드 오류와 전체 요청 실패를 구분하고 오류가 수정될 때까지 찾을 수 있게 합니다.
  • VAL-03 MUST: 네트워크 오류 후 유효한 입력을 유지하고 제출 잠금을 해제할 수 있게 합니다.
  • VAL-04 MUST: 서버가 거절한 값의 이유와 복구 행동을 안전한 문구로 제공합니다.
  • VAL-05 SHOULD: 제출 전에는 조합 중·입력 중인 값에 성급한 오류를 남발하지 않습니다.
  • VAL-06 MUST: 비밀번호·토큰을 복구 편의 목적으로 브라우저 저장소에 쓰지 않습니다.

VPS 기존 계약

실제 vps-forms 문서는 aria-invalid, 필드 그룹 직후 WickedFormNotice error, 필요한 경우 빨간 toast, 지속 오류를 요구합니다. toast는 지속 안내의 대체물이 아닙니다. WickedFormNotice 자체는 오류 필드의 id 연결을 자동으로 만들지 않으므로 각 폼에서 연결 여부를 검증해야 합니다.

Blesta 기존 계약

PDT의 Form helper·action·method·CSRF·필드 이름·multipart를 유지합니다. 프런트의 제출 차단과 기존 중복 제출 방지기의 실행 순서가 충돌하지 않는지 확인합니다.

예시와 검증

공개 키 형식 오류를 입력 아래에 남기고 필드로 이동할 수 있게 합니다. 전체 요청 실패는 별도 요약으로 설명합니다. 단일 필드·여러 필드·서버 422·5xx·세션 만료·수정 후 재제출을 테스트합니다. 실제 고객 데이터 생성은 승인된 격리 환경에서만 수행합니다.

출처와 적용 범위

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

Markdown 원본 다운로드