npm - zt-admin-template - Versions diffs - 1.0.0 - Mend

zt-admin-template 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (80) hide show

package/package.json +11 -0
package/template/.env.development +2 -0
package/template/.env.production +2 -0
package/template/.env.test +2 -0
package/template/.kiro/specs/course-backend-integration/.config.kiro +1 -0
package/template/.kiro/specs/course-backend-integration/design.md +234 -0
package/template/.kiro/specs/course-backend-integration/requirements.md +116 -0
package/template/.kiro/specs/course-backend-integration/tasks.md +0 -0
package/template/COMPLETION_CHECKLIST.md +305 -0
package/template/DEPLOYMENT_GUIDE.md +391 -0
package/template/FINAL_SUMMARY.md +428 -0
package/template/IMPLEMENTATION_SUMMARY.md +382 -0
package/template/INTEGRATION_GUIDE.md +458 -0
package/template/PROJECT_OVERVIEW.md +343 -0
package/template/QUICK_START.md +273 -0
package/template/RBAC_Tutorial.md +424 -0
package/template/README.md +16 -0
package/template/React_Antd_TS_Tutorial.md +279 -0
package/template/START_ALL.md +163 -0
package/template/SYSTEM_MANAGEMENT.md +247 -0
package/template/eslint.config.js +29 -0
package/template/index.html +13 -0
package/template/koa-server/README.md +65 -0
package/template/koa-server/app.js +625 -0
package/template/koa-server/package-lock.json +1547 -0
package/template/koa-server/package.json +26 -0
package/template/koa-server/public/assets/index-B1Cj4mG9.css +1 -0
package/template/koa-server/public/assets/index-Mgxg-xqT.js +503 -0
package/template/koa-server/public/favicon.svg +1 -0
package/template/koa-server/public/icons.svg +24 -0
package/template/koa-server/public/index.html +14 -0
package/template/koa-server/uploads/1774265088480-962006467.png +0 -0
package/template/koa-server/uploads/file-1774346891704-610962013.png +0 -0
package/template/koa-server/uploads/file-1774346898887-58636533.png +0 -0
package/template/koa-server/uploads/file-1774346912676-771862547.png +0 -0
package/template/koa-server/uploads/file-1774347025308-130037894.png +0 -0
package/template/koa-server/uploads/file-1774347031104-766499773.png +0 -0
package/template/koa-server/uploads/file-1774347094969-731402203.png +0 -0
package/template/koa-server/uploads/file-1774347101948-330296656.png +0 -0
package/template/koa-server/uploads/file-1774351682377-932868720.png +0 -0
package/template/koa-server/uploads/file-1774352037654-877426905.png +0 -0
package/template/koa-server/uploads/file-1774352175463-386248997.png +0 -0
package/template/koa-server/uploads/file-1774361446433-405859961.png +0 -0
package/template/koa-server/uploads/file-1774361512207-465806267.png +0 -0
package/template/lianxi.html +15 -0
package/template/package-lock.json +6307 -0
package/template/package.json +36 -0
package/template/public/favicon.svg +1 -0
package/template/public/icons.svg +24 -0
package/template/src/App.css +184 -0
package/template/src/App.tsx +44 -0
package/template/src/api/course.ts +86 -0
package/template/src/api/menu.ts +55 -0
package/template/src/api/role.ts +58 -0
package/template/src/api/user.ts +58 -0
package/template/src/assets/hero.png +0 -0
package/template/src/assets/react.svg +1 -0
package/template/src/assets/vite.svg +1 -0
package/template/src/components/Child.tsx +10 -0
package/template/src/components/MainLayout.tsx +169 -0
package/template/src/components/SunZi.tsx +13 -0
package/template/src/contexts/ThemeContext.tsx +33 -0
package/template/src/hooks/usePermission.tsx +62 -0
package/template/src/index.css +111 -0
package/template/src/main.tsx +13 -0
package/template/src/pages/Dashboard.tsx +39 -0
package/template/src/pages/Users.tsx +95 -0
package/template/src/pages/banner/BannerList.tsx +182 -0
package/template/src/pages/course/Course.tsx +586 -0
package/template/src/pages/course/CourseList.tsx +168 -0
package/template/src/pages/system/menu/Menu.tsx +501 -0
package/template/src/pages/system/role/Role.tsx +458 -0
package/template/src/pages/system/user/User.tsx +364 -0
package/template/src/types/permission.ts +21 -0
package/template/src/utils/request.tsx +94 -0
package/template/src/vite-env.d.ts +1 -0
package/template/tsconfig.app.json +32 -0
package/template/tsconfig.json +7 -0
package/template/tsconfig.node.json +13 -0
package/template/vite.config.ts +30 -0

package/template/index.html ADDED Viewed

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>admin-system</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/template/koa-server/README.md ADDED Viewed

@@ -0,0 +1,65 @@
+# Admin System Backend Server
+基于 Koa 的后端服务器
+## 安装依赖
+```bash
+cd koa-server
+npm install
+```
+## 启动服务器
+### 开发模式（自动重启）
+```bash
+npm run dev
+```
+### 生产模式
+```bash
+npm start
+```
+服务器将在 `http://localhost:8080` 启动
+## API 端点
+### 用户管理
+- `GET /system/user/list` - 获取用户列表
+- `GET /system/user/:id` - 获取用户详情
+- `POST /system/user` - 新增用户
+- `PUT /system/user` - 编辑用户
+- `DELETE /system/user/:id` - 删除用户
+### 角色管理
+- `GET /system/role/list` - 获取角色列表
+- `GET /system/role/:id` - 获取角色详情
+- `POST /system/role` - 新增角色
+- `PUT /system/role` - 编辑角色
+- `DELETE /system/role/:id` - 删除角色
+### 菜单管理
+- `GET /system/menu/list` - 获取菜单列表
+- `GET /system/menu/:id` - 获取菜单详情
+- `POST /system/menu` - 新增菜单
+- `PUT /system/menu` - 编辑菜单
+- `DELETE /system/menu/:id` - 删除菜单
+## 响应格式
+所有 API 响应格式如下：
+```json
+{
+  "code": 200,
+  "message": "成功",
+  "data": {}
+}
+```
+## 错误处理
+- `200` - 成功
+- `404` - 资源不存在
+- `500` - 服务器错误

package/template/koa-server/app.js ADDED Viewed

@@ -0,0 +1,625 @@
+const Koa = require('koa');
+const Router = require('koa-router');
+const cors = require('koa-cors');
+const bodyParser = require('koa-bodyparser');
+const path = require('path');
+const static = require('koa-static');
+const multer = require('@koa/multer');
+const fs = require('fs');
+// 配置 multer
+const storage = multer.diskStorage({
+  destination: function (req, file, cb) {
+    const uploadPath = path.join(__dirname, 'uploads');
+    // 确保上传目录存在
+    if (!fs.existsSync(uploadPath)) {
+      fs.mkdirSync(uploadPath, { recursive: true });
+    }
+    cb(null, uploadPath);
+  },
+  filename: function (req, file, cb) {
+    const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1E9);
+    cb(null, file.fieldname + '-' + uniqueSuffix + path.extname(file.originalname));
+  }
+});
+const upload = multer({ storage: storage });
+// 创建 Koa 实例
+const app = new Koa();
+const router = new Router();
+// 中间件
+app.use(cors());
+app.use(bodyParser());
+// 静态文件服务
+const publicPath = path.join(__dirname, 'public');
+const uploadsPath = path.join(__dirname, 'uploads');
+console.log('Static paths:', publicPath, uploadsPath);
+app.use(static(publicPath));
+app.use(static(uploadsPath));
+// 模拟数据
+const users = [
+  {
+    id: '1',
+    username: 'admin',
+    nickName: '管理员',
+    userType: '管理员',
+    email: 'admin@qq.com',
+    phonenumber: '15888888888',
+    sex: '0',
+    status: 0,
+    delFlag: 0,
+    createTime: '2026-01-18 10:58:15',
+    dept: '研发部门',
+    roles: ['admin'],
+  },
+  {
+    id: '2',
+    username: 'test',
+    nickName: '测试员',
+    userType: '普通角色',
+    email: 'test@qq.com',
+    phonenumber: '15666666666',
+    sex: '1',
+    status: 0,
+    delFlag: 0,
+    createTime: '2026-01-18 10:58:15',
+    dept: '测试部门',
+    roles: ['common'],
+  },
+  {
+    id: '3',
+    username: 'dev',
+    nickName: '开发者',
+    userType: '普通角色',
+    email: 'dev@qq.com',
+    phonenumber: '15777777777',
+    sex: '0',
+    status: 0,
+    delFlag: 0,
+    createTime: '2026-01-17 14:30:00',
+    dept: '研发部门',
+    roles: ['common'],
+  },
+];
+const roles = [
+  {
+    id: '1',
+    roleName: '超级管理员',
+    roleKey: 'admin',
+    roleSort: 1,
+    status: 0,
+    delFlag: 0,
+    createTime: '2026-01-18 10:58:15',
+    remark: '超级管理员',
+    permissions: ['*:*:*'],
+  },
+  {
+    id: '2',
+    roleName: '普通角色',
+    roleKey: 'common',
+    roleSort: 2,
+    status: 0,
+    delFlag: 0,
+    createTime: '2026-01-18 10:58:15',
+    remark: '普通角色',
+    permissions: ['system:user:query', 'system:role:query'],
+  },
+  {
+    id: '3',
+    roleName: '测试角色',
+    roleKey: 'test',
+    roleSort: 3,
+    status: 0,
+    delFlag: 0,
+    createTime: '2026-01-17 09:30:00',
+    remark: '测试人员角色',
+    permissions: ['system:user:query', 'system:menu:query'],
+  },
+];
+const menus = [
+  {
+    id: '1',
+    menuName: '系统管理',
+    parentId: '0',
+    orderNum: 1,
+    path: 'system',
+    menuType: 'M',
+    visible: 0,
+    status: 0,
+    icon: 'system',
+    createTime: '2026-01-18 10:58:15',
+    isFrame: 1,
+    isCache: 0,
+    children: [
+      {
+        id: '100',
+        menuName: '用户管理',
+        parentId: '1',
+        orderNum: 1,
+        path: 'user',
+        component: 'system/user/index',
+        menuType: 'C',
+        visible: 0,
+        status: 0,
+        perms: 'system:user:list',
+        icon: 'user',
+        createTime: '2026-01-18 10:58:15',
+        isFrame: 0,
+        isCache: 0,
+      },
+      {
+        id: '101',
+        menuName: '角色管理',
+        parentId: '1',
+        orderNum: 2,
+        path: 'role',
+        component: 'system/role/index',
+        menuType: 'C',
+        visible: 0,
+        status: 0,
+        perms: 'system:role:list',
+        icon: 'peoples',
+        createTime: '2026-01-18 10:58:15',
+        isFrame: 0,
+        isCache: 0,
+      },
+      {
+        id: '102',
+        menuName: '菜单管理',
+        parentId: '1',
+        orderNum: 3,
+        path: 'menu',
+        component: 'system/menu/index',
+        menuType: 'C',
+        visible: 0,
+        status: 0,
+        perms: 'system:menu:list',
+        icon: 'tree-table',
+        createTime: '2026-01-18 10:58:15',
+        isFrame: 0,
+        isCache: 0,
+      },
+    ],
+  },
+  {
+    id: '2',
+    menuName: '业务管理',
+    parentId: '0',
+    orderNum: 2,
+    path: 'business',
+    menuType: 'M',
+    visible: 0,
+    status: 0,
+    icon: 'shopping',
+    createTime: '2026-01-17 15:20:00',
+    isFrame: 1,
+    isCache: 0,
+    children: [
+      {
+        id: '200',
+        menuName: '订单管理',
+        parentId: '2',
+        orderNum: 1,
+        path: 'order',
+        component: 'business/order/index',
+        menuType: 'C',
+        visible: 0,
+        status: 0,
+        perms: 'business:order:list',
+        icon: 'shopping-cart',
+        createTime: '2026-01-17 15:20:00',
+        isFrame: 0,
+        isCache: 0,
+      },
+    ],
+  },
+];
+// 响应格式化
+const formatResponse = (code, message, data = null) => ({
+  code,
+  message,
+  data,
+});
+// ==================== 用户管理 ====================
+// 获取用户列表
+router.get('/system/user/list', (ctx) => {
+  const { pageNum = 1, pageSize = 10, username, phonenumber, status } = ctx.query;
+  let filteredUsers = [...users];
+  if (username) {
+    filteredUsers = filteredUsers.filter(u =>
+      u.username.toLowerCase().includes(username.toLowerCase())
+    );
+  }
+  if (phonenumber) {
+    filteredUsers = filteredUsers.filter(u =>
+      u.phonenumber.includes(phonenumber)
+    );
+  }
+  if (status !== undefined && status !== '') {
+    const statusNum = parseInt(status);
+    filteredUsers = filteredUsers.filter(u => u.status === statusNum);
+  }
+  const start = (pageNum - 1) * pageSize;
+  const end = start + parseInt(pageSize);
+  ctx.body = formatResponse(200, '获取成功', {
+    rows: filteredUsers.slice(start, end),
+    total: filteredUsers.length,
+  });
+});
+// 获取用户详情
+router.get('/system/user/:id', (ctx) => {
+  const { id } = ctx.params;
+  const user = users.find((u) => u.id === id);
+  if (!user) {
+    ctx.status = 404;
+    ctx.body = formatResponse(404, '用户不存在');
+    return;
+  }
+  ctx.body = formatResponse(200, '获取成功', user);
+});
+// 新增用户
+router.post('/system/user', (ctx) => {
+  const { username, nickName, email, phonenumber, sex, dept, status, remark } = ctx.request.body;
+  const newUser = {
+    id: String(users.length + 1),
+    username,
+    nickName,
+    userType: '普通角色',
+    email,
+    phonenumber,
+    sex,
+    status: status ? 0 : 1,
+    delFlag: 0,
+    createTime: new Date().toLocaleString(),
+    dept,
+    remark,
+    roles: ['common'],
+  };
+  users.push(newUser);
+  ctx.body = formatResponse(200, '添加成功', newUser);
+});
+// 编辑用户
+router.put('/system/user', (ctx) => {
+  const { id, username, nickName, email, phonenumber, sex, dept, status, remark } = ctx.request.body;
+  const userIndex = users.findIndex((u) => u.id === id);
+  if (userIndex === -1) {
+    ctx.status = 404;
+    ctx.body = formatResponse(404, '用户不存在');
+    return;
+  }
+  users[userIndex] = {
+    ...users[userIndex],
+    username,
+    nickName,
+    email,
+    phonenumber,
+    sex,
+    dept,
+    status: status ? 0 : 1,
+    remark,
+  };
+  ctx.body = formatResponse(200, '编辑成功', users[userIndex]);
+});
+// 删除用户
+router.delete('/system/user/:id', (ctx) => {
+  const { id } = ctx.params;
+  const userIndex = users.findIndex((u) => u.id === id);
+  if (userIndex === -1) {
+    ctx.status = 404;
+    ctx.body = formatResponse(404, '用户不存在');
+    return;
+  }
+  users.splice(userIndex, 1);
+  ctx.body = formatResponse(200, '删除成功');
+});
+// ==================== 角色管理 ====================
+// 获取角色列表
+router.get('/system/role/list', (ctx) => {
+  const { pageNum = 1, pageSize = 10 } = ctx.query;
+  const start = (pageNum - 1) * pageSize;
+  const end = start + pageSize;
+  ctx.body = formatResponse(200, '获取成功', {
+    rows: roles.slice(start, end),
+    total: roles.length,
+  });
+});
+// 获取角色详情
+router.get('/system/role/:id', (ctx) => {
+  const { id } = ctx.params;
+  const role = roles.find((r) => r.id === id);
+  if (!role) {
+    ctx.status = 404;
+    ctx.body = formatResponse(404, '角色不存在');
+    return;
+  }
+  ctx.body = formatResponse(200, '获取成功', role);
+});
+// 新增角色
+router.post('/system/role', (ctx) => {
+  const { roleName, roleKey, roleSort, status, remark, permissions } = ctx.request.body;
+  const newRole = {
+    id: String(roles.length + 1),
+    roleName,
+    roleKey,
+    roleSort,
+    status: status ? 0 : 1,
+    delFlag: 0,
+    createTime: new Date().toLocaleString(),
+    remark,
+    permissions,
+  };
+  roles.push(newRole);
+  ctx.body = formatResponse(200, '添加成功', newRole);
+});
+// 编辑角色
+router.put('/system/role', (ctx) => {
+  const { id, roleName, roleKey, roleSort, status, remark, permissions } = ctx.request.body;
+  const roleIndex = roles.findIndex((r) => r.id === id);
+  if (roleIndex === -1) {
+    ctx.status = 404;
+    ctx.body = formatResponse(404, '角色不存在');
+    return;
+  }
+  roles[roleIndex] = {
+    ...roles[roleIndex],
+    roleName,
+    roleKey,
+    roleSort,
+    status: status ? 0 : 1,
+    remark,
+    permissions,
+  };
+  ctx.body = formatResponse(200, '编辑成功', roles[roleIndex]);
+});
+// 删除角色
+router.delete('/system/role/:id', (ctx) => {
+  const { id } = ctx.params;
+  const roleIndex = roles.findIndex((r) => r.id === id);
+  if (roleIndex === -1) {
+    ctx.status = 404;
+    ctx.body = formatResponse(404, '角色不存在');
+    return;
+  }
+  roles.splice(roleIndex, 1);
+  ctx.body = formatResponse(200, '删除成功');
+});
+// ==================== 菜单管理 ====================
+// 获取菜单列表
+router.get('/system/menu/list', (ctx) => {
+  ctx.body = formatResponse(200, '获取成功', menus);
+});
+// 获取菜单详情
+router.get('/system/menu/:id', (ctx) => {
+  const { id } = ctx.params;
+  const findMenu = (items) => {
+    for (const item of items) {
+      if (item.id === id) return item;
+      if (item.children) {
+        const found = findMenu(item.children);
+        if (found) return found;
+      }
+    }
+    return null;
+  };
+  const menu = findMenu(menus);
+  if (!menu) {
+    ctx.status = 404;
+    ctx.body = formatResponse(404, '菜单不存在');
+    return;
+  }
+  ctx.body = formatResponse(200, '获取成功', menu);
+});
+// 新增菜单
+router.post('/system/menu', (ctx) => {
+  const { menuName, parentId, orderNum, path, component, menuType, status, perms, icon, remark } = ctx.request.body;
+  const newMenu = {
+    id: String(Date.now()),
+    menuName,
+    parentId,
+    orderNum,
+    path,
+    component,
+    menuType,
+    visible: 0,
+    status: status ? 0 : 1,
+    perms,
+    icon,
+    createTime: new Date().toLocaleString(),
+    isFrame: 0,
+    isCache: 0,
+    remark,
+  };
+  if (parentId === '0') {
+    menus.push(newMenu);
+  } else {
+    const addToParent = (items) => {
+      for (const item of items) {
+        if (item.id === parentId) {
+          if (!item.children) item.children = [];
+          item.children.push(newMenu);
+          return true;
+        }
+        if (item.children && addToParent(item.children)) return true;
+      }
+      return false;
+    };
+    addToParent(menus);
+  }
+  ctx.body = formatResponse(200, '添加成功', newMenu);
+});
+// 编辑菜单
+router.put('/system/menu', (ctx) => {
+  const { id, menuName, parentId, orderNum, path, component, menuType, status, perms, icon, remark } = ctx.request.body;
+  const updateMenu = (items) => {
+    for (const item of items) {
+      if (item.id === id) {
+        Object.assign(item, {
+          menuName,
+          parentId,
+          orderNum,
+          path,
+          component,
+          menuType,
+          status: status ? 0 : 1,
+          perms,
+          icon,
+          remark,
+        });
+        return true;
+      }
+      if (item.children && updateMenu(item.children)) return true;
+    }
+    return false;
+  };
+  if (updateMenu(menus)) {
+    ctx.body = formatResponse(200, '编辑成功');
+  } else {
+    ctx.status = 404;
+    ctx.body = formatResponse(404, '菜单不存在');
+  }
+});
+// 删除菜单
+router.delete('/system/menu/:id', (ctx) => {
+  const { id } = ctx.params;
+  const deleteMenu = (items) => {
+    for (let i = 0; i < items.length; i++) {
+      if (items[i].id === id) {
+        items.splice(i, 1);
+        return true;
+      }
+      if (items[i].children && deleteMenu(items[i].children)) return true;
+    }
+    return false;
+  };
+  if (deleteMenu(menus)) {
+    ctx.body = formatResponse(200, '删除成功');
+  } else {
+    ctx.status = 404;
+    ctx.body = formatResponse(404, '菜单不存在');
+  }
+});
+// 文件上传 - 支持任意字段名
+router.post('/upload.do', upload.any(), (ctx) => {
+  const file = ctx.files?.[0];
+  if (!file) {
+    ctx.status = 400;
+    ctx.body = formatResponse(400, '请选择文件');
+    return;
+  }
+  const fileUrl = `http://localhost:8085/${file.filename}`;
+  ctx.body = formatResponse(200, '上传成功', {
+    url: fileUrl,
+    filename: file.filename,
+    originalname: file.originalname
+  });
+});
+// 课程文件上传接口（兼容真实后端路径）
+router.post('/api/courses/upload', upload.any(), (ctx) => {
+  const file = ctx.files?.[0];
+  if (!file) {
+    ctx.status = 400;
+    ctx.body = formatResponse(400, '请选择文件');
+    return;
+  }
+  const fileUrl = `http://localhost:8085/${file.filename}`;
+  // 真实后端直接返回 URL 字符串作为 data
+  ctx.body = formatResponse(200, '上传成功', fileUrl);
+});
+// 健康检查
+router.get('/health', (ctx) => {
+  ctx.body = { status: 'ok' };
+});
+// SPA 兜底路由：所有非 API 请求都返回 index.html，支持前端路由刷新
+router.get('/(.*)', (ctx, next) => {
+  const reqPath = ctx.path;
+  // API 和上传接口不走兜底
+  if (
+    reqPath.startsWith('/system') ||
+    reqPath.startsWith('/api') ||
+    reqPath.startsWith('/upload') ||
+    reqPath.startsWith('/health')
+  ) {
+    return next();
+  }
+  const indexPath = path.join(__dirname, 'public/index.html');
+  if (fs.existsSync(indexPath)) {
+    ctx.type = 'html';
+    ctx.body = fs.createReadStream(indexPath);
+  } else {
+    ctx.status = 404;
+    ctx.body = 'index.html not found, please build the frontend first.';
+  }
+});
+// 注册路由
+app.use(router.routes()).use(router.allowedMethods());
+// 启动服务器
+const port = 8085;
+app.listen(port, () => {
+  console.log(`Koa 服务器已启动: http://localhost:${port}`);
+});