moov/imagecashletter Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

moov-io/imagecashletter

Moov的使命是为开发者提供简单的方式，将银行处理功能集成到自己的软件产品中。我们的开源项目专注于解决***服务中的单一职责，并围绕性能、可扩展性和易用性设计。

ImageCashLetter实现了X9影像现金票据(ICL)规范的读取器、写入器和验证器，通过HTTP服务器和Go库提供Check 21服务。HTTP服务器可通过Docker镜像获取，Go包github.com/moov-io/imagecashletter也已发布。

目录

• 项目状态
• 使用方法
  • Docker部署
  • Google Cloud部署
  • 配置设置
  • 数据持久化
• 了解影像现金票据
• 获取帮助
• 支持和测试的平台
• 贡献指南
• 相关项目

项目状态

Moov ImageCashLetter已在多个生产环境中积极使用。如果您关注其进展，请为项目点赞。如果您有基于ImageCashLetter的上层功能实现、业务逻辑或发现bug，欢迎提交issue或pull request。感谢支持！

使用方法

影像现金票据项目实现了HTTP服务器和Go库，用于创建和修改ICL文件。我们还提供了一些读写器示例。

Docker部署

我们发布了公开Docker镜像moov/imagecashletter（可从Docker Hub获取）。无需额外配置即可在:8083端口提供服务，并在:9093/metrics提供Prometheus格式的指标。此外，我们还为OpenShift提供了Docker镜像，发布为quay.io/moov/imagecashletter。

拉取并启动Docker镜像：

bash
docker pull moov/imagecashletter:latest
docker run -p 8083:8083 -p 9093:9093 moov/imagecashletter:latest

列出内存中存储的文件：

bash
curl localhost:8083/files

json
null

上传x9文件（二进制）：

bash
curl -X POST --data-binary "@./test/testdata/valid-ascii.x937" http://localhost:8083/files/create

json
{"id":"<YOUR-UNIQUE-FILE-ID>","fileHeader":{"id":"","standardLevel":"03","testIndicator":"T","immediateDestination":"061000146","immediateOrigin":"026073150", ...

获取已存在的x9文件（JSON格式）：

bash
curl http://localhost:8083/files/<YOUR-UNIQUE-FILE-ID>

json
{"id":"<YOUR-UNIQUE-FILE-ID>","fileHeader":{"id":"","standardLevel":"03","testIndicator":"T","immediateDestination":"061000146","immediateOrigin":"026073150", ...

从JSON创建x9文件：

bash
curl -X POST -H "content-type: application/json" localhost:8083/files/create --data @./test/testdata/icl-valid.json

json
{"id":"<YOUR-UNIQUE-FILE-ID>","fileHeader":{"id":"","standardLevel":"35","testIndicator":"T","immediateDestination":"231380104","immediateOrigin":"***", ...

获取格式化文件内容：

bash
curl localhost:8083/files/<YOUR-UNIQUE-FILE-ID>/contents

P0135T231380104121042882201810032219NCitadel      Wells Fargo    US   P100123138010412104288220181003201810032219IGA1   Contact Name 5558675552  P200123138010412104288220181003201810039999   1  01             P25   *** 031300012       555888100001000001       GD1Y030BP261121042882201810031       938383      01  Test Payee   Y10
...

Google Cloud Run部署

要在托管环境中快速启动，可将项目部署到Google Cloud Platform。

1. 从Google Cloud控制台创建新项目，命名为：moov-icl-demo
2. 为项目启用Container Registry API，并关联账单账户（如需要）
3. 打开Cloud Shell终端，运行以下Docker命令（替换<PROJECT-ID>为您的项目ID）：

   bash
   docker pull moov/imagecashletter
   docker tag moov/imagecashletter gcr.io/<PROJECT-ID>/imagecashletter
   docker push gcr.io/<PROJECT-ID>/imagecashletter
   

4. 部署容器到Cloud Run：

   bash
   gcloud run deploy --image gcr.io/<PROJECT-ID>/imagecashletter --port 8083
   

5. 选择目标平台为1，服务名称为imagecashletter，选择最近的区域。部署成功后会提供API URL，可通过以下命令测试：

   bash
   curl [***]
   

   预期响应：null（表示无文件）

配置设置

可通过以下环境变量配置ImageCashLetter行为：

数据持久化

ImageCashLetter不持久化任何文件或交易数据。所有数据仅存储在进程内存中，服务重启后数据将丢失。同时，内存中的数据不进行加密处理。

了解影像现金票据

• 影像现金票据简介
• 影像现金票据文件结构

获取帮助

支持和测试的平台

• 64位Linux（Ubuntu、Debian）、macOS和Windows
• 树莓派（Raspberry Pi）

注意：32位平台存在已知问题，不提供支持。

贡献指南

欢迎贡献！请查看我们的贡献指南和行为准则。

项目使用Go Modules，要求Go v1.14或更高版本。建议使用标记的发布版本用于生产环境。

测试

项目维护全面的单元测试套件，推荐使用表驱动测试处理相似测试用例。运行当前目录下的所有测试：go test。覆盖率信息可在Codecov查看。

模糊测试

项目通过moov/imagecashletterfuzz Docker镜像提供模糊测试支持，详情参见文档。如发现崩溃示例，请报告至***。

相关项目

Moov开源***基础设施项目还包括：

• Moov Watchman：提供美国和欧盟贸易制裁名单搜索功能
• Moov Fed：美联储系统工具，支持ABA路由号查询、***机构名称查找等
• Moov Wire：实现Fedwire资金服务文件的读写，支持实时全额结算资金转账
• Moov ACH：提供ACH文件生成和解析，支持美国主要资金转账标准交易码
• Moov Metro 2：支持消费者信用报告的Metro 2格式读写和验证

许可证

Apache License 2.0 - 详见LICENSE