student-home-hours-2026-11-15.md 4.1 KB

学生首页时长统计核对与四项显示

2026-11-15。用户先要求核对熊梓含初中及其他学生的累计陪练时长,随后明确要求学生首页隐藏累计时长,仅保留截图红框余额。当前交付为本地修复,尚未上线。

熊梓含初中

正式会员ID1850。实际上课记录19次,18次正式60分钟、1次体验60分钟,共19小时。原首页 e_order_tongji 从 CourseAppointment.dszt>10 推算时长,只有10条满足;多条实际已上课的旧预约仍是0/10状态,漏计9小时。学习记录本身完整,不应通过再次结课来补统计。

逐笔账务核对:原充值SilverCoin、UserPoint各20,体验UserExp1;18次正式课每次各扣SilverCoin和UserPoint1,逐一匹配18个不同lessonId;体验课仅UserExp扣1。11月14日完课后正式余额2。11月15日09:06续费10,当前余额12,其中已预留1、可用11。首页截图显示12与账本一致,累计10有误。没有修改、补扣、补偿、重置余额或再次结课。

核对前后全量学生流水聚合版本与41组条数一致,余额及预留查询结果一致。

界面与统计修复

  • 学生首页移除累计陪练时长卡片,四列为累积生词、剩余陪练时长、30分钟软件时长、60分钟软件时长。老师端累计时长仍显示。
  • 学生统计使用单独 student-stats-v2 缓存,升级后不继续命中旧统计;余额缓存和老师统计键保留。
  • 学生接口的累计时长改用完成课记事实,同一学生同一预约去重、排除作废课记;依次采用同学生的完课报告时长、原预约时长、有效历史分钟字段及明确课型时长。30分钟按0.5小时、60分钟按1小时、体验按实际分钟处理;不按课程次数直接当小时。
  • 数据不足、非有限时长、已结束预约对应课记缺失(包括部分缺失)均返回未知,不猜测时长或静默归零,也不依据预约补加实际出勤。
  • 保留生词 t_total 原有PracticeRecord来源、老师收入分支、费用和结算规则。新模块仅SELECT,无生产迁移。
  • 浏览器验收门槛同步为四项有效数字,余额/统计失败时仍拒绝通过。

其他学生排查

对639个正式会员做只读排查,其中546人有完成课记。发现93人的原首页与课记口径不同:82人可由现有课记计算出差异,9人历史分钟信息不全,2人有已结束预约但没有对应课记。后11人保留待核对,不自动修正历史记录或余额。

这是一份同一时点的只读统计快照;82项不是逐人完成过财务审计的结论。姓名及原值/记录次数/候选值/异常状态清单仅保存在受保护本地CSV,不进入Git。

全局核对在REPEATABLE READ、READ ONLY事务中执行,带25秒statement_timeout,固定帐套、固定SQL。临时函数有令牌摘要、租户和短期过期检查,执行后已删除,不保留任意SQL执行入口。

验证

  • 缺陷用例对旧版本确实失败:混合30/60分钟及30分钟体验,已结束状态滞后,期待2小时而旧代码返回1小时;随后修复通过。
  • 5项隔离PostgreSQL回归覆盖19小时原案例、部分或全部缺课记、取消/作废、去重、归属隔离、报告优先级、未知与NaN时长,且禁止统计发出写入SQL。
  • 移动端404、管理端394、服务端591,共1,389项通过;生产构建及11项云函数定义校验通过。独立审查发现的未知值/部分缺失问题均有红测、修复及复审。
  • 实际候选构建配本地合成API,在390px和1024px检查四列和横向溢出,累计卡片不存在;健康/余额失败/统计失败/旧缓存四场景通过,外部请求0。合成显示值只用于测试,不是对真实学生余额的修改。
  • 生产核查只读,不等于候选已部署或家长当前页面已更新。真实数据的19小时计算已由只读SQL核验,界面和接口变更仍等待上线。

私有证据:/Users/mac/.local/state/xiaoshu/qa/2026-11-15-student-hours/。其中 学生累计时长排查清单.csv 为93项排查清单;原始账号、账本及课记数据不进入Git。