Skip to content

模块分工与调用规范 ​

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/                      # 数据模型定义

开放平台基础集成要求 ​

租赁业务正常运转需确保以下第三方开放平台能力已配置就绪:

  1. 支付宝开放平台:
    • 签约开通“租赁行业交易组件”与“芝麻信用免押”官方能力;
    • 在系统后台完成应用公钥证书、支付宝公钥证书及根证书的合规配置;
    • 网关异步通知需确保外网可正常通过 HTTPS 访问,且配置了有效的域名 SSL 证书。
  2. 第三方电子合同服务:
    • 配置电子签署厂商的开发者凭据,确保租赁电子合同模板已完成平台报备与印章配置。
  3. 周期性扣款定时任务:
    • 系统代扣任务通过命令行/计划任务驱动;
    • 支付宝规范要求代扣扣款需在每日 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 等)进行异步解耦拓展,切勿在核心交易代码主链路上同步插入过多耗时的外部网络请求。


并发安全与防重纪律 ​

  1. 创单防重入:系统在关键下单链路中内置了 Redis 分布式互斥锁,二开自定义业务入口时也应具备防重入意识;
  2. 异步网关幂等性:外部回调(如支付、代扣通知)具有重试机制,接收端必须先校验业务单据的当前状态,已处理的记录直接返回成功,严禁重复记账;
  3. 押金安全原则:未结清分期账单或存在未结货损争议时,系统严禁调用预授权解冻。调整完结流转时切勿颠倒调用顺序。

安徽用易软件科技有限公司 · 承信租 V4 官方技术文档中心