• 报告期次：第1次 ｜ 报告日期：2026-10-08 ｜ 项目组号：第12组 ｜ 项目名称：在线购物系统

• 已完成工作：上传03模块 products.py 与 README，发布 v0.1.3-products，完成 T04、T05 接口实测记录

• 成果物：王暾：Java商品接口与组长协调

• 已完成工作：整理需求规格、迭代计划、测试用例、构建部署说明与汇报讲稿

• 成果物：第一次汇报材料成果

负责人：王暾 / wangtun773。源码在backend-java/src/main/java/cn/course/shopping/product/，旧products.py归档legacy/python-stage1/。

类/方法	职责
ProductController.publish/history	POST/GET /api/products；均需卖家Cookie
ProductService.publish	事务内检查会话、校验输入、确保无未售商品后发布
ProductService.history	按id降序返回全部商品及状态/成交时间
ProductService.price	BigDecimal精确转整数分，拒绝浮点输入和非法金额
ProductService.image	校验PNG/JPEG/WebP Data URL、Base64、文件头及2MB上限

19.90元保存为1990分，避免二进制浮点误差。在售active和冻结frozen均占唯一名额，只有sold后才能发布下一件。应用写事务BEGIN IMMEDIATE与数据库唯一索引共同防止并发重复发布；失败整体回滚。

商品已售时不删除记录，以便F05历史查询。图片文件头校验不等于完整图像解码。

组长协调接口冻结、审查与真实进度核算，不代替其他成员实际提交。验收关注SystemAcceptanceTest的concurrentPublish、limitsDoNotCreateProduct、fullWorkflowAndHistory等。

当前Java源码 · 完整启动说明 · 迁移与验证记录。第一阶段Python说明保留在仓库legacy/python-stage1及Wiki历史中。

责任成员：王暾。组长确认本轮六位成员已分别完成或复核对应模块，沿用现有六人分工。Java迁移及自动执行由Codex辅助；个人完成/复核归属不等同于独立手工编写全部代码或本人亲自运行全部测试。

• 当前对应源码
• 固定Java实现提交
• 可下载源码ZIP
• Windows/Ubuntu/Docker验证通过
• 本轮任务见第2次阶段性评审报告；教师意见评审后记录。

实际成果：第1次阶段性评审报告草稿、9页PPT讲述版、讲稿、需求说明、迭代计划草案、测试用例和交接清单。完成人真实姓名：____。

全部文件 · 公开资料下载 · 首次Wiki报告

资料版本 v0.1.2-review01的资料包只含本次汇报材料；GitHub源码快照另含前端和组员已上传的05源码，尚非完整系统版本。PPT每页均可编辑，备注含讲述要点；姓名、组号、实际迭代时间、总进度和个人完成情况需小组补齐。PPT结构与版面检查通过，但这些检查不替代现场排练。

测试录屏尚未提供，教师意见评审后填写。AI辅助完成原型和材料，成员须理解、核验并如实说明使用情况。

（评审后填写）