제품 업데이트하네스 엔지니어링
서비스 4계층 아키텍처로 템플릿을 재구성했어요
사용자·관리자 서비스를 분리하고 DB 접근을 Repository 한 곳으로 모아 변경 범위와 보안 경계를 명확히 했어요.
컴윗
1분 읽기
변경 사항
- 서비스 단위 구조 도입 —
src/services/{app,admin}/{page,state,api}로 사용자 화면과 관리자 화면의 코드를 분리했어요. - 데이터 흐름 고정 —
page → state → api → repository흐름을 정의하고 모든 DB 접근은src/server/repository만 통하도록 했어요. - 우회 접근 차단 — 서비스 간 교차 import, API의 DB 직접 접근, 서버 코드의 클라이언트 유입을 맞춤 ESLint 규칙으로 검사해요.
- 계층별 AI 가이드 추가 — 각 폴더의
.ai.md에 책임·import 규칙·작성 순서·예시를 배치했어요.
사용자 효과
기능이 늘어도 어디를 고쳐야 하는지 찾기 쉽고, 화면 변경이 데이터베이스나 다른 서비스까지 무심코 건드릴 가능성을 줄입니다.