39 lines
2.5 KiB
Markdown
39 lines
2.5 KiB
Markdown
# Design: H5 运营弹窗配置管理（管理后台）
|
||
|
||
## 页面结构
|
||
|
||
- 设置管理下新增「H5运营弹窗配置」入口（仅超管/平台）：
|
||
- 列表页 `src/views/settings/h5-popup-configuration/index.vue`
|
||
- 创建/编辑表单弹窗（复用 ArtForm + ArtSearchBar/ArtTable 模式）
|
||
- 详情以弹窗/抽屉展示完整配置
|
||
- 分页、筛选、表格沿用 ArtTable / ArtSearchBar / ArtTableHeader 与统一响应结构（`code/msg/timestamp/data`、分页 `items/page/size/total`）。
|
||
|
||
## 接口与类型
|
||
|
||
- 新增 `src/api/modules/h5PopupConfiguration.ts` 与 `src/types/api/h5PopupConfiguration.ts`：
|
||
- `GET /api/admin/h5-popup-configurations`（page/page_size/enabled，倒序分页）
|
||
- `POST /api/admin/h5-popup-configurations`（创建）
|
||
- `GET /api/admin/h5-popup-configurations/{id}`（详情）
|
||
- `PUT /api/admin/h5-popup-configurations/{id}`（更新，整表提交，版本 +1）
|
||
- `POST /api/admin/h5-popup-configurations/{id}/enable`、`{id}/disable`（请求体 `{ id }`，返回更新后配置）
|
||
- 枚举映射常量集中放置：`pages`（home/asset_detail/package_purchase/asset_wallet_recharge）、`frequency`（once/daily）、`action_type`（package_purchase/asset_wallet_recharge，空字符串 = 无）、`card_types`（CMCC/CUCC/CTCC/CBN）。
|
||
|
||
## 表单约定
|
||
|
||
- `pages` 多选必填（空数组非法）；`title`（1–100）/`content`（1–2000）/`frequency`/起止时间必填。
|
||
- 范围三选器（店铺/设备类型/卡类型）空数组 = 全量，回显「全部」。
|
||
- 起止时间用 datetimerange，提交转 ISO 8601（`starts_at`/`ends_at`），`ends_at` 不得早于 `starts_at`。
|
||
- `priority` 数字输入（0–1000000）；`enabled` 开关；`action_type` 下拉（含「无」选项，提交空字符串清除受控动作）。
|
||
- 编辑表单整表提交；编辑保存成功后提示「每次更新版本递增，旧版本通知保留原快照，新版本可向原命中客户按频率重新投放一次」。
|
||
- 启用/停用为行操作（停用需二次确认），以接口返回的更新后配置刷新当前行。
|
||
|
||
## 权限与可见性
|
||
|
||
- 权限码：`h5_popup_configuration:list`（菜单/列表）、`:create`、`:update`、`:enable`、`:disable`。
|
||
- 路由 `meta.permissions` + 按钮 `v-permission`/`usePermission`，仅超管/平台可见；代理/企业/个人由后端 403 兜底并原文透传失败文案。
|
||
- 不提供删除入口（文档无 DELETE 接口）。
|
||
|
||
## 待确认
|
||
|
||
- 权限编码以后端菜单配置为准（前端默认 `h5_popup_configuration:list/create/update/enable/disable`）。
|