14
백엔드 기반 · NestJS
NestTemplate
NestJS에서 반복되는 설정, 에러 처리, 스토리지·메일 기능을 공통 패키지와 생성 템플릿으로 정리했습니다.
기반·생성 템플릿 구현 / 실제 소비자 인수 대기
- 기간
- 2026 — 현재
- 역할
- 백엔드 기반 설계
PROJECT / DECISION RECORD
문제에서 구현까지
- 01문제
프로젝트마다 인증·설정·에러·저장소 기능을 복제하면 유지보수 경계가 흐려집니다.
- 02설계 선택
Nest 고유 계약과 외부 생성기를 분리하고, 실제 소비자가 검증한 공통 기능만 채택합니다.
- 03구현·진행
nest-foundation 패키지와 nest-app/resource/upload 생성 템플릿을 구현·집중 검증했습니다.
문제
14프로젝트마다 인증·설정·에러·저장소 기능을 복제하면 유지보수 경계가 흐려집니다.
제약
- 범용 언어 프레임워크가 아니라 NestJS 전용이며 파일 적용 실행은 Source Materializer에 위임합니다.
- NestJS 고유 기능을 다른 언어·프레임워크의 공통 모듈이라고 주장하지 않습니다.
- 패키지 테스트 성공과 실제 서비스에서 검증된 재사용 기능은 구분합니다.
설계와 결정
- Nest 고유 계약과 외부 생성기를 분리하고, 실제 소비자가 검증한 공통 기능만 채택합니다.
- 에러·환경설정·스토리지·메일·페이지네이션·암호화 기능을 foundation 패키지로 구성했습니다.
- 앱·리소스·업로드 템플릿의 파일 생성은 별도 Source Materializer가 담당하게 했습니다.
구현
- nest-foundation 패키지와 nest-app/resource/upload 생성 템플릿을 구현·집중 검증했습니다.
- 패키지 tarball 소비 테스트와 생성 템플릿 결과물의 집중 검증 근거가 있습니다.
- capability 후보는 구현돼 있어도 실제 소비자 확인 전에는 승인 완료로 표시하지 않습니다.
검증과 근거
소스 근거직접 확인
README 구현 자산 표에서 nest-foundation 및 생성 템플릿의 구현·집중 테스트 상태를 확인했습니다.
결과와 현재 상태
패키지 설치·소비 테스트를 수행했습니다. 실제 서비스에 적용한 결과에 대한 인수는 아직 완료되지 않았습니다.
현재 상태기반·생성 템플릿 구현 / 실제 소비자 인수 대기