添加注解

plugs/think-plugs-points-mall/src/controller/PointLog.php

@@ -8,6 +8,16 @@ use think\admin\helper\QueryHelper;
 
 class PointLog extends Controller
 {
+    /**
+     * 积分记录列表
+     * 显示积分记录的表格数据，支持按时间范围筛选。
+     * @auth true
+     * @menu true
+     * @return void
+     * @throws \think\db\exception\DataNotFoundException
+     * @throws \think\db\exception\DbException
+     * @throws \think\db\exception\ModelNotFoundException
+     */
     public function index()
     {
         $this->title = '积分记录';

plugs/think-plugs-ticket/src/controller/Dept.php

@@ -7,8 +7,17 @@ use think\admin\Controller;
 use think\admin\helper\QueryHelper;
 use think\admin\model\SystemUser;
 
+/**
+ * 部门管理控制器
+ */
 class Dept extends Controller
 {
+    /**
+     * 部门列表页面
+     * 显示部门管理的表格数据，支持搜索和筛选。
+     * @auth true
+     * @menu true
+     */
     public function index()
     {
         $this->title = '部门管理';
@@ -19,6 +28,12 @@ class Dept extends Controller
         });
     }
 
+    /**
+     * 添加部门页面
+     * 提供表单用于添加新部门，并加载用户列表以供选择负责人。
+     * @auth true
+     * @menu true
+     */
     public function add()
     {
         $this->title = '添加部门';
@@ -26,6 +41,12 @@ class Dept extends Controller
         TicketDept::mForm('form');
     }
 
+    /**
+     * 编辑部门页面
+     * 提供表单用于编辑现有部门信息，并加载用户列表以供选择负责人。
+     * @auth true
+     * @menu true
+     */
     public function edit()
     {
         $this->title = '编辑部门';
@@ -33,12 +54,24 @@ class Dept extends Controller
         TicketDept::mForm('form');
     }
 
+    /**
+     * 删除部门
+     * 根据提交的 ID 删除指定部门。
+     * @auth true
+     * @menu true
+     */
     public function remove()
     {
         $this->_applyFormToken();
         TicketDept::mDelete('id');
     }
 
+    /**
+     * 更新部门状态
+     * 根据提交的 ID 和状态值更新部门的状态。
+     * @auth true
+     * @menu true
+     */
     public function status()
     {
         TicketDept::mSave($this->_vali([