更新记录

1.0.1（2026-10-22） 下载此版本

本项目仅开源 uni-app 社区康养用户端（基于 Vue3），可在电脑浏览器、手机浏览器、微信小程序、手机 App 等多端运行。用 HBuilderX 导入本目录即可本地体验，供学习研究。

平台兼容性

uni-app(3.8.7)

其他

社区康养 · 用户端

开源说明

本项目仅开源 uni-app 社区康养用户端（基于 Vue3），可在电脑浏览器、手机浏览器、微信小程序、手机 App 等多端运行。用 HBuilderX 导入本目录即可本地体验，供学习研究。

这是什么软件

这是一个面向社区居民，尤其是中老年用户的一站式社区健康养老服务平台。您可以在手机上完成：

• 看健康：记录健康档案、查看血压等趋势、绑定智能手环/血压计、AI 初步问诊、预约社区医生
• 逛社区：绑定所在社区，查看公告、活动、健康资讯，报名参与邻里活动
• 享服务：社区食堂订餐、邻里互助信息发布、报修、志愿服务、灵活就业、预约上门家政/护理等服务
• 逛商城：购买康养商品、积分兑换、拼团（若后台开启）、查看物流、申请售后
• 管账户：会员成长、钱包充值提现、分销推广赚佣金

底部有五个主入口：首页、社区、商城、服务、我的。

部分账号还具备特殊身份入口（登录后出现在「我的」页）：

• 社区员工 → 「员工中心」：管理活动、报修、志愿、招聘、食堂排菜、健康资讯等
• 社区医生 → 「医生工作台」：处理预约问诊、与居民在线沟通

能在哪些地方使用

应用内置长辈模式和字体大小调节，可在「设置」中开启，方便视力不佳的用户阅读。

对接了哪些第三方

下面列出的是用户能直接感受到的外部服务，用大白话说明「干什么用」：

平台服务端（自建，非第三方 SaaS）

登录与账号安全

支付与资金

文件存储

地图与定位

AI 与健康

内容安全（平台后端）

客服与沟通

物流与售后

分享与设备能力

说明：本用户端未接入实时音视频通话（视频电话）、第三方快递轨迹自动查询 API 等能力；以当前代码为准。拼团模块在商城 Tab 中默认隐藏，需后台开启后才显示。

用户能做什么（功能详解）

首页 · 一眼掌握社区动态

• 搜索入口：可搜索活动、健康资讯、志愿服务等内容。
• 消息铃铛：右上角显示未读消息数量，点击进入消息中心。
• 绑定社区引导：若尚未绑定社区，会提示「绑定社区，查看本地服务」，点击可选择社区、楼栋、房间完成绑定。
• 轮播广告：首页顶部轮播图由后台配置，可点击跳转（如活动页、商品页、外链等）。
• 便捷服务金刚区：后台配置的快捷入口（如健康档案、在线问诊、食堂订餐、社区报修等），一键进入对应功能。
• 热门活动：横向滑动展示本社区正在报名的活动；可直接报名或查看详情。
• 下拉刷新：下拉页面可刷新最新内容。

社区 · 本地生活资讯

• 社区身份头部：显示当前绑定社区名称，可切换或重新绑定社区。
• 数据概览：展示「正在报名」活动数、健康资讯数、社区公告数。
• 最新公告条：滚动展示最近一条社区公告，点击进入公告列表。
• 正在发生：主推一张热门活动大卡片，下方横向展示更多活动。
• 健康资讯：分类浏览社区健康科普文章，点击查看详情。
• 社区公告：查看社区发布的通知、政策、停水停电等信息。

商城 · 康养商品购物

• 商品搜索：按关键词搜索商品。
• 购物车：右上角显示购物车商品数量，可进入购物车结算。
• 分类浏览：按商品分类（如保健品、器械、日用等）筛选。
• 商品详情：查看商品图片、价格、销量、详情介绍；可加入购物车或立即购买。
• 拼团特惠（若后台开启）：参与多人拼团享折扣价。
• 收藏商品：可将喜欢的商品加入「我的收藏」。

服务 · 社区生活服务

• 服务入口网格：后台配置的服务快捷入口，常见包括：
  • 食堂订餐：查看今日推荐菜品，进入完整菜单下单
  • 邻里信息：浏览/发布互助信息
  • 社区报修：提交维修申请
  • 志愿服务：报名参与志愿活动
  • 灵活就业：浏览社区招聘岗位
• 今日食堂推荐：横向展示当天推荐菜品及价格，点击进入菜品详情或完整食堂页。

我的 · 个人中心

未登录时

• 展示登录引导，说明登录后可查看订单、健康数据、积分等。

已登录时

• 头像与昵称：显示用户头像、昵称、用户 ID；点击进入个人资料编辑。
• 会员卡片：展示当前会员等级、成长值进度、距离下一等级还需多少成长值。
• 资产概览：
  • 钱包余额：点击进入钱包，可充值、提现、查看流水
  • 我的积分：点击进入积分商城兑换礼品
• 功能菜单（根据身份动态显示）：

设置入口（右上角齿轮）：长辈模式、字体大小、消息通知开关、隐私设置、关于我们、用户协议等。

登录、注册与实名

健康档案与健康数据

• 健康档案：填写姓名、年龄、性别、***；记录既往病史（高血压、糖尿病等可多选或自定义）、过敏史、用药情况、紧急联系人等，保存后供问诊、上门服务参考。
• 健康趋势：以图表展示血压、血糖、心率、体重、步数等指标的变化趋势；可按日/周/月查看。
• 血压明细：选中某一天，查看该日各时段的血压测量记录列表。
• 手动录入：可手动添加一条健康测量记录（如自测血压）。
• 亲属健康关注：
  • 通过手机号邀请亲属绑定，对方确认后可互相关注
  • 查看亲属的健康状态概览（血压、心率等指标及是否正常）
  • 一键拨打亲属电话
  • 处理待确认的绑定请求（同意/拒绝）

智能设备

• 已绑定设备列表：展示绑定的智能血压计、手环等设备，显示在线/离线状态、最近测量数值与时间。
• 蓝牙搜索绑定（App / 微信小程序）：
  • 自动搜索附近蓝牙健康设备
  • 选中设备后提交绑定；也可手动输入设备码绑定
• 预警记录：设备测量异常（如血压偏高）时，平台推送预警，在此查看历史预警列表。
• 解绑设备：不再使用时可将设备从账号解绑。

在线问诊与 AI 健康助手

• AI 智能问诊：
  • 选择常见症状标签（如头痛、咳嗽、失眠等）
  • 文字描述症状、持续时间、既往病史
  • 提交后由豆包 AI 分析，生成初步诊断建议、注意事项、推荐科室等
  • 可查看历史问诊记录及详细结果
• AI 健康助手（对话页）：
  • 与 AI 助手多轮文字对话，描述不适获取参考建议
  • 支持快捷症状标签一键填入
  • AI 仅提供初步参考，不替代医生诊断；遇紧急症状会提示就医或拨打 120
• 预约社区医生：
  • 按日期查看可预约的医生列表
  • 选择时段提交预约
  • 在「我的预约」查看预约状态（待就诊、已完成等）
• 医患沟通：
  • 预约后可在工作台/预约详情进入与医生的聊天
  • 支持文字、图片、语音、视频消息
  • 新消息通过 WebSocket 实时推送

社区活动

• 活动列表：按类型（文化、健康、娱乐等）、时间筛选本社区活动。
• 活动详情：查看活动时间、地点、人数、介绍、封面图；报名中时可一键报名。
• 我的报名：查看已报名活动的记录与状态。

健康资讯

• 资讯列表：按分类浏览健康科普、养生知识等文章。
• 资讯详情：阅读正文，可收藏文章。

社区公告

• 公告列表：查看社区发布的全部公告。
• 首页/社区 Tab 也会展示最新公告摘要。

邻里信息

• 信息列表：按类型（闲置转让、求助、技能分享等）浏览邻居发布的信息。
• 信息详情：查看标题、描述、图片、发布者信息；可发起「邻里咨询」在线沟通。
• 发布信息（需实名通过）：
  • 选择类型，填写标题、详细描述
  • 上传图片（最多 9 张）
  • 填写联系方式
  • 提交后展示在列表（可能经平台/百度内容审核）
• 邻里咨询：
  • 与发布者一对一文字聊天
  • 会话列表统一管理，未读消息有角标
  • WebSocket 实时推送新消息

社区报修

• 提交报修（需实名通过）：
  • 选择报修类型（水电、门窗、电梯等）
  • 填写问题描述、所在位置
  • 上传现场照片
  • 提交后生成工单，等待社区员工处理
• 报修记录：查看历史工单及状态（待处理、处理中、已完成、已关闭）。

志愿服务

• 志愿活动列表：浏览社区发布的志愿活动（如助老、环保、义诊等）。
• 活动详情：查看时间、地点、所需人数、积分奖励；可报名参与。
• 我的志愿：查看报名记录、服务时长、获得积分等统计。

灵活就业

• 岗位列表：按分类浏览社区周边兼职、零工岗位。
• 岗位详情：查看工作内容、要求、薪资、联系方式。
• 投递简历：填写简短自我介绍后提交申请。
• 我的投递：查看投递记录及状态。

食堂订餐

• 日期与餐次：选择订餐日期（今日/未来几天）、餐次（早餐/午餐/晚餐）。
• 菜品分类：按热菜、凉菜、主食、汤品等筛选。
• 菜品详情：查看图片、价格、标签、营养说明。
• 购物车：加减数量，查看合计金额。
• 下单支付：确认订单后选择微信/支付宝/零钱支付。
• 取餐方式：目前为到店核销取餐——支付成功后获得核销码，到食堂出示给工作人员核销取菜（暂不支持配送到家）。

上门服务

• 服务项目：浏览可预约的上门服务项目（如家政保洁、陪诊、康复护理等，以后台配置为准）。
• 预约流程：
  • 选择服务项目
  • 选择预约日期与可用时段
  • 填写服务地址（可选用地图选点）、联系人、备注
  • 确认订单并支付
• 服务评价：服务完成后可对本次服务打分、写评价。

商城购物流程

• 加入购物车 / 立即购买 → 确认订单：
  • 选择收货地址（商城实物商品）
  • 填写订单备注
  • 选择支付方式并支付
• 我的订单：
  • 按状态筛选：待付款、待发货、待收货、已完成、已取消等
  • 查看订单详情、取消未支付订单、确认收货
• 物流详情：查看快递公司、单号、运输轨迹，可复制单号。
• 使用凭证：部分虚拟/服务类订单展示核销码或电子凭证。
• 售后申请：
  • 选择售后原因，填写说明，上传凭证图片
  • 退货退款时需填写退货快递公司与单号
  • 在「售后进度」跟踪处理状态

拼团活动（若后台开启）

• 拼团列表：浏览正在进行的拼团商品。
• 拼团详情：查看拼团价、成团人数、剩余时间；可发起拼团或参与他人拼团。
• 成团后按普通订单流程发货。

会员中心

• 查看当前会员等级、专属权益说明。
• 消费、签到等行为可积累成长值，升级解锁更多权益（具体以后台规则为准）。

积分商城

• 积分商品列表：用积分兑换礼品、优惠券等。
• 兑换详情：查看所需积分、库存、兑换说明；确认后扣减积分。
• 兑换记录：查看历史兑换订单。
• 积分明细：查看积分获得与消耗流水。

钱包

• 余额查询：显示当前钱包可用余额。
• 充值：选择金额，通过微信或支付宝充值到钱包。
• 提现：将钱包余额提现到绑定的收款账户（需实名，后台审核打款）。
• 交易流水：查看充值、消费、提现等记录。

分销推广

• 邀请好友：展示专属邀请码与二维码，可复制文案、生成海报、微信分享（小程序）。
• 我的团队：查看一级、二级推广成员数量与列表。
• 我的收益：查看累计佣金、可提现金额、收益明细。
• 推广订单：查看下级用户产生的推广订单。
• 佣金提现：申请将佣金提现到收款账户。

收货地址

• 地址列表：管理多个收货地址，可设默认。
• 新增/编辑地址：
  • 填写收货人、手机号
  • 选择省市区（全国行政区划树）
  • 可点击「定位」自动获取当前位置并反查地址
  • 可打开地图选点微调位置
  • 填写详细门牌号

消息中心

• 展示平台推送的系统消息（实名审核、问诊结果、订单状态、活动提醒、设备预警等）。
• 消息按分类、标题、摘要、时间展示；未读消息高亮。
• 点击可跳转到对应业务页面（若消息配置了跳转链接）。
• 支持「全部已读」。

帮助中心

• 按分类浏览常见问题与操作指南。
• 搜索关键词查找相关帮助文章。
• 查看文章详情。

设置

搜索

• 全局搜索活动、资讯、商品、服务等。
• 展示热门搜索词推荐。

员工中心（社区员工身份）

• 首页概览：待办事项统计。
• 活动管理：发布/编辑/结束社区活动，查看报名名单。
• 报修工单：查看居民报修列表，处理工单（派单、完成、备注）。
• 志愿管理：发布/编辑志愿活动，审核报名、签到。
• 就业招聘：发布/编辑/下架岗位，查看投递申请。
• 食堂排菜：维护菜品库、每日排菜、查看订餐订单、核销取餐、标记配送。
• 健康资讯：发布/编辑/删除资讯文章。

医生工作台（社区医生身份）

• 任务列表：按状态筛选预约问诊任务（待处理、进行中、已完成）。
• 任务详情：查看患者信息、预约时间、症状描述；可拨打电话联系患者。
• 完成问诊：填写诊断结论、建议，标记任务完成。
• 医患沟通：进入与患者的聊天页，收发文字/图片/语音/视频消息。

付钱怎么付（汇总）

不同场景，可选支付方式略有不同：

按打开方式：

支付前会弹出确认；支付成功后订单状态会自动更新（第三方支付会短暂轮询确认结果）。从支付宝 H5 跳回后，再次打开页面会继续查单。

体验地址

线上 API 环境：https://sqky.xianmxkj.com

技术栈

本地运行

这份代码已对接线上体验环境，默认不用改配置，打开后直接运行即可（API 与 WebSocket 地址见 common/config.js）。

开始前请准备

1. 一台 Windows 或 Mac 电脑。
2. 下载安装 HBuilderX（官方开发工具）：
   打开 https://www.dcloud.io/hbuilderx.html，下载「正式版」并安装。
3. 建议安装 Chrome 浏览器，用于运行 H5 页面。

第一步：打开项目文件夹

1. 找到本仓库里的 uniapp-app-shequkangyang 文件夹（里面有 pages.json、App.vue、common 等）。
2. 记住文件夹路径，后面要在 HBuilderX 里选中这一层目录。

第二步：用 HBuilderX 导入

1. 打开 HBuilderX → 文件 → 打开目录。
2. 选中 uniapp-app-shequkangyang 文件夹，确定。
3. 左侧出现文件树即表示成功。

第三步：运行到浏览器

1. 菜单 运行 → 运行到浏览器 → Chrome。
2. 首次可能提示安装插件，按提示安装后重试。
3. 浏览器弹出页面，能看到首页和底部五个 Tab（首页、社区、商城、服务、我的），即运行成功。
4. 保持 HBuilderX 不要关闭，否则调试可能中断。

运行到微信小程序（可选）

1. 菜单 运行 → 运行到小程序模拟器 → 微信开发者工具。
2. 首次需安装微信开发者工具并登录。
3. 在微信开发者工具 详情 → 本地设置 中勾选「不校验合法域名……」，否则本地联调可能请求失败。
4. 小程序内可体验微信一键登录、微信支付、蓝牙搜设备等（需后台商户号与设备配置完整才真正可用）。

常见情况

第一次验收建议

1. Chrome 打开后能看到首页和底部五个 Tab。
2. 点「我的」能看到登录入口。
3. 点「社区」未绑定时会提示绑定社区。
4. 点「商城」能看到商品列表（或空态提示）。

做到以上几点，说明用户端已在本地跑通。

许可证

见本目录下 LICENSE 文件。