单业态初创团队在中东部署出海外卖平台时技术评审里除了问「五端齐不齐」更该问「合规字段放哪一层、支付通道如何按需对接、RTL 与跑单层是否解耦」。若税务展示、小票模板、支付回调与营销模块焊在同一代码路径里上线后加第二种当地支付或改阿语文案就要全链回归全套高预算很快烧在隐性返工上。下文从分层架构、合规配置 YAML、支付桥接边界说明「跑单层、合规层、支付层、展示层」怎么拆。示例为教学示意以光合同城当期海外交付为准。海外支付与税务各国不同支持按需定制对接不默认某一国税制商务结算规则由客户在当地自行确定。痛点合规、支付、RTL 焊成一条链中东试水常见反模式税务字段写死在OrderService字符串里改小票税号要发版支付 PSP 选择与locale绑定切阿语触发重建 PaymentIntentRTL CSS 与购物车组件耦合改布局连带支付页回归结算导出列硬编码财务要的当地核对项凑不齐只能二次开发后果很直观上线第二个月加第二种本地钱包要连 RTL 一起重测财务追问服务费展示口径发现字段散落在三个模块。出海外卖平台若走分层架构应先冻结合规配置与支付桥接契约再谈 UI 有多少语言包。评审时可先问改税务展示是否只动 YAML加 PSP 是否不动订单状态机RTL 切换是否不重建支付意图答不上来隐性成本多半在合同外。模块目录树跑单层、合规层、支付层分离overseas-wm-mena/ ├── apps/ │ ├── diner-app/ # RTL 布局层 │ ├── merchant-app/ │ ├── rider-app/ │ └── admin-console/ ├── takeout-core/ # 跑单层 │ ├── order-hub/ │ ├── catalog-snapshot/ │ └── fulfillment-bridge/ ├── compliance-layer/ # 合规层按国配置 │ ├── receipt-template/ │ ├── tax-display-fields/ │ ├── export-profile/ │ └── delivery-rule-pack/ ├── payment-bridge/ # 支付桥按需对接 │ ├── channel-registry/ │ ├── intent-factory/ │ ├── webhook-ingress/ │ └── reconcile-read/ ├── i18n/ │ ├── message-catalog/ │ └── rtl-layout-tokens/ ├── master-data/ │ ├── user-master/ │ └── merchant-master/ └── ops/ ├── mena-uae-compliance.yaml ├── payment-channels.yaml └── export-columns-ar.yaml边界原则takeout-core不感知具体国税制合规展示走compliance-layer配置。payment-bridge只认order_idchannel_cfg_id不绑定locale。RTL 属于i18n/rtl-layout-tokens与支付通道正交。结算导出走export-profile列定义来自 YAML禁止硬编码。合规配置 YAML按国扩展不改跑单层# ops/mena-uae-compliance.yaml示意market:AEcurrency:AEDreceipt:show_trn:truetrn_label_key:receipt.trnservice_fee_display:separate_linetax_display:fields:-key:vat_ratesource:configvalue:5%-key:vat_amountsource:computedformula:order.taxable * 0.05delivery_rules:friday_cutoff:13:00ramadan_mode:configurableexport_profiles:finance_uae:extends:base_financeextra_columns:-key:trnheader:TRN-key:vat_amountheader:VAT Amount改小票 TRN 展示只改 YAML message-key不改order-hub状态机。税务与申报各国不同字段与报表支持按需定制不默认阿联酋或任何单一国税制客户在当地确定合规结论系统提供可配置项与导出。支付桥接通道按需注册# ops/payment-channels.yaml示意channels:-id:psp_local_cardenabled:truemarket:AEwebhook_path:/pay/webhook/psp_local_cardbinds:[order_id,channel_cfg_id,amount,currency]-id:psp_wallet_benabled:falsemarket:AEnote:按需定制对接首期关闭rules:-locale_change_must_not_recreate_intent-channel_selection_by_market_not_by_language-webhook_only_advances_payment_states// payment-bridge 创建意图示意publicPaymentIntentcreateIntent(CreateIntentCmdcmd){ChannelCfgcfgregistry.get(cmd.channelCfgId());returnintentFactory.create(cmd.orderId(),cfg.id(),cmd.amount(),cmd.currency()// 禁止写入 locale 或 rtl_mode);}海外支付各国接口不同成品提供可配置能力与对接底座psp_wallet_b关闭时不加载 Bean启用时走按需定制对接流程不动takeout-core表结构。RTL 与 i18n展示域独立# i18n/rtl-layout-tokens.yaml示意locales:ar-AE:direction:rtlmessage_catalog:messages_ar_AEen-AE:direction:ltrmessage_catalog:messages_en_AElayout_tokens:cart_item_row:rtl-flex-row-reverseaddress_form:rtl-input-align-rightconstraints:-sku_id_invariant_across_locales-price_format_uses_market_currency_not_locale切换ar-AE只换 message-key 与 layout token不重建 PaymentIntent不复制 SKU 行。订单与合规字段扩展表而非污染主表-- 订单主表不含具体国税字段CREATETABLEoh_order(idBIGINTPRIMARYKEY,order_noVARCHAR(32)NOTNULL,user_idBIGINTNOTNULL,merchant_idBIGINTNOTNULL,amountDECIMAL(12,2)NOTNULL,currencyCHAR(3)NOTNULL,statusVARCHAR(24)NOTNULL);-- 合规扩展按市场挂载CREATETABLEcp_order_compliance_ext(order_idBIGINTPRIMARYKEY,market_codeVARCHAR(8)NOTNULL,trn_snapshotVARCHAR(32)NULL,vat_amountDECIMAL(12,2)NULL,receipt_json JSONNULL,CONSTRAINTfk_cp_orderFOREIGNKEY(order_id)REFERENCESoh_order(id));加第二市场新增ops/mena-xxx-compliance.yaml 扩展表模板不ALTERoh_order通用列。结算导出客户侧对账字段可配置# ops/export-columns-ar.yaml示意profile:finance_uae_arcolumns:-order_no-merchant_id-order_amount-vat_amount-merchant_income-settle_status-settle_batch_noencoding:UTF-8bom:true系统提供可配置核对字段、导出项、状态同步回订单商务结算规则由客户在当地确定不写成全球统一结算能力。Webhook ingress只推进支付相关状态PostMapping(/pay/webhook/{channelId})publicvoidonWebhook(PathVariableStringchannelId,RequestBodyStringbody){WebhookEventevtverifier.verify(channelId,body);orderHub.applyPaymentTransition(evt.orderId(),evt.targetPaymentState());// 禁止在此改 locale、tax_display 或 marketing 字段}支付回调与合规展示解耦联调 PSP 时不触发 RTL 或税务模板回归。部署与验收清单部署示意compliance-layer配置外置 volume按国热加载payment-bridge未启用通道不注册路由diner-app构建含 RTL token与 API 分开发版验收五项切ar-AE已创建 PaymentIntent 的order_id不变启用psp_wallet_b按需对接后跑单层表结构零 ALTER改mena-uae-compliance.yamlTRN 展示小票变、订单状态机不变导出 CSV 增列只改 YAML财务核对项齐关闭营销模块下单—支付—配送—导出仍通过RTL 联调清单与跑单层分开验收中东出海外卖平台试水阿语 RTL 不应与支付、营销绑在同一回归包。建议联调分三张清单清单 A — 跑单层必过用户选店、加购、下单、商家接单、配送状态、后台导出。语言先用默认 locale确认业务闭环。清单 B — RTL 展示可与 A 并行但不触发支付重建切换ar-AE检查购物车行序、地址输入对齐、价格仍用AED格式。断言已有PaymentIntent.order_id不变。清单 C — 合规字段对照当地样例小票 TRN、VAT 展示、导出 CSV 列与财务提供样例一致。改mena-uae-compliance.yaml后只重跑 C不重跑 A 的全链。这样排期上支付联调与 RTL 改版可以并行隐性成本可控。若供应商要求「改 RTL 必须全回归支付」应评估为架构未解耦。支付联调阶段划分P0 — 一种本地通道加下单支付回调退出标准是完结单可导出。P1 — 退款与部分退款回调退出标准是状态机分支覆盖。P2 — 第二种通道按需定制退出标准是不改订单表结构。P3 — 对账文件格式退出标准是财务样例对齐。海外支付各国接口不同P2 不应与 P0 绑在同一里程碑。合同里写「P0 必交付P2 另计联调人天」比「支付全包」更少纠纷。税务字段配置化而非写死在 Service// 反模式StringreceiptTRN: hardcodedTrn VAT 5%;// 目标ReceiptViewviewreceiptTemplate.render(complianceConfig.load(market),orderSnapshot,messageCatalog.locale(locale));税务与申报各国不同字段与报表支持按需定制。代码层只负责「按配置渲染」不负责「默认某国税率正确」。客户在当地确定合规结论系统提供可配置项与导出不替代客户财务判断。配送规则包按市场热加载# delivery-rule-pack/mena-uae.yaml示意friday:delivery_end:13:00ramadan:mode:configurableevening_window:19:00-23:00distance_fee:tiers:-max_km:5fee:8-max_km:12fee:15当地节假日、斋月时段、远距离费阶梯不应写死在 Java 常量。中东试水常改的是规则而不是订单状态机规则包热加载可减少发版次数。隐性成本评审问句问加第二种钱包要不要改订单表期望答不要。只增payment-channels.yaml与 webhook 路由按需定制对接。问改小票 TRN 展示要不要发版期望答改 compliance YAML message-key不动order-hub。问阿语上线要不要重测已通过的支付用例期望答不重测收单创建只测 UI 与文案。问财务导出列谁配期望答运营或实施在 YAML 配置不必每次找研发改代码。与中台能力的关系光合同城海外版支持全套出海外卖平台交付统一后台一体化八大模块可组合后台统一、用户商家资料互通。合规、支付、多语言按市场分层扩展后续叠加跑腿等同底座模块时不重导用户商家资料。单业态全套预算下的范围控制单业态初创在中东拿全套预算销售端容易堆「五端 双语言 双支付 营销」。工程上应坚持跑单层里程碑优先于扩展层里程碑。合同 milestones 建议拆成M1 跑单层阿语 RTLM2 一种支付 P0M3 合规导出样例M4 第二种支付按需定制M5 营销模块。每 milestone 有独立验收与付款节点隐性成本不会在一个「全套交付日」集中爆炸。出海外卖平台若一次签「全部完成才付尾款」联调拖延会把现金流和士气一起拖垮。分层 milestone 对初创团队更友好也迫使供应商把架构解耦做到位。客服与财务口径合规字段前置中东商家上线后会问三类问题小票上税号对不对、退款多久到账、远距离为什么加价。若合规字段与配送规则没进首期验收客服答不上来财务对不上导出隐性成本体现为加班而非发票。建议在 M3 前完成给客服一份「字段口径说明」来自 compliance YAML 与 message-key给财务一份「导出列说明」来自 export profile。技术交付物不仅是代码还包括运营能直接用的口径文档。小结出海外卖平台在中东的工程要点跑单层、合规层、支付层、展示层解耦支付与 locale 正交税务字段配置化、按需定制结算导出 YAML 可配。先把一国一城主链路与合规样例验收通过再开第二通道或扩展模块隐性成本比一次买齐再全链回归可控得多。