智慧餐厅信创适配资料梳理与新吴区实施依据
资料复核日期：2026年10月20日｜范围：zhctprompt历史方案、适配记录、测试报告与厂商公开资料。
一、综合结论
现有资料已经覆盖架构选型、麒麟环境部署、GBase 8s初步业务适配、金蝶Web与缓存中间件冒烟、OceanBase业务验证及EMQX设备通信。信创改造具备可复用的工程基础，但各技术路线的验证深度不同，不能合并表述为整套系统已经完成信创验收。
新吴区继续执行现行V3选型：新购两台海光x86_64服务器，银河麒麟V10商业版，Web采用东方通TongHttpServer，缓存采用东方通TongRDS，消息采用本地EMQX企业版，数据库采用南大通用GBase 8s。实施按新旧并行、不停机切换目标组织，采购优先我方统一提供，甲方也可提供符合供货清单的资源。
本次需要补充的重点是：复用已有GBase ODBC适配并审查其已知问题，验证新吴区两套后端，完成东方通实际产品联调，处理EMQX设备P2P订阅和鉴权差异，验证异构数据库在线同步及回退。
二、资料分类与验证深度
| 资料路线 | 已有依据 | 可复用内容 | 适用边界 |
|---|---|---|---|
| TongWeb＋KingbaseES | 2026年6月架构方案、SQL/DDL风险分析 | PHP服务边界、数据库迁移清单、回归场景 | 本次定向检索未找到该完整组合的项目实测或验收报告；不能按已验证组合交付 |
| 麒麟＋GBase 8s | 6月24日至26日安装、连接、导入和业务接口记录；store历史提交 | ClientSDK/unixODBC/PDO_ODBC、ThinkPHP驱动与SQL适配经验 | 主要是store临时POC；不证明新吴区分支、ai_api、正式海光环境或全业务通过 |
| 麒麟＋Apusic ALB/AMDC | 6月25日实际商业产品安装和PHP-FPM链路报告 | PHP 7.3/7.4转发、缓存PING/SET/GET、部署检查方法 | Intel x86_64低规格临时机；非海光性能测试；未完成整站与全部Redis命令回归 |
| Apusic Docker POC | 使用Nginx、Redis、Mosquitto的等价容器方案 | 协议链路和验证脚本组织方式 | 这些容器不能证明金蝶产品兼容；与实际产品报告分开使用 |
| 城市副中心OceanBase | CE 4.5.0.0连接与SQL冒烟、业务复测及后续现场记录 | PHP MySQL协议访问、迁移校验、运维和回归模板 | ARM项目经验；不能证明GBase兼容、麒麟海光容量或新吴区合规通过 |
| 城市副中心EMQX | 5.8.9部署、模拟设备闭环、实物460反馈与后续现场消息记录 | Topic/Client ID、上下行、ACK、重连、设备入口分离 | 历史包和运行记录不能证明当前企业版授权；部分记录为模拟设备，需逐条区分 |
| TongHttpServer/TongRDS | 历史替换分析及当前厂商产品说明 | Web代理职责、Redis接口兼容方向、测试清单 | 本次定向检索未发现与金蝶报告同范围的项目实测记录；正式版本仍需验证 |
证据使用规则：历史方案证明当时的设计方向；部署与测试记录证明特定版本、环境和场景的结果；厂商资料说明产品能力。上述依据均不能单独证明本项目的最终信创验收结论。完整来源见来源索引。
三、Web中间件：TongWeb与TongHttpServer分别处理
6月2日方案针对Java应用服务器TongWeb，采用Java网关通过HTTP访问PHP后端，后端仍保留Nginx/OpenResty与PHP-FPM。这可以解释PHP与Java运行时如何协作，但不构成严格替换原生Nginx后的目标架构。
新吴区使用TongHttpServer承担Web入口和代理，PHP继续由PHP-FPM运行。TongWeb不是PHP运行时，也不能只增加一层国产网关就视为原有组件已完成替代。
厂商公开资料说明TongHttpServer具备静态资源、代理及负载均衡能力；本项目的PHP-FPM/FastCGI接入方式由实际交付版本和厂商配置方案验证。验证范围包括ThinkPHP路由、PATH_INFO、/aizhct/代理、HTTPS、上传、历史图片、转发头、超时、流式接口及日志。不能假定原Nginx配置可直接复制使用。TongHttpServer官方说明
既有金蝶ALB实测可复用测试方法；其结果不转移为TongHttpServer的通过结论。既有临时产品测试授权已超出记录中的有效期，本次采购和部署需重新取得有效许可。
四、缓存：从Redis接口兼容验证到业务状态迁移
新吴区采用TongRDS。厂商说明其提供高度兼容Redis的数据访问接口；项目仍需按实际命令清单验证，不能把“接口兼容”直接写成全部缓存业务已通过。TongRDS官方说明
| 范围 | 核验内容 |
|---|---|
| 客户端 | PHP扩展、连接方式、认证、重连、异常返回与序列化 |
| 数据结构 | 实际使用的字符串、哈希、列表、集合、有序集合及Lua脚本 |
| 状态语义 | TTL、会话续期、锁的原子性与释放、计数、事务或流水线 |
| 队列与任务 | 领取、确认、重试、积压、恢复、幂等及重复消费 |
| 迁移 | 区分可清空重建的缓存与需要接续的会话、锁和任务，不直接清空所有状态 |
金蝶AMDC已有PING/SET/GET和PHP客户端冒烟，不代表锁、队列或TongRDS实现已经验证。Web、缓存和MQTT分别列产品和授权，不再用“一套东方通中间件”覆盖全部角色。
五、数据库：三条路线分别复用
5.1 KingbaseES：保留为历史替代路线
早期KingbaseES方案基于PostgreSQL兼容接口或专用PDO驱动，涵盖DDL、自增、函数、分组、分页、锁和跨库访问改造。它可作为风险检查模板，不能把pgsql、pdo_kdb配置直接用于GBase 8s。KingbaseES与GBase 8s是不同产品，不使用“南大数据库”作为共同实施名称。
5.2 GBase 8s：已有连接、数据和部分业务适配成果
历史记录已经验证的链路为：
ThinkPHP store → gbase8s连接器/SQL Builder → PHP PDO_ODBC
→ unixODBC → GBase ClientSDK ODBC驱动 → GBase 8s
初期分析过PDO_GBASEDBT，后续以已跑通的PDO_ODBC为实现路线。新吴区先复核这条路线与厂商支持版本，不再从“完全没有PHP接入经验”开始估算。
| 历史成果 | 记录结果 | 不能据此推导 |
|---|---|---|
| 三层连接 | ODBC、独立PHP、ThinkPHP连接/查询/写入/回读通过 | 所有PHP版本和应用均通过 |
| Schema转换 | 227张表、3138字段、454个保留索引；6个索引在POC跳过 | 新吴区表结构相同或可跳过相同索引 |
| 数据导入 | 历史样本227张表、2,625,971行，逐表count匹配 | 金额、字段、引用关系及新吴区生产数据已校验 |
| 业务探针 | 消费订单列表、人员/部门消费统计及菜品销量统计等有通过记录 | 全业务、导出、交易、同步和高峰性能全部通过 |
| 代码归档 | store历史提交a3847b05a包含连接器、Builder、配置示例与订单适配；0cc178a28含后续适配 | 新吴区当前发布分支已包含这些改动 |
本次只读核查本机store的历史提交和分支归属，找到origin/codex/gbase8s-localization-adapter；当前本机HEAD未检出上述三个驱动文件。这说明后续需按精确commit审查差异和依赖，不能直接假定已进入新吴区代码，也不能整支合并其他项目业务变化。
需要优先处理的历史问题：
- 参数化SELECT曾触发PHP段错误，PDO::quote曾返回空字符串。旧连接器采用参数内联和自定义转义规避。正式方案先取得厂商支持的驱动组合，验证原生绑定；如保留兼容层，必须审查占位符替换、类型、NULL、引号、多字节字符、注入与事务行为，不直接把POC绕行作为安全结论。
- POC将text/json等映射为lvarchar(32739)，部分索引被跳过；正式迁移必须核对实际长度、LOB/JSON存储策略和索引，避免截断或性能退化。
- 历史环境出现空字符串按NULL处理，导入曾以空格兜底；零日期曾替换为1970年。以上均为当时POC策略，正式迁移逐字段确定业务语义，不机械复用。
- ON UPDATE CURRENT_TIMESTAMP被移除、部分排序规则和宽松GROUP BY不兼容；更新时间、排序、聚合结果需要等价验证，不能为执行成功而改变业务含义。
- 全量订单聚合曾明显慢于原环境；默认日期筛选的调整不能作为数据库性能达标证明。正式验证同数据、同筛选、同统计口径，覆盖空日期、历史报表和导出。
- 历史多次错误来自前后端或公共基类版本不一致。部署时锁定整套代码和依赖；不以补空鉴权方法解决兼容问题。
既有成果主要属于ThinkPHP 5的store。ai_api的ThinkPHP 6连接器、两套业务库、跨库调用、后台任务和城运中心同步源端分别验证，不从store成功推断ai_api成功。厂商当前列有PHP/ODBC及迁移工具支持，但应锁定具体发行版本、CSDK、驱动和工具支持矩阵，不用当前产品网页替代2026年6月POC的版本信息。GBase 8s官方说明
5.3 OceanBase：保留城市副中心复用资料
城市副中心已留存OceanBase CE 4.5.0.0、PHP 7.3/7.4连接、SQL冒烟、业务复测及后续备份记录。该路线可用于理解MySQL协议兼容和迁移验证方法，本次不据此把新吴区数据库改回OceanBase。
历史“互认证证书申请方案”记载的是申请和咨询过程，不等于证书已取得；社区版运行可用也不等于任意项目均满足信创验收。版本、许可、适配证明和实际验收范围分别核验。
六、EMQX：已有业务经验，迁移需要处理协议差异
城市副中心历史EMQX安装为5.8.9，临时制镜环境是ARM64；三全还保留x86_64/openEuler安装回传记录。两种记录分别反映原环境事实，不能当作海光＋麒麟V10企业版已经验证。
已有业务证据包括：模拟消费消息进入真实业务处理并返回反馈、实物460排菜收到反馈、60台模拟设备消息复跑，以及后续人脸新增/删除、排菜消息的设备接收记录。模拟消费中“付款码已过期”证明处理链路到达业务层，不证明真实扣款成功；1500人用餐流程测试也不等于1500条数据库并发连接能力。
| 迁移项 | 历史发现与实施要求 |
|---|---|
| P2P主题 | 曾出现平台发布topic/p2p/clientId而设备只订阅topic，EMQX按标准匹配无法投递。设备订阅精确P2P主题，或由平台给出可验证的兼容映射；不为省事授予全部设备topic/#读取权限 |
| Client ID | 保留既有业务格式时核对唯一性、共享订阅、重连和会话；旧新连接使用相同ID造成踢线的情况纳入测试 |
| 鉴权 | 阿里云特有签名和API分别改造；历史匿名模式只作为联调记录。生产使用明确身份、最小Topic ACL、受控网络和可支持的TLS方案 |
| 双接入地址 | 历史已区分平台云内Broker地址与设备可达入口。新吴区分别配置、分别实测，不把云内IP返回给设备 |
| 业务闭环 | 排菜、人脸、上下线、补报、ACK、重试、去重、队列积压与恢复分别留证；Broker收到了不等于设备执行成功 |
| 版本与许可 | 历史5.8.9运行包不构成当前企业版采购凭据；锁定新交付企业版版本、连接规格、授权期、维保和离线部署方式 |
官方将国产硬件及麒麟等发行版适配列为可联系厂商获取支持的事项。采购时取得与海光x86_64、具体麒麟V10发行版匹配的包和支持说明，随后复跑设备闭环。EMQX官方安装说明
EMQX企业版采用自托管采购路线，官方为定制报价；询价同时列连接数、消息速率、部署节点、许可期限与信创材料需求。官方定价、商务入口
七、新吴区资源与迁移约束
| 角色 | 固定资源口径 | 承载内容 |
|---|---|---|
| 新应用主机 | 海光x86_64，8核16GB，系统盘100GB、数据盘500GB，DMZ | TongHttpServer、PHP应用、EMQX、后台任务及图片访问 |
| 新数据主机 | 海光x86_64，8核32GB，系统盘100GB、数据盘500GB，非DMZ | GBase 8s、TongRDS |
原服务器持续提供迁移期业务。业务入口沿用TCP 8453到应用443映射；数据库及缓存仅向获准应用源地址开放，EMQX管理口不向公网开放。两台服务器分别承担应用和数据角色，不能写成双应用高可用、数据库双节点或EMQX集群。
资源规格保持现行V3，不因历史其他项目配置自动增减。实施验证数据库与缓存共机、EMQX与PHP共机的CPU/内存/IO竞争，按实际峰值和恢复测试验收。两个500GB数据盘均需分别规划数据库、日志、图片和持久化目录；备份存储独立提供。
不停机切换是项目目标，本次资料复核未找到该新吴区MySQL到GBase组合已经完成全量＋增量＋回退演练的证据。实施先验证源版本日志条件、同步工具支持、DDL、事务顺序、延迟和位点；切换时排空旧事务、追平数据、转移唯一写入权并接续会话、任务和消息。
如切换后回旧库，必须先完成新增数据反向同步或可靠重放并校验，不以“旧服务器还在”作为完整回退方案。无法在演练中满足连续性指标时，不把不停机能力写成已经实现。
城运中心汇聚目标库保留原边界，改造Python程序的GBase源端访问与字段映射，并校验完整汇聚周期。图片数量、数据库表数和压测规模均按新吴区现网核实，不能套用历史227表、12GB、1500人或其他项目数据。
八、实施补测与交付资料
| 顺序 | 责任角色 | 交付与通过条件 |
|---|---|---|
| 1 交付基线 | 项目经理、供货方、研发 | 精确CPU/OS/软件版本、补丁、介质摘要、许可、维护、认可范围和整套代码commit；安装包与授权有效 |
| 2 Web与缓存 | 中间件厂商、后端、测试 | TongHttpServer完整PHP链路；TongRDS实际命令与状态迁移；与原系统业务结果一致 |
| 3 数据与应用 | DBA、store/ai_api研发、测试 | 受支持ODBC/驱动组合、两套应用、SQL与字段映射、数据核对、交易及导出通过 |
| 4 设备接入 | 设备研发、后端、网络、测试 | 每种在用设备完成P2P、鉴权、可达入口、上下行执行及ACK、断线恢复和幂等 |
| 5 在线切换 | DBA、研发、运维、测试 | 在线同步、单一写入转移、峰值切换、回退、独立备份恢复通过并记录指标 |
| 6 项目验收 | 项目经理、客户验收及测评方 | 授权、版本、适配证明、功能/性能/迁移/恢复报告；信创、等保、密评分别按适用要求交付 |
详细条目见实施补测清单。各项状态均按本次新吴区实测更新，历史项目通过结果只作为复用依据。
九、资料复用与版本规则
- 新吴区固定选型和资源以现行V3为准。早期OceanBase、达梦、服务器复用及停机迁移文档保留作历史，不覆盖最新方案。
- 历史数据、容量、P95、工期与报价均附原项目、版本及测试模型；不能直接形成新项目承诺。
- 国产背景、商业许可、互认证、实际兼容和项目验收分别记录。PHP、ThinkPHP及其扩展仍列入完整组件清单，国产框架名称不能替代全部运行依赖审查。
- 原始历史资料原位保存。本次只编译脱敏技术结论，不复制历史密码、Token、人员数据、许可文件或生产命令到新材料。
- 代码复用按精确提交逐项审查，补测通过后才能进入新吴区发布基线；本次未修改业务代码、部署服务器或执行采购。
十、核心阅读入口
- TongWeb＋KingbaseES历史方案：PHP运行边界与迁移检查项。
- 国产WebServer替换分析：TongHttpServer与Nginx行为对照。
- GBase 8s部署适配说明：已验证接入路线。
- GBase数据迁移POC：227表导入、字段与索引风险。
- GBase当前进展记录：业务修复及未闭环事项。
- 城市副中心EMQX方案：Broker迁移、P2P及历史业务闭环。
- 城市副中心后续上线验证：设备入口、人脸消息与数据库备份。
- OceanBase互认证申请记录：申请范围及证书边界。
- 新吴区现行V3方案：当前产品、资源、迁移与费用口径。
本页作为内部技术复核资料使用；历史原文中的敏感配置按原资料权限管理。正式供货、部署和验收文件使用实际交付版本及有效授权。