From e06634471385f1e87b8641afba5da52b6677d5d0 Mon Sep 17 00:00:00 2001
From: oTAETAEo <ggg7515@naver.com>
Date: Thu, 5 Nov 2026 13:00:49 +0900
Subject: [PATCH 1/5] =?UTF-8?q?feat:=20=ED=9C=B4=EC=A7=80=ED=86=B5=20?=
 =?UTF-8?q?=EC=A0=9C=EC=99=B8=20=EB=82=B4=20=ED=85=9C=ED=94=8C=EB=A6=BF?=
 =?UTF-8?q?=EC=9D=84=20=EC=83=9D=EC=84=B1=20=EC=88=9C=EC=9C=BC=EB=A1=9C=20?=
 =?UTF-8?q?=EC=9D=BD=EB=8A=94=20=EC=A1=B0=ED=9A=8C=20=EC=B6=94=EA=B0=80=20?=
 =?UTF-8?q?(#66)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../repository/TemplateRepository.java        |  6 ++
 .../TemplateListRepositoryTest.java           | 85 +++++++++++++++++++
 2 files changed, 91 insertions(+)
 create mode 100644 src/test/java/com/sniptext/domain/template/repository/TemplateListRepositoryTest.java

diff --git a/src/main/java/com/sniptext/domain/template/repository/TemplateRepository.java b/src/main/java/com/sniptext/domain/template/repository/TemplateRepository.java
index 583a079..2ca96e9 100644
--- a/src/main/java/com/sniptext/domain/template/repository/TemplateRepository.java
+++ b/src/main/java/com/sniptext/domain/template/repository/TemplateRepository.java
@@ -19,6 +19,12 @@ public interface TemplateRepository extends JpaRepository<Template, Long> {
 	/** 본인 소유 조회. 휴지통 템플릿도 찾으므로 내 휴지통과 다른 회원 것을 호출자가 구분할 수 있다 */
 	Optional<Template> findByIdAndUserId(Long id, Long userId);
 
+	/**
+	 * 휴지통을 제외한 본인 템플릿 전체, 생성 순(ID 오름차순). 목록은 페이지를 나누지 않는다.
+	 * idx_templates_user_deleted (user_id, deleted_at)는 뒤에 기본 키가 붙어 있어 따로 정렬하지 않는다
+	 */
+	List<Template> findAllByUserIdAndDeletedAtIsNullOrderByIdAsc(Long userId);
+
 	/** 휴지통을 제외한 보유 개수. idx_templates_user_deleted (user_id, deleted_at)를 탄다 */
 	long countByUserIdAndDeletedAtIsNull(Long userId);
 
diff --git a/src/test/java/com/sniptext/domain/template/repository/TemplateListRepositoryTest.java b/src/test/java/com/sniptext/domain/template/repository/TemplateListRepositoryTest.java
new file mode 100644
index 0000000..5988fd4
--- /dev/null
+++ b/src/test/java/com/sniptext/domain/template/repository/TemplateListRepositoryTest.java
@@ -0,0 +1,85 @@
+package com.sniptext.domain.template.repository;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import java.time.LocalDateTime;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.context.annotation.Import;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.sniptext.domain.template.entity.Template;
+import com.sniptext.domain.user.entity.User;
+import com.sniptext.fixture.TemplateFixture;
+import com.sniptext.fixture.UserFixture;
+import com.sniptext.support.IntegrationTestSupport;
+import com.sniptext.support.MutableClock;
+import com.sniptext.support.MutableClockConfiguration;
+
+import jakarta.persistence.EntityManager;
+
+/** 내 템플릿 목록 조회의 범위와 정렬을 실제 MySQL로 검증한다. */
+@Transactional
+@Import(MutableClockConfiguration.class)
+class TemplateListRepositoryTest extends IntegrationTestSupport {
+
+	private static final LocalDateTime FIXED = LocalDateTime.of(2026, 10, 25, 10, 0);
+
+	@Autowired
+	private TemplateRepository templateRepository;
+
+	@Autowired
+	private EntityManager entityManager;
+
+	@Autowired
+	private MutableClock clock;
+
+	private Long userId;
+	private Long otherUserId;
+
+	@BeforeEach
+	void setUp() {
+		clock.setTo(FIXED);
+		userId = saveUser("owner@sniptext.com");
+		otherUserId = saveUser("other@sniptext.com");
+	}
+
+	@Test
+	@DisplayName("휴지통을 제외한 본인 템플릿만 ID 오름차순으로 읽는다")
+	void activeTemplatesInIdOrder() {
+		Long first = save(TemplateFixture.template(userId, "/첫째"));
+		save(TemplateFixture.template(otherUserId, "/남의것"));
+		save(TemplateFixture.trashedTemplate(userId, "/삭제", FIXED));
+		Long second = save(TemplateFixture.template(userId, "/둘째"));
+		Long third = save(TemplateFixture.template(userId, "/셋째"));
+		entityManager.clear();
+
+		assertThat(templateRepository.findAllByUserIdAndDeletedAtIsNullOrderByIdAsc(userId))
+			.extracting(Template::getId)
+			.containsExactly(first, second, third);
+	}
+
+	@Test
+	@DisplayName("템플릿이 없으면 빈 목록이다")
+	void empty() {
+		save(TemplateFixture.template(otherUserId));
+		save(TemplateFixture.trashedTemplate(userId, "/삭제", FIXED));
+
+		assertThat(templateRepository.findAllByUserIdAndDeletedAtIsNullOrderByIdAsc(userId)).isEmpty();
+	}
+
+	private Long save(Template template) {
+		return templateRepository.saveAndFlush(template).getId();
+	}
+
+	private Long saveUser(String email) {
+		User user = UserFixture.user(email);
+		entityManager.persist(user);
+		entityManager.flush();
+		return user.getId();
+	}
+
+}

From 20aa877438ac2a70543de65f4a5ccdf942ccd451 Mon Sep 17 00:00:00 2001
From: oTAETAEo <ggg7515@naver.com>
Date: Thu, 5 Nov 2026 13:00:50 +0900
Subject: [PATCH 2/5] =?UTF-8?q?feat:=20=EB=82=B4=20=ED=85=9C=ED=94=8C?=
 =?UTF-8?q?=EB=A6=BF=20=EB=AA=A9=EB=A1=9D=20=EC=A1=B0=ED=9A=8C=20=EC=84=9C?=
 =?UTF-8?q?=EB=B9=84=EC=8A=A4=20=EA=B5=AC=ED=98=84=20(#66)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../service/TemplateQueryService.java         | 13 +++++++
 .../dto/result/TemplateListItemResult.java    | 35 +++++++++++++++++++
 .../dto/result/TemplateListResult.java        | 12 +++++++
 .../service/TemplateQueryServiceTest.java     | 33 +++++++++++++++++
 4 files changed, 93 insertions(+)
 create mode 100644 src/main/java/com/sniptext/domain/template/service/dto/result/TemplateListItemResult.java
 create mode 100644 src/main/java/com/sniptext/domain/template/service/dto/result/TemplateListResult.java

diff --git a/src/main/java/com/sniptext/domain/template/service/TemplateQueryService.java b/src/main/java/com/sniptext/domain/template/service/TemplateQueryService.java
index 1818fb1..bbd70c5 100644
--- a/src/main/java/com/sniptext/domain/template/service/TemplateQueryService.java
+++ b/src/main/java/com/sniptext/domain/template/service/TemplateQueryService.java
@@ -1,5 +1,7 @@
 package com.sniptext.domain.template.service;
 
+import java.util.List;
+
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
@@ -8,6 +10,8 @@
 import com.sniptext.domain.template.repository.TemplateRepository;
 import com.sniptext.domain.template.service.dto.query.TemplateDetailQuery;
 import com.sniptext.domain.template.service.dto.result.TemplateDetailResult;
+import com.sniptext.domain.template.service.dto.result.TemplateListItemResult;
+import com.sniptext.domain.template.service.dto.result.TemplateListResult;
 import com.sniptext.global.exception.BusinessException;
 
 import lombok.RequiredArgsConstructor;
@@ -24,6 +28,15 @@ public long countActive(Long userId) {
 		return templateRepository.countByUserIdAndDeletedAtIsNull(userId);
 	}
 
+	/** 내 템플릿 목록. 휴지통을 제외한 전체를 생성 순으로 */
+	public TemplateListResult getTemplates(Long userId) {
+		List<TemplateListItemResult> templates = templateRepository.findAllByUserIdAndDeletedAtIsNullOrderByIdAsc(userId)
+			.stream()
+			.map(TemplateListItemResult::from)
+			.toList();
+		return TemplateListResult.from(templates);
+	}
+
 	/** 내 템플릿 상세. 없거나 다른 회원 것이면 TEMPLATE404_1, 휴지통에 있으면 TEMPLATE404_2 */
 	public TemplateDetailResult getTemplate(TemplateDetailQuery query) {
 		return TemplateDetailResult.from(getActiveTemplate(query.userId(), query.templateId()));
diff --git a/src/main/java/com/sniptext/domain/template/service/dto/result/TemplateListItemResult.java b/src/main/java/com/sniptext/domain/template/service/dto/result/TemplateListItemResult.java
new file mode 100644
index 0000000..0c7cc58
--- /dev/null
+++ b/src/main/java/com/sniptext/domain/template/service/dto/result/TemplateListItemResult.java
@@ -0,0 +1,35 @@
+package com.sniptext.domain.template.service.dto.result;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import com.sniptext.domain.template.entity.Template;
+import com.sniptext.domain.template.support.TemplateVariableExtractor;
+
+/** 내 템플릿 목록의 한 항목. 변수 목록은 저장하지 않고 복호화한 본문에서 뽑는다. */
+public record TemplateListItemResult(
+	Long templateId,
+	String title,
+	String shortcut,
+	String content,
+	List<String> variables,
+	LocalDateTime lastUsedAt,
+	LocalDateTime createdAt,
+	LocalDateTime editedAt
+) {
+
+	public static TemplateListItemResult from(Template template) {
+		String content = template.getContent().getValue();
+		return new TemplateListItemResult(
+			template.getId(),
+			template.getTitle().getValue(),
+			template.getShortcut().getValue(),
+			content,
+			TemplateVariableExtractor.extract(content),
+			template.getLastUsedAt(),
+			template.getCreatedAt(),
+			template.getEditedAt()
+		);
+	}
+
+}
diff --git a/src/main/java/com/sniptext/domain/template/service/dto/result/TemplateListResult.java b/src/main/java/com/sniptext/domain/template/service/dto/result/TemplateListResult.java
new file mode 100644
index 0000000..a73f02b
--- /dev/null
+++ b/src/main/java/com/sniptext/domain/template/service/dto/result/TemplateListResult.java
@@ -0,0 +1,12 @@
+package com.sniptext.domain.template.service.dto.result;
+
+import java.util.List;
+
+/** 내 템플릿 목록. 페이지를 나누지 않으므로 개수는 항목 수와 같다. */
+public record TemplateListResult(int totalCount, List<TemplateListItemResult> templates) {
+
+	public static TemplateListResult from(List<TemplateListItemResult> templates) {
+		return new TemplateListResult(templates.size(), List.copyOf(templates));
+	}
+
+}
diff --git a/src/test/java/com/sniptext/domain/template/service/TemplateQueryServiceTest.java b/src/test/java/com/sniptext/domain/template/service/TemplateQueryServiceTest.java
index 3bbd486..72ab661 100644
--- a/src/test/java/com/sniptext/domain/template/service/TemplateQueryServiceTest.java
+++ b/src/test/java/com/sniptext/domain/template/service/TemplateQueryServiceTest.java
@@ -5,6 +5,7 @@
 import static org.mockito.BDDMockito.given;
 
 import java.time.LocalDateTime;
+import java.util.List;
 import java.util.Optional;
 
 import org.junit.jupiter.api.DisplayName;
@@ -19,6 +20,8 @@
 import com.sniptext.domain.template.repository.TemplateRepository;
 import com.sniptext.domain.template.service.dto.query.TemplateDetailQuery;
 import com.sniptext.domain.template.service.dto.result.TemplateDetailResult;
+import com.sniptext.domain.template.service.dto.result.TemplateListItemResult;
+import com.sniptext.domain.template.service.dto.result.TemplateListResult;
 import com.sniptext.fixture.TemplateFixture;
 import com.sniptext.global.exception.BusinessException;
 
@@ -81,4 +84,34 @@ void getTemplateInTrash() {
 			.isEqualTo(TemplateErrorCode.TEMPLATE_IN_TRASH);
 	}
 
+	@Test
+	@DisplayName("목록은 레포지토리가 읽은 순서 그대로, 개수와 본문에서 뽑은 변수 목록을 함께 돌려준다")
+	void getTemplates() {
+		Template first = TemplateFixture.templateWithContent(USER_ID, "{{금액}}원, {{고객명}}님 {{금액}}원");
+		Template second = TemplateFixture.templateWithContent(USER_ID, "변수 없는 본문 {{잘못된 변수}}");
+		given(templateRepository.findAllByUserIdAndDeletedAtIsNullOrderByIdAsc(USER_ID))
+			.willReturn(List.of(first, second));
+
+		TemplateListResult result = templateQueryService.getTemplates(USER_ID);
+
+		assertThat(result.totalCount()).isEqualTo(2);
+		assertThat(result.templates()).extracting(TemplateListItemResult::content)
+			.containsExactly("{{금액}}원, {{고객명}}님 {{금액}}원", "변수 없는 본문 {{잘못된 변수}}");
+		assertThat(result.templates()).extracting(TemplateListItemResult::variables)
+			.containsExactly(List.of("금액", "고객명"), List.of());
+		assertThat(result.templates().getFirst().title()).isEqualTo(TemplateFixture.TITLE);
+		assertThat(result.templates().getFirst().shortcut()).isEqualTo(TemplateFixture.SHORTCUT);
+	}
+
+	@Test
+	@DisplayName("템플릿이 없으면 개수 0과 빈 목록이다")
+	void getTemplatesEmpty() {
+		given(templateRepository.findAllByUserIdAndDeletedAtIsNullOrderByIdAsc(USER_ID)).willReturn(List.of());
+
+		TemplateListResult result = templateQueryService.getTemplates(USER_ID);
+
+		assertThat(result.totalCount()).isZero();
+		assertThat(result.templates()).isEmpty();
+	}
+
 }

From 7790d97824a15d5215f7ad0c1c8e31b6e01d7c61 Mon Sep 17 00:00:00 2001
From: oTAETAEo <ggg7515@naver.com>
Date: Thu, 5 Nov 2026 13:00:50 +0900
Subject: [PATCH 3/5] =?UTF-8?q?feat:=20=EB=82=B4=20=ED=85=9C=ED=94=8C?=
 =?UTF-8?q?=EB=A6=BF=20=EB=AA=A9=EB=A1=9D=20API=20=EA=B5=AC=ED=98=84=20(#6?=
 =?UTF-8?q?6)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../controller/TemplateController.java        |   7 +
 .../controller/TemplateSuccessCode.java       |   1 +
 .../dto/TemplateListItemResponse.java         |  33 +++
 .../controller/dto/TemplateListResponse.java  |  17 ++
 .../TemplateListControllerTest.java           | 250 ++++++++++++++++++
 5 files changed, 308 insertions(+)
 create mode 100644 src/main/java/com/sniptext/domain/template/controller/dto/TemplateListItemResponse.java
 create mode 100644 src/main/java/com/sniptext/domain/template/controller/dto/TemplateListResponse.java
 create mode 100644 src/test/java/com/sniptext/domain/template/controller/TemplateListControllerTest.java

diff --git a/src/main/java/com/sniptext/domain/template/controller/TemplateController.java b/src/main/java/com/sniptext/domain/template/controller/TemplateController.java
index 66b4497..fbd6fe7 100644
--- a/src/main/java/com/sniptext/domain/template/controller/TemplateController.java
+++ b/src/main/java/com/sniptext/domain/template/controller/TemplateController.java
@@ -12,6 +12,7 @@
 import com.sniptext.domain.template.controller.dto.TemplateCreateRequest;
 import com.sniptext.domain.template.controller.dto.TemplateCreateResponse;
 import com.sniptext.domain.template.controller.dto.TemplateDetailResponse;
+import com.sniptext.domain.template.controller.dto.TemplateListResponse;
 import com.sniptext.domain.template.controller.dto.TemplateUpdateRequest;
 import com.sniptext.domain.template.controller.dto.TemplateUpdateResponse;
 import com.sniptext.domain.template.service.TemplateCommandService;
@@ -37,6 +38,12 @@ public class TemplateController {
 	private final TemplateCommandService templateCommandService;
 	private final TemplateQueryService templateQueryService;
 
+	@GetMapping
+	public ResponseEntity<ApiResponse<TemplateListResponse>> getTemplates(@LoginUser Long userId) {
+		return ApiResponse.success(TemplateSuccessCode.TEMPLATE_LIST_FOUND,
+			TemplateListResponse.from(templateQueryService.getTemplates(userId)));
+	}
+
 	@GetMapping("/{templateId}")
 	public ResponseEntity<ApiResponse<TemplateDetailResponse>> getTemplate(
 		@LoginUser Long userId,
diff --git a/src/main/java/com/sniptext/domain/template/controller/TemplateSuccessCode.java b/src/main/java/com/sniptext/domain/template/controller/TemplateSuccessCode.java
index 02844c9..7bb5b67 100644
--- a/src/main/java/com/sniptext/domain/template/controller/TemplateSuccessCode.java
+++ b/src/main/java/com/sniptext/domain/template/controller/TemplateSuccessCode.java
@@ -11,6 +11,7 @@
 @RequiredArgsConstructor
 public enum TemplateSuccessCode implements ResultCode {
 
+	TEMPLATE_LIST_FOUND(HttpStatus.OK, "TEMPLATE200_1", "템플릿 목록 조회에 성공했습니다."),
 	TEMPLATE_FOUND(HttpStatus.OK, "TEMPLATE200_2", "템플릿 조회에 성공했습니다."),
 	TEMPLATE_UPDATED(HttpStatus.OK, "TEMPLATE200_3", "수정 내용이 저장되었습니다."),
 	TEMPLATE_CREATED(HttpStatus.CREATED, "TEMPLATE201_1", "템플릿이 저장되었습니다.");
diff --git a/src/main/java/com/sniptext/domain/template/controller/dto/TemplateListItemResponse.java b/src/main/java/com/sniptext/domain/template/controller/dto/TemplateListItemResponse.java
new file mode 100644
index 0000000..fdcf7f4
--- /dev/null
+++ b/src/main/java/com/sniptext/domain/template/controller/dto/TemplateListItemResponse.java
@@ -0,0 +1,33 @@
+package com.sniptext.domain.template.controller.dto;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import com.sniptext.domain.template.service.dto.result.TemplateListItemResult;
+
+/** 내 템플릿 목록의 한 항목 (명세 8번). 시각은 전역 직렬화 설정이 +09:00을 붙여 내보낸다. */
+public record TemplateListItemResponse(
+	Long templateId,
+	String title,
+	String shortcut,
+	String content,
+	List<String> variables,
+	LocalDateTime lastUsedAt,
+	LocalDateTime createdAt,
+	LocalDateTime editedAt
+) {
+
+	public static TemplateListItemResponse from(TemplateListItemResult result) {
+		return new TemplateListItemResponse(
+			result.templateId(),
+			result.title(),
+			result.shortcut(),
+			result.content(),
+			result.variables(),
+			result.lastUsedAt(),
+			result.createdAt(),
+			result.editedAt()
+		);
+	}
+
+}
diff --git a/src/main/java/com/sniptext/domain/template/controller/dto/TemplateListResponse.java b/src/main/java/com/sniptext/domain/template/controller/dto/TemplateListResponse.java
new file mode 100644
index 0000000..e0cc02a
--- /dev/null
+++ b/src/main/java/com/sniptext/domain/template/controller/dto/TemplateListResponse.java
@@ -0,0 +1,17 @@
+package com.sniptext.domain.template.controller.dto;
+
+import java.util.List;
+
+import com.sniptext.domain.template.service.dto.result.TemplateListResult;
+
+/** 명세 8번 내 템플릿 목록. 생성 순, 페이지 나눔 없음 */
+public record TemplateListResponse(int totalCount, List<TemplateListItemResponse> templates) {
+
+	public static TemplateListResponse from(TemplateListResult result) {
+		return new TemplateListResponse(
+			result.totalCount(),
+			result.templates().stream().map(TemplateListItemResponse::from).toList()
+		);
+	}
+
+}
diff --git a/src/test/java/com/sniptext/domain/template/controller/TemplateListControllerTest.java b/src/test/java/com/sniptext/domain/template/controller/TemplateListControllerTest.java
new file mode 100644
index 0000000..d5f8544
--- /dev/null
+++ b/src/test/java/com/sniptext/domain/template/controller/TemplateListControllerTest.java
@@ -0,0 +1,250 @@
+package com.sniptext.domain.template.controller;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.hamcrest.Matchers.contains;
+import static org.hamcrest.Matchers.empty;
+import static org.hamcrest.Matchers.nullValue;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+import java.nio.charset.StandardCharsets;
+import java.time.LocalDateTime;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.context.annotation.Import;
+import org.springframework.http.HttpHeaders;
+import org.springframework.test.util.ReflectionTestUtils;
+import org.springframework.test.web.servlet.MvcResult;
+import org.springframework.test.web.servlet.ResultActions;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.sniptext.domain.template.entity.Shortcut;
+import com.sniptext.domain.template.entity.Template;
+import com.sniptext.domain.template.entity.TemplateContent;
+import com.sniptext.domain.template.entity.TemplateTitle;
+import com.sniptext.domain.template.repository.TemplateRepository;
+import com.sniptext.domain.user.entity.User;
+import com.sniptext.fixture.TemplateFixture;
+import com.sniptext.fixture.UserFixture;
+import com.sniptext.support.IntegrationTestSupport;
+import com.sniptext.support.MutableClock;
+import com.sniptext.support.MutableClockConfiguration;
+
+import jakarta.persistence.EntityManager;
+import tools.jackson.databind.JsonNode;
+import tools.jackson.databind.json.JsonMapper;
+
+/** 명세 8번. 범위·정렬·응답 형식을 실제 필터·MySQL까지 거쳐 확인한다. */
+@Transactional
+@Import(MutableClockConfiguration.class)
+class TemplateListControllerTest extends IntegrationTestSupport {
+
+	private static final String PATH = "/api/v1/templates";
+	private static final String NO_STORE = "no-store";
+	private static final LocalDateTime FIXED = LocalDateTime.of(2026, 10, 7, 10, 30);
+	private static final String CONTENT = "{{금액}}원입니다.\n{{고객명}}님, {{금액}}원을 확인해주세요.";
+
+	@Autowired
+	private TemplateRepository templateRepository;
+
+	@Autowired
+	private EntityManager entityManager;
+
+	@Autowired
+	private MutableClock clock;
+
+	@Autowired
+	private JsonMapper jsonMapper;
+
+	private Long userId;
+	private Long otherUserId;
+
+	@BeforeEach
+	void setUp() {
+		clock.setTo(FIXED);
+		userId = saveUser("owner@sniptext.com");
+		otherUserId = saveUser("other@sniptext.com");
+	}
+
+	@Test
+	@DisplayName("목록을 조회하면 200, 명세 순서의 필드와 +09:00이 붙은 시각, 캐시 금지 헤더")
+	void getTemplates() throws Exception {
+		Template template = templateRepository.saveAndFlush(TemplateFixture.template(userId, "/Quote"));
+		template.edit(TemplateTitle.create("프로젝트 견적 안내"), Shortcut.create("/Quote"), TemplateContent.create(CONTENT),
+			FIXED.plusHours(1));
+		template.markUsed(FIXED.plusHours(2));
+		flushAndClear();
+
+		MvcResult result = getAs(userId)
+			.andExpect(status().isOk())
+			.andExpect(header().string(HttpHeaders.CACHE_CONTROL, NO_STORE))
+			.andExpect(jsonPath("$.isSuccess").value(true))
+			.andExpect(jsonPath("$.code").value("TEMPLATE200_1"))
+			.andExpect(jsonPath("$.message").value("템플릿 목록 조회에 성공했습니다."))
+			.andExpect(jsonPath("$.result.totalCount").value(1))
+			.andExpect(jsonPath("$.result.templates[0].templateId").value(template.getId()))
+			.andExpect(jsonPath("$.result.templates[0].title").value("프로젝트 견적 안내"))
+			.andExpect(jsonPath("$.result.templates[0].shortcut").value("/Quote"))
+			.andExpect(jsonPath("$.result.templates[0].lastUsedAt").value("2026-10-07T12:30:00+09:00"))
+			.andExpect(jsonPath("$.result.templates[0].createdAt").value("2026-10-07T10:30:00+09:00"))
+			.andExpect(jsonPath("$.result.templates[0].editedAt").value("2026-10-07T11:30:00+09:00"))
+			.andReturn();
+
+		JsonNode body = jsonMapper.readTree(result.getResponse().getContentAsString(StandardCharsets.UTF_8));
+		assertThat(body.get("result").propertyNames()).containsExactly("totalCount", "templates");
+		assertThat(body.get("result").get("templates").get(0).propertyNames())
+			.containsExactly("templateId", "title", "shortcut", "content", "variables", "lastUsedAt", "createdAt",
+				"editedAt");
+	}
+
+	@Test
+	@DisplayName("생성 순(템플릿 ID 오름차순)으로 내려주고, 새 템플릿은 맨 뒤에 붙는다")
+	void createdOrder() throws Exception {
+		Long first = save(userId, "/첫째");
+		Long second = save(userId, "/둘째");
+		Long third = save(userId, "/셋째");
+		flushAndClear();
+
+		expectOrder(first, second, third);
+
+		Long newest = save(userId, "/넷째");
+		flushAndClear();
+
+		expectOrder(first, second, third, newest);
+	}
+
+	@Test
+	@DisplayName("수정·사용 기록으로 시각이 바뀌어도 순서는 그대로다")
+	void orderIgnoresEditAndUse() throws Exception {
+		Long first = save(userId, "/첫째");
+		Long second = save(userId, "/둘째");
+		Long third = save(userId, "/셋째");
+		// 가운데를 고치고 셋째를 써서, 최근 수정순·오래된 수정순·최근 사용순 어느 쪽이어도 순서가 달라지게 한다
+		clock.setTo(FIXED.plusHours(1));
+		templateRepository.findById(second).orElseThrow().edit(TemplateTitle.create("고친 이름"),
+			Shortcut.create("/둘째"), TemplateContent.create(CONTENT), FIXED.plusHours(1));
+		templateRepository.findById(third).orElseThrow().markUsed(FIXED.plusHours(2));
+		flushAndClear();
+
+		expectOrder(first, second, third);
+	}
+
+	@Test
+	@DisplayName("휴지통에서 되돌린 템플릿은 원래 자리로 돌아온다")
+	void restoredTemplateBackInPlace() throws Exception {
+		Long first = save(userId, "/첫째");
+		Template middle = templateRepository.saveAndFlush(TemplateFixture.trashedTemplate(userId, "/가운데", FIXED));
+		Long third = save(userId, "/셋째");
+		flushAndClear();
+
+		expectOrder(first, third);
+
+		// 16번 복구 API가 아직 없어 휴지통 표시만 지운다. 복구는 생성 시각·ID를 바꾸지 않는다
+		Template trashed = templateRepository.findById(middle.getId()).orElseThrow();
+		ReflectionTestUtils.setField(trashed, "deletedAt", null);
+		flushAndClear();
+
+		expectOrder(first, middle.getId(), third);
+	}
+
+	@Test
+	@DisplayName("휴지통과 다른 회원의 템플릿은 빠진다")
+	void excludesTrashAndOthers() throws Exception {
+		Long mine = save(userId, "/내것");
+		templateRepository.saveAndFlush(TemplateFixture.trashedTemplate(userId, "/삭제", FIXED));
+		save(otherUserId, "/남의것");
+		flushAndClear();
+
+		getAs(userId)
+			.andExpect(status().isOk())
+			.andExpect(jsonPath("$.result.totalCount").value(1))
+			.andExpect(jsonPath("$.result.templates[*].templateId", contains(mine.intValue())));
+	}
+
+	@Test
+	@DisplayName("템플릿이 없으면 totalCount 0과 빈 배열")
+	void noTemplates() throws Exception {
+		templateRepository.saveAndFlush(TemplateFixture.trashedTemplate(userId, "/삭제", FIXED));
+		save(otherUserId, "/남의것");
+		flushAndClear();
+
+		getAs(userId)
+			.andExpect(status().isOk())
+			.andExpect(jsonPath("$.code").value("TEMPLATE200_1"))
+			.andExpect(jsonPath("$.result.totalCount").value(0))
+			.andExpect(jsonPath("$.result.templates", empty()));
+	}
+
+	@Test
+	@DisplayName("본문은 복호화해 내려주고, 변수 목록은 그 본문에서 첫 등장 순으로 중복 없이 뽑는다")
+	void contentAndVariables() throws Exception {
+		templateRepository.saveAndFlush(TemplateFixture.templateWithContent(userId, CONTENT));
+		flushAndClear();
+
+		getAs(userId)
+			.andExpect(status().isOk())
+			.andExpect(jsonPath("$.result.templates[0].content").value(CONTENT))
+			.andExpect(jsonPath("$.result.templates[0].variables", contains("금액", "고객명")));
+	}
+
+	@Test
+	@DisplayName("사용 이력이 없으면 lastUsedAt은 null이다")
+	void neverUsed() throws Exception {
+		save(userId, "/견적");
+		flushAndClear();
+
+		getAs(userId)
+			.andExpect(status().isOk())
+			.andExpect(jsonPath("$.result.templates[0].lastUsedAt").value(nullValue()));
+	}
+
+	@Test
+	@DisplayName("토큰이 없으면 COMMON401_1, 캐시 금지")
+	void unauthenticated() throws Exception {
+		mockMvc.perform(get(PATH))
+			.andExpect(status().isUnauthorized())
+			.andExpect(header().string(HttpHeaders.CACHE_CONTROL, NO_STORE))
+			.andExpect(jsonPath("$.isSuccess").value(false))
+			.andExpect(jsonPath("$.code").value("COMMON401_1"))
+			.andExpect(jsonPath("$.message").value("로그인이 필요해요."))
+			.andExpect(jsonPath("$.result").isEmpty());
+	}
+
+	private void expectOrder(Long... templateIds) throws Exception {
+		Integer[] expected = new Integer[templateIds.length];
+		for (int i = 0; i < templateIds.length; i++) {
+			expected[i] = templateIds[i].intValue();
+		}
+		getAs(userId)
+			.andExpect(status().isOk())
+			.andExpect(jsonPath("$.result.totalCount").value(templateIds.length))
+			.andExpect(jsonPath("$.result.templates[*].templateId", contains(expected)));
+	}
+
+	private ResultActions getAs(Long userId) throws Exception {
+		return mockMvc.perform(get(PATH).header(HttpHeaders.AUTHORIZATION, bearer(userId)));
+	}
+
+	private Long save(Long ownerId, String shortcut) {
+		return templateRepository.saveAndFlush(TemplateFixture.template(ownerId, shortcut)).getId();
+	}
+
+	/** 1차 캐시를 비워 응답이 DB에서 다시 읽은(복호화한) 값으로 만들어지게 한다 */
+	private void flushAndClear() {
+		entityManager.flush();
+		entityManager.clear();
+	}
+
+	private Long saveUser(String email) {
+		User user = UserFixture.user(email);
+		entityManager.persist(user);
+		entityManager.flush();
+		return user.getId();
+	}
+
+}

From 5424ad3cbcdd4a5e5318486e494f25b79378b101 Mon Sep 17 00:00:00 2001
From: oTAETAEo <ggg7515@naver.com>
Date: Thu, 5 Nov 2026 13:11:25 +0900
Subject: [PATCH 4/5] =?UTF-8?q?refactor:=20=EB=82=B4=20=ED=85=9C=ED=94=8C?=
 =?UTF-8?q?=EB=A6=BF=20=EB=AA=A9=EB=A1=9D=20=EC=BB=A8=ED=8A=B8=EB=A1=A4?=
 =?UTF-8?q?=EB=9F=AC=EC=9D=98=20=EC=84=9C=EB=B9=84=EC=8A=A4=20=ED=98=B8?=
 =?UTF-8?q?=EC=B6=9C=EC=9D=84=20=EB=B3=80=EC=88=98=EB=A1=9C=20=EB=B6=84?=
 =?UTF-8?q?=EB=A6=AC=20(#66)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../domain/template/controller/TemplateController.java      | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/main/java/com/sniptext/domain/template/controller/TemplateController.java b/src/main/java/com/sniptext/domain/template/controller/TemplateController.java
index fbd6fe7..9da8b0c 100644
--- a/src/main/java/com/sniptext/domain/template/controller/TemplateController.java
+++ b/src/main/java/com/sniptext/domain/template/controller/TemplateController.java
@@ -20,6 +20,7 @@
 import com.sniptext.domain.template.service.dto.query.TemplateDetailQuery;
 import com.sniptext.domain.template.service.dto.result.TemplateCreateResult;
 import com.sniptext.domain.template.service.dto.result.TemplateDetailResult;
+import com.sniptext.domain.template.service.dto.result.TemplateListResult;
 import com.sniptext.domain.template.service.dto.result.TemplateUpdateResult;
 import com.sniptext.global.response.ApiResponse;
 import com.sniptext.global.security.LoginUser;
@@ -40,8 +41,9 @@ public class TemplateController {
 
 	@GetMapping
 	public ResponseEntity<ApiResponse<TemplateListResponse>> getTemplates(@LoginUser Long userId) {
-		return ApiResponse.success(TemplateSuccessCode.TEMPLATE_LIST_FOUND,
-			TemplateListResponse.from(templateQueryService.getTemplates(userId)));
+		TemplateListResult result = templateQueryService.getTemplates(userId);
+
+		return ApiResponse.success(TemplateSuccessCode.TEMPLATE_LIST_FOUND, TemplateListResponse.from(result));
 	}
 
 	@GetMapping("/{templateId}")

From 4a266a8680d00888fc54ba73f6e97b5756b4362e Mon Sep 17 00:00:00 2001
From: oTAETAEo <ggg7515@naver.com>
Date: Sat, 7 Nov 2026 13:21:09 +0900
Subject: [PATCH 5/5] =?UTF-8?q?test:=20=EB=B3=B5=EA=B5=AC=ED=95=9C=20?=
 =?UTF-8?q?=ED=85=9C=ED=94=8C=EB=A6=BF=EC=9D=98=20=EB=AA=A9=EB=A1=9D=20?=
 =?UTF-8?q?=EC=9C=84=EC=B9=98=EB=A5=BC=20=EC=8B=A4=EC=A0=9C=20=EB=B3=B5?=
 =?UTF-8?q?=EA=B5=AC=20API=EB=A1=9C=20=EA=B2=80=EC=A6=9D=20(#66)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../template/controller/TemplateListControllerTest.java  | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/src/test/java/com/sniptext/domain/template/controller/TemplateListControllerTest.java b/src/test/java/com/sniptext/domain/template/controller/TemplateListControllerTest.java
index d5f8544..6b01d9b 100644
--- a/src/test/java/com/sniptext/domain/template/controller/TemplateListControllerTest.java
+++ b/src/test/java/com/sniptext/domain/template/controller/TemplateListControllerTest.java
@@ -5,6 +5,7 @@
 import static org.hamcrest.Matchers.empty;
 import static org.hamcrest.Matchers.nullValue;
 import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
@@ -18,7 +19,6 @@
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.context.annotation.Import;
 import org.springframework.http.HttpHeaders;
-import org.springframework.test.util.ReflectionTestUtils;
 import org.springframework.test.web.servlet.MvcResult;
 import org.springframework.test.web.servlet.ResultActions;
 import org.springframework.transaction.annotation.Transactional;
@@ -45,6 +45,7 @@
 class TemplateListControllerTest extends IntegrationTestSupport {
 
 	private static final String PATH = "/api/v1/templates";
+	private static final String RESTORE_PATH = "/api/v1/trash/templates/{templateId}/restore";
 	private static final String NO_STORE = "no-store";
 	private static final LocalDateTime FIXED = LocalDateTime.of(2026, 10, 7, 10, 30);
 	private static final String CONTENT = "{{금액}}원입니다.\n{{고객명}}님, {{금액}}원을 확인해주세요.";
@@ -144,9 +145,9 @@ void restoredTemplateBackInPlace() throws Exception {
 
 		expectOrder(first, third);
 
-		// 16번 복구 API가 아직 없어 휴지통 표시만 지운다. 복구는 생성 시각·ID를 바꾸지 않는다
-		Template trashed = templateRepository.findById(middle.getId()).orElseThrow();
-		ReflectionTestUtils.setField(trashed, "deletedAt", null);
+		mockMvc.perform(post(RESTORE_PATH, middle.getId()).header(HttpHeaders.AUTHORIZATION, bearer(userId)))
+			.andExpect(status().isOk())
+			.andExpect(jsonPath("$.code").value("TRASH200_2"));
 		flushAndClear();
 
 		expectOrder(first, middle.getId(), third);