Feature/votes

build.gradle

@@ -41,6 +41,9 @@ dependencies {
 	testImplementation 'org.springframework.boot:spring-boot-starter-test'
 	testImplementation 'org.springframework.security:spring-security-test'
 	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.8'
+    implementation "org.springframework.session:spring-session-jdbc"
+
 }
 
 tasks.named('test') {

docs.txt

@@ -0,0 +1,22 @@
+# Notes: Spec ↔ Implementation 매핑
+#
+# page#0 관리자 페이지
+# 0.1 홈화면
+# GET /votes : 목록 (id, name, code, adminUrl, shareUrl)
+    투표 블록 터치 → GET /votes/{id} 로 상세 조회
+# POST /votes : 새 투표 생성 (res.shareUrl 로 링크 복사)
+    날짜 2개 선택 → backend에는 startDate,endDate로 저장 (두 날짜 포함 범위)
+    프론트에서 3번째 날짜 선택 시 프론트 로직으로 2개만 유지 → 서버엔 항상 (start,end)만 전달
+# DELETE /votes/{id} : 투표 삭제
+# PATCH /votes/{id} : 이름/날짜 범위 수정 (둘 다 vote attr)
+
+#
+# 0.2 투표 설정 화면
+# 참여자 칩 생성 섹션: POST /votes/{id}/participants {displayName}
+    생성된 응답에 loginCode 포함(칩/매직링크 구현용)
+# 참여자 삭제: DELETE /participants/{participantId}
+#
+# 기타
+# Vote 삭제 시 @OneToMany(cascade=ALL, orphanRemoval=true)로 참가자 함께 삭제
+# 코드/링크: app.base-url + "/v/" + code (공유 링크), "/admin/votes/{id}" (관리 URL)
+# Validation: endDate >= startDate. name not blank.

src/main/java/com/workingdead/config/CorsConfig.java

@@ -0,0 +1,29 @@
+package com.workingdead.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.cors.*;
+
+import java.util.List;
+
+@Configuration
+public class CorsConfig {
+    @Bean
+    public CorsConfigurationSource corsConfigurationSource() {
+        CorsConfiguration config = new CorsConfiguration();
+        config.setAllowedOrigins(List.of(
+                "http://localhost:3000",
+                "http://localhost:8081",
+                "http://localhost:8080",
+                "http://10.0.2.2:8080"
+        ));
+        config.setAllowedMethods(List.of("GET","POST","PUT","PATCH","DELETE","OPTIONS"));
+        config.setAllowedHeaders(List.of("*"));
+        config.setExposedHeaders(List.of("Authorization", "Content-Type"));
+        config.setAllowCredentials(true);
+        config.setMaxAge(3600L);
+        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
+        source.registerCorsConfiguration("/**", config);
+        return source;
+    }
+}

src/main/java/com/workingdead/config/OpenApiConfig.java

@@ -0,0 +1,38 @@
+package com.workingdead.config;
+
+import io.swagger.v3.oas.models.Components;
+import io.swagger.v3.oas.models.OpenAPI;
+import io.swagger.v3.oas.models.info.Info;
+import io.swagger.v3.oas.models.security.SecurityRequirement;
+import io.swagger.v3.oas.models.security.SecurityScheme;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * Swagger springdoc-ui 구성 파일
+ */
+@Configuration
+public class OpenApiConfig {
+    @Bean
+    public OpenAPI openAPI() {
+        Info info = new Info()
+                .title("API Document")
+                .version("v5.28.1")
+                .description("UniConnect 백엔드 API 명세");
+
+        SecurityScheme securityScheme = new SecurityScheme()
+                .type(SecurityScheme.Type.HTTP)
+                .scheme("bearer")
+                .bearerFormat("JWT")
+                .in(SecurityScheme.In.HEADER)
+                .name("Authorization");
+
+        SecurityRequirement securityRequirement = new SecurityRequirement().addList("Bearer Authentication");
+
+        return new OpenAPI()
+                .components(new Components().addSecuritySchemes("Bearer Authentication", securityScheme))
+                .addSecurityItem(securityRequirement)
+                .info(info);
+    }
+}
+

src/main/java/com/workingdead/config/SecurityConfig.java

@@ -0,0 +1,30 @@
+package com.workingdead.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.security.config.annotation.web.builders.HttpSecurity;
+import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
+import org.springframework.security.web.SecurityFilterChain;
+
+@Configuration
+@EnableWebSecurity
+public class SecurityConfig {
+
+    @Bean
+    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
+        http
+                .csrf(csrf -> csrf.disable())
+                .formLogin(form -> form.disable())  // 기본 로그인 폼 비활성화
+                .httpBasic(basic -> basic.disable()) // 브라우저 팝업 로그인 비활성화
+                .authorizeHttpRequests(auth -> auth
+                        .requestMatchers(
+                                "/v3/api-docs/**",
+                                "/swagger-ui/**",
+                                "/swagger-ui.html"
+                        ).permitAll()
+                        .anyRequest().permitAll()
+                );
+
+        return http.build();
+    }
+}

src/main/java/com/workingdead/meet/controller/ParticipantController.java

@@ -0,0 +1,53 @@
+package com.workingdead.meet.controller;
+
+import com.workingdead.meet.dto.*;
+import com.workingdead.meet.entity.*;
+import com.workingdead.meet.repository.*;
+import com.workingdead.meet.service.*;
+import io.swagger.v3.oas.annotations.*;
+import io.swagger.v3.oas.annotations.media.*;
+import io.swagger.v3.oas.annotations.responses.*;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+@Tag(name = "Participant", description = "참여자 관리 API")
+@RestController
+@RequestMapping("")
+public class ParticipantController {
+    private final ParticipantService participantService;
+    public ParticipantController(ParticipantService participantService) { this.participantService = participantService; }
+
+
+    // 0.2 참여자 추가/삭제
+    @Operation(
+            summary = "참여자 추가",
+            description = "특정 투표에 새로운 참여자를 추가합니다. displayName을 기반으로 참여자 칩이 생성됩니다."
+    )
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "참여자 추가 성공",
+                    content = @Content(schema = @Schema(implementation = ParticipantDtos.ParticipantRes.class))),
+            @ApiResponse(responseCode = "400", description = "잘못된 요청 (displayName이 비어있는 경우)", content = @Content),
+            @ApiResponse(responseCode = "404", description = "투표를 찾을 수 없음", content = @Content)
+    })
+    @PostMapping("/votes/{voteId}/participants")
+    public ResponseEntity<ParticipantDtos.ParticipantRes> add(@PathVariable Long voteId, @RequestBody @Valid ParticipantDtos.CreateParticipantReq req) {
+        var res = participantService.add(voteId, req.displayName());
+        return ResponseEntity.ok(res);
+    }
+
+    @Operation(
+            summary = "참여자 삭제",
+            description = "특정 참여자를 삭제합니다."
+    )
+    @ApiResponses({
+            @ApiResponse(responseCode = "204", description = "참여자 삭제 성공", content = @Content),
+            @ApiResponse(responseCode = "404", description = "참여자를 찾을 수 없음", content = @Content)
+    })
+    @DeleteMapping("/participants/{participantId}")
+    public ResponseEntity<Void> remove(@PathVariable Long participantId) {
+        participantService.remove(participantId);
+        return ResponseEntity.noContent().build();
+    }
+}

src/main/java/com/workingdead/meet/controller/VoteController.java

@@ -0,0 +1,87 @@
+package com.workingdead.meet.controller;
+
+import com.workingdead.meet.dto.*;
+import com.workingdead.meet.entity.*;
+import com.workingdead.meet.repository.*;
+import com.workingdead.meet.service.*;
+import io.swagger.v3.oas.annotations.*;
+import io.swagger.v3.oas.annotations.media.*;
+import io.swagger.v3.oas.annotations.responses.*;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+import java.util.List;
+
+@Tag(name = "Vote", description = "투표 관리 API")
+@RestController
+@RequestMapping("/votes")
+public class VoteController {
+    private final VoteService voteService;
+    public VoteController(VoteService voteService) { this.voteService = voteService; }
+
+    @Operation(
+            summary = "투표 목록 조회",
+            description = "모든 투표 목록을 조회합니다. 각 투표의 기본 정보(id, name, code, adminUrl, shareUrl, startDate, endDate)를 반환합니다." +
+                    "code+baseUrl=shareUrl"
+    )
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "조회 성공",
+                    content = @Content(schema = @Schema(implementation = VoteDtos.VoteSummary.class)))
+    })
+    // 0.1 홈화면 리스트 & 생성
+    @GetMapping
+    public List<VoteDtos.VoteSummary> list() { return voteService.listAll(); }
+
+    // 0.2 투표 설정 화면 읽기/수정/삭제
+    @GetMapping("/{id}")
+    public VoteDtos.VoteDetail get(@PathVariable Long id) { return voteService.get(id); }
+
+
+    @Operation(
+            summary = "새 투표 생성",
+            description = "새로운 투표를 생성합니다. 고유한 code가 자동 생성되며, shareUrl을 통해 참여자에게 공유할 수 있습니다."
+    )
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "생성 성공",
+                    content = @Content(schema = @Schema(implementation = VoteDtos.VoteSummary.class))),
+            @ApiResponse(responseCode = "400", description = "잘못된 요청 (name이 비어있는 경우)", content = @Content)
+    })
+    @PostMapping
+    public ResponseEntity<VoteDtos.VoteSummary> create(@RequestBody @Valid VoteDtos.CreateVoteReq req) {
+        var res = voteService.create(req);
+// 0.2.3 링크 복사: res.shareUrl 포함
+        return ResponseEntity.ok(res);
+    }
+
+
+    @Operation(
+            summary = "투표 정보 수정",
+            description = "투표의 이름 또는 날짜 범위를 수정합니다. endDate는 startDate보다 크거나 같아야 합니다."
+    )
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "수정 성공",
+                    content = @Content(schema = @Schema(implementation = VoteDtos.VoteDetail.class))),
+            @ApiResponse(responseCode = "400", description = "잘못된 요청 (endDate < startDate)", content = @Content),
+            @ApiResponse(responseCode = "404", description = "투표를 찾을 수 없음", content = @Content)
+    })
+    @PatchMapping("/{id}")
+    public VoteDtos.VoteDetail update(@PathVariable Long id, @RequestBody VoteDtos.UpdateVoteReq req) {
+// 날짜 범위 검증은 서비스에서 처리 (end >= start)
+        return voteService.update(id, req);
+    }
+
+    @Operation(
+            summary = "투표 삭제",
+            description = "투표를 삭제합니다. 연관된 모든 참여자도 함께 삭제됩니다 (cascade)."
+    )
+    @ApiResponses({
+            @ApiResponse(responseCode = "204", description = "삭제 성공", content = @Content),
+            @ApiResponse(responseCode = "404", description = "투표를 찾을 수 없음", content = @Content)
+    })
+    @DeleteMapping("/{id}")
+    public ResponseEntity<Void> delete(@PathVariable Long id) {
+        voteService.delete(id);
+        return ResponseEntity.noContent().build();
+    }
+}

src/main/java/com/workingdead/meet/dto/ParticipantDtos.java

@@ -0,0 +1,9 @@
+package com.workingdead.meet.dto;
+
+import jakarta.validation.constraints.*;
+
+
+public class ParticipantDtos {
+    public record CreateParticipantReq(@NotBlank String displayName) {}
+    public record ParticipantRes(Long id, String displayName) {}
+}

src/main/java/com/workingdead/meet/dto/VoteDtos.java

@@ -0,0 +1,20 @@
+package com.workingdead.meet.dto;
+
+import jakarta.validation.constraints.*;
+import java.time.*;
+import java.util.*;
+
+
+public class VoteDtos {
+    public record CreateVoteReq(
+            @NotBlank String name,
+            LocalDate startDate,
+            LocalDate endDate,
+            List<String> participantNames  // 참여자 이름 리스트 (optional)
+    ) {}
+    public record UpdateVoteReq(String name, LocalDate startDate, LocalDate endDate) {}
+
+    public record VoteSummary(Long id, String name, String code, String adminUrl, String shareUrl, LocalDate startDate, LocalDate endDate) {}
+
+    public record VoteDetail(Long id, String name, String code, LocalDate startDate, LocalDate endDate, List<ParticipantDtos.ParticipantRes> participants) {}
+}

src/main/java/com/workingdead/meet/entity/Participant.java

@@ -0,0 +1,39 @@
+package com.workingdead.meet.entity;
+
+import jakarta.persistence.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.Setter;
+
+@Getter @Setter @AllArgsConstructor @Builder
+@Entity
+@Table(name = "participant")
+public class Participant {
+    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "vote_id", nullable = false)
+    private Vote vote; // FK to vote
+
+
+    @Column(nullable = false)
+    private String displayName; // 칩에 보여줄 이름
+
+
+//    @Column(nullable = false, unique = true)
+//    private String loginCode; // 간단 로그인 토큰(칩 생성용)
+
+
+    public Participant() {}
+    public Participant(Vote vote, String displayName) {
+        this.vote = vote;
+        this.displayName = displayName;
+//        this.loginCode = loginCode;
+    }
+
+
+    // getters/setters
+}

src/main/java/com/workingdead/meet/entity/Vote.java

@@ -0,0 +1,47 @@
+package com.workingdead.meet.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.*;
+import java.util.*;
+
+
+@Getter @Setter @AllArgsConstructor @Builder
+@Entity
+@Table(name = "vote")
+public class Vote {
+    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+
+    @Column(nullable = false)
+    private String name; // 투표(블록) 이름
+
+
+    @Column(unique = true, nullable = false, updatable = false)
+    private String code; // 공유용 짧은 코드 (링크)
+
+
+    private LocalDate startDate; // 선택 범위 시작
+    private LocalDate endDate; // 선택 범위 끝
+
+
+    @Column(nullable = false, updatable = false)
+    private Instant createdAt = Instant.now();
+
+
+    @OneToMany(mappedBy = "vote", cascade = CascadeType.ALL, orphanRemoval = true)
+    private List<Participant> participants = new ArrayList<>();
+
+
+    public Vote() {}
+    public Vote(String name, String code) {
+        this.name = name;
+        this.code = code;
+    }
+
+
+    // getters/setters
+    public void setDateRange(LocalDate start, LocalDate end) { this.startDate = start; this.endDate = end; }
+}