#49 #50 #51 #52 #53 - 채팅 채널 메시지 기능 구현 (목록 조회·텍스트/파일 전송·기본 채널 시딩)

[yunkihong-dev]

관련 이슈

closes #49 #50 #51 #52 #53

작업 내용

• 채팅 채널 메시지 도메인(Message)·인프라·서비스·API 추가 ([CHAT-001] 채널 목록 조회 #49 채널 목록 조회 위에 이어짐)
• Message 엔티티 추가 — channel/sender FK, content(TEXT), MessageType(TEXT/FILE), createdAt
• MessageRepository(페이징) 도메인 인터페이스 + Spring Data/JPA 어댑터(포트-어댑터)
• 메시지 목록 조회 GET /api/v1/channels/{channelId}/messages?page=0&size=50
• 최신순(createdAt DESC) 기본 정렬, MessageResponse[] 반환
• 채널 미존재 시 CHANNEL_NOT_FOUND
• 텍스트 메시지 전송 POST /api/v1/channels/{channelId}/messages (201 Created)
• MessageCreateRequest(content, type), sender = 현재 멤버(@AuthenticationPrincipal)
• type 미지정 시 TEXT로 저장
• 파일 첨부 메시지 전송 — 같은 경로를 multipart/form-data로 분기
• MessageFile 엔티티 + Message.files(@onetomany, cascade) + addFile
• MultipartFile 업로드는 drive 모듈 StorageService(MinIO) 재사용, type=FILE 저장
• 첨부 없으면 MESSAGE_FILE_REQUIRED, MessageResponse에 files(MessageFileResponse[]) 포함
• 기본 채널 자동 생성 — ChannelSeeder(ApplicationRunner)
• 기동 시 General(GENERAL) + 팀별 4개(DEV/DESIGN/MARKETING/PRODUCT, TEAM) 멱등 생성
• 전체 멤버를 General 채널에 참여 (멱등)
• ChannelMember 엔티티 + 리포지토리, ChannelRepository.findByName 추가
• Flyway 마이그레이션 추가
• V25__create_message.sql (channel/sender FK, (channel_id, created_at) 인덱스)
• V26__create_message_file.sql (message FK, message_id 인덱스)
• V27__create_channel_member.sql (channel/member 유니크 제약)
• ErrorCode에 CHANNEL_NOT_FOUND, MESSAGE_FILE_REQUIRED 추가

체크리스트

• 테스트 작성 (Red)
• 기능 구현 (Green)
• 리팩터링 완료
• 테스트 전체 통과

정책 결정

• 마이그레이션 버전: 이슈에는 V10__create_channel.sql로 명시됐으나 V10이 이미 선점되어 채널 테이블([CHAT-001] 채널 목록 조회 #49)은 V24, 메시지/파일/멤버는 V25~V27로 작성
• 메시지 응답은 페이지 메타데이터(totalElements 등) 없이 MessageResponse[]만 반환 — 이슈 명세 및 프론트 배열 계약에 맞춤
• 텍스트/파일 전송은 동일 엔드포인트를 content-type으로 분기(JSON vs multipart) — 프론트의 type 기반 호출과 호환
• 파일 저장은 신규 스토리지 추상화를 만들지 않고 drive 모듈의 MinIO StorageService 빈을 재사용
• 기본 채널 시딩은 별도 데이터 마이그레이션 대신 ApplicationRunner로 처리하고, findByName/existsByChannelIdAndMemberId로 멱등 보장

체크리스트

• 테스트 작성 (Red)
• 기능 구현 (Green)
• DB 마이그레이션 추가
• 대상 테스트 통과
• 전체 테스트 통과

검증

• ./gradlew test --tests "com.yanus.attendance.chat.*" — chat 모듈 단위 테스트(ChannelService/MessageService/ChannelSeeder) 통과
• ./gradlew compileJava compileTestJava — 이슈 단계별 컴파일 통과
• ./gradlew test — 전체 테스트 BUILD SUCCESSFUL (AttendanceApplicationTests.contextLoads() 포함, 신규 엔티티 4종 + ChannelSeeder 기동을 Testcontainers 스키마에서 검증)
• 프론트 영향
• 채널 목록: GET /api/v1/channels 응답에 type(GENERAL/TEAM/DIRECT) 포함
• 메시지 목록: GET /api/v1/channels/{channelId}/messages?page=0&size=50 — 최신순 배열, 각 항목에 senderId/senderName/content/type/files/createdAt
• 텍스트 전송: POST .../messages JSON 바디 { "content": "...", "type": "TEXT" }
• 파일 전송: 같은 경로에 multipart/form-data로 content(선택) + files(필수) 전송, 응답 type=FILE & files[] 포함
• 기본 채널(General + DEV/DESIGN/MARKETING/PRODUCT)은 서버 기동 시 자동 생성되어 별도 생성 요청 불필요