┌─────────────────────────────────────────────────────────┐
│                   浏览器（Browser）                       │
├─────────────────────────────────────────────────────────┤
│          后台管理（Admin） localhost:3000/admin            │
│  · 数据看板 / 库存预警 / 出入库趋势图表                     │
│  · 仓库 / 库区库位 / 商品 / 供应商 / 客户 基础数据管理        │
│  · 入库单 / 出库单 / 库存 / 库存流水 / 盘点管理             │
│  · 用户管理 / 公告管理 / 个人中心                          │
└─────────────────────────────────────────────────────────┘
                          │  HTTP /api/*
                          ▼
┌─────────────────────────────────────────────────────────┐
│              Spring Boot 后端（localhost:8080）            │
├─────────────┬──────────────┬──────────────┬──────────────┤
│  Interceptor │  Controller  │   Service    │   Mapper     │
│  JWT认证     │  admin/ 后台  │   业务逻辑    │  MyBatis-Plus│
│  角色鉴权     │  auth/ 登录   │   事务管理    │  XML 自定义SQL│
└─────────────┴──────────────┴──────────────┴──────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────┐
│            MySQL 8.0（warehouse_management）              │
│   17 张数据表：user, warehouse, storage_area,             │
│   storage_location, product_category, product, supplier, │
│   customer, inbound_order(+item), outbound_order(+item), │
│   stock, stock_record, stock_check(+item), announcement  │
└─────────────────────────────────────────────────────────┘

warehouse-management-system/
├── db/                                 # 数据库初始化脚本目录
│   └── init.sql                        # 建表 + 初始数据脚本（17 张表）
├── springboot/                         # 后端 Spring Boot 项目
│   ├── pom.xml                         # Maven 配置（Spring Boot 3.2.3）
│   └── src/main/java/com/example/
│       ├── common/                     # 公共模块
│       │   ├── annotation/             # @Anonymous、@RequireRole 注解
│       │   ├── constant/               # 安全常量
│       │   ├── enums/                  # UserRoleEnum、UserStatusEnum
│       │   ├── exception/              # 全局异常处理 + 错误码枚举
│       │   ├── BaseEntity.java         # 基础实体（id + 时间戳）
│       │   ├── LogicDeleteEntity.java  # 逻辑删除实体
│       │   ├── PageResult.java         # 统一分页结果
│       │   ├── Result.java             # 统一响应体
│       │   └── UserContext.java        # 用户上下文工具
│       ├── config/                     # 配置类
│       │   ├── CorsConfig.java         # 跨域配置
│       │   ├── JacksonConfig.java      # JSON 序列化配置
│       │   ├── MetaObjectHandlerConfig.java # 字段自动填充
│       │   ├── MybatisPlusConfig.java  # MP 分页 + 逻辑删除
│       │   └── WebMvcConfig.java       # 拦截器注册 + 静态资源映射
│       ├── controller/
│       │   ├── admin/                  # 12 个后台控制器（仓库/库区/商品/供应商/客户/
│       │   │                           #   入库/出库/库存/盘点/统计/用户/公告）
│       │   ├── front/                  # AuthController（登录）、UploadController（上传）
│       │   └── FileController.java     # 文件访问
│       ├── dto/                        # 数据传输对象（10 个业务模块，19 个 DTO）
│       ├── entity/                     # 17 个实体类
│       ├── mapper/                     # 17 个 Mapper 接口
│       ├── security/                   # JWT 认证 + 角色鉴权
│       │   ├── JwtUtils.java           # Token 生成/解析
│       │   ├── JwtAuthInterceptor.java # 认证拦截器
│       │   └── RoleAuthInterceptor.java# 角色鉴权拦截器
│       ├── service/                    # 13 个业务服务类
│       ├── utils/                      # OrderNoUtils（单号生成）、PasswordUtils
│       ├── vo/                         # 视图对象（11 个业务模块，19 个 VO）
│       └── MainApplication.java        # 启动类
│   └── src/main/resources/
│       ├── application.yml             # 主配置文件
│       └── mapper/                     # MyBatis XML 自定义 SQL（如有）
├── vue/                                # 前端 Vue 3 项目
│   └── src/
│       ├── api/                        # API 封装（admin 后台 12 个模块 + 统一出口 + auth/common）
│       ├── assets/styles/main.css      # 全局样式（工业仓储主题：深青绿 + 琥珀）
│       ├── layouts/AdminLayout.vue     # 后台布局（侧边栏 + 顶栏）
│       ├── router/index.js             # 路由配置（后台 14 个页面 + 登录页）
│       ├── stores/user.js              # Pinia 用户状态
│       ├── utils/                      # request.js（Axios 拦截器）、file.js
│       ├── views/                      # 后台页面（14 个）+ Login.vue
│       └── main.js                     # 入口文件
└── uploads/                            # 文件上传目录（头像等）