社交互动(social)
关注、收藏、评论、点赞、转发、拉黑六类行为记在哪,屏上那几个数由谁算,前台那两颗按钮归谁渲染。
应用编码 social,本页对应应用版本 1.0.2(引擎要求 >=5.6.2 <6.0.0),license 为 MIT、装载不要凭证,仓库 wujies-social-plugin。
六类行为归它管:关注与粉丝、收藏夹与收藏、评论与回复、点赞、转发、拉黑,另有一份「互动行为」流水和两张统计表。被互动的对象都不在这个应用里,文章在 内容中心,图片在 图床管理,商品与视频同理。每张动作表因此只带 target_type 加 target_id 一对引用,标题、封面和「点进去往哪走」交给拥有那个对象的应用。
前台那一屏它也不管:src/main/resources 下只有 mapper/social/,既无 site-templates/,也无 site-styles/。评论区和互动条的版式、挂载点、样式都在 CMS 主题里(post.html 上那串 data-cms-* 属性与 modules/interactions.html),本应用只回 JSON。两截 URL 因此各写了一遍:SocialSiteLinks 的 COMMENT_BASE、INTERACTION_BASE 与 CmsThemeProperties 的 COMMENT_API_BASE、INTERACTION_API_BASE 必须同值,改一边前台就调不到接口。
装它
dependencies 为空、MIT,任何部署都能直接装。装之前看三处:
- 宿主
application.yml的open-api.tenant.path-patterns要含/site/**(口径见 部署配置)。匿名读评论树靠这条带认出当前租户,少了它前台那一片是空的。 - 要有评论区与互动条,
cms得在。缺它时这 11 页后台和/portal/**照常可用,前台没地方挂载。 migrations/01-create-social-tables.sql建 11 张表,脚本头写明「存量部署上这些表有数据,彻底删除会 DROP 它们」,动手前先备份。
安装过程与「装完菜单为什么没立刻出现」见 在部署里使用应用,键归属规则见 菜单归属。装成功后侧栏多一个「社交互动」,两根枝下共 11 页,每页下面都挂满 query/add/edit/remove/export 五颗按钮:
| 分组 | 菜单 | 路由 | 需要的权限码 |
|---|---|---|---|
| 关注管理 | 关注统计 | followStatistics | social:followStatistics:list |
| 关注管理 | 关注数据 | follow | social:follow:list |
| 关注管理 | 关注分组 | followGroup | social:followGroup:list |
| 关注管理 | 黑名单 | block | social:block:list |
| 关注管理 | 收藏夹 | favoriteFolder | social:favoriteFolder:list |
| 互动管理 | 互动统计 | statistics | social:statistics:list |
| 互动管理 | 互动行为 | userAction | social:userAction:list |
| 互动管理 | 点赞(通用) | like | social:like:list |
| 互动管理 | 评论(通用) | comment | social:comment:list |
| 互动管理 | 收藏(通用) | favorite | social:favorite:list |
| 互动管理 | 转发(通用) | share | social:share:list |
11 页全是远程模块(component 写作 remote:social/social/<路由>),界面来自本仓库 frontend/,加载机制见 远程应用。
配它
sys_config 里一行都没有:app.json 的菜单没有「配置」这一项,宿主 ModuleBusinessSettings 认识的分类只有 mall、im、exam、gallery、cms 五个,social 不在其中。能调的量都写死在 Java 常量里,要改就得改代码、重打包、热加载一次。
| 项 | 现值 | 写在哪 | 什么时候要改 |
|---|---|---|---|
| 可被评论的目标 | article、image | SocialSiteCommentService.TARGET_TYPES | 商品详情、视频页要接评论区时放开这一处 |
| 可被点赞/收藏/转发的目标 | article、image | SocialSiteInteractionService.TARGET_TYPES | 与上一行一起放;表是通用的,收窄只发生在常量上 |
| 评论正文字数上限 | 500 | SocialSiteCommentService.CONTENT_MAX,超限报「评论内容最多 500 字」 | 宿主 KCommentSection.vue 的 maxlength 同值,两边要一起动 |
| 评论树每栋预览条数 | 2 | SocialSiteCommentService.REPLY_PREVIEW | 想少发一次「展开更多」请求时调 |
| 转发渠道缺省值 | link | SocialSiteInteractionService#share | 前台那颗「分享」默认记复制链接,渠道全集在 social_share_type 字典里 |
| 点赞/收藏/转发的写入口径 | sync | 宿主 application.yml 的 wujies.social.site-write-mode,环境变量 WUJIES_SOCIAL_WRITE_MODE | 装了 RabbitMQ 的站点改成 mq:请求只投递、先回乐观数,落库由消费端做;投递失败当场退回 sync。值不是 sync/mq 时 social 插件起不来 |
| 队列批量阈值与落库间隔 | 50 条 / 2 秒 | SocialInteractionConsumer 的 BATCH_THRESHOLD 与 @Scheduled(fixedRate = 2000) | 只影响评论计数缓存的刷新节奏 |
目标类型的完整词表在字典 social_target_type(image、album、article、video、comment,由 02-create-social-dictionaries.sql 落库),另有 social_action_type、social_follow_type、social_share_type 三份。往字典里加一个值不会让那个对象变得可互动,公开接口只认上面那两枚常量。
用它
管理员那 11 页都是运营入口,三处口径值得单独说:
- 评论的审核只翻
status(PUT /social/comment/audit、PUT /social/comment/batchAudit,权限码social:comment:edit),0正常、1已删除、2已屏蔽。前台没有审核开关,新评论一进来就是0,也就是先发后审。公开那棵树只回status = '0',屏蔽一条等于把它和它下面的回复一起从访客眼前撤掉,后台列表里还在。 - 删评论按整栋删:
SocialCommentServiceImpl#deleteWithValidByIds先按commentId、rootId、parentId三个条件圈出要陪葬的行,删完再按图片分组回扣gallery_image的评论数。 - 后台手工增删关注(
POST/DELETE /social/follow)不动social_follow_statistics,那张表只有两条写入路:/portal/follow/**的关注与取消关注会同时更新双方那行,POST /social/followStatistics/refresh/{userId}(加/refresh/batch)从明细表现算覆盖。所以「关注数据」与「关注统计」两页数字对不上时,先跑一次 refresh。 social_block只有它自己那套后台 CRUD 在读写,公开评论与互动的任何一条路径都不查它,拉黑目前是一份台账。
会员在会员中心「社交互动」(/member/social)里看四档:我的点赞、我的收藏、我的转发、我的评论,标签上的数字来自 GET /portal/social/interaction/summary,列表走 GET /portal/social/interaction/list,删一条走 DELETE /portal/social/interaction/{like|favorite|share|comment}/{id}。四条全是 @SaCheckLogin、没有权限码,且都不接受 userId 参数。关注那一头是 /portal/follow/** 八条(关注列表、粉丝列表、关注/取关、改关注类型、查是否关注、两个统计端点)。侧栏那一格按「本租户已启用应用」过滤,应用编码写的是 social。
游客能读的只有两件事:GET /site/comment/tree、GET /site/comment/replies 与 GET /site/interaction/state。写一律要登录:POST /site/comment、POST /site/comment/like、POST /site/interaction/like|favorite|share,GET /site/interaction/mine 也要。@SaIgnore 挂在类上,所以校验顺序是先 LoginHelper.isLogin() 再 getUserId(),未登录直接回「请先登录」。state 在匿名时把「我点过没有」回成 null 而不是 false,前台据此决定那颗按钮该不该亮;四颗写接口都回服务端最新的数,前端先按 +1 画、拿到回值再校准。pageSize 一律夹到 100。评论正文按纯文本存取(前端 {{ }} 插值,服务端不过 HtmlSanitizer),跟 CMS 富文本那道闸门两套,别把这里当能带标签的口子。
这几个数写在哪
| 屏上的数 | 谁算 | 落在哪 |
|---|---|---|
| 文章/图片的点赞、收藏、转发数 | SocialSiteInteractionService#state 现场 selectCount 明细表 | 每次现算,不读汇总行 |
| 图片卡片上的点赞数、评论数 | social 写过去 | gallery_image.like_count、comment_count,两份投影 |
| 某条评论的点赞数 | setLiked 按明细重算后写回 | social_comment.like_count |
| 某条评论的回复数 | 写入路径 +1 | social_comment.reply_count,树接口回的是实查条数 |
| 后台「互动统计」那一屏 | SocialInteractionConsumer 聚合 | social_statistics |
| 关注数 / 粉丝数 / 好友数 | 会员端关注动作与 refresh 端点 | social_follow_statistics |
social_statistics 与前台按钮对不上属于正常现象:站内 C 端已经改走同步落库那一路,队列消费者留着但没有消息进来,那张表因此长期停在旧值上(SocialInteractionConsumer 类注释写明「目前没有生产者」)。view_count、download_count 两列与 social 无关,归图床自己算;cms_post 上根本没有评论数列,文章被评论了几条只在问 social 时才知道。
回扣图床那两列走裸 SQL(GalleryImageCountSync,UPDATE gallery_image SET 列 = GREATEST(0, IFNULL(列,0)+delta),绕过租户拦截器),失败只记日志、不向前台报错:投影掉了几个数,不该让评论发不出去。
软删的行还占着唯一键。uk_target_user (target_type, target_id, user_id, tenant_id) 里没有 del_flag,取消点赞是把那行标成已删除,行本身还在,所以再点一次必须先 reviveByTarget 把那行改回来、改不动才插入,直接插会撞 DuplicateKeyException。同一个形状在 uk_user_followed、uk_user_blocked、uk_target、uk_user_id 上都成立。social_share 没有唯一键,转发记的是次数,同一个人连点十次就是十行。
评论树固定两层,按 rootId 归堆,父评论被删后孤儿回复自成顶层。replies 在按 rootId 或 parentId 取之外还会再核一遍 target_type 与 target_id:这是个匿名端点,少这一道核对就等于任何人拿一个 rootId 都能翻到别的内容下面的评论。
前台列表与详情接口可以带一个可选的 contentAuthorId(内容作者的用户 id)。给了它,服务端替每条评论标出「这条是作者写的」,并数出每一栋里作者写在还没展开的那几条回复中的条数,「展开」那颗按钮上的「作者回复等 N 条」就是这么来的;前台因此不用自己再问一遍「这条评论的人是不是那篇文章的作者」。点赞的目标类型公开路径只认 article 与 image 两枚常量。图片这里有两套计数:图床自己的 /open/gallery/image/** 是 Redis 纯计数器,只加总数、记不住谁点的,所以「我点过没有」这一问落在本应用这张带唯一键的通用表上。
出问题查什么
| 现象 | 先看 |
|---|---|
| 前台没有评论区,也没有互动条 | cms 装没装;挂载点在 CMS 主题的 post.html 与 modules/interactions.html 里,本应用不提供任何 HTML |
| 评论发得出去,前台看不见 | 那条的 status 是不是被翻成 1 或 2,公开树只回 0 |
| 取消点赞后再点报错 | 走的是 reviveByTarget 那条支路没有;uk_target_user 不含 del_flag |
| 图片上的评论数与评论条数对不上 | 回扣只发生在 image 目标的写入与删除路径上,article 目标一律不动图床列 |
| 后台「互动统计」与前台按钮差很多 | 两张口径:那张表等 MQ,前台按钮现查明细,队列当前无生产者 |
| 会员中心没有「社交互动」那一格 | 本租户未启用 social,侧栏按已启用应用过滤 |
| 「我的点赞」里标题是空的 | 摘要由 内容中心 的 /portal/cms/post/summary 与图床那一份批量接口给,对应应用没装或那个对象已删 |
| 列表页搜关键词报「表不存在」 | keyword 的 EXISTS 直接写了 cms_post、gallery_image 两个表名(零编译依赖换来的耦合),那两张表不在这套库里整条 SQL 就崩。这条未联机验证 |
| 关注数与粉丝列表条数不符 | 后台手工增删关注不更新统计,跑一次 POST /social/followStatistics/refresh/{userId} |
| 拉黑了某人,他照样能评论 | social_block 当前只被它自己的后台页读写 |
| 图床「只看关注的作者」一片空 | FollowRelationApiAdapter 在 social 未加载时降级返回空集,故意不让图床 500 |
实现索引
| 项 | 值 |
|---|---|
| 数据表 | social_follow、social_follow_group、social_follow_statistics、social_favorite、social_favorite_folder、social_comment、social_like、social_share、social_block、social_statistics、social_user_action |
| 后台接口前缀 | /social/follow、/social/followGroup、/social/followStatistics、/social/favorite、/social/favoriteFolder、/social/comment、/social/like、/social/share、/social/block、/social/statistics、/social/userAction,全部 @SaCheckPermission |
| 会员端 | /portal/follow/**、/portal/social/interaction/**(@SaCheckLogin,无权限码,只回当前登录这个人) |
| 公开端 | GET /site/comment/tree、GET /site/comment/replies、POST /site/comment、POST /site/comment/like;GET /site/interaction/state、GET /site/interaction/mine、`POST /site/interaction/like |
| 对外契约 | FollowRelationApi(问 social 要一个人的关注列表),契约在 wujies-common-plugin-sdk,实现 adapter/FollowRelationApiAdapter。写法见 插件开发 |
| 字典 | social_target_type、social_action_type、social_follow_type、social_share_type |
| 自带静态资源 | 无。没有模板目录,也没有样式目录 |
| 迁移脚本 | migrations/01-create-social-tables.sql、migrations/02-create-social-dictionaries.sql |
| 源码 | cn/wujies/social,公开接口在 site/ 子包,会员中心在 portal/ 子包 |
那 11 张表同时是卸载时「彻底删除」的 DROP 依据:平台从迁移脚本里解析 CREATE TABLE 得出本应用声明的表,app.json 的 migrations 数组为空并不影响执行,装载时扫的是 <pluginDir>/migrations/<appCode>/ 目录。已执行过的脚本内容不能再改,校验和不一致会被直接拒掉,改表结构请新增一个 03-*.sql。后端装载与重启口径见 后端部署,接口约定见 接口约定,仓库分工见 仓库布局。本页所有取值与行为都取自代码和迁移脚本,未联机验证。