面向居家养老服务机构的全链路运营管理 SaaS。客户为河北石家庄一家养老机构,管理 200 余位长者与 40 余位服务人员,业务覆盖助餐、助浴、助洁、助医陪诊、康复护理与精神慰藉六类上门服务。原有痛点:纸质工单流转 24 至 48 小时、健康数据靠手抄无连续曲线、月度结算对账 3 天。
架构为单一事实源后端加三端共享 API。后端用 Python、FastAPI、SQLAlchemy、PostgreSQL 与 Redis,JWT 加 RBAC 鉴权,自动生成 48 个业务模块的增删改查;Web 管理端用 React、Vite 与 TypeScript,配置驱动通用组件,覆盖 167 个功能点;服务端 App 用 React Native 与 Expo,覆盖 Android 与 iOS,实现扫码签到与服务回填;长者与家属端为微信小程序,可查看健康档案并一键呼叫;部署用 Docker Compose 与 Nginx 多阶段镜像,服务器无需装 Node。
功能覆盖九域:客户档案(长者信息、健康档案、亲属关联、ADL 评估)、服务工单(智能派单、抢单池、扫码签到、回填评价)、健康监测(血压血糖心率录入、多阈值告警)、膳食管理(老年菜品库、营养计算、慢病禁忌过滤)、合同结算(计费规则、月度结算单导出)、物资库存(出入库、盘点、临期预警)、应急告警(SOS、跌倒侦测、离床超时)、第三方对接(短信网关、智能硬件、支付医保)、经营驾驶舱(营收趋势、人员产能看板)。
我的核心贡献:一是注册表驱动架构,48 个模块在单一 Python 文件中定义,构建阶段自动生成三端配置,无逐模块 UI 代码,新增模块只需改一行;二是 JWT 加 RBAC 鉴权,双令牌与角色精细授权,自动拦截越权;三是种子数据生成器,按字段语义生成 1200 余行演示数据,首启即非空;四是六套共 160 项自动化校验,覆盖后端单测、端到端接口、Web 一致性、小程序、App 与部署。
亮点是改一处、全端同步,新增模块最快 30 分钟可验收,总代码量 6407 行,较逐模块开发减少约七成。难点一是配置漂移,注册表变更后三端不同步会致前端静默报错,方案是强制字段比对;二是演示空表,方案是字段语义联动生成加非空校验。