Spring Boot + Thymeleaf 셸 + Vue island — 동적 화면을 서버 템플릿에 하드코딩하지 말 것
## 구조
예약·게시판 같은 서비스에서 우리가 반복해 쓰는 구성은 다음과 같다.
| 계층 | 역할 |
|---|---|
| Spring Boot | API, 인증, 세션, 데이터 |
| Thymeleaf | **공통 레이아웃(셸)만** — 헤더, 푸터, 메타 태그 |
| Vue 3 (Vite) island | 목록·폼·미디어 갤러리 같은 **동적 화면** |
순수 서버 렌더링(SSR) 앱이 아니다. 화면의 동적 부분은 셸 안에 마운트되는 Vue 컴포넌트가 데이터를 받아 그린다.
## 반복된 실수
서버 템플릿에서 `th:each` 로 목록을 직접 그려 버리는 실수가 **같은 프로젝트에서 두 번** 났다(미디어 게시판 등). 처음에는 빠르게 동작하지만 이후 다음 문제가 생긴다.
- 페이징·정렬·검색이 페이지 이동이 되어, 이미 있는 Vue 화면과 동작이 **둘로 갈라진다.**
- 같은 데이터를 보여 주는 화면이 두 구현으로 유지보수된다.
- 캐시·접근성·모바일 동작이 화면마다 달라진다.
## 규칙으로 고정
- 새 동적 화면을 만들기 전에 "이건 island 인가 셸인가"를 먼저 정한다.
- 서버 템플릿에는 **반복·조건 분기로 데이터를 그리는 코드를 넣지 않는다.** 필요한 초기값은 JSON 으로 내려 주고 island 가 읽는다.
- 프로젝트 문서의 맨 위에 이 규칙을 두고, 위반이 발견되면 그 자리에서 island 로 옮긴다.
## 교훈
"한 번만 빠르게"는 규칙이 없으면 반복된다. 아키텍처의 경계는 코드 리뷰가 아니라 **문서의 첫 줄**에 있어야 지켜진다.
게시글 목록
| 제목 | 작성일 | 조회 |
|---|---|---|
| 자체 개발 웹 엔진 nginx-drsoft로 수백 개 도메인 무중단 운영하기 | 264 | |
| Redis Cluster를 활용한 멀티테넌트 환경 세션 관리 시스템 구축 사례 | 83 |