diff --git a/.idea/workspace.xml b/.idea/workspace.xml index c3a830d..481517b 100644 --- a/.idea/workspace.xml +++ b/.idea/workspace.xml @@ -1,7 +1,12 @@ + + - + + + - + { + "customColor": "", + "associatedIndex": 1 +} @@ -57,6 +63,7 @@ diff --git a/client/package-lock.json b/client/package-lock.json index ef537ad..cf67628 100644 --- a/client/package-lock.json +++ b/client/package-lock.json @@ -18,6 +18,7 @@ "cz-customizable": "^7.0.0", "echarts": "^5.4.1", "element-plus": "^2.2.28", + "file-saver": "^2.0.5", "global": "^4.4.0", "husky": "^8.0.2", "screenfull": "^6.0.2", @@ -26,11 +27,13 @@ "unplugin-vue-components": "^0.22.12", "vue": "^3.2.13", "vue-i18n": "^9.2.2", + "vue-property-decorator": "^9.1.2", "vue-router": "^4.0.3", "vuex": "^4.0.0", "vuex-persistedstate": "^4.1.0" }, "devDependencies": { + "@types/file-saver": "^2.0.5", "@typescript-eslint/eslint-plugin": "^5.4.0", "@typescript-eslint/parser": "^5.4.0", "@vue/cli-plugin-babel": "~5.0.0", @@ -2982,6 +2985,13 @@ "@types/range-parser": "*" } }, + "node_modules/@types/file-saver": { + "version": "2.0.7", + "resolved": "https://registry.npmmirror.com/@types/file-saver/-/file-saver-2.0.7.tgz", + "integrity": "sha512-dNKVfHd/jk0SkR/exKGj2ggkB45MAkzvWCaqLUUgkyjITkGNzH8H+yUwr+BLJUBjZOe9w8X3wgmXhZDRg1ED6A==", + "dev": true, + "license": "MIT" + }, "node_modules/@types/html-minifier-terser": { "version": "6.1.0", "resolved": "https://registry.npmmirror.com/@types/html-minifier-terser/-/html-minifier-terser-6.1.0.tgz", @@ -4940,18 +4950,6 @@ "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" } }, - "node_modules/acorn-jsx/node_modules/acorn": { - "version": "7.4.1", - "dev": true, - "license": "MIT", - "peer": true, - "bin": { - "acorn": "bin/acorn" - }, - "engines": { - "node": ">=0.4.0" - } - }, "node_modules/acorn-node": { "version": "1.8.2", "resolved": "https://registry.npmjs.org/acorn-node/-/acorn-node-1.8.2.tgz", @@ -8299,6 +8297,12 @@ "node": "^10.12.0 || >=12.0.0" } }, + "node_modules/file-saver": { + "version": "2.0.5", + "resolved": "https://registry.npmmirror.com/file-saver/-/file-saver-2.0.5.tgz", + "integrity": "sha512-P9bmyZ3h/PRG+Nzga+rbdI4OEpNDzAVyy74uVO9ATgzLK6VtAsYybF/+TOCvrc0MO793d6+42lLyZTw7/ArVzA==", + "license": "MIT" + }, "node_modules/fill-range": { "version": "7.0.1", "resolved": "https://registry.npmmirror.com/fill-range/-/fill-range-7.0.1.tgz", @@ -15708,6 +15712,16 @@ "@vue/shared": "3.2.45" } }, + "node_modules/vue-class-component": { + "version": "7.2.6", + "resolved": "https://registry.npmmirror.com/vue-class-component/-/vue-class-component-7.2.6.tgz", + "integrity": "sha512-+eaQXVrAm/LldalI272PpDe3+i4mPis0ORiMYxF6Ae4hyuCh15W8Idet7wPUEs4N4YptgFHGys4UrgNQOMyO6w==", + "license": "MIT", + "peer": true, + "peerDependencies": { + "vue": "^2.0.0" + } + }, "node_modules/vue-demi": { "version": "0.13.11", "resolved": "https://registry.npmmirror.com/vue-demi/-/vue-demi-0.13.11.tgz", @@ -15861,6 +15875,16 @@ "node": ">=8.9.0" } }, + "node_modules/vue-property-decorator": { + "version": "9.1.2", + "resolved": "https://registry.npmmirror.com/vue-property-decorator/-/vue-property-decorator-9.1.2.tgz", + "integrity": "sha512-xYA8MkZynPBGd/w5QFJ2d/NM0z/YeegMqYTphy7NJQXbZcuU6FC6AOdUAcy4SXP+YnkerC6AfH+ldg7PDk9ESQ==", + "license": "MIT", + "peerDependencies": { + "vue": "*", + "vue-class-component": "*" + } + }, "node_modules/vue-router": { "version": "4.1.6", "resolved": "https://registry.npmmirror.com/vue-router/-/vue-router-4.1.6.tgz", @@ -18548,6 +18572,12 @@ "@types/range-parser": "*" } }, + "@types/file-saver": { + "version": "2.0.7", + "resolved": "https://registry.npmmirror.com/@types/file-saver/-/file-saver-2.0.7.tgz", + "integrity": "sha512-dNKVfHd/jk0SkR/exKGj2ggkB45MAkzvWCaqLUUgkyjITkGNzH8H+yUwr+BLJUBjZOe9w8X3wgmXhZDRg1ED6A==", + "dev": true + }, "@types/html-minifier-terser": { "version": "6.1.0", "resolved": "https://registry.npmmirror.com/@types/html-minifier-terser/-/html-minifier-terser-6.1.0.tgz", @@ -19967,14 +19997,7 @@ "resolved": "https://registry.npmmirror.com/acorn-jsx/-/acorn-jsx-5.3.2.tgz", "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", "dev": true, - "requires": {}, - "dependencies": { - "acorn": { - "version": "7.4.1", - "dev": true, - "peer": true - } - } + "requires": {} }, "acorn-node": { "version": "1.8.2", @@ -22289,6 +22312,11 @@ "flat-cache": "^3.0.4" } }, + "file-saver": { + "version": "2.0.5", + "resolved": "https://registry.npmmirror.com/file-saver/-/file-saver-2.0.5.tgz", + "integrity": "sha512-P9bmyZ3h/PRG+Nzga+rbdI4OEpNDzAVyy74uVO9ATgzLK6VtAsYybF/+TOCvrc0MO793d6+42lLyZTw7/ArVzA==" + }, "fill-range": { "version": "7.0.1", "resolved": "https://registry.npmmirror.com/fill-range/-/fill-range-7.0.1.tgz", @@ -27373,6 +27401,13 @@ } } }, + "vue-class-component": { + "version": "7.2.6", + "resolved": "https://registry.npmmirror.com/vue-class-component/-/vue-class-component-7.2.6.tgz", + "integrity": "sha512-+eaQXVrAm/LldalI272PpDe3+i4mPis0ORiMYxF6Ae4hyuCh15W8Idet7wPUEs4N4YptgFHGys4UrgNQOMyO6w==", + "peer": true, + "requires": {} + }, "vue-demi": { "version": "0.13.11", "resolved": "https://registry.npmmirror.com/vue-demi/-/vue-demi-0.13.11.tgz", @@ -27464,6 +27499,12 @@ } } }, + "vue-property-decorator": { + "version": "9.1.2", + "resolved": "https://registry.npmmirror.com/vue-property-decorator/-/vue-property-decorator-9.1.2.tgz", + "integrity": "sha512-xYA8MkZynPBGd/w5QFJ2d/NM0z/YeegMqYTphy7NJQXbZcuU6FC6AOdUAcy4SXP+YnkerC6AfH+ldg7PDk9ESQ==", + "requires": {} + }, "vue-router": { "version": "4.1.6", "resolved": "https://registry.npmmirror.com/vue-router/-/vue-router-4.1.6.tgz", diff --git a/client/src/apis/accident.ts b/client/src/apis/accident.ts index 8e87112..1b446d9 100644 --- a/client/src/apis/accident.ts +++ b/client/src/apis/accident.ts @@ -1,35 +1,57 @@ +// 从 "@/utils" 模块中导入 http 对象，用于发起 HTTP 请求 import { http } from "@/utils"; +// 从 "@/apis/bookManage" 模块中导入 IPageSearchElderByKey 接口 import { IPageSearchElderByKey } from "@/apis/bookManage"; +// 定义一个名为 IPageAccidentByKey 的接口，用于分页查询事故登记时的数据结构 interface IPageAccidentByKey { + // 老人姓名 elderName: string; + // 护工姓名 staffName: string; } +// 定义一个名为 IAddAccident 的接口，用于新增事故登记时的数据结构 interface IAddAccident { + // 事故登记的 ID id: number; + // 老人的 ID elderId: number; + // 护工的 ID staffId: number; + // 事故发生日期 occurDate: string; + // 事故描述 description: string; + // 事故相关图片 picture: string; } +// 定义一个名为 IGetAccidentById 的接口，用于根据编号获取事故登记时的数据结构 interface IGetAccidentById { + // 事故登记的 ID accidentId: string; } +// 定义一个名为 IEditAccident 的接口，用于编辑事故登记时的数据结构 interface IEditAccident { + // 事故登记的 ID id: number; + // 姓名 name: string; + // 电话号码 phone: string; + // 关系 relation: string; + // 事故日期字符串 accidentDateStr: string; + // 事故编号 accidentNum: number; } -// 分页查询事故登记 +// 定义一个异步函数 pageAccidentByKey，用于分页查询事故登记 export async function pageAccidentByKey(data: IPageAccidentByKey) { + // 使用 http 对象发起 GET 请求，请求路径为 "/api/accident/pageAccidentByKey"，并将 data 对象展开作为请求参数 return http.get("/api/accident/pageAccidentByKey", { params: { ...data @@ -37,8 +59,9 @@ export async function pageAccidentByKey(data: IPageAccidentByKey) { }); } -// 分页搜索老人 +// 定义一个异步函数 pageSearchElderByKey，用于分页搜索老人 export async function pageSearchElderByKey(data: IPageSearchElderByKey) { + // 使用 http 对象发起 GET 请求，请求路径为 "/api/accident/pageSearchElderByKey"，并将 data 对象展开作为请求参数 return http.get("/api/accident/pageSearchElderByKey", { params: { ...data @@ -46,18 +69,21 @@ export async function pageSearchElderByKey(data: IPageSearchElderByKey) { }); } -// 获取护工列表 +// 定义一个异步函数 listAccidentStaff，用于获取护工列表 export async function listAccidentStaff() { + // 使用 http 对象发起 GET 请求，请求路径为 "/api/accident/listAccidentStaff" return http.get("/api/accident/listAccidentStaff"); } -// 新增事故登记 +// 定义一个函数 addAccident，用于新增事故登记 export function addAccident(data: IAddAccident) { + // 使用 http 对象发起 POST 请求，请求路径为 "/api/accident/addAccident"，并将 data 对象作为请求体 return http.post("/api/accident/addAccident", data); } -// 根据编号获取事故登记 +// 定义一个异步函数 getAccidentById，用于根据编号获取事故登记 export async function getAccidentById(data: IGetAccidentById) { + // 使用 http 对象发起 GET 请求，请求路径为 "/api/accident/getAccidentById"，并将 data 对象展开作为请求参数 return http.get("/api/accident/getAccidentById", { params: { ...data @@ -65,13 +91,15 @@ export async function getAccidentById(data: IGetAccidentById) { }); } -// 编辑事故登记 +// 定义一个函数 editAccident，用于编辑事故登记 export function editAccident(data: IEditAccident) { + // 使用 http 对象发起 PUT 请求，请求路径为 "/api/accident/editAccident"，并将 data 对象作为请求体 return http.put("/api/accident/editAccident", data); } -// 删除事故登记 +// 定义一个异步函数 deleteAccident，用于删除事故登记 export async function deleteAccident(data: IGetAccidentById) { + // 使用 http 对象发起 DELETE 请求，请求路径为 "/api/accident/deleteAccident"，并将 data 对象展开作为请求参数 return http.delete("/api/accident/deleteAccident", { params: { ...data diff --git a/client/src/apis/bedPanorama.ts b/client/src/apis/bedPanorama.ts index 80e8fab..1474293 100644 --- a/client/src/apis/bedPanorama.ts +++ b/client/src/apis/bedPanorama.ts @@ -1,18 +1,32 @@ +// 从 "@/utils" 模块导入 http 对象，该对象可能封装了 HTTP 请求方法 import { http } from "@/utils"; +// 定义一个名为 IListRoomByKey 的接口，用于描述获取房间列表时请求参数的数据结构 interface IListRoomByKey { + // 楼栋 ID，类型为字符串 buildingId: string; + // 楼层 ID，类型为字符串 floorId: string; + // 老人姓名，类型为字符串 elderName: string; } -// 获取楼栋列表 +/** + * 获取楼栋列表 + * @returns 一个 Promise，解析为包含楼栋列表的响应 + */ export async function listBuilding() { + // 发起一个 GET 请求到指定的 API 端点，用于获取楼栋列表 return http.get("/api/bedPanorama/listBuilding"); } -// 获取楼层列表 +/** + * 根据楼栋 ID 获取楼层列表 + * @param buildingId - 用于筛选楼层列表的楼栋 ID + * @returns 一个 Promise，解析为包含楼层列表的响应 + */ export function listFloorByBuildingId(buildingId: string) { + // 发起一个 GET 请求到指定的 API 端点，携带楼栋 ID 作为参数，用于获取对应楼栋的楼层列表 return http.get("/api/bedPanorama/listFloorByBuildingId", { params: { buildingId @@ -20,8 +34,13 @@ export function listFloorByBuildingId(buildingId: string) { }); } -// 获取房间列表 +/** + * 根据条件获取房间列表 + * @param data - 包含筛选条件的对象，符合 IListRoomByKey 接口的结构 + * @returns 一个 Promise，解析为包含房间列表的响应 + */ export function listRoomByKey(data: IListRoomByKey) { + // 发起一个 GET 请求到指定的 API 端点，将 data 对象中的属性展开作为请求参数，用于获取符合条件的房间列表 return http.get("/api/bedPanorama/listRoomByKey", { params: { ...data diff --git a/client/src/apis/bookManage.ts b/client/src/apis/bookManage.ts index 171a1d8..46c4db0 100644 --- a/client/src/apis/bookManage.ts +++ b/client/src/apis/bookManage.ts @@ -1,45 +1,79 @@ +// 从 '@/utils' 模块导入 http 对象，该对象可能封装了 HTTP 请求的方法，用于后续发起网络请求 import { http } from '@/utils' +// 定义一个接口 ISearchFormReserveByKey，用于描述分页查询预定时请求参数的数据结构 interface ISearchFormReserveByKey { + // 当前页码，类型为数字 pageNum: number + // 每页显示的数量，类型为数字 pageSize: number + // 老人姓名，可选参数，类型为字符串 elderName?: string + // 付款人电话，可选参数，类型为字符串 payerPhone?: string } +// 定义一个导出的接口 IPageSearchElderByKey，用于描述分页搜索老人时请求参数的数据结构 export interface IPageSearchElderByKey { + // 当前页码，类型为数字 pageNum: number + // 每页显示的数量，类型为数字 pageSize: number + // 老人姓名，可选参数，类型为字符串 elderName?: string + // 老人电话，可选参数，类型为字符串 elderPhone?: string } +// 定义一个接口 IAddReserve，用于描述新增预定时请求体的数据结构 interface IAddReserve { + // 床位 ID，类型为字符串 bedId: string + // 定金，类型为字符串 deposit: string + // 截止日期，类型为字符串 dueDate: string + // 老人地址，类型为字符串 elderAddress: string + // 老人年龄，类型为字符串 elderAge: string + // 老人姓名，类型为字符串 elderName: string + // 老人电话，类型为字符串 elderPhone: string + // 老人性别，类型为字符串 elderSex: string + // 身份证号码，类型为字符串 idNum: string + // 付款人姓名，类型为字符串 payerName: string + // 付款人电话，类型为字符串 payerPhone: string + // 工作人员 ID，类型为字符串 staffId: string } +// 定义一个接口 IGetReserveById，用于描述根据预定编号和老人编号获取预定信息时请求参数的数据结构 interface IGetReserveById { + // 老人 ID，类型为字符串 elderId: string + // 预定 ID，类型为字符串 reserveId: string } +// 定义一个接口 IRefund，用于描述退款时请求体的数据结构 interface IRefund { + // 预定 ID，类型为字符串 reserveId: string } -// 分页查询预定 +/** + * 分页查询预定信息 + * @param data - 包含分页和查询条件的对象，符合 ISearchFormReserveByKey 接口 + * @returns 一个 Promise，解析为包含分页查询预定结果的响应 + */ export async function pageReserveByKey(data: ISearchFormReserveByKey) { + // 发起一个 GET 请求到指定的 API 端点，将 data 对象中的属性展开作为请求参数 return http.get('/api/reserve/pageReserveByKey', { params: { ...data @@ -47,8 +81,13 @@ export async function pageReserveByKey(data: ISearchFormReserveByKey) { }) } -// 分页搜索老人 +/** + * 分页搜索老人信息 + * @param data - 包含分页和查询条件的对象，符合 IPageSearchElderByKey 接口 + * @returns 一个 Promise，解析为包含分页搜索老人结果的响应 + */ export function pageSearchElderByKey(data: IPageSearchElderByKey) { + // 发起一个 GET 请求到指定的 API 端点，将 data 对象中的属性展开作为请求参数 return http.get('/api/reserve/pageSearchElderByKey', { params: { ...data @@ -56,23 +95,41 @@ export function pageSearchElderByKey(data: IPageSearchElderByKey) { }) } -// 获取营销人员 +/** + * 获取营销人员列表 + * @returns 一个 Promise，解析为包含营销人员列表的响应 + */ export function listReserveStaff() { + // 发起一个 GET 请求到指定的 API 端点，用于获取营销人员列表 return http.get('/api/reserve/listReserveStaff') } -// 获取楼栋树 +/** + * 获取楼栋树信息 + * @returns 一个 Promise，解析为包含楼栋树信息的响应 + */ export function getBuildTree() { + // 发起一个 GET 请求到指定的 API 端点，用于获取楼栋树信息 return http.get('/api/reserve/getBuildTree') } -// 新增预定 +/** + * 新增预定信息 + * @param data - 包含新增预定所需信息的对象，符合 IAddReserve 接口 + * @returns 一个 Promise，解析为新增预定操作的响应 + */ export function addReserve(data: IAddReserve) { + // 发起一个 POST 请求到指定的 API 端点，将 data 对象作为请求体 return http.post('/api/reserve/addReserve', data) } -// 根据预定编号和老人编号获取预定信息 +/** + * 根据预定编号和老人编号获取预定信息 + * @param data - 包含预定编号和老人编号的对象，符合 IGetReserveById 接口 + * @returns 一个 Promise，解析为包含指定预定信息的响应 + */ export function getReserveById(data: IGetReserveById) { + // 发起一个 GET 请求到指定的 API 端点，将 data 对象中的属性展开作为请求参数 return http.get('/api/reserve/getReserveByReserveIdAndElderId', { params: { ...data @@ -80,7 +137,12 @@ export function getReserveById(data: IGetReserveById) { }) } -// 退款 +/** + * 进行退款操作 + * @param data - 包含退款所需预定 ID 的对象，符合 IRefund 接口 + * @returns 一个 Promise，解析为退款操作的响应 + */ export function refund(data: IRefund) { - return http.put('/api/reserve/refund',data) + // 发起一个 PUT 请求到指定的 API 端点，将 data 对象作为请求体 + return http.put('/api/reserve/refund', data) } diff --git a/client/src/apis/build.ts b/client/src/apis/build.ts index 925cfac..eb5871f 100644 --- a/client/src/apis/build.ts +++ b/client/src/apis/build.ts @@ -1,64 +1,103 @@ +// 从 "@/utils" 模块导入 http 对象，用于发起 HTTP 请求 import { http } from "@/utils"; +// 定义 IPageBedByKey 接口，用于分页查询床位时的参数结构 interface IPageBedByKey { + // 楼栋 ID buildId: string; + // 楼层 ID floorId: string; + // 房间 ID roomId: string; + // 床位状态标识 bedFlag: string; } +// 定义 IAddBuilding 接口，用于新增楼栋时的请求数据结构 interface IAddBuilding { + // 楼栋 ID id: string; + // 楼栋名称 name: string; + // 楼层数量 floorNum: string; } +// 定义 IGetBuildingById 接口，用于根据编号获取楼栋时的参数结构 interface IGetBuildingById { + // 楼栋 ID buildingId: string; } +// 定义 IAddFloor 接口，用于新增楼层时的请求数据结构 interface IAddFloor { + // 楼层 ID id: string; + // 楼层名称 name: string; + // 房间数量 roomNum: string; + // 所属楼栋 ID buildingId: string; + // 楼层限制相关信息 floorLimit: string; } +// 定义 IGetFloorById 接口，用于根据编号获取楼层时的参数结构 interface IGetFloorById { + // 楼层 ID floorId: string; } +// 定义 IAddRoom 接口，用于新增房间时的请求数据结构 interface IAddRoom { + // 房间 ID id: string; + // 房间名称 name: string; + // 房间类型 ID typeId: string; + // 床位数量 bedNum: string; + // 所属楼层 ID floorId: string; + // 房间限制相关信息 roomLimit: string; } +// 定义 IGetRoomById 接口，用于根据编号获取房间时的参数结构 interface IGetRoomById { + // 房间 ID roomId: string; } +// 定义 IDeleteNode 接口，用于删除节点时的参数结构 interface IDeleteNode { + // 节点 ID id: string; + // 节点标识 mark: string; } +// 定义 IAddBed 接口，用于新增床位时的请求数据结构 interface IAddBed { + // 床位 ID id: string; + // 床位名称 name: string; + // 所属房间 ID roomId: string; + // 床位限制相关信息 bedLimit: string; } +// 定义 IGetBedById 接口，用于根据编号获取床位时的参数结构 interface IGetBedById { + // 床位 ID bedId: string; } -// 床位状态 +// 定义床位状态列表，包含每个状态的标签和对应的值 export const IBedFlagList = [ { label: "空闲", value: "空闲" }, { label: "预定", value: "预定" }, @@ -66,13 +105,22 @@ export const IBedFlagList = [ { label: "退住审核", value: "退住审核" } ]; -// 获取楼栋-楼层-房间树 +/** + * 获取楼栋 - 楼层 - 房间树 + * @returns 一个 Promise，解析为包含楼栋 - 楼层 - 房间树数据的响应 + */ export async function getNoBedTree() { + // 发起 GET 请求到 /api/build/getNoBedTree 接口获取数据 return http.get("/api/build/getNoBedTree"); } -// 分页查询床位 +/** + * 分页查询床位 + * @param data - 包含分页查询床位所需参数的对象，符合 IPageBedByKey 接口 + * @returns 一个 Promise，解析为包含分页查询床位结果的响应 + */ export async function pageBedByKey(data: IPageBedByKey) { + // 发起 GET 请求到 /api/build/pageBedByKey 接口，将 data 对象展开作为请求参数 return http.get("/api/build/pageBedByKey", { params: { ...data @@ -80,13 +128,23 @@ export async function pageBedByKey(data: IPageBedByKey) { }); } -// 新增楼栋 +/** + * 新增楼栋 + * @param data - 包含新增楼栋所需信息的对象，符合 IAddBuilding 接口 + * @returns 一个 Promise，解析为新增楼栋操作的响应 + */ export function addBuilding(data: IAddBuilding) { + // 发起 POST 请求到 /api/build/addBuilding 接口，将 data 作为请求体 return http.post("/api/build/addBuilding", data); } -// 根据编号获取楼栋 +/** + * 根据编号获取楼栋 + * @param data - 包含要获取的楼栋编号的对象，符合 IGetBuildingById 接口 + * @returns 一个 Promise，解析为包含指定楼栋信息的响应 + */ export async function getBuildingById(data: IGetBuildingById) { + // 发起 GET 请求到 /api/build/getBuildingById 接口，将 data 对象展开作为请求参数 return http.get("/api/build/getBuildingById", { params: { ...data @@ -94,18 +152,33 @@ export async function getBuildingById(data: IGetBuildingById) { }); } -// 编辑楼栋 +/** + * 编辑楼栋 + * @param data - 包含要编辑的楼栋信息的对象，符合 IAddBuilding 接口 + * @returns 一个 Promise，解析为编辑楼栋操作的响应 + */ export function editBuilding(data: IAddBuilding) { + // 发起 PUT 请求到 /api/build/editBuilding 接口，将 data 作为请求体 return http.put("/api/build/editBuilding", data); } -// 新增楼层 +/** + * 新增楼层 + * @param data - 包含新增楼层所需信息的对象，符合 IAddFloor 接口 + * @returns 一个 Promise，解析为新增楼层操作的响应 + */ export function addFloor(data: IAddFloor) { + // 发起 POST 请求到 /api/build/addFloor 接口，将 data 作为请求体 return http.post("/api/build/addFloor", data); } -// 根据编号获取楼层 +/** + * 根据编号获取楼层 + * @param data - 包含要获取的楼层编号的对象，符合 IGetFloorById 接口 + * @returns 一个 Promise，解析为包含指定楼层信息的响应 + */ export async function getFloorById(data: IGetFloorById) { + // 发起 GET 请求到 /api/build/getFloorById 接口，将 data 对象展开作为请求参数 return http.get("/api/build/getFloorById", { params: { ...data @@ -113,23 +186,42 @@ export async function getFloorById(data: IGetFloorById) { }); } -// 编辑楼层 +/** + * 编辑楼层 + * @param data - 包含要编辑的楼层信息的对象，符合 IAddFloor 接口 + * @returns 一个 Promise，解析为编辑楼层操作的响应 + */ export function editFloor(data: IAddFloor) { + // 发起 PUT 请求到 /api/build/editFloor 接口，将 data 作为请求体 return http.put("/api/build/editFloor", data); } -// 获取房间类型列表 +/** + * 获取房间类型列表 + * @returns 一个 Promise，解析为包含房间类型列表数据的响应 + */ export async function listRoomType() { + // 发起 GET 请求到 /api/build/listRoomType 接口获取数据 return http.get("/api/build/listRoomType"); } -// 新增房间 +/** + * 新增房间 + * @param data - 包含新增房间所需信息的对象，符合 IAddRoom 接口 + * @returns 一个 Promise，解析为新增房间操作的响应 + */ export function addRoom(data: IAddRoom) { + // 发起 POST 请求到 /api/build/addRoom 接口，将 data 作为请求体 return http.post("/api/build/addRoom", data); } -// 根据编号获取房间 +/** + * 根据编号获取房间 + * @param data - 包含要获取的房间编号的对象，符合 IGetRoomById 接口 + * @returns 一个 Promise，解析为包含指定房间信息的响应 + */ export async function getRoomById(data: IGetRoomById) { + // 发起 GET 请求到 /api/build/getRoomById 接口，将 data 对象展开作为请求参数 return http.get("/api/build/getRoomById", { params: { ...data @@ -137,13 +229,23 @@ export async function getRoomById(data: IGetRoomById) { }); } -// 编辑房间 +/** + * 编辑房间 + * @param data - 包含要编辑的房间信息的对象，符合 IAddRoom 接口 + * @returns 一个 Promise，解析为编辑房间操作的响应 + */ export function editRoom(data: IAddRoom) { + // 发起 PUT 请求到 /api/build/editRoom 接口，将 data 作为请求体 return http.put("/api/build/editRoom", data); } -// 删除节点 +/** + * 删除节点 + * @param data - 包含要删除的节点信息的对象，符合 IDeleteNode 接口 + * @returns 一个 Promise，解析为删除节点操作的响应 + */ export async function deleteNode(data: IDeleteNode) { + // 发起 DELETE 请求到 /api/build/deleteNode 接口，将 data 对象展开作为请求参数 return http.delete("/api/build/deleteNode", { params: { ...data @@ -151,13 +253,23 @@ export async function deleteNode(data: IDeleteNode) { }); } -// 新增床位 +/** + * 新增床位 + * @param data - 包含新增床位所需信息的对象，符合 IAddBed 接口 + * @returns 一个 Promise，解析为新增床位操作的响应 + */ export function addBed(data: IAddBed) { + // 发起 POST 请求到 /api/build/addBed 接口，将 data 作为请求体 return http.post("/api/build/addBed", data); } -// 根据编号获取床位 +/** + * 根据编号获取床位 + * @param data - 包含要获取的床位编号的对象，符合 IGetBedById 接口 + * @returns 一个 Promise，解析为包含指定床位信息的响应 + */ export async function getBedById(data: IGetBedById) { + // 发起 GET 请求到 /api/build/getBedById 接口，将 data 对象展开作为请求参数 return http.get("/api/build/getBedById", { params: { ...data @@ -165,13 +277,23 @@ export async function getBedById(data: IGetBedById) { }); } -// 编辑床位 +/** + * 编辑床位 + * @param data - 包含要编辑的床位信息的对象，符合 IAddBed 接口 + * @returns 一个 Promise，解析为编辑床位操作的响应 + */ export function editBed(data: IAddBed) { + // 发起 PUT 请求到 /api/build/editBed 接口，将 data 作为请求体 return http.put("/api/build/editBed", data); } -// 删除床位 +/** + * 删除床位 + * @param data - 包含要删除的床位编号的对象，符合 IGetBedById 接口 + * @returns 一个 Promise，解析为删除床位操作的响应 + */ export async function deleteBed(data: IGetBedById) { + // 发起 DELETE 请求到 /api/build/deleteBed 接口，将 data 对象展开作为请求参数 return http.delete("/api/build/deleteBed", { params: { ...data diff --git a/client/src/apis/cateringSet.ts b/client/src/apis/cateringSet.ts index 9135182..1d4ae24 100644 --- a/client/src/apis/cateringSet.ts +++ b/client/src/apis/cateringSet.ts @@ -1,26 +1,50 @@ +// 从 "@/utils" 模块导入 http 对象，用于发起 HTTP 请求 import { http } from "@/utils"; +// 从 "@/apis/dishes" 模块导入 IPageDishesByKey 接口，用于分页查询菜品时的参数类型定义 import { IPageDishesByKey } from "@/apis/dishes"; +/** + * 定义 IPageCateringSetByKey 接口，用于分页查询餐饮套餐时的参数结构 + */ interface IPageCateringSetByKey { - name:string; + // 名称，用于筛选餐饮套餐 + name: string; + // 套餐名称，由于后台与前端组件封装要求，该字段与 name 可能存在关联 setName: string; } +/** + * 定义 IAddCateringSet 接口，用于新增餐饮套餐时的请求数据结构 + */ interface IAddCateringSet { + // 餐饮套餐的 ID id: number; + // 餐饮套餐的名称 name: string; + // 餐饮套餐的月价格 monthPrice: number; - dishesIdList: any ; + // 菜品 ID 列表，类型为 any，需根据实际情况调整 + dishesIdList: any; } +/** + * 定义 IGetCateringSetById 接口，用于根据编号查询餐饮套餐时的参数结构 + */ interface IGetCateringSetById { - setId: string + // 餐饮套餐的 ID + setId: string; } -// 分页查询餐饮套餐 +/** + * 分页查询餐饮套餐 + * @param data - 包含分页查询餐饮套餐所需参数的对象，符合 IPageCateringSetByKey 接口 + * @returns 一个 Promise，解析为包含分页查询餐饮套餐结果的响应 + */ export async function pageCateringSetByKey(data: IPageCateringSetByKey) { - // 因为后台返回的字段与前端表单数据的prop不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 - Reflect.has(data, 'name') ? (data.setName = data.name) : '' + // 由于后台返回的字段与前端表单数据的 prop 不一样，而组件封装要求字段一致 + // 所以如果 data 对象中有 'name' 字段，则将其值赋给 'setName' 字段 + Reflect.has(data, 'name') ? (data.setName = data.name) : ''; + // 发起 GET 请求到 /api/cateringSet/pageCateringSetByKey 接口，将 data 对象展开作为请求参数 return http.get("/api/cateringSet/pageCateringSetByKey", { params: { ...data @@ -28,13 +52,22 @@ export async function pageCateringSetByKey(data: IPageCateringSetByKey) { }); } -// 获取菜品分类 +/** + * 获取菜品分类 + * @returns 一个 Promise，解析为包含菜品分类列表的响应 + */ export function listDishesType() { + // 发起 POST 请求到 /api/cateringSet/listDishesType 接口获取菜品分类数据 return http.post("/api/cateringSet/listDishesType"); } -// 分页查询菜品 +/** + * 分页查询菜品 + * @param data - 包含分页查询菜品所需参数的对象，符合 IPageDishesByKey 接口 + * @returns 一个 Promise，解析为包含分页查询菜品结果的响应 + */ export async function pageDishesByKey(data: IPageDishesByKey) { + // 发起 GET 请求到 /api/cateringSet/pageDishesByKey 接口，将 data 对象展开作为请求参数 return http.get("/api/cateringSet/pageDishesByKey", { params: { ...data @@ -42,13 +75,23 @@ export async function pageDishesByKey(data: IPageDishesByKey) { }); } -// 新增餐饮套餐 +/** + * 新增餐饮套餐 + * @param data - 包含新增餐饮套餐所需信息的对象，符合 IAddCateringSet 接口 + * @returns 一个 Promise，解析为新增餐饮套餐操作的响应 + */ export function addCateringSet(data: IAddCateringSet) { + // 发起 POST 请求到 /api/cateringSet/addCateringSet 接口，将 data 作为请求体 return http.post("/api/cateringSet/addCateringSet", data); } -// 根据编号查询餐饮套餐 +/** + * 根据编号查询餐饮套餐 + * @param data - 包含要查询的餐饮套餐编号的对象，符合 IGetCateringSetById 接口 + * @returns 一个 Promise，解析为包含指定餐饮套餐信息的响应 + */ export async function getCateringSetById(data: IGetCateringSetById) { + // 发起 GET 请求到 /api/cateringSet/getCateringSetById 接口，将 data 对象展开作为请求参数 return http.get("/api/cateringSet/getCateringSetById", { params: { ...data @@ -56,13 +99,23 @@ export async function getCateringSetById(data: IGetCateringSetById) { }); } -// 编辑餐饮套餐 +/** + * 编辑餐饮套餐 + * @param data - 包含要编辑的餐饮套餐信息的对象，符合 IAddCateringSet 接口 + * @returns 一个 Promise，解析为编辑餐饮套餐操作的响应 + */ export function editCateringSet(data: IAddCateringSet) { + // 发起 PUT 请求到 /api/cateringSet/editCateringSet 接口，将 data 作为请求体 return http.put("/api/cateringSet/editCateringSet", data); } -// 删除餐饮套餐 +/** + * 删除餐饮套餐 + * @param data - 包含要删除的餐饮套餐编号的对象，符合 IGetCateringSetById 接口 + * @returns 一个 Promise，解析为删除餐饮套餐操作的响应 + */ export async function deleteCateringSet(data: IGetCateringSetById) { + // 发起 DELETE 请求到 /api/cateringSet/deleteCateringSet 接口，将 data 对象展开作为请求参数 return http.delete("/api/cateringSet/deleteCateringSet", { params: { ...data diff --git a/client/src/apis/checkContract.ts b/client/src/apis/checkContract.ts index c658840..c5a2b1e 100644 --- a/client/src/apis/checkContract.ts +++ b/client/src/apis/checkContract.ts @@ -1,44 +1,87 @@ +// 从 "@/utils" 模块导入 http 对象，用于发起 HTTP 请求 import { http } from "@/utils"; +// 从 "@/apis/bookManage" 模块导入 IPageSearchElderByKey 接口，用于分页搜索老人时的参数类型定义 import { IPageSearchElderByKey } from "@/apis/bookManage"; +/** + * 定义 IPageCheckContractByKey 接口，用于分页查询入住签约时的参数结构 + */ interface IPageCheckContractByKey { + // 姓名，用于筛选入住签约记录 name: string; + // 性别，用于筛选入住签约记录 sex: string; + // 身份证号码，用于筛选入住签约记录 idNum: string; } +/** + * 定义 IAddCheckContract 接口，用于新增入住签约时的请求数据结构 + */ interface IAddCheckContract { + // 入住签约的 ID id: string; + // 护理等级 ID nursingGradeId: string; + // 餐饮套餐 ID cateringSetId: string; + // 床位 ID bedId: string; + // 姓名 name: string; + // 身份证号码 idNum: string; + // 年龄 age: string; + // 性别 sex: string; + // 电话 phone: string; + // 地址 address: string; + // 工作人员 ID staffId: string; + // 签约日期 signDate: string; + // 开始日期 startDate: string; + // 结束日期 endDate: string; + // 紧急联系人查询列表，包含多个紧急联系人信息 operateEmergencyContactQueryList: IEmergencyContact[]; } +/** + * 定义 IEmergencyContact 接口，用于表示紧急联系人的信息结构 + */ interface IEmergencyContact { + // 姓名 name: string; + // 电话 phone: string; + // 邮箱 email: string; + // 关系 relation: string; + // 接收标志 receiveFlag: string; } +/** + * 定义 IGetCheckContractById 接口，用于根据老人编号查询入住签约时的参数结构 + */ interface IGetCheckContractById { - elderId: string + // 老人 ID + elderId: string; } -// 分页查询入住签约 +/** + * 分页查询入住签约 + * @param data - 包含分页查询入住签约所需参数的对象，符合 IPageCheckContractByKey 接口 + * @returns 一个 Promise，解析为包含分页查询入住签约结果的响应 + */ export async function pageCheckContractByKey(data: IPageCheckContractByKey) { + // 发起 GET 请求到 /api/checkContract/pageCheckContractByKey 接口，将 data 对象展开作为请求参数 return http.get("/api/checkContract/pageCheckContractByKey", { params: { ...data @@ -46,8 +89,13 @@ export async function pageCheckContractByKey(data: IPageCheckContractByKey) { }); } -// 分页搜索老人 +/** + * 分页搜索老人 + * @param data - 包含分页搜索老人所需参数的对象，符合 IPageSearchElderByKey 接口 + * @returns 一个 Promise，解析为包含分页搜索老人结果的响应 + */ export async function pageSearchElderByKey(data: IPageSearchElderByKey) { + // 发起 GET 请求到 /api/checkContract/pageSearchElderByKey 接口，将 data 对象展开作为请求参数 return http.get("/api/checkContract/pageSearchElderByKey", { params: { ...data @@ -55,13 +103,22 @@ export async function pageSearchElderByKey(data: IPageSearchElderByKey) { }); } -// 获取护理等级列表 +/** + * 获取护理等级列表 + * @returns 一个 Promise，解析为包含护理等级列表的响应 + */ export async function listNurseGrade() { + // 发起 GET 请求到 /api/checkContract/listNurseGrade 接口获取护理等级数据 return http.get("/api/checkContract/listNurseGrade"); } -// 根据编号查询护理等级 +/** + * 根据编号查询护理等级 + * @param nurseGradeId - 要查询的护理等级 ID + * @returns 一个 Promise，解析为包含指定护理等级信息的响应 + */ export async function getNurseGradeById(nurseGradeId: string) { + // 发起 GET 请求到 /api/checkContract/getNurseGradeById 接口，将 nurseGradeId 作为请求参数 return http.get("/api/checkContract/getNurseGradeById", { params: { nurseGradeId @@ -69,13 +126,22 @@ export async function getNurseGradeById(nurseGradeId: string) { }); } -// 获取餐饮套餐列表 +/** + * 获取餐饮套餐列表 + * @returns 一个 Promise，解析为包含餐饮套餐列表的响应 + */ export async function listCateringSet() { + // 发起 GET 请求到 /api/checkContract/listCateringSet 接口获取餐饮套餐数据 return http.get("/api/checkContract/listCateringSet"); } -// 根据编号查询餐饮套餐 +/** + * 根据编号查询餐饮套餐 + * @param cateringSetId - 要查询的餐饮套餐 ID + * @returns 一个 Promise，解析为包含指定餐饮套餐信息的响应 + */ export async function getCateringSetById(cateringSetId: string) { + // 发起 GET 请求到 /api/checkContract/getCateringSetById 接口，将 cateringSetId 作为请求参数 return http.get("/api/checkContract/getCateringSetById", { params: { cateringSetId @@ -83,13 +149,22 @@ export async function getCateringSetById(cateringSetId: string) { }); } -// 获取楼栋树 +/** + * 获取楼栋树 + * @returns 一个 Promise，解析为包含楼栋树信息的响应 + */ export async function getBuildTree() { + // 发起 GET 请求到 /api/checkContract/getBuildTree 接口获取楼栋树数据 return http.get("/api/checkContract/getBuildTree"); } -// 根据编号查询床位 +/** + * 根据编号查询床位 + * @param bedId - 要查询的床位 ID + * @returns 一个 Promise，解析为包含指定床位信息的响应 + */ export async function getBedById(bedId: string) { + // 发起 GET 请求到 /api/checkContract/getBedById 接口，将 bedId 作为请求参数 return http.get("/api/checkContract/getBedById", { params: { bedId @@ -97,18 +172,32 @@ export async function getBedById(bedId: string) { }); } -// 获取营销人员 +/** + * 获取营销人员 + * @returns 一个 Promise，解析为包含营销人员列表的响应 + */ export async function listReserveStaff() { + // 发起 GET 请求到 /api/checkContract/listReserveStaff 接口获取营销人员数据 return http.get("/api/checkContract/listReserveStaff"); } -// 新增入住签约 +/** + * 新增入住签约 + * @param data - 包含新增入住签约所需信息的对象，符合 IAddCheckContract 接口 + * @returns 一个 Promise，解析为新增入住签约操作的响应 + */ export function addCheckContract(data: IAddCheckContract) { + // 发起 POST 请求到 /api/checkContract/addCheckContract 接口，将 data 作为请求体 return http.post("/api/checkContract/addCheckContract", data); } -// 根据老人编号查询入住签约 +/** + * 根据老人编号查询入住签约 + * @param data - 包含要查询的老人编号的对象，符合 IGetCheckContractById 接口 + * @returns 一个 Promise，解析为包含指定入住签约信息的响应 + */ export async function getCheckContractById(data: IGetCheckContractById) { + // 发起 GET 请求到 /api/checkContract/getCheckContractById 接口，将 data 对象展开作为请求参数 return http.get("/api/checkContract/getCheckContractById", { params: { ...data @@ -116,13 +205,23 @@ export async function getCheckContractById(data: IGetCheckContractById) { }); } -// 编辑入住签约 +/** + * 编辑入住签约 + * @param data - 包含要编辑的入住签约信息的对象，符合 IAddCheckContract 接口 + * @returns 一个 Promise，解析为编辑入住签约操作的响应 + */ export function editCheckContract(data: IAddCheckContract) { + // 发起 PUT 请求到 /api/checkContract/editCheckContract 接口，将 data 作为请求体 return http.put("/api/checkContract/editCheckContract", data); } -// 删除入住签约 +/** + * 删除入住签约 + * @param data - 包含要删除的入住签约编号的对象，符合 IGetCheckContractById 接口 + * @returns 一个 Promise，解析为删除入住签约操作的响应 + */ export async function deleteCheckContract(data: IGetCheckContractById) { + // 发起 DELETE 请求到 /api/checkContract/deleteCheckContract 接口，将 data 对象展开作为请求参数 return http.delete("/api/checkContract/deleteCheckContract", { params: { ...data diff --git a/client/src/apis/consume.ts b/client/src/apis/consume.ts index 2f2a005..69bb33b 100644 --- a/client/src/apis/consume.ts +++ b/client/src/apis/consume.ts @@ -1,13 +1,25 @@ +// 从 "@/utils" 模块导入名为 http 的对象， +// 推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 import { http } from "@/utils"; +// 定义一个接口 IPageConsumeByKey，用于描述分页查询消费记录时的请求参数结构 interface IPageConsumeByKey { + // 老人姓名，用于筛选消费记录，类型为字符串 elderName: string; + // 开始时间，用于筛选消费记录的时间范围，类型为字符串 startTime: string; + // 结束时间，用于筛选消费记录的时间范围，类型为字符串 endTime: string; } -// 分页查询消费记录 +/** + * 定义一个异步函数 pageConsumeByKey，用于分页查询消费记录 + * @param data - 一个符合 IPageConsumeByKey 接口的对象，包含查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询消费记录的响应结果 + */ export async function pageConsumeByKey(data: IPageConsumeByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/consume/pageConsumeByKey" + // 将传入的 data 对象展开作为请求的参数 return http.get("/api/consume/pageConsumeByKey", { params: { ...data diff --git a/client/src/apis/depositRecharge.ts b/client/src/apis/depositRecharge.ts index 4bb2d1d..ed6ef32 100644 --- a/client/src/apis/depositRecharge.ts +++ b/client/src/apis/depositRecharge.ts @@ -1,24 +1,47 @@ +// 从 "@/utils" 模块导入名为 http 的对象， +// 推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 import { http } from "@/utils"; + +// 从 "@/apis/bookManage" 模块导入 IPageSearchElderByKey 接口， +// 用于描述分页搜索老人时的请求参数结构 import { IPageSearchElderByKey } from "@/apis/bookManage"; +// 定义一个接口 IPageDepositRechargeByKey，用于描述分页查询预存充值时的请求参数结构 interface IPageDepositRechargeByKey { - idNum:string; - name:string; - elderName:string; + // 身份证号码，用于筛选预存充值记录，类型为字符串 + idNum: string; + // 姓名，用于筛选预存充值记录，类型为字符串 + name: string; + // 老人姓名，用于筛选预存充值记录，类型为字符串 + elderName: string; + // 电话，用于筛选预存充值记录，类型为字符串 phone: string; + // 老人电话，用于筛选预存充值记录，类型为字符串 elderPhone: string; } +// 定义一个接口 IRecharge，用于描述入住老人账户充值时的请求参数结构 interface IRecharge { + // 老人 ID，用于指定要充值的老人账户，类型为字符串 elderId: string; + // 充值金额，用于指定充值的金额，类型为字符串 amount: string; } -// 分页查询预存充值 +/** + * 定义一个异步函数 pageDepositRechargeByKey，用于分页查询预存充值记录 + * @param data - 一个符合 IPageDepositRechargeByKey 接口的对象，包含查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询预存充值记录的响应结果 + */ export async function pageDepositRechargeByKey(data: IPageDepositRechargeByKey) { - // 因为后台返回的字段与前端表单数据的prop不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 - Reflect.has(data, 'elderName') ? (data.name = data.elderName) : '' - Reflect.has(data, 'elderPhone') ? (data.phone = data.elderPhone) : '' + // 因为后台返回的字段与前端表单数据的 prop 不一样， + // 但是组件封装需要一样，所以请求前增加一些这两个字段 + // 如果 data 对象中有 'elderName' 字段，则将其值赋给 'name' 字段 + Reflect.has(data, 'elderName')? (data.name = data.elderName) : ''; + // 如果 data 对象中有 'elderPhone' 字段，则将其值赋给 'phone' 字段 + Reflect.has(data, 'elderPhone')? (data.phone = data.elderPhone) : ''; + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/depositRecharge/pageDepositRechargeByKey" + // 将处理后的 data 对象展开作为请求的参数 return http.get("/api/depositRecharge/pageDepositRechargeByKey", { params: { ...data @@ -26,16 +49,28 @@ export async function pageDepositRechargeByKey(data: IPageDepositRechargeByKey) }); } -// 分页搜索老人 +/** + * 定义一个函数 pageSearchElderByKey，用于分页搜索老人 + * @param data - 一个符合 IPageSearchElderByKey 接口的对象，包含搜索所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页搜索老人的响应结果 + */ export function pageSearchElderByKey(data: IPageSearchElderByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/depositRecharge/pageSearchElderByKey" + // 将 data 对象展开作为请求的参数 return http.get('/api/depositRecharge/pageSearchElderByKey', { params: { ...data } - }) + }); } -// 入住老人账户充值 +/** + * 定义一个函数 recharge，用于入住老人账户充值 + * @param data - 一个符合 IRecharge 接口的对象，包含充值所需的参数 + * @returns 一个 Promise 对象，解析后得到的是入住老人账户充值操作的响应结果 + */ export function recharge(data: IRecharge) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/depositRecharge/recharge" + // 将 data 对象作为请求的主体 return http.put("/api/depositRecharge/recharge", data); } diff --git a/client/src/apis/dishes.ts b/client/src/apis/dishes.ts index accd0c3..f647a4a 100644 --- a/client/src/apis/dishes.ts +++ b/client/src/apis/dishes.ts @@ -1,36 +1,60 @@ +// 从 "@/utils" 模块导入名为 http 的对象，该对象可能是用于发起 HTTP 请求的工具，比如对 axios 等请求库的封装 import { http } from "@/utils"; +// 定义一个接口 IListDishesType，用于描述获取菜品分类列表时的请求参数结构 interface IListDishesType { + // 菜品分类名称，用于筛选菜品分类列表，类型为字符串 dishesTypeName: string; } +// 导出一个接口 IPageDishesByKey，用于描述分页查询菜品时的请求参数结构 export interface IPageDishesByKey { + // 菜品名称，用于筛选菜品，类型为字符串 dishesName: string; + // 菜品类型 ID，用于筛选属于特定类型的菜品，类型为数字 typeId: number; } +// 定义一个接口 IAddDishesType，用于描述新增菜品分类时的数据结构 interface IAddDishesType { + // 菜品分类的 ID，类型为数字 id: number; + // 菜品分类的名称，类型为字符串 name: string; } +// 定义一个接口 IGetDishesTypeById，用于描述根据编号获取菜品分类时的请求参数结构 interface IGetDishesTypeById { + // 菜品分类 ID，类型为字符串 dishesTypeId: string; } +// 定义一个接口 IAddDishes，用于描述新增菜品时的数据结构 interface IAddDishes { + // 菜品的 ID，类型为数字 id: number; + // 菜品的名称，类型为字符串 name: string; + // 菜品的价格，类型为字符串 price: string; + // 菜品所属类型的 ID，类型为数字 typeId: number; } +// 导出一个接口 IGetDishesById，用于描述根据编号获取菜品时的请求参数结构 export interface IGetDishesById { + // 菜品 ID，类型为字符串 dishesId: string; } -// 获取菜品分类列表 +/** + * 定义一个异步函数 listDishesType，用于获取菜品分类列表 + * @param data - 一个符合 IListDishesType 接口的对象，包含获取菜品分类列表所需的参数 + * @returns 一个 Promise 对象，解析后得到的是获取菜品分类列表的响应结果 + */ export async function listDishesType(data: IListDishesType) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/dishes/listDishesType" + // 将 data 对象展开作为请求的参数 return http.get("/api/dishes/listDishesType", { params: { ...data @@ -38,8 +62,14 @@ export async function listDishesType(data: IListDishesType) { }); } -// 分页查询菜品 +/** + * 定义一个异步函数 pageDishesByKey，用于分页查询菜品 + * @param data - 一个符合 IPageDishesByKey 接口的对象，包含分页查询菜品所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询菜品的响应结果 + */ export async function pageDishesByKey(data: IPageDishesByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/dishes/pageDishesByKey" + // 将 data 对象展开作为请求的参数 return http.get("/api/dishes/pageDishesByKey", { params: { ...data @@ -47,13 +77,25 @@ export async function pageDishesByKey(data: IPageDishesByKey) { }); } -// 新增菜品分类 +/** + * 定义一个函数 addDishesType，用于新增菜品分类 + * @param data - 一个符合 IAddDishesType 接口的对象，包含新增菜品分类所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增菜品分类操作的响应结果 + */ export function addDishesType(data: IAddDishesType) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/dishes/addDishesType" + // 将 data 对象作为请求的主体 return http.post("/api/dishes/addDishesType", data); } -// 根据编号获取菜品分类 +/** + * 定义一个异步函数 getDishesTypeById，用于根据编号获取菜品分类 + * @param data - 一个符合 IGetDishesTypeById 接口的对象，包含根据编号获取菜品分类所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号获取菜品分类的响应结果 + */ export async function getDishesTypeById(data: IGetDishesTypeById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/dishes/getDishesTypeById" + // 将 data 对象展开作为请求的参数 return http.get("/api/dishes/getDishesTypeById", { params: { ...data @@ -61,13 +103,25 @@ export async function getDishesTypeById(data: IGetDishesTypeById) { }); } -// 编辑菜品分类 +/** + * 定义一个函数 editDishesType，用于编辑菜品分类 + * @param data - 一个符合 IAddDishesType 接口的对象，包含编辑菜品分类所需的数据 + * @returns 一个 Promise 对象，解析后得到的是编辑菜品分类操作的响应结果 + */ export function editDishesType(data: IAddDishesType) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/dishes/editDishesType" + // 将 data 对象作为请求的主体 return http.put("/api/dishes/editDishesType", data); } -// 删除菜品分类 +/** + * 定义一个异步函数 deleteDishesType，用于删除菜品分类 + * @param data - 一个符合 IGetDishesTypeById 接口的对象，包含删除菜品分类所需的参数 + * @returns 一个 Promise 对象，解析后得到的是删除菜品分类操作的响应结果 + */ export async function deleteDishesType(data: IGetDishesTypeById) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 "/api/dishes/deleteDishesType" + // 将 data 对象展开作为请求的参数 return http.delete("/api/dishes/deleteDishesType", { params: { ...data @@ -75,13 +129,25 @@ export async function deleteDishesType(data: IGetDishesTypeById) { }); } -// 新增菜品 +/** + * 定义一个函数 addDishes，用于新增菜品 + * @param data - 一个符合 IAddDishes 接口的对象，包含新增菜品所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增菜品操作的响应结果 + */ export function addDishes(data: IAddDishes) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/dishes/addDishes" + // 将 data 对象作为请求的主体 return http.post("/api/dishes/addDishes", data); } -// 根据编号获取菜品 +/** + * 定义一个异步函数 getDishesById，用于根据编号获取菜品 + * @param data - 一个符合 IGetDishesById 接口的对象，包含根据编号获取菜品所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号获取菜品的响应结果 + */ export async function getDishesById(data: IGetDishesById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/dishes/getDishesById" + // 将 data 对象展开作为请求的参数 return http.get("/api/dishes/getDishesById", { params: { ...data @@ -89,13 +155,25 @@ export async function getDishesById(data: IGetDishesById) { }); } -// 编辑菜品 +/** + * 定义一个函数 editDishes，用于编辑菜品 + * @param data - 一个符合 IAddDishes 接口的对象，包含编辑菜品所需的数据 + * @returns 一个 Promise 对象，解析后得到的是编辑菜品操作的响应结果 + */ export function editDishes(data: IAddDishes) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/dishes/editDishes" + // 将 data 对象作为请求的主体 return http.put("/api/dishes/editDishes", data); } -// 删除菜品 +/** + * 定义一个异步函数 deleteDishes，用于删除菜品 + * @param data - 一个符合 IGetDishesById 接口的对象，包含删除菜品所需的参数 + * @returns 一个 Promise 对象，解析后得到的是删除菜品操作的响应结果 + */ export async function deleteDishes(data: IGetDishesById) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 "/api/dishes/deleteDishes" + // 将 data 对象展开作为请求的参数 return http.delete("/api/dishes/deleteDishes", { params: { ...data diff --git a/client/src/apis/elderRecord.ts b/client/src/apis/elderRecord.ts index 6ae94ae..ead9262 100644 --- a/client/src/apis/elderRecord.ts +++ b/client/src/apis/elderRecord.ts @@ -1,43 +1,72 @@ +// 从 "@/utils" 模块导入名为 http 的对象，该对象可能是对 HTTP 请求库（如 axios）的封装，用于发起各种 HTTP 请求 import { http } from "@/utils"; +// 定义一个接口 IPageElderByKey，用于描述分页查询员工（这里可能是长者相关，名称可能有误）时的请求参数结构 interface IPageElderByKey { + // 姓名，用于筛选，类型为字符串 name: string; + // 长者姓名，用于筛选，类型为字符串 elderName: string; + // 身份证号码，用于筛选，类型为字符串 idNum: string; + // 性别，用于筛选，类型为字符串 sex: string; + // 长者性别，用于筛选，类型为字符串 elderSex: string; } +// 定义一个接口 IGetElderById，用于描述根据编号获取长者信息时的请求参数结构 interface IGetElderById { + // 长者 ID，类型为字符串 elderId: string; } +// 定义一个接口 IEditElder，用于描述编辑长者信息时的数据结构 interface IEditElder { + // 长者 ID，类型为数字 id: number; + // 姓名，类型为字符串 name: string; + // 身份证号码，类型为字符串 idNum: string; + // 年龄，类型为数字 age: number; + // 性别，类型为字符串 sex: string; + // 电话号码，类型为字符串 phone: string; + // 地址，类型为字符串 address: string; } -// 性别 +// 定义一个名为 sexList 的常量，是一个包含性别选项的数组，每个选项有标签和对应的值 export const sexList = [ { label: "男", value: "男" }, { label: "女", value: "女" } ]; -// 导出excel +/** + * 定义一个函数 exportExcel，用于导出 Excel 文件 + * @returns 一个 Promise 对象，解析后得到的是导出 Excel 文件操作的响应结果 + */ export function exportExcel() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/elderRecord/exportExcel" return http.get("/api/elderRecord/exportExcel"); } -// 分页查询员工 +/** + * 定义一个异步函数 pageElderByKey，用于分页查询员工（长者） + * @param data - 一个符合 IPageElderByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询的响应结果 + */ export async function pageElderByKey(data: IPageElderByKey) { - // 因为后台返回的字段与前端表单数据的prop不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 - Reflect.has(data, "sex") ? (data.elderSex = data.sex) : ""; - Reflect.has(data, "name") ? (data.elderName = data.name) : ""; + // 因为后台返回的字段与前端表单数据的 prop 不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 + // 如果 data 对象中有 "sex" 字段，则将其值赋给 "elderSex" 字段 + Reflect.has(data, "sex")? (data.elderSex = data.sex) : ""; + // 如果 data 对象中有 "name" 字段，则将其值赋给 "elderName" 字段 + Reflect.has(data, "name")? (data.elderName = data.name) : ""; + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/elderRecord/pageElderByKey" + // 将处理后的 data 对象展开作为请求的参数 return http.get("/api/elderRecord/pageElderByKey", { params: { ...data @@ -45,8 +74,14 @@ export async function pageElderByKey(data: IPageElderByKey) { }); } -// 根据编号获取长者信息 +/** + * 定义一个异步函数 getElderById，用于根据编号获取长者信息 + * @param data - 一个符合 IGetElderById 接口的对象，包含根据编号获取长者信息所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号获取长者信息的响应结果 + */ export async function getElderById(data: IGetElderById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/elderRecord/getElderById" + // 将 data 对象展开作为请求的参数 return http.get("/api/elderRecord/getElderById", { params: { ...data @@ -54,8 +89,14 @@ export async function getElderById(data: IGetElderById) { }); } -// 根据编号获取长者档案 +/** + * 定义一个异步函数 getElderRecordById，用于根据编号获取长者档案 + * @param data - 一个符合 IGetElderById 接口的对象，包含根据编号获取长者档案所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号获取长者档案的响应结果 + */ export async function getElderRecordById(data: IGetElderById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/elderRecord/getElderRecordById" + // 将 data 对象展开作为请求的参数 return http.get("/api/elderRecord/getElderRecordById", { params: { ...data @@ -63,13 +104,25 @@ export async function getElderRecordById(data: IGetElderById) { }); } -// 编辑长者 +/** + * 定义一个函数 editElder，用于编辑长者信息 + * @param data - 一个符合 IEditElder 接口的对象，包含编辑长者信息所需的数据 + * @returns 一个 Promise 对象，解析后得到的是编辑长者信息操作的响应结果 + */ export function editElder(data: IEditElder) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/elderRecord/editElder" + // 将 data 对象作为请求的主体 return http.put("/api/elderRecord/editElder", data); } -// 删除长者 +/** + * 定义一个异步函数 deleteElder，用于删除长者 + * @param data - 一个符合 IGetElderById 接口的对象，包含删除长者所需的参数 + * @returns 一个 Promise 对象，解析后得到的是删除长者操作的响应结果 + */ export async function deleteElder(data: IGetElderById) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 "/api/elderRecord/deleteElder" + // 将 data 对象展开作为请求的参数 return http.delete("/api/elderRecord/deleteElder", { params: { ...data diff --git a/client/src/apis/home.ts b/client/src/apis/home.ts index 501dc4e..bdd99c2 100644 --- a/client/src/apis/home.ts +++ b/client/src/apis/home.ts @@ -1,25 +1,56 @@ +// 从 '@/utils' 模块导入名为 http 的对象，该对象可能是用于发起 HTTP 请求的工具，比如对 axios 等请求库的封装 import { http } from '@/utils' -// 可售床位 + +/** + * 定义一个异步函数 getAvailableBed，用于获取可售床位信息 + * @returns 一个 Promise 对象，解析后得到的是获取可售床位信息的响应结果 + */ export async function getAvailableBed() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/home/availableBed' return http.get('/api/home/availableBed') } -// 业务趋势 + +/** + * 定义一个异步函数 getBusinessTrend，用于获取业务趋势信息 + * @returns 一个 Promise 对象，解析后得到的是获取业务趋势信息的响应结果 + */ export async function getBusinessTrend() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/home/businessTrend' return http.get('/api/home/businessTrend') } -// 客户来源渠道 + +/** + * 定义一个异步函数 getClientSource，用于获取客户来源渠道信息 + * @returns 一个 Promise 对象，解析后得到的是获取客户来源渠道信息的响应结果 + */ export async function getClientSource() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/home/clientSource' return http.get('/api/home/clientSource') } -// 本月业绩排行 + +/** + * 定义一个异步函数 getMonthPerformanceRank，用于获取本月业绩排行信息 + * @returns 一个 Promise 对象，解析后得到的是获取本月业绩排行信息的响应结果 + */ export async function getMonthPerformanceRank() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/home/monthPerformanceRank' return http.get('/api/home/monthPerformanceRank') } -// 今日概览 + +/** + * 定义一个异步函数 getTodayOverview，用于获取今日概览信息 + * @returns 一个 Promise 对象，解析后得到的是获取今日概览信息的响应结果 + */ export async function getTodayOverview() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/home/todayOverview' return http.get('/api/home/todayOverview') } -// 今日销售跟进 + +/** + * 定义一个异步函数 getTodaySaleFollow，用于获取今日销售跟进信息 + * @returns 一个 Promise 对象，解析后得到的是获取今日销售跟进信息的响应结果 + */ export async function getTodaySaleFollow() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/home/todaySaleFollow' return http.get('/api/home/todaySaleFollow') } diff --git a/client/src/apis/index.ts b/client/src/apis/index.ts index 067f355..9c44323 100644 --- a/client/src/apis/index.ts +++ b/client/src/apis/index.ts @@ -1,16 +1,29 @@ +// 注释说明这是动态路由的假数据，并且提示该部分代码可以删除 // 动态路由的假数据 可删除 +// 从 '@/utils' 模块导入名为 http 的对象， +// 推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 import { http } from '@/utils' +// 注释说明发起请求的时机：在动态设置路由的时候（data => 树形结构 => 路由列表） // 问题：何时发起请求？ 在动态设置路由的时候（data => 树形结构 => 路由列表） +/** + * 定义一个函数 getUserRouteList，用于获取用户的路由列表 + * @param uid - 用户 ID，类型为数字，用于作为请求参数来获取对应用户的路由列表 + * @returns 一个 Promise 对象，解析后得到的是获取到的用户路由列表数据（成功时），或者在失败时抛出错误 + */ function getUserRouteList(uid: number) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 '/api/user_router_list'，请求体包含用户 ID return http .post('/api/user_router_list', { uid }) + // 处理请求成功的情况，直接返回请求得到的数据 .then((data) => data) + // 处理请求失败的情况，捕获错误并重新抛出，以便上层调用者处理 .catch((err) => { throw err }) } +// 导出 getUserRouteList 函数，以便在其他模块中可以导入和使用该函数 export { getUserRouteList } diff --git a/client/src/apis/nurseGrade.ts b/client/src/apis/nurseGrade.ts index b215ea8..0bd92a7 100644 --- a/client/src/apis/nurseGrade.ts +++ b/client/src/apis/nurseGrade.ts @@ -1,37 +1,64 @@ +// 从 "@/utils" 模块导入名为 http 的对象， +// 推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 import { http } from "@/utils"; + +// 从 "@/apis/service" 模块导入 IPageServiceByKey 接口， +// 用于描述分页查询服务时的请求参数结构 import { IPageServiceByKey } from "@/apis/service"; +// 定义一个接口 IPageNurseGradeByKey，用于描述分页查询护理等级时的请求参数结构 interface IPageNurseGradeByKey { - name:string; + // 名称，用于筛选护理等级，类型为字符串 + name: string; + // 护理等级名称，用于筛选护理等级，类型为字符串 gradeName: string; - type:string; + // 类型，用于筛选护理等级，类型为字符串 + type: string; + // 护理类型，用于筛选护理等级，类型为字符串 nurseType: string; } +// 定义一个接口 IAddNurseGrade，用于描述新增护理等级时的数据结构 interface IAddNurseGrade { + // 护理等级的 ID，类型为数字 id: number; + // 护理等级的名称，类型为字符串 name: string; + // 护理等级的类型，类型为字符串 type: string; + // 护理等级的月价格，类型为数字 monthPrice: number; - serviceIdList: any ; + // 服务 ID 列表，类型为 any，需根据实际情况调整 + serviceIdList: any; } +// 定义一个接口 IGetNurseGradeById，用于描述根据编号查询护理等级时的请求参数结构 interface IGetNurseGradeById { - nurseGradeId: string + // 护理等级 ID，类型为字符串 + nurseGradeId: string; } -// 护理类型 +// 定义一个名为 INurseTypeList 的常量，是一个包含护理类型选项的数组，每个选项有标签和对应的值 export const INurseTypeList = [ { label: "自理", value: "自理" }, { label: "介护", value: "介护" }, { label: "全护", value: "全护" } ]; -// 分页查询护理等级 +/** + * 定义一个异步函数 pageNurseGradeByKey，用于分页查询护理等级 + * @param data - 一个符合 IPageNurseGradeByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询护理等级的响应结果 + */ export async function pageNurseGradeByKey(data: IPageNurseGradeByKey) { - // 因为后台返回的字段与前端表单数据的prop不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 - Reflect.has(data, 'name') ? (data.gradeName = data.name) : '' - Reflect.has(data, 'type') ? (data.nurseType = data.type) : '' + // 因为后台返回的字段与前端表单数据的 prop 不一样， + // 但是组件封装需要一样，所以请求前增加一些这两个字段 + // 如果 data 对象中有 'name' 字段，则将其值赋给 'gradeName' 字段 + Reflect.has(data, 'name')? (data.gradeName = data.name) : ''; + // 如果 data 对象中有 'type' 字段，则将其值赋给 'nurseType' 字段 + Reflect.has(data, 'type')? (data.nurseType = data.type) : ''; + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/nurseGrade/pageNurseGradeByKey" + // 将处理后的 data 对象展开作为请求的参数 return http.get("/api/nurseGrade/pageNurseGradeByKey", { params: { ...data @@ -39,13 +66,23 @@ export async function pageNurseGradeByKey(data: IPageNurseGradeByKey) { }); } -// 获取服务类型 +/** + * 定义一个函数 listServiceType，用于获取服务类型 + * @returns 一个 Promise 对象，解析后得到的是获取服务类型的响应结果 + */ export function listServiceType() { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/nurseGrade/listServiceType" return http.post("/api/nurseGrade/listServiceType"); } -// 分页查询服务 +/** + * 定义一个异步函数 pageServiceByKey，用于分页查询服务 + * @param data - 一个符合 IPageServiceByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询服务的响应结果 + */ export async function pageServiceByKey(data: IPageServiceByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/nurseGrade/pageServiceByKey" + // 将 data 对象展开作为请求的参数 return http.get("/api/nurseGrade/pageServiceByKey", { params: { ...data @@ -53,13 +90,25 @@ export async function pageServiceByKey(data: IPageServiceByKey) { }); } -// 新增护理等级 +/** + * 定义一个函数 addNurseGrade，用于新增护理等级 + * @param data - 一个符合 IAddNurseGrade 接口的对象，包含新增护理等级所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增护理等级操作的响应结果 + */ export function addNurseGrade(data: IAddNurseGrade) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/nurseGrade/addNurseGrade" + // 将 data 对象作为请求的主体 return http.post("/api/nurseGrade/addNurseGrade", data); } -// 根据编号查询护理等级 +/** + * 定义一个异步函数 getNurseGradeById，用于根据编号查询护理等级 + * @param data - 一个符合 IGetNurseGradeById 接口的对象，包含根据编号查询护理等级所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号查询护理等级的响应结果 + */ export async function getNurseGradeById(data: IGetNurseGradeById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/nurseGrade/getNurseGradeById" + // 将 data 对象展开作为请求的参数 return http.get("/api/nurseGrade/getNurseGradeById", { params: { ...data @@ -67,13 +116,25 @@ export async function getNurseGradeById(data: IGetNurseGradeById) { }); } -// 编辑护理等级 +/** + * 定义一个函数 editNurseGrade，用于编辑护理等级 + * @param data - 一个符合 IAddNurseGrade 接口的对象，包含编辑护理等级所需的数据 + * @returns 一个 Promise 对象，解析后得到的是编辑护理等级操作的响应结果 + */ export function editNurseGrade(data: IAddNurseGrade) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/nurseGrade/editNurseGrade" + // 将 data 对象作为请求的主体 return http.put("/api/nurseGrade/editNurseGrade", data); } -// 删除护理等级 +/** + * 定义一个异步函数 deleteNurseGrade，用于删除护理等级 + * @param data - 一个符合 IGetNurseGradeById 接口的对象，包含删除护理等级所需的参数 + * @returns 一个 Promise 对象，解析后得到的是删除护理等级操作的响应结果 + */ export async function deleteNurseGrade(data: IGetNurseGradeById) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 "/api/nurseGrade/deleteNurseGrade" + // 将 data 对象展开作为请求的参数 return http.delete("/api/nurseGrade/deleteNurseGrade", { params: { ...data diff --git a/client/src/apis/nurseReserve.ts b/client/src/apis/nurseReserve.ts index 93337fa..bb31b28 100644 --- a/client/src/apis/nurseReserve.ts +++ b/client/src/apis/nurseReserve.ts @@ -1,34 +1,64 @@ +// 从 "@/utils" 模块导入名为 http 的对象， +// 推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 import { http } from "@/utils"; +// 从 "@/apis/bookManage" 模块导入 IPageSearchElderByKey 接口， +// 用于描述分页搜索老人时的请求参数结构 import { IPageSearchElderByKey } from "@/apis/bookManage"; +// 从 "@/apis/service" 模块导入 IGetServiceById 接口， +// 用于描述根据编号查询服务时的请求参数结构 import { IGetServiceById } from "@/apis/service"; +// 定义一个接口 IPageNurseReserveByKey，用于描述分页查询护理预定时的请求参数结构 interface IPageNurseReserveByKey { + // 床位名称，用于筛选护理预定记录，类型为字符串 bedName: string; - elderName:string; + // 老人姓名，用于筛选护理预定记录，类型为字符串 + elderName: string; + // 服务名称，用于筛选护理预定记录，类型为字符串 serviceName: string; } +// 定义一个接口 IAddNurseReserve，用于描述新增护理预定时的数据结构 interface IAddNurseReserve { + // 老人 ID，类型为数字 elderId: number; + // 服务名称，类型为字符串 serviceName: string; + // 需要服务的日期（这里推测为时间戳等能表示日期的值，类型为数字） needDate: number; + // 服务价格，类型为数字 servicePrice: number; + // 收费方式，类型为字符串 chargeMethod: string; + // 频率，类型为数字 frequency: number; + // 支付金额，类型为数字 payAmount: number; } +// 定义一个接口 IExecuteNurseReserve，用于描述执行护理预定时的数据结构 interface IExecuteNurseReserve { + // 护理预定的 ID，类型为数字 id: number; + // 护理日期，类型为字符串 nurseDate: string; + // 护理人员 ID，类型为字符串 staffId: string; } -// 分页查询护理预定 +/** + * 定义一个异步函数 pageNurseReserveByKey，用于分页查询护理预定 + * @param data - 一个符合 IPageNurseReserveByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询护理预定的响应结果 + */ export async function pageNurseReserveByKey(data: IPageNurseReserveByKey) { - // 因为后台返回的字段与前端表单数据的prop不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 - // Reflect.has(data, 'name') ? (data.gradeName = data.name) : '' - // Reflect.has(data, 'type') ? (data.nurseType = data.type) : '' + // 因为后台返回的字段与前端表单数据的 prop 不一样， + // 但是组件封装需要一样，所以原本计划请求前处理某些字段， + // 但这里代码被注释掉了，可能是暂不处理或有其他调整 + // Reflect.has(data, 'name')? (data.gradeName = data.name) : '' + // Reflect.has(data, 'type')? (data.nurseType = data.type) : '' + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/nurseReserve/pageNurseReserveByKey" + // 将 data 对象展开作为请求的参数 return http.get("/api/nurseReserve/pageNurseReserveByKey", { params: { ...data @@ -36,27 +66,49 @@ export async function pageNurseReserveByKey(data: IPageNurseReserveByKey) { }); } -// 分页搜索老人 +/** + * 定义一个函数 pageSearchElderByKey，用于分页搜索老人 + * @param data - 一个符合 IPageSearchElderByKey 接口的对象，包含搜索所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页搜索老人的响应结果 + */ export function pageSearchElderByKey(data: IPageSearchElderByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/nurseReserve/pageSearchElderByKey" + // 将 data 对象展开作为请求的参数 return http.get('/api/nurseReserve/pageSearchElderByKey', { params: { ...data } - }) + }); } -// 获取服务项目 +/** + * 定义一个异步函数 listService，用于获取服务项目 + * @returns 一个 Promise 对象，解析后得到的是获取服务项目的响应结果 + */ export async function listService() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/nurseReserve/listService" return http.get("/api/nurseReserve/listService"); } -// 新增护理预定 +/** + * 定义一个函数 addNurseReserve，用于新增护理预定 + * @param data - 一个符合 IAddNurseReserve 接口的对象，包含新增护理预定所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增护理预定操作的响应结果 + */ export function addNurseReserve(data: IAddNurseReserve) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/nurseReserve/addNurseReserve" + // 将 data 对象作为请求的主体 return http.post("/api/nurseReserve/addNurseReserve", data); } -// 根据编号查询护理预定 +/** + * 定义一个异步函数 getServiceById，用于根据编号查询服务（这里实际是护理预定相关服务） + * @param data - 一个符合 IGetServiceById 接口的对象，包含根据编号查询服务所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号查询服务的响应结果 + */ export async function getServiceById(data: IGetServiceById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/nurseReserve/getServiceById" + // 将 data 对象展开作为请求的参数 return http.get("/api/nurseReserve/getServiceById", { params: { ...data @@ -64,12 +116,22 @@ export async function getServiceById(data: IGetServiceById) { }); } -// 护理人员 +/** + * 定义一个异步函数 listNurseStaff，用于获取护理人员列表 + * @returns 一个 Promise 对象，解析后得到的是获取护理人员列表的响应结果 + */ export async function listNurseStaff() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/nurseReserve/listNurseStaff" return http.get("/api/nurseReserve/listNurseStaff"); } -// 执行护理预定 +/** + * 定义一个函数 executeNurseReserve，用于执行护理预定 + * @param data - 一个符合 IExecuteNurseReserve 接口的对象，包含执行护理预定所需的数据 + * @returns 一个 Promise 对象，解析后得到的是执行护理预定操作的响应结果 + */ export function executeNurseReserve(data: IExecuteNurseReserve) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/nurseReserve/executeNurseReserve" + // 将 data 对象作为请求的主体 return http.put("/api/nurseReserve/executeNurseReserve", data); } diff --git a/client/src/apis/order.ts b/client/src/apis/order.ts index 5c3a7a5..e98f9dd 100644 --- a/client/src/apis/order.ts +++ b/client/src/apis/order.ts @@ -1,40 +1,70 @@ +// 从 "@/utils" 模块导入名为 http 的对象， +// 推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 import { http } from "@/utils"; + +// 从 "@/apis/bookManage" 模块导入 IPageSearchElderByKey 接口， +// 用于描述分页搜索老人时的请求参数结构 import { IPageSearchElderByKey } from "@/apis/bookManage"; + +// 从 "@/apis/dishes" 模块导入 IPageDishesByKey 接口， +// 用于描述分页查询菜品时的请求参数结构 import { IPageDishesByKey } from "@/apis/dishes"; +// 定义一个接口 IPageOrderByKey，用于描述分页查询点餐时的请求参数结构 interface IPageOrderByKey { - elderName:string; + // 老人姓名，用于筛选点餐记录，类型为字符串 + elderName: string; + // 老人电话，用于筛选点餐记录，类型为字符串 elderPhone: string; } +// 定义一个接口 IAddOrder，用于描述新增点餐时的数据结构 interface IAddOrder { + // 老人 ID，类型为字符串 elderId: string; + // 就餐方式，类型为字符串 dineType: string; + // 就餐日期，类型为字符串 dineDate: string; + // 点的菜品列表，类型为 any，需根据实际情况调整 orderDishesList: any; } +// 定义一个接口 IGetOrderById，用于描述根据编号查询点餐时的请求参数结构 interface IGetOrderById { + // 菜品 ID，这里可能是点餐记录中的菜品 ID，用于查询特定点餐记录，类型为字符串 dishesId: string; } +// 定义一个接口 ISendOrder，用于描述送餐时的数据结构 interface ISendOrder { + // 订单 ID，类型为字符串 id: string; + // 送餐日期，类型为字符串 deliverDishesDate: string; + // 送餐人员 ID，类型为字符串 staffId: string; } -// 就餐方式 +// 定义一个名为 IDineTypeList 的常量，是一个包含就餐方式选项的数组，每个选项有标签和对应的值 export const IDineTypeList = [ { label: "送餐", value: "送餐" }, { label: "堂食", value: "堂食" } ]; -// 分页查询点餐 +/** + * 定义一个异步函数 pageOrderByKey，用于分页查询点餐 + * @param data - 一个符合 IPageOrderByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询点餐的响应结果 + */ export async function pageOrderByKey(data: IPageOrderByKey) { - // 因为后台返回的字段与前端表单数据的prop不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 - // Reflect.has(data, 'name') ? (data.gradeName = data.name) : '' - // Reflect.has(data, 'type') ? (data.nurseType = data.type) : '' + // 因为后台返回的字段与前端表单数据的 prop 不一样， + // 但是组件封装需要一样，所以原本计划请求前处理某些字段， + // 但这里代码被注释掉了，可能是暂不处理或有其他调整 + // Reflect.has(data, 'name')? (data.gradeName = data.name) : '' + // Reflect.has(data, 'type')? (data.nurseType = data.type) : '' + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/order/pageOrderByKey" + // 将 data 对象展开作为请求的参数 return http.get("/api/order/pageOrderByKey", { params: { ...data @@ -42,31 +72,55 @@ export async function pageOrderByKey(data: IPageOrderByKey) { }); } -// 分页搜索老人 +/** + * 定义一个函数 pageSearchElderByKey，用于分页搜索老人 + * @param data - 一个符合 IPageSearchElderByKey 接口的对象，包含搜索所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页搜索老人的响应结果 + */ export function pageSearchElderByKey(data: IPageSearchElderByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/order/pageSearchElderByKey" + // 将 data 对象展开作为请求的参数 return http.get('/api/order/pageSearchElderByKey', { params: { ...data } - }) + }); } -// 分页查询菜品 +/** + * 定义一个异步函数 pageDishesByKey，用于分页查询菜品（这里是在点餐相关模块中查询菜品） + * @param data - 一个符合 IPageDishesByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询菜品的响应结果 + */ export async function pageDishesByKey(data: IPageDishesByKey) { - return http.get("/api/order/pageDishesByKey",{ - params:{ + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/order/pageDishesByKey" + // 将 data 对象展开作为请求的参数 + return http.get("/api/order/pageDishesByKey", { + params: { ...data } }); } -// 新增点餐 +/** + * 定义一个函数 addOrder，用于新增点餐 + * @param data - 一个符合 IAddOrder 接口的对象，包含新增点餐所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增点餐操作的响应结果 + */ export function addOrder(data: IAddOrder) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/order/addOrder" + // 将 data 对象作为请求的主体 return http.post("/api/order/addOrder", data); } -// 根据编号查询点餐 +/** + * 定义一个异步函数 getOrderById，用于根据编号查询点餐 + * @param data - 一个符合 IGetOrderById 接口的对象，包含根据编号查询点餐所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号查询点餐的响应结果 + */ export async function getOrderById(data: IGetOrderById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/order/getOrderById" + // 将 data 对象展开作为请求的参数 return http.get("/api/order/getOrderById", { params: { ...data @@ -74,12 +128,22 @@ export async function getOrderById(data: IGetOrderById) { }); } -// 护理人员 +/** + * 定义一个异步函数 listNurseStaff，用于获取护理人员列表（这里在点餐模块中获取护理人员列表，可能与业务逻辑有关） + * @returns 一个 Promise 对象，解析后得到的是获取护理人员列表的响应结果 + */ export async function listNurseStaff() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/order/listNurseStaff" return http.get("/api/order/listNurseStaff"); } -// 送餐 +/** + * 定义一个函数 sendOrder，用于送餐 + * @param data - 一个符合 ISendOrder 接口的对象，包含送餐所需的数据 + * @returns 一个 Promise 对象，解析后得到的是送餐操作的响应结果 + */ export function sendOrder(data: ISendOrder) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/order/sendOrder" + // 将 data 对象作为请求的主体 return http.put("/api/order/sendOrder", data); } diff --git a/client/src/apis/outward.ts b/client/src/apis/outward.ts index 066b898..1d4e858 100644 --- a/client/src/apis/outward.ts +++ b/client/src/apis/outward.ts @@ -1,48 +1,77 @@ +// 从 "@/utils" 模块导入名为 http 的对象，该对象可用于发起 HTTP 请求，可能是对 axios 等请求库的封装 import { http } from "@/utils"; +// 从 "@/apis/bookManage" 模块导入 IPageSearchElderByKey 接口，此接口用于定义分页搜索老人时的请求参数结构 import { IPageSearchElderByKey } from "@/apis/bookManage"; +// 定义 IPageOutwardByKey 接口，用于描述分页查询外出登记时的请求参数结构 interface IPageOutwardByKey { + // 老人姓名，用于筛选外出登记记录，类型为字符串 elderName: string; + // 陪同人类型，用于筛选外出登记记录，类型为字符串 chaperoneType: string; + // 外出开始时间，用于筛选外出登记记录，类型为字符串 startTime: string; + // 外出结束时间，用于筛选外出登记记录，类型为字符串 endTime: string; } +// 定义 IListContactByElderId 接口，用于描述根据老人 ID 获取紧急联系人列表时的请求参数结构 interface IListContactByElderId { + // 老人 ID，类型为字符串 elderId: string; } +// 定义 IAddOutward 接口，用于描述新增外出登记时的数据结构 interface IAddOutward { + // 老人 ID，类型为数字 elderId: number; + // 陪同人姓名，类型为字符串 chaperoneName: string; + // 陪同人电话，类型为字符串 chaperonePhone: string; + // 陪同人类型，类型为字符串 chaperoneType: string; + // 外出日期，类型为字符串 outwardDate: string; + // 计划返回日期，类型为字符串 planReturnDate: string; } +// 定义 IGetOutwardById 接口，用于描述根据编号获取外出登记时的请求参数结构 interface IGetOutwardById { + // 外出登记 ID，类型为字符串 outwardId: string; } +// 定义 IDelayReturn 接口，用于描述延期返回操作时的数据结构 interface IDelayReturn { + // 外出登记 ID，类型为字符串 id: string; + // 新的计划返回日期，类型为字符串 planReturnDate: string; } +// 定义 IRecordReturn 接口，用于描述登记返回操作时的数据结构 interface IRecordReturn { + // 外出登记 ID，类型为字符串 id: string; + // 实际返回日期，类型为 any，具体类型需根据实际情况确定 realReturnDate: any; } -// 陪同人类型 +// 定义一个常量 typeList，包含陪同人类型的选项，每个选项有标签和对应的值 export const typeList = [ { label: "护工", value: "护工" }, { label: "家属", value: "家属" } ]; -// 分页查询外出登记 +/** + * 定义一个异步函数 pageOutwardByKey，用于分页查询外出登记 + * @param data - 一个符合 IPageOutwardByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询外出登记的响应结果 + */ export async function pageOutwardByKey(data: IPageOutwardByKey) { + // 使用 http 对象发起 GET 请求，请求地址为 "/api/outward/pageOutwardByKey"，并将 data 对象展开作为请求参数 return http.get("/api/outward/pageOutwardByKey", { params: { ...data @@ -50,8 +79,13 @@ export async function pageOutwardByKey(data: IPageOutwardByKey) { }); } -// 分页搜索老人 +/** + * 定义一个异步函数 pageSearchElderByKey，用于分页搜索老人 + * @param data - 一个符合 IPageSearchElderByKey 接口的对象，包含搜索所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页搜索老人的响应结果 + */ export async function pageSearchElderByKey(data: IPageSearchElderByKey) { + // 使用 http 对象发起 GET 请求，请求地址为 "/api/outward/pageSearchElderByKey"，并将 data 对象展开作为请求参数 return http.get("/api/outward/pageSearchElderByKey", { params: { ...data @@ -59,13 +93,22 @@ export async function pageSearchElderByKey(data: IPageSearchElderByKey) { }); } -// 获取护工列表 +/** + * 定义一个异步函数 listOutwardStaff，用于获取护工列表 + * @returns 一个 Promise 对象，解析后得到的是获取护工列表的响应结果 + */ export async function listOutwardStaff() { + // 使用 http 对象发起 GET 请求，请求地址为 "/api/outward/listOutwardStaff" return http.get("/api/outward/listOutwardStaff"); } -// 获取紧急联系人列表 +/** + * 定义一个异步函数 listContactByElderId，用于根据老人 ID 获取紧急联系人列表 + * @param data - 一个符合 IListContactByElderId 接口的对象，包含所需的老人 ID + * @returns 一个 Promise 对象，解析后得到的是获取紧急联系人列表的响应结果 + */ export async function listContactByElderId(data: IListContactByElderId) { + // 使用 http 对象发起 GET 请求，请求地址为 "/api/outward/listContactByElderId"，并将 data 对象展开作为请求参数 return http.get("/api/outward/listContactByElderId", { params: { ...data @@ -73,13 +116,23 @@ export async function listContactByElderId(data: IListContactByElderId) { }); } -// 新增外出登记 +/** + * 定义一个函数 addOutward，用于新增外出登记 + * @param data - 一个符合 IAddOutward 接口的对象，包含新增外出登记所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增外出登记操作的响应结果 + */ export function addOutward(data: IAddOutward) { + // 使用 http 对象发起 POST 请求，请求地址为 "/api/outward/addOutward"，并将 data 对象作为请求体 return http.post("/api/outward/addOutward", data); } -// 根据编号获取外出登记 +/** + * 定义一个异步函数 getOutwardById，用于根据编号获取外出登记 + * @param data - 一个符合 IGetOutwardById 接口的对象，包含所需的外出登记 ID + * @returns 一个 Promise 对象，解析后得到的是根据编号获取外出登记的响应结果 + */ export async function getOutwardById(data: IGetOutwardById) { + // 使用 http 对象发起 GET 请求，请求地址为 "/api/outward/getOutwardById"，并将 data 对象展开作为请求参数 return http.get("/api/outward/getOutwardById", { params: { ...data @@ -87,18 +140,33 @@ export async function getOutwardById(data: IGetOutwardById) { }); } -// 延期返回 +/** + * 定义一个函数 delayReturn，用于处理延期返回操作 + * @param data - 一个符合 IDelayReturn 接口的对象，包含延期返回所需的数据 + * @returns 一个 Promise 对象，解析后得到的是延期返回操作的响应结果 + */ export function delayReturn(data: IDelayReturn) { + // 使用 http 对象发起 PUT 请求，请求地址为 "/api/outward/delayReturn"，并将 data 对象作为请求体 return http.put("/api/outward/delayReturn", data); } -// 登记返回 +/** + * 定义一个函数 recordReturn，用于处理登记返回操作 + * @param data - 一个符合 IRecordReturn 接口的对象，包含登记返回所需的数据 + * @returns 一个 Promise 对象，解析后得到的是登记返回操作的响应结果 + */ export function recordReturn(data: IRecordReturn) { + // 使用 http 对象发起 PUT 请求，请求地址为 "/api/outward/recordReturn"，并将 data 对象作为请求体 return http.put("/api/outward/recordReturn", data); } -// 删除外出登记 +/** + * 定义一个异步函数 deleteOutward，用于删除外出登记 + * @param data - 一个符合 IGetOutwardById 接口的对象，包含要删除的外出登记 ID + * @returns 一个 Promise 对象，解析后得到的是删除外出登记操作的响应结果 + */ export async function deleteOutward(data: IGetOutwardById) { + // 使用 http 对象发起 DELETE 请求，请求地址为 "/api/outward/deleteOutward"，并将 data 对象展开作为请求参数 return http.delete("/api/outward/deleteOutward", { params: { ...data diff --git a/client/src/apis/retreatApply.ts b/client/src/apis/retreatApply.ts index 5aed87a..ed1724a 100644 --- a/client/src/apis/retreatApply.ts +++ b/client/src/apis/retreatApply.ts @@ -1,19 +1,37 @@ +// 从 "@/utils" 模块导入名为 http 的对象， +// 推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 import { http } from "@/utils"; + +// 从 "@/apis/bookManage" 模块导入 IPageSearchElderByKey 接口， +// 用于描述分页搜索老人时的请求参数结构 import { IPageSearchElderByKey } from "@/apis/bookManage"; +// 定义一个接口 IPageRetreatApplyByKey，用于描述分页查询退住申请时的请求参数结构 interface IPageRetreatApplyByKey { + // 床位名称，用于筛选退住申请记录，类型为字符串 bedName: string; + // 老人姓名，用于筛选退住申请记录，类型为字符串 elderName: string; + // 老人性别，用于筛选退住申请记录，类型为字符串 elderSex: string; + // 身份证号码，用于筛选退住申请记录，类型为字符串 idNum: string; } +// 定义一个接口 IAddRetreatApply，用于描述新增退住申请时的数据结构 interface IAddRetreatApply { + // 老人 ID，类型为数字，用于标识发起退住申请的老人 elderId: number; } -// 分页查询退住申请 +/** + * 定义一个异步函数 pageRetreatApplyByKey，用于分页查询退住申请 + * @param data - 一个符合 IPageRetreatApplyByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询退住申请的响应结果 + */ export async function pageRetreatApplyByKey(data: IPageRetreatApplyByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/retreatApply/pageRetreatApplyByKey" + // 将 data 对象展开作为请求的参数 return http.get("/api/retreatApply/pageRetreatApplyByKey", { params: { ...data @@ -21,8 +39,14 @@ export async function pageRetreatApplyByKey(data: IPageRetreatApplyByKey) { }); } -// 分页搜索老人 +/** + * 定义一个异步函数 pageSearchElderByKey，用于分页搜索老人 + * @param data - 一个符合 IPageSearchElderByKey 接口的对象，包含搜索所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页搜索老人的响应结果 + */ export async function pageSearchElderByKey(data: IPageSearchElderByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/retreatApply/pageSearchElderByKey" + // 将 data 对象展开作为请求的参数 return http.get("/api/retreatApply/pageSearchElderByKey", { params: { ...data @@ -30,7 +54,13 @@ export async function pageSearchElderByKey(data: IPageSearchElderByKey) { }); } -// 新增退住申请 +/** + * 定义一个函数 addRetreatApply，用于新增退住申请 + * @param data - 一个符合 IAddRetreatApply 接口的对象，包含新增退住申请所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增退住申请操作的响应结果 + */ export function addRetreatApply(data: IAddRetreatApply) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/retreatApply/addRetreatApply" + // 将 data 对象作为请求的主体 return http.post("/api/retreatApply/addRetreatApply", data); } diff --git a/client/src/apis/retreatAudit.ts b/client/src/apis/retreatAudit.ts index 2abb61d..79fe3ee 100644 --- a/client/src/apis/retreatAudit.ts +++ b/client/src/apis/retreatAudit.ts @@ -1,29 +1,46 @@ +// 从 "@/utils" 模块导入名为 http 的对象，该对象可能用于发起 HTTP 请求，例如对 axios 等请求库的封装 import { http } from "@/utils"; +// 定义一个接口 IPageRetreatAuditByKey，用于描述分页查询退住审核时的请求参数结构 interface IPageRetreatAuditByKey { + // 老人姓名，用于筛选退住审核记录，类型为字符串 elderName: string; + // 老人性别，用于筛选退住审核记录，类型为字符串 elderSex: string; + // 身份证号码，用于筛选退住审核记录，类型为字符串 idNum: string; } +// 定义一个接口 IGetElderFeeById，用于描述根据编号获取老人费用详情时的请求参数结构 interface IGetElderFeeById { + // 老人 ID，类型为数字，用于指定获取费用详情的老人 elderId: number; } +// 定义一个接口 IAuditElderFee，用于描述审核老人费用详情时的数据结构 interface IAuditElderFee { + // 申请 ID，类型为数字，用于标识退住申请 applyId: number; + // 老人 ID，类型为数字，用于关联老人 elderId: number; + // 审核结果，类型为数字，可能是枚举值（如 0 表示不通过，1 表示通过等） auditResult: number; } -// 审核结果 +// 定义一个常量 IAuditResultList，包含审核结果的选项，每个选项有标签和对应的值 export const IAuditResultList = [ { label: "通过", value: "通过" }, { label: "不通过", value: "不通过" } ]; -// 分页查询退住审核 +/** + * 定义一个异步函数 pageRetreatAuditByKey，用于分页查询退住审核 + * @param data - 一个符合 IPageRetreatAuditByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询退住审核的响应结果 + */ export async function pageRetreatAuditByKey(data: IPageRetreatAuditByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/retreatAudit/pageRetreatAuditByKey" + // 将 data 对象展开作为请求的参数 return http.get("/api/retreatAudit/pageRetreatAuditByKey", { params: { ...data @@ -31,8 +48,14 @@ export async function pageRetreatAuditByKey(data: IPageRetreatAuditByKey) { }); } -// 根据编号获取老人费用详情 +/** + * 定义一个异步函数 getElderFeeById，用于根据编号获取老人费用详情 + * @param data - 一个符合 IGetElderFeeById 接口的对象，包含根据编号获取老人费用详情所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号获取老人费用详情的响应结果 + */ export async function getElderFeeById(data: IGetElderFeeById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/retreatAudit/getElderFeeById" + // 将 data 对象展开作为请求的参数 return http.get("/api/retreatAudit/getElderFeeById", { params: { ...data @@ -40,7 +63,13 @@ export async function getElderFeeById(data: IGetElderFeeById) { }); } -// 审核老人费用详情 +/** + * 定义一个函数 auditElderFee，用于审核老人费用详情 + * @param data - 一个符合 IAuditElderFee 接口的对象，包含审核老人费用详情所需的数据 + * @returns 一个 Promise 对象，解析后得到的是审核老人费用详情操作的响应结果 + */ export function auditElderFee(data: IAuditElderFee) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/retreatAudit/auditElderFee" + // 将 data 对象作为请求的主体 return http.put("/api/retreatAudit/auditElderFee", data); } diff --git a/client/src/apis/roomType.ts b/client/src/apis/roomType.ts index 738f889..0458f2a 100644 --- a/client/src/apis/roomType.ts +++ b/client/src/apis/roomType.ts @@ -1,24 +1,42 @@ +// 从 "@/utils" 模块导入名为 http 的对象，该对象可能是用于发起 HTTP 请求的工具，比如对 axios 等请求库的封装 import { http } from "@/utils"; +// 定义一个接口 IPageRoomTypeByKey，用于描述分页查询房间类型时的请求参数结构 interface IPageRoomTypeByKey { + // 名称，用于筛选房间类型，类型为字符串 name: string; + // 房间类型名称，用于筛选房间类型，类型为字符串 roomTypeName: string; } +// 定义一个接口 IAddRoomType，用于描述新增房间类型时的数据结构 interface IAddRoomType { + // 房间类型的 ID，类型为字符串 id: string; + // 房间类型的名称，类型为字符串 name: string; + // 房间类型的月价格，类型为字符串 monthPrice: string; } +// 定义一个接口 IGetRoomTypeById，用于描述根据编号查询房间类型时的请求参数结构 interface IGetRoomTypeById { + // 房间类型 ID，类型为字符串 roomTypeId: string; } -// 分页查询房间类型 +/** + * 定义一个异步函数 pageRoomTypeByKey，用于分页查询房间类型 + * @param data - 一个符合 IPageRoomTypeByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询房间类型的响应结果 + */ export async function pageRoomTypeByKey(data: IPageRoomTypeByKey) { - // 因为后台返回的字段与前端表单数据的prop不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 - Reflect.has(data, "name") ? (data.roomTypeName = data.name) : ""; + // 因为后台返回的字段与前端表单数据的 prop 不一样， + // 但是组件封装需要一样，所以请求前增加一些这两个字段 + // 如果 data 对象中有 "name" 字段，则将其值赋给 "roomTypeName" 字段 + Reflect.has(data, "name")? (data.roomTypeName = data.name) : ""; + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/roomType/pageRoomTypeByKey" + // 将处理后的 data 对象展开作为请求的参数 return http.get("/api/roomType/pageRoomTypeByKey", { params: { ...data @@ -26,13 +44,25 @@ export async function pageRoomTypeByKey(data: IPageRoomTypeByKey) { }); } -// 新增房间类型 +/** + * 定义一个函数 addRoomType，用于新增房间类型 + * @param data - 一个符合 IAddRoomType 接口的对象，包含新增房间类型所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增房间类型操作的响应结果 + */ export function addRoomType(data: IAddRoomType) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/roomType/addRoomType" + // 将 data 对象作为请求的主体 return http.post("/api/roomType/addRoomType", data); } -// 根据编号查询房间类型 +/** + * 定义一个异步函数 getRoomTypeById，用于根据编号查询房间类型 + * @param data - 一个符合 IGetRoomTypeById 接口的对象，包含根据编号查询房间类型所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号查询房间类型的响应结果 + */ export async function getRoomTypeById(data: IGetRoomTypeById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/roomType/getRoomTypeById" + // 将 data 对象展开作为请求的参数 return http.get("/api/roomType/getRoomTypeById", { params: { ...data @@ -40,13 +70,25 @@ export async function getRoomTypeById(data: IGetRoomTypeById) { }); } -// 编辑房间类型 +/** + * 定义一个函数 editRoomType，用于编辑房间类型 + * @param data - 一个符合 IAddRoomType 接口的对象，包含编辑房间类型所需的数据 + * @returns 一个 Promise 对象，解析后得到的是编辑房间类型操作的响应结果 + */ export function editRoomType(data: IAddRoomType) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/roomType/editRoomType" + // 将 data 对象作为请求的主体 return http.put("/api/roomType/editRoomType", data); } -// 删除房间类型 +/** + * 定义一个异步函数 deleteRoomType，用于删除房间类型 + * @param data - 一个符合 IGetRoomTypeById 接口的对象，包含删除房间类型所需的参数 + * @returns 一个 Promise 对象，解析后得到的是删除房间类型操作的响应结果 + */ export async function deleteRoomType(data: IGetRoomTypeById) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 "/api/roomType/deleteRoomType" + // 将 data 对象展开作为请求的参数 return http.delete("/api/roomType/deleteRoomType", { params: { ...data diff --git a/client/src/apis/service.ts b/client/src/apis/service.ts index 067a33c..a115761 100644 --- a/client/src/apis/service.ts +++ b/client/src/apis/service.ts @@ -1,44 +1,70 @@ +// 从 "@/utils" 模块导入名为 http 的对象，推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 import { http } from "@/utils"; +// 定义一个接口 IGetServiceType，用于描述获取服务类型时的请求参数结构 interface IGetServiceType { + // 服务类型名称，用于筛选服务类型，类型为字符串 serviceTypeName: string; } +// 导出一个接口 IPageServiceByKey，用于描述分页查询服务时的请求参数结构 export interface IPageServiceByKey { + // 名称，用于筛选服务，类型为字符串 name: string; + // 服务类型 ID，用于筛选属于特定类型的服务，类型为数字 typeId: number; } +// 定义一个接口 IAddServiceType，用于描述新增服务类型时的数据结构 interface IAddServiceType { + // 服务类型的 ID，类型为数字 id: number; + // 服务类型的名称，类型为字符串 name: string; } +// 定义一个接口 IGetServiceTypeById，用于描述根据编号获取服务类型时的请求参数结构 interface IGetServiceTypeById { + // 服务类型 ID，类型为字符串 serviceTypeId: string; } +// 定义一个接口 IAddService，用于描述新增服务时的数据结构 interface IAddService { + // 服务的 ID，类型为数字 id: number; + // 服务的名称，类型为字符串 name: string; + // 服务所需日期，类型为字符串 needDate: string; + // 服务价格，类型为字符串 price: string; + // 服务所属类型的 ID，类型为数字 typeId: number; + // 收费方式，类型为字符串 chargeMethod: string; } +// 导出一个接口 IGetServiceById，用于描述根据编号获取服务时的请求参数结构 export interface IGetServiceById { + // 服务 ID，类型为字符串 serviceId: string; } -// 收费方式 +// 定义一个名为 IChargeMethodList 的常量，是一个包含收费方式选项的数组，每个选项有标签和对应的值 export const IChargeMethodList = [ { label: "按次", value: "按次" }, { label: "按月", value: "按月" } ]; -// 获取服务类型列表 +/** + * 定义一个异步函数 getServiceType，用于获取服务类型列表 + * @param data - 一个符合 IGetServiceType 接口的对象，包含获取服务类型列表所需的参数 + * @returns 一个 Promise 对象，解析后得到的是获取服务类型列表的响应结果 + */ export async function getServiceType(data: IGetServiceType) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/service/getServiceType" + // 将 data 对象展开作为请求的参数 return http.get("/api/service/getServiceType", { params: { ...data @@ -46,10 +72,17 @@ export async function getServiceType(data: IGetServiceType) { }); } -// 分页查询服务 +/** + * 定义一个异步函数 pageServiceByKey，用于分页查询服务 + * @param data - 一个符合 IPageServiceByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询服务的响应结果 + */ export async function pageServiceByKey(data: IPageServiceByKey) { - // 因为后台返回的字段与前端表单数据的prop不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 - // Reflect.has(data, 'roleName') ? (data.roleId = data.roleName) : '' + // 因为后台返回的字段与前端表单数据的 prop 不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 + // 这里注释掉的代码可能是原本用于处理字段的逻辑，但当前未启用 + // Reflect.has(data, 'roleName')? (data.roleId = data.roleName) : '' + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/service/pageServiceByKey" + // 将 data 对象展开作为请求的参数 return http.get("/api/service/pageServiceByKey", { params: { ...data @@ -57,13 +90,25 @@ export async function pageServiceByKey(data: IPageServiceByKey) { }); } -// 新增服务类型 +/** + * 定义一个函数 addServiceType，用于新增服务类型 + * @param data - 一个符合 IAddServiceType 接口的对象，包含新增服务类型所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增服务类型操作的响应结果 + */ export function addServiceType(data: IAddServiceType) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/service/addServiceType" + // 将 data 对象作为请求的主体 return http.post("/api/service/addServiceType", data); } -// 根据编号获取服务类型 +/** + * 定义一个异步函数 getServiceTypeById，用于根据编号获取服务类型 + * @param data - 一个符合 IGetServiceTypeById 接口的对象，包含根据编号获取服务类型所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号获取服务类型的响应结果 + */ export async function getServiceTypeById(data: IGetServiceTypeById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/service/getServiceTypeById" + // 将 data 对象展开作为请求的参数 return http.get("/api/service/getServiceTypeById", { params: { ...data @@ -71,13 +116,25 @@ export async function getServiceTypeById(data: IGetServiceTypeById) { }); } -// 编辑服务类型 +/** + * 定义一个函数 editServiceType，用于编辑服务类型 + * @param data - 一个符合 IAddServiceType 接口的对象，包含编辑服务类型所需的数据 + * @returns 一个 Promise 对象，解析后得到的是编辑服务类型操作的响应结果 + */ export function editServiceType(data: IAddServiceType) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/service/editServiceType" + // 将 data 对象作为请求的主体 return http.put("/api/service/editServiceType", data); } -// 删除服务类型 +/** + * 定义一个异步函数 deleteServiceType，用于删除服务类型 + * @param data - 一个符合 IGetServiceTypeById 接口的对象，包含删除服务类型所需的参数 + * @returns 一个 Promise 对象，解析后得到的是删除服务类型操作的响应结果 + */ export async function deleteServiceType(data: IGetServiceTypeById) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 "/api/service/deleteServiceType" + // 将 data 对象展开作为请求的参数 return http.delete("/api/service/deleteServiceType", { params: { ...data @@ -85,13 +142,25 @@ export async function deleteServiceType(data: IGetServiceTypeById) { }); } -// 新增服务 +/** + * 定义一个函数 addService，用于新增服务 + * @param data - 一个符合 IAddService 接口的对象，包含新增服务所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增服务操作的响应结果 + */ export function addService(data: IAddService) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/service/addService" + // 将 data 对象作为请求的主体 return http.post("/api/service/addService", data); } -// 根据编号获取服务 +/** + * 定义一个异步函数 getServiceById，用于根据编号获取服务 + * @param data - 一个符合 IGetServiceById 接口的对象，包含根据编号获取服务所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号获取服务的响应结果 + */ export async function getServiceById(data: IGetServiceById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/service/getServiceById" + // 将 data 对象展开作为请求的参数 return http.get("/api/service/getServiceById", { params: { ...data @@ -99,13 +168,25 @@ export async function getServiceById(data: IGetServiceById) { }); } -// 编辑服务 +/** + * 定义一个函数 editService，用于编辑服务 + * @param data - 一个符合 IAddService 接口的对象，包含编辑服务所需的数据 + * @returns 一个 Promise 对象，解析后得到的是编辑服务操作的响应结果 + */ export function editService(data: IAddService) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/service/editService" + // 将 data 对象作为请求的主体 return http.put("/api/service/editService", data); } -// 删除服务 +/** + * 定义一个异步函数 deleteService，用于删除服务 + * @param data - 一个符合 IGetServiceById 接口的对象，包含删除服务所需的参数 + * @returns 一个 Promise 对象，解析后得到的是删除服务操作的响应结果 + */ export async function deleteService(data: IGetServiceById) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 "/api/service/deleteService" + // 将 data 对象展开作为请求的参数 return http.delete("/api/service/deleteService", { params: { ...data diff --git a/client/src/apis/soldManage.ts b/client/src/apis/soldManage.ts index 36d9117..96a0ee5 100644 --- a/client/src/apis/soldManage.ts +++ b/client/src/apis/soldManage.ts @@ -1,58 +1,110 @@ +// 从 '@/utils' 模块导入名为 http 的对象，该对象可能是用于发起 HTTP 请求的工具，比如对 axios 等请求库的封装 import { http } from '@/utils' +// 定义一个接口 IAddConsult，用于描述新增咨询时的数据结构 interface IAddConsult { - address: string - age: string - consultContent: string - consultDate: string - consultName: string - consultPhone: string - elderName: string - elderPhone: string - idNum: string - relation: string - sex: string - sourceId: string | number - staffId: string | number - consultId?: string | number - elderId?: string | number + // 地址，类型为字符串 + address: string; + // 年龄，类型为字符串 + age: string; + // 咨询内容，类型为字符串 + consultContent: string; + // 咨询日期，类型为字符串 + consultDate: string; + // 咨询人姓名，类型为字符串 + consultName: string; + // 咨询人电话，类型为字符串 + consultPhone: string; + // 老人姓名，类型为字符串 + elderName: string; + // 老人电话，类型为字符串 + elderPhone: string; + // 身份证号码，类型为字符串 + idNum: string; + // 关系，类型为字符串 + relation: string; + // 性别，类型为字符串 + sex: string; + // 来源 ID，可以是字符串或数字 + sourceId: string | number; + // 接待人 ID，可以是字符串或数字 + staffId: string | number; + // 咨询 ID，可选，类型可以是字符串或数字 + consultId?: string | number; + // 老人 ID，可选，类型可以是字符串或数字 + elderId?: string | number; } +// 定义一个接口 ISearhFormConsultByKey，用于描述分页查询咨询时的请求参数结构 interface ISearhFormConsultByKey { - pageNum: number - pageSize: number - consultName?: string - consultPhone?: string - elderName?: string - elderPhone?: string - endTime?: string - sourceId?: string - staffId?: string - startTime?: string - sourceName?: string - staffName?: string + // 页码，类型为数字 + pageNum: number; + // 每页数量，类型为数字 + pageSize: number; + // 咨询人姓名，可选，类型为字符串 + consultName?: string; + // 咨询人电话，可选，类型为字符串 + consultPhone?: string; + // 老人姓名，可选，类型为字符串 + elderName?: string; + // 老人电话，可选，类型为字符串 + elderPhone?: string; + // 结束时间，可选，类型为字符串 + endTime?: string; + // 来源 ID，可选，类型为字符串 + sourceId?: string; + // 接待人 ID，可选，类型为字符串 + staffId?: string; + // 开始时间，可选，类型为字符串 + startTime?: string; + // 来源名称，可选，类型为字符串 + sourceName?: string; + // 接待人名称，可选，类型为字符串 + staffName?: string; } +// 定义一个接口 IConsultByForm，用于描述根据咨询人编号和老人编号获取咨询信息时的请求参数结构 interface IConsultByForm { - consultId: string | number - elderId: string | number + // 咨询 ID，可以是字符串或数字 + consultId: string | number; + // 老人 ID，可以是字符串或数字 + elderId: string | number; } -// 获取咨询管理表格数据 根据咨询人编号和老人编号获取咨询信息 +/** + * 定义一个异步函数 getConsultByForm，用于根据咨询人编号和老人编号获取咨询信息 + * @param data - 一个符合 IConsultByForm 接口的对象，包含获取咨询信息所需的参数 + * @returns 一个 Promise 对象，解析后得到的是获取咨询信息的响应结果 + */ export async function getConsultByForm(data: IConsultByForm) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/consult/getConsultByConsultIdAndElderId' + // 将 data 对象展开作为请求的参数 return http.get('/api/consult/getConsultByConsultIdAndElderId', { params: { ...data } }) } -//新增资询 + +/** + * 定义一个函数 addConsult，用于新增咨询 + * @param data - 一个符合 IAddConsult 接口的对象，包含新增咨询所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增咨询操作的响应结果 + */ export function addConsult(data: IAddConsult) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 '/api/consult/addConsult' + // 将 data 对象作为请求的主体 return http.post('/api/consult/addConsult', data) } -// 删除咨询 +/** + * 定义一个函数 delConsult，用于删除咨询 + * @param elderId - 老人 ID，可以是字符串或数字，用于标识要删除的咨询关联的老人 + * @returns 一个 Promise 对象，解析后得到的是删除咨询操作的响应结果 + */ export function delConsult(elderId: string | number) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 '/api/consult/deleteConsult' + // 将 elderId 作为请求的参数 return http.delete('/api/consult/deleteConsult', { params: { elderId @@ -60,13 +112,25 @@ export function delConsult(elderId: string | number) { }) } -//编辑咨询 +/** + * 定义一个函数 editConsult，用于编辑咨询 + * @param data - 一个符合 IAddConsult 接口的对象，包含编辑咨询所需的数据 + * @returns 一个 Promise 对象，解析后得到的是编辑咨询操作的响应结果 + */ export function editConsult(data: IAddConsult) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 '/api/consult/editConsult' + // 将 data 对象作为请求的主体 return http.put('/api/consult/editConsult', data) } -// 转为意向客户 +/** + * 定义一个函数 intentionConsult，用于将咨询转为意向客户 + * @param elderId - 老人 ID，可以是字符串或数字，用于标识要转为意向客户的咨询关联的老人 + * @returns 一个 Promise 对象，解析后得到的是将咨询转为意向客户操作的响应结果 + */ export function intentionConsult(elderId: string | number) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 '/api/consult/intentionConsult' + // 将包含 elderId 的对象作为请求的主体 return http.put('/api/consult/intentionConsult', { data: { elderId @@ -74,21 +138,37 @@ export function intentionConsult(elderId: string | number) { }) } -// 来源渠道 +/** + * 定义一个函数 listConsultSource，用于获取来源渠道 + * @returns 一个 Promise 对象，解析后得到的是获取来源渠道的响应结果 + */ export function listConsultSource() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/consult/listConsultSource' return http.get('/api/consult/listConsultSource') } -// 接待人 +/** + * 定义一个函数 listConsultStaff，用于获取接待人 + * @returns 一个 Promise 对象，解析后得到的是获取接待人的响应结果 + */ export function listConsultStaff() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/consult/listConsultStaff' return http.get('/api/consult/listConsultStaff') } -// 分页查询咨询 +/** + * 定义一个异步函数 pageConsultByKey，用于分页查询咨询 + * @param data - 一个符合 ISearhFormConsultByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询咨询的响应结果 + */ export async function pageConsultByKey(data: ISearhFormConsultByKey) { - // 因为后台返回的字段与前端表单数据的prop不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 - Reflect.has(data, 'sourceName') ? (data.sourceId = data.sourceName) : '' - Reflect.has(data, 'staffName') ? (data.staffId = data.staffName) : '' + // 因为后台返回的字段与前端表单数据的 prop 不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 + // 如果 data 对象中有'sourceName' 字段，则将其值赋给'sourceId' 字段 + Reflect.has(data,'sourceName')? (data.sourceId = data.sourceName) : ''; + // 如果 data 对象中有'staffName' 字段，则将其值赋给'staffId' 字段 + Reflect.has(data,'staffName')? (data.staffId = data.staffName) : ''; + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/consult/pageConsultByKey' + // 将处理后的 data 对象展开作为请求的参数 const res = await http.get('/api/consult/pageConsultByKey', { params: { ...data @@ -97,17 +177,28 @@ export async function pageConsultByKey(data: ISearhFormConsultByKey) { return res } -//意向用户接口 +// 定义一个接口 ISearhFormIntentionByKey，用于描述分页查询意向客户时的请求参数结构 interface ISearhFormIntentionByKey { - pageNum: number - pageSize: number - elderName?: string - elderPhone?: string | number - labelId?: number + // 页码，类型为数字 + pageNum: number; + // 每页数量，类型为数字 + pageSize: number; + // 老人姓名，可选，类型为字符串 + elderName?: string; + // 老人电话，可选，可以是字符串或数字 + elderPhone?: string | number; + // 标签 ID，可选，类型为数字 + labelId?: number; } -//分页查询意向客户 +/** + * 定义一个异步函数 pageIntentionByKey，用于分页查询意向客户 + * @param data - 一个符合 ISearhFormIntentionByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询意向客户的响应结果 + */ export async function pageIntentionByKey(data: ISearhFormIntentionByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/intention/pageIntentionByKey' + // 将 data 对象展开作为请求的参数 const res = await http.get('/api/intention/pageIntentionByKey', { params: { ...data @@ -116,23 +207,47 @@ export async function pageIntentionByKey(data: ISearhFormIntentionByKey) { return res } -// 新增沟通记录 +/** + * 定义一个函数 addCommunicationRecord，用于新增沟通记录 + * @param data - 包含新增沟通记录所需数据的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是新增沟通记录操作的响应结果 + */ export function addCommunicationRecord(data: any) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 '/api/intention/addCommunicationRecord' + // 将 data 对象作为请求的主体 return http.post('/api/intention/addCommunicationRecord', data) } -// 新增意向客户 +/** + * 定义一个函数 addIntention，用于新增意向客户 + * @param data - 包含新增意向客户所需数据的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是新增意向客户操作的响应结果 + */ export function addIntention(data: any) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 '/api/intention/addIntention' + // 将 data 对象作为请求的主体 return http.post('/api/intention/addIntention', data) } -// 新增回访计划 +/** + * 定义一个函数 addVisitPlan，用于新增回访计划 + * @param data - 包含新增回访计划所需数据的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是新增回访计划操作的响应结果 + */ export function addVisitPlan(data: any) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 '/api/intention/addVisitPlan' + // 将 data 对象作为请求的主体 return http.post('/api/intention/addVisitPlan', data) } -// 新增沟通记录 +/** + * 定义一个函数 deleteCommunicationRecord，用于删除沟通记录 + * @param communicationRecordId - 沟通记录 ID，类型为 any（具体类型需根据实际情况确定），用于标识要删除的沟通记录 + * @returns 一个 Promise 对象，解析后得到的是删除沟通记录操作的响应结果 + */ export function deleteCommunicationRecord(communicationRecordId: any) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 '/api/intention/deleteCommunicationRecord' + // 将 communicationRecordId 作为请求的参数 return http.delete('/api/intention/deleteCommunicationRecord', { params: { communicationRecordId @@ -140,8 +255,14 @@ export function deleteCommunicationRecord(communicationRecordId: any) { }) } -// 删除回访计划 +/** + * 定义一个函数 deleteVisitPlan，用于删除回访计划 + * @param visitPlanId - 回访计划 ID，类型为 any（具体类型需根据实际情况确定），用于标识要删除的回访计划 + * @returns 一个 Promise 对象，解析后得到的是删除回访计划操作的响应结果 + */ export function deleteVisitPlan(visitPlanId: any) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 '/api/intention/deleteVisitPlan' + // 将 visitPlanId 作为请求的参数 return http.delete('/api/intention/deleteVisitPlan', { params: { visitPlanId @@ -149,28 +270,58 @@ export function deleteVisitPlan(visitPlanId: any) { }) } -// 编辑沟通记录 +/** + * 定义一个函数 editCommunicationRecord，用于编辑沟通记录 + * @param data - 包含编辑沟通记录所需数据的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是编辑沟通记录操作的响应结果 + */ export function editCommunicationRecord(data: any) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 '/api/intention/editCommunicationRecord' + //将 data 对象作为请求的主体 return http.put('/api/intention/editCommunicationRecord', data) } -// 编辑意向客户 +/** + * 定义一个函数 editIntention，用于编辑意向客户 + * @param data - 包含编辑意向客户所需数据的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是编辑意向客户操作的响应结果 + */ export function editIntention(data: any) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 '/api/intention/editIntention' + // 将 data 对象作为请求的主体 return http.put('/api/intention/editIntention', data) } -// 编辑老人标签 +/** + * 定义一个函数 editElderLabel，用于编辑老人标签 + * @param data - 包含编辑老人标签所需数据的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是编辑老人标签操作的响应结果 + */ export function editElderLabel(data: any) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 '/api/intention/editElderLabel' + // 将 data 对象作为请求的主体 return http.put('/api/intention/editElderLabel', data) } -// 执行回访计划 +/** + * 定义一个函数 executeVisitPlan，用于执行回访计划 + * @param data - 包含执行回访计划所需数据的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是执行回访计划操作的响应结果 + */ export function executeVisitPlan(data: any) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 '/api/intention/executeVisitPlan' + // 将 data 对象作为请求的主体 return http.put('/api/intention/executeVisitPlan', data) } -// 根据编号获取编辑意向客户标签 +/** + * 定义一个函数 getEditElderLabelById，用于根据编号获取编辑意向客户标签 + * @param data - 包含获取编辑意向客户标签所需参数的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是根据编号获取编辑意向客户标签的响应结果 + */ export function getEditElderLabelById(data: any) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/intention/getEditElderLabelById' + // 将 data 对象展开作为请求的参数 return http.get('/api/intention/getEditElderLabelById', { params: { ...data @@ -178,8 +329,14 @@ export function getEditElderLabelById(data: any) { }) } -// 根据编号获取意向客户标签 +/** + * 定义一个函数 getElderLabelById，用于根据编号获取意向客户标签 + * @param data - 包含获取意向客户标签所需参数的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是根据编号获取意向客户标签的响应结果 + */ export function getElderLabelById(data: any) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/intention/getElderLabelById' + // 将 data 对象展开作为请求的参数 return http.get('/api/intention/getElderLabelById', { params: { ...data @@ -187,8 +344,14 @@ export function getElderLabelById(data: any) { }) } -// 根据编号获取意向客户 +/** + * 定义一个函数 getIntentById，用于根据编号获取意向客户 + * @param data - 包含获取意向客户所需参数的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是根据编号获取意向客户的响应结果 + */ export function getIntentById(data: any) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/intention/getIntentById' + // 将 data 对象展开作为请求的参数 return http.get('/api/intention/getIntentById', { params: { ...data @@ -196,8 +359,14 @@ export function getIntentById(data: any) { }) } -//客户标签 +/** + * 定义一个函数 listLabel，用于获取客户标签 + * @param data - 包含获取客户标签所需参数的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是获取客户标签的响应结果 + */ export function listLabel(data: any) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/intention/listLabel' + // 将 data 对象展开作为请求的参数 return http.get('/intention/listLabel', { params: { ...data @@ -205,29 +374,12 @@ export function listLabel(data: any) { }) } -// 分页查询沟通记录 +/** + * 定义一个函数 pageCommunicationRecord，用于分页查询沟通记录 + * @param data - 包含分页查询沟通记录所需参数的对象，类型为 any（具体结构需根据实际情况确定） + * @returns 一个 Promise 对象，解析后得到的是分页查询沟通记录的响应结果 + */ export function pageCommunicationRecord(data: any) { - return http.get('/intention/pageCommunicationRecord', { - params: { - ...data - } - }) -} - -// 分页搜索老人 -export function pageSearchElderByKey(data: any) { - return http.get('/intention/pageSearchElderByKey', { - params: { - ...data - } - }) -} - -// 分页查询回访计划 -export function pageVisitPlan(data: any) { - return http.get('/intention/pageVisitPlan', { - params: { - ...data - } - }) -} + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/intention/pageCommunicationRecord' + // 将 data 对象展开作为请求的参数 + return http.get diff --git a/client/src/apis/source.ts b/client/src/apis/source.ts index 8b54d01..58128b1 100644 --- a/client/src/apis/source.ts +++ b/client/src/apis/source.ts @@ -1,23 +1,40 @@ +// 从 "@/utils" 模块导入名为 http 的对象，推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 import { http } from "@/utils"; +// 定义一个接口 IPageSourceByKey，用于描述分页查询来源渠道时的请求参数结构 interface IPageSourceByKey { + // 名称，用于筛选来源渠道，类型为字符串 name: string; + // 来源渠道名称，用于筛选来源渠道，类型为字符串 sourceName: string; } +// 定义一个接口 IAddSource，用于描述新增来源渠道时的数据结构 interface IAddSource { + // 来源渠道的 ID，类型为字符串 id: string; + // 来源渠道的名称，类型为字符串 name: string; } +// 定义一个接口 IGetSourceById，用于描述根据编号查询来源渠道时的请求参数结构 interface IGetSourceById { + // 来源渠道 ID，类型为字符串 sourceId: string; } -// 分页查询来源渠道 +/** + * 定义一个异步函数 pageSourceByKey，用于分页查询来源渠道 + * @param data - 一个符合 IPageSourceByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询来源渠道的响应结果 + */ export async function pageSourceByKey(data: IPageSourceByKey) { - // 因为后台返回的字段与前端表单数据的prop不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 - Reflect.has(data, "name") ? (data.sourceName = data.name) : ""; + // 因为后台返回的字段与前端表单数据的 prop 不一样， + // 但是组件封装需要一样，所以请求前增加一些这两个字段 + // 如果 data 对象中有 "name" 字段，则将其值赋给 "sourceName" 字段 + Reflect.has(data, "name")? (data.sourceName = data.name) : ""; + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/source/pageSourceByKey" + // 将处理后的 data 对象展开作为请求的参数 return http.get("/api/source/pageSourceByKey", { params: { ...data @@ -25,13 +42,25 @@ export async function pageSourceByKey(data: IPageSourceByKey) { }); } -// 新增来源渠道 +/** + * 定义一个函数 addSource，用于新增来源渠道 + * @param data - 一个符合 IAddSource 接口的对象，包含新增来源渠道所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增来源渠道操作的响应结果 + */ export function addSource(data: IAddSource) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/source/addSource" + // 将 data 对象作为请求的主体 return http.post("/api/source/addSource", data); } -// 根据编号查询来源渠道 +/** + * 定义一个异步函数 getSourceById，用于根据编号查询来源渠道 + * @param data - 一个符合 IGetSourceById 接口的对象，包含根据编号查询来源渠道所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号查询来源渠道的响应结果 + */ export async function getSourceById(data: IGetSourceById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/source/getSourceById" + // 将 data 对象展开作为请求的参数 return http.get("/api/source/getSourceById", { params: { ...data @@ -39,13 +68,25 @@ export async function getSourceById(data: IGetSourceById) { }); } -// 编辑来源渠道 +/** + * 定义一个函数 editSource，用于编辑来源渠道 + * @param data - 一个符合 IAddSource 接口的对象，包含编辑来源渠道所需的数据 + * @returns 一个 Promise 对象，解析后得到的是编辑来源渠道操作的响应结果 + */ export function editSource(data: IAddSource) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/source/editSource" + // 将 data 对象作为请求的主体 return http.put("/api/source/editSource", data); } -// 删除来源渠道 +/** + * 定义一个异步函数 deleteSource，用于删除来源渠道 + * @param data - 一个符合 IGetSourceById 接口的对象，包含删除来源渠道所需的参数 + * @returns 一个 Promise 对象，解析后得到的是删除来源渠道操作的响应结果 + */ export async function deleteSource(data: IGetSourceById) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 "/api/source/deleteSource" + // 将 data 对象展开作为请求的参数 return http.delete("/api/source/deleteSource", { params: { ...data diff --git a/client/src/apis/staff.ts b/client/src/apis/staff.ts index 347b5ff..0dedaa6 100644 --- a/client/src/apis/staff.ts +++ b/client/src/apis/staff.ts @@ -1,38 +1,69 @@ +// 从 "@/utils" 模块导入名为 http 的对象，推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 import { http } from "@/utils"; +// 定义一个接口 IPageStaffByKey，用于描述分页查询员工时的请求参数结构 interface IPageStaffByKey { + // 角色 ID，用于筛选员工，类型为数字 roleId: number; - roleName:number; + // 这里 roleName 的类型标注为 number 可能有误，通常角色名称应该是字符串类型，用于筛选员工 + roleName: number; + // 员工姓名，用于筛选员工，类型为字符串 name: string; + // 员工电话，用于筛选员工，类型为字符串 phone: string; } +// 定义一个接口 IAddStaff，用于描述新增员工时的数据结构 interface IAddStaff { + // 员工 ID，类型为数字 id: number; + // 员工角色 ID，类型为数字 roleId: number; + // 员工姓名，类型为字符串 name: string; + // 员工身份证号码，类型为字符串 idNum: string; + // 员工年龄，类型为数字 age: number; + // 员工性别，类型为字符串 sex: string; + // 员工电话，类型为字符串 phone: string; + // 员工邮箱，类型为字符串 email: string; + // 员工地址，类型为字符串 address: string; + // 员工头像地址，类型为字符串 avator: string; } +// 定义一个接口 IGetStaffById，用于描述根据员工编号查询员工时的请求参数结构 interface IGetStaffById { - staffId: string + // 员工 ID，类型为字符串 + staffId: string; } -// 获取角色列表 +/** + * 定义一个异步函数 getRole，用于获取角色列表 + * @returns 一个 Promise 对象，解析后得到的是获取角色列表的响应结果 + */ export async function getRole() { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/staff/getRole" return http.get("/api/staff/getRole"); } -// 分页查询员工 +/** + * 定义一个异步函数 pageStaffByKey，用于分页查询员工 + * @param data - 一个符合 IPageStaffByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询员工的响应结果 + */ export async function pageStaffByKey(data: IPageStaffByKey) { - // 因为后台返回的字段与前端表单数据的prop不一样，但是组件封装是需要一样的，所以请求前增加一些这两个字段 - Reflect.has(data, 'roleName') ? (data.roleId = data.roleName) : '' + // 因为后台返回的字段与前端表单数据的 prop 不一样， + // 但是组件封装需要一样，所以请求前增加一些这两个字段 + // 如果 data 对象中有 'roleName' 字段，则将其值赋给 'roleId' 字段，这里逻辑可能需要进一步确认合理性 + Reflect.has(data, 'roleName')? (data.roleId = data.roleName) : ''; + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/staff/pageStaffByKey" + // 将 data 对象展开作为请求的参数 return http.get("/api/staff/pageStaffByKey", { params: { ...data @@ -40,13 +71,25 @@ export async function pageStaffByKey(data: IPageStaffByKey) { }); } -// 新增员工 +/** + * 定义一个函数 addStaff，用于新增员工 + * @param data - 一个符合 IAddStaff 接口的对象，包含新增员工所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增员工操作的响应结果 + */ export function addStaff(data: IAddStaff) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/staff/addStaff" + // 将 data 对象作为请求的主体 return http.post("/api/staff/addStaff", data); } -// 根据老人编号查询员工 +/** + * 定义一个异步函数 getStaffById，用于根据员工编号查询员工 + * @param data - 一个符合 IGetStaffById 接口的对象，包含根据员工编号查询员工所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据员工编号查询员工的响应结果 + */ export async function getStaffById(data: IGetStaffById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/staff/getStaffById" + // 将 data 对象展开作为请求的参数 return http.get("/api/staff/getStaffById", { params: { ...data @@ -54,13 +97,25 @@ export async function getStaffById(data: IGetStaffById) { }); } -// 编辑员工 +/** + * 定义一个函数 editStaff，用于编辑员工信息 + * @param data - 一个符合 IAddStaff 接口的对象，包含编辑员工所需的数据 + * @returns 一个 Promise 对象，解析后得到的是编辑员工操作的响应结果 + */ export function editStaff(data: IAddStaff) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/staff/editStaff" + // 将 data 对象作为请求的主体 return http.put("/api/staff/editStaff", data); } -// 删除员工 +/** + * 定义一个异步函数 leaveStaff，用于删除员工 + * @param data - 一个符合 IGetStaffById 接口的对象，包含删除员工所需的参数 + * @returns 一个 Promise 对象，解析后得到的是删除员工操作的响应结果 + */ export async function leaveStaff(data: IGetStaffById) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 "/api/staff/leaveStaff" + // 将 data 对象展开作为请求的参数 return http.delete("/api/staff/leaveStaff", { params: { ...data diff --git a/client/src/apis/user.ts b/client/src/apis/user.ts index 93eba6e..2317095 100644 --- a/client/src/apis/user.ts +++ b/client/src/apis/user.ts @@ -1,60 +1,106 @@ -import { http } from '@/utils' +// 从 '@/utils' 模块导入名为 http 的对象，推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 +import { http } from '@/utils'; +// 定义一个接口 ILoginForm，用于描述登录表单的数据结构 interface ILoginForm { - pass: string - phone: string + // 密码，类型为字符串 + pass: string; + // 电话号码，类型为字符串 + phone: string; } +// 定义一个接口 ISendCodeForm，用于描述发送验证码表单的数据结构 interface ISendCodeForm { - pass: string - account: string + // 密码，类型为字符串 + pass: string; + // 账号，类型为字符串 + account: string; } +// 定义一个接口 IForgetPass，用于描述忘记密码时的数据结构 interface IForgetPass { - code: string - pass: string - account: string + // 验证码，类型为字符串 + code: string; + // 新密码，类型为字符串 + pass: string; + // 账号，类型为字符串 + account: string; } +// 定义一个接口 IEditPass，用于描述修改密码时的数据结构 interface IEditPass { - newPass: string - oldPass: string + // 新密码，类型为字符串 + newPass: string; + // 旧密码，类型为字符串 + oldPass: string; } +// 定义一个类 IEditPassImpl，实现了 IEditPass 接口，用于表示修改密码的数据实体 export class IEditPassImpl implements IEditPass { - newPass: string - oldPass: string + // 新密码属性 + newPass: string; + // 旧密码属性 + oldPass: string; + // 构造函数，接收新密码和旧密码作为参数，并赋值给对应的属性 constructor(newPass: string, oldPass: string) { - this.newPass = newPass - this.oldPass = oldPass + this.newPass = newPass; + this.oldPass = oldPass; } } -// 登录 +/** + * 定义一个函数 getLogin，用于处理登录操作 + * @param data - 一个符合 ILoginForm 接口的对象，包含登录所需的数据 + * @returns 一个 Promise 对象，解析后得到的是登录操作的响应结果 + */ export function getLogin(data: ILoginForm) { - return http.post('/api/account/login', data) + // 使用导入的 http 对象发起 POST 请求，请求地址为 '/api/account/login' + // 将 data 对象作为请求的主体 + return http.post('/api/account/login', data); } -// 发送验证码 +/** + * 定义一个异步函数 sendCode，用于发送验证码 + * @param data - 一个符合 ISendCodeForm 接口的对象，包含发送验证码所需的数据 + * @returns 一个 Promise 对象，解析后得到的是发送验证码操作的响应结果 + */ export async function sendCode(data: ISendCodeForm) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 '/api/account/sendCode' + // 将 data 对象展开作为请求的参数 return http.get('/api/account/sendCode', { params: { ...data } - }) + }); } -// 忘记密码 +/** + * 定义一个异步函数 forgetPass，用于处理忘记密码的操作 + * @param data - 一个符合 IForgetPass 接口的对象，包含忘记密码操作所需的数据 + * @returns 一个 Promise 对象，解析后得到的是忘记密码操作的响应结果 + */ export async function forgetPass(data: IForgetPass) { - return http.put('/api/account/forget', data) + // 使用导入的 http 对象发起 PUT 请求，请求地址为 '/api/account/forget' + // 将 data 对象作为请求的主体 + return http.put('/api/account/forget', data); } -// 修改密码 +/** + * 定义一个异步函数 editPass，用于处理修改密码的操作 + * @param data - 一个符合 IEditPass 接口的对象，包含修改密码操作所需的数据 + * @returns 一个 Promise 对象，解析后得到的是修改密码操作的响应结果 + */ export async function editPass(data: IEditPass) { - return http.put('/api/account/edit', data) + // 使用导入的 http 对象发起 PUT 请求，请求地址为 '/api/account/edit' + // 将 data 对象作为请求的主体 + return http.put('/api/account/edit', data); } -// 退出登录 +/** + * 定义一个异步函数 getLogout，用于处理退出登录的操作 + * @returns 一个 Promise 对象，解析后得到的是退出登录操作的响应结果 + */ export async function getLogout() { - return http.delete('/api/account/logout') + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 '/api/account/logout' + return http.delete('/api/account/logout'); } diff --git a/client/src/apis/visit.ts b/client/src/apis/visit.ts index 3300427..5cb5e96 100644 --- a/client/src/apis/visit.ts +++ b/client/src/apis/visit.ts @@ -1,49 +1,83 @@ +// 从 "@/utils" 模块导入名为 http 的对象，推测该对象是用于发起 HTTP 请求的工具，可能是对 axios 等请求库的封装 import { http } from "@/utils"; +// 从 "@/apis/bookManage" 模块导入 IPageSearchElderByKey 接口， +// 用于描述分页搜索老人时的请求参数结构 import { IPageSearchElderByKey } from "@/apis/bookManage"; +// 定义一个接口 IPageVisitByKey，用于描述分页查询来访登记时的请求参数结构 interface IPageVisitByKey { + // 老人姓名，用于筛选来访登记记录，类型为字符串 elderName: string; + // 来访人姓名，用于筛选来访登记记录，类型为字符串 visitName: string; + // 来访人电话，用于筛选来访登记记录，类型为字符串 visitPhone: string; + // 来访状态标识，用于筛选来访登记记录，类型为字符串 visitFlag: string; } +// 定义一个接口 IAddVisit，用于描述新增来访登记时的数据结构 interface IAddVisit { + // 来访登记的 ID，类型为数字 id: number; + // 老人 ID，类型为数字 elderId: number; + // 来访人姓名，类型为字符串 name: string; + // 来访人电话，类型为字符串 phone: string; + // 与老人的关系，类型为字符串 relation: string; + // 来访日期，类型为字符串 visitDate: string; + // 来访次数，类型为数字 visitNum: number; } +// 定义一个接口 IGetVisitById，用于描述根据编号获取来访登记时的请求参数结构 interface IGetVisitById { + // 来访登记 ID，类型为字符串 visitId: string; } +// 定义一个接口 IEditVisit，用于描述编辑来访登记时的数据结构 interface IEditVisit { + // 来访登记的 ID，类型为数字 id: number; + // 来访人姓名，类型为字符串 name: string; + // 来访人电话，类型为字符串 phone: string; + // 与老人的关系，类型为字符串 relation: string; + // 来访日期字符串，类型为字符串 visitDateStr: string; + // 来访次数，类型为数字 visitNum: number; } +// 定义一个接口 IRecordLeave，用于描述登记离开时的数据结构 interface IRecordLeave { + // 来访登记 ID，类型为字符串 id: string; + // 离开日期，类型为 any（具体类型需根据实际情况确定） leaveDate: any; } -// 来访状态 +// 定义一个名为 typeList 的常量，是一个包含来访状态选项的数组，每个选项有标签和对应的值 export const typeList = [ { label: "待离开", value: "待离开" }, { label: "已离开", value: "已离开" } ]; -// 分页查询来访登记 +/** + * 定义一个异步函数 pageVisitByKey，用于分页查询来访登记 + * @param data - 一个符合 IPageVisitByKey 接口的对象，包含分页查询所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页查询来访登记的响应结果 + */ export async function pageVisitByKey(data: IPageVisitByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/visit/pageVisitByKey" + // 将 data 对象展开作为请求的参数 return http.get("/api/visit/pageVisitByKey", { params: { ...data @@ -51,8 +85,14 @@ export async function pageVisitByKey(data: IPageVisitByKey) { }); } -// 分页搜索老人 +/** + * 定义一个异步函数 pageSearchElderByKey，用于分页搜索老人 + * @param data - 一个符合 IPageSearchElderByKey 接口的对象，包含搜索所需的参数 + * @returns 一个 Promise 对象，解析后得到的是分页搜索老人的响应结果 + */ export async function pageSearchElderByKey(data: IPageSearchElderByKey) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/visit/pageSearchElderByKey" + // 将 data 对象展开作为请求的参数 return http.get("/api/visit/pageSearchElderByKey", { params: { ...data @@ -60,13 +100,25 @@ export async function pageSearchElderByKey(data: IPageSearchElderByKey) { }); } -// 新增来访登记 +/** + * 定义一个函数 addVisit，用于新增来访登记 + * @param data - 一个符合 IAddVisit 接口的对象，包含新增来访登记所需的数据 + * @returns 一个 Promise 对象，解析后得到的是新增来访登记操作的响应结果 + */ export function addVisit(data: IAddVisit) { + // 使用导入的 http 对象发起 POST 请求，请求地址为 "/api/visit/addVisit" + // 将 data 对象作为请求的主体 return http.post("/api/visit/addVisit", data); } -// 根据编号获取来访登记 +/** + * 定义一个异步函数 getVisitById，用于根据编号获取来访登记 + * @param data - 一个符合 IGetVisitById 接口的对象，包含根据编号获取来访登记所需的参数 + * @returns 一个 Promise 对象，解析后得到的是根据编号获取来访登记的响应结果 + */ export async function getVisitById(data: IGetVisitById) { + // 使用导入的 http 对象发起 GET 请求，请求地址为 "/api/visit/getVisitById" + // 将 data 对象展开作为请求的参数 return http.get("/api/visit/getVisitById", { params: { ...data @@ -74,18 +126,36 @@ export async function getVisitById(data: IGetVisitById) { }); } -// 编辑来访登记 +/** + * 定义一个函数 editVisit，用于编辑来访登记 + * @param data - 一个符合 IEditVisit 接口的对象，包含编辑来访登记所需的数据 + * @returns 一个 Promise 对象，解析后得到的是编辑来访登记操作的响应结果 + */ export function editVisit(data: IEditVisit) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/visit/editVisit" + // 将 data 对象作为请求的主体 return http.put("/api/visit/editVisit", data); } -// 登记离开 +/** + * 定义一个函数 recordLeave，用于登记离开 + * @param data - 一个符合 IRecordLeave 接口的对象，包含登记离开所需的数据 + * @returns 一个 Promise 对象，解析后得到的是登记离开操作的响应结果 + */ export function recordLeave(data: IRecordLeave) { + // 使用导入的 http 对象发起 PUT 请求，请求地址为 "/api/visit/recordLeave" + // 将 data 对象作为请求的主体 return http.put("/api/visit/recordLeave", data); } -// 删除来访登记 +/** + * 定义一个异步函数 deleteVisit，用于删除来访登记 + * @param data - 一个符合 IGetVisitById 接口的对象，包含删除来访登记所需的参数 + * @returns 一个 Promise 对象，解析后得到的是删除来访登记操作的响应结果 + */ export async function deleteVisit(data: IGetVisitById) { + // 使用导入的 http 对象发起 DELETE 请求，请求地址为 "/api/visit/deleteVisit" + // 将 data 对象展开作为请求的参数 return http.delete("/api/visit/deleteVisit", { params: { ...data diff --git a/client/src/components/Grid/components/GridItem.vue b/client/src/components/Grid/components/GridItem.vue index 6492076..7e5389e 100644 --- a/client/src/components/Grid/components/GridItem.vue +++ b/client/src/components/Grid/components/GridItem.vue @@ -1,23 +1,38 @@ + diff --git a/client/src/components/Grid/interface/index.ts b/client/src/components/Grid/interface/index.ts index b062bef..a3ff77d 100644 --- a/client/src/components/Grid/interface/index.ts +++ b/client/src/components/Grid/interface/index.ts @@ -1,6 +1,12 @@ -export type BreakPoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' +// 定义一个类型别名 BreakPoint，它的值只能是 'xs'、'sm'、'md'、'lg' 或 'xl' 中的一个， +// 通常用于表示响应式布局中的不同屏幕断点 +export type BreakPoint = 'xs' |'sm' |'md' | 'lg' | 'xl'; +// 定义一个类型别名 Responsive，它是一个对象类型，包含两个可选属性 span 和 offset。 +// span 用于表示在响应式布局中元素所占的列数，类型为 number 类型的可选值。 +// offset 用于表示在响应式布局中元素的偏移量，类型为 number 类型的可选值。 +// 这个类型通常用于描述在不同屏幕断点下元素的布局属性 export type Responsive = { - span?: number - offset?: number -} + span?: number; + offset?: number; +}; diff --git a/client/src/components/IconPark/index.vue b/client/src/components/IconPark/index.vue index 59e6480..9ca92a5 100644 --- a/client/src/components/IconPark/index.vue +++ b/client/src/components/IconPark/index.vue @@ -1,4 +1,12 @@