beta1.0

README.md

@@ -0,0 +1,163 @@
+# 菜品管理系统后端
+
+这是一个基于Spring Boot + MyBatis-Plus的菜品管理系统后端API。
+
+## 技术栈
+
+- **Spring Boot 3.4.6** - Web框架
+- **MyBatis-Plus 3.5.3.1** - 数据持久层框架
+- **MySQL** - 数据库
+- **Lombok** - 简化Java代码
+- **Maven** - 项目管理工具
+
+## 项目结构
+
+```
+src/
+├── main/
+│   ├── java/com/example/javatest/
+│   │   ├── JavaTestApplication.java      # 主启动类
+│   │   ├── config/
+│   │   │   └── MybatisPlusConfig.java    # MyBatis-Plus配置
+│   │   ├── controller/
+│   │   │   └── DishController.java       # 菜品控制器
+│   │   ├── entity/
+│   │   │   └── Dish.java                 # 菜品实体类
+│   │   ├── mapper/
+│   │   │   └── DishMapper.java           # 菜品Mapper接口
+│   │   └── service/
+│   │       ├── DishService.java          # 菜品服务接口
+│   │       └── impl/
+│   │           └── DishServiceImpl.java  # 菜品服务实现
+│   └── resources/
+│       ├── application.properties        # 应用配置
+│       ├── mapper/
+│       │   └── DishMapper.xml           # MyBatis映射文件
+│       └── sql/
+│           └── dishes.sql               # 数据库建表脚本
+```
+
+## 快速开始
+
+### 1. 环境要求
+
+- JDK 17+
+- MySQL 8.0+
+- Maven 3.6+
+
+### 2. 数据库配置
+
+1. 创建MySQL数据库
+2. 执行 `src/main/resources/sql/dishes.sql` 脚本创建表和测试数据
+3. 修改 `application.properties` 中的数据库连接信息：
+
+```properties
+spring.datasource.url=jdbc:mysql://localhost:3306/restaurant_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
+spring.datasource.username=your_username
+spring.datasource.password=your_password
+```
+
+### 3. 运行项目
+
+```bash
+# 克隆项目
+git clone <your-repo-url>
+
+# 进入项目目录
+cd java-test
+
+# 安装依赖并运行
+mvn spring-boot:run
+```
+
+项目启动后访问：http://localhost:8080
+
+## API接口
+
+### 菜品管理接口
+
+| 方法 | 路径 | 描述 |
+|------|------|------|
+| GET | `/api/dishes` | 分页查询菜品列表 |
+| GET | `/api/dishes/{id}` | 根据ID查询菜品详情 |
+| POST | `/api/dishes` | 添加菜品 |
+| PUT | `/api/dishes/{id}` | 更新菜品 |
+| DELETE | `/api/dishes/{id}` | 删除菜品 |
+| PATCH | `/api/dishes/{id}/status` | 更新菜品状态 |
+
+### 分页查询参数
+
+- `page`: 当前页，默认1
+- `size`: 每页大小，默认10
+- `dishName`: 菜品名称（模糊查询）
+- `category`: 分类筛选
+- `status`: 状态筛选
+
+### 示例请求
+
+```bash
+# 查询菜品列表
+curl "http://localhost:8080/api/dishes?page=1&size=10"
+
+# 根据名称搜索
+curl "http://localhost:8080/api/dishes?dishName=宫保鸡丁"
+
+# 根据分类筛选
+curl "http://localhost:8080/api/dishes?category=主食"
+
+# 更新菜品状态
+curl -X PATCH "http://localhost:8080/api/dishes/1/status" \
+  -H "Content-Type: application/json" \
+  -d '{"status": "停售"}'
+```
+
+## 数据模型
+
+### Dish (菜品)
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| dishId | Long | 菜品ID (主键) |
+| dishName | String | 菜品名称 |
+| category | String | 分类 |
+| price | BigDecimal | 价格 |
+| stock | Integer | 库存 |
+| status | String | 状态 (在售/停售) |
+| description | String | 描述 |
+| imageUrl | String | 图片URL |
+| sales | Integer | 销量 |
+| tag | String | 标签 |
+| isDeleted | Integer | 逻辑删除标记 |
+| deletedAt | LocalDateTime | 删除时间 |
+| createdAt | LocalDateTime | 创建时间 |
+| updatedAt | LocalDateTime | 更新时间 |
+
+## 功能特性
+
+- ✅ CRUD操作
+- ✅ 分页查询
+- ✅ 条件筛选（名称、分类、状态）
+- ✅ 逻辑删除
+- ✅ 自动时间戳填充
+- ✅ 跨域支持
+- ✅ 统一响应格式
+
+## 前端集成
+
+此后端API与Vue3前端菜品管理页面完全兼容，支持：
+
+- 菜品列表展示
+- 分页显示
+- 搜索筛选
+- 菜品详情查看
+- 菜品编辑
+- 状态切换
+- 菜品删除
+
+## 开发说明
+
+- 使用MyBatis-Plus简化数据操作
+- 支持逻辑删除，数据安全
+- 自动填充创建时间和更新时间
+- ResponseEntity统一响应格式
+- 完整的异常处理机制