平台基础与用户授权表.md 33 KB

平台基础与用户授权表

本文引用的文件

  • sql/plat.sql
  • sql/user.sql
  • SysUser.java
  • SystemInfo.java
  • SaTokenWebConfig.java
  • AuthController.java
  • SysUserService.java
  • LoginActivityService.java
  • LicenseUtil.java
  • SystemService.java

目录

  1. 引言
  2. 项目结构
  3. 核心数据表
  4. 架构总览
  5. 关键组件分析
  6. 依赖关系分析
  7. 典型查询场景
  8. 性能与容量建议
  9. 数据安全与备份恢复
  10. 常见运维问题排查
  11. 结论

引言

本文聚焦平台基础与用户授权相关的数据库设计,覆盖 plat 模块中的系统配置、表信息、会话与缓存、知识库与聊天等辅助表,以及 user 脚本中定义的用户体系。文档重点说明:

  • sys_user 用户的身份、状态和账号生命周期;
  • system_info 的系统机器码、客户编号、单位、手机号、授权时间和过期时间;
  • Sa-Token 会话、客户端 token、许可证校验之间的关系;
  • 当前代码库中尚未出现“水印”和“授权单元”的持久化表,并给出扩展建议;
  • 按用户查会话、查绑定 ai-server 节点、查授权有效期等典型查询;
  • 敏感字段保护、备份恢复策略和常见运维问题。

项目结构

平台基础数据主要落在 PostgreSQL 主库(由应用动态数据源 master 指向),并通过两套 SQL 脚本初始化:

路径 职责 是否注册为业务表元数据
sql/user.sql 创建 sys_user、用户名唯一索引、默认管理员、case_info.owner_id 归属迁移 否
sql/plat.sql 创建 system_info、table_info、table_field、case_info、chat_session、chat_message、chat_model、chat_provider、knowledge_*、phone_isp、bank_card_issuer_info 等表 部分
graph TB
    subgraph "PostgreSQL 主库"
        SYS_USER["sys_user"]
        SYSTEM_INFO["system_info"]
        CASE_INFO["case_info"]
        TABLE_INFO["table_info"]
        TABLE_FIELD["table_field"]
        CHAT_SESSION["chat_session"]
        CHAT_MESSAGE["chat_message"]
        CHAT_MODEL["chat_model"]
        CHAT_PROVIDER["chat_provider"]
        KNOWLEDGE_INFO["knowledge_info"]
        KNOWLEDGE_FRAGMENT["knowledge_fragment"]
        KNOWLEDGE_ATTACH["knowledge_attach"]
        PHONE_ISP["phone_isp"]
        BANK_CARD_ISSUER["bank_card_issuer_info"]
    end

    USER_SQL["sql/user.sql<br/>用户体系与案件归属迁移"] --> SYS_USER
    USER_SQL --> CASE_INFO

    PLAT_SQL["sql/plat.sql<br/>平台基础与功能表"] --> SYSTEM_INFO
    PLAT_SQL --> TABLE_INFO
    PLAT_SQL --> TABLE_FIELD
    PLAT_SQL --> CHAT_SESSION
    PLAT_SQL --> CHAT_MESSAGE
    PLAT_SQL --> CHAT_MODEL
    PLAT_SQL --> CHAT_PROVIDER
    PLAT_SQL --> KNOWLEDGE_INFO
    PLAT_SQL --> KNOWLEDGE_FRAGMENT
    PLAT_SQL --> KNOWLEDGE_ATTACH
    PLAT_SQL --> PHONE_ISP
    PLAT_SQL --> BANK_CARD_ISSUER

图表来源

  • sql/user.sql:1-75
  • sql/plat.sql:1-154

章节来源

  • sql/user.sql:1-75
  • sql/plat.sql:1-154

核心数据表

sys_user:系统用户表

字段 类型 约束 语义
id BIGSERIAL 主键 用户自增 ID
username VARCHAR(64) 非空 登录名
pwd_hash VARCHAR(100) 非空 BCrypt 密码哈希;不返回前端
display_name VARCHAR(64) 可空 显示名称
is_admin SMALLINT 默认 0 1=管理员,0=普通用户
status SMALLINT 默认 1 1=启用,0=停用
create_time TIMESTAMP 默认当前时间 创建时间
update_time TIMESTAMP 可空 更新时间
last_login_time TIMESTAMP 可空 最后登录时间

唯一约束与索引:

  • sys_user 的主键是 id。
  • 存在唯一索引 uk_sys_user_username,对 lower(username) 建立唯一约束,实现用户名不区分大小写唯一。
  • 未定义外键,owner_id 通过应用层与注释表达逻辑归属。

敏感字段:

  • pwd_hash 在实体上标注忽略序列化,不应随用户信息查询返回前端。
  • 日志中记录的是用户 ID 和用户名,不应记录明文密码。

    erDiagram
    SYS_USER {
    bigserial id PK
    varchar username
    varchar pwd_hash
    varchar display_name
    smallint is_admin
    smallint status
    timestamp create_time
    timestamp update_time
    timestamp last_login_time
    }
    

图表来源

  • SysUser.java:21-61
  • sql/user.sql:19-43

章节来源

  • SysUser.java:21-61
  • sql/user.sql:19-43

system_info:系统配置与授权信息

字段 类型 约束 语义
machinecode TEXT 主键 服务器机器码,作为授权绑定标识
client_no TEXT 可空 客户编号
unit TEXT 可空 单位
phone TEXT 可空 联系方式
active_date_time DATE 可空 激活时间
authdatetime DATE 可空 授权开始时间
overdatetime DATE 可空 授权过期时间

实体中还包含一个计算字段:

字段 类型 约束 语义
remainingDate Long 非持久化字段 剩余天数,由服务根据 overdatetime 与当前日期计算

注意:

  • 该表没有 id 自增主键,而是以 machinecode 作为主键。
  • 当前 SQL 中 machinecode 未显式声明 PRIMARY KEY,但 Java 实体使用 @TableId(value = "machinecode");部署时应确保数据库层面确实存在主键约束,避免后续写入或更新行为不一致。
  • remainingDate 不参与数据库映射,仅用于接口展示。

    erDiagram
    SYSTEM_INFO {
    text machinecode PK
    text client_no
    text unit
    text phone
    date authdatetime
    date overdatetime
    datetime active_date_time
    }
    

图表来源

  • SystemInfo.java:17-71
  • sql/plat.sql:31-41

章节来源

  • SystemInfo.java:17-71
  • sql/plat.sql:31-41

case_info:案件信息与归属

字段 类型 约束 语义
id INTEGER AUTO_INCREMENT 主键 案件 ID
name TEXT 可空 案件名称
pwd TEXT 可空 历史保留字段,不再参与开案校验
type TEXT 可空 案件类型
remark TEXT 可空 备注
db TEXT 可空 数据库相关标识
db_Path TEXT 可空 数据库路径
init INTEGER 可空 初始化状态
create_time DATE 可空 创建时间
owner_id BIGINT 新增列 案件归属用户 ID,对应 sys_user.id

索引:

  • case_info 主键为 id。
  • 新增索引 idx_case_info_owner,基于 owner_id。
  • 迁移脚本将历史无归属案件统一归给 admin 用户。

    erDiagram
    CASE_INFO {
    integer id PK
    text name
    text pwd
    text type
    text remark
    text db
    text db_path
    integer init
    date create_time
    bigint owner_id
    }
    
    SYS_USER ||--o{ CASE_INFO : "拥有"
    

图表来源

  • sql/plat.sql:9-30
  • sql/user.sql:45-75
  • SysUser.java:21-61

章节来源

  • sql/plat.sql:9-30
  • sql/user.sql:45-75

table_info 与 table_field:表元数据

这两张表服务于“案件库的业务表语义检索”,即描述外部表的结构元数据,而不是平台自身的权限表。

table_info

字段 类型 约束 语义
id INTEGER 主键 表元数据 ID
main_id INTEGER 可空 主表关联 ID
table_name_cn TEXT 可空 中文表名
table_name_en TEXT 可空 英文表名
headers TEXT 可空 表头信息
classify TEXT 可空 分类
func_regex TEXT 可空 函数正则
line_no INTEGER 默认 0 行号
has_inner INTEGER 默认 0 是否内部表
create_time DATE 可空 创建时间

table_field

字段 类型 约束 语义
id INTEGER AUTO_INCREMENT 主键 字段元数据 ID
table_id INTEGER 非空 所属表元数据 ID
field_name_cn TEXT 可空 中文字段名
field_name_en TEXT 可空 英文字段名
field_type TEXT 可空 字段类型
required INTEGER 默认 0 是否必填
field_len INTEGER 默认 0 字段长度
matched INTEGER 可空 匹配状态
direction_conf TEXT 可空 方向置信度
field_sort INTEGER 可空 排序
erDiagram
  TABLE_INFO {
    integer id PK
    integer main_id
    text table_name_cn
    text table_name_en
    text headers
    text classify
    text func_regex
    integer line_no
    integer has_inner
    date create_time
  }

  TABLE_FIELD {
    integer id PK
    integer table_id
    text field_name_cn
    text field_name_en
    text field_type
    integer required
    integer field_len
    integer matched
    text direction_conf
    integer field_sort
  }

  TABLE_INFO ||--o{ TABLE_FIELD : "包含字段"

图表来源

  • sql/plat.sql:43-69

章节来源

  • sql/plat.sql:43-69

chat_session 与 chat_message:聊天会话与消息

表 关键字段 语义
chat_session id、case_id、session_title、session_content、conversation_id 会话标题、内容、外部对话 ID 和所属案件
chat_message id、session_id、content、role、model_name 单条消息、角色和模型名称

约束与索引:

  • chat_message.id 自增主键。
  • chat_session.id 是文本主键。
  • 当前 SQL 未对 session_id 建索引;若按会话查询消息频繁,应增加索引。

    erDiagram
    CHAT_SESSION {
    text id PK
    integer case_id
    text session_title
    text session_content
    text conversation_id
    }
    
    CHAT_MESSAGE {
    integer id PK
    text session_id
    text content
    text role
    text model_name
    }
    
    CHAT_SESSION ||--o{ CHAT_MESSAGE : "包含消息"
    

图表来源

  • sql/plat.sql:71-96

章节来源

  • sql/plat.sql:71-96

chat_model 与 chat_provider:模型与供应商

表 关键字段 语义
chat_provider id、provider_name、provider_code、provider_icon、provider_desc、api_host AI 模型供应商
chat_model id、category、model_name、provider_code、model_describe、model_dimension、api_host、api_key 具体模型及 API 密钥

安全注意:

  • chat_model.api_key 属于敏感配置,不应直接输出到前端;如需展示,应脱敏或只返回是否已配置。

    erDiagram
    CHAT_PROVIDER {
    integer id PK
    text provider_name
    text provider_code
    text provider_icon
    text provider_desc
    text api_host
    }
    
    CHAT_MODEL {
    integer id PK
    text category
    text model_name
    text provider_code
    text model_describe
    integer model_dimension
    text api_host
    text api_key
    }
    
    CHAT_PROVIDER ||--o{ CHAT_MODEL : "提供模型"
    

图表来源

  • sql/plat.sql:98-126

章节来源

  • sql/plat.sql:98-126

knowledge_info、knowledge_fragment、knowledge_attach:知识库

表 关键字段 语义
knowledge_info id、name、share、description、separator、overlap_char、retrieve_limit、text_block_size、vector_model、embedding_model 知识库元数据
knowledge_fragment id、idx、doc_id、content 知识片段
knowledge_attach id、knowledge_id、oss_id、doc_id、name、type 知识库附件

这些表主要用于知识库、向量检索和文档处理,不属于用户授权核心表,但与平台基础能力密切相关。

章节来源

  • sql/plat.sql:128-154

phone_isp 与 bank_card_issuer_info:基础字典表

表 主键 用途
phone_isp paragraph 手机号段归属省份、城市、运营商
bank_card_issuer_info bank_bin 银行卡发卡行 BIN 信息

章节来源

  • sql/plat.sql:1-8
  • sql/plat.sql:32-42

架构总览

平台认证、授权与会话的关系如下:

sequenceDiagram
    participant Client as "前端"
    participant Gateway as "网关"
    participant Server as "ai-server"
    participant AuthCtrl as "AuthController"
    participant UserSvc as "SysUserService"
    participant SaToken as "Sa-Token"
    participant Redis as "Redis"
    participant DB as "PostgreSQL"

    Client->>Gateway: "携带 x-token 访问接口"
    Gateway->>Server: "转发请求"
    Server->>SaToken: "checkLogin()"
    SaToken-->>Server: "验证 token 有效"
    Server->>UserSvc: "touch(userId)"
    UserSvc->>Redis: "记录最近活跃时间"
    Server->>DB: "按需读取 sys_user / system_info"
    Server-->>Client: "业务响应"

图表来源

  • SaTokenWebConfig.java:1-65
  • LoginActivityService.java:1-106
  • AuthController.java:1-82

Sa-Token 在此项目中只做登录检查,不做角色和菜单权限;权限边界主要由 is_admin 标志和业务逻辑控制。客户端 token 通过 x-token 请求头传递。

章节来源

  • SaTokenWebConfig.java:1-65
  • AuthController.java:1-82

关键组件分析

用户登录与 Sa-Token 会话

登录流程:

  1. 前端调用 /auth/login。
  2. AuthController 委托 SysUserService.login。
  3. 服务层从 sys_user 读取用户,校验密码和状态。
  4. 若账号正在其他设备使用,且未强制登录,则返回占用异常。
  5. 登录后调用 StpUtil.login(userId) 生成 Sa-Token。
  6. 调用 LoginActivityService.touch 记录 Redis 活跃度。
  7. 更新 sys_user.last_login_time。
  8. 返回 token 和用户基本信息。

登出流程:

  1. 释放当前 token 打开的案件数据源。
  2. 调用 StpUtil.logout() 注销 token。

    flowchart TD
    Start(["登录入口"]) --> Validate["校验用户名和密码"]
    Validate --> Valid{"凭证有效?"}
    Valid -->|否| ReturnError["返回用户名或密码错误"]
    Valid -->|是| CheckStatus["检查账号状态"]
    CheckStatus --> Enabled{"账号启用?"}
    Enabled -->|否| ReturnDisabled["返回账号已被停用"]
    Enabled -->|是| CheckInUse["检查账号是否正在使用"]
    CheckInUse --> InUse{"正在使用且未强制登录?"}
    InUse -->|是| ReturnInUse["返回账号正在其他设备使用"]
    InUse -->|否| Login["StpUtil.login(userId)"]
    Login --> Touch["记录 Redis 活跃度"]
    Touch --> UpdateLastLogin["更新最后登录时间"]
    UpdateLastLogin --> ReturnToken["返回 token 和用户信息"]
    

图表来源

  • SysUserService.java:1-200
  • LoginActivityService.java:1-106
  • AuthController.java:1-82

章节来源

  • SysUserService.java:1-200
  • LoginActivityService.java:1-106
  • AuthController.java:1-82

许可证校验与 system_info

许可证校验的核心是本地授权文件和外部激活命令:

  • LicenseUtil.checkAuthStatus 会检查授权文件是否存在,并调用激活器命令解析授权码。
  • 结果带 60 秒进程级缓存,避免频繁启动子进程。
  • SystemService.noNet 接收上传的 .xlts 授权文件,写入磁盘,校验成功后更新 system_info。
  • SystemService.info 根据 overdatetime 计算剩余天数。

    flowchart TD
    Upload["上传授权文件"] --> SaveFile["写入 license.xlts"]
    SaveFile --> Verify["LicenseUtil.checkAuthStatus()"]
    Verify --> Valid{"授权有效?"}
    Valid -->|否| Reject["拒绝更新并返回错误"]
    Valid -->|是| ReadAuth["读取授权信息"]
    ReadAuth --> Persist["写入 system_info"]
    Persist --> Done["完成激活"]
    

图表来源

  • LicenseUtil.java:1-163
  • SystemService.java:1-200
  • SystemInfo.java:17-71

章节来源

  • LicenseUtil.java:1-163
  • SystemService.java:1-200
  • SystemInfo.java:17-71

账号活跃检测与 Redis

LoginActivityService 用 Redis 维护“半小时内是否在使用”的状态:

  • Key 前缀:zsjz:auth:last-active:{userId}。
  • Value:最后活跃毫秒时间戳。
  • TTL:可配置的窗口分钟数,默认 30 分钟。
  • 每个节点对同一用户每分钟最多写一次 Redis,降低写入压力。
  • Redis 异常不会阻断登录,而是记录日志并按“不在使用中”处理。

    sequenceDiagram
    participant Client as "前端"
    participant Interceptor as "Sa-Token 拦截器"
    participant Activity as "LoginActivityService"
    participant Redis as "Redis"
    
    Client->>Interceptor: "已登录请求"
    Interceptor->>Activity: "touch(userId)"
    Activity->>Activity: "判断是否达到节流间隔"
    Activity->>Redis: "set key, ttl=windowMinutes"
    Redis-->>Activity: "成功或异常"
    Activity-->>Interceptor: "不影响主流程"
    

图表来源

  • LoginActivityService.java:1-106
  • SaTokenWebConfig.java:1-65

章节来源

  • LoginActivityService.java:1-106

依赖关系分析

classDiagram
    class SysUser {
        +Long id
        +String username
        +String pwdHash
        +String displayName
        +Integer isAdmin
        +Integer status
        +LocalDateTime createTime
        +LocalDateTime updateTime
        +LocalDateTime lastLoginTime
    }

    class SystemInfo {
        +String machinecode
        +String clientNo
        +String unit
        +String phone
        +LocalDate authdatetime
        +LocalDate overdatetime
        +LocalDateTime activeDateTime
        +Long remainingDate
    }

    class AuthController {
        +login(dto)
        +logout()
        +info()
        +changePwd(dto)
        +verifyPwd(dto)
    }

    class SysUserService {
        +login(dto)
        +logout()
        +info()
        +changePwd(dto)
        +verifyPwd(password)
        +list(keyword, page, size)
        +create(dto)
    }

    class LoginActivityService {
        +touch(userId)
        +isInUse(userId)
    }

    class LicenseUtil {
        +checkAuthStatus()
        +exec(cmd)
        +getActivator()
    }

    class SystemService {
        +info()
        +machineCode()
        +noNet(file)
        +cleanCache()
    }

    AuthController --> SysUserService : "调用"
    SysUserService --> LoginActivityService : "活跃度检测"
    SystemService --> LicenseUtil : "授权校验"
    SysUserService --> SysUser : "读写用户"
    SystemService --> SystemInfo : "读写系统授权"

图表来源

  • SysUser.java:21-61
  • SystemInfo.java:17-71
  • AuthController.java:1-82
  • SysUserService.java:1-200
  • LoginActivityService.java:1-106
  • LicenseUtil.java:1-163
  • SystemService.java:1-200

章节来源

  • SysUser.java:21-61
  • SystemInfo.java:17-71
  • AuthController.java:1-82
  • SysUserService.java:1-200
  • LoginActivityService.java:1-106
  • LicenseUtil.java:1-163
  • SystemService.java:1-200

典型查询场景

按用户查会话

目标:根据 sys_user.id 找到该用户创建的聊天会话。

当前实现中,chat_session.case_id 表示会话所属案件,而不是直接绑定用户。因此推荐查询顺序:

  1. 按 case_info.owner_id = ? 查出案件 ID。
  2. 按 chat_session.case_id IN (...) 查出会话。
  3. 可选:按 chat_message.session_id 查询消息。

    flowchart TD
    A["输入 userId"] --> B["SELECT id FROM case_info WHERE owner_id = ?"]
    B --> C["SELECT * FROM chat_session WHERE case_id IN (子查询)"]
    C --> D["SELECT * FROM chat_message WHERE session_id IN (子查询)"]
    

补充建议:

  • 如果未来需要“用户维度直接查会话”,可在 chat_session 增加 user_id 字段并建索引。
  • 当前 SQL 未对 chat_message.session_id 建索引,高频按会话查消息时建议添加。

章节来源

  • sql/plat.sql:71-96
  • sql/user.sql:45-75

查绑定的 ai-server 节点

当前仓库中未发现“用户绑定 ai-server 节点”的专用表。ai-server 在项目中更多表现为后端服务实例,而网关侧存在路由、节点和健康检查相关代码。就数据库层面而言:

  • 没有在 sys_user、system_info 或 chat_* 表中看到 ai-server 节点绑定字段。
  • 如果有“某用户只能使用某个 ai-server 节点”的需求,应新增独立表,例如用户-节点绑定表,并以用户 ID 和节点标识建立唯一约束。
  • 当前 chat_model.provider_code、chat_model.api_host 更偏向模型供应商配置,而非运行时节点绑定。

章节来源

  • sql/plat.sql:98-126
  • SystemInfo.java:17-71

查授权有效期

目标:查看当前机器的授权是否有效、何时过期、剩余多少天。

推荐查询:

SELECT
    machinecode,
    client_no,
    unit,
    phone,
    active_date_time,
    authdatetime,
    overdatetime,
    GREATEST(0, DATE('now') - overdatetime) AS remaining_days
FROM system_info
ORDER BY overdatetime DESC
LIMIT 1;

说明:

  • 实际业务中优先取最新一条记录。
  • 剩余天数可由数据库或 Java 层计算;Java 层通过 SystemService.info 计算 remainingDate。

章节来源

  • sql/plat.sql:31-41
  • SystemService.java:1-200

查用户是否被停用或密码过期

数据库侧:

  • sys_user.status = 0 表示停用。
  • 当前没有“密码过期时间”字段,只有 pwd_hash。
  • 如果需要密码过期策略,应新增 pwd_expire_time 或类似字段,并配合索引。

章节来源

  • sql/user.sql:19-43
  • SysUser.java:21-61

性能与容量建议

表 建议
sys_user 用户量通常较小,现有唯一索引已足够;列表查询已有分页。
system_info 授权信息通常只有一行;若多实例部署,需明确主从复制策略。
case_info owner_id 查询较多,索引 idx_case_info_owner 很重要。
chat_message 如按会话高频查询,建议为 session_id 加索引。
chat_session 如按用户高频查会话,建议增加 user_id 并建索引。
knowledge_fragment 文档片段可能很大,建议评估分片、归档或向量存储方案。
chat_model.api_key 敏感配置,不建议大表频繁全表扫描暴露。

Sa-Token 会话本身不一定持久化在 sys_user 或 system_info 中;当前会话令牌由 Sa-Token 管理,活跃状态通过 Redis 维护。若 Sa-Token 后端改为数据库存储,应单独建立会话表,而不是复用业务表。

[本节为通用性能建议,不直接分析特定代码文件]

数据安全与备份恢复

敏感字段保护

位置 敏感内容 保护要求
sys_user.pwd_hash 密码哈希 不返回前端;不落盘明文密码;日志不记录密码
chat_model.api_key 模型 API 密钥 接口返回时脱敏或隐藏;备份加密
system_info.phone 联系方式 备份加密;审计导出时脱敏
chat_message.content 用户对话内容 备份加密;保留策略明确
case_info.pwd 历史口令字段 不再使用,但历史数据仍需保护
license.xlts 授权文件 文件系统权限最小化,备份加密

备份恢复建议

  1. PostgreSQL 主库:至少包含 sys_user、system_info、case_info、chat_session、chat_message、chat_model。
  2. Redis:包含 zsjz:auth:last-active:* 等活跃标记;即使丢失也不应阻断登录,但会影响“账号是否正在使用”的判断。
  3. 授权文件:license.xlts 不在数据库中,必须单独备份。
  4. 恢复顺序:
    • 先恢复 PostgreSQL;
    • 再恢复 Redis;
    • 最后确认 license.xlts 存在并可被激活器读取。
  5. 恢复后校验:
    • 检查 sys_user 管理员账户状态;
    • 检查 system_info.overdatetime;
    • 尝试登录并调用 /sys/checkAuth 或系统授权接口。

备份频率建议

数据类型 建议频率 保留周期
PostgreSQL 主库 每日全量 + 增量 至少 30 天
Redis 每次部署前、授权变更后 可短期保留
授权文件 每次更新 永久保留
聊天记录 按合规策略 建议分级保留

[本节为通用安全与备份建议,不直接分析特定代码文件]

常见运维问题排查

登录提示“账号正在其他设备使用”

可能原因:

  • Redis 中存在该用户的活跃标记。
  • 另一台设备仍持有有效 Sa-Token。
  • 用户未选择“强制登录”。

排查步骤:

  1. 检查 Redis 中 zsjz:auth:last-active:{userId} 是否存在。
  2. 检查 Sa-Token 中该用户是否仍有有效 token。
  3. 前端重新提交带强制登录参数,后端会调用踢下线逻辑。

章节来源

  • LoginActivityService.java:1-106
  • SysUserService.java:1-200

登录后长时间不操作却被误判为在线

可能原因:

  • Redis 活跃标记 TTL 大于业务期望窗口。
  • 窗口配置过大。
  • 旧 token 仍存在且未被顶号。

处理建议:

  • 调整 zsjz.auth.in-use-window-minutes。
  • 清理 Redis 中残留活跃标记。
  • 使用 Sa-Token 踢下线或登出接口清理会话。

章节来源

  • LoginActivityService.java:1-106

授权失效或机器码不匹配

可能原因:

  • license.xlts 不存在。
  • 授权文件被替换到错误路径。
  • 激活器命令执行失败。
  • 机器码变化导致授权失效。

排查步骤:

  1. 检查授权文件路径和权限。
  2. 查看 LicenseUtil 执行的命令日志。
  3. 检查 system_info.machinecode 是否为预期值。
  4. 重新上传授权文件。

章节来源

  • LicenseUtil.java:1-163
  • SystemService.java:1-200

无法查询用户对应的会话

可能原因:

  • chat_session 没有直接 user_id 字段。
  • 需要先通过 case_info.owner_id 定位案件,再查会话。
  • chat_message.session_id 缺少索引导致查询慢。

处理建议:

  • 使用案件归属间接查询。
  • 如需用户直连会话,扩展 chat_session.user_id。
  • 为 chat_message.session_id 增加索引。

章节来源

  • sql/plat.sql:71-96
  • sql/user.sql:45-75

结论

当前平台的用户授权数据主要落在两张核心表:

  • sys_user:负责系统用户认证、管理员标志、启用状态和最后登录时间;
  • system_info:负责机器码、客户编号、单位、联系方式和授权有效期。

Sa-Token 负责会话与 token 管理,Redis 负责“账号是否正在使用”的活跃判定,许可证文件负责离线授权,三者共同构成认证、会话和授权的闭环。

目前仓库中没有“水印”和“授权单元”的数据库表。若后续引入水印或授权单元,建议:

  • 新增独立的授权单元表,绑定机器码、客户编号、单位、有效期和功能范围;
  • 新增水印策略表,绑定用户、案件、租户或设备;
  • 将水印和授权单元与 system_info、sys_user 建立清晰的外键或逻辑关联;
  • 对敏感字段进行加密存储、脱敏输出和审计记录。