ISO8583 Web Simulator 使用指南

1. 项目目录结构及介绍

ISO8583 Web Simulator 的目录结构如下：

isosim/
├── .github/              # GitHub 工作流文件
├── cmd/                  # 主执行文件
├── docs/                 # 文档
├── githooks/             # Git 钩子
├── internal/             # 内部模块
├── test/                 # 测试数据
│   ├── testdata/
│   └── testdata/
├── web/                  # 前端文件
├── .gitignore            # Git 忽略文件
├── Dockerfile            # Docker 构建文件
├── LICENSE               # 许可证文件
├── README.md             # 项目说明文件
├── go.mod                # Go 模块定义文件
└── go.sum                # Go 模块校验文件

• .github/: 包含 GitHub 工作流文件，用于自动化处理如代码审查、测试等任务。
• cmd/: 包含项目的主执行文件 isosim.go，是项目的启动点。
• docs/: 存放项目文档。
• githooks/: 包含 Git 钩子脚本，用于在提交代码前执行一些自定义操作。
• internal/: 包含项目内部使用的模块和包。
• test/: 包含测试数据和相关文件。
• web/: 包含前端代码，包括 HTML、CSS 和 JavaScript 文件。
• Dockerfile: 用于构建 Docker 容器的指令文件。
• LICENSE: 项目的许可证信息，本项目采用 Apache-2.0 许可。
• README.md: 项目的说明文档，通常包含项目的介绍、使用方法和安装步骤。
• go.mod 和 go.sum: Go 项目的依赖管理文件。

2. 项目的启动文件介绍

项目的启动文件位于 cmd/isosim/isosim.go。该文件定义了命令行接口，并包含了启动项目所需的主要逻辑。以下是启动文件的一些关键部分：

• 命令行参数解析：用于解析用户提供的命令行参数，如 -http-port、-specs-dir、-html-dir 和 -data-dir 等。
• HTTP 服务器启动：设置并启动 HTTP 服务器，监听指定的端口。
• 加载配置文件：根据提供的参数加载 ISO 规范定义文件和前端文件。
• 日志记录：设置日志记录级别，便于开发和调试。

3. 项目的配置文件介绍

项目的配置文件主要是 ISO 规范定义文件，通常位于 test/testdata/specs 目录下。这些文件使用 YAML 格式定义 ISO8583 消息的规范。以下是配置文件的一些要点：

• 规范定义：定义消息的字段、类型（如 ASCII、EBCDIC、BCD 和 BINARY 编码）和长度。
• 字段类型：指定字段是固定的、可变的还是位映射的。
• 嵌套字段：支持定义嵌套的字段结构。
• 响应规则：基于字段值（如金额、货币等）定义消息的响应规则。

通过修改这些配置文件，可以定制 ISO8583 消息的处理方式和格式。