Skip to content

核心数据表 ​

1. 管理员表 (admin_users) ​

字段名类型说明
user_idBIGINT主键(统一 user_id 命名)
user_nameVARCHAR用户名
emailVARCHAR邮箱地址
phoneVARCHAR手机号
nameVARCHAR昵称/姓名
avatarVARCHAR头像 URL
statusTINYINT状态(0禁用,1启用)
passwordVARCHAR密码哈希
login_countINT登录次数
last_login_ipVARCHAR最后登录 IP
last_login_atTIMESTAMP最后登录时间
last_active_atTIMESTAMP最后活动时间
created_atTIMESTAMP创建时间
updated_atTIMESTAMP更新时间
deleted_atTIMESTAMP删除时间(软删除)

2. 后台菜单表 (admin_menus) ​

字段名类型说明
menu_idBIGINT主键
parent_idBIGINT父级菜单 ID
pathVARCHAR路由路径
nameVARCHAR路由名称
componentVARCHAR组件路径
redirectVARCHAR重定向路径
titleVARCHAR菜单标题
iconVARCHAR菜单图标
typeTINYINT类型(0目录,1菜单,2按钮)
permissionVARCHAR权限标识
is_enableBOOLEAN是否启用
is_hideBOOLEAN是否隐藏菜单
is_hide_tabBOOLEAN是否隐藏标签
is_iframeBOOLEAN是否 iframe 嵌入
keep_aliveBOOLEAN是否缓存
is_full_pageBOOLEAN是否全屏
fixed_tabBOOLEAN是否固定标签
show_badgeBOOLEAN是否显示徽章
show_text_badgeVARCHAR徽章文本
active_pathVARCHAR激活路径
linkVARCHAR外部链接
sortINT排序
created_atTIMESTAMP创建时间
updated_atTIMESTAMP更新时间

3. 用户表 (users) ​

字段名类型说明
user_idBIGINT主键
user_nameVARCHAR用户名
emailVARCHAR邮箱地址
mobileVARCHAR手机号
avatarVARCHAR头像
statusTINYINT状态
available_pointsINT可用积分
available_coinsINT可用金币
balanceDECIMAL(16,2)钱包可用余额(元)
frozen_balanceDECIMAL(16,2)钱包冻结余额(元)
vip_expires_atTIMESTAMPVIP 过期时间
passwordVARCHAR密码哈希
login_countINT登录次数
last_login_ipVARCHAR最后登录 IP
last_login_atTIMESTAMP最后登录时间
last_active_atTIMESTAMP最后活动时间
email_verified_atTIMESTAMP邮箱验证时间
mobile_verified_atTIMESTAMP手机验证时间
created_atTIMESTAMP创建时间
updated_atTIMESTAMP更新时间
deleted_atTIMESTAMP删除时间(软删除)

4. 用户扩展表 ​

表名说明
user_extras用户额外信息(性别、生日、签名等)
user_profiles用户画像/偏好

5. 角色和权限表(spatie/laravel-permission) ​

表名说明
roles角色表
permissions权限表
model_has_roles模型角色关联表(多态)
model_has_permissions模型权限关联表(多态)
role_has_permissions角色权限关联表

6. 系统配置表 (settings) ​

字段名类型说明
idBIGINT主键
nameVARCHAR配置名称
keyVARCHAR配置键名(唯一)
valueTEXT配置值
cast_typeVARCHAR数据类型(string/int/float/bool/json)
input_typeVARCHAR输入类型
paramTEXT参数配置(JSON)
remarkVARCHAR备注
sortINT排序
created_atTIMESTAMP创建时间
updated_atTIMESTAMP更新时间

7. 地区表 (areas) ​

字段名类型说明
idBIGINT主键
parent_idBIGINT父级地区 ID
nameVARCHAR地区名称
area_codeINT地区代码
city_codeVARCHAR城市代码
latDECIMAL纬度
lngDECIMAL经度
levelTINYINT层级
sortINT排序
created_atTIMESTAMP创建时间
updated_atTIMESTAMP更新时间

8. 验证码表 ​

表名说明关键字段
phone_codes短信验证码phone、scene、code、state、ip、send_at
mail_codes邮件验证码email、scene、code、state、ip、send_at

9. 登录历史表 (login_histories) ​

字段名类型说明
idBIGINT主键
user_typeVARCHAR用户类型(多态:App\Models\User / App\Models\Admin\Admin)
user_idBIGINT用户 ID
ipVARCHAR登录 IP
portINT端口
platformVARCHAR平台
deviceVARCHAR设备
browserVARCHAR浏览器
user_agentTEXTUser-Agent
addressVARCHAR地址
login_atTIMESTAMP登录时间
created_atTIMESTAMP创建时间
updated_atTIMESTAMP更新时间

10. 附件表 (attachments) ​

字段名类型说明
idBIGINT主键(从 10000000 起)
uploader_typeVARCHAR上传者类型(多态)
uploader_idBIGINT上传者 ID
diskVARCHAR存储磁盘(local/public/s3 等)
pathVARCHAR物理存储路径
nameVARCHAR显示名称
original_nameVARCHAR原始文件名
extensionVARCHAR文件扩展名
mime_typeVARCHARMIME 类型
typeVARCHAR附件类型(image/video/audio/document/other)
sizeBIGINT文件大小(字节)
hashCHAR(32)文件 MD5 哈希(用于去重校验)
created_atTIMESTAMP创建时间
updated_atTIMESTAMP更新时间
deleted_atTIMESTAMP删除时间(软删除)

索引:(uploader_type, uploader_id) 复合索引、type 索引、hash 索引、(disk, path) 唯一索引。

11. 审计日志表 (audit_logs) ​

字段名类型说明
idBIGINT主键
admin_idBIGINT操作管理员 ID
methodVARCHARHTTP 方法
pathVARCHAR请求路径
queryTEXTQuery 参数(JSON)
bodyTEXT请求体(JSON,脱敏)
status_codeINT响应状态码
ipVARCHAR请求 IP
user_agentVARCHARUser-Agent
duration_msINT请求耗时(毫秒)
created_atTIMESTAMP创建时间

12. 调度任务日志表 (schedule_logs) ​

字段名类型说明
idBIGINT主键
task_nameVARCHAR任务名称
task_typeVARCHAR任务类型(command/callback/exec)
expressionVARCHARCron 表达式
statusVARCHAR执行状态(running/success/failed/skipped)
exit_codeINT退出码
duration_msINT执行耗时(毫秒)
exceptionTEXT异常信息摘要
started_atTIMESTAMP开始时间
finished_atTIMESTAMP结束时间
created_atTIMESTAMP创建时间

通过 Schedule::task 的事件监听自动记录,支持按 schedule.log_prunable_days 设置自动清理。

13. AI 对话表 ​

表名说明
agent_conversationsAI 会话列表(管理员 ID、标题、模型、创建/更新时间)
agent_messagesAI 消息记录(会话 ID、角色 user/assistant/tool、内容、工具调用信息等)

14. 其他核心表 ​

表名说明
personal_access_tokensSanctum 个人访问令牌
notifications站内通知(多态)
socials第三方账号绑定
password_reset_tokens密码重置令牌

文档来源:PRD 第 5.1 节