Wujies 无界平台
应用

社交互动(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,任何部署都能直接装。装之前看三处:

  1. 宿主 application.yml 的 open-api.tenant.path-patterns 要含 /site/**(口径见 部署配置)。匿名读评论树靠这条带认出当前租户,少了它前台那一片是空的。
  2. 要有评论区与互动条,cms 得在。缺它时这 11 页后台和 /portal/** 照常可用,前台没地方挂载。
  3. migrations/01-create-social-tables.sql 建 11 张表,脚本头写明「存量部署上这些表有数据,彻底删除会 DROP 它们」,动手前先备份。

安装过程与「装完菜单为什么没立刻出现」见 在部署里使用应用,键归属规则见 菜单归属。装成功后侧栏多一个「社交互动」,两根枝下共 11 页,每页下面都挂满 query/add/edit/remove/export 五颗按钮:

分组菜单路由需要的权限码
关注管理关注统计followStatisticssocial:followStatistics:list
关注管理关注数据followsocial:follow:list
关注管理关注分组followGroupsocial:followGroup:list
关注管理黑名单blocksocial:block:list
关注管理收藏夹favoriteFoldersocial:favoriteFolder:list
互动管理互动统计statisticssocial:statistics:list
互动管理互动行为userActionsocial:userAction:list
互动管理点赞(通用)likesocial:like:list
互动管理评论(通用)commentsocial:comment:list
互动管理收藏(通用)favoritesocial:favorite:list
互动管理转发(通用)sharesocial:share:list

11 页全是远程模块(component 写作 remote:social/social/<路由>),界面来自本仓库 frontend/,加载机制见 远程应用。

配它

sys_config 里一行都没有:app.json 的菜单没有「配置」这一项,宿主 ModuleBusinessSettings 认识的分类只有 mall、im、exam、gallery、cms 五个,social 不在其中。能调的量都写死在 Java 常量里,要改就得改代码、重打包、热加载一次。

项现值写在哪什么时候要改
可被评论的目标article、imageSocialSiteCommentService.TARGET_TYPES商品详情、视频页要接评论区时放开这一处
可被点赞/收藏/转发的目标article、imageSocialSiteInteractionService.TARGET_TYPES与上一行一起放;表是通用的,收窄只发生在常量上
评论正文字数上限500SocialSiteCommentService.CONTENT_MAX,超限报「评论内容最多 500 字」宿主 KCommentSection.vue 的 maxlength 同值,两边要一起动
评论树每栋预览条数2SocialSiteCommentService.REPLY_PREVIEW想少发一次「展开更多」请求时调
转发渠道缺省值linkSocialSiteInteractionService#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
某条评论的回复数写入路径 +1social_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。后端装载与重启口径见 后端部署,接口约定见 接口约定,仓库分工见 仓库布局。本页所有取值与行为都取自代码和迁移脚本,未联机验证。

目录