feat: 接入积分服务端真实接口并完成隔离联调

新增积分服务端接口封装、积分中心页面，支持登录回跳、签到恢复、积分明细等功能。清理缓存时保留未确认签到键，新增ApiRequestError错误类型区分业务状态，更新开发文档记录积分页面联调完成情况。
2026-10-04 08:29:53 +08:00
parent 2a9ff403c4
commit 6b16d4fd55
9 changed files with 555 additions and 150 deletions
@@ -1,6 +1,24 @@
 # AI 融资平台开发文档

-> 版本：v1.42 · 基线日期：2026-09-22 · 更新日期：2026-10-01 · 状态：积分后端及真实HTTP隔离开发检查完成，默认关闭、DEC-POINT待确认；原表未迁移、积分页面未接、未部署。模型运行参数/调用额度受控配置、后台分析进程心跳/进度超时提示、只读服务检查/调用用量、评估排障、受控人工重试与操作审计、业务权限模板、资料/消息只读及敏感字段保护源码完成未部署；FAQ服务端和反馈闭环源码完成未部署。资讯/课堂/搜索/会员课程进度、消息中心和产品编辑/公共目录已正式部署至https://airz.hqling.cloud；新域名公网HTTPS通过。微信/Android此前开发编译通过，小程序需重新发行，H5未部署、真机及多设备待验收。最新资料/评估版本及会话精简约定保留。
+> 版本：v1.43 · 基线日期：2026-09-22 · 更新日期：2026-10-02 · 状态：积分后端已随5fee3cf部署，默认关闭、DEC-POINT待确认；原表未迁移，积分页面真实读取、异常恢复及隔离联调完成，前端未重新发行。以下后台和内容模块的历史部署状态以新会话交接及后端deployment-baota.md最新发布记录为准。微信/Android编译通过，小程序需重新发行，H5未部署、真机及多设备待验收。最新资料/评估版本及会话精简约定保留。
+
+### 0.51 2026-10-02 积分页面恢复与隔离联调
+
+页面按加载所属Token和页面代次隔离请求；账户切换后的规则、任务、分页、签到及明细展开操作先清旧状态并读取新账户。四读取接口先暂存，校验日期、时区、版本、奖励及签到状态一致后统一展示；失败显示不可用与重试，不把读失败显示成零积分或无记录。
+
+按账户保存的未知签到请求优先于今日已完成状态；加载开始即恢复原键，当前规则或流水读取失败仍可POST确认原成功回执。共享 `ApiRequestError` 提供HTTP状态/错误码，只有服务器明确拒绝且未入账的409日期/规则/已签/请求/余额错误、422参数错误及503规则不可用可弃旧键；网络、写冲突、账本不可用及坏回执保键。成功回执要求delta=1..1000、balanceAfter=0..2147483647、replayed为boolean，并匹配原预期日期和版本；展示当前余额须重新GET，不能用历史balanceAfter覆盖。
+
+隔离Chrome页面主流程98项/127次积分请求通过，123次进入真实本机后端，4次受控故障；两次真实提交后丢响应分别在刷新已签和当前规则损坏状态下用原键确认，流水不重复。覆盖20+7分页、NULL/零/负流水、原子读取、确定拒绝与坏回执、账户切换及迟到401。登录回跳只注入合成认证响应，非真实认证验收。手机/桌面截图、日志及清理证据见台账0.51及仓库外 `airz-points-page-20261002` 目录；页面开发检查不能代替生产原表迁移、业务规则批准或真机/发布验收。
+
+补充81项/81次积分请求通过，主流程与补充共179项/208次请求（201真实后端、7受控故障），覆盖网络中断、流水503仍确认、分页/展开换账户和实际拒绝分类。共享会话清理仅保留原账户的三字段待确认命令，不含Token/资料；其它缓存与会话照常清除。恢复例外见积分契约v3，不能跨会员迁移、自动确认或替代鉴权。Android/微信最终编译通过，完整证据和边界以台账0.51为准。
+
+401登录清理专项35项通过（15真实积分HTTP、2合成登录），实际丢响应→撤销Token→清会话/资料、留原键→重新登录→原键重放且不重复入账。214项开发检查累计223积分请求，216次真实隔离后端、7次受控故障。临时数据库/Token/runtime/私密配置及服务已精确清理，未发布前端、迁移正式库或调用模型；后台重启本地预览被自动审批拒绝，当前无本轮预览服务。完整复现前须重新建立隔离环境。
+
+### 0.50 2026-10-02 积分页面真实读取
+
+积分页读取后端 `/points`、`/rules`、`/tasks`、`/ledger`，按服务端业务日、规则版本及有界流水游标渲染；空账本的 `snapshotId=0` 和历史 `null` 元字段按契约保留。移除本机签到天数、固定奖励和体验邀请码，未发布规则显示不可用，不以页面示例值兜底。
+
+签到请求上下文按账户保存 `requestId`、`expectedDate` 和 `expectedRuleVersion`，网络结果不确定时复用原键确认，成功后重新读取余额。页面增加登录回跳、分页、加载/错误/空状态、Token/页面代次守卫；Android 与微信小程序编译通过。积分原表迁移、正式奖励发布、真实设备和开启规则后的到账验收仍待业务确认。
 > 配套台账：[开发进度](开发进度.md)。本文定义范围、接口和验收口径，台账记录实际执行与证据。
 > 文档初始规划后已开始开发；以下更新记录优先于原始基线。除明确列为已实现的部分外，计划接口和增量数据仍待开发。