设计与部署

本组各迭代的技术设计与部署文档。迭代 1 为 Python 基线版（第 1 次成果验收的交付对象），迭代 2 起迁移至 Java（Spring Boot），两套文档并行保留以便对照。

迭代 1 基线版（Python 3.12 + FastAPI，baseline-v1.0）

第 1 次成果验收的交付对象，main 分支，端口 8000。

• 架构设计与数据库表结构 —— 三表 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（Java 17 + Spring Boot 3.3.5，iter2-java 分支）

按课程要求迁移至 Java，端口 8080。当前Java开发主线；仓库默认main仍为Python。Java分支ZIP。

总体设计

• 架构设计与数据库表结构-迭代2 —— Controller-Service-Mapper-Thymeleaf 四层、六表关系、实际接口与库存状态机
• 数据库设计-迭代2 —— 六张表字段、实际索引、约束与商品/意向迁移边界
• 构建过程手册-迭代2 —— JDK 17 + Maven、mvnw clean package、产物 target/online-shopping-group5.jar
• 部署手册-迭代2 —— JDK 17 环境、端口 8080、常见问题、评审演示动线
• 口令码与队列规则说明-迭代2 —— 买家账号下单、不生成新码、旧码兼容、失败人工确认与库存联动