总线

app\plugin\PluginHook：

• on($event, $handler) 订阅
• dispatch($event, $payload) 通知（插件异常不影响主流程）
• filter($event, $value, $payload) 可改返回值（用于校验、附加字段）

事件名常量集中在 app\plugin\PluginEvents。

高频事件

常量	事件名	时机
ORDER_PAID	order.paid	订单支付成功
ORDER_COMPLETED	order.completed	订单完成
USER_REGISTERED	user.registered	用户注册完成
REFUND_APPROVED	refund.approved	售后退款入账
ORDER_VALIDATE_ITEMS	order.validate_items	下单商品校验（可中断）
REFUND_BEFORE_APPLY / APPROVE	refund.before_*	售后拦截
BONUS_HUB_TABS / LOGS	bonus.hub.*	奖金聚合页
BONUS_SOURCE_INCOME	bonus.source_income	账户入账（奖金侧）
SCHEDULE_REGISTER	schedule.register	注册定时子任务
MEMBER_PURGE	member.purge	会员物理删除清理

新增事件：先在 PluginEvents 加常量与注释，再在主流程 dispatch/filter，最后在插件 listen.php 订阅。