把每一次吃药、打针、输液都记清楚,家人可以一起管。
面向用药人与监护人的协作式用药本:药品库存、用药计划、到点提醒、打卡记录、处方识别与依从性统计。 当前版本 v0.2.0,已在飞牛 NAS 真机安装并完成通知渠道与处方识别的联调。
按医嘱长期吃药、打针、输液时,最容易出的问题不是"不知道要做什么",而是:
- 到点忘了 —— 应用按计划提前、到点、逾期分三级提醒,直到完成或明确跳过;
- 做完没记 —— 一键打卡,误点可撤销,库存自动扣减;
- 剩多少不清楚 —— 批次库存 + 有效期 + 低库存预警;
- 复诊说不清 —— 完成率、漏服次数、按药品与时段分布,都能下钻到具体记录。
它不做医疗建议:不提供诊断、用药建议或剂量推荐,所有计划都由用户按医嘱录入。
| 项目 | 值 |
|---|---|
| 应用名 | 用药管理 |
| 核心概念 | 用药本(一本 = 一位用药人 / 一段照护关系) |
| 仓库 | medcare |
| 飞牛包名 | techfunway-medcare |
| 默认端口 | 8913 |
| 技术栈 | smallgo 框架实例 + Go/Gin/GORM/SQLite + Vue 3/TypeScript/Vite |
| 前端 | 全新设计系统(5 套配色 × 亮暗),不复用 smallgo 主题 |
| 当前版本 | v0.2.0 |
| 真机 | 飞牛 NAS,v0.1.0 起连续升级验证到 v0.2.0 |
-
一个账号可创建/加入多个用药本,顶部一键切换;
-
邀请链接、6 位邀请码、二维码三种加入方式;
-
管理员 / 监护人 / 成员三级权限:管理员由创建人担任并可转交;成员默认只能查看与「提醒用药」;
-
权限逐格勾选:管理员决定谁是用药人,并对每位成员按「模块 × 动作」勾选——用药记录、药品与库存、用药计划、处方识别、图片资料、统计与日志、成员与邀请, 每块都能单独决定能不能看、能不能新增 / 修改 / 删除(用药记录另有「点提醒」「点完成」两格)。勾了才有,不勾就没有:没勾查看,那一页连进都进不去。 老人、孕妇、学生用药人各有搭手的人,把对应的格勾给实际动手的家人;另有「只读 / 帮忙照看 / 管药与计划 / 全部」四个预设可一键套用。
-
每位成员配置自己的通知渠道与订阅开关。
- 药品基础信息与库存分开:药品详情页分「基本信息 / 库存 / 出入库明细」三个标签;
- 药品、批次、入库(包装数 × 每包装含量)、盘点、调整、丢弃;
- 出入库明细记录入库来源(药店购买 / 医院开具 / 其他)与录入来源(手动 / 药盒 / 缴费单 / 处方 / 完成用药 / 盘点);
- 完成用药时按「先到期先出」扣减批次并记出库,撤销按原明细恢复;识别导入、手动入库、处方确认都自动入库;
- 低库存阈值、临期预警天数可分别设置,首页与药品页都有提醒。
- 频率:每天、每 N 天、每周指定星期、每 N 小时;一条计划可设多个时间点;
- 长期计划与固定疗程都支持,保存前可预览未来 7 天;
- 今日按早上/中午/下午/晚上/夜间分组,逾期置顶;
- 结果:完成、撤销、漏服(手动 + 日终自动)、医生调整、自己调整、稍后提醒;
- 调整记录改前改后,历史记录不会被覆盖。
- 药品页「拍照识别」支持三种单据:药品包装盒、门诊收费凭据、处方笺;
- 药盒读出名称、规格、厂家、有效期、包装内数量;缴费单按「逐条提取」把单子上的每种药都列出来,可勾选、全选、逐条修改后批量导入;
- 处方笺 → 生成每天几点的用药计划;药盒 / 收费凭据 → 只建药品并按单据数量入库,不排计划;
- 逐项人工核对后才落库,低置信度字段会标「请核对」;批量导入走事务,建药品、写批次、记库存流水一次完成;
- 识别历史按单据类型区分标题,可点开重新核对,失败的记录一键重试;
- 原图默认不保存,可选加密留存。
- 识别服务配置支持不保存先测连接、先拉模型列表,模型可直接下拉选择。
| 渠道 | 说明 |
|---|---|
| 站内 | 通知中心 + 实时浮层,多端同步 |
| 邮件 | SMTP(465 SSL / 587 STARTTLS / 25),系统级配置 |
| 钉钉 | 群机器人 Webhook,支持加签与自定义关键词 |
| 飞书 | 群机器人 Webhook,支持签名与自定义关键词 |
- 提前提醒、到点提醒、逾期升级(默认 +15、+60 分钟)、每日总结;
- 按成员 fan-out,同一成员 90 秒内合并成一条;
- 失败按 1/2/4/8/16 分钟退避重试,投递日志可查可重试。
- 居家、诊所、医院、药房、其他;计划可绑定地点;
- 某天临时换地方只改这一次,不影响后续;
- 事件卡片显示地址,支持复制与地图打开。
- 完成率、当前漏服、曾漏服、连续无漏服天数、医生/自己调整次数;
- 趋势图、日历热力图、按药品与时段分布;
- 口径在页面上可解释,任一数字可下钻到具体记录。
- 亮色 / 暗色 / 跟随系统(白天亮色、晚上自动暗色);
- 5 套配色:温润药本(默认)、清风医疗、深夜护航、柔光珊瑚、素简黑白;
- 手机端:底部标签栏、底部弹层、自定义日期/时间/选择器、PWA 可安装;
- 全应用禁止浏览器原生弹窗与原生日期/时间选择器。
| 层 | 技术 |
|---|---|
| 后端 | Go + Gin + GORM + SQLite(WAL,单连接) |
| 调度 | 通知派发(每分钟)、每日总结、日终漏服结算(00:10)、库存对账(03:30) |
| 实时 | SSE 推送 + 修订号轮询兜底 |
| 前端 | Vue 3 + TypeScript + Vite + Pinia + Vue Router |
| 公共能力 | smallgo:认证、用户权限、系统配置、备份、审计、匿名统计 |
业务代码集中在 server/medcare/;数据边界是 book_id,非成员一律 404。
忘记管理员密码?直接看 重置管理员密码。
应用中心 → 手动安装 → 从电脑上传,选择对应架构的 fpk(x86 / arm64)。安装向导确认端口(默认 8913), 完成后桌面出现「用药管理」图标,点击即用飞牛账号直接登录。
docker run -d --name techfunway-medcare -p 8913:8913 \
-v medcare-data:/app/data techfunways/medcare:latest./medcare -port 8913 -data-dir ./data -web-dir ./static/dist浏览器打开 http://localhost:8913,首个注册用户自动成为管理员。
管理员在「我的 → 用户管理」里可以新增用户、改用户名、改角色(管理员/普通用户)、 启用或禁用账号、重置密码、删除账号(不能删除或禁用自己,也不能取消自己的管理员身份)。
超级管理员:首次注册的那个账号就是超级管理员。它的设置任何账号都不能改——不能改名、 改角色、禁用、删除或重置密码,包括它自己;忘记密码只能用下面的命令行重置。普通用户可以被 提升为管理员,但普通管理员同样动不了超级管理员。
「偏好设置 → 管理员配置 → 注册审核」可打开「普通用户注册需审核」:打开后新注册的普通账号 处于「待审核」,登录会提示等待审核,管理员在用户管理里点「通过审核,允许登录」后才能使用; 首个注册的管理员不受影响。
不需要登录网页,在服务器上执行一次命令即可。建议先停掉正在运行的服务(避免和运行中的 进程同时写 SQLite),重置完再启动。
命令格式:
medcare -data-dir <该实例的数据目录> -reset-admin-password [-admin-password '新密码']- 不加
-admin-password:随机生成一个强密码并打印在终端,照着复制即可; - 加
-admin-password '新密码':直接指定(至少 6 位); - 只重置第一个管理员账号的密码,并让该账号已签发的登录令牌全部失效;其它数据一律不动。
cd ~/develop/apps/medcare
./stop.sh
./bin/medcare -data-dir ./data -reset-admin-password
# 指定密码就加:-admin-password '你的新密码'
./start.sh先在应用中心把「用药管理」停掉,再在该应用安装目录执行(路径以应用中心显示为准,
一般在 /vol1/@appstore/ 或 /vol1/@appdata/ 下;-data-dir 指向这个应用自己的数据目录):
cd /vol1/@appstore/techfunway-medcare # 换成实际安装目录
./medcare -data-dir /vol1/@appdata/techfunway-medcare -reset-admin-password执行完回应用中心启动应用,用新密码登录。路径不确定时看应用详情里的「安装位置 / 数据目录」。
docker exec -it <容器名> /app/medcare -data-dir /data -reset-admin-password
# 或停容器后一次性执行:
# docker run --rm -v <数据卷>:/data <镜像> -data-dir /data -reset-admin-password./medcare -data-dir ./data -reset-admin-passwordcd server && go run . # 后端,默认 8913
cd web && npm run dev # 前端,:3000 代理 /api 到 :8913
make build # 前端 → server/static/dist,再编译后端
bash scripts/smoke.sh # 端到端冒烟(临时端口 + 临时数据目录)
bash scripts/build-fnpack-local.sh both # 一次产出 x86 + arm64 两个飞牛包- 需求规格说明书 — 做什么、角色权限、P0/P1、验收。
- 概要设计 — 用药本上下文、模块、关键流程、部署。
- 详细设计 — 表结构、API、算法、AI、通知、安全、测试。
- UI/UX 交互分册 — 视觉、组件、页面、交互、移动端验收。
- UI 方案样稿 — 5 套风格静态样稿与选择说明。
- 文档索引 — 阅读顺序与界面预览。
- 端口 8913;
config.go、app.json、fnpack/manifest、向导、Docker 必须一致。 - 包名 techfunway-medcare;网关前缀
/app/techfunway-medcare;数据目录同名。 - 飞牛入口
type: url新页面打开,protocol: ""+ 网关字段。 - 时区 固定北京时间,前端格式化不受设备时区影响;存储与比较统一 UTC。
- 数据边界 所有业务数据带
book_id,先校验成员身份。 - 禁止原生弹窗
alert/confirm/prompt一律不用,日期/时间/下拉也自定义。 - 手机端 375×667 无横向滚动;输入 16px;触控 44px;无重模糊动画。
- 安全 通知/AI/SMTP 密钥 AES-GCM 加密;邀请 token 只存哈希;处方图私有。
见 CHANGELOG.md。
本应用只帮助记录和提醒,不提供诊断、用药建议或剂量推荐。请遵医嘱。