xk-hy-transit-go/README.md

xk-hy-transit-go

外网 Windows 中转：从云端 xk-api 拉取监管组包 → 本机 MySQL 落库 → AES 签名 → 经内网 xk-hy-forward-go 双通道上报政务云（28212 业务数据 + 28211 处方 PDF）→ 批量回调云端状态。

前置

1. 云端配置 HY_TRANSIT_API_TOKEN，部署 routes/hy.php 与 xk_hy_transit_cloud.sql。
2. 本机执行 sql/hy_transit_schema.sql。
3. 内网部署 xk-hy-forward-go。

环境配置

cp .env.example .env
# 编辑 .env 填写 XK_API_TOKEN、HY_*、FORWARD_BASE_URL、FILE_UPLOAD_VIA_FORWARD、MYSQL_DSN

程序启动时自动 godotenv.Load() 读取 .env。

运行

运营推荐：直接双击或运行 transit.exe（无参数），按中文菜单选择「单次执行」或「定时执行」。

完整命令说明（单次 / 定时 / 计划任务 / 排错）：见 docs/COMMANDS.md。

# 交互菜单（无参数）
go run ./cmd/transit

# 单次同步
go run ./cmd/transit sync --step=all --date=2026-05-18

# 定时常驻（默认每天 22:00）
go run ./cmd/transit serve

步骤：consult | referral | recipe | verification | all

应用日志默认目录：log/transit/（pull / push / app 按日滚动；控制台仅开始/结束/错误），详见 docs/COMMANDS.md。

接口文档

云端 API 说明：xk-api/docs/hy-transit-api.md（WSL 路径以实际仓库为准）。

Windows 部署

• 推荐：transit.exe 无参数 → 菜单选「定时执行」，或 transit.exe serve 注册为服务。
• 计划任务单次：见 docs/COMMANDS.md 中 schtasks 示例。