wearefrank/zaakbrug

ZaakBrug 镜像文档

镜像概述和主要用途

ZaakBrug 是 Open-ZaakBrug 的继任者，专为荷兰市政当局设计，支持从“zaak- en documentatieservices”（ZDS，案件和文档服务）向“zaakgericht werken”（ZGW，以案件为导向的工作）规范过渡。ZGW 是荷兰市政软件 Common Ground 规范 的一部分，旨在取代旧有 ZDS 标准。ZaakBrug 作为接口层，连接 ZGW 案件登记系统与 ZDS 系统，助力市政当局无需*** ZDS 接口即可迁移至 ZGW 标准。

核心功能和特性

• 双向协议转换：实现 ZDS 与 ZGW 标准之间的双向数据转换，支持平滑过渡。
• 基于 Frank!Framework：采用 Frank!Framework 构建，提供稳定的集成能力和可扩展性。
• Ladybug 调试器：内置 Ladybug 调试器，可实时展示每个请求的处理步骤，便于追踪错误和调试。
• 广泛兼容性：不仅支持与 OpenZaak 案件登记系统对接，还兼容任何实现 ZGW 规范的案件登记系统。

使用场景和适用范围

适用于荷兰市政当局，特别是需要从 ZDS 系统过渡到 ZGW 规范的市政机构。可用于连接 ZDS 系统与符合 ZGW 标准的案件登记系统，实现案件（zaak）和文档（document）的管理与数据交换。

详细使用方法和配置说明

Docker 部署步骤

在生产环境中，建议通过 Docker 运行 ZaakBrug。确保已安装 Docker，按以下步骤操作：

1. 克隆 GitHub 项目（如未克隆）：
   https://github.com/ibissource/zaakbrug

2. 打开命令提示符，切换至项目克隆目录。

3. 构建 Docker 镜像：
   docker build -t zaakbrug:test .

4. 启动容器：
   docker run -p 8080:8080 -e dtap.stage=LOC --name=zaakbrug zaakbrug:test

5. 访问用户界面：打开浏览器，访问 http://localhost:8080。

6. 健康检查：执行以下命令检查容器健康状态：
   docker inspect --format='{{json .State.Health.Status}}' zaakbrug

   警告：在 Windows 的 DOS 命令窗口中，--format= 后的字符串需用双引号包裹，命令为：
   docker inspect --format="{{json .State.Health.Status}}" zaakbrug

   信息：若熟悉 Frank!Framework，健康状态显示 healthy 表示 Frank 配置中的所有适配器均已无错误启动。

配置说明

案件和文档标识符配置

通过配置 zaakbrug.zgw.zaak-identificatie-template 和 zaakbrug.zgw.document-identificatie-template 属性，可自定义案件标识符（zaak-identificatie）和文档标识符（document-identificatie）的生成格式。变量替换语法为 {[variable-name][:formatting-string]}，支持以下变量：