구민주 sprint 5 by minjukoo · Pull Request #111 · codeit-bootcamp-spring/9-sprint-mission

minjukoo · 2026-03-01T16:51:25Z

Discodeit Backend Project - Mission 5

1. 요구사항

기본 항목

RESTful API 재설계: 기존 미션에서 구현한 API를 RESTful 원칙에 맞게 재설계하고, 제공된 API 스펙과의 정합성을 확보했습니다.
Postman 컨트롤러 테스트: 설계한 API의 모든 엔드포인트에 대해 유효성 검증을 수행하고, 테스트 결과물을 Export하여 공유 가능하도록 준비했습니다.
Swagger API 문서화: Springdoc-openapi를 도입하여 Swagger 기반의 인터랙티브 API 문서를 자동 생성하고 Swagger-UI를 통해 런타임 테스트를 수행했습니다.

심화 항목

정적 리소스 서빙 및 프론트엔드 통합: 백엔드 서버에서 정적 리소스(HTML/JS/CSS)를 서빙하도록 설정하여 프론트엔드-백엔드 간의 통합 연동을 완수했습니다.
Railway.app 클라우드 배포: GitHub 레포지토리와 Railway.app을 연동하여 CI/CD 환경을 구축하고, 자동 생성된 도메인을 통해 실서비스 환경에서 동작을 검증했습니다.
서버 URL: https://9-sprint-mission-production-e541.up.railway.app
멀티파트 파일 핸들링: MultipartFile 인터페이스를 활용하여 메시지 전송 시 파일 첨부 및 서버 로컬 저장 기능을 구현했습니다.
채널 타입별 비즈니스 로직 분리: PUBLIC/PRIVATE 채널 성격에 따른 생성 및 조회 권한 로직을 분리하여 구현했습니다.

2. 주요 변경사항

전역 예외 처리 시스템 구축: 각 컨트롤러에 파편화되어 있던 예외 처리 로직을 @RestControllerAdvice를 통해 중앙 집약적으로 관리하도록 변경했습니다.
RESTful 엔드포인트 최적화: @RequestMapping을 활용하여 HTTP 메서드와 경로를 명시적으로 매핑함으로써 API의 직관성을 높였습니다.
이진 데이터처리 로직 고도화: 파일 조회 API를 구현하여 특정 식별자(binaryContentId)를 통해 서버 내 정적 리소스에 접근할 수 있는 인터페이스를 마련했습니다.
DTO를 통한 데이터 캡슐화: UserDto와 같은 전용 데이터 객체를 도입하여 비즈니스 엔티티가 직접 외부로 노출되는 것을 방지했습니다.
멀티파트 및 연관 관계 매핑: 메시지 전송 시 JSON 명세와 MultipartFile을 동시에 수용하는 구조를 구축했습니다. UUID 식별자를 포인터처럼 활용하여 작성자, 채널, 메시지 간의 논리적 연결 고리를 생성하고 데이터의 무결성을 유지했습니다.

3. API 테스트 가이드 (Postman)

본 프로젝트의 모든 API 기능 및 테스트 시나리오는 제공된 Postman 컬렉션 파일을 통해 확인할 수 있습니다.

파일 위치: discodeit/postman/mission5.postman_collection.json
테스트 시나리오
1. 유저 가입 및 로그인
2. 공개 채널 생성
3. 각 유저별 파일 첨부를 포함한 메시지 전송
4. 채널 ID 기반의 전체 메시지 목록 조회

4. 멘토님께 드리는 질문

질문 1: 현재 메시지 파일을 서버의 로컬 디렉토리에 직접 저장하고 있습니다. 실무에서 트래픽이 증가하여 서버 인스턴스가 여러 대로 늘어날 경우, 로컬 저장 방식이 가지는 한계와 이를 해결하기 위한 조언을 구하고 싶습니다.
질문 2: 메시지 조회 시 채널 ID를 Query Parameter로 전달받아 필터링하고 있습니다. 데이터가 방대해질 경우 단순 필터링은 성능 저하가 발생할 텐데, 실무에서는 인덱스 설계나 페이징 처리를 어떤 방식으로 운영하여 성능을 최적화하는지 궁금합니다.

… mission-5

joonfluence

전체 요약

Spring Boot 기반 Discodeit 백엔드를 RESTful API로 재설계한 PR입니다. Controller-Service-Repository 계층 분리, DTO 도입, Swagger 문서화, 전역 예외 처리 등 전반적으로 잘 구성되어 있습니다.

특히 Controller-Api 인터페이스 분리 패턴, @RestControllerAdvice 전역 예외 처리, @ConditionalOnProperty를 활용한 Repository 전략 패턴 등이 인상적입니다.

아래 코멘트들을 참고해주세요.

P2: 2건 (적극적으로 고려해주세요)
P3: 4건 (웬만하면 반영해 주세요)
P4: 2건 (반영해도 좋고 넘어가도 좋습니다)

joonfluence · 2026-03-03T17:44:46Z

discodeit/src/main/java/com/sprint/mission/discodeit/service/basic/BasicAuthService.java

+    User user = userRepository.findByUsername(request.getUsername())
+        .orElseThrow(() -> new NoSuchElementException(
+            "User with username " + request.getUsername() + " not found"));
+    if (!user.getPassword().equals(request.getPassword())) {


[P2] 비밀번호를 평문(plain text)으로 저장하고 equals()로 직접 비교하고 있습니다.

학습 프로젝트라 하더라도 BCryptPasswordEncoder 같은 해시 기반 비교를 사용하는 습관을 들이는 것이 좋습니다. 평문 비밀번호가 직렬화된 파일이나 로그에 노출될 위험이 있습니다.

Suggested change

if (!user.getPassword().equals(request.getPassword())) {

if (!passwordEncoder.matches(request.getPassword(), user.getPassword())) {

(PasswordEncoder를 주입받고, 회원가입 시 passwordEncoder.encode()로 저장하는 로직도 함께 필요합니다)

joonfluence · 2026-03-03T17:44:47Z

discodeit/src/main/java/com/sprint/mission/discodeit/controller/ChannelController.java

+public class ChannelController implements ChannelApi {
+
+  private final ChannelService channelService;
+  private final MessageRepository messageRepository;


[P2] Controller가 MessageRepository를 직접 주입받아 마지막 메시지 시간을 조회하고 있습니다.

이는 계층 구조(Controller → Service → Repository)를 위반합니다. ChannelService 또는 MessageService에 마지막 메시지 시간 조회 로직을 위임하고, Controller에서는 Service만 의존하도록 수정하는 것이 바람직합니다.

Suggested change

private final MessageRepository messageRepository;

// private final MessageRepository messageRepository; // Repository 직접 의존 제거

joonfluence · 2026-03-03T17:44:47Z

discodeit/src/main/java/com/sprint/mission/discodeit/controller/BinaryContentController.java

+        .orElse(ResponseEntity.notFound().build());
+  }
+
+  private BinaryContentResponse convertToResponse(BinaryContent content) {


[P3] BinaryContentResponse에 byte[]가 포함되어 있어 JSON 응답 시 Base64로 직렬화됩니다.

파일 크기가 커지면 메모리 사용량과 응답 크기가 급증합니다. 메타데이터 조회 API에서는 바이트 데이터를 제외하고, 파일 다운로드는 별도의 스트리밍 엔드포인트(StreamingResponseBody 또는 Resource)로 제공하는 것을 권장합니다.

joonfluence · 2026-03-03T17:44:47Z

discodeit/src/main/java/com/sprint/mission/discodeit/controller/GlobalExceptionHandler.java

+
+  @ExceptionHandler(Exception.class)
+  public ResponseEntity<String> handleAll(Exception e) {
+    e.printStackTrace();


[P3] e.printStackTrace()는 stdout으로 출력되어 로그 수집 도구에서 누락될 수 있습니다. SLF4J 로거를 사용해주세요.

Suggested change

e.printStackTrace();

log.error("서버 내부 오류 발생", e);

(클래스에 @Slf4j 어노테이션 또는 private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class); 추가 필요)

joonfluence · 2026-03-03T17:44:47Z

discodeit/src/main/java/com/sprint/mission/discodeit/controller/AuthController.java

+  private final UserStatusService userStatusService;
+
+  @Override
+  public ResponseEntity<UserDto> login(@Valid @RequestBody LoginRequest request,


[P3] AuthController와 UserController에 동일한 convertToDto(User) 메서드가 중복되어 있습니다.

변환 로직이 변경되면 양쪽 모두 수정해야 하므로, 별도의 UserMapper 클래스로 추출하거나 서비스 계층에서 DTO 변환을 담당하도록 하면 유지보수성이 높아집니다.

joonfluence · 2026-03-03T17:44:47Z

discodeit/src/main/java/com/sprint/mission/discodeit/entity/Message.java

+    this.authorId = authorId;
+    this.channelId = channelId;
+    if (attachmentIds != null) {
+      this.attachmentIds = attachmentIds;


[P3] Message.update() 내부에서 recordUpdate()를 호출하지 않고 있습니다.

현재는 BasicMessageService.update()에서 별도로 recordUpdate()를 호출하고 있지만, Channel.update()는 엔티티 내부에서 recordUpdate()를 호출하는 등 패턴이 일관되지 않습니다.

엔티티의 상태 변경 메서드 내부에서 타임스탬프 갱신을 통일하면 실수를 줄일 수 있습니다.

Suggested change

this.attachmentIds = attachmentIds;

public void update(String content) {

if (content == null || content.isBlank()) {

throw new IllegalArgumentException("메시지 내용은 비어있을 수 없습니다.");

}

this.content = content;

recordUpdate();

}

joonfluence · 2026-03-03T17:44:47Z

discodeit/src/main/java/com/sprint/mission/discodeit/controller/UserApi.java

+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+import jakarta.servlet.http.HttpSession;


[P4] jakarta.servlet.http.HttpSession import가 7번째 줄과 중복됩니다. 하나를 제거해주세요.

joonfluence · 2026-03-03T17:44:47Z

discodeit/src/main/java/com/sprint/mission/discodeit/dto/UserCreateRequest.java

+@AllArgsConstructor
+public class UserCreateRequest {
+
+  private String username;


[P4] PublicChannelCreateRequest에는 @NotBlank가 적용되어 있지만, UserCreateRequest에는 username, email, password 등 필수 필드에 대한 validation 어노테이션이 없습니다.

회원가입 시 빈 값이 들어올 수 있으므로 @NotBlank, @Email 등을 추가하면 좋겠습니다.

minjukoo and others added 17 commits January 27, 2026 19:00

feat: Spring Boot 전환 및 의존성 주입(DI) 완료

acd8620

feat: Spring Boot 및 DI 엔진 교체 완료

8b7f07b

feat: 유저 서비스 및 리포지토리 고도화 완료

06bd8cc

추가 기능 요구 사항

c161195

feat: Sprint 3 Spring 마이그레이션 및 상태 관리 로직 구현 완료

7ad78a1

Sprint 4 완료

1a7d32c

feat: 베이스 코드와 같은 방향으로 수정1

88ee210

feat: 스프린트 5 완료 - 세션 인증, 멀티파트 업로드 및 프론트엔드 통합

8a24912

그래들 재설정

3da6ef3

fix: 배포 환경용 포트 설정 및 파일 리포지토리 활성화

7472ded

fix: gradlew 실행 권한 추가

35f6f75

fix: WebConfig CORS allowedOrigins에 Railway 도메인 추가

ed7b112

fix: update CORS origin patterns and static resource handlers

7d5a227

fix: WebConfig CORS 및 정적 리소스 경로 수정

266c662

docs: add postman collection for mission 5

4580d01

Create README.md

1cd6786

Merge branch 'mission-5' of github.com:minjukoo/9-sprint-mission into…

c607489

… mission-5

minjukoo changed the title ~~Mission 5~~ 구민주 Mission 5 Mar 1, 2026

minjukoo added 3 commits March 2, 2026 01:56

chore: remove unnecessary ide configuration files from tracking

9d367bc

chore: untrack unnecessary configuration files

f11ce90

chore: remove files using correct gitignore

2ac8777

joonfluence suggested changes Mar 3, 2026

View reviewed changes

minjukoo changed the title ~~구민주 Mission 5~~ 구민주 sprint 5 Mar 5, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

구민주 sprint 5#111

구민주 sprint 5#111
minjukoo wants to merge 20 commits intocodeit-bootcamp-spring:구민주from
minjukoo:mission-5

minjukoo commented Mar 1, 2026 •

edited

Loading

Uh oh!

joonfluence left a comment

Uh oh!

joonfluence Mar 3, 2026

Uh oh!

joonfluence Mar 3, 2026

Uh oh!

joonfluence Mar 3, 2026

Uh oh!

joonfluence Mar 3, 2026

Uh oh!

joonfluence Mar 3, 2026

Uh oh!

joonfluence Mar 3, 2026

Uh oh!

joonfluence Mar 3, 2026

Uh oh!

joonfluence Mar 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	if (!user.getPassword().equals(request.getPassword())) {
	if (!passwordEncoder.matches(request.getPassword(), user.getPassword())) {

	private final MessageRepository messageRepository;
	// private final MessageRepository messageRepository; // Repository 직접 의존 제거

	e.printStackTrace();
	log.error("서버 내부 오류 발생", e);

-      this.attachmentIds = attachmentIds;
+  public void update(String content) {
+    if (content == null || content.isBlank()) {
+      throw new IllegalArgumentException("메시지 내용은 비어있을 수 없습니다.");
+    }
+    this.content = content;
+    recordUpdate();
+  }

Conversation

minjukoo commented Mar 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Discodeit Backend Project - Mission 5

1. 요구사항

기본 항목

심화 항목

2. 주요 변경사항

3. API 테스트 가이드 (Postman)

4. 멘토님께 드리는 질문

Uh oh!

joonfluence left a comment

Choose a reason for hiding this comment

전체 요약

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

minjukoo commented Mar 1, 2026 •

edited

Loading