← 전체 프로젝트
14

백엔드 기반 · NestJS

NestTemplate

NestJS에서 반복되는 설정, 에러 처리, 스토리지·메일 기능을 공통 패키지와 생성 템플릿으로 정리했습니다.

기반·생성 템플릿 구현 / 실제 소비자 인수 대기
기간
2026 — 현재
역할
백엔드 기반 설계

PROJECT / DECISION RECORD

문제에서 구현까지

  1. 01문제

    프로젝트마다 인증·설정·에러·저장소 기능을 복제하면 유지보수 경계가 흐려집니다.

  2. 02설계 선택

    Nest 고유 계약과 외부 생성기를 분리하고, 실제 소비자가 검증한 공통 기능만 채택합니다.

  3. 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 및 생성 템플릿의 구현·집중 테스트 상태를 확인했습니다.

결과와 현재 상태

패키지 설치·소비 테스트를 수행했습니다. 실제 서비스에 적용한 결과에 대한 인수는 아직 완료되지 않았습니다.

현재 상태기반·생성 템플릿 구현 / 실제 소비자 인수 대기

함께 보는 프로젝트