midway-fatcms 0.0.5 → 0.0.7

package/.qoder/skills/midway-fatcms-crud/examples.md

@@ -0,0 +1,990 @@
+# midway-fatcms CRUD 使用示例大全
+
+## 基础查询示例
+
+### 简单列表查询
+
+```typescript
+import { Provide, Inject } from '@midwayjs/core';
+import { CurdMixService } from 'midway-fatcms';
+import { SqlDbType } from 'midway-fatcms';
+
+@Provide()
+export class OrderService {
+  @Inject()
+  curdMixService: CurdMixService;
+
+  async getOrderList() {
+    const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+    // 基础查询
+    const orders = await quick.getList({
+      condition: { status: 'paid' },
+    });
+
+    return orders;
+  }
+}
+```
+
+### 条件 + 排序 + 指定字段
+
+```typescript
+async getFilteredOrders() {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  const orders = await quick.getList({
+    condition: {
+      status: 'paid',
+      amount: { $gte: 100, $lte: 1000 },
+      created_at: { $gte: '2024-01-01' },
+    },
+    orderBy: 'created_at DESC',  // 降序
+    columns: ['id', 'order_no', 'amount', 'status', 'created_at'],
+  });
+
+  return orders;
+}
+```
+
+### 分页查询
+
+```typescript
+async getOrderPage(pageNo: number, pageSize: number) {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  const page = await quick.getListPage({
+    condition: { status: 'paid' },
+    pageNo,
+    pageSize,
+    orderBy: 'created_at DESC',
+  });
+
+  return {
+    list: page.rows,
+    total: page.total_count,
+    pageNo,
+    pageSize,
+  };
+}
+```
+
+### 唯一查询
+
+```typescript
+async getOrderByNo(orderNo: string) {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  // 0条返回 null，多条抛出异常
+  const order = await quick.getUniqueOne({
+    condition: { order_no: orderNo },
+  });
+
+  return order; // null 或对象
+}
+```
+
+### 存在性判断
+
+```typescript
+async checkOrderExists(orderNo: string) {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  const exists = await quick.isExist({
+    condition: { order_no: orderNo },
+  });
+
+  return exists; // true / false
+}
+```
+
+### 复杂条件查询
+
+```typescript
+async getComplexOrders() {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  // AND + OR 组合
+  const orders = await quick.getList({
+    condition: {
+      $and: [
+        { status: 'active' },
+        {
+          $or: [
+            { type: 'normal' },
+            { type: 'vip', amount: { $gte: 500 } },
+          ],
+        },
+      ],
+    },
+    orderBy: 'created_at DESC',
+  });
+
+  return orders;
+}
+```
+
+### 包含匹配查询
+
+```typescript
+async searchOrdersByKeyword(keyword: string) {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  const orders = await quick.getList({
+    condition: {
+      status: 'active',
+      order_name: { $likeInclude: keyword },  // LIKE '%keyword%'
+    },
+    orderBy: 'created_at DESC',
+  });
+
+  return orders;
+}
+```
+
+### IN 查询
+
+```typescript
+async getOrdersByStatuses(statuses: string[]) {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+  return await quick.getList({
+    condition: { status: { $in: statuses } },
+    orderBy: 'id DESC',
+  });
+}
+```
+
+## 写入操作示例
+
+### 插入单条
+
+```typescript
+async createOrder(orderData: any) {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  // 启用标准字段自动填充
+  quick.setBaseCfgModel({
+    enableStandardUpdateCfg: true,
+  });
+
+  const result = await quick.insertObject({
+    data: {
+      order_no: orderData.orderNo,
+      amount: orderData.amount,
+      status: 'pending',
+      user_id: orderData.userId,
+    },
+  });
+
+  return {
+    id: result.insertId,
+    affectedRows: result.affectedRows,
+  };
+}
+```
+
+### 批量插入
+
+```typescript
+async batchCreateOrders(orders: any[]) {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  const result = await quick.batchInsert({
+    data: orders.map(order => ({
+      order_no: order.orderNo,
+      amount: order.amount,
+      status: order.status,
+      user_id: order.userId,
+    })),
+  });
+
+  return {
+    affectedRows: result.affectedRows,
+  };
+}
+```
+
+### 更新数据
+
+```typescript
+async updateOrderStatus(orderId: number, status: string) {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  // 注意：必须带 condition，否则可能全表更新
+  const result = await quick.updateObject({
+    condition: { id: orderId },
+    data: {
+      status,
+      updated_at: new Date(),
+    },
+  });
+
+  return {
+    affectedRows: result.affectedRows,
+  };
+}
+```
+
+### 插入或更新
+
+```typescript
+async saveOrUpdateOrder(orderData: any) {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  // 先查询存在性，再决定插入或更新（2条 SQL）
+  const result = await quick.insertOrUpdate({
+    condition: { order_no: orderData.orderNo },  // 查询条件
+    data: {
+      order_no: orderData.orderNo,
+      amount: orderData.amount,
+      status: orderData.status,
+      user_id: orderData.userId,
+    },
+  });
+
+  return result;
+}
+```
+
+### 原生 Upsert（更高效）
+
+```typescript
+async upsertOrder(orderData: any) {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  // MySQL: ON DUPLICATE KEY UPDATE（1条 SQL）
+  const result = await quick.insertOnDuplicate(
+    {
+      data: {
+        id: orderData.id,
+        order_no: orderData.orderNo,
+        amount: orderData.amount,
+        count: orderData.count,
+      },
+    },
+    ['id'],  // 唯一列，PostgreSQL/SQL Server 必填
+  );
+
+  return result;
+}
+```
+
+### 删除操作
+
+```typescript
+async deleteOrder(orderId: number) {
+  const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+
+  // 启用软删除
+  quick.setBaseCfgModel({
+    enableSoftDelete: true,
+  });
+
+  // 如果启用软删除，实际执行 UPDATE 设置 deleted_at
+  // 如果未启用，执行物理 DELETE
+  const result = await quick.deleteObject({
+    condition: { id: orderId },
+  });
+
+  return {
+    affectedRows: result.affectedRows,
+  };
+}
+```
+
+## 分表操作示例
+
+### 按月分表（订单表）
+
+```typescript
+import { ShardingType } from 'midway-fatcms';
+import { CurdProService } from 'midway-fatcms';
+
+@Provide()
+export class OrderShardingService {
+  @Inject()
+  curdProService: CurdProService;
+
+  // 获取按月分表实例
+  private getOrderSharding() {
+    return this.curdProService.getShardingCrud('mydb', SqlDbType.mysql, {
+      type: ShardingType.MONTH,
+      baseTable: 't_order',
+      timeColumn: 'created_at',
+      autoCreateTable: true,
+      tableCreateOptions: {
+        copyIndexes: true,
+        tableOptions: 'ENGINE=InnoDB DEFAULT CHARSET=utf8mb4',
+      },
+    });
+  }
+
+  // 插入订单（自动路由到对应月份表）
+  async createOrder(orderData: any) {
+    const sharding = this.getOrderSharding();
+
+    await sharding.insert({
+      data: {
+        order_id: orderData.orderId,
+        amount: orderData.amount,
+        created_at: orderData.createdAt, // 用于路由到对应分表
+      },
+    });
+  }
+
+  // 批量插入（自动分组并行写入）
+  async batchCreateOrders(orders: any[]) {
+    const sharding = this.getOrderSharding();
+
+    const result = await sharding.batchInsert({
+      data: orders.map(o => ({
+        order_id: o.orderId,
+        amount: o.amount,
+        created_at: o.createdAt,
+      })),
+    });
+
+    console.log(`涉及 ${result.tableCount} 个分表，共插入 ${result.totalAffected} 条`);
+    return result;
+  }
+
+  // 列表查询（自动合并多表结果）
+  async getOrdersByMonth(startDate: string, endDate: string) {
+    const sharding = this.getOrderSharding();
+
+    const orders = await sharding.query({
+      condition: {
+        status: 'paid',
+        created_at: { $gte: startDate, $lte: endDate },
+      },
+      orderBy: 'created_at DESC', // 时间分表必须传此格式
+    });
+
+    return orders;
+  }
+
+  // 分页查询（跨分表自动处理）
+  async getOrderPage(pageNo: number, pageSize: number) {
+    const sharding = this.getOrderSharding();
+
+    const page = await sharding.queryPage({
+      condition: { status: 'paid' },
+      pageNo,
+      pageSize,
+      orderBy: 'created_at DESC',
+    });
+
+    return {
+      list: page.rows,
+      total: page.total_count,
+    };
+  }
+
+  // 统计总数
+  async countOrders() {
+    const sharding = this.getOrderSharding();
+
+    return await sharding.queryCount({
+      condition: { status: 'paid' },
+    });
+  }
+}
+```
+
+### 哈希分表（用户表）
+
+```typescript
+@Provide()
+export class UserShardingService {
+  @Inject()
+  curdProService: CurdProService;
+
+  // 获取哈希分表实例
+  private getUserSharding() {
+    return this.curdProService.getShardingCrud('mydb', SqlDbType.mysql, {
+      type: ShardingType.HASH,
+      baseTable: 't_user',
+      shardingColumn: 'user_id',
+      tableCount: 16,  // t_user_01 ~ t_user_16
+    });
+  }
+
+  // 插入用户
+  async createUser(userData: any) {
+    const sharding = this.getUserSharding();
+
+    await sharding.insert({
+      data: {
+        user_id: userData.userId,  // 用于哈希路由
+        name: userData.name,
+        email: userData.email,
+      },
+    });
+  }
+
+  // 查询用户（需要提供 user_id 用于路由）
+  async getUserById(userId: string) {
+    const sharding = this.getUserSharding();
+
+    return await sharding.queryOne({
+      condition: { user_id: userId },
+    });
+  }
+
+  // 查询多用户（无 user_id 时扫描多个分表）
+  async getUsersByStatus(status: string) {
+    const sharding = this.getUserSharding();
+
+    return await sharding.query({
+      condition: { status },
+      orderBy: 'created_at DESC',
+    });
+  }
+}
+```
+
+### 分表 + 软删除 + 标准字段
+
+```typescript
+async createOrderWithFullConfig(orderData: any) {
+  const sharding = this.curdProService
+    .getShardingCrud('mydb', SqlDbType.mysql, {
+      type: ShardingType.MONTH,
+      baseTable: 't_order',
+      timeColumn: 'created_at',
+    })
+    .setBaseCfg({
+      enableSoftDelete: true,
+      enableStandardUpdateCfg: true,
+    });
+
+  await sharding.insert({
+    data: {
+      order_id: orderData.orderId,
+      amount: orderData.amount,
+      created_at: orderData.createdAt,
+    },
+  });
+  // 自动填充：created_by, deleted_at = 0
+}
+```
+
+## 关联数据填充示例
+
+### 字典翻译
+
+```typescript
+import { Provide, Inject } from '@midwayjs/core';
+import { CurdMixService } from 'midway-fatcms';
+
+@Provide()
+export class OrderWithDictService {
+  @Inject()
+  curdMixService: CurdMixService;
+
+  async getOrdersWithDict() {
+    const cfgModel = {
+      method: 'order.list.withDict',
+      sqlTable: 't_order',
+      sqlSimpleName: 'SIMPLE_QUERY_PAGE',
+      columnsRelation: [
+        // 订单状态翻译
+        {
+          relatedType: 'dict',
+          relatedCode: 'OrderStatusEnum',
+          sourceColumn: 'status',
+          targetColumns: [
+            { from: 'label', to: 'status_text' },
+            { from: 'color', to: 'status_color' },
+          ],
+        },
+        // 支付类型翻译
+        {
+          relatedType: 'dict',
+          relatedCode: 'PayTypeEnum',
+          sourceColumn: 'pay_type',
+          targetColumns: [{ from: 'label', to: 'pay_type_text' }],
+        },
+      ],
+    };
+
+    const ctx = await this.curdMixService.executeCrudByCfg(
+      {
+        condition: {},
+        pageNo: 1,
+        pageSize: 10,
+        orderBy: 'created_at DESC',
+      },
+      cfgModel
+    );
+
+    const { rows } = ctx.getResModelForQueryPage();
+    // rows 自动包含 status_text, status_color, pay_type_text
+    return rows;
+  }
+}
+```
+
+### 用户信息填充
+
+```typescript
+async getOrdersWithUserInfo() {
+  const cfgModel = {
+    method: 'order.list.withUser',
+    sqlTable: 't_order',
+    sqlSimpleName: 'SIMPLE_QUERY_PAGE',
+    columnsRelation: [
+      // 创建者信息填充
+      {
+        relatedType: 'accountBasic',
+        sourceColumn: 'created_by',
+        targetColumns: [], // 空数组使用默认映射
+      },
+    ],
+  };
+
+  const ctx = await this.curdMixService.executeCrudByCfg(
+    {
+      condition: {},
+      pageNo: 1,
+      pageSize: 10,
+      orderBy: 'created_at DESC',
+    },
+    cfgModel
+  );
+
+  const { rows } = ctx.getResModelForQueryPage();
+  // rows 自动包含：
+  // - created_by_nickname
+  // - created_by_avatar
+  // - created_by_account_type
+  return rows;
+}
+```
+
+### 多级关联填充
+
+```typescript
+async getOrdersWithMultiRelation() {
+  const cfgModel = {
+    method: 'order.list.full',
+    sqlTable: 't_order',
+    sqlSimpleName: 'SIMPLE_QUERY_PAGE',
+    columnsRelation: [
+      // 订单状态字典
+      {
+        relatedType: 'dict',
+        relatedCode: 'OrderStatusEnum',
+        sourceColumn: 'status',
+        targetColumns: [{ from: 'label', to: 'status_text' }],
+      },
+      // 创建者信息
+      {
+        relatedType: 'accountBasic',
+        sourceColumn: 'created_by',
+        targetColumns: [
+          { from: 'nickName', to: 'creator_name' },
+          { from: 'avatar', to: 'creator_avatar' },
+        ],
+      },
+      // 更新者信息
+      {
+        relatedType: 'accountBasic',
+        sourceColumn: 'modified_by',
+        targetColumns: [
+          { from: 'nickName', to: 'modifier_name' },
+        ],
+      },
+      // 所属站点信息
+      {
+        relatedType: 'workbenchBasic',
+        sourceColumn: 'workbench_code',
+        targetColumns: [
+          { from: 'workbench_name', to: 'site_name' },
+          { from: 'workbench_domain', to: 'site_domain' },
+        ],
+      },
+    ],
+  };
+
+  const ctx = await this.curdMixService.executeCrudByCfg(
+    { condition: {}, pageNo: 1, pageSize: 10, orderBy: 'created_at DESC' },
+    cfgModel
+  );
+
+  return ctx.getResModelForQueryPage();
+}
+```
+
+### 独立关联填充（已有数据）
+
+```typescript
+async linkRelationToExistingData(rows: any[]) {
+  // 对已有数据（如从缓存获取的）执行关联填充
+  await this.curdMixService.linkColumnRelationDatas(rows, {
+    columnsRelations: [
+      {
+        relatedType: 'dict',
+        relatedCode: 'OrderStatusEnum',
+        sourceColumn: 'status',
+        targetColumns: [{ from: 'label', to: 'status_text' }],
+      },
+      {
+        relatedType: 'accountBasic',
+        relatedCode: 'SexEnum',
+        sourceColumn: 'sex',
+        targetColumns: [{ from: 'label', to: 'sex_text' }],
+      },
+    ],
+  });
+
+  // rows 中的每行自动追加 status_text、sex_text 字段
+  return rows;
+}
+```
+
+## 综合业务场景示例
+
+### 场景1：订单管理（完整 CURD）
+
+```typescript
+@Provide()
+export class OrderManagerService {
+  @Inject()
+  curdProService: CurdProService;
+
+  @Inject()
+  curdMixService: CurdMixService;
+
+  private getQuick() {
+    const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_order');
+    quick.setBaseCfgModel({
+      enableStandardUpdateCfg: true,
+      enableSoftDelete: true,
+    });
+    return quick;
+  }
+
+  // 创建订单
+  async create(orderData: any) {
+    const quick = this.getQuick();
+
+    const result = await quick.insertObject({
+      data: {
+        order_no: orderData.orderNo,
+        user_id: orderData.userId,
+        amount: orderData.amount,
+        status: 'pending',
+      },
+    });
+
+    return { id: result.insertId };
+  }
+
+  // 查询订单列表（带分页、字典翻译）
+  async list(params: any) {
+    const cfgModel = {
+      method: 'order.list',
+      sqlTable: 't_order',
+      sqlSimpleName: 'SIMPLE_QUERY_PAGE',
+      enableSoftDelete: true, // 自动过滤 deleted_at = 0
+      columnsRelation: [
+        {
+          relatedType: 'dict',
+          relatedCode: 'OrderStatusEnum',
+          sourceColumn: 'status',
+          targetColumns: [{ from: 'label', to: 'status_text' }],
+        },
+        {
+          relatedType: 'accountBasic',
+          sourceColumn: 'created_by',
+          targetColumns: [],
+        },
+      ],
+    };
+
+    const ctx = await this.curdMixService.executeCrudByCfg(
+      {
+        condition: {
+          status: params.status,
+          user_id: params.userId,
+        },
+        pageNo: params.pageNo || 1,
+        pageSize: params.pageSize || 20,
+        orderBy: 'created_at DESC',
+      },
+      cfgModel
+    );
+
+    return ctx.getResModelForQueryPage();
+  }
+
+  // 更新订单
+  async update(orderId: number, updateData: any) {
+    const quick = this.getQuick();
+
+    await quick.updateObject({
+      condition: { id: orderId },
+      data: {
+        status: updateData.status,
+        amount: updateData.amount,
+      },
+    });
+  }
+
+  // 删除订单（软删除）
+  async delete(orderId: number) {
+    const quick = this.getQuick();
+
+    await quick.deleteObject({
+      condition: { id: orderId },
+    });
+    // 实际执行：UPDATE t_order SET deleted_at=xxx, deleted_by='user123' WHERE id=1
+  }
+}
+```
+
+### 场景2：大数据量分表订单系统
+
+```typescript
+import * as dayjs from 'dayjs';
+
+@Provide()
+export class BigDataOrderService {
+  @Inject()
+  curdProService: CurdProService;
+
+  private getSharding() {
+    return this.curdProService
+      .getShardingCrud('bigdata_db', SqlDbType.mysql, {
+        type: ShardingType.MONTH,
+        baseTable: 't_order',
+        timeColumn: 'created_at',
+        countCache: {
+          ttlSeconds: 300,
+          maxSize: 1000,
+        },
+      })
+      .setBaseCfg({
+        enableStandardUpdateCfg: true,
+        enableSoftDelete: true,
+      });
+  }
+
+  // 接收订单数据（可能跨多月）
+  async receiveOrders(orders: any[]) {
+    const sharding = this.getSharding();
+
+    // 自动按月份分组，并行插入到不同分表
+    const result = await sharding.batchInsert({
+      data: orders.map(o => ({
+        order_no: o.orderNo,
+        user_id: o.userId,
+        amount: o.amount,
+        created_at: o.createdAt,
+      })),
+    });
+
+    return {
+      total: result.totalAffected,
+      tableCount: result.tableCount,
+    };
+  }
+
+  // 查询最近3个月的订单
+  async getRecentOrders(userId: string) {
+    const sharding = this.getSharding();
+
+    const threeMonthsAgo = dayjs().subtract(3, 'month').format('YYYY-MM-DD');
+
+    return await sharding.query({
+      condition: {
+        user_id: userId,
+        created_at: { $gte: threeMonthsAgo },
+      },
+      orderBy: 'created_at DESC',
+    });
+  }
+
+  // 分页查询历史订单（跨分表）
+  async getHistoryOrders(userId: string, pageNo: number) {
+    const sharding = this.getSharding();
+
+    return await sharding.queryPage({
+      condition: { user_id: userId },
+      pageNo,
+      pageSize: 20,
+      orderBy: 'created_at DESC',
+    });
+  }
+}
+```
+
+### 场景3：使用原生 SQL
+
+```typescript
+@Provide()
+export class ReportService {
+  @Inject()
+  curdMixService: CurdMixService;
+
+  async getReportBySQL() {
+    const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql);
+
+    // 执行框架封装的 SQL（带参数绑定）
+    const rows = await quick.executeSQL(
+      `SELECT
+        DATE_FORMAT(created_at, '%Y-%m') as month,
+        COUNT(*) as order_count,
+        SUM(amount) as total_amount
+       FROM t_order
+       WHERE status = ? AND created_at > ?
+       GROUP BY month
+       ORDER BY month DESC`,
+      ['completed', '2024-01-01']
+    );
+
+    return rows;
+  }
+
+  async executeComplexQuery() {
+    const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql);
+
+    // 执行原生 SQL（最小封装，支持泛型）
+    const users = await quick.executeNativeSQL<
+      { id: number; name: string; total_orders: number }[]
+    >(
+      `SELECT u.id, u.name, COUNT(o.id) as total_orders
+       FROM t_user u
+       LEFT JOIN t_order o ON u.id = o.user_id
+       WHERE u.status = ?
+       GROUP BY u.id
+       HAVING total_orders > ?`,
+      ['active', 5]
+    );
+
+    return users;
+  }
+
+  async getRawTables() {
+    const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql);
+
+    // 原生 SQL 执行 SHOW TABLES
+    return await quick.executeNativeSQL('SHOW TABLES');
+  }
+}
+```
+
+### 场景4：配置驱动 CURD
+
+```typescript
+@Provide()
+export class ConfigDrivenService {
+  @Inject()
+  curdMixService: CurdMixService;
+
+  async executeByConfig() {
+    // 定义配置
+    const cfgJson = {
+      method: 'user.customQuery',
+      sqlTable: 'sys_user',
+      sqlSimpleName: 'SIMPLE_QUERY_PAGE',
+      allowCfg: {
+        data: ['name', 'email', 'phone'], // 只允许这些字段被修改
+      },
+      updateCfg: {
+        // 自动设置创建时间
+        'data.created_at': { functionName: 'getCurrentTimeString' },
+        // 自动设置创建人
+        'data.created_by': { context: 'visitor.accountId' },
+      },
+      validateCfg: {
+        // 字段校验
+        'data.name': ['required', 'string', 'length:2,50'],
+        'data.email': ['required', 'email'],
+        'data.phone': ['phone:cn'],
+      },
+    };
+
+    // 执行
+    const ctx = await this.curdMixService.executeCrudByCfg(
+      {
+        condition: { status: 1 },
+        pageNo: 1,
+        pageSize: 10,
+        orderBy: 'created_at DESC',
+      },
+      cfgJson
+    );
+
+    return ctx.getResModelForQueryPage();
+  }
+
+  // 执行数据库中存储的 method
+  async executeDbMethod(methodCode: string, params: any) {
+    const ctx = await this.curdMixService.executeCrud({
+      method: methodCode,
+      ...params,
+    });
+    return ctx;
+  }
+}
+```
+
+### 场景5：日志批量插入
+
+```typescript
+@Provide()
+export class LogService {
+  @Inject()
+  curdMixService: CurdMixService;
+
+  async batchInsertLogs(logs: Array<{ action: string; user_id: number }>) {
+    const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql, 't_log');
+    const result = await quick.batchInsert({
+      data: logs.map(log => ({
+        ...log,
+        created_at: new Date().toISOString(),
+      })),
+    });
+    return result; // { affectedRows }
+  }
+}
+```
+
+### 场景6：事务中的多表操作
+
+```typescript
+@Provide()
+export class TransferService {
+  @Inject()
+  curdMixService: CurdMixService;
+
+  async transfer(fromId: number, toId: number, amount: number) {
+    // 当使用事务中间件时，所有操作共享同一个事务
+    const quick = this.curdMixService.getBbUtil('mydb', SqlDbType.mysql);
+
+    // 扣减转出账户余额
+    await quick.updateObject({
+      condition: { id: fromId },
+      data: { balance: { $decr: amount } }, // 使用递减操作符
+    }, 't_account');
+
+    // 增加转入账户余额
+    await quick.updateObject({
+      condition: { id: toId },
+      data: { balance: { $incr: amount } }, // 使用递增操作符
+    }, 't_account');
+
+    // 记录转账日志
+    await quick.insertObject({
+      data: {
+        from_id: fromId,
+        to_id: toId,
+        amount,
+        created_at: new Date().toISOString(),
+      },
+    }, 't_transfer_log');
+  }
+}
+```