create-meadminjs 1.0.0

package/template/meadmin/src/fileManage/storage/local.ts

@@ -0,0 +1,93 @@
+import { UploadParam, UploadResult, UpStorageInterface } from '@/types/fileManage.js';
+import { app } from '@meadmin/core';
+import { UploadOptions, UploadStreamFileInfo } from '@midwayjs/busboy';
+import { appendFileSync, createReadStream, createWriteStream, existsSync, mkdirSync, renameSync, rmSync, statSync } from 'node:fs';
+import { relative, resolve } from 'node:path';
+import { BaseStorage } from './base.js';
+export class LocalStorage extends BaseStorage implements UpStorageInterface {
+  get path() {
+    return '/' + this.model + '/';
+  }
+  //保存文件
+  async saveFie({ filename, data }: UploadStreamFileInfo, md5: string, savePath: string, tmpPath: string) {
+    const suffix = filename.substring(filename.lastIndexOf('.')); //后缀带着.
+    const tmpFilePath = resolve(tmpPath, '__tmp__' + process.pid + '__' + md5 + suffix); //临时文件带上进程id防止重复
+    const saveFilePath = resolve(savePath, md5 + suffix);
+    const saveStat = statSync(saveFilePath, { throwIfNoEntry: false });
+    if (saveStat) {
+      return { size: saveStat.size, path: saveFilePath }; //已存在无需上传
+    }
+    return await new Promise<{ size: number; path: string }>((reslove, reject) => {
+      const stream = createWriteStream(tmpFilePath);
+      stream.on('close', () => {
+        renameSync(tmpFilePath, saveFilePath);
+        reslove({ size: statSync(saveFilePath, { throwIfNoEntry: true }).size, path: saveFilePath });
+      });
+      stream.on('error', (e) => {
+        reject(e);
+      });
+      data.pipe(stream);
+    });
+  }
+  async getFilePath(path: string) {
+    return resolve((app.getConfig('busboy') as UploadOptions).upDir + this.path, path);
+  }
+  async getFileReadSteam(path: string) {
+    return createReadStream(await this.getFilePath(path));
+  }
+  async upload(file: UploadStreamFileInfo, params: UploadParam) {
+    const fileUpconfig = app.getConfig('busboy') as UploadOptions;
+    const uploadResult = { storage: 'local' } as UploadResult;
+    uploadResult.md5 = params.md5;
+    //只处理1个文件上传
+    const { filename, mimeType } = file;
+    if (params.chunk !== '1') {
+      //非分片上传
+      const res = await this.saveFie(file, params.md5, fileUpconfig.upDir + this.path, fileUpconfig.tmpdir);
+      uploadResult.size = res.size;
+      uploadResult.path = relative(fileUpconfig.upDir + this.path, res.path);
+    } else {
+      //分片上传
+      const suffix = filename.substring(filename.lastIndexOf('.')); //后缀带着.
+      const saveFilePath = resolve(fileUpconfig.upDir + this.path, params.md5 + suffix);
+      const saveStat = statSync(saveFilePath, { throwIfNoEntry: false });
+      if (saveStat) {
+        //已存在无需上传
+        uploadResult.size = saveStat.size;
+        uploadResult.path = relative(fileUpconfig.upDir + this.path, saveFilePath);
+      } else {
+        if (params.start === undefined || params.over === undefined || params.chunkMd5 === undefined) {
+          throw new Error('分片上传时，start、over、chunkMd5必须有值');
+        }
+        const path = resolve(fileUpconfig.tmpdir, params.md5 + '/');
+        if (!existsSync(path)) {
+          mkdirSync(path);
+        }
+        const res = await this.saveFie(file, params.chunkMd5, path, path);
+        const tmpFilePath = resolve(fileUpconfig.tmpdir, '__tmp__chunk_all__' + process.pid + '__' + params.md5 + suffix); //临时文件带上进程id防止重复
+        appendFileSync(tmpFilePath, ''); //追加空串确保文件存在
+        await new Promise<void>((resolve, reject) => {
+          const fsStream = createWriteStream(tmpFilePath, { flags: 'r+', start: +params.start, autoClose: true });
+          fsStream.on('close', () => {
+            resolve();
+          });
+          fsStream.on('error', (e) => {
+            reject(e);
+          });
+          createReadStream(res.path).pipe(fsStream);
+        });
+        if (params.over !== '1') {
+          //未结束直接返回
+          return null;
+        }
+        renameSync(tmpFilePath, saveFilePath);
+        rmSync(path, { force: true, recursive: true });
+        uploadResult.size = statSync(saveFilePath, { throwIfNoEntry: true }).size;
+        uploadResult.path = relative(fileUpconfig.upDir + this.path, saveFilePath);
+      }
+    }
+    uploadResult.name = params.name || filename;
+    uploadResult.mimeType = mimeType;
+    return uploadResult;
+  }
+}

package/template/meadmin/src/filter/badRequest.filter.ts

@@ -0,0 +1,14 @@
+import { CodeEunm } from '@/dict/code.enum.js';
+import { ResponseService } from '@/service/response.service.js';
+import { Catch, httpError } from '@midwayjs/core';
+
+@Catch(httpError.BadRequestError)
+export class BadRequestFilter {
+  protected resposes: ResponseService;
+  constructor() {
+    this.resposes = new ResponseService();
+  }
+  async catch(err: Error) {
+    return this.resposes.error(err.message, CodeEunm.Fail);
+  }
+}

package/template/meadmin/src/filter/default.filter.ts

@@ -0,0 +1,28 @@
+import { CodeEunm } from '@/dict/code.enum.js';
+import { ResponseService } from '@/service/response.service.js';
+import { Catch, Config, Context, ILogger, Logger } from '@midwayjs/core';
+import { MidwayI18nService } from '@midwayjs/i18n';
+import { ValidationError } from '@sequelize/core';
+
+@Catch()
+export class DefaultErrorFilter {
+  @Config('debug')
+  debug?: boolean;
+  @Logger()
+  logger: ILogger;
+  protected resposes: ResponseService;
+
+  constructor() {
+    this.resposes = new ResponseService();
+  }
+
+  async catch(err: Error | ValidationError, ctx: Context) {
+    this.logger.error(err, ctx);
+    // 所有的未分类错误会到这里
+    const i18n = await ctx.requestContext.getAsync(MidwayI18nService);
+    return this.resposes.error(
+      this.debug ? err.message + ((err as ValidationError).errors ? '; ' + (err as ValidationError).errors.join('、') : '') : i18n.translate('未知异常请联系管理员'),
+      CodeEunm.Error,
+    );
+  }
+}

package/template/meadmin/src/filter/forbidden.filter.ts

@@ -0,0 +1,15 @@
+import { CodeEunm } from '@/dict/code.enum.js';
+import { ResponseService } from '@/service/response.service.js';
+import { Catch, httpError } from '@midwayjs/core';
+
+@Catch(httpError.ForbiddenError)
+export class ForbiddenErrorFilter {
+  protected resposes: ResponseService;
+  constructor() {
+    this.resposes = new ResponseService();
+  }
+
+  async catch(err: Error) {
+    return this.resposes.error(err.message, CodeEunm.Forbidden);
+  }
+}

package/template/meadmin/src/filter/index.ts

@@ -0,0 +1,6 @@
+import { BadRequestFilter } from './badRequest.filter.js';
+import { DefaultErrorFilter } from './default.filter.js';
+import { NotFoundFilter } from './notfound.filter.js';
+import { UnauthorizedErrorFilter } from './unauthorized.filter.js';
+import { ValidateErrorFilter } from './validate.filter.js';
+export const filters = [DefaultErrorFilter, NotFoundFilter, UnauthorizedErrorFilter, ValidateErrorFilter, BadRequestFilter];

package/template/meadmin/src/filter/notfound.filter.ts

@@ -0,0 +1,10 @@
+import { Catch, httpError } from '@midwayjs/core';
+
+@Catch(httpError.NotFoundError)
+export class NotFoundFilter {
+  async catch() {
+    // 404 错误会到这里
+    // ctx.redirect('/404.html');
+    return '404';
+  }
+}

package/template/meadmin/src/filter/unauthorized.filter.ts

@@ -0,0 +1,15 @@
+import { CodeEunm } from '@/dict/code.enum.js';
+import { ResponseService } from '@/service/response.service.js';
+import { Catch, httpError } from '@midwayjs/core';
+
+@Catch(httpError.UnauthorizedError)
+export class UnauthorizedErrorFilter {
+  protected resposes: ResponseService;
+  constructor() {
+    this.resposes = new ResponseService();
+  }
+
+  async catch(err: Error) {
+    return this.resposes.error(err.message, CodeEunm.Unauthorized);
+  }
+}

package/template/meadmin/src/filter/validate.filter.ts

@@ -0,0 +1,23 @@
+import { CodeEunm } from '@/dict/code.enum.js';
+import { extractBracesContent } from '@/helper/utils.js';
+import { ResponseService } from '@/service/response.service.js';
+import { Catch, Context } from '@midwayjs/core';
+import { MidwayI18nService } from '@midwayjs/i18n';
+import { MidwayValidationError } from '@midwayjs/validate';
+
+@Catch(MidwayValidationError)
+export class ValidateErrorFilter {
+  protected resposes: ResponseService;
+  constructor() {
+    this.resposes = new ResponseService();
+  }
+
+  async catch(err: MidwayValidationError, ctx: Context) {
+    const args = {} as Record<string, string>;
+    const i18n = await ctx.requestContext.getAsync(MidwayI18nService);
+    extractBracesContent(err.message).forEach((v) => {
+      args[v] = i18n.translate(v);
+    });
+    return this.resposes.error(i18n.translate('参数校验错误:') + i18n.translate(err.message, { args }), CodeEunm.ValidateFail);
+  }
+}

package/template/meadmin/src/helper/dotenv.ts

@@ -0,0 +1,13 @@
+import dotenv from 'dotenv';
+// 根据当前环境加载不同的 .env 文件
+if (process.env.NODE_ENV) {
+  dotenv.config({
+    path: ['.env', `.env.${process.env.NODE_ENV}`],
+    override: true,
+  });
+} else {
+  dotenv.config({
+    path: ['.env'],
+    override: true,
+  });
+}

package/template/meadmin/src/helper/dto.ts

@@ -0,0 +1,195 @@
+import { getClassExtendedMetadata, getPropertyType, INJECT_CUSTOM_PROPERTY, saveClassMetadata } from '@midwayjs/core';
+import { Dto, OmitDto, PickDto } from '@midwayjs/validate';
+
+import { DECORATORS } from '@midwayjs/swagger/dist/constants.js';
+import { RULES_KEY } from '@midwayjs/validate/dist/constants.js';
+import { cloneDeep } from 'lodash-es';
+
+/**
+ * PickDto 用于从现有的 DTO 中获取一些属性，变成新的 DTO，
+ * 兼容swagger和validate
+ * @param dto
+ * @param keys
+ * @returns
+ */
+export function PickDtoType<T, K extends Array<keyof T>>(dto: Dto<T>, keys: K): Dto<Pick<T, K[number]>> {
+  const pickedDto = PickDto(dto, keys);
+  pickedDto.prototype = Object.prototype;
+  const fatherProperties = getClassExtendedMetadata(INJECT_CUSTOM_PROPERTY, dto) ?? {};
+  const pickedProperties: any = {};
+  for (const key of keys) {
+    if (fatherProperties[key] && fatherProperties[key].key === DECORATORS.API_MODEL_PROPERTIES) {
+      pickedProperties[key] = fatherProperties[key];
+      pickedProperties[key].metadata.type = pickedProperties[key].metadata.type ?? getPropertyType(dto.prototype, key as string).name;
+    }
+  }
+  saveClassMetadata(INJECT_CUSTOM_PROPERTY, pickedProperties, pickedDto);
+  return pickedDto;
+}
+
+/**
+ * OmitDto 用于将其中某些属性剔除，变成新的 DTO
+ * 兼容swagger和validate
+ * @param dto
+ * @param keys
+ * @returns
+ */
+export function OmitDtoType<T, K extends Array<keyof T>>(dto: Dto<T>, keys: K): Dto<Omit<T, K[number]>> {
+  let pickedDto = function () {} as any;
+  if (keys.length) {
+    pickedDto = OmitDto(dto, keys);
+    pickedDto.prototype = Object.prototype;
+  } else {
+    const fatherRule = getClassExtendedMetadata(RULES_KEY, dto);
+    const partitalRule: any = {};
+    for (const key of Object.keys(fatherRule)) {
+      if (fatherRule[key]) {
+        partitalRule[key] = cloneDeep(fatherRule[key]);
+      }
+    }
+    saveClassMetadata(RULES_KEY, partitalRule, pickedDto);
+  }
+  //设置swagger properties定义
+  const fatherProperties = getClassExtendedMetadata(INJECT_CUSTOM_PROPERTY, dto) ?? {};
+  const pickedProperties: any = {};
+  for (const key of Object.keys(fatherProperties)) {
+    if (fatherProperties[key].key === DECORATORS.API_MODEL_PROPERTIES && !keys.includes(key as any)) {
+      pickedProperties[key] = fatherProperties[key];
+      pickedProperties[key].metadata.type = pickedProperties[key].metadata.type ?? getPropertyType(dto.prototype, key as string).name;
+    }
+  }
+  saveClassMetadata(INJECT_CUSTOM_PROPERTY, pickedProperties, pickedDto);
+  return pickedDto;
+}
+
+/**
+ * 将属性设置为可选
+ * 兼容swagger和validate
+ * @param dto
+ * @param keys 传入属性数组则只将对应的属性设置为可选。否则将所有属性设置为可选
+ * @returns
+ */
+export function PartialType<T, K extends Array<keyof T>>(
+  dto: Dto<T>,
+  keys?: K,
+): K extends unknown
+  ? Dto<Partial<T>>
+  : Dto<
+      Omit<T, K[number]> & {
+        [P in K[number]]?: T[P];
+      }
+    > {
+  //重新声明校验规则并设置为可选
+  const partitalDto = function () {} as any;
+  const fatherRule = getClassExtendedMetadata(RULES_KEY, dto);
+  const partitalRule: any = {};
+  for (const key of Object.keys(fatherRule)) {
+    if (fatherRule[key]) {
+      partitalRule[key] = cloneDeep(fatherRule[key]);
+      if (!keys || keys.includes(key as any)) {
+        partitalRule[key] = partitalRule[key].optional();
+        if (partitalRule[key].type === 'string') {
+          partitalRule[key] = partitalRule[key].empty('');
+        }
+      }
+    }
+  }
+  saveClassMetadata(RULES_KEY, partitalRule, partitalDto);
+  //设置swagger properties定义
+  const fatherProperties = getClassExtendedMetadata(INJECT_CUSTOM_PROPERTY, dto) ?? {};
+  const partitalProperties: any = {};
+  for (const key of Object.keys(fatherProperties)) {
+    if (fatherProperties[key].key === DECORATORS.API_MODEL_PROPERTIES) {
+      partitalProperties[key] = cloneDeep(fatherProperties[key]);
+      if (!keys || keys.includes(key as any)) {
+        partitalProperties[key].metadata.required = false;
+      }
+      partitalProperties[key].metadata.type = partitalProperties[key].metadata.type ?? getPropertyType(dto.prototype, key as string).name;
+    }
+  }
+  saveClassMetadata(INJECT_CUSTOM_PROPERTY, partitalProperties, partitalDto);
+  return partitalDto;
+}
+
+/**
+ * 将属性设置为必填
+ * 兼容swagger和validate
+ * @param dto
+ * @param keys 传入属性数组则只将对应的属性设置为必填。否则将所有属性设置为必填
+ * @returns
+ */
+export function RequiredType<T, K extends Array<keyof T>>(
+  dto: Dto<T>,
+  keys?: K,
+): K extends unknown
+  ? Dto<Required<T>>
+  : Dto<
+      Omit<T, K[number]> & {
+        [P in K[number]]-?: T[P];
+      }
+    > {
+  //重新声明校验规则并设置为可选
+  const requiredDto: any = function () {};
+  const fatherRule = getClassExtendedMetadata(RULES_KEY, dto);
+  const requiredRule: any = {};
+  for (const key of Object.keys(fatherRule)) {
+    if (fatherRule[key]) {
+      requiredRule[key] = cloneDeep(fatherRule[key]);
+      if (!keys || keys.includes(key as any)) {
+        requiredRule[key] = requiredRule[key].required();
+        if (requiredRule[key].type === 'string') {
+          requiredRule[key] = requiredRule[key].empty('');
+        }
+      }
+    }
+  }
+  saveClassMetadata(RULES_KEY, requiredRule, requiredDto);
+  //设置swagger properties定义
+  const fatherProperties = getClassExtendedMetadata(INJECT_CUSTOM_PROPERTY, dto) ?? {};
+  const partitalProperties: any = {};
+  for (const key of Object.keys(fatherProperties)) {
+    if (fatherProperties[key].key === DECORATORS.API_MODEL_PROPERTIES) {
+      partitalProperties[key] = cloneDeep(fatherProperties[key]);
+      if (!keys || keys.includes(key as any)) {
+        partitalProperties[key].metadata.required = false;
+      }
+      partitalProperties[key].metadata.type = partitalProperties[key].metadata.type ?? getPropertyType(dto.prototype, key as string).name;
+    }
+  }
+  saveClassMetadata(INJECT_CUSTOM_PROPERTY, partitalProperties, requiredDto);
+  return requiredDto;
+}
+
+/**
+ * 两种类型合并为一种新类型,结合了两种类型的所有属性
+ * 兼容swagger和validate
+ * @param dto1
+ * @param dto2
+ * @returns
+ */
+export function IntersectionType<T1, T2>(dto1: Dto<T1>, dto2: Dto<T2>): Dto<T1 & T2> {
+  //重新声明校验规则
+  const dto: any = function () {};
+  const fatherRule1 = getClassExtendedMetadata(RULES_KEY, dto1);
+  const fatherRule2 = getClassExtendedMetadata(RULES_KEY, dto2);
+  const rule = Object.assign({}, fatherRule1, fatherRule2);
+  saveClassMetadata(RULES_KEY, rule, dto);
+  //设置swagger properties定义
+  const fatherProperties1 = getClassExtendedMetadata(INJECT_CUSTOM_PROPERTY, dto1) ?? {};
+  const fatherProperties2 = getClassExtendedMetadata(INJECT_CUSTOM_PROPERTY, dto2) ?? {};
+  const properties: any = {};
+  for (const key of Object.keys(fatherProperties1)) {
+    if (fatherProperties1[key].key === DECORATORS.API_MODEL_PROPERTIES) {
+      properties[key] = fatherProperties1[key];
+      properties[key].metadata.type = properties[key].metadata.type ?? getPropertyType(dto1.prototype, key).name;
+    }
+  }
+  for (const key of Object.keys(fatherProperties2)) {
+    if (fatherProperties2[key].key === DECORATORS.API_MODEL_PROPERTIES) {
+      properties[key] = fatherProperties2[key];
+      properties[key].metadata.type = properties[key].metadata.type ?? getPropertyType(dto2.prototype, key).name;
+    }
+  }
+  saveClassMetadata(INJECT_CUSTOM_PROPERTY, properties, dto);
+  return dto;
+}

package/template/meadmin/src/helper/snowflake.ts

@@ -0,0 +1,50 @@
+export class CustomSnowflake {
+  private workerId: number; // 机器ID，10位机器码，最大值1023
+  private sequence = 0; // 序列号
+  private lastTimestamp = -1; // 上次生成ID的时间戳
+  private epoch; // 初始时间戳，可自定义
+  constructor(workerId, epoch = 1609459200000) {
+    this.workerId = workerId; // 机器ID
+    this.epoch = epoch; // 初始时间戳，可自定义
+  }
+
+  // 生成下一个ID的方法
+  nextId() {
+    let timestamp = Date.now();
+
+    // 如果当前时间小于上次生成ID的时间，抛出异常
+    if (timestamp < this.lastTimestamp) {
+      throw new Error('Clock moved backwards, refusing to generate id');
+    }
+
+    // 如果当前时间与上次生成ID的时间相同，则递增序列号
+    if (timestamp === this.lastTimestamp) {
+      this.sequence = (this.sequence + 1) & 4095; // 12位序列号
+
+      // 如果序列号达到最大值，等待下一毫秒
+      if (this.sequence === 0) {
+        timestamp = this.waitNextMillis(timestamp);
+      }
+    } else {
+      this.sequence = 0; // 重置序列号
+    }
+
+    this.lastTimestamp = timestamp; // 更新上次生成ID的时间戳
+
+    // 生成ID，包括时间戳、机器ID和序列号
+    const id = ((BigInt(timestamp - this.epoch) << 22n) | (BigInt(this.workerId) << 10n) | BigInt(this.sequence)).toString(10);
+    return id;
+  }
+
+  // 等待下一毫秒的方法
+  waitNextMillis(timestamp: number) {
+    while (timestamp <= this.lastTimestamp) {
+      timestamp = Date.now();
+    }
+    return timestamp;
+  }
+}
+const customSnowflake = new CustomSnowflake(0); // 设置机器ID为0
+export const uuid = () => {
+  return customSnowflake.nextId();
+};

package/template/meadmin/src/helper/utils.ts

@@ -0,0 +1,57 @@
+import { formatWithArray, formatWithObject } from '@midwayjs/i18n/dist/utils.js';
+import { clone } from 'lodash-es';
+
+export type TreeArrayItem<T, C extends string | number> = { [K in C]: TreeArrayItem<T, C>[] } & T;
+/**
+ * 数组转为树结构
+ * @param arr
+ * @param key
+ * @param parentKey
+ * @param childrenKey
+ * @returns
+ */
+export function listToTree<T extends Record<string, any>>(arr: T[], key: keyof T = 'id' as const, parentKey: keyof T = 'parentId' as const, childrenKey = 'children' as const) {
+  const treeNode = new Map();
+  const newArr = clone(arr);
+  newArr.forEach((item) => {
+    (item as any)[childrenKey] = [];
+    treeNode.set(item[key], item);
+  });
+  const rootArr = [] as Array<TreeArrayItem<T, typeof childrenKey>>;
+  arr.forEach((item) => {
+    const parentNode = treeNode.get(item[parentKey]);
+    if (parentNode) {
+      parentNode[childrenKey].push(item);
+    } else {
+      rootArr.push(treeNode.get(item[key]));
+    }
+  });
+  return rootArr;
+}
+
+/**
+ * 提取大括号内容
+ * @param text 监测的值
+ * @returns
+ */
+export function extractBracesContent(text: string) {
+  const result = [];
+  const stack = [];
+  for (let i = 0; i < text.length; i++) {
+    if (text[i] === '{') {
+      stack.push(i);
+    } else if (text[i] === '}' && stack.length > 0) {
+      const start = stack.pop();
+      result.push(text.substring(start + 1, i));
+    }
+  }
+  return result;
+}
+
+export function formatText(message: string, args: Array<string | number> | Record<string, string | number>) {
+  if (Array.isArray(args)) {
+    return formatWithArray(message, args);
+  } else {
+    return formatWithObject(message, args);
+  }
+}

package/template/meadmin/src/interface.ts

@@ -0,0 +1,12 @@
+/**
+ * @description User-Service parameters
+ */
+export interface IUserOptions {
+  uid: number;
+}
+
+declare module '@midwayjs/core' {
+  export interface MidwayConfig {
+    debug?: boolean;
+  }
+}

package/template/meadmin/src/locales/en.json

@@ -0,0 +1,13 @@
+{
+  "参数校验错误:": "Check parameter error:",
+  "操作成功": "Successfully",
+  "列表数据获取成功": "The list data was successfully obtained",
+  "没有对应的信息": "There is no corresponding information.",
+  "错误的{key}": "Incorrect {key}",
+  "用户名": "Username",
+  "密码": "Password",
+  "验证码": "Captcha",
+  "验证码标识": "Captcha identifier",
+  "验证码错误或已过期": "The verification code is incorrect or has expired",
+  "未知异常请联系管理员": "Unknown error, please contact the administrator"
+}

package/template/meadmin/src/logger.ts

@@ -0,0 +1,24 @@
+import { ILogger } from '@midwayjs/core';
+
+export let appLogger: ILogger = {
+  info: console.log,
+  debug: console.log,
+  error: console.log,
+  warn: console.log,
+}; //应用logger 必须在ready 后调用
+export let coreLogger: ILogger = {
+  info: console.log,
+  debug: console.log,
+  error: console.log,
+  warn: console.log,
+}; //框架级别logger 必须在ready 后调用
+
+/**
+ * 初始化log方法
+ * @param appLoggerFn
+ * @param coreLoggerFn
+ */
+export const initLogger = (appLoggerFn: ILogger, coreLoggerFn: ILogger) => {
+  appLogger = appLoggerFn;
+  coreLogger = coreLoggerFn;
+};

package/template/meadmin/src/middleware/report.middleware.ts

@@ -0,0 +1,23 @@
+import { IMiddleware, Middleware } from '@midwayjs/core';
+import { Context, NextFunction } from '@midwayjs/koa';
+
+@Middleware()
+export class ReportMiddleware implements IMiddleware<Context, NextFunction> {
+  resolve() {
+    return async (ctx: Context, next: NextFunction) => {
+      // 控制器前执行的逻辑
+      const startTime = Date.now();
+      // 执行下一个 Web 中间件，最后执行到控制器
+      // 这里可以拿到下一个中间件或者控制器的返回值
+      const result = await next();
+      // 控制器之后执行的逻辑
+      ctx.logger.info(`Report in "src/middleware/report.middleware.ts", rt = ${Date.now() - startTime}ms`);
+      // 返回给上一个中间件的结果
+      return result;
+    };
+  }
+
+  static getName(): string {
+    return 'report';
+  }
+}

package/template/meadmin/src/response/apiBase.res.ts

@@ -0,0 +1,12 @@
+import { CodeEunm } from '@/dict/code.enum.js';
+import { ApiProperty } from '@midwayjs/swagger';
+
+export class ApiBaseRes {
+  @ApiProperty({
+    description: '状态码:200=成功;401=未登录;403=没有权限;400=失败(业务错误);402=校验失败;500=系统异常',
+    type: 'string',
+  })
+  code: CodeEunm;
+  @ApiProperty({ description: '状态信息', type: 'string' })
+  msg: string;
+}

package/template/meadmin/src/response/apiError.res.ts

@@ -0,0 +1,6 @@
+import { CodeEunm } from '@/dict/code.enum.js';
+import { ApiBaseRes } from './apiBase.res.js';
+
+export class ApiErrorRes extends ApiBaseRes {
+  declare code: Exclude<CodeEunm, CodeEunm.Success>;
+}

package/template/meadmin/src/response/apiPage.res.ts

@@ -0,0 +1,19 @@
+import { ApiProperty } from '@midwayjs/swagger';
+import { ApiSuccessRes } from './apiSuccess.res.js';
+
+export class PageRes<T = any> {
+  @ApiProperty({ description: '分页页码', type: 'integer' })
+  page: number;
+  @ApiProperty({ description: '每页记录数', type: 'integer' })
+  pageSize: number;
+  @ApiProperty({ description: '总数量', type: 'integer' })
+  total: number;
+  @ApiProperty({
+    description: '列表数据',
+    type: 'array',
+    items: { type: 'object' },
+  })
+  list: T[];
+}
+
+export class ApiPageRes<T = any> extends ApiSuccessRes<PageRes<T>> {}

package/template/meadmin/src/response/apiSuccess.res.ts

@@ -0,0 +1,17 @@
+import { CodeEunm } from '@/dict/code.enum.js';
+import { ApiProperty } from '@midwayjs/swagger';
+import { ApiBaseRes } from './apiBase.res.js';
+
+export class EmptyClass {}
+
+export class ApiSuccessRes<T extends NonNullable<any>> extends ApiBaseRes {
+  declare code: CodeEunm.Success;
+  @ApiProperty({ description: '数据,code非200时值为undefined', type: 'object' })
+  data: T;
+}
+
+export class ApiSuccessResArr<T extends NonNullable<any>> extends ApiBaseRes {
+  declare code: CodeEunm.Success;
+  @ApiProperty({ description: '数据,code非200时值为undefined', type: 'array' })
+  data: T;
+}

package/template/meadmin/src/ruleType/index.ts

@@ -0,0 +1,3 @@
+import { RuleType as DefaultRuleType } from '@midwayjs/validate';
+import { initRuleType as initStringRule } from './string.js';
+export const RuleType = initStringRule(DefaultRuleType);