mhCardReader/江苏医保部署检查清单.md

江苏医保部署检查清单

📋 部署前准备

1. 获取必要文件

• HeaSecReadInfo.dll - 从江苏医保部门获取
• 初始化参数 - 13个配置参数已申请并确认
• Visual C++ 运行时 - 已安装相应版本
• 网络权限 - 防火墙配置完成

2. 环境检查

• 操作系统: Windows 7/10/11 或 Windows Server
• .NET Framework: 4.5 或更高版本
• 系统架构: 确认DLL和程序位数匹配（32位/64位）
• 管理员权限: 确保程序有足够权限访问读卡器

🚀 部署步骤

第一步：复制DLL文件

目标位置: E:\huaihaiProject\readCard\ThCardReader\ThCardReader\bin\Debug\
文件名: HeaSecReadInfo.dll

验证命令:

# 检查文件是否存在
Test-Path "E:\huaihaiProject\readCard\ThCardReader\ThCardReader\bin\Debug\HeaSecReadInfo.dll"

# 查看文件属性
Get-ItemProperty "E:\huaihaiProject\readCard\ThCardReader\ThCardReader\bin\Debug\HeaSecReadInfo.dll"

第二步：配置参数

在程序中设置正确的13个参数：

{
  "IP": "实际医保服务器IP",
  "PORT": 实际端口号,
  "TIMEOUT": 120,
  "LOG_PATH": "C:\\logs\\jiangsu\\",
  "EC_URL": "实际电子凭证URL",
  "CARD_PASSTYPE": "1",
  "API_NAME": "实际API名称",
  "API_VERSION": "1.0.0",
  "ACCESS_KEY": "实际访问密钥",
  "SECRETKEY": "实际密钥",
  "ORG_ID": "医院编号",
  "EXT": "",
  "AREA_CODE": "行政区划代码"
}

第三步：创建日志目录

# 创建日志目录
New-Item -ItemType Directory -Path "C:\logs\jiangsu" -Force

# 设置权限
icacls "C:\logs\jiangsu" /grant Users:F

第四步：测试部署

1. 启动程序: 运行ThCardReader.exe
2. 打开测试页面: jiangsu_test.html
3. 检查DLL: 点击"检查DLL文件"按钮
4. 测试初始化: 使用正确参数初始化

🔍 部署验证

1. DLL文件检查

访问: http://localhost:8321/readcard/entry/jiangsu_checkdll

期望结果:

{
  "success": true,
  "code": 200,
  "message": "HeaSecReadInfo.dll文件检查通过",
  "data": {
    "dllPath": "E:\\huaihaiProject\\readCard\\ThCardReader\\ThCardReader\\bin\\Debug\\HeaSecReadInfo.dll",
    "fileSize": 文件大小,
    "lastModified": "文件修改时间"
  }
}

2. 系统初始化检查

访问: http://localhost:8321/readcard/entry/jiangsu_init

期望结果:

{
  "success": true,
  "code": 200,
  "message": "江苏医保社保卡系统初始化成功"
}

3. 状态检查

访问: http://localhost:8321/readcard/entry/jiangsu_status

期望结果:

{
  "success": true,
  "code": 200,
  "data": {
    "initialized": true,
    "configLoaded": true
  }
}

❌ 常见问题排查

问题1: DLL文件不存在

错误信息: "HeaSecReadInfo.dll文件不存在" 解决方案:

1. 确认DLL文件已复制到正确位置
2. 检查文件名拼写是否正确
3. 确认文件没有被杀毒软件删除

问题2: DLL加载失败

错误信息: "DllNotFoundException: 无法加载DLL" 解决方案:

1. 安装对应的Visual C++ Redistributable
2. 检查系统位数匹配（32位/64位）
3. 检查DLL文件是否损坏

问题3: 初始化失败

错误信息: "江苏医保系统初始化失败" 解决方案:

1. 确认13个配置参数正确
2. 检查网络连接到医保服务器
3. 确认IP和端口可达
4. 检查防火墙设置

问题4: 权限不足

错误信息: "访问被拒绝" 解决方案:

1. 以管理员身份运行程序
2. 检查日志目录权限
3. 确认DLL文件权限设置

📞 技术支持联系方式

程序相关问题

• 项目负责人: [联系方式]
• 技术支持: [联系方式]

医保参数相关问题

• 江苏省医保局: 025-83275907
• 当地医保部门: [当地联系方式]
• 技术服务商: [服务商联系方式]

📝 部署日志模板

=== 江苏医保系统部署日志 ===
部署日期: ____年__月__日
部署人员: __________
医院名称: __________
系统版本: ThCardReader v1.0

□ 1. DLL文件部署 - 完成时间: ______
□ 2. 参数配置 - 完成时间: ______  
□ 3. 环境准备 - 完成时间: ______
□ 4. 功能测试 - 完成时间: ______
□ 5. 用户培训 - 完成时间: ______

测试结果:
□ DLL检查通过
□ 系统初始化成功  
□ 读卡功能正常
□ 网络连接正常
□ 日志记录正常

备注: 
_________________________________
_________________________________

签字确认:
部署人员: _________ 日期: _______
用户代表: _________ 日期: _______

🎯 部署成功标准

✅ 所有检查项目通过 ✅ DLL文件正确加载 ✅ 系统成功初始化 ✅ 能够正常读取社保卡 ✅ 日志文件正常生成 ✅ 用户能够正常操作

完成以上所有检查后，江苏医保读卡功能即可正式投入使用。