mirror of
https://github.com/fastapiadmin/FastapiAdmin.git
synced 2026-09-23 21:18:09 +00:00
refactor: 小程序端代码瘦身与功能补齐
- 清理冗余代码与配置: - 删除废弃的 mock 适配器、通用 mock 模块与示例API - 移除冗余的 ts 类型文件与 patch 目录 - 简化 tsconfig 组件路径配置 - 新增功能与优化: - 新增全局水印组件与水印配置 - 接入微信小程序登录/手机号登录 - 新增系统参数配置 store 与国际化支持 - 新增 markdown 渲染插件与样式配置 - 优化 pinia 持久化逻辑修复 - 新增微信小程序 access_token 缓存配置 - 修复登录趋势数据结构定义 - 优化全局请求防抖重定向逻辑 - 页面与路由优化: - 补全引导页首次启动逻辑 - 统一页面底部安全区适配 - 更新页面路由类型声明 - 代码质量优化: - 移除无用 console.log 调试代码 - 修复全局弹窗重复重登录问题 - 优化 mp-html 组件配置
This commit is contained in:
@@ -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 为上线前待办(非阻断)
|
||||
Reference in New Issue
Block a user