feat(api): 添加幸福币记录功能

- 新增 xfb_list 接口用于获取用户幸福币记录
- 实现分页查询功能
- 添加收支统计功能
- 在路由文件中注册新的 API 端点
- 添加完整的注释文档

app/controller/api/user/User.php

@@ -616,6 +616,28 @@ class User extends BaseController
     }
 
 
+    /**
+     * @return mixed
+     * @throws \think\db\exception\DataNotFoundException
+     * @throws \think\db\exception\DbException
+     * @throws \think\db\exception\ModelNotFoundException
+     * @author 史晨
+     * @date 2026/4/9 14:16
+     * 幸福币列表
+     */
+    public function xfb_list()
+    {
+        $type = $this->request->param('type');
+        [$page, $limit] = $this->getPage();
+        $uid = $this->request->uid();
+        $where['uid'] = $uid;
+        $list = DB::name('user_sign_xfb')->where($where)->where('type', $type)->page($page, $limit)->order("id desc")->select();
+        $obtain = Db::name('user_sign_xfb')->where($where)->where('type', 1)->sum('number');
+        $consume = Db::name('user_sign_xfb')->where($where)->where('type', 2)->sum('number');
+        return app("json")->success(['list' => $list, 'obtain' => $obtain, 'consume' => $consume]);
+    }
+
+
     public function spread_info_yhc()
     {
         log::info("============ddddddddd");

route/api.php

@@ -356,6 +356,7 @@ Route::group('api/', function () {
             Route::get('vr_name','User/vr_name');//VR名称
             Route::post('un_bind', 'User/unBindVxOrAli');//解绑微信或支付宝
 
+            Route::get('xfb_list','User/xfb_list');//购物金记录
         })->prefix('api.user.');
 
         // 共富区