智工厂产品系统

一、行业定位
适用行业：离散型制造业（机械加工 / 电子装配 / 注塑五金零部件加工等中小型工厂）。

典型企业画像：员工 50–500 人，多车间、多机型混线生产，按订单或预测驱动的中小制造企业。这类企业普遍面临「Excel 管 BOM、纸质工单跑车间、设备坏了才知道」的痛点，需要一个轻量、可落地、能管住核心生产要素的后台系统——本项目正是面向这一场景。

技术底座：基于 RuoYi（Spring Boot + MyBatis + Vue + MySQL + Redis）二次开发，复用其用户/角色/菜单/权限/日志/定时任务等基础设施，在其上叠加「工厂管理」业务模块。

二、核心业务模块（对应项目已实现的 factory 包）
1. BOM 物料清单管理（bom / bom_item）
解决什么：定义"一个产品由哪些物料、各多少用量组成"。

BOM 主表记录产品（如 A型电机外壳 P-A-001、版本 V1.0、状态 草稿/启用/停用）；
明细表 bom_item 记录每个 BOM 下的子件用量（如 M6螺丝 ×8 个、密封圈 ×2 个、主控芯片 ×1 STM32）；
支持版本管理，新产品试制走 V0.9 草稿，量产后升 V1.0 启用。
业务价值：BOM 是生产、采购、成本的共同数据源头，统一后避免"工艺一份、采购一份、库房一份"的对账混乱。

2. 生产工单管理（work_order）
解决什么：把"要做什么、做多少、在哪台设备上、什么时候做完"管起来。

字段贴合真实车间：工单编号、产品名称、计划数量 / 实际数量、车间（冲压/注塑/装配）、生产设备、计划与实际起止时间、工单状态（待生产 / 生产中 / 已完成 / 已取消）
初始化数据中的 WO20260710002 B型控制板 计划 500、实际 200、状态"生产中"、备注"紧急插单" —— 典型的插单排

本系统是基于若依框架二次开发的工厂生产管理后台，围绕「BOM 物料清单 → 生产工单 → 设备管理」三条主线，帮助中小制造企业把生产要素从 Excel 和纸质单据搬到线上。系统自带完整的用户、权限、日志等基础能力，开箱即用。

一、BOM 物料清单管理
定义"产品由什么组成、各用多少"的工艺数据源头，是生产领料、采购、成本核算的共同依据。

BOM 主表管理：维护产品编号、产品名称、BOM 版本（如 V1.0）、状态（草稿 / 已启用 / 已停用），支持版本区分试制与量产。
物料明细维护：每个 BOM 下挂多条明细，记录物料编号、名称、用量（精度到小数 3 位）、单位（个 / kg / m）。
例：A型电机外壳 = 外壳本体×1 + M6螺丝×8 + 密封圈×2
状态管控：新产品试制走"草稿"，验证通过后"启用"，淘汰产品"停用"，历史版本保留可追溯。
操作权限：支持 BOM 的查询 / 新增 / 修改 / 删除，按角色授权。
二、生产工单管理
把"做什么、做多少、在哪做、什么时候完成"管起来，串起计划→执行→完工全流程。

工单创建：录入工单编号、产品名称、计划数量、生产车间（冲压/注塑/装配）、指定生产设备、计划起止时间。
进度跟踪：对比「计划数量」与「实际数量」，实时掌握完成进度。
状态流转：待生产 → 生产中 → 已完成 / 已取消，状态机清晰。
插单处理：备注支持标注"紧急插单"等特殊情况，灵活应对临时加单。
时间对照：计划起止时间 vs 实际起止时间，便于分析是否延期。
操作权限：工单查询 / 新增 / 修改 / 删除分级授权。
三、设备管理
车间设备的台账与状态管理，为排产提供可用产能依据。
设备台账：记录设备编号、名称、类型（冲压/注塑/装配设备）、所属车间、生产厂家、购置日期。

1. 动态数据源 + AOP 切换（DataSourceAspect / DynamicDataSource）
通过 @DataSource 注解 + AOP 切面，方法级动态切换主从/多数据源，用 ThreadLocal（DynamicDataSourceContextHolder）持有当前线程数据源 Key。工厂业务量大时可把报表/历史数据拆到从库，主库专注交易，无需改业务代码。

2. 数据权限切面（DataScopeAspect）
@DataScope 注解实现行级数据权限：根据当前用户的角色，自动在 SQL 上拼接部门过滤条件（全部 / 本部门 / 本部门及以下 / 仅本人 / 自定义）。工厂场景下，车间主任只看本车间工单、计划员看全厂，靠一行注解即可落地。

3. 操作日志全链路留痕（LogAspect + 异步落库）
@Log 注解 + AOP 自动记录操作人、时间、模块、业务类型（增删改查导入导出）、请求参数、返回结果、耗时、异常。关键设计：日志落库走 AsyncManager 异步线程池（ThreadPoolConfig），不阻塞主业务请求，保证工单/BOM 操作性能。

4. Spring Security + JWT 无状态鉴权
自定义 JwtAuthenticationTokenFilter 拦截请求，从 Token 解析用户并放入 SecurityContext；
TokenService 负责 Token 签发、刷新、续期，登录态存 Redis；
LogoutSuccessHandler 登出时清理 Redis Token，实现"踢人/强制下线"；
无状态设计便于水平扩展、对接多端（Web/扫码终端）。
5. 接口级安全防护三件套
限流 @RateLimiter：基于 Redis 的令牌桶/滑动窗口，防止工单批量查询被打爆；