颐养通居家养老运营平台产品系统Vibe Coding

1. 立项原因
随着老龄化加速，居家养老成为国家"9073"工程（90% 居家、7% 社区、3% 机构）的核心场景。但居家养老机构的日常运营长期依赖纸质单据与 Excel：服务人员上门靠手写工单、健康数据靠家属口述、订单派发靠电话——运营人效低、漏单错单频发、客户体验差。
2. 行业场景与业务背景
本系统服务的客户是位于河北石家庄的一家居家养老服务机构，旗下有 200+ 位登记长者、30+ 位一线服务人员、5 位医生 + 3 位评估师 + 10 余位志愿者，业务覆盖助餐、助浴、助洁、助医陪诊、康复护理、精神慰藉六大上门服务类别。
3. 核心痛点

工单流转慢：纸质派单 → 现场手写 → 回公司录入，全流程 24-48 小时，客户投诉响应滞后
健康数据盲区：长者血压 / 血糖依赖家属手抄、医生上门才能采集，无法形成连续健康曲线，异常无法及时干预
结算对账繁：每月人工核对工时、补贴、扣款，财务对账需 3 天/次
应急响应慢：长者突发 SOS，传统电话链路平均 8 分钟才到一线服务人员
管理层决策缺数据：营收、人员产能、服务满意度等指标散落在多份 Excel，无法实时看经营状况

本系统按业务域划分为 48 个功能模块，覆盖居家养老机构从前端获客到后端结算的全链路：
1. 客户与档案：长者基础档案、健康档案、亲属关联、ADL/MMSE 评估记录
2. 服务工单：智能派单（按距离/专长/负载）、抢单池、扫码签到（GPS 校验）、服务回填（含照片/量表）、客户评价、改派与退单
3. 健康监测：血压/血糖/心率/体温日常录入、多阈值分级告警、历史曲线与异常归档、与智能硬件对接（蓝牙血压计/手环自动同步）
4. 膳食管理：800+ 道适合老年人的菜品库（按软硬度/口味/慢病禁忌分类）、每餐营养自动计算、糖尿病/高血压/肾病自动过滤不适宜菜品
5. 合同结算：服务合同模板、按月/按次计费、工时统计与补贴、月度结算单自动生成可导出 PDF
6. 员工排班：服务人员/医生/评估师/志愿者 4 类角色管理、班次排定与考勤、工作量统计与绩效看板
7. 物资库存：护理物资（一次性护理垫/轮椅/血压计等）出入库、库存盘点、临期预警、领用审批
8. 应急告警：SOS 一键呼叫（手环/App/家属/服务台多通道）、跌倒侦测（手环加速度传感器）、夜间离床超时未归、心率骤变多通道通知
9. 第三方对接：短信网关（验证码/告警）、智能硬件（手环/血压计/烟感/门磁/人体感应）、微信支付与医保接口预留
10. 经营驾驶舱：营收趋势（近 7/30/90 日）、人员产能（人均单数/工时利用率）、未结工单、异常告警、客户活跃度多维看板、一键导出日报/周报/月报

1. 整体架构
单一事实源后端 + 三端共享 API：
后端：Python + FastAPI + SQLAlchemy + PostgreSQL + Redis，JWT 鉴权（access 短期 + refresh 长期）+ RBAC，按业务域自动生成 48 个 CRUD 模块
Web 管理端：React + Vite + TS，配置驱动表单/列表/详情/编辑，覆盖 167 个功能点
服务端 App：RN + Expo（Android+iOS），扫码签到/服务回填/告警接收
长者/家属端：微信原生小程序，远程查看健康档案/服务记录、一键呼叫
部署：Docker Compose + Nginx 多阶段构建镜像，服务器无需装 Node
2. 我的核心贡献
注册表驱动架构：48 个模块在单一 Python 文件 registry.py 定义，CI 阶段自动生成三端配置（Web JSON / 小程序 CommonJS / App JSON），全项目无任何一行逐模块 UI 代码。新增模块成本 = 改 1 行注册表 + npm run gen
JWT + RBAC 鉴权改造：access/refresh 双令牌 + 按角色精细授权；CI 自动拦截越权与配置漂移
种子数据生成器：基于字段语义联动（性别-姓名/类型-内容/价格-类别）生成 1200+ 行可信演示数据，本地化姓名/石家庄街道/三甲医院，首启即非空
6 套 160 项自动化校验：pytest / 后端 E2E / Web 一致性 / 小程序 / RN / 部署配置，拦截静默 422/403
3. 亮点与难点
亮点 1：单一事实源让"改一处、全端同步"——客户新增模块从需求到三端可验收最快 30 分钟
亮点 2：代码量极小——后端 949 / Web 1033 / 小程序 2754 / RN 1671 = 总计 6407