medical-mall/docs/admin/ADMIN_PAGE_COMPLIANCE_CHECKLIST.md

后台页面 AdminLayout 包装检查清单

本清单列出所有 menu.uts 中定义的路由对应的 uvue 文件，并标注其完整路径和包装状态。

检查状态说明：

• ✅ 完全符合：已使用 AdminLayout 包装且有正确的 currentPage prop
• ⚠️ 部分符合：已使用 AdminLayout 但 currentPage prop 不正确或位置不对
• ❌ 需要修改：未使用 AdminLayout 或未添加 currentPage prop
• 🔄 需要优化：currentPage 值为动态值而非静态值（需要验证）

---

路由清单

1. 首页

序号	路由	currentPage	文件路径	状态	说明
1	/pages/mall/admin/homePage/index	home	pages/mall/admin/homePage/index.uvue	✅	已正确包装

---

2. 用户管理

序号	路由	currentPage	文件路径	状态	说明
2	/pages/mall/admin/user-statistics	user	pages/mall/admin/user-statistics.uvue	⚠️	currentPage 在内层 view，应该在 AdminLayout 上
3	/pages/mall/admin/user-management	user-list (动态)	pages/mall/admin/user-management.uvue	🔄	使用动态 currentPage，根据 action 参数变化
3.1	/pages/mall/admin/user-management?action=group	user-group	pages/mall/admin/user-management.uvue	🔄	同上，动态值
3.2	/pages/mall/admin/user-management?action=tag	user-tag	pages/mall/admin/user-management.uvue	🔄	同上，动态值
3.3	/pages/mall/admin/user-management?action=level	user-level	pages/mall/admin/user-management.uvue	🔄	同上，动态值
3.4	/pages/mall/admin/user-management?action=config	user-config	pages/mall/admin/user-management.uvue	🔄	同上，动态值

---

3. 订单管理

序号	路由	currentPage	文件路径	状态	说明
4	/pages/mall/admin/order-management	order-list (tab=list)	pages/mall/admin/order-management.uvue	❌	未使用 AdminLayout，未添加 currentPage
4.1	/pages/mall/admin/order-management?tab=stats	order-stats	pages/mall/admin/order-management.uvue	❌	需要处理 tab 参数
4.2	/pages/mall/admin/order-management?tab=list	order-list	pages/mall/admin/order-management.uvue	❌	需要处理 tab 参数
4.3	/pages/mall/admin/order-management?tab=aftersale	order-aftersale	pages/mall/admin/order-management.uvue	❌	需要处理 tab 参数
4.4	/pages/mall/admin/order-management?tab=cashier	order-cashier	pages/mall/admin/order-management.uvue	❌	需要处理 tab 参数
4.5	/pages/mall/admin/order-management?tab=verify	order-verify	pages/mall/admin/order-management.uvue	❌	需要处理 tab 参数
4.6	/pages/mall/admin/order-management?tab=config	order-config	pages/mall/admin/order-management.uvue	❌	需要处理 tab 参数

---

4. 商品管理

序号	路由	currentPage	文件路径	状态	说明
5	/pages/mall/admin/product-management	product-list	pages/mall/admin/product-management.uvue	❌	未使用 AdminLayout，未添加 currentPage
6	/pages/mall/admin/product-statistics	product-statistics	pages/mall/admin/product-statistics.uvue	✅	已正确包装
7	/pages/mall/admin/product-classification	product-classification	pages/mall/admin/product-classification.uvue	❌	已导入 AdminLayout 但未在模板中使用
8	/pages/mall/admin/product-specifications	product-specifications	pages/mall/admin/product-specifications.uvue	❌	已导入 AdminLayout 但未在模板中使用
9	/pages/mall/admin/product-parameters	product-parameters	pages/mall/admin/product-parameters.uvue	❌	已导入 AdminLayout 但未在模板中使用
10	/pages/mall/admin/product-labels	product-labels	pages/mall/admin/product-labels.uvue	❌	已导入 AdminLayout 但未在模板中使用
11	/pages/mall/admin/product-protection	product-protection	pages/mall/admin/product-protection.uvue	❌	已导入 AdminLayout 但未在模板中使用
12	/pages/mall/admin/product-reviews	product-reviews	pages/mall/admin/product-reviews.uvue	❌	已导入 AdminLayout 但未在模板中使用

---

5. 设计

序号	路由	currentPage	文件路径	状态	说明
13	/pages/mall/admin/design/index	design-home	pages/mall/admin/design/index.uvue	⚠️	属性名为 current-page（kebab-case），应为 currentPage（camelCase）

---

6. 文章管理

序号	路由	currentPage	文件路径	状态	说明
14	/pages/mall/admin/content/index	content-list	pages/mall/admin/content/index.uvue	❌	已使用 AdminLayout 但未添加 currentPage

---

7. 客服管理

序号	路由	currentPage	文件路径	状态	说明
15	/pages/mall/admin/service/index	service-index	pages/mall/admin/service/index.uvue	✅	已完成
16	/pages/mall/admin/service/script	service-script	pages/mall/admin/service/script.uvue	✅	已完成
17	/pages/mall/admin/service/message	service-message	pages/mall/admin/service/message.uvue	✅	已完成
18	/pages/mall/admin/service/autoReply	service-autoReply	pages/mall/admin/service/autoReply.uvue	✅	已完成
19	/pages/mall/admin/service/config	service-config	pages/mall/admin/service/config.uvue	✅	已完成

---

8. 营销管理

8.1 优惠券

序号	路由	currentPage	文件路径	状态	说明
20	/pages/mall/admin/marketing/coupon/list	coupon-list	pages/mall/admin/marketing/coupon/list.uvue	❌	未使用 AdminLayout，未添加 currentPage
21	/pages/mall/admin/marketing/coupon/receive	coupon-receive	pages/mall/admin/marketing/coupon/receive.uvue	❌	未使用 AdminLayout，未添加 currentPage

8.2 积分、抽奖等（统一页面）

序号	路由	currentPage	文件路径	状态	说明
22-32	/pages/mall/admin/marketing/points/index	多个（根据 tab）	pages/mall/admin/marketing/points/index.uvue	❌	未使用 AdminLayout，未添加 currentPage

8.3 签到

序号	路由	currentPage	文件路径	状态	说明
33	/pages/mall/admin/marketing/signin/rule	signin-rule	pages/mall/admin/marketing/signin/rule.uvue	❌	未使用 AdminLayout，未添加 currentPage
34	/pages/mall/admin/marketing/signin/record	signin-record	pages/mall/admin/marketing/signin/record.uvue	❌	未使用 AdminLayout，未添加 currentPage

---

9. 系统设置

9.1 基础设置

序号	路由	currentPage	文件路径	状态	说明
35	/pages/mall/admin/system-settings	sys-basic	pages/mall/admin/system-settings.uvue	⚠️	已使用 AdminLayout 但未添加 currentPage

9.2 消息管理

序号	路由	currentPage	文件路径	状态	说明
36	/pages/mall/admin/system/message-management	sys-message	pages/mall/admin/system/message-management.uvue	❌	已导入 AdminLayout 但未在模板中使用

9.3 协议设置

序号	路由	currentPage	文件路径	状态	说明
37	/pages/mall/admin/system/agreement-settings	sys-agreement	pages/mall/admin/system/agreement-settings.uvue	❌	已导入 AdminLayout 但未在模板中使用

9.4 小票配置

序号	路由	currentPage	文件路径	状态	说明
38	/pages/mall/admin/system/receipt-settings	sys-receipt	pages/mall/admin/system/receipt-settings.uvue	❌	已导入 AdminLayout 但未在模板中使用

9.5 权限管理

序号	路由	currentPage	文件路径	状态	说明
39	/pages/mall/admin/system/permission/role	sys-role	pages/mall/admin/system/permission/role.uvue	❌	已导入 AdminLayout 但未在模板中使用
40	/pages/mall/admin/system/permission/admin-list	sys-admin	pages/mall/admin/system/permission/admin-list.uvue	❌	已导入 AdminLayout 但未在模板中使用
41	/pages/mall/admin/system/permission/permission-setting	sys-perm-setting	pages/mall/admin/system/permission/permission-setting.uvue	❌	已导入 AdminLayout 但未在模板中使用

9.6 发货设置

序号	路由	currentPage	文件路径	状态	说明
42	/pages/mall/admin/system/shipping/courier	ship-courier	pages/mall/admin/system/shipping/courier.uvue	❌	未使用 AdminLayout，未添加 currentPage
43	/pages/mall/admin/system/shipping/pickup/points	pickup-points	pages/mall/admin/system/shipping/pickup/points.uvue	❌	未使用 AdminLayout，未添加 currentPage
44	/pages/mall/admin/system/shipping/pickup/verifiers	pickup-verifier	pages/mall/admin/system/shipping/pickup/verifiers.uvue	❌	未使用 AdminLayout，未添加 currentPage
45	/pages/mall/admin/system/shipping/freight-template	ship-freight	pages/mall/admin/system/shipping/freight-template.uvue	❌	未使用 AdminLayout，未添加 currentPage

9.7 接口配置

序号	路由	currentPage	文件路径	状态	说明
46	/pages/mall/admin/system/api/yht/page	api-yht-page	pages/mall/admin/system/api/yht/page.uvue	❌	已导入 AdminLayout 但未在模板中使用
47	/pages/mall/admin/system/api/yht/config	api-yht-config	pages/mall/admin/system/api/yht/config.uvue	❌	已导入 AdminLayout 但未在模板中使用
48	/pages/mall/admin/system/api/storage	api-storage	pages/mall/admin/system/api/storage.uvue	❌	已导入 AdminLayout 但未在模板中使用
49	/pages/mall/admin/system/api/collect	api-collect	pages/mall/admin/system/api/collect.uvue	❌	已导入 AdminLayout 但未在模板中使用
50	/pages/mall/admin/system/api/logistics	api-logistics	pages/mall/admin/system/api/logistics.uvue	❌	已导入 AdminLayout 但未在模板中使用
51	/pages/mall/admin/system/api/waybill	api-waybill	pages/mall/admin/system/api/waybill.uvue	❌	已导入 AdminLayout 但未在模板中使用
52	/pages/mall/admin/system/api/sms	api-sms	pages/mall/admin/system/api/sms.uvue	❌	已导入 AdminLayout 但未在模板中使用
53	/pages/mall/admin/system/api/pay	api-pay	pages/mall/admin/system/api/pay.uvue	❌	已导入 AdminLayout 但未在模板中使用

---

10. 维护管理

10.1 开发配置

序号	路由	currentPage	文件路径	状态	说明
54	/pages/mall/admin/maintain/dev-config/category	dev-config-category	pages/mall/admin/maintain/dev-config/category.uvue	⚠️	已使用 AdminLayout 但未添加 currentPage
55	/pages/mall/admin/maintain/dev-config/combination-data	dev-config-combo	pages/mall/admin/maintain/dev-config/combination-data.uvue	❌	已导入 AdminLayout 但未在模板中使用
56	/pages/mall/admin/maintain/dev-config/cron-job	dev-config-cron	pages/mall/admin/maintain/dev-config/cron-job.uvue	❌	已导入 AdminLayout 但未在模板中使用
57	/pages/mall/admin/maintain/dev-config/permission	dev-config-permission	pages/mall/admin/maintain/dev-config/permission.uvue	❌	已导入 AdminLayout 但未在模板中使用
58	/pages/mall/admin/maintain/dev-config/module-config	dev-config-module	pages/mall/admin/maintain/dev-config/module-config.uvue	❌	已导入 AdminLayout 但未在模板中使用
59	/pages/mall/admin/maintain/dev-config/custom-event	dev-config-event	pages/mall/admin/maintain/dev-config/custom-event.uvue	❌	已导入 AdminLayout 但未在模板中使用

10.2 安全维护

序号	路由	currentPage	文件路径	状态	说明
60	/pages/mall/admin/maintain/security/refresh-cache	security-refresh-cache	pages/mall/admin/maintain/security/refresh-cache.uvue	❌	已导入 AdminLayout 但未在模板中使用
61	/pages/mall/admin/maintain/security/system-log	security-system-log	pages/mall/admin/maintain/security/system-log.uvue	❌	已导入 AdminLayout 但未在模板中使用
62	/pages/mall/admin/maintain/security/online-upgrade	security-online-upgrade	pages/mall/admin/maintain/security/online-upgrade.uvue	❌	已导入 AdminLayout 但未在模板中使用

10.3 数据维护

序号	路由	currentPage	文件路径	状态	说明
63	/pages/mall/admin/maintain/data/logistics-company	data-logistics-company	pages/mall/admin/maintain/data/logistics-company.uvue	❌	已导入 AdminLayout 但未在模板中使用
64	/pages/mall/admin/maintain/data/city-data	data-city-data	pages/mall/admin/maintain/data/city-data.uvue	❌	已导入 AdminLayout 但未在模板中使用
65	/pages/mall/admin/maintain/data/clear-data	data-clear-data	pages/mall/admin/maintain/data/clear-data.uvue	❌	已导入 AdminLayout 但未在模板中使用

10.4 对外接口

序号	路由	currentPage	文件路径	状态	说明
66	/pages/mall/admin/maintain/external/account	external-account	pages/mall/admin/maintain/external/account.uvue	❌	未使用 AdminLayout，未添加 currentPage

10.5 语言设置

序号	路由	currentPage	文件路径	状态	说明
67	/pages/mall/admin/maintain/i18n/language-list	i18n-language-list	pages/mall/admin/maintain/i18n/language-list.uvue	❌	已导入 AdminLayout 但未在模板中使用
68	/pages/mall/admin/maintain/i18n/language-detail	i18n-language-detail	pages/mall/admin/maintain/i18n/language-detail.uvue	❌	已导入 AdminLayout 但未在模板中使用
69	/pages/mall/admin/maintain/i18n/region-list	i18n-region-list	pages/mall/admin/maintain/i18n/region-list.uvue	❌	已导入 AdminLayout 但未在模板中使用
70	/pages/mall/admin/maintain/i18n/translate-config	i18n-translate-config	pages/mall/admin/maintain/i18n/translate-config.uvue	❌	已导入 AdminLayout 但未在模板中使用

10.6 开发工具

序号	路由	currentPage	文件路径	状态	说明
71	/pages/mall/admin/maintain/dev-tools/database	dev-tools-db	pages/mall/admin/maintain/dev-tools/database.uvue	❌	已导入 AdminLayout 但未在模板中使用
72	/pages/mall/admin/maintain/dev-tools/file	dev-tools-file	pages/mall/admin/maintain/dev-tools/file.uvue	❌	已导入 AdminLayout 但未在模板中使用
73	/pages/mall/admin/maintain/dev-tools/api	dev-tools-api	pages/mall/admin/maintain/dev-tools/api.uvue	❌	已导入 AdminLayout 但未在模板中使用
74	/pages/mall/admin/maintain/dev-tools/codegen	dev-tools-codegen	pages/mall/admin/maintain/dev-tools/codegen.uvue	❌	已导入 AdminLayout 但未在模板中使用
75	/pages/mall/admin/maintain/dev-tools/data-dict	dev-tools-dict	pages/mall/admin/maintain/dev-tools/data-dict.uvue	❌	已导入 AdminLayout 但未在模板中使用

10.7 系统信息

序号	路由	currentPage	文件路径	状态	说明
76	/pages/mall/admin/maintain/system-info	system-info	pages/mall/admin/maintain/system-info.uvue	⚠️	已使用 AdminLayout 但未添加 currentPage

---

统计汇总

状态	数量	百分比
✅ 完全符合	2	2.6%
⚠️ 部分符合	6	7.9%
🔄 需要优化	5	6.6%
❌ 需要修改	63	82.9%
总计	76	100%

---

需要修改的文件分类

类别 A：已导入但未在模板中使用（需要包装）- 27 个文件

pages/mall/admin/product-classification.uvue
pages/mall/admin/product-specifications.uvue
pages/mall/admin/product-parameters.uvue
pages/mall/admin/product-labels.uvue
pages/mall/admin/product-protection.uvue
pages/mall/admin/product-reviews.uvue
pages/mall/admin/system/message-management.uvue
pages/mall/admin/system/agreement-settings.uvue
pages/mall/admin/system/receipt-settings.uvue
pages/mall/admin/system/permission/role.uvue
pages/mall/admin/system/permission/admin-list.uvue
pages/mall/admin/system/permission/permission-setting.uvue
pages/mall/admin/system/api/yht/page.uvue
pages/mall/admin/system/api/yht/config.uvue
pages/mall/admin/system/api/storage.uvue
pages/mall/admin/system/api/collect.uvue
pages/mall/admin/system/api/logistics.uvue
pages/mall/admin/system/api/waybill.uvue
pages/mall/admin/system/api/sms.uvue
pages/mall/admin/system/api/pay.uvue
pages/mall/admin/maintain/dev-config/combination-data.uvue
pages/mall/admin/maintain/dev-config/cron-job.uvue
pages/mall/admin/maintain/dev-config/permission.uvue
pages/mall/admin/maintain/dev-config/module-config.uvue
pages/mall/admin/maintain/dev-config/custom-event.uvue
pages/mall/admin/maintain/security/refresh-cache.uvue
pages/mall/admin/maintain/security/system-log.uvue

类别 B：未使用 AdminLayout（需要完全重新包装）- 36 个文件

pages/mall/admin/product-management.uvue
pages/mall/admin/order-management.uvue
pages/mall/admin/marketing/coupon/list.uvue
pages/mall/admin/marketing/coupon/receive.uvue
pages/mall/admin/marketing/points/index.uvue
pages/mall/admin/marketing/signin/rule.uvue
pages/mall/admin/marketing/signin/record.uvue
pages/mall/admin/system/shipping/courier.uvue
pages/mall/admin/system/shipping/pickup/points.uvue
pages/mall/admin/system/shipping/pickup/verifiers.uvue
pages/mall/admin/system/shipping/freight-template.uvue
pages/mall/admin/customer-service/script.uvue
pages/mall/admin/customer-service/messages.uvue
pages/mall/admin/customer-service/auto-reply.uvue
pages/mall/admin/customer-service/config.uvue
pages/mall/admin/maintain/data/logistics-company.uvue
pages/mall/admin/maintain/data/city-data.uvue
pages/mall/admin/maintain/data/clear-data.uvue
pages/mall/admin/maintain/external/account.uvue
pages/mall/admin/maintain/i18n/language-list.uvue
pages/mall/admin/maintain/i18n/language-detail.uvue
pages/mall/admin/maintain/i18n/region-list.uvue
pages/mall/admin/maintain/i18n/translate-config.uvue
pages/mall/admin/maintain/dev-tools/database.uvue
pages/mall/admin/maintain/dev-tools/file.uvue
pages/mall/admin/maintain/dev-tools/api.uvue
pages/mall/admin/maintain/dev-tools/codegen.uvue
pages/mall/admin/maintain/dev-tools/data-dict.uvue

类别 C：需要修复 currentPage 或属性名 - 10 个文件

pages/mall/admin/user-statistics.uvue         (currentPage 在内层 view)
pages/mall/admin/design/index.uvue            (属性名应为 currentPage 而非 current-page, 值应为 design-home)
pages/mall/admin/content/index.uvue           (缺少 currentPage)
pages/mall/admin/customer-service/list.uvue   (属性名应为 currentPage，值应为 cs-list)
pages/mall/admin/system-settings.uvue         (缺少 currentPage)
pages/mall/admin/maintain/dev-config/category.uvue  (缺少 currentPage)
pages/mall/admin/maintain/system-info.uvue    (缺少 currentPage)

类别 D：动态 currentPage（已可接受但需验证）- 5 个文件

pages/mall/admin/user-management.uvue         (使用 :currentPage="currentPage"，根据 action 参数动态变化)

---

推荐修改优先级

优先级 1（必须修改，影响导航）

1. 所有完全缺少 AdminLayout 的文件（类别 B）
2. currentPage 值错误的文件（如 customer-service/list.uvue）

优先级 2（应该修改，影响主题和导航状态）

1. 已导入但未使用 AdminLayout 的文件（类别 A）
2. currentPage 属性名错误的文件（使用 current-page 而非 currentPage）

优先级 3（可选，增强用户体验）

1. 验证所有动态 currentPage 的实现正确性

---

修改建议

每个页面应该遵循以下模板：

<template>
  <AdminLayout :currentPage="currentPageValue">
    <!-- 页面内容 -->
  </AdminLayout>
</template>

<script setup lang="uts">
import { ref } from 'vue'
import { onLoad } from '@dcloudio/uni-app'
import AdminLayout from '@/layouts/admin/AdminLayout.uvue'

const currentPageValue = ref('page-id')

onLoad((options) => {
  // 如果需要根据参数动态设置 currentPage
  // currentPageValue.value = dynamicValue
})
</script>

---

文档生成时间：2026年1月30日