midway-fatcms 0.0.6 → 0.0.8

package/src/libs/crud-pro-quick/index.ts

@@ -0,0 +1,52 @@
+/**
+ * 快捷 CRUD 操作模块
+ *
+ * 在 CrudPro 之上封装便捷方法，提供简洁的 API 进行单表 CRUD 操作。
+ * 内部使用工厂函数模式，每次操作都会获取新的 CrudPro 实例，因此**可以安全复用**。
+ *
+ * **与 CrudPro 的关系：**
+ * - CrudPro 是有状态执行器，禁止复用
+ * - CrudProQuick 内部每次调用工厂函数获取新 CrudPro，可以安全复用
+ *
+ * **使用方式：**
+ * 必须通过 CurdProService.getQuickCrud() 获取实例，不要直接构造。
+ *
+ * @example
+ * // 通过 CurdProService 获取实例
+ * const quick = curdProService.getQuickCrud('mydb', SqlDbType.mysql, 't_user');
+ *
+ * // 设置公共配置
+ * quick.setBaseCfgModel({
+ *   enableSoftDelete: true,
+ *   enableStandardUpdateCfg: true,
+ * });
+ *
+ * // 查询列表（新 API）
+ * const result = await quick.findList({ condition: { status: 1 } });
+ * console.log(result.rows, result.count);
+ *
+ * // 插入数据（新 API）
+ * const insertResult = await quick.insert({ data: { name: '张三', age: 20 } });
+ * console.log(insertResult.affectedRows, insertResult.insertId);
+ */
+
+// 核心类
+export { CrudProQuick } from './CrudProQuick';
+
+// 类型导出
+export type { ICrudProQuickFactory } from './CrudProQuick';
+export type { IRequestCfgModel2, ICommonStandardColumns } from './models';
+
+// 工具函数
+export { fixSoftDelete } from './fixSoftDelete';
+
+// 重新导出结果类型
+export {
+  CrudWriteResult,
+  CrudQueryOneResult,
+  CrudQueryListResult,
+  CrudQueryPageResult,
+  CrudExistResult,
+  CrudCountResult,
+  CrudUpsertResult,
+} from '@/libs/crud-pro/models/CrudResult';

package/src/libs/crud-pro-quick/models.ts

@@ -0,0 +1,35 @@
+import { IRequestCfgModel } from '@/libs/crud-pro/interfaces';
+
+/**
+ * 常用标准表结构字段（6个字段）
+ * 
+ * 用于软删除和审计跟踪：
+ * - deleted_at: 删除时间戳，0=未删除
+ * - deleted_by: 删除人ID
+ * - created_by: 创建人ID
+ * - created_at: 创建时间（毫秒时间戳）
+ * - modified_by: 修改人ID
+ * - modified_at: 修改时间（毫秒时间戳）
+ */
+export interface ICommonStandardColumns {
+  deleted_at?: number;
+  deleted_by?: string;
+  created_by?: string;
+  created_at?: number;
+  modified_by?: string;
+  modified_at?: number;
+}
+
+/**
+ * 扩展的请求配置模型
+ * 
+ * 在 IRequestCfgModel 基础上添加了业务层常用的配置项：
+ * - enableStandardUpdateCfg: 启用标准字段自动填充
+ * - enableStandardUpdateCfgCondition: 启用标准字段条件注入
+ * - enableSoftDelete: 启用软删除
+ */
+export interface IRequestCfgModel2 extends IRequestCfgModel {
+  enableStandardUpdateCfg?: boolean | string[]; // 默认为true
+  enableStandardUpdateCfgCondition?: boolean | string[]; // 默认为false
+  enableSoftDelete?: boolean;
+}

package/src/libs/crud-sharding/ShardingConfig.ts

@@ -1,3 +1,11 @@
+import { CrudPro } from '@/libs/crud-pro/CrudPro';
+
+/**
+ * CrudPro 工厂函数类型
+ * 每次调用返回新的 CrudPro 实例，避免状态污染
+ */
+export type CrudProFactory = () => CrudPro;
+
 /**
  * 分表配置模型
  * 
@@ -63,6 +71,14 @@ export interface IShardingConfig {
    */
   timeColumn?: string;
 
+  /**
+   * 主键字段
+   * 用于时间分表场景下，当 condition 中包含主键时，时间字段仅用于路由定位分表，
+   * 不参与具体表的查询条件（避免时间精度损失导致查询失败）
+   * 例如：id, order_id
+   */
+  primaryKey?: string;
+
   /**
    * 自定义分表路由函数
    * 用于 CUSTOM 类型
@@ -86,8 +102,8 @@ export interface IShardingConfig {
    * 适用于时间分表类型（YEAR/MONTH/DAY）。
    * 
    * 默认值：
-   * - YEAR: 3（最近3年）
-   * - MONTH: 12（最近12个月）
+   * - YEAR: 2（最近2年）
+   * - MONTH: 3（最近3个月）
    * - DAY: 7（最近7天）
    * 
    * @example