8.9 KiB
8.9 KiB
根目录 > nflg-qms-admin
nflg-qms-admin - QMS 质量管理后台
模块职责
QMS（质量管理系统）管理后台服务，是一个功能丰富的独立业务服务，覆盖：
- 来料检验 -- 来料检验任务管理、AQL 抽样规则、不合格处理
- 检验标准 -- 检验项目、检验标准、检验标准项目管理
- 抽样计划 -- 抽样方案管理
- 质量通知 -- 质量通知单管理
- 问题工单 -- 问题工单(Issue Ticket)、工单流程、整改措施、待办事项
- COA 证书 -- COA 审核任务管理
- PDI 整车检测 -- 整车检测任务记录、检测规则、检测结果、交付项、组件、状态项
- 免检管理 -- 免检物料、免检类别
- 质检物料 -- 质检物料分类、质检物料管理
- 质量检验员 -- 质量检验员管理
- 供应商 SQE -- 供应商 SQE 管理
- 标准缺陷 -- 标准缺陷管理
- 质量报表 -- 质量报表
- 文件管理 -- QMS 文件管理（文件分类/文件/版本/成员/OnlyOffice 集成）
- 广告管理 -- 广告管理
- PDF 尺寸提取 -- 集成 nflg-qms-pdf-extract，从工程图纸提取尺寸数据
- 外部接口 -- 为 WMS 等系统提供来料检验回调、PDI 任务记录、物料查询等外部接口
- 消息通知 -- 邮件/RTX/待办事项三种消息渠道
入口与启动
| 项 | 值 |
|---|---|
| 入口类 | com.nflg.qms.admin.QmsApplication |
| 端口 | 8105 |
| 服务名 | qms-local |
| ComponentScan | com.nflg.qms.admin, com.nflg.wms.starter, com.nflg.wms.repository |
关键依赖
- nflg-wms-common
- nflg-wms-starter
- nflg-qms-pdf-extract (PDF 数据提取)
- Spring Boot Web / AOP / Validation / Mail / Thymeleaf / LDAP / MongoDB
- ZXing (二维码)
- EasyExcel (Excel 处理)
- iText7 / Flying Saucer PDF (PDF 生成)
- PowerJob Client (任务调度)
- Redisson (分布式锁)
- OpenTelemetry (链路追踪)
- Hypersistence TSID (ID 生成)
- MinIO 8.5.17 (对象存储)
- AWS S3 SDK 2.39.5 (对象存储)
- JJWT 0.12.6 (OnlyOffice JWT 签名)
- Apache Commons IO / Lang3
- TinyPinyin (拼音转换)
- Spring Retry
对外接口 (Controller)
业务 Controller (34 个)
| Controller | 路由前缀 | 说明 |
|---|---|---|
QmsIncomingInspectionTaskController |
/incoming-inspection-task |
来料检验任务 |
QmsIncomingInspectionTaskAqlRuleController |
/incoming-inspection-task-aql-rule |
来料检验 AQL 抽样规则 |
QmsIncomingInspectionTaskNonconformanceController |
/incoming-inspection-task-nonconformance |
来料检验不合格处理 |
QmsInspectionItemController |
/inspectionItem |
检验项目管理 |
QmsInspectionStandardController |
/inspection-standard |
检验标准管理 |
QmsInspectionStandardItemController |
/inspection-standard-item |
检验标准项目 |
QmsSamplingPlanController |
/sampling-plan |
抽样计划 |
QualityNotificationController |
/quality-notification |
质量通知 |
QmsIssueTicketController |
/issueTicket |
问题工单 |
QmsIssueTicketProcessController |
/issueTicketProcess |
工单流程 |
QmsIssueTicketProcessMeasureController |
/issueTicketProcessMeasure |
工单整改措施 |
QmsIssueTicketTodoController |
/ticket-todo-item |
工单待办事项 |
QmsCoaTaskController |
/coaTask |
COA 证书任务 |
QmsCoaReviewController |
/coaReview |
COA 审核 |
QmsPdiTaskRecordController |
/pdiTaskRecord |
PDI 检测任务记录 |
QmsPdiComponentController |
/pdiComponent |
PDI 组件 |
QmsPdiDeliveryItemController |
/pdiDeliveryItem |
PDI 交付项 |
QmsPdiDetectionRulesController |
/pdiDetectionRules |
PDI 检测规则 |
QmsPdiInspectionResultsController |
/pdiInspectionResults |
PDI 检测结果 |
QmsPdiStatusItemController |
/pdiStatusItem |
PDI 状态项 |
QmsExemptCategoryController |
/exemptCategory |
免检类别 |
QmsExemptMaterialController |
/exemptMaterial |
免检物料 |
QmsQcMaterialCategoryController |
/qcMaterialCategory |
质检物料分类 |
QmsQcMaterialController |
/qcMaterial |
质检物料 |
QmsQualityInspectorController |
/qualityInspector |
质量检验员 |
QmsSupplierSqeController |
/supplierSqe |
供应商 SQE |
QmsStandardDefectController |
/standardDefect |
标准缺陷 |
QmsReportController |
/report |
质量报表 |
QmsFileCategoryController |
/fileCategory |
文件分类 |
QmsFileController |
/file |
文件管理 |
QmsFileMemberController |
/fileMember |
文件成员 |
FileUpLoadController |
/fileUpload |
文件上传 |
AdvertisementController |
/ad |
广告管理 |
TestController |
/test |
测试接口 |
外部接口 Controller (3 个)
| Controller | 路由前缀 | 说明 |
|---|---|---|
ExternalIncomingInspectionTaskController |
/external/incoming-inspection-task |
外部来料检验任务接口（供 WMS 回调） |
ExternalPdiTaskRecordController |
/external/pdi-task-record |
外部 PDI 任务记录接口 |
MaterialController |
/external/material |
外部物料查询接口 |
关键业务 Service
| Service | 说明 |
|---|---|
IncomingInspectionTaskControllerService |
来料检验任务业务逻辑 |
QmsInspectionStandardControllerService |
检验标准业务逻辑 |
QmsInspectionStandardItemControllerService |
检验标准项目业务逻辑 |
QmsSamplingPlanControllerService |
抽样计划业务逻辑 |
QualityNotificationControllerService |
质量通知业务逻辑 |
QmsIssueTicketControllerService |
问题工单业务逻辑 |
QmsIssueTicketProcessControllerService |
工单流程业务逻辑 |
QmsIssueTicketProcessMeasureControllerService |
工单整改措施业务逻辑 |
QmsIssueTicketTodoControllerService |
工单待办事项业务逻辑 |
QmsPdiTaskRecordControllerService |
PDI 任务记录业务逻辑 |
QmsPdiComponentControllerService |
PDI 组件业务逻辑 |
QmsPdiDeliveryItemControllerService |
PDI 交付项业务逻辑 |
QmsPdiDetectionRulesControllerService |
PDI 检测规则业务逻辑 |
QmsPdiInspectionResultsControllerService |
PDI 检测结果业务逻辑 |
QmsPdiStatusItemControllerService |
PDI 状态项业务逻辑 |
QmsFileCategoryControllerService |
文件分类业务逻辑 |
QmsFileControllerService |
文件管理业务逻辑 |
QmsFileMemberControllerService |
文件成员业务逻辑 |
FileControllerService |
文件上传业务逻辑 |
QmsQcMaterialControllerService |
质检物料业务逻辑 |
QmsStandardDefectControllerService |
标准缺陷业务逻辑 |
QmsReportControllerService |
质量报表业务逻辑 |
ExternalPdiTaskRecordControllerService |
外部 PDI 任务业务逻辑 |
WmsApiService |
WMS 系统 API 调用服务 |
WmsIncomingInspectionTaskCallbackService |
WMS 来料检验回调服务 |
BasdeSerialNumberControllerService |
流水号生成 |
ISendMessageService |
消息发送接口 |
EmailMessageImpl |
邮件消息实现 |
RtxMessageImpl |
RTX 消息实现 |
TodoItemMessageImpl |
待办事项消息实现 |
RtxSendService |
RTX 发送服务 |
事件驱动
| 类 | 说明 |
|---|---|
IncomingInspectionTaskFinishEvent |
来料检验完成事件 |
TicketEventPublisher |
工单事件发布器 |
TicketEventListener |
工单事件监听器 |
配置
| 类 | 说明 |
|---|---|
PdfExtractConfig |
PDF 提取服务 Bean 配置（注册 PdfExtractionService/TextGrouper/DimensionIdentifier/RegionFilterService） |
AsyncConfig |
异步线程池配置：ticketTaskExecutor(5-10)、wmsCallbackExecutor(5-20) |
测试
DeploySitTest.java- SIT 环境部署测试
相关文件清单
src/main/java/com/nflg/qms/admin/controller/- 34 个 Controllersrc/main/java/com/nflg/qms/admin/controller/external/- 3 个外部接口 Controllersrc/main/java/com/nflg/qms/admin/service/- 约 31 个 Servicesrc/main/java/com/nflg/qms/admin/service/impl/- 消息发送实现src/main/java/com/nflg/qms/admin/config/- 配置类src/main/java/com/nflg/qms/admin/event/- 事件定义src/main/java/com/nflg/qms/admin/listener/- 事件监听器src/main/java/com/nflg/qms/admin/publisher/- 事件发布器src/main/java/com/nflg/qms/admin/pojo/- QO/VO 对象src/main/java/com/nflg/qms/admin/util/- 工具类src/main/resources/application*.yml- 配置文件pom.xml- 模块依赖定义
变更记录 (Changelog)
| 时间 | 操作 | 说明 |
|---|---|---|
| 2026-05-23 14:28:57 | 重写 | 首次扫描严重低估模块规模（记录 3 文件，实际约 80 文件），本次全面重写：补充全部 37 个 Controller、31 个 Service、事件驱动架构、MinIO/OnlyOffice/PDF 提取等依赖，修正入口类名 |
| 2026-05-23 14:16:58 | 初始化 | 首次生成模块文档（内容不完整） |