Hướng dẫn

@sdcorejs/nestjs đóng gói hạ tầng mà các service NestJS đa tenant thường xuyên cần: request context, thực thi tenancy, trường kiểm toán, permission, xác minh JWT, cache, HTTP client outbound an toàn, validation, i18n, lưu trữ file, lịch sử thao tác, job lease phân tán và tích hợp BullMQ.

Thư viện cung cấp các cơ chế. Ứng dụng của bạn vẫn chịu trách nhiệm về policy miền: cách ánh xạ một principal đã xác minh thành user và tenant, họ có permission nào, có thể xem bản ghi nào và side effect bên ngoài nào có tính idempotent.

Chọn lộ trình

• Dự án mới: Cài đặt → Cấu hình → Ứng dụng hoàn chỉnh.
• CRUD đa tenant: Request context → Multi-tenancy → Các lớp cơ sở ORM.
• Xác thực: JWT và Keycloak → Ví dụ danh tính và permission.
• Tính năng có trạng thái: File tải lên, lịch sử thao tác và job scheduler.
• Review production: Cơ sở dữ liệu và PostgreSQL và hướng dẫn migration bảo mật 1.1.0 được liên kết từ navigation tài liệu.

Public import

Chỉ sử dụng package root và bảy subpath đã được ghi trong tài liệu:

import { SdCoreModule } from '@sdcorejs/nestjs';
import { BaseRepository, ContextService } from '@sdcorejs/nestjs/core';
import { AuthGuard, HasPermission } from '@sdcorejs/nestjs/auth';
import { CacheService, HttpService } from '@sdcorejs/nestjs/services';
import { ZodValidationGuard } from '@sdcorejs/nestjs/validation';
import { QueueModule } from '@sdcorejs/nestjs/queue';
import { I18N_RESOLVER } from '@sdcorejs/nestjs/i18n';
import { UploadedFileService } from '@sdcorejs/nestjs/features';

Deep import vào dist, src hoặc thư mục nội bộ của một feature không thuộc hợp đồng tương thích.