227 lines
6.7 KiB
Markdown
227 lines
6.7 KiB
Markdown
# 安心验静态数据与展示映射审计
|
||
|
||
审计时间：2026-04-23
|
||
|
||
## 一、已确认的真实问题
|
||
|
||
### 1. 后台订单详情页存在“接口有值但页面没展示完整”的问题
|
||
|
||
- 文件：`admin-web/src/pages/orders/index.vue`
|
||
- 现象：
|
||
- 接口已返回 `product_info.color`
|
||
- 接口已返回 `extra_info.condition_desc` / `remark`
|
||
- 页面原先只展示了 `size_spec` 和 `usage_status`
|
||
- 导致后台看到的内容与接口实际内容不一致，且卡片出现大面积空白
|
||
- 本轮已修复：
|
||
- 商品信息区补充 `颜色 / 规格`
|
||
- 补充信息区补充 `补充说明`
|
||
|
||
### 2. 鉴定作业台也存在同类字段遗漏
|
||
|
||
- 文件：`admin-web/src/pages/appraisal-tasks/index.vue`
|
||
- 现象：
|
||
- 页面已有 `product_info.color`
|
||
- 但工作区与上下文区未展示，导致检测侧看到的信息不完整
|
||
- 本轮已修复：
|
||
- 商品与送检区补充 `颜色 / 规格`
|
||
- 工作台左侧上下文区补充 `颜色 / 规格`
|
||
|
||
### 3. 用户端多个页面在接口失败时会静默回退到 mock 数据
|
||
|
||
- 风险级别：高
|
||
- 问题本质：
|
||
- 页面请求失败后，没有给用户明确错误态
|
||
- 而是继续显示 `src/mocks/app.ts` 中的示例数据
|
||
- 会造成“接口已经失败，但页面仍像有真实数据”的错觉
|
||
- 这类问题比普通静态文案更危险，因为会直接影响业务判断
|
||
|
||
## 二、前端仍在使用 mock / fallback 的页面
|
||
|
||
### 1. 用户端高风险页面
|
||
|
||
以下页面在请求失败时，会直接沿用 mock 或 fallback 数据：
|
||
|
||
- `user-app/src/pages/home/index.vue`
|
||
- `user-app/src/pages/address/index.vue`
|
||
- `user-app/src/pages/message/index.vue`
|
||
- `user-app/src/pages/mine/index.vue`
|
||
- `user-app/src/pages/order/detail.vue`
|
||
- `user-app/src/pages/order/shipping.vue`
|
||
- `user-app/src/pages/report/detail.vue`
|
||
- `user-app/src/pages/help/index.vue`
|
||
- `user-app/src/pages/help/detail.vue`
|
||
- `user-app/src/pages/settings/index.vue`
|
||
- `user-app/src/pages/support/index.vue`
|
||
- `user-app/src/pages/support/detail.vue`
|
||
- `user-app/src/pages/support/create.vue`
|
||
- `user-app/src/pages/verify/result.vue`
|
||
|
||
统一来源：
|
||
|
||
- `user-app/src/mocks/app.ts`
|
||
|
||
### 2. 风险说明
|
||
|
||
- 订单、报告、消息、地址、工单、验真都属于真实业务数据
|
||
- 这些页面不适合在接口失败时展示示例数据
|
||
- 正确策略应该是：
|
||
- 显示错误态
|
||
- 提供重试按钮
|
||
- 保留空态，但不能伪造业务内容
|
||
|
||
## 三、后端接口本身仍是静态拼装的数据
|
||
|
||
### 1. 首页接口
|
||
|
||
- 文件：`server-api/app/controller/app/HomeController.php`
|
||
- 当前静态内容：
|
||
- `banners`
|
||
- `service_entries`
|
||
- `quick_entries`
|
||
- `trust_metrics`
|
||
- `trust_points`
|
||
- `faqs`
|
||
- 当前只有 `category_entries` 来自数据库
|
||
|
||
补充说明：
|
||
|
||
- `user-app/src/pages/home/index.vue` 原先没有消费 `banners`
|
||
- 即使接口已经返回首页头图文案，前端页面也仍然使用写死标题
|
||
- 本轮已修复为直接读取接口 `banners[0]`
|
||
|
||
### 2. 帮助中心接口
|
||
|
||
- 文件：`server-api/app/controller/app/HelpCenterController.php`
|
||
- 当前问题：
|
||
- 帮助分类与文章内容全部写在控制器里
|
||
- 搜索和分类筛选只是对本地数组做过滤
|
||
- 结论：
|
||
- 当前帮助中心已经“可用”，但本质仍是写死内容，不是后台可运营内容
|
||
|
||
### 3. 设置页协议入口
|
||
|
||
- 文件：`server-api/app/controller/app/SettingsController.php`
|
||
- 当前静态内容：
|
||
- `legal_entries`
|
||
- 跳转的帮助中心关键词
|
||
|
||
### 4. 下单预览协议文案
|
||
|
||
- 文件：`server-api/app/controller/app/AppraisalController.php`
|
||
- 当前静态内容：
|
||
- `preview()` 中的 `agreements`
|
||
- `service_agreement`
|
||
- `privacy_policy`
|
||
- `appraisal_notice`
|
||
|
||
## 四、前端仍然硬编码的业务选项
|
||
|
||
这些不一定是 bug，但如果要达到“后台可维护、线上可运营”的标准，后续建议逐步改成可配置或接口下发。
|
||
|
||
### 1. 用户端
|
||
|
||
- `user-app/src/pages/support/create.vue`
|
||
- 工单类型 `typeOptions`
|
||
- `user-app/src/pages/support/index.vue`
|
||
- 常见问题快捷入口 `quickTypes`
|
||
- `user-app/src/pages/appraisal/product.vue`
|
||
- 颜色建议 `colorSuggestions`
|
||
- 规格建议 `sizeSuggestions`
|
||
- `user-app/src/pages/appraisal/extra.vue`
|
||
- 购买渠道
|
||
- 使用情况
|
||
- 附件情况
|
||
|
||
### 2. 管理后台
|
||
|
||
- `admin-web/src/pages/orders/index.vue`
|
||
- 服务筛选项
|
||
- 状态筛选项
|
||
- `admin-web/src/pages/appraisal-tasks/index.vue`
|
||
- 阶段筛选项
|
||
- 状态筛选项
|
||
- 结果选项
|
||
- `admin-web/src/pages/reports/index.vue`
|
||
- 服务筛选项
|
||
- 报告状态项
|
||
- 结果项
|
||
- `admin-web/src/pages/tickets/index.vue`
|
||
- 工单类型与状态筛选
|
||
|
||
说明：
|
||
|
||
- 这类枚举型选项短期内可以先保留
|
||
- 但工单类型、结果模板、服务文案如果未来需要运营调整，建议迁移为后台字典表或系统配置
|
||
|
||
## 五、已发现的“假入口 / 假交互”
|
||
|
||
- `user-app/src/pages/appraisal/upload.vue`
|
||
- `查看示例` 按钮无实际功能
|
||
- `查看拍摄示例` 入口无实际功能
|
||
- `user-app/src/pages/home/index.vue`
|
||
- 未识别的快捷入口会落到“该功能正在完善中”
|
||
- `user-app/src/pages/mine/index.vue`
|
||
- 未识别入口也会落到“该功能正在完善中”
|
||
|
||
## 六、推荐开发顺序
|
||
|
||
### P0：先清掉会误导真实业务判断的 fallback
|
||
|
||
优先处理以下页面：
|
||
|
||
- 订单详情
|
||
- 报告详情
|
||
- 消息中心
|
||
- 地址管理
|
||
- 工单列表 / 工单详情
|
||
- 设置页
|
||
- 验真页
|
||
|
||
目标：
|
||
|
||
- 失败时显示明确错误状态，不再显示 mock 业务数据
|
||
|
||
### P1：把接口里已返回但页面没展示完整的字段补齐
|
||
|
||
优先处理以下模块：
|
||
|
||
- 后台订单详情
|
||
- 鉴定作业台
|
||
- 用户端订单详情
|
||
- 报告详情页的商品摘要 / 估值摘要一致性
|
||
|
||
目标：
|
||
|
||
- 页面展示与接口字段保持一致
|
||
- 同一份订单数据在用户端、后台、报告端口径一致
|
||
|
||
### P2：把后端静态内容迁移为可维护内容
|
||
|
||
优先处理：
|
||
|
||
- 首页内容
|
||
- 帮助中心
|
||
- 设置页协议入口
|
||
- 下单预览协议区
|
||
|
||
推荐做法：
|
||
|
||
- 新建内容配置表 / 帮助中心表 / 协议配置表
|
||
- 后台增加内容维护入口
|
||
- 用户端改为读取接口配置
|
||
|
||
### P3：把前端硬编码枚举逐步改为字典化
|
||
|
||
优先处理：
|
||
|
||
- 工单类型
|
||
- 鉴定结果模板
|
||
- 用户端下单辅助枚举
|
||
|
||
## 七、建议的下一步落地动作
|
||
|
||
1. 先移除用户端业务页面对 `user-app/src/mocks/app.ts` 的依赖，改为错误态 + 重试。
|
||
2. 统一订单 / 报告 / 鉴定任务三端字段口径，补齐 `color`、`condition_desc`、`remark`、`accessories` 等实际字段。
|
||
3. 设计内容配置模型，把首页、帮助中心、协议说明迁到后台管理。
|
||
4. 最后再做字典化，把工单类型、辅助选项、结果模板迁到接口配置。
|