Analysis 事件监听器清单（home/homeapi 模块）
本文档整理自 app/event.php，列出 home/homeapi 模块需要发送到 analysis 分析服务的事件。
1. 用户行为事件（用户漏斗）
| 事件名称 | 说明 | 监听器 | 触发位置 | 对应路由 |
|---|
| PageView | 页面浏览/访问 | PageViewAnalysisHandlerListener | - | 前端页面访问 |
| AddToCart | 商品加入购物车 | AddToCartAnalysisHandlerListener | CartService | POST /cart |
| RemoveFromCart | 商品移除购物车 | RemoveFromCartAnalysisHandlerListener | CartService | POST /cart |
| BeginCheckout | 开始结账 | BeginCheckoutAnalysisHandlerListener | CartService | POST /checkouts/:token |
| AddAddressInfo | 添加收货地址 | AddAddressInfoAnalysisHandlerListener、StandardAddAddressInfoAnalysisHandlerListener | CheckoutSinglePageService | POST /checkouts/:token/contact-information |
| AddPaymentInfo | 添加支付方式 | AddPaymentInfoAnalysisHandlerListener、StandardAddPaymentInfoAnalysisHandlerListener | CheckoutSinglePageService | POST /checkouts/:token/payment-method |
| AddShippingInfo | 添加物流信息 | AddShippingInfoAnalysisHandlerListener、StandardAddShippingInfoAnalysisHandlerListener | CheckoutSinglePageService | POST /checkouts/:token/shipping-method |
2. 顾客相关事件
| 事件名称 | 说明 | 监听器 | 触发位置 | 对应路由 |
|---|
| CustomerCreate | 顾客创建/添加 | CustomerCreateAnalysisHandlerListener | CustomerService | POST /account/appregister |
| CustomerSignUp | 顾客注册 | CustomerSignUpAnalysisHandlerListener | CustomerService | POST /account/register |
| CustomerLogin | 顾客登录 | CustomerLoginAnalysisHandlerListener | CustomerService | POST /account/login |
3. 订单相关事件
| 事件名称 | 说明 | 监听器 | 触发位置 | 对应路由 |
|---|
| OrderCreate | 订单创建 | OrderCreateAnalysisHandlerListener | CheckoutSinglePageService、CheckoutOnePageService | POST /ordersinglepage/:token |
| OrderOnePageCreate | 快捷订单创建 | OrderCreateAnalysisHandlerListener | CheckoutOnePageService | POST /orderonepage/:token/complete |
4. COD 订单事件
| 事件名称 | 说明 | 监听器 | 触发位置 | 对应路由 |
|---|
| codOrderSubmitSuccess | COD订单提交成功 | CodOrderSubmitSuccessAnalysisHandlerListener | CodOrderHandlerService | POST /ordercodpage/:token |
5. 事件统计汇总
| 分类 | 事件数量 |
|---|
| 用户行为事件 | 7 |
| 顾客相关事件 | 3 |
| 订单相关事件 | 2 |
| COD 订单事件 | 1 |
| 总计 | 13 |
6. 用户行为漏斗路径
PageView → AddToCart → BeginCheckout → AddAddressInfo/AddPaymentInfo/AddShippingInfo → OrderCreate → OrderPaid
7. 前台路由清单
| 路由 | 说明 | 触发事件 |
|---|
| POST /cart | 购物车操作 | AddToCart、RemoveFromCart |
| POST /checkouts/:token | 开始结账 | BeginCheckout |
| POST /checkouts/:token/contact-information | 保存联系信息 | AddAddressInfo |
| POST /checkouts/:token/payment-method | 保存支付方式 | AddPaymentInfo |
| POST /checkouts/:token/shipping-method | 保存物流信息 | AddShippingInfo |
| POST /account/register | 顾客注册 | CustomerCreate、CustomerSignUp |
| POST /account/appregister | App导流注册 | CustomerCreate |
| POST /account/login | 顾客登录 | CustomerLogin |
| POST /orderonepage/:token/complete | 快捷订单创建 | OrderOnePageCreate |
| POST /ordersinglepage/:token | 订单结账 | OrderCreate |
| POST /ordercodpage/:token | COD订单提交 | codOrderSubmitSuccess |
文档生成时间：2026-04-30