BeeX 配置目录
本目录回答四件事：配置属于哪个服务、谁可以修改、何时生效、历史订单是否受影响。
总原则：影响钱的配置必须版本化，并按订单下单时间命中有效版本；订单收益保存快照。运行开关可以即时生效，但必须记录操作人、环境和时间。测试与正式配置分开，发布正式环境必须明确执行。
配置归属
admin-service
负责管理入口、飞书 SSO/RBAC、配置版本发布、活动编排、展示位、热门品牌、H5 包和文案编辑权限。所有写操作记录真实操作人。
business service
负责读取已生效配置并执行转链、订单、返佣、活动权益、钱包和提现。业务接口不能直接修改管理配置。
ai-ops-worker
负责异步 Git 写回、文案同步、巡检和运维任务；使用独立数据库，不与业务库或 admin-service 库混用。
云效与环境变量
负责平台密钥、数据库、Redis、OSS、MQ、Webhook 等部署凭据。密钥不写进 Git、文档或流水线脚本文本，只通过密钥组注入。
现行配置模块
| 模块 | 主要配置 | 生效与快照 | 归属 | 风险 |
|---|---|---|---|---|
| 佣金系数 | maxCommissionBaseBps、CPS 区间 × 商品类型的分档（每档必填技术服务费、用户分配比例、直接邀请人推广比例）、释放时间 | 版本化；按下单时间命中；订单保存基础返现和活动奖励快照 | /api/v1/admin/config-console/api/v1/admin/config/rule-versions | 高 |
| 活动与券 | 事件、条件、动作、券模板、额度、比例、有效期、预占/核销/退回、人群和参加次数 | 活动时间窗 + 幂等动作记录；订单创建时预占，取消/退款时释放或顺延 | /api/v1/admin/campaigns | 高 |
| 运营展示位 | 图片、跳转目标、展示时机、优先级、频控、语言、版本和用户标签 | 发布后供 App/H5 拉取；素材删除时同步清理 OSS 对象 | /api/v1/admin/campaign-placements | 中 |
| 商品与 BeeX 活动商品 | 商品类型、平台、商品 ID、活动标签、开始/结束时间、排序、下架原因 | 活动到期自动回落到平台真实类型；列表和详情返回同一分类快照 | 商品运营模块 | 高 |
| 热门品牌 | 平台、品牌名、关键词、店铺 ID、图标、背景图、说明、排序、启用状态，以及按品牌配置的固定商品链接列表 | 支持单条补录和 Excel 批量导入；链接解析后按平台商品 ID 去重，相同商品的不同分享链接只保留一条。添加、刷新、排序、停用或删除商品都会更新品牌时间戳，使 App 缓存失效并后台刷新。未配置固定商品时才回退到关键词/店铺搜索 | /api/v1/admin/popular-brands/api/v1/admin/popular-brands/{brandId}/products/api/v1/admin/popular-brands/{brandId}/products/import | 中 |
| 提现 | 最低/最高金额、每日次数、手续费、KYC、支付密码、支持渠道、审核与风控开关 | 申请时保存规则快照；后续修改不改变已创建提现单 | /api/v1/admin/withdraws 与提现规则配置 | 高 |
| H5 离线包 | 版本、环境、灰度用户/设备、Native 版本范围、强制更新、启用、发布和回滚 | 测试发布 → 转正式 → 正式灰度 → 正式发布；每步记录发布人 | /api/v1/admin/h5-packages | 高 |
| 运行时开关 | 客户端功能开关、最低版本、平台入口、调试能力和紧急降级 | 可即时生效；不得承载资金比例或长期业务规则 | /api/v1/admin/config/runtime-features | 中 |
| 文案中心 | 翻译账号权限、语言值、修改记录和待写 Git 批次 | 测试 App 保存到 admin-service；统一确认后由 AI Ops Worker 提交 Git，随 H5 包发布 | /api/v1/admin/i18n/api/v1/i18n/editor | 中 |
| 平台集成 | TikTok/Shopee/Lazada/Xendit/WhatsApp 的账号标识、Token、scope、Webhook 和路由 | 按国家、环境和账号隔离；密钥只从部署环境读取 | 环境变量 + 平台账号管理 | 高 |
资金配置发布规则
- 在印尼测试环境新建版本，填写修改原因和计划生效时间。
- 用固定订单样例验证预览金额、订单快照、活动预占、退款释放和钱包入账。
- 把同一配置内容转移到印尼正式环境；正式环境生成自己的版本 ID，但保留来源版本和操作人。
- 先灰度指定测试账号，再发布全部用户。旧订单继续使用其原快照。
- 回滚只能创建一个新的生效版本，不能覆盖或删除已经被订单引用的版本。