buer/asset

There is no license information available for the latest version (2.4.2) of this package.

Finance packagist

2.4.2 2024-04-02 06:34 UTC

Requires

• php: >=5.6.0

Unknown License

• Buer Huang

README

用户资金管理系统

框架要求

Laravel >= 5.1

安装

composer require buer/asset

配置

1.在 config/app.php 注册 ServiceProvider 和 Facade (Laravel 5.5 无需手动注册)

'providers' => [
    // ...
    Buer\Asset\AssetServiceProvider::class,
],
'aliases' => [
    // ...
    'Asset' => Buer\Asset\AssetFacade::class,
],

数据迁移

php artisan migrate

laravel5.4迁移时因编码问题会抛异常索引key过长。解决问题，2个办法：

1.升级MySql版本到5.5.3以上。

2.手动配置迁移命令migrate生成的默认字符串长度，在AppServiceProvider中调用Schema::defaultStringLength方法来实现配置：

use Illuminate\Support\Facades\Schema;

public function boot()
{
   Schema::defaultStringLength(191);
}

拷贝配置文件

php artisan vendor:publish

若成功，则会生成文件config/asset.php, 其中：

type代表交易类型，禁止修改。

sub_type是子类型，可以自定义。

程序调用

使用Asset门面

use Asset;

#...

Asset::recharge(金额, 子类型, '订单号', '备注', 用户ID, 管理员ID, 关联模型对象); // 加款
Asset::freeze(金额, 子类型, '订单号', '备注', 用户ID, 管理员ID, 关联模型对象); // 冻结
Asset::withdraw(金额, 子类型, '订单号', '备注', 用户ID, 管理员ID, 关联模型对象); // 提现
Asset::unfreeze(金额, 子类型, '订单号', '备注', 用户ID, 管理员ID, 关联模型对象); // 解冻
Asset::consume(金额, 子类型, '订单号', '备注', 用户ID, 管理员ID, 关联模型对象); // 从余额扣款
Asset::consume(金额, 子类型, '订单号', '备注', 用户ID, 管理员ID, 关联模型对象, 'frozen'); // 从冻结扣款
Asset::refund(金额, 子类型, '订单号', '备注', 用户ID, 管理员ID, 关联模型对象); // 退款
Asset::expend(金额, 子类型, '订单号', '备注', 用户ID, 管理员ID, 关联模型对象); // 从余额支出
Asset::expend(金额, 子类型, '订单号', '备注', 用户ID, 管理员ID, 关联模型对象, 'frozen'); // 从冻结支出
Asset::income(金额, 子类型, '订单号', '备注', 用户ID, 管理员ID, 关联模型对象); // 收入
Asset::transfer('金额', 子类型, '订单号', '备注', '转出用户ID', '转入用户ID', '管理员ID', '关联模型对象'); // 转账

传关联模型对象参数时，需要在模型中使用此trait

use Buer\Asset\Models\Relations\AssetAmountMorphMany;

class YourModel extends Model
{
    use AssetAmountMorphMany;
}

日结

每天需要执行一次日结命令，执行时间不限，默认结算前一天的数据:

php artisan daily-settlement:user-asset
php artisan daily-settlement:platform-asset

若漏做，可以使用日期参数补做，补做日期为结算当前日期:

php artisan daily-settlement:user-asset 20180620
php artisan daily-settlement:platform-asset 20180620

对账

用户对账：

剩余金额 + 冻结金额 = 累计平台加款 + 累计平台退款 + 累计交易收入 - 累计平台提现 - 累计平台消费 - 累计交易支出

平台对账:

累计用户加款 - 累计用户提现 = 平台资金 + 托管资金 + 用户总余额 + 用户总冻结

字段都在数据库中。

异常

异常默认会抛出AssetException，可以在配置asset.php中自定义exception_class为你的异常类。