本文引用的文件
本文聚焦平台基础与用户授权相关的数据库设计,覆盖 plat 模块中的系统配置、表信息、会话与缓存、知识库与聊天等辅助表,以及 user 脚本中定义的用户体系。文档重点说明:
sys_user 用户的身份、状态和账号生命周期;system_info 的系统机器码、客户编号、单位、手机号、授权时间和过期时间;平台基础数据主要落在 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
图表来源
章节来源
| 字段 | 类型 | 约束 | 语义 |
|---|---|---|---|
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
}
图表来源
章节来源
| 字段 | 类型 | 约束 | 语义 |
|---|---|---|---|
machinecode |
TEXT |
主键 | 服务器机器码,作为授权绑定标识 |
client_no |
TEXT |
可空 | 客户编号 |
unit |
TEXT |
可空 | 单位 |
phone |
TEXT |
可空 | 联系方式 |
active_date_time |
DATE |
可空 | 激活时间 |
authdatetime |
DATE |
可空 | 授权开始时间 |
overdatetime |
DATE |
可空 | 授权过期时间 |
实体中还包含一个计算字段:
| 字段 | 类型 | 约束 | 语义 |
|---|---|---|---|
remainingDate |
Long |
非持久化字段 | 剩余天数,由服务根据 overdatetime 与当前日期计算 |
注意:
id 自增主键,而是以 machinecode 作为主键。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
}
图表来源
章节来源
| 字段 | 类型 | 约束 | 语义 |
|---|---|---|---|
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 : "拥有"
图表来源
章节来源
这两张表服务于“案件库的业务表语义检索”,即描述外部表的结构元数据,而不是平台自身的权限表。
| 字段 | 类型 | 约束 | 语义 |
|---|---|---|---|
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 |
可空 | 创建时间 |
| 字段 | 类型 | 约束 | 语义 |
|---|---|---|---|
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 : "包含字段"
图表来源
章节来源
| 表 | 关键字段 | 语义 |
|---|---|---|
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 : "包含消息"
图表来源
章节来源
| 表 | 关键字段 | 语义 |
|---|---|---|
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 : "提供模型"
图表来源
章节来源
| 表 | 关键字段 | 语义 |
|---|---|---|
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 |
知识库附件 |
这些表主要用于知识库、向量检索和文档处理,不属于用户授权核心表,但与平台基础能力密切相关。
章节来源
| 表 | 主键 | 用途 |
|---|---|---|
phone_isp |
paragraph |
手机号段归属省份、城市、运营商 |
bank_card_issuer_info |
bank_bin |
银行卡发卡行 BIN 信息 |
章节来源
平台认证、授权与会话的关系如下:
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: "业务响应"
图表来源
Sa-Token 在此项目中只做登录检查,不做角色和菜单权限;权限边界主要由 is_admin 标志和业务逻辑控制。客户端 token 通过 x-token 请求头传递。
章节来源
登录流程:
/auth/login。AuthController 委托 SysUserService.login。sys_user 读取用户,校验密码和状态。StpUtil.login(userId) 生成 Sa-Token。LoginActivityService.touch 记录 Redis 活跃度。sys_user.last_login_time。登出流程:
调用 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 和用户信息"]
图表来源
章节来源
许可证校验的核心是本地授权文件和外部激活命令:
LicenseUtil.checkAuthStatus 会检查授权文件是否存在,并调用激活器命令解析授权码。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["完成激活"]
图表来源
章节来源
LoginActivityService 用 Redis 维护“半小时内是否在使用”的状态:
zsjz:auth:last-active:{userId}。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: "不影响主流程"
图表来源
章节来源
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 : "读写系统授权"
图表来源
章节来源
目标:根据 sys_user.id 找到该用户创建的聊天会话。
当前实现中,chat_session.case_id 表示会话所属案件,而不是直接绑定用户。因此推荐查询顺序:
case_info.owner_id = ? 查出案件 ID。chat_session.case_id IN (...) 查出会话。可选:按 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 字段并建索引。chat_message.session_id 建索引,高频按会话查消息时建议添加。章节来源
当前仓库中未发现“用户绑定 ai-server 节点”的专用表。ai-server 在项目中更多表现为后端服务实例,而网关侧存在路由、节点和健康检查相关代码。就数据库层面而言:
sys_user、system_info 或 chat_* 表中看到 ai-server 节点绑定字段。chat_model.provider_code、chat_model.api_host 更偏向模型供应商配置,而非运行时节点绑定。章节来源
目标:查看当前机器的授权是否有效、何时过期、剩余多少天。
推荐查询:
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;
说明:
SystemService.info 计算 remainingDate。章节来源
数据库侧:
sys_user.status = 0 表示停用。pwd_hash。pwd_expire_time 或类似字段,并配合索引。章节来源
| 表 | 建议 |
|---|---|
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 |
授权文件 | 文件系统权限最小化,备份加密 |
sys_user、system_info、case_info、chat_session、chat_message、chat_model。zsjz:auth:last-active:* 等活跃标记;即使丢失也不应阻断登录,但会影响“账号是否正在使用”的判断。license.xlts 不在数据库中,必须单独备份。license.xlts 存在并可被激活器读取。sys_user 管理员账户状态;system_info.overdatetime;/sys/checkAuth 或系统授权接口。| 数据类型 | 建议频率 | 保留周期 |
|---|---|---|
| PostgreSQL 主库 | 每日全量 + 增量 | 至少 30 天 |
| Redis | 每次部署前、授权变更后 | 可短期保留 |
| 授权文件 | 每次更新 | 永久保留 |
| 聊天记录 | 按合规策略 | 建议分级保留 |
[本节为通用安全与备份建议,不直接分析特定代码文件]
可能原因:
排查步骤:
zsjz:auth:last-active:{userId} 是否存在。章节来源
可能原因:
处理建议:
zsjz.auth.in-use-window-minutes。章节来源
可能原因:
license.xlts 不存在。排查步骤:
LicenseUtil 执行的命令日志。system_info.machinecode 是否为预期值。章节来源
可能原因:
chat_session 没有直接 user_id 字段。case_info.owner_id 定位案件,再查会话。chat_message.session_id 缺少索引导致查询慢。处理建议:
chat_session.user_id。chat_message.session_id 增加索引。章节来源
当前平台的用户授权数据主要落在两张核心表:
sys_user:负责系统用户认证、管理员标志、启用状态和最后登录时间;system_info:负责机器码、客户编号、单位、联系方式和授权有效期。Sa-Token 负责会话与 token 管理,Redis 负责“账号是否正在使用”的活跃判定,许可证文件负责离线授权,三者共同构成认证、会话和授权的闭环。
目前仓库中没有“水印”和“授权单元”的数据库表。若后续引入水印或授权单元,建议:
system_info、sys_user 建立清晰的外键或逻辑关联;