يحوّل JSON إلى نموذج مبني على الـ decorators لمكتبة sequelize-typescript: صنف يرث Model مع @Table و@Column({ type: DataType.*, allowNull })، وأنواع TypeScript للخصائص، وdecorators من class-validator للتحقق.
يستهدف sequelize-typescript (المكتبة التي يقوم عليها @nestjs/sequelize في NestJS) لا sequelize المجردة، لذا يختلف مسار الاستيراد وتهجئة DataType (دون s في آخرها) عن نسخة JavaScript.
اسم النموذج (الافتراضي MyModel)؛ ويصبح أيضًا tableName بصيغة upper snake case في @Table.invoice.model.ts وسجّلها بـ new Sequelize({ ..., models: [Invoice] }) أو بـ SequelizeModule.forFeature([Invoice]) في NestJS.{
"invoice_no": "INV-2024-0042",
"amount": 1250.75,
"currency": "EUR",
"paid": false,
"due_date": "2024-07-31",
"memo": ""
}import { Table, Column, Model, DataType } from 'sequelize-typescript';
import { IsNotEmpty, IsOptional } from 'class-validator';
@Table({ tableName: 'INVOICE', timestamps: false })
export class Invoice extends Model<Invoice> {
@Column({ type: DataType.INTEGER, primaryKey: true, autoIncrement: true })
id: number;
@Column({ type: DataType.STRING, allowNull: false, field: 'invoice_no' })
@IsNotEmpty()
invoiceNo: string;
@Column({ type: DataType.DOUBLE, allowNull: false })
@IsNotEmpty()
amount: number;
@Column({ type: DataType.STRING, allowNull: false })
@IsNotEmpty()
currency: string;
@Column({ type: DataType.BOOLEAN, allowNull: false })
@IsNotEmpty()
paid: boolean;
@Column({ type: DataType.DATEONLY, allowNull: false, field: 'due_date' })
@IsNotEmpty()
dueDate: string;
@Column({ type: DataType.STRING, allowNull: false })
@IsOptional()
memo: string;
}memo سلسلة فارغة: ليست NULL، لذا يُبقي العمود allowNull: false، لكنه يحصل على @IsOptional() لا @IsNotEmpty(). ويصبح amount من نوع DataType.DOUBLE، ويصبح due_date من نوع DataType.DATEONLY بنوع string، لأن Sequelize يُرجع القيم التي هي تاريخ فقط كنص.
{ Table, Column, Model, DataType } من sequelize-typescript ويعرّف الصنف بالشكل extends Model<Invoice>.@Table({ tableName: 'INVOICE', timestamps: false })، مطابقًا لمولّد JavaScript، فلا تُفترض أعمدة createdAt/updatedAt.@Column يذكر type وallowNull؛ والأعمدة القابلة لـ null نوعها string | null وهكذا.INTEGER/BIGINT/DOUBLE → number، وBOOLEAN → boolean، وDATE → Date، وDATEONLY → string، وJSON → Record<string, unknown> أو مصفوفة ذات نوع مثل string[].field: 'invoice_no' يشير إلى العمود الأصلي؛ ومفتاح id في JSON يُستخدم مفتاحًا أساسيًا لا يُكرَّر.@IsNotEmpty()؛ والبقية تحصل على @IsOptional().حين تحتاج إلى حفظ بيانات يرسلها نظام فوترة أو تسويات خارجي بصيغة JSON، ابنِ صنف النموذج من ذلك الـ payload واستخدمه عبر @InjectModel(Invoice).
صدّر بيانات الجدول الحالية كـ JSON والصقها لتحصل على مسودة نموذج ذي أنواع، بدلًا من إعادة كتابة كائن define() كصنف يدويًا.
DataType.DECIMAL(12, 2) أكثر أمانًا من DataType.DOUBLE.experimentalDecorators وemitDecoratorMetadata في tsconfig لتعمل الـ decorators.useDefineForClassFields (الافتراضي حين يكون target هو ES2022 أو أحدث)، تحجب تعريفات الخصائص العادية الـ getters الخاصة بـ Sequelize. عطّل ذلك الخيار أو أضف declare قبل الخصائص.Model<InvoiceAttributes, InvoiceCreationAttributes> بدلًا من Model<Invoice>؟يقبل sequelize-typescript v2 معاملَي نوع عامّين؛ والكود المولَّد يمرّر الصنف نفسه ببساطة. إن أردت فحص أنواع Invoice.create({...}) دون الحقول المولَّدة تلقائيًا مثل id، فعرّف واجهة لسمات الإنشاء ومرّرها كمعامل النوع الثاني.
DataType لا DataTypes؟DataType هو الاسم الذي تُصدِّره sequelize-typescript. استيراد DataTypes من sequelize يعمل بالطريقة نفسها، لكن الالتزام باسم واحد في كل ملف أوضح للقراءة.
لا. لا يحدث التحقق إلا حين تستدعي validate(invoice) بنفسك أو حين تكون الـ decorators على DTO يعالجه ValidationPipe في NestJS. للتحقق على مستوى Sequelize، استخدم @Column({ validate: { notEmpty: true } }) أو decorators من sequelize-typescript مثل @NotEmpty.