同城中台系统核心表设计与模块启用状态机（代码深讲）

县城创业者评估「同城中台系统」时技术侧常纠结功能捆绑是否必须一次启用全部业务域下文用模块注册表、启用状态机与 Service 伪代码说明「统一中台 按需启用模块」如何落地并给出低成本试水期的联调验收点。示例为教学示意。设计目标中台底座与业务模块解耦核心思路platform_module_registry记录可购模块tenant_module_enable记录租户启用状态公共域用户、权限、营销始终走中台服务业务域按启用标记路由。模块注册与启用表示意CREATETABLEplatform_module_registry(idBIGINTPRIMARYKEYAUTO_INCREMENT,module_codeVARCHAR(32)NOTNULLUNIQUECOMMENTRUNNER/ GROUPON / WAIMAI ...,module_nameVARCHAR(64)NOTNULL,versionVARCHAR(16)NOTNULL,created_atDATETIMENOTNULLDEFAULTCURRENT_TIMESTAMP);CREATETABLEtenant_module_enable(idBIGINTPRIMARYKEYAUTO_INCREMENT,tenant_idBIGINTNOTNULL,module_codeVARCHAR(32)NOTNULL,enable_statusTINYINTNOTNULLCOMMENT0DISABLED 1ENABLED 2TRIAL,enabled_atDATETIMENULL,UNIQUEKEYuk_tenant_module(tenant_id,module_code));CREATEINDEXidx_tenant_statusONtenant_module_enable(tenant_id,enable_status);县城低成本试水可先写enable_status2TRIAL仅开放单模块 API 路由扩面再批量置1ENABLED。模块启用状态机DISABLED --(purchase)-- TRIAL --(acceptance)-- ENABLED ^ | --------(rollback)-------DISABLED模块未采购或未部署制品TRIAL试点租户可见限账号/限区域ENABLED正式启用走完整权限与导出策略非法跳转如 TRIAL 直接跳 ENABLED 且无验收记录应由ModuleEnableService拒绝。ModuleEnableService 伪代码示意ServicepublicclassModuleEnableService{publicvoidenableTrial(LongtenantId,StringmoduleCode,TrialScopescope){assertPurchased(tenantId,moduleCode);upsertStatus(tenantId,moduleCode,EnableStatus.TRIAL);routeRegistry.bindTrialScope(tenantId,moduleCode,scope);auditLog.record(tenantId,moduleCode,TRIAL,scope);}publicvoidpromoteToEnabled(LongtenantId,StringmoduleCode,StringacceptanceRef){requireStatus(tenantId,moduleCode,EnableStatus.TRIAL);requireAcceptance(acceptanceRef);upsertStatus(tenantId,moduleCode,EnableStatus.ENABLED);routeRegistry.clearTrialScope(tenantId,moduleCode);auditLog.record(tenantId,moduleCode,ENABLED,acceptanceRef);}}TrialScope建议包含试点区县、最大商家数、最大日订单量写入附件便于验收。公共能力共享营销示例中台marketing_campaign与用户user_id关联不绑定单一module_code。新业务模块启用后通过module_code过滤可用活动类型即可无需重建优惠券引擎。-- 活动适用模块示意CREATETABLEmarketing_campaign_module(campaign_idBIGINTNOTNULL,module_codeVARCHAR(32)NOTNULL,PRIMARYKEY(campaign_id,module_code));这对应「中台新增营销能力已购单模块与综合版可同步受益」的工程落点以当期方案为准。网关路由与权限校验API 网关根据tenant_module_enable动态路由# gateway route snippet (示意)-id:runner-apipredicates:-Path/api/runner/**filters:-name:ModuleEnabledargs:moduleCode:RUNNERallowTrial:trueModuleEnabled过滤器应读取租户启用状态DISABLED 返回 403TRIAL 超限返回 429 或业务错误码。联调验收清单低成本试水仅启用单模块时其它模块 API 应 403TRIAL 账号越权访问非试点区域应失败启用第二模块后同一user_id可跨模块下单若业务允许营销活动在marketing_campaign_module正确挂载状态从 TRIAL 到 ENABLED 必须有acceptanceRef审计记录导出任务按模块分表或分前缀避免混库混导与外包方案的对照数据模型一致性外包常见陷阱是第二个模块另起 user 表。中台方案应强制user_id全局唯一。验收 SQLSELECTu.id,COUNT(DISTINCTm.module_code)ASmodule_cntFROMuser_account uJOINuser_module_binding mONm.user_idu.idWHEREu.tenant_id:trialTenantGROUPBYu.idHAVINGmodule_cnt1;试点用户至少在一个 module 有绑定启用第二模块后同一user_id应出现第二条 binding而不是新注册。审计与回滚CREATETABLEmodule_enable_audit(idBIGINTPRIMARYKEYAUTO_INCREMENT,tenant_idBIGINTNOTNULL,module_codeVARCHAR(32)NOTNULL,from_statusTINYINTNOTNULL,to_statusTINYINTNOTNULL,operatorVARCHAR(64)NOTNULL,ref_noVARCHAR(64)NULL,created_atDATETIMENOTNULL);回滚 ENABLED→TRIAL 必须留 ref_no避免生产误操作无迹可循。网关 ModuleEnabled 过滤器伪代码publicclassModuleEnabledFilterimplementsGlobalFilter{publicMonoVoidfilter(ServerWebExchangeex,GatewayFilterChainchain){StringcoderesolveModuleCode(ex.getRequest().getPath());EnableStatusstenableService.status(tenantId(ex),code);if(stDISABLED)returnforbidden(ex);if(stTRIALtrialLimiter.exceeded(tenantId(ex),code))returntooManyRequests(ex);returnchain.filter(ex);}}TRIAL 限流应覆盖日订单量与并发注册写入TrialScope附件。营销券跨模块挂载 REST示意POST /internal/marketing/campaigns/{id}/modules {moduleCodes:[GROUPON,WAIMAI]}仅 TENANT_ADMIN 可写变更写 audit。县城试水首期可只挂一个 module_code。导出任务分模块前缀示意export/groupon/20260813/tenant_1001_orders.csv export/runner/20260813/tenant_1001_orders.csv混导会导致财务对账把两条业务线算成一条扩模块前务必约定前缀。TRIAL 附件模板示意tenant_id: 1001 module_code: GROUPON trial_city: 410000-xx max_merchants: 20 max_daily_orders: 200 acceptance_ref: ACC-20260813-001promote 到 ENABLED 必须引用 acceptance_ref否则审计链断裂。纯技术小结「同城中台系统」的功能捆绑焦虑应转成模块注册、启用状态机与网关路由问题。光合同城按成品交付支持单模块采购与后期叠加公共域统一维护业务域按需启用。县城创业者低成本试水时优先验 TRIAL 边界与审计链再扩 ENABLED。