🎨 Palette: 대시보드 파일 업로드 프록시 버튼 도입 및 접근성 개선

.jules/palette.md

@@ -81,3 +81,7 @@
 ## 2026-08-12 - Skip to Content Accessibility
 **Learning:** Screen reader and keyboard-only users experience significant friction when forced to navigate through repetitive header controls on every page load.
 **Action:** Keep a visible-on-focus skip link as the first interactive element, target a programmatically focusable main container, and give the focused link a high-contrast outline.
+
+## 2023-10-27 - 파일 업로드 버튼 접근성 개선
+**Learning:** `aria-hidden="true"`는 파일 입력 요소를 접근성 트리에서 제거하여 스크린 리더에서 읽히지 않도록 합니다. 네이티브 input[type="file"]을 커스텀 버튼으로 교체할 때, 네이티브 요소를 완전히 숨기고 커스텀 버튼이 포커스를 받도록 보장해야 합니다.
+**Action:** 접근성 개선을 위해 네이티브 요소에 `aria-hidden="true"`, `tabindex="-1"`, `class="sr-only"`를 적용하고 이를 트리거하는 프록시 버튼을 사용합니다.

scanner/dashboard/index.html

@@ -93,7 +93,8 @@
   <span class="logo"></span><span class="brand">AppGuardrail</span>
   <span class="spacer"></span>
   <span class="meta" id="src">no findings loaded</span>
-  <input type="file" id="file" accept="application/json,.json" aria-label="Upload findings file" style="margin-left:12px">
+  <input type="file" id="file" accept="application/json,.json" aria-hidden="true" tabindex="-1" class="sr-only">
+  <button type="button" id="file-proxy" class="primary-action" aria-label="Upload findings file" style="margin-left:12px">Upload findings</button>
 </header>
 <p id="findings-summary" class="sr-only" role="status" aria-live="polite" aria-atomic="true"></p>
 <main id="app" tabindex="-1"></main>
@@ -325,6 +326,9 @@ <h1>Dashboard</h1>
 }
 
 const fileInput = document.getElementById('file');
+const fileProxy = document.getElementById('file-proxy');
+fileProxy.addEventListener('click', () => fileInput.click());
+
 fileInput.addEventListener('change', () => {
   const selectedFile = fileInput.files?.[0];
   fileInput.value = '';

tests/test_dashboard_core.py

@@ -302,3 +302,20 @@ def test_dashboard_search_escape_clears_input():
     assert "e.key === 'Escape'" in html
     assert "query = '';" in html
     assert "render();" in html
+
+
+def test_file_upload_proxy_accessibility_contract():
+    """File upload must use an accessible proxy button instead of native file input."""
+    html = dashboard_index_path().read_text(encoding="utf-8")
+    assert 'class="sr-only"' in html and 'tabindex="-1"' in html and 'aria-hidden="true"' in html and '<input type="file" id="file"' in html
+    assert '<button type="button" id="file-proxy"' in html and 'class="primary-action"' in html
+    assert "fileProxy.addEventListener('click', () => fileInput.click())" in html
+
+
+def test_file_upload_proxy_accessibility_contract_is_documented_accurately():
+    """UX accessibility learnings must be properly documented in the journal."""
+    import pathlib
+    journal_path = pathlib.Path(__file__).parent.parent / ".jules" / "palette.md"
+    if journal_path.exists():
+        journal_text = journal_path.read_text(encoding="utf-8")
+        assert '`aria-hidden="true"`는 파일 입력 요소를 접근성 트리에서 제거' in journal_text