diff --git a/frontend/public/docs/ticket-pool.html b/frontend/public/docs/ticket-pool.html
index f68e447..7636580 100644
--- a/frontend/public/docs/ticket-pool.html
+++ b/frontend/public/docs/ticket-pool.html
@@ -119,6 +119,9 @@
footer { margin-top: 46px; padding-top: 22px; border-top: 1px solid var(--line); color: var(--ink-faint); font-size: 13px; display: flex; justify-content: space-between; flex-wrap: wrap; gap: 8px; }
@media (max-width:560px){ .tk-body .row { grid-template-columns: 70px 1fr; gap: 8px; } }
@media print { body{background:#fff;} .card,header.mast,.ticket,.cat-badge{box-shadow:none;} .ticket{break-inside:avoid;} td .fill{border-color:#999;} }
+
+ .row.target { background: var(--primary-soft); border-radius: 10px; padding: 9px 11px; margin-top: 8px; }
+ .row.target .lab { color: var(--primary-deep); font-weight: 800; }
@@ -126,11 +129,11 @@
AWESOMEDEV · 수습 실전 티켓 풀
실전 티켓 풀 20
템플릿 & 아이디어 카탈로그
- 5~6주차에 수습생에게 줄 실전 티켓을 미리 준비하는 문서예요. 아래 20개는 어떤 프로젝트에나 있는 안전한 티켓 패턴이고, 각 패턴마다 "우리 프로젝트에서 찾는 법"이 붙어 있어요. 멘토가 실제 코드에서 해당 건을 찾아 뒤쪽 양식으로 구체화하면 티켓 풀이 완성됩니다.
+ 5~6주차에 수습생에게 줄 실전 티켓 20개예요. 각 패턴마다 🎯 우리 건 — 여러분이 매일 쓰는 이 학습 플랫폼(mirim-app)의 실제 코드에서 찾아 둔 구체적인 일감이 붙어 있어요. 여러분이 고치면 이 플랫폼이 정말로 좋아집니다. 파일 경로까지 적어 뒀으니, 배정받으면 바로 코드를 열어 보세요.
프론트 7 · 백엔드 6 · 품질 4 · 디자인 3
난이도 ★(반나절~1일) · ★★(2~3일)
- 멘토용 · D-7까지 구체화
+ 구체화 완료 · 배정 대기
@@ -164,6 +167,7 @@
찾는 법각 화면에서 데이터 0건으로 조회해 보기. .map() 돌리는 목록 중 length가 0일 때 분기가 없는 곳이 후보.
완료 조건0건일 때 지정된 문구·아이콘 노출, 1건 이상이면 기존과 동일, 스크린샷 첨부된 PR.
멘토 준비대상 화면 지정, 문구 확정(디자이너 수습생과 협업시키면 좋음).
+
🎯 우리 건코딩 문제 필터 결과 0건 빈 상태 — FE-04(필터)와 짝 티켓. 코딩 문제 목록 frontend/src/pages/CodingPage.jsx에 FE-04로 언어·난이도 필터가 생기면 "조건에 맞는 문제 0건"이라는 새 상태가 태어난다. 0건일 때 "조건에 맞는 문제가 없어요" 안내 + [필터 초기화] 버튼을 보여줄 것. FE-04 담당자와 둘이 짝으로 진행 — 남의 코드 위에 얹는 연습.
찾는 법네트워크를 느리게(개발자도구 throttling) 하고 화면 이동 — 흰 화면이나 깜빡임이 보이는 곳이 후보.
완료 조건로딩 중 표시 노출, 로드 완료 시 자연스럽게 교체, 에러 시 로딩이 무한히 남지 않음.
멘토 준비기존 공용 로딩 컴포넌트가 있으면 알려주기(새로 만들지 재사용할지).
+ 🎯 우리 건공용 로딩 컴포넌트(스켈레톤) 도입 — "불러오는 중…" 텍스트가 9곳에 하드코딩되어 있다(grep -rn "불러오는 중" frontend/src로 직접 세어 보기). components/Loading.jsx를 만들어 카드 모양 스켈레톤으로 통일하고, 우선 대시보드(DashboardPage.jsx)와 학습 문서(DocsPage.jsx) 2곳만 교체. 나머지는 후속 티켓.
@@ -184,6 +189,7 @@
찾는 법각 폼에 일부러 빈 값/이상한 값 넣고 제출해 보기 — 서버 에러로만 알게 되는 폼이 후보.
완료 조건정의된 규칙별 에러 문구 노출, 통과 시 정상 제출, 에러 문구는 한국어로 친절하게.
멘토 준비검사 규칙 목록 확정(무엇을 필수로, 어떤 형식으로).
+ 🎯 우리 건비밀번호 변경: 새 비번 = 현재 비번 차단 — frontend/src/pages/ChangePasswordPage.jsx — 지금은 새 비밀번호를 현재 것과 똑같이 넣어도 통과된다(바꾼 게 아닌데 바꿨다고 안내됨). 프론트 validate에 "현재와 다른 비밀번호를 써 주세요" 추가 + 백엔드 AuthService.changePassword에도 같은 검사(프론트는 우회 가능 — 서버가 최종 방어선이라는 걸 몸으로 익히는 티켓).
@@ -194,6 +200,7 @@
찾는 법운영/관리 화면 중 항목이 20개 이상 쌓이는 목록에서 사용자가 스크롤로만 찾는 곳.
완료 조건옵션 변경 시 목록 갱신, 새로고침해도 기본값 정상, 기존 기능 회귀 없음.
멘토 준비정렬/필터 기준 확정, 서버 쿼리 지원 여부 확인(클라이언트 정렬로 충분한지).
+ 🎯 우리 건코딩 문제 목록에 언어·난이도 필터 — frontend/src/pages/CodingPage.jsx — 문제 25개(JS 12·SQL 5·Java 8)가 한 줄로 길게만 나온다. 언어(전체/JS/SQL/Java)와 난이도(쉬움/보통/어려움) 필터 칩을 추가. useState 2개와 .filter()면 충분 — 새 API 불필요. 퀴즈 페이지의 탭 UI(tabs 클래스)를 참고. 완료되면 FE-01(0건 빈 상태)로 이어진다.
@@ -204,6 +211,7 @@
찾는 법서버 꺼두고/네트워크 끊고 주요 동작 실행 — 알 수 없는 문구가 뜨는 곳 수집.
완료 조건실패 상황별 지정 문구 노출, 콘솔 에러는 유지(디버깅용), 문구 목록 문서화.
멘토 준비상황별 문구 톤 가이드 한 줄(사과·원인·해결 순).
+ 🎯 우리 건세션 만료 안내 메시지 — frontend/src/api/client.js의 401 인터셉터가 /login으로 보낼 때 아무 설명이 없다 — 학생 입장에선 "쓰다가 갑자기 로그인 화면"이다. 인터셉터에서 /login?expired=1로 보내고, LoginPage.jsx가 쿼리스트링(useSearchParams)을 읽어 "세션이 만료됐어요. 다시 로그인해 주세요"를 폼 위에 표시.
@@ -214,6 +222,7 @@
찾는 법개발자도구 모바일 뷰(375px)로 주요 화면 전부 훑기 — 가로 스크롤 생기는 곳이 후보.
완료 조건375px·768px·데스크톱 3구간 스크린샷 첨부, 기존 데스크톱 레이아웃 변화 없음.
멘토 준비깨지는 화면 목록 미리 수집(학생이 찾는 것부터 시키면 반나절 추가).
+ 🎯 우리 건상단 메뉴 가로 스크롤 힌트 — 모바일에서 상단 메뉴(global.css의 .topnav-menu)가 "코딩 문…"처럼 잘리는데, 스크롤바까지 숨겨져 있어(::-webkit-scrollbar) 더 있다는 표시가 전혀 없다. 오른쪽 가장자리 그라데이션 페이드(mask-image 또는 ::after)로 "더 있음"을 암시할 것. CSS만으로 해결 — JS 불필요.
@@ -224,6 +233,7 @@
찾는 법비슷한 JSX 덩어리를 검색(클래스명·문구로 grep) — 3곳 이상 반복되는 블록이 후보.
완료 조건추출한 컴포넌트 1개 + 기존 사용처 전부 교체, 화면 픽셀 변화 없음(전후 스크린샷).
멘토 준비대상 지정 필수(범위 폭주 방지). props 설계는 착수 계획서에서 함께 리뷰.
+ 🎯 우리 건페이지 히어로 공통 컴포넌트 추출 — hero compact 블록(eyebrow + 제목 + 설명)이 7개 페이지에 복붙되어 있다. components/PageHero.jsx로 추출(eyebrow·title·children props 설계)하고 2~3개 페이지부터 적용. "언제 컴포넌트로 뽑는가(3번 반복되면)"와 props 설계를 연습하는 티켓.
@@ -240,6 +250,7 @@
찾는 법프론트에서 두 번 요청해서 조합하거나, 하드코딩으로 때운 값이 있는 화면의 API가 후보.
완료 조건응답 DTO에 필드 추가, 기존 호출부 회귀 없음, 화면에 값 표시, API 문서/주석 갱신.
멘토 준비추가할 필드와 출처(어느 테이블/계산) 지정.
+ 🎯 우리 건코딩 문제 목록에 시도 횟수(attempts) 내려주기 — CodingController의 ProblemSummary record에는 attempts가 없다(상세 ProblemDetail에는 있음). 목록 응답에 추가하고, 프론트 CodingPage.jsx 목록에 "3번째 도전 중" 배지 표시. record 필드 추가 → 서비스 → 화면까지 세로로 관통하는 첫 티켓으로 적당.
@@ -250,6 +261,7 @@
찾는 법등록/수정 API에 일부러 이상한 값 보내 보기 — 500이 뜨는 곳이 후보.
완료 조건정의된 규칙 위반 시 400 + 명확한 메시지, 정상 값은 기존대로, 테스트 1개 추가.
멘토 준비검증 규칙 표(필드·규칙·에러 메시지) 초안.
+ 🎯 우리 건코딩 제출 코드 길이 제한 — CodingController.SubmitRequest의 code 필드에 길이 제한이 없다 — 수 MB를 보내도 DB가 그대로 받는다. @Size(max = 20000)(약 500줄) + 컨트롤러 @Valid 확인 + 프론트 초과 시 안내. "받을 수 있는 것"과 "받아도 되는 것"은 다르다는 검증 원칙 티켓.
@@ -260,6 +272,7 @@
찾는 법최근 장애/문의 때 로그 보고도 원인을 몰랐던 지점을 선임에게 물어 수집.
완료 조건지정 지점 로그에 식별자·원인 포함, 개인정보(전화번호 등) 마스킹 확인.
멘토 준비개인정보 로깅 금지 규칙 브리핑(이 티켓이 보안 교육 기회).
+ 🎯 우리 건검증 실패(400) 응답 메시지 한국어 통일 — @Valid 실패 시 응답 message가 "Validation failed for object='loginRequest'…" 영어 원문이다(기본기 감사에서 발견). @RestControllerAdvice + MethodArgumentNotValidException 핸들러를 만들어 첫 번째 필드 에러의 한국어 메시지(DTO에 이미 다 적어 둠)를 {"message": "..."}로 내려주기. 전역 예외 처리 입문 티켓.
@@ -270,6 +283,7 @@
찾는 법관리/통계 화면에서 "이 목록도 보고 싶다"고 미뤄둔 요구가 후보 (신규 화면과 세트로 주면 FE 수습생과 협업 티켓이 됨).
완료 조건API 동작(페이징 포함 여부 명시), 계층 구조 준수, 테스트 1개, API 명세 공유.
멘토 준비대상 테이블·조건·응답 형태 스펙 한 장. 참고할 기존 유사 API 지정.
+ 🎯 우리 건학생 한 명의 과제 제출 모아보기 API — 멘토 화면(MentorController)에는 전체 제출 최신순(GET /api/mentor/submissions)만 있고 학생별로 모아보기가 없다. GET /api/mentor/students/{userId}/submissions 신규 작성(단순 R) + MentorPage.jsx에서 학생 이름 클릭 시 필터. hasRole("MENTOR") 권한이 어떻게 걸리는지(SecurityConfig) 함께 확인.
@@ -280,6 +294,7 @@
찾는 법서비스 코드에서 의미를 알 수 없는 숫자 리터럴 grep — 선임이 "이건 바뀔 수 있는 값"이라고 확인해준 것만.
완료 조건동작 변화 없음(값 동일), 상수 이름이 의미를 설명, 어디서 왜 쓰는지 주석.
멘토 준비추출 대상 목록 지정(전체 수색은 범위 폭주).
+ 🎯 우리 건로그인 잠금 정책을 설정값으로 추출 — LoginAttemptService의 5회/5분이 static final 상수로 박혀 있다. security.login-lock.max-failures·lock-minutes를 application.yml에 ${ENV:기본값} 패턴으로 추출(@Value 주입) — 컨테이너 재빌드 없이 정책을 조정할 수 있게. 기존 테스트(LoginAttemptServiceTest)가 깨지지 않게 유지하는 것까지가 완료 조건.
@@ -290,6 +305,7 @@
찾는 법쿼리 로그 켜고 목록 화면 열기 — 같은 모양 쿼리가 수십 번 반복되는 곳이 후보.
완료 조건쿼리 수 전/후 비교 기록(예: 51→2), 결과 데이터 동일함 검증, 개선 설명 PR에 작성.
멘토 준비대상 지점 확정 필수. JPA 페치 전략을 함께 리뷰(혼자 두면 위험한 티켓).
+ 🎯 우리 건N+1 지점 측정하고 개선하기 — MentorController·CodingService 주석에 "학생 4~5명이라 괜찮다(N+1)"고 적어 둔 지점이 있다(grep -rn "N+1" backend/src). SQL 로그를 켜고(logging.level...SQL: DEBUG) 멘토 화면을 열어 쿼리가 몇 번 나가는지 직접 센 뒤, 학생 100명 가정으로 IN 절/JOIN FETCH로 줄이기. 측정→개선→재측정 수치를 PR에 첨부.
@@ -306,6 +322,7 @@
찾는 법이슈 트래커/메모에 쌓인 "급하지 않은 버그" 목록에서 데이터 파손 위험 없는 것.
완료 조건재현 절차 문서, 수정 PR, 실패했다가 통과하는 테스트 1개.
멘토 준비버그 후보 2~3개 골라두기(1개는 막힐 경우의 교체용).
+ 🎯 우리 건잠재 버그: 문서 뷰어 notFound 상태 미리셋 — frontend/src/pages/DocViewerPage.jsx — notFound가 한 번 true가 되면 되돌리는 코드가 없다. 지금은 문서 간 직행 링크가 없어 안 터질 뿐(전수 감사에서 "결함 실재, 현재 도달 불가"로 판정된 건). 재현 경로를 직접 구성(없는 slug 접속 → 정상 문서로 이동)해 버그를 드러내고, slug 변경 시 상태 리셋으로 수정. "도달 불가한 결함은 언제 고치는가"를 토론해 보는 티켓.
@@ -316,6 +333,7 @@
찾는 법if 분기가 3개 이상인데 테스트 0개인 함수를 서비스 코드에서 찾기.
완료 조건케이스 5개 이상(경계값 포함), 전부 통과, 테스트 이름만 봐도 뭘 검증하는지 알 것.
멘토 준비대상 함수 지정 + 기존 테스트 파일 1개를 본보기로 알려주기.
+ 🎯 우리 건SubmissionService·CourseProgressService 단위 테스트 — 이 두 서비스만 테스트가 0개다(backend/src/test/.../service/ 목록과 대조). ProgressServiceTest 패턴(Mockito + 한국어 @DisplayName) 그대로 — 재제출 시 상태가 SUBMITTED로 돌아오는지, 없는 과제 404, 빈 내용 400 등 분기마다 1개. 전체 테스트가 25개+로 늘어나는 걸 확인.
@@ -326,6 +344,7 @@
찾는 법본인의 1주차 세팅 메모가 그대로 재료. (이 티켓은 사실상 준비돼 있음)
완료 조건문서만 보고 다른 수습생이 클린 세팅 성공(상호 검증), 시크릿 값은 문서에 안 씀.
멘토 준비문서 위치 지정, 시크릿 기재 금지 재강조.
+ 🎯 우리 건README 현행화 — 따라 하면 실행되게 — README.md에 텔레그램 알림·로그인 잠금·내 정보·주소찾기 등 최근 기능이 하나도 없다(grep 0건). README만 보고 처음부터 로컬 실행을 따라 해 보고, 막히는 지점(환경변수·포트·시드 계정)을 전부 고쳐 쓰기. "문서는 새 팀원이 검증한다" — 여러분이 그 새 팀원이다.
@@ -336,6 +355,7 @@
찾는 법에디터/린트의 unused 경고 + 주석 블록 검색. 삭제 전 "정말 안 쓰나" 확인 방법을 배우는 게 포인트.
완료 조건빌드·테스트 통과, 삭제 목록을 PR 설명에 정리, 확신 없는 건 삭제 대신 질문.
멘토 준비범위 폴더 지정(전체 수색 금지), 리뷰 꼼꼼히.
+ 🎯 우리 건미사용 import·변수 정리 (frontend/src/pages 한정) — npm run lint 결과를 기준으로 frontend/src/pages 디렉터리의 미사용 import·변수만 정리. 범위를 벗어난 "김에 수정"은 금지 — 정리 PR은 작아야 리뷰가 된다는 걸 배우는 티켓. lint 경고 개수 before/after를 PR 설명에 기록.
@@ -351,6 +371,7 @@
무엇을FE-01·FE-05와 짝: 빈 상태/에러 상태의 일러스트·문구·레이아웃을 디자인하고 개발자에게 핸드오프.
완료 조건시안 + 문구 + 간격/색 명세, 개발 구현 결과가 시안과 일치하는지 확인까지.
멘토 준비기존 디자인 톤 참고 자료 전달.
+ 🎯 우리 건빈 상태·오류 화면 디자인 세트 — FE-01·FE-05와 짝. 플랫폼 공통 상태 3종(데이터 없음 / 검색 결과 없음 / 오류) 일러스트+문구 톤을 피그마로 설계. 현재 화면들은 회색 텍스트 한 줄뿐이다. 개발 수습생과 협업해 1종은 실제 반영까지 — 디자인이 코드가 되는 전 과정을 경험.
@@ -360,6 +381,7 @@
무엇을2주차 UI 인벤토리에서 찾은 불편 지점 1개를 개선 시안으로 만들고, 팀 리뷰 통과분을 개발 티켓으로 넘기기.
완료 조건현행 문제 정의 → 개선 시안(2안) → 선택안 핸드오프 문서 → 구현 확인.
멘토 준비개선 후보 화면 2~3개 승인해 두기(고객사 승인 필요 화면 제외).
+ 🎯 우리 건퀴즈 결과 화면 UX 관찰·개선 제안 — 퀴즈 결과 화면(QuizPage.jsx 채점 후) — 틀린 문제를 다시 보는 흐름을 동료 2명이 쓰는 걸 관찰하고(어디서 머뭇거리나), 개선안 1장(before/after 스케치)을 멘토에게 제안 → 승인되면 개발 티켓으로 전환. "관찰 → 제안 → 반영"의 UX 사이클 한 바퀴.
@@ -369,6 +391,7 @@
무엇을서비스에서 쓰이는 버튼·입력·카드·색·글자 크기를 한 장으로 정리한 "컴포넌트 정리표" 제작 — FE-07(공통 컴포넌트화)의 근거 자료가 됨.
완료 조건컴포넌트별 변형 수 집계, 통일 제안 포함, 팀 공유 발표 10분.
멘토 준비범위(화면 몇 개까지) 지정.
+ 🎯 우리 건미니 디자인 시스템 정리표 — global.css의 버튼(btn·btn-primary·btn-ghost)·배지(badge-*)·칩·카드 변형을 화면 캡처로 전수 수집해 피그마 정리표로. 색·간격·글자 크기 토큰까지 뽑으면 이 플랫폼의 미니 디자인 시스템 v0.1이 된다. DZ-01·FE-07과 자연스럽게 연결.
@@ -401,31 +424,31 @@
배정 트래커
티켓 풀 현황판
- D-7까지 각 패턴을 실제 건으로 구체화하고, 5~6주차에 배정하면서 채워 나가세요. 학생 1명당 5~6주 동안 2~4건이 적당해요.
+ ✅ 2026-07-17 구체화 완료 — 20건 모두 이 학습 플랫폼(mirim-app) 실코드 기준으로 검증했습니다. 이제 5~6주차에 배정만 하면 됩니다. 학생 1명당 5~6주 동안 2~4건이 적당해요.
| 패턴 | 실제 티켓 제목 | 구체화 | 배정 대상 | 배정일 | 상태 |
|---|
- | FE-01 | | ☐ | | | |
- | FE-02 | | ☐ | | | |
- | FE-03 | | ☐ | | | |
- | FE-04 | | ☐ | | | |
- | FE-05 | | ☐ | | | |
- | FE-06 | | ☐ | | | |
- | FE-07 | | ☐ | | | |
- | BE-01 | | ☐ | | | |
- | BE-02 | | ☐ | | | |
- | BE-03 | | ☐ | | | |
- | BE-04 | | ☐ | | | |
- | BE-05 | | ☐ | | | |
- | BE-06 | | ☐ | | | |
- | QA-01 | | ☐ | | | |
- | QA-02 | | ☐ | | | |
- | QA-03 | | ☐ | | | |
- | QA-04 | | ☐ | | | |
- | DZ-01 | | ☐ | | | |
- | DZ-02 | | ☐ | | | |
- | DZ-03 | | ☐ | | | |
+ | FE-01 | 코딩 문제 필터 결과 0건 빈 상태 | ☑ | | | |
+ | FE-02 | 공용 로딩 컴포넌트(스켈레톤) 도입 | ☑ | | | |
+ | FE-03 | 비밀번호 변경: 새 비번 = 현재 비번 차단 | ☑ | | | |
+ | FE-04 | 코딩 문제 목록에 언어·난이도 필터 | ☑ | | | |
+ | FE-05 | 세션 만료 안내 메시지 | ☑ | | | |
+ | FE-06 | 상단 메뉴 가로 스크롤 힌트 | ☑ | | | |
+ | FE-07 | 페이지 히어로 공통 컴포넌트 추출 | ☑ | | | |
+ | BE-01 | 코딩 문제 목록에 시도 횟수(attempts) 내려주기 | ☑ | | | |
+ | BE-02 | 코딩 제출 코드 길이 제한 | ☑ | | | |
+ | BE-03 | 검증 실패(400) 응답 메시지 한국어 통일 | ☑ | | | |
+ | BE-04 | 학생 한 명의 과제 제출 모아보기 API | ☑ | | | |
+ | BE-05 | 로그인 잠금 정책을 설정값으로 추출 | ☑ | | | |
+ | BE-06 | N+1 지점 측정하고 개선하기 | ☑ | | | |
+ | QA-01 | 잠재 버그: 문서 뷰어 notFound 상태 미리셋 | ☑ | | | |
+ | QA-02 | SubmissionService·CourseProgressService 단위 테스트 | ☑ | | | |
+ | QA-03 | README 현행화 — 따라 하면 실행되게 | ☑ | | | |
+ | QA-04 | 미사용 import·변수 정리 (frontend/src/pages 한정) | ☑ | | | |
+ | DZ-01 | 빈 상태·오류 화면 디자인 세트 | ☑ | | | |
+ | DZ-02 | 퀴즈 결과 화면 UX 관찰·개선 제안 | ☑ | | | |
+ | DZ-03 | 미니 디자인 시스템 정리표 | ☑ | | | |