diff --git a/AGENTS.md b/AGENTS.md index 80caffa..8de2bb0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -73,6 +73,7 @@ prisma/ - 모든 수학 수식은 KaTeX로 렌더링한다. 일반 텍스트나 Unicode 수식 문자를 직접 사용하지 않는다. - KaTeX 컴포넌트는 `components/math/` 하위에 위치한다. +- 현재 수식 컴포넌트는 `katex.renderToString()`을 직접 사용한다. 별도 래퍼 라이브러리를 추가하기 전에 Next.js App Router 클라이언트 번들에서 런타임 문제가 없는지 확인한다. ### 상태 관리 @@ -83,10 +84,20 @@ prisma/ ### 컴포넌트 배치 -- 게임 화면에서 재사용되는 입력, 피드백, 점수 요약 UI는 `components/game/` 하위에 둔다. +- 게임 화면에서 재사용되는 입력, 피드백, 점수 요약, 진행 단계 UI는 `components/game/` 하위에 둔다. - 수식 렌더링 전용 컴포넌트는 `components/math/` 하위에 둔다. - 라우트별 조립 컴포넌트(`PlayClient` 등)는 해당 `app/` 라우트 폴더에 둘 수 있다. +### 접근성 / 키보드 조작 + +- 문제 풀이 화면은 키보드만으로 진행할 수 있어야 한다. +- 새 문제가 표시되면 첫째 항 입력 칸에 focus를 둔다. +- 첫째 항에서 Enter를 누르면 둘째 항 입력 칸으로 focus를 이동한다. +- 둘째 항에서 Enter를 누르면 제출 동작을 실행한다. +- 정답·오답 피드백이 표시되면 다음 진행 버튼에 focus를 둔다. +- 최종 결과 화면이 표시되면 다시 시작 버튼에 focus를 둔다. +- 아이콘이나 기호만으로 상태를 표시할 때는 `aria-label`, `sr-only` 텍스트 등으로 의미를 함께 제공한다. + ### API / 백엔드 - API는 `app/api/` 하위의 Route Handlers로만 구현한다. 별도의 백엔드 서버를 추가하지 않는다. diff --git a/README.md b/README.md index 3d82595..8659f87 100644 --- a/README.md +++ b/README.md @@ -46,6 +46,21 @@ --- +## 현재 구현 상태 + +- 시작 화면에서 `/play` 풀이 화면으로 이동할 수 있습니다. +- `/play`에서 괄호 앞 음수 분배 문제 10개를 풉니다. +- 문제와 정답 수식은 KaTeX로 렌더링합니다. +- 진행 단계는 현재 문제, 완료된 정답, 완료된 오답, 남은 문제를 구분해서 표시합니다. +- 키보드 흐름을 지원합니다. + - 새 문제 시작 시 첫째 항 입력 칸에 focus + - 첫째 항 Enter → 둘째 항 입력 칸으로 이동 + - 둘째 항 Enter → 제출 + - 피드백 화면 → 다음 문제/결과 보기 버튼에 focus + - 결과 화면 → 다시 시작 버튼에 focus + +--- + ## 시작하기 ### 사전 요구사항 diff --git a/components/game/StageIndicator.tsx b/components/game/StageIndicator.tsx index b5b569d..76a3f0f 100644 --- a/components/game/StageIndicator.tsx +++ b/components/game/StageIndicator.tsx @@ -11,46 +11,60 @@ export default function StageIndicator({ currentIndex, results, }: StageIndicatorProps) { + const completedCount = results.filter((result) => result !== null).length; + const correctCount = results.filter((result) => result?.correct).length; + const incorrectCount = results.filter((result) => result?.correct === false) + .length; + return ( -
+ 총 {results.length}문제 중 {completedCount}문제 완료, 정답{" "} + {correctCount}개, 오답 {incorrectCount}개, 현재 {currentIndex + 1}번 + 문제 +
+