feat: 网关管理模块 + RBAC权限认证 + 组织架构 + 审计日志

- 网关管理：GatewayEntity/Service/Controller CRUD + 测试连接；设备 GatewayId 外键关联 - JWT 认证：登录签发 Token（权限编码写入 Claims）、RequirePermission 权限过滤器、CurrentUser 上下文 - RBAC：用户/角色/权限实体与 CRUD，预定义 4 角色 + 6 权限种子（admin/admin123） - 组织架构：sys_org 固定层级树（公司/实验室/部门/班组白夜班），层级校验，用户挂 OrgId/岗位/技能标签 - 数据权限：角色 DataScope（全部/本组织及下级），用户列表按组织子树过滤 - 防锁死保护：禁止删/禁自己，保证至少一名活跃管理员，角色摘除 user:manage 前校验 - 审计日志：AuditRecorder 接入设备增删改/指令下发/登录登出/组织变更，AuditController 查询 - 设备指令下发按网关表取连接参数；设备列表支持 gatewayId/productId 筛选 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-09-10 17:31:39 +08:00
parent 3059befcf5
commit 6aca0297bb
48 changed files with 3583 additions and 52 deletions
@@ -0,0 +1,127 @@
+using SqlSugar;
+
+namespace Model.Entity.Config
+{
+    /// <summary>
+    /// 网关（通讯通道）：TCP 类存 IP+端口，串口类存 COM+波特率，S7 类额外存 CPU/Rack/Slot。
+    /// 同一网关下多设备用从站号（SlaveId）区分。
+    /// </summary>
+    public class GatewayEntity : BaseEntity
+    {
+        /// <summary>
+        /// 网关编码（唯一，如 GW-ENV-01）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "网关编码", Length = 64)]
+        public string Code { get; set; }
+
+        /// <summary>
+        /// 网关名称
+        /// </summary>
+        [SugarColumn(ColumnDescription = "网关名称", Length = 100)]
+        public string Name { get; set; }
+
+        /// <summary>
+        /// 通讯协议类型（决定连接参数组：TCP/Serial/S7）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "通讯协议类型")]
+        public IotDeviceProtocolEnum ProtocolType { get; set; } = IotDeviceProtocolEnum.ModbusTcp;
+
+        #region TCP 参数（ModbusTcp / Tcp / S7 协议使用）
+        /// <summary>
+        /// IP 地址
+        /// </summary>
+        [SugarColumn(ColumnDescription = "IP地址", Length = 50, IsNullable = true)]
+        public string? Host { get; set; }
+
+        /// <summary>
+        /// 端口号（ModbusTcp 默认 502，S7 默认 102）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "端口号", IsNullable = true)]
+        public int? Port { get; set; }
+        #endregion
+
+        #region 串口参数（ModbusRtu / Serial 协议使用）
+        /// <summary>
+        /// 串口号（如 COM3）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "串口号", Length = 20, IsNullable = true)]
+        public string? ComPort { get; set; }
+
+        /// <summary>
+        /// 波特率（默认 9600）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "波特率", IsNullable = true)]
+        public int? BaudRate { get; set; }
+
+        /// <summary>
+        /// 数据位（默认 8）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "数据位", IsNullable = true)]
+        public byte? DataBits { get; set; }
+
+        /// <summary>
+        /// 停止位（1/2，默认 1）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "停止位", IsNullable = true)]
+        public byte? StopBits { get; set; }
+
+        /// <summary>
+        /// 校验位（0=None 1=Odd 2=Even，默认 0）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "校验位", IsNullable = true)]
+        public byte? Parity { get; set; }
+        #endregion
+
+        #region S7 参数（S7 协议专用）
+        /// <summary>
+        /// S7 CPU 型号（如 S71200、S71500）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "S7 CPU型号", Length = 20, IsNullable = true)]
+        public string? CpuType { get; set; }
+
+        /// <summary>
+        /// S7 Rack（默认 0）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "S7 Rack", IsNullable = true)]
+        public byte? Rack { get; set; }
+
+        /// <summary>
+        /// S7 Slot（默认 1）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "S7 Slot", IsNullable = true)]
+        public byte? Slot { get; set; }
+        #endregion
+
+        #region 状态
+        /// <summary>
+        /// 是否启用
+        /// </summary>
+        [SugarColumn(ColumnDescription = "是否启用")]
+        public bool IsEnabled { get; set; } = true;
+
+        /// <summary>
+        /// 在线状态（0=离线 1=在线 3=异常，由测试连接更新）
+        /// </summary>
+        [SugarColumn(ColumnDescription = "在线状态")]
+        public byte OnlineStatus { get; set; }
+
+        /// <summary>
+        /// 最后连接成功时间
+        /// </summary>
+        [SugarColumn(ColumnDescription = "最后连接时间", IsNullable = true)]
+        public DateTime? LastConnectedTime { get; set; }
+
+        /// <summary>
+        /// 最近错误
+        /// </summary>
+        [SugarColumn(ColumnDescription = "最近错误", Length = 500, IsNullable = true)]
+        public string? LastError { get; set; }
+        #endregion
+
+        /// <summary>
+        /// 备注
+        /// </summary>
+        [SugarColumn(ColumnDescription = "备注", Length = 500, IsNullable = true)]
+        public string? Remark { get; set; }
+    }
+}
@@ -34,10 +34,10 @@ namespace Model.Entity.Config
        public long ProductId { get; set; }

        /// <summary>
-        /// 所属网关Code（对应网关实体/通道的标识，连接时据此刻查找 IP/端口/串口）
+        /// 所属网关Id（关联 GatewayEntity.Id，0=未分配）
        /// </summary>
-        [SugarColumn(ColumnDescription = "所属网关Code", Length = 64)]
-        public string GatewayCode { get; set; }
+        [SugarColumn(ColumnDescription = "所属网关Id", DefaultValue = "0")]
+        public long GatewayId { get; set; }

        /// <summary>
        /// 从站地址（协议从站号，网关下区分设备）
@@ -0,0 +1,50 @@
+using SqlSugar;
+
+namespace Model.Entity.System
+{
+    /// <summary>
+    /// 审计日志表（记录所有关键操作）
+    /// </summary>
+    [SugarTable("sys_audit_log")]
+    public class AuditLogEntity : BaseEntity
+    {
+        [SugarColumn(ColumnName = "UserId", ColumnDescription = "操作人用户Id")]
+        public long UserId { get; set; }
+
+        [SugarColumn(ColumnName = "UserName", ColumnDescription = "操作人用户名", Length = 64, IsNullable = true)]
+        public string? UserName { get; set; }
+
+        [SugarColumn(ColumnName = "RoleId", ColumnDescription = "操作人角色Id（0=无/多角色）", DefaultValue = "0")]
+        public long RoleId { get; set; }
+
+        [SugarColumn(ColumnName = "RoleName", ColumnDescription = "操作人角色名称", Length = 100, IsNullable = true)]
+        public string? RoleName { get; set; }
+
+        [SugarColumn(ColumnName = "OperationType", ColumnDescription = "操作类型（Create/Update/Delete/Login/Command等）", Length = 32, IsNullable = false)]
+        public string OperationType { get; set; }
+
+        [SugarColumn(ColumnName = "OperationTarget", ColumnDescription = "操作对象（如 IotDevice/Gateway/User/Role）", Length = 64, IsNullable = false)]
+        public string OperationTarget { get; set; }
+
+        [SugarColumn(ColumnName = "TargetId", ColumnDescription = "操作对象Id（0=无具体Id）", DefaultValue = "0")]
+        public long TargetId { get; set; }
+
+        [SugarColumn(ColumnName = "DeviceId", ColumnDescription = "关联设备Id（0=无关设备）", DefaultValue = "0")]
+        public long DeviceId { get; set; }
+
+        [SugarColumn(ColumnName = "OldValue", ColumnDescription = "操作前值（JSON）", ColumnDataType = "text", IsNullable = true)]
+        public string? OldValue { get; set; }
+
+        [SugarColumn(ColumnName = "NewValue", ColumnDescription = "操作后值（JSON）", ColumnDataType = "text", IsNullable = true)]
+        public string? NewValue { get; set; }
+
+        [SugarColumn(ColumnName = "Ip", ColumnDescription = "操作IP", Length = 45, IsNullable = true)]
+        public string? Ip { get; set; }
+
+        [SugarColumn(ColumnName = "Description", ColumnDescription = "操作描述", Length = 500, IsNullable = true)]
+        public string? Description { get; set; }
+
+        [SugarColumn(ColumnName = "OperateTime", ColumnDescription = "操作时间", IsNullable = false)]
+        public DateTime OperateTime { get; set; }
+    }
+}
@@ -0,0 +1,40 @@
+using SqlSugar;
+
+namespace Model.Entity.System
+{
+    /// <summary>
+    /// 组织架构表（树形：公司/实验室/部门/班组，ParentId 自关联；班组带白/夜班）
+    /// </summary>
+    [SugarTable("sys_org")]
+    public class OrgEntity : BaseEntity
+    {
+        [SugarColumn(ColumnName = "ParentId", ColumnDescription = "父级组织Id（0=根节点）", DefaultValue = "0")]
+        public long ParentId { get; set; }
+
+        [SugarColumn(ColumnName = "Name", ColumnDescription = "组织名称", Length = 100, IsNullable = false)]
+        public string Name { get; set; }
+
+        [SugarColumn(ColumnName = "Code", ColumnDescription = "组织编码（唯一）", Length = 64, IsNullable = false)]
+        public string Code { get; set; }
+
+        /// <summary>组织类型：1=公司, 2=实验室, 3=部门, 4=班组</summary>
+        [SugarColumn(ColumnName = "OrgType", ColumnDescription = "组织类型（1公司/2实验室/3部门/4班组）", ColumnDataType = "smallint", DefaultValue = "3")]
+        public byte OrgType { get; set; }
+
+        /// <summary>班组班次：0=非班组, 1=白班, 2=夜班</summary>
+        [SugarColumn(ColumnName = "ShiftType", ColumnDescription = "班次（0非班组/1白班/2夜班）", ColumnDataType = "smallint", DefaultValue = "0")]
+        public byte ShiftType { get; set; }
+
+        [SugarColumn(ColumnName = "Leader", ColumnDescription = "负责人", Length = 50, IsNullable = true)]
+        public string? Leader { get; set; }
+
+        [SugarColumn(ColumnName = "Phone", ColumnDescription = "联系电话", Length = 20, IsNullable = true)]
+        public string? Phone { get; set; }
+
+        [SugarColumn(ColumnName = "Sort", ColumnDescription = "排序号", DefaultValue = "0")]
+        public int Sort { get; set; }
+
+        [SugarColumn(ColumnName = "Remark", ColumnDescription = "备注", Length = 500, IsNullable = true)]
+        public string? Remark { get; set; }
+    }
+}
@@ -0,0 +1,26 @@
+using SqlSugar;
+
+namespace Model.Entity.System
+{
+    /// <summary>
+    /// 权限表（功能权限码，如 device:view / device:edit / alert:confirm）
+    /// </summary>
+    [SugarTable("sys_permission")]
+    public class PermissionEntity : BaseEntity
+    {
+        [SugarColumn(ColumnName = "Code", ColumnDescription = "权限编码（唯一，如 device:view）", Length = 64, IsNullable = false)]
+        public string Code { get; set; }
+
+        [SugarColumn(ColumnName = "Name", ColumnDescription = "权限名称", Length = 100, IsNullable = false)]
+        public string Name { get; set; }
+
+        [SugarColumn(ColumnName = "Group", ColumnDescription = "权限分组（如 device/alert/inspection/user）", Length = 64, IsNullable = true)]
+        public string? Group { get; set; }
+
+        [SugarColumn(ColumnName = "IsSystem", ColumnDescription = "是否系统内置（不可删除）", ColumnDataType = "smallint", DefaultValue = "0")]
+        public byte IsSystem { get; set; }
+
+        [SugarColumn(ColumnName = "Sort", ColumnDescription = "排序号", DefaultValue = "0")]
+        public int Sort { get; set; }
+    }
+}
@@ -0,0 +1,29 @@
+using SqlSugar;
+
+namespace Model.Entity.System
+{
+    /// <summary>
+    /// 角色表
+    /// </summary>
+    [SugarTable("sys_role")]
+    public class RoleEntity : BaseEntity
+    {
+        [SugarColumn(ColumnName = "Code", ColumnDescription = "角色编码（唯一）", Length = 64, IsNullable = false)]
+        public string Code { get; set; }
+
+        [SugarColumn(ColumnName = "Name", ColumnDescription = "角色名称", Length = 100, IsNullable = false)]
+        public string Name { get; set; }
+
+        [SugarColumn(ColumnName = "DataScope", ColumnDescription = "数据范围（1=全部,2=本实验室）", ColumnDataType = "smallint", DefaultValue = "2")]
+        public byte DataScope { get; set; }
+
+        [SugarColumn(ColumnName = "IsSystem", ColumnDescription = "是否系统内置角色（不可删除）", ColumnDataType = "smallint", DefaultValue = "0")]
+        public byte IsSystem { get; set; }
+
+        [SugarColumn(ColumnName = "Sort", ColumnDescription = "排序号", DefaultValue = "0")]
+        public int Sort { get; set; }
+
+        [SugarColumn(ColumnName = "Remark", ColumnDescription = "备注", Length = 500, IsNullable = true)]
+        public string? Remark { get; set; }
+    }
+}
@@ -0,0 +1,17 @@
+using SqlSugar;
+
+namespace Model.Entity.System
+{
+    /// <summary>
+    /// 角色-权限关联表（多对多）
+    /// </summary>
+    [SugarTable("sys_role_permission")]
+    public class RolePermissionEntity : BaseEntity
+    {
+        [SugarColumn(ColumnName = "RoleId", ColumnDescription = "角色Id")]
+        public long RoleId { get; set; }
+
+        [SugarColumn(ColumnName = "PermissionId", ColumnDescription = "权限Id")]
+        public long PermissionId { get; set; }
+    }
+}
@@ -0,0 +1,47 @@
+using SqlSugar;
+
+namespace Model.Entity.System
+{
+    /// <summary>
+    /// 用户表
+    /// </summary>
+    [SugarTable("sys_user")]
+    public class UserEntity : BaseEntity
+    {
+        [SugarColumn(ColumnName = "UserName", ColumnDescription = "用户名（登录账号）", Length = 64, IsNullable = false)]
+        public string UserName { get; set; }
+
+        [SugarColumn(ColumnName = "PasswordHash", ColumnDescription = "密码哈希", Length = 256, IsNullable = false)]
+        public string PasswordHash { get; set; }
+
+        [SugarColumn(ColumnName = "RealName", ColumnDescription = "真实姓名", Length = 100, IsNullable = true)]
+        public string? RealName { get; set; }
+
+        [SugarColumn(ColumnName = "Email", ColumnDescription = "邮箱", Length = 128, IsNullable = true)]
+        public string? Email { get; set; }
+
+        [SugarColumn(ColumnName = "Phone", ColumnDescription = "手机号", Length = 20, IsNullable = true)]
+        public string? Phone { get; set; }
+
+        [SugarColumn(ColumnName = "OrgId", ColumnDescription = "所属组织Id（公司/实验室/部门/班组任一节点，0=未分配）", DefaultValue = "0")]
+        public long OrgId { get; set; }
+
+        [SugarColumn(ColumnName = "Position", ColumnDescription = "岗位", Length = 64, IsNullable = true)]
+        public string? Position { get; set; }
+
+        [SugarColumn(ColumnName = "SkillTags", ColumnDescription = "技能标签（逗号分隔，如 Modbus,PLC,温度箱）", Length = 500, IsNullable = true)]
+        public string? SkillTags { get; set; }
+
+        [SugarColumn(ColumnName = "IsEnabled", ColumnDescription = "是否启用", ColumnDataType = "smallint", DefaultValue = "1")]
+        public byte IsEnabled { get; set; }
+
+        [SugarColumn(ColumnName = "LastLoginTime", ColumnDescription = "最后登录时间", IsNullable = true)]
+        public DateTime? LastLoginTime { get; set; }
+
+        [SugarColumn(ColumnName = "Avatar", ColumnDescription = "头像URL", Length = 256, IsNullable = true)]
+        public string? Avatar { get; set; }
+
+        [SugarColumn(ColumnName = "Remark", ColumnDescription = "备注", Length = 500, IsNullable = true)]
+        public string? Remark { get; set; }
+    }
+}
@@ -0,0 +1,17 @@
+using SqlSugar;
+
+namespace Model.Entity.System
+{
+    /// <summary>
+    /// 用户-角色关联表（多对多）
+    /// </summary>
+    [SugarTable("sys_user_role")]
+    public class UserRoleEntity : BaseEntity
+    {
+        [SugarColumn(ColumnName = "UserId", ColumnDescription = "用户Id")]
+        public long UserId { get; set; }
+
+        [SugarColumn(ColumnName = "RoleId", ColumnDescription = "角色Id")]
+        public long RoleId { get; set; }
+    }
+}