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/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/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/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/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/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/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/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 @@