28 lines
2.5 KiB
Markdown
28 lines
2.5 KiB
Markdown
# 天宫列表与详情素材字段
|
||
|
||
## 展示规则
|
||
|
||
- 正式模式列表图沿用后端 `iconUrl`（数据库 `icon_url`）。未绑定仍按现有 `opacity: .2` 淡化，不改灰度；已绑定正常显示。
|
||
- 详情主神像与祈愿／回向弹窗神像使用 `iconDetailUrl`（数据库 `icon_detail_url`），不再使用本地原型神像，也不使用列表缩略图顶替。
|
||
- 介绍使用 `description`，仅在未恭请神仙的请神页显示并保留换行；已绑定的敬神页不展示介绍，也不展示“暂无介绍”占位。
|
||
- 详情图缺失显示“详情图片暂未配置”；加载失败显示“详情图片加载失败”；空介绍显示“暂无介绍”。不补写神仙介绍。
|
||
- 显式 `preview=1`／`avatarDemo=1` 仍为独立 Mock，只使用原型素材，不用于验证真实后端字段。
|
||
|
||
## 接口
|
||
|
||
继续复用 JWT 接口 GET `/api/tiangong/items`，不新增请求，不调用尚未接入的独立详情接口。该接口同时返回 `iconUrl`、`iconDetailUrl`、`description`、`active` 及持有关系和统计。后端现有代码已查询并返回这些字段、解析存储地址，本次未修改后端或执行SQL。
|
||
|
||
## 开发者工具验收
|
||
|
||
1. 导入项目并重新编译，使用真实账号登录，不使用H5演示参数。
|
||
2. 天宫列表：已绑定显示原图，未绑定仍显示同一图片的20%透明度效果。
|
||
3. 查看 Network 中 GET `/api/tiangong/items` 返回的三个字段。进入对应神仙详情，主神像应对应 `iconDetailUrl`；未恭请的请神页介绍与 `description` 一致，不能显示另一份本地原型介绍。
|
||
4. 已绑定神仙进入敬神页，不应显示介绍或介绍占位；上香等按钮正常显示。打开祈愿／回向弹窗，弹窗神像也对应详情图，不能换回本地图片。
|
||
5. 服务端未配置图片／介绍时按上述提示展示；图片不可访问时显示加载失败。返回列表不改变未绑定图片效果。
|
||
|
||
## 验证与边界
|
||
|
||
108项前端测试、TypeScript、H5／微信构建、13个微信原生WXSS编译检查通过。测试覆盖请神页显示介绍、敬神页不显示介绍或占位、详情与弹窗、字段缺失及加载失败、更新及账号切换。微信产物2,022,607 bytes，低于2MiB。
|
||
|
||
本机浏览器真实模式停在登录入口，尚未通过真实账号验证远程图片和介绍；未绕过登录、未修改远程数据。后端已有的未提交改动、本机 project.config.json 均保留。本次未自动提交、推送或部署后端。
|