← 포트폴리오 목록
다중 검사 서비스 통합관리 플랫폼
4개 검사 서비스의 고객 정보를 단일 화면에서 통합 관리하고, 1회 서명으로 다건 동의를 처리하는 통합 서명 시스템을 Next.js + NestJS + Prisma 기반으로 설계·구현합니다.
다중 서비스 정규화 어댑터 계층 설계4개 검사 서비스의 이질적 스키마를 단일 뷰로 정규화하는 Prisma 어댑터 계층 구현, 신규 서비스 추가 시 기존 테이블 무변경 확장 구조 설계
통합 서명 트랜잭션 설계1회 서명으로 다건 동의를 원자적으로 처리하는 Prisma 트랜잭션 구현, 서비스별 PDF 템플릿 엔진과 서명 저장소를 분리 설계
서비스 상태 머신 기반 잠금 로직 구축신청/진행/완료 3단계 상태 머신으로 서비스 수정 가능 범위를 제어, 의뢰서 PDF 버전 관리로 변경 이력 추적 구조 설계
Overview
프로젝트 개요
4개 검사 서비스의 고객 정보를 단일 화면에서 통합 관리하고, 1회 서명으로 다건 동의를 처리하는 통합 서명 시스템을 Next.js + NestJS + Prisma 기반으로 설계·구현합니다. 서비스별 이질적 데이터를 정규화하는 어댑터 계층과 엑셀 일괄 예약 등록까지 포함하며, 서명·동의 데이터 등 민감정보 보호를 고려한 저장 구조를 함께 설계하는 풀스택 프로젝트입니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
4개 검사 서비스마다 다른 데이터 구조를 단일 화면에서 표시하기 위한 스키마 정규화 전략 설계
1회 서명으로 다건 동의를 처리하되 서비스별 법적 동의서 형식을 개별로 보존해야 하는 PDF 생성 구조 설계
진행 완료 서비스의 수정 잠금과 의뢰서 재발급 시점을 동시에 만족하는 상태 전이 규칙 설계
엑셀 업로드 시 행 단위 실패를 사용자에게 명확히 전달하면서도 부분 성공 데이터의 정합성을 보장하는 검증 로직
핵심 기능 1
통합 서비스 관리 대시보드
4개 검사 서비스의 고객을 단일 리스트에서 조회하고, 고객명·생년월일·전화·예약일·검체채취일·바코드·병원명·라이프코드 8종 필터로 좁혀볼 수 있는 통합 화면을 제공합니다
핵심 기능 2
통합 동의 서명 시스템
고객이 여러 검사의 동의서를 1회 서명으로 일괄 처리할 수 있으며, 서비스별 동의 여부를 체크박스로 선택한 뒤 서비스별 동의서 PDF가 자동으로 개별 생성됩니다
핵심 기능 3
서비스 신청 수정 및 재발급
고객 상세에서 신청 서비스 유형을 변경할 수 있으며, 진행이 완료된 서비스는 잠금 처리되고 최소 1개 이상 선택 검증 후 의뢰서 PDF가 재생성됩니다
핵심 기능 4
검사 예약 및 엑셀 일괄 등록
개별 예약은 팝업에서 부모/자식 서비스를 다중 선택해 등록하고, 엑셀 업로드 시 서비스별 매핑 규칙에 따라 다건 예약이 자동화된 파이프라인으로 일괄 등록됩니다
구현 과정
프로젝트 진행 단계
STEP 1
다중 서비스 데이터 모델 및 통합 스키마 설계
4개 검사 서비스 스키마 분석, PostgreSQL 통합 뷰 모델 정의 및 Prisma 어댑터 계층 설계
STEP 2
통합 서명·동의 API 개발
NestJS 기반 서명 저장·PDF 생성 API 구현, 서비스별 동의서 템플릿 엔진 연동
STEP 3
통합 관리 대시보드 UI 개발
Next.js 기반 통합 리스트·상세·서명 화면 구현, 8종 필터와 페이징 컴포넌트 설계
STEP 4
엑셀 일괄 등록 및 통합 테스트
엑셀 파싱 검증 파이프라인 구현, API-프론트 통합 테스트 및 매핑 규칙 케이스 검증
프로젝트 성과
다중 서비스 정규화 어댑터 계층 설계4개 검사 서비스의 이질적 스키마를 단일 뷰로 정규화하는 Prisma 어댑터 계층 구현, 신규 서비스 추가 시 기존 테이블 무변경 확장 구조 설계
통합 서명 트랜잭션 설계1회 서명으로 다건 동의를 원자적으로 처리하는 Prisma 트랜잭션 구현, 서비스별 PDF 템플릿 엔진과 서명 저장소를 분리 설계
서비스 상태 머신 기반 잠금 로직 구축신청/진행/완료 3단계 상태 머신으로 서비스 수정 가능 범위를 제어, 의뢰서 PDF 버전 관리로 변경 이력 추적 구조 설계
엑셀 일괄 등록 검증 파이프라인 구현서비스별 매핑 규칙 4종을 순차 적용하는 행 단위 파싱 검증 엔진 설계, 웹·데스크탑 공용 모듈로 재사용 구조 구축
Review
기술적 주안점
- 다중 서비스 데이터를 단일 스키마로 정규화하는 어댑터 계층을 NestJS 모듈로 구현하여, 신규 검사 서비스 추가 시 기존 코드를 수정하지 않는 확장 구조를 설계합니다
- 1회 서명으로 다건 동의를 완료 처리하는 통합 서명 플로우를 구현하고, 서비스별 PDF는 공통 템플릿 엔진에서 개별 생성되도록 설계합니다
- 서비스 조합 변경을 상태 머신 기반으로 안전하게 처리하고, 변경 즉시 의뢰서 PDF를 재생성하는 워크플로우를 구현합니다
