NextPDF Connect에서 구조적 접근성 검사 (Pro)

한눈에 보기

NextPDF Connect에서 구조적 접근성 분석을 실행합니다. 이 도구는 check_accessibility이며, Pro 도구 공급자를 기준으로 다시 검증됩니다. 이 공급자는 프로토콜 이름 check_accessibility 아래에 new CheckAccessibilityTool()을 등록합니다. 이 도구 자체의 설명은 범위를 명확히 한정합니다. 즉, PDF의 구조적 접근성 — 제목, 표, 이미지, 읽기 순서 지표 —을 분석합니다. 이 도구는 지표와 개선 힌트를 제시합니다. 이 도구는 PDF/UA 또는 WCAG 적합성을 인증하지 않습니다. 그러한 판정은 이 도구가 아니라 적합성 검사기 — 예를 들어 veraPDF 또는 PDF/UA 테스트 도구 — 가 내립니다. check_accessibility는 Pro 티어 도구입니다. NextPDF는 부팅 시 class_exists()로 이를 탐지하고, Pro 패키지가 설치된 경우에만 등록합니다.

설치

composer require nextpdf/server
composer require nextpdf/pro

전송 채널을 바인딩합니다. diagnostic.capabilities로 도구를 확인합니다.

개념 개요

접근 가능한 구조는 두 가지 요소에 의존합니다. 구조 요소로 이루어진 논리적 구조 트리(ISO 32000-2 §14.7)와, 카탈로그 Lang 항목으로 설정되는 선언된 문서 언어(ISO 32000-2 §14.9; PDF/UA-2 §8.4.4)입니다. check_accessibility는 이러한 구조적 지표를 검사하고, 각 발견 사항에 심각도와 개선 안내가 포함된 보고서를 반환합니다. 보고서의 모든 수치 점수나 pass/fail은 지표 요약이며, 인증이 아닙니다 — 분류 신호로 읽으십시오.

API 표면

도구	티어	역할	위험 티어
`create_pdf`, `add_text`	Core	검사할 콘텐츠 생성	Safe / Caution
`check_accessibility`	Pro	구조적 접근성 분석	Safe
`output_pdf`	Core	PDF 렌더링 및 반환	Approval Required / Review (base64)

도구 이름은 레지스트리의 프로토콜 이름입니다. 도구 카탈로그가 기준 카탈로그입니다. 사용할 수 있는 도구는 설치된 티어에 따라 달라집니다.

코드 예제 — 빠른 시작

create_pdf → add_text로 콘텐츠를 추가합니다.
document_id로 check_accessibility를 실행합니다.
발견 사항을 확인합니다. 심각도, 지표, 영향받는 페이지, 개선 힌트를 살펴봅니다.
필요하면 수동 검토를 위해 보고서와 함께 output_pdf(base64)를 실행합니다.

코드 예제 — 프로덕션

보고서를 판정이 아니라 분류 입력으로 취급하십시오. 각 발견 사항을 구체적인 수정 작업에 연결하십시오. 태그가 지정된 출력을 활성화하고, 문서 언어를 설정하고, 제목 구조를 추가합니다. 적합성 게이트를 위해서는 외부 검사기를 실행하고, 이 도구의 점수가 아니라 그 검사기의 판정을 권위 있는 결과로 취급하십시오. destroy: true를 사용하는 output_pdf 전에 검사를 실행하십시오. 그렇지 않으면 문서를 볼 수 없습니다.

경계 사례 및 주의점

콘텐츠 없음. 빈 문서는 인증이 아니라 콘텐츠 없음이라는 발견 사항을 산출합니다.
대용량 문서. 분석은 타임아웃으로 제한됩니다. 대용량 입력은 분할하거나 범위를 지정하십시오.
파기된 세션. 출력으로 세션이 파기되기 전에 검사를 실행하십시오.
암호화된 원본. 비밀번호를 제공하십시오.
Pro 없음. Core만 설치된 경우 check_accessibility는 등록되지 않습니다.

성능

예산에 설정된 타임아웃이 분석을 제한합니다. 프로파일은 semantic입니다. 보고서는 구조 분석 출력이므로, 정확한 비교는 바이트 출력이 아니라 발견 사항을 기준으로 합니다.

보안 참고 사항

보고서는 콘텐츠의 비밀정보가 아니라 구조를 설명합니다. 분석 중인 문서는 여전히 민감할 수 있으므로, 신뢰 경계 안에 두십시오. 분석 경로는 파일 시스템에 아무것도 기록하지 않습니다.

적합성

진술	사양	조항
논리적 구조는 구조 요소들의 트리입니다.	ISO 32000-2	§14.7
문서 언어는 `Lang` 항목을 통해 선언됩니다.	ISO 32000-2	§14.9
접근 가능한 저작을 위해서는 자연어가 지정되어야 합니다.	PDF/UA-2	§8.4.4

check_accessibility는 접근 가능한 저작을 지원하는 구조적 지표를 보고합니다. 이 도구는 PDF/UA 또는 WCAG 적합성을 주장하지 않습니다 — 해당 판단은 독립적인 검사기가 합니다.

상용 맥락

check_accessibility는 Pro 티어 도구로, 서버 부팅 시 Pro 패키지가 확인될 때만 등록됩니다.

PDF/UA-2 매핑

이 도구가 검사하는 구조적 지표는 PDF/UA-2 저작 요구 사항과 일치합니다. 즉, 태그가 지정된 구조 트리(ISO 32000-2 §14.7)와 선언된 문서 언어(PDF/UA-2 §8.4.4)입니다. 이 도구는 이러한 지표의 존재 여부를 보고합니다. PDF/UA-2 적합성은 이 도구의 보고서가 아니라 PDF/UA 검사기가 판단합니다.

태그 → ISO 32000-2 §14 상호 참조

제목 및 표 관련 발견 사항은 ISO 32000-2 §14.7 구조 트리의 논리적 구조 요소에 해당합니다. 언어 관련 발견 사항은 §14.9 Lang 항목에 해당합니다. 이 도구는 이러한 구조적 앵커의 존재 여부를 보여 줍니다. 이 도구는 모든 §14 태그 규칙을 검증하지는 않습니다 — 이는 검사기의 역할입니다.

WCAG 2.2 매핑

명암비 및 읽기 순서 관련 발견 사항은 명암비 및 의미 있는 순서와 같은 WCAG 성공 기준과 관련됩니다. 이 도구는 측정된 명암비와 같은 지표 값을 보고합니다. WCAG 적합성 주장에는 전체 WCAG 평가가 필요하며, 이 도구는 이를 수행하지도 주장하지도 않습니다.

전송 채널 가용성

전송 채널	가용	참고
MCP (stdio)	예 (Pro)	보고서는 도구 결과입니다.
REST	예 (Pro)	보고서는 응답 본문입니다.
gRPC	예 (Pro)	단항; 보고서는 응답 메시지에 포함됩니다.

HITL 위험 티어

check_accessibility는 Safe(읽기 전용 분석)이며 절대 게이트하지 않습니다. 파일로 output_pdf를 실행하는 것은 Approval Required이며, base64 모드는 Review입니다(HITL 위험 티어).

확인 게이트 JSON 봉투

분석은 절대 게이트하지 않습니다:

{ "allowed": true }