Skip to content
2772780896Public

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

15 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WMS Lite · 个人仓库管理系统

扫码/输编码即出入库的轻量仓库操作台:一条主线(登录 → 编码出入库 → 查库存流水),不做大而全后台。

功能列表

  • 登录与角色:JWT 认证,ADMIN / STAFF 两级权限(前端菜单 + 后端中间件双层拦截)
  • 商品管理:sku 为自然键主键,扫码/输入编码直接定位商品(仅 ADMIN)
  • 仓库管理:code 为自然键主键(仅 ADMIN)
  • 编码操作台:输入商品编码回车带出商品 → 选仓库 → 输数量 → 提交;入库 / 出库 / 退货三 Tab;扫码枪 Enter 键流转适配,提交成功焦点自动回编码框支持连续作业
  • 采购入库 / 销售出库 / 双向退货(RETURN_IN 入 / RETURN_OUT 出,退货必填原因)
  • 库存查询:单商品聚合视图(各仓分布 + 总量)、全量/单仓库扁平列表,分页 + 排序
  • 流水查询:按商品 / 仓库 / 类型 / 日期范围筛选,分页 + 排序

技术亮点

  • 防超卖:出库不做"先查再改",而是 UPDATE ... WHERE quantity >= N 原子扣减——数据库隐式行锁让并发请求排队,库存不够 affectedRows=0 直接拒绝,无竞态窗口
  • 幂等入库:每笔操作携带客户端生成的 bizNo(UUID),数据库 @unique 约束拒绝网络重试导致的重复提交
  • 事务一致:库存变更与流水写入包在同一 prisma.$transaction,要么全成功要么全回滚
  • RBAC:JWT payload 携带角色,auth 验签 + rbac 路由守卫两层中间件;前端只做体验层隐藏,安全完全由后端裁决
  • 自然键设计:Product 以 sku、Warehouse 以 code 为主键,外键直接引用业务编码,全流程无内部 ID 中转
  • 排序白名单:lib/sort.js 只放行受控排序字段,防注入

技术栈

层 技术
后端 Node.js + Express 5 + Prisma + SQLite
前端 React 19 + Vite + Tailwind CSS 4 + React Router + Axios
认证 jsonwebtoken + bcryptjs

运行方式

# 1. 后端(默认 http://localhost:3000)
cd backend
npm install
npx prisma db push      # 初始化 SQLite 数据库(dev.db)
node prisma/seed.js     # 可选:写入演示账号
node app.js

# 2. 前端(默认 http://localhost:5173,/api 已代理到 :3000)
cd frontend
npm install
npm run dev

演示账号:admin / admin123(管理员)、staff / staff123(仓库员)。

目录导读

lite-wms/
├── backend/            # Express + Prisma 后端
│   ├── controllers/    # 业务控制器(登录/商品/仓库/出入库/库存)
│   ├── middleware/     # auth 验签 + rbac 角色守卫
│   ├── lib/            # prisma 实例 + 排序白名单工具
│   └── prisma/         # schema 与 SQLite 库、seed 脚本
├── frontend/           # React 编码操作台前端
│   └── src/
│       ├── api/        # axios 实例 + 请求/响应拦截器
│       ├── components/ # 布局/守卫/弹窗/分页
│       ├── context/    # 认证全局状态
│       └── pages/      # 登录/操作台/库存/流水/商品/仓库
├── 记录/               # 开发过程文档(历史档案)
└── 想法/               # 技术专题笔记(Node 并发模型、大文件流式传输、管理颗粒度)

延伸阅读

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages