generated from ttipo/project-base
ttipo
08cf31fbe6
계약 3절. 내 주소록은 엔진의 JMAP Contacts(직원마다 기본 주소록)에, 사내 목록은 엔진 계정 목록을 사내 목록 계정으로만 읽는다. 엔진 검색은 낱말 단위이고 이름 정렬을 못 해서, 직원마다 주소록을 엔진 state 로 확인하는 캐시에 두고 서버가 찾고(초성 · 전화 숫자) 정렬한다. 쓰기는 직원마다 차례로 · ifInState 로 하고, 어긋나거나 엔진이 잠깐 거절하면 다시 읽어 세 번까지. 리뷰로 고친 것: - 전화번호 정규식이 입력 길이의 제곱이었다(1MB 본문 하나로 약 24분 CPU) — 정규식을 나누고, DTO 검사를 applyDecorators 로 묶어 형식 → 길이 → 모양 차례로 돌린다. - 고치기는 PATCH(보낸 칸만 검사) — 칸 안의 남의 속성(label · contexts · fax · pref · role · 둘째 조직)은 지금 카드와 합쳐 지킨다(CardDAV 와 함께 쓰려고). - [되돌리기]는 지우기 직전에 읽은 카드 전체를 5분 기억했다가 같은 uid 로 다시 만든다(되돌리기 표 — 우리 규칙 밖의 값 · 다른 프로그램의 칸도 그대로). - 큰 주소록이 캐시에 들지 못해 요청마다 엔진을 통째로 다시 읽었다 — 크기 한도 800만을 쓰기에 걸고 캐시의 한 사람 상한과 맞췄다. - 받는 사람 추천의 q 를 화면과 같은 맞추기(초성 · 조합 중 글자)로 — 주소록이 크면 미리 받은 100줄이 주소록으로 차서 사내 · 최근 주소의 초성 찾기가 사라졌다. - excludeGroupId · 사내 항목 하나 · q 254자, 판은 읽기 전에 물은 것으로, 한글 이름 조각은 붙여 잇는다. 에러 코드 CONTACT_001(같은 이름 그룹) · CONTACT_002(주소록 한도)를 더하고 클라이언트 사전을 생성했다. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
91 lines
3.9 KiB
TypeScript
91 lines
3.9 KiB
TypeScript
import { Module } from '@nestjs/common';
|
|
import { TypeOrmModule } from '@nestjs/typeorm';
|
|
import { ConfigModule } from '@nestjs/config';
|
|
import { ScheduleModule } from '@nestjs/schedule';
|
|
import { ThrottlerModule } from '@nestjs/throttler';
|
|
import { CacheModule } from '@nestjs/cache-manager';
|
|
import { APP_GUARD } from '@nestjs/core';
|
|
|
|
import { ClientIpThrottlerGuard } from '@/common/guards/client-ip-throttler.guard';
|
|
import { OriginGuard } from '@/common/guards/origin.guard';
|
|
import { AuthModule } from '@/modules/auth/auth.module';
|
|
import { ContactsModule } from '@/modules/contacts/contacts.module';
|
|
import { HealthModule } from '@/modules/health/health.module';
|
|
import { MailModule } from '@/modules/mail/mail.module';
|
|
import { UploadModule } from '@/modules/upload/upload.module';
|
|
import { UserModule } from '@/modules/user/user.module';
|
|
import { parsePositiveInt } from '@/shared/utils/env';
|
|
import { buildDatabaseOptions } from '@/shared/config/database.config';
|
|
import { validateEnv } from '@/shared/config/env.validation';
|
|
import { ShutdownLogger } from '@/shared/logger/shutdown.logger';
|
|
|
|
// Rate Limiting 기본 정책 — 루트 .env 의 THROTTLE_* 로 덮어쓸 수 있다 (.claude/rules/env-structure.md)
|
|
const THROTTLE_DEFAULT_TTL_MS = 60_000; // 집계 구간: 60초
|
|
const THROTTLE_DEFAULT_LIMIT = 100; // 구간당 IP별 최대 요청 수
|
|
|
|
@Module({
|
|
imports: [
|
|
ScheduleModule.forRoot(),
|
|
ConfigModule.forRoot({
|
|
isGlobal: true,
|
|
envFilePath: `.env.${process.env.NODE_ENV || 'development'}`,
|
|
// 설정이 잘못되면 조용히 기본값으로 굴러가지 않고 기동 시점에 실패시킨다
|
|
validate: validateEnv,
|
|
}),
|
|
// 전역 캐시 매니저 — Redis 도입 시 store 옵션을 redisStore 로 변경
|
|
CacheModule.register({
|
|
isGlobal: true,
|
|
ttl: 60_000, // 60초 기본 TTL
|
|
}),
|
|
// 전역 Rate Limiter — API 남용/브루트포스 방지 (프로젝트의 유일한 rate limiting 수단)
|
|
// 한도 초과 시 429 → 전역 필터가 REQ_001 로 매핑한다.
|
|
// 라우트 단위 조정은 @Throttle({ default: { ttl, limit } }), 제외는 @SkipThrottle().
|
|
ThrottlerModule.forRoot([
|
|
{
|
|
// compose 가 미정의 변수를 빈 문자열로 주입하므로 parsePositiveInt 로 방어한다
|
|
ttl: parsePositiveInt(
|
|
process.env.THROTTLE_TTL_MS,
|
|
THROTTLE_DEFAULT_TTL_MS,
|
|
),
|
|
limit: parsePositiveInt(
|
|
process.env.THROTTLE_LIMIT,
|
|
THROTTLE_DEFAULT_LIMIT,
|
|
),
|
|
},
|
|
]),
|
|
// DB 접속 설정은 database.config.ts 하나만 수정한다 (CLI 와 공유)
|
|
TypeOrmModule.forRootAsync({
|
|
useFactory: () => ({
|
|
...buildDatabaseOptions(),
|
|
// Nest 모듈에 등록된 엔티티를 자동으로 수집한다 (CLI 는 glob 경로를 사용)
|
|
autoLoadEntities: true,
|
|
}),
|
|
}),
|
|
HealthModule,
|
|
// 직원 로그인(쿠키 JWT) — 자격 확인은 MailModule 의 메일 엔진 포트로
|
|
AuthModule,
|
|
// 웹메일 API (Stalwart JMAP 어댑터)
|
|
MailModule,
|
|
// 주소록 API — 내 주소록 · 사내 목록 (8단계, 메일 모듈도 받는 사람 추천에 쓴다)
|
|
ContactsModule,
|
|
UploadModule,
|
|
UserModule,
|
|
],
|
|
providers: [
|
|
ShutdownLogger,
|
|
// 전역 가드는 등록 순서대로 돈다 — 다른 사이트에서 온 상태 변경 요청은 요청 수를 세기 전에 막는다
|
|
{
|
|
provide: APP_GUARD,
|
|
useClass: OriginGuard,
|
|
},
|
|
// 요청 수 한도 — ThrottlerGuard 그대로, 클라이언트 키만 IPv6 /64 로 묶는다 (두 번째 limiter 가 아니다)
|
|
{
|
|
provide: APP_GUARD,
|
|
useClass: ClientIpThrottlerGuard,
|
|
},
|
|
],
|
|
})
|
|
// 요청 추적 ID 는 app.setup.ts 의 configureApp() 이 **맨 앞** express 미들웨어로 붙인다 —
|
|
// 본문 파서 오류(413·400·415)에도 traceId 가 남도록 Nest 미들웨어(본문 파서 뒤)로 두지 않는다
|
|
export class AppModule {}
|