10 crmeb baseline capability map

CRMEB 底座能力与智慧农业改造映射

本文档用于回答一个核心问题：当前已经搭建好的 CRMEB 多商户商城到底能提供什么，智慧农业 V1 应该复用什么、扩展什么、新建什么。

结论先行：

• 当前系统是完整的 CRMEB 多商户商城底座，不是空项目。
• 平台后台、商户后台、用户端、客服端和后端 API 已经具备商品、订单、支付、退款、物流、营销、商户、用户、财务、权限、素材、客服、队列和定时任务能力。
• 当前源码、Chrome 运行页面和远程 MySQL 库均未发现独立的“农场、地块、租地、认养、云仓、农业溯源”业务模块；这些属于智慧农业 V1 新增域。
• 后续开发建议采用“新增业务类型 + 复用交易履约底座”的路线，不建议另起一套商城、支付、订单或结算系统。

2026-07-29 运行态核验

本节记录当前浏览器页面和远程数据库的实际状态。注意：源码能力、菜单配置和当前业务数据是三类信息，后续分析不要混用。

Chrome 页面

已确认当前 Chrome 中存在 3 个 SmartFarm 标签：

端	URL	页面标题	运行态观察
平台管理端	http://www.smartfarm.com/admin/dashboard	控制台 - CRMEB多商城系统	顶部一级菜单显示：首页、店铺、商品、订单、分销、营销、用户、内容、财务、应用、装修、客服、设置、维护。控制台统计大多为 0，并有商品管理、用户管理、订单管理、分销管理、一号通、文章管理、优惠券、系统设置等快捷入口。
商户后台	http://www.smartfarm.com/merchant/dashboard	控制台-	顶部一级菜单显示：首页、商品、订单、营销、财务、用户、员工、装修、设置、公告。当前商户为“铂悦衣橱”，账号 admin1，控制台显示出售商品 4，交易和用户统计大多为 0。
用户端	http://www.smartfarm.com/	智慧农场	底部导航为：首页、分类、逛逛、购物车、我的。首页内容仍是 CRMEB 默认商城形态：优惠券、积分商城、商品分类、种草社区、服饰商品列表等，暂未看到农场、租地、认养、云仓或溯源入口。

平台端和商户端已经核验一级菜单及当前控制台内容；数据库菜单分层已进一步沉淀到 11-current-menu-page-audit.md。该文档按 eb_system_menu 的 menu_name、route、path、is_mer、is_agent、is_menu、is_show 等字段记录当前可见菜单树。后续仍需要结合当前账号权限和页面实际显示做逐页功能验收。

远程 MySQL

通过 MCP 只读检查远程库：

项	当前值
数据库	www_smartfarm_co
MySQL 版本	8.0.45
表数量	165
菜单记录	eb_system_menu 2419 条
商户	1 个
商户管理员	1 个
用户	0 个
商品	8 个
商品规格值	36 条
订单	0 单
退款单	0 单
优惠券	6 张
秒杀活动/时段	各 1 条
财务/财务流水	0 条
装修页面	3 条
附件	88 条

当前唯一商户为“铂悦衣橱”，商品分类仍是服装、女装、男装、帽子、包包、配饰等默认电商分类；商品样例也是服饰类商品。site_name 已配置为“智慧农场”，但业务数据和页面内容还没有切换为智慧农业。

按表名和菜单名检索 farm/land/adopt/trace/warehouse/cloud/crop/agri/plant 以及“农、地块、认养、云仓、溯源、种植、养殖、智慧”等关键词，没有发现智慧农业业务表或菜单。唯一命中是原系统里 plantform 拼写路径，不代表农业种植模块。

端能力现状

端	当前入口	已具备能力	智慧农业中的定位
平台管理端	http://www.smartfarm.com/admin/dashboard、smartfarm_admin	控制台、商户管理、商品审核、订单、退款、营销、用户、财务、分账、素材、装修、系统配置、权限、数据大屏	新增农业资产、租地认养、云仓秒杀、用户云仓、溯源和结算运营入口
商户后台	http://www.smartfarm.com/merchant/dashboard、smartfarm_mer	商户商品、规格库存、订单发货、售后、普通秒杀/拼团/预售/助力、财务账单、提现、分账申请、运费和店铺配置	供应链商品、云仓供货申请、入库/验收、约定履约和货款入口
用户端	http://www.smartfarm.com/、smartfarm_user	首页、商品分类、商品详情、购物车、下单支付、订单物流、退款售后、优惠券、秒杀、拼团、预售、助力、店铺街、会员、积分、余额、分销、客服	增加农场专区、租地认养、集市云仓、我的云仓、溯源展示
客服端	http://www.smartfarm.com/kefu/dashboard、smartfarm_service	客服登录、会话、用户信息、订单、退款、物流、商品上下文；当前只有 Token 身份、静态路由和最小宽度约 1000px 的 PC 三栏页	保留原客服页，新增农业桌面查询与独立移动现场作业布局、职责权限和对象范围
后端服务	smartfarm	ThinkPHP 8、Swoole、Repository/DAO/Model、路由、中间件、事件、队列、定时器、支付回调、OpenAPI	承载新增农业业务模型、状态机、结算任务和对外接口

可直接复用的 CRMEB 底座

商品与店铺

可复用能力：

• 平台商品、商户商品、商品分类、品牌、标签、规格、库存、运费模板、保障服务、商品评价。
• 商户入驻、商户资料、商户分类、商户分组、店铺开关、商户后台商品维护。
• 商品审核、上下架、批量处理、商品操作记录。

智慧农业用法：

• 平台自营农产品和商户农产品优先复用现有商品体系。
• 增加商品来源、产地、批次、溯源档案、供应链主体等字段或关联表。
• 农场地块、认养资产不建议直接当普通商品保存，建议独立建模，再在可售套餐层关联订单和商品能力。

源码入口：

• smartfarm/route/admin/product.php
• smartfarm/route/admin/merchant.php
• smartfarm/route/merchant/product.php
• smartfarm/app/common/repositories/store/product/ProductRepository.php

订单、支付、履约和售后

可复用能力：

• 购物车、下单检查、订单创建、订单详情、订单列表、订单状态、支付、发货、物流、核销、退款、退货、售后日志。
• 用户端已有 v2、v3 下单接口，当前注释中说明支持分账。
• 商户端可处理订单发货、批量发货、电子面单、同城配送、预约订单和退款审核。

智慧农业用法：

• 租地、认养、云仓抢购都应接入支付、订单状态和退款售后体系。
• 必须在订单明细扩展记录业务来源和规则快照，区分普通商品、租地、认养、普通秒杀和云仓首次购买，并记录云仓明细唯一去向。
• 租地/认养的“收成邮寄、产出邮寄”可以复用发货履约，但种植/养殖周期应单独建模。

源码入口：

• smartfarm/route/api/login.php
• smartfarm/route/api/notLogin.php
• smartfarm/route/admin/order.php
• smartfarm/route/merchant/order.php
• smartfarm/app/common/repositories/store/order/StoreOrderCreateRepository.php
• smartfarm/app/common/repositories/store/order/StoreOrderRepository.php
• smartfarm/app/common/repositories/store/order/StoreRefundOrderRepository.php

营销活动

可复用能力：

• 优惠券、平台券、商户券、积分商城、签到积分、普通秒杀、秒杀场次、秒杀商品、拼团、预售、助力、直播、活动报名、活动标签、专题活动。

智慧农业用法：

• 普通 CRMEB 营销继续保持独立。
• 云仓秒杀可以参考普通秒杀的场次、倒计时、秒杀商品、秒杀价、库存、限购和支付超时释放机制。
• 云仓秒杀必须新增独立业务域，不能只把普通秒杀改个名称。它还需要商户供货、付款后待选择、单一明细去向、用户持仓、二次零售批次和本金/收益/回购账本。

源码入口：

• smartfarm/route/admin/marketing.php
• smartfarm/route/merchant/marketing.php
• smartfarm/app/common/repositories/store/StoreSeckillActiveRepository.php
• smartfarm/app/common/repositories/store/StoreSeckillProductRepository.php

商户、财务、分账和账本

可复用能力：

• 商户货款账单、商户财务统计、资金流水、用户提现、商户转账申请、分账商户申请、分账单、支付回调、退款冲正基础。
• 平台后台和商户后台都有财务账单与导出入口。

智慧农业用法：

• 商户普通商品货款可以复用商户账单/财务记录模式。
• 商户云仓供货建议 V1 采用供货价结算，生成独立可追溯账本。
• 用户云仓本金、收益和回购不要把普通余额流水作为唯一事实来源；应新增独立业务账本，再根据结算动作入账或打款。
• 结算必须以首次订单明细、用户持仓、云仓批次、二次零售分配和商品来源快照为依据。

源码入口：

• smartfarm/route/admin/accounts.php
• smartfarm/route/merchant/accounts.php
• smartfarm/app/common/repositories/system/merchant/FinancialRecordRepository.php
• smartfarm/app/common/repositories/store/order/StoreOrderProfitsharingRepository.php
• smartfarm/app/common/repositories/user/UserBillRepository.php

用户、会员和账户

可复用能力：

• 用户登录注册、微信/小程序/App 授权、用户资料、地址、收藏、反馈、余额、积分、签到、会员、分销、提现、发票、浏览记录、用户标签和用户分组。

智慧农业用法：

• 用户租地/认养、我的土地、我的认养、我的云仓和云仓账本都应挂到用户中心。
• 用户身份、地址、余额、积分、优惠券、售后入口直接复用。
• 云仓收益展示必须区分预计收益和实际收益，避免表达成固定收益。

源码入口：

• smartfarm/route/admin/user.php
• smartfarm/route/api/login.php
• smartfarm_user/pages.json
• smartfarm_user/api/user.js
• smartfarm_user/api/order.js

内容、素材、装修和溯源展示

可复用能力：

• 素材上传、图片/视频、文章 CMS、页面装修、微页面、专题、系统表单、用户表单。
• 现有代码存在履约/服务场景下的 trace_form_id 配置痕迹，但不是完整农业溯源系统。

智慧农业用法：

• 溯源档案可以复用素材、文章、系统表单的展示和上传能力。
• 农事/养殖记录、检测报告、证书、批次档案建议独立建模。
• 商品详情增加溯源入口，租地/认养详情增加周期记录入口。

源码入口：

• smartfarm/route/admin/diy.php
• smartfarm/route/admin/article.php
• smartfarm/route/admin/form.php
• smartfarm/app/common/repositories/system/attachment/AttachmentRepository.php

地图、定位与坐标

当前事实：

• 后端已有 /api/lbs/geocoder，通过腾讯地图完成逆地址解析；eb_system_config 已定义 tx_map_key，当前平台配置值尚未写入。
• 平台管理端 src/components/map/Map.vue 和商户端 src/components/map/map.vue 已能加载腾讯 GL JS、点选标记和逆地址。
• 用户端已使用 uni.getLocation、uni.chooseLocation、uni.openLocation，manifest.json 声明地图与定位权限。
• 用户现有定位链路使用 WGS84，而腾讯地图、uni-app <map> 和目标导航场景采用 GCJ02，存在坐标偏移风险。
• 现有数据库坐标字段分别使用 lng/lat、long/lat、longitude/latitude 且多为字符型，不能作为新农业域规范。
• 商户资料页存在经纬度标签方向错误和提交 log 字段的现状缺陷。
• 当前 joypack/tencent-map 请求实现关闭 TLS 证书校验，新农业地图服务不能直接复用该请求层。

智慧农业用法：

• V1 统一腾讯地图、GCJ02 和 longitude/latitude/coordinate_system。
• 农场和统一自提点保存真实点位；区域、地块、栏舍默认继承农场点位并使用示意图。
• 平台复用现有地图显示和点选，新建后端 FarmMapService 统一地理编码、逆地址、缓存、限流和错误。
• 用户农场导航只需要目标点位，不自动申请用户当前位置；地图失败时保留地址、示意图和复制。
• 客户端展示 Key 与服务端 WebService Key/SK 分离，真实值不写入文档或前端源码。
• 旧 LBS 坐标系和商户资料缺陷作为 CRMEB 基线整改单独回归，不在农业页面任务中顺手扩大重构。

客服、消息、队列和定时器

可复用能力：

• 客服端会话、订单/退款/物流/商品上下文、站内通知、短信、模板消息、队列、Swoole task、支付成功监听、自动取消订单、自动收货、自动评价、分账定时任务。

智慧农业用法：

• 租地/认养履约、云仓待选择、批次状态、本金/收益/回购结算通知可以复用短信、模板消息和站内消息模式。
• 农事/养殖周期提醒、支付超时释放、选择截止自动代销、二次售后转有效、节点结算和到期回购应走定时任务或队列。
• Swoole 常驻进程下改代码要重启服务，队列和定时器代码要避免持有请求级状态。

源码入口：

• smartfarm/route/service.php
• smartfarm/crmeb/jobs/
• smartfarm/crmeb/listens/
• smartfarm/app/event.php
• smartfarm/crmeb/services/SwooleTaskService.php

智慧农业 V1 改造映射

V1 目标	CRMEB 可复用部分	需要新增或扩展
农场、区域、地块	权限、菜单、素材、后台列表表单	农场/区域/地块模型、状态、可租作物、地块上下架
用户租地	商品展示、订单、支付、退款、发货、用户地址	租赁套餐、租地订单来源、种植批次、农事记录、收成邮寄
用户认养	商品展示、订单、支付、退款、发货、用户地址	认养品种、认养资产、认养套餐、养殖批次、产出记录
农事/养殖记录	素材上传、系统表单、用户端展示能力	农事记录、养殖记录、采收/产出记录、批次时间线
农产品溯源	素材、文章、页面装修、商品详情	溯源码、批次档案、检测报告、证书、商品/订单关联
平台自营商品	平台商品、库存、订单、支付、售后	自营来源、产地、批次、溯源关联、经营统计口径
商户商品销售	商户入驻、商品上传、审核、订单、发货、账单	农产品供货信息、供货资质、溯源资料、质量审核规则
云仓秒杀	普通秒杀场次、秒杀商品、秒杀价、库存、限购、支付超时	独立云仓活动、供货审核、SKU 批次、付款后待选择、结算模式和回购快照
用户云仓	用户中心、订单、余额、账单	单一明细去向、用户持仓、专属库存池、二次零售分配、本金/收益/回购
商户货款结算	商户财务、资金流水、分账、导出	订单明细快照、供货价模式、云仓供货货款账本
用户云仓账本入账	用户余额、提现、账单	本金/收益/回购账本、二次零售关联、冻结冲正、幂等资金入账

推荐实施路线

1. 保持 CRMEB 原商品、订单、支付、退款、普通秒杀、优惠券、拼团、预售等能力可用。
2. 新增农业业务域，不把农场地块、认养资产硬塞进普通商品表；可售套餐和订单明细再与商品/订单体系对接。
3. 通过订单明细扩展表记录业务来源、唯一去向和规则快照，先解决历史订单能否解释和核算。
4. 云仓秒杀独立建模，复用普通秒杀体验，但不与普通秒杀共用业务状态、库存池和账本。
5. 创建订单时写入农业订单绑定；支付成功核心事务内原子保存付款事实、农业业务状态、库存/迁移和 Outbox。提交后事件与队列只推进提醒、持仓、投影、通知和修复，不负责补造付款核心事实。
6. 结算账本只做冲正、冻结、作废，不物理删除历史财务事实。
7. V1 必须完成活动未抢完退库存、代销到期回购、农业异常和售后冲正，再后置 IoT、复杂 GIS、AI 和监管端。

文档和 Skill 沉淀方式

项目文档用于沉淀业务目标、范围、页面、规则和验收口径；业务决策以 12 为统一事实来源，流程、PRD、数据和开发前评审分别以 13 到 16 为详细依据。

项目内 skill 用于帮助 Codex 和技术人员在改代码时快速定位入口、调用链、风险点和验证方式。后续涉及智慧农业立项、CRMEB 底座能力、云仓秒杀、订单结算或源码改造时，应先读：

smartfarm/codex-skills/crmeb-merchant-extension-guide/SKILL.md

再按问题读取：

smartfarm/codex-skills/crmeb-merchant-extension-guide/references/smartfarm-project-brief.md
smartfarm_docs/10-crmeb-baseline-capability-map.md
smartfarm_docs/11-current-menu-page-audit.md

后续开发前检查清单

• 当前需求是复用 CRMEB 原能力，还是新增智慧农业业务域？
• 是否涉及订单、支付、库存、退款、商户货款或用户收益？
• 是否需要在订单明细扩展表写入商品来源、唯一去向、优惠/运费承担、结算模式、分成率和回购快照？
• 是否会影响普通秒杀、普通商品、普通商户结算？
• 是否需要新增菜单权限、平台端页面、商户端页面、用户端页面和 API？
• 是否需要支付超时、自动代销、售后转有效、节点结算和到期回购等队列/定时任务？
• 是否有可回归的最小闭环：创建配置、下单支付、延后选择、状态流转、履约、售后、结算、回购和导出？

关联文档

• 00-project-overview.md
• 01-project-charter.md
• 04-module-map.md
• 05-v1-scope-prd.md
• 08-v1-settlement-policy.md
• 09-cloud-warehouse-seckill.md
• 11-current-menu-page-audit.md
• 12-v1-business-decisions-and-glossary.md
• 13-cloud-warehouse-process-and-state-machines.md
• 15-v1-data-model-draft.md
• 23-crmeb-visual-baseline-audit.md
• 25-user-uniapp-reuse-audit.md