一个基于 Node.js + Express + PostgreSQL 与 Vue 3 + Vite + TypeScript 的轻量级企业资源规划系统，覆盖商品、入库、出库、退货、库存与操作日志等核心业务场景。

 

一、核心功能介绍

1. 基础功能：用户认证（登录 / 会话 / 权限）、商品管理（信息 / 分类 / 规格）、库存管理（实时查询 / 汇总 / 预警）、入库管理（创建 / 扫码 / 记录查询）、出库管理（创建 / 扫码 / 记录查询）、退货管理（创建 / 审批 / 记录查询）。
2. 高级功能：序列号唯一性校验、低于成本价出库预警、扫码枪快速出入库、Excel 数据导出、完整操作日志记录。
3. 系统管理：用户增删改查与角色分配、基于 RBAC 的权限控制、系统参数配置与数据备份恢复、操作 / 异常日志查询。
4. 数据分析：库存周转率分析、商品销售趋势分析、异常出入库预警。

二、环境要求

1. 开发环境：
   • 操作系统：Windows 11 / Linux (Ubuntu 20.04+) /macOS；
   • Node.js：>= 18.0.0；
   • Docker：20.10+（PostgreSQL 容器）、Docker Compose：2.0+；
   • 内存：>= 4GB，磁盘空间：>= 10GB。
2. 生产环境：
   • 操作系统：Linux (Ubuntu 20.04+ 推荐)；
   • Node.js：>= 18.0.0、PostgreSQL：15+、Nginx：1.18+（反向代理）、PM2（最新版）；
   • 内存：>= 4GB，磁盘空间：>= 20GB。

5.5 入库管理页面

常见问题

Q1: 忘记管理员密码怎么办？
A: 方式一：登录系统后在「我的账户」中修改
方式二：执行 scripts/init-db.sql 中的管理员 INSERT 语句重置密码

Q2: 如何备份数据？
A: 使用 pg_dump 导出数据库，或参考生产环境部署指南中的备份章节

Q3: 扫码枪不工作怎么办？
A: 确保扫码枪已正确连接，输入框处于聚焦状态，尝试手动输入扫码枪内容测试

Q4: 如何更换端口？
A: 修改 .env 文件中的 PORT 配置项（后端）或 vite.config.ts 中的 server.port 配置项（前端）

Q5: 首次启动需要运行 migrate 命令吗？
A: 不需要。系统使用 SQL 脚本自动初始化，Docker 启动时会自动执行

Q6: 生产环境部署需要注意什么？
A: 请务必修改默认密码、配置 HTTPS、设置防火墙规则、定期备份数据