Spring Boot 업무 API

SPEC

기술 스펙

서버

• Java 17
• Spring Boot
• MyBatis

데이터

• PostgreSQL

FIT

이런 프로젝트에 맞습니다

• 화면과 외부 시스템이 같은 업무 데이터를 함께 써야 하는 경우
• 기존 API가 권한·예외 처리 기준 없이 늘어난 경우
• 연동 규격을 문서로 넘겨야 하는 경우

PREBUILT

예시로 살펴볼 구성

아래는 예시에서 다루는 구성입니다. 실제 템플릿의 기능과 제공 범위는 제작·검증을 거쳐 확정할 예정입니다.

인증·권한 계층

로그인, 토큰 검증, 역할별 접근 제어가 동작하는 상태로 준비되어 있습니다.

표준 응답·예외 형식

성공·실패 응답 형식과 오류 코드 체계가 정해져 있어 화면 쪽 처리 기준이 흔들리지 않습니다.

목록·상세·등록 기본 구조

조회, 상세, 등록·수정·삭제와 페이징·정렬이 같은 규칙으로 동작합니다.

API 문서 자동 생성

코드에서 연동 규격 문서를 뽑아내는 설정이 들어 있어 문서를 따로 관리하지 않습니다.

프로젝트에 맞춰 구성과 디자인을 조정합니다.

SCOPE

포함 범위

제공 범위와 제외 범위를 먼저 정의한 뒤 진행합니다. 일정과 세부 조건은 협의 후 SOW에서 확정합니다.

FAQ

자주 묻는 질문

기존 데이터베이스 구조를 그대로 써야 하나요?

기존 구조를 우선 사용합니다. 변경이 필요하면 영향 범위를 먼저 확인하고 SOW에 반영합니다.

Java 버전이나 프레임워크 버전을 지정할 수 있나요?

운영 환경에 맞춰 지정할 수 있습니다. 지정한 버전은 SOW의 기술환경 항목에 기록합니다.