# zwsAdminSystem

**Repository Path**: XiaoYangProject/zws-admin-system

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-18
- **Last Updated**: 2026-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🏭 zwsAdminSystem — 仓储物流可视化管理系统

> **烟草行业智能仓储管理系统**，前后端分离架构，覆盖入库、出库、库存、货位、托盘、设备监控、任务调度等核心仓储业务。  
> 基于 Vue 3 + .NET 8 构建，从 WinForms 旧系统全面升级改造。

## ✨ 作品亮点

| 亮点 | 说明 |
|------|------|
| 🏛️ **完整 DDD 分层架构** | 表现层、应用层、领域层、工具层清晰分离，代码可维护性高 |
| 🔄 **WinForms → Web 全量迁移** | 从 8 万行 WinForms 旧系统逐模块迁移到 Web 端，保持业务逻辑一致 |
| 🎨 **液态玻璃 UI 风格** | 毛玻璃效果 + 柔和渐变，兼顾美观与高效操作 |
| 🏗️ **CrudProxy 动态路由** | 零 Controller 即可实现任意实体的增删改查，大幅减少样板代码 |
| ⚙️ **代码生成器** | 一键生成 Service 接口/实现 + 前端 API 调用全链路 |
| 🔐 **JWT 无状态认证** | Token 认证 + 操作日志审计，安全可追溯 |
| 📦 **一体化部署** | 前端构建产物直接输出到后端 wwwroot，单文件部署 |

## 技术栈

| 层级 | 技术 |
|------|------|
| **前端** | Vue 3.4 + Vite 5 + Vue Router 4 + Pinia 2 |
| **UI 组件库** | Element Plus 2.5 + Vxe Table 4 + ECharts 6 |
| **后端** | .NET 8 + ASP.NET Core Web API + Entity Framework Core 8 |
| **数据库** | SQL Server |
| **认证** | JWT Bearer Token |

## 项目结构

```
zwsAdminSystem/
├── vue3-admin-web/                    # 前端主项目（Vue3）
│   ├── src/
│   │   ├── api/                       # API 封装（按模块分目录）
│   │   ├── assets/css/theme.css       # 全局主题（液态玻璃风格）
│   │   ├── components/                # 公共组件
│   │   ├── router/                    # 路由配置
│   │   ├── utils/                     # 工具函数（axios 封装、加密等）
│   │   └── views/                     # 业务页面
│   │       ├── bill/                  # 单据管理（入库/出库/任务）
│   │       ├── report/                # 报表（单据/库存/出入库统计）
│   │       ├── warehouse/             # 仓库管理（货位/现场监控/物料/托盘）
│   │       ├── basic/                 # 基础数据（设备/路段/路线）
│   │       ├── system/                # 系统管理（用户/角色/菜单/日志）
│   │       └── platform/              # 平台工具
│   ├── package.json
│   └── vite.config.js                 # 代理 /api → localhost:15645
│
├── XiaoYang.NET8.bcpysk/              # 后端项目（.NET 8 DDD 分层）
│   ├── XiaoYang.NET8.bcpysk.WebAPI/   # 表现层（Controller + CrudProxy 动态路由）
│   ├── XiaoYang.NET8.bcpysk.Application/  # 应用层（Service 接口/实现 + DbContext）
│   ├── XiaoYang.NET8.bcpysk.Domain/       # 领域层（实体 + 枚举 + DTO）
│   ├── XiaoYang.NET8.bcpysk.Utils/        # 工具层（NLog + 统一响应）
│   └── XiaoYang.NET8.bcpysk.CodeGenerator/ # 代码生成器
│
├── vue2-admin-web/                    # 前端旧版（Vue2，已保留但不再维护）
└── 数据库架构.sql                      # 数据库初始化脚本
```

## 系统功能

### 仓储业务
- **入库管理** — 入库单据创建与跟踪
- **出库管理** — 出库单据与人工出库
- **任务管理** — 任务调度与请求管理

### 仓库监控
- **现场监控** — 输送线状态、堆垛机状态、任务接收开关，实时轮询
- **货位监控** — 货位状态可视化

### 基础数据
- 设备管理、路段管理、路线配置
- 物料管理、货位管理、托盘管理

### 报表统计
- 单据报表、实时库存统计、出入库统计

### 系统管理
- 用户 / 用户组 / 角色 / 菜单管理
- 数据字典、操作日志、文件管理

## 快速开始

### 环境要求
- Node.js ≥ 18
- .NET 8.0 SDK
- SQL Server（数据库）

### 前端启动

```bash
cd vue3-admin-web
npm install
npm run dev
```

前端默认运行在 `http://localhost:8080`，API 请求代理到后端 `http://localhost:15645`。

### 后端启动

```bash
cd XiaoYang.NET8.bcpysk
dotnet run --project XiaoYang.NET8.bcpysk.WebAPI
```

后端默认运行在 `http://localhost:15645`，Swagger 文档地址 `http://localhost:15645/swagger`。

### 构建部署

前端构建产物会直接输出到后端 `wwwroot` 目录，实现前后端一体化部署：

```bash
cd vue3-admin-web
npm run build
```

## 架构说明

### CrudProxy 动态路由
后端 `/api/crud/{entityName}/{action}` 提供通用 CRUD 端点，前端通过表名即可调用任意实体的增删改查，无需为每个实体单独编写 Controller。

### 代码生成器
```bash
# 在 CodeGenerator 项目目录下
.\add --entity=表名
```
自动生成 Service 接口/实现 + 前端 API 调用链路。

### 认证流程
JWT Token 无状态认证：登录获取 Token → 存储到 localStorage → 请求头携带 `Authorization: Bearer {token}` → 路由守卫拦截未登录访问。

---

## 📄 作品简介

**zwsAdminSystem — 烟草行业智能仓储可视化管理系统**

基于 Vue 3 + .NET 8 全栈架构，从 8 万行 WinForms 旧系统完整重构迁移的 Web 端仓储管理系统。系统覆盖入库管理、出库管理、任务调度、库存统计、货位监控、现场监控、设备管理、物料/托盘/货位管理、用户角色权限等全链路仓储业务，实现了仓储作业的数字化与可视化监控。

**技术实现方面**，前端采用 Vue 3 组合式 API + Element Plus + Vite，实现液态玻璃风格的现代化 UI；后端采用 .NET 8 + Entity Framework Core + DDD 四层架构（WebAPI/Application/Domain/Utils），通过自定义 CrudProxy 动态路由机制大幅减少 Controller 样板代码，配合代码生成器可一键生成全链路 CRUD。认证采用 JWT Bearer Token，前端通过 Axios 拦截器自动携带 Token，路由守卫控制访问权限。系统支持前后端一体化部署，前端构建产物直接输出到后端 wwwroot 目录。

**核心功能亮点**：实时库存统计支持物料+批次维度汇总与托盘级钻取；货位监控以二维矩阵网格展示货位状态，支持颜色编码可视化；现场监控实时显示堆垛机/输送线运行状态与任务接收状态；入库/出库单据全流程管理；物料/货位/托盘等基础数据维护；用户角色菜单权限管理。系统自研代码生成器，可通过命令行快速生成 Service 层接口/实现与前端 API 调用，显著提升开发效率。