API core

Đường dẫn import: @sdcorejs/nestjs/core

Entrypoint core gồm bốn bề mặt phối hợp với nhau:

• ORM — entity/mixin TypeORM, repository, service, controller, kiểu query và cầu nối history.
• Request context — AsyncLocalStorage và ánh xạ danh tính tin cậy.
• Multi-tenancy — decorator scope, strategy, thực thi fail-closed và grant đặc quyền có audit.
• Audit — strategy cho trường actor và subscriber TypeORM.

Luồng điển hình

verified JWT principal
  -> ContextService identity
  -> tenancy/audit strategies
  -> BaseRepository scoped query or mutation
  -> optional ActionHistory recorder

import {
  BaseEntity,
  BaseRepository,
  ContextService,
  Scoped,
  WithAudit,
  type ITenancyStrategy,
} from '@sdcorejs/nestjs/core';

Bắt đầu với ORM để xem ví dụ entity/repository/service/controller hoàn chỉnh. Mỗi entity có scope cũng phải tuân theo cấu hình tenancy; thiếu scope bắt buộc sẽ fail closed thay vì fallback về dữ liệu global.

Cơ sở dữ liệu đích

Lớp query và các kiểu cột tích hợp nhắm tới PostgreSQL. Tìm kiếm văn bản phụ thuộc vào unaccent, đường dẫn JSON dùng operator PostgreSQL, import dùng RETURNING, và việc sắp xếp chỉ định vị trí null. Xem Hành vi PostgreSQL trước khi chọn datasource engine.