도구 알고리즘과 콘텐츠를 검수하고 공개하는 기준

1. 여섯 가지 판정 상태 체계 (Evaluation Status Taxonomy)

웹접근성 체크랩은 사용자의 입력과 검사 규칙을 단순히 이분법적인 합격/불합격으로만 분류하지 않습니다. 웹 접근성 기준의 성격에 따라 자동 계산이 가능한 영역과 사람의 맥락 판단이 필요한 영역을 정확히 분리하기 위해 6가지 상태 코드를 정의합니다.

pass (적합)

사용자가 명시한 입력값과 정적 검사 규칙의 범위 내에서 공식 성공 기준의 경계값을 수학적·구조적으로 충족함을 의미합니다.

fail (부적합)

자동화된 계산이나 정적 파싱 결과, 공식 기준이 규정하는 최소 수치나 구조적 필수 요건을 명백히 미달함을 의미합니다.

potential_issue (잠재적 문제)

알고리즘상 기술적 결함이나 접근성 저하 가능성이 감지되었으나, 시각적 디자인 맥락이나 주변 콘텐츠와의 관계에 따라 최종 판단이 달라질 수 있는 주의 상태입니다.

manual_review (수동 확인 필요)

텍스트의 실제 의미, 버튼의 실제 시각적 목적, 스크린리더 가상 커서 탐색 경험 등 자동화 코드가 확정할 수 없는 항목으로 사람의 수동 검토 질문을 제시합니다.

not_applicable (해당 없음)

입력된 컴포넌트 유형이나 조건이 특정 성공 기준의 적용 대상(예: 비활성 컴포넌트의 명도 대비 예외, 텍스트 줄바꿈 인라인 링크)에 해당하지 않는 경우입니다.

invalid_input (입력값 오류)

HEX 색상 코드 형식 불일치, 음수 크기 좌표, 닫히지 않은 깨진 HTML 마크업 등 계산을 수행하기 전에 입력 형식의 수정이 필요한 상태입니다.

2. 아티클 검증 상태 4단계 체계 (Article Verification Taxonomy)

공개된 기술 아티클과 가이드의 신뢰성을 담보하기 위해 다음 4가지 검증 상태를 엄격히 적용합니다.

verified (계산 및 fixture 확인)

공개 fixture와 자동 테스트 범위가 확인된 항목으로, 공식 계산 공식 및 결정적 알고리즘의 동작 범위를 투명하게 명시합니다.

reproduced (재현 조건 공개)

사용자가 직접 재현할 수 있는 마크업과 표준 대조 절차는 공개되었으나, 자동 로그가 아닌 맥락적 수동 판단을 요하는 항목입니다.

review_pending (검증 예정)

향후 신규 규격 개정이나 추가 브라우저 엔진 환경에서의 검증이 예정된 항목입니다.

not_applicable (해당 없음)

해당 기술 글의 범위에 직접적인 자동 테스트나 검사가 해당되지 않는 경우입니다.

3. 근거 문서의 우선순위 (Evidentiary Hierarchy)

도구의 판정 알고리즘과 설명 문서는 신뢰할 수 있는 공식 표준 명세만을 최우선 근거로 채택합니다.

1. 1순위 - W3C 공식 표준 및 가이드라인: W3C WCAG(Web Content Accessibility Guidelines) 2.2 표준 본문과 해당 성공 기준의 공식 Understanding 문서, WAI-ARIA 1.2 명세, HTML-AAM(HTML Accessibility API Mappings) 1.0 규격을 최상위 근거로 삼습니다.
2. 2순위 - 국내 국가 표준 및 지침: 국립전파연구원(RRA) 고시 한국형 웹 콘텐츠 접근성 지침 2.2(국가표준 KS X OT0003, 제·개정일: 2022-12-28) 및 한국지능정보사회진흥원(NIA)의 상세 제작 기법을 국내 환경의 근거로 병행합니다.
3. 3순위 - 브라우저 엔진 및 플랫폼 표준: 브라우저 렌더링 엔진(Blink, WebKit, Gecko)의 접근성 트리 구현 명세 및 MDN Web Docs의 공식 기술 문서를 참조합니다.
4. 4순위 - 프로젝트 휴리스틱:표준에 명시되지 않은 실무 경험적 조언은 ‘프로젝트 휴리스틱(Project Heuristic)’으로 명확히 표기하여 공식 표준과 엄격히 구분합니다.

기관의 단순 홍보용 웹페이지 첫 화면이나 검색 엔진 요약 스니펫은 판정 기준의 근거로 사용하지 않습니다.

4. HTML 입력 데이터의 안전한 처리 (Safe Inert Parsing)

웹접근성 체크랩은 사용자가 입력한 HTML 코드 조각을 서버로 전송하지 않고 브라우저 내부에서만 안전하게 분석합니다.

• 브라우저 내장 DOMParser API를 사용하여 text/html 문서로 비활성 파싱(Inert Parsing)을 수행합니다.
• 파싱 과정에서 브라우저 비활성 DOMParser를 활용하여 스크립트 실행이나 외부 리소스 호출이 발생하지 않도록 설계했습니다.
• 분석 대상 HTML은 분석 메모리 내에서 구조적 순회만 거치며, 실제 사용자 화면의 라이브 DOM에 직접 삽입하지 않습니다.

5. 테스트 자동화와 품질 보증 (Testing & Quality Assurance)

도구의 신뢰성을 유지하기 위해 코드 배포 전 다층적인 자동화 품질 게이트를 실행합니다.

• 순수 TypeScript 단위 테스트: 현재 프로젝트의 자동 테스트와 공개 fixture를 기준으로 검증하며, 대표 fixture와 정적 규칙의 재현 절차를 공개합니다. 전체 접근성 준수를 단정하지 않으며, 실제 브라우저 환경의 수동 확인이 필요합니다.
• 정적 산출물 검증 (Static Output QA): 정적 빌드(SSG) 과정에서 생성된 모든 HTML 페이지가 고유한 H1, 유효한 메타데이터, 올바른 내부 링크 구조를 갖추고 있는지 자동으로 검사합니다.
• axe-core 자동 접근성 검사: 배포 전 자동 접근성 검사를 실행하도록 품질 게이트를 운영하며, 자동 검사가 포착하지 못하는 의미·맥락·스크린리더 동작은 별도로 수동 검토합니다.

6. 국제 표준 용어 표기 원칙 (International Terminology)

본 사이트는 한국어 설명과 함께 국제적으로 통용되는 영문 표준 용어를 병기하여, 검색 엔진 크롤러와 다국어 사용자가 용어의 의미를 명확히 이해할 수 있도록 지원합니다.

• 색상 대비: Color Contrast Ratio (WCAG 1.4.3 / 1.4.6 / 1.4.11)
• 상대 휘도: Relative Luminance (sRGB L1, L2 계산 공식)
• 대상 크기: Target Size Minimum (WCAG 2.5.8 Level AA, 2.5.5 Level AAA)
• 접근 가능한 이름: Accessible Name Computation (W3C AccName 1.2)
• 키보드 초점 표시: Focus Visible & Focus Not Obscured (WCAG 2.4.7 / 2.4.11)
• 제목 구조: Info and Relationships & Headings (WCAG 1.3.1 / 2.4.6)

7. AI 보조 활용 원칙과 인간 검수 책임 (AI Transparency)

콘텐츠 구조 설계, 설명문 초안, 정적 검사 스크립트 작성에 AI 도구를 보조적으로 참고했습니다.

다만 모든 판정 알고리즘 수식, fixture 재현 조건, 공식 인용은 운영자가 W3C 및 RRA 원문과 직접 대조하여 검증했으며, 이는 실제 보조공학기기(스크린리더 등)를 이용한 수동 검증을 대체하는 것이 아닙니다. 모든 공개 콘텐츠의 최종 검토 및 기술적 책임은 운영자 서호영에게 있습니다.

8. 게시 전 확인 절차와 저품질 복제 차단

웹접근성 체크랩은 페이지 수를 인위적으로 늘리기 위한 대량 자동 생성 콘텐츠를 철저히 차단합니다.

• 모든 신규 콘텐츠는 초안 상태로 관리되며, 검수 책임자의 확인, 실제 검수일, 주장별 공식 URL 근거, 테스트 증거, 고유 질문이 모두 완비된 경우에만 게시 전 확인 절차를 거쳐 공개됩니다.
• 단순히 변수명이나 번호만 바꾼 템플릿 파생 페이지는 색인 대상에서 원천 배제됩니다.

9. 오류 정정 및 변경 이력 관리 (Errata & Corrections)

도구의 판정 알고리즘이나 가이드 설명에서 기술적 오류가 발견될 경우, 즉시 재현 입력과 공식 기준을 대조하여 코드를 수정하고 단위 테스트를 추가합니다.

오류 제보가 접수되면 공식 근거와 재현 조건을 확인한 뒤 확인 결과와 수정일을 공개합니다. 처리 시점은 제보 내용과 검증 범위에 따라 달라질 수 있으며, 수정된 내역은 변경 기록에 투명하게 공개됩니다.