CmsKit 实体参考

本文档提供CmsKit系统中所有数据库实体的详细说明，以表格形式展示。

内容实体

Article（文章表 cms_article）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
Title	string	标题
Keywords	string	关键字
Source	string	来源
Excerpt	string	摘要
Content	string	正文
ViewHits	int	浏览量
CommentQuantity	int	评论数量
LikesQuantity	int	点赞数量
CollectQuantity	int	收藏数量
Thumbnail	string	列表缩略图封面
AuditStatus	enum	审核状态	IX_Article_AuditStatus_CreateTime: 用于按审核状态和时间筛选列表
AuditText	string	审核信息
AuditTime	DateTime?	审核时间
Recommend	bool	是否推荐	IX_Article_IsStickie_Recommend_CreateTime: 用于筛选置顶、推荐文章并排序
RecommendTime	DateTime?	推荐时间
IsStickie	bool	是否置顶	同上
Archive	string	随笔档案（如2019年1月）	IX_Article_Archive: 用于按归档月份查询
ArticleSource	enum	随笔类型（原创、转载、翻译）
Editor	enum	编辑器类型（1:MarkDown 2:富文本）
WordNumber	long	字数
ReadingTime	long	预计阅读时长
Commentable	bool	随笔是否开启评论
ClientIp	string	客户端IP
ClientAddress	string	客户端地址
CreateUserId	Guid?	创建用户ID	IX_Article_CreateUserId_CreateTime: 用于查询特定用户的文章列表并排序
CreateTime	DateTime	创建时间	包含在多个索引中用于排序

ArticleDraft（文章草稿表 cms_article_draft）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
ArticleId	Guid	关联随笔ID	IX_ArticleDraft_ArticleId: 用于快速查找文章对应的草稿
Title	string	标题
Content	string	内容
Status	enum	草稿状态
LastModificationTime	DateTime	最后修改时间
CreateUserId	Guid?	创建用户ID	IX_ArticleDraft_CreateUserId_LastModificationTime: 用于查询用户草稿列表并排序

ArticleTag（文章标签关联表 cms_article_tag）

字段名称	类型	描述	关键字段与索引建议
ArticleId	Guid	文章ID	复合主键 (PK: ArticleId, TagId), IX_ArticleTag_TagId: 用于按标签查找文章
TagId	Guid	标签ID	复合主键 (PK: ArticleId, TagId), IX_ArticleTag_ArticleId: 用于查找文章的标签 (主键已包含)

Classify（分类表 cms_classify）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
Name	string	分类名称	IX_Classify_UserId_Name: 用于特定用户下按名称查找分类 (可考虑唯一约束)
Description	string	分类描述
ArticleCount	int	文章数量
UserId	Guid	所属用户ID	IX_Classify_UserId_SortCode: 用于查询用户分类列表并排序
Status	bool	状态
SortCode	int	排序	包含在 IX_Classify_UserId_SortCode 中

Channel（频道表 cms_channel）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
Name	string	频道名称
ChannelCode	string	频道代码	IX_Channel_ChannelCode: 用于按代码快速查找 (可考虑唯一约束)
Thumbnail	string	封面图
SortCode	int	排序	IX_Channel_Status_SortCode: 用于查询可用频道并排序
Status	bool	状态	包含在 IX_Channel_Status_SortCode 中

评论相关实体

Comment（评论表 cms_comment）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
SubjectId	Guid	关联随笔id	IX_Comment_SubjectId_SubjectType_CreateTime: 用于查询特定主题的评论列表并排序
SubjectType	enum	评论的对象类型	包含在 IX_Comment_SubjectId_SubjectType_CreateTime 中
Text	string	回复的文本内容
RootCommentId	Guid?	根评论ID	IX_Comment_RootCommentId_CreateTime: 用于查询某个根评论下的所有回复并排序
ParentId	Guid?	父评论ID	IX_Comment_ParentId: 用于查找子评论
RespUserId	Guid?	回复用户ID
LikesQuantity	int	点赞量
AuditStatus	enum	是否已审核	IX_Comment_AuditStatus_CreateTime: 用于查询待审核或特定状态的评论
CreateUserId	Guid?	创建用户ID	IX_Comment_CreateUserId_CreateTime: 用于查询用户发表的评论
CreateTime	DateTime	创建时间	包含在多个索引中用于排序

沸点相关实体

ShortMsg（沸点消息表 cms_short_msg）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
TopicId	Guid?	话题ID	IX_ShortMsg_TopicId_CreateTime: 用于查询话题下的沸点
ClubId	Guid?	圈子ID	IX_ShortMsg_ClubId_CreateTime: 用于查询圈子下的沸点
PollId	Guid?	投票ID	IX_ShortMsg_PollId: 用于查找沸点关联的投票
Content	string	内容
HotIndex	decimal	热度	IX_ShortMsg_HotIndex_CreateTime: 用于按热度排序沸点列表
ViewHits	int	浏览量
CommentQuantity	int	评论数量
LikesQuantity	int	点赞数量
ClientIp	string	客户端IP
ClientAddress	string	客户端地址
AuditStatus	enum	状态	IX_ShortMsg_AuditStatus_CreateTime: 用于查询特定审核状态的沸点
AuditTime	DateTime?	审核时间
AuditText	string	审核信息
CreateUserId	Guid?	创建用户ID	IX_ShortMsg_CreateUserId_CreateTime: 用于查询用户发布的沸点
CreateTime	DateTime	创建时间	包含在多个索引中用于排序

Topic（话题主题表 cms_topic）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
Name	string	名称	IX_Topic_Name: 用于按名称查找 (可考虑唯一约束)
Cover	string	封面
Brief	string	简介
IsRec	bool	是否推荐	IX_Topic_Status_IsRec_RecRank: 用于查询推荐话题并排序
RecRank	int	推荐排序	包含在 IX_Topic_Status_IsRec_RecRank 中
Hot	int	热度	IX_Topic_Status_Hot: 用于按热度查询话题
ViewCnt	int	阅读量
UserCnt	int	参与人数
Status	int	状态	包含在多个索引中
LastHot	int	最后热度

圈子相关实体

Club（圈子表 cms_club）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
CategoryId	int?	分类	IX_Club_CategoryId_Status_CreateTime: 用于按分类查询圈子
Title	string	标题
Description	string	描述
Icon	string	图标
FollowerCount	int	加入人数（关注人数）	IX_Club_Status_IsRec_FollowerCount: 用于查询推荐圈子并按人数排序
MsgCount	int	消息数量（累计发言数）
AttenderCount	int	参与数（独立用户互动行为数）
Notice	string	公告
SortCode	int	排序	IX_Club_Status_SortCode: 用于查询圈子列表并排序
Status	bool	状态	包含在多个索引中
ViewHits	int	阅读量
IsRec	bool	是否推荐	包含在 IX_Club_Status_IsRec_FollowerCount 中
RecRank	int	推荐排序
CreateUserId	Guid?	创建用户ID
CreateTime	DateTime	创建时间	包含在 IX_Club_CategoryId_Status_CreateTime 中

ClubMemberRole（圈子成员角色关联表 cms_club_member_role）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
ClubId	Guid	圈子ID	复合唯一索引 UX_ClubMemberRole_ClubId_UserId, IX_ClubMemberRole_ClubId_Role: 用于查询圈子成员角色
UserId	Guid	用户ID	复合唯一索引 UX_ClubMemberRole_ClubId_UserId, IX_ClubMemberRole_UserId: 用于查询用户角色
Role	int	角色类型（1:圈主, 2:管理员, 3:嘉宾, 4:普通成员）
ExpireTime	DateTime?	角色过期时间（null表示永久）
IsEnabled	bool	是否启用
GrantedByUserId	Guid?	授予角色的管理员ID
GrantedTime	DateTime	授予时间
ChangeReason	string?	角色变更原因
Remark	string?	备注
CreateTime	DateTime	创建时间

标签相关实体

Tag（标签表 cms_tag）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
Alias	string	别名
Thumbnail	string	标签封面图
TagName	string	标签名	IX_Tag_TagName: 用于按名称查找 (可考虑唯一约束)
Status	bool	标签状态(true:正常,false:拉黑)	IX_Tag_Status_ArticleCount: 用于查询正常标签并按文章数排序, IX_Tag_Status_SubscribersCount: 用于查询正常标签并按关注数排序
ArticleCount	int	随笔数量	包含在 IX_Tag_Status_ArticleCount 中
ViewHits	int	浏览次数
Remark	string	标签备注情况
SubscribersCount	int	关注数量	包含在 IX_Tag_Status_SubscribersCount 中

UserTag（用户标签关联表 cms_user_tag）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
TagId	Guid	标签ID	复合唯一索引 UX_UserTag_TagId_UserId, IX_UserTag_TagId_CreateTime: 用于查询标签的关注者列表
UserId	Guid	用户ID	复合唯一索引 UX_UserTag_TagId_UserId, IX_UserTag_UserId_CreateTime: 用于查询用户关注的标签列表
CreateTime	DateTime	关注时间	包含在多个索引中用于排序

ChannelTag（频道标签关联表 cms_channel_tag）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
ChannelId	Guid	频道ID	复合唯一索引 UX_ChannelTag_ChannelId_TagId, IX_ChannelTag_ChannelId_SortCode: 用于查询频道的标签列表并排序
TagId	Guid	标签ID	复合唯一索引 UX_ChannelTag_ChannelId_TagId, IX_ChannelTag_TagId: 用于查询标签所属的频道
SortCode	int	排序码	包含在 IX_ChannelTag_ChannelId_SortCode 中

投票相关实体

Poll（投票表 cms_poll）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
Code	string	编码	IX_Poll_Code: 用于按编码查找 (可考虑唯一约束)
Question	string	投票问题
AllowMultipleVote	bool	是否允许多选
VoteCount	int	投票总数
ShowVoteCount	bool	是否显示投票计数
ShowResultWithoutGivingVote	bool	是否允许未投票用户查看结果
ShowHoursLeft	bool	是否显示剩余时间（小时）
StartDate	DateTime	投票开始日期	IX_Poll_StartDate_EndDate: 用于查询进行中或已结束的投票
EndDate	DateTime	投票结束日期	包含在 IX_Poll_StartDate_EndDate 中
ResultShowingEndDate	DateTime?	结果显示截止日期
CreateUserId	Guid?	创建者ID	IX_Poll_CreateUserId_CreateTime: 用于查询用户创建的投票
CreateTime	DateTime	创建时间	包含在 IX_Poll_CreateUserId_CreateTime 中

PollOption（投票选项表 cms_poll_option）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
PollId	Guid	所属投票ID	IX_PollOption_PollId_Order: 用于查询投票的所有选项并排序
Text	string	选项文本
VoteCount	int	投票计数
Order	int	显示顺序	包含在 IX_PollOption_PollId_Order 中

PollUserVote（用户投票记录表 cms_poll_user_vote）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
PollId	Guid	投票ID	复合唯一索引 UX_PollUserVote_PollId_UserId_PollOptionId (如果允许多选则不能加OptionId), IX_PollUserVote_PollId_UserId: 用于检查用户是否已投票
UserId	Guid	用户ID	包含在复合唯一索引和 IX_PollUserVote_PollId_UserId 中
PollOptionId	Guid	所选投票选项ID	IX_PollUserVote_PollOptionId: 用于统计选项票数
CreationTime	DateTime	投票时间

用户互动实体

UserInteractionLog（用户交互日志表 cms_interaction_log）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
EntityId	Guid	关联实体ID（如随笔ID）	IX_UserInteractionLog_EntityId_EntityType_Date: 用于查询实体的日访问量
EntityType	string	关联实体类型（如Article）	包含在 IX_UserInteractionLog_EntityId_EntityType_Date 中
EntityCreateUserId	Guid	关联实体创建者Id
UserId	Guid	浏览用户ID	IX_UserInteractionLog_UserId_Date: 用于查询用户的日活跃度
Date	string	浏览时间（YYYY-MM-dd格式）	包含在多个索引中
ClientIp	string	客户端IP
InteractionType	enum	交互类型（浏览、点赞等）	IX_UserInteractionLog_EntityId_EntityType_InteractionType: 用于查询特定类型的互动

UserLike（用户点赞表 cms_user_like）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
SubjectId	Guid	被点赞实体ID	复合唯一索引 UX_UserLike_SubjectId_SubjectType_UserId, IX_UserLike_SubjectId_SubjectType_CreateTime: 用于查询实体的点赞列表
SubjectType	enum	被点赞实体类型	包含在复合唯一索引和 IX_UserLike_SubjectId_SubjectType_CreateTime 中
UserId	Guid	点赞用户ID	复合唯一索引 UX_UserLike_SubjectId_SubjectType_UserId, IX_UserLike_UserId_CreateTime: 用于查询用户的点赞列表
CreateTime	DateTime	点赞时间	包含在多个索引中用于排序

UserSubscribe（用户关注表 cms_user_subscribe）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
SubscribeUserId	Guid	被关注用户ID	复合唯一索引 UX_UserSubscribe_UserId_SubscribeUserId, IX_UserSubscribe_SubscribeUserId_CreateTime: 用于查询用户的粉丝列表
UserId	Guid	关注者用户ID	复合唯一索引 UX_UserSubscribe_UserId_SubscribeUserId, IX_UserSubscribe_UserId_CreateTime: 用于查询用户的关注列表
CreateTime	DateTime	关注时间	包含在多个索引中用于排序
Status	bool	关注状态

收藏相关实体

Collection（收藏集表 cms_collection）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
Name	string	名称	IX_Collection_CreateUserId_Name: 用于查询用户的收藏集 (可考虑唯一约束)
Remark	string	描述
Quantity	int	收藏数量
PrivacyType	enum	隐私类型（公开/仅自己可见）	IX_Collection_CreateUserId_PrivacyType: 用于根据隐私类型筛选用户收藏集
CreateUserId	Guid	创建用户ID	包含在多个索引中
CreateTime	DateTime	创建时间	IX_Collection_CreateUserId_CreateTime: 用于按时间排序用户收藏集

ArticleCollection（文章收藏关联表 cms_article_collection）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
ArticleId	Guid	文章ID	复合唯一索引 UX_ArticleCollection_ArticleId_CollectionId, IX_ArticleCollection_ArticleId: 用于查询文章被哪些收藏集收藏
CollectionId	Guid	收藏集ID	复合唯一索引 UX_ArticleCollection_ArticleId_CollectionId, IX_ArticleCollection_CollectionId_CreateTime: 用于查询收藏集内的文章列表并排序
CreateTime	DateTime	收藏时间	包含在 IX_ArticleCollection_CollectionId_CreateTime 中
Remark	string	收藏备注

CurrentVisitUser（当前访问用户表 cms_current_visit_user）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
Name	string	用户名称
Avatar	string	用户头像
EntityType	string	关联实体类型	IX_CurrentVisitUser_EntityType_EntityId_CreateTime: 用于查询正在访问特定实体的用户列表
EntityId	string	关联实体Id	包含在 IX_CurrentVisitUser_EntityType_EntityId_CreateTime 中
CreateTime	DateTime	访问时间	包含在 IX_CurrentVisitUser_EntityType_EntityId_CreateTime 中
UserId	Guid?	用户ID	IX_CurrentVisitUser_UserId: 用于快速查找特定用户的访问记录

系统实体

CmsUser（CMS用户表 cms_user）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
UserName	string	用户名	IX_CmsUser_UserName: 用于按用户名查找 (应为唯一约束)
NickName	string	昵称	IX_CmsUser_NickName: 用于按昵称查找
Introduction	string	个人介绍
AvatarKey	string	头像Key
Status	enum	状态(激活/禁用)	IX_CmsUser_Status: 用于按状态筛选用户
BlogUrl	string	博客地址
Company	string	公司
Position	string	职位
WorkDirection	string	职业方向
WorkStartTime	DateTime	开始工作时间
CreateTime	DateTime	创建时间

审核与通知实体

AuditLog（审核日志表 cms_audit_log）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
SubjectId	Guid	关联实体Id	IX_AuditLog_SubjectId_AuditLogEntityType: 用于查询特定实体的审核历史
AuditStatus	enum	审核状态
AuditLogEntityType	enum	审核日志实体类型	包含在 IX_AuditLog_SubjectId_AuditLogEntityType 中
AuditText	string	审核信息
CreateUserId	Guid?	创建用户ID	IX_AuditLog_CreateUserId_CreateTime: 用于查询审核员的操作记录
CreateUserName	string	创建用户名称
CreateTime	DateTime	创建时间	包含在 IX_AuditLog_CreateUserId_CreateTime 中
IsDeleted	bool	是否已删除

Notification（通知表 cms_notification）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
Type	enum	通知类型	IX_Notification_UserId_IsRead_Type_CreateTime: 用于查询用户未读或已读的特定类型通知列表
ArticleId	Guid?	相关文章ID	IX_Notification_ArticleId: 用于查找与文章相关的通知
CommentId	Guid?	相关评论ID	IX_Notification_CommentId: 用于查找与评论相关的通知
IsRead	bool	是否已读	包含在 IX_Notification_UserId_IsRead_Type_CreateTime 中
UserId	Guid	通知接收用户ID	包含在 IX_Notification_UserId_IsRead_Type_CreateTime 中
CreateUserId	Guid	通知发起用户ID
CreateTime	DateTime	创建时间	包含在 IX_Notification_UserId_IsRead_Type_CreateTime 中
CommentEntry	object	评论消息	(非数据库字段)
ArticleEntry	object	随笔内容	(非数据库字段)
SubjectId	Guid?	关联主题ID	IX_Notification_SubjectId_Type: 用于查找特定主题的通知
ShortMsgEntry	object	沸点相关内容对象	(非数据库字段)
UserInfo	object	用户信息对象	(非数据库字段)
UserInfoId	Guid?	用户信息ID
NotificationRespUserId	Guid?	通知回复的用户ID
ReadTime	DateTime?	阅读时间

Setting（设置表 cms_setting）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
Name	string	键：编码	复合唯一索引 UX_Setting_Name_ProviderName_ProviderKey: 确保设置的唯一性
Value	string	值
ProviderName	string	提供者（U：用户，S：系统）	包含在复合唯一索引中
ProviderKey	string	提供者键	包含在复合唯一索引中
CreateTime	DateTime	创建时间
CreateUserId	Guid?	创建用户ID

附件相关实体

CommonAttachment（通用附件表 cms_common_attachment）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
EntityId	Guid	关联业务ID	IX_CommonAttachment_EntityId_EntityType: 用于查询实体关联的附件
EntityType	string	关联实体类型	包含在 IX_CommonAttachment_EntityId_EntityType 中
FileName	string	文件名
FilePath	string	文件路径
FileSize	long	文件大小
FileMetaId	long	文件元数据ID
IsFileExist	bool	判断文件是否实际存在服务器
CreateUserId	Guid	上传用户ID	IX_CommonAttachment_CreateUserId_CreateTime: 用于查询用户上传的附件
CreateTime	DateTime	上传时间	包含在 IX_CommonAttachment_CreateUserId_CreateTime 中

用户积分相关实体

UserIntegral（用户积分表 cms_user_integral）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
CurrentIntegral	int	当前积分
TotalIntegral	int	累计积分
AccumulatedSignDays	int	累计签到天数
CreateUserId	Guid?	创建用户ID	IX_UserIntegral_CreateUserId: 用于查找用户的积分记录 (应为唯一约束)
CreateTime	DateTime	创建时间
LastModifierId	Guid?	最后修改者ID
LastModificationTime	DateTime?	最后修改时间

UserIntegralLog（用户积分日志表 cms_user_integral_log）

字段名称	类型	描述	关键字段与索引建议
Id	Guid	主键	主键索引 (PK)
IntegralType	enum	积分类型	IX_UserIntegralLog_CreateUserId_IntegralType_CreateTime: 用于查询用户特定类型的积分记录
Integral	int	积分值
SignYear	string	年	IX_UserIntegralLog_CreateUserId_SignDate: 用于查询用户某天的签到记录
SignMonth	string	年月
SignDate	string	年月日(YYYY-MM-DD格式)	包含在 IX_UserIntegralLog_CreateUserId_SignDate 中
ClientIp	string	客户端IP
ClientAddress	string	客户端地址
CreateUserId	Guid?	创建用户ID	包含在多个索引中
CreateUserName	string	创建用户名称
CreateTime	DateTime	创建时间	包含在 IX_UserIntegralLog_CreateUserId_IntegralType_CreateTime 中

枚举类型

枚举名称	主要值	描述
AuditStatus	Pending, Approved, Rejected, Black	审核状态枚举
InteractionType	View, Like, Comment, Collect, Share	互动类型枚举
UserLikeSubjectType	UserLikeArticle, UserLikeComment	点赞对象类型枚举
CommentSubjectType	ArticleComment, TagComment	评论对象类型枚举
NotificationType	UserLikeArticle, UserCommentOnArticle	通知类型枚举
SettingProviderNameEnum	U, S, R	设置提供者类型枚举
UserStatus	Active, Disabled	用户状态枚举
PrivacyType	Public, VisibleOnlyMySelf	隐私类型枚举
ArticleSource	Original, Repost, Translated	随笔类型枚举
ArticleEditorType	MarkDown, RichText	编辑器类型枚举
AuditLogEntityType	Article, Comment, ShortMsg, Other	日志关联的实体类型枚举
ClubTypeEnum	Club, Topic	话题类型枚举
AttachmentType	Image, Video	附件类型枚举
IntegralType	签到(10), 连续签到(20)	积分获取类型枚举