Appearance
模块分工与调用规范
EBAOZU 系统后端遵循严格的单向依赖分层架构: Controller(接收并校验请求) → Services(核心业务逻辑与事务) → DAO(数据访问层) → Model(ORM 模型映射)。
app/
├── common/controller/Lease.php # 租赁通用 Controller Trait(管理端接口复用)
├── controller/ # 控制器层(api / admin / store)
├── services/
│ ├── alipay/CommerceRentServices.php # 支付宝租赁交易组件核心业务
│ ├── alipay/CreditZhimaServices.php # 芝麻信用预授权核心业务
│ └── order/
│ ├── StoreOrderServices.php # 订单核心调度服务
│ ├── StoreOrderLeaseServices.php # 租赁业务专属服务
│ └── StoreOrderComputedServices.php# 实时费用与分期试算服务
├── dao/order/ # 数据访问层
└── model/order/ # 数据模型定义开放平台基础集成要求
租赁业务正常运转需确保以下第三方开放平台能力已配置就绪:
- 支付宝开放平台:
- 签约开通“租赁行业交易组件”与“芝麻信用免押”官方能力;
- 在系统后台完成应用公钥证书、支付宝公钥证书及根证书的合规配置;
- 网关异步通知需确保外网可正常通过 HTTPS 访问,且配置了有效的域名 SSL 证书。
- 第三方电子合同服务:
- 配置电子签署厂商的开发者凭据,确保租赁电子合同模板已完成平台报备与印章配置。
- 周期性扣款定时任务:
- 系统代扣任务通过命令行/计划任务驱动;
- 支付宝规范要求代扣扣款需在每日 07:00 ~ 23:00 之间发起。
二次开发必须遵守的底线准则
为保障系统长期升级兼容性与资金/资产安全,进行二次开发时请严格遵循以下准则:
1. 严格禁止跨层直接操作数据库
- 严禁在 Controller 中书写原生 SQL 或直接调用
Db::table(...); - 所有业务读写操作必须封装在对应的
Services或DAO类中; - 订单与分期状态变更逻辑复杂,禁止自行绕过 Service 方法直接 UPDATE 状态字段。
2. 状态扭转必须包裹在数据库事务中
任何涉及订单状态流转、分期账单核销、库存扣减及押金变动的二开逻辑,必须包裹在数据库强事务中处理,杜绝网络异常或接口失败导致的数据不一致:
php
$this->transaction(function () {
// 1. 业务逻辑处理
// 2. 状态扭转更新
// 3. 记录操作流水
});3. 通过事件监听机制(Event / Listener)实现解耦扩展
若二开需要对接企业自有 ERP、WMS 仓库、CRM 或财务对账系统,强烈建议通过监听系统标准订单事件(如 OrderTake、OrderPaySuccess 等)进行异步解耦拓展,切勿在核心交易代码主链路上同步插入过多耗时的外部网络请求。
并发安全与防重纪律
- 创单防重入:系统在关键下单链路中内置了 Redis 分布式互斥锁,二开自定义业务入口时也应具备防重入意识;
- 异步网关幂等性:外部回调(如支付、代扣通知)具有重试机制,接收端必须先校验业务单据的当前状态,已处理的记录直接返回成功,严禁重复记账;
- 押金安全原则:未结清分期账单或存在未结货损争议时,系统严禁调用预授权解冻。调整完结流转时切勿颠倒调用顺序。