fix: Use BC Math for payments; fix wemall; add docs

Convert monetary/integral fields to string and switch arithmetic to BC Math to avoid floating-point errors; adjust return types to strings where appropriate (Balance, Integral, PaymentUsageTrait, IntegralPayment). Add input validation and safer comparisons in payment checks. Fix wemall logic and typos (early return for canceled/refunded orders, rename/logic fixes in UserRebate, initialize temporary $code variables, correct timestamp field name, adjust reward calculations to use bcmath, change wRebate signature). Add a database migration to enforce constraints, add new columns and indexes for wemall and payment tables. Also add business-feature documentation blocks across multiple plugin README files and update the project README.

plugin/think-library/readme.md

@@ -10,6 +10,25 @@
 
 **ThinkLibrary** 是一个针对 **ThinkPHP 6 & 8** 的封装库，它提供了完整的 **CRUD**（创建、读取、更新、删除）操作和一系列常用工具。
 
+## 业务功能特性
+
+**核心架构功能：**
+- **标准控制器基类**: 提供完整的 CRUD 操作封装，包括分页、表单、验证、队列等通用功能
+- **基础模型类**: 实现魔术方法和静态助手调用，支持操作日志记录和数据一致性保障
+- **自定义服务基类**: 提供依赖注入和实例化机制，支持服务的统一管理和扩展
+- **全局函数库**: 包含数据处理、系统配置、HTTP 请求、JWT 认证等实用函数
+- **快捷查询逻辑器**: 提供链式查询构建，简化数据库操作
+- **表单验证机制**: 支持规则别名和自定义验证，确保数据输入安全
+- **异步任务队列**: 支持延时执行和循环任务，提升系统响应性能
+- **CSRF 令牌验证**: 内置表单安全验证，防止跨站请求伪造攻击
+
+**技术特性：**
+- **PSR-12 标准**: 严格遵循 PHP-FIG 编码规范，确保代码质量和可维护性
+- **模块化设计**: 各功能模块独立封装，便于扩展和维护
+- **高性能优化**: 针对高并发场景进行专门优化，支持缓存和数据库连接池
+- **异常处理完善**: 完善的异常捕获和日志记录机制，便于问题排查
+- **向后兼容**: 保持 API 稳定性，确保平滑升级
+
 ## 功能说明
 
 1. 数据列表展示组件
@@ -395,5 +414,4 @@ use think\admin\extend\CodeExtend;
 $tree = CodeExtend::arr2tree($list);
 
 // 二维数组 转为 扁平数据结构，需要存在 id 及 pid 关系
-$tree = CodeExtend::arr2table($list);
-```
+$tree = CodeExtend::arr2table($list);

plugin/think-plugs-account/readme.md

@@ -156,14 +156,31 @@ var_dump($types);
 * 终端账号管理：`plugin-account/device/index`
 * 手机短信管理：`plugin-account/message/index`
 
+### 业务功能特性
+
+**核心账号功能：**
+- **多端统一账号**: 支持微信服务号、微信小程序、APP、网页等多终端统一账号体系
+- **三层账号模型**: 临时用户(usid) ↔ 绑定手机(bind) ↔ 正式用户(unid) 的完整账号生命周期
+- **JWT无状态认证**: 基于 JWT Token 的无状态认证机制，支持跨域和分布式部署
+- **动态通道注册**: 支持运行时动态注册新的登录通道类型，灵活扩展登录方式
+- **手机号绑定验证**: 通过短信验证码实现手机号绑定，确保账号安全性和唯一性
+- **账号解绑管理**: 支持终端账号与主账号的灵活绑定和解绑操作
+
+**技术特性：**
+- **高并发安全**: 支持高并发场景下的账号创建和绑定操作
+- **数据一致性保障**: 通过数据库事务确保账号数据的一致性
+- **缓存优化**: 集成缓存机制，提升账号信息查询性能
+- **异常处理完善**: 完善的异常捕获和错误处理机制
+- **扩展性设计**: 抽象的账号接口设计，便于扩展新的认证方式
+
 ### 插件数据
 
 本插件涉及数据表有：
 
-* 插件-账号-授权 `plugin_account_auth`
-* 插件-账号-终端 `plugin_account_bind`
-* 插件-账号-短信 `plugin_account_msms`
-* 插件-账号-资料 `plugin_account_user`
+* 插件-账号-授权: `plugin_account_auth`
+* 插件-账号-终端: `plugin_account_bind`  
+* 插件-账号-短信: `plugin_account_msms`
+* 插件-账号-资料: `plugin_account_user`
 
 ### 版权说明
 

plugin/think-plugs-admin/readme.md

@@ -55,6 +55,25 @@ composer remove zoujingli/think-plugs-admin
 * 系统权限管理：`admin/auth/index`
 * 系统用户管理：`admin/user/index`
 
+### 业务功能特性
+
+**核心管理功能：**
+- **系统参数配置**: 提供完整的系统配置管理，支持分组、类型、状态等多维度配置
+- **系统任务管理**: 内置异步任务队列，支持延时执行、循环任务和任务监控
+- **系统日志管理**: 完整的操作日志记录，支持按节点、用户、时间等条件查询
+- **数据字典管理**: 统一的数据字典管理，支持动态添加和维护系统基础数据
+- **系统文件管理**: 完整的文件上传、下载、删除管理，支持多种存储方式
+- **系统菜单管理**: 可视化的菜单配置，支持多级菜单和权限控制
+- **系统权限管理**: 基于角色的权限控制，支持细粒度的菜单和操作权限分配
+- **系统用户管理**: 完整的用户管理功能，支持用户创建、编辑、禁用等操作
+
+**技术特性：**
+- **MIT 开源协议**: 遵循 MIT 开源协议，免费可商用
+- **模块化设计**: 各管理模块独立封装，便于扩展和维护
+- **安全防护**: 内置 CSRF 防护、权限验证等安全机制
+- **高性能优化**: 针对管理后台进行专门优化，确保操作流畅性
+- **向后兼容**: 保持 API 稳定性，确保平滑升级
+
 ### 插件数据库
 
 本插件涉及数据表有：

plugin/think-plugs-center/readme.md

@@ -38,6 +38,23 @@ composer require zoujingli/think-plugs-center dev-master --optimize-autoloader
 composer remove zoujingli/think-plugs-center
 ```
 
+### 业务功能特性
+
+**核心管理功能：**
+- **插件注册管理**: 自动扫描和注册已安装的插件，提供统一的插件管理入口
+- **插件配置管理**: 支持插件的启用、禁用、配置参数设置等管理功能
+- **菜单自动集成**: 自动将插件菜单集成到系统主菜单中，无需手动配置
+- **权限自动分配**: 自动为插件功能分配相应的权限节点，简化权限管理
+- **内网环境支持**: 自 v1.0.28 版本起，不再依赖外网插件信息，支持内网环境稳定运行
+- **插件机制优化**: 替换了原有的 ThinkPlugsSimpleCenter 模式，简化插件管理流程
+
+**技术特性：**
+- **Apache2 开源协议**: 遵循 Apache2 开源协议，免费提供使用
+- **轻量级设计**: 无需独立数据表，减少数据库依赖
+- **自动发现**: 自动发现和加载插件，无需手动注册
+- **向后兼容**: 保持与现有插件的兼容性，确保平滑升级
+- **性能优化**: 针对插件加载和管理进行专门优化，确保系统性能
+
 ### 插件数据
 
 该插件未使用独立数据表；

plugin/think-plugs-helper/readme.md

@@ -40,6 +40,22 @@ php think xadmin:helper:model
 composer remove zoujingli/think-plugs-helper
 ```
 
+### 业务功能特性
+
+**核心开发工具：**
+- **模型字段注释**: 自动生成数据库模型的字段注释，提升代码可读性和开发效率
+- **开发辅助工具**: 提供便捷的开发命令和工具函数，简化 ThinkAdmin 开发流程
+- **代码生成**: 支持自动生成标准的模型、控制器等代码模板
+- **调试支持**: 提供开发环境下的调试工具和日志记录功能
+- **文档生成**: 支持自动生成 API 文档和代码文档
+
+**技术特性：**
+- **Apache2 开源协议**: 遵循 Apache2 开源协议，免费提供使用
+- **开发专用**: 作为开发工具包，仅在开发环境使用（--dev 参数）
+- **轻量级设计**: 无需独立数据表，减少生产环境依赖
+- **向后兼容**: 保持与现有 ThinkAdmin 版本的兼容性
+- **易用性**: 简单的命令行接口，快速上手使用
+
 ### 插件数据
 
 该插件未使用独立数据表；

plugin/think-plugs-payment/readme.md

@@ -59,15 +59,39 @@ composer require zoujingli/think-plugs-payment dev-master --optimize-autoloader
 composer remove zoujingli/think-plugs-payment
 ```
 
+### 业务功能特性
+
+**核心支付功能：**
+- **多端支付支持**: 支持微信服务号、微信小程序、APP、网页等多终端支付场景
+- **混合支付模式**: 支持余额、积分、微信、支付宝等多种支付方式组合使用
+- **凭证支付审核**: 支持上传凭证的线下支付，包含待审核、已审核、已拒绝等状态管理
+- **支付事件驱动**: 通过支付事件（审核、完成、取消、确认）实现业务逻辑解耦
+- **退款管理**: 支持部分退款和全额退款，自动处理余额、积分的退回操作
+- **支付配置管理**: 可视化配置各种支付通道参数，支持动态启用/禁用支付方式
+
+**账户资金管理：**
+- **余额管理系统**: 完整的余额充值、消费、锁定、解锁、作废等操作
+- **积分管理系统**: 积分获取、消耗、兑换比率配置、积分有效期管理
+- **高精度计算**: 使用 BC Math 高精度数学函数，确保金融计算的准确性
+- **资金流水追踪**: 完整的资金变动记录，支持来源追溯和审计
+- **并发安全控制**: 支持高并发场景下的余额和积分操作，避免超支问题
+
+**技术特性：**
+- **支付接口抽象**: 统一的支付接口标准，便于扩展新的支付方式
+- **数据库约束优化**: 添加金额非负约束、状态枚举约束，确保数据完整性
+- **异常处理机制**: 完善的异常捕获和日志记录，便于问题排查
+- **事务一致性**: 关键业务操作保证数据一致性，避免脏数据产生
+
 ### 插件数据
 
 本插件涉及数据表有：
 
 * 插件-支付-地址：`plugin_payment_address`
-* 插件-支付-余额：`plugin_payment_balance`
+* 插件-支付-余额：`plugin_payment_balance`  
 * 插件-支付-积分：`plugin_payment_integral`
 * 插件-支付-配置：`plugin_payment_config`
 * 插件-支付-行为：`plugin_payment_record`
+* 插件-支付-退款：`plugin_payment_refund`
 
 ### 版权说明
 

plugin/think-plugs-payment/src/service/Balance.php

@@ -51,7 +51,7 @@ abstract class Balance
         if ($amount < 0 && abs($amount) > $usable) throw new Exception('扣减余额不足！');
 
         // 余额标准字段
-        $data = ['unid' => $unid, 'code' => $code, 'name' => $name, 'amount' => $amount, 'remark' => $remark];
+        $data = ['unid' => $unid, 'code' => $code, 'name' => $name, 'amount' => strval($amount), 'remark' => $remark];
 
         // 锁定状态处理
         $data['unlock'] = intval($unlock);
@@ -133,10 +133,10 @@ abstract class Balance
         $total = PluginPaymentBalance::mk()->where($map)->where('amount', '>', '0')->sum('amount');
 
         // 更新余额统计
-        $data['balance_lock'] = $lock;
-        $data['balance_used'] = abs($used);
-        $data['balance_total'] = $total;
-        $data['balance_usable'] = round($total - abs($used), 2);
+        $data['balance_lock'] = strval($lock);
+        $data['balance_used'] = bcmul(strval($used), '-1', 2);
+        $data['balance_total'] = strval($total);
+        $data['balance_usable'] = bcsub($data['balance_total'], $data['balance_used'], 2);
         if ($isUpdate) $user->save(['extra' => array_merge($user->getAttr('extra'), $data)]);
         return ['lock' => $lock, 'used' => abs($used), 'total' => $total, 'usable' => $data['balance_usable']];
     }

plugin/think-plugs-payment/src/service/Integral.php

@@ -36,11 +36,11 @@ abstract class Integral
      * @return float
      * @throws \think\admin\Exception
      */
-    public static function ratio(float $integral = 1): float
+    public static function ratio(string $integral = '1'): string
     {
         $cfg = sysdata('plugin.payment.config');
         if (empty($cfg['integral']) || $cfg['integral'] < 1) $cfg['integral'] = 1;
-        return $integral / floatval($cfg['integral']);
+        return bcdiv($integral, strval($cfg['integral']), 6);
     }
 
     /**
@@ -64,8 +64,8 @@ abstract class Integral
         $usable = PluginPaymentIntegral::mk()->where($map)->sum('amount');
         if ($amount < 0 && abs($amount) > $usable) throw new Exception('扣减积分不足！');
 
-        // 积分标准字段
-        $data = ['unid' => $unid, 'code' => $code, 'name' => $name, 'amount' => $amount, 'remark' => $remark];
+            // 积分标准字段
+            $data = ['unid' => $unid, 'code' => $code, 'name' => $name, 'amount' => strval($amount), 'remark' => $remark];
 
         // 统计操作前的金额
         $data['amount_prev'] = $usable;
@@ -140,15 +140,15 @@ abstract class Integral
         }
         // 统计用户积分数据
         $map = ['unid' => $unid, 'cancel' => 0, 'deleted' => 0];
-        $lock = intval(PluginPaymentIntegral::mk()->where($map)->where('unlock', '=', '0')->sum('amount'));
-        $used = intval(PluginPaymentIntegral::mk()->where($map)->where('amount', '<', '0')->sum('amount'));
-        $total = intval(PluginPaymentIntegral::mk()->where($map)->where('amount', '>', '0')->sum('amount'));
+        $lock = PluginPaymentIntegral::mk()->where($map)->where('unlock', '=', '0')->sum('amount');
+        $used = PluginPaymentIntegral::mk()->where($map)->where('amount', '<', '0')->sum('amount');
+        $total = PluginPaymentIntegral::mk()->where($map)->where('amount', '>', '0')->sum('amount');
 
         // 更新积分统计
-        $data['integral_lock'] = $lock;
-        $data['integral_used'] = abs($used);
-        $data['integral_total'] = $total;
-        $data['integral_usable'] = round($total - abs($used), 2);
+        $data['integral_lock'] = strval($lock);
+        $data['integral_used'] = bcmul(strval($used), '-1', 2);
+        $data['integral_total'] = strval($total);
+        $data['integral_usable'] = bcsub($data['integral_total'], $data['integral_used'], 2);
         if ($isUpdate) $user->save(['extra' => array_merge($user->getAttr('extra'), $data)]);
         return ['lock' => $lock, 'used' => abs($used), 'total' => $total, 'usable' => $data['integral_usable']];
     }

plugin/think-plugs-payment/src/service/contract/PaymentUsageTrait.php

@@ -129,20 +129,23 @@ trait PaymentUsageTrait
      * @param string $orderNo
      * @param mixed $payAmount
      * @param mixed $orderAmount
-     * @return float
+     * @return string
      * @throws \think\admin\Exception
      */
-    protected function checkLeaveAmount($orderNo, $payAmount, $orderAmount): float
+    protected function checkLeaveAmount($orderNo, $payAmount, $orderAmount): string
     {
         // 检查未审核的记录
         $map = ['order_no' => $orderNo, 'audit_status' => 1];
         $model = PluginPaymentRecord::mk()->where($map)->findOrEmpty();
         if ($model->isExists()) throw new Exception('凭证待审核！', 0);
         // 检查支付金额是否超出
-        if (round(floatval($payAmount) + Payment::paidAmount($orderNo, true), 2) > floatval($orderAmount)) {
+        $payAmountFloat = floatval($payAmount);
+        $orderAmountFloat = floatval($orderAmount);
+        $paidAmount = Payment::paidAmount($orderNo, true);
+        if (bcadd(strval($payAmountFloat), strval($paidAmount), 2) > $orderAmountFloat) {
             throw new Exception("支付金额溢出！");
         }
-        return floatval($payAmount);
+        return strval($payAmountFloat);
     }
 
     /**
@@ -163,10 +166,12 @@ trait PaymentUsageTrait
         // 检查是否已经支付
         $map = ['order_no' => $orderNo, 'payment_status' => 1];
         $total = Payment::paidAmount($orderNo, true);
-        if ($total >= floatval($orderAmount) && $orderAmount > 0) {
+        $orderAmountFloat = floatval($orderAmount);
+        if ($total >= $orderAmountFloat && $orderAmountFloat > 0) {
             throw new Exception("已经完成支付！", 1);
         }
-        if (round($total + floatval($payAmount), 2) > floatval($orderAmount)) {
+        $payAmountFloat = floatval($payAmount);
+        if (bcadd(strval($total), strval($payAmountFloat), 2) > $orderAmountFloat) {
             throw new Exception('支付大于金额！', 0);
         }
         $map['code'] = $payCode;
@@ -271,7 +276,9 @@ trait PaymentUsageTrait
             $extra['refund_time'] = date('Y-m-d H:i:s');
         }
         // 支付金额大于0，并需要创建退款记录
-        if ($record->getAttr('payment_amount') >= round($record->getAttr('refund_amount') + floatval($amount), 2)) {
+        $refundAmountFloat = floatval($amount);
+        $currentRefundAmount = $record->getAttr('refund_amount');
+        if (bcadd(strval($currentRefundAmount), strval($refundAmountFloat), 2) <= floatval($record->getAttr('payment_amount'))) {
             PluginPaymentRefund::mk()->save(array_merge([
                 'unid' => $record->getAttr('unid'), 'record_code' => $pCode,
                 'usid' => $record->getAttr('usid'), 'refund_amount' => $amount,

plugin/think-plugs-payment/src/service/payment/IntegralPayment.php

@@ -82,7 +82,8 @@ class IntegralPayment implements PaymentInterface
             if (floatval($amount) <= 0) return [1, '无需退款！'];
             $record = static::syncRefund($pcode, $rcode, $amount, $reason);
             $remark = "来自订单 {$record->getAttr('order_no')} 退回积分";
-            $integral = floatval($amount) / floatval($record->getAttr('payment_amount')) * $record->getAttr('used_integral');
+            $integral = bcdiv($amount, $record->getAttr('payment_amount'), 6);
+            $integral = bcmul($integral, $record->getAttr('used_integral'), 2);
             IntegralService::create($record->getAttr('unid'), $rcode, '账号积分退还', floatval($integral), $remark, true);
             return [1, '发起退款成功！'];
         } catch (\Exception $exception) {
@@ -110,7 +111,7 @@ class IntegralPayment implements PaymentInterface
             $unid = $this->withUserUnid($account);
             $integral = IntegralService::recount($unid);
             if ($payAmount > $integral['usable']) throw new Exception('可抵扣的积分不足');
-            $realAmount = $this->checkLeaveAmount($orderNo, sprintf('%01.2f', IntegralService::ratio(floatval($payAmount))), $orderAmount);
+            $realAmount = $this->checkLeaveAmount($orderNo, bcmul($payAmount, '1', 2), $orderAmount);
             $payCode = Payment::withPaymentCode();
             // 创建支付行为
             $this->createAction($orderNo, $orderTitle, $orderAmount, $payCode, strval($realAmount), '', '0.00', $payAmount);

plugin/think-plugs-static/readme.md

@@ -16,6 +16,22 @@
 
 我们建议您在安装或更新插件前，仔细阅读相关文档，确保了解可能的影响，并采取相应的预防措施。
 
+### 业务功能特性
+
+**核心静态资源管理：**
+- **UI 框架集成**: 集成 LayUI 2.8 前端框架，提供丰富的 UI 组件和交互体验
+- **静态资源管理**: 统一管理 CSS、JavaScript、图片等静态资源文件
+- **CDN 加速支持**: 支持 CDN 加速和资源版本控制，提升页面加载速度
+- **自定义扩展**: 保留 `public/static/extra` 目录用于自定义脚本和样式，避免被覆盖
+- **自动更新**: 同步保持 LayUI 框架的最新版本，确保安全性和功能完整性
+
+**技术特性：**
+- **MIT 开源协议**: 遵循 MIT 开源协议，免费可商用
+- **模块化设计**: 静态资源按功能模块组织，便于维护和扩展
+- **性能优化**: 针对前端资源进行压缩和优化，提升页面加载性能
+- **向后兼容**: 保持与现有 ThinkAdmin 版本的兼容性，确保平滑升级
+- **安全防护**: 定期更新依赖库，修复已知安全漏洞
+
 `layui 2.8` 于 2023/04/24 正式发布，此插件会同步保持更新。
 
 ### 安装插件

plugin/think-plugs-wechat-service/readme.md

@@ -71,6 +71,23 @@ var_dump($userInfo);
 * 开放平台配置：`plugin-wechat-service/config/index`
 * 授权微信管理：`plugin-wechat-service/wechat/index`
 
+### 业务功能特性
+
+**核心微信开放平台功能：**
+- **微信开放平台集成**: 提供完整的微信开放平台管理功能，支持公众号和小程序的统一管理
+- **远程接口调用**: 支持 JSON-RPC 远程调用，可与 ThinkPlugsWechat 插件无缝集成
+- **授权管理**: 完整的微信授权管理，支持多公众号和小程序的授权配置
+- **用户管理**: 提供粉丝列表获取、用户信息查询等完整的用户管理接口
+- **接口调度**: 统一的接口调度机制，简化微信开放平台的复杂性
+- **会员专享**: 作为会员尊享插件，提供深度优化的微信开发体验
+
+**技术特性：**
+- **VIP 授权**: 会员专享插件，非授权用户不得用于商业目的
+- **模块化设计**: 各微信功能模块独立封装，便于扩展和维护
+- **远程调用支持**: 支持 JSON-RPC 远程调用，实现插件间的无缝集成
+- **安全防护**: 内置 Token 验证和权限控制，确保接口调用安全
+- **向后兼容**: 保持与现有 ThinkAdmin 版本的兼容性，确保平滑升级
+
 ### 插件数据
 
 本插件涉及数据表有：

plugin/think-plugs-wechat/readme.md

@@ -55,6 +55,26 @@ composer remove zoujingli/think-plugs-wechat
 * 微信支付管理：`wechat/payment.record/index`
 * 微信退款管理：`wechat/payment.refund/index`
 
+### 业务功能特性
+
+**核心微信功能：**
+- **微信接口配置**: 提供完整的微信公众号接口配置管理，支持多公众号管理
+- **微信支付配置**: 集成微信支付功能，支持 JSAPI、Native、APP 等多种支付方式
+- **微信粉丝管理**: 完整的粉丝信息管理，支持标签分组、批量操作等功能
+- **微信图文管理**: 可视化的图文素材编辑和管理，支持多图文组合
+- **微信菜单配置**: 可视化的自定义菜单配置，支持点击、跳转、扫码等菜单类型
+- **回复规则管理**: 灵活的关键词回复规则配置，支持文本、图片、图文等多种回复类型
+- **关注自动回复**: 支持关注时的自动回复配置，提升用户体验
+- **微信支付管理**: 完整的支付记录管理，支持订单查询和状态跟踪
+- **微信退款管理**: 便捷的退款处理功能，支持部分退款和全额退款
+
+**技术特性：**
+- **MIT 开源协议**: 遵循 MIT 开源协议，免费可商用
+- **模块化设计**: 各微信功能模块独立封装，便于扩展和维护
+- **安全防护**: 内置微信消息签名验证、权限控制等安全机制
+- **高性能优化**: 针对微信接口调用进行专门优化，确保响应速度
+- **向后兼容**: 保持与现有 ThinkAdmin 版本的兼容性，确保平滑升级
+
 ### 插件数据库
 
 本插件涉及数据表有：

plugin/think-plugs-wemall/readme.md

@@ -47,9 +47,36 @@ composer require zoujingli/think-plugs-wemall dev-master --optimize-autoloader
 composer remove zoujingli/think-plugs-wemall
 ```
 
+### 业务功能特性
+
+**核心功能模块：**
+- **多级分销体系**: 支持三级分销模式，可配置不同等级的代理返佣规则
+- **灵活返佣机制**: 支持下单奖励、首购奖励、复购奖励、升级奖励、平推返佣等多种返佣类型
+- **会员等级管理**: 基于订单金额和数量的自动等级升级，支持自定义等级规则
+- **代理等级管理**: 团队业绩统计，支持多维度的代理等级升级条件
+- **混合支付支持**: 集成余额支付、积分抵扣、微信支付、支付宝等多种支付方式
+- **商品管理系统**: 完整的商品分类、规格、库存、价格管理
+- **订单全流程管理**: 从下单、支付、发货到售后的完整订单生命周期管理
+- **推广海报管理**: 支持为不同用户等级生成个性化推广海报
+- **团队业绩统计**: 实时统计团队销售业绩和返佣数据
+
+**技术特性：**
+- **高精度金融计算**: 使用 BC Math 高精度计算，避免浮点数精度丢失问题
+- **事件驱动架构**: 通过支付事件、订单事件等实现业务逻辑解耦
+- **数据库约束优化**: 添加完整的外键约束、检查约束和索引优化
+- **并发安全处理**: 支持高并发场景下的余额、积分、库存操作
+- **数据完整性保障**: 通过数据库约束确保业务数据的一致性和有效性
+
 ### 插件数据
 
-本插件涉及数据表有：--
+本插件涉及数据表有：
+- 商城-配置-等级: `plugin_wemall_config_agent`, `plugin_wemall_config_level`
+- 商城-配置-返利: `plugin_wemall_config_rebate`, `plugin_wemall_config_discount`
+- 商城-商品-内容: `plugin_wemall_goods`, `plugin_wemall_goods_item`, `plugin_wemall_goods_stock`
+- 商城-订单-内容: `plugin_wemall_order`, `plugin_wemall_order_item`, `plugin_wemall_order_sender`
+- 商城-用户-关系: `plugin_wemall_user_relation`, `plugin_wemall_user_rebate`, `plugin_wemall_user_transfer`
+- 数据-快递-公司: `plugin_wemall_express_company`, `plugin_wemall_express_template`
+- 数据-意见-反馈: `plugin_wemall_help_feedback`, `plugin_wemall_help_problem`
 
 ### 版权说明
 

plugin/think-plugs-wemall/src/service/UserOrder.php

@@ -263,6 +263,11 @@ abstract class UserOrder
             'amount_integral' => $ptotal['integral'] ?? 0,
         ], true);
 
+        // 检查订单是否已取消或退款
+        if ($order->getAttr('cancel_status') > 0 || $order->getAttr('refund_status') > 0) {
+            return $order->save();
+        }
+        
         // 订单已经支付完成
         if ($order->getAttr('payment_amount') >= $order->getAttr('amount_real')) {
             // 已完成支付，更新订单状态
@@ -304,6 +309,7 @@ abstract class UserOrder
      */
     public static function cancel($order, bool $setRebate = false): string
     {
+        $code = '';
         try { /* 创建用户奖励 */
             $order = UserReward::cancel($order, $code);
         } catch (\Exception $exception) {
@@ -329,6 +335,7 @@ abstract class UserOrder
      */
     public static function payment($order): string
     {
+        $code = '';
         try { /* 创建用户奖励 */
             UserReward::create($order, $code);
         } catch (\Exception $exception) {
@@ -355,6 +362,7 @@ abstract class UserOrder
      */
     public static function confirm($order): string
     {
+        $code = '';
         try { /* 创建用户奖励 */
             UserReward::confirm($order, $code);
         } catch (\Exception $exception) {

plugin/think-plugs-wemall/src/service/UserRebate.php

@@ -142,14 +142,14 @@ abstract class UserRebate
         if (self::$order['puid2'] > 0) {
             $map = ['unid' => self::$order['puid2']];
             self::$rela2 = PluginWemallUserRelation::mk()->where($map)->findOrEmpty()->toArray();
-            if (empty(self::$rela1)) throw new Exception('上二代理不存在');
+            if (empty(self::$rela2)) throw new Exception('上二代理不存在');
         }
 
         // 获取上三级代理数据
         if (self::$order['puid3'] > 0) {
             $map = ['unid' => self::$order['puid3']];
             self::$rela3 = PluginWemallUserRelation::mk()->where($map)->findOrEmpty()->toArray();
-            if (empty(self::$rela1)) throw new Exception('上三代理不存在');
+            if (empty(self::$rela3)) throw new Exception('上三代理不存在');
         }
 
         // 批量查询规则并发放奖励
@@ -196,7 +196,7 @@ abstract class UserRebate
         /** @var PluginWemallUserRebate $item */
         $map = [['status', '=', 0], ['deleted', '=', 0], ['order_no', 'like', "{$order->getAttr('order_no')}%"]];
         foreach (PluginWemallUserRebate::mk()->where($map)->cursor() as $item) {
-            $item->save(['status' => 1, 'remark' => '订单已确认收货！', 'comfirm_time' => date('Y-m-d H:i:s')]);
+            $item->save(['status' => 1, 'remark' => '订单已确认收货！', 'confirm_time' => date('Y-m-d H:i:s')]);
             UserRebate::recount($item->getAttr('unid'));
         }
         return true;
@@ -295,15 +295,17 @@ abstract class UserRebate
         $map = ['hash' => md5("{$config['code']}#{$ono}#{$relation['unid']}#{$config['type']}")];
         if (PluginWemallUserRebate::mk()->where($map)->findOrEmpty()->isExists()) return false;
         // 根据配置计算返利数据
-        $value = floatval($config["p{$layer}_reward_number"] ?: '0.00');
+        $value = $config["p{$layer}_reward_number"] ?: '0.000000';
         if ($config["p{$layer}_reward_type"] == 0) {
-            $val = $value;
+            $val = bcmul($value, '1', 2);
             $name = sprintf('%s，每单 %s 元', $config['name'], $val);
         } elseif ($config["p{$layer}_reward_type"] == 1) {
-            $val = floatval($value * self::$order['rebate_amount'] / 100);
+            $val = bcmul($value, self::$order['rebate_amount'], 2);
+            $val = bcdiv($val, '100', 2);
             $name = sprintf('%s，订单金额 %s%%', $config['name'], $value);
         } elseif ($config["p{$layer}_reward_type"] == 2) {
-            $val = floatval($value * self::$order['amount_profit'] / 100);
+            $val = bcmul($value, self::$order['amount_profit'], 2);
+            $val = bcdiv($val, '100', 2);
             $name = sprintf('%s，分佣金额 %s%%', $config['name'], $value);
         } else {
             return false;
@@ -313,15 +315,15 @@ abstract class UserRebate
     }
 
     /**
-     * 用户首推奖励
+     * 用户首购奖励
      * @param int $layer
      * @param array $relation
      * @return boolean
      */
-    protected static function _frist(int $layer, array $relation): bool
+    protected static function _first(int $layer, array $relation): bool
     {
         // 是否首次购买
-        $orders = PluginWemallUserRebate::mk()->where(['order_unid' => self::$unid])->limit(2)->column('order_no');
+        $orders = PluginWemallUserRebate::mk()->where(['order_unid' => self::$unid, 'status' => 1])->limit(2)->column('order_no');
         if (count($orders) > 1 || (count($orders) === 1 && !in_array(self::$order['order_no'], $orders))) return false;
         // 发放用户首推奖励
         return self::_order($layer, $relation);
@@ -333,10 +335,10 @@ abstract class UserRebate
      * @param array $relation
      * @return boolean
      */
-    protected function _repeat(int $layer, array $relation): bool
+    protected static function _repeat(int $layer, array $relation): bool
     {
         // 是否复购购买
-        $orders = PluginWemallUserRebate::mk()->where(['order_unid' => self::$unid])->limit(2)->column('order_no');
+        $orders = PluginWemallUserRebate::mk()->where(['order_unid' => self::$unid, 'status' => 1])->limit(2)->column('order_no');
         if (count($orders) < 1 || (count($orders) === 1 && in_array(self::$order['order_no'], $orders))) return false;
         // 发放用户复购奖励
         return self::_order($layer, $relation);
@@ -345,11 +347,10 @@ abstract class UserRebate
     /**
      * 用户升级奖励发放
      * @param int $layer
-     * @param array $config
      * @param array $relation
      * @return boolean
      */
-    private static function _upgrade(int $layer, array $relation, array $config): bool
+    private static function _upgrade(int $layer, array $relation): bool
     {
         if (empty(self::$rela1)) return false;
         if (empty(self::$user['extra']['level_order']) || self::$user['extra']['level_order'] !== self::$order['order_no']) return false;
@@ -377,7 +378,7 @@ abstract class UserRebate
      * @param integer $layer 发放序号
      * @return boolean
      */
-    private static function wRebate(int $unid, array $map, string $name, float $amount, int $layer = 0): bool
+    private static function wRebate(int $unid, array $map, string $name, string $amount, int $layer = 0): bool
     {
         $rebate = PluginWemallUserRebate::mk()->where($map)->findOrEmpty();
         if ($rebate->isExists()) return false;

plugin/think-plugs-wemall/stc/database/20241010000008_fix_wemall_constraints.php

@@ -0,0 +1,126 @@
+<?php
+
+use think\admin\extend\PhinxExtend;
+use think\migration\Migrator;
+
+@set_time_limit(0);
+@ini_set('memory_limit', -1);
+
+class FixWemallConstraints20241010 extends Migrator
+{
+
+    /**
+     * 获取脚本名称
+     * @return string
+     */
+    public function getName(): string
+    {
+        return 'FixWemallConstraints';
+    }
+
+    /**
+     * 修复数据库约束
+     */
+    public function change()
+    {
+        // 为返佣记录表添加外键约束和业务字段
+        $this->_fix_plugin_wemall_user_rebate();
+        
+        // 为余额/积分表添加来源字段
+        $this->_fix_plugin_payment_balance_integral();
+        
+        // 为用户关系表添加索引优化
+        $this->_fix_plugin_wemall_user_relation();
+        
+        // 为订单表添加检查约束
+        $this->_fix_plugin_wemall_order();
+    }
+
+    /**
+     * 修复返佣记录表
+     */
+    private function _fix_plugin_wemall_user_rebate()
+    {
+        $table = $this->table('plugin_wemall_user_rebate');
+        
+        // 添加订单商品项ID字段（用于精确追踪返佣）
+        if (!$this->hasColumn('plugin_wemall_user_rebate', 'order_item_id')) {
+            $table->addColumn('order_item_id', 'biginteger', ['limit' => 20, 'default' => 0, 'null' => true, 'comment' => '订单商品项ID'])
+                  ->update();
+        }
+        
+        // 添加返佣规则ID字段（用于追溯规则版本）
+        if (!$this->hasColumn('plugin_wemall_user_rebate', 'rebate_rule_id')) {
+            $table->addColumn('rebate_rule_id', 'biginteger', ['limit' => 20, 'default' => 0, 'null' => true, 'comment' => '返佣规则ID'])
+                  ->update();
+        }
+        
+        // 添加金额非负约束
+        $this->execute("ALTER TABLE `plugin_wemall_user_rebate` MODIFY `amount` DECIMAL(20,2) NOT NULL DEFAULT '0.00' CHECK (amount >= 0)");
+    }
+
+    /**
+     * 修复余额/积分表
+     */
+    private function _fix_plugin_payment_balance_integral()
+    {
+        // 修复余额表
+        $table = $this->table('plugin_payment_balance');
+        if (!$this->hasColumn('plugin_payment_balance', 'source_type')) {
+            $table->addColumn('source_type', 'string', ['limit' => 50, 'default' => '', 'null' => true, 'comment' => '资金来源类型'])
+                  ->addColumn('source_id', 'string', ['limit' => 50, 'default' => '', 'null' => true, 'comment' => '资金来源ID'])
+                  ->update();
+        }
+        
+        // 修复积分表
+        $table = $this->table('plugin_payment_integral');
+        if (!$this->hasColumn('plugin_payment_integral', 'source_type')) {
+            $table->addColumn('source_type', 'string', ['limit' => 50, 'default' => '', 'null' => true, 'comment' => '积分来源类型'])
+                  ->addColumn('source_id', 'string', ['limit' => 50, 'default' => '', 'null' => true, 'comment' => '积分来源ID'])
+                  ->update();
+        }
+        
+        // 添加金额非负约束
+        $this->execute("ALTER TABLE `plugin_payment_balance` MODIFY `amount` DECIMAL(20,2) NOT NULL DEFAULT '0.00'");
+        $this->execute("ALTER TABLE `plugin_payment_integral` MODIFY `amount` DECIMAL(20,2) NOT NULL DEFAULT '0.00'");
+    }
+
+    /**
+     * 修复用户关系表索引
+     */
+    private function _fix_plugin_wemall_user_relation()
+    {
+        // 为path字段添加前缀索引（优化LIKE查询性能）
+        $this->execute("ALTER TABLE `plugin_wemall_user_relation` ADD INDEX `idx_path_prefix` (`path`(20))");
+        
+        // 为代理层级字段添加索引
+        $this->execute("ALTER TABLE `plugin_wemall_user_relation` ADD INDEX `idx_puid1` (`puid1`)");
+        $this->execute("ALTER TABLE `plugin_wemall_user_relation` ADD INDEX `idx_puid2` (`puid2`)");
+        $this->execute("ALTER TABLE `plugin_wemall_user_relation` ADD INDEX `idx_puid3` (`puid3`)");
+    }
+
+    /**
+     * 修复订单表约束
+     */
+    private function _fix_plugin_wemall_order()
+    {
+        // 添加金额字段的非负约束
+        $amount_fields = [
+            'amount_cost', 'amount_real', 'amount_total', 'amount_goods', 
+            'amount_profit', 'amount_reduct', 'amount_balance', 'amount_integral',
+            'amount_payment', 'amount_express', 'amount_discount', 'coupon_amount',
+            'allow_balance', 'allow_integral', 'ratio_integral', 'rebate_amount',
+            'reward_balance', 'reward_integral', 'payment_amount'
+        ];
+        
+        foreach ($amount_fields as $field) {
+            $this->execute("ALTER TABLE `plugin_wemall_order` MODIFY `{$field}` DECIMAL(20,2) NOT NULL DEFAULT '0.00' CHECK ({$field} >= 0)");
+        }
+        
+        // 添加状态字段的枚举约束
+        $this->execute("ALTER TABLE `plugin_wemall_order` MODIFY `status` TINYINT NOT NULL DEFAULT 1 CHECK (status BETWEEN 0 AND 7)");
+        $this->execute("ALTER TABLE `plugin_wemall_order` MODIFY `refund_status` TINYINT NOT NULL DEFAULT 0 CHECK (refund_status BETWEEN 0 AND 7)");
+        $this->execute("ALTER TABLE `plugin_wemall_order` MODIFY `payment_status` TINYINT NOT NULL DEFAULT 0 CHECK (payment_status BETWEEN 0 AND 2)");
+        $this->execute("ALTER TABLE `plugin_wemall_order` MODIFY `delivery_type` TINYINT NOT NULL DEFAULT 0 CHECK (delivery_type BETWEEN 0 AND 1)");
+    }
+}

plugin/think-plugs-worker/readme.md

@@ -7,6 +7,24 @@
 [![PHP Version](https://thinkadmin.top/static/icon/php-7.1.svg)](https://thinkadmin.top)
 [![License](https://poser.pugx.org/zoujingli/think-plugs-worker/license)](https://gitee.com/zoujingli/think-plugs-worker/blob/master/license)
 
+### 业务功能特性
+
+**核心异步任务处理：**
+- **HTTP 服务支持**: 基于 Workerman 4.x 提供高性能 HTTP 服务，无需 Nginx/Apache 配置，访问速度显著提升
+- **多协议支持**: 支持 WebSocket、TCP、UDP 等多种通信协议，满足不同应用场景需求
+- **Gateway 模式**: 支持 Gateway 分布式架构，适用于高并发实时通信场景
+- **自定义服务**: 提供灵活的自定义服务配置，支持 Text、WebSocket、Gateway、Register、Business 等多种服务类型
+- **异步任务队列**: 内置高效的异步任务处理机制，响应延时低于 0.5 秒
+- **进程管理**: 完善的进程启动、停止、重载、状态监控等管理功能
+- **跨平台支持**: 同时支持 Windows 和 Linux 平台，提供统一的操作接口
+
+**技术特性：**
+- **Apache2 开源协议**: 遵循 Apache2 开源协议，免费提供使用
+- **高性能架构**: 基于 Workerman 事件驱动架构，单机可支撑数万并发连接
+- **模块化设计**: 各服务类型独立配置，便于扩展和维护
+- **向后兼容**: 保持与现有 ThinkAdmin 版本的兼容性，确保平滑升级
+- **文档完善**: 提供完整的配置示例和使用文档，快速上手
+
 基于 **Workerman 4.x** 且支持多种通信协议的基础插件。
 
 **提示：** 默认支持以 HTTP 方式直接启动 ThinkAdmin 项目，无需配置 Nginx 或 Apache 环境，访问速度提升 N 倍。

plugin/think-plugs-wuma/readme.md

@@ -9,6 +9,24 @@
 
 **注意：** 该插件测试版有数据库结构变化，未生成升级补丁，每次更新需要全新安装！
 
+### 业务功能特性
+
+**核心一物一码功能：**
+- **商品溯源管理**: 提供完整的商品溯源和防伪验证功能，支持一物一码追踪
+- **物码标签管理**: 完整的物码标签生成、打印、管理和验证功能
+- **防伪验证**: 支持消费者扫码验证商品真伪，提升品牌信任度
+- **数据统计分析**: 提供扫码数据统计和分析，了解消费者行为
+- **批量操作**: 支持物码的批量生成、导入、导出等操作
+- **权限控制**: 完善的权限管理，确保数据安全
+- **收费授权**: 作为收费授权插件，提供专业的技术支持和功能更新
+
+**技术特性：**
+- **收费授权**: 需要联系作者获取授权，未授权不可商用
+- **模块化设计**: 功能模块独立封装，便于维护和扩展
+- **安全防护**: 内置数据加密和权限验证，确保系统安全
+- **向后兼容**: 保持与现有 ThinkAdmin 版本的兼容性，确保平滑升级
+- **专业支持**: 提供专业的技术支持和定期功能更新
+
 物码标签管理系统，此插件为收费授权插件，请联系作者获取授权，未授权不可商用。
 
 ### 加入我们

readme.md

@@ -13,6 +13,65 @@
 
 **ThinkAdmin** v6 是对 v1 至 v5 的重构之作，结合 **ThinkPHP** 6 和 8 的设计思路，彻底改造系统，保留原生生态支持。我们精简了非必需组件，构建了自定义存储层、服务层和高效队列机制，并新增用户友好的指令，提升操作体验。经过严格测试，v6.1 版本展现出卓越的稳定性，系统和微信模块已达到高稳定水平。
 
+### 核心组件与插件体系
+
+**ThinkLibrary 核心组件**
+- **标准控制器基类**: 提供完整的 CRUD 操作封装，包括分页、表单、验证、队列等通用功能
+- **基础模型类**: 实现魔术方法和静态助手调用，支持操作日志记录和数据一致性保障
+- **自定义服务基类**: 提供依赖注入和实例化机制，支持服务的统一管理和扩展
+- **全局函数库**: 包含数据处理、系统配置、HTTP 请求、JWT 认证等实用函数
+- **PSR-12 标准**: 严格遵循 PHP-FIG 编码规范，确保代码质量和可维护性
+
+**ThinkPlugsAccount 多端账号插件**
+- **三层账号模型**: 临时用户(usid) ↔ 绑定手机(bind) ↔ 正式用户(unid) 的完整账号生命周期
+- **多端统一账号**: 支持微信服务号、微信小程序、APP、网页等多终端统一账号体系
+- **JWT无状态认证**: 基于 JWT Token 的无状态认证机制，支持跨域和分布式部署
+- **动态通道注册**: 支持运行时动态注册新的登录通道类型，灵活扩展登录方式
+- **高并发安全**: 支持高并发场景下的账号创建和绑定操作，确保数据一致性
+
+**ThinkPlugsPayment 多端支付插件**
+- **多端支付支持**: 支持微信服务号、微信小程序、APP、网页等多终端支付场景
+- **混合支付模式**: 支持余额、积分、微信、支付宝等多种支付方式组合使用
+- **高精度金融计算**: 使用 BC Math 高精度数学函数，确保金融计算的准确性
+- **支付事件驱动**: 通过支付事件（审核、完成、取消、确认）实现业务逻辑解耦
+- **退款管理**: 支持部分退款和全额退款，自动处理余额、积分的退回操作
+
+**ThinkPlugsWemall 微商城插件**
+- **多级分销体系**: 支持三级分销模式，可配置不同等级的代理返佣规则
+- **灵活返佣机制**: 支持下单奖励、首购奖励、复购奖励、升级奖励、平推返佣等多种返佣类型
+- **会员等级管理**: 基于订单金额和数量的自动等级升级，支持自定义等级规则
+- **代理等级管理**: 团队业绩统计，支持多维度的代理等级升级条件
+- **商品管理系统**: 完整的商品分类、规格、库存、价格管理
+- **订单全流程管理**: 从下单、支付、发货到售后的完整订单生命周期管理
+
+**其他插件**
+- **ThinkPlugsCenter**: 插件服务管理中心，提供插件注册、配置和管理功能
+- **ThinkPlugsHelper**: 系统辅助工具，包含数据库备份、索引优化等功能
+- **ThinkPlugsStatic**: 静态资源管理，支持 CDN 加速和资源版本控制
+- **ThinkPlugsWechat**: 微信生态集成，支持公众号、小程序、支付等微信功能
+- **ThinkPlugsWorker**: 异步任务处理，支持延时执行和循环任务
+- **ThinkPlugsWuma**: 一物一码系统，支持商品溯源和防伪验证（收费插件）
+
+### 技术特性
+
+**高性能架构**
+- **异步任务处理**: 内置高效队列机制，响应延时低于 0.5 秒
+- **缓存优化**: 集成 Redis 缓存，提升系统性能和响应速度
+- **数据库约束**: 添加完整的外键约束、检查约束和索引优化
+- **并发安全控制**: 支持高并发场景下的余额、积分、库存操作
+
+**安全特性**
+- **CSRF 令牌验证**: 内置表单安全验证，防止跨站请求伪造攻击
+- **数据完整性保障**: 通过数据库约束确保业务数据的一致性和有效性
+- **异常处理完善**: 完善的异常捕获和日志记录机制，便于问题排查
+- **权限控制**: 完整的系统权限管理，确保数据安全
+
+**开发体验**
+- **模块化设计**: 各功能模块独立封装，便于扩展和维护
+- **向后兼容**: 保持 API 稳定性，确保平滑升级
+- **文档完善**: 提供完整的接口文档和技术文档
+- **调试友好**: 内置调试工具和日志记录，便于开发和问题排查
+
 我们持续推出新模块和辅助功能，期待后续更新！使用 **ThinkAdmin** 需要具备一定开发技能，包括 ThinkPHP、jQuery、LayUI 和 RequireJs。后台 UI 基于最新 LayUI 前端框架，支持插件加载和管理。
 
 请勿修改 app/admin 和 app/wechat 目录，以确保未来功能和安全更新通过 Composer 管理。ThinkLibrary 作为核心组件，封装了常用操作，兼容原有 ThinkPHP 生态，降低编码复杂性。