更新记录

1.0.0（2026-09-09）

更新日志

[1.0.0] - 2026-09-09

新增功能

业务管理模块（12 个）

• 轮播管理（banner）- 完整的增删改查功能
• 分类管理（categories）- 完整的增删改查功能
• 服务管理（services）- 完整的增删改查功能
• 工人管理（workers）- 完整的增删改查功能
• 门店管理（stores）- 完整的增删改查功能
• 优惠券管理（coupons）- 完整的增删改查功能
• 用户优惠券管理（user-coupons）- 完整的增删改查功能
• 订单管理（orders）- 增改查功能（状态管理）
• 评价管理（reviews）- 只读列表查看
• 收藏管理（favorites）- 只读列表查看
• 地址管理（addresses）- 只读列表查看
• 系统配置管理（kv）- 只读列表查看

云函数服务（32 个）

• 为每个业务模块创建了对应的管理端 API
• 支持分页查询、添加、更新、删除操作
• 统一使用 admin/{module}/sys/{action} 路由格式

数据库初始化

• 创建 db_init.json 包含 32 个数据集合定义
• 从用户端复制 12 个业务数据表的 schema 和初始数据
• 添加家政业务菜单到 opendb-admin-menus.init_data.json

菜单系统

• 新增"家政业务"一级菜单组
• 包含 12 个业务子菜单项
• 菜单 ID 使用 jz- 前缀统一命名

修复问题

登录菜单加载错误

• 修复 user/kh/getMenu 接口在角色记录不存在时抛出 "Cannot read properties of null (reading 'menu')" 错误
• 增加容错处理：当角色表未初始化时，管理员仍可加载所有启用菜单
• 添加 fallback 机制直接查询 opendb-admin-menus 表

优化改进

Logo 资源

• 生成符合各位置尺寸要求的 logo 图片
  • logo.png (478x478) - 方形应用图标
  • logo1.png (224x160) - 宽屏格式
  • logo2.png (480x100) - 横幅格式
  • logo3.png (480x100) - 横幅格式
• 使用蓝色渐变背景，白色文字，带阴影效果
• 更新 app.config.js 中的 logoTitle 为 "星云家政管理端"

URL 路径优化

• 移除业务模块 URL 中的 xy/ 前缀
• 统一使用 admin/{module}/sys/{action} 简洁格式
• 与系统管理模块（admin/system）保持一致的命名风格

技术细节

页面结构（19 个 Vue 文件）

• 12 个列表页面（list.vue）
• 7 个表单弹窗页面（form/addUpdate.vue）
• 使用 vk-data-table 组件实现智能表格
• 支持查询、分页、排序、批量操作

服务架构

• 基于 vk-unicloud router 云函数架构
• 使用 vk.baseDao.getTableData 实现分页查询
• 使用 vk.baseDao.add/updateById/del 实现 CRUD 操作
• 统一返回格式 {code, msg, data}

权限控制

• 基于角色的菜单权限系统
• 管理员角色默认拥有所有菜单权限
• 支持自定义角色的菜单分配

部署说明

1. 初始化云数据库

   右键 uniCloud-aliyun/database → 初始化云数据库

2. 上传云函数

   右键 uniCloud-aliyun/cloudfunctions/router → 上传并运行

3. 运行到浏览器

   HBuilderX → 运行 → 运行到浏览器

文件统计

• Vue 页面：19 个
• 云函数服务：32 个
• 数据库文件：24 个（12 表 × 2）
• 菜单项：13 个（1 父级 + 12 子级）
• Logo 图片：4 个（不同尺寸）

平台兼容性

云端兼容性

uni-app(4.36)

其他

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+