diff --git a/app/Admin/Actions/Post/ActiveUserAction.php b/app/Admin/Actions/Post/ActiveUserAction.php
index 9ac9534..f6cad55 100644
--- a/app/Admin/Actions/Post/ActiveUserAction.php
+++ b/app/Admin/Actions/Post/ActiveUserAction.php
@@ -8,15 +8,24 @@ use Illuminate\Database\Eloquent\Model;
class ActiveUserAction extends RowAction
{
+ // 动作名称，显示在界面上的按钮文本
public $name = '激活';
+ /**
+ * 处理激活用户的逻辑
+ *
+ * @param User $model 被激活的用户模型
+ * @return \Encore\Admin\Actions\Response 返回操作结果的响应
+ */
public function handle(User $model)
{
- // $model ...
+ // 将用户的激活状态设置为 1（激活）
$model->is_active = 1;
+
+ // 保存用户模型的更改
$model->save();
+ // 返回成功响应并刷新页面
return $this->response()->success('操作成功.')->refresh();
}
-
}
diff --git a/app/Admin/Actions/Post/DividerAction.php b/app/Admin/Actions/Post/DividerAction.php
index 054f834..ebef964 100644
--- a/app/Admin/Actions/Post/DividerAction.php
+++ b/app/Admin/Actions/Post/DividerAction.php
@@ -7,22 +7,32 @@ use Illuminate\Database\Eloquent\Model;
class DividerAction extends RowAction
{
+ // 动作名称，显示在界面上的按钮文本
public $name = '分隔线';
+ /**
+ * 处理分隔线的逻辑
+ *
+ * @param Model $model 当前行的模型实例
+ * @return \Encore\Admin\Actions\Response 返回操作结果的响应
+ */
public function handle(Model $model)
{
- // $model ...
+ // 此处可以添加处理逻辑，当前实现中不执行任何操作
+ // 例如，可以记录日志或执行其他操作
+ // 返回成功响应并刷新页面
return $this->response()->success('Success message.')->refresh();
}
/**
- * Render row action.
+ * 渲染行操作的HTML
*
- * @return string
+ * @return string 返回HTML字符串，用于显示分隔线
*/
public function render()
{
+ // 返回一个包含分隔线的列表项HTML
return '';
}
}
diff --git a/app/Admin/Actions/Post/ForceDeleteProductAction.php b/app/Admin/Actions/Post/ForceDeleteProductAction.php
index 259b8cf..5f7bd66 100644
--- a/app/Admin/Actions/Post/ForceDeleteProductAction.php
+++ b/app/Admin/Actions/Post/ForceDeleteProductAction.php
@@ -8,23 +8,38 @@ use Illuminate\Http\Request;
class ForceDeleteProductAction extends RowAction
{
+ // 动作名称，显示在界面上的按钮文本
public $name = '删除';
-
+ /**
+ * 处理强制删除产品的逻辑
+ *
+ * @param Product $product 被删除的产品模型
+ * @return \Encore\Admin\Actions\Response 返回操作结果的响应
+ */
public function handle(Product $product)
{
+ // 调用模型的 forceDelete 方法，永久删除产品
$product->forceDelete();
+ // 返回成功响应并刷新页面
return $this->response()->success('操作成功.')->refresh();
}
-
+ /**
+ * 从请求中检索产品模型
+ *
+ * @param Request $request 当前请求实例
+ * @return Product|false 返回找到的产品模型或 false
+ */
public function retrieveModel(Request $request)
{
+ // 从请求中获取 '_key' 参数
if (!$key = $request->get('_key')) {
- return false;
+ return false; // 如果没有找到 '_key'，返回 false
}
+ // 使用 withTrashed 方法查询包括已删除的产品，并根据找到的键查找产品
return Product::query()->withTrashed()->findOrFail($key);
}
}
diff --git a/app/Admin/Actions/Post/OrderReceivedAction.php b/app/Admin/Actions/Post/OrderReceivedAction.php
index 72a07e1..766ec73 100644
--- a/app/Admin/Actions/Post/OrderReceivedAction.php
+++ b/app/Admin/Actions/Post/OrderReceivedAction.php
@@ -5,30 +5,39 @@ namespace App\Admin\Actions\Post;
use App\Enums\OrderShipStatusEnum;
use App\Enums\OrderStatusEnum;
use App\Models\Order;
-use App\Models\User;
use Encore\Admin\Actions\RowAction;
-use Illuminate\Database\Eloquent\Model;
-use Illuminate\Http\Request;
class OrderReceivedAction extends RowAction
{
+ // 动作名称，显示在界面上的按钮文本
public $name = '确认收货';
+ /**
+ * 处理确认收货的逻辑
+ *
+ * @param Order $order 当前订单模型实例
+ * @return \Encore\Admin\Actions\Response 返回操作结果的响应
+ */
public function handle(Order $order)
{
+ // 检查订单状态是否为已付款
if ($order->status != OrderStatusEnum::PAID) {
-
+ // 如果未付款，返回错误信息
return back()->withErrors('订单未付款', 'error');
}
+ // 检查订单的发货状态是否为已发货
if ($order->ship_status != OrderShipStatusEnum::DELIVERED) {
-
+ // 如果未发货，返回错误信息
return back()->withErrors('订单未发货', 'error');
}
+ // 更新订单的发货状态为已收货
$order->ship_status = OrderShipStatusEnum::RECEIVED;
+ // 保存订单的更改
$order->save();
+ // 返回成功响应并刷新页面
return $this->response()->success('确认收货成功.')->refresh();
}
}
diff --git a/app/Admin/Actions/Post/OrderRefundAction.php b/app/Admin/Actions/Post/OrderRefundAction.php
index 8d43a10..aaaca67 100644
--- a/app/Admin/Actions/Post/OrderRefundAction.php
+++ b/app/Admin/Actions/Post/OrderRefundAction.php
@@ -5,55 +5,69 @@ namespace App\Admin\Actions\Post;
use App\Enums\OrderShipStatusEnum;
use App\Enums\OrderStatusEnum;
use App\Models\Order;
-use App\Models\User;
use Encore\Admin\Actions\RowAction;
-use Illuminate\Database\Eloquent\Model;
use Illuminate\Http\Request;
use Yansongda\Pay\Pay;
class OrderRefundAction extends RowAction
{
+ // 动作名称，显示在界面上的按钮文本
public $name = '退款';
-
+ /**
+ * 处理订单退款的逻辑
+ *
+ * @param Order $order 当前订单模型实例
+ * @param Request $request 当前请求实例
+ * @return \Encore\Admin\Actions\Response 返回操作结果的响应
+ */
public function handle(Order $order, Request $request)
{
- // 订单必须申请支付了，才可才可以退款
+ // 检查订单状态是否为申请退款
if ($order->status != OrderStatusEnum::APPLY_REFUND) {
+ // 如果当前状态不允许退款，返回错误信息
return $this->response()->error('订单当前状态禁止退款');
}
+ // 创建支付宝支付实例
$pay = Pay::alipay(config('pay.ali'));
- // 退款数据
+ // 准备退款数据
$refundData = [
- 'out_trade_no' => $order->no,
- 'trade_no' => $order->pay_no,
- 'refund_amount' => $order->pay_amount,
- 'refund_reason' => '正常退款',
+ 'out_trade_no' => $order->no, // 订单号
+ 'trade_no' => $order->pay_no, // 支付交易号
+ 'refund_amount' => $order->pay_amount, // 退款金额
+ 'refund_reason' => '正常退款', // 退款原因
];
try {
-
- // 将订单状态改为退款
+ // 发起退款请求
$response = $pay->refund($refundData);
- $order->pay_refund_fee = $response->get('refund_fee');
- $order->pay_trade_no = $response->get('trade_no');
- $order->status = OrderStatusEnum::REFUND;
- $order->save();
- } catch (\Exception $e) {
+ // 更新订单的退款信息
+ $order->pay_refund_fee = $response->get('refund_fee'); // 设置退款金额
+ $order->pay_trade_no = $response->get('trade_no'); // 设置退款交易号
+ $order->status = OrderStatusEnum::REFUND; // 更新订单状态为退款
+ $order->save(); // 保存订单的更改
- // 调用异常的处理
- // abort(500, $e->getMessage());
- return $this->response()->error('服务器异常，请稍后再试');
+ } catch (\Exception $e) {
+ // 处理异常情况
+ // abort(500, $e->getMessage()); // 可选：抛出异常
+ return $this->response()->error('服务器异常，请稍后再试'); // 返回错误信息
}
+ // 返回成功响应并刷新页面
return $this->response()->success('退款成功.')->refresh();
}
+ /**
+ * 显示退款确认对话框
+ *
+ * @return void
+ */
public function dialog()
{
+ // 确认退款操作
$this->confirm('退款会直接把钱退回到支付账户，是否继续');
}
}
diff --git a/app/Admin/Actions/Post/OrderShipAction.php b/app/Admin/Actions/Post/OrderShipAction.php
index db820af..b8ae921 100644
--- a/app/Admin/Actions/Post/OrderShipAction.php
+++ b/app/Admin/Actions/Post/OrderShipAction.php
@@ -5,40 +5,59 @@ namespace App\Admin\Actions\Post;
use App\Enums\OrderShipStatusEnum;
use App\Enums\OrderStatusEnum;
use App\Models\Order;
-use App\Models\User;
use Encore\Admin\Actions\RowAction;
-use Illuminate\Database\Eloquent\Model;
use Illuminate\Http\Request;
class OrderShipAction extends RowAction
{
+ // 动作名称，显示在界面上的按钮文本
public $name = '发货';
+ /**
+ * 处理订单发货的逻辑
+ *
+ * @param Order $order 当前订单模型实例
+ * @param Request $request 当前请求实例
+ * @return \Encore\Admin\Actions\Response 返回操作结果的响应
+ */
public function handle(Order $order, Request $request)
{
+ // 检查订单状态是否为已付款
if ($order->status != OrderStatusEnum::PAID) {
-
+ // 如果未付款，返回错误信息
return $this->response()->error('订单未付款');
}
- $company = $request->input('company');
- $no = $request->input('no');
- if (empty($company) || empty($no)) {
+ // 获取物流公司和物流单号
+ $company = $request->input('company'); // 物流公司
+ $no = $request->input('no'); // 物流单号
+ // 检查物流公司和物流单号是否为空
+ if (empty($company) || empty($no)) {
+ // 如果有必填项为空，返回错误信息
return $this->response()->error('必填项不能为空');
}
- $order->ship_status = OrderShipStatusEnum::DELIVERED;
- $order->express_company = $company;
- $order->express_no = $no;
- $order->save();
+ // 更新订单的发货状态和物流信息
+ $order->ship_status = OrderShipStatusEnum::DELIVERED; // 设置发货状态为已发货
+ $order->express_company = $company; // 设置物流公司
+ $order->express_no = $no; // 设置物流单号
+ $order->save(); // 保存订单的更改
+ // 返回成功响应并刷新页面
return $this->response()->success('发货成功.')->refresh();
}
+ /**
+ * 定义发货表单
+ *
+ * @return void
+ */
public function form()
{
+ // 定义物流公司输入框，设置为必填项
$this->text('company', '物流公司')->required();
+ // 定义物流单号输入框，设置为必填项
$this->text('no', '物流单号')->required();
}
}
diff --git a/app/Admin/Actions/Post/ProductStatusAction.php b/app/Admin/Actions/Post/ProductStatusAction.php
index b739169..d823022 100644
--- a/app/Admin/Actions/Post/ProductStatusAction.php
+++ b/app/Admin/Actions/Post/ProductStatusAction.php
@@ -8,39 +8,57 @@ use Illuminate\Http\Request;
class ProductStatusAction extends RowAction
{
+ // 动作名称，显示在界面上的按钮文本
public $name = '';
+ /**
+ * 设置动作名称
+ *
+ * @param string $name 动作名称
+ * @return $this 返回当前实例，以便链式调用
+ */
public function setName($name)
{
- $this->name = $name;
+ $this->name = $name; // 设置动作名称
- return $this;
+ return $this; // 返回当前实例
}
+ /**
+ * 处理商品状态的逻辑
+ *
+ * @param Product $product 当前商品模型实例
+ * @return \Encore\Admin\Actions\Response 返回操作结果的响应
+ */
public function handle(Product $product)
{
- // $model ...
- // 如果商品已经下架
+ // 检查商品是否已下架
if ($product->trashed()) {
-
- // 重新上架
+ // 如果商品已下架，则重新上架
$product->restore();
} else {
-
+ // 如果商品未下架，则进行下架操作
$product->delete();
}
-
+ // 返回成功响应并刷新页面
return $this->response()->success('操作成功.')->refresh();
}
-
+ /**
+ * 从请求中检索商品模型
+ *
+ * @param Request $request 当前请求实例
+ * @return Product|false 返回找到的商品模型实例，或返回 false
+ */
public function retrieveModel(Request $request)
{
+ // 从请求中获取商品的唯一键
if (!$key = $request->get('_key')) {
- return false;
+ return false; // 如果没有提供键，则返回 false
}
+ // 查找并返回商品模型，包括已删除的商品
return Product::query()->withTrashed()->findOrFail($key);
}
}
diff --git a/app/Admin/Controllers/AdminController.php b/app/Admin/Controllers/AdminController.php
index 872da8b..dd1c026 100644
--- a/app/Admin/Controllers/AdminController.php
+++ b/app/Admin/Controllers/AdminController.php
@@ -14,105 +14,133 @@ use Illuminate\Support\Facades\Validator;
class AdminController extends BaseAuthController
{
- // 覆盖默认的
+ /**
+ * 显示管理员列表页面
+ *
+ * @param Content $content 内容区域
+ * @return Content 返回构建好的内容
+ */
public function index(Content $content)
{
return $content
- ->header(trans('admin.administrator'))
- ->description(trans('admin.list'))
- ->body($this->adminGrid()->render());
+ ->header(trans('admin.administrator')) // 设置页面标题
+ ->description(trans('admin.list')) // 设置页面描述
+ ->body($this->adminGrid()->render()); // 渲染管理员网格
}
+ /**
+ * 创建管理员网格
+ *
+ * @return Grid 返回管理员网格实例
+ */
protected function adminGrid()
{
+ // 获取用户模型
$userModel = config('admin.database.users_model');
+ // 创建新的网格实例
$grid = new Grid(new $userModel());
- $grid->column('id', 'ID')->sortable();
- $grid->column('username', trans('admin.username'));
- $grid->column('name', trans('admin.name'));
- $grid->column('login_ip', '登录ip');
- $grid->roles(trans('admin.roles'))->pluck('name')->label();
- $grid->column('created_at', trans('admin.created_at'));
- $grid->column('updated_at', trans('admin.updated_at'));
+ // 定义网格的列
+ $grid->column('id', 'ID')->sortable(); // ID 列，支持排序
+ $grid->column('username', trans('admin.username')); // 用户名列
+ $grid->column('name', trans('admin.name')); // 姓名列
+ $grid->column('login_ip', '登录ip'); // 登录 IP 列
+ $grid->roles(trans('admin.roles'))->pluck('name')->label(); // 角色列，显示角色名称
+ $grid->column('created_at', trans('admin.created_at')); // 创建时间列
+ $grid->column('updated_at', trans('admin.updated_at')); // 更新时间列
+ // 自定义操作按钮
$grid->actions(function (Grid\Displayers\DropdownActions $actions) {
+ // 禁用 ID 为 1 的管理员的删除操作
if ($actions->getKey() == 1) {
$actions->disableDelete();
}
});
-
+ // 自定义工具栏
$grid->tools(function (Grid\Tools $tools) {
$tools->batch(function (Grid\Tools\BatchActions $actions) {
+ // 禁用批量删除操作
$actions->disableDelete();
});
});
- return $grid;
+ return $grid; // 返回创建的网格
}
-
+ /**
+ * 显示操作日志页面
+ *
+ * @param Content $content 内容区域
+ * @return Content 返回构建好的内容
+ */
public function indexLogs(Content $content)
{
return $content
- ->header(trans('admin.operation_log'))
- ->description(trans('admin.list'))
- ->body($this->logGrid());
+ ->header(trans('admin.operation_log')) // 设置页面标题
+ ->description(trans('admin.list')) // 设置页面描述
+ ->body($this->logGrid()); // 渲染操作日志网格
}
/**
- * @return Grid
+ * 创建操作日志网格
+ *
+ * @return Grid 返回操作日志网格实例
*/
protected function logGrid()
{
+ // 创建新的操作日志网格实例
$grid = new Grid(new OperationLog());
+ // 按照 ID 降序排列
$grid->model()->orderBy('id', 'DESC');
- $grid->column('id', 'ID')->sortable();
- $grid->column('user.name', '用户');
+ // 定义网格的列
+ $grid->column('id', 'ID')->sortable(); // ID 列，支持排序
+ $grid->column('user.name', '用户'); // 用户列，显示用户名
$grid->column('method', '方法')->display(function ($method) {
+ // 根据方法类型设置颜色
$color = array_get(OperationLog::$methodColors, $method, 'grey');
-
- return "$method";
+ return "$method"; // 返回带颜色的标签
});
- $grid->column('path', '路径')->label('info');
- $grid->column('ip', '地址')->label('primary');
+ $grid->column('path', '路径')->label('info'); // 路径列
+ $grid->column('ip', '地址')->label('primary'); // IP 地址列
$grid->column('description', '描述')->limit(20)->modal(function ($model) {
-
+ // 描述列，点击可弹出详细信息
return new Box('详情', $model->description ?: ' ');
});
$grid->column('input', '输入数据')->limit(20)->expand(function ($model) {
-
+ // 输入数据列，点击可展开显示详细信息
$input = json_decode($model->input, true);
$input = array_except($input, ['_pjax', '_token', '_method', '_previous_']);
$codes = empty($input) ?
'{}' :
- ''.json_encode($input, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE).'
';
-
- return new Box('详情', $codes);
+ '' . json_encode($input, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) . '
';
+ return new Box('详情', $codes); // 返回输入数据的详细信息
});
- $grid->column('created_at', trans('admin.created_at'));
+ $grid->column('created_at', trans('admin.created_at')); // 创建时间列
+ // 自定义操作按钮
$grid->actions(function (Grid\Displayers\Actions $actions) {
- $actions->disableEdit();
- $actions->disableView();
+ $actions->disableEdit(); // 禁用编辑操作
+ $actions->disableView(); // 禁用查看操作
});
- $grid->disableCreateButton();
+ $grid->disableCreateButton(); // 禁用创建按钮
+ // 自定义过滤器
$grid->filter(function (Grid\Filter $filter) {
$userModel = config('admin.database.users_model');
- $filter->equal('user_id', 'User')->select($userModel::all()->pluck('name', 'id'));
- $filter->equal('method')->select(array_combine(OperationLog::$methods, OperationLog::$methods));
- $filter->like('path');
- $filter->equal('ip');
+ // 添加过滤选项
+ $filter->equal('user_id', 'User')->select($userModel::all()->pluck('name', 'id')); // 按用户过滤
+ $filter->equal('method')->select(array_combine(OperationLog::$methods, OperationLog::$methods)); // 按方法过滤
+ $filter->like('path'); // 按路径过滤
+ $filter->equal('ip'); // 按 IP 过滤
});
- return $grid;
+ return $grid; // 返回创建的操作日志网格
}
}
diff --git a/app/Admin/Controllers/ArticleNotificationController.php b/app/Admin/Controllers/ArticleNotificationController.php
index 3bbcdd5..0c9c3ee 100644
--- a/app/Admin/Controllers/ArticleNotificationController.php
+++ b/app/Admin/Controllers/ArticleNotificationController.php
@@ -11,89 +11,96 @@ use Encore\Admin\Show;
class ArticleNotificationController extends AdminController
{
/**
- * Title for current resource.
+ * 当前资源的标题
*
* @var string
*/
protected $title = '通知文章';
/**
- * Make a grid builder.
+ * 创建网格构建器
*
- * @return Grid
+ * @return Grid 返回网格实例
*/
protected function grid()
{
+ // 创建新的网格实例
$grid = new Grid(new ArticleNotification);
+ // 按照最新的通知排序
$grid->model()->latest();
- $grid->column('id', __('Id'));
- $grid->column('title', __('Title'));
- $grid->column('created_at', __('Created at'));
+ // 定义网格的列
+ $grid->column('id', __('Id')); // ID 列
+ $grid->column('title', __('Title')); // 标题列
+ $grid->column('created_at', __('Created at')); // 创建时间列
+ // 定义过滤器
$grid->filter(function (Grid\Filter $filter) {
-
- $filter->like('id', __('Id'));
- $filter->like('title', __('Title'));
+ $filter->like('id', __('Id')); // 按 ID 过滤
+ $filter->like('title', __('Title')); // 按标题过滤
});
+ // 自定义操作按钮
$grid->actions(function (Grid\Displayers\DropdownActions $actions) {
-
- $actions->disableEdit();
+ $actions->disableEdit(); // 禁用编辑操作
});
- return $grid;
+ return $grid; // 返回创建的网格
}
/**
- * Make a show builder.
+ * 创建详情展示构建器
*
- * @param mixed $id
- * @return Show
+ * @param mixed $id 通知文章的 ID
+ * @return Show 返回详情展示实例
*/
protected function detail($id)
{
+ // 创建新的详情展示实例
$show = new Show(ArticleNotification::findOrFail($id));
- $show->field('id', __('Id'));
- $show->field('title', __('Title'));
- $show->field('content', __('Content'))->unescape();
- $show->field('created_at', __('Created at'));
+ // 定义展示的字段
+ $show->field('id', __('Id')); // ID 字段
+ $show->field('title', __('Title')); // 标题字段
+ $show->field('content', __('Content'))->unescape(); // 内容字段，允许 HTML 解码
+ $show->field('created_at', __('Created at')); // 创建时间字段
- return $show;
+ return $show; // 返回创建的详情展示
}
/**
- * Make a form builder.
+ * 创建表单构建器
*
- * @return Form
+ * @return Form 返回表单实例
*/
protected function form()
{
+ // 创建新的表单实例
$form = new Form(new ArticleNotification);
- $form->text('title', __('Title'))->help('请再三确认再发布，不可修改');
- $form->kindeditor('content', __('Content'));
-
+ // 定义表单字段
+ $form->text('title', __('Title'))->help('请再三确认再发布，不可修改'); // 标题字段，带帮助信息
+ $form->kindeditor('content', __('Content')); // 内容字段，使用富文本编辑器
+
+ // 保存事件
$form->saving(function (Form $form) {
-
+ // 检查当前环境是否为开发环境
if (app()->environment('dev')) {
-
- admin_toastr('开发环境不允许操作', 'error');
- return back()->withInput();
+ admin_toastr('开发环境不允许操作', 'error'); // 提示用户
+ return back()->withInput(); // 返回到表单
}
});
-
+
+ // 删除事件
$form->deleting(function (Form $form) {
-
+ // 检查当前环境是否为开发环境
if (app()->environment('dev')) {
-
- admin_toastr('开发环境不允许操作', 'error');
- return back()->withInput();
+ admin_toastr('开发环境不允许操作', 'error'); // 提示用户
+ return back()->withInput(); // 返回到表单
}
});
- return $form;
+ return $form; // 返回创建的表单
}
}
diff --git a/app/Admin/Controllers/AuthController.php b/app/Admin/Controllers/AuthController.php
index 6ede048..db640d4 100644
--- a/app/Admin/Controllers/AuthController.php
+++ b/app/Admin/Controllers/AuthController.php
@@ -1,87 +1,90 @@
-only([$this->username(), 'password']);
/** @var \Illuminate\Validation\Validator $validator */
+ // 对输入的凭证进行验证
$validator = Validator::make($credentials, [
- $this->username() => 'required',
- 'password' => 'required',
+ $this->username() => 'required', // 用户名为必填
+ 'password' => 'required', // 密码为必填
]);
+ // 如果验证失败，返回错误信息
if ($validator->fails()) {
return back()->withInput()->withErrors($validator);
}
+ // 如果验证通过，尝试进行身份验证
if ($this->guard()->attempt($credentials)) {
-
- // 验证是否登录的 ip
+ // 登录成功后，执行身份验证后的操作（比如记录 IP 地址）
$this->authenticated($this->guard()->user());
- // 记录登录日期
+ // 记录登录日期并返回成功响应
return $this->sendLoginResponse($request);
}
+ // 如果身份验证失败，返回失败信息
return back()->withInput()->withErrors([
- $this->username() => $this->getFailedLoginMessage(),
+ $this->username() => $this->getFailedLoginMessage(), // 获取失败的登录信息
]);
}
/**
- * 登录之后提示 ip 地址
+ * 登录之后提示 IP 地址
*
* @param Administrator $user
*/
protected function authenticated(Administrator $user)
{
- $ip = request()->getClientIp();
+ $ip = request()->getClientIp(); // 获取当前登录用户的 IP 地址
- // 如果两次 ip 不一样, 提示风险
+ // 如果当前登录 IP 与上次登录的 IP 不一致，提示风险
if (! is_null($user->login_ip) && $ip != $user->login_ip) {
-
admin_info('上一次登录的地址与本次不同,如果不是本人操作,建议及时修改密码');
}
+ // 更新用户的登录 IP 地址
$user->login_ip = $ip;
- $user->save();
+ $user->save(); // 保存更新后的 IP 地址
}
-
+
+ /**
+ * 设置更新操作
+ */
public function putSetting()
{
- $form = $this->settingForm();
-
+ $form = $this->settingForm(); // 获取设置表单
+
+ // 表单提交时的处理逻辑
$form->submitted(function (Form $form) {
-
+ // 如果是开发环境，则禁止操作
if (app()->environment('dev')) {
-
- admin_toastr('开发环境不允许操作', 'error');
- return back()->withInput();
+ admin_toastr('开发环境不允许操作', 'error'); // 显示错误提示
+ return back()->withInput(); // 返回上一页面并保留输入
}
});
-
- return $form->update(Admin::user()->id);
+
+ // 执行设置更新
+ return $form->update(Admin::user()->id); // 更新当前登录用户的设置
}
}
diff --git a/app/Admin/Controllers/CarController.php b/app/Admin/Controllers/CarController.php
index c8cb307..9e82e75 100644
--- a/app/Admin/Controllers/CarController.php
+++ b/app/Admin/Controllers/CarController.php
@@ -2,89 +2,92 @@
namespace App\Admin\Controllers;
-use App\Models\Car;
-use Encore\Admin\Controllers\AdminController;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Show;
+use App\Models\Car; // 引入 Car 模型
+use Encore\Admin\Controllers\AdminController; // 引入 AdminController 作为基类
+use Encore\Admin\Form; // 引入表单构建类
+use Encore\Admin\Grid; // 引入网格（列表）构建类
+use Encore\Admin\Show; // 引入详情展示类
class CarController extends AdminController
{
/**
- * Title for current resource.
+ * 当前资源的标题（在界面上显示）
*
* @var string
*/
- protected $title = '购物车数据';
+ protected $title = '购物车数据'; // 设置控制器的标题为 "购物车数据"
/**
- * Make a grid builder.
+ * 创建网格（列表）视图.
*
* @return Grid
*/
protected function grid()
{
- $grid = new Grid(new Car);
+ $grid = new Grid(new Car); // 实例化 Grid，使用 Car 模型作为数据源
- $grid->column('id', __('Id'));
+ // 定义要在网格中显示的列
+ $grid->column('id', __('Id')); // ID 列
+ $grid->column('user_id', __('User id')); // 用户 ID 列
+ $grid->column('product_id', __('Product id')); // 商品 ID 列
- $grid->column('user_id', __('User id'));
- $grid->column('product_id', __('Product id'));
+ // 显示用户和商品的名称，假设它们通过 Eloquent 关系关联
+ $grid->column('user.name', '用户'); // 用户名称列
+ $grid->column('product.name', '商品'); // 商品名称列
+ $grid->column('number', __('Number')); // 数量列
- $grid->column('user.name', '用户');
- $grid->column('product.name', '商品');
- $grid->column('number', __('Number'));
+ $grid->column('created_at', '收藏时间'); // 创建时间列
+ // 禁用默认操作按钮和创建按钮
+ $grid->disableActions(); // 禁用行操作按钮
+ $grid->disableCreateButton(); // 禁用创建按钮
- $grid->column('created_at', '收藏时间');
-
- $grid->disableActions();
- $grid->disableCreateButton();
-
+ // 添加过滤条件设置
$grid->filter(function (Grid\Filter $filter) {
-
- $filter->equal('user_id', '用户ID');
- $filter->equal('product_id', '商品ID');
- $filter->like('user.name', '用户名');
- $filter->like('product.name', '商品');
+ $filter->equal('user_id', '用户ID'); // 精确匹配用户 ID
+ $filter->equal('product_id', '商品ID'); // 精确匹配商品 ID
+ $filter->like('user.name', '用户名'); // 用户名模糊查询
+ $filter->like('product.name', '商品'); // 商品名称模糊查询
});
- return $grid;
+ return $grid; // 返回配置好的网格实例
}
/**
- * Make a show builder.
+ * 创建详情显示视图.
*
* @param mixed $id
* @return Show
*/
protected function detail($id)
{
- $show = new Show(Car::findOrFail($id));
+ $show = new Show(Car::findOrFail($id)); // 获取指定 ID 的 Car 实例，并实例化 Show 类
- $show->field('id', __('Id'));
- $show->field('number', __('Number'));
- $show->field('product_id', __('Product id'));
- $show->field('user_id', __('User id'));
- $show->field('created_at', __('Created at'));
- $show->field('updated_at', __('Updated at'));
+ // 定义要在详情页面中显示的字段
+ $show->field('id', __('Id')); // 显示 ID 字段
+ $show->field('number', __('Number')); // 显示数量字段
+ $show->field('product_id', __('Product id')); // 显示商品 ID 字段
+ $show->field('user_id', __('User id')); // 显示用户 ID 字段
+ $show->field('created_at', __('Created at')); // 显示创建时间字段
+ $show->field('updated_at', __('Updated at')); // 显示更新时间字段
- return $show;
+ return $show; // 返回 Show 实例
}
/**
- * Make a form builder.
+ * 创建表单用于添加或编辑数据.
*
* @return Form
*/
protected function form()
{
- $form = new Form(new Car);
+ $form = new Form(new Car); // 创建一个新的 Form 实例，用于 Car 模型的数据
- $form->number('number', __('Number'))->default(1);
- $form->number('product_id', __('Product id'));
- $form->number('user_id', __('User id'));
+ // 定义表单字段
+ $form->number('number', __('Number'))->default(1); // 数量字段，默认为 1
+ $form->number('product_id', __('Product id')); // 商品 ID 字段
+ $form->number('user_id', __('User id')); // 用户 ID 字段
- return $form;
+ return $form; // 返回配置好的表单实例
}
}
diff --git a/app/Admin/Controllers/CategoryController.php b/app/Admin/Controllers/CategoryController.php
index c2f3d53..ec3d1af 100644
--- a/app/Admin/Controllers/CategoryController.php
+++ b/app/Admin/Controllers/CategoryController.php
@@ -16,182 +16,180 @@ use Illuminate\Http\Request;
class CategoryController extends Controller
{
- use HasResourceActions;
+ use HasResourceActions; // 引入资源操作的特性
/**
- * Index interface.
+ * 显示商品分类的首页
*
* @param Content $content
- * @return Content
+ * @return Content 返回构建好的内容
*/
public function index(Content $content)
{
return $content
- ->header('商品分类')
- ->description('')
+ ->header('商品分类') // 设置页面标题
+ ->description('') // 页面描述
->row(function (Row $row) {
- // 只能在同一级排序拖动，不允许二级
+ // 创建分类树形结构，限制只能在同一级排序
$row->column(6, Category::tree(function (Tree $tree) {
+ $tree->disableCreate(); // 禁用创建新分类的功能
- $tree->disableCreate();
-
+ // 允许拖拽排序，且最大深度为1
$tree->nestable(['maxDepth' => 1])
->branch(function ($branch) {
-
+ // 自定义树节点的显示格式
$icon = "";
-
return $icon . ' ' . $branch['title'];
});
}));
- // 新建表单
+ // 创建新分类的表单
$row->column(6, function (Column $column) {
$form = new \Encore\Admin\Widgets\Form();
- $form->action(admin_base_path('categories'));
+ $form->action(admin_base_path('categories')); // 设置表单提交路径
- $form->text('title', '分类名')->rules('required|unique:categories,title');
- $form->icon('icon', '图标')->default('fa-bars')->rules('required');
- $form->image('thumb', '缩略图')->uniqueName()->rules('required');
- $form->hidden('_token')->default(csrf_token());
+ // 定义表单字段
+ $form->text('title', '分类名')->rules('required|unique:categories,title'); // 分类名，必填且唯一
+ $form->icon('icon', '图标')->default('fa-bars')->rules('required'); // 图标，必填
+ $form->image('thumb', '缩略图')->uniqueName()->rules('required'); // 缩略图，必填
+ $form->hidden('_token')->default(csrf_token()); // CSRF 令牌
+ // 将表单添加到页面
$column->append((new Box('新增', $form))->style('success'));
});
});
}
/**
- * Show interface.
+ * 显示分类的详细信息
*
- * @param mixed $id
+ * @param mixed $id 分类ID
* @param Content $content
- * @return Content
+ * @return Content 返回构建好的内容
*/
public function show($id, Content $content)
{
return $content
- ->header('详情')
- ->description('')
- ->body($this->detail($id));
+ ->header('详情') // 设置页面标题
+ ->description('') // 页面描述
+ ->body($this->detail($id)); // 显示分类详细信息
}
/**
- * Edit interface.
+ * 显示编辑分类的界面
*
- * @param mixed $id
+ * @param mixed $id 分类ID
* @param Content $content
- * @return Content
+ * @return Content 返回构建好的内容
*/
public function edit($id, Content $content)
{
return $content
- ->header('编辑')
- ->description('')
- ->body($this->form()->edit($id));
+ ->header('编辑') // 设置页面标题
+ ->description('') // 页面描述
+ ->body($this->form()->edit($id)); // 显示编辑表单
}
-
-
/**
- * Make a show builder.
+ * 创建分类详细信息的展示构建器
*
- * @param mixed $id
- * @return Show
+ * @param mixed $id 分类ID
+ * @return Show 返回详细信息展示实例
*/
protected function detail($id)
{
- $show = new Show(Category::findOrFail($id));
+ $show = new Show(Category::findOrFail($id)); // 根据ID查找分类
- $show->field('id');
- $show->field('title', '分类名');
+ // 定义展示的字段
+ $show->field('id'); // ID
+ $show->field('title', '分类名'); // 分类名
$show->field('thumb', '缩略图')->unescape()->as(function ($thumb) {
- return image($thumb);
+ return image($thumb); // 显示缩略图
});
- $show->field('description', '描述');
- $show->field('order', '排序');
- $show->field('created_at', '创建时间');
- $show->field('updated_at', '修改时间');
+ $show->field('description', '描述'); // 描述
+ $show->field('order', '排序'); // 排序
+ $show->field('created_at', '创建时间'); // 创建时间
+ $show->field('updated_at', '修改时间'); // 修改时间
- return $show;
+ return $show; // 返回详细信息展示
}
/**
- * Make a form builder.
+ * 创建分类的表单构建器
*
- * @return Form
+ * @return Form 返回表单实例
*/
protected function form()
{
- $form = new Form(new Category);
+ $form = new Form(new Category); // 创建新的表单实例
+
+ // 定义表单字段
+ $form->text('title', '分类名'); // 分类名
+ $form->icon('icon', '图标'); // 图标
+ $form->image('thumb', '缩略图'); // 缩略图
+ $form->text('description', '描述'); // 描述
- $form->text('title', '分类名');
- $form->icon('icon', '图标');
- $form->image('thumb', '缩略图');
- $form->text('description', '描述');
-
+ // 保存前的逻辑
$form->saving(function (Form $form) {
-
- if (app()->environment('dev')) {
-
- admin_toastr('开发环境不允许操作', 'error');
- return back()->withInput();
+ if (app()->environment('dev')) { // 检查是否在开发环境
+ admin_toastr('开发环境不允许操作', 'error'); // 提示用户
+ return back()->withInput(); // 返回到表单
}
});
-
- return $form;
+ return $form; // 返回创建的表单
}
-
/**
- * 分类下有商品，不允许删除
+ * 删除分类
*
- * @param $id
- * @return \Illuminate\Http\JsonResponse
+ * @param $id 分类ID
+ * @return \Illuminate\Http\JsonResponse 返回 JSON 响应
*/
public function destroy($id)
{
- if (app()->environment('dev')) {
-
+ if (app()->environment('dev')) { // 检查是否在开发环境
return response()->json(['status' => false, 'message' => '开发环境不允许操作']);
}
- /**
- * @var $category Category
- */
- $category = Category::query()->findOrFail($id);
+ /** @var $category Category */
+ $category = Category::query()->findOrFail($id); // 查找分类
+
+ // 检查分类下是否有商品
if ($category->products()->exists()) {
return response()->json(['status' => false, 'message' => '分类下有商品存在，不允许删除']);
}
+ // 尝试删除分类
if ($category->delete()) {
$data = [
'status' => true,
- 'message' => trans('admin.delete_succeeded'),
+ 'message' => trans('admin.delete_succeeded'), // 删除成功提示
];
} else {
$data = [
'status' => false,
- 'message' => trans('admin.delete_failed'),
+ 'message' => trans('admin.delete_failed'), // 删除失败提示
];
}
- return response()->json($data);
+ return response()->json($data); // 返回 JSON 响应
}
/**
- * 商品下拉列表
+ * 获取分类下的商品下拉列表
*
* @param Request $request
- * @return \Illuminate\Support\Collection
+ * @return \Illuminate\Support\Collection 返回商品集合
*/
public function getProducts(Request $request)
{
- $id = $request->get('q');
+ $id = $request->get('q'); // 获取请求参数中的分类ID
- $category = Category::query()->findOrFail($id);
+ $category = Category::query()->findOrFail($id); // 查找分类
- // 尽量促销卖得少的商品
+ // 返回分类下的商品，按销量降序排列
return $category->products()->orderBy('sale_count', 'desc')->get(['id', 'name as text']);
}
}
diff --git a/app/Admin/Controllers/CommentController.php b/app/Admin/Controllers/CommentController.php
index 25a096d..58c896b 100644
--- a/app/Admin/Controllers/CommentController.php
+++ b/app/Admin/Controllers/CommentController.php
@@ -12,62 +12,68 @@ use Encore\Admin\Layout\Content;
class CommentController extends Controller
{
- use HasResourceActions;
+ use HasResourceActions; // 引入资源操作的特性
/**
- * Index interface.
+ * 显示评论列表的界面
*
* @param Content $content
- * @return Content
+ * @return Content 返回构建好的内容
*/
public function index(Content $content)
{
return $content
- ->header('评论列表')
- ->description('')
- ->body($this->grid());
+ ->header('评论列表') // 设置页面标题
+ ->description('') // 页面描述
+ ->body($this->grid()); // 显示评论列表
}
/**
- * Make a grid builder.
+ * 创建评论列表的网格构建器
*
- * @return Grid
+ * @return Grid 返回网格实例
*/
protected function grid()
{
- $grid = new Grid(new Comment);
+ $grid = new Grid(new Comment); // 创建新的网格实例，基于 Comment 模型
- $grid->model()->latest();
+ $grid->model()->latest(); // 按照创建时间降序排列评论
- $grid->column('id');
- $grid->column('order_id', '订单');
- $grid->column('product.name', '商品');
- $grid->column('user.name', '用户');
- $grid->column('content', '评论内容');
- $grid->column('score', '评分');
- $grid->column('created_at', '创建时间');
- $grid->column('updated_at', '修改时间');
+ // 定义网格列
+ $grid->column('id'); // 评论ID
+ $grid->column('order_id', '订单'); // 关联的订单ID
+ $grid->column('product.name', '商品'); // 关联商品的名称
+ $grid->column('user.name', '用户'); // 关联用户的名称
+ $grid->column('content', '评论内容'); // 评论内容
+ $grid->column('score', '评分'); // 评分
+ $grid->column('created_at', '创建时间'); // 创建时间
+ $grid->column('updated_at', '修改时间'); // 修改时间
+ // 定义过滤器
$grid->filter(function (Grid\Filter $filter) {
+ $filter->disableIdFilter(); // 禁用ID过滤器
- $filter->disableIdFilter();
+ // 用户过滤器
$filter->where(function ($query) {
-
+ // 根据用户名称模糊查询用户ID
$collections = User::query()
->where('name', 'like', "%{$this->input}%")
->pluck('id');
+ // 根据用户ID过滤评论
$query->whereIn('user_id', $collections->all());
}, '用户');
- $filter->where(function ($query) {
+ // 商品过滤器
+ $filter->where(function ($query) {
+ // 根据商品名称模糊查询商品ID
$collections = Product::query()
->where('name', 'like', "%{$this->input}%")
->pluck('id');
-
+ // 根据商品ID过滤评论
$query->whereIn('product_id', $collections->all());
}, '商品');
});
- return $grid;
+ return $grid; // 返回构建好的网格
}
}
diff --git a/app/Admin/Controllers/CouponCodeController.php b/app/Admin/Controllers/CouponCodeController.php
index 80ada3a..6b29285 100644
--- a/app/Admin/Controllers/CouponCodeController.php
+++ b/app/Admin/Controllers/CouponCodeController.php
@@ -2,189 +2,191 @@
namespace App\Admin\Controllers;
-use App\Enums\UserSexEnum;
-use App\Enums\UserSourceEnum;
-use App\Models\CouponCode;
-use App\Models\CouponTemplate;
-use App\Models\User;
-use App\Notifications\CouponCodeNotification;
-use Carbon\Carbon;
-use Encore\Admin\Controllers\AdminController;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Show;
-use Illuminate\Http\Request;
-use Illuminate\Notifications\DatabaseNotification;
-use Ramsey\Uuid\Uuid;
+use App\Enums\UserSexEnum; // 用户性别枚举
+use App\Enums\UserSourceEnum; // 用户来源枚举
+use App\Models\CouponCode; // 优惠券兑换码模型
+use App\Models\CouponTemplate; // 优惠券模板模型
+use App\Models\User; // 用户模型
+use App\Notifications\CouponCodeNotification; // 优惠券通知
+use Carbon\Carbon; // 日期时间处理库
+use Encore\Admin\Controllers\AdminController; // 管理员控制器基类
+use Encore\Admin\Form; // 表单构建器
+use Encore\Admin\Grid; // 网格构建器
+use Encore\Admin\Show; // 展示构建器
+use Illuminate\Http\Request; // 请求处理
+use Illuminate\Notifications\DatabaseNotification; // 数据库通知模型
+use Ramsey\Uuid\Uuid; // UUID生成库
class CouponCodeController extends AdminController
{
/**
- * Title for current resource.
+ * 当前资源的标题.
*
* @var string
*/
- protected $title = '优惠券兑换码';
+ protected $title = '优惠券兑换码'; // 控制器标题
/**
- * Make a grid builder.
+ * 创建网格构建器.
*
- * @return Grid
+ * @return Grid 返回网格实例
*/
protected function grid()
{
- $grid = new Grid(new CouponCode);
+ $grid = new Grid(new CouponCode); // 创建新的网格实例，基于 CouponCode 模型
- $grid->model()->latest();
+ $grid->model()->latest(); // 按照创建时间降序排列优惠券兑换码
- $grid->column('id', __('Id'));
- $grid->column('code', '兑换码');
- $grid->column('user_id', __('User id'));
- $grid->column('template_id', '优惠券ID');
+ // 定义网格列
+ $grid->column('id', __('Id')); // 显示ID
+ $grid->column('code', '兑换码'); // 显示兑换码
+ $grid->column('user_id', __('User id')); // 显示用户ID
+ $grid->column('template_id', '优惠券ID'); // 显示优惠券模板ID
- $grid->column('user.name', '会员名');
- $grid->column('template.title', '优惠券名');
-
- $grid->column('used_at', __('Used at'));
- $grid->column('notification_at', '上一次发送通知时间');
- $grid->column('created_at', __('Created at'));
+ // 关联显示用户和优惠券模板的名称
+ $grid->column('user.name', '会员名'); // 显示会员名称
+ $grid->column('template.title', '优惠券名'); // 显示优惠券名称
+ // 显示使用时间和通知时间
+ $grid->column('used_at', __('Used at')); // 显示使用时间
+ $grid->column('notification_at', '上一次发送通知时间'); // 显示上一次发送通知的时间
+ $grid->column('created_at', __('Created at')); // 显示创建时间
+ // 定义过滤器
$grid->filter(function (Grid\Filter $filter) {
-
- $filter->equal('code', '兑换码');
- $filter->like('user.name', '会员名');
- $filter->equal('template.title', '优惠券名');
- $filter->between('used_at')->datetime();
+ $filter->equal('code', '兑换码'); // 兑换码过滤
+ $filter->like('user.name', '会员名'); // 会员名模糊查询
+ $filter->equal('template.title', '优惠券名'); // 优惠券名过滤
+ $filter->between('used_at')->datetime(); // 使用时间范围过滤
});
+ // 禁用编辑和查看操作
$grid->actions(function (Grid\Displayers\Actions $actions) {
-
- $actions->disableEdit();
- $actions->disableView();
+ $actions->disableEdit(); // 禁用编辑按钮
+ $actions->disableView(); // 禁用查看按钮
});
- return $grid;
+ return $grid; // 返回构建好的网格
}
-
+ /**
+ * 存储新的优惠券兑换码.
+ *
+ * @return \Illuminate\Http\RedirectResponse
+ */
public function store()
{
- $request = request();
+ $request = request(); // 获取请求实例
/**
* 发放的优惠券不能为空
* @var $template CouponTemplate
*/
+ // 根据模板ID查找优惠券模板
$template = CouponTemplate::query()->findOrFail($request->input('template_id'));
- $today = Carbon::today();
- if ($today->gt(Carbon::make($template->end_date))) {
+ $today = Carbon::today(); // 获取今天的日期
- admin_error('优惠券已过期');
- return back()->withInput();
+ // 检查优惠券是否过期
+ if ($today->gt(Carbon::make($template->end_date))) {
+ admin_error('优惠券已过期'); // 显示错误信息
+ return back()->withInput(); // 返回上一个页面并保留输入
}
// 如果会员 ID 不为空，则代表是指定会员发放
if ($userIds = $request->input('user_ids')) {
-
- // 使用空格拆分 id
- $ids = array_values(array_filter(explode(' ', $userIds)));
- $users = User::query()->findMany($ids);
- }
- // 否则则是条件范围发放
- else {
-
- $query = User::query();
- // 性别
- $sex = array_filter($request->input('user_sex'));
- // 会员来源
- $sources = array_filter($request->input('user_source'));
- // 登录次数
- $loginCount = (int)$request->input('login_count');
- // 会员总积分
- $scoreAll = (int)$request->input('user_score');
-
+ // 使用空格拆分 ID
+ $ids = array_values(array_filter(explode(' ', $userIds))); // 过滤空值并重建索引
+ $users = User::query()->findMany($ids); // 查找指定的用户
+ } else {
+ // 否则则是条件范围发放
+ $query = User::query(); // 创建用户查询
+
+ // 获取过滤条件
+ $sex = array_filter($request->input('user_sex')); // 性别
+ $sources = array_filter($request->input('user_source')); // 会员来源
+ $loginCount = (int)$request->input('login_count'); // 登录次数
+ $scoreAll = (int)$request->input('user_score'); // 总积分
+
+ // 应用过滤条件
$query->whereIn('sex', $sex)
->whereIn('source', $sources)
->where('login_count', '>=', $loginCount)
->where('score_all', '>=', $scoreAll);
- $users = $query->get();
+ $users = $query->get(); // 获取符合条件的用户
}
-
- // 开始根据用户发放
- $now = Carbon::now()->toDateTimeString();
- $notifications = collect();
+ // 开始根据用户发放优惠券
+ $now = Carbon::now()->toDateTimeString(); // 获取当前时间
+ $notifications = collect(); // 创建通知集合
$codes = $users->map(function (User $user) use ($template, $notifications, $now) {
+ $code = strtoupper(str_random(16)); // 生成随机兑换码
- $code = strtoupper(str_random(16));
-
+ // 创建通知数据
$notification = [
- 'id' => Uuid::uuid4()->toString(),
- 'type' => CouponCodeNotification::class,
- 'notifiable_id' => $user->id,
- 'notifiable_type' => get_class($user),
- 'data' => json_encode((new CouponCodeNotification($template, $code))->toArray($user), JSON_UNESCAPED_UNICODE),
- 'created_at' => $now,
- 'updated_at' => $now,
+ 'id' => Uuid::uuid4()->toString(), // 生成唯一ID
+ 'type' => CouponCodeNotification::class, // 通知类型
+ 'notifiable_id' => $user->id, // 可通知的用户ID
+ 'notifiable_type' => get_class($user), // 用户类型
+ 'data' => json_encode((new CouponCodeNotification($template, $code))->toArray($user), JSON_UNESCAPED_UNICODE), // 通知数据
+ 'created_at' => $now, // 创建时间
+ 'updated_at' => $now, // 更新时间
];
- $notifications->push($notification);
+ $notifications->push($notification); // 将通知添加到集合
return [
- 'code' => $code,
- 'user_id' => $user->id,
- 'template_id' => $template->id,
- 'notification_at' => $now,
- 'created_at' => $now,
- 'updated_at' => $now,
+ 'code' => $code, // 兑换码
+ 'user_id' => $user->id, // 用户ID
+ 'template_id' => $template->id, // 模板ID
+ 'notification_at' => $now, // 通知时间
+ 'created_at' => $now, // 创建时间
+ 'updated_at' => $now, // 更新时间
];
});
-
- $size = 1000;
+ $size = 1000; // 每次插入的数量
foreach (array_chunk($codes->all(), $size, true) as $chunk) {
- // 优惠券码
- CouponCode::query()->insert($codes->all());
+ // 批量插入优惠券码
+ CouponCode::query()->insert($chunk);
}
foreach (array_chunk($notifications->all(), $size, true) as $chunk) {
- // 通知
+ // 批量插入通知
DatabaseNotification::query()->insert($chunk);
}
- admin_toastr("发布成功，总共有{$users->count()}位会员符合发放条件");
- return response()->redirectTo(admin_url('/coupon_codes'));
+ admin_toastr("发布成功，总共有{$users->count()}位会员符合发放条件"); // 显示成功提示
+ return response()->redirectTo(admin_url('/coupon_codes')); // 重定向到优惠券兑换码列表
}
/**
- * Make a form builder.
+ * 创建表单构建器.
*
- * @return Form
+ * @return Form 返回表单实例
*/
protected function form()
{
- $form = new Form(new CouponCode);
+ $form = new Form(new CouponCode); // 创建新的表单实例，基于 CouponCode 模型
- $today = Carbon::today()->toDateString();
+ $today = Carbon::today()->toDateString(); // 获取今天的日期
- $form->divider('指定会员发放');
- $form->text('user_ids', '会员')->help('请输入会员的ID, 多个会员用空格隔开，如果为空则代表是范围发放');
+ $form->divider('指定会员发放'); // 分隔符
+ $form->text('user_ids', '会员')->help('请输入会员的ID, 多个会员用空格隔开，如果为空则代表是范围发放'); // 会员ID输入框
- $form->divider('范围发放');
+ $form->divider('范围发放'); // 分隔符
+ // 获取有效的优惠券模板
$templates = CouponTemplate::query()->where('end_date', '>=', $today)->pluck('title', 'id');
- $form->checkbox('user_sex', '会员性别')->options([UserSexEnum::MAN => '男', UserSexEnum::WOMAN => '女'])->canCheckAll();
+ $form->checkbox('user_sex', '会员性别')->options([UserSexEnum::MAN => '男', UserSexEnum::WOMAN => '女'])->canCheckAll(); // 性别选择框
$form->checkbox('user_source', '会员来源')->options([
- UserSourceEnum::MOON => '前台注册',
- UserSourceEnum::GITHUB => 'Github',
- UserSourceEnum::QQ => 'QQ',
- UserSourceEnum::WEIBO => '微博',
- ])->canCheckAll();
- $form->number('login_count', '会员登录次数')->default(0)->help('会员登录次数大于等于给定的次数');
- $form->number('user_score', '会员总积分')->default(0)->help('会员给定的积分大于等于总积分');
-
- $form->divider('优惠券');
-
- $form->select('template_id', '优惠券')->help('发放的优惠券')->options($templates)->required();
-
- return $form;
+ UserSourceEnum::MOON => '前台注册',
+ UserSourceEnum::GITHUB => 'Github',
+ UserSourceEnum::QQ => 'QQ',
+ UserSourceEnum::WEIBO => '微博',
+ ])->canCheckAll(); // 来源选择框
+ $form->number('login_count', '会员登录次数')->default(0)->help('会员登录次数大于等于给定的次数'); // 登录次数输入框
+ $form->number('user_score', '会员总积分')->default(0)->help('会员给定的积分大于等于总积分'); // 总积分输入框
+
+ $form->divider('优惠券'); // 分隔符
+ $form->select('template_id', '优惠券')->help('发放的优惠券')->options($templates)->required(); // 优惠券选择框
+
+ return $form; // 返回构建好的表单
}
}
diff --git a/app/Admin/Controllers/CouponLogController.php b/app/Admin/Controllers/CouponLogController.php
index de28c64..b5a13d7 100644
--- a/app/Admin/Controllers/CouponLogController.php
+++ b/app/Admin/Controllers/CouponLogController.php
@@ -2,56 +2,60 @@
namespace App\Admin\Controllers;
-use App\Admin\Transforms\YesNoTransform;
-use App\Models\UserHasCoupon;
-use Encore\Admin\Controllers\AdminController;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Show;
+use App\Admin\Transforms\YesNoTransform; // 引入 YesNoTransform 类，用于转换布尔值
+use App\Models\UserHasCoupon; // 引入用户优惠券记录模型
+use Encore\Admin\Controllers\AdminController; // 引入管理员控制器基类
+use Encore\Admin\Form; // 引入表单构建器
+use Encore\Admin\Grid; // 引入网格构建器
+use Encore\Admin\Show; // 引入展示构建器
class CouponLogController extends AdminController
{
/**
- * Title for current resource.
+ * 当前资源的标题.
*
* @var string
*/
- protected $title = '会员领取记录';
+ protected $title = '会员领取记录'; // 控制器标题
/**
- * Make a grid builder.
+ * 创建网格构建器.
*
- * @return Grid
+ * @return Grid 返回网格实例
*/
protected function grid()
{
- $grid = new Grid(new UserHasCoupon);
-
- $grid->model()->latest();
-
- $grid->column('id', __('Id'));
- $grid->column('user_id', '用户 ID');
- $grid->column('user.name', '用户昵称');
- $grid->column('title', __('Title'));
- $grid->column('amount', '满减金额');
- $grid->column('full_amount', __('Full amount'));
- $grid->column('start_date', __('Start date'));
- $grid->column('end_date', __('End date'));
- $grid->column('is_used', '是否使用')->display(function () {
+ $grid = new Grid(new UserHasCoupon); // 创建新的网格实例，基于 UserHasCoupon 模型
+
+ $grid->model()->latest(); // 按照记录创建时间降序排列
+
+ // 定义网格列
+ $grid->column('id', __('Id')); // 显示记录ID
+ $grid->column('user_id', '用户 ID'); // 显示用户ID
+ $grid->column('user.name', '用户昵称'); // 显示用户昵称
+ $grid->column('title', __('Title')); // 显示优惠券标题
+ $grid->column('amount', '满减金额'); // 显示满减金额
+ $grid->column('full_amount', __('Full amount')); // 显示满额金额
+ $grid->column('start_date', __('Start date')); // 显示优惠券开始日期
+ $grid->column('end_date', __('End date')); // 显示优惠券结束日期
- return YesNoTransform::trans(! is_null($this->used_at));
+ // 显示是否使用的状态，使用 YesNoTransform 转换
+ $grid->column('is_used', '是否使用')->display(function () {
+ return YesNoTransform::trans(! is_null($this->used_at)); // 如果 used_at 不为空，则表示已使用
});
- $grid->column('used_at', '使用时间');
- $grid->column('created_at', __('Created at'));
- $grid->disableActions();
- $grid->disableCreateButton();
+ $grid->column('used_at', '使用时间'); // 显示使用时间
+ $grid->column('created_at', __('Created at')); // 显示创建时间
- $grid->filter(function (Grid\Filter $filter) {
+ // 禁用操作按钮和创建按钮
+ $grid->disableActions(); // 禁用操作按钮
+ $grid->disableCreateButton(); // 禁用创建按钮
- $filter->like('title', __('Title'));
+ // 定义过滤器
+ $grid->filter(function (Grid\Filter $filter) {
+ $filter->like('title', __('Title')); // 允许通过优惠券标题进行模糊查询
});
- return $grid;
+ return $grid; // 返回构建好的网格
}
}
diff --git a/app/Admin/Controllers/CouponTemplateController.php b/app/Admin/Controllers/CouponTemplateController.php
index 4bf97b3..0179d1c 100644
--- a/app/Admin/Controllers/CouponTemplateController.php
+++ b/app/Admin/Controllers/CouponTemplateController.php
@@ -2,85 +2,94 @@
namespace App\Admin\Controllers;
-use App\Admin\Transforms\YesNoTransform;
-use App\Models\CouponTemplate;
-use Carbon\Carbon;
-use Encore\Admin\Controllers\AdminController;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Show;
+use App\Admin\Transforms\YesNoTransform; // 引入 YesNoTransform 类，用于转换布尔值
+use App\Models\CouponTemplate; // 引入优惠券模板模型
+use Carbon\Carbon; // 引入 Carbon 日期时间处理库
+use Encore\Admin\Controllers\AdminController; // 引入管理员控制器基类
+use Encore\Admin\Form; // 引入表单构建器
+use Encore\Admin\Grid; // 引入网格构建器
+use Encore\Admin\Show; // 引入展示构建器
class CouponTemplateController extends AdminController
{
/**
- * Title for current resource.
+ * 当前资源的标题.
*
* @var string
*/
- protected $title = '优惠券';
+ protected $title = '优惠券'; // 控制器标题
/**
- * Make a grid builder.
+ * 创建网格构建器.
*
- * @return Grid
+ * @return Grid 返回网格实例
*/
protected function grid()
{
- $grid = new Grid(new CouponTemplate);
+ $grid = new Grid(new CouponTemplate); // 创建新的网格实例，基于 CouponTemplate 模型
- $grid->model()->latest('start_date');
+ $grid->model()->latest('start_date'); // 按照开始日期降序排列优惠券模板
- $grid->column('id', __('Id'));
- $grid->column('title', __('Title'));
- $grid->column('amount', '优惠金额');
- $grid->column('full_amount', __('Full amount'));
- $grid->column('score', '需兑换积分');
- $grid->column('exp_date', '有效日期')->display(function () {
+ // 定义网格列
+ $grid->column('id', __('Id')); // 显示记录ID
+ $grid->column('title', __('Title')); // 显示优惠券标题
+ $grid->column('amount', '优惠金额'); // 显示优惠金额
+ $grid->column('full_amount', __('Full amount')); // 显示满额金额
+ $grid->column('score', '需兑换积分'); // 显示需兑换的积分
- return $this->start_date . ' ~ ' . $this->end_date;
+ // 显示有效日期范围
+ $grid->column('exp_date', '有效日期')->display(function () {
+ return $this->start_date . ' ~ ' . $this->end_date; // 显示开始日期和结束日期
});
- $today = Carbon::today();
+
+ $today = Carbon::today(); // 获取今天的日期
+
+ // 显示优惠券是否有效（未过期）
$grid->column('overtime', '是否有效（未过期）')->display(function () use ($today) {
+ $endDate = Carbon::make($this->end_date); // 将结束日期转换为 Carbon 实例
+ $startDate = Carbon::make($this->start_date); // 将开始日期转换为 Carbon 实例
- $endDate = Carbon::make($this->end_date);
- $startDate = Carbon::make($this->start_date);
- // 如果没有结束日期，代表永远不过期
+ // 检查是否有结束日期和开始日期
if (is_null($endDate) || is_null($startDate)) {
-
- $isOver = true;
+ $isOver = true; // 如果没有结束日期，代表永远不过期
} else {
-
+ // 检查今天的日期是否在有效日期范围内
$isOver = $today->gte($startDate) && $today->lte($endDate);
}
- return YesNoTransform::trans($isOver);
+ return YesNoTransform::trans($isOver); // 使用 YesNoTransform 转换布尔值为可读格式
});
- $grid->column('created_at', __('Created at'));
- $grid->filter(function (Grid\Filter $filter) {
+ $grid->column('created_at', __('Created at')); // 显示创建时间
- $filter->like('title', __('Title'));
+ // 定义过滤器
+ $grid->filter(function (Grid\Filter $filter) {
+ $filter->like('title', __('Title')); // 允许通过优惠券标题进行模糊查询
});
- return $grid;
+ return $grid; // 返回构建好的网格
}
/**
- * Make a form builder.
+ * 创建表单构建器.
*
- * @return Form
+ * @return Form 返回表单实例
*/
protected function form()
{
- $form = new Form(new CouponTemplate);
-
- $form->text('title', __('Title'));
- $form->decimal('amount', '优惠金额');
- $form->decimal('full_amount', __('Full amount'));
- $form->number('score', __('Score'))->default(0)->help('设置为 0 代表无需积分即可兑换优惠券');
- $form->date('start_date', __('Start date'))->default(date('Y-m-d'));
- $form->date('end_date', __('End date'))->default(Carbon::today()->addMonth());
-
- return $form;
+ $form = new Form(new CouponTemplate); // 创建新的表单实例，基于 CouponTemplate 模型
+
+ $form->text('title', __('Title')); // 输入优惠券标题
+ $form->decimal('amount', '优惠金额'); // 输入优惠金额
+ $form->decimal('full_amount', __('Full amount')); // 输入满额金额
+ $form->number('score', __('Score')) // 输入需兑换积分
+ ->default(0) // 默认值为 0
+ ->help('设置为 0 代表无需积分即可兑换优惠券'); // 帮助提示
+ $form->date('start_date', __('Start date')) // 输入开始日期
+ ->default(date('Y-m-d')); // 默认设置为今天
+ $form->date('end_date', __('End date')) // 输入结束日期
+ ->default(Carbon::today()->addMonth()); // 默认设置为一个月后
+
+ return $form; // 返回构建好的表单
}
}
diff --git a/app/Admin/Controllers/HomeController.php b/app/Admin/Controllers/HomeController.php
index 5904f2a..b4388b4 100644
--- a/app/Admin/Controllers/HomeController.php
+++ b/app/Admin/Controllers/HomeController.php
@@ -2,83 +2,89 @@
namespace App\Admin\Controllers;
-use App\Admin\Extensions\Div;
-use App\Http\Controllers\Controller;
-use App\Models\SiteCount;
-use App\Models\User;
-use App\Services\SiteCountService;
-use Carbon\Carbon;
-use Encore\Admin\Auth\Database\Menu;
-use Encore\Admin\Facades\Admin;
-use Encore\Admin\Layout\Content;
-use Encore\Admin\Layout\Row;
-use Encore\Admin\Widgets\Box;
+use App\Admin\Extensions\Div; // 引入自定义的 Div 类
+use App\Http\Controllers\Controller; // 引入基础控制器
+use App\Models\SiteCount; // 引入站点统计模型
+use App\Models\User; // 引入用户模型
+use App\Services\SiteCountService; // 引入站点统计服务
+use Carbon\Carbon; // 引入 Carbon 日期时间处理库
+use Encore\Admin\Auth\Database\Menu; // 引入菜单模型
+use Encore\Admin\Facades\Admin; // 引入 Admin 门面
+use Encore\Admin\Layout\Content; // 引入内容布局
+use Encore\Admin\Layout\Row; // 引入行布局
+use Encore\Admin\Widgets\Box; // 引入盒子组件
class HomeController extends Controller
{
+ /**
+ * 显示仪表盘首页.
+ *
+ * @param Content $content 内容布局实例
+ * @param SiteCountService $service 站点统计服务实例
+ * @return Content 返回内容布局
+ */
public function index(Content $content, SiteCountService $service)
{
// 用于更新菜单数据到文件， 可删除
-// file_put_contents(database_path('data/menus.json'), Menu::all()->toJson(JSON_UNESCAPED_UNICODE));
+ // file_put_contents(database_path('data/menus.json'), Menu::all()->toJson(JSON_UNESCAPED_UNICODE));
- // 使用 echart
+ // 引入 ECharts 图表库
Admin::js('/js/echarts.min.js');
return $content
- ->header('仪表盘')
- ->row(function (Row $row) use ($service) {
+ ->header('仪表盘') // 设置页面标题
+ ->row(function (Row $row) use ($service) { // 创建一行布局
/**
- * 今日统计,今天的特殊，需要从缓存 redis 中读取
+ * 今日统计, 今天的特殊情况，需要从缓存 redis 中读取
*
* @var $todaySite SiteCount
*/
- $now = Carbon::now();
- $today = $now->toDateString();
- $todaySite = SiteCount::query()->firstOrNew(['date' => $today]);
- $todaySite = $service->syncByCache($todaySite);
+ $now = Carbon::now(); // 获取当前时间
+ $today = $now->toDateString(); // 获取今天的日期字符串
+ $todaySite = SiteCount::query()->firstOrNew(['date' => $today]); // 获取今天的统计记录，如果不存在则创建新记录
+ $todaySite = $service->syncByCache($todaySite); // 从缓存中同步今天的统计数据
// 七日统计
- $lastWeekDate = $now->subDay(7);
+ $lastWeekDate = $now->subDay(7); // 计算七天前的日期
$weekSites = SiteCount::query()
- ->where('date', '!=', $today)
- ->where('date', '>', $lastWeekDate)
- ->get()
- ->push($todaySite)
- ->sortBy('date');
-
+ ->where('date', '!=', $today) // 排除今天的记录
+ ->where('date', '>', $lastWeekDate) // 只获取最近七天的记录
+ ->get() // 获取记录
+ ->push($todaySite) // 将今天的记录添加到结果集中
+ ->sortBy('date'); // 按日期排序
// 本月统计
- $month = $now->format('Y-m');
+ $month = $now->format('Y-m'); // 获取当前月份（格式：YYYY-MM）
$monthSites = SiteCount::query()
- ->where('date', '!=', $today)
- ->where('date', '>', $month)
- ->get()
- ->push($todaySite)
- ->sortBy('date');
-
+ ->where('date', '!=', $today) // 排除今天的记录
+ ->where('date', '>', $month) // 只获取本月的记录
+ ->get() // 获取记录
+ ->push($todaySite) // 将今天的记录添加到结果集中
+ ->sortBy('date'); // 按日期排序
- $row->column(4, new Box('今日用户注册来源', new Div('todayRegister')));
- $row->column(4, new Box('七日用户注册来源', new Div('weekRegister')));
- $row->column(4, new Box('本月用户注册来源', new Div('monthRegister')));
+ // 创建统计信息的盒子组件
+ $row->column(4, new Box('今日用户注册来源', new Div('todayRegister'))); // 今日用户注册来源
+ $row->column(4, new Box('七日用户注册来源', new Div('weekRegister'))); // 七日用户注册来源
+ $row->column(4, new Box('本月用户注册来源', new Div('monthRegister'))); // 本月用户注册来源
- $row->column(4, new Box('今日订单', new Div('todayOrders')));
- $row->column(4, new Box('近期订单量', new Div('weekSites')));
- $row->column(4, new Box('交易金额', new Div('saleMoney')));
+ $row->column(4, new Box('今日订单', new Div('todayOrders'))); // 今日订单
+ $row->column(4, new Box('近期订单量', new Div('weekSites'))); // 近期订单量
+ $row->column(4, new Box('交易金额', new Div('saleMoney'))); // 交易金额
- $allSites = compact('todaySite', 'weekSites', 'monthSites');
- $row->column(12, view('admin.chars.echart', $allSites));
+ // 将所有统计数据传递给视图
+ $allSites = compact('todaySite', 'weekSites', 'monthSites'); // 打包统计数据
+ $row->column(12, view('admin.chars.echart', $allSites)); // 渲染 ECharts 视图并传递数据
});
}
-
/**
- * 自定义 404 页面
+ * 自定义 404 页面.
*
* @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
*/
public function noFound()
{
- return redirect('admin');
+ return redirect('admin'); // 重定向到管理员首页
}
}
diff --git a/app/Admin/Controllers/LevelController.php b/app/Admin/Controllers/LevelController.php
index 8bb210b..013d767 100644
--- a/app/Admin/Controllers/LevelController.php
+++ b/app/Admin/Controllers/LevelController.php
@@ -2,191 +2,191 @@
namespace App\Admin\Controllers;
-use App\Models\Level;
-use App\Http\Controllers\Controller;
-use Encore\Admin\Controllers\HasResourceActions;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Layout\Content;
-use Encore\Admin\Show;
+use App\Models\Level; // 引入 Level 模型
+use App\Http\Controllers\Controller; // 引入基础控制器
+use Encore\Admin\Controllers\HasResourceActions; // 引入资源控制器特性
+use Encore\Admin\Form; // 引入表单构建器
+use Encore\Admin\Grid; // 引入网格构建器
+use Encore\Admin\Layout\Content; // 引入内容布局
+use Encore\Admin\Show; // 引入展示构建器
class LevelController extends Controller
{
- use HasResourceActions;
+ use HasResourceActions; // 使用资源控制器特性，使得该控制器支持资源操作
/**
- * Index interface.
+ * 显示列表页面.
*
- * @param Content $content
- * @return Content
+ * @param Content $content 内容布局实例
+ * @return Content 返回内容布局
*/
public function index(Content $content)
{
return $content
- ->header('列表')
- ->description('')
- ->body($this->grid());
+ ->header('列表') // 设置页面标题
+ ->description('') // 设置页面描述（可选）
+ ->body($this->grid()); // 渲染网格
}
/**
- * Show interface.
+ * 显示详情页面.
*
- * @param mixed $id
- * @param Content $content
- * @return Content
+ * @param mixed $id 资源 ID
+ * @param Content $content 内容布局实例
+ * @return Content 返回内容布局
*/
public function show($id, Content $content)
{
return $content
- ->header('详情')
- ->description('')
- ->body($this->detail($id));
+ ->header('详情') // 设置页面标题
+ ->description('') // 设置页面描述（可选）
+ ->body($this->detail($id)); // 渲染详情视图
}
/**
- * Edit interface.
+ * 显示编辑页面.
*
- * @param mixed $id
- * @param Content $content
- * @return Content
+ * @param mixed $id 资源 ID
+ * @param Content $content 内容布局实例
+ * @return Content 返回内容布局
*/
public function edit($id, Content $content)
{
return $content
- ->header('Edit')
- ->description('')
- ->body($this->form()->edit($id));
+ ->header('编辑') // 设置页面标题
+ ->description('') // 设置页面描述（可选）
+ ->body($this->form()->edit($id)); // 渲染编辑表单
}
/**
- * Create interface.
+ * 显示创建页面.
*
- * @param Content $content
- * @return Content
+ * @param Content $content 内容布局实例
+ * @return Content 返回内容布局
*/
public function create(Content $content)
{
return $content
- ->header('新建')
- ->description('')
- ->body($this->form());
+ ->header('新建') // 设置页面标题
+ ->description('') // 设置页面描述（可选）
+ ->body($this->form()); // 渲染创建表单
}
/**
- * Make a grid builder.
+ * 创建网格构建器.
*
- * @return Grid
+ * @return Grid 返回网格实例
*/
protected function grid()
{
- $grid = new Grid(new Level);
+ $grid = new Grid(new Level); // 创建新的网格实例，基于 Level 模型
- $grid->model()->orderBy('min_score', 'desc');
-
-
- $grid->column('id', 'id');
- $grid->column('icon', '图标')->image('', 90, 90);
- $grid->column('name', '名字')->editable();
- $grid->column('level', '等级');
- $grid->column('min_score', '分阶');
- $grid->column('created_at', '创建时间');
- $grid->column('updated_at', '更新时间');
+ $grid->model()->orderBy('min_score', 'desc'); // 按 min_score 降序排列
+ // 定义网格的列
+ $grid->column('id', 'ID'); // 显示 ID 列
+ $grid->column('icon', '图标')->image('', 90, 90); // 显示图标列，设置图像大小
+ $grid->column('name', '名字')->editable(); // 显示名字列，可编辑
+ $grid->column('level', '等级'); // 显示等级列
+ $grid->column('min_score', '分阶'); // 显示分阶列
+ $grid->column('created_at', '创建时间'); // 显示创建时间列
+ $grid->column('updated_at', '更新时间'); // 显示更新时间列
+ // 自定义操作按钮
$grid->actions(function (Grid\Displayers\Actions $actions) {
-
- $level = $actions->row;
- if (! $level->can_delete) {
- $actions->disableDelete();
+ $level = $actions->row; // 获取当前行的数据
+ if (!$level->can_delete) { // 检查是否可以删除
+ $actions->disableDelete(); // 禁用删除按钮
}
});
- return $grid;
+ return $grid; // 返回构建好的网格
}
/**
- * Make a show builder.
+ * 创建详情构建器.
*
- * @param mixed $id
- * @return Show
+ * @param mixed $id 资源 ID
+ * @return Show 返回展示实例
*/
protected function detail($id)
{
- $show = new Show(Level::findOrFail($id));
-
- $show->field('id', 'id');
- $show->field('icon', '图标')->image();
- $show->field('name', '名字');
- $show->field('level', '等级');
- $show->field('min_score', '分阶');
- $show->field('created_at', '创建时间');
- $show->field('updated_at', '更新时间');
-
- return $show;
+ $show = new Show(Level::findOrFail($id)); // 查找并显示指定 ID 的 Level 记录
+
+ // 定义详情展示的字段
+ $show->field('id', 'ID'); // 显示 ID
+ $show->field('icon', '图标')->image(); // 显示图标
+ $show->field('name', '名字'); // 显示名字
+ $show->field('level', '等级'); // 显示等级
+ $show->field('min_score', '分阶'); // 显示分阶
+ $show->field('created_at', '创建时间'); // 显示创建时间
+ $show->field('updated_at', '更新时间'); // 显示更新时间
+
+ return $show; // 返回构建好的详情视图
}
/**
- * Make a form builder.
+ * 创建表单构建器.
*
- * @return Form
+ * @return Form 返回表单实例
*/
protected function form()
{
- $form = new Form(new Level);
+ $form = new Form(new Level); // 创建新的表单实例，基于 Level 模型
+ // 添加图标字段，设置唯一名称
$icon = $form->image('icon', '图标')->uniqueName();
- if (! windows_os()) {
- $icon->resize(160, 160);;
+ if (!windows_os()) { // 如果不是 Windows 系统
+ $icon->resize(160, 160); // 调整图标大小
}
- $form->text('name', '名字');
- $form->number('level', '等级');
- $form->number('min_score', '积分');
-
+ // 添加其他字段
+ $form->text('name', '名字'); // 添加名字字段
+ $form->number('level', '等级'); // 添加等级字段
+ $form->number('min_score', '积分'); // 添加积分字段
+
+ // 添加保存前的钩子
$form->saving(function (Form $form) {
-
- if (app()->environment('dev')) {
-
- admin_toastr('开发环境不允许操作', 'error');
- return back()->withInput();
+ if (app()->environment('dev')) { // 如果当前环境是开发环境
+ admin_toastr('开发环境不允许操作', 'error'); // 显示错误提示
+ return back()->withInput(); // 返回并保留输入
}
});
-
- return $form;
+ return $form; // 返回构建好的表单
}
/**
- * Remove the specified resource from storage.
+ * 删除指定资源.
*
- * @param int $id
- * @return \Illuminate\Http\Response
+ * @param int $id 资源 ID
+ * @return \Illuminate\Http\Response 返回响应
* @throws \Exception
*/
public function destroy($id)
{
- $level = Level::query()->findOrFail($id);
-
- if (! $level->can_delete) {
+ $level = Level::query()->findOrFail($id); // 查找指定 ID 的 Level 记录
+ if (!$level->can_delete) { // 检查是否可以删除
return response()->json([
'status' => false,
- 'message' => '这个等级不允许删除',
+ 'message' => '这个等级不允许删除', // 返回错误消息
]);
}
+ // 尝试删除记录
if ($level->delete()) {
$data = [
'status' => true,
- 'message' => trans('admin.delete_succeeded'),
+ 'message' => trans('admin.delete_succeeded'), // 返回成功消息
];
} else {
$data = [
'status' => false,
- 'message' => trans('admin.delete_failed'),
+ 'message' => trans('admin.delete_failed'), // 返回失败消息
];
}
- return response()->json($data);
+ return response()->json($data); // 返回 JSON 响应
}
}
diff --git a/app/Admin/Controllers/OrderController.php b/app/Admin/Controllers/OrderController.php
index 4753203..fb0ad57 100644
--- a/app/Admin/Controllers/OrderController.php
+++ b/app/Admin/Controllers/OrderController.php
@@ -2,266 +2,242 @@
namespace App\Admin\Controllers;
-use App\Admin\Actions\Post\OrderReceivedAction;
-use App\Admin\Actions\Post\OrderRefundAction;
-use App\Admin\Actions\Post\OrderShipAction;
-use App\Admin\Extensions\ReceivedButton;
-use App\Admin\Extensions\ShipButton;
-use App\Admin\Transforms\OrderDetailTransform;
-use App\Admin\Transforms\OrderPayTypeTransform;
-use App\Admin\Transforms\OrderShipStatusTransform;
-use App\Admin\Transforms\OrderStatusTransform;
-use App\Admin\Transforms\OrderTypeTransform;
-use App\Admin\Transforms\YesNoTransform;
-use App\Enums\OrderShipStatusEnum;
-use App\Enums\OrderStatusEnum;
-use App\Http\Controllers\Controller;
-use App\Models\Order;
-use App\Models\User;
-use Encore\Admin\Controllers\HasResourceActions;
-use Encore\Admin\Facades\Admin;
-use Encore\Admin\Grid;
-use Encore\Admin\Grid\Displayers\Actions;
-use Encore\Admin\Grid\Filter;
-use Encore\Admin\Layout\Content;
-use Encore\Admin\Show;
-use Encore\Admin\Widgets\Form;
-use Illuminate\Http\Request;
-use Illuminate\Support\Facades\DB;
-use Yansongda\Pay\Pay;
+use App\Admin\Actions\Post\OrderReceivedAction; // 引入订单已收货操作
+use App\Admin\Actions\Post\OrderRefundAction; // 引入订单退款操作
+use App\Admin\Actions\Post\OrderShipAction; // 引入订单发货操作
+use App\Admin\Extensions\ReceivedButton; // 引入收货按钮扩展
+use App\Admin\Extensions\ShipButton; // 引入发货按钮扩展
+use App\Admin\Transforms\OrderDetailTransform; // 引入订单详情转换器
+use App\Admin\Transforms\OrderPayTypeTransform; // 引入订单支付方式转换器
+use App\Admin\Transforms\OrderShipStatusTransform; // 引入订单物流状态转换器
+use App\Admin\Transforms\OrderStatusTransform; // 引入订单状态转换器
+use App\Admin\Transforms\OrderTypeTransform; // 引入订单类型转换器
+use App\Admin\Transforms\YesNoTransform; // 引入是/否转换器
+use App\Enums\OrderShipStatusEnum; // 引入订单物流状态枚举
+use App\Enums\OrderStatusEnum; // 引入订单状态枚举
+use App\Http\Controllers\Controller; // 引入基础控制器
+use App\Models\Order; // 引入订单模型
+use App\Models\User; // 引入用户模型
+use Encore\Admin\Controllers\HasResourceActions; // 引入资源控制器特性
+use Encore\Admin\Facades\Admin; // 引入 Admin 门面
+use Encore\Admin\Grid; // 引入网格构建器
+use Encore\Admin\Grid\Displayers\Actions; // 引入操作显示器
+use Encore\Admin\Grid\Filter; // 引入过滤器
+use Encore\Admin\Layout\Content; // 引入内容布局
+use Encore\Admin\Show; // 引入展示构建器
+use Encore\Admin\Widgets\Form; // 引入表单构建器
+use Illuminate\Http\Request; // 引入请求类
+use Illuminate\Support\Facades\DB; // 引入数据库门面
+use Yansongda\Pay\Pay; // 引入支付处理类
class OrderController extends Controller
{
- use HasResourceActions;
+ use HasResourceActions; // 使用资源控制器特性，使该控制器支持资源操作
/**
- * Index interface.
+ * 显示订单列表页面.
*
- * @param Content $content
- * @return Content
+ * @param Content $content 内容布局实例
+ * @return Content 返回内容布局
*/
public function index(Content $content)
{
return $content
- ->header('订单列表')
- ->description('')
- ->body($this->grid());
+ ->header('订单列表') // 设置页面标题
+ ->description('') // 设置页面描述（可选）
+ ->body($this->grid()); // 渲染网格
}
/**
- * Show interface.
+ * 显示订单详情页面.
*
- * @param mixed $id
- * @param Content $content
- * @return Content
+ * @param mixed $id 订单 ID
+ * @param Content $content 内容布局实例
+ * @return Content 返回内容布局
*/
public function show($id, Content $content)
{
return $content
- ->header('详情')
- ->description('')
- ->body($this->detail($id));
+ ->header('详情') // 设置页面标题
+ ->description('') // 设置页面描述（可选）
+ ->body($this->detail($id)); // 渲染订单详情
}
-
-
-
/**
- * Make a grid builder.
+ * 创建网格构建器.
*
- * @return Grid
+ * @return Grid 返回网格实例
*/
protected function grid()
{
- $grid = new Grid(new Order);
-
- $grid->model()->withTrashed()->latest();
-
- $grid->column('id');
- $grid->column('no', '流水号');
- $grid->column('user.name', '用户');
- $grid->column('origin_amount', '订单原价');
- $grid->column('post_amount', '邮费');
- $grid->column('coupon_amount', '优惠');
- $grid->column('amount', '总价');
+ $grid = new Grid(new Order); // 创建新的网格实例，基于 Order 模型
+
+ $grid->model()->withTrashed()->latest(); // 显示软删除的记录，并按创建时间降序排列
+
+ // 定义网格的列
+ $grid->column('id'); // 显示订单 ID
+ $grid->column('no', '流水号'); // 显示订单流水号
+ $grid->column('user.name', '用户'); // 显示用户名称
+ $grid->column('origin_amount', '订单原价'); // 显示订单原价
+ $grid->column('post_amount', '邮费'); // 显示邮费
+ $grid->column('coupon_amount', '优惠'); // 显示优惠金额
+ $grid->column('amount', '总价'); // 显示总价
$grid->column('status', '状态')->display(function ($status) {
-
- // 如果订单是付款, 那么就修改为物流状态
+ // 如果订单已付款，显示物流状态
if ($status == OrderStatusEnum::PAID) {
-
- return OrderShipStatusTransform::trans($this->ship_status);
+ return OrderShipStatusTransform::trans($this->ship_status); // 转换并显示物流状态
}
-
- return OrderStatusTransform::trans($status);
+ return OrderStatusTransform::trans($status); // 转换并显示订单状态
});
$grid->column('type', '订单类型')->display(function ($type) {
-
- return OrderTypeTransform::trans($type);
+ return OrderTypeTransform::trans($type); // 转换并显示订单类型
});
-
$grid->column('pay_type', '支付方式')->display(function ($type) {
-
- return OrderPayTypeTransform::trans($type);
+ return OrderPayTypeTransform::trans($type); // 转换并显示支付方式
});
- $grid->column('pay_no', '支付流水号');
- $grid->column('paid_at', '支付时间');
- $grid->column('consignee_name', '收货人姓名');
- $grid->column('consignee_phone', '收货人手机');
- $grid->column('created_at', '创建时间');
+ $grid->column('pay_no', '支付流水号'); // 显示支付流水号
+ $grid->column('paid_at', '支付时间'); // 显示支付时间
+ $grid->column('consignee_name', '收货人姓名'); // 显示收货人姓名
+ $grid->column('consignee_phone', '收货人手机'); // 显示收货人手机
+ $grid->column('created_at', '创建时间'); // 显示创建时间
+ // 禁用行选择器和创建按钮
$grid->disableRowSelector();
$grid->disableCreateButton();
- $grid->actions(function (Grid\Displayers\DropdownActions $actions) {
-
- /**
- * @var $order Order
- */
- $order = $actions->row;
+ // 自定义操作按钮
+ $grid->actions(function (Grid\Displayers\DropdownActions $actions) {
+ $order = $actions->row; // 获取当前行的订单数据
- // 如果出现了申请,显示可以退款按钮
+ // 根据订单状态添加相应的操作按钮
if ($order->status == OrderStatusEnum::APPLY_REFUND) {
-
- $actions->add(new OrderRefundAction());
+ $actions->add(new OrderRefundAction()); // 添加退款操作按钮
} elseif ($order->status == OrderStatusEnum::PAID) {
-
if ($order->ship_status == OrderShipStatusEnum::PENDING) {
-
- $actions->add(new OrderShipAction());
+ $actions->add(new OrderShipAction()); // 添加发货操作按钮
} elseif ($order->ship_status == OrderShipStatusEnum::DELIVERED) {
-
- $actions->add(new OrderReceivedAction());
+ $actions->add(new OrderReceivedAction()); // 添加确认收货操作按钮
}
-
}
- $actions->disableEdit();
+ $actions->disableEdit(); // 禁用编辑按钮
});
+ // 添加过滤器
$grid->filter(function (Filter $filter) {
-
- $filter->disableIdFilter();
- $filter->like('no', '流水号');
+ $filter->disableIdFilter(); // 禁用 ID 过滤
+ $filter->like('no', '流水号'); // 添加流水号模糊查询
$filter->where(function ($query) {
-
+ // 根据用户名称查询用户 ID
$users = User::query()->where('name', 'like', "%{$this->input}%")->pluck('id');
- $query->whereIn('user_id', $users->all());
+ $query->whereIn('user_id', $users->all()); // 根据用户 ID 查询订单
}, '用户');
});
- return $grid;
+ return $grid; // 返回构建好的网格
}
/**
- * Make a show builder.
+ * 创建订单详情展示构建器.
*
- * @param mixed $id
- * @return Show
+ * @param mixed $id 订单 ID
+ * @return Show 返回展示实例
*/
protected function detail($id)
{
- $show = new Show(Order::query()->withTrashed()->findOrFail($id));
+ $show = new Show(Order::query()->withTrashed()->findOrFail($id)); // 查找并显示指定 ID 的订单记录
- $show->field('id');
- $show->field('no', '流水号');
+ // 定义详情展示的字段
+ $show->field('id'); // 显示订单 ID
+ $show->field('no', '流水号'); // 显示订单流水号
$show->field('user', '用户')->as(function ($user) {
- return optional($user)->name;
+ return optional($user)->name; // 显示用户名称
});
+ $show->divider(); // 添加分隔线
- $show->divider();
-
- $show->field('amount', '总计');
+ $show->field('amount', '总计'); // 显示订单总计
$show->field('status', '状态')->as(function ($status) {
-
- // 如果订单是付款, 那么就修改为物流状态
+ // 如果订单已付款，显示物流状态
if ($status == OrderStatusEnum::PAID) {
-
- return OrderShipStatusTransform::trans($this->ship_status);
+ return OrderShipStatusTransform::trans($this->ship_status); // 转换并显示物流状态
}
-
- return OrderStatusTransform::trans($status);
+ return OrderStatusTransform::trans($status); // 转换并显示订单状态
});
$show->field('type', '订单类型')->as(function ($type) {
-
- return OrderTypeTransform::trans($type);
+ return OrderTypeTransform::trans($type); // 转换并显示订单类型
});
- $show->divider();
+ $show->divider(); // 添加分隔线
- $show->field('express_company', '物流公司');
- $show->field('express_no', '物流单号');
+ $show->field('express_company', '物流公司'); // 显示物流公司
+ $show->field('express_no', '物流单号'); // 显示物流单号
- $show->divider();
+ $show->divider(); // 添加分隔线
- $show->field('consignee_name', '收货人');
- $show->field('consignee_phone', '收货人手机');
- $show->field('consignee_address', '收货地址');
+ $show->field('consignee_name', '收货人'); // 显示收货人姓名
+ $show->field('consignee_phone', '收货人手机'); // 显示收货人手机
+ $show->field('consignee_address', '收货地址'); // 显示收货地址
- $show->divider();
+ $show->divider(); // 添加分隔线
$show->field('pay_type', '支付类型')->as(function ($type) {
-
- return OrderPayTypeTransform::trans($type);
+ return OrderPayTypeTransform::trans($type); // 转换并显示支付类型
});
- $show->field('refund_reason', '退款理由');
- $show->field('pay_trade_no', '退款单号');
- $show->field('pay_no', '支付单号');
- $show->field('paid_at', '支付时间');
- $show->field('created_at', '创建时间');
- $show->field('updated_at', '修改时间');
-
- // 详情
+ $show->field('refund_reason', '退款理由'); // 显示退款理由
+ $show->field('pay_trade_no', '退款单号'); // 显示退款单号
+ $show->field('pay_no', '支付单号'); // 显示支付单号
+ $show->field('paid_at', '支付时间'); // 显示支付时间
+ $show->field('created_at', '创建时间'); // 显示创建时间
+ $show->field('updated_at', '修改时间'); // 显示修改时间
+
+ // 显示订单详情
$show->details('详情', function (Grid $details) {
-
- $details->column('id');
- $details->column('product.name', '商品名字');
- $details->column('price', '单价');
- $details->column('number', '数量');
+ $details->column('id'); // 显示订单详情 ID
+ $details->column('product.name', '商品名字'); // 显示商品名称
+ $details->column('price', '单价'); // 显示单价
+ $details->column('number', '数量'); // 显示数量
$details->column('is_commented', '是否评论')->display(function ($is) {
-
- return YesNoTransform::trans($is);
+ return YesNoTransform::trans($is); // 转换并显示是否评论
});
- $details->column('total', '小计');
+ $details->column('total', '小计'); // 显示小计
+ // 禁用行选择器、创建按钮、过滤器和操作按钮
$details->disableRowSelector();
$details->disableCreateButton();
$details->disableFilter();
$details->disableActions();
});
- return $show;
+ return $show; // 返回构建好的详情视图
}
/**
- * 后台删除订单就是真的删除了
- * @param $id
- * @return \Illuminate\Http\JsonResponse
+ * 删除指定订单.
+ *
+ * @param mixed $id 订单 ID
+ * @return \Illuminate\Http\JsonResponse 返回 JSON 响应
*/
public function destroy($id)
{
try {
-
DB::transaction(function () use ($id) {
- /**
- * @var $order Order
- */
- $order = Order::withTrashed()->findOrFail($id);
- $order->details()->delete();
- $order->forceDelete();
+ $order = Order::withTrashed()->findOrFail($id); // 查找指定 ID 的订单
+ $order->details()->delete(); // 删除订单详情
+ $order->forceDelete(); // 强制删除订单
});
$data = [
'status' => true,
- 'message' => trans('admin.delete_succeeded'),
+ 'message' => trans('admin.delete_succeeded'), // 返回成功消息
];
} catch (\Throwable $e) {
$data = [
'status' => false,
- 'message' => trans('admin.delete_failed') . $e->getMessage(),
+ 'message' => trans('admin.delete_failed') . $e->getMessage(), // 返回失败消息及错误信息
];
}
- return response()->json($data);
+ return response()->json($data); // 返回 JSON 响应
}
}
diff --git a/app/Admin/Controllers/ProductController.php b/app/Admin/Controllers/ProductController.php
index 3eaa888..401c6b2 100644
--- a/app/Admin/Controllers/ProductController.php
+++ b/app/Admin/Controllers/ProductController.php
@@ -2,248 +2,241 @@
namespace App\Admin\Controllers;
-
-use App\Admin\Actions\Post\DividerAction;
-use App\Admin\Actions\Post\ForceDeleteProductAction;
-use App\Admin\Actions\Post\ProductStatusAction;
-use App\Admin\Transforms\YesNoTransform;
-use App\Http\Controllers\Controller;
-use App\Models\Category;
-use App\Models\Product;
-use Encore\Admin\Controllers\HasResourceActions;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Layout\Content;
-use Encore\Admin\Show;
+use App\Admin\Actions\Post\DividerAction; // 引入分隔符操作
+use App\Admin\Actions\Post\ForceDeleteProductAction; // 引入强制删除商品操作
+use App\Admin\Actions\Post\ProductStatusAction; // 引入商品状态操作
+use App\Admin\Transforms\YesNoTransform; // 引入是/否转换器
+use App\Http\Controllers\Controller; // 引入基础控制器
+use App\Models\Category; // 引入分类模型
+use App\Models\Product; // 引入商品模型
+use Encore\Admin\Controllers\HasResourceActions; // 引入资源控制器特性
+use Encore\Admin\Form; // 引入表单构建器
+use Encore\Admin\Grid; // 引入网格构建器
+use Encore\Admin\Layout\Content; // 引入内容布局
+use Encore\Admin\Show; // 引入展示构建器
class ProductController extends Controller
{
- use HasResourceActions;
+ use HasResourceActions; // 使用资源控制器特性，使该控制器支持资源操作
/**
- * Index interface.
+ * 显示商品列表界面.
*
- * @param Content $content
- * @return Content
+ * @param Content $content 内容布局实例
+ * @return Content 返回内容布局
*/
public function index(Content $content)
{
return $content
- ->header('商品列表')
- ->description('')
- ->body($this->grid());
+ ->header('商品列表') // 设置页面标题
+ ->description('') // 设置页面描述（可选）
+ ->body($this->grid()); // 渲染商品网格
}
/**
- * Show interface.
+ * 显示商品详情界面.
*
- * @param mixed $id
- * @param Content $content
- * @return Content
+ * @param mixed $id 商品 ID
+ * @param Content $content 内容布局实例
+ * @return Content 返回内容布局
*/
public function show($id, Content $content)
{
return $content
- ->header('详情')
- ->description('')
- ->body($this->detail($id));
+ ->header('详情') // 设置页面标题
+ ->description('') // 设置页面描述（可选）
+ ->body($this->detail($id)); // 渲染商品详情
}
/**
- * Edit interface.
+ * 显示编辑商品界面.
*
- * @param mixed $id
- * @param Content $content
- * @return Content
+ * @param mixed $id 商品 ID
+ * @param Content $content 内容布局实例
+ * @return Content 返回内容布局
*/
public function edit($id, Content $content)
{
return $content
- ->header('编辑')
- ->description('')
- ->body($this->form()->edit($id));
+ ->header('编辑') // 设置页面标题
+ ->description('') // 设置页面描述（可选）
+ ->body($this->form()->edit($id)); // 渲染编辑表单
}
/**
- * Create interface.
+ * 显示添加商品界面.
*
- * @param Content $content
- * @return Content
+ * @param Content $content 内容布局实例
+ * @return Content 返回内容布局
*/
public function create(Content $content)
{
return $content
- ->header('添加商品')
- ->description('为你的商城添加一个商品')
- ->body($this->form());
+ ->header('添加商品') // 设置页面标题
+ ->description('为你的商城添加一个商品') // 设置页面描述
+ ->body($this->form()); // 渲染添加商品表单
}
/**
- * Make a grid builder.
+ * 创建商品网格构建器.
*
- * @return Grid
+ * @return Grid 返回网格实例
*/
protected function grid()
{
- $grid = new Grid(new Product);
+ $grid = new Grid(new Product); // 创建新的网格实例，基于 Product 模型
- $grid->model()->withTrashed()->latest();
+ $grid->model()->withTrashed()->latest(); // 显示软删除的记录，并按创建时间降序排列
- $grid->column('id');
- $grid->column('category.title', '商品类别');
+ // 定义网格的列
+ $grid->column('id'); // 显示商品 ID
+ $grid->column('category.title', '商品类别'); // 显示商品类别
$grid->column('name', '商品名')->display(function ($name) {
- return str_limit($name, 30);
+ return str_limit($name, 30); // 显示商品名，限制字符数为 30
});
- $grid->column('thumb', '首图')->image('', 50, 50);
+ $grid->column('thumb', '首图')->image('', 50, 50); // 显示商品缩略图
$grid->column('price', '价格')->display(function ($price) {
-
- return $price . '/' . $this->original_price;
+ return $price . '/' . $this->original_price; // 显示销售价和原价
});
- $grid->column('view_count', '浏览次数')->sortable();
- $grid->column('sale_count', '售出数量')->sortable();
- $grid->column('count', '库存量')->sortable();
+ $grid->column('view_count', '浏览次数')->sortable(); // 显示并支持排序的浏览次数
+ $grid->column('sale_count', '售出数量')->sortable(); // 显示并支持排序的售出数量
+ $grid->column('count', '库存量')->sortable(); // 显示并支持排序的库存量
$grid->column('deleted_at', '是否上架')->display(function ($isAlive) {
-
- return YesNoTransform::trans(is_null($isAlive));
+ return YesNoTransform::trans(is_null($isAlive)); // 转换并显示是否上架
});
- $grid->column('created_at', '创建时间');
- $grid->column('updated_at', '修改时间');
-
+ $grid->column('created_at', '创建时间'); // 显示创建时间
+ $grid->column('updated_at', '修改时间'); // 显示修改时间
// 查询过滤
$grid->filter(function (Grid\Filter $filter) {
-
$categories = Category::query()
->orderBy('order')
->latest()
->pluck('title', 'id')
- ->all();
+ ->all(); // 获取分类列表
- $filter->disableIdFilter();
- $filter->equal('category_id', '分类')->select($categories);
- $filter->equal('id', 'ID');
- $filter->equal('uuid', 'UUID');
- $filter->like('name', '商品名字');
+ $filter->disableIdFilter(); // 禁用 ID 过滤
+ $filter->equal('category_id', '分类')->select($categories); // 分类过滤
+ $filter->equal('id', 'ID'); // ID 过滤
+ $filter->equal('uuid', 'UUID'); // UUID 过滤
+ $filter->like('name', '商品名字'); // 商品名字模糊查询
});
-
- // 增加一个上架，下架功能
+ // 增加一个上架/下架功能
$grid->actions(function (Grid\Displayers\DropdownActions $actions) {
+ $actions->disableDelete(); // 禁用删除按钮
+ $actions->add(new ForceDeleteProductAction()); // 添加强制删除商品操作
+ $actions->add(new DividerAction()); // 添加分隔符
+ // 根据商品是否上架设置操作按钮名称
+ $name = is_null($actions->row->deleted_at) ? "下架" : "上架";
+ $statusAction = new ProductStatusAction(); // 创建商品状态操作
+ $statusAction->setName($name); // 设置操作按钮名称
- $actions->disableDelete();
- $actions->add(new ForceDeleteProductAction());
- $actions->add(new DividerAction());
-
- $name = is_null($actions->row->deleted_at) ?
- "下架":
- "上架";
-
- $statusAction = new ProductStatusAction();
- $statusAction->setName($name);
-
- $actions->add($statusAction);
+ $actions->add($statusAction); // 添加状态操作按钮
});
- return $grid;
+ return $grid; // 返回构建好的网格
}
/**
- * Make a show builder.
+ * 创建商品详情展示构建器.
*
- * @param mixed $id
- * @return Show
+ * @param mixed $id 商品 ID
+ * @return Show 返回展示实例
*/
protected function detail($id)
{
- $show = new Show(Product::query()->withTrashed()->findOrFail($id));
-
- $show->field('id');
- $show->field('category.title', '商品类别');
- $show->field('name', '商品名');
- $show->field('title', '卖点');
- $show->field('thumb', '缩略图')->image();
+ $show = new Show(Product::query()->withTrashed()->findOrFail($id)); // 查找并显示指定 ID 的商品记录
+
+ // 定义详情展示的字段
+ $show->field('id'); // 显示商品 ID
+ $show->field('category.title', '商品类别'); // 显示商品类别
+ $show->field('name', '商品名'); // 显示商品名
+ $show->field('title', '卖点'); // 显示商品卖点
+ $show->field('thumb', '缩略图')->image(); // 显示商品缩略图
$show->field('price', '价格')->as(function ($price) {
- return $price . '/' . $this->original_price;
+ return $price . '/' . $this->original_price; // 显示销售价和原价
});
- $show->field('view_count', '浏览次数');
- $show->field('sale_count', '售出数量');
- $show->field('count', '库存量');
+ $show->field('view_count', '浏览次数'); // 显示浏览次数
+ $show->field('sale_count', '售出数量'); // 显示售出数量
+ $show->field('count', '库存量'); // 显示库存量
$show->field('deleted_at', '是否上架')->as(function ($isAlive) {
- return is_null($isAlive) ? '上架' : '下架';
+ return is_null($isAlive) ? '上架' : '下架'; // 显示商品是否上架
});
- $show->field('created_at', '创建时间');
- $show->field('updated_at', '修改时间');
+ $show->field('created_at', '创建时间'); // 显示创建时间
+ $show->field('updated_at', '修改时间'); // 显示修改时间
-
- return $show;
+ return $show; // 返回构建好的详情视图
}
/**
- * Make a form builder.
+ * 创建商品表单构建器.
*
- * @return Form
+ * @return Form 返回表单实例
*/
protected function form()
{
- $form = new Form(new Product);
-
+ $form = new Form(new Product); // 创建新的表单实例，基于 Product 模型
- $form->select('category_id', '类别')->options(Category::selectOrderAll())->rules('required|exists:categories,id');
+ // 定义表单字段
+ $form->select('category_id', '类别')->options(Category::selectOrderAll())->rules('required|exists:categories,id'); // 选择商品类别
$form->text('name', '商品名字')->rules(function (Form $form) {
-
- $rules = 'required|max:50|unique:products,name';
+ $rules = 'required|max:50|unique:products,name'; // 商品名字的验证规则
if ($id = $form->model()->id) {
- $rules .= ',' . $id;
+ $rules .= ',' . $id; // 在编辑时排除当前商品
}
-
- return $rules;
+ return $rules; // 返回验证规则
});
- $form->textarea('title', '卖点')->rules('required|max:199');
- $form->currency('price', '销售价')->symbol('$')->rules('required|numeric');
- $form->currency('original_price', '原价')->symbol('$')->rules('required|numeric');
- $form->number('count', '库存量')->rules('required|integer|min:0');
+ $form->textarea('title', '卖点')->rules('required|max:199'); // 商品卖点
+ $form->currency('price', '销售价')->symbol('￥')->rules('required|numeric'); // 商品销售价
+ $form->currency('original_price', '原价')->symbol('￥')->rules('required|numeric'); // 商品原价
+ $form->number('count', '库存量')->rules('required|integer|min:0'); // 商品库存量
+
+ $form->image('thumb', '缩略图')->uniqueName()->move('products/thumb')->rules('required'); // 商品缩略图
+ $form->multipleImage('pictures', '轮播图')->uniqueName()->move('products/lists'); // 商品轮播图
- $form->image('thumb', '缩略图')->uniqueName()->move('products/thumb')->rules('required');
- $form->multipleImage('pictures', '轮播图')->uniqueName()->move('products/lists');
+ $form->editor('detail.content', '详情')->rules('required'); // 商品详情
- $form->editor('detail.content', '详情')->rules('required');
-
+ // 保存前的钩子
$form->saving(function (Form $form) {
-
- if (app()->environment('dev')) {
-
- admin_toastr('开发环境不允许操作', 'error');
- return back()->withInput();
+ if (app()->environment('dev')) { // 在开发环境中禁止操作
+ admin_toastr('开发环境不允许操作', 'error'); // 显示错误提示
+ return back()->withInput(); // 返回输入
}
});
- return $form;
+ return $form; // 返回构建好的表单
}
-
+ /**
+ * 删除指定商品.
+ *
+ * @param mixed $id 商品 ID
+ * @return \Illuminate\Http\JsonResponse 返回 JSON 响应
+ */
public function destroy($id)
{
- $product = Product::query()->withTrashed()->findOrFail($id);
-
- if (app()->environment('dev')) {
-
- admin_toastr('开发环境不允许操作', 'error');
- return back()->withInput();
+ $product = Product::query()->withTrashed()->findOrFail($id); // 查找指定 ID 的商品
+
+ if (app()->environment('dev')) { // 在开发环境中禁止操作
+ admin_toastr('开发环境不允许操作', 'error'); // 显示错误提示
+ return back()->withInput(); // 返回输入
}
+ // 尝试强制删除商品
if ($product->forceDelete()) {
$data = [
'status' => true,
- 'message' => trans('admin.delete_succeeded'),
+ 'message' => trans('admin.delete_succeeded'), // 返回成功消息
];
} else {
$data = [
'status' => false,
- 'message' => trans('admin.delete_failed'),
+ 'message' => trans('admin.delete_failed'), // 返回失败消息
];
}
- return response()->json($data);
+ return response()->json($data); // 返回 JSON 响应
}
}
diff --git a/app/Admin/Controllers/ProductLikeController.php b/app/Admin/Controllers/ProductLikeController.php
index bacb031..00268fe 100644
--- a/app/Admin/Controllers/ProductLikeController.php
+++ b/app/Admin/Controllers/ProductLikeController.php
@@ -2,58 +2,59 @@
namespace App\Admin\Controllers;
-use App\Models\ProductHasUser;
-use Encore\Admin\Controllers\AdminController;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Show;
+use App\Models\ProductHasUser; // 引入用户与商品关联模型
+use Encore\Admin\Controllers\AdminController; // 引入管理控制器基类
+use Encore\Admin\Form; // 引入表单构建器
+use Encore\Admin\Grid; // 引入网格构建器
+use Encore\Admin\Show; // 引入展示构建器
class ProductLikeController extends AdminController
{
/**
- * Title for current resource.
+ * 当前资源的标题.
*
* @var string
*/
- protected $title = '商品喜好';
+ protected $title = '商品喜好'; // 设置资源的标题为“商品喜好”
/**
- * Make a grid builder.
+ * 创建网格构建器.
*
- * @return Grid
+ * @return Grid 返回网格实例
*/
protected function grid()
{
- $grid = new Grid(new ProductHasUser);
+ $grid = new Grid(new ProductHasUser); // 创建新的网格实例，基于 ProductHasUser 模型
- $grid->model()->latest();
+ $grid->model()->latest(); // 按照创建时间降序排列数据
- $grid->column('user_id', __('User id'));
- $grid->column('product_id', __('Product id'));
+ // 定义网格的列
+ $grid->column('user_id', __('User id')); // 显示用户 ID
+ $grid->column('product_id', __('Product id')); // 显示商品 ID
- $grid->column('user.name', '用户');
- $grid->column('created_at', '收藏时间');
- $grid->column('product.name', '商品');
+ $grid->column('user.name', '用户'); // 显示用户姓名
+ $grid->column('created_at', '收藏时间'); // 显示商品收藏的时间
+ $grid->column('product.name', '商品'); // 显示商品名称
$grid->column('product.price', '价格')->display(function ($price) {
-
- return $price . '/' . $this->product['original_price'];
+ // 显示商品价格，并附加原价
+ return $price . '/' . $this->product['original_price']; // 返回格式化的价格
});
- $grid->column('product.thumb', '首图')->image('', 50, 50);
-
+ $grid->column('product.thumb', '首图')->image('', 50, 50); // 显示商品缩略图，设置显示大小
- $grid->disableActions();
- $grid->disableCreateButton();
- $grid->disableBatchActions();
+ // 禁用某些操作
+ $grid->disableActions(); // 禁用行操作按钮
+ $grid->disableCreateButton(); // 禁用创建按钮
+ $grid->disableBatchActions(); // 禁用批量操作按钮
+ // 定义过滤器
$grid->filter(function (Grid\Filter $filter) {
-
- $filter->disableIdFilter();
- $filter->like('user_id', '用户ID');
- $filter->like('product_id', '商品ID');
- $filter->like('user.name', '用户名');
- $filter->equal('product.name', '商品');
+ $filter->disableIdFilter(); // 禁用 ID 过滤器
+ $filter->like('user_id', '用户ID'); // 用户 ID 模糊查询
+ $filter->like('product_id', '商品ID'); // 商品 ID 模糊查询
+ $filter->like('user.name', '用户名'); // 用户名模糊查询
+ $filter->equal('product.name', '商品'); // 商品名称精确查询
});
- return $grid;
+ return $grid; // 返回构建好的网格
}
}
diff --git a/app/Admin/Controllers/ScoreLogController.php b/app/Admin/Controllers/ScoreLogController.php
index 5b46229..251ce97 100644
--- a/app/Admin/Controllers/ScoreLogController.php
+++ b/app/Admin/Controllers/ScoreLogController.php
@@ -2,49 +2,51 @@
namespace App\Admin\Controllers;
-use App\Models\ScoreLog;
-use Encore\Admin\Controllers\AdminController;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Show;
+use App\Models\ScoreLog; // 引入积分日志模型
+use Encore\Admin\Controllers\AdminController; // 引入管理控制器基类
+use Encore\Admin\Form; // 引入表单构建器
+use Encore\Admin\Grid; // 引入网格构建器
+use Encore\Admin\Show; // 引入展示构建器
class ScoreLogController extends AdminController
{
/**
- * Title for current resource.
+ * 当前资源的标题.
*
* @var string
*/
- protected $title = '积分日志';
+ protected $title = '积分日志'; // 设置资源的标题为“积分日志”
/**
- * Make a grid builder.
+ * 创建网格构建器.
*
- * @return Grid
+ * @return Grid 返回网格实例
*/
protected function grid()
{
- $grid = new Grid(new ScoreLog);
+ $grid = new Grid(new ScoreLog); // 创建新的网格实例，基于 ScoreLog 模型
- $grid->model()->latest();
+ $grid->model()->latest(); // 按照创建时间降序排列数据
- $grid->column('id', __('Id'));
- $grid->column('user_id', __('User id'));
- $grid->column('user.name', '用户名');
- $grid->column('description', __('Description'));
- $grid->column('score', __('Score'));
- $grid->column('created_at', __('Created at'));
- $grid->column('updated_at', __('Updated at'));
+ // 定义网格的列
+ $grid->column('id', __('Id')); // 显示日志 ID
+ $grid->column('user_id', __('User id')); // 显示用户 ID
+ $grid->column('user.name', '用户名'); // 显示用户名
+ $grid->column('description', __('Description')); // 显示日志描述
+ $grid->column('score', __('Score')); // 显示积分
+ $grid->column('created_at', __('Created at')); // 显示创建时间
+ $grid->column('updated_at', __('Updated at')); // 显示更新时间
- $grid->disableActions();
- $grid->disableCreateButton();
+ // 禁用某些操作
+ $grid->disableActions(); // 禁用行操作按钮
+ $grid->disableCreateButton(); // 禁用创建按钮
+ // 定义过滤器
$grid->filter(function (Grid\Filter $filter) {
-
- $filter->like('user.name', '用户名');
- $filter->equal('score', '积分');
+ $filter->like('user.name', '用户名'); // 用户名模糊查询
+ $filter->equal('score', '积分'); // 积分精确查询
});
- return $grid;
+ return $grid; // 返回构建好的网格
}
}
diff --git a/app/Admin/Controllers/ScoreRuleController.php b/app/Admin/Controllers/ScoreRuleController.php
index beb2f6c..bf2abc1 100644
--- a/app/Admin/Controllers/ScoreRuleController.php
+++ b/app/Admin/Controllers/ScoreRuleController.php
@@ -2,22 +2,22 @@
namespace App\Admin\Controllers;
-use App\Enums\ScoreRuleIndexEnum;
-use App\Models\ScoreRule;
-use App\Http\Controllers\Controller;
-use Encore\Admin\Controllers\HasResourceActions;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Layout\Content;
-use Encore\Admin\Show;
-use Illuminate\Http\Request;
+use App\Enums\ScoreRuleIndexEnum; // 引入积分规则索引枚举
+use App\Models\ScoreRule; // 引入积分规则模型
+use App\Http\Controllers\Controller; // 引入控制器基类
+use Encore\Admin\Controllers\HasResourceActions; // 引入资源操作特性
+use Encore\Admin\Form; // 引入表单构建器
+use Encore\Admin\Grid; // 引入网格构建器
+use Encore\Admin\Layout\Content; // 引入内容布局
+use Encore\Admin\Show; // 引入展示构建器
+use Illuminate\Http\Request; // 引入请求处理
class ScoreRuleController extends Controller
{
- use HasResourceActions;
+ use HasResourceActions; // 使用资源操作特性，提供 CRUD 操作
/**
- * Index interface.
+ * 列表界面.
*
* @param Content $content
* @return Content
@@ -25,13 +25,13 @@ class ScoreRuleController extends Controller
public function index(Content $content)
{
return $content
- ->header('列表')
- ->description(':xxx 是变量模板,建议不要操作')
- ->body($this->grid());
+ ->header('列表') // 设置页面标题
+ ->description(':xxx 是变量模板,建议不要操作') // 设置页面描述
+ ->body($this->grid()); // 设置页面主体为网格
}
/**
- * Show interface.
+ * 显示详细信息界面.
*
* @param mixed $id
* @param Content $content
@@ -40,13 +40,13 @@ class ScoreRuleController extends Controller
public function show($id, Content $content)
{
return $content
- ->header('详情')
- ->description('')
- ->body($this->detail($id));
+ ->header('详情') // 设置页面标题
+ ->description('') // 设置页面描述
+ ->body($this->detail($id)); // 设置页面主体为详细信息
}
/**
- * Edit interface.
+ * 编辑界面.
*
* @param mixed $id
* @param Content $content
@@ -55,13 +55,13 @@ class ScoreRuleController extends Controller
public function edit($id, Content $content)
{
return $content
- ->header('Edit')
- ->description('')
- ->body($this->form($id)->edit($id));
+ ->header('Edit') // 设置页面标题
+ ->description('') // 设置页面描述
+ ->body($this->form($id)->edit($id)); // 设置页面主体为编辑表单
}
/**
- * Create interface.
+ * 创建界面.
*
* @param Content $content
* @return Content
@@ -69,130 +69,125 @@ class ScoreRuleController extends Controller
public function create(Content $content)
{
return $content
- ->header('新建')
- ->description('')
- ->body($this->form());
+ ->header('新建') // 设置页面标题
+ ->description('') // 设置页面描述
+ ->body($this->form()); // 设置页面主体为创建表单
}
/**
- * Make a grid builder.
+ * 创建网格构建器.
*
* @return Grid
*/
protected function grid()
{
- $grid = new Grid(new ScoreRule);
+ $grid = new Grid(new ScoreRule); // 创建新的网格实例，基于 ScoreRule 模型
- $grid->model()->latest();
+ $grid->model()->latest(); // 按照创建时间降序排列数据
- $grid->column('id', 'id');
- $grid->column('description', '描述');
- $grid->column('replace_text', '替换文本');
- $grid->column('score', '积分');
+ // 定义网格的列
+ $grid->column('id', 'id'); // 显示日志 ID
+ $grid->column('description', '描述'); // 显示描述
+ $grid->column('replace_text', '替换文本'); // 显示替换文本
+ $grid->column('score', '积分'); // 显示积分
$grid->column('times', '次数')->display(function ($times) {
-
+ // 显示次数，如果没有则返回空
return $times ? $times : '';
});
- $grid->column('created_at', '创建时间');
- $grid->column('updated_at', '修改时间');
+ $grid->column('created_at', '创建时间'); // 显示创建时间
+ $grid->column('updated_at', '修改时间'); // 显示修改时间
+ // 定义行操作
$grid->actions(function (Grid\Displayers\Actions $actions) {
-
- $rule = $actions->row;
- if (! $rule->can_delete) {
- $actions->disableDelete();
+ $rule = $actions->row; // 获取当前行数据
+ if (! $rule->can_delete) { // 如果该规则不可删除
+ $actions->disableDelete(); // 禁用删除按钮
}
-
});
- return $grid;
+ return $grid; // 返回构建好的网格
}
/**
- * Make a show builder.
+ * 创建展示构建器.
*
* @param mixed $id
* @return Show
*/
protected function detail($id)
{
- $show = new Show(ScoreRule::findOrFail($id));
+ $show = new Show(ScoreRule::findOrFail($id)); // 创建展示实例，查找指定 ID 的记录
- $show->field('id', 'id');
- $show->field('description', '描述');
- $show->field('replace_text', '替换文本');
- $show->field('score', '积分');
+ // 定义展示的字段
+ $show->field('id', 'id'); // 显示 ID
+ $show->field('description', '描述'); // 显示描述
+ $show->field('replace_text', '替换文本'); // 显示替换文本
+ $show->field('score', '积分'); // 显示积分
$show->field('times', '次数')->as(function ($times) {
-
+ // 显示次数，如果没有则返回空
return $times ? $times : '';
});
- $show->field('created_at', '创建时间');
- $show->field('updated_at', '修改时间');
+ $show->field('created_at', '创建时间'); // 显示创建时间
+ $show->field('updated_at', '修改时间'); // 显示修改时间
- return $show;
+ return $show; // 返回展示实例
}
/**
- * Make a form builder.
+ * 创建表单构建器.
*
* @param null $id
* @return Form
*/
protected function form($id = null)
{
- $form = new Form(new ScoreRule);
+ $form = new Form(new ScoreRule); // 创建新的表单实例，基于 ScoreRule 模型
- // 只有新增才能改变类型
- $options = [ScoreRuleIndexEnum::CONTINUE_LOGIN => '连续登录', ScoreRuleIndexEnum::VISITED_PRODUCT => '每日浏览商品'];
+ // 定义可选的积分规则类型
+ $options = [
+ ScoreRuleIndexEnum::CONTINUE_LOGIN => '连续登录',
+ ScoreRuleIndexEnum::VISITED_PRODUCT => '每日浏览商品'
+ ];
- if (is_null($id)) {
-
- $form->select('index_code', '类型')->options($options)->rules('required');
+ if (is_null($id)) { // 如果是创建新记录
+ $form->select('index_code', '类型')->options($options)->rules('required'); // 选择积分类型，必填
}
- $form->number('score', '积分');
-
-
- if (! is_null($id)) {
-
- // 只有当时连续登录和修改的才有次数
- $scoreRule = ScoreRule::query()->findOrFail($id);
- $form->textarea('replace_text', '替换文本');
- $form->textarea('description', '描述');
+ $form->number('score', '积分'); // 输入积分
- if (array_key_exists($scoreRule->index_code, $options)) {
+ if (! is_null($id)) { // 如果是编辑现有记录
+ // 只有当是连续登录和修改的才有次数
+ $scoreRule = ScoreRule::query()->findOrFail($id); // 查找指定 ID 的规则
+ $form->textarea('replace_text', '替换文本'); // 输入替换文本
+ $form->textarea('description', '描述'); // 输入描述
- $form->number('times', '次数');
+ if (array_key_exists($scoreRule->index_code, $options)) { // 如果规则类型在选项中
+ $form->number('times', '次数'); // 输入次数
}
-
} else {
-
- $form->number('times', '次数');
+ $form->number('times', '次数'); // 输入次数
}
-
+ // 表单保存前的处理
$form->saving(function (Form $form) {
-
- // 如果是新建复制模板
+ // 如果是新建记录，复制模板
if (! $form->model()->exists) {
-
-
$rule = ScoreRule::query()
- ->where('can_delete', 0)
- ->where('index_code', $form->index_code)
- ->firstOrFail();
+ ->where('can_delete', 0) // 查找不可删除的规则
+ ->where('index_code', $form->index_code) // 根据类型查找
+ ->firstOrFail(); // 查找失败则抛出异常
+ // 复制规则的描述和替换文本
$form->model()->description = $rule->description;
$form->model()->replace_text = $rule->replace_text;
}
-
});
- return $form;
+ return $form; // 返回构建好的表单
}
/**
- * Remove the specified resource from storage.
+ * 从存储中删除指定资源.
*
* @param int $id
* @return \Illuminate\Http\Response
@@ -200,28 +195,28 @@ class ScoreRuleController extends Controller
*/
public function destroy($id)
{
- $rule = ScoreRule::query()->findOrFail($id);
-
- if (! $rule->can_delete) {
+ $rule = ScoreRule::query()->findOrFail($id); // 查找指定 ID 的规则
+ if (! $rule->can_delete) { // 如果该规则不可删除
return response()->json([
'status' => false,
- 'message' => '这个等级不允许删除',
+ 'message' => '这个等级不允许删除', // 返回错误信息
]);
}
+ // 尝试删除规则
if ($rule->delete()) {
$data = [
'status' => true,
- 'message' => trans('admin.delete_succeeded'),
+ 'message' => trans('admin.delete_succeeded'), // 返回成功信息
];
} else {
$data = [
'status' => false,
- 'message' => trans('admin.delete_failed'),
+ 'message' => trans('admin.delete_failed'), // 返回失败信息
];
}
- return response()->json($data);
+ return response()->json($data); // 返回 JSON 响应
}
}
diff --git a/app/Admin/Controllers/SeckillController.php b/app/Admin/Controllers/SeckillController.php
index bc60c64..17c329e 100644
--- a/app/Admin/Controllers/SeckillController.php
+++ b/app/Admin/Controllers/SeckillController.php
@@ -2,26 +2,26 @@
namespace App\Admin\Controllers;
-use App\Http\Controllers\Controller;
-use App\Http\Requests\StoreSeckillRequest;
-use App\Models\Category;
-use App\Models\Product;
-use App\Models\Seckill;
-use Carbon\Carbon;
-use Encore\Admin\Controllers\HasResourceActions;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Layout\Content;
-use Illuminate\Http\Request;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Facades\Redis;
+use App\Http\Controllers\Controller; // 引入控制器基类
+use App\Http\Requests\StoreSeckillRequest; // 引入秒杀请求验证类
+use App\Models\Category; // 引入分类模型
+use App\Models\Product; // 引入商品模型
+use App\Models\Seckill; // 引入秒杀模型
+use Carbon\Carbon; // 引入日期时间处理库
+use Encore\Admin\Controllers\HasResourceActions; // 引入资源操作特性
+use Encore\Admin\Form; // 引入表单构建器
+use Encore\Admin\Grid; // 引入网格构建器
+use Encore\Admin\Layout\Content; // 引入内容布局
+use Illuminate\Http\Request; // 引入请求处理
+use Illuminate\Support\Facades\DB; // 引入数据库操作
+use Illuminate\Support\Facades\Redis; // 引入 Redis 操作
class SeckillController extends Controller
{
- use HasResourceActions;
+ use HasResourceActions; // 使用资源操作特性，提供 CRUD 操作
/**
- * Index interface.
+ * 列表界面.
*
* @param Content $content
* @return Content
@@ -29,13 +29,13 @@ class SeckillController extends Controller
public function index(Content $content)
{
return $content
- ->header('秒杀列表')
- ->description('')
- ->body($this->grid());
+ ->header('秒杀列表') // 设置页面标题
+ ->description('') // 设置页面描述
+ ->body($this->grid()); // 设置页面主体为网格
}
/**
- * Create interface.
+ * 创建界面.
*
* @param Content $content
* @return Content
@@ -43,124 +43,130 @@ class SeckillController extends Controller
public function create(Content $content)
{
return $content
- ->header('新建秒杀')
- ->description('')
- ->body($this->form());
+ ->header('新建秒杀') // 设置页面标题
+ ->description('') // 设置页面描述
+ ->body($this->form()); // 设置页面主体为创建表单
}
/**
- * Make a grid builder.
+ * 创建网格构建器.
*
* @return Grid
*/
protected function grid()
{
- $grid = new Grid(new Seckill);
+ $grid = new Grid(new Seckill); // 创建新的网格实例，基于 Seckill 模型
- $grid->model()->latest();
+ $grid->model()->latest(); // 按照创建时间降序排列数据
- $grid->column('id');
+ // 定义网格的列
+ $grid->column('id'); // 显示秒杀 ID
- $grid->column('product.id', '商品ID');
+ $grid->column('product.id', '商品ID'); // 显示商品 ID
$grid->column('product.name', '商品名字')->display(function ($name) {
+ // 显示商品名字，限制显示长度为30个字符
return str_limit($name, 30);
});
$grid->column('product.thumb', '商品图')->display(function ($thumb) {
+ // 显示商品缩略图
return image($thumb);
});
- $grid->column('price', '秒杀价');
- $grid->column('number', '秒杀数量');
- $grid->column('start_at', '开始时间');
- $grid->column('end_at', '结束时间');
- $grid->column('rollback_count', '回滚量');
+ $grid->column('price', '秒杀价'); // 显示秒杀价格
+ $grid->column('number', '秒杀数量'); // 显示秒杀数量
+ $grid->column('start_at', '开始时间'); // 显示开始时间
+ $grid->column('end_at', '结束时间'); // 显示结束时间
+ $grid->column('rollback_count', '回滚量'); // 显示回滚量
$grid->column('is_rollback', '是否回滚数量')->display(function ($is) {
+ // 显示是否回滚数量
return $is ? '是' : '否';
});
- $grid->column('created_at', '创建时间');
- $grid->column('updated_at', '修改时间');
+ $grid->column('created_at', '创建时间'); // 显示创建时间
+ $grid->column('updated_at', '修改时间'); // 显示修改时间
+ // 定义行操作
$grid->actions(function (Grid\Displayers\Actions $actions) {
-
- $actions->disableView();
- $actions->disableEdit();
+ $actions->disableView(); // 禁用查看按钮
+ $actions->disableEdit(); // 禁用编辑按钮
});
- return $grid;
+ return $grid; // 返回构建好的网格
}
-
-
/**
- * Make a form builder.
+ * 创建表单构建器.
*
* @return Form
*/
protected function form()
{
- $form = new Form(new Seckill);
+ $form = new Form(new Seckill); // 创建新的表单实例，基于 Seckill 模型
+ // 获取所有分类
$categories = Category::selectOrderAll();
+ // 选择分类，加载商品
$form->select('category_id', '分类')
->options($categories)
- ->load('product_id', admin_url('api/products'));
- $form->select('product_id', '秒杀商品');
+ ->load('product_id', admin_url('api/products')); // 根据分类动态加载商品
- $form->number('price', '秒杀价')
- ->default(1);
- $form->number('number', '秒杀数量')
- ->default(1)
- ->help('保证商品的库存数量大于此数量，会从库存中减去');
+ $form->select('product_id', '秒杀商品'); // 选择秒杀商品
- $now = Carbon::now();
- $form->datetime('start_at', '开始时间')
- ->default($now->format('Y-m-d H:00:00'));
- $form->datetime('end_at', '结束时间')
- ->default($now->addHour(2)->format('Y-m-d H:00:00'))
- ->rules('required|date|after_or_equal:start_at');
+ $form->number('price', '秒杀价') // 输入秒杀价
+ ->default(1); // 默认值为1
+ $form->number('number', '秒杀数量') // 输入秒杀数量
+ ->default(1) // 默认值为1
+ ->help('保证商品的库存数量大于此数量，会从库存中减去'); // 提示用户
+
+ $now = Carbon::now(); // 获取当前时间
+ $form->datetime('start_at', '开始时间') // 输入开始时间
+ ->default($now->format('Y-m-d H:00:00')); // 默认值为当前时间整点
+ $form->datetime('end_at', '结束时间') // 输入结束时间
+ ->default($now->addHour(2)->format('Y-m-d H:00:00')) // 默认值为当前时间后2小时
+ ->rules('required|date|after_or_equal:start_at'); // 验证规则
- return $form;
+ return $form; // 返回构建好的表单
}
/**
+ * 存储秒杀信息.
+ *
* @param Request $request
* @return \Illuminate\Http\JsonResponse|\Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
* @throws \Exception
*/
public function store(Request $request)
{
- $number = $request->input('number', 0);
- $product = Product::query()->findOrFail($request->input('product_id'));
+ $number = $request->input('number', 0); // 获取秒杀数量
+ $product = Product::query()->findOrFail($request->input('product_id')); // 查找商品
+ // 验证秒杀数量不能大于库存数量
if ($number > $product->count) {
-
return back()->withInput()->withErrors(['number' => '秒杀数量不能大于库存数量']);
}
- DB::beginTransaction();
+ DB::beginTransaction(); // 开始数据库事务
try {
-
+ // 获取请求中的相关属性
$attributes = $request->only(['category_id', 'product_id', 'price', 'number', 'start_at', 'end_at']);
- Seckill::create($attributes);
+ Seckill::create($attributes); // 创建新的秒杀记录
// 减去库存数量
- $product->decrement('count', $number);
+ $product->decrement('count', $number); // 从商品库存中减去秒杀数量
} catch (\Error $e) {
-
- DB::rollBack();
- return back()->withInput()->withErrors(['category_id' => $e->getMessage()]);
+ DB::rollBack(); // 回滚事务
+ return back()->withInput()->withErrors(['category_id' => $e->getMessage()]); // 返回错误信息
}
- DB::commit();
+ DB::commit(); // 提交事务
- admin_toastr('添加成功');
- return back();
+ admin_toastr('添加成功'); // 显示成功消息
+ return back(); // 返回上一个页面
}
/**
- * Remove the specified resource from storage.
+ * 从存储中删除指定资源.
*
* @param int $id
* @return \Illuminate\Http\Response
@@ -172,51 +178,43 @@ class SeckillController extends Controller
* @var $seckill Seckill
* @var $product Product
*/
- $seckill = Seckill::query()->findOrFail($id);
-
+ $seckill = Seckill::query()->findOrFail($id); // 查找指定 ID 的秒杀记录
- // 如果已经到了开始抢购时间，就不能删除了
+ // 获取当前时间和秒杀的开始和结束时间
$now = Carbon::now();
$startTime = Carbon::make($seckill->start_at);
$endTime = Carbon::make($seckill->end_at);
// 如果正处于抢购的时间，不允许删除
if ($now->gte($startTime) && $now->lte($endTime)) {
-
return response()->json([
'status' => false,
- 'message' => '秒杀已经开始，不能删除',
+ 'message' => '秒杀已经开始，不能删除', // 返回错误信息
]);
}
- DB::beginTransaction();
-
+ DB::beginTransaction(); // 开始数据库事务
try {
-
- // 先把 redis 数据删除掉
- // 虽然过期会自动清理，但是如果用户是
- // 删除还没有开始的秒杀，只能在这里手动清理
+ // 删除 Redis 中的秒杀数据
\Redis::connection()->del([$seckill->getRedisModelKey(), $seckill->getRedisQueueKey()]);
-
- $seckill->delete();
+ $seckill->delete(); // 删除秒杀记录
$data = [
- 'status' => false,
- 'message' => trans('admin.delete_succeeded'),
+ 'status' => true,
+ 'message' => trans('admin.delete_succeeded'), // 返回成功信息
];
} catch (\Exception $e) {
-
$data = [
- 'status' => true,
- 'message' => trans('admin.delete_failed'),
+ 'status' => false,
+ 'message' => trans('admin.delete_failed'), // 返回失败信息
];
- DB::rollBack();
+ DB::rollBack(); // 回滚事务
}
- DB::commit();
- return response()->json($data);
+ DB::commit(); // 提交事务
+ return response()->json($data); // 返回 JSON 响应
}
}
diff --git a/app/Admin/Controllers/SettingController.php b/app/Admin/Controllers/SettingController.php
index b9ec991..1d5747b 100644
--- a/app/Admin/Controllers/SettingController.php
+++ b/app/Admin/Controllers/SettingController.php
@@ -2,24 +2,24 @@
namespace App\Admin\Controllers;
-use App\Enums\SettingKeyEnum;
-use App\Models\Setting;
-use App\Http\Controllers\Controller;
-use Encore\Admin\Controllers\HasResourceActions;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Layout\Content;
-use Encore\Admin\Layout\Row;
-use Encore\Admin\Show;
-use Encore\Admin\Widgets\Box;
-use Illuminate\Http\Request;
+use App\Enums\SettingKeyEnum; // 引入设置键枚举
+use App\Models\Setting; // 引入设置模型
+use App\Http\Controllers\Controller; // 引入控制器基类
+use Encore\Admin\Controllers\HasResourceActions; // 引入资源操作特性
+use Encore\Admin\Form; // 引入表单构建器
+use Encore\Admin\Grid; // 引入网格构建器
+use Encore\Admin\Layout\Content; // 引入内容布局
+use Encore\Admin\Layout\Row; // 引入行布局
+use Encore\Admin\Show; // 引入显示构建器
+use Encore\Admin\Widgets\Box; // 引入盒子组件
+use Illuminate\Http\Request; // 引入请求处理
class SettingController extends Controller
{
- use HasResourceActions;
+ use HasResourceActions; // 使用资源操作特性，提供 CRUD 操作
/**
- * Index interface.
+ * 配置列表界面.
*
* @param Content $content
* @return Content
@@ -27,73 +27,89 @@ class SettingController extends Controller
public function index(Content $content)
{
return $content
- ->header('配置列表')
- ->description('')
- ->body(function (Row $row) {
-
+ ->header('配置列表') // 设置页面标题
+ ->description('') // 设置页面描述
+ ->body(function (Row $row) { // 设置页面主体为行布局
+ // 获取所有设置键
$settingKeys = $this->getSettingKeys();
+ // 初始化设置数组
$settings = [];
foreach ($settingKeys as $key) {
-
+ // 获取每个设置键的值
$settings[$key] = setting(new SettingKeyEnum($key));
}
+ // 创建一个新的表单实例
$form = new \Encore\Admin\Widgets\Form($settings);
- $form->action(admin_url('settings'));
- $form->method('POST');
- $form->hidden('_token', csrf_token());
-
+ $form->action(admin_url('settings')); // 设置表单提交地址
+ $form->method('POST'); // 设置表单提交方法
+ $form->hidden('_token', csrf_token()); // 添加 CSRF 令牌
- $form->text(SettingKeyEnum::USER_INIT_PASSWORD, '会员初始密码')->required();
- $form->decimal(SettingKeyEnum::UN_PAY_CANCEL_TIME, '订单自动取消时间')->required()->help('单位：分钟');
- $form->decimal(SettingKeyEnum::POST_AMOUNT, '邮费')->required()->help('设置为 0 免邮');
+ // 添加表单字段
+ $form->text(SettingKeyEnum::USER_INIT_PASSWORD, '会员初始密码')->required(); // 会员初始密码，必填
+ $form->decimal(SettingKeyEnum::UN_PAY_CANCEL_TIME, '订单自动取消时间')->required()->help('单位：分钟'); // 订单自动取消时间，必填，单位为分钟
+ $form->decimal(SettingKeyEnum::POST_AMOUNT, '邮费')->required()->help('设置为 0 免邮'); // 邮费，必填，设置为0时免邮
+ // 定义开关状态
$states = [
'on' => ['value' => 1, 'text' => '打开', 'color' => 'success'],
'off' => ['value' => 0, 'text' => '关闭', 'color' => 'danger'],
];
+ // 获取秒杀状态并设置提示信息
$seckillStatus = \setting(new SettingKeyEnum(SettingKeyEnum::IS_OPEN_SECKILL)) ? '开启' : '关闭';
$seckillHelp = "秒杀现在是 {$seckillStatus} 状态";
- $form->switch(SettingKeyEnum::IS_OPEN_SECKILL, '是否开启秒杀')->states($states)->help($seckillHelp);
+ $form->switch(SettingKeyEnum::IS_OPEN_SECKILL, '是否开启秒杀')->states($states)->help($seckillHelp); // 是否开启秒杀开关
+ // 将表单放入盒子组件中并显示
$row->column(12, new Box('网站配置', $form));
});
}
+ /**
+ * 存储设置.
+ *
+ * @param Request $request
+ * @return \Illuminate\Http\RedirectResponse
+ */
public function store(Request $request)
{
- // 对秒杀这个特殊的 key 做处理
+ // 对秒杀这个特殊的 key 做处理，将开关状态转换为 0 或 1
$val = strtolower($request->input(SettingKeyEnum::IS_OPEN_SECKILL)) == 'on' ? 1 : 0;
- $request->offsetSet(SettingKeyEnum::IS_OPEN_SECKILL, $val);
+ $request->offsetSet(SettingKeyEnum::IS_OPEN_SECKILL, $val); // 更新请求中的秒杀状态
+ // 验证输入数据
$this->validate($request, [
- SettingKeyEnum::USER_INIT_PASSWORD => 'required|string',
- SettingKeyEnum::UN_PAY_CANCEL_TIME => 'required|integer|min:0',
- SettingKeyEnum::IS_OPEN_SECKILL => 'required|int|in:0,1',
- SettingKeyEnum::POST_AMOUNT => 'required|numeric|min:0',
+ SettingKeyEnum::USER_INIT_PASSWORD => 'required|string', // 会员初始密码，必填且为字符串
+ SettingKeyEnum::UN_PAY_CANCEL_TIME => 'required|integer|min:0', // 订单自动取消时间，必填且为非负整数
+ SettingKeyEnum::IS_OPEN_SECKILL => 'required|int|in:0,1', // 秒杀状态，必填且为0或1
+ SettingKeyEnum::POST_AMOUNT => 'required|numeric|min:0', // 邮费，必填且为非负数字
]);
-
+ // 获取所有设置键并更新数据库
$settingKeys = $this->getSettingKeys();
foreach ($settingKeys as $key) {
-
- Setting::query()->where('key', $key)->update(['value' => $request->input($key)]);
+ Setting::query()->where('key', $key)->update(['value' => $request->input($key)]); // 更新每个设置的值
}
- admin_success('修改成功');
- return back();
+ admin_success('修改成功'); // 显示成功消息
+ return back(); // 返回上一个页面
}
+ /**
+ * 获取所有设置键.
+ *
+ * @return array
+ */
private function getSettingKeys()
{
return [
- SettingKeyEnum::USER_INIT_PASSWORD,
- SettingKeyEnum::UN_PAY_CANCEL_TIME,
- SettingKeyEnum::POST_AMOUNT,
- SettingKeyEnum::IS_OPEN_SECKILL,
+ SettingKeyEnum::USER_INIT_PASSWORD, // 会员初始密码
+ SettingKeyEnum::UN_PAY_CANCEL_TIME, // 订单自动取消时间
+ SettingKeyEnum::POST_AMOUNT, // 邮费
+ SettingKeyEnum::IS_OPEN_SECKILL, // 是否开启秒杀
];
}
}
diff --git a/app/Admin/Controllers/UploadController.php b/app/Admin/Controllers/UploadController.php
index 3087669..28a72ed 100644
--- a/app/Admin/Controllers/UploadController.php
+++ b/app/Admin/Controllers/UploadController.php
@@ -2,38 +2,42 @@
namespace App\Admin\Controllers;
-use App\Exceptions\UploadException;
-use App\Http\Controllers\Controller;
-use App\Services\UploadServe;
-use Illuminate\Support\Facades\Storage;
+use App\Exceptions\UploadException; // 引入自定义上传异常类
+use App\Http\Controllers\Controller; // 引入控制器基类
+use App\Services\UploadServe; // 引入上传服务类
+use Illuminate\Support\Facades\Storage; // 引入存储门面，便于文件存储操作
class UploadController extends Controller
{
/**
- * @param UploadServe $uploadServe
- * @return array
+ * 通过编辑器上传文件.
+ *
+ * @param UploadServe $uploadServe 上传服务实例
+ * @return array 返回上传结果数组
*/
public function uploadByEditor(UploadServe $uploadServe)
{
- $disk = 'public';
+ $disk = 'public'; // 定义使用的存储磁盘
try {
- $files = $uploadServe->setFileInput('pictures')
- ->setMaxSize('10M')
- ->setExtensions(['jpg', 'jpeg', 'png', 'bmp', 'gif'])
- ->validate()
- ->storeMulti('upload/editor', compact('disk'));
-
+ // 设置文件输入名称、最大文件大小和允许的文件扩展名，并进行验证和存储
+ $files = $uploadServe->setFileInput('pictures') // 设置文件输入名称为 'pictures'
+ ->setMaxSize('10M') // 设置最大文件大小为 10MB
+ ->setExtensions(['jpg', 'jpeg', 'png', 'bmp', 'gif']) // 设置允许的文件扩展名
+ ->validate() // 验证上传的文件
+ ->storeMulti('upload/editor', compact('disk')); // 存储文件，路径为 'upload/editor'
+
+ // 将存储的文件路径转换为可访问的 URL
$files = collect($files)->map(function ($file) use ($disk) {
- return Storage::disk($disk)->url($file);
- })->all();
-
+ return Storage::disk($disk)->url($file); // 获取文件的 URL
+ })->all(); // 转换为数组
} catch (UploadException $e) {
-
- return ['errno' => 1, 'msg' => $e->getMessage()];
+ // 捕获上传异常并返回错误信息
+ return ['errno' => 1, 'msg' => $e->getMessage()]; // 返回错误代码和消息
}
- return ['errno' => 0, 'data' => $files];
+ // 返回成功的上传结果
+ return ['errno' => 0, 'data' => $files]; // 返回成功代码和文件 URL 列表
}
}
diff --git a/app/Admin/Controllers/UserController.php b/app/Admin/Controllers/UserController.php
index a99a70c..d0f10b5 100644
--- a/app/Admin/Controllers/UserController.php
+++ b/app/Admin/Controllers/UserController.php
@@ -2,28 +2,28 @@
namespace App\Admin\Controllers;
-use App\Admin\Actions\Post\ActiveUserAction;
-use App\Admin\Transforms\UserSexTransform;
-use App\Admin\Transforms\YesNoTransform;
-use App\Enums\UserSexEnum;
-use App\Enums\UserStatusEnum;
-use App\Http\Controllers\Controller;
-use App\Models\Level;
-use App\Models\User;
-use Encore\Admin\Controllers\HasResourceActions;
-use Encore\Admin\Form;
-use Encore\Admin\Grid;
-use Encore\Admin\Grid\Filter;
-use Encore\Admin\Layout\Content;
-use Encore\Admin\Show;
-use Illuminate\Validation\Rule;
+use App\Admin\Actions\Post\ActiveUserAction; // 引入激活用户操作
+use App\Admin\Transforms\UserSexTransform; // 引入性别转换器
+use App\Admin\Transforms\YesNoTransform; // 引入是/否转换器
+use App\Enums\UserSexEnum; // 引入性别枚举
+use App\Enums\UserStatusEnum; // 引入用户状态枚举
+use App\Http\Controllers\Controller; // 引入控制器基类
+use App\Models\Level; // 引入等级模型
+use App\Models\User; // 引入用户模型
+use Encore\Admin\Controllers\HasResourceActions; // 引入资源操作特性
+use Encore\Admin\Form; // 引入表单构建器
+use Encore\Admin\Grid; // 引入网格构建器
+use Encore\Admin\Grid\Filter; // 引入网格过滤器
+use Encore\Admin\Layout\Content; // 引入内容布局
+use Encore\Admin\Show; // 引入显示构建器
+use Illuminate\Validation\Rule; // 引入验证规则
class UserController extends Controller
{
- use HasResourceActions;
+ use HasResourceActions; // 使用资源操作特性，提供 CRUD 操作
/**
- * Index interface.
+ * 显示会员列表界面.
*
* @param Content $content
* @return Content
@@ -31,43 +31,43 @@ class UserController extends Controller
public function index(Content $content)
{
return $content
- ->header('会员列表')
- ->description('')
- ->body($this->grid());
+ ->header('会员列表') // 设置页面标题
+ ->description('') // 设置页面描述
+ ->body($this->grid()); // 设置页面主体为网格
}
/**
- * Show interface.
+ * 显示用户详情界面.
*
- * @param mixed $id
+ * @param mixed $id 用户 ID
* @param Content $content
* @return Content
*/
public function show($id, Content $content)
{
return $content
- ->header('详情')
- ->description('')
- ->body($this->detail($id));
+ ->header('详情') // 设置页面标题
+ ->description('') // 设置页面描述
+ ->body($this->detail($id)); // 设置页面主体为用户详情
}
/**
- * Edit interface.
+ * 显示编辑用户界面.
*
- * @param mixed $id
+ * @param mixed $id 用户 ID
* @param Content $content
* @return Content
*/
public function edit($id, Content $content)
{
return $content
- ->header('Edit')
- ->description('')
- ->body($this->form()->edit($id));
+ ->header('Edit') // 设置页面标题
+ ->description('') // 设置页面描述
+ ->body($this->form()->edit($id)); // 设置页面主体为编辑表单
}
/**
- * Create interface.
+ * 显示创建用户界面.
*
* @param Content $content
* @return Content
@@ -75,131 +75,128 @@ class UserController extends Controller
public function create(Content $content)
{
return $content
- ->header('新建')
- ->description('')
- ->body($this->form());
+ ->header('新建') // 设置页面标题
+ ->description('') // 设置页面描述
+ ->body($this->form()); // 设置页面主体为创建表单
}
/**
- * Make a grid builder.
+ * 创建网格构建器.
*
* @return Grid
*/
protected function grid()
{
- $grid = new Grid(new User);
+ $grid = new Grid(new User); // 创建用户网格
+ // 获取所有等级，并按最小分数降序排序
$levels = Level::query()->orderBy('min_score', 'desc')->get();
- // 排序最新的
+ // 按照最新的用户排序
$grid->model()->latest();
- $grid->column('id', 'Id');
- $grid->column('name', '用户名');
+ // 定义网格列
+ $grid->column('id', 'Id'); // 用户 ID
+ $grid->column('name', '用户名'); // 用户名
$grid->column('sex', '性别')->display(function ($sex) {
-
- return UserSexTransform::trans($sex);
+ return UserSexTransform::trans($sex); // 显示性别
});
$grid->column('email', '邮箱')->display(function ($email) {
- return str_limit($email, 20);
+ return str_limit($email, 20); // 限制显示邮箱长度
});
- $grid->column('avatar', '头像')->image('', 50, 50);
- $grid->column('github_name', 'Github');
- $grid->column('qq_name', 'QQ');
- $grid->column('weibo_name', '微博');
+ $grid->column('avatar', '头像')->image('', 50, 50); // 显示用户头像
+ $grid->column('github_name', 'Github'); // Github 昵称
+ $grid->column('qq_name', 'QQ'); // QQ 昵称
+ $grid->column('weibo_name', '微博'); // 微博 昵称
$grid->column('level', '等级')->display(function () use ($levels) {
-
+ // 根据用户总积分获取对应等级
$level = $levels->where('min_score', '<=', $this->score_all)->first();
- return optional($level)->name;
+ return optional($level)->name; // 显示等级名称
});
- $grid->column('score_all', '总积分')->sortable();
- $grid->column('score_now', '剩余积分')->sortable();
- $grid->column('login_ip', '登录地址');
- $grid->column('login_count', '登录次数')->sortable();
+ $grid->column('score_all', '总积分')->sortable(); // 总积分，支持排序
+ $grid->column('score_now', '剩余积分')->sortable(); // 剩余积分，支持排序
+ $grid->column('login_ip', '登录地址'); // 登录地址
+ $grid->column('login_count', '登录次数')->sortable(); // 登录次数，支持排序
$grid->column('is_active', '是否激活')->display(function ($isActive) {
-
- return YesNoTransform::trans($isActive);
+ return YesNoTransform::trans($isActive); // 显示是否激活状态
});
- $grid->column('created_at', '创建时间');
- $grid->column('updated_at', '修改时间');
+ $grid->column('created_at', '创建时间'); // 创建时间
+ $grid->column('updated_at', '修改时间'); // 修改时间
+ // 定义网格操作
$grid->actions(function (Grid\Displayers\DropdownActions $actions) {
-
- if (! $actions->row->is_active) {
-
+ // 如果用户未激活，则添加激活用户操作
+ if (!$actions->row->is_active) {
$actions->add(new ActiveUserAction());
}
});
// 筛选功能
- $levelOptions = $levels->pluck('name', 'id');
+ $levelOptions = $levels->pluck('name', 'id'); // 获取等级选项
$grid->filter(function (Filter $filter) use ($levelOptions) {
- $filter->disableIdFilter();
- $filter->like('name', '用户名');
- $filter->like('email', '邮箱');
-
- $filter->where(function ($query) {
-
- // 找到这个等级
- $level = Level::query()->findOrFail($this->input);
- // 找到下一个等级
- $high = Level::query()->where('min_score', '>', $level->min_score)->orderBy('min_score', 'asc')->first();
-
-
- $query->where('score_all', '>=', $level->min_score);
- if (! is_null($high)) {
- $query->where('score_all', '<', $high->min_score);
- }
-
- }, '等级')->select($levelOptions);
+ $filter->disableIdFilter(); // 禁用 ID 筛选
+ $filter->like('name', '用户名'); // 用户名模糊筛选
+ $filter->like('email', '邮箱'); // 邮箱模糊筛选
+
+ // 按等级筛选
+ $filter->where(function ($query) {
+ // 找到选中的等级
+ $level = Level::query()->findOrFail($this->input);
+ // 找到下一个等级
+ $high = Level::query()->where('min_score', '>', $level->min_score)->orderBy('min_score', 'asc')->first();
+
+ // 筛选总积分在当前等级范围内的用户
+ $query->where('score_all', '>=', $level->min_score);
+ if (!is_null($high)) {
+ $query->where('score_all', '<', $high->min_score);
+ }
+ }, '等级')->select($levelOptions); // 添加等级选择
});
- return $grid;
+ return $grid; // 返回网格
}
/**
- * Make a show builder.
+ * 创建显示构建器.
*
- * @param mixed $id
+ * @param mixed $id 用户 ID
* @return Show
*/
protected function detail($id)
{
- $show = new Show(User::findOrFail($id));
-
+ $show = new Show(User::findOrFail($id)); // 创建用户详情显示构建器
- $show->field('id', 'Id');
- $show->field('name', '用户名');
+ // 定义显示字段
+ $show->field('id', 'Id'); // 用户 ID
+ $show->field('name', '用户名'); // 用户名
$show->field('sex', '性别')->as(function ($sex) {
-
- return UserSexTransform::trans($sex);
+ return UserSexTransform::trans($sex); // 显示性别
});
- $show->field('email', '邮箱');
- $show->field('avatar', '头像')->image();
- $show->field('github_name', 'Github昵称');
- $show->field('qq_name', 'QQ昵称');
- $show->field('weibo_name', '微博昵称');
- $show->field('login_ip', '登录地址');
- $show->field('login_count', '登录次数');
+ $show->field('email', '邮箱'); // 邮箱
+ $show->field('avatar', '头像')->image(); // 显示头像
+ $show->field('github_name', 'Github昵称'); // Github 昵称
+ $show->field('qq_name', 'QQ昵称'); // QQ 昵称
+ $show->field('weibo_name', '微博昵称'); // 微博 昵称
+ $show->field('login_ip', '登录地址'); // 登录地址
+ $show->field('login_count', '登录次数'); // 登录次数
$show->field('is_active', '是否激活')->as(function ($isActive) {
+ return YesNoTransform::trans($isActive); // 显示是否激活状态
+ })->unescape(); // 取消 HTML 转义
+ $show->field('created_at', '创建时间'); // 创建时间
+ $show->field('updated_at', '修改时间'); // 修改时间
- return YesNoTransform::trans($isActive);
- })->unescape();
- $show->field('created_at', '创建时间');
- $show->field('updated_at', '修改时间');
-
+ // 显示用户的收货地址
$show->addresses('收货地址', function (Grid $grid) {
-
- $grid->model()->latest();
- $grid->column('name', '收货人');
- $grid->column('phone', '收货人联系方式');
- $grid->column('detail_address', '详细地址');
+ $grid->model()->latest(); // 按最新排序
+ $grid->column('name', '收货人'); // 收货人姓名
+ $grid->column('phone', '收货人联系方式'); // 收货人联系方式
+ $grid->column('detail_address', '详细地址'); // 详细地址
$grid->column('is_default', '是否默认')->display(function ($is) {
-
- return YesNoTransform::trans($is);
+ return YesNoTransform::trans($is); // 显示是否默认
});
- $grid->column('created_at', '创建时间');
+ $grid->column('created_at', '创建时间'); // 创建时间
+ // 禁用一些操作
$grid->disableActions();
$grid->disableCreateButton();
$grid->disableFilter();
@@ -207,13 +204,14 @@ class UserController extends Controller
$grid->disableRowSelector();
});
+ // 显示用户的积分日志
$show->scoreLogs('积分', function (Grid $grid) {
+ $grid->model()->latest(); // 按最新排序
+ $grid->column('description', '描述'); // 积分描述
+ $grid->column('score', '积分'); // 积分
+ $grid->column('created_at', '创建时间'); // 创建时间
- $grid->model()->latest();
- $grid->column('description', '描述');
- $grid->column('score', '积分');
- $grid->column('created_at', '创建时间');
-
+ // 禁用一些操作
$grid->disableActions();
$grid->disableCreateButton();
$grid->disableFilter();
@@ -221,11 +219,11 @@ class UserController extends Controller
$grid->disableRowSelector();
});
- return $show;
+ return $show; // 返回用户详情显示构建器
}
/**
- * Make a form builder.
+ * 创建表单构建器.
*
* @return Form
*/
@@ -233,53 +231,61 @@ class UserController extends Controller
{
// 前台用户注册必须要有这个 token，兼容一下
$form = new Form(tap(new User, function ($user) {
- $user->active_token = str_random(60);
+ $user->active_token = str_random(60); // 生成随机激活 token
}));
+ // 用户名字段
$form->text('name', '用户名')->rules(function (Form $form) {
- $rules = 'required|unique:users,id';
+ $rules = 'required|unique:users,name'; // 用户名必填且唯一
- // 更新操作
- if (! is_null($id = $form->model()->getKey())) {
+ // 更新操作时，排除当前用户 ID
+ if (!is_null($id = $form->model()->getKey())) {
$rules .= ",{$id}";
}
- return $rules;
+ return $rules; // 返回验证规则
});
- $sexOptions = [UserSexEnum::MAN => '男', UserSexEnum::WOMAN => '女'];
- $form->select('sex', '性别')->rules(['required', Rule::in(array_keys($sexOptions))])->options($sexOptions)->default(1);
+ // 性别字段
+ $sexOptions = [UserSexEnum::MAN => '男', UserSexEnum::WOMAN => '女']; // 性别选项
+ $form->select('sex', '性别')->rules(['required', Rule::in(array_keys($sexOptions))])
+ ->options($sexOptions)->default(1); // 默认选择男
+
+ // 邮箱字段
$form->email('email', '邮箱')->rules(function (Form $form) {
- $rules = 'required|email|unique:users,email';
+ $rules = 'required|email|unique:users,email'; // 邮箱必填且唯一
- // 更新操作
- if (! is_null($id = $form->model()->getKey())) {
+ // 更新操作时，排除当前用户 ID
+ if (!is_null($id = $form->model()->getKey())) {
$rules .= ",{$id}";
}
- return $rules;
+ return $rules; // 返回验证规则
});
- // dd(windows_os());
- $form->password('password', '密码');
- $avatar = $form->image('avatar', '头像')->uniqueName()->move('avatars');
- if (! windows_os()) {
- $avatar->resize(160, 160);;
+ // 密码字段
+ $form->password('password', '密码'); // 密码字段
+
+ // 头像字段
+ $avatar = $form->image('avatar', '头像')->uniqueName()->move('avatars'); // 上传头像并指定存储路径
+
+ // 如果不是 Windows 系统，调整头像尺寸
+ if (!windows_os()) {
+ $avatar->resize(160, 160);
}
+ // 激活状态开关
$form->switch('is_active', '激活');
- // 加密密码
+ // 在保存表单前加密密码
$form->saving(function (Form $form) {
-
if ($form->password) {
- $form->password = bcrypt($form->password);
+ $form->password = bcrypt($form->password); // 加密密码
} else {
- $form->password = $form->model()->password;
+ $form->password = $form->model()->password; // 保持原密码
}
-
});
- return $form;
+ return $form; // 返回表单构建器
}
}
diff --git a/app/Admin/bootstrap.php b/app/Admin/bootstrap.php
index aec7fe9..6c68593 100644
--- a/app/Admin/bootstrap.php
+++ b/app/Admin/bootstrap.php
@@ -1,8 +1,12 @@