系统使用说明

电线电缆制造业质量追溯系统

1. 系统概览

本系统覆盖“原材料 → 生产 → 质检 → 仓储/物流 → 追溯/异常 → 数据分析”的全流程质量管理。所有接口均通过 /backend/index.php/api/v1/... 访问，前端位于 frontend/ 目录。

2. 环境要求与初始化

2.1 环境

• PHP ≥ 7.4（例如 XAMPP）
• MySQL ≥ 8.0
• 可选：Redis

2.2 初始化步骤

# 导入数据库
mysql -u root -p < doc/sql/quality_tracking_system.sql

# 创建/重置管理员
cd C:\xampp\htdocs\123456
C:\xampp\php\php.exe backend/test/add_default_admin.php

默认管理员账号：admin / admin123

3. 登录与权限

• 支持角色：管理员、系统管理员、生产经理、原材管理员、仓储管理员、物流管理员、质检员、操作工、客户。
• 登录成功后浏览器本地化保存 authToken、currentUser、userPermissions。
• 10 分钟无操作自动退出。
• 导航菜单与关键按钮依据权限自动显示/禁用。

4. 功能模块

4.1 登录（frontend/index.html）

输入用户名/密码请求 /auth/login，成功后跳转 frontend/admin/dashboard.html。

4.2 仪表盘

显示生产订单、局放检测、异常统计等关键指标，支持刷新与查看详情。

4.3 原材料管理

新增/查询原材料，包含钢芯、铝股、绝缘材料等专属参数，接口 /material/list、/material/add。

4.4 生产管理

创建订单、绑定原材料、查看工序详情，自动生成 19 位追溯码。

4.5 质检管理

录入局放、钢芯铝绞线、架空绝缘导线等检测数据，可扩展控制电缆/3KV 以下动力电缆。

4.6 追溯查询

根据追溯码查看原材、生产、质检、仓储、物流、异常的全链路信息。

4.7 仓储管理

记录入库/出库/调拨/盘点日志，接口 /warehouse/logs。

4.8 物流管理

维护发货/退货信息，接口 /logistics/list、/logistics/save。

4.9 异常管理

录入异常事件，跟踪处理，接口 /abnormal/report、/abnormal/list。

4.10 用户管理

查询用户、创建/禁用、重置密码，接口 /users/*。

4.11 系统设置

调整系统名称、日志级别、CORS、限流、上传限制等，保存后写入覆盖配置。

5. 配置覆盖机制

backend/config/config.php 为基础配置，前端“系统设置”保存时生成 config_override.json 并自动覆盖。若需还原可删除覆盖文件并重启服务。

6. 追溯码规则

格式：企业标识(2字母) + 产品类型(3数字) + 日期(YYYYMMDD) + 生产线(2字母/数字) + 流水号(4数字)，通过数据库锁防止并发重复。

7. 扩展建议

• 审计与回滚、配置版本管理。
• 权限管理中心、按钮级权限控制。
• 多维度报表、导出、定时推送。
• 追溯附件上传（质检报告、照片等）。
• 消息中心（站内/邮件/短信/企业微信）。
• 设备/MES 接口自动化。
• 移动端或小程序，支持扫码与现场录入。

8. 常见问题

• 无法登录：确认数据库存在账号，可运行 add_default_admin.php 重置。
• 跨域错误：在系统设置中修改 CORS 白名单。
• 权限问题：检查角色映射、刷新权限缓存、清除浏览器缓存。
• 配置未生效：确认 config_override.json 格式正确并重启服务。