# 退款政策简化 + 预订须知必填校验 ## 日期 2026-03-22 --- ## 一、退款政策管理简化 ### 变更说明 退款政策现在**直接绑定到产品**,不再区分退款类型,不再有默认政策概念。 ### 删除的字段 | 接口 | 删除字段 | 说明 | |------|---------|------| | 退款政策列表/详情 VO | `refundType` | 不再区分定金/全款/尾款类型 | | 退款政策列表/详情 VO | `isDefault` | 不再有默认政策概念 | | 退款政策创建/修改请求 | `refundType` | 同上 | | 退款政策创建/修改请求 | `isDefault` | 同上 | | 产品详情 VO | `refundPolicyId` | 已废弃,用 refundPolicyIds | | 产品详情 VO | `refundPolicyName` | 已废弃 | ### 退款政策列表页(退款管理 > 退款政策) **需要删除的列:** - ~~退款类型~~ - ~~生效开始~~ - ~~生效结束~~ - ~~默认~~ **保留的列:** - 政策名称 - 规则数(规则条数) - 状态(启用/禁用) - 创建时间 - 操作 ### 退款政策创建/修改表单 **需要删除的字段:** - ~~退款类型(DEPOSIT/BALANCE/FULL 下拉)~~ - ~~是否默认(开关)~~ **保留的字段:** - 政策名称(必填) - 备注(选填) - 退款规则列表(必填,每条规则包含:距出发天数 + 退款比例%) ### 接口无变化 - `GET /admin/order/refund-policy/list` — 退款政策列表 - `GET /admin/order/refund-policy/enabled` — 启用的政策列表(产品设计选择用) - `GET /admin/order/refund-policy/{policyId}` — 政策详情 - `POST /admin/order/refund-policy` — 创建政策 - `PUT /admin/order/refund-policy/{policyId}` — 修改政策 - `DELETE /admin/order/refund-policy/{policyId}` — 删除政策(不再限制"默认不能删") - `PUT /admin/order/refund-policy/{policyId}/toggle?enabled=true/false` — 启用/禁用 --- ## 二、产品退款政策绑定(按支付方式映射) ### `refundPolicyIds` 字段格式(Map,不变) ```json { "refundPolicyIds": { "FULL": "3", "DEPOSIT": "1", "BALANCE": "4" } } ``` - key = 支付类型:`FULL`(全款)、`DEPOSIT`(定金)、`BALANCE`(尾款) - value = 退款政策ID(从 `GET /admin/order/refund-policy/enabled` 获取) - 退款政策本身不再区分类型,任何政策都可以绑定到任何支付类型 ### 退款政策与支付方式的关系 | 支付方式 | 需要配置的退款政策 | |---------|------------------| | 全款支付 (FULL) | FULL | | 定金+尾款 (DEPOSIT) | DEPOSIT + BALANCE | **上架/完成时自动校验**:系统根据产品的支付方式(`product_pricing.payment_type`)检查 `refundPolicyIds` 中是否配置了对应的退款政策。缺少则校验不通过。 --- ## 三、产品上架/完成新增必填校验 以下字段在**上架(PUBLISHED)**和**定制完成(COMPLETED)**时必须填写,否则校验不通过: | 字段 | 说明 | 选择来源 | |------|------|---------| | `bookingTermsId` | 预订条款 | `GET /admin/product/booking-terms/enabled` | | `refundPolicyIds` | 退款政策(按支付方式映射) | `GET /admin/order/refund-policy/enabled` | | `warmTipsId` | 温馨提示 | `GET /admin/product/warm-tips/enabled` | | `insuranceSchemeId` | 保险方案 | 已有 | | `contractSchemeId` | 合同方案 | 已有 | --- ## 四、所有产品改为预约产品 所有产品的 `isBooking` 已设为 `true`(预约产品)。产品列表"预约"列应全部显示"是"。