JSON ⇄ XLSX 互转工具

这个程序解决什么问题

客户要的是「JSON 和 XLSX 直接互相转化的程序」,并且要「一个发送端口」。本服务同时提供:

• 网页双向互转:JSON → XLSX、XLSX → JSON,浏览器里点几下就能完成,不需要装 Excel 插件。
• 一个接收端口:/jquick-decision/decision/saveThirdPartyTesting,形态与接口文档中 jquick-decision/decision/saveYjFilterOilData 一致(POST + {"list":[...]})。
• 字段契约:按「31、第三方检测」表结构的 28 个字段校验与落库。

给对方的对接说明(可直接转发)

转换规则

1. 表头即字段英文名,首行冻结;请勿修改表头文字。
2. 日期列用文本 YYYY-MM-DD HH:mm:ss,避免 Excel 区域设置导致日期漂移。
3. id、sample_no、test_person_no 等长数字串为文本列,不会被转成科学计数法。
4. 嵌套对象用点号扁平化(gisEquipmentTorqueSurfaceNoList.0.originalId),导入时自动还原。
5. 必传字段缺失会在页面提示,接收端口也会返回 400 与逐行说明。

常见问题

对方说连不上端口?

确认服务用 HOST=0.0.0.0 启动、服务器防火墙放行端口;先用 POST /api/echo 试连通性,再发真实数据。

要不要鉴权?

默认开启。给对方的长期令牌用 API_TOKEN 环境变量固定;内网联调可临时 AUTH_MODE=off。

Excel 里日期变成 45000 这样的数字?

该列被设成了数值格式,程序在导入时会按 Excel 日期序列号自动还原为日期文本。