# 江苏医保部署检查清单

## 📋 **部署前准备**

### 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
```

**验证命令**:
```powershell
# 检查文件是否存在
Test-Path "E:\huaihaiProject\readCard\ThCardReader\ThCardReader\bin\Debug\HeaSecReadInfo.dll"

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

### 第二步：配置参数
在程序中设置正确的13个参数：
```json
{
  "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": "行政区划代码"
}
```

### 第三步：创建日志目录
```powershell
# 创建日志目录
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`

**期望结果**:
```json
{
  "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`

**期望结果**:
```json
{
  "success": true,
  "code": 200,
  "message": "江苏医保社保卡系统初始化成功"
}
```

### 3. 状态检查
访问: `http://localhost:8321/readcard/entry/jiangsu_status`

**期望结果**:
```json
{
  "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文件正确加载** 
✅ **系统成功初始化**
✅ **能够正常读取社保卡**
✅ **日志文件正常生成**
✅ **用户能够正常操作**

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