添加mapper注释

src/main/java/com/labelsys/backend/mapper/SysUserMapper.java

@@ -8,23 +8,85 @@ import com.labelsys.backend.enums.UserStatus;
 import java.util.List;
 import org.apache.ibatis.annotations.Param;
 
+/**
+ * 用户数据访问层
+ *
+ * 继承 BaseMapper<SysUser>，提供用户表的基础 CRUD 操作，
+ * 并扩展自定义的查询和更新方法。
+ */
 public interface SysUserMapper extends BaseMapper<SysUser> {
 
+    /**
+     * 根据ID和公司ID查询用户
+     *
+     * @param id 用户ID
+     * @param companyId 公司ID
+     * @return 用户信息，不存在返回 null
+     */
     SysUser findByIdAndCompanyId(@Param("id") Long id, @Param("companyId") Long companyId);
 
+    /**
+     * 根据公司ID和手机号查询用户
+     *
+     * @param companyId 公司ID
+     * @param phone 手机号
+     * @return 用户信息，不存在返回 null
+     */
     SysUser findByCompanyIdAndPhone(@Param("companyId") Long companyId, @Param("phone") String phone);
 
+    /**
+     * 查询公司管理员列表
+     *
+     * @param companyId 公司ID
+     * @return 管理员用户列表
+     */
     List<SysUser> listCompanyAdmins(@Param("companyId") Long companyId);
 
+    /**
+     * 更新用户密码
+     *
+     * @param id 用户ID
+     * @param companyId 公司ID
+     * @param passwordHash 加密后的密码
+     * @param mustChangePassword 是否强制修改密码
+     * @return 更新影响的行数
+     */
     int updatePassword(@Param("id") Long id, @Param("companyId") Long companyId,
         @Param("passwordHash") String passwordHash, @Param("mustChangePassword") boolean mustChangePassword);
 
+    /**
+     * 更新用户角色和岗位
+     *
+     * @param id 用户ID
+     * @param companyId 公司ID
+     * @param role 角色
+     * @param position 岗位
+     * @return 更新影响的行数
+     */
     int updateAssignment(@Param("id") Long id, @Param("companyId") Long companyId, @Param("role") UserRole role,
         @Param("position") UserPosition position);
 
+    /**
+     * 更新用户状态
+     *
+     * @param id 用户ID
+     * @param companyId 公司ID
+     * @param status 用户状态
+     * @return 更新影响的行数
+     */
     int updateStatus(@Param("id") Long id, @Param("companyId") Long companyId, @Param("status") UserStatus status);
 
+    /**
+     * 增加会话版本号
+     *
+     * @param id 用户ID
+     * @param companyId 公司ID
+     * @return 更新影响的行数
+     */
     int bumpSessionVersion(@Param("id") Long id, @Param("companyId") Long companyId);
 
+    /**
+     * 删除所有用户（测试用）
+     */
     void deleteAll();
 }