Repository navigation
Home
《软件工程实践（Ⅰ）》2026-2027-1 学期 ｜ 项目主题：在线购物系统（挑战升级）
组长：胡成溯 ｜ 组员：黄程宇、周到（产品经理）｜ 开发方式：Scrum，两周一个迭代，共 7 次评审
基于统一基线需求的「单商品售卖」在线购物系统：卖家登录后台发布商品，买家提交购买意向，系统按先到先得排队、口令码撤销、进入交易自动冻结、交易结果由卖家标记。本学期在此基线上按迭代逐步升级为多商品、多用户、在线支付的完整系统。
注意：基线原文是「买家不用注册」。第 2 次迭代起改为「浏览不拦截、下单必须登录」（依据挑战需求 A.2.1 与《挑战需求A-澄清问答记录》），原「手填姓名电话」的路径已取消。
当前进度（第 2 次迭代，2026-10-09 ~ 10-22）：技术栈由 Python/FastAPI 迁移至 Java 17 + Spring Boot 3 + MyBatis-Plus + Thymeleaf + SQLite，同时按挑战需求 A（A.1 商品管理升级 5 条 + A.2 客户升级 3 条）重排迭代范围。分工按「一人一模块、代码包零交叉」：账号与客户（胡成溯，auth/ buyer/ admin/）、商品中心（黄程宇，product/）、买家门户与交易（周到，portal/），跨模块只走 Service 接口。迭代 1 的 Python 版本保留在 main 分支作为原型参考；迭代 2 的代码在 iter2-java 分支。
需求覆盖情况与逐条任务拆解见《工作任务表 v4.0》；口径以《挑战需求A-澄清问答记录》为准。
- 需求规格说明书-第5组 —— MVP 功能需求（FR-01~FR-08）与验收清单
- 需求澄清结论-第5组 —— 2026-10-04 助教访谈结论（开发与验收依据）
- Product-Backlog-第5组 —— 27 条特性、优先级与故事点
- 架构设计与数据库表结构 —— 三表 DDL、FastAPI 分层、双状态机、队列递补算法、REST 接口清单
-
构建过程手册 ——
build.py构建步骤、产物dist/online-shopping-group5-1.0.0.zip、Docker 镜像构建 -
部署手册 —— Python 环境、
pip install、端口 8000、Docker 部署、评审演示动线 -
口令码与队列规则说明 —— 口令码生命周期与队列递补设计（8 位
token_hex(4)，FR-04 待细化项落地）
- 架构设计与数据库表结构-迭代2 —— Controller-Service-Mapper-Thymeleaf 四层、四表 DDL、接口清单与实现状态
-
构建过程手册-迭代2 —— JDK 17 + Maven、
mvnw clean package、产物target/online-shopping-group5.jar - 部署手册-迭代2 —— JDK 17 环境、端口 8080、常见问题、评审演示动线
-
口令码与队列规则说明-迭代2 —— 32 位口令码（
TimeUtils.randomTokenCode()+UNIQUE兜底）与队列递补设计
- 账号与客户模块-迭代2 —— 买家账号（注册/登录/会话）、客户管理、两套登录态隔离、跨模块出口
- 契约-账号与客户-迭代2 —— 8 条路由的参数与模型属性、错误提示口径、8 项联调清单
- 第1次阶段性评审报告 —— 2026-10-08（MVP 基线）
- 第1次测试记录 —— 交叉测试 14 条验收清单全通过（2026-10-07）
- 买家门户入口：
http://localhost:8080/buyer/register（注册）/http://localhost:8080/buyer/login（登录） - 卖家登录：
http://localhost:8080/login（初始账号 admin / admin12345，首登后请改密） - 卖家后台：
http://localhost:8080/admin - 基座自检：
http://localhost:8080/admin/diagnostics（实时查看四张表的结构与行数） - 启动方式：双击仓库根目录
run.bat，或执行mvnw.cmd spring-boot:run
-
买家页面：
http://127.0.0.1:8000/product -
卖家后台：
http://127.0.0.1:8000/admin -
仓库源代码：
https://github.com/xiaochu-dev/online-shopping-group5
- 胡成溯：第2次个人汇报 —— 账号与客户模块（T2-01~T2-07，13 点）
- 黄程宇：第1次个人汇报 —— 商品发布、图片校验、买家提交