用户资料逐项审核

头像AVATAR、相册ALBUM、昵称NICKNAME、个性签名INTRODUCTION分别审核,保存成功不等于公开展示。注册草稿仅本人可见,真正完成注册后自动为非空资料项提审;相册在资料编辑保存时按照片位置拆成独立审核项;注册后的App及后台编辑继续使用原保存接口,仅实际改变字段产生待审。没有额外“提交审核”接口、发布按钮或注册步骤。

后台网页顶部提供“头像/相册/昵称/个性签名”四个审核分类,首次进入和重置默认头像待审核(field=AVATAR、status=PENDING)。下方以紧凑按钮展示全部状态及五种状态数量,数量来自当前分类与已应用关键词的同次statistics响应,全部为五项之和;加载或失败显示未知占位。点击分类保留已选状态和已应用关键词,点击状态保留分类,均回到第一页;未提交的搜索草稿不影响切换、分页或刷新。接口的field缺省值仍为ALL,保持其他调用方兼容;侧栏气泡在首屏独立读取全局待审总数,不采用当前分类数量。

本人和公开展示

头像统一读取响应中的avatarUrl,业务身份仍以/api/v1/media/user-avatars/{userId}表示;真实加载地址与授权由统一mediaDelivery返回,不能假定avatarUrl始终是API相对路径。后台按当前查看者身份选择本人最新已保存绑定头像或他人最后审核通过头像;本人待审/驳回图不因此公开。各自没有对应引用时才返回API默认PNG,上传未保存不生效。公开资料avatarId仍只表示已审引用,客户端直接加载后台URL,私密鉴权交由公共加载组件;CDN/OSS不附带本站Bearer。原准入与双向屏蔽保持,媒体不可用时URL为null,缓存不得绕过当前权限。

本人me、主页汇总、注册保存/完成及可编辑资料保留本人最新提交值,并增加moderation。公开资料、关系、动态/评论作者的avatarId、昵称、签名和公开相册只取最后通过值;其他人读取头像时也只使用已审公开图。未审/驳回时保留对应公开值,首次无通过值为默认图/默认昵称/空签名/空相册;本人通过avatarUrl读取自己时使用最新已保存绑定图。修改一项不影响其他通过项。

用户主页主体仅通过当前有序公开快照投影相册,最多9张;公开相册图片每次复核目标、双向屏蔽、公开引用及归属,自看也不回退本人候选或暂存。单项下架留下位置空缺,替换通过后旧引用不可继续读取;空相册不泄露私有/待审状态,图片失败保留错误。生日与年龄仅在本次详情专用投影展示已保存结构化生日及UTC权威整岁,不扩展其他最小profile,也不改变上述四项先审。

清空头像、签名或相册立即撤下旧公开内容并替代该项待审,不把删除作为一条新内容发布。旧资料没有人工通过证据,升级时仅标为LEGACY补审,不自动通过;本人原文、编辑版本、注册进度、会员和会话不因补审丢失。LEGACY的入队时间是补审时间,不伪造原提交或人工决定。

moderation字段

{
  "avatar": {"status":"EMPTY","reviewId":null,"reason":null,"submittedAt":null,"reviewedAt":null},
  "nickname": {"status":"PENDING","reviewId":"00000000-0000-4000-8000-000000000001","reason":null,"submittedAt":"2026-11-06T00:00:00Z","reviewedAt":null},
  "introduction": {"status":"REJECTED","reviewId":"00000000-0000-4000-8000-000000000002","reason":"请修改签名内容","submittedAt":"2026-11-06T00:00:00Z","reviewedAt":"2026-11-06T01:00:00Z"},
  "album": {"status":"PENDING","reviewId":"00000000-0000-4000-8000-000000000003","reason":null,"submittedAt":"2026-11-06T00:00:00Z","reviewedAt":null},
  "published": {"avatarId":null,"nickname":"原昵称","introduction":"原已通过签名","albumPhotoIds":[]}
}
字段 类型/可空 说明
avatar/album/nickname/introduction object,非空 对应本人当前提交的四项状态,不能用一项状态推测其他项
各项.status string,非空 EMPTY无内容;NOT_SUBMITTED未完成注册的非空草稿;PENDING待审;APPROVED当前值已通过;REJECTED驳回;HIDDEN已下架
各项.reviewId UUID,可空 对应候选/当前公开来源的审核项,EMPTY/NOT_SUBMITTED为null
各项.reason string,可空 仅REJECTED/HIDDEN提供管理员原文,不伪造翻译;其余为null
各项.submittedAt/reviewedAt date-time,可空 入队/最近人工决定时间,无人工审核不得编造
published object,非空 当前仍公开的四项值,独立于本人新提交内容;相册使用已通过图片UUID快照
published.avatarId/nickname/introduction/albumPhotoIds UUID/string/string/array,可空 空表示此项无当前通过内容,不从本人新草稿补齐

修改、驳回和并发

同字段新候选使旧待审SUPERSEDED,旧项不再可通过;原文没变不重复入队,修改其他资料也不重提原驳回项。驳回后修改再保存;回到最后通过值则撤销新待审并恢复APPROVED反馈。审核修订与私人资料编辑version独立,人工通过不覆盖本人后续输入,不改变registrationStep或渠道VIP。

列表和头像公开均按最后通过值,社交昵称搜索也不匹配未审草稿。后台对仍在公开使用的已通过项可单项下架HIDE并填写原因;旧历史通过项不能下架新内容。清空、编辑、决定及注销按同一账号锁串行,版本或状态冲突不自动覆盖。

客户端接入

我的首屏继续一次GET /me/home,从account.moderation读取反馈,不加审核状态请求。资料编辑展示各项待审/驳回/下架状态及原文原因;保存提示按实际状态说明,不能提示已公开。本人仍显示自己的提交值,公开页面显示服务端公开值,不拼接本机提交内容或设计人物。

未审核不增加登录/VIP准入步骤;先按原registrationStatus/vipRequired分流。刷新或审核变化不覆盖未保存草稿;409和未知写入结果保持原有保护。头像与国旗仍按原媒体路径/缓存,不把图片塞入JSON。状态标签中英日韩由客户端本地化,固定状态与审核原因不自动翻译。

管理后台

独立“用户资料审核”菜单:侧栏气泡只显示真实全局PENDING资料项数(头像、相册、昵称、签名分别计数),不采用当前筛选或分页数量;0隐藏,审核成功后更新,可见页面每30秒及切回窗口时检查。无权限不读取,退出清空,失败不伪造0。一次队列与统计按状态/字段/用户搜索,并返回当前资料头像、性别和所选国家;左侧只显示头像、昵称及右下角国家角标,不显示公开ID/账号UUID。列表只展示新提交内容,不显示此前公开内容,也不读取previous头像;previous及公开快照仍保留在接口契约中。图片自身使用8px圆角,每张照片独立一行;点击打开单张预览弹窗,预览复用已授权Blob;账号头像与审核图片同会话内按不可变图片标识使用内存及IndexedDB缓存,各最多64项/32MiB、固定5分钟且不超过会话有效期,切换菜单及服务器恢复身份后的强制刷新可复用;按管理员、会话和权限摘要隔离,图片变化使用新标识,失败不缓存,退出、换号或权限变化清空。真实头像加载中只显示中性占位,不先显示默认头像;存储不可用时仍可正常下载。审核头像和相册图片走私有审核PNG及私有审核相册图片,当前账号头像使用原管理员用户头像入口。右侧待审项直接显示“同意/拒绝”,已通过且仍公开的项保留下架;点击“同意”直接按列表版本提交APPROVE和空reason,不弹窗,提交中防重复及禁止离开,成功刷新列表、统计与侧栏气泡;拒绝/下架继续在轻量操作窗填写reason(必填,最多500个UTF-16代码单元),确认后提交,已保存理由在状态列显示。OWNER持ADMIN_PROFILE_REVIEWS_WRITE作决定,VIEWER只读;头像和相册通过前需成功读取并解码待审PNG,同意遇到409或结果不明锁定操作,手动刷新列表成功并查看最新内容后才允许再次点击;拒绝/下架仍先读取最新项核对并显式采用版本,均不自动重发。

JSON继续独立Cookie/可信HTTPS/真实JWE,写入同源及CSRF;精确头像GET和相册图片GET免JSON信封。业务决定和PROFILE_FIELD_APPROVE/REJECT/HIDE成功审计同事务,失败整体回滚;审计只含字段、UUID、动作及修订,不保存昵称、签名或图片正文。注销清除候选和公开引用,再执行媒体删除队列;旧审核详情不可恢复已注销内容。

拒绝弹窗先单选快捷理由:按头像、相册、昵称、个性签名提供对应的内容质量理由,并共用广告引流、联系方式、色情低俗、辱骂攻击、冒充身份等选项,默认不选。只有选择“其他”才展开必填文本框,仍限制原输入最多500个UTF-16代码单元、trim后非空;切到快捷理由隐藏输入框,切回“其他”保留本次草稿。切换四语保留选项编号及自填内容,确认提交时将当前语言的快捷理由正文或自填原文通过既有reason字段提交,不新增接口字段或后端枚举,不自动作审核决定。下架继续手填原因;选择与草稿继续受离开确认、在途禁用、409/未知结果只读核对及显式采用版本保护。

Java API与管理后台既有V29能力已统一部署并完成原有回归;本次相册单张审核新增Flyway V38,已随版本20261108T111351Z-99f423f61835-worktree完成服务器迁移验收。该历史批次真实队列为空;后续真实验收只读,不代替管理员作出审核决定。后台另完成17项真实入口只读页面验收;Flutter已完成三项状态及原因、提交/清空提示接入,专项59项及全仓878项通过、44项条件跳过,真实账号和设备联调尚未进行;不将上传成功、待审或客户端隐藏当作服务端审核通过。

2026-11-20统一媒体交付已部署到唯一正式环境(运行配置仍为dev):已认证App成功JSON按需返回统一mediaDelivery,能力头不再选择格式,服务端决定CDN/OSS/API。业务ID和权限保持,文件通过返回的transport及授权加载;字段、缓存、单项失败与设备验收见统一媒体交付。后台网页仍使用独立管理员协议。