4.7 KiB
HIS_Sur_Data_Deal
网页端检测数据处理工具。上传 待处理检测数据.zip 后，系统会自动识别 V1/V2 数据结构，调用原处理脚本生成 Excel，并在网页中展示结果摘要、工作表统计和数据预览。
处理完成后可在结果页：
- 调整每个工作表的预览行数。
- 选择是否显示基本工作表、未匹配检测内容项、未检测到内容汇总表。
- 按姓名、采样时间、检测原因选择升序或降序排序。
- 导出当前内容选择和排序后的单个 Excel。
“未检测到内容汇总”会在每个“姓名 / 住院号 / 采样时间 / 检测原因”分组标题下单独排序，不会把不同检测原因的分组混在一起。
本地运行
pip install -r requirements.txt
uvicorn app.main:app --host 0.0.0.0 --port 8000
访问：
http://localhost:8000
Docker 构建与运行
docker build -t his-sur-data-deal .
docker run --rm -p 8000:8000 his-sur-data-deal
访问：
http://localhost:8000
Docker Compose 通用部署
通用配置文件：
docker_compose.yaml
这个配置是本地构建配置，不会从远程镜像仓库拉取 his-sur-data-deal:latest。运行时必须在项目源码目录执行，目录中需要包含：
Dockerfile
requirements.txt
app/
docker_compose.yaml
启动：
docker compose -f docker_compose.yaml up -d --build
默认映射：
宿主机 8000 -> 容器 8000
访问：
http://服务器IP:8000
frpc + NPM 反向代理到公网域名
如果本服务运行在内网机器，想通过公网服务器域名访问，可按下面链路处理：
浏览器
-> 公网域名
-> 公网服务器 Nginx Proxy Manager
-> 公网服务器 frps 暴露端口
-> 内网机器 frpc
-> 内网 Docker 服务 127.0.0.1:8000
内网机器运行本项目：
docker compose -f docker_compose.yaml up -d --build
内网机器 frpc 示例：
serverAddr = "公网服务器IP"
serverPort = 7000
[[proxies]]
name = "his-sur-data-deal"
type = "tcp"
localIP = "127.0.0.1"
localPort = 8000
remotePort = 18004
公网服务器 Nginx Proxy Manager 中新增 Proxy Host：
Domain Names: 你的域名，例如 his.example.com
Scheme: http
Forward Hostname / IP: 127.0.0.1
Forward Port: 18004
Websockets Support: 可不开
Block Common Exploits: 建议开启
SSL: 按需申请 Let's Encrypt
如果公网服务器的 NPM 与 frps 不在同一台机器，则 Forward Hostname / IP 填写 frps 所在服务器的内网或公网 IP。
NAS Docker Compose 部署
NAS 地址：
http://192.168.31.5/
NAS 专用配置文件：
docker_compose-Nas.yaml
这个配置同样是本地构建配置，不依赖远程镜像仓库。NAS 上请把整个项目源码放到下面目录：
/share/Container/his_sur_data_deal/app
该目录中必须包含：
/share/Container/his_sur_data_deal/app/Dockerfile
/share/Container/his_sur_data_deal/app/requirements.txt
/share/Container/his_sur_data_deal/app/app/
/share/Container/his_sur_data_deal/app/docker_compose-Nas.yaml
如果只在 NAS 面板里粘贴 yaml，而没有把 Dockerfile 和 app/ 一起放到上述路径，NAS 会报 failed to read dockerfile: open Dockerfile: no such file or directory。
启动：
cd /share/Container/his_sur_data_deal/app
docker compose -f docker_compose-Nas.yaml up -d --build
默认映射：
NAS 4004 -> 容器 8000
访问：
http://192.168.31.5:4004
镜像推送示例
docker tag his-sur-data-deal 192.168.31.5:5002/admin/his-sur-data-deal:latest
docker push 192.168.31.5:5002/admin/his-sur-data-deal:latest
数据模式
V1：
- zip 解压后包含
Patients_info.csv、Tests_List、Tests_Detail_List。 - 输出一个汇总 Excel。
V2：
- zip 解压后包含
Patients_info.csv。 - 按患者目录分别保存检测汇总和具体检测。
- 输出多个患者 Excel。
患者编号类型可选择自动识别。自动识别会读取 Patients_info.csv 中的 pat_no，并与 Tests_List 文件名或患者目录名比对：如果更匹配 10 位补零编号，则使用 pat_no；如果更匹配原始编号，则使用 zhuyuanhao。
结果规则
- 系统默认输出完整结果。
未匹配检测内容会规范化为独立列：表头为未匹配检测项目名，数据行只保存对应检测值。- 如果某个工作表没有任何未匹配检测项目，不显示
未匹配检测内容标识列。 - 标准检测字段全为
Not_Find的记录会移入未检测到内容汇总，不继续留在原基本工作表中。 - 导出 Excel 会跟随页面上的内容选择和排序。