business-common 公共业务模块
模块概述
提供跨业态复用的公共能力。当前首期实现 业务业态场景注册表（cfg_biz_scene），用于统一维护场景编号、管理端选品元数据与扩展 JSON（小程序路径等）。
设计文档：xinghuacun_travel_doc/architecture/业务业态场景注册表设计.md
模块结构
business-common/
├── business-common-api/ # BizSceneApi 跨模块契约
├── business-common-bean/ # 含 BizScenePickerSupport、BizSceneCouponLegacySupport 等
├── business-common-service/
├── business-common-application/
└── business-common-controller/
扩展解析（bean/support）
| 类 |
用途 |
BizScenePickerSupport |
ext_json.pickers（COUPON_SCOPE / BANNER_TARGET）覆盖 admin_list_url |
BizSceneCouponLegacySupport |
券 legacy scene_code ↔ 注册表 canonical 映射 |
BizSceneMobileJumpSupport |
ext_json.mobile 小程序路径 |
BizSceneAdminListRecordSupport |
管理端分页列表 records 解析 |
框架枚举（FRAME）
| 类 |
用途 |
IntValueEnum / StringValueEnum |
整型/字符串存库枚举标记接口 |
EnumValueSupport |
fromValue / getDescByValue 统一实现 |
ShelfStatusEnum、VerticalPayStatusEnum 等 |
跨业态复用枚举，均实现上述接口 |
数据库
| 脚本 |
说明 |
doc/sql/business-common/cfg_biz_scene_schema.sql |
建表 |
doc/sql/business-common/cfg_biz_scene_seed.sql |
种子数据（节选） |
doc/sql/business-common/cfg_biz_scene_menu_permission.sql |
菜单与权限 |
doc/sql/business-common/cfg_biz_scene_upgrade_existing.sql |
存量库升级顺序（联调前置） |
管理端接口
前缀：${jeesharp.web.adminPath}/common/bizScene/v1
| 操作 |
方法 |
URL |
权限 |
| 分页列表 |
POST |
list |
manager:business:common:bizScene:list |
| 详情 |
GET |
info?id= |
manager:business:common:bizScene:info |
| 新增 |
POST |
create |
manager:business:common:bizScene:create |
| 更新 |
POST |
update |
manager:business:common:bizScene:update |
| 删除 |
GET |
delete?ids= |
manager:business:common:bizScene:delete |
| 启用选项 |
GET |
enabledOptions?capability= |
manager:business:common:bizScene:list |
capability 可选值：COUPON、BANNER、NAV。
版本记录
| 版本 |
日期 |
说明 |
| 1.5 |
2026-07-03 |
E：biz_coupon_scene 退役种子；轮播 create/update 拆分；前端删除 presets |
| 1.4 |
2026-07-03 |
ARCH：FoodFinanceReadApi/HotelFinanceReadApi 上收 -api；PAY：scenic/hotel *BookingPayAssembler |
| 1.3 |
2026-07-03 |
ARCH：ScenicFinanceReadApi 上收 scenic-api；PAY 退款：BookingRefundTailSupport 商城售后接入 |
| 1.2 |
2026-07-03 |
FRAME：IntValueEnum/EnumValueSupport；PAY：VerticalPayPrepareSupport（pay-bean） |
| 1.1 |
2026-07-03 |
BizSceneApi、Picker 解析；券/轮播桥接 |
| 1.0 |
2026-07-03 |
首期：cfg_biz_scene CRUD + enabledOptions |
