feat(报表分析): 新增签署总览等四个报表菜单并拆分演示数据开关

2026-09-24 21:03:39 +08:00
parent abe7e17582
commit 78402859fd
26 changed files with 3618 additions and 193 deletions
@@ -0,0 +1,294 @@
+/**
+ * 报表分析（签署总览 / 签署量分析 / 签署时效分析 / 患者结构分析）的数据源。
+ *
+ * 现状：后端没有任何分析聚合接口，所以这四个菜单目前只有演示数据。
+ * 这里刻意**返回任务级明细**而不是预先算好的聚合结果，原因是演示阶段聚合逻辑
+ * 要能被页面与验证脚本反复调用（换筛选条件、下钻、导出都基于同一份明细）。
+ *
+ * ⚠️ 真实接入时不要照搬这个形状：一次分析查询不该把全量任务明细拉到浏览器里算。
+ * 后端应按页面给出四个聚合接口（总览指标 + 趋势、签署量分组、时效指标 + 分组、
+ * 患者结构分组），届时这个模块退化成「按查询参数取聚合结果」，
+ * 页面侧的聚合函数随之删掉即可 —— 页面只消费聚合结果，不关心它从哪来。
+ *
+ * 演示数据的两条硬约束（都踩过）：
+ * 1. **确定性**：用固定种子的 PRNG，不用 Math.random。否则每次刷新数字都在跳，
+ *    截图对不上、验证脚本没法断言「筛选后行数应该变少」。
+ * 2. **锚定「距今天数」**：任务的日期按「N 天前」生成，不写死具体日期。
+ *    写死日期后过几天再打开，近 7 天 / 近 14 天 / 本月 全是空的，
+ *    演示时看起来像筛选坏了。
+ */
+
+import { mockFlags } from '@/utils/mock-flags'
+
+import { mockDocumentCatalog, campusOfDepartment } from './mock-catalog'
+import type {
+  PatientSex,
+  SigningMethod,
+  SigningTaskStatus,
+  VisitType,
+  WorkbenchCampus,
+} from './types'
+
+const useMockData = mockFlags.reportAnalytics
+
+export const isReportAnalyticsMockEnabled = useMockData
+
+/**
+ * 演示数据覆盖的天数。
+ * 比最长的时间筛选（本月按 1 号起算，最多 31 天）略短，够用且不至于让
+ * 「本月」看起来总是差几天；真要展示整月，把这里调到 31 即可。
+ */
+const DEMO_SPAN_DAYS = 30
+
+/** 演示任务量级：约 5 条/天，够让趋势图与排行榜有形状，又不会让表格卡顿 */
+const DEMO_TASK_COUNT = 152
+
+/** 一条报表任务行：聚合所需的全部维度都在这里，页面不再回查其它数据源 */
+export interface ReportTaskRow {
+  id: string
+  patientId: string
+  patientName: string
+  sex: PatientSex
+  age: number
+  visitType: VisitType
+  visitNo: string
+  campus: WorkbenchCampus
+  department: string
+  documentName: string
+  category: string
+  method: SigningMethod
+  status: SigningTaskStatus
+  /** 发起时间，`YYYY-MM-DD HH:mm`（与签署记录同一格式，便于直接比较与展示） */
+  createdAt: string
+  /** 签署完成时间；未完成的任务没有这一项 */
+  signedAt?: string
+  /** 签署用时（分钟）；只有已签署的任务有。超 1440 为超 24 小时，超 2880 为超期完成 */
+  signMinutes?: number
+}
+
+export interface ReportAnalyticsDataset {
+  tasks: ReportTaskRow[]
+  /**
+   * 数据是否可用。真实模式下没有后端接口，这里返回 false，
+   * 页面据此显示「后端尚未提供分析接口」的说明，而不是渲染一张全 0 的假报表。
+   */
+  available: boolean
+  /** 数据生成时刻（`YYYY-MM-DD HH:mm`），页面用于「数据截至」提示 */
+  generatedAt: string
+}
+
+/* =========================================================================
+   确定性随机
+   ========================================================================= */
+
+/** mulberry32：小、快、固定种子可复现 */
+function createRandom(seed: number): () => number {
+  let state = seed >>> 0
+
+  return () => {
+    state = (state + 0x6d2b79f5) >>> 0
+    let t = state
+    t = Math.imul(t ^ (t >>> 15), t | 1)
+    t ^= t + Math.imul(t ^ (t >>> 7), t | 61)
+
+    return ((t ^ (t >>> 14)) >>> 0) / 4294967296
+  }
+}
+
+function pick<T>(random: () => number, items: readonly T[]): T {
+  return items[Math.floor(random() * items.length)] as T
+}
+
+function intBetween(random: () => number, min: number, max: number): number {
+  return min + Math.floor(random() * (max - min + 1))
+}
+
+/* =========================================================================
+   演示患者池
+   ========================================================================= */
+
+interface DemoPatient {
+  name: string
+  sex: PatientSex
+  age: number
+  visitType: VisitType
+}
+
+/**
+ * 患者池。
+ *
+ * 含 3 名未成年患者：儿科知情同意同样由监护人签署，报表统计的是患者本人年龄。
+ * 未成年占比刻意保持在三成以下（3/24），与「综合医院里儿科签署只是小部分」的实际相符。
+ *
+ * ⚠️ **不要把「每个年龄段在任意时间窗内都非空」当作验收标准**：未成年任务只有十几条，
+ * 近 7 天窗口里恰好一条都没有是正常的（实测 2026-09-24 当天就是这样）。
+ * 年龄段分档的正确性由分档边界（17/18、40/41、60/61）来保证，不是由「每档都非空」。
+ * 为了让窄窗口好看而硬塞样本，会让年龄段分布失去真实形状。
+ */
+const DEMO_PATIENTS: DemoPatient[] = [
+  { name: '周雅琴', sex: '女', age: 29, visitType: '门诊' },
+  { name: '李淑芬', sex: '女', age: 67, visitType: '住院' },
+  { name: '赵美英', sex: '女', age: 58, visitType: '住院' },
+  { name: '陈志强', sex: '男', age: 61, visitType: '住院' },
+  { name: '王建国', sex: '男', age: 71, visitType: '住院' },
+  { name: '孙浩然', sex: '男', age: 54, visitType: '门诊' },
+  { name: '刘伟', sex: '男', age: 45, visitType: '门诊' },
+  { name: '吴桂芳', sex: '女', age: 73, visitType: '住院' },
+  { name: '黄志明', sex: '男', age: 66, visitType: '门诊' },
+  { name: '郑海燕', sex: '女', age: 38, visitType: '门诊' },
+  { name: '徐丽华', sex: '女', age: 50, visitType: '体检' },
+  { name: '马晓东', sex: '男', age: 42, visitType: '其他' },
+  { name: '林俊杰', sex: '男', age: 34, visitType: '体检' },
+  { name: '何秀英', sex: '女', age: 62, visitType: '住院' },
+  { name: '邓小燕', sex: '女', age: 27, visitType: '门诊' },
+  { name: '曹明辉', sex: '男', age: 57, visitType: '住院' },
+  { name: '袁丽', sex: '女', age: 19, visitType: '门诊' },
+  { name: '沈国强', sex: '男', age: 78, visitType: '住院' },
+  { name: '崔文静', sex: '女', age: 46, visitType: '体检' },
+  { name: '侯志远', sex: '男', age: 36, visitType: '门诊' },
+  { name: '龚雨萱', sex: '女', age: 6, visitType: '门诊' },
+  { name: '范子墨', sex: '男', age: 14, visitType: '住院' },
+  { name: '柳思彤', sex: '女', age: 16, visitType: '门诊' },
+  { name: '严志刚', sex: '男', age: 52, visitType: '其他' },
+]
+
+/* =========================================================================
+   演示任务生成
+   ========================================================================= */
+
+/** 状态分布：已签署占多数，其余各留一点，六种状态在总览统计块里都看得到 */
+const STATUS_WEIGHTS: { status: SigningTaskStatus; weight: number }[] = [
+  { status: 'signed', weight: 68 },
+  { status: 'pending', weight: 9 },
+  { status: 'signing', weight: 5 },
+  { status: 'expired', weight: 8 },
+  { status: 'void', weight: 5 },
+  { status: 'failed', weight: 5 },
+]
+
+const STATUS_TOTAL_WEIGHT = STATUS_WEIGHTS.reduce((sum, item) => sum + item.weight, 0)
+
+function pickStatus(random: () => number): SigningTaskStatus {
+  let roll = random() * STATUS_TOTAL_WEIGHT
+
+  for (const item of STATUS_WEIGHTS) {
+    roll -= item.weight
+
+    if (roll <= 0) {
+      return item.status
+    }
+  }
+
+  return 'signed'
+}
+
+function pad(value: number): string {
+  return String(value).padStart(2, '0')
+}
+
+function formatMoment(date: Date): string {
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`
+}
+
+/**
+ * 签署用时（分钟）。
+ *
+ * 分三段构造，保证「24 小时内完成率」与「超期完成」两张表都拿得到样本：
+ * 大部分在 3~120 分钟，一部分落在 24 小时附近，少数超过 48 小时有效期。
+ */
+function buildSignMinutes(random: () => number): number {
+  const roll = random()
+
+  if (roll < 0.82) {
+    return intBetween(random, 3, 720)
+  }
+
+  if (roll < 0.94) {
+    return intBetween(random, 720, 2880)
+  }
+
+  return intBetween(random, 2881, 6600)
+}
+
+function buildTasks(): ReportTaskRow[] {
+  const random = createRandom(20260924)
+  const rows: ReportTaskRow[] = []
+  const today = new Date()
+
+  for (let index = 0; index < DEMO_TASK_COUNT; index += 1) {
+    const patient = pick(random, DEMO_PATIENTS)
+    const document = pick(random, mockDocumentCatalog)
+    const status = pickStatus(random)
+    const method: SigningMethod = random() < 0.45 ? 'pad' : 'sms'
+
+    // 越靠近今天的任务越少：真实签署量不会是均匀分布，均匀分布的趋势图一眼假
+    const daysAgo = Math.floor(DEMO_SPAN_DAYS * Math.pow(random(), 1.35))
+
+    const createdAt = new Date(today)
+    createdAt.setDate(createdAt.getDate() - daysAgo)
+    createdAt.setHours(intBetween(random, 8, 19), intBetween(random, 0, 59), 0, 0)
+
+    const isSigned = status === 'signed'
+    const signMinutes = isSigned ? buildSignMinutes(random) : undefined
+
+    const row: ReportTaskRow = {
+      id: `RT${createdAt.getFullYear()}${pad(createdAt.getMonth() + 1)}${pad(createdAt.getDate())}${pad(index + 1)}`,
+      patientId: `P${202610000 + (DEMO_PATIENTS.indexOf(patient) + 1)}`,
+      patientName: patient.name,
+      sex: patient.sex,
+      age: patient.age,
+      visitType: patient.visitType,
+      visitNo: `${patient.visitType === '住院' ? 'ZY' : patient.visitType === '体检' ? 'TJ' : 'MZ'}${createdAt.getFullYear()}${pad(createdAt.getMonth() + 1)}${pad(createdAt.getDate())}${pad(index + 1)}`,
+      campus: campusOfDepartment(document.department),
+      department: document.department,
+      documentName: document.name,
+      category: document.category,
+      method,
+      status,
+      createdAt: formatMoment(createdAt),
+    }
+
+    if (signMinutes !== undefined) {
+      const signedAt = new Date(createdAt.getTime() + signMinutes * 60_000)
+      row.signMinutes = signMinutes
+      row.signedAt = formatMoment(signedAt)
+    }
+
+    rows.push(row)
+  }
+
+  // 按发起时间倒序：页面与导出的默认顺序都跟这里一致，不必各自再排一次
+  return rows.sort((a, b) => b.createdAt.localeCompare(a.createdAt))
+}
+
+/* =========================================================================
+   对外接口
+   ========================================================================= */
+
+let cachedTasks: ReportTaskRow[] | null = null
+
+/** 演示数据只生成一次：确定性生成也要避免每次进页面都重跑一遍 */
+function readTasks(): ReportTaskRow[] {
+  cachedTasks ??= buildTasks()
+
+  return cachedTasks
+}
+
+/**
+ * 取报表分析数据集。
+ *
+ * 真实模式下后端没有对应接口，返回 `available: false` 而不抛错：
+ * 报表页拿到空数据时的正确表现是「说明原因」，不是弹一个红色报错 ——
+ * 后端没上线不是用户的错，也不该看起来像页面坏了。
+ */
+export async function getReportAnalyticsDataset(): Promise<ReportAnalyticsDataset> {
+  if (!useMockData) {
+    return { tasks: [], available: false, generatedAt: formatMoment(new Date()) }
+  }
+
+  return {
+    tasks: readTasks(),
+    available: true,
+    generatedAt: formatMoment(new Date()),
+  }
+}