프로젝트 개요
홀가분 심리검사는 심리 검사 프로젝트를 관리하고 응시자의 응답을 수집·분석하기 위한 백엔드 플랫폼입니다. 관리자는 다양한 유형의 문항(단일 선택, 복수 선택, 5점 척도, 안내문)으로 구성된 심리 검사 프로젝트를 생성할 수 있으며, 응시자는 고유 액세스 코드를 통해 검사에 참여하고 결과를 확인할 수 있습니다.
NestJS 프레임워크 기반으로 도메인 주도 설계(DDD) 패턴을 적용하여, 관리자 앱(Admin App)과 클라이언트 앱(Client App)의 API를 하나의 서버에서 모듈 단위로 분리·운영합니다.
기능 플로우
주요 기능
- 프로젝트 생성 및 관리: 관리자가 심리 검사 프로젝트를 생성하고, 제목·설명·커버 이미지를 설정합니다. 프로젝트 복제(딥 카피) 기능으로 기존 검사를 빠르게 재활용할 수 있습니다.
- 다양한 문항 유형 지원: 단일 선택(
SINGLE_SELECT), 복수 선택(MULTI_SELECT), 5점 척도(FIVE_POINT_SCALE), 안내문(GUIDE) 등 4가지 문항 유형을 제공합니다. - 선택지-결과 매핑: 각 선택지에 결과 엔딩(Ending)을 매핑하여, 응시자의 응답 패턴에 따라 맞춤형 결과를 자동으로 도출합니다.
- 액세스 코드 기반 응시 관리: 프로젝트별 고유 액세스 코드를 발급하여 응시자 접근을 제어합니다. 코드당 1회 응시로 중복 참여를 방지합니다.
- 응답 수집 및 분석: 응시자의 문항별 답변과 소요 시간을 기록하고, 매핑된 결과를 자동으로 산출합니다.
- 파일 업로드:
Supabase스토리지와Cloudflare R2를 활용하여 프로젝트 커버 이미지, 문항 이미지 등을 관리합니다. - 관리자 인증:
JWT기반 Access Token / Refresh Token 인증 체계로 관리자 API를 보호합니다.bcrypt비밀번호 암호화를 적용합니다. - Swagger API 문서:
@nestjs/swagger를 통해 자동 생성되는 API 문서를 제공하여 프론트엔드 개발자와의 협업을 지원합니다.
