create-jnrs-vue 1.2.25 → 1.2.27

package/jnrs-vue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jnrs-vue",
-  "version": "1.2.25",
+  "version": "1.2.27",
   "description": "JNRS 信息化管理系统",
   "author": "talia_tan",
   "private": true,
@@ -19,9 +19,9 @@
   },
   "dependencies": {
     "@element-plus/icons-vue": "^2.3.2",
-    "@jnrs/lingshu-smart": "2.2.6",
-    "@jnrs/shared": "1.1.18",
-    "@jnrs/vue-core": "1.2.13",
+    "@jnrs/lingshu-smart": "2.2.7",
+    "@jnrs/shared": "1.1.23",
+    "@jnrs/vue-core": "1.2.15",
     "@vueuse/core": "^14.1.0",
     "element-plus": "^2.13.3",
     "pinia": "^3.0.4",

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

@@ -27,6 +27,15 @@
           },
           "component": "/demos/simpleTable/index"
         },
+        {
+          "path": "/compositionTable",
+          "name": "compositionTable",
+          "meta": {
+            "title": "简单数据表格 - 组合式",
+            "todoCount": 0
+          },
+          "component": "/demos/compositionTable/index"
+        },
         {
           "path": "/crud",
           "name": "Crud",
@@ -36,6 +45,15 @@
           },
           "component": "/demos/crud/index"
         },
+        {
+          "path": "/compositionCrud",
+          "name": "compositionCrud",
+          "meta": {
+            "title": "完整增删改查 - 组合式",
+            "todoCount": 0
+          },
+          "component": "/demos/compositionCrud/index"
+        },
         {
           "path": "/testRedirect",
           "name": "TestRedirect",

package/jnrs-vue/src/api/demos/ai_agent_context.ts

@@ -0,0 +1,159 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : project/ai_agent_context.ts
+ * @Date   : 2026/03/01
+ * @Desc.  : 示例模块接口文档（对于标准业务功能可作为 AI Agent 上下文）
+ */
+
+import type {
+  // 列表数据及数据总数
+  IPageTableData,
+  // 分页
+  IPagination,
+  // 附件
+  IFile
+} from '@/types'
+import {
+  // axios 请求方法泛型拓展封装
+  axiosRequest
+} from '../request'
+import {
+  // 将对象转为 FormData
+  objectToFormData
+} from '@/utils'
+
+export interface Project extends IFile {
+  id: string
+  programCode: string
+  program: string
+  code: string
+  name: string
+  description: string
+  projectType?: '敏捷型' | '瀑布型' | '混合型'
+  manager: string
+  budget: number
+  plannedStartDate: string
+  plannedFinishDate: string
+  progress: string
+  status: '进行中' | '已完成' | '未开始' | '已暂停'
+}
+
+type ProjectReadOnly =
+  | 'programCode'
+  | 'program'
+  | 'code'
+  | 'manager'
+  | 'plannedFinishDate'
+  | 'progress'
+  | 'status'
+  | 'imageDocument'
+  | 'attachmentDocument'
+
+export type EditProject = Omit<Project, ProjectReadOnly> & {
+  newAttachmentFile: []
+  newImageFiles: []
+}
+
+export interface ProjectQuery extends IPagination {
+  code?: string
+  projectType?: '敏捷型' | '瀑布型' | '混合型'
+  manager?: string
+}
+
+/**
+ * 项目 - 列表数据
+ */
+export const ProjectListApi = (params?: ProjectQuery): Promise<IPageTableData<Project>> => {
+  return axiosRequest({
+    url: '/project/table',
+    method: 'get',
+    params
+  })
+}
+
+/**
+ * 项目 - 详情数据
+ */
+export const DataApiTest = (params: { id: string }): Promise<Project> => {
+  return axiosRequest({
+    url: '/project/info',
+    method: 'get',
+    params
+  })
+}
+
+/**
+ * 项目 - 新增
+ */
+export const CreateProjectApi = (data: Omit<Project, 'id'>) => {
+  return axiosRequest({
+    url: '/project/save',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 项目 - 编辑
+ */
+export const EditProjectApi = (data: EditProject) => {
+  return axiosRequest({
+    url: '/project/save',
+    method: 'post',
+    data: objectToFormData(data) // 请求体如果为 formData 类型，使用 objectToFormData 方法转换
+  })
+}
+
+/**
+ * 项目 - 更新
+ */
+export const UpdateProjectApi = (data: Project) => {
+  return axiosRequest({
+    url: '/project/update',
+    method: 'put',
+    data
+  })
+}
+
+/**
+ * 项目 - 删除
+ */
+export const DeleteProjectApi = (id: string) => {
+  return axiosRequest({
+    url: `/project/delete/${id}`,
+    method: 'delete'
+  })
+}
+
+/**
+ * 项目 - 导入
+ */
+export const ImportDataApi = (data: FormData) => {
+  return axiosRequest({
+    url: '/project/import',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 项目 - 导出
+ */
+export const ExportApi = (data: Record<string, unknown>): Promise<Blob> => {
+  return axiosRequest({
+    url: '/project/export',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 项目 - 文件下载
+ */
+export const DownloadFileApi = (): Promise<Blob> => {
+  return axiosRequest({
+    url: '/project/files',
+    method: 'post'
+  })
+}

package/jnrs-vue/src/api/demos/index.ts

@@ -3,10 +3,10 @@
  * @WeChat : Tan578853789
  * @File   : demos/index.ts
  * @Date   : 2026/03/01
- * @Desc.  : 示例模块接口文档（可作为 AI Agent 上下文来源）
+ * @Desc.  : 示例模块接口文档（非标业务功能人工编码参考）
  */
 
-import type { IBusinessResponse } from '@jnrs/shared'
+import type { IFullResponse } from '@jnrs/shared'
 import type { IPagination, IPageTableData, IFile, IUser } from '@/types'
 import { axiosRequest } from '../request'
 import { objectToFormData } from '@/utils'
@@ -15,7 +15,7 @@ import { objectToFormData } from '@/utils'
  * 项目 - 详情
  */
 export interface Project extends IFile {
-  id: string
+  id: number
   programCode: string
   program: string
   code: string
@@ -31,10 +31,9 @@ export interface Project extends IFile {
 }
 
 /**
- * 新增项目 - 忽略字段
+ * 创建时不能修改的属性
  */
-type CreateProjectOmit =
-  | 'id'
+type ProjectReadOnly =
   | 'programCode'
   | 'program'
   | 'code'
@@ -48,8 +47,7 @@ type CreateProjectOmit =
 /**
  * 项目 - 创建
  */
-export type EditProject = Omit<Project, CreateProjectOmit> & {
-  id?: string
+export type EditProject = Omit<Project, ProjectReadOnly> & {
   managerId?: Record<string, unknown> | number
   newAttachmentFile: []
   newImageFiles: []
@@ -62,27 +60,24 @@ export interface ProjectQuery extends IPagination {
   code?: string
   projectType?: '敏捷型' | '瀑布型' | '混合型'
   manager?: string
+  plannedStartDate?: string
 }
 
 // 测试 获取数据
-export const DataApiTest = (id: string): Promise<IUser> => {
+export const DataApiTest = (params: { id: string }): Promise<IUser> => {
   return axiosRequest({
     url: '/auth/user-info',
     method: 'get',
-    params: {
-      id
-    }
+    params
   })
 }
 
 // 测试 获取全量数据
-export const FullDataApiTest = (id: string): Promise<IBusinessResponse<IUser>> => {
+export const FullDataApiTest = (params: { id: string }): Promise<IFullResponse<IUser>> => {
   return axiosRequest({
     url: '/auth/user-info',
     method: 'get',
-    params: {
-      id
-    },
+    params,
     returnFullResponse: true // 需要返回完整响应数据时使用该选项
   })
 }
@@ -104,19 +99,18 @@ export const NoNeedAuthApi = () => {
   return axiosRequest({
     url: '/auth/no',
     method: 'post',
-    noAuth: true
+    noAuth: true // 是否需要权限，默认为 false
   })
 }
 
 /**
  * 测试 无权限
- * @param showErrorMsg 是否显示错误信息
  */
 export const NoAuthApi = (showErrorMsg: boolean) => {
   return axiosRequest({
     url: '/auth/no',
     method: 'post',
-    showErrorMsg
+    showErrorMsg // 是否显示错误信息，默认为 true
   })
 }
 
@@ -137,7 +131,7 @@ export const EditProjectApi = (data: EditProject) => {
   return axiosRequest({
     url: '/demos/save',
     method: 'post',
-    data: objectToFormData(data) // 包含文件上传类需使用 formData 类型
+    data: objectToFormData(data) // 请求体如果为 formData 类型，使用 objectToFormData 方法转换
   })
 }
 
@@ -155,7 +149,7 @@ export const UpdateProjectApi = (data: Project) => {
 /**
  * 删除数据
  */
-export const DeleteProjectApi = (id: string) => {
+export const DeleteProjectApi = (id: number) => {
   return axiosRequest({
     url: `/demos/delete/${id}`,
     method: 'delete'
@@ -164,11 +158,11 @@ export const DeleteProjectApi = (id: string) => {
 /**
  * 列表数据
  */
-export const ProjectListApi = (data?: ProjectQuery): Promise<IPageTableData<Project>> => {
+export const ProjectListApi = (params?: ProjectQuery): Promise<IPageTableData<Project>> => {
   return axiosRequest({
     url: '/demos/table',
     method: 'get',
-    data
+    params
   })
 }
 
@@ -203,3 +197,17 @@ export const ExportApi = (data: Record<string, unknown>): Promise<Blob> => {
     data
   })
 }
+
+/**
+ * axios 方式下载文件
+ * @param uniqueFileName 文件唯一名称（列表中一般是在 item.attachmentDocument/imageDocument.attachments[].uniqueFileName)
+ * @returns Blob
+ */
+export const FileApi = (uniqueFileName: string): Promise<Blob> => {
+  return axiosRequest({
+    url: '/files/' + uniqueFileName,
+    method: 'get',
+    responseType: 'blob', // 响应类型为 blob
+    showErrorMsg: false // 不显示错误信息
+  })
+}

package/jnrs-vue/src/api/request.ts

@@ -6,7 +6,7 @@
  * @Desc.  : axios 网络请求实例
  */
 
-import type { IBusinessRequest, IBusinessResponse } from '@jnrs/shared'
+import type { IBusinessRequest, IFullResponse } from '@jnrs/shared'
 import { createAxiosInstance } from '@jnrs/shared/request'
 import { useMockStore } from '@jnrs/vue-core/pinia'
 import { useAuthStore } from '@/stores'
@@ -32,7 +32,7 @@ const axiosInstance = createAxiosInstance({
  * @param options 请求配置项
  * @returns Promise<T> 响应数据
  */
-const axiosRequest = <T = IBusinessResponse>(options: IBusinessRequest): Promise<T> => {
+const axiosRequest = <T = IFullResponse>(options: IBusinessRequest): Promise<T> => {
   if (!axiosInstance) {
     throw new Error('请先调用 createRequest 初始化 axios 实例')
   }

package/jnrs-vue/src/components/common/DictTag.vue

@@ -12,7 +12,7 @@ import { getDictLabel, getDictColor } from '@/utils'
 
 export interface Props {
   dictName: string
-  value: string | number
+  value?: string | number
   /**
    * 是否使用颜色
    */