W

仓库管理系统

Warehouse OS

V1 MVP 已就绪
生产级工程基座

多客户库存、扫码作业与审计，现在在一个系统里。

管理员、员工和客户拥有独立工作区。库存变化通过原子事务完成，客户数据由服务端身份与查询条件严格隔离。

进入系统npm run dev
项目状态
frameworkNext.js 16
languageTypeScript strict
uiTailwind 4 + shadcn/ui
database本机 PostgreSQL
quality40 checks passed

架构原则

业务底线先于页面数量

多客户隔离
角色守卫与强制客户条件共同限制每一次数据访问。
库存事务
出入库只能经过服务层，防负库存与并发超卖。
移动扫码
先选分类和作业类型，再扫码核验产品。
全链路审计
每次库存变化都产生流水，敏感操作保留日志。

V1 交付范围

核心链路已完成

从账号与客户隔离，到原子库存事务、扫码作业、余料和标签打印，已形成可部署的 MVP。

  1. 01数据库约束、事务与审计
  2. 02登录、RBAC 与客户隔离
  3. 03客户、产品、库存与余料
  4. 04扫码作业与二维码打印
本地启动
先准备 PostgreSQL，再填写本机数据库连接配置。
cp .env.example .env.local
npm install
npm run db:migrate
npm run bootstrap:admin -- admin@example.com '安全密码' '管理员'
npm run dev

完整配置、目录职责和验证命令请查看项目 README。