Refactor/response variable unification #162

[chaen-ing]

🪺 Summary

1. 복수는 ~s ex) ids
2. 엔티티 정보는 제외 ex) seedID -> id
3. 다른 엔티티의 경우 이름 + 필드 ex)tagNames

위에 기준 바탕으로 씨드조회 관련 api들 응답, 요청 수정했습니다.
씨드 리스트 조회하는 경우들 모두 거의 비슷하다고 봐도 될 것 같아요

swagger도 정렬 + 로컬에서는 로컬만 쓸수있게 변경했습니다

🌱 Issue Number

• [Refactor] 응답 변수명 통일 #162

🙏 To Reviewers

• api 명세서도 수정해놨는데 필터링 및 검색 쪽 Response, request body기준으로 봐주세요 (예시는 넘 많아서 다못바꿨습니다)
• category, filter에서도 위에 기준에 부합하지 않는 경우가 많긴한데 이것도 바꾸면 너무 일이커질것같아..일단 뒀습니다
• swagger 관련 서버 env 추가해놨고 로컬에 추가하시면 됩니다.

[Copilot]

Pull Request Overview

Refactors request/response DTOs to use unified field names and enhances Swagger configuration.

• Standardized field names across APIs (e.g., seedId → id, seedName → name, tags → tagNames, seedLink → link, seedDetail → detail)
• Added Swagger UI sorting options and external server URL support via swagger.server.url
• Disabled the V2 simplification controller by commenting out its Spring annotations

Reviewed Changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/main/resources/application.yml	Added Swagger UI sorting options (groups-order, tags_sorter, operations_sorter) and new swagger.server.url property
src/main/java/com/adoonge/seedzip/simplification/controller/SimplificationControllerV2.java	Commented out controller annotations, effectively disabling V2 endpoints
src/main/java/com/adoonge/seedzip/seed/service/SeedService.java	Updated service logic to use renamed request fields (type, name, link, detail) and builder responses
src/main/java/com/adoonge/seedzip/seed/repository/SeedRepositoryImpl.java	Refactored filtering methods to use tagNames instead of tags
src/main/java/com/adoonge/seedzip/seed/dto/response/SeedResponse.java	Renamed response DTO records to unified field names (e.g., id, name, link, detail)
src/main/java/com/adoonge/seedzip/seed/dto/request/SeedUpdateRequest.java, SeedRequest.java, SeedFilteringRequest.java, SeedDeleteListRequest.java	Renamed request DTO records to match naming conventions (type, name, categoryNames, tagNames, ids)
src/main/java/com/adoonge/seedzip/seed/dto/SeedDTO.java	Updated internal DTO field names to unified conventions
src/main/java/com/adoonge/seedzip/global/config/SwaggerConfig.java	Changed property key to swagger.server.url and added conditional logic for local vs. production URLs

Comments suppressed due to low confidence (2)

src/main/java/com/adoonge/seedzip/seed/dto/response/SeedResponse.java:22

• After renaming response fields, ensure that existing API tests and JSON serialization/deserialization tests are updated to cover these new property names (id, name, link, detail) to prevent regressions.

    public record SeedInfoSimple(Long id, String name){}

src/main/java/com/adoonge/seedzip/simplification/controller/SimplificationControllerV2.java:26

• Commenting out @RestController disables the controller—if the intention is to deprecate or remove v2 endpoints, consider deleting this class or adding a clear deprecation notice; otherwise, re-enable the annotations so the API remains available.

//@RestController

[Copilot]

Using a substring check to detect localhost URLs is brittle; consider relying on an explicit environment/profile flag or parsing the URL scheme so you can handle various formats and avoid accidental mismatches.

Suggested change

	if(swaggerServerUrl.contains("localhost")){
	servers.add(new Server().url(swaggerServerUrl).description("Local Server"));
	}else{
	servers.add(new Server().url("https://"+swaggerServerUrl).description("AdoongE Server"));
	try {
	java.net.URI uri = new java.net.URI(swaggerServerUrl);
	String host = uri.getHost();
	if ("localhost".equals(host) || "127.0.0.1".equals(host) || "[::1]".equals(host)) {
	servers.add(new Server().url(swaggerServerUrl).description("Local Server"));
	} else {
	servers.add(new Server().url("https://" + swaggerServerUrl).description("AdoongE Server"));
	}
	} catch (java.net.URISyntaxException e) {
	throw new IllegalArgumentException("Invalid URL format for swaggerServerUrl: " + swaggerServerUrl, e);

[gyuseon25]

고생많으셨습니다 💯👍