lblod/notulen-prepublish-service

Notulen prepublish服务

镜像概述

Notulen prepublish服务是一个处理文档容器的服务，提供一系列API调用用于预发布（生成临时预览）、签名（持久化并创建签名资源）和发布（持久化并创建已发布资源）不同类型的文档，包括议程（agenda）、处理事项（behandelingen）、决议清单（besluitenlijst）和会议记录（notulen）。

核心功能与API端点

1. 议程（agenda）相关

• /prepublish/agenda/:zittingIdentifier：从数据库中指定会议（zitting）的议程生成预发布文档，返回结果但不持久化
• /signing/agenda/sign/:kind/:zittingIdentifier：为指定类型（:kind）的会议议程持久化预发布文档（若不存在），并创建关联的签名资源（signedResource）
• /signing/agenda/publish/:kind/:zittingIdentifier：为指定类型（:kind）的会议议程持久化预发布文档（若不存在），并创建关联的已发布资源（publishedResource）

2. 处理事项（behandelingen）相关

• /prepublish/behandelingen/:zittingIdentifier：为与指定会议关联的每个“处理事项”生成预发布文档，返回结果但不持久化
• /signing/behandeling/sign/:zittingIdentifier/:behandelingUuid：为指定会议和处理事项UUID的处理事项持久化预发布文档（若不存在），并创建关联的签名资源
• /signing/behandeling/publish/:zittingIdentifier/:behandelingUuid：为指定会议和处理事项UUID的处理事项持久化预发布文档（若不存在），并创建关联的已发布资源

3. 决议清单（besluitenlijst）相关

• /prepublish/besluitenlijst/:zittingIdentifier：从指定会议生成决议清单的预发布文档，返回结果但不持久化
• /signing/besluitenlijst/sign/:zittingIdentifier：为指定会议的决议清单持久化预发布文档（若不存在），并创建关联的签名资源
• /signing/besluitenlijst/publish/:zittingIdentifier：为指定会议的决议清单持久化预发布文档（若不存在），并创建关联的已发布资源

4. 会议记录（notulen）相关

• /prepublish/notulen/:documentIdentifier：为指定会议记录（notulen）生成预发布文档，返回结果但不持久化
• /signing/notulen/sign/:kind/:documentIdentifier：为指定类型（:kind）和文档标识符的会议记录持久化预发布文档（若不存在），并创建关联的签名资源
• /signing/notulen/publish/:kind/:documentIdentifier：为指定类型（:kind）和文档标识符的会议记录持久化预发布文档（若不存在），并创建关联的已发布资源

与前端兼容性

• 若需与frontend-gelinkt-notuleren 1.x兼容，请使用版本 < 0.5.x
• 若需与frontend-gelinkt-notuleren 2.x兼容，请使用版本 >= 0.5.x

注意：版本号为0.5.x的发布版本仍处于开发阶段，在完善新发布流程期间，API可能存在不一致性。

配置说明

可通过以下环境变量配置服务：

• DATE_FORMAT：传递给luxon的日期时间格式，详细格式标记参见https://moment.github.io/luxon/docs/manual/formatting.html#table-of-tokens%E3%80%82%E9%BB%98%E8%AE%A4%E5%80%BC%EF%BC%9A%60dd/MM/yyyy HH:mm:ss`

使用场景

适用于需要对会议相关文档（如议程、处理事项、决议清单、会议记录）进行预发布预览、签名确认及正式发布流程管理的系统，可集成到文档管理平台或会议记录系统中，实现文档发布生命周期的自动化处理。