🗄️ 数据库ER图设计

OpenClaw私域运营小程序 · 数据库架构与表结构

📊 技术栈概览
主数据库
MySQL 8.0
缓存
Redis 7.0
搜索引擎
Elasticsearch 8.0
文档库
MongoDB 6.0
分析库
ClickHouse 23.0

8 大模块30+ 张核心表,遵循第三范式设计,支持索引优化、分区策略和缓存策略。

🔗 核心实体关系图
erDiagram users ||--o{ user_profiles : has users ||--o{ user_tags : has users ||--o{ user_learning_progress : has users ||--o{ user_devices : has users ||--o{ user_sessions : has users ||--o{ user_auth_tokens : has users ||--o{ user_content_actions : performs users ||--o{ event_registrations : makes users ||--o{ event_submissions : submits users ||--o{ notifications : receives users ||--o{ comments : writes users ||--o{ user_relationships : follows users ||--o{ messages : sends users ||--o{ openclaw_users : connects_to contents ||--o{ content_chapters : contains contents ||--o{ content_resources : contains contents ||--o{ user_content_actions : affects contents ||--o{ content_analytics : generates categories ||--o{ contents : categorizes categories ||--o{ events : categorizes events ||--o{ event_tasks : has events ||--o{ event_registrations : receives events ||--o{ event_submissions : gets notifications ||--o{ notification_logs : logs comments ||--o{ comments : replies_to openclaw_users ||--o{ openclaw_projects : owns openclaw_users ||--o{ openclaw_sync_logs : generates
👤 用户中心模块

users 用户主表

字段类型说明
idVARCHAR(36)主键
usernameVARCHAR(50)用户名
emailVARCHAR(100)邮箱
phoneVARCHAR(20)手机号
password_hashVARCHAR(255)密码哈希
statusENUMactive/inactive/banned
created_atTIMESTAMP创建时间

user_profiles 用户画像

字段类型说明
idVARCHAR(36)主键
user_idVARCHAR(36)关联用户
avatarVARCHAR(255)头像URL
nicknameVARCHAR(100)昵称
bioTEXT个人简介
interestsJSON兴趣标签
engagement_levelENUM参与度等级

user_tags 用户标签

字段类型说明
idVARCHAR(36)主键
user_idVARCHAR(36)关联用户
tag_nameVARCHAR(100)标签名
sourceENUMsystem/user/auto

user_learning_progress 学习进度

字段类型说明
idVARCHAR(36)主键
user_idVARCHAR(36)关联用户
content_idVARCHAR(36)关联内容
progressDECIMAL(5,2)进度百分比
completedBOOLEAN是否完成
study_timeINT学习时长(秒)
📚 内容运营模块

contents 内容主表

字段类型说明
idVARCHAR(36)主键
titleVARCHAR(200)标题
content_typeENUMarticle/video/course
category_idVARCHAR(36)分类
author_idVARCHAR(36)作者
statusENUMdraft/published
tagsJSON标签列表
view_countINT浏览量

categories 分类表

字段类型说明
idVARCHAR(36)主键
nameVARCHAR(100)分类名
slugVARCHAR(120)URL标识
parent_idVARCHAR(36)父分类
sort_orderINT排序

content_chapters 章节表

字段类型说明
idVARCHAR(36)主键
content_idVARCHAR(36)关联内容
titleVARCHAR(200)章节标题
order_indexINT排序
durationINT时长(秒)
video_urlVARCHAR(255)视频URL

user_content_actions 内容行为

字段类型说明
idVARCHAR(36)主键
user_idVARCHAR(36)关联用户
content_idVARCHAR(36)关联内容
action_typeENUMview/like/favorite
created_atTIMESTAMP行为时间
🎯 活动管理模块

events 活动主表

字段类型说明
idVARCHAR(36)主键
titleVARCHAR(200)活动标题
event_typeENUMchallenge/contest/webinar
statusENUMdraft/active/completed
start_timeTIMESTAMP开始时间
end_timeTIMESTAMP结束时间
max_participantsINT最大参与人数

event_tasks 活动任务

字段类型说明
idVARCHAR(36)主键
event_idVARCHAR(36)关联活动
titleVARCHAR(200)任务标题
task_typeENUMcontent/action/social
pointsINT积分
order_indexINT排序

event_registrations 活动报名

字段类型说明
idVARCHAR(36)主键
event_idVARCHAR(36)关联活动
user_idVARCHAR(36)关联用户
statusENUMpending/approved
team_nameVARCHAR(200)团队名

event_submissions 任务提交

字段类型说明
idVARCHAR(36)主键
event_idVARCHAR(36)关联活动
task_idVARCHAR(36)关联任务
user_idVARCHAR(36)提交用户
statusENUMpending/approved
points_earnedINT获得积分
📊 分析统计模块

user_events 行为事件

字段类型说明
idVARCHAR(36)主键
user_idVARCHAR(36)关联用户
event_typeVARCHAR(50)事件类型
event_dataJSON事件数据
timestampTIMESTAMP事件时间
session_idVARCHAR(36)会话ID

content_analytics 内容分析

字段类型说明
idVARCHAR(36)主键
content_idVARCHAR(36)关联内容
dateDATE统计日期
views_countINT浏览量
completion_rateDECIMAL(5,2)完成率
bounce_rateDECIMAL(5,2)跳出率

analytics_reports 分析报告

字段类型说明
idVARCHAR(36)主键
report_nameVARCHAR(200)报告名
report_typeENUMdaily/weekly/monthly
metricsJSON指标列表
statusENUMdraft/active/paused
🔔 通知系统模块

notifications 通知表

字段类型说明
idVARCHAR(36)主键
user_idVARCHAR(36)目标用户
titleVARCHAR(200)通知标题
notification_typeENUMsystem/content/event
priorityENUMlow/normal/high/urgent
readBOOLEAN是否已读
channelsJSON投递渠道

notification_templates 通知模板

字段类型说明
idVARCHAR(36)主键
template_nameVARCHAR(100)模板名
template_typeENUMsystem/content/event
content_templateTEXT内容模板
variablesJSON变量列表
💬 社交互动模块

comments 评论表

字段类型说明
idVARCHAR(36)主键
content_idVARCHAR(36)关联内容
user_idVARCHAR(36)评论者
parent_idVARCHAR(36)父评论
contentTEXT评论内容
likes_countINT点赞数

user_relationships 用户关系

字段类型说明
idVARCHAR(36)主键
follower_idVARCHAR(36)关注者
following_idVARCHAR(36)被关注者
relationship_typeENUMfollow/friend/block
statusENUMactive/pending

messages 消息表

字段类型说明
idVARCHAR(36)主键
conversation_idVARCHAR(36)会话
sender_idVARCHAR(36)发送者
recipient_idVARCHAR(36)接收者
contentTEXT消息内容
message_typeENUMtext/image/file
🔗 OpenClaw集成模块

openclaw_users OC用户映射

字段类型说明
idVARCHAR(36)主键
local_user_idVARCHAR(36)本地用户
openclaw_user_idVARCHAR(36)OC用户ID
permissionsJSON权限列表
sync_statusENUMactive/inactive/error
last_sync_atTIMESTAMP最后同步

openclaw_projects OC项目

字段类型说明
idVARCHAR(36)主键
project_idVARCHAR(36)OC项目ID
nameVARCHAR(200)项目名
owner_idVARCHAR(36)项目所有者
visibilityENUMpublic/private

openclaw_sync_logs 同步日志

字段类型说明
idVARCHAR(36)主键
sync_typeVARCHAR(50)同步类型
sync_statusENUMsuccess/failed/partial
records_processedINT处理记录数
records_failedINT失败记录数
error_messageTEXT错误信息