314 lines
11 KiB
Markdown
314 lines
11 KiB
Markdown
# 后台页面检查 - 快速参考表
|
||
|
||
## 📊 整体统计
|
||
|
||
- **总路由数**：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'
|
||
```
|
||
|
||
### 系统 API（6个）
|
||
|
||
```
|
||
❌ 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：修复属性名**
|
||
|
||
```bash
|
||
# 在 design/index.uvue
|
||
# 查找：current-page='design'
|
||
# 替换为：:currentPage="'design-home'"
|
||
```
|
||
|
||
**示例 2：移动 currentPage**
|
||
|
||
```bash
|
||
# 在 user-statistics.uvue
|
||
# 查找：<AdminLayout><view class="Page" currentPage='user'>
|
||
# 替换为：<AdminLayout :currentPage="'user'"><view class="Page">
|
||
```
|
||
|
||
**示例 3：添加 currentPage**
|
||
|
||
```bash
|
||
# 在 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日_
|