From 6955e73317ab1ad594039f4b6e90e67b23b8449e Mon Sep 17 00:00:00 2001
From: huangzhenbao <17818024429@163.com>
Date: Thu, 19 Mar 2026 09:39:41 +0800
Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E4=BA=A4=E5=90=88=E5=B9=B6=E4=BB=A3?=
 =?UTF-8?q?=E7=A0=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 pages/mall/admin/docs/ADMIN_GUARD_STRATEGY.md |   54 -
 .../docs/ADMIN_LAYOUT_PROGRESS_REPORT.md      |   94 -
 .../docs/ADMIN_SIDEBAR_COMPLETE_GUIDE.md      |  422 ---
 .../mall/admin/docs/CRMEB_DASHBOARD_README.md |  570 ----
 pages/mall/admin/docs/CRMEB_ROUTE_FIX_LOG.md  |  267 --
 .../admin/docs/FINAL_COMPLETION_REPORT.md     |  432 ---
 .../mall/admin/docs/IMPORT_RESOLUTION_FIX.md  |   89 -
 .../admin/docs/PHASE_2_COMPLETION_REPORT.md   |  338 ---
 pages/mall/admin/docs/PHASE_2_INDEX.md        |  347 ---
 .../admin/docs/PHASE_2_QUICK_REFERENCE.md     |  256 --
 .../docs/PHASE_2_VERIFICATION_CHECKLIST.md    |  264 --
 pages/mall/admin/docs/ROUTING_FIX_REPORT.md   |   44 -
 .../admin/docs/SESSION_COMPLETION_SUMMARY.md  |  364 ---
 .../mall/admin/docs/SYSTEM_INFO_DIAGNOSIS.md  |  306 ---
 .../admin/docs/UNI_APP_X_PAGE_FIX_GUIDE.md    | 2408 +++++++++++++++++
 .../admin/docs/create_placeholder_pages.py    |  177 --
 ...__admin__user-management-db-integration.md |  121 -
 ...__admin__product-module-standardization.md |   50 -
 18 files changed, 2408 insertions(+), 4195 deletions(-)
 delete mode 100644 pages/mall/admin/docs/ADMIN_GUARD_STRATEGY.md
 delete mode 100644 pages/mall/admin/docs/ADMIN_LAYOUT_PROGRESS_REPORT.md
 delete mode 100644 pages/mall/admin/docs/ADMIN_SIDEBAR_COMPLETE_GUIDE.md
 delete mode 100644 pages/mall/admin/docs/CRMEB_DASHBOARD_README.md
 delete mode 100644 pages/mall/admin/docs/CRMEB_ROUTE_FIX_LOG.md
 delete mode 100644 pages/mall/admin/docs/FINAL_COMPLETION_REPORT.md
 delete mode 100644 pages/mall/admin/docs/IMPORT_RESOLUTION_FIX.md
 delete mode 100644 pages/mall/admin/docs/PHASE_2_COMPLETION_REPORT.md
 delete mode 100644 pages/mall/admin/docs/PHASE_2_INDEX.md
 delete mode 100644 pages/mall/admin/docs/PHASE_2_QUICK_REFERENCE.md
 delete mode 100644 pages/mall/admin/docs/PHASE_2_VERIFICATION_CHECKLIST.md
 delete mode 100644 pages/mall/admin/docs/ROUTING_FIX_REPORT.md
 delete mode 100644 pages/mall/admin/docs/SESSION_COMPLETION_SUMMARY.md
 delete mode 100644 pages/mall/admin/docs/SYSTEM_INFO_DIAGNOSIS.md
 create mode 100644 pages/mall/admin/docs/UNI_APP_X_PAGE_FIX_GUIDE.md
 delete mode 100644 pages/mall/admin/docs/create_placeholder_pages.py
 delete mode 100644 pages/mall/admin/docs/ops/2026-02-05__admin__user-management-db-integration.md
 delete mode 100644 pages/mall/admin/docs/ops/2026-02-06__admin__product-module-standardization.md

diff --git a/pages/mall/admin/docs/ADMIN_GUARD_STRATEGY.md b/pages/mall/admin/docs/ADMIN_GUARD_STRATEGY.md
deleted file mode 100644
index 2c92fa73..00000000
--- a/pages/mall/admin/docs/ADMIN_GUARD_STRATEGY.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# Admin 模块统一权限守卫策略
-
-本文档遵循 `@docs/AGENT_PROJECT_SPEC.md` 规范，旨在说明 Admin 模块前端页面的权限守卫实现策略、覆盖范围及待办事项。
-
-## 1. 统一守卫策略
-
-根据决策，Admin 模块采用**统一布局守卫**策略。
-
-- **守卫落点**：`@/layouts/admin/AdminLayout.uvue`
-- **触发时机**：`onMounted` 生命周期钩子
-
-所有使用 `<AdminLayout>` 组件包裹的页面，都会自动继承此安全策略，无需在各自页面内部重复编写守卫逻辑。
-
-## 2. 守卫行为
-
-守卫逻辑严格分为两步，符合前端“快速失败”和依赖方向原则：
-
-1.  **登录检查（无 IO）**：
-    - 调用 `services/analytics/authGuard.uts` 中的 `ensureAnalyticsLogin()`。
-    - **行为**：如果用户未登录（无有效 session），则中断页面加载，并自动跳转到登录页（`/pages/user/login`），同时附带 `redirect` 参数，以便登录后能返回原页面。
-
-2.  **角色检查（依赖本地 Profile）**：
-    - 调用 `utils/store.uts` 中的 `await getCurrentUser()` 获取当前用户的 `profile`，该 `profile` 中包含了从 `ak_users` 同步的 `role` 字段。
-    - **行为**：检查 `role` 是否为 `'admin'` 或 `'analytics'` 之一。如果不是，则：
-        - `uni.showToast({ title: '权限不足' })`
-        - 800ms 后 `uni.switchTab({ url: '/pages/mall/consumer/index' })`（按决策 B 跳转到消费者首页）。
-
-只有当登录和角色检查都通过后，`AdminLayout` 才会继续执行其内部的导航和组件渲染逻辑。
-
-## 3. 覆盖范围
-
-### 已确认被统一守卫覆盖的页面：
-
-- `pages/mall/admin/index_new.uvue` (通过其使用的 `AdminLayout`)
-- `pages/mall/admin/product/product-statistics/index.uvue`
-- `pages/mall/admin/user/Statistic.uvue`
-- `pages/mall/admin/order/order-statistics/index.uvue` (本次已改造)
-- 其他所有在模板中使用了 `<AdminLayout>` 的页面。
-
-### **例外与风险**：未被统一守卫覆盖的 Admin 页面
-
-以下在 `pages.json` 中注册的 `admin` 路由，由于是独立的“裸”页面，**不会**被 `AdminLayout` 的统一守卫保护，存在安全风险：
-
-- `pages/mall/admin/index`
-- `pages/mall/admin/user-detail`
-- `pages/mall/admin/merchant-detail`
-- `pages/mall/admin/system-monitor`
-
-## 4. 待办事项
-
-为实现 Admin 模块权限的全覆盖，建议后续处理上述例外页面：
-
-- **方案 1（推荐）**：将这些独立的页面改造为使用 `<AdminLayout>` 包裹，使其自动纳入统一守卫范围。
-- **方案 2（临时）**：在这些页面的 `onLoad` 钩子中，手动加入与 `AdminLayout` 中相同的守卫逻辑代码。
diff --git a/pages/mall/admin/docs/ADMIN_LAYOUT_PROGRESS_REPORT.md b/pages/mall/admin/docs/ADMIN_LAYOUT_PROGRESS_REPORT.md
deleted file mode 100644
index f620a353..00000000
--- a/pages/mall/admin/docs/ADMIN_LAYOUT_PROGRESS_REPORT.md
+++ /dev/null
@@ -1,94 +0,0 @@
-# 🎯 后台布局改造 - 当前进度报告
-
-## 📊 进度概览
-
-### ✅ 已完成 (核心改造)
-
-- **AdminSubSider 自动跳转修复** ✅
-- **样式修正 (flex-direction)** ✅
-- **导航方式优化 (redirectTo)** ✅
-- **状态管理验证** ✅
-- **AdminLayout 组件创建** ✅
-
-### 🔧 已修复 (语法错误)
-
-- **Vite Vue 编译错误** ✅
-- **缺少结束标签问题** ✅
-- **AdminLayout 包装错误** ✅
-
-### 📋 页面包装进度
-
-- **已完成页面**: ~40 个 (新增: 秒杀、直播、付费会员、用户充值、每日签到相关页面)
-- **交互修复**: 修复了“选择图片”和“开启/隐藏”开关无法点击的问题。
-- **剩余页面**: ~25 个
-- **总进度**: ~61%
-
-## 🎯 剩余工作清单
-
-### 已完成 (营销管理 - 秒杀、直播、付费会员、用户充值、每日签到) ✅
-
-- [x] `marketing/seckill/list.uvue` -> `seckill-list`
-- [x] `marketing/seckill/product.uvue` -> `seckill-product`
-- [x] `marketing/seckill/config.uvue` -> `seckill-config`
-- [x] `marketing/live/room.uvue` -> `live-room`
-- [x] `marketing/live/product.uvue` -> `live-items`
-- [x] `marketing/live/anchor.uvue` -> `live-anchors`
-- [x] `marketing/member/type.uvue` -> `member-type`
-- [x] `marketing/member/right.uvue` -> `member-rights`
-- [x] `marketing/member/card.uvue` -> `member-card`
-- [x] `marketing/member/record.uvue` -> `member-record`
-- [x] `marketing/member/config.uvue` -> `member-config`
-- [x] `marketing/recharge/quota.uvue` -> `recharge-quota`
-- [x] `marketing/recharge/config.uvue` -> `recharge-config`
-- [x] `marketing/checkin/config.uvue` -> `checkin-config`
-- [x] `marketing/checkin/reward.uvue` -> `checkin-reward` (实现连续/累积奖励切换及添加弹窗)
-- [x] `marketing/newcomer/index.uvue` -> `newcomer-gift` (实现余额、积分及优惠券选择弹窗)
-- [x] **交互增强**: 为所有新页面添加了 Switch 切换、图片上传、详情弹窗/抽屉、删除确认等逻辑。
-
-### 高优先级 (核心功能页面)
-
-1. `marketing/coupon/list.uvue` → `coupon-list`
-2. `marketing/coupon/receive.uvue` → `coupon-receive`
-3. `marketing/points/index.uvue` → `points-stats` (动态)
-4. `marketing/signin/rule.uvue` → `signin-rule`
-5. `marketing/signin/record.uvue` → `signin-record`
-
-### 中优先级 (系统设置页面)
-
-6. `system/permission/role.uvue` → `sys-role`
-7. `system/permission/admin-list.uvue` → `sys-admin`
-8. `system/permission/permission-setting.uvue` → `sys-perm-setting`
-9. `system/shipping/courier.uvue` → `ship-courier`
-10. `system/shipping/freight-template.uvue` → `ship-freight`
-11. `system/shipping/pickup/points.uvue` → `pickup-points`
-12. `system/shipping/pickup/verifiers.uvue` → `pickup-verifier`
-
-### 低优先级 (维护工具页面)
-
-13. `maintain/dev-config/*` → 各种 dev-config-\* ID
-14. `maintain/dev-tools/*` → 各种 dev-tools-\* ID
-15. `maintain/data/*` → 各种 data-\* ID
-16. `maintain/security/*` → 各种 security-\* ID
-17. `maintain/i18n/*` → 各种 i18n-\* ID
-18. `maintain/external/*` → `external-account`
-19. `subscription/*` → 各种订阅相关页面
-
-## 🚀 快速继续方案
-
-### 方案A: 批量自动化处理
-
-使用脚本自动为所有剩余页面添加 AdminLayout 包装
-
-### 方案B: 按优先级逐步处理
-
-从高优先级页面开始，逐步完成
-
-### 方案C: 生成详细指南
-
-创建完整的修改指南，让开发团队自行完成
-
-## 💡 建议
-
-**推荐方案A**: 批量自动化处理可以快速完成所有页面，节省时间并保证一致性。
-
-你希望选择哪个方案继续？或者有其他具体需求？
diff --git a/pages/mall/admin/docs/ADMIN_SIDEBAR_COMPLETE_GUIDE.md b/pages/mall/admin/docs/ADMIN_SIDEBAR_COMPLETE_GUIDE.md
deleted file mode 100644
index 7e83d922..00000000
--- a/pages/mall/admin/docs/ADMIN_SIDEBAR_COMPLETE_GUIDE.md
+++ /dev/null
@@ -1,422 +0,0 @@
-# 确保 Admin 页面侧边栏一直显示的完整步骤
-
-## 概述
-
-确保 uni-app-x 的 Admin 页面在切换过程中保持侧边栏显示需要从多个维度进行配置。以下是完整的步骤检查清单。
-
----
-
-## 第一部分：文件和路由配置
-
-### 1.1 创建新的 Admin 页面文件
-
-**文件路径**: `pages/mall/admin/maintain/<category>/<page-name>.uvue`
-
-**重点**:
-
-- ✅ 使用 UTF-8 编码（**不要 BOM**）
-- ✅ 严格的 SFC 结构: `<template>` → `<script>` → `<style>`
-- ✅ 没有额外内容在closing tags之后
-
-**模板**:
-
-```uvue
-<template>
-  <AdminLayout currentPage="<page-id>">
-    <view class="page">
-      <!-- 页面内容 -->
-    </view>
-  </AdminLayout>
-</template>
-
-<script setup lang="uts">
-import AdminLayout from '@/layouts/admin/AdminLayout.uvue'
-</script>
-
-<style scoped>
-.page {
-  padding: 20px;
-}
-</style>
-```
-
-### 1.2 在 pages.json 中注册路由
-
-**位置**: `pages.json` 中的合适分类下
-
-**格式**:
-
-```json
-{
-  "path": "maintain/<category>/<page-name>",
-  "style": {
-    "navigationBarTitleText": "页面标题",
-    "navigationStyle": "custom"
-  }
-}
-```
-
-**重点**:
-
-- ✅ `navigationStyle: "custom"` 必须设置，允许自定义 AdminLayout
-- ✅ `path` 必须与文件结构匹配
-
----
-
-## 第二部分：菜单配置
-
-### 2.1 在 menu.uts 中定义菜单项
-
-**文件**: `layouts/admin/utils/menu.uts`
-
-**两种菜单结构**:
-
-#### 选项 A：有子菜单的菜单组（推荐）
-
-```typescript
-{
-  id: 'maintain',
-  title: '维护',
-  icon: '/static/maintain.svg',
-  path: '/pages/mall/admin/maintain/...',
-  groups: [
-    {
-      id: 'dev-config',
-      title: '开发配置',
-      children: [
-        {
-          id: 'module-config',
-          title: '模块配置',
-          path: '/pages/mall/admin/maintain/dev-config/module-config'
-        }
-      ]
-    }
-  ]
-}
-```
-
-#### 选项 B：没有子菜单的菜单组（叶子节点）
-
-```typescript
-{
-  id: 'maintain',
-  title: '维护',
-  groups: [
-    {
-      id: 'system-info',
-      title: '系统信息',
-      path: '/pages/mall/admin/maintain/system-info',
-      children: []  // ⚠️ 必须显式设置为空数组
-    }
-  ]
-}
-```
-
-**重点**:
-
-- ✅ 每个 menu item 必须有唯一的 `id`
-- ✅ 如果是叶子节点，必须显式设置 `children: []`
-- ✅ `path` 必须与 pages.json 路由匹配
-
-### 2.2 菜单 ID 命名规则
-
-**建议**:
-
-```
-一级菜单: maintain / user / order / product
-二级组: dev-config / security / data / external
-子项: module-config / permission / cron-job
-
-currentPage 值应该与 menu.id 对应:
-- 对应一级: currentPage="maintain"
-- 对应二级: currentPage="system-info"
-- 对应三级: currentPage="module-config"
-```
-
----
-
-## 第三部分：导航逻辑
-
-### 3.1 nav.uts 匹配规则
-
-**文件**: `layouts/admin/utils/nav.uts`
-
-**关键函数**: `findActiveByCurrentPage(menuList, currentPage)`
-
-**匹配顺序** (必须按此顺序):
-
-1. 一级菜单 ID 匹配: `m.id === currentPage`
-2. 二级菜单组 ID 匹配: `g.id === currentPage` ⚠️ **包括叶子节点**
-3. 二级菜单组 path 匹配: `normalize(g.path) === normalize(currentPage)`
-4. 三级菜单子项 ID 匹配: `c.id === currentPage`
-5. 三级菜单子项 path 匹配: `normalize(c.path) === normalize(currentPage)`
-6. 四级及以上: 递归查找
-7. 默认兜底: 返回 `{ activeMenuId: 'home', activeSubId: '' }`
-
-**核心代码**:
-
-```typescript
-// 关键：在检查 children 前，先检查 group 本身是否是叶子节点
-for (const g of groups) {
-  if (g.id === page) {
-    return { activeMenuId: m.id, activeSubId: g.id }; // ✅ 叶子节点匹配
-  }
-  if (g.path && normalize(g.path) === pageNorm) {
-    return { activeMenuId: m.id, activeSubId: g.id }; // ✅ 叶子节点路径匹配
-  }
-  // 然后才检查 children
-  const cs = g.children ?? [];
-  // ...
-}
-```
-
-### 3.2 页面中使用 currentPage
-
-**在页面文件中**:
-
-```uvue
-<AdminLayout currentPage="system-info">
-  <!-- 页面内容 -->
-</AdminLayout>
-```
-
-**currentPage 值确定规则**:
-
-- 如果页面是二级菜单组的叶子: 使用 group id (`system-info`)
-- 如果页面是三级菜单子项: 使用 child id (`module-config`)
-- 也可以使用路径形式 (`/pages/mall/admin/maintain/system-info`)
-
----
-
-## 第四部分：AdminLayout 组件
-
-### 4.1 AdminLayout.uvue 的关键逻辑
-
-**文件**: `layouts/admin/AdminLayout.uvue`
-
-**核心职责**:
-
-```typescript
-// 1. 导入必要的生命周期和工具
-import { onShow } from "@dcloudio/uni-app";
-import { findActiveByCurrentPage } from "./utils/nav.uts";
-
-// 2. 接收 currentPage prop
-const props = defineProps<{ currentPage: string }>();
-
-// 3. 同步导航状态的关键函数
-const syncActiveByCurrentPage = () => {
-  let current = props.currentPage;
-  if (!current) {
-    // 如果没有 currentPage，从路由获取
-    const pages = getCurrentPages();
-    const last = pages[pages.length - 1];
-    current = last?.route ? `/${last.route}` : "";
-  }
-  const r = findActiveByCurrentPage(menuList.value, current);
-  activeMenuId.value = r.activeMenuId; // ✅ 更新一级菜单
-  activeSubId.value = r.activeSubId; // ✅ 更新二级菜单
-};
-
-// 4. 在多个生命周期调用同步函数
-watch(
-  () => props.currentPage,
-  () => syncActiveByCurrentPage(),
-  { immediate: true },
-);
-onMounted(() => syncActiveByCurrentPage());
-onShow(() => syncActiveByCurrentPage());
-
-// 5. 计算二级侧边栏的内容
-const activeGroups = computed(() => {
-  const m = menuList.value.find((it) => it.id === activeMenuId.value);
-  return m?.groups ?? [];
-});
-
-// 6. 根据 activeSubId 计算面包屑标题
-const breadcrumb = computed(() => {
-  let subTitle = "";
-  const groups = activeGroups.value;
-  for (const g of groups) {
-    // ✅ 检查 group 本身（支持叶子节点）
-    if (g.id === activeSubId.value) {
-      subTitle = g.title;
-      break;
-    }
-    // ✅ 检查 group 的 children
-    const cs = g.children ?? [];
-    const hit = cs.find((c) => c.id === activeSubId.value);
-    if (hit) {
-      subTitle = hit.title;
-      break;
-    }
-  }
-  return subTitle
-    ? `${activeMenuTitle.value} / ${subTitle}`
-    : activeMenuTitle.value;
-});
-```
-
-**渲染 AdminSubSider 时**:
-
-```uvue
-<AdminSubSider
-  v-if="activeGroups.length > 0"
-  :activeMenuTitle="activeMenuTitle"
-  :groups="activeGroups"
-  :activeSubId="activeSubId"
-  :activeMenuId="activeMenuId || 'home'"
-  @sub-click="onSubClick"
-/>
-```
-
----
-
-## 第五部分：AdminSubSider 二级侧边栏
-
-### 5.1 二级侧边栏的 groupAsChild 逻辑
-
-**文件**: `layouts/admin/components/AdminSubSider.uvue`
-
-**关键逻辑**:
-
-```typescript
-// 支持 group 作为菜单项（叶子节点）的点击处理
-const handleGroupTitleClick = (group: MenuGroup) => {
-  // 如果 group 有 path，直接导航
-  if (group.path) {
-    go(group.path)
-  }
-  // 否则选中这个 group
-  else {
-    activeSubId.value = group.id
-  }
-}
-
-// 模板中
-<template v-for="group in groups">
-  <view
-    v-if="!group.children || group.children.length === 0"
-    class="group-as-child"
-    @click="handleGroupTitleClick(group)"
-    :class="{ active: activeSubId === group.id }"
-  >
-    {{ group.title }}
-  </view>
-  <view v-else class="group-normal">
-    <!-- 正常的组处理 -->
-  </view>
-</template>
-```
-
----
-
-## 第六部分：状态管理（可选但推荐）
-
-### 6.1 使用 state.uts 管理全局状态
-
-**文件**: `layouts/admin/state.uts`
-
-```typescript
-import { ref } from "vue";
-
-// 跨页面持久化的状态
-export const tabs = ref<TabItem[]>([]);
-export const activeTabId = ref("");
-export const isCollapsed = ref(false);
-export const hasNotification = ref(false);
-```
-
-**优点**:
-
-- ✅ 页面切换时保持侧边栏收起/展开状态
-- ✅ 标签页状态持久化
-- ✅ 通知状态保持
-
----
-
-## 完整检查清单
-
-### 📋 新增页面时必须检查:
-
-- [ ] **文件**
-  - [ ] 文件位置正确: `pages/mall/admin/maintain/<category>/<page-name>.uvue`
-  - [ ] 编码是 UTF-8（无 BOM）
-  - [ ] 正确的 SFC 结构
-  - [ ] `<script setup>` 导入了 `AdminLayout`
-
-- [ ] **路由配置**
-  - [ ] 在 `pages.json` 中注册了路由
-  - [ ] `navigationStyle: "custom"` 设置正确
-  - [ ] `path` 与文件结构匹配
-
-- [ ] **菜单配置**
-  - [ ] 在 `menu.uts` 中定义了菜单项
-  - [ ] menu id 唯一且命名规范
-  - [ ] 如果是叶子节点，设置 `children: []`
-  - [ ] 路径与 pages.json 匹配
-
-- [ ] **页面文件**
-  - [ ] `currentPage` prop 值正确
-  - [ ] `currentPage` 与菜单配置中的 id 对应
-
-- [ ] **缓存清理**
-  - [ ] 删除 `unpackage/dist`
-  - [ ] 删除 `.hbuilderx/cache`
-  - [ ] 清理浏览器缓存 (Ctrl+Shift+Delete)
-  - [ ] 强制刷新页面 (Ctrl+Shift+R)
-
----
-
-## 调试技巧
-
-### 验证导航匹配
-
-```powershell
-node test-system-info-nav.js
-```
-
-### 浏览器控制台诊断
-
-```javascript
-// 在浏览器 DevTools 中运行
-const pages = getCurrentPages();
-const route = pages[pages.length - 1]?.route;
-console.log("当前路由:", route);
-
-// 查看 AdminLayout 组件状态
-// 打开 Vue DevTools 查看 activeMenuId, activeSubId
-```
-
-### 常见问题排查
-
-| 问题         | 原因                       | 解决                             |
-| ------------ | -------------------------- | -------------------------------- |
-| 侧边栏不显示 | `currentPage` 未匹配到菜单 | 检查 nav.uts 匹配逻辑            |
-| 高亮错误     | menu.id 不一致             | 确保 currentPage 与 menu id 相同 |
-| 页面切换闪烁 | 缓存问题                   | 清理缓存，强制刷新               |
-| 编译错误     | 文件编码问题               | 重新创建文件，确保无 BOM         |
-| 组件无法解析 | @ 别名未配置               | 检查 tsconfig.json 的 paths      |
-
----
-
-## 总结：一句话版本
-
-**确保 Admin 页面侧边栏一直显示的关键是**:
-
-> 正确配置菜单结构 → 准确设置 currentPage → 实现导航匹配逻辑 → 同步状态到 AdminLayout → 支持叶子节点处理
-
----
-
-## 参考文件
-
-| 文件                                                    | 职责         |
-| ------------------------------------------------------- | ------------ |
-| `pages/mall/admin/maintain/<category>/<page-name>.uvue` | 页面文件     |
-| `pages.json`                                            | 路由配置     |
-| `layouts/admin/utils/menu.uts`                          | 菜单定义     |
-| `layouts/admin/utils/nav.uts`                           | 导航匹配逻辑 |
-| `layouts/admin/AdminLayout.uvue`                        | 布局容器     |
-| `layouts/admin/components/AdminSubSider.uvue`           | 二级侧边栏   |
-| `layouts/admin/state.uts`                               | 全局状态     |
-| `tsconfig.json`                                         | 编译配置     |
diff --git a/pages/mall/admin/docs/CRMEB_DASHBOARD_README.md b/pages/mall/admin/docs/CRMEB_DASHBOARD_README.md
deleted file mode 100644
index b0dea6fa..00000000
--- a/pages/mall/admin/docs/CRMEB_DASHBOARD_README.md
+++ /dev/null
@@ -1,570 +0,0 @@
-# CRMEB 标准版后台管理系统
-
-## 📋 项目概述
-
-基于 uni-app-x 完全自主开发的 CRMEB 风格后台管理系统，严格遵循 CRMEB 设计规范，实现完整的数据看板和用户统计功能。
-
-## 🏗️ 目录结构
-
-```
-mall/
-├── App.uvue                           # 全局样式配置
-├── layouts/
-│   └── admin/
-│       ├── index.uvue                # 主布局组件
-│       ├── components/
-│       │   └── card.uvue            # 卡片组件
-│       └── utils/
-│           └── echarts-config.uts   # ECharts配置
-├── pages/
-│   ├── minimal.uvue                 # 测试页面
-│   └── mall/
-│       └── admin/
-│           ├── index.uvue           # 数据看板
-│           ├── user-management.uvue # 用户管理
-│           ├── product-management.uvue # 商品管理
-│           ├── order-management.uvue # 订单管理
-│           ├── finance-management.uvue # 财务管理
-│           └── user-statistics.uvue # 用户统计页
-├── pages.json                       # 页面配置
-└── CRMEB_DASHBOARD_README.md        # 项目文档
-```
-
-## 🎨 设计规范
-
-### 全局样式体系
-- **24栅格系统**: 响应式布局，支持1-24列
-- **CSS变量**: 统一的颜色、间距、圆角规范
-- **全局重置**: 消除浏览器默认样式差异
-- **主题色**: CRMEB 风格的蓝色系配色
-
-### 布局架构
-- **AdminLayout**: 左侧菜单 + 顶部导航 + 标签页 + 内容区
-- **垂直菜单**: 一级图标菜单 + 二级文字菜单 + 折叠功能
-- **标签页**: 可关闭的多标签页，支持切换导航
-- **内容区**: flex:1 + height:0 + scroll-view 确保正确滚动
-
-## 📊 核心功能
-
-### 1. 数据看板 (Dashboard)
-
-#### KPI 指标卡片 (第一行)
-```vue
-<!-- 4个KPI卡片：销售额/访问量/订单量/新增用户 -->
-<view class="kpi-cards-row">
-  <view class="kpi-card">
-    <view class="card-content">
-      <view class="card-header">
-        <text class="card-title">销售额</text>
-        <view class="card-tag">今日</view>
-      </view>
-      <view class="card-value">
-        <text class="value-number">¥125,680.50</text>
-        <view class="value-trend up">+5.7%</view>
-      </view>
-      <view class="card-footer">
-        <text>昨日：¥118,920.30</text>
-        <text>本月累计：¥2,857,808.90</text>
-      </view>
-    </view>
-  </view>
-</view>
-```
-
-#### 订单统计图表 (第二行)
-```vue
-<!-- 柱状图(订单金额) + 折线图(订单数量) -->
-<AdminCard title="订单统计">
-  <view class="chart-container">
-    <!-- ECharts 组合图表 -->
-  </view>
-</AdminCard>
-```
-
-#### 用户分析图表 (第三行)
-```vue
-<!-- 用户趋势折线图 + 用户构成饼图 -->
-<view class="charts-row two-cols">
-  <AdminCard title="用户趋势"><!-- 折线图 --></AdminCard>
-  <AdminCard title="用户构成"><!-- 饼图 --></AdminCard>
-</view>
-```
-
-### 2. 用户统计页
-
-#### 筛选条件栏
-```vue
-<view class="filter-section">
-  <view class="filter-row">
-    <view class="filter-left">
-      <!-- 用户渠道选择器 + 日期范围选择器 -->
-    </view>
-    <view class="filter-right">
-      <!-- 查询按钮 + 导出按钮 -->
-    </view>
-  </view>
-</view>
-```
-
-#### 指标概览 (6个KPI卡片)
-```vue
-<view class="metrics-row">
-  <!-- 累计用户/访客数/浏览量/新增用户/成交用户/付费会员 -->
-</view>
-```
-
-#### 多折线趋势图
-```vue
-<view class="chart-section">
-  <view class="admin-card">
-    <!-- 图表图例 + 多折线图表 -->
-  </view>
-</view>
-```
-
-## 🔧 技术实现
-
-### AdminLayout 组件
-
-#### 核心特性
-```javascript
-// 双层侧边栏
-const menuList = ref([
-  {
-    id: 'dashboard',
-    title: '首页',
-    icon: 'icon-dashboard',
-    path: '/pages/mall/admin/index',
-    subMenus: [] // 二级菜单
-  }
-  // ... 其他菜单项
-])
-
-// 标签页管理
-const tabs = ref([
-  { id: 'dashboard', title: '首页', closable: false }
-])
-
-// 折叠状态
-const isCollapsed = ref(false)
-```
-
-#### 布局结构
-```vue
-<view class="admin-layout">
-  <!-- 左侧 Sider -->
-  <view class="admin-sider" :class="{ 'sider-collapsed': isCollapsed }">
-    <view class="sider-header"><!-- Logo + 折叠按钮 --></view>
-    <view class="menu-primary"><!-- 一级菜单 --></view>
-    <view class="menu-secondary"><!-- 二级菜单 --></view>
-  </view>
-
-  <!-- 主内容区 -->
-  <view class="admin-main">
-    <view class="admin-header"><!-- 顶部导航 --></view>
-    <view class="admin-tabs"><!-- 标签页 --></view>
-    <scroll-view class="page-content" scroll-y="true" :style="{ flex: '1', height: '0' }">
-      <slot /><!-- 页面内容 -->
-    </scroll-view>
-  </view>
-</view>
-```
-
-### ECharts 图表配置
-
-#### 组合图表配置
-```javascript
-export const getOrderChartOption = (period) => ({
-  series: [
-    {
-      name: '订单金额',
-      type: 'bar',
-      data: amountData,
-      itemStyle: { color: '#1890ff' }
-    },
-    {
-      name: '订单数量',
-      type: 'line',
-      data: countData,
-      itemStyle: { color: '#52c41a' }
-    }
-  ]
-})
-```
-
-#### 多折线图配置
-```javascript
-export const getUserStatisticsOption = () => ({
-  series: [
-    { name: '新增用户', type: 'line', data: newUsersData },
-    { name: '访客数', type: 'line', data: visitorsData },
-    // ... 更多数据线
-  ]
-})
-```
-
-## 📱 响应式设计
-
-### 断点系统
-```scss
-/* >=1200px: 4卡片一行 */
-.kpi-cards-row { display: flex; gap: 24px; }
-
-/* <=1200px: 2卡片一行 */
-@media (max-width: 1199px) {
-  .kpi-card { min-width: 45%; }
-}
-
-/* <=768px: 单列布局 */
-@media (max-width: 767px) {
-  .kpi-cards-row { flex-direction: column; }
-  .charts-row.two-cols { flex-direction: column; }
-}
-```
-
-### 栅格系统
-```scss
-/* 24列栅格系统 */
-.col-6 { flex: 0 0 25%; max-width: 25%; }
-.col-12 { flex: 0 0 50%; max-width: 50%; }
-.col-24 { flex: 0 0 100%; max-width: 100%; }
-```
-
-## 🚀 运行指南
-
-### 开发环境
-```bash
-# HBuilderX 中运行
-# 选择：运行 -> 运行到浏览器 -> Chrome
-```
-
-### 页面访问
-- **数据看板**: `/pages/mall/admin/index`
-- **用户统计**: `/pages/mall/admin/user-statistics`
-- **其他页面**: 通过左侧菜单导航
-
-### 功能测试
-1. **菜单导航**: 点击左侧菜单切换页面
-2. **标签页**: 点击标签切换，点击关闭按钮关闭
-3. **折叠功能**: 点击折叠按钮收起/展开菜单
-4. **图表展示**: 查看各种数据图表
-5. **响应式**: 调整浏览器窗口测试适配
-
-## 📚 开发规范
-
-### 文件命名
-- **组件**: PascalCase (`AdminLayout.vue`)
-- **页面**: kebab-case (`user-statistics.uvue`)
-- **工具**: camelCase (`echarts-config.uts`)
-
-### 代码组织
-```vue
-<template>
-  <!-- 模板：清晰的结构层次 -->
-</template>
-
-<script setup lang="uts">
-  // 导入语句
-  // 响应式数据
-  // 计算属性
-  // 生命周期
-  // 方法定义
-</script>
-
-<style>
-  /* 组件内样式：避免scoped污染 */
-</style>
-```
-
-### 样式原则
-- **组件内样式**: 避免 `scoped`，确保样式隔离
-- **CSS变量**: 使用统一的主题变量
-- **BEM命名**: 清晰的样式命名规范
-- **移动优先**: 响应式设计从移动端开始
-
-## 🎯 项目特色
-
-### ✅ 完全自主开发
-- **0%源码复制**: 100%自主编写
-- **CRMEB风格**: 严格遵循设计规范
-- **技术先进**: Vue 3 + TypeScript + uni-app-x
-- **功能完整**: 数据看板 + 用户统计双页面
-
-### ✅ 设计还原度高
-- **布局结构**: 1:1还原CRMEB后台布局
-- **视觉风格**: 白底轻阴影，Element-UI设计语言
-- **交互体验**: 流畅的动画和反馈效果
-- **响应式**: 全设备适配
-
-### ✅ 架构优秀
-- **组件化**: 模块化组件设计
-- **可扩展**: 易于添加新功能
-- **可维护**: 清晰的代码结构
-- **性能优化**: 合理的渲染策略
-
-## 📋 功能清单
-
-### 已实现功能
-- ✅ CRMEB风格垂直菜单布局
-- ✅ 顶部多标签页系统
-- ✅ 双层侧边栏导航
-- ✅ KPI指标卡片展示
-- ✅ 订单统计组合图表
-- ✅ 用户趋势分析图表
-- ✅ 用户构成饼图
-- ✅ 用户统计筛选功能
-- ✅ 多折线趋势图表
-- ✅ 响应式24栅格布局
-- ✅ 完整的样式系统
-- ✅ ECharts图表配置
-
-### 扩展功能
-- 🔄 ECharts实际集成
-- 🔄 数据实时更新
-- 🔄 图表交互功能
-- 🔄 数据导出功能
-- 🔄 更多管理页面
-
----
-
-## 🎉 总结
-
-本项目成功实现了CRMEB标准版后台管理系统，具备完整的数据看板和用户统计功能。通过严格遵循CRMEB的设计规范和自主开发，确保了代码质量和技术先进性。
-
-项目采用了现代化的技术栈，实现了响应式设计和模块化架构，为后续功能扩展奠定了坚实基础。
-
----
-
-## 🚀 部署运行
-
-### 开发环境
-```bash
-# HBuilderX 中运行
-# 选择：运行 -> 运行到浏览器
-```
-
-### 访问页面
-- **数据看板**: `/pages/mall/admin/index`
-- **用户统计**: `/pages/mall/admin/user-statistics`
-- **其他页面**: 通过左侧菜单导航
-
-### 功能验证
-1. **菜单导航**: 左侧双层菜单切换页面
-2. **标签页**: 顶部标签页切换和关闭
-3. **折叠功能**: 菜单栏收起/展开
-4. **图表展示**: 查看各种数据可视化
-5. **响应式**: 调整窗口测试适配效果
-
-## 📋 功能清单
-
-### ✅ 已实现功能
-- [x] CRMEB风格垂直菜单布局
-- [x] 顶部多标签页系统
-- [x] 双层侧边栏导航
-- [x] 二级菜单Tab切换功能
-- [x] KPI指标卡片展示
-- [x] 订单统计组合图表
-- [x] 用户趋势分析图表
-- [x] 用户构成饼图
-- [x] 用户统计筛选功能
-- [x] 多折线趋势图表
-- [x] 响应式24栅格布局
-- [x] 完整的样式系统
-- [x] ECharts图表配置
-- [x] 页面参数处理(onLoad)
-- [x] Tab内部状态管理
-
-### 🎯 技术亮点
-- **完全自主开发**: 0%源码复制，100%原创
-- **CRMEB风格还原**: 严格遵循设计规范
-- **现代技术栈**: Vue 3 + TypeScript + uni-app-x
-- **架构设计**: 模块化组件，易于维护
-- **用户体验**: 流畅交互，响应式适配
-
----
-
-## 🔧 二级菜单Tab切换机制详解
-
-### 实现原理
-
-CRMEB后台的二级菜单采用 **页面级Tab切换** 模式：
-- 点击一级菜单：跳转到对应页面的**默认Tab**
-- 点击二级菜单：跳转到同一页面的**指定Tab**
-- 通过URL参数控制Tab状态
-
-### 技术实现
-
-#### 1. AdminLayout菜单配置
-```javascript
-const menuList = ref([
-  {
-    id: 'user',
-    title: '用户管理',
-    icon: 'icon-user',
-    path: '/pages/mall/admin/user-management',
-    subMenus: [
-      {
-        id: 'user-list',
-        title: '用户列表',
-        path: '/pages/mall/admin/user-management'  // 默认Tab
-      },
-      {
-        id: 'user-add',
-        title: '添加用户',
-        path: '/pages/mall/admin/user-management?action=add'  // 指定Tab
-      }
-    ]
-  },
-  {
-    id: 'product',
-    title: '商品管理',
-    icon: 'icon-shopping',
-    path: '/pages/mall/admin/product-management',
-    subMenus: [
-      {
-        id: 'product-list',
-        title: '商品列表',
-        path: '/pages/mall/admin/product-management'
-      },
-      {
-        id: 'product-add',
-        title: '添加商品',
-        path: '/pages/mall/admin/product-management?action=add'
-      },
-      {
-        id: 'category',
-        title: '商品分类',
-        path: '/pages/mall/admin/product-management?tab=category'
-      }
-    ]
-  }
-])
-```
-
-#### 2. 菜单点击处理
-```javascript
-const handleMenuClick = (menu: any) => {
-  activeMenu.value = menu.id
-  // 跳转到默认Tab
-  uni.navigateTo({ url: menu.path })
-}
-
-const handleSubMenuClick = (subMenu: any) => {
-  activeSubMenu.value = subMenu.id
-  // 跳转到指定Tab（带参数）
-  uni.navigateTo({ url: subMenu.path })
-}
-```
-
-#### 3. 页面参数处理
-```javascript
-// 页面Tab配置
-const tabs = ref([
-  { key: 'user-list', title: '用户列表', icon: 'icon-list' },
-  { key: 'user-add', title: '添加用户', icon: 'icon-add' },
-  { key: 'category', title: '商品分类', icon: 'icon-category' }
-])
-
-const activeTab = ref('user-list')
-
-// 页面加载时处理参数
-onLoad((options: any) => {
-  if (options && options.action) {
-    if (options.action === 'add') {
-      activeTab.value = 'user-add'
-      showAddModal.value = true
-    }
-  } else if (options && options.tab) {
-    if (options.tab === 'category') {
-      activeTab.value = 'category'
-    }
-  }
-})
-```
-
-#### 4. Tab内容切换
-```vue
-<!-- Tab栏 -->
-<view class="tab-bar">
-  <view
-    v-for="tab in tabs"
-    :key="tab.key"
-    class="tab-item"
-    :class="{ 'active': activeTab === tab.key }"
-    @click="switchTab(tab.key)"
-  >
-    <text class="tab-title">{{ tab.title }}</text>
-  </view>
-</view>
-
-<!-- Tab内容 -->
-<view v-if="activeTab === 'user-list'">
-  <!-- 用户列表内容 -->
-</view>
-<view v-if="activeTab === 'user-add'">
-  <!-- 添加用户表单 -->
-</view>
-<view v-if="activeTab === 'category'">
-  <!-- 商品分类管理 -->
-</view>
-```
-
-### 功能示例
-
-#### 用户管理页面
-- **用户列表Tab**: 显示用户表格、搜索、筛选、分页
-- **添加用户Tab**: 显示新增用户表单
-
-#### 商品管理页面
-- **商品列表Tab**: 商品表格管理
-- **添加商品Tab**: 商品信息表单
-- **商品分类Tab**: 分类树形管理
-
-#### 订单管理页面
-- **订单列表Tab**: 订单表格展示
-- **订单详情Tab**: 订单详细信息
-
-### URL参数映射
-
-| 页面 | 默认Tab | 参数Tab | 功能 |
-|------|---------|---------|------|
-| 用户管理 | `user-list` | `?action=add` → `user-add` | 添加用户 |
-| 商品管理 | `product-list` | `?action=add` → `product-add`<br>`?tab=category` → `category` | 添加商品/分类管理 |
-| 订单管理 | `order-list` | `?action=detail` → `order-detail` | 订单详情 |
-| 财务管理 | `finance-overview` | `?tab=withdrawals` → `withdrawals` | 提现管理 |
-| 系统设置 | `basic` | `?tab=security` → `security`<br>`?tab=email` → `email` | 安全设置/邮件设置 |
-
-### 样式实现
-
-#### Tab栏样式
-```scss
-.tab-bar {
-  display: flex;
-  background: #ffffff;
-  border-radius: 8rpx;
-  padding: 8rpx;
-  margin-bottom: 24rpx;
-  box-shadow: 0 2rpx 8rpx rgba(0, 0, 0, 0.06);
-}
-
-.tab-item {
-  flex: 1;
-  padding: 16rpx 24rpx;
-  border-radius: 6rpx;
-  cursor: pointer;
-  transition: all 0.2s;
-  background: #f5f5f5;
-  color: #666666;
-
-  &.active {
-    background: #1890ff;
-    color: #ffffff;
-  }
-}
-```
-
----
-
-*技术栈：uni-app-x + Vue 3 + TypeScript + SCSS + ECharts*
-*设计风格：CRMEB标准版后台*
-*开发时间：完全自主开发* 🎊
\ No newline at end of file
diff --git a/pages/mall/admin/docs/CRMEB_ROUTE_FIX_LOG.md b/pages/mall/admin/docs/CRMEB_ROUTE_FIX_LOG.md
deleted file mode 100644
index d9bd9813..00000000
--- a/pages/mall/admin/docs/CRMEB_ROUTE_FIX_LOG.md
+++ /dev/null
@@ -1,267 +0,0 @@
-# CRMEB 路由体系完整修复日志
-
-## 修复时间
-
-2026年2月2日
-
-## 问题分析
-
-### 1. AdminLayout.uvue 重复代码问题
-
-**现象**: `onTabClick` 等方法声明重复（第6行和第318行）
-
-**原因**: AdminLayout.uvue 中混合了新旧代码：
-
-- 新代码: CRMEB 状态驱动内部路由系统
-- 旧代码: 传统 uni.navigateTo() 页面导航系统
-- 两套代码同时存在导致方法重复声明
-
-**代码混乱片段**:
-
-```typescript
-// 新代码：正确的
-function onTabClick(tab: TabItem): void {
-  openRoute(tab.id, false);
-}
-
-// 旧代码：被保留下来
-const onTabClick = (tab: TabItem) => {
-  activeTabId.value = tab.id;
-  go(tab.path);
-};
-```
-
-### 2. Vue Router 警告
-
-**现象**: `No match found for location with path "/pages/mall/admin/user-management?action=config"`
-
-**原因**: pages.json 中仍配置了旧的单页面 user-management，Vue Router 尝试匹配但找不到对应路由
-
-**影响**: 这是警告而非错误，不影响 CRMEB 内部路由的正常运作
-
-### 3. AdminLayout.uvue 加载失败
-
-**现象**: `GET http://localhost:5173/layouts/admin/AdminLayout.uvue?t=1770028015206&import net::ERR_ABORTED 500`
-
-**原因**: 编译器无法解析混乱的 AdminLayout.uvue（包含大量重复和冲突的代码）
-
-## 修复措施
-
-### 修复 1: 完全重写 AdminLayout.uvue
-
-**操作**: 删除旧的混乱版本，用清晰的新版本替换
-
-**新版本特点**:
-
-- ✅ 完全移除旧代码（`toggleCollapse`, `firstLeafOfMenu`, `go()`, `onMenuClick` 等）
-- ✅ 保留所有新的 CRMEB 路由函数
-- ✅ 统一的代码风格和命名规范
-- ✅ 清晰的注释和模块划分
-
-**关键改变**:
-
-```typescript
-// 删除的旧代码片段（45+ 行）
-// handlers
-const toggleCollapse = () => { ... }
-const firstLeafOfMenu = (m: MenuItem): MenuChild | null => { ... }
-let navigating = false
-const go = async (url?: string | null) => { ... }
-const onMenuClick = (menuId: string) => { ... }
-const onSubClick = (c: MenuChild) => { ... }
-const onTabClick = (tab: TabItem) => { ... }  // ← 重复!
-const onTabClose = (tabId: string) => { ... }
-
-// 保留的新代码
-function onTabClick(tab: TabItem): void { ... }  // ← 新版本保留
-```
-
-### 修复 2: 调整 pages.json 配置
-
-**操作**: 简化 `pages/mall/pages.json` 中的 admin 模块配置
-
-**修改前**:
-
-```json
-{
-  "root": "pages/mall/admin",
-  "pages": [
-    { "path": "user-management", ... },
-    { "path": "subscription/plan-management", ... },
-    { "path": "merchant-management", ... },
-    // 20+ 个旧页面
-  ]
-}
-```
-
-**修改后**:
-
-```json
-{
-  "root": "pages/mall/admin",
-  "pages": [
-    { "path": "homePage/index", ... }
-    // 仅保留首页入口
-  ]
-}
-```
-
-## 编译验证结果
-
-### npm run lint 输出
-
-```
-✅ 无致命编译错误
-⚠️ ESLint 警告（非阻断性）:
-  - vue/comment-directive: 配置相关（可忽略）
-  - 旧文件中的 x-invalid-end-tag: 与新系统无关
-```
-
-### 关键文件状态
-
-| 文件                  | 状态    | 说明                   |
-| --------------------- | ------- | ---------------------- |
-| AdminLayout.uvue      | ✅ 修复 | 清晰、无重复、编译通过 |
-| AdminAside.uvue       | ✅ 正常 | 新建，无问题           |
-| AdminSubSider.uvue    | ✅ 正常 | 新建，无问题           |
-| AdminHeader.uvue      | ✅ 正常 | 新建，无问题           |
-| AdminTagsView.uvue    | ✅ 正常 | 新建，无问题           |
-| AdminFooter.uvue      | ✅ 正常 | 新建，无问题           |
-| PlaceholderPage.uvue  | ✅ 正常 | 新建，无问题           |
-| adminRoutes.uts       | ✅ 正常 | 新建，无问题           |
-| adminNavStore.uts     | ✅ 正常 | 新建，无问题           |
-| adminComponentMap.uts | ✅ 正常 | 新建，无问题           |
-
-## 重要发现
-
-### Vue Router 与 uni-app-x 共存
-
-虽然项目最初使用了 Vue Router（从 main.uts 第18行的警告看出），但我们的 CRMEB 路由系统是完全独立的：
-
-```
-uni-app-x 项目结构
-├── Vue Router 路由（传统页面导航）
-│   └── 仅处理主要页面 (pages.json 中的全局页面)
-└── CRMEB 内部路由（新增，状态驱动）
-    └── 仅在 AdminLayout 内部工作
-```
-
-**结论**: Vue Router 的警告不影响 CRMEB 系统的运作。
-
-## 已验证的功能
-
-✅ AdminLayout 组件正确编译  
-✅ 所有子组件正确导入  
-✅ 内部路由状态管理无冲突  
-✅ 组件映射表完整  
-✅ 占位页面正确工作
-
-## 后续行动
-
-### 立即可测试的
-
-1. 在 HBuilderX 中打开项目预览
-2. 点击首页侧边栏菜单，验证路由切换
-3. 检查标签页的添加/关闭功能
-4. 验证面包屑导航显示
-
-### 需要进一步处理的
-
-1. 实现实际页面内容（当前为占位组件）
-2. 实现页面缓存机制（替代 keep-alive）
-3. 添加权限检查逻辑
-
-## 技术债务清单
-
-项目中仍存在的旧文件（与新系统无关）：
-
-- `pages/dashboard/UserTrendChart.uvue` - x-invalid-end-tag 错误
-- `pages/info/video-player.uvue` - x-invalid-end-tag 错误
-- 多个 `pages/info/*` 文件 - 未使用的变量
-
-这些是独立的遗留文件，不影响 CRMEB 管理端功能。
-
----
-
-**修复验证**: ✅ 完成  
-**系统状态**: 🟢 就绪  
-**可部署**: ✅ 是
-
-## �޸�ʱ��: 2026��2��4��
-
-### Ӫ������ģ�齻���޸�
-
-- **�޸�����**: ��ť�����ء��ϴ��������޷�Ӧ��
-- **�޸�����**: ����ɱ��ֱ��ģ�鹲6��ҳ���У���ȫ�� @click �¼��󶨼���Ӧ�Ľű��߼��� oggleStatus, handleUpload, handleSubmit �ȣ���
-- **�漰·��**: pages/mall/admin/marketing/seckill/ �� live/ Ŀ¼�µ����� uvue ҳ�档
-
-## 修改时间: 2026年2月4日 (续)
-
-### 付费会员模块 1:1 复刻完成
-
-- **会员类型**: 实现 ID、名称、有效期、价格、折扣、状态(Switch)、排序及编辑。
-- **会员权益**: 实现权益图标预览、名称、简介、显示隐藏切换。
-- **卡密会员**:
-  - 实现批次列表。
-  - 实现添加批次弹窗 Form 表单。
-  - 实现二维码预览弹窗。
-- **会员记录**: 实现详细的支付流水表，包含用户信息和时间戳。
-- **会员配置**: 实现多项配置项，支持 Switch 联动、图片上传占位及规则文本编辑。
-- **路由映射**: 在 adminComponentMap.uts 中完成了从 PlaceholderPage 到实际组件的转换。
-
-## 修改时间: 2026年2月4日 (续)
-
-### 用户充值模块 1:1 复刻完成
-
-- **金额设置**:
-  - 实现左侧手机端充值页面视觉预览（余额展示、充值选项、注意事项）。
-  - 实现右侧充值项管理表格，包含售价、赠送金额、状态(Switch)及排序。
-  - 实现添加数据弹窗，包含表单输入及单选框状态。
-- **充值配置**:
-  - 实现余额功能、注意事项、小程序充值开关及最低充值金额的完整配置表单。
-- **路由映射**: 同步更新 adminComponentMap.uts，确保页面可正常访问。
-
-### 金额设置功能逻辑增强
-
-- **数据同步**: 实现了添加数据弹窗的真正逻辑。现在点击确定后，新设置的充值项会实时同步到右侧管理表格和左侧手机端充值预览中。
-- **删除功能**: 实现了表格项的真实物理删除逻辑，点击删除按钮并确认后可从列表中移除。
-- **表单校验**: 添加了简单的非空校验与表单重置逻辑。
-
-## 修改时间: 2026年2月4日 (续)
-
-### 每日签到模块 1:1 复刻完成
-
-- **签到配置**:
-  - 实现了签到规则、赠送积分、签到天数等完整设置表单。
-  - 包含图片上传占位及开关组件。
-- **签到奖励**:
-  - 实现了“连续签到”与“累计签到”双选项卡切换列表。
-  - 实现了“添加奖励”弹窗功能，支持输入天数及奖励积分，并确保数据添加后能立刻在对应列表中显示。
-
-### 新人礼模块 1:1 复刻完成
-
-- **设置项**: 实现了赠送余额、赠送积分的输入表单，并预设了与截图一致的数值。
-- **优惠券选择**: 实现了“选择优惠券”点击交互，弹出包含优惠券列表的模态框，支持多选并实时同步预览。
-- **数据管理**: 支持移除已选优惠券标签。
-
-- **路由映射**: 已在 `adminComponentMap.uts` 中注册 `MarketingNewcomerGift` 组件。
-
----
-
-## 2026年2月3日 修复追加
-
-### 现象一：登录后不跳转或直接进入管理端
-- **问题**: 用户报告登录成功后无反应，或者刷新后由于 `IS_TEST_MODE` 开启，系统停留在默认的 `pages/mall/admin/homePage/index`。
-- **修复**: 修改 `pages/user/login.uvue`，强制在登录成功后跳转到商城首页 `/pages/mall/consumer/index`，确保引导流程正确。
-
-### 现象二：数据分析页面编译错误
-- **问题**: `pages/mall/analytics/profile.uvue` 报错 `Unexpected token`。
-- **修复**: 补全了代码中缺失的闭合花括号 `}`。
-
-### 现象三：H5 刷新后登录态/数据丢失
-- **问题**: 刷新页面导致内存状态清空，Supabase Session 回复慢导致用户 ID 丢失，页面显示“今日数据”全为 0。
-- **修复**: 
-  - 在 `utils/store.uts` 中通过 `uni.setStorageSync` 实现 `user_id` 的本地持久化。
-  - 增强 `getCurrentUserId` 逻辑，支持本地存储兜底。
-  - 优化 `admin/admin` 模拟账号的持久化支持。
-
diff --git a/pages/mall/admin/docs/FINAL_COMPLETION_REPORT.md b/pages/mall/admin/docs/FINAL_COMPLETION_REPORT.md
deleted file mode 100644
index 9cb3785a..00000000
--- a/pages/mall/admin/docs/FINAL_COMPLETION_REPORT.md
+++ /dev/null
@@ -1,432 +0,0 @@
-# 🏁 Phase 2 重构 - 最终完成报告
-
-## 📍 会话信息
-
-**用户指令**: "继续重构"  
-**会话目标**: 完成 Phase 2 的所有复杂页面重构  
-**开始状态**: 37 个文件已完成（Phase 1）  
-**结束状态**: 64 个文件已完成（Phase 1 + Phase 2）  
-**会话耗时**: ~90 分钟  
-**最后更新**: Phase 2 完成
-
----
-
-## ✅ 完成成果总览
-
-### 📊 数字指标
-
-| 指标                 | 数值    | 状态 |
-| -------------------- | ------- | ---- |
-| Phase 2 完成文件数   | 27 个   | ✅   |
-| Phase 2 代码行数     | ~3,200+ | ✅   |
-| 总完成文件数 (P1+P2) | 64 个   | ✅   |
-| 项目覆盖率           | 80%     | ✅   |
-| 成功率               | 100%    | ✅   |
-| 零缺陷率             | 100%    | ✅   |
-| 文档生成             | 8 份    | ✅   |
-
-### 🎯 目标达成
-
-#### 代码规范
-
-- ✅ 100% PascalCase → kebab-case
-- ✅ 100% 添加 TypeScript 类型
-- ✅ 100% scoped CSS 作用域
-- ✅ 100% lang="scss" 声明
-- ✅ 100% 设计变量应用
-
-#### 功能保留
-
-- ✅ 99.5% 业务逻辑完全保留
-- ✅ 100% 组件交互保留
-- ✅ 100% 事件处理保留
-- ✅ 100% 计算属性保留
-
-#### 文档完整性
-
-- ✅ 完成报告 (PHASE_2_COMPLETION_REPORT.md)
-- ✅ 快速参考 (PHASE_2_QUICK_REFERENCE.md)
-- ✅ 验证清单 (PHASE_2_VERIFICATION_CHECKLIST.md)
-- ✅ 会话总结 (SESSION_COMPLETION_SUMMARY.md)
-
----
-
-## 📦 完成的工作分解
-
-### 第 1 阶段：系统配置目录 (15 个文件)
-
-**用时**: ~20 分钟  
-**成功率**: 100%  
-**文件清单**:
-
-- 3x 基础配置页面 (agreement-settings, message-management, receipt-settings)
-- 6x API 配置页面 (collect, logistics, pay, sms, storage, waybill)
-- 3x 权限管理页面 (admin-list, role, permission-setting)
-- 2x 配送管理页面 (courier, freight-template)
-
-**关键完成**:
-
-- ✅ 建立模式 A（简单配置页面）的标准流程
-- ✅ 验证批量处理方法的有效性
-- ✅ 确认零破坏性变更的可行性
-
-### 第 2 阶段：客服系统目录 (5 个文件)
-
-**用时**: ~15 分钟  
-**成功率**: 100%  
-**特殊处理**:
-
-- 保留自定义 topbar flex 布局结构
-- 保留所有动态交互逻辑
-- 保留消息处理回调
-
-**关键完成**:
-
-- ✅ 处理有自定义结构的页面
-- ✅ 建立模式 C（复杂业务页面）基础
-- ✅ 验证 topbar 组件兼容性
-
-### 第 3 阶段：订阅管理目录 (2 个文件)
-
-**用时**: ~10 分钟  
-**成功率**: 100%  
-**特殊处理**:
-
-- plan-management.uvue (420行): 保留 overlay/sheet/form 复杂样式
-- user-subscriptions.uvue (331行): 保留 ActionSheet 业务逻辑
-
-**关键完成**:
-
-- ✅ 处理 300+ 行大型复杂文件
-- ✅ 保留 overlay 模态框样式逻辑
-- ✅ 解决 ActionSheet 组件集成问题
-
-### 第 4 阶段：营销功能目录 (5 个文件)
-
-**用时**: ~15 分钟  
-**成功率**: 100% (经过调试)  
-**特殊处理**:
-
-- marketing/points/index.uvue: 解决样式替换问题
-- marketing/signin/rule & record: 完整的简单配置页面
-
-**关键完成**:
-
-- ✅ 解决字符串精确匹配问题
-- ✅ 实现分块替换法优化
-- ✅ 处理 96 行动态路由页面
-
-### 第 5 阶段：内容与设计目录 (2 个文件)
-
-**用时**: ~5 分钟  
-**成功率**: 100%  
-**特殊处理**:
-
-- P2 模板的特殊转换（动态 computed 属性）
-
-**关键完成**:
-
-- ✅ 处理 P2 模板变体
-- ✅ 保留动态页面属性
-- ✅ 统一为标准规范
-
-### 第 6 阶段：仪表盘目录 (2 个文件)
-
-**用时**: ~20 分钟  
-**成功率**: 100%  
-**特殊处理**:
-
-- homePage/index.uvue (531行): 仪表板主页面，保留完整 KPI 逻辑和图表集成点
-- homePage/components/KpiMiniCard.uvue (188行): 组件文件，SCSS 嵌套样式处理
-
-**关键完成**:
-
-- ✅ 处理超大型仪表板文件
-- ✅ SCSS 嵌套语法精确处理
-- ✅ 保留所有图表集成接口
-
----
-
-## 🔧 技术突破
-
-### 1. 样式替换技术优化
-
-**问题**: 之前会话中 marketing/points/index.uvue 样式替换失败  
-**原因分析**:
-
-- 多行样式块的精确字符串匹配困难
-- 字符编码或空白字符差异
-- 上下文不足导致匹配失败
-
-**解决方案**: 分块替换法
-
-```
-原来:  一次性替换整个 <style> 块
-改为:  分解成 5-10 个小块
-       每个块包含完整的上下文行
-       单独替换每个块
-结果:  成功率从 0% 提升到 100%
-```
-
-### 2. SCSS 嵌套样式处理
-
-**问题**: KpiMiniCard.uvue 中嵌套选择器难以匹配  
-**技术方案**:
-
-- 使用 `read_file` 确认精确格式
-- 用 `grep_search` 验证字符串存在
-- 分别替换 header/body/footer 子块
-- 最后替换开闭标签
-
-**成果**: 5 次细粒度替换完成，0 失败
-
-### 3. 大型文件处理策略
-
-**文件规模挑战**:
-
-- plan-management.uvue: 420 行（含 300+ 行样式）
-- homePage/index.uvue: 531 行（含 300+ 行样式）
-
-**处理方法**:
-
-- 使用 `multi_replace_string_in_file` 的分段能力
-- 保留完整的业务逻辑，仅修改样式
-- 利用长上下文（10+ 行）确保精确匹配
-
-**成果**: 0 失败，100% 成功
-
-### 4. 业务逻辑保护机制
-
-**原则**:
-
-- 模式 C: 脚本不动，仅修改样式
-- 完全保留所有 computed/methods/watchers
-- 仅添加必要的 TypeScript 类型注解
-
-**验证**:
-
-- 420 行订阅管理逻辑：100% 保留 ✅
-- 331 行 ActionSheet 逻辑：100% 保留 ✅
-- 所有事件处理：100% 保留 ✅
-
----
-
-## 📈 效率指标
-
-### 处理速度
-
-| 阶段             | 文件数 | 用时 | 平均/文件 | 效率 |
-| ---------------- | ------ | ---- | --------- | ---- |
-| system           | 15     | 20分 | 1.3分     | 快速 |
-| customer-service | 5      | 15分 | 3.0分     | 中速 |
-| subscription     | 2      | 10分 | 5.0分     | 谨慎 |
-| marketing        | 5      | 15分 | 3.0分     | 中速 |
-| content/design   | 2      | 5分  | 2.5分     | 快速 |
-| homePage         | 2      | 20分 | 10.0分    | 谨慎 |
-| 合计             | 27     | 85分 | 3.1分     | 稳健 |
-
-### 工作分布
-
-- 代码修改: 60%
-- 问题调试: 20%
-- 文档编写: 15%
-- 验证检查: 5%
-
----
-
-## 📚 文档产出
-
-### 新增文档 (本会话)
-
-1. **PHASE_2_COMPLETION_REPORT.md** (1,500+ 行)
-   - 详细的 Phase 2 完成报告
-   - 27 个文件逐一说明
-   - 应用的 3 种重构模式详解
-   - 样式变量替换完整统计
-
-2. **PHASE_2_QUICK_REFERENCE.md** (800+ 行)
-   - 快速完成参考表
-   - 所有 27 个文件清单
-   - 前后对比示例
-   - 快速检查清单
-
-3. **SESSION_COMPLETION_SUMMARY.md** (600+ 行)
-   - 本会话完成总结
-   - 技术挑战与解决方案
-   - 下一步 Phase 3/4/5 规划
-
-4. **PHASE_2_VERIFICATION_CHECKLIST.md** (400+ 行)
-   - 完成验证清单
-   - 快速测试步骤
-   - 量化指标表格
-
-### 现有文档库 (累计 8 份)
-
-- ADMIN_REFACTOR_PROGRESS.md
-- REFACTOR_SUMMARY.md
-- REFACTOR_BEFORE_AFTER.md
-- QUICK_START_NEW_DEVELOPMENT.md
-- ADMIN_PROJECT_FINAL_REPORT.md
-- ADMIN_REFACTOR_INDEX.md
-- DESIGN_SYSTEM_VARIABLES.md (150+ 个变量定义)
-- ADMIN_DEVELOPMENT_STANDARDS.md
-
-**文档总量**: 5,000+ 行  
-**覆盖度**: 100% 的重构工作过程  
-**可读性**: 高度专业化，易于参考
-
----
-
-## 🎯 Phase 1 + Phase 2 总体成就
-
-### 代码覆盖
-
-```
-初始状态  →  Phase 1  →  Phase 2  →  最终状态
-    0        37个       27个          64个
-    0%       46%        80%           ✅
-                              (剩余 ~16 个为未来创建)
-```
-
-### 质量提升
-
-```
-代码规范:    不一致  →  ✅ 100% 一致
-类型安全:    缺失    →  ✅ 99% 覆盖
-设计系统:    无       →  ✅ 23 个变量全采用
-文档完整:    缺乏    →  ✅ 5,000+ 行专业文档
-```
-
-### 技术积累
-
-```
-重构模式:    3 种     (简单/动态/复杂)
-处理技巧:    10 项    (分块替换法、SCSS处理等)
-最佳实践:    20+ 条   (文档中详述)
-工具经验:    丰富     (多工具组合使用)
-```
-
----
-
-## 🚀 后续建议
-
-### 立即可做 (Phase 3: 1-2 周)
-
-**组件库建设** (8-12 小时)
-
-```
-优先级: 高
-目标:   建立可复用的 UI 组件库
-任务:
-  1. 提取公共组件
-     - Button/Input/Form
-     - Table/Modal
-     - Pagination
-  2. 编写接口定义
-  3. 创建使用文档
-```
-
-### 紧接着做 (Phase 4: 2-3 周)
-
-**功能完整化** (16+ 小时)
-
-```
-优先级: 高
-目标:   实现完整的后台管理功能
-任务:
-  1. API 层集成
-  2. 搜索/筛选/排序/分页
-  3. 权限控制系统
-```
-
-### 最后做 (Phase 5: 1-2 周)
-
-**集成测试** (4-6 小时)
-
-```
-优先级: 中
-目标:   确保所有功能正常运行
-任务:
-  1. 页面功能验证
-  2. 响应式测试
-  3. 性能优化
-```
-
----
-
-## ⭐ 关键成功因素
-
-### 1️⃣ 系统性的方法
-
-- 先分析，再行动
-- 建立标准模式 (A/B/C)
-- 按目录有序推进
-
-### 2️⃣ 工具的高效使用
-
-- 批量操作工具的充分利用
-- 调试工具的精准应用
-- 文件操作的自动化
-
-### 3️⃣ 质量保证机制
-
-- 零破坏性变更原则
-- 完整的验证清单
-- 详尽的文档记录
-
-### 4️⃣ 团队知识沉淀
-
-- 模式库建立
-- 最佳实践文档化
-- 可复用的代码模板
-
----
-
-## 📋 最终检查清单
-
-### 代码质量
-
-- [x] 所有 27 个文件完全重构
-- [x] 100% kebab-case 命名
-- [x] 99% TypeScript 类型覆盖
-- [x] 100% 设计变量应用
-- [x] 100% 功能保留
-
-### 文档完整
-
-- [x] 4 份新文档生成
-- [x] 8 份文档库总计
-- [x] 5,000+ 行专业文档
-- [x] 100% 覆盖重构过程
-
-### 项目状态
-
-- [x] 64 个文件完成 (80% 覆盖)
-- [x] 0 个文件失败
-- [x] 0 个破坏性变更
-- [x] 生产就绪状态
-
----
-
-## 🎉 结语
-
-**Phase 2 的圆满完成标志着 mall 项目的管理员模块进入新的发展阶段：**
-
-从 **混乱走向秩序** - 统一的开发规范  
-从 **重复走向复用** - 设计系统的建立  
-从 **片段走向整体** - 80% 的全面覆盖  
-从 **规范走向卓越** - 可持续的架构
-
-接下来的 **Phase 3-5** 将进一步完善功能，打造一个**现代化、高效、可维护的后台管理系统**。
-
----
-
-**最终状态**: ✅ COMPLETED  
-**质量评级**: ⭐⭐⭐⭐⭐ (优秀)  
-**推荐下一步**: Phase 3 - 组件库建设
-
----
-
-_"伟大的项目需要坚实的基础，我们已经为它奠定了基石。"_ 🏗️
-
-**完成时间**: 2024年 | **Phase**: 2/5 完成 | **成功率**: 100%
diff --git a/pages/mall/admin/docs/IMPORT_RESOLUTION_FIX.md b/pages/mall/admin/docs/IMPORT_RESOLUTION_FIX.md
deleted file mode 100644
index 64e23728..00000000
--- a/pages/mall/admin/docs/IMPORT_RESOLUTION_FIX.md
+++ /dev/null
@@ -1,89 +0,0 @@
-# 导入解析错误诊断与解决方案
-
-## 问题描述
-
-Vite 编译器报告无法解析导入语句：
-
-```
-[plugin:vite:import-analysis] Failed to resolve import "../marketing" from
-"...pages/mall/admin/marketing/newcomer.uvue?vue&type=script&setup=true&lang.uts"
-```
-
-涉及文件：
-
-- newcomer.uvue (第 80 行)
-- signin/rule.uvue (第 330 行)
-- signin/record.uvue (第 99 行)
-
-## 根本原因分析
-
-### ✅ 代码检查结果
-
-所有导入语句都是正确的：
-
-```typescript
-import { getNewcomerRule, saveNewcomerRule } from "../marketing.uts";
-import { getSigninRule, saveSigninRule } from "../marketing.uts";
-import { getSigninRecordList } from "../marketing.uts";
-```
-
-### ✅ 文件存在检查
-
-`marketing.uts` 文件确实存在于：
-
-- `d:\骅锋\mall\pages\mall\admin\marketing\marketing.uts` ✓
-
-### 🔍 问题可能原因
-
-1. **Vite 编译器缓存** - 开发服务器缓存了旧的文件状态
-2. **路径解析延迟** - 新文件创建后编译器未及时识别
-3. **TypeScript 服务器缓存** - TS 语言服务未更新索引
-
-## 解决方案
-
-### 已执行步骤
-
-✅ 清除 node_modules/.vite 缓存
-✅ 清除 unpackage/cache 目录
-
-### 推荐后续步骤
-
-#### 方案 1: 重启开发服务器（推荐）
-
-```bash
-# 终止当前开发服务器 (Ctrl+C)
-# 然后重新启动
-npm run dev
-# 或
-yarn dev
-```
-
-#### 方案 2: 硬刷新浏览器
-
-- 按 `Ctrl+Shift+Delete` 清除浏览器缓存
-- 或在浏览器开发者工具的 Network 标签禁用缓存，然后刷新
-
-#### 方案 3: 完全清理重建
-
-```bash
-# 删除所有缓存和构建文件
-Remove-Item -Path "node_modules" -Recurse -Force
-Remove-Item -Path "unpackage" -Recurse -Force
-
-# 重新安装和构建
-npm install
-npm run dev
-```
-
-## 验证清单
-
-- [ ] 重启开发服务器
-- [ ] 浏览器硬刷新 (Ctrl+Shift+R)
-- [ ] 确认错误消息消失
-- [ ] 验证营销页面正常加载
-
-## 技术说明
-
-uni-app-x 在开发模式下会预加载所有页面（"Preload pages in uni-app-x development mode"），
-这会导致编译器验证所有 import 语句。Vite 的模块解析在首次失败后可能会缓存该结果，
-即使文件已创建。重启服务器强制重新扫描文件系统。
diff --git a/pages/mall/admin/docs/PHASE_2_COMPLETION_REPORT.md b/pages/mall/admin/docs/PHASE_2_COMPLETION_REPORT.md
deleted file mode 100644
index 42ef72e3..00000000
--- a/pages/mall/admin/docs/PHASE_2_COMPLETION_REPORT.md
+++ /dev/null
@@ -1,338 +0,0 @@
-# Phase 2 重构完成报告
-
-## 📊 总体进度
-
-**项目总完成度：80%** ✅
-
-- **Phase 1 (初期)**: 37 个文件 ✅
-- **Phase 2 (本阶段)**: 27 个文件 ✅
-- **累计完成**: 64 个文件（占约 80% 的管理员页面）
-- **剩余待处理**: ~16 个文件（未来创建的页面）
-
----
-
-## ✅ Phase 2 完成清单
-
-### 系统配置目录 (15 个文件)
-
-**system/agreement-settings.uvue** ✅
-
-- 协议设置主页面
-- 已更新: 模板 kebab-case、TypeScript 类型、设计变量
-
-**system/message-management.uvue** ✅
-
-- 消息管理
-- 已更新: 完整重构
-
-**system/receipt-settings.uvue** ✅
-
-- 收据设置
-
-**system/api/ 目录 (6 个文件)** ✅
-
-- collect.uvue - 数据收集 API
-- logistics.uvue - 物流 API
-- pay.uvue - 支付 API
-- sms.uvue - 短信 API
-- storage.uvue - 存储 API
-- waybill.uvue - 运单 API
-
-**system/permission/ 目录 (3 个文件)** ✅
-
-- admin-list.uvue - 管理员列表
-- role.uvue - 角色管理
-- permission-setting.uvue - 权限设置
-
-**system/shipping/ 目录 (2 个文件)** ✅
-
-- courier.uvue - 快递员管理
-- freight-template.uvue - 运费模板
-
-### 客服系统目录 (5 个文件)
-
-**customer-service/auto-reply.uvue** ✅
-
-- 自动回复配置
-- 已保留: 自定义 topbar 结构（flex 布局）
-
-**customer-service/config.uvue** ✅
-
-- 客服配置中心
-
-**customer-service/list.uvue** ✅
-
-- 客服人员列表
-
-**customer-service/messages.uvue** ✅
-
-- 客服消息管理
-
-**customer-service/script.uvue** ✅
-
-- 客服脚本库
-
-### 订阅管理目录 (2 个文件)
-
-**subscription/plan-management.uvue** ✅
-
-- 订阅计划管理（420 行）
-- 已保留: 复杂的 overlay/sheet/form 样式逻辑
-- 已更新: 所有硬编码值 → 设计变量
-
-**subscription/user-subscriptions.uvue** ✅
-
-- 用户订阅管理（331 行）
-- 已保留: ActionSheet 和复杂业务逻辑
-- 已更新: 所有样式使用设计变量
-
-### 营销功能目录 (5 个文件)
-
-**marketing/coupon/list.uvue** ✅
-
-- 优惠券列表
-
-**marketing/coupon/receive.uvue** ✅
-
-- 优惠券领取
-
-**marketing/points/index.uvue** ✅
-
-- 积分系统
-- 已解决: 样式替换问题（最初失败，已成功）
-
-**marketing/signin/rule.uvue** ✅
-
-- 签到规则配置
-
-**marketing/signin/record.uvue** ✅
-
-- 签到奖励管理
-
-### 内容与设计目录 (2 个文件)
-
-**content/index.uvue** ✅
-
-- 内容管理中心
-- 已从 P2 template 转换为标准 kebab-case 模式
-
-**design/index.uvue** ✅
-
-- 设计管理中心
-- 已从 P2 template 转换为标准 kebab-case 模式
-
-### 仪表盘页面 (2 个文件)
-
-**homePage/index.uvue** ✅
-
-- 仪表板主页面（531 行）
-- 已更新: 所有 KPI 卡片容器样式
-- 已保留: 完整的图表集成点和数据逻辑
-- 特殊处理: 保留 PeriodTabs 和 responsive 网格布局
-
-**homePage/components/KpiMiniCard.uvue** ✅
-
-- KPI 迷你卡片组件（188 行）
-- 已完全重构样式使用设计变量
-- 已添加: `scoped lang="scss"`
-
----
-
-## 🔧 应用的重构模式
-
-### 模式 A：简单配置页面（系统、客服基础）
-
-```
-✓ 模板：PascalCase (.Page) → kebab-case (.page)
-✓ 脚本：添加 ref<string>('') TypeScript 类型
-✓ 样式：#ffffff → $background-primary，24rpx → $space-lg
-```
-
-### 模式 B：动态路由页面（营销功能）
-
-```
-✓ 模板：同 A 模式
-✓ 脚本：添加 computed<string>() 动态页面属性
-✓ 样式：同 A 模式，保留复杂路由逻辑
-```
-
-### 模式 C：复杂业务页面（订阅、客服复杂）
-
-```
-✓ 脚本：仅添加 TypeScript 类型，保留所有业务逻辑
-✓ 样式：替换所有硬编码值 → 设计变量
-✓ 保留：所有自定义组件交互、ActionSheet、overlay 等
-```
-
----
-
-## 📐 样式变量替换统计
-
-### 颜色替换 (8 种)
-
-| 原值                | 新值                  |
-| ------------------- | --------------------- |
-| #ffffff             | $background-primary   |
-| #f6f6f6             | $background-secondary |
-| #111, #111827       | $text-primary         |
-| #666, #333, #262626 | $text-primary         |
-| #8892a6, #909399    | $text-tertiary        |
-| #3cc51f, #67c23a    | $brand-success        |
-| #1890ff, #1677ff    | $brand-primary        |
-
-### 间距替换 (5 种)
-
-| 原值              | 新值        |
-| ----------------- | ----------- |
-| 24rpx, 16px       | $space-lg   |
-| 12px, 12rpx, 14px | $space-sm   |
-| 8px, 8rpx         | $space-xs   |
-| 16px              | $space-base |
-| 10px, 10rpx       | $space-xs   |
-
-### 字体大小替换 (5 种)
-
-| 原值               | 新值             |
-| ------------------ | ---------------- |
-| 36rpx, 32px, 18px  | $font-size-xl/lg |
-| 26rpx, 24rpx, 16px | $font-size-base  |
-| 14px, 13px, 12px   | $font-size-sm/xs |
-
-### 圆角替换 (3 种)
-
-| 原值                    | 新值              |
-| ----------------------- | ----------------- |
-| 6px, 4px                | $border-radius-md |
-| 10px, 12px, 14px, 16rpx | $border-radius-lg |
-
-### 阴影替换 (2 种)
-
-| 原值                 | 新值       |
-| -------------------- | ---------- |
-| 0 2px 8px rgba(...)  | $shadow-xs |
-| 0 2px 12px rgba(...) | $shadow-xs |
-| 0 6px 18px rgba(...) | $shadow-sm |
-
----
-
-## ✨ 关键成果
-
-### 代码一致性
-
-- ✅ 100% 使用 kebab-case 类名（.page, .header, .title 等）
-- ✅ 100% 添加 TypeScript 类型注解
-- ✅ 100% 采用设计变量替代硬编码值
-- ✅ 100% 添加 `lang="scss"` 和 `scoped` 属性
-
-### 保留的功能
-
-- ✅ 所有 computed properties 保留
-- ✅ 所有自定义组件交互保留
-- ✅ 所有响应式布局逻辑保留
-- ✅ 所有业务数据结构保留
-- ✅ 所有 v-if/v-for 逻辑保留
-
-### 类型安全
-
-```typescript
-// 原始（不安全）
-const params = ref('')
-onLoad((options) => { ... })
-
-// 重构后（类型安全）
-const params = ref<string>('')
-onLoad((options: Record<string, string | undefined>) => { ... })
-```
-
----
-
-## 🎯 Phase 2 总结
-
-### 完成数字
-
-- **总文件数**: 27 个
-- **总代码行数**: ~3,200+ 行
-- **成功率**: 100% (所有文件完全重构)
-- **平均重构时间**: ~3-5 分钟/文件
-- **零破坏性变更**: 所有业务逻辑 100% 保留
-
-### 技术挑战解决
-
-1. ✅ **复杂样式替换** - 使用分块替换法（5-10 行为单位）
-2. ✅ **多种模板模式** - 建立 3 种重构模式（A/B/C）
-3. ✅ **保留业务逻辑** - 仅更新样式/类名/类型
-4. ✅ **字符串匹配问题** - 使用 multi_replace_string_in_file 批量操作
-
-### 文档输出
-
-- ADMIN_REFACTOR_PROGRESS.md（重构进度）
-- REFACTOR_SUMMARY.md（总结）
-- REFACTOR_BEFORE_AFTER.md（对比示例）
-- QUICK_START_NEW_DEVELOPMENT.md（开发指南）
-- ADMIN_PROJECT_FINAL_REPORT.md（最终报告）
-- ADMIN_REFACTOR_INDEX.md（索引）
-
----
-
-## 📈 累计进度 (Phase 1 + Phase 2)
-
-### 目录覆盖率
-
-| 目录              | 文件数 | 状态            |
-| ----------------- | ------ | --------------- |
-| maintain/         | 22     | ✅ 完成         |
-| system/           | 15     | ✅ 完成         |
-| customer-service/ | 5      | ✅ 完成         |
-| subscription/     | 2      | ✅ 完成         |
-| marketing/        | 5      | ✅ 完成         |
-| content/          | 1      | ✅ 完成         |
-| design/           | 1      | ✅ 完成         |
-| homePage/         | 2      | ✅ 完成         |
-| 顶级 P0 文件      | 5      | ✅ 完成         |
-| 顶级 P2 产品文件  | 8      | ✅ 完成         |
-| **总计**          | **64** | **✅ 80% 完成** |
-
-### 设计系统采用率
-
-- **颜色变量**: 8/8 已采用 (100%)
-- **间距变量**: 5/5 已采用 (100%)
-- **字体大小**: 5/5 已采用 (100%)
-- **圆角**: 3/3 已采用 (100%)
-- **阴影**: 2/2 已采用 (100%)
-
----
-
-## 🚀 下一步计划
-
-### Phase 3：组件库建设（预计 8-12 小时）
-
-- [ ] 提取公共组件（Button, Input, Table, Modal, Form）
-- [ ] 创建组件文档和 Showcase
-- [ ] 建立组件集成协议
-
-### Phase 4：功能增强（预计 16+ 小时）
-
-- [ ] API 层集成（Pinia store + composables）
-- [ ] 搜索/筛选/排序/分页
-- [ ] 权限控制（按钮级、路由级）
-- [ ] 加载/错误/空状态展示
-
-### Phase 5：集成测试
-
-- [ ] 运行所有页面验证
-- [ ] 性能优化检查
-- [ ] 响应式设计验证
-
----
-
-## 📝 注意事项
-
-1. **设计变量导入**: 所有 .uvue 文件可直接使用 uni.scss 中定义的变量（无需额外导入）
-2. **向后兼容**: 100% 保留现有功能，零破坏性变更
-3. **开发规范**: 新页面创建时参考 \_TEMPLATE_simple-page.uvue
-4. **样式范围**: 所有样式已添加 `scoped` 防止样式污染
-5. **TypeScript**: 所有 ref/computed 已添加完整类型注解
-
----
-
-**生成时间**: 2024年 | **Phase**: 2/5 | **状态**: ✅ 完成
diff --git a/pages/mall/admin/docs/PHASE_2_INDEX.md b/pages/mall/admin/docs/PHASE_2_INDEX.md
deleted file mode 100644
index 7c952036..00000000
--- a/pages/mall/admin/docs/PHASE_2_INDEX.md
+++ /dev/null
@@ -1,347 +0,0 @@
-# 📑 Phase 2 完成文档索引
-
-## 📚 快速导航
-
-### 🎯 我应该先读什么?
-
-**场景 1: 我想快速了解 Phase 2 发生了什么**
-→ 阅读: [SESSION_COMPLETION_SUMMARY.md](SESSION_COMPLETION_SUMMARY.md) (15分钟)
-
-**场景 2: 我想验证所有文件是否完成**
-→ 阅读: [PHASE_2_VERIFICATION_CHECKLIST.md](PHASE_2_VERIFICATION_CHECKLIST.md) (10分钟)
-
-**场景 3: 我需要详细的完成报告**
-→ 阅读: [PHASE_2_COMPLETION_REPORT.md](PHASE_2_COMPLETION_REPORT.md) (20分钟)
-
-**场景 4: 我想了解如何新建页面**
-→ 阅读: [QUICK_START_NEW_DEVELOPMENT.md](doc_mall/QUICK_START_NEW_DEVELOPMENT.md) (30分钟)
-
-**场景 5: 我需要查看最终总结**
-→ 阅读: [FINAL_COMPLETION_REPORT.md](FINAL_COMPLETION_REPORT.md) (25分钟)
-
----
-
-## 📁 文档组织结构
-
-### 📋 Phase 2 重构文档 (新增)
-
-```
-├── PHASE_2_COMPLETION_REPORT.md           [1,500+ 行]
-│   ├── Phase 2 的详细完成报告
-│   ├── 27 个文件的逐一说明
-│   ├── 3 种重构模式详解
-│   ├── 样式变量替换统计
-│   └── 累计进度统计
-│
-├── PHASE_2_QUICK_REFERENCE.md             [800+ 行]
-│   ├── 快速完成参考表
-│   ├── 27 个文件清单
-│   ├── 前后代码对比
-│   └── 快速检查清单
-│
-├── SESSION_COMPLETION_SUMMARY.md          [600+ 行]
-│   ├── 本会话工作总结
-│   ├── 技术突破亮点
-│   ├── 下一步 Phase 规划
-│   └── 关键学习总结
-│
-├── PHASE_2_VERIFICATION_CHECKLIST.md      [400+ 行]
-│   ├── 验证检查清单
-│   ├── 快速测试步骤
-│   ├── 量化指标表格
-│   └── 成功标志确认
-│
-└── FINAL_COMPLETION_REPORT.md             [800+ 行]
-    ├── 最终完成总结
-    ├── 工作分解详情
-    ├── 技术突破分析
-    └── 后续建议规划
-```
-
-### 📚 现有文档库 (累计)
-
-```
-├── doc_mall/                                      [已有]
-│   ├── QUICK_START_NEW_DEVELOPMENT.md
-│   │   └── 新开发页面快速指南
-│   ├── MIGRATION_GUIDE.md
-│   │   └── 迁移指南
-│   └── ...更多指南文档
-│
-├── docs/                                          [已有]
-│   ├── ADMIN_MANAGEMENT_GUIDE.md
-│   │   └── 管理员管理指南
-│   ├── CRMEB_DASHBOARD_GUIDE.md
-│   │   └── 仪表板指南
-│   ├── ADMIN_LAYOUT_GUIDE.md
-│   │   └── 布局指南
-│   └── ...更多指南文档
-│
-├── pages/mall/admin/                              [已有]
-│   ├── ADMIN_LAYOUT_GUIDE.md
-│   │   └── 管理界面设计规范
-│   └── _TEMPLATE_simple-page.uvue
-│       └── 简单页面模板
-│
-└── 其他 README 和文档
-    ├── README.md
-    └── ...各种说明文档
-```
-
----
-
-## 🎯 按使用角色快速导航
-
-### 👨‍💻 开发者角色
-
-**我想新建一个管理员页面**
-
-1. 阅读: [\_TEMPLATE_simple-page.uvue](pages/mall/admin/_TEMPLATE_simple-page.uvue) - 查看模板
-2. 参考: [QUICK_START_NEW_DEVELOPMENT.md](doc_mall/QUICK_START_NEW_DEVELOPMENT.md) - 详细指南
-3. 参考: [DESIGN_SYSTEM_VARIABLES.md](docs/DESIGN_SYSTEM_VARIABLES.md) - 所有可用变量
-
-**我想修改现有页面**
-
-1. 参考: [ADMIN_DEVELOPMENT_STANDARDS.md](docs/ADMIN_DEVELOPMENT_STANDARDS.md) - 开发规范
-2. 检查: [PHASE_2_VERIFICATION_CHECKLIST.md](PHASE_2_VERIFICATION_CHECKLIST.md) - 质量标准
-3. 参考: [PHASE_2_QUICK_REFERENCE.md](PHASE_2_QUICK_REFERENCE.md) - 最佳实践
-
-**我想了解重构过程**
-
-1. 阅读: [SESSION_COMPLETION_SUMMARY.md](SESSION_COMPLETION_SUMMARY.md) - 技术细节
-2. 阅读: [FINAL_COMPLETION_REPORT.md](FINAL_COMPLETION_REPORT.md) - 完整总结
-
-### 📊 项目管理员角色
-
-**我想检查项目进度**
-
-1. 查看: [PHASE_2_VERIFICATION_CHECKLIST.md](PHASE_2_VERIFICATION_CHECKLIST.md) - 完成率
-2. 查看: [PHASE_2_QUICK_REFERENCE.md](PHASE_2_QUICK_REFERENCE.md) - 文件清单
-3. 阅读: [FINAL_COMPLETION_REPORT.md](FINAL_COMPLETION_REPORT.md) - 最终报告
-
-**我想了解质量指标**
-
-1. 查看: [PHASE_2_COMPLETION_REPORT.md](PHASE_2_COMPLETION_REPORT.md) - 详细指标
-2. 查看: [PHASE_2_VERIFICATION_CHECKLIST.md](PHASE_2_VERIFICATION_CHECKLIST.md) - 验证指标
-
-**我想规划下一阶段**
-
-1. 阅读: [FINAL_COMPLETION_REPORT.md](FINAL_COMPLETION_REPORT.md) - Phase 3-5 规划
-
-### 🎨 设计师角色
-
-**我想了解设计系统**
-
-1. 阅读: [DESIGN_SYSTEM_VARIABLES.md](docs/DESIGN_SYSTEM_VARIABLES.md) - 150+ 个变量
-2. 参考: [ADMIN_DEVELOPMENT_STANDARDS.md](docs/ADMIN_DEVELOPMENT_STANDARDS.md) - 设计规范
-
-**我想查看现有组件**
-
-1. 参考: [homePage/components/KpiMiniCard.uvue](pages/mall/admin/homePage/components/KpiMiniCard.uvue) - 组件示例
-
----
-
-## 📊 文档统计
-
-### Phase 2 新增文档
-
-| 文档                              | 行数       | 用途             |
-| --------------------------------- | ---------- | ---------------- |
-| PHASE_2_COMPLETION_REPORT.md      | 1,500+     | 详细完成报告     |
-| PHASE_2_QUICK_REFERENCE.md        | 800+       | 快速参考         |
-| SESSION_COMPLETION_SUMMARY.md     | 600+       | 会话总结         |
-| PHASE_2_VERIFICATION_CHECKLIST.md | 400+       | 验证清单         |
-| FINAL_COMPLETION_REPORT.md        | 800+       | 最终总结         |
-| **小计**                          | **4,100+** | **Phase 2 专用** |
-
-### 现有文档库
-
-| 类别         | 数量    | 示例                                                           |
-| ------------ | ------- | -------------------------------------------------------------- |
-| 设计系统文档 | 2       | DESIGN_SYSTEM_VARIABLES.md, ADMIN_DEVELOPMENT_STANDARDS.md     |
-| 开发指南     | 3       | QUICK_START_NEW_DEVELOPMENT.md, ADMIN_MANAGEMENT_GUIDE.md, ... |
-| 迁移文档     | 4       | MIGRATION_GUIDE.md, MIGRATION_SUMMARY.md, ...                  |
-| 其他文档     | 5+      | README.md, PAGE_STRUCTURE_ANALYSIS.md, ...                     |
-| **小计**     | **14+** | **累计 5,000+ 行**                                             |
-
-### 总计
-
-- **新增文档**: 5 份
-- **现有文档**: 14+ 份
-- **总计**: 19+ 份
-- **总行数**: 5,000+ 行
-
----
-
-## 🔍 按主题检索
-
-### 🏗️ 架构设计
-
-- [ADMIN_DEVELOPMENT_STANDARDS.md](docs/ADMIN_DEVELOPMENT_STANDARDS.md) - 整体架构和规范
-- [ADMIN_LAYOUT_GUIDE.md](docs/ADMIN_LAYOUT_GUIDE.md) - 布局设计
-- [PAGE_STRUCTURE_ANALYSIS.md](docs/PAGE_STRUCTURE_ANALYSIS.md) - 页面结构分析
-
-### 🎨 设计系统
-
-- [DESIGN_SYSTEM_VARIABLES.md](docs/DESIGN_SYSTEM_VARIABLES.md) - 150+ 个设计变量
-- [PHASE_2_QUICK_REFERENCE.md](PHASE_2_QUICK_REFERENCE.md) - 变量替换对照表
-
-### 📝 开发指南
-
-- [QUICK_START_NEW_DEVELOPMENT.md](doc_mall/QUICK_START_NEW_DEVELOPMENT.md) - 新页面开发
-- [\_TEMPLATE_simple-page.uvue](pages/mall/admin/_TEMPLATE_simple-page.uvue) - 页面模板
-- [ADMIN_REFACTOR_INDEX.md](docs/ADMIN_REFACTOR_INDEX.md) - 重构索引
-
-### 📊 进度追踪
-
-- [PHASE_2_COMPLETION_REPORT.md](PHASE_2_COMPLETION_REPORT.md) - Phase 2 完成情况
-- [FINAL_COMPLETION_REPORT.md](FINAL_COMPLETION_REPORT.md) - 总体完成情况
-- [ADMIN_REFACTOR_PROGRESS.md](docs/ADMIN_REFACTOR_PROGRESS.md) - 重构进度
-
-### ✅ 质量验证
-
-- [PHASE_2_VERIFICATION_CHECKLIST.md](PHASE_2_VERIFICATION_CHECKLIST.md) - 验证清单
-- [REFACTOR_BEFORE_AFTER.md](docs/REFACTOR_BEFORE_AFTER.md) - 重构前后对比
-
-### 🚀 未来规划
-
-- [FINAL_COMPLETION_REPORT.md](FINAL_COMPLETION_REPORT.md) - Phase 3-5 规划
-
----
-
-## 📱 关键文件位置
-
-### 核心重构文件
-
-```
-pages/mall/admin/
-├── system/                          [15 个 ✅]
-├── customer-service/                [5 个 ✅]
-├── subscription/                    [2 个 ✅]
-├── marketing/                       [5 个 ✅]
-├── content/ & design/               [2 个 ✅]
-├── homePage/                        [2 个 ✅]
-└── _TEMPLATE_simple-page.uvue       [模板 ✅]
-```
-
-### 文档文件
-
-```
-根目录/
-├── PHASE_2_COMPLETION_REPORT.md
-├── PHASE_2_QUICK_REFERENCE.md
-├── SESSION_COMPLETION_SUMMARY.md
-├── PHASE_2_VERIFICATION_CHECKLIST.md
-├── FINAL_COMPLETION_REPORT.md
-└── 本文件 (PHASE_2_INDEX.md)
-
-docs/
-├── DESIGN_SYSTEM_VARIABLES.md
-├── ADMIN_DEVELOPMENT_STANDARDS.md
-├── ADMIN_REFACTOR_PROGRESS.md
-├── REFACTOR_SUMMARY.md
-├── REFACTOR_BEFORE_AFTER.md
-├── ADMIN_REFACTOR_INDEX.md
-└── ...其他文档
-
-doc_mall/
-├── QUICK_START_NEW_DEVELOPMENT.md
-├── MIGRATION_GUIDE.md
-└── ...其他迁移文档
-```
-
----
-
-## ⚡ 快速命令
-
-### 验证 Phase 2 完成
-
-```bash
-# 计算总文件数
-find pages/mall/admin -name "*.uvue" -type f | wc -l
-
-# 检查设计变量使用
-grep -r '\$background-primary\|\$space-lg' pages/mall/admin/ --include="*.uvue" | wc -l
-
-# 验证 scoped 属性
-grep -r 'scoped' pages/mall/admin/ --include="*.uvue" | wc -l
-
-# 验证 lang="scss"
-grep -r 'lang="scss"' pages/mall/admin/ --include="*.uvue" | wc -l
-```
-
-### 查看重构前后对比
-
-```bash
-# 查看模板对比
-cat docs/REFACTOR_BEFORE_AFTER.md | grep -A 20 "# 前后对比"
-
-# 查看设计变量列表
-cat docs/DESIGN_SYSTEM_VARIABLES.md | grep "^- \\\$"
-
-# 查看完成清单
-cat PHASE_2_VERIFICATION_CHECKLIST.md | grep "✅"
-```
-
----
-
-## 🎓 学习路径
-
-### 新开发者入门 (2-3 天)
-
-1. **第 1 天**: 阅读 [ADMIN_DEVELOPMENT_STANDARDS.md](docs/ADMIN_DEVELOPMENT_STANDARDS.md) + [DESIGN_SYSTEM_VARIABLES.md](docs/DESIGN_SYSTEM_VARIABLES.md)
-2. **第 2 天**: 查看 [\_TEMPLATE_simple-page.uvue](pages/mall/admin/_TEMPLATE_simple-page.uvue) + 参考现有页面
-3. **第 3 天**: 按 [QUICK_START_NEW_DEVELOPMENT.md](doc_mall/QUICK_START_NEW_DEVELOPMENT.md) 创建新页面
-
-### 项目经理了解进度 (30分钟)
-
-1. 阅读 [PHASE_2_QUICK_REFERENCE.md](PHASE_2_QUICK_REFERENCE.md) (10分钟)
-2. 查看 [PHASE_2_VERIFICATION_CHECKLIST.md](PHASE_2_VERIFICATION_CHECKLIST.md) (10分钟)
-3. 阅读 [FINAL_COMPLETION_REPORT.md](FINAL_COMPLETION_REPORT.md) (10分钟)
-
-### 架构师深度了解 (2-4 小时)
-
-1. 阅读全部 Phase 2 文档 (1.5 小时)
-2. 查看 [REFACTOR_BEFORE_AFTER.md](docs/REFACTOR_BEFORE_AFTER.md) (30分钟)
-3. 审查核心文件代码 (1.5 小时)
-4. 规划 Phase 3-5 (30分钟)
-
----
-
-## 🔗 外部参考
-
-### uni-app-x 文档
-
-- [uni-app-x 官方文档](https://uniapp.dcloud.net.cn/uni-app-x/)
-- [UTS 语言文档](https://uniapp.dcloud.net.cn/uts/)
-
-### Vue 3 参考
-
-- [Vue 3 组合式 API](https://v3.vuejs.org/guide/composition-api-introduction.html)
-- [Vue 3 类型支持](https://v3.vuejs.org/guide/typescript-support.html)
-
-### SCSS 文档
-
-- [SCSS 官方文档](https://sass-lang.com/)
-- [SCSS 变量使用](https://sass-lang.com/documentation/variables)
-
----
-
-## 📞 文档反馈
-
-如有问题或建议:
-
-1. 查看对应的详细文档
-2. 参考 [PHASE_2_VERIFICATION_CHECKLIST.md](PHASE_2_VERIFICATION_CHECKLIST.md) 中的验证步骤
-3. 参考 [ADMIN_DEVELOPMENT_STANDARDS.md](docs/ADMIN_DEVELOPMENT_STANDARDS.md) 中的规范
-4. 查看 [\_TEMPLATE_simple-page.uvue](pages/mall/admin/_TEMPLATE_simple-page.uvue) 中的示例
-
----
-
-**最后更新**: Phase 2 完成  
-**文档总数**: 19+ 份  
-**总行数**: 5,000+ 行  
-**覆盖度**: 100%  
-**质量**: ⭐⭐⭐⭐⭐
-
-✅ **所有文档已就绪，期待您的使用！**
diff --git a/pages/mall/admin/docs/PHASE_2_QUICK_REFERENCE.md b/pages/mall/admin/docs/PHASE_2_QUICK_REFERENCE.md
deleted file mode 100644
index 50244c46..00000000
--- a/pages/mall/admin/docs/PHASE_2_QUICK_REFERENCE.md
+++ /dev/null
@@ -1,256 +0,0 @@
-# 📊 Phase 2 快速完成参考表
-
-## 文件完成清单
-
-### ✅ 系统配置目录（15/15 完成）
-
-| 文件名                             | 行数 | 状态 | 类型     |
-| ---------------------------------- | ---- | ---- | -------- |
-| agreement-settings.uvue            | 61   | ✅   | 系统配置 |
-| message-management.uvue            | 61   | ✅   | 系统配置 |
-| receipt-settings.uvue              | 61   | ✅   | 系统配置 |
-| api/collect.uvue                   | 62   | ✅   | API配置  |
-| api/logistics.uvue                 | 62   | ✅   | API配置  |
-| api/pay.uvue                       | 62   | ✅   | API配置  |
-| api/sms.uvue                       | 62   | ✅   | API配置  |
-| api/storage.uvue                   | 62   | ✅   | API配置  |
-| api/waybill.uvue                   | 62   | ✅   | API配置  |
-| permission/admin-list.uvue         | 62   | ✅   | 权限管理 |
-| permission/role.uvue               | 62   | ✅   | 权限管理 |
-| permission/permission-setting.uvue | 62   | ✅   | 权限管理 |
-| shipping/courier.uvue              | 62   | ✅   | 配送管理 |
-| shipping/freight-template.uvue     | 62   | ✅   | 配送管理 |
-
-### ✅ 客服系统目录（5/5 完成）
-
-| 文件名          | 行数 | 状态 | 特殊处理             |
-| --------------- | ---- | ---- | -------------------- |
-| auto-reply.uvue | 36   | ✅   | 保留 topbar flex布局 |
-| config.uvue     | 36   | ✅   | 保留 topbar flex布局 |
-| list.uvue       | 36   | ✅   | 保留 topbar flex布局 |
-| messages.uvue   | 36   | ✅   | 保留 topbar flex布局 |
-| script.uvue     | 36   | ✅   | 保留 topbar flex布局 |
-
-### ✅ 订阅管理目录（2/2 完成）
-
-| 文件名                  | 行数 | 状态 | 特殊处理                        |
-| ----------------------- | ---- | ---- | ------------------------------- |
-| plan-management.uvue    | 420  | ✅   | 保留 overlay/sheet/form复杂样式 |
-| user-subscriptions.uvue | 331  | ✅   | 保留 ActionSheet业务逻辑        |
-
-### ✅ 营销功能目录（5/5 完成）
-
-| 文件名              | 行数 | 状态 | 特殊处理       |
-| ------------------- | ---- | ---- | -------------- |
-| coupon/list.uvue    | 31   | ✅   | 动态路由模式   |
-| coupon/receive.uvue | 31   | ✅   | 动态路由模式   |
-| points/index.uvue   | 96   | ✅   | 样式替换已修复 |
-| signin/rule.uvue    | 61   | ✅   | 简单配置页面   |
-| signin/record.uvue  | 61   | ✅   | 简单配置页面   |
-
-### ✅ 内容与设计目录（2/2 完成）
-
-| 文件名             | 行数 | 状态 | 转换                     |
-| ------------------ | ---- | ---- | ------------------------ |
-| content/index.uvue | 30   | ✅   | P2 template → kebab-case |
-| design/index.uvue  | 30   | ✅   | P2 template → kebab-case |
-
-### ✅ 仪表盘目录（2/2 完成）
-
-| 文件名                               | 行数 | 状态 | 特殊处理                   |
-| ------------------------------------ | ---- | ---- | -------------------------- |
-| homePage/index.uvue                  | 531  | ✅   | 保留完整KPI逻辑+图表集成点 |
-| homePage/components/KpiMiniCard.uvue | 188  | ✅   | 组件样式完全现代化         |
-
----
-
-## 🎯 重构成果统计
-
-### 总体数据
-
-- **总文件数**: 27
-- **总代码行数**: ~3,200+
-- **平均文件大小**: ~119 行/文件
-- **完成率**: 100%
-- **成功率**: 100% (无失败或部分完成)
-
-### 按目录分布
-
-```
-系统配置      |████████████████ 15个
-客服系统      |███████ 5个
-订阅管理      |█████ 2个
-营销功能      |███████ 5个
-内容设计      |█████ 2个
-仪表盘        |█████ 2个
-────────────────────────────────
-总计         |27个文件 ✅
-```
-
-### 设计变量采用率
-
-```
-颜色变量      |████████████████ 8/8 (100%)
-间距变量      |████████████████ 5/5 (100%)
-字体大小      |████████████████ 5/5 (100%)
-圆角变量      |████████████████ 3/3 (100%)
-阴影变量      |████████████████ 2/2 (100%)
-────────────────────────────────
-总体覆盖      |████████████████ 100%
-```
-
-### 代码质量指标
-
-- ✅ **TypeScript 类型**: 100% 覆盖 (ref<T>, computed<T>, params types)
-- ✅ **CSS 作用域**: 100% 添加 `scoped` (防止样式污染)
-- ✅ **SCSS 语言**: 100% 添加 `lang="scss"`
-- ✅ **命名规范**: 100% 使用 kebab-case (.page, .header, .title)
-- ✅ **功能保留**: 100% 保留原有业务逻辑
-
----
-
-## 🔍 核心更改对比
-
-### 前后对比示例
-
-#### 示例 1: 简单配置页面（如 agreement-settings.uvue）
-
-```diff
-- <view class="Page">
--   <view class="Header">
--     <text class="Title">协议设置</text>
-+
-+ <view class="page">
-+   <view class="header">
-+     <text class="title">协议设置</text>
-
-- <style>
-- .Page { padding: 24rpx; }
-- .Header { background: #ffffff; }
-- .Title { font-size: 36rpx; }
-+ <style scoped lang="scss">
-+ .page { padding: $space-lg; }
-+ .header { background: $background-primary; }
-+ .title { font-size: $font-size-xl; }
-```
-
-#### 示例 2: 复杂业务页面（如 subscription/plan-management.uvue）
-
-```diff
-  // 脚本: 仅添加类型，保留所有业务逻辑
-  const plans = ref<Plan[]>([])
-- onLoad((options) => { ... })
-+ onLoad((options: Record<string, string | undefined>) => { ... })
-
-  // 样式: 完全替换硬编码值
-- background: #ffffff;
-+ background: $background-primary;
-- padding: 24px;
-+ padding: $space-lg;
-- font-size: 16px;
-+ font-size: $font-size-base;
-```
-
-#### 示例 3: 组件样式更新（如 KpiMiniCard.uvue）
-
-```diff
-- <style>
-+ <style scoped lang="scss">
-  .kpi-card {
--   background-color: #ffffff;
--   border: 1px solid #ebeef5;
--   border-radius: 6px;
--   padding: 16px;
--   box-shadow: 0 2px 12px rgba(0,0,0,0.04);
-+   background-color: $background-primary;
-+   border: 1px solid $background-secondary;
-+   border-radius: $border-radius-md;
-+   padding: $space-lg;
-+   box-shadow: $shadow-xs;
-  }
-```
-
----
-
-## 📋 检查清单
-
-使用此清单验证所有文件的完成质量：
-
-### 模板层 (Template)
-
-- [ ] 所有 PascalCase 类名转换为 kebab-case
-- [ ] 所有 v-bind 和插值表达式保留
-- [ ] 所有条件/循环逻辑保留
-- [ ] 所有事件处理保留
-
-### 脚本层 (Script)
-
-- [ ] lang="uts" 属性已添加
-- [ ] 所有 ref<T>() 添加了类型注解
-- [ ] 所有 computed<T>() 添加了类型注解
-- [ ] 函数参数添加了类型（如 Record<string, string | undefined>）
-- [ ] 所有业务逻辑 100% 保留
-- [ ] 所有导入语句保留
-
-### 样式层 (Style)
-
-- [ ] lang="scss" 已添加
-- [ ] scoped 属性已添加
-- [ ] 所有 #xxxxxx 颜色替换为 $color-variable
-- [ ] 所有 px/rpx 间距替换为 $space-variable
-- [ ] 所有 px/rpx 字体大小替换为 $font-size-variable
-- [ ] 所有 px/rpx 圆角替换为 $border-radius-variable
-- [ ] 所有阴影替换为 $shadow-variable
-- [ ] 所有媒体查询保留
-
----
-
-## 🚀 Phase 2 时间轴
-
-| 阶段           | 时间       | 完成文件  | 成果                                |
-| -------------- | ---------- | --------- | ----------------------------------- |
-| 系统配置批处理 | ~20分钟    | 15/15     | 完成所有 system/ 目录               |
-| 客服系统批处理 | ~15分钟    | 5/5       | 完成 customer-service/ + topbar保留 |
-| 订阅系统处理   | ~10分钟    | 2/2       | 保留复杂样式逻辑                    |
-| 营销功能处理   | ~15分钟    | 5/5       | 解决样式替换问题                    |
-| 仪表盘+组件    | ~20分钟    | 2/2       | 大型仪表板完全现代化                |
-| 文档+验证      | ~10分钟    | -         | 生成完整文档和验证                  |
-| **总计**       | **90分钟** | **27/27** | **✅ Phase 2 完成**                 |
-
----
-
-## 📈 Phase 1 + Phase 2 总计
-
-- **Phase 1 完成**: 37 个文件
-- **Phase 2 完成**: 27 个文件
-- **总计**: **64 个文件** ✅
-- **覆盖率**: **80%** (剩余 ~16 个为未来创建的页面)
-- **设计系统采用**: **100%** (23/23 变量)
-- **代码质量**: **优秀** (99.5% 一致性)
-
----
-
-## 💾 文件保存位置
-
-所有重构完成的文件已保存至原始位置，无需迁移：
-
-```
-d:\骅锋\mall\pages\mall\admin\
-├── system\
-│   ├── agreement-settings.uvue ✅
-│   ├── message-management.uvue ✅
-│   ├── receipt-settings.uvue ✅
-│   ├── api\ ✅ (6个)
-│   ├── permission\ ✅ (3个)
-│   └── shipping\ ✅ (2个)
-├── customer-service\ ✅ (5个)
-├── subscription\ ✅ (2个)
-├── marketing\ ✅ (5个)
-├── content\ ✅ (1个)
-├── design\ ✅ (1个)
-└── homePage\ ✅ (2个)
-```
-
----
-
-**最后更新**: Phase 2 完成 | **状态**: ✅ 生产就绪 | **质量**: 优秀
diff --git a/pages/mall/admin/docs/PHASE_2_VERIFICATION_CHECKLIST.md b/pages/mall/admin/docs/PHASE_2_VERIFICATION_CHECKLIST.md
deleted file mode 100644
index 51722812..00000000
--- a/pages/mall/admin/docs/PHASE_2_VERIFICATION_CHECKLIST.md
+++ /dev/null
@@ -1,264 +0,0 @@
-# ✅ Phase 2 完成验证检查表
-
-## 快速验证命令
-
-使用以下 grep 命令验证所有文件的完成质量：
-
-### 1. 验证 scoped 属性
-
-```bash
-grep -r "scoped" pages/mall/admin/ --include="*.uvue" | wc -l
-# 预期: 64+ 个文件
-```
-
-### 2. 验证 lang="scss"
-
-```bash
-grep -r 'lang="scss"' pages/mall/admin/ --include="*.uvue" | wc -l
-# 预期: 64+ 个文件
-```
-
-### 3. 检查硬编码颜色（应该很少）
-
-```bash
-grep -r '#[0-9a-fA-F]\{6\}' pages/mall/admin/ --include="*.uvue" | head -20
-# 应该都是注释或特殊用途
-```
-
-### 4. 检查设计变量使用
-
-```bash
-grep -r '\$background-primary\|\$space-lg\|\$font-size-base' pages/mall/admin/ --include="*.uvue" | wc -l
-# 预期: 100+ 个匹配
-```
-
----
-
-## Phase 2 文件完成状态检查表
-
-### ✅ System 目录 (15/15 完成)
-
-- [ ] `system/agreement-settings.uvue`
-  - Template: kebab-case ✅
-  - Script: TypeScript types ✅
-  - Style: Design variables ✅
-  - scoped + lang="scss" ✅
-
-- [ ] `system/message-management.uvue` - ✅ 同上
-
-- [ ] `system/receipt-settings.uvue` - ✅ 同上
-
-- [ ] `system/api/collect.uvue` - ✅
-- [ ] `system/api/logistics.uvue` - ✅
-- [ ] `system/api/pay.uvue` - ✅
-- [ ] `system/api/sms.uvue` - ✅
-- [ ] `system/api/storage.uvue` - ✅
-- [ ] `system/api/waybill.uvue` - ✅
-
-- [ ] `system/permission/admin-list.uvue` - ✅
-- [ ] `system/permission/role.uvue` - ✅
-- [ ] `system/permission/permission-setting.uvue` - ✅
-
-- [ ] `system/shipping/courier.uvue` - ✅
-- [ ] `system/shipping/freight-template.uvue` - ✅
-
-### ✅ Customer Service 目录 (5/5 完成)
-
-- [ ] `customer-service/auto-reply.uvue` - ✅
-  - Special: topbar flex 布局保留 ✅
-
-- [ ] `customer-service/config.uvue` - ✅
-- [ ] `customer-service/list.uvue` - ✅
-- [ ] `customer-service/messages.uvue` - ✅
-- [ ] `customer-service/script.uvue` - ✅
-
-### ✅ Subscription 目录 (2/2 完成)
-
-- [ ] `subscription/plan-management.uvue` - ✅
-  - Special: 420 行复杂 overlay/sheet 样式保留 ✅
-  - All styles replaced with variables ✅
-
-- [ ] `subscription/user-subscriptions.uvue` - ✅
-  - Special: ActionSheet 业务逻辑保留 ✅
-  - All styles replaced with variables ✅
-
-### ✅ Marketing 目录 (5/5 完成)
-
-- [ ] `marketing/coupon/list.uvue` - ✅
-  - Dynamic routing pattern ✅
-  - Styles: All variables ✅
-
-- [ ] `marketing/coupon/receive.uvue` - ✅
-
-- [ ] `marketing/points/index.uvue` - ✅
-  - Fixed: Style replacement issue resolved ✅
-  - Computed property preserved ✅
-
-- [ ] `marketing/signin/rule.uvue` - ✅
-  - Simple config pattern ✅
-
-- [ ] `marketing/signin/record.uvue` - ✅
-
-### ✅ Content & Design 目录 (2/2 完成)
-
-- [ ] `content/index.uvue` - ✅
-  - Converted from P2 template to kebab-case ✅
-
-- [ ] `design/index.uvue` - ✅
-
-### ✅ HomePage 目录 (2/2 完成)
-
-- [ ] `homePage/index.uvue` - ✅
-  - 531 lines, full KPI logic preserved ✅
-  - All styles to variables ✅
-  - Chart integration points preserved ✅
-
-- [ ] `homePage/components/KpiMiniCard.uvue` - ✅
-  - 188 lines component ✅
-  - SCSS nested styles handled ✅
-  - scoped + lang="scss" added ✅
-
----
-
-## 🔍 详细验证清单
-
-### 每个文件应该包含:
-
-#### Template 部分
-
-```diff
-- ✅ 所有 PascalCase 类名转换为 kebab-case
-- ✅ .Page → .page
-- ✅ .Header → .header
-- ✅ .Title → .title
-- ✅ .Card → .card
-- ✅ 所有原有模板逻辑完整保留
-```
-
-#### Script 部分
-
-```diff
-- ✅ lang="uts" 属性存在
-- ✅ 所有 ref() 添加了类型: ref<string>()
-- ✅ 所有 computed() 添加了类型: computed<string>()
-- ✅ onLoad 参数类型: Record<string, string | undefined>
-- ✅ 所有业务逻辑 100% 保留
-```
-
-#### Style 部分
-
-```diff
-- ✅ <style scoped lang="scss"> 标签格式正确
-- ✅ 所有 #ffffff → $background-primary
-- ✅ 所有 24rpx → $space-lg
-- ✅ 所有 14px → $font-size-sm
-- ✅ 所有 6px → $border-radius-md
-- ✅ 所有响应式查询 @media 保留
-```
-
----
-
-## 📊 量化指标
-
-### Code Metrics (Phase 2)
-
-| 指标            | 目标 | 实际  | 状态    |
-| --------------- | ---- | ----- | ------- |
-| 文件完成数      | 27   | 27    | ✅ 100% |
-| kebab-case 类名 | 100% | 100%  | ✅      |
-| TypeScript 类型 | 90%  | 99%   | ✅      |
-| 设计变量使用    | 95%  | 100%  | ✅      |
-| 功能保留率      | 99%  | 99.5% | ✅      |
-| scoped 属性     | 100% | 100%  | ✅      |
-| lang="scss"     | 100% | 100%  | ✅      |
-
-### Style Variable Coverage (Phase 2)
-
-| 变量类别          | 替换数量 | 覆盖率   |
-| ----------------- | -------- | -------- |
-| 颜色 (#fff等)     | 150+     | 100%     |
-| 间距 (24rpx等)    | 200+     | 100%     |
-| 字体大小 (14px等) | 80+      | 100%     |
-| 圆角 (6px等)      | 50+      | 100%     |
-| 阴影              | 30+      | 100%     |
-| **总计**          | **510+** | **100%** |
-
----
-
-## 🧪 快速测试步骤
-
-### 1. 文件完整性检查
-
-```bash
-# 计数所有重构文件
-find pages/mall/admin -name "*.uvue" -type f | wc -l
-# 应该是 64 个或更多
-```
-
-### 2. 样式变量检查
-
-```bash
-# 查找仍然使用硬编码颜色的文件
-grep -r '#[a-fA-F0-9]\{3,6\}' pages/mall/admin/ --include="*.uvue" | grep -v '//\|<!--' | head -10
-# 应该很少或没有（除了特殊情况）
-```
-
-### 3. 命名规范检查
-
-```bash
-# 查找仍然使用 PascalCase 的文件
-grep -r 'class="[A-Z]' pages/mall/admin/ --include="*.uvue" | head -10
-# 应该为空
-```
-
-### 4. TypeScript 类型检查
-
-```bash
-# 查找有类型的 ref
-grep -r 'ref<' pages/mall/admin/ --include="*.uvue" | wc -l
-# 应该是 50+ 个
-```
-
----
-
-## 📋 完成证明
-
-### Phase 2 完成签名
-
-**总文件数**: 27 ✅  
-**总代码行**: ~3,200+ ✅  
-**设计变量应用**: 510+ 替换 ✅  
-**类型安全**: 99% 覆盖 ✅  
-**功能保留**: 99.5% ✅  
-**文档完成**: 2 份新文档 + 6 份现有文档 ✅
-
-### 所有目标达成
-
-- [x] 系统配置页面重构完成
-- [x] 客服系统页面重构完成
-- [x] 订阅管理页面重构完成
-- [x] 营销功能页面重构完成
-- [x] 内容与设计页面重构完成
-- [x] 仪表盘与组件重构完成
-- [x] 所有硬编码值替换为设计变量
-- [x] 所有类名改为 kebab-case
-- [x] 所有脚本添加 TypeScript 类型
-- [x] 所有样式添加 scoped 和 lang="scss"
-- [x] 完整文档生成
-- [x] 零破坏性变更验证
-
----
-
-## 🎯 成功标志
-
-✅ **所有 27 个 Phase 2 文件完全重构**  
-✅ **100% 设计规范一致性**  
-✅ **99.5% 功能保留率**  
-✅ **3,000+ 行文档**  
-✅ **生产就绪状态**
-
----
-
-**验证时间**: Phase 2 完成时  
-**验证人**: AI 系统验证  
-**最终状态**: ✅ PASSED (所有检查项通过)
diff --git a/pages/mall/admin/docs/ROUTING_FIX_REPORT.md b/pages/mall/admin/docs/ROUTING_FIX_REPORT.md
deleted file mode 100644
index 1c951d8b..00000000
--- a/pages/mall/admin/docs/ROUTING_FIX_REPORT.md
+++ /dev/null
@@ -1,44 +0,0 @@
-# Vue Router 路由错误修复报告
-
-## 问题描述
-
-用户报告了一个 Vue Router 警告：
-
-```
-[Vue Router warn]: No match found for location with path "/pages/mall/admin/marketing/points/index?tab=seckill-config"
-```
-
-该错误出现在应用启动阶段（main.uts:18），表明系统仍在尝试加载一个已废弃的、使用 query 参数的旧路由。
-
-## 根本原因
-
-在升级营销模块从多标签页（单个 `/points/index` 页面带多个 tabs）改为独立页面架构时，存在两个不同的 `pages.json` 文件：
-
-1. **`d:\骅锋\mall\pages.json`** - 根目录主配置文件（已正确更新）
-2. **`d:\骅锋\mall\pages\mall\pages.json`** - 旧的子包配置文件（未更新）
-
-旧的子包配置文件中仍然包含已废弃的 `marketing/points/index` 路由注册。
-
-## 解决方案
-
-✅ **已删除** `d:\骅锋\mall\pages\mall\pages.json` 中的以下条目（第 488-495 行）：
-
-```json
-{
-  "path": "marketing/points/index",
-  "style": {
-    "navigationBarTitleText": "积分管理",
-    "enablePullDownRefresh": false
-  }
-}
-```
-
-## 验证
-
-- ✅ 代码搜索确认：没有任何代码引用 `/pages/mall/admin/marketing/points/index?tab=*` 路由
-- ✅ menu.uts 中所有营销菜单项已正确指向独立页面路由
-- ✅ 所有 5 个积分相关页面（stats, goods, order, record, config）已正确注册在根 pages.json 中
-
-## 后续步骤
-
-应用重新编译后，Vue Router 警告应该消失。所有营销页面导航将按照新的独立页面架构正确运行。
diff --git a/pages/mall/admin/docs/SESSION_COMPLETION_SUMMARY.md b/pages/mall/admin/docs/SESSION_COMPLETION_SUMMARY.md
deleted file mode 100644
index ce6d2ba1..00000000
--- a/pages/mall/admin/docs/SESSION_COMPLETION_SUMMARY.md
+++ /dev/null
@@ -1,364 +0,0 @@
-# 🎉 Phase 2 重构 - 会话完成总结
-
-## 📌 会话概览
-
-**开始**: 用户发起"继续重构"命令  
-**结束**: Phase 2 完整完成，所有 27 个文件已重构  
-**总耗时**: ~90 分钟（实际代码操作）  
-**成果**: 27 个文件 + 2 份完整文档
-
----
-
-## ✨ 本会话亮点
-
-### 1️⃣ 高效批量处理
-
-- **多文件操作**: 使用 `multi_replace_string_in_file` 在单次调用中处理 2-6 个文件
-- **样式替换**: 解决了之前卡住的样式替换问题（分块替换法）
-- **时间效率**: 平均每个文件 ~3-5 分钟完成
-
-### 2️⃣ 智能错误处理
-
-| 问题                          | 原因               | 解决方案                      |
-| ----------------------------- | ------------------ | ----------------------------- |
-| marketing/points 样式替换失败 | 字符串精确匹配问题 | 改用分块替换 + 更精确的上下文 |
-| KpiMiniCard 样式替换失败      | SCSS 嵌套格式差异  | 分解为多个小块单独替换        |
-
-### 3️⃣ 大型文件处理
-
-- **homePage/index.uvue**: 531 行仪表板，完全保留 KPI 逻辑和图表集成点
-- **plan-management.uvue**: 420 行复杂订阅管理，保留所有 overlay/sheet 样式
-- **user-subscriptions.uvue**: 331 行 ActionSheet 业务逻辑完全保留
-
----
-
-## 📊 重构成果详情
-
-### 完成的 27 个文件
-
-#### 第 1 批：系统配置（15 个）✅
-
-```
-system/
-├── agreement-settings.uvue         [61行]  ✅
-├── message-management.uvue         [61行]  ✅
-├── receipt-settings.uvue           [61行]  ✅
-├── api/
-│   ├── collect.uvue                [62行]  ✅
-│   ├── logistics.uvue              [62行]  ✅
-│   ├── pay.uvue                    [62行]  ✅
-│   ├── sms.uvue                    [62行]  ✅
-│   ├── storage.uvue                [62行]  ✅
-│   └── waybill.uvue                [62行]  ✅
-├── permission/
-│   ├── admin-list.uvue             [62行]  ✅
-│   ├── role.uvue                   [62行]  ✅
-│   └── permission-setting.uvue     [62行]  ✅
-└── shipping/
-    ├── courier.uvue                [62行]  ✅
-    └── freight-template.uvue       [62行]  ✅
-```
-
-#### 第 2 批：客服系统（5 个）✅
-
-```
-customer-service/
-├── auto-reply.uvue                 [36行]  ✅ (保留 topbar 布局)
-├── config.uvue                     [36行]  ✅
-├── list.uvue                       [36行]  ✅
-├── messages.uvue                   [36行]  ✅
-└── script.uvue                     [36行]  ✅
-```
-
-#### 第 3 批：订阅管理（2 个）✅
-
-```
-subscription/
-├── plan-management.uvue            [420行] ✅ (复杂 overlay 保留)
-└── user-subscriptions.uvue         [331行] ✅ (ActionSheet 保留)
-```
-
-#### 第 4 批：营销功能（5 个）✅
-
-```
-marketing/
-├── coupon/
-│   ├── list.uvue                   [31行]  ✅
-│   └── receive.uvue                [31行]  ✅
-├── points/
-│   └── index.uvue                  [96行]  ✅ (样式问题已解决)
-└── signin/
-    ├── rule.uvue                   [61行]  ✅
-    └── record.uvue                 [61行]  ✅
-```
-
-#### 第 5 批：内容与设计（2 个）✅
-
-```
-├── content/index.uvue              [30行]  ✅
-└── design/index.uvue               [30行]  ✅
-```
-
-#### 第 6 批：仪表盘（2 个）✅
-
-```
-homePage/
-├── index.uvue                      [531行] ✅ (完整图表逻辑保留)
-└── components/KpiMiniCard.uvue     [188行] ✅ (组件样式现代化)
-```
-
-**总行数**: ~3,200+ 行代码  
-**成功率**: 100% (27/27 完全成功)
-
----
-
-## 🔄 应用的重构模式
-
-### 模式总结
-
-**模式 A - 简单配置页面** (占 56%)
-
-- system/\*, customer-service/\* 的基础内容
-- 转换: PascalCase → kebab-case
-- 特点: 结构简单，快速处理
-
-**模式 B - 动态路由页面** (占 19%)
-
-- marketing/coupon/\*, marketing/points/\*, marketing/signin/\*
-- 转换: 同 A，但保留 computed 路由逻辑
-- 特点: 需要理解业务逻辑
-
-**模式 C - 复杂业务页面** (占 15%)
-
-- subscription/\*, homePage/\*
-- 转换: 保留所有脚本，仅更新样式+类型
-- 特点: 大文件，复杂样式，需要谨慎处理
-
-**模式 D - 组件文件** (占 7%)
-
-- homePage/components/KpiMiniCard.uvue
-- 转换: 完全样式现代化，保留 props 和 computed
-- 特点: 需要 scoped CSS 处理
-
----
-
-## 💪 技术挑战与解决方案
-
-### 挑战 1: 样式替换精确匹配
-
-```
-问题: replace_string_in_file 无法匹配多行样式块
-原因: 字符编码或空白字符差异
-解决: 分块替换法 + 更多上下文行
-结果: ✅ 成功处理所有 27 个文件
-```
-
-### 挑战 2: SCSS 嵌套语法
-
-```
-问题: KpiMiniCard 组件中嵌套 CSS 规则难以匹配
-原因: 嵌套选择器的缩进和格式差异
-解决: 单独处理每个嵌套块（.kpi-header, .kpi-body 等）
-结果: ✅ 5 次细粒度替换完成
-```
-
-### 挑战 3: 大型仪表板文件
-
-```
-问题: homePage/index.uvue 531 行，样式块 300+ 行
-原因: 单次替换整个块可能失败
-解决: 使用 multi_replace_string_in_file 的分段能力
-结果: ✅ 一次成功完成所有替换
-```
-
-### 挑战 4: 业务逻辑保留
-
-```
-问题: 如何修改样式同时保留完整的业务逻辑?
-原因: 不能破坏任何 JavaScript/TypeScript 代码
-解决: 仅替换样式块，保留脚本完全不动（模式 C）
-结果: ✅ 420+ 行订阅逻辑、331 行 ActionSheet 完全保留
-```
-
----
-
-## 📈 代码质量指标
-
-### TypeScript 覆盖率
-
-```
-ref<T>() 类型注解:  27/27 文件 (100%) ✅
-computed<T>():      12/27 文件 (44%) ✅
-函数参数类型:       25/27 文件 (93%) ✅
-总体类型安全:       100% ✅
-```
-
-### CSS 规范覆盖率
-
-```
-scoped 属性:        27/27 文件 (100%) ✅
-lang="scss":        27/27 文件 (100%) ✅
-kebab-case 类名:    27/27 文件 (100%) ✅
-设计变量使用:       27/27 文件 (100%) ✅
-总体规范性:         100% ✅
-```
-
-### 功能保留率
-
-```
-业务逻辑:           27/27 文件 (100%) ✅
-组件交互:           27/27 文件 (100%) ✅
-事件处理:           27/27 文件 (100%) ✅
-计算属性:           25/27 文件 (93%) ✅
-API 调用:           24/27 文件 (89%) ✅
-总体保留率:         99.5% ✅
-```
-
----
-
-## 📚 文档产出
-
-### 新增文档（本会话）
-
-1. **PHASE_2_COMPLETION_REPORT.md**
-   - 详细的完成报告
-   - 所有 27 个文件的逐一说明
-   - 应用的重构模式
-   - 样式变量替换统计
-
-2. **PHASE_2_QUICK_REFERENCE.md**
-   - 快速参考表
-   - 文件完成清单
-   - 前后对比示例
-   - 检查清单
-
-### 现有文档库（累计）
-
-- ADMIN_REFACTOR_PROGRESS.md
-- REFACTOR_SUMMARY.md
-- REFACTOR_BEFORE_AFTER.md
-- QUICK_START_NEW_DEVELOPMENT.md
-- ADMIN_PROJECT_FINAL_REPORT.md
-- ADMIN_REFACTOR_INDEX.md
-- DESIGN_SYSTEM_VARIABLES.md
-- ADMIN_DEVELOPMENT_STANDARDS.md
-
-**文档总行数**: 3,000+ 行  
-**覆盖范围**: 100% 的重构工作
-
----
-
-## 🎯 整体进度回顾
-
-### 从开始到现在
-
-**初始状态** (会话开始)
-
-- 37 个文件已完成（Phase 1）
-- 23 个文件待处理（Phase 2）
-- 需要处理的目录: system/, customer-service/, subscription/, marketing/, homePage/ 等
-
-**当前状态** (会话结束) ✅
-
-- 64 个文件已完成 (Phase 1: 37 + Phase 2: 27)
-- 0 个文件待处理 (Phase 2 完成)
-- 覆盖率: 80% (剩余 ~16 个为未来创建的页面)
-
-**质量指标**
-
-- 代码一致性: 99.5% ✅
-- 功能保留率: 99.5% ✅
-- 零破坏性变更: 100% ✅
-- 文档完整性: 100% ✅
-
----
-
-## 🚀 下一步方向
-
-### Phase 3: 组件库建设（预计 8-12 小时）
-
-```
-目标: 建立可复用的 UI 组件库
-任务:
-  ☐ 提取公共组件 (Button, Input, Table, Modal, Form)
-  ☐ 编写组件 Props 接口
-  ☐ 创建组件使用文档
-  ☐ 集成到已重构的页面
-```
-
-### Phase 4: 功能增强（预计 16+ 小时）
-
-```
-目标: 实现完整的后台管理功能
-任务:
-  ☐ API 层集成 (Pinia store)
-  ☐ 搜索/筛选/排序/分页
-  ☐ 权限控制系统
-  ☐ 状态管理
-  ☐ 网络请求处理
-```
-
-### Phase 5: 集成测试（预计 4-6 小时）
-
-```
-目标: 确保所有功能正常运行
-任务:
-  ☐ 页面功能验证
-  ☐ 响应式设计测试
-  ☐ 性能优化
-  ☐ 跨浏览器兼容性
-```
-
----
-
-## 💡 关键学习
-
-### 1. 批量处理的效率
-
-- 使用 `multi_replace_string_in_file` 比 `replace_string_in_file` 快 50%
-- 分块替换比一次性替换成功率高 95%
-
-### 2. 大文件处理技巧
-
-- 先用 `read_file` 确认格式
-- 用 `grep_search` 验证目标字符串存在
-- 使用扩展的上下文（3-5 行）确保精确匹配
-
-### 3. 业务逻辑保护
-
-- 保留脚本，仅修改样式是最安全的方式
-- TypeScript 类型注解可以逐步添加，不破坏现有逻辑
-- 组件的 props 和 emits 必须完全保留
-
-### 4. 设计系统的价值
-
-- 使用 23 个精心设计的变量替换数百个硬编码值
-- 减少重复代码，提高维护性
-- 统一视觉风格，提升用户体验
-
----
-
-## 📝 最后的话
-
-**Phase 2 的圆满完成标志着管理员项目的重构进入新阶段：**
-
-✅ **结构化完成** - 所有页面遵循统一的开发规范  
-✅ **类型安全** - 完整的 TypeScript 类型注解  
-✅ **设计一致** - 100% 采用设计系统变量  
-✅ **文档完备** - 3,000+ 行开发指南  
-✅ **零缺陷** - 没有破坏任何现有功能
-
-接下来的 Phase 3-5 将进一步提升项目的功能完整性和用户体验。
-
----
-
-**会话时间**: 90 分钟  
-**处理文件**: 27 个  
-**代码行数**: ~3,200+  
-**文档行数**: 1,500+  
-**成功率**: 100%  
-**下一步**: Phase 3 - 组件库建设 🎯
-
----
-
-_"从混乱到秩序，从重复到复用，从规范到卓越。"_ ✨
diff --git a/pages/mall/admin/docs/SYSTEM_INFO_DIAGNOSIS.md b/pages/mall/admin/docs/SYSTEM_INFO_DIAGNOSIS.md
deleted file mode 100644
index 4dd882d3..00000000
--- a/pages/mall/admin/docs/SYSTEM_INFO_DIAGNOSIS.md
+++ /dev/null
@@ -1,306 +0,0 @@
-# System-Info 页面 Sider/SubSider 不显示 - 诊断报告
-
-## ✅ 检查清单结果
-
-按照 ADMIN_SIDEBAR_COMPLETE_GUIDE.md 的标准进行诊断：
-
-### 1️⃣ 文件配置 - ✅ 通过
-
-- ✅ 文件位置正确: `pages/mall/admin/maintain/system-info.uvue`
-- ✅ 编码正确: UTF-8 without BOM
-- ✅ SFC 结构正确: `<template>` → `<script>` → `<style>`
-- ✅ 导入了 AdminLayout
-
-### 2️⃣ 路由配置 - ✅ 通过
-
-**pages.json (line 603)**:
-
-```json
-{
-  "path": "maintain/system-info",
-  "style": {
-    "navigationBarTitleText": "系统信息",
-    "navigationStyle": "custom"
-  }
-}
-```
-
-- ✅ `navigationStyle: "custom"` 正确
-- ✅ `path` 与文件匹配
-
-### 3️⃣ 菜单配置 - ❌ 关键问题发现！
-
-**menu.uts (line 724-729)**:
-
-```typescript
-{
-  id: 'system-info',
-  title: '系统信息',
-  path: '/pages/mall/admin/maintain/system-info',
-  children: []
-}
-```
-
-**❌ 问题**:
-
-- `system-info` 定义为**菜单项本身**，不是一个 MenuGroup
-- 它应该是某个一级菜单（如 'maintain'）下的 **二级组（group）**
-- 当前结构：顶级数组中的菜单项 → 没有任何分组
-
-**对比工作正常的结构**:
-
-```typescript
-// refresh-cache 的结构（工作正常）
-{
-  id: 'maintain',  // ← 一级菜单
-  title: '维护',
-  groups: [
-    {
-      id: 'security-maintain',  // ← 二级组
-      title: '安全维护',
-      children: [
-        {
-          id: 'security-refresh-cache',  // ← 三级菜单
-          title: '刷新缓存',
-          path: '/pages/mall/admin/maintain/security/refresh-cache'
-        }
-      ]
-    }
-  ]
-}
-```
-
-### 4️⃣ 页面文件 - ✅ 通过
-
-```uvue
-<AdminLayout currentPage="system-info">
-  <!--  页面内容 -->
-</AdminLayout>
-```
-
-- ✅ `currentPage="system-info"` 设置正确
-
----
-
-## 🔍 根本原因分析
-
-### 为什么没有 Sider/SubSider？
-
-根据 AdminLayout.uvue 的计算逻辑：
-
-```typescript
-const activeGroups = computed(() => {
-  const m = menuList.value.find((it) => it.id === activeMenuId.value);
-  return m?.groups ?? []; // ← 从菜单项中获取 groups 数组
-});
-```
-
-**流程追踪**:
-
-1. `currentPage="system-info"`
-2. nav.uts 的 `findActiveByCurrentPage()` 无法匹配（因为 system-info 不在任何一级菜单的 groups 中）
-3. **降级到默认**: `{ activeMenuId: 'home', activeSubId: '' }`
-4. `activeGroups` 获取的是 'home' 菜单的 groups（为空）
-5. **条件判断失败**: `v-if="activeGroups.length > 0"` → SubSider 不显示！
-
----
-
-## 🛠️ 诊断步骤
-
-### 第一步：验证菜单配置
-
-**menu.uts 中检查 maintain 菜单**:
-
-```typescript
-{
-  id: 'maintain',
-  title: '维护',
-  icon: '/static/maintain.svg',
-  groups: [
-    // ... 其他组 ...
-    {
-      id: 'system-info',  // ← 必须确保 system-info 在 groups 数组中
-      title: '系统信息',
-      path: '/pages/mall/admin/maintain/system-info',
-      children: []
-    }
-  ]
-}
-```
-
-**检查清单**:
-
-- [ ] `system-info` 在 `maintain.groups` 数组中
-- [ ] `system-info.id === 'system-info'`
-- [ ] `system-info.path` 正确
-- [ ] `system-info.children` 设置为 `[]`
-
-### 第二步：在浏览器中运行诊断脚本
-
-打开浏览器 DevTools (F12)，在 Console 标签中粘贴运行:
-
-```javascript
-// 复制 debug-runtime-status.js 的内容到控制台
-```
-
-**关键输出指标**:
-
-- `activeMenuId` 应该是 `"maintain"`（不是 `"home"`）
-- `activeSubId` 应该是 `"system-info"`
-- `activeGroups` 应该有长度 > 0
-- `.sub-sider` DOM 应该存在且 `display !== 'none'`
-
-### 第三步：验证 nav.uts 匹配逻辑
-
-运行导航测试脚本:
-
-```powershell
-node test-system-info-nav.js
-```
-
-**预期输出**:
-
-```
-✅ PASS - 正确匹配到 maintain/system-info
-```
-
-如果显示 `maintain/system-info` 匹配失败，说明菜单配置有问题。
-
----
-
-## 🛠️ 可能的根本原因
-
-### 原因 1: system-info 在错误的位置
-
-❌ **错误** - 顶级菜单项（没有分组）:
-
-```typescript
-// menuList 的顶层
-[
-  { id: 'home', ... },
-  { id: 'system-info', ... },  // ← 错误位置！
-  { id: 'maintain', groups: [...] }
-]
-```
-
-✅ **正确** - maintain 菜单的 groups 内:
-
-```typescript
-{
-  id: 'maintain',
-  groups: [
-    { id: 'system-info', ... }  // ← 正确位置
-  ]
-}
-```
-
-### 原因 2: nav.uts 未正确检查 group 叶子节点
-
-**必须包含此逻辑**:
-
-```typescript
-for (const g of groups) {
-  // ⚠️ 关键：先检查 group 本身
-  if (g.id === page) {
-    return { activeMenuId: m.id, activeSubId: g.id };
-  }
-  if (g.path && normalize(g.path) === pageNorm) {
-    return { activeMenuId: m.id, activeSubId: g.id };
-  }
-  // 然后才检查 children
-  const cs = g.children ?? [];
-  // ...
-}
-```
-
-### 原因 3: AdminLayout 未正确同步状态
-
-**必须在多个生命周期调用 syncActiveByCurrentPage**:
-
-```typescript
-watch(
-  () => props.currentPage,
-  () => syncActiveByCurrentPage(),
-  { immediate: true },
-);
-onMounted(() => syncActiveByCurrentPage());
-onShow(() => syncActiveByCurrentPage());
-```
-
----
-
-## 🔧 修复方案
-
-根据诊断结果选择以下方案之一:
-
-**方案 A: 如果 nav 测试失败**
-→ 修复 menu.uts，确保 system-info 在 maintain.groups 中
-
-**方案 B: 如果 nav 测试通过但 subsider 仍不显示**
-→ 检查浏览器 Vue DevTools:
-
-- activeMenuId 是否为 "maintain"
-- activeSubId 是否为 "system-info"
-- activeGroups 是否有内容
-
-**方案 C: 如果一切看起来都正确**
-→ 清理缓存:
-
-```powershell
-Remove-Item -Recurse -Force unpackage\dist
-Remove-Item -Recurse -Force .hbuilderx\cache
-npm run dev:h5
-# 浏览器: Ctrl+Shift+Delete 清理，Ctrl+Shift+R 强制刷新
-```
-
----
-
-## 📊 对比表
-
-| 项目          | system-info (❌ 当前) | refresh-cache (✅ 工作)      |
-| ------------- | --------------------- | ---------------------------- |
-| 菜单结构      | 顶级菜单项            | 一级 > 二级组 > 三级         |
-| 所属分组      | 无                    | maintain > security-maintain |
-| nav 匹配结果  | home (默认)           | maintain                     |
-| activeGroups  | [] (empty)            | security-maintain's children |
-| SubSider 显示 | ❌ 隐藏               | ✅ 显示                      |
-
----
-
-## ✨ 修复步骤
-
-1. **编辑 menu.uts**
-   - 找到 `system-info` 菜单项（line 724-729）
-   - 删除或修改它
-   - 将其添加到 `maintain` > `groups` 中（建议在最后）
-
-2. **验证菜单 ID 一致性**
-   - `menu.uts` 中: `id: 'system-info'`
-   - `system-info.uvue` 中: `currentPage="system-info"`
-   - ✅ 保持一致
-
-3. **清理缓存**
-
-   ```powershell
-   Remove-Item -Recurse -Force unpackage\dist
-   Remove-Item -Recurse -Force .hbuilderx\cache
-   ```
-
-4. **重启开发服务器 & 清理浏览器缓存**
-   - Ctrl+Shift+Delete 清理浏览器
-   - Ctrl+Shift+R 强制刷新
-
----
-
-## 📌 关键学习点
-
-根据 ADMIN_SIDEBAR_COMPLETE_GUIDE.md:
-
-> **第二部分 2.1**: 菜单必须遵循以下结构之一：
->
-> - 选项 A: 有子菜单的菜单组（**推荐**）
-> - 选项 B: 没有子菜单的菜单组（叶子节点）
->
-> **关键**: 子菜单项必须在某个一级菜单的 `groups` 数组内
-
-system-info 当前的结构违反了这一原则，它被定义为顶级菜单项，而不是某个分组下的项。
diff --git a/pages/mall/admin/docs/UNI_APP_X_PAGE_FIX_GUIDE.md b/pages/mall/admin/docs/UNI_APP_X_PAGE_FIX_GUIDE.md
new file mode 100644
index 00000000..f070fd82
--- /dev/null
+++ b/pages/mall/admin/docs/UNI_APP_X_PAGE_FIX_GUIDE.md
@@ -0,0 +1,2408 @@
+---
+� 文档维护说明：
+
+此文档持续记录 uni-app-x / UTS / Supabase 项目开发中遇到的真实问题与解决方案，
+供后续开发者复盘参考，避免重复踩坑。
+
+文档标记维持在此文件中，以便后续开发和对接。
+---
+
+# uni-app-x 页面修复指南
+
+## 📋 文档概述
+
+本文档总结了 uni-app-x 项目中页面配置和编译错误的完整修复流程，旨在为后续开发提供标准化的解决方案和最佳实践。
+
+#### **原因十一：标签重复定义错误**
+
+- **现象**: `[plugin:vite:vue] Single file component can contain only one <script setup> element`
+- **原因**: 在使用 `replace_string_in_file` 等编辑工具时，如果匹配范围过窄（仅匹配了 template），而替换内容包含全量代码（template+script+style），会导致原有的 script/style 块被留在文件末尾，产生重复标签。
+- **解决方案**: 确保替换操作覆盖文件的完整生命周期，或者在发现 500 错误时检查文件末尾是否有残留的旧标签。
+- **预防**: 优先使用 `create_file` 或子代理重写整个文件，而非局部替换复杂的 SFC 结构。
+
+#### **原因十二：KPI 统计网格响应式不一致 (用户体验红线)**
+
+- **现象**: 某些宽度下出现一行 3 个卡片，导致视觉不平衡或数据展示拥挤。
+- **原因**: 使用了 `repeat(auto-fit/auto-fill, ...)` 或基于 `min-width` 的 flex 自动布局。
+- **解决方案**:
+  1. 使用全局统一类 `.kpi-grid`。
+  2. 严禁使用 `auto-fit/auto-fill`。
+  3. 必须显式使用视图断点拦截：
+     - `>= 1200px`: 固定 4 列 (`grid-template-columns: repeat(4, minmax(0, 1fr))`)。
+     - `768px - 1199px`: 固定 2 列 (`grid-template-columns: repeat(2, minmax(0, 1fr))`)。
+     - `< 768px`: 固定 1 列 (`grid-template-columns: repeat(1, minmax(0, 1fr))`)。
+  4. 使用 `minmax(0, 1fr)` 配分子项 `min-width: 0` 确保在任何容器宽度下网格不被撑爆。
+- **强制规则**: 任何页面都不允许出现一行 3 个卡片的情况。(注：除非是类似“商品分类”样式的预览展示，需遵循下文响应式规则)
+
+#### **原因二十七：响应式预览网格布局 (装饰/设计模块规范)**
+
+- **现象**: 在小屏下预览手机模型重叠或在大屏下留白过多。
+- **解决方案**:
+  1. 使用 `display: grid` 代替 `flex-wrap`。
+  2. **三段式响应式**:
+     - `> 1250px`: `grid-template-columns: repeat(3, 1fr);` (一行 3 个)
+     - `700px ~ 1250px`: `grid-template-columns: repeat(2, 1fr);` (一行 2 个)
+     - `< 700px`: `grid-template-columns: 1fr;` (一行 1 个)
+  3. **Case Study**: `pages/mall/admin/decoration/category.uvue` (商品分类) 采用了此标准实现 1:1 视觉复刻。
+
+#### **原因十三：侧边栏响应式断点与 Overlay 冲突 (严重体验红线)**
+
+- **现象**: 在 770px~1005px 宽度下，侧边栏遮挡内容，或内容区没有正确让出空间。
+- **原因**:
+  1. 断点逻辑不统一：`main` 布局计算与组件显隐逻辑使用了不同的宽度阈值。
+  2. 动画不匹配：内容区 `margin-left` 动画时长与侧栏 `transform` 时长不一致。
+  3. 状态残留：跨断点时没有强制重置 Overlay 状态。
+- **1:1 复刻 CRMEB 解决方案**:
+  1. **明确三段断点策略**:
+     - **Desktop (>=1200px)**: `aside=dock`, `subSider=dock` (如果开启)。`mainLeft = 270px`。
+     - **Tablet (768px-1199px)**: `aside=dock`, `subSider=overlay` (带 mask)。`mainLeft = 70px`。
+     - **Mobile (<768px)**: `aside=overlay`, `subSider=overlay`。`mainLeft = 0px`。
+  2. **统一状态机**: 使用 `layoutMode` (desktop/tablet/mobile) 驱动所有组件渲染，而非散乱的媒体查询。
+  3. **计算属性驱动布局**: `mainLeft` 必须严格根据 `layoutMode` 和 `subSider` 的 Dock/Overlay 属性动态计算。
+  4. **跨断点清理**: 在 `onWindowResize` 监听到模式切换时，立即强制关闭所有 Overlay (mask=false)，防止残影遮挡。
+  5. **指针事件隔离**: 隐藏态侧栏必须显式设置 `pointer-events: none` 和 `visibility: hidden`。
+
+#### **原因十四：KPI 统计概况列数不一致 (CRMEB 像素级规范)**
+
+- **现象**: 统计概况在大屏下显示 4 列或 5 列，导致无法一行平铺 6 个核心指标。
+- **解决方案 (6-2-1 规则)**:
+  1. 使用全局类 `.kpi-grid-6` 实现专用的统计概况布局。
+  2. **强制断点**:
+     - `> 1200px`: 固定 6 列 (`repeat(6, minmax(0, 1fr))`)。
+     - `768px - 1199.98px`: 固定 2 列。
+     - `< 768px`: 固定 1 列。
+  3. **侧栏联动**: 当 `viewport < 768px` 时，布局容器必须切换到移动端模式（主侧栏变为 Overlay，mainLeft 归零），确保 1 列布局拥有最大水平空间。
+
+#### **原因十五：ECharts 图表响应式裁切与视觉偏位**
+
+- **现象**: 窗口缩小时饼图被砍掉一半，或在大屏下视觉不居中、底部不对齐。
+- **原因**:
+  1. 使用了固定高度（如 `height: 521px`）而没有弹性容器。
+  2. ECharts 的 `center` 和 `radius` 使用了静态百分比或固定像素，无法适配极端宽高比。
+  3. 仅依赖 `window.resize` 而没有监听“容器级”尺寸变化（如侧边栏折叠导致的局部宽度变化）。
+- **解决方案**:
+  1. **容器加固**: 移除根组件固定高度，改用 `min-height`；卡片内容区设置 `overflow: visible` 防止裁切。
+  2. **像素级算法**: 禁止在 `option` 中直接硬编码 `['50%', '60%']`，应计算：`outerRadius = min(w, h) * 0.38`，`centerY = legendSpace + (h - legendSpace) / 2`。
+  3. **双重自适应**:
+     - **底层**: 使用 `ResizeObserver` 监听容器级 DOM 变化。
+     - **上层**: 监听 `store` 中的侧边栏状态，在动画结束后强制触发 `refreshSize()`。
+  4. **文字同步**: 中间文字（total-value）必须通过 `computed` 样式与饼图中心点像素级同步。
+  5. **架构建议**: 在 UTS 环境下，涉及 ECharts 等需要向 RenderJS 传递复杂 Object 的组件，**优先使用 Options API**。Options API 在处理 `toPlainObject` 转换及 Prop 传递时具备更稳定的兼容性，可避免 `script setup` 下可能出现的对象元数据干扰。
+
+#### **原因十六：ECharts 响应式失效与百分比布局规范**
+
+- **现象**: 侧边栏折叠时图表不缩小导致溢出，或在不同宽高比下圆环变形/裁切。
+- **原因**:
+  1. 使用了固定的像素值定义 `radius` 和 `center`。
+  2. 容器高度依赖父级 `flex` 且未设置 `min-height`，导致某些极端高度下被折叠。
+  3. 缺乏对动画中间态的捕获。
+- **强制解决方案 (Web/uni-app-x)**:
+  1. **百分比优先**: `radius` 必须使用百分比（如 `['55%', '75%']`），`center` 必须使用百分比。
+  2. **高度钳制**: 容器使用 `height: clamp(...)` 或固定高度（如 `520px`）+ `min-height`。
+  3. **全链路 Resize**:
+     - `ResizeObserver` 监听 DOM 容器变化。
+     - `transitionend` 监听侧边栏动画结束。
+     - `watch` 监听全局布局状态（`layoutMode` / `collapsed`）。
+  4. **裁切隔离**: 所有祖先容器、`ec-wrap`、`ec-canvas` 必须显式设置 `overflow: visible !important`。
+
+#### **原因十七：ECharts 画布溢出与容器约束 (Containing Block 丢失)**
+
+- **现象**: `ec-canvas` (uni-view) 拥有极大的 `width/height` (如 948px) 且 `position: absolute`，但脱离了父级卡片，溢出到整个页面，且图表内容消失。
+- **原因**:
+  1. **层叠上下文丢失**: `ec-canvas` 的父组件或 `EChartsView` 根节点未设置 `position: relative`，导致 absolute 元素相对于 `body` 定位。
+  2. **尺寸初始化瓶颈**: 在父容器高度为 0 (如 `flex` 自动压缩) 或动画中间态初始化 ECharts，导致内部 `canvas` 宽高计算错误。
+- **强制解决方案**:
+  1. **修正 Containing Block (Step 1)**:
+     - 容器(`chart-wrap`)必须显式设置 `position: relative !important`。
+     - 使用 `:deep()` 强制约束子组件：`.ec-wrap { position: relative; } .ec-canvas { position: absolute; inset: 0; width: 100% !important; height: 100% !important; }`。
+  2. **确定性高度策略 (Step 2)**:
+     - 图表容器禁止高度塌陷。使用 `height: clamp(min, preferred, max)` 或固定高度。
+     - 示例：`height: clamp(280px, 40vh, 450px); min-height: 280px;`。
+  3. **Resize 闭环链路 (Step 3)**:
+     - 禁止使用 `setTimeout` 盲猜。
+     - 必须使用 `ResizeObserver` 监听 `chart-wrap` 尺寸变化。
+     - 必须监听 `sidebar` 的 `transitionend` 事件，确保侧边栏动画结束后的布局稳定。
+     - 统一使用 `requestAnimationFrame(() => chart.resize())` 确保在下一次重绘前完成布局对齐。
+  4. **百分比布局 (Step 4)**:
+     - `series.pie` 的 `radius` 和 `center` 必须使用百分比形式，杜绝 px 导致的自适应失败。
+
+#### **原因十八：CRMEB 响应式断点与图表重构规范 (1:1 复刻)**
+
+- **现象**: 在 1200px 断点切换时布局生硬，图表在单列模式下比例过小或中心偏移。
+- **解决方案**:
+  1. **Grid 布局容器**: 容器页面必须使用 CSS Grid 定义 `grid-template-columns: 2fr 1fr` (>=1200) 和 `1fr` (<1200)，避免 flex 宽度计算误差。
+  2. **外部图例隔离**: 为保证 ECharts 渲染空间的确定性，禁止使用内置 `legend`。改为 `flex-direction: row` 的外部 `legend-col`，确保左上角图例与右侧饼图互不干扰。
+  3. **确定性中心同步**:
+     - ECharts `center` 设置为 `['50%', '50%']`。
+     - 中心文字组件使用绝对定位 `top:50%; left:50%; transform:translate(-50%,-50%)` 实现物理像素级对齐。
+  4. **两档响应式高度**:
+     - `chart-col` 在桌面端 (>=1200) 使用中等高度 (约 320-360px)。
+     - 在移动端/窄屏 (<1200) 自动扩展为大高度 (约 500-600px)，以匹配全宽展示的视觉张力。
+
+#### **原因十九：布局组件依赖缺失导致的级联加载失败**
+
+- **现象**: 控制台报 `GET http://.../AdminLayout.uvue?import net::ERR_CACHE_READ_FAILURE` 或 `TypeError: Failed to fetch dynamically imported module`。
+- **原因**: 核心布局组件（如 `AdminLayout.uvue`）在 `<script setup>` 中使用了 `watch`、`computed` 或其他 Vue API 但**未在顶部 import**。这会导致 JavaScript 语法解析错误，使整个模块加载失败。由于它是所有页面的父容器，会导致全站白屏且报错信息具有误导性（看似网络错误，实为语法错误）。
+- **解决方案**:
+  1. 检查所有在 `setup` 块中使用的 Vue API 是否已显式导入：`import { ref, computed, watch, onMounted } from 'vue'`。
+  2. 使用浏览器的 Network 面板查看失败的 `.uvue?import` 请求详情，查看看具体的语法错误堆栈。
+
+#### **原因二十：UVUE 组件导入路径不规范与生命周期误用**
+
+- **现象**: 页面显示正常但控制台抛出 `Unhandled error during execution of async component loader` 或 `onLoad is not defined`。
+- **原因**:
+  1. **路径缺失后缀**: 在 UVUE 全局构建环境下，导入自定义 `.uvue` 组件必须显式包含 `.uvue` 后缀。
+  2. **生命周期冲突**: 在 `<script setup>` 语法糖中直接编写 `onLoad(() => {})` 而未从 `@dcloudio/uni-app` 导入。
+- **解决方案**:
+  1. **强制后缀**: `import AdminLayout from '@/layouts/admin/AdminLayout.uvue'`。
+  2. **规范生命周期**:
+     - 简单初始化建议统一使用 Vue 标准的 `onMounted(() => {})`。
+     - 如需获取页面参数，通过 `getCurrentPages()` 获取当前页面实例的 `options`。
+     - 禁止在 `setup` 顶层直接定义未声明的 `onLoad/onShow`。
+
+#### **原因二十一：Admin 内部路由 DYNAMIC IMPORT 兼容性问题**
+
+- **现象**: 在 Admin 后台切换菜单或打开特定维护页面时，控制台抛出 `TypeError: Failed to fetch dynamically imported module` 或 `ERR_CACHE_READ_FAILURE`。
+- **原因**:
+  1. **环境限制**: 在某些 `uni-app-x` 的 H5 Vite 编译环境下，针对 `.uvue` 文件的动态 `import()` 支持可能存在不稳定性。
+  2. **语法敏感**: 如果被异步加载的组件本身存在轻微的 UTS/Composition API 语法错误，Vite 的 H5 运行时可能无法正确捕获并提示，而是直接抛出网络加载失败相关的错误。
+- **解决方案**:
+  1. **转为静态导入**: 在 `adminComponentMap.uts` 顶部使用静态 `import` 导入所有管理端子页面组件。
+  2. **组件映射**: 维护 `componentMap` 为静态 Map，避免在运行时使用 `defineAsyncComponent`，从而提高页面的加载成功率和抗语法错误风险。
+
+#### **原因二十二：Tab 切换高度抖动 (Tab Switching Height Jitter)**
+
+- **现象**: 在包含多标签切换的配置页面中，切换不同标签时，由于内容块高度差异较大，导致整个容器或页面产生明显的跳动/收缩。
+- **原因**: 每个 `v-if` 或 `v-show` 对应的内容高度不一致，且父容器没有设置 `min-height` 进行视觉对齐。
+- **解决方案**: 为切换内容的公共父容器（如 `.config-body` 或 `.tab-content`）设置一个统一的 `min-height`（推荐 400px - 600px 之间，视表单复杂度而定），确保最矮的标签页下仍能撑开容器。
+
+#### **原因二十三：循环依赖导致的 500 错误 (Circular Dependency & AdminLayout)**
+
+- **现象**: 浏览器报 `500 Internal Server Error`，控制台显示 `Failed to fetch dynamically imported module` 或 `net::ERR_ABORTED`。
+- **原因**: 核心布局组件 `AdminLayout.uvue` 导入了 `adminComponentMap.uts`（用于动态渲染子页面），而子页面内部又通过 `import AdminLayout` 引用了布局组件。这种循环依赖在 Vite/UTS 环境下会导致整个加载链路崩溃。
+- **解决方案**:
+  1. 所有在 `adminComponentMap.uts` 中注册的**子页面**（Sub-pages），**严禁**在 `<template>` 中包裹 `<AdminLayout>`，也**严禁**在 `<script>` 中 `import AdminLayout`。
+  2. 布局由主入口统一提供，子页面只需编写内容区的 `<view>`。
+  3. **例外**: 仅当某个页面是独立存在的（例如登录页、引导页），且需要独立布局时，才允许自行包装。
+
+#### **原因二十四：ECharts 图表不显示与容器高度塌陷 (Grid/Flex 嵌套陷阱)**
+
+- **现象**: 页面加载后饼图/折线图区域空白，且高度为 0，或仅显示为一条细线；Grid 布局中左右卡片高度不一致（左高右低或反之）。
+- **原因**:
+  1. **Grid 子项默认行为**: CSS Grid 的直接子项 (`.gender-col`) 默认是 `display: block`。若其内部卡片 (`.gender-card`) 设置了 `height: 100%`，在某些浏览器或特定嵌套层级下，如果父级没有显式高度（仅由兄弟元素撑开），`100%` 无法正确计算，导致高度塌陷。
+  2. **Canvas 依赖**: ECharts 的 Canvas 依赖父容器的实际像素高度。如果初始化时父容器高度为 0（因 Flex 压缩或加载时序），Canvas 就会渲染成 0x0。
+  3. **Margin 干扰**: 左侧卡片 (`AnalyticsUserMapTable`) 原本带有 `margin-bottom: 16px`。在 Grid 布局(`align-items: stretch` 默认)中，Grid Cell 的高度包含了这个 Margin。这导致左侧卡片的 _可见背景区域_ 比右侧卡片 _矮_ 了 16px（因为 Margin 是透明的），视觉上顶部对齐但底部不对齐。
+- **解决方案**:
+  1. **Grid 子项 Flex 化**:
+     ```css
+     .map-col,
+     .gender-col {
+       min-width: 0;
+       display: flex; /* 关键：启用 Flex 上下文 */
+       flex-direction: column; /* 确保子元素垂直填充 */
+     }
+     ```
+     这样 Grid Cell 变为 Flex Container，其子元素 (`.gender-card`) 的 `height: 100%` 或 `flex: 1` 就能正确基于 Grid Cell 的最终高度进行计算。
+  2. **移除组件级 Margin**: Grid 布局应使用 `gap` 属性控制间距，组件自身 (`.user-map-card`) 不应自带外部 Margin，否则会破坏等高计算。
+  3. **强制 Canvas 填充**: 图表组件容器需设置 `width: 100% !important; height: 100% !important;` 且 `position: absolute` (配合父级 relative) 或 `flex: 1`，确保填满 Flex 空间。
+
+#### **原因二十五：uni-app x 悬停菜单功能失效 (鼠标事件兼容性)**
+
+- **现象**: `@mouseenter` 和 `@mouseleave` 事件完全无响应，悬停菜单不显示；控制台显示状态变化但菜单不可见或定位错误；鼠标悬停在蓝色方格功能按钮上无任何反应。
+- **根本原因**:
+  1. **平台条件编译缺失**: uni-app x 对鼠标事件有特殊处理机制，所有 `@mouseenter/@mouseleave` 的处理函数必须包装在 `#ifdef H5` 条件编译中才能生效，直接编写的代码会被平台忽略。
+  2. **CSS 定位兼容性**: 使用 `top: 100%` 百分比定位在 uni-app x 中计算不准确，导致菜单定位错误或不可见。
+  3. **容器设置不当**: 缺少 `height: 100%` 和 `overflow: visible` 设置，导致悬停检测区域不完整或菜单被裁切。
+- **对比分析**: 参考 `AdminHeader.uvue` 中工作正常的个人信息悬停菜单实现，发现以下关键差异：
+
+  ```javascript
+  // ❌ 错误写法 - 不工作
+  function handleFunctionMenuOver(e: any): void {
+    functionMenuVisible.value = true // 直接执行，被 uni-app x 忽略
+  }
+
+  // ✅ 正确写法 - 工作
+  function handleFunctionMenuOver(e: any): void {
+    // #ifdef H5
+    functionMenuVisible.value = true // 包装在条件编译中才生效
+    // #endif
+  }
+  ```
+
+- **完整解决方案**:
+  1. **添加条件编译** (最关键):
+     ```javascript
+     function handleFunctionMenuOver(e: any): void {
+       // #ifdef H5
+       if (hideFunctionMenuTimer !== null) {
+         clearTimeout(hideFunctionMenuTimer as number)
+         hideFunctionMenuTimer = null
+       }
+       functionMenuVisible.value = true
+       // #endif
+     }
+     ```
+  2. **修复 CSS 定位**:
+     ```css
+     .function-menu {
+       position: absolute;
+       top: 44px; /* 使用固定像素值，44px是tags容器高度 */
+       right: 0;
+       overflow: visible; /* 确保菜单不被裁切 */
+     }
+     ```
+  3. **优化容器设置**:
+     ```css
+     .function-btn-wrapper {
+       height: 100%; /* 确保悬停不中断，仿照AdminHeader */
+       overflow: visible;
+     }
+     ```
+  4. **统一定时器延迟**: 所有定时器延迟设置为 150ms，与 AdminHeader 保持一致。
+- **推广规则**:
+  1. uni-app x 中的所有鼠标事件处理必须包装在 `#ifdef H5` 中。
+  2. 悬停菜单定位优先使用固定像素值而非百分比。
+  3. 容器必须设置正确的 `height` 和 `overflow` 属性。
+  4. 成功的悬停菜单实现应该作为模板复用到其他组件。
+
+#### **原因二十六：假分页（全量加载 + 前端 slice）导致性能浪费与计数错误**
+
+- **现象**: 页面翻页正常，但 Network 面板显示每次进入页面只发一次请求；`total` 显示的数量与数据库实际行数不符（偏少）；切换到第 2 页后数据消失或 `total` 突然跳变。
+- **根本原因**:
+  1. `fetchUsers()` 没有传入 `limit/offset` 参数，一次性拉取所有记录到前端内存。
+  2. `pagedList` 通过 `computed(() => userList.value.slice(start, end))` 实现，是纯前端裁切。
+  3. `total` 为 `computed(() => userList.value.length)`，反映的是当次拉取的行数，而非数据库真实总行数。
+  4. 翻页 handler 仅更新 `currentPage.value`，没有重新 `fetchUsers()`，所以只有第一次加载时才有网络请求。
+- **识别特征（自查清单）**:
+  ```
+  ❌ pagedList = computed(() => userList.value.slice((page-1)*ps, page*ps))
+  ❌ total = computed(() => userList.value.length)
+  ❌ 翻页 handler 只做 currentPage.value = p，没有 fetchUsers()
+  ❌ select() 调用没有 limit/offset 参数
+  ```
+- **正确实现（服务端分页模板）**:
+  ```typescript
+  // ✅ state
+  const total = ref(0)          // 来自服务端，不是 .length
+  const pagedList = computed(() => userList.value)  // 无前端 slice，服务端已分页
+
+  // ✅ fetch：每次翻页都重新请求
+  const fetchUsers = async (page: number, ps: number) => {
+    const offset = (page - 1) * ps
+    const offsetFilter = offset > 0 ? `offset=${offset}` : null
+    const res = await supabase.select('table', offsetFilter, {
+      limit: ps, order: 'created_at.desc', count: 'exact'
+    })
+    userList.value = (res.data as UTSJSONObject[]).map(mapDbRow)
+    // 从 Content-Range 头解析总数（见原因二十八）
+    total.value = parseTotalFromContentRange(res)
+  }
+
+  // ✅ 翻页 handler：每次翻页都调用 fetch
+  const handlePageChange = (p: number) => {
+    currentPage.value = p
+    fetchUsers(p, pageSize.value)
+  }
+
+  onMounted(() => fetchUsers(1, pageSize.value))
+  ```
+- **强制规则**: 任何使用 Supabase 的列表页面，`total` 必须来自后端 `Content-Range` 响应头或 `res.count`，严禁使用 `computed(() => localArray.value.length)` 作为总数。
+
+#### **原因二十七（补充）：已在另一位置记录（响应式预览网格）**
+
+> 此编号已被响应式预览网格布局条目占用，见本文件第 37 行附近。
+
+#### **原因二十八：aksupa `.page().limit()` 触发 Range 头，导致 PostgREST 416 错误**
+
+- **现象**: 首页（第 1 页）加载正常，翻到第 2 页后浏览器控制台立刻出现 `416 Range Not Satisfiable`，数据消失或显示错误状态；即使页面 UI 上的"下一页"按钮已禁用，错误仍然出现。
+- **根本原因**:
+  1. aksupa（自定义 PostgREST 封装）的 `.page(n).limit(ps)` 链式调用内部会计算 `rangeFrom = (n-1)*ps`、`rangeTo = n*ps-1`，然后把这两个值注入到 HTTP 请求头 `Range: bytes=rangeFrom-rangeTo`（或 PostgREST 格式的 Content-Range 请求头）中。
+  2. PostgREST 遵循 HTTP Range 协议规范：只要 `rangeFrom >= total`（即请求的起始偏移 >= 数据库总行数），**必须返回 416**，这是协议强制行为，不是可配置的。
+  3. UI 层的"禁用"保护（`if (p > totalPage) return`）在 `total` 来自错误来源时本身就不可靠（见原因二十六），因此无法阻止越界请求。
+  4. 即使 UI 保护正确，在数据量恰好是页大小整数倍时（如共 15 条、每页 15 条），请求第 2 页仍会触发 416（`rangeFrom=15 >= total=15`）。
+- **错误修复思路（踩坑路径）**:
+  ```
+  ❌ 第一轮尝试：在 handlePageChange / onPageBtnClick 中加 if (p > totalPage) return
+  结果：仍然 416。因为 UI 保护只能拦截按钮点击，无法修复协议层行为。
+  
+  ❌ 第二轮尝试：在 fetchUsers 中加 if (res.status === 416) { ... } 分支处理
+  结果：错误被吞但数据仍为空，用户体验差，根本原因未消除。
+  ```
+- **正确修复方案**:
+  ```typescript
+  // ❌ 禁止使用 Range 头分页
+  const res = await supabase
+    .from('ak_users')
+    .select(columns)
+    .page(page)       // ← 产生 Range 头
+    .limit(pageSize)  // ← 产生 Range 头
+    .execute()
+
+  // ✅ 使用 URL 参数分页（永远不返回 416）
+  const offset = (page - 1) * ps
+  const offsetFilter = offset > 0 ? `offset=${offset}` : null
+  const res = await supabase.select('ak_users', offsetFilter, {
+    columns: 'id, username, ...',
+    limit: ps,
+    order: 'created_at.desc',
+    count: 'exact'    // → Prefer: count=exact → 响应包含 Content-Range: 0-14/26
+  })
+  // PostgREST 对 ?offset=N&limit=N 参数：offset 超出 total 时返回 200 + 空数组，绝不 416
+  ```
+- **总数解析（Content-Range 手动解析）**:
+  ```typescript
+  // 当 aksupa 使用 count: 'exact' 时，响应头会包含 Content-Range: 0-14/26
+  // 必须手动解析，因为绕过了 .page().limit() 的自动汇总逻辑
+  const parseTotal = (res: AkReqResponse): number => {
+    const cr = (res.headers?.['content-range'] ?? res.headers?.['Content-Range']) as string | null
+    if (cr) {
+      const slash = cr.lastIndexOf('/')
+      if (slash !== -1) {
+        const n = parseInt(cr.substring(slash + 1), 10)
+        if (!isNaN(n)) return n
+      }
+    }
+    // 降级：至少知道 offset + 当前页行数
+    return offset + (res.data as UTSJSONObject[]).length
+  }
+  total.value = parseTotal(res)
+  ```
+- **强制规则**:
+  1. **项目内所有列表页禁止使用 `.page().limit()` 链式调用**（aksupa 或其他类似封装）。
+  2. 分页必须使用 `offset=N` URL 参数注入方式。
+  3. 总数必须从 `Content-Range` 响应头解析，不可用本地数组长度代替。
+  4. RLS 注意：`ak_users` 表默认只允许 `auth.uid() = id`（自读）。Admin 页面需要额外添加 `service_role` 或管理员角色的 RLS 策略，否则即使分页正确，数据也会为空。
+
+#### **原因二十九：CommonPagination `disabled` 状态仅为 CSS 装饰，边界点击仍会触发**
+
+- **现象**: 在第 1 页时点击"上一页"按钮，或在最后一页时点击"下一页"按钮，虽然按钮视觉上呈灰色/禁用态，但仍会向父组件 `emit('page-change', 0)` 或 `emit('page-change', totalPage+1)`，导致 `fetchUsers(0, ps)` 被调用、产生 `offset=-ps`（负数），请求异常。
+- **根本原因**: `disabled` class 仅控制 CSS 样式（`opacity`、`cursor: not-allowed`），没有在事件处理函数中加入边界检查，点击事件照常触发和冒泡。
+- **修复方案**:
+  ```typescript
+  // CommonPagination.uvue — onPageBtnClick
+  // ❌ 修复前：直接 emit，无边界保护
+  const onPageBtnClick = (p: number) => {
+    if (p !== -1) emit('page-change', p)
+  }
+
+  // ✅ 修复后：加入 p >= 1 && p <= props.totalPage 双向边界检查
+  const onPageBtnClick = (p: number) => {
+    if (p !== -1 && p >= 1 && p <= props.totalPage) {
+      emit('page-change', p)
+    }
+  }
+  ```
+- **父页面的双重保护（纵深防御）**:
+  ```typescript
+  // 在 handlePageChange 中同样加入边界检查，防止其他调用路径绕过组件保护
+  const handlePageChange = (p: number) => {
+    if (p < 1 || p > totalPage.value) return
+    currentPage.value = p
+    fetchUsers(p, pageSize.value)
+  }
+  ```
+- **推广规则**:
+  1. 任何分页组件，`disabled` 状态必须同时在 CSS **和**事件处理函数两层保护，视觉禁用 ≠ 逻辑禁用。
+  2. 父组件的翻页 handler 应做二次校验，实现纵深防御。
+  3. `fetchUsers` 的 `offset` 计算前应确保 `page >= 1`，避免负数 offset 进入请求。
+
+## 🛠️ 完整修复流程
+
+```
+[plugin:uni:h5-pages-json] 页面"minimal"不存在，请确保填写的页面路径不包含文件后缀，且必须与真实的文件路径大小写保持一致。
+```
+
+```
+SyntaxError: The requested module '.../vue.runtime.esm.js' does not provide an export named 'onLoad'
+```
+
+### 2. 根本原因总结
+
+#### **原因一：pages.json 路径配置错误**
+
+- **错误格式**: `"path": "pages/minimal"` (主页面缺少完整路径)
+- **错误格式**: `"path": "pages/mall/admin/index"` (主页面错误包含完整路径)
+- **错误格式**: 子包路径配置不完整
+
+#### **原因二：AdminLayout 组件语法错误**
+
+- **重复闭合标签**: `<script>` 标签重复闭合
+- **生命周期导入错误**: 从 Vue 导入 uni-app 生命周期钩子
+
+#### **原因三：页面跳转路径格式不一致**
+
+- **错误格式**: `url: 'pages/mall/admin/user-management'` (缺少前缀 `/`)
+- **错误格式**: `url: '/pages/mall/admin/user-management'` (某些情况下不适用)
+
+#### **原因四：组件依赖和导入问题**
+
+- AdminLayout 组件未正确导入
+- 类型定义缺失
+- 响应式数据使用错误
+
+#### **原因五：特殊字符解析错误**
+
+- **Emoji 字符兼容性**: uni-app-x 模板解析器对某些 emoji 字符支持不完整
+- **Unicode 符号问题**: 某些特殊 Unicode 符号可能导致 "Invalid end tag" 编译错误
+- **字符编码问题**: 文件编码或不可见字符可能影响模板解析
+
+#### **原因六：缩进不一致错误**
+
+- **混合缩进**: 同一文件中混用制表符和空格缩进
+- **不一致的结束标签**: 开始标签和结束标签使用不同的缩进方式
+- **Vue 解析器敏感性**: Vue 模板解析器对缩进不一致特别敏感
+
+#### **原因七：方法调用错误**
+
+- **方法重命名**: 重构时方法名改变但模板中未更新引用
+- **未定义方法**: 模板中调用不存在的方法
+- **参数不匹配**: 方法调用时的参数与定义不一致
+
+#### **原因八：自闭合标签错误**
+
+- **错误格式**: 使用 `></tag>` 而不是 `/>` 结束自闭合标签
+- **Vue 规范**: 自闭合标签必须使用 `/>` 结尾
+- **编译器敏感**: uni-app-x 对标签格式要求严格
+
+#### **原因九：模态框嵌套问题**
+
+- **条件嵌套**: 模态框被放在条件渲染内部，可能导致显示异常
+- **作用域限制**: 模态框应该在所有条件外部，全局可用
+- **层级问题**: 模态框需要最高层级显示，不应受页面模式影响
+
+#### **原因十：.uvue文件特殊字符兼容性**
+
+- **UTS编译器敏感性**: uni-app-x的.uvue文件对特殊字符更敏感
+- **Unicode符号解析**: 某些Unicode符号可能导致UTS编译器解析失败
+- **文件复杂度**: 复杂的模板结构可能超出UTS编译器的处理能力
+
+#### **原因五：特殊字符解析错误**
+
+- **Emoji 字符问题**: uni-app-x 模板解析器对某些 emoji 字符支持不完整
+- **Unicode 字符**: 某些特殊 Unicode 符号可能导致 "Invalid end tag" 错误
+- **不可见字符**: BOM 或其他不可见字符可能影响模板解析
+
+## 🛠️ 完整修复流程
+
+### **阶段一：基础配置简化**
+
+#### **步骤 1.1：创建最小可用配置**
+
+```json
+// pages.json - 最简配置
+{
+  "pages": [
+    {
+      "path": "pages/minimal",
+      "style": {
+        "navigationBarTitleText": "最小测试"
+      }
+    }
+  ]
+}
+```
+
+**验证**: 确保基础页面能够正常编译和显示。
+
+#### **步骤 1.2：验证文件完整性**
+
+```bash
+# 检查页面文件是否存在
+pages/minimal.uvue ✅
+pages/mall/admin/index.uvue ✅
+pages/mall/admin/user-management.uvue ✅
+```
+
+### **阶段二：AdminLayout 组件修复**
+
+#### **步骤 2.1：修复语法错误**
+
+```vue
+<!-- 错误：重复的 </script> 标签 -->
+<script setup lang="uts">
+import { ref, computed } from 'vue'
+// ... 代码 ...
+</script>
+</script> <!-- ❌ 多余的闭合标签 -->
+
+<!-- 正确 -->
+<script setup lang="uts">
+import { ref, computed } from 'vue'
+// ... 代码 ...
+</script>
+```
+
+#### **步骤 2.2：修复生命周期导入**
+
+```javascript
+// ❌ 错误：从 Vue 导入 uni-app 生命周期
+import { ref, computed, onLoad } from "vue";
+
+// ✅ 正确：uni-app-x 生命周期全局可用
+import { ref, computed } from "vue";
+
+// 在组件中直接使用
+onLoad(() => {
+  activeMenu.value = props.currentPage;
+});
+```
+
+#### **步骤 2.3：验证组件结构**
+
+```vue
+<template>
+  <view class="admin-layout">
+    <!-- 侧边栏 -->
+    <view class="admin-sidebar">
+      <!-- 菜单列表 -->
+    </view>
+
+    <!-- 主内容区 -->
+    <view class="main-container">
+      <!-- 页面头部 -->
+      <!-- 页面内容 -->
+      <slot></slot>
+    </view>
+  </view>
+</template>
+```
+
+### **阶段三：页面配置恢复**
+
+#### **步骤 3.1：恢复主页面配置**
+
+```json
+{
+  "pages": [
+    {
+      "path": "pages/minimal",
+      "style": {
+        "navigationBarTitleText": "最小测试"
+      }
+    },
+    {
+      "path": "pages/mall/admin/index",
+      "style": {
+        "navigationBarTitleText": "管理后台",
+        "navigationStyle": "custom"
+      }
+    }
+  ]
+}
+```
+
+#### **步骤 3.2：恢复子包配置**
+
+```json
+{
+  "subPackages": [
+    {
+      "root": "pages/mall",
+      "pages": [
+        {
+          "path": "admin/user-management",
+          "style": {
+            "navigationBarTitleText": "用户管理",
+            "navigationStyle": "custom"
+          }
+        }
+        // ... 其他页面
+      ]
+    }
+  ]
+}
+```
+
+#### **步骤 3.3：验证完整配置**
+
+```json
+{
+  "pages": [
+    {
+      "path": "pages/minimal",
+      "style": { "navigationBarTitleText": "最小测试" }
+    },
+    {
+      "path": "pages/mall/admin/index",
+      "style": {
+        "navigationBarTitleText": "管理后台",
+        "navigationStyle": "custom"
+      }
+    }
+  ],
+  "subPackages": [
+    {
+      "root": "pages/mall",
+      "pages": [
+        {
+          "path": "admin/user-management",
+          "style": {
+            "navigationBarTitleText": "用户管理",
+            "navigationStyle": "custom"
+          }
+        },
+        {
+          "path": "admin/product-management",
+          "style": {
+            "navigationBarTitleText": "商品管理",
+            "navigationStyle": "custom"
+          }
+        },
+        {
+          "path": "admin/order-management",
+          "style": {
+            "navigationBarTitleText": "订单管理",
+            "navigationStyle": "custom"
+          }
+        },
+        {
+          "path": "admin/finance-management",
+          "style": {
+            "navigationBarTitleText": "财务管理",
+            "navigationStyle": "custom"
+          }
+        },
+        {
+          "path": "admin/system-settings",
+          "style": {
+            "navigationBarTitleText": "系统设置",
+            "navigationStyle": "custom"
+          }
+        }
+      ]
+    }
+  ],
+  "globalStyle": {
+    "navigationBarTextStyle": "black",
+    "navigationBarTitleText": "mall",
+    "navigationBarBackgroundColor": "#FFFFFF",
+    "backgroundColor": "#F8F8F8"
+  }
+}
+```
+
+### **阶段四：路径格式统一**
+
+### **阶段五：特殊字符处理**
+
+#### **步骤 5.1：移除问题 Emoji 字符**
+
+```vue
+<!-- ❌ 问题：某些 emoji 字符可能导致 "Invalid end tag" 错误 -->
+<template>
+  <view class="stats-cards">
+    <view class="stat-card">
+      <view class="stat-icon">👥</view>
+      <!-- 可能导致解析错误 -->
+      <view class="stat-content">
+        <text class="stat-value">{{ totalUsers }}</text>
+        <text class="stat-label">总用户数</text>
+      </view>
+    </view>
+  </view>
+</template>
+
+<!-- ✅ 修复：使用安全字符替代 -->
+<template>
+  <view class="stats-cards">
+    <view class="stat-card">
+      <view class="stat-icon">👤</view>
+      <!-- 使用安全字符 -->
+      <view class="stat-content">
+        <text class="stat-value">{{ totalUsers }}</text>
+        <text class="stat-label">总用户数</text>
+      </view>
+    </view>
+  </view>
+</template>
+```
+
+**常见问题 Emoji 及替代方案**:
+
+```javascript
+// 统计图标
+'👥' → '👤'  // 用户数量
+'✅' → '✓'   // 成功/活跃
+'🚫' → '✗'   // 禁用/下架
+'📦' → '□'   // 商品/包裹
+'⏳' → '○'   // 等待/处理中
+'🚚' → '→'   // 配送中
+'⚠️' → '!'   // 警告/库存不足
+
+// 财务图标
+'💰' → '$'   // 收入
+'📈' → '↑'   // 增长
+'📊' → '≡'   // 图表
+'💳' → '■'   // 账户
+```
+
+#### **步骤 5.2：检查文件编码**
+
+```bash
+# 检查文件编码和特殊字符
+file pages/mall/admin/*.uvue
+
+# 确保文件编码为 UTF-8 无 BOM
+# 移除任何不可见字符
+```
+
+#### **步骤 5.3：验证模板语法完整性**
+
+```vue
+<!-- ✅ 确保所有标签正确闭合 -->
+<template>
+  <AdminLayout current-page="user-list">
+    <view class="user-management">
+      <!-- 所有开始标签都有对应的结束标签 -->
+      <view v-if="condition">内容</view>
+      <view v-for="item in items" :key="item.id">
+        {{ item.name }}
+      </view>
+    </view>
+  </AdminLayout>
+</template>
+```
+
+#### **步骤 5.4：最终验证**
+
+### **阶段六：缩进一致性检查**
+
+#### **步骤 6.1：统一缩进方式**
+
+```vue
+<!-- ❌ 错误：混合使用制表符和空格 -->
+<template>
+  <AdminLayout current-page="user-list">
+    <view class="user-management">
+      <!-- 内容 -->
+		</view>  <!-- 制表符缩进 -->
+	  </view>  <!-- 制表符缩进 -->
+	</view>  <!-- 制表符缩进 -->
+  </AdminLayout>
+</template>
+
+<!-- ✅ 正确：统一使用空格缩进 -->
+<template>
+  <AdminLayout current-page="user-list">
+    <view class="user-management">
+      <!-- 内容 -->
+    </view>
+  </AdminLayout>
+</template>
+```
+
+#### **步骤 6.2：检查缩进工具**
+
+```bash
+# 检查文件中是否存在制表符
+grep -P '\t' pages/mall/admin/*.uvue
+
+# 将制表符转换为空格（2个空格）
+sed -i 's/\t/  /g' pages/mall/admin/*.uvue
+```
+
+#### **步骤 6.3：验证标签闭合**
+
+```javascript
+// 检查所有开始标签都有对应结束标签
+// 检查缩进一致性
+// 确保没有多余的闭合标签
+```
+
+#### **步骤 6.4：最终验证**
+
+### **阶段七：方法调用检查**
+
+#### **步骤 7.1：检查方法引用**
+
+```javascript
+// ❌ 错误：方法名已更改但模板未更新
+<template>
+  <button @click="oldMethodName()">按钮</button>
+</template>
+
+// ✅ 正确：更新方法引用
+<template>
+  <button @click="newMethodName()">按钮</button>
+</template>
+```
+
+#### **步骤 7.2：验证方法定义**
+
+```javascript
+// 确保所有模板中引用的方法都已定义
+const newMethodName = () => {
+  // 方法实现
+};
+```
+
+#### **步骤 7.3：检查参数匹配**
+
+```javascript
+// 确保方法调用时的参数与定义一致
+const handleClick = (param: string) => {
+  console.log(param)
+}
+
+// 模板调用
+<button @click="handleClick('value')">按钮</button>
+```
+
+#### **步骤 7.4：最终验证**
+
+### **阶段八：自闭合标签检查**
+
+#### **步骤 8.1：检查自闭合标签格式**
+
+```vue
+<!-- ❌ 错误：错误的结束格式 -->
+<input v-model="value" />
+<image :src="url"></image>
+<!-- 错误 -->
+<checkbox :checked="checked"></checkbox>
+<!-- 错误 -->
+
+<!-- ✅ 正确：标准自闭合格式 -->
+<input v-model="value" />
+<image :src="url" />
+<!-- 正确 -->
+<checkbox :checked="checked" />
+<!-- 正确 -->
+```
+
+#### **步骤 8.2：自动修复工具**
+
+```bash
+# 使用 sed 批量修复（注意备份文件）
+sed -i 's/><\/image>/ \/>/g' pages/mall/admin/*.uvue
+sed -i 's/><\/checkbox>/ \/>/g' pages/mall/admin/*.uvue
+```
+
+#### **步骤 8.3：验证标签完整性**
+
+```javascript
+// 检查所有自闭合标签都正确结束
+// 确保没有多余的结束标签
+```
+
+### **阶段九：模态框位置优化**
+
+#### **步骤 9.1：识别模态框位置问题**
+
+```vue
+<!-- ❌ 错误：模态框嵌套在条件内部 -->
+<template>
+  <view>
+    <view v-if="currentMode === 'list'">
+      <!-- 列表内容 -->
+      <view v-if="showModal" class="modal">
+        <!-- 条件嵌套 -->
+        模态框内容
+      </view>
+    </view>
+  </view>
+</template>
+
+<!-- ✅ 正确：模态框在条件外部 -->
+<template>
+  <view>
+    <view v-if="currentMode === 'list'">
+      <!-- 列表内容 -->
+    </view>
+
+    <!-- 模态框在外部 -->
+    <view v-if="showModal" class="modal"> 模态框内容 </view>
+  </view>
+</template>
+```
+
+#### **步骤 9.2：重构模态框位置**
+
+```vue
+<template>
+  <view class="page-container">
+    <!-- 主要内容区域 -->
+    <view v-if="currentMode === 'list'" class="content">
+      <!-- 内容 -->
+    </view>
+
+    <view v-else-if="currentMode === 'form'" class="content">
+      <!-- 表单 -->
+    </view>
+
+    <!-- 模态框：放在最后，全局可用 -->
+    <Modal v-if="showAddModal" @close="closeModal"> 添加内容 </Modal>
+
+    <Modal v-if="showDeleteModal" @close="closeModal"> 删除确认 </Modal>
+  </view>
+</template>
+```
+
+#### **步骤 9.3：验证模态框行为**
+
+```javascript
+// 确保模态框在所有页面模式下都能正常显示
+// 测试不同条件下的模态框显示
+```
+
+#### **步骤 9.4：最终验证**
+
+### **阶段十：.uvue文件特殊处理**
+
+#### **步骤 10.1：简化复杂模板**
+
+```vue
+<!-- ❌ 复杂模板可能导致UTS编译器问题 -->
+<template>
+  <AdminLayout current-page="user-list">
+    <view class="complex-layout">
+      <!-- 复杂的嵌套结构、大量条件渲染、复杂表达式 -->
+      <view v-if="complexCondition" v-for="item in largeArray">
+        <!-- 大量内容 -->
+      </view>
+    </view>
+  </AdminLayout>
+</template>
+
+<!-- ✅ 简化模板结构 -->
+<template>
+  <AdminLayout current-page="user-list">
+    <view class="simple-layout">
+      <text>简化内容</text>
+    </view>
+  </AdminLayout>
+</template>
+```
+
+#### **步骤 10.2：移除问题Unicode字符**
+
+```vue
+<!-- ❌ .uvue文件中可能导致编译错误的字符 -->
+<view class="icon">✓</view>
+<!-- 对勾符号 -->
+<view class="icon">✗</view>
+<!-- 叉号符号 -->
+<view class="icon">★</view>
+<!-- 星号符号 -->
+
+<!-- ✅ 使用安全字符 -->
+<view class="icon">Y</view>
+<!-- 字母Y -->
+<view class="icon">N</view>
+<!-- 字母N -->
+<view class="icon">*</view>
+<!-- 星号 -->
+```
+
+#### **步骤 10.3：UTS编译器兼容性检查**
+
+```javascript
+// 检查UTS特定的语法要求
+// 确保所有导入和类型定义正确
+// 验证组件Props和事件处理
+```
+
+#### **步骤 10.4：渐进式开发策略**
+
+```javascript
+// 1. 从最小可用模板开始
+const minimalTemplate = `
+<template>
+  <AdminLayout current-page="page">
+    <view class="page">
+      <text>页面内容</text>
+    </view>
+  </AdminLayout>
+</template>
+`;
+
+// 2. 逐步添加功能，每次只添加一个特性
+// 3. 每次修改后立即编译测试
+// 4. 出现问题时立即回滚到上一个稳定版本
+```
+
+#### **步骤 10.5：最终验证**
+
+### **阶段十一：批量.uvue文件修复**
+
+### **阶段十二：AdminLayout双侧边栏布局**
+
+#### **步骤 11.1：识别问题文件**
+
+```bash
+# 检查所有.uvue文件是否正常编译
+# 记录出现"Invalid end tag"错误的文件
+# 按优先级排序修复顺序
+```
+
+#### **步骤 11.2：批量简化模板**
+
+```javascript
+// 为每个问题文件创建最小可用模板
+const minimalTemplates = {
+  "user-management.uvue": `
+<template>
+  <AdminLayout current-page="user-list">
+    <view class="user-management">
+      <text>用户管理</text>
+    </view>
+  </AdminLayout>
+</template>
+
+<script setup lang="uts">
+import { ref } from 'vue'
+import AdminLayout from '@/layouts/admin/index.uvue'
+const currentMode = ref('list')
+</script>
+
+<style>
+.user-management { padding: 20px; }
+</style>
+  `,
+
+  "product-management.uvue": `
+<template>
+  <AdminLayout current-page="product-management">
+    <view class="product-management">
+      <text>商品管理</text>
+    </view>
+  </AdminLayout>
+</template>
+
+<script setup lang="uts">
+import { ref } from 'vue'
+import AdminLayout from '@/layouts/admin/index.uvue'
+const currentMode = ref('list')
+</script>
+
+<style>
+.product-management { padding: 20px; }
+</style>
+  `,
+
+  // 为其他页面创建类似的模板
+};
+```
+
+#### **步骤 11.3：统一字符替换**
+
+```bash
+# 批量替换所有.uvue文件中的问题字符
+find pages/mall/admin -name "*.uvue" -exec sed -i \
+  -e 's/👤/U/g' \
+  -e 's/✓/Y/g' \
+  -e 's/✗/N/g' \
+  -e 's/★/*/g' \
+  -e 's/📦/□/g' \
+  -e 's/⏳/○/g' \
+  -e 's/🚚/→/g' \
+  {} \;
+```
+
+#### **步骤 11.4：验证批量修复**
+
+```javascript
+// 检查所有文件是否正常编译
+// 确认没有"Invalid end tag"错误
+// 测试基本页面导航功能
+```
+
+#### **步骤 11.5：最终验证**
+
+#### **步骤 12.1：设计双侧边栏布局**
+
+```vue
+<!-- ❌ 传统布局：二级菜单在主侧边栏内部 -->
+<template>
+  <view class="admin-layout">
+    <view class="main-sider">
+      <!-- 一级菜单 -->
+      <view class="menu-primary"><!-- ... --></view>
+      <!-- 二级菜单（错误位置） -->
+      <view class="menu-secondary"><!-- ... --></view>
+    </view>
+    <view class="main-content">
+      <!-- 页面内容 -->
+    </view>
+  </view>
+</template>
+
+<!-- ✅ 双侧边栏布局：二级菜单在内容区左侧 -->
+<template>
+  <view class="admin-layout">
+    <!-- 主侧边栏：只显示一级菜单 -->
+    <view class="admin-sider">
+      <view class="menu-primary"><!-- 一级菜单 --></view>
+    </view>
+
+    <!-- 主内容区 -->
+    <view class="admin-main">
+      <!-- 内容侧边栏：显示二级菜单 -->
+      <view class="content-sider" v-if="hasSubMenus">
+        <view class="content-sider-content">
+          <!-- 二级菜单 -->
+        </view>
+      </view>
+
+      <!-- 内容区域 -->
+      <view class="content-area">
+        <!-- 页面内容 -->
+        <slot></slot>
+      </view>
+    </view>
+  </view>
+</template>
+```
+
+#### **步骤 12.2：实现菜单数据结构**
+
+```javascript
+const menuList = ref([
+  {
+    id: "user",
+    title: "用户管理",
+    icon: "icon-user",
+    path: "/pages/mall/admin/user-management",
+    subMenus: [
+      {
+        id: "user-list",
+        title: "用户列表",
+        path: "/pages/mall/admin/user-management",
+      },
+      {
+        id: "user-add",
+        title: "添加用户",
+        path: "/pages/mall/admin/user-management?action=add",
+      },
+    ],
+  },
+  {
+    id: "product",
+    title: "商品管理",
+    icon: "icon-product",
+    path: "/pages/mall/admin/product-management",
+    subMenus: [
+      {
+        id: "product-list",
+        title: "商品列表",
+        path: "/pages/mall/admin/product-management",
+      },
+      {
+        id: "category",
+        title: "商品分类",
+        path: "/pages/mall/admin/product-management?tab=category",
+      },
+    ],
+  },
+  // 没有子菜单的页面
+  {
+    id: "statistics",
+    title: "用户统计",
+    icon: "icon-statistics",
+    path: "/pages/mall/admin/user-statistics",
+  },
+]);
+```
+
+#### **步骤 12.3：计算属性实现**
+
+```javascript
+// 计算当前菜单的子菜单
+const activeSubMenus = computed(() => {
+  const menu = menuList.value.find((m) => m.id === activeMenu.value);
+  return menu ? menu.subMenus || [] : [];
+});
+
+// 判断是否有子菜单
+const hasSubMenus = computed(() => {
+  return activeSubMenus.value.length > 0;
+});
+```
+
+#### **步骤 12.4：菜单点击处理**
+
+```javascript
+const handleMenuClick = (menu: any) => {
+  activeMenu.value = menu.id
+  // 设置默认子菜单（如果有的话）
+  activeSubMenu.value = menu.subMenus && menu.subMenus.length > 0 ? menu.subMenus[0].id : ''
+
+  // 导航到菜单路径
+  uni.navigateTo({
+    url: menu.path
+  })
+}
+
+const handleSubMenuClick = (subMenu: any) => {
+  activeSubMenu.value = subMenu.id
+  // 导航到子菜单路径（可能包含查询参数）
+  uni.navigateTo({
+    url: subMenu.path
+  })
+}
+```
+
+#### **步骤 12.5：样式实现**
+
+```scss
+/* 主侧边栏 */
+.admin-sider {
+  width: 200px;
+  background-color: #001529;
+  position: fixed;
+  left: 0;
+  top: 0;
+  bottom: 0;
+  z-index: 1000;
+}
+
+/* 主内容区 */
+.admin-main {
+  margin-left: 200px;
+  display: flex;
+  min-height: 100vh;
+}
+
+/* 内容侧边栏 */
+.content-sider {
+  width: 180px;
+  background-color: #ffffff;
+  border-right: 1px solid #e8e8e8;
+  box-shadow: 2px 0 8px rgba(0, 0, 0, 0.06);
+}
+
+.content-sub-menu-item {
+  height: 36px;
+  padding: 0 16px;
+  cursor: pointer;
+  transition: all 0.2s;
+
+  &.active {
+    background-color: #e6f7ff;
+    color: #1890ff;
+    border-right: 2px solid #1890ff;
+  }
+}
+
+/* 内容区域 */
+.content-area {
+  flex: 1;
+  background-color: #f0f2f5;
+}
+```
+
+#### **步骤 12.6：响应式设计**
+
+```scss
+@media (max-width: 768px) {
+  .admin-sider {
+    width: 160px;
+  }
+
+  .admin-main {
+    margin-left: 160px;
+  }
+
+  .content-sider {
+    width: 140px;
+  }
+}
+```
+
+#### **步骤 12.7：最终验证**
+
+### **阶段十三：AdminLayout代码清理**
+
+#### **步骤 13.1：移除遗留变量引用**
+
+```javascript
+// ❌ 错误：引用已删除的变量
+const handleMenuClick = (menu: any) => {
+  activeMenu.value = menu.id
+  // 引用不存在的 tabs 变量
+  const existingTab = tabs.value.find(tab => tab.id === menu.id)
+  // ...
+}
+
+// ✅ 修复：移除所有遗留引用
+const handleMenuClick = (menu: any) => {
+  activeMenu.value = menu.id
+  activeSubMenu.value = menu.subMenus?.[0]?.id || ''
+
+  uni.navigateTo({ url: menu.path })
+}
+```
+
+#### **步骤 13.2：检查计算属性完整性**
+
+```javascript
+// 确保所有模板中使用的属性都已定义
+const activeSubMenuTitle = computed(() => {
+  const subMenu = activeSubMenus.value.find(sm => sm.id === activeSubMenu.value)
+  return subMenu ? subMenu.title : ''
+})
+
+// 模板中使用
+<text v-if="activeSubMenuTitle">{{ activeSubMenuTitle }}</text>
+```
+
+#### **步骤 13.3：验证模板依赖**
+
+```vue
+<!-- 检查模板中使用的所有变量和方法 -->
+<template>
+  <!-- 确保这些属性都已定义 -->
+  <view v-if="activeSubMenus.length > 0">
+    <text>{{ activeMenuTitle }}</text>
+    <text>{{ activeSubMenuTitle }}</text>
+  </view>
+</template>
+```
+
+#### **步骤 13.4：最终验证**
+
+### **阶段十二：AdminLayout组件解析修复**
+
+#### **步骤 12.1：检查组件导入路径**
+
+```javascript
+// ❌ 错误：缺少文件扩展名
+import AdminLayout from "@/layouts/admin/index";
+
+// ❌ 错误：路径不存在
+import AdminLayout from "@/layout/admin/index.uvue";
+
+// ✅ 正确：完整路径包含扩展名
+import AdminLayout from "@/layouts/admin/index.uvue";
+```
+
+#### **步骤 12.2：简化组件结构**
+
+```vue
+<!-- ❌ 复杂组件结构 -->
+<template>
+  <view class="complex-layout">
+    <!-- 大量嵌套、条件渲染、事件处理 -->
+    <view v-if="condition" v-for="item in items">
+      <!-- 复杂内容 -->
+    </view>
+  </view>
+</template>
+
+<!-- ✅ 简化组件结构 -->
+<template>
+  <view class="simple-layout">
+    <slot></slot>
+  </view>
+</template>
+
+<script setup lang="uts">
+const props = defineProps<{
+  currentPage: string
+}>()
+</script>
+```
+
+#### **步骤 12.3：验证组件可用性**
+
+```javascript
+// 在页面中正确使用组件
+<template>
+  <AdminLayout current-page="page-name">
+    <view class="page-content">
+      <!-- 页面内容 -->
+    </view>
+  </AdminLayout>
+</template>
+```
+
+#### **步骤 12.4：UTS编译器兼容性**
+
+```javascript
+// 确保组件语法符合UTS要求
+// 使用 <script setup lang="uts">
+// 正确定义props类型
+// 避免复杂的TypeScript类型
+```
+
+#### **步骤 12.5：最终验证**
+
+#### **步骤 4.1：AdminLayout 菜单路径**
+
+```javascript
+const menuList = ref([
+  {
+    id: "dashboard",
+    title: "首页",
+    icon: "🏠",
+    path: "/pages/mall/admin/index", // ✅ 完整路径
+  },
+  {
+    id: "user-list",
+    title: "用户管理",
+    icon: "👤",
+    path: "/pages/mall/admin/user-management", // ✅ 完整路径
+  },
+  // ... 其他菜单项
+]);
+```
+
+#### **步骤 4.2：页面跳转路径**
+
+```javascript
+// 管理后台首页的导航方法
+const goToUserManagement = () => {
+  uni.navigateTo({
+    url: "/pages/mall/admin/user-management", // ✅ 带前缀的完整路径
+  });
+};
+```
+
+## 🎯 成功原理总结
+
+### **原理一：正确的项目结构**
+
+```
+mall/
+├── pages/
+│   ├── minimal.uvue                    # 主页面
+│   └── mall/
+│       └── admin/
+│           ├── index.uvue             # 管理后台首页
+│           ├── user-management.uvue   # 用户管理
+│           └── ...
+├── layouts/
+│   └── admin/
+│       ├── index.uvue                 # AdminLayout 组件
+│       └── ...
+└── pages.json                         # 页面配置文件
+```
+
+### **原理二：pages.json 配置规范**
+
+#### **主页面路径格式**:
+
+```json
+{
+  "pages": [
+    {
+      "path": "pages/minimal", // ✅ 完整路径包含 pages/
+      "style": {
+        /* ... */
+      }
+    }
+  ]
+}
+```
+
+#### **子包页面路径格式**:
+
+```json
+{
+  "subPackages": [
+    {
+      "root": "pages/mall", // ✅ 相对项目根目录
+      "pages": [
+        {
+          "path": "admin/index", // ✅ 相对 root 目录
+          "style": {
+            /* ... */
+          }
+        }
+      ]
+    }
+  ]
+}
+```
+
+### **原理三：生命周期钩子使用**
+
+#### **uni-app-x 生命周期规范**:
+
+```javascript
+// ✅ 正确：全局可用，无需导入
+onLoad(() => {
+  // 页面加载逻辑
+});
+
+onShow(() => {
+  // 页面显示逻辑
+});
+
+// ✅ 特殊情况：需要显式导入
+import { onLoad } from "@dcloudio/uni-app";
+```
+
+#### **Vue 3 组合式 API**:
+
+```javascript
+import { ref, computed, onMounted } from "vue";
+
+// 响应式数据
+const count = ref(0);
+
+// 计算属性
+const doubleCount = computed(() => count.value * 2);
+
+// 生命周期
+onMounted(() => {
+  console.log("组件挂载");
+});
+```
+
+### **原理四：组件语法正确性**
+
+#### **Vue 3 模板语法**:
+
+```vue
+<template>
+  <view class="component">
+    <!-- 正确的标签闭合 -->
+    <view v-if="show">{{ message }}</view>
+    <view v-for="item in items" :key="item.id">
+      {{ item.name }}
+    </view>
+  </view>
+</template>
+```
+
+#### **TypeScript 声明**:
+
+```typescript
+<script setup lang="uts">
+// 正确的 Props 定义
+const props = defineProps<{
+  currentPage: string
+  title?: string
+}>()
+
+// 正确的类型定义
+interface MenuItem {
+  id: string
+  title: string
+  icon: string
+  path: string
+}
+</script>
+```
+
+### **原理五：错误排查方法**
+
+#### **逐步验证策略**:
+
+1. **最小化配置**: 从最简单的配置开始
+2. **逐步添加**: 每次只添加一个功能
+3. **错误定位**: 根据错误信息快速定位问题
+4. **备份恢复**: 修改前备份，失败时快速回滚
+
+#### **常见错误检查清单**:
+
+- ✅ pages.json 路径格式是否正确
+- ✅ 页面文件是否存在
+- ✅ 组件语法是否正确
+- ✅ 导入语句是否正确
+- ✅ 生命周期钩子使用是否正确
+- ✅ 响应式数据使用是否正确
+- ✅ 特殊字符和 emoji 是否安全
+- ✅ 缩进是否一致（避免混用制表符和空格）
+- ✅ 方法调用是否正确（方法名和参数匹配）
+- ✅ 自闭合标签格式是否正确（使用 `/>` 而非 `></tag>`）
+- ✅ 模态框位置是否正确（避免条件嵌套）
+- ✅ .uvue文件复杂度是否适中（避免过度复杂的模板结构）
+- ✅ 批量文件修复是否完整（所有.uvue文件都已简化处理）
+- ✅ AdminLayout组件是否正确导入和解析
+- ✅ AdminLayout代码清理是否完整（无遗留变量引用）
+
+## 🚀 最佳实践指南
+
+### **开发规范**
+
+#### **1. 文件命名规范**
+
+- 页面文件: `kebab-case.uvue`
+- 组件文件: `PascalCase.uvue`
+- 工具文件: `camelCase.uts`
+
+#### **2. 路径配置规范**
+
+- 主页面: `pages/page-name`
+- 子包页面: `root: "pages/module"`, `path: "sub-page"`
+- 组件导入: `@/layouts/...`, `@/components/...`
+
+#### **3. 代码组织规范**
+
+```vue
+<template>
+  <!-- 模板内容 -->
+</template>
+
+<script setup lang="uts">
+// 导入语句
+// 类型定义
+// Props 定义
+// 响应式数据
+// 计算属性
+// 生命周期
+// 方法
+</script>
+
+<style lang="scss" scoped>
+/* 样式内容 */
+</style>
+```
+
+### **调试技巧**
+
+#### **1. 编译错误排查**
+
+- 查看控制台错误信息
+- 检查文件语法
+- 验证导入路径
+- 确认类型定义
+
+#### **2. 运行时错误排查**
+
+- 检查页面配置
+- 验证组件 Props
+- 确认事件处理
+- 测试页面跳转
+
+#### **3. 性能优化**
+
+- 合理使用响应式数据
+- 避免不必要的计算属性
+- 优化组件渲染
+- 使用合适的生命周期
+
+#### **4. .uvue文件特殊处理**
+
+- 保持模板结构简单，避免过度复杂
+- 使用UTS编译器兼容的字符集
+- 定期检查文件编码和特殊字符
+- 采用渐进式开发策略，从简单到复杂
+- 出现编译错误时优先简化模板结构
+
+#### **5. AdminLayout组件维护**
+
+- 保持组件结构简单，避免过度复杂的功能
+- 使用正确的文件扩展名(.uvue)在导入路径中
+- 定期验证组件的导出和解析
+- 出现解析错误时优先简化组件结构
+- 确保组件语法符合UTS编译器要求
+
+#### **6. 双侧边栏布局设计**
+
+- 主侧边栏只显示一级菜单图标，保持简洁
+- 内容侧边栏显示二级菜单，位于内容区左侧
+- 合理分配侧边栏宽度，确保移动端兼容性
+- 使用计算属性动态控制侧边栏显示
+- 确保路由同步和高亮状态正确
+
+## 📚 参考资源
+
+### **官方文档**
+
+- [uni-app-x 官方文档](https://doc.dcloud.net.cn/uni-app-x/)
+- [Vue 3 组合式 API](https://cn.vuejs.org/guide/extras/composition-api-faq.html)
+- [TypeScript 指南](https://www.typescriptlang.org/docs/)
+
+### **最佳实践**
+
+- 遵循项目现有的代码风格
+- 保持配置的一致性
+- 定期检查和更新依赖
+- 编写清晰的注释
+
+---
+
+## 🎯 总结
+
+通过本次修复，我们建立了完整的 uni-app-x 项目开发和调试方法论：
+
+1. **问题定位**: 快速识别配置和语法错误
+2. **逐步修复**: 从简单到复杂，逐步解决问题
+3. **规范建立**: 统一的代码和配置规范
+4. **最佳实践**: 可复用的开发模式
+
+### **新增问题类型**
+
+#### **特殊字符兼容性问题**
+
+- **现象**: `[plugin:uts] Invalid end tag` 错误
+- **原因**: emoji 字符或特殊 Unicode 符号导致模板解析失败
+- **解决方案**: 替换为标准 ASCII 字符或安全 Unicode 符号
+- **预防**: 在模板中使用经过验证的安全字符集
+
+---
+
+#### **原因十四：AdminLayout代码清理不完整**
+
+- **遗留变量引用**: 移除功能后仍引用已删除的变量
+- **计算属性缺失**: 重构时遗漏必要的计算属性
+- **模板依赖问题**: 模板中使用未定义的响应式属性
+
+---
+
+## 🎯 阶段十五: CRMEB 路由体系 1:1 复刻
+
+### **背景与目标**
+
+本阶段实现了 CRMEB v5 标准版管理端前端的路由体系和侧边栏布局的完整复刻,采用"内部路由/状态驱动渲染"模式,在 uni-app-x 项目中实现单页应用(SPA)体验。
+
+### **核心架构设计**
+
+#### **1. 内部路由系统**
+
+不同于传统的 `uni.navigateTo` 页面栈模式,采用状态驱动的内部路由:
+
+```
+点击菜单 → 更新 activeRouteId → 切换组件渲染 → 不打开新页面
+```
+
+**优势**:
+
+- ✅ 避免页面栈堆积
+- ✅ 保持布局和侧边栏状态
+- ✅ 实现 CRMEB 风格的标签页系统
+- ✅ 更快的页面切换速度
+
+#### **2. 文件结构**
+
+```
+layouts/admin/
+├── router/
+│   ├── adminRoutes.uts          # 路由配置(映射CRMEB routes)
+│   └── adminComponentMap.uts    # 组件映射表(静态导入)
+├── store/
+│   └── adminNavStore.uts        # 导航状态管理
+├── components/
+│   ├── AdminAside.uvue          # 主侧边栏(一级菜单)
+│   ├── AdminSubSider.uvue       # 二级侧边栏(分组+菜单项)
+│   ├── AdminHeader.uvue         # 顶部栏
+│   ├── AdminTagsView.uvue       # 标签页
+│   └── PlaceholderPage.uvue     # 占位组件
+└── AdminLayout.uvue             # 布局容器(渲染组件)
+```
+
+#### **3. 路由数据结构**
+
+**一级菜单 (TopMenu)**:
+
+```typescript
+{
+  id: 'user',
+  title: '用户',
+  icon: 'user',
+  path: '/pages/mall/admin/user/list',  // 默认路径
+  order: 2,
+  groups: [...]  // 分组列表
+}
+```
+
+**路由记录 (RouteRecord)**:
+
+```typescript
+{
+  id: 'user_list',
+  title: '用户管理',
+  path: '/pages/mall/admin/user/list',
+  componentKey: 'UserList',  // 映射到组件
+  parentId: 'user',
+  groupId: 'user-manage',
+  auth: ['admin-user-user-index']
+}
+```
+
+### **实施步骤总结**
+
+#### **步骤 1: 抽取 CRMEB 路由结构**
+
+从 CRMEB 源码 `router/modules/*` 抽取:
+
+- 9 个一级模块: home, user, product, order, marketing, cms, finance, statistic, setting
+- 30+ 二级路由: 用户管理、商品列表、订单管理等
+- 分组信息: 用户管理、会员管理、营销工具等
+
+#### **步骤 2: 创建路由配置文件**
+
+**文件**: `layouts/admin/router/adminRoutes.uts`
+
+包含:
+
+- `topMenus`: 一级菜单配置
+- `routes`: 完整路由表
+- 工具函数: `getTopMenus()`, `findRouteById()`, `getBreadcrumb()` 等
+
+#### **步骤 3: 创建状态管理**
+
+**文件**: `layouts/admin/store/adminNavStore.uts`
+
+状态:
+
+- `activeTopMenuId`: 当前选中的一级菜单
+- `activeRouteId`: 当前激活的路由
+- `tabs`: 标签页列表
+- `isMainAsideCollapsed`: 主侧边栏折叠状态
+
+方法:
+
+- `openRoute(routeId)`: 打开路由(核心方法)
+- `closeTab(tabId)`: 关闭标签页
+- `initNavState()`: 初始化导航状态
+
+#### **步骤 4: 创建组件映射表**
+
+**文件**: `layouts/admin/router/adminComponentMap.uts`
+
+**关键点**:
+
+- ✅ 所有组件**必须静态导入**(确保打包可分析)
+- ✅ 使用 `@` 别名(禁止相对路径)
+- ✅ 占位组件统一使用 `PlaceholderPage`
+
+```typescript
+import UserList from '@/pages/mall/admin/user/list.uvue'
+import ProductList from '@/pages/mall/admin/product/list.uvue'
+
+export const componentMap: Map<string, any> = new Map([
+  ['UserList', UserList],
+  ['ProductList', ProductList],
+  ...
+])
+```
+
+#### **步骤 5: 重构 AdminLayout**
+
+**核心变化**:
+
+```vue
+<!-- 旧模式: slot 渲染 -->
+<slot></slot>
+
+<!-- 新模式: 组件映射渲染 -->
+<component :is="currentComponent" />
+```
+
+**计算属性**:
+
+```typescript
+const currentComponent = computed(() => {
+  const route = findRouteById(activeRouteId.value);
+  return getComponent(route.componentKey);
+});
+```
+
+#### **步骤 6: 重构侧边栏组件**
+
+**AdminAside (主侧边栏)**:
+
+- 仅显示一级菜单图标+文本
+- 宽度: 96px (CRMEB: 64px)
+- 点击切换 `activeTopMenuId`
+
+**AdminSubSider (二级侧边栏)**:
+
+- 显示当前一级菜单的分组和子项
+- 宽度: 180px (CRMEB: 200px)
+- 位于内容区左侧(独立层级)
+
+#### **步骤 7: 批量创建占位页面**
+
+使用 Python 脚本创建 26 个占位页面:
+
+```bash
+python create_placeholder_pages.py
+```
+
+每个页面包含:
+
+- 标题和组件Key显示
+- 统一的占位样式
+- TODO 注释
+
+#### **步骤 8: 修改首页模式**
+
+**旧模式**:
+
+```vue
+<template>
+  <AdminLayout currentPage="home">
+    <!-- 内容 -->
+  </AdminLayout>
+</template>
+```
+
+**新模式**:
+
+```vue
+<template>
+  <view class="dashboard-page">
+    <!-- 内容 -->
+  </view>
+</template>
+<!-- 不再包裹 AdminLayout -->
+```
+
+### **关键技术点**
+
+#### **1. 组件动态渲染**
+
+**问题**: uni-app-x 不支持动态 `import()`
+
+**解决方案**: 使用 Map + 静态导入
+
+```typescript
+// ❌ 不可用
+const component = () => import(`@/pages/${path}.uvue`);
+
+// ✅ 正确方式
+const component = componentMap.get(componentKey);
+```
+
+#### **2. 路由同步**
+
+状态驱动而非URL驱动:
+
+```typescript
+// 点击菜单
+onRouteClick(routeId) →
+  activeRouteId.value = routeId →
+    currentComponent 重新计算 →
+      渲染新组件
+```
+
+#### **3. 标签页管理**
+
+模仿 CRMEB 的标签页行为:
+
+- 固定标签 (`isAffix`): 首页等,不可关闭
+- 普通标签: 可关闭、关闭其他、关闭全部
+- 关闭当前标签时自动切换到相邻标签
+
+#### **4. 面包屑导航**
+
+自动生成面包屑:
+
+```typescript
+getBreadcrumb('user_list')
+  → [{ id: 'user', title: '用户' }, { id: 'user_list', title: '用户管理' }]
+```
+
+### **与 CRMEB 的对照表**
+
+| CRMEB 特性    | uni-app-x 实现   | 备注                        |
+| ------------- | ---------------- | --------------------------- |
+| Vue Router    | 状态驱动内部路由 | 无 router 实例              |
+| router.push() | openRoute()      | 更新状态而非跳转            |
+| keep-alive    | 未实现           | 后续可通过组件缓存实现      |
+| 菜单配置      | menu.uts         | 已废弃,改用 adminRoutes.uts |
+| Vuex store    | UTS 响应式变量   | ref/computed 代替           |
+| 动态导入      | 静态映射表       | 打包限制                    |
+
+### **常见问题与解决方案**
+
+#### **问题 1: 组件未找到**
+
+**现象**: `getComponent` 返回 `PlaceholderPage`
+
+**原因**:
+
+- componentMap 中缺少对应的 key
+- 导入路径错误
+
+**解决**:
+
+```typescript
+// 检查 adminComponentMap.uts
+import UserList from "@/pages/mall/admin/user/list.uvue";
+componentMap.set("UserList", UserList);
+```
+
+#### **问题 2: 标签页不显示**
+
+**现象**: 点击菜单后标签页为空
+
+**原因**: `tabs` 数组未正确更新
+
+**解决**:
+
+```typescript
+// 确保在 openRoute 中添加标签
+if (addTab) {
+  addTabItem(route);
+}
+```
+
+#### **问题 3: 二级侧边栏不显示**
+
+**现象**: 点击一级菜单后二级侧边栏空白
+
+**原因**: 一级菜单的 `groups` 为空数组
+
+**解决**:
+
+```typescript
+// 检查 adminRoutes.uts 中的 topMenus 配置
+{
+  id: 'user',
+  groups: [
+    { id: 'user-manage', title: '用户管理' }  // ✅ 必须有
+  ]
+}
+```
+
+#### **问题 4: 模板编译错误**
+
+**现象**: `Invalid end tag` 或 `Illegal '/' in tags`
+
+**原因**:
+
+- 组件模板中有乱码
+- 标签未正确闭合
+
+**解决**:
+
+- 检查文件编码为 UTF-8
+- 移除特殊 emoji 字符
+- 确保所有标签正确闭合
+
+### **性能优化建议**
+
+1. **懒加载路由**: 只在需要时加载组件
+2. **虚拟滚动**: 标签页数量过多时使用虚拟列表
+3. **状态持久化**: 将 `activeRouteId` 等状态存入 localStorage
+4. **权限控制**: 在 `openRoute` 中增加权限校验逻辑
+
+### **扩展开发指南**
+
+#### **添加新路由**
+
+1. 在 `adminRoutes.uts` 中添加路由记录:
+
+```typescript
+{
+  id: 'custom_feature',
+  title: '自定义功能',
+  path: '/pages/mall/admin/custom/feature',
+  componentKey: 'CustomFeature',
+  parentId: 'setting',
+  groupId: 'setting-system'
+}
+```
+
+2. 创建页面文件:
+
+```bash
+pages/mall/admin/custom/feature.uvue
+```
+
+3. 在 `adminComponentMap.uts` 中添加映射:
+
+```typescript
+import CustomFeature from "@/pages/mall/admin/custom/feature.uvue";
+componentMap.set("CustomFeature", CustomFeature);
+```
+
+#### **添加新的一级菜单**
+
+1. 在 `topMenus` 中添加:
+
+```typescript
+{
+  id: 'reports',
+  title: '报表',
+  icon: 'report',
+  path: '/pages/mall/admin/reports/index',
+  order: 10,
+  groups: [...]
+}
+```
+
+2. 更新侧边栏图标映射 (`AdminAside.uvue`):
+
+```typescript
+const iconMap: Record<string, string> = {
+  ...
+  'reports': 'R'
+}
+```
+
+### **验收标准**
+
+- ✅ 主侧边栏显示所有一级菜单
+- ✅ 点击一级菜单,二级侧边栏正确显示分组和子项
+- ✅ 点击子项,内容区渲染对应组件
+- ✅ 标签页正确添加、切换、关闭
+- ✅ 无页面栈堆积
+- ✅ 无模板编译错误
+- ✅ 无乱码
+- ✅ 所有 import 使用 `@` 别名
+
+### **文档更新**
+
+本次重构新增以下文件和概念:
+
+- **内部路由模式**: 状态驱动渲染,替代页面跳转
+- **组件映射表**: 静态导入 + Map 查找,替代动态导入
+- **CRMEB 路由映射**: 1:1 复刻 CRMEB 的路由和菜单结构
+- **双侧边栏布局**: 主侧边栏(一级) + 二级侧边栏(分组)
+
+## 🎯 阶段十八: Vue/Vite 编译失败导致的连锁依赖雪崩 (500 错误与动态导入阻断)
+
+### **原因三十二：SCSS 括号闭合错误引发的 ?import 连锁报错**
+
+- **现象**:
+  1. 浏览器控制台出现核心组件的 SCSS 编译失败：GET /pages/mall/admin/product/product-management/index.uvue?...&lang.scss 500
+  2. 随后出现警告：[Vue warn]: Unhandled error during execution of async component loader
+  3. 最终报错阻断页面级加载：TypeError: Failed to fetch dynamically imported module: /pages/mall/admin/homePage/index.uvue?import
+- **原因**:
+  在修改或合并页面（如整合目录结构）时，不慎破坏了 <style lang="scss"> 其中的结构（例如留下了一个多余的闭合大括号 } 或丢失了 </style>）。由于 Vite 处理 uni-app-x 时是按块编译的，CSS 预处理报错会导致服务端直接向该组件抛出 **500 错误**。
+  在 "内部路由/状态驱动" 模式下，我们的系统依赖 dminComponentMap.uts 全量静态扫描所有的管理页面。一旦链路树中的某个子节点（例如 product-management/index.uvue）发生了 500 编译失败，会导致整个模块依赖树发生雪崩。父级页面（如引了全局 Layout 的 homePage/index.uvue）会因为底层的依赖断裂，无法组装出正确的 JS 模块，最终导致 **动态导入失败** 的假象。
+- **解决方案**:
+  1. **禁止盲目改路由**：**绝对不要**因为看到 homePage 报错就去重写 homePage 或者怀疑路由表配错了。
+  2. **顺藤摸瓜找源头**：沿着浏览器 Network 或者 Console 错误的最顶部往上翻，找到第一个且唯一一个抛出 500 的资源（在本例中是 lang.scss）。
+  3. **修复语法树**：回到那个触发 500 的文件，检查并修复 emplate、script、style 标签的闭锁以及其内部（特别是 SCSS 嵌套）的语法错误（如括号配对）。语法自洽后，整个异步组件树便会瞬间全量恢复正常。
+- **防止复发规范**: 当执行文件全局批量替换或目录大迁移后，切勿遗留未闭合的代码块。修复问题必须采用“由底向外”的收敛原则。
+
+---
+
+这个指南现在涵盖了 uni-app-x 项目开发中最常见的 17 类问题(新增动态导入与语法遮蔽解析),为后续开发提供了完整的故障排除和最佳实践指导。 🚀
+
+### 原因二十一：动态导入 (Dynamic Import) 导致 H5 加载异常 (net::ERR_CACHE_READ_FAILURE)
+
+**问题描述：**
+在 H5 环境下，使用 `defineAsyncComponent` 或 Vite 默认的动态导入语法加载 `.uvue` 组件时，经常出现 `net::ERR_CACHE_READ_FAILURE` 错误。这通常是因为 UTS 编译器在处理动态分包时，无法正确生成或缓存对应的脚本模块。
+
+**解决方案：**
+
+1. **强制改为静态导入**：在路由配置文件（如 `adminComponentMap.uts`）中，不要使用 `() => import(...)`，而是直接使用顶层的 `import` 语句导入所有组件。
+2. **中心化映射表**：建立一个中心化的组件映射表，利用 UTS 的强类型特性确保组件在编译期就被分析和包含。
+
+### 原因二十二：语法错误导致模块加载失败 (Masked Syntax Errors)
+
+**问题描述：**
+某些 UTS 语法错误（如非标准的泛型写法 `reactive<T>` 或不兼容的脚本标签 `<script uts>`）在 H5 模式下不会直接报出详细的语法错误，而是会导致生成的 JS 模块无效，从而触发浏览器的 `net::ERR_CACHE_READ_FAILURE`。
+
+**解决方案：**
+
+1. **标准化 Script 标签**：统一使用 `<script setup lang="uts">` 或 `<script lang="uts">`（配合 `defineComponent`）。
+2. **规范响应式声明**：避免在 `reactive` 上直接使用泛型（如 `reactive<T>(...)`），应使用类型断言 `reactive(...) as T`。
+3. **避免遗留的 Options API 写法**：尽量将旧的 `export default { data(), methods() }` 结构转换为 Composition API 模式，以获得最佳的 UTS 编译支持。
+
+### 原因二十三：AdminLayout 循环依赖导致 500 错误 (Circular Dependency)
+
+**问题描述：**
+在 H5 环境下，为某个子页面添加 `AdminLayout` 包裹后，Vite 或编译器报错 `500 Internal Server Error (ERR_ABORTED)`，且页面无法加载。
+
+**原因：**
+
+1. **依赖闭环**：`AdminLayout` 导入了侧边栏和路由逻辑，路由逻辑引用了 `adminComponentMap.uts`，而映射表又导入了所有子页面组件。
+2. **递归调用**：如果子页面组件再次导入 `AdminLayout` 试图自我包裹，就会形成死循环依赖，导致 Vite 开发服务器或编译后的模块加载失败。
+
+**解决方案：**
+
+1. **分层包裹架构**：所有注册在 `adminComponentMap.uts` 中的“子页面组件”**必须禁止** 导入和使用 `AdminLayout`。
+2. **统一入口提供布局**：由父级容器（如 `admin/index.uvue` 或顶层路由组件）负责一次性提供 `AdminLayout` 框架。
+
+### 原因二十四：标签切换/动态显显引起的高度抖动 (Layout Jitter)
+
+**问题描述：**
+使用 `v-if` 在不同配置标签间切换，或者动态显示/隐藏表单项时，外部卡片（Card）的尺寸会突然跳动，影响视觉稳定性。
+
+**解决方案：**
+
+1. **预设最小高度**：在 `config-card` 或 `config-body` 上显式设置 `min-height`（如 `550px` 或 `600px`），确保即使内容较少，容器高度也保持不变。
+2. **容器钳制**：确保 `min-height` 足够覆盖该页面中所有可能出现的最高配置项组合。
+
+### 原因二十五：边距一致性与像素级对齐 (Margin Consistency)
+
+**问题描述：**
+页面顶部标题、内容卡片、底部边距在不同页面不一致。例如：有些页面顶部紧贴 breadcrumb，有些页面底部多出大量空白，左右间距不统一。
+
+**解决方案：**
+
+1. **容器级 padding 置空**：子页面根组件（如 `.admin-page`）应设置 `padding: 0`，完全信任 `AdminLayout.uvue` 中 `.content-inner` 提供的 `20px` 标准边距 (`--admin-page-padding-desktop`)。
+2. **三段式间距 (20px 规则)**：
+   - **Header-to-Content Gap (20px)**: 顶部白色标题栏与下方内容卡片之间，统一定义 `margin-top: 20px`。
+   - **External Padding (20px)**: 由框架层 `.content-inner` 提供全局 20px 间距，确保页面四周留白均匀。
+3. **内容区域一致性**：所有装修类的预览组件（如 `.preview-column`）和管理卡片（如 `.manage-card`）应通过这种 20px 的分层间距保持视觉节奏一致。
+
+### 原因二十六：装修模块的“白色背景卡片”统一化 (Unified White Card Pattern)
+
+**问题描述：**
+装修（Decoration）和设计（Design）模块中，预览区（PhonePreview）和设置区（Settings）如果背景色参差不齐（灰白交替）或使用独立阴影的小卡片，会显得界面琐碎且不专业。
+
+**解决方案：**
+
+1. **大卡片容器化**：将左侧预览、中间预览、右侧配置等所有相关内容全部封装在一个 `.main-card` 或 `.card-container` 白色背景容器内，并使用统一阴影 (`0 2px 12px 0 rgba(0, 0, 0, 0.05)`)。
+2. **示例应用 - 主题风格 (theme-style.uvue)**：
+   - 移除原有的多个独立预览 Card，统一至一个大背景。
+   - 颜色选择项（ThemeItem）重构为带有 1px 细边框和特定圆角的微型容器。
+   - 预览手机（MockPhone）间距固定为 30px，并确保在容器内水平平铺。
+3. **避免深色背景块**：在配置表单内部，尽量避免使用深灰色（如 `#f6f8fb`）背景块，改用白色背景加浅灰色细边框 (`1px solid #f0f0f0`)，使整体视觉更加通透一致。
+4. **内部列间距对齐**：左边栏（MenuSide）、中预览（PhonePreview）、右配置（Settings）的内部 Padding 应维持在 30px-40px 左右，确保内容呼吸感一致。
+
+### 原因二十七：首屏加载资源请求暴增 (Dev Mode Requests Spike)
+
+**问题描述：**
+浏览器 Network 面板显示瞬间 500+ 个 JS/Vue 文件请求，页面加载由于 Pending 状态卡顿。
+
+**原因分析：**
+
+- **Vite 开发机制**：在 HBuilderX 的开发模式下，Vite 采用原生 ESM 加载，不进行文件合并。每一个 `.uvue`、`.uts`、脚本、样式都是独立的 HTTP 请求。
+- **依赖引用过深**：首屏主页面引用了全量的公共样式或未优化的重型组件。
+
+**解决方案：**
+
+1. **构建验证**：明确 500+ 请求是“开发环境”特有现象。上线前执行 `npm run build`，Vite 会自动将这些文件合并为极少数的 Chunk。
+2. **样式按需导入**：避免在 `App.uvue` 中全局导入仅管理端使用的重型 CSS，改为在 `AdminLayout.uvue` 或具体子包中局部导入。
+
+### 原因二十八：路由冗余导致 H5 启动缓慢 (Pages.json 优化与分包)
+
+**问题描述：**
+`pages` 数组过大，导致 H5 下打包的入口主体体积过载，白屏时间长。
+
+**解决方案：**
+
+1. **分包化重构 (subPackages)**：将所有 Admin 管理页面按业务域（如 `admin/order`、`admin/product`）由主包 `pages` 移入 `subPackages`。
+2. **首页最小化**：调整 `pages.json` 顺序，确保应用启动首屏（如 `login.uvue`）位于主包且依赖最少。
+
+### 原因二十九：Mock 模式下的认证后门与状态同步 (Auth Bypass)
+
+**问题描述：**
+本地调试时，由于 Supabase Session 过期或网络不通导致无法进入管理后台，且登录逻辑复杂时难以快速验证 UI。
+
+**解决方案：**
+
+1. **Admin Backdoor**：在 `login.uvue` 实现中加入 `admin/admin` 静态验证逻辑，直接操作 `store.uts` 的状态，绕过网络请求。
+2. **状态注入规范**：手动登录成功后，必须显式调用 `setIsLoggedIn(true)` 和 `setUserProfile(adminProfile)`，否则会触发响应式布局逻辑失效。
+3. **依赖引用补全**：在 `script setup` 中必须显式 `import { setIsLoggedIn, setUserProfile } from '@/utils/store.uts'`，避免 `ReferenceError`。
+
+### 原因三十：Vite 依赖预构建与手动拆包 (Manual Chunks)
+
+**问题描述：**
+生产环境下第三方大库（Vue, Uni-App, AntD 等）与业务业务逻辑混在一起，导致每次局部代码更新都会使巨大的主包缓存失效。
+
+**解决方案：**
+在 `vite.config.js` 中配置 `build.rollupOptions.output.manualChunks`，将 `node_modules` 下的大型库强制拆分为独立文件（如 `vendor-vue`、`vendor-uni`）。这样首屏加载只需下载一次体积恒定的核心库，后续仅下载变化的业务代码。
+
+### 原因三十一：跨域预检失败导致 REST 请求被浏览器拦截 (CORS Preflight)
+
+**现象：**
+
+- 控制台报错：
+  - `Access to XMLHttpRequest at 'http://192.168.1.61:9122/rest/v1/...' from origin 'http://localhost:5173' has been blocked by CORS policy`
+  - `Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header`
+  - `GET ... net::ERR_FAILED`
+
+**原因分析：**
+
+1. H5 调试环境的页面源是 `http://localhost:5173`，请求目标是 `http://192.168.1.61:9122`，属于跨域请求（协议/域名/IP/端口任一不同即跨域）。
+2. 业务请求携带 `apikey`、`authorization`、`content-type` 等非简单请求头时，浏览器会先发 `OPTIONS` 预检请求。
+3. 目标服务（通常是网关/Kong/Nginx）对 `OPTIONS` 响应中缺少 `Access-Control-Allow-Origin`（以及允许方法、允许头），浏览器会在前端直接拦截后续 GET/POST。
+4. 配置地址与实际请求地址不一致也会放大问题，例如项目配置可能是 `192.168.1.61:9122`，而实际报错请求是其他主机，两者很可能不是同一服务或同一网关配置。
+
+**解决方案：**
+
+1. **后端网关开启 CORS（根本修复）**：
+
+- 允许来源：`http://localhost:5173`
+- 允许方法：`GET, POST, PUT, PATCH, DELETE, OPTIONS`
+- 允许请求头：`apikey, authorization, content-type, prefer, x-client-info`
+- 确保 `OPTIONS` 返回 `200/204` 且带完整 CORS 响应头
+
+2. **本地开发使用 Vite 代理（前端临时规避）**：
+
+- 在 `vite.config.js` 配置 `server.proxy`，将 `/rest/v1`、`/auth/v1` 等路径代理到真实网关，避免浏览器直接跨域。
+
+3. **统一 URL 配置**：
+
+- 检查 `ak/config.uts` 中 `SUPA_URL` 与实际发起请求的主机是否一致，避免请求落到未配置 CORS 的地址。
+
+**快速排查命令（后端自检）：**
+
+```bash
+curl -i -X OPTIONS "http://192.168.1.61:9122/rest/v1/ml_coupon_templates?select=*" \
+  -H "Origin: http://localhost:5173" \
+  -H "Access-Control-Request-Method: GET" \
+  -H "Access-Control-Request-Headers: apikey,authorization,content-type"
+```
+
+若响应头中没有 `Access-Control-Allow-Origin`，即可确认是服务端 CORS 配置问题，而非前端语法或请求代码问题。
+
+---
+
+## 🎯 阶段十六: UI/UX与数据库集成深度打磨 (商品分类实战)
+
+### **背景与目标**
+
+本阶段以“商品分类 (`classification/index.uvue`)”页面为实战案例，彻底剔除前端 Mock 数据，深度结合真实 PostgreSQL 数据库（Supabase）结构进行前后端联调。同时打磨前端表单与自定义 UI 组件，以确保交互体验达到最佳标准。
+
+### **核心技术栈与实战难点**
+
+#### **1. 前后端数据类型的精确映射**
+
+不同于简单的 JSON，前端必须严格适配数据库设计的各类约束：
+
+- **UUID 约束**: 分类的 `id` 及 `parent_id` 必须由普通整数转为字符串（UUID）格式。
+- **Array 数组类型**: 数据库中存储的 `path` 字段为 `text[]` (例如 `{"数码电器","智能手机"}`)。前端接收时需要正确将其反序列化为 UTS/JS 的 `string[]`。
+- **UTSJSONObject 转换红线**: Supabase 在请求/返回时强制声明类型检查，嵌套类型或者未知格式会导致 UTS 强转 `as UTSJSONObject` 失败。我们需要利用 `.replace('{', '[').replace('}', ']')` 与 `JSON.parse` 显式完成 postgres `text[]` 到 JS 数组格式的清洗。
+
+#### **2. 分类层级 (Path & Level)的自动计算**
+
+对于具有树形结构的数据，新建或更新分类时：
+
+- 新节点的 `level` 动态等于其选定父节点的 `level + 1`，默认为 1。
+- 新节点的 `path` 必须完整继承父节点的 `path` 加当前节点自己的 `name`。
+- **抽屉组件联动 (Drawer Form)**：实现在 `picker` 表单选择上级分类时，前端自动提取对应父分类对象，用于准备组装上述关联属性，大幅降低人工误操作。
+
+#### **3. 自定义组件样式交互调优 (UX 打磨)**
+
+对于模拟原生的 Switch 切换开关等手工 UI 元素 (`.switch-mock`)，极易出现细微排版与手势体验不佳的问题。
+
+- **失效的纵向居中**: `<text>` 作为 Flex 的子元素使用 `display: flex; align-items: center` 时经常无法触发完美的纵轴对齐。**解决方案**: 为包裹单行文字的 `text` class 指定与父容器等高的 `line-height` (`line-height: 24px;` 对齐父元素 `height: 24px`)。
+- **热区与手势反馈**: 原生浏览器端缺失 pointer 样式会让用户认为该元素不可点击。需要在 `.switch-mock` 顶层增加 `cursor: pointer;`。
+
+### **最佳实践总结 (最佳体验法则)**
+
+1. **统一数据源 (Single Source of Truth)**：一旦存在后台建表规范 (如 `CONSUMER_DB_DOC`)，前端 `interface` 层应100%镜像字段名，规避繁琐的字段隐射。
+2. **渐进式数据增强 (Progressive Data Enhancement)**: 表格展示优先处理 `loadData`，并引入 `buildParentOptions` 把平铺的数据（Flat Data）映射到 `tree` 组件或下拉框（Select/Picker）。
+3. **细节决定体验**: 在处理 `div`/`view` 改写的组件时，必须补充缺失的交互态（鼠标悬浮、点击动效、内部绝对居中对齐）。
+4. **组件化复用 (Componentization)**: 对于管理后台高频使用的 UI 元素（如状态开关），必须抽取为全局或业务组件（如 `StatusSwitch`），确保交互一致性，支持自定义文字（开启/显示、关闭/隐藏）并简化外部代码量。
+
+---
+
+## 🎯 阶段十七: 全局 UI 组件化与标准化 (StatusSwitch 实战)
+
+### **背景与目标**
+
+为了消除管理后台各子页面中“状态开关”实现不统一（样式各异、交互逻辑分散）的问题，本阶段实施了全局 `StatusSwitch` 组件的封装与存量页面自动化替换。
+
+### **核心技术实现**
+
+#### **1. 业务组件封装 (`StatusSwitch.uvue`)**
+
+- **双向绑定**: 完美支持 `v-model` (uts 模式下的 `modelValue`)。
+- **自定义语义化**: 通过 `activeText` 和 `inactiveText` 区分不同场景（如：开启/关闭、显示/隐藏、启用/禁用）。
+- **像素级布局对齐**:
+  - 强制 `line-height` 等于容器高度 (24px)，解决 uts 环境下文本垂直居中的顽疾。
+  - 响应式 `switch-dot` 偏移逻辑，确保开关滑块在开启态精确到位。
+  - 顶部容器追加 `cursor: pointer;` 增强 Web/H5 端的交互反馈。
+
+#### **2. 存量代码“手术级”替换**
+
+针对以下高频场景完成了组件替换：
+
+- **商品分类 (`classification/index.uvue`)**: 剔除冗余的 20+ 行 CSS，简化模板结构。
+- **商品标签 (`labels/index.uvue`)**: 同时支持“状态”和“移动端展示（显示/隐藏）”两种不同语义。
+- **商品保障 (`protection/index.uvue`)**: 统一各页面视觉断点。
+
+### **标准化规范 (开发红线)**
+
+- **禁止内联开关样式**: 凡涉及状态切换的开关，严禁在页面级定义 `.switch-mock` 或 `.status-switch-mini`。必须统一导入并使用 `@/components/StatusSwitch.uvue`。
+- **接口同步**: 必须通过 `v-model` 绑定数据项属性，并在 `@change` 事件中通过 Supabase 完成数据库状态回写，确保 UI 与持久层同步。
+- **文字对齐**: 任何时候文字都应在开关中央水平垂直居中，禁止出现文字偏上或偏下的视觉瑕疵。
+
+---
+
+这个指南现在涵盖了 uni-app-x 项目开发中最常见的 36 类问题（含分页数据集成、PostgREST 协议层行为、全局组件化最佳实践），为后续开发提供了完整的故障排除和标准化指导。 🚀
diff --git a/pages/mall/admin/docs/create_placeholder_pages.py b/pages/mall/admin/docs/create_placeholder_pages.py
deleted file mode 100644
index d16ae674..00000000
--- a/pages/mall/admin/docs/create_placeholder_pages.py
+++ /dev/null
@@ -1,177 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-"""
-批量创建 Admin 占位页面
-"""
-
-import os
-from pathlib import Path
-
-# 页面配置 (基于 adminRoutes.uts)
-pages_config = [
-    # 首页 - 已存在,跳过
-    
-    # 用户模块
-    {'path': 'pages/mall/admin/user/list.uvue', 'title': '用户管理', 'componentKey': 'UserList'},
-    {'path': 'pages/mall/admin/user/level.uvue', 'title': '用户等级', 'componentKey': 'UserLevel'},
-    {'path': 'pages/mall/admin/user/group.uvue', 'title': '用户分组', 'componentKey': 'UserGroup'},
-    {'path': 'pages/mall/admin/user/label.uvue', 'title': '用户标签', 'componentKey': 'UserLabel'},
-    {'path': 'pages/mall/admin/user/grade/type.uvue', 'title': '会员类型', 'componentKey': 'UserGradeType'},
-    {'path': 'pages/mall/admin/user/grade/card.uvue', 'title': '卡密会员', 'componentKey': 'UserGradeCard'},
-    {'path': 'pages/mall/admin/user/grade/record.uvue', 'title': '会员记录', 'componentKey': 'UserGradeRecord'},
-    {'path': 'pages/mall/admin/user/grade/right.uvue', 'title': '会员权益', 'componentKey': 'UserGradeRight'},
-    
-    # 商品模块
-    {'path': 'pages/mall/admin/product/list.uvue', 'title': '商品管理', 'componentKey': 'ProductList'},
-    {'path': 'pages/mall/admin/product/classify.uvue', 'title': '商品分类', 'componentKey': 'ProductClassify'},
-    {'path': 'pages/mall/admin/product/reply.uvue', 'title': '商品评论', 'componentKey': 'ProductReply'},
-    {'path': 'pages/mall/admin/product/attr.uvue', 'title': '商品规格', 'componentKey': 'ProductAttr'},
-    {'path': 'pages/mall/admin/product/param.uvue', 'title': '商品参数', 'componentKey': 'ProductParam'},
-    {'path': 'pages/mall/admin/product/label.uvue', 'title': '商品标签', 'componentKey': 'ProductLabel'},
-    {'path': 'pages/mall/admin/product/protection.uvue', 'title': '商品保障', 'componentKey': 'ProductProtection'},
-    
-    # 订单模块
-    {'path': 'pages/mall/admin/order/list.uvue', 'title': '订单管理', 'componentKey': 'OrderList'},
-    
-    # 营销模块
-    {'path': 'pages/mall/admin/marketing/coupon/list.uvue', 'title': '优惠券', 'componentKey': 'MarketingCoupon'},
-    {'path': 'pages/mall/admin/marketing/integral/list.uvue', 'title': '积分管理', 'componentKey': 'MarketingIntegral'},
-    {'path': 'pages/mall/admin/marketing/bargain/list.uvue', 'title': '砍价活动', 'componentKey': 'MarketingBargain'},
-    {'path': 'pages/mall/admin/marketing/combination/list.uvue', 'title': '拼团活动', 'componentKey': 'MarketingCombination'},
-    {'path': 'pages/mall/admin/marketing/seckill/list.uvue', 'title': '秒杀活动', 'componentKey': 'MarketingSeckill'},
-    
-    # 内容模块
-    {'path': 'pages/mall/admin/cms/article/list.uvue', 'title': '文章管理', 'componentKey': 'CmsArticle'},
-    {'path': 'pages/mall/admin/cms/category/list.uvue', 'title': '文章分类', 'componentKey': 'CmsCategory'},
-    
-    # 财务模块
-    {'path': 'pages/mall/admin/finance/record.uvue', 'title': '财务记录', 'componentKey': 'FinanceRecord'},
-    
-    # 数据统计模块
-    {'path': 'pages/mall/admin/statistic/index.uvue', 'title': '数据概览', 'componentKey': 'StatisticIndex'},
-    
-    # 设置模块
-    {'path': 'pages/mall/admin/setting/system/config.uvue', 'title': '系统配置', 'componentKey': 'SettingSystemConfig'},
-    {'path': 'pages/mall/admin/setting/system/admin.uvue', 'title': '管理员管理', 'componentKey': 'SettingSystemAdmin'},
-    {'path': 'pages/mall/admin/setting/system/role.uvue', 'title': '角色管理', 'componentKey': 'SettingSystemRole'},
-]
-
-# 占位页面模板
-template = '''<template>
-  <view class="page-container">
-    <view class="page-header">
-      <text class="page-title">{title}</text>
-      <text class="page-subtitle">Component: {componentKey}</text>
-    </view>
-    
-    <view class="page-content">
-      <view class="placeholder-card">
-        <text class="placeholder-title">页面占位</text>
-        <text class="placeholder-desc">该功能模块正在开发中</text>
-        <text class="placeholder-info">当前采用 CRMEB 路由体系 1:1 映射</text>
-      </view>
-    </view>
-  </view>
-</template>
-
-<script setup lang="uts">
-import {{ ref }} from 'vue'
-
-// TODO: 实现 {title} 的具体功能
-const loading = ref<boolean>(false)
-</script>
-
-<style scoped lang="scss">
-.page-container {{
-  padding: 20px;
-  min-height: 100vh;
-  background: #f5f5f5;
-}}
-
-.page-header {{
-  margin-bottom: 20px;
-}}
-
-.page-title {{
-  display: block;
-  font-size: 24px;
-  font-weight: 600;
-  color: #333;
-  margin-bottom: 8px;
-}}
-
-.page-subtitle {{
-  display: block;
-  font-size: 14px;
-  color: #999;
-}}
-
-.page-content {{
-  background: #fff;
-  border-radius: 4px;
-  padding: 24px;
-}}
-
-.placeholder-card {{
-  text-align: center;
-  padding: 60px 20px;
-}}
-
-.placeholder-title {{
-  display: block;
-  font-size: 18px;
-  font-weight: 600;
-  color: #666;
-  margin-bottom: 12px;
-}}
-
-.placeholder-desc {{
-  display: block;
-  font-size: 14px;
-  color: #999;
-  margin-bottom: 8px;
-}}
-
-.placeholder-info {{
-  display: block;
-  font-size: 12px;
-  color: #1890ff;
-}}
-</style>
-'''
-
-def create_placeholder_pages():
-    """创建所有占位页面"""
-    base_dir = Path(r'd:\骅锋\mall')
-    created_count = 0
-    skipped_count = 0
-    
-    for page in pages_config:
-        file_path = base_dir / page['path']
-        
-        # 如果文件已存在,跳过
-        if file_path.exists():
-            print(f'[跳过] {page["path"]} - 文件已存在')
-            skipped_count += 1
-            continue
-        
-        # 创建目录
-        file_path.parent.mkdir(parents=True, exist_ok=True)
-        
-        # 生成文件内容
-        content = template.format(
-            title=page['title'],
-            componentKey=page['componentKey']
-        )
-        
-        # 写入文件
-        with open(file_path, 'w', encoding='utf-8') as f:
-            f.write(content)
-        
-        print(f'[创建] {page["path"]}')
-        created_count += 1
-    
-    print(f'\n完成! 创建 {created_count} 个文件, 跳过 {skipped_count} 个文件')
-
-if __name__ == '__main__':
-    create_placeholder_pages()
diff --git a/pages/mall/admin/docs/ops/2026-02-05__admin__user-management-db-integration.md b/pages/mall/admin/docs/ops/2026-02-05__admin__user-management-db-integration.md
deleted file mode 100644
index b9258ea1..00000000
--- a/pages/mall/admin/docs/ops/2026-02-05__admin__user-management-db-integration.md
+++ /dev/null
@@ -1,121 +0,0 @@
-# 2026-02-05__admin__user-management-db-integration.md
-
-## 摘要
-
-为管理后台用户管理模块（`pages/mall/admin/user/user-management/index.uvue`）接入数据库，实现用户列表分页查询、筛选、用户详情展示，并支持会员信息（是否会员 + 方案名 + 到期时间）与余额（固定 0）的展示。
-
-## 动机
-
-- 原 admin 用户管理页面为占位页，无真实数据接入
-- 需要按照项目规范（`AGENT_PROJECT_SPEC.md`）通过 `services/` 层访问数据，admin 全局数据走 RPC
-- 用户管理需展示会员信息（基于 `ml_user_subscriptions`）与余额（暂固定 0）
-
-## 影响范围
-
-- **数据库层**：新增 RPC（暂存于 `test/`，待验证后入库到 `docs/sql/30_rpc/admin/`）
-- **服务层**：新增 `services/admin/AdminUserService.uts`
-- **页面层**：`pages/mall/admin/user/user-management/index.uvue` 从占位页升级为完整功能页
-- **工具层**：`utils/supabaseService.uts` 新增 `export { supa }` 供 services 统一使用
-
-## 变更清单
-
-### 新增文件
-- `pages/mall/admin/user/test/rpc_admin_user_list_v1.sql` - 用户列表 RPC（分页+筛选）
-- `pages/mall/admin/user/test/rpc_admin_user_detail_v1.sql` - 用户详情 RPC
-- `services/admin/AdminUserService.uts` - Admin 用户管理服务封装
-- `pages/mall/admin/docs/ops/2026-02-05__admin__user-management-db-integration.md` - 本操作文档
-
-### 修改文件
-- `pages/mall/admin/user/user-management/index.uvue` - 从占位页升级为完整功能页
-- `utils/supabaseService.uts` - 新增 `export { supa }` 供 services 层统一使用
-
-### 删除文件
-- 无
-
-## 兼容性与风险
-
-### 兼容性
-- RPC 依赖现有表结构：`ak_users`、`ml_user_profiles`、`ml_user_subscriptions`、`ml_subscription_plans`、`ml_user_addresses`
-- 会员关联口径：`ml_user_subscriptions.user_id = ak_users.auth_id`（即 `auth.users.id`）
-- 余额字段固定返回 0，不影响现有业务
-
-### 风险
-- RPC 暂存于 `test/` 目录，未入库到 `docs/sql/`，需验证后再迁移
-- 新增 `export { supa }` 可能影响其他模块的导入行为（但为统一出口，风险较低）
-- 页面功能较复杂，需充分测试分页、筛选、弹窗等交互
-
-## 回滚方案
-
-1. **回滚页面**：恢复 `pages/mall/admin/user/user-management/index.uvue` 为原占位页内容
-2. **回滚服务**：删除 `services/admin/AdminUserService.uts`
-3. **回滚工具**：移除 `utils/supabaseService.uts` 中的 `export { supa }`
-4. **回滚 RPC**：删除 `pages/mall/admin/user/test/` 下的两个 RPC 文件
-
-## 验证方式
-
-### 功能验证
-1. 访问管理后台 → 用户管理 → 用户列表
-2. 验证列表数据加载正常，显示用户基本信息、会员信息、余额
-3. 测试筛选功能：搜索、角色、状态、会员筛选
-4. 测试分页功能：上一页/下一页
-5. 点击"查看"按钮，验证用户详情弹窗正常显示
-6. 验证详情页中的会员信息（方案名、到期时间）和地址信息
-
-### 技术验证
-1. 检查 RPC 调用是否正常返回数据
-2. 检查服务层数据转换是否正确
-3. 检查页面渲染是否正常，无报错
-4. 检查网络请求是否通过 services 层，未直接访问 supabase client
-
-### SQL 验证
-```sql
--- 验证 RPC 是否创建成功
-SELECT proname, prosrc FROM pg_proc WHERE proname LIKE 'rpc_admin_user_%';
-
--- 测试用户列表 RPC
-SELECT * FROM rpc_admin_user_list(1, 20, NULL, NULL, NULL, NULL);
-
--- 测试用户详情 RPC（替换为真实用户ID）
-SELECT * FROM rpc_admin_user_detail('your-user-id-here');
-```
-
-## 关联文档
-
-- `docs/project_spec/AGENT_PROJECT_SPEC.md` - 项目规范文档
-- `docs/sql/30_rpc/auth/get_current_user_role_v1.sql` - RPC 鉴权入口
-- `mall_sql/schemas/complete_mall_database.sql` - 数据库表结构
-- `doc_mall/create_mall_subscription_tables.sql` - 订阅表结构
-- `pages/mall/admin/user/docs/USER_STATISTICS_DB.md` - 用户统计相关文档
-
-## 技术实现要点
-
-### RPC 设计
-- 使用 `SECURITY DEFINER` + `SET search_path = public`
-- 入口鉴权：`get_current_user_role() IN ('admin', 'analytics')`
-- 支持分页、搜索、多维度筛选
-- 会员信息通过 `LATERAL JOIN` 获取最新有效订阅
-
-### 服务层设计
-- 封装 RPC 调用，提供类型安全的接口
-- 统一错误处理和日志记录
-- 数据转换：UTSJSONObject → TypeScript 类型
-
-### 页面设计
-- 响应式布局，支持移动端
-- 完整的筛选和分页功能
-- 用户详情弹窗展示完整信息
-- 会员信息按方案 C 展示：是否会员 + 方案名 + 到期时间
-
-## 后续计划
-
-1. **RPC 入库**：验证通过后，将 RPC 迁移到 `docs/sql/30_rpc/admin/`
-2. **功能扩展**：根据业务需求，可能需要添加用户编辑、状态变更等功能
-3. **性能优化**：考虑添加缓存、索引优化等
-4. **余额功能**：当钱包/余额表实现后，接入真实余额数据
-
-## 部署注意事项
-
-1. 确保数据库表结构已部署（`ml_user_profiles`、`ml_user_subscriptions` 等）
-2. 确保 `get_current_user_role()` RPC 已部署
-3. 部署前建议在测试环境验证 RPC 功能正常
-4. 页面部署后检查控制台是否有错误信息
\ No newline at end of file
diff --git a/pages/mall/admin/docs/ops/2026-02-06__admin__product-module-standardization.md b/pages/mall/admin/docs/ops/2026-02-06__admin__product-module-standardization.md
deleted file mode 100644
index 648d546d..00000000
--- a/pages/mall/admin/docs/ops/2026-02-06__admin__product-module-standardization.md
+++ /dev/null
@@ -1,50 +0,0 @@
-# 操作文档：Admin 商品模块标准化实施
-
-- **日期**：2026-02-06
-- **作用域**：`admin` / `product`
-- **实施人**：Cascade (AI Assistant)
-
-## 1. 摘要
-按照 `AGENT_PROJECT_SPEC.md` 规范，完成了 Admin 商品模块从数据库 RPC 到 Service 层，再到前端页面的全链路标准化改造。
-
-## 2. 动机
-- 统一商品模块数据访问口径，消除页面 Mock 数据。
-- 增强数据库安全性，所有特权操作均通过 `SECURITY DEFINER` RPC 并包含角色校验。
-- 修复分类层级变动时 `path` 与 `level` 字段不同步的潜在风险。
-
-## 3. 影响范围
-- **数据库**：新增/更新了 `rpc_admin_product_*` 和 `rpc_admin_category_*` 系列函数。
-- **服务层**：新增 `services/admin/productService.uts` 和 `services/admin/productCategoryService.uts`。
-- **前端页面**：重构了 `product-management/index.uvue` 和 `classification/index.uvue`。
-
-## 4. 变更清单
-
-### 4.1 数据库 RPC (docs/sql/30_rpc/product/)
-- `rpc_admin_product_list_v1.sql`: 标准化分页查询，对齐 `JSONB` 返回结构。
-- `rpc_admin_product_update_status_v1.sql`: 统一处理上下架与回收站逻辑。
-- `rpc_admin_category_list_v1.sql`: 适配 `ml_categories` 权威字段。
-- `rpc_admin_category_create_v1.sql`: 自动维护层级路径。
-- `rpc_admin_category_update_v1.sql`: **核心增强**，支持子树 `path` 与 `level` 的级联更新，并具备递归防循环引用校验。
-- `rpc_admin_category_delete_v1.sql`: 实现“有子项禁止删除”的安全策略。
-
-### 4.2 服务层 (services/admin/)
-- `productService.uts`: 封装商品列表与状态变更接口。
-- `productCategoryService.uts`: 封装分类列表与 CRUD 接口。
-
-### 4.3 前端重构
-- **商品管理**：接入真实数据流，支持按名称、状态搜索，支持实时上下架切换。
-- **商品分类**：接入真实树形数据，支持完整的 CRUD 操作与状态开关。
-
-## 5. 安全与权限验证
-- **RPC 安全**：所有函数均声明为 `SECURITY DEFINER`，并固定 `search_path = public`。
-- **角色守卫**：函数入口显式校验 `role IN ('admin', 'analytics')`。
-- **数据隔离**：仅返回 UI 渲染必要的最小字段集。
-
-## 6. 回滚方案
-- **SQL**：执行 `DROP FUNCTION IF EXISTS public.rpc_admin_...`。
-- **代码**：通过 Git 回退 `pages/mall/admin/product/` 相关目录的变更。
-
-## 7. 验证方式
-1. 登录 Admin 账号，进入“商品管理”，验证列表分页与搜索是否正常。
-2. 切换商品“上架/下架”开关，刷新页面确认状态持久化。
-3. 进入“商品分类”，尝试添加子分类并移动其父级，通过数据库查询确认其 `path` 已级联修正。