🏠 安颐生活居 · 网站与小程序数据互通方案

版本 v1.1 ｜创建 2026-08-21 ｜更新 2026-08-21（养老圈子板块）

已完成 0 / 39 项

✅ 勾选即完成（进度自动保存在本浏览器 localStorage）

📌 架构概要

官网（Spring Boot + MySQL，主数据源）↔ 小程序（Flask + SQLite）通过 HTTP JSON API 双向互通
原则：不共享数据库、各用各的认证体系、官网为主、小程序为轻量入口
用户打通：小程序 openid ↔ 官网手机号（sys_user.username），官网签发 JWT 给小程序

小程序端 ──► api.cloudsupport.com.cn (Flask:5002, SQLite)
官网 Web  ──► cloudsupport.com.cn   (Spring Boot:8080, MySQL)
        └──── 互通 API（内部令牌双向调用）────┘

📦 互通数据清单

级别	数据项	方向	说明
A	养老圈子文章	官网→小程序	官网统一发布（政策/反诈/健康 6 类），同步到小程序健康生活页
A	老人评估结果	小程序→官网	总分/失能等级/分项得分 → 健康档案
A	老人档案	小程序→官网	基本信息/病史/风险/照护信息
B	用户身份打通	双向	openid ↔ 手机号绑定，一号通
B	服务与任务	官网→小程序	服务目录展示、小程序下单生成任务
B	照护员/企业	官网→小程序	服务人员与企业信息可见
C	服务目录	官网→小程序	分类/服务/价格同步展示
C	健康建议	官网→小程序	健康建议推送到小程序建议页
C	区域地址库	官网→小程序	完整三级地址库

🗂️ 分阶段待办清单

点击条目即可勾选/取消，进度自动保存

一、背景与目标

数据复用：小程序已有老人档案、评估结果、健康文章能在官网展示和使用
用户打通：同一用户在小程序和官网使用同一账号（手机号为桥梁）
业务闭环：官网的照护员/服务/任务体系能触达小程序用户，小程序成为下单入口
单向增量：以官网（MySQL）为主数据源，小程序为轻量入口，逐步收敛数据到官网

阶段 0：基础设施（约 0.5 天）

官网后端新增互通 Controller（WechatBridgeController），路径 /api/v1/bridge/*
配置官网后端允许小程序后端调用（Spring Security 放行 + 内部 token）
小程序后端新增互通 API 模块（Flask blueprint）
设计并实现内部服务令牌（官网签发 app-token，双向校验）
两后端互 ping 健康接口成功（/api/v1/bridge/ping ↔ /api/bridge/ping）

阶段 1：养老圈子内容板块 + 文章互通（约 2-3 天）

官网新增 cms_article 表（policy/fraud/diet/exercise/mental/disease 六类）
官网新增文章管理接口（增删改查/上下线）
官网新增公开文章接口：/api/v1/public/articles（列表+详情+阅读量）
将 /policy 静态政策内容迁移入库（category=policy）
将 /anti-fraud 静态反诈内容迁移入库（category=fraud）
网站导航改造：养老政策+反诈知识 → 合并为「养老圈子」板块（6 分类 Tab）
官网→小程序同步机制：定时将 cms_article 增量同步到小程序 health_articles
小程序健康生活页分类 Tab 增加：养老政策、反诈知识（共 6 类）
小程序阅读量回写官网 cms_article.read_count

阶段 2：老人档案 + 评估结果上官网（约 1-2 天）

官网新增老人档案模块（biz_elder_profile，对齐 elder_profiles 各 JSON 段）
官网新增评估记录表（biz_assessment_record）
迁移脚本：elder_profiles + assessment_records → 官网
官网'我的档案'页面 + 照护员端可查看老人评估摘要

阶段 3：用户打通（约 1-2 天）

官网 sys_user 新增 wechat_openid 字段（唯一索引，可空）
小程序'绑定手机号'流程：wx.getPhoneNumber → 官网 /api/v1/bridge/bind-phone → 建号/关联 → 返回 JWT
官网登录接口兼容：手机号+验证码或手机号+密码均可
小程序保存官网 JWT，访问官网业务 API 时携带

阶段 4：服务与任务闭环（约 2-3 天，核心业务）

官网标准服务 API 对小程序开放（只读）：/api/v1/bridge/services
小程序服务页展示官网服务目录（价格/时长/适用人群）
小程序用户下单 → 调官网 /api/v1/bridge/orders → 官网生成 biz_care_task（PENDING）
照护员在官网接单、服务、完成 → 状态同步回小程序

阶段 5：健康数据与建议闭环（约 1-2 天）

官网 biz_health_data 采集（硬件设备/手动录入）→ 生成 biz_health_advice
健康建议同步到小程序建议页（suggestions 页改造为读取官网 API）
小程序健康打卡数据上报官网（可选）

阶段 6：数据治理与完善（持续）

完整三级地址库导入官网 sys_region（已有三级地址库.xlsx + convertAreaData.js）
测试账号（13800138000 等）初始化进官网 sys_user
小程序老数据（users 38 行）清理/归档
定时同步任务（cron/systemd timer）确保两端增量数据一致
监控与日志：互通 API 调用量、错误率
安全加固：更换默认密钥（数据库/Redis/JWT）、令牌轮换