e2hang/HIS-GUI

Fork 0

Files

e2hang 77fef99b92 Update patient_case logger data

2026-04-01 11:02:24 +08:00

8.2 KiB

Raw Permalink Blame History

🚀 快速开始指南

概述

你已经成功获得了一个升级后的HIS系统，包含病例管理系统和操作日志系统。

📁 文件结构

核心代码文件

HIS/
├── include/models/
│   └── patient_case.h                 ← 病例数据模型
├── src/models/
│   └── patient_case.cpp               ← 病例实现
├── include/core/
│   └── patient_case_service.h         ← 病例服务接口
├── src/core/
│   ├── patient_case_service.cpp       ← 病例服务实现
│   ├── his_core.cpp/h                 ← 已修改
├── include/utils/
│   └── logger.h                       ← 日志系统
├── src/utils/
│   └── logger.cpp                     ← 日志实现
├── include/cli/
│   └── repl_shell.h                   ← 已修改
├── src/cli/
│   └── repl_shell.cpp                 ← 已修改(新增命令)
└── CMakeLists.txt                     ← 已修改

文档文件

HIS/
├── CASE_AND_LOG_GUIDE.md              ← 📖 详细使用指南
├── IMPLEMENTATION_SUMMARY.md          ← 📖 实现总结
├── COMPLETION_REPORT.md               ← 📖 完成报告  
├── CHANGES.md                         ← 📖 变更清单
└── QUICKSTART.md                      ← 📖 本文件 (快速开始)

日志文件

logs/
├── his_operation.log                  ← 主日志文件 (自动生成)
└── demo_logs.txt                      ← 导出示例 (演示时生成)

演示脚本

HIS/
└── demo_case_and_log.sh               ← 🎬 自动化演示脚本

🎯 快速使用

1️⃣ 编译

cd /home/e2hang/code/HIS
mkdir -p build
cd build
cmake ..
make

结果: 生成 build/his 可执行文件 (951 KB)

2️⃣ 运行

./build/his

你将看到:

=============================================
 HIS CLI (Ward/Bed) - REPL Shell
 root path: data/
 data file: wards.txt
 type 'help' for commands
=============================================
his>

3️⃣ 加载数据

his> doctor load
his> medicine load
his> ward load
his> patient load

4️⃣ 体验新功能

添加患者

his> patient add P001 张三 45 男 13800000001

添加诊断

his> case diagnosis add P001 D001 "高烧" "青霉素" "病毒感染"

添加药物

his> case medicine add P001 M001 Amoxicillin 100 "一日三次,饭后服用" 5.5

查看病例

his> case view P001

输出:

=== Patient Case: P001 ===
Diagnosis Records: 1
  - Doctor: D001 | Diagnosis: High fever

Medicine Records: 1 (Total Cost: 550.00)
  - Amoxicillin x100 @ 5.50 = 550.00

Admission Records: 0

查看日志

his> log view 10

导出日志

his> log export logs/my_logs.txt

5️⃣ 自动演示

bash demo_case_and_log.sh

演示脚本会自动:

✅ 加载数据
✅ 创建患者
✅ 添加诊断记录
✅ 添加药物处方
✅ 查看病例信息
✅ 查看操作日志
✅ 导出日志文件

📚 详细文档

文档	内容	适合场景
CASE_AND_LOG_GUIDE.md	完整的功能说明和命令参考	实际使用和学习
IMPLEMENTATION_SUMMARY.md	技术实现细节和架构设计	代码理解和扩展
COMPLETION_REPORT.md	项目完成情况和测试结果	质量评估
CHANGES.md	所有代码变更详情	代码审查

🎮 新增命令快速参考

病例命令 (case)

case view P001                          # 查看患者病例
case diagnosis add P001 D001 "诊断"      # 添加诊断记录
case medicine add P001 M001 "药名" 200 "用法" 5.5   # 添加药物
case admission add P001 W1 B001 "原因"   # 添加住院记录
case discharge P001 "总结"              # 患者出院
case stats P001                         # 查看统计信息

日志命令 (log)

log view 20                             # 查看最近20条日志
log clear                               # 清空日志
log export logs/backup.log              # 导出日志
log format set "[{time}] {type}: {command}"  # 自定义格式

📊 典型工作流程

场景1: 新患者就诊

# 1. 添加患者
patient add P001 患者名 35 男 13800000001

# 2. 记录诊断
case diagnosis add P001 D001 "感冒" "感冒药"

# 3. 开药处方
case medicine add P001 M001 感冒灵 100 "一日三次" 3.5

# 4. 查看完整病历
case view P001

# 5. 查看统计（计算医疗费用）
case stats P001

场景2: 患者住院

# 1. 添加患者
patient add P002 住院患者 60 女 13800000002

# 2. 记录诊断
case diagnosis add P002 D001 "高血压" "降压药" "严重"

# 3. 添加住院信息
case admission add P002 W1 B001 "高血压需要观察"

# 4. 查看病历
case view P002

# 5. 患者出院
case discharge P002 "血压稳定,可出院"

# 6. 导出病历
log export logs/P002_record.log

场景3: 医疗审计

# 1. 查看最近的操作日志
log view 50

# 2. 导出日志进行审计
log export logs/audit_2026_04.log

# 3. 自定义日志格式便于分析
log format set "{objectId} {command} {details}"

# 4. 再次查看
log view

🔍 查看日志文件

主日志文件

tail -50 logs/his_operation.log

查看导出的日志

cat logs/demo_logs.txt

⚙️ 命令帮助

在HIS shell中输入:

his> help

你将看到所有可用命令的完整列表。

🐛 常见问题

Q: 为什么某个case命令添加失败?

A: 检查患者ID是否存在。使用 patient list 查看所有患者。

Q: 日志文件存放在哪?

A: 主日志在 logs/his_operation.log，可通过 log export 导出。

Q: 能否批量导入数据?

A: 可以，使用 doctor load, patient load 等命令从文件加载。

Q: 病例数据会持久化吗?

A: 支持JSON序列化，可集成到数据库。目前在内存中。

Q: 支持多用户并发访问吗?

A: 目前是单用户，可扩展为多用户系统。

📖 推荐阅读顺序

快速开始 (本文件) ← 👈 你在这里
演示脚本 → 运行 demo_case_and_log.sh 查看效果
使用指南 → 阅读 CASE_AND_LOG_GUIDE.md 学习详细用法
实现总结 → 阅读 IMPLEMENTATION_SUMMARY.md 理解技术细节
变更清单 → 阅读 CHANGES.md 了解代码改动
完成报告 → 阅读 COMPLETION_REPORT.md 查看质量指标

💡 提示

保存工作

# 导出患者数据
patient save data/patients_backup.txt

# 导出所有日志
log export logs/monthly_backup.log

查询数据

# 搜索患者
patient find 名字片段

# 查看特定患者的所有记录
case view P001

# 查看患者的费用统计
case stats P001

系统管理

# 清空内存日志（注：文件日志保留）
log clear

# 导出日志进行长期存储
log export logs/archive_$(date +%Y%m%d).log

🎯 重要快捷键

功能	快捷键
退出程序	`exit` 或 `quit`
显示帮助	`help`
获取患者列表	`patient list`
查看病例	`case view <ID>`
查看日志	`log view`

📞 技术支持

如有问题，请参考:

阅读相关文档 (CASE_AND_LOG_GUIDE.md)
运行demo脚本查看示例
查看帮助命令 (his> help)

✅ 系统检查清单

确保系统正常运行:

能成功编译 (make 成功)
能启动程序 (./build/his 运行)
能加载数据 (doctor load 等)
能创建患者 (patient add)
能添加诊断 (case diagnosis add)
能查看病例 (case view)
能查看日志 (log view)
能导出日志 (log export)
日志文件已生成 (ls logs/)

🎉 完成!

你已经掌握了HIS系统的新功能!

现在可以:

✅ 管理患者病例
✅ 记录诊断和药物信息
✅ 追踪住院信息
✅ 审计所有操作日志

祝你使用愉快! 🚀

版本: 1.0.0
最后更新: 2026-04-01
编译状态: ✅ 成功
测试状态: ✅ 通过

8.2 KiB Raw Permalink Blame History Unescape Escape