model.service.ts

service 파일은 비즈니스 로직의 핵심입니다. 복잡한 작업을 처리하고, 서로 다른 모듈 간을 조정하며, 원자적 데이터 일관성을 보장합니다.

🧠비즈니스 로직

유효성 검사, 계산, 의사 결정 로직이 데이터 정의와 분리되어 이곳에 존재합니다.

Service 클래스 구조

서비스는 serve() 함수를 사용하여 정의되며, 이 함수는 데이터베이스 모델을 바인딩하고 콜백을 통해 의존성 주입을 허용합니다.

product.service.ts

메서드 및 변수

serve() 함수는 클래스에 CRUD 메서드와 기본 모델에 대한 접근 권한을 자동으로 장착합니다.

1.1. Predefined Variables

field	설명	예제
<MODEL_NAME>Model	model.document.ts에서 선언된 데이터베이스 모델 인스턴스
logger	stdout 로깅을 위한 내장 로거 모듈

<MODEL_NAME>Model

model.document.ts에서 선언된 데이터베이스 모델 인스턴스

logger

stdout 로깅을 위한 내장 로거 모듈

1.2. Predefined Methods (CRUD)

method	설명	예제
getProduct(id: string)	ID로 문서를 불러옵니다. 없으면 에러를 반환합니다.
loadProduct(id?: string)	ID로 문서를 불러옵니다. 없으면 null을 반환합니다.
loadProductMany(ids: string[])	ID 배열로 문서를 일괄 로드합니다. 문서 또는 null 배열을 반환합니다.
createProduct(data: db.ProductInput)	입력 데이터로 새 문서를 생성합니다.
updateProduct(id: string, data: Partial<db.Product>)	ID로 문서를 업데이트합니다. 업데이트된 문서를 반환합니다.
removeProduct(id: string)	ID로 문서를 소프트 삭제합니다. 상태를 'archived'로 설정합니다.
searchProduct(searchText: string, queryOption?: ListQueryOption)	텍스트로 문서를 검색합니다. 문서 목록과 개수를 반환합니다.
searchDocsProduct(searchText: string, queryOption?: ListQueryOption)	텍스트로 문서를 검색합니다. 문서 목록만 반환합니다.
searchCountProduct(searchText: string)	검색 텍스트와 일치하는 문서 수를 셉니다.

getProduct(id: string)

ID로 문서를 불러옵니다. 없으면 에러를 반환합니다.

loadProduct(id?: string)

ID로 문서를 불러옵니다. 없으면 null을 반환합니다.

loadProductMany(ids: string[])

ID 배열로 문서를 일괄 로드합니다. 문서 또는 null 배열을 반환합니다.

1.3. Query Based Methods

model.document.ts의 'Filter' 정의에서 생성된 메서드들입니다.

method	설명	예제
list<Query>(...args, option?)	정의된 쿼리와 일치하는 문서를 나열합니다.
listIds<Query>(...args, option?)	정의된 쿼리와 일치하는 문서 ID를 나열합니다.
find<Query>(...args, option?)	정의된 쿼리와 일치하는 단일 문서를 찾습니다.
findId<Query>(...args, option?)	정의된 쿼리와 일치하는 단일 문서 ID를 찾습니다.
pick<Query>(...args, option?)	정의된 쿼리와 일치하는 단일 문서를 찾습니다. 없으면 에러를 던집니다.
pickId<Query>(...args, option?)	정의된 쿼리와 일치하는 단일 문서 ID를 찾습니다. 없으면 에러를 던집니다.
exists<Query>(...args)	정의된 쿼리와 일치하는 문서가 존재하는지 확인합니다. ID 또는 null을 반환합니다.
count<Query>(...args)	정의된 쿼리와 일치하는 만서 수를 셉니다.
insight<Query>(...args)	정의된 쿼리와 일치하는 집계 통계를 가져옵니다.
query<Query>(...args)	Filter에 정의된 원시 쿼리 객체를 가져옵니다.

list<Query>(...args, option?)

정의된 쿼리와 일치하는 문서를 나열합니다.

listIds<Query>(...args, option?)

정의된 쿼리와 일치하는 문서 ID를 나열합니다.

find<Query>(...args, option?)

정의된 쿼리와 일치하는 단일 문서를 찾습니다.

미들웨어 메서드

데이터 생성 과정에 개입하기 위해 특정 미들웨어 메서드를 재정의할 수 있습니다.

method	설명	예제
_preCreate(data)	생성 전에 호출되는 훅입니다. 수정된 데이터를 반환하세요.
_postCreate(doc)	생성 후에 호출되는 훅입니다. 수정된 문서를 반환하세요.
_preUpdate(id, data)	업데이트 전에 호출되는 훅입니다.
_postUpdate(doc)	업데이트 후에 호출되는 훅입니다.
_preRemove(id)	삭제 전에 호출되는 훅입니다.
_postRemove(doc)	삭제 후에 호출되는 훅입니다.
listenPre(type, listener)	동적 pre-hook 리스너를 등록합니다.
listenPost(type, listener)	동적 post-hook 리스너를 등록합니다.

_preCreate(data)

생성 전에 호출되는 훅입니다. 수정된 데이터를 반환하세요.

_postCreate(doc)

생성 후에 호출되는 훅입니다. 수정된 문서를 반환하세요.

_preUpdate(id, data)

업데이트 전에 호출되는 훅입니다.

_postUpdate(doc)

의존성 주입

의존성은 serve()의 콜백 함수를 통해 주입됩니다. 이는 타입 안전성을 보장하고 순환 의존성 문제를 방지합니다.

3.1. Supported Injections

method	설명	예제
service<T>()	다른 서비스를 주입합니다.
use<T>()	외부 클래스나 변수를 주입합니다.
env<T>(key, factory?)	환경 변수를 주입합니다. 없으면 에러를 발생시킵니다.
envOptional<T>(key, factory?)	환경 변수를 안전하게 주입합니다. 없으면 undefined를 반환합니다.
generate<T>(factory)	환경에 따라 값을 동적으로 생성합니다.
signal<T>()	시그널(웹소켓/큐) 모듈을 주입합니다.

service<T>()

다른 서비스를 주입합니다.

use<T>()

외부 클래스나 변수를 주입합니다.

env<T>(key, factory?)

환경 변수를 주입합니다. 없으면 에러를 발생시킵니다.

envOptional<T>(key, factory?)

환경 변수를 안전하게 주입합니다. 없으면 undefined를 반환합니다.

Service 모범 사례

1️⃣Document는 순수하게

단순한 상태 변경은 Document 메서드에 둡니다. 다른 서비스가 포함된 복잡한 로직은 Service 메서드에 둡니다.

2️⃣자동 생성 메서드 활용

원시 DB 쿼리보다 자동 생성된 list/find 메서드를 선호하세요. 일관성과 타입 안전성을 유지합니다.

field

설명

예제

<MODEL_NAME>Model

model.document.ts에서 선언된 데이터베이스 모델 인스턴스

logger

stdout 로깅을 위한 내장 로거 모듈

method

설명

예제

getProduct(id: string)

ID로 문서를 불러옵니다. 없으면 에러를 반환합니다.

loadProduct(id?: string)

ID로 문서를 불러옵니다. 없으면 null을 반환합니다.

loadProductMany(ids: string[])

ID 배열로 문서를 일괄 로드합니다. 문서 또는 null 배열을 반환합니다.

createProduct(data: db.ProductInput)

입력 데이터로 새 문서를 생성합니다.

updateProduct(id: string, data: Partial<db.Product>)

ID로 문서를 업데이트합니다. 업데이트된 문서를 반환합니다.

removeProduct(id: string)

ID로 문서를 소프트 삭제합니다. 상태를 'archived'로 설정합니다.

searchProduct(searchText: string, queryOption?: ListQueryOption)

텍스트로 문서를 검색합니다. 문서 목록과 개수를 반환합니다.

searchDocsProduct(searchText: string, queryOption?: ListQueryOption)

텍스트로 문서를 검색합니다. 문서 목록만 반환합니다.

searchCountProduct(searchText: string)

검색 텍스트와 일치하는 문서 수를 셉니다.

method

설명

예제

list<Query>(...args, option?)

정의된 쿼리와 일치하는 문서를 나열합니다.

listIds<Query>(...args, option?)

정의된 쿼리와 일치하는 문서 ID를 나열합니다.

find<Query>(...args, option?)

정의된 쿼리와 일치하는 단일 문서를 찾습니다.

findId<Query>(...args, option?)

정의된 쿼리와 일치하는 단일 문서 ID를 찾습니다.

pick<Query>(...args, option?)

정의된 쿼리와 일치하는 단일 문서를 찾습니다. 없으면 에러를 던집니다.

pickId<Query>(...args, option?)

정의된 쿼리와 일치하는 단일 문서 ID를 찾습니다. 없으면 에러를 던집니다.

exists<Query>(...args)

정의된 쿼리와 일치하는 문서가 존재하는지 확인합니다. ID 또는 null을 반환합니다.

count<Query>(...args)

정의된 쿼리와 일치하는 만서 수를 셉니다.

insight<Query>(...args)

정의된 쿼리와 일치하는 집계 통계를 가져옵니다.

query<Query>(...args)

Filter에 정의된 원시 쿼리 객체를 가져옵니다.

method

설명

예제

_preCreate(data)

생성 전에 호출되는 훅입니다. 수정된 데이터를 반환하세요.

_postCreate(doc)

생성 후에 호출되는 훅입니다. 수정된 문서를 반환하세요.

_preUpdate(id, data)

업데이트 전에 호출되는 훅입니다.

_postUpdate(doc)

업데이트 후에 호출되는 훅입니다.

_preRemove(id)

삭제 전에 호출되는 훅입니다.

_postRemove(doc)

삭제 후에 호출되는 훅입니다.

listenPre(type, listener)

동적 pre-hook 리스너를 등록합니다.

listenPost(type, listener)

동적 post-hook 리스너를 등록합니다.

method

설명

예제

service<T>()

다른 서비스를 주입합니다.

use<T>()

외부 클래스나 변수를 주입합니다.

env<T>(key, factory?)

환경 변수를 주입합니다. 없으면 에러를 발생시킵니다.

envOptional<T>(key, factory?)

환경 변수를 안전하게 주입합니다. 없으면 undefined를 반환합니다.

generate<T>(factory)

환경에 따라 값을 동적으로 생성합니다.

signal<T>()

시그널(웹소켓/큐) 모듈을 주입합니다.