번역·검수 플랫폼 — 개발 진행 가이드

접속 계정 정보

🛡️

관리자

사용자 관리 · 콘텐츠 등록 · 작업 배정

ADMIN

🛡️ 관리자 대시보드 열기

관리자 대시보드

🔗 대시보드 열기 🔐 로그인 페이지

테스트 계정

아이디 : admin@example.com

비밀번호: Admin1234!

✍️

번역 담당자

원문 다운로드 · 번역본 업로드 · 상태 전이

TRANSLATOR

✍️ 번역 대시보드 열기

번역 대시보드

🔗 대시보드 열기 🔐 로그인 페이지

테스트 계정 1

아이디 : translator1@example.com

비밀번호: Trans1234!

테스트 계정 2

아이디 : translator2@example.com

비밀번호: Trans1234!

🔍

검수 담당자

번역본 다운로드 · 승인 / 수정 요청 처리

REVIEWER

🔍 검수 대시보드 열기

검수 대시보드

🔗 대시보드 열기 🔐 로그인 페이지

테스트 계정 1

아이디 : reviewer1@example.com

비밀번호: Review1234!

테스트 계정 2

아이디 : reviewer2@example.com

비밀번호: Review1234!

Phase별 작업 진행 현황

Phase 0 — 프로젝트 초기 셋업 및 문서화

개발 착수 전 문서·환경 기반 완성

5 / 5 완료 ▼

Task ID	제목	상태
TASK-001	CLAUDE.md 프로젝트 지침 작성	✅ 완료
TASK-002	shrimp-rules.md AI 에이전트 규칙 작성	✅ 완료
TASK-003	docs/PRD.md 요구사항 정의서 작성 (v1.1.0)	✅ 완료
TASK-004	docs/PRD.md 기술 검증 및 업데이트	✅ 완료
TASK-005	docs/ROADMAP.md 개발 로드맵 작성	✅ 완료

Phase 1 — 프로젝트 초기 셋업 및 인증 구조

Next.js 앱 생성, DB 스키마 확정, 로그인/로그아웃 동작

14 / 14 완료 ▼

Task ID	제목	상태
TASK-101	Next.js 16.2.7 앱 초기 생성pnpm create next-app · TypeScript strict · Tailwind · App Router	✅ 완료
TASK-102	핵심 패키지 설치Prisma 5.22, NextAuth v5 beta.31, shadcn/ui, Zod 4, bcryptjs	✅ 완료
TASK-103	환경변수 설정.env / .env.example · DATABASE_URL · NEXTAUTH_SECRET · UPLOAD_DIR	✅ 완료
TASK-104	Prisma 스키마 작성 (7개 테이블)users, contents, translation_tasks, review_tasks, task_files, review_comments, status_change_logs	✅ 완료
TASK-105	docs/ERD.md 작성Mermaid erDiagram · FK 관계 · 상태 전이 요약	✅ 완료
TASK-106	MariaDB 마이그레이션 및 시드prisma db push · 5개 계정(ADMIN 1, TRANSLATOR 2, REVIEWER 2) 생성	✅ 완료
TASK-107	src/lib/db.ts Prisma Client 싱글턴globalThis 패턴 · 핫 리로드 중복 방지	✅ 완료
TASK-108	src/lib/auth.ts NextAuth v5 설정Credentials Provider · JWT · isActive DB 재대조 · role 포함	✅ 완료
TASK-109	인증 미들웨어 및 인증 가드middleware.ts · 미인증→/login · role 불일치→/403	✅ 완료
TASK-110	403 / 401 에러 페이지shadcn Card · 홈 링크 · 로그인 링크	✅ 완료
TASK-111	로그인 페이지 UI(auth)/login · signIn · 에러 메시지 · 역할별 리다이렉트	✅ 완료
TASK-112	로그아웃 처리LogoutButton Client Component · signOut({ callbackUrl: '/login' })	✅ 완료
TASK-113	역할별 route group 레이아웃admin/ · translator/ · reviewer/ layout.tsx · AppHeader	✅ 완료
TASK-114	역할별 대시보드 placeholder/admin/dashboard · /translator/dashboard · /reviewer/dashboard	✅ 완료

Phase 2 — ADMIN 기능 구현

사용자 관리, 콘텐츠 등록, 작업 배정, 전체 현황 대시보드

14 / 14 완료 ▼

Task ID	제목	상태
TASK-201	GET/POST /api/users이메일 중복 409 · bcrypt 해시 · 목록 조회	✅ 완료
TASK-202	PATCH /api/users/[id]마지막 ADMIN 비활성화 방지 · 본인 계정 보호	✅ 완료
TASK-203	사용자 관리 UI (/admin/users)Table · 역할 Select · 활성화 Switch · 계정 생성 Modal	✅ 완료
TASK-204	POST /api/contents (파일 업로드)multipart/form-data · validateAndSaveFile · DB 저장	✅ 완료
TASK-205	GET/PATCH /api/contents, GET /[id]페이지네이션 · 번역작업 include · 메타수정	✅ 완료
TASK-206	GET /api/contents/[id]/file원문 스트리밍 다운로드 · 역할별 접근 제어	✅ 완료
TASK-207	콘텐츠 UI (/admin/contents)목록 · 등록 폼(Checkbox 언어) · 상세 페이지	✅ 완료
TASK-208	POST /api/translation-taskscontent/assignee 검증 · unique 중복 409	✅ 완료
TASK-209	POST /api/review-tasks번역 COMPLETED 조건 · translationTaskId unique	✅ 완료
TASK-210	GET /api/translation-tasks, GET /api/review-tasks역할별 필터 · status/assignee/language 쿼리 파라미터	✅ 완료
TASK-211	PATCH /api/translation-tasks/[id]/status (ADMIN)강제 상태 변경 · reason 필수 · StatusChangeLog 기록	✅ 완료
TASK-212	작업 관리 UI (/admin/tasks)번역·검수 통합 테이블 · 상태 배지	✅ 완료
TASK-213	GET /api/dashboard/summary상태별 카운트 · 최근 작업 5건	✅ 완료
TASK-214	관리자 대시보드 UI (/admin/dashboard)요약 카드 4개 · 상태 현황 · 최근 작업 · 빠른 링크	✅ 완료

Phase 3 — TRANSLATOR 기능 구현

작업 조회, 원문 다운로드, 번역본 업로드, 상태 전이

8 / 8 완료 ▼

Task ID	제목	상태
TASK-301	GET /api/translation-tasks/[id] (상세)소유권 검증 · reviewTask+comments include · 파일 목록	✅ 완료
TASK-302	GET /api/contents/[id]/file (원문 다운로드)runtime=nodejs · TRANSLATOR 배정 확인 · createStreamResponse	✅ 완료
TASK-303	PATCH /api/translation-tasks/[id]/status허용 전이 매트릭스 · COMPLETED 시 파일 필수 · 낙관적 잠금	✅ 완료
TASK-304	POST/GET /api/translation-tasks/[id]/filesIN_PROGRESS 상태 한정 · 기존 파일 교체 · BigInt 직렬화	✅ 완료
TASK-305	GET /api/translation-tasks/[id]/files/[fileId]번역본 다운로드 · REVIEWER 배정 확인 · 스트리밍	✅ 완료
TASK-306	GET /api/review-tasks/[id]/comments검수 의견 목록 · author include · REVIEWER 소유권	✅ 완료
TASK-307	TRANSLATOR 대시보드 UI배정 작업 목록 · 상태 요약 카드	✅ 완료
TASK-308	번역 작업 상세 UI (/translator/tasks/[id])원문 다운로드 · 파일 업로드 · 상태 전이 버튼 · 수정 사유 표시	✅ 완료

Phase 4 — REVIEWER 기능 구현

검수 작업 조회, 번역본 다운로드, 승인/반려 트랜잭션

8 / 8 완료 ▼

Task ID	제목	상태
TASK-401	GET /api/review-tasks (목록, 본인 필터)REVIEWER 소유권 · 페이지네이션	✅ 완료
TASK-402	GET /api/review-tasks/[id] (상세)translationTask+comments include · 소유권 403	✅ 완료
TASK-403	번역본 파일 다운로드 APIruntime=nodejs · REVIEWER 배정 확인 · Path Traversal 방어	✅ 완료
TASK-404	검수 시작 (PENDING → IN_PROGRESS)낙관적 잠금 · 상태 충돌 409	✅ 완료
TASK-405	승인 트랜잭션$transaction · 번역 DELIVERED + 검수 COMPLETED 원자적 변경	✅ 완료
TASK-406	반려 트랜잭션$transaction · 번역+검수 REVISION_REQUESTED + ReviewComment 생성	✅ 완료
TASK-407	REVIEWER 대시보드 UI배정 검수 작업 목록 · 상태 요약 카드	✅ 완료
TASK-408	검수 작업 상세 UI (/reviewer/tasks/[id])번역본 다운로드 · 검수 시작/승인/반려 버튼 · 사유 입력 · 의견 이력	✅ 완료

Phase 5 — 파일 처리 공통 유틸리티 및 보안 강화

파일 검증·저장·다운로드 공통 로직, Zod 스키마, Rate Limiting

6 / 6 완료 ▼

Task ID	제목	상태
TASK-501	src/lib/file.ts — 파일 유틸리티확장자+MIME 매직바이트 검증 · UUID 파일명 · Path Traversal 방어 · ReadableStream	✅ 완료
TASK-502	src/lib/validation.ts — Zod 스키마uuid, email, role, targetLanguage, taskStatus, pagination 공통 스키마	✅ 완료
TASK-503	Rate Limiting — 로그인 브루트포스 방어IP당 5분 10회 · 이메일당 5분 5회 · 인메모리 카운터 · 429 응답	✅ 완료
TASK-504	ADMIN 완료 파일 다운로드DELIVERED 상태 번역 작업 최종 번역본 다운로드	✅ 완료
TASK-505	GET /api/health — 헬스체크db.$queryRaw SELECT 1 · 200 ok / 503 disconnected	✅ 완료
TASK-506	Phase 2~4 API file.ts·validation.ts 통합validateAndSaveFile(2곳) · createStreamResponse(2곳) · Zod 스키마 전체 적용	✅ 완료

Phase 6 — 통합 테스트 및 배포 준비

Vitest 단위 테스트, E2E 워크플로우 검증, PM2·Nginx 배포

8 / 8 완료 ▼

Task ID	제목	상태
TASK-601	단위 테스트 — Rate Limiting / Zod 스키마vitest · 38개 테스트 통과 · 232ms	✅ 완료
TASK-602	TypeScript 타입체크 전체 통과pnpm typecheck — 오류 0	✅ 완료
TASK-603	E2E — 승인 경로 검증PENDING→IN_PROGRESS→COMPLETED→DELIVERED 시퀀스 시뮬레이션	✅ 완료
TASK-604	E2E — 재작업 경로 검증반려→REVISION_REQUESTED→재업로드→재검수→DELIVERED 시뮬레이션	✅ 완료
TASK-605	PM2 ecosystem.config.jsfork mode · 포트 3020 · 로그 설정	✅ 완료
TASK-606	nginx.conf.example리버스 프록시 · client_max_body_size 55m · /uploads deny all · HTTPS	✅ 완료
TASK-607	Rocky Linux 서버 배포 및 PM2 기동PM2 ID 49 · 포트 3020 · online 상태 확인	✅ 완료
TASK-608	프로덕션 스모크 테스트curl http://localhost:3020/api/health → {"status":"ok","db":"connected"}	✅ 완료

기술 스택

⚡

Next.js 16

App Router · Server Components

🔷

TypeScript 5

strict mode · 반환 타입 명시

🗄️

Prisma 5

MariaDB 10.6 · $transaction

🔐

NextAuth v5

Credentials · JWT · DB 재대조

🎨

shadcn/ui

base-ui · Tailwind CSS 4

✅

Zod 4

API 입력 검증 · 공통 스키마

🧪

Vitest 4

38개 단위 테스트 통과

🚀

PM2

포트 3020 · Rocky Linux

다국어 교육콘텐츠 번역·검수 협업 플랫폼

📊 전체 진행률

관리자

번역 담당자

검수 담당자

Phase 0 — 프로젝트 초기 셋업 및 문서화

Phase 1 — 프로젝트 초기 셋업 및 인증 구조

Phase 2 — ADMIN 기능 구현

Phase 3 — TRANSLATOR 기능 구현

Phase 4 — REVIEWER 기능 구현

Phase 5 — 파일 처리 공통 유틸리티 및 보안 강화

Phase 6 — 통합 테스트 및 배포 준비

Next.js 16

TypeScript 5

Prisma 5

NextAuth v5

shadcn/ui

Zod 4

Vitest 4

PM2