> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/dev-guide/pjt-prepare/undefined/undefined-2.md).

# 어플리케이션 구성 설계

## Application 프로젝트

<figure><img src="/files/wzbLnQMpeqMQsoWvOH2U" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="191.77783203125"></th><th></th></tr></thead><tbody><tr><td><strong>리소스 구성</strong></td><td><strong>정보</strong></td></tr><tr><td><strong>x2bee-common</strong></td><td>- 자바 프로젝트에 공통으로 사용될 framework 관련 모듈, spring boot 기본 설정으로 제공하지 못하는 기능을 제공<br>- jar 모듈</td></tr><tr><td><strong>x2bee-api</strong></td><td>- Rest API 제공 서비스<br>- Springboot, Rest API<br>- x2bee-api-member : 회원, 로그인 서비스<br>- x2bee-api-order : 주문 및 클레임 처리 서비스<br>- x2bee-api-goods : 상품 서비스<br>- x2bee-api-display : 전시 서비스<br>- x2bee-api-event : 이벤트 서비스<br>- x2bee-api-common : 사용자, 협력사, 시스템 공통 서비스</td></tr><tr><td><strong>x2bee-gw</strong></td><td>- front API Gateway, 사용자 인증 서비스<br>- Springboot, Spring Cloud Gateway</td></tr><tr><td><strong>x2bee-bo</strong></td><td>- 관리자를 위한 화면 제공 서비스<br>- Springboot, Next.js</td></tr><tr><td><strong>x2bee-cc</strong></td><td>- 고객센터를 위한 화면 제공 서비스.<br>- Springboot, Next.js</td></tr><tr><td><strong>x2bee-batch-mbod</strong></td><td>- 회원, 주문(클레임) batch 서버<br>- Springbatch</td></tr><tr><td><strong>x2bee-batch-gddp</strong></td><td>- 상품, 전시 batch 서버<br>- Springbatch</td></tr></tbody></table>

## \[고객사약어]-GW

<figure><img src="/files/nHC8mLxAotv5Hwzv3LHs" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="140.666748046875"></th><th></th></tr></thead><tbody><tr><td><strong>리소스 구성</strong></td><td><strong>정보</strong></td></tr><tr><td><strong>Node.js</strong></td><td>- Next.js 의 Server Side Rendering 서버.</td></tr><tr><td><strong>FO Gateway Layer</strong></td><td>- Spring Cloud Gateway로 구현. Rest API Url에 따라 Predicate, Filter 기능 제공<br>- Tomcat서버가 내장되어 내부 MSA 서비스 호출</td></tr></tbody></table>

## \[고객사약어]-BO, CC

<figure><img src="/files/oWXHY2CJPepKH4JpwWrn" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="176.22216796875"></th><th></th></tr></thead><tbody><tr><td><strong>리소스 구성</strong></td><td><strong>정보</strong></td></tr><tr><td><strong>Presentation Layer</strong></td><td>- Server Side Rendering을 지원하는 React.js 기반 Next.js를 사용하여 웹 서비스 구현<br>- HTML5/CSS3 표준을 준수</td></tr><tr><td><strong>Controller Layer</strong></td><td>- URL과 매핑된 메소드를 통해 Model과 View의 연결 수행<br>- 요청에 대한 Validation 처리및 Business Logic 수행 시의 Exception의 처리(Error 메시지 처리 Logic)</td></tr><tr><td><strong>Service Layer</strong></td><td>- 회원/로그인, 주문/클레임, 상품, 전시/검색, 시스템공통, 이벤트 등의 업무 수행 시 필요한 비즈니스를 통합한 하나의 서비스로 구성<br>- WebClient를 이용하여 MAS Service를 호출하여 비즈니스 처리를 수행</td></tr><tr><td><strong>x2bee-common</strong></td><td>- 다국어 서비스 등을 포함한 채널 관리, 접근 관리 등 사이트 전방에 적용되는 공통 기능 유틸리티</td></tr></tbody></table>

## \[고객사약어]-Api-\*

<figure><img src="/files/IgCzz7viyel3jfvDn5Q7" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="197.333251953125"></th><th></th></tr></thead><tbody><tr><td><strong>리소스 구성</strong></td><td><strong>정보</strong></td></tr><tr><td><strong>Presentation Layer</strong></td><td>- Json Format의 Restful API Service</td></tr><tr><td><strong>Controller Layer</strong></td><td>- URL과 매핑된 메소드를 통해 Model과 View의 연결 수행<br>- 요청에 대한 Validation 처리 및 Business Logic 수행 시의 Exception의 처리(Error 메시지 처리 Logic)</td></tr><tr><td><strong>Service Layer</strong></td><td>- 각각의 회원/로그인, 주문/클레임, 상품, 전시/검색, 시스템공통, 이벤트 업무 서비스<br>- 요청된 업무를 각 비즈니스 서비스 영역별로 수행을 요청하여 처리한 후 처리 결과를 Controller에 반환</td></tr><tr><td><strong>Data Access Layer</strong></td><td>- 서비스 오브젝트와 DBMS 간의 매핑을 담당하는 영역<br>- Persistence 처리 로직 구현<br>- 각각 용도에 따라 ReadWrite 또는 ReadOnly 커넥션 사용</td></tr><tr><td><strong>x2bee-common</strong></td><td>- 다국어 서비스 등을 포함한 채널 관리, 접근 관리 등 사이트 전방에 적용되는 공통 기능 유틸리티</td></tr></tbody></table>

###


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://tech.x2bee.com/dev-guide/pjt-prepare/undefined/undefined-2.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.