系统难度与我们的实现
一笔天然气交易同时涉及气源、计划、数量、吨价、企业资质、资金和提货履约。 系统需要让采购、供货和运营人员在不同终端上围绕同一笔业务协作。
| 难点 | 项目中的具体工作 | 体现的能力 |
|---|---|---|
| 行业参数与普通商品不同 | 区分气源商品与销售计划，处理发货地、日期、吨数、元/吨、定金及实际过磅数量 | 专业行业理解与数据建模 |
| 买家、供货商和运营人员职责不同 | 企业认证、供货商模式、企业上下文请求头与独立工作端 | 多角色产品设计与上下文管理 |
| 成交之后还有提货和结算 | 连接订单状态、定金、提货车辆、过磅数量、双方凭证和退款等分支 | 复杂交易流程与状态协同 |
| App 与微信运行环境不同 | uni-app 多端开发、条件编译、下载引导、WebView 与消息导航 | 跨平台工程与系统集成 |
| 业务端与管理端必须能接续工作 | 气源计划审核、订单管理、企业认证、资金记录及运营信息管理 | 前后端协作与可运营系统建设 |
| 多版本持续迭代需要兼容 | 新旧认证请求头兼容、模块化 API 与类型定义、多个工作端接入 | 长期维护、版本演进与接口适配 |
这些难点使项目的工程价值集中在业务对象、角色、状态和终端之间的协作。框架和组件承担通用基础，我们围绕实际天然气业务完成系统开发与持续优化。
产品与交易界面
App：购气与个人业务中心
图片来自开发者在 App Store 发布的真实截图。购气首页集中提供企业认证、气源大厅、抢购与招标入口；个人中心将会员、钱包与订单状态组织在同一处。App Store 官方条目
购气页先引导用户建立交易资格，再浏览气源与业务入口；个人中心围绕待付款、已付定金、已付款、待收货及完成状态组织任务。这反映了产业交易中的身份、资金与履约关系。
App：资讯与客服
资讯广场承载行业内容，AI 客服界面提供常见业务问题的问答入口。两者在交易操作之外支持用户理解业务和获取信息。
截图能够确认客服产品入口和界面设计，模型、知识库及服务端实现需结合相应资料继续核对；本案例将其表述为客服集成能力。
Web：气源计划与门户
公开购气端按发货地组织计划列表，呈现气源名称、元/吨报价、可售数量、计划时间和销售状态。网页采集于 2026-10-08。公开购气端
当前门户组织企业服务与大宗商品资源，为用户连接不同业务入口。公开购气端的商品链接带商品与计划编号；本次匿名点击后进入登录页面，详情与购买流程根据本地源码分析。
官方多端入口
官网公开提供 Android、iOS 和微信小程序二维码。本次取得的是官方入口素材，小程序内部界面与流程另外通过本地源码分析。合气官网
当前官网还展示企业服务、大宗商品资源及合作授权资料；本案例重点介绍长期迭代的天然气业务系统，将当前门户展示与历史 App 截图区分使用。
系统架构
架构图依据已检索的多端代码、接口调用及管理模块绘制。采购商、供货商和运营人员各有工作入口，通过业务接口协同处理气源、企业、订单和履约资料。
| 终端 / 层级 | 分工 |
|---|---|
| App | 购气、企业认证、个人订单、钱包及供货商入口 |
| 微信小程序 | 浏览、资讯、轻量服务与部分业务查询；按场景衔接 App 和 WebView |
| Web 购气端 | 公开气源浏览、地区筛选和商品 / 计划详情 |
| 供货商工作端 | 商品与计划、订单、提货等企业工作入口 |
| 管理后台 | 审核、业务资料维护、订单管理、资金记录和运营管理 |
| 业务 API | 为终端提供企业、气源计划、订单、钱包与认证等数据及操作接口 |
图中采用业务层级描述。具体服务端框架、部署拓扑及数据一致性方案以对应后端源码和部署资料为准。
多端协同与后台管理
按任务划分终端职责
App 与小程序共享业务背景，但承担不同的使用场景。本地小程序版本把部分深层操作引导到 App，商家工作模块通过 WebView 接入，并处理安全区域、底部导航和页面消息通信。
| 场景 | 具体实现 |
|---|---|
| 采购与供货身份切换 | 保存角色及企业上下文；切换供货商工作入口，采购模式清理相应上下文 |
| 接口认证兼容 | 新认证使用 Bearer，兼容历史 X-Access-Token；供货商请求携带 Tenant-Id |
| 商家模块接入 | WebView 承载工作模块，处理跳转、返回、切换标签及提示消息 |
| 平台差异 | 条件编译区分微信、App 与 H5；下载导航按平台分支处理 |
| 复杂操作衔接 | 部分小程序业务查询保留，充值、提现、转账等深层操作按版本引导 App |
角色与企业上下文是多端协作的重要基础。这里描述的是已核对的客户端实现；服务端的鉴权与企业数据边界应与后端实现共同验证。
后台承接产业运营
管理端模块示意依据代码中的业务页面绘制，展示审核和业务操作的关系。
| 管理范围 | 可核对的页面与业务字段 |
|---|---|
| 气源与计划 | 商品、库存、供货计划、销售计划及计划审核 |
| 企业与采购 | 采购商、供货商企业资料、资质认证和采购需求审核 |
| 订单与履约 | 订单状态、吨数、吨价、实际过磅数量、定金、付款渠道及双方交易凭证 |
| 资金与凭证 | 提现审核、充值记录、付款接口记录、同步 / 异步返回及资金明细 |
| 会员与运营 | 会员权益、规则、积分、资讯、消息、客服和操作手册 |
这套后台承担的是产业运营人员的持续工作：前台发起业务、后台审核和维护资料、供货商处理履约、采购商跟进状态。开发工作要将这些角色的操作接起来。
关键工程实现
商品与计划分离
同一气源可以有不同日期、区域和数量的销售计划。公开 Web 链接同时携带商品编号与计划编号；接口模块围绕销售计划、地区列表和气源日历组织查询。
这种设计需要将“产品是什么”与“哪一批、何时、在哪里可以买”分开表达。商品详情、库存与订单都要理解当前计划的上下文。
定金、履约与订单状态
订单流程示意依据页面字段与接口操作整理。实际状态和付款分支随交易模式变化，流程图用于解释主线。
| 业务对象 | 在实现中的体现 |
|---|---|
| 采购数量与价格 | 吨数、元/吨、合同金额和订单总价分别呈现 |
| 定金与付款 | 预估定金、实际定金、抵扣金额、付款渠道和付款单号 |
| 提货信息 | 车辆、司机信息、提货数量与提货资料维护 |
| 履约结果 | 实际过磅数量、双方交易凭证及收货 / 完成状态 |
| 异常分支 | 退款、取消、转让订单及相关状态入口 |
项目需要处理的是业务记录之间的关系。界面不能只展示一个“支付成功”结果，还要支持后续提货、凭证维护和状态跟进。
本次核对了公开浏览界面及本地实现，未登录企业账户、提交订单、付款或执行资金操作。
企业认证与审核状态
采购商和供货商采用不同认证流程。页面按实名状态和企业审核状态，跳转到申请、审核中或已通过的详情页面；接口支持营业执照、相关资质和企业信息上传。
这项工作把身份资料、角色资格和可用业务入口关联起来，便于用户理解自己还需完成哪一步。
供应商工作端与接口层
本地供货商移动工作端分别组织商品、计划、订单、提货与个人信息 API。管理端对应商品 / 计划审核、企业资料和订单业务页面；接口封装与类型定义支持多个终端接入持续演进的业务系统。
小程序新版通过统一请求拦截器处理认证、企业上下文和文件上传，兼容历史接口认证方式。平台运行差异与业务接口差异在接入层集中处理，减少页面中的重复适配。
持续迭代的工程工作
代码与历史资料显示，项目经历多端页面和管理功能的持续调整，包括认证入口整合、会员 / 权限展示、商家 WebView、价格呈现及订单提货信息维护。
这类系统的长期维护需要区分不同版本的接口、状态和运行环境。本地新旧订单类型定义存在不同的数字编号，不能把某个客户端枚举直接视为全平台统一状态契约。
这项项目体现的能力
| 能力 | 合气网中的具体体现 |
|---|---|
| 深入理解行业业务 | 气源、计划、吨价、资质、定金与履约的数据关系 |
| 建设多端产品 | App、小程序、Web、供货商工作端和管理后台 |
| 前后端业务协同 | 企业认证、订单、提货、资金记录和运营管理的接口衔接 |
| 处理复杂状态 | 采购和供货身份、审核状态、订单生命周期及异常分支 |
| 集成业务与内容服务 | 资讯、客服、会员权益与交易操作共同服务用户 |
| 支撑长期演进 | 旧接口兼容、模块化 API、类型定义、WebView 和持续迭代 |
合气网展示了我们围绕专业行业建设业务系统的能力：理解交易规则，组织多个角色与终端，完成核心系统开发，并持续处理运营过程中出现的新需求。
资料与说明
- 官方截图：合气网 App Store 条目。本次页面显示版本 3.3.25；截图为开发者发布的展示素材，图内日期与数据属于截图样例，不代表当前经营数据。
- 多端入口与合作展示：合气官网。公开 Web 浏览：气源计划。采集日期：2026-10-08。
- 工程依据：App、小程序、Web、供货商和管理端代码，以及项目维护文档。开发职责由团队确认。
- 架构、流程与管理模块图为工程示意；App 图片为官方发布截图，Web 图片为现场网页采集。
- 历史后台优化截图包含客户资料、交易数据和修改批注，保留用于内部研究；公开素材包采用模块示意图。
- 交易规模、资金正确性、后端运行性能及当前小程序实机体验未在本次检索中验证。