teapot_system/详细实施任务拆分.md

# 铜壶管理系统详细实施任务拆分

## 1. 当前阶段目标
在现有设计文档、任务计划书和 UI 方案全部落地后，当前已经进入“主流程完成后的联调、验收与交付整理”阶段。

当前阶段目标聚焦以下事项：
1. 继续核对前后端主链路在真实 SQLite 数据库上的运行情况。
2. 保证登录、权限、商品、附件、订单、标签下载、统计、用户管理等功能稳定可用。
3. 同步更新设计文档与实施清单，避免后续联调继续参考过期说明。
4. 整理最终验收项、部署注意点和可交付内容。

---

## 2. 本轮实施拆分

### 2.1 已完成准备工作
1. 设计文档已确定功能边界。
2. 任务计划书已明确阶段目标。
3. UI 方案与静态效果图已完成。
4. 前端 `frontend` 与后端 `backend` 工程骨架已生成。

### 2.2 第一批开发范围

#### A. 后端基础能力
1. 调整后端工程到 Java 11 可运行版本。
2. 接入 SQLite 数据源与初始化脚本。
3. 建立用户、权限、类目、商品、订单等核心基础表结构。
4. 实现统一返回结构和健康检查接口。
5. 实现登录、获取当前用户、用户列表、用户创建、权限分配基础接口。
6. 建立 JWT 鉴权过滤器与服务端权限校验骨架。

#### B. 前端基础能力
1. 接入 Vue Router、Pinia、Element Plus。
2. 实现登录页和登录态持久化。
3. 实现主工作台布局、顶部栏、左侧导航。
4. 实现基于权限的菜单显示和页面路由守卫。
5. 实现商品中心、商品详情、订单列表、订单详情、统计页、用户管理页的第一版静态骨架。
6. 接入后端登录接口和当前用户接口。

#### C. 联调验证
1. 管理员登录后可访问全部基础页面。
2. 普通用户根据权限显示对应菜单。
3. 服务端未授权接口返回拒绝结果。
4. 前端未登录状态不能进入业务页面。

### 2.3 当前已完成能力概览
1. 登录、当前用户、JWT 鉴权、菜单与按钮级权限控制已经完成。
2. 商品中心、商品详情、商品编辑、附件上传、附件下载、主图切换、附件删除已经完成。
3. 订单创建、编辑、删除、完成、标签按量下载、库存校验与完成扣减已经完成。
4. 月度统计、年度统计、用户管理页面与对应后端接口已经完成。
5. 前端 `npm run build`、后端 `./mvnw.cmd test`、后端 8081 启动与默认管理员登录均已验证通过。

---

## 3. 当前剩余收尾项

### 3.1 联调与验收
1. 继续用真实数据复核商品附件、订单标签下载、库存扣减等关键业务场景。
2. 补充异常场景回归，包括越权访问、缺少标签模板、库存不足和空附件等边界情况。

### 3.2 文档与交付整理
1. 同步设计文档、计划书、实施拆分与当前实现保持一致。
2. 整理部署命令、默认账号、数据库备份与版本化 SQL 说明。

### 3.3 体验与性能收尾
1. 视需要继续优化前端构建体积与页面加载体验。
2. 视业务数据规模决定是否把当前前端本地筛选进一步升级为服务端分页查询。

---

## 4. 当前建议验收点
本轮代码提交后，至少应满足：
1. 前端项目可构建通过，并能进入登录页和业务页面。
2. 后端项目可启动并初始化 SQLite 数据库，8081 端口实例可正常访问。
3. 使用默认管理员账号可以登录，并获取当前用户信息。
4. 登录后可看到商品中心、商品详情、订单中心、订单详情、统计页、用户管理页。
5. 商品附件上传、下载、设主图、删除和订单标签下载链路可正常工作。
6. 订单创建、编辑、删除、完成和库存联动规则可正常工作。

---

## 5. 当前默认演示账号
为方便第一轮联调，建议先保留以下默认账号：
1. 管理员：`admin / Admin@123`
2. 客户用户：`customer / Customer@123`
3. 打包工：`packer / Packer@123`

后续可在用户管理页中由管理员进行新增、重置密码和权限调整。