Munchkin

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 18)

2021 Entry6.0 backend repository

Munchkin Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Entry6.0 LTS

## 구성
### [1. 기획 배경](#기획-배경)
### [2. 구현 방안](#구현-방안)
### [3. 구현](#구현)

## **기획 배경**
### **지난 버전 회고**
Entry5.0을 마치고 진행한 회고에서 애플리케이션의 문제보다는 UX적인 문제점이 많이 지적되었습니다. 실제로 올해 서비스는 99.849%의 성공률을 기록하며 성공적으로 마무리되었으며, 발생했던 치명적인 오류는 없었습니다.

### **문제 인식 및 개선할 점 도출**
1기 선배님들부터 5년동안 시스템을 구축하며 생긴 노하우를 바탕으로 잘 돌아가는 어플리케이션 구축에는 무리가 없지만 유지보수에는 어려움이 있다는 문제가 있었습니다. 따라서 저희는 `유연성`과 `재사용성`을 최우선으로 고려하여 `유지보수`가 가능한 코드를 작성하고자 하였습니다. 궁극적으로 견고한 모노리스 어플리케이션을 구축하여 추후 더 다양한 시도를 할 수 있도록 하는 기반을 다지고자 하였습니다.

### **문제 해결 방안**
유연하고 재사용성 높은 코드를 작성하기 위해 해결 방안을 탐색하던 중 우아한 테크세미나에서 발표된 <우아한 모노리스>의 `모듈형 모노리스` 적용 사례를 접하게 되었습니다. 각 도메인을 모듈로 분리하여 하나의 서비스로 동작하도록 하며 분리된 서비스들을 조립하여 애플리케이션을 구성한다면 문제를 해결할 수 있을 것이라고 판단하였습니다.

## **구현 방안**
### **사례 분석**
완성도 있는 모듈형 모노리스 애플리케이션을 구성하기 위해서 우선 <우아한 모노리스>의 사례를 분석했습니다. <우아한 모노리스>에서는 다음과 같은 전략들을 사용하여 애플리케이션을 분해하였습니다.

- 도메인 지향적 멀티모듈 프로젝트 구성
- 공통적인 관심사는 common 모듈에서 관리
- 구현 세부사항은 private로 외부 접근 방지
- 외부 모듈과는 인터페이스로만 교류
- 의도하지 않은 빈의 공유 방지를 위해 모듈별로 컨텍스트 분리
- 분리된 컨텍스트들은 하나의 루트 컨텍스트를 부모로 가짐
- 의도적으로 공유하고자 하는 인터페이스 빈은 `@Published` 어노테이션을 통해 루트 컨텍스트로 등록하여 간접적으로 공유

분해한 서비스는 하나의 모듈에서 결합되어 사용되므로 서비스간의 결합도를 최소화함에 따른 개발상의 이점과 동시에 서비스의 자유로운 분리/결합으로 인한 운영상의 이점을 모두 취할 수 있었습니다.

### **전략 설계**
<우아한 모노리스>의 사례를 바탕으로 애플리케이션을 구성하기로 하였습니다. 기존 전략은 그대로 가져가도록 하되, 웹 어플리케이션에 맞게 몇 가지 전략을 추가하였습니다.

- 루트 컨텍스트에 등록된 빈(`@Published`어노테이션이 붙은 빈) 중 `@RestController`어노테이션이 붙은 빈은 SERVLET 컨텍스트로 복사하도록 하여 SERVLET 컨텍스트에서 Controller에 라우팅이 가능하도록 하였습니다.

- 컨텍스트 분리와 재결합에 따른 빈 순환 참조 문제를 해결하기 위하여 도메인의 의존 방향을 정의하였으며, 빈 초기화 순서에 따른 문제를 해결하기 위하여 모듈에 우선순위를 부여하여 참조되는 컨텍스트의 빈을 먼저 초기화 하도록 하였습니다.

## **구현**
### **애플리케이션 분해**
우선 도메인 지향적 모듈화를 위해 기획에서 도메인을 도출하고, 각 도메인마다 하나의 모듈을 구축하여 최종적으로 5개의 모듈의 서비스가 상호작용하며 Entry6.0을 구성합니다.

- **지원자** : *입학전형 시스템의 주체이며, 지원 서비스를 통해 원서를 접수합니다.*
- **관리자** : *접수된 원서를 확인하고 상태 서비스를 통해 지원자를 관리합니다.*
- **지원** : *지원자의 원서 정보를 관리합니다.*
- **성적** : *지원자의 성적 정보를 관리합니다.*
- **알람** : *지원자의 상태에 따라 지원자에게 알림을 전송합니다.*

또한 분리된 애플리케이션을 조립하기 위해서 메인 모듈을, 인증이나 로깅과 같은 수직적 관심사를 공통적으로 구축하기 위해서 공통 모듈을 각각 구축하여 서비스간의 결합이 원활하게 이루어질 수 있도록 하였습니다.

### **서비스 모듈 구성**
```
<domain>
    ㄴ src
        ㄴ main
            ㄴ java
                ㄴ kr.hs.entrydsm.<domain>
                    ㄴ presenter
                        ㄴ web
                    ㄴ usecase
                        ㄴ dto
                        ㄴ exception
                    ㄴ domain
                        ㄴ entity
                        ㄴ repository
                    ㄴ infrastructure
                        ㄴ database
                    ㄴ integrate
                        ㄴ <other domains>
                    <domain>ModuleConfiguration.java
                    Enable<domain>Module.java
            ㄴ resources
        ㄴ test
```
- presenter 계층은 애플리케이션의 최외곽 계층으로, 외부와의 상호작용을 담당합니다. 주로 `@RestController` 어노테이션이 붙은 클래스가 위치합니다.
- usecase 계층에서는 애플리케이션의 핵심 비즈니스 로직이 위치합니다. 애플리케이션의 `@Service` 어노테이션이 붙은 클래스와, 해당 클래스의 인터페이스 및 DTO, 로직 처리 중 발생할 수 있는 exception이 위치합니다.
- domain 계층에서는 도메인의 속성과 행위를 정의합니다. `@Entity` 어노테이션이 붙은 클래스와 `@Repository` 어노테이션이 붙은 클래스의 인터페이스가 위치합니다.
- infrastructure 계층에서는 서비스가 운영되는 인프라에 대한 부분을 구성합니다. 현재는 DB 관련 로직만 위치하고 있습니다.
- integrate 계층에서는 모듈과의 상호작용을 위한 로직을 구성합니다. 다른 컨텍스트와의 공유를 필요로 하는 domain이 위치합니다.
- \<domain>ModuleConfiguration 클래스에서는 모듈의 설정사항을 구성하고 컨텍스트에 빈을 등록하는 역할을 수행합니다. 공통 모듈의 ModuleConfiguration 추상 클래스를 상속받아 구현합니다.
- Enable\<domain>Module 어노테이션에서는 \<domain>ModuleConfiguration 클래스를 Import하여 어노테이션화합니다.

### **메인 모듈 구성**
```
main
  ㄴ src
    ㄴ main
      ㄴ java
        ㄴ kr.hs.entrydsm.main
          ㄴ configuration
          ㄴ integration
            ㄴ <domain>
              ㄴ <domain>Integrate<another domain>Service.java
            .
            .
            .
          ㄴ MainApplication
      ㄴ resources
    ㄴ test
```
- configuration 패키지에서는 메인에서 다른 모듈들을 통합할 때에 고려해야 할 전략들을 구현합니다.
- integration 패키지에서는 의존하는 모듈에서 의존받는 모듈로의 통합을 구현합니다.

### **공통 모듈 구성**
```
common
  ㄴ src
    ㄴ main
      ㄴ java
        ㄴ kr.hs.entrydsm.common
          ㄴ context
            ㄴ beans
              ㄴ Published.java
              ㄴ PublishedComponentRegisteringPostProcessor.java
          ㄴ ModuleConfiguration.java
          ㄴ Module.java
      ㄴ resources
    ㄴ test
```
- PublishedComponentRegisteringPostProcessor 클래스에서는 `@Published` 어노테이션이 붙은 컴포넌트를 루트 컨텍스트로 등록시키는 로직을 구현합니다. <우아한 모노리스>에서 공개된 코드를 바탕으로 최적화하여 구현하였습니다.
- ModuleConfiguration 클래스는 서비스 모듈 내에 있는 설정사항 파일의 추상 클래스입니다.

## Coded By 🔥
### EntryDSM
`EntryDSM`은 대덕소프트웨어마이스터고등학교 입학전형 시스템 개발팀으로, 학교 특성상 매 해마다 진행되는 서류 원서 접수와 면접을 통한 신입생 선발 프로세스를 개선하고자 하는 목표를 가지고 다양한 기술을 탐구하며 요구사항과 팀의 상황에 알맞게 해당 기술을 도입하여 매 해마다 `Entry series`를 개발합니다.

### Entry series
`Entry`는 [EntryDSM](###EntryDSM)에서 매 해마다 신입생 원서 접수와 면접을 위해서 개발하는 입학전형 시스템 프로젝트입니다. 원서 접수 기간동안 수 만 건의 요청을 안전하게 처리하는 것을 최우선으로 프로젝트가 진행됩니다.

Munchkin

Munchkin Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Munchkin

Munchkin Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README