292 lines
10 KiB
Markdown
292 lines
10 KiB
Markdown
# JY1.0 功能矩阵与知识库覆盖清单
|
||
|
||
## 1. 用途
|
||
|
||
本文档用于作为 MCP 服务和 AI 助手知识库的覆盖清单。后续建设知识库、页面索引、API 索引和功能问答时，应以本清单为基础逐项补齐页面说明、后端过程、字段和常见问题。
|
||
|
||
## 2. 总体功能矩阵
|
||
|
||
| 模块目录 | 中文模块 | 页面数量约计 | 核心功能 | MCP/知识库覆盖点 |
|
||
| --- | --- | ---: | --- | --- |
|
||
| `SalesManagement` | 销售管理 | 37 | 客户、产品、报价、合同、订单、发货、售后、统计分析 | 合同/订单/发货流程、后端 `name`、订单字段、统计图表 |
|
||
| `BasicData` | 基础数据 | 14 | 菜单、角色、权限、人员、班次、日历、物料、工艺、设备能力 | 权限配置、菜单路由、基础字典、工艺维护 |
|
||
| `TechnologyCenter` | 技术中心 | 12 | BOM、物料、图纸、图纸确认、导入 | BOM 字段、图纸上传下载、导入模板 |
|
||
| `SeikoWorkshop` | 精工车间 | 26 | 工艺制定、计划、派工、执行、质检、工时、追溯、工况 | 工艺流程、派工执行链路、零件追溯、质检字段 |
|
||
| `AssemblyManagement` | 装配管理 | 11 | 装配任务、接收任务、执行、领料、补货、滑台/专机 | 装配开始/暂停/恢复/完成、领料、调试、自检 |
|
||
| `PurchasingManagement` | 采购管理 | 8 | 供应商、到货通知、采购订单、外协订单、采购查询 | 采购订单字段、到货状态、供应商筛选 |
|
||
| `WarehouseManagement` | 仓储管理 | 27 | 入库、出库、库存、盘点、调拨、库位、补货、可视化 | 入库/出库流程、库存字段、批量操作、条码打印 |
|
||
| `DeviceManagement` | 设备管理 | 13 | 设备状态、监控、点检、维修、能耗、灯控、异常原因 | 设备状态字段、实时/历史数据、点检维修流程 |
|
||
| `ManufacturingCenter` | 制造中心 | 1 | 制造中心扩展页面 | 页面调用和业务说明 |
|
||
| `WarehouseVisualization` | 仓库可视化 | 1 | 仓储布局和可视化展示 | 可视化数据来源、布局资源 |
|
||
| `dashboard` | 首页 | 1 | 首页信息、统计、入口 | 首页卡片、统计接口 |
|
||
| `login` | 登录 | 1 | 登录、改密、获取角色菜单 | 登录接口、Cookie、动态路由 |
|
||
| `layout` | 系统框架 | 8 | 顶栏、侧边栏、标签页、主内容区 | 导航结构、权限菜单、路由缓存 |
|
||
|
||
## 3. 销售管理覆盖清单
|
||
|
||
目录：`src/views/SalesManagement`
|
||
|
||
应覆盖页面能力：
|
||
|
||
- 客户管理：客户资料维护、查询、编辑。
|
||
- 公司信息维护：公司基础资料。
|
||
- 产品维护：产品基础资料。
|
||
- 创建报价：报价单创建和维护。
|
||
- 销售合同、机床合同、新版合同、售后合同。
|
||
- 合同查询、新版合同查询、合同审核。
|
||
- 订单管理、订单下发、订单查询、订单审核。
|
||
- 订单进度、订单进度总览、订单追溯。
|
||
- 物料追溯。
|
||
- 发货通知、发货通知查询、发货记录、发货审核、产品发货。
|
||
- 售后和售后查询。
|
||
- 统计分析：区域销售、订单趋势、产品类别、产品占比、产品定价、设备利用率、工时统计。
|
||
|
||
知识库重点：
|
||
|
||
- 合同编号、订单号、客户名称、产品名称、发货状态等中文字段。
|
||
- 合同到订单、订单到生产、订单到发货的业务链路。
|
||
- 销售统计图表的数据口径。
|
||
- 新旧合同页面差异。
|
||
|
||
## 4. 基础数据覆盖清单
|
||
|
||
目录：`src/views/BasicData`、`src/api/BasicData`
|
||
|
||
应覆盖页面能力：
|
||
|
||
- 菜单管理：角色模块分配、菜单上下移动、一级/二级菜单维护。
|
||
- 系统角色维护。
|
||
- 用户权限管理。
|
||
- 人员管理、车间人员角色管理。
|
||
- 班次管理、工厂日历。
|
||
- 物料维护。
|
||
- 零件编号维护。
|
||
- 车间工艺分类、工艺名称、工艺要求维护。
|
||
- 设备能力设置、设备人员维护。
|
||
- 项目管理显示。
|
||
|
||
知识库重点：
|
||
|
||
- 动态菜单字段：`id`、`pid`、`path`、`component`、`redirect`、`name`、`title`、`icon`。
|
||
- 权限配置影响路由和侧边栏。
|
||
- 基础字典如何被其他模块作为下拉数据使用。
|
||
- 工艺基础数据与精工车间工艺制定的关系。
|
||
|
||
## 5. 技术中心覆盖清单
|
||
|
||
目录：`src/views/TechnologyCenter`
|
||
|
||
应覆盖页面能力：
|
||
|
||
- BOM 基础数据。
|
||
- BOM 维护、查询、库存查询。
|
||
- BOM 导入。
|
||
- 物料维护、物料查询。
|
||
- 零件图导入。
|
||
- 图纸确认、图纸确认分发、图纸确认查询。
|
||
|
||
知识库重点：
|
||
|
||
- BOM 层级、物料编码、图号、零件名称。
|
||
- Excel 导入流程和校验。
|
||
- 图纸上传下载接口。
|
||
- 技术资料与生产/装配页面的关联。
|
||
|
||
## 6. 精工车间覆盖清单
|
||
|
||
目录：`src/views/SeikoWorkshop`
|
||
|
||
应覆盖页面能力：
|
||
|
||
- 制定工艺、工艺文档管理、工序查询。
|
||
- 生产计划、生产任务查询。
|
||
- 车间派工、生产执行、在加工零件。
|
||
- 零件追溯。
|
||
- 工时统计、订单工时、其他工作完成。
|
||
- 工况、设备监控。
|
||
- 物料审核、采购合同审核。
|
||
- 质量维护、自检记录、质检信息查询、采购质检、其他质检。
|
||
- 报废投产、测试数据录入。
|
||
- Andon 异常提示。
|
||
|
||
知识库重点：
|
||
|
||
- 工艺制定到派工到执行的完整链路。
|
||
- 工序、设备、人员、工时字段。
|
||
- 零件追溯查询条件和结果字段。
|
||
- 质检、报废、返工相关状态。
|
||
|
||
## 7. 装配管理覆盖清单
|
||
|
||
目录：`src/views/AssemblyManagement`
|
||
|
||
应覆盖页面能力：
|
||
|
||
- 装配任务查询、接收任务。
|
||
- 装配执行、专机装配执行、滑台装配执行。
|
||
- 装配领料、临时领料。
|
||
- 补货单、滑台补货单。
|
||
- 开始装配、完成装配、自检、暂停、恢复、打回。
|
||
- 调试数据、滑台调试数据、产品详细参数维护。
|
||
|
||
知识库重点：
|
||
|
||
- `装配执行_开始装配`、`装配执行_完成装配`、`装配管理_暂停装配`、`装配管理_恢复装配` 等后端过程。
|
||
- 领料单、三表查询、产品参数、调试记录。
|
||
- 装配任务状态流转。
|
||
- 装配页面涉及的图纸/PDF/客户资料查看。
|
||
|
||
## 8. 采购管理覆盖清单
|
||
|
||
目录：`src/views/PurchasingManagement`
|
||
|
||
应覆盖页面能力：
|
||
|
||
- 供应商管理。
|
||
- 到货通知。
|
||
- 采购订单、外协采购订单。
|
||
- 订单查询、外协订单查询。
|
||
- 外购件查询、外协件查询。
|
||
|
||
知识库重点：
|
||
|
||
- 供应商、采购合同、采购订单、到货数量、到货状态。
|
||
- 采购到仓储入库的衔接。
|
||
- 外协订单和普通采购订单差异。
|
||
|
||
## 9. 仓储管理覆盖清单
|
||
|
||
目录：`src/views/WarehouseManagement`
|
||
|
||
应覆盖页面能力：
|
||
|
||
- 采购件入库、自制件入库、外协到货/外协入库。
|
||
- 入库扫描、入库记录、采购入库记录、外协记录、主轴库存记录。
|
||
- 出库、出库明细、采购出库记录。
|
||
- 领料单查询、物料领用、退料记录。
|
||
- 库存查询、库存记录、库存汇总、库存盘点。
|
||
- 调拨查询、外协调拨。
|
||
- 补货、补货查询、新补货查询。
|
||
- 库位管理、物料库位、模具管理。
|
||
- 外协厂维护。
|
||
- 仓库可视化。
|
||
|
||
知识库重点：
|
||
|
||
- 入库批量选择、数量校验、库位校验、条码打印。
|
||
- 库存字段：物料名称、图号/型号、库存、库位、批次、单位。
|
||
- 采购件、自制件、外协件的入库差异。
|
||
- 出库、领料、调拨、盘点对库存的影响。
|
||
|
||
## 10. 设备管理覆盖清单
|
||
|
||
目录：`src/views/DeviceManagement`
|
||
|
||
应覆盖页面能力：
|
||
|
||
- 设备状态、设备状态监控。
|
||
- 设备信息。
|
||
- 实时信息、历史信息、当前监控。
|
||
- 设备点检、点检记录。
|
||
- 维修记录。
|
||
- 设备能耗。
|
||
- 灯控。
|
||
- 不合格原因。
|
||
|
||
知识库重点：
|
||
|
||
- 设备编号、设备名称、状态、报警、点检、维修、能耗字段。
|
||
- 实时监控和历史查询的数据差异。
|
||
- 设备状态与车间生产执行的关联。
|
||
|
||
## 11. 系统框架覆盖清单
|
||
|
||
目录：`src/views/layout`、`src/router`、`src/store`
|
||
|
||
应覆盖能力：
|
||
|
||
- 登录后权限获取。
|
||
- 动态路由注入。
|
||
- 侧边栏渲染。
|
||
- 顶栏用户操作。
|
||
- 标签页缓存。
|
||
- 404 和重定向。
|
||
|
||
知识库重点：
|
||
|
||
- `constantRouterMap` 与动态路由的边界。
|
||
- `getRouter.js` 根据 `pid` 递归生成树。
|
||
- `tagsView`、`permission`、`user` Vuex 模块职责。
|
||
- Cookie 过期导致强制登出的处理。
|
||
|
||
## 12. 请求与后端过程覆盖清单
|
||
|
||
知识库和 MCP 必须覆盖以下请求类型：
|
||
|
||
| 类型 | 说明 | 覆盖要求 |
|
||
| --- | --- | --- |
|
||
| `type=1` | 查询 | 提取 name、param、分页、返回 rows/total |
|
||
| `type=2` | 增删改 | 默认只做说明，不直接执行 |
|
||
| `type=7` | 批量提交 | 提取批量字段和数组结构 |
|
||
| `type=11` | 项目扩展查询 | 作为查询类处理 |
|
||
| `type=12` | 项目扩展写操作 | 作为写操作说明，MCP 默认禁止执行 |
|
||
| `type=3` | SQL/菜单类查询 | 高风险，知识库可说明，工具不得开放任意 SQL |
|
||
| `type=2001` | 报表/特殊查询 | 记录来源和页面 |
|
||
|
||
## 13. AI 助手问题覆盖样例
|
||
|
||
项目类：
|
||
|
||
- JY1.0 使用什么技术栈？
|
||
- 新增页面应该放在哪里？
|
||
- 为什么不能用 Vue 3 写法？
|
||
- 请求为什么 url 为空？
|
||
|
||
功能类：
|
||
|
||
- 仓储管理有哪些功能？
|
||
- 采购件入库页面的流程是什么？
|
||
- 装配执行有哪些状态流转？
|
||
- 零件追溯在哪些页面用到？
|
||
|
||
代码类：
|
||
|
||
- 查找所有调用 `CreateData('12'...)` 的地方。
|
||
- 查询字段 `订单号` 被哪些页面使用。
|
||
- 找到 `装配执行_完成装配` 的调用点。
|
||
- 分析指定 Vue 文件的表格列。
|
||
|
||
排障类：
|
||
|
||
- 登录后跳回登录页是什么原因？
|
||
- 新增菜单后页面打不开如何排查？
|
||
- 接口有返回但表格不显示如何排查？
|
||
- 入库成功但库存没变化如何排查？
|
||
|
||
开发类：
|
||
|
||
- 生成一个符合项目规范的查询页面。
|
||
- 给某个页面增加导出按钮。
|
||
- 给表格增加状态标签。
|
||
- 检查新页面是否符合 AGENTS.md 规则。
|
||
|
||
## 14. 后续补全计划
|
||
|
||
第一轮补全：
|
||
|
||
- 自动生成所有页面路径清单。
|
||
- 自动生成所有 `CreateData` 后端 `name` 清单。
|
||
- 自动生成所有表格中文字段清单。
|
||
|
||
第二轮补全：
|
||
|
||
- 人工补充每个后端过程的真实业务含义。
|
||
- 人工补充关键页面操作流程。
|
||
- 人工补充常见报错和解决方案。
|
||
|
||
第三轮补全：
|
||
|
||
- 接入只读业务查询。
|
||
- 将高频问答沉淀为 FAQ。
|
||
- 每次发布后增量更新知识库。
|