# codeBuddy_web

**Repository Path**: ricardo__m/code-buddy_web

## Basic Information

- **Project Name**: codeBuddy_web
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-11
- **Last Updated**: 2026-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 库存管理系统

基于 Spring Boot + MyBatis Plus + MySQL 的库存管理系统。

## 技术栈

- **后端**: Spring Boot 2.7.14
- **ORM**: MyBatis Plus 3.5.3.1
- **数据库**: MySQL 8.0
- **构建工具**: Maven
- **前端**: HTML5 + CSS3 + JavaScript

## 项目结构

```
inventory-management/
├── pom.xml                           # Maven配置文件
├── src/
│   └── main/
│       ├── java/
│       │   └── com/example/inventory/
│       │       ├── InventoryApplication.java   # 启动类
│       │       ├── config/
│       │       │   └── MyMetaObjectHandler.java # 自动填充配置
│       │       ├── controller/
│       │       │   └── InventoryController.java # 控制器
│       │       ├── entity/
│       │       │   └── Inventory.java          # 实体类
│       │       ├── mapper/
│       │       │   └── InventoryMapper.java     # Mapper接口
│       │       └── service/
│       │           ├── InventoryService.java    # 服务接口
│       │           └── impl/
│       │               └── InventoryServiceImpl.java  # 服务实现
│       └── resources/
│           ├── application.yml       # 应用配置
│           └── sql/
│               └── init.sql          # 数据库初始化脚本
└── src/main/resources/static/
    └── index.html                    # 前端页面
```

## 快速开始

### 1. 环境要求

- JDK 1.8+
- Maven 3.6+
- MySQL 8.0+

### 2. 数据库配置

1. 登录 MySQL：
```bash
mysql -u root -p
```

2. 执行数据库初始化脚本：
```sql
source d:/codebuddyWORKSPACE/zzlWeb/src/main/resources/sql/init.sql
```

或在 MySQL 命令行中执行 `init.sql` 文件内容。

3. 修改 `application.yml` 中的数据库连接配置：
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/inventory_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root        # 修改为你的用户名
    password: root        # 修改为你的密码
```

### 3. 编译运行

```bash
# 进入项目目录
cd d:/codebuddyWORKSPACE/zzlWeb

# 编译项目
mvn clean package

# 运行项目
mvn spring-boot:run
```

或者直接运行打包后的 JAR 文件：
```bash
java -jar target/inventory-management-1.0.0.jar
```

### 4. 访问系统

打开浏览器访问：http://localhost:8080

## 功能特性

- ✅ 商品列表展示（分页、排序）
- ✅ 商品搜索（按名称、编码）
- ✅ 分类筛选
- ✅ 新增商品
- ✅ 编辑商品
- ✅ 删除商品
- ✅ 批量删除
- ✅ 库存统计（总量、低库存预警）
- ✅ 响应式设计，支持移动端

## API 接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/inventory/list | 获取分页列表 |
| GET | /api/inventory/{id} | 获取详情 |
| POST | /api/inventory | 新增 |
| PUT | /api/inventory/{id} | 更新 |
| DELETE | /api/inventory/{id} | 删除 |
| DELETE | /api/inventory/batch/{ids} | 批量删除 |
| GET | /api/inventory/statistics | 统计信息 |
| GET | /api/inventory/categories | 获取分类列表 |

## 数据库表结构

```sql
inventory 表：
- id: BIGINT, 主键ID
- product_code: VARCHAR(50), 商品编码
- product_name: VARCHAR(100), 商品名称
- category: VARCHAR(50), 分类
- specification: VARCHAR(100), 规格型号
- unit: VARCHAR(20), 单位
- quantity: INT, 库存数量
- price: DECIMAL(10,2), 单价
- total_amount: DECIMAL(12,2), 总金额
- warehouse: VARCHAR(100), 仓库位置
- supplier: VARCHAR(100), 供应商
- remark: VARCHAR(500), 备注
- create_time: DATETIME, 创建时间
- update_time: DATETIME, 更新时间
- deleted: TINYINT, 逻辑删除标记
```