Spring 기반 업무 시스템 — REST API·트랜잭션·인증·권한 관리

프로젝트 개요

업무 API, 데이터 처리, 인증과 권한을 Spring 기반의 공통 개발 구조로 구성하는 업무 시스템입니다.

API 명세와 프론트엔드 타입을 같은 계약에서 만들고, 역할별 기능 권한과 감사 로그, DB 변경 이력을 운영 콘솔에서 관리합니다.

주요 기능

API 계약

• Controller·Service·Repository 역할 분리
• 요청·응답 DTO와 ProblemDetail 공통 오류 응답
• OpenAPI 문서와 프론트엔드 타입 자동 생성

인증·권한

• Spring Security 기반 인증·인가와 세션 처리
• 역할별 메뉴·기능(조회·등록·수정·삭제·승인·내보내기) 권한 매트릭스
• 권한 변경 이력

운영

• 업무 단위 트랜잭션과 데이터 접근 관리
• API 응답시간·처리량·오류율 모니터링
• 감사 로그와 DB 마이그레이션 이력

기술 구성

구현 포인트

• Controller는 요청 변환만 담당하고 업무 규칙은 Service에서 처리
• jOOQ 생성 모델과 OpenAPI 생성 타입으로 DB·서버·화면 사이의 계약을 빌드에서 확인
• DB 구조 변경은 Flyway migration으로 기록해 환경별 스키마 차이 방지
• 권한 검사는 메뉴 노출과 서버 처리 양쪽에서 같은 역할 기준으로 적용

업무에 주는 가치

API 계약이 문서와 타입으로 자동 생성되어 화면과 서버가 서로 다른 필드를 쓰는 오류를 빌드 단계에서 막습니다.

역할별 권한을 매트릭스로 관리해 조직 변경이나 신규 업무 추가 시 권한 설정을 빠르게 반영합니다.

감사 로그와 마이그레이션 이력이 남아 운영 중 문제를 추적하고 변경 내역을 설명할 수 있습니다.