kyj-yanglao-web-new/.workbuddy/memory/2026-08-06.md

2026-08-06

elderly/apply/nine-precautions/risk-disclosure-statement/Form.vue — secondElderSign 字符串/数组互转

用户要求：用 TableUpload 的 secondElderSign 字段，提交时转成字符串、回显时转成数组（参照 check-in ProcessForm.vue 的做法）。

背景：TableUpload（src/components/UploadFile/src/TableUpload.vue）的 modelValue 必须是数组 FileItem[]（内部 fileList = props.modelValue || []，并 push/splice），而后端以 JSON 字符串存储该字段。原 open() 用 Object.assign(dataForm, res) 直接把后端字符串塞进 secondElderSign，编辑/查看时组件会拿到字符串而崩。

改动：

• 新增两个辅助函数 toFileArray(val)（字符串→数组，带 Array.isArray/JSON.parse 兜底）与 toFileString(val)（空数组→''，否则 JSON.stringify）。
• open()：Object.assign 后加 dataForm.secondElderSign = toFileArray(res.secondElderSign)（回显转数组）。
• submitForm()：submitData 加 secondElderSign: toFileString(dataForm.secondElderSign)（提交转字符串）。
• 因 reactive 里 secondElderSign: [] 被推成 never[]，在声明处和 resetForm 处改为 [] as any[]，消除 TS2322。

类型检查：引入的 TS2322 已消除。Form.vue 仍剩 441/819 两处 TS6133（未使用变量 updateRiskCheckboxes / nextAssessDate），为改动前既有的，与本次无关、不影响运行。

elderly/apply/nine-precautions/risk-disclosure-statement/index.vue — 导出 secondElderSign 为图片

用户要求：导出（handleImportCard / ButtonImport）时把 secondElderSign（后端存 JSON 字符串，形如 [{fileUrl, fileName, fileSize, createTime}]，存的是 OSS 图片 URL）导出成真实图片嵌入 Excel。

根因/决策：原导出用 exportWithExpandedObjectArrays（src/utils/excel-export.ts，底层 SheetJS/xlsx 社区版）无法往 Excel 嵌图片，且原代码压根没导出该字段。改用项目已有的 exceljs（^4.4.0，已在 node_modules；social-worker/floor-activity-record/photo/index.vue 已有可复用的「ExcelJS + addImage + fetch 二进制」范式）。

改动：

• 移除 exportWithExpandedObjectArrays 导入，新增 import ExcelJS from 'exceljs'、import { getAccessToken } from '@/utils/auth'、import { saveAs } from 'file-saver'。
• 重写 handleImportCard：拉取列表后交给新函数 exportRiskDisclosureToExcel(exportList)。
• 新增 exportRiskDisclosureToExcel：建 workbook/worksheet，18 个文本列 + 动态「二次告知签名」图片列（列数=所有行签名图最大数量，无图则不生成图片列）；逐行 addRow，对每行 secondElderSign 用 parseFileList 解析出 fileUrl 数组，fetch 成 ArrayBuffer 后 workbook.addImage({buffer, extension}) + worksheet.addImage(imageId, {tl, ext:{width:90,height:90}}) 嵌入；失败则单元格写「图片加载失败」。
• 新增 parseFileList（JSON 字符串/数组→{fileUrl,fileName}[]，带兜底）、fetchImageAsBuffer（复用 photo 页写法，fetch 带 Authorization: Bearer token）、getImageExtension（png→png，其余→jpeg；注意 ExcelJS 不支持 'jpg' 字面量，必须映射到 'jpeg'）。

类型检查：引入的 getImageExtension 返回类型含 'jpg' 导致 TS2322，已改为返回 'png' | 'jpeg' 修正。index.vue 其余报错（模板 el-tag :type 返回 string、handleEdit/handleView 多传参、若干 TS6133 未用变量）均为 385 行之前的既有问题，与本次无关。

data-board/nine-safety-measures/index.vue — 对接真实看板接口（前两个对象）

用户要求：后台接口 nineRiskBoardGet（src/api/data-board/nine-safety.ts 第一个接口）已写好，先对接返回的 overview 和 itemRiskDistributions 两个对象，其余字段后续再对接。

改动：

• loadAllData：
  • 在参数里补 tenantIds（从 userStore.orgTenantId 取，数组化后传入）。
  • 把 getNineSafetyOverview 和 getNineRiskDistribution 两个 mock 调用合并成一次真实请求 echartsApi.nineRiskBoardGet(params)。
  • 其余 11 个 mock 接口继续保留（月度趋势、热力图、散点、箱线图、签署状态、红名单、评估人工作量、护理级别、相关性、雷达、3D 柱状图）。
• 字段映射：
  • overview：
  • disclosureTotal → totalElders（知情书总数）
  • highRiskTimes → highRiskCount（高风险总人次）
  • highRiskTimesRatio → highRiskRatio（高风险人次占比 %）
  • disclosureUnsignedCount → pendingSignatures（待签署知情书）
  • 100 - disclosureUnsignedRatio → signedRate（签署率 %）
  • assessCompleteRate → evalCompletionRate（评估完成率 %）
  • assessorCount → assessorCount（评估人员数）
  • itemRiskDistributions：
  • itemName → name
  • highCount → high
  • middleCount → medium
  • lowCount → low
  • unknownCount → none
  • totalCount → total

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — highRiskHeatMap 结构变更适配

用户反馈：highRiskHeatMap 字段结构有变化（顶部加了楼栋/楼层筛选后），cells 改为对象数组。

新结构：

• items：{code: itemCode, name: 九防名}
• builds：{code: buildId, name: 楼栋名}
• cells：{buildId, buildName, itemCode, itemName, highRiskElderCount, maxValue}

改动：

• 热力图映射不再依赖隐式 x/y 下标，改为通过 itemCode / buildId 在 items / builds 里查找索引。
• heatCells 过滤掉找不到对应索引的异常单元格。
• 顺带把 maxValue 存到 floorHeatmap / bar3D 对象里，供后续色阶归一化使用（当前渲染仍用自身计算的最大值，兼容安全）。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — 对接真实看板接口（剩余全部字段）

用户发了 12 张接口字段截图，要求把剩余字段全部对接。

改动：

• 新增 riskLevelRatios ref，renderOverallPie 改为从该 ref 读取（不再从 nineRiskDist 聚合）。
• loadAllData：
  • 只保留 getRiskRadar 一个 mock 调用（真实接口未提供"护理级别 × 九防高危占比"雷达图明细）。
  • 其余 10 个 mock 接口全部移除，统一从 nineRiskBoardGet 一次返回的数据里映射。
• 字段映射：
  • riskLevelRatios → renderOverallPie：riskLevelName/riskLevel → name，count → value，按 riskLevel 映射颜色。
  • monthlyTrends → riskTrend：month/highCount/middleCount/lowCount/unknownCount → month/high/medium/low/none。
  • highRiskHeatMap → floorHeatmap / bar3D：items → risks，builds → floors，cells → [buildIndex, itemIndex, value]。
  • highRiskElders → ageScatter：elderName/elderAge/elderSex/highRiskCount/nurseLevelName → name/age/sex/highCount/nurseLevel。
  • itemScoreDistributions → scoreDist：真实返回 buckets，按 count 累计计算五数概括（min/q1/median/q3/max）供箱线图使用。
  • disclosureSignRate → signature：signedCount/unsignedCount/total/signRate → signed/unsigned/total/signedRate，firstSignedOnly 给 0。
  • nurseLevelHighRiskElderCounts → nurseLevelRisk：nurseLevelName/count → name/high。
  • assessorStats → assessorWorkload：assessor/assessedElderCount/highRiskElderCount → name/count/highCount。
  • multiHighRiskElders → redList：elderId/elderName/elderSex/elderAge/bedName/buildName/nurseLevelName/assessor/highRiskItems/highRiskCount/assessDate → 页面字段；highRiskItems 按逗号拆分并去掉"防"字。
• 模板：红名单表格"评估日期"列从写死的 2022-12-12 改为 r.assessDate。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — highRiskHeatMap 结构变更适配

用户反馈：highRiskHeatMap 字段结构有变化（顶部加了楼栋/楼层筛选后），cells 改为对象数组。

新结构：

• items：{code: itemCode, name: 九防名}
• builds：{code: buildId, name: 楼栋名}
• cells：{buildId, buildName, itemCode, itemName, highRiskElderCount, maxValue}

改动：

• 热力图映射不再依赖隐式 x/y 下标，改为通过 itemCode / buildId 在 items / builds 里查找索引。
• heatCells 过滤掉找不到对应索引的异常单元格。
• 顺带把 maxValue 存到 floorHeatmap / bar3D 对象里，供后续色阶归一化使用（当前渲染仍用自身计算的最大值，兼容安全）。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — 雷达图改用 nurseLevelHighRiskRecordCounts

用户要求：「各护理级别 · 九防高危占比雷达」使用 nurseLevelHighRiskRecordCounts 数组。

背景：该数组只有 {nurseLevelId, nurseLevelName, count, ratio}，没有按九防拆分。原 mock 雷达图是「护理级别 × 九防」矩阵，真实数据无法直接还原该形态。

改动：

• loadAllData：移除最后一个 mock 调用 getRiskRadar，nineRiskBoardGet 成为唯一数据源。
• 护理级别数据映射：从 bd.nurseLevelHighRiskRecordCounts 读取，给 nurseLevelRisk 增加 count/ratio，保留 high（=count）供漏斗图继续使用。
• renderRiskRadar：改为读 nurseLevelRisk；indicator = 各护理级别名称；series 两个：「高危占比(%)」用真实 ratio，「记录数(归一化)」用 count/maxCount*100 避免数量级失真；tooltip 显示真实记录数和占比。
• 删除 riskRadar ref。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — highRiskHeatMap 结构变更适配

用户反馈：highRiskHeatMap 字段结构有变化（顶部加了楼栋/楼层筛选后），cells 改为对象数组。

新结构：

• items：{code: itemCode, name: 九防名}
• builds：{code: buildId, name: 楼栋名}
• cells：{buildId, buildName, itemCode, itemName, highRiskElderCount, maxValue}

改动：

• 热力图映射不再依赖隐式 x/y 下标，改为通过 itemCode / buildId 在 items / builds 里查找索引。
• heatCells 过滤掉找不到对应索引的异常单元格。
• 顺带把 maxValue 存到 floorHeatmap / bar3D 对象里，供后续色阶归一化使用（当前渲染仍用自身计算的最大值，兼容安全）。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — 评估得分分布箱线图数据映射修正

用户反馈：「评估得分分布（箱线图）」渲染异常，大部分项目被拉成 0~100 的细长线条，只有防跌倒、防噎食等少数项目能看出箱子。

根因：后台 itemScoreDistributions 返回了真实的 minScore / maxScore，也返回了 buckets（分桶统计）。原映射用 buckets[0].min 和 buckets[last].max 作为箱线图的 min/max，导致每个项目的上下须都钉死在 0 和 100，箱子被压扁；四分位数也只用桶下边界，没有插值。

改动：

• min/max 改为优先使用后台真实 minScore / maxScore，缺失时才回退到桶边界。
• 四分位数 q1 / median / q3 在桶内做线性插值，而不是直接取桶下边界。
• 空桶跳过，避免异常点干扰累计。
• 五数概括统一保留 2 位小数，避免浮点精度导致十几位小数。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — 按护理级别 · 高危项漏斗字段修正

用户反馈：「按护理级别 · 高危项漏斗」图表为空，后台真实字段是 nurseLevelHighRiskElderCounts。

根因：loadAllData 里护理级别数据仍从 bd.nurseLevelHighRiskRecordCounts 读取，与后台实际返回字段不一致，导致 nurseLevelRisk 为空，漏斗图没有数据。

改动：

• nurseLevelRisk 改为优先读取 bd.nurseLevelHighRiskElderCounts，同时兼容旧名 bd.nurseLevelHighRiskRecordCounts 作为 fallback。
• 漏斗图和雷达图共用 nurseLevelRisk，结构保持 {name, count, ratio, none, low, medium, high} 不变。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — 雷达图适配 nurseLevelHighRiskRecordCounts 新结构

用户反馈：nurseLevelHighRiskRecordCounts 数据结构已变化，需要按新结构重新渲染「各护理级别 · 九防高危占比雷达」。

新结构：

[
  {
    nurseLevelId,
    nurseLevelName,
    ratio,
    totalCount,
    items: [
      { itemCode, itemName, count, ratio }
    ]
  }
]

改动：

• 新增 nurseLevelRadarData ref，结构为 { indicators: [{name, max}], series: [{name, value, count, lineStyle, itemStyle, areaStyle}] }。
• loadAllData：从 bd.nurseLevelHighRiskRecordCounts 解析雷达数据；indicator 取第一条护理级别的 items.itemName；每个护理级别作为一条 radar series，value 为各九防项的 ratio（保留 2 位小数），count 为原始人数供 tooltip 使用。
• renderRiskRadar：改为读取 nurseLevelRadarData；indicator = 九防项目名称；legend 显示各护理级别名称；tooltip 展示该护理级别下每个九防项的占比和人数。
• 漏斗图继续使用 nurseLevelRisk（来自 nurseLevelHighRiskElderCounts），与雷达图数据源解耦。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — 评估人工作量统计 X 轴防拥挤

用户反馈：「评估人工作量统计」图表 X 轴标签太多、互相重叠。

改动：

• renderAssessorWorkload：
  • grid.bottom 从 30 加大到 90，给旋转标签留出垂直空间。
  • xAxis.axisLabel.rotate 从 40 度加大到 60 度，fontSize 从 11 降到 10，margin 从 8 加到 12。
  • 新增 dataZoom slider，默认展示前 12 条（或 40%，取较小者），底部出现横向滚动条，可拖动查看其余评估人。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — 修复 3D 楼栋图 tooltip 显示 undefined

问题：3D 楼栋×九防高危人数图表 hover 时 tooltip 显示 undefined - undefined，高危人数：undefined 人。

根因：ECharts bar3D 的 tooltip formatter 参数里，数据坐标/值位于 params.value，而 params.data 是 { value: [...] } 对象。原代码用 p.data[0] / p.data[2] 访问，拿到的是 undefined。

改动：render3DBar 的 tooltip formatter 改为从 p.value 读取 [楼栋索引, 九防索引, 高危人数]，并用 floors / risks 数组反查名称；同时加 ?? '-' 兜底，避免极端情况再次显示 undefined。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — 红名单九防筛选生效 + 评估日期格式化

问题：

1. 重点人群红名单的九防风险下拉筛选没有过滤效果。
2. 评估日期显示为数组形式 [2026,7,28]，需要格式化为正常日期。

根因：

• 之前 nineRiskOptions 的 value 已去掉"防"前缀，但 redList.risks 存储格式与下拉 value 的对应关系存在歧义，导致筛选不直观；同时 el-select 的 clearable 可能让空值判断不够健壮。
• assessDate 后台直接返回了 [年,月,日] 数组，原样渲染到表格。

改动：

• 统一使用带"防"前缀的风险名称：redList.risks 保留原始值（不再 .replace('防', '')），nineRiskOptions 的 value 也使用 r.name。
• 风险标签颜色计算时去掉"防"前缀以匹配 riskTagColor 的 key：riskTagColor(rk.replace('防', ''))。
• 新增 formatAssessDate 工具函数，支持数组、Date、字符串，统一输出 yyyy-MM-dd。
• redList 映射时 assessDate 使用 formatAssessDate(e.assessDate)。
• 模板中评估日期直接显示 r.assessDate（函数已返回 '-' 兜底）。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — 红名单风险筛选仍显示 0 人

问题：选择"防噎食"后，红名单显示"共 0 人"，但数据中应包含该风险项的长者。

根因：

• e.highRiskItems 可能以数组形式返回，原代码只按字符串 .split(',') 解析，导致数组被序列化为 "防噎食,防压疮" 这样的单一项。
• 即使解析正确，精确匹配 === 对空格、前缀不一致等边界情况不够健壮。

改动：

• redList.risks 解析改为同时支持数组和字符串：数组逐项 String().trim()，字符串按逗号拆分。
• filteredRedList 匹配逻辑增强：
  • 精确相等 s === redRiskFilter.value
  • 去掉"防"前缀后相等 s.replace('防', '') === keyword
  • 互相包含匹配 s.includes(redRiskFilter.value) || redRiskFilter.value.includes(s)
• 空字符串风险项会被过滤掉。

类型检查：NO_NINE_SAFETY_ERRORS。

data-board/nine-safety-measures/index.vue — 简易精神状态映射为防误食

问题：后端把「防误食」这条风险命名为「简易精神状态」，导致红名单选「防误食」过滤不出数据，且页面各图表会显示「简易精神状态」。

改动：

• 新增 normalizeRiskName 工具函数：输入 "简易精神状态" 时返回 "防误食"，其他名称原样返回。
• 在 loadAllData 中所有涉及九防项目名称的地方统一应用该映射：
  • nineRiskDist（九防风险等级分布）
  • heatItems（热力图/3D 图的九防轴标签）
  • scoreDist（评估得分分布箱线图）
  • nurseLevelRadarData（各护理级别雷达 indicator）
  • redList.risks（红名单高风险项标签与下拉筛选）
• 红名单下拉选项本身来自 NINE_RISKS，已固定为「防误食」，映射后筛选可正常命中。

类型检查：NO_NINE_SAFETY_ERRORS。

ContractBodyHubei.vue — 按《湖北省养老机构服务合同（2024版）》.docx 重写正文

用户要求：以桌面上的湖北 2024 标准合同 docx 为准，改造 src/views/elderly/contracts/components/ContractBodyHubei.vue，保留原组件设计模式（a4-page / section-title / content-text / FieldItem / SignatureItem）与功能，仅替换正文内容。

关键点（用户特别强调）：

• 费用章节保持动态生成，不要写死：monthlyExpenses / oneTimeExpenses / stageExpenses 三块列表渲染原样保留（template 第 1418/1471/1562 行附近）。
• 争议解决条款误用 accountName/bank 字段，已改为独立字段 disputeCourt / disputeArbitration。

新增字段（contractForm）：partyAEmail、partyAContactPhone、elderCensusAddr、elderPhone、elderEmail、roomFloor、bedNo、trialDays(默认7)、trialStart/End、renewDays、emergencyContact*、memberFeeAmt/Cn/RefundMode、penaltyPercent、disputeMode/Court/Arbitration、copyCount。

• fillContractForm / parse 回填均补了映射，memberFeeAmt 加中文大写 watch（同 deposit）。
• 正文覆盖：使用说明、甲乙丙方信息、第一条~第十四条（服务内容与方式、费用、期限与变更、护理等级、甲方/乙方权利义务、丙方责任、信息保护、保密、违约责任、免责、争议解决、合同生效附件）。
• 验证：ESLint 0 错误；vue-tsc 过滤 ContractBodyHubei 无报错。