로컬 개발 환경 설정하기

본 문서에서는 개발자 개발 환경 설정 방법에 대하여 기술합니다.

아래에서 로컬 개발환경 기본구조를 설명하고, 로컬개발환경 세팅 방법을 설명합니다.

---

로컬 개발환경

구분	내용	비고
IDE Tool	IntelliJ IDEA 2024.1.2 Visual Studio Code 1.89 Eclipse 2024‑03	최신 버전 이용
JDK 버전	OpenJDK 21 (LTS)
Node 버전	Node.js 24.11 (LTS)
형상관리	GitLab
WAS	Apache Tomcat 10.1.24	Java Servlet Container
DBMS	PostgreSQL 15.3

주요 프레임워크(Framework)

• Spring Framework

  • spring-boot 3.5.6

  • spring-core 6.1.10

  • spring-data-jpa 3.3.1

  • tomcat-embed-core 10.1.25 (exclusion)

• Spring Cloud Framework

  • spring-cloud 2023.0.2

  • spring-cloud-aws 3.1.1

• NestJS Framework

  • nestjs 10.3.9

  • opensearch 2.10.0

  • typeorm 0.3.20

  • pg 8.11.5

• Next.js Framework

  • next 16.0.1

  • next-intl 4.4.0

  • react 19.2.0

  • react-query 5.40.0

  • zustand 5.0.3

Spring Framework 주요 라이브러리 (Library)

구분	내용	비고
Logging	logback 1.5.6
Database	mybatis 3.5.19 HikariCP 5.0.1 PostgreSQL 42.7.3
Query 및 ORM	querydsl 7.0
Cache	ehcache 3.11.1
인증 및 보안	jjwt 0.12.6
Excel 처리	poi 5.2.5
JSON 처리 (Jackson)	jackson-core 2.17.1 jackson-databind 2.17.1
Apache Utils	commons-lang3 (3.14.0) commons-text 1.12.0 commons-io 2.16.1 commons-codec 1.17.0 commons-beanutils 1.9.4
편의성 라이브러리	Lombok 1.18.42
API 문서화	Springdoc 2.8.13 - Swagger3.0

NestJS Framework 주요 라이브러리 (Library)

구분	내용	비고
Logging	winston 3.13.0
Database	mybatis-mapper 0.8.0 pg 8.11.5
Query 및 ORM	typeorm 0.3.20
Cache	cache-manager 5.5.3
인증 및 보안	@nestjs/jwt 10.2.0
통신 처리	axios 1.7.7
검색엔진Database	opensearch 2.10.0
인메모리 Database	ioredis 5.4.1
API 문서화	nestjs/swagger 7.3.1 - Swagger3.0

Next.js Framework 주요 라이브러리 (Library)

구분	내용	비고
상태관리	zustand 4.5.2
데이터 조회 캐싱	react-query 5.40.0
다국어 처리	next-intl 4.4.0
반응형 슬라이드쇼 처리	swiper 11.1.14
CSS	tailwindcss 4.1.16

로컬 개발환경 세팅

프로젝트 개발을 시작하기 위해 필요한 개발 도구 정보를 참고하여 설치해주세요.

구분	도구	다운로드
개발	IntelliJ IDEA	다운로드 바로가기 >
	Visual Studio Code	다운로드 바로가기 >
	Eclipse	다운로드 바로가기 >
필수	git (Git Client 사용 가능)	다운로드 바로가기>
	SourceTree	다운로드 바로가기>
	DBeaver	다운로드 바로가기>
	Open Jdk 17 (타사 Opeb jdk 가능)	다운로드 바로가기>
	Node.js 20	다운로드 바로가기>

• 프로젝트 목록

프로젝트명	설명
x2bee-common	Spring 공통 기능 제공 프로젝트
x2bee-gw	Spring Cloud Gateway 프로젝트
x2bee-bo	관리자 사이트 Next.js Front End 프로젝트
x2bee-api-bo	관리자 API Spring 프로젝트
x2bee-api-common	공통 API 및 외부 인터페이스 API Spring 프로젝트
x2bee-api-display	전시 API Spring 프로젝트
x2bee-api-event	이벤트 API Spring 프로젝트
x2bee-api-goods	상품 API Spring 프로젝트
x2bee-api-order	주문 API Spring 프로젝트
x2bee-api-member	회원 API Spring 프로젝트
x2bee-batch-gddp	전시, 상품 Spring Batch 프로젝트
x2bee-batch-mbod	회원, 주문 Spring Batch 프로젝트
x2bee-nest-search	검색엔진 프로젝트
x2bee-fo	사용자 사이트 Next.js Front End 프로젝트

---

IntelliJ IDEA 설정 및 APP 실행하기

IntelliJ를 설치하고 실행합니다.

Git에서 소스코드를 복제하기 위해 “Git-Clone”을 실행합니다.

1

설치 및 실행

IntelliJ를 설치하고 실행합니다.

이미 설치되어 있다면 최신 버전으로 업데이트하세요.

2

Git에서 소스 복제

1. IntelliJ에서 "Git-Clone" 기능을 사용하여 저장소를 복제합니다.

2. 복제한 전체 프로젝트 또는 개별 프로젝트를 선택합니다.

3

의존성 리로드

프로젝트 선택 후 "Reload project"를 실행하여 Maven(또는 해당 빌드 툴)에서 의존성을 재설정 및 다운로드합니다.

IntelliJ IDEA 설정 및 FO APP 실행하기

image-20240408-073437.png

IntelliJ를 설치하고 실행합니다.

Git에서 소스코드를 복제하기 위해 “Git-Clone”을 실행합니다.

image-20240408-072154.png

package.json을 선택하고 "Run ‘npm install’"를 실행하여 npm에서 의존성을 재설정 및 다운로드합니다.

image-20240408-072858.png

npm 실행 목록에서 "start:local"을 선택하여 해당 프로젝트를 실행합니다.

---

Visual Studio Code 설정 및 APP 실행하기

Visual Studio Code를 설치하고 실행합니다.

소스 코드를 복제하기 위해 "Source Control" 탭에서 "Clone Repository"를 실행합니다.

"Extensions" 탭에서 "java"를 검색하여 "Extension Pack for Java" 및 "Spring Boot Extension Pack"을 설치합니다.

해당 프로젝트의 실행 파일을 선택하고 “Run” 또는 “Debug”를 선택하여 해당 프로젝트를 실행합니다.

---

Eclipse 설정 및 APP 실행하기

Eclipse를 설치하고 실행합니다.

"Open Perspective" 창에서 "Clone a Git repository"를 실행하여 Git Repository에서 소스 코드를 로컬 디렉토리에 복제합니다.

Lombok 다운로드에서 "lombok.jar" 파일을 Eclipse 설치 경로에 다운로드합니다. 그 후, 설치된 폴더의 "eclipse.ini" 파일을 열어 "-javaagent:C:\설치경로\jee-2023-06\eclipse\lombok.jar"를 추가합니다.

실행할 프로젝트의 기동 파일을 선택하고 "Run" 또는 "Debug"를 선택하여 해당 프로젝트를 실행합니다.