Build precise task specs, veri…

# 库存管理系统规格说明

一、项目概述

基于 Next.js 14（App Router）+ PostgreSQL 的库存管理系统，支持多仓库、多SKU的出入库管理。

二、技术架构

• 前端：Next.js 14（App Router + Server Components）
• 后端：Next.js API Routes / Server Actions
• 数据库：PostgreSQL（建议 14+ 版本）
• ORM：Prisma（推荐）或 Drizzle
• UI：Tailwind CSS + shadcn/ui（可选）

三、功能规格

1. 基础数据管理

• SKU管理：编码（唯一）、名称、分类、单位、安全库存阈值，支持500+ SKU
• 仓库管理：3个仓库的增删改查、状态管理
• 供应商/客户档案（可选）

2. 出入库管理

• 入库单：仓库、SKU、数量、批次号、供应商、经办人、时间
• 出库单：仓库、SKU、数量、领用人/客户、经办人、时间
• 单据状态流转：草稿 → 待审核 → 已确认/已驳回
• 红字冲销（负向调整）支持

3. 库存核算

• 实时库存 = 入库累计 − 出库累计，按 仓库×SKU 维度汇总
• 库存预警：低于安全库存提醒
• 乐观锁/事务保证并发下库存数据一致

4. 报表与查询

• 出入库流水查询（按时间、仓库、SKU、单号筛选）
• 库存汇总表、单据导出CSV
• 分页：单页默认20条，支持调整

5. 权限

• 角色：管理员（全部权限）、仓管员（本仓出入库）、查看者（只读）
• 基于JWT的登录认证

四、性能要求

• 常规列表查询响应时间 < 1秒（本地/内网环境）
• 库存更新操作使用数据库事务，保证原子性

五、数据库核心表设计

• sku（商品表）、warehouse（仓库表）
• stock_in_order / stock_out_order（单据主表）
• order_item（单据明细，含sku_id、数量、批次）
• inventory（仓库×SKU库存汇总表，唯一索引约束）
• users / roles（用户权限）

六、验收标准

1. 可正常录入、查询500个SKU，3个仓库数据完整

2. 出入库单据创建后，库存实时准确更新，重复提交不产生重复数据

3. 并发提交同一SKU出入库时，库存数值无错乱（可通过脚本模拟并发验证）

4. 库存不允许为负数（出库时校验并拦截）

5. 角色权限隔离有效：查看者无法执行写操作

6. 列表查询、筛选、分页、导出功能正常

7. 删除仓库时若有库存记录，应阻止或提示

七、测试环境配置

• Node.js：≥ 18.17（Next.js 14 最低要求）
• PostgreSQL：本地 Docker 部署（推荐 postgres:16 镜像），端口默认5432
• 环境变量（.env）：DATABASE_URL=postgresql://user:pass@localhost:5432/inventory
• 测试数据：脚本生成3个仓库、500个SKU、各仓库若干条出入库记录
• 测试流程：单元测试（Jest，覆盖库存计算逻辑）+ 功能手动验收 + 并发压力模拟（如用脚本并发调用API）

八、交付物

• 源代码（含README部署文档）
• 数据库迁移脚本与测试数据脚本
• 验收测试记录表