본 문서에서는 개발자 개발 환경 설정 방법에 대하여 기술합니다.
아래에서 로컬 개발환경 기본구조를 설명하고, 로컬개발환경 세팅 방법을 설명합니다.
로컬 개발환경
구분 | 내용 | 비고 |
|---|---|---|
IDE Tool | IntelliJ IDEA 2024.1.2 | 최신 버전 이용 |
Visual Studio Code 1.88 89 | 최신 버전 이용 | |
Eclipse 2024‑03 | 최신 버전 이용 | |
JDK 버전 | OpenJDK 17.0.10.8.1 (LTS) | 17 버전 중 최신 버전 이용 |
Node 버전 | Node.js 20.12.1 (LTS) | 20 버전 중 최신 버전 이용 |
형상관리 | GitLab | |
WAS | Apache Tomcat 10.1.1924 | Java Servlet Container |
DBMS | PostgreSQL 15.3 |
주요 프레임워크(Framework)
Spring Framework
spring-boot 3.23.41
spring-core 6.1.510
spring-data-jpa 3.23.41
tomcat-embed-core 10.1.19 25 (exclusion)
Spring Cloud Framework
spring-cloud 2023.0.02
spring-cloud-aws 3.1.1
NestJS Framework
nestjs 10.3.79
elasticsearch opensearch 2.10.0.1
typeorm 0.3.20
pg 8.11.5
Next.js Framework
next 14.12.43
next-intl 3.1114.1
react 18.23.01
react-query 5.2940.0
zustand 4.5.2
Spring Framework 주요 라이브러리 (Library)
구분 | 내용 | 비고 |
|---|---|---|
Logging | logback 1.45.146 | |
Database |
| |
Query 및 ORM | querydsl 5.1.0 | |
Cache | ehcache 3.10.8 | |
인증 및 보안 | jjwt 0.12.5 6 | |
Excel 처리 | poi 5.2.5 | |
JSON 처리 (Jackson) |
| |
Apache Utils |
| |
편의성 라이브러리 | Lombok 1.18.32 | |
API 문서화 | Springdoc 2.45.0 - Swagger3.0 |
NestJS Framework 주요 라이브러리 (Library)
구분 | 내용 | 비고 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
Logging | logback 1winston 3.413.140 | |||||||||||
Database |
| |||||||||||
Query 및 ORM | querydsl 5typeorm 0.13.0 20 | |||||||||||
Cache | ehcache 3.10.8 cache-manager 5.5.3 | |||||||||||
인증 및 보안 | jjwt 0.12.5 | Excel 처리 | poi 5.2.5 | JSON 처리 (Jackson) |
| Apache Utils |
| 편의성 라이브러리 | Lombok 1.18.32 | API 문서화 | Springdoc 2.4.0 nestjs/jwt 10.2.0 | |
통신 처리 | axios 1.7.2 | |||||||||||
검색엔진Database | opensearch 2.10.0 | |||||||||||
인메모리 Database | ioredis 5.4.1 | |||||||||||
API 문서화 | nestjs/swagger 7.3.1 - Swagger3.0 |
Next.js Framework 주요 라이브러리 (Library)
구분 | 내용 | 비고 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Logging 상태관리 | logback 1.zustand 4.14 | Database | API 문서화 | mybatis 3. 5. 15HikariCP 5.0.1 PostgreSQL 42.6.2 | Query 및 ORM | querydsl 5.1.0 | Cache | ehcache 3.10.8 | 인증 및 보안 | jjwt 0.12.5 | Excel 처리 | poi 5.2.5 | JSON 처리 (Jackson) |
| Apache Utils |
| 편의성 라이브러리 | Lombok 1.18.32 | Springdoc 2.4.0 - Swagger3.02 | |
데이터 조회 캐싱 | react-query 5.40.0 | |||||||||||||||||||
다국어 처리 | next-intl 3.14.1 | |||||||||||||||||||
반응형 슬라이드쇼 처리 | swiper 11.1.3 | |||||||||||||||||||
CSS | tailwindcss 3.4.3 |
로컬 개발환경 세팅
프로젝트 개발을 시작하기 위해 필요한 개발 도구 정보를 참고하여 설치해주세요.
구분 | 도구 | 다운로드 |
|---|---|---|
개발 | 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 | 관리자 사이트 Spring Thymeleaf 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”을 실행합니다.
전체 프로젝트 또는 개별 프로젝트를 선택하고 "Reload project"를 실행하여 Maven에서 의존성을 재설정 및 다운로드합니다.
| Rw ui textbox macro | ||
|---|---|---|
| ||
의존성 설정에 문제가 있어 충돌이 발생하면 메뉴에서 "Clean"을 선택하여 초기화한 후 다시 "Reload"합니다. |
실행할 프로젝트의 기동 파일을 선택하고 "Run" 또는 "Debug"를 선택하여 해당 프로젝트를 실행합니다.
IntelliJ IDEA 설정 및 FO APP 실행하기
IntelliJ를 설치하고 실행합니다.
Git에서 소스코드를 복제하기 위해 “Git-Clone”을 실행합니다.
package.json을 선택하고 "Run ‘npm install’"를 실행하여 npm에서 의존성을 재설정 및 다운로드합니다.
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"를 선택하여 해당 프로젝트를 실행합니다.