refactor: 小程序端代码瘦身与功能补齐

- 清理冗余代码与配置:
  - 删除废弃的 mock 适配器、通用 mock 模块与示例API
  - 移除冗余的 ts 类型文件与 patch 目录
  - 简化 tsconfig 组件路径配置
- 新增功能与优化:
  - 新增全局水印组件与水印配置
  - 接入微信小程序登录/手机号登录
  - 新增系统参数配置 store 与国际化支持
  - 新增 markdown 渲染插件与样式配置
  - 优化 pinia 持久化逻辑修复
  - 新增微信小程序 access_token 缓存配置
  - 修复登录趋势数据结构定义
  - 优化全局请求防抖重定向逻辑
- 页面与路由优化:
  - 补全引导页首次启动逻辑
  - 统一页面底部安全区适配
  - 更新页面路由类型声明
- 代码质量优化:
  - 移除无用 console.log 调试代码
  - 修复全局弹窗重复重登录问题
  - 优化 mp-html 组件配置
This commit is contained in:
zhangtao
2026-08-05 23:47:49 +08:00
parent 372b277a9f
commit ffbe2453f2
126 changed files with 5288 additions and 12246 deletions
+57
View File
@@ -0,0 +1,57 @@
# 小程序页面优化报告
**日期**: 2026-08-05
**范围**: 16 个页面全面体检 + 4 处优化修复
---
## 一、体检结论
小程序 16 个页面功能完整、质量较高:
- **首页**index):轮播 Banner / 快捷入口 / 运营概览 / ECharts 登录趋势 / 最新公告
- **工作台**(work):用户卡 / 模块搜索 / 分组导航
- **我的**(mine):用户卡 / 工单统计 / 快捷入口 / 设置列表
- **工单管理**tickets):搜索 / 状态 Tab 吸顶 / 类型下拉 / 时间范围 / 左滑删除 / 分页 / 悬浮新增
- **AI 助手**(chat):流式对话 / 多会话 / 消息窗口化渲染(防长会话卡顿)
- **引导页**onboarding):4 屏渐变引导
## 二、优化项(4处)
| # | 文件 | 优化内容 | 类型 |
|---|------|----------|------|
| 1 | `pages/index/index.vue` | 通知栏接入**真实公告**`recentNotices[0]`),移除硬编码假消息;无公告自动隐藏;点击跳转公告列表 | 上线阻断修复 |
| 2 | `composables/useListPage.ts` | `loadData()` 增加 `uni.stopPullDownRefresh()`,修复**所有列表页下拉刷新指示器不收起**的 bug(工单/公告页共用,一处生效) | 体验 bug 修复 |
| 3 | `pages/mine/index.vue` | 移除无效 `hover-class="wot-bg-bg"`,改用 `hover-class="none"` + `active:opacity-70` | 样式修正 |
| 4 | `pages/index/index.vue` | Banner 装饰圆环增加**极光呼吸动效**(`banner-orbit`,transform 动画真机性能友好) | 视觉增强 |
## 三、验证
-`vue-tsc --noEmit` 通过,0 错误
## 四、遗留待办(上线前)
| 事项 | 说明 |
|------|------|
| 首页登录趋势为 mock 数据 | 后端暂无趋势接口,已标注。上线前需接入真实接口(或后端补 `dashboard/login-trend` 接口) |
| 小程序 AppID | 未申请,`manifest.config.ts` 仍为占位符 |
| 订阅消息模板 ID | 未配置,`useSubscribeMessage.ts``TEMPLATE_IDS` 为空 |
---
## 第二轮:小程序化优化(23:35)
### 优化项(批量安全区适配 + 合规确认)
| # | 文件 | 优化内容 | 类型 |
|---|------|----------|------|
| 1 | `about` / `ai-models` / `setting` / `notices` / `tickets` | 底部统一加 `<wd-gap safe-area-bottom />`,全面屏 Home 条避让 | 小程序化 |
| 2 | `tickets/index.vue` | `wd-fab``:gap="{ bottom: 40 }"` 上移避让 Home 条(组件源码确认无内置 safe-area) | 小程序化 |
| 3 | 注册页(审计确认) | 已有用户协议勾选(`agreeRead` + 协议链接)— **小程序上架审核必备项** | 合规确认 |
### 小程序规范体检结论
- ✅ 16 页全部具备:导航标题、底部安全区、骨架屏/空状态、分享(useShare)、下拉刷新
-`window.open` 均有 `#ifdef H5` 包裹,小程序端不编译无泄漏
- ✅ chat / ticket-detail 输入区均已处理 `env(safe-area-inset-bottom)`
- ✅ 注册/忘记密码页 100vh 已有 H5/小程序条件编译适配
- ⚠️ 登录趋势 mock 数据、AppID、订阅消息模板 ID 为上线前待办(非阻断)