海外版同城系统含外卖、跑腿等多模块时若 i18n 与 payment profile 耦合成一次发布回滚风险大。宜语言包与支付通道分开测模块级biz_switches与全局locale独立版本。配置分层{locale_version:L-20260930.1,payment_profile_id:sg-wallet-v2,biz_switches:{waimai:true,paotui:false}}拉取接口app.get(/api/global/config)defglobal_config(if_none_match:str):cfgload_merged_config()ifif_none_matchcfg[etag]:returnResponse(status304)returncfg分开测段1换 locale验 UI不下单。段2固定 locale沙箱支付。段3开第二模块开关验菜单与支付 profile 不变。客服后台 localeadmin_ui_locale可与user_locale独立导出模板用export_locale。光合同城边界光合同城海外版支持多模块开关与语言/支付解耦按需定制各国对接。小结海外版同城系统语言包和支付通道分开测模块扩城时不拖死支付验收。模块开关与 locale 并行 bumpdefopen_module(module_code:str):cfgload_for_update()cfg[biz_switches][module_code]Truecfg[config_version]bump(cfg[config_version])save(cfg)# locale_version 不变payment_profile_id 不变端侧收到 config_version 变更小程序onShow拉配置对比本地 version变更则rebuildHomeMenu()不必发版。支付 profile 跨国切换defresolve_payment_profile(country:str)-str:returnsettings.PAYMENT_PROFILES[country]# 与 locale 无耦合回归用例换语言包locale_version 1payment_profile 不变biz_switches 不变。换支付 profilelocale_version 不变payment_profile 变biz_switches 不变。开跑腿模块locale_version 不变payment_profile 不变biz_switches 中 paotuitrue。日志与排错config 变更写 audit谁、何时、改了哪键、新旧 version。支付失败排错看 profile_id不必猜是否语言发布连带。光合同城边界海外版综合成品支持上述解耦各国通道与税务按需定制不写全球统一自动分账。小结海外版同城系统语言包与支付通道分开测靠独立 version 与 audit模块开关第三维独立 bump扩城不拖死支付验收。ETag 与 304app.get(/api/config)defconfig(if_none_match:strHeader(None)):etagcurrent_etag()ifif_none_matchetag:returnResponse(status304)returnJSONResponse(load_config(),headers{ETag:etag})小程序省流量但config_version变更必须 bump etag。多模块菜单合并defmerged_home_entries(cfg):entries[]forcode,onincfg[biz_switches].items():ifon:entries.extend(MODULE_ENTRIES[code])returndedupe_by_route(entries)客服后台只读 replica客服查单可走 replica改配置、改开关必须走主库。读写分离边界写进运维手册。小结补述海外版同城系统语言、支付、模块开关三维 version端侧只认config_version聚合 etag 亦可但审计要分键记录。开第二模块要不要重接支付海外版同城系统语言包与支付通道分开测第三维是模块开关开跑腿不应 bump 语言版本也不应切换支付 profile。回归用例宜写清换语言包时支付 profile 不变换支付 profile 时语言版本不变开第二模块时前两维都不变只改业务开关。端侧收到配置版本变更后重建首页菜单不必发版。配置变更写审计日志谁、何时、改了哪键、新旧版本支付失败排错看 profile 标识不必猜是否语言发布连带。客服后台语种可与用户端不同导出列名宜与商家财务习惯一致。扩城时复制第一城的 mapping 与语言包结构比口头重新约定省重复沟通。ETag 与配置版本 bump 后小程序宜在 onShow 拉配置重建菜单省流量但不漏变更。客服查单走只读副本改开关走主库读写边界写进运维手册。三维版本独立 bump语言版本、支付 profile、模块开关各自独立变更与回滚。审计日志记录谁改了哪键支付失败排错看 profile 标识。端侧 onShow 拉配置对比版本变更后重建菜单不必发版也能关未开通入口。回归用例宜覆盖换语言包时支付 profile 不变换 profile 时语言版本不变开第二模块时前两维都不变。客服查单可走只读副本改开关走主库读写边界写进运维手册扩城时不拖死支付验收。ETag 与配置版本 bump 后小程序 onShow 拉配置重建菜单省流量但不漏变更多模块菜单合并时按路由去重避免重复入口。扩城可复制模板。