Files
medical-mall/docs/admin/ADMIN_PAGE_QUICK_REFERENCE.md
2026-02-02 20:07:37 +08:00

11 KiB
Raw Blame History

后台页面检查 - 快速参考表

📊 整体统计

  • 总路由数76 条(包括所有 tab 参数变体)
  • 总文件数50+ 个 uvue 文件
  • 完全符合2 个2.6%
  • 部分符合6 个7.9%
  • 动态实现5 个6.6%
  • 需要修改63 个82.9%

已完全符合的文件2个

✅ pages/mall/admin/homePage/index.uvue
   └─ <AdminLayout currentPage="home">

✅ pages/mall/admin/product-statistics.uvue
   └─ <AdminLayout currentPage="product-statistics">

⚠️ 部分符合的文件(需要小修改)

属性名错误(使用 current-page 而非 currentPage

❌ pages/mall/admin/design/index.uvue
   现在:<AdminLayout current-page='design'>
   应该:<AdminLayout :currentPage="'design-home'">

❌ pages/mall/admin/customer-service/list.uvue
   现在:<AdminLayout current-page='list'>
   应该:<AdminLayout :currentPage="'cs-list'">

currentPage 在错误的位置

❌ pages/mall/admin/user-statistics.uvue
   现在:<AdminLayout><view currentPage='user'>
   应该:<AdminLayout :currentPage="'user'"><view>

❌ pages/mall/admin/content/index.uvue
   现在:<AdminLayout>(无 currentPage
   应该:<AdminLayout :currentPage="'content-list'">

❌ pages/mall/admin/system-settings.uvue
   现在:<AdminLayout>(无 currentPage
   应该:<AdminLayout :currentPage="'sys-basic'">

❌ pages/mall/admin/maintain/dev-config/category.uvue
   现在:<AdminLayout>(无 currentPage
   应该:<AdminLayout :currentPage="'dev-config-category'">

❌ pages/mall/admin/maintain/system-info.uvue
   现在:<AdminLayout>(无 currentPage
   应该:<AdminLayout :currentPage="'system-info'">

🔄 动态 currentPage 实现(已正确)

✅ pages/mall/admin/user-management.uvue
   <AdminLayout :currentPage="currentPage">
   // 根据 action 参数动态变化:
   // action='' → user-list
   // action=group → user-group
   // action=tag → user-tag
   // action=level → user-level
   // action=config → user-config

需要完全重新包装的文件36个

商品和订单(需要处理 tab 参数)

❌ pages/mall/admin/product-management.uvue
   缺少:<AdminLayout :currentPage="'product-list'">

❌ pages/mall/admin/order-management.uvue
   需要动态 currentPage根据 tab 参数):
   - tab=stats → order-stats
   - tab=list → order-list
   - tab=aftersale → order-aftersale
   - tab=cashier → order-cashier
   - tab=verify → order-verify
   - tab=config → order-config

营销和客服(需要包装)

❌ pages/mall/admin/marketing/coupon/list.uvue
   缺少:<AdminLayout :currentPage="'coupon-list'">

❌ pages/mall/admin/marketing/coupon/receive.uvue
   缺少:<AdminLayout :currentPage="'coupon-receive'">

❌ pages/mall/admin/marketing/points/index.uvue
   需要动态 currentPage根据 tab 参数):
   多个标签页对应不同的 currentPage

❌ pages/mall/admin/marketing/signin/rule.uvue
   缺少:<AdminLayout :currentPage="'signin-rule'">

❌ pages/mall/admin/marketing/signin/record.uvue
   缺少:<AdminLayout :currentPage="'signin-record'">

❌ pages/mall/admin/customer-service/script.uvue
   缺少:<AdminLayout :currentPage="'cs-script'">

❌ pages/mall/admin/customer-service/messages.uvue
   缺少:<AdminLayout :currentPage="'cs-message'">

❌ pages/mall/admin/customer-service/auto-reply.uvue
   缺少:<AdminLayout :currentPage="'cs-auto-reply'">

❌ pages/mall/admin/customer-service/config.uvue
   缺少:<AdminLayout :currentPage="'cs-config'">

系统管理(需要包装)

❌ pages/mall/admin/system/shipping/courier.uvue
   缺少:<AdminLayout :currentPage="'ship-courier'">

❌ pages/mall/admin/system/shipping/pickup/points.uvue
   缺少:<AdminLayout :currentPage="'pickup-points'">

❌ pages/mall/admin/system/shipping/pickup/verifiers.uvue
   缺少:<AdminLayout :currentPage="'pickup-verifier'">

❌ pages/mall/admin/system/shipping/freight-template.uvue
   缺少:<AdminLayout :currentPage="'ship-freight'">

维护管理(需要包装)

❌ pages/mall/admin/maintain/data/logistics-company.uvue
   缺少:<AdminLayout :currentPage="'data-logistics-company'">

❌ pages/mall/admin/maintain/data/city-data.uvue
   缺少:<AdminLayout :currentPage="'data-city-data'">

❌ pages/mall/admin/maintain/data/clear-data.uvue
   缺少:<AdminLayout :currentPage="'data-clear-data'">

❌ pages/mall/admin/maintain/external/account.uvue
   缺少:<AdminLayout :currentPage="'external-account'">

❌ pages/mall/admin/maintain/i18n/language-list.uvue
   缺少:<AdminLayout :currentPage="'i18n-language-list'">

❌ pages/mall/admin/maintain/i18n/language-detail.uvue
   缺少:<AdminLayout :currentPage="'i18n-language-detail'">

❌ pages/mall/admin/maintain/i18n/region-list.uvue
   缺少:<AdminLayout :currentPage="'i18n-region-list'">

❌ pages/mall/admin/maintain/i18n/translate-config.uvue
   缺少:<AdminLayout :currentPage="'i18n-translate-config'">

❌ pages/mall/admin/maintain/dev-tools/database.uvue
   缺少:<AdminLayout :currentPage="'dev-tools-db'">

❌ pages/mall/admin/maintain/dev-tools/file.uvue
   缺少:<AdminLayout :currentPage="'dev-tools-file'">

❌ pages/mall/admin/maintain/dev-tools/api.uvue
   缺少:<AdminLayout :currentPage="'dev-tools-api'">

❌ pages/mall/admin/maintain/dev-tools/codegen.uvue
   缺少:<AdminLayout :currentPage="'dev-tools-codegen'">

❌ pages/mall/admin/maintain/dev-tools/data-dict.uvue
   缺少:<AdminLayout :currentPage="'dev-tools-dict'">

📋 已导入但未使用的文件27个 - 类别 A

这些文件已经导入 AdminLayout但在 template 中没有使用它。需要在模板中使用并添加 currentPage。

商品管理6个

❌ pages/mall/admin/product-classification.uvue → 'product-classification'
❌ pages/mall/admin/product-specifications.uvue → 'product-specifications'
❌ pages/mall/admin/product-parameters.uvue → 'product-parameters'
❌ pages/mall/admin/product-labels.uvue → 'product-labels'
❌ pages/mall/admin/product-protection.uvue → 'product-protection'
❌ pages/mall/admin/product-reviews.uvue → 'product-reviews'

系统设置8个

❌ pages/mall/admin/system/message-management.uvue → 'sys-message'
❌ pages/mall/admin/system/agreement-settings.uvue → 'sys-agreement'
❌ pages/mall/admin/system/receipt-settings.uvue → 'sys-receipt'
❌ pages/mall/admin/system/permission/role.uvue → 'sys-role'
❌ pages/mall/admin/system/permission/admin-list.uvue → 'sys-admin'
❌ pages/mall/admin/system/permission/permission-setting.uvue → 'sys-perm-setting'
❌ pages/mall/admin/system/api/yht/page.uvue → 'api-yht-page'
❌ pages/mall/admin/system/api/yht/config.uvue → 'api-yht-config'

系统 API6个

❌ pages/mall/admin/system/api/storage.uvue → 'api-storage'
❌ pages/mall/admin/system/api/collect.uvue → 'api-collect'
❌ pages/mall/admin/system/api/logistics.uvue → 'api-logistics'
❌ pages/mall/admin/system/api/waybill.uvue → 'api-waybill'
❌ pages/mall/admin/system/api/sms.uvue → 'api-sms'
❌ pages/mall/admin/system/api/pay.uvue → 'api-pay'

维护 - 开发配置5个

❌ pages/mall/admin/maintain/dev-config/combination-data.uvue → 'dev-config-combo'
❌ pages/mall/admin/maintain/dev-config/cron-job.uvue → 'dev-config-cron'
❌ pages/mall/admin/maintain/dev-config/permission.uvue → 'dev-config-permission'
❌ pages/mall/admin/maintain/dev-config/module-config.uvue → 'dev-config-module'
❌ pages/mall/admin/maintain/dev-config/custom-event.uvue → 'dev-config-event'

维护 - 安全维护3个

❌ pages/mall/admin/maintain/security/refresh-cache.uvue → 'security-refresh-cache'
❌ pages/mall/admin/maintain/security/system-log.uvue → 'security-system-log'
❌ pages/mall/admin/maintain/security/online-upgrade.uvue → 'security-online-upgrade'

🔧 快速修改命令指南

对于类别 C 的简单修改7个文件

示例 1修复属性名

# 在 design/index.uvue
# 查找current-page='design'
# 替换为::currentPage="'design-home'"

示例 2移动 currentPage

# 在 user-statistics.uvue
# 查找:<AdminLayout><view class="Page" currentPage='user'>
# 替换为:<AdminLayout :currentPage="'user'"><view class="Page">

示例 3添加 currentPage

# 在 content/index.uvue
# 查找:<AdminLayout>
# 替换为:<AdminLayout :currentPage="'content-list'">

💡 重要提示

  1. 属性名必须使用 camelCase:使用 currentPage 而不是 current-page
  2. 值需要用引号:currentPage="'value'":currentPage="dynamicValue"
  3. 导入必须存在:确保导入了 AdminLayout from '@/layouts/admin/AdminLayout.uvue'
  4. 位置很重要currentPage 属性必须在 <AdminLayout> 标签上,而不是内层元素上
  5. 动态值推荐:对于多标签页面,建议使用动态 currentPage如 user-management.uvue

📁 完整的文件列表

按状态分类

状态 数量 文件
完全符合 2 homePage/index.uvue, product-statistics.uvue
⚠️ 需小修改 6 design/index.uvue, user-statistics.uvue, content/index.uvue, customer-service/list.uvue, system-settings.uvue, maintain/system-info.uvue, maintain/dev-config/category.uvue
🔄 动态实现 5 user-management.uvue, order-management.uvue (需实现), marketing/points/index.uvue (需实现)
需要修改 63 其他所有文件

📞 获取更详细的信息

  • 完整清单:查看 ADMIN_PAGE_COMPLIANCE_CHECKLIST.md
  • 修改计划:查看 ADMIN_PAGE_MODIFICATION_PLAN.md
  • Menu 定义:查看 layouts/admin/utils/menu.uts
  • Layout 组件:查看 layouts/admin/AdminLayout.uvue

快速参考表 - 生成时间2026年1月30日