feat: 重构前端代码结构并添加Java后端支持

- 重构前端导入和组件结构，优化代码组织 - 添加Java后端基础框架和API实现 - 修复类型定义和接口兼容性问题 - 新增测试页面和工具函数 - 优化国际化支持和错误处理 - 更新依赖配置和构建脚本新增Java后端模块： - 实现基础认证、订单、支付等服务 - 添加Swagger API文档支持 - 配置数据库连接和缓存 - 实现国际化消息处理 - 添加安全过滤器和限流控制
2026-03-30 16:51:18 +08:00
parent 1b14947e7b
commit e47beffaf9
199 changed files with 24719 additions and 958 deletions
--- a/serverjava/docs/10_API_Changelog.md
+++ b/serverjava/docs/10_API_Changelog.md
@@ -0,0 +1,335 @@
+# API 变更日志
+
+## 1. 版本 1.0.0 (2024-01-01)
+
+### 1.1 新增功能
+
+- **认证模块**：
+  - 新增 `POST /api/v1/auth/login` 接口：用户登录
+  - 新增 `POST /api/v1/auth/register` 接口：用户注册
+  - 新增 `GET /api/v1/auth/me` 接口：获取当前用户信息
+
+- **商品模块**：
+  - 新增 `POST /api/v1/products` 接口：创建商品
+  - 新增 `GET /api/v1/products` 接口：获取商品列表
+  - 新增 `GET /api/v1/products/{id}` 接口：获取商品详情
+  - 新增 `PUT /api/v1/products/{id}` 接口：更新商品
+  - 新增 `DELETE /api/v1/products/{id}` 接口：删除商品
+
+- **订单模块**：
+  - 新增 `POST /api/v1/orders` 接口：创建订单
+  - 新增 `GET /api/v1/orders` 接口：获取订单列表
+  - 新增 `GET /api/v1/orders/{id}` 接口：获取订单详情
+  - 新增 `PUT /api/v1/orders/{id}` 接口：更新订单
+  - 新增 `DELETE /api/v1/orders/{id}` 接口：删除订单
+
+- **支付模块**：
+  - 新增 `POST /api/v1/payments` 接口：创建支付
+  - 新增 `GET /api/v1/payments` 接口：获取支付列表
+  - 新增 `GET /api/v1/payments/{id}` 接口：获取支付详情
+  - 新增 `PUT /api/v1/payments/{id}` 接口：更新支付
+
+- **物流模块**：
+  - 新增 `POST /api/v1/logistics` 接口：创建物流
+  - 新增 `GET /api/v1/logistics` 接口：获取物流列表
+  - 新增 `GET /api/v1/logistics/{id}` 接口：获取物流详情
+  - 新增 `PUT /api/v1/logistics/{id}` 接口：更新物流
+
+- **用户模块**：
+  - 新增 `POST /api/v1/users` 接口：创建用户
+  - 新增 `GET /api/v1/users` 接口：获取用户列表
+  - 新增 `GET /api/v1/users/{id}` 接口：获取用户详情
+  - 新增 `PUT /api/v1/users/{id}` 接口：更新用户
+  - 新增 `DELETE /api/v1/users/{id}` 接口：删除用户
+
+- **监控模块**：
+  - 新增 `GET /api/v1/monitoring/health` 接口：系统健康状态
+  - 新增 `GET /api/v1/monitoring/ping` 接口：系统响应测试
+  - 新增 `GET /api/v1/monitoring/metrics` 接口：系统性能指标
+
+- **告警模块**：
+  - 新增 `POST /api/v1/alerts` 接口：创建告警
+  - 新增 `GET /api/v1/alerts` 接口：获取告警列表
+  - 新增 `GET /api/v1/alerts/{id}` 接口：获取告警详情
+  - 新增 `PUT /api/v1/alerts/{id}` 接口：更新告警
+  - 新增 `PUT /api/v1/alerts/{id}/resolve` 接口：解决告警
+
+- **配置模块**：
+  - 新增 `POST /api/v1/configs` 接口：创建配置
+  - 新增 `GET /api/v1/configs` 接口：获取配置列表
+  - 新增 `GET /api/v1/configs/{id}` 接口：获取配置详情
+  - 新增 `PUT /api/v1/configs/{id}` 接口：更新配置
+  - 新增 `DELETE /api/v1/configs/{id}` 接口：删除配置
+
+- **审计模块**：
+  - 新增 `GET /api/v1/audit` 接口：获取审计日志列表
+  - 新增 `GET /api/v1/audit/{id}` 接口：获取审计日志详情
+
+- **数据模块**：
+  - 新增 `POST /api/v1/data/import` 接口：导入数据
+  - 新增 `GET /api/v1/data/export` 接口：导出数据
+
+- **报表模块**：
+  - 新增 `GET /api/v1/reports/sales` 接口：销售报表
+  - 新增 `GET /api/v1/reports/inventory` 接口：库存报表
+  - 新增 `GET /api/v1/reports/users` 接口：用户报表
+
+### 1.2 变更内容
+
+- **认证模块**：
+  - 使用 JWT 进行认证
+  - 支持角色授权
+
+- **商品模块**：
+  - 支持商品分页查询
+  - 支持商品搜索
+
+- **订单模块**：
+  - 支持订单状态流转
+  - 支持订单查询
+
+- **支付模块**：
+  - 支持多种支付方式
+  - 支持支付状态更新
+
+- **物流模块**：
+  - 支持物流状态更新
+  - 支持物流查询
+
+- **用户模块**：
+  - 支持用户角色管理
+  - 支持用户权限控制
+
+- **监控模块**：
+  - 支持系统健康检查
+  - 支持系统性能监控
+
+- **告警模块**：
+  - 支持告警级别管理
+  - 支持告警状态更新
+
+- **配置模块**：
+  - 支持配置类型管理
+  - 支持配置查询
+
+- **审计模块**：
+  - 支持审计日志查询
+  - 支持审计日志过滤
+
+- **数据模块**：
+  - 支持数据导入导出
+  - 支持数据格式转换
+
+- **报表模块**：
+  - 支持销售报表生成
+  - 支持库存报表生成
+  - 支持用户报表生成
+
+### 1.3 修复问题
+
+- **认证模块**：
+  - 修复登录失败时的错误处理
+  - 修复注册时的参数验证
+
+- **商品模块**：
+  - 修复商品创建时的参数验证
+  - 修复商品更新时的权限检查
+
+- **订单模块**：
+  - 修复订单创建时的状态设置
+  - 修复订单更新时的权限检查
+
+- **支付模块**：
+  - 修复支付创建时的参数验证
+  - 修复支付状态更新时的错误处理
+
+- **物流模块**：
+  - 修复物流创建时的参数验证
+  - 修复物流状态更新时的错误处理
+
+- **用户模块**：
+  - 修复用户创建时的参数验证
+  - 修复用户更新时的权限检查
+
+- **监控模块**：
+  - 修复健康检查端点的响应格式
+  - 修复性能指标的计算
+
+- **告警模块**：
+  - 修复告警创建时的参数验证
+  - 修复告警状态更新时的错误处理
+
+- **配置模块**：
+  - 修复配置创建时的参数验证
+  - 修复配置更新时的权限检查
+
+- **审计模块**：
+  - 修复审计日志查询时的参数验证
+  - 修复审计日志过滤时的错误处理
+
+- **数据模块**：
+  - 修复数据导入时的格式验证
+  - 修复数据导出时的格式转换
+
+- **报表模块**：
+  - 修复销售报表生成时的计算错误
+  - 修复库存报表生成时的计算错误
+  - 修复用户报表生成时的计算错误
+
+## 2. 版本 1.1.0 (2024-02-01)
+
+### 2.1 新增功能
+
+- **认证模块**：
+  - 新增 `POST /api/v1/auth/refresh` 接口：刷新 token
+  - 新增 `POST /api/v1/auth/logout` 接口：用户登出
+
+- **商品模块**：
+  - 新增 `GET /api/v1/products/categories` 接口：获取商品分类
+  - 新增 `POST /api/v1/products/batch` 接口：批量创建商品
+
+- **订单模块**：
+  - 新增 `POST /api/v1/orders/batch` 接口：批量创建订单
+  - 新增 `GET /api/v1/orders/status` 接口：获取订单状态统计
+
+- **支付模块**：
+  - 新增 `POST /api/v1/payments/batch` 接口：批量创建支付
+  - 新增 `GET /api/v1/payments/status` 接口：获取支付状态统计
+
+- **物流模块**：
+  - 新增 `POST /api/v1/logistics/batch` 接口：批量创建物流
+  - 新增 `GET /api/v1/logistics/status` 接口：获取物流状态统计
+
+- **用户模块**：
+  - 新增 `POST /api/v1/users/batch` 接口：批量创建用户
+  - 新增 `GET /api/v1/users/roles` 接口：获取用户角色
+
+- **监控模块**：
+  - 新增 `GET /api/v1/monitoring/health/detail` 接口：详细健康状态
+  - 新增 `GET /api/v1/monitoring/metrics/detail` 接口：详细性能指标
+
+- **告警模块**：
+  - 新增 `POST /api/v1/alerts/batch` 接口：批量创建告警
+  - 新增 `GET /api/v1/alerts/severity` 接口：获取告警严重程度统计
+
+- **配置模块**：
+  - 新增 `POST /api/v1/configs/batch` 接口：批量创建配置
+  - 新增 `GET /api/v1/configs/types` 接口：获取配置类型
+
+- **审计模块**：
+  - 新增 `GET /api/v1/audit/actions` 接口：获取审计操作类型
+  - 新增 `GET /api/v1/audit/resources` 接口：获取审计资源类型
+
+- **数据模块**：
+  - 新增 `POST /api/v1/data/import/batch` 接口：批量导入数据
+  - 新增 `GET /api/v1/data/export/batch` 接口：批量导出数据
+
+- **报表模块**：
+  - 新增 `GET /api/v1/reports/sales/detail` 接口：详细销售报表
+  - 新增 `GET /api/v1/reports/inventory/detail` 接口：详细库存报表
+  - 新增 `GET /api/v1/reports/users/detail` 接口：详细用户报表
+
+### 2.2 变更内容
+
+- **认证模块**：
+  - 优化 JWT 认证逻辑
+  - 支持 token 过期时间配置
+
+- **商品模块**：
+  - 优化商品搜索逻辑
+  - 支持商品分类管理
+
+- **订单模块**：
+  - 优化订单状态流转逻辑
+  - 支持订单批量操作
+
+- **支付模块**：
+  - 优化支付处理逻辑
+  - 支持支付批量操作
+
+- **物流模块**：
+  - 优化物流处理逻辑
+  - 支持物流批量操作
+
+- **用户模块**：
+  - 优化用户角色管理逻辑
+  - 支持用户批量操作
+
+- **监控模块**：
+  - 优化健康检查逻辑
+  - 支持详细性能指标
+
+- **告警模块**：
+  - 优化告警处理逻辑
+  - 支持告警批量操作
+
+- **配置模块**：
+  - 优化配置管理逻辑
+  - 支持配置批量操作
+
+- **审计模块**：
+  - 优化审计日志查询逻辑
+  - 支持审计操作类型和资源类型查询
+
+- **数据模块**：
+  - 优化数据导入导出逻辑
+  - 支持数据批量操作
+
+- **报表模块**：
+  - 优化报表生成逻辑
+  - 支持详细报表生成
+
+### 2.3 修复问题
+
+- **认证模块**：
+  - 修复 token 刷新时的错误处理
+  - 修复登出时的 token 失效处理
+
+- **商品模块**：
+  - 修复商品分类查询时的错误处理
+  - 修复商品批量创建时的参数验证
+
+- **订单模块**：
+  - 修复订单批量创建时的参数验证
+  - 修复订单状态统计时的计算错误
+
+- **支付模块**：
+  - 修复支付批量创建时的参数验证
+  - 修复支付状态统计时的计算错误
+
+- **物流模块**：
+  - 修复物流批量创建时的参数验证
+  - 修复物流状态统计时的计算错误
+
+- **用户模块**：
+  - 修复用户批量创建时的参数验证
+  - 修复用户角色查询时的错误处理
+
+- **监控模块**：
+  - 修复详细健康状态查询时的错误处理
+  - 修复详细性能指标查询时的计算错误
+
+- **告警模块**：
+  - 修复告警批量创建时的参数验证
+  - 修复告警严重程度统计时的计算错误
+
+- **配置模块**：
+  - 修复配置批量创建时的参数验证
+  - 修复配置类型查询时的错误处理
+
+- **审计模块**：
+  - 修复审计操作类型查询时的错误处理
+  - 修复审计资源类型查询时的错误处理
+
+- **数据模块**：
+  - 修复数据批量导入时的格式验证
+  - 修复数据批量导出时的格式转换
+
+- **报表模块**：
+  - 修复详细销售报表生成时的计算错误
+  - 修复详细库存报表生成时的计算错误
+  - 修复详细用户报表生成时的计算错误
+
+## 3. 总结
+
+本 API 变更日志详细记录了 Crawlful Hub 项目的 API 变更历史。通过本日志，您可以了解 API 的新增功能、变更内容和修复问题，便于 API 的使用和维护。