区域长管理周报表 — 开发方案

1.1 什么是区域长管理周报表？

区域长每周填写的综合性运营报表，汇总本区域当周的 经营指标、质量指标、团队指标 三大类数据，每周一张。

遵循样式先行 → 规则锁定 → 数据就位 → 页面打通的核心原则，每步可独立验收。

不采用单张宽表（太臃肿），也不过度拆分（JOIN太多）。用 原始表 + 缓存表 + 手工表 三层分离，各司其职。

3.1 Layer 1 — 原始数据层（轻流同步）

按业务条线分表存储，每张表对应一个轻流 appKey。这张图列出所有可能涉及的表：

3.2 Layer 2 — 计算缓存层

每周运行一次 analyze_weekly.py，从原始表按机构+休养区+日期聚合，写入缓存表：

3.3 Layer 3 — 展示层

报表页面从缓存表读取数据，秒级渲染。手动填报项从 report_manual_entries 读取并合入。

# 数据流全链路
轻流 openApi → sync_*.py → MySQL原始表
                              ↓
                     analyze_weekly.py
                              ↓
                   weekly_report_snapshot  ←  report_manual_entries
                              ↓
                       Flask API (/api/weekly-report?...)
                              ↓
                      HTML 报表页面（动态渲染）

按数据获取方式将全部指标分为三类，决定开发路径和优先级。

4.1 A类指标当前覆盖情况

以下A类指标的数据已在 MySQL 中，可通过 SQL 直接计算。但部分字段需要追加到现有同步脚本中：

周报表项目完全复用现有的护理漏测/不良事件系统的同一套基础设施：

5.1 新建内容清单

• 2~3 张新原始表（员工、满意度、增值收入——取决于轻流中是否有对应应用）
• 3 张缓存表（weekly_report_snapshot / report_indicator_values / report_manual_entries）
• 1 个分析脚本（analyze_weekly.py）
• 1 个报表页面（weekly-report.html，从 Step 1 的静态模板升级）
• 若干 Flask API（/api/weekly-report/data、/api/weekly-report/manual-save 等）

6.1 分三阶段推进

6.2 你需要的输入

• 入住协议表单中"失能险标记"的 queId（如果存在）
• 入住协议表单中"请假外出状态"的 queId（如果存在）
• 员工管理 / 满意度 / 增值收入的轻流 appKey（如果有对应应用）
• 所有缺失字段的 queId → 含义对照表

7.1 轻流字段前置条件

7.2 缓存表的快照特性

每周的分析结果写入 weekly_report_snapshot 后不再更新。这是刻意设计——保证了历史周报表不会因为后续数据变化而失真。

7.3 手动填报数据的持久化

• C 类手动填报数据写入 report_manual_entries，不混入缓存表
• 页面渲染时分层读取：缓存表（自动）+ 手工表（手动），在前端合并
• 下次分析不会覆盖手工数据

7.4 复用已有部署规范

• HTML 页面需同时部署到 /opt/leakcheck/ 和 /opt/site/
• Python 脚本用 pymysql + charset=utf8mb4 避免中文乱码
• queId 在 API 请求中必须传 int 类型
• pageSize 上限为 200

7.5 报表样式规范

• 表头信息行独立于表格之上
• 一级指标用彩色竖排标签（绿/橙/蓝）
• 二级指标组之间用 3px 粗灰线分隔
• 关键数值红/绿/橙三色高亮
• 响应式：窄屏横向滚动