供需、信用标签、推荐与通知 2.5.5

本次需同时更新 APK 和服务器程序。先备份服务器完整 data/ 目录，再替换程序；保留数据库、媒体、私密资料加密密钥及原有账户和授权。客户端使用同一签名，可覆盖升级。

供需卡片

「社群 → 供需」保留出货、收货、其他，增加配货代购，移除联营合作及原鉴定意向。旧意向卡片升级后下架，在发布人的「我的卡片」保留历史，可编辑为新意向后重新上架。

配货代购只包含贵金属首饰、其他两个大类。贵金属首饰默认支持黄料兑换；选择“是”时必须填写两个正数组成的比例，例如 1:0.998，选择“否”时不保存比例。保留简介、发布位置、发货地及交割方式。贵金属首饰使用系统金条标识，无需上传照片；其他大类可上传最多三张照片。「服务」中的奢侈品鉴定、烟酒鉴定及车辆价值评估也使用系统标识，其他服务仍可选照片。

供需简介正文最多 200 个字符，按完整显示字符计数，中文和组合表情不会截成半个。列表预览最多 70 个字符、两行，详情显示全文。供需不展示评论入口、评论计数或评论列表，服务端拒绝新增供需评论；有交易需求通过私信联系。其他图文频道保留既有互动。

供需卡默认个人用户展示上限 10 张、已认证企业 20 张。待审核卡片也占名额，编辑和刷新不增加名额，下架或删除释放名额；下架卡片可在「我的卡片」重新上架。发布和重新上架在同一数据库事务内检查名额，防止多次同时提交超额。降低上限保留已有卡片，但后续发布或上架必须先腾出名额。

后台数量及信用管理

管理员路径：「设置 → 进入管理后台 → 社群风险提示与官方推荐」。在“供需卡数量管理”分别设置个人、已认证企业上限，允许 0–100000 的整数；0 表示暂不允许新增或重新上架。保存使用版本校验，避免两个管理员互相覆盖。

「用户信用标签管理」按账户或姓名搜索，逐个设置良好、优秀、旗舰、风险、高风险，默认良好。公开卡片、联系人、聊天列表、评论及详情均展示信用等级。个人为蓝标，已通过企业认证为黄标；身份类型随认证状态更新。调整信用不会更改身份认证或直接封禁社群，封禁仍使用既有社群管理。

官方推荐

推荐仅由管理员发布、编辑和置顶，普通用户可浏览既有互动。「＋发布推荐图文 / 视频」支持选择多项媒体；「管理推荐与置顶」进入推荐详情后置顶或取消置顶，置顶内容排在普通推荐之前，翻页保持该顺序。

推荐正文、附件数量、视频时长及单账户媒体容量不设产品额度。上传以流方式写入服务器，支持 JPEG、PNG、MP4、WebM；图片单边不超过 8192 像素且总像素不超过 2500 万，实际容量受服务器磁盘、反向代理、网络和设备解码能力约束。推荐使用独立管理员上传接口，普通用户上传额度、私信 30 秒视频限制仍按原规则执行。若反向代理另设上传大小或超时限制，部署时同步调整。

列表中的视频进入可见区域后自动静音播放，点击进入详情才启用声音和播放控制。离开页面、切换标签、滚动出可见区域、应用退到后台或锁定后暂停。媒体读取校验账户及授权，并支持范围请求。

系统提醒

「设置 → 通知与提醒」可开启权限和进入手机系统通知设置。到期和私信分别使用高优先级通知频道，声音跟随系统提示音并支持振动。锁屏内容固定为“您有一条提醒”或“收到一条私信”，没有姓名、发信人、账目金额、物品或消息正文。静音、勿扰和通知权限仍遵循手机设置。

未结清且未删除的典当及有到期日的业务，在到期前 7 天、到期当天分别安排一次提醒，计划时间为本地上午 9 点。当天开启应用时已过 9 点的未发提醒会尽快补发；同一天的多笔提醒合并为通用通知，每笔两个时间点分别记录已提醒状态，重新进入应用不会重发。归还、结清、删除或调整到期日后，计划跟随已提交的数据更新。经营数据和到期计划在手机本地计算，通知计划只保存匿名哈希和日期，不上传门店账目。

前台约每 5 秒检查匿名私信提醒；后台通过 Android 系统任务约每 15 分钟检查联网状态及未读私信。延迟审核的消息从审核通过后的投递序列进入提醒，已读或已清除的消息不提醒。退出账户会取消该账户的系统任务、到期计划和通知；一键清除同时移除通知游标及已提醒记录。后台检查可在 APP 本机锁定时运行，不解除密码或指纹锁。

当前未配置厂商即时推送。系统省电、待机、网络和强行停止会影响任务与定时提醒的实际到达时间，因此后台私信不能保证像微信一样即时到达。后续可由推送 SDK 的接收事件调用 AppNotifications.CheckInbox，继续通过 GET /api/community/chat/reminders?after= 获取匿名序列并沿用去重、审核和账户校验；推送载荷无需携带聊天正文或经营资料。

Android 任务的最小周期及定时器行为见 JobInfo.Builder 和后台定时任务，通知频道设置见 Android 通知频道。

验证

全部接口检查使用隔离的本机服务器和虚构资料；安卓检查只操作 com.xfestudio.jidangjia.authtest，不访问公网账户或正式应用数据。

dotnet run --project tests/JiDangJia.Checks -c Release
node tools/check-community-safety.cjs
node tools/check-community-revision.cjs
node tools/check-community.cjs
node tools/check-community-cards.cjs
.\tools\build-community-test.ps1
node tools/start-community-fixture.cjs
node tools/check-community-cards-ui.cjs forms
node tools/check-community-cards-ui.cjs notifications
node tools/check-community-cards-ui.cjs labels
node tools/check-community-cards-ui.cjs video
node tools/check-community-cards-ui.cjs due

媒体检查需要真实测试视频；check-community-media.cjs 可生成浏览器录制的隔离 WebM 样本，再执行卡片检查。原生界面检查需先安装隔离测试 APK、启动模拟器并准备虚构账户。报告位于 artifacts/verification/。模拟器验证通知频道、后台任务与脱敏内容；实际响铃、已登记指纹及各手机厂商省电行为需在实体设备验收。

2.5.5 交付检查全部通过：业务与备份 357 项、实际 AuthClient 登录授权 60 项、社群基础接口 442 项、社群改版接口 176 项、社群安全 142 项、新供需与通知接口 157 项、安卓原生界面 52 项、发布清理保护 32 项。接口回归使用本次发布的服务器程序；原生界面包括配货代购、信用与数量管理、真实 31 秒视频画面、静音与有声播放、后台暂停、匿名锁屏通知、两次到期提醒及去重、左右滑动切换。