生产管理系统

一个基于 Flask + 原生 JavaScript 的轻量级生产管理系统，用于管理生产流程、物料采购、发货跟踪和质量控制。

功能特性

📊 仪表盘

• 实时显示生产良品率、直通良品率
• 发货数量统计
• 不良品数量监控

📦 生产管理

• 工单管理 - 创建、跟踪生产工单
• BOM 物料清单 - 定义产品的物料组成
• 期初库存 - 管理物料初始库存
• 采购需求 - 自动计算采购需求

🚚 发货管理

• 发货记录 - 记录发货信息
• 发货查询 - 按 SN/MAC 查询发货记录
• 发货汇总 - 发货数据统计分析

📋 订单与对账

• 客户订单 - 管理客户订单信息
• 对账管理 - 订单对账功能
• 物料采购 - 采购单管理

👥 系统管理

• 用户管理 - 支持超级管理员、管理员、普通用户角色
• 通知系统 - 操作通知推送
• 操作日志 - 记录用户操作历史
• SOP 文件管理 - 上传和管理标准作业程序文件

技术栈

后端

• Flask - Python Web 框架
• SQLite - 轻量级数据库
• Redis - 缓存和实时数据存储（可选）

前端

• 原生 JavaScript - 无框架依赖
• CSS3 - 现代化 UI 样式
• 组件化架构 - 模块化的 JS 组件

项目结构

生产管理系统/
├── server/                 # 后端服务
│   ├── app.py             # Flask 应用主文件
│   ├── data.db            # SQLite 数据库
│   └── requirements.txt   # Python 依赖
├── frontend/              # 前端资源
│   ├── index.html         # 主页面
│   ├── login.html         # 登录页面
│   ├── assets/            # 静态资源（CSS、图片）
│   ├── js/
│   │   ├── app.js         # 应用入口
│   │   ├── api.js         # API 请求封装
│   │   ├── router.js      # 前端路由
│   │   └── components/    # 页面组件
│   └── sop_files/         # SOP 文件存储
├── deploy/                # 部署配置
│   ├── nginx/             # Nginx 配置
│   └── systemd/           # Systemd 服务配置
├── .env.example           # 环境变量示例
└── README.md

快速开始

环境要求

• Python 3.8+
• Redis（可选，用于缓存和实时数据）

安装步骤

1. 克隆项目

   cd 生产管理系统
   

2. 创建虚拟环境

   python3 -m venv venv
   source venv/bin/activate  # Linux/macOS
   # 或 venv\Scripts\activate  # Windows
   

3. 安装依赖

   pip install -r server/requirements.txt
   

4. 配置环境变量

   cp .env.example .env
   # 编辑 .env 文件，配置 Redis 和管理员密码
   

5. 启动服务

   cd server
   python app.py
   

6. 访问系统

   打开浏览器访问 http://localhost:5000

默认账户

• 用户名: admin
• 密码: admin123（或通过环境变量 ADMIN_PASSWORD 配置）

环境变量配置

变量名	说明	默认值
REDIS_HOST	Redis 服务器地址	127.0.0.1
REDIS_PORT	Redis 端口	6379
REDIS_DB	Redis 数据库编号	0
REDIS_PASSWORD	Redis 密码	-
ADMIN_PASSWORD	默认管理员密码	admin123
SUPERADMIN_USERNAME	超级管理员用户名	-
SUPERADMIN_PASSWORD	超级管理员密码	-
APP_SECRET	Flask Session 密钥	change-me
HOST	服务监听地址	0.0.0.0
PORT	服务监听端口	5000

生产部署

使用 Systemd

1. 复制服务配置文件：

   sudo cp deploy/systemd/production-system.service /etc/systemd/system/
   

2. 启动服务：

   sudo systemctl enable production-system
   sudo systemctl start production-system
   

使用 Nginx 反向代理

1. 复制 Nginx 配置：

   sudo cp deploy/nginx/production-system.conf /etc/nginx/sites-available/
   sudo ln -s /etc/nginx/sites-available/production-system.conf /etc/nginx/sites-enabled/
   

2. 重载 Nginx：

   sudo nginx -t
   sudo systemctl reload nginx
   

API 接口

认证

• POST /api/auth/login - 用户登录
• GET /api/auth/me - 获取当前用户信息
• POST /api/auth/logout - 用户登出
• GET /api/auth/captcha - 获取验证码

仪表盘

• GET /api/dashboard - 获取仪表盘数据

工单管理

• GET /api/work-orders - 获取工单列表
• POST /api/work-orders - 创建工单

发货管理

• GET /api/shipments - 获取发货记录
• POST /api/shipments - 创建发货记录

更多 API 详见 server/app.py。

开发说明

前端组件开发

前端采用组件化架构，每个页面对应一个 JS 组件文件：

// frontend/js/components/example.js
export function render() {
    return `<div class="page">...</div>`;
}

export function init() {
    // 初始化逻辑
}

添加新路由

在 frontend/js/router.js 中添加路由配置：

const routes = {
    '/example': () => import('./components/example.js'),
    // ...
};

许可证

MIT License