設定

MBC CQRS サーバーレスフレームワークでは、特定の要件に合わせてプロジェクトをカスタマイズできます。このガイドでは、フレームワークで利用可能なすべての設定オプションについて説明します。

プロジェクト設定

serverless.yml

サーバーレスアプリケーションのメイン設定ファイルです。

テーブルプレフィックス

フレームワークは NODE_ENV と APP_NAME 環境変数を使用してDynamoDBテーブルプレフィックスを自動生成します。形式は {NODE_ENV}-{APP_NAME}-{tableName} です。例えば、NODE_ENV=dev と APP_NAME=my-app の場合、コマンドテーブルは dev-my-app-command という名前になります。

service: my-app

frameworkVersion: '3'

plugins:
  - serverless-offline
  - serverless-plugin-typescript
  - serverless-dynamodb-local

provider:
  name: aws
  runtime: nodejs18.x
  stage: ${opt:stage, 'dev'}
  region: ${opt:region, 'ap-northeast-1'}
  memorySize: 512
  timeout: 30

  environment:
    NODE_ENV: ${self:provider.stage}
    APP_NAME: ${self:service}
    COGNITO_USER_POOL_ID: ${env:COGNITO_USER_POOL_ID}
    COGNITO_CLIENT_ID: ${env:COGNITO_CLIENT_ID}

  iam:
    role:
      statements:
        - Effect: Allow
          Action:
            - dynamodb:Query
            - dynamodb:Scan
            - dynamodb:GetItem
            - dynamodb:PutItem
            - dynamodb:UpdateItem
            - dynamodb:DeleteItem
          Resource:
            - !GetAtt CommandTable.Arn
            - !GetAtt DataTable.Arn

custom:
  serverless-offline:
    httpPort: 3000
    lambdaPort: 3002

  dynamodb:
    stages:
      - dev
    start:
      port: 8000
      inMemory: true
      migrate: true

NestJS設定

アプリケーションでNestJSモジュールを設定します。

// app.module.ts
import { Module } from '@nestjs/common';
import { ConfigModule } from '@nestjs/config';
import { CommandModule } from '@mbc-cqrs-serverless/core';

@Module({
  imports: [
    // 環境変数をロード
    ConfigModule.forRoot({
      isGlobal: true,
      envFilePath: ['.env.local', '.env'],
    }),

    // Commandモジュールを設定
    CommandModule.register({
      tableName: process.env.DYNAMODB_TABLE_NAME,
      dataSyncHandlers: [],
    }),
  ],
})
export class AppModule {}

TypeScript設定

tsconfig.json

MBC CQRS Serverlessプロジェクト向けの推奨TypeScript設定。

{
  "compilerOptions": {
    "module": "commonjs",
    "target": "ES2021",
    "lib": ["ES2021"],
    "declaration": true,
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true,
    "noImplicitThis": true,
    "alwaysStrict": true,
    "noUnusedLocals": false,
    "noUnusedParameters": false,
    "noImplicitReturns": true,
    "noFallthroughCasesInSwitch": false,
    "inlineSourceMap": true,
    "inlineSources": true,
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true,
    "skipLibCheck": true,
    "esModuleInterop": true,
    "resolveJsonModule": true,
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"],
      "@shared/*": ["src/shared/*"]
    },
    "outDir": "./dist"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

ESLint設定

.eslintrc.js

推奨ESLint設定。

module.exports = {
  parser: '@typescript-eslint/parser',
  parserOptions: {
    project: 'tsconfig.json',
    sourceType: 'module',
  },
  plugins: ['@typescript-eslint/eslint-plugin'],
  extends: [
    'plugin:@typescript-eslint/recommended',
    'plugin:prettier/recommended',
  ],
  root: true,
  env: {
    node: true,
    jest: true,
  },
  ignorePatterns: ['.eslintrc.js', 'dist', 'node_modules'],
  rules: {
    '@typescript-eslint/interface-name-prefix': 'off',
    '@typescript-eslint/explicit-function-return-type': 'off',
    '@typescript-eslint/explicit-module-boundary-types': 'off',
    '@typescript-eslint/no-explicit-any': 'warn',
    '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
  },
};

モジュール設定

CommandModuleオプション

コアCommandModuleを設定します。

import { Module } from '@nestjs/common';
import { CommandModule } from '@mbc-cqrs-serverless/core';

@Module({
  imports: [
    CommandModule.register({
      // 必須: DynamoDBテーブル名
      tableName: 'order',

      // オプション: RDS同期用データ同期ハンドラー
      dataSyncHandlers: [OrderRdsSyncHandler],

      // オプション: 将来使用予定（未実装）
      skipError: false,

      // オプション: デフォルトDynamoDBデータ同期ハンドラーを無効化
      disableDefaultHandler: false,
    }),
  ],
})
export class OrderModule {}

SequenceModuleオプション

自動インクリメントシーケンスを設定します。

import { Module } from '@nestjs/common';
import { SequenceModule } from '@mbc-cqrs-serverless/sequence';

@Module({
  imports: [
    SequenceModule.register({
      // オプション: デフォルトシーケンスコントローラーを有効/無効化
      enableController: true,
    }),
  ],
})
export class AppModule {}

注: ローテーション戦略（day、month、year、fiscal_yearly、none）はマスターデータ設定で設定され、モジュールオプションではありません。詳細はシーケンスドキュメントを参照してください。

TenantModuleオプション

マルチテナントサポートを設定します。

import { Module } from '@nestjs/common';
import { TenantModule } from '@mbc-cqrs-serverless/tenant';

@Module({
  imports: [
    TenantModule.register({
      // オプション: デフォルトテナントコントローラーを有効/無効化
      enableController: true,

      // オプション: RDS同期用データ同期ハンドラー
      dataSyncHandlers: [TenantRdsSyncHandler],
    }),
  ],
})
export class AppModule {}

NotificationModule

環境変数を使用してメール通知を設定します。

import { Module } from '@nestjs/common';
import { NotificationModule } from '@mbc-cqrs-serverless/core';

@Module({
  imports: [
    // NotificationModuleはグローバルモジュール - インポートするだけで使用可能
    NotificationModule,
  ],
})
export class AppModule {}

NotificationModuleは環境変数で設定されます：

# Required: Default sender email address
SES_FROM_EMAIL=noreply@example.com

# Optional: AWS SES endpoint (for local development)
SES_ENDPOINT=http://localhost:4566

# Optional: AWS SES region
SES_REGION=ap-northeast-1

ログ設定

ロガーの設定

本番環境向けの構造化ログを設定します。

import { Logger } from '@nestjs/common';

// 環境に基づいてログレベルを設定
const LOG_LEVELS = {
  production: ['error', 'warn', 'log'],
  development: ['error', 'warn', 'log', 'debug', 'verbose'],
  test: ['error', 'warn'],
};

// main.tsまたはbootstrapで設定
const app = await NestFactory.create(AppModule, {
  logger: LOG_LEVELS[process.env.NODE_ENV] || LOG_LEVELS.development,
});

// サービス内の構造化ログ
@Injectable()
export class OrderService {
  private readonly logger = new Logger(OrderService.name);

  async createOrder(dto: CreateOrderDto): Promise<Order> {
    this.logger.log({
      message: 'Creating order',
      code: dto.code,
      tenantCode: dto.tenantCode,
    });

    // ... implementation
  }
}

バリデーション設定

グローバルバリデーションパイプ

すべてのエンドポイントのバリデーションを設定します。

import { ValidationPipe } from '@nestjs/common';

// main.tsまたはbootstrapで設定
app.useGlobalPipes(
  new ValidationPipe({
    // ペイロードをDTOインスタンスに変換
    transform: true,

    // DTOにないプロパティを除去
    whitelist: true,

    // 余分なプロパティでエラーをスロー
    forbidNonWhitelisted: true,

    // プリミティブ型を変換
    transformOptions: {
      enableImplicitConversion: true,
    },

    // カスタムエラーメッセージ
    exceptionFactory: (errors) => {
      const messages = errors.map(error => ({
        field: error.property,
        errors: Object.values(error.constraints || {}),
      }));
      return new BadRequestException({
        message: 'Validation failed',
        errors: messages,
      });
    },
  }),
);

CORS設定

CORSの設定

クロスオリジンリソース共有を設定します。

// In main.ts
app.enableCors({
  origin: process.env.ALLOWED_ORIGINS?.split(',') || [
    'http://localhost:3000',
  ],
  methods: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS'],
  allowedHeaders: ['Content-Type', 'Authorization', 'X-Request-Id'],
  credentials: true,
  maxAge: 3600,
});

ステージ固有の設定

環境ベースの設定

環境ごとに異なる設定を設定します。

// config/configuration.ts
export default () => ({
  stage: process.env.STAGE || 'dev',

  database: {
    tablePrefix: `myapp-${process.env.STAGE}`,
    commandTable: `myapp-${process.env.STAGE}-command`,
    dataTable: `myapp-${process.env.STAGE}-data`,
  },

  aws: {
    region: process.env.AWS_REGION || 'ap-northeast-1',
    dynamodbEndpoint: process.env.DYNAMODB_ENDPOINT, // For local dev
  },

  auth: {
    userPoolId: process.env.COGNITO_USER_POOL_ID,
    clientId: process.env.COGNITO_CLIENT_ID,
  },

  features: {
    enableDebugLogs: process.env.STAGE === 'dev',
    enableMetrics: process.env.STAGE === 'prod',
  },
});

// Usage
import { ConfigService } from '@nestjs/config';

@Injectable()
export class AppService {
  constructor(private configService: ConfigService) {}

  getTableName(): string {
    return this.configService.get<string>('database.commandTable');
  }
}

関連ドキュメント

• 環境変数 - 利用可能な全環境変数
• モジュール - モジュールの設定と登録
• デプロイガイド - 本番環境の設定