feat(old-items): complete reuse workflow and refine miniapp home

This commit is contained in:
2026-08-15 16:38:30 +08:00
parent 65d23eab4a
commit f3737c80be
94 changed files with 7880 additions and 215 deletions
+62
View File
@@ -223,6 +223,68 @@ DOCX 仅在管理端浏览器转换,API 保存前对富文本执行服务端
---
## D-019 旧物善用采用独立域并分三阶段交付
状态:ACCEPTED
决定:用户于 2026-08-15 明确批准在 D-017 原延期边界之外新增“旧物善用”独立模块,但继续排除现金捐赠、微信/支付宝/银行卡支付和自动扣款。模块沿用现有账号、登录态和安全基线,新增独立路由、后台菜单、权限、API 和数据表,不修改既有服务申请与公益项目状态机。
交付分三阶段:第一阶段实现真实旧物捐赠提交、最多六张私有图片、上门取件或定点投递、后台人工审核与人员分配边界、状态溯源、物资需求发布与定向捐赠、真实事实统计;第二阶段实现入库/分拣/消毒/出库/帮扶落地台账及 Excel 导入导出打印;第三阶段实现电子证书和公益积分。第一阶段不接第三方物流,取件人员由后台人工安排;未实施能力只保留模块边界,不显示可操作伪入口。
捐赠状态为 `SUBMITTED → WAITING_PICKUP/WAITING_DROP_OFF → RECEIVED → PROCESSING → COMPLETED`,并允许审核驳回与接收前取消。需求状态为 `DRAFT → PUBLISHED → FULFILLED/CLOSED`。所有创建和状态变更使用客户端 UUID 幂等、revision 乐观锁、不可变历史和事务审计。联系人、手机号、取件地址、物品描述、驳回原因加密保存;手机号另存域隔离 HMAC;公开资源使用随机 UUID 和非连续公益编号。统计只从已接收/已完成事实计算,不允许人工覆盖。
原因:满足用户新增的实物公益闭环,同时把物流、仓储台账、证书积分与支付等风险不同的能力拆开交付,避免以空页面、模拟数据或未审计状态冒充完成。
---
## D-020 旧物台账采用原子批量入库与只追加流转事件
状态:ACCEPTED
决定:旧物善用 Phase 2 使用一条物资批次主记录配合只追加流转事件,状态固定为 `IN_STOCK → SORTED → DISINFECTED → OUTBOUND → DELIVERED`,禁止跳级、回退和覆盖历史。来源捐赠最多绑定一个物资批次;关联台账在分拣和落地时同步捐赠处理/完成事实,定向需求满足数量只在落地事务中增加。
Excel 在管理端浏览器本地读取和生成,API 只接收固定结构、最多 500 行的已解析数据,不保存或执行原始工作簿。导入批次、全部物资行、入库事件和审计全有或全无;导出使用独立权限、最多 5000 条且排除个人字段和内部备注。小程序只公开状态、时间及出库/落地的粗粒度地区。
原因:防止部分导入、重复入库、越级完成、覆盖审计事实和表格携带宏/公式进入服务端,同时使物资去向可追溯但不扩大受助对象隐私暴露面。
---
## D-021 旧物善用积分仅作为公益荣誉记录
状态:ACCEPTED
决定:Phase 3 的积分只记录旧物捐赠参与,不具有现金价值,不支持兑换、购买、转让、提现、到期或排行。默认每件物资 1 分、单笔最多 500 分;管理端可激活不可变规则版本,按四类物资配置未来计分,但不得覆盖既有流水。自动计分只发生在捐赠真实进入 `COMPLETED` 时,并与证书、状态历史和审计在同一事务提交;证书补发不得重复计分。人工校正必须填写原因、校验 revision、写只追加流水且不得产生负余额。
证书使用纯文本模板和固定占位符,每次签发保存完整快照。新模板只影响未来证书;补发会撤销但不删除旧证书。证书收件人称呼加密保存,仅本人会话可查看,不提供匿名公开核验。法律声明固定明确证书仅记录公益参与,不是捐赠收据、税务凭证或财产权利证明。既有已完成捐赠不自动批量回填,必要时由授权人员依据真实记录补发并审计。
原因:在满足公益激励与纪念需求的同时,避免积分被误解为支付、资产或消费体系,防止规则变更重写历史,并保证完成事实、荣誉凭证和积分账目一致可追溯。
---
## D-022 公众端使用“帮扶服务”名称并收敛首页入口
状态:ACCEPTED
决定:按用户 2026-08-15 的明确要求,小程序公众端将“服务申请”统一展示为“帮扶服务”,提交内容称为“帮扶需求”;首页移除关爱老人、困境儿童、妇女帮扶和残障救助四个重复分类快捷按钮,改为一个高权重帮扶服务主入口与志愿服务、公益项目、公益动态、旧物善用四个次级入口。六类具体服务仍在帮扶服务选择页完整保留。
本次仅调整公众信息架构、视觉资源和用户文案。为保持已上线契约兼容,内部 `ServiceApplication` 数据模型、API 路径、共享枚举、后台业务名称和状态机不改名。新增四张虚构 AI 场景图只用于分类识别,不构成真实公益服务或成果证明。
原因:首页分类入口与下级选择重复且同级入口过多;“帮扶服务”更直接表达群众可以获得的服务,同时避免因纯展示改名引入数据库/API 迁移风险。
---
## D-023 首页主功能区补充财务公开与服务进度
状态:ACCEPTED
决定:按用户 2026-08-15 的明确要求,小程序首页“帮扶服务”下方主功能区由四项调整为 3×2 六宫格,保留志愿服务、公益项目、公益动态和旧物善用,并加入财务公开与服务进度。财务公开进入既有公开文档列表,服务进度进入本人帮扶服务列表,不新增占位页或新业务接口。
服务进度从下方便捷入口上移,避免同页重复;便捷入口取消旧物善用,仅保留公益活动,以及具备授权时显示的协作任务。旧物善用模块本身及首页主功能入口继续保留,不删除既有业务能力。
原因:提高财务透明内容和个人服务跟进的首页可达性,同时减少便捷入口重复和冗余;3×2 布局可保持适老化点击面积与清晰文字标签。
---
## 待确认建议
Codex 若有会改变已批准架构的建议,只能写在这里,不得直接实施: