业务表解析-余额系统

已于 2024-03-10 18:44:06 修改
阅读量1k 收藏 1
点赞数
分类专栏： 业务表分析 文章标签： laravel php 业务表分析 余额系统
于 2022-07-25 17:13:05 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/DBCai/article/details/125971868
版权

业务表解析-余额系统

业务要求
  1. 有个地方可以查看用户的 可用余额 与 冻结余额
  2. 还有个地方可以查看用户余额（可用余额 + 冻结余额）变动的明细
  3. 后台可以查看用户余额变动明细，可通过类型，变更类型，甚至备注去匹配记录
业务例子
  1. 有那么一种关系，下级购物，上级可以获得佣金
  2. 当下级购物并且付款后，上级立马获得冻结余额。具体实现就是给上级创建一条增加冻结余额的记录，然后增加上级的冻结余额
  3. 当下级确认收货，并且订单得到结算后，就需要将冻结余额转移到可用余额中。具体实现就是给上级创建一条减少冻结余额的记录，然后上级减少冻结余额。接着，给上级创建一条添加可用余额的记录，然后增加上级的可用余额
表结构设计（mysql）
//可用余额 与 冻结余额
CREATE TABLE `users` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
  `balance` decimal(12,2) unsigned NOT NULL DEFAULT '0.00' COMMENT '可用余额',
  `frozen_balance` decimal(12,2) unsigned NOT NULL DEFAULT '0.00' COMMENT '冻结余额',
  PRIMARY KEY (`id`) USING BTREE,
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

//余额记录表
CREATE TABLE `user_balance_records` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  `user_id` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '用户ID',
  `status` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '余额状态 1=可用余额 2=冻结余额',
  `targetable_type` varchar(191) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '目标类型',
  `targetable_id` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '目标模型ID',
  `type` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '类型',
  `change_action` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '变更类型 1=增加 2=减少',
  `change_value` decimal(12,2) NOT NULL DEFAULT '0.00' COMMENT '变更值',
  `old_value` decimal(12,2) NOT NULL DEFAULT '0.00' COMMENT '旧值',
  `new_value` decimal(12,2) NOT NULL DEFAULT '0.00' COMMENT '新值',
  `comment` varchar(191) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '备注',
  `finance_comment` varchar(191) COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '' COMMENT '财务备注',
  `created_at` timestamp NULL DEFAULT NULL,
  `updated_at` timestamp NULL DEFAULT NULL,
  PRIMARY KEY (`id`),
  KEY `user_balance_records_user_id_index` (`user_id`)
) ENGINE=InnoDB AUTO_INCREMENT=1DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户余额流水表';

字段解释

  1. users.balance：可用余额，用来统计可以使用的余额，≥ 0
  2. users.frozen_balance：冻结余额，用来统计冻结的余额，≥ 0
  3. user_balance_records.status:入账状态，1=可用余额，2=冻结余额
  4. user_balance_records.targetable_type 与 user_balance_records.targetable_type_id， 对应引起余额变化的目标模型。例子：下单使用了余额，这里就是订单模型 与 订单ID了
  5. user_balance_records.type：类型，必须要足够精确。使用余额下单是一种类型，订单取消后，退还也是一种类型，使用余额发红包是一种，领取别人的红包是一种，因未领取完而回退的红包金额也是一种类型。这里，可能有人会问，既然已经有了目标模型，难道还无法确认什么类型吗？可以，但是不直观。例子：如果开发人员把充值与退款所消耗的余额都记录到了一条记录上（暂不考虑设计合理与否），此时仅由记录(targetable_type + targetable_type_id) 来识别的话，我们是无法一眼就看出这条记录是因为充值还是退款引起了，后期做搜索也不好做
  6. user_balance_records.change_action：值的变更类型，正数就是 增加 ，负数就是减少，冗余做筛选用的
  7. user_balance_records.change_value：变更值，负数时带符号
  8. user_balance_records.old_value：旧值，也就是变更前的 users.balance 或者 users.frozen_balance
  9. user_balance_records.new_value:新值，也就是变更后的 users.balance 或者 users.frozen_balance
  10. user_balance_records.comment：备注
  11. user_balance_records.finance_comment 财务备注，部分公司需要
程序思考
  1. 从表设计中可以发现，每一次余额的变动，都会修改 user_balance_records 与 users 表，所需存储记录时，必须加上事务
  2. 为了余额的准确性，必须先获得锁后，才能进行余额的相关操作

以此为界限，下面是 laravel 中的具体实现

数据表迁移文件
    //给用户表添加余额字段的 up 方法（原本就存在了users 表，所有里面没有ID）
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->unsignedDecimal('balance', 12)->default('0.00')->comment('余额');
            $table->unsignedDecimal('frozen_balance', 12)->default('0.00')->comment('冻结余额');
        });
    }

    //创建余额记录表的 up 方法
    public function up()
    {
        Schema::create('user_balance_records', function (Blueprint $table) {
            $table->increments('id');
            $table->unsignedBigInteger('user_id')->default('0')->comment('用户ID')->index();
            $table->unsignedTinyInteger('status')->default('1')->comment('入账状态 1=可用余额，2=冻结余额');
            $table->string('targetable_type')->default('')->comment('目标类型');
            $table->unsignedBigInteger('targetable_id')->default('0')->comment('目标模型ID');
            $table->unsignedTinyInteger('type')->default('1')->comment('类型');
            $table->unsignedTinyInteger('change_action')->default('1')->comment('变更类型 1=增加 2=减少');
            $table->decimal('change_value', 12)->default('0.00')->comment('变更值');
            $table->decimal('old_value', 12)->default('0.00')->comment('旧值');
            $table->decimal('new_value', 12)->default('0.00')->comment('新值');
            $table->string('comment')->default('')->comment('备注');
            $table->string('finance_comment')->default('')->comment('财务备注');
            $table->timestamps();
            $table->comment('用户余额流水表');
        });
    }
UserBalanceRecord 模型类
<?php

namespace App\Models\User;

use App\Models\User;
use Dcat\Admin\Traits\HasDateTimeFormatter;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Carbon;

/**
 * App\Models\User\UserBalanceRecord
 *
 * @property int         $id
 * @property int         $user_id         用户ID
 * @property int         $status          入账状态 1=可用余额，2=冻结余额
 * @property string      $targetable_type 目标类型
 * @property int         $targetable_id   目标模型ID
 * @property int         $type            类型
 * @property int         $change_action   变更类型 1=增加 2=减少
 * @property string      $change_value    变更值
 * @property string      $old_value       旧金额
 * @property string      $new_value       新金额
 * @property string      $comment         备注
 * @property string      $finance_comment 财务备注
 * @property Carbon|null $created_at
 * @property Carbon|null $updated_at
 * @property User|null   $user
 */
class UserBalanceRecord extends Model
{
    use HasDateTimeFormatter;

    protected $table   = 'user_balance_records';
    protected $guarded = [];

    //改变类型
    public const CHANGE_TYPE_INC = 1;
    public const CHANGE_TYPE_DEC = 2;
    public const CHANGE_TYPE_MAP = [
        self::CHANGE_TYPE_INC => '增加',
        self::CHANGE_TYPE_DEC => '减少'
    ];

    //入账状态 1=可用余额，2=冻结余额
    public const STATUS_ALREADY = 1;
    public const STATUS_WAIT    = 2;
    public const STATUS_MAP     = [
        self::STATUS_ALREADY => '可用余额',
        self::STATUS_WAIT    => '冻结余额'
    ];

    /**
     * 类型:根据改变余额的类型，自行添加
     */
    public const TYPE_RED_ENVELOPE_SEND               = 1;
    public const TYPE_RED_ENVELOPE_RECEIVE            = 2;
    public const TYPE_MAP                             = [
        self::TYPE_RED_ENVELOPE_SEND               => '发红包',
        self::TYPE_RED_ENVELOPE_RECEIVE            => '领红包',
    ];

    public function targetable()
    {
        return $this->morphTo();
    }

    public function user()
    {
        return $this->belongsTo(User::class);
    }

}
UserBalanceRecordService 类
<?php

namespace App\Services\User;

use App\Constants\CacheKey;
use App\Models\User;
use App\Models\User\UserBalanceRecord;
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\Cache;

class UserBalanceRecordService
{
    /**
     * 修改余额
     *
     * @param Model  $model
     * @param int    $userId
     * @param float  $changeValue
     * @param int    $type 看模型
     * @param string $comment
     *
     * @return bool
     */
    public static function changeBalance(
        Model $model,
        int $userId,
        float $changeValue,
        int $type,
        string $comment = ''
    ): bool {
        $lock = Cache::lock(CacheKey::LOCK . 'user-balance:' . $userId, 10);
        try {
            // 为获得锁等待最多 5 秒...
            $lock->block(5);

            $isNaturalNumber = bccomp((string)$changeValue, '0.00', 2) !== -1;

            $changRow = User::query()
                ->where('id', $userId)
                ->when(!$isNaturalNumber, function ($query) use ($changeValue) {
                    $query->where('balance', '>=', abs($changeValue));
                })
                ->increment('balance', $changeValue);
            if ($changRow === 0) {
                return false;
            }

            $newValue = User::query()->where('id', $userId)->value('balance') ?? '0.00';

            //添加记录
            $record                = new UserBalanceRecord();
            $record->user_id       = $userId;
            $record->type          = $type;
            $record->change_value  = $changeValue;
            $record->old_value     = bcsub($newValue, (string)$changeValue, 2);
            $record->new_value     = $newValue;
            $record->change_action = $isNaturalNumber ? UserBalanceRecord::CHANGE_TYPE_INC : UserBalanceRecord::CHANGE_TYPE_DEC;
            $record->comment       = $comment;
            $record->status        = UserBalanceRecord::STATUS_ALREADY;
            $record->targetable()->associate($model);

            return $record->save();

        } catch (\Exception $e) {
            return false;
        }
        finally {
            optional($lock)->release();
        }

    }

    /**
     * 修改冻结余额
     *
     * @param Model  $model
     * @param int    $userId
     * @param float  $changeValue
     * @param int    $type 看模型
     * @param string $comment
     *
     * @return bool
     */
    public static function changeFrozenBalance(
        Model $model,
        int $userId,
        float $changeValue,
        int $type,
        string $comment = ''
    ): bool {
        $lock = Cache::lock(CacheKey::LOCK . 'user-frozen-balance:' . $userId, 10);
        try {
            // 为获得锁等待最多 5 秒...
            $lock->block(5);

            $isNaturalNumber = bccomp((string)$changeValue, '0.00', 2) !== -1;

            $changRow = User::query()
                ->where('id', $userId)
                ->when(!$isNaturalNumber, function ($query) use ($changeValue) {
                    $query->where('frozen_balance', '>=', abs($changeValue));
                })
                ->increment('frozen_balance', $changeValue);
            if ($changRow === 0) {
                return false;
            }

            $newValue = User::query()->where('id', $userId)->value('frozen_balance') ?? '0.00';

            //添加记录
            $record                = new UserBalanceRecord();
            $record->user_id       = $userId;
            $record->type          = $type;
            $record->change_value  = $changeValue;
            $record->old_value     = bcsub($newValue, (string)$changeValue, 2);
            $record->new_value     = $newValue;
            $record->change_action = $isNaturalNumber ? UserBalanceRecord::CHANGE_TYPE_INC : UserBalanceRecord::CHANGE_TYPE_DEC;
            $record->comment       = $comment;
            $record->status        = UserBalanceRecord::STATUS_WAIT;

            $record->targetable()->associate($model);

            return $record->save();

        } catch (\Exception $e) {
            return false;
        }
        finally {
            optional($lock)->release();
        }

    }
  
}

//CacheKey::LOCK 为一个常量，这里的定义的值是 “lock:”
具体使用
//记得传自己的参数哈
UserBalanceRecordService::changeBalance()
UserBalanceRecordService::changeFrozenBalance()
代码说明
  1. 读者可能会很好奇，代码里面怎么看不到启用事务代码的？这是因为changeBalance 与 changeFrozenBalance方法的实现，是个相对底层的代码。调用这个方法的地方，往往还会有一些其他的数据库操作的，并且会在那里启用事务。所以这里不需要启用事务，这样子还可以减少事物嵌套了
DBCai
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
php 余额冻结设计_适用于多业务的资金账户管理系统如何设计？
weixin_39964590的博客
12-04 607
资金账户管理系统能准确反映资金的变动情况和确保客户账户资金余额的正确性，随着业务的发展，一个平台可能会产生越来越多不同类型的业务。本文从资金管理系统的作用出发，对如何设计好资金账户管理系统展开了分析说明，供大家一同参考和学习。有企业客户开通了云流量服务，按实际使用量进行计费，然后再完成付款。由于是先使用服务，后计费付款的模式，需要客户先预存资金，以确保有充足的资金能够完成付费，否则客户将没有使用权...
mysql 余额表设计_余额表的设计
weixin_39600510的博客
02-04 2187
原由在开发ERP应用中，我们经常需要知道某个实体的当前数量，例如知道商品当前的库存，或者科目的金额，或者某个客户剩余的信用额度，所以这种需求是比较普遍的。通常会设计两张表，一张是流水账表，有的称明细表，或者日志表，用于记录所有发生的事务记录。一张是余额表，用于记录各个实体当前最新的余额。流水号NO.商品编号ProductId增加Add减少Reduce1P132P113P25商品编号ProductI...
设计一个对银行账户余额操作的简单程序（java）
weixin_56587881的博客
04-23 1411
假设 账号: int account=666666 密码:int password=111111 余额:int balance=10000 进入程序输出选择操作选项: 1.存款,2.取款,3.查询余额 要求使用Scanner交互式操作. 存款,取款,查询均需要输入账号密码,验证没有问题即可操作. 可以多次重复操作。 输出结果： ...
并发实际场景（保持余额操作的正确：数据库余额字段版）
qq_23725949的博客
12-14 3279
场景： 一个人在一家银行办了一个账户，银行给了 一张卡（存取款）、一本存折（存取款）、一个网银（查询余额） 卡和存储不断存款和取款，网银不断查询余额。如何保持余额的正确。   数据库余额表：原本想用版本号来实现的，后面弃用version字段。 DROP TABLE IF EXISTS `t_test`; CREATE TABLE `t_test` (   `id` int(11) NOT...
微信小程序-记账本
热门推荐
weixin_46008509的博客
07-01 1万+
项目说明 这是一款具有记账功能的小程序-记账本，简单分为四个模块：首页、记账、报表、我的。首页页面初始数据显示当月的收入支出和结余的情况、以及当日收支，有列表可以选择其他日期的记账信息。记账页面有记账类型、消费类型、支付类型和记账信息可选择，记账信息选择记账时间、金额和备注，最后选择保存。报表模块页面有年列表、月列表和日列表选择记账的日期，选择支出或收入会分别显示当年的收支总额，以及显示百分比饼图可直观看到年度的消费类型比例。最后是我的模块，提供授权登录来显示用户的头像及昵称。 ...
深脑链打地基，人工智能建高楼：DBC和AI的不解之缘
m0_65813568的博客
02-19 357
深脑链打地基，人工智能建高楼：DBC和AI的不解之缘
记一个简单表结构设计语句--消费记账
向小雅的博客
06-10 264
CREATE DATABASE HUTUBILL; USE HUTUBILL; CREATE TABLE CONFIG ( ID INT AUTO_INCREMENT, KEY_ VARCHAR(255), VALUE VARCHAR(255), PRIMARY KEY (ID) ) DEFAULT CHARSET =UTF8; CREATE TABLE CATEGORY( ID INT AUTO_INCREMENT, NAME VARCHAR(255), PRIMARY
laravel中锁以及事务的简单使用
最新发布
smallmww的博客
10-17 1908
共享：我可以读写加锁, 别人可以读加锁。排他：只有我 才 可以读写加锁, 也就是说，必须要等我提交事务，其他的才可以操作。二、简单例子实现加锁锁和事务在使用时需要配合使用，也就是用锁时需要先开启事务，事务提交时，会自动解锁。// 开启事务//共享锁 s锁 读锁//排他锁 x锁 写锁...
php计算每笔交易后余额,PHP实现财务审核通过后返现金额到客户的功能
weixin_29344197的博客
03-20 280
PHP实现财务审核通过后返现金额到客户的功能来源：中文源码网浏览： 次日期：2019年11月5日【下载文档:PHP实现财务审核通过后返现金额到客户的功能.txt】(友情提示:右键点上行txt文档名->目标另存为)PHP实现财务审核通过后返现金额到客户的功能应用场景：有这么一个返现的系统，当前端客户发起提现的时候，后端就要通过审核这笔返现订单，才可以返现到客户的账号里。来...
银行业务系统--jsp
12-10
【银行业务系统--jsp】是基于JavaServer Pages（JSP）技术开发的一个本科毕业设计项目，主要用于模拟实际银行的各种业务操作。在这个系统中，JSP作为前端展示层，与后端服务器进行交互，处理用户的请求并展示响应...
Java-银行管理系统源代码.pdf
07-14
【Java 银行管理系统源代码解析】 在Java编程中，银行管理系统的实现涉及到许多核心概念和技术，这里我们将深入分析给定的`accounts.java`和`DBoper.java`部分源代码，了解其主要功能和设计思路。 1. **类与对象**...
基于jdbc的银行业务管理系统
05-11
【基于jdbc的银行业务管理系统】是一个完全由Java编程语言实现的后台系统，专注于处理银行业务逻辑，不包含前端用户界面。这个系统利用Java JDBC（Java Database Connectivity）技术来与数据库进行交互，完成诸如...
c++编写的模拟银行系统 链表 附带源码及设计报告
11-24
《C++实现的模拟银行系统：链表与设计思想解析》 C++是一种强大的面向对象编程语言，广泛应用于系统软件、应用软件、游戏开发以及金融领域的软件系统，如银行系统。本项目是基于C++编写的一个模拟银行系统，它利用...
快手信息流广告-平台全解析-.pdf
09-20
快手信息流广告平台是一个功能强大且复杂的系统，为广告主提供了高效的解决方案，帮助他们在快手平台上实现业务目标。但是，需要广告主和快手平台之间的紧密合作和沟通，才能充分发挥快手信息流广告平台的作用。
MySQL语法--03--查询select
时光里的博客
10-03 799
查询 select 判断条件，子查询，统计查询，聚合，分组，表的关联 判断条件 distinct 去重 SELECT DISTINCT job FROM emp; like 通配符：%（n个字符） _下划线（1个字符） 查询emp表中,名字 t 开头 n个字符 SELECT * FROM emp WHERE ename LIKE 't%'; 查询emp表中,名字 含有 n 的 SELECT * FROM emp WHERE ename LIKE '%n%'; 查询emp表中,名字 t 开头 3
Mysql 数据库表分区（流水账单表数据保留一季度示例）
qq_36330624的博客
06-08 1659
1.流水账单表数据保留一季度示例结构图 流水账单主表创建唯一索引创建触发器-备份清理的数据清理批量删除导致的DataFree流水账单备份数据按月份RANGE分区1月份2月份3月份4月份 2.创建表 1.基本表结构 CREATE TABLE `withdraw_range` ( `id` int(11) NOT NULL AUTO_INCREMENT, `mid` int(11) DEFAULT NULL, `money` decimal(19,2) DEFAULT NULL COMMENT '金
MySQL数据库课设
WUHU648的博客
07-04 5918
数据库应用课程设计-线上美食订购数据库系统 一、项目简介 商家可以由食材供货源提供相应的食材，其中食材供货源有联系电话、负责人姓名、地址、供应商名称和供应商编号属性五个属性，其中供应商编号是唯一标识码，不同的食材供货源可以为不同的商家提供食材，并产生了提供量属性，商家有好评度、姓名、收入、账号和评价等级五个属性，其中账号是商家的唯一标识码。商家开设了线下餐厅和雇佣了外卖员，线下餐厅有餐厅号、餐厅好评度、外卖员编号和就餐人数四个属性，其中餐厅号是唯一标识码，外卖员编号是外键。外卖员有外卖员编号、联系方式、性别
Mysql资金账户表_mysql 账户管理
weixin_42356137的博客
01-28 385
今天学习怎样用 mysql 命令的方式来管理账号。手册上说 “GRANT语句允许系统管理员创建MySQL用户账户，授予权限。”。但我无论怎么样也没有办法用这个命令创建用户账号。我想增加一个新的测试用户，命令如下：mysql> GRANT ALL ON qyoa.* TO chy@localhost INDENTIFIED BY "123456";ERROR 1046 (3D000): No ...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值