create-meadminjs 1.0.0

package/template/meadmin/view/admin/src/api/example/demo.ts

@@ -0,0 +1,189 @@
+import { PageParam, PageResult } from '@/api/api.model.js';
+import { FileInfo } from '@/api/file.js';
+import { SystemAdminInfo } from '@/api/system/admin.js';
+import request, { RequestOptions } from '@/utils/request.js';
+
+//示例_Demo
+export class ExampleDemo {
+  mobile = '' as string | null; //手机号
+  type = undefined as 0 | 1 | 2 | undefined; //类型:0=书籍;1=电子产品;2=卡片
+  name = '' as string; //名称
+  books = [] as Array<ExampleBook>; //书籍
+  user = undefined as User | null | undefined; //用户
+  avatar = undefined as FileInfo | null | undefined; //头像
+  files = [] as Array<FileInfo>; //附件
+}
+
+//示例_书籍
+export type ExampleBook = {
+  createdAdmin: SystemAdminInfo | null; //创建者
+  updatedAdmin: SystemAdminInfo | null; //最后更新者
+  id: string; //ID
+  name: string; //名称
+  createdAt: string; //创建时间
+  updatedAt: string; //最后更新时间
+};
+
+//用户
+export type User = {
+  id: string; //ID
+  username: string; //用户名
+  nickname: string; //昵称
+  password: string; //密码
+  avatar: UserFile | null; //头像
+  email: string | null; //邮箱
+  mobile: string | null; //手机号
+  loginFailure: number; //登录失败次数
+  lastLoginAt: string | null; //最后登录时间
+  lastLoginIp: string; //最后登录ip
+  status: 1 | 0; //状态:1=启用;0=禁用
+  createdUserId: string | null; //创建者Id
+  createdUser: User | null; //创建者
+  updatedUser: User | null; //最后更新者
+  createdAt: string; //创建时间
+  updatedAt: string; //最后更新时间
+};
+
+//用户附件表(前台)
+export type UserFile = {
+  createdUserId: string | null; //创建者Id
+  createdUser: User | null; //创建者
+  updatedUser: User | null; //最后更新者
+  id: string; //ID
+  name: string; //文件名
+  path: string; //路径
+  mimeType: string; //mime类型
+  size: number | null; //文件大小
+  storage: string; //存储引擎
+  md5: string; //文件MD5值
+  url: string | null; //文件url
+  createdAt: string; //创建时间
+  updatedAt: string; //最后更新时间
+};
+
+//获取用户信息
+export function getUserApi() {
+  return request<
+    PageResult<User>,
+    [
+      {
+        id?: string;
+        username?: string;
+        page: number;
+        pageSize: number;
+      },
+    ]
+  >(
+    (data) => ({
+      url: 'example/demo/getUser',
+      method: 'post',
+      data: data,
+    }),
+    { noLoading: true },
+  );
+}
+
+//获取示例_书籍信息
+export function getExampleBookApi() {
+  return request<
+    PageResult<ExampleBook>,
+    [
+      {
+        id?: string;
+        name?: string;
+        page: number;
+        pageSize: number;
+      },
+    ]
+  >(
+    (data) => ({
+      url: 'example/demo/getExampleBook',
+      method: 'post',
+      data: data,
+    }),
+    { noLoading: true },
+  );
+}
+
+export type ExampleDemoInfo = ExampleDemo & {
+  id: string; //ID
+  createdAt: string; //创建时间
+  updatedAt: string; //最后更新时间
+  createdAdmin: SystemAdminInfo | null; //创建者
+  updatedAdmin: SystemAdminInfo | null; //最后更新者
+};
+//添加示例_Demo信息
+export function addExampleDemoApi() {
+  return request<ExampleDemoInfo, [ExampleDemo]>(
+    (data) => ({
+      url: 'example/demo/add',
+      method: 'post',
+      data: data,
+    }),
+    { success: true },
+  );
+}
+
+export type ExampleDemoListResult = PageResult<ExampleDemoInfo>;
+export class ExampleDemoListParam extends PageParam {
+  createdAdmin?: SystemAdminInfo | null; //创建者
+  updatedAdmin?: SystemAdminInfo | null; //最后更新者
+  id?: string; //ID
+  mobile?: string | null; //手机号
+  type?: 0 | 1 | 2; //类型:0=书籍;1=电子产品;2=卡片
+  name?: string; //名称
+  books?: Array<ExampleBook>; //书籍
+  user?: User | null; //用户
+  avatar?: FileInfo | null; //头像
+  files?: Array<FileInfo>; //附件
+  startCreatedAt?: string; //创建时间(起)
+  endCreatedAt?: string; //创建时间(止)
+  startUpdatedAt?: string; //最后更新时间(起)
+  endUpdatedAt?: string; //最后更新时间(止)
+}
+//获取示例_Demo列表
+export function exampleDemoListApi(options?: RequestOptions<ExampleDemoListResult, [ExampleDemoListParam]>) {
+  return request<ExampleDemoListResult, [ExampleDemoListParam]>(
+    (data) => ({
+      url: 'example/demo/',
+      method: 'post',
+      data: data,
+    }),
+    Object.assign({ noLoading: true, clearEmpty: ['', undefined, null] }, options),
+  );
+}
+
+//根据id获取示例_Demo详情
+export function exampleDemoInfoApi(options?: RequestOptions<ExampleDemoInfo, [string]>) {
+  return request<ExampleDemoInfo, [string]>(
+    (id) => ({
+      url: `example/demo/info/${id}`,
+      method: 'get',
+    }),
+    Object.assign({ noLoading: true }, options),
+  );
+}
+
+export type UpdateExampleDemoInfoParam = Omit<Partial<ExampleDemoInfo>, 'id' | 'createdAt' | 'updatedAt' | 'createdAdmin' | 'updatedAdmin'>;
+//修改示例_Demo信息
+export function updateExampleDemoApi(options?: RequestOptions<ExampleDemoInfo, [string, UpdateExampleDemoInfoParam]>) {
+  return request<ExampleDemoInfo, [string, UpdateExampleDemoInfoParam]>(
+    (id, data) => ({
+      url: `example/demo/up/${id}`,
+      method: 'post',
+      data: data,
+    }),
+    Object.assign({ success: true, noLoading: true }, options),
+  );
+}
+
+//删除示例_Demo
+export function delExampleDemoApi(options?: RequestOptions<null, [string]>) {
+  return request<null, [string]>(
+    (id) => ({
+      url: `example/demo/del/${id}`,
+      method: 'post',
+    }),
+    Object.assign({ noLoading: true }, options),
+  );
+}

package/template/meadmin/view/admin/src/api/file.ts

@@ -0,0 +1,124 @@
+import { PageParam, PageResult } from '@/api/api.model.js';
+import request, { RequestOptions } from '@/utils/request.js';
+import { SystemAdminInfo } from './system/admin.js';
+
+//附件
+export class File {
+  id?: string; //ID
+  name = '' as string; //文件名
+  path = '' as string; //路径
+  mimeType = '' as string; //mime类型
+  size = undefined as number | null | undefined; //文件大小(字节)
+  storage = '' as string; //存储引擎
+  url = ''; //访问地址
+}
+
+export type FileInfo = Required<File> & {
+  id: string; //ID
+  createdAdmin: Omit<SystemAdminInfo, 'roles' | 'roleMenus'>;
+  updatedAdmin: Omit<SystemAdminInfo, 'roles' | 'roleMenus'>;
+  size: number;
+  createdAt: string; //创建时间
+  updatedAt: string; //最后更新时间
+};
+
+/**
+ * 上传文件
+ * FormData参数说明
+ * file File 文件
+ * md5 string  md5值
+ * sharding '0'|'1' 分片上传:0=否;1=是
+ * chunkMd5 string 当前分片md5值
+ * chunkIndex string 当前片序号(从0开始)
+ * start string 当前分片起止位置(从0开始)
+ * over string 是否结束(需确保最后一个分片上传时其他分片请求已完成):0=否;1=是
+ *
+ * @returns
+ */
+export function uploadFileApi<T extends boolean = true>(returnAxios = true as T) {
+  return request<Partial<FileInfo>, [FormData], T>(
+    (data) => ({
+      url: 'file/upload',
+      method: 'post',
+      data: data,
+      headers: {
+        'Content-Type': 'multipart/form-data',
+      },
+    }),
+    { success: false, noLoading: true },
+    returnAxios,
+  );
+}
+
+export type FileListResult = PageResult<FileInfo>;
+export class FileListParam extends PageParam {
+  id?: string; //ID
+  name?: string; //文件名
+  path?: string; //路径
+  mimeType?: string; //mime类型
+  size?: number | null; //文件大小(字节)
+  storage?: string; //存储引擎
+  startCreatedAt?: string; //创建时间(起)
+  endCreatedAt?: string; //创建时间(止)
+  startUpdatedAt?: string; //最后更新时间(起)
+  endUpdatedAt?: string; //最后更新时间(止)
+  createdAdminId?: string; //创建者id
+}
+//获取附件列表
+export function fileListApi(options?: RequestOptions<FileListResult, [FileListParam]>) {
+  return request<FileListResult, [FileListParam]>(
+    (data) => ({
+      url: 'file/',
+      method: 'post',
+      data: data,
+    }),
+    Object.assign({ noLoading: true, clearEmpty: ['', undefined, null] }, options),
+  );
+}
+
+//获取我的附件列表
+export function fileMyListApi(options?: RequestOptions<FileListResult, [Omit<FileListParam, 'createdAdminId'>]>) {
+  return request<FileListResult, [Omit<FileListParam, 'createdAdminId'>]>(
+    (data) => ({
+      url: 'file/my',
+      method: 'post',
+      data: data,
+    }),
+    Object.assign({ noLoading: true, clearEmpty: ['', undefined, null] }, options),
+  );
+}
+
+//根据id获取附件详情
+export function fileInfoApi(options?: RequestOptions<FileInfo, [string]>) {
+  return request<FileInfo, [string]>(
+    (id) => ({
+      url: `file/info/${id}`,
+      method: 'get',
+    }),
+    options,
+  );
+}
+
+export type UpdateFileInfoParam = Omit<Partial<FileInfo>, 'id' | 'createdAt' | 'updatedAt' | 'createdAdmin'>;
+//修改附件信息
+export function updateFileApi(options?: RequestOptions<FileInfo, [string, UpdateFileInfoParam]>) {
+  return request<FileInfo, [string, UpdateFileInfoParam]>(
+    (id, data) => ({
+      url: `file/up/${id}`,
+      method: 'post',
+      data: data,
+    }),
+    Object.assign({ success: true, noLoading: true }, options),
+  );
+}
+
+//删除附件
+export function delFileApi(options?: RequestOptions<null, [string]>) {
+  return request<null, [string]>(
+    (id) => ({
+      url: `file/del/${id}`,
+      method: 'post',
+    }),
+    Object.assign({ noLoading: true }, options),
+  );
+}

package/template/meadmin/view/admin/src/api/login.ts

@@ -0,0 +1,55 @@
+import request from '@/utils/request';
+import { SystemAdminInfo } from './system/admin.js';
+import { SystemMenuInfo } from './system/menu.js';
+
+//获取登录验证码
+export function loginCaptchaApi<T extends boolean = false>(returnAxios: T = false as T, noLoading = true) {
+  return request<{ id: string; imageBase64: string }, [number?, number?], T>(
+    (width = 100, height = 30) => ({
+      url: 'login/captcha',
+      method: 'get',
+      params: { width, height },
+    }),
+    { noLoading },
+    returnAxios,
+  );
+}
+
+// 登录
+export class LoginParams {
+  username = '';
+  password = '';
+  captcha = '';
+  captchaId = '';
+}
+export interface LoginResult {
+  token: string;
+}
+export function loginApi<T extends boolean = true>(returnAxios: T = true as T) {
+  return request<LoginResult, [LoginParams], T>(
+    (params) => ({
+      url: 'login/login',
+      method: 'post',
+      data: params,
+    }),
+    {},
+    returnAxios,
+  );
+}
+
+// 获取用户详细信息
+export interface UserInfo {
+  btnRules: string[]; // 按钮权限
+  info: SystemAdminInfo;
+  menus: SystemMenuInfo[];
+}
+export function userInfoApi<T extends boolean = false>(returnAxios: T = false as T, noLoading = true) {
+  return request<UserInfo, [], T>(
+    () => ({
+      url: 'login/info',
+      method: 'post',
+    }),
+    { noLoading },
+    returnAxios,
+  );
+}

package/template/meadmin/view/admin/src/api/system/admin.ts

@@ -0,0 +1,111 @@
+import { PageParam, PageResult } from '@/api/api.model.js';
+import request, { RequestOptions } from '@/utils/request.js';
+import { FileInfo } from '../file.js';
+import { SystemMenuInfo } from './menu.js';
+import { SystemRoleInfo } from './role.js';
+
+//管理员
+export class SystemAdmin {
+  username = '' as string; //用户名
+  nickname = '' as string; //昵称
+  password = '' as string; //密码
+  avatar = null as FileInfo | null; //头像
+  email = '' as string; //邮箱
+  mobile = '' as string; //手机号
+  status = 1 as 1 | 0 | undefined; //状态:1=启用;0=禁用
+  roleIds = [] as string[]; //具有的角色
+}
+
+export type SystemAdminInfo = Omit<SystemAdmin, 'roleIds'> & {
+  id: string; //ID
+  loginFailure: number | undefined; //登录失败次数
+  lastLoginAt: string | null; //最后登录时间
+  lastLoginIp: string; //最后登录ip
+  roles: Array<Omit<SystemRoleInfo, 'menus'>>;
+  roleMenus: NonNullable<SystemMenuInfo>;
+  createdAt: string; //创建时间
+  updatedAt: string; //最后更新时间
+  createdAdmin: Omit<SystemAdmin, 'createdAdmin' | 'updatedAdmin'> | null;
+  updatedAdmin: Omit<SystemAdmin, 'createdAdmin' | 'updatedAdmin'> | null;
+};
+//添加管理员信息
+export function addSystemAdminApi() {
+  return request<SystemAdminInfo, [SystemAdmin]>(
+    (data) => ({
+      url: 'system/admin/add',
+      method: 'post',
+      data: data,
+    }),
+    { success: true },
+  );
+}
+
+export type SystemAdminListResult = PageResult<SystemAdminInfo>;
+export class SystemAdminListParam extends PageParam {
+  id?: string; //ID
+  username?: string; //用户名
+  nickname?: string; //昵称
+  password?: string; //密码
+  avatar?: FileInfo | null; //头像
+  email?: string; //邮箱
+  mobile?: string; //手机号
+  loginFailure?: number; //登录失败次数
+  startLastLoginAt?: string | null; //最后登录时间(起)
+  endLastLoginAt?: string | null; //最后登录时间(止)
+  lastLoginIp?: string; //最后登录ip
+  status?: 1 | 0; //状态:1=启用;0=禁用
+  isSuper?: 1 | 0; //超级管理员:1=是;0=不是
+  roles?: Array<Omit<SystemRoleInfo, 'menus'>> | null; //具有的角色
+  startCreatedAt?: string; //创建时间(起)
+  endCreatedAt?: string; //创建时间(止)
+  startUpdatedAt?: string; //最后更新时间(起)
+  endUpdatedAt?: string; //最后更新时间(止)
+}
+//获取管理员列表
+export function systemAdminListApi(options?: RequestOptions<SystemAdminListResult, [SystemAdminListParam]>) {
+  return request<SystemAdminListResult, [SystemAdminListParam]>(
+    (data) => ({
+      url: 'system/admin/',
+      method: 'post',
+      data: data,
+    }),
+    Object.assign({ noLoading: true, clearEmpty: ['', undefined, null] }, options),
+  );
+}
+
+//根据id获取管理员详情
+export function systemAdminInfoApi(options?: RequestOptions<SystemAdminInfo, [string]>) {
+  return request<SystemAdminInfo, [string]>(
+    (id) => ({
+      url: `system/admin/info/${id}`,
+      method: 'get',
+    }),
+    Object.assign({ noLoading: true }, options),
+  );
+}
+
+export type UpdateSystemAdminInfoParam = Omit<Partial<SystemAdminInfo>, 'id' | 'loginFailure' | 'lastLoginAt' | 'lastLoginIp' | 'createdAt' | 'updatedAt' | 'createdAdmin' | 'updatedAdmin'> & {
+  roleIds: string[];
+};
+//修改管理员信息
+export function updateSystemAdminApi(options?: RequestOptions<SystemAdminInfo, [string, UpdateSystemAdminInfoParam]>) {
+  return request<SystemAdminInfo, [string, UpdateSystemAdminInfoParam]>(
+    (id, data) => ({
+      url: `system/admin/up/${id}`,
+      method: 'post',
+      data: data,
+    }),
+    Object.assign({ success: true, noLoading: true }, options),
+  );
+}
+
+//删除管理员
+export function delSystemAdminApi(options?: RequestOptions<null, [string]>) {
+  return request<null, [string]>(
+    (id) => ({
+      url: `system/admin/del/${id}`,
+      method: 'post',
+    }),
+    Object.assign({ noLoading: true }, options),
+  );
+}

package/template/meadmin/view/admin/src/api/system/menu.ts

@@ -0,0 +1,125 @@
+import { PageParam, PageResult } from '@/api/api.model.js';
+import { TreeArrayItem } from '@/utils/helper.js';
+import request, { RequestOptions } from '@/utils/request.js';
+import { SystemAdmin } from './admin.js';
+
+//菜单
+export class SystemMenu {
+  id?: string; //ID
+  parentId = '' as string | null; //父级id
+  title = '' as string; //菜单名称
+  menuType = undefined as 1 | 2 | 3 | undefined; //类型:1=目录;2=菜单;3=按钮
+  status = 1 as 1 | 0 | undefined; //状态:1=启用;0=禁用
+  rule = '' as string; //权限
+  orderNum = 999 as number | undefined; //排序(降序)
+  path = '' as string; //路径
+  isLink = 0 as 0 | 1 | undefined; //外链:1=是;0=否
+  component = '' as string; //组件路径(相对于views文件夹)
+  hideMenu = 0 as 0 | 1 | undefined; //隐藏:1=是;0=否
+  cache = 1 as 0 | 1 | undefined; //缓存:1=是;0=否
+  icon = '' as string; //图标
+  affix = 0 as 0 | 1 | undefined; //固定tag:1=是;0=否
+  alwaysShow = 0 as 0 | 1 | undefined; //恒定展示(只有一个子元素时不隐藏):1=是;0=否
+  breadcrumb = 1 as 0 | 1 | undefined; //面包屑:1=展示;0=不展示
+  createdAt = '' as string; //创建时间
+  updatedAt = '' as string; //最后更新时间
+}
+
+export type SystemMenuInfo = SystemMenu & {
+  id: string; //ID
+  createdAdmin: Omit<SystemAdmin, 'createdAdmin' | 'updatedAdmin'> | null;
+  updatedAdmin: Omit<SystemAdmin, 'createdAdmin' | 'updatedAdmin'> | null;
+};
+//添加菜单信息
+export function addSystemMenuApi() {
+  return request<SystemMenuInfo, [SystemMenu]>(
+    (data) => ({
+      url: 'system/menu/add',
+      method: 'post',
+      data: data,
+    }),
+    { success: true },
+  );
+}
+
+export type SystemMenuListResult = PageResult<SystemMenuInfo>;
+export class SystemMenuListParam extends PageParam {
+  parentId?: string | null; //父级id
+  id?: string; //ID
+  title?: string; //菜单名称
+  menuType?: 1 | 2 | 3; //类型:1=目录;2=菜单;3=按钮
+  status?: 1 | 0; //状态:1=启用;0=禁用
+  rule?: string; //权限
+  orderNum?: number; //排序(降序)
+  path?: string; //路径
+  isLink?: 0 | 1; //外链:1=是;0=否
+  component?: string; //组件路径(相对于views文件夹)
+  hideMenu?: 0 | 1; //隐藏:1=是;0=否
+  cache?: 0 | 1; //缓存:1=是;0=否
+  icon?: string; //图标
+  affix?: 0 | 1 | 2 | 3 | 4; //固定tag:1=是;0=否
+  alwaysShow?: 0 | 1; //恒定展示(只有一个子元素时不隐藏):1=是;0=否
+  breadcrumb?: 0 | 1; //面包屑:1=展示;0=不展示
+  startCreatedAt?: string; //创建时间(起)
+  endCreatedAt?: string; //创建时间(止)
+  startUpdatedAt?: string; //最后更新时间(起)
+  endUpdatedAt?: string; //最后更新时间(止)
+}
+//获取菜单列表
+export function systemMenuListApi(options?: RequestOptions<SystemMenuListResult, [SystemMenuListParam]>) {
+  return request<SystemMenuListResult, [SystemMenuListParam]>(
+    (data) => ({
+      url: 'system/menu/',
+      method: 'post',
+      data: data,
+    }),
+    Object.assign({ noLoading: true, clearEmpty: ['', undefined, null] }, options),
+  );
+}
+
+export type SystemMenuTreeAll = TreeArrayItem<SystemMenuInfo, 'children'>[];
+//获取树形结构
+export function systemMenuTreeAllApi(options?: RequestOptions<SystemMenuTreeAll, []>) {
+  return request<SystemMenuTreeAll, []>(
+    () => ({
+      url: 'system/menu/treeAll',
+      method: 'get',
+    }),
+    Object.assign({ noLoading: true }, options),
+  );
+}
+
+//根据id获取菜单详情
+export function systemMenuInfoApi(options?: RequestOptions<SystemMenuInfo, [string]>) {
+  return request<SystemMenuInfo & { parent?: SystemMenuInfo | null }, [string]>(
+    (id) => ({
+      url: `system/menu/info/${id}`,
+      method: 'get',
+    }),
+    Object.assign({ noLoading: true }, options),
+  );
+}
+
+export type UpdateSystemMenuInfoParam = Omit<Partial<SystemMenuInfo>, 'id' | 'createdAt' | 'updatedAt' | 'createdAdmin' | 'updatedAdmin'>;
+//修改菜单信息
+export function updateSystemMenuApi(options?: RequestOptions<SystemMenuInfo, [string, UpdateSystemMenuInfoParam]>) {
+  return request<SystemMenuInfo, [string, UpdateSystemMenuInfoParam]>(
+    (id, data) => ({
+      url: `system/menu/up/${id}`,
+      method: 'post',
+      data: data,
+    }),
+    Object.assign({ success: true, noLoading: true }, options),
+  );
+}
+
+//删除菜单
+export function delSystemMenuApi(options?: RequestOptions<null, [string]>) {
+  return request<null, [string]>(
+    (id) => ({
+      url: `system/menu/del/${id}`,
+      method: 'post',
+    }),
+    Object.assign({ noLoading: true }, options),
+  );
+}