English | 中文
基于 Vue 3 + FastAPI 的中小型医院综合信息管理系统，覆盖 门诊、住院、药房、检验、体检、收费 等核心业务全流程。
| 维度 |
数量 |
| 业务模块 |
34 个后端路由模块 |
| API 接口 |
247 个 RESTful 接口 |
| 数据库表 |
61 张业务表 |
| 前端页面 |
69 个 Vue 页面 |
| 用户角色 |
8 种（admin/director/doctor/nurse/cashier/pharmacist/guide/patient） |
| 模块 |
功能说明 |
| 智能导诊 |
症状描述→科室推荐（310+ 关键词匹配） |
| 分诊台 |
4 级分级导诊、科室分流 |
| 预约挂号 |
在线预约、按医生/科室、专家号区分 |
| 现场挂号 |
患者自助/窗口代办两种模式 |
| 报到签到 |
三步式扫码报到（身份证→选预约→生成队列号） |
| 排队叫号 |
候诊队列、叫号、过号、跳号、急诊插队 |
| 候诊巡视 |
巡视记录、关注高风险患者 |
| 违约记录 |
三次违约自动暂停预约 30 天 |
| 缴费管理 |
待缴清单、在线/窗口缴费、退费 |
| 收费记录 |
收费流水、状态跟踪、明细查询 |
| 发票管理 |
发票开具、查询、作废 |
| 日结对账 |
收费员每日收支汇总 |
| 模块 |
功能说明 |
| 排班管理 |
医生周排班、号源数量、专家标记 |
| 电子病历 |
主诉/现病史/既往史/诊断/治疗，模板复用 |
| 处方开立 |
药品搜索、剂量频次途径、库存校验 |
| 检查检验申请 |
检查类型、项目、紧急标记 |
| 考勤签到 |
每日签到/签退、出勤统计 |
| 多学科会诊 |
MDT 申请、参与科室、结果录入 |
| 临床路径 |
路径模板管理、进度跟踪 |
| 模块 |
功能说明 |
| 药品管理 |
入库、查询、修改、库存查询 |
| 耗材管理 |
医疗耗材入库、查询、修改、删除 |
| 处方审核 |
药师审方、确认发药 |
| 发药管理 |
处方核对、发药确认、退药 |
| 库存预警 |
低库存/近效期自动提醒 |
| 库存盘点 |
实物盘点、差异处理 |
| 药品采购 |
采购订单、审批、入库 |
| 处方点评 |
合理性审核、问题统计 |
| ADR 监测 |
药品不良反应上报、跟踪 |
| 模块 |
功能说明 |
| 病区床位 |
病区维护、床位状态、空床查询 |
| 入院登记 |
4 种入院类型、床位分配、押金登记 |
| 住院医嘱 |
长期/临时医嘱、审核、停止、撤销 |
| 护士工作站 |
医嘱执行、护理记录、体温录入 |
| 住院费用 |
费用明细、每日清单、押金扣减 |
| 出院结算 |
总费用计算、押金退还 |
| 模块 |
功能说明 |
| 病历模板 |
病种模板、复用 |
| 结构化病历 |
主诉/现病史/既往史/查体/诊断/治疗 |
| 病程记录 |
日常病程、上级查房 |
| 查房记录 |
主任/副主任查房、查房意见 |
| 病历质控 |
三级签名、归档 |
| CA 数字签名 |
电子签名、签名验证 |
| 模块 |
功能说明 |
| 检查检验 |
申请、样本接收、结果录入、审核 |
| 检验结果查询 |
结果列表、异常标记、报告查看 |
| 体检套餐 |
套餐定义、项目组合 |
| 体检预约 |
在线预约、状态跟踪 |
| 体检记录 |
检查录入、结果汇总 |
| 体检报告 |
报告生成、综合评估 |
| 模块 |
功能说明 |
| 手术申请 |
急诊/择期、麻醉方式 |
| 手术排台 |
主刀/麻醉医师分配、时间安排 |
| 麻醉记录 |
麻醉过程、用药记录 |
| 模块 |
功能说明 |
| 健康档案 |
个人信息、过敏史、就诊记录 |
| 病历查询 |
历次就诊病历查看 |
| 处方查询 |
处方明细、状态 |
| 预交金管理 |
充值、查询、扣费、退款 |
| 双向转诊 |
门诊/住院/急诊转诊 |
| 复诊随访 |
随访计划、患者反馈、随访记录 |
| 满意度评价 |
就诊评价、评分统计 |
| 模块 |
功能说明 |
| 用户权限 |
角色管理、密码重置、用户删除 |
| 操作日志 |
全量操作审计、按用户/操作筛选（中间件自动记录） |
| 数据字典 |
业务字典维护 |
| 系统参数 |
配置项管理 |
| 消息中心 |
站内信、已读标记 |
| 通知公告 |
按角色定向推送 |
| 数据备份 |
手动备份、恢复、下载 |
| 不良事件 |
医疗安全事件记录 |
| 号源池 |
按科室统计号源分布 |
| 报表统计 |
门诊量/收费/药品/工作量 4 大类报表 |
| 模块 |
功能说明 |
| 医保接口 |
医保实时结算、电子凭证 |
| PACS/RIS |
医学影像存储、阅片、报告 |
| 闭环医嘱 |
医嘱→摆药→执行→计费完整闭环 |
| CDSS |
用药安全、药物相互作用 |
| DRG/DIP |
病种付费、病案首页 |
| 互联网医院 |
在线问诊、复诊配药 |
完整 Roadmap 见 doc/todos.md，详细差距分析见 doc/architecture.md。
┌─────────────────────────────────────────────────────────────┐
│ 前端层 (Browser) │
│ Vue 3 · Element Plus · Vuex · Vue Router · Rspack │
├─────────────────────────────────────────────────────────────┤
│ 应用层 (FastAPI) │
│ 34 个路由模块 · 247 个 API · JWT 认证 · 操作日志中间件 │
├─────────────────────────────────────────────────────────────┤
│ 数据层 │
│ SQLite (开发) / PostgreSQL (生产) │
│ SQLAlchemy ORM · Alembic │
└─────────────────────────────────────────────────────────────┘
| 层级 |
技术 |
| 前端 |
Vue 3.4+ / Element Plus 2.x / Vuex 4 / Vue Router 4 / Axios / Rspack |
| 后端 |
FastAPI 0.111+ / SQLAlchemy 2.x / Pydantic 2.x / Alembic |
| 数据库 |
SQLite（开发）/ PostgreSQL（生产推荐） |
| 容器化 |
Docker / Docker Compose |
| 代码质量 |
ruff (Python) / Prettier (JavaScript) |
| 测试 |
pytest（后端 API 测试） |
| 安全 |
bcrypt 密码加密、JWT 会话、操作日志审计 |
hoimsystem/
├── vue3-new-ui/ # Vue 3 前端
│ ├── src/
│ │ ├── views/ # 69 个页面组件，按模块分目录
│ │ │ ├── admin/ # 管理员模块
│ │ │ ├── patient/ # 患者服务
│ │ │ ├── doctor/ # 医生工作站
│ │ │ ├── pharmacy/ # 药房
│ │ │ ├── charge/ # 收费
│ │ │ ├── queue/ # 排队叫号
│ │ │ ├── checkin/ # 报到签到
│ │ │ ├── inpatient/ # 住院管理
│ │ │ ├── lab/ # 检验科
│ │ │ ├── exam/ # 体检中心
│ │ │ ├── followup/ # 随访
│ │ │ ├── report/ # 报表统计
│ │ │ └── system/ # 系统管理
│ │ ├── api/ # 接口封装
│ │ ├── router/ # 路由配置
│ │ ├── store/ # Vuex 状态管理
│ │ └── styles/ # 全局样式
│ ├── public/index.html
│ └── rspack.config.js
│
├── fastapi_be/ # FastAPI 后端
│ ├── app/
│ │ ├── routers/ # 34 个路由模块
│ │ │ ├── user.py # 登录认证
│ │ │ ├── admin.py # 管理员（医生/病人/科室）
│ │ │ ├── patient.py # 患者服务
│ │ │ ├── doctor.py # 医生工作站
│ │ │ ├── pharmacy.py # 药房
│ │ │ ├── purchase.py # 药品采购
│ │ │ ├── consumable.py # 耗材管理
│ │ │ ├── adverse_reaction.py # 药品ADR
│ │ │ ├── charge.py # 收费
│ │ │ ├── queue.py # 排队叫号
│ │ │ ├── triage.py # 智能导诊
│ │ │ ├── triage_desk.py # 分诊台
│ │ │ ├── checkin.py # 报到签到
│ │ │ ├── vitalsign.py # 生命体征
│ │ │ ├── lab.py # 检验科
│ │ │ ├── exam.py # 体检
│ │ │ ├── ward.py # 病区床位
│ │ │ ├── admission.py # 入院登记
│ │ │ ├── inpatient_order.py # 住院医嘱
│ │ │ ├── nursing.py # 护士工作站
│ │ │ ├── inpatient_charge.py # 住院费用
│ │ │ ├── discharge.py # 出院结算
│ │ │ ├── surgery.py # 手术管理
│ │ │ ├── emr.py # 电子病历
│ │ │ ├── clinical_pathway.py # 临床路径
│ │ │ ├── mdt.py # 多学科会诊
│ │ │ ├── followup.py # 随访
│ │ │ ├── referral.py # 双向转诊
│ │ │ ├── digital_signature.py # CA签名
│ │ │ ├── adverse_event.py # 不良事件
│ │ │ ├── report.py # 报表统计
│ │ │ ├── system.py # 操作日志/字典/配置
│ │ │ ├── backup.py # 数据备份
│ │ │ └── upload.py # 文件上传
│ │ ├── models.py # 61 张表的 SQLAlchemy 模型
│ │ ├── schemas.py # Pydantic 请求/响应模型
│ │ ├── dependencies.py # JWT 解析、权限校验
│ │ ├── database.py # 数据库连接
│ │ ├── config.py # 配置加载
│ │ ├── pagination.py # 分页工具
│ │ └── main.py # 应用入口（CORS、中间件、路由注册）
│ ├── tests/ # pytest 测试用例
│ └── requirements.txt
│
├── doc/ # 项目文档
│ ├── README.md # 文档索引
│ ├── architecture.md # 架构与技术选型
│ ├── demandDoc.md # 需求文档
│ ├── apiDoc.md # API 接口文档
│ ├── databaseDoc.md # 数据库文档
│ ├── deployDoc.md # 部署文档
│ ├── user-manual.md # 用户操作手册
│ └── todos.md # 路线图与待办
│
├── doc_assets/ # 文档资源（截图、流程图、SQL）
│
├── docker-compose.yml # Docker Compose 编排
├── SECURITY.md # 安全策略
├── CONTRIBUTING.md # 贡献指南
├── CHANGELOG.md # 变更日志
├── LICENSE # MIT 许可证
└── README.md # 本文件
| 组件 |
版本 |
| Node.js |
≥ 16 |
| Python |
≥ 3.10 |
| 数据库 |
内置 SQLite，无需安装 |
git clone https://github.com/Palpitate-xus/hoimsystem.git
cd hoimsystem
cd fastapi_be
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Linux/Mac
# venv\Scripts\activate # Windows
# 安装依赖
pip install -r requirements.txt
# 启动（首次启动自动建表）
python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
启动后访问 http://localhost:8000/docs 查看自动生成的 Swagger 文档。
cd vue3-new-ui
# 安装依赖
npm install --legacy-peer-deps
# 开发模式（端口 8091）
npm run serve:rspack
# 生产构建
npm run build
详细部署配置（Nginx、HTTPS、Systemd）见 doc/deployDoc.md。
系统初始化时自动创建以下测试账号（首次启动后端时建表，账号通过 API 或 SQL 注入）：
| 角色 |
用户名 |
密码 |
备注 |
| 管理员 |
admin |
admin123 |
全部权限 |
| 医生 |
doctor1 |
doctor123 |
普通医生 |
| 患者 |
patient1 |
patient123 |
患者自助 |
⚠️ 生产环境部署前必须修改默认密码，并在 .env 中设置 SECRET_KEY 为随机强密钥（使用 openssl rand -base64 32 生成）。
系统支持 8 种角色，覆盖门诊全岗位：
| 角色 |
主要权限 |
| 管理员 (admin) |
全局管理：用户、医生、病人、科室、药品、通知、收费、系统配置 |
| 科室主任 (director) |
科室管理：本科室排班、医生管理、发布通知、处方点评 |
| 医生 (doctor) |
诊疗工作：病历书写、处方开立、检查申请、排班查看 |
| 护士 (nurse) |
护理工作：预检分诊、生命体征录入、住院护理、随访 |
| 收费员 (cashier) |
收费窗口：现场挂号/退号、费用结算、日结对账 |
| 药师 (pharmacist) |
药房管理：处方审核、发药确认、退药处理、库存管理 |
| 导诊员 (guide) |
导诊服务：分诊台管理、智能导诊、候诊队列 |
| 患者 (patient) |
自助服务：挂号/预约、缴费、查报告、健康档案、评价 |
- 业务覆盖广：门诊 + 住院 + 药房 + 检验 + 体检 + 手术，9 大领域 40+ 模块
- 代码质量高：247 个 API 按模块清晰组织，前后端分离，组件复用
- 开发体验好：FastAPI 自动文档、热重载、SQLite 零配置启动
- 可观测性强：操作日志中间件自动记录、操作时间精确到秒
- 安全可控：JWT 认证、bcrypt 密码、身份证号脱敏显示、操作审计
- UI 体验佳：Element Plus 组件库、全局样式工具类、空状态/加载状态全覆盖
- 提交信息：
<type>: <description>（type 取自 conventional commits：feat/fix/docs/style/refactor/test/chore）
- 分支策略：
master 为主分支，特性开发新建分支
- 代码风格：后端遵循 ruff 默认规则，前端遵循 Prettier 默认规则
- 接口路径：所有 API 以
/api/ 为前缀
- 数据库表名：统一前缀
hoimsystem_
更多截图见 doc_assets/ 目录。
MIT
欢迎提交 Issue 和 Pull Request。详见 CONTRIBUTING.md。
联系方式：palpitate.xus@outlook.com
