[FEAT] 과제 제안 API 개발 & 이메일 API 개발

.gitignore

@@ -36,6 +36,6 @@ out/
 ### VS Code ###
 .vscode/
 
-/src/main/resources/application-local.yml
 /src/main/resources/application-oauth.yml
-/src/main/resources/static/docs/
+/src/main/resources/application-email.yml
+/src/main/resources/static/docs/

build.gradle

@@ -41,6 +41,7 @@ dependencies {
  runtimeOnly 'com.mysql:mysql-connector-j'
  annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'
  testImplementation 'org.springframework.boot:spring-boot-starter-test'
+ developmentOnly 'org.springframework.boot:spring-boot-devtools'
 
  //auth
  implementation 'io.jsonwebtoken:jjwt-api:0.11.5'
@@ -56,6 +57,13 @@ dependencies {
  implementation 'io.micrometer:micrometer-registry-prometheus'
 
  testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+
+ //email
+ implementation 'org.springframework.boot:spring-boot-starter-mail'
+
+ //thymeleaf(for email service)
+ implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
+ implementation 'nz.net.ultraq.thymeleaf:thymeleaf-layout-dialect'
 }
 
 tasks.named('test') {
@@ -88,6 +96,7 @@ tasks.named('asciidoctor') {
 build {
  dependsOn copyDocument
 }
+
 allprojects {
  repositories {
  maven { url 'https://jitpack.io'}

src/docs/asciidoc/eventNotice.adoc

@@ -0,0 +1,32 @@
+== 이벤트 공지 사항 API
+:source-highlighter: highlightjs
+
+=== 이벤트 공지 사항 생성 (POST /eventNotices)
+
+====
+operation::event-notice-controller-test/create-event-notice[snippets="http-request,request-fields,http-response,response-fields"]
+====
+
+=== 이벤트 공지 사항 리스트 조회 (GET /eventNotices)
+
+====
+operation::event-notice-controller-test/get-event-notice-list[snippets="query-parameters,http-request,http-response,response-fields"]
+====
+
+=== 이벤트 공지 사항 조회 (GET /eventNotices/{eventNoticeId})
+
+====
+operation::event-notice-controller-test/get-event-notice[snippets="path-parameters,http-request,http-response,response-fields"]
+====
+
+=== 이벤트 공지 사항 수정 (PUT /eventNotices/{eventNoticeId})
+
+====
+operation::event-notice-controller-test/update-event-notice[snippets="path-parameters,http-request,request-fields,http-response,response-fields"]
+====
+
+=== 이벤트 공지 사항 삭제 (DELETE /eventNotices/{eventNoticeId})
+
+====
+operation::event-notice-controller-test/delete-event-notice[snippets="path-parameters,http-request,http-response"]
+====

src/docs/asciidoc/eventPeriod.adoc

@@ -0,0 +1,23 @@
+== 이벤트 기간 API
+:source-highlighter: highlightjs
+
+---
+=== 이벤트 기간 생성 (POST /eventPeriods)
+====
+operation::event-period-controller-test/create-event-period[snippets="http-request,request-fields,http-response,response-fields"]
+====
+
+=== 올해의 이벤트 기간 조회 (GET /eventPeriod)
+====
+operation::event-period-controller-test/get-event-period[snippets="http-request,http-response,response-fields"]
+====
+
+=== 전체 이벤트 기간 리스트 조회 (GET /eventPeriods)
+====
+operation::event-period-controller-test/get-event-periods[snippets="http-request,http-response,response-fields"]
+====
+
+=== 올해의 이벤트 기간 업데이트 (PUT /eventPeriod)
+====
+operation::event-period-controller-test/update-event-period[snippets="http-request,request-fields,http-response,response-fields"]
+====

src/docs/asciidoc/index.adoc

@@ -2,8 +2,15 @@
 :doctype: book
 :source-highlighter: highlightjs
 :toc: left
-:toclevels: 3
+:toclevels: 2
 :seclinks:
 
+=== 커스텀 예외 코드
+include::{snippets}/exception-code-controller-test/get-exception-codes/exception-response-fields.adoc[]
+
 include::auth-controller-test.adoc[]
-// include::eventPeriod.adoc[] 컨트롤러별로 주석 지우고 문서 추가
+include::jobInterview.adoc[]
+include::talk.adoc[]
+include::notice.adoc[]
+include::eventNotice.adoc[]
+include::eventPeriod.adoc[]

src/docs/asciidoc/jobInterview.adoc

@@ -0,0 +1,32 @@
+== 잡페어 인터뷰 API
+:source-highlighter: highlightjs
+
+---
+=== 잡페어 인터뷰 생성 (POST /jobInterviews)
+====
+operation::job-interview-controller-test/create-job-interview[snippets="http-request,request-fields,http-response,response-fields"]
+====
+
+---
+=== 잡페어 인터뷰 리스트 조회 (GET /jobInterviews)
+====
+operation::job-interview-controller-test/get-job-interview-list[snippets="http-request,query-parameters,http-response,response-fields"]
+====
+
+---
+=== 잡페어 인터뷰 단건 조회 (GET /jobInterviews/{jobInterviewId})
+====
+operation::job-interview-controller-test/get-job-interview[snippets="http-request,path-parameters,http-response,response-fields"]
+====
+
+---
+=== 잡페어 인터뷰 수정 (PUT /jobInterviews/{jobInterviewId})
+====
+operation::job-interview-controller-test/update-job-interview[snippets="http-request,path-parameters,request-fields,http-response,response-fields"]
+====
+
+---
+=== 잡페어 인터뷰 삭제 (DELETE /jobInterviews/{jobInterviewId})
+====
+operation::job-interview-controller-test/delete-job-interview[snippets="http-request,path-parameters,http-response"]
+====

src/docs/asciidoc/notice.adoc

@@ -0,0 +1,32 @@
+== 공지 사항 API
+:source-highlighter: highlightjs
+
+=== 공지 사항 생성 (POST /notices)
+
+====
+operation::notice-controller-test/create-notice[snippets="http-request,request-fields,http-response,response-fields"]
+====
+
+=== 공지 사항 리스트 조회 (GET /notices)
+
+====
+operation::notice-controller-test/get-notice-list[snippets="query-parameters,http-request,http-response,response-fields"]
+====
+
+=== 공지 사항 조회 (GET /notices/{noticeId})
+
+====
+operation::notice-controller-test/get-notice[snippets="path-parameters,http-request,http-response,response-fields"]
+====
+
+=== 공지 사항 수정 (PUT /notices/{noticeId})
+
+====
+operation::notice-controller-test/update-notice[snippets="path-parameters,http-request,request-fields,http-response,response-fields"]
+====
+
+=== 공지 사항 삭제 (DELETE /notices/{noticeId})
+
+====
+operation::notice-controller-test/delete-notice[snippets="path-parameters,http-request,http-response"]
+====

src/docs/asciidoc/talk.adoc

@@ -0,0 +1,32 @@
+== 대담 영상 API
+:source-highlighter: highlightjs
+
+---
+=== 대담 영상 생성 (POST /talks)
+====
+operation::talk-controller-test/create-talk[snippets="http-request,request-fields,http-response,response-fields"]
+====
+
+---
+=== 대담 영상 리스트 조회 (GET /talks)
+====
+operation::talk-controller-test/get-talk-list[snippets="http-request,query-parameters,http-response,response-fields"]
+====
+
+---
+=== 대담 영상 단건 조회 (GET /talks/{talkId})
+====
+operation::talk-controller-test/get-talk[snippets="http-request,path-parameters,http-response,response-fields"]
+====
+
+---
+=== 대담 영상 수정 (PUT /talks/{talkId})
+====
+operation::talk-controller-test/update-talk[snippets="http-request,path-parameters,request-fields,http-response,response-fields"]
+====
+
+---
+=== 대담 영상 삭제 (DELETE /talks/{talkId})
+====
+operation::talk-controller-test/delete-talk[snippets="http-request,path-parameters,http-response"]
+====

src/main/java/com/scg/stop/StopApplication.java

@@ -2,13 +2,12 @@
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
-import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
 
 @SpringBootApplication
 public class StopApplication {
 
- public static void main(String[] args) {
- SpringApplication.run(StopApplication.class, args);
- }
+ public static void main(String[] args) {
+ SpringApplication.run(StopApplication.class, args);
+ }
 
-}
+}

src/main/java/com/scg/stop/domain/file/domain/File.java

@@ -4,9 +4,9 @@
 import static jakarta.persistence.GenerationType.IDENTITY;
 import static lombok.AccessLevel.PROTECTED;
 
-import com.scg.stop.domain.event.domain.EventNotice;
 import com.scg.stop.domain.gallery.domain.Gallery;
-import com.scg.stop.domain.notice.domain.Notice;
+import com.scg.stop.notice.domain.Notice;
+import com.scg.stop.event.domain.EventNotice;
 import com.scg.stop.global.domain.BaseTimeEntity;
 import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
@@ -46,4 +46,12 @@ public class File extends BaseTimeEntity {
  @ManyToOne(fetch = LAZY)
  @JoinColumn(name = "gallery_id")
  private Gallery gallery;
-}
+
+ public void setNotice(Notice notice) {
+ this.notice = notice;
+ }
+
+ public void setEventNotice(EventNotice eventNotice) {
+ this.eventNotice = eventNotice;
+ }
+}

src/main/java/com/scg/stop/domain/file/dto/response/FileResponse.java

@@ -0,0 +1,33 @@
+package com.scg.stop.domain.file.dto.response;
+
+import static lombok.AccessLevel.PRIVATE;
+
+import com.scg.stop.domain.file.domain.File;
+import java.time.LocalDateTime;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor(access = PRIVATE)
+@AllArgsConstructor
+public class FileResponse {
+
+ private Long id;
+ private String uuid;
+ private String name;
+ private String mimeType;
+ private LocalDateTime createdAt;
+ private LocalDateTime updatedAt;
+
+ public static FileResponse from(File file) {
+ return new FileResponse(
+ file.getId(),
+ file.getUuid(),
+ file.getName(),
+ file.getMimeType(),
+ file.getCreatedAt(),
+ file.getUpdatedAt()
+ );
+ }
+}

src/main/java/com/scg/stop/domain/file/repository/FileRepository.java

@@ -0,0 +1,11 @@
+package com.scg.stop.domain.file.repository;
+
+import com.scg.stop.domain.file.domain.File;
+import java.util.List;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+public interface FileRepository extends JpaRepository<File, Long> {
+
+ List<File> findByIdIn(List<Long> ids);
+}