[feat/MAT-591] study handwriting snapshot API hook 추가

[b0nsu]

Summary

MAT-591 신규 spec 인 study handwriting snapshot endpoint 의 hook 두 개 추가. publishId/problemId/type 조합으로 시점별 (AFTER_FIRST_SUBMIT / AFTER_RETRY_SUBMIT / AFTER_POINTING) 필기 데이터 upsert + 단건 조회. 후속 MAT-591 통합 PR (매니저 generic 화 + ProblemScreen / PointingScreen 통합) 의 base.

Linear

• MAT-591 — 문제풀이 영역 필기 저장 기능 추가

Changes

• apps/native/src/apis/controller/student/study/handwriting/useGetStudyHandwritingSnapshot.ts 신규 — GET /api/student/study/problem/{publishId}/{problemId}/handwriting/snapshot/{type}. StudyHandwritingSnapshotType 도 함께 export. staleTime: Infinity, enabled 패턴.
• apps/native/src/apis/controller/student/study/handwriting/usePostStudyHandwritingSnapshot.ts 신규 — POST /api/student/study/problem/{publishId}/{problemId}/handwriting/snapshot, body { type, dataJson }. onSuccess setQueryData 미장착 — 캐시는 MAT-591 통합 PR 의 wiring 단일 경로에서 처리.
• apps/native/src/apis/controller/student/study/index.ts — 옛 useGetStudyHandwriting / useUpdateStudyHandwriting export 제거 (consumer 0). snapshot hook + StudyHandwritingSnapshotType re-export.
• apps/native/src/types/api/schema.d.ts — pnpm openapi regen. snapshot endpoint 2 개 + StudyHandwritingSnapshotSaveRequest / StudyHandwritingSnapshotResp 추가. 누적된 다른 도메인 schema 변경도 함께 동기화.

Testing

• pnpm --filter native exec tsc --noEmit — exit 0
• pnpm --filter native exec eslint <변경 파일> — 0 error (@/apis/client import warning 은 주변 hook 과 동일한 사전 존재 패턴)
• hook 단독 추가이므로 기존 화면 영향 없음 (consumer 0)

Risk / Impact

• 영향 범위: study API layer (snapshot endpoint 신규 추가)
• 호환성: 옛 study handwriting PUT hook 제거 — consumer 0 이라 영향 없음. 서버측 endpoint 는 살아있음 (다른 client 가 사용 가능)
• 머지 순서: 본 PR → MAT-591 통합 PR (별 branch, base develop). MAT-591 통합은 PR [fix/MAT-524+542] 필기 자동저장 race 봉쇄 + dataJson 전환 + save queue #313 머지 후 진행

Follow-up

• MAT-591 통합 PR
  • useHandwritingManager generic 화 — { scope: 'scrap' | 'study', ... }
  • save queue entry key 일반화 (scrapId 단일 → composite key)
  • poster scope 분기 (scrap PUT vs study POST)
  • ProblemScreen / PointingScreen 통합 (3 시점 매트릭스: phase 별 write/read type)

[linear]

MAT-350 study handwriting API 추가

MAT-591

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
pointer-admin	Ready	Preview, Comment	May 13, 2026 2:55pm

[Copilot]

Pull request overview

Adds a new student study handwriting API layer to the native app so problem-solving/pointing screens can fetch and persist handwriting tied to (publishId, problemId) using the existing OpenAPI + TanStack Query client setup.

Changes:

• Added useGetStudyHandwriting query hook for fetching handwriting with staleTime: Infinity and enabled support.
• Added useUpdateStudyHandwriting mutation hook to save/update handwriting and immediately update the query cache.
• Regenerated OpenAPI types (schema.d.ts) and exported the new hooks from the study controller index.

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated 2 comments.

File	Description
apps/native/src/types/api/schema.d.ts	Adds Study handwriting endpoint types (and other regenerated schema changes).
apps/native/src/apis/controller/student/study/index.ts	Exposes new handwriting hooks from the study controller entrypoint.
apps/native/src/apis/controller/student/study/handwriting/useGetStudyHandwriting.ts	New query hook for (publishId, problemId) handwriting retrieval.
apps/native/src/apis/controller/student/study/handwriting/putUpdateStudyHandwriting.ts	New mutation hook for saving handwriting + updating cached query data.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.