코리안무드 셀러 어드민

🔑접속 정보

아이디 / 비밀번호 옆 복사 버튼을 클릭하세요

🛡️

본사 관리자

ADMIN · 전체 권한

이메일 admin@koreaanmood.com

비밀번호 Admin1234!

관리자 로그인 → 대시보드

👤

셀러 (테스트 계정)

SELLER · 브랜드A

이메일 seller-a@test.com

비밀번호 Seller1234!

셀러 로그인 → 대시보드

🛍️

카페24 쇼핑몰 사용자

CAFE24 · 쇼핑몰 회원

쇼핑몰 cafeadmin77.cafe24.com

아이디 test1

비밀번호 dlshvoa00!!

쇼핑몰 로그인 → 쇼핑몰 보기

🏪

카페24 쇼핑몰 관리자

CAFE24 · 쇼핑몰 어드민

쇼핑몰 cafeadmin77.cafe24.com

아이디 cafeadmin77

비밀번호 dlshvoa00!!

카페24 관리자 로그인 → 쇼핑몰 보기

📊전체 진행률

Phase 0 ~ Phase 5

Phase 0 · 착수 준비

100%

✓ 완료

Phase 1 · 골격 구축

100%

✓ 완료

Phase 2 · UI/UX

100%

✓ 완료

Phase 3 · 핵심 기능

100%

✓ 완료

Phase 4 · 고급/최적화

100%

✓ 완료

Phase 5 · 검수/오픈

50%

진행중

전체 태스크

29 / 30

97%

⏳ 남은 작업: T-030 프로덕션 오픈 (카페24 OAuth + Full sync + 50개 셀러 계정)

📋Phase 상세 진행 상황

클릭으로 펼치기 / 접기

P0 착수 준비 (Phase 0)

1/1 완료 ▼

Task ID	작업명	주요 산출물	상태
T-001	비즈니스 정책 및 환경 확정 정산 VAT/환불/배송비 정책, 카페24 OAuth 앱 등록, Rate Limit 확정	정산 VAT 처리 방식 (공급가 기준) 환불 차감 시점 확정 카페24 OAuth 앱 등록 완료 .env.example 작성 Rate Limit 문서화	완료

P1 애플리케이션 골격 구축 (Phase 1)

4/4 완료 ▼

Task ID	작업명	주요 산출물	상태
T-002	프로젝트 초기 셋업 Next.js 16.x App Router + TypeScript strict, pnpm, ESLint, Tailwind CSS 4, shadcn/ui	Next.js 16.x + TypeScript strict pnpm + ESLint/Prettier + Husky Tailwind CSS 4 + shadcn/ui PM2 ecosystem.config.js	완료
T-003	라우트 구조 및 레이아웃 골격 app/(auth), app/(admin), app/(seller) 라우트 그룹, 모든 주요 페이지 skeleton	(auth) / (admin) / (seller) 라우트 그룹 SidebarAdmin, SidebarSeller, Header not-found, error, loading 전역 페이지	완료
T-004	타입 정의 및 Prisma 스키마 설계 11개 테이블 Prisma 5.x 스키마, domain enum, pnpm db:push	11개 테이블 스키마 정의 MariaDB 테이블 생성 (db:push) src/types/ SessionUser, ApiResult 등	완료
T-005	데이터 격리 팩토리 및 인증 미들웨어 골격 getSellerPrisma() 팩토리, Iron Session 8.x, CSRF Origin 검증	getSellerPrisma(sellerId) 팩토리 (Prisma $extends) src/proxy.ts — Next.js 16 Edge-safe 가드 Iron Session 8.x (8시간, httpOnly) CSRF Origin 검증 유틸	완료

P2 UI/UX 완성 — 더미 데이터 (Phase 2)

5/5 완료 ▼

Task ID	작업명	주요 산출물	상태
T-006	디자인 시스템 및 공통 컴포넌트 라이브러리 shadcn/ui 컴포넌트, DataTable, SalesChart, KpiCard, 더미 데이터 생성기	DataTable (정렬/페이지네이션/검색) SalesLineChart / SalesBarChart (recharts) KpiCard 컴포넌트 더미 데이터 생성기 (셀러 5, 상품 100, 주문 500)	완료
T-007	인증 페이지 UI 로그인, 비밀번호 변경, 계정 잠금 안내 페이지	로그인 페이지 (RHF + Zod) 비밀번호 변경 페이지 계정 잠금 안내 페이지	완료
T-008	셀러 화면 UI 완성 대시보드, 상품/주문/배송/CS/매출/정산 전체 화면 UI	셀러 대시보드 KPI + 차트 상품 목록/수정 (인라인 편집) 주문 목록/상세 + 상태 변경 모달 배송 처리 모달 (택배사 + 운송장) 취소/반품/교환 조회 (읽기 전용) 매출 통계 + 정산 추정	완료
T-009	본사 관리자 화면 UI 완성 셀러 계정 관리, 전체 주문/정산 조회, SyncJob 모니터링 화면	셀러 계정 관리 (CRUD + 수수료율) 전체 주문 조회 (셀러 필터) 전체 정산 조회 (추정치 표) SyncJob 모니터링 화면	완료
T-010	반응형 및 PC 데스크톱 최적화 검수 1280/1440/1920 해상도 검증, 키보드 네비게이션, Playwright 스냅샷	1280/1440/1920 해상도 검증 Playwright MCP 스냅샷 확인 aria-label 접근성 기본 적용	완료

P3 핵심 기능 구현 (Phase 3)

13/13 완료 ▼

Task ID	작업명	주요 산출물	상태
T-011	인증 시스템 구현 argon2id 해시, 5회 실패 30분 잠금, Iron Session 발급/갱신/소멸	argon2id 비밀번호 해시 (@node-rs/argon2) 로그인 5회 실패 → 30분 잠금 Iron Session 발급/갱신 비밀번호 변경 API	완료
T-012	셀러 계정 관리 API admin 가드, 셀러 CRUD, CommissionPolicy 이력, AuditLog	셀러 CRUD API (임시 비밀번호 발급) CommissionPolicy 이력 관리 모든 변경 AuditLog 기록	완료
T-013	카페24 OAuth 토큰 발급 및 암호화 Authorization Code 플로우, AES-256-GCM 암호화, 자동 갱신	OAuth Authorization Code 플로우 AES-256-GCM 토큰 암호화 저장 만료 5분 전 자동 refresh	완료
T-014	카페24 API 클라이언트 및 Rate Limit fetch 클라이언트, Full Jitter Backoff, 429/5xx 큐잉, 레이턴시 로깅	fetch 기반 cafe24 클라이언트 Full Jitter Exponential Backoff (5회) 429/5xx 자동 재시도 개인정보 마스킹 레이턴시 로깅	완료
T-015	카페24 동기화 워커 구현 Incremental sync (5분/30분), Full sync 새벽 3시, SyncJob 기록	주문/CS Incremental sync (5분) 상품 Incremental sync (30분) Full sync 03:00 cron + 중복 방지 락 SyncJob 시작/종료/건수/에러 기록	완료
T-016	상품 조회/수정 API getSellerPrisma 격리, 가격/재고/상태 PATCH → 카페24 동기 PUT, 롤백	자사 상품 조회 (sellerId 격리) 가격/재고/판매상태 PATCH API 카페24 PUT 동기 호출 + 실패 롤백	완료
T-017	주문 조회/상태 변경 API 주문 목록/상세, 상태 전이 검증 (결제완료→준비중→배송중)	주문 목록 (검색/필터/정렬) 주문 상세 + OrderItem 상태 전이 검증 (일방향)	완료
T-018	배송 처리 API 택배사 + 운송장 입력, Shipment 생성, 카페24 배송 등록, 운송장 중복 체크	Shipment 생성 API 카페24 배송 등록 동기 호출 운송장 중복 체크	완료
T-019	CS(취소/반품/교환) 조회 API 카페24 CS 데이터 동기화, 셀러 격리 읽기 전용	CS 데이터 동기화 셀러 격리 조회 (읽기 전용)	완료
T-020	매출 통계 API 일별/월별 집계, 대시보드 KPI, 5분 메모리 캐시	일별/월별 매출 집계 (N+1 최적화) 대시보드 KPI 합산 API 5분 TTL 메모리 캐시	완료
T-021	정산 추정 API 기간별 매출 × CommissionPolicy → Settlement 추정, 참고용 추정치 메타	CommissionPolicy 시점 적용 계산 Settlement 추정 upsert "참고용 추정치" 응답 메타	완료
T-022	본사 관리자 전체 주문 API admin 가드, sellerId 필터 옵션 전체 주문 조회	admin 가드 + sellerId 필터 전체 주문 조회 API	완료
T-023	핵심 기능 통합 테스트 Playwright MCP E2E, 셀러 A/B 격리 크로스 체크, 버그 수정	셀러 전체 플로우 E2E 테스트 sellerId 격리 크로스 체크 CSRF/세션/잠금 엣지 케이스 requireAdmin → checkAdmin 403 응답 수정	완료

P4 고급 기능 및 최적화 (Phase 4)

6/6 완료 ▼

Task ID	작업명	주요 산출물	상태
T-024	엑셀 다운로드 ExcelJS 기반 상품/주문/매출 3개 API, UI 버튼 추가	GET /api/export/products GET /api/export/orders (날짜 범위 최대 1년) GET /api/export/sales (월별 집계) AuditLog (EXPORT_PRODUCTS/ORDERS/SALES) 상품/주문/매출 페이지 다운로드 버튼	완료
T-025	AuditLog 통합 및 관리자 조회 UI 누락 액션 보완, 관리자 AuditLog 조회 API + 화면	SETTLEMENT_ESTIMATED, SYNC_TRIGGERED 추가 GET /api/admin/audit-logs (필터: action/actorId/날짜) /admin/audit-logs 관리자 UI 사이드바 감사 로그 메뉴	완료
T-026	보안 강화 및 점검 IP Rate Limit, 보안 헤더, pnpm audit, CSRF 전수 점검	IP 로그인 Rate Limit (10분 / 20회) X-Frame-Options DENY, CSP, nosniff 헤더 pnpm audit high/critical 0건 CSRF 전수 점검 완료 보안 예외 docs/security/audit-exceptions.md	완료
T-027	성능 최적화 Prisma 복합 인덱스 5개, KPI 메모리 캐시, N+1 쿼리 제거	Order [sellerId, cafe24UpdatedAt] 인덱스 Product [sellerId, updatedAt] 인덱스 AuditLog [actorId, createdAt], [action, createdAt] SyncJob [type, status, startedAt] 인덱스 KPI API 5분 TTL 메모리 캐시 매출 통계 N+1 → 단일 range 쿼리 Promise.all 병렬 쿼리 최적화	완료
T-028	배포 파이프라인 및 모니터링 PM2, Nginx 리버스 프록시, SSL, DB 백업, Healthcheck, Slack 알림	PM2 ecosystem.config.js (port 3006) Nginx 리버스 프록시 (port 80) Pino 구조화 로깅 PM2 pm2-logrotate (50M / 30일 / 압축) Healthcheck API (GET /api/health) Slack 동기화 실패 알림 (src/lib/alert.ts) DB 일일 백업 cron (mysqldump + gzip, 30일 rotation) HTTPS/SSL (certbot — Let's Encrypt 인증서 적용 완료)	완료

P5 검수 및 안정화 (Phase 5)

1/2 완료 ▼

Task ID	작업명	주요 산출물	상태
T-029	UAT 및 본사 검수 본사 + 파일럿 셀러 3개 UAT, 운영 매뉴얼 작성	셀러 시나리오 16개 전체 PASS (S01~S16) 어드민 시나리오 8개 전체 PASS (A01~A08) 발견 버그 6건 수정 (carrier code, mock data, effectiveFrom 등) UAT 결과 보고서 작성 (docs/uat/uat-results.md)	완료
T-030	프로덕션 오픈 및 인수인계 50개 셀러 계정 일괄 생성, Full sync, 인수인계 문서	프로덕션 DB 마이그레이션 카페24 프로덕션 OAuth + 초기 Full sync 50개 셀러 계정 일괄 생성 인수인계 문서 (아키텍처/운영/트러블슈팅)	대기

🔌주요 API 엔드포인트

🔐 인증

POST/api/auth/login

POST/api/auth/logout

PATCH/api/auth/password

👤 셀러

GET/api/products

PATCH/api/products/[id]

GET/api/orders

PATCH/api/orders/[id]/status

POST/api/orders/[id]/ship

GET/api/cs

GET/api/stats/sales

GET/api/stats/kpi

GET/api/settlements/estimate

🛡️ 관리자

GET/api/admin/sellers

POST/api/admin/sellers

PATCH/api/admin/sellers/[id]

GET/api/admin/orders

GET/api/admin/settlements

GET/api/admin/audit-logs

POST/api/admin/sync/trigger

📥 다운로드 / 시스템

GET/api/export/products

GET/api/export/orders

GET/api/export/sales

GET/api/health

GET/api/cafe24/callback

⚡기술 스택

▲

Next.js 16.x

App Router · TS strict

🗄

Prisma 5.x

MariaDB 10.6.12

🎨

Tailwind CSS 4

shadcn/ui

🔐

Iron Session 8.x

argon2id · AES-256-GCM

🏪

카페24 REST API

OAuth 2.0 · Leaky Bucket

📊

Recharts

매출 라인/바 차트

📥

ExcelJS

스트리밍 엑셀

📝

Pino

구조화 로깅 (JSON)

⚙️

PM2

Fork · pm2-logrotate

🌐

Nginx

리버스 프록시 · SSL

🤖

zod

런타임 스키마 검증

📋

react-hook-form

폼 상태 관리

Phase 5 완료 준비 · UAT 통과프로덕션 오픈을 향한 마지막 단계

Phase 5 완료 준비 · UAT 통과
프로덕션 오픈을 향한 마지막 단계