# VWMS

**Repository Path**: null_148_0124/vwms

## Basic Information

- **Project Name**: VWMS
- **Description**: AI 智能WMS
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-07-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# V-WMS 语音智能仓储管理系统

面向制造、电商、第三方物流企业的触屏原生语音一体化智能仓储管理平台，深度集成本地私有化 LLM、流式 ASR、TTS、VAD 声纹校验、AR 视觉识别。

## 技术栈

- **后端框架**: FastAPI 0.115+
- **工作流引擎**: LangGraph 0.1+
- **LLM服务**: Dify / OpenAI兼容 / LLMStudio / 本地模型
- **ORM**: SQLAlchemy 2.0
- **数据库**: PostgreSQL 15+
- **缓存**: Redis 7+
- **认证**: JWT + 声纹认证
- **API文档**: Swagger UI / ReDoc

## 功能模块

### 核心业务模块
1. **入库管理** - 语音创建入库单、质检、库位分配、批量入库
2. **出库管理** - 订单创建、波次优化、拣货、复核、出库完成
3. **移库管理** - 库位间库存转移
4. **盘点管理** - 库区盘点、差异处理、库存调整
5. **采购管理** - 采购单创建、审批、驳回

### 创新功能模块
1. **声纹登录** - 无需账号密码，声纹口令登录
2. **断点暂停恢复** - 任意业务节点暂停，断点恢复执行
3. **语音指令解析** - 一句话语音直达业务功能
4. **编码智能校正** - LLM 编码纠错，支持 SKU/库位/托盘编码
5. **库存预警** - 低于安全库存自动预警

### 系统管理模块
1. **用户管理** - 用户注册、权限管理
2. **SKU管理** - 商品信息管理
3. **库位管理** - 库位信息管理
4. **热词管理** - ASR 热词库同步

## 项目结构

```
new_v1/
├── main.py              # FastAPI 应用入口
├── config.py            # 配置文件
├── database.py          # 数据库连接
├── redis_client.py      # Redis 客户端
├── models.py            # SQLAlchemy ORM 模型
├── schemas.py           # Pydantic 数据模型
├── requirements.txt     # 依赖列表
├── .env                 # 环境变量
├── init_db.py           # 数据库初始化脚本
├── langgraph_flow.py    # LangGraph 工作流定义
├── langgraph_routes.py  # LangGraph 工作流 API
├── llm_service.py       # LLM服务（支持多供应商）
├── llm_routes.py        # LLM API
├── auth_service.py      # 认证服务
├── auth_routes.py       # 认证路由
├── sku_service.py       # SKU 服务
├── sku_routes.py        # SKU 路由
├── location_service.py  # 库位服务
├── location_routes.py   # 库位路由
├── inventory_service.py # 库存服务
├── inventory_routes.py  # 库存路由
├── inbound_service.py   # 入库服务
├── inbound_routes.py    # 入库路由
├── outbound_service.py  # 出库服务
├── outbound_routes.py   # 出库路由
├── transfer_service.py  # 移库服务
├── transfer_routes.py   # 移库路由
├── count_service.py     # 盘点服务
├── count_routes.py      # 盘点路由
├── purchase_service.py  # 采购服务
├── purchase_routes.py   # 采购路由
├── checkpoint_service.py# 断点服务
├── checkpoint_routes.py # 断点路由
├── voice_service.py     # 语音服务
└── voice_routes.py      # 语音路由
```

## 快速开始

### 1. 环境要求

- Python 3.10+
- PostgreSQL 15+
- Redis 7+

### 2. 安装依赖

```bash
pip install -r requirements.txt
```

### 3. 配置环境变量

修改 `.env` 文件：

```env
DATABASE_URL=postgresql://vwms:vwms@localhost:5432/vwms
REDIS_URL=redis://localhost:6379/0
SECRET_KEY=vwms_secret_key_2024_enterprise_edition
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=120
VOICE_SIMILARITY_THRESHOLD=0.85

LLM_PROVIDER=dify
LLM_API_KEY=your_dify_api_key_here
LLM_BASE_URL=http://localhost:5173
LLM_MODEL=gpt-4o-mini
DIFY_APP_ID=your_dify_app_id_here
LLM_STREAM=true
```

### 4. 初始化数据库

```bash
python init_db.py
```

### 5. 启动服务

```bash
uvicorn main:app --host 0.0.0.0 --port 8000 --reload
```

### 6. 访问 API 文档

- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc

## 使用 Docker (推荐)

```bash
docker-compose up -d
```

## API 端点概览

### 认证
- `POST /api/auth/register` - 用户注册
- `POST /api/auth/login` - 用户名密码登录
- `POST /api/auth/voiceprint-login` - 声纹登录

### 库存管理
- `GET /api/inventory/summary` - 库存汇总
- `GET /api/inventory/alerts` - 库存预警
- `GET /api/inventory/stock/{sku_code}` - SKU库存查询

### 入库
- `POST /api/inbound/orders` - 创建入库单
- `POST /api/inbound/orders/{id}/receive` - 确认收货
- `POST /api/inbound/orders/{id}/complete` - 完成入库

### 出库
- `POST /api/outbound/orders` - 创建出库单
- `POST /api/outbound/orders/{id}/pick` - 拣货
- `POST /api/outbound/orders/{id}/complete` - 完成出库

### 语音
- `POST /api/voice/parse` - 解析语音指令
- `POST /api/voice/correct` - 编码校正
- `POST /api/voice/hotwords/sync` - 同步热词

### 断点管理
- `GET /api/checkpoints` - 获取暂停任务
- `POST /api/checkpoints/{id}/resume` - 恢复暂停任务
- `POST /api/checkpoints/batch/resume` - 批量恢复

### LangGraph 工作流
- `POST /api/langgraph/parse` - 解析语音指令
- `POST /api/langgraph/inbound/start` - 启动入库流程
- `POST /api/langgraph/inbound/confirm` - 确认入库步骤
- `POST /api/langgraph/inbound/pause` - 暂停入库流程
- `POST /api/langgraph/outbound/start` - 启动出库流程
- `POST /api/langgraph/outbound/confirm` - 确认出库步骤
- `POST /api/langgraph/purchase/start` - 启动采购流程
- `POST /api/langgraph/purchase/confirm` - 确认采购步骤
- `POST /api/langgraph/resume` - 恢复暂停流程
- `GET /api/langgraph/graph/{flow_type}` - 获取工作流图(Mermaid)
- `GET /api/langgraph/diagram/{flow_type}` - 获取流程图(Mermaid)

### LLM 服务
- `GET /api/llm/config` - 获取LLM配置
- `POST /api/llm/chat` - 对话接口
- `POST /api/llm/stream-chat` - 流式对话
- `POST /api/llm/correct` - 编码智能校正
- `POST /api/llm/parse` - 语音指令解析
- `POST /api/llm/extract` - 实体提取
- `POST /api/llm/reason` - 推理决策

## LLM 供应商配置

### Dify平台
```env
LLM_PROVIDER=dify
LLM_API_KEY=your_dify_api_key
LLM_BASE_URL=http://your_dify_host:5173
DIFY_APP_ID=your_chatflow_app_id
```

### OpenAI兼容模式
```env
LLM_PROVIDER=openai
LLM_API_KEY=your_openai_api_key
LLM_BASE_URL=https://api.openai.com/v1
LLM_MODEL=gpt-4o-mini
```

### LLMStudio
```env
LLM_PROVIDER=llmstudio
LLM_API_KEY=sk-xxx
LLM_BASE_URL=http://localhost:1234/v1
LLM_MODEL=your_model_name
```

### 本地模型（OpenAI兼容API）
```env
LLM_PROVIDER=local
LLM_API_KEY=sk-xxx
LLM_BASE_URL=http://localhost:8000/v1
LLM_MODEL=your_local_model
```

## 触屏终端规范

- 触控按钮最小 60*60px
- 行高 ≥ 80px
- 字体最小 16px（操作文字≥20px）
- 支持手势滑动、双指缩放
- 业务弹窗占屏幕 80% 以上

## 安全规范

- 全栈本地内网私有化部署
- 语音原始音频处理完成即时销毁
- 每台触屏设备绑定内网 MAC 地址
- 操作日志全链路记录
- PostgreSQL 每日自动全量备份

## 许可证

MIT License