扫码/输编码即出入库的轻量仓库操作台:一条主线(登录 → 编码出入库 → 查库存流水),不做大而全后台。
- 登录与角色: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 并发模型、大文件流式传输、管理颗粒度)
- 单品级(SN)管理粒度的推演与三种扩展架构:想法/3. 管理颗粒度.md
- Node.js 并发模型与库存下沉数据库的实战策略:想法/1. JS与Node并发学习笔记.md
- 大文件流式传输的零拷贝切片方案:想法/2. 大文件解决方案.md