kromit/rkhelper

RKHelper镜像说明

镜像概述

RKHelper是一个专注于奥地利《收银机安全条例》（Registrierkassensicherheitsverordnung, RKSV）合规的微服务镜像。它封装了收据验证、数据导出检查和测试用例执行等核心功能，帮助开发者快速实现符合RKSV要求的收银系统。

核心功能

• 收据有效性验证: 检查单个收银收据的签名合法性、格式合规性及内容完整性。
• RKSV-DEP导出检查: 验证导出文件的机器可读代码链、营业额计数器连续性、收据类型顺序等关键合规项。
• 测试用例执行: 支持预设测试场景，验证收银系统在不同业务场景下的合规性。
• 加密材料管理: 生成与管理合规所需的加密材料（如AES密钥、证书等）。

使用场景

1. 奥地利收银系统开发者: 快速验证产品是否符合RKSV条例要求。
2. 测试团队: 部署前对收银软件进行合规性验证。
3. 审计机构: 检查收银数据导出文件的有效性与合规性。

配置说明

服务支持以下参数配置：

• -o OUTPUT_DIR: 指定生成数据（收据、导出文件等）的存储目录。
• -v: 启用详细输出模式，打印执行日志到标准输出。
• -c: 标记系统为封闭系统（使用企业名称和密钥ID替代证书序列号）。
• -l TURNOVER-COUNTER-LENGTH: 设置营业额计数器长度（5-8字节，默认8字节）。

Docker部署示例

bash
docker run -v /本地输出目录:/app/output kromit/rkhelper java -jar regkassen-demo-1.0.0.jar -o /app/output -v -c -l 8

说明:

• -v /本地输出目录:/app/output: 将本地目录挂载到容器，保存生成的合规文件。
• -jar regkassen-demo-1.0.0.jar: 启动服务主程序。
• -v: 启用详细日志输出。
• -c: 启用封闭系统模式。
• -l 8: 设置营业额计数器长度为8字节。