📋 목차

1. 서버 설정 및 실행
2. 기본 환경 설정
3. API 엔드포인트 상세
4. 프론트엔드 연동 설정
5. 데이터베이스 관리 명령어
6. 실제 응답 데이터 예시
7. 에러 처리
8. Postman 테스트 가이드

1. 서버 설정 및 실행

📦 설치 및 초기 설정

# 1. 의존성 설치
npm install

# 2. 환경 변수 설정 (.env 파일 확인)
# 포트, MongoDB URI, JWT 시크릿 등 설정

# 3. 데이터베이스 초기화 (샘플 데이터 포함)
npm run setup << 사용 주의

# 4. 서버 실행
npm run dev  # 개발 모드
npm start    # 프로덕션 모드

🔧 주요 스크립트 명령어

# 서버 실행
npm run dev              # 개발 서버 (nodemon 사용)
npm start               # 프로덕션 서버

# 데이터베이스 관리
npm run seed            # 요금제 샘플 데이터 생성
npm run seed:questions  # 진단 질문 데이터 생성
npm run setup          # 전체 초기화 (삭제 + 샘플 데이터)
npm run clean          # setup과 동일

# 데이터 삭제 (선택적)
npm run clear          # 전체 데이터 삭제
npm run clear:users    # 사용자 + 보관함 데이터 삭제
npm run clear:plans    # 요금제 + 관련 보관함 삭제
npm run clear:diagnosis # 진단 질문 + 결과 삭제
npm run clear:bookmarks # 보관함만 삭제
npm run clear:results  # 진단 결과만 삭제
npm run clear:test     # 테스트 데이터만 삭제

# 상태 확인
npm run db:status      # 데이터베이스 상태 확인
npm run health         # 서버 헬스체크

2. 기본 환경 설정

환경 변수 (.env)

→ SLACK .env 내용 참조

Axios 설정 (프론트엔드용 - src/utils/api.js)