DPSP — Project Command Center

COMPLETED Phase 1 — 코어 인프라 구축

DB 스키마 설계, 인증 체계, 보안 인프라, 기본 프레임워크 구축. 프로젝트의 기술적 기반을 확립한 단계.

6 / 6 완료

✓PostgreSQL 스키마 v4.4 (core + 6 extension schemas)

✓3-Actor 인증 모델 (Admin/Company/Rider) + JWT + TOTP 2FA

✓Express 5 백엔드 + React 19 프론트엔드 + Admin 프론트엔드

✓9개 미들웨어 스택 (auth, ownership, TOTP, accountLock 등)

✓PII 암호화 — AES-256-GCM (주민번호, 계좌번호)

✓IDOR 보호 — ownershipMiddleware 9개 검증 함수

COMPLETED Phase 2 — 정산 파이프라인 완성

엑셀 업로드부터 이체 파일 생성까지 전체 정산 흐름 구현. 쿠팡/배민 4종 파서, 4-tier 매칭, 배치 상태 머신 완성.

8 / 8 완료

✓엑셀 업로드 파이프라인 (web + macro 공용, uploadProcessingService)

✓플랫폼별 파서 (Coupang/Baemin × Daily/Weekly)

✓4-tier 라이더 매칭 + Dead letter 처리 (SAVEPOINT 기반)

✓정산 계산 엔진 — 4개 Calculator (세금·보험·차감 통합)

✓배치 상태 머신 — 8단계 (draft → completed + revoked)

✓인센티브 엔진 — CINR 기반 (company_incentive_rules/results)

✓이체 CSV 파일 생성 + 라이더 명세서 이미지 자동생성

✓위탁/비위탁 전이 권한 분기 (service_type × batch_type)

COMPLETED Phase 3 — 프론트엔드 & 비즈니스 기능

본사/관리자/라이더 UI 완성, 셀프서비스 시스템, 다중 회사 지원, 매크로 에이전트 구축.

8 / 8 완료

✓프론트엔드 통합 5단계 완료 (20+ 공통 컴포넌트, 레이아웃 표준화)

✓본사 프론트엔드 28+ 페이지 (정산·라이더·팀·대시보드·설정)

✓Admin 프론트엔드 16+ 페이지 (Bridge 패턴 컴포넌트 공유)

✓라이더 셀프서비스 (6종 요청, 4종 자동처리 핸들러)

✓다중 회사 M:N 소속 (rider_company_affiliations, dpsp_company_contracts)

✓일정산 전환 요청 시스템 (영구/1회성, resolveIsDailySettlement)

✓매크로 에이전트 시스템 (API 키 인증 + 실행 로그)

✓프로모션 관리 모듈 (개인/팀, 권역별/총합 인센티브)

IN PROGRESS Phase 4 — 안정화 & 런칭 준비

보안 취약점 수정, 데이터 무결성 강화, 핵심 비즈니스 로직 완성. 정식 서비스 운영에 필요한 필수 안정화 작업.

0 / 16 완료 · Sprint 1~2 (예상 3~5주)

P0 긴급 — 데이터 무결성

RW-001: settlement_details 참조 무결성 (fn_archive 호출 로직 구현)

RW-002: CINR 인센티브 함수 구현 (fn_apply_company_incentives)

P1 높음 — 비즈니스 로직 & 보안

RW-003: 하드코딩 요율 → DB 연결 (13건, 4개 Calculator)

RW-004: 매크로 라우트 rate limiting 적용

RW-005: err.message 직접 노출 수정 (9건 컨트롤러)

RW-006: platform_promotion_results 집계 연동

RW-007: auth 미들웨어 통합 (authMiddleware + adminAuth 이원화 해소)

RW-008: 501 스텁 엔드포인트 구현 (dashboard, companies 등 4건)

보안 긴급 — 취약점 수정

VUL-04: JWT 시크릿 하드코딩 폴백 제거 (부팅 시 검증 추가)

VUL-10: Rate limiting 전면 적용 (로그인, SMS, 업로드 등)

VUL-14: Helmet.js 보안 헤더 적용 (CSP, X-Frame 등)

버그 수정 — 미해결 5건

BUG-003: '위탁중' 상태 문구 미표시 (Medium)

BUG-006: 위탁 계정 업로드 차단 누락 (High)

BUG-010, 011, 012, 014: UI/UX 버그 (사이드바, 반응형, 페이지네이션, 버튼)

UPCOMING Phase 5 — 코드 품질 & 기술 부채 해소

6개 감사 보고서 결과 반영, 성능 최적화, 리팩토링. 서비스 안정성과 유지보수성을 높이는 작업.

0 / 10 완료 · Sprint 3 (예상 1~2주)

RW-009~011: TODO 주석 정리 (refactor 6건, security 3건, bug 1건)

RW-012: IRUL 테이블 완전 제거 (2026-02 deprecated)

RW-013: pg_partman 자동 파티션 관리 적용

RW-014: CSS !important 정리 (40건, 6개 파일)

RW-015~017: 불필요 컬럼 제거, 기능 TODO, 백업 파일 정리

프론트엔드 품질 감사 대응 (Critical/High 37건 우선)

에러 핸들링 감사 대응 (Critical/High 19건 우선)

성능 감사 대응 (N+1 쿼리, 파티션 프루닝, 번들 분할)

API 응답 형식 표준화 (29건 불일치 해소)

데이터 무결성 감사 대응 (라운딩 통일, 음수 정산금 검증)

FUTURE Phase 6 — 포스트 런칭 확장

런칭 이후 점진적으로 추가할 기능과 개선 사항. 비즈니스 확장과 사용자 경험 고도화.

Generic Inquiry 시스템 구현 (스키마 존재, 백엔드/프론트엔드 0%)

SuperAdmin 대시보드 실데이터 연동

라이더 전용 모바일 웹 확장

추가 플랫폼 파서 (요기요, 땡겨요 등)

프론트엔드 RoleGuard 패턴 적용 (라우트 레벨 권한 검증)

i18n 시스템 도입 (한국어 하드코딩 127+ 파일 해소)

소득세 신고 지원 데이터 연동

Delivery Partner
Settlement Platform

프로젝트 현황

시스템 아키텍처

React 19 + Vite

Node.js + Express 5

PostgreSQL

정산 데이터 흐름

로드맵

🚀 정식 서비스 런칭

감사 현황

Delivery PartnerSettlement Platform