CRMEB/backend/modules/product/normal

product/normal/ — 实物商品产品类型

功能概述

实物商品（通用）产品类型，是最核心的产品履约形态。支持完整的商品管理（库存/SKU/规格）、物流发货、订单生命周期管理和售后流程。

运费模板（ShippingTemplates）已迁移至 app/ 层作为系统级功能，详见 app/services/shipping/、app/adminapi/controller/freight/、app/adminapi/route/freight.php。此处不再包含运费模板相关文件。

核心文件

normal/
├── controller/
│   ├── admin/
│   │   ├── ProductController.php              实物商品管理
│   │   ├── OrderController.php                实物订单管理
│   │   └── DeliveryServiceController.php      客服/发货管理
│   └── user/
│       ├── ProductController.php              用户端商品展示
│       ├── OrderController.php                用户端实物订单
│       └── CheckoutController.php             用户端下单确认
├── crontab/
│   ├── NormalOrderCancelTask.php              未支付订单自动取消
│   └── NormalTakeDeliveryTask.php             自动确认收货定时任务
├── dao/
│   ├── NormalOrderDao.php                     实物订单 DAO
│   ├── NormalProductDao.php                   实物商品 DAO
│   ├── NormalProductSkuDao.php                实物 SKU DAO
│   └── DeliveryServiceDao.php                 客服服务 DAO
├── handler/
│   ├── NormalAfterSaleHandler.php             实物售后规则处理器
│   └── NormalOrderAdapter.php                 实物订单适配器
├── listener/
│   ├── OrderPaidListener.php                  支付成功
│   ├── OrderCancelListener.php                订单取消
│   ├── OrderDeliveryListener.php              订单发货
│   ├── OrderTakeListener.php                  确认收货
│   ├── OrderCompleteListener.php              订单完成
│   ├── OrderCommentListener.php               订单评价
│   ├── OrderDeleteListener.php                订单删除
│   ├── OrderPriceChangeListener.php           改价
│   ├── OrderRefundCreateAfterListener.php     申请退款后
│   ├── OrderRefundSuccessListener.php         退款成功
│   ├── OrderRefundRefuseListener.php          拒绝退款
│   ├── OrderRefundCancelAfterListener.php     取消退款后
├── model/
│   ├── NormalProductModel.php                 实物商品模型（eb_pt_normal）
│   ├── NormalProductSkuModel.php              实物 SKU 模型（eb_pt_normal_sku）
│   ├── NormalOrderModel.php                   实物订单模型（eb_pt_normal_order）
│   └── DeliveryService.php
├── route/
│   ├── admin.php                              后台路由
│   ├── user.php                               用户端路由
│   └── manage.php                             移动管理端路由
├── service/
│   ├── ProductServices.php                    商品查询服务
│   ├── ProductSaveServices.php                商品保存服务
│   ├── OrderServices.php                      订单服务
│   ├── OrderCreateServices.php                订单创建服务
│   ├── CheckoutServices.php                   结算页服务
│   ├── RefundServices.php                     退款服务
│   ├── CrontabServices.php                    定时任务服务
│   └── DeliveryServiceServices.php            客服/发货服务
├── App.php
├── Handler.php                                产品类型主处理器
├── Installer.php
├── event.php
└── plugin.json

关键事件

事件名	说明
OrderPaySuccess	支付成功
OrderCancel	订单取消
OrderDelivery	订单发货
OrderTake	确认收货
OrderComplete	订单完成
OrderComment	订单评价
OrderDelete	订单删除
OrderPriceChange	改价
OrderRefundCreateAfter	申请退款后
OrderRefundSuccess	退款成功
OrderRefundRefuse	拒绝退款
OrderRefundCancelAfter	取消退款后
运费模板系列	运费模板相关事件

售后规则

• 支持售后类型：退款、退货退款、换货、维修
• 售后期限：7天
• 需要物流配送

数据表

• eb_pt_normal — 实物商品扩展表
• eb_pt_normal_sku — 实物商品 SKU 表
• eb_pt_normal_order — 实物商品订单扩展表
• eb_shipping_templates — 运费模板表

插件信息

{
    "key": "product_normal",
    "name": "实物商品",
    "type": "product"
}