npm - create-jnrs-vue - Versions diffs - 1.2.34 → 1.2.36 - Mend

create-jnrs-vue 1.2.34 → 1.2.36

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (29) hide show

package/README.md +3 -3
package/jnrs-vue/.env.development +2 -2
package/jnrs-vue/{agentic/RULES_API.md → AGENTS/README_API.md} +16 -12
package/jnrs-vue/AGENTS/README_BASE.md +11 -0
package/jnrs-vue/{agentic/RULES_COMMON.md → AGENTS/README_COMMON.md} +3 -0
package/jnrs-vue/{agentic/RULES_CRUD.md → AGENTS/README_CRUD.md} +53 -16
package/jnrs-vue/{agentic/RULES_DEPENDENCIES.md → AGENTS/README_DEPENDENCIES.md} +1 -1
package/jnrs-vue/{agentic/RULES_MENU.md → AGENTS/README_MENU.md} +12 -12
package/jnrs-vue/README.md +3 -3
package/jnrs-vue/package.json +4 -4
package/jnrs-vue/public/system/menu.json +17 -0
package/jnrs-vue/src/api/business/index.ts +69 -0
package/jnrs-vue/src/api/common/index.ts +3 -2
package/jnrs-vue/src/api/demos/project.ts +39 -4
package/jnrs-vue/src/api/system/index.ts +1 -1
package/jnrs-vue/src/components/common/ImageView.vue +19 -26
package/jnrs-vue/src/components/common/PdfView.vue +19 -26
package/jnrs-vue/src/composables/useDateRangeField.ts +26 -0
package/jnrs-vue/src/utils/file.ts +5 -4
package/jnrs-vue/src/utils/packages.ts +10 -8
package/jnrs-vue/src/views/businessPlayground/EditDialog.vue +137 -0
package/jnrs-vue/src/views/businessPlayground/index.vue +90 -0
package/jnrs-vue/src/views/demos/crud/EditDialog.vue +13 -20
package/jnrs-vue/src/views/demos/crud/index.vue +50 -7
package/jnrs-vue/src/views/demos/playground/RequestPage.vue +13 -1
package/jnrs-vue/src/views/lingshuSmart/editorPage.vue +1 -2
package/jnrs-vue/tsconfig.json +3 -3
package/package.json +1 -1
package/jnrs-vue/agentic/RULES_BASE.md +0 -8

package/README.md CHANGED Viewed

@@ -36,9 +36,9 @@ pnpm add create-jnrs-vue
 - 前置准备
   - 将业务功能原型图作为生成前端代码的参考图
   - 从 api 工具（如 ApiFox） 中导出 openapi 文档，或接入其提供的 MCP 服务
-  - 使用 AI Agent 读取并分析当前 `README.md` 文件及 `/agentic/RULES_BASE.md` 文件并作为 IDE AI Agent 的记忆
+  - 使用 AI Agent 读取并分析当前 `README.md` 文件及 `/AGENTS/README_BASE.md` 文件并作为 IDE AI Agent 的记忆
 - 预置提示词
-  - 保存记忆：`读取并分析当前 README.md 文件及 /agentic/RULES_BASE.md 文件并作为 IDE AI Agent 的记忆`
+  - 保存记忆：`读取并分析当前 README.md 文件及 /AGENTS/README_BASE.md 文件并作为 IDE AI Agent 的记忆`
   - 生成菜单：`根据提供的菜单原型图，生成菜单`
   - 生成服务文件：`根据提供的 openapi 文档或 MCP 服务，生成API 服务文件`
   - 生成增删改查页面文件：`根据提供的界面原型图，生成增删改查页面文件`
@@ -47,7 +47,7 @@ pnpm add create-jnrs-vue
 ```Text
 jnrs-vue/
-├── agentic/              # AI Agent 规则与提示词
+├── AGENTS/               # AI Agent 规则与提示词
 ├── viteMockServe/        # Mock 服务配置
 ├── public/               # 静态资源
 ├── src/                  # 源码目录

package/jnrs-vue/.env.development CHANGED Viewed

@@ -4,8 +4,8 @@ ENV = 'development'
 VITE_USE_MOCK = true
 # 后端接口基地址 - 开发环境
-# VITE_BASE_URL = '192.168.1.120:6001'
-VITE_BASE_URL = '192.168.1.50:5001'
+VITE_BASE_URL = '192.168.1.6:5001'
+# VITE_BASE_URL = '192.168.1.50:5001'
 # 应用运行主机（置空默认为 localhost）
 VITE_APP_HOST = ''

package/jnrs-vue/{agentic/RULES_API.md → AGENTS/README_API.md} RENAMED Viewed

@@ -1,49 +1,53 @@
 # API 服务文件配置规则(Service Layer)
-说明：对提供的 `open api` 进行业务模块解析，最终生成的 `API 服务文件(Service Layer)`代码示例参考 /src/api/agentic/project.ts，最终目的是作为 AI Agent 提示词，基于每个业务模块的 Service Layer 文件直接生成 views 等代码，便于 Vibe Coding。
+说明：对提供的 `openapi` 进行业务模块解析，最终生成的 `API 服务文件(Service Layer)`代码示例参考 /src/api/demos/project.ts，最终目的是作为 AI Agent 提示词，基于每个业务模块的 Service Layer 文件直接生成 views 等代码，便于 Vibe Coding。
-## apifox 中对于 open api 的导出规则
+## apifox 中对于 openapi 的导出规则
 - apifox 导出配置：
   - 数据格式：OpenAPI Spec。
   - OpenAPI Spec 版本：OpenAPI 3.1。
   - 文件格式：JSON。
-  - 包含 Apifox 扩展的 OpenAPI 字段（x-apifox-\*\*\*）：包含。
-  - 将 API 文档的目录，作为 Tags 字段导出：否。
+  - 包含 Apifox 扩展的 OpenAPI 属性（x-apifox-\*\*\*）：包含。
+  - 将 API 文档的目录，作为 Tags 属性导出：否。
 - 最终导出的文件为 `*openapi.json`。
 - 优先使用 apifox 提供的 MCP 服务。
-## \*openapi.json 文件内容详细解析规则
+## \*openapi.json 文件内容详细解析规则（以下简称 openapi 文档）
 - 基本规则
-  - 禁止对 \*openapi.json 文件进行任何修改。
-  - 严格按照提供的 open api 文档进行解析，禁止编造新的接口或字段。
-  - 所有新生成的 Service Layer 文件及目录都存放在 /src/api 目录下。
+  - 禁止对 openapi 文档进行任何修改。
+  - 除非后文中明确指出需要创造，否则禁止创造 openapi 文档中不存在的接口、类型、属性、字段、值。
+  - 所有新生成的 Service Layer 文件及目录都存放在 `/src/api` 目录下, 生成路径参考 `menu.json` 中 component 属性的路径配置。
   - 所有新创建的 api 函数均命名为 `*Api`，如：`projectListApi`、`addProductApi`。
+  - 所有创建的 api 函数、interface、enum、type 都必须包含注释信息，优先参考 openapi 文档进行注释。
 - 解析规则
   - 解析 'paths' 中 'x-apifox-folder' 的值，作为当前文件的模块名称，如：`project.ts`；如果'x-apifox-folder' 的值包含层级，则按照层级创建目录及文件，如：`product/craft.ts`、`product/process.ts`。
   - 按需生成类型，按需拆分接口逻辑，如将编辑接口拆分为新增和修改接口。
+  - 解析 'description' 的值，作为注释参考。
   - 解析 'paths' 中的 summary，作为 export 的注释信息，如：`/** 项目 - 列表 */`。
   - 解析 'paths' 中的 URL Path，作为 axiosRequest 函数的 url 参数值。
   - 解析 'paths' 中的 HTTP Method，作为 axiosRequest 函数的 method 参数值。
   - 解析 'paths' 中的 parameters，作为 axiosRequest 函数的 params 参数值。
   - 解析 'paths' 中的 requestBody，作为 axiosRequest 函数的 data 参数值；如果 content-type 为 `form-data`，则 axiosRequest 函数的 data 类型值必须使用 objectToFormData 函数包裹，如 `data: objectToFormData(data)`。
+  - 如果某项 schema 存在 `"$ref"` JSON Reference 关键字，则对 `"$ref"` 的值路径进行进一步解析，获取其指向的类型定义，作为当前属性的类型值。
+  - 如果某项 schema 存在 `enum` 关键字，则忽略 `enum` 的值，而是查找当前 schema 所在对象中 name 属性的值如 'projectType' 等，作为字典名称，并在生成服务文件时添加额外注释 “[DICT] 此属性为字典值，字典名称为：projectType，字典值为：[${enum 的值}]”。
   - 如果 views 中需要使用原始响应数据，如需要显示后端返回的 msg 信息，则需要在 axiosRequest 函数中设置属性 `returnRawResponse: true`
 - parameters 特殊处理
   - 如果查询参数包含 `pageNo` 和 `pageSize`，则查询类型必须继承 `IPagination`
 - requestBody 特殊处理
-  - 如果某个 'properties' 类型名为 '\*Id'，如 'projectId、productProcessId'，则认为该属性和 `components/select` 相关，则类型值固定为 `Record<string, unknown> | number | undefined`，如下所示：
+  - 如果某个 'properties' 类型名为 '\*Id'，如 'projectId、productProcessId'，则认为该属性和 `components/select` 相关，则类型值必须固定设置为 `Record<string, unknown> | number | undefined` 并添加额外注释：`// 适配 components/selectXXX 组件`，如下所示：
     ```ts
-    managerId?: Record<string, unknown> | number
+    managerId?: Record<string, unknown> | number // 适配 components/selectManager 组件
     ```
   - 如果某个 'properties' 的类型名同时包含 'orginAttachmentName、newAttachmentFile' 或 'orginImageNames
-    newImageFiles'，则创建一个新的类型并继承模块类型，按需额外添加 `newImageFiles` 和 `newAttachmentFile` 属性供列表使用，类型值固定为 `IAttachment[] | undefined`，如下所示：
+    newImageFiles'，则不需要创建该属性，因为在 objectToFormData 函数中会自动处理，应该创建一个新的类型并继承模块类型，然后按需额外添加 `newImageFiles` 和 `newAttachmentFile` 属性供列表使用，类型值固定为 `IAttachment[] | undefined`，如下所示：
     ```ts
     export interface ProcessedProject extends Project {
@@ -52,7 +56,7 @@
     }
     ```
-    但是在新增和修改功能中，则设置其类型值为 `[]`，如下所示：
+    但是在新增和修改功能中，则设置其属性类型值为 `[]`，如下所示：
     ```ts
     export interface AddProject {

package/jnrs-vue/AGENTS/README_BASE.md ADDED Viewed

@@ -0,0 +1,11 @@
+# 基础规则
+- 提示词关键字：
+  - `生成服务` 时，参考 [服务配置规则](./README_API.md)
+  - `生成菜单` 时，参考 [菜单配置规则](./README_MENU.md)
+  - `生成增删改查页面` 时，参考 [增删改查页面配置规则](./README_CRUD.md)
+- 严格按照 ESLint 规范进行编码，参考 [eslint config](../eslint.config.ts)
+- 代码风格按照 Prettier 规范进行编码，参考 [prettierrc config](../prettierrc.json)
+- 所有新创建的文件或目录都使用小驼峰命名，命名需简洁精炼，不同目录下但是属于同一个模块的文件命名应保持统一，如 `/src/views/productManagement.vue`、`/src/api/productManagement.ts`
+- 禁止导入未使用的变量，避免出现 `'xxx' is defined but never used` 警告

package/jnrs-vue/{agentic/RULES_COMMON.md → AGENTS/README_COMMON.md} RENAMED Viewed

@@ -4,3 +4,6 @@
   - 模块：模块是业务逻辑的集合，如：项目模块、产品模块、用户模块、系统模块...，基本是一个模块对应一个 'menu.json' 中一个菜单或目录项；一个模块对应一个 Service Layer 文件，如：`project.ts`、`product.ts`、`user.ts`、`system.ts`。
   - components/select：选择功能组件，可借助 AI Agent 通过引用 JnSelectTemplate 生成，具体使用参考 SelectProject.vue 文件，如：`SelectProject.vue`、`SelectProduct.vue`、`SelectUser.vue`，功能为“选择某模块的某项数据，获取其 id 值”，如 'SelectProject.vue' 的功能为选择项目模块的某个项目，获取项目 id 值。
   - components/common：通用功能组件，属于编程人员预置文件，不可通过 AI Agent 自动生成，如：`CardTable.vue`、`DictTag.vue`、`ImageView.vue`、`PdfView.vue`。
+- utils
+  - 具体功能见目录：`/src/utils`

package/jnrs-vue/{agentic/RULES_CRUD.md → AGENTS/README_CRUD.md} RENAMED Viewed

@@ -8,33 +8,67 @@
 | 特征文件路径                                                            | 特征描述                                                         | 特征索引 |
 | ----------------------------------------------------------------------- | ---------------------------------------------------------------- | -------- |
-| /agentic/RULES_BASE.md                                                  | 基础规则                                                         | 0        |
-| /agentic/RULES_DEPENDENCIES.md                                          | 工程外部依赖包提供的能力                                         | 1        |
-| /agentic/RULES_COMMON.md                                                | 工程内部提供的通用能力                                           | 2        |
+| /AGENTS/README_BASE.md                                                  | 基础规则                                                         | 0        |
+| /AGENTS/README_DEPENDENCIES.md                                          | 工程外部依赖包提供的能力                                         | 1        |
+| /AGENTS/README_COMMON.md                                                | 工程内部提供的通用能力                                           | 2        |
 | /src/views/demos/crud/index.vue 和 /src/views/demos/crud/EditDialog.vue | 具体的业务功能：数据列表页、新增&修改弹窗面                      | 3        |
 | /src/api/demos/project.ts                                               | API 服务文件(Service Layer)，即具体的业务功能 API 函数及类型系统 | 4        |
 ## 通用规则约束
+- 禁止对函数进行多余的包装
+- 所有 `el-form-item` 组件必须包含 `label` 和 `prop` 属性，分别对应表单中的标签和属性名。
 - 所有以 `Select*` 开头的组件，如 `SelectProject.vue`， 其文件路径均在 /src/components/select 目录下，功能为“选择某模块的某项数据，获取其 id 值”，如 `SelectProject.vue` 的功能为选择项目模块的某个项目，获取项目 id 值。
+- 所有新生成的文件及目录都存放在 `/src/views` 目录下, 生成路径严格按照 `menu.json` 中 component 属性的路径配置。
+- 如果在服务文件中某属性的注释中识别到 ‘[DICT]’ 相关注释，则使用 element-plus 组件库中的 `el-select` 组件且 `el-option` 组件需使用 getDictList 函数获取字典列表进行生成，且 getDictList 函数的 dictName 参数即为注释中的字典名称，如 'projectType'，在表单中如果该字典的属性值是必填项，则在定义时默认值为注释中的字典值的第一个值，如下方代码所示：
+```vue
+<el-form-item label="项目类型" prop="projectType">
+  <el-select v-model="form.projectType" filterable placeholder="" clearable>
+    <el-option
+      :label="item.label"
+      :value="item.value"
+      v-for="item in getDictList('projectType')"
+      :key="item.value"
+    />
+  </el-select>
+</el-form-item>
+```
 ## 详细规则约束
 index.vue 文件内容：
-| 主要组成部分描述                                                                                                   | 使用场景                                                            | 上下文权重数组 |
-| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- | -------------- |
-| template 顶层块内编写 `<span class="jn-card-title">项目管理</span>`                                                | 当前模块名称，通常在“ElCard#header“组件中配套使用，具体名称按需修改 | [0,-1,-1,1,-1] |
-| template 顶层块内使用 `JnTable` 组件                                                                               | 当前模块存在列表功能                                                | [0,1,1,1,1]    |
-| template 顶层块内使用 `JnPagination` 组件                                                                          | 当前模块存在分页功能                                                | [0,1,1,1,1]    |
-| template 顶层块内使用 `EditDialog` 组件                                                                            | 当前模块存在新增、修改功能                                          | [1,1,1,1,1]    |
-| template 顶层块内使用 `JnImportAndExport` 组件                                                                     | 当前模块存在倒入、导出功能                                          | [0,1,1,1,1]    |
-| template 顶层块内使用 `Select*` 组件                                                                               | 当前模块存在选择其他模块数据功能，通常在“查询条件“表单中配套使用    | [0,0,1,1,1]    |
-| template 顶层块内使用 `DictTag` 组件                                                                               | 当前模块存在字典标签功能                                            | [0,0,1,1,1]    |
-| template 顶层块内使用 `JnDatetime` 组件                                                                            | 当前模块存在ISO 8601 日期时间格式化功能                             | [0,1,1,1,1]    |
-| template 顶层块内使用 `ImageView` 组件                                                                             | 当前模块存在图片查看功能                                            | [0,0,1,1,1]    |
-| template 顶层块内使用 `PdfView` 组件                                                                               | 当前模块存在 PDF 文件查看功能                                       | [0,0,1,1,1]    |
-| script 顶层块内，getTable 函数体对 tableData 的特殊处理（基于 raw data 新增 newImageFiles,newAttachmentFile 属性） | 表格中要使用 `ImageView` 组件时需处理                               | [0,0,1,1,1]    |
+| 主要组成部分描述                                                                                                   | 使用场景                                                                                                             | 上下文权重数组 |
+| ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- | -------------- |
+| template 顶层块内编写 `<span class="jn-card-title">项目管理</span>`                                                | 当前模块名称，通常在“ElCard#header“组件中配套使用，具体名称按需修改                                                  | [0,-1,-1,1,-1] |
+| template 顶层块内使用 `JnTable` 组件                                                                               | 当前模块存在列表功能                                                                                                 | [0,1,1,1,1]    |
+| template 顶层块内使用 `JnPagination` 组件                                                                          | 当前模块存在分页功能                                                                                                 | [0,1,1,1,1]    |
+| template 顶层块内使用 `EditDialog` 组件                                                                            | 当前模块存在新增、修改功能                                                                                           | [1,1,1,1,1]    |
+| template 顶层块内使用 `JnImportAndExport` 组件                                                                     | 当前模块存在倒入、导出功能                                                                                           | [0,1,1,1,1]    |
+| template 顶层块内使用 `Select*` 组件                                                                               | 当前模块存在选择其他模块数据功能，通常在“查询条件“表单中配套使用                                                     | [0,0,1,1,1]    |
+| el-table 块内使用 `DictTag` 组件                                                                                   | 如果在服务文件中某属性的注释中识别到 ‘[DICT]’ 相关注释，则使用`DictTag` 组件且 dictName 属性的值即为注释中字典名称。 | [0,0,1,1,1]    |
+| template 顶层块内使用 `JnDatetime` 组件                                                                            | 当前模块存在ISO 8601 日期时间格式化功能                                                                              | [0,1,1,1,1]    |
+| template 顶层块内使用 `ImageView` 组件                                                                             | 当前模块存在图片查看功能                                                                                             | [0,0,1,1,1]    |
+| template 顶层块内使用 `PdfView` 组件                                                                               | 当前模块存在 PDF 文件查看功能                                                                                        | [0,0,1,1,1]    |
+| script 顶层块内，getTable 函数体对 tableData 的特殊处理（基于 raw data 新增 newImageFiles,newAttachmentFile 属性） | 表格中要使用 `ImageView` 组件时需处理                                                                                | [0,0,1,1,1]    |
+edit.vue 文件其他规则：
+- 对于搜索表单中时间/日期范围选择器的绑定值处理：
+  - 引入 import { useDateRangeField } from '@/composables/useDateRangeField'
+  - 定义 const dateRange = useDateRangeField(queryForm.value, 'startDate', 'endDate')
+  - 绑定控件 <el-date-picker
+          v-model="dateRange"
+          type="daterange"
+          range-separator="至"
+          start-placeholder="开始日期"
+          end-placeholder="结束日期"
+          value-format="YYYY-MM-DD"
+          size="small"
+          style="width: 300px"
+        />
+  - 使用 handleReset 函数重置表单时，需要将 dateRange.value 重置为 null
 edit.vue 文件内容：
@@ -51,3 +85,6 @@ edit.vue 文件其他规则：
 - el-form 组件内编写的 el-input 组件加 `maxlength`、`show-word-limit` 属性。
 - el-form 组件内编写的 el-input-number 组件的 '#prefix' 按需使用。
+- open 函数中 `const matched = objectMatchAssign(ruleForm.value, row)`，用于将 row 中的属性值赋值给 ruleForm.value 中的属性。
+- open 函数中会自动回填 imageDocument 和 attachmentDocument 属性，不需要手动处理。
+- submitForm 函数中 `const matched = objectMatchAssign(ruleForm.value, row)`，用于将 ruleForm.value 中的属性值赋值给 row 中的属性（深拷贝合并对象中已有的键值，排除 null、undefined 值），且 objectMatchAssign 函数中会自动处理 newAttachmentFile、newImageFiles 属性，将它们转换为数组类型，不需要手动处理。

package/jnrs-vue/{agentic/RULES_DEPENDENCIES.md → AGENTS/README_DEPENDENCIES.md} RENAMED Viewed

@@ -1,6 +1,6 @@
 # 工程外部提供的作用域依赖包的规则
-说明：使用当前工程依赖 `@jnrs` 命名空间下的包时，如：`@jnrs/shared`、`@jnrs/vue-core`、`@jnrs/lingshu-smart`，详细描述参考各自的 `README.md` 和 `AGENTIC.md` 文件。
+说明：使用当前工程依赖 `@jnrs` 命名空间下的包时，如：`@jnrs/shared`、`@jnrs/vue-core`、`@jnrs/lingshu-smart`，详细描述参考各自的 `README.md` 和 `AGENTS.md` 文件。
 ## 使用优先级

package/jnrs-vue/{agentic/RULES_MENU.md → AGENTS/README_MENU.md} RENAMED Viewed

@@ -19,13 +19,13 @@
 }
 ```
-| 字段 | 类型     | 说明                 |
+| 属性 | 类型     | 说明                 |
 | ---- | -------- | -------------------- |
 | code | `number` | 状态码，`0` 表示成功 |
 | msg  | `string` | 提示信息             |
 | data | `Array`  | 菜单数据数组         |
-**注意：** 模拟真实后端接口，遵循统一的 API 响应格式规范，`code` 为 `0` 时表示成功，`data` 字段包含实际的菜单数据。
+**注意：** 模拟真实后端接口，遵循统一的 API 响应格式规范，`code` 为 `0` 时表示成功，`data` 属性包含实际的菜单数据。
 ---
@@ -68,13 +68,13 @@
 ---
-## 📝 字段详细说明
+## 📝 属性详细说明
 ### 1. meta 对象（元信息）
 所有菜单项都必须包含 `meta` 对象，用于存储路由元信息。
-| 字段        | 类型       | 必填 | 默认值  | 说明                                                     |
+| 属性        | 类型       | 必填 | 默认值  | 说明                                                     |
 | ----------- | ---------- | ---- | ------- | -------------------------------------------------------- |
 | title       | `string`   | 是   | —       | 菜单/页面标题                                            |
 | icon        | `string`   | -    | —       | Element Plus 图标名称（如 `ChatDotRound`、`StarFilled`） |
@@ -139,7 +139,7 @@
 ### 1. 待办提醒 (todoCount)
-`todoCount` 字段用于在菜单项上显示待办事项数量的角标提醒。
+`todoCount` 属性用于在菜单项上显示待办事项数量的角标提醒。
 **使用场景：**
@@ -164,8 +164,8 @@
 ### 2. 权限控制 (permissions)
-`permissions` 字段用于细粒度的权限控制，配合系统的权限验证机制使用。
-如果没有权限控制需求，可以忽略该字段。
+`permissions` 属性用于细粒度的权限控制，配合系统的权限验证机制使用。
+如果没有权限控制需求，可以忽略该属性。
 **权限格式：** `模块:操作`，例如：
@@ -187,7 +187,7 @@
 **工作原理：**
-- 如果设置了 permissions 字段，系统会根据当前用户的权限列表进行匹配
+- 如果设置了 permissions 属性，系统会根据当前用户的权限列表进行匹配
 - 如果用户拥有至少一个列出的权限，则可以访问该菜单
 - 如果用户没有任何匹配的权限，则菜单不会显示
@@ -198,7 +198,7 @@
 ### 3. 免登录访问 (noAuth)
-`noAuth` 字段设置为 `true` 时，该路由无需登录即可访问。
+`noAuth` 属性设置为 `true` 时，该路由无需登录即可访问。
 **使用场景：**
@@ -224,7 +224,7 @@
 ### 4. 全局路由 (global)
-`global` 字段设置为 `true` 时，该路由会使用全局布局组件。
+`global` 属性设置为 `true` 时，该路由会使用全局布局组件。
 **工作原理：**
@@ -247,7 +247,7 @@
 ### 5. 重定向 (redirect)
-`redirect` 字段用于设置路由重定向，访问该路径时会自动跳转到指定路径。
+`redirect` 属性用于设置路由重定向，访问该路径时会自动跳转到指定路径。
 **使用场景：**
@@ -415,7 +415,7 @@
 ## 🔍 常用 Element Plus 图标
-以下是一些常用的图标名称，可直接用于 `meta.icon` 字段：
+以下是一些常用的图标名称，可直接用于 `meta.icon` 属性：
 | 图标名称       | 用途       |
 | -------------- | ---------- |

package/jnrs-vue/README.md CHANGED Viewed

@@ -21,9 +21,9 @@ pnpm build
 - 前置准备
   - 将业务功能原型图作为生成前端代码的参考图
   - 从 api 工具（如 ApiFox） 中导出 openapi 文档，或接入其提供的 MCP 服务
-  - 使用 AI Agent 读取并分析当前 `README.md` 文件及 `/agentic/RULES_BASE.md` 文件并作为 IDE AI Agent 的记忆
+  - 使用 AI Agent 读取并分析当前 `README.md` 文件及 `/AGENTS/README_BASE.md` 文件并作为 IDE AI Agent 的记忆
 - 预置提示词
-  - 保存记忆：`读取并分析当前 README.md 文件及 /agentic/RULES_BASE.md 文件并作为 IDE AI Agent 的记忆`
+  - 保存记忆：`读取并分析当前 README.md 文件及 /AGENTS/README_BASE.md 文件并作为 IDE AI Agent 的记忆`
   - 生成菜单：`根据提供的菜单原型图，生成菜单`
   - 生成服务文件：`根据提供的 openapi 文档或 MCP 服务，生成API 服务文件`
   - 生成增删改查页面文件：`根据提供的界面原型图，生成增删改查页面文件`
@@ -32,7 +32,7 @@ pnpm build
 ```Text
 jnrs-vue/
-├── agentic/              # AI Agent 规则与提示词
+├── AGENTS/               # AI Agent 规则与提示词
 ├── viteMockServe/        # Mock 服务配置
 ├── public/               # 静态资源
 ├── src/                  # 源码目录

package/jnrs-vue/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "jnrs-vue",
-  "version": "1.2.34",
+  "version": "1.2.36",
   "description": "JNRS 信息化管理系统",
   "author": "talia_tan",
   "private": true,
@@ -19,9 +19,9 @@
   },
   "dependencies": {
     "@element-plus/icons-vue": "^2.3.2",
-    "@jnrs/lingshu-smart": "2.2.20",
-    "@jnrs/shared": "1.1.25",
-    "@jnrs/vue-core": "1.2.18",
+    "@jnrs/lingshu-smart": "2.2.29",
+    "@jnrs/shared": "1.1.28",
+    "@jnrs/vue-core": "1.2.21",
     "@vueuse/core": "^14.1.0",
     "element-plus": "^2.13.3",
     "pinia": "^3.0.4",

package/jnrs-vue/public/system/menu.json CHANGED Viewed

@@ -29,6 +29,23 @@
         }
       ]
     },
+    {
+      "meta": {
+        "title": "业务功能测试",
+        "icon": "Operation"
+      },
+      "children": [
+        {
+          "path": "/businessPlayground",
+          "name": "businessPlayground",
+          "meta": {
+            "title": "业务功能测试",
+            "todoCount": 8
+          },
+          "component": "/businessPlayground/index"
+        }
+      ]
+    },
     {
       "meta": {
         "title": "灵枢智造系统",

package/jnrs-vue/src/api/business/index.ts ADDED Viewed

@@ -0,0 +1,69 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : business/index.ts
+ * @Date   : 2026/05/25
+ * @Desc.  : 业务功能测试模块接口文档
+ */
+import type { IBlobItem } from '@jnrs/shared'
+import type { IPagination, IPageTableData, IFile } from '@/types'
+import { axiosRequest } from '../request'
+import { objectToFormData } from '@/utils'
+export interface ProcessItem extends IFile {
+  id?: number
+  productName?: string
+  productCode?: string
+  height?: number
+  isProcessCompleteness?: boolean
+  imageDocumentId?: unknown
+  attachmentDocumentId?: unknown
+}
+export interface SaveProcessRequest {
+  /** ID 编号 */
+  id?: number
+  productName: string
+  productCode: string
+  height: number
+  orginAttachmentName?: string
+  /** 文件 */
+  newAttachmentFile: []
+  orginImageNames?: string[]
+  /** 图片 */
+  newImageFiles: []
+}
+/**
+ * 列表
+ */
+export const getProductManagementProcessListApi = (params: IPagination): Promise<IPageTableData<ProcessItem>> => {
+  return axiosRequest({
+    url: '/product/process',
+    method: 'get',
+    params
+  })
+}
+/**
+ * 新建/编辑
+ */
+export const saveProductManagementProcessApi = (data: SaveProcessRequest): Promise<void> => {
+  return axiosRequest({
+    url: '/product/process',
+    method: 'post',
+    data: objectToFormData(data)
+  })
+}
+/**
+ * 齐套检查 导出
+ */
+export const getStandardLoadKitCheckExportApi = (): Promise<IBlobItem> => {
+  return axiosRequest({
+    url: '/order/completeness-check/export',
+    method: 'get',
+    responseType: 'blob'
+  })
+}

package/jnrs-vue/src/api/common/index.ts CHANGED Viewed

@@ -1,11 +1,12 @@
 import { axiosRequest } from '../request'
+import type { IBlobItem } from '@jnrs/shared'
 /**
  * axios 方式下载文件
  * @param uniqueFileName 文件唯一名称（列表中一般是在 item.attachmentDocument/imageDocument.attachments[].uniqueFileName)
  * @returns Blob
  */
-export const FileApi = (uniqueFileName: string): Promise<Blob> => {
+export const fileDownloadApi = (uniqueFileName: string): Promise<IBlobItem> => {
   return axiosRequest({
     url: '/files/' + uniqueFileName,
     method: 'get',
@@ -18,7 +19,7 @@ export const FileApi = (uniqueFileName: string): Promise<Blob> => {
  * Fetch 方式下载文件
  */
 // import { useFetch } from '@vueuse/core'
-// export const FileApi = (uniqueFileName: string) => {
+// export const fileDownloadApi = (uniqueFileName: string) => {
 //   return useFetch(`/files/${uniqueFileName}`, {
 //     method: 'get',
 //     headers: {

package/jnrs-vue/src/api/demos/project.ts CHANGED Viewed

@@ -6,6 +6,7 @@
  * @Desc.  : 项目模块接口文档
  */
+import type { IFullResponse, IBlobItem } from '@jnrs/shared'
 import type { IDocument, IAttachment, IPagination, IPageTableData } from '@/types'
 import { axiosRequest } from '../request'
 import { objectToFormData } from '@/utils'
@@ -20,6 +21,7 @@ export interface Project {
   name: string
   description: string
   projectType: number
+  managerId: number
   managerName: string
   budget: number
   plannedStartDate: string
@@ -27,6 +29,7 @@ export interface Project {
   milestoneFinishDate: string
   progress: string
   status: number
+  enable: boolean
   /**
    * 图片
    */
@@ -82,14 +85,24 @@ export interface UpdateProject {
   newAttachmentFile: []
 }
+/**
+ * 项目 - 启用/禁用
+ */
+export interface ProjectEnable {
+  id: string
+  enable: boolean
+}
 /**
  * 项目 - 查询
  */
 export interface ProjectQuery extends IPagination {
   code?: string
   projectType?: number
-  manager?: string
+  managerName?: string
   plannedStartDate?: string
+  startDate?: string
+  endDate?: string
 }
 /**
@@ -128,7 +141,7 @@ export const updateProjectApi = (data: Project) => {
 /**
  * 项目 - 删除
  */
-export const deleteProjectApi = (id: string) => {
+export const deleteProjectApi = (id: string): Promise<IFullResponse<unknown>> => {
   return axiosRequest({
     url: `/agentic/project/delete/${id}`,
     method: 'delete',
@@ -136,6 +149,17 @@ export const deleteProjectApi = (id: string) => {
   })
 }
+/**
+ * 项目 - 启用/禁用
+ */
+export const projectEnableApi = (data: ProjectEnable) => {
+  return axiosRequest({
+    url: '/agentic/project/enable',
+    method: 'put',
+    data
+  })
+}
 /**
  * 项目 - 列表数据
  */
@@ -171,11 +195,12 @@ export const importProjectApi = (data: FormData) => {
 /**
  * 项目数据导出
  */
-export const exportProjectApi = (data: Record<string, unknown>): Promise<Blob> => {
+export const exportProjectApi = (data: Record<string, unknown>): Promise<IBlobItem> => {
   return axiosRequest({
     url: '/agentic/project/export',
     method: 'post',
-    data
+    data,
+    responseType: 'blob'
   })
 }
@@ -210,3 +235,13 @@ export const NoAuthApi = (showErrorMsg: boolean) => {
     showErrorMsg // 是否显示错误信息，默认为 true
   })
 }
+/**
+ * 测试 请求错误
+ */
+export const FailApi = () => {
+  return axiosRequest({
+    url: '/auth/fail',
+    method: 'post'
+  })
+}

package/jnrs-vue/src/api/system/index.ts CHANGED Viewed

@@ -32,7 +32,7 @@ export const LoginApi = (data: LoginParams): Promise<LoginResult> => {
   return axiosRequest({
     url: '/auth/login',
     method: 'post',
-    data,
+    data: objectToFormData(data),
     noAuth: true
   })
 }