一、系统整体介绍
OpenVPM 是当前最现代化、可生产落地的开源兽医诊所PIMS管理系统，基于AGPLv3永久免费开源协议，彻底替代市面高价商用宠物医院系统（ezyVet、ProVet Cloud等）。专为中小型宠物诊所、动物医院打造，覆盖接诊、排班、电子病历、收费对账、库存管控、客户运营、AI辅助诊疗全流程，支持私有化自主部署，数据完全归属门店，无厂商锁死、无按月年费、无功能阉割。
区别于老旧开源兽医系统，OpenVPM采用全新技术架构，界面简洁易用、低学习成本，普通员工半天即可上手，同时支持二次开发、API对接、AI拓展，是目前宠物医疗行业最优的开源管理系统解决方案。
二、核心功能全详解（完整版）
1. 客户&宠物档案管理（基础核心）
搭建门店完整客户资产数据库，支持一户多宠绑定，全方位记录宠物诊疗信息，永久留存、随时追溯。
• 完整档案录入：宠主信息、宠物品种、年龄、体重趋势、芯片编号、宠物照片、疫苗本存档
• 健康风控记录：过敏史、既往慢性病、治愈病史、就诊异常记录
• 极速检索：全局快捷键模糊搜索，手机号、宠物名、姓名一键查全量记录
• 动态自动更新：就诊、疫苗、消费、开药后系统自动归档，无需手动建台账
2. 智能预约&医生排班系统
告别纸质表格、Excel排班，可视化日历管理，彻底杜绝预约冲突、漏单、错单问题。
• 多视图切换：日视图/周视图，按医生分栏独立展示排班，清晰直观
• 自定义服务类型：问诊、体检、疫苗、手术、洗护、住院，可自定义时长、专属颜色标签
• 全流程就诊状态：预约→到店签到→接诊中→接诊完成→结算离场
• 高阶功能：重复预约、时段锁定（医生休息/手术预留）、批量排班管理
3. 标准化电子病历EMR系统（医生核心）
采用国际通用兽医SOAP病历模板，替代手写病历，规范诊疗流程，满足门店诊疗存档、复盘、核查需求。
• 富文本病历编辑，支持图文混排，可上传化验报告、影像截图、诊疗单据
• 完整诊疗记录：主观症状、客观检查、诊断结果、治疗方案、复诊建议
• 疫苗管理：自动记录接种时间、疫苗品类，到期智能提醒，支持疫苗证书生成下载
• 处方管理：内置用药剂量计算器、处方留存、补打、用药追溯，规避用药失误
• 病情分类管理：区分活跃病症、慢性病、已治愈病症，复诊快速参考
4. 收费开票&营收对账系统
一站式解决门店收费、报价、对账、营收统计，财务数据自动同步，杜绝错账、漏账。
• 支持诊疗项目、药品、耗材一键加单，自动核算总价、税费、优惠
• 支持先出报价单，客户确认后一键转为正式账单
• 全维度账单记录：支付方式、账户余额、欠款明细、历史消费记录
• 自动生成营收报表，同步仪表盘，实时查看门店盈利数据
5. 药品耗材库存管理
精细化管控疫苗、药品、耗材、管制药品，实现库存自动化管理，减少损耗、杜绝过期浪费。
• 库存录入、分类管理，支持设置最低库存预警、有效期预警
• 自动扣减库存：接诊开药、耗材使用后系统自动核销，无需手动登记
• 批次管理、供应商管理，方便批量补货、溯源查询
• 管制药品专项审计：全程日志记录、用量追溯、作废登记，合规可控
6. 客户自助门户
赋能宠主自主服务，大幅减轻前台工作量，提升门店服务质感。
• 宠主自主在线预约、查看宠物电子病历、下载疫苗证明
• 自助查询账单、线上缴费、查看在售处方
7. AI智能助手 OpenVPM Agent
内置专属兽医AI工具，辅助办公、辅助诊疗，降低新手员工、新医生上手门槛。
• 自动辅助生成标准化SOAP病历，节省医生书写时间
• 智能核算宠物用药剂量，规避用药错误
• 批量统计逾期疫苗、待回访客户、未复诊宠物清单
• 一键调取宠物全周期病史、诊疗汇总，辅助诊断参考
8. 数据报表&权限管理
• 多维度数据报表：营收趋势、医生绩效、病种统计、库存台账、客户消费统计，支持CSV/PDF导出
• 精细化RBAC权限：管理员、兽医、技师、前台、只读查看员，各司其职，杜绝误操作、数据泄露
三、OpenVPM 优缺点详细分析
✅ 核心优点（碾压商用系统）
1. 永久免费、无任何隐形消费
AGPLv3正规开源协议，无年费、无账号限制、无功能阉割，对比商用系统200–600美元/月的高额服务费，长期节省巨额成本。
2. 数据100%自主掌控，无厂商锁死
支持私有化部署，所有诊疗数据、客户数据、营收数据全部存储在自己服务器，可随时完整导出，不会被第三方平台锁数据、卡权限。
3. 轻量化易上手，学习成本极低
界面现代化、简洁直观，区别于传统兽医系统卡顿、臃肿、操作复杂的问题，普通员工半天即可熟练使用。
4. 高可拓展性，支持二次开发
API-first架构，自带完整REST API、Webhook实时事件，可对接AI工具、小程序、预约插件、第三方设备，适配门店个性化需求。
5. 技术架构先进、稳定流畅
基于Next15+TS+PostgreSQL开发，对比老旧Java开源兽医系统，运行更稳定、响应更快、不易崩溃。
6. 自带AI能力，领先传统系统
内置官方AI助手，无需额外付费开通，辅助病历、用药、客户回访，适配当下智能诊疗趋势。
❌ 现有缺点&适配短板（客观说明）
1. 原生无中文界面，需适配汉化
海外开源项目，原生为英文，国内门店使用需人工汉化适配，新手无法自行完成。
2. 部署门槛高，环境依赖复杂
依赖Docker、Node、pnpm、PostgreSQL、MinIO对象存储，需要配置环境变量、数据库权限、RLS安全策略，纯小白自行部署大概率报错、启动失败。
3. 短信/邮件推送需自行配置
系统自带推送功能，但需要对接第三方服务商（Resend、Telnyx），默认无法直接使用，需技术配置。
4. 无现成移动端APP
目前仅支持网页端使用，移动端需适配适配或封装，暂无官方独立APP。
5. 国内合规适配需微调
海外诊疗逻辑，部分功能（管制药品审计、报表格式）需要根据国内宠物医疗行业规范微调优化。
四、保姆级零基础部署教程（可直接照做）
适配服务器/本地电脑部署，全程命令行操作，步骤完整无遗漏，新手可直接复刻。
1. 部署前置条件
• 服务器系统：CentOS / Ubuntu 主流Linux系统
• 环境要求：Node.js 20+、pnpm 9+、Docker、Docker Compose
• 硬件最低配置：2核4G内存、40G硬盘（满足单门店日常使用）
2. 安装基础环境
依次执行以下命令，安装依赖环境
| Plain Text # 更新系统依赖 apt update && apt upgrade -y # 安装Node.js20 curl -fsSL https://deb.nodesource.com/setup_20.x | bash - apt install nodejs -y # 安装pnpm npm install -g pnpm # 安装Docker&Docker Compose apt install docker.io docker-compose-plugin -y systemctl start docker systemctl enable docker |
3. 拉取开源项目源码
| Plain Text # 安装git apt install git -y # 克隆开源仓库 git clone https://github.com/evangauer/openvpm.git cd openvpm # 复制环境配置文件 cp .env.example .env |
4. 启动数据库与存储服务
启动PostgreSQL数据库 + MinIO对象存储（存放图片、病历、附件）
| Plain Text docker compose -f docker/docker-compose.yml up -d |
执行后自动创建数据库、openpims存储桶，无需手动配置。
5. 安装项目依赖&环境校验
| Plain Text # 安装项目依赖 pnpm install --frozen-lockfile # 校验开源版本完整性 pnpm verify:oss-release |
6. 初始化数据库&安全策略
| Plain Text # 推送数据库表结构 pnpm db:push # 启用数据库行级安全策略（核心安全配置） pnpm db:rls pnpm db:rls:test # 导入演示测试数据 pnpm db:seed |
7. 启动项目
| Plain Text # 开发环境启动 pnpm dev # 生产环境后台常驻启动 docker compose -f docker/docker-compose.yml up -d |
8. 访问系统&登录账号
浏览器访问：http://服务器IP:3000
默认测试账号（部署完成直接登录）
• 管理员：admin@neighborhoodvet.example.com / password123
• 兽医：sarah.chen@neighborhoodvet.example.com / password123
• 技师：jamie.torres@neighborhoodvet.example.com / password123
• 前台：morgan.bailey@neighborhoodvet.example.com / password123
9. 部署后必做优化（生产上线必备）
• 修改所有默认账号密码，防止数据泄露
• 汉化系统界面，适配国内员工使用习惯
• 配置域名、HTTPS证书，实现外网正常访问
• 配置数据库定时备份，防止数据丢失
• 微调报表、诊疗模板，适配国内宠物医疗规范
五、新手快速上手使用指南
1. 首次登录必做操作
• 修改默认密码，开启账号安全保护
• 录入门店基础信息、诊疗项目、收费标准
• 创建正式员工账号，分配对应岗位权限
• 批量录入药品、疫苗、耗材初始库存
2. 日常办公核心流程
前台预约登记 → 到店签到 → 医生接诊写病历开处方 → 收费结算 → 系统自动扣库存、归档记录 → 后台数据自动统计
六、常见问题解答
1. 部署后启动失败、报错怎么办？
大概率是环境版本不匹配、端口占用、数据库权限未开启，新手不建议自行排查，可咨询专业技术协助调试。
2. 私有化部署数据安全吗？
极度安全，数据仅存储在自有服务器，无第三方访问权限，支持手动/自动备份，不会出现商用系统数据锁死、无法导出的问题。
3. 可以永久免费商用吗？
支持，AGPLv3协议永久免费，无门店数量、员工账号、功能使用限制，仅修改源码对外提供服务需遵循开源协议。
4. 可以对接小程序、AI、第三方设备吗？
完全支持，自带完整API接口和Webhook事件，可灵活二次开发、对接各类第三方工具。
七、一站式落地服务说明
源码开源免费，但部署调试、汉化适配、环境优化、生产上线门槛极高，新手自行部署极易出现启动失败、功能异常、数据不安全等问题。我方提供全套落地服务：
• ✅ 零基础全程代部署、环境搭建、端口调试、域名上线
• ✅ 系统完整汉化、国内诊疗模板适配、报表优化
• ✅ 全功能跑通测试：预约、病历、收费、库存、AI全部正常可用
• ✅ 员工一对一操作教学、门店个性化配置
• ✅ 永久免费技术咨询、问题排查、版本更新指导