1. 작성 목적
본 기록은 CoreERP 프로젝트의 백엔드 개발을 시작하며 진행한 Spring Boot 기반 환경 구성 및 데이터베이스 연결 과정을 정리하기 위한 문서이다.
이 단계의 목표는 기능 구현이 아니라, 향후 도메인 설계를 안정적으로 진행하기 위한 백엔드 실행 환경을 명확히 고정하는 것이었다.
2. 백엔드 기술 스택 선택
2-1. 기술 선정 기준
- Java 17 기반
- Gradle 빌드 시스템
- Spring Boot 3.5.12 (SNAPSHOT)
- JPA 기반 ORM 구조
- MariaDB 연동
CoreERP는 단기 실습용 프로젝트가 아니라, 확장 가능성과 유지보수성을 고려한 ERP 시스템을 목표로 한다. 따라서 엔터프라이즈 환경에서 널리 사용되는 Spring Boot + JPA 구조를 채택하였다.
3. 의존성 구성
계층 분리를 전제로 다음 의존성을 추가하였다.
- spring-boot-starter-web
- spring-boot-starter-data-jpa
- mariadb-java-client
- lombok
이를 통해 다음과 같은 구조를 전제로 한다.
Controller → Service → Repository → JPA → Database
웹 계층과 데이터 계층을 동시에 구성하여, 이후 도메인 설계 단계로 자연스럽게 확장할 수 있도록 준비하였다.
4. application 설정
데이터베이스 연결을 위한 기본 설정을 구성하였다.
spring: datasource: url: jdbc:mariadb://localhost:3310/coreerp username: root password: ******** driver-class-name: org.mariadb.jdbc.Driver jpa: hibernate: ddl-auto: update show-sql: true
ddl-auto를 update로 설정하여, 엔티티 설계 단계에서 테이블이 자동 생성·수정되도록 준비하였다.
5. DB 연결 검증
Spring Boot 실행 후 정상 기동을 확인하였다.
- Tomcat 정상 실행
- MariaDB 연결 성공
- Hibernate 초기화 로그 확인
- SQL 로그 출력 정상 확인
이 과정은 단순 연결 확인이 아니라, JPA 기반 도메인 설계가 실제 데이터베이스와 정상적으로 연동되는지 사전 검증하는 단계였다.
6. 기반 구축 단계의 의미
백엔드 실행 환경이 안정적으로 고정되었다는 것은, 이후 설계 단계에서 발생할 수 있는 환경 오류를 사전에 제거했다는 의미를 가진다.
CoreERP는 이제 단순 화면 프로젝트를 넘어, 실제 데이터 흐름을 가지는 시스템 구조로 전환되었다.
7. 다음 단계
이후 단계에서는 패키지 구조 정리 및 도메인 설계를 진행하며, ERP의 핵심이 되는 데이터 무결성 구조를 구체화할 예정이다.
