Files
web-inspector/frontend/src/components/inspection/SiteCrawlForm.tsx
jungwoo choi bffce65aca feat: 접근성 검사 표준 선택 기능 — WCAG/KWCAG 버전별 선택 지원
3가지 검사 모드(한 페이지, 사이트 크롤링, 목록 업로드) 모두에서 접근성 표준을
선택할 수 있도록 추가. WCAG 2.0 A/AA, 2.1 AA, 2.2 AA와 KWCAG 2.1, 2.2를
지원하며, KWCAG 선택 시 axe-core 결과를 KWCAG 검사항목으로 자동 매핑.

- KWCAG 2.2 (33항목) / 2.1 (24항목) ↔ WCAG 매핑 테이블 (kwcag_mapping.py)
- AccessibilityChecker에 표준 파싱 및 KWCAG 변환 로직 추가
- 전체 API 파이프라인에 accessibility_standard 파라미터 전파
- 프론트엔드 3개 폼에 공용 표준 선택 드롭다운 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-14 08:36:14 +09:00

221 lines
7.0 KiB
TypeScript

"use client";
import { useState, type FormEvent } from "react";
import { useRouter } from "next/navigation";
import { Button } from "@/components/ui/button";
import { Input } from "@/components/ui/input";
import { Card, CardContent } from "@/components/ui/card";
import { Globe, Loader2 } from "lucide-react";
import { api, ApiError } from "@/lib/api";
import { isValidUrl } from "@/lib/constants";
import { useSiteInspectionStore } from "@/stores/useSiteInspectionStore";
import { cn } from "@/lib/utils";
import {
AccessibilityStandardSelect,
type AccessibilityStandard,
} from "./AccessibilityStandardSelect";
/** 최대 페이지 수 옵션 (0 = 무제한) */
const MAX_PAGES_OPTIONS = [10, 20, 50, 0] as const;
/** 크롤링 깊이 옵션 */
const MAX_DEPTH_OPTIONS = [1, 2, 3] as const;
/** 동시 검사 수 옵션 */
const CONCURRENCY_OPTIONS = [1, 2, 4, 8] as const;
/** 사이트 크롤링 폼 */
export function SiteCrawlForm() {
const [url, setUrl] = useState("");
const [error, setError] = useState<string | null>(null);
const [isLoading, setIsLoading] = useState(false);
const [maxPages, setMaxPages] = useState<number>(20);
const [maxDepth, setMaxDepth] = useState<number>(2);
const [concurrency, setConcurrency] = useState<number>(4);
const [accessibilityStandard, setAccessibilityStandard] =
useState<AccessibilityStandard>("wcag_2.1_aa");
const router = useRouter();
const { setSiteInspection } = useSiteInspectionStore();
const handleSubmit = async (e: FormEvent) => {
e.preventDefault();
setError(null);
const trimmedUrl = url.trim();
if (!trimmedUrl) {
setError("URL을 입력해주세요");
return;
}
if (!isValidUrl(trimmedUrl)) {
setError("유효한 URL을 입력해주세요 (http:// 또는 https://로 시작)");
return;
}
setIsLoading(true);
try {
const response = await api.startSiteInspection(
trimmedUrl,
maxPages,
maxDepth,
concurrency,
accessibilityStandard
);
setSiteInspection(response.site_inspection_id, trimmedUrl);
router.push(
`/site-inspections/${response.site_inspection_id}/progress`
);
} catch (err) {
if (err instanceof ApiError) {
setError(err.detail);
} else {
setError("사이트 크롤링 시작 중 오류가 발생했습니다. 다시 시도해주세요.");
}
} finally {
setIsLoading(false);
}
};
return (
<Card className="w-full max-w-2xl mx-auto">
<CardContent className="pt-6">
<form onSubmit={handleSubmit} className="flex flex-col gap-4">
{/* URL 입력 필드 */}
<div className="relative">
<Globe className="absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-muted-foreground" />
<Input
type="text"
value={url}
onChange={(e) => {
setUrl(e.target.value);
if (error) setError(null);
}}
placeholder="https://example.com"
className="pl-10 h-12 text-base"
disabled={isLoading}
aria-label="크롤링할 사이트 URL 입력"
aria-invalid={!!error}
aria-describedby={error ? "site-url-error" : undefined}
/>
</div>
{/* 옵션 영역 */}
<div className="grid grid-cols-1 sm:grid-cols-4 gap-4">
{/* 최대 페이지 수 */}
<div>
<label className="text-xs text-muted-foreground mb-1.5 block">
</label>
<div className="flex gap-1.5">
{MAX_PAGES_OPTIONS.map((option) => (
<Button
key={option}
type="button"
variant={maxPages === option ? "default" : "outline"}
size="sm"
className={cn(
"flex-1 text-xs",
maxPages === option && "pointer-events-none"
)}
onClick={() => setMaxPages(option)}
disabled={isLoading}
>
{option === 0 ? "무제한" : option}
</Button>
))}
</div>
</div>
{/* 크롤링 깊이 */}
<div>
<label className="text-xs text-muted-foreground mb-1.5 block">
</label>
<div className="flex gap-1.5">
{MAX_DEPTH_OPTIONS.map((option) => (
<Button
key={option}
type="button"
variant={maxDepth === option ? "default" : "outline"}
size="sm"
className={cn(
"flex-1 text-xs",
maxDepth === option && "pointer-events-none"
)}
onClick={() => setMaxDepth(option)}
disabled={isLoading}
>
{option}
</Button>
))}
</div>
</div>
{/* 동시 검사 수 */}
<div>
<label className="text-xs text-muted-foreground mb-1.5 block">
</label>
<div className="flex gap-1.5">
{CONCURRENCY_OPTIONS.map((option) => (
<Button
key={option}
type="button"
variant={concurrency === option ? "default" : "outline"}
size="sm"
className={cn(
"flex-1 text-xs",
concurrency === option && "pointer-events-none"
)}
onClick={() => setConcurrency(option)}
disabled={isLoading}
>
{option}
</Button>
))}
</div>
</div>
{/* 접근성 기준 */}
<AccessibilityStandardSelect
value={accessibilityStandard}
onChange={setAccessibilityStandard}
disabled={isLoading}
/>
</div>
{/* 사이트 크롤링 시작 버튼 */}
<Button
type="submit"
size="lg"
className="h-12 text-base w-full"
disabled={isLoading}
>
{isLoading ? (
<>
<Loader2 className="h-4 w-4 animate-spin" />
...
</>
) : (
<>
<Globe className="h-4 w-4" />
</>
)}
</Button>
</form>
{error && (
<p
id="site-url-error"
className="mt-2 text-sm text-destructive"
role="alert"
>
{error}
</p>
)}
</CardContent>
</Card>
);
}