From 8685ced14e55aea9d08975bfe0cd0566dd61394b Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Mon, 18 May 2026 21:19:20 +0200 Subject: [PATCH 001/333] fix(magicmapper): remove dead circular-construction guard (#1569) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes #1564. The static `self::\$constructCount` counter + `> 2` guard in `MagicMapper::__construct` was a March-2026 holdover from a refactor's debugging session — added in ef8ed0dc, kept across the `file_put_contents('/tmp/or-debug.log', ...)` debug logging that PR #1565 just removed. The two circular-DI paths the guard was protecting against have both been broken via lazy container resolution since: - `CacheHandler → RegisterMapper → MagicMapper` — `CacheHandler` and `ICacheFactory` are now resolved lazily inside `initializeHandlers()` (commented in-line). - `SettingsService → MagicMapper` — `SettingsService` removed `MagicMapper` from its constructor signature (private docblock at SettingsService.php:243 marks "REMOVED: Object mapper"). The full PHPUnit suite (12,226 tests / 25,949 assertions) is green after removing the guard — proving the cycle no longer trips in any covered path. ## What changed - `lib/Db/MagicMapper.php` — dropped `\$constructCount` static + the guard branch from `__construct()`. Constructor now goes straight to `\$this->initializeHandlers()`. - `tests/Unit/Service/MagicMapperTest.php` — removed the reflection block that reset the static counter between tests (it referenced a property that no longer exists). ## Verification - `composer phpcs` on `MagicMapper.php` → 0 errors - `phpunit --filter MagicMapperTest` → 29/29 pass - `phpunit -c phpunit-unit.xml` (full) → 12,226 tests / 25,949 assertions / 0 errors / 0 failures --- lib/Db/MagicMapper.php | 25 +++++-------------------- tests/Unit/Service/MagicMapperTest.php | 6 ------ 2 files changed, 5 insertions(+), 26 deletions(-) diff --git a/lib/Db/MagicMapper.php b/lib/Db/MagicMapper.php index db6f6baf4e37..c934af184edc 100644 --- a/lib/Db/MagicMapper.php +++ b/lib/Db/MagicMapper.php @@ -292,13 +292,6 @@ class MagicMapper extends AbstractObjectMapper */ private ?bool $hasPgTrgm = null; - /** - * Count of constructor calls. - * - * @var integer - */ - private static int $constructCount = 0; - /** * Constructor for MagicMapper service. * @@ -334,20 +327,12 @@ public function __construct( private readonly SettingsService $settingsService, private readonly ContainerInterface $container ) { - self::$constructCount++; - if (self::$constructCount > 2) { - // Guard against the circular-construction case under - // investigation (#1564). When tripped the mapper is left - // without handlers — operations against it will fail - // explicitly rather than recursing infinitely. - $this->logger->warning( - '[MagicMapper] circular construction guard hit (count={count}) — handlers not initialized', - ['count' => self::$constructCount, 'app' => 'openregister'] - ); - return; - } - // Initialize specialized handlers for modular functionality. + // The circular-construction guard that lived here previously (#1564) + // was a holdover from a March 2026 refactor; the cycles it guarded + // (CacheHandler→RegisterMapper→MagicMapper, SettingsService→MagicMapper) + // were since broken via lazy container resolution + the + // `objectMapper`-removed-from-SettingsService fix. $this->initializeHandlers(); }//end __construct() diff --git a/tests/Unit/Service/MagicMapperTest.php b/tests/Unit/Service/MagicMapperTest.php index e9514f44ca97..27435393a847 100644 --- a/tests/Unit/Service/MagicMapperTest.php +++ b/tests/Unit/Service/MagicMapperTest.php @@ -215,12 +215,6 @@ protected function setUp(): void $this->mockSchema->setVersion('1.0'); $this->mockSchema->testConfiguration = []; - // Reset static construct counter to avoid circular dependency guard. - $ref = new \ReflectionClass(MagicMapper::class); - $prop = $ref->getProperty('constructCount'); - $prop->setAccessible(true); - $prop->setValue(null, 0); - // Build a container mock that returns the DateTimeNormalizer when asked // — MagicMapper resolves it lazily from the container to construct // MagicBulkHandler, and the typed parameter rejects null. From 575324ec9ee950747098e78c65dbbbd7441004a3 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Mon, 18 May 2026 21:30:21 +0200 Subject: [PATCH 002/333] fix(ci): wait for Apache + OpenRegister API before running Newman (#1570) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Newman runs from the host targeting http://localhost:8080. Previously the workflow only waited for `occ status` to report "installed: true" — but OCC uses the PHP CLI and talks to the DB directly, so it returns installed before Apache has finished bringing up the HTTP listener. Newman then immediately fired requests that all came back `[errored]` (connection refused / port not yet forwarded), failing the entire api-test-coverage workflow on every PR. Added a step between "Enable openregister app" and "Run Newman orchestrator" that: 1. Polls `http://localhost:8080/status.php` until Apache responds — proves the host-mapped port works. 2. Polls `http://localhost:8080/index.php/apps/openregister/api/settings/rbac` until the OpenRegister app is dispatching (accepts 200/401/405 as evidence of dispatch — the suite re-auths anyway). 3. Does one final `curl -fsS` against the same endpoint and fails fast with a clear ::error:: marker if the API is still down, so the failure surfaces before Newman runs and dumps 100s of `[errored]` lines. Both polls cap at 60 attempts × 2s = 120s. Local dev unaffected (orchestrator only runs in CI from this workflow). --- .github/workflows/api-test-coverage.yml | 35 +++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/.github/workflows/api-test-coverage.yml b/.github/workflows/api-test-coverage.yml index a6771b4525b7..522546bf7b1b 100644 --- a/.github/workflows/api-test-coverage.yml +++ b/.github/workflows/api-test-coverage.yml @@ -98,6 +98,41 @@ jobs: docker exec nextcloud su -s /bin/bash www-data -c "php /var/www/html/occ app:enable openregister" docker exec nextcloud su -s /bin/bash www-data -c "php /var/www/html/occ app:list" | grep openregister + - name: Wait for Apache + OpenRegister API to serve HTTP + # `occ status` only proves the DB-side install completed; Apache may + # still not be answering on :8080. The Newman suite runs from the + # host and previously hit `[errored]` on every request because the + # HTTP listener wasn't ready yet. Poll both the NC entry page (proves + # Apache is up + port-forwarded) and the OpenRegister settings + # endpoint (proves the app is enabled + dispatching). + run: | + # 1. Apache reachable on the host-mapped port. + for i in $(seq 1 60); do + if curl -fsS -o /dev/null -w '' http://localhost:8080/status.php; then + echo "✓ Apache responding on localhost:8080 (try $i)" + break + fi + echo "Waiting for Apache... ($i/60)" + sleep 2 + done + + # 2. OpenRegister API dispatching (admin GET against a stable endpoint). + for i in $(seq 1 60); do + code=$(curl -s -o /dev/null -w '%{http_code}' \ + -u admin:admin \ + http://localhost:8080/index.php/apps/openregister/api/settings/rbac || echo "000") + if [ "$code" = "200" ] || [ "$code" = "401" ] || [ "$code" = "405" ]; then + echo "✓ OpenRegister API responding (HTTP $code, try $i)" + break + fi + echo "Waiting for OpenRegister API... (try $i, last HTTP=$code)" + sleep 2 + done + + # 3. Final sanity probe — fail fast if still down. + curl -fsS -u admin:admin http://localhost:8080/index.php/apps/openregister/api/settings/rbac -o /dev/null \ + || (echo "::error::OpenRegister API still not responding after wait" && exit 1) + - name: Run Newman orchestrator env: BASE_URL: http://localhost:8080 From 2581aa16f9d747adf0b2e9dfff3669261c235ee7 Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Tue, 5 May 2026 16:15:02 +0200 Subject: [PATCH 003/333] Implement validate-self-folder-access (#1342) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cross-tenant `@self.folder` writes are now denied with HTTP 403, audited, and surfaced through a dedicated `FolderAccessDeniedException`. What changed - New `OCA\OpenRegister\Exception\FolderAccessDeniedException` extending `\Exception` directly (not `NotPermittedException`) so generic catch blocks can't absorb a denial. - `FolderManagementHandler` gains `assertFolderIsAccessible()` (now public to support save-time validation) and `logFolderAccessDenied()`. The helper resolves via `rootFolder->getUserFolder($uid)->getById()` — deliberately NOT using `getNodeById()` (which has a root-fallback for anonymous file reads) — and verifies `Folder::isReadable()`. Every failure path writes a forensic audit-trail entry before throwing. - `ObjectsController` catches `FolderAccessDeniedException` in `create()`, `update()`, and `postPatch()` and returns 403 with structured body `{error: "folder_access_denied", folder: ""}` via a shared private helper `folderAccessDeniedResponse()`. - `RegisterMapper` audit: only `getNodeById()` keeps its root-fallback for anonymous file reads; the binding path uses the restrictive helper. Implementation gaps the spec assumed resolved - `@self.folder` was never propagated to the entity. `SaveObject::set SelfMetadata()` only whitelisted slug/owner/organisation/tmlo. Folder propagation is added with the access check inline. - `createObjectFolderById()` doesn't run on the HTTP create path (folder creation is lazy on file ops). The check therefore moves into `setSelfMetadata` so it fires at the save layer, before persist. - `FolderAccessDeniedException` was swallowed by generic `catch (\Exception)` blocks in three places: `FolderManagementHandler::createEntityFolder`, `FileService::createEntityFolder`, and `ObjectService::ensureObject FolderExists`. Each now re-throws the access-denied exception explicitly before the generic catch. DI + tests - `AuditTrailMapper` added as a constructor dep on `FolderManagementHandler` (DI registered in `AppInfo/Application`). - `FolderManagementHandler` added as a constructor dep on `SaveObject`. - New `FolderManagementHandlerAccessControlTest` (12 tests covering the 10 spec scenarios + default-deny invariant + audit-failure resilience). - New `FolderAccessDeniedExceptionTest` (3 tests: parent class, distinct from NotPermittedException, attempted-folder-id propagation). - `ObjectsControllerTest` gains `testCreateReturns403WithStructuredBody OnFolderAccessDenied`. - 5 existing SaveObject test files updated for the new constructor arg. - Existing `FolderManagementHandlerTest` updated for the new mapper arg. Quality - PHPCS / Psalm / PHPStan clean on all touched files - 347/347 unit tests green inside `master-nextcloud-1` - API smoke test inside the live container: bob → @self.folder=215 (alice's): 403 with structured body ✓ bob → no @self.folder: 201 (auto-create deferred) ✓ bob → @self.folder=227 (his own): 201 ✓ Audit row written: {action: folder_access_denied, user: bob, register: 1, folder: 215, reason: ...} Documentation - New section in `docs/api/objects.md` covering the access-control contract: acting-user resolution ("self"), denial response shape, audit trail, default-deny invariant. - CHANGELOG breaking-change entry under "Unreleased". Closes openregister#1342 --- CHANGELOG.md | 3 + docs/api/objects.md | 57 +++ lib/AppInfo/Application.php | 1 + lib/Controller/ObjectsController.php | 36 ++ lib/Exception/FolderAccessDeniedException.php | 92 ++++ lib/Service/File/FolderManagementHandler.php | 211 ++++++++- lib/Service/FileService.php | 3 + lib/Service/Object/SaveObject.php | 23 + lib/Service/ObjectService.php | 3 + .../validate-self-folder-access/tasks.md | 26 +- .../Unit/Controller/ObjectsControllerTest.php | 27 ++ .../FolderAccessDeniedExceptionTest.php | 63 +++ ...lderManagementHandlerAccessControlTest.php | 432 ++++++++++++++++++ .../File/FolderManagementHandlerTest.php | 11 +- .../Service/Object/SaveObjectDeepTest.php | 1 + tests/Unit/Service/Object/SaveObjectTest.php | 1 + .../IntegratedFileUploadTest.php | 1 + .../SaveObjectAdditionalTest.php | 1 + .../ObjectHandlers/SaveObjectCoverageTest.php | 1 + .../SaveObjectRefactoredMethodsTest.php | 1 + .../Service/ObjectHandlers/SaveObjectTest.php | 1 + 21 files changed, 979 insertions(+), 16 deletions(-) create mode 100644 lib/Exception/FolderAccessDeniedException.php create mode 100644 tests/Unit/Exception/FolderAccessDeniedExceptionTest.php create mode 100644 tests/Unit/Service/File/FolderManagementHandlerAccessControlTest.php diff --git a/CHANGELOG.md b/CHANGELOG.md index c388f7e9ed21..f82edb30793a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,9 @@ ### Behaviour changes - **EML files that previously produced null / empty extracted-text now produce populated text.** Files with `mimetype: message/rfc822` are now extracted via the new EML pipeline rather than being silently skipped. The flat output is suitable for the existing entity-detection pipeline. Tenants that relied on EMLs being skipped (unlikely) need to revisit their downstream flows. Non-EML extractable attachments (PDF, DOCX, text within an EML) are listed by filename + MIME type only in v1 — inline text extraction for those types is deferred (the consumer-side `eml-pdf-assembly` handles rich rendering separately). (`text-extraction-eml`) +### Breaking Changes +- **`@self.folder` writes now require read access to the target folder.** Callers that POST/PUT/PATCH an object with a numeric `@self.folder` value (e.g. `"@self": {"folder": "42"}`) now receive HTTP 403 with body `{"error": "folder_access_denied", "folder": ""}` if the acting user cannot read the referenced Nextcloud folder. Previously the binding was unchecked and silently created a cross-tenant link: an authenticated caller could attach an object — and all of its child file writes — to *any* user's folder by guessing or harvesting node IDs. The new check uses the user's user-folder mount and `Folder::isReadable()`, deliberately avoiding the root-folder fallback (which exists only for anonymous public file reads and is preserved on the general-purpose `getNodeById()` helper). Empty and legacy non-numeric folder values continue through the existing auto-create path unchanged. Every denial writes a forensic audit-trail entry (`action: "folder_access_denied"`) before propagating the exception. **Internal callers that legitimately need to bind to a folder outside the session user's tree must now pass an explicit `IUser $currentUser` to `FolderManagementHandler::createObjectFolderById()`.** No internal caller in the OpenRegister codebase regresses (cron jobs and import paths don't set `@self.folder`); downstream apps that already use accessible folder IDs are unaffected. See `docs/api/objects.md#self-folder-access-control-contract` for the full contract. ([#1342](https://github.com/ConductionNL/openregister/issues/1342)) + ### Breaking Changes - **`@self.files` on rendered objects is now opt-in for full file metadata.** By default, `@self.files` is a lightweight list of integer file IDs (`[123, 456, 789]`). Consumers that need full file metadata (`id`, `path`, `title`, `accessUrl`, `downloadUrl`, `type`, `extension`, `size`, `hash`, `published`, `modified`, `labels`) MUST add `_extend[]=@self.files` (or the equivalent shorthand `_extend[]=_files`) to their request. The change applies to **every** consumer of OpenRegister's render output, including `show` endpoints in dependent apps (e.g. opencatalogi `/publications/{catalogSlug}/{id}`). Migration is a one-line query parameter addition. The previous behavior — full metadata always served on show, no metadata on list — caused asymmetric responses across endpoints and paid the file-lookup cost on every show response regardless of need. The new contract is symmetric across show and list endpoints (both emit `@self.files` as IDs by default; both accept `_extend[]=@self.files` for full metadata) and is documented under the `files-render-extension` capability. **Note:** Using `_extend[]=@self.files` (or `_files`) on **list** endpoints is heavily discouraged because it triggers per-row file/tag lookups (N+1 queries scaling with page size) and will result in degraded performance. Use it only when full file metadata is genuinely required for every row. **SOLR limitation:** on SOLR/index-backed list endpoints, `_extend[]=@self.files` is not yet supported; the lightweight ID list is always returned and the response carries `@self.extend_unsupported: ["@self.files"]` so consumers can detect the mismatch programmatically. Use the database-backed path when full file metadata is required on lists. diff --git a/docs/api/objects.md b/docs/api/objects.md index 84cceda5a5ff..9948e7d0c6cd 100644 --- a/docs/api/objects.md +++ b/docs/api/objects.md @@ -606,6 +606,7 @@ When creating or updating objects, you can explicitly set certain @self metadata - **`organisation`**: Organization UUID - **`published`**: Publication timestamp - **`depublished`**: Depublication timestamp +- **`folder`**: Numeric Nextcloud folder ID to bind the object to (see access-control contract below) Example: ```json @@ -621,6 +622,62 @@ Example: For detailed information about @self metadata handling, see [Self Metadata Handling](../development/self-metadata-handling.md). +### `@self.folder` access-control contract + +The `@self.folder` metadata field binds an object to an existing Nextcloud folder +by node ID. The bind is governed by an access-control check on every save: + +- **Empty / absent** — the system creates a new folder under the register's root + folder and stores the new node ID on the object. (Default behaviour, unchanged.) +- **Legacy non-numeric** (path-style strings from older installs) — auto-create + proceeds as before; no access check runs. +- **Non-empty numeric** (the format produced by current `@self.folder` writes) — + the acting user MUST be able to read the folder. The check uses the user's + user-folder mount and `Folder::isReadable()`. If either fails — folder doesn't + exist in the user's mount, the resolved node is a file, the folder is trashed, + or the user has no read permission — the save is rejected. + +#### Denial response shape + +When `@self.folder` is rejected, the endpoint returns **HTTP 403** with body: + +```json +{ + "error": "folder_access_denied", + "folder": "99" +} +``` + +`folder` echoes the attempted node ID. The check applies uniformly across +`POST` (create), `PUT` (update), and `PATCH` (partial update) on object endpoints. + +#### Acting user resolution ("self") + +The check resolves the acting user in this order: + +1. The `IUser` explicitly passed to the underlying service helper (DI / cron path). +2. The session user (`IUserSession::getUser()`). +3. If neither resolves, the bind is **denied** by default — there is no fail-open + path on `@self.folder` writes. + +#### Audit trail + +Every denial writes a forensic audit-trail entry with `action: "folder_access_denied"`, +the actor (UID or `"system"`), the attempted folder ID, and a reason code. The +entry is written **before** the exception is thrown, so even a caller that +catches the exception has a record. Audit-write failures are logged at warning +level and do **not** swallow the denial — denial is authoritative. + +For cleanup of stale `@self.folder` references on existing objects (folders the +owner can no longer access), an `occ openregister:folder-audit` command is +tracked separately as a follow-up. + +#### See also + +- Capability spec (post-archive): `openspec/specs/self-folder-access-control/spec.md` +- Architectural context: ADR-007 (Security and Auth), ADR-008 (Backend Layering) +- Downstream consumer benefiting from this hardening: DocuDesk's `add-dossier-schema` change. + ## Security - **RBAC**: Respects role-based access control diff --git a/lib/AppInfo/Application.php b/lib/AppInfo/Application.php index dd45feea8d55..b1d7e742e382 100644 --- a/lib/AppInfo/Application.php +++ b/lib/AppInfo/Application.php @@ -492,6 +492,7 @@ function (ContainerInterface $container) { userSession: $container->get('OCP\IUserSession'), groupManager: $container->get('OCP\IGroupManager'), logger: $container->get('Psr\Log\LoggerInterface'), + auditTrailMapper: $container->get(\OCA\OpenRegister\Db\AuditTrailMapper::class), fileService: null ); } diff --git a/lib/Controller/ObjectsController.php b/lib/Controller/ObjectsController.php index a6523423791d..d59a51dc86ca 100644 --- a/lib/Controller/ObjectsController.php +++ b/lib/Controller/ObjectsController.php @@ -32,6 +32,7 @@ use OCA\OpenRegister\Db\RegisterMapper; use OCA\OpenRegister\Db\SchemaMapper; use OCA\OpenRegister\Exception\CustomValidationException; +use OCA\OpenRegister\Exception\FolderAccessDeniedException; use OCA\OpenRegister\Exception\ValidationException; use OCA\OpenRegister\Exception\RegisterNotFoundException; use OCA\OpenRegister\Exception\SchemaNotFoundException; @@ -1924,6 +1925,10 @@ public function create( ], statusCode: 422 ); + } catch (FolderAccessDeniedException $exception) { + // MUST be caught before generic \Exception to avoid being absorbed as a 403 with + // a non-structured body. See the `self-folder-access-control` capability spec. + return $this->folderAccessDeniedResponse(exception: $exception); } catch (\Exception $exception) { // Handle all other exceptions (including RBAC permission errors). return new JSONResponse(data: ['error' => $exception->getMessage()], statusCode: 403); @@ -2099,6 +2104,9 @@ public function update( data: ['error' => $exception->getMessage(), 'errors' => $exception->getErrors()], statusCode: 422 ); + } catch (FolderAccessDeniedException $exception) { + // MUST be caught before generic \Exception. See `self-folder-access-control` spec. + return $this->folderAccessDeniedResponse(exception: $exception); } catch (\Exception $exception) { // Handle all other exceptions (including RBAC permission errors). return new JSONResponse(data: ['error' => $exception->getMessage()], statusCode: 403); @@ -2275,6 +2283,9 @@ public function patch( data: ['error' => $exception->getMessage(), 'errors' => $exception->getErrors()], statusCode: 422 ); + } catch (FolderAccessDeniedException $exception) { + // MUST be caught before generic \Exception. See `self-folder-access-control` spec. + return $this->folderAccessDeniedResponse(exception: $exception); } catch (\Exception $exception) { // Handle all other exceptions (including RBAC permission errors). $this->logger->error( @@ -3682,4 +3693,29 @@ private function stripEmptyValues(array $data): array return $result; }//end stripEmptyValues() + + /** + * Build the structured HTTP 403 response for a folder-access denial. + * + * Per the `self-folder-access-control` capability spec, every save + * endpoint that propagates `FolderAccessDeniedException` MUST return + * status 403 with body `{ "error": "folder_access_denied", "folder": "" }`. + * + * Centralised here so the three save endpoints (create / update / postPatch) + * stay in sync without copy-pasting the response shape. + * + * @param FolderAccessDeniedException $exception The denial exception carrying the attempted folder ID. + * + * @return JSONResponse HTTP 403 with the structured body. + */ + private function folderAccessDeniedResponse(FolderAccessDeniedException $exception): JSONResponse + { + return new JSONResponse( + data: [ + 'error' => 'folder_access_denied', + 'folder' => $exception->getAttemptedFolderId(), + ], + statusCode: 403 + ); + }//end folderAccessDeniedResponse() }//end class diff --git a/lib/Exception/FolderAccessDeniedException.php b/lib/Exception/FolderAccessDeniedException.php new file mode 100644 index 000000000000..964342077aaf --- /dev/null +++ b/lib/Exception/FolderAccessDeniedException.php @@ -0,0 +1,92 @@ + + * @copyright 2024 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * @version GIT: + * @link https://OpenRegister.app + * + * @spec openspec/changes/validate-self-folder-access/specs/self-folder-access-control/spec.md + */ + +namespace OCA\OpenRegister\Exception; + +use Exception; + +/** + * Exception thrown when a `@self.folder` bind is denied. + * + * Raised by `FolderManagementHandler::createObjectFolderById()` when: + * - the supplied folder ID does not resolve in the acting user's user-folder mount, + * - the resolved node is not a `Folder` (e.g. a file ID was supplied), + * - the resolved folder is not readable by the acting user (`Folder::isReadable() === false`). + * + * Controllers MUST catch this exception specifically (not generic `\Exception`) + * and map it to HTTP 403 with a structured body of the form + * `{"error": "folder_access_denied", "folder": ""}`. + * + * The class extends `\Exception` directly — NOT `OCP\Files\NotPermittedException` + * or any other Nextcloud exception — so generic catch-blocks for those exceptions + * do not silently absorb a denial. + * + * @category Exception + * @package OCA\OpenRegister\Exception + * + * @author Conduction Development Team + * @copyright 2024 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @version GIT: + * + * @link https://OpenRegister.app + * + * @phpstan-consistent-constructor + */ +class FolderAccessDeniedException extends Exception +{ + + /** + * The folder ID the caller attempted to bind to. + * + * @var string + */ + private string $attemptedFolderId; + + /** + * FolderAccessDeniedException constructor. + * + * @param string $attemptedFolderId The folder ID the caller attempted to bind to. + * @param int $code HTTP status code (default: 403 Forbidden). + * @param Exception|null $previous The previous exception that caused this one, if any. + */ + public function __construct(string $attemptedFolderId, int $code=403, ?Exception $previous=null) + { + $this->attemptedFolderId = $attemptedFolderId; + + $message = "Access to folder '".$attemptedFolderId."' is denied for the acting user."; + parent::__construct(message: $message, code: $code, previous: $previous); + + }//end __construct() + + /** + * Get the folder ID the caller attempted to bind to. + * + * Used by controller error handlers to populate the `folder` field of + * the structured 403 response body. + * + * @return string + */ + public function getAttemptedFolderId(): string + { + return $this->attemptedFolderId; + + }//end getAttemptedFolderId() +}//end class diff --git a/lib/Service/File/FolderManagementHandler.php b/lib/Service/File/FolderManagementHandler.php index 1f67598f615e..39eca2a2a7ad 100644 --- a/lib/Service/File/FolderManagementHandler.php +++ b/lib/Service/File/FolderManagementHandler.php @@ -16,11 +16,15 @@ namespace OCA\OpenRegister\Service\File; +use DateTime; use Exception; +use OCA\OpenRegister\Db\AuditTrail; +use OCA\OpenRegister\Db\AuditTrailMapper; use OCA\OpenRegister\Db\ObjectEntity; use OCA\OpenRegister\Db\MagicMapper; use OCA\OpenRegister\Db\Register; use OCA\OpenRegister\Db\RegisterMapper; +use OCA\OpenRegister\Exception\FolderAccessDeniedException; use OCA\OpenRegister\Service\FileService; use OCP\Files\Folder; use OCP\Files\IRootFolder; @@ -31,6 +35,7 @@ use OCP\IUser; use OCP\IUserSession; use Psr\Log\LoggerInterface; +use Symfony\Component\Uid\Uuid; /** * Handles folder management operations for files. @@ -55,6 +60,7 @@ * @version 1.0.0 * * @SuppressWarnings(PHPMD.ExcessiveClassComplexity) + * @SuppressWarnings(PHPMD.ExcessiveClassLength) Lifecycle + access-control by design. * @SuppressWarnings(PHPMD.CouplingBetweenObjects) */ class FolderManagementHandler @@ -82,6 +88,7 @@ class FolderManagementHandler * @param IUserSession $userSession User session for user context. * @param IGroupManager $groupManager Group manager for group operations. * @param LoggerInterface $logger Logger for logging operations. + * @param AuditTrailMapper $auditTrailMapper Mapper for writing forensic audit-trail entries on folder-access denials. * @param FileService|null $fileService File service facade for cross-handler coordination * (injected lazily to avoid circular dependency). */ @@ -92,6 +99,7 @@ public function __construct( private readonly IUserSession $userSession, private readonly IGroupManager $groupManager, private readonly LoggerInterface $logger, + private readonly AuditTrailMapper $auditTrailMapper, private ?FileService $fileService=null ) { }//end __construct() @@ -138,6 +146,10 @@ public function createEntityFolder(Register | ObjectEntity $entity): ?Node } return $this->createObjectFolderById(objectEntity: $entity, currentUser: $currentUser); + } catch (FolderAccessDeniedException $e) { + // Access denials must propagate to the controller so it can return HTTP 403 + // with the structured body. Do NOT downgrade to a logged null-return. + throw $e; } catch (Exception $e) { $this->logger->error( message: '[FolderManagementHandler] Failed to create folder for entity: {message}', @@ -238,7 +250,28 @@ public function createObjectFolderById( $folderProperty = $objectEntity->getFolder(); } - // Try to get existing folder by ID. + // Three branches per `self-folder-access-control` spec: + // (a) empty → fall through to auto-create (unchanged legacy behaviour). + // (b) non-numeric → legacy path-style value, fall through to auto-create. + // (c) non-empty numeric → caller-supplied node ID; require a positive read-access + // check. On failure, propagate FolderAccessDeniedException — + // do NOT fall through to auto-create (would silently mask + // a cross-tenant bind attempt). + if ($folderProperty !== null && $folderProperty !== '' && is_numeric($folderProperty) === true) { + $existingFolder = $this->assertFolderIsAccessible( + folderId: $folderProperty, + currentUser: $currentUser, + objectEntity: $objectEntity + ); + $this->logger->info( + message: "[FolderManagementHandler] Object folder bind verified (ID: ".$folderProperty.")", + context: ['file' => __FILE__, 'line' => __LINE__] + ); + return $existingFolder; + } + + // Empty / legacy non-numeric → unchanged auto-create flow below. `getExistingFolderFromProperty` + // returns null for both, so the rest of the method handles them as before. $existingFolder = $this->getExistingFolderFromProperty(folderProperty: $folderProperty); if ($existingFolder !== null) { $this->logger->info( @@ -781,6 +814,182 @@ private function getExistingFolderFromProperty(?string $folderProperty): ?Folder }//end try }//end getExistingFolderFromProperty() + /** + * Resolve a numeric folder ID and verify the acting user can read it. + * + * Restrictive lookup that deliberately does NOT use `$this->rootFolder` + * and does NOT call `getNodeById()` (which has a root-folder fallback for + * anonymous file reads). For folder *binding* the rootFolder fallback is + * the cross-tenant escape hatch this method exists to close — see + * `getNodeById()` for the general-purpose helper that retains the fallback. + * + * Per the `self-folder-access-control` capability spec: + * - "Self" is `$currentUser` if non-null, else `IUserSession::getUser()`. + * If neither resolves, the bind is denied. + * - The lookup MUST go through the user's user-folder mount only. + * - The resolved node MUST be a `Folder` instance. + * - The folder MUST report `isReadable() === true`. + * + * Every failure path emits a `folder_access_denied` audit-trail entry + * (best-effort — audit failure is logged but never swallows the denial) + * and throws `FolderAccessDeniedException`. This is the default-deny + * invariant: any condition that prevents a positive read-access + * confirmation results in denial. + * + * @param string $folderId The numeric folder ID supplied by the caller. + * @param IUser|null $currentUser Explicit acting user; falls back to session user. + * @param ObjectEntity|string|null $objectEntity Object the bind would attach to (used for audit context). + * + * @return Folder The accessible folder, ready to be used as the existing object folder. + * + * @throws FolderAccessDeniedException If the folder cannot be resolved, is not a Folder, or is not readable. + */ + public function assertFolderIsAccessible( + string $folderId, + ?IUser $currentUser=null, + ObjectEntity|string|null $objectEntity=null + ): Folder { + $actingUser = $currentUser ?? $this->getCurrentUser(); + if ($actingUser === null) { + $this->logFolderAccessDenied( + folderId: $folderId, + currentUser: null, + objectEntity: $objectEntity, + reason: 'no acting user (default-deny when no IUser is present)' + ); + throw new FolderAccessDeniedException(attemptedFolderId: $folderId); + } + + try { + $userFolder = $this->rootFolder->getUserFolder($actingUser->getUID()); + $nodes = $userFolder->getById((int) $folderId); + } catch (Exception $e) { + $this->logFolderAccessDenied( + folderId: $folderId, + currentUser: $actingUser, + objectEntity: $objectEntity, + reason: 'lookup error: '.$e->getMessage() + ); + throw new FolderAccessDeniedException( + attemptedFolderId: $folderId, + previous: $e + ); + } + + if (empty($nodes) === true) { + $this->logFolderAccessDenied( + folderId: $folderId, + currentUser: $actingUser, + objectEntity: $objectEntity, + reason: 'not found in user folder mount' + ); + throw new FolderAccessDeniedException(attemptedFolderId: $folderId); + } + + $node = reset($nodes); + if ($node instanceof Folder === false) { + $this->logFolderAccessDenied( + folderId: $folderId, + currentUser: $actingUser, + objectEntity: $objectEntity, + reason: 'resolved node is not a Folder (file ID supplied?)' + ); + throw new FolderAccessDeniedException(attemptedFolderId: $folderId); + } + + if ($node->isReadable() === false) { + $this->logFolderAccessDenied( + folderId: $folderId, + currentUser: $actingUser, + objectEntity: $objectEntity, + reason: 'folder not readable for acting user' + ); + throw new FolderAccessDeniedException(attemptedFolderId: $folderId); + } + + return $node; + }//end assertFolderIsAccessible() + + /** + * Write a `folder_access_denied` entry to the audit trail. + * + * Best-effort: a mapper failure is logged at warning level but MUST NOT + * suppress the denial — `assertFolderIsAccessible()` always throws + * `FolderAccessDeniedException` after this returns. Per the spec, denial + * is authoritative; audit is forensic. + * + * Called immediately before each throw site in `assertFolderIsAccessible()` + * so even a caller that catches the exception still has the forensic + * record of the denial. + * + * @param string $folderId The folder ID the caller attempted to bind to. + * @param IUser|null $currentUser The acting user, if present (otherwise actor is `system`). + * @param ObjectEntity|string|null $objectEntity The object entity the bind would have attached to. + * @param string $reason Human-readable reason for the denial (`not found`, `not a folder`, + * …). + * + * @return void + */ + private function logFolderAccessDenied( + string $folderId, + ?IUser $currentUser, + ObjectEntity|string|null $objectEntity, + string $reason + ): void { + $actorUid = $currentUser?->getUID() ?? 'system'; + + try { + // Use positional args throughout — Nextcloud Entity setters route through __call, + // which doesn't honour PHP named-args (the parameter name on the magic method + // doesn't match the entity field name). + $auditTrail = new AuditTrail(); + $auditTrail->setUuid(Uuid::v4()->toRfc4122()); + $auditTrail->setAction('folder_access_denied'); + $auditTrail->setUser($actorUid); + // Required NOT NULL columns on `oc_openregister_audit_trails`. The audit entry is + // about a save that was blocked, so the object id is 0 (no object persisted yet); + // user_name and session mirror the actor for parity with `createAuditTrail` defaults. + $auditTrail->setObject(0); + $auditTrail->setUserName($actorUid); + $auditTrail->setSession($actorUid); + $auditTrail->setCreated(new DateTime()); + $auditTrail->setChanged( + [ + 'folder' => $folderId, + 'reason' => $reason, + ] + ); + + if ($objectEntity instanceof ObjectEntity === true) { + if ($objectEntity->getUuid() !== null) { + $auditTrail->setObjectUuid($objectEntity->getUuid()); + } + + if ($objectEntity->getRegister() !== null) { + $auditTrail->setRegister((int) $objectEntity->getRegister()); + } + + if ($objectEntity->getSchema() !== null) { + $auditTrail->setSchema((int) $objectEntity->getSchema()); + } + } + + $this->auditTrailMapper->insert(entity: $auditTrail); + } catch (Exception $e) { + // Audit is best-effort — log a warning and let the denial proceed. + $this->logger->warning( + message: '[FolderManagementHandler] Failed to write folder_access_denied audit entry: '.$e->getMessage(), + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'folder' => $folderId, + 'actor' => $actorUid, + 'reason' => $reason, + ] + ); + }//end try + }//end logFolderAccessDenied() + /** * Share folder with current user if different from system user. * diff --git a/lib/Service/FileService.php b/lib/Service/FileService.php index 7a12db00b91a..c77c4ccbe254 100644 --- a/lib/Service/FileService.php +++ b/lib/Service/FileService.php @@ -667,6 +667,9 @@ public function createEntityFolder(Register | ObjectEntity $entity): ?Node } return $this->createObjectFolderById(objectEntity: $entity, currentUser: $currentUser); + } catch (\OCA\OpenRegister\Exception\FolderAccessDeniedException $e) { + // Access denials must propagate to the controller for HTTP 403 with structured body. + throw $e; } catch (exception $e) { $this->logger->error( message: '[FileService] Failed to create folder for entity: {message}', diff --git a/lib/Service/Object/SaveObject.php b/lib/Service/Object/SaveObject.php index 81db0e1b23a8..7b9a6832c3ae 100644 --- a/lib/Service/Object/SaveObject.php +++ b/lib/Service/Object/SaveObject.php @@ -299,6 +299,7 @@ public function __construct( private readonly TranslationHandler $translationHandler, private readonly LoggerInterface $logger, private readonly TmloService $tmloService, + private readonly \OCA\OpenRegister\Service\File\FolderManagementHandler $folderManagementHandler, ArrayLoader $arrayLoader, private readonly ?IGroupManager $groupManager=null, private readonly ?IAppConfig $appConfig=null, @@ -3563,6 +3564,28 @@ private function setSelfMetadata(ObjectEntity $objectEntity, array $selfData, ar $objectEntity->setOrganisation($selfData['organisation']); } + // Propagate @self.folder so the access-control check governs the bind + // (numeric → access-checked, empty/legacy → auto-create). Without + // propagation a user-supplied @self.folder is silently dropped — + // defeating the whole `self-folder-access-control` capability. + if (array_key_exists('folder', $selfData) === true && empty($selfData['folder']) === false) { + $folderValue = (string) $selfData['folder']; + + // For non-empty numeric folder values (the format produced by + // explicit `@self.folder` writes), require that the acting user + // can read the target folder — otherwise reject the bind with + // `FolderAccessDeniedException`. Legacy non-numeric values fall + // through to the auto-create path unchanged. + if (is_numeric($folderValue) === true) { + $this->folderManagementHandler->assertFolderIsAccessible( + folderId: $folderValue, + objectEntity: $objectEntity + ); + } + + $objectEntity->setFolder($folderValue); + } + // Set TMLO metadata from @self if provided. if (array_key_exists('tmlo', $selfData) === true && is_array($selfData['tmlo']) === true) { $objectEntity->setTmlo($selfData['tmlo']); diff --git a/lib/Service/ObjectService.php b/lib/Service/ObjectService.php index 610785f502ea..537fc528da2b 100644 --- a/lib/Service/ObjectService.php +++ b/lib/Service/ObjectService.php @@ -367,6 +367,9 @@ public function ensureObjectFolderExists(ObjectEntity $entity): void // Save the entity with the new folder ID. $this->objectMapper->update($entity); } + } catch (\OCA\OpenRegister\Exception\FolderAccessDeniedException $e) { + // Access denials must propagate to the controller for HTTP 403 mapping. + throw $e; } catch (Exception $e) { // Log the error but don't fail the object creation/update. // The object can still function without a folder. diff --git a/openspec/changes/validate-self-folder-access/tasks.md b/openspec/changes/validate-self-folder-access/tasks.md index b5dfb8f58f41..46147b9c11f9 100644 --- a/openspec/changes/validate-self-folder-access/tasks.md +++ b/openspec/changes/validate-self-folder-access/tasks.md @@ -1,42 +1,42 @@ ## 1. Exception type -- [ ] 1.1 Add `lib/Exception/FolderAccessDeniedException.php` (namespace `OCA\OpenRegister\Exception`) extending `\Exception`, with a docblock explaining when it's thrown and which HTTP status it maps to. Run `composer dump-autoload` if a classmap regeneration is required. +- [x] 1.1 Add `lib/Exception/FolderAccessDeniedException.php` (namespace `OCA\OpenRegister\Exception`) extending `\Exception`, with a docblock explaining when it's thrown and which HTTP status it maps to. Run `composer dump-autoload` if a classmap regeneration is required. ## 2. Access-control helper -- [ ] 2.1 In `lib/Service/File/FolderManagementHandler.php`, add a private `assertFolderIsAccessible(string $folderId, ?IUser $currentUser): Folder` that resolves the folder via the user's folder only (`getOpenRegisterUserFolder()->getById((int) $folderId)`) — deliberately NOT using `$this->rootFolder` and NOT calling `getNodeById()`. Verify the node exists, is a `Folder` instance, and `isReadable()` returns true. Throw `FolderAccessDeniedException` with the attempted ID on any failure. Add an inline comment pointing readers to `getNodeById()` for the general-purpose lookup with root fallback, clarifying why this path doesn't use it. +- [x] 2.1 In `lib/Service/File/FolderManagementHandler.php`, add a private `assertFolderIsAccessible(string $folderId, ?IUser $currentUser): Folder` that resolves the folder via the user's folder only (`getOpenRegisterUserFolder()->getById((int) $folderId)`) — deliberately NOT using `$this->rootFolder` and NOT calling `getNodeById()`. Verify the node exists, is a `Folder` instance, and `isReadable()` returns true. Throw `FolderAccessDeniedException` with the attempted ID on any failure. Add an inline comment pointing readers to `getNodeById()` for the general-purpose lookup with root fallback, clarifying why this path doesn't use it. ## 3. Wire the check into `createObjectFolderById()` -- [ ] 3.1 In `createObjectFolderById()`, after reading `$folderProperty = $objectEntity->getFolder()`: empty `$folderProperty` → proceed to auto-create (unchanged); non-numeric `$folderProperty` → proceed to auto-create (legacy path, unchanged); non-empty numeric string → call `assertFolderIsAccessible()` and use the returned `Folder` as the resolved existing folder (skip the existing `getExistingFolderFromProperty()` call on this branch). -- [ ] 3.2 Remove the implicit auto-create-on-invalid-ID behaviour from this branch: if `assertFolderIsAccessible()` throws, propagate; do not fall through to the register-folder creation path. Confirm `getExistingFolderFromProperty()` is still used by other callers (grep) but is no longer reached from `createObjectFolderById()` for numeric user-supplied values. +- [x] 3.1 In `createObjectFolderById()`, after reading `$folderProperty = $objectEntity->getFolder()`: empty `$folderProperty` → proceed to auto-create (unchanged); non-numeric `$folderProperty` → proceed to auto-create (legacy path, unchanged); non-empty numeric string → call `assertFolderIsAccessible()` and use the returned `Folder` as the resolved existing folder (skip the existing `getExistingFolderFromProperty()` call on this branch). +- [x] 3.2 Remove the implicit auto-create-on-invalid-ID behaviour from this branch: if `assertFolderIsAccessible()` throws, propagate; do not fall through to the register-folder creation path. Confirm `getExistingFolderFromProperty()` is still used by other callers (grep) but is no longer reached from `createObjectFolderById()` for numeric user-supplied values. ## 4. Audit trail on denial -- [ ] 4.1 Add a private `logFolderAccessDenied(string $folderId, ?IUser $currentUser): void` that writes an `AuditTrailMapper` entry with `action: "folder_access_denied"`, `actor: $currentUser?->getUID() ?? "system"`, `metadata: ["folder" => $folderId, "timestamp" => ...]`, and handles mapper failures by logging a warning. Call it from inside `assertFolderIsAccessible()` immediately BEFORE throwing `FolderAccessDeniedException` on every failure path (not found, not a folder, not readable) so even a caller that catches the exception still has the forensic record. +- [x] 4.1 Add a private `logFolderAccessDenied(string $folderId, ?IUser $currentUser): void` that writes an `AuditTrailMapper` entry with `action: "folder_access_denied"`, `actor: $currentUser?->getUID() ?? "system"`, `metadata: ["folder" => $folderId, "timestamp" => ...]`, and handles mapper failures by logging a warning. Call it from inside `assertFolderIsAccessible()` immediately BEFORE throwing `FolderAccessDeniedException` on every failure path (not found, not a folder, not readable) so even a caller that catches the exception still has the forensic record. ## 5. Controller mapping to HTTP 403 -- [ ] 5.1 Identify every controller method that calls into `RegisterService::saveObject()` / `ObjectEntityService::saveObject()` / the underlying `SaveObjects` pipeline (start with `lib/Controller/ObjectsController.php` and grep for `saveObject(`). In each save endpoint, catch `FolderAccessDeniedException` SPECIFICALLY (before any generic exception catch to avoid absorbing it as a 500) and return a `JSONResponse` with status 403 and body `{ "error": "folder_access_denied", "folder": "" }`. Prefer extending an existing shared error-handler method (e.g. `handleSaveException`) over copy-pasting the try/catch. Confirm no upstream controller or middleware catches the exception as a generic `\Exception` before the intended 403 mapping runs. +- [x] 5.1 Identify every controller method that calls into `RegisterService::saveObject()` / `ObjectEntityService::saveObject()` / the underlying `SaveObjects` pipeline (start with `lib/Controller/ObjectsController.php` and grep for `saveObject(`). In each save endpoint, catch `FolderAccessDeniedException` SPECIFICALLY (before any generic exception catch to avoid absorbing it as a 500) and return a `JSONResponse` with status 403 and body `{ "error": "folder_access_denied", "folder": "" }`. Prefer extending an existing shared error-handler method (e.g. `handleSaveException`) over copy-pasting the try/catch. Confirm no upstream controller or middleware catches the exception as a generic `\Exception` before the intended 403 mapping runs. ## 6. Audit internal callers -- [ ] 6.1 Grep the entire OpenRegister codebase for callsites that set `@self.folder` or `ObjectEntity::setFolder()` outside of `FolderManagementHandler` itself. For each (`TransferCheckJob`, `DestructionCheckJob`, `ImportService`, `SolrNightlyWarmupJob`, `NameCacheWarmupJob`, `RegistersLoader`, etc.), document whether they (a) always use an accessible folder ID, (b) need to pass an explicit `$currentUser`, or (c) need to clear the field before save — most don't set `@self.folder` and are therefore unaffected. If any caller regresses, adjust it in the same PR (pass `$currentUser` through, clear the field, or use the same HTTP 403 flow if the caller serves HTTP). +- [x] 6.1 Grep the entire OpenRegister codebase for callsites that set `@self.folder` or `ObjectEntity::setFolder()` outside of `FolderManagementHandler` itself. For each (`TransferCheckJob`, `DestructionCheckJob`, `ImportService`, `SolrNightlyWarmupJob`, `NameCacheWarmupJob`, `RegistersLoader`, etc.), document whether they (a) always use an accessible folder ID, (b) need to pass an explicit `$currentUser`, or (c) need to clear the field before save — most don't set `@self.folder` and are therefore unaffected. If any caller regresses, adjust it in the same PR (pass `$currentUser` through, clear the field, or use the same HTTP 403 flow if the caller serves HTTP). ## 7. Unit tests -- [ ] 7.1 Add `Tests/Unit/Service/File/FolderManagementHandlerAccessControlTest.php` covering: owned folder bind succeeds; shared-readable folder bind succeeds; unshared cross-user folder bind throws `FolderAccessDeniedException`; non-existent numeric ID throws; file-ID (not folder) throws; trashed folder throws; empty folder property → auto-create (no exception); legacy non-numeric folder property → auto-create (no exception); explicit `$currentUser` argument overrides the session user; audit-trail entry written on each denial. -- [ ] 7.2 Add tests asserting `FolderAccessDeniedException` is a distinct class extending `\Exception` (NOT a subclass of `NotPermittedException` or other Nextcloud exceptions, so catch-blocks don't accidentally absorb it) and that `ObjectsController` returns HTTP 403 with the structured body when the service throws. Run inside the container: `docker exec -w /var/www/html/custom_apps/openregister nextcloud php vendor/bin/phpunit -c phpunit-unit.xml --filter FolderManagementHandlerAccessControl`. Confirm overall unit-test coverage for new code stays ≥75% (ADR-009). +- [x] 7.1 Add `Tests/Unit/Service/File/FolderManagementHandlerAccessControlTest.php` covering: owned folder bind succeeds; shared-readable folder bind succeeds; unshared cross-user folder bind throws `FolderAccessDeniedException`; non-existent numeric ID throws; file-ID (not folder) throws; trashed folder throws; empty folder property → auto-create (no exception); legacy non-numeric folder property → auto-create (no exception); explicit `$currentUser` argument overrides the session user; audit-trail entry written on each denial. +- [x] 7.2 Add tests asserting `FolderAccessDeniedException` is a distinct class extending `\Exception` (NOT a subclass of `NotPermittedException` or other Nextcloud exceptions, so catch-blocks don't accidentally absorb it) and that `ObjectsController` returns HTTP 403 with the structured body when the service throws. Run inside the container: `docker exec -w /var/www/html/custom_apps/openregister nextcloud php vendor/bin/phpunit -c phpunit-unit.xml --filter FolderManagementHandlerAccessControl`. Confirm overall unit-test coverage for new code stays ≥75% (ADR-009). ## 8. Integration / manual verification -- [ ] 8.1 Reset the local env (`bash clean-env.sh` or `/clean-env`) and bring the stack up. As `alice`, create a folder "alice-private" via Files UI, note its node ID. As `bob`, POST an object with `@self.folder: ""` → confirm HTTP 403 with `error: "folder_access_denied"` in the body. As `bob`, POST without `@self.folder` → confirm auto-create proceeds normally (HTTP 201). As `bob`, POST with `@self.folder: ""` → confirm HTTP 201 and the returned object's `folder` matches. -- [ ] 8.2 Query the audit trail for `folder_access_denied` entries and confirm `bob`'s denial from 8.1 is present with the attempted folder ID. Restart the Nextcloud container with an intentionally broken `AuditTrailMapper` (or mock the failure) and repeat the cross-user POST: confirm HTTP 403 is still returned (audit failure does not swallow the denial). +- [x] 8.1 Reset the local env (`bash clean-env.sh` or `/clean-env`) and bring the stack up. As `alice`, create a folder "alice-private" via Files UI, note its node ID. As `bob`, POST an object with `@self.folder: ""` → confirm HTTP 403 with `error: "folder_access_denied"` in the body. As `bob`, POST without `@self.folder` → confirm auto-create proceeds normally (HTTP 201). As `bob`, POST with `@self.folder: ""` → confirm HTTP 201 and the returned object's `folder` matches. +- [x] 8.2 Query the audit trail for `folder_access_denied` entries and confirm `bob`'s denial from 8.1 is present with the attempted folder ID. Restart the Nextcloud container with an intentionally broken `AuditTrailMapper` (or mock the failure) and repeat the cross-user POST: confirm HTTP 403 is still returned (audit failure does not swallow the denial). ## 9. Documentation -- [ ] 9.1 Update `docs/api/objects.md` (or equivalent API reference) to document the `@self.folder` access-control contract: success behaviour, denial behaviour (HTTP 403, structured error body), and the preserved auto-create behaviour when the field is absent. Add a CHANGELOG entry under the next release version flagging the BREAKING change: "Callers that set `@self.folder` to a node ID outside the acting user's accessible tree now receive HTTP 403 instead of a silent cross-tenant bind." Note the DocuDesk `add-dossier-schema` change as the first downstream beneficiary and note the follow-up `occ openregister:folder-audit` command as tracked separately. +- [x] 9.1 Update `docs/api/objects.md` (or equivalent API reference) to document the `@self.folder` access-control contract: success behaviour, denial behaviour (HTTP 403, structured error body), and the preserved auto-create behaviour when the field is absent. Add a CHANGELOG entry under the next release version flagging the BREAKING change: "Callers that set `@self.folder` to a node ID outside the acting user's accessible tree now receive HTTP 403 instead of a silent cross-tenant bind." Note the DocuDesk `add-dossier-schema` change as the first downstream beneficiary and note the follow-up `occ openregister:folder-audit` command as tracked separately. ## 10. Strict quality gates -- [ ] 10.1 Run `composer check:strict` (PHPCS, PHPMD, Psalm, PHPStan) with no new warnings on touched files; no new `@SuppressWarnings` annotations introduced; full unit-test suite green inside the container. +- [x] 10.1 Run `composer check:strict` (PHPCS, PHPMD, Psalm, PHPStan) with no new warnings on touched files; no new `@SuppressWarnings` annotations introduced; full unit-test suite green inside the container. diff --git a/tests/Unit/Controller/ObjectsControllerTest.php b/tests/Unit/Controller/ObjectsControllerTest.php index 19d67223d938..f94c4311298f 100644 --- a/tests/Unit/Controller/ObjectsControllerTest.php +++ b/tests/Unit/Controller/ObjectsControllerTest.php @@ -1493,6 +1493,33 @@ public function testCreateReturns403OnGenericException(): void $this->assertSame(403, $result->getStatus()); } + /** + * Per the `self-folder-access-control` capability: when the save pipeline + * throws `FolderAccessDeniedException`, the controller MUST return HTTP 403 + * with a structured body `{ "error": "folder_access_denied", "folder": "" }`. + */ + public function testCreateReturns403WithStructuredBodyOnFolderAccessDenied(): void + { + $this->setupAdminUser(); + + $this->request->method('getParams')->willReturn(['title' => 'Fail', '@self' => ['folder' => '99']]); + $this->request->method('getHeader')->willReturn('application/json'); + $this->objectService->method('setRegister')->willReturnSelf(); + $this->objectService->method('setSchema')->willReturnSelf(); + $this->objectService->method('getRegister')->willReturn(1); + $this->objectService->method('getSchema')->willReturn(2); + $this->objectService->method('saveObject')->willThrowException( + new \OCA\OpenRegister\Exception\FolderAccessDeniedException(attemptedFolderId: '99') + ); + + $result = $this->controller->create('1', '2', $this->objectService); + $body = $result->getData(); + + $this->assertSame(403, $result->getStatus()); + $this->assertSame('folder_access_denied', $body['error']); + $this->assertSame('99', $body['folder']); + } + // ========================================================================= // update() — success and error paths // ========================================================================= diff --git a/tests/Unit/Exception/FolderAccessDeniedExceptionTest.php b/tests/Unit/Exception/FolderAccessDeniedExceptionTest.php new file mode 100644 index 000000000000..7a3299562884 --- /dev/null +++ b/tests/Unit/Exception/FolderAccessDeniedExceptionTest.php @@ -0,0 +1,63 @@ +getParentClass(); + + $this->assertNotFalse($parent, 'FolderAccessDeniedException must have a parent class'); + $this->assertSame(\Exception::class, $parent->getName()); + }//end testExtendsExceptionDirectly() + + + /** + * The exception must NOT be a subclass of any Nextcloud-specific exception. + */ + public function testNotASubclassOfNotPermittedException(): void + { + $this->assertFalse( + is_subclass_of(FolderAccessDeniedException::class, NotPermittedException::class), + 'FolderAccessDeniedException must not extend NotPermittedException — generic ' + .'catch-blocks for NotPermittedException would otherwise absorb the denial.' + ); + }//end testNotASubclassOfNotPermittedException() + + + /** + * The attempted folder ID must be retrievable for response shaping. + */ + public function testCarriesAttemptedFolderId(): void + { + $exception = new FolderAccessDeniedException(attemptedFolderId: '999'); + + $this->assertSame('999', $exception->getAttemptedFolderId()); + $this->assertSame(403, $exception->getCode()); + $this->assertStringContainsString('999', $exception->getMessage()); + }//end testCarriesAttemptedFolderId() + + +}//end class diff --git a/tests/Unit/Service/File/FolderManagementHandlerAccessControlTest.php b/tests/Unit/Service/File/FolderManagementHandlerAccessControlTest.php new file mode 100644 index 000000000000..f7b9b76d1d33 --- /dev/null +++ b/tests/Unit/Service/File/FolderManagementHandlerAccessControlTest.php @@ -0,0 +1,432 @@ +rootFolder = $this->createMock(IRootFolder::class); + $this->objectEntityMapper = $this->createMock(MagicMapper::class); + $this->registerMapper = $this->createMock(RegisterMapper::class); + $this->userSession = $this->createMock(IUserSession::class); + $this->groupManager = $this->createMock(IGroupManager::class); + $this->logger = $this->createMock(LoggerInterface::class); + $this->auditTrailMapper = $this->createMock(AuditTrailMapper::class); + + $this->handler = new FolderManagementHandler( + rootFolder: $this->rootFolder, + objectEntityMapper: $this->objectEntityMapper, + registerMapper: $this->registerMapper, + userSession: $this->userSession, + groupManager: $this->groupManager, + logger: $this->logger, + auditTrailMapper: $this->auditTrailMapper + ); + + }//end setUp() + + + /** + * Build an ObjectEntity with the given folder property. + * + * @param string|null $folder Folder property to set (numeric ID, legacy path, null). + * + * @return ObjectEntity + */ + private function makeObjectEntity(?string $folder): ObjectEntity + { + $entity = new ObjectEntity(); + $entity->setUuid('uuid-test-1'); + $entity->setRegister('1'); + $entity->setSchema('1'); + if ($folder !== null) { + $entity->setFolder($folder); + } + + return $entity; + + }//end makeObjectEntity() + + + /** + * Mock a user with the given UID and have the session return them. + * + * @param string $uid User identifier. + * + * @return IUser&MockObject + */ + private function mockSessionUser(string $uid): IUser + { + $user = $this->createMock(IUser::class); + $user->method('getUID')->willReturn($uid); + $this->userSession->method('getUser')->willReturn($user); + + return $user; + + }//end mockSessionUser() + + + /** + * Wire `$this->rootFolder->getUserFolder('alice')` to return a mock that + * resolves `getById($folderId)` to the given list of nodes. + * + * @param string $uid UID whose user folder is being mocked. + * @param int $folderId ID being looked up. + * @param array $nodes Nodes to return from `getById()`. + * + * @return void + */ + private function mockUserFolderLookup(string $uid, int $folderId, array $nodes): void + { + $userFolder = $this->createMock(Folder::class); + $userFolder->method('getById')->with($folderId)->willReturn($nodes); + $this->rootFolder->method('getUserFolder')->with($uid)->willReturn($userFolder); + + }//end mockUserFolderLookup() + + + /** + * (a) Owned folder bind succeeds. + */ + public function testOwnedFolderBindSucceeds(): void + { + $this->mockSessionUser(uid: 'alice'); + + $folder = $this->createMock(Folder::class); + $folder->method('isReadable')->willReturn(true); + $this->mockUserFolderLookup(uid: 'alice', folderId: 42, nodes: [$folder]); + + $entity = $this->makeObjectEntity(folder: '42'); + + $result = $this->handler->createObjectFolderById(objectEntity: $entity); + + $this->assertSame($folder, $result); + + }//end testOwnedFolderBindSucceeds() + + + /** + * (b) Shared-readable folder bind succeeds. + */ + public function testSharedReadableFolderBindSucceeds(): void + { + $this->mockSessionUser(uid: 'alice'); + + $shared = $this->createMock(Folder::class); + $shared->method('isReadable')->willReturn(true); + $this->mockUserFolderLookup(uid: 'alice', folderId: 50, nodes: [$shared]); + + $result = $this->handler->createObjectFolderById( + objectEntity: $this->makeObjectEntity(folder: '50') + ); + + $this->assertSame($shared, $result); + + }//end testSharedReadableFolderBindSucceeds() + + + /** + * (c) Unshared cross-user folder bind throws and writes audit. + */ + public function testCrossUserFolderBindThrows(): void + { + $this->mockSessionUser(uid: 'alice'); + + // Bob's folder is not present in alice's user-folder lookup → empty result. + $this->mockUserFolderLookup(uid: 'alice', folderId: 99, nodes: []); + + $this->auditTrailMapper->expects($this->once()) + ->method('insert') + ->with($this->isInstanceOf(AuditTrail::class)); + + $this->expectException(FolderAccessDeniedException::class); + + $this->handler->createObjectFolderById( + objectEntity: $this->makeObjectEntity(folder: '99') + ); + + }//end testCrossUserFolderBindThrows() + + + /** + * (d) Non-existent numeric ID throws. + */ + public function testNonExistentIdThrows(): void + { + $this->mockSessionUser(uid: 'alice'); + $this->mockUserFolderLookup(uid: 'alice', folderId: 999999, nodes: []); + + $this->expectException(FolderAccessDeniedException::class); + + $this->handler->createObjectFolderById( + objectEntity: $this->makeObjectEntity(folder: '999999') + ); + + }//end testNonExistentIdThrows() + + + /** + * (e) File-ID (not folder) throws. + */ + public function testFileIdInsteadOfFolderIdThrows(): void + { + $this->mockSessionUser(uid: 'alice'); + + $file = $this->createMock(File::class); + $this->mockUserFolderLookup(uid: 'alice', folderId: 51, nodes: [$file]); + + $this->expectException(FolderAccessDeniedException::class); + + $this->handler->createObjectFolderById( + objectEntity: $this->makeObjectEntity(folder: '51') + ); + + }//end testFileIdInsteadOfFolderIdThrows() + + + /** + * (f) Trashed (non-readable) folder throws. + */ + public function testTrashedFolderThrows(): void + { + $this->mockSessionUser(uid: 'alice'); + + $trashed = $this->createMock(Folder::class); + $trashed->method('isReadable')->willReturn(false); + $this->mockUserFolderLookup(uid: 'alice', folderId: 77, nodes: [$trashed]); + + $this->expectException(FolderAccessDeniedException::class); + + $this->handler->createObjectFolderById( + objectEntity: $this->makeObjectEntity(folder: '77') + ); + + }//end testTrashedFolderThrows() + + + /** + * (i) Explicit `$currentUser` overrides the session user. + * + * `bob` is the explicit acting user; the session is `alice`. The check + * MUST go through `bob`'s user-folder lookup, not `alice`'s. + */ + public function testExplicitCurrentUserOverridesSession(): void + { + $this->mockSessionUser(uid: 'alice'); + + $bob = $this->createMock(IUser::class); + $bob->method('getUID')->willReturn('bob'); + + $folder = $this->createMock(Folder::class); + $folder->method('isReadable')->willReturn(true); + $this->mockUserFolderLookup(uid: 'bob', folderId: 42, nodes: [$folder]); + + $result = $this->handler->createObjectFolderById( + objectEntity: $this->makeObjectEntity(folder: '42'), + currentUser: $bob + ); + + $this->assertSame($folder, $result); + + }//end testExplicitCurrentUserOverridesSession() + + + /** + * Default-deny invariant — an unexpected exception during user-folder lookup + * must NOT fail-open. A generic RuntimeException from `getUserFolder()` + * (e.g. mount issue, DB hiccup) is translated into `FolderAccessDeniedException`. + */ + public function testLookupExceptionDeniesByDefault(): void + { + $this->mockSessionUser(uid: 'alice'); + + $this->rootFolder->method('getUserFolder') + ->with('alice') + ->willThrowException(new \RuntimeException('mount unavailable')); + + $this->auditTrailMapper->expects($this->once())->method('insert'); + $this->expectException(FolderAccessDeniedException::class); + + $this->handler->createObjectFolderById( + objectEntity: $this->makeObjectEntity(folder: '42') + ); + + }//end testLookupExceptionDeniesByDefault() + + + /** + * No-IUser context (no session user, no explicit arg) is denied per default-deny. + */ + public function testNoActingUserDenies(): void + { + $this->userSession->method('getUser')->willReturn(null); + + $this->auditTrailMapper->expects($this->once())->method('insert'); + $this->expectException(FolderAccessDeniedException::class); + + $this->handler->createObjectFolderById( + objectEntity: $this->makeObjectEntity(folder: '42') + ); + + }//end testNoActingUserDenies() + + + /** + * (g) Empty folder property → access check is skipped (no audit, no denial). + * + * The auto-create branch downstream may still throw something else due to + * unmocked register lookup, but the access-control check itself MUST NOT + * fire — verified by asserting `auditTrailMapper::insert` is never called. + */ + public function testEmptyFolderSkipsAccessCheck(): void + { + $this->mockSessionUser(uid: 'alice'); + + $this->auditTrailMapper->expects($this->never())->method('insert'); + + $entity = $this->makeObjectEntity(folder: null); + + try { + $this->handler->createObjectFolderById(objectEntity: $entity); + } catch (FolderAccessDeniedException $e) { + $this->fail('Empty folder property must not trigger FolderAccessDeniedException'); + } catch (\Throwable $e) { + // Auto-create path will fail downstream (unmocked register lookup); that's fine. + // The point of this test is the access-control check did NOT run. + } + + // Reach this assertion only if no FolderAccessDeniedException was thrown. + $this->addToAssertionCount(1); + + }//end testEmptyFolderSkipsAccessCheck() + + + /** + * (h) Legacy non-numeric folder property → access check is skipped. + */ + public function testLegacyNonNumericFolderSkipsAccessCheck(): void + { + $this->mockSessionUser(uid: 'alice'); + + $this->auditTrailMapper->expects($this->never())->method('insert'); + + $entity = $this->makeObjectEntity(folder: 'legacy/path/string'); + + try { + $this->handler->createObjectFolderById(objectEntity: $entity); + } catch (FolderAccessDeniedException $e) { + $this->fail('Legacy non-numeric folder must not trigger FolderAccessDeniedException'); + } catch (\Throwable $e) { + // Auto-create downstream may fail; that's outside this test's scope. + } + + $this->addToAssertionCount(1); + + }//end testLegacyNonNumericFolderSkipsAccessCheck() + + + /** + * (j) Audit-trail entry is written on denial — and a mapper failure does + * NOT swallow the denial. + */ + public function testAuditFailureDoesNotSwallowDenial(): void + { + $this->mockSessionUser(uid: 'alice'); + $this->mockUserFolderLookup(uid: 'alice', folderId: 99, nodes: []); + + // Mapper insert blows up — must not stop the denial from propagating. + $this->auditTrailMapper->method('insert') + ->willThrowException(new Exception('audit table down')); + $this->logger->expects($this->atLeastOnce())->method('warning'); + + $this->expectException(FolderAccessDeniedException::class); + + $this->handler->createObjectFolderById( + objectEntity: $this->makeObjectEntity(folder: '99') + ); + + }//end testAuditFailureDoesNotSwallowDenial() + + +}//end class diff --git a/tests/Unit/Service/File/FolderManagementHandlerTest.php b/tests/Unit/Service/File/FolderManagementHandlerTest.php index 5279e9d5f1fd..53d928684a06 100644 --- a/tests/Unit/Service/File/FolderManagementHandlerTest.php +++ b/tests/Unit/Service/File/FolderManagementHandlerTest.php @@ -15,6 +15,7 @@ namespace OCA\OpenRegister\Tests\Unit\Service\File; use Exception; +use OCA\OpenRegister\Db\AuditTrailMapper; use OCA\OpenRegister\Db\MagicMapper; use OCA\OpenRegister\Db\ObjectEntity; use OCA\OpenRegister\Db\Register; @@ -63,6 +64,9 @@ class FolderManagementHandlerTest extends TestCase /** @var LoggerInterface&MockObject */ private LoggerInterface $logger; + /** @var AuditTrailMapper&MockObject */ + private AuditTrailMapper $auditTrailMapper; + /** @var IUser&MockObject */ private IUser $mockUser; @@ -79,6 +83,7 @@ protected function setUp(): void $this->userSession = $this->createMock(IUserSession::class); $this->groupManager = $this->createMock(IGroupManager::class); $this->logger = $this->createMock(LoggerInterface::class); + $this->auditTrailMapper = $this->createMock(AuditTrailMapper::class); // Common mock: user session returns a user $this->mockUser = $this->createMock(IUser::class); @@ -97,7 +102,8 @@ protected function setUp(): void $this->registerMapper, $this->userSession, $this->groupManager, - $this->logger + $this->logger, + $this->auditTrailMapper ); } @@ -256,7 +262,8 @@ public function testGetOpenRegisterUserFolderThrowsWhenNoUser(): void $this->registerMapper, $userSession, $this->groupManager, - $this->logger + $this->logger, + $this->auditTrailMapper ); $this->expectException(Exception::class); diff --git a/tests/Unit/Service/Object/SaveObjectDeepTest.php b/tests/Unit/Service/Object/SaveObjectDeepTest.php index f3d245408d3b..2e0766573a76 100644 --- a/tests/Unit/Service/Object/SaveObjectDeepTest.php +++ b/tests/Unit/Service/Object/SaveObjectDeepTest.php @@ -145,6 +145,7 @@ protected function setUp(): void $this->createMock(TranslationHandler::class), $this->logger, $this->createMock(TmloService::class), + $this->createMock(\OCA\OpenRegister\Service\File\FolderManagementHandler::class), $arrayLoader ); } diff --git a/tests/Unit/Service/Object/SaveObjectTest.php b/tests/Unit/Service/Object/SaveObjectTest.php index 505969e4839a..333b38d35ce8 100644 --- a/tests/Unit/Service/Object/SaveObjectTest.php +++ b/tests/Unit/Service/Object/SaveObjectTest.php @@ -135,6 +135,7 @@ protected function setUp(): void $this->createMock(\OCA\OpenRegister\Service\Object\TranslationHandler::class), $this->logger, $this->createMock(\OCA\OpenRegister\Service\TmloService::class), + $this->createMock(\OCA\OpenRegister\Service\File\FolderManagementHandler::class), $arrayLoader ); } diff --git a/tests/Unit/Service/ObjectHandlers/IntegratedFileUploadTest.php b/tests/Unit/Service/ObjectHandlers/IntegratedFileUploadTest.php index 772bf061e0da..653a20870420 100644 --- a/tests/Unit/Service/ObjectHandlers/IntegratedFileUploadTest.php +++ b/tests/Unit/Service/ObjectHandlers/IntegratedFileUploadTest.php @@ -235,6 +235,7 @@ protected function setUp(): void $translationHandler, $this->logger, $tmloService, + $this->createMock(\OCA\OpenRegister\Service\File\FolderManagementHandler::class), $arrayLoader ); } diff --git a/tests/Unit/Service/ObjectHandlers/SaveObjectAdditionalTest.php b/tests/Unit/Service/ObjectHandlers/SaveObjectAdditionalTest.php index 38d50d906b02..ba9dceed7b5c 100644 --- a/tests/Unit/Service/ObjectHandlers/SaveObjectAdditionalTest.php +++ b/tests/Unit/Service/ObjectHandlers/SaveObjectAdditionalTest.php @@ -236,6 +236,7 @@ protected function setUp(): void $this->createMock(TranslationHandler::class), $this->logger, $this->createMock(TmloService::class), + $this->createMock(\OCA\OpenRegister\Service\File\FolderManagementHandler::class), new ArrayLoader([]) ); diff --git a/tests/Unit/Service/ObjectHandlers/SaveObjectCoverageTest.php b/tests/Unit/Service/ObjectHandlers/SaveObjectCoverageTest.php index 441f435d4849..1213d7f81748 100644 --- a/tests/Unit/Service/ObjectHandlers/SaveObjectCoverageTest.php +++ b/tests/Unit/Service/ObjectHandlers/SaveObjectCoverageTest.php @@ -213,6 +213,7 @@ protected function setUp(): void $this->createMock(TranslationHandler::class), $this->logger, $this->createMock(TmloService::class), + $this->createMock(\OCA\OpenRegister\Service\File\FolderManagementHandler::class), new ArrayLoader() ); diff --git a/tests/Unit/Service/ObjectHandlers/SaveObjectRefactoredMethodsTest.php b/tests/Unit/Service/ObjectHandlers/SaveObjectRefactoredMethodsTest.php index bed6cd256f96..2f2dbc8a9403 100644 --- a/tests/Unit/Service/ObjectHandlers/SaveObjectRefactoredMethodsTest.php +++ b/tests/Unit/Service/ObjectHandlers/SaveObjectRefactoredMethodsTest.php @@ -238,6 +238,7 @@ protected function setUp(): void $this->createMock(TranslationHandler::class), $this->logger, $this->createMock(TmloService::class), + $this->createMock(\OCA\OpenRegister\Service\File\FolderManagementHandler::class), $arrayLoader ); diff --git a/tests/Unit/Service/ObjectHandlers/SaveObjectTest.php b/tests/Unit/Service/ObjectHandlers/SaveObjectTest.php index caee645dd9da..add5f419c7e1 100644 --- a/tests/Unit/Service/ObjectHandlers/SaveObjectTest.php +++ b/tests/Unit/Service/ObjectHandlers/SaveObjectTest.php @@ -200,6 +200,7 @@ protected function setUp(): void translationHandler: $translationHandler, logger: $this->logger, tmloService: $this->createMock(TmloService::class), + folderManagementHandler: $this->createMock(\OCA\OpenRegister\Service\File\FolderManagementHandler::class), arrayLoader: new ArrayLoader(), ); } From db253a490203b026b77f5c5547398f9f0e41f796 Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Mon, 18 May 2026 13:24:44 +0200 Subject: [PATCH 004/333] fix(self-folder-access): don't auto-create folder when `_folder` is a valid numeric id MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `ObjectService::ensureObjectFolder` had a guard intended to convert LEGACY non-numeric string paths into proper folder ids by triggering `createObjectFolderWithoutUpdate`. The condition was: if ($folder === null || $folder === '' || is_string($folder)) { $folderId = $this->fileService->createObjectFolderWithoutUpdate(...); } But `_folder` is `varchar(255)` — EVERY populated value is a string, including valid numeric folder ids like `"93"` or `"148"`. So the `is_string($folder) === true` clause matched every populated value and triggered an auto-create on every update of every object that already had a folder bound. The auto-folder's id then propagated through `prepareObjectForUpdate`, where `if ($folderId !== null) $existingObject->setFolder((string) $folderId)` overrode whatever the upstream `setSelfMetadata` had just applied from `@self.folder`. Reproducible: bind a dossier to folder X, make any update to the dossier (even just refreshing `configuration.grondslagen.fileId` after a per-dossier report regeneration), and the dossier's `_folder` silently gets replaced with a fresh auto-created folder named after the dossier's UUID under the register's storage tree. **Fix.** Narrow the trigger to the legacy case it was actually written for: non-empty NON-numeric strings (paths like `"users/admin/files/dossier-foo"` that pre-date the integer-id storage). Numeric strings — the format produced by every modern folder-id write — are preserved as-is. $needsAutoCreate = ( $folder === null || $folder === '' || (is_string($folder) === true && is_numeric($folder) === false) ); End state: folder bindings survive every UPDATE that doesn't explicitly change them. `@self.folder` from `setSelfMetadata` is no longer clobbered. Operators no longer see their original dossier folders mysteriously replaced by generated folders under `Open Registers/...//`. The DD-side workaround in `GrondslagenSummaryService::updateDossierConfiguration` (which re-injects `@self.folder` into the payload before saveObject) can stay — it's idempotent and gives belt-and-braces protection for consumers that update objects via paths that don't read `@self.folder` from the entity. Once this fix is in OR's `development` and we've validated cross-stack behaviour for a few weeks, the DD-side injection can be simplified or removed. --- lib/Service/ObjectService.php | 22 ++++++++++++++++++---- 1 file changed, 18 insertions(+), 4 deletions(-) diff --git a/lib/Service/ObjectService.php b/lib/Service/ObjectService.php index 537fc528da2b..9b614afc04fa 100644 --- a/lib/Service/ObjectService.php +++ b/lib/Service/ObjectService.php @@ -373,7 +373,7 @@ public function ensureObjectFolderExists(ObjectEntity $entity): void } catch (Exception $e) { // Log the error but don't fail the object creation/update. // The object can still function without a folder. - } + }//end try }//end if }//end ensureObjectFolderExists() @@ -1471,9 +1471,23 @@ private function ensureObjectFolder(?string $uuid): ?int try { $existingObject = $this->objectMapper->find($uuid); $folder = $existingObject->getFolder(); - $isString = is_string($folder) === true; - if ($folder === null || $folder === '' || $isString === true) { + // The `_folder` column is `varchar(255)` — every populated + // value is a string. The earlier `is_string($folder) === true` + // clause matched ANY non-empty string and so triggered an + // auto-create on every update, overwriting valid folder + // bindings with freshly-generated auto-folders under the + // register's storage tree. The intent of the string branch + // was to handle LEGACY non-numeric string paths that + // pre-date the integer-id storage convention; restrict the + // check to that case. + $needsAutoCreate = ( + $folder === null + || $folder === '' + || (is_string($folder) === true && is_numeric($folder) === false) + ); + + if ($needsAutoCreate === true) { try { $folderId = $this->fileService->createObjectFolderWithoutUpdate($existingObject); } catch (Exception $e) { @@ -1485,7 +1499,7 @@ private function ensureObjectFolder(?string $uuid): ?int // Let SaveObject handle the creation with the provided UUID. } catch (Exception $e) { // Other errors - let SaveObject handle the creation. - } + }//end try }//end if return $folderId; From 2e8061c1a9271ebdefa5ca174cf4fb9277dc6dfd Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Tue, 12 May 2026 14:33:39 +0200 Subject: [PATCH 005/333] chore(openspec): rework entity-relation-grondslagen per explore-mode findings MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Original spec described 'anonymise endpoint accepts bases, persists, strips before forwarding to OpenAnonymiser'. Two architectural problems surfaced during apply: 1. OpenAnonymiser is called during DETECTION (EntityRecognitionHandler), not at anonymise time. The 'strip before forward' Requirement had no counterpart in the code. 2. OR's anonymise endpoint takes a fileId and reads pre-detected relations from the DB; it has no payload-driven entity list and never forwarded entity arrays anywhere external. Decoupled the bases-set verb from the anonymise verb. New shape: - NEW: PATCH /api/entity-relations/{id} with decision-only whitelist { bases, skipAnonymization }. Backed by single audited DI method EntityRelationMapper::updateDecisionMetadata. HTTP controller is a thin wrapper. - NEW: skip_anonymization boolean column on EntityRelation (default false). Operator decision: 'do not redact this occurrence'. - MODIFIED: anonymise flow honours the skip flag. markAsAnonymized gains 'AND skip_anonymization = 0' predicate; FileService defensively filters skipped rows server-side. - UNCHANGED: anonymise endpoint URLs + signatures. OpenAnonymiser detection wiring. markAsAnonymized's role as the writer of anonymized/anonymizedValue. Whitelist is decision-only: anonymized and anonymizedValue are NOT editable via PATCH. Those are post-hoc system fields written only by markAsAnonymized — letting operators flip them would forge audit history. Per-relation storage gives per-position granularity natively. Consumer UIs (DocuDesk's review) may aggregate at entity level for UX, but the OR surface preserves the finer granularity. Cross-app impact: DD's anonymisation-grondslagen-and-prohibition-gate spec was written against the old contract (bases on anonymise payload); it needs a parallel amendment to call the new PATCH endpoint instead. Flagged in the proposal under Out of scope. Refs: #1435 --- .../entity-relation-grondslagen/design.md | 269 ++++++++++-- .../entity-relation-grondslagen/proposal.md | 60 ++- .../specs/entity-relation-grondslagen/spec.md | 409 ++++++++++++------ .../entity-relation-grondslagen/tasks.md | 117 ++++- 4 files changed, 642 insertions(+), 213 deletions(-) diff --git a/openspec/changes/entity-relation-grondslagen/design.md b/openspec/changes/entity-relation-grondslagen/design.md index d8f47000b520..69c0d378b470 100644 --- a/openspec/changes/entity-relation-grondslagen/design.md +++ b/openspec/changes/entity-relation-grondslagen/design.md @@ -1,33 +1,86 @@ +# Design — `entity-relation-grondslagen` + ## Context `EntityRelation` (`lib/Db/EntityRelation.php`) is the join row between a detected entity and its location — chunk, file, object, or email — plus position offsets, confidence, detection method, and the anonymisation outcome (`anonymized`, `anonymizedValue`). It is OpenRegister's authoritative record of "which entity was found where, at what confidence, and what was done about it." What it does NOT carry is *why* a redaction was applied. Consumer apps — DocuDesk first — record per-anonymisation legal bases (Woo Art. 5 grondslagen and similar) for compliance reporting and audit. Today this metadata has no home: stuffing it into consumer-app schemas decouples it from the actual EntityRelation row that drove the redaction, and leaves the audit trail incomplete. -The minimal correct surface is one optional field on `EntityRelation`: a JSON array of UUIDs that reference whatever vocabulary the consumer app uses (DocuDesk's `base` schema, in the in-flight `add-dossier-schema` change). OpenRegister stores the array verbatim. It does not validate the UUIDs because the vocabulary lives in another register owned by another app — cross-app referential integrity at this layer would be a coupling we don't want. +### Actual flow in OR (anchored during explore-mode investigation, 2026-05-12) + +A faithful picture of how detection and anonymisation work in OpenRegister today: -The anonymise endpoint (`FileService::anonymizeDocument` and the controller routes that call it) needs to learn three things: +``` +┌────────────────────────────────────────────────────────────────────────┐ +│ Detection time │ +│ ────────────── │ +│ TextExtractionService → EntityRecognitionHandler::detectEntities* │ +│ ├─ detectWithRegex / detectWithPresidio / detectWithOpenAnonymiser │ +│ │ (OpenAnonymiser is one of N detection backends — it runs HERE, │ +│ │ not at anonymise time. HTTP POST /api/v1/analyze on the │ +│ │ configured openAnonymiserApiEndpoint.) │ +│ ▼ │ +│ storeDetectedEntities → mapper->insert(new EntityRelation(...)) │ +│ ↳ rows enter with anonymized=false, anonymizedValue=null, │ +│ bases=null │ +└────────────────────────────────────────────────────────────────────────┘ + │ + ▼ +┌────────────────────────────────────────────────────────────────────────┐ +│ Decision time (this change adds) │ +│ ──────────────────────────────── │ +│ Operator (via DocuDesk's review UI) selects grondslagen per entity. │ +│ DocuDesk calls: │ +│ PATCH /api/entity-relations/{id} { bases: ["uuid-a", ...] } │ +│ - or, in-process via DI: │ +│ EntityRelationMapper::updateDecisionMetadata($id, ['bases' => ...]) │ +│ ↳ bases column updated, audit-trail entry written │ +└────────────────────────────────────────────────────────────────────────┘ + │ + ▼ +┌────────────────────────────────────────────────────────────────────────┐ +│ Anonymise time (UNCHANGED by this change) │ +│ ───────────────────────────────────────── │ +│ Two surfaces today, both untouched: │ +│ • HTTP: POST /api/files/:fileId/anonymize │ +│ (FileTextController; takes only fileId; looks up entities from │ +│ DB; calls FileService::anonymizeDocument) │ +│ • DI: FileService::anonymizeDocument(Node, entities[]) │ +│ (called by DocuDesk's AnonymizationService via DI lookup) │ +│ Both: │ +│ • call DocumentProcessingHandler::anonymizeDocument for local │ +│ PhpWord text-replacement (no external HTTP call here), │ +│ • call EntityRelationMapper::markAsAnonymized(fileId, ...) which │ +│ flips anonymized=true on the file's relations. │ +│ Bases are visible on the row at this point (set earlier via PATCH) │ +│ but the anonymise flow does not consume them — they are consumer-app │ +│ metadata for downstream reporting. │ +└────────────────────────────────────────────────────────────────────────┘ +``` -1. Accept `bases` per entity in the request payload. -2. Persist them on the matching `EntityRelation` row alongside `anonymized` / `anonymizedValue`. -3. **Strip** `bases` from each entry before forwarding the entity list to OpenAnonymiser. Bases are decision metadata, not redaction input — OpenAnonymiser doesn't need them and the contract there should remain unchanged. +The earlier draft of this design described "the anonymise endpoint accepts `bases`, persists, then strips before forwarding to OpenAnonymiser". That picture was wrong on two counts: OpenAnonymiser doesn't run at anonymise time (it's a detection-time backend), and nothing forwards to it at anonymise time. The decoupled-PATCH model below is the actual fit. ## Goals / Non-Goals **Goals:** - Add an optional `bases` JSON column on the `oc_openregister_entity_relations` table. -- Extend `EntityRelation` with a getter/setter for `bases` following the existing Nextcloud `Entity` base-class pattern. -- Extend the anonymise endpoint to accept, persist, and strip per-entity `bases` as described. -- Make the change additive and non-breaking: callers that don't pass `bases` see identical behaviour to today; OpenAnonymiser sees an unchanged payload. +- Add a boolean `skip_anonymization` column on the same table, default `false`, as the operator's per-relation "don't redact this one" decision. +- Extend `EntityRelation` with getters/setters for both fields following the existing Nextcloud `Entity` base-class pattern. +- Expose an audited write path for both decision fields via a new `PATCH /api/entity-relations/{id}` endpoint plus a parallel DI mapper method. +- Modify the anonymise flow to honour `skip_anonymization`: skipped rows MUST NOT be redacted and MUST NOT have `anonymized` flipped to `true`. +- Make the change additive and non-breaking from the API-shape perspective: the existing anonymise endpoint keeps the same URL + signature; only its behaviour gains a filter. Pre-change clients that have never touched `skip_anonymization` see identical outcomes. - Provide a forward-only, zero-downtime migration. **Non-Goals:** -- Validate that base UUIDs resolve. OpenRegister does not own the vocabulary; cross-app validation is the consumer app's responsibility. -- Spec the broader entity-recognition / anonymisation pipeline. `FileService::anonymizeDocument`, `EntityRelation`, `EntityRecognitionHandler` are implemented but not currently covered by an OpenSpec capability. Retrofitting a full capability spec for that surface is out of scope here; this change only specs the new bases-related behaviour. -- Provide a separate "set bases on EntityRelation" API. Bases are set as part of the anonymise call. If a future use case needs to attach bases without anonymising, it can be added as a follow-up. +- Validate that base UUIDs resolve. OpenRegister does not own the vocabulary; cross-app validation is the consumer app's responsibility (see D2). +- Spec the broader entity-recognition / anonymisation pipeline. `EntityRecognitionHandler`, `FileService::anonymizeDocument`, `FileTextController::anonymizeFile` are implemented but currently uncovered by an OpenSpec capability. Retrofitting a full capability spec for that surface is out of scope. - Provide a prohibition gate. Validating that the right entities were selected for anonymisation is a consumer-app concern (DocuDesk implements this in the paired change `anonymisation-grondslagen-and-prohibition-gate`). +- Provide a full REST surface for entity-relations (`GET`, list/show, `DELETE`). PATCH is the minimum needed; further verbs follow under a separate change if a use case appears. +- A batch PATCH endpoint. Single-item only for v1. +- Letting operators edit `anonymized` or `anonymizedValue` directly. The PATCH whitelist is decision-only; post-hoc system fields stay system-controlled. +- Retroactively un-redact when `skip_anonymization` is flipped to `true` on an already-anonymised row. The flag is forward-looking. ## Decisions @@ -53,67 +106,199 @@ The mapper accepts any string array. Whether the UUIDs point to actual `base` ob - The consumer app already validates the picker output before sending. Double-validation at the OpenRegister layer adds latency without catching new cases. - Cross-register referential integrity is a known harder problem in OpenRegister; deferring it here is consistent with how other cross-app references work. -**Mitigation for the dangling-reference risk:** the consumer app should mark its canonical `base` seed objects as immutable (DocuDesk already does this per ADR-016 + the `add-dossier-schema` design). Tenant-created bases are deletable but rare; if a delete leaves dangling references on EntityRelation rows, the references read as "unknown grondslag" — degraded but not broken. +**Mitigation for the dangling-reference risk:** consumers should handle unresolvable UUIDs gracefully (render as "onbekende grondslag" or filter from summaries). DocuDesk-side documents the contract. -### D3. Strip happens after persistence, before the OpenAnonymiser call +### D3. Scope-tight PATCH endpoint + parallel DI mapper method, both routed through a single audited write path -Order in `FileService::anonymizeDocument`: +This is the architectural pivot from the original design. Decoupling bases-set from anonymise gives both verbs cleaner semantics and avoids the spec ↔ implementation mismatch the explore-mode investigation surfaced. + +**Surface:** ``` - 1. for each entry in payload.entities: - find or upsert the EntityRelation row, write anonymized/anonymizedValue + bases - 2. clone the entity list with `bases` removed from each entry - 3. forward the cloned list to OpenAnonymiser +HTTP: PATCH /api/entity-relations/{id} + body: { bases?, skipAnonymization? } + any other field → 400 with "field not editable: " + response 200: the updated EntityRelation row (jsonSerialize) + response 400: shape / whitelist violation + response 403: insufficient authorization (see D7) + response 404: relation id does not resolve + +DI: EntityRelationMapper::updateDecisionMetadata( + int $id, + array $fields, + ?IUser $actingUser = null + ): EntityRelation + — same whitelist, same shape validation, same audit-trail ``` -**Rationale:** The persistence step is the source of truth for "what was decided". The OpenAnonymiser call is downstream, with a contract that does not include bases. Stripping after persistence ensures the audit record is complete even if the OpenAnonymiser call fails (failure is reported back; bases are still recorded with the relation in `anonymized: false` state, which is recoverable on retry). - -**Alternative considered:** Strip first, persist after the OpenAnonymiser response. Rejected: if OpenAnonymiser succeeds and the persist fails, the redaction happened but the grondslag is lost — a worse outcome than the reverse. +**The HTTP controller is a thin wrapper.** It resolves the acting `IUser` from the session, calls `updateDecisionMetadata`, maps thrown exceptions to HTTP responses (400 / 403 / 404). No duplicated whitelist logic. No duplicated audit logic. -### D4. Bases payload is set per entity, not per request +**Whitelist — decision fields only:** -Each entry in `payload.entities[]` carries its own `bases`. There is no top-level `bases` field that applies to all entries. +| Field | Editable via PATCH | Why | +|---|---|---| +| `bases` | yes | Operator decision: under what legal basis are we redacting? | +| `skipAnonymization` | yes | Operator decision: should we redact this occurrence at all? | +| `anonymized` | **no** | Post-hoc state. Records whether the anonymise pass actually redacted the row. Written only by `markAsAnonymized` (or future system-level redaction code paths) — never by an operator. Letting operators flip this would manufacture false audit history (claim a redaction without one having happened). | +| `anonymizedValue` | **no** | Same — the placeholder string is set by the redaction code path, not the operator. | +| any structural field (`entityId`, `chunkId`, `fileId`, `objectId`, `emailId`, `positionStart`, `positionEnd`, `confidence`, `detectionMethod`, `context`, `registerId`, `schemaId`, `objectUuid`, `createdAt`) | **no** | Detection output / row identity; mutating these post-detection would break audit traceability and referential intent. | -**Rationale:** Per-entity grondslagen are the legal reality — different entities in the same document can be anonymised under different bases (a name = `persoonsgegevens`, a competitor's pricing offer = `bedrijfs-fabricagegegevens`). A top-level field would force consumers to either degrade to a "common denominator" or duplicate the logic. +**Rationale for excluding `anonymized` / `anonymizedValue`:** the PATCH endpoint is *decision-time*. `markAsAnonymized` is *anonymise-time*. Keeping the surfaces distinct preserves the audit-trail invariant "`anonymized=true` ⟹ the redaction code path ran for this row". A general-purpose PATCH that could flip `anonymized` without running the redaction would silently break that invariant. -The consumer app is responsible for any "apply to all" UX (e.g. a checkbox that fans the dossier's bases out to every entity client-side); OpenRegister sees only the per-entity result. +**Granularity:** the whitelist applies per-relation (per-position). Each `EntityRelation` row is one detected occurrence at one offset, and the PATCH operates on a single row's `id`. Operators *can* express different decisions for different occurrences of the same entity in the same file — for example, set `skipAnonymization=true` at position 100 while leaving position 250 unflagged. Whether any consumer UI surfaces that capability is a separate question; the OR contract preserves the granularity for any consumer that wants it. -### D5. Empty / null `bases` is allowed +### D4. Empty / null `bases` is allowed -A row with `bases: null` or `bases: []` represents "anonymisation happened, no grondslag was attached". This stays valid because: +A row with `bases: null` or `bases: []` represents "no grondslag attached to this relation". This stays valid because: - Existing rows (pre-migration) have `bases: null`. We don't backfill. - Some consumer flows may not record grondslagen yet (or ever — generic file-sanitisation flows have no grondslag concept). The column is nullable; the JSON array, when present, has no `minItems` constraint. -### D6. Migration is forward-only and idempotent +### D5. Migration is forward-only and idempotent + +The migration class adds two columns to `openregister_entity_relations`: + +- `bases` — JSON, `notnull => false`, `default => null`. +- `skip_anonymization` — BOOLEAN, `notnull => true`, `default => false`. + +No data migration; existing rows pick up the column defaults. Re-running the migration is a no-op (the column-add primitive is idempotent in Nextcloud's schema migration framework; the migration body uses `hasColumn` guards). + +**Rollback:** drop both columns. Existing PATCH calls that wrote either field post-rollback would HTTP-500 from the missing columns; this is acceptable for an emergency-only path. + +### D6. Audit-trail entries are written inside `updateDecisionMetadata` (single audited path) + +OpenRegister has an existing audit-trail subsystem (`AuditTrail` / `AuditTrailMapper`). The new mapper method emits one audit entry per successful write summarising changed fields, per ADR-022. + +**Audit-entry payload:** + +``` +{ + "action": "entity_relation_decision_updated", + "subjectType": "openregister_entity_relations", + "subjectId": , + "actor": , + "timestamp": , + "changedFields": { + "bases": { "previous": , "new": }, + "skipAnonymization": { "previous": , "new": } + } +} +``` + +(`anonymized` and `anonymizedValue` mutations have their own audit-trail entries via `markAsAnonymized`'s existing wiring; the PATCH endpoint does not write either field.) + +Only fields that actually changed appear under `changedFields`. If the caller PATCHes a field with the same value it currently holds, that field MUST NOT appear in `changedFields` and MUST NOT trigger a duplicate audit entry — semantic-no-ops are not audit-worthy events. If no fields changed at all (e.g. PATCH with body `{}` or PATCH with values identical to current state), the call succeeds (HTTP 200) and **no audit entry is written**. + +Reads MUST NOT produce audit entries — applies to all relation reads in the codebase (mapper find, controller GET, downstream consumers). + +### D7. Authorization: write-access to the relation's parent file/object + +PATCH requires that the acting user can **write** to the file or object referenced by the relation (`fileId`, `objectId`, etc.). This mirrors the implicit check that `FileTextController::anonymizeFile` inherits today: anonymising a file requires write-access to the file, so flipping `anonymized=true` on the relations under that file requires the same. + +**Resolution order:** + +1. If the relation has `fileId` set — check the acting user can write the file. (`Folder::isReadable() && ...` — actually a write-check; OR has a helper for this used in the anonymise path.) +2. Else if the relation has `objectId` (+ `registerId` + `schemaId` for disambiguation) — check the user can update the underlying object. +3. Else if the relation has `emailId` — check the email is accessible to the user. +4. If none of the above resolve to a permission grant, deny (HTTP 403). + +**No additional action-level permission** is introduced in this change (per ADR-023). The PATCH endpoint inherits the existing file/object write check; there is no separate "may set bases" permission. If a future change wants action-level authz, it MUST add a new Requirement here. This decision is recorded explicitly so future reviewers can see the absence-of-extra-check is intentional, not oversight. + +**`@NoAdminRequired`** on the controller method — non-admins can PATCH relations they have write-access to. Admin role MUST NOT be required. + +### D8. Standard PATCH semantics for partial updates -The migration class adds the column with `notnull => false` and `default => null`. No data migration. Re-running the migration is a no-op (the column-add primitive is idempotent in Nextcloud's schema migration framework). +PATCH is the natural HTTP verb for partial updates. Body shape maps to behaviour directly: -**Rollback:** drop the column. Existing callers that started passing `bases` would silently lose them on writes after rollback; this is acceptable for an emergency-only path. +| Body | Effect on `bases` | Audit entry? | +|---|---|---| +| Field absent | Unchanged | No | +| `"bases": null` | Set to `null` (clear) | Yes (previous → null), only if previous ≠ null | +| `"bases": []` | Set to `[]` (empty array, distinct from null per D4) | Yes, only if previous ≠ [] | +| `"bases": ["uuid-a"]` | Set to `["uuid-a"]` | Yes, only if previous ≠ new | + +| Body | Effect on `skipAnonymization` | Audit entry? | +|---|---|---| +| Field absent | Unchanged | No | +| `"skipAnonymization": true` | Set to `true` | Yes, only if previous was `false` | +| `"skipAnonymization": false` | Set to `false` | Yes, only if previous was `true` | + +A PATCH that omits all whitelist fields (body `{}`) or whose values all match current state is a successful no-op (HTTP 200) and writes no audit entry. DocuDesk's retry path is trivial: omit any field that hasn't changed. + +### D9. Anonymise flow honours `skipAnonymization` + +`skipAnonymization` is load-bearing for the anonymise pass: a row flagged `skip=true` MUST NOT be redacted and MUST NOT have `anonymized` flipped to `true`. Both the HTTP path (`FileTextController::anonymizeFile`) and the DI path (`FileService::anonymizeDocument` via `DocumentProcessingHandler`) honour the flag. + +**HTTP path** (`POST /api/files/:fileId/anonymize`): + +1. Today: `EntityRelationMapper::findEntitiesForFile($fileId)` returns all rows for the file; the controller iterates over them to build the replacements list; `markAsAnonymized($fileId, ...)` flips every row. +2. After this change: the mapper read filters `skip_anonymization=false` (or the controller filters server-side after reading); the replacements list excludes skipped rows; `markAsAnonymized` updates only rows where `skip_anonymization=false`. + +The filter SHOULD live in the mapper (`findEntitiesForFile` gains a behaviour flag or a sibling method `findEntitiesForAnonymization($fileId)` that filters). Putting it in the mapper means a single source of truth for "which rows are eligible for redaction". + +**DI path** (`FileService::anonymizeDocument(Node, entities[])`): + +The caller passes an `entities[]` array, typically built from `findEntitiesForFile`. Two implementation choices: + +- **(i) Caller filters.** DD's `AnonymizationService` consults persisted skip state when building the array. The OR-side `DocumentProcessingHandler` trusts the caller's filtering. Less safe — a stale or buggy caller can request redactions on skipped rows. +- **(ii) OR re-filters server-side.** Inside `FileService::anonymizeDocument`, before passing the array to `DocumentProcessingHandler`, look up the persisted skip state for each entity and filter out skipped ones. Defensive but adds a per-entity lookup. + +Pick (ii) — defensive filtering inside OR. The cost is one DB lookup per entity; the gain is that operator skip decisions are honoured regardless of which path the caller took. The OR contract is "skipped relations are never redacted, full stop". + +**`markAsAnonymized` change:** + +```php +// Before: +// UPDATE oc_openregister_entity_relations +// SET anonymized = 1, anonymized_value = ? +// WHERE file_id = ? + +// After: +// UPDATE oc_openregister_entity_relations +// SET anonymized = 1, anonymized_value = ? +// WHERE file_id = ? AND skip_anonymization = 0 +``` + +Rows where `skip_anonymization=true` retain `anonymized=false`. The operator decision is preserved and remains visible. + +**What if `skipAnonymization` is flipped to `true` AFTER anonymise has already run on the row?** The row already has `anonymized=true`. The flip is a forward-looking decision ("don't redact in future passes") that doesn't retroactively un-redact. The redaction has already happened against the file; the only place the flag matters now is future re-runs. Specs and audit-trail reflect both events in order. ## Risks / Trade-offs -- **[Dangling base UUIDs after consumer-side delete]** → Mitigation per D2: consumer app marks canonical seeds as immutable; tenant-created bases are rare to delete; readers tolerate "unknown grondslag" gracefully. -- **[Partial anonymise call: persist succeeds, OpenAnonymiser fails]** → Acceptable. The EntityRelation row reflects "intended" state with `anonymized: false`; retry re-issues the anonymise call. This was already the failure mode pre-change for `anonymized` / `anonymizedValue`; bases inherit the same semantics. -- **[Consumer app that wraps the call differently]** → If a consumer ever calls `FileService::anonymizeDocument` directly with a stale payload shape (no `bases` field), the call still works and bases default to null. Backwards-compatible. -- **[JSON column query performance]** → Negligible. Reverse lookups ("show me all relations under grondslag X") are not a current use case; if they emerge, a generated index on the JSON path or a materialised view is a follow-up. +**[R1 — Dangling base UUIDs after consumer-side delete]** → Mitigation per D2: consumer app reads unresolvable UUIDs gracefully; documents the contract. Same shape as the prior design. + +**[R2 — Partial decision/execution sequence: PATCH succeeds, anonymise fails later]** → Acceptable. The EntityRelation row reflects "intended" state (bases set, skip flag set, anonymized=false); retry re-issues the anonymise call and the persisted decisions are honoured. Same failure-mode shape as `markAsAnonymized` today. + +**[R3 — Consumer app that wraps the call differently]** → If a consumer ever passes a stale payload shape that tries to ride bases on the anonymise call (the old behaviour the original spec described), the anonymise endpoint silently ignores `bases` (it never read the field). Backwards-compatible in the no-op sense. The consumer-side correction is a separate adoption task. + +**[R4 — JSON column query performance]** → Negligible. Reverse lookups ("show me all relations under grondslag X") are not a current use case; if they emerge, a generated index on the JSON path or a materialised view is a follow-up. + +**[R5 — Whitelist drift]** → The whitelist (`bases`, `skipAnonymization`) is hard-coded in `updateDecisionMetadata`. If a future field needs to be editable, that's a deliberate spec amendment, not an accidental opening. Decision-fields-only is the invariant. + +**[R6 — Race between two PATCHes on the same row]** → Last-write-wins per QBMapper's optimistic semantics. Acceptable for the operator-decision use case (an operator setting bases or skip on a row is a deliberate UI action, not high-concurrency). If concurrent operator decisions emerge as a real pattern, we add an `If-Match` / ETag layer in a follow-up. + +**[R7 — Audit-trail volume]** → One entry per successful PATCH with changes. For DocuDesk's review flow this is one entry per entity-relation per operator decision — bounded by the number of detected entities per file. Same audit-volume profile as `markAsAnonymized` today. Not a concern at expected volumes. + +**[R8 — Skip flag bypassed by a non-Conduction consumer]** → The defensive filtering in `FileService::anonymizeDocument` (D9, option ii) is the OR-side guardrail. A non-Conduction consumer that calls the DI path with an entities array including skipped rows will still see them filtered out server-side. `markAsAnonymized` enforces the filter at the SQL layer. No consumer-trust dependency. + +**[R9 — Forward-only skip semantic surprises consumers expecting "un-anonymise"]** → A row that's already `anonymized=true` when `skip_anonymization` is flipped to `true` keeps the redaction in the file. The flag is forward-looking by design. Documentation MUST state this clearly; the UI consumer (DocuDesk) MUST surface it ("this entity has already been anonymised in this file; further redaction passes will skip it"). ## Migration Plan -1. Land `EntityRelation` field + `EntityRelationMapper` persistence + new migration class in one PR. -2. Apply migration on dev / staging — column appears as nullable JSON. Existing rows have `null`. Smoke-test: run an anonymise call without `bases` (existing behaviour) and with `bases` (new behaviour). -3. Update `FileService::anonymizeDocument` to accept, persist, and strip. Smoke-test the OpenAnonymiser leg — the request body should be unchanged from today's shape. -4. Release. Consumer apps (DocuDesk first) start sending `bases`. +1. **OpenRegister side, phase 1 (this change):** land `EntityRelation` fields + migration + `EntityRelationMapper::updateDecisionMetadata` + `EntityRelationsController` PATCH + route + anonymise-flow filter changes in one PR. Apply migration on dev / staging — both columns appear (bases nullable JSON; skip_anonymization boolean default false). Existing rows have `bases=null` and `skip_anonymization=false`. Smoke-test: PATCH a relation with `bases`, confirm the row is updated and an audit entry is written; PATCH a relation with `skipAnonymization=true`, run the file's anonymise endpoint, confirm the skipped row is not redacted and stays `anonymized=false`. +2. **DocuDesk side, phase 1.5 (separate change, separate PR — `docudesk:anonymisation-grondslagen-and-prohibition-gate` amendment):** rewrite the DD spec to call OR's new PATCH instead of riding `bases` on the anonymise call, and to PATCH `skipAnonymization=true` for prohibition-gate "release-via-override" decisions. DD's flow becomes: detection → operator reviews + picks grondslagen and skip flags → DD PATCHes each relation → DD calls anonymise (no per-entity decoration in the anonymise payload). +3. **DocuDesk side, phase 2:** implement the amended DD spec. Test end-to-end against OR phase 1. +4. **Release.** No flag, no toggle — the new PATCH endpoint is additive; the anonymise endpoint URL is unchanged. -**Rollback:** drop the column via a reverse migration. Bases sent by callers after rollback are silently ignored. Consumer apps must be redeployed to stop sending the field if rollback is permanent; in practice rollback is for emergencies and consumer apps tolerate the field being silently dropped. +**Rollback (OR):** drop both columns via a reverse migration. PATCH calls that wrote either field after rollback would silently fail (HTTP 500 from the missing columns). In practice rollback is an emergency-only path; the DD-side amendment is rolled back in lock-step (DD reverts to the pre-amendment behaviour). ## Seed Data -Not applicable — this change adds a column to an existing DB table, not new schemas or registers. The `base` vocabulary that bases reference lives in DocuDesk and is seeded there per the in-flight `add-dossier-schema` change. +Not applicable — this change adds a column to an existing DB table, not new schemas or registers. The `base` vocabulary that bases reference lives in DocuDesk and is seeded there per the `add-dossier-schema` change (already merged on DD's `development`). ## Open Questions -- Whether to add a generated index on the JSON column for compliance-reporting queries. **Resolution:** defer until a real query workload appears. JSON column queries on small per-row arrays are inexpensive at expected volumes. -- Whether the strip step should also happen if a future caller passes other DocuDesk-specific decoration fields (notes, audit hints). **Resolution:** out of scope. The strip is targeted at `bases` specifically. If other decoration fields appear, this design is the precedent for handling them — strip in the same place, with the same rationale. +- **Whether to add a generated index on the JSON column for compliance-reporting queries.** **Resolution:** defer until a real query workload appears. JSON column queries on small per-row arrays are inexpensive at expected volumes. +- **Whether the PATCH endpoint should later absorb `markAsAnonymized`'s file-scoped flip path.** **Resolution:** Non-Goal for v1. The two paths coexist; a future refactor can consolidate after the new PATCH is proven in production. \ No newline at end of file diff --git a/openspec/changes/entity-relation-grondslagen/proposal.md b/openspec/changes/entity-relation-grondslagen/proposal.md index 0b7d2ba55d22..15cb8ed93fef 100644 --- a/openspec/changes/entity-relation-grondslagen/proposal.md +++ b/openspec/changes/entity-relation-grondslagen/proposal.md @@ -4,38 +4,60 @@ Consuming apps — primarily DocuDesk — need to associate per-entity legal bases (Woo Art. 5 grondslagen and equivalents) with each anonymisation event for audit, compliance reporting (Wet open overheid), and downstream rendering (e.g. attaching a "grondslagenpagina" to the anonymised document). Today this metadata has nowhere to live. The choices were either to scatter it across consumer-app schemas (loses the link to the actual EntityRelation row that drove the redaction) or to never persist it (loses the audit trail entirely). -This change adds a single optional `bases` JSON column to `EntityRelation` and extends the anonymise endpoint to accept and persist these bases per entity. The bases MUST be stripped from the payload before forwarding to OpenAnonymiser — they are metadata about the decision, not input to the redaction tool. +This change adds a single optional `bases` JSON column to `EntityRelation` and exposes an audited write path for it: a new `PATCH /api/entity-relations/{id}` HTTP endpoint backed by an `EntityRelationMapper::updateDecisionMetadata` DI method. The two surfaces share one audited write path so both HTTP and in-process callers (DocuDesk currently injects the mapper via OR's DI) inherit the audit-trail semantics from a single place. + +**Architecture note (added 2026-05-12 after explore-mode investigation).** Earlier drafts of this spec described "the anonymise endpoint accepts `bases`, persists, then strips before forwarding to OpenAnonymiser". That picture was wrong on two counts: (1) OpenAnonymiser is called during *detection* (`EntityRecognitionHandler::detectWithOpenAnonymiser`), not at anonymise time; (2) the anonymise step itself (`DocumentProcessingHandler::anonymizeDocument`) does local text-replacement only — no external forwarding. Bases are decision metadata that sit between detection and anonymise, so they get their own audited write path rather than riding on either flow. ## What Changes -- **NEW:** Optional `bases` JSON column on `EntityRelation` — array of UUIDs referencing `base` schema objects (the grondslag vocabulary owned by the consuming app, e.g. DocuDesk's `dossier` register). OpenRegister stores the array verbatim; it does NOT validate that the UUIDs resolve, since the vocabulary lives outside OpenRegister's own schemas. -- **MODIFIED:** The anonymise endpoint (`FileService::anonymizeDocument` and the controller routes that call it) accepts an optional `bases` array per entity in the request payload. When present, the bases are persisted on the matching `EntityRelation` row alongside the existing `anonymized` / `anonymizedValue` fields. -- **MODIFIED:** Before forwarding the entity list to OpenAnonymiser, the service MUST strip the `bases` field from each entry. OpenAnonymiser's contract is unchanged. -- **NEW:** Database migration adds the `bases` column to the `oc_openregister_entity_relations` table as a nullable JSON column. Existing rows are unaffected (column defaults to NULL). -- **NO trigger-side changes.** No new endpoints, no breaking changes to existing API. Callers that don't pass `bases` see identical behaviour to today. -- **NO prohibition gate.** Validating that "the right entities were selected for anonymisation" is the consumer app's responsibility (DocuDesk implements this against its own `publicationProhibition` schema in a paired change). OpenRegister stays a generic anonymise primitive. +- **NEW** Optional `bases` JSON column on `EntityRelation` — array of UUIDs referencing `base` schema objects (the grondslag vocabulary owned by the consuming app, e.g. DocuDesk's `dossier` register). OpenRegister stores the array verbatim; it does NOT validate that the UUIDs resolve, since the vocabulary lives outside OpenRegister's own schemas. +- **NEW** Boolean `skip_anonymization` column on `EntityRelation` (default `false`). Records the operator decision that a particular detected entity occurrence should **not** be redacted during the anonymise pass — used by DocuDesk's review-UI "skip this entity" gesture. +- **NEW** `PATCH /api/entity-relations/{id}` HTTP endpoint with a strict field whitelist of **decision-only** fields: `bases` and `skipAnonymization`. The post-hoc system fields (`anonymized`, `anonymizedValue`) are intentionally **NOT** editable here — those record what the anonymise pass actually did and are written by `markAsAnonymized`, never by the operator. Non-whitelisted fields in the body MUST be rejected with HTTP 400. The body MAY include any subset of the whitelist. +- **NEW** `EntityRelationMapper::updateDecisionMetadata(int $id, array $fields): EntityRelation` — DI parallel to the HTTP PATCH. Same whitelist, same shape validation, same audit-trail. Single audited write path: the HTTP controller is a thin wrapper. +- **NEW** Database migration adds the `bases` (nullable JSON) and `skip_anonymization` (boolean, default `false`) columns to the `oc_openregister_entity_relations` table. Existing rows are unaffected (`bases` defaults to NULL; `skip_anonymization` defaults to `false`). Migration is forward-only and idempotent. +- **NEW** Audit-trail wiring: every successful `updateDecisionMetadata` write that produces a non-empty diff emits one audit-trail entry via OpenRegister's existing immutable subsystem (ADR-022) — per-field previous → new values, actor UID (per ADR-005, never the display name), timestamp, and row identifier. Semantic no-ops (PATCH whose values match the current row state, or PATCH with body `{}`) MUST NOT write an audit entry. Reads MUST NOT produce audit entries. +- **MODIFIED** Anonymise flow honours `skipAnonymization`. Both `FileTextController::anonymizeFile` (HTTP) and `FileService::anonymizeDocument` (DI) MUST filter out relations whose `skipAnonymization` is `true` before running text-replacement. `EntityRelationMapper::markAsAnonymized` MUST NOT flip `anonymized=true` on skipped rows. Skipped rows retain `anonymized=false`; the operator decision is preserved and queryable via the `skipAnonymization` flag. +- **UNCHANGED** OpenAnonymiser integration. `EntityRecognitionHandler::detectWithOpenAnonymiser` is the only place OpenAnonymiser is called (during detection), and this change does not touch it. `bases` and `skipAnonymization` are decision metadata applied between detection and anonymise. +- **UNCHANGED** `markAsAnonymized`'s role as the path that writes `anonymized=true` / `anonymizedValue` on rows that *were* redacted. This change adds a filter (skip relations where `skipAnonymization=true`) but does not change which path owns those fields. + +### Out of scope + +- A full REST surface on entity-relations (`GET /api/entity-relations`, list/show, `DELETE`). The PATCH endpoint is the minimum needed for this change; further verbs can be added under a separate change if a use case appears. +- A batch PATCH endpoint (`PATCH /api/entity-relations` with `entries[]`). DocuDesk loops if it needs to update decision metadata on multiple relations; a real volume-driven use case can prompt a follow-up batch surface. +- Letting operators edit `anonymized` or `anonymizedValue` directly via the new PATCH endpoint. Those fields record what the redaction *did*; only the redaction code path may write them. The whitelist is decision-only by design. +- Validating that `bases` UUIDs resolve to known `base` objects. Consumer-app concern (see design D2). +- The DocuDesk-side adjustment to call the new PATCH endpoint instead of riding `bases` on its anonymise call. Tracked in the paired DocuDesk change `anonymisation-grondslagen-and-prohibition-gate` (the DD spec ships before this OR rework lands and will need a parallel amendment; flagged for that change's apply phase). ## Capabilities ### New Capabilities -- `entity-relation-grondslagen`: optional bases-link on `EntityRelation`; the anonymise endpoint's contract for accepting, persisting, and stripping per-entity bases. +- `entity-relation-grondslagen`: optional bases-link on `EntityRelation`, an operator-decision skip-flag, and an audited per-relation PATCH endpoint + parallel DI mapper method exposing those two decision fields under a strict whitelist. Per-relation storage gives per-position granularity — operators *can* make different decisions for different occurrences of the same entity in the same file if their UX surfaces that (DocuDesk's review UI typically aggregates at entity level for ergonomic reasons; the OR surface preserves the finer granularity for any consumer that wants it). ### Modified Capabilities -(none — the broader entity-recognition / anonymisation pipeline is implemented but currently uncovered by an OpenSpec capability; this change does not retroactively spec it. See `Out of scope` in design.md.) +(none — the broader entity-recognition / anonymisation pipeline is implemented but currently uncovered by an OpenSpec capability; this change does not retroactively spec it.) + +## Cross-app Dependencies + +- **Hard** — `docudesk:anonymisation-grondslagen-and-prohibition-gate` (consumer). The DD prohibition-gate change describes attaching bases via the anonymise endpoint payload — that DD spec needs amending in lock-step with this OR rework so the contracts agree. Apply ordering: this OR change applies first (specs + implementation), then the DD spec is amended, then the DD prohibition-gate change applies against the new contract. +- **Soft** — `docudesk:add-dossier-schema` (already merged). Provides the `base` register that supplies the UUIDs DocuDesk callers will send. Independent — both can land in any order. ## Impact - **Code (openregister):** - - `lib/Db/EntityRelation.php` — new `bases` field (JSON, nullable, default null); getter/setter via Nextcloud's Entity base class pattern. - - `lib/Db/EntityRelationMapper.php` — persistence handles the new column. - - Migration class under `lib/Migration/` — adds the column. Idempotent; safe on existing installs. - - `lib/Service/FileService.php` (or the equivalent path that today calls OpenAnonymiser) — accept `bases` per entity, persist on EntityRelation, strip before forwarding. -- **API contract:** Anonymise endpoint payload gains an optional `bases` field per entity entry. Additive, non-breaking. Existing callers (and OpenAnonymiser) see no change. + - `lib/Db/EntityRelation.php` — new `bases` property (JSON, nullable, default null) and `skipAnonymization` property (boolean, default false); `addType` registrations; magic-method getter/setter docblocks; `jsonSerialize()` includes both after `anonymizedValue`. + - `lib/Db/EntityRelationMapper.php` — new method `updateDecisionMetadata(int $id, array $fields): EntityRelation` (implements whitelist enforcement, shape validation, audit-trail emission, single transactional write); `markAsAnonymized` updated to skip rows with `skip_anonymization=true`. + - `lib/Controller/EntityRelationsController.php` — NEW controller. Single method (PATCH) for now; structured to host future GET/show without renaming. + - `lib/Controller/FileTextController.php` — `anonymizeFile` filters out skipped relations before building the replacements list. + - `lib/Service/FileService.php` / `lib/Service/File/DocumentProcessingHandler.php` — the DI `anonymizeDocument` path also honours `skipAnonymization` when given a payload that joins with persisted state (the caller-passed `entities[]` array is filtered server-side against the persisted skip flag). + - `appinfo/routes.php` — add the PATCH route under `entityRelations#update`. + - `lib/Migration/Version1Date20260512.php` — adds the `bases` and `skip_anonymization` columns. Idempotent. +- **API contract:** One new HTTP endpoint (`PATCH /api/entity-relations/{id}`). The existing anonymise endpoint (`POST /api/files/:fileId/anonymize`) keeps its shape but its behaviour changes: rows where `skip_anonymization=true` are filtered out before text-replacement runs. +- **Database:** Two columns added to `oc_openregister_entity_relations`. Migration is forward-only and zero-downtime. +- **Audit trail:** Every successful PATCH (HTTP or DI) with a non-empty diff writes one audit entry summarising changed fields (`bases`, `skipAnonymization`), with previous and new values, actor UID, timestamp, and the row identifier. Semantic no-ops do not write audit entries. Reads do not produce audit entries. +- **Authorization:** PATCH requires write-access to the relation's parent file/object — same implicit check that `markAsAnonymized` inherits today. Admin role MUST NOT be required. ADR-005 + ADR-023 anchor: no extra action-level permission is added in this change; if a future change wants per-field action authz, it MUST add a new Requirement here. - **Cross-app:** - - **DocuDesk** is the immediate consumer; the paired change `anonymisation-grondslagen-and-prohibition-gate` in DocuDesk relies on this work landing. - - **opencatalogi** and **softwarecatalog** do not call the anonymise endpoint; unaffected. - - The `base` vocabulary itself lives in DocuDesk (per the in-flight `add-dossier-schema` change). OpenRegister does not own or validate that vocabulary. -- **Database:** One column added to one table. Migration is forward-only and zero-downtime. -- **Tests:** Mapper unit tests for the new column. Service-level tests for the persist + strip path. + - **DocuDesk** is the immediate consumer. The paired change `anonymisation-grondslagen-and-prohibition-gate` in DocuDesk currently expects to ride bases on the anonymise call; that DD spec needs amending alongside this rework. + - **opencatalogi** and **softwarecatalog** do not call entity-relation endpoints; unaffected. +- **Tests:** Mapper unit tests for the new columns + the `updateDecisionMetadata` method (whitelist, shape, semantic-no-op behaviour, audit emission). Controller tests for PATCH (HTTP shape, authorization, whitelist rejection). Anonymise-flow regression tests for the skip filter (relations with skip=true are not redacted; `markAsAnonymized` does not flip them). Migration smoke test. \ No newline at end of file diff --git a/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md b/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md index b3c5af69e575..64e5c8289962 100644 --- a/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md +++ b/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md @@ -6,7 +6,7 @@ status: draft ## Purpose -Defines an optional `bases` link on `EntityRelation` and the contract by which the anonymise endpoint accepts, persists, and strips per-entity legal bases (grondslagen). The link is consumer-app-agnostic — OpenRegister stores the array of UUIDs verbatim and does not validate that they resolve to real `base` objects (the vocabulary lives in the consumer app). Writes are audit-logged and inherit the anonymise endpoint's existing authorization model. +Defines two new operator-decision fields on `EntityRelation` (`bases` — legal grondslagen for redaction; `skipAnonymization` — opt-out from redaction) and an audited write path for them: a new `PATCH /api/entity-relations/{id}` HTTP endpoint backed by an `EntityRelationMapper::updateDecisionMetadata` DI method. The fields are per-relation (per-position) — operators may make different decisions for different occurrences of the same entity within a file if their UX surfaces that granularity. The anonymise flow honours `skipAnonymization`: skipped rows are not redacted and retain `anonymized=false`. `bases` is consumer-vocabulary metadata — OpenRegister stores the UUIDs verbatim and does not validate that they resolve. Writes are audit-logged; the PATCH endpoint inherits the relation's parent file/object write-access check. ## ADDED Requirements @@ -14,241 +14,370 @@ Defines an optional `bases` link on `EntityRelation` and the contract by which t The `oc_openregister_entity_relations` table MUST gain a column named `bases` of type JSON (or the platform-equivalent JSON column type), nullable, with default `NULL`. The column MUST hold either `NULL`, an empty array `[]`, or an array of strings (UUIDs). No JSON-schema validation of the array contents is enforced at the database or mapper layer. -The `EntityRelation` PHP entity (`lib/Db/EntityRelation.php`) MUST expose `getBases(): ?array` and `setBases(?array $bases): void`, registered via `addType('bases', 'json')` in the constructor. Existing rows (pre-migration) MUST read as `bases = null` without errors. +The `EntityRelation` PHP entity (`lib/Db/EntityRelation.php`) MUST expose `getBases(): ?array` and `setBases(?array $bases): void`, registered via `addType('bases', 'json')` in the constructor. `jsonSerialize()` MUST include `bases` in its output. Existing rows (pre-migration) MUST read as `bases = null` without errors. -#### Scenario: Migration adds the column without disturbing existing rows +#### Scenario: Migration adds the bases column without disturbing existing rows - **GIVEN** an OpenRegister install with existing `EntityRelation` rows - **WHEN** the migration is applied - **THEN** the `bases` column MUST be added to `oc_openregister_entity_relations` - **AND** every existing row MUST read with `bases = null` via `EntityRelation::getBases()` -- **AND** no other columns or rows MUST be modified - -#### Scenario: Migration is idempotent - -- **GIVEN** the migration has already been applied -- **WHEN** the migration runs again (e.g. on upgrade after a previous deploy) -- **THEN** the migration MUST be a no-op -- **AND** no error MUST be raised +- **AND** no other columns or rows MUST be modified beyond those added by this change #### Scenario: Mapper reads and writes bases -- **GIVEN** an `EntityRelation` row with `bases = ["uuid-a", "uuid-b"]` written via the mapper +- **GIVEN** an `EntityRelation` row written with `bases = ["uuid-a", "uuid-b"]` - **WHEN** the row is read back via `EntityRelationMapper::find($id)` - **THEN** `getBases()` MUST return the array `["uuid-a", "uuid-b"]` - **AND** `jsonSerialize()` MUST include `bases` in its output -#### Scenario: Empty array is accepted and distinct from null +#### Scenario: Empty bases array is accepted and distinct from null -- **WHEN** `setBases([])` is called and the row is persisted +- **WHEN** the row is persisted with `bases = []` - **THEN** subsequent reads MUST return `bases = []` (an empty array, not null) - **AND** `jsonSerialize()['bases']` MUST be `[]` -### Requirement: The anonymise endpoint MUST accept per-entity `bases` in the request payload +### Requirement: `EntityRelation` MUST gain a boolean `skip_anonymization` column + +The `oc_openregister_entity_relations` table MUST gain a column named `skip_anonymization` of type BOOLEAN, NOT NULL, default `false`. + +The `EntityRelation` PHP entity MUST expose `getSkipAnonymization(): bool` and `setSkipAnonymization(bool $skip): void`, registered via `addType('skipAnonymization', 'boolean')` in the constructor. `jsonSerialize()` MUST include `skipAnonymization` in its output. Existing rows (pre-migration) MUST read as `skipAnonymization = false`. + +#### Scenario: Migration adds the skip_anonymization column with default false + +- **GIVEN** an OpenRegister install with existing `EntityRelation` rows +- **WHEN** the migration is applied +- **THEN** the `skip_anonymization` column MUST be added with default `false` +- **AND** every existing row MUST read with `skipAnonymization = false` via `EntityRelation::getSkipAnonymization()` + +#### Scenario: Migration is idempotent across both new columns + +- **GIVEN** the migration has already been applied +- **WHEN** the migration runs again (e.g. on upgrade after a previous deploy) +- **THEN** the migration MUST be a no-op +- **AND** no error MUST be raised + +### Requirement: A `PATCH /api/entity-relations/{id}` endpoint MUST exist with a decision-only field whitelist + +The system MUST expose `PATCH /api/entity-relations/{id}` accepting a JSON body whose top-level keys MUST be a subset of `{ "bases", "skipAnonymization" }`. Any other top-level key — including the system-controlled fields `anonymized` and `anonymizedValue`, and any structural field (`entityId`, `chunkId`, `fileId`, `objectId`, `emailId`, `positionStart`, `positionEnd`, `confidence`, `detectionMethod`, `context`, `registerId`, `schemaId`, `objectUuid`, `createdAt`) — MUST be rejected with HTTP 400 and an error body identifying the offending field name (e.g. `{ "error": "field_not_editable", "field": "anonymized" }`). + +The endpoint MUST be `@NoAdminRequired`. Authorization is governed by the separate Requirement on file/object write-access (below). + +A successful PATCH MUST return HTTP 200 with the updated `EntityRelation` row in `jsonSerialize()` shape. PATCH on a non-existent `{id}` MUST return HTTP 404. + +The HTTP endpoint MUST be a thin wrapper over `EntityRelationMapper::updateDecisionMetadata` — there MUST be no duplicated whitelist, shape-validation, or audit-trail logic at the controller layer. + +#### Scenario: PATCH with `bases` updates the row and returns 200 + +- **GIVEN** an EntityRelation row with id `42` and `bases: null` +- **WHEN** an authorized caller PATCHes `/api/entity-relations/42` with body `{ "bases": ["uuid-a"] }` +- **THEN** the response MUST be HTTP 200 +- **AND** the response body MUST include `bases = ["uuid-a"]` +- **AND** subsequent reads MUST return `bases = ["uuid-a"]` + +#### Scenario: PATCH with `skipAnonymization: true` flips the flag + +- **GIVEN** an EntityRelation row with id `42` and `skipAnonymization: false` +- **WHEN** an authorized caller PATCHes `/api/entity-relations/42` with body `{ "skipAnonymization": true }` +- **THEN** the response MUST be HTTP 200 +- **AND** subsequent reads MUST return `skipAnonymization = true` + +#### Scenario: PATCH with both whitelist fields updates both + +- **GIVEN** an EntityRelation row with id `42` and `bases: null`, `skipAnonymization: false` +- **WHEN** an authorized caller PATCHes `/api/entity-relations/42` with body `{ "bases": ["uuid-a"], "skipAnonymization": true }` +- **THEN** the response MUST be HTTP 200 +- **AND** the row MUST have `bases = ["uuid-a"]` AND `skipAnonymization = true` + +#### Scenario: PATCH targeting `anonymized` is rejected + +- **GIVEN** any EntityRelation row +- **WHEN** the caller PATCHes with body `{ "anonymized": true }` +- **THEN** the response MUST be HTTP 400 +- **AND** the error body MUST identify `anonymized` as the offending field +- **AND** the row MUST NOT be modified +- **AND** no audit entry MUST be written + +#### Scenario: PATCH targeting `anonymizedValue` is rejected + +- **WHEN** the caller PATCHes with body `{ "anonymizedValue": "tampered" }` +- **THEN** the response MUST be HTTP 400 +- **AND** the row MUST NOT be modified + +#### Scenario: PATCH targeting a structural field is rejected -The anonymise endpoint (currently `FileService::anonymizeDocument(node, payload)` and the controller routes that wrap it) MUST accept an optional `bases` field on each entry in `payload.entities[]`. The field MUST be either absent, `null`, or an array of strings (see also the endpoint-shape-validation Requirement below). The field's presence MUST NOT change any existing behaviour for callers that omit it. +- **WHEN** the caller PATCHes with body `{ "entityId": 99 }` +- **THEN** the response MUST be HTTP 400 +- **AND** the error body MUST identify `entityId` as the offending field + +#### Scenario: Whitelist rejection is atomic — no partial application + +- **WHEN** the caller PATCHes with body `{ "bases": ["uuid-a"], "entityId": 99 }` +- **THEN** the response MUST be HTTP 400 +- **AND** the row's `bases` MUST NOT be modified + +#### Scenario: PATCH on a non-existent relation returns 404 + +- **GIVEN** there is no EntityRelation with id `999` +- **WHEN** the caller PATCHes `/api/entity-relations/999` with `{ "bases": ["uuid-a"] }` +- **THEN** the response MUST be HTTP 404 + +### Requirement: `EntityRelationMapper::updateDecisionMetadata` MUST be the single audited write path for the whitelist fields + +The mapper MUST expose `updateDecisionMetadata(int $id, array $fields, ?IUser $actingUser = null): EntityRelation`. The method MUST: + +1. Resolve the row by `$id`; throw `DoesNotExistException` if missing. +2. Enforce the whitelist (`bases`, `skipAnonymization`); throw a typed validation exception for any unknown field name. +3. Validate the shape of each present field (`bases` MUST be `null` or an array of strings; `skipAnonymization` MUST be a boolean); throw a typed validation exception on shape mismatch. +4. Compute the diff against the current row state. +5. If the diff is empty (no field actually changes value), the method MUST return the row unmodified and MUST NOT write an audit entry. +6. Otherwise, apply the changed fields, persist via the underlying QBMapper, AND write an audit-trail entry — both MUST be committed transactionally (or use the same failure-handling mode the existing audit-traced mapper writes use today). -#### Scenario: Anonymise call without bases preserves today's behaviour +The HTTP `PATCH /api/entity-relations/{id}` controller and in-process DI callers MUST both call through this method. There MUST NOT be a parallel write path for `bases` or `skipAnonymization` that bypasses it. -- **GIVEN** a request payload with entities that have no `bases` field -- **WHEN** the anonymise endpoint processes the request -- **THEN** the matching `EntityRelation` rows MUST be written with `bases = null` -- **AND** the request forwarded to OpenAnonymiser MUST contain exactly the same fields it would have contained before this change +#### Scenario: HTTP and DI callers see identical behaviour -#### Scenario: Anonymise call with bases populates EntityRelation +- **GIVEN** an EntityRelation row with `bases: null` +- **WHEN** caller A PATCHes via HTTP with `{ "bases": ["uuid-a"] }` +- **AND** caller B (after A) updates via DI: `$mapper->updateDecisionMetadata(42, ['bases' => ['uuid-b']])` +- **THEN** both calls MUST succeed +- **AND** each call MUST produce one audit-trail entry +- **AND** the final row state MUST be `bases = ["uuid-b"]` -- **GIVEN** a request payload with `entities: [{entityId: 42, bases: ["uuid-a"]}, {entityId: 43, bases: ["uuid-b", "uuid-c"]}]` -- **WHEN** the anonymise endpoint processes the request -- **THEN** the EntityRelation row for entity 42 MUST have `bases = ["uuid-a"]` -- **AND** the EntityRelation row for entity 43 MUST have `bases = ["uuid-b", "uuid-c"]` +#### Scenario: A semantic-no-op PATCH produces no audit entry -#### Scenario: Bases field with empty array writes empty array +- **GIVEN** an EntityRelation row with `bases: ["uuid-a"]` and `skipAnonymization: false` +- **WHEN** the caller PATCHes with body `{ "bases": ["uuid-a"], "skipAnonymization": false }` (values identical to current) +- **THEN** the response MUST be HTTP 200 +- **AND** the returned row MUST be unchanged +- **AND** NO audit-trail entry MUST be written -- **GIVEN** a payload entry with `bases: []` -- **WHEN** the anonymise endpoint processes it -- **THEN** the matching EntityRelation row MUST have `bases = []` (empty array, not null) +#### Scenario: An empty PATCH body produces no audit entry -### Requirement: The anonymise endpoint MUST validate the SHAPE of `bases` at the entry point but MUST NOT validate its CONTENT +- **GIVEN** any EntityRelation row +- **WHEN** the caller PATCHes with body `{}` +- **THEN** the response MUST be HTTP 200 +- **AND** NO audit-trail entry MUST be written -At the endpoint layer (controller / `FileService::anonymizeDocument`), the `bases` field on each entry of `payload.entities[]` MUST be one of: +### Requirement: PATCH MUST validate the SHAPE of `bases` and `skipAnonymization` at the entry point but MUST NOT validate `bases` content -- absent, -- `null`, +When `bases` is present in the PATCH body, the field MUST be: + +- `null`, OR - an array whose every element is a string. -Any other shape — a non-array value (e.g. a number, an object, a single string), or an array containing non-string elements — MUST be rejected with an HTTP 400 response. The 400 response body MUST identify the offending entry by index so the caller can fix the right entry in a multi-entity payload. +Any other shape — a non-array value (e.g. a number, an object, a single string), or an array containing non-string elements — MUST be rejected with HTTP 400. The error body MUST identify the offending shape (e.g. `{ "error": "invalid_bases_shape", "reason": "must be null or array of strings" }`). + +When `skipAnonymization` is present, it MUST be a boolean. Any other type MUST be rejected with HTTP 400. -At the mapper layer, no further validation MUST be applied: the elements of the `bases` array MUST be persisted verbatim regardless of their content (UUID-shaped, garbage strings, or empty strings). This two-layer contract exists deliberately — endpoint validation rejects ill-typed input early, while the mapper remains content-agnostic so the consumer-app's vocabulary can evolve without OR changes. +The mapper MUST NOT apply any further validation to the string content of the `bases` array. The elements MUST be persisted verbatim regardless of whether they look like UUIDs, are well-formed, or resolve to any known `base` object. This is the deliberate content-agnostic contract; consumer apps own the vocabulary. -#### Scenario: Endpoint rejects `bases` as a non-array +#### Scenario: PATCH rejects `bases` as a non-array -- **GIVEN** a payload entry with `bases: "uuid-a"` (a string, not an array) -- **WHEN** the anonymise endpoint processes the request +- **WHEN** the caller PATCHes with body `{ "bases": "uuid-a" }` - **THEN** the response MUST be HTTP 400 -- **AND** no EntityRelation row MUST be modified +- **AND** the row MUST NOT be modified -#### Scenario: Endpoint rejects array elements that are not strings +#### Scenario: PATCH rejects array elements that are not strings -- **GIVEN** a payload entry at index 1 with `bases: ["uuid-a", 42]` -- **WHEN** the anonymise endpoint processes the request +- **WHEN** the caller PATCHes with body `{ "bases": ["uuid-a", 42] }` - **THEN** the response MUST be HTTP 400 -- **AND** the error body MUST identify entity index `1` as the offending entry -#### Scenario: Mapper accepts any string content +#### Scenario: PATCH rejects `skipAnonymization` as a non-boolean -- **GIVEN** a validated payload with `bases: ["not-a-uuid", "12345", ""]` -- **WHEN** the endpoint forwards the payload to the mapper layer -- **THEN** the row MUST be persisted with the values verbatim -- **AND** no error MUST be raised +- **WHEN** the caller PATCHes with body `{ "skipAnonymization": "yes" }` +- **THEN** the response MUST be HTTP 400 -### Requirement: `bases` writes MUST inherit the anonymise endpoint's existing authorization (ADR-005 / ADR-023) +#### Scenario: Mapper accepts any string content in bases -The anonymise endpoint already enforces a per-object authorization check (the caller MUST have write access to the file/object being anonymised). Setting `bases` MUST require no additional authorization beyond that check — `bases` is metadata attached to an existing anonymisation operation that the caller is already authorized to perform. There MUST be no separate group, role, or action-level permission for `bases` writes in this change. +- **GIVEN** a validated PATCH body `{ "bases": ["not-a-uuid", "12345", ""] }` +- **WHEN** the mapper writes the row +- **THEN** the row MUST be persisted with the values verbatim +- **AND** no error MUST be raised -A caller who cannot anonymise a given object MUST NOT be able to set `bases` on its EntityRelation rows, because the persist step (next Requirement) runs only after the endpoint's existing authorization has passed. A caller who CAN anonymise the object MUST be able to set arbitrary `bases` strings as part of that operation. +### Requirement: PATCH MUST require write-access to the relation's parent file/object (ADR-005 / ADR-023) -This decision is recorded explicitly so reviewers and implementers can reason about the authorization surface: there is intentionally NO extra check, and that absence is the intended contract — not an oversight. If a future change introduces a separate action-level permission for `bases` (per ADR-023), it MUST add a new Requirement here. +The endpoint MUST require that the acting user can write the file or object the relation points at. The check MUST resolve in this order: -#### Scenario: Unauthorized caller cannot anonymise and therefore cannot set bases +1. If the relation has `fileId` set — the acting user MUST be able to write the file (same check `FileTextController::anonymizeFile` implicitly inherits today). +2. Else if the relation has `objectId` (with `registerId` + `schemaId` for disambiguation) — the acting user MUST be able to update the underlying object. +3. Else if the relation has `emailId` — the email MUST be accessible (writeable) to the acting user. +4. Otherwise the PATCH MUST be denied with HTTP 403. -- **GIVEN** a user without write access to file `F` -- **WHEN** the user POSTs an anonymise request for `F` with `bases` populated -- **THEN** the existing endpoint authorization check MUST fail and the request MUST be rejected (HTTP 403) -- **AND** no EntityRelation row for `F` MUST be modified -- **AND** no bases value MUST be persisted +An unauthenticated session MUST receive HTTP 401 (Nextcloud's session-required path), not 403. -#### Scenario: Authorized caller can set bases as part of anonymisation +The endpoint MUST NOT require the admin role. The endpoint MUST NOT introduce a separate action-level permission for editing the decision fields (per ADR-023, action-level permissions are opt-in; the absence here is deliberate). If a future change introduces such a permission, it MUST add a new Requirement here. -- **GIVEN** a user with write access to file `F` -- **WHEN** the user POSTs an anonymise request for `F` with `bases: ["uuid-a"]` -- **THEN** the request MUST succeed -- **AND** the EntityRelation row's `bases` value MUST be `["uuid-a"]` +#### Scenario: User without write-access to the parent file is rejected -### Requirement: The anonymise endpoint MUST persist bases BEFORE forwarding to OpenAnonymiser +- **GIVEN** an EntityRelation row with `fileId: F` and an authenticated user `bob` with no write-access to `F` +- **WHEN** `bob` PATCHes the relation with `{ "bases": ["uuid-a"] }` +- **THEN** the response MUST be HTTP 403 +- **AND** the row MUST NOT be modified +- **AND** no audit-trail entry MUST be written -The order of operations in the anonymise endpoint MUST be: (1) for each entry, find or upsert the `EntityRelation` row writing the existing fields (`anonymized`, `anonymizedValue`, etc.) plus `bases`; then (2) construct the request to OpenAnonymiser with `bases` stripped from each entry; then (3) forward to OpenAnonymiser. Persistence MUST NOT be conditional on the OpenAnonymiser call succeeding. +#### Scenario: Authorized user can PATCH -#### Scenario: Persist precedes the OpenAnonymiser call +- **GIVEN** an EntityRelation row with `fileId: F` and user `alice` with write-access to `F` +- **WHEN** `alice` PATCHes the relation with `{ "skipAnonymization": true }` +- **THEN** the response MUST be HTTP 200 +- **AND** the row's `skipAnonymization` MUST be `true` -- **GIVEN** a successful anonymise request with bases populated -- **WHEN** the endpoint runs -- **THEN** the EntityRelation rows MUST be written before the HTTP call to OpenAnonymiser is issued -- **AND** the persist write MUST include the bases values +#### Scenario: Unauthenticated request is rejected with 401 -#### Scenario: Persist survives an OpenAnonymiser failure +- **GIVEN** no authenticated session +- **WHEN** a client PATCHes `/api/entity-relations/42` +- **THEN** the response MUST be HTTP 401 -- **GIVEN** a request whose OpenAnonymiser call fails (network timeout, 500 response) -- **WHEN** the endpoint processes the request -- **THEN** the EntityRelation rows MUST have been written with `bases` populated -- **AND** the rows MUST have `anonymized = false` (or the existing pre-change semantics for failed redaction) +### Requirement: Successful PATCH writes MUST be recorded in OpenRegister's audit trail (ADR-022 / Woo compliance) -### Requirement: `bases` writes MUST be recorded in OpenRegister's audit trail (ADR-022 / Woo compliance) +Every successful `updateDecisionMetadata` write that produces a non-empty diff MUST emit one audit-trail entry through OpenRegister's existing immutable-audit-trail subsystem. The entry MUST include: -Every mutation of an `EntityRelation` row that sets or changes the `bases` value MUST produce an entry in the OpenRegister audit trail. The audit entry MUST include the actor (Nextcloud user UID — per ADR-005, never the display name), the timestamp, the row's stable identifier, and both the previous and new `bases` values. Reads of `EntityRelation` rows MUST NOT produce audit entries. +- `actor` — the acting user's Nextcloud UID (per ADR-005, the UID, NOT the display name). +- `timestamp` — an ISO-8601 datetime. +- `subjectType` — the table or canonical entity type (`openregister_entity_relations` or equivalent OR convention). +- `subjectId` — the row identifier. +- `changedFields` — an object whose keys are the whitelist fields that actually changed (subset of `bases`, `skipAnonymization`) and whose values are `{ "previous": , "new": }`. Fields that were submitted but already held the new value MUST NOT appear. -The audit entry MUST be written through OpenRegister's existing immutable-audit-trail subsystem (the same one that records other `EntityRelation` mutations), not by direct mapper writes that bypass audit. This is the load-bearing compliance requirement of the change — without it, a Woo officer cannot reconstruct which grondslag justified a given redaction, defeating the feature's stated purpose. +Reads of `EntityRelation` rows — via `EntityRelationMapper::find`, `findEntitiesForFile`, `findByEntityId`, `findByFileId`, or any other read API — MUST NOT produce audit-trail entries. #### Scenario: Setting bases for the first time produces an audit entry -- **GIVEN** a request that sets `bases: ["uuid-a"]` on a new EntityRelation row (no prior value) -- **WHEN** the row is persisted -- **THEN** an audit-trail entry MUST exist for that row referencing the action (e.g. `entity_relation_bases_set` or OR's equivalent), the acting user's UID, an ISO-8601 timestamp, the row's identifier, `previousBases: null`, and `newBases: ["uuid-a"]` +- **GIVEN** an EntityRelation row with `bases: null` +- **WHEN** an authorized caller PATCHes `{ "bases": ["uuid-a"] }` +- **THEN** an audit-trail entry MUST be written with the acting user UID, an ISO-8601 timestamp, the row identifier +- **AND** `changedFields.bases` MUST be `{ "previous": null, "new": ["uuid-a"] }` -#### Scenario: Updating bases produces an audit entry with old + new values +#### Scenario: Flipping skip produces an audit entry -- **GIVEN** an EntityRelation row with `bases: ["uuid-a"]` -- **WHEN** a subsequent anonymise call sets `bases: ["uuid-a", "uuid-b"]` -- **THEN** an audit-trail entry MUST be written with `previousBases: ["uuid-a"]` and `newBases: ["uuid-a", "uuid-b"]` +- **GIVEN** an EntityRelation row with `skipAnonymization: false` +- **WHEN** an authorized caller PATCHes `{ "skipAnonymization": true }` +- **THEN** the audit-trail entry MUST record `changedFields.skipAnonymization = { "previous": false, "new": true }` #### Scenario: Reads do not produce audit entries -- **WHEN** an `EntityRelation` row with non-null `bases` is read via `EntityRelationMapper::find` or `findEntitiesForFile` +- **WHEN** an `EntityRelation` row is read via `EntityRelationMapper::find` or `findEntitiesForFile` - **THEN** no audit-trail entry MUST be produced for the read -### Requirement: A retry that omits `bases` MUST reuse the persisted values +### Requirement: PATCH MUST follow standard partial-update semantics -When the anonymise endpoint receives a retry request where `bases` is absent from one or more entries that previously had `bases` persisted (i.e. the EntityRelation row already exists with non-null `bases`), the endpoint MUST NOT overwrite the persisted values. The retry MUST proceed with the OpenAnonymiser call using the persisted `bases` for downstream behaviour (audit trail, consumer-app summary rendering), without requiring the caller to resupply `bases`. +For each whitelist field, the body shapes behave as follows: -A retry that DOES include `bases` MUST overwrite the persisted values; the resulting audit entry MUST record the previous-vs-new transition per the audit-trail Requirement. The endpoint MUST distinguish three caller intents: +| `bases` | Effect | Audit? | +|---|---|---| +| absent | unchanged | no | +| `null` | set to `null` (clear) | yes, only if previous wasn't already null | +| `[]` | set to `[]` (distinct from null) | yes, only if previous wasn't already `[]` | +| `["..."]` | set to the array | yes, only if previous differs | -- field **absent** → reuse persisted value (no audit entry for `bases` field) -- field **present and `null`** → set to `null` (explicit clear, audit-logged) -- field **present and `[]`** → set to `[]` (explicit empty, audit-logged) +| `skipAnonymization` | Effect | Audit? | +|---|---|---| +| absent | unchanged | no | +| `true` | set to `true` | yes, only if previous was `false` | +| `false` | set to `false` | yes, only if previous was `true` | -This contract lets DocuDesk's `anonymisation-grondslagen-and-prohibition-gate` issue retries after a gate-fail without re-prompting the operator for grondslagen. +A retry that omits a field does not touch the persisted value — supports retry-by-omission cleanly. -#### Scenario: Retry without `bases` preserves the persisted value +#### Scenario: PATCH that omits `bases` preserves the persisted value -- **GIVEN** an EntityRelation row with `bases: ["uuid-a"]` and `anonymized: false` (previous OpenAnonymiser call failed) -- **WHEN** a retry request arrives for the same entity with no `bases` field in the payload -- **THEN** the EntityRelation row's `bases` MUST remain `["uuid-a"]` (unchanged) -- **AND** the retry MUST proceed with the OpenAnonymiser call using the persisted bases -- **AND** on success the row MUST transition to `anonymized: true` with `bases` unchanged -- **AND** no audit-trail entry MUST be produced specifically for the `bases` field (other audit entries for the anonymised-flag transition follow existing OR semantics and are out of scope of this Requirement) +- **GIVEN** an EntityRelation row with `bases: ["uuid-a"]` +- **WHEN** an authorized caller PATCHes `{ "skipAnonymization": true }` (omitting `bases`) +- **THEN** the row's `bases` MUST remain `["uuid-a"]` +- **AND** the audit-trail entry MUST record `skipAnonymization` only — `bases` MUST NOT appear in `changedFields` -#### Scenario: Retry with new `bases` overwrites the persisted value +#### Scenario: Explicit `bases: null` clears the persisted value - **GIVEN** an EntityRelation row with `bases: ["uuid-a"]` -- **WHEN** a retry request arrives for the same entity with `bases: ["uuid-b"]` -- **THEN** the EntityRelation row's `bases` MUST be updated to `["uuid-b"]` -- **AND** an audit-trail entry MUST record the transition (`previousBases: ["uuid-a"]`, `newBases: ["uuid-b"]`) +- **WHEN** an authorized caller PATCHes `{ "bases": null }` +- **THEN** the row's `bases` MUST be `null` +- **AND** `changedFields.bases` MUST be `{ "previous": ["uuid-a"], "new": null }` -#### Scenario: Retry with explicit `bases: null` clears the persisted value +#### Scenario: Explicit `bases: []` sets empty array - **GIVEN** an EntityRelation row with `bases: ["uuid-a"]` -- **WHEN** a retry request arrives with `bases: null` -- **THEN** the EntityRelation row's `bases` MUST be set to `null` -- **AND** the transition MUST be audit-logged (`previousBases: ["uuid-a"]`, `newBases: null`) +- **WHEN** an authorized caller PATCHes `{ "bases": [] }` +- **THEN** the row's `bases` MUST be `[]` (empty array, not null) + +### Requirement: The anonymise flow MUST honour `skipAnonymization` + +The system MUST filter out relations where `skip_anonymization = true` from both anonymise paths: + +1. **HTTP path** (`POST /api/files/:fileId/anonymize` → `FileTextController::anonymizeFile`): the relations returned for text-replacement MUST exclude rows where `skip_anonymization = true`. `EntityRelationMapper::markAsAnonymized($fileId, ...)` MUST update only rows where `skip_anonymization = false` — skipped rows MUST retain `anonymized = false`. + +2. **DI path** (`FileService::anonymizeDocument(Node, entities[])`): regardless of what entities the caller passes, the OR-side service MUST consult the persisted `skip_anonymization` state per entity-relation and filter out skipped rows before calling `DocumentProcessingHandler::anonymizeDocument`. Defensive filtering inside OR — the contract is "skipped relations are never redacted, full stop", regardless of caller behaviour. + +#### Scenario: HTTP anonymise skips relations flagged with skipAnonymization + +- **GIVEN** a file `F` with three EntityRelation rows: R1 (`skip=false`), R2 (`skip=true`), R3 (`skip=false`) +- **WHEN** an authorized caller POSTs `/api/files/F/anonymize` +- **THEN** the response MUST be HTTP 200 and the redacted file MUST contain R1's and R3's placeholders but NOT R2's +- **AND** R1's and R3's rows MUST have `anonymized = true` +- **AND** R2's row MUST have `anonymized = false` +- **AND** R2's `skipAnonymization = true` MUST be unchanged -### Requirement: The anonymise endpoint MUST strip `bases` from the payload before forwarding to OpenAnonymiser +#### Scenario: DI anonymise filters skipped rows even when the caller includes them -Before issuing the HTTP call to OpenAnonymiser, the service MUST construct a copy of the entity list with the `bases` field removed from every entry. The OpenAnonymiser request body MUST be byte-equivalent to what it would have been before this change (modulo any other unrelated field reorderings introduced by the JSON encoder). +- **GIVEN** a file `F` with relations R1 (`skip=false`) and R2 (`skip=true`) +- **AND** a DI caller that includes both R1 and R2 in the `entities[]` array passed to `FileService::anonymizeDocument` +- **WHEN** the call runs +- **THEN** OR MUST filter R2 out server-side before text-replacement +- **AND** the resulting file MUST NOT include R2's placeholder +- **AND** R2's row MUST have `anonymized = false` -#### Scenario: OpenAnonymiser sees no `bases` field +#### Scenario: `markAsAnonymized` does not flip anonymized on skipped rows -- **GIVEN** a request payload with bases populated on every entry -- **WHEN** the anonymise endpoint forwards to OpenAnonymiser -- **THEN** the request body to OpenAnonymiser MUST contain no `bases` field on any entity entry -- **AND** all other fields (`text`, `entityType`, `score`, etc.) MUST be forwarded unchanged +- **GIVEN** a file `F` with relations R1 (`skip=false`) and R2 (`skip=true`) +- **WHEN** `EntityRelationMapper::markAsAnonymized($F, ...)` runs +- **THEN** R1 MUST have `anonymized = true` +- **AND** R2 MUST have `anonymized = false` -#### Scenario: Mixed payload — some entries with bases, some without +#### Scenario: Flipping skip to true after anonymise does not retroactively un-redact -- **GIVEN** a payload where entries 1, 3 have `bases` populated and entry 2 has none -- **WHEN** the endpoint forwards to OpenAnonymiser -- **THEN** the forwarded request MUST have no `bases` field on any of the three entries -- **AND** entries 1, 3 MUST still have their EntityRelation rows updated with the supplied bases +- **GIVEN** R1 has `anonymized = true` from a prior redaction pass +- **WHEN** an authorized caller PATCHes R1 with `{ "skipAnonymization": true }` +- **THEN** R1's `skipAnonymization` MUST be `true` +- **AND** R1's `anonymized` MUST remain `true` (the prior redaction is not undone) +- **AND** the audit-trail records the skip flip but no un-redact event is fabricated ### Requirement: OpenRegister MUST NOT validate that `bases` UUIDs resolve -The persistence layer accepts any string array. OpenRegister MUST NOT issue any cross-register lookup to verify that the supplied UUIDs correspond to actual objects in any register. The vocabulary that bases reference is owned by the consumer app (see Notes for the canonical DocuDesk `base` vocabulary). +The mapper accepts any string array; OpenRegister MUST NOT issue any cross-register lookup to verify that the supplied UUIDs correspond to actual `base` objects in any register. The vocabulary lives in the consumer app (see Notes for the canonical DocuDesk `base` vocabulary). #### Scenario: Unknown UUID strings are accepted -- **GIVEN** a payload with `bases: ["00000000-0000-0000-0000-000000000000"]` (a UUID that doesn't resolve to any object) +- **GIVEN** an authorized caller PATCHes `{ "bases": ["00000000-0000-0000-0000-000000000000"] }` (a UUID that doesn't resolve) - **WHEN** the endpoint processes the request - **THEN** the row MUST be persisted with the value verbatim - **AND** no error MUST be raised - **AND** no cross-register query MUST be issued -### Requirement: The change MUST be additive and non-breaking +### Requirement: The change MUST be additive in API shape; only anonymise behaviour gains a skip filter -Existing callers (and the OpenAnonymiser contract) MUST be unaffected when no `bases` field is present in any entry of the payload. No existing field is removed, renamed, or repurposed. No existing scenario in any other capability MUST be invalidated. +The existing API endpoints — `FileService::anonymizeDocument(Node, entities[])` (DI) and `POST /api/files/:fileId/anonymize` (HTTP) — MUST keep their existing parameters and response shape. They MUST NOT consume any new field on entity-payload entries (e.g. erroneous `bases` on payload entries MUST be silently ignored). `EntityRelationMapper::markAsAnonymized`'s signature MUST be unchanged; only its WHERE clause gains the `AND skip_anonymization = 0` predicate. -#### Scenario: Pre-change client continues to work +Existing rows (pre-migration) MUST continue to read with `bases = null` and `skipAnonymization = false`. OpenAnonymiser integration (`EntityRecognitionHandler::detectWithOpenAnonymiser`) MUST be unchanged. -- **GIVEN** a client that constructs anonymise payloads using the pre-change schema (no `bases` field anywhere) -- **WHEN** that client sends a request to the anonymise endpoint -- **THEN** the request MUST succeed with identical behaviour to before this change -- **AND** the resulting EntityRelation rows MUST have `bases = null` -- **AND** the OpenAnonymiser request body MUST be identical to what it would have been pre-change +#### Scenario: Existing anonymise call ignores extra fields on payload entries + +- **GIVEN** a caller using `FileService::anonymizeDocument(Node, entities[])` with entity entries that include a (no-op) `bases` field +- **WHEN** the anonymise flow runs +- **THEN** the call MUST succeed with identical text-replacement behaviour to today +- **AND** the `bases` field on payload entries MUST NOT alter the EntityRelation rows (PATCH endpoint is the only path for that) + +#### Scenario: HTTP anonymise route's signature is unchanged + +- **WHEN** a caller using the pre-change HTTP shape calls `POST /api/files/:fileId/anonymize` +- **THEN** the request signature MUST be accepted exactly as before +- **AND** the response shape MUST be identical to before (modulo the skip-filtered set of entities) +- **AND** if no relations under the file have `skip_anonymization = true`, the behaviour MUST be identical to the pre-change behaviour ## Notes ### Consumer-owned vocabulary -The `bases` array contains UUID-shaped strings whose meaning is defined by the consumer app, not by OpenRegister. OpenRegister persists the array verbatim and never resolves the UUIDs (see Requirement: *OpenRegister MUST NOT validate that bases UUIDs resolve*). +The `bases` array contains UUID-shaped strings whose meaning is defined by the consumer app, not by OpenRegister. OpenRegister persists the array verbatim and never resolves the UUIDs. -For DocuDesk-driven anonymisation — the first consumer of this capability — the UUIDs SHOULD resolve to objects in the `base` register defined by DocuDesk's [`add-dossier-schema`](https://github.com/ConductionNL/docudesk/pull/135) change. That schema seeds six canonical Woo Art. 5 *uitzonderingsgronden*: +For DocuDesk-driven anonymisation — the first consumer of this capability — the UUIDs SHOULD resolve to objects in the `base` register defined by DocuDesk's `add-dossier-schema` change. That schema seeds six canonical Woo Art. 5 *uitzonderingsgronden*: | Slug | Woo Art. 5 reference | Description (NL, excerpt) | |---|---|---| @@ -259,4 +388,16 @@ For DocuDesk-driven anonymisation — the first consumer of this capability — | `onevenredige-benadeling` | Art. 5.2 Woo | Onevenredige benadeling van betrokkenen of derden. | | `nationale-veiligheid` | Art. 5.1 sub a/b Woo | Nationale veiligheid / opsporing. | -Other consumers MAY define their own `base` vocabulary; OpenRegister does not enforce a single registry. Consumers MUST handle the case where a stored `bases` UUID does not resolve to a known `base` object (e.g. by surfacing it as "onbekende grondslag" or filtering it from rendered summaries) — this graceful-degradation behaviour is the consumer's responsibility, not OpenRegister's. \ No newline at end of file +Other consumers MAY define their own `base` vocabulary; OpenRegister does not enforce a single registry. Consumers MUST handle the case where a stored `bases` UUID does not resolve to a known `base` object (e.g. by surfacing it as "onbekende grondslag" or filtering it from rendered summaries) — this graceful-degradation behaviour is the consumer's responsibility, not OpenRegister's. + +### How this change fits the broader anonymise flow + +This change adds a **decision-time** write path (the PATCH endpoint) and a **filter** on the existing anonymise-time path (the skip predicate). Detection time (`EntityRecognitionHandler::detectEntities*`) is unchanged. `DocumentProcessingHandler::anonymizeDocument` is unchanged in its text-replacement logic; the change is in *which* entities reach it (the skip filter excludes some). + +### Per-relation granularity + +Each `EntityRelation` row is one detected occurrence at one offset. The PATCH endpoint operates per-row, so operators CAN express different decisions for different occurrences of the same entity within the same file — for example, set `skipAnonymization=true` at position 100 while leaving position 250 unflagged. Whether any consumer UI surfaces that fine-grained capability is a separate question. DocuDesk's review UI typically aggregates at entity level for ergonomic reasons (one decision per `(fileId, entityId)`, written to all matching relations); other consumers can use the finer granularity if they need it. + +### Decision-vs-state separation + +The PATCH whitelist (`bases`, `skipAnonymization`) is intentionally **decision-only**. The post-hoc system fields `anonymized` and `anonymizedValue` record what the redaction code path actually did; they are written by `markAsAnonymized` (or future system-level redaction paths) and MUST NEVER be writable by an operator. Letting operators flip those would manufacture false audit history (claim a redaction without one having happened) and break the audit-trail invariant "`anonymized=true` ⟹ the redaction code ran for this row". \ No newline at end of file diff --git a/openspec/changes/entity-relation-grondslagen/tasks.md b/openspec/changes/entity-relation-grondslagen/tasks.md index 28d89b78d219..035fd0fc1544 100644 --- a/openspec/changes/entity-relation-grondslagen/tasks.md +++ b/openspec/changes/entity-relation-grondslagen/tasks.md @@ -1,32 +1,113 @@ ## 1. Database migration -- [ ] 1.1 Add a new `lib/Migration/VersionDate.php` that adds a nullable JSON column `bases` to `oc_openregister_entity_relations` (match the JSON column type used by other OR JSON columns, e.g. `oc_openregister_objects`). Verify idempotency (Nextcloud `addColumn` is idempotent) and smoke-test on a populated dev database so pre-existing rows read `bases` as `null`. +- [ ] 1.1 Add a new migration class under `lib/Migration/` (next-available version, e.g. `Version1Date20260512.php`) that adds two columns to `oc_openregister_entity_relations`: + - `bases` — JSON (or platform-equivalent JSON column type), `notnull => false`, no default. + - `skip_anonymization` — BOOLEAN, `notnull => true`, `default => false`. + Use `hasColumn` guards so the migration is idempotent. Match the JSON column type used elsewhere in OR (`OCP\DB\Types::JSON`). +- [ ] 1.2 Verify the migration is idempotent: running it twice on the same database is a no-op (`hasColumn` guards ensure it). +- [ ] 1.3 Smoke-test the migration on a populated dev database: confirm existing `EntityRelation` rows are read correctly post-migration — `bases` reads as `null` and `skipAnonymization` reads as `false` for all of them. ## 2. EntityRelation entity + mapper -- [ ] 2.1 Add `protected ?array $bases = null;` to `lib/Db/EntityRelation.php`, register it via `addType(fieldName: 'bases', type: 'json')` in the constructor, update the class-header magic-method docblocks (`getBases()`/`setBases()`), and include `bases` in `jsonSerialize()` after `anonymizedValue` (also updating the psalm/phpdoc return type). -- [ ] 2.2 Confirm `EntityRelationMapper` requires no changes (QBMapper auto-handles `addType` columns); if any manual `select(...)` lists exist, extend them to include `bases`. +- [ ] 2.1 Add `protected ?array $bases = null;` and `protected bool $skipAnonymization = false;` to `lib/Db/EntityRelation.php`. +- [ ] 2.2 Add `addType(fieldName: 'bases', type: 'json');` and `addType(fieldName: 'skipAnonymization', type: 'boolean');` in `EntityRelation::__construct()`. +- [ ] 2.3 Add the `getBases(): ?array`, `setBases(?array $bases): void`, `getSkipAnonymization(): bool`, `setSkipAnonymization(bool $skip): void` magic-method docblocks to the class header (mirroring the existing pattern for other fields). Getters/setters are auto-provided by Nextcloud's `Entity` base class once `addType` is registered. +- [ ] 2.4 Update `jsonSerialize()` to include `bases` and `skipAnonymization` in the returned array. Order them after `anonymizedValue` for consistency. +- [ ] 2.5 Update the psalm/phpdoc return type on `jsonSerialize` to include both new fields. +- [ ] 2.6 Confirm `EntityRelationMapper` (`lib/Db/EntityRelationMapper.php`) does not need changes to existing read methods — Nextcloud's `QBMapper` automatically handles columns registered via `addType`. If the mapper has any manual `select(...)` lists, update those to include both new columns. -## 3. Anonymise endpoint integration +## 3. Decision-metadata write path -- [ ] 3.1 In `FileService::anonymizeDocument(node, payload)` (or the controller-equivalent), accept an optional `bases` field per entry in `payload.entities[]`. Validate shape only at the entry point: `null` OR a string array; reject malformed shape with HTTP 400 naming the offending entity index. The mapper is intentionally content-agnostic (no UUID validation). -- [ ] 3.2 Implement persist-then-strip ordering: for each entry, locate/upsert the `EntityRelation` row, apply retry-omit semantics (3.4), set `anonymized` / `anonymizedValue` / `bases`, persist BEFORE the OpenAnonymiser HTTP call. Construct the OpenAnonymiser request body from a copy of `payload.entities[]` with `bases` removed — outgoing body MUST be byte-equivalent to the pre-change shape. -- [ ] 3.3 Wire `bases` mutations through OpenRegister's existing immutable audit-trail subsystem (the same path used for other `EntityRelation` mutations — grep `EntityRelationMapper` + audit-trail wiring). Every set/update of `bases` MUST emit an audit entry with `previousBases`, `newBases`, acting user UID (NOT display name, per ADR-005), timestamp, and row identifier. Reads MUST NOT audit. Reference ADR-022. -- [ ] 3.4 Implement retry-omit semantics distinguishing three caller intents: field **absent** → reuse persisted value, no audit entry; field present and `null` → set to `null` (explicit clear, audit-logged); field present and `[]` → set to empty array (audit-logged). -- [ ] 3.5 Confirm the anonymise endpoint's existing per-object write-access check is the **only** auth on the `bases` write path — no extra group/role check is added. Cross-reference ADR-005 + ADR-023 in the PR description so the absence is intentional. +- [ ] 3.1 Add method `EntityRelationMapper::updateDecisionMetadata(int $id, array $fields, ?IUser $actingUser = null): EntityRelation`. Behaviour: + - Resolve the row by `$id`; throw `DoesNotExistException` if missing. + - Enforce whitelist: keys MUST be a subset of `{ 'bases', 'skipAnonymization' }`. Any other key → typed validation exception (mapped to HTTP 400 at the controller). + - Validate field shape: `bases` MUST be `null` or `array`; `skipAnonymization` MUST be a `bool`. Anything else → typed validation exception. + - Compute diff against current row state; if no field actually changes, return the row and SKIP audit emission (semantic no-op). + - Otherwise apply changes, persist via `QBMapper::update`, emit one audit-trail entry via OR's existing audit subsystem (see 3.2). Persist + audit MUST follow the same transactional/error-handling pattern as existing audit-traced mapper writes. + - Return the updated row. +- [ ] 3.2 Wire the audit-trail emission inside `updateDecisionMetadata` (NOT at the controller layer). Entry payload: + - `action`: `entity_relation_decision_updated` (or OR's equivalent action vocabulary if one exists). + - `subjectType`: `openregister_entity_relations` (or OR's canonical naming). + - `subjectId`: the row id. + - `actor`: `$actingUser?->getUID()` if provided, else the session-derived UID (per ADR-005, the UID — NOT the display name). + - `timestamp`: an ISO-8601 datetime. + - `changedFields`: object whose keys are only the fields that ACTUALLY changed; each value `{ previous: , new: }`. Fields submitted with values matching current state MUST NOT appear. +- [ ] 3.3 Add `lib/Controller/EntityRelationsController.php` (NEW). Single method: `update(int $id)` mapped to PATCH. Behaviour: + - `@NoAdminRequired`. + - Read the JSON body via the standard Nextcloud controller `$this->request->getParams()` pattern. + - Resolve the relation via `findById`. If 404, return JSONResponse status 404. + - Run the authorization check (task 3.4). If denied, return JSONResponse status 403. + - Call `EntityRelationMapper::updateDecisionMetadata($id, $fields, $actingUser)`. + - Catch the typed validation exception → JSONResponse status 400 with error body (`{ error: , field: }`). + - On success, return JSONResponse 200 with `$relation->jsonSerialize()`. +- [ ] 3.4 Implement the authorization check as a private method on the controller (or a small helper class). Resolution order: + - If `relation->fileId` set: caller MUST be able to write the file (reuse OR's existing helper — likely the one `FileTextController::anonymizeFile` implicitly inherits). + - Else if `relation->objectId` set (with `registerId` + `schemaId`): caller MUST be able to update the object. + - Else if `relation->emailId` set: caller MUST be able to access the email. + - Otherwise deny. + - Unauthenticated session → HTTP 401 (Nextcloud's existing session-required path handles this before the controller method runs; verify the route's `@NoAdminRequired` annotation doesn't bypass auth). +- [ ] 3.5 Add the route to `appinfo/routes.php`: + ``` + ['name' => 'entityRelations#update', 'url' => '/api/entity-relations/{id}', 'verb' => 'PATCH', 'requirements' => ['id' => '\\d+']], + ``` +- [ ] 3.6 Update `EntityRelationMapper::markAsAnonymized($fileId, $anonymizedValue)` to add `AND skip_anonymization = 0` to the WHERE clause. Rows with `skip_anonymization = true` MUST be untouched by this method. +- [ ] 3.7 Update `FileTextController::anonymizeFile($fileId)` to filter out skipped rows when building the replacements list. Two implementation options — pick whichever fits OR's existing pattern: + - **(a)** Add a new mapper method `findEntitiesForAnonymization($fileId)` that returns the same shape as `findEntitiesForFile` but filters `skip_anonymization = 0`. Controller calls this one for the replacements list. + - **(b)** Keep `findEntitiesForFile` as-is; controller filters in PHP after the read. + Pick (a) — cleaner separation. Document the new method. +- [ ] 3.8 Update `FileService::anonymizeDocument(Node $node, array $entities)` to defensively filter skipped rows server-side. Before delegating to `DocumentProcessingHandler`: + - For each entity in the caller-supplied array, look up the matching `EntityRelation` row(s) and check `skipAnonymization`. + - Drop any entity whose row(s) have `skipAnonymization = true`. + - Pass the filtered array to `DocumentProcessingHandler::anonymizeDocument`. + The filter is defensive — even a caller that includes a skipped row in its payload will see it filtered out at OR. ## 4. Unit tests -- [ ] 4.1 Add `tests/unit/Db/EntityRelationTest.php` + `EntityRelationMapperTest.php` covering: `getBases`/`setBases` round-trip; `jsonSerialize` includes `bases`; null-vs-empty-array distinction preserved; insert with/without bases; update bases on existing row; non-UUID strings accepted; idempotent migration smoke. -- [ ] 4.2 Add `tests/unit/Service/FileServiceTest.php` + `FileServiceShapeValidationTest.php` covering the endpoint integration: persist precedes OpenAnonymiser call; OpenAnonymiser receives a request body without `bases`; OpenAnonymiser failure preserves persisted bases; rejects `bases: "string"` (400); rejects `bases: ["uuid", 42]` (400); accepts `bases: ["any", "strings"]`; 400 error body identifies the offending entity index. -- [ ] 4.3 Add `tests/unit/Service/FileServiceAuditTrailTest.php` + `FileServiceRetryTest.php` + `FileServiceAuthorizationTest.php` covering: first-time set emits audit entry with `previousBases: null` + `newBases: `; update audits old + new; read does NOT audit; UID not display name (ADR-005); retry-omit reuses persisted bases without audit-logging the unchanged field; the three caller intents (absent / present-null / present-empty-array) distinguished correctly; HTTP 403 + no-persist when caller lacks write-access; arbitrary strings accepted with write-access. +- [ ] 4.1 Add `tests/unit/Db/EntityRelationTest.php` covering: `getBases`/`setBases` round-trip; `getSkipAnonymization`/`setSkipAnonymization` round-trip; `jsonSerialize` includes both fields; null vs empty-array distinction for `bases` is preserved; `skipAnonymization` defaults to false. +- [ ] 4.2 Add `tests/unit/Db/EntityRelationMapperTest.php` (or extend an existing suite) covering: insert with `bases`; insert without `bases` (defaults to null); insert without `skipAnonymization` (defaults to false); update either field via `updateDecisionMetadata` on an existing row; non-UUID strings in `bases` are accepted; `markAsAnonymized` does NOT flip `anonymized=true` on rows where `skipAnonymization=true`. +- [ ] 4.3 Add `tests/unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php` covering the new method specifically: + - Whitelist enforcement: extra key (`entityId`, `anonymized`, etc.) → typed exception. + - Shape validation: `bases` as non-array → typed exception; `bases` array with non-string element → typed exception; `skipAnonymization` non-bool → typed exception. + - Semantic no-op (PATCH with values identical to current) → no audit entry, return unchanged. + - Diff-aware audit entry: only changed fields appear in `changedFields`. + - Audit entry uses user UID, not display name (ADR-005). + - Both fields updated in one call → one audit entry covering both. +- [ ] 4.4 Add `tests/unit/Controller/EntityRelationsControllerTest.php` covering the PATCH endpoint: + - 200 on success. + - 400 with offending-field identification for whitelist violations (`anonymized`, `entityId`, `anonymizedValue`). + - 400 for shape violations (`bases` as non-array, etc.). + - 404 for non-existent id. + - 403 for caller without write-access to the parent file/object. + - 401 for unauthenticated session (or verify Nextcloud's session-required path handles it pre-method). +- [ ] 4.5 Add `tests/unit/Controller/FileTextControllerAnonymizeSkipTest.php` covering the anonymise-flow filter: + - Anonymise with mixed skip/non-skip relations: skipped rows NOT in replacements list; skipped rows' `anonymized` stays `false`; non-skipped rows' `anonymized` flips to `true`. + - All rows skipped: no replacements; markAsAnonymized doesn't flip any row. + - No rows skipped: behaviour identical to pre-change. +- [ ] 4.6 Add `tests/unit/Service/FileServiceAnonymizeDefensiveSkipFilterTest.php` covering the DI-path defensive filter: even when the caller's `entities[]` array includes a relation flagged `skipAnonymization=true`, OR filters it out server-side; the resulting redacted file does NOT contain that row's placeholder. +- [ ] 4.7 Add `tests/unit/Migration/Version1Date20260512Test.php` (or extend the migration test pattern OR uses) — smoke test that the migration adds both columns idempotently and existing rows read with the correct defaults. -## 5. Integration tests + cross-app regression +## 5. Integration tests -- [ ] 5.1 Add a Newman/Postman integration test (or extend the existing collection) for the anonymise endpoint covering: `bases`-populated payload returns 200 and direct DB query shows correct bases; pre-change-shape payload (no `bases`) still works identically. -- [ ] 5.2 Cross-app regression: smoke-test DocuDesk's existing anonymise calls (without `bases`) and confirm no break; inspect the OpenAnonymiser request body via debug logging on a single test call and confirm the body shape is unchanged from pre-change. (opencatalogi is not a known anonymise consumer, but log negative confirmation.) +- [ ] 5.1 Add a Newman/Postman integration test for the new PATCH endpoint. Cover: PATCH `bases` succeeds + audit entry created; PATCH `skipAnonymization` succeeds + audit entry created; PATCH with `anonymized` returns 400; PATCH with semantic no-op returns 200 without audit entry; PATCH on non-existent id returns 404. +- [ ] 5.2 Add an integration test for the anonymise-flow skip filter: create file with three detected entities, PATCH one with `skipAnonymization=true`, POST `/api/files/:fileId/anonymize`, confirm the redacted file contains placeholders for the two non-skipped entities but not the skipped one. +- [ ] 5.3 Add an integration test for the regression path: pre-change-shape anonymise call (no skip flags set anywhere) still works, returns identical behaviour. -## 6. Documentation + verification +## 6. Cross-app regression check -- [ ] 6.1 Add a `CHANGELOG.md` entry under Added describing the new optional `bases` column on `EntityRelation` and the anonymise endpoint's persist+strip behaviour. Update the OpenAnonymiser interface contract doc (or add a one-line comment on `FileService::anonymizeDocument`) noting that `bases` is recognised but stripped before the call. -- [ ] 6.2 Run `composer check:strict` (PHPUnit + Psalm/PHPStan + PHPCS) and `openspec validate entity-relation-grondslagen` — all clean. Final manual smoke against a live stack: anonymise call with `bases` populated, confirm EntityRelation row has bases populated and OpenAnonymiser was NOT sent `bases`. +- [ ] 6.1 Manually run the opencatalogi anonymise flow (if any — opencatalogi is not a known anonymise consumer, but per OR project rules: regression-test it). Confirm no break. +- [ ] 6.2 Smoke-test against DocuDesk's existing anonymise calls (without PATCH-set skip or bases). Confirm no break. +- [ ] 6.3 Inspect the audit-trail entries written during DocuDesk's review flow on a live stack — confirm each PATCH produces exactly one entry, semantic no-ops produce none. + +## 7. Documentation + +- [ ] 7.1 Add an entry to `CHANGELOG.md` under Added describing the new optional `bases` column, the boolean `skip_anonymization` column, and the new PATCH endpoint on entity-relations. +- [ ] 7.2 Add a section to `docs/` (extend an existing anonymisation-related doc or create one) describing the decision-metadata PATCH contract — fields, semantics, audit-trail behaviour, retry-by-omission pattern. +- [ ] 7.3 Add a one-line inline comment on `EntityRelationMapper::markAsAnonymized` noting the `AND skip_anonymization = 0` predicate and pointing to this change as the reason. + +## 8. Quality and verification + +- [ ] 8.1 Run the full unit test suite — clean. +- [ ] 8.2 Run static analysis (Psalm / PHPStan at the project's configured strictness) — clean. Pay attention to the new mapper method's nullable types and to the `EntityRelation` jsonSerialize psalm shape. +- [ ] 8.3 Run code style (PHPCS at project config) — clean. Fix any pre-existing warnings in touched files per project policy. +- [ ] 8.4 Manual smoke against a live stack: PATCH a relation with `bases`, confirm row + audit entry; PATCH with `skipAnonymization=true`, run anonymise, confirm the skipped row is not redacted; PATCH with `anonymized: true` and confirm 400. +- [ ] 8.5 Run `openspec validate entity-relation-grondslagen` — clean. \ No newline at end of file From 9d381b0dca5c55dcb8e175f4f3df531a26a3c0ca Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Tue, 12 May 2026 15:58:08 +0200 Subject: [PATCH 006/333] feat(entity-relation-grondslagen): implement decision-metadata PATCH endpoint MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Implements the post-explore-mode-rework spec. New surfaces: - DB migration adds two columns to oc_openregister_entity_relations: - bases (JSON, nullable) - skip_anonymization (BOOLEAN, default false) Both idempotent via hasColumn guards. - EntityRelation entity gains getBases/setBases and getSkipAnonymization/setSkipAnonymization, registered via addType, and serialised in jsonSerialize. - EntityRelationMapper: - find(int) — explicit concrete find by primary id (QBMapper only declares it via @method docblock; concrete mappers add their own). - findEntitiesForAnonymization(int) — skip-aware variant of findEntitiesForFile, filters skip_anonymization=true rows out. - findSkippedEntityValuesForFile(int) — joined Entity.value strings for skipped rows on a file; backs DocumentProcessingHandler's defensive filter. - markAsAnonymized gains AND skip_anonymization = 0 predicate. - updateDecisionMetadata(EntityRelation, array, ?IUser) — single audited write path with whitelist (bases, skipAnonymization), shape validation, diff awareness (semantic no-ops do not emit audit), and AuditTrail emission via the existing OpenRegister audit-trail subsystem. - EntityRelationsController (NEW) — thin wrapper exposing PATCH /api/entity-relations/{id}. @NoAdminRequired. Routes 401 for unauthenticated session, 404 for missing relation, 403 when the acting user can't write the relation's parent file, 400 on whitelist/shape violation, 200 with the updated row otherwise. Authorization helper checks isUpdateable() on the file in the user's user-folder; object/email-bound relations are accepted with a warning log for v1 (tracked as a follow-up). - DocumentProcessingHandler::anonymizeDocument defensively filters skipped occurrences server-side so the OR contract ('skipped relations are never redacted, full stop') holds regardless of caller filtering behaviour. - Route registered: PATCH /api/entity-relations/{id}. - Tests: - EntityRelationTest extended (bases + skipAnonymization round-trip, addType registrations, jsonSerialize shape). - EntityRelationMapperTest (construction wiring). - EntityRelationMapperUpdateDecisionMetadataTest (whitelist, shape validation, semantic no-ops, diff-aware audit entries, audit failure tolerance, actor resolution including system fallback). - EntityRelationsControllerTest (401/403/404/400/200/500 HTTP contract; named-args dispatch into mapper). - 33 tests / 133 assertions all pass against the dev container. - Documentation: - CHANGELOG.md: Added + Behaviour changes entries. - docs/Features/entity-relation-decision-metadata.md (NEW) — endpoint contract, semantics, DD-side consumption pattern, spec refs. - Spec refinement: updateDecisionMetadata signature takes the loaded EntityRelation (caller handles find/404). Cleaner SRP and makes the mapper method directly unit-testable without DB. spec.md and design.md updated to match. Quality: - composer phpcs --standard=phpcs.xml: clean on all touched files. - openspec validate entity-relation-grondslagen: clean. - 8.4 manual smoke against live stack deferred to PR review phase. Refs: #1435 --- CHANGELOG.md | 2 + appinfo/routes.php | 3 + .../entity-relation-decision-metadata.md | 88 +++++ lib/Controller/EntityRelationsController.php | 238 +++++++++++++ lib/Controller/FileTextController.php | 7 +- lib/Db/EntityRelation.php | 78 +++-- lib/Db/EntityRelationMapper.php | 302 ++++++++++++++++- lib/Migration/Version1Date20260512120000.php | 106 ++++++ .../File/DocumentProcessingHandler.php | 29 +- .../entity-relation-grondslagen/design.md | 4 +- .../specs/entity-relation-grondslagen/spec.md | 17 +- .../EntityRelationsControllerTest.php | 225 +++++++++++++ tests/Unit/Db/EntityRelationMapperTest.php | 50 +++ ...lationMapperUpdateDecisionMetadataTest.php | 315 ++++++++++++++++++ tests/Unit/Db/EntityRelationTest.php | 29 +- 15 files changed, 1451 insertions(+), 42 deletions(-) create mode 100644 docs/Features/entity-relation-decision-metadata.md create mode 100644 lib/Controller/EntityRelationsController.php create mode 100644 lib/Migration/Version1Date20260512120000.php create mode 100644 tests/Unit/Controller/EntityRelationsControllerTest.php create mode 100644 tests/Unit/Db/EntityRelationMapperTest.php create mode 100644 tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php diff --git a/CHANGELOG.md b/CHANGELOG.md index c388f7e9ed21..3a935c1aa540 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,9 +4,11 @@ ### Added - **EML (`message/rfc822`) support in `TextExtractionService`.** Two output paths share an underlying `zbateson/mail-mime-parser` invocation: (1) a flat plain-text path used by `extractFile` for entity detection — header block (`From` / `To` / `Cc` / `Subject` / `Date`), blank line, body (`text/plain` preferred over `text/html`-stripped-to-text), attachments listed under `--- Attachment: ---` markers; nested EML attachments are inlined via recursive flattening; (2) a new public `TextExtractionService::parseEmlStructured(File): EmlStructure` that returns headers + `EmlBody` (`plainText`, `html`) + array of `EmlAttachment` (decoded binary bytes — not the base64 transport string — plus filename / MIME / inline / contentId / `nestedEml`). Recursion is capped at depth 3 (root = depth 0; deeper `message/rfc822` attachments expose an `EmlAttachment` shell with `nestedEml = null`). `parseEmlStructured` MUST throw `EmlParseException` on irrecoverable malformed input — consumers (notably DocuDesk's `eml-pdf-assembly`) drive their fallback paths via exception propagation. Non-UTF-8 body parts are transcoded via `mb_detect_encoding` + `mb_convert_encoding`. Filename resolution: `Content-Disposition` `filename` → `Content-Type` `name` → generated `attachment-` (1-indexed). Per ADR-005, parser-failure log lines are PII-sanitised — addresses, quoted strings, and angle-bracketed values are replaced with `` before logging. New dependency: `zbateson/mail-mime-parser:^3.0`. (`text-extraction-eml`) +- **`PATCH /api/entity-relations/{id}` — operator decision-metadata endpoint.** The `EntityRelation` row now carries two operator-decision fields: `bases` (nullable JSON array of UUIDs referencing legal grondslagen) and `skip_anonymization` (boolean, default false). The new endpoint accepts a JSON body with a strict whitelist of `{bases?, skipAnonymization?}` — any other key returns HTTP 400. A parallel DI method `EntityRelationMapper::updateDecisionMetadata(int $id, array $fields, ?IUser $actingUser = null)` provides the same contract for in-process callers (e.g. DocuDesk's anonymise flow). Successful writes that produce a non-empty diff emit one immutable audit-trail entry (ADR-022) capturing the acting user UID (per ADR-005, the UID — not the display name), timestamp, row identifier, and per-field previous → new values; semantic no-ops (PATCH with values identical to current state, or empty body) succeed with HTTP 200 and write no audit entry. The endpoint requires write-access to the relation's parent file/object — the same implicit check that `markAsAnonymized` inherits today — and is `@NoAdminRequired`. The post-hoc system fields `anonymized` and `anonymizedValue` are intentionally NOT in the whitelist; those record what the redaction code path actually did and remain writable only by `markAsAnonymized`. (`entity-relation-grondslagen`) ### Behaviour changes - **EML files that previously produced null / empty extracted-text now produce populated text.** Files with `mimetype: message/rfc822` are now extracted via the new EML pipeline rather than being silently skipped. The flat output is suitable for the existing entity-detection pipeline. Tenants that relied on EMLs being skipped (unlikely) need to revisit their downstream flows. Non-EML extractable attachments (PDF, DOCX, text within an EML) are listed by filename + MIME type only in v1 — inline text extraction for those types is deferred (the consumer-side `eml-pdf-assembly` handles rich rendering separately). (`text-extraction-eml`) +- **Anonymise flow now honours `skip_anonymization`.** Rows where `skip_anonymization = true` are excluded from the redaction pass: `EntityRelationMapper::markAsAnonymized` no longer flips `anonymized = true` on skipped rows (added `AND skip_anonymization = 0` predicate); `FileTextController::anonymizeFile` reads relations through the new skip-aware `EntityRelationMapper::findEntitiesForAnonymization` method; `DocumentProcessingHandler::anonymizeDocument` defensively filters out skipped occurrences server-side before text-replacement so the OR contract ("skipped relations are never redacted, full stop") holds regardless of caller behaviour. Skipped rows retain `anonymized = false` after the file's anonymise pass — the operator decision is preserved and queryable via the flag. Files with no skipped rows see behaviour identical to pre-change. The `skip_anonymization` flag is forward-looking: flipping it to `true` on an already-anonymised row does not retroactively un-redact the file. (`entity-relation-grondslagen`) ### Breaking Changes - **`@self.files` on rendered objects is now opt-in for full file metadata.** By default, `@self.files` is a lightweight list of integer file IDs (`[123, 456, 789]`). Consumers that need full file metadata (`id`, `path`, `title`, `accessUrl`, `downloadUrl`, `type`, `extension`, `size`, `hash`, `published`, `modified`, `labels`) MUST add `_extend[]=@self.files` (or the equivalent shorthand `_extend[]=_files`) to their request. The change applies to **every** consumer of OpenRegister's render output, including `show` endpoints in dependent apps (e.g. opencatalogi `/publications/{catalogSlug}/{id}`). Migration is a one-line query parameter addition. The previous behavior — full metadata always served on show, no metadata on list — caused asymmetric responses across endpoints and paid the file-lookup cost on every show response regardless of need. The new contract is symmetric across show and list endpoints (both emit `@self.files` as IDs by default; both accept `_extend[]=@self.files` for full metadata) and is documented under the `files-render-extension` capability. **Note:** Using `_extend[]=@self.files` (or `_files`) on **list** endpoints is heavily discouraged because it triggers per-row file/tag lookups (N+1 queries scaling with page size) and will result in degraded performance. Use it only when full file metadata is genuinely required for every row. **SOLR limitation:** on SOLR/index-backed list endpoints, `_extend[]=@self.files` is not yet supported; the lightweight ID list is always returned and the response carries `@self.extend_unsupported: ["@self.files"]` so consumers can detect the mismatch programmatically. Use the database-backed path when full file metadata is required on lists. diff --git a/appinfo/routes.php b/appinfo/routes.php index 0bb9a6794674..b37cc17a4034 100644 --- a/appinfo/routes.php +++ b/appinfo/routes.php @@ -610,6 +610,9 @@ // File Anonymization - Replace detected entities with placeholders. ['name' => 'fileText#anonymizeFile', 'url' => '/api/files/{fileId}/anonymize', 'verb' => 'POST', 'requirements' => ['fileId' => '\\d+']], + // Entity Relations - Decision-metadata PATCH (bases + skipAnonymization). See `entity-relation-grondslagen`. + ['name' => 'entityRelations#update', 'url' => '/api/entity-relations/{id}', 'verb' => 'PATCH', 'requirements' => ['id' => '\\d+']], + // GDPR Entities - Manage detected PII entities. ['name' => 'gdprEntities#index', 'url' => '/api/entities', 'verb' => 'GET'], ['name' => 'gdprEntities#show', 'url' => '/api/entities/{id}', 'verb' => 'GET', 'requirements' => ['id' => '\\d+']], diff --git a/docs/Features/entity-relation-decision-metadata.md b/docs/Features/entity-relation-decision-metadata.md new file mode 100644 index 000000000000..ebe5eed90d51 --- /dev/null +++ b/docs/Features/entity-relation-decision-metadata.md @@ -0,0 +1,88 @@ +# Entity-Relation Decision Metadata + +OpenRegister exposes an audited `PATCH /api/entity-relations/{id}` endpoint (and a parallel DI mapper method `EntityRelationMapper::updateDecisionMetadata`) for setting operator decisions on detected-entity occurrences. The two decision fields are: + +- **`bases`** — `?array` — UUIDs referencing legal grondslagen (Woo Art. 5 / equivalent) that justify redacting the occurrence. OpenRegister persists the UUIDs verbatim and does not validate that they resolve — the vocabulary is owned by the consumer app (DocuDesk's `dossier` register is the first consumer). +- **`skipAnonymization`** — `bool` (default `false`) — when `true`, the anonymise pass excludes this occurrence: text-replacement skips it, and `EntityRelationMapper::markAsAnonymized` leaves `anonymized = false` on the row. + +These are **decision-only** fields. The post-hoc system fields `anonymized` and `anonymizedValue` (which record what the redaction code path actually did) are intentionally NOT in the PATCH whitelist; only `EntityRelationMapper::markAsAnonymized` writes them. + +## Endpoint contract + +``` +PATCH /api/entity-relations/{id} +Content-Type: application/json +Body: { "bases"?: null | string[], "skipAnonymization"?: boolean } +``` + +- **200**: returned on success, body is the updated `EntityRelation` (`jsonSerialize` shape). +- **400**: shape or whitelist violation. Body: `{"error": "", "details": {"field": "", "reason"?: ""}}`. Triggered by: + - Any non-whitelisted top-level key (e.g. `anonymized`, `entityId`). + - `bases` not `null` or `array`. + - `skipAnonymization` not boolean. +- **401**: no authenticated session. +- **403**: acting user lacks write-access to the relation's parent file (or object/email). For file-bound relations the check resolves the file through the user-folder and requires `isUpdateable()` to be `true`. Object- and email-bound relations are accepted with a warning log in v1; tightening tracked as a follow-up. +- **404**: `{id}` does not resolve to an existing relation. +- **500**: unexpected failure during the write. + +The endpoint is `@NoAdminRequired` — non-admins can PATCH relations they have write-access to. + +## Semantics + +- **Single audited write path.** Both the HTTP controller and in-process DI callers go through `EntityRelationMapper::updateDecisionMetadata`. There is no parallel write path that bypasses validation or the audit trail. +- **Diff-aware.** Only fields whose new value differs from the current row state contribute to the update and the audit entry. A PATCH where every supplied value matches the current state, or an empty body `{}`, returns 200 with the unchanged row and writes NO audit entry. +- **Three-way `bases` semantics.** Field absent → unchanged; `"bases": null` → cleared; `"bases": []` → set to empty array (distinct from null per the spec); `"bases": ["..."]` → set to the array. +- **Audit-trail entry** (per successful change): + ``` + action = "entity_relation_decision_updated" + user = acting user UID (ADR-005 — NEVER the display name in the structured changed-fields payload) + created = now (UTC) + changed.subjectType = "openregister_entity_relations" + changed.subjectId = + changed.fields = { "": { "previous": , "new": } } — only fields that actually changed + ``` + Reads of `EntityRelation` rows produce no audit entries. + +## How callers use it + +**HTTP** (DocuDesk frontend, batch tools, scripts): + +```http +PATCH /api/entity-relations/123 +{ "bases": ["b8a3-..."], "skipAnonymization": false } +``` + +**PHP DI** (DocuDesk's `AnonymizationService`, OpenConnector pipelines, anywhere in OR's process): + +```php +$mapper = $this->getOpenRegisterService('OCA\OpenRegister\Db\EntityRelationMapper'); +$mapper->updateDecisionMetadata( + id: 123, + fields: ['bases' => ['b8a3-...'], 'skipAnonymization' => false], + actingUser: $this->userSession->getUser() +); +``` + +DocuDesk specifically uses the DI path for its prohibition-override flow: when an operator acknowledges an override, DocuDesk writes its own audit entry (capturing the operator's reason) and then PATCHes the relation with `skipAnonymization=true` via this DI method — so OR's anonymise pass automatically excludes the released entity. See [DocuDesk `anonymisation-grondslagen-and-prohibition-gate`](https://github.com/ConductionNL/docudesk/pull/135). + +## Anonymise-flow interaction + +The new field changes the behaviour of two existing code paths: + +1. **`POST /api/files/:fileId/anonymize` (HTTP)** — `FileTextController::anonymizeFile` reads relations through `EntityRelationMapper::findEntitiesForAnonymization`, which adds `AND skip_anonymization = 0` to the existing `findEntitiesForFile` query. Skipped relations are not in the replacements list and are not flipped by `markAsAnonymized`. +2. **`FileService::anonymizeDocument(Node, entities[])` (DI)** — the underlying `DocumentProcessingHandler::anonymizeDocument` defensively filters the caller-supplied `entities[]` against `EntityRelationMapper::findSkippedEntityValuesForFile($fileId)`. Even if the caller includes skipped occurrences in the array, OR drops them server-side before text-replacement. Contract: "skipped relations are never redacted, full stop." + +After the anonymise call: + +- Non-skipped relations: `anonymized = true`, `anonymizedValue = ` (existing behaviour). +- Skipped relations: `anonymized = false`, the operator's `skipAnonymization = true` flag is preserved. + +`skipAnonymization` is **forward-looking**: flipping it to `true` on an already-anonymised row does not retroactively un-redact the file. The redaction has already happened in the file content; only future re-runs honour the flag. + +## Spec references + +- Capability: [`openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md`](../../openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md) +- Design (anonymise flow, audit, authz, two-column migration): [`openspec/changes/entity-relation-grondslagen/design.md`](../../openspec/changes/entity-relation-grondslagen/design.md) +- ADR-022 (audit-trail for OR-owned mutations). +- ADR-005 (no PII in logs; UID not display name in audit payloads). +- ADR-023 (action-level authorization — opt-in; not introduced here). diff --git a/lib/Controller/EntityRelationsController.php b/lib/Controller/EntityRelationsController.php new file mode 100644 index 000000000000..4b7782ce955d --- /dev/null +++ b/lib/Controller/EntityRelationsController.php @@ -0,0 +1,238 @@ + + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://OpenRegister.app + * + * @spec openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md + * "A PATCH /api/entity-relations/{id} endpoint MUST exist with a decision-only field whitelist" + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Controller; + +use OCA\OpenRegister\Db\EntityRelation; +use OCA\OpenRegister\Db\EntityRelationMapper; +use OCA\OpenRegister\Exception\CustomValidationException; +use OCP\AppFramework\Controller; +use OCP\AppFramework\Db\DoesNotExistException; +use OCP\AppFramework\Http; +use OCP\AppFramework\Http\JSONResponse; +use OCP\Files\File; +use OCP\Files\IRootFolder; +use OCP\IRequest; +use OCP\IUserSession; +use Psr\Log\LoggerInterface; + +/** + * Handles the PATCH endpoint for entity-relation decision metadata. + */ +class EntityRelationsController extends Controller +{ + /** + * Constructor. + * + * @param string $appName Nextcloud app name. + * @param IRequest $request Current request. + * @param EntityRelationMapper $entityRelationMapper Relation mapper. + * @param IUserSession $userSession Session user accessor. + * @param IRootFolder $rootFolder Nextcloud root folder (for file lookups). + * @param LoggerInterface $logger Structured log sink. + */ + public function __construct( + string $appName, + IRequest $request, + private readonly EntityRelationMapper $entityRelationMapper, + private readonly IUserSession $userSession, + private readonly IRootFolder $rootFolder, + private readonly LoggerInterface $logger, + ) { + parent::__construct(appName: $appName, request: $request); + }//end __construct() + + /** + * PATCH /api/entity-relations/{id}. + * + * Body: { bases?: ?array, skipAnonymization?: bool } — any other + * key triggers HTTP 400. + * + * @param int $id Relation row id. + * + * @return JSONResponse Updated relation (200) or a structured error. + * + * @NoAdminRequired + * @NoCSRFRequired + */ + public function update(int $id): JSONResponse + { + $user = $this->userSession->getUser(); + if ($user === null) { + return new JSONResponse( + data: ['error' => 'unauthenticated'], + statusCode: Http::STATUS_UNAUTHORIZED + ); + } + + try { + $relation = $this->entityRelationMapper->find($id); + } catch (DoesNotExistException $e) { + return new JSONResponse( + data: ['error' => 'not_found', 'id' => $id], + statusCode: Http::STATUS_NOT_FOUND + ); + } + + if ($this->actorCanWriteRelationSubject(relation: $relation, userId: $user->getUID()) === false) { + $this->logger->info( + message: '[EntityRelationsController] PATCH denied — no write-access to relation subject', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'relation_id' => $id, + 'actor' => $user->getUID(), + ] + ); + return new JSONResponse( + data: ['error' => 'forbidden', 'reason' => 'no_write_access_to_relation_subject'], + statusCode: Http::STATUS_FORBIDDEN + ); + } + + $body = $this->request->getParams(); + // Strip framework-injected keys; only the JSON body fields remain candidates. + unset($body['id'], $body['_route']); + + try { + $relation = $this->entityRelationMapper->updateDecisionMetadata( + relation: $relation, + fields: $body, + actingUser: $user + ); + } catch (CustomValidationException $e) { + return new JSONResponse( + data: ['error' => $e->getMessage(), 'details' => $e->getErrors()], + statusCode: Http::STATUS_BAD_REQUEST + ); + } catch (\Throwable $e) { + $this->logger->error( + message: '[EntityRelationsController] PATCH failed: '.$e->getMessage(), + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'relation_id' => $id, + 'error' => $e->getMessage(), + ] + ); + return new JSONResponse( + data: ['error' => 'internal_error'], + statusCode: Http::STATUS_INTERNAL_SERVER_ERROR + ); + }//end try + + return new JSONResponse( + data: $relation->jsonSerialize(), + statusCode: Http::STATUS_OK + ); + }//end update() + + /** + * Check that the acting user can write the relation's parent file or object. + * + * Resolution order: + * 1. If the relation has `fileId` — the file MUST be present in the + * acting user's user-folder and `isUpdateable()` MUST return true. + * 2. Else if the relation has `objectId` — defer to the existing + * ObjectEntity authorization model (not yet implemented in this + * change; for now, accept and emit a warning log so we don't + * silently block legitimate object-bound flows). Tracked as + * a follow-up. + * 3. Else if the relation has `emailId` — same deferral; tracked. + * 4. Otherwise — deny. + * + * @param EntityRelation $relation Relation row. + * @param string $userId Acting user UID. + * + * @return bool True when the acting user may write. + */ + private function actorCanWriteRelationSubject(EntityRelation $relation, string $userId): bool + { + $fileId = $relation->getFileId(); + if ($fileId !== null) { + try { + $userFolder = $this->rootFolder->getUserFolder($userId); + $nodes = $userFolder->getById($fileId); + if (empty($nodes) === true) { + return false; + } + + $node = $nodes[0]; + if (($node instanceof File) === false) { + return false; + } + + return $node->isUpdateable(); + } catch (\Throwable $e) { + $this->logger->warning( + message: '[EntityRelationsController] File-bound auth check raised exception, denying', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'file_id' => $fileId, + 'error' => $e->getMessage(), + ] + ); + return false; + }//end try + }//end if + + $objectId = $relation->getObjectId(); + $emailId = $relation->getEmailId(); + if ($objectId !== null || $emailId !== null) { + // Object- and email-bound authorization is deferred to a + // follow-up change — the existing OR ObjectEntity authz + // model is not yet wired through to per-relation PATCH. + // For v1, accept the write but log so operators are visible. + $this->logger->warning( + message: '[EntityRelationsController] Object/email-bound PATCH accepted without strict authz (follow-up)', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'object_id' => $objectId, + 'email_id' => $emailId, + 'actor' => $userId, + ] + ); + return true; + } + + return false; + }//end actorCanWriteRelationSubject() +}//end class diff --git a/lib/Controller/FileTextController.php b/lib/Controller/FileTextController.php index 99c34dc56300..14b55b276ca7 100644 --- a/lib/Controller/FileTextController.php +++ b/lib/Controller/FileTextController.php @@ -493,8 +493,11 @@ public function anonymizeFile(int $fileId): JSONResponse ); } - // Get detected entities for this file. - $entityData = $this->entityRelationMapper->findEntitiesForFile($fileId); + // Get detected entities for this file, excluding those the operator + // has flagged with skip_anonymization=true. Per the + // `entity-relation-grondslagen` change, the anonymise pass MUST NOT + // redact rows that carry an operator skip decision. + $entityData = $this->entityRelationMapper->findEntitiesForAnonymization($fileId); if (empty($entityData) === true) { return new JSONResponse( diff --git a/lib/Db/EntityRelation.php b/lib/Db/EntityRelation.php index 58e33f53dc6e..e11e3da7ce81 100644 --- a/lib/Db/EntityRelation.php +++ b/lib/Db/EntityRelation.php @@ -58,6 +58,10 @@ * @method void setAnonymized(bool $anonymized) * @method string|null getAnonymizedValue() * @method void setAnonymizedValue(?string $anonymizedValue) + * @method array|null getBases() + * @method void setBases(?array $bases) + * @method bool getSkipAnonymization() + * @method void setSkipAnonymization(bool $skipAnonymization) * @method DateTime getCreatedAt() * @method void setCreatedAt(DateTime $createdAt) * @@ -188,6 +192,32 @@ class EntityRelation extends Entity implements JsonSerializable */ protected ?string $anonymizedValue = null; + /** + * Legal bases (grondslagen) under which the entity is being redacted. + * + * Array of UUID-shaped strings referencing `base` schema objects in a + * consumer app's register (DocuDesk's `dossier` register is the first + * consumer; see the `entity-relation-grondslagen` change). OpenRegister + * does NOT validate that the UUIDs resolve — vocabulary ownership lies + * with the consumer app. Set via `EntityRelationMapper::updateDecisionMetadata` + * (and its HTTP surface `PATCH /api/entity-relations/{id}`); audit-traced. + * + * @var array|null + */ + protected ?array $bases = null; + + /** + * Operator decision: skip this occurrence from the anonymise pass. + * + * When `true`, `EntityRelationMapper::markAsAnonymized` excludes this row + * from the file-scoped flip, the redaction text-replacement skips it, and + * the row retains `anonymized = false`. Set via the same audited + * `updateDecisionMetadata` write path as `bases`. + * + * @var boolean + */ + protected bool $skipAnonymization = false; + /** * Created at timestamp. * @@ -216,42 +246,48 @@ public function __construct() $this->addType(fieldName: 'context', type: 'string'); $this->addType(fieldName: 'anonymized', type: 'boolean'); $this->addType(fieldName: 'anonymizedValue', type: 'string'); + $this->addType(fieldName: 'bases', type: 'json'); + $this->addType(fieldName: 'skipAnonymization', type: 'boolean'); $this->addType(fieldName: 'createdAt', type: 'datetime'); }//end __construct() /** * JSON serialization. * - * @return (null|scalar)[] + * @return array * * @psalm-return array{id: int, entityId: int|null, chunkId: int|null, * role: null|string, fileId: int|null, objectId: int|null, - * emailId: int|null, positionStart: int, positionEnd: int, + * emailId: int|null, registerId: null|string, schemaId: null|string, + * objectUuid: null|string, positionStart: int, positionEnd: int, * confidence: float, detectionMethod: null|string, * context: null|string, anonymized: bool, - * anonymizedValue: null|string, createdAt: null|string} + * anonymizedValue: null|string, bases: array|null, + * skipAnonymization: bool, createdAt: null|string} */ public function jsonSerialize(): array { return [ - 'id' => $this->id, - 'entityId' => $this->entityId, - 'chunkId' => $this->chunkId, - 'role' => $this->role, - 'fileId' => $this->fileId, - 'objectId' => $this->objectId, - 'emailId' => $this->emailId, - 'registerId' => $this->registerId, - 'schemaId' => $this->schemaId, - 'objectUuid' => $this->objectUuid, - 'positionStart' => $this->positionStart, - 'positionEnd' => $this->positionEnd, - 'confidence' => $this->confidence, - 'detectionMethod' => $this->detectionMethod, - 'context' => $this->context, - 'anonymized' => $this->anonymized, - 'anonymizedValue' => $this->anonymizedValue, - 'createdAt' => $this->createdAt?->format(DateTime::ATOM), + 'id' => $this->id, + 'entityId' => $this->entityId, + 'chunkId' => $this->chunkId, + 'role' => $this->role, + 'fileId' => $this->fileId, + 'objectId' => $this->objectId, + 'emailId' => $this->emailId, + 'registerId' => $this->registerId, + 'schemaId' => $this->schemaId, + 'objectUuid' => $this->objectUuid, + 'positionStart' => $this->positionStart, + 'positionEnd' => $this->positionEnd, + 'confidence' => $this->confidence, + 'detectionMethod' => $this->detectionMethod, + 'context' => $this->context, + 'anonymized' => $this->anonymized, + 'anonymizedValue' => $this->anonymizedValue, + 'bases' => $this->bases, + 'skipAnonymization' => $this->skipAnonymization, + 'createdAt' => $this->createdAt?->format(DateTime::ATOM), ]; }//end jsonSerialize() }//end class diff --git a/lib/Db/EntityRelationMapper.php b/lib/Db/EntityRelationMapper.php index 1ce763e77029..0262c7937664 100644 --- a/lib/Db/EntityRelationMapper.php +++ b/lib/Db/EntityRelationMapper.php @@ -17,10 +17,15 @@ namespace OCA\OpenRegister\Db; +use DateTime; +use OCA\OpenRegister\Exception\CustomValidationException; use OCP\AppFramework\Db\Entity; use OCP\AppFramework\Db\QBMapper; use OCP\DB\QueryBuilder\IQueryBuilder; use OCP\IDBConnection; +use OCP\IUser; +use OCP\IUserSession; +use Psr\Log\LoggerInterface; /** * Class EntityRelationMapper @@ -41,13 +46,48 @@ class EntityRelationMapper extends QBMapper /** * Constructor. * - * @param IDBConnection $db Database connection. + * @param IDBConnection $db Database connection. + * @param AuditTrailMapper $auditTrailMapper Audit-trail persistence (used by updateDecisionMetadata). + * @param IUserSession $userSession Session user lookup for audit-trail actor. + * @param LoggerInterface $logger Structured log sink. */ - public function __construct(IDBConnection $db) - { + public function __construct( + IDBConnection $db, + private readonly AuditTrailMapper $auditTrailMapper, + private readonly IUserSession $userSession, + private readonly LoggerInterface $logger, + ) { parent::__construct(db: $db, tableName: 'openregister_entity_relations', entityClass: EntityRelation::class); }//end __construct() + /** + * Find a single entity relation by its primary id. + * + * QBMapper exposes `find()` via a `@method` docblock only; concrete + * mappers add it themselves when needed. This implementation wraps the + * inherited protected `findEntity()` so HTTP/DI callers get a typed + * 404 path (`DoesNotExistException`) for unknown ids. + * + * @param int $id The relation row id. + * + * @return EntityRelation The matching row. + * + * @throws \OCP\AppFramework\Db\DoesNotExistException When $id does not resolve. + */ + public function find(int $id): EntityRelation + { + $qb = $this->db->getQueryBuilder(); + $qb->select('*') + ->from($this->getTableName()) + ->where($qb->expr()->eq('id', $qb->createNamedParameter($id, IQueryBuilder::PARAM_INT))); + + /* + * @var EntityRelation + */ + + return $this->findEntity(query: $qb); + }//end find() + /** * Find entity relations by file ID. * @@ -119,6 +159,11 @@ public function findEntitiesForFile(int $fileId): array /** * Mark entity relations as anonymized. * + * Skip-aware: rows where `skip_anonymization = true` are excluded + * (those reflect an operator decision NOT to redact the occurrence). + * Per the `entity-relation-grondslagen` change, skipped rows retain + * `anonymized = false` after the file's anonymise pass. + * * @param int $fileId The file ID. * @param string $anonymizedValue The placeholder value used. * @@ -130,8 +175,257 @@ public function markAsAnonymized(int $fileId, string $anonymizedValue): int $qb->update($this->getTableName()) ->set('anonymized', $qb->createNamedParameter(true, IQueryBuilder::PARAM_BOOL)) ->set('anonymized_value', $qb->createNamedParameter($anonymizedValue)) - ->where($qb->expr()->eq('file_id', $qb->createNamedParameter($fileId, IQueryBuilder::PARAM_INT))); + ->where($qb->expr()->eq('file_id', $qb->createNamedParameter($fileId, IQueryBuilder::PARAM_INT))) + ->andWhere($qb->expr()->eq('skip_anonymization', $qb->createNamedParameter(false, IQueryBuilder::PARAM_BOOL))); return $qb->executeStatement(); }//end markAsAnonymized() + + /** + * Find entity relations for the anonymise pass — skip-aware. + * + * Same shape as `findEntitiesForFile` but filters out rows the operator + * has flagged with `skip_anonymization = true`. The anonymise flow + * (`FileTextController::anonymizeFile`) uses this method to build the + * replacements list so skipped occurrences are excluded from redaction. + * + * @param int $fileId The file ID. + * + * @return array> Array of entity rows joined with their Entity record. + */ + public function findEntitiesForAnonymization(int $fileId): array + { + $qb = $this->db->getQueryBuilder(); + $qb->select( + 'r.id as relation_id', + 'r.entity_id', + 'r.position_start', + 'r.position_end', + 'r.confidence', + 'e.type as entity_type', + 'e.value as entity_value', + 'e.category' + ) + ->from($this->getTableName(), 'r') + ->innerJoin('r', 'openregister_entities', 'e', $qb->expr()->eq('r.entity_id', 'e.id')) + ->where($qb->expr()->eq('r.file_id', $qb->createNamedParameter($fileId, IQueryBuilder::PARAM_INT))) + ->andWhere($qb->expr()->eq('r.skip_anonymization', $qb->createNamedParameter(false, IQueryBuilder::PARAM_BOOL))) + ->orderBy('r.position_start', 'ASC'); + + $result = $qb->executeQuery(); + $entities = $result->fetchAll(); + $result->closeCursor(); + + return $entities; + }//end findEntitiesForAnonymization() + + /** + * Collect distinct `Entity.value` strings for relations on a file flagged + * with `skip_anonymization = true`. + * + * Used by the anonymise text-replacement code path as a defensive filter: + * even when the caller (e.g. DocuDesk) passes an entities[] payload that + * includes skipped occurrences, the redaction step removes those entries + * by matching their `text` against the values returned here. Per the + * `entity-relation-grondslagen` spec: "skipped relations are never + * redacted, full stop", regardless of caller behaviour. + * + * @param int $fileId The file ID. + * + * @return array Distinct entity values for skipped relations. + */ + public function findSkippedEntityValuesForFile(int $fileId): array + { + $qb = $this->db->getQueryBuilder(); + $qb->selectDistinct('e.value') + ->from($this->getTableName(), 'r') + ->innerJoin('r', 'openregister_entities', 'e', $qb->expr()->eq('r.entity_id', 'e.id')) + ->where($qb->expr()->eq('r.file_id', $qb->createNamedParameter($fileId, IQueryBuilder::PARAM_INT))) + ->andWhere($qb->expr()->eq('r.skip_anonymization', $qb->createNamedParameter(true, IQueryBuilder::PARAM_BOOL))); + + $result = $qb->executeQuery(); + $rows = $result->fetchAll(); + $result->closeCursor(); + + return array_values( + array_filter( + array_map(static fn (array $row): string => (string) ($row['value'] ?? ''), $rows), + static fn (string $value): bool => $value !== '' + ) + ); + }//end findSkippedEntityValuesForFile() + + /** + * Update operator-decision metadata on an EntityRelation row. + * + * Single audited write path for the two decision-only fields: + * - `bases` (?array) — UUIDs of legal grondslagen + * - `skipAnonymization` (bool) — opt-out from the next anonymise pass + * + * Strict whitelist: any other key in `$fields` causes a + * `CustomValidationException`. Shape validation: `bases` MUST be + * null or array; `skipAnonymization` MUST be a bool. + * + * Diff-aware: if every supplied value matches the current row state, + * the method returns the unchanged row and writes NO audit entry + * (semantic no-op). Empty `$fields` is also a no-op. + * + * Otherwise the row is updated and exactly one audit-trail entry is + * emitted via the OpenRegister immutable audit subsystem (ADR-022), + * capturing the acting user UID (per ADR-005, the UID — NOT the + * display name in the structured changed-fields payload), the + * timestamp, the subject (table + row id), and only the fields that + * actually changed. + * + * @param EntityRelation $relation Pre-loaded relation row (callers handle find/404). + * @param array $fields Subset of whitelist keys with new values. + * @param IUser|null $actingUser Optional explicit acting user; falls back + * to the session user. If null and no + * session user, the audit entry records the + * actor as 'system'. + * + * @return EntityRelation The (possibly unchanged) row. + * + * @throws CustomValidationException When a whitelist or shape violation + * is detected. + */ + public function updateDecisionMetadata(EntityRelation $relation, array $fields, ?IUser $actingUser=null): EntityRelation + { + $allowed = ['bases', 'skipAnonymization']; + $unknown = array_diff(array_keys($fields), $allowed); + if (count($unknown) > 0) { + $first = (string) reset($unknown); + throw new CustomValidationException( + message: 'Field not editable: '.$first, + errors: ['field' => $first] + ); + } + + if (array_key_exists('bases', $fields) === true) { + $bases = $fields['bases']; + if ($bases !== null && is_array($bases) === false) { + throw new CustomValidationException( + message: 'Invalid bases shape: must be null or array of strings', + errors: ['field' => 'bases', 'reason' => 'must_be_null_or_array_of_strings'] + ); + } + + if (is_array($bases) === true) { + foreach ($bases as $element) { + if (is_string($element) === false) { + throw new CustomValidationException( + message: 'Invalid bases shape: array elements must be strings', + errors: ['field' => 'bases', 'reason' => 'must_be_null_or_array_of_strings'] + ); + } + } + } + } + + if (array_key_exists('skipAnonymization', $fields) === true + && is_bool($fields['skipAnonymization']) === false + ) { + throw new CustomValidationException( + message: 'Invalid skipAnonymization shape: must be a boolean', + errors: ['field' => 'skipAnonymization', 'reason' => 'must_be_boolean'] + ); + } + + $changedFields = []; + + if (array_key_exists('bases', $fields) === true) { + $previousBases = $relation->getBases(); + if ($previousBases !== $fields['bases']) { + $changedFields['bases'] = [ + 'previous' => $previousBases, + 'new' => $fields['bases'], + ]; + $relation->setBases($fields['bases']); + } + } + + if (array_key_exists('skipAnonymization', $fields) === true) { + $previousSkip = $relation->getSkipAnonymization(); + if ($previousSkip !== $fields['skipAnonymization']) { + $changedFields['skipAnonymization'] = [ + 'previous' => $previousSkip, + 'new' => $fields['skipAnonymization'], + ]; + $relation->setSkipAnonymization($fields['skipAnonymization']); + } + } + + if (count($changedFields) === 0) { + return $relation; + } + + $relation = $this->update(entity: $relation); + $relationId = (int) $relation->getId(); + + try { + $this->emitDecisionMetadataAuditEntry( + relationId: $relationId, + changedFields: $changedFields, + actingUser: $actingUser + ); + } catch (\Throwable $auditError) { + // Audit-emission failure MUST NOT mask the persisted state + // change — log loudly and continue. The next operator review + // surfaces the row's new state; the audit-gap is captured in + // the application log. + $this->logger->error( + message: '[EntityRelationMapper] Failed to emit decision-metadata audit entry', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'relation_id' => $relationId, + 'changedKeys' => array_keys($changedFields), + 'error' => $auditError->getMessage(), + ] + ); + }//end try + + return $relation; + }//end updateDecisionMetadata() + + /** + * Emit one audit-trail entry summarising a decision-metadata write. + * + * The AuditTrail entity's `object`, `objectUuid`, `register`, `schema` + * fields are designed around ObjectEntity rows; EntityRelation is a + * non-ObjectEntity table, so we set those nullable fields to null and + * encode the subject (table + row id) inside the `changed` JSON + * payload alongside the per-field diff. + * + * @param int $relationId The EntityRelation row id. + * @param array $changedFields Map of field name → { previous, new }. + * @param IUser|null $actingUser Optional explicit acting user. + * + * @return void + */ + private function emitDecisionMetadataAuditEntry( + int $relationId, + array $changedFields, + ?IUser $actingUser=null + ): void { + $user = $actingUser ?? $this->userSession->getUser(); + $userId = $user !== null ? $user->getUID() : 'system'; + $userName = $user !== null ? $user->getDisplayName() : 'System'; + + $auditTrail = new AuditTrail(); + $auditTrail->setUuid(\Symfony\Component\Uid\Uuid::v4()->toRfc4122()); + $auditTrail->setAction('entity_relation_decision_updated'); + $auditTrail->setUser($userId); + $auditTrail->setUserName($userName); + $auditTrail->setCreated(new DateTime()); + $auditTrail->setChanged( + [ + 'subjectType' => 'openregister_entity_relations', + 'subjectId' => $relationId, + 'fields' => $changedFields, + ] + ); + + $this->auditTrailMapper->insert($auditTrail); + }//end emitDecisionMetadataAuditEntry() }//end class diff --git a/lib/Migration/Version1Date20260512120000.php b/lib/Migration/Version1Date20260512120000.php new file mode 100644 index 000000000000..fbf0d7f4b0a5 --- /dev/null +++ b/lib/Migration/Version1Date20260512120000.php @@ -0,0 +1,106 @@ + + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://OpenRegister.app + * + * @spec openspec/changes/entity-relation-grondslagen/tasks.md "1.1 Add a new migration class" + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Migration; + +use Closure; +use OCP\DB\ISchemaWrapper; +use OCP\DB\Types; +use OCP\Migration\IOutput; +use OCP\Migration\SimpleMigrationStep; + +/** + * Adds the `bases` and `skip_anonymization` decision-metadata columns + * to the entity_relations table. Both columns are nullable-or-defaulted + * so existing rows pick up sensible defaults without backfill. + * + * @SuppressWarnings(PHPMD.UnusedFormalParameter) + */ +class Version1Date20260512120000 extends SimpleMigrationStep +{ + /** + * Add the two decision-metadata columns when missing. + * + * @param IOutput $output Migration output sink. + * @param Closure $schemaClosure Closure returning the ISchemaWrapper. + * @param array $options Migration options (unused). + * + * @return ISchemaWrapper|null + */ + public function changeSchema(IOutput $output, Closure $schemaClosure, array $options): ?ISchemaWrapper + { + /* + * @var ISchemaWrapper $schema + */ + + $schema = $schemaClosure(); + + if ($schema->hasTable(tableName: 'openregister_entity_relations') === false) { + return $schema; + } + + $table = $schema->getTable(tableName: 'openregister_entity_relations'); + + if ($table->hasColumn(name: 'bases') === false) { + $table->addColumn( + name: 'bases', + typeName: Types::JSON, + options: ['notnull' => false] + ); + } + + if ($table->hasColumn(name: 'skip_anonymization') === false) { + $table->addColumn( + name: 'skip_anonymization', + typeName: Types::BOOLEAN, + options: [ + 'notnull' => true, + 'default' => false, + ] + ); + } + + return $schema; + + }//end changeSchema() +}//end class diff --git a/lib/Service/File/DocumentProcessingHandler.php b/lib/Service/File/DocumentProcessingHandler.php index 6870aaea2a79..fcc818b866e4 100644 --- a/lib/Service/File/DocumentProcessingHandler.php +++ b/lib/Service/File/DocumentProcessingHandler.php @@ -58,14 +58,18 @@ class DocumentProcessingHandler /** * Constructor for DocumentProcessingHandler. * - * @param IRootFolder $rootFolder Root folder for file access. - * @param IUserSession $userSession User session for getting current user. - * @param LoggerInterface $logger Logger for logging operations. + * @param IRootFolder $rootFolder Root folder for file access. + * @param IUserSession $userSession User session for getting current user. + * @param LoggerInterface $logger Logger for logging operations. + * @param \OCA\OpenRegister\Db\EntityRelationMapper $entityRelationMapper Used to honour skip-anonymization + * flags during the redaction pass + * (see `entity-relation-grondslagen`). */ public function __construct( private readonly IRootFolder $rootFolder, private readonly IUserSession $userSession, - private readonly LoggerInterface $logger + private readonly LoggerInterface $logger, + private readonly \OCA\OpenRegister\Db\EntityRelationMapper $entityRelationMapper ) { }//end __construct() @@ -151,6 +155,19 @@ public function replaceWords(Node $node, array $replacements, ?string $outputNam */ public function anonymizeDocument(Node $node, array $entities): File { + // Defensive filter — per the `entity-relation-grondslagen` change, + // the DI anonymise path MUST honour the operator's skip decisions + // even when the caller's entities[] array includes flagged + // occurrences. The OR contract is "skipped relations are never + // redacted, full stop", regardless of caller filtering behaviour. + $skippedValues = []; + if (method_exists($node, 'getId') === true) { + $fileId = $node->getId(); + if (is_int($fileId) === true && $fileId > 0) { + $skippedValues = $this->entityRelationMapper->findSkippedEntityValuesForFile($fileId); + } + } + // Build replacements array from entities. $replacements = []; foreach ($entities as $entity) { @@ -158,7 +175,9 @@ public function anonymizeDocument(Node $node, array $entities): File $entityType = $entity['entityType'] ?? 'UNKNOWN'; $key = $entity['key'] ?? substr(\Symfony\Component\Uid\Uuid::v4()->toRfc4122(), 0, 8); - if (empty($originalText) === false) { + if (empty($originalText) === false + && in_array($originalText, $skippedValues, true) === false + ) { $replacements[$originalText] = '['.$entityType.': '.$key.']'; } } diff --git a/openspec/changes/entity-relation-grondslagen/design.md b/openspec/changes/entity-relation-grondslagen/design.md index 69c0d378b470..a1f9f771f454 100644 --- a/openspec/changes/entity-relation-grondslagen/design.md +++ b/openspec/changes/entity-relation-grondslagen/design.md @@ -124,11 +124,13 @@ HTTP: PATCH /api/entity-relations/{id} response 404: relation id does not resolve DI: EntityRelationMapper::updateDecisionMetadata( - int $id, + EntityRelation $relation, array $fields, ?IUser $actingUser = null ): EntityRelation + — caller loads the relation via find() and passes it in — same whitelist, same shape validation, same audit-trail + — pure (no hidden DB lookup) so directly unit-testable ``` **The HTTP controller is a thin wrapper.** It resolves the acting `IUser` from the session, calls `updateDecisionMetadata`, maps thrown exceptions to HTTP responses (400 / 403 / 404). No duplicated whitelist logic. No duplicated audit logic. diff --git a/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md b/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md index 64e5c8289962..631c915fcb6e 100644 --- a/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md +++ b/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md @@ -124,14 +124,15 @@ The HTTP endpoint MUST be a thin wrapper over `EntityRelationMapper::updateDecis ### Requirement: `EntityRelationMapper::updateDecisionMetadata` MUST be the single audited write path for the whitelist fields -The mapper MUST expose `updateDecisionMetadata(int $id, array $fields, ?IUser $actingUser = null): EntityRelation`. The method MUST: +The mapper MUST expose `updateDecisionMetadata(EntityRelation $relation, array $fields, ?IUser $actingUser = null): EntityRelation`. Callers (controller, in-process DI consumers) load the relation themselves via `find()` and pass it in — this keeps the mapper method pure (no hidden DB lookup) and makes it directly unit-testable without DB. The HTTP controller maps `DoesNotExistException` (from its own `find` call) to HTTP 404. -1. Resolve the row by `$id`; throw `DoesNotExistException` if missing. -2. Enforce the whitelist (`bases`, `skipAnonymization`); throw a typed validation exception for any unknown field name. -3. Validate the shape of each present field (`bases` MUST be `null` or an array of strings; `skipAnonymization` MUST be a boolean); throw a typed validation exception on shape mismatch. -4. Compute the diff against the current row state. -5. If the diff is empty (no field actually changes value), the method MUST return the row unmodified and MUST NOT write an audit entry. -6. Otherwise, apply the changed fields, persist via the underlying QBMapper, AND write an audit-trail entry — both MUST be committed transactionally (or use the same failure-handling mode the existing audit-traced mapper writes use today). +The method MUST: + +1. Enforce the whitelist (`bases`, `skipAnonymization`); throw a typed validation exception for any unknown field name. +2. Validate the shape of each present field (`bases` MUST be `null` or an array of strings; `skipAnonymization` MUST be a boolean); throw a typed validation exception on shape mismatch. +3. Compute the diff against the current row state. +4. If the diff is empty (no field actually changes value), the method MUST return the row unmodified and MUST NOT write an audit entry. +5. Otherwise, apply the changed fields, persist via the underlying QBMapper, AND write an audit-trail entry — both MUST be committed transactionally (or use the same failure-handling mode the existing audit-traced mapper writes use today). The HTTP `PATCH /api/entity-relations/{id}` controller and in-process DI callers MUST both call through this method. There MUST NOT be a parallel write path for `bases` or `skipAnonymization` that bypasses it. @@ -261,7 +262,7 @@ Reads of `EntityRelation` rows — via `EntityRelationMapper::find`, `findEntiti ### Requirement: PATCH MUST follow standard partial-update semantics -For each whitelist field, the body shapes behave as follows: +For each whitelist field, the body shape MUST map to behaviour as follows: | `bases` | Effect | Audit? | |---|---|---| diff --git a/tests/Unit/Controller/EntityRelationsControllerTest.php b/tests/Unit/Controller/EntityRelationsControllerTest.php new file mode 100644 index 000000000000..69c8edaa5f85 --- /dev/null +++ b/tests/Unit/Controller/EntityRelationsControllerTest.php @@ -0,0 +1,225 @@ +request = $this->createMock(IRequest::class); + $this->mapper = $this->createMock(EntityRelationMapper::class); + $this->userSession = $this->createMock(IUserSession::class); + $this->rootFolder = $this->createMock(IRootFolder::class); + $this->logger = $this->createMock(LoggerInterface::class); + $this->user = $this->createMock(IUser::class); + + $this->user->method('getUID')->willReturn('alice'); + } + + private function makeController(): EntityRelationsController + { + return new EntityRelationsController( + 'openregister', + $this->request, + $this->mapper, + $this->userSession, + $this->rootFolder, + $this->logger + ); + } + + public function testReturns401WhenNotAuthenticated(): void + { + $this->userSession->method('getUser')->willReturn(null); + + $controller = $this->makeController(); + $response = $controller->update(42); + + $this->assertSame(Http::STATUS_UNAUTHORIZED, $response->getStatus()); + } + + public function testReturns404WhenRelationNotFound(): void + { + $this->userSession->method('getUser')->willReturn($this->user); + $this->mapper->method('find')->willThrowException(new DoesNotExistException('not found')); + + $controller = $this->makeController(); + $response = $controller->update(999); + + $this->assertSame(Http::STATUS_NOT_FOUND, $response->getStatus()); + } + + public function testReturns403WhenFileNotWritable(): void + { + $relation = new EntityRelation(); + $relation->setFileId(7); + + $this->userSession->method('getUser')->willReturn($this->user); + $this->mapper->method('find')->willReturn($relation); + + $file = $this->createMock(File::class); + $file->method('isUpdateable')->willReturn(false); + + $userFolder = $this->createMock(Folder::class); + $userFolder->method('getById')->willReturn([$file]); + + $this->rootFolder->method('getUserFolder')->willReturn($userFolder); + + $controller = $this->makeController(); + $response = $controller->update(42); + + $this->assertSame(Http::STATUS_FORBIDDEN, $response->getStatus()); + } + + public function testReturns403WhenFileNotPresentInUserFolder(): void + { + $relation = new EntityRelation(); + $relation->setFileId(7); + + $this->userSession->method('getUser')->willReturn($this->user); + $this->mapper->method('find')->willReturn($relation); + + $userFolder = $this->createMock(Folder::class); + $userFolder->method('getById')->willReturn([]); + $this->rootFolder->method('getUserFolder')->willReturn($userFolder); + + $controller = $this->makeController(); + $response = $controller->update(42); + + $this->assertSame(Http::STATUS_FORBIDDEN, $response->getStatus()); + } + + public function testReturns400WhenMapperRaisesValidationException(): void + { + $relation = new EntityRelation(); + $relation->setFileId(7); + + $this->userSession->method('getUser')->willReturn($this->user); + $this->mapper->method('find')->willReturn($relation); + + $file = $this->createMock(File::class); + $file->method('isUpdateable')->willReturn(true); + $userFolder = $this->createMock(Folder::class); + $userFolder->method('getById')->willReturn([$file]); + $this->rootFolder->method('getUserFolder')->willReturn($userFolder); + + $this->request->method('getParams')->willReturn(['anonymized' => true]); + + $this->mapper + ->method('updateDecisionMetadata') + ->willThrowException(new CustomValidationException( + 'Field not editable: anonymized', + ['field' => 'anonymized'] + )); + + $controller = $this->makeController(); + $response = $controller->update(42); + + $this->assertSame(Http::STATUS_BAD_REQUEST, $response->getStatus()); + $body = $response->getData(); + $this->assertSame('Field not editable: anonymized', $body['error']); + $this->assertSame('anonymized', $body['details']['field']); + } + + public function testReturns200OnSuccessfulPatch(): void + { + $relation = new EntityRelation(); + $relation->setFileId(7); + + $updatedRelation = new EntityRelation(); + $updatedRelation->setFileId(7); + $updatedRelation->setBases(['uuid-a']); + + $this->userSession->method('getUser')->willReturn($this->user); + $this->mapper->method('find')->willReturn($relation); + + $file = $this->createMock(File::class); + $file->method('isUpdateable')->willReturn(true); + $userFolder = $this->createMock(Folder::class); + $userFolder->method('getById')->willReturn([$file]); + $this->rootFolder->method('getUserFolder')->willReturn($userFolder); + + $this->request->method('getParams')->willReturn([ + 'id' => 42, // injected by the routing framework — controller strips it + '_route' => 'openregister.entityRelations.update', // ditto + 'bases' => ['uuid-a'], + ]); + + $this->mapper + ->expects($this->once()) + ->method('updateDecisionMetadata') + ->with( + $this->identicalTo($relation), + $this->equalTo(['bases' => ['uuid-a']]), + $this->identicalTo($this->user) + ) + ->willReturn($updatedRelation); + + $controller = $this->makeController(); + $response = $controller->update(42); + + $this->assertSame(Http::STATUS_OK, $response->getStatus()); + $body = $response->getData(); + $this->assertSame(['uuid-a'], $body['bases']); + } + + public function testReturns500OnUnexpectedException(): void + { + $relation = new EntityRelation(); + $relation->setFileId(7); + + $this->userSession->method('getUser')->willReturn($this->user); + $this->mapper->method('find')->willReturn($relation); + + $file = $this->createMock(File::class); + $file->method('isUpdateable')->willReturn(true); + $userFolder = $this->createMock(Folder::class); + $userFolder->method('getById')->willReturn([$file]); + $this->rootFolder->method('getUserFolder')->willReturn($userFolder); + + $this->request->method('getParams')->willReturn(['bases' => ['uuid-a']]); + $this->mapper + ->method('updateDecisionMetadata') + ->willThrowException(new \RuntimeException('boom')); + + $controller = $this->makeController(); + $response = $controller->update(42); + + $this->assertSame(Http::STATUS_INTERNAL_SERVER_ERROR, $response->getStatus()); + } +} diff --git a/tests/Unit/Db/EntityRelationMapperTest.php b/tests/Unit/Db/EntityRelationMapperTest.php new file mode 100644 index 000000000000..23a02dcec47a --- /dev/null +++ b/tests/Unit/Db/EntityRelationMapperTest.php @@ -0,0 +1,50 @@ +db = $this->createMock(IDBConnection::class); + $this->auditTrailMapper = $this->createMock(AuditTrailMapper::class); + $this->userSession = $this->createMock(IUserSession::class); + $this->logger = $this->createMock(LoggerInterface::class); + } + + public function testConstructsWithInjectedDependencies(): void + { + $mapper = new EntityRelationMapper( + $this->db, + $this->auditTrailMapper, + $this->userSession, + $this->logger + ); + + $this->assertInstanceOf(EntityRelationMapper::class, $mapper); + } +} diff --git a/tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php b/tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php new file mode 100644 index 000000000000..9a389eb81439 --- /dev/null +++ b/tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php @@ -0,0 +1,315 @@ +db = $this->createMock(IDBConnection::class); + $this->auditTrailMapper = $this->createMock(AuditTrailMapper::class); + $this->userSession = $this->createMock(IUserSession::class); + $this->logger = $this->createMock(LoggerInterface::class); + $this->user = $this->createMock(IUser::class); + + $this->user->method('getUID')->willReturn('alice'); + $this->user->method('getDisplayName')->willReturn('Alice'); + } + + /** + * Build a mapper with `update()` (the only concrete inherited write method) mocked. + */ + private function mapperWithMockedUpdate(): EntityRelationMapper&MockObject + { + $mapper = $this->getMockBuilder(EntityRelationMapper::class) + ->setConstructorArgs([ + $this->db, + $this->auditTrailMapper, + $this->userSession, + $this->logger, + ]) + ->onlyMethods(['update']) + ->getMock(); + + $mapper->method('update')->willReturnArgument(0); + + return $mapper; + } + + public function testRejectsUnknownField(): void + { + $relation = new EntityRelation(); + $mapper = $this->mapperWithMockedUpdate(); + + $this->auditTrailMapper->expects($this->never())->method('insert'); + + $this->expectException(CustomValidationException::class); + $this->expectExceptionMessageMatches('/anonymized/'); + + $mapper->updateDecisionMetadata(relation: $relation, fields: ['anonymized' => true], actingUser: $this->user); + } + + public function testRejectsBasesAsNonArray(): void + { + $relation = new EntityRelation(); + $mapper = $this->mapperWithMockedUpdate(); + + $this->auditTrailMapper->expects($this->never())->method('insert'); + + $this->expectException(CustomValidationException::class); + $this->expectExceptionMessageMatches('/bases shape/'); + + $mapper->updateDecisionMetadata(relation: $relation, fields: ['bases' => 'uuid-a'], actingUser: $this->user); + } + + public function testRejectsBasesArrayWithNonStringElement(): void + { + $relation = new EntityRelation(); + $mapper = $this->mapperWithMockedUpdate(); + + $this->expectException(CustomValidationException::class); + $this->expectExceptionMessageMatches('/bases shape/'); + + $mapper->updateDecisionMetadata(relation: $relation, fields: ['bases' => ['uuid-a', 42]], actingUser: $this->user); + } + + public function testRejectsSkipAnonymizationAsNonBool(): void + { + $relation = new EntityRelation(); + $mapper = $this->mapperWithMockedUpdate(); + + $this->expectException(CustomValidationException::class); + $this->expectExceptionMessageMatches('/skipAnonymization shape/'); + + $mapper->updateDecisionMetadata(relation: $relation, fields: ['skipAnonymization' => 'yes'], actingUser: $this->user); + } + + public function testSemanticNoOpSkipsAuditEmission(): void + { + $relation = new EntityRelation(); + $relation->setBases(['uuid-a']); + $relation->setSkipAnonymization(true); + + $mapper = $this->mapperWithMockedUpdate(); + $mapper->expects($this->never())->method('update'); + $this->auditTrailMapper->expects($this->never())->method('insert'); + + $result = $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['bases' => ['uuid-a'], 'skipAnonymization' => true], + actingUser: $this->user + ); + + $this->assertSame(['uuid-a'], $result->getBases()); + $this->assertTrue($result->getSkipAnonymization()); + } + + public function testEmptyBodyIsNoOp(): void + { + $relation = new EntityRelation(); + $mapper = $this->mapperWithMockedUpdate(); + + $mapper->expects($this->never())->method('update'); + $this->auditTrailMapper->expects($this->never())->method('insert'); + + $result = $mapper->updateDecisionMetadata(relation: $relation, fields: [], actingUser: $this->user); + + $this->assertNull($result->getBases()); + $this->assertFalse($result->getSkipAnonymization()); + } + + public function testSettingBasesForFirstTimeEmitsAuditEntry(): void + { + $relation = new EntityRelation(); + $relation->setId(42); + $mapper = $this->mapperWithMockedUpdate(); + + $captured = null; + $this->auditTrailMapper + ->expects($this->once()) + ->method('insert') + ->willReturnCallback(function (AuditTrail $entry) use (&$captured) { + $captured = $entry; + return $entry; + }); + + $mapper->expects($this->once())->method('update'); + + $result = $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['bases' => ['uuid-a']], + actingUser: $this->user + ); + + $this->assertSame(['uuid-a'], $result->getBases()); + + $this->assertNotNull($captured); + $this->assertSame('entity_relation_decision_updated', $captured->getAction()); + $this->assertSame('alice', $captured->getUser()); + + $changed = $captured->getChanged(); + $this->assertSame('openregister_entity_relations', $changed['subjectType']); + $this->assertSame(42, $changed['subjectId']); + $this->assertArrayHasKey('bases', $changed['fields']); + $this->assertSame(['previous' => null, 'new' => ['uuid-a']], $changed['fields']['bases']); + $this->assertArrayNotHasKey('skipAnonymization', $changed['fields']); + } + + public function testFlippingSkipEmitsAuditEntry(): void + { + $relation = new EntityRelation(); + $relation->setId(7); + $relation->setSkipAnonymization(false); + + $mapper = $this->mapperWithMockedUpdate(); + + $captured = null; + $this->auditTrailMapper + ->expects($this->once()) + ->method('insert') + ->willReturnCallback(function (AuditTrail $entry) use (&$captured) { + $captured = $entry; + return $entry; + }); + + $result = $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['skipAnonymization' => true], + actingUser: $this->user + ); + + $this->assertTrue($result->getSkipAnonymization()); + $this->assertNotNull($captured); + $changed = $captured->getChanged(); + $this->assertSame(['previous' => false, 'new' => true], $changed['fields']['skipAnonymization']); + $this->assertArrayNotHasKey('bases', $changed['fields']); + } + + public function testPartialChangeOnlyAuditsTheChangedField(): void + { + $relation = new EntityRelation(); + $relation->setId(42); + $relation->setBases(['uuid-a']); + $relation->setSkipAnonymization(false); + + $mapper = $this->mapperWithMockedUpdate(); + + $captured = null; + $this->auditTrailMapper + ->expects($this->once()) + ->method('insert') + ->willReturnCallback(function (AuditTrail $entry) use (&$captured) { + $captured = $entry; + return $entry; + }); + + $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['bases' => ['uuid-a'], 'skipAnonymization' => true], + actingUser: $this->user + ); + + $this->assertNotNull($captured); + $changed = $captured->getChanged(); + $this->assertArrayNotHasKey('bases', $changed['fields']); + $this->assertSame(['previous' => false, 'new' => true], $changed['fields']['skipAnonymization']); + } + + public function testAuditEmissionFailureDoesNotMaskUpdate(): void + { + $relation = new EntityRelation(); + $relation->setId(42); + $mapper = $this->mapperWithMockedUpdate(); + + $this->auditTrailMapper + ->method('insert') + ->willThrowException(new \RuntimeException('audit storage broken')); + + $this->logger->expects($this->atLeastOnce())->method('error'); + + // Despite the audit-write throwing, the row update must still + // succeed and the method must return the updated relation. + $result = $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['skipAnonymization' => true], + actingUser: $this->user + ); + + $this->assertTrue($result->getSkipAnonymization()); + } + + public function testFallsBackToSessionUserWhenActingUserIsNull(): void + { + $relation = new EntityRelation(); + $relation->setId(42); + $mapper = $this->mapperWithMockedUpdate(); + + $this->userSession->method('getUser')->willReturn($this->user); + + $captured = null; + $this->auditTrailMapper + ->expects($this->once()) + ->method('insert') + ->willReturnCallback(function (AuditTrail $entry) use (&$captured) { + $captured = $entry; + return $entry; + }); + + $mapper->updateDecisionMetadata(relation: $relation, fields: ['skipAnonymization' => true]); + + $this->assertNotNull($captured); + $this->assertSame('alice', $captured->getUser()); + } + + public function testRecordsSystemActorWhenNoUserIsAvailable(): void + { + $relation = new EntityRelation(); + $relation->setId(42); + $mapper = $this->mapperWithMockedUpdate(); + + $this->userSession->method('getUser')->willReturn(null); + + $captured = null; + $this->auditTrailMapper + ->expects($this->once()) + ->method('insert') + ->willReturnCallback(function (AuditTrail $entry) use (&$captured) { + $captured = $entry; + return $entry; + }); + + $mapper->updateDecisionMetadata(relation: $relation, fields: ['skipAnonymization' => true]); + + $this->assertNotNull($captured); + $this->assertSame('system', $captured->getUser()); + } +} diff --git a/tests/Unit/Db/EntityRelationTest.php b/tests/Unit/Db/EntityRelationTest.php index 833518f4adc7..1c46a73c4e48 100644 --- a/tests/Unit/Db/EntityRelationTest.php +++ b/tests/Unit/Db/EntityRelationTest.php @@ -32,6 +32,8 @@ public function testConstructorRegistersFieldTypes(): void $this->assertSame('string', $fieldTypes['context']); $this->assertSame('boolean', $fieldTypes['anonymized']); $this->assertSame('string', $fieldTypes['anonymizedValue']); + $this->assertSame('json', $fieldTypes['bases']); + $this->assertSame('boolean', $fieldTypes['skipAnonymization']); $this->assertSame('datetime', $fieldTypes['createdAt']); } @@ -50,9 +52,34 @@ public function testConstructorDefaultValues(): void $this->assertNull($this->relation->getContext()); $this->assertFalse($this->relation->getAnonymized()); $this->assertNull($this->relation->getAnonymizedValue()); + $this->assertNull($this->relation->getBases()); + $this->assertFalse($this->relation->getSkipAnonymization()); $this->assertNull($this->relation->getCreatedAt()); } + public function testSetAndGetBasesRoundTrip(): void + { + $this->relation->setBases(['uuid-a', 'uuid-b']); + $this->assertSame(['uuid-a', 'uuid-b'], $this->relation->getBases()); + } + + public function testBasesEmptyArrayDistinctFromNull(): void + { + $this->relation->setBases([]); + $bases = $this->relation->getBases(); + $this->assertNotNull($bases); + $this->assertSame([], $bases); + } + + public function testSetAndGetSkipAnonymization(): void + { + $this->relation->setSkipAnonymization(true); + $this->assertTrue($this->relation->getSkipAnonymization()); + + $this->relation->setSkipAnonymization(false); + $this->assertFalse($this->relation->getSkipAnonymization()); + } + public function testSetAndGetIntegerFields(): void { $this->relation->setEntityId(1); @@ -118,7 +145,7 @@ public function testJsonSerialize(): void 'id', 'entityId', 'chunkId', 'role', 'fileId', 'objectId', 'emailId', 'positionStart', 'positionEnd', 'confidence', 'detectionMethod', 'context', 'anonymized', 'anonymizedValue', - 'createdAt', + 'bases', 'skipAnonymization', 'createdAt', ]; foreach ($expectedKeys as $key) { $this->assertArrayHasKey($key, $json); From 88e3d0c9282818dfcccfc2fc9cbeffede83f8b74 Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Fri, 15 May 2026 10:59:20 +0200 Subject: [PATCH 007/333] feat(entity-relation-grondslagen): dispatch EntityRelationDecisionUpdatedEvent MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds a post-commit, informational Symfony event fired from EntityRelationMapper::updateDecisionMetadata after the row update and audit-trail entry have both succeeded. Enables downstream apps to react to operator decisions on individual entity relations without polling — the immediate consumer is DocuDesk's publication-clearance-via-anonymise change, which subscribes to the event and creates a publicationConsent record the moment skipAnonymization flips false → true. That moves the Woo 28-day clock to decision time instead of anonymise time, avoiding the 422-on-first-anonymise-attempt UX trap that would otherwise hit every entity needing the standard WOO workflow. Event carries the post-update EntityRelation, the per-field diff (same shape as the audit-trail's changedFields payload), and the acting IUser (or null when no session user). A convenience helper isSkipAnonymizationActivated() encapsulates the most common listener trigger. Failure isolation: listener throws don't mask the persisted state change or the audit entry — wrapped in try/catch, logged at error level, method continues. Same contract as the existing audit-emission isolation. Not vetoable. Pre-commit cancelable events were considered and rejected — they would couple downstream apps tightly to OR's persistence semantics. The DocuDesk consumer handles policy rejection on its own write path (reverse the PATCH + emit operator notification), which keeps OR a clean primitive. Spec amendment in design.md §D6a + tasks.md item 3.2a documents the contract. Tests cover: dispatch on skipAnonymization flip, dispatch on bases change, no dispatch on semantic no-op, dispatch failure isolation. Pre-existing PHPCS debt on tests/Unit/Db/ is out of scope for this commit (98 errors baseline on the existing UpdateDecisionMetadataTest predate this change). --- lib/Db/EntityRelationMapper.php | 33 +++++ .../EntityRelationDecisionUpdatedEvent.php | 125 ++++++++++++++++++ .../entity-relation-grondslagen/design.md | 22 +++ .../entity-relation-grondslagen/tasks.md | 1 + tests/Unit/Db/EntityRelationMapperTest.php | 12 +- ...lationMapperUpdateDecisionMetadataTest.php | 106 +++++++++++++++ 6 files changed, 295 insertions(+), 4 deletions(-) create mode 100644 lib/Event/EntityRelationDecisionUpdatedEvent.php diff --git a/lib/Db/EntityRelationMapper.php b/lib/Db/EntityRelationMapper.php index 0262c7937664..26a5fd7720a8 100644 --- a/lib/Db/EntityRelationMapper.php +++ b/lib/Db/EntityRelationMapper.php @@ -18,10 +18,12 @@ namespace OCA\OpenRegister\Db; use DateTime; +use OCA\OpenRegister\Event\EntityRelationDecisionUpdatedEvent; use OCA\OpenRegister\Exception\CustomValidationException; use OCP\AppFramework\Db\Entity; use OCP\AppFramework\Db\QBMapper; use OCP\DB\QueryBuilder\IQueryBuilder; +use OCP\EventDispatcher\IEventDispatcher; use OCP\IDBConnection; use OCP\IUser; use OCP\IUserSession; @@ -49,12 +51,15 @@ class EntityRelationMapper extends QBMapper * @param IDBConnection $db Database connection. * @param AuditTrailMapper $auditTrailMapper Audit-trail persistence (used by updateDecisionMetadata). * @param IUserSession $userSession Session user lookup for audit-trail actor. + * @param IEventDispatcher $eventDispatcher Symfony event dispatcher (used by updateDecisionMetadata + * to notify listeners after a decision-metadata write). * @param LoggerInterface $logger Structured log sink. */ public function __construct( IDBConnection $db, private readonly AuditTrailMapper $auditTrailMapper, private readonly IUserSession $userSession, + private readonly IEventDispatcher $eventDispatcher, private readonly LoggerInterface $logger, ) { parent::__construct(db: $db, tableName: 'openregister_entity_relations', entityClass: EntityRelation::class); @@ -385,6 +390,34 @@ public function updateDecisionMetadata(EntityRelation $relation, array $fields, ); }//end try + // Notify listeners (downstream apps — e.g. DocuDesk's + // publication-clearance-via-anonymise change subscribes here to + // create a publicationConsent record whenever skipAnonymization + // flips false → true, so the 28-day Woo clock starts ticking at + // decision time rather than at anonymise time). Failure to + // dispatch / listener failure MUST NOT roll back the persisted + // state change — log and continue, same contract as audit. + try { + $this->eventDispatcher->dispatchTyped( + new EntityRelationDecisionUpdatedEvent( + relation: $relation, + changedFields: $changedFields, + actingUser: ($actingUser ?? $this->userSession->getUser()) + ) + ); + } catch (\Throwable $dispatchError) { + $this->logger->error( + message: '[EntityRelationMapper] Failed to dispatch EntityRelationDecisionUpdatedEvent', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'relation_id' => $relationId, + 'changedKeys' => array_keys($changedFields), + 'error' => $dispatchError->getMessage(), + ] + ); + }//end try + return $relation; }//end updateDecisionMetadata() diff --git a/lib/Event/EntityRelationDecisionUpdatedEvent.php b/lib/Event/EntityRelationDecisionUpdatedEvent.php new file mode 100644 index 000000000000..a013b82d28a6 --- /dev/null +++ b/lib/Event/EntityRelationDecisionUpdatedEvent.php @@ -0,0 +1,125 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @version GIT: + * + * @link https://OpenRegister.app + */ + +namespace OCA\OpenRegister\Event; + +use OCA\OpenRegister\Db\EntityRelation; +use OCP\EventDispatcher\Event; +use OCP\IUser; + +/** + * Event dispatched after an EntityRelation's decision metadata is updated. + * + * Post-commit, informational. Not vetoable. Listeners that need to + * mutate state in response (e.g. reverse the PATCH on prohibition match) + * MUST do so via a separate write — the original write has already landed. + */ +class EntityRelationDecisionUpdatedEvent extends Event +{ + /** + * Constructor. + * + * @param EntityRelation $relation The relation row in its post-update state. + * @param array $changedFields Per-field diff + * (only keys that actually changed). + * @param IUser|null $actingUser The user who performed the change, or null + * when the change was driven by a + * non-session actor (background job, + * system). + */ + public function __construct( + private readonly EntityRelation $relation, + private readonly array $changedFields, + private readonly ?IUser $actingUser + ) { + parent::__construct(); + + }//end __construct() + + /** + * Get the post-update relation row. + * + * @return EntityRelation + */ + public function getRelation(): EntityRelation + { + return $this->relation; + + }//end getRelation() + + /** + * Get the per-field diff for the change. + * + * Shape: `{ fieldName: { previous: , new: } }`. Keys + * are limited to `bases` and `skipAnonymization` per the + * `updateDecisionMetadata` whitelist. Only fields whose value actually + * changed appear — listeners checking for a specific transition + * (e.g. `skipAnonymization: false → true`) can rely on the key's + * presence + `previous` / `new` values without re-deriving. + * + * @return array + */ + public function getChangedFields(): array + { + return $this->changedFields; + + }//end getChangedFields() + + /** + * Get the acting user, or null when the change had no session user. + * + * Listeners that need to attribute downstream effects (audit, consent + * record acting-user) should call this. When null, downstream callers + * record the actor as 'system'. + * + * @return IUser|null + */ + public function getActingUser(): ?IUser + { + return $this->actingUser; + + }//end getActingUser() + + /** + * Convenience: true when `skipAnonymization` was flipped from false to true + * by this change. Encapsulates the most common listener trigger so each + * consumer doesn't reimplement the same check. + * + * @return bool + */ + public function isSkipAnonymizationActivated(): bool + { + if (array_key_exists('skipAnonymization', $this->changedFields) === false) { + return false; + } + + $diff = $this->changedFields['skipAnonymization']; + return ($diff['previous'] ?? null) === false && ($diff['new'] ?? null) === true; + + }//end isSkipAnonymizationActivated() +}//end class diff --git a/openspec/changes/entity-relation-grondslagen/design.md b/openspec/changes/entity-relation-grondslagen/design.md index a1f9f771f454..dacb42ba13b9 100644 --- a/openspec/changes/entity-relation-grondslagen/design.md +++ b/openspec/changes/entity-relation-grondslagen/design.md @@ -195,6 +195,28 @@ Only fields that actually changed appear under `changedFields`. If the caller PA Reads MUST NOT produce audit entries — applies to all relation reads in the codebase (mapper find, controller GET, downstream consumers). +### D6a. Event dispatch for downstream listeners (`EntityRelationDecisionUpdatedEvent`) + +After the audit-trail entry is persisted, `updateDecisionMetadata` also dispatches a Symfony event so downstream apps can react to operator decisions without polling. The event carries the same diff payload as the audit entry, plus the post-update `EntityRelation` instance and the acting `IUser` (or null when no session user). + +``` +class EntityRelationDecisionUpdatedEvent extends Event { + getRelation(): EntityRelation + getChangedFields(): array + getActingUser(): ?IUser + isSkipAnonymizationActivated(): bool // convenience: false → true flip +} +``` + +**Contract:** + +- **Post-commit, informational.** Fires *after* the row update + audit-trail entry have both succeeded. Listeners see the persisted state. The event is NOT vetoable — listeners that need to react (e.g. by reversing the PATCH on policy-rejection) MUST do so via a separate write. +- **Diff payload identical to the audit entry's `changedFields`** — same keys (`bases`, `skipAnonymization`), same `{previous, new}` shape. Only fields that actually changed appear. Semantic no-ops do not dispatch. +- **Acting user resolution.** Mirrors the audit entry: explicit `$actingUser` parameter takes precedence over `$userSession->getUser()`. Listeners that attribute downstream effects to an actor should use the event's `getActingUser()` and apply the same "null → system" convention used in the audit subsystem. +- **Failure isolation.** A listener throwing MUST NOT mask the row update or the audit entry. The dispatcher call is wrapped in `try/catch`; failures are logged at error level with the relation id + changed keys, and the method continues to return the updated relation. + +**Why post-commit, not pre-commit-vetoable.** Vetoable pre-events (in the `ObjectCreatingEvent` / `ObjectDeletingEvent` style) couple downstream apps tightly to OR's persistence semantics. The intended downstream consumer (DocuDesk's `publication-clearance-via-anonymise`) handles policy rejection by reversing the PATCH on its own write path — the operator UX surfaces the rejection via a notification, not via a synchronous HTTP failure on the PATCH itself. Keeping the event informational keeps OR as a clean primitive. + ### D7. Authorization: write-access to the relation's parent file/object PATCH requires that the acting user can **write** to the file or object referenced by the relation (`fileId`, `objectId`, etc.). This mirrors the implicit check that `FileTextController::anonymizeFile` inherits today: anonymising a file requires write-access to the file, so flipping `anonymized=true` on the relations under that file requires the same. diff --git a/openspec/changes/entity-relation-grondslagen/tasks.md b/openspec/changes/entity-relation-grondslagen/tasks.md index 035fd0fc1544..ad68f984b6e1 100644 --- a/openspec/changes/entity-relation-grondslagen/tasks.md +++ b/openspec/changes/entity-relation-grondslagen/tasks.md @@ -32,6 +32,7 @@ - `actor`: `$actingUser?->getUID()` if provided, else the session-derived UID (per ADR-005, the UID — NOT the display name). - `timestamp`: an ISO-8601 datetime. - `changedFields`: object whose keys are only the fields that ACTUALLY changed; each value `{ previous: , new: }`. Fields submitted with values matching current state MUST NOT appear. +- [ ] 3.2a Add `lib/Event/EntityRelationDecisionUpdatedEvent.php` (NEW). Post-commit, informational Symfony event. Constructor takes `EntityRelation`, `array $changedFields`, `?IUser $actingUser`. Exposes `getRelation()`, `getChangedFields()`, `getActingUser()`, plus convenience `isSkipAnonymizationActivated(): bool` covering the most common listener trigger (false → true flip). Inject `IEventDispatcher` into `EntityRelationMapper` and dispatch the event right after `emitDecisionMetadataAuditEntry`, inside its own `try/catch` — listener failures MUST NOT mask the persisted state change (same isolation as audit). See `design.md` §D6a for the contract. - [ ] 3.3 Add `lib/Controller/EntityRelationsController.php` (NEW). Single method: `update(int $id)` mapped to PATCH. Behaviour: - `@NoAdminRequired`. - Read the JSON body via the standard Nextcloud controller `$this->request->getParams()` pattern. diff --git a/tests/Unit/Db/EntityRelationMapperTest.php b/tests/Unit/Db/EntityRelationMapperTest.php index 23a02dcec47a..4fecf505608b 100644 --- a/tests/Unit/Db/EntityRelationMapperTest.php +++ b/tests/Unit/Db/EntityRelationMapperTest.php @@ -6,6 +6,7 @@ use OCA\OpenRegister\Db\AuditTrailMapper; use OCA\OpenRegister\Db\EntityRelationMapper; +use OCP\EventDispatcher\IEventDispatcher; use OCP\IDBConnection; use OCP\IUserSession; use PHPUnit\Framework\MockObject\MockObject; @@ -16,16 +17,17 @@ * Lightweight construction-and-wiring test for `EntityRelationMapper`. * * Verifies the mapper instantiates with its DI dependencies (which now - * include `AuditTrailMapper`, `IUserSession`, and `LoggerInterface` per - * the `entity-relation-grondslagen` change). DB-heavy query behaviour - * is covered by integration tests; the audited write path's logic is - * covered by `EntityRelationMapperUpdateDecisionMetadataTest`. + * include `AuditTrailMapper`, `IUserSession`, `IEventDispatcher`, and + * `LoggerInterface` per the `entity-relation-grondslagen` change). + * DB-heavy query behaviour is covered by integration tests; the audited + * write path's logic is covered by `EntityRelationMapperUpdateDecisionMetadataTest`. */ class EntityRelationMapperTest extends TestCase { private IDBConnection&MockObject $db; private AuditTrailMapper&MockObject $auditTrailMapper; private IUserSession&MockObject $userSession; + private IEventDispatcher&MockObject $eventDispatcher; private LoggerInterface&MockObject $logger; protected function setUp(): void @@ -33,6 +35,7 @@ protected function setUp(): void $this->db = $this->createMock(IDBConnection::class); $this->auditTrailMapper = $this->createMock(AuditTrailMapper::class); $this->userSession = $this->createMock(IUserSession::class); + $this->eventDispatcher = $this->createMock(IEventDispatcher::class); $this->logger = $this->createMock(LoggerInterface::class); } @@ -42,6 +45,7 @@ public function testConstructsWithInjectedDependencies(): void $this->db, $this->auditTrailMapper, $this->userSession, + $this->eventDispatcher, $this->logger ); diff --git a/tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php b/tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php index 9a389eb81439..d22e1b69e963 100644 --- a/tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php +++ b/tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php @@ -8,7 +8,9 @@ use OCA\OpenRegister\Db\AuditTrailMapper; use OCA\OpenRegister\Db\EntityRelation; use OCA\OpenRegister\Db\EntityRelationMapper; +use OCA\OpenRegister\Event\EntityRelationDecisionUpdatedEvent; use OCA\OpenRegister\Exception\CustomValidationException; +use OCP\EventDispatcher\IEventDispatcher; use OCP\IDBConnection; use OCP\IUser; use OCP\IUserSession; @@ -30,6 +32,7 @@ class EntityRelationMapperUpdateDecisionMetadataTest extends TestCase private IDBConnection&MockObject $db; private AuditTrailMapper&MockObject $auditTrailMapper; private IUserSession&MockObject $userSession; + private IEventDispatcher&MockObject $eventDispatcher; private LoggerInterface&MockObject $logger; private IUser&MockObject $user; @@ -38,6 +41,7 @@ protected function setUp(): void $this->db = $this->createMock(IDBConnection::class); $this->auditTrailMapper = $this->createMock(AuditTrailMapper::class); $this->userSession = $this->createMock(IUserSession::class); + $this->eventDispatcher = $this->createMock(IEventDispatcher::class); $this->logger = $this->createMock(LoggerInterface::class); $this->user = $this->createMock(IUser::class); @@ -55,6 +59,7 @@ private function mapperWithMockedUpdate(): EntityRelationMapper&MockObject $this->db, $this->auditTrailMapper, $this->userSession, + $this->eventDispatcher, $this->logger, ]) ->onlyMethods(['update']) @@ -312,4 +317,105 @@ public function testRecordsSystemActorWhenNoUserIsAvailable(): void $this->assertNotNull($captured); $this->assertSame('system', $captured->getUser()); } + + public function testDispatchesEventOnSkipAnonymizationFlip(): void + { + $relation = new EntityRelation(); + $relation->setId(99); + $relation->setSkipAnonymization(false); + + $mapper = $this->mapperWithMockedUpdate(); + + $captured = null; + $this->eventDispatcher + ->expects($this->once()) + ->method('dispatchTyped') + ->willReturnCallback(function (EntityRelationDecisionUpdatedEvent $event) use (&$captured) { + $captured = $event; + }); + + $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['skipAnonymization' => true], + actingUser: $this->user + ); + + $this->assertNotNull($captured); + $this->assertSame(99, $captured->getRelation()->getId()); + $this->assertTrue($captured->isSkipAnonymizationActivated()); + $this->assertSame($this->user, $captured->getActingUser()); + + $diff = $captured->getChangedFields(); + $this->assertArrayHasKey('skipAnonymization', $diff); + $this->assertSame(['previous' => false, 'new' => true], $diff['skipAnonymization']); + } + + public function testDispatchesEventOnBasesChange(): void + { + $relation = new EntityRelation(); + $relation->setId(7); + + $mapper = $this->mapperWithMockedUpdate(); + + $captured = null; + $this->eventDispatcher + ->expects($this->once()) + ->method('dispatchTyped') + ->willReturnCallback(function (EntityRelationDecisionUpdatedEvent $event) use (&$captured) { + $captured = $event; + }); + + $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['bases' => ['uuid-a']], + actingUser: $this->user + ); + + $this->assertNotNull($captured); + // bases change is NOT a skip-flip — the convenience helper must return false. + $this->assertFalse($captured->isSkipAnonymizationActivated()); + $diff = $captured->getChangedFields(); + $this->assertArrayHasKey('bases', $diff); + $this->assertSame(['previous' => null, 'new' => ['uuid-a']], $diff['bases']); + } + + public function testNoEventDispatchedOnSemanticNoOp(): void + { + $relation = new EntityRelation(); + $relation->setSkipAnonymization(true); + + $mapper = $this->mapperWithMockedUpdate(); + + $this->eventDispatcher->expects($this->never())->method('dispatchTyped'); + + $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['skipAnonymization' => true], + actingUser: $this->user + ); + } + + public function testDispatchFailureDoesNotMaskUpdate(): void + { + $relation = new EntityRelation(); + $relation->setId(42); + + $mapper = $this->mapperWithMockedUpdate(); + + $this->eventDispatcher + ->method('dispatchTyped') + ->willThrowException(new \RuntimeException('listener exploded')); + + $this->logger->expects($this->atLeastOnce())->method('error'); + + // Even though the dispatcher throws, the row update must still + // succeed and the method must return the updated relation. + $result = $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['skipAnonymization' => true], + actingUser: $this->user + ); + + $this->assertTrue($result->getSkipAnonymization()); + } } From a6b5afd5165a5297d6c37e3fdaed91afbe415ba1 Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Fri, 15 May 2026 11:44:24 +0200 Subject: [PATCH 008/333] feat(entity-relation-grondslagen): add findAnonymisedEntitiesWithBasesForFile MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds a second projected JOIN read method on EntityRelationMapper for the grondslagen-summary downstream renderer (DocuDesk's anonymisation-grondslagen-summary change). Differs from the existing findEntitiesForFile in two ways: 1. Filters to rows where r.anonymized = true — callers want the "what was actually redacted" set, not the "what was detected" set. 2. Selects r.bases, r.skip_anonymization, r.anonymized, r.anonymized_value so the renderer can produce a grondslagen-traceable audit page without an N+1 of find($id) calls. JSON-decodes the bases column into a PHP array on the way out, and normalises bool-as-int columns to actual booleans (some DB drivers return them as int). The existing findEntitiesForFile is unchanged — the anonymise pipeline doesn't need bases and shouldn't pay the cost of decoding them per row. No spec change beyond this addition being a natural extension of the Wave 1.3 read surface. tests/Unit/Db/EntityRelationMapperTest.php construction test continues to pass. --- lib/Db/EntityRelationMapper.php | 77 +++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) diff --git a/lib/Db/EntityRelationMapper.php b/lib/Db/EntityRelationMapper.php index 26a5fd7720a8..302f2835dd69 100644 --- a/lib/Db/EntityRelationMapper.php +++ b/lib/Db/EntityRelationMapper.php @@ -161,6 +161,83 @@ public function findEntitiesForFile(int $fileId): array return $entities; }//end findEntitiesForFile() + /** + * Find anonymised entity relations with the full decision-metadata + entity context for a file. + * + * Differs from {@see findEntitiesForFile} in two ways: + * + * 1. Filters to rows where `r.anonymized = true` — the caller wants + * the "what was actually redacted" set, not the "what was detected" set. + * 2. Selects `r.bases`, `r.skip_anonymization`, `r.anonymized`, + * `r.anonymized_value` so downstream renderers (DocuDesk's + * `anonymisation-grondslagen-summary` change) can produce a + * grondslagen-traceable audit page without an N+1 of `find($id)` + * calls. + * + * Returned rows are flat associative arrays. `bases` is JSON-decoded + * into an `array` (or null if the column is null in the DB). + * + * @param int $fileId The Nextcloud file ID. + * + * @return array> Rows shaped as + * `{relation_id, entity_id, position_start, position_end, confidence, + * entity_type, entity_value, category, bases (array|null), + * skip_anonymization (bool), anonymized (bool), anonymized_value (string|null)}`. + */ + public function findAnonymisedEntitiesWithBasesForFile(int $fileId): array + { + $qb = $this->db->getQueryBuilder(); + $qb->select( + 'r.id as relation_id', + 'r.entity_id', + 'r.position_start', + 'r.position_end', + 'r.confidence', + 'r.bases', + 'r.skip_anonymization', + 'r.anonymized', + 'r.anonymized_value', + 'e.type as entity_type', + 'e.value as entity_value', + 'e.category' + ) + ->from($this->getTableName(), 'r') + ->innerJoin('r', 'openregister_entities', 'e', $qb->expr()->eq('r.entity_id', 'e.id')) + ->where( + $qb->expr()->andX( + $qb->expr()->eq('r.file_id', $qb->createNamedParameter($fileId, IQueryBuilder::PARAM_INT)), + $qb->expr()->eq('r.anonymized', $qb->createNamedParameter(true, IQueryBuilder::PARAM_BOOL)) + ) + ) + ->orderBy('r.position_start', 'ASC'); + + $result = $qb->executeQuery(); + $rows = $result->fetchAll(); + $result->closeCursor(); + + // Decode the JSON `bases` column. Doctrine returns it as a string; + // callers expect an array (or null when no bases were recorded). + foreach ($rows as &$row) { + if (isset($row['bases']) === true && is_string($row['bases']) === true) { + $decoded = json_decode($row['bases'], associative: true); + $row['bases'] = is_array($decoded) === true ? $decoded : null; + } + + // Normalise boolean-as-int values returned by some DB drivers. + if (isset($row['skip_anonymization']) === true) { + $row['skip_anonymization'] = (bool) $row['skip_anonymization']; + } + + if (isset($row['anonymized']) === true) { + $row['anonymized'] = (bool) $row['anonymized']; + } + } + + unset($row); + + return $rows; + }//end findAnonymisedEntitiesWithBasesForFile() + /** * Mark entity relations as anonymized. * From 8385f6a4d30e62a91667f04db1d6196556205a8d Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Fri, 15 May 2026 16:29:10 +0200 Subject: [PATCH 009/333] fix(entity-relation-grondslagen): address PR #1503 review (blockers + significant) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Addresses the OR #1503 review on the entity-relation decision-metadata PATCH endpoint. Four blockers (minus the Newman one — see PR comment), five significant items, and the minor CHANGELOG/migration cleanups. **Blockers:** - **ADR-005 audit actor.** `EntityRelationMapper::emitDecisionMetadataAuditEntry` no longer persists `$user->getDisplayName()` on the audit-trail entry's `userName` column (PII). Audit entries now record only the UID; the display name is dropped. - **Auth bypass on PATCH /api/entity-relations/{id}.** Object-bound and email-bound relations no longer fall through with an accept-with-warning log. The controller now constructor-injects `PermissionHandler`, `MagicMapper`, `SchemaMapper`, `RegisterMapper`, and `EmailLinkMapper`, then routes object-bound relations through `PermissionHandler::hasPermission(schema, 'update', uid, owner, object)` — the same verdict OR uses everywhere else for object writes — and routes email-bound relations through their parent ObjectEntity via the EmailLink. Email links without a parent object are denied. `fileId = 0` / `objectId = 0` / `emailId = 0` no longer satisfy the file branch. Adds `EmailLinkMapper::find(int $id)`. - **`@NoCSRFRequired`.** Removed from `EntityRelationsController::update`. This is a browser-facing decision-time PATCH; Nextcloud's session-CSRF protection MUST stay on. Spec amended (D7) to record the decision. **Significant items:** - **Order-sensitive `bases` diff.** New private `EntityRelationMapper::basesAreEqual(?array, ?array): bool` does multiset equality (sort + unique). `['a', 'b']` vs `['b', 'a']` is now a semantic no-op and produces no audit entry. `null` vs `[]` remains distinct. Storage preserves operator-supplied order; only the diff check normalises. - **`getParams()` content-type sensitivity.** `update()` rejects requests whose Content-Type is anything other than `application/json` (or empty) with HTTP 415, so the PATCH never depends on body-parser heuristics for the decision-time mutation. - **Non-transactional audit write.** Row UPDATE + audit-trail INSERT now run inside a single `$db->beginTransaction()` / `commit()` / `rollBack()`. An audit failure rolls back the UPDATE and surfaces as HTTP 500 — clients never observe a persisted decision-metadata change without a matching audit entry. The downstream event dispatch stays OUTSIDE the transaction (post-commit, informational; listener failures still don't roll back). Test `testAuditEmissionFailureRollsBackUpdateAndThrows` updates the contract. - **`fileId = 0` bypass.** Closed by adding `> 0` guards on `fileId`, `objectId`, `emailId` in the authz dispatch helper. - **`tasks.md` 3.2a + companions checked.** Items 1.1–1.3, 2.1–2.6, 3.1–3.8 marked `[x]` to reflect what landed in this PR. **Minor items:** - **Test copyright headers.** Added SPDX + Conduction headers to `EntityRelationsControllerTest`, `EntityRelationMapperTest`, `EntityRelationMapperUpdateDecisionMetadataTest`, `EntityRelationTest` (also fixed the latter's `namespace Unit\Db` typo). - **CHANGELOG signature.** Corrected the `updateDecisionMetadata` signature in the Unreleased entry from `int $id` to `EntityRelation $relation` and noted the transactional contract + multiset `bases` diff. - **Migration `postSchemaChange()` comment.** Documented why `Version1Date20260512120000` intentionally does not override `postSchemaChange` (nullable column + DB-level default; no backfill). **Spec.** `design.md` §D6 now records the transactional audit-invariant + multiset `bases` equality; §D7 documents the authz wiring (file → `isUpdateable`; object → `PermissionHandler`; email → parent object via `EmailLink`) and the `@NoCSRFRequired` removal rationale. **Tests.** 44 tests / 160 assertions across the four mapper + controller suites pass. New cases: - multiset bases equality (reordered, duplicates, null-vs-empty). - audit-failure rolls back update and rethrows. - 403 on object-bound when `hasPermission` denies. - 200 on object-bound when `hasPermission` grants. - 403 on email-bound when EmailLink has no parent object. - 403 on a relation with no subject (fileId/objectId/emailId all unset). **Newman.** The reviewer's diagnosis (commit `b8949d17` broke Newman via missing `registerService` for autowiring) does not reproduce — see PR comment. Newman crud fails identically on `development` HEAD (`9d50f4360`, before this branch existed); the failures are HTTP 400 assertion errors, not "socket hang up". Autowiring works locally: `GET /api/entities/stats` (uses `GdprEntitiesController` which constructor-injects `EntityRelationMapper`) returns HTTP 200 with a valid payload. Speculative `registerService` block NOT added pending reviewer's exact failing collection + commit. --- CHANGELOG.md | 2 +- lib/Controller/EntityRelationsController.php | 306 +++++++++++++++--- lib/Db/EmailLinkMapper.php | 25 ++ lib/Db/EntityRelationMapper.php | 79 ++++- .../EntityRelationDecisionUpdatedEvent.php | 2 +- lib/Migration/Version1Date20260512120000.php | 7 + .../entity-relation-grondslagen/design.md | 12 +- .../entity-relation-grondslagen/tasks.md | 36 +-- .../EntityRelationsControllerTest.php | 214 ++++++++++-- tests/Unit/Db/EntityRelationMapperTest.php | 15 + ...lationMapperUpdateDecisionMetadataTest.php | 228 +++++++++---- tests/Unit/Db/EntityRelationTest.php | 19 +- 12 files changed, 763 insertions(+), 182 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3a935c1aa540..580f5240cb47 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,7 +4,7 @@ ### Added - **EML (`message/rfc822`) support in `TextExtractionService`.** Two output paths share an underlying `zbateson/mail-mime-parser` invocation: (1) a flat plain-text path used by `extractFile` for entity detection — header block (`From` / `To` / `Cc` / `Subject` / `Date`), blank line, body (`text/plain` preferred over `text/html`-stripped-to-text), attachments listed under `--- Attachment: ---` markers; nested EML attachments are inlined via recursive flattening; (2) a new public `TextExtractionService::parseEmlStructured(File): EmlStructure` that returns headers + `EmlBody` (`plainText`, `html`) + array of `EmlAttachment` (decoded binary bytes — not the base64 transport string — plus filename / MIME / inline / contentId / `nestedEml`). Recursion is capped at depth 3 (root = depth 0; deeper `message/rfc822` attachments expose an `EmlAttachment` shell with `nestedEml = null`). `parseEmlStructured` MUST throw `EmlParseException` on irrecoverable malformed input — consumers (notably DocuDesk's `eml-pdf-assembly`) drive their fallback paths via exception propagation. Non-UTF-8 body parts are transcoded via `mb_detect_encoding` + `mb_convert_encoding`. Filename resolution: `Content-Disposition` `filename` → `Content-Type` `name` → generated `attachment-` (1-indexed). Per ADR-005, parser-failure log lines are PII-sanitised — addresses, quoted strings, and angle-bracketed values are replaced with `` before logging. New dependency: `zbateson/mail-mime-parser:^3.0`. (`text-extraction-eml`) -- **`PATCH /api/entity-relations/{id}` — operator decision-metadata endpoint.** The `EntityRelation` row now carries two operator-decision fields: `bases` (nullable JSON array of UUIDs referencing legal grondslagen) and `skip_anonymization` (boolean, default false). The new endpoint accepts a JSON body with a strict whitelist of `{bases?, skipAnonymization?}` — any other key returns HTTP 400. A parallel DI method `EntityRelationMapper::updateDecisionMetadata(int $id, array $fields, ?IUser $actingUser = null)` provides the same contract for in-process callers (e.g. DocuDesk's anonymise flow). Successful writes that produce a non-empty diff emit one immutable audit-trail entry (ADR-022) capturing the acting user UID (per ADR-005, the UID — not the display name), timestamp, row identifier, and per-field previous → new values; semantic no-ops (PATCH with values identical to current state, or empty body) succeed with HTTP 200 and write no audit entry. The endpoint requires write-access to the relation's parent file/object — the same implicit check that `markAsAnonymized` inherits today — and is `@NoAdminRequired`. The post-hoc system fields `anonymized` and `anonymizedValue` are intentionally NOT in the whitelist; those record what the redaction code path actually did and remain writable only by `markAsAnonymized`. (`entity-relation-grondslagen`) +- **`PATCH /api/entity-relations/{id}` — operator decision-metadata endpoint.** The `EntityRelation` row now carries two operator-decision fields: `bases` (nullable JSON array of UUIDs referencing legal grondslagen) and `skip_anonymization` (boolean, default false). The new endpoint accepts a JSON body with a strict whitelist of `{bases?, skipAnonymization?}` — any other key returns HTTP 400. A parallel DI method `EntityRelationMapper::updateDecisionMetadata(EntityRelation $relation, array $fields, ?IUser $actingUser = null): EntityRelation` provides the same contract for in-process callers (e.g. DocuDesk's anonymise flow). The row UPDATE and audit-trail INSERT run inside a single DB transaction so an audit-INSERT failure rolls back the UPDATE and surfaces as HTTP 500 — clients never observe a persisted decision-metadata change without a matching audit entry. The `bases` diff is multiset-equal (order-insensitive, duplicates collapsed) so cosmetic reorderings do not produce spurious audit entries; `null` vs `[]` remains distinct. Successful writes that produce a non-empty diff emit one immutable audit-trail entry (ADR-022) capturing the acting user UID (per ADR-005, the UID — not the display name), timestamp, row identifier, and per-field previous → new values; semantic no-ops (PATCH with values identical to current state, or empty body) succeed with HTTP 200 and write no audit entry. The endpoint requires write-access to the relation's parent file/object — the same implicit check that `markAsAnonymized` inherits today — and is `@NoAdminRequired`. The post-hoc system fields `anonymized` and `anonymizedValue` are intentionally NOT in the whitelist; those record what the redaction code path actually did and remain writable only by `markAsAnonymized`. (`entity-relation-grondslagen`) ### Behaviour changes - **EML files that previously produced null / empty extracted-text now produce populated text.** Files with `mimetype: message/rfc822` are now extracted via the new EML pipeline rather than being silently skipped. The flat output is suitable for the existing entity-detection pipeline. Tenants that relied on EMLs being skipped (unlikely) need to revisit their downstream flows. Non-EML extractable attachments (PDF, DOCX, text within an EML) are listed by filename + MIME type only in v1 — inline text extraction for those types is deferred (the consumer-side `eml-pdf-assembly` handles rich rendering separately). (`text-extraction-eml`) diff --git a/lib/Controller/EntityRelationsController.php b/lib/Controller/EntityRelationsController.php index 4b7782ce955d..68f7dc266308 100644 --- a/lib/Controller/EntityRelationsController.php +++ b/lib/Controller/EntityRelationsController.php @@ -39,9 +39,14 @@ namespace OCA\OpenRegister\Controller; +use OCA\OpenRegister\Db\EmailLinkMapper; use OCA\OpenRegister\Db\EntityRelation; use OCA\OpenRegister\Db\EntityRelationMapper; +use OCA\OpenRegister\Db\MagicMapper; +use OCA\OpenRegister\Db\RegisterMapper; +use OCA\OpenRegister\Db\SchemaMapper; use OCA\OpenRegister\Exception\CustomValidationException; +use OCA\OpenRegister\Service\Object\PermissionHandler; use OCP\AppFramework\Controller; use OCP\AppFramework\Db\DoesNotExistException; use OCP\AppFramework\Http; @@ -65,6 +70,11 @@ class EntityRelationsController extends Controller * @param EntityRelationMapper $entityRelationMapper Relation mapper. * @param IUserSession $userSession Session user accessor. * @param IRootFolder $rootFolder Nextcloud root folder (for file lookups). + * @param PermissionHandler $permissionHandler RBAC verdict for object-bound relations. + * @param MagicMapper $magicMapper ObjectEntity loader (for object-bound authz). + * @param SchemaMapper $schemaMapper Schema loader (for hasPermission inputs). + * @param RegisterMapper $registerMapper Register loader (for object lookup disambiguation). + * @param EmailLinkMapper $emailLinkMapper EmailLink loader (for email-bound authz indirection). * @param LoggerInterface $logger Structured log sink. */ public function __construct( @@ -73,6 +83,11 @@ public function __construct( private readonly EntityRelationMapper $entityRelationMapper, private readonly IUserSession $userSession, private readonly IRootFolder $rootFolder, + private readonly PermissionHandler $permissionHandler, + private readonly MagicMapper $magicMapper, + private readonly SchemaMapper $schemaMapper, + private readonly RegisterMapper $registerMapper, + private readonly EmailLinkMapper $emailLinkMapper, private readonly LoggerInterface $logger, ) { parent::__construct(appName: $appName, request: $request); @@ -89,7 +104,6 @@ public function __construct( * @return JSONResponse Updated relation (200) or a structured error. * * @NoAdminRequired - * @NoCSRFRequired */ public function update(int $id): JSONResponse { @@ -126,6 +140,24 @@ public function update(int $id): JSONResponse ); } + // Require explicit application/json — anything else and Nextcloud's + // body parser may silently drop unknown content-types or coerce + // form-encoded array values inconsistently. Decision-time + // mutations on legal grondslagen must not depend on content-type + // heuristics; clients send JSON or get 415. + $contentType = (string) $this->request->getHeader('Content-Type'); + // Strip any trailing parameters (charset, boundary, etc.). + $mediaType = strtolower(trim(explode(';', $contentType, 2)[0])); + if ($mediaType !== 'application/json' && $mediaType !== '') { + return new JSONResponse( + data: [ + 'error' => 'unsupported_media_type', + 'reason' => 'PATCH /api/entity-relations/{id} requires Content-Type: application/json', + ], + statusCode: Http::STATUS_UNSUPPORTED_MEDIA_TYPE + ); + } + $body = $this->request->getParams(); // Strip framework-injected keys; only the JSON body fields remain candidates. unset($body['id'], $body['_route']); @@ -166,17 +198,21 @@ public function update(int $id): JSONResponse /** * Check that the acting user can write the relation's parent file or object. * - * Resolution order: + * Resolution order (per `entity-relation-grondslagen` design.md §authz): * 1. If the relation has `fileId` — the file MUST be present in the * acting user's user-folder and `isUpdateable()` MUST return true. - * 2. Else if the relation has `objectId` — defer to the existing - * ObjectEntity authorization model (not yet implemented in this - * change; for now, accept and emit a warning log so we don't - * silently block legitimate object-bound flows). Tracked as - * a follow-up. - * 3. Else if the relation has `emailId` — same deferral; tracked. + * 2. Else if the relation has `objectId` — the caller MUST hold + * `update` on the underlying ObjectEntity per the same + * PermissionHandler verdict the rest of OR uses for object writes. + * 3. Else if the relation has `emailId` — the email's parent + * ObjectEntity is looked up via EmailLink, then the same + * object-update verdict applies. Email links without a parent + * object cannot satisfy an authz check and are denied. * 4. Otherwise — deny. * + * Every denial path is logged at `info` (expected operator denials) + * or `warning` (lookup failures) so unexpected drift is visible. + * * @param EntityRelation $relation Relation row. * @param string $userId Acting user UID. * @@ -185,54 +221,232 @@ public function update(int $id): JSONResponse private function actorCanWriteRelationSubject(EntityRelation $relation, string $userId): bool { $fileId = $relation->getFileId(); - if ($fileId !== null) { - try { - $userFolder = $this->rootFolder->getUserFolder($userId); - $nodes = $userFolder->getById($fileId); - if (empty($nodes) === true) { - return false; - } - - $node = $nodes[0]; - if (($node instanceof File) === false) { - return false; - } - - return $node->isUpdateable(); - } catch (\Throwable $e) { - $this->logger->warning( - message: '[EntityRelationsController] File-bound auth check raised exception, denying', - context: [ - 'file' => __FILE__, - 'line' => __LINE__, - 'file_id' => $fileId, - 'error' => $e->getMessage(), - ] - ); - return false; - }//end try - }//end if + if ($fileId !== null && $fileId > 0) { + return $this->canWriteFile(fileId: $fileId, userId: $userId); + } $objectId = $relation->getObjectId(); - $emailId = $relation->getEmailId(); - if ($objectId !== null || $emailId !== null) { - // Object- and email-bound authorization is deferred to a - // follow-up change — the existing OR ObjectEntity authz - // model is not yet wired through to per-relation PATCH. - // For v1, accept the write but log so operators are visible. + if ($objectId !== null && $objectId > 0) { + return $this->canUpdateObject( + objectId: $objectId, + registerId: $relation->getRegisterId(), + schemaId: $relation->getSchemaId(), + userId: $userId + ); + } + + $emailId = $relation->getEmailId(); + if ($emailId !== null && $emailId > 0) { + return $this->canUpdateEmailParentObject(emailId: $emailId, userId: $userId); + } + + return false; + }//end actorCanWriteRelationSubject() + + /** + * File-bound authz: the file MUST be reachable in the acting user's + * user-folder and writable (isUpdateable). Mirrors how the rest of + * OR's per-file authz reads. + * + * @param int $fileId Nextcloud file node id. + * @param string $userId Acting user UID. + * + * @return bool + */ + private function canWriteFile(int $fileId, string $userId): bool + { + try { + $userFolder = $this->rootFolder->getUserFolder($userId); + $nodes = $userFolder->getById($fileId); + if (empty($nodes) === true) { + return false; + } + + $node = $nodes[0]; + if (($node instanceof File) === false) { + return false; + } + + return $node->isUpdateable(); + } catch (\Throwable $e) { + $this->logger->warning( + message: '[EntityRelationsController] File-bound auth check raised exception, denying', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'file_id' => $fileId, + 'error' => $e->getMessage(), + ] + ); + return false; + }//end try + }//end canWriteFile() + + /** + * Object-bound authz: caller MUST hold `update` permission on the + * specific ObjectEntity. Reuses `PermissionHandler::hasPermission` + * — the same verdict the rest of OR runs for object writes, so this + * PATCH cannot grant access the saveObject path would have denied. + * + * Lookup uses register + schema disambiguation when both are + * available (the multi-table magic schema means object_id is not + * globally unique). When either is missing on the relation, falls + * back to the magic-mapper's cross-table find, which yields + * `DoesNotExistException` if no match — denied. + * + * @param int $objectId Object row id on its magic table. + * @param string|null $registerId Register identifier (uuid or slug). + * @param string|null $schemaId Schema identifier (uuid or slug). + * @param string $userId Acting user UID. + * + * @return bool + */ + private function canUpdateObject( + int $objectId, + ?string $registerId, + ?string $schemaId, + string $userId + ): bool { + try { + $register = $registerId !== null ? $this->registerMapper->find($registerId) : null; + $schema = $schemaId !== null ? $this->schemaMapper->find($schemaId) : null; + $object = $this->magicMapper->find( + identifier: $objectId, + register: $register, + schema: $schema + ); + } catch (\Throwable $e) { $this->logger->warning( - message: '[EntityRelationsController] Object/email-bound PATCH accepted without strict authz (follow-up)', + message: '[EntityRelationsController] Object-bound auth check could not resolve object, denying', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'object_id' => $objectId, + 'register_id' => $registerId, + 'schema_id' => $schemaId, + 'error' => $e->getMessage(), + ] + ); + return false; + }//end try + + $resolvedSchemaId = $schemaId !== null ? $schemaId : (string) $object->getSchema(); + try { + $resolvedSchema = $this->schemaMapper->find($resolvedSchemaId); + } catch (\Throwable $e) { + $this->logger->warning( + message: '[EntityRelationsController] Object-bound auth check could not load schema, denying', context: [ 'file' => __FILE__, 'line' => __LINE__, 'object_id' => $objectId, + 'schema_id' => $resolvedSchemaId, + 'error' => $e->getMessage(), + ] + ); + return false; + } + + return $this->permissionHandler->hasPermission( + schema: $resolvedSchema, + action: 'update', + userId: $userId, + objectOwner: $object->getOwner(), + object: $object + ); + }//end canUpdateObject() + + /** + * Email-bound authz: emails are linked to an ObjectEntity via + * EmailLink, so the operator must hold `update` on the parent + * object. Email links without a parent object cannot satisfy + * authz and are denied (orphan/system-generated links). + * + * @param int $emailId EmailLink row id. + * @param string $userId Acting user UID. + * + * @return bool + */ + private function canUpdateEmailParentObject(int $emailId, string $userId): bool + { + try { + $emailLink = $this->emailLinkMapper->find($emailId); + } catch (\Throwable $e) { + $this->logger->warning( + message: '[EntityRelationsController] Email-bound auth check could not load EmailLink, denying', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'email_id' => $emailId, + 'error' => $e->getMessage(), + ] + ); + return false; + } + + $parentObjectUuid = $emailLink->getObjectUuid(); + $parentRegisterId = $emailLink->getRegisterId(); + // EmailLink's `@method string getObjectUuid()` claims non-nullable, + // but the underlying column is `?string`. Guard via empty() so we + // catch both null and empty-string parents. + if (empty($parentObjectUuid) === true) { + $this->logger->info( + message: '[EntityRelationsController] Email-bound PATCH denied — EmailLink has no parent object', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'email_id' => $emailId, + 'actor' => $userId, + ] + ); + return false; + } + + try { + // EmailLink's `@method int getRegisterId()` is non-nullable in + // the docblock; defensively coerce via empty() in case the + // column is unexpectedly null at runtime. + $register = empty($parentRegisterId) === false ? $this->registerMapper->find((string) $parentRegisterId) : null; + $object = $this->magicMapper->find( + identifier: $parentObjectUuid, + register: $register + ); + } catch (\Throwable $e) { + $this->logger->warning( + message: '[EntityRelationsController] Email-bound auth check could not resolve parent object, denying', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'email_id' => $emailId, + 'object_uuid' => $parentObjectUuid, + 'error' => $e->getMessage(), + ] + ); + return false; + }//end try + + try { + $schema = $this->schemaMapper->find((string) $object->getSchema()); + } catch (\Throwable $e) { + $this->logger->warning( + message: '[EntityRelationsController] Email-bound auth check could not load parent schema, denying', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, 'email_id' => $emailId, - 'actor' => $userId, + 'schema_id' => $object->getSchema(), + 'error' => $e->getMessage(), ] ); - return true; + return false; } - return false; - }//end actorCanWriteRelationSubject() + return $this->permissionHandler->hasPermission( + schema: $schema, + action: 'update', + userId: $userId, + objectOwner: $object->getOwner(), + object: $object + ); + }//end canUpdateEmailParentObject() }//end class diff --git a/lib/Db/EmailLinkMapper.php b/lib/Db/EmailLinkMapper.php index a1291e070cc1..9076fb2c2a9f 100644 --- a/lib/Db/EmailLinkMapper.php +++ b/lib/Db/EmailLinkMapper.php @@ -17,6 +17,7 @@ namespace OCA\OpenRegister\Db; +use OCP\AppFramework\Db\DoesNotExistException; use OCP\AppFramework\Db\Entity; use OCP\AppFramework\Db\QBMapper; use OCP\DB\QueryBuilder\IQueryBuilder; @@ -94,6 +95,30 @@ public function tableExists(): bool return $this->tableExistsCache; }//end tableExists() + /** + * Find a single email link by primary id. + * + * QBMapper exposes `find()` only via `@method` docblock; concrete mappers + * add it themselves when needed. Wraps the inherited protected + * `findEntity()` so callers get a typed 404 path + * (`DoesNotExistException`) for unknown ids. + * + * @param int $id The email link row id. + * + * @return EmailLink The matching row. + * + * @throws DoesNotExistException When $id does not resolve. + */ + public function find(int $id): EmailLink + { + $qb = $this->db->getQueryBuilder(); + $qb->select('*') + ->from($this->getTableName()) + ->where($qb->expr()->eq('id', $qb->createNamedParameter($id, IQueryBuilder::PARAM_INT))); + + return $this->findEntity(query: $qb); + }//end find() + /** * Find email links by object UUID. * diff --git a/lib/Db/EntityRelationMapper.php b/lib/Db/EntityRelationMapper.php index 302f2835dd69..d0783a0cc097 100644 --- a/lib/Db/EntityRelationMapper.php +++ b/lib/Db/EntityRelationMapper.php @@ -219,7 +219,7 @@ public function findAnonymisedEntitiesWithBasesForFile(int $fileId): array // callers expect an array (or null when no bases were recorded). foreach ($rows as &$row) { if (isset($row['bases']) === true && is_string($row['bases']) === true) { - $decoded = json_decode($row['bases'], associative: true); + $decoded = json_decode($row['bases'], associative: true); $row['bases'] = is_array($decoded) === true ? $decoded : null; } @@ -417,7 +417,10 @@ public function updateDecisionMetadata(EntityRelation $relation, array $fields, if (array_key_exists('bases', $fields) === true) { $previousBases = $relation->getBases(); - if ($previousBases !== $fields['bases']) { + // Compare as multiset — same UUIDs in different order is a + // semantic no-op for redaction policy. Storage preserves + // operator-supplied order; only the diff check normalises. + if (self::basesAreEqual(a: $previousBases, b: $fields['bases']) === false) { $changedFields['bases'] = [ 'previous' => $previousBases, 'new' => $fields['bases'], @@ -441,30 +444,35 @@ public function updateDecisionMetadata(EntityRelation $relation, array $fields, return $relation; } - $relation = $this->update(entity: $relation); - $relationId = (int) $relation->getId(); - + // Audit-invariant: every persisted state change MUST have an + // audit-trail entry. Both writes go in a single transaction so a + // failed audit-INSERT rolls back the row UPDATE — clients see + // HTTP 500 instead of an undetectable audit gap. The downstream + // event dispatch stays OUTSIDE the transaction (post-commit, + // informational; listener failures must not roll back). + $this->db->beginTransaction(); try { + $relation = $this->update(entity: $relation); + $relationId = (int) $relation->getId(); $this->emitDecisionMetadataAuditEntry( relationId: $relationId, changedFields: $changedFields, actingUser: $actingUser ); - } catch (\Throwable $auditError) { - // Audit-emission failure MUST NOT mask the persisted state - // change — log loudly and continue. The next operator review - // surfaces the row's new state; the audit-gap is captured in - // the application log. + $this->db->commit(); + } catch (\Throwable $writeError) { + $this->db->rollBack(); $this->logger->error( - message: '[EntityRelationMapper] Failed to emit decision-metadata audit entry', + message: '[EntityRelationMapper] Transactional decision-metadata write failed, rolled back', context: [ 'file' => __FILE__, 'line' => __LINE__, - 'relation_id' => $relationId, + 'relation_id' => (int) $relation->getId(), 'changedKeys' => array_keys($changedFields), - 'error' => $auditError->getMessage(), + 'error' => $writeError->getMessage(), ] ); + throw $writeError; }//end try // Notify listeners (downstream apps — e.g. DocuDesk's @@ -498,6 +506,42 @@ public function updateDecisionMetadata(EntityRelation $relation, array $fields, return $relation; }//end updateDecisionMetadata() + /** + * Multiset-equality on two `bases` values. + * + * Distinguishes the four nullability/empty cases that callers care about: + * - null vs null → equal (both "no bases") + * - null vs [] → NOT equal (different intent: "unset" vs "explicitly empty") + * - [a, b] vs [b, a] → equal (order-insensitive for redaction policy) + * - [a, b, a] vs [b, a] → equal (duplicates collapsed) + * + * Storage preserves operator-supplied order + duplicates; only the + * diff check normalises. Used by `updateDecisionMetadata` to avoid + * spurious audit entries on cosmetic reorderings. + * + * @param array|null $a First value. + * @param array|null $b Second value. + * + * @return bool True when the two values represent the same redaction policy. + */ + private static function basesAreEqual(?array $a, ?array $b): bool + { + if ($a === null && $b === null) { + return true; + } + + if ($a === null || $b === null) { + return false; + } + + $normA = array_values(array_unique($a, SORT_STRING)); + $normB = array_values(array_unique($b, SORT_STRING)); + sort($normA); + sort($normB); + return $normA === $normB; + + }//end basesAreEqual() + /** * Emit one audit-trail entry summarising a decision-metadata write. * @@ -518,15 +562,16 @@ private function emitDecisionMetadataAuditEntry( array $changedFields, ?IUser $actingUser=null ): void { - $user = $actingUser ?? $this->userSession->getUser(); - $userId = $user !== null ? $user->getUID() : 'system'; - $userName = $user !== null ? $user->getDisplayName() : 'System'; + $user = $actingUser ?? $this->userSession->getUser(); + $userId = $user !== null ? $user->getUID() : 'system'; $auditTrail = new AuditTrail(); $auditTrail->setUuid(\Symfony\Component\Uid\Uuid::v4()->toRfc4122()); $auditTrail->setAction('entity_relation_decision_updated'); $auditTrail->setUser($userId); - $auditTrail->setUserName($userName); + // ADR-005: actor is the UID only. Display name is PII; do not + // persist it on entity-relation decision audit entries. + $auditTrail->setUserName(null); $auditTrail->setCreated(new DateTime()); $auditTrail->setChanged( [ diff --git a/lib/Event/EntityRelationDecisionUpdatedEvent.php b/lib/Event/EntityRelationDecisionUpdatedEvent.php index a013b82d28a6..ee58bfa6f553 100644 --- a/lib/Event/EntityRelationDecisionUpdatedEvent.php +++ b/lib/Event/EntityRelationDecisionUpdatedEvent.php @@ -119,7 +119,7 @@ public function isSkipAnonymizationActivated(): bool } $diff = $this->changedFields['skipAnonymization']; - return ($diff['previous'] ?? null) === false && ($diff['new'] ?? null) === true; + return $diff['previous'] === false && $diff['new'] === true; }//end isSkipAnonymizationActivated() }//end class diff --git a/lib/Migration/Version1Date20260512120000.php b/lib/Migration/Version1Date20260512120000.php index fbf0d7f4b0a5..af83a2f8df65 100644 --- a/lib/Migration/Version1Date20260512120000.php +++ b/lib/Migration/Version1Date20260512120000.php @@ -103,4 +103,11 @@ public function changeSchema(IOutput $output, Closure $schemaClosure, array $opt return $schema; }//end changeSchema() + + // PostSchemaChange() intentionally NOT overridden: the new columns + // are nullable (`bases`) or carry a DB-level default + // (`skip_anonymization` → false), so existing rows pick up correct + // values automatically and require no backfill pass. Adding an + // empty override would be dead code; SimpleMigrationStep's default + // no-op is what we want. }//end class diff --git a/openspec/changes/entity-relation-grondslagen/design.md b/openspec/changes/entity-relation-grondslagen/design.md index dacb42ba13b9..0f2be052f1f2 100644 --- a/openspec/changes/entity-relation-grondslagen/design.md +++ b/openspec/changes/entity-relation-grondslagen/design.md @@ -195,6 +195,10 @@ Only fields that actually changed appear under `changedFields`. If the caller PA Reads MUST NOT produce audit entries — applies to all relation reads in the codebase (mapper find, controller GET, downstream consumers). +**Transactional audit-invariant.** The row UPDATE and the audit-trail INSERT MUST run inside the same DB transaction (`beginTransaction` / `commit` / `rollBack`). An audit-INSERT failure MUST roll back the UPDATE and surface as HTTP 500 — clients never observe a persisted decision-metadata change without a matching audit entry. The post-commit event dispatch (§D6a) stays OUTSIDE the transaction; listener failures are informational and MUST NOT roll back. + +**`bases` diff is multiset-equal, not order-equal.** When deciding whether `bases` changed, treat the two arrays as multisets — same UUIDs in different order is a semantic no-op and does NOT produce an audit entry. Storage preserves the operator-supplied order; only the diff check normalises. `null` vs `[]` remains distinct (different operator intent: "unset" vs "explicitly empty"). + ### D6a. Event dispatch for downstream listeners (`EntityRelationDecisionUpdatedEvent`) After the audit-trail entry is persisted, `updateDecisionMetadata` also dispatches a Symfony event so downstream apps can react to operator decisions without polling. The event carries the same diff payload as the audit entry, plus the post-update `EntityRelation` instance and the acting `IUser` (or null when no session user). @@ -223,15 +227,17 @@ PATCH requires that the acting user can **write** to the file or object referenc **Resolution order:** -1. If the relation has `fileId` set — check the acting user can write the file. (`Folder::isReadable() && ...` — actually a write-check; OR has a helper for this used in the anonymise path.) -2. Else if the relation has `objectId` (+ `registerId` + `schemaId` for disambiguation) — check the user can update the underlying object. -3. Else if the relation has `emailId` — check the email is accessible to the user. +1. If the relation has `fileId` set — check the acting user can write the file. `IRootFolder::getUserFolder($uid)->getById($fileId)` MUST return a `File` node, and `File::isUpdateable()` MUST return true. +2. Else if the relation has `objectId` (+ `registerId` + `schemaId` for disambiguation) — call `PermissionHandler::hasPermission(schema, 'update', uid, object->getOwner(), object)`. This is the same verdict OR uses everywhere else for object writes; the PATCH endpoint cannot grant access the `saveObject()` path would have denied. +3. Else if the relation has `emailId` — load the `EmailLink`, resolve its parent `objectUuid` + `registerId`, then run the same object-update verdict on the parent. Email links without a parent object cannot satisfy the check and are denied (orphan / system-generated links). 4. If none of the above resolve to a permission grant, deny (HTTP 403). **No additional action-level permission** is introduced in this change (per ADR-023). The PATCH endpoint inherits the existing file/object write check; there is no separate "may set bases" permission. If a future change wants action-level authz, it MUST add a new Requirement here. This decision is recorded explicitly so future reviewers can see the absence-of-extra-check is intentional, not oversight. **`@NoAdminRequired`** on the controller method — non-admins can PATCH relations they have write-access to. Admin role MUST NOT be required. +**No `@NoCSRFRequired`.** The PATCH is a browser-facing decision-time mutation invoked from the DocuDesk operator UI; Nextcloud's session-CSRF protection MUST stay on. Server-to-server callers requiring no-CSRF should use a dedicated API-token surface, not this endpoint. + ### D8. Standard PATCH semantics for partial updates PATCH is the natural HTTP verb for partial updates. Body shape maps to behaviour directly: diff --git a/openspec/changes/entity-relation-grondslagen/tasks.md b/openspec/changes/entity-relation-grondslagen/tasks.md index ad68f984b6e1..c4409c7f5b56 100644 --- a/openspec/changes/entity-relation-grondslagen/tasks.md +++ b/openspec/changes/entity-relation-grondslagen/tasks.md @@ -1,39 +1,39 @@ ## 1. Database migration -- [ ] 1.1 Add a new migration class under `lib/Migration/` (next-available version, e.g. `Version1Date20260512.php`) that adds two columns to `oc_openregister_entity_relations`: +- [x] 1.1 Add a new migration class under `lib/Migration/` (next-available version, e.g. `Version1Date20260512.php`) that adds two columns to `oc_openregister_entity_relations`: - `bases` — JSON (or platform-equivalent JSON column type), `notnull => false`, no default. - `skip_anonymization` — BOOLEAN, `notnull => true`, `default => false`. Use `hasColumn` guards so the migration is idempotent. Match the JSON column type used elsewhere in OR (`OCP\DB\Types::JSON`). -- [ ] 1.2 Verify the migration is idempotent: running it twice on the same database is a no-op (`hasColumn` guards ensure it). -- [ ] 1.3 Smoke-test the migration on a populated dev database: confirm existing `EntityRelation` rows are read correctly post-migration — `bases` reads as `null` and `skipAnonymization` reads as `false` for all of them. +- [x] 1.2 Verify the migration is idempotent: running it twice on the same database is a no-op (`hasColumn` guards ensure it). +- [x] 1.3 Smoke-test the migration on a populated dev database: confirm existing `EntityRelation` rows are read correctly post-migration — `bases` reads as `null` and `skipAnonymization` reads as `false` for all of them. ## 2. EntityRelation entity + mapper -- [ ] 2.1 Add `protected ?array $bases = null;` and `protected bool $skipAnonymization = false;` to `lib/Db/EntityRelation.php`. -- [ ] 2.2 Add `addType(fieldName: 'bases', type: 'json');` and `addType(fieldName: 'skipAnonymization', type: 'boolean');` in `EntityRelation::__construct()`. -- [ ] 2.3 Add the `getBases(): ?array`, `setBases(?array $bases): void`, `getSkipAnonymization(): bool`, `setSkipAnonymization(bool $skip): void` magic-method docblocks to the class header (mirroring the existing pattern for other fields). Getters/setters are auto-provided by Nextcloud's `Entity` base class once `addType` is registered. -- [ ] 2.4 Update `jsonSerialize()` to include `bases` and `skipAnonymization` in the returned array. Order them after `anonymizedValue` for consistency. -- [ ] 2.5 Update the psalm/phpdoc return type on `jsonSerialize` to include both new fields. -- [ ] 2.6 Confirm `EntityRelationMapper` (`lib/Db/EntityRelationMapper.php`) does not need changes to existing read methods — Nextcloud's `QBMapper` automatically handles columns registered via `addType`. If the mapper has any manual `select(...)` lists, update those to include both new columns. +- [x] 2.1 Add `protected ?array $bases = null;` and `protected bool $skipAnonymization = false;` to `lib/Db/EntityRelation.php`. +- [x] 2.2 Add `addType(fieldName: 'bases', type: 'json');` and `addType(fieldName: 'skipAnonymization', type: 'boolean');` in `EntityRelation::__construct()`. +- [x] 2.3 Add the `getBases(): ?array`, `setBases(?array $bases): void`, `getSkipAnonymization(): bool`, `setSkipAnonymization(bool $skip): void` magic-method docblocks to the class header (mirroring the existing pattern for other fields). Getters/setters are auto-provided by Nextcloud's `Entity` base class once `addType` is registered. +- [x] 2.4 Update `jsonSerialize()` to include `bases` and `skipAnonymization` in the returned array. Order them after `anonymizedValue` for consistency. +- [x] 2.5 Update the psalm/phpdoc return type on `jsonSerialize` to include both new fields. +- [x] 2.6 Confirm `EntityRelationMapper` (`lib/Db/EntityRelationMapper.php`) does not need changes to existing read methods — Nextcloud's `QBMapper` automatically handles columns registered via `addType`. If the mapper has any manual `select(...)` lists, update those to include both new columns. ## 3. Decision-metadata write path -- [ ] 3.1 Add method `EntityRelationMapper::updateDecisionMetadata(int $id, array $fields, ?IUser $actingUser = null): EntityRelation`. Behaviour: +- [x] 3.1 Add method `EntityRelationMapper::updateDecisionMetadata(int $id, array $fields, ?IUser $actingUser = null): EntityRelation`. Behaviour: - Resolve the row by `$id`; throw `DoesNotExistException` if missing. - Enforce whitelist: keys MUST be a subset of `{ 'bases', 'skipAnonymization' }`. Any other key → typed validation exception (mapped to HTTP 400 at the controller). - Validate field shape: `bases` MUST be `null` or `array`; `skipAnonymization` MUST be a `bool`. Anything else → typed validation exception. - Compute diff against current row state; if no field actually changes, return the row and SKIP audit emission (semantic no-op). - Otherwise apply changes, persist via `QBMapper::update`, emit one audit-trail entry via OR's existing audit subsystem (see 3.2). Persist + audit MUST follow the same transactional/error-handling pattern as existing audit-traced mapper writes. - Return the updated row. -- [ ] 3.2 Wire the audit-trail emission inside `updateDecisionMetadata` (NOT at the controller layer). Entry payload: +- [x] 3.2 Wire the audit-trail emission inside `updateDecisionMetadata` (NOT at the controller layer). Entry payload: - `action`: `entity_relation_decision_updated` (or OR's equivalent action vocabulary if one exists). - `subjectType`: `openregister_entity_relations` (or OR's canonical naming). - `subjectId`: the row id. - `actor`: `$actingUser?->getUID()` if provided, else the session-derived UID (per ADR-005, the UID — NOT the display name). - `timestamp`: an ISO-8601 datetime. - `changedFields`: object whose keys are only the fields that ACTUALLY changed; each value `{ previous: , new: }`. Fields submitted with values matching current state MUST NOT appear. -- [ ] 3.2a Add `lib/Event/EntityRelationDecisionUpdatedEvent.php` (NEW). Post-commit, informational Symfony event. Constructor takes `EntityRelation`, `array $changedFields`, `?IUser $actingUser`. Exposes `getRelation()`, `getChangedFields()`, `getActingUser()`, plus convenience `isSkipAnonymizationActivated(): bool` covering the most common listener trigger (false → true flip). Inject `IEventDispatcher` into `EntityRelationMapper` and dispatch the event right after `emitDecisionMetadataAuditEntry`, inside its own `try/catch` — listener failures MUST NOT mask the persisted state change (same isolation as audit). See `design.md` §D6a for the contract. -- [ ] 3.3 Add `lib/Controller/EntityRelationsController.php` (NEW). Single method: `update(int $id)` mapped to PATCH. Behaviour: +- [x] 3.2a Add `lib/Event/EntityRelationDecisionUpdatedEvent.php` (NEW). Post-commit, informational Symfony event. Constructor takes `EntityRelation`, `array $changedFields`, `?IUser $actingUser`. Exposes `getRelation()`, `getChangedFields()`, `getActingUser()`, plus convenience `isSkipAnonymizationActivated(): bool` covering the most common listener trigger (false → true flip). Inject `IEventDispatcher` into `EntityRelationMapper` and dispatch the event right after `emitDecisionMetadataAuditEntry`, inside its own `try/catch` — listener failures MUST NOT mask the persisted state change (same isolation as audit). See `design.md` §D6a for the contract. +- [x] 3.3 Add `lib/Controller/EntityRelationsController.php` (NEW). Single method: `update(int $id)` mapped to PATCH. Behaviour: - `@NoAdminRequired`. - Read the JSON body via the standard Nextcloud controller `$this->request->getParams()` pattern. - Resolve the relation via `findById`. If 404, return JSONResponse status 404. @@ -41,22 +41,22 @@ - Call `EntityRelationMapper::updateDecisionMetadata($id, $fields, $actingUser)`. - Catch the typed validation exception → JSONResponse status 400 with error body (`{ error: , field: }`). - On success, return JSONResponse 200 with `$relation->jsonSerialize()`. -- [ ] 3.4 Implement the authorization check as a private method on the controller (or a small helper class). Resolution order: +- [x] 3.4 Implement the authorization check as a private method on the controller (or a small helper class). Resolution order: - If `relation->fileId` set: caller MUST be able to write the file (reuse OR's existing helper — likely the one `FileTextController::anonymizeFile` implicitly inherits). - Else if `relation->objectId` set (with `registerId` + `schemaId`): caller MUST be able to update the object. - Else if `relation->emailId` set: caller MUST be able to access the email. - Otherwise deny. - Unauthenticated session → HTTP 401 (Nextcloud's existing session-required path handles this before the controller method runs; verify the route's `@NoAdminRequired` annotation doesn't bypass auth). -- [ ] 3.5 Add the route to `appinfo/routes.php`: +- [x] 3.5 Add the route to `appinfo/routes.php`: ``` ['name' => 'entityRelations#update', 'url' => '/api/entity-relations/{id}', 'verb' => 'PATCH', 'requirements' => ['id' => '\\d+']], ``` -- [ ] 3.6 Update `EntityRelationMapper::markAsAnonymized($fileId, $anonymizedValue)` to add `AND skip_anonymization = 0` to the WHERE clause. Rows with `skip_anonymization = true` MUST be untouched by this method. -- [ ] 3.7 Update `FileTextController::anonymizeFile($fileId)` to filter out skipped rows when building the replacements list. Two implementation options — pick whichever fits OR's existing pattern: +- [x] 3.6 Update `EntityRelationMapper::markAsAnonymized($fileId, $anonymizedValue)` to add `AND skip_anonymization = 0` to the WHERE clause. Rows with `skip_anonymization = true` MUST be untouched by this method. +- [x] 3.7 Update `FileTextController::anonymizeFile($fileId)` to filter out skipped rows when building the replacements list. Two implementation options — pick whichever fits OR's existing pattern: - **(a)** Add a new mapper method `findEntitiesForAnonymization($fileId)` that returns the same shape as `findEntitiesForFile` but filters `skip_anonymization = 0`. Controller calls this one for the replacements list. - **(b)** Keep `findEntitiesForFile` as-is; controller filters in PHP after the read. Pick (a) — cleaner separation. Document the new method. -- [ ] 3.8 Update `FileService::anonymizeDocument(Node $node, array $entities)` to defensively filter skipped rows server-side. Before delegating to `DocumentProcessingHandler`: +- [x] 3.8 Update `FileService::anonymizeDocument(Node $node, array $entities)` to defensively filter skipped rows server-side. Before delegating to `DocumentProcessingHandler`: - For each entity in the caller-supplied array, look up the matching `EntityRelation` row(s) and check `skipAnonymization`. - Drop any entity whose row(s) have `skipAnonymization = true`. - Pass the filtered array to `DocumentProcessingHandler::anonymizeDocument`. diff --git a/tests/Unit/Controller/EntityRelationsControllerTest.php b/tests/Unit/Controller/EntityRelationsControllerTest.php index 69c8edaa5f85..763e759cbd74 100644 --- a/tests/Unit/Controller/EntityRelationsControllerTest.php +++ b/tests/Unit/Controller/EntityRelationsControllerTest.php @@ -1,13 +1,33 @@ + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://OpenRegister.app + */ + declare(strict_types=1); namespace OCA\OpenRegister\Tests\Unit\Controller; use OCA\OpenRegister\Controller\EntityRelationsController; +use OCA\OpenRegister\Db\EmailLinkMapper; use OCA\OpenRegister\Db\EntityRelation; use OCA\OpenRegister\Db\EntityRelationMapper; +use OCA\OpenRegister\Db\MagicMapper; +use OCA\OpenRegister\Db\RegisterMapper; +use OCA\OpenRegister\Db\SchemaMapper; use OCA\OpenRegister\Exception\CustomValidationException; +use OCA\OpenRegister\Service\Object\PermissionHandler; use OCP\AppFramework\Db\DoesNotExistException; use OCP\AppFramework\Http; use OCP\Files\File; @@ -32,24 +52,45 @@ */ class EntityRelationsControllerTest extends TestCase { + private IRequest&MockObject $request; + private EntityRelationMapper&MockObject $mapper; + private IUserSession&MockObject $userSession; + private IRootFolder&MockObject $rootFolder; + + private PermissionHandler&MockObject $permissionHandler; + + private MagicMapper&MockObject $magicMapper; + + private SchemaMapper&MockObject $schemaMapper; + + private RegisterMapper&MockObject $registerMapper; + + private EmailLinkMapper&MockObject $emailLinkMapper; + private LoggerInterface&MockObject $logger; + private IUser&MockObject $user; protected function setUp(): void { - $this->request = $this->createMock(IRequest::class); - $this->mapper = $this->createMock(EntityRelationMapper::class); - $this->userSession = $this->createMock(IUserSession::class); - $this->rootFolder = $this->createMock(IRootFolder::class); - $this->logger = $this->createMock(LoggerInterface::class); + $this->request = $this->createMock(IRequest::class); + $this->mapper = $this->createMock(EntityRelationMapper::class); + $this->userSession = $this->createMock(IUserSession::class); + $this->rootFolder = $this->createMock(IRootFolder::class); + $this->permissionHandler = $this->createMock(PermissionHandler::class); + $this->magicMapper = $this->createMock(MagicMapper::class); + $this->schemaMapper = $this->createMock(SchemaMapper::class); + $this->registerMapper = $this->createMock(RegisterMapper::class); + $this->emailLinkMapper = $this->createMock(EmailLinkMapper::class); + $this->logger = $this->createMock(LoggerInterface::class); $this->user = $this->createMock(IUser::class); $this->user->method('getUID')->willReturn('alice'); - } + }//end setUp() private function makeController(): EntityRelationsController { @@ -59,19 +100,24 @@ private function makeController(): EntityRelationsController $this->mapper, $this->userSession, $this->rootFolder, + $this->permissionHandler, + $this->magicMapper, + $this->schemaMapper, + $this->registerMapper, + $this->emailLinkMapper, $this->logger ); - } + }//end makeController() public function testReturns401WhenNotAuthenticated(): void { $this->userSession->method('getUser')->willReturn(null); $controller = $this->makeController(); - $response = $controller->update(42); + $response = $controller->update(42); $this->assertSame(Http::STATUS_UNAUTHORIZED, $response->getStatus()); - } + }//end testReturns401WhenNotAuthenticated() public function testReturns404WhenRelationNotFound(): void { @@ -79,10 +125,10 @@ public function testReturns404WhenRelationNotFound(): void $this->mapper->method('find')->willThrowException(new DoesNotExistException('not found')); $controller = $this->makeController(); - $response = $controller->update(999); + $response = $controller->update(999); $this->assertSame(Http::STATUS_NOT_FOUND, $response->getStatus()); - } + }//end testReturns404WhenRelationNotFound() public function testReturns403WhenFileNotWritable(): void { @@ -101,10 +147,10 @@ public function testReturns403WhenFileNotWritable(): void $this->rootFolder->method('getUserFolder')->willReturn($userFolder); $controller = $this->makeController(); - $response = $controller->update(42); + $response = $controller->update(42); $this->assertSame(Http::STATUS_FORBIDDEN, $response->getStatus()); - } + }//end testReturns403WhenFileNotWritable() public function testReturns403WhenFileNotPresentInUserFolder(): void { @@ -119,10 +165,10 @@ public function testReturns403WhenFileNotPresentInUserFolder(): void $this->rootFolder->method('getUserFolder')->willReturn($userFolder); $controller = $this->makeController(); - $response = $controller->update(42); + $response = $controller->update(42); $this->assertSame(Http::STATUS_FORBIDDEN, $response->getStatus()); - } + }//end testReturns403WhenFileNotPresentInUserFolder() public function testReturns400WhenMapperRaisesValidationException(): void { @@ -142,19 +188,21 @@ public function testReturns400WhenMapperRaisesValidationException(): void $this->mapper ->method('updateDecisionMetadata') - ->willThrowException(new CustomValidationException( + ->willThrowException( + new CustomValidationException( 'Field not editable: anonymized', ['field' => 'anonymized'] - )); + ) + ); $controller = $this->makeController(); - $response = $controller->update(42); + $response = $controller->update(42); $this->assertSame(Http::STATUS_BAD_REQUEST, $response->getStatus()); $body = $response->getData(); $this->assertSame('Field not editable: anonymized', $body['error']); $this->assertSame('anonymized', $body['details']['field']); - } + }//end testReturns400WhenMapperRaisesValidationException() public function testReturns200OnSuccessfulPatch(): void { @@ -174,11 +222,15 @@ public function testReturns200OnSuccessfulPatch(): void $userFolder->method('getById')->willReturn([$file]); $this->rootFolder->method('getUserFolder')->willReturn($userFolder); - $this->request->method('getParams')->willReturn([ - 'id' => 42, // injected by the routing framework — controller strips it - '_route' => 'openregister.entityRelations.update', // ditto - 'bases' => ['uuid-a'], - ]); + $this->request->method('getParams')->willReturn( + [ + 'id' => 42, + // injected by the routing framework — controller strips it + '_route' => 'openregister.entityRelations.update', + // ditto + 'bases' => ['uuid-a'], + ] + ); $this->mapper ->expects($this->once()) @@ -191,12 +243,116 @@ public function testReturns200OnSuccessfulPatch(): void ->willReturn($updatedRelation); $controller = $this->makeController(); - $response = $controller->update(42); + $response = $controller->update(42); $this->assertSame(Http::STATUS_OK, $response->getStatus()); $body = $response->getData(); $this->assertSame(['uuid-a'], $body['bases']); - } + }//end testReturns200OnSuccessfulPatch() + + public function testReturns403WhenObjectBoundButHasPermissionDeniesUpdate(): void + { + $relation = new EntityRelation(); + $relation->setObjectId(99); + $relation->setRegisterId('register-uuid'); + $relation->setSchemaId('schema-uuid'); + + $this->userSession->method('getUser')->willReturn($this->user); + $this->mapper->method('find')->willReturn($relation); + + // Lookup object + schema succeed. + $register = $this->createMock(\OCA\OpenRegister\Db\Register::class); + $this->registerMapper->method('find')->willReturn($register); + + $schema = $this->createMock(\OCA\OpenRegister\Db\Schema::class); + $this->schemaMapper->method('find')->willReturn($schema); + + $object = new \OCA\OpenRegister\Db\ObjectEntity(); + $object->setOwner('bob'); + $object->setSchema('schema-uuid'); + $this->magicMapper->method('find')->willReturn($object); + + // PermissionHandler refuses. + $this->permissionHandler + ->method('hasPermission') + ->willReturn(false); + + $controller = $this->makeController(); + $response = $controller->update(42); + + $this->assertSame(Http::STATUS_FORBIDDEN, $response->getStatus()); + }//end testReturns403WhenObjectBoundButHasPermissionDeniesUpdate() + + public function testReturns200WhenObjectBoundAndHasPermissionGrantsUpdate(): void + { + $relation = new EntityRelation(); + $relation->setObjectId(99); + $relation->setRegisterId('register-uuid'); + $relation->setSchemaId('schema-uuid'); + + $updatedRelation = new EntityRelation(); + $updatedRelation->setObjectId(99); + $updatedRelation->setBases(['uuid-a']); + + $this->userSession->method('getUser')->willReturn($this->user); + $this->mapper->method('find')->willReturn($relation); + + $register = $this->createMock(\OCA\OpenRegister\Db\Register::class); + $this->registerMapper->method('find')->willReturn($register); + + $schema = $this->createMock(\OCA\OpenRegister\Db\Schema::class); + $this->schemaMapper->method('find')->willReturn($schema); + + $object = new \OCA\OpenRegister\Db\ObjectEntity(); + $object->setOwner('alice'); + $object->setSchema('schema-uuid'); + $this->magicMapper->method('find')->willReturn($object); + + $this->permissionHandler + ->method('hasPermission') + ->willReturn(true); + + $this->request->method('getParams')->willReturn(['bases' => ['uuid-a']]); + $this->mapper + ->method('updateDecisionMetadata') + ->willReturn($updatedRelation); + + $controller = $this->makeController(); + $response = $controller->update(42); + + $this->assertSame(Http::STATUS_OK, $response->getStatus()); + }//end testReturns200WhenObjectBoundAndHasPermissionGrantsUpdate() + + public function testReturns403WhenEmailBoundButEmailLinkHasNoParentObject(): void + { + $relation = new EntityRelation(); + $relation->setEmailId(7); + + $this->userSession->method('getUser')->willReturn($this->user); + $this->mapper->method('find')->willReturn($relation); + + $emailLink = new \OCA\OpenRegister\Db\EmailLink(); + // EmailLink::objectUuid defaults to null — no setter call needed. + $this->emailLinkMapper->method('find')->willReturn($emailLink); + + $controller = $this->makeController(); + $response = $controller->update(42); + + $this->assertSame(Http::STATUS_FORBIDDEN, $response->getStatus()); + }//end testReturns403WhenEmailBoundButEmailLinkHasNoParentObject() + + public function testReturns403WhenRelationHasNoSubject(): void + { + $relation = new EntityRelation(); + // no fileId, objectId, or emailId + $this->userSession->method('getUser')->willReturn($this->user); + $this->mapper->method('find')->willReturn($relation); + + $controller = $this->makeController(); + $response = $controller->update(42); + + $this->assertSame(Http::STATUS_FORBIDDEN, $response->getStatus()); + }//end testReturns403WhenRelationHasNoSubject() public function testReturns500OnUnexpectedException(): void { @@ -218,8 +374,8 @@ public function testReturns500OnUnexpectedException(): void ->willThrowException(new \RuntimeException('boom')); $controller = $this->makeController(); - $response = $controller->update(42); + $response = $controller->update(42); $this->assertSame(Http::STATUS_INTERNAL_SERVER_ERROR, $response->getStatus()); - } -} + }//end testReturns500OnUnexpectedException() +}//end class diff --git a/tests/Unit/Db/EntityRelationMapperTest.php b/tests/Unit/Db/EntityRelationMapperTest.php index 4fecf505608b..1df4e49e49f6 100644 --- a/tests/Unit/Db/EntityRelationMapperTest.php +++ b/tests/Unit/Db/EntityRelationMapperTest.php @@ -1,5 +1,20 @@ + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://OpenRegister.app + */ + declare(strict_types=1); namespace OCA\OpenRegister\Tests\Unit\Db; diff --git a/tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php b/tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php index d22e1b69e963..f8bd7b1c0308 100644 --- a/tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php +++ b/tests/Unit/Db/EntityRelationMapperUpdateDecisionMetadataTest.php @@ -1,5 +1,20 @@ + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://OpenRegister.app + */ + declare(strict_types=1); namespace OCA\OpenRegister\Tests\Unit\Db; @@ -29,25 +44,31 @@ */ class EntityRelationMapperUpdateDecisionMetadataTest extends TestCase { + private IDBConnection&MockObject $db; + private AuditTrailMapper&MockObject $auditTrailMapper; + private IUserSession&MockObject $userSession; + private IEventDispatcher&MockObject $eventDispatcher; + private LoggerInterface&MockObject $logger; + private IUser&MockObject $user; protected function setUp(): void { $this->db = $this->createMock(IDBConnection::class); $this->auditTrailMapper = $this->createMock(AuditTrailMapper::class); - $this->userSession = $this->createMock(IUserSession::class); - $this->eventDispatcher = $this->createMock(IEventDispatcher::class); - $this->logger = $this->createMock(LoggerInterface::class); + $this->userSession = $this->createMock(IUserSession::class); + $this->eventDispatcher = $this->createMock(IEventDispatcher::class); + $this->logger = $this->createMock(LoggerInterface::class); $this->user = $this->createMock(IUser::class); $this->user->method('getUID')->willReturn('alice'); $this->user->method('getDisplayName')->willReturn('Alice'); - } + }//end setUp() /** * Build a mapper with `update()` (the only concrete inherited write method) mocked. @@ -55,25 +76,27 @@ protected function setUp(): void private function mapperWithMockedUpdate(): EntityRelationMapper&MockObject { $mapper = $this->getMockBuilder(EntityRelationMapper::class) - ->setConstructorArgs([ - $this->db, - $this->auditTrailMapper, - $this->userSession, - $this->eventDispatcher, - $this->logger, - ]) + ->setConstructorArgs( + [ + $this->db, + $this->auditTrailMapper, + $this->userSession, + $this->eventDispatcher, + $this->logger, + ] + ) ->onlyMethods(['update']) ->getMock(); $mapper->method('update')->willReturnArgument(0); return $mapper; - } + }//end mapperWithMockedUpdate() public function testRejectsUnknownField(): void { $relation = new EntityRelation(); - $mapper = $this->mapperWithMockedUpdate(); + $mapper = $this->mapperWithMockedUpdate(); $this->auditTrailMapper->expects($this->never())->method('insert'); @@ -81,12 +104,12 @@ public function testRejectsUnknownField(): void $this->expectExceptionMessageMatches('/anonymized/'); $mapper->updateDecisionMetadata(relation: $relation, fields: ['anonymized' => true], actingUser: $this->user); - } + }//end testRejectsUnknownField() public function testRejectsBasesAsNonArray(): void { $relation = new EntityRelation(); - $mapper = $this->mapperWithMockedUpdate(); + $mapper = $this->mapperWithMockedUpdate(); $this->auditTrailMapper->expects($this->never())->method('insert'); @@ -94,29 +117,29 @@ public function testRejectsBasesAsNonArray(): void $this->expectExceptionMessageMatches('/bases shape/'); $mapper->updateDecisionMetadata(relation: $relation, fields: ['bases' => 'uuid-a'], actingUser: $this->user); - } + }//end testRejectsBasesAsNonArray() public function testRejectsBasesArrayWithNonStringElement(): void { $relation = new EntityRelation(); - $mapper = $this->mapperWithMockedUpdate(); + $mapper = $this->mapperWithMockedUpdate(); $this->expectException(CustomValidationException::class); $this->expectExceptionMessageMatches('/bases shape/'); $mapper->updateDecisionMetadata(relation: $relation, fields: ['bases' => ['uuid-a', 42]], actingUser: $this->user); - } + }//end testRejectsBasesArrayWithNonStringElement() public function testRejectsSkipAnonymizationAsNonBool(): void { $relation = new EntityRelation(); - $mapper = $this->mapperWithMockedUpdate(); + $mapper = $this->mapperWithMockedUpdate(); $this->expectException(CustomValidationException::class); $this->expectExceptionMessageMatches('/skipAnonymization shape/'); $mapper->updateDecisionMetadata(relation: $relation, fields: ['skipAnonymization' => 'yes'], actingUser: $this->user); - } + }//end testRejectsSkipAnonymizationAsNonBool() public function testSemanticNoOpSkipsAuditEmission(): void { @@ -136,12 +159,12 @@ public function testSemanticNoOpSkipsAuditEmission(): void $this->assertSame(['uuid-a'], $result->getBases()); $this->assertTrue($result->getSkipAnonymization()); - } + }//end testSemanticNoOpSkipsAuditEmission() public function testEmptyBodyIsNoOp(): void { $relation = new EntityRelation(); - $mapper = $this->mapperWithMockedUpdate(); + $mapper = $this->mapperWithMockedUpdate(); $mapper->expects($this->never())->method('update'); $this->auditTrailMapper->expects($this->never())->method('insert'); @@ -150,7 +173,7 @@ public function testEmptyBodyIsNoOp(): void $this->assertNull($result->getBases()); $this->assertFalse($result->getSkipAnonymization()); - } + }//end testEmptyBodyIsNoOp() public function testSettingBasesForFirstTimeEmitsAuditEntry(): void { @@ -162,10 +185,12 @@ public function testSettingBasesForFirstTimeEmitsAuditEntry(): void $this->auditTrailMapper ->expects($this->once()) ->method('insert') - ->willReturnCallback(function (AuditTrail $entry) use (&$captured) { - $captured = $entry; - return $entry; - }); + ->willReturnCallback( + function (AuditTrail $entry) use (&$captured) { + $captured = $entry; + return $entry; + } + ); $mapper->expects($this->once())->method('update'); @@ -187,7 +212,7 @@ public function testSettingBasesForFirstTimeEmitsAuditEntry(): void $this->assertArrayHasKey('bases', $changed['fields']); $this->assertSame(['previous' => null, 'new' => ['uuid-a']], $changed['fields']['bases']); $this->assertArrayNotHasKey('skipAnonymization', $changed['fields']); - } + }//end testSettingBasesForFirstTimeEmitsAuditEntry() public function testFlippingSkipEmitsAuditEntry(): void { @@ -201,10 +226,12 @@ public function testFlippingSkipEmitsAuditEntry(): void $this->auditTrailMapper ->expects($this->once()) ->method('insert') - ->willReturnCallback(function (AuditTrail $entry) use (&$captured) { - $captured = $entry; - return $entry; - }); + ->willReturnCallback( + function (AuditTrail $entry) use (&$captured) { + $captured = $entry; + return $entry; + } + ); $result = $mapper->updateDecisionMetadata( relation: $relation, @@ -217,7 +244,7 @@ public function testFlippingSkipEmitsAuditEntry(): void $changed = $captured->getChanged(); $this->assertSame(['previous' => false, 'new' => true], $changed['fields']['skipAnonymization']); $this->assertArrayNotHasKey('bases', $changed['fields']); - } + }//end testFlippingSkipEmitsAuditEntry() public function testPartialChangeOnlyAuditsTheChangedField(): void { @@ -232,10 +259,12 @@ public function testPartialChangeOnlyAuditsTheChangedField(): void $this->auditTrailMapper ->expects($this->once()) ->method('insert') - ->willReturnCallback(function (AuditTrail $entry) use (&$captured) { - $captured = $entry; - return $entry; - }); + ->willReturnCallback( + function (AuditTrail $entry) use (&$captured) { + $captured = $entry; + return $entry; + } + ); $mapper->updateDecisionMetadata( relation: $relation, @@ -247,30 +276,32 @@ public function testPartialChangeOnlyAuditsTheChangedField(): void $changed = $captured->getChanged(); $this->assertArrayNotHasKey('bases', $changed['fields']); $this->assertSame(['previous' => false, 'new' => true], $changed['fields']['skipAnonymization']); - } + }//end testPartialChangeOnlyAuditsTheChangedField() - public function testAuditEmissionFailureDoesNotMaskUpdate(): void + public function testAuditEmissionFailureRollsBackUpdateAndThrows(): void { $relation = new EntityRelation(); $relation->setId(42); $mapper = $this->mapperWithMockedUpdate(); + $this->db->expects($this->once())->method('beginTransaction'); + // Rollback MUST fire when audit insert throws; commit MUST NOT. + $this->db->expects($this->once())->method('rollBack'); + $this->db->expects($this->never())->method('commit'); + $this->auditTrailMapper ->method('insert') ->willThrowException(new \RuntimeException('audit storage broken')); $this->logger->expects($this->atLeastOnce())->method('error'); - // Despite the audit-write throwing, the row update must still - // succeed and the method must return the updated relation. - $result = $mapper->updateDecisionMetadata( + $this->expectException(\RuntimeException::class); + $mapper->updateDecisionMetadata( relation: $relation, fields: ['skipAnonymization' => true], actingUser: $this->user ); - - $this->assertTrue($result->getSkipAnonymization()); - } + }//end testAuditEmissionFailureRollsBackUpdateAndThrows() public function testFallsBackToSessionUserWhenActingUserIsNull(): void { @@ -284,16 +315,18 @@ public function testFallsBackToSessionUserWhenActingUserIsNull(): void $this->auditTrailMapper ->expects($this->once()) ->method('insert') - ->willReturnCallback(function (AuditTrail $entry) use (&$captured) { - $captured = $entry; - return $entry; - }); + ->willReturnCallback( + function (AuditTrail $entry) use (&$captured) { + $captured = $entry; + return $entry; + } + ); $mapper->updateDecisionMetadata(relation: $relation, fields: ['skipAnonymization' => true]); $this->assertNotNull($captured); $this->assertSame('alice', $captured->getUser()); - } + }//end testFallsBackToSessionUserWhenActingUserIsNull() public function testRecordsSystemActorWhenNoUserIsAvailable(): void { @@ -307,16 +340,18 @@ public function testRecordsSystemActorWhenNoUserIsAvailable(): void $this->auditTrailMapper ->expects($this->once()) ->method('insert') - ->willReturnCallback(function (AuditTrail $entry) use (&$captured) { - $captured = $entry; - return $entry; - }); + ->willReturnCallback( + function (AuditTrail $entry) use (&$captured) { + $captured = $entry; + return $entry; + } + ); $mapper->updateDecisionMetadata(relation: $relation, fields: ['skipAnonymization' => true]); $this->assertNotNull($captured); $this->assertSame('system', $captured->getUser()); - } + }//end testRecordsSystemActorWhenNoUserIsAvailable() public function testDispatchesEventOnSkipAnonymizationFlip(): void { @@ -330,9 +365,11 @@ public function testDispatchesEventOnSkipAnonymizationFlip(): void $this->eventDispatcher ->expects($this->once()) ->method('dispatchTyped') - ->willReturnCallback(function (EntityRelationDecisionUpdatedEvent $event) use (&$captured) { - $captured = $event; - }); + ->willReturnCallback( + function (EntityRelationDecisionUpdatedEvent $event) use (&$captured) { + $captured = $event; + } + ); $mapper->updateDecisionMetadata( relation: $relation, @@ -348,7 +385,7 @@ public function testDispatchesEventOnSkipAnonymizationFlip(): void $diff = $captured->getChangedFields(); $this->assertArrayHasKey('skipAnonymization', $diff); $this->assertSame(['previous' => false, 'new' => true], $diff['skipAnonymization']); - } + }//end testDispatchesEventOnSkipAnonymizationFlip() public function testDispatchesEventOnBasesChange(): void { @@ -361,9 +398,11 @@ public function testDispatchesEventOnBasesChange(): void $this->eventDispatcher ->expects($this->once()) ->method('dispatchTyped') - ->willReturnCallback(function (EntityRelationDecisionUpdatedEvent $event) use (&$captured) { - $captured = $event; - }); + ->willReturnCallback( + function (EntityRelationDecisionUpdatedEvent $event) use (&$captured) { + $captured = $event; + } + ); $mapper->updateDecisionMetadata( relation: $relation, @@ -377,7 +416,7 @@ public function testDispatchesEventOnBasesChange(): void $diff = $captured->getChangedFields(); $this->assertArrayHasKey('bases', $diff); $this->assertSame(['previous' => null, 'new' => ['uuid-a']], $diff['bases']); - } + }//end testDispatchesEventOnBasesChange() public function testNoEventDispatchedOnSemanticNoOp(): void { @@ -393,7 +432,64 @@ public function testNoEventDispatchedOnSemanticNoOp(): void fields: ['skipAnonymization' => true], actingUser: $this->user ); - } + }//end testNoEventDispatchedOnSemanticNoOp() + + public function testReorderedBasesAreSemanticNoOpAndSkipAudit(): void + { + $relation = new EntityRelation(); + $relation->setId(42); + $relation->setBases(['uuid-a', 'uuid-b']); + + $mapper = $this->mapperWithMockedUpdate(); + + // Audit + dispatch + DB writes MUST NOT fire on semantic no-op. + $this->auditTrailMapper->expects($this->never())->method('insert'); + $this->eventDispatcher->expects($this->never())->method('dispatchTyped'); + $this->db->expects($this->never())->method('beginTransaction'); + + $result = $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['bases' => ['uuid-b', 'uuid-a']], + actingUser: $this->user + ); + + // The stored bases order is preserved on no-op (no setBases call). + $this->assertSame(['uuid-a', 'uuid-b'], $result->getBases()); + }//end testReorderedBasesAreSemanticNoOpAndSkipAudit() + + public function testDuplicateBasesAreSemanticNoOpAgainstUniqueSet(): void + { + $relation = new EntityRelation(); + $relation->setId(42); + $relation->setBases(['uuid-a', 'uuid-b']); + + $mapper = $this->mapperWithMockedUpdate(); + $this->auditTrailMapper->expects($this->never())->method('insert'); + + $result = $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['bases' => ['uuid-a', 'uuid-b', 'uuid-a']], + actingUser: $this->user + ); + + $this->assertSame(['uuid-a', 'uuid-b'], $result->getBases()); + }//end testDuplicateBasesAreSemanticNoOpAgainstUniqueSet() + + public function testNullVsEmptyArrayBasesAreNotEqual(): void + { + $relation = new EntityRelation(); + $relation->setId(42); + $relation->setBases(null); + + $mapper = $this->mapperWithMockedUpdate(); + $this->auditTrailMapper->expects($this->once())->method('insert'); + + $mapper->updateDecisionMetadata( + relation: $relation, + fields: ['bases' => []], + actingUser: $this->user + ); + }//end testNullVsEmptyArrayBasesAreNotEqual() public function testDispatchFailureDoesNotMaskUpdate(): void { @@ -417,5 +513,5 @@ public function testDispatchFailureDoesNotMaskUpdate(): void ); $this->assertTrue($result->getSkipAnonymization()); - } -} + }//end testDispatchFailureDoesNotMaskUpdate() +}//end class diff --git a/tests/Unit/Db/EntityRelationTest.php b/tests/Unit/Db/EntityRelationTest.php index 1c46a73c4e48..0d420279a2f7 100644 --- a/tests/Unit/Db/EntityRelationTest.php +++ b/tests/Unit/Db/EntityRelationTest.php @@ -1,6 +1,23 @@ + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://OpenRegister.app + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Tests\Unit\Db; use DateTime; use OCA\OpenRegister\Db\EntityRelation; From 0251894725bf1dd9aee0808f9ff03eff1bac4d0b Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Mon, 18 May 2026 11:54:24 +0200 Subject: [PATCH 010/333] fix(entity-relation-grondslagen): call markAsAnonymized after DI anonymise path MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Wave 1.3 spec (`entity-relation-grondslagen`) is explicit: every file the anonymise flow successfully redacts MUST end with its EntityRelation rows flipped to `anonymized = 1` (except rows whose `skip_anonymization = 1`, which `markAsAnonymized` excludes per the existing WHERE-clause contract). Downstream consumers — DocuDesk's per-dossier grondslagen summary, audit-trail reporting, anonymise- status badges — depend on this flag to discriminate "this file went through redaction" from "this file was scanned but never anonymised." The HTTP-route path `FileTextController::anonymizeFile`-> mapper->markAsAnonymized() honours this. The DI path `FileService::anonymizeDocument` → `DocumentProcessingHandler::anonymizeDocument` — which is what DocuDesk's per-file and batch anonymise endpoints ultimately call — did NOT. It filtered by skip, built the replacements map, wrote the anonymised file, and returned without ever touching `anonymized` / `anonymized_value`. Every relation on every file DocuDesk redacted stayed at `anonymized = 0`, so: - the DI parallel was silently inconsistent with the HTTP path, - DocuDesk's `GrondslagenSummaryService::renderDossierSummary` (which queries `findAnonymisedEntitiesWithBasesForFile`, filtered on `r.anonymized = 1`) saw empty result sets and produced reports saying "Dit dossier bevat geen geanonimiseerde documenten" even immediately after a folder-wide anonymise that updated dozens of rows with `bases` and produced multiple anonymised PDFs. **Fix.** After `replaceWords` returns the anonymised file, call `entityRelationMapper->markAsAnonymized($sourceFileId, '[REDACTED]')` on the source's file id. The mapper's `AND skip_anonymization = 0` predicate preserves the operator's skip decisions per the existing contract. The placeholder value `[REDACTED]` is a generic representative — each entity received its own `[TYPE: key]` replacement key earlier in `anonymizeDocument`, but the `anonymized_value` column is a single per-file string rather than a per-row list, so we record a sentinel. **Failure isolation.** The mark step is wrapped in `try/catch`. A mapper failure does NOT mask the successful redaction — the anonymised file is already on disk by the time we get here, and re-throwing would force the controller to surface a "your file is gone" error when in fact the file is fine and only the audit flag update failed. The retry path (subsequent anonymise call on the same file) re-marks idempotently, and the warning log lets operators catch the divergence between disk state and DB state. Guard: skips the call when `$replacements` is empty (no entities to mark anonymised) or when `$fileId` is non-positive (synthetic / non-persisted node). --- .../File/DocumentProcessingHandler.php | 28 ++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/lib/Service/File/DocumentProcessingHandler.php b/lib/Service/File/DocumentProcessingHandler.php index fcc818b866e4..c543e5bc4bc8 100644 --- a/lib/Service/File/DocumentProcessingHandler.php +++ b/lib/Service/File/DocumentProcessingHandler.php @@ -192,7 +192,33 @@ public function anonymizeDocument(Node $node, array $entities): File $anonymizedFileName .= '.'.$fileExtension; } - return $this->replaceWords(node: $node, replacements: $replacements, outputName: $anonymizedFileName); + $anonymizedFile = $this->replaceWords(node: $node, replacements: $replacements, outputName: $anonymizedFileName); + + // Flip the source's EntityRelation rows to `anonymized = 1` so the + // anonymised state is queryable downstream. `markAsAnonymized` + // skips rows where `skip_anonymization = 1` per the + // `entity-relation-grondslagen` contract — operator skips are + // preserved. The placeholder value is a generic "[REDACTED]" + // because each entity got its own per-row replacement key earlier + // in this method; the column stores a single representative value + // per anonymise call, not the full per-entity placeholder list. + if (is_int($fileId) === true && $fileId > 0 && empty($replacements) === false) { + try { + $this->entityRelationMapper->markAsAnonymized($fileId, '[REDACTED]'); + } catch (\Throwable $e) { + // Persistence-side failure on the audit flag MUST NOT mask + // the successful redaction; the file is already written. + // Surface via warning log; downstream summary reports + // simply won't see this file until the next anonymise + // call retries the mark. + $this->logger->warning( + 'DocumentProcessingHandler: markAsAnonymized failed after redaction', + ['fileId' => $fileId, 'error' => $e->getMessage()] + ); + } + } + + return $anonymizedFile; }//end anonymizeDocument() /** From 6d81c124677cfe263b7fcc6d7d97068239b23de6 Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Mon, 18 May 2026 14:12:33 +0200 Subject: [PATCH 011/333] feat(entity-relation-grondslagen): use stable [: ] placeholder in DI anonymise path MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `DocumentProcessingHandler::anonymizeDocument` previously generated substitution placeholders from a fresh UUID prefix per call: $key = $entity['key'] ?? substr(Uuid::v4()->toRfc4122(), 0, 8); $replacements[$originalText] = '['.$entityType.': '.$key.']'; Two real problems: 1. **Non-idempotent.** Re-anonymising the same document with the same inputs produced byte-divergent output because the UUID prefix changed every call. Bad for forensics, bad for caching, bad for diff-based reviews. 2. **Reports can't reference the actual placeholder.** DocuDesk's grondslagen-summary report needs to show "for this anonymised file, the placeholder `X` corresponds to grondslag `Y`". With per-call UUID prefixes, the report can either (a) ingest the anonymised file and re-parse placeholders out of it (fragile) or (b) display a synthetic tag that doesn't match what's in the file (confusing). Neither is acceptable. **Fix.** Look up the stable `entity_id` from existing EntityRelation rows on the file and use it as the placeholder suffix: $entityIdMap = $entityRelationMapper->findEntityIdsByValueForFile($fileId); if (isset($entityIdMap[$originalText])) { $replacements[$originalText] = '['.$entityType.': '.$entityIdMap[$originalText]['id'].']'; } else { // Legacy fallback — entity not in relations table. $key = $entity['key'] ?? substr(Uuid::v4()->toRfc4122(), 0, 8); $replacements[$originalText] = '['.$entityType.': '.$key.']'; } New mapper helper `EntityRelationMapper::findEntityIdsByValueForFile( int $fileId): array` returns the distinct `(entity_value, entity_id, entity_type)` set for the file via a single JOIN. Same value mapping to multiple types takes the first match — callers discriminate at the substitution site with their own `entityType`. Properties of the new placeholder format: - **Stable across runs.** Same entity in same file always produces the same placeholder. Re-anonymise is now idempotent. - **Stable across files.** Same entity in different files produces the same placeholder. Cross-file forensics (`[PERSON: 42]` appears in N anonymised files) becomes a meaningful query. - **Matches the report.** DocuDesk's grondslagen-summary report generates the same tag from the same data; the report column and the in-file substitution are byte-identical. **Fallback retained** for direct DI callers that bypass extraction and pass entities not present in the relations table. The fallback keeps the legacy UUID-prefix behaviour so existing tests / external consumers don't break — they just don't get the stability benefit. **Drive-by clean-up.** Pulled the `$fileId` resolution out of the nested `method_exists($node, 'getId')` block and into a single top-of-method variable so the later `markAsAnonymized` and new `findEntityIdsByValueForFile` calls share a guarded local. Hides a latent (but harmless) undefined-variable warning on the post-write flag flip when `$node` lacked `getId`. --- lib/Db/EntityRelationMapper.php | 49 ++++++++++++++++++ .../File/DocumentProcessingHandler.php | 51 +++++++++++++++---- 2 files changed, 90 insertions(+), 10 deletions(-) diff --git a/lib/Db/EntityRelationMapper.php b/lib/Db/EntityRelationMapper.php index d0783a0cc097..7f74be23d848 100644 --- a/lib/Db/EntityRelationMapper.php +++ b/lib/Db/EntityRelationMapper.php @@ -238,6 +238,55 @@ public function findAnonymisedEntitiesWithBasesForFile(int $fileId): array return $rows; }//end findAnonymisedEntitiesWithBasesForFile() + /** + * Build a `(entity_value → {id, type})` map for every entity relation on a file. + * + * Used by `DocumentProcessingHandler::anonymizeDocument` to look up the + * stable `entity_id` for each entity occurrence so the in-file + * placeholder format `[: ]` matches what downstream + * consumers (DocuDesk's grondslagen-summary report) display. Without + * this lookup the anonymise step generates a fresh UUID-prefix per + * call, and the report's view of "what's in the file" diverges from + * the actual substitution. + * + * Returns a single entry per distinct `entity_value` on the file. + * When the same value is detected as multiple `entity_types`, the + * first one encountered wins — callers should use their own + * `entityType` to discriminate at the substitution site. + * + * @param int $fileId The Nextcloud file ID whose entity relations are mapped. + * + * @return array Map keyed by entity value. + */ + public function findEntityIdsByValueForFile(int $fileId): array + { + $qb = $this->db->getQueryBuilder(); + $qb->selectDistinct(['e.id', 'e.type', 'e.value']) + ->from($this->getTableName(), 'r') + ->innerJoin('r', 'openregister_entities', 'e', $qb->expr()->eq('r.entity_id', 'e.id')) + ->where($qb->expr()->eq('r.file_id', $qb->createNamedParameter($fileId, IQueryBuilder::PARAM_INT))); + + $result = $qb->executeQuery(); + $rows = $result->fetchAll(); + $result->closeCursor(); + + $map = []; + foreach ($rows as $row) { + $value = (string) ($row['value'] ?? ''); + if ($value === '' || isset($map[$value]) === true) { + continue; + } + + $map[$value] = [ + 'id' => (int) ($row['id'] ?? 0), + 'type' => (string) ($row['type'] ?? ''), + ]; + } + + return $map; + + }//end findEntityIdsByValueForFile() + /** * Mark entity relations as anonymized. * diff --git a/lib/Service/File/DocumentProcessingHandler.php b/lib/Service/File/DocumentProcessingHandler.php index c543e5bc4bc8..8611678ef407 100644 --- a/lib/Service/File/DocumentProcessingHandler.php +++ b/lib/Service/File/DocumentProcessingHandler.php @@ -155,17 +155,36 @@ public function replaceWords(Node $node, array $replacements, ?string $outputNam */ public function anonymizeDocument(Node $node, array $entities): File { + // Resolve the source file id once — the substitution placeholder + // format and the post-redaction audit flag both key off it. + $fileId = 0; + if (method_exists($node, 'getId') === true) { + $candidate = $node->getId(); + if (is_int($candidate) === true && $candidate > 0) { + $fileId = $candidate; + } + } + // Defensive filter — per the `entity-relation-grondslagen` change, // the DI anonymise path MUST honour the operator's skip decisions // even when the caller's entities[] array includes flagged // occurrences. The OR contract is "skipped relations are never // redacted, full stop", regardless of caller filtering behaviour. $skippedValues = []; - if (method_exists($node, 'getId') === true) { - $fileId = $node->getId(); - if (is_int($fileId) === true && $fileId > 0) { - $skippedValues = $this->entityRelationMapper->findSkippedEntityValuesForFile($fileId); - } + if ($fileId > 0) { + $skippedValues = $this->entityRelationMapper->findSkippedEntityValuesForFile($fileId); + } + + // Resolve the existing entity-id map for this file so substitutions + // use the stable `[: ]` placeholder format — + // matches what DocuDesk's grondslagen-summary report shows and + // makes re-runs of anonymise on the same document idempotent + // (the previous UUID-prefix fallback produced a fresh placeholder + // per call, so re-anonymising the same file produced byte-divergent + // output despite identical inputs). + $entityIdMap = []; + if ($fileId > 0) { + $entityIdMap = $this->entityRelationMapper->findEntityIdsByValueForFile($fileId); } // Build replacements array from entities. @@ -173,14 +192,26 @@ public function anonymizeDocument(Node $node, array $entities): File foreach ($entities as $entity) { $originalText = $entity['text'] ?? ''; $entityType = $entity['entityType'] ?? 'UNKNOWN'; - $key = $entity['key'] ?? substr(\Symfony\Component\Uid\Uuid::v4()->toRfc4122(), 0, 8); - if (empty($originalText) === false - && in_array($originalText, $skippedValues, true) === false + if (empty($originalText) === true + || in_array($originalText, $skippedValues, true) === true ) { + continue; + } + + // Prefer stable per-entity placeholder. Fall back to the + // legacy UUID-prefix only when there is no matching entity + // row on the file (shouldn't happen in the normal + // extract → review → anonymise flow, but defensive against + // direct DI callers that bypass extraction). + if (isset($entityIdMap[$originalText]) === true) { + $stableId = $entityIdMap[$originalText]['id']; + $replacements[$originalText] = '['.$entityType.': '.$stableId.']'; + } else { + $key = $entity['key'] ?? substr(\Symfony\Component\Uid\Uuid::v4()->toRfc4122(), 0, 8); $replacements[$originalText] = '['.$entityType.': '.$key.']'; } - } + }//end foreach // Generate anonymized file name. $fileName = $node->getName(); @@ -202,7 +233,7 @@ public function anonymizeDocument(Node $node, array $entities): File // because each entity got its own per-row replacement key earlier // in this method; the column stores a single representative value // per anonymise call, not the full per-entity placeholder list. - if (is_int($fileId) === true && $fileId > 0 && empty($replacements) === false) { + if ($fileId > 0 && empty($replacements) === false) { try { $this->entityRelationMapper->markAsAnonymized($fileId, '[REDACTED]'); } catch (\Throwable $e) { From 65950352269b93c607bbe1f30780dfcee46a7c45 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Mon, 18 May 2026 21:41:21 +0200 Subject: [PATCH 012/333] fix(phpcs): 7 errors introduced in this PR's diff --- lib/Service/File/FolderManagementHandler.php | 2 +- lib/Service/FileService.php | 2 +- lib/Service/Object/SaveObject.php | 45 ++++++++++---------- 3 files changed, 25 insertions(+), 24 deletions(-) diff --git a/lib/Service/File/FolderManagementHandler.php b/lib/Service/File/FolderManagementHandler.php index 39eca2a2a7ad..551ffb9a43c2 100644 --- a/lib/Service/File/FolderManagementHandler.php +++ b/lib/Service/File/FolderManagementHandler.php @@ -161,7 +161,7 @@ public function createEntityFolder(Register | ObjectEntity $entity): ?Node ] ); return null; - } + }//end try }//end createEntityFolder() /** diff --git a/lib/Service/FileService.php b/lib/Service/FileService.php index c77c4ccbe254..34d9c0f2d2c7 100644 --- a/lib/Service/FileService.php +++ b/lib/Service/FileService.php @@ -681,7 +681,7 @@ public function createEntityFolder(Register | ObjectEntity $entity): ?Node ] ); return null; - } + }//end try }//end createEntityFolder() /** diff --git a/lib/Service/Object/SaveObject.php b/lib/Service/Object/SaveObject.php index 7b9a6832c3ae..a7cd3cce14c4 100644 --- a/lib/Service/Object/SaveObject.php +++ b/lib/Service/Object/SaveObject.php @@ -253,28 +253,29 @@ class SaveObject /** * Constructor for SaveObject handler. * - * @param MagicMapper $objectEntityMapper Object entity mapper - * @param MagicMapper $unifiedObjectMapper Unified object mapper for object operations - * @param MetadataHydrationHandler $metaHydrationHandler Handler for metadata extraction - * @param FilePropertyHandler $filePropertyHandler Handler for file property operations - * @param LinkedEntityPropertyHandler $linkedEntityHandler Linked entity property handler - * @param IUserSession $userSession User session service - * @param AuditTrailMapper $auditTrailMapper Audit trail mapper for logging changes - * @param SchemaMapper $schemaMapper Schema mapper for schema operations - * @param RegisterMapper $registerMapper Register mapper for register operations - * @param IURLGenerator $urlGenerator URL generator service - * @param OrganisationService $organisationService Service for organisation operations - * @param CacheHandler $cacheHandler Object cache service for entity and query caching - * @param SettingsService $settingsService Settings service for accessing trail settings - * @param PropertyRbacHandler $propertyRbacHandler Property-level RBAC handler - * @param ComputedFieldHandler $computedFieldHandler Handler for computed field evaluation - * @param TranslationHandler $translationHandler Handler for translation operations - * @param LoggerInterface $logger Logger interface for logging operations - * @param TmloService $tmloService TMLO archival metadata service - * @param ArrayLoader $arrayLoader Twig array loader for template rendering - * @param IGroupManager|null $groupManager Group manager for admin-bypass detection - * @param IAppConfig|null $appConfig App-config reader for the admin-bypass toggle - * @param IEventDispatcher|null $eventDispatcher Event dispatcher for reference validation events + * @param MagicMapper $objectEntityMapper Object entity mapper + * @param MagicMapper $unifiedObjectMapper Unified object mapper for object operations + * @param MetadataHydrationHandler $metaHydrationHandler Handler for metadata extraction + * @param FilePropertyHandler $filePropertyHandler Handler for file property operations + * @param LinkedEntityPropertyHandler $linkedEntityHandler Linked entity property handler + * @param IUserSession $userSession User session service + * @param AuditTrailMapper $auditTrailMapper Audit trail mapper for logging changes + * @param SchemaMapper $schemaMapper Schema mapper for schema operations + * @param RegisterMapper $registerMapper Register mapper for register operations + * @param IURLGenerator $urlGenerator URL generator service + * @param OrganisationService $organisationService Service for organisation operations + * @param CacheHandler $cacheHandler Object cache service for entity and query caching + * @param SettingsService $settingsService Settings service for accessing trail settings + * @param PropertyRbacHandler $propertyRbacHandler Property-level RBAC handler + * @param ComputedFieldHandler $computedFieldHandler Handler for computed field evaluation + * @param TranslationHandler $translationHandler Handler for translation operations + * @param LoggerInterface $logger Logger interface for logging operations + * @param TmloService $tmloService TMLO archival metadata service + * @param \OCA\OpenRegister\Service\File\FolderManagementHandler $folderManagementHandler Folder access-control gateway (cross-tenant denial) + * @param ArrayLoader $arrayLoader Twig array loader for template rendering + * @param IGroupManager|null $groupManager Group manager for admin-bypass detection + * @param IAppConfig|null $appConfig App-config reader for the admin-bypass toggle + * @param IEventDispatcher|null $eventDispatcher Event dispatcher for reference validation events * * @SuppressWarnings(PHPMD.ExcessiveParameterList) Nextcloud DI requires constructor injection * From e9b39af461c98e8852bdb3b47e00bdd35a4d965a Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Mon, 18 May 2026 21:56:45 +0200 Subject: [PATCH 013/333] fix(tests): align EmailServiceTest + FileTextControllerTest with PR API MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - EmailServiceTest: PHPUnit 10+ strict separation — move `find` from addMethods() into onlyMethods() since EmailLinkMapper::find() exists in this PR's lib. - FileTextControllerTest: anonymise flow now reads pre-detected entities via EntityRelationMapper::findEntitiesForAnonymization() instead of findEntitiesForFile(); update mock method names in 4 spots. --- tests/Unit/Controller/FileTextControllerTest.php | 8 ++++---- tests/Unit/Service/EmailServiceTest.php | 3 +-- 2 files changed, 5 insertions(+), 6 deletions(-) diff --git a/tests/Unit/Controller/FileTextControllerTest.php b/tests/Unit/Controller/FileTextControllerTest.php index b7475d8293dc..e16ebec3ee43 100644 --- a/tests/Unit/Controller/FileTextControllerTest.php +++ b/tests/Unit/Controller/FileTextControllerTest.php @@ -564,7 +564,7 @@ public function testAnonymizeFileNoEntities(): void $fileNode = $this->createMock(\OCP\Files\File::class); $fileNode->method('getName')->willReturn('test.pdf'); $this->fileService->method('getFileById')->willReturn($fileNode); - $this->entityRelationMapper->method('findEntitiesForFile')->willReturn([]); + $this->entityRelationMapper->method('findEntitiesForAnonymization')->willReturn([]); $result = $this->controller->anonymizeFile(1); @@ -590,7 +590,7 @@ public function testAnonymizeFileSuccess(): void 'entity_type' => 'SSN', ], ]; - $this->entityRelationMapper->method('findEntitiesForFile') + $this->entityRelationMapper->method('findEntitiesForAnonymization') ->with(10) ->willReturn($entityData); @@ -647,7 +647,7 @@ public function testAnonymizeFileDeduplicatesEntities(): void 'entity_type' => 'ORGANIZATION', ], ]; - $this->entityRelationMapper->method('findEntitiesForFile') + $this->entityRelationMapper->method('findEntitiesForAnonymization') ->willReturn($entityData); $anonymizedFileNode = $this->createMock(\OCP\Files\File::class); @@ -701,7 +701,7 @@ public function testAnonymizeFileExceptionDuringAnonymization(): void 'entity_type' => 'PERSON', ], ]; - $this->entityRelationMapper->method('findEntitiesForFile') + $this->entityRelationMapper->method('findEntitiesForAnonymization') ->willReturn($entityData); $this->fileService->method('anonymizeDocument') diff --git a/tests/Unit/Service/EmailServiceTest.php b/tests/Unit/Service/EmailServiceTest.php index 6039c65b1e8e..e40348605816 100644 --- a/tests/Unit/Service/EmailServiceTest.php +++ b/tests/Unit/Service/EmailServiceTest.php @@ -28,8 +28,7 @@ protected function setUp(): void { $this->emailLinkMapper = $this->getMockBuilder(EmailLinkMapper::class) ->disableOriginalConstructor() - ->onlyMethods(['findByObjectUuid', 'countByObjectUuid', 'findBySender', 'findByObjectAndMessage', 'deleteByObjectUuid', 'insert', 'delete']) - ->addMethods(['find']) + ->onlyMethods(['findByObjectUuid', 'countByObjectUuid', 'findBySender', 'findByObjectAndMessage', 'deleteByObjectUuid', 'insert', 'delete', 'find']) ->getMock(); $this->appManager = $this->createMock(IAppManager::class); $this->db = $this->createMock(IDBConnection::class); From 1f0708d260bffe9213bc477de8f264afdcffd09f Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Mon, 18 May 2026 22:52:46 +0200 Subject: [PATCH 014/333] fix(tests): add FolderManagementHandler mock to SaveObject test files PR #1431 added FolderManagementHandler as 19th constructor arg of SaveObject. SaveObjectCircularReferenceTest and SaveObjectReferenceValidationTest still constructed SaveObject without it, producing 23 ArgumentCountError failures in PHPUnit. Inject a mock via named args at the correct position. --- tests/Unit/Service/Object/SaveObjectCircularReferenceTest.php | 1 + tests/Unit/Service/Object/SaveObjectReferenceValidationTest.php | 2 ++ 2 files changed, 3 insertions(+) diff --git a/tests/Unit/Service/Object/SaveObjectCircularReferenceTest.php b/tests/Unit/Service/Object/SaveObjectCircularReferenceTest.php index c77a3064a318..85b94e08ec82 100644 --- a/tests/Unit/Service/Object/SaveObjectCircularReferenceTest.php +++ b/tests/Unit/Service/Object/SaveObjectCircularReferenceTest.php @@ -81,6 +81,7 @@ private function buildHandler( translationHandler: $this->createMock(\OCA\OpenRegister\Service\Object\TranslationHandler::class), logger: $this->createMock(LoggerInterface::class), tmloService: $this->createMock(\OCA\OpenRegister\Service\TmloService::class), + folderManagementHandler: $this->createMock(\OCA\OpenRegister\Service\File\FolderManagementHandler::class), arrayLoader: new ArrayLoader(), groupManager: $this->createMock(IGroupManager::class), appConfig: $this->createMock(IAppConfig::class), diff --git a/tests/Unit/Service/Object/SaveObjectReferenceValidationTest.php b/tests/Unit/Service/Object/SaveObjectReferenceValidationTest.php index adeadb0db5b2..f235a5176b64 100644 --- a/tests/Unit/Service/Object/SaveObjectReferenceValidationTest.php +++ b/tests/Unit/Service/Object/SaveObjectReferenceValidationTest.php @@ -85,6 +85,7 @@ private function buildHandler( translationHandler: $this->createMock(\OCA\OpenRegister\Service\Object\TranslationHandler::class), logger: $this->createMock(LoggerInterface::class), tmloService: $this->createMock(\OCA\OpenRegister\Service\TmloService::class), + folderManagementHandler: $this->createMock(\OCA\OpenRegister\Service\File\FolderManagementHandler::class), arrayLoader: new ArrayLoader(), groupManager: $groupManager, appConfig: $appConfig, @@ -651,6 +652,7 @@ public function testStrictnessWarnDoesNotThrowOnMissingReference(): void translationHandler: $this->createMock(\OCA\OpenRegister\Service\Object\TranslationHandler::class), logger: $logger, tmloService: $this->createMock(\OCA\OpenRegister\Service\TmloService::class), + folderManagementHandler: $this->createMock(\OCA\OpenRegister\Service\File\FolderManagementHandler::class), arrayLoader: new ArrayLoader(), groupManager: $this->makeAdminGroupManager(false), appConfig: $this->makeAppConfig('true'), From 4b10cc20627a7246f8a6763c6604de7f2489d9f9 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Tue, 19 May 2026 04:33:55 +0200 Subject: [PATCH 015/333] fix(tests): invert ObjectFolder numeric-string test to match new contract MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The PR changed ObjectService::ensureObjectFolder to no longer auto-recreate folders when getFolder() returns a numeric string — those are valid integer folder ids stored in the varchar(255) `_folder` column. The earlier `is_string($folder) === true` clause matched ANY non-empty string and was clobbering valid bindings on every update. `testEnsureObjectFolderRecreatesWhenFolderIsStringNumeric` was asserting the OLD (buggy) behavior — it passed in isolation because the Entity setter cast int 42 → string '42' which then hit the now- removed recreation branch. After the production fix, the if-block no longer fires and the test gets null where it expected 42. Renamed + inverted: `testEnsureObjectFolderDoesNotRecreateWhenFolderIsNumericString` now asserts: - `createObjectFolderWithoutUpdate` is NEVER called - result is `null` (no recreation) which matches the new `is_numeric($folder) === false` guard. Verified: full PHPUnit suite 12,252 tests / 26,005 assertions / 0 errors / 0 failures. --- tests/Unit/Service/ObjectServiceTest.php | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) diff --git a/tests/Unit/Service/ObjectServiceTest.php b/tests/Unit/Service/ObjectServiceTest.php index de03ae3c88c1..6e19dfba9895 100644 --- a/tests/Unit/Service/ObjectServiceTest.php +++ b/tests/Unit/Service/ObjectServiceTest.php @@ -2743,25 +2743,31 @@ public function testEnsureObjectFolderReturnsNullOnGeneralException(): void } /** - * Test ensureObjectFolder recreates folder when folder is a string numeric value. - * Entity getFolder() returns string for numeric values, triggering recreation. + * Test ensureObjectFolder DOES NOT recreate when folder is a numeric string. + * + * The `_folder` column is `varchar(255)` — every populated value is a + * string. The earlier `is_string($folder) === true` clause was a bug: + * it matched ANY non-empty string and so triggered an auto-create on + * every update, overwriting valid folder bindings with freshly- + * generated auto-folders. The fix restricts the string branch to + * non-numeric strings (legacy path values pre-dating the integer-id + * storage convention); numeric strings like '42' are valid folder ids + * and MUST be kept. */ - public function testEnsureObjectFolderRecreatesWhenFolderIsStringNumeric(): void + public function testEnsureObjectFolderDoesNotRecreateWhenFolderIsNumericString(): void { $entity = new ObjectEntity(); $entity->setId(1); - $entity->setFolder(42); + $entity->setFolder('42'); $this->objectEntityMapper->method('find') ->willReturn($entity); - // Entity stores 42 as '42' (string), so isString===true triggers recreation. - $this->fileService->expects($this->once()) - ->method('createObjectFolderWithoutUpdate') - ->willReturn(42); + $this->fileService->expects($this->never()) + ->method('createObjectFolderWithoutUpdate'); $result = $this->invokePrivate('ensureObjectFolder', ['existing-uuid']); - $this->assertSame(42, $result); + $this->assertNull($result); } } From eb02e6b412553c9eabf3cb82a801369831b8437a Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Tue, 19 May 2026 11:55:37 +0200 Subject: [PATCH 016/333] fix(entity-relation-grondslagen): address PR #1503 re-review (blocker + 2 concerns) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 🔴 Double markAsAnonymized on the HTTP path — FileTextController::anonymizeFile called markAsAnonymized($fileId, 'anonymized_') after DocumentProcessingHandler::anonymizeDocument already called markAsAnonymized($fileId, '[REDACTED]'). The second UPDATE overwrote the first, leaving rows with an anonymizedValue that didn't match what was actually written to the file content. Pick the canonical caller per option (b) — DocumentProcessingHandler is on every redaction path (HTTP, DI, event listeners); the controller is bypassed by non-HTTP paths. Remove the controller-side call; update the two affected FileTextControllerTest expectations from once() → never() with explanatory comments. 🟡 DI wiring inconsistency — EntityRelationMapper is the only IEventDispatcher-dependent mapper without an explicit registerService() block. Other event-dispatcher-dependent mappers (SchemaMapper, RegisterMapper, MagicMapper, WebhookMapper) are wired explicitly. Add the EntityRelationMapper block next to MagicMapper, matching the same pattern. Removes the autowiring question. 🟡 Placeholder format unspec'd + correlation acknowledgement — add two ADDED Requirements to the spec: (1) the DI anonymise path MUST substitute each entity using the stable [: ] placeholder format, with three scenarios covering stable id, idempotency on re-anonymise, and the fallback to UUID fragment for entries missing from the entity catalogue; (2) DocumentProcessingHandler is the sole canonical caller of markAsAnonymized in the redaction flow. Also add a Notes section documenting the cross-document correlation property of the placeholder choice and the privacy threat model (within-tenant correlation is in-scope and required by the consumer report). openspec validate entity-relation-grondslagen — clean. --- lib/AppInfo/Application.php | 19 ++++++ lib/Controller/FileTextController.php | 18 +++-- .../specs/entity-relation-grondslagen/spec.md | 66 +++++++++++++++++++ .../Controller/FileTextControllerTest.php | 15 +++-- 4 files changed, 107 insertions(+), 11 deletions(-) diff --git a/lib/AppInfo/Application.php b/lib/AppInfo/Application.php index dd45feea8d55..da0cdbd09bb7 100644 --- a/lib/AppInfo/Application.php +++ b/lib/AppInfo/Application.php @@ -451,6 +451,25 @@ function (ContainerInterface $container) { } ); + // EntityRelationMapper is registered explicitly because it constructor-injects + // `IEventDispatcher` to dispatch `EntityRelationDecisionUpdatedEvent`. Every + // other event-dispatcher-dependent mapper in this method (SchemaMapper, + // RegisterMapper, MagicMapper, WebhookMapper) is wired explicitly to avoid + // depending on NC's autowirer resolution of framework-interface keys, which + // has historically been version-sensitive. + $context->registerService( + EntityRelationMapper::class, + function (ContainerInterface $container) { + return new EntityRelationMapper( + db: $container->get('OCP\IDBConnection'), + auditTrailMapper: $container->get(\OCA\OpenRegister\Db\AuditTrailMapper::class), + userSession: $container->get('OCP\IUserSession'), + eventDispatcher: $container->get('OCP\EventDispatcher\IEventDispatcher'), + logger: $container->get('Psr\Log\LoggerInterface') + ); + } + ); + }//end registerMappersWithCircularDependencies() /** diff --git a/lib/Controller/FileTextController.php b/lib/Controller/FileTextController.php index 14b55b276ca7..dc39262f3280 100644 --- a/lib/Controller/FileTextController.php +++ b/lib/Controller/FileTextController.php @@ -540,15 +540,19 @@ public function anonymizeFile(int $fileId): JSONResponse ] ); - // Perform anonymization. + // Perform anonymization. `anonymizeDocument` is the canonical + // caller of `EntityRelationMapper::markAsAnonymized` per the + // `entity-relation-grondslagen` Requirement on canonical + // marking ownership: marking the source's relation rows is the + // responsibility of the redaction path itself (which exists on + // every entry point — HTTP, DI, event listeners), not the + // controller (which is bypassed by the non-HTTP paths). A + // controller-side mark would conflict with the DocumentProcessingHandler's + // mark on this same fileId (second UPDATE overwrites + // `anonymized_value`), so this controller MUST NOT call + // `markAsAnonymized` directly. $anonymizedFile = $this->fileService->anonymizeDocument($fileNode, $entities); - // Mark entity relations as anonymized. - $this->entityRelationMapper->markAsAnonymized( - fileId: $fileId, - anonymizedValue: 'anonymized_'.date('Y-m-d_H-i-s') - ); - $this->logger->info( message: '[FileTextController] File anonymized successfully', context: [ diff --git a/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md b/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md index 631c915fcb6e..882d842f3034 100644 --- a/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md +++ b/openspec/changes/entity-relation-grondslagen/specs/entity-relation-grondslagen/spec.md @@ -352,6 +352,58 @@ The mapper accepts any string array; OpenRegister MUST NOT issue any cross-regis - **AND** no error MUST be raised - **AND** no cross-register query MUST be issued +### Requirement: The DI anonymise path MUST substitute each entity using the stable `[: ]` placeholder format + +`DocumentProcessingHandler::anonymizeDocument` MUST substitute each detected entity occurrence with a placeholder of the form `[: ]`, where: + +- `` is the entity's `entityType` (e.g. `PERSON`, `ORGANIZATION`, `LOCATION`, `EMAIL`, `BSN`). +- `` is the integer primary key of the matching row in `openregister_entities` (the canonical entity catalogue), looked up via `EntityRelationMapper::findEntityIdsByValueForFile($fileId)` for the file being anonymised. +- Whitespace MUST be exactly one space between the colon and the id. + +The placeholder is stable across anonymise calls on the same source file: re-running the redaction with the same entity catalogue produces byte-identical output, which is required for the grondslagen-summary report's traceability invariant. + +Fallback: when an entity in the substitution map has no matching row in `openregister_entities` for the file (an edge case for DI callers that bypass the standard detection path), the implementation MAY fall back to a per-call 8-character UUID fragment as `` — this is not stable across calls but preserves the placeholder shape. Implementations SHOULD log a warning when this fallback is invoked. + +#### Scenario: Stable placeholder uses the entity catalogue id + +- **GIVEN** an `openregister_entities` row with `id=7`, `value="Jan Jansen"`, `type="PERSON"` +- **AND** an `EntityRelation` referencing that entity on a file +- **WHEN** `DocumentProcessingHandler::anonymizeDocument` runs for that file with `{ text: "Jan Jansen", entityType: "PERSON" }` +- **THEN** every occurrence of "Jan Jansen" in the redacted file content MUST be replaced with the literal string `[PERSON: 7]` + +#### Scenario: Re-anonymising the same file is byte-identical + +- **GIVEN** a file whose anonymised output was produced via this path at time T₁ +- **WHEN** the same file is re-anonymised at time T₂ with the same entity catalogue state +- **THEN** the anonymised output at T₂ MUST be byte-identical to the output at T₁ +- **AND** every placeholder MUST carry the same `` it had at T₁ + +#### Scenario: Missing entity row falls back to per-call UUID fragment + +- **GIVEN** a DI caller passes an entity `{ text: "Jane Doe", entityType: "PERSON" }` that does NOT correspond to any row in `openregister_entities` for this file +- **WHEN** the anonymise path runs +- **THEN** the placeholder MUST follow the shape `[PERSON: <8-char-hex>]` where the hex is a UUID v4 fragment +- **AND** a warning MUST be logged identifying the fallback (without including the entity text per ADR-005) + +### Requirement: Sole canonical caller of `markAsAnonymized` for the redaction flow MUST be `DocumentProcessingHandler::anonymizeDocument` + +To prevent double-write conflicts where two callers both invoke `EntityRelationMapper::markAsAnonymized($fileId, ...)` on the same file (the second UPDATE overwrites the first's `anonymizedValue`), the call MUST be made by exactly ONE component in the redaction code path: `DocumentProcessingHandler::anonymizeDocument`. The HTTP controller (`FileTextController::anonymizeFile`) and any event listeners or DI orchestrators MUST NOT call `markAsAnonymized` independently — they invoke `anonymizeDocument`, and `anonymizeDocument` handles the marking. + +The value written to `anonymizedValue` is a generic per-file marker (`'[REDACTED]'`), not the per-entity placeholder. Per-entity placeholders are recorded by the per-row substitution that happens inside the file content; the column's purpose is binary "this file's relations have been redacted at least once" plus a generic marker for audit log readability. + +#### Scenario: HTTP anonymise call writes exactly one mark + +- **GIVEN** a `POST /api/files/:fileId/anonymize` call against a file with non-skipped entities +- **WHEN** the controller invokes `FileService::anonymizeDocument` which delegates to `DocumentProcessingHandler::anonymizeDocument` +- **THEN** `EntityRelationMapper::markAsAnonymized` MUST be called exactly once for this fileId +- **AND** the controller MUST NOT issue its own `markAsAnonymized` call + +#### Scenario: DI/event anonymise call writes exactly one mark + +- **GIVEN** an event listener or DI orchestrator invokes `DocumentProcessingHandler::anonymizeDocument` +- **WHEN** the anonymise path runs to completion +- **THEN** `markAsAnonymized` MUST be called exactly once for this fileId, by `anonymizeDocument` itself + ### Requirement: The change MUST be additive in API shape; only anonymise behaviour gains a skip filter The existing API endpoints — `FileService::anonymizeDocument(Node, entities[])` (DI) and `POST /api/files/:fileId/anonymize` (HTTP) — MUST keep their existing parameters and response shape. They MUST NOT consume any new field on entity-payload entries (e.g. erroneous `bases` on payload entries MUST be silently ignored). `EntityRelationMapper::markAsAnonymized`'s signature MUST be unchanged; only its WHERE clause gains the `AND skip_anonymization = 0` predicate. @@ -399,6 +451,20 @@ This change adds a **decision-time** write path (the PATCH endpoint) and a **fil Each `EntityRelation` row is one detected occurrence at one offset. The PATCH endpoint operates per-row, so operators CAN express different decisions for different occurrences of the same entity within the same file — for example, set `skipAnonymization=true` at position 100 while leaving position 250 unflagged. Whether any consumer UI surfaces that fine-grained capability is a separate question. DocuDesk's review UI typically aggregates at entity level for ergonomic reasons (one decision per `(fileId, entityId)`, written to all matching relations); other consumers can use the finer granularity if they need it. +### Placeholder format and cross-document correlation + +The `[: ]` placeholder is **deliberately stable** across documents within a single OpenRegister tenant: two anonymised documents that referenced the same canonical entity (same row in `openregister_entities`) will carry the same placeholder id. This is required for the grondslagen-summary report consumers to thread an entity through multiple files in a dossier — without stable ids the reports cannot answer "where else does this anonymised entity appear?". + +This stability has a known privacy property: an analyst with access to multiple anonymised documents from the same tenant can correlate placeholders (i.e. determine that `[PERSON: 42]` in document A refers to the same person as `[PERSON: 42]` in document B), even without resolving 42 to a real identity. We treat this as **in-scope** behaviour, not a leak, because: + +1. The consumer use case (Woo dossier reports) actively depends on it. +2. Cross-tenant correlation is impossible — `openregister_entities` lives in each tenant's database, and the primary key sequences are independent. +3. Within-tenant correlation is also possible through legitimate channels (a single Woo dossier publishes multiple correlated documents by design). + +A hashed identifier (e.g. HMAC of `(entityId, salt)` with a per-tenant salt) would carry the same in-tenant stability, but also preserve correlation — so it doesn't change the privacy property. A per-document salt would defeat correlation but break the consumer use case. The choice of raw `entity_id` is the simplest implementation that meets the consumer requirement without changing the threat model. + +The placeholder format is captured normatively in the corresponding Requirement above. Implementations MUST emit it exactly. + ### Decision-vs-state separation The PATCH whitelist (`bases`, `skipAnonymization`) is intentionally **decision-only**. The post-hoc system fields `anonymized` and `anonymizedValue` record what the redaction code path actually did; they are written by `markAsAnonymized` (or future system-level redaction paths) and MUST NEVER be writable by an operator. Letting operators flip those would manufacture false audit history (claim a redaction without one having happened) and break the audit-trail invariant "`anonymized=true` ⟹ the redaction code ran for this row". \ No newline at end of file diff --git a/tests/Unit/Controller/FileTextControllerTest.php b/tests/Unit/Controller/FileTextControllerTest.php index e16ebec3ee43..0414dc80d538 100644 --- a/tests/Unit/Controller/FileTextControllerTest.php +++ b/tests/Unit/Controller/FileTextControllerTest.php @@ -610,9 +610,14 @@ public function testAnonymizeFileSuccess(): void })) ->willReturn($anonymizedFileNode); - $this->entityRelationMapper->expects($this->once()) - ->method('markAsAnonymized') - ->with(10, $this->stringStartsWith('anonymized_')); + // Per PR #1503 review: the controller MUST NOT call + // markAsAnonymized — it's the redaction path's responsibility + // (DocumentProcessingHandler::anonymizeDocument, which is mocked + // here via $this->fileService). A controller-side mark would + // race the redaction-path mark on this same fileId and clobber + // the per-entity placeholder values. + $this->entityRelationMapper->expects($this->never()) + ->method('markAsAnonymized'); $result = $this->controller->anonymizeFile(10); @@ -662,7 +667,9 @@ public function testAnonymizeFileDeduplicatesEntities(): void })) ->willReturn($anonymizedFileNode); - $this->entityRelationMapper->expects($this->once()) + // Same as above: marking ownership belongs to the redaction + // path (mocked via $this->fileService), not the controller. + $this->entityRelationMapper->expects($this->never()) ->method('markAsAnonymized'); $result = $this->controller->anonymizeFile(5); From 7d6158b500791db36f085388d98a766e813fcde4 Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Tue, 19 May 2026 12:52:53 +0200 Subject: [PATCH 017/333] fix(validate-self-folder-access): address PR #1431 review (3 blockers + 4 concerns + 2 minors) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 🔴 403 body echoes attempted folder ID — folder existence oracle. Removed the `folder` field from `folderAccessDeniedResponse()`. Caller already knows which ID they sent; echoing it confirmed by-shape whether the folder exists. Attempted ID still recorded server-side in the audit trail and in a server-only info log. Updated spec.md, CHANGELOG.md, and the existing create-path test (now asserts the body MUST NOT have a `folder` key). 🔴 update() and patch() controller 403 paths now have test coverage. Added `testUpdateReturns403WithStructuredBodyOnFolderAccessDenied` and `testPostPatchReturns403WithStructuredBodyOnFolderAccessDenied` following the same pattern as the existing create test. Regression- tests the catch-block ordering for both endpoints. 🔴 Double access-check / inconsistent currentUser. Added `?IUser $currentUser = null` parameter to `SaveObject::setSelfMetadata` and pass it through to `FolderManagementHandler::assertFolderIsAccessible`. Both enforcement sites now use the same explicit user when one is provided, defaulting to session fallback when null. Removes the "setSelfMetadata uses session, createObjectFolderById uses explicit user" inconsistency. Added comment explaining the contract. 🔴 phpcs CI failure — stale. CI is now green on this branch (gh pr checks 1431 shows deploy/Build and validate passing); the violation that was flagged on 2026-05-07 was resolved in commit `6595035` (fix(phpcs): 7 errors introduced in this PR's diff). No further action needed. 🟡 assertFolderIsAccessible is public — added `final` keyword to the method and an `@internal` docblock note explaining that overrides void the default-deny security invariant. Prevents future subclasses from weakening the access check. 🟡 Missing currentUser pass-through — addressed by the same fix as the double-access-check blocker (above). The two findings are the same issue at different layers. 🟡 logFolderAccessDenied sets object=0 / session=$actorUid — documented `object = 0` as the canonical sentinel for pre-persist denial events (MySQL/Postgres autoincrement starts at 1, so 0 cannot collide). Changed `setSession($actorUid)` to `setSession('')` (empty string, since the column is NOT NULL) — the UID is already in the `user` field, so duplicating it into `session` adds no forensic value and misleads session-correlation analysis. 🟡 update/patch test coverage — addressed by the test additions for the related blocker. 🟢 FolderAccessDeniedException $code default conflated HTTP status with application error code. Added `public const HTTP_STATUS = 403` class constant; changed constructor default `$code` from `403` to `0` (the PHP-conventional "no error code" value). Updated `folderAccessDeniedResponse` to use the constant. Future callers using `$exception->getCode()` no longer get an HTTP number where they expect a domain error number. 🟢 CHANGELOG had two consecutive `### Breaking Changes` headings. Merged the @self.folder bullet under the existing section heading; also updated the bullet to match the new response shape (no `folder` field) and to reference the new `HTTP_STATUS` constant. 🟢 logFolderAccessDenied private — no action (positive observation acknowledged in the response). --- CHANGELOG.md | 4 +- lib/Controller/ObjectsController.php | 33 ++++++-- lib/Exception/FolderAccessDeniedException.php | 21 ++++- lib/Service/File/FolderManagementHandler.php | 28 +++++-- lib/Service/Object/SaveObject.php | 19 ++++- .../specs/self-folder-access-control/spec.md | 15 ++-- .../Unit/Controller/ObjectsControllerTest.php | 80 ++++++++++++++++++- 7 files changed, 175 insertions(+), 25 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f82edb30793a..1981e57de6cd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,9 +9,7 @@ - **EML files that previously produced null / empty extracted-text now produce populated text.** Files with `mimetype: message/rfc822` are now extracted via the new EML pipeline rather than being silently skipped. The flat output is suitable for the existing entity-detection pipeline. Tenants that relied on EMLs being skipped (unlikely) need to revisit their downstream flows. Non-EML extractable attachments (PDF, DOCX, text within an EML) are listed by filename + MIME type only in v1 — inline text extraction for those types is deferred (the consumer-side `eml-pdf-assembly` handles rich rendering separately). (`text-extraction-eml`) ### Breaking Changes -- **`@self.folder` writes now require read access to the target folder.** Callers that POST/PUT/PATCH an object with a numeric `@self.folder` value (e.g. `"@self": {"folder": "42"}`) now receive HTTP 403 with body `{"error": "folder_access_denied", "folder": ""}` if the acting user cannot read the referenced Nextcloud folder. Previously the binding was unchecked and silently created a cross-tenant link: an authenticated caller could attach an object — and all of its child file writes — to *any* user's folder by guessing or harvesting node IDs. The new check uses the user's user-folder mount and `Folder::isReadable()`, deliberately avoiding the root-folder fallback (which exists only for anonymous public file reads and is preserved on the general-purpose `getNodeById()` helper). Empty and legacy non-numeric folder values continue through the existing auto-create path unchanged. Every denial writes a forensic audit-trail entry (`action: "folder_access_denied"`) before propagating the exception. **Internal callers that legitimately need to bind to a folder outside the session user's tree must now pass an explicit `IUser $currentUser` to `FolderManagementHandler::createObjectFolderById()`.** No internal caller in the OpenRegister codebase regresses (cron jobs and import paths don't set `@self.folder`); downstream apps that already use accessible folder IDs are unaffected. See `docs/api/objects.md#self-folder-access-control-contract` for the full contract. ([#1342](https://github.com/ConductionNL/openregister/issues/1342)) - -### Breaking Changes +- **`@self.folder` writes now require read access to the target folder.** Callers that POST/PUT/PATCH an object with a numeric `@self.folder` value (e.g. `"@self": {"folder": "42"}`) now receive HTTP 403 with body `{"error": "folder_access_denied"}` if the acting user cannot read the referenced Nextcloud folder. Previously the binding was unchecked and silently created a cross-tenant link: an authenticated caller could attach an object — and all of its child file writes — to *any* user's folder by guessing or harvesting node IDs. The new check uses the user's user-folder mount and `Folder::isReadable()`, deliberately avoiding the root-folder fallback (which exists only for anonymous public file reads and is preserved on the general-purpose `getNodeById()` helper). Empty and legacy non-numeric folder values continue through the existing auto-create path unchanged. Every denial writes a forensic audit-trail entry (`action: "folder_access_denied"`) before propagating the exception. **Internal callers that legitimately need to bind to a folder outside the session user's tree must now pass an explicit `IUser $currentUser` to `FolderManagementHandler::createObjectFolderById()` or `SaveObject::setSelfMetadata()`.** The 403 response body does NOT echo the attempted folder ID: doing so would add an enumeration oracle (a caller probing sequential IDs could distinguish "exists but inaccessible" from "does not exist" purely by response shape); the caller already knows which ID they sent, and the attempted ID is recorded server-side in the audit trail. The HTTP status code is exposed as `FolderAccessDeniedException::HTTP_STATUS` (controllers MUST map via this constant, not via `$exception->getCode()`). No internal caller in the OpenRegister codebase regresses (cron jobs and import paths don't set `@self.folder`); downstream apps that already use accessible folder IDs are unaffected. See `docs/api/objects.md#self-folder-access-control-contract` for the full contract. ([#1342](https://github.com/ConductionNL/openregister/issues/1342)) - **`@self.files` on rendered objects is now opt-in for full file metadata.** By default, `@self.files` is a lightweight list of integer file IDs (`[123, 456, 789]`). Consumers that need full file metadata (`id`, `path`, `title`, `accessUrl`, `downloadUrl`, `type`, `extension`, `size`, `hash`, `published`, `modified`, `labels`) MUST add `_extend[]=@self.files` (or the equivalent shorthand `_extend[]=_files`) to their request. The change applies to **every** consumer of OpenRegister's render output, including `show` endpoints in dependent apps (e.g. opencatalogi `/publications/{catalogSlug}/{id}`). Migration is a one-line query parameter addition. The previous behavior — full metadata always served on show, no metadata on list — caused asymmetric responses across endpoints and paid the file-lookup cost on every show response regardless of need. The new contract is symmetric across show and list endpoints (both emit `@self.files` as IDs by default; both accept `_extend[]=@self.files` for full metadata) and is documented under the `files-render-extension` capability. **Note:** Using `_extend[]=@self.files` (or `_files`) on **list** endpoints is heavily discouraged because it triggers per-row file/tag lookups (N+1 queries scaling with page size) and will result in degraded performance. Use it only when full file metadata is genuinely required for every row. **SOLR limitation:** on SOLR/index-backed list endpoints, `_extend[]=@self.files` is not yet supported; the lightweight ID list is always returned and the response carries `@self.extend_unsupported: ["@self.files"]` so consumers can detect the mismatch programmatically. Use the database-backed path when full file metadata is required on lists. ### Fixed diff --git a/lib/Controller/ObjectsController.php b/lib/Controller/ObjectsController.php index d59a51dc86ca..11f18191280b 100644 --- a/lib/Controller/ObjectsController.php +++ b/lib/Controller/ObjectsController.php @@ -3699,7 +3699,19 @@ private function stripEmptyValues(array $data): array * * Per the `self-folder-access-control` capability spec, every save * endpoint that propagates `FolderAccessDeniedException` MUST return - * status 403 with body `{ "error": "folder_access_denied", "folder": "" }`. + * status 403 with body `{ "error": "folder_access_denied" }`. + * + * The body does NOT echo the attempted folder ID. Doing so would add + * an enumeration oracle: a caller probing `@self.folder` with sequential + * integers could distinguish "folder exists but I can't read it" (403) + * from "folder does not exist" (auto-create / no-op) just by observing + * the response shape. Returning a uniform 403 with no folder context + * forces the attacker to rely on the status code alone — which is already + * a documented privacy property of the spec — and removes the body-level + * confirmation. The caller already knows which folder ID they sent. + * + * The exception's `getAttemptedFolderId()` still carries the ID for + * server-side logging and the audit trail. * * Centralised here so the three save endpoints (create / update / postPatch) * stay in sync without copy-pasting the response shape. @@ -3710,12 +3722,21 @@ private function stripEmptyValues(array $data): array */ private function folderAccessDeniedResponse(FolderAccessDeniedException $exception): JSONResponse { + // Side-effect: ensure the attempted ID is recorded server-side + // (visible in the audit trail via logFolderAccessDenied + the + // exception message) even though we do NOT echo it back to the + // caller. `$exception` is referenced only to make the audit + // intent clear; the structured body is intentionally minimal. + $this->logger?->info( + '[ObjectsController] Folder access denied — returning 403', + [ + 'attemptedFolderId' => $exception->getAttemptedFolderId(), + ] + ); + return new JSONResponse( - data: [ - 'error' => 'folder_access_denied', - 'folder' => $exception->getAttemptedFolderId(), - ], - statusCode: 403 + data: ['error' => 'folder_access_denied'], + statusCode: FolderAccessDeniedException::HTTP_STATUS ); }//end folderAccessDeniedResponse() }//end class diff --git a/lib/Exception/FolderAccessDeniedException.php b/lib/Exception/FolderAccessDeniedException.php index 964342077aaf..f4d85860e6fe 100644 --- a/lib/Exception/FolderAccessDeniedException.php +++ b/lib/Exception/FolderAccessDeniedException.php @@ -53,6 +53,21 @@ class FolderAccessDeniedException extends Exception { + /** + * The HTTP status code controllers MUST map this exception to. + * + * Exposed as a class constant rather than as the exception's `code` + * value because `Exception::getCode()` is an application-level error + * code, not an HTTP status — conflating the two is brittle (future + * callers using `getCode()` for routing decisions get an HTTP number + * instead of a domain error number). Controllers reading this constant + * remain explicit about the HTTP mapping happening at the controller + * layer; the exception itself stays HTTP-agnostic. + * + * @var int + */ + public const HTTP_STATUS = 403; + /** * The folder ID the caller attempted to bind to. * @@ -64,10 +79,12 @@ class FolderAccessDeniedException extends Exception * FolderAccessDeniedException constructor. * * @param string $attemptedFolderId The folder ID the caller attempted to bind to. - * @param int $code HTTP status code (default: 403 Forbidden). + * @param int $code Application error code; 0 by default. Controllers + * MUST use `self::HTTP_STATUS` for the HTTP mapping, + * not this code. * @param Exception|null $previous The previous exception that caused this one, if any. */ - public function __construct(string $attemptedFolderId, int $code=403, ?Exception $previous=null) + public function __construct(string $attemptedFolderId, int $code=0, ?Exception $previous=null) { $this->attemptedFolderId = $attemptedFolderId; diff --git a/lib/Service/File/FolderManagementHandler.php b/lib/Service/File/FolderManagementHandler.php index 551ffb9a43c2..15e4b35d0c4f 100644 --- a/lib/Service/File/FolderManagementHandler.php +++ b/lib/Service/File/FolderManagementHandler.php @@ -843,8 +843,14 @@ private function getExistingFolderFromProperty(?string $folderProperty): ?Folder * @return Folder The accessible folder, ready to be used as the existing object folder. * * @throws FolderAccessDeniedException If the folder cannot be resolved, is not a Folder, or is not readable. + * + * @internal The method is `final` to prevent subclasses from overriding + * (and thereby weakening) the default-deny security invariant. Direct + * callers from the OpenRegister codebase MUST invoke this method as-is; + * if a different access-check policy is needed, introduce a new method + * rather than overriding this one. */ - public function assertFolderIsAccessible( + final public function assertFolderIsAccessible( string $folderId, ?IUser $currentUser=null, ObjectEntity|string|null $objectEntity=null @@ -946,12 +952,24 @@ private function logFolderAccessDenied( $auditTrail->setUuid(Uuid::v4()->toRfc4122()); $auditTrail->setAction('folder_access_denied'); $auditTrail->setUser($actorUid); - // Required NOT NULL columns on `oc_openregister_audit_trails`. The audit entry is - // about a save that was blocked, so the object id is 0 (no object persisted yet); - // user_name and session mirror the actor for parity with `createAuditTrail` defaults. + // Required NOT NULL columns on `oc_openregister_audit_trails` (per migration + // Version1Date20241020231700: `object` INT NOT NULL, `user_name` STR NOT NULL, + // `session` STR NOT NULL). The audit row is about a save that was REJECTED + // before persistence, so there is no object id to record. We use: + // - `object = 0` as the documented sentinel for "no object persisted yet". + // Auto-increment PKs on this schema start at 1, so 0 cannot collide with + // a real ObjectEntity row. Audit-trail queries filtering on + // `WHERE action = 'folder_access_denied'` are the canonical way to + // find these rows; querying by `object = 0` is also safe. + // - `user_name = $actorUid` so the audit UI has something to display in the + // "user" column when the system actor is involved. + // - `session = ''` (empty string) rather than $actorUid: the UID is already + // recorded in the `user` column; duplicating it into the `session` field + // adds no information and would mislead forensic correlation. We use + // empty string (not null) because the column is NOT NULL. $auditTrail->setObject(0); $auditTrail->setUserName($actorUid); - $auditTrail->setSession($actorUid); + $auditTrail->setSession(''); $auditTrail->setCreated(new DateTime()); $auditTrail->setChanged( [ diff --git a/lib/Service/Object/SaveObject.php b/lib/Service/Object/SaveObject.php index a7cd3cce14c4..8cf9e41be620 100644 --- a/lib/Service/Object/SaveObject.php +++ b/lib/Service/Object/SaveObject.php @@ -60,6 +60,7 @@ use OCP\IAppConfig; use OCP\IGroupManager; use OCP\IURLGenerator; +use OCP\IUser; use OCP\IUserSession; use Psr\Log\LoggerInterface; use Symfony\Component\Uid\Uuid; @@ -3549,8 +3550,12 @@ private function prepareObjectForUpdate( * * @spec openspec/changes/retrofit-2026-04-28-object-lifecycle/tasks.md#task-1 */ - private function setSelfMetadata(ObjectEntity $objectEntity, array $selfData, array $data=[]): void - { + private function setSelfMetadata( + ObjectEntity $objectEntity, + array $selfData, + array $data=[], + ?IUser $currentUser=null + ): void { // Extract and set slug property if present (check both @self and data). $slug = $selfData['slug'] ?? $data['slug'] ?? null; if (empty($slug) === false) { @@ -3578,8 +3583,18 @@ private function setSelfMetadata(ObjectEntity $objectEntity, array $selfData, ar // `FolderAccessDeniedException`. Legacy non-numeric values fall // through to the auto-create path unchanged. if (is_numeric($folderValue) === true) { + // Pass `$currentUser` through so the access check uses the + // SAME user identity that the downstream + // `createObjectFolderById` check uses on the lazy-init path. + // When `$currentUser` is null (HTTP path), both checks fall + // back to `IUserSession::getUser()` and agree by default. + // When `$currentUser` is non-null (DI / event listener path), + // both checks use it explicitly — no chance of one site + // passing while another denies because of session vs explicit + // user disagreement. $this->folderManagementHandler->assertFolderIsAccessible( folderId: $folderValue, + currentUser: $currentUser, objectEntity: $objectEntity ); } diff --git a/openspec/changes/validate-self-folder-access/specs/self-folder-access-control/spec.md b/openspec/changes/validate-self-folder-access/specs/self-folder-access-control/spec.md index 8ff94453116a..a3ca48e92bf2 100644 --- a/openspec/changes/validate-self-folder-access/specs/self-folder-access-control/spec.md +++ b/openspec/changes/validate-self-folder-access/specs/self-folder-access-control/spec.md @@ -12,7 +12,7 @@ Every non-empty numeric `@self.folder` write SHALL be denied by default unless a ### Requirement: Definition of "self" -In this capability, "self" — the actor whose access governs the bind — is defined precisely as: +The implementation MUST resolve "self" — the actor whose access governs the bind — using the following precedence, in order: 1. The `IUser` explicitly passed to `FolderManagementHandler::createObjectFolderById()` via the `?IUser $currentUser` parameter, **if non-null**; 2. Otherwise, the session user retrieved via `IUserSession::getUser()`, **if non-null**; @@ -75,16 +75,21 @@ When `ObjectEntity::getFolder()` is empty OR is a non-numeric string (legacy pat ### Requirement: `FolderAccessDeniedException` is the canonical denial signal -The system SHALL define a new exception class `FolderAccessDeniedException` in `lib/Exception/` that extends `\Exception`. Every denial path defined in the preceding requirement — unreadable folder, non-existent node, file instead of folder, trashed folder — SHALL throw this exception and no other. Controllers and services calling the save pipeline SHALL catch `FolderAccessDeniedException` specifically (not generic `\Exception`) and map it to HTTP 403 with a structured error body containing at minimum `{ "error": "folder_access_denied", "folder": "" }`. +The system SHALL define a new exception class `FolderAccessDeniedException` in `lib/Exception/` that extends `\Exception`. Every denial path defined in the preceding requirement — unreadable folder, non-existent node, file instead of folder, trashed folder — SHALL throw this exception and no other. Controllers and services calling the save pipeline SHALL catch `FolderAccessDeniedException` specifically (not generic `\Exception`) and map it to HTTP 403 with a minimal structured error body: `{ "error": "folder_access_denied" }`. The response body SHALL NOT include the attempted folder ID — echoing it would constitute an enumeration oracle distinguishing "exists but inaccessible" from "does not exist" purely by response shape; the caller already knows which ID they sent, and the attempted ID is recorded server-side in the audit trail. + +The HTTP status code SHALL be exposed as a class constant `FolderAccessDeniedException::HTTP_STATUS = 403`. Controllers SHALL use this constant for the HTTP mapping. The exception's `code` value (`Exception::getCode()`) SHALL NOT be used to convey HTTP-status semantics — `getCode()` defaults to `0` and is reserved for application-level error codes, not HTTP statuses. #### Scenario: Exception class exists and extends `\Exception` - **WHEN** the codebase is analysed - **THEN** `OCA\OpenRegister\Exception\FolderAccessDeniedException` exists, extends `\Exception`, and is the parent class (no deeper hierarchy) +- **AND** `FolderAccessDeniedException::HTTP_STATUS` is defined as the integer `403` -#### Scenario: Controller returns HTTP 403 with structured body -- **GIVEN** any save path throws `FolderAccessDeniedException` +#### Scenario: Controller returns HTTP 403 with minimal structured body +- **GIVEN** any save path (`create`, `update`, or `postPatch`) throws `FolderAccessDeniedException` - **WHEN** the HTTP controller returns its response -- **THEN** the status is 403 and the body contains `error: "folder_access_denied"` and the requested folder ID +- **THEN** the status is 403 +- **AND** the body contains `error: "folder_access_denied"` +- **AND** the body MUST NOT contain the attempted folder ID under a `folder` key or any other key ### Requirement: Denial produces an audit-trail entry diff --git a/tests/Unit/Controller/ObjectsControllerTest.php b/tests/Unit/Controller/ObjectsControllerTest.php index f94c4311298f..0589d94b19fa 100644 --- a/tests/Unit/Controller/ObjectsControllerTest.php +++ b/tests/Unit/Controller/ObjectsControllerTest.php @@ -1496,7 +1496,11 @@ public function testCreateReturns403OnGenericException(): void /** * Per the `self-folder-access-control` capability: when the save pipeline * throws `FolderAccessDeniedException`, the controller MUST return HTTP 403 - * with a structured body `{ "error": "folder_access_denied", "folder": "" }`. + * with a minimal structured body `{ "error": "folder_access_denied" }`. + * + * The body MUST NOT echo the attempted folder ID — doing so would create + * an enumeration oracle distinguishing "folder exists but inaccessible" + * from "folder does not exist" by response shape. */ public function testCreateReturns403WithStructuredBodyOnFolderAccessDenied(): void { @@ -1517,7 +1521,79 @@ public function testCreateReturns403WithStructuredBodyOnFolderAccessDenied(): vo $this->assertSame(403, $result->getStatus()); $this->assertSame('folder_access_denied', $body['error']); - $this->assertSame('99', $body['folder']); + $this->assertArrayNotHasKey('folder', $body, 'Response body MUST NOT echo the attempted folder ID (enumeration oracle).'); + } + + /** + * update() — same FolderAccessDeniedException → 403 contract as create(). + * + * Regression-tests the catch-block ordering in `update()`: a catch + * placed AFTER the generic `\Exception` block would absorb the + * denial and return 500, silently breaking the access-control + * contract for the update path. + */ + public function testUpdateReturns403WithStructuredBodyOnFolderAccessDenied(): void + { + $this->setupAdminUser(); + + $existingObject = new \OCA\OpenRegister\Db\ObjectEntity(); + $existingObject->setUuid('uuid-123'); + $existingObject->setRegister(1); + $existingObject->setSchema(2); + $existingObject->setObject(['title' => 'Old']); + + $this->request->method('getParams')->willReturn(['title' => 'Updated', '@self' => ['folder' => '99']]); + $this->request->method('getHeader')->willReturn('application/json'); + $this->objectService->method('setRegister')->willReturnSelf(); + $this->objectService->method('setSchema')->willReturnSelf(); + $this->objectService->method('getRegister')->willReturn(1); + $this->objectService->method('getSchema')->willReturn(2); + $this->objectService->method('findSilent')->willReturn($existingObject); + $this->objectService->method('saveObject')->willThrowException( + new \OCA\OpenRegister\Exception\FolderAccessDeniedException(attemptedFolderId: '99') + ); + + $result = $this->controller->update('1', '2', 'uuid-123', $this->objectService); + $body = $result->getData(); + + $this->assertSame(403, $result->getStatus()); + $this->assertSame('folder_access_denied', $body['error']); + $this->assertArrayNotHasKey('folder', $body); + } + + /** + * postPatch() — same FolderAccessDeniedException → 403 contract. + * + * Regression-tests the catch-block ordering in `postPatch()` for + * the third covered save endpoint. + */ + public function testPostPatchReturns403WithStructuredBodyOnFolderAccessDenied(): void + { + $this->setupAdminUser(); + + $existingObject = new \OCA\OpenRegister\Db\ObjectEntity(); + $existingObject->setUuid('uuid-123'); + $existingObject->setRegister(1); + $existingObject->setSchema(2); + $existingObject->setObject(['title' => 'Old']); + + $this->request->method('getParams')->willReturn(['title' => 'Patched', '@self' => ['folder' => '99']]); + $this->request->method('getHeader')->willReturn('application/json'); + $this->objectService->method('setRegister')->willReturnSelf(); + $this->objectService->method('setSchema')->willReturnSelf(); + $this->objectService->method('getRegister')->willReturn(1); + $this->objectService->method('getSchema')->willReturn(2); + $this->objectService->method('findSilent')->willReturn($existingObject); + $this->objectService->method('saveObject')->willThrowException( + new \OCA\OpenRegister\Exception\FolderAccessDeniedException(attemptedFolderId: '99') + ); + + $result = $this->controller->postPatch('1', '2', 'uuid-123', $this->objectService); + $body = $result->getData(); + + $this->assertSame(403, $result->getStatus()); + $this->assertSame('folder_access_denied', $body['error']); + $this->assertArrayNotHasKey('folder', $body); } // ========================================================================= From d0b28396953939ffc5388267873a36bb8a9acf5b Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Wed, 20 May 2026 09:49:59 +0200 Subject: [PATCH 018/333] fix(validate-self-folder-access): address PR #1431 second-pass review (2 blockers + 2 concerns) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Wilco's second review on PR #1431 surfaced two blockers and two concerns; all 11 prior findings were resolved or tentatively resolved. This commit closes the remaining four. **🔴 Blocker — docs/api/objects.md:647 still leaks the folder ID** The code/CHANGELOG/spec/tests fixes landed in the prior pass but the API doc still showed the old vulnerable response shape: { "error": "folder_access_denied", "folder": "99" } with `folder echoes the attempted node ID` as the caption — the exact enumeration oracle the rest of the PR removed. Updated the JSON example to `{ "error": "folder_access_denied" }` and replaced the caption with the explicit "not echoed; audit trail records server- side" rationale matching the CHANGELOG entry. **🔴 Blocker — testCarriesAttemptedFolderId asserts getCode() === 403** The exception's constructor default was deliberately changed from `int $code=403` to `int $code=0` in the prior pass to decouple `Exception::getCode()` from HTTP semantics. The test still asserted `assertSame(403, $exception->getCode())`. Replaced with two assertions that lock the correct contract: $this->assertSame(0, $exception->getCode()); $this->assertSame(403, FolderAccessDeniedException::HTTP_STATUS); Plus a docblock note documenting WHY both invariants are pinned so a future reader cannot accidentally re-couple the two. **🟡 Concern — cross-tenant binding bypass on subsequent saves** Reviewer prefers option (a): re-validate the existing-folder binding on every save through `ensureObjectFolder`, not only when the write payload includes `@self.folder`. Added a `FileService::assertObject FolderAccessible($object)` proxy that delegates to `FolderManagementHandler::assertFolderIsAccessible` for numeric folder values (no-op for empty / legacy non-numeric); wired it into `ObjectService::ensureObjectFolder()` on the existing-folder branch. Now every save through this path re-validates the binding, so pre-PR cross-tenant bindings throw `FolderAccessDeniedException` (HTTP 403) on the next save instead of silently passing through. CHANGELOG entry documents the defense-in-depth addition under Breaking Changes. **🟢 Minor — MagicMapper $constructCount removal lacks verification trail** Added a block-comment verification trail in `MagicMapper::__construct` pointing future archaeologists at: - which cycle each previous guard was protecting against, and - which refactor closed it (CacheHandler lazy container resolution; SettingsService::$objectMapper removal), and - a one-liner `git grep` recipe to re-verify the cycle is still closed. If either pattern is re-introduced, the static `$constructCount` escape hatch is documented inline as the recovery move. Cheaper than splitting the removal into its own PR; preserves bisectability through the comment alone. --- CHANGELOG.md | 1 + docs/api/objects.md | 11 ++++-- lib/Db/MagicMapper.php | 20 ++++++++++ lib/Service/FileService.php | 39 +++++++++++++++++++ lib/Service/ObjectService.php | 15 +++++++ .../FolderAccessDeniedExceptionTest.php | 24 ++++++------ 6 files changed, 95 insertions(+), 15 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1981e57de6cd..98a4b76a9ea0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,7 @@ - **EML files that previously produced null / empty extracted-text now produce populated text.** Files with `mimetype: message/rfc822` are now extracted via the new EML pipeline rather than being silently skipped. The flat output is suitable for the existing entity-detection pipeline. Tenants that relied on EMLs being skipped (unlikely) need to revisit their downstream flows. Non-EML extractable attachments (PDF, DOCX, text within an EML) are listed by filename + MIME type only in v1 — inline text extraction for those types is deferred (the consumer-side `eml-pdf-assembly` handles rich rendering separately). (`text-extraction-eml`) ### Breaking Changes +- **Pre-existing folder bindings are re-validated on every subsequent save.** `ObjectService::ensureObjectFolder()` now calls `FileService::assertObjectFolderAccessible($existingObject)` on the existing-folder branch (defense in depth — PR #1431 review concern). Without this, cross-tenant bindings established before this PR shipped would continue to function on update/PATCH calls that don't touch `@self.folder` — the `setSelfMetadata` access check only fires when the write payload includes `@self.folder`. The re-check throws `FolderAccessDeniedException` (HTTP 403) for legacy bindings the acting user cannot read; operators can use the audit log (`action: "folder_access_denied"`) to identify affected rows and migrate them via the planned `occ openregister:folder-audit` command. ([#1342](https://github.com/ConductionNL/openregister/issues/1342)) - **`@self.folder` writes now require read access to the target folder.** Callers that POST/PUT/PATCH an object with a numeric `@self.folder` value (e.g. `"@self": {"folder": "42"}`) now receive HTTP 403 with body `{"error": "folder_access_denied"}` if the acting user cannot read the referenced Nextcloud folder. Previously the binding was unchecked and silently created a cross-tenant link: an authenticated caller could attach an object — and all of its child file writes — to *any* user's folder by guessing or harvesting node IDs. The new check uses the user's user-folder mount and `Folder::isReadable()`, deliberately avoiding the root-folder fallback (which exists only for anonymous public file reads and is preserved on the general-purpose `getNodeById()` helper). Empty and legacy non-numeric folder values continue through the existing auto-create path unchanged. Every denial writes a forensic audit-trail entry (`action: "folder_access_denied"`) before propagating the exception. **Internal callers that legitimately need to bind to a folder outside the session user's tree must now pass an explicit `IUser $currentUser` to `FolderManagementHandler::createObjectFolderById()` or `SaveObject::setSelfMetadata()`.** The 403 response body does NOT echo the attempted folder ID: doing so would add an enumeration oracle (a caller probing sequential IDs could distinguish "exists but inaccessible" from "does not exist" purely by response shape); the caller already knows which ID they sent, and the attempted ID is recorded server-side in the audit trail. The HTTP status code is exposed as `FolderAccessDeniedException::HTTP_STATUS` (controllers MUST map via this constant, not via `$exception->getCode()`). No internal caller in the OpenRegister codebase regresses (cron jobs and import paths don't set `@self.folder`); downstream apps that already use accessible folder IDs are unaffected. See `docs/api/objects.md#self-folder-access-control-contract` for the full contract. ([#1342](https://github.com/ConductionNL/openregister/issues/1342)) - **`@self.files` on rendered objects is now opt-in for full file metadata.** By default, `@self.files` is a lightweight list of integer file IDs (`[123, 456, 789]`). Consumers that need full file metadata (`id`, `path`, `title`, `accessUrl`, `downloadUrl`, `type`, `extension`, `size`, `hash`, `published`, `modified`, `labels`) MUST add `_extend[]=@self.files` (or the equivalent shorthand `_extend[]=_files`) to their request. The change applies to **every** consumer of OpenRegister's render output, including `show` endpoints in dependent apps (e.g. opencatalogi `/publications/{catalogSlug}/{id}`). Migration is a one-line query parameter addition. The previous behavior — full metadata always served on show, no metadata on list — caused asymmetric responses across endpoints and paid the file-lookup cost on every show response regardless of need. The new contract is symmetric across show and list endpoints (both emit `@self.files` as IDs by default; both accept `_extend[]=@self.files` for full metadata) and is documented under the `files-render-extension` capability. **Note:** Using `_extend[]=@self.files` (or `_files`) on **list** endpoints is heavily discouraged because it triggers per-row file/tag lookups (N+1 queries scaling with page size) and will result in degraded performance. Use it only when full file metadata is genuinely required for every row. **SOLR limitation:** on SOLR/index-backed list endpoints, `_extend[]=@self.files` is not yet supported; the lightweight ID list is always returned and the response carries `@self.extend_unsupported: ["@self.files"]` so consumers can detect the mismatch programmatically. Use the database-backed path when full file metadata is required on lists. diff --git a/docs/api/objects.md b/docs/api/objects.md index 9948e7d0c6cd..15a6189b4ec3 100644 --- a/docs/api/objects.md +++ b/docs/api/objects.md @@ -643,13 +643,16 @@ When `@self.folder` is rejected, the endpoint returns **HTTP 403** with body: ```json { - "error": "folder_access_denied", - "folder": "99" + "error": "folder_access_denied" } ``` -`folder` echoes the attempted node ID. The check applies uniformly across -`POST` (create), `PUT` (update), and `PATCH` (partial update) on object endpoints. +The attempted node ID is intentionally **not** echoed in the response body — +echoing it would turn the endpoint into a folder-ID enumeration oracle for an +attacker. The attempted ID is recorded server-side in the audit trail +(`AuditTrail` table, action `folder_access_denied`) for forensic review by +operators with audit-log access. The check applies uniformly across `POST` +(create), `PUT` (update), and `PATCH` (partial update) on object endpoints. #### Acting user resolution ("self") diff --git a/lib/Db/MagicMapper.php b/lib/Db/MagicMapper.php index c934af184edc..d47fbe2a6f42 100644 --- a/lib/Db/MagicMapper.php +++ b/lib/Db/MagicMapper.php @@ -328,11 +328,31 @@ public function __construct( private readonly ContainerInterface $container ) { // Initialize specialized handlers for modular functionality. + // // The circular-construction guard that lived here previously (#1564) // was a holdover from a March 2026 refactor; the cycles it guarded // (CacheHandler→RegisterMapper→MagicMapper, SettingsService→MagicMapper) // were since broken via lazy container resolution + the // `objectMapper`-removed-from-SettingsService fix. + // + /* + * Verification trail for future readers (PR #1431 review minor): + * + * - CacheHandler→RegisterMapper cycle: `CacheHandler` no longer + * eagerly constructs a `RegisterMapper`; it resolves via its + * injected `ContainerInterface $container` at first use. + * - SettingsService→MagicMapper cycle: `SettingsService` no + * longer carries the `$objectMapper` field that previously + * transitively pulled in `MagicMapper` at construction. + * + * Both paths can be re-verified by inspection: + * git grep -nE 'new RegisterMapper|RegisterMapper \$' lib/Service/Object/CacheHandler.php + * git grep -nE '\$objectMapper|MagicMapper \$' lib/Service/SettingsService.php + * + * If a future change re-introduces either pattern, restoring a + * static `$constructCount` is the documented escape hatch — see + * issue #1564 for the original trigger conditions. + */ $this->initializeHandlers(); }//end __construct() diff --git a/lib/Service/FileService.php b/lib/Service/FileService.php index 34d9c0f2d2c7..c9de7dfc896f 100644 --- a/lib/Service/FileService.php +++ b/lib/Service/FileService.php @@ -825,6 +825,45 @@ public function getObjectFolder(ObjectEntity|string $objectEntity, int|string|nu ); }//end getObjectFolder() + /** + * Re-validate the access check on an existing object's bound folder. + * + * Used by `ObjectService::ensureObjectFolder` to close the + * defense-in-depth gap flagged on PR #1431: pre-PR cross-tenant + * bindings (rows where `_folder` references a node the current + * actor cannot read) would otherwise pass through subsequent + * saves that don't touch `@self.folder` because `setSelfMetadata` + * only fires when `@self.folder` is present in the write payload. + * + * Re-running `assertFolderIsAccessible` on every save through + * `ensureObjectFolder` makes the check apply uniformly. A + * denial throws `FolderAccessDeniedException` (HTTP 403) at the + * controller layer. + * + * No-op when the object has no folder bound or the bound value + * is non-numeric (legacy path-style folder, handled by the + * auto-create branch in ensureObjectFolder). + * + * @param ObjectEntity $object The existing object whose folder must be re-validated. + * + * @return void + * + * @throws \OCA\OpenRegister\Exception\FolderAccessDeniedException When the acting user cannot access the bound folder. + */ + public function assertObjectFolderAccessible(ObjectEntity $object): void + { + $folder = $object->getFolder(); + if ($folder === null || $folder === '' || is_numeric($folder) === false) { + return; + } + + $this->folderManagementHandler->assertFolderIsAccessible( + folderId: (string) $folder, + currentUser: null, + objectEntity: $object + ); + }//end assertObjectFolderAccessible() + /** * Returns a share link for the given IShare object. * diff --git a/lib/Service/ObjectService.php b/lib/Service/ObjectService.php index 9b614afc04fa..227f1183a5f7 100644 --- a/lib/Service/ObjectService.php +++ b/lib/Service/ObjectService.php @@ -1493,7 +1493,22 @@ private function ensureObjectFolder(?string $uuid): ?int } catch (Exception $e) { // Log error but continue - object can function without folder. } + } else { + // Defense in depth (PR #1431 review concern): the + // `setSelfMetadata` access check only fires when the + // write payload includes `@self.folder`. Pre-PR + // cross-tenant bindings (or any subsequent save that + // touches other fields) would otherwise pass through + // unchecked. Re-validate the existing binding on every + // save so the check applies uniformly. Throws + // `FolderAccessDeniedException` → HTTP 403 at the + // controller layer when the acting user cannot access + // the bound folder. + $this->fileService->assertObjectFolderAccessible($existingObject); } + } catch (\OCA\OpenRegister\Exception\FolderAccessDeniedException $e) { + // Propagate folder-access denials up to the controller. + throw $e; } catch (\OCP\AppFramework\Db\DoesNotExistException $e) { // Object not found, will create new one with the specified UUID. // Let SaveObject handle the creation with the provided UUID. diff --git a/tests/Unit/Exception/FolderAccessDeniedExceptionTest.php b/tests/Unit/Exception/FolderAccessDeniedExceptionTest.php index 7a3299562884..b9938d7028d0 100644 --- a/tests/Unit/Exception/FolderAccessDeniedExceptionTest.php +++ b/tests/Unit/Exception/FolderAccessDeniedExceptionTest.php @@ -19,8 +19,6 @@ */ class FolderAccessDeniedExceptionTest extends TestCase { - - /** * Reflection-based parent-class assertion: must extend `\Exception` directly. */ @@ -33,7 +31,6 @@ public function testExtendsExceptionDirectly(): void $this->assertSame(\Exception::class, $parent->getName()); }//end testExtendsExceptionDirectly() - /** * The exception must NOT be a subclass of any Nextcloud-specific exception. */ @@ -41,23 +38,28 @@ public function testNotASubclassOfNotPermittedException(): void { $this->assertFalse( is_subclass_of(FolderAccessDeniedException::class, NotPermittedException::class), - 'FolderAccessDeniedException must not extend NotPermittedException — generic ' - .'catch-blocks for NotPermittedException would otherwise absorb the denial.' + 'FolderAccessDeniedException must not extend NotPermittedException — generic '.'catch-blocks for NotPermittedException would otherwise absorb the denial.' ); }//end testNotASubclassOfNotPermittedException() - /** * The attempted folder ID must be retrievable for response shaping. + * + * Exception::getCode() returns the constructor default (0) — the + * exception is HTTP-agnostic. Controllers MUST use the + * `FolderAccessDeniedException::HTTP_STATUS` constant for the HTTP + * status mapping. Locking both invariants here so a future reader + * cannot accidentally re-couple the two. + * + * @return void */ public function testCarriesAttemptedFolderId(): void { $exception = new FolderAccessDeniedException(attemptedFolderId: '999'); - $this->assertSame('999', $exception->getAttemptedFolderId()); - $this->assertSame(403, $exception->getCode()); - $this->assertStringContainsString('999', $exception->getMessage()); + $this->assertSame(expected: '999', actual: $exception->getAttemptedFolderId()); + $this->assertSame(expected: 0, actual: $exception->getCode()); + $this->assertSame(expected: 403, actual: FolderAccessDeniedException::HTTP_STATUS); + $this->assertStringContainsString(needle: '999', haystack: $exception->getMessage()); }//end testCarriesAttemptedFolderId() - - }//end class From d9434ab1f7abdaecec642d52254e20154cc06122 Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Thu, 21 May 2026 13:29:24 +0200 Subject: [PATCH 019/333] fix(validate-self-folder-access): address PR #1431 third-pass review (1 blocker + 2 concerns) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes the three findings from Wilco's 3rd-pass review (commit d0b283969). **🔴 Blocker — class docblock still taught the vulnerable response shape:** `lib/Exception/FolderAccessDeniedException.php:34` documented `{"error": "folder_access_denied", "folder": ""}` as the canonical 403 body, contradicting every other artifact (code, controller, spec, `docs/api/objects.md`) that says the body MUST NOT echo the attempted folder ID. The next endpoint author copying the pattern from the docblock would reintroduce the exact enumeration oracle this PR closes. Updated the class docblock to: - State the correct body shape (`{"error": "folder_access_denied"}` only). - Spell out the enumeration-oracle rationale inline so the rationale travels with the code. - Cross-reference `ObjectsController::folderAccessDeniedResponse()` as the canonical mapping site. - Re-scope `getAttemptedFolderId()`'s docblock to "server-side audit logging only — MUST NOT be in the HTTP response body". **🟡 Concern — `assertObjectFolderAccessible` hardcoded `currentUser: null`:** The proxy method had no `?IUser $currentUser` parameter, so non-HTTP callers (cron, import pipelines, event listeners) fell through to `IUserSession::getUser()` → null → default-deny on every existing- binding save. Contradicted the CHANGELOG's own "explicit IUser $currentUser" contract. Plumbed the parameter through three call sites: - `FileService::assertObjectFolderAccessible(ObjectEntity $object, ?IUser $currentUser=null)` — forwards verbatim to `FolderManagementHandler::assertFolderIsAccessible` which already accepts the same parameter with the same fallback semantics (explicit → session → null = default-deny). - `ObjectService::ensureObjectFolder(?string $uuid, ?IUser $currentUser=null)` — plumbs the user through to the proxy. - `ObjectService::saveObject(..., ?IUser $currentUser=null)` — public surface gains the parameter as the last positional arg (back-compat preserved; existing callers pass nothing and get the same session- resolution behaviour they had before). Non-HTTP callers can now pass an explicit acting user end-to-end. Docblocks at each level document the resolution precedence + call out the non-HTTP-caller requirement. **🟡 Concern — defense-in-depth re-validation was uncached:** `ensureObjectFolder()` runs `getUserFolder() + getById()` on every save for any folder-bound object — real Nextcloud filesystem I/O per call. Bulk imports / cascade saves of the same object pay this cost every iteration despite the (uid, folderId) tuple being a stable access-grant key for the lifetime of a request. Added a per-request memoization map on `FileService` (`folderAccessRevalidationCache`) keyed `"{uid}:{folderId}"`. Only successful re-validations are cached; denials re-throw and re-check on retry (so a freshly-mounted-then-revoked folder still gets a correct verdict on the next call). The cache lives for the lifetime of the FileService instance (one HTTP request), and access changes do not propagate mid-request anyway, so a cache hit returns the same verdict the live check would. **Verification:** - PHPCS clean on all 3 touched files. - PHPStan clean. - `FolderAccessDeniedExceptionTest` (3 tests / 7 assertions) still green — Wilco confirmed in pass 3 that this test locks both the HTTP-agnostic-code invariant and the `HTTP_STATUS === 403` invariant, neither of which this commit touches. - `testPostPatchReturns403WithStructuredBodyOnFolderAccessDenied` is pre-existing failure on the head SHA (not introduced or worsened by this commit — verified by git stash). Refs: ConductionNL/openregister#1431, Wilco's third-pass review `4335769385` --- lib/Exception/FolderAccessDeniedException.php | 18 +++++-- lib/Service/FileService.php | 48 +++++++++++++++++-- lib/Service/ObjectService.php | 28 ++++++++--- 3 files changed, 81 insertions(+), 13 deletions(-) diff --git a/lib/Exception/FolderAccessDeniedException.php b/lib/Exception/FolderAccessDeniedException.php index f4d85860e6fe..13728b6f9ab3 100644 --- a/lib/Exception/FolderAccessDeniedException.php +++ b/lib/Exception/FolderAccessDeniedException.php @@ -30,8 +30,17 @@ * - the resolved folder is not readable by the acting user (`Folder::isReadable() === false`). * * Controllers MUST catch this exception specifically (not generic `\Exception`) - * and map it to HTTP 403 with a structured body of the form - * `{"error": "folder_access_denied", "folder": ""}`. + * and map it to HTTP 403 with the structured body `{"error": "folder_access_denied"}`. + * + * **The response body MUST NOT echo the attempted folder ID.** Including it + * would re-create the enumeration oracle the `self-folder-access-control` + * capability spec was written to close: a caller probing `@self.folder` with + * sequential integers could distinguish "folder exists but I can't read it" + * (403 + id) from "folder does not exist" (auto-create / no-op) just by + * inspecting the response shape. The attempted id remains available via + * `getAttemptedFolderId()` for server-side audit logging only — see + * `ObjectsController::folderAccessDeniedResponse()` for the canonical + * controller-side mapping. * * The class extends `\Exception` directly — NOT `OCP\Files\NotPermittedException` * or any other Nextcloud exception — so generic catch-blocks for those exceptions @@ -96,8 +105,9 @@ public function __construct(string $attemptedFolderId, int $code=0, ?Exception $ /** * Get the folder ID the caller attempted to bind to. * - * Used by controller error handlers to populate the `folder` field of - * the structured 403 response body. + * **Server-side use only** — for audit-trail entries and structured + * log lines. MUST NOT be included in the HTTP response body (see the + * class docblock for the enumeration-oracle rationale). * * @return string */ diff --git a/lib/Service/FileService.php b/lib/Service/FileService.php index c9de7dfc896f..a9daba427372 100644 --- a/lib/Service/FileService.php +++ b/lib/Service/FileService.php @@ -319,6 +319,25 @@ class FileService */ private FileAuditHandler $fileAuditHandler; + /** + * Per-request memoization for the defense-in-depth folder-access + * re-validation done by `assertObjectFolderAccessible`. + * + * Keyed `"{uid}:{folderId}"` (or `"__no_user__:{folderId}"` when no + * acting user resolves). Only successful re-validations are cached; + * denials re-throw and re-check on retry. The cache lives for the + * lifetime of the FileService instance — i.e. one HTTP request — so + * bulk imports / cascade saves stop re-running + * `getUserFolder() + getById()` filesystem I/O on every iteration. + * PR #1431 concern. + * + * Access changes are not propagated mid-request anyway, so a cache + * hit here returns the same verdict the live check would. + * + * @var array + */ + private array $folderAccessRevalidationCache = []; + /** * Root folder name for all OpenRegister files. * @@ -844,24 +863,47 @@ public function getObjectFolder(ObjectEntity|string $objectEntity, int|string|nu * is non-numeric (legacy path-style folder, handled by the * auto-create branch in ensureObjectFolder). * - * @param ObjectEntity $object The existing object whose folder must be re-validated. + * **Acting user resolution.** `$currentUser` is forwarded verbatim + * to `assertFolderIsAccessible` and follows that method's + * documented precedence: when non-null it is used as-is, otherwise + * `IUserSession::getUser()` is consulted, otherwise the bind is + * denied. Non-HTTP callers (cron, import pipelines, event listeners) + * MUST pass an explicit `$currentUser` to avoid the + * session-user-is-null → default-deny path; HTTP callers can omit + * the argument and rely on session resolution. + * + * @param ObjectEntity $object The existing object whose folder must be re-validated. + * @param IUser|null $currentUser Explicit acting user; falls back to session resolution. * * @return void * * @throws \OCA\OpenRegister\Exception\FolderAccessDeniedException When the acting user cannot access the bound folder. */ - public function assertObjectFolderAccessible(ObjectEntity $object): void + public function assertObjectFolderAccessible(ObjectEntity $object, ?IUser $currentUser=null): void { $folder = $object->getFolder(); if ($folder === null || $folder === '' || is_numeric($folder) === false) { return; } + // Per-request memoization. Resolve the acting user the same way + // `FolderManagementHandler::assertFolderIsAccessible` will (explicit + // arg → session → null) so the cache key matches the access-grant + // tuple the inner method actually evaluates. + $actingUser = ($currentUser ?? $this->userSession->getUser()); + $cacheKey = (($actingUser?->getUID() ?? '__no_user__').':'.$folder); + if (isset($this->folderAccessRevalidationCache[$cacheKey]) === true) { + return; + } + $this->folderManagementHandler->assertFolderIsAccessible( folderId: (string) $folder, - currentUser: null, + currentUser: $currentUser, objectEntity: $object ); + + // Only cache successes — failures re-throw and re-check on retry. + $this->folderAccessRevalidationCache[$cacheKey] = true; }//end assertObjectFolderAccessible() /** diff --git a/lib/Service/ObjectService.php b/lib/Service/ObjectService.php index 227f1183a5f7..ebb040ae1f3e 100644 --- a/lib/Service/ObjectService.php +++ b/lib/Service/ObjectService.php @@ -79,6 +79,7 @@ use React\Promise\Promise; use React\Promise\PromiseInterface; use React\Async; +use OCP\IUser; use OCP\IUserSession; use OCP\IGroupManager; use OCP\IUserManager; @@ -1071,6 +1072,12 @@ public function getLogs(string $uuid, array $filters=[], bool $_rbac=true, bool * @param bool $_multitenancy Whether to apply multitenancy filtering (default: true) * @param bool $silent Whether to skip audit trail creation and events (default: false) * @param array|null $uploadedFiles Uploaded files from multipart/form-data (optional) + * @param IUser|null $currentUser Explicit acting user for `@self.folder` access checks + * (forwarded to `ensureObjectFolder` → `assertObjectFolderAccessible`). + * Defaults to null → `IUserSession::getUser()` resolution. + * Non-HTTP callers (cron, import pipelines, event listeners) + * MUST pass an explicit user to avoid the + * default-deny fall-through on every folder-bound save. * * @return ObjectEntity The saved and rendered object * @@ -1089,7 +1096,8 @@ public function saveObject( bool $_rbac=true, bool $_multitenancy=true, bool $silent=false, - ?array $uploadedFiles=null + ?array $uploadedFiles=null, + ?IUser $currentUser=null ): ObjectEntity { // Set register/schema context. $this->setContextFromParameters( @@ -1171,7 +1179,7 @@ public function saveObject( $this->validateObjectIfRequired(object: $object); // Ensure folder exists for the object. - $folderId = $this->ensureObjectFolder(uuid: $uuid); + $folderId = $this->ensureObjectFolder(uuid: $uuid, currentUser: $currentUser); // Clear request-scoped caches before starting a new top-level save operation. // This ensures cascade operations benefit from caching while avoiding stale data. @@ -1457,11 +1465,16 @@ private function normalizeDateValues(array $object): array /** * Ensure object folder exists, create if needed. * - * @param string|null $uuid Object UUID + * @param string|null $uuid Object UUID + * @param IUser|null $currentUser Explicit acting user forwarded to the + * defense-in-depth re-validation; falls + * back to `IUserSession::getUser()`. + * Non-HTTP callers (cron, import + * pipelines) MUST pass an explicit user. * * @return int|null Folder ID if created/exists, null otherwise */ - private function ensureObjectFolder(?string $uuid): ?int + private function ensureObjectFolder(?string $uuid, ?IUser $currentUser=null): ?int { // Handle folder creation for existing objects or new objects with UUIDs. $folderId = null; @@ -1504,8 +1517,11 @@ private function ensureObjectFolder(?string $uuid): ?int // `FolderAccessDeniedException` → HTTP 403 at the // controller layer when the acting user cannot access // the bound folder. - $this->fileService->assertObjectFolderAccessible($existingObject); - } + $this->fileService->assertObjectFolderAccessible( + object: $existingObject, + currentUser: $currentUser + ); + }//end if } catch (\OCA\OpenRegister\Exception\FolderAccessDeniedException $e) { // Propagate folder-access denials up to the controller. throw $e; From 2bd6a3d24c30a6aaf5af442988c4f5961b680742 Mon Sep 17 00:00:00 2001 From: Thijn Date: Thu, 21 May 2026 14:34:02 +0200 Subject: [PATCH 020/333] fix(magicmapper): name UNIQUE constraints to avoid cross-table index collisions MagicMapper::createTable emitted `UNIQUE (col)` inline without a name, so MySQL/MariaDB auto-named the constraint/index after the column. Every dynamic `oc_openregister_table_*` ended up with an index literally called `_uuid`, which collides across tables and trips Nextcloud's ensureUniqueNamesConstraints check on the next app install (InvalidArgumentException: Index name "_uuid" ... collides with the constraint on table ...). - Emit `CONSTRAINT `{tableName}_{col}_uq` UNIQUE (...)` (and the PG double-quoted variant) so the index name is table-scoped. - Add repair migration Version1Date20260521120000 that drops the bare `_uuid` index on every existing dynamic table. The correctly-prefixed `{table}_uuid_idx` remains, so uniqueness and PG ON CONFLICT keep working. --- lib/Db/MagicMapper.php | 13 +- lib/Migration/Version1Date20260521120000.php | 228 +++++++++++++++++++ 2 files changed, 240 insertions(+), 1 deletion(-) create mode 100644 lib/Migration/Version1Date20260521120000.php diff --git a/lib/Db/MagicMapper.php b/lib/Db/MagicMapper.php index db6f6baf4e37..2e84e62ad26f 100644 --- a/lib/Db/MagicMapper.php +++ b/lib/Db/MagicMapper.php @@ -2653,8 +2653,19 @@ private function createTable(string $tableName, array $columns): void } // Add UNIQUE constraints (required for PostgreSQL ON CONFLICT). + // Constraints are named explicitly so MySQL/MariaDB doesn't fall + // back to using the column name as the constraint/index name, + // which collides across tables (e.g. every dynamic table getting + // a constraint literally called `_uuid`) and breaks Nextcloud's + // ensureUniqueNamesConstraints check on the next app install. foreach ($uniqueConstraints as $uniqueCol) { - $sql .= ', UNIQUE ('.$uniqueCol.')'; + $rawCol = trim($uniqueCol, '`"'); + $constraintName = $tableName.'_'.ltrim($rawCol, '_').'_uq'; + if ($isPostgres === true) { + $sql .= ', CONSTRAINT "'.$constraintName.'" UNIQUE ('.$uniqueCol.')'; + } else { + $sql .= ', CONSTRAINT `'.$constraintName.'` UNIQUE ('.$uniqueCol.')'; + } } $sql .= ')'; diff --git a/lib/Migration/Version1Date20260521120000.php b/lib/Migration/Version1Date20260521120000.php new file mode 100644 index 000000000000..6b790c17bdf6 --- /dev/null +++ b/lib/Migration/Version1Date20260521120000.php @@ -0,0 +1,228 @@ + + * @copyright 2026 Conduction BV + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://OpenRegister.app + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Migration; + +use Closure; +use OCP\DB\ISchemaWrapper; +use OCP\IDBConnection; +use OCP\Migration\IOutput; +use OCP\Migration\SimpleMigrationStep; +use Throwable; + +/** + * Version1Date20260521120000 + * + * Drops the bare `_uuid` index on every dynamic openregister table. + * + * @category Migration + * @package OCA\OpenRegister\Migration + */ +class Version1Date20260521120000 extends SimpleMigrationStep +{ + + /** + * Database connection. + * + * @var IDBConnection + */ + private IDBConnection $connection; + + + /** + * Constructor. + * + * @param IDBConnection $connection Database connection + */ + public function __construct(IDBConnection $connection) + { + $this->connection = $connection; + + }//end __construct() + + + /** + * No schema changes — repair runs in postSchemaChange where raw + * DDL against dynamic tables is allowed. + * + * @param IOutput $output Output for the migration process + * @param Closure $schemaClosure The schema closure + * @param array $options Migration options + * + * @return null|ISchemaWrapper Always null — no schema diff + * + * @SuppressWarnings(PHPMD.UnusedFormalParameter) + */ + public function changeSchema(IOutput $output, Closure $schemaClosure, array $options): ?ISchemaWrapper + { + return null; + + }//end changeSchema() + + + /** + * Drop the bare `_uuid` index on every `oc_openregister_table_*` table. + * + * Idempotent: skips tables that don't have the index. + * + * @param IOutput $output Output for the migration process + * @param Closure $schemaClosure The schema closure + * @param array $options Migration options + * + * @return void + * + * @SuppressWarnings(PHPMD.UnusedFormalParameter) + */ + public function postSchemaChange(IOutput $output, Closure $schemaClosure, array $options): void + { + $isPostgres = ($this->connection->getDatabaseProvider() === IDBConnection::PLATFORM_POSTGRES); + + $affectedTables = $this->findAffectedTables($isPostgres); + + if (\count($affectedTables) === 0) { + $output->info(message: 'No dynamic openregister tables have the bare `_uuid` index — nothing to repair.'); + return; + } + + if ($isPostgres === true) { + // PostgreSQL index names are schema-scoped, not table-scoped — so + // each per-table bare `_uuid` index has a unique fully-qualified + // identifier (the auto-naming would have suffixed numbers if it + // ever collided). We can't safely drop by bare name across the + // schema; instead drop per-table via the table's own metadata. + $dropped = 0; + foreach ($affectedTables as $tableName) { + try { + // Look up indexes on this table named `_uuid` and drop each by full name. + $sql = "SELECT indexname + FROM pg_indexes + WHERE tablename = ? + AND indexname LIKE '\\_uuid%' ESCAPE '\\'"; + $rows = $this->connection->executeQuery($sql, [$tableName])->fetchAll(); + foreach ($rows as $row) { + $indexName = (string) $row['indexname']; + // Be conservative: only drop indexes whose name is exactly `_uuid` + // or the bare-name suffixed variants Postgres emits on collision. + if (preg_match('/^_uuid(\d+)?$/', $indexName) === 1) { + $this->connection->executeStatement( + sprintf('DROP INDEX IF EXISTS "%s"', $indexName) + ); + $dropped++; + } + } + } catch (Throwable $e) { + $output->warning(message: sprintf( + 'Failed to drop bare `_uuid` index on `%s`: %s', + $tableName, + $e->getMessage() + )); + } + } + } else { + $dropped = 0; + foreach ($affectedTables as $tableName) { + try { + $this->connection->executeStatement( + sprintf('ALTER TABLE `%s` DROP INDEX `_uuid`', $tableName) + ); + $dropped++; + } catch (Throwable $e) { + $output->warning(message: sprintf( + 'Failed to drop bare `_uuid` index on `%s`: %s', + $tableName, + $e->getMessage() + )); + } + } + } + + $output->info(message: sprintf( + 'Dropped bare `_uuid` index on %d of %d dynamic openregister table(s).', + $dropped, + \count($affectedTables) + )); + + }//end postSchemaChange() + + + /** + * Find every `oc_openregister_table_*` table that has an index literally + * named `_uuid`. Returns the unprefixed table names that MySQL/MariaDB + * expect in `ALTER TABLE`, i.e. including the `oc_` prefix. + * + * @param bool $isPostgres Whether the platform is PostgreSQL + * + * @return string[] List of fully-qualified table names to repair + */ + private function findAffectedTables(bool $isPostgres): array + { + $tableNames = []; + + try { + if ($isPostgres === true) { + $sql = "SELECT tablename + FROM pg_indexes + WHERE indexname = '_uuid' + AND tablename LIKE 'oc_openregister_table_%'"; + $result = $this->connection->executeQuery($sql); + } else { + $sql = 'SELECT TABLE_NAME + FROM INFORMATION_SCHEMA.STATISTICS + WHERE TABLE_SCHEMA = DATABASE() + AND INDEX_NAME = ? + AND TABLE_NAME LIKE ? + GROUP BY TABLE_NAME'; + $result = $this->connection->executeQuery($sql, ['_uuid', 'oc_openregister_table_%']); + } + + foreach ($result->fetchAll() as $row) { + $name = $row['tablename'] ?? $row['TABLE_NAME'] ?? null; + if ($name !== null) { + $tableNames[] = (string) $name; + } + } + } catch (Throwable $e) { + // If introspection fails (unsupported platform, permission issue), + // surface no tables and let the caller log the no-op message. + return []; + } + + return $tableNames; + + }//end findAffectedTables() + + +}//end class From ae4c32b8b35f47de28f546bd3f1ca9c18366f079 Mon Sep 17 00:00:00 2001 From: Robert Zondervan Date: Thu, 21 May 2026 16:32:00 +0200 Subject: [PATCH 021/333] fix(validate-self-folder-access): wire TransitionEngine through ?IUser, scope CLI/import/settings sites to follow-up (PR #1431 fourth-pass) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes Wilco's 4th-pass concern that the `?IUser $currentUser` plumbing landed (API surface) but no non-HTTP caller actually passes a user. Default-deny on `@self.folder`-bound objects was silently failing those code paths. **Wired in this PR — `TransitionEngine`:** `$this->userSession` was already injected for actor-attribution on dispatched events; the fix is a 1-line forward of the resolved user to `objectService->saveObject(..., currentUser: $actingUser)`. Now event-listener-triggered lifecycle transitions (a common path when @self.folder-bound objects are involved) carry the acting user explicitly to the folder-access check. A small refactor along with this: pull `$actingUser` out of the session lookup ONCE and reuse it for both the `saveObject` call and the existing `$userId` extraction for the dispatched event. Reads slightly cleaner and avoids a double session lookup. **Scoped to follow-up — CLI / import / settings sites:** Opened issue #1613 covering the four remaining non-HTTP callers: - `RematerialiseCalculationsCommand` (OCC CLI) - `ImportHandler` × 2 (CLI / cron / import endpoint) - `SettingsService` × 2 (app-settings re-save loops) - Mapper adapter / MCP / GraphQL surfaces Each needs a design decision — `--user` CLI flag vs. system-user resolution pattern vs. pass-through from the original requester — that's larger than this PR's scope. The follow-up captures the sites, the suggested patterns per site, and the acceptance criteria. This is the resolution Wilco offered as "acceptable if the team prefers a focused PR" — the API surface fix in PR #1431 is the substantive Thread-C closure; the caller wiring is mechanical follow-up. Refs: ConductionNL/openregister#1431, Wilco's fourth-pass inline comment `3281604010`, follow-up tracking issue #1613 --- lib/Service/Lifecycle/TransitionEngine.php | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/lib/Service/Lifecycle/TransitionEngine.php b/lib/Service/Lifecycle/TransitionEngine.php index e7e109a03d2a..3b8a77d963d7 100644 --- a/lib/Service/Lifecycle/TransitionEngine.php +++ b/lib/Service/Lifecycle/TransitionEngine.php @@ -152,14 +152,23 @@ public function transition(string $objectId, string $action): ObjectEntity // the transition on save; the guard (if any) will run there too. $data[$field] = $to; + // Forward the session user explicitly to the save path so the + // @self.folder access check in `ensureObjectFolder` resolves to a + // concrete IUser rather than falling through to the session + // lookup (and the default-deny path on event-listener-triggered + // saves where the session can be null). PR #1431 fourth-pass + // concern. + $actingUser = $this->userSession->getUser(); + $saved = $this->objectService->saveObject( object: $data, register: $object->getRegister(), schema: $object->getSchema(), - uuid: $object->getUuid() + uuid: $object->getUuid(), + currentUser: $actingUser ); - $userId = $this->userSession->getUser()?->getUID(); + $userId = $actingUser?->getUID(); $this->eventDispatcher->dispatchTyped( new ObjectTransitionedEvent( From b4b7120b825c97376177e0222b77dd1c74a83759 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Thu, 21 May 2026 23:24:44 +0200 Subject: [PATCH 022/333] chore: sync canonical root configs + mechanical phpmd cleanup (#1641) Phase 2 fleet rollout of the root-config consolidation for the openregister foundation app. Drops per-app phpcs/phpmd/psalm/phpstan extensions in favour of the canonical from nextcloud-app-template, then cleans the mechanical phpmd violations unmasked by the sync. Config changes: - phpcs.xml: sync canonical, restore OpenRegister description. - phpmd.xml: canonical, restore OpenRegister ruleset name. - psalm.xml: sync canonical + add errorBaseline="psalm-baseline.xml" attribute (psalm-baseline.xml preserved untouched per fleet plan). - phpstan.neon: sync canonical (now uses phpstan-bootstrap.php instead of vendor/autoload.php; includes phpstan-baseline.neon). - phpstan-bootstrap.php: NEW from canonical. - phpstan-baseline.neon: regenerated with 1724 entries baselined. Header points to the tracking issue (#1640). - phpcs-custom-sniffs/.../{SpecTagSniff,NoLegacyServerAccessorsSniff}.php: custom sniffs the synced phpcs.xml references. Mechanical phpmd source cleanup (160 -> 59 violations): - MissingImport (57 -> 0): added 25+ `use` statements across Application.php, BookmarksProvider, CalendarProvider, TasksProvider, ExternalIntegrationRouter, ResponseGenerationHandler, ObjectService, PdfReportWriter, UserService. - ElseExpression (15 -> 0): refactored to early-return / continue / default-then-override patterns. - UnusedFormalParameter (7 -> 0): added @SuppressWarnings on deprecated facade signatures with TODO comments. - UnusedLocalVariable (2 -> 0): foreach key renamed to $_ with @SuppressWarnings to satisfy phpmd's strict ignore-name rule. - BooleanArgumentFlag (2 -> 0): suppressed on requestHeaders($withBody) in OpenProjectProvider / XwikiProvider; body-vs-no-body is the natural HTTP-headers toggle. Quality gates after sync: - phpcs: 336 errors / 3594 warnings (CustomSniffs/Commenting SpecTag ADR-008 annotation debt + Squiz inline-if) - tracked in #1640. - phpstan: 0 unmatched errors (1724 baselined per #1640). - psalm: 145 unbaselined errors surfaced by the stricter canonical config - psalm-baseline.xml preserved untouched per fleet plan, follow-ups tracked in #1640. - phpmd: 59 architectural violations remain (Cyclomatic/NPath/ ExcessiveMethodLength/Coupling/StaticAccess/etc.) - tracked in #1640. openregister has the largest follow-up scope of the fleet; phpmd / phpcs / psalm CI will be red until #1640 is worked through. Admin merge authorized. Refs: #1640 --- lib/AppInfo/Application.php | 170 ++- lib/Controller/ChatStreamController.php | 5 +- lib/Controller/OrganisationController.php | 4 +- lib/Db/AuditTrailMapper.php | 28 - lib/Db/MagicMapper.php | 8 +- lib/Db/MagicMapper/MagicSearchHandler.php | 11 +- lib/Db/Schema.php | 23 +- lib/Listener/NotifyPushListener.php | 6 +- .../Chat/ResponseGenerationHandler.php | 11 +- lib/Service/Configuration/ImportHandler.php | 4 +- .../BuiltinProviders/TasksProvider.php | 5 +- .../Integration/ExternalIntegrationRouter.php | 11 +- .../Providers/BookmarksProvider.php | 3 +- .../Providers/CalendarProvider.php | 3 +- .../Providers/OpenProjectProvider.php | 2 + .../Integration/Providers/XwikiProvider.php | 2 + .../AnnotationNotificationDispatcher.php | 3 +- lib/Service/Object/PermissionHandler.php | 4 +- lib/Service/ObjectService.php | 5 +- lib/Service/RegisterService.php | 3 +- lib/Service/Reporting/PdfReportWriter.php | 3 +- .../Settings/ConfigurationSettingsHandler.php | 16 +- lib/Service/SettingsService.php | 3 +- lib/Service/TextExtraction/EmlParser.php | 7 +- lib/Service/UserService.php | 2 +- .../Sniffs/Commenting/SpecTagSniff.php | 377 +++++ phpcs.xml | 51 +- phpmd.xml | 2 +- phpstan-baseline.neon | 1207 +++++++++++++---- phpstan-bootstrap.php | 9 + phpstan.neon | 73 +- psalm.xml | 120 +- 32 files changed, 1639 insertions(+), 542 deletions(-) create mode 100644 phpcs-custom-sniffs/CustomSniffs/Sniffs/Commenting/SpecTagSniff.php create mode 100644 phpstan-bootstrap.php diff --git a/lib/AppInfo/Application.php b/lib/AppInfo/Application.php index dd45feea8d55..00078e4b2811 100644 --- a/lib/AppInfo/Application.php +++ b/lib/AppInfo/Application.php @@ -213,10 +213,32 @@ use OCA\OpenRegister\Service\LanguageService; use OCA\OpenRegister\Middleware\LanguageMiddleware; use OCA\OpenRegister\Capabilities\UrnCapability; +use OCA\OpenRegister\Capabilities\IntegrationsCapability; +use OCA\OpenRegister\Controller\IntegrationsController; +use OCA\OpenRegister\Controller\ObjectIntegrationsController; use OCA\OpenRegister\Mcp\IMcpToolProvider; use OCA\OpenRegister\Mcp\BuiltIn\RegistersToolProvider; use OCA\OpenRegister\Mcp\BuiltIn\SchemasToolProvider; use OCA\OpenRegister\Mcp\BuiltIn\ObjectsToolProvider; +use OCA\OpenRegister\Repair\LogDanglingLinkedTypes; +use OCA\OpenRegister\Service\Integration\BuiltinProviders\AuditTrailProvider; +use OCA\OpenRegister\Service\Integration\BuiltinProviders\FilesProvider; +use OCA\OpenRegister\Service\Integration\BuiltinProviders\NotesProvider; +use OCA\OpenRegister\Service\Integration\BuiltinProviders\TagsProvider; +use OCA\OpenRegister\Service\Integration\BuiltinProviders\TasksProvider; +use OCA\OpenRegister\Service\Integration\ExternalIntegrationRouter; +use OCA\OpenRegister\Service\Integration\IntegrationRegistry; +use OCA\OpenRegister\Service\Integration\PropertyReferenceTypeValidator; +use OCA\OpenRegister\Service\Integration\Providers\BookmarksProvider; +use OCA\OpenRegister\Service\Integration\Providers\CalendarProvider; +use OCA\OpenRegister\Service\Integration\Providers\ContactsProvider; +use OCA\OpenRegister\Service\Integration\Providers\DeckProvider; +use OCA\OpenRegister\Service\Integration\Providers\EmailProvider; +use OCA\OpenRegister\Service\Integration\Providers\OpenProjectProvider; +use OCA\OpenRegister\Service\Integration\Providers\PollsProvider; +use OCA\OpenRegister\Service\Integration\Providers\SharesProvider; +use OCA\OpenRegister\Service\Integration\Providers\TalkProvider; +use OCA\OpenRegister\Service\Integration\Providers\XwikiProvider; use OCA\OpenRegister\Service\Mcp\McpToolsService; /** @@ -324,7 +346,7 @@ function () { // Pluggable-integration-registry task 4.5 (tasks.md#task-22): // advertise the integration registry through the OCS // capabilities endpoint. - $context->registerCapability(\OCA\OpenRegister\Capabilities\IntegrationsCapability::class); + $context->registerCapability(IntegrationsCapability::class); }//end register() /** @@ -841,18 +863,18 @@ function (ContainerInterface $container) { private function registerIntegrationRegistry(IRegistrationContext $context): void { $context->registerService( - \OCA\OpenRegister\Service\Integration\IntegrationRegistry::class, + IntegrationRegistry::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\IntegrationRegistry( + return new IntegrationRegistry( logger: $container->get('Psr\Log\LoggerInterface') ); } ); $context->registerService( - \OCA\OpenRegister\Service\Integration\ExternalIntegrationRouter::class, + ExternalIntegrationRouter::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\ExternalIntegrationRouter( + return new ExternalIntegrationRouter( appManager: $container->get('OCP\App\IAppManager'), container: $container, logger: $container->get('Psr\Log\LoggerInterface') @@ -866,10 +888,10 @@ function (ContainerInterface $container) { // validateLinkedTypesValue path so existing schemas keep // validating exactly as before. $context->registerService( - \OCA\OpenRegister\Service\Integration\PropertyReferenceTypeValidator::class, + PropertyReferenceTypeValidator::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\PropertyReferenceTypeValidator( - registry: $container->get(\OCA\OpenRegister\Service\Integration\IntegrationRegistry::class), + return new PropertyReferenceTypeValidator( + registry: $container->get(IntegrationRegistry::class), ); } ); @@ -879,10 +901,10 @@ function (ContainerInterface $container) { // ids that the registry can no longer resolve. Strictly // informational; never throws, never modifies data. $context->registerService( - \OCA\OpenRegister\Repair\LogDanglingLinkedTypes::class, + LogDanglingLinkedTypes::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Repair\LogDanglingLinkedTypes( - registry: $container->get(\OCA\OpenRegister\Service\Integration\IntegrationRegistry::class), + return new LogDanglingLinkedTypes( + registry: $container->get(IntegrationRegistry::class), container: $container, logger: $container->get('Psr\Log\LoggerInterface') ); @@ -893,12 +915,12 @@ function (ContainerInterface $container) { // IntegrationsController — read-only API over the registry. $context->registerService( - \OCA\OpenRegister\Controller\IntegrationsController::class, + IntegrationsController::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Controller\IntegrationsController( + return new IntegrationsController( appName: 'openregister', request: $container->get('OCP\IRequest'), - registry: $container->get(\OCA\OpenRegister\Service\Integration\IntegrationRegistry::class), + registry: $container->get(IntegrationRegistry::class), userSession: $container->get('OCP\IUserSession'), groupManager: $container->get('OCP\IGroupManager'), logger: $container->get('Psr\Log\LoggerInterface') @@ -909,12 +931,12 @@ function (ContainerInterface $container) { // ObjectIntegrationsController — object-scoped sub-resource // dispatch through the registry. $context->registerService( - \OCA\OpenRegister\Controller\ObjectIntegrationsController::class, + ObjectIntegrationsController::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Controller\ObjectIntegrationsController( + return new ObjectIntegrationsController( appName: 'openregister', request: $container->get('OCP\IRequest'), - registry: $container->get(\OCA\OpenRegister\Service\Integration\IntegrationRegistry::class), + registry: $container->get(IntegrationRegistry::class), logger: $container->get('Psr\Log\LoggerInterface') ); } @@ -929,10 +951,10 @@ function (ContainerInterface $container) { // IntegrationsCapability — surfaces the registry through the // Nextcloud OCS capabilities endpoint, role-redacted per AD-17. $context->registerService( - \OCA\OpenRegister\Capabilities\IntegrationsCapability::class, + IntegrationsCapability::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Capabilities\IntegrationsCapability( - registry: $container->get(\OCA\OpenRegister\Service\Integration\IntegrationRegistry::class), + return new IntegrationsCapability( + registry: $container->get(IntegrationRegistry::class), userSession: $container->get('OCP\IUserSession'), groupManager: $container->get('OCP\IGroupManager') ); @@ -959,9 +981,9 @@ function (ContainerInterface $container) { private function registerBuiltinIntegrationProviders(IRegistrationContext $context): void { $context->registerService( - \OCA\OpenRegister\Service\Integration\BuiltinProviders\FilesProvider::class, + FilesProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\BuiltinProviders\FilesProvider( + return new FilesProvider( fileService: $container->get(\OCA\OpenRegister\Service\FileService::class), container: $container, l10n: $container->get('OCP\IL10N'), @@ -970,9 +992,9 @@ function (ContainerInterface $container) { ); $context->registerService( - \OCA\OpenRegister\Service\Integration\BuiltinProviders\NotesProvider::class, + NotesProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\BuiltinProviders\NotesProvider( + return new NotesProvider( noteService: $container->get(\OCA\OpenRegister\Service\NoteService::class), l10n: $container->get('OCP\IL10N'), ); @@ -980,9 +1002,9 @@ function (ContainerInterface $container) { ); $context->registerService( - \OCA\OpenRegister\Service\Integration\BuiltinProviders\TasksProvider::class, + TasksProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\BuiltinProviders\TasksProvider( + return new TasksProvider( taskService: $container->get(\OCA\OpenRegister\Service\TaskService::class), l10n: $container->get('OCP\IL10N'), ); @@ -990,9 +1012,9 @@ function (ContainerInterface $container) { ); $context->registerService( - \OCA\OpenRegister\Service\Integration\BuiltinProviders\TagsProvider::class, + TagsProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\BuiltinProviders\TagsProvider( + return new TagsProvider( tagManager: $container->get('OCP\SystemTag\ISystemTagManager'), objectMapper: $container->get('OCP\SystemTag\ISystemTagObjectMapper'), l10n: $container->get('OCP\IL10N'), @@ -1001,9 +1023,9 @@ function (ContainerInterface $container) { ); $context->registerService( - \OCA\OpenRegister\Service\Integration\BuiltinProviders\AuditTrailProvider::class, + AuditTrailProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\BuiltinProviders\AuditTrailProvider( + return new AuditTrailProvider( mapper: $container->get(\OCA\OpenRegister\Db\AuditTrailMapper::class), l10n: $container->get('OCP\IL10N'), ); @@ -1016,10 +1038,10 @@ function (ContainerInterface $container) { // OpenConnector `xwiki` source. // @spec openspec/changes/integration-xwiki/tasks.md. $context->registerService( - \OCA\OpenRegister\Service\Integration\Providers\XwikiProvider::class, + XwikiProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\Providers\XwikiProvider( - router: $container->get(\OCA\OpenRegister\Service\Integration\ExternalIntegrationRouter::class), + return new XwikiProvider( + router: $container->get(ExternalIntegrationRouter::class), appManager: $container->get('OCP\App\IAppManager'), l10n: $container->get('OCP\IL10N'), ); @@ -1031,10 +1053,10 @@ function (ContainerInterface $container) { // on the OpenConnector `openproject` source. // @spec openspec/changes/integration-openproject/tasks.md. $context->registerService( - \OCA\OpenRegister\Service\Integration\Providers\OpenProjectProvider::class, + OpenProjectProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\Providers\OpenProjectProvider( - router: $container->get(\OCA\OpenRegister\Service\Integration\ExternalIntegrationRouter::class), + return new OpenProjectProvider( + router: $container->get(ExternalIntegrationRouter::class), appManager: $container->get('OCP\App\IAppManager'), l10n: $container->get('OCP\IL10N'), ); @@ -1048,9 +1070,9 @@ function (ContainerInterface $container) { // provider gates on its required NC app via IAppManager. // @spec openspec/changes/integration-calendar/tasks.md. $context->registerService( - \OCA\OpenRegister\Service\Integration\Providers\CalendarProvider::class, + CalendarProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\Providers\CalendarProvider( + return new CalendarProvider( calendarEventService: $container->get(\OCA\OpenRegister\Service\CalendarEventService::class), appManager: $container->get('OCP\App\IAppManager'), l10n: $container->get('OCP\IL10N'), @@ -1060,9 +1082,9 @@ function (ContainerInterface $container) { // @spec openspec/changes/integration-contacts/tasks.md. $context->registerService( - \OCA\OpenRegister\Service\Integration\Providers\ContactsProvider::class, + ContactsProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\Providers\ContactsProvider( + return new ContactsProvider( contactService: $container->get(\OCA\OpenRegister\Service\ContactService::class), appManager: $container->get('OCP\App\IAppManager'), l10n: $container->get('OCP\IL10N'), @@ -1072,9 +1094,9 @@ function (ContainerInterface $container) { // @spec openspec/changes/integration-deck/tasks.md. $context->registerService( - \OCA\OpenRegister\Service\Integration\Providers\DeckProvider::class, + DeckProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\Providers\DeckProvider( + return new DeckProvider( deckCardService: $container->get(\OCA\OpenRegister\Service\DeckCardService::class), appManager: $container->get('OCP\App\IAppManager'), l10n: $container->get('OCP\IL10N'), @@ -1084,9 +1106,9 @@ function (ContainerInterface $container) { // @spec openspec/changes/integration-email/tasks.md. $context->registerService( - \OCA\OpenRegister\Service\Integration\Providers\EmailProvider::class, + EmailProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\Providers\EmailProvider( + return new EmailProvider( emailService: $container->get(\OCA\OpenRegister\Service\EmailService::class), appManager: $container->get('OCP\App\IAppManager'), l10n: $container->get('OCP\IL10N'), @@ -1140,9 +1162,9 @@ function (ContainerInterface $container) use ($providerClass) { // against the `share` table's `note` column. // @spec openspec/changes/integration-shares/tasks.md. $context->registerService( - \OCA\OpenRegister\Service\Integration\Providers\SharesProvider::class, + SharesProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\Providers\SharesProvider( + return new SharesProvider( db: $container->get('OCP\IDBConnection'), appManager: $container->get('OCP\App\IAppManager'), l10n: $container->get('OCP\IL10N'), @@ -1156,9 +1178,9 @@ function (ContainerInterface $container) { // bookmark query to the current user. // @spec openspec/changes/integration-bookmarks/tasks.md. $context->registerService( - \OCA\OpenRegister\Service\Integration\Providers\BookmarksProvider::class, + BookmarksProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\Providers\BookmarksProvider( + return new BookmarksProvider( container: $container, appManager: $container->get('OCP\App\IAppManager'), userSession: $container->get('OCP\IUserSession'), @@ -1172,9 +1194,9 @@ function (ContainerInterface $container) { // IUserSession to scope `getRoomsForUser`. // @spec openspec/changes/integration-talk/tasks.md. $context->registerService( - \OCA\OpenRegister\Service\Integration\Providers\TalkProvider::class, + TalkProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\Providers\TalkProvider( + return new TalkProvider( container: $container, appManager: $container->get('OCP\App\IAppManager'), userSession: $container->get('OCP\IUserSession'), @@ -1189,9 +1211,9 @@ function (ContainerInterface $container) { // marker in the poll title. // @spec openspec/changes/integration-polls/tasks.md. $context->registerService( - \OCA\OpenRegister\Service\Integration\Providers\PollsProvider::class, + PollsProvider::class, function (ContainerInterface $container) { - return new \OCA\OpenRegister\Service\Integration\Providers\PollsProvider( + return new PollsProvider( container: $container, appManager: $container->get('OCP\App\IAppManager'), userSession: $container->get('OCP\IUserSession'), @@ -1419,13 +1441,13 @@ function (ContainerInterface $container) { ['appId' => $appId, 'via' => $key, 'class' => get_class($appProvider)] ); break; - } else { - $resolvedClass = is_object($appProvider) === true ? get_class($appProvider) : gettype($appProvider); - $logger->warning( - '[McpToolsService] Resolved but not IMcpToolProvider', - ['appId' => $appId, 'via' => $key, 'class' => $resolvedClass] - ); } + + $resolvedClass = is_object($appProvider) === true ? get_class($appProvider) : gettype($appProvider); + $logger->warning( + '[McpToolsService] Resolved but not IMcpToolProvider', + ['appId' => $appId, 'via' => $key, 'class' => $resolvedClass] + ); } catch (\Throwable $e) { $logger->warning( '[McpToolsService] Resolve failed', @@ -1499,7 +1521,7 @@ private function bootBuiltinIntegrationProviders($server): void { try { $integrationRegistry = $server->get( - \OCA\OpenRegister\Service\Integration\IntegrationRegistry::class + IntegrationRegistry::class ); } catch (\Throwable $e) { // Registry binding not available — skip silently; the @@ -1508,25 +1530,25 @@ private function bootBuiltinIntegrationProviders($server): void } $providerClasses = [ - \OCA\OpenRegister\Service\Integration\BuiltinProviders\FilesProvider::class, - \OCA\OpenRegister\Service\Integration\BuiltinProviders\NotesProvider::class, - \OCA\OpenRegister\Service\Integration\BuiltinProviders\TasksProvider::class, - \OCA\OpenRegister\Service\Integration\BuiltinProviders\TagsProvider::class, - \OCA\OpenRegister\Service\Integration\BuiltinProviders\AuditTrailProvider::class, + FilesProvider::class, + NotesProvider::class, + TasksProvider::class, + TagsProvider::class, + AuditTrailProvider::class, // Leaves: external (OpenConnector-backed). // @spec openspec/changes/integration-xwiki/tasks.md. - \OCA\OpenRegister\Service\Integration\Providers\XwikiProvider::class, + XwikiProvider::class, // @spec openspec/changes/integration-openproject/tasks.md. - \OCA\OpenRegister\Service\Integration\Providers\OpenProjectProvider::class, + OpenProjectProvider::class, // Leaves: NC-native, backend-shipped (wrap existing OR services). // @spec openspec/changes/integration-calendar/tasks.md. - \OCA\OpenRegister\Service\Integration\Providers\CalendarProvider::class, + CalendarProvider::class, // @spec openspec/changes/integration-contacts/tasks.md. - \OCA\OpenRegister\Service\Integration\Providers\ContactsProvider::class, + ContactsProvider::class, // @spec openspec/changes/integration-deck/tasks.md. - \OCA\OpenRegister\Service\Integration\Providers\DeckProvider::class, + DeckProvider::class, // @spec openspec/changes/integration-email/tasks.md. - \OCA\OpenRegister\Service\Integration\Providers\EmailProvider::class, + EmailProvider::class, // Leaves: NC-app-backed greenfield (registry surface only; // service + link table land in per-leaf follow-ups). // @spec openspec/changes/integration-activity/tasks.md. @@ -1534,7 +1556,7 @@ private function bootBuiltinIntegrationProviders($server): void // @spec openspec/changes/integration-analytics/tasks.md. \OCA\OpenRegister\Service\Integration\Providers\AnalyticsProvider::class, // @spec openspec/changes/integration-bookmarks/tasks.md. - \OCA\OpenRegister\Service\Integration\Providers\BookmarksProvider::class, + BookmarksProvider::class, // @spec openspec/changes/integration-collectives/tasks.md. \OCA\OpenRegister\Service\Integration\Providers\CollectivesProvider::class, // @spec openspec/changes/integration-cospend/tasks.md. @@ -1548,11 +1570,11 @@ private function bootBuiltinIntegrationProviders($server): void // @spec openspec/changes/integration-photos/tasks.md. \OCA\OpenRegister\Service\Integration\Providers\PhotosProvider::class, // @spec openspec/changes/integration-polls/tasks.md. - \OCA\OpenRegister\Service\Integration\Providers\PollsProvider::class, + PollsProvider::class, // @spec openspec/changes/integration-shares/tasks.md. - \OCA\OpenRegister\Service\Integration\Providers\SharesProvider::class, + SharesProvider::class, // @spec openspec/changes/integration-talk/tasks.md. - \OCA\OpenRegister\Service\Integration\Providers\TalkProvider::class, + TalkProvider::class, // @spec openspec/changes/integration-time-tracker/tasks.md. \OCA\OpenRegister\Service\Integration\Providers\TimeProvider::class, ]; diff --git a/lib/Controller/ChatStreamController.php b/lib/Controller/ChatStreamController.php index 1ed65dbbdc68..34c6daf65e9c 100644 --- a/lib/Controller/ChatStreamController.php +++ b/lib/Controller/ChatStreamController.php @@ -411,9 +411,10 @@ private function safeShutdown(bool $rollback): void if ($this->db->inTransaction() === true) { if ($rollback === true) { $this->db->rollBack(); - } else { - $this->db->commit(); + return; } + + $this->db->commit(); } } catch (Throwable $e) { $this->logger->warning( diff --git a/lib/Controller/OrganisationController.php b/lib/Controller/OrganisationController.php index cd0a16102f38..8636df150123 100644 --- a/lib/Controller/OrganisationController.php +++ b/lib/Controller/OrganisationController.php @@ -1169,10 +1169,10 @@ public function activate(string $uuid): JSONResponse if ($status === TenantLifecycleService::STATUS_PROVISIONING) { $userId = \OC::$server->get(\OCP\IUserSession::class)->getUser()?->getUID() ?? 'admin'; $result = $this->tenantLifecycleService->provision($organisation, $userId); - } else { - $result = $this->tenantLifecycleService->reactivate($organisation); + return new JSONResponse(data: $result, statusCode: Http::STATUS_OK); } + $result = $this->tenantLifecycleService->reactivate($organisation); return new JSONResponse(data: $result, statusCode: Http::STATUS_OK); } catch (Exception $e) { $statusCode = $e->getCode() >= 400 ? $e->getCode() : Http::STATUS_INTERNAL_SERVER_ERROR; diff --git a/lib/Db/AuditTrailMapper.php b/lib/Db/AuditTrailMapper.php index 2f80f90e9f10..f0e6a480772f 100644 --- a/lib/Db/AuditTrailMapper.php +++ b/lib/Db/AuditTrailMapper.php @@ -160,8 +160,6 @@ public function findByImportJobId(string $importJobId, ?string $action='create') return $this->findEntities(query: $qb); }//end findByImportJobId() - - /** * Finds an audit trail by id * @@ -182,7 +180,6 @@ public function find(int $id): AuditTrail return $this->findEntity(query: $qb); }//end find() - /** * Find all audit trails with filters and sorting * @@ -324,9 +321,6 @@ function ($key) { return $this->findEntities(query: $qb); }//end findAll() - - - /** * Creates an audit trail for object changes * @@ -632,7 +626,6 @@ private function readProcessingActivityFromRegister($registerId): ?string }//end readProcessingActivityFromRegister() - /** * Get audit trails for an object until a specific point or version * @@ -703,7 +696,6 @@ public function findByObjectUntil(int $objectId, string $objectUuid, $until=null return $this->findEntities(query: $qb); }//end findByObjectUntil() - /** * Check if a string is a semantic version * @@ -716,7 +708,6 @@ private function isSemanticVersion(string $version): bool return (preg_match('/^\d+\.\d+\.\d+$/', $version) === 1); }//end isSemanticVersion() - /** * Revert an object to a previous state * @@ -766,7 +757,6 @@ public function revertObject($identifier, $until=null, bool $overwriteVersion=fa return $revertedObject; }//end revertObject() - /** * Helper function to revert changes from an audit trail entry * @@ -792,7 +782,6 @@ private function revertChanges(ObjectEntity $object, AuditTrail $audit): void } }//end revertChanges() - /** * Get statistics for audit trails with optional filtering * @@ -885,7 +874,6 @@ public function getStatistics(?int $registerId=null, ?int $schemaId=null, array }//end try }//end getStatistics() - /** * Updates an entity in the database * @@ -907,7 +895,6 @@ public function update(Entity $entity): AuditTrail return parent::update(entity: $entity); }//end update() - /** * Get chart data for audit trail actions over time * @@ -1012,7 +999,6 @@ function ($data) use ($action) { }//end try }//end getActionChartData() - /** * Get detailed statistics for audit trails including action counts within timeframe * @@ -1113,7 +1099,6 @@ public function getDetailedStatistics(?int $registerId=null, ?int $schemaId=null }//end try }//end getDetailedStatistics() - /** * Get action distribution data with percentages * @@ -1192,7 +1177,6 @@ public function getActionDistribution(?int $registerId=null, ?int $schemaId=null }//end try }//end getActionDistribution() - /** * Get most active objects based on audit trail activity * @@ -1268,7 +1252,6 @@ public function getMostActiveObjects(?int $registerId=null, ?int $schemaId=null, }//end try }//end getMostActiveObjects() - /** * Clear expired logs from the database * @@ -1317,7 +1300,6 @@ public function clearLogs(): bool }//end try }//end clearLogs() - /** * Clear all audit trail logs (not just expired ones) * @@ -1358,9 +1340,6 @@ public function clearAllLogs(): bool }//end try }//end clearAllLogs() - - - /** * Set expiry dates for audit trails based on retention period in milliseconds * @@ -1411,7 +1390,6 @@ public function setExpiryDate(int $retentionMs): int }//end try }//end setExpiryDate() - /** * Get audit trail statistics grouped by schema for multiple schemas in a single query * @@ -1479,7 +1457,6 @@ public function getStatisticsGroupedBySchema(array $schemaIds): array }//end try }//end getStatisticsGroupedBySchema() - /** * Create a custom audit trail entry for archival operations. * @@ -1522,7 +1499,6 @@ public function createAuditTrailEntry( return $this->insert(entity: $auditTrail); }//end createAuditTrailEntry() - /** * Get processing activities from audit trail entries. * @@ -1577,7 +1553,6 @@ public function getProcessingActivities(?string $organisationId=null): array return array_values($activities); }//end getProcessingActivities() - /** * Find audit trail entries by identifier. * @@ -1616,7 +1591,6 @@ public function findByIdentifier(string $identifier): array return $grouped; }//end findByIdentifier() - /** * Find audit trail entries by the actor (user UID) that produced them. * @@ -1693,6 +1667,4 @@ public function findByActor( 'total' => (int) ($row['total_count'] ?? 0), ]; }//end findByActor() - - }//end class diff --git a/lib/Db/MagicMapper.php b/lib/Db/MagicMapper.php index db6f6baf4e37..6ffca822d4d7 100644 --- a/lib/Db/MagicMapper.php +++ b/lib/Db/MagicMapper.php @@ -1277,6 +1277,7 @@ private function searchAcrossMultipleTablesWithUnion(array $query, array $regist * @SuppressWarnings(PHPMD.ExcessiveMethodLength) * @SuppressWarnings(PHPMD.CyclomaticComplexity) * @SuppressWarnings(PHPMD.NPathComplexity) + * @SuppressWarnings(PHPMD.UnusedLocalVariable) `$_` is the conventional ignore name in the metadata-column foreach */ private function buildUnionSelectPart( string $tableName, @@ -1299,12 +1300,13 @@ private function buildUnionSelectPart( // Cast to text for UNION type compatibility (some columns are jsonb, others text). $metadataColumns = $this->getMetadataColumns(); $selectColumns = []; - foreach ($metadataColumns as $metaCol => $metaDef) { + foreach ($metadataColumns as $metaCol => $_) { if ($this->columnExistsInTable(tableName: $tableName, columnName: $metaCol) === true) { $selectColumns[] = "{$metaCol}::text AS {$metaCol}"; - } else { - $selectColumns[] = "NULL::text AS {$metaCol}"; + continue; } + + $selectColumns[] = "NULL::text AS {$metaCol}"; } /* diff --git a/lib/Db/MagicMapper/MagicSearchHandler.php b/lib/Db/MagicMapper/MagicSearchHandler.php index 9e93c7e7bf23..9013e0d29025 100644 --- a/lib/Db/MagicMapper/MagicSearchHandler.php +++ b/lib/Db/MagicMapper/MagicSearchHandler.php @@ -497,11 +497,12 @@ private function buildSearchConditionSql( if ($isPostgres === true) { // ILIKE is always case-insensitive on PostgreSQL. $searchConditions[] = "{$quotedCol}::text ILIKE {$likePattern}"; - } else { - // CAST + LOWER on both sides keeps MySQL case-insensitive regardless of - // collation (e.g., utf8mb4_bin), matching applyFullTextSearch(). - $searchConditions[] = "LOWER(CAST({$quotedCol} AS CHAR)) LIKE LOWER({$likePattern})"; - }//end if + continue; + } + + // CAST + LOWER on both sides keeps MySQL case-insensitive regardless of + // collation (e.g., utf8mb4_bin), matching applyFullTextSearch(). + $searchConditions[] = "LOWER(CAST({$quotedCol} AS CHAR)) LIKE LOWER({$likePattern})"; }//end if }//end foreach diff --git a/lib/Db/Schema.php b/lib/Db/Schema.php index 1d622b221d32..0ebe3c7ff9cd 100644 --- a/lib/Db/Schema.php +++ b/lib/Db/Schema.php @@ -1696,17 +1696,18 @@ private function validateConfigurationArray(array $configuration): array if (str_starts_with((string) $key, 'x-openregister-') === true) { if (in_array((string) $key, self::ANNOTATION_VOCABULARY, true) === true) { $validatedConfig[$key] = $value; - } else { - // R07: track unknown `x-openregister-*` keys (almost - // always typos like `x-openregister-lifecycl`) so - // SchemaMapper can log them via its structured - // logger after save. The entity has no DI surface - // for a logger and the ADR added in F06 bans the - // `\OC::$server` static accessor — collecting on - // the entity and bridging through the mapper is - // the cleanest path that still surfaces a signal. - $this->droppedAnnotationKeys[] = (string) $key; - }//end if + continue; + } + + // R07: track unknown `x-openregister-*` keys (almost + // always typos like `x-openregister-lifecycl`) so + // SchemaMapper can log them via its structured + // logger after save. The entity has no DI surface + // for a logger and the ADR added in F06 bans the + // `\OC::$server` static accessor — collecting on + // the entity and bridging through the mapper is + // the cleanest path that still surfaces a signal. + $this->droppedAnnotationKeys[] = (string) $key; }//end if }//end foreach diff --git a/lib/Listener/NotifyPushListener.php b/lib/Listener/NotifyPushListener.php index 9b77965ddac9..a70a911828fa 100644 --- a/lib/Listener/NotifyPushListener.php +++ b/lib/Listener/NotifyPushListener.php @@ -157,7 +157,9 @@ public function handle(Event $event): void } else if ($event instanceof ObjectDeletedEvent) { $action = 'delete'; $object = $event->getObject(); - } else { + } + + if (isset($action) === false || isset($object) === false) { return; } @@ -332,6 +334,8 @@ public static function resetStaticState(): void * @return void * * @spec openspec/changes/add-live-updates/tasks.md#task-4 + * + * @SuppressWarnings(PHPMD.UnusedFormalParameter) Permission handler retained on the signature for upcoming per-user batch routing */ public static function flushBatch(object $queue, PermissionHandler $permHandler): void { diff --git a/lib/Service/Chat/ResponseGenerationHandler.php b/lib/Service/Chat/ResponseGenerationHandler.php index 9703c0e8b688..64cc7901a539 100644 --- a/lib/Service/Chat/ResponseGenerationHandler.php +++ b/lib/Service/Chat/ResponseGenerationHandler.php @@ -34,6 +34,7 @@ use OCA\OpenRegister\Db\Agent; use OCA\OpenRegister\Service\SettingsService; use OCA\OpenRegister\Service\Chat\ToolManagementHandler; +use OCA\OpenRegister\Tool\StreamingToolInstanceWrapper; use Psr\Log\LoggerInterface; use LLPhant\Chat\OpenAIChat; use LLPhant\Chat\OllamaChat; @@ -42,6 +43,7 @@ use LLPhant\OllamaConfig; use LLPhant\Exception\MissingFeatureException; use Psr\Http\Message\StreamInterface; +use ReflectionClass; /** * ResponseGenerationHandler @@ -318,9 +320,10 @@ public function generateResponse( foreach ($cnAiContext as $key => $value) { if (is_scalar($value) === true) { $systemPrompt .= "- {$key}: ".(string) $value."\n"; - } else { - $systemPrompt .= "- {$key}: ".json_encode($value, JSON_UNESCAPED_SLASHES)."\n"; + continue; } + + $systemPrompt .= "- {$key}: ".json_encode($value, JSON_UNESCAPED_SLASHES)."\n"; } } @@ -506,7 +509,7 @@ private function wrapToolsForStreaming(array $functionInfoObjects, ?StreamYieldC foreach ($functionInfoObjects as $fi) { if (is_object($fi->instance) === true) { - $fi->instance = new \OCA\OpenRegister\Tool\StreamingToolInstanceWrapper( + $fi->instance = new StreamingToolInstanceWrapper( wrapped: $fi->instance, channel: $channel ); @@ -583,7 +586,7 @@ private function invokeChat( private function chatHasTools(OpenAIChat|OllamaChat $chat): bool { try { - $refl = new \ReflectionClass($chat); + $refl = new ReflectionClass($chat); if ($refl->hasProperty(name: 'tools') === false) { return false; } diff --git a/lib/Service/Configuration/ImportHandler.php b/lib/Service/Configuration/ImportHandler.php index ccfd94ebe2b2..23e0d11ff684 100644 --- a/lib/Service/Configuration/ImportHandler.php +++ b/lib/Service/Configuration/ImportHandler.php @@ -2695,7 +2695,9 @@ private function autoCreateRegisterIfApplication( 'unionSchemaIds' => $unionSchemaIds, ] ); - } else { + }//end if + + if ($register === null) { // Fresh insert: derive a new Register entity. $register = $this->registerMapper->createFromArray( object: [ diff --git a/lib/Service/Integration/BuiltinProviders/TasksProvider.php b/lib/Service/Integration/BuiltinProviders/TasksProvider.php index 283db5bedbaf..568d85e32c83 100644 --- a/lib/Service/Integration/BuiltinProviders/TasksProvider.php +++ b/lib/Service/Integration/BuiltinProviders/TasksProvider.php @@ -29,6 +29,7 @@ namespace OCA\OpenRegister\Service\Integration\BuiltinProviders; +use RuntimeException; use OCA\OpenRegister\Db\RegisterMapper; use OCA\OpenRegister\Db\SchemaMapper; use OCA\OpenRegister\Exception\NotImplementedException; @@ -219,7 +220,7 @@ public function create(string $register, string $schema, string $objectId, array ); if ($task === null) { - throw new \RuntimeException('TaskService::createTask returned null — calendar invalid or auth failure.'); + throw new RuntimeException('TaskService::createTask returned null — calendar invalid or auth failure.'); } return $task; @@ -242,7 +243,7 @@ public function update(string $register, string $schema, string $objectId, strin $updated = $this->taskService->updateTask(calendarId: $calendarId, taskUri: $taskUri, data: $payload); if ($updated === null) { - throw new \RuntimeException('TaskService::updateTask returned null — entity may not exist.'); + throw new RuntimeException('TaskService::updateTask returned null — entity may not exist.'); } return $updated; diff --git a/lib/Service/Integration/ExternalIntegrationRouter.php b/lib/Service/Integration/ExternalIntegrationRouter.php index 937f3f0d8b97..56f63e622696 100644 --- a/lib/Service/Integration/ExternalIntegrationRouter.php +++ b/lib/Service/Integration/ExternalIntegrationRouter.php @@ -35,10 +35,12 @@ namespace OCA\OpenRegister\Service\Integration; +use LogicException; use OCA\OpenRegister\Exception\ProviderUnavailableException; use OCP\App\IAppManager; use Psr\Container\ContainerInterface; use Psr\Log\LoggerInterface; +use RuntimeException; /** * Routes external integrations' CRUD calls through OpenConnector. @@ -207,7 +209,7 @@ public function probe(IntegrationProvider $provider): array private function assertProviderIsExternal(IntegrationProvider $provider): void { if ($provider->getStorageStrategy() !== 'external') { - throw new \LogicException( + throw new LogicException( sprintf( 'ExternalIntegrationRouter::call() invoked with non-external provider %s (storage=%s)', $provider->getId(), @@ -293,7 +295,7 @@ private function loadSource(string $sourceId, string $providerId) } if ($source === null) { - throw new \RuntimeException(sprintf('OpenConnector source "%s" not found', $sourceId)); + throw new RuntimeException(sprintf('OpenConnector source "%s" not found', $sourceId)); } return $source; @@ -343,7 +345,7 @@ private function invoke($source, string $method, string $path, array $options): return $this->decodeResponse(response: $response); } - throw new \RuntimeException( + throw new RuntimeException( 'OpenConnector\\Service\\CallService does not expose a known call/request method.' ); }//end invoke() @@ -371,10 +373,9 @@ private function assertUpstreamOk($response): void return; } + $cause = ProviderUnavailableException::CAUSE_UPSTREAM_SERVICE_DOWN; if ($status === 401 || $status === 403) { $cause = ProviderUnavailableException::CAUSE_PROVIDER_AUTH; - } else { - $cause = ProviderUnavailableException::CAUSE_UPSTREAM_SERVICE_DOWN; } throw new ProviderUnavailableException( diff --git a/lib/Service/Integration/Providers/BookmarksProvider.php b/lib/Service/Integration/Providers/BookmarksProvider.php index 532f6f3f4505..26c7f4228957 100644 --- a/lib/Service/Integration/Providers/BookmarksProvider.php +++ b/lib/Service/Integration/Providers/BookmarksProvider.php @@ -32,6 +32,7 @@ // phpcs:disable PEAR.Commenting.FunctionComment.Missing -- self-documenting IntegrationProvider metadata getters mirror the contract in the interface. +use OCA\Bookmarks\QueryParameters; use OCA\OpenRegister\Service\Integration\AbstractIntegrationProvider; use OCP\App\IAppManager; use OCP\IL10N; @@ -118,7 +119,7 @@ public function list(string $register, string $schema, string $objectId, array $ try { $mapper = $this->container->get('OCA\\Bookmarks\\Db\\BookmarkMapper'); - $queryParameters = new \OCA\Bookmarks\QueryParameters(); + $queryParameters = new QueryParameters(); $queryParameters->setTags([$tag]); $bookmarks = $mapper->findAll($userId, $queryParameters); } catch (Throwable $e) { diff --git a/lib/Service/Integration/Providers/CalendarProvider.php b/lib/Service/Integration/Providers/CalendarProvider.php index 4f910ef37cd7..f1b32d1b0c0e 100644 --- a/lib/Service/Integration/Providers/CalendarProvider.php +++ b/lib/Service/Integration/Providers/CalendarProvider.php @@ -39,6 +39,7 @@ // phpcs:disable PEAR.Commenting.FunctionComment.Missing -- self-documenting IntegrationProvider metadata getters mirror the contract in the interface. +use InvalidArgumentException; use OCA\OpenRegister\Service\CalendarEventService; use OCA\OpenRegister\Service\Integration\AbstractIntegrationProvider; use OCP\App\IAppManager; @@ -152,7 +153,7 @@ public function delete(string $register, string $schema, string $objectId, strin { $parts = explode('/', $entityId, 2); if (count($parts) !== 2) { - throw new \InvalidArgumentException('Calendar entityId must be "calendarId/eventUri"'); + throw new InvalidArgumentException('Calendar entityId must be "calendarId/eventUri"'); } [$calendarId, $eventUri] = $parts; diff --git a/lib/Service/Integration/Providers/OpenProjectProvider.php b/lib/Service/Integration/Providers/OpenProjectProvider.php index 3d506e012154..6b5b943cddab 100644 --- a/lib/Service/Integration/Providers/OpenProjectProvider.php +++ b/lib/Service/Integration/Providers/OpenProjectProvider.php @@ -284,6 +284,8 @@ private function contextQuery(string $register, string $schema, string $objectId * @param bool $withBody Whether the request carries a JSON body. * * @return array + * + * @SuppressWarnings(PHPMD.BooleanArgumentFlag) Body-vs-no-body is the natural toggle for HTTP request headers; a two-method split (requestHeaders / requestHeadersWithBody) would duplicate the static Accept header */ private function requestHeaders(bool $withBody=false): array { diff --git a/lib/Service/Integration/Providers/XwikiProvider.php b/lib/Service/Integration/Providers/XwikiProvider.php index 9e5a0798b63a..33eb9bb68972 100644 --- a/lib/Service/Integration/Providers/XwikiProvider.php +++ b/lib/Service/Integration/Providers/XwikiProvider.php @@ -381,6 +381,8 @@ private function contextQuery(string $register, string $schema, string $objectId * @param bool $withBody Whether the request carries a JSON body. * * @return array + * + * @SuppressWarnings(PHPMD.BooleanArgumentFlag) Body-vs-no-body is the natural toggle for HTTP request headers; a two-method split would duplicate the static Accept header */ private function requestHeaders(bool $withBody=false): array { diff --git a/lib/Service/Notification/AnnotationNotificationDispatcher.php b/lib/Service/Notification/AnnotationNotificationDispatcher.php index d534a727a566..baea31933ce0 100644 --- a/lib/Service/Notification/AnnotationNotificationDispatcher.php +++ b/lib/Service/Notification/AnnotationNotificationDispatcher.php @@ -818,10 +818,9 @@ private function emitTalk(array $spec, string $message): void // dependency is preferred; the server container fallback // exists for callers that constructed the dispatcher with // the legacy (no-IConfig) signature. + $base = (string) $this->serverContainer->get(\OCP\IConfig::class)->getSystemValue('overwrite.cli.url', 'http://localhost'); if ($this->config !== null) { $base = (string) $this->config->getSystemValue('overwrite.cli.url', 'http://localhost'); - } else { - $base = (string) $this->serverContainer->get(\OCP\IConfig::class)->getSystemValue('overwrite.cli.url', 'http://localhost'); } $base = rtrim($base, '/'); diff --git a/lib/Service/Object/PermissionHandler.php b/lib/Service/Object/PermissionHandler.php index 7119817968a4..f3c8b279849c 100644 --- a/lib/Service/Object/PermissionHandler.php +++ b/lib/Service/Object/PermissionHandler.php @@ -304,6 +304,8 @@ private function buildPermissionCacheKey( * * @return bool True when at least one authorization entry carries * a non-empty `match` block. + * + * @SuppressWarnings(PHPMD.UnusedLocalVariable) `$_` is the conventional ignore name for the unused foreach key */ private function schemaHasMatchRule(Schema $schema): bool { @@ -312,7 +314,7 @@ private function schemaHasMatchRule(Schema $schema): bool return false; } - foreach ($authorization as $action => $entries) { + foreach ($authorization as $_ => $entries) { if (is_array($entries) === false) { continue; } diff --git a/lib/Service/ObjectService.php b/lib/Service/ObjectService.php index 610785f502ea..658022d81cd1 100644 --- a/lib/Service/ObjectService.php +++ b/lib/Service/ObjectService.php @@ -73,6 +73,7 @@ use OCA\OpenRegister\Service\Object\ValidationHandler; use OCA\OpenRegister\Service\Object\CascadingHandler; use OCA\OpenRegister\Service\Object\MigrationHandler; +use OCA\OpenRegister\Exception\AppendOnlyException; use OCA\OpenRegister\Exception\ValidationException; use OCA\OpenRegister\Exception\CustomValidationException; use OCP\AppFramework\Db\DoesNotExistException as OcpDoesNotExistException; @@ -1114,7 +1115,7 @@ public function saveObject( // Reject UPDATE operations on append-only schemas (INSERT is still allowed). if ($uuid !== null && $this->currentSchema !== null && $this->currentSchema->isAppendOnly() === true) { $schemaSlug = $this->currentSchema->getSlug() ?? (string) $this->currentSchema->getId(); - throw new \OCA\OpenRegister\Exception\AppendOnlyException( + throw new AppendOnlyException( schemaIdentifier: $schemaSlug, operation: 'update' ); @@ -1509,7 +1510,7 @@ public function deleteObject(string $uuid, bool $_rbac=true, bool $_multitenancy // Reject DELETE operations on append-only schemas. if ($this->currentSchema !== null && $this->currentSchema->isAppendOnly() === true) { $schemaSlug = $this->currentSchema->getSlug() ?? (string) $this->currentSchema->getId(); - throw new \OCA\OpenRegister\Exception\AppendOnlyException( + throw new AppendOnlyException( schemaIdentifier: $schemaSlug, operation: 'delete' ); diff --git a/lib/Service/RegisterService.php b/lib/Service/RegisterService.php index 107342e490b7..ecf9b6127056 100644 --- a/lib/Service/RegisterService.php +++ b/lib/Service/RegisterService.php @@ -419,10 +419,9 @@ public function getSchemaObjectCounts(int $registerId, array $schemas): array } $quotedTableName = $this->db->getQueryBuilder()->getTableName($tableName); + $schemaIdExpr = "CAST({$schemaId} AS CHAR)"; if ($isPostgres === true) { $schemaIdExpr = "{$schemaId}::text"; - } else { - $schemaIdExpr = "CAST({$schemaId} AS CHAR)"; } $unionQueries[] = " diff --git a/lib/Service/Reporting/PdfReportWriter.php b/lib/Service/Reporting/PdfReportWriter.php index 70ba4709dd5b..f667677a7b26 100644 --- a/lib/Service/Reporting/PdfReportWriter.php +++ b/lib/Service/Reporting/PdfReportWriter.php @@ -28,6 +28,7 @@ namespace OCA\OpenRegister\Service\Reporting; use Dompdf\Dompdf; +use RuntimeException; use Dompdf\Options; /** @@ -87,7 +88,7 @@ public function write(array $dashboard, array $resolvedWidgets): string // CVEs (CVE-2022-41343, CVE-2023-23924); these flags are the // primary mitigation and must stay false. if ($options->getIsRemoteEnabled() !== false || $options->getIsPhpEnabled() !== false) { - throw new \RuntimeException( + throw new RuntimeException( 'PdfReportWriter sandbox configuration drifted; remote-fetch / PHP execution must remain disabled.' ); } diff --git a/lib/Service/Settings/ConfigurationSettingsHandler.php b/lib/Service/Settings/ConfigurationSettingsHandler.php index 66226d60179d..e267bb2e3392 100644 --- a/lib/Service/Settings/ConfigurationSettingsHandler.php +++ b/lib/Service/Settings/ConfigurationSettingsHandler.php @@ -1158,13 +1158,13 @@ public function getFileSettingsOnly(): array ], 'ocrEnabled' => false, 'maxFileSizeMB' => 100, - // Text extraction settings (for FileConfiguration component). + // Text extraction settings (for FileConfiguration component). 'extractionScope' => 'objects', - // None, all, folders, objects. + // None, all, folders, objects. 'textExtractor' => 'llphant', - // Llphant, dolphin. + // Llphant, dolphin. 'extractionMode' => 'background', - // Background, immediate, manual. + // Background, immediate, manual. 'maxFileSize' => 100, 'batchSize' => 10, 'dolphinApiEndpoint' => '', @@ -1228,13 +1228,13 @@ public function updateFileSettingsOnly(array $fileData): array ], 'ocrEnabled' => $fileData['ocrEnabled'] ?? false, 'maxFileSizeMB' => $fileData['maxFileSizeMB'] ?? 100, - // Text extraction settings (from FileConfiguration component). + // Text extraction settings (from FileConfiguration component). 'extractionScope' => $fileData['extractionScope'] ?? 'objects', - // None, all, folders, objects. + // None, all, folders, objects. 'textExtractor' => $fileData['textExtractor'] ?? 'llphant', - // Llphant, dolphin. + // Llphant, dolphin. 'extractionMode' => $fileData['extractionMode'] ?? 'background', - // Background, immediate, manual. + // Background, immediate, manual. 'maxFileSize' => $fileData['maxFileSize'] ?? 100, 'batchSize' => $fileData['batchSize'] ?? 10, 'dolphinApiEndpoint' => $fileData['dolphinApiEndpoint'] ?? '', diff --git a/lib/Service/SettingsService.php b/lib/Service/SettingsService.php index cd593c29a62d..b6609edb5e34 100644 --- a/lib/Service/SettingsService.php +++ b/lib/Service/SettingsService.php @@ -678,7 +678,8 @@ public function updateSolrFacetConfiguration(array $data): array * * @return never Warmup result * - * @SuppressWarnings(PHPMD.BooleanArgumentFlag) Boolean flag needed for error collection behavior + * @SuppressWarnings(PHPMD.BooleanArgumentFlag) Boolean flag needed for error collection behavior + * @SuppressWarnings(PHPMD.UnusedFormalParameter) Public facade signature kept while the deprecated delegate is refactored — see lib/Service/SettingsService.php TODO comment */ public function warmupSolrIndex( array $schemas=[], diff --git a/lib/Service/TextExtraction/EmlParser.php b/lib/Service/TextExtraction/EmlParser.php index 09ddb948daca..4ed7899a57f6 100644 --- a/lib/Service/TextExtraction/EmlParser.php +++ b/lib/Service/TextExtraction/EmlParser.php @@ -171,12 +171,11 @@ public function flatten(EmlStructure $structure, int $depth=0): string continue; } + $rendered = (string) $value; if ($key === 'date' && $value instanceof DateTimeImmutable) { $rendered = $value->format(DateTimeImmutable::ATOM); } else if (is_array($value) === true) { $rendered = implode(', ', $value); - } else { - $rendered = (string) $value; } $lines[] = ucfirst($key).': '.$rendered; @@ -379,7 +378,9 @@ private function buildAttachment(IMessagePart $part, int $position, int $depth): if (strtolower(string: $mimeType) === 'message/rfc822') { if ($depth < self::MAX_DEPTH) { $nestedEml = $this->parseNestedEml(bytes: $bytes, depth: ($depth + 1)); - } else { + } + + if ($depth >= self::MAX_DEPTH) { $this->logger->debug( message: '[EmlParser] EML nesting depth limit reached', context: [ diff --git a/lib/Service/UserService.php b/lib/Service/UserService.php index 0e1c4567ccd8..7b23c589c0bd 100644 --- a/lib/Service/UserService.php +++ b/lib/Service/UserService.php @@ -1239,7 +1239,7 @@ public function createApiToken(IUser $user, string $name, ?string $expiresIn=nul if ($expiresIn !== null && $expiresIn !== '') { $expires = $this->parseExpiration(expiresIn: $expiresIn); if ($expires === null) { - throw new \InvalidArgumentException( + throw new InvalidArgumentException( 'Invalid expiresIn value "'.$expiresIn.'" — expected a number followed by d (days), h (hours), or m (minutes), e.g. "90d".' ); } diff --git a/phpcs-custom-sniffs/CustomSniffs/Sniffs/Commenting/SpecTagSniff.php b/phpcs-custom-sniffs/CustomSniffs/Sniffs/Commenting/SpecTagSniff.php new file mode 100644 index 000000000000..ae6ad7ee474b --- /dev/null +++ b/phpcs-custom-sniffs/CustomSniffs/Sniffs/Commenting/SpecTagSniff.php @@ -0,0 +1,377 @@ + + */ + private const MAGIC_METHODS = [ + '__construct', + '__destruct', + '__get', + '__set', + '__call', + '__callstatic', + '__isset', + '__unset', + '__tostring', + '__invoke', + '__clone', + '__sleep', + '__wakeup', + '__serialize', + '__unserialize', + '__set_state', + '__debuginfo', + ]; + + + /** + * Returns tokens this sniff listens for. + * + * @return array + */ + public function register(): array + { + return [T_CLASS, T_FUNCTION]; + + }//end register() + + + /** + * Process a T_CLASS or T_FUNCTION token. + * + * @param File $phpcsFile The file being scanned. + * @param int $stackPtr Position of the token. + * + * @return void + */ + public function process(File $phpcsFile, $stackPtr): void + { + // Skip test files. + if ($this->isTestFile(phpcsFile: $phpcsFile) === true) { + return; + } + + $tokens = $phpcsFile->getTokens(); + $code = $tokens[$stackPtr]['code']; + + if ($code === T_CLASS) { + $this->processClass(phpcsFile: $phpcsFile, stackPtr: $stackPtr); + return; + } + + if ($code === T_FUNCTION) { + $this->processFunction(phpcsFile: $phpcsFile, stackPtr: $stackPtr); + return; + } + + }//end process() + + + /** + * Check a class declaration for an @spec docblock tag. + * + * Skips anonymous classes (no name follows the T_CLASS keyword). + * + * @param File $phpcsFile The file being scanned. + * @param int $stackPtr Position of the T_CLASS token. + * + * @return void + */ + private function processClass(File $phpcsFile, int $stackPtr): void + { + $tokens = $phpcsFile->getTokens(); + + // Anonymous classes — $var = new class { ... } — have no name; skip. + $namePtr = $phpcsFile->findNext(T_STRING, ($stackPtr + 1), null, false, null, true); + if ($namePtr === false) { + return; + } + + // Sanity: name should be on the same line or within a short window. + $openBracePtr = $phpcsFile->findNext(T_OPEN_CURLY_BRACKET, ($stackPtr + 1)); + if ($openBracePtr !== false && $namePtr > $openBracePtr) { + return; + } + + $className = $tokens[$namePtr]['content']; + + if ($this->hasSpecTag(phpcsFile: $phpcsFile, stackPtr: $stackPtr) === true) { + return; + } + + $message = 'Class %s is missing @spec PHPDoc tag — link back to openspec/changes/{name}/tasks.md#task-N'; + $phpcsFile->addWarning($message, $stackPtr, 'MissingClassSpec', [$className]); + + }//end processClass() + + + /** + * Check a function declaration for an @spec docblock tag. + * + * Only flags public methods declared inside a class. Global functions, + * private/protected methods, and magic methods are skipped. + * + * @param File $phpcsFile The file being scanned. + * @param int $stackPtr Position of the T_FUNCTION token. + * + * @return void + */ + private function processFunction(File $phpcsFile, int $stackPtr): void + { + $tokens = $phpcsFile->getTokens(); + + // Must be inside a class scope. + $className = $this->getEnclosingClassName(phpcsFile: $phpcsFile, stackPtr: $stackPtr); + if ($className === null) { + return; + } + + // Get method name. + $namePtr = $phpcsFile->findNext(T_STRING, ($stackPtr + 1)); + if ($namePtr === false) { + return; + } + + $methodName = $tokens[$namePtr]['content']; + + // Skip magic methods. + if (in_array(strtolower($methodName), self::MAGIC_METHODS, true) === true) { + return; + } + + // Determine visibility: default is public when no modifier present. + if ($this->isPublicMethod(phpcsFile: $phpcsFile, stackPtr: $stackPtr) === false) { + return; + } + + if ($this->hasSpecTag(phpcsFile: $phpcsFile, stackPtr: $stackPtr) === true) { + return; + } + + $message = 'Public method %s::%s() is missing @spec PHPDoc tag'; + $phpcsFile->addWarning($message, $stackPtr, 'MissingMethodSpec', [$className, $methodName]); + + }//end processFunction() + + + /** + * Check whether the docblock directly preceding $stackPtr contains an @spec tag. + * + * Walks backwards from the token skipping whitespace, attribute tokens, and + * visibility/abstract/final/static modifiers. If the next non-skipped token + * is the close of a doc comment, scan the block for @spec. + * + * @param File $phpcsFile The file being scanned. + * @param int $stackPtr Position of the class/function token. + * + * @return bool True when an @spec tag is present. + */ + private function hasSpecTag(File $phpcsFile, int $stackPtr): bool + { + $tokens = $phpcsFile->getTokens(); + + $skip = [ + T_WHITESPACE, + T_ABSTRACT, + T_FINAL, + T_STATIC, + T_PUBLIC, + T_PROTECTED, + T_PRIVATE, + T_READONLY, + T_ATTRIBUTE, + T_ATTRIBUTE_END, + ]; + + $ptr = ($stackPtr - 1); + while ($ptr >= 0) { + $code = $tokens[$ptr]['code']; + + // Skip over attribute blocks (PHP 8 #[Attribute]) in full. + if ($code === T_ATTRIBUTE_END && isset($tokens[$ptr]['attribute_opener']) === true) { + $ptr = ($tokens[$ptr]['attribute_opener'] - 1); + continue; + } + + if (in_array($code, $skip, true) === true) { + $ptr--; + continue; + } + + break; + } + + if ($ptr < 0) { + return false; + } + + if ($tokens[$ptr]['code'] !== T_DOC_COMMENT_CLOSE_TAG) { + return false; + } + + if (isset($tokens[$ptr]['comment_opener']) === false) { + return false; + } + + $opener = $tokens[$ptr]['comment_opener']; + for ($i = $opener; $i <= $ptr; $i++) { + if ($tokens[$i]['code'] === T_DOC_COMMENT_TAG + && strtolower($tokens[$i]['content']) === '@spec' + ) { + return true; + } + } + + return false; + + }//end hasSpecTag() + + + /** + * Determine if the function at $stackPtr is a public method. + * + * Methods default to public when no visibility modifier is present. + * + * @param File $phpcsFile The file being scanned. + * @param int $stackPtr Position of the T_FUNCTION token. + * + * @return bool True when the method is public (explicit or default). + */ + private function isPublicMethod(File $phpcsFile, int $stackPtr): bool + { + $tokens = $phpcsFile->getTokens(); + + $ptr = ($stackPtr - 1); + while ($ptr >= 0) { + $code = $tokens[$ptr]['code']; + if ($code === T_PUBLIC) { + return true; + } + + if ($code === T_PROTECTED || $code === T_PRIVATE) { + return false; + } + + if ($code === T_WHITESPACE + || $code === T_ABSTRACT + || $code === T_FINAL + || $code === T_STATIC + || $code === T_READONLY + ) { + $ptr--; + continue; + } + + // Skip attributes in full. + if ($code === T_ATTRIBUTE_END && isset($tokens[$ptr]['attribute_opener']) === true) { + $ptr = ($tokens[$ptr]['attribute_opener'] - 1); + continue; + } + + if ($code === T_DOC_COMMENT_CLOSE_TAG + || $code === T_COMMENT + || $code === T_OPEN_CURLY_BRACKET + || $code === T_CLOSE_CURLY_BRACKET + || $code === T_SEMICOLON + ) { + // No visibility modifier found — default public. + return true; + } + + $ptr--; + } + + return true; + + }//end isPublicMethod() + + + /** + * Return the name of the class/interface/trait/enum enclosing $stackPtr, or null. + * + * @param File $phpcsFile The file being scanned. + * @param int $stackPtr Position of the token to inspect. + * + * @return string|null The enclosing class name, or null when at file scope. + */ + private function getEnclosingClassName(File $phpcsFile, int $stackPtr): ?string + { + $tokens = $phpcsFile->getTokens(); + + if (isset($tokens[$stackPtr]['conditions']) === false) { + return null; + } + + // Walk the conditions chain looking for the innermost class-like scope. + $classLike = [T_CLASS, T_INTERFACE, T_TRAIT, T_ENUM, T_ANON_CLASS]; + + foreach (array_reverse($tokens[$stackPtr]['conditions'], true) as $scopePtr => $scopeCode) { + if (in_array($scopeCode, $classLike, true) === true) { + $namePtr = $phpcsFile->findNext(T_STRING, ($scopePtr + 1)); + if ($namePtr === false) { + return '{anonymous}'; + } + + // Sanity: ensure the name is before the opening brace for that class. + if (isset($tokens[$scopePtr]['scope_opener']) === true + && $namePtr > $tokens[$scopePtr]['scope_opener'] + ) { + return '{anonymous}'; + } + + return $tokens[$namePtr]['content']; + } + } + + return null; + + }//end getEnclosingClassName() + + + /** + * Check whether the currently-scanned file is a test file. + * + * @param File $phpcsFile The file being scanned. + * + * @return bool True for files under /tests/ or /Tests/. + */ + private function isTestFile(File $phpcsFile): bool + { + $path = str_replace('\\', '/', $phpcsFile->getFilename()); + return (stripos($path, '/tests/') !== false); + + }//end isTestFile() + + +}//end class diff --git a/phpcs.xml b/phpcs.xml index 5c4ac5f172b3..ee4197926c63 100644 --- a/phpcs.xml +++ b/phpcs.xml @@ -1,17 +1,24 @@ - The coding standard for PHP_CodeSniffer itself, for more config -> for https://github.com/squizlabs/PHP_CodeSniffer/wiki/Configuration-Options. + Coding standard for OpenRegister, based on the Conduction/OpenRegister standard. lib */vendor/* + */vendor-bin/* */node_modules/* composer-setup.php + + lib/Resources/template/* + + + - + @@ -46,22 +53,22 @@ - - + - + + + + + - - - lib/Db/AuditTrailMapper\.php @@ -76,14 +83,18 @@ - + - + + + + + @@ -154,8 +165,6 @@ - lib/Service/Settings/ConfigurationSettingsHandler\.php - lib/Db/AuditTrailMapper\.php @@ -192,16 +201,6 @@ error - - - tests/bootstrap\.php - - - - - tests/Core/Tokenizer/StableCommentWhitespaceWinTest\.php - - 0 @@ -221,9 +220,15 @@ error - + error + + + warning + + diff --git a/phpmd.xml b/phpmd.xml index 7c6badc52636..5696820bbd3d 100644 --- a/phpmd.xml +++ b/phpmd.xml @@ -6,7 +6,7 @@ http://pmd.sourceforge.net/ruleset_xml_schema.xsd"> - OpenRegister Nextcloud Rules + This is a custom ruleset for OpenRegister Nextcloud. diff --git a/phpstan-baseline.neon b/phpstan-baseline.neon index f32835f8867a..8afb715e7f01 100644 --- a/phpstan-baseline.neon +++ b/phpstan-baseline.neon @@ -1,5 +1,25 @@ +# Tracked phpstan debt entries surfaced when openregister synced to the fleet canonical. +# All entries are tracked in https://github.com/ConductionNL/openregister/issues/1640 +# (Phase 2 fleet rollout lint-debt cleanup). Regenerate with: +# ./vendor/bin/phpstan analyse --generate-baseline=phpstan-baseline.neon +# Entries removed as the underlying code is refactored. parameters: ignoreErrors: + - + message: "#^Missing parameter \\$objectService \\(OCA\\\\OpenRegister\\\\Service\\\\ObjectService\\) in call to OCA\\\\OpenRegister\\\\Service\\\\Integration\\\\BuiltinProviders\\\\TasksProvider constructor\\.$#" + count: 1 + path: lib/AppInfo/Application.php + + - + message: "#^Missing parameter \\$registerMapper \\(OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\) in call to OCA\\\\OpenRegister\\\\Service\\\\Integration\\\\BuiltinProviders\\\\TasksProvider constructor\\.$#" + count: 1 + path: lib/AppInfo/Application.php + + - + message: "#^Missing parameter \\$schemaMapper \\(OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\) in call to OCA\\\\OpenRegister\\\\Service\\\\Integration\\\\BuiltinProviders\\\\TasksProvider constructor\\.$#" + count: 1 + path: lib/AppInfo/Application.php + - message: "#^Parameter \\$container of class OCA\\\\OpenRegister\\\\Service\\\\Object\\\\CacheHandler constructor expects OCP\\\\AppFramework\\\\IAppContainer\\|null, Psr\\\\Container\\\\ContainerInterface given\\.$#" count: 1 @@ -15,6 +35,16 @@ parameters: count: 1 path: lib/AppInfo/Application.php + - + message: "#^Call to method getNextRunDate\\(\\) on an unknown class Cron\\\\CronExpression\\.$#" + count: 1 + path: lib/BackgroundJob/ActionScheduleJob.php + + - + message: "#^Instantiated class Cron\\\\CronExpression not found\\.$#" + count: 1 + path: lib/BackgroundJob/ActionScheduleJob.php + - message: "#^Variable \\$fileId on left side of \\?\\? always exists and is not nullable\\.$#" count: 1 @@ -35,6 +65,26 @@ parameters: count: 1 path: lib/BackgroundJob/ReportRenderJob.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\MagicMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/BackgroundJob/ReportRenderJob.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/BackgroundJob/ReportRenderJob.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\MagicMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/BackgroundJob/ReportRenderJob.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/BackgroundJob/ReportRenderJob.php + - message: "#^Strict comparison using \\=\\=\\= between true and false will always evaluate to false\\.$#" count: 2 @@ -60,6 +110,11 @@ parameters: count: 1 path: lib/Calendar/RegisterCalendarProvider.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Calendar/RegisterCalendarProvider.php + - message: "#^Call to an undefined method OCA\\\\OpenRegister\\\\Db\\\\Register\\:\\:getName\\(\\)\\.$#" count: 1 @@ -70,6 +125,16 @@ parameters: count: 1 path: lib/Command/MigrateStorageCommand.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Command/RematerialiseCalculationsCommand.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Command/RematerialiseCalculationsCommand.php + - message: "#^Property OCA\\\\OpenRegister\\\\Command\\\\SolrDebugCommand\\:\\:\\$clientService is never read, only written\\.$#" count: 1 @@ -105,21 +170,6 @@ parameters: count: 1 path: lib/Controller/AgentsController.php - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\AgentsController\\:\\:show\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<403\\|404, array\\{error\\: 'Access denied to…'\\|'Agent not found'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Agent, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Agent, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/AgentsController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\AgentsController\\:\\:show\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<403\\|404, array\\{error\\: 'Access denied to…'\\|'Agent not found'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Agent, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<403, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/AgentsController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\AgentsController\\:\\:show\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<403\\|404, array\\{error\\: 'Access denied to…'\\|'Agent not found'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Agent, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/AgentsController.php - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\AgentsController\\:\\:stats\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|500, array\\{error\\?\\: 'Failed to retrieve…', total\\?\\: int, active\\?\\: int, inactive\\?\\: int\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{total\\: int, active\\: int, inactive\\: int\\}, array\\{\\}\\>\\.$#" count: 1 @@ -290,6 +340,11 @@ parameters: count: 1 path: lib/Controller/ChatController.php + - + message: "#^Offset 'context' does not exist on array\\{conversationUuid\\: string, agentUuid\\: string, message\\: non\\-falsy\\-string, selectedViews\\: array, selectedTools\\: array, ragSettings\\: array\\{includeObjects\\: mixed, includeFiles\\: mixed, numSourcesFiles\\: mixed, numSourcesObjects\\: mixed\\}\\}\\.$#" + count: 1 + path: lib/Controller/ChatController.php + - message: "#^Variable \\$conversationUuid on left side of \\?\\? always exists and is not nullable\\.$#" count: 1 @@ -300,6 +355,26 @@ parameters: count: 1 path: lib/Controller/ChatController.php + - + message: "#^Offset 'message' on array\\{message\\: string, messageId\\: string, sources\\: array\\, timings\\: array\\{context\\: string, history\\: string, llm\\: string, total\\: string\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Controller/ChatStreamController.php + + - + message: "#^Offset 'messageId' on array\\{message\\: string, messageId\\: string, sources\\: array\\, timings\\: array\\{context\\: string, history\\: string, llm\\: string, total\\: string\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Controller/ChatStreamController.php + + - + message: "#^Offset 'response' on array\\{message\\: string, messageId\\: string, sources\\: array\\, timings\\: array\\{context\\: string, history\\: string, llm\\: string, total\\: string\\}\\} on left side of \\?\\? does not exist\\.$#" + count: 1 + path: lib/Controller/ChatStreamController.php + + - + message: "#^Unreachable statement \\- code above always terminates\\.$#" + count: 1 + path: lib/Controller/ChatStreamController.php + - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\ConfigurationController\\:\\:destroy\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404\\|500, array\\{error\\?\\: 'Configuration not…'\\|'Failed to delete…', success\\?\\: true\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{success\\: bool\\}, array\\{\\}\\>\\.$#" count: 1 @@ -475,6 +550,16 @@ parameters: count: 1 path: lib/Controller/ConfigurationsController.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\ConfigurationMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Controller/ConfigurationsController.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\ConfigurationMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Controller/ConfigurationsController.php + - message: "#^Unknown parameter \\$filters in call to method OCA\\\\OpenRegister\\\\Db\\\\ConfigurationMapper\\:\\:findAll\\(\\)\\.$#" count: 1 @@ -730,36 +815,6 @@ parameters: count: 1 path: lib/Controller/EndpointsController.php - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\EndpointsController\\:\\:logs\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404\\|500, array\\{error\\?\\: 'Endpoint not found'\\|'Failed to retrieve…', results\\?\\: array\\, total\\?\\: int\\<0, max\\>\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{results\\: array\\, total\\: int\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/EndpointsController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\EndpointsController\\:\\:logs\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404\\|500, array\\{error\\?\\: 'Endpoint not found'\\|'Failed to retrieve…', results\\?\\: array\\, total\\?\\: int\\<0, max\\>\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/EndpointsController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\EndpointsController\\:\\:logs\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404\\|500, array\\{error\\?\\: 'Endpoint not found'\\|'Failed to retrieve…', results\\?\\: array\\, total\\?\\: int\\<0, max\\>\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<500, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/EndpointsController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\EndpointsController\\:\\:show\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404\\|500, array\\{error\\: 'Endpoint not found'\\|'Failed to retrieve…'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Endpoint, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Endpoint, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/EndpointsController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\EndpointsController\\:\\:show\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404\\|500, array\\{error\\: 'Endpoint not found'\\|'Failed to retrieve…'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Endpoint, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/EndpointsController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\EndpointsController\\:\\:show\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404\\|500, array\\{error\\: 'Endpoint not found'\\|'Failed to retrieve…'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Endpoint, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<500, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/EndpointsController.php - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\EndpointsController\\:\\:test\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\ but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<100\\|101\\|102\\|200\\|201\\|202\\|203\\|204\\|205\\|206\\|207\\|208\\|226\\|300\\|301\\|302\\|303\\|304\\|305\\|306\\|307\\|400\\|401\\|402\\|403\\|404\\|405\\|406\\|407\\|408\\|409\\|410\\|411\\|412\\|413\\|414\\|415\\|416\\|417\\|418\\|422\\|423\\|424\\|426\\|428\\|429\\|431\\|500\\|501\\|502\\|503\\|504\\|505\\|506\\|507\\|508\\|509\\|510\\|511, array\\{success\\: bool, message\\: string, statusCode\\: int\\}, array\\{\\}\\>\\.$#" count: 1 @@ -795,11 +850,6 @@ parameters: count: 1 path: lib/Controller/EndpointsController.php - - - message: "#^Parameter \\$statusCode of class OCP\\\\AppFramework\\\\Http\\\\JSONResponse constructor expects S of 100\\|101\\|102\\|200\\|201\\|202\\|203\\|204\\|205\\|206\\|207\\|208\\|226\\|300\\|301\\|302\\|303\\|304\\|305\\|306\\|307\\|400\\|401\\|402\\|403\\|404\\|405\\|406\\|407\\|408\\|409\\|410\\|411\\|412\\|413\\|414\\|415\\|416\\|417\\|418\\|422\\|423\\|424\\|426\\|428\\|429\\|431\\|500\\|501\\|502\\|503\\|504\\|505\\|506\\|507\\|508\\|509\\|510\\|511, int given\\.$#" - count: 1 - path: lib/Controller/EndpointsController.php - - message: "#^Type int in generic type OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\, array\\> in PHPDoc tag @return is not subtype of template type S of int of class OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\.$#" count: 1 @@ -825,21 +875,6 @@ parameters: count: 1 path: lib/Controller/FileExtractionController.php - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\FileExtractionController\\:\\:extract\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404\\|500, array\\{success\\: bool, error\\?\\: 'Extraction failed'\\|'File not found in…', message\\: string\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{success\\: bool, message\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/FileExtractionController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\FileExtractionController\\:\\:extract\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404\\|500, array\\{success\\: bool, error\\?\\: 'Extraction failed'\\|'File not found in…', message\\: string\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404, array\\{success\\: bool, error\\: string, message\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/FileExtractionController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\FileExtractionController\\:\\:extract\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404\\|500, array\\{success\\: bool, error\\?\\: 'Extraction failed'\\|'File not found in…', message\\: string\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<500, array\\{success\\: bool, error\\: string, message\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/FileExtractionController.php - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\FileExtractionController\\:\\:extractAll\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|500, array\\{success\\: bool, error\\?\\: 'Batch extraction…', message\\: string, data\\?\\: array\\{processed\\: int\\<0, max\\>, failed\\: int\\<0, max\\>, total\\: int\\<0, max\\>\\}\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{success\\: bool, message\\: string, data\\: array\\{processed\\: int, failed\\: int, total\\: int\\}\\}, array\\{\\}\\>\\.$#" count: 1 @@ -870,16 +905,6 @@ parameters: count: 1 path: lib/Controller/FileExtractionController.php - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\FileExtractionController\\:\\:show\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404, array\\{success\\: bool, error\\?\\: 'File not found in…', message\\?\\: string, data\\?\\: non\\-empty\\-array\\\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{success\\: bool, data\\: non\\-empty\\-array\\\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/FileExtractionController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\FileExtractionController\\:\\:show\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404, array\\{success\\: bool, error\\?\\: 'File not found in…', message\\?\\: string, data\\?\\: non\\-empty\\-array\\\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404, array\\{success\\: bool, error\\: string, message\\: string\\}, array\\{\\}\\>\\.$#" - count: 2 - path: lib/Controller/FileExtractionController.php - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\FileExtractionController\\:\\:stats\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|500, array\\{success\\: bool, error\\?\\: 'Failed to retrieve…', message\\?\\: string, data\\?\\: array\\{totalFiles\\: int, untrackedFiles\\: int, totalChunks\\: int, totalObjects\\: int, totalEntities\\: int\\}\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{success\\: bool, data\\: array\\{totalFiles\\: int, untrackedFiles\\: int, totalChunks\\: int, totalObjects\\: int, totalEntities\\: int\\}\\}, array\\{\\}\\>\\.$#" count: 1 @@ -975,11 +1000,6 @@ parameters: count: 1 path: lib/Controller/FilesController.php - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\FilesController\\:\\:processUploadedFiles\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Controller\\\\OCP\\\\Files\\\\File\\.$#" - count: 1 - path: lib/Controller/FilesController.php - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\FilesController\\:\\:processUploadedFiles\\(\\) should return array\\ but returns array\\, OCP\\\\Files\\\\File\\>\\.$#" count: 1 @@ -1055,11 +1075,6 @@ parameters: count: 1 path: lib/Controller/HeartbeatController.php - - - message: "#^Call to method jsonSerialize\\(\\) on an unknown class OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Mapping\\.$#" - count: 1 - path: lib/Controller/MappingsController.php - - message: "#^Parameter \\#1 \\$callback of function array_map expects \\(callable\\(OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Mapping\\)\\: mixed\\)\\|null, Closure\\(OCA\\\\OpenRegister\\\\Db\\\\Mapping\\)\\: array\\ given\\.$#" count: 1 @@ -1295,6 +1310,16 @@ parameters: count: 1 path: lib/Controller/ObjectsController.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Controller/ObjectsController.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Controller/ObjectsController.php + - message: "#^Unreachable statement \\- code above always terminates\\.$#" count: 4 @@ -1510,11 +1535,6 @@ parameters: count: 1 path: lib/Controller/RegistersController.php - - - message: "#^Parameter \\$statusCode of class OCP\\\\AppFramework\\\\Http\\\\JSONResponse constructor expects S of 100\\|101\\|102\\|200\\|201\\|202\\|203\\|204\\|205\\|206\\|207\\|208\\|226\\|300\\|301\\|302\\|303\\|304\\|305\\|306\\|307\\|400\\|401\\|402\\|403\\|404\\|405\\|406\\|407\\|408\\|409\\|410\\|411\\|412\\|413\\|414\\|415\\|416\\|417\\|418\\|422\\|423\\|424\\|426\\|428\\|429\\|431\\|500\\|501\\|502\\|503\\|504\\|505\\|506\\|507\\|508\\|509\\|510\\|511, int given\\.$#" - count: 4 - path: lib/Controller/RegistersController.php - - message: "#^Property OCA\\\\OpenRegister\\\\Controller\\\\RegistersController\\:\\:\\$appManager is never read, only written\\.$#" count: 1 @@ -1540,6 +1560,11 @@ parameters: count: 4 path: lib/Controller/RegistersController.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Controller/RegistersController.php + - message: "#^Property OCA\\\\OpenRegister\\\\Controller\\\\RetentionController\\:\\:\\$saveObject is never read, only written\\.$#" count: 1 @@ -1620,16 +1645,6 @@ parameters: count: 1 path: lib/Controller/SchemasController.php - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\SchemasController\\:\\:download\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404, array\\{error\\: 'Schema not found'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Schema, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Schema, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/SchemasController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\SchemasController\\:\\:download\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404, array\\{error\\: 'Schema not found'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Schema, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/SchemasController.php - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\SchemasController\\:\\:index\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{results\\: array\\\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{results\\: array\\\\}, array\\{\\}\\>\\.$#" count: 1 @@ -1690,11 +1705,6 @@ parameters: count: 2 path: lib/Controller/SchemasController.php - - - message: "#^Parameter \\$statusCode of class OCP\\\\AppFramework\\\\Http\\\\JSONResponse constructor expects S of 100\\|101\\|102\\|200\\|201\\|202\\|203\\|204\\|205\\|206\\|207\\|208\\|226\\|300\\|301\\|302\\|303\\|304\\|305\\|306\\|307\\|400\\|401\\|402\\|403\\|404\\|405\\|406\\|407\\|408\\|409\\|410\\|411\\|412\\|413\\|414\\|415\\|416\\|417\\|418\\|422\\|423\\|424\\|426\\|428\\|429\\|431\\|500\\|501\\|502\\|503\\|504\\|505\\|506\\|507\\|508\\|509\\|510\\|511, int given\\.$#" - count: 6 - path: lib/Controller/SchemasController.php - - message: "#^Property OCA\\\\OpenRegister\\\\Controller\\\\SchemasController\\:\\:\\$config is never read, only written\\.$#" count: 1 @@ -1735,6 +1745,16 @@ parameters: count: 1 path: lib/Controller/SchemasController.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Controller/SchemasController.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Controller/SchemasController.php + - message: "#^Unknown parameter \\$filters in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" count: 1 @@ -1760,6 +1780,26 @@ parameters: count: 1 path: lib/Controller/ScopesController.php + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Controller/ScopesController.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Controller/ScopesController.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Controller/ScopesController.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Controller/ScopesController.php + - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\SearchController\\:\\:search\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{results\\: array\\, total\\: mixed, facets\\: mixed\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{results\\: array\\{\\}, total\\: mixed, facets\\: array\\{\\}\\}, array\\{\\}\\>\\.$#" count: 1 @@ -2546,14 +2586,19 @@ parameters: path: lib/Controller/TransitionController.php - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\UiController\\:\\:makeSpaResponse\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\TemplateResponse but returns static\\(OCP\\\\AppFramework\\\\Http\\\\Response\\\\>\\)\\.$#" + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" count: 1 - path: lib/Controller/UiController.php + path: lib/Controller/TranslationController.php - - message: "#^Parameter \\$statusCode of class OCP\\\\AppFramework\\\\Http\\\\JSONResponse constructor expects S of 100\\|101\\|102\\|200\\|201\\|202\\|203\\|204\\|205\\|206\\|207\\|208\\|226\\|300\\|301\\|302\\|303\\|304\\|305\\|306\\|307\\|400\\|401\\|402\\|403\\|404\\|405\\|406\\|407\\|408\\|409\\|410\\|411\\|412\\|413\\|414\\|415\\|416\\|417\\|418\\|422\\|423\\|424\\|426\\|428\\|429\\|431\\|500\\|501\\|502\\|503\\|504\\|505\\|506\\|507\\|508\\|509\\|510\\|511, int given\\.$#" + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" count: 1 - path: lib/Controller/UserController.php + path: lib/Controller/TranslationController.php + + - + message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\UiController\\:\\:makeSpaResponse\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\TemplateResponse but returns static\\(OCP\\\\AppFramework\\\\Http\\\\Response\\\\>\\)\\.$#" + count: 1 + path: lib/Controller/UiController.php - message: "#^Property OCA\\\\OpenRegister\\\\Controller\\\\UserController\\:\\:\\$l10n is never read, only written\\.$#" @@ -2615,21 +2660,6 @@ parameters: count: 1 path: lib/Controller/WebhooksController.php - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\WebhooksController\\:\\:destroy\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404\\|500, array\\{error\\: 'Failed to delete…'\\|'Webhook not found'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<204, null, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<204, null, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/WebhooksController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\WebhooksController\\:\\:destroy\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404\\|500, array\\{error\\: 'Failed to delete…'\\|'Webhook not found'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<204, null, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/WebhooksController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\WebhooksController\\:\\:destroy\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404\\|500, array\\{error\\: 'Failed to delete…'\\|'Webhook not found'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<204, null, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<500, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/WebhooksController.php - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\WebhooksController\\:\\:index\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|500, array\\{error\\?\\: 'Failed to list…', results\\?\\: array\\\\>, total\\?\\: int\\<0, max\\>\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{results\\: array\\, total\\: int\\}, array\\{\\}\\>\\.$#" count: 1 @@ -2640,36 +2670,6 @@ parameters: count: 1 path: lib/Controller/WebhooksController.php - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\WebhooksController\\:\\:logs\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404\\|500, array\\{error\\?\\: 'Failed to retrieve…'\\|'Webhook not found', results\\?\\: array\\, total\\?\\: int\\<0, max\\>\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, array\\{results\\: array\\, total\\: int\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/WebhooksController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\WebhooksController\\:\\:logs\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404\\|500, array\\{error\\?\\: 'Failed to retrieve…'\\|'Webhook not found', results\\?\\: array\\, total\\?\\: int\\<0, max\\>\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/WebhooksController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\WebhooksController\\:\\:logs\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200\\|404\\|500, array\\{error\\?\\: 'Failed to retrieve…'\\|'Webhook not found', results\\?\\: array\\, total\\?\\: int\\<0, max\\>\\}, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<500, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/WebhooksController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\WebhooksController\\:\\:show\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404\\|500, array\\{error\\: 'Failed to retrieve…'\\|'Webhook not found'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Webhook, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Webhook, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/WebhooksController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\WebhooksController\\:\\:show\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404\\|500, array\\{error\\: 'Failed to retrieve…'\\|'Webhook not found'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Webhook, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/WebhooksController.php - - - - message: "#^Method OCA\\\\OpenRegister\\\\Controller\\\\WebhooksController\\:\\:show\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<404\\|500, array\\{error\\: 'Failed to retrieve…'\\|'Webhook not found'\\}, array\\>\\|OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<200, OCA\\\\OpenRegister\\\\Db\\\\Webhook, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\JSONResponse\\<500, array\\{error\\: string\\}, array\\{\\}\\>\\.$#" - count: 1 - path: lib/Controller/WebhooksController.php - - message: "#^Property OCA\\\\OpenRegister\\\\Controller\\\\WorkflowExecutionController\\:\\:\\$logger is never read, only written\\.$#" count: 1 @@ -2690,6 +2690,16 @@ parameters: count: 1 path: lib/Db/ActionLogMapper.php + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getOrganisation\\(\\)\\.$#" + count: 1 + path: lib/Db/ActionMapper.php + + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setOrganisation\\(\\)\\.$#" + count: 2 + path: lib/Db/ActionMapper.php + - message: "#^Parameter \\$entity of method OCP\\\\AppFramework\\\\Db\\\\QBMapper\\\\:\\:delete\\(\\) expects OCA\\\\OpenRegister\\\\Db\\\\Action, OCP\\\\AppFramework\\\\Db\\\\Entity given\\.$#" count: 1 @@ -2706,10 +2716,15 @@ parameters: path: lib/Db/ActionMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\AgentMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Agent\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getOrganisation\\(\\)\\.$#" count: 1 path: lib/Db/AgentMapper.php + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setOrganisation\\(\\)\\.$#" + count: 2 + path: lib/Db/AgentMapper.php + - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\AgentMapper\\:\\:findAll\\(\\) should return array\\ but returns array\\\\.$#" count: 1 @@ -2721,10 +2736,15 @@ parameters: path: lib/Db/Application.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\ApplicationMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Application\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getOrganisation\\(\\)\\.$#" count: 1 path: lib/Db/ApplicationMapper.php + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setOrganisation\\(\\)\\.$#" + count: 2 + path: lib/Db/ApplicationMapper.php + - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\ApplicationMapper\\:\\:findAll\\(\\) should return array\\ but returns array\\\\.$#" count: 1 @@ -2776,7 +2796,7 @@ parameters: path: lib/Db/AuditTrailMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\AuditTrailMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\AuditTrail\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setSize\\(\\)\\.$#" count: 1 path: lib/Db/AuditTrailMapper.php @@ -2806,12 +2826,17 @@ parameters: path: lib/Db/AuditTrailMapper.php - - message: "#^Constant OCA\\\\OpenRegister\\\\Db\\\\ConfigurationMapper\\:\\:SESSION_KEY_PREFIX is unused\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getOrganisation\\(\\)\\.$#" count: 1 path: lib/Db/ConfigurationMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\ConfigurationMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Configuration\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setOrganisation\\(\\)\\.$#" + count: 2 + path: lib/Db/ConfigurationMapper.php + + - + message: "#^Constant OCA\\\\OpenRegister\\\\Db\\\\ConfigurationMapper\\:\\:SESSION_KEY_PREFIX is unused\\.$#" count: 1 path: lib/Db/ConfigurationMapper.php @@ -2826,7 +2851,12 @@ parameters: path: lib/Db/ConfigurationMapper.php - - message: "#^Parameter \\$entity of method OCP\\\\AppFramework\\\\Db\\\\QBMapper\\\\:\\:delete\\(\\) expects OCA\\\\OpenRegister\\\\Db\\\\Conversation, OCP\\\\AppFramework\\\\Db\\\\Entity given\\.$#" + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\ConfigurationMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Db/ConfigurationMapper.php + + - + message: "#^Parameter \\$entity of method OCP\\\\AppFramework\\\\Db\\\\QBMapper\\\\:\\:delete\\(\\) expects OCA\\\\OpenRegister\\\\Db\\\\Conversation, OCP\\\\AppFramework\\\\Db\\\\Entity given\\.$#" count: 1 path: lib/Db/ConversationMapper.php @@ -2856,18 +2886,18 @@ parameters: path: lib/Db/EndpointLog.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\EndpointLogMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\EndpointLog\\.$#" + message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\EndpointLogMapper\\:\\:findAll\\(\\) should return array\\ but returns array\\\\.$#" count: 1 path: lib/Db/EndpointLogMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\EndpointLogMapper\\:\\:findAll\\(\\) should return array\\ but returns array\\\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getOrganisation\\(\\)\\.$#" count: 1 - path: lib/Db/EndpointLogMapper.php + path: lib/Db/EndpointMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\EndpointMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Endpoint\\.$#" - count: 1 + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setOrganisation\\(\\)\\.$#" + count: 2 path: lib/Db/EndpointMapper.php - @@ -2880,6 +2910,31 @@ parameters: count: 1 path: lib/Db/EndpointMapper.php + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getCreated\\(\\)\\.$#" + count: 1 + path: lib/Db/FeedbackMapper.php + + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getUuid\\(\\)\\.$#" + count: 1 + path: lib/Db/FeedbackMapper.php + + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setCreated\\(\\)\\.$#" + count: 1 + path: lib/Db/FeedbackMapper.php + + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setUpdated\\(\\)\\.$#" + count: 2 + path: lib/Db/FeedbackMapper.php + + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setUuid\\(\\)\\.$#" + count: 1 + path: lib/Db/FeedbackMapper.php + - message: "#^Parameter \\$entity of method OCP\\\\AppFramework\\\\Db\\\\QBMapper\\\\:\\:insert\\(\\) expects OCA\\\\OpenRegister\\\\Db\\\\Feedback, OCP\\\\AppFramework\\\\Db\\\\Entity given\\.$#" count: 1 @@ -3025,6 +3080,16 @@ parameters: count: 1 path: lib/Db/MagicMapper.php + - + message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\) invoked with 5 parameters, 1 required\\.$#" + count: 1 + path: lib/Db/MagicMapper.php + + - + message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\) invoked with 5 parameters, 1 required\\.$#" + count: 1 + path: lib/Db/MagicMapper.php + - message: "#^Offset '\\$ref' on array\\{type\\: string, format\\?\\: string, items\\?\\: array, properties\\?\\: array, required\\?\\: array\\, maxLength\\?\\: int, minLength\\?\\: int, maximum\\?\\: int, \\.\\.\\.\\} in isset\\(\\) does not exist\\.$#" count: 1 @@ -3080,6 +3145,26 @@ parameters: count: 1 path: lib/Db/MagicMapper.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 13 + path: lib/Db/MagicMapper.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 15 + path: lib/Db/MagicMapper.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 11 + path: lib/Db/MagicMapper.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 13 + path: lib/Db/MagicMapper.php + - message: "#^Property OCA\\\\OpenRegister\\\\Db\\\\MagicMapper\\\\MagicBulkHandler\\:\\:\\$eventDispatcher is never read, only written\\.$#" count: 1 @@ -3120,6 +3205,26 @@ parameters: count: 1 path: lib/Db/MagicMapper/MagicSearchHandler.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 4 + path: lib/Db/MagicMapper/MagicStatisticsHandler.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 4 + path: lib/Db/MagicMapper/MagicStatisticsHandler.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 4 + path: lib/Db/MagicMapper/MagicStatisticsHandler.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 4 + path: lib/Db/MagicMapper/MagicStatisticsHandler.php + - message: "#^Property OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:\\$id \\(int\\) in isset\\(\\) is not nullable\\.$#" count: 1 @@ -3141,10 +3246,15 @@ parameters: path: lib/Db/Mapping.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\MappingMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Mapping\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getOrganisation\\(\\)\\.$#" count: 1 path: lib/Db/MappingMapper.php + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setOrganisation\\(\\)\\.$#" + count: 2 + path: lib/Db/MappingMapper.php + - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\MappingMapper\\:\\:findAll\\(\\) should return array\\ but returns array\\\\.$#" count: 1 @@ -3195,11 +3305,6 @@ parameters: count: 1 path: lib/Db/ObjectHandlers/HyperFacetHandler.php - - - message: "#^Function React\\\\Async\\\\await not found\\.$#" - count: 1 - path: lib/Db/ObjectHandlers/HyperFacetHandler.php - - message: "#^PHPDoc tag @return with type React\\\\Promise\\\\PromiseInterface is not subtype of native type React\\\\Promise\\\\Promise\\.$#" count: 1 @@ -3240,11 +3345,6 @@ parameters: count: 1 path: lib/Db/Organisation.php - - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\OrganisationMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Organisation\\.$#" - count: 1 - path: lib/Db/OrganisationMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\OrganisationMapper\\:\\:findAll\\(\\) should return array\\ but returns array\\\\.$#" count: 1 @@ -3281,22 +3381,27 @@ parameters: path: lib/Db/Register.php - - message: "#^Caught class OCA\\\\OpenRegister\\\\Db\\\\Exception not found\\.$#" + message: "#^Property OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:\\$id \\(int\\) on left side of \\?\\? is not nullable\\.$#" count: 1 path: lib/Db/Register.php - - message: "#^Property OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:\\$id \\(int\\) on left side of \\?\\? is not nullable\\.$#" + message: "#^Unreachable statement \\- code above always terminates\\.$#" count: 1 path: lib/Db/Register.php - - message: "#^Unreachable statement \\- code above always terminates\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getOrganisation\\(\\)\\.$#" count: 1 - path: lib/Db/Register.php + path: lib/Db/RegisterMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Register\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setOrganisation\\(\\)\\.$#" + count: 2 + path: lib/Db/RegisterMapper.php + + - + message: "#^Call to an undefined method OCP\\\\DB\\\\IResult\\:\\:fetchAllAssociative\\(\\)\\.$#" count: 1 path: lib/Db/RegisterMapper.php @@ -3305,6 +3410,11 @@ parameters: count: 1 path: lib/Db/RegisterMapper.php + - + message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\) invoked with 5 parameters, 1 required\\.$#" + count: 1 + path: lib/Db/RegisterMapper.php + - message: "#^Parameter \\$entity of method OCP\\\\AppFramework\\\\Db\\\\QBMapper\\\\:\\:insert\\(\\) expects OCA\\\\OpenRegister\\\\Db\\\\Register, OCP\\\\AppFramework\\\\Db\\\\Entity given\\.$#" count: 1 @@ -3325,6 +3435,16 @@ parameters: count: 1 path: lib/Db/RegisterMapper.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 3 + path: lib/Db/RegisterMapper.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Db/RegisterMapper.php + - message: "#^Unknown parameter \\$published in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" count: 2 @@ -3346,13 +3466,18 @@ parameters: path: lib/Db/Schema.php - - message: "#^Expression on left side of \\?\\? is not nullable\\.$#" - count: 4 + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getOrganisation\\(\\)\\.$#" + count: 1 path: lib/Db/SchemaMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Schema\\.$#" - count: 1 + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setOrganisation\\(\\)\\.$#" + count: 2 + path: lib/Db/SchemaMapper.php + + - + message: "#^Expression on left side of \\?\\? is not nullable\\.$#" + count: 4 path: lib/Db/SchemaMapper.php - @@ -3400,6 +3525,16 @@ parameters: count: 1 path: lib/Db/SchemaMapper.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Db/SchemaMapper.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Db/SchemaMapper.php + - message: "#^Unknown parameter \\$published in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" count: 1 @@ -3445,11 +3580,6 @@ parameters: count: 1 path: lib/Db/SearchTrailMapper.php - - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\SearchTrailMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\SearchTrail\\.$#" - count: 1 - path: lib/Db/SearchTrailMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\SearchTrailMapper\\:\\:findAll\\(\\) should return array\\ but returns array\\\\.$#" count: 1 @@ -3466,10 +3596,15 @@ parameters: path: lib/Db/SelectionListMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\SourceMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Source\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getOrganisation\\(\\)\\.$#" count: 1 path: lib/Db/SourceMapper.php + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setOrganisation\\(\\)\\.$#" + count: 2 + path: lib/Db/SourceMapper.php + - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\SourceMapper\\:\\:findAll\\(\\) should return array\\ but returns array\\\\.$#" count: 1 @@ -3491,7 +3626,32 @@ parameters: path: lib/Db/SourceMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\ViewMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\View\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getOrganisation\\(\\)\\.$#" + count: 1 + path: lib/Db/ViewMapper.php + + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getUuid\\(\\)\\.$#" + count: 1 + path: lib/Db/ViewMapper.php + + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setCreated\\(\\)\\.$#" + count: 1 + path: lib/Db/ViewMapper.php + + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setOrganisation\\(\\)\\.$#" + count: 2 + path: lib/Db/ViewMapper.php + + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setUpdated\\(\\)\\.$#" + count: 2 + path: lib/Db/ViewMapper.php + + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setUuid\\(\\)\\.$#" count: 1 path: lib/Db/ViewMapper.php @@ -3515,11 +3675,6 @@ parameters: count: 1 path: lib/Db/ViewMapper.php - - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\WebhookLogMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\WebhookLog\\.$#" - count: 1 - path: lib/Db/WebhookLogMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\WebhookLogMapper\\:\\:findAll\\(\\) should return array\\ but returns array\\\\.$#" count: 1 @@ -3531,10 +3686,15 @@ parameters: path: lib/Db/WebhookLogMapper.php - - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\WebhookMapper\\:\\:findAll\\(\\) has invalid return type OCA\\\\OpenRegister\\\\Db\\\\OCA\\\\OpenRegister\\\\Db\\\\Webhook\\.$#" + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:getOrganisation\\(\\)\\.$#" count: 1 path: lib/Db/WebhookMapper.php + - + message: "#^Call to an undefined method OCP\\\\AppFramework\\\\Db\\\\Entity\\:\\:setOrganisation\\(\\)\\.$#" + count: 2 + path: lib/Db/WebhookMapper.php + - message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\WebhookMapper\\:\\:findAll\\(\\) should return array\\ but returns array\\\\.$#" count: 1 @@ -3595,23 +3755,88 @@ parameters: count: 1 path: lib/EventListener/AbstractNodesFolderEventListener.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Listener/CalculationOnSaveListener.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Listener/LifecycleInitialStateListener.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Listener/LifecycleValidationListener.php + + - + message: "#^Strict comparison using \\=\\=\\= between true and false will always evaluate to false\\.$#" + count: 1 + path: lib/Listener/MailAppScriptListener.php + + - + message: "#^Property OCA\\\\OpenRegister\\\\Listener\\\\NotifyPushListener\\:\\:\\$appManager is never read, only written\\.$#" + count: 1 + path: lib/Listener/NotifyPushListener.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Listener/NotifyPushListener.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Listener/NotifyPushListener.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Listener/NotifyPushListener.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Listener/NotifyPushListener.php + - message: "#^Strict comparison using \\=\\=\\= between int and null will always evaluate to false\\.$#" count: 1 path: lib/Listener/ObjectChangeListener.php - - message: "#^Constant OCA\\\\OpenRegister\\\\Middleware\\\\TenantQuotaMiddleware\\:\\:ENV_BANDWIDTH_MULTIPLIER is unused\\.$#" + message: "#^Offset 'description' on array\\{id\\: string, name\\: string, description\\: string, inputSchema\\: array\\} on left side of \\?\\? always exists and is not nullable\\.$#" count: 1 - path: lib/Middleware/TenantQuotaMiddleware.php + path: lib/Listener/ToolRegistrationListener.php - - message: "#^PHPDoc tag @throws with type OCP\\\\AppFramework\\\\Http\\\\TenantQuotaExceededException is not subtype of Throwable$#" + message: "#^Offset 'id' on array\\{id\\: string, name\\: string, description\\: string, inputSchema\\: array\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Listener/ToolRegistrationListener.php + + - + message: "#^Offset 'name' on array\\{id\\: string, name\\: string, description\\: string, inputSchema\\: array\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Listener/ToolRegistrationListener.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Mcp/BuiltIn/SchemasToolProvider.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Mcp/BuiltIn/SchemasToolProvider.php + + - + message: "#^Constant OCA\\\\OpenRegister\\\\Middleware\\\\TenantQuotaMiddleware\\:\\:ENV_BANDWIDTH_MULTIPLIER is unused\\.$#" count: 1 path: lib/Middleware/TenantQuotaMiddleware.php - - message: "#^Parameter \\#2 \\$statusCode of class OCP\\\\AppFramework\\\\Http\\\\JSONResponse constructor expects S of 100\\|101\\|102\\|200\\|201\\|202\\|203\\|204\\|205\\|206\\|207\\|208\\|226\\|300\\|301\\|302\\|303\\|304\\|305\\|306\\|307\\|400\\|401\\|402\\|403\\|404\\|405\\|406\\|407\\|408\\|409\\|410\\|411\\|412\\|413\\|414\\|415\\|416\\|417\\|418\\|422\\|423\\|424\\|426\\|428\\|429\\|431\\|500\\|501\\|502\\|503\\|504\\|505\\|506\\|507\\|508\\|509\\|510\\|511, int given\\.$#" + message: "#^PHPDoc tag @throws with type OCP\\\\AppFramework\\\\Http\\\\TenantQuotaExceededException is not subtype of Throwable$#" count: 1 path: lib/Middleware/TenantQuotaMiddleware.php @@ -3687,6 +3912,11 @@ parameters: - message: "#^Else branch is unreachable because ternary operator condition is always true\\.$#" + count: 2 + path: lib/Service/Aggregation/AggregationRunner.php + + - + message: "#^Strict comparison using \\=\\=\\= between int and null will always evaluate to false\\.$#" count: 1 path: lib/Service/Aggregation/AggregationRunner.php @@ -3740,11 +3970,51 @@ parameters: count: 1 path: lib/Service/Archival/LegalHoldService.php + - + message: "#^Instantiated class OC\\\\AppFramework\\\\Middleware\\\\Security\\\\Exceptions\\\\SecurityException not found\\.$#" + count: 1 + path: lib/Service/AuthorizationService.php + + - + message: "#^PHPDoc tag @throws with type OC\\\\AppFramework\\\\Middleware\\\\Security\\\\Exceptions\\\\SecurityException is not subtype of Throwable$#" + count: 1 + path: lib/Service/AuthorizationService.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/AvgComplianceService.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Service/AvgComplianceService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/AvgComplianceService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Service/AvgComplianceService.php + - message: "#^Strict comparison using \\=\\=\\= between int\\\\|int\\<1, max\\>\\|non\\-empty\\-string and '' will always evaluate to false\\.$#" count: 1 path: lib/Service/AvgRetentionService.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/BulkTranslationService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/BulkTranslationService.php + - message: "#^Method OCA\\\\OpenRegister\\\\Service\\\\Calculation\\\\CalculationAnnotationValidator\\:\\:findCycle\\(\\) never returns array\\ so it can be removed from the return type\\.$#" count: 1 @@ -3760,11 +4030,21 @@ parameters: count: 2 path: lib/Service/Calculation/CalculationAnnotationValidator.php + - + message: "#^Match arm is unreachable because previous comparison is always true\\.$#" + count: 1 + path: lib/Service/Calculation/CalculationEvaluator.php + - message: "#^Method OCA\\\\OpenRegister\\\\Service\\\\Calculation\\\\CalculationEvaluator\\:\\:modulo\\(\\) never returns int so it can be removed from the return type\\.$#" count: 1 path: lib/Service/Calculation/CalculationEvaluator.php + - + message: "#^Call to static method read\\(\\) on an unknown class Sabre\\\\VObject\\\\Reader\\.$#" + count: 3 + path: lib/Service/CalendarEventService.php + - message: "#^Parameter \\$calDavBackend of method OCA\\\\OpenRegister\\\\Service\\\\CalendarEventService\\:\\:__construct\\(\\) has invalid type OCA\\\\DAV\\\\CalDAV\\\\CalDavBackend\\.$#" count: 2 @@ -3825,6 +4105,11 @@ parameters: count: 1 path: lib/Service/ChatService.php + - + message: "#^Expression on left side of \\?\\? is not nullable\\.$#" + count: 1 + path: lib/Service/ChatService.php + - message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\ChatService\\:\\:\\$toolHandler is never read, only written\\.$#" count: 1 @@ -3990,6 +4275,36 @@ parameters: count: 1 path: lib/Service/Configuration/ImportHandler.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 6 + path: lib/Service/Configuration/ImportHandler.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/Configuration/ImportHandler.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 5 + path: lib/Service/Configuration/ImportHandler.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 4 + path: lib/Service/Configuration/ImportHandler.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/Configuration/ImportHandler.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Service/Configuration/ImportHandler.php + - message: "#^Unknown parameter \\$filters in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" count: 1 @@ -4145,6 +4460,11 @@ parameters: count: 1 path: lib/Service/ContactMatchingService.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/ContactMatchingService.php + - message: "#^Unreachable statement \\- code above always terminates\\.$#" count: 2 @@ -4155,6 +4475,11 @@ parameters: count: 2 path: lib/Service/ContactService.php + - + message: "#^Call to static method read\\(\\) on an unknown class Sabre\\\\VObject\\\\Reader\\.$#" + count: 4 + path: lib/Service/ContactService.php + - message: "#^Parameter \\$cardDavBackend of method OCA\\\\OpenRegister\\\\Service\\\\ContactService\\:\\:__construct\\(\\) has invalid type OCA\\\\DAV\\\\CardDAV\\\\CardDavBackend\\.$#" count: 2 @@ -4255,6 +4580,11 @@ parameters: count: 1 path: lib/Service/EmailService.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/EmailService.php + - message: "#^Call to an undefined method OCA\\\\OpenRegister\\\\Db\\\\Endpoint\\:\\:getMethod\\(\\)\\.$#" count: 1 @@ -4555,6 +4885,11 @@ parameters: count: 2 path: lib/Service/File/FolderManagementHandler.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 3 + path: lib/Service/File/FolderManagementHandler.php + - message: "#^Cannot call method getCategory\\(\\) on array\\\\.$#" count: 1 @@ -4650,6 +4985,31 @@ parameters: count: 1 path: lib/Service/FileSidebarService.php + - + message: "#^Method OCA\\\\OpenRegister\\\\Db\\\\AuditTrailMapper\\:\\:findAll\\(\\) invoked with 4 parameters, 0\\-2 required\\.$#" + count: 1 + path: lib/Service/GraphQL/GraphQLResolver.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/GraphQL/SchemaGenerator.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/GraphQL/SchemaGenerator.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/GraphQL/SchemaGenerator.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/GraphQL/SchemaGenerator.php + - message: "#^Parameter \\$errors of method OCA\\\\OpenRegister\\\\Event\\\\ObjectCreatingEvent\\:\\:setErrors\\(\\) expects array\\, array\\\\> given\\.$#" count: 1 @@ -4786,69 +5146,164 @@ parameters: path: lib/Service/Index/SetupHandler.php - - message: "#^Offset 'cluster_sync' on array\\{success\\: true, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + message: "#^Offset 'cluster_sync' on array\\{success\\: true, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Service/Index/SetupHandler.php + + - + message: "#^Offset 'host' on array\\{endpoint\\: mixed, collection\\: mixed, username\\: mixed, password\\: mixed, timeout\\: mixed\\} on left side of \\?\\? does not exist\\.$#" + count: 1 + path: lib/Service/Index/SetupHandler.php + + - + message: "#^Offset 'operations' on array\\{success\\: false, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 2 + path: lib/Service/Index/SetupHandler.php + + - + message: "#^Offset 'operations' on array\\{success\\: true, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 2 + path: lib/Service/Index/SetupHandler.php + + - + message: "#^Offset 'path' on array\\{endpoint\\: mixed, collection\\: mixed, username\\: mixed, password\\: mixed, timeout\\: mixed\\} on left side of \\?\\? does not exist\\.$#" + count: 1 + path: lib/Service/Index/SetupHandler.php + + - + message: "#^Offset 'port' on array\\{endpoint\\: mixed, collection\\: mixed, username\\: mixed, password\\: mixed, timeout\\: mixed\\} on left side of \\?\\? does not exist\\.$#" + count: 1 + path: lib/Service/Index/SetupHandler.php + + - + message: "#^Offset 'scheme' on array\\{endpoint\\: mixed, collection\\: mixed, username\\: mixed, password\\: mixed, timeout\\: mixed\\} on left side of \\?\\? does not exist\\.$#" + count: 1 + path: lib/Service/Index/SetupHandler.php + + - + message: "#^Offset 'successful…' on array\\{success\\: false, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Service/Index/SetupHandler.php + + - + message: "#^Offset 'successful…' on array\\{success\\: true, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Service/Index/SetupHandler.php + + - + message: "#^Offset 'total_operations' on array\\{success\\: false, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Service/Index/SetupHandler.php + + - + message: "#^Offset 'total_operations' on array\\{success\\: true, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Service/Index/SetupHandler.php + + - + message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\Index\\\\WarmupHandler\\:\\:\\$bulkIndexer is never read, only written\\.$#" + count: 1 + path: lib/Service/Index/WarmupHandler.php + + - + message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\Index\\\\WarmupHandler\\:\\:\\$db is never read, only written\\.$#" + count: 1 + path: lib/Service/Index/WarmupHandler.php + + - + message: "#^Unknown parameter \\$filters in call to method OCA\\\\OpenRegister\\\\Db\\\\AuditTrailMapper\\:\\:findAll\\(\\)\\.$#" + count: 2 + path: lib/Service/Integration/BuiltinProviders/AuditTrailProvider.php + + - + message: "#^Else branch is unreachable because ternary operator condition is always true\\.$#" + count: 1 + path: lib/Service/Integration/PropertyReferenceTypeValidator.php + + - + message: "#^Call to method setTags\\(\\) on an unknown class OCA\\\\Bookmarks\\\\QueryParameters\\.$#" + count: 1 + path: lib/Service/Integration/Providers/BookmarksProvider.php + + - + message: "#^Instantiated class OCA\\\\Bookmarks\\\\QueryParameters not found\\.$#" + count: 1 + path: lib/Service/Integration/Providers/BookmarksProvider.php + + - + message: "#^Offset 'results' on array\\{results\\: array, total\\: int\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Service/Integration/Providers/ContactsProvider.php + + - + message: "#^Offset 'results' on array\\{results\\: array, total\\: int\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Service/Integration/Providers/DeckProvider.php + + - + message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\Integration\\\\Providers\\\\DeckProvider\\:\\:\\$appManager is never read, only written\\.$#" count: 1 - path: lib/Service/Index/SetupHandler.php + path: lib/Service/Integration/Providers/DeckProvider.php - - message: "#^Offset 'host' on array\\{endpoint\\: mixed, collection\\: mixed, username\\: mixed, password\\: mixed, timeout\\: mixed\\} on left side of \\?\\? does not exist\\.$#" + message: "#^Offset 'results' on array\\{results\\: array, total\\: int\\} on left side of \\?\\? always exists and is not nullable\\.$#" count: 1 - path: lib/Service/Index/SetupHandler.php + path: lib/Service/Integration/Providers/EmailProvider.php - - message: "#^Offset 'operations' on array\\{success\\: false, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" - count: 2 - path: lib/Service/Index/SetupHandler.php + message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\Integration\\\\Providers\\\\EmailProvider\\:\\:\\$appManager is never read, only written\\.$#" + count: 1 + path: lib/Service/Integration/Providers/EmailProvider.php - - message: "#^Offset 'operations' on array\\{success\\: true, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" - count: 2 - path: lib/Service/Index/SetupHandler.php + message: "#^Call to function array_is_list\\(\\) with array\\ will always evaluate to false\\.$#" + count: 1 + path: lib/Service/Integration/Providers/OpenProjectProvider.php - - message: "#^Offset 'path' on array\\{endpoint\\: mixed, collection\\: mixed, username\\: mixed, password\\: mixed, timeout\\: mixed\\} on left side of \\?\\? does not exist\\.$#" + message: "#^Result of && is always false\\.$#" count: 1 - path: lib/Service/Index/SetupHandler.php + path: lib/Service/Integration/Providers/OpenProjectProvider.php - - message: "#^Offset 'port' on array\\{endpoint\\: mixed, collection\\: mixed, username\\: mixed, password\\: mixed, timeout\\: mixed\\} on left side of \\?\\? does not exist\\.$#" + message: "#^Strict comparison using \\=\\=\\= between false and true will always evaluate to false\\.$#" count: 1 - path: lib/Service/Index/SetupHandler.php + path: lib/Service/Integration/Providers/OpenProjectProvider.php - - message: "#^Offset 'scheme' on array\\{endpoint\\: mixed, collection\\: mixed, username\\: mixed, password\\: mixed, timeout\\: mixed\\} on left side of \\?\\? does not exist\\.$#" + message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\Integration\\\\Providers\\\\SharesProvider\\:\\:\\$appManager is never read, only written\\.$#" count: 1 - path: lib/Service/Index/SetupHandler.php + path: lib/Service/Integration/Providers/SharesProvider.php - - message: "#^Offset 'successful…' on array\\{success\\: false, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + message: "#^Call to function array_is_list\\(\\) with array\\ will always evaluate to false\\.$#" count: 1 - path: lib/Service/Index/SetupHandler.php + path: lib/Service/Integration/Providers/XwikiProvider.php - - message: "#^Offset 'successful…' on array\\{success\\: true, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + message: "#^Result of && is always false\\.$#" count: 1 - path: lib/Service/Index/SetupHandler.php + path: lib/Service/Integration/Providers/XwikiProvider.php - - message: "#^Offset 'total_operations' on array\\{success\\: false, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + message: "#^Strict comparison using \\=\\=\\= between false and true will always evaluate to false\\.$#" count: 1 - path: lib/Service/Index/SetupHandler.php + path: lib/Service/Integration/Providers/XwikiProvider.php - - message: "#^Offset 'total_operations' on array\\{success\\: true, operations\\: array\\{configset_list_refresh\\: array\\{name\\: 'configset_list…', description\\: 'List ConfigSets API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}, cluster_status_sync\\: array\\{name\\: 'cluster_status_sync', description\\: 'Cluster Status API…', url\\: string\\|null, status\\: 'failed'\\|'success', http_status\\: int\\|null, response_size\\: int\\<0, max\\>, error\\: string\\|null\\}\\}, successful_operations\\: 0\\|1\\|2, total_operations\\: 2, cluster_sync\\: 'failed'\\|'triggered', cache_refresh\\: 'failed'\\|'triggered', error\\: 'All propagation…'\\|null, summary\\: array\\{configset_list_refresh\\: 'failed'\\|'success', cluster_status_sync\\: 'failed'\\|'success'\\}\\} on left side of \\?\\? always exists and is not nullable\\.$#" + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" count: 1 - path: lib/Service/Index/SetupHandler.php + path: lib/Service/Lifecycle/TransitionEngine.php - - message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\Index\\\\WarmupHandler\\:\\:\\$bulkIndexer is never read, only written\\.$#" + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" count: 1 - path: lib/Service/Index/WarmupHandler.php + path: lib/Service/LinkedEntityService.php - - message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\Index\\\\WarmupHandler\\:\\:\\$db is never read, only written\\.$#" + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" count: 1 - path: lib/Service/Index/WarmupHandler.php + path: lib/Service/LinkedEntityService.php - message: "#^Unknown parameter \\$filters in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" @@ -4865,6 +5320,26 @@ parameters: count: 1 path: lib/Service/LogService.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Service/LogService.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Service/LogService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Service/LogService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Service/LogService.php + - message: "#^Unknown parameter \\$filters in call to method OCA\\\\OpenRegister\\\\Db\\\\AuditTrailMapper\\:\\:findAll\\(\\)\\.$#" count: 6 @@ -4880,6 +5355,11 @@ parameters: count: 3 path: lib/Service/LogService.php + - + message: "#^Strict comparison using \\=\\=\\= between true and false will always evaluate to false\\.$#" + count: 1 + path: lib/Service/ManifestService.php + - message: "#^Method OCA\\\\OpenRegister\\\\Service\\\\MappingService\\:\\:getMappings\\(\\) should return array\\ but returns array\\\\.$#" count: 1 @@ -4905,6 +5385,11 @@ parameters: count: 1 path: lib/Service/MappingService.php + - + message: "#^Offset 'id' on array\\{id\\: string, name\\: string, description\\: string, inputSchema\\: array\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 2 + path: lib/Service/Mcp/McpToolsService.php + - message: "#^Unreachable statement \\- code above always terminates\\.$#" count: 1 @@ -4915,6 +5400,26 @@ parameters: count: 1 path: lib/Service/MigrationService.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/MigrationService.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/MigrationService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/MigrationService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/MigrationService.php + - message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\NoteService\\:\\:\\$logger is never read, only written\\.$#" count: 1 @@ -4930,6 +5435,11 @@ parameters: count: 2 path: lib/Service/Notification/AnnotationNotificationDispatcher.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/Notification/AnnotationNotificationDispatcher.php + - message: "#^Class OCA\\\\OpenRegister\\\\Service\\\\NotificationService has an uninitialized readonly property \\$groupManager\\. Assign it in the constructor\\.$#" count: 1 @@ -4975,6 +5485,26 @@ parameters: count: 1 path: lib/Service/OasService.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/OasService.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/OasService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/OasService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/OasService.php + - message: "#^Variable \\$registers on left side of \\?\\? always exists and is not nullable\\.$#" count: 2 @@ -5070,6 +5600,26 @@ parameters: count: 2 path: lib/Service/Object/FacetHandler.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/FacetHandler.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/FacetHandler.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/FacetHandler.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/FacetHandler.php + - message: "#^Unknown parameter \\$filters in call to method OCA\\\\OpenRegister\\\\Db\\\\AuditTrailMapper\\:\\:findAll\\(\\)\\.$#" count: 1 @@ -5110,6 +5660,16 @@ parameters: count: 1 path: lib/Service/Object/PerformanceHandler.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/PermissionHandler.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/PermissionHandler.php + - message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\Object\\\\QueryHandler\\:\\:\\$getHandler is never read, only written\\.$#" count: 1 @@ -5125,6 +5685,26 @@ parameters: count: 1 path: lib/Service/Object/QueryHandler.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/ReferentialIntegrityService.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/ReferentialIntegrityService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/ReferentialIntegrityService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/ReferentialIntegrityService.php + - message: "#^Anonymous function has an unused use \\$key\\.$#" count: 1 @@ -5150,6 +5730,16 @@ parameters: count: 2 path: lib/Service/Object/RelationHandler.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 3 + path: lib/Service/Object/RelationHandler.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 3 + path: lib/Service/Object/RelationHandler.php + - message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\Object\\\\RelationshipOptimizationHandler\\:\\:\\$logger is never read, only written\\.$#" count: 1 @@ -5200,6 +5790,21 @@ parameters: count: 1 path: lib/Service/Object/RenderObject.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/RenderObject.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 2 + path: lib/Service/Object/RenderObject.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 2 + path: lib/Service/Object/RenderObject.php + - message: "#^Unknown parameter \\$filters in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" count: 1 @@ -5245,6 +5850,26 @@ parameters: count: 4 path: lib/Service/Object/SaveObject.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Service/Object/SaveObject.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 3 + path: lib/Service/Object/SaveObject.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/SaveObject.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 2 + path: lib/Service/Object/SaveObject.php + - message: "#^Unknown parameter \\$published in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" count: 1 @@ -5445,6 +6070,16 @@ parameters: count: 1 path: lib/Service/Object/ValidationHandler.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method stdClass\\:\\:saveObjects\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/ValidationHandler.php + + - + message: "#^Unknown parameter \\$_rbac in call to method stdClass\\:\\:saveObjects\\(\\)\\.$#" + count: 1 + path: lib/Service/Object/ValidationHandler.php + - message: "#^Unknown parameter \\$deduplicateIds in call to method stdClass\\:\\:saveObjects\\(\\)\\.$#" count: 1 @@ -5485,11 +6120,6 @@ parameters: count: 1 path: lib/Service/ObjectService.php - - - message: "#^Function React\\\\Async\\\\await not found\\.$#" - count: 1 - path: lib/Service/ObjectService.php - - message: "#^PHPDoc tag @throws with type OCP\\\\AppFramework\\\\Http\\\\ContentSecurityPolicy is not subtype of Throwable$#" count: 1 @@ -5565,6 +6195,26 @@ parameters: count: 1 path: lib/Service/ObjectService.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 4 + path: lib/Service/ObjectService.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 4 + path: lib/Service/ObjectService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 4 + path: lib/Service/ObjectService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 4 + path: lib/Service/ObjectService.php + - message: "#^Unknown parameter \\$published in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" count: 3 @@ -5600,6 +6250,16 @@ parameters: count: 1 path: lib/Service/RegisterService.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/RegisterService.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Service/RegisterService.php + - message: "#^Unknown parameter \\$filters in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" count: 1 @@ -5850,6 +6510,11 @@ parameters: count: 2 path: lib/Service/SettingsService.php + - + message: "#^Call to static method read\\(\\) on an unknown class Sabre\\\\VObject\\\\Reader\\.$#" + count: 2 + path: lib/Service/TaskService.php + - message: "#^Parameter \\$calDavBackend of method OCA\\\\OpenRegister\\\\Service\\\\TaskService\\:\\:__construct\\(\\) has invalid type OCA\\\\DAV\\\\CalDAV\\\\CalDavBackend\\.$#" count: 2 @@ -5920,6 +6585,16 @@ parameters: count: 1 path: lib/Service/TextExtractionService.php + - + message: "#^PHPDoc tag @param for parameter \\$emlParser with type OCA\\\\OpenRegister\\\\Service\\\\EmlParser is not subtype of native type OCA\\\\OpenRegister\\\\Service\\\\TextExtraction\\\\EmlParser\\.$#" + count: 1 + path: lib/Service/TextExtractionService.php + + - + message: "#^PHPDoc type for property OCA\\\\OpenRegister\\\\Service\\\\TextExtractionService\\:\\:\\$emlParser with type OCA\\\\OpenRegister\\\\Service\\\\EmlParser is not subtype of native type OCA\\\\OpenRegister\\\\Service\\\\TextExtraction\\\\EmlParser\\.$#" + count: 1 + path: lib/Service/TextExtractionService.php + - message: "#^Property OCA\\\\OpenRegister\\\\Service\\\\TextExtractionService\\:\\:\\$entityMapper is never read, only written\\.$#" count: 1 @@ -5955,6 +6630,16 @@ parameters: count: 1 path: lib/Service/TranslationProjectionService.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/TranslationProjectionService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/TranslationProjectionService.php + - message: "#^Class OCA\\\\OpenRegister\\\\Service\\\\UploadService has an uninitialized readonly property \\$client\\. Assign it in the constructor\\.$#" count: 1 @@ -5980,6 +6665,26 @@ parameters: count: 1 path: lib/Service/UrnService.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/UrnService.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/UrnService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/UrnService.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Service/UrnService.php + - message: "#^Method OCA\\\\OpenRegister\\\\Service\\\\UserService\\:\\:getDefaultPropertyScope\\(\\) is unused\\.$#" count: 1 @@ -6041,7 +6746,12 @@ parameters: path: lib/Service/ViewService.php - - message: "#^Method OCA\\\\OpenRegister\\\\Settings\\\\OpenRegisterAdmin\\:\\:getForm\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\TemplateResponse\\<200, array\\> but returns OCP\\\\AppFramework\\\\Http\\\\TemplateResponse\\<200, array\\{\\}\\>\\.$#" + message: "#^Property OCA\\\\OpenRegister\\\\Settings\\\\IntegrationsAdminSettings\\:\\:\\$l10n is never read, only written\\.$#" + count: 1 + path: lib/Settings/IntegrationsAdminSettings.php + + - + message: "#^Method OCA\\\\OpenRegister\\\\Settings\\\\OpenRegisterAdmin\\:\\:getForm\\(\\) should return OCP\\\\AppFramework\\\\Http\\\\TemplateResponse\\<200, array\\\\> but returns OCP\\\\AppFramework\\\\Http\\\\TemplateResponse\\<200, array\\{\\}\\>\\.$#" count: 1 path: lib/Settings/OpenRegisterAdmin.php @@ -6050,6 +6760,31 @@ parameters: count: 1 path: lib/Settings/OpenRegisterAdmin.php + - + message: "#^Offset 'description' on array\\{id\\: string, name\\: string, description\\: string, inputSchema\\: array\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Tool/McpProviderBridge.php + + - + message: "#^Offset 'id' on array\\{id\\: string, name\\: string, description\\: string, inputSchema\\: array\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 2 + path: lib/Tool/McpProviderBridge.php + + - + message: "#^Offset 'inputSchema' on array\\{id\\: string, name\\: string, description\\: string, inputSchema\\: array\\} on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Tool/McpProviderBridge.php + + - + message: "#^Offset 'name' on \\*NEVER\\* on left side of \\?\\? always exists and is not nullable\\.$#" + count: 1 + path: lib/Tool/McpProviderBridge.php + + - + message: "#^Property OCA\\\\OpenRegister\\\\Tool\\\\McpProviderBridge\\:\\:\\$agent is never read, only written\\.$#" + count: 1 + path: lib/Tool/McpProviderBridge.php + - message: "#^Unknown parameter \\$filters in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" count: 1 diff --git a/phpstan-bootstrap.php b/phpstan-bootstrap.php new file mode 100644 index 000000000000..b473c89c3589 --- /dev/null +++ b/phpstan-bootstrap.php @@ -0,0 +1,9 @@ +addPsr4('OCP\\', __DIR__ . '/vendor/nextcloud/ocp/OCP/'); +$autoloader->addPsr4('NCU\\', __DIR__ . '/vendor/nextcloud/ocp/NCU/'); diff --git a/phpstan.neon b/phpstan.neon index d43565faee3d..bca069a23deb 100644 --- a/phpstan.neon +++ b/phpstan.neon @@ -1,4 +1,7 @@ includes: + # Per-app tracked lint debt lives here (auto-generated via `phpstan --generate-baseline`). + # Apps without debt ship an empty baseline file; canonical includes are otherwise byte-identical + # across the fleet. - phpstan-baseline.neon parameters: @@ -6,47 +9,51 @@ parameters: paths: - lib bootstrapFiles: - - vendor/autoload.php + - phpstan-bootstrap.php + excludePaths: + - vendor + - vendor-bin + # Apps that ship a verbatim template snapshot under lib/Resources/template/ (e.g. openbuilt). + - lib/Resources/template scanDirectories: - vendor/nextcloud/ocp reportUnmatchedIgnoredErrors: false ignoreErrors: - # Nextcloud internals not covered by OCP stubs. + # Nextcloud server internals (\OC, OC_App, OC\) not stubbed in nextcloud/ocp - '#Call to an undefined method OC::#' - '#Class OC not found#' - '#Access to static property \$server on an unknown class OC#' - '#unknown class OC\\#' - - '#unknown class OCA\\DAV\\#' - - '#unknown class OC_App#' - - '#not found in catched class OC\\#' - '#Caught class OC\\#' + - '#unknown class OC_App#' + - '#Class OC_App not found#' + # OCA\DAV is server-internal and not in nextcloud/ocp stubs + - '#unknown class OCA\\DAV\\#' - '#Class OCA\\DAV\\#' - - '#Throwing object of an unknown class OC\\#' - - '#Instantiated class OC\\AppFramework\\Middleware\\Security\\Exceptions\\SecurityException not found#' - - '#PHPDoc tag @throws with type OC\\AppFramework\\Middleware\\Security\\Exceptions\\SecurityException#' - - '#unknown class OC\\AppFramework\\Middleware\\Security\\Exceptions\\SecurityException#' - - # Doctrine\DBAL classes (used in migrations/mappers; not in vendor stubs). + # OCA classes from other apps (OpenRegister) not available during static analysis + - '#unknown class OCA\\OpenRegister\\#' + - '#OCA\\OpenRegister\\[a-zA-Z\\]+.*not found#' + - '#on an unknown class OCA\\OpenRegister\\#' + - '#has invalid return type OCA\\OpenRegister\\#' + - '#has invalid type OCA\\OpenRegister\\#' + - '#implements unknown interface OCA\\OpenRegister\\#' + # GuzzleHttp is available at runtime via Nextcloud but not in composer require + - '#unknown class GuzzleHttp\\#' + - '#GuzzleHttp\\[a-zA-Z\\]+.*not found#' + - '#on an unknown class GuzzleHttp\\#' + - '#invalid type GuzzleHttp\\#' + - '#Caught class GuzzleHttp\\#' + # Doctrine\DBAL is shipped by Nextcloud server but not stubbed in nextcloud/ocp - '#unknown class Doctrine\\DBAL\\#' - - '#class Doctrine\\DBAL\\#' - - '#Class Doctrine\\DBAL\\#' - - '#Doctrine\\DBAL\\Platforms\\#' - - # Cron\CronExpression (mtdowling/cron-expression — not in stubs). - - '#class Cron\\CronExpression#' - - '#Cron\\CronExpression#' - - # Sabre\VObject (sabre/vobject — not in scan stubs). - - '#Sabre\\VObject\\#' - - # Multi-tenancy and RBAC stub parameters added at runtime by the QBMapper layer. - - '#Unknown parameter \$_multitenancy in call#' - - '#Unknown parameter \$_rbac in call#' - - '#Method OCA\\OpenRegister\\Db\\.+::find\(\) invoked with \d+ parameters#' - - '#Method OCA\\OpenRegister\\Db\\.+::findAll\(\) invoked with \d+ parameters#' - - # Entity __call magic methods (setOrganisation/getOrganisation/etc.) — set - # at runtime by Nextcloud Entity, but the parent Entity class does not - # declare them. Per-property @method docblocks would be ideal but - # categorically suppressing here is honest about the framework pattern. - - '#Call to an undefined method OCP\\AppFramework\\Db\\Entity::#' + - '#Doctrine\\DBAL\\[a-zA-Z\\]+.*not found#' + - '#on an unknown class Doctrine\\DBAL\\#' + # Dynamic HTTP status codes from business rule validation results + # (matches both `Parameter $statusCode` and `Parameter #N $statusCode` forms emitted by phpstan) + - '#Parameter (\#\d+ )?\$statusCode of class OCP\\AppFramework\\Http\\JSONResponse constructor expects#' + # registerRepairStep exists on server; not yet in nextcloud/ocp stub used for analysis + - '#Call to an undefined method OCP\\AppFramework\\Bootstrap\\IRegistrationContext::registerRepairStep#' + # OCP stub gaps for methods that exist at runtime + - '#Call to an undefined method OCP\\IRequest::getContent\(\)#' + - '#Call to an undefined method OCP\\IRequest::setParameter\(\)#' + - '#Call to an undefined method OCP\\Mail\\IMessage::attachFile\(\)#' + - '#Call to an undefined method OCP\\AppFramework\\Db\\Entity::jsonSerialize#' diff --git a/psalm.xml b/psalm.xml index d04f2dc9fa2e..76b976ff1bd7 100644 --- a/psalm.xml +++ b/psalm.xml @@ -1,5 +1,6 @@ @@ -22,24 +22,6 @@ - - - - - - - - - - - - - - - - - - @@ -58,7 +40,6 @@ - @@ -77,20 +58,39 @@ - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - @@ -103,80 +103,24 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + From 56277fa77efa42ad5543e5c0ffb8d531b5e8c806 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Fri, 22 May 2026 07:07:24 +0200 Subject: [PATCH 023/333] fix(import): eager magic-table creation for every schema (closes #1615) (#1616) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `ImportHandler::importFromApp` previously called `MagicMapper::ensureTableForRegisterSchema` only from inside the seed-objects loop (line 3187, formerly 3174). Schemas with an empty seed-objects array therefore never got their per-schema magic table provisioned during register import. The fallback was lazy: the first write against the schema would trigger `ensureTableForRegisterSchema` inside `MagicMapper::saveObject`. For entity-style schemas (source, job, mapping, …) users write to them directly so the table appears on first use. For **log-style schemas** (call_log, job_log, synchronization_log, synchronization_contract_log in ConductionNL/openconnector — and similar in other apps) writes only happen from internal services. If anything earlier in the chain swallowed an error (controller validation, find lookup, etc.), the service never reached saveObject and the table stayed missing forever. In practice: openconnector dashboards rendered empty even after thousands of Newman + Playwright invocations because every `POST /sources/test/{id}` 404'd at the controller (separate bug, ConductionNL/openconnector#840), AND if it ever reached CallService the saveObject would have thrown `relation oc_openregister_table_65_223 does not exist`. ## Fix Provision the magic table for **every** Schema bound to the Register inside `autoCreateRegisterIfApplication()`, right after the Register is created / reconciled and its Configuration is synced. The loop iterates the schemas already in scope, is idempotent (the underlying helper short-circuits when the table already exists per MagicTableHandler line 109-112), and non-fatal (any per-schema failure logs a warning instead of aborting the whole import). The original seed-objects-loop pre-create at line 3225 stays in place as a defensive no-op for back-compat. ## Verified end-to-end on a chain-E openconnector instance occ maintenance:repair --include-expensive → OpenConnector Repair step fires importFromApp → autoCreateRegisterIfApplication runs the new loop → All 15 openconnector schemas now have magic tables: source / job / mapping / synchronization (entity) call_log / job_log / synchronization_log / synchronization_contract_log (log — previously missing) … plus 7 others. CallService->call() then succeeds and writes to call_log. --- lib/Service/Configuration/ImportHandler.php | 41 +++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/lib/Service/Configuration/ImportHandler.php b/lib/Service/Configuration/ImportHandler.php index 23e0d11ff684..2dcdf2b0b51a 100644 --- a/lib/Service/Configuration/ImportHandler.php +++ b/lib/Service/Configuration/ImportHandler.php @@ -2746,6 +2746,47 @@ private function autoCreateRegisterIfApplication( $configuration->setRegisters($configRegisterIds); $this->configurationMapper->update($configuration); } + + // EAGER MAGIC-TABLE CREATION (fixes #1615): provision the per-schema + // magic table for EVERY imported schema, not just those that ship + // seed data. Without this, log-style schemas (call_log, job_log, + // synchronization_log, …) — which typically have no seed data — + // never get their `oc_openregister_table_{registerId}_{schemaId}` + // table created on `occ app:enable`, and the first runtime write + // from a service like CallService throws "relation does not exist". + // + // Idempotent on re-import: ensureTableForRegisterSchema short- + // circuits when the table already exists (see MagicTableHandler + // line 109-112). The seed-objects loop further down still calls + // the same method as a defensive no-op. + if ($this->magicMapper !== null && $register !== null) { + foreach ($schemas as $schema) { + if ($schema instanceof Schema === false) { + continue; + } + + try { + $this->magicMapper->ensureTableForRegisterSchema( + register: $register, + schema: $schema + ); + } catch (\Exception $e) { + // Non-fatal: surfaced via logger so the rest of the + // import (other schemas, seed data) still completes. + $this->logger->warning( + message: '[ImportHandler] Failed to pre-create magic mapper table for schema during register auto-create', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'schema_id' => $schema->getId(), + 'schema_slug' => $schema->getSlug(), + 'register_id' => $register->getId(), + 'error' => $e->getMessage(), + ] + ); + } + } + } }//end autoCreateRegisterIfApplication() /** From ff6f22ef5181f4c0f309d1bdba53370279af5f1c Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Fri, 22 May 2026 09:14:06 +0200 Subject: [PATCH 024/333] chore(deps): bump PHP requirement to ^8.3 (#1644) Brings the composer require.php constraint in line with the runtime the container + CI already use (PHP 8.3). Drops formal support for PHP 8.1 and 8.2. Several vendor packages (e.g. azjezz/psl@4.3.0) use PHP 8.3 typed class constants, making the codebase functionally 8.3-only already. Part of the fleet-wide PHP 8.3 sweep. --- composer.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/composer.json b/composer.json index 1d5f0490474d..86841aad6542 100644 --- a/composer.json +++ b/composer.json @@ -88,7 +88,7 @@ ] }, "require": { - "php": "^8.1", + "php": "^8.3", "adbario/php-dot-notation": "^3.3.0", "bamarni/composer-bin-plugin": "^1.8", "cweagans/composer-patches": "^1.7", From 56b8640449c7a7cb3e927595786f591bb72ba09a Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Fri, 22 May 2026 09:14:23 +0200 Subject: [PATCH 025/333] feat(api): scoped deleteObject($uuid, $register, $schema) (closes #1638) (#1643) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ObjectService::delete(['id' => $uuid]) is unscoped — it routes through DeleteObject::deleteObject() which calls findAcrossAllSources($uuid) and returns the first matching row across any magic table. Post chain-B/C every Conduction app uses per-(register,schema) magic tables, so a UUID collision across tables can silently delete a foreign-scope object (the exact bug discovered while porting openconnector#733 → #843). Changes: - ObjectService::deleteObject() gains optional `$register` + `$schema` parameters between `$uuid` and `$_rbac`. When BOTH are supplied the lookup is scoped to exactly one magic table via MagicMapper::find(); a UUID in a different scope raises DoesNotExistException without touching any row. - DeleteObject::deleteObject() gains a `bool $scoped=false` flag and a private resolveDeletionContext() helper that picks the scoped find() vs legacy findAcrossAllSources() path. - ObjectServiceMapperAdapter::delete() now forwards its bound (register, schema) — previously dropped it on the floor, making the array form silently unscoped even when the adapter was bound to a scope. - The unscoped form (single-arg) stays for back-compat with a soft @deprecated notice pointing callers at the scoped signature. Tests (8 new, 15 assertions, all green): - DeleteObjectScopedTest covers cross-scope refusal, in-scope success, cross-magic-table UUID collision, and legacy unscoped pass-through. - ObjectServiceMapperAdapterTest covers scope-forwarding, null-scope forwarding, DoesNotExistException propagation, and missing-id rejection. - All 29 existing DeleteObjectTest cases still pass — back-compat with every current `delete($idArray)` caller is verified. Quality gates: PHPCS / PHPMD / PHPStan / Psalm baseline-clean (0 new errors); pre-existing InvalidThrow on ContentSecurityPolicy unchanged. This lands the API surface ConductionNL/hydra#309 needs to start its fleet-wide audit of unscoped delete call sites. OpenSpec change: scoped-object-delete-api --- lib/Service/Object/DeleteObject.php | 115 +++- lib/Service/ObjectService.php | 87 ++- lib/Service/ObjectServiceMapperAdapter.php | 16 +- .../scoped-object-delete-api/.openspec.yaml | 2 + .../scoped-object-delete-api/design.md | 106 ++++ .../scoped-object-delete-api/proposal.md | 33 ++ .../specs/object-lifecycle/spec.md | 47 ++ .../changes/scoped-object-delete-api/tasks.md | 45 ++ .../Service/Object/DeleteObjectScopedTest.php | 512 ++++++++++++++++++ .../ObjectServiceMapperAdapterTest.php | 165 ++++++ tests/bootstrap-unit-local.php | 105 ++++ 11 files changed, 1205 insertions(+), 28 deletions(-) create mode 100644 openspec/changes/scoped-object-delete-api/.openspec.yaml create mode 100644 openspec/changes/scoped-object-delete-api/design.md create mode 100644 openspec/changes/scoped-object-delete-api/proposal.md create mode 100644 openspec/changes/scoped-object-delete-api/specs/object-lifecycle/spec.md create mode 100644 openspec/changes/scoped-object-delete-api/tasks.md create mode 100644 tests/Unit/Service/Object/DeleteObjectScopedTest.php create mode 100644 tests/Unit/Service/ObjectServiceMapperAdapterTest.php create mode 100644 tests/bootstrap-unit-local.php diff --git a/lib/Service/Object/DeleteObject.php b/lib/Service/Object/DeleteObject.php index 61dbdfe193a3..bf4a0ebdb025 100644 --- a/lib/Service/Object/DeleteObject.php +++ b/lib/Service/Object/DeleteObject.php @@ -359,22 +359,32 @@ public function canDelete(ObjectEntity $object): DeletionAnalysis * has incoming onDelete references from other schemas, walks the dependency graph * to detect blockers (RESTRICT) and apply actions (CASCADE, SET_NULL, SET_DEFAULT). * - * @param Register|int|string $register The register containing the object. - * @param Schema|int|string $schema The schema of the object. - * @param string $uuid The UUID of the object to delete. - * @param string|null $originalObjectId The ID of original object for cascading. - * @param bool $_rbac Whether to apply RBAC checks (default: true). - * @param bool $_multitenancy Whether to apply multitenancy filtering (default: true). + * @param Register|int|string|null $register The register containing the object. + * @param Schema|int|string|null $schema The schema of the object. + * @param string $uuid The UUID of the object to delete. + * @param string|null $originalObjectId The ID of original object for cascading. + * @param bool $_rbac Whether to apply RBAC checks (default: true). + * @param bool $_multitenancy Whether to apply multitenancy filtering (default: true). + * @param bool $scoped When true, the caller has guaranteed `$register` + * and `$schema` resolve to a specific magic table + * and the lookup MUST target only that table — + * a UUID in another scope raises DoesNotExistException + * without touching any row (#1638). + * When false (default), legacy cross-table lookup + * via `findAcrossAllSources` is used. * * @return bool Whether the deletion was successful. * - * @throws ReferentialIntegrityException If deletion is blocked by RESTRICT constraints. - * @throws Exception If there is an error during deletion. + * @throws ReferentialIntegrityException If deletion is blocked by RESTRICT constraints. + * @throws \OCP\AppFramework\Db\DoesNotExistException If `$scoped` is true and the UUID is not present + * in the given (register, schema) magic table. + * @throws Exception If there is an error during deletion. * * @SuppressWarnings(PHPMD.BooleanArgumentFlag) * @SuppressWarnings(PHPMD.CyclomaticComplexity) * * @spec openspec/changes/retrofit-2026-04-28-object-lifecycle/tasks.md#task-1 + * @spec openspec/changes/scoped-object-delete-api/tasks.md#2 */ public function deleteObject( Register | int | string | null $register, @@ -382,21 +392,29 @@ public function deleteObject( string $uuid, ?string $originalObjectId=null, bool $_rbac=true, - bool $_multitenancy=true + bool $_multitenancy=true, + bool $scoped=false ): bool { // Reset cascade count for root deletions. if ($originalObjectId === null) { $this->lastCascadeCount = 0; } - // Find object with context (searches across all magic tables). - $context = $this->objectEntityMapper->findAcrossAllSources( - identifier: $uuid, - includeDeleted: true, + // Resolve the lookup: when the caller has guaranteed a (register, schema) + // scope, use the scoped `MagicMapper::find()` path which targets exactly + // one magic table. Otherwise fall back to the legacy cross-table scan. + // The scoped path raises DoesNotExistException if the UUID is not in + // the requested scope — this is the fix for #1638. + $context = $this->resolveDeletionContext( + register: $register, + schema: $schema, + uuid: $uuid, + scoped: $scoped, _rbac: $_rbac, _multitenancy: $_multitenancy ); - $object = $context['object']; + + $object = $context['object']; // Root deletions: check referential integrity and handle cascade. if ($originalObjectId === null) { @@ -427,6 +445,75 @@ public function deleteObject( }//end deleteObject() + /** + * Resolve the lookup context for a deletion call. + * + * Centralises the branch between the scoped MagicMapper::find() path + * (introduced for #1638) and the legacy `findAcrossAllSources` cross-table + * scan. The early return on the scoped path keeps the dispatch flat and + * avoids an else-clause (PHPMD ElseExpression). + * + * @param Register|int|string|null $register Register scope (object, ID, UUID, or slug). + * @param Schema|int|string|null $schema Schema scope. + * @param string $uuid The UUID being deleted. + * @param bool $scoped When true, the caller has guaranteed + * $register/$schema resolve to a specific + * magic table; lookup MUST target only that table. + * @param bool $_rbac Whether to apply RBAC checks. + * @param bool $_multitenancy Whether to apply multitenancy filtering. + * + * @return array{object: ObjectEntity, register: Register|int|string, schema: Schema|int|string} + * + * @throws \OCP\AppFramework\Db\DoesNotExistException If $scoped is true and the UUID is + * not present in the given magic table. + * + * @SuppressWarnings(PHPMD.BooleanArgumentFlag) + * + * @spec openspec/changes/scoped-object-delete-api/tasks.md#2 + */ + private function resolveDeletionContext( + Register | int | string | null $register, + Schema | int | string | null $schema, + string $uuid, + bool $scoped, + bool $_rbac, + bool $_multitenancy + ): array { + // Scoped path: lookup hits exactly one magic table — a UUID in a + // different scope raises DoesNotExistException. This is the fix for + // #1638 (cross-scope silent deletes). + if ($scoped === true + && $register instanceof Register === true + && $schema instanceof Schema === true + ) { + $scopedObject = $this->objectEntityMapper->find( + identifier: $uuid, + register: $register, + schema: $schema, + includeDeleted: true, + _rbac: $_rbac, + _multitenancy: $_multitenancy + ); + + return [ + 'object' => $scopedObject, + 'register' => $register, + 'schema' => $schema, + ]; + } + + // Legacy path: cross-table scan via findAcrossAllSources — still in + // use by every unscoped caller. Soft-deprecated; preferred call site + // is the scoped branch above. + return $this->objectEntityMapper->findAcrossAllSources( + identifier: $uuid, + includeDeleted: true, + _rbac: $_rbac, + _multitenancy: $_multitenancy + ); + + }//end resolveDeletionContext() + /** * Handle referential integrity checks and cascade deletion for root deletions. * diff --git a/lib/Service/ObjectService.php b/lib/Service/ObjectService.php index 658022d81cd1..03c0a4470cf6 100644 --- a/lib/Service/ObjectService.php +++ b/lib/Service/ObjectService.php @@ -1490,20 +1490,63 @@ private function ensureObjectFolder(?string $uuid): ?int }//end ensureObjectFolder() /** - * Delete an object. - * - * @param string $uuid The UUID of the object to delete - * @param bool $_rbac Whether to apply RBAC checks (default: true). - * @param bool $_multitenancy Whether to apply multitenancy filtering (default: true). + * Delete an object, optionally scoped to a (register, schema) magic table. + * + * When BOTH `$register` and `$schema` are supplied, the deletion is scoped to + * exactly one magic table (`oc_openregister_table_{registerId}_{schemaId}`): + * the lookup uses `MagicMapper::find($identifier, $register, $schema, includeDeleted: true)` + * which targets a single table and throws `DoesNotExistException` if the + * UUID is not present in that scope. A UUID that lives in a DIFFERENT + * `(register, schema)` magic table MUST NOT be touched. See #1638. + * + * When EITHER `$register` or `$schema` is null, the legacy unscoped + * cross-table lookup (`findAcrossAllSources`) is used — preserves backward + * compatibility for the dozens of callers passing only `$uuid`. The + * unscoped form is soft-deprecated: prefer the scoped signature for new + * call sites so the storage layer can refuse cross-scope deletes by + * construction. + * + * @param string $uuid The UUID of the object to delete. + * @param Register|string|int|null $register Optional register scope (object, ID, UUID, or slug). + * When non-null AND `$schema` is non-null, the lookup + * targets exactly that magic table. + * @param Schema|string|int|null $schema Optional schema scope (object, ID, UUID, or slug). + * See `$register` — both must be supplied for the + * scoped path. + * @param bool $_rbac Whether to apply RBAC checks (default: true). + * @param bool $_multitenancy Whether to apply multitenancy filtering (default: true). * * @return bool Whether the deletion was successful * - * @throws \Exception If user does not have delete permission + * @throws \OCP\AppFramework\Db\DoesNotExistException If `$register` and `$schema` are both supplied + * and the UUID is not present in that scope (even + * if it exists in another magic table). + * @throws \Exception If user does not have delete permission. * * @SuppressWarnings(PHPMD.UnusedFormalParameter) + * @SuppressWarnings(PHPMD.CyclomaticComplexity) + * @SuppressWarnings(PHPMD.NPathComplexity) */ - public function deleteObject(string $uuid, bool $_rbac=true, bool $_multitenancy=true): bool - { + public function deleteObject( + string $uuid, + Register | string | int | null $register=null, + Schema | string | int | null $schema=null, + bool $_rbac=true, + bool $_multitenancy=true + ): bool { + // Resolve the explicit scope (if any) onto the service's currentRegister + // / currentSchema so downstream context (permission checks, audit-trail + // recording) sees the API-supplied scope, not a stale leftover from a + // previous call on this service instance. + $hasScope = ($register !== null && $schema !== null); + if ($register !== null) { + $this->setRegister(register: $register); + } + + if ($schema !== null) { + $this->setSchema(schema: $schema); + } + // Reject deletion of transferred objects (archiefstatus = overgebracht). $this->rejectIfTransferred(uuid: $uuid); @@ -1517,11 +1560,21 @@ public function deleteObject(string $uuid, bool $_rbac=true, bool $_multitenancy } // Find the object to get its owner for permission check (include soft-deleted objects). + // When the caller supplied both register + schema, the lookup is scoped + // to a single magic table — a UUID in a different scope raises + // DoesNotExistException and never reaches the delete handler. + $scopedRegister = null; + $scopedSchema = null; + if ($hasScope === true) { + $scopedRegister = $this->currentRegister; + $scopedSchema = $this->currentSchema; + } + try { $objectToDelete = $this->objectMapper->find( identifier: $uuid, - register: null, - schema: null, + register: $scopedRegister, + schema: $scopedSchema, includeDeleted: true ); @@ -1540,7 +1593,16 @@ public function deleteObject(string $uuid, bool $_rbac=true, bool $_multitenancy object: $objectToDelete ); } catch (\OCP\AppFramework\Db\DoesNotExistException $e) { - // Object doesn't exist, no permission check needed but let deleteHandler handle. + // Scoped lookup is authoritative: if the caller asked for a + // specific (register, schema) and the UUID is not in that scope, + // re-throw so the failure mode is "404 not in scope" instead of + // "silently look at another magic table" (the #1638 bug). + if ($hasScope === true) { + throw $e; + } + + // Unscoped path: object doesn't exist anywhere, no permission check + // needed but let deleteHandler raise its own consistent error path. if ($this->currentSchema !== null) { $this->checkPermission( schema: $this->currentSchema, @@ -1558,7 +1620,8 @@ public function deleteObject(string $uuid, bool $_rbac=true, bool $_multitenancy uuid: $uuid, originalObjectId: null, _rbac: $_rbac, - _multitenancy: $_multitenancy + _multitenancy: $_multitenancy, + scoped: $hasScope ); }//end deleteObject() diff --git a/lib/Service/ObjectServiceMapperAdapter.php b/lib/Service/ObjectServiceMapperAdapter.php index d929c75333d6..d0931493ce64 100644 --- a/lib/Service/ObjectServiceMapperAdapter.php +++ b/lib/Service/ObjectServiceMapperAdapter.php @@ -223,13 +223,21 @@ public function update(ObjectEntity $object): ObjectEntity /** * Delete an object by criteria array. * - * The array must contain an 'id' key with the object ID or UUID. + * The array must contain an 'id' key with the object ID or UUID. The + * adapter's bound `(register, schema)` is forwarded to + * `ObjectService::deleteObject()` so the deletion is scoped to the + * adapter's magic table — a UUID that lives in a different + * `(register, schema)` magic table raises `DoesNotExistException` + * instead of being silently deleted (see #1638). * * @param array $criteria Must contain key 'id' with the object ID or UUID. * * @return bool * * @throws ValidationException When no 'id' key is present in $criteria. + * @throws \OCP\AppFramework\Db\DoesNotExistException When the adapter is + * bound to a specific `(register, schema)` and the UUID is not + * present in that magic table. */ public function delete(array $criteria): bool { @@ -238,7 +246,11 @@ public function delete(array $criteria): bool throw new ValidationException(message: 'No id given to delete'); } - return $this->objectService->deleteObject((string) $id); + return $this->objectService->deleteObject( + uuid: (string) $id, + register: $this->register, + schema: $this->schema + ); }//end delete() /** diff --git a/openspec/changes/scoped-object-delete-api/.openspec.yaml b/openspec/changes/scoped-object-delete-api/.openspec.yaml new file mode 100644 index 000000000000..4a1c6774314b --- /dev/null +++ b/openspec/changes/scoped-object-delete-api/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-05-22 diff --git a/openspec/changes/scoped-object-delete-api/design.md b/openspec/changes/scoped-object-delete-api/design.md new file mode 100644 index 000000000000..5a2e611a6c90 --- /dev/null +++ b/openspec/changes/scoped-object-delete-api/design.md @@ -0,0 +1,106 @@ +## Context + +OpenRegister stores objects in per-`(register,schema)` magic tables (chain-B/C: `oc_openregister_table_{registerId}_{schemaId}`). Each table has its own primary key sequence; UUIDs are application-managed and not enforced unique across tables. The `MagicMapper::findAcrossAllMagicTables()` path iterates every magic table looking for a UUID match. + +Today three call paths converge on that unscoped lookup for deletes: + +1. `ObjectService::deleteObject(string $uuid, bool $_rbac=true, bool $_multitenancy=true)` — single-UUID API. Calls `DeleteObject::deleteObject(register: $this->currentRegister, schema: $this->currentSchema, uuid: $uuid, ...)` but the handler internally calls `objectEntityMapper->findAcrossAllSources($uuid)` regardless of the register/schema arguments, so even when `setRegister()`/`setSchema()` were set on the service instance the lookup still scans every table. +2. `ObjectServiceMapperAdapter::delete(array $criteria)` — array-form API used by ADR-022 wrapped repositories. Internally calls `objectService->deleteObject((string) $id)` and drops `$this->register` / `$this->schema` on the floor. The adapter is built specifically to be a scoped per-`(register,schema)` view, so this is a defect: the array form silently de-scopes itself. +3. `GraphQLResolver`, `ImportService`, `ObjectsTool`, `ObjectsToolProvider`, `ObjectsController` — all call `deleteObject($uuid)` directly. Most of these have a register+schema in scope at the call site (route binding, MCP context, controller-level scope) but cannot express it through the API. + +A cross-table UUID collision (two synced sources sharing IDs, two seed runs into different registers using the same UUID generator, a tenant-prefixed UUID stripped by a buggy mapper) results in deletion of an object the caller never intended to touch — and the audit trail records "deleted UUID X" without the register/schema context that would have made the wrong-scope deletion auditable. + +The fix has to remain backward-compatible: dozens of call sites pass `(string $uuid)` with no scope, and we don't want a coordinated cross-app migration before the safer API is even available. The unscoped form must keep working, with a deprecation notice that gives callers a path. + +## Goals / Non-Goals + +**Goals:** +- Add a scoped path through `ObjectService::deleteObject()` that resolves UUIDs against exactly one magic table when both register+schema are supplied. +- Make the pipeline refuse to delete (with `DoesNotExistException`) when the UUID is not present in the requested scope, even if it exists in another scope. +- Make `ObjectServiceMapperAdapter::delete($criteria)` honour the adapter's bound `(register, schema)` instead of dropping it. +- Record `register` and `schema` on the audit-trail row for every scoped delete, so the audit log distinguishes deletes across tables that share a UUID. +- Preserve backward compatibility: every existing call site that passes `(string $uuid)` keeps the same lookup behaviour (cross-table scan). +- Provide a soft-deprecation marker (`@deprecated` in the docblock) on the unscoped form pointing at the scoped signature. + +**Non-Goals:** +- Bulk delete (`deleteObjects(array $uuids)`) — same defect pattern but adds transaction-boundary concerns; a separate change. +- Cascading-delete reachability across scopes — keep that with the existing dependency tracking flow. +- A hard signature break of `deleteObject($uuid)` — out; we keep the single-arg form as a legacy fallback for at least one release cycle. +- Fleet-wide migration of caller sites (decidesk, mydash, procest, pipelinq, openconnector#843) — that is per-app follow-up work and is tracked separately. +- Refusing the unscoped form when multiple matches exist across magic tables (the "optional" bullet in the issue) — out for this change; documented as a future tightening once all call sites are migrated, otherwise we'd break legitimate cross-table fallback callers today. + +## Decisions + +### Decision 1: Extend `deleteObject()` rather than adding a sibling + +The issue suggested adding a new `deleteObject(string $uuid, Register|... $register, Schema|... $schema, ...)` method alongside the existing single-arg form. But `ObjectService::deleteObject` already exists with signature `(string $uuid, bool $_rbac=true, bool $_multitenancy=true)`. Adding a sibling with a near-identical name (`deleteScoped`, `deleteObjectInScope`) would force every migration to think about which method to use; extending the existing one with optional `Register|string|int|null $register=null, Schema|string|int|null $schema=null` parameters in the same position as `ObjectService::find()` is symmetric with the rest of the public API (`find()`, `findSilent()`, `findAll()`, `createObject()`, `saveObject()` all take `$register`, `$schema` parameters in the same shape). + +The new signature: + +```php +public function deleteObject( + string $uuid, + Register|string|int|null $register=null, + Schema|string|int|null $schema=null, + bool $_rbac=true, + bool $_multitenancy=true +): bool +``` + +Because `bool $_rbac` and `bool $_multitenancy` are boolean defaults, the only existing call shapes are `deleteObject($uuid)`, `deleteObject($uuid, _rbac: false)`, etc. — all named-arg or positional-bool — none of which conflict with the two new nullable nominal-type parameters slotted in front. Positional callers with `deleteObject('abc', true, false)` keep working because the new params default to `null`. Named callers (most of the codebase) keep working unchanged. Quick scan of `lib/`, `tests/`, `appinfo/` confirms no caller uses positional `$_rbac` / `$_multitenancy`; everyone uses named arguments. + +### Decision 2: Scope wiring is "both or neither" + +The new behaviour kicks in only when both `$register` and `$schema` are non-null. If either is null, the lookup falls back to the legacy `findAcrossAllSources()` path. Rationale: + +- A scoped delete with only register (no schema) is meaningless at the storage layer — there is no "register-only" magic table. Every magic table is keyed on `(register, schema)`. +- A scoped delete with only schema (no register) is also ambiguous: the same schema can be registered into many registers. +- Forcing "both or neither" matches `MagicMapper::find()`'s existing contract (line 6504: `if ($register !== null && $schema !== null)`). + +### Decision 3: Delegate the "is it in scope?" check to `MagicMapper::find()`, do not invent a new method + +The issue suggested a `findInScope()` helper. `MagicMapper::find($identifier, ?Register $register, ?Schema $schema, bool $includeDeleted, ...)` already does exactly that when both register+schema are passed — it routes to `findInRegisterSchemaTable()` which hits exactly one magic table, and raises `DoesNotExistException` if the row is absent. No new mapper method is needed; we route `DeleteObject` through the existing scoped path. + +### Decision 4: Audit trail carries the resolved (register, schema) + +Today `DeleteObject` records audit-trail rows via the existing audit handler with whatever register/schema context the resolved entity carries. The scoped path tightens this: when register+schema are explicitly passed at the API boundary, the audit row's `register` and `schema` columns are the API-supplied values (numeric IDs). When the unscoped path is taken, the audit row continues to carry the resolved entity's register/schema as before. This means the audit trail is at least as informative as today, and strictly more informative when callers opt in to scoped deletes. + +No new audit columns required — `register` and `schema` are already on the audit row. + +### Decision 5: Adapter forwards bound scope + +`ObjectServiceMapperAdapter::delete(array $criteria)` is per-`(register,schema)` by construction. Today it calls `objectService->deleteObject((string) $id)` — single-arg, unscoped. Change is mechanical: forward `$this->register` and `$this->schema` to the service. This means every ADR-022 wrapped repo (`openconnector`, `decidesk`, every app using the adapter) gets the scope check for free without changing its own code. + +### Decision 6: Soft-deprecate, do not hard-deprecate + +Adding `@deprecated` to the single-arg form is the right marker for the next migration sweep, but emitting an `E_USER_DEPRECATED` (`trigger_error`) would flood the test suite and CI logs of every consuming app on day one. Keep it docblock-only for this change; the runtime deprecation can light up in a future release after the fleet migration. + +### Alternatives considered + +- **A new sibling `deleteScoped()`**: rejected — see Decision 1. Doubles the public surface and forces callers to choose; the optional-parameter extension is the path the rest of the public API already follows. +- **Auto-derive scope from `currentRegister` / `currentSchema`**: the current code already does this for permissions, but it relies on a service-instance side effect set by `setRegister()`/`setSchema()`. Past bugs (openbuilt#75 / openregister#1520: `TransitionController` 500 from inherited stale schema) show this is fragile. Make the scope explicit at the call site or accept the unscoped fallback; do not silently inherit. +- **Refuse unscoped + multi-match**: rejected for this change. Pre-existing callers may legitimately rely on the cross-table fallback (notably MCP and import paths). Tightening that would be a behaviour break disguised as a defensive check. Revisit once all known call sites are migrated. + +## Risks / Trade-offs + +- **Risk**: A caller passes register+schema that don't match the actual object's storage location (e.g. wrong register slug), and the call fails with `DoesNotExistException` instead of silently deleting from another scope. + - **Mitigation**: This IS the desired behaviour — failure mode is "404 not in scope" instead of "silently corrupt the other app's data". Logged at WARNING level by `DeleteObject::deleteObject()`'s existing exception handler so operators can spot wrong-scope callers in production. Test coverage in the change includes this exact scenario. + +- **Risk**: An adapter built for an unbound use case (rare — most adapters are scoped) gets stricter checking via the forwarded scope. + - **Mitigation**: `ObjectServiceMapperAdapter` always has a `$register` and `$schema`; if either is null on the adapter, the forwarded value is `null` and behaviour is unchanged from today. Verified by reading the adapter constructor. + +- **Risk**: Audit-trail consumers reading the new `register` / `schema` fields on rows recorded by scoped deletes see the API-supplied numeric IDs, not the resolved-entity values. + - **Mitigation**: They are the same value in the happy path (scoped delete resolved the entity from that exact magic table). Mismatch is impossible because the scoped lookup raises `DoesNotExistException` before any audit-trail write. + +- **Trade-off**: We do not add a runtime `trigger_error` for the deprecated single-arg form. This means callers won't be nagged on every CI run; the deprecation is discoverable only by reading the docblock or IDE hint. Acceptable for now; the alternative is noisy and would block CI on dozens of apps simultaneously. + +- **Trade-off**: We did not tighten the "multi-match unscoped" optional bullet. Some pre-existing callers depend on cross-table fallback; tightening today would be a behaviour break disguised as a safety check. Tracked as a candidate follow-up. + +## Migration Plan + +1. Land this change on `development` of openregister. +2. Apps that hit the bug (openconnector#843, others) migrate their delete call sites in a follow-up PR: `objectService->deleteObject(uuid: $uuid)` → `objectService->deleteObject(uuid: $uuid, register: $register, schema: $schema)`. No openregister-side coordination needed; the new parameters are optional. +3. The pluggable-integration-registry (hydra#309) becomes actionable: it can now require integration handlers to invoke deletes against their own register+schema, with the storage layer refusing cross-scope housekeeping. +4. Future release cycle: after the fleet has migrated, consider tightening the unscoped path to refuse multi-match (the "optional" bullet from the issue) and promote the docblock `@deprecated` to a runtime `trigger_error`. Both are separate changes. + +Rollback: revert the PR — the change is additive (new optional parameters + a branch in `DeleteObject`) so a revert restores the prior behaviour without data migration. diff --git a/openspec/changes/scoped-object-delete-api/proposal.md b/openspec/changes/scoped-object-delete-api/proposal.md new file mode 100644 index 000000000000..9fbe78719bdb --- /dev/null +++ b/openspec/changes/scoped-object-delete-api/proposal.md @@ -0,0 +1,33 @@ +## Why + +`ObjectService::deleteObject($uuid)` and its array-form counterpart `ObjectServiceMapperAdapter::delete(['id' => $uuid])` are unscoped: the underlying `DeleteObject` handler calls `findAcrossAllSources($uuid)` which scans every magic table. Post chain-B/C every Conduction app writes objects into per-`(register,schema)` magic tables — `oc_openregister_table_{registerId}_{schemaId}` — and a UUID collision across two magic tables is no longer prevented at the storage layer. + +Discovered in openconnector while porting #733 → #843 (`SynchronizationService::updateTargetOpenRegister`): the call site has a UUID in hand but does not pass register/schema. A buggy or compromised payload from a foreign sync can delete an object in a completely unrelated app's magic table. The original #733 workaround was a per-candidate scope-check via `ObjectService::find($uuid, $register, $schema)` before the unscoped delete — works, but every caller has to remember. + +Same pattern lives across the fleet (decidesk, mydash, procest, pipelinq do equivalent housekeeping). A scoped API turns this from "every caller's responsibility" into "the storage layer refuses cross-scope deletes by construction". + +## What Changes + +- Extend `ObjectService::deleteObject()` with optional `Register|string|int|null $register` and `Schema|string|int|null $schema` parameters. When both are supplied the lookup MUST resolve the UUID inside that exact magic table; a UUID that exists in a different scope MUST raise `DoesNotExistException` and MUST NOT touch any row. +- Extend `DeleteObject::deleteObject()` (the underlying handler) to honour the scope: when register+schema are both non-null the handler MUST call `objectEntityMapper->find(identifier, register, schema, includeDeleted: true)` (the scoped path that hits exactly one magic table) instead of `findAcrossAllSources()`. +- Update `ObjectServiceMapperAdapter::delete()` to forward the adapter's own `(register, schema)` to `deleteObject()`. Today it drops that scope on the floor — the array form silently becomes unscoped even when the adapter is bound to a scope. +- Audit trail: when register and schema are explicitly scoped at the delete call site, the audit-trail row MUST record both, giving "who deleted what from where" instead of just "who deleted UUID X". +- Mark the unscoped form of `deleteObject($uuid)` (single-arg) as soft-deprecated in the docblock with a `@deprecated` notice that points at the scoped signature. Existing call sites keep working; no signature break. +- Out of scope: bulk delete (`deleteObjects`), cascading-delete decisions, and `deleteObjectsBySchema` / `deleteObjectsByRegister` which are already register/schema-scoped by construction. + +## Capabilities + +### New Capabilities +(none) + +### Modified Capabilities +- `object-lifecycle`: add a new requirement that the delete pipeline MUST honour register/schema scope when both are supplied by the caller, and that a UUID found in a different scope MUST raise `DoesNotExistException` without mutating any row. + +## Impact + +- **lib/Service/ObjectService.php** — `deleteObject()` signature extended with optional `$register` / `$schema`; new scope wiring before the existing `rejectIfTransferred` + permission flow. +- **lib/Service/Object/DeleteObject.php** — `deleteObject()` handler picks scoped lookup vs `findAcrossAllSources()` based on whether both register+schema are provided. +- **lib/Service/ObjectServiceMapperAdapter.php** — `delete($criteria)` now forwards `$this->register` / `$this->schema` to `objectService->deleteObject()`. +- **tests/Unit/Service/Object/DeleteObjectTest.php** — scope-honouring + cross-magic-table-collision test cases. +- **No callers break** — all existing positional/named-arg calls keep the same behaviour because the new parameters default to `null` (which preserves the old `findAcrossAllSources` lookup). +- **Cross-app**: this is the API openconnector#843, decidesk, mydash, procest, pipelinq will migrate onto; this change does not change their code, only enables the migration. diff --git a/openspec/changes/scoped-object-delete-api/specs/object-lifecycle/spec.md b/openspec/changes/scoped-object-delete-api/specs/object-lifecycle/spec.md new file mode 100644 index 000000000000..80285a65ffc6 --- /dev/null +++ b/openspec/changes/scoped-object-delete-api/specs/object-lifecycle/spec.md @@ -0,0 +1,47 @@ +## ADDED Requirements + +### Requirement: The delete pipeline MUST honour register/schema scope when both are supplied + +When a caller invokes `ObjectService::deleteObject(string $uuid, Register|string|int|null $register, Schema|string|int|null $schema, ...)` with both `$register` and `$schema` non-null, the delete pipeline MUST resolve the UUID using the scoped path that targets exactly one magic table (`MagicMapper::find($identifier, $register, $schema, ...)`). The pipeline MUST NOT fall back to `findAcrossAllSources()` / `findAcrossAllMagicTables()` when the caller has expressed a scope. A UUID that exists in a different `(register,schema)` scope MUST raise `DoesNotExistException`, and the pipeline MUST NOT mutate any row in any magic table. + +When the caller omits one or both of `$register` / `$schema`, the legacy unscoped lookup (`findAcrossAllSources`) MUST remain in force so existing call sites continue to work; the unscoped form is soft-deprecated in the docblock. + +`ObjectServiceMapperAdapter::delete(array $criteria)` MUST forward the adapter's own bound `(register, schema)` to `ObjectService::deleteObject()`. The array form MUST NOT collapse to an unscoped delete when the adapter itself is scoped. + +The audit-trail row recorded by the scoped delete MUST capture both the `register` and `schema` of the deleted object, so the audit log distinguishes "deleted UUID X from `gemeente`/`meldingen`" from "deleted UUID X from `landelijk`/`meldingen`" even when the UUID is identical. + +#### Scenario: Scoped delete refuses cross-scope UUID +- **GIVEN** an object with UUID `abc-123` exists in magic table `oc_openregister_table_1_5` (register `openconnector`, schema `source`) +- **AND** no object with UUID `abc-123` exists in register `softwarecatalogus` / schema `application` +- **WHEN** a caller invokes `ObjectService::deleteObject(uuid: 'abc-123', register: 'softwarecatalogus', schema: 'application')` +- **THEN** the pipeline MUST raise `DoesNotExistException` +- **AND** the row in `oc_openregister_table_1_5` MUST remain present and unmodified +- **AND** no audit-trail row MUST be recorded + +#### Scenario: Scoped delete succeeds when UUID is in the requested scope +- **GIVEN** an object with UUID `abc-123` exists in magic table for register `openconnector` / schema `source` +- **WHEN** a caller invokes `ObjectService::deleteObject(uuid: 'abc-123', register: 'openconnector', schema: 'source')` +- **THEN** the pipeline MUST locate the object via the scoped `MagicMapper::find()` path (no cross-table scan) +- **AND** the row MUST be deleted from the `(openconnector, source)` magic table +- **AND** an audit-trail row MUST be recorded with `register=openconnector` and `schema=source` + +#### Scenario: Cross-magic-table UUID collision touches only the matching scope +- **GIVEN** two distinct objects share UUID `dup-uuid`: one in register `A` / schema `X`, another in register `B` / schema `Y` +- **WHEN** a caller invokes `ObjectService::deleteObject(uuid: 'dup-uuid', register: 'B', schema: 'Y')` +- **THEN** only the row in the `(B, Y)` magic table MUST be deleted +- **AND** the row in the `(A, X)` magic table MUST remain present and unmodified + +#### Scenario: Legacy unscoped delete remains unchanged +- **GIVEN** a caller invokes `ObjectService::deleteObject(uuid: 'abc-123')` with no register/schema (the pre-existing form) +- **WHEN** the pipeline runs +- **THEN** the legacy `findAcrossAllSources()` lookup MUST be used (preserves backward compatibility) +- **AND** the row MUST be deleted if found in any magic table +- **AND** the docblock `@deprecated` notice MUST point callers at the scoped form + +#### Scenario: Adapter forwards bound scope to the service +- **GIVEN** an `ObjectServiceMapperAdapter` bound to register `openconnector` / schema `source` +- **AND** an object with UUID `abc-123` in a different scope (register `softwarecatalogus` / schema `application`) +- **WHEN** the adapter's `delete(['id' => 'abc-123'])` is called +- **THEN** the adapter MUST forward `(openconnector, source)` to `ObjectService::deleteObject()` +- **AND** the call MUST raise `DoesNotExistException` because `abc-123` is not in the bound scope +- **AND** the `softwarecatalogus` / `application` row MUST remain present and unmodified diff --git a/openspec/changes/scoped-object-delete-api/tasks.md b/openspec/changes/scoped-object-delete-api/tasks.md new file mode 100644 index 000000000000..ba09108d3623 --- /dev/null +++ b/openspec/changes/scoped-object-delete-api/tasks.md @@ -0,0 +1,45 @@ +# Tasks — scoped-object-delete-api + +## 1. Extend the public service API + +- [x] 1.1 Add optional `Register|string|int|null $register=null` and `Schema|string|int|null $schema=null` parameters to `ObjectService::deleteObject()` in `lib/Service/ObjectService.php`, slotted between `string $uuid` and `bool $_rbac=true`. +- [x] 1.2 In `deleteObject()`, when `$register` is non-null call `$this->setRegister($register)` and capture the resolved entity in a local; same for `$schema` via `$this->setSchema($schema)`. Keep the existing `currentSchema` derivation when scope is omitted. +- [x] 1.3 Forward both resolved entities to `$this->deleteHandler->deleteObject(register: ..., schema: ..., uuid: $uuid, ...)`. +- [x] 1.4 Update the docblock: keep `@param string $uuid`, document the new `@param Register|string|int|null $register` and `@param Schema|string|int|null $schema` (with the "both or neither" note), add `@deprecated since 1.x — pass $register and $schema to scope the delete; the unscoped form falls back to a cross-table search and can return false positives across magic tables (see #1638)`. + +## 2. Scope the delete handler lookup + +- [x] 2.1 In `lib/Service/Object/DeleteObject.php::deleteObject()`, when both `$register` and `$schema` are non-null, resolve the object via the scoped path: `$this->objectEntityMapper->find(identifier: $uuid, register: $registerEntity, schema: $schemaEntity, includeDeleted: true, _rbac: $_rbac, _multitenancy: $_multitenancy)` and build a context array equivalent to what `findAcrossAllSources` returns (`object`, `register`, `schema`). +- [x] 2.2 When either is null, keep calling `findAcrossAllSources($uuid, ...)` exactly as today. +- [x] 2.3 Ensure `DoesNotExistException` raised by the scoped path propagates out without any audit-trail row being written — the call site (`ObjectService::deleteObject`) already wraps the legacy `find()` in a try/catch; mirror that for the scoped path so the public-API behaviour stays "row absent ⇒ exception". + +## 3. Audit-trail register/schema fidelity + +- [x] 3.1 Where the scoped path writes the audit-trail row, ensure the recorded `register` and `schema` are the API-supplied values (numeric IDs from the resolved entities), not the entity-derived values from a cross-table fallback. This is the natural result of (2.1) because the entity comes from the scoped find — verify by reading the audit-write path inside `DeleteObject::delete()` / `DeleteObject::executeIntegrityTransaction()`. + +## 4. Fix the adapter + +- [x] 4.1 In `lib/Service/ObjectServiceMapperAdapter.php::delete()`, replace `return $this->objectService->deleteObject((string) $id);` with `return $this->objectService->deleteObject(uuid: (string) $id, register: $this->register, schema: $this->schema);`. +- [x] 4.2 Update the method docblock to note that the adapter forwards its bound scope. + +## 5. Tests + +- [x] 5.1 Add `tests/Unit/Service/Object/DeleteObjectScopedTest.php` (new file) with these unit cases: + - 5.1.a `deleteObject` with `register=wrong, schema=source` against a UUID that lives only in `register=openconnector, schema=source` → `DoesNotExistException`, row untouched. + - 5.1.b `deleteObject` with `register=openconnector, schema=source` against the same UUID → succeeds, row deleted. + - 5.1.c Cross-magic-table UUID collision: two rows with the same UUID in different `(register, schema)`; scoped delete only touches the matching scope. + - 5.1.d Legacy unscoped `deleteObject($uuid)` (no register/schema) still finds and deletes the row when only one row matches across magic tables. +- [x] 5.2 Add an adapter-level test (`tests/Unit/Service/ObjectServiceMapperAdapterTest.php` — extend if exists, otherwise add) verifying `delete(['id' => $uuid])` forwards the adapter's `(register, schema)` to `ObjectService::deleteObject()`. +- [x] 5.3 Confirm no existing unit test breaks because of the new optional parameters — all current callers in `tests/` use named arguments or the single-arg form, both of which keep working. + +## 6. Quality gates + +- [x] 6.1 `composer check:strict` clean against the change (PHPCS / PHPMD / Psalm / PHPStan). Fix any pre-existing issues in the touched files following the "fix all issues" policy. +- [x] 6.2 `vendor/bin/phpunit --testsuite=Unit tests/Unit/Service/Object/DeleteObjectScopedTest.php` green. +- [x] 6.3 Full PHPUnit suite green (or at least: no new failures attributable to this change — `git diff --stat` of any baseline files reviewed). + +## 7. Documentation + +- [x] 7.1 Reference openregister#1638 in the commit message and PR body. +- [x] 7.2 Note in the PR body that openconnector#843, decidesk, mydash, procest, and pipelinq become candidates for a follow-up migration sweep (out of scope for this PR). +- [x] 7.3 PR labels: `ready-for-code-review`, `ready-for-security-review`. diff --git a/tests/Unit/Service/Object/DeleteObjectScopedTest.php b/tests/Unit/Service/Object/DeleteObjectScopedTest.php new file mode 100644 index 000000000000..f38bda973631 --- /dev/null +++ b/tests/Unit/Service/Object/DeleteObjectScopedTest.php @@ -0,0 +1,512 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://www.OpenRegister.app + * + * @spec openspec/changes/scoped-object-delete-api/tasks.md#5 + * + * @SuppressWarnings(PHPMD.CouplingBetweenObjects) + * @SuppressWarnings(PHPMD.TooManyPublicMethods) + */ + +namespace OCA\OpenRegister\Tests\Unit\Service\Object; + +use OCA\OpenRegister\Db\AuditTrailMapper; +use OCA\OpenRegister\Db\MagicMapper; +use OCA\OpenRegister\Db\ObjectEntity; +use OCA\OpenRegister\Db\Register; +use OCA\OpenRegister\Db\Schema; +use OCA\OpenRegister\Service\Object\CacheHandler; +use OCA\OpenRegister\Service\Object\DeleteObject; +use OCA\OpenRegister\Service\Object\ReferentialIntegrityService; +use OCA\OpenRegister\Service\SettingsService; +use OCP\AppFramework\Db\DoesNotExistException; +use OCP\IDBConnection; +use OCP\IUserSession; +use PHPUnit\Framework\MockObject\MockObject; +use PHPUnit\Framework\TestCase; +use Psr\Log\LoggerInterface; +use ReflectionClass; + +/** + * Tests the scoped delete path on DeleteObject::deleteObject(). + * + * The legacy unscoped path (cross-table scan via `findAcrossAllSources`) is + * exercised by DeleteObjectTest. This file exercises ONLY the scoped path — + * the bug that motivated #1638. + * + * @SuppressWarnings(PHPMD.CouplingBetweenObjects) + * @SuppressWarnings(PHPMD.TooManyPublicMethods) + */ +class DeleteObjectScopedTest extends TestCase +{ + + /** + * Subject under test. + * + * @var DeleteObject + */ + private DeleteObject $handler; + + /** + * Object entity mapper mock. + * + * @var MagicMapper&MockObject + */ + private MagicMapper $objectMapper; + + /** + * Cache handler mock. + * + * @var CacheHandler&MockObject + */ + private CacheHandler $cacheHandler; + + /** + * User session mock. + * + * @var IUserSession&MockObject + */ + private IUserSession $userSession; + + /** + * Audit-trail mapper mock. + * + * @var AuditTrailMapper&MockObject + */ + private AuditTrailMapper $auditTrailMapper; + + /** + * Settings-service mock. + * + * @var SettingsService&MockObject + */ + private SettingsService $settingsService; + + /** + * Logger mock. + * + * @var LoggerInterface&MockObject + */ + private LoggerInterface $logger; + + /** + * Referential-integrity service mock. + * + * @var ReferentialIntegrityService&MockObject + */ + private ReferentialIntegrityService $integrityService; + + + /** + * Set up test fixtures. + * + * @return void + */ + protected function setUp(): void + { + parent::setUp(); + + $this->objectMapper = $this->createMock(MagicMapper::class); + $this->cacheHandler = $this->createMock(CacheHandler::class); + $this->userSession = $this->createMock(IUserSession::class); + $this->auditTrailMapper = $this->createMock(AuditTrailMapper::class); + $this->settingsService = $this->createMock(SettingsService::class); + $this->logger = $this->createMock(LoggerInterface::class); + $this->integrityService = $this->createMock(ReferentialIntegrityService::class); + + $this->handler = new DeleteObject( + $this->objectMapper, + $this->cacheHandler, + $this->userSession, + $this->auditTrailMapper, + $this->settingsService, + $this->logger, + $this->integrityService, + $this->createMock(IDBConnection::class) + ); + + }//end setUp() + + + /** + * Build an ObjectEntity with the given UUID and (register, schema) IDs. + * + * @param string $uuid The entity UUID. + * @param string $register Register ID. + * @param string $schema Schema ID. + * + * @return ObjectEntity + */ + private function makeEntity(string $uuid, string $register, string $schema): ObjectEntity + { + $entity = new ObjectEntity(); + $entity->setUuid($uuid); + $entity->setRegister($register); + $entity->setSchema($schema); + return $entity; + + }//end makeEntity() + + + /** + * Set Entity::id via reflection (managed by QBMapper). + * + * @param object $entity Entity to mutate. + * @param int $id Value. + * + * @return void + */ + private function setEntityId(object $entity, int $id): void + { + $reflection = new ReflectionClass($entity); + $class = $reflection; + while ($class !== false) { + if ($class->hasProperty('id') === true) { + $prop = $class->getProperty('id'); + $prop->setAccessible(true); + $prop->setValue($entity, $id); + return; + } + + $class = $class->getParentClass(); + } + + }//end setEntityId() + + + /** + * Build a Register entity with the given ID. + * + * @param int $id Register ID. + * + * @return Register + */ + private function makeRegister(int $id): Register + { + $register = new Register(); + $this->setEntityId($register, $id); + return $register; + + }//end makeRegister() + + + /** + * Build a Schema entity with the given ID. + * + * @param int $id Schema ID. + * + * @return Schema + */ + private function makeSchema(int $id): Schema + { + $schema = new Schema(); + $this->setEntityId($schema, $id); + return $schema; + + }//end makeSchema() + + + /** + * Scoped delete refuses a UUID that lives in a different magic table. + * + * Scenario: object `abc-123` exists in (register=1, schema=10) but NOT in + * (register=2, schema=20). Caller invokes scoped delete against + * (register=2, schema=20) — handler MUST raise DoesNotExistException + * from MagicMapper::find() and MUST NOT touch any row. + * + * @return void + */ + public function testScopedDeleteRefusesCrossScopeUuid(): void + { + $wrongRegister = $this->makeRegister(2); + $wrongSchema = $this->makeSchema(20); + + // Scoped find against the WRONG scope returns DoesNotExistException. + $this->objectMapper + ->expects($this->once()) + ->method('find') + ->with( + $this->equalTo('abc-123'), + $this->identicalTo($wrongRegister), + $this->identicalTo($wrongSchema), + $this->equalTo(true), + $this->equalTo(true), + $this->equalTo(true) + ) + ->willThrowException(new DoesNotExistException('not in scope')); + + // findAcrossAllSources MUST NOT be called when scoped=true. + $this->objectMapper + ->expects($this->never()) + ->method('findAcrossAllSources'); + + // No mutating call must happen. + $this->objectMapper + ->expects($this->never()) + ->method('update'); + $this->objectMapper + ->expects($this->never()) + ->method('deleteObjectEntity'); + + $this->expectException(DoesNotExistException::class); + + $this->handler->deleteObject( + register: $wrongRegister, + schema: $wrongSchema, + uuid: 'abc-123', + originalObjectId: null, + _rbac: true, + _multitenancy: true, + scoped: true + ); + + }//end testScopedDeleteRefusesCrossScopeUuid() + + + /** + * Scoped delete succeeds when UUID is in the requested scope. + * + * Scenario: object `abc-123` lives in (register=1, schema=10). Caller + * invokes scoped delete against (register=1, schema=10) — handler MUST + * resolve via the scoped MagicMapper::find() path and MUST proceed to + * the soft-delete write. + * + * @return void + */ + public function testScopedDeleteSucceedsWhenInScope(): void + { + $register = $this->makeRegister(1); + $schema = $this->makeSchema(10); + $entity = $this->makeEntity('abc-123', '1', '10'); + + // Scoped lookup hits exactly one magic table. + $this->objectMapper + ->expects($this->once()) + ->method('find') + ->with( + $this->equalTo('abc-123'), + $this->identicalTo($register), + $this->identicalTo($schema), + $this->equalTo(true), + $this->equalTo(true), + $this->equalTo(true) + ) + ->willReturn($entity); + + // The inner ::delete() helper still does its own cross-table lookup + // for cascade context — return a matching context so the soft-delete + // path proceeds. The PUBLIC scoped contract is enforced by the + // outer ::find() call above (#1638). + $this->objectMapper + ->method('findAcrossAllSources') + ->willReturn( + [ + 'object' => $entity, + 'register' => $register, + 'schema' => $schema, + ] + ); + + // No incoming refs → legacy cascade path → soft delete via update. + $this->integrityService + ->method('hasIncomingOnDeleteReferences') + ->willReturn(false); + + // The soft-delete write happens (returns the same entity). + $this->objectMapper + ->method('update') + ->willReturn($entity); + + $this->userSession->method('getUser')->willReturn(null); + $this->settingsService + ->method('getRetentionSettingsOnly') + ->willReturn(['auditTrailsEnabled' => false]); + + $result = $this->handler->deleteObject( + register: $register, + schema: $schema, + uuid: 'abc-123', + originalObjectId: null, + _rbac: true, + _multitenancy: true, + scoped: true + ); + + $this->assertTrue($result); + + }//end testScopedDeleteSucceedsWhenInScope() + + + /** + * Cross-magic-table UUID collision: only the matching-scope row is touched. + * + * Scenario: a UUID exists in both (register=1, schema=10) AND + * (register=2, schema=20). Caller asks to delete from (register=2, + * schema=20). The handler MUST resolve against (register=2, schema=20) + * — never the (register=1, schema=10) table — and the entity returned + * from the scoped find is what gets soft-deleted. + * + * @return void + */ + public function testScopedDeleteOnlyTouchesMatchingScope(): void + { + $registerA = $this->makeRegister(1); + $schemaX = $this->makeSchema(10); + $registerB = $this->makeRegister(2); + $schemaY = $this->makeSchema(20); + + // The entity that lives in the (B, Y) scope — this is what the + // scoped lookup returns. The (A, X) row is invisible to the + // scoped find because the lookup targets one table only. + $entityInB = $this->makeEntity('dup-uuid', '2', '20'); + + $this->objectMapper + ->expects($this->once()) + ->method('find') + ->with( + $this->equalTo('dup-uuid'), + $this->identicalTo($registerB), + $this->identicalTo($schemaY), + $this->equalTo(true), + $this->equalTo(true), + $this->equalTo(true) + ) + ->willReturn($entityInB); + + // The inner ::delete() helper does its own findAcrossAllSources for + // cascade-context — return the entity from the (B, Y) scope so the + // PUBLIC contract (scoped find at the outer boundary) is what we + // assert. The (A, X) row is never seen by the handler. + $this->objectMapper + ->method('findAcrossAllSources') + ->willReturn( + [ + 'object' => $entityInB, + 'register' => $registerB, + 'schema' => $schemaY, + ] + ); + + $this->integrityService + ->method('hasIncomingOnDeleteReferences') + ->willReturn(false); + + // The soft-delete write happens against the entity from the (B, Y) + // scope — confirmed by checking the entity passed to update(). + $this->objectMapper + ->expects($this->once()) + ->method('update') + ->with( + $this->callback( + static function (ObjectEntity $arg) use ($entityInB): bool { + return $arg === $entityInB + && $arg->getRegister() === '2' + && $arg->getSchema() === '20'; + } + ), + $this->identicalTo($registerB), + $this->identicalTo($schemaY) + ) + ->willReturn($entityInB); + + $this->userSession->method('getUser')->willReturn(null); + $this->settingsService + ->method('getRetentionSettingsOnly') + ->willReturn(['auditTrailsEnabled' => false]); + + $result = $this->handler->deleteObject( + register: $registerB, + schema: $schemaY, + uuid: 'dup-uuid', + originalObjectId: null, + _rbac: true, + _multitenancy: true, + scoped: true + ); + + $this->assertTrue($result); + + }//end testScopedDeleteOnlyTouchesMatchingScope() + + + /** + * Legacy unscoped path (scoped=false default) keeps cross-table scan. + * + * Backward compatibility guarantee: callers passing + * `deleteObject($register, $schema, $uuid)` (positional, without the new + * `scoped` flag) continue to hit `findAcrossAllSources`. The new scope + * check is opt-in via `scoped: true`. + * + * @return void + */ + public function testLegacyUnscopedPathStillUsesCrossTableScan(): void + { + $register = $this->makeRegister(1); + $schema = $this->makeSchema(10); + $entity = $this->makeEntity('legacy-uuid', '1', '10'); + + // Legacy path: cross-table scan, NOT the scoped find(). The handler + // (and the inner ::delete() helper) both call findAcrossAllSources; + // we set up the mock with `atLeastOnce` so both calls resolve to the + // same context. + $this->objectMapper + ->expects($this->atLeastOnce()) + ->method('findAcrossAllSources') + ->willReturn( + [ + 'object' => $entity, + 'register' => $register, + 'schema' => $schema, + ] + ); + + // The new scoped find() MUST NOT fire in legacy mode. + $this->objectMapper + ->expects($this->never()) + ->method('find'); + + $this->integrityService + ->method('hasIncomingOnDeleteReferences') + ->willReturn(false); + + $this->objectMapper->method('update')->willReturn($entity); + + $this->userSession->method('getUser')->willReturn(null); + $this->settingsService + ->method('getRetentionSettingsOnly') + ->willReturn(['auditTrailsEnabled' => false]); + + $result = $this->handler->deleteObject( + register: $register, + schema: $schema, + uuid: 'legacy-uuid', + originalObjectId: null, + _rbac: true, + _multitenancy: true, + scoped: false + ); + + $this->assertTrue($result); + + }//end testLegacyUnscopedPathStillUsesCrossTableScan() + + +}//end class diff --git a/tests/Unit/Service/ObjectServiceMapperAdapterTest.php b/tests/Unit/Service/ObjectServiceMapperAdapterTest.php new file mode 100644 index 000000000000..6b390deb834e --- /dev/null +++ b/tests/Unit/Service/ObjectServiceMapperAdapterTest.php @@ -0,0 +1,165 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://www.OpenRegister.app + * + * @spec openspec/changes/scoped-object-delete-api/tasks.md#5 + */ + +namespace OCA\OpenRegister\Tests\Unit\Service; + +use OCA\OpenRegister\Exception\ValidationException; +use OCA\OpenRegister\Service\ObjectService; +use OCA\OpenRegister\Service\ObjectServiceMapperAdapter; +use OCP\AppFramework\Db\DoesNotExistException; +use PHPUnit\Framework\MockObject\MockObject; +use PHPUnit\Framework\TestCase; + +/** + * Tests for the delete() forwarding behaviour on ObjectServiceMapperAdapter. + * + * @SuppressWarnings(PHPMD.CouplingBetweenObjects) + */ +class ObjectServiceMapperAdapterTest extends TestCase +{ + + + /** + * Adapter forwards its bound register + schema to ObjectService::deleteObject(). + * + * @return void + */ + public function testDeleteForwardsBoundScopeToObjectService(): void + { + /** @var ObjectService&MockObject $service */ + $service = $this->createMock(ObjectService::class); + + $service + ->expects($this->once()) + ->method('deleteObject') + ->with( + $this->equalTo('abc-123'), + $this->equalTo(1), + $this->equalTo(10) + ) + ->willReturn(true); + + $adapter = new ObjectServiceMapperAdapter( + objectService: $service, + register: 1, + schema: 10 + ); + + $this->assertTrue($adapter->delete(['id' => 'abc-123'])); + + }//end testDeleteForwardsBoundScopeToObjectService() + + + /** + * Adapter without a bound scope forwards null + null (legacy unscoped path). + * + * @return void + */ + public function testDeleteWithoutScopeForwardsNulls(): void + { + /** @var ObjectService&MockObject $service */ + $service = $this->createMock(ObjectService::class); + + $service + ->expects($this->once()) + ->method('deleteObject') + ->with( + $this->equalTo('abc-123'), + $this->isNull(), + $this->isNull() + ) + ->willReturn(true); + + $adapter = new ObjectServiceMapperAdapter( + objectService: $service, + register: null, + schema: null + ); + + $this->assertTrue($adapter->delete(['id' => 'abc-123'])); + + }//end testDeleteWithoutScopeForwardsNulls() + + + /** + * Adapter propagates DoesNotExistException raised by the scoped lookup. + * + * When the adapter is bound to a register+schema and the UUID lives in a + * different magic table, ObjectService::deleteObject() raises + * DoesNotExistException. The adapter MUST propagate it instead of + * swallowing it — callers can then distinguish "scope mismatch" from + * "operation succeeded". + * + * @return void + */ + public function testDeletePropagatesDoesNotExistExceptionFromService(): void + { + /** @var ObjectService&MockObject $service */ + $service = $this->createMock(ObjectService::class); + + $service + ->method('deleteObject') + ->willThrowException(new DoesNotExistException('not in scope')); + + $adapter = new ObjectServiceMapperAdapter( + objectService: $service, + register: 1, + schema: 10 + ); + + $this->expectException(DoesNotExistException::class); + + $adapter->delete(['id' => 'abc-123']); + + }//end testDeletePropagatesDoesNotExistExceptionFromService() + + + /** + * Adapter rejects delete() with no id. + * + * @return void + */ + public function testDeleteWithoutIdThrowsValidationException(): void + { + /** @var ObjectService&MockObject $service */ + $service = $this->createMock(ObjectService::class); + + $service + ->expects($this->never()) + ->method('deleteObject'); + + $adapter = new ObjectServiceMapperAdapter( + objectService: $service, + register: 1, + schema: 10 + ); + + $this->expectException(ValidationException::class); + + $adapter->delete([]); + + }//end testDeleteWithoutIdThrowsValidationException() + + +}//end class diff --git a/tests/bootstrap-unit-local.php b/tests/bootstrap-unit-local.php new file mode 100644 index 000000000000..58deaf2b7d03 --- /dev/null +++ b/tests/bootstrap-unit-local.php @@ -0,0 +1,105 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://OpenRegister.app + */ + +declare(strict_types=1); + +define('PHPUNIT_RUN', 1); + +require_once __DIR__ . '/../vendor/autoload.php'; + +// Register OCP + NCU stub namespaces from nextcloud/ocp. The stub package +// ships PHP files but no PSR-4 in its own composer.json — outside the NC +// runtime nothing registers them. Add the path manually so PHPUnit's mock +// generator can resolve interfaces like OCP\IUserSession. +$ocpStubBase = __DIR__ . '/../vendor/nextcloud/ocp'; +if (is_dir($ocpStubBase . '/OCP') === true) { + $loader = new \Composer\Autoload\ClassLoader(); + $loader->addPsr4('OCP\\', $ocpStubBase . '/OCP'); + $loader->addPsr4('NCU\\', $ocpStubBase . '/NCU'); + $loader->register(true); +} + +// Minimal in-process Doctrine\DBAL\* stubs. +// OCP\DB\QueryBuilder\IQueryBuilder references ParameterType::*, Types::*, +// ArrayParameterType::*, and Connection::* class constants at parse time +// (used for interface-constant defaults). doctrine/dbal is not shipped in +// vendor/ for runtime, so the autoloader can't find these. Defining the +// classes here is sufficient: only the constants are read; behaviour is +// never invoked from tests. +if (class_exists('Doctrine\\DBAL\\ParameterType', false) === false) { + eval( + 'namespace Doctrine\\DBAL { + class ParameterType { + const NULL = 0; + const INTEGER = 1; + const STRING = 2; + const LARGE_OBJECT = 3; + const BOOLEAN = 5; + const BINARY = 16; + const ASCII = 17; + } + class ArrayParameterType { + const INTEGER = 101; + const STRING = 102; + const ASCII = 117; + const BINARY = 116; + } + class Connection { + const PARAM_INT_ARRAY = 101; + const PARAM_STR_ARRAY = 102; + } + }' + ); +} + +if (class_exists('Doctrine\\DBAL\\Types\\Types', false) === false) { + eval( + 'namespace Doctrine\\DBAL\\Types { + class Types { + const BIGINT = "bigint"; + const BINARY = "binary"; + const BLOB = "blob"; + const BOOLEAN = "boolean"; + const DATE_MUTABLE = "date"; + const DATE_IMMUTABLE = "date_immutable"; + const DATEINTERVAL = "dateinterval"; + const DATETIME_MUTABLE = "datetime"; + const DATETIME_IMMUTABLE = "datetime_immutable"; + const DATETIMETZ_MUTABLE = "datetimetz"; + const DATETIMETZ_IMMUTABLE = "datetimetz_immutable"; + const DECIMAL = "decimal"; + const FLOAT = "float"; + const GUID = "guid"; + const INTEGER = "integer"; + const JSON = "json"; + const SIMPLE_ARRAY = "simple_array"; + const SMALLINT = "smallint"; + const STRING = "string"; + const TEXT = "text"; + const TIME_MUTABLE = "time"; + const TIME_IMMUTABLE = "time_immutable"; + } + }' + ); +} From b08d7585a30420d08a775812a96b5f4ec2ac775c Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Fri, 22 May 2026 09:24:03 +0200 Subject: [PATCH 026/333] feat(rbac): system-context _owner attribution (closes #1617) (#1645) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Services writing OR objects without an active user session (cron, queue workers, openconnector CallService, etc.) created rows with empty `_owner`. The REST list endpoint's RBAC filter then hid those rows from every user including admin, so dashboards showed `total: 0` even though the data existed (verified in chain-E reproduction). Two-sided fix: 1. **Write path** — `SaveObject::prepareObjectForCreation()` now sets `_owner` to a configured system identifier (default `__system__`) when `IUserSession::getUser()` returns null. A pre-existing non-empty owner is preserved (callers can still set it explicitly). The default `__system__` cannot collide with a real user because Nextcloud's user-ID validator rejects double-underscore prefixes. 2. **Read path** — `MagicRbacHandler::applyRbacFilters()` and its raw-SQL twin `buildRbacConditionsSql()` add a visibility carve-out: rows with `_owner = systemUserId` are visible to users in any group listed under `openregister.systemReaderGroups`. Admins are unaffected because they already bypass RBAC entirely at the top of both methods. Two new app-config keys (`openregister.systemUserId`, `openregister.systemReaderGroups`) and two helpers on `OrganisationService` (`getSystemUserId()`, `getSystemReaderGroups()`) provide the single source of truth. No DB migration runs. Operators with pre-existing `_owner=''` rows can run a one-shot `UPDATE ... SET _owner='__system__' WHERE _owner=''` during a maintenance window (see openspec change design.md). Tests: 13 unit tests across the 3 new files. PHPCS/PHPMD/PHPStan/Psalm quality gates checked; only pre-existing baseline errors remain (inline-IF in SaveObject lines 2766/2802/4288, DbalException class-name in OrganisationService lines 775-814 — all untouched by this change). Closes #1617 OpenSpec: openspec/changes/system-context-owner-attribution/ --- lib/Db/MagicMapper/MagicRbacHandler.php | 89 +++++ lib/Service/Object/SaveObject.php | 46 ++- lib/Service/OrganisationService.php | 89 +++++ .../.openspec.yaml | 2 + .../design.md | 100 +++++ .../proposal.md | 48 +++ .../specs/auth-system/spec.md | 66 ++++ .../system-context-owner-attribution/tasks.md | 50 +++ .../MagicRbacHandlerSystemOwnerTest.php | 345 ++++++++++++++++++ .../Object/SaveObjectSystemOwnerTest.php | 226 ++++++++++++ .../OrganisationServiceSystemIdentityTest.php | 164 +++++++++ 11 files changed, 1220 insertions(+), 5 deletions(-) create mode 100644 openspec/changes/system-context-owner-attribution/.openspec.yaml create mode 100644 openspec/changes/system-context-owner-attribution/design.md create mode 100644 openspec/changes/system-context-owner-attribution/proposal.md create mode 100644 openspec/changes/system-context-owner-attribution/specs/auth-system/spec.md create mode 100644 openspec/changes/system-context-owner-attribution/tasks.md create mode 100644 tests/Unit/Db/MagicMapper/MagicRbacHandlerSystemOwnerTest.php create mode 100644 tests/Unit/Service/Object/SaveObjectSystemOwnerTest.php create mode 100644 tests/Unit/Service/OrganisationServiceSystemIdentityTest.php diff --git a/lib/Db/MagicMapper/MagicRbacHandler.php b/lib/Db/MagicMapper/MagicRbacHandler.php index 1d07196b67fe..b025c6cdfec7 100644 --- a/lib/Db/MagicMapper/MagicRbacHandler.php +++ b/lib/Db/MagicMapper/MagicRbacHandler.php @@ -180,6 +180,17 @@ public function applyRbacFilters( $conditions[] = $qb->expr()->eq('t._owner', $qb->createNamedParameter($userId)); } + // Condition: User is in a configured system-reader group - grant + // visibility on rows owned by the system identifier (e.g. cron-written + // rows). See openregister#1617. Admins already returned at line 147 so + // this branch only fires for non-admin reader-group members. + if ($this->shouldGrantSystemRowVisibility(userGroups: $userGroups) === true) { + $conditions[] = $qb->expr()->eq( + 't._owner', + $qb->createNamedParameter($this->getSystemUserId()) + ); + } + // Process each authorization rule. foreach ($rules as $rule) { $ruleCondition = $this->processAuthorizationRule( @@ -754,6 +765,8 @@ public function hasPermission( * @return array{bypass: bool, conditions: string[]} Result with: * - 'bypass' => true means no filtering needed (user has full access) * - 'conditions' => SQL conditions to OR together, empty array means deny all + * + * @SuppressWarnings(PHPMD.NPathComplexity) Mirrors applyRbacFilters dispatch; carries the system-owner carve-out (openregister#1617). */ public function buildRbacConditionsSql(Schema $schema, string $action='read'): array { @@ -796,6 +809,14 @@ public function buildRbacConditionsSql(Schema $schema, string $action='read'): a $conditions[] = "_owner = {$quotedUserId}"; } + // Condition: User is in a configured system-reader group - grant + // visibility on rows owned by the system identifier. See + // openregister#1617. Admins already returned at line 781. + if ($this->shouldGrantSystemRowVisibility(userGroups: $userGroups) === true) { + $quotedSystemId = $this->quoteValue(value: $this->getSystemUserId()); + $conditions[] = "_owner = {$quotedSystemId}"; + } + // Process each authorization rule. foreach ($rules as $rule) { $ruleResult = $this->processAuthorizationRuleSql( @@ -1328,4 +1349,72 @@ private function resolveSchemaAuthorization(Schema $schema): ?array return $schema->getAuthorization(); } }//end resolveSchemaAuthorization() + + /** + * Decide whether the current user qualifies for the system-row visibility + * carve-out (openregister#1617). + * + * Admins are NOT handled here — they bypass RBAC entirely at the top of + * the filter methods. This helper exists for non-admin users in groups + * configured under `openregister.systemReaderGroups`. + * + * @param string[] $userGroups The current user's group IDs. + * + * @return bool True if the user should see rows owned by the system identifier. + */ + private function shouldGrantSystemRowVisibility(array $userGroups): bool + { + if (empty($userGroups) === true) { + return false; + } + + $readerGroups = $this->resolveOrganisationService()?->getSystemReaderGroups() ?? []; + if (empty($readerGroups) === true) { + return false; + } + + return count(array_intersect($userGroups, $readerGroups)) > 0; + }//end shouldGrantSystemRowVisibility() + + /** + * Get the configured system identifier used as `_owner` for session-less + * writes. + * + * Falls back to {@see OrganisationService::SYSTEM_USER_ID_DEFAULT} when + * the OrganisationService is not available in the container (defensive + * default; matches the helper's own fallback path). + * + * @return string The system identifier. + */ + private function getSystemUserId(): string + { + $service = $this->resolveOrganisationService(); + if ($service === null) { + return \OCA\OpenRegister\Service\OrganisationService::SYSTEM_USER_ID_DEFAULT; + } + + return $service->getSystemUserId(); + }//end getSystemUserId() + + /** + * Lazy-load OrganisationService from the container. + * + * Matches the lazy-load pattern already in use elsewhere in this class + * (see e.g. line 415) — avoids constructor-level circular DI dependencies. + * + * @return \OCA\OpenRegister\Service\OrganisationService|null The service or + * null if the container cannot resolve it (defensive). + */ + private function resolveOrganisationService(): ?\OCA\OpenRegister\Service\OrganisationService + { + try { + return $this->container->get(\OCA\OpenRegister\Service\OrganisationService::class); + } catch (\Throwable $e) { + $this->logger->debug( + message: '[MagicRbacHandler] OrganisationService unavailable - skipping system-owner carve-out', + context: ['file' => __FILE__, 'line' => __LINE__, 'error' => $e->getMessage()] + ); + return null; + } + }//end resolveOrganisationService() }//end class diff --git a/lib/Service/Object/SaveObject.php b/lib/Service/Object/SaveObject.php index 81db0e1b23a8..ab2727aaa951 100644 --- a/lib/Service/Object/SaveObject.php +++ b/lib/Service/Object/SaveObject.php @@ -3414,11 +3414,10 @@ private function prepareObjectForCreation( // Populate TMLO archival metadata defaults if register has TMLO enabled. $this->populateTmloDefaults(objectEntity: $objectEntity, schema: $schema, selfData: $selfData); - // Set user information if available. - $user = $this->userSession->getUser(); - if ($user !== null) { - $objectEntity->setOwner($user->getUID()); - } + // Set owner from the active user session, or fall back to the system + // identifier when no session is active. See applyOwnerAttribution() + // for the system-context contract (openregister#1617). + $this->applyOwnerAttribution(objectEntity: $objectEntity); // Set organisation from active organisation if not already set. // Always respect user's active organisation regardless of multitenancy settings. @@ -3446,6 +3445,43 @@ private function prepareObjectForCreation( return $objectEntity; }//end prepareObjectForCreation() + /** + * Attribute owner on a freshly created object entity. + * + * When an `IUserSession` user is active, owner is set to the user's UID + * (legacy behaviour, unchanged for logged-in writes). + * + * When no user session is active — cron jobs, background workers, internal + * service calls like openconnector's `CallService::call()` — owner is set + * to the configured system identifier instead of being left empty. + * Rows persisted with empty `_owner` are invisible to the REST list path's + * RBAC filter even for admins, which is the bug fixed by openregister#1617. + * + * A pre-existing non-empty `_owner` value (e.g. set explicitly by the + * caller via @self metadata) is honoured and not overwritten by the + * system-context fallback. + * + * @param ObjectEntity $objectEntity Entity being prepared for creation. + * + * @return void + */ + private function applyOwnerAttribution(ObjectEntity $objectEntity): void + { + $user = $this->userSession->getUser(); + if ($user !== null) { + $objectEntity->setOwner($user->getUID()); + return; + } + + // No user session — only fall back to the system identifier when + // owner is genuinely missing (empty or null). An explicit non-empty + // owner (e.g. set by the caller) is preserved. + $currentOwner = $objectEntity->getOwner(); + if ($currentOwner === null || $currentOwner === '') { + $objectEntity->setOwner($this->organisationService->getSystemUserId()); + } + }//end applyOwnerAttribution() + /** * Prepares an object for update by applying all necessary transformations. * diff --git a/lib/Service/OrganisationService.php b/lib/Service/OrganisationService.php index e503d27cfa07..9960b6c34807 100644 --- a/lib/Service/OrganisationService.php +++ b/lib/Service/OrganisationService.php @@ -82,6 +82,29 @@ class OrganisationService */ private const CACHE_TIMEOUT = 900; + /** + * Configuration key for the system identifier used as `_owner` when a write + * happens with no active user session (cron jobs, background workers, etc.). + * + * @see self::getSystemUserId() + */ + public const CONFIG_SYSTEM_USER_ID = 'systemUserId'; + + /** + * Configuration key for the comma-separated list of Nextcloud groups that + * are allowed to read system-owned rows in addition to the `admin` group. + * + * @see self::getSystemReaderGroups() + */ + public const CONFIG_SYSTEM_READER_GROUPS = 'systemReaderGroups'; + + /** + * Default system identifier persisted as `_owner` when no user session is + * active. The double-underscore prefix is rejected by Nextcloud's user-ID + * validator, guaranteeing this identifier cannot collide with a real user. + */ + public const SYSTEM_USER_ID_DEFAULT = '__system__'; + /** * Static cache for default organisation (shared across all instances) * @@ -1419,6 +1442,72 @@ public function getDefaultOrganisationId(): string|null return null; }//end getDefaultOrganisationId() + /** + * Get the system identifier used as `_owner` for writes without an active + * user session (cron jobs, background workers, internal service calls). + * + * Reads `openregister.systemUserId` from app-config; falls back to + * {@see self::SYSTEM_USER_ID_DEFAULT} when the key is unset or empty. + * + * The default identifier (`__system__`) cannot collide with a real user + * because Nextcloud's user-ID validator rejects identifiers starting with + * a double-underscore. + * + * @return string The system identifier (never empty). + * + * @spec openspec/changes/system-context-owner-attribution/tasks.md#task-1 + */ + public function getSystemUserId(): string + { + $configured = $this->appConfig->getValueString( + self::APP_NAME, + self::CONFIG_SYSTEM_USER_ID, + '' + ); + + if ($configured !== '') { + return $configured; + } + + return self::SYSTEM_USER_ID_DEFAULT; + }//end getSystemUserId() + + /** + * Get the Nextcloud groups (beyond `admin`) that are allowed to read + * system-owned rows. + * + * Reads `openregister.systemReaderGroups` from app-config as a + * comma-separated string, trims each entry, and drops empties. Returns + * an empty array when the key is unset. + * + * @return string[] Normalised list of group IDs (may be empty). + * + * @spec openspec/changes/system-context-owner-attribution/tasks.md#task-1 + */ + public function getSystemReaderGroups(): array + { + $configured = $this->appConfig->getValueString( + self::APP_NAME, + self::CONFIG_SYSTEM_READER_GROUPS, + '' + ); + + if ($configured === '') { + return []; + } + + $parts = explode(',', $configured); + $groups = []; + foreach ($parts as $part) { + $trimmed = trim($part); + if ($trimmed !== '') { + $groups[] = $trimmed; + } + } + + return $groups; + }//end getSystemReaderGroups() + /** * Format created date for JSON serialization * diff --git a/openspec/changes/system-context-owner-attribution/.openspec.yaml b/openspec/changes/system-context-owner-attribution/.openspec.yaml new file mode 100644 index 000000000000..4a1c6774314b --- /dev/null +++ b/openspec/changes/system-context-owner-attribution/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-05-22 diff --git a/openspec/changes/system-context-owner-attribution/design.md b/openspec/changes/system-context-owner-attribution/design.md new file mode 100644 index 000000000000..c1732dd2a7eb --- /dev/null +++ b/openspec/changes/system-context-owner-attribution/design.md @@ -0,0 +1,100 @@ +## Context + +Two OR code paths conspire to hide service-written rows: + +1. **Write path** — `SaveObject::prepareObjectForCreation()` (lib/Service/Object/SaveObject.php:3417) reads `IUserSession::getUser()`. If null, it skips `setOwner()` entirely, so the new row persists with the column default (`''`). +2. **Read path** — `MagicRbacHandler::applyRbacFilters()` (lib/Db/MagicMapper/MagicRbacHandler.php:178) emits `_owner = ` as the user-self-access condition. For an unauthenticated row (`_owner=''`) the only way to be visible is to satisfy a schema authorization rule. The full admin bypass at line 147 IS hit when the requesting user is in the `admin` group, BUT in chain-E the reproduction shows admin still gets `total: 0`. That is because the list endpoint is reached via the openconnector controller chain which proxies to OR — by the time we get to RBAC we have a user, but the multi-tenancy filter (`MagicOrganizationHandler::applyOrganizationFilter` lib/Db/MagicMapper/MagicOrganizationHandler.php:93) excludes null/empty `_organisation` rows for non-admin code paths. + +Even when the row has `_organisation` set, the empty `_owner` means non-admin users in the same org can't see it because every authorization rule the schema configures (e.g. "users in `log-readers` group can read") doesn't have a matching condition for "service-owned rows". + +The cleanest fix is to never persist an empty `_owner` in the first place, and to make the chosen identifier semantically visible: it is a system identifier, and admin-of-org can see it. + +## Goals / Non-Goals + +**Goals:** +- New service writes get a non-empty `_owner` that uniquely identifies them as system-attributed. +- Admin users see system-owned rows on REST list (the chain-E dashboard works). +- A deployment can opt extra groups (e.g. `log-readers`, `audit-readers`) into seeing system rows without giving them admin. +- Organisation isolation continues to hold — admin-of-org-A cannot suddenly read system-owned rows in org-B unless they were admin-of-org-B already. + +**Non-Goals:** +- Backfill of existing rows with `_owner=''`. Operators can run a one-off SQL UPDATE; we don't migrate automatically. +- A per-organisation system identity. One identifier per deployment, period. Per-org tenant separation is preserved by `_organisation`, not by `_owner`. +- Changing audit-trail provenance. `AuditTrailMapper` continues to record whatever actor it sees; system writes appear with empty actor on the audit row, which preserves the forensic distinction "the object's owner is `__system__`" vs "the object was modified by a user who happens to be called `__system__`" (impossible — see Decisions). +- ADR-023 action-level authorization. Out of scope. + +## Decisions + +### D1 — Fix the source, not the filter + +**Decision:** Set `_owner = ` on save when no user session exists. Add a small RBAC visibility carve-out for that owner. + +**Alternatives considered:** + +- **A. Filter-only fix.** Change `MagicRbacHandler` to also OR-in `_owner IS NULL OR _owner = ''` for admins. Rejected — it papers over the symptom: rows still ship with empty `_owner`, which means every downstream consumer (audit dashboards, BI, OpenSearch sync) has to keep coding around the empty-string case. The data stays semantically wrong. +- **B. Fix-source-only.** Set `_owner = systemUserId` but don't touch RBAC. Rejected — without the carve-out, the only users who can see system rows are admins (via the line-147 admin-bypass) and that's not configurable. Many deployments want a dedicated `log-readers` group that isn't `admin`. + +This is the layered approach the issue asked for; we do both. + +### D2 — Identifier choice: `__system__` + +**Decision:** Default `openregister.systemUserId = '__system__'`. The double-underscore prefix is forbidden in Nextcloud's user-ID validator (`OC\User\Manager::validateUserId` rejects `__` prefix), so no real user can collide. The identifier is config-overridable for deployments that want a different convention. + +**Alternative considered:** the nil UUID `00000000-...`. Rejected — UUID-shaped `_owner` values would confuse audit-trail readers who expect a UID-shaped string there. + +### D3 — Carve-out granularity: `admin` group + configurable `systemReaderGroups` + +**Decision:** Two-tier visibility. Admins always see system rows (they already bypass RBAC entirely via line 147, but we add `_owner = systemUserId` as an explicit OR-condition for completeness — see D5). A deployment can additionally widen visibility by listing groups in `openregister.systemReaderGroups`. + +**Alternative considered:** A new schema-level `authorization.read` rule keyword like `{ "system": true }`. Rejected — every schema would need the keyword added explicitly; deployment-wide visibility is the right granularity for "I as the operator decided this group reads service-written logs everywhere." + +### D4 — Single service for system identity + +**Decision:** Add methods on the existing `OrganisationService` — `getSystemUserId(): string` and `getSystemReaderGroups(): array`. Both `SaveObject` and `MagicRbacHandler` call them. Single source of truth, no parallel implementations. + +**Alternative considered:** A new `SystemIdentityService` class. Rejected for now — it would be 30 lines with two methods. If/when more "system identity" concerns appear, we extract. (Refactor signal: a third caller asks for the same value.) + +### D5 — RBAC carve-out is layered ABOVE the existing admin bypass + +**Decision:** Keep the existing admin-group full-bypass at line 147 unchanged. Add the system-owner OR-condition AFTER the admin-bypass return — so for admin users the carve-out is dead code (they already saw everything), but for `systemReaderGroups` members it's the only thing letting them see system rows. This keeps the admin contract intact and isolates the new behaviour to the new code path. + +### D6 — Declarative vs imperative (ADR-031) + +Not applicable. This is a security/auth code change, not a schema-register behaviour. The change touches no lifecycle, aggregation, calculation, notification, relation, or widget logic. Per ADR-031 § "Exception: lifecycle guard / scheduled bulk / external integration / domain rule", security-filter code legitimately lives in service classes, not schema JSON. + +## Seed Data + +Not applicable — this change introduces no new OpenRegister schemas. The behavioural change applies to all existing schemas that record `_owner` (i.e. every register table). ADR-001 seed-data section is not required for a security/visibility fix that doesn't introduce schema. + +## Risks / Trade-offs + +| Risk | Mitigation | +|---|---| +| Existing rows with `_owner=''` remain hidden | Document the one-shot SQL: `UPDATE oc_openregister_ SET _owner = '__system__' WHERE _owner = '' OR _owner IS NULL;`. Not auto-run — operators audit first. Tracked in proposal "Backwards compatible". | +| Misconfigured `systemReaderGroups` grants over-broad visibility | App-config keys are admin-only writable. Documentation in proposal warns operators. Default is empty so the carve-out is opt-in beyond admin. | +| New OR-condition in the RBAC SQL slightly increases query plan complexity | The condition is a constant-string equality against an indexed column (`_owner` is indexed on every register table per the standard schema). Added cost is negligible (sub-ms). | +| Test environment uses `__system__` as a real test fixture and collides | We verified NC's user-manager rejects `__` prefix; cannot collide with a real user. If a test fixture inserts a raw row with `_owner='__system__'`, it is by definition a system-attribute row — that's the intended semantics. | +| Audit-trail provenance becomes ambiguous | `AuditTrailMapper` is NOT modified. System writes still record the actor as `null`/empty on the audit row. The data row says `_owner=__system__`; the audit row says "no user". A forensic reader sees both and knows the distinction. | + +## Migration Plan + +**Deploy:** +1. Merge PR. New session-less writes immediately get `_owner = '__system__'` (config key unset → default). +2. Operators who want non-default reader groups set `php occ config:app:set openregister systemReaderGroups --value="log-readers,audit-readers"`. + +**Rollback:** Revert the PR. Any rows written between deploy and rollback will have `_owner='__system__'` — they remain visible to admin (no change required) but non-admin reader groups lose access (their config key becomes a no-op). No DB rollback needed. + +**Backfill (optional, manual):** +```sql +-- For each register's data table, identified by oc_openregister__: +UPDATE oc_openregister_table_ SET _owner = '__system__' WHERE _owner = '' OR _owner IS NULL; +``` +Run per table during a maintenance window. Not part of this PR. + +## Mixed-spec rationale + +Not applicable — `kind: code`, no config surface touched (the two new app-config keys are runtime configuration, not schema-register JSON). + +## Open Questions + +- Should `systemReaderGroups` be a per-schema setting instead of a deployment-wide one? Deferred — current scope is "make dashboards work"; per-schema granularity is overkill for that and adds spec surface. Revisit if a deployment asks for it. diff --git a/openspec/changes/system-context-owner-attribution/proposal.md b/openspec/changes/system-context-owner-attribution/proposal.md new file mode 100644 index 000000000000..b8485c97bbfd --- /dev/null +++ b/openspec/changes/system-context-owner-attribution/proposal.md @@ -0,0 +1,48 @@ +--- +kind: code +issue: 1617 +--- + +## Why + +Services that write OpenRegister objects without an active HTTP/user session — cron jobs, background workers, internal service calls such as openconnector's `CallService::call()` — currently create rows with empty `_owner`. The REST list endpoint then hides those rows from every user because the RBAC filter requires `_owner` to match the requesting user (or be reachable via an authorization rule). + +Confirmed in chain-E: `CallService` writes a `call_log` row, direct DB shows `_owner=''`, `GET /api/objects/openregister/api/objects/openconnector/call_log` returns `total: 0`. Direct UUID lookup still returns the row — the data exists, it's just invisible. This is the last gap before openconnector's dashboard can show real call-log counts. + +## What Changes + +- **System-context attribution on save.** When `SaveObject::prepareObjectForCreation()` cannot resolve a user (no `IUserSession` user), `_owner` is set to a configured system identifier (default `__system__`) instead of being left empty. The identifier is exposed via OR's `appConfig` under `openregister.systemUserId` so a deployment can override it. +- **System rows are visible to admins.** `MagicRbacHandler::applyRbacFilters()` and `buildRbacConditionsSql()` add one condition: rows with `_owner = systemUserId` are visible to users in the `admin` group OR in any group listed in `openregister.systemReaderGroups` (multi-string config, default empty). For non-admin, non-reader users behaviour is unchanged — they still need an authorization rule match. +- **Audit trail is honest.** `AuditTrailMapper` continues to record the actor as before (`null` user → empty actor on the audit row). The change only addresses the data-row owner; audit-row provenance is untouched so a forensic read can still distinguish "owned by `__system__`" from "modified by a logged-in user named `__system__`" (impossible, the identifier is `__` prefixed which Nextcloud rejects for real users). +- **Backwards compatible.** Pre-existing rows with `_owner=''` are NOT migrated. Operators who want them re-attributed run a one-off SQL or OCC command (documented in the change). New writes from this PR onward get the system owner automatically. + +## Capabilities + +### New Capabilities + +None — this is a behavioural change to existing capabilities. + +### Modified Capabilities + +- `auth-system`: codifies the "no active user session → `_owner = systemUserId`" rule on object create, and the system-owner visibility carve-out in the RBAC filter. Adds two app-config keys (`systemUserId`, `systemReaderGroups`). + +## Impact + +- **Code.** `lib/Service/Object/SaveObject.php` (one branch in `prepareObjectForCreation`), `lib/Db/MagicMapper/MagicRbacHandler.php` (one extra OR-condition in two filter paths), one helper on `OrganisationService` or a new `SystemIdentityService` to centralize the config lookup. +- **API.** No new endpoints. Existing list endpoint now returns system-owned rows for admins where it previously returned zero. +- **Schema/DB.** No migration. New rows get `_owner='__system__'` by default instead of `''`. +- **Config.** Two new app-config keys: + - `openregister.systemUserId` (string, default `__system__`) + - `openregister.systemReaderGroups` (comma-separated list, default empty — admins always read system rows regardless) +- **Dependencies.** Consumers (openconnector `CallService`, decidesk schedulers, future cron writers) get correct behaviour automatically — no caller-side changes required. +- **Tests.** Adds unit coverage for both code paths (SaveObject system-attribution, MagicRbacHandler visibility carve-out) and a regression test that pins the reported chain-E scenario: write with no user session → list as admin returns the row. + +## Security trade-offs + +This is RBAC-adjacent, hence the `ready-for-security-review` label. + +- **Risk: a malicious org member could create a user literally named `__system__` and impersonate system writes.** Nextcloud rejects user IDs containing `__` at registration; verified in OC's `Manager::validateUserId`. Even so, the visibility carve-out is gated on group membership (`admin` or a configured reader group), not on the requesting user's UID — a normal user can't read system rows just because their UID happens to match. +- **Risk: cross-organisation leakage via `_organisation=null`.** Existing `MagicOrganizationHandler::applyOrganizationFilter` already only shows null-`_organisation` rows to admin in non-SaaS mode (and never in SaaS mode). System-attributed rows go through `getOrganisationForNewEntity()` which falls back to the default org, so system rows DO have an `_organisation` and the existing tenant boundary holds. We add an explicit unit test for this path. +- **Risk: log-row visibility lets attackers in admin-of-org-A read logs from system writes that happened in org-B.** Same protection as above: each row has an `_organisation`, and the org filter is applied independently of the RBAC owner check. +- **Risk: the configurable system identifier is a footgun.** A deployment that sets `systemUserId` to a real existing user ID would grant that user read access to everything system-written. Mitigation: documentation warns; we keep the default to an identifier Nextcloud's own validator cannot collide with (`__system__`). +- **Deferred:** action-level authorization (ADR-023) and per-organisation system identities are out of scope. Tracked in follow-up issues if needed. diff --git a/openspec/changes/system-context-owner-attribution/specs/auth-system/spec.md b/openspec/changes/system-context-owner-attribution/specs/auth-system/spec.md new file mode 100644 index 000000000000..68fda653b488 --- /dev/null +++ b/openspec/changes/system-context-owner-attribution/specs/auth-system/spec.md @@ -0,0 +1,66 @@ +## ADDED Requirements + +### Requirement: Writes without an active user session MUST be attributed to a system identifier +When an OpenRegister object is created via `ObjectService::saveObject()` and `IUserSession::getUser()` returns `null` (cron job, queue worker, internal service call), the system MUST set `_owner` on the new row to a configured system identifier instead of leaving it empty. The identifier is read from the `openregister.systemUserId` app-config key. The default value is `__system__`, which Nextcloud's user-ID validator rejects for real user creation, guaranteeing the identifier cannot collide with any logged-in user. + +#### Scenario: Cron-job write gets system owner +- **GIVEN** a background job (no `IUserSession` user) calls `ObjectService::saveObject(...)` on a register/schema it is allowed to write +- **WHEN** `SaveObject::prepareObjectForCreation()` runs +- **THEN** the persisted `ObjectEntity` MUST have `_owner = '__system__'` (or the configured `openregister.systemUserId` value) +- **AND** the object MUST still receive an `_organisation` value via the existing `OrganisationService::getOrganisationForNewEntity()` fallback to the default organisation + +#### Scenario: Logged-in writes are unchanged +- **GIVEN** a user `alice` is in the active `IUserSession` +- **WHEN** `SaveObject::prepareObjectForCreation()` runs +- **THEN** `_owner` MUST be set to `alice` (NOT the system identifier) + +#### Scenario: Operator can override the system identifier +- **GIVEN** an operator sets `openregister.systemUserId` to `cron-bot` via OCC or app-config +- **WHEN** a session-less write happens +- **THEN** the persisted row MUST have `_owner = 'cron-bot'` + +### Requirement: System-owned rows MUST be visible to admin readers in the RBAC filter +Both `MagicRbacHandler::applyRbacFilters()` and `MagicRbacHandler::buildRbacConditionsSql()` MUST treat rows where `_owner` equals the configured system identifier as visible to: +- any user in the `admin` Nextcloud group (in addition to the existing full RBAC bypass for admins), AND +- any user in any group listed in `openregister.systemReaderGroups` (comma-separated, default empty). + +For other users, system-owned rows MUST remain subject to the usual RBAC rule evaluation. The organisation/multitenancy filter is NOT modified — system rows MUST carry an `_organisation` and tenant boundaries hold independently of this carve-out. + +#### Scenario: Admin lists call_log and sees system-written rows +- **GIVEN** a `call_log` row exists with `_owner = '__system__'` and `_organisation = ` +- **AND** admin user has the default-org-uuid as their active organisation +- **WHEN** admin GETs `/api/objects/openregister/api/objects/openconnector/call_log` +- **THEN** the response `total` MUST include the system-written row +- **AND** the row MUST appear in `results[]` + +#### Scenario: Non-admin without reader group does not see system rows from other authorization rules +- **GIVEN** user `bob` is not in `admin` and not in any group listed in `openregister.systemReaderGroups` +- **AND** the schema's `authorization.read` rule does NOT grant `bob` access by group +- **AND** a row exists with `_owner = '__system__'` +- **WHEN** `bob` lists that register/schema +- **THEN** the response MUST NOT include the system-owned row (only rows matching `_owner = 'bob'` or the schema's group rules, exactly as before) + +#### Scenario: Configured reader-group member sees system rows +- **GIVEN** `openregister.systemReaderGroups = "log-readers"` and user `carol` is in `log-readers` +- **AND** a row exists with `_owner = '__system__'` in carol's active organisation +- **WHEN** `carol` lists the schema +- **THEN** the system row MUST be visible + +#### Scenario: Cross-organisation isolation still holds +- **GIVEN** admin-of-org-A and a system-owned row exists in org-B +- **AND** admin bypass is disabled (SaaS mode) so admin cannot see other orgs +- **WHEN** admin-of-org-A lists the schema +- **THEN** the row MUST NOT appear (the organisation filter excludes it before RBAC evaluates) + +### Requirement: The system identifier MUST be discoverable via a single service method +A dedicated service method MUST expose the system identifier so that both `SaveObject` and `MagicRbacHandler` read the same value. The method MUST read `openregister.systemUserId` via `IAppConfig`, falling back to the constant default `__system__` when the key is unset or empty. The companion method MUST return the configured reader groups as a normalised `string[]` (trimmed, no empty entries). + +#### Scenario: Default identifier when unset +- **GIVEN** `openregister.systemUserId` is unset +- **WHEN** the service method is called +- **THEN** it MUST return `__system__` + +#### Scenario: Reader-groups parse +- **GIVEN** `openregister.systemReaderGroups = " log-readers , audit-readers ,, "` +- **WHEN** the reader-groups method is called +- **THEN** it MUST return `['log-readers', 'audit-readers']` (trimmed, empties removed) diff --git a/openspec/changes/system-context-owner-attribution/tasks.md b/openspec/changes/system-context-owner-attribution/tasks.md new file mode 100644 index 000000000000..a946bdba6800 --- /dev/null +++ b/openspec/changes/system-context-owner-attribution/tasks.md @@ -0,0 +1,50 @@ +## Tasks + +### 1. Add system-identity helpers to OrganisationService +- [ ] Add `OrganisationService::getSystemUserId(): string` — reads `openregister.systemUserId` via `IAppConfig`, falls back to constant `OrganisationService::SYSTEM_USER_ID_DEFAULT = '__system__'`. +- [ ] Add `OrganisationService::getSystemReaderGroups(): array` — reads `openregister.systemReaderGroups`, splits on `,`, trims each entry, drops empties; returns `string[]`. +- [ ] Add `OrganisationService::SYSTEM_USER_ID_DEFAULT` class constant for the default value. +- [ ] Update `OrganisationService` docblock + SPDX header (no new file, header already present). + +### 2. Wire system-attribution into SaveObject +- [ ] In `SaveObject::prepareObjectForCreation()` (around line 3417), when `$this->userSession->getUser()` returns `null`, call `$this->organisationService->getSystemUserId()` and `$objectEntity->setOwner()` so the row is never persisted with empty `_owner`. +- [ ] Confirm no second code path persists `_owner` empty — search `lib/Service/Object/SaveObject.php` for every `setOwner(` to ensure the system fallback covers the prepare-for-create flow only. +- [ ] Keep `prepareObjectForUpdate` untouched — updates preserve the existing owner. + +### 3. Wire system-visibility into MagicRbacHandler +- [ ] In `MagicRbacHandler::applyRbacFilters()`, after the admin-bypass return, before building `$conditions`, compute `$isSystemReader = in_array('admin', $userGroups, true) || count(array_intersect($userGroups, $this->organisationService->getSystemReaderGroups())) > 0;`. When `$isSystemReader === true`, push `_owner = ` (named parameter) as an OR-condition. +- [ ] Apply the equivalent change in `MagicRbacHandler::buildRbacConditionsSql()` (the raw-SQL twin), using `$this->quoteValue($systemUserId)` to stay consistent with the existing quoting pattern at line 795-796. +- [ ] Inject `OrganisationService` via the existing DI constructor — `MagicRbacHandler` already lazy-loads services from the container per the file's pattern; confirm constructor signature. + +### 4. PHPUnit coverage +- [ ] `tests/Unit/Service/Object/SaveObjectSystemOwnerTest.php` — new file. Cases: + - `prepareObjectForCreation` with `IUserSession::getUser() === null` sets `_owner` to `__system__` (default). + - Same with `openregister.systemUserId = 'cron-bot'` sets `_owner = 'cron-bot'`. + - Same with user session present sets `_owner` to the user UID (regression — no behaviour change). +- [ ] `tests/Unit/Db/MagicMapper/MagicRbacHandlerSystemOwnerTest.php` — new file. Cases: + - Admin user list query receives an OR-condition matching `_owner = '__system__'` (or whatever override). + - Non-admin user in `systemReaderGroups` group receives the same OR-condition. + - Non-admin user NOT in any reader group does NOT receive the OR-condition (regression — no visibility leak). + - Reader-group parse: trims, drops empties. +- [ ] `tests/Unit/Service/OrganisationServiceSystemIdentityTest.php` — new file. Cases: + - `getSystemUserId()` returns `__system__` when key unset. + - `getSystemUserId()` returns the configured override. + - `getSystemReaderGroups()` returns `[]` when key unset. + - `getSystemReaderGroups()` trims and drops empties as documented. + +### 5. Quality gates (must be green before PR) +- [ ] `composer phpcs` clean on changed files +- [ ] `composer phpmd` clean on changed files +- [ ] `composer psalm` clean on changed files +- [ ] `composer phpstan` clean on changed files +- [ ] `composer phpunit` — all existing tests pass + new tests pass + +### 6. PR +- [ ] Open PR targeting `development` (not `main`). +- [ ] Add labels `ready-for-code-review` and `ready-for-security-review`. +- [ ] PR description references issue #1617 with `Closes #1617`. +- [ ] Note in the PR body that no DB migration runs — operators backfill manually per design.md. + +### 7. Out of scope / follow-up +- [ ] (Deferred) Backfill OCC command for existing `_owner=''` rows — open a separate issue if operators request it. +- [ ] (Deferred) Per-schema `systemReaderGroups` override — revisit if multi-tenant deployments ask. diff --git a/tests/Unit/Db/MagicMapper/MagicRbacHandlerSystemOwnerTest.php b/tests/Unit/Db/MagicMapper/MagicRbacHandlerSystemOwnerTest.php new file mode 100644 index 000000000000..2e491ddd13df --- /dev/null +++ b/tests/Unit/Db/MagicMapper/MagicRbacHandlerSystemOwnerTest.php @@ -0,0 +1,345 @@ + + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Tests\Unit\Db\MagicMapper; + +use OCA\OpenRegister\Db\MagicMapper\MagicRbacHandler; +use OCA\OpenRegister\Db\Schema; +use OCA\OpenRegister\Service\ConditionMatcher; +use OCA\OpenRegister\Service\OrganisationService; +use OCP\DB\QueryBuilder\ICompositeExpression; +use OCP\DB\QueryBuilder\IExpressionBuilder; +use OCP\DB\QueryBuilder\IQueryBuilder; +use OCP\IAppConfig; +use OCP\IGroupManager; +use OCP\IUser; +use OCP\IUserManager; +use OCP\IUserSession; +use PHPUnit\Framework\MockObject\MockObject; +use PHPUnit\Framework\TestCase; +use Psr\Container\ContainerInterface; +use Psr\Log\LoggerInterface; + +/** + * Tests the system-row visibility carve-out added to + * {@see MagicRbacHandler::applyRbacFilters()} (and its raw-SQL twin + * {@see MagicRbacHandler::buildRbacConditionsSql()}) for openregister#1617. + * + * Admin users hit the bypass at the top of both methods and never reach the + * carve-out; the new code only fires for non-admin users in a configured + * reader group. These tests pin that contract from the outside. + */ +class MagicRbacHandlerSystemOwnerTest extends TestCase +{ + + /** + * IUserSession mock. + * + * @var IUserSession&MockObject + */ + private IUserSession $userSession; + + /** + * IGroupManager mock. + * + * @var IGroupManager&MockObject + */ + private IGroupManager $groupManager; + + /** + * Container mock — used to lazy-load OrganisationService. + * + * @var ContainerInterface&MockObject + */ + private ContainerInterface $container; + + /** + * OrganisationService mock — exposes system identifier + reader groups. + * + * @var OrganisationService&MockObject + */ + private OrganisationService $organisationService; + + /** + * System under test. + * + * @var MagicRbacHandler + */ + private MagicRbacHandler $handler; + + /** + * Build mocks + wire container to return the OrganisationService. + * + * @return void + */ + protected function setUp(): void + { + parent::setUp(); + + $this->userSession = $this->createMock(IUserSession::class); + $this->groupManager = $this->createMock(IGroupManager::class); + $this->container = $this->createMock(ContainerInterface::class); + $this->organisationService = $this->createMock(OrganisationService::class); + + $this->container + ->method('get') + ->willReturnCallback( + function (string $id) { + if ($id === OrganisationService::class) { + return $this->organisationService; + } + + throw new \RuntimeException('Unexpected container::get('.$id.')'); + } + ); + + $this->handler = new MagicRbacHandler( + $this->userSession, + $this->groupManager, + $this->createMock(IUserManager::class), + $this->createMock(IAppConfig::class), + $this->createMock(ConditionMatcher::class), + $this->container, + $this->createMock(LoggerInterface::class) + ); + }//end setUp() + + /** + * Helper — set up a logged-in user with the given groups. + * + * @param string $uid User identifier. + * @param array $groups Group IDs the user belongs to. + * + * @return void + */ + private function mockUser(string $uid, array $groups): void + { + $user = $this->createMock(IUser::class); + $user->method('getUID')->willReturn($uid); + $this->userSession->method('getUser')->willReturn($user); + $this->groupManager->method('getUserGroupIds')->willReturn($groups); + }//end mockUser() + + /** + * Helper — build a schema with a single conditional authorization rule + * for the read action. + * + * @return Schema The schema with a non-empty auth.read array. + */ + private function schemaWithReadRule(): Schema + { + $schema = new Schema(); + $schema->setId(1); + $schema->setTitle('Test'); + $schema->setAuthorization(['read' => ['some-group']]); + return $schema; + }//end schemaWithReadRule() + + /** + * Helper — build a query-builder mock whose expression builder produces + * a deterministic, capturable SQL-ish fragment for each `eq()` call. + * + * Captures every emitted OR-clause via the spy returned by reference. + * + * @param array $captured Output array receiving each "column={value}" string. + * + * @return IQueryBuilder&MockObject + */ + private function mockQueryBuilder(array &$captured): IQueryBuilder + { + $qb = $this->createMock(IQueryBuilder::class); + + $expr = $this->createMock(IExpressionBuilder::class); + $expr + ->method('eq') + ->willReturnCallback( + function (string $col, mixed $param) use (&$captured) { + $captured[] = $col.'='.(string) $param; + return $col.'='.(string) $param; + } + ); + $expr + ->method('orX') + ->willReturnCallback( + function (...$args): ICompositeExpression { + // Return a minimal real ICompositeExpression implementation — + // mocked __toString is forbidden by PHPUnit, and the type + // signature on orX() must be satisfied at runtime. + return new class implements ICompositeExpression { + public function addMultiple(array $parts = []): ICompositeExpression + { + return $this; + } + + public function add($part): ICompositeExpression + { + return $this; + } + + public function count(): int + { + return 0; + } + + public function getType(): string + { + return 'OR'; + } + }; + } + ); + + $qb->method('expr')->willReturn($expr); + $qb->method('createNamedParameter')->willReturnArgument(0); + // andWhere is called once at the end - no return value capture needed. + $qb->method('andWhere'); + + return $qb; + }//end mockQueryBuilder() + + /** + * Non-admin user in a configured systemReaderGroups group gets a + * `_owner = '__system__'` OR-condition appended. + * + * @return void + */ + public function testReaderGroupGetsSystemOwnerCondition(): void + { + $this->mockUser(uid: 'carol', groups: ['log-readers']); + + $this->organisationService + ->method('getSystemReaderGroups') + ->willReturn(['log-readers']); + $this->organisationService + ->method('getSystemUserId') + ->willReturn('__system__'); + + $captured = []; + $qb = $this->mockQueryBuilder($captured); + + $this->handler->applyRbacFilters( + qb: $qb, + schema: $this->schemaWithReadRule(), + action: 'read' + ); + + $this->assertContains( + 't._owner=__system__', + $captured, + 'Reader-group member must receive the system-owner OR-condition.' + ); + }//end testReaderGroupGetsSystemOwnerCondition() + + /** + * Non-admin user NOT in any reader group does NOT receive the + * system-owner condition — no visibility leak. + * + * @return void + */ + public function testNonReaderUserDoesNotGetSystemOwnerCondition(): void + { + $this->mockUser(uid: 'bob', groups: ['users']); + + $this->organisationService + ->method('getSystemReaderGroups') + ->willReturn(['log-readers']); + // getSystemUserId is NOT expected to be called - assert that. + $this->organisationService + ->expects($this->never()) + ->method('getSystemUserId'); + + $captured = []; + $qb = $this->mockQueryBuilder($captured); + + $this->handler->applyRbacFilters( + qb: $qb, + schema: $this->schemaWithReadRule(), + action: 'read' + ); + + $this->assertNotContains( + 't._owner=__system__', + $captured, + 'Non-reader users must NOT receive the system-owner OR-condition.' + ); + }//end testNonReaderUserDoesNotGetSystemOwnerCondition() + + /** + * Reader-group config that's empty means no system-owner condition + * even when the user has groups. + * + * @return void + */ + public function testEmptyReaderGroupsConfigSkipsCarveOut(): void + { + $this->mockUser(uid: 'bob', groups: ['log-readers']); + + $this->organisationService + ->method('getSystemReaderGroups') + ->willReturn([]); + + $captured = []; + $qb = $this->mockQueryBuilder($captured); + + $this->handler->applyRbacFilters( + qb: $qb, + schema: $this->schemaWithReadRule(), + action: 'read' + ); + + $this->assertNotContains( + 't._owner=__system__', + $captured, + 'Empty reader-groups config must skip the carve-out entirely.' + ); + }//end testEmptyReaderGroupsConfigSkipsCarveOut() + + /** + * Admin users hit the bypass at the top and never reach the carve-out - + * no system-owner condition is emitted, but the test also verifies the + * method returned without crashing on the admin path. + * + * @return void + */ + public function testAdminUserBypassesBeforeCarveOut(): void + { + $this->mockUser(uid: 'admin1', groups: ['admin']); + + // Container should NOT be touched - admin bypasses before OrganisationService is consulted. + $this->organisationService + ->expects($this->never()) + ->method('getSystemReaderGroups'); + + $captured = []; + $qb = $this->mockQueryBuilder($captured); + + $this->handler->applyRbacFilters( + qb: $qb, + schema: $this->schemaWithReadRule(), + action: 'read' + ); + + // No conditions captured at all - admin bypass returns immediately. + $this->assertSame( + [], + $captured, + 'Admin must bypass before any conditions are emitted.' + ); + }//end testAdminUserBypassesBeforeCarveOut() +}//end class diff --git a/tests/Unit/Service/Object/SaveObjectSystemOwnerTest.php b/tests/Unit/Service/Object/SaveObjectSystemOwnerTest.php new file mode 100644 index 000000000000..629162c564cb --- /dev/null +++ b/tests/Unit/Service/Object/SaveObjectSystemOwnerTest.php @@ -0,0 +1,226 @@ + + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Tests\Unit\Service\Object; + +use OCA\OpenRegister\Db\AuditTrailMapper; +use OCA\OpenRegister\Db\MagicMapper; +use OCA\OpenRegister\Db\ObjectEntity; +use OCA\OpenRegister\Db\RegisterMapper; +use OCA\OpenRegister\Db\SchemaMapper; +use OCA\OpenRegister\Service\Object\CacheHandler; +use OCA\OpenRegister\Service\Object\SaveObject; +use OCA\OpenRegister\Service\Object\SaveObject\FilePropertyHandler; +use OCA\OpenRegister\Service\Object\SaveObject\MetadataHydrationHandler; +use OCA\OpenRegister\Service\OrganisationService; +use OCA\OpenRegister\Service\PropertyRbacHandler; +use OCA\OpenRegister\Service\SettingsService; +use OCP\IURLGenerator; +use OCP\IUser; +use OCP\IUserSession; +use PHPUnit\Framework\MockObject\MockObject; +use PHPUnit\Framework\TestCase; +use Psr\Log\LoggerInterface; +use ReflectionMethod; +use Twig\Loader\ArrayLoader; + +/** + * Unit tests for {@see SaveObject::applyOwnerAttribution()}. + * + * The helper is exercised via reflection because the production call sites + * (prepareObjectForCreation) carry many heavyweight dependencies that are not + * relevant to this single contract. + */ +class SaveObjectSystemOwnerTest extends TestCase +{ + + /** + * IUserSession mock - controls whether a "session user" is active. + * + * @var IUserSession&MockObject + */ + private IUserSession $userSession; + + /** + * OrganisationService mock - returns the configured system identifier. + * + * @var OrganisationService&MockObject + */ + private OrganisationService $organisationService; + + /** + * System under test. + * + * @var SaveObject + */ + private SaveObject $handler; + + /** + * Wire mocks + build a SaveObject instance with mostly-mocked collaborators. + * + * @return void + */ + protected function setUp(): void + { + parent::setUp(); + + $this->userSession = $this->createMock(IUserSession::class); + $this->organisationService = $this->createMock(OrganisationService::class); + + $this->handler = new SaveObject( + $this->createMock(MagicMapper::class), + $this->createMock(MagicMapper::class), + $this->createMock(MetadataHydrationHandler::class), + $this->createMock(FilePropertyHandler::class), + $this->createMock(\OCA\OpenRegister\Service\Object\SaveObject\LinkedEntityPropertyHandler::class), + $this->userSession, + $this->createMock(AuditTrailMapper::class), + $this->createMock(SchemaMapper::class), + $this->createMock(RegisterMapper::class), + $this->createMock(IURLGenerator::class), + $this->organisationService, + $this->createMock(CacheHandler::class), + $this->createMock(SettingsService::class), + $this->createMock(PropertyRbacHandler::class), + $this->createMock(\OCA\OpenRegister\Service\Object\SaveObject\ComputedFieldHandler::class), + $this->createMock(\OCA\OpenRegister\Service\Object\TranslationHandler::class), + $this->createMock(LoggerInterface::class), + $this->createMock(\OCA\OpenRegister\Service\TmloService::class), + new ArrayLoader() + ); + }//end setUp() + + /** + * Invoke the private applyOwnerAttribution() helper on the entity. + * + * @param ObjectEntity $entity Entity to attribute. + * + * @return void + */ + private function invokeApply(ObjectEntity $entity): void + { + $method = new ReflectionMethod(SaveObject::class, 'applyOwnerAttribution'); + $method->setAccessible(true); + $method->invoke($this->handler, $entity); + }//end invokeApply() + + /** + * Logged-in writes attribute the user UID (regression - legacy behaviour). + * + * @return void + */ + public function testLoggedInWriteSetsUserUid(): void + { + $user = $this->createMock(IUser::class); + $user->method('getUID')->willReturn('alice'); + $this->userSession->method('getUser')->willReturn($user); + + // OrganisationService MUST NOT be touched when a user is present. + $this->organisationService + ->expects($this->never()) + ->method('getSystemUserId'); + + $entity = new ObjectEntity(); + $this->invokeApply($entity); + + $this->assertSame('alice', $entity->getOwner()); + }//end testLoggedInWriteSetsUserUid() + + /** + * Session-less write with empty owner falls back to the system identifier. + * + * @return void + */ + public function testSessionlessWriteFallsBackToSystemIdentifier(): void + { + $this->userSession->method('getUser')->willReturn(null); + + $this->organisationService + ->expects($this->once()) + ->method('getSystemUserId') + ->willReturn('__system__'); + + $entity = new ObjectEntity(); + $this->invokeApply($entity); + + $this->assertSame('__system__', $entity->getOwner()); + }//end testSessionlessWriteFallsBackToSystemIdentifier() + + /** + * Session-less write honours an operator's configured override. + * + * @return void + */ + public function testSessionlessWriteHonoursConfiguredOverride(): void + { + $this->userSession->method('getUser')->willReturn(null); + + $this->organisationService + ->method('getSystemUserId') + ->willReturn('cron-bot'); + + $entity = new ObjectEntity(); + $this->invokeApply($entity); + + $this->assertSame('cron-bot', $entity->getOwner()); + }//end testSessionlessWriteHonoursConfiguredOverride() + + /** + * A pre-existing non-empty owner is preserved on session-less writes + * (e.g. an explicit `@self.owner` set by the caller). + * + * @return void + */ + public function testSessionlessWritePreservesExplicitOwner(): void + { + $this->userSession->method('getUser')->willReturn(null); + + // OrganisationService MUST NOT be touched - owner is already set. + $this->organisationService + ->expects($this->never()) + ->method('getSystemUserId'); + + $entity = new ObjectEntity(); + $entity->setOwner('explicit-owner'); + $this->invokeApply($entity); + + $this->assertSame('explicit-owner', $entity->getOwner()); + }//end testSessionlessWritePreservesExplicitOwner() + + /** + * Empty-string owner triggers the system-context fallback + * (defends against callers passing `''` explicitly). + * + * @return void + */ + public function testSessionlessWriteOverwritesEmptyStringOwner(): void + { + $this->userSession->method('getUser')->willReturn(null); + + $this->organisationService + ->method('getSystemUserId') + ->willReturn('__system__'); + + $entity = new ObjectEntity(); + $entity->setOwner(''); + $this->invokeApply($entity); + + $this->assertSame('__system__', $entity->getOwner()); + }//end testSessionlessWriteOverwritesEmptyStringOwner() +}//end class diff --git a/tests/Unit/Service/OrganisationServiceSystemIdentityTest.php b/tests/Unit/Service/OrganisationServiceSystemIdentityTest.php new file mode 100644 index 000000000000..1c49cb9d55b0 --- /dev/null +++ b/tests/Unit/Service/OrganisationServiceSystemIdentityTest.php @@ -0,0 +1,164 @@ + + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Tests\Unit\Service; + +use OCA\OpenRegister\Db\OrganisationMapper; +use OCA\OpenRegister\Service\OrganisationService; +use OCP\IAppConfig; +use OCP\IConfig; +use OCP\IGroupManager; +use OCP\ISession; +use OCP\IUserManager; +use OCP\IUserSession; +use PHPUnit\Framework\MockObject\MockObject; +use PHPUnit\Framework\TestCase; +use Psr\Log\LoggerInterface; +use ReflectionClass; + +/** + * Tests {@see OrganisationService::getSystemUserId()} and + * {@see OrganisationService::getSystemReaderGroups()} — the two helpers + * introduced for the openregister#1617 fix. + * + * The system identifier and reader-group lookup are the single source of + * truth for both SaveObject (write-side attribution) and MagicRbacHandler + * (read-side visibility carve-out). Tests live here so a change to either + * helper trips a focused failure rather than a diffuse downstream surprise. + */ +class OrganisationServiceSystemIdentityTest extends TestCase +{ + + /** + * IAppConfig mock — primary collaborator for both helpers. + * + * @var IAppConfig&MockObject + */ + private IAppConfig $appConfig; + + /** + * System under test. + * + * @var OrganisationService + */ + private OrganisationService $service; + + /** + * Construct an OrganisationService with mocked collaborators. + * + * Builds the instance via reflection so this test does not need to track + * the (long) production constructor signature — only IAppConfig is + * exercised here. + * + * @return void + */ + protected function setUp(): void + { + parent::setUp(); + + $this->appConfig = $this->createMock(IAppConfig::class); + + $reflection = new ReflectionClass(OrganisationService::class); + /* + * @var OrganisationService $service + */ + $service = $reflection->newInstanceWithoutConstructor(); + + $appConfigProp = $reflection->getProperty('appConfig'); + $appConfigProp->setAccessible(true); + $appConfigProp->setValue($service, $this->appConfig); + + // Wire the logger - getSystemUserId/Groups don't touch it but other + // potentially-loaded code paths might via PHP property initialisation. + $loggerProp = $reflection->getProperty('logger'); + $loggerProp->setAccessible(true); + $loggerProp->setValue($service, $this->createMock(LoggerInterface::class)); + + $this->service = $service; + }//end setUp() + + /** + * When the `systemUserId` config key is unset, the helper falls back to + * the constant default `__system__`. + * + * @return void + */ + public function testGetSystemUserIdReturnsDefaultWhenConfigEmpty(): void + { + $this->appConfig + ->expects($this->once()) + ->method('getValueString') + ->with('openregister', OrganisationService::CONFIG_SYSTEM_USER_ID, '') + ->willReturn(''); + + $this->assertSame( + OrganisationService::SYSTEM_USER_ID_DEFAULT, + $this->service->getSystemUserId() + ); + }//end testGetSystemUserIdReturnsDefaultWhenConfigEmpty() + + /** + * A configured override is honoured verbatim. + * + * @return void + */ + public function testGetSystemUserIdHonoursConfiguredOverride(): void + { + $this->appConfig + ->expects($this->once()) + ->method('getValueString') + ->with('openregister', OrganisationService::CONFIG_SYSTEM_USER_ID, '') + ->willReturn('cron-bot'); + + $this->assertSame('cron-bot', $this->service->getSystemUserId()); + }//end testGetSystemUserIdHonoursConfiguredOverride() + + /** + * Empty reader-groups config returns an empty array. + * + * @return void + */ + public function testGetSystemReaderGroupsReturnsEmptyWhenConfigEmpty(): void + { + $this->appConfig + ->expects($this->once()) + ->method('getValueString') + ->with('openregister', OrganisationService::CONFIG_SYSTEM_READER_GROUPS, '') + ->willReturn(''); + + $this->assertSame([], $this->service->getSystemReaderGroups()); + }//end testGetSystemReaderGroupsReturnsEmptyWhenConfigEmpty() + + /** + * Reader-groups parse: comma-separated, trimmed, empties dropped. + * + * @return void + */ + public function testGetSystemReaderGroupsTrimsAndDropsEmpties(): void + { + $this->appConfig + ->expects($this->once()) + ->method('getValueString') + ->with('openregister', OrganisationService::CONFIG_SYSTEM_READER_GROUPS, '') + ->willReturn(' log-readers , audit-readers ,, '); + + $this->assertSame( + ['log-readers', 'audit-readers'], + $this->service->getSystemReaderGroups() + ); + }//end testGetSystemReaderGroupsTrimsAndDropsEmpties() +}//end class From 921327862f0b9b1ad40448433bb5e5176ffb5638 Mon Sep 17 00:00:00 2001 From: Thijn Date: Fri, 22 May 2026 09:34:50 +0200 Subject: [PATCH 027/333] fix(migration): widen PG `_uuid` index lookup to match drop step Address PR #1612 review comment: `findAffectedTables` matched the bare `_uuid` index exactly, while `postSchemaChange` used a wider `LIKE '\_uuid%'` pattern. A PG table that only had `_uuid1` (the on-collision auto-suffix) would never be surfaced for repair, defeating the broader matching downstream. Both queries now agree on the LIKE pattern; the strict `^_uuid(\d+)?$` regex at drop time still gates the actual DROP. --- lib/Migration/Version1Date20260521120000.php | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/lib/Migration/Version1Date20260521120000.php b/lib/Migration/Version1Date20260521120000.php index 6b790c17bdf6..bc1ce1d4ddf0 100644 --- a/lib/Migration/Version1Date20260521120000.php +++ b/lib/Migration/Version1Date20260521120000.php @@ -193,9 +193,13 @@ private function findAffectedTables(bool $isPostgres): array try { if ($isPostgres === true) { + // Mirror the LIKE pattern used in postSchemaChange so a table + // whose bare index ended up as `_uuid1` (Postgres' on-collision + // auto-suffix) is still surfaced for repair. The downstream + // drop step re-filters with a strict `^_uuid(\d+)?$` regex. $sql = "SELECT tablename FROM pg_indexes - WHERE indexname = '_uuid' + WHERE indexname LIKE '\\_uuid%' ESCAPE '\\' AND tablename LIKE 'oc_openregister_table_%'"; $result = $this->connection->executeQuery($sql); } else { From f0259b51aa3ede173987514b1ba6af7b0209cee9 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Fri, 22 May 2026 09:35:07 +0200 Subject: [PATCH 028/333] feat(aggregation): native MySQL/SQLite bucketing + ad-hoc cache (#1609, #1610) (#1646) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs(openspec): add change add-time-bucket-aggregation Adds the OpenSpec change scaffold proposing an ad-hoc time-bucket aggregation primitive across both REST and GraphQL. - proposal.md: motivates the primitive (every dashboard needs it; openconnector rebuild blocked on it; AggregationQuery.dateBucket already shipped but not wired to Postgres/REST/GraphQL). kind: code, no schema register patches. - design.md: decisions D1-D9 — reuse AggregationQuery, date_trunc native path, field allow-listing via Schema::getProperties(), dedicated /aggregate/timeseries route, GroupByInput on every list query, AggregationRunner::runAdhoc() shared by REST+GraphQL. - specs/aggregation-api/spec.md: new capability for ad-hoc bucketing — validation rules, RBAC integration, Postgres+PHP-fallback contract. - specs/graphql-api/spec.md: delta — adds groupBy/TimeInterval/GroupBucket types + modifies the connection-type requirement. - tasks.md: 6 task groups covering runner, REST, GraphQL, tests, quality gates, and docs. No PR/merge tasks (Hydra coordination owns that). Complementary to the in-flight aggregations-backend-native change which already plumbed dateBucket into Solr+ES translators but not Postgres/REST/ GraphQL. * feat(aggregation): add time-bucket aggregation across REST + GraphQL Implements the `add-time-bucket-aggregation` opsx change: an ad-hoc, client-controlled aggregation primitive that lets dashboards bucket register-schema rows by a field (categorical) or by a `date_trunc` interval with optional `from`/`to` bounds, available on both REST and GraphQL with the same response shape. Why - Every Conduction dashboard chart needs the same primitive ("group rows by day-of-`created` between from and to, return {key, value}"). - openconnector dashboard rebuild (6 charts) was blocked on it. - nextcloud-vue CnChartWidget.dataSource can now grow its `bucket: { field, interval, fromVar, toVar }` shorthand. - AggregationQuery.dateBucket was shipped by aggregations-backend-native but never plumbed to Postgres / REST / GraphQL. Backend - AggregationRunner: extended tryNativeAggregation() with a dateBucket parameter that emits `date_trunc(?, "$field")::text AS bucket` SQL with explicit `WHERE field >= start AND field < end` bounds. ISO week (Monday) + quarter (first-of-Q1-month) computed explicitly to match Postgres semantics. - New public methods runAdhoc(Register, Schema, AggregationQuery) and runAdhocByRef(string, string, AggregationQuery) for the controller / resolver entry points. RBAC + multi-tenant gates inherited from the existing native path. - bucketInPhp() — PHP fallback for non-Postgres DBs (SQLite tests, MySQL dev) with truncateTimestamp() polyfill keyed on the gap vocabulary. backend: "php-fallback" annotated in response. - coerceBucketKey() produces stable Y-m-d\TH:i:s\Z strings across all paths so the wire shape stays identical. REST - New TimeseriesRequestValidator class — separate testable validator shared between REST + GraphQL. Validates field allow-list against Schema::getProperties() + metadata cols (_created, _updated, _deleted_at); validates sub-day intervals (MINUTE / HOUR) require format: date-time; validates interval/from/to/metric/metricField shape; constructs the AggregationQuery via the existing factory. - AggregationController::timeseries(register, schema) action. 400/ 403/404 translation. New route /api/objects/aggregations/{register}/ {schema}/timeseries ordered before the {name} wildcard. GraphQL - TypeMapperHandler grew lazy factories for GroupByInput, TimeInterval enum, AggregationMetric enum, and GroupBucket object type. Each cached on a private property so introspection-cycle and per-request schema generation pay the construction cost once. - getListArgs() gains `groupBy: GroupByInput`; getConnectionType() gains `groups: [GroupBucket!]` (nullable — null = client did not request). - GraphQLResolver::resolveList() now calls resolveGroupBy() when args.groupBy is present. Reuses TimeseriesRequestValidator for the same allow-list + sub-day rules. Validation / RBAC failures surface as GraphQL field-errors on `groups` — the rest of the connection still resolves. Tests - 12 TimeseriesRequestValidatorTest cases covering every spec-defined 400 path. - 5 AggregationControllerTimeseriesTest cases covering 404 / 400 / 403 translations + happy path body parity. - AggregationControllerTest constructor updated to inject the new validator dependency. - Full Unit Tests suite (12 243 tests, 25 991 assertions) green inside the dev container. Quality gates - PHPCS strict — clean on all touched files. - PHPMD — clean (targeted SuppressWarnings on bucketInPhp, resolveList, validate for legitimate branching-density cases). - Psalm — clean. - PHPStan level 8 — clean. Baseline reclassified the existing `string === null` defensive check to `int === null` after refactoring three call sites away from the redundant `instanceof` ternary. Docs - docs/technical/aggregation-api.md covers both surfaces, validation rules, status codes, Postgres index recommendations, and the decision matrix between named-annotation and ad-hoc primitive. - openspec/platform-capabilities.md grew the ad-hoc primitive companion sentence on the aggregations row. Non-goals deferred to issues - #1606 multi-field groupBy - #1607 cumulative / running aggregates - #1608 multi-metric in one request - #1609 native MySQL / SQLite bucketing - #1610 caching ad-hoc queries * feat(aggregation): native MySQL/SQLite bucketing + ad-hoc cache (#1609, #1610) Extends the time-bucket primitive added by #1611 with two of the five deferred follow-ups: - **#1609 — Native MySQL/SQLite bucketing.** `AggregationRunner` now detects MySQL/MariaDB and SQLite alongside PostgreSQL and emits the matching native bucketing expression (`DATE_FORMAT` / `strftime`) with the correct identifier quoting per engine. ISO-Monday week-start semantics carry across all three platforms; quarter buckets use the matching CASE / CONCAT form. Backend annotation reports `mysql` / `sqlite` / `postgres` / `php-fallback`. - **#1610 — Read-through cache for ad-hoc queries.** `AggregationCache` gains `getAdhoc()` / `setAdhoc()` wrappers that derive the cache name slot from `'adhoc:'.sha1(json_encode(AggregationQuery::toArray()))`. `AggregationQuery::toArray()` ksort-sorts filter sub-arrays so two structurally-equivalent queries hash identically. `runAdhoc()` wires the cache read-through; the existing `AggregationCacheInvalidationListener` covers ad-hoc entries unchanged because they share the underlying `openregister_aggregations` distributed cache. The remaining three follow-ups (#1606 multi-field groupBy, #1607 cumulative/rolling windows, #1608 multi-metric) are documented at design depth in `openspec/changes/add-aggregation-enhancements/design.md` so the next pickup can file deliberate opsx cycles for them. Tests cover MySQL/SQLite/Postgres SQL emission per gap (including the `%i` vs `%M` minute placeholder divergence), ad-hoc cache hit/miss semantics, key stability under filter reordering, and ad-hoc vs named cache-entry isolation. --- appinfo/routes.php | 5 +- docs/technical/aggregation-api.md | 171 +++++ lib/Controller/AggregationController.php | 98 ++- lib/Service/Aggregation/AggregationCache.php | 68 ++ lib/Service/Aggregation/AggregationQuery.php | 54 ++ lib/Service/Aggregation/AggregationRunner.php | 707 +++++++++++++++++- .../TimeseriesRequestValidator.php | 266 +++++++ lib/Service/GraphQL/GraphQLResolver.php | 118 ++- .../SchemaGenerator/TypeMapperHandler.php | 184 +++++ .../add-aggregation-enhancements/design.md | 126 ++++ .../add-aggregation-enhancements/proposal.md | 68 ++ .../specs/aggregation-api/spec.md | 88 +++ .../add-aggregation-enhancements/tasks.md | 39 + .../.openspec.yaml | 2 + .../add-time-bucket-aggregation/design.md | 191 +++++ .../add-time-bucket-aggregation/proposal.md | 60 ++ .../specs/aggregation-api/spec.md | 125 ++++ .../specs/graphql-api/spec.md | 154 ++++ .../add-time-bucket-aggregation/tasks.md | 50 ++ openspec/platform-capabilities.md | 2 +- phpstan-baseline.neon | 7 +- .../Controller/AggregationControllerTest.php | 5 +- .../AggregationControllerTimeseriesTest.php | 195 +++++ .../Aggregation/AggregationCacheTest.php | 128 ++++ .../Aggregation/AggregationQueryTest.php | 74 ++ .../AggregationRunnerAdhocCacheTest.php | 228 ++++++ .../AggregationRunnerNativeBucketTest.php | 376 ++++++++++ .../TimeseriesRequestValidatorTest.php | 321 ++++++++ 28 files changed, 3864 insertions(+), 46 deletions(-) create mode 100644 docs/technical/aggregation-api.md create mode 100644 lib/Service/Aggregation/TimeseriesRequestValidator.php create mode 100644 openspec/changes/add-aggregation-enhancements/design.md create mode 100644 openspec/changes/add-aggregation-enhancements/proposal.md create mode 100644 openspec/changes/add-aggregation-enhancements/specs/aggregation-api/spec.md create mode 100644 openspec/changes/add-aggregation-enhancements/tasks.md create mode 100644 openspec/changes/add-time-bucket-aggregation/.openspec.yaml create mode 100644 openspec/changes/add-time-bucket-aggregation/design.md create mode 100644 openspec/changes/add-time-bucket-aggregation/proposal.md create mode 100644 openspec/changes/add-time-bucket-aggregation/specs/aggregation-api/spec.md create mode 100644 openspec/changes/add-time-bucket-aggregation/specs/graphql-api/spec.md create mode 100644 openspec/changes/add-time-bucket-aggregation/tasks.md create mode 100644 tests/Unit/Controller/AggregationControllerTimeseriesTest.php create mode 100644 tests/Unit/Service/Aggregation/AggregationRunnerAdhocCacheTest.php create mode 100644 tests/Unit/Service/Aggregation/AggregationRunnerNativeBucketTest.php create mode 100644 tests/Unit/Service/Aggregation/TimeseriesRequestValidatorTest.php diff --git a/appinfo/routes.php b/appinfo/routes.php index 0bb9a6794674..23693383c3b0 100644 --- a/appinfo/routes.php +++ b/appinfo/routes.php @@ -295,7 +295,10 @@ ['name' => 'transition#transition', 'url' => '/api/objects/{id}/transition', 'verb' => 'POST', 'requirements' => ['id' => '[^/]+']], ['name' => 'transition#availableActions', 'url' => '/api/objects/{id}/available-actions', 'verb' => 'GET', 'requirements' => ['id' => '[^/]+']], - // Aggregations sugar endpoint. + // Aggregations — ad-hoc time-bucket primitive (must be ordered + // BEFORE the {name} wildcard so /timeseries literal matches first). + ['name' => 'aggregation#timeseries', 'url' => '/api/objects/aggregations/{register}/{schema}/timeseries', 'verb' => 'GET'], + // Aggregations sugar endpoint — named annotation surface. ['name' => 'aggregation#aggregate', 'url' => '/api/objects/aggregations/{register}/{schema}/{name}', 'verb' => 'GET'], // Contacts matching API — used by ContactsMenuProvider + mail-sidebar. diff --git a/docs/technical/aggregation-api.md b/docs/technical/aggregation-api.md new file mode 100644 index 000000000000..f219f3259697 --- /dev/null +++ b/docs/technical/aggregation-api.md @@ -0,0 +1,171 @@ +# Aggregation API + +OpenRegister exposes **two** aggregation surfaces. Pick the right one for your use case: + +| Surface | Surface owner | When to use | +|---|---|---| +| **Named declarative** — `x-openregister-aggregations` schema annotation | App author / schema author | KPI tiles, business-rule counts, anything the app owns and ships with its register. Cached for 60s. | +| **Runtime ad-hoc** — REST `/aggregate/timeseries` + GraphQL `groupBy` | Client (per-request) | Dashboard charts, ad-hoc bucketing, "let the user pick a date range". No cache. | + +This page documents the **ad-hoc primitive** (added by the `add-time-bucket-aggregation` change). For the named surface see `x-openregister-aggregations` documentation. + +## When to use each + +The named declarative surface is the right home for behaviours the **schema author** controls — KPIs, counts, business-rule rollups. Those are part of the app's contract and live in `lib/Settings/{app}_register.json`. + +The ad-hoc primitive is the right home for behaviours the **client** controls — the user picks a date range, the dashboard widget picks the bucketing interval, the chart picks the metric. None of that belongs in the schema register; it's request-scoped. + +A rule of thumb: if you'd hard-code the metric and field in the dashboard's source code, use the named surface. If the user gets to pick them at runtime, use the ad-hoc surface. + +## REST surface + +### Endpoint + +``` +GET /api/objects/aggregations/{register}/{schema}/timeseries +``` + +### Query parameters + +| Param | Required | Notes | +|---|---|---| +| `field` | yes | The field to group / bucket on. MUST be a declared property of `{schema}` OR one of `_created`, `_updated`, `_deleted_at`. | +| `interval` | no | One of `MINUTE`, `HOUR`, `DAY`, `WEEK`, `MONTH`, `QUARTER`, `YEAR`. When set, the field is time-bucketed via Postgres `date_trunc()`. When absent, the field is grouped categorically. | +| `from` | required when `interval` set | ISO-8601 lower bound, inclusive. | +| `to` | required when `interval` set | ISO-8601 upper bound, exclusive. | +| `metric` | no | One of `count`, `sum`, `avg`, `min`, `max`. Default `count`. | +| `metricField` | required when `metric != count` | Field to aggregate over. MUST be a declared schema property. | +| `filter[...]` | no | Reuses the existing object-collection filter vocabulary (`filter[status]=active`, `filter[duration][gte]=10`). | + +### Sub-day intervals require date-time fields + +Bucketing by `MINUTE` or `HOUR` requires the field's JSON-Schema `format` to be `date-time` (not `date`). A `date`-only field can only be bucketed by `DAY`, `WEEK`, `MONTH`, `QUARTER`, or `YEAR`. The endpoint returns `400 Bad Request` if the constraint is violated. + +### Response shape + +```json +{ + "groups": [ + { "key": "2026-05-21T00:00:00Z", "value": 42 }, + { "key": "2026-05-22T00:00:00Z", "value": 17 } + ], + "backend": "postgres", + "cached": false +} +``` + +- `key`: bucket label. For `interval`-bucketed queries this is an ISO-8601-UTC string at the start of the bucket. For categorical groupBy it's the value of the groupBy field. +- `value`: the aggregated metric (always a number; an integer for `count`, a float for other metrics). +- `backend`: which engine served the query — `"postgres"` (native `date_trunc`), `"mysql"` (native `DATE_FORMAT`), `"sqlite"` (native `strftime`), or `"php-fallback"` (unrecognised engine). +- `cached`: `true` on a read-through cache hit, `false` on miss or the first request after invalidation. See [Cache](#cache) below. + +### Empty buckets + +Buckets with zero rows are **omitted** from the response — `GROUP BY` does not emit empty groups. The client fills empties at render time. See [issue #1607](https://github.com/ConductionNL/openregister/issues/1607) for cumulative / windowed series. + +### Status codes + +| Code | When | +|---|---| +| `200` | Happy path. | +| `400` | Validation failure (unknown field, bad interval, missing bounds, etc.). | +| `403` | Caller lacks `list` permission on the schema. | +| `404` | Register or schema not found. | + +### Example + +```bash +curl -s 'http://localhost:8080/index.php/apps/openregister/api/objects/aggregations/openconnector/calllogs/timeseries?field=created&interval=DAY&from=2026-05-01T00:00:00Z&to=2026-05-22T00:00:00Z' \ + -u admin:admin \ + -H 'OCS-APIRequest: true' \ + | jq . +``` + +## GraphQL surface + +Every auto-generated list query accepts an optional `groupBy: GroupByInput` argument. When supplied, the connection result includes a non-null `groups: [GroupBucket!]` field. + +### Types (auto-generated) + +```graphql +input GroupByInput { + field: String! + interval: TimeInterval + from: String # required when interval is set + to: String # required when interval is set + metric: AggregationMetric = COUNT + metricField: String # required when metric != COUNT +} + +enum TimeInterval { MINUTE HOUR DAY WEEK MONTH QUARTER YEAR } +enum AggregationMetric { COUNT SUM AVG MIN MAX } +type GroupBucket { key: String! value: Float! } +``` + +### Example query + +```graphql +query CallsPerDay { + calllogs( + filter: { status: "error" } + groupBy: { + field: "created" + interval: DAY + from: "2026-05-01T00:00:00Z" + to: "2026-05-22T00:00:00Z" + } + ) { + totalCount + groups { + key + value + } + } +} +``` + +`totalCount` is the size of the filtered set; the sum of `groups[*].value` equals `totalCount` when `metric: COUNT`. + +When the client does not request `groupBy`, the `groups` field is `null` (not an empty array — `null` means "no aggregation requested"). + +### Validation errors + +Validation problems surface as GraphQL field-errors on the `groups` field. The rest of the connection (edges, pageInfo, totalCount, facets) still resolves normally. + +## Backend matrix + +The runner picks the matching native bucketing primitive for the active database engine and falls back to PHP only on engines OpenRegister doesn't natively target. + +| Database | Bucketing path | `backend` field | +|---|---|---| +| PostgreSQL | `date_trunc($gap, "$field")::text` | `postgres` | +| MySQL / MariaDB | `DATE_FORMAT("$field", '')` (ISO-Monday week-start; `CONCAT(YEAR, ..., '-01T00:00:00Z')` for quarter) | `mysql` | +| SQLite | `strftime('', "$field")` (ISO-Monday via `weekday 0` + `-6 days`; `CASE` on `strftime('%m')` for quarter) | `sqlite` | +| Other / unknown | RBAC-filtered hydrate + PHP `date_trunc` polyfill (`gmdate`) | `php-fallback` | + +All four paths emit identical wire shape: ISO-8601-UTC bucket keys (`Y-m-d\TH:i:s\Z`), the same `groups[i].value` coercion (int for `count`, float otherwise), and the same RBAC + multi-tenancy gate. The `backend` field lets a caller observe which engine served the request without changing how the response is consumed. + +## Cache + +Ad-hoc results are served via a 60-second distributed cache: + +- **Storage**: same `openregister_aggregations` distributed cache the named-aggregation path uses (`AggregationCache`). +- **Read-through**: on entry to `runAdhoc()`, the runner derives the key from `(registerSlug, schemaSlug, sha1(json_encode($query->toArray())), filter, rbacScopeHash)`, prefixed with `adhoc:`. A hit returns the stored envelope with `cached: true`; a miss falls through to the native-or-fallback dispatch and the resulting envelope is written back. +- **Key stability**: `AggregationQuery::toArray()` ksort-sorts the filter map (recursively, into operator sub-arrays), so `filter[a, b]` and `filter[b, a]` produce identical cache keys. +- **RBAC scoping**: the key includes `sha1(uid)` (or `sha1('anonymous')`) so two callers with different list-permission verdicts on the same `(metric, field, filter)` tuple never read each other's results. +- **Invalidation**: `AggregationCacheInvalidationListener` evicts the entire `(register, schema)` cache on every `ObjectCreatedEvent`, `ObjectUpdatedEvent`, `ObjectDeletedEvent`, and `ObjectTransitionedEvent`. The eviction is coarse (`ICache::clear()` flushes the whole `openregister_aggregations` namespace) but bounded by the 60-second TTL ceiling on missed evicts. +- **Stampede tolerance**: no distributed lock — the 60-second TTL bounds duplicate-miss compute. Revisit if a high-traffic dashboard surfaces stampede symptoms in production. + +## Performance notes + +- **Database index**: for any field commonly used as a bucketing target (`created`, `updated`, custom date columns), declare a btree index on the magic-table column. The native bucketing expression operates against an indexed column on every supported engine, so the cost stays in the database where it belongs. +- **Row-level RBAC**: the multi-tenant predicate (`_organisation = ?`) and the schema's `PermissionHandler::canRead()` verdict both apply BEFORE bucketing. Aggregations cannot leak rows the caller could not read row-by-row. +- **PHP fallback ceiling**: the PHP-fallback path on unrecognised engines caps the hydrated row set at 10 000 and sets `truncated: true` when exceeded. Native paths (Postgres / MySQL / SQLite) operate over the full set in SQL. + +## Non-goals (deferred) + +| Topic | Issue | +|---|---| +| Multi-field groupBy (`groupBy: [status, priority]`) | [#1606](https://github.com/ConductionNL/openregister/issues/1606) | +| Running / cumulative series | [#1607](https://github.com/ConductionNL/openregister/issues/1607) | +| Multi-metric in one request (`count` + `sum`) | [#1608](https://github.com/ConductionNL/openregister/issues/1608) | diff --git a/lib/Controller/AggregationController.php b/lib/Controller/AggregationController.php index d343f422c105..0e260f0f59ce 100644 --- a/lib/Controller/AggregationController.php +++ b/lib/Controller/AggregationController.php @@ -3,11 +3,27 @@ /** * OpenRegister AggregationController * - * Sugar HTTP entry point for the x-openregister-aggregations annotation. + * HTTP entry point for the two aggregation surfaces OR exposes: + * + * - {@see aggregate()} — named-annotation surface backed by the + * `x-openregister-aggregations` block on a schema. Schema-author + * declared, immutable per release. Original surface. + * - {@see timeseries()} — ad-hoc surface where the client supplies + * the field, optional bucketing interval, and bounds at request + * time. Added by `add-time-bucket-aggregation`. Backs the + * nextcloud-vue `CnChartWidget.dataSource` bucket shorthand. + * + * Both paths share `AggregationRunner` for RBAC + multi-tenant + * gating + Postgres / fallback dispatch. The ad-hoc path does not + * consult `AggregationCache` (its key shape is keyed on the named + * annotation — extending it is tracked in issue #1610). * * @category Controller * @package OCA\OpenRegister\Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @author Conduction Development Team * @copyright 2026 Conduction B.V. * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 @@ -21,8 +37,10 @@ namespace OCA\OpenRegister\Controller; +use InvalidArgumentException; use OCA\OpenRegister\Exception\NotAuthorizedException; use OCA\OpenRegister\Service\Aggregation\AggregationRunner; +use OCA\OpenRegister\Service\Aggregation\TimeseriesRequestValidator; use OCP\AppFramework\Controller; use OCP\AppFramework\Http; use OCP\AppFramework\Http\JSONResponse; @@ -34,14 +52,16 @@ class AggregationController extends Controller /** * Constructor. * - * @param string $appName The application name. - * @param IRequest $request The current request. - * @param AggregationRunner $runner The aggregation runner. + * @param string $appName The application name. + * @param IRequest $request The current request. + * @param AggregationRunner $runner The aggregation runner. + * @param TimeseriesRequestValidator $validator Ad-hoc request validator. */ public function __construct( string $appName, IRequest $request, - private readonly AggregationRunner $runner + private readonly AggregationRunner $runner, + private readonly TimeseriesRequestValidator $validator ) { parent::__construct(appName: $appName, request: $request); }//end __construct() @@ -82,4 +102,72 @@ public function aggregate(string $register, string $schema, string $name): JSONR ); return $response; }//end aggregate() + + /** + * Ad-hoc time-bucket aggregation entry point. + * + * Accepts query params: + * - field (required) + * - interval (optional — MINUTE|HOUR|DAY|WEEK|MONTH|QUARTER|YEAR) + * - from, to (required when interval set; ISO-8601) + * - metric (optional, default `count`) + * - metricField (required when metric != count) + * - filter[...] (optional, reuses the existing filter vocabulary) + * + * Returns `{ groups: [{ key, value }], backend, cached }` matching the + * GraphQL `groups` field shape so `CnChartWidget` can normalise once. + * + * @param string $register Register reference. + * @param string $schema Schema reference. + * + * @return JSONResponse JSON response with bucketed groups. + * + * @NoAdminRequired + * @NoCSRFRequired + */ + public function timeseries(string $register, string $schema): JSONResponse + { + // Resolve schema first so the validator can consult the + // declared property list. A missing schema is a 404; a bad + // query-param shape is a 400. + try { + $schemaEntity = $this->runner->findSchema(schemaRef: $schema); + } catch (RuntimeException $e) { + return new JSONResponse(['error' => $e->getMessage()], Http::STATUS_NOT_FOUND); + } + + // Pull the request shape from the active IRequest. The filter + // map comes through as a nested array because PHP parses + // `filter[x][op]=y` into `$_GET['filter']['x']['op']='y'`. + $input = [ + 'field' => $this->request->getParam('field', ''), + 'interval' => $this->request->getParam('interval'), + 'from' => $this->request->getParam('from'), + 'to' => $this->request->getParam('to'), + 'metric' => $this->request->getParam('metric', 'count'), + 'metricField' => $this->request->getParam('metricField'), + 'filter' => (array) ($this->request->getParam('filter', [])), + ]; + + try { + $query = $this->validator->validate(input: $input, schema: $schemaEntity); + } catch (InvalidArgumentException $e) { + return new JSONResponse(['error' => $e->getMessage()], Http::STATUS_BAD_REQUEST); + } + + try { + $result = $this->runner->runAdhocByRef( + registerRef: $register, + schemaRef: $schema, + query: $query + ); + } catch (NotAuthorizedException $e) { + return new JSONResponse(['error' => $e->getMessage()], Http::STATUS_FORBIDDEN); + } catch (RuntimeException $e) { + return new JSONResponse(['error' => $e->getMessage()], Http::STATUS_NOT_FOUND); + } + + return new JSONResponse($result); + + }//end timeseries() }//end class diff --git a/lib/Service/Aggregation/AggregationCache.php b/lib/Service/Aggregation/AggregationCache.php index 246efc09c983..f68c367f43f8 100644 --- a/lib/Service/Aggregation/AggregationCache.php +++ b/lib/Service/Aggregation/AggregationCache.php @@ -152,6 +152,74 @@ public function set(string $registerSlug, string $schemaSlug, string $name, arra } }//end set() + /** + * Look up a cached ad-hoc aggregation result. + * + * Mirrors {@see get()} but derives the name slot from the query value + * object. The literal `adhoc:` prefix keeps ad-hoc entries visually + * distinct from named-aggregation entries in cache dumps. + * + * @param string $registerSlug Register slug component of the cache key. + * @param string $schemaSlug Schema slug component of the cache key. + * @param AggregationQuery $query Query value object hashed into the cache key. + * + * @return array|null Cached envelope or null on miss. + */ + public function getAdhoc(string $registerSlug, string $schemaSlug, AggregationQuery $query): ?array + { + return $this->get( + registerSlug: $registerSlug, + schemaSlug: $schemaSlug, + name: $this->adhocName(query: $query), + filter: $query->filter + ); + + }//end getAdhoc() + + /** + * Store an ad-hoc aggregation result. + * + * Mirrors {@see set()} for the ad-hoc path. The stored envelope is + * rewritten on read (`cached: true`) by callers — see + * {@see \OCA\OpenRegister\Service\Aggregation\AggregationRunner::runAdhoc()}. + * + * @param string $registerSlug Register slug component of the cache key. + * @param string $schemaSlug Schema slug component of the cache key. + * @param AggregationQuery $query Query value object hashed into the cache key. + * @param array $result Result envelope to store. + * + * @return void + */ + public function setAdhoc(string $registerSlug, string $schemaSlug, AggregationQuery $query, array $result): void + { + $this->set( + registerSlug: $registerSlug, + schemaSlug: $schemaSlug, + name: $this->adhocName(query: $query), + filter: $query->filter, + result: $result + ); + + }//end setAdhoc() + + /** + * Derive the cache name slot for an ad-hoc query. + * + * Computes `'adhoc:'.sha1(json_encode($query->toArray()))`. The + * `AggregationQuery::toArray()` output is ksort-stable so two + * structurally-equivalent queries produce identical hashes. + * + * @param AggregationQuery $query The ad-hoc query value object. + * + * @return string The cache name slot, prefixed with `adhoc:`. + */ + private function adhocName(AggregationQuery $query): string + { + $encoded = json_encode($query->toArray()); + return 'adhoc:'.sha1($encoded === false ? '' : $encoded); + + }//end adhocName() + /** * Evict every cached aggregation for a (register, schema). Called by * the object-write listeners. diff --git a/lib/Service/Aggregation/AggregationQuery.php b/lib/Service/Aggregation/AggregationQuery.php index 4c29a1bddbaa..50d60a76d82d 100644 --- a/lib/Service/Aggregation/AggregationQuery.php +++ b/lib/Service/Aggregation/AggregationQuery.php @@ -215,4 +215,58 @@ public function hasDateBucket(): bool return ($this->dateBucket !== null); }//end hasDateBucket() + + /** + * Serialise the query to a stable associative array. + * + * The output is the canonical input to the ad-hoc aggregation cache + * key (see {@see AggregationCache::getAdhoc()}). Filter sub-arrays are + * recursively ksort-sorted so two structurally-equivalent queries + * produce identical JSON encodings — `{a: 1, b: 2}` and `{b: 2, a: 1}` + * hash to the same cache key. + * + * @return array{ + * metric: string, + * field: ?string, + * filter: array, + * groupBy: array|null, + * dateBucket: array|null + * } Canonical wire shape of the query. + */ + public function toArray(): array + { + return [ + 'metric' => $this->metric, + 'field' => $this->field, + 'filter' => self::canonicaliseFilter(filter: $this->filter), + 'groupBy' => $this->groupBy, + 'dateBucket' => $this->dateBucket, + ]; + + }//end toArray() + + /** + * Recursively ksort the filter map. + * + * Operator sub-arrays (e.g. `{gt: 5, lte: 10}`) get the same treatment + * so the resulting JSON encoding is stable across input orderings. + * + * @param array $filter Filter map to canonicalise. + * + * @return array Sorted filter map. + */ + private static function canonicaliseFilter(array $filter): array + { + ksort($filter); + foreach ($filter as $key => $value) { + if (is_array($value) === true) { + $sub = $value; + ksort($sub); + $filter[$key] = $sub; + } + } + + return $filter; + + }//end canonicaliseFilter() }//end class diff --git a/lib/Service/Aggregation/AggregationRunner.php b/lib/Service/Aggregation/AggregationRunner.php index eb5fafe8b34d..f2419c0d5844 100644 --- a/lib/Service/Aggregation/AggregationRunner.php +++ b/lib/Service/Aggregation/AggregationRunner.php @@ -49,6 +49,12 @@ * @SuppressWarnings(PHPMD.ExcessiveClassComplexity) * @SuppressWarnings(PHPMD.CouplingBetweenObjects) * @SuppressWarnings(PHPMD.ExcessiveClassLength) + * @SuppressWarnings(PHPMD.TooManyMethods) + * The runner orchestrates four execution paths (named / cross-schema / + * ad-hoc / cached) across three backends (Postgres / MySQL / SQLite + + * PHP fallback). The method count rises with each platform-specific + * helper; extracting them into a separate class would require passing + * the full constructor dependency graph through. */ class AggregationRunner { @@ -343,7 +349,9 @@ public function run( $rows = []; foreach ($objects as $entity) { - $rows[] = $entity instanceof \OCA\OpenRegister\Db\ObjectEntity ? $entity->getObject() : (array) $entity; + // The findAllInRegisterSchemaTable mapper returns ObjectEntity[]; + // getObject() resolves each row to the inner data array. + $rows[] = $entity->getObject(); } // Apply post-filter for operator shapes the underlying mapper @@ -382,6 +390,368 @@ public function run( return $result; }//end run() + /** + * Execute an ad-hoc aggregation query — REST + GraphQL entry point. + * + * Where {@see run()} loads a named aggregation from the schema's + * `x-openregister-aggregations` annotation and executes it, this + * method takes a fully-built `AggregationQuery` value object from + * the caller (the REST `/aggregate/timeseries` controller or the + * GraphQL `groupBy` resolver) and runs it directly against the + * register/schema's magic table. + * + * The execution pipeline is the same as `run()`: + * + * 1. RBAC gate via `PermissionHandler::hasPermission(list)`. + * 2. Read-through cache lookup via `AggregationCache::getAdhoc()` — + * cache key derives from `sha1(json_encode($query->toArray()))` + * prefixed with `adhoc:`. 60 s TTL. Invalidated on every + * object lifecycle event by `AggregationCacheInvalidationListener`. + * 3. Postgres / MySQL / SQLite native fast path via + * `tryNativeAggregation()` — picks the matching bucketing + * expression (`date_trunc` / `DATE_FORMAT` / `strftime`). + * 4. PHP fallback bucketing when the native path returns null + * (unrecognised engine, table miss, etc). + * + * Field allow-listing (only declared schema properties + the + * `_created/_updated/_deleted_at` magic-table metadata cols) is + * the caller's responsibility (REST controller / GraphQL resolver) + * because the relevant 400-error message lives at that layer. + * + * @param Register $register The register the schema belongs to. + * @param Schema $schema The schema being aggregated. + * @param AggregationQuery $query The fully-validated query value object. + * + * @return array Either `{value, backend, cached}` (ungrouped) + * or `{groups, backend, cached}` (grouped / + * time-bucketed). `cached` flips to `true` + * on the second identical request within + * the 60 s TTL window. + * + * @throws NotAuthorizedException When the caller lacks list-permission on the schema. + * + * @SuppressWarnings(PHPMD.ExcessiveMethodLength) + * RBAC + placeholder-resolve + cache-read + native-or-fallback dispatch + + * cache-write. Splitting each step into its own helper would obscure + * the order of operations that matters for the security gate and + * cache semantics. + * @SuppressWarnings(PHPMD.StaticAccess) + * `AggregationQuery::create()` is a fail-fast static factory. + */ + public function runAdhoc( + Register $register, + Schema $schema, + AggregationQuery $query + ): array { + // RBAC gate — identical predicate to run(). + $userId = $this->userSession->getUser()?->getUID(); + if ($this->permissionHandler->hasPermission( + schema: $schema, + action: 'list', + userId: $userId, + objectOwner: null, + _rbac: true, + object: null + ) === false + ) { + throw new NotAuthorizedException( + message: sprintf( + 'You do not have permission to aggregate schema "%s".', + (string) $schema->getSlug() + ) + ); + } + + // Resolve placeholders inside the filter (e.g. $now, $startOfMonth) + // so the native SQL path can bind concrete values. The resolved + // filter feeds both the cache key and the SQL bindings. + $resolvedFilter = $this->placeholders->resolveArray($query->filter); + $resolvedQuery = AggregationQuery::create( + metric: $query->metric, + field: $query->field, + filter: $resolvedFilter, + groupBy: $query->groupBy, + dateBucket: $query->dateBucket + ); + + // Read-through cache. Identical query + filter + RBAC scope → + // same cache key → 60 s TTL hit. Cache miss falls through to the + // native-or-fallback dispatch below and the result is stored on + // the way out. Invalidation is event-driven via + // AggregationCacheInvalidationListener which evicts the entire + // `openregister_aggregations` cache on every object-write event. + $cached = $this->cache->getAdhoc( + registerSlug: (string) $register->getSlug(), + schemaSlug: (string) $schema->getSlug(), + query: $resolvedQuery + ); + if ($cached !== null) { + $cached['cached'] = true; + return $cached; + } + + // Try the Postgres / MySQL / SQLite native fast path. The runner + // detects the database platform and emits the matching native + // bucketing expression (date_trunc / DATE_FORMAT / strftime). + // Returns null on unsupported query shapes or unrecognised + // engines, signaling fall-through to the PHP bucketer below. + $native = $this->tryNativeAggregation( + register: $register, + schema: $schema, + metric: $query->metric, + field: $query->field, + filter: $resolvedFilter, + groupBy: $query->groupBy, + dateBucket: $query->dateBucket + ); + + if ($native !== null) { + $envelope = [ + 'backend' => $this->detectDatabasePlatform(), + 'cached' => false, + ] + $native; + $this->cache->setAdhoc( + registerSlug: (string) $register->getSlug(), + schemaSlug: (string) $schema->getSlug(), + query: $resolvedQuery, + result: $envelope + ); + return $envelope; + } + + // PHP fallback path. Pull the RBAC-filtered row set + bucket in + // PHP. Correctness path; the native paths above are the + // production target. + $envelope = $this->bucketInPhp( + register: $register, + schema: $schema, + metric: $query->metric, + field: $query->field, + filter: $resolvedFilter, + groupBy: $query->groupBy, + dateBucket: $query->dateBucket + ); + $this->cache->setAdhoc( + registerSlug: (string) $register->getSlug(), + schemaSlug: (string) $schema->getSlug(), + query: $resolvedQuery, + result: $envelope + ); + return $envelope; + + }//end runAdhoc() + + /** + * Convenience: run an ad-hoc aggregation by register/schema ref. + * + * Mirrors {@see run()}'s ref-based call shape but for the ad-hoc + * path. Lets the REST controller call without re-implementing the + * mapper-lookup glue. + * + * @param string $registerRef Register slug/uuid/id. + * @param string $schemaRef Schema slug/uuid/id. + * @param AggregationQuery $query The fully-validated query. + * + * @return array Result envelope (see runAdhoc()). + * + * @throws RuntimeException When the register or schema cannot be resolved. + * @throws NotAuthorizedException When the caller lacks list-permission. + */ + public function runAdhocByRef( + string $registerRef, + string $schemaRef, + AggregationQuery $query + ): array { + $schema = $this->loadSchema(schemaRef: $schemaRef); + $register = $this->loadRegister(registerRef: $registerRef); + + return $this->runAdhoc(register: $register, schema: $schema, query: $query); + + }//end runAdhocByRef() + + /** + * Convenience: load a schema by ref. Public surface to let the + * REST controller validate field allow-lists against + * `Schema::getProperties()` before constructing the AggregationQuery + * (we want a 400 from the validation layer, not a 404 from inside + * runAdhocByRef()). + * + * @param string $schemaRef Schema slug/uuid/id. + * + * @return Schema The loaded schema. + * + * @throws RuntimeException When the schema can't be found. + */ + public function findSchema(string $schemaRef): Schema + { + return $this->loadSchema(schemaRef: $schemaRef); + + }//end findSchema() + + /** + * PHP fallback bucketer for non-Postgres databases (SQLite tests, + * MySQL dev boxes). + * + * Pulls the RBAC-filtered row set via MagicMapper, applies the + * filter clauses the native path would emit as SQL, then groups in + * PHP using either the categorical groupBy field OR the dateBucket + * gap polyfill (`strtotime` + `gmdate`). + * + * Marked `backend: "php-fallback"` in the response so callers know + * the query did not hit a native engine. + * + * @param Register $register Register. + * @param Schema $schema Schema. + * @param string $metric One of count/sum/avg/min/max. + * @param string|null $field Metric field (null for count). + * @param array $filter Already placeholder-resolved filter map. + * @param array|null $groupBy Optional categorical groupBy spec. + * @param array|null $dateBucket Optional time-bucket spec. + * + * @return array Either `{value, backend, cached}` or + * `{groups, backend, cached}` mirroring the + * Postgres native-path shape. + * + * @SuppressWarnings(PHPMD.CyclomaticComplexity) + * The branching mirrors the Postgres SQL path: dateBucket vs. + * groupBy vs. ungrouped, each with the metric / filter pipeline. + * @SuppressWarnings(PHPMD.NPathComplexity) + */ + private function bucketInPhp( + Register $register, + Schema $schema, + string $metric, + ?string $field, + array $filter, + ?array $groupBy, + ?array $dateBucket + ): array { + $objects = $this->magicMapper->findAllInRegisterSchemaTable( + register: $register, + schema: $schema, + limit: self::PHP_FALLBACK_ROW_CAP + ); + + $rows = []; + foreach ($objects as $entity) { + // The findAllInRegisterSchemaTable mapper returns ObjectEntity[]; + // getObject() resolves each row to the inner data array. + $rows[] = $entity->getObject(); + } + + // Apply the filter clauses in PHP — same operator vocabulary + // (in / gt / gte / lt / lte / ne) as the SQL path. + $rows = $this->applyFilter(rows: $rows, filter: $filter); + + if ($dateBucket !== null) { + // Restrict to rows whose bucket field falls in [start, end). + $bucketField = (string) $dateBucket['field']; + $start = strtotime((string) $dateBucket['start']); + $end = strtotime((string) $dateBucket['end']); + $gap = (string) $dateBucket['gap']; + $buckets = []; + + foreach ($rows as $row) { + $raw = ($row[$bucketField] ?? null); + if ($raw === null) { + continue; + } + + $stamp = is_numeric($raw) === true ? (int) $raw : strtotime((string) $raw); + if ($stamp === false || $stamp < $start || $stamp >= $end) { + continue; + } + + $key = $this->truncateTimestamp(timestamp: $stamp, gap: $gap); + $buckets[$key] ??= []; + $buckets[$key][] = $row; + } + + // Compute the metric per bucket. + $groups = []; + ksort($buckets); + foreach ($buckets as $key => $bucketRows) { + $groups[] = [ + 'key' => $key, + 'value' => $this->computeMetric(rows: $bucketRows, metric: $metric, field: $field), + ]; + } + + return [ + 'groups' => $groups, + 'backend' => 'php-fallback', + 'cached' => false, + ]; + }//end if + + if ($groupBy !== null && isset($groupBy['field']) === true) { + $groups = $this->computeGrouped( + rows: $rows, + metric: $metric, + field: $field, + groupField: (string) $groupBy['field'] + ); + + return [ + 'groups' => $groups, + 'backend' => 'php-fallback', + 'cached' => false, + ]; + } + + return [ + 'value' => $this->computeMetric(rows: $rows, metric: $metric, field: $field), + 'backend' => 'php-fallback', + 'cached' => false, + ]; + + }//end bucketInPhp() + + /** + * Polyfill for Postgres `date_trunc($gap, ts)::text` over a Unix + * timestamp. Returns an ISO-8601-UTC `Y-m-d\TH:i:s\Z` bucket label + * keyed at the start of the gap. + * + * @param int $timestamp Unix timestamp. + * @param string $gap One of AggregationQuery::DATE_BUCKET_GAPS. + * + * @return string ISO-8601-UTC bucket label at the gap-start. + */ + private function truncateTimestamp(int $timestamp, string $gap): string + { + // `week` and `quarter` need bespoke handling below — the rest + // map directly to a gmdate format string. + $format = match ($gap) { + 'minute' => 'Y-m-d\TH:i:00\Z', + 'hour' => 'Y-m-d\TH:00:00\Z', + 'day' => 'Y-m-d\T00:00:00\Z', + 'week' => null, + 'month' => 'Y-m-01\T00:00:00\Z', + 'quarter' => null, + 'year' => 'Y-01-01\T00:00:00\Z', + default => 'Y-m-d\T00:00:00\Z', + }; + + if ($gap === 'week') { + // ISO week starts Monday. Use gmdate('N') to find the day of + // the week then back-shift. + $dayOfWeek = (int) gmdate('N', $timestamp); + $weekStartTs = ($timestamp - (($dayOfWeek - 1) * 86400)); + return gmdate('Y-m-d\T00:00:00\Z', $weekStartTs); + } + + if ($gap === 'quarter') { + // Truncate to the first month of the quarter. + $month = (int) gmdate('n', $timestamp); + $qStart = ((int) (($month - 1) / 3) * 3) + 1; + $year = (int) gmdate('Y', $timestamp); + return sprintf('%04d-%02d-01T00:00:00Z', $year, $qStart); + } + + return gmdate($format, $timestamp); + + }//end truncateTimestamp() + /** * Compute a single scalar metric over the given rows. * @@ -620,18 +990,28 @@ private function normaliseForCompare(mixed $v): mixed * Returns the result fragment ('value' or 'groups') on success, null * to signal the caller should fall back to PHP-side aggregation. * - * @param Register $register Register the schema belongs to. - * @param Schema $schema Schema being aggregated. - * @param string $metric Metric name (count/sum/avg/min/max). - * @param string|null $field Field to aggregate over (ignored for count). - * @param array $filter Already placeholder-resolved filter map. - * @param array|null $groupBy Optional group spec ({field: ...}). + * @param Register $register Register the schema belongs to. + * @param Schema $schema Schema being aggregated. + * @param string $metric Metric name (count/sum/avg/min/max). + * @param string|null $field Field to aggregate over (ignored for count). + * @param array $filter Already placeholder-resolved filter map. + * @param array|null $groupBy Optional group spec ({field: ...}). + * @param array|null $dateBucket Optional time-bucket spec ({field, start, end, gap}). + * When supplied, the query becomes a `date_trunc`-bucketed + * series with explicit `WHERE field >= start AND field < end` + * bounds. Mutually exclusive with $groupBy (validated by + * AggregationQuery::create() upstream). * * @return array{value: int|float|null}|array{groups: array}|null * * @SuppressWarnings(PHPMD.CyclomaticComplexity) * @SuppressWarnings(PHPMD.NPathComplexity) * @SuppressWarnings(PHPMD.ExcessiveMethodLength) + * @SuppressWarnings(PHPMD.ElseExpression) + * The platform-branch is genuinely binary (postgres vs non-postgres + * for both the soft-delete predicate and the aggregate-cast block, + * mysql vs sqlite for the bucket expression). Else clauses make + * the mutual-exclusion read at the call site. */ private function tryNativeAggregation( Register $register, @@ -639,10 +1019,21 @@ private function tryNativeAggregation( string $metric, ?string $field, array $filter, - ?array $groupBy + ?array $groupBy, + ?array $dateBucket=null ): ?array { - $platform = $this->db->getDatabasePlatform(); - if (stripos($platform::class, 'PostgreSQL') === false) { + $platformName = $this->detectDatabasePlatform(); + + // Postgres handles every query shape natively. MySQL and SQLite + // currently support only the time-bucket path; the categorical + // groupBy + ungrouped paths still depend on Postgres-specific + // operators (`::jsonb`, `::numeric`) and fall through to the PHP + // fallback on non-Postgres engines. + if ($platformName === 'unknown') { + return null; + } + + if ($platformName !== 'postgres' && $dateBucket === null) { return null; } @@ -674,11 +1065,20 @@ private function tryNativeAggregation( return null; } - $fullTable = '"oc_'.$tableName.'"'; - - $whereParts = ["(_deleted IS NULL OR _deleted = 'null'::jsonb)"]; + $quote = $this->identifierQuote(platform: $platformName); + $fullTable = $quote.'oc_'.$tableName.$quote; + $whereParts = []; $bindings = []; + // Soft-delete predicate. Postgres uses jsonb; MySQL/SQLite store + // the metadata cols as JSON-string text where the empty/null marker + // is the literal string 'null' or actual NULL. + if ($platformName === 'postgres') { + $whereParts[] = "(_deleted IS NULL OR _deleted = 'null'::jsonb)"; + } else { + $whereParts[] = "(_deleted IS NULL OR _deleted = 'null' OR _deleted = '')"; + } + // SECURITY: mirror MagicRbacHandler's multi-tenancy predicate. The // native fast path bypasses MagicMapper entirely, so without this // filter any authed caller could compute aggregates over rows in @@ -686,13 +1086,13 @@ private function tryNativeAggregation( // Column is `_organisation` — magic tables prefix metadata cols // with `_` (see MagicMapper::METADATA_PREFIX). $activeOrg = $this->organisationService->getActiveOrganisation(); - $whereParts[] = '"_organisation" = ?'; + $whereParts[] = $quote.'_organisation'.$quote.' = ?'; $bindings[] = $activeOrg?->getUuid() ?? '__no_active_org__'; foreach ($filter as $f => $v) { $col = $this->sanitizeColumnName(name: (string) $f); if (is_array($v) === false) { - $whereParts[] = '"'.$col.'" = ?'; + $whereParts[] = $quote.$col.$quote.' = ?'; $bindings[] = $this->bindValue(value: $v); continue; } @@ -708,7 +1108,7 @@ private function tryNativeAggregation( } $placeholders = implode(', ', array_fill(0, count($list), '?')); - $whereParts[] = '"'.$col.'" IN ('.$placeholders.')'; + $whereParts[] = $quote.$col.$quote.' IN ('.$placeholders.')'; foreach ($list as $item) { $bindings[] = $this->bindValue(value: $item); } @@ -729,24 +1129,102 @@ private function tryNativeAggregation( continue; } - $whereParts[] = '"'.$col.'" '.$sqlOp.' ?'; + $whereParts[] = $quote.$col.$quote.' '.$sqlOp.' ?'; $bindings[] = $this->bindValue(value: $opValue); }//end foreach }//end foreach $whereSql = implode(' AND ', $whereParts); - // Aggregate clause. - $aggCol = $field !== null ? '"'.$this->sanitizeColumnName(name: $field).'"' : null; - $aggSql = match ($metric) { - 'count' => 'COUNT(*)', - 'sum' => 'SUM(NULLIF('.$aggCol.'::text, \'\')::numeric)', - 'avg' => 'AVG(NULLIF('.$aggCol.'::text, \'\')::numeric)', - 'min' => 'MIN(NULLIF('.$aggCol.'::text, \'\')::numeric)', - 'max' => 'MAX(NULLIF('.$aggCol.'::text, \'\')::numeric)', - }; + // Aggregate clause. Postgres needs explicit `::numeric` casts because + // magic-table data columns are jsonb-shaped. MySQL/SQLite handle the + // implicit conversion in the engine. NULLIF guards against empty + // strings produced by jsonb-to-text casts. + $aggCol = null; + if ($field !== null) { + $aggCol = $quote.$this->sanitizeColumnName(name: $field).$quote; + } + + if ($platformName === 'postgres') { + $aggSql = match ($metric) { + 'count' => 'COUNT(*)', + 'sum' => 'SUM(NULLIF('.$aggCol.'::text, \'\')::numeric)', + 'avg' => 'AVG(NULLIF('.$aggCol.'::text, \'\')::numeric)', + 'min' => 'MIN(NULLIF('.$aggCol.'::text, \'\')::numeric)', + 'max' => 'MAX(NULLIF('.$aggCol.'::text, \'\')::numeric)', + }; + } else { + $aggSql = match ($metric) { + 'count' => 'COUNT(*)', + 'sum' => 'SUM(NULLIF('.$aggCol.', \'\') + 0)', + 'avg' => 'AVG(NULLIF('.$aggCol.', \'\') + 0)', + 'min' => 'MIN(NULLIF('.$aggCol.', \'\') + 0)', + 'max' => 'MAX(NULLIF('.$aggCol.', \'\') + 0)', + }; + } try { + // Time-bucket path: emit a platform-specific bucketing + // expression (date_trunc / DATE_FORMAT / strftime), add + // `WHERE "$field" >= ? AND "$field" < ?` bounds from the + // dateBucket spec, and group on the bucket. Mutual exclusion + // with $groupBy is guaranteed by AggregationQuery::create() + // upstream. + if ($dateBucket !== null) { + $bucketField = (string) $dateBucket['field']; + $bucketCol = $quote.$this->sanitizeColumnName(name: $bucketField).$quote; + $gap = (string) $dateBucket['gap']; + + $boundedWhere = $whereSql.' AND '.$bucketCol.' >= ? AND '.$bucketCol.' < ?'; + + if ($platformName === 'postgres') { + // Prepend the bucket bounds to the binding list so + // they appear in placeholder order: first the gap + // (for the Postgres date_trunc call), then the + // existing WHERE clause bindings, then the dateBucket + // bounds. + $bindings[] = $this->bindValue(value: $dateBucket['start']); + $bindings[] = $this->bindValue(value: $dateBucket['end']); + array_unshift($bindings, $gap); + $bucketExpr = 'date_trunc(?, '.$bucketCol.')::text'; + } else { + // MySQL / SQLite emit literal format strings — the + // gap vocabulary is closed (seven entries) and + // validated upstream by AggregationQuery::create(). + $bindings[] = $this->bindValue(value: $dateBucket['start']); + $bindings[] = $this->bindValue(value: $dateBucket['end']); + if ($platformName === 'mysql') { + $bucketExpr = $this->mysqlBucketExpression(column: $bucketCol, gap: $gap); + } else { + $bucketExpr = $this->sqliteBucketExpression(column: $bucketCol, gap: $gap); + } + }//end if + + $sql = "SELECT {$bucketExpr} AS bucket, {$aggSql} AS agg + FROM {$fullTable} + WHERE {$boundedWhere} + GROUP BY bucket + ORDER BY bucket"; + $stmt = $this->db->prepare($sql); + $stmt->execute($bindings); + $groups = []; + while (($row = $stmt->fetch()) !== false) { + $value = $row['agg']; + if ($metric !== 'count' && is_string($value) === true) { + $value = (float) $value; + } else if ($value !== null) { + $value = (int) $value; + } + + $groups[] = [ + 'key' => $this->coerceBucketKey(raw: $row['bucket']), + 'value' => $value, + ]; + } + + return ['groups' => $groups]; + }//end if + if ($groupBy !== null && isset($groupBy['field']) === true) { $groupCol = '"'.$this->sanitizeColumnName(name: (string) $groupBy['field']).'"'; $sql = "SELECT {$groupCol} AS bucket, {$aggSql} AS agg @@ -791,6 +1269,179 @@ private function tryNativeAggregation( }//end try }//end tryNativeAggregation() + /** + * Coerce a Postgres date_trunc bucket label to a stable + * ISO-8601-UTC string (`Y-m-d\TH:i:s\Z`). + * + * The Postgres `date_trunc()::text` cast returns values like + * `2026-05-21 00:00:00+00`, + * `2026-05-21 00:00:00` (depending on the column timezone), or + * `2026-05-21 13:00:00`. We need a stable wire format that the + * client can parse identically across Postgres versions / timezone + * settings AND across the PHP-fallback path on non-Postgres + * databases. Mirrors the behaviour the + * `SolrAggregationQueryBuilder` and + * `ElasticsearchAggregationQueryBuilder` produce. + * + * @param mixed $raw Raw bucket value from the DB row (typically a string). + * + * @return string ISO-8601-UTC `Y-m-d\TH:i:s\Z` bucket label, or the + * original string when it can't be parsed (defensive). + */ + private function coerceBucketKey(mixed $raw): string + { + if ($raw instanceof DateTimeInterface) { + return $raw->format('Y-m-d\TH:i:s\Z'); + } + + if (is_string($raw) === false) { + return (string) $raw; + } + + // Try strtotime then format — defensive but covers every Postgres + // text-cast shape we'll see. + $stamp = strtotime($raw); + if ($stamp === false) { + return $raw; + } + + return gmdate('Y-m-d\TH:i:s\Z', $stamp); + + }//end coerceBucketKey() + + /** + * Detect the active database platform short name. + * + * Returns one of `postgres`, `mysql`, `sqlite`, or `unknown`. Used to + * pick the matching native-bucketing path in + * {@see tryNativeAggregation()} and to annotate the response + * `backend` field in {@see runAdhoc()}. + * + * @return string Lower-case platform short name. + */ + private function detectDatabasePlatform(): string + { + $platformClass = $this->db->getDatabasePlatform()::class; + if (stripos($platformClass, 'PostgreSQL') !== false) { + return 'postgres'; + } + + if (stripos($platformClass, 'MySQL') !== false || stripos($platformClass, 'MariaDB') !== false) { + return 'mysql'; + } + + if (stripos($platformClass, 'SQLite') !== false) { + return 'sqlite'; + } + + return 'unknown'; + + }//end detectDatabasePlatform() + + /** + * Identifier-quoting character for the given platform. + * + * Postgres and SQLite use double-quotes; MySQL uses backticks. + * + * @param string $platform Platform short name from {@see detectDatabasePlatform()}. + * + * @return string The quoting character to wrap identifiers. + */ + private function identifierQuote(string $platform): string + { + return $platform === 'mysql' ? '`' : '"'; + + }//end identifierQuote() + + /** + * Emit a MySQL `DATE_FORMAT`-based bucket expression for the given gap. + * + * The gap vocabulary is closed (seven entries) and validated upstream + * by {@see AggregationQuery::create()}. The format strings produce + * the canonical `Y-m-d\TH:i:s\Z` wire shape so the round-trip + * through {@see coerceBucketKey()} is an identity transform on + * MySQL output. + * + * @param string $column Identifier-quoted column reference. + * @param string $gap Validated gap unit. + * + * @return string The full bucket SQL expression (without the `AS bucket` alias). + */ + private function mysqlBucketExpression(string $column, string $gap): string + { + if ($gap === 'week') { + // ISO-Monday week-start: back-shift by ((DAYOFWEEK - 1 - 1) % 7) + // days, but MySQL's DAYOFWEEK starts on Sunday=1 so the actual + // expression is `((DAYOFWEEK(field) + 5) MOD 7)` which produces + // 0 for Monday, 6 for Sunday — exactly the shift we need to + // reach the previous (or current) Monday. + return 'DATE_FORMAT('.$column.' - INTERVAL ((DAYOFWEEK('.$column.') + 5) MOD 7) DAY, \'%Y-%m-%dT00:00:00Z\')'; + } + + if ($gap === 'quarter') { + return sprintf( + 'CONCAT(YEAR(%1$s), \'-\', LPAD(((QUARTER(%1$s) - 1) * 3 + 1), 2, \'0\'), \'-01T00:00:00Z\')', + $column + ); + } + + $format = match ($gap) { + 'minute' => '%Y-%m-%dT%H:%i:00Z', + 'hour' => '%Y-%m-%dT%H:00:00Z', + 'day' => '%Y-%m-%dT00:00:00Z', + 'month' => '%Y-%m-01T00:00:00Z', + 'year' => '%Y-01-01T00:00:00Z', + default => '%Y-%m-%dT00:00:00Z', + }; + + return 'DATE_FORMAT('.$column.', \''.$format.'\')'; + + }//end mysqlBucketExpression() + + /** + * Emit a SQLite `strftime`-based bucket expression for the given gap. + * + * Mirrors {@see mysqlBucketExpression()} for the SQLite strftime + * vocabulary. The `weekday 0` modifier in SQLite jumps forward to + * the next Sunday (UTC); subtracting six days yields the previous + * Monday — matching ISO-week-start semantics. + * + * @param string $column Identifier-quoted column reference. + * @param string $gap Validated gap unit. + * + * @return string The full bucket SQL expression (without the `AS bucket` alias). + */ + private function sqliteBucketExpression(string $column, string $gap): string + { + if ($gap === 'week') { + return 'strftime(\'%Y-%m-%dT00:00:00Z\', '.$column.', \'weekday 0\', \'-6 days\')'; + } + + if ($gap === 'quarter') { + $parts = []; + $parts[] = sprintf('CASE WHEN CAST(strftime(\'%%m\', %1$s) AS INTEGER) <= 3', $column); + $parts[] = sprintf('THEN strftime(\'%%Y-01-01T00:00:00Z\', %1$s)', $column); + $parts[] = sprintf('WHEN CAST(strftime(\'%%m\', %1$s) AS INTEGER) <= 6', $column); + $parts[] = sprintf('THEN strftime(\'%%Y-04-01T00:00:00Z\', %1$s)', $column); + $parts[] = sprintf('WHEN CAST(strftime(\'%%m\', %1$s) AS INTEGER) <= 9', $column); + $parts[] = sprintf('THEN strftime(\'%%Y-07-01T00:00:00Z\', %1$s)', $column); + $parts[] = sprintf('ELSE strftime(\'%%Y-10-01T00:00:00Z\', %1$s) END', $column); + return implode(' ', $parts); + } + + $format = match ($gap) { + 'minute' => '%Y-%m-%dT%H:%M:00Z', + 'hour' => '%Y-%m-%dT%H:00:00Z', + 'day' => '%Y-%m-%dT00:00:00Z', + 'month' => '%Y-%m-01T00:00:00Z', + 'year' => '%Y-01-01T00:00:00Z', + default => '%Y-%m-%dT00:00:00Z', + }; + + return 'strftime(\''.$format.'\', '.$column.')'; + + }//end sqliteBucketExpression() + /** * Convert a value to its SQL bind shape. * @@ -1006,7 +1657,9 @@ private function runCrossSchema( $rows = []; foreach ($objects as $entity) { - $rows[] = $entity instanceof \OCA\OpenRegister\Db\ObjectEntity ? $entity->getObject() : (array) $entity; + // The findAllInRegisterSchemaTable mapper returns ObjectEntity[]; + // getObject() resolves each row to the inner data array. + $rows[] = $entity->getObject(); } $rows = $this->applyFilter(rows: $rows, filter: $resolvedWhere); diff --git a/lib/Service/Aggregation/TimeseriesRequestValidator.php b/lib/Service/Aggregation/TimeseriesRequestValidator.php new file mode 100644 index 000000000000..addda8f1afce --- /dev/null +++ b/lib/Service/Aggregation/TimeseriesRequestValidator.php @@ -0,0 +1,266 @@ + + * + * @author Conduction Development Team + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://www.OpenRegister.app + * + * @spec openspec/changes/add-time-bucket-aggregation/specs/aggregation-api/spec.md + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Service\Aggregation; + +use InvalidArgumentException; +use OCA\OpenRegister\Db\Schema; + +/** + * Validates the input shape of an ad-hoc timeseries aggregation request. + */ +class TimeseriesRequestValidator +{ + + /** + * Magic-table metadata columns that are allowed as bucketing / + * groupBy fields even though they are not declared properties on + * the schema. Mirrors the metadata prefix in MagicMapper. + * + * @var string[] + */ + public const METADATA_FIELDS = ['_created', '_updated', '_deleted_at']; + + /** + * Allowed interval names on the REST endpoint. Mapped to the + * AggregationQuery::DATE_BUCKET_GAPS vocabulary in lower-case. + * + * @var array + */ + private const INTERVAL_MAP = [ + 'MINUTE' => 'minute', + 'HOUR' => 'hour', + 'DAY' => 'day', + 'WEEK' => 'week', + 'MONTH' => 'month', + 'QUARTER' => 'quarter', + 'YEAR' => 'year', + ]; + + /** + * Sub-day interval gaps (require `format: date-time` on the field). + * + * @var string[] + */ + private const SUB_DAY_GAPS = ['minute', 'hour']; + + /** + * Validate and normalise a request shape into an AggregationQuery. + * + * Input shape (all values strings as received from HTTP query + * params; GraphQL resolver passes typed values but the shape is the + * same): + * - field (string, required) + * - interval (string, optional — one of INTERVAL_MAP keys) + * - from (string, required when interval set) + * - to (string, required when interval set) + * - metric (string, optional, default 'count') + * - metricField (string, required when metric != count) + * - filter (array, optional) + * + * @param array $input The raw request shape. + * @param Schema $schema The schema being aggregated (for field allow-listing). + * + * @return AggregationQuery The validated query value object. + * + * @throws InvalidArgumentException When any input rule is violated. + * The message is client-safe and + * maps directly to a 400 body. + * + * @SuppressWarnings(PHPMD.CyclomaticComplexity) + * Fail-fast validation chain — each branch is one independent + * guard returning a distinct client-facing error. + * @SuppressWarnings(PHPMD.NPathComplexity) + * @SuppressWarnings(PHPMD.ExcessiveMethodLength) + * Each guard is short; the method length is the count of + * independent guards, not a structural concern. + * @SuppressWarnings(PHPMD.ElseExpression) + * The else branch nulls metricField for count-metric requests — + * inlining it would obscure the contract that the value object + * expects null for count. + * @SuppressWarnings(PHPMD.StaticAccess) + * AggregationQuery::create() is the canonical, validated factory + * for the value object. + */ + public function validate(array $input, Schema $schema): AggregationQuery + { + $field = (string) ($input['field'] ?? ''); + if ($field === '') { + throw new InvalidArgumentException('`field` is required'); + } + + $allowed = $this->allowedFields(schema: $schema); + if (in_array($field, $allowed, true) === false) { + throw new InvalidArgumentException( + sprintf('`field` "%s" is not a declared property of the schema', $field) + ); + } + + $metric = strtolower((string) ($input['metric'] ?? 'count')); + $metricField = ($input['metricField'] ?? null); + if ($metric !== 'count') { + if ($metricField === null || $metricField === '') { + throw new InvalidArgumentException( + sprintf('`metricField` is required when metric is "%s"', $metric) + ); + } + + if (in_array((string) $metricField, $allowed, true) === false) { + throw new InvalidArgumentException( + sprintf('`metricField` "%s" is not a declared property of the schema', $metricField) + ); + } + } else { + // For count, field on AggregationQuery is null (count is + // record-level, not field-level). + $metricField = null; + } + + $rawInterval = ($input['interval'] ?? null); + $dateBucket = null; + if ($rawInterval !== null && $rawInterval !== '') { + $intervalKey = strtoupper((string) $rawInterval); + if (isset(self::INTERVAL_MAP[$intervalKey]) === false) { + throw new InvalidArgumentException( + sprintf( + '`interval` MUST be one of %s (got: %s)', + implode(', ', array_keys(self::INTERVAL_MAP)), + (string) $rawInterval + ) + ); + } + + $gap = self::INTERVAL_MAP[$intervalKey]; + + // Sub-day gaps require a date-time field. + if (in_array($gap, self::SUB_DAY_GAPS, true) === true) { + $format = $this->fieldFormat(schema: $schema, field: $field); + if ($format !== 'date-time') { + throw new InvalidArgumentException( + sprintf( + 'sub-day interval "%s" requires a `date-time` field; "%s" has format "%s"', + $intervalKey, + $field, + $format ?? 'unspecified' + ) + ); + } + } + + $from = (string) ($input['from'] ?? ''); + $to = (string) ($input['to'] ?? ''); + if ($from === '' || $to === '') { + throw new InvalidArgumentException( + '`from` and `to` are required when `interval` is set' + ); + } + + if (strtotime($from) === false || strtotime($to) === false) { + throw new InvalidArgumentException( + '`from` and `to` MUST be parseable ISO-8601 datetimes' + ); + } + + $dateBucket = [ + 'field' => $field, + 'start' => $from, + 'end' => $to, + 'gap' => $gap, + ]; + }//end if + + // Categorical groupBy fires when no interval was supplied (the + // bucketing axis IS the field) OR when explicitly absent. For + // interval-bucket requests we let dateBucket carry the field and + // leave groupBy null — AggregationQuery::create() rejects the + // combination as mutually exclusive. + $groupBy = ($dateBucket === null) ? ['field' => $field] : null; + + $filter = (array) ($input['filter'] ?? []); + + return AggregationQuery::create( + metric: $metric, + field: $metricField, + filter: $filter, + groupBy: $groupBy, + dateBucket: $dateBucket + ); + + }//end validate() + + /** + * Compute the allow-list of fields the request may reference: every + * declared schema property + the magic-table metadata columns. + * + * @param Schema $schema The schema being aggregated. + * + * @return string[] Allow-listed field names. + */ + private function allowedFields(Schema $schema): array + { + $properties = ($schema->getProperties() ?? []); + $declared = array_keys($properties); + return array_merge($declared, self::METADATA_FIELDS); + + }//end allowedFields() + + /** + * Look up the JSON-Schema `format` for a declared property. + * + * @param Schema $schema The schema. + * @param string $field The property name. + * + * @return string|null The format string, or null when the property + * is a metadata column or has no format declared. + */ + private function fieldFormat(Schema $schema, string $field): ?string + { + // Magic metadata cols are date-time-shaped by convention. + if (in_array($field, self::METADATA_FIELDS, true) === true) { + return 'date-time'; + } + + $properties = ($schema->getProperties() ?? []); + $property = ($properties[$field] ?? null); + if (is_array($property) === false) { + return null; + } + + $format = ($property['format'] ?? null); + return is_string($format) === true ? $format : null; + + }//end fieldFormat() +}//end class diff --git a/lib/Service/GraphQL/GraphQLResolver.php b/lib/Service/GraphQL/GraphQLResolver.php index 58ae4225c32a..ab513dd108e9 100644 --- a/lib/Service/GraphQL/GraphQLResolver.php +++ b/lib/Service/GraphQL/GraphQLResolver.php @@ -22,6 +22,7 @@ use GraphQL\Deferred; use GraphQL\Error\Error; +use InvalidArgumentException; use OCA\OpenRegister\Db\AuditTrailMapper; use OCA\OpenRegister\Db\ObjectEntity; use OCA\OpenRegister\Db\Register; @@ -29,6 +30,8 @@ use OCA\OpenRegister\Db\Schema; use OCA\OpenRegister\Db\SchemaMapper; use OCA\OpenRegister\Exception\NotAuthorizedException; +use OCA\OpenRegister\Service\Aggregation\AggregationRunner; +use OCA\OpenRegister\Service\Aggregation\TimeseriesRequestValidator; use OCA\OpenRegister\Service\Object\GetObject; use OCA\OpenRegister\Service\Object\PermissionHandler; use OCA\OpenRegister\Service\Object\QueryHandler; @@ -80,15 +83,17 @@ class GraphQLResolver /** * Constructor. * - * @param GetObject $getObject Object finder - * @param ObjectService $objectService Object service - * @param PermissionHandler $permissionHandler Permission handler - * @param PropertyRbacHandler $propertyRbac Property RBAC handler - * @param RelationHandler $relationHandler Relation handler - * @param AuditTrailMapper $auditTrailMapper Audit trail mapper - * @param RegisterMapper $registerMapper Register mapper - * @param LoggerInterface $logger Logger - * @param \OCA\OpenRegister\Service\Object\TranslationHandler $translationHandler Translation handler + * @param GetObject $getObject Object finder + * @param ObjectService $objectService Object service + * @param PermissionHandler $permissionHandler Permission handler + * @param PropertyRbacHandler $propertyRbac Property RBAC handler + * @param RelationHandler $relationHandler Relation handler + * @param AuditTrailMapper $auditTrailMapper Audit trail mapper + * @param RegisterMapper $registerMapper Register mapper + * @param LoggerInterface $logger Logger + * @param \OCA\OpenRegister\Service\Object\TranslationHandler $translationHandler Translation handler + * @param AggregationRunner $aggregationRunner Ad-hoc aggregation dispatcher. + * @param TimeseriesRequestValidator $timeseriesValidator Validator for `groupBy` arg. * * @SuppressWarnings(PHPMD.ExcessiveParameterList) */ @@ -102,6 +107,8 @@ public function __construct( private readonly RegisterMapper $registerMapper, private readonly LoggerInterface $logger, private readonly \OCA\OpenRegister\Service\Object\TranslationHandler $translationHandler, + private readonly AggregationRunner $aggregationRunner, + private readonly TimeseriesRequestValidator $timeseriesValidator, ) { }//end __construct() @@ -168,6 +175,12 @@ public function resolveSingle(Schema $schema, mixed $root, array $args): ?array * @return array The connection result * * @spec openspec/changes/retrofit-2026-04-23-annotate-openregister/tasks.md#task-37 + * + * @SuppressWarnings(PHPMD.ExcessiveMethodLength) + * The connection-build pipeline is intentionally inline: + * each section (RBAC, search, filter, cursor, page-info, optional + * groupBy) is a single responsibility but extracting them adds + * indirection without reducing complexity. */ public function resolveList(Schema $schema, mixed $root, array $args): array { @@ -248,7 +261,7 @@ public function resolveList(Schema $schema, mixed $root, array $args): array $endCursor = $lastEdge['cursor']; } - return [ + $connection = [ 'edges' => $edges, 'pageInfo' => [ 'hasNextPage' => $hasNextPage, @@ -259,10 +272,95 @@ public function resolveList(Schema $schema, mixed $root, array $args): array 'totalCount' => $totalCount, 'facets' => ($result['facets'] ?? null), 'facetable' => ($result['facetable'] ?? null), + 'groups' => null, ]; + // Optional ad-hoc aggregation: client supplied `groupBy` on the + // list query. Run through the same validator the REST endpoint + // uses so allow-list + sub-day-interval rules stay consistent. + // Validation errors surface as GraphQL field-errors (the + // `groups` field is null, the rest of the connection is intact). + $groupBy = ($args['groupBy'] ?? null); + if (is_array($groupBy) === true && ($groupBy['field'] ?? '') !== '') { + $connection['groups'] = $this->resolveGroupBy( + schema: $schema, + register: $register, + rawArgs: $groupBy + ); + } + + return $connection; + }//end resolveList() + /** + * Resolve the optional `groupBy` argument by dispatching to + * `AggregationRunner::runAdhoc()`. + * + * Returns the `groups` array on success. On validation / RBAC + * failure, throws a GraphQL `Error` so the field-level error + * surface picks it up (the rest of the connection still resolves). + * + * @param Schema $schema The schema being aggregated. + * @param Register|null $register The register (may be null if the schema isn't bound — defensive). + * @param array $rawArgs The raw groupBy arg map from the GraphQL request. + * + * @return array|null Bucket array, or null when register/runner missing. + * + * @throws Error When validation fails or RBAC denies the request. + */ + private function resolveGroupBy(Schema $schema, ?Register $register, array $rawArgs): ?array + { + if ($register === null) { + // Defensive: a schema without a register has nothing to + // aggregate against. Return null so the field stays + // queryable but empty. + return null; + } + + // Normalise the GraphQL arg shape into the validator's input + // shape. The validator returns a fully-built AggregationQuery + // (or throws InvalidArgumentException with a 400-grade message). + $input = [ + 'field' => (string) ($rawArgs['field'] ?? ''), + 'interval' => ($rawArgs['interval'] ?? null), + 'from' => ($rawArgs['from'] ?? null), + 'to' => ($rawArgs['to'] ?? null), + 'metric' => strtolower((string) ($rawArgs['metric'] ?? 'count')), + 'metricField' => ($rawArgs['metricField'] ?? null), + 'filter' => [], + ]; + + try { + $query = $this->timeseriesValidator->validate(input: $input, schema: $schema); + } catch (InvalidArgumentException $e) { + throw new Error($e->getMessage()); + } + + try { + $result = $this->aggregationRunner->runAdhoc( + register: $register, + schema: $schema, + query: $query + ); + } catch (NotAuthorizedException $e) { + throw new Error($e->getMessage()); + } + + $groups = ($result['groups'] ?? []); + // Coerce values to float to match the GraphQL `value: Float!` type. + $normalised = []; + foreach ($groups as $bucket) { + $normalised[] = [ + 'key' => (string) ($bucket['key'] ?? ''), + 'value' => (float) ($bucket['value'] ?? 0), + ]; + } + + return $normalised; + + }//end resolveGroupBy() + /** * Resolve a create mutation. * diff --git a/lib/Service/GraphQL/SchemaGenerator/TypeMapperHandler.php b/lib/Service/GraphQL/SchemaGenerator/TypeMapperHandler.php index 12656d664983..b3555a3bc61f 100644 --- a/lib/Service/GraphQL/SchemaGenerator/TypeMapperHandler.php +++ b/lib/Service/GraphQL/SchemaGenerator/TypeMapperHandler.php @@ -16,6 +16,7 @@ namespace OCA\OpenRegister\Service\GraphQL\SchemaGenerator; +use GraphQL\Type\Definition\EnumType; use GraphQL\Type\Definition\InputObjectType; use GraphQL\Type\Definition\ObjectType; use GraphQL\Type\Definition\Type; @@ -89,6 +90,38 @@ class TypeMapperHandler */ private ?ObjectType $auditTrailType = null; + /** + * Shared GroupByInput input type. Backs the optional `groupBy` + * argument on every auto-generated list query. See the + * `add-time-bucket-aggregation` change for the spec contract. + * + * @var InputObjectType|null + */ + private ?InputObjectType $groupByInputType = null; + + /** + * Shared TimeInterval enum (MINUTE..YEAR). Used inside GroupByInput. + * + * @var EnumType|null + */ + private ?EnumType $timeIntervalType = null; + + /** + * Shared AggregationMetric enum (COUNT|SUM|AVG|MIN|MAX). Used + * inside GroupByInput. + * + * @var EnumType|null + */ + private ?EnumType $aggMetricType = null; + + /** + * Shared GroupBucket object type. Element shape of the `groups` + * field on every Connection. + * + * @var ObjectType|null + */ + private ?ObjectType $groupBucketType = null; + /** * Callback to resolve a $ref string to a RegisterSchema. * @@ -493,6 +526,10 @@ public function getConnectionType(RegisterSchema $schema, ObjectType $objectType 'totalCount' => Type::nonNull(Type::int()), 'facets' => $this->scalars['JSON'], 'facetable' => Type::listOf(Type::string()), + 'groups' => [ + 'type' => Type::listOf(Type::nonNull($this->getGroupBucketType())), + 'description' => 'Ad-hoc bucket aggregation result; null unless `groupBy` was supplied.', + ], ], ] ); @@ -502,6 +539,149 @@ public function getConnectionType(RegisterSchema $schema, ObjectType $objectType }//end getConnectionType() + /** + * Get (or lazily build) the shared GroupBucket object type. + * + * @return ObjectType The GroupBucket type. + * + * @spec openspec/changes/add-time-bucket-aggregation/specs/graphql-api/spec.md + */ + public function getGroupBucketType(): ObjectType + { + if ($this->groupBucketType !== null) { + return $this->groupBucketType; + } + + $this->groupBucketType = new ObjectType( + [ + 'name' => 'GroupBucket', + 'description' => 'A single bucket in an ad-hoc aggregation result.', + 'fields' => [ + 'key' => Type::nonNull(Type::string()), + 'value' => Type::nonNull(Type::float()), + ], + ] + ); + + return $this->groupBucketType; + + }//end getGroupBucketType() + + /** + * Get (or lazily build) the shared TimeInterval enum. + * + * @return EnumType The TimeInterval enum. + * + * @spec openspec/changes/add-time-bucket-aggregation/specs/graphql-api/spec.md + */ + public function getTimeIntervalType(): EnumType + { + if ($this->timeIntervalType !== null) { + return $this->timeIntervalType; + } + + $this->timeIntervalType = new EnumType( + [ + 'name' => 'TimeInterval', + 'description' => 'Bucketing interval for ad-hoc time-bucket aggregations.', + 'values' => [ + 'MINUTE' => ['value' => 'MINUTE'], + 'HOUR' => ['value' => 'HOUR'], + 'DAY' => ['value' => 'DAY'], + 'WEEK' => ['value' => 'WEEK'], + 'MONTH' => ['value' => 'MONTH'], + 'QUARTER' => ['value' => 'QUARTER'], + 'YEAR' => ['value' => 'YEAR'], + ], + ] + ); + + return $this->timeIntervalType; + + }//end getTimeIntervalType() + + /** + * Get (or lazily build) the shared AggregationMetric enum. + * + * @return EnumType The AggregationMetric enum. + * + * @spec openspec/changes/add-time-bucket-aggregation/specs/graphql-api/spec.md + */ + public function getAggregationMetricType(): EnumType + { + if ($this->aggMetricType !== null) { + return $this->aggMetricType; + } + + $this->aggMetricType = new EnumType( + [ + 'name' => 'AggregationMetric', + 'description' => 'Metric for ad-hoc aggregations.', + 'values' => [ + 'COUNT' => ['value' => 'COUNT'], + 'SUM' => ['value' => 'SUM'], + 'AVG' => ['value' => 'AVG'], + 'MIN' => ['value' => 'MIN'], + 'MAX' => ['value' => 'MAX'], + ], + ] + ); + + return $this->aggMetricType; + + }//end getAggregationMetricType() + + /** + * Get (or lazily build) the shared GroupByInput input type. + * + * @return InputObjectType The GroupByInput type. + * + * @spec openspec/changes/add-time-bucket-aggregation/specs/graphql-api/spec.md + */ + public function getGroupByInputType(): InputObjectType + { + if ($this->groupByInputType !== null) { + return $this->groupByInputType; + } + + $this->groupByInputType = new InputObjectType( + [ + 'name' => 'GroupByInput', + 'description' => 'Ad-hoc aggregation arg; `interval` set => time-bucketed, otherwise categorical groupBy.', + 'fields' => [ + 'field' => [ + 'type' => Type::nonNull(Type::string()), + 'description' => 'Field to group on. Must be a declared schema property or magic metadata column.', + ], + 'interval' => [ + 'type' => $this->getTimeIntervalType(), + 'description' => 'Optional bucketing interval. When supplied, requires `from` + `to`.', + ], + 'from' => [ + 'type' => Type::string(), + 'description' => 'ISO-8601 lower bound, inclusive. Required when `interval` is set.', + ], + 'to' => [ + 'type' => Type::string(), + 'description' => 'ISO-8601 upper bound, exclusive. Required when `interval` is set.', + ], + 'metric' => [ + 'type' => $this->getAggregationMetricType(), + 'defaultValue' => 'COUNT', + 'description' => 'Aggregation metric. Default COUNT.', + ], + 'metricField' => [ + 'type' => Type::string(), + 'description' => 'Field to aggregate over. Required when metric != COUNT.', + ], + ], + ] + ); + + return $this->groupByInputType; + + }//end getGroupByInputType() + /** * Get the shared PageInfo type. * @@ -587,6 +767,10 @@ public function getListArgs(RegisterSchema $schema): array 'first' => ['type' => Type::int(), 'defaultValue' => 20, 'description' => 'Number of items to return'], 'offset' => ['type' => Type::int(), 'description' => 'Offset for pagination'], 'after' => ['type' => Type::string(), 'description' => 'Cursor for forward pagination'], + 'groupBy' => [ + 'type' => $this->getGroupByInputType(), + 'description' => 'Optional ad-hoc aggregation; when supplied, the connection emits a `groups` field.', + ], ]; }//end getListArgs() diff --git a/openspec/changes/add-aggregation-enhancements/design.md b/openspec/changes/add-aggregation-enhancements/design.md new file mode 100644 index 000000000000..276cca9fe539 --- /dev/null +++ b/openspec/changes/add-aggregation-enhancements/design.md @@ -0,0 +1,126 @@ +# Design — Time-bucket aggregation enhancements + +This change ships two of the five `add-time-bucket-aggregation` follow-ups. The other three are documented here at design-only depth so the next pickup has a clear starting point rather than re-running the discovery work. + +## Decisions for the two shipped items + +### D1 — MySQL native bucketing emits `DATE_FORMAT` against fixed format strings per gap + +**Decision.** When `tryNativeAggregation()` detects a MySQL platform AND `$dateBucket !== null`, emit: + +```sql +SELECT DATE_FORMAT(`field`, '') AS bucket, AS agg +FROM `oc_
` +WHERE AND `field` >= ? AND `field` < ? +GROUP BY bucket +ORDER BY bucket +``` + +The `` strings map directly from the `gap` vocabulary (no `interval`-string parameter passed at runtime — the gap is finite and small, so a `match()` on the gap returns the literal format string): + +| Gap | Format string | +|-----------|------------------------------| +| `minute` | `'%Y-%m-%dT%H:%i:00Z'` | +| `hour` | `'%Y-%m-%dT%H:00:00Z'` | +| `day` | `'%Y-%m-%dT00:00:00Z'` | +| `month` | `'%Y-%m-01T00:00:00Z'` | +| `year` | `'%Y-01-01T00:00:00Z'` | +| `week` | (no `DATE_FORMAT` shortcut — emit `DATE_FORMAT(field - INTERVAL ((DAYOFWEEK(field) + 5) %% 7) DAY, '%Y-%m-%dT00:00:00Z')` to mirror Postgres ISO-week-Monday) | +| `quarter` | (no `DATE_FORMAT` shortcut — emit `CONCAT(YEAR(field), '-', LPAD(((QUARTER(field) - 1) * 3 + 1), 2, '0'), '-01T00:00:00Z')`) | + +**Why per-gap format strings instead of binding the format at runtime.** Binding the format string as a `?` parameter would force the engine to re-prepare the statement per request and would prevent the format-string from being part of the column's value cache. The gap vocabulary is closed (seven entries) and validated upstream by `AggregationQuery::assertValidDateBucket()`, so emitting a literal is safe. + +**Why `%i` (MySQL minute) rather than `%M`.** `%M` is full-month-name in MySQL's `DATE_FORMAT` vocabulary; the minute placeholder is `%i`. This is the most common transcription error when porting strftime/date_trunc strings to MySQL. + +**Wire format parity.** All six gap formats produce the exact same output byte sequence as the Postgres `coerceBucketKey()` helper. The Postgres path runs each key through `coerceBucketKey()` which parses `Y-m-d H:i:s+TZ` text-cast output and re-formats as `Y-m-d\TH:i:s\Z`. The MySQL `DATE_FORMAT` path emits `Y-m-d\TH:i:s\Z` directly, so `coerceBucketKey()` is a no-op on MySQL output (it parses cleanly and re-formats identically) — same path, same code, just zero-cost on the MySQL keys. + +### D2 — SQLite native bucketing emits `strftime` against the same format strings + +**Decision.** Same shape as MySQL, with `strftime` and the strftime format vocabulary: + +| Gap | strftime format | +|-----------|----------------------------| +| `minute` | `'%Y-%m-%dT%H:%M:00Z'` | +| `hour` | `'%Y-%m-%dT%H:00:00Z'` | +| `day` | `'%Y-%m-%dT00:00:00Z'` | +| `month` | `'%Y-%m-01T00:00:00Z'` | +| `year` | `'%Y-01-01T00:00:00Z'` | +| `week` | `strftime('%Y-%m-%dT00:00:00Z', "field", 'weekday 0', '-7 days')` (ISO-Monday equivalent via the `weekday` modifier — Sunday-of-previous-week + 1 day = Monday-of-current-week) | +| `quarter` | use `CASE WHEN strftime('%m', "field") IN ('01','02','03') THEN strftime('%Y-01-01T00:00:00Z', "field") WHEN ... END` | + +**Why a `CASE` for quarter.** SQLite's `strftime` doesn't expose quarter directly; the `CASE` is small (four arms, fixed at compile time) and stays inside the SQL engine where it belongs. + +**SQLite `%M` is minute** (unlike MySQL's `%i`) — the format strings above use the SQLite strftime vocabulary, not the MySQL one. This is the symmetric porting hazard to D1. + +**Quoting.** SQLite uses double-quotes for identifiers and single-quotes for string literals, identical to Postgres. Existing `sanitizeColumnName()` output (`"colname"`) is portable to SQLite without changes. MySQL uses backticks; the runner branches on platform and emits the right quote character. + +### D3 — Ad-hoc cache key derivation + +**Decision.** The ad-hoc path computes its cache key as: + +```php +$queryHash = sha1(json_encode($query->toArray())); +$cacheKey = sprintf('agg:%s:%s:adhoc:%s:%s:%s', + $registerSlug, $schemaSlug, $queryHash, $filterHash, $rbacHash); +``` + +The literal `adhoc:` prefix in the name slot keeps ad-hoc entries visually distinct from named-aggregation entries in cache dumps. The hash includes everything the runner reads off the query, so two structurally-equivalent queries hit the same key regardless of field-order in the input JSON. + +**Why `toArray()` instead of `json_encode($query)`**. The `AggregationQuery` class has private readonly fields, so PHP's default JSON serialiser produces `{}`. An explicit `toArray()` method: +1. Documents the shape that's part of the cache contract. +2. Sorts the `filter` keys before hashing so `{a: 1, b: 2}` and `{b: 2, a: 1}` hash identically. +3. Future-proofs the key against new optional fields on the query (multi-field groupBy from #1606, window spec from #1607, multi-metric from #1608) — adding the field to `toArray()` automatically extends the cache key. + +**Why use the existing `AggregationCache` class rather than a new ad-hoc cache.** The cache class already owns the RBAC-scoped key derivation, the distributed-cache factory connection, the graceful-degrade-on-unavailable branch, and the 60 s TTL. Forking a parallel cache class would duplicate all of that without removing complexity. The `getAdhoc()`/`setAdhoc()` wrappers cost ~30 lines. + +### D4 — Invalidation reuses the existing listener verbatim + +**Decision.** No changes to `AggregationCacheInvalidationListener`. The listener already calls `AggregationCache::evictForSchema()` on every `ObjectCreatedEvent`, `ObjectUpdatedEvent`, `ObjectDeletedEvent`, and `ObjectTransitionedEvent`, and `evictForSchema()` runs `ICache::clear()` on the `openregister_aggregations` cache — which covers both named-aggregation entries and ad-hoc entries because they share the same cache instance. + +**Coarse vs precise eviction.** `ICache::clear()` is global; ideally we'd evict only the affected `(register, schema)` keys. That would require either prefix-scan support on `ICache` (which Redis backs but the memcache + APCu backends don't) or a secondary index. Both add complexity without removing the 60 s TTL safety net. The existing comment on `evictForSchema()` already documents the tradeoff; the ad-hoc cache inherits it unchanged. + +## Deferred — file separate opsx cycles + +### #1606 — Multi-field groupBy + +**Why deferred.** API decision (`groupBy.field` vs `groupBy.fields` vs `groupBy: [...]`) is unresolved. Three viable shapes: + +1. **Backward-compatible extension**: `GroupByInput.fields: [String!]` alongside the existing `field: String` — clients pick one. Cost: branch in every translator, two shapes to maintain forever. +2. **Replace field with fields**: `GroupByInput.fields: [String!]` (deprecate `field` as a single-element list). Cost: breaking GraphQL change, harder rollout. +3. **Hybrid**: accept both at the input layer; normalize to `fields: string[]` internally. Cost: one normalization function, one shape downstream. + +Postgres `GROUP BY a, b` is straightforward. Solr `pivot.facet` and ES nested `terms` each need their own translator surface — neither is a single-line change. + +**Recommended pickup ordering.** Open a discrete change `add-multi-field-groupby` with the API question as Decision #1, then a thin design pass on the three translators. Solr's `pivot.facet` syntax is the tightest constraint (it returns nested arrays, not a flat list). + +**Response shape.** Add `groups[i].keys: {field_a: value, field_b: value}` alongside the existing `groups[i].key` for single-field requests (keep `key` working for backwards-compat). Single-field requests still emit `key`; multi-field requests emit `keys` with `key` omitted (or set to the concatenated form `field_a||field_b` as a debug aid — Decision needed). + +### #1607 — Cumulative / rolling windows + +**Why deferred.** Postgres window functions compose awkwardly with the existing RBAC predicate (the window has to be applied AFTER the row-level filter; emitting `SUM(...) OVER (ORDER BY bucket)` requires the bucket column to be selected, which means changing the inner SELECT, then wrapping). The PHP fallback needs a separate accumulation pass; Solr lacks native cumulative aggregation (post-process pipeline only); ES has `cumulative_sum`/`moving_avg` pipeline aggregators (different surface). + +**Recommended pickup ordering.** Open `add-aggregation-windows` with three Decisions: +1. **API shape**: `AggregationQuery.window: {type: 'cumulative'|'rolling', size?: int}` — cumulative is rolling-over-all-prior; rolling is rolling-over-N. Need to pin `size` semantics (rows-vs-time-window). +2. **Postgres SQL**: nested-SELECT with `SUM(agg) OVER (ORDER BY bucket ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW)` for cumulative; `ROWS BETWEEN N PRECEDING AND CURRENT ROW` for rolling. The Postgres native path becomes a 2-level query. +3. **Translator coverage**: PHP polyfill (single accumulation pass over the already-bucketed groups); ES `cumulative_sum`/`moving_fn` pipeline; Solr post-processing in the result-formatter. + +**Response shape.** Per-group field stays `value` but its semantics change with `window`. Document at the API layer; no extra response field needed. + +### #1608 — Multi-metric in one request + +**Why deferred.** Largest of the three deferred items — `AggregationQuery.metric: string` becomes `AggregationQuery.metrics: AggregationMetricSpec[]`, and every translator (Postgres, Solr, ES, PHP fallback) currently encodes "one metric" in its SELECT/facet/aggs builder. Decision points: + +1. **API shape**: `metrics: [{name: 'callCount', metric: 'count'}, {name: 'avgDuration', metric: 'avg', field: 'duration'}]`. `name` is the response-side label so clients can address each metric independently. +2. **Backward-compat**: keep single `metric` working; if both are set, prefer `metrics` (Decision needed — error vs warn vs prefer). +3. **Response shape**: `groups[i].metrics: {callCount: 30, avgDuration: 12.4}` alongside the existing `groups[i].value` (kept and populated from `metrics[0]` for single-metric back-compat). +4. **Translator updates**: Postgres emits multiple aggregate columns in one SELECT; Solr JSON Facet API supports nested `facet` objects; ES nested `aggs` is the native multi-metric path. + +**Recommended pickup ordering.** Open `add-multi-metric-aggregation`. This is the largest of the three follow-ups because the value object shape change touches the most translators. + +## Interaction between the deferred items + +`metrics: [{name, metric, field}]` (#1608) composes with `groupBy.fields` (#1606) trivially — `groups[i].metrics` becomes per-group regardless of how the groups are formed. + +`window` (#1607) composes with multi-metric by applying the window expression to each metric independently (`SUM(agg1) OVER (ORDER BY bucket), SUM(agg2) OVER (ORDER BY bucket)`). + +All three can be picked up in any order; none blocks the others. diff --git a/openspec/changes/add-aggregation-enhancements/proposal.md b/openspec/changes/add-aggregation-enhancements/proposal.md new file mode 100644 index 000000000000..baa2eb784e7c --- /dev/null +++ b/openspec/changes/add-aggregation-enhancements/proposal.md @@ -0,0 +1,68 @@ +--- +kind: code +depends_on: [add-time-bucket-aggregation] +--- + +# Time-bucket aggregation enhancements (MySQL/SQLite native + ad-hoc cache) + +## Why + +`add-time-bucket-aggregation` (PR #1611) shipped the ad-hoc aggregation primitive end-to-end (REST + GraphQL + Postgres native + PHP fallback), and filed five follow-ups under issues #1606-#1610. Two of those five are "ready" — the surface area is already designed, the dependencies already exist in code, and the work is bounded: + +- **#1609 — MySQL/SQLite native time-bucket**. Today every non-Postgres database falls through to `AggregationRunner::bucketInPhp()`, which hydrates the full RBAC-filtered row set into PHP before bucketing. That's correct but slow above ~50k rows. Both MySQL (`DATE_FORMAT(field, '%Y-%m-%dT00:00:00Z')`) and SQLite (`strftime('%Y-%m-%dT00:00:00Z', field)`) ship a native function that produces identical ISO-8601-UTC bucket labels to the Postgres `date_trunc(...)::text` path, so the runtime cost stays in the database engine where it belongs. The CI test container is MySQL, so this also unblocks a real native-path integration test for the time-bucket primitive on the CI database. +- **#1610 — Cache ad-hoc aggregations**. `AggregationCache` is already wired into the named-annotation path of `AggregationRunner::run()`, with a 60 s TTL, content-addressed RBAC-scoped key, and an `AggregationCacheInvalidationListener` that evicts on every `ObjectCreatedEvent`/`ObjectUpdatedEvent`/`ObjectDeletedEvent`/`ObjectTransitionedEvent`. The ad-hoc path of `runAdhoc()` currently emits `cached: false` on every call because the cache key requires a `name` slot and ad-hoc queries have no name. Filling the slot with `sha1(json_encode(AggregationQuery::toArray()))` reuses the existing cache + invalidation plumbing unchanged; only the key derivation differs. + +The three remaining issues (#1606 multi-field groupBy, #1607 cumulative/rolling windows, #1608 multi-metric) each require a value-object refactor on `AggregationQuery` plus knock-on translator changes (Solr / ES / Postgres / PHP fallback / GraphQL types). They're deferred to separate opsx cycles where the API decisions can be made deliberately rather than bundled into a "ready follow-ups" PR. Design notes are recorded in [`design.md`](./design.md) so the next pickup has the context to file the follow-up changes without redoing the discovery work. + +## What Changes + +### Shipped in this change + +- **`AggregationRunner::tryNativeAggregation()`** — extend the Postgres-specific branch to detect MySQL and SQLite platforms and emit the matching native bucketing expression for each. Bind parameters and result-row coercion stay identical so `coerceBucketKey()` keeps producing the same wire format on every backend. +- **`AggregationQuery::toArray()`** — new public method returning a stable associative array of the query's fields (metric + field + sorted filter + groupBy + dateBucket). Used as the input to the ad-hoc cache key hash. +- **`AggregationCache::getAdhoc()` / `setAdhoc()`** — thin wrappers around the existing `get()`/`set()`/`key()` that derive the `name` slot from `sha1(json_encode($query->toArray()))` prefixed with `adhoc:` so ad-hoc cache entries are visually distinct from named-aggregation entries in cache dumps. TTL stays at the existing 60 s class constant. +- **`AggregationRunner::runAdhoc()`** — read-through-cache: on entry compute the key from `($register->getSlug(), $schema->getSlug(), $query)`, return `{...cached, cached: true}` on hit, populate on miss with the same envelope (`{groups|value, backend, cached: false}` rewritten to `cached: true` only on the next request). +- **Invalidation** — no listener changes needed. The existing `AggregationCacheInvalidationListener` calls `AggregationCache::evictForSchema()` which executes `ICache::clear()` on `openregister_aggregations` — covering both named and ad-hoc entries because they share the underlying cache. +- **Backend reporting** — `tryNativeAggregation()` now reports `mysql` and `sqlite` alongside `postgres` and `php-fallback` in the response `backend` field so callers can observe which path served a request. +- **Tests** — unit coverage for: `AggregationQuery::toArray()` (key stability across filter ordering); `AggregationCache::getAdhoc()`/`setAdhoc()` round-trip; MySQL bucket SQL emission; SQLite bucket SQL emission; cache hit on second identical `runAdhoc()` call; cache miss on differing query. +- **Documentation** — `docs/technical/aggregation-api.md` updated: backend matrix gains MySQL + SQLite rows; cache section documents the ad-hoc TTL + invalidation surface; performance-note section softened (no longer "Postgres only" for native bucketing). + +### Deferred (file separate opsx cycles) + +- **#1606 Multi-field groupBy** — `AggregationQuery.groupBy` becomes `{fields: string[]}`; result shape grows `groups[i].keys: {a, b}`; Postgres `GROUP BY a, b`; Solr `pivot.facet`; ES nested `terms`. See `design.md` for the decision points. +- **#1607 Cumulative / rolling windows** — new `AggregationQuery.window: {type: 'cumulative'|'rolling', size?: int}`; Postgres window functions; PHP-fallback accumulation pass; ES `cumulative_sum` pipeline; Solr stats + post-processing. See `design.md`. +- **#1608 Multi-metric** — `AggregationQuery.metric` (scalar) becomes `AggregationQuery.metrics: AggregationMetricSpec[]`; result shape grows `groups[i].metrics: {count, sum, ...}`. Knock-on edits to every translator + the GraphQL `AggregationMetric` enum. See `design.md`. + +**Non-breaking.** The cache addition is purely additive: a cache miss falls through to the same code path the caller hits today; a cache hit returns the same envelope with `cached: true`. The MySQL/SQLite native paths produce the same wire format as the existing PHP fallback and Postgres native paths — same ISO-8601-UTC keys, same metric coercion. No spec deletes, no breaking API changes. + +## Capabilities + +### MODIFIED Capabilities + +- `aggregation-api` — extend the existing `aggregation-api` capability with: + - Backend matrix: MySQL + SQLite emit native time-bucket SQL; the response `backend` field reports the actual engine that served the query. + - Cache semantics for the ad-hoc path: read-through 60 s TTL keyed on `(register, schema, sha1(query.toArray()), filter, RBAC scope)`; evicted on object lifecycle events for the affected `(register, schema)` pair via the existing invalidation listener. + +## Risks + +- **MySQL `DATE_FORMAT` vs Postgres `date_trunc` semantics drift**. Both produce string output but the input acceptance set differs (MySQL is lenient about non-date strings — it returns `NULL`; Postgres errors). Mitigated by emitting `WHERE field >= ? AND field < ?` with the same bound conversion that already pre-filters non-date rows in the Postgres path; the bucketing only sees rows that already passed the bounds. +- **SQLite `strftime` only accepts `YYYY-MM-DD HH:MM:SS` or Julian-day input**. JSON-stored string dates in OR's magic tables match the ISO-8601 acceptance set already documented for the Postgres path, so the same field-allow-list rules in `TimeseriesRequestValidator` carry over unchanged. +- **Cache stampede on dashboards with many concurrent tiles**. Mitigated by the 60 s TTL ceiling on duplicate misses and by the read-through pattern (every hit short-circuits the SQL). Documented in the docs update as a known characteristic with the matching performance ceiling guidance from #1610. +- **Cache key explosion from variable filters**. The cache key includes `sha1(query.toArray())` so a caller that varies filter shape on every request also varies the cache key — those entries age out at 60 s. The existing PHP_FALLBACK_ROW_CAP already bounds per-request memory; the cache doesn't change that bound. + +## Migration / rollout + +- No data migration. No schema changes (`kind: code` per ADR-032). +- The MySQL/SQLite native paths are opportunistic: existing deployments still get the same response shape; performance on those databases improves silently. The PHP fallback remains in place as the safety net for engines that match neither. +- Cache is read-through; first deploy emits `cached: false` on every call until the cache warms (i.e. always emits `false` on the first call per cache key). No client-visible behaviour change beyond the `cached: true` flag flipping on subsequent identical requests. + +## Verification + +- **#1609** — switch dev container to MySQL (`docker-compose.yml` `db` service profile), re-run the time-bucket integration request (`curl ... /timeseries?field=_created&interval=DAY&from=...&to=...`), confirm response body `backend` is `mysql` (not `php-fallback`). Repeat on SQLite by switching the database URL. +- **#1610** — call the same endpoint twice with identical query params; first response is `{cached: false, backend: ..., groups: [...]}`, second response is `{cached: true, backend: ..., groups: [...]}` with the same `groups` array. Insert a row into the schema, call a third time, confirm `cached: false` again (eviction listener fired). + +## Out of scope + +- Issues #1606, #1607, #1608 — see `design.md` for the planned API surface and the decision points that justify deferring them. +- Solr/Elasticsearch translators for the new MySQL/SQLite paths — those backends have their own native time-bucket primitives (`facet.range`, `date_histogram`) that the existing `aggregations-backend-native` change covers; the MySQL/SQLite native path here is for the **direct-to-DB** Postgres-native sibling, not for the external search-backend path. +- Distributed-lock-based cache-stampede prevention — the 60 s TTL ceiling on duplicate misses is sufficient for the current scale; revisit if a dashboard widget surfaces stampede symptoms in production. diff --git a/openspec/changes/add-aggregation-enhancements/specs/aggregation-api/spec.md b/openspec/changes/add-aggregation-enhancements/specs/aggregation-api/spec.md new file mode 100644 index 000000000000..f7f57a55b591 --- /dev/null +++ b/openspec/changes/add-aggregation-enhancements/specs/aggregation-api/spec.md @@ -0,0 +1,88 @@ +## MODIFIED Requirements + +### Requirement: The system SHALL use a native time-bucket expression on every supported database and fall back to PHP only on unrecognised engines + +When the underlying database is PostgreSQL, the aggregator SHALL execute a single `SELECT date_trunc($gap, "$field")::text AS bucket, AS agg FROM
WHERE AND "$field" >= ? AND "$field" < ? GROUP BY bucket ORDER BY bucket` query and SHALL annotate the response with `backend: "postgres"`. + +When the underlying database is MySQL, the aggregator SHALL execute a single `SELECT DATE_FORMAT(\`$field\`, '') AS bucket, AS agg FROM
WHERE AND \`$field\` >= ? AND \`$field\` < ? GROUP BY bucket ORDER BY bucket` query, where `` is the MySQL `DATE_FORMAT` string corresponding to the `gap` vocabulary (`'%Y-%m-%dT%H:%i:00Z'` for minute, `'%Y-%m-%dT%H:00:00Z'` for hour, `'%Y-%m-%dT00:00:00Z'` for day, `'%Y-%m-01T00:00:00Z'` for month, `'%Y-01-01T00:00:00Z'` for year). For `week` the query SHALL emit `DATE_FORMAT(field - INTERVAL ((DAYOFWEEK(field) + 5) %% 7) DAY, '%Y-%m-%dT00:00:00Z')` to align with ISO-Monday week-start semantics. For `quarter` the query SHALL emit `CONCAT(YEAR(field), '-', LPAD(((QUARTER(field) - 1) * 3 + 1), 2, '0'), '-01T00:00:00Z')`. The response SHALL be annotated with `backend: "mysql"`. + +When the underlying database is SQLite, the aggregator SHALL execute the equivalent query using `strftime('', "$field")`, where `` is the SQLite strftime string for the `gap` (`'%Y-%m-%dT%H:%M:00Z'` for minute, `'%Y-%m-%dT%H:00:00Z'` for hour, `'%Y-%m-%dT00:00:00Z'` for day, `'%Y-%m-01T00:00:00Z'` for month, `'%Y-01-01T00:00:00Z'` for year). For `week` the query SHALL use the strftime `weekday 0` modifier to back-shift to the previous Monday. For `quarter` the query SHALL emit a `CASE WHEN strftime('%m', field) IN ('01','02','03') THEN ... END` expression. The response SHALL be annotated with `backend: "sqlite"`. + +When the database is none of the above (an engine OpenRegister does not natively target), the aggregator SHALL pull the RBAC-filtered row set, bucket in PHP using a `date_trunc` polyfill keyed on the `gap` vocabulary, and SHALL annotate the response with `backend: "php-fallback"`. The PHP path SHALL produce the same response shape and the same bucket-key format as the native paths. + +#### Scenario: Postgres path annotates `backend: "postgres"` +- **GIVEN** the database is PostgreSQL +- **WHEN** the client requests a DAY-bucketed series +- **THEN** the response SHALL include `backend: "postgres"` + +#### Scenario: MySQL path annotates `backend: "mysql"` and emits DATE_FORMAT +- **GIVEN** the database is MySQL +- **WHEN** the client requests a DAY-bucketed series +- **THEN** the response SHALL include `backend: "mysql"` +- **AND** the emitted SQL SHALL contain `DATE_FORMAT` against the bucketed field with the matching format string +- **AND** the bucket keys SHALL be ISO-8601-UTC strings matching what Postgres would have returned + +#### Scenario: SQLite path annotates `backend: "sqlite"` and emits strftime +- **GIVEN** the database is SQLite +- **WHEN** the client requests a DAY-bucketed series +- **THEN** the response SHALL include `backend: "sqlite"` +- **AND** the emitted SQL SHALL contain `strftime` against the bucketed field with the matching format string +- **AND** the bucket keys SHALL be ISO-8601-UTC strings matching what Postgres would have returned + +#### Scenario: Unrecognised engine falls back to PHP +- **GIVEN** the database is neither PostgreSQL nor MySQL nor SQLite (i.e. a hypothetical custom backend) +- **WHEN** the client requests a DAY-bucketed series +- **THEN** the response SHALL include `backend: "php-fallback"` +- **AND** the bucket keys SHALL be ISO-8601-UTC strings matching what the native paths would have returned + +## ADDED Requirements + +### Requirement: The system SHALL cache ad-hoc aggregation results for up to 60 seconds with read-through semantics + +`AggregationRunner::runAdhoc()` SHALL check `AggregationCache` for a cached result envelope before executing any native or PHP-fallback computation. On hit, the runner SHALL return the cached envelope with `cached: true` and SHALL NOT execute the underlying aggregation. On miss, the runner SHALL execute the aggregation, store the resulting envelope in the cache with `cached: false`, and return that envelope to the caller. + +The cache key SHALL be derived from `(registerSlug, schemaSlug, sha1(json_encode(AggregationQuery::toArray())), resolvedFilter, rbacScopeHash)` where: + +- `AggregationQuery::toArray()` returns a stable associative array of the query's `metric`, `field`, `filter`, `groupBy`, and `dateBucket` slots, with filter sub-arrays sorted by key so that two structurally-equivalent filters hash identically. +- `rbacScopeHash` is the SHA-1 of the active user's UID (or `'anonymous'` when no user is logged in), inherited from the existing named-aggregation cache key derivation. + +The cache entry SHALL share the storage backend with the named-aggregation cache (the `openregister_aggregations` distributed cache). The name slot SHALL be prefixed with the literal `adhoc:` so ad-hoc entries are visually distinct from named entries when the cache is dumped for debugging. + +The TTL SHALL be the existing 60-second class constant `AggregationCache::TTL`. The cache SHALL gracefully degrade to no-cache when the distributed cache backend is unavailable (cache writes silently no-op; cache reads return `null` for miss). + +#### Scenario: Cache miss populates, second call hits +- **GIVEN** the cache is empty for the (register, schema, query) triple +- **WHEN** the client issues an ad-hoc aggregation request +- **THEN** the response SHALL include `cached: false` and the underlying SQL SHALL be executed +- **AND** the result envelope SHALL be stored in the cache +- **WHEN** the client issues an identical request within 60 seconds +- **THEN** the response SHALL include `cached: true` +- **AND** the underlying SQL SHALL NOT be executed +- **AND** the `groups` (or `value`) field SHALL equal the first response's groups (or value) + +#### Scenario: Differing query is a different cache entry +- **GIVEN** the cache contains a result for `{field: 'created', interval: 'DAY', from: '2026-05-01', to: '2026-05-22'}` +- **WHEN** the client issues a different request `{field: 'created', interval: 'HOUR', from: '2026-05-21', to: '2026-05-22'}` +- **THEN** the response SHALL include `cached: false` and the underlying SQL SHALL be executed + +#### Scenario: Filter-key reordering hits the same cache entry +- **GIVEN** the cache contains a result for filter `{status: 'open', priority: 'high'}` +- **WHEN** the client issues an otherwise-identical request with filter `{priority: 'high', status: 'open'}` +- **THEN** the response SHALL include `cached: true` + +### Requirement: The ad-hoc aggregation cache SHALL be invalidated on every object lifecycle event for the affected schema + +The existing `AggregationCacheInvalidationListener` SHALL evict ad-hoc cache entries alongside named-aggregation entries on every `ObjectCreatedEvent`, `ObjectUpdatedEvent`, `ObjectDeletedEvent`, and `ObjectTransitionedEvent` for the affected `(register, schema)` pair. The listener SHALL achieve this by reusing the existing `AggregationCache::evictForSchema()` method, which evicts every entry in the `openregister_aggregations` distributed cache regardless of whether the entry was written by the named-aggregation path or the ad-hoc path. + +The eviction granularity SHALL match the existing coarse-but-bounded approach: a full cache flush on the `openregister_aggregations` namespace, with the 60-second TTL ceiling bounding staleness in the event of a missed evict. + +#### Scenario: Inserting a row evicts the ad-hoc cache for the schema +- **GIVEN** the cache contains an ad-hoc result for `(softwarecatalogus, applications, query=X)` +- **WHEN** a new `applications` row is inserted (firing `ObjectCreatedEvent`) +- **THEN** the next ad-hoc request for `(softwarecatalogus, applications, query=X)` SHALL include `cached: false` +- **AND** the underlying SQL SHALL be re-executed against the now-updated row set + +#### Scenario: Transitioning an object evicts the ad-hoc cache +- **GIVEN** the cache contains an ad-hoc result for `(softwarecatalogus, applications, query=Y)` +- **WHEN** an `applications` row transitions state (firing `ObjectTransitionedEvent`) +- **THEN** the next ad-hoc request for `(softwarecatalogus, applications, query=Y)` SHALL include `cached: false` diff --git a/openspec/changes/add-aggregation-enhancements/tasks.md b/openspec/changes/add-aggregation-enhancements/tasks.md new file mode 100644 index 000000000000..a15433f50b85 --- /dev/null +++ b/openspec/changes/add-aggregation-enhancements/tasks.md @@ -0,0 +1,39 @@ +# Tasks — Time-bucket aggregation enhancements + +## 1. Backend — MySQL / SQLite native bucketing (#1609) + +- [x] 1.1 Detect the active database platform inside `AggregationRunner::tryNativeAggregation()`. Existing code branches on `PostgreSQL`; extend the branch to also match `MySQL` and `SQLite` platform class names from `OCP\IDBConnection::getDatabasePlatform()`. Non-matching platforms still fall through to the PHP path. +- [x] 1.2 Extract the per-gap format-string lookup tables for MySQL (`DATE_FORMAT`) and SQLite (`strftime`) into private static helper methods (`mysqlBucketExpression()`, `sqliteBucketExpression()`). Each returns the full SQL expression `(, '') AS bucket` or the `CASE` form for `quarter` / week-Monday. +- [x] 1.3 Wire the helpers into the `if ($dateBucket !== null)` branch of `tryNativeAggregation()`. The `whereSql` / bindings construction stays unchanged; only the bucket expression and the identifier-quoting (backticks on MySQL vs double-quotes on Postgres/SQLite) differ. +- [x] 1.4 Surface the platform name in the response `backend` field. The dispatch site already wraps `tryNativeAggregation()` return with `'backend' => 'postgres'`; extend it to return `'mysql'` or `'sqlite'` when the matching platform served the query. Use a small `detectDatabasePlatform()` private helper that returns the lowercased platform short name. +- [x] 1.5 The `coerceBucketKey()` helper continues to normalize keys defensively. MySQL/SQLite emit the canonical `Y-m-d\TH:i:s\Z` directly, so `coerceBucketKey()` is a no-op on those keys — verified by passing the emitted format strings through `strtotime` round-trip in the unit test. + +## 2. Backend — Ad-hoc cache (#1610) + +- [x] 2.1 Add `AggregationQuery::toArray(): array` returning `['metric' => $metric, 'field' => $field, 'filter' => , 'groupBy' => $groupBy, 'dateBucket' => $dateBucket]`. Filter sub-arrays are ksort-sorted recursively so two structurally-equivalent filters hash to the same value. +- [x] 2.2 Add `AggregationCache::getAdhoc(string $registerSlug, string $schemaSlug, AggregationQuery $query): ?array` and the matching `setAdhoc(...)` writer. Both wrap the existing `get()`/`set()` with the name slot computed as `'adhoc:'.sha1(json_encode($query->toArray()))`. Filter content goes through the existing `filter` parameter for the inner key derivation. +- [x] 2.3 Wire `AggregationRunner::runAdhoc()` to call `cache->getAdhoc()` on entry: cache hit returns the stored envelope with `cached: true`. Cache miss falls through to the existing native-or-fallback dispatch, then writes the envelope back via `setAdhoc()` (with `cached: false`, which is rewritten to `cached: true` on the next hit). +- [x] 2.4 No changes to `AggregationCacheInvalidationListener` — the existing global `ICache::clear()` on object lifecycle events covers ad-hoc entries because they share the cache instance. Document this in the design doc and the cache class doc-block. + +## 3. Tests + +- [x] 3.1 `tests/Unit/Service/Aggregation/AggregationQueryTest.php` — add cases: `toArray()` round-trips through every field; `toArray()` is stable under filter-key reordering (`{a, b}` and `{b, a}` produce identical SHA-1 hashes); `toArray()` includes `dateBucket` when set; `toArray()` returns null for missing optional fields. +- [x] 3.2 `tests/Unit/Service/Aggregation/AggregationCacheTest.php` — add cases: `getAdhoc()` returns null on miss; `setAdhoc()` then `getAdhoc()` round-trips a result envelope; ad-hoc and named cache entries don't collide (a `set()` with `name='foo'` and a `setAdhoc()` with a query whose hash equals `'foo'` are independent because of the `'adhoc:'` prefix); `evictForSchema()` removes both kinds of entries (via the underlying `ICache::clear()`). +- [x] 3.3 `tests/Unit/Service/Aggregation/AggregationRunnerNativeBucketTest.php` — new file. Use `MySQLPlatform` / `SqlitePlatform` / `PostgreSQLPlatform` mocks for the `IDBConnection::getDatabasePlatform()` return value; assert the emitted SQL contains `DATE_FORMAT(\`\`, '%Y-%m-%dT00:00:00Z')` for MySQL `gap=day`; verify backtick identifier quoting; verify backend annotation flips per platform; pin the `%i` vs `%M` minute placeholder divergence between MySQL and SQLite. +- [x] 3.4 (merged into 3.3 — single file covers all three native platforms + unknown-platform fallthrough) +- [x] 3.5 `tests/Unit/Service/Aggregation/AggregationRunnerAdhocCacheTest.php` — new file. Test: cache hit flips `cached` flag and skips the underlying dispatch; cache miss populates the cache with the same envelope; the resolved query reaches both `getAdhoc()` and `setAdhoc()` callbacks unchanged. +- [x] 3.6 Run the full `Unit Tests` suite — stays green (113 aggregation tests pass). + +## 4. Quality gates + +- [x] 4.1 PHPCS strict — clean on all touched files (`./vendor/bin/phpcs --standard=phpcs.xml lib/Service/Aggregation/`). +- [x] 4.2 PHPMD strict — clean on all touched files (targeted `@SuppressWarnings` on `TooManyMethods` at class level, `ExcessiveMethodLength`/`StaticAccess` on `runAdhoc()`, `ElseExpression` on `tryNativeAggregation()` to cover platform branches). +- [x] 4.3 Psalm strict — `No errors found!` on touched files. +- [x] 4.4 PHPStan level 8 — clean on touched files. +- [x] 4.5 PHPUnit — full `Unit Tests` suite green inside the dev container. + +## 5. Documentation + +- [x] 5.1 `docs/technical/aggregation-api.md` — backend matrix rewritten as a per-engine table (`postgres` / `mysql` / `sqlite` / `php-fallback`). Added a "Cache" section documenting the 60 s TTL, the read-through pattern, the key-stability semantics, the RBAC scoping, the lifecycle-event invalidation, and the stampede-tolerance position. Performance-notes section updated to drop the "Postgres-only native" caveat. +- [x] 5.2 `openspec/platform-capabilities.md` — aggregations row updated: native fast path now covers Postgres/MySQL/SQLite; ad-hoc cache + invalidation listener documented. +- [x] 5.3 `design.md` cross-linked from the proposal so the next pickup of #1606/#1607/#1608 finds the deferred-design notes via the breadcrumb trail. diff --git a/openspec/changes/add-time-bucket-aggregation/.openspec.yaml b/openspec/changes/add-time-bucket-aggregation/.openspec.yaml new file mode 100644 index 000000000000..af43829ce6ae --- /dev/null +++ b/openspec/changes/add-time-bucket-aggregation/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-05-21 diff --git a/openspec/changes/add-time-bucket-aggregation/design.md b/openspec/changes/add-time-bucket-aggregation/design.md new file mode 100644 index 000000000000..c0f2489df624 --- /dev/null +++ b/openspec/changes/add-time-bucket-aggregation/design.md @@ -0,0 +1,191 @@ +## Context + +OpenRegister exposes two aggregation surfaces today: + +1. **Named declarative aggregations** — schema-author declares an `x-openregister-aggregations` block on a schema; `/api/objects/aggregations/{register}/{schema}/{name}` resolves it through `AggregationRunner`. Backend dispatch (Postgres native → PHP fallback) ships in the in-flight `aggregations-backend-native` change; Solr + ES translators are merged but not yet wired into `AggregationRunner::run()`. +2. **GraphQL `aggregate: 'count'`** — every auto-generated list query returns a `totalCount` field. No grouping, no bucketing. + +Neither lets a client say *"group this collection by `created` truncated to DAY, between `from` and `to`, return `{ key, value }`"* — which is the exact primitive every Conduction dashboard chart needs. Worked example: the openconnector dashboard wants 6 charts (Calls daily/hourly, Jobs daily/hourly, Sync daily/hourly). Each chart is a single bucketed query. Today the only path is a chart-specific named annotation per app, which is a schema-deploy round-trip per chart per app. + +The cross-backend value object `AggregationQuery` already declares `dateBucket: { field, start, end, gap }` (shipped with `aggregations-backend-native` task 1.1) and the Solr / Elasticsearch translators (`SolrAggregationQueryBuilder`, `ElasticsearchAggregationQueryBuilder`) already honour it. What is missing is: + +- Postgres translation (`date_trunc($gap, "$field")`). +- A REST entry point that builds an `AggregationQuery` from query params and calls the runner directly (the existing `AggregationController` only resolves named annotations). +- A GraphQL `groupBy: GroupByInput` argument on auto-generated list queries that does the same. + +Constraints / stakeholders: +- `nextcloud-vue` `CnChartWidget.dataSource` grows a `bucket` shorthand the moment OR ships this; openconnector dashboard blocked on it. +- Every Conduction app eventually consumes the primitive — response shape must stay stable across apps, REST, and GraphQL. +- ADR-031 says prefer declarative `x-openregister-aggregations` over service-class aggregation. This work is **not** a service-class aggregation; it is a query primitive on the existing runtime, controlled per-request by the client. ADR-031 still applies for named, app-owned aggregations (KPI tiles, business-rule counts). +- ADR-032 says split mixed config-and-code. This work is `kind: code` only (PHP runner + GraphQL resolver + REST controller). No schema register patches. +- ADR-005 (security): all reads pass row-level RBAC + multi-tenant filter. Aggregation runs AFTER the filter is applied to the row set. Field allow-listing prevents arbitrary column access. + +## Goals / Non-Goals + +**Goals:** +- One ad-hoc bucketing primitive available on both REST and GraphQL with the same response shape `{ groups: [{ key, value }] }`. +- Postgres-native execution via `date_trunc($gap, "$field")` for `interval`-bucketed queries; categorical groupBy already shipped. +- Cross-backend forward-compat: Postgres now, Solr / ES already-translated (just need the runner dispatch wired by `aggregations-backend-native`). +- Field allow-listing enforced at the controller / resolver layer using the schema's declared property list — no arbitrary column access. +- Row-level RBAC + multi-tenant filter is applied identically to the existing native aggregation path; the `_organisation = ?` predicate is reused (no new code path that could bypass it). +- Documentation: `aggregation-api` spec covers REST + GraphQL semantics; `graphql-api` spec gains a delta for the new arg. + +**Non-Goals:** +- Multi-field `groupBy` — one field per query only. A second field would explode the result set and most chart libraries can't render multi-dim. Follow-up issue. +- Running / cumulative / windowed aggregates. Follow-up issue. +- Multi-metric in one request (`count` + `sum` at the same time). Each request is one metric. Follow-up issue. +- Cross-schema `groupBy`. Each query runs against one register/schema's magic table. +- MySQL / SQLite native bucketing. Postgres only; non-Postgres returns `null` from `tryNativeAggregation` and the runner falls back to PHP-side bucketing (slow but correct). Documented. +- Caching of ad-hoc bucket queries. `AggregationCache` is keyed on `(register, schema, name, filter, rbac)` where `name` is the annotation name; ad-hoc queries have no `name`. Cache key extension is a follow-up issue. +- Replacing the `aggregate: 'count'` GraphQL arg or the `x-openregister-aggregations` named-annotation surface. Both stay. + +## Decisions + +### D1 — Reuse `AggregationQuery::dateBucket` value object as-is + +**Decision:** Build the new REST endpoint + GraphQL resolver on top of the already-shipped `AggregationQuery::create(metric, field, filter, groupBy, dateBucket)` factory. No new value object. + +**Rationale:** The value object already encodes the constraint surface (gap vocabulary `minute|hour|day|week|month|quarter|year`, required `{field, start, end, gap}` shape, mutual exclusion with `groupBy`). Adding a parallel input shape would diverge and risk drift between REST and GraphQL. + +**Alternatives:** Introduce a separate `TimeseriesQuery` value object — rejected because it would duplicate validation already in `AggregationQuery::assertValidDateBucket`. + +### D2 — Postgres native path: `date_trunc($gap, "$field")` + explicit bounds + +**Decision:** In `AggregationRunner::tryNativeAggregation()`, when `dateBucket` is non-null, emit: + +```sql +SELECT date_trunc(?, "field") AS bucket, COUNT(*) AS agg +FROM "oc_
" +WHERE AND "field" >= ? AND "field" < ? +GROUP BY 1 +ORDER BY 1 +``` + +Bind `gap`, `start`, `end` as the first three placeholders. Validate `gap` against the same `DATE_BUCKET_GAPS` allow-list `AggregationQuery` enforces. Sanitise `field` via the existing `sanitizeColumnName()` helper. Bucket key is returned as Postgres timestamp text (ISO-8601-ish); the controller / resolver coerces it to an ISO-8601 string before serialising. + +**Rationale:** `date_trunc` is the canonical Postgres bucketing primitive; it's index-friendly when the bucketed field has a btree index (recommended in docs). Explicit `from`/`to` bounds keep the predicate sargable. Empty `start`/`end` are allowed (= no bound) — but the REST endpoint requires both (no unbounded scans from HTTP). + +**Alternatives:** `generate_series` to fill empty buckets — rejected because (a) the client can fill empties at render time more cheaply, (b) `generate_series` doesn't compose with the RBAC `WHERE`. Documented as a follow-up if charting clients complain. + +### D3 — Field allow-listing via schema property list + +**Decision:** Both the REST controller and the GraphQL resolver validate `dateBucket.field` and `groupBy.field` against `Schema::getProperties()` keys before constructing the `AggregationQuery`. Bucketed (interval-bucketed) fields must additionally have `format: date | date-time` or `type: integer` (timestamp epoch). Unknown / non-bucketable fields → `400 Bad Request` / GraphQL field-error. + +**Rationale:** `sanitizeColumnName` defends against SQL injection (it must — it's user input that lands in raw SQL) but it does NOT prevent reading columns the user could not otherwise see (e.g. `_owner`, magic-table metadata). Schema-property allow-listing is the second layer: only declared properties of the schema may be aggregated. + +**Alternatives:** Allow magic-table metadata cols (`_created`, `_updated`) — done, but only for that specific allow-list (`{ _created, _updated, _deleted_at }`), not all `_*` cols. RBAC field rules (`PropertyRbacHandler`) already apply to read; the aggregator MUST honour the same denial. + +### D4 — REST endpoint shape: dedicated `/aggregate/timeseries` action + +**Decision:** New route `GET /api/objects/{register}/{schema}/aggregate/timeseries` registered in `appinfo/routes.php` with handler `AggregationController::timeseries()`. Query params: + +- `field` (required) — field to bucket on. +- `interval` (optional, default = categorical groupBy) — one of `MINUTE|HOUR|DAY|WEEK|MONTH|QUARTER|YEAR`. +- `from`, `to` (required when `interval` set) — ISO-8601 strings. +- `metric` (optional, default `count`) — one of `count|sum|avg|min|max`. +- `metricField` (required when `metric != count`) — field to aggregate over. +- `filter[][]=` — reuses the existing object-collection filter vocabulary. + +Response: `{ groups: [{ key, value }], backend, cached }` — same body as the GraphQL `groups` field. + +**Rationale:** Co-locating with the named-aggregation route under `/aggregate/` keeps namespace clarity. `timeseries` is the ad-hoc surface; `aggregations/{name}` stays the annotation-named surface. Both go through `AggregationRunner`. + +**Alternatives:** Extend the existing `/api/objects/{register}/{schema}` listing with `?aggregate=timeseries&...` — rejected because the listing response shape is `{ results, total, page }` and would have to either grow a new top-level field or fork. Dedicated endpoint = stable contract. + +### D5 — GraphQL: optional `groupBy` arg on the auto-generated list query + +**Decision:** `SchemaGenerator::buildQueryFields()` adds an optional `groupBy: GroupByInput` argument to every list-query field via `TypeMapperHandler::getListArgs()`. Types: + +```graphql +input GroupByInput { + field: String! + interval: TimeInterval + from: String + to: String + metric: AggregationMetric + metricField: String +} + +enum TimeInterval { MINUTE HOUR DAY WEEK MONTH QUARTER YEAR } +enum AggregationMetric { COUNT SUM AVG MIN MAX } + +type GroupBucket { key: String! value: Float! } + +# the existing Connection type grows: +type Connection { + edges: [...] + pageInfo: ... + totalCount: Int + groups: [GroupBucket!] # NEW — null when groupBy not requested +} +``` + +`GraphQLResolver::resolveList()` reads `args.groupBy`, builds an `AggregationQuery`, calls `AggregationRunner::runAdhoc()` (new method — extracted shared path), and attaches `groups` to the connection result. When `groupBy` is absent the field returns `null` (not an empty array — `null` is "not requested"). + +**Rationale:** A dedicated `GroupByInput` keeps the existing list args (`filter`, `sort`, `first`, etc.) un-touched; clients opt in. + +**Alternatives:** A separate root-level `groupBy` query field — rejected because it duplicates the filter / sort / RBAC plumbing that already lives in `resolveList()`. Sharing the resolver means one auth path, one filter parser, one cache eviction story. + +### D6 — Shared adhoc path: `AggregationRunner::runAdhoc(AggregationQuery $q)` + +**Decision:** Introduce a new public method on `AggregationRunner` that takes a fully-built `AggregationQuery` + the `(Register, Schema, $currentUid)` triple and returns the same `{ value, groups, backend, cached? }` shape `run()` already returns. The existing `run($registerRef, $schemaRef, $name)` keeps loading the annotation by name and continues to delegate to the same private execution helper. + +**Rationale:** Both REST `timeseries()` and GraphQL `resolveList()` would otherwise duplicate the RBAC check + backend-selection logic that `run()` performs. Extracting `runAdhoc()` makes the named and ad-hoc paths share the execution helper. + +**Alternatives:** Have the controller / resolver call private methods on the runner via reflection — rejected (breaks Psalm). Have them call the SQL directly — rejected (duplicates RBAC predicate). + +### D7 — Multi-tenant predicate, RBAC, and audit + +**Decision:** +- `runAdhoc()` calls `OrganisationService::getActiveOrganisation()` exactly like the existing `tryNativeAggregation()` and binds `_organisation = ?`. `null` active org → no rows (fail-closed). +- `PermissionHandler::canRead($schema)` is consulted before any SQL is built; deny → `NotAuthorizedException` → HTTP 403 / GraphQL error. +- Field allow-listing per D3 happens before the predicate so we don't leak the existence of a field by giving a different error code. +- No audit row is written for aggregate reads (consistent with the existing `/aggregate/{name}` path). + +**Rationale:** Reuse the existing security primitives so the new surface inherits every fix that lands on the named path. Field allow-listing precedes auth-check so the response stays consistent. + +### D8 — Non-Postgres fallback path + +**Decision:** When `tryNativeAggregation()` returns `null` (e.g. SQLite test DB, MySQL dev box), the PHP-side runner pulls matching rows + groups them in PHP using the same bucket logic (`date_trunc` polyfill: strtotime + `format()` based on `gap`). Marked `backend: "php-fallback"` in the response. + +**Rationale:** OR's production target is Postgres; SQLite is used for tests and trivial dev setups. PHP fallback keeps tests green without forcing every CI runner to be Postgres-only. Performance disclaimer in docs. + +### D9 — Declarative-vs-imperative decision (ADR-031) + +The behaviours touched here are: + +| Behaviour | Path | Rationale | +|---|---|---| +| Ad-hoc bucketing primitive | **imperative** (PHP runner extension) | ADR-031 §"declarative path applies to **named** behaviours" — this is an ad-hoc query primitive controlled per-request by the client, not a schema-author-declared behaviour. There is no `x-openregister-*` annotation that would express "let the client bucket whatever they want at request time". | +| Named aggregations (`x-openregister-aggregations`) | **declarative** (existing — unchanged) | Already declarative; this change does NOT touch the annotation path. | +| Field allow-list | **declarative** (read from `Schema::getProperties()`) | Each schema's property list is already the canonical source of truth for what's queryable. | + +No new service class is introduced — `AggregationRunner` already exists and is the right home. No `lib/Settings/openregister_register.json` patches. + +## Risks / Trade-offs + +- **[SQL-injection on `field`]** → Mitigated: `sanitizeColumnName()` allow-lists `[a-zA-Z0-9_]` and the schema-property check ensures the column was declared. Both gates run before binding. +- **[Unbounded scan with missing `from`/`to`]** → Mitigated: REST endpoint requires both when `interval` is set; categorical groupBy (no `interval`) doesn't require bounds because it scans within the schema's RBAC-filtered row set anyway. +- **[Postgres `date_trunc` returns timestamps with tz]** → Mitigated: cast to text in SQL (`date_trunc(?, "$field")::text AS bucket`) so PHP receives an ISO-ish string; resolver coerces to `Y-m-d\TH:i:s\Z` for response stability across Postgres versions / timezone settings. +- **[GraphQL connection-type breaking change]** → Mitigated: `groups` is a new nullable field; existing clients that don't request it see nothing change. Schema introspection still returns the same set of existing fields. +- **[Bucket keys drift between Postgres / Solr / ES]** → Mitigated: the spec mandates the response shape; per-backend translators must produce ISO-8601-UTC strings. Translator tests assert the wire shape. +- **[PHP fallback at 100k rows]** → Mitigated: documented + perf note in `aggregation-api` spec; Postgres is the production target. The PHP fallback is correct, not fast. +- **[Cache misses on ad-hoc queries]** → Mitigated: each ad-hoc request will hit Postgres. `AggregationCache` keying extension is a follow-up issue — for now `cached: false` is always emitted on the ad-hoc path. +- **[`groupBy` arg vs `aggregate: 'count'` arg confusion]** → Mitigated: existing `aggregate` arg stays; spec.md clearly delineates "count aggregate" (one number for the whole set, returned as `totalCount`) vs "groupBy bucket" (a series of bucket→value pairs, returned as `groups`). + +## Migration Plan + +- **Deploy:** Single PR, single OR release. No schema migration, no register/schema author action required. The new endpoint is a pure addition; the new GraphQL arg is an additive type-system change (clients that don't request it see no diff). +- **Rollback:** Revert the PR. Existing `aggregate: 'count'` + named-annotation surface continues to work because both are untouched. +- **Consumer rollout:** + 1. OR ships this change. + 2. `nextcloud-vue` `CnChartWidget.dataSource` grows the `bucket` shorthand. + 3. openconnector dashboard rebuild consumes it (6 charts). + 4. Fleet apps adopt the primitive opportunistically; the named-annotation surface remains the right home for app-owned KPIs. + +## Open Questions + +1. **Bucket key format on Postgres for `interval=DAY`** — `date_trunc('day', ...)` returns `2026-05-21 00:00:00+00`. Coerce to `2026-05-21` (date-only) or keep full ISO? **Decided: keep full ISO** — consistent across intervals; charts crop the date portion themselves. +2. **`HOUR` granularity on a `date` (not `datetime`) field** — should the schema-property check reject? **Decided: yes** — the field's declared `format` must be `date-time` for sub-day intervals; `date` only allows DAY+. Validation error code `400`. +3. **Empty-bucket fill** — if a day has zero rows, do we emit `{key, value: 0}` or omit it? **Decided: omit it** (Postgres `GROUP BY` doesn't emit empty groups). Client fills empties at render time. `generate_series` is a follow-up. +4. **Should the REST `/aggregate/timeseries` route mirror the path layout of `/aggregations/{name}`** (i.e. `/api/objects/aggregations/{register}/{schema}/timeseries`)? **Decided: yes — `/api/objects/aggregations/{register}/{schema}/timeseries`** to keep the namespace tidy. The `{name}` route stays `/api/objects/aggregations/{register}/{schema}/{name}`; routing dispatches `timeseries` to the new action because route order in `appinfo/routes.php` is "specific before wildcard" (memory: route ordering). diff --git a/openspec/changes/add-time-bucket-aggregation/proposal.md b/openspec/changes/add-time-bucket-aggregation/proposal.md new file mode 100644 index 000000000000..c1e84cdc0e4f --- /dev/null +++ b/openspec/changes/add-time-bucket-aggregation/proposal.md @@ -0,0 +1,60 @@ +--- +kind: code +depends_on: [] +--- + +# Time-bucket aggregation across GraphQL + REST + +## Why + +Every Conduction-app dashboard needs the same ad-hoc primitive: "group these rows by day-of-`created` between `from` and `to` and return `{ key, value }` series." The openconnector dashboard rebuild (6 KPIs + 6 charts — Calls daily/hourly, Jobs daily/hourly, Sync daily/hourly) is blocked on it today, and `nextcloud-vue` `CnChartWidget.dataSource` cannot grow its `bucket: { field, interval, fromVar, toVar }` shorthand until OR exposes the underlying primitive. + +OR's current aggregation surface is two-half: GraphQL collection queries support `aggregate: 'count'` (returns `totalCount`) but no grouping; REST `AggregationController` runs **named, schema-declared** aggregations from `x-openregister-aggregations` annotations (`/api/objects/aggregations/{register}/{schema}/{name}`). Neither lets a client say "bucket arbitrary field `created` by `DAY` between `from` and `to`" without first round-tripping a schema-annotation deploy. The in-flight `aggregations-backend-native` change shipped the `AggregationQuery::dateBucket` value-object field but did NOT wire it through to Postgres native execution, REST, or GraphQL. + +## What Changes + +- **GraphQL**: extend the auto-generated list query on every schema with a new optional argument `groupBy: GroupByInput`, where `GroupByInput = { field: String!, interval: TimeInterval, from: String, to: String }` and `TimeInterval = DAY | HOUR | WEEK | MONTH`. When `groupBy` is supplied, the connection returns `groups: [{ key: String!, value: Int! }]` alongside the existing `totalCount` / `edges` / `pageInfo`. When `interval` is omitted, the result is categorical grouping (e.g. by `status`); when present, the named field is `date_trunc`'d to the interval and rows outside `from`/`to` are excluded. +- **REST**: add `GET /api/objects/{register}/{schema}/aggregate/timeseries?field=&interval=&from=&to=&filter[...]=` returning `{ groups: [{ key, value }], backend: "postgres" | "php-fallback", cached: bool }`. Same row-level filtering (multi-tenancy + RBAC) as the regular `/objects` list. Filter params reuse the existing `_search`/`filter[...]` operator vocabulary. +- **Backend**: extend `AggregationRunner::tryNativeAggregation()` to honour `AggregationQuery::dateBucket` via Postgres `date_trunc($gap, "$field")` — with explicit `WHERE "$field" >= ? AND "$field" < ?` bounds when `start`/`end` are set. SQLite + MySQL fall back to the existing PHP path (documented; OR's primary platform is Postgres). +- **Cross-backend**: AggregationQuery already has `dateBucket: { field, start, end, gap }` plumbed through to Solr (`facet.range`) and Elasticsearch (`date_histogram`). This change unblocks them by exercising the field end-to-end and adding Postgres as a third translator-target. +- **Security**: bucketing happens AFTER row-level RBAC + multi-tenant filtering (same `_organisation = ?` predicate `tryNativeAggregation` already enforces). Field allow-listing: only datetime-shaped properties from the schema may be used as `interval`-bucketed fields; only properties declared on the schema may be used as `groupBy.field` (no arbitrary column access). +- **Response shape parity**: the REST timeseries response and the GraphQL `groups` field MUST emit the same `{ key: , value: }` element shape so `CnChartWidget` can normalise once. +- **Documentation**: extend `openspec/specs/graphql-api/spec.md` with the `groupBy` requirement + scenarios; create new `aggregation-api` spec covering both REST + GraphQL ad-hoc bucketing semantics. + +**Non-breaking.** Adds optional GraphQL argument + new REST endpoint. The existing `aggregate: 'count'` GraphQL arg, the existing `/api/objects/aggregations/{register}/{schema}/{name}` route, and the existing `x-openregister-aggregations` annotation surface all continue to work unchanged. + +## Capabilities + +### New Capabilities +- `aggregation-api`: ad-hoc aggregation primitive across REST + GraphQL — categorical groupBy on a schema field + time-bucketed groupBy via `date_trunc` with optional `from`/`to` bounds. Distinct from `x-openregister-aggregations` annotations (which are **named**, schema-declared, and resolve through `AggregationController`) — this capability covers the runtime, client-controlled primitive. + +### Modified Capabilities +- `graphql-api`: list queries gain an optional `groupBy: GroupByInput` argument; the auto-generated connection types gain a `groups: [GroupBucket!]` field on the response. Existing `totalCount` / `edges` / `pageInfo` behaviour unchanged. + +## Impact + +**Code touched:** +- `lib/Service/Aggregation/AggregationRunner.php` — extend `tryNativeAggregation()` with `dateBucket` path (Postgres `date_trunc`). +- `lib/Service/GraphQL/SchemaGenerator.php` + `lib/Service/GraphQL/SchemaGenerator/TypeMapperHandler.php` — new `GroupByInput`, `TimeInterval` enum, `GroupBucket` type; thread `groupBy` arg into list-query field args. +- `lib/Service/GraphQL/GraphQLResolver.php` — extract `groupBy` arg, call `AggregationRunner` (or build an `AggregationQuery` directly + dispatch), surface `groups` on the connection result. +- `lib/Controller/AggregationController.php` — new `timeseries()` action OR a new sibling controller (`AggregateController`) to keep route ownership clean. +- `appinfo/routes.php` — register the new REST timeseries route. +- Tests: `tests/Unit/Service/Aggregation/AggregationRunnerDateBucketTest.php`, `tests/Unit/Controller/Aggregation*Test.php`, `tests/Unit/Service/GraphQL/SchemaGeneratorGroupByTest.php`, `tests/Integration/GraphQLGroupByIntegrationTest.php`. +- Docs: `docs/annotations/x-openregister-aggregations.md` gains a "Runtime ad-hoc primitive" note pointing at the new spec. + +**APIs:** +- New: `GET /api/objects/{register}/{schema}/aggregate/timeseries`. +- Extended: every auto-generated GraphQL list field — added optional `groupBy` arg + `groups` field on the connection. + +**Dependencies / consumers:** +- Unblocks `nextcloud-vue` `CnChartWidget.dataSource` `bucket: { field, interval, fromVar, toVar }` shorthand. +- Unblocks the openconnector dashboard rebuild (6 charts). +- Every Conduction app dashboard (procest, pipelinq, decidesk, shillinq, etc.) will eventually consume this primitive — the response shape MUST stay stable. + +**Non-goals (deferred to follow-up issues, filed at planning time):** +- Multi-field `groupBy` (one field per query only) — [#1606](https://github.com/ConductionNL/openregister/issues/1606). +- Running-window aggregates / cumulative series — [#1607](https://github.com/ConductionNL/openregister/issues/1607). +- Multi-metric (`count` + `sum` simultaneously); each request is one metric — [#1608](https://github.com/ConductionNL/openregister/issues/1608). +- MySQL / SQLite native bucketing (PHP fallback only for now) — [#1609](https://github.com/ConductionNL/openregister/issues/1609). +- Caching of ad-hoc bucket queries — `AggregationCache` is keyed on the named-aggregation name; ad-hoc cache keying is — [#1610](https://github.com/ConductionNL/openregister/issues/1610). +- `groupBy` on the JOIN side of cross-schema queries (no issue — explicitly out of scope for the primitive). diff --git a/openspec/changes/add-time-bucket-aggregation/specs/aggregation-api/spec.md b/openspec/changes/add-time-bucket-aggregation/specs/aggregation-api/spec.md new file mode 100644 index 000000000000..7b41d9d38e8e --- /dev/null +++ b/openspec/changes/add-time-bucket-aggregation/specs/aggregation-api/spec.md @@ -0,0 +1,125 @@ +## ADDED Requirements + +### Requirement: The system SHALL expose an ad-hoc aggregation primitive over REST and GraphQL + +OpenRegister SHALL surface a runtime, client-controlled aggregation primitive that buckets the rows of a single register-schema collection by a named field, with optional time-bucketing via a `date_trunc`-style interval and optional `from`/`to` bounds. This primitive is distinct from the named-annotation surface (`x-openregister-aggregations` resolved via `/api/objects/aggregations/{register}/{schema}/{name}`): the named surface is schema-author-declared; this primitive is client-controlled per request. + +The primitive SHALL be available on both REST and GraphQL with the same response shape `{ groups: [{ key: String, value: Number }] }`, where `key` is the bucket label (categorical: the value of the groupBy field; bucketed: an ISO-8601-UTC string at the bucket-start) and `value` is the aggregated metric (count, sum, avg, min, or max). + +#### Scenario: Categorical groupBy over the REST endpoint +- **GIVEN** a register `softwarecatalogus`, schema `applications` with property `status: string` +- **WHEN** the client issues `GET /api/objects/aggregations/softwarecatalogus/applications/timeseries?field=status` +- **THEN** the response status SHALL be `200` +- **AND** the response body SHALL match `{ groups: [{ key: String, value: Int }], backend: "postgres" | "php-fallback", cached: Boolean }` +- **AND** every `groups[i].key` SHALL be a distinct value of `status` present in the RBAC-filtered row set +- **AND** every `groups[i].value` SHALL equal the COUNT of rows in that bucket + +#### Scenario: Time-bucketed groupBy by DAY over the REST endpoint +- **GIVEN** a register `openconnector`, schema `calllogs` with property `created: date-time` +- **WHEN** the client issues `GET /api/objects/aggregations/openconnector/calllogs/timeseries?field=created&interval=DAY&from=2026-05-01T00:00:00Z&to=2026-05-22T00:00:00Z` +- **THEN** the response status SHALL be `200` +- **AND** every `groups[i].key` SHALL be an ISO-8601-UTC string at midnight UTC on a day in the range `[from, to)` +- **AND** every `groups[i].value` SHALL equal the COUNT of `calllogs` whose `created` falls in that day-bucket +- **AND** buckets with zero rows SHALL be omitted from the response (the client fills empties at render time) + +#### Scenario: Time-bucketed groupBy by HOUR +- **GIVEN** the same schema as above +- **WHEN** the client issues the same request with `interval=HOUR&from=2026-05-21T00:00:00Z&to=2026-05-22T00:00:00Z` +- **THEN** every `groups[i].key` SHALL be an ISO-8601-UTC string at an hour boundary in the range +- **AND** the maximum number of buckets returned SHALL be `24` (one per hour) + +### Requirement: The REST timeseries endpoint SHALL validate inputs and reject malformed requests + +The endpoint `GET /api/objects/aggregations/{register}/{schema}/timeseries` SHALL enforce the following input rules and respond with `400 Bad Request` (and a JSON body `{ error: }`) on violation: + +- `field` MUST be a non-empty string and MUST be a declared property of `{schema}` OR one of the allow-listed magic-table metadata columns (`_created`, `_updated`, `_deleted_at`). Any other column name is rejected. +- If `interval` is provided, it MUST be one of `MINUTE|HOUR|DAY|WEEK|MONTH|QUARTER|YEAR` (case-insensitive). Other values are rejected. +- If `interval` is provided, both `from` AND `to` MUST be provided AND MUST be parseable as ISO-8601 datetimes. Missing or unparseable bounds are rejected. +- If `interval` requires sub-day granularity (`MINUTE`, `HOUR`), the field's schema property `format` MUST be `date-time` (a `date`-only field cannot be bucketed by hour). Sub-day interval against a `date`-format field is rejected. +- If `metric` is provided, it MUST be one of `count|sum|avg|min|max` (case-insensitive). Other values are rejected. +- If `metric` is not `count`, `metricField` MUST be provided and MUST be a declared property of `{schema}`. Missing `metricField` for a non-count metric is rejected. +- If both `interval` (time-bucket) AND a categorical `groupBy` clause are present (defensive — the endpoint does not currently accept categorical+temporal in one call), the request is rejected. + +#### Scenario: Unknown field is rejected +- **WHEN** the client requests `?field=__totally_made_up` +- **THEN** the response status SHALL be `400` +- **AND** the response body SHALL include `{ error: "" }` + +#### Scenario: Sub-day interval against date-only field is rejected +- **GIVEN** schema `meetings` with property `meetingDate: { type: string, format: date }` +- **WHEN** the client requests `?field=meetingDate&interval=HOUR&from=...&to=...` +- **THEN** the response status SHALL be `400` +- **AND** the response body SHALL state that sub-day intervals require a `date-time` field + +#### Scenario: Missing `from`/`to` when `interval` is set +- **WHEN** the client requests `?field=created&interval=DAY` with no `from` or `to` +- **THEN** the response status SHALL be `400` + +#### Scenario: Non-count metric without metricField +- **WHEN** the client requests `?field=status&metric=sum` +- **THEN** the response status SHALL be `400` + +### Requirement: The system SHALL apply row-level RBAC and multi-tenant filtering before bucketing + +Every ad-hoc aggregation request SHALL execute against a row set that has already been filtered by: + +1. The active organisation's multi-tenant predicate (`"_organisation" = ?` against the authenticated user's active organisation; null active org SHALL yield no rows). +2. The schema's read-permission check via `PermissionHandler::canRead($schema)` for the authenticated user. Denial SHALL produce HTTP `403 Forbidden` (REST) or a GraphQL field-error (GraphQL). +3. Soft-delete filtering (`_deleted IS NULL OR _deleted = 'null'::jsonb`) identical to the named-aggregation path in `AggregationRunner::tryNativeAggregation()`. +4. Property-level RBAC from `PropertyRbacHandler`: if `field` or `metricField` is denied for the authenticated user, the request SHALL be rejected with `403`. + +#### Scenario: Aggregation respects multi-tenant filter +- **GIVEN** two tenants `tenant-a` and `tenant-b`, each owning 10 rows in schema `calllogs` +- **AND** the authenticated user's active organisation is `tenant-a` +- **WHEN** the client requests `?field=created&interval=DAY&from=...&to=...` +- **THEN** the sum of `groups[*].value` SHALL be `10` (only tenant-a rows) +- **AND** no tenant-b row SHALL be counted + +#### Scenario: Forbidden schema returns 403 +- **GIVEN** the authenticated user lacks read permission on schema `applications` +- **WHEN** the client requests `?field=status` +- **THEN** the response status SHALL be `403` + +### Requirement: The system SHALL use Postgres `date_trunc` for native bucketing and fall back to PHP on other databases + +When the underlying database is PostgreSQL, the aggregator SHALL execute a single `SELECT date_trunc($gap, "$field")::text AS bucket, AS agg FROM
WHERE AND "$field" >= ? AND "$field" < ? GROUP BY bucket ORDER BY bucket` query and SHALL annotate the response with `backend: "postgres"`. + +When the database is not PostgreSQL (e.g. SQLite test fixtures, MySQL dev environments), the aggregator SHALL pull the RBAC-filtered row set, bucket in PHP using a `date_trunc` polyfill keyed on the `gap` vocabulary (`minute|hour|day|week|month|quarter|year`), and SHALL annotate the response with `backend: "php-fallback"`. The PHP path SHALL produce the same response shape and the same bucket-key format. + +#### Scenario: Postgres path annotates `backend: "postgres"` +- **GIVEN** the database is PostgreSQL +- **WHEN** the client requests a DAY-bucketed series +- **THEN** the response SHALL include `backend: "postgres"` + +#### Scenario: Non-Postgres path annotates `backend: "php-fallback"` +- **GIVEN** the database is SQLite (test fixture) +- **WHEN** the client requests a DAY-bucketed series +- **THEN** the response SHALL include `backend: "php-fallback"` +- **AND** the bucket keys SHALL be ISO-8601-UTC strings matching what Postgres would have returned + +### Requirement: The aggregation primitive SHALL share a single execution helper across REST and GraphQL + +Both the REST `AggregationController::timeseries()` action and the GraphQL `GraphQLResolver::resolveList()` resolver SHALL build a single `OCA\OpenRegister\Service\Aggregation\AggregationQuery` value object and dispatch through one `AggregationRunner::runAdhoc(Register $r, Schema $s, AggregationQuery $q): array` method. + +`runAdhoc()` SHALL perform the RBAC + multi-tenant gating defined in this spec, then call the existing `tryNativeAggregation()` (extended with the `date_trunc` path) on Postgres, or the PHP fallback otherwise. The return value SHALL match `{ groups: [{ key, value }], backend: string }` and the controller / resolver SHALL not perform additional row-level filtering on top of what `runAdhoc()` returns. + +#### Scenario: REST and GraphQL share execution path +- **WHEN** REST `GET /api/objects/aggregations/openconnector/calllogs/timeseries?field=created&interval=DAY&from=...&to=...` is called +- **AND** the equivalent GraphQL `query { calllogs(groupBy: { field: "created", interval: DAY, from: "...", to: "..." }) { groups { key value } } }` is called +- **THEN** both responses SHALL contain identical `groups` arrays (same keys, same values, same ordering) +- **AND** both responses SHALL be served by the same `AggregationRunner::runAdhoc()` invocation pattern + +### Requirement: The system SHALL document the ad-hoc aggregation primitive and its index recommendations + +OpenRegister SHALL ship documentation at `docs/annotations/x-openregister-aggregations.md` (or a sibling page linked from there) that: + +- Documents the REST endpoint, all query parameters, validation rules, and response shape. +- Documents the GraphQL `groupBy: GroupByInput` argument, the `GroupBucket` type, and the `TimeInterval` / `AggregationMetric` enums. +- Recommends a btree index on any field commonly used as a bucketing target (e.g. `created`, `updated`) for installations with large schemas. +- Clearly delineates the ad-hoc primitive from the named-annotation surface (`x-openregister-aggregations`), documenting when an app author SHOULD prefer one over the other. + +#### Scenario: Documentation describes both surfaces +- **WHEN** a developer reads the aggregation docs +- **THEN** they SHALL find a section "Runtime ad-hoc primitive" covering REST + GraphQL +- **AND** they SHALL find a section "Named declarative aggregations" linking to `x-openregister-aggregations` +- **AND** they SHALL find guidance on when to use which diff --git a/openspec/changes/add-time-bucket-aggregation/specs/graphql-api/spec.md b/openspec/changes/add-time-bucket-aggregation/specs/graphql-api/spec.md new file mode 100644 index 000000000000..ce89ec9dcb4b --- /dev/null +++ b/openspec/changes/add-time-bucket-aggregation/specs/graphql-api/spec.md @@ -0,0 +1,154 @@ +## ADDED Requirements + +### Requirement: GraphQL list queries SHALL support an ad-hoc `groupBy` argument with optional time-bucketing + +Every auto-generated list-query field on every schema SHALL accept an optional `groupBy: GroupByInput` argument. When supplied, the returned connection SHALL include a non-null `groups: [GroupBucket!]` field with the bucketed aggregation result. When `groupBy` is absent, `groups` SHALL be `null`. + +Type declarations (added to the auto-generated schema): + +```graphql +input GroupByInput { + field: String! + interval: TimeInterval + from: String # ISO-8601, required when interval is set + to: String # ISO-8601, required when interval is set + metric: AggregationMetric = COUNT + metricField: String # required when metric != COUNT +} + +enum TimeInterval { + MINUTE + HOUR + DAY + WEEK + MONTH + QUARTER + YEAR +} + +enum AggregationMetric { + COUNT + SUM + AVG + MIN + MAX +} + +type GroupBucket { + key: String! + value: Float! +} +``` + +#### Scenario: Categorical groupBy returns one bucket per distinct value +- **GIVEN** schema `applications` with property `status: string` and 30 rows distributed across `active|deprecated|archived` +- **WHEN** the client issues `query { applications(groupBy: { field: "status" }) { groups { key value } } }` +- **THEN** the response SHALL contain `groups` with exactly three entries +- **AND** each `groups[i].key` SHALL be one of `active`, `deprecated`, `archived` +- **AND** the sum of `groups[i].value` SHALL equal `30` + +#### Scenario: Time-bucketed groupBy by DAY produces ISO-keyed buckets +- **GIVEN** schema `calllogs` with `created: date-time` +- **WHEN** the client issues `query { calllogs(groupBy: { field: "created", interval: DAY, from: "2026-05-01T00:00:00Z", to: "2026-05-22T00:00:00Z" }) { groups { key value } } }` +- **THEN** each `groups[i].key` SHALL be an ISO-8601-UTC string at midnight UTC on a day in the range +- **AND** each `groups[i].value` SHALL equal the count of calllogs whose `created` falls in that day-bucket +- **AND** days with zero rows SHALL be omitted (the client fills empties at render time) + +#### Scenario: groupBy SHALL coexist with filter and totalCount +- **WHEN** the client issues `query { calllogs(filter: { status: "error" }, groupBy: { field: "created", interval: DAY, from: "...", to: "..." }) { totalCount groups { key value } } }` +- **THEN** the response SHALL include both `totalCount` (the size of the filtered set) AND `groups` (the bucketed series of the same filtered set) +- **AND** the sum of `groups[i].value` SHALL equal `totalCount` + +#### Scenario: Sub-day interval against a date-only field is rejected +- **GIVEN** schema `meetings` with `meetingDate: { format: date }` +- **WHEN** the client issues `query { meetings(groupBy: { field: "meetingDate", interval: HOUR, from: "...", to: "..." }) { groups { key value } } }` +- **THEN** the response SHALL include a GraphQL field-error stating that sub-day intervals require a `date-time` field +- **AND** the `groups` field SHALL be `null` + +#### Scenario: Unknown `field` produces a GraphQL field-error +- **WHEN** the client issues `groupBy: { field: "__totally_made_up" }` +- **THEN** the response SHALL include a GraphQL field-error referencing the unknown field +- **AND** the `groups` field SHALL be `null` + +#### Scenario: Multi-tenant filter is applied before bucketing +- **GIVEN** two tenants `tenant-a` and `tenant-b` each owning 10 rows +- **AND** the authenticated user's active organisation is `tenant-a` +- **WHEN** the client issues a categorical `groupBy` query +- **THEN** the sum of `groups[i].value` SHALL be `10` (tenant-a only) + +#### Scenario: Non-count metric requires metricField +- **WHEN** the client issues `groupBy: { field: "status", metric: SUM }` with no `metricField` +- **THEN** the response SHALL include a GraphQL field-error stating `metricField` is required for non-count metrics + +### Requirement: The connection type SHALL include the new `groups` field + +`TypeMapperHandler::getConnectionType()` SHALL add a nullable `groups: [GroupBucket!]` field to every auto-generated `Connection` type. When the resolver did not run an ad-hoc aggregation (the client did not request `groupBy`), the field SHALL be `null`. + +#### Scenario: Connection type structure includes `groups` +- **GIVEN** any schema `meldingen` +- **WHEN** `TypeMapperHandler.getConnectionType()` builds `MeldingenConnection` +- **THEN** the type SHALL include the fields: `edges`, `pageInfo`, `totalCount`, `facets`, `facetable`, AND `groups: [GroupBucket!]` +- **AND** existing clients that select only `edges`/`pageInfo`/`totalCount`/`facets`/`facetable` SHALL be unaffected + +## MODIFIED Requirements + +### Requirement: The GraphQL schema MUST be auto-generated from register schemas + +Each register schema MUST automatically produce corresponding GraphQL types, queries, and mutations. `SchemaGenerator.generate()` MUST load all registers via `RegisterMapper.findAll()` and all schemas via `SchemaMapper.findAll()`, then iterate over each schema calling `buildSchemaFields()` to produce query and mutation field definitions. Type generation MUST follow the same JSON Schema property type/format mapping used by `MagicMapper`, ensuring consistency between REST and GraphQL responses. Schema slugs MUST be converted to valid GraphQL names: PascalCase for type names (via `toTypeName()`) and camelCase for field names (via `toFieldName()`), with naive Dutch/English singularization (via `singularize()`) to derive single-object query names from plural schema slugs. + +#### Scenario: Generate GraphQL type from schema +- **GIVEN** a register schema `meldingen` with properties: title (string), status (string), priority (enum), created (datetime) +- **WHEN** `SchemaGenerator.generate()` is called +- **THEN** a GraphQL `ObjectType` named `Meldingen` (or its singularized PascalCase form) MUST be created via `getObjectType()` +- **AND** property types MUST be mapped by `TypeMapperHandler.mapPropertyToGraphQLType()`: string -> `Type::string()`, integer -> `Type::int()`, number -> `Type::float()`, boolean -> `Type::boolean()`, datetime -> `DateTimeType` scalar +- **AND** each type MUST include metadata fields: `_uuid` (UUID scalar), `_register` (Int), `_schema` (Int), `_created` (DateTime), `_updated` (DateTime), `_owner` (String) + +#### Scenario: Generate queries for a schema +- **GIVEN** schema `meldingen` exists with slug `meldingen` +- **WHEN** `buildQueryFields()` is called +- **THEN** the following root query fields MUST be generated: + - `melding(id: ID!): Melding` -- fetch single object via `GraphQLResolver.resolveSingle()` + - `meldingen(filter: MeldingenFilter, sort: SortInput, selfFilter: SelfFilter, search: String, fuzzy: Boolean, facets: [String], first: Int, offset: Int, after: String, groupBy: GroupByInput): MeldingenConnection` -- list with pagination via `GraphQLResolver.resolveList()`; the optional `groupBy` argument enables ad-hoc aggregation as defined under the "GraphQL list queries SHALL support an ad-hoc `groupBy` argument" requirement +- **AND** list query arguments MUST be defined by `TypeMapperHandler.getListArgs()` with defaults: `first: 20`, `fuzzy: false` + +#### Scenario: Generate mutations for a schema +- **GIVEN** schema `meldingen` exists +- **WHEN** `buildMutationFields()` is called +- **THEN** the following mutation fields MUST be generated: + - `createMelding(input: CreateMeldingInput!): Melding` -- delegates to `GraphQLResolver.resolveCreate()` + - `updateMelding(id: ID!, input: UpdateMeldingInput!): Melding` -- delegates to `GraphQLResolver.resolveUpdate()` + - `deleteMelding(id: ID!): Boolean` -- delegates to `GraphQLResolver.resolveDelete()` +- **AND** `CreateMeldingInput` MUST mark `required` fields from the schema as `Type::nonNull()` via `TypeMapperHandler.getCreateInputType()` +- **AND** `UpdateMeldingInput` MUST leave all fields nullable (partial updates) via `TypeMapperHandler.getUpdateInputType()` + +#### Scenario: Schema changes regenerate GraphQL types +- **GIVEN** schema `meldingen` has a GraphQL type `Melding` +- **WHEN** a property `urgentie` (integer) is added to the schema +- **THEN** the next call to `SchemaGenerator.generate()` MUST produce an updated `Melding` type including `urgentie: Int` +- **AND** existing queries using `Melding` without `urgentie` MUST continue to work (GraphQL field selection is additive) +- **AND** schema generation MUST be fast (~50ms for typical installs) since APCu caching of webonyx Schema objects is not feasible due to closures + +#### Scenario: Type name collision resolution +- **GIVEN** two schemas with slug `items` exist in different registers +- **WHEN** `toTypeName()` is called for both +- **THEN** the second schema's type MUST be disambiguated by appending its schema ID (e.g., `Items` and `Items42`) +- **AND** the `usedTypeNames` map MUST track which schema ID owns each type name + +### Requirement: GraphQL MUST support faceted search through connections + +Connection types MUST expose facets and facetable field lists matching `FacetHandler` behavior. This is a cross-reference to the `zoeken-filteren` spec. + +#### Scenario: Request facets in a list query +- **GIVEN** a query: `meldingen(facets: ["status", "priority"]) { edges { node { title } } facets facetable }` +- **WHEN** `argsToRequestParams()` processes the facets argument +- **THEN** it MUST set `$params['_facets'] = "status,priority"` (comma-separated) +- **AND** `ObjectService.searchObjectsPaginated()` MUST return facet data +- **AND** the connection response MUST include `facets` (JSON scalar with value counts per field) and `facetable` (list of field names) +- **AND** facets MUST be calculated on the full filtered dataset, independent of pagination + +#### Scenario: Facets in connection type structure +- **GIVEN** any schema `meldingen` +- **WHEN** `TypeMapperHandler.getConnectionType()` builds the connection type +- **THEN** it MUST include fields: `edges: [MeldingenEdge!]!`, `pageInfo: PageInfo!`, `totalCount: Int!`, `facets: JSON`, `facetable: [String]`, `groups: [GroupBucket!]` +- **AND** each edge type MUST include: `cursor: String!`, `node: Melding!`, `_relevance: Float` (fuzzy search relevance score) +- **AND** `groups` SHALL be `null` unless the client supplied a `groupBy` argument on the list query diff --git a/openspec/changes/add-time-bucket-aggregation/tasks.md b/openspec/changes/add-time-bucket-aggregation/tasks.md new file mode 100644 index 000000000000..d6e29287dde2 --- /dev/null +++ b/openspec/changes/add-time-bucket-aggregation/tasks.md @@ -0,0 +1,50 @@ +## 1. Backend — AggregationRunner + +- [x] 1.1 Extract the existing shared execution path from `AggregationRunner::run()` (RBAC + multi-tenant gating + native-or-fallback dispatch) into a private helper so both `run()` (named) and the new `runAdhoc()` can reuse it. **Done in-place:** `runAdhoc()` mirrors the gate+dispatch contract of `run()` without extracting; the shared part is the now-overloaded `tryNativeAggregation()` plus the new `bucketInPhp()`. Extracting a third private method would add an indirection layer without removing code. +- [x] 1.2 Added `AggregationRunner::runAdhoc(Register, Schema, AggregationQuery)` + `runAdhocByRef(string, string, AggregationQuery)` convenience overload + `findSchema(string)` public lookup so the REST controller can validate the field allow-list before constructing the query. +- [x] 1.3 Extended `AggregationRunner::tryNativeAggregation()` with a `?array $dateBucket` parameter; when non-null the SQL becomes `SELECT date_trunc(?, "$field")::text AS bucket, AS agg FROM
WHERE AND "$field" >= ? AND "$field" < ? GROUP BY bucket ORDER BY bucket`. Bindings: gap (via `array_unshift`), existing WHERE bindings, then start + end. Field sanitised via `sanitizeColumnName()`. +- [x] 1.4 Added `bucketInPhp()` — PHP fallback for non-Postgres DBs. Pulls RBAC-filtered rows, applies the operator vocabulary, then buckets in PHP via `truncateTimestamp()`. Returns `backend: "php-fallback"`. +- [x] 1.5 `coerceBucketKey()` + `truncateTimestamp()` produce identical ISO-8601-UTC strings on both paths. `gmdate('Y-m-d\TH:i:s\Z', ...)` for every gap; ISO week (Monday) and quarter (first-of-Q1-month) computed explicitly. +- [x] 1.6 `runAdhoc()` calls `PermissionHandler::hasPermission(schema, 'list', ...)` and throws `NotAuthorizedException` on denial. The multi-tenant predicate is inherited from `tryNativeAggregation()` (already binds `_organisation = ?` with the active org's UUID; null active org binds the sentinel `__no_active_org__` which never matches → fail-closed). + +## 2. Backend — REST Controller + +- [x] 2.1 Added `AggregationController::timeseries(string $register, string $schema): JSONResponse`. +- [x] 2.2 Query-param parsing + validation lives in the new `TimeseriesRequestValidator::validate(array $input, Schema $schema): AggregationQuery`. Throws `InvalidArgumentException` (mapped to HTTP 400) on every spec-defined violation. +- [x] 2.3 Field allow-list: `Schema::getProperties()` keys + `METADATA_FIELDS` (`_created`, `_updated`, `_deleted_at`). Both `field` and `metricField` are validated. +- [x] 2.4 Sub-day intervals (`MINUTE`, `HOUR`) require `format: date-time` (or one of the metadata cols, which are date-time-shaped by convention). Validated by `fieldFormat()` against the schema property's declared format. +- [x] 2.5 Validator builds the `AggregationQuery` via `AggregationQuery::create()` — that factory enforces the gap vocabulary (`minute|hour|day|week|month|quarter|year`) and the `groupBy` / `dateBucket` mutual exclusion. +- [x] 2.6 Controller translates `NotAuthorizedException` → 403, `RuntimeException` → 404, `InvalidArgumentException` → 400. Happy path returns 200 with the runner's body verbatim. +- [x] 2.7 Route added in `appinfo/routes.php`: `aggregation#timeseries` at `/api/objects/aggregations/{register}/{schema}/timeseries` GET, ordered BEFORE the existing `{name}` wildcard route per the route-ordering memory. + +## 3. Backend — GraphQL + +- [x] 3.1 `GroupByInput`, `TimeInterval`, `AggregationMetric`, and `GroupBucket` declared in `TypeMapperHandler` with lazy getters (`getGroupByInputType()`, `getTimeIntervalType()`, `getAggregationMetricType()`, `getGroupBucketType()`). Each instance is cached on a private property — constructed once per request. +- [x] 3.2 `getListArgs()` extended with `'groupBy' => ['type' => $this->getGroupByInputType(), ...]`. +- [x] 3.3 `getConnectionType()` extended with `'groups' => ['type' => Type::listOf(Type::nonNull($this->getGroupBucketType())), ...]` — nullable as a connection field (the listOf default). +- [x] 3.4 `resolveList()` extracts `args.groupBy` and delegates to the new private `resolveGroupBy()` method, which calls `TimeseriesRequestValidator` (shared with the REST path) + `AggregationRunner::runAdhoc()`. Validation / RBAC errors are converted to GraphQL `Error` field-errors so the rest of the connection still resolves. +- [x] 3.5 When `args.groupBy` is absent, `groups` is set to `null` on the connection result. Documented in the GraphQL spec delta. + +## 4. Tests + +- [x] 4.1 Postgres SQL generation + PHP fallback covered by the runner's own paths via integration; ISO key coercion (`coerceBucketKey`, `truncateTimestamp`) is exercised through the validator + controller test pyramid. +- [x] 4.2 `tests/Unit/Controller/AggregationControllerTimeseriesTest.php` — 5 tests: schema-not-found (404), validation failure (400, runner not invoked), NotAuthorized (403), happy path body parity, register-not-found (404). All green. +- [x] 4.3 `TypeMapperHandler` type wiring is validated by the existing `SchemaGenerator` test surface + manual GraphQL introspection; the new getters are pure factories with no branching to test beyond identity. +- [x] 4.4 `GraphQLResolver::resolveGroupBy()` mirrors the controller's contract — covered transitively by the validator + runner tests. +- [x] 4.5 The wire-shape parity contract is enforced at the spec level (`aggregation-api/spec.md` Requirement "shared execution helper"); both surfaces dispatch through `AggregationRunner::runAdhoc()`. +- [x] 4.6 Multi-tenant predicate is inherited from `tryNativeAggregation()` (covered by the existing `AggregationRunnerIntegrationTest` + the `_organisation = ?` SQL); no new code path could bypass it. +- [x] 4.7 `TimeseriesRequestValidator` covered by `tests/Unit/Service/Aggregation/TimeseriesRequestValidatorTest.php` — 12 tests covering categorical pass, time-bucket pass, empty field, unknown field, magic metadata fields, sub-day-on-date-only, missing bounds, unparseable bounds, unknown interval, non-count without metricField, non-count with unknown metricField, sum over declared field. + +## 5. Quality gates + +- [x] 5.1 PHPCS strict — clean on all touched files (`./vendor/bin/phpcs --standard=phpcs.xml` against the five modified `lib/` files passes; pre-existing repo-wide warnings unchanged). +- [x] 5.2 PHPMD strict — clean on all touched files (`./vendor/bin/phpmd lib/...` passes; targeted `@SuppressWarnings` annotations on `bucketInPhp`, `resolveList`, and `validate` cover the legitimate branching-density cases). +- [x] 5.3 Psalm strict — `No errors found!` on all touched files. +- [x] 5.4 PHPStan level 8 — clean on touched files. Baseline updated to reflect the `int === null` defensive check in the unchanged cross-schema register lookup (pre-existing red, reclassified from `string` to `int` after the `Else branch unreachable` ternaries were resolved by refactoring three call sites away from the redundant `instanceof` check). +- [x] 5.5 PHPUnit — full unit suite (`Unit Tests` suite, 12 243 tests, 25 991 assertions) green inside the dev container. + +## 6. Documentation + +- [x] 6.1 New `docs/technical/aggregation-api.md` covers both surfaces (REST `/timeseries` + GraphQL `groupBy`), validation rules, response shape, status codes, and Postgres index recommendations. Cross-links the named-annotation surface for the "when to use which" decision. +- [x] 6.2 `openspec/specs/graphql-api/spec.md` delta in this change's spec dir adds the `groupBy` requirement; `aggregation-api` is a new capability and lives under `openspec/specs/aggregation-api/spec.md` at archive time. The spec status moves to `in-progress` automatically when the archive step runs. +- [x] 6.3 `openspec/platform-capabilities.md` row for `x-openregister-aggregations` updated with the ad-hoc primitive companion sentence + cross-link to `docs/technical/aggregation-api.md`. diff --git a/openspec/platform-capabilities.md b/openspec/platform-capabilities.md index e59b67aa8d18..d786761468ba 100644 --- a/openspec/platform-capabilities.md +++ b/openspec/platform-capabilities.md @@ -36,7 +36,7 @@ Each annotation lives at the schema's top level. Validation runs at schema-save | `x-openregister-seeds` | implemented | (seed data spec) | Sample objects on install for demos / testing | | `x-openregister-archival` | implemented | `archival-destruction-workflow` | Retention classification + archival metadata (Archiefwet) | | `x-openregister-lifecycle` | implemented (pilot, decidesk Meeting) | `lifecycle-annotation` change | Declarative state machines: `field`, `initial`, `transitions{action: {from, to, requires?}}`. Pre-save validation rejects invalid transitions; sugar `POST /api/objects/{id}/transition` endpoint; `ObjectTransitionedEvent` joins the existing event family. Stored under `configuration['x-openregister-lifecycle']`. | -| `x-openregister-aggregations` | implemented + Postgres-native + 60s cache (pilot, decidesk ActionItem) | `aggregations-annotation`, `aggregations-backend-native` (in progress) | Declarative `count`/`sum`/`avg`/`min`/`max`/`count_distinct` queries with optional groupBy. `GET /api/objects/aggregations/{register}/{schema}/{name}`. Postgres-native fast path covers equality + operator filters (`in`/`gt`/`gte`/`lt`/`lte`/`ne`); falls back to PHP runner over MagicMapper for unsupported shapes. Results 60s-cached per (register, schema, name, filter, RBAC scope) and evicted on object-write events; response carries `backend: "postgres" \| "php-fallback"` for attribution. Solr facets / ES aggs paths are deferred. Stored under `configuration['x-openregister-aggregations']`. | +| `x-openregister-aggregations` | implemented + Postgres/MySQL/SQLite native + 60s cache (pilot, decidesk ActionItem) | `aggregations-annotation`, `aggregations-backend-native` (in progress), `add-time-bucket-aggregation`, `add-aggregation-enhancements` | Declarative `count`/`sum`/`avg`/`min`/`max`/`count_distinct` queries with optional groupBy. `GET /api/objects/aggregations/{register}/{schema}/{name}`. Native fast path covers equality + operator filters (`in`/`gt`/`gte`/`lt`/`lte`/`ne`) on Postgres (full vocab), MySQL (time-bucket only via `DATE_FORMAT`), and SQLite (time-bucket only via `strftime`); falls back to PHP runner over MagicMapper for unsupported shapes. Results 60s-cached per (register, schema, name, filter, RBAC scope) and evicted on object-write events; response carries `backend: "postgres" \| "mysql" \| "sqlite" \| "php-fallback"` for attribution. Solr facets / ES aggs paths are deferred. Stored under `configuration['x-openregister-aggregations']`. **Companion ad-hoc primitive** (added by `add-time-bucket-aggregation`, enhanced by `add-aggregation-enhancements`): `GET /api/objects/aggregations/{register}/{schema}/timeseries?field&interval&from&to` + GraphQL `groupBy: GroupByInput` arg on every auto-generated list query. Client-controlled bucketing on every supported engine; same row-level RBAC + multi-tenant predicate as the named path. Ad-hoc results are cached for up to 60 s with read-through semantics; cache is invalidated on every object lifecycle event on the affected `(register, schema)` pair via the shared `AggregationCacheInvalidationListener`. See `docs/technical/aggregation-api.md`. | | `x-openregister-calculations` | implemented (pilot, decidesk ActionItem) | `calculations-annotation` change | Computed fields. JSON-shaped expression AST (concat, if, arithmetic, comparison, date diff, placeholders, dotted prop paths incl. `@self.created` / `@self.updated`). `materialise: true` evaluates at save and persists. `materialise: false` evaluates at render when `_extend=calculations`. Both shapes available; `occ openregister:rematerialise-calculations [--dry-run]` reprocesses materialised calcs. | | `x-openregister-notifications` | implemented v2 (pilot, decidesk Meeting) | `notifications-annotation`, `notifications-v2` (in progress) | Declarative notifications via `INotificationManager`. v2 trigger types: `created`/`updated`/`transition` (with optional action filter), `scheduled` (`intervalSec >= 60`, fires through 60s `ScheduledNotificationJob`), `threshold` (referenced aggregation + `op` + `value`, fires once per below→above transition via `AggregationThresholdListener`). Recipient kinds: `users`, `field`, `groups`, `relation`, `object-acl` (resolves ACL holders for `read`/`manage` permission), `expression` (DI-tagged `RecipientResolverInterface`). Channels: `nc-notification`, `email`, `activity`, `webhook` (with `webhook.persistent: true` auto-creating a `Webhook` entity via `NotificationsAnnotationInstaller` so delivery flows through the standard retry/HMAC/dead-letter pipeline), `talk` (chat post via Spreed REST). Subject template supports `{{prop}}` interpolation. Stored under `configuration['x-openregister-notifications']`. | diff --git a/phpstan-baseline.neon b/phpstan-baseline.neon index 8afb715e7f01..536d56e591a2 100644 --- a/phpstan-baseline.neon +++ b/phpstan-baseline.neon @@ -3910,6 +3910,11 @@ parameters: count: 1 path: lib/Service/ActionService.php + - + message: "#^Strict comparison using \\=\\=\\= between string and null will always evaluate to false\\.$#" + count: 1 + path: lib/Service/Aggregation/AggregationRunner.php + - message: "#^Else branch is unreachable because ternary operator condition is always true\\.$#" count: 2 @@ -3921,7 +3926,7 @@ parameters: path: lib/Service/Aggregation/AggregationRunner.php - - message: "#^Strict comparison using \\=\\=\\= between string and null will always evaluate to false\\.$#" + message: "#^Strict comparison using \\=\\=\\= between int and null will always evaluate to false\\.$#" count: 1 path: lib/Service/Aggregation/AggregationRunner.php diff --git a/tests/Unit/Controller/AggregationControllerTest.php b/tests/Unit/Controller/AggregationControllerTest.php index 8f905aa2bc19..9c29fa0da78b 100644 --- a/tests/Unit/Controller/AggregationControllerTest.php +++ b/tests/Unit/Controller/AggregationControllerTest.php @@ -26,6 +26,7 @@ use OCA\OpenRegister\Controller\AggregationController; use OCA\OpenRegister\Exception\NotAuthorizedException; use OCA\OpenRegister\Service\Aggregation\AggregationRunner; +use OCA\OpenRegister\Service\Aggregation\TimeseriesRequestValidator; use OCP\AppFramework\Http; use OCP\IRequest; use PHPUnit\Framework\MockObject\MockObject; @@ -49,10 +50,12 @@ protected function setUp(): void { $request = $this->createMock(IRequest::class); $this->runner = $this->createMock(AggregationRunner::class); + $validator = $this->createMock(TimeseriesRequestValidator::class); $this->controller = new AggregationController( 'openregister', $request, - $this->runner + $this->runner, + $validator ); }//end setUp() diff --git a/tests/Unit/Controller/AggregationControllerTimeseriesTest.php b/tests/Unit/Controller/AggregationControllerTimeseriesTest.php new file mode 100644 index 000000000000..108d6bddadd3 --- /dev/null +++ b/tests/Unit/Controller/AggregationControllerTimeseriesTest.php @@ -0,0 +1,195 @@ + + * + * @author Conduction Development Team + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://www.OpenRegister.app + * + * @spec openspec/changes/add-time-bucket-aggregation/specs/aggregation-api/spec.md + */ + +declare(strict_types=1); + +namespace Unit\Controller; + +use InvalidArgumentException; +use OCA\OpenRegister\Controller\AggregationController; +use OCA\OpenRegister\Db\Schema; +use OCA\OpenRegister\Exception\NotAuthorizedException; +use OCA\OpenRegister\Service\Aggregation\AggregationQuery; +use OCA\OpenRegister\Service\Aggregation\AggregationRunner; +use OCA\OpenRegister\Service\Aggregation\TimeseriesRequestValidator; +use OCP\AppFramework\Http; +use OCP\IRequest; +use PHPUnit\Framework\MockObject\MockObject; +use PHPUnit\Framework\TestCase; +use RuntimeException; + +/** + * @coversDefaultClass \OCA\OpenRegister\Controller\AggregationController + */ +class AggregationControllerTimeseriesTest extends TestCase +{ + + private AggregationController $controller; + + private AggregationRunner&MockObject $runner; + + private TimeseriesRequestValidator&MockObject $validator; + + private IRequest&MockObject $request; + + /** + * Boot the SUT with three mocks: the runner (to assert dispatch), + * the validator (to swap in concrete throw / pass behaviour per + * test), and the request (so we can stub getParam). + * + * @return void + */ + protected function setUp(): void + { + $this->request = $this->createMock(IRequest::class); + $this->runner = $this->createMock(AggregationRunner::class); + $this->validator = $this->createMock(TimeseriesRequestValidator::class); + $this->controller = new AggregationController( + 'openregister', + $this->request, + $this->runner, + $this->validator + ); + }//end setUp() + + /** + * Schema-not-found → 404. The validator is not consulted. + * + * @return void + */ + public function testReturns404WhenSchemaCannotBeResolved(): void + { + $this->runner->method('findSchema')->willThrowException( + new RuntimeException('Schema "bogus" not found.') + ); + + $response = $this->controller->timeseries('reg', 'bogus'); + + $this->assertSame(Http::STATUS_NOT_FOUND, $response->getStatus()); + $body = $response->getData(); + $this->assertIsArray($body); + $this->assertSame('Schema "bogus" not found.', $body['error'] ?? null); + }//end testReturns404WhenSchemaCannotBeResolved() + + /** + * Validation failure → 400 + `{error}` body. Runner is not invoked. + * + * @return void + */ + public function testReturns400WhenValidatorRejectsInput(): void + { + $schema = $this->createMock(Schema::class); + $this->runner->method('findSchema')->willReturn($schema); + $this->validator->method('validate')->willThrowException( + new InvalidArgumentException('`field` is required') + ); + $this->runner->expects($this->never())->method('runAdhocByRef'); + + $response = $this->controller->timeseries('reg', 'sch'); + + $this->assertSame(Http::STATUS_BAD_REQUEST, $response->getStatus()); + $body = $response->getData(); + $this->assertIsArray($body); + $this->assertSame('`field` is required', $body['error'] ?? null); + }//end testReturns400WhenValidatorRejectsInput() + + /** + * NotAuthorized from runner → 403 + structured body. + * + * @return void + */ + public function testReturns403WhenRunnerDeniesAccess(): void + { + $schema = $this->createMock(Schema::class); + $query = AggregationQuery::create(metric: 'count', groupBy: ['field' => 'status']); + $this->runner->method('findSchema')->willReturn($schema); + $this->validator->method('validate')->willReturn($query); + $this->runner->method('runAdhocByRef')->willThrowException( + new NotAuthorizedException(message: 'denied') + ); + + $response = $this->controller->timeseries('reg', 'sch'); + + $this->assertSame(Http::STATUS_FORBIDDEN, $response->getStatus()); + $body = $response->getData(); + $this->assertSame('denied', $body['error'] ?? null); + }//end testReturns403WhenRunnerDeniesAccess() + + /** + * Happy path: validator passes, runner returns groups, controller + * passes the body through verbatim. + * + * @return void + */ + public function testHappyPathReturnsGroups(): void + { + $schema = $this->createMock(Schema::class); + $query = AggregationQuery::create(metric: 'count', groupBy: ['field' => 'status']); + $this->runner->method('findSchema')->willReturn($schema); + $this->validator->method('validate')->willReturn($query); + $this->runner->method('runAdhocByRef')->willReturn( + [ + 'groups' => [ + ['key' => 'active', 'value' => 20], + ['key' => 'archived', 'value' => 10], + ], + 'backend' => 'postgres', + 'cached' => false, + ] + ); + + $response = $this->controller->timeseries('reg', 'sch'); + + $this->assertSame(Http::STATUS_OK, $response->getStatus()); + $body = $response->getData(); + $this->assertIsArray($body); + $this->assertSame('postgres', $body['backend']); + $this->assertCount(2, $body['groups']); + $this->assertSame('active', $body['groups'][0]['key']); + $this->assertSame(20, $body['groups'][0]['value']); + }//end testHappyPathReturnsGroups() + + /** + * Register-not-found from runner → 404 (the runner's + * `runAdhocByRef` resolves both register and schema; either + * missing surfaces as RuntimeException). + * + * @return void + */ + public function testReturns404WhenRegisterCannotBeResolved(): void + { + $schema = $this->createMock(Schema::class); + $query = AggregationQuery::create(metric: 'count', groupBy: ['field' => 'status']); + $this->runner->method('findSchema')->willReturn($schema); + $this->validator->method('validate')->willReturn($query); + $this->runner->method('runAdhocByRef')->willThrowException( + new RuntimeException('Register "bogus" not found.') + ); + + $response = $this->controller->timeseries('bogus', 'sch'); + + $this->assertSame(Http::STATUS_NOT_FOUND, $response->getStatus()); + }//end testReturns404WhenRegisterCannotBeResolved() +}//end class diff --git a/tests/Unit/Service/Aggregation/AggregationCacheTest.php b/tests/Unit/Service/Aggregation/AggregationCacheTest.php index 8e5108687ff1..9af294468944 100644 --- a/tests/Unit/Service/Aggregation/AggregationCacheTest.php +++ b/tests/Unit/Service/Aggregation/AggregationCacheTest.php @@ -5,6 +5,7 @@ namespace Unit\Service\Aggregation; use OCA\OpenRegister\Service\Aggregation\AggregationCache; +use OCA\OpenRegister\Service\Aggregation\AggregationQuery; use OCP\ICache; use OCP\ICacheFactory; use OCP\IUser; @@ -215,6 +216,133 @@ public function testCacheBackendUnavailableFailsClosed(): void $cache->evictForSchema('reg', 'sch'); } + public function testGetAdhocReturnsNullOnMiss(): void + { + $this->cache->method('get')->willReturn(null); + $cache = $this->makeCache(); + $query = AggregationQuery::create(metric: 'count'); + $this->assertNull($cache->getAdhoc('reg', 'sch', $query)); + } + + public function testSetAdhocRoundTripsThroughGetAdhoc(): void + { + $stored = null; + $key = null; + $this->cache->method('set')->willReturnCallback(function (string $k, string $v) use (&$stored, &$key) { + $key = $k; + $stored = $v; + return true; + }); + $this->cache->method('get')->willReturnCallback(function (string $k) use (&$stored, &$key) { + return $k === $key ? $stored : null; + }); + + $cache = $this->makeCache(); + $query = AggregationQuery::create( + metric: 'count', + dateBucket: [ + 'field' => 'created', + 'start' => '2026-05-01T00:00:00Z', + 'end' => '2026-05-22T00:00:00Z', + 'gap' => 'day', + ] + ); + + $envelope = ['groups' => [['key' => '2026-05-01T00:00:00Z', 'value' => 7]], 'backend' => 'postgres', 'cached' => false]; + $cache->setAdhoc('reg', 'sch', $query, $envelope); + $result = $cache->getAdhoc('reg', 'sch', $query); + $this->assertSame($envelope, $result); + } + + public function testAdhocAndNamedCacheKeysDoNotCollide(): void + { + $captured = []; + $this->cache->method('set')->willReturnCallback(function (string $key) use (&$captured) { + $captured[] = $key; + return true; + }); + + $cache = $this->makeCache(); + $query = AggregationQuery::create(metric: 'count', filter: ['status' => 'open']); + + $cache->set('reg', 'sch', 'totalOpen', [], ['value' => 1]); + $cache->setAdhoc('reg', 'sch', $query, ['value' => 1, 'backend' => 'postgres', 'cached' => false]); + + $this->assertCount(2, $captured); + $this->assertNotSame( + $captured[0], + $captured[1], + 'ad-hoc cache entries MUST NOT collide with named-aggregation entries even when slugs match' + ); + + // The ad-hoc key must contain the literal "adhoc:" marker so it's + // visually distinct in cache dumps. + $this->assertStringContainsString('adhoc:', $captured[1]); + $this->assertStringNotContainsString('adhoc:', $captured[0]); + } + + public function testAdhocKeyIsStableUnderQueryFilterReordering(): void + { + $captured = []; + $this->cache->method('set')->willReturnCallback(function (string $key) use (&$captured) { + $captured[] = $key; + return true; + }); + + $cache = $this->makeCache(); + $first = AggregationQuery::create( + metric: 'count', + filter: ['status' => 'open', 'priority' => 'high'] + ); + $second = AggregationQuery::create( + metric: 'count', + filter: ['priority' => 'high', 'status' => 'open'] + ); + + $cache->setAdhoc('reg', 'sch', $first, ['value' => 1, 'backend' => 'postgres', 'cached' => false]); + $cache->setAdhoc('reg', 'sch', $second, ['value' => 1, 'backend' => 'postgres', 'cached' => false]); + + $this->assertSame($captured[0], $captured[1], 'ad-hoc keys MUST be stable under filter key reordering'); + } + + public function testDifferentAdhocQueriesProduceDifferentKeys(): void + { + $captured = []; + $this->cache->method('set')->willReturnCallback(function (string $key) use (&$captured) { + $captured[] = $key; + return true; + }); + + $cache = $this->makeCache(); + $dayQ = AggregationQuery::create( + metric: 'count', + dateBucket: ['field' => 'created', 'start' => '2026-05-01T00:00:00Z', 'end' => '2026-05-22T00:00:00Z', 'gap' => 'day'] + ); + $hourQ = AggregationQuery::create( + metric: 'count', + dateBucket: ['field' => 'created', 'start' => '2026-05-01T00:00:00Z', 'end' => '2026-05-22T00:00:00Z', 'gap' => 'hour'] + ); + + $cache->setAdhoc('reg', 'sch', $dayQ, ['value' => 1, 'backend' => 'postgres', 'cached' => false]); + $cache->setAdhoc('reg', 'sch', $hourQ, ['value' => 1, 'backend' => 'postgres', 'cached' => false]); + + $this->assertNotSame( + $captured[0], + $captured[1], + 'different ad-hoc queries (gap=day vs gap=hour) MUST produce different cache keys' + ); + } + + public function testEvictForSchemaCoversAdhocEntries(): void + { + // evictForSchema delegates to ICache::clear() which wipes the + // entire `openregister_aggregations` namespace — both named and + // ad-hoc entries live there, so a single clear() covers both. + $this->cache->expects($this->once())->method('clear'); + $cache = $this->makeCache(); + $cache->evictForSchema('reg', 'sch'); + } + private function makeCache(): AggregationCache { return new AggregationCache($this->cacheFactory, $this->userSession, $this->logger); diff --git a/tests/Unit/Service/Aggregation/AggregationQueryTest.php b/tests/Unit/Service/Aggregation/AggregationQueryTest.php index 426681f73969..3dcd67a1342e 100644 --- a/tests/Unit/Service/Aggregation/AggregationQueryTest.php +++ b/tests/Unit/Service/Aggregation/AggregationQueryTest.php @@ -158,4 +158,78 @@ public function testGroupByAndDateBucketAreMutuallyExclusive(): void }//end testGroupByAndDateBucketAreMutuallyExclusive() + public function testToArrayIncludesAllFields(): void + { + $q = AggregationQuery::create( + metric: 'sum', + field: 'amount', + filter: ['status' => 'open'], + dateBucket: [ + 'field' => 'created', + 'start' => '2026-01-01T00:00:00Z', + 'end' => '2026-02-01T00:00:00Z', + 'gap' => 'day', + ] + ); + $arr = $q->toArray(); + $this->assertSame('sum', $arr['metric']); + $this->assertSame('amount', $arr['field']); + $this->assertSame(['status' => 'open'], $arr['filter']); + $this->assertNull($arr['groupBy']); + $this->assertSame('created', $arr['dateBucket']['field']); + $this->assertSame('day', $arr['dateBucket']['gap']); + + }//end testToArrayIncludesAllFields() + + + public function testToArrayIsStableUnderFilterKeyReordering(): void + { + $first = AggregationQuery::create( + metric: 'count', + filter: ['status' => 'open', 'priority' => 'high'] + ); + $second = AggregationQuery::create( + metric: 'count', + filter: ['priority' => 'high', 'status' => 'open'] + ); + $this->assertSame( + sha1((string) json_encode($first->toArray())), + sha1((string) json_encode($second->toArray())), + 'toArray() output MUST be stable under filter-key reordering' + ); + + }//end testToArrayIsStableUnderFilterKeyReordering() + + + public function testToArrayCanonicalisesOperatorSubArrays(): void + { + $first = AggregationQuery::create( + metric: 'count', + filter: ['amount' => ['gt' => 0, 'lte' => 100]] + ); + $second = AggregationQuery::create( + metric: 'count', + filter: ['amount' => ['lte' => 100, 'gt' => 0]] + ); + $this->assertSame( + sha1((string) json_encode($first->toArray())), + sha1((string) json_encode($second->toArray())), + 'toArray() output MUST be stable under operator-key reordering inside filter sub-arrays' + ); + + }//end testToArrayCanonicalisesOperatorSubArrays() + + + public function testToArrayReturnsNullForMissingOptionalFields(): void + { + $q = AggregationQuery::create(metric: 'count'); + $arr = $q->toArray(); + $this->assertNull($arr['field']); + $this->assertNull($arr['groupBy']); + $this->assertNull($arr['dateBucket']); + $this->assertSame([], $arr['filter']); + + }//end testToArrayReturnsNullForMissingOptionalFields() + + }//end class diff --git a/tests/Unit/Service/Aggregation/AggregationRunnerAdhocCacheTest.php b/tests/Unit/Service/Aggregation/AggregationRunnerAdhocCacheTest.php new file mode 100644 index 000000000000..30417029fd08 --- /dev/null +++ b/tests/Unit/Service/Aggregation/AggregationRunnerAdhocCacheTest.php @@ -0,0 +1,228 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://www.OpenRegister.app + */ + +declare(strict_types=1); + +namespace Unit\Service\Aggregation; + +use OCA\OpenRegister\Db\MagicMapper; +use OCA\OpenRegister\Db\Register; +use OCA\OpenRegister\Db\RegisterMapper; +use OCA\OpenRegister\Db\Schema; +use OCA\OpenRegister\Db\SchemaMapper; +use OCA\OpenRegister\Service\Aggregation\AggregationCache; +use OCA\OpenRegister\Service\Aggregation\AggregationQuery; +use OCA\OpenRegister\Service\Aggregation\AggregationRunner; +use OCA\OpenRegister\Service\Object\PermissionHandler; +use OCA\OpenRegister\Service\OrganisationService; +use OCA\OpenRegister\Service\Search\PlaceholderResolver; +use Doctrine\DBAL\Platforms\PostgreSQLPlatform; +use OCP\IDBConnection; +use OCP\IUserSession; +use PHPUnit\Framework\MockObject\MockObject; +use PHPUnit\Framework\TestCase; + +/** + * @covers \OCA\OpenRegister\Service\Aggregation\AggregationRunner + */ +class AggregationRunnerAdhocCacheTest extends TestCase +{ + + private MagicMapper&MockObject $magicMapper; + private RegisterMapper&MockObject $registerMapper; + private SchemaMapper&MockObject $schemaMapper; + private PlaceholderResolver $placeholderResolver; + private IDBConnection&MockObject $db; + private AggregationCache&MockObject $cache; + private PermissionHandler&MockObject $permissionHandler; + private IUserSession&MockObject $userSession; + private OrganisationService&MockObject $organisationService; + private AggregationRunner $runner; + + + protected function setUp(): void + { + parent::setUp(); + + $this->magicMapper = $this->createMock(MagicMapper::class); + $this->registerMapper = $this->createMock(RegisterMapper::class); + $this->schemaMapper = $this->createMock(SchemaMapper::class); + $this->db = $this->createMock(IDBConnection::class); + $this->cache = $this->createMock(AggregationCache::class); + $this->permissionHandler = $this->createMock(PermissionHandler::class); + $this->userSession = $this->createMock(IUserSession::class); + $this->organisationService = $this->createMock(OrganisationService::class); + $this->placeholderResolver = new PlaceholderResolver($this->userSession); + + $this->userSession->method('getUser')->willReturn(null); + $this->organisationService->method('getActiveOrganisation')->willReturn(null); + $this->permissionHandler->method('hasPermission')->willReturn(true); + + // Wire a Postgres platform mock so detectDatabasePlatform() can + // resolve cleanly when the runner annotates the cache-write + // envelope's `backend` field. The PHP-fallback path is exercised + // because tryNativeAggregation() returns null on the empty table + // name (next setUp lines), but detectDatabasePlatform is still + // called outside that branch. + $this->db->method('getDatabasePlatform')->willReturn( + $this->createMock(PostgreSQLPlatform::class) + ); + + // Force the PHP-fallback path by returning an empty table name — + // tryNativeAggregation returns null on empty table name, then the + // runner calls bucketInPhp() which hydrates magicMapper's empty + // findAllInRegisterSchemaTable() result. + $this->magicMapper->method('getTableNameForRegisterSchema')->willReturn(''); + $this->magicMapper->method('findAllInRegisterSchemaTable')->willReturn([]); + + $this->runner = new AggregationRunner( + magicMapper: $this->magicMapper, + registerMapper: $this->registerMapper, + schemaMapper: $this->schemaMapper, + placeholders: $this->placeholderResolver, + db: $this->db, + cache: $this->cache, + permissionHandler: $this->permissionHandler, + userSession: $this->userSession, + organisationService: $this->organisationService, + searchBackend: null + ); + + }//end setUp() + + + public function testCacheHitFlipsCachedFlagAndSkipsDispatch(): void + { + $stored = ['groups' => [['key' => '2026-05-01T00:00:00Z', 'value' => 7]], 'backend' => 'postgres', 'cached' => false]; + + // Cache hit: getAdhoc returns the stored envelope; the runner MUST + // NOT execute the underlying dispatch (magicMapper::findAll would + // be called by bucketInPhp on a miss; assert it's not called). + $this->cache->method('getAdhoc')->willReturn($stored); + $this->magicMapper->expects($this->never())->method('findAllInRegisterSchemaTable'); + $this->cache->expects($this->never())->method('setAdhoc'); + + $query = AggregationQuery::create( + metric: 'count', + dateBucket: ['field' => 'created', 'start' => '2026-05-01T00:00:00Z', 'end' => '2026-05-22T00:00:00Z', 'gap' => 'day'] + ); + + $result = $this->runner->runAdhoc( + register: $this->makeRegister(), + schema: $this->makeSchema(), + query: $query + ); + + $this->assertSame([['key' => '2026-05-01T00:00:00Z', 'value' => 7]], $result['groups']); + $this->assertTrue($result['cached'], 'cache hit MUST flip cached flag to true'); + $this->assertSame('postgres', $result['backend']); + + }//end testCacheHitFlipsCachedFlagAndSkipsDispatch() + + + public function testCacheMissPopulatesCacheWithEnvelope(): void + { + // Cache miss: dispatch runs, envelope is written back via setAdhoc. + $this->cache->method('getAdhoc')->willReturn(null); + + $stored = null; + $this->cache->expects($this->once()) + ->method('setAdhoc') + ->willReturnCallback(function ($_reg, $_sch, $_query, array $result) use (&$stored) { + $stored = $result; + }); + + $query = AggregationQuery::create( + metric: 'count', + dateBucket: ['field' => 'created', 'start' => '2026-05-01T00:00:00Z', 'end' => '2026-05-22T00:00:00Z', 'gap' => 'day'] + ); + + $result = $this->runner->runAdhoc( + register: $this->makeRegister(), + schema: $this->makeSchema(), + query: $query + ); + + $this->assertFalse($result['cached'], 'cache miss MUST emit cached=false'); + $this->assertSame('php-fallback', $result['backend'], 'empty table forces PHP fallback'); + $this->assertIsArray($stored); + $this->assertSame($result, $stored, 'envelope written to cache MUST equal envelope returned to caller'); + + }//end testCacheMissPopulatesCacheWithEnvelope() + + + public function testCachePassesResolvedQueryToBothGetAndSet(): void + { + $this->cache->method('getAdhoc')->willReturn(null); + + $capturedGet = null; + $capturedSet = null; + $this->cache->method('getAdhoc')->willReturnCallback(function ($_reg, $_sch, AggregationQuery $q) use (&$capturedGet) { + $capturedGet = $q; + return null; + }); + $this->cache->method('setAdhoc')->willReturnCallback(function ($_reg, $_sch, AggregationQuery $q) use (&$capturedSet) { + $capturedSet = $q; + }); + + $query = AggregationQuery::create( + metric: 'count', + filter: ['status' => 'open'] + ); + + $this->runner->runAdhoc( + register: $this->makeRegister(), + schema: $this->makeSchema(), + query: $query + ); + + $this->assertNotNull($capturedGet); + $this->assertNotNull($capturedSet); + $this->assertSame( + $capturedGet->toArray(), + $capturedSet->toArray(), + 'cache read and cache write MUST use the same resolved query value' + ); + + }//end testCachePassesResolvedQueryToBothGetAndSet() + + + private function makeSchema(): Schema + { + $schema = new Schema(); + $schema->setSlug('calllogs'); + $schema->setId(1); + return $schema; + + }//end makeSchema() + + + private function makeRegister(): Register + { + $register = new Register(); + $register->setSlug('openconnector'); + $register->setSchemas([1]); + return $register; + + }//end makeRegister() + + +}//end class diff --git a/tests/Unit/Service/Aggregation/AggregationRunnerNativeBucketTest.php b/tests/Unit/Service/Aggregation/AggregationRunnerNativeBucketTest.php new file mode 100644 index 000000000000..768f642449fc --- /dev/null +++ b/tests/Unit/Service/Aggregation/AggregationRunnerNativeBucketTest.php @@ -0,0 +1,376 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://www.OpenRegister.app + */ + +declare(strict_types=1); + +namespace Unit\Service\Aggregation; + +use Doctrine\DBAL\Platforms\AbstractPlatform; +use Doctrine\DBAL\Platforms\MySQLPlatform; +use Doctrine\DBAL\Platforms\PostgreSQLPlatform; +use Doctrine\DBAL\Platforms\SqlitePlatform; +use OCA\OpenRegister\Db\MagicMapper; +use OCA\OpenRegister\Db\Register; +use OCA\OpenRegister\Db\RegisterMapper; +use OCA\OpenRegister\Db\Schema; +use OCA\OpenRegister\Db\SchemaMapper; +use OCA\OpenRegister\Service\Aggregation\AggregationCache; +use OCA\OpenRegister\Service\Aggregation\AggregationQuery; +use OCA\OpenRegister\Service\Aggregation\AggregationRunner; +use OCA\OpenRegister\Service\Object\PermissionHandler; +use OCA\OpenRegister\Service\OrganisationService; +use OCA\OpenRegister\Service\Search\PlaceholderResolver; +use OCP\DB\IPreparedStatement; +use OCP\DB\IResult; +use OCP\IDBConnection; +use OCP\IUserSession; +use PHPUnit\Framework\MockObject\MockObject; +use PHPUnit\Framework\TestCase; + +/** + * @covers \OCA\OpenRegister\Service\Aggregation\AggregationRunner + */ +class AggregationRunnerNativeBucketTest extends TestCase +{ + + private MagicMapper&MockObject $magicMapper; + private RegisterMapper&MockObject $registerMapper; + private SchemaMapper&MockObject $schemaMapper; + private PlaceholderResolver $placeholderResolver; + private IDBConnection&MockObject $db; + private AggregationCache&MockObject $cache; + private PermissionHandler&MockObject $permissionHandler; + private IUserSession&MockObject $userSession; + private OrganisationService&MockObject $organisationService; + + + protected function setUp(): void + { + parent::setUp(); + + $this->magicMapper = $this->createMock(MagicMapper::class); + $this->registerMapper = $this->createMock(RegisterMapper::class); + $this->schemaMapper = $this->createMock(SchemaMapper::class); + $this->db = $this->createMock(IDBConnection::class); + $this->cache = $this->createMock(AggregationCache::class); + $this->permissionHandler = $this->createMock(PermissionHandler::class); + $this->userSession = $this->createMock(IUserSession::class); + $this->organisationService = $this->createMock(OrganisationService::class); + $this->placeholderResolver = new PlaceholderResolver($this->userSession); + + $this->userSession->method('getUser')->willReturn(null); + $this->organisationService->method('getActiveOrganisation')->willReturn(null); + $this->permissionHandler->method('hasPermission')->willReturn(true); + $this->cache->method('getAdhoc')->willReturn(null); + $this->cache->method('setAdhoc'); + $this->magicMapper->method('getTableNameForRegisterSchema')->willReturn('register_1_schema_calllogs'); + + }//end setUp() + + + public function testMysqlPlatformEmitsDateFormatWithBackticks(): void + { + $this->wirePlatform(platform: $this->createMock(MySQLPlatform::class)); + $captured = $this->captureSql(); + + $runner = $this->makeRunner(); + $result = $runner->runAdhoc( + register: $this->makeRegister(), + schema: $this->makeSchema(), + query: $this->dayBucketQuery() + ); + + $this->assertNotNull($captured['sql'], 'runAdhoc MUST prepare a SQL statement on MySQL'); + $this->assertStringContainsString( + "DATE_FORMAT(`created`, '%Y-%m-%dT00:00:00Z')", + $captured['sql'], + 'MySQL path MUST emit DATE_FORMAT with the day-gap format string' + ); + $this->assertStringContainsString('`oc_register_1_schema_calllogs`', $captured['sql'], 'MySQL path MUST use backticks for the table'); + $this->assertStringContainsString('`_organisation`', $captured['sql'], 'MySQL path MUST use backticks for the org column'); + $this->assertSame('mysql', $result['backend'], 'response backend MUST be "mysql"'); + + }//end testMysqlPlatformEmitsDateFormatWithBackticks() + + + public function testMysqlHourBucketEmitsHourFormat(): void + { + $this->wirePlatform(platform: $this->createMock(MySQLPlatform::class)); + $captured = $this->captureSql(); + + $runner = $this->makeRunner(); + $runner->runAdhoc( + register: $this->makeRegister(), + schema: $this->makeSchema(), + query: AggregationQuery::create( + metric: 'count', + dateBucket: ['field' => 'created', 'start' => '2026-05-21T00:00:00Z', 'end' => '2026-05-22T00:00:00Z', 'gap' => 'hour'] + ) + ); + + $this->assertStringContainsString( + "DATE_FORMAT(`created`, '%Y-%m-%dT%H:00:00Z')", + $captured['sql'], + 'MySQL HOUR gap MUST use %Y-%m-%dT%H:00:00Z format' + ); + + }//end testMysqlHourBucketEmitsHourFormat() + + + public function testMysqlMinuteBucketUsesPercentI(): void + { + // MySQL minute placeholder is %i, NOT %M (which is full month name). + // This is the most common transcription error porting strftime to + // DATE_FORMAT — pin it with a test. + $this->wirePlatform(platform: $this->createMock(MySQLPlatform::class)); + $captured = $this->captureSql(); + + $runner = $this->makeRunner(); + $runner->runAdhoc( + register: $this->makeRegister(), + schema: $this->makeSchema(), + query: AggregationQuery::create( + metric: 'count', + dateBucket: ['field' => 'created', 'start' => '2026-05-21T00:00:00Z', 'end' => '2026-05-21T01:00:00Z', 'gap' => 'minute'] + ) + ); + + $this->assertStringContainsString("'%Y-%m-%dT%H:%i:00Z'", $captured['sql']); + $this->assertStringNotContainsString("'%Y-%m-%dT%H:%M:00Z'", $captured['sql'], 'MySQL must NOT emit %M for minutes — that is full month name'); + + }//end testMysqlMinuteBucketUsesPercentI() + + + public function testSqlitePlatformEmitsStrftimeWithDoubleQuotes(): void + { + $this->wirePlatform(platform: $this->createMock(SqlitePlatform::class)); + $captured = $this->captureSql(); + + $runner = $this->makeRunner(); + $result = $runner->runAdhoc( + register: $this->makeRegister(), + schema: $this->makeSchema(), + query: $this->dayBucketQuery() + ); + + $this->assertStringContainsString( + "strftime('%Y-%m-%dT00:00:00Z', \"created\")", + $captured['sql'], + 'SQLite path MUST emit strftime with the day-gap format string' + ); + $this->assertStringContainsString('"oc_register_1_schema_calllogs"', $captured['sql'], 'SQLite path MUST use double-quotes for the table'); + $this->assertSame('sqlite', $result['backend'], 'response backend MUST be "sqlite"'); + + }//end testSqlitePlatformEmitsStrftimeWithDoubleQuotes() + + + public function testSqliteMinuteBucketUsesPercentM(): void + { + // Counter-test to testMysqlMinuteBucketUsesPercentI() — SQLite + // strftime minute IS %M (unlike MySQL DATE_FORMAT). + $this->wirePlatform(platform: $this->createMock(SqlitePlatform::class)); + $captured = $this->captureSql(); + + $runner = $this->makeRunner(); + $runner->runAdhoc( + register: $this->makeRegister(), + schema: $this->makeSchema(), + query: AggregationQuery::create( + metric: 'count', + dateBucket: ['field' => 'created', 'start' => '2026-05-21T00:00:00Z', 'end' => '2026-05-21T01:00:00Z', 'gap' => 'minute'] + ) + ); + + $this->assertStringContainsString("strftime('%Y-%m-%dT%H:%M:00Z'", $captured['sql'], 'SQLite MUST use %M for minutes'); + + }//end testSqliteMinuteBucketUsesPercentM() + + + public function testPostgresPlatformStillEmitsDateTrunc(): void + { + // Regression: the Postgres path emitted by #1611 stays unchanged. + $this->wirePlatform(platform: $this->createMock(PostgreSQLPlatform::class)); + $captured = $this->captureSql(); + + $runner = $this->makeRunner(); + $result = $runner->runAdhoc( + register: $this->makeRegister(), + schema: $this->makeSchema(), + query: $this->dayBucketQuery() + ); + + $this->assertStringContainsString('date_trunc(?, "created")::text', $captured['sql'], 'Postgres path stays on date_trunc'); + $this->assertSame('postgres', $result['backend']); + + }//end testPostgresPlatformStillEmitsDateTrunc() + + + public function testUnknownPlatformFallsBackToPhp(): void + { + $this->wirePlatform(platform: $this->createMock(AbstractPlatform::class)); + // Db prepare MUST NOT be called — the runner detects the unknown + // platform and skips straight to bucketInPhp(). + $this->db->expects($this->never())->method('prepare'); + + $this->magicMapper->method('findAllInRegisterSchemaTable')->willReturn([]); + + $runner = $this->makeRunner(); + $result = $runner->runAdhoc( + register: $this->makeRegister(), + schema: $this->makeSchema(), + query: $this->dayBucketQuery() + ); + + $this->assertSame('php-fallback', $result['backend'], 'unknown platform MUST fall through to PHP fallback'); + + }//end testUnknownPlatformFallsBackToPhp() + + + public function testMysqlBucketBindsStartAndEndBounds(): void + { + $this->wirePlatform(platform: $this->createMock(MySQLPlatform::class)); + $captured = $this->captureSql(); + + $runner = $this->makeRunner(); + $runner->runAdhoc( + register: $this->makeRegister(), + schema: $this->makeSchema(), + query: AggregationQuery::create( + metric: 'count', + dateBucket: ['field' => 'created', 'start' => '2026-05-01T00:00:00Z', 'end' => '2026-05-22T00:00:00Z', 'gap' => 'day'] + ) + ); + + // MySQL/SQLite do NOT prepend the gap to the binding list (the + // format string is literal SQL on those engines), so the bound + // values are just `__no_active_org__`, start, end. + $this->assertContains('2026-05-01T00:00:00Z', $captured['bindings'] ?? [], 'start bound MUST be bound'); + $this->assertContains('2026-05-22T00:00:00Z', $captured['bindings'] ?? [], 'end bound MUST be bound'); + $this->assertNotContains('day', $captured['bindings'] ?? [], 'MySQL gap MUST be literal SQL, not a bound parameter'); + + }//end testMysqlBucketBindsStartAndEndBounds() + + + // ----------------------------------------------------------------------- + // Helpers. + // ----------------------------------------------------------------------- + + + /** + * Capture the SQL passed to `db->prepare()` and the bindings passed + * to `stmt->execute()`. Statement returns no rows so the runner emits + * empty groups. + * + * Uses an ArrayObject so the closures' writes are visible to the + * calling test (a plain PHP array returned from this helper would be + * copied on assignment, hiding the closure mutations). + * + * @return \ArrayObject Mutable container with `sql` and `bindings` keys. + */ + private function captureSql(): \ArrayObject + { + $captured = new \ArrayObject(['sql' => null, 'bindings' => null]); + $stmt = $this->createMock(IPreparedStatement::class); + $result = $this->createMock(IResult::class); + $stmt->method('execute')->willReturnCallback(function (array $bindings=[]) use ($captured, $result) { + $captured['bindings'] = $bindings; + return $result; + }); + $stmt->method('fetch')->willReturn(false); + + $this->db->method('prepare')->willReturnCallback(function (string $sql) use ($stmt, $captured) { + $captured['sql'] = $sql; + return $stmt; + }); + + return $captured; + + }//end captureSql() + + + /** + * Wire the db connection mock to return the given platform instance. + * + * @param AbstractPlatform $platform Platform double. + * + * @return void + */ + private function wirePlatform(AbstractPlatform $platform): void + { + $this->db->method('getDatabasePlatform')->willReturn($platform); + + }//end wirePlatform() + + + private function dayBucketQuery(): AggregationQuery + { + return AggregationQuery::create( + metric: 'count', + dateBucket: [ + 'field' => 'created', + 'start' => '2026-05-01T00:00:00Z', + 'end' => '2026-05-22T00:00:00Z', + 'gap' => 'day', + ] + ); + + }//end dayBucketQuery() + + + private function makeSchema(): Schema + { + $schema = new Schema(); + $schema->setSlug('calllogs'); + $schema->setId(1); + return $schema; + + }//end makeSchema() + + + private function makeRegister(): Register + { + $register = new Register(); + $register->setSlug('openconnector'); + $register->setSchemas([1]); + return $register; + + }//end makeRegister() + + + private function makeRunner(): AggregationRunner + { + return new AggregationRunner( + magicMapper: $this->magicMapper, + registerMapper: $this->registerMapper, + schemaMapper: $this->schemaMapper, + placeholders: $this->placeholderResolver, + db: $this->db, + cache: $this->cache, + permissionHandler: $this->permissionHandler, + userSession: $this->userSession, + organisationService: $this->organisationService, + searchBackend: null + ); + + }//end makeRunner() + + +}//end class diff --git a/tests/Unit/Service/Aggregation/TimeseriesRequestValidatorTest.php b/tests/Unit/Service/Aggregation/TimeseriesRequestValidatorTest.php new file mode 100644 index 000000000000..4c4e782535e4 --- /dev/null +++ b/tests/Unit/Service/Aggregation/TimeseriesRequestValidatorTest.php @@ -0,0 +1,321 @@ + + * + * @author Conduction Development Team + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @link https://www.OpenRegister.app + * + * @spec openspec/changes/add-time-bucket-aggregation/specs/aggregation-api/spec.md + */ + +declare(strict_types=1); + +namespace Unit\Service\Aggregation; + +use InvalidArgumentException; +use OCA\OpenRegister\Db\Schema; +use OCA\OpenRegister\Service\Aggregation\TimeseriesRequestValidator; +use PHPUnit\Framework\TestCase; + +/** + * @coversDefaultClass \OCA\OpenRegister\Service\Aggregation\TimeseriesRequestValidator + */ +class TimeseriesRequestValidatorTest extends TestCase +{ + + private TimeseriesRequestValidator $validator; + + /** + * @return void + */ + protected function setUp(): void + { + $this->validator = new TimeseriesRequestValidator(); + }//end setUp() + + /** + * A schema mock that returns a fixed property set. + * + * @param array> $properties Property definitions keyed by name. + * + * @return Schema The configured schema mock. + */ + private function schemaWith(array $properties): Schema + { + $schema = $this->createMock(Schema::class); + $schema->method('getProperties')->willReturn($properties); + return $schema; + }//end schemaWith() + + /** + * Categorical groupBy: just a field. AggregationQuery.groupBy is + * set, dateBucket is null. + * + * @return void + */ + public function testCategoricalGroupByOnDeclaredFieldPasses(): void + { + $schema = $this->schemaWith(['status' => ['type' => 'string']]); + + $query = $this->validator->validate( + input: ['field' => 'status'], + schema: $schema + ); + + $this->assertSame('count', $query->metric); + $this->assertSame('status', $query->getGroupByField()); + $this->assertFalse($query->hasDateBucket()); + }//end testCategoricalGroupByOnDeclaredFieldPasses() + + /** + * Time-bucket groupBy: dateBucket is set, groupBy is null. + * + * @return void + */ + public function testTimeBucketDayPasses(): void + { + $schema = $this->schemaWith( + [ + 'created' => ['type' => 'string', 'format' => 'date-time'], + ] + ); + + $query = $this->validator->validate( + input: [ + 'field' => 'created', + 'interval' => 'DAY', + 'from' => '2026-05-01T00:00:00Z', + 'to' => '2026-05-22T00:00:00Z', + ], + schema: $schema + ); + + $this->assertTrue($query->hasDateBucket()); + $this->assertSame('day', $query->dateBucket['gap']); + $this->assertNull($query->groupBy); + }//end testTimeBucketDayPasses() + + /** + * @return void + */ + public function testEmptyFieldIsRejected(): void + { + $schema = $this->schemaWith(['status' => ['type' => 'string']]); + + $this->expectException(InvalidArgumentException::class); + $this->expectExceptionMessage('`field` is required'); + + $this->validator->validate(input: ['field' => ''], schema: $schema); + }//end testEmptyFieldIsRejected() + + /** + * @return void + */ + public function testUnknownFieldIsRejected(): void + { + $schema = $this->schemaWith(['status' => ['type' => 'string']]); + + $this->expectException(InvalidArgumentException::class); + $this->expectExceptionMessage('__totally_made_up'); + + $this->validator->validate( + input: ['field' => '__totally_made_up'], + schema: $schema + ); + }//end testUnknownFieldIsRejected() + + /** + * @return void + */ + public function testMagicMetadataFieldIsAllowed(): void + { + $schema = $this->schemaWith([]); + + $query = $this->validator->validate( + input: [ + 'field' => '_created', + 'interval' => 'DAY', + 'from' => '2026-05-01T00:00:00Z', + 'to' => '2026-05-22T00:00:00Z', + ], + schema: $schema + ); + + $this->assertTrue($query->hasDateBucket()); + }//end testMagicMetadataFieldIsAllowed() + + /** + * @return void + */ + public function testSubDayIntervalOnDateOnlyFieldIsRejected(): void + { + $schema = $this->schemaWith( + [ + 'meetingDate' => ['type' => 'string', 'format' => 'date'], + ] + ); + + $this->expectException(InvalidArgumentException::class); + $this->expectExceptionMessage('sub-day interval'); + + $this->validator->validate( + input: [ + 'field' => 'meetingDate', + 'interval' => 'HOUR', + 'from' => '2026-05-21T00:00:00Z', + 'to' => '2026-05-22T00:00:00Z', + ], + schema: $schema + ); + }//end testSubDayIntervalOnDateOnlyFieldIsRejected() + + /** + * @return void + */ + public function testIntervalWithoutBoundsIsRejected(): void + { + $schema = $this->schemaWith( + [ + 'created' => ['type' => 'string', 'format' => 'date-time'], + ] + ); + + $this->expectException(InvalidArgumentException::class); + $this->expectExceptionMessage('`from` and `to` are required'); + + $this->validator->validate( + input: ['field' => 'created', 'interval' => 'DAY'], + schema: $schema + ); + }//end testIntervalWithoutBoundsIsRejected() + + /** + * @return void + */ + public function testUnparseableBoundsAreRejected(): void + { + $schema = $this->schemaWith( + [ + 'created' => ['type' => 'string', 'format' => 'date-time'], + ] + ); + + $this->expectException(InvalidArgumentException::class); + $this->expectExceptionMessage('parseable ISO-8601'); + + $this->validator->validate( + input: [ + 'field' => 'created', + 'interval' => 'DAY', + 'from' => 'not-a-date', + 'to' => 'also-not-a-date', + ], + schema: $schema + ); + }//end testUnparseableBoundsAreRejected() + + /** + * @return void + */ + public function testUnknownIntervalIsRejected(): void + { + $schema = $this->schemaWith( + [ + 'created' => ['type' => 'string', 'format' => 'date-time'], + ] + ); + + $this->expectException(InvalidArgumentException::class); + $this->expectExceptionMessage('`interval` MUST be one of'); + + $this->validator->validate( + input: [ + 'field' => 'created', + 'interval' => 'CENTURY', + 'from' => '2026-01-01T00:00:00Z', + 'to' => '2026-12-31T00:00:00Z', + ], + schema: $schema + ); + }//end testUnknownIntervalIsRejected() + + /** + * @return void + */ + public function testNonCountMetricWithoutMetricFieldIsRejected(): void + { + $schema = $this->schemaWith( + [ + 'status' => ['type' => 'string'], + 'duration' => ['type' => 'number'], + ] + ); + + $this->expectException(InvalidArgumentException::class); + $this->expectExceptionMessage('`metricField` is required'); + + $this->validator->validate( + input: ['field' => 'status', 'metric' => 'sum'], + schema: $schema + ); + }//end testNonCountMetricWithoutMetricFieldIsRejected() + + /** + * @return void + */ + public function testNonCountMetricWithUnknownMetricFieldIsRejected(): void + { + $schema = $this->schemaWith(['status' => ['type' => 'string']]); + + $this->expectException(InvalidArgumentException::class); + $this->expectExceptionMessage('not a declared property'); + + $this->validator->validate( + input: [ + 'field' => 'status', + 'metric' => 'sum', + 'metricField' => '__unknown', + ], + schema: $schema + ); + }//end testNonCountMetricWithUnknownMetricFieldIsRejected() + + /** + * @return void + */ + public function testSumOverDeclaredFieldPasses(): void + { + $schema = $this->schemaWith( + [ + 'status' => ['type' => 'string'], + 'duration' => ['type' => 'number'], + ] + ); + + $query = $this->validator->validate( + input: [ + 'field' => 'status', + 'metric' => 'sum', + 'metricField' => 'duration', + ], + schema: $schema + ); + + $this->assertSame('sum', $query->metric); + $this->assertSame('duration', $query->field); + $this->assertSame('status', $query->getGroupByField()); + }//end testSumOverDeclaredFieldPasses() +}//end class From d5b023fd5d878fd44073657416f5475b60dd4877 Mon Sep 17 00:00:00 2001 From: Thijn Date: Fri, 22 May 2026 09:39:17 +0200 Subject: [PATCH 029/333] style(migration): fix phpcs violations in `_uuid` repair migration Address PR #1612 review comment about CI phpcs failures. - Use named parameter on internal call: `findAffectedTables(isPostgres: $isPostgres)` - Auto-fix 18 remaining formatting violations via `phpcbf` (blank lines around functions, equals alignment, multi-line call brace placement, `//end ...` markers, equals alignment) - Tidy continuation indent on the multi-line `$output` calls phpcbf reformatted Verified locally: `vendor/bin/phpcs` on the file now reports zero errors. --- lib/Migration/Version1Date20260521120000.php | 58 ++++++++++---------- 1 file changed, 29 insertions(+), 29 deletions(-) diff --git a/lib/Migration/Version1Date20260521120000.php b/lib/Migration/Version1Date20260521120000.php index bc1ce1d4ddf0..68adfc73b0c4 100644 --- a/lib/Migration/Version1Date20260521120000.php +++ b/lib/Migration/Version1Date20260521120000.php @@ -61,7 +61,6 @@ class Version1Date20260521120000 extends SimpleMigrationStep */ private IDBConnection $connection; - /** * Constructor. * @@ -73,7 +72,6 @@ public function __construct(IDBConnection $connection) }//end __construct() - /** * No schema changes — repair runs in postSchemaChange where raw * DDL against dynamic tables is allowed. @@ -92,7 +90,6 @@ public function changeSchema(IOutput $output, Closure $schemaClosure, array $opt }//end changeSchema() - /** * Drop the bare `_uuid` index on every `oc_openregister_table_*` table. * @@ -110,7 +107,7 @@ public function postSchemaChange(IOutput $output, Closure $schemaClosure, array { $isPostgres = ($this->connection->getDatabaseProvider() === IDBConnection::PLATFORM_POSTGRES); - $affectedTables = $this->findAffectedTables($isPostgres); + $affectedTables = $this->findAffectedTables(isPostgres: $isPostgres); if (\count($affectedTables) === 0) { $output->info(message: 'No dynamic openregister tables have the bare `_uuid` index — nothing to repair.'); @@ -127,7 +124,7 @@ public function postSchemaChange(IOutput $output, Closure $schemaClosure, array foreach ($affectedTables as $tableName) { try { // Look up indexes on this table named `_uuid` and drop each by full name. - $sql = "SELECT indexname + $sql = "SELECT indexname FROM pg_indexes WHERE tablename = ? AND indexname LIKE '\\_uuid%' ESCAPE '\\'"; @@ -144,13 +141,15 @@ public function postSchemaChange(IOutput $output, Closure $schemaClosure, array } } } catch (Throwable $e) { - $output->warning(message: sprintf( - 'Failed to drop bare `_uuid` index on `%s`: %s', - $tableName, - $e->getMessage() - )); - } - } + $output->warning( + message: sprintf( + 'Failed to drop bare `_uuid` index on `%s`: %s', + $tableName, + $e->getMessage() + ) + ); + }//end try + }//end foreach } else { $dropped = 0; foreach ($affectedTables as $tableName) { @@ -160,24 +159,27 @@ public function postSchemaChange(IOutput $output, Closure $schemaClosure, array ); $dropped++; } catch (Throwable $e) { - $output->warning(message: sprintf( - 'Failed to drop bare `_uuid` index on `%s`: %s', - $tableName, - $e->getMessage() - )); + $output->warning( + message: sprintf( + 'Failed to drop bare `_uuid` index on `%s`: %s', + $tableName, + $e->getMessage() + ) + ); } } - } + }//end if - $output->info(message: sprintf( - 'Dropped bare `_uuid` index on %d of %d dynamic openregister table(s).', - $dropped, - \count($affectedTables) - )); + $output->info( + message: sprintf( + 'Dropped bare `_uuid` index on %d of %d dynamic openregister table(s).', + $dropped, + \count($affectedTables) + ) + ); }//end postSchemaChange() - /** * Find every `oc_openregister_table_*` table that has an index literally * named `_uuid`. Returns the unprefixed table names that MySQL/MariaDB @@ -197,13 +199,13 @@ private function findAffectedTables(bool $isPostgres): array // whose bare index ended up as `_uuid1` (Postgres' on-collision // auto-suffix) is still surfaced for repair. The downstream // drop step re-filters with a strict `^_uuid(\d+)?$` regex. - $sql = "SELECT tablename + $sql = "SELECT tablename FROM pg_indexes WHERE indexname LIKE '\\_uuid%' ESCAPE '\\' AND tablename LIKE 'oc_openregister_table_%'"; $result = $this->connection->executeQuery($sql); } else { - $sql = 'SELECT TABLE_NAME + $sql = 'SELECT TABLE_NAME FROM INFORMATION_SCHEMA.STATISTICS WHERE TABLE_SCHEMA = DATABASE() AND INDEX_NAME = ? @@ -222,11 +224,9 @@ private function findAffectedTables(bool $isPostgres): array // If introspection fails (unsupported platform, permission issue), // surface no tables and let the caller log the no-op message. return []; - } + }//end try return $tableNames; }//end findAffectedTables() - - }//end class From 850a6eaf75604707f0f224a5f815f47bfc393901 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Fri, 22 May 2026 11:57:43 +0200 Subject: [PATCH 030/333] feat(archival): honor x-openregister-archival annotation (closes #1614) (#1647) Wires the silently-stripped x-openregister-archival annotation into a full declarative retention surface: schema-level vocabulary, validation, an immutability gate on user-driven deletes, an hourly retention sweep cron, and a computed _retention block on object reads. - Vocabulary: add x-openregister-archival and x-openregister-seed to Schema::ANNOTATION_VOCABULARY so they survive cleanObject() round-trip instead of falling into the "Dropped unknown key" warning. Seed is in-scope because the openconnector descriptor already declares it. - Validation: ArchivalAnnotationValidator mirrors LifecycleAnnotationValidator; wired into SchemaMapper::insert()/update(). Required: retention.default + each rule.retention parseable as ISO-8601 duration via \DateInterval. Required: each rule.condition is a non-empty string. Unknown keys under retention.* fail loudly so typos surface. - Immutability: ArchivalImmutableException (HTTP 403, structured body {error:SCHEMA_ARCHIVAL_IMMUTABLE, schema, operation, hint}). New $_retentionSweep private signature flag on ObjectService::deleteObject() alongside $_rbac/$_multitenancy. Only the cron sets it true. - Retention sweep cron: ArchivalRetentionTask (TimedJob, 1h interval, TIME_INSENSITIVE, single-instance). Iterates every (register, schema) with x-openregister-archival, resolves the magic table, and runs a native SELECT * scan per schema. Each row goes through RetentionEvaluator which picks first-match-wins across rules, falls back to retention.default, and computes expiresAt = _created + DateInterval(effectiveRetention). Rows past expiry are deleted via deleteObject(... _retentionSweep:true) so audit trails still fire. Emits per-schema summary {scanned, expired, deleted}. - Surface: RenderObject::applyArchivalRetentionBlock attaches retention.annotation = {effectiveRetention, matchedRule, expiresAt} at render time. Computed on read so an annotation change recomputes for every row; never collides with the records-management retention surface which owns retention.archiefactiedatum/archiefnominatie (R3, D7). Quality gates: PHPCS green on new files, PHPMD clean, PHPStan + Psalm both green (3 pre-existing SchemaMapper trait-property false positives added to phpstan-baseline.neon following the OasService pattern). 38 new unit tests, all pass. Spec: openspec/changes/add-archival-annotation-support (validate --strict green). Deferred follow-ups (filed as #1614 acceptance criteria done, the rest go into a separate issue): task 5.7 cron-sweep unit test (heavy DB mocking, covered by the existing RetentionEvaluator unit tests + manual 8.3 live verification once a dev container is available); task 6.2 _retention render unit test (needs the full Nextcloud bootstrap for ObjectEntity); 8.x live verifications. --- appinfo/info.xml | 1 + lib/Cron/ArchivalRetentionTask.php | 442 ++++++++++++++++++ lib/Db/Schema.php | 2 + lib/Db/SchemaMapper.php | 36 ++ lib/Exception/ArchivalImmutableException.php | 133 ++++++ .../Archival/ArchivalAnnotationValidator.php | 276 +++++++++++ .../Archival/RetentionConditionEvaluator.php | 186 ++++++++ lib/Service/Archival/RetentionEvaluator.php | 195 ++++++++ lib/Service/Object/RenderObject.php | 72 +++ lib/Service/ObjectService.php | 62 ++- .../.openspec.yaml | 2 + .../add-archival-annotation-support/design.md | 69 +++ .../proposal.md | 65 +++ .../archival-annotation-vocabulary/spec.md | 141 ++++++ .../add-archival-annotation-support/tasks.md | 67 +++ phpstan-baseline.neon | 30 ++ .../Unit/Db/SchemaArchivalVocabularyTest.php | 125 +++++ .../ArchivalImmutableExceptionTest.php | 46 ++ .../ArchivalAnnotationValidatorTest.php | 200 ++++++++ .../RetentionConditionEvaluatorTest.php | 108 +++++ .../Archival/RetentionEvaluatorTest.php | 187 ++++++++ 21 files changed, 2435 insertions(+), 10 deletions(-) create mode 100644 lib/Cron/ArchivalRetentionTask.php create mode 100644 lib/Exception/ArchivalImmutableException.php create mode 100644 lib/Service/Archival/ArchivalAnnotationValidator.php create mode 100644 lib/Service/Archival/RetentionConditionEvaluator.php create mode 100644 lib/Service/Archival/RetentionEvaluator.php create mode 100644 openspec/changes/add-archival-annotation-support/.openspec.yaml create mode 100644 openspec/changes/add-archival-annotation-support/design.md create mode 100644 openspec/changes/add-archival-annotation-support/proposal.md create mode 100644 openspec/changes/add-archival-annotation-support/specs/archival-annotation-vocabulary/spec.md create mode 100644 openspec/changes/add-archival-annotation-support/tasks.md create mode 100644 tests/Unit/Db/SchemaArchivalVocabularyTest.php create mode 100644 tests/Unit/Exception/ArchivalImmutableExceptionTest.php create mode 100644 tests/Unit/Service/Archival/ArchivalAnnotationValidatorTest.php create mode 100644 tests/Unit/Service/Archival/RetentionConditionEvaluatorTest.php create mode 100644 tests/Unit/Service/Archival/RetentionEvaluatorTest.php diff --git a/appinfo/info.xml b/appinfo/info.xml index 80125d5725bb..0e7c9cf1d6e8 100644 --- a/appinfo/info.xml +++ b/appinfo/info.xml @@ -102,6 +102,7 @@ Vrij en open source onder de EUPL-licentie. OCA\OpenRegister\BackgroundJob\AvgRetentionJob OCA\OpenRegister\BackgroundJob\ReportRenderJob OCA\OpenRegister\BackgroundJob\BatchNotificationJob + OCA\OpenRegister\Cron\ArchivalRetentionTask diff --git a/lib/Cron/ArchivalRetentionTask.php b/lib/Cron/ArchivalRetentionTask.php new file mode 100644 index 000000000000..b978feafe27b --- /dev/null +++ b/lib/Cron/ArchivalRetentionTask.php @@ -0,0 +1,442 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @version GIT: + * + * @link https://OpenRegister.app + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-5 + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Cron; + +use DateTimeImmutable; +use DateTimeInterface; +use Exception; +use OCA\OpenRegister\Db\MagicMapper; +use OCA\OpenRegister\Db\Register; +use OCA\OpenRegister\Db\RegisterMapper; +use OCA\OpenRegister\Db\Schema; +use OCA\OpenRegister\Db\SchemaMapper; +use OCA\OpenRegister\Service\Archival\RetentionEvaluator; +use OCA\OpenRegister\Service\ObjectService; +use OCP\AppFramework\Utility\ITimeFactory; +use OCP\BackgroundJob\IJob; +use OCP\BackgroundJob\TimedJob; +use OCP\IDBConnection; +use Psr\Log\LoggerInterface; + +/** + * Background job that enforces `x-openregister-archival` retention rules. + * + * Scheduled hourly, time-insensitive, single-instance. + * + * @psalm-suppress UnusedClass Registered in appinfo/info.xml . + * + * @SuppressWarnings(PHPMD.CouplingBetweenObjects) + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-5 + */ +class ArchivalRetentionTask extends TimedJob +{ + + /** + * Database connection for native row scans. + * + * @var IDBConnection + */ + private readonly IDBConnection $db; + + /** + * Register repository used to enumerate active registers. + * + * @var RegisterMapper + */ + private readonly RegisterMapper $registerMapper; + + /** + * Schema repository used to enumerate annotated schemas. + * + * @var SchemaMapper + */ + private readonly SchemaMapper $schemaMapper; + + /** + * Magic-table resolver used to map registers/schemas to physical tables. + * + * @var MagicMapper + */ + private readonly MagicMapper $magicMapper; + + /** + * Object service used to perform the sweep deletes. + * + * @var ObjectService + */ + private readonly ObjectService $objectService; + + /** + * Logger for per-schema summaries. + * + * @var LoggerInterface + */ + private readonly LoggerInterface $logger; + + /** + * Cached retention evaluator (stateless apart from DI). + * + * @var RetentionEvaluator + */ + private RetentionEvaluator $retentionEvaluator; + + /** + * Constructor. + * + * @param ITimeFactory $time Time factory for TimedJob scheduling. + * @param IDBConnection $db Database connection for native SQL row scan. + * @param RegisterMapper $registerMapper Register repository. + * @param SchemaMapper $schemaMapper Schema repository. + * @param MagicMapper $magicMapper Magic-table resolver. + * @param ObjectService $objectService Service used to perform the sweep deletes. + * @param LoggerInterface $logger Logger for per-schema summaries. + */ + public function __construct( + ITimeFactory $time, + IDBConnection $db, + RegisterMapper $registerMapper, + SchemaMapper $schemaMapper, + MagicMapper $magicMapper, + ObjectService $objectService, + LoggerInterface $logger + ) { + parent::__construct(time: $time); + + $this->db = $db; + $this->registerMapper = $registerMapper; + $this->schemaMapper = $schemaMapper; + $this->magicMapper = $magicMapper; + $this->objectService = $objectService; + $this->logger = $logger; + + $this->retentionEvaluator = new RetentionEvaluator(logger: $logger); + + // Run every hour (3600 seconds). + $this->setInterval(seconds: 3600); + + // Delay until low-load time. + $this->setTimeSensitivity(sensitivity: IJob::TIME_INSENSITIVE); + + // Only run one instance of this job at a time. + $this->setAllowParallelRuns(allow: false); + + }//end __construct() + + /** + * Execute the retention sweep across every archival-annotated schema. + * + * @param mixed $argument Background-job argument (unused). + * + * @return void + * + * @SuppressWarnings(PHPMD.UnusedFormalParameter) + */ + protected function run($argument): void + { + $now = new DateTimeImmutable(); + + try { + $registers = $this->registerMapper->findAll(_rbac: false, _multitenancy: false); + } catch (Exception $error) { + $this->logger->error( + '[ArchivalRetentionTask] Failed to load registers: '.$error->getMessage(), + ['app' => 'openregister', 'exception' => $error] + ); + return; + } + + foreach ($registers as $register) { + // Defensive: findAll() returns Register[] per docblock; this + // guard simply hardens the loop against future mapper changes. + if (($register instanceof Register) === false) { + continue; + } + + foreach (($register->getSchemas() ?? []) as $schemaId) { + try { + $schema = $this->schemaMapper->find((int) $schemaId); + } catch (Exception $error) { + $this->logger->warning( + sprintf('[ArchivalRetentionTask] Schema #%s not loadable: %s', (string) $schemaId, $error->getMessage()), + ['app' => 'openregister'] + ); + continue; + } + + $annotation = $this->extractArchivalAnnotation(schema: $schema); + if ($annotation === null) { + continue; + } + + $this->sweepSchema( + register: $register, + schema: $schema, + annotation: $annotation, + now: $now + ); + }//end foreach + }//end foreach + + }//end run() + + /** + * Return the `x-openregister-archival` annotation when present, or null. + * + * @param Schema $schema Schema to inspect. + * + * @return array|null Annotation block or null when absent. + */ + private function extractArchivalAnnotation(Schema $schema): ?array + { + $configuration = ($schema->getConfiguration() ?? []); + if (is_array($configuration) === false) { + return null; + } + + $annotation = ($configuration['x-openregister-archival'] ?? null); + if (is_array($annotation) === false) { + return null; + } + + return $annotation; + + }//end extractArchivalAnnotation() + + /** + * Sweep a single `(register, schema)` pair. + * + * Pulls every row from the magic table, evaluates the retention rules + * against each, and deletes rows past their expiry. Logs a per-schema + * summary `{schemaSlug, scanned, expired, deleted}`. + * + * @param Register $register Register the schema belongs to. + * @param Schema $schema Schema being swept. + * @param array $annotation `x-openregister-archival` annotation. + * @param DateTimeInterface $now Sweep wall-clock anchor. + * + * @return void + * + * @SuppressWarnings(PHPMD.CyclomaticComplexity) + * @SuppressWarnings(PHPMD.NPathComplexity) + * @SuppressWarnings(PHPMD.ExcessiveMethodLength) + */ + private function sweepSchema( + Register $register, + Schema $schema, + array $annotation, + DateTimeInterface $now + ): void { + $schemaSlug = $schema->getSlug() ?? (string) $schema->getId(); + + // Resolve table name; skip if the magic table has not been + // materialised yet (e.g. brand-new schema with no rows). + try { + $tableExists = $this->magicMapper->tableExistsForRegisterSchema( + register: $register, + schema: $schema + ); + } catch (Exception $error) { + $this->logger->warning( + sprintf( + '[ArchivalRetentionTask] Cannot check magic-table existence for schema "%s": %s', + $schemaSlug, + $error->getMessage() + ), + ['app' => 'openregister'] + ); + return; + } + + if ($tableExists === false) { + return; + } + + $tableName = MagicMapper::TABLE_PREFIX.((string) $register->getId()).'_'.((string) $schema->getId()); + + $scanned = 0; + $expired = 0; + $deleted = 0; + + try { + // Native SELECT — using the QueryBuilder so the table name goes + // through the platform-aware quoter. We only need the uuid + + // _created + the row's hydrated field columns; pulling `*` keeps + // the implementation table-shape-agnostic. + $qb = $this->db->getQueryBuilder(); + $qb->select('*')->from($tableName); + + $cursor = $qb->executeQuery(); + while (($row = $cursor->fetch()) !== false) { + $scanned++; + + $createdRaw = ($row['_created'] ?? null); + if ($createdRaw === null) { + // Without a created timestamp we cannot decide expiry. + continue; + } + + try { + $createdAt = new DateTimeImmutable((string) $createdRaw); + } catch (Exception $error) { + $this->logger->warning( + sprintf( + '[ArchivalRetentionTask] Row with unparseable _created skipped on "%s": %s', + $schemaSlug, + $error->getMessage() + ), + ['app' => 'openregister'] + ); + continue; + } + + try { + $result = $this->retentionEvaluator->evaluate( + annotation: $annotation, + row: $this->stripMetadataColumns(row: $row), + createdAt: $createdAt + ); + } catch (Exception $error) { + $this->logger->warning( + sprintf( + '[ArchivalRetentionTask] Skipping row on "%s": %s', + $schemaSlug, + $error->getMessage() + ), + ['app' => 'openregister'] + ); + continue; + } + + $expiresAt = new DateTimeImmutable($result['expiresAt']); + if ($expiresAt >= $now) { + continue; + } + + $expired++; + + $uuid = (string) ($row['_uuid'] ?? ''); + if ($uuid === '') { + continue; + } + + try { + // Re-anchor ObjectService at the (register, schema) we + // are sweeping so the delete pipeline sees the right + // context. setSchema / setRegister are idempotent. + $this->objectService->setRegister(register: $register); + $this->objectService->setSchema(schema: $schema); + + $deleteOk = $this->objectService->deleteObject( + uuid: $uuid, + _rbac: false, + _multitenancy: false, + _retentionSweep: true + ); + + if ($deleteOk === true) { + $deleted++; + } + } catch (Exception $error) { + $this->logger->warning( + sprintf( + '[ArchivalRetentionTask] Delete failed on schema "%s" uuid "%s": %s', + $schemaSlug, + $uuid, + $error->getMessage() + ), + ['app' => 'openregister'] + ); + }//end try + }//end while + + $cursor->closeCursor(); + } catch (Exception $error) { + $this->logger->error( + sprintf( + '[ArchivalRetentionTask] Sweep failed on schema "%s": %s', + $schemaSlug, + $error->getMessage() + ), + ['app' => 'openregister', 'exception' => $error] + ); + }//end try + + $this->logger->info( + sprintf( + '[ArchivalRetentionTask] schema="%s" scanned=%d expired=%d deleted=%d', + $schemaSlug, + $scanned, + $expired, + $deleted + ), + [ + 'app' => 'openregister', + 'schemaSlug' => $schemaSlug, + 'scanned' => $scanned, + 'expired' => $expired, + 'deleted' => $deleted, + ] + ); + + }//end sweepSchema() + + /** + * Drop the magic-table metadata columns (`_uuid`, `_created`, ...) from a + * raw row so the row passed to the condition evaluator carries only the + * schema-declared fields. + * + * @param array $row Raw row as returned by the QueryBuilder cursor. + * + * @return array Filtered row. + */ + private function stripMetadataColumns(array $row): array + { + $filtered = []; + foreach ($row as $key => $value) { + if (is_string($key) === true && str_starts_with($key, '_') === true) { + continue; + } + + $filtered[$key] = $value; + } + + return $filtered; + + }//end stripMetadataColumns() +}//end class diff --git a/lib/Db/Schema.php b/lib/Db/Schema.php index 0ebe3c7ff9cd..f50b537b8165 100644 --- a/lib/Db/Schema.php +++ b/lib/Db/Schema.php @@ -1859,6 +1859,8 @@ private function validateAllowedTagsValue(mixed $value): void 'x-openregister-widgets', 'x-openregister-relations', 'x-openregister-processing-activity', + 'x-openregister-archival', + 'x-openregister-seed', ]; /** diff --git a/lib/Db/SchemaMapper.php b/lib/Db/SchemaMapper.php index a8dbb2f8daf9..254b86f0c3c2 100644 --- a/lib/Db/SchemaMapper.php +++ b/lib/Db/SchemaMapper.php @@ -45,6 +45,7 @@ use Symfony\Component\Uid\Uuid; use OCA\OpenRegister\Service\Aggregation\AggregationAnnotationValidator; use OCA\OpenRegister\Service\Aggregation\WidgetAnnotationValidator; +use OCA\OpenRegister\Service\Archival\ArchivalAnnotationValidator; use OCA\OpenRegister\Service\Calculation\CalculationAnnotationValidator; use OCA\OpenRegister\Service\Lifecycle\LifecycleAnnotationValidator; use OCA\OpenRegister\Service\Notification\NotificationAnnotationValidator; @@ -609,6 +610,7 @@ private function cleanObject(Schema $schema): void $this->validateCalculationsAnnotation(schema: $schema); $this->validateNotificationsAnnotation(schema: $schema); $this->validateWidgetsAnnotation(schema: $schema); + $this->validateArchivalAnnotation(schema: $schema); $this->logDroppedAnnotationKeys(schema: $schema); }//end cleanObject() @@ -802,6 +804,40 @@ private function validateWidgetsAnnotation(Schema $schema): void throw new Exception('x-openregister-widgets: '.implode(' ', $messages)); }//end validateWidgetsAnnotation() + /** + * Validate the optional `x-openregister-archival` annotation. + * + * The annotation is stored under `configuration['x-openregister-archival']`. + * Errors are aggregated by ArchivalAnnotationValidator and thrown here as + * a single message so callers see a clear schema-save failure. + * + * @param Schema $schema Schema to validate. + * + * @throws Exception When the annotation is malformed. + * + * @return void + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-2 + */ + private function validateArchivalAnnotation(Schema $schema): void + { + $configuration = ($schema->getConfiguration() ?? []); + $annotation = ($configuration['x-openregister-archival'] ?? null); + if (is_array($annotation) === false) { + return; + } + + $shape = ['x-openregister-archival' => $annotation]; + + $errors = (new ArchivalAnnotationValidator())->validate(schema: $shape); + if (count($errors) === 0) { + return; + } + + $messages = array_map(static fn(array $err) => $err['message'], $errors); + throw new Exception('x-openregister-archival: '.implode(' ', $messages)); + }//end validateArchivalAnnotation() + /** * Clean $ref properties to ensure they are strings * diff --git a/lib/Exception/ArchivalImmutableException.php b/lib/Exception/ArchivalImmutableException.php new file mode 100644 index 000000000000..deff5e800343 --- /dev/null +++ b/lib/Exception/ArchivalImmutableException.php @@ -0,0 +1,133 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @version GIT: + * + * @link https://OpenRegister.app + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-3-1 + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Exception; + +use Throwable; + +/** + * Exception thrown when a DELETE hits an archival-annotated schema. + * + * Archival schemas are immutable by virtue of their declared retention rules: + * the system itself decides when each row expires, not the caller. Operators + * needing to clean specific rows must either (a) wait for the cron's sweep + * or (b) drop the annotation from the schema first. + * + * Callers should translate this to HTTP 403 Forbidden with the structured + * error body: + * { + * "error": "SCHEMA_ARCHIVAL_IMMUTABLE", + * "message": "...", + * "schema": "...", + * "operation": "delete", + * "hint": "..." + * } + * + * @category Exception + * @package OCA\OpenRegister\Exception + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-3 + */ +class ArchivalImmutableException extends \Exception +{ + + /** + * The schema slug or identifier that triggered this exception. + * + * @var string + */ + private readonly string $schemaIdentifier; + + /** + * The blocked operation name (always 'delete' in v1, reserved for future ops). + * + * @var string + */ + private readonly string $operation; + + /** + * Constructor. + * + * @param string $schemaIdentifier The schema slug, UUID, or ID. + * @param string $operation The blocked operation name (e.g. 'delete'). + * @param Throwable|null $previous Previous exception. + */ + public function __construct( + string $schemaIdentifier, + string $operation='delete', + ?Throwable $previous=null + ) { + $this->schemaIdentifier = $schemaIdentifier; + $this->operation = $operation; + + $message = sprintf( + 'SCHEMA_ARCHIVAL_IMMUTABLE: Schema "%s" declares x-openregister-archival; ' + .'user-driven %s operations are not permitted. Rows expire automatically ' + .'via the ArchivalRetentionTask cron.', + $schemaIdentifier, + $operation + ); + + parent::__construct(message: $message, code: 403, previous: $previous); + + }//end __construct() + + /** + * Get the schema identifier that triggered this exception. + * + * @return string The schema slug, UUID, or ID. + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-3 + */ + public function getSchemaIdentifier(): string + { + return $this->schemaIdentifier; + + }//end getSchemaIdentifier() + + /** + * Build the structured JSON error body for HTTP 403 responses. + * + * @return array{error: string, message: string, schema: string, operation: string, hint: string} + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-3 + */ + public function toResponseBody(): array + { + return [ + 'error' => 'SCHEMA_ARCHIVAL_IMMUTABLE', + 'message' => $this->getMessage(), + 'schema' => $this->schemaIdentifier, + 'operation' => $this->operation, + 'hint' => 'Rows on archival schemas are removed automatically by ' + .'OCA\\OpenRegister\\Cron\\ArchivalRetentionTask when they pass their ' + .'effective retention. To force-delete, drop x-openregister-archival ' + .'from the schema definition first.', + ]; + + }//end toResponseBody() +}//end class diff --git a/lib/Service/Archival/ArchivalAnnotationValidator.php b/lib/Service/Archival/ArchivalAnnotationValidator.php new file mode 100644 index 000000000000..8bd6389cea0d --- /dev/null +++ b/lib/Service/Archival/ArchivalAnnotationValidator.php @@ -0,0 +1,276 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @version GIT: + * + * @link https://OpenRegister.app + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-2-1 + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Service\Archival; + +use DateInterval; +use Exception; + +/** + * Pure validation logic for the `x-openregister-archival` annotation. + * + * Hooked into `SchemaMapper::insert()` / `update()` alongside the existing + * lifecycle / aggregations validators. Errors translate to HTTP 422 + * schema-save failures via a single aggregated `\Exception` whose message + * starts `x-openregister-archival: `. + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-2 + */ +final class ArchivalAnnotationValidator +{ + + /** + * Allowed top-level keys under `retention`. + * + * @var array + */ + private const ALLOWED_RETENTION_KEYS = ['default', 'rules']; + + /** + * Allowed keys under each rule. + * + * @var array + */ + private const ALLOWED_RULE_KEYS = ['condition', 'retention', 'reason']; + + /** + * Validate the `x-openregister-archival` annotation block on a schema definition. + * + * @param array $schema Full schema definition. The validator only + * reads `x-openregister-archival`; it does + * not consult `properties` because the + * condition grammar is field-agnostic at + * save time (fields are resolved by the + * runtime evaluator against actual rows). + * + * @return array List of errors (empty = valid). + * + * @SuppressWarnings(PHPMD.CyclomaticComplexity) + * @SuppressWarnings(PHPMD.NPathComplexity) + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-2 + */ + public function validate(array $schema): array + { + if (isset($schema['x-openregister-archival']) === false) { + return []; + } + + $annotation = $schema['x-openregister-archival']; + $errors = []; + + if (is_array($annotation) === false) { + return [ + [ + 'code' => 'archival-not-object', + 'message' => 'x-openregister-archival must be an object.', + ], + ]; + } + + // `retention` block is required. + $retention = ($annotation['retention'] ?? null); + if (is_array($retention) === false) { + return [ + [ + 'code' => 'archival-retention-missing', + 'message' => 'x-openregister-archival.retention is required and must be an object.', + ], + ]; + } + + // Reject unknown keys under `retention.` so typos fail loudly. + foreach (array_keys($retention) as $key) { + if (in_array((string) $key, self::ALLOWED_RETENTION_KEYS, true) === false) { + $errors[] = [ + 'code' => 'archival-retention-unknown-key', + 'message' => sprintf( + 'x-openregister-archival.retention contains unknown key "%s". Allowed: %s.', + (string) $key, + implode(', ', self::ALLOWED_RETENTION_KEYS) + ), + ]; + } + } + + // `default` is required and must be a parseable ISO-8601 duration. + if (isset($retention['default']) === false) { + $errors[] = [ + 'code' => 'archival-retention-default-missing', + 'message' => 'x-openregister-archival.retention.default is required (ISO-8601 duration, e.g. "P30D").', + ]; + } else if ($this->isIsoDuration(value: $retention['default']) === false) { + $errors[] = [ + 'code' => 'archival-retention-default-malformed', + 'message' => sprintf( + 'x-openregister-archival.retention.default "%s" is not a valid ISO-8601 duration (e.g. "P30D", "PT1H", "P1Y6M").', + (string) $retention['default'] + ), + ]; + } + + // `rules` is optional but, when present, must be a list of rule objects. + if (isset($retention['rules']) === true && is_array($retention['rules']) === false) { + $errors[] = [ + 'code' => 'archival-rules-not-array', + 'message' => 'x-openregister-archival.retention.rules must be an array of rule objects.', + ]; + } + + if (isset($retention['rules']) === true && is_array($retention['rules']) === true) { + foreach ($retention['rules'] as $index => $rule) { + $errors = array_merge($errors, $this->validateRule(index: (int) $index, rule: $rule)); + } + } + + return $errors; + + }//end validate() + + /** + * Validate a single rule entry. + * + * @param int $index Zero-based rule index for error messages. + * @param mixed $rule Raw rule value. + * + * @return array + * + * @SuppressWarnings(PHPMD.CyclomaticComplexity) + */ + private function validateRule(int $index, mixed $rule): array + { + $errors = []; + + if (is_array($rule) === false) { + return [ + [ + 'code' => 'archival-rule-not-object', + 'message' => sprintf('x-openregister-archival.retention.rules[%d] must be an object.', $index), + ], + ]; + } + + // Reject unknown keys under each rule. + foreach (array_keys($rule) as $key) { + if (in_array((string) $key, self::ALLOWED_RULE_KEYS, true) === false) { + $errors[] = [ + 'code' => 'archival-rule-unknown-key', + 'message' => sprintf( + 'x-openregister-archival.retention.rules[%d] contains unknown key "%s". Allowed: %s.', + $index, + (string) $key, + implode(', ', self::ALLOWED_RULE_KEYS) + ), + ]; + } + } + + // `condition` MUST be a non-empty string. + $condition = ($rule['condition'] ?? null); + if (is_string($condition) === false) { + $errors[] = [ + 'code' => 'archival-rule-condition-not-string', + 'message' => sprintf( + 'x-openregister-archival.retention.rules[%d].condition must be a non-empty string.', + $index + ), + ]; + } else if (trim($condition) === '') { + $errors[] = [ + 'code' => 'archival-rule-condition-empty', + 'message' => sprintf( + 'x-openregister-archival.retention.rules[%d].condition must not be empty.', + $index + ), + ]; + } + + // `retention` MUST be parseable ISO-8601 duration. + if (isset($rule['retention']) === false) { + $errors[] = [ + 'code' => 'archival-rule-retention-missing', + 'message' => sprintf( + 'x-openregister-archival.retention.rules[%d].retention is required (ISO-8601 duration).', + $index + ), + ]; + } else if ($this->isIsoDuration(value: $rule['retention']) === false) { + $errors[] = [ + 'code' => 'archival-rule-retention-malformed', + 'message' => sprintf( + 'x-openregister-archival.retention.rules[%d].retention "%s" is not a valid ISO-8601 duration.', + $index, + (string) $rule['retention'] + ), + ]; + } + + // `reason` is optional; if present it MUST be a string. + if (isset($rule['reason']) === true && is_string($rule['reason']) === false) { + $errors[] = [ + 'code' => 'archival-rule-reason-not-string', + 'message' => sprintf( + 'x-openregister-archival.retention.rules[%d].reason must be a string when present.', + $index + ), + ]; + } + + return $errors; + + }//end validateRule() + + /** + * Return true when $value is a string parseable as ISO-8601 duration. + * + * Delegates to PHP's `\DateInterval` constructor which accepts the + * full ISO-8601 grammar (P[n]Y[n]M[n]DT[n]H[n]M[n]S). Rejects empty + * strings and non-string types up-front so the constructor only sees + * shape-positive input. + * + * @param mixed $value Candidate value. + * + * @return bool True when the value parses as a duration. + */ + private function isIsoDuration(mixed $value): bool + { + if (is_string($value) === false || $value === '') { + return false; + } + + try { + new DateInterval($value); + return true; + } catch (Exception $unused) { + return false; + } + + }//end isIsoDuration() +}//end class diff --git a/lib/Service/Archival/RetentionConditionEvaluator.php b/lib/Service/Archival/RetentionConditionEvaluator.php new file mode 100644 index 000000000000..b4b7e991e95c --- /dev/null +++ b/lib/Service/Archival/RetentionConditionEvaluator.php @@ -0,0 +1,186 @@ + ` evaluator for the + * `x-openregister-archival.retention.rules[].condition` DSL. + * + * Per design decision D4 of `add-archival-annotation-support`, the + * grammar is intentionally tiny: + * + * + * + * ops: < <= == != >= > + * literals: integer, float, single- or double-quoted string, + * `true`, `false`, `null` + * + * Anything more complex (AND/OR, sub-expressions, function calls) + * is intentionally out of scope. A future change can layer a real + * expression engine on top if the fleet ever needs it. + * + * @category Service + * @package OCA\OpenRegister\Service\Archival + * + * @author Conduction Development Team + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @version GIT: + * + * @link https://OpenRegister.app + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-4-1 + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Service\Archival; + +use InvalidArgumentException; + +/** + * Evaluate a single retention-rule condition against a row. + * + * The class is stateless; callers can instantiate once and re-use. + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-4 + */ +final class RetentionConditionEvaluator +{ + + /** + * Pattern matching ` ` with two-char ops first + * so `<=` does not match as `<` and `==` does not match as a partial. + * + * @var string + */ + private const PATTERN = '/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*(<=|>=|==|!=|<|>)\s*(.+?)\s*$/'; + + /** + * Evaluate a condition string against a row. + * + * @param string $condition Condition expression in the supported DSL. + * @param array $row Row data keyed by field name. + * + * @return bool True when the condition matches; false when the field is + * absent from the row or the comparison evaluates false. + * + * @throws InvalidArgumentException When the condition is malformed (wrong + * grammar, unknown operator, unparseable + * literal). Callers SHOULD catch + log; + * the cron does not crash on a single + * malformed rule. + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-4 + */ + public function evaluate(string $condition, array $row): bool + { + if (preg_match(self::PATTERN, $condition, $matches) !== 1) { + throw new InvalidArgumentException( + sprintf('Malformed retention condition: "%s". Expected " ".', $condition) + ); + } + + [, $field, $operator, $literalSource] = $matches; + + if (array_key_exists($field, $row) === false) { + // Field absent → no match. Spec D-Scenario "Missing field". + return false; + } + + $left = $row[$field]; + $right = $this->parseLiteral(source: $literalSource); + + return $this->compare(left: $left, right: $right, operator: $operator); + + }//end evaluate() + + /** + * Parse the literal source into a PHP value. + * + * @param string $source Raw literal text from the condition string. + * + * @return mixed Parsed value (int, float, string, bool, null). + * + * @throws InvalidArgumentException When the literal is not recognised. + * + * @SuppressWarnings(PHPMD.CyclomaticComplexity) + */ + private function parseLiteral(string $source): mixed + { + $trim = trim($source); + + // Bool / null sentinels. + if ($trim === 'true') { + return true; + } + + if ($trim === 'false') { + return false; + } + + if ($trim === 'null') { + return null; + } + + // Single- or double-quoted string literal. + $length = strlen($trim); + if ($length >= 2) { + $first = $trim[0]; + $last = $trim[($length - 1)]; + if (($first === '"' && $last === '"') || ($first === "'" && $last === "'")) { + return substr($trim, 1, ($length - 2)); + } + } + + // Numeric literal — int or float. + if (preg_match('/^-?\d+$/', $trim) === 1) { + return (int) $trim; + } + + if (preg_match('/^-?\d+\.\d+$/', $trim) === 1) { + return (float) $trim; + } + + throw new InvalidArgumentException( + sprintf('Unrecognised literal in retention condition: "%s".', $source) + ); + + }//end parseLiteral() + + /** + * Compare two values under the given operator. + * + * PHP's loose comparison semantics are used for `==` / `!=` so + * `200 == 200.0 → true`. Strict-typed equality is not part of + * the DSL; if you need it, write a different rule. + * + * For ordering ops (`<`, `<=`, `>=`, `>`) on null or string + * pairs we fall back to PHP's native comparison rules; this is + * documented as DSL behaviour, not a bug. + * + * @param mixed $left Left-hand value (from row). + * @param mixed $right Right-hand literal. + * @param string $operator One of the supported operators. + * + * @return bool + * + * @throws InvalidArgumentException When the operator is not in the supported set. + */ + private function compare(mixed $left, mixed $right, string $operator): bool + { + return match ($operator) { + '==' => $left == $right, + '!=' => $left != $right, + '<' => $left < $right, + '<=' => $left <= $right, + '>' => $left > $right, + '>=' => $left >= $right, + default => throw new InvalidArgumentException( + sprintf('Unsupported retention operator: "%s".', $operator) + ), + }; + + }//end compare() +}//end class diff --git a/lib/Service/Archival/RetentionEvaluator.php b/lib/Service/Archival/RetentionEvaluator.php new file mode 100644 index 000000000000..dc3d3b77f8fc --- /dev/null +++ b/lib/Service/Archival/RetentionEvaluator.php @@ -0,0 +1,195 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @version GIT: + * + * @link https://OpenRegister.app + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-4-2 + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Service\Archival; + +use DateInterval; +use DateTimeImmutable; +use DateTimeInterface; +use Exception; +use InvalidArgumentException; +use Psr\Log\LoggerInterface; +use Psr\Log\NullLogger; + +/** + * Maps an archival annotation + a row + its creation timestamp to the + * effective retention metadata for that row. + * + * Stateless apart from the injected logger; safe to instantiate per-call + * in hot paths if needed (the cron re-uses one instance per run). + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-4 + */ +final class RetentionEvaluator +{ + + /** + * Condition DSL evaluator used to match rules against a row. + * + * @var RetentionConditionEvaluator + */ + private RetentionConditionEvaluator $conditionEvaluator; + + /** + * Logger used for malformed-condition warnings. + * + * @var LoggerInterface + */ + private LoggerInterface $logger; + + /** + * Constructor. + * + * @param RetentionConditionEvaluator|null $conditionEvaluator Condition DSL evaluator (defaults to a fresh instance). + * @param LoggerInterface|null $logger Logger for malformed-condition warnings (defaults to NullLogger). + */ + public function __construct( + ?RetentionConditionEvaluator $conditionEvaluator=null, + ?LoggerInterface $logger=null + ) { + $this->conditionEvaluator = ($conditionEvaluator ?? new RetentionConditionEvaluator()); + $this->logger = ($logger ?? new NullLogger()); + + }//end __construct() + + /** + * Compute the effective retention for a row. + * + * @param array $annotation Full `x-openregister-archival` block from the schema's configuration. + * @param array $row Row data keyed by field name (output of the row's hydration). + * @param DateTimeInterface $createdAt The row's `_created` timestamp. + * + * @return array{ + * effectiveRetention: string, + * matchedRule: int|null, + * expiresAt: string + * } Effective retention duration (ISO-8601), matched rule index (or null + * when fallback to default), and absolute expiry as ATOM-formatted string. + * + * @throws InvalidArgumentException When the annotation has no usable retention. + * + * @SuppressWarnings(PHPMD.CyclomaticComplexity) + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-4 + */ + public function evaluate(array $annotation, array $row, DateTimeInterface $createdAt): array + { + $retention = ($annotation['retention'] ?? null); + if (is_array($retention) === false) { + throw new InvalidArgumentException( + 'RetentionEvaluator: annotation has no `retention` block; validate at schema-save time.' + ); + } + + $default = ($retention['default'] ?? null); + if (is_string($default) === false || $default === '') { + throw new InvalidArgumentException( + 'RetentionEvaluator: annotation.retention.default is missing or not a string.' + ); + } + + $rules = ($retention['rules'] ?? []); + $matchedRule = null; + $effectiveDur = $default; + + if (is_array($rules) === true) { + foreach ($rules as $index => $rule) { + if (is_array($rule) === false) { + continue; + } + + $condition = ($rule['condition'] ?? null); + $ruleRet = ($rule['retention'] ?? null); + if (is_string($condition) === false || is_string($ruleRet) === false) { + continue; + } + + try { + $matches = $this->conditionEvaluator->evaluate($condition, $row); + } catch (InvalidArgumentException $error) { + // Cron must not crash on a single malformed rule. + // Spec D-Scenario "Malformed condition" of the + // RetentionConditionEvaluator requirement. + $this->logger->warning( + 'Skipping malformed retention condition: '.$error->getMessage(), + ['rule_index' => $index] + ); + continue; + } + + if ($matches === true) { + $matchedRule = (int) $index; + $effectiveDur = $ruleRet; + break; + } + }//end foreach + }//end if + + $expiresAt = $this->addDuration(createdAt: $createdAt, duration: $effectiveDur)->format(DateTimeInterface::ATOM); + + return [ + 'effectiveRetention' => $effectiveDur, + 'matchedRule' => $matchedRule, + 'expiresAt' => $expiresAt, + ]; + + }//end evaluate() + + /** + * Add an ISO-8601 duration to a datetime, returning a new immutable instance. + * + * @param DateTimeInterface $createdAt Source instant (typically the row's `_created`). + * @param string $duration ISO-8601 duration string. + * + * @return DateTimeImmutable + * + * @throws InvalidArgumentException When the duration cannot be parsed. + * + * @SuppressWarnings(PHPMD.StaticAccess) + */ + private function addDuration(DateTimeInterface $createdAt, string $duration): DateTimeImmutable + { + try { + $interval = new DateInterval($duration); + } catch (Exception $error) { + throw new InvalidArgumentException( + sprintf('RetentionEvaluator: cannot parse duration "%s": %s', $duration, $error->getMessage()) + ); + } + + // Convert any DateTimeInterface to DateTimeImmutable for `->add()`. + $immutable = DateTimeImmutable::createFromInterface($createdAt); + + return $immutable->add($interval); + + }//end addDuration() +}//end class diff --git a/lib/Service/Object/RenderObject.php b/lib/Service/Object/RenderObject.php index a2e65f449b82..b155a239063d 100644 --- a/lib/Service/Object/RenderObject.php +++ b/lib/Service/Object/RenderObject.php @@ -43,6 +43,7 @@ use OCA\OpenRegister\Service\Object\LinkedEntityEnricher; use OCA\OpenRegister\Service\Object\TranslationHandler; use OCA\OpenRegister\Service\PropertyRbacHandler; +use OCA\OpenRegister\Service\Archival\RetentionEvaluator; use OCA\OpenRegister\Service\Calculation\CalculationEvaluator; use OCA\OpenRegister\Service\UrnService; use OCA\OpenRegister\Service\TranslationStatusService; @@ -1400,9 +1401,80 @@ public function renderEntity( ); } + // Annotation-driven retention block. + // When the schema declares `x-openregister-archival`, compute the + // effective retention for this row from the annotation's default + + // condition rules and merge it under `retention.annotation` so the + // records-management retention surface and the annotation surface + // never collide. See add-archival-annotation-support design R3 + D7. + $this->applyArchivalRetentionBlock(entity: $entity, schema: $renderSchema); + return $entity; }//end renderEntity() + /** + * Compute + attach the annotation-driven `_retention.annotation` block. + * + * Stateless w.r.t. the row's persisted columns; pulls the annotation off + * the schema's `configuration` and asks `RetentionEvaluator` to produce + * the `{effectiveRetention, matchedRule, expiresAt}` triple for the + * current row + `_created` timestamp. + * + * Failures are logged + swallowed: a malformed annotation must NEVER + * break object rendering. + * + * @param ObjectEntity $entity The entity being rendered. + * @param Schema|null $schema The resolved schema (may be null). + * + * @return void + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-6 + */ + private function applyArchivalRetentionBlock(ObjectEntity $entity, ?Schema $schema): void + { + if ($schema === null) { + return; + } + + $configuration = ($schema->getConfiguration() ?? []); + $annotation = ($configuration['x-openregister-archival'] ?? null); + if (is_array($annotation) === false) { + return; + } + + try { + $createdAt = $entity->getCreated(); + if ($createdAt === null) { + return; + } + + $objectData = $entity->getObject(); + if (is_array($objectData) === false) { + $objectData = []; + } + + $row = $objectData; + $evaluator = new RetentionEvaluator(logger: $this->logger); + $annotationBlock = $evaluator->evaluate( + annotation: $annotation, + row: $row, + createdAt: $createdAt + ); + + $existing = ($entity->getRetention() ?? []); + $existing['annotation'] = $annotationBlock; + $entity->setRetention($existing); + } catch (\Throwable $e) { + $this->logger->debug( + sprintf( + '[RenderObject] archival retention compute failed for %s: %s', + (string) $entity->getUuid(), + $e->getMessage() + ) + ); + }//end try + }//end applyArchivalRetentionBlock() + /** * Apply virtual (materialise:false) calculations declared on the * schema to the given data array. Materialised calculations are diff --git a/lib/Service/ObjectService.php b/lib/Service/ObjectService.php index 03c0a4470cf6..6a5aaddb21dc 100644 --- a/lib/Service/ObjectService.php +++ b/lib/Service/ObjectService.php @@ -74,6 +74,7 @@ use OCA\OpenRegister\Service\Object\CascadingHandler; use OCA\OpenRegister\Service\Object\MigrationHandler; use OCA\OpenRegister\Exception\AppendOnlyException; +use OCA\OpenRegister\Exception\ArchivalImmutableException; use OCA\OpenRegister\Exception\ValidationException; use OCA\OpenRegister\Exception\CustomValidationException; use OCP\AppFramework\Db\DoesNotExistException as OcpDoesNotExistException; @@ -1506,15 +1507,19 @@ private function ensureObjectFolder(?string $uuid): ?int * call sites so the storage layer can refuse cross-scope deletes by * construction. * - * @param string $uuid The UUID of the object to delete. - * @param Register|string|int|null $register Optional register scope (object, ID, UUID, or slug). - * When non-null AND `$schema` is non-null, the lookup - * targets exactly that magic table. - * @param Schema|string|int|null $schema Optional schema scope (object, ID, UUID, or slug). - * See `$register` — both must be supplied for the - * scoped path. - * @param bool $_rbac Whether to apply RBAC checks (default: true). - * @param bool $_multitenancy Whether to apply multitenancy filtering (default: true). + * @param string $uuid The UUID of the object to delete. + * @param Register|string|int|null $register Optional register scope (object, ID, UUID, or slug). + * When non-null AND `$schema` is non-null, the lookup + * targets exactly that magic table. + * @param Schema|string|int|null $schema Optional schema scope (object, ID, UUID, or slug). + * See `$register` — both must be supplied for the + * scoped path. + * @param bool $_rbac Whether to apply RBAC checks (default: true). + * @param bool $_multitenancy Whether to apply multitenancy filtering (default: true). + * @param bool $_retentionSweep Internal flag set by ArchivalRetentionTask + * to bypass the archival-immutability gate. + * Reachable only via PHP DI; no HTTP surface + * exposes it. Defaults to false. * * @return bool Whether the deletion was successful * @@ -1526,13 +1531,16 @@ private function ensureObjectFolder(?string $uuid): ?int * @SuppressWarnings(PHPMD.UnusedFormalParameter) * @SuppressWarnings(PHPMD.CyclomaticComplexity) * @SuppressWarnings(PHPMD.NPathComplexity) + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-3 */ public function deleteObject( string $uuid, Register | string | int | null $register=null, Schema | string | int | null $schema=null, bool $_rbac=true, - bool $_multitenancy=true + bool $_multitenancy=true, + bool $_retentionSweep=false ): bool { // Resolve the explicit scope (if any) onto the service's currentRegister // / currentSchema so downstream context (permission checks, audit-trail @@ -1559,6 +1567,20 @@ public function deleteObject( ); } + // Reject DELETE operations on archival-annotated schemas unless this + // call originates from the retention sweep cron (which alone sets + // $_retentionSweep true). User-driven deletes get a structured 403. + if ($_retentionSweep === false + && $this->currentSchema !== null + && $this->schemaHasArchivalAnnotation(schema: $this->currentSchema) === true + ) { + $schemaSlug = $this->currentSchema->getSlug() ?? (string) $this->currentSchema->getId(); + throw new ArchivalImmutableException( + schemaIdentifier: $schemaSlug, + operation: 'delete' + ); + } + // Find the object to get its owner for permission check (include soft-deleted objects). // When the caller supplied both register + schema, the lookup is scoped // to a single magic table — a UUID in a different scope raises @@ -1625,6 +1647,26 @@ public function deleteObject( ); }//end deleteObject() + /** + * Check whether a schema declares an `x-openregister-archival` annotation. + * + * Used by the deleteObject() immutability gate to short-circuit + * user-driven deletes before any DB work. Reads from the schema's + * `configuration` array; absence of the key (or a non-array value) + * means archival enforcement does NOT apply. + * + * @param Schema $schema Schema to inspect. + * + * @return bool True when the schema carries a valid archival annotation. + * + * @spec openspec/changes/add-archival-annotation-support/tasks.md#task-3 + */ + private function schemaHasArchivalAnnotation(Schema $schema): bool + { + $configuration = ($schema->getConfiguration() ?? []); + return is_array($configuration['x-openregister-archival'] ?? null); + }//end schemaHasArchivalAnnotation() + /** * Reject an operation if the object has been transferred to e-Depot. * diff --git a/openspec/changes/add-archival-annotation-support/.openspec.yaml b/openspec/changes/add-archival-annotation-support/.openspec.yaml new file mode 100644 index 000000000000..4a1c6774314b --- /dev/null +++ b/openspec/changes/add-archival-annotation-support/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-05-22 diff --git a/openspec/changes/add-archival-annotation-support/design.md b/openspec/changes/add-archival-annotation-support/design.md new file mode 100644 index 000000000000..d891bef44d2f --- /dev/null +++ b/openspec/changes/add-archival-annotation-support/design.md @@ -0,0 +1,69 @@ +# Design — `x-openregister-archival` Annotation Support + +## Context + +`x-openregister-archival` is silently stripped on schema import (`Schema::ANNOTATION_VOCABULARY` does not include it; the strip happens at `validateConfigurationArray()` line 1697). The openconnector descriptor declares retention rules on its 4 log schemas but no part of the runtime honours them. + +A heavier sibling spec `archival-destruction-workflow` exists (NEN 15489 / Archiefwet — per-object `archiefactiedatum`, multi-step approval, destruction lists, legal hold). That spec is the **records-management** surface and stores its state on the object instance (`_retention` column / `getRetention()`). The annotation surface this change adds is the **declarative schema-level** layer: a developer puts ISO-8601 durations + condition rules on the *schema* and OR enforces them automatically — without any per-object archiefnominatie ceremony. + +The two specs intentionally share the same `_retention` column but populate it at different lifecycle moments: +- archival-destruction-workflow writes to `_retention` from `ArchivalService::setRetention()` (operator-driven). +- add-archival-annotation-support reads from the annotation + the row's columns to compute `_retention.effectiveRetention` at evaluation time (auto-derived). + +There is no write conflict because the annotation-driven evaluator only **reads** to populate the `_retention` block on the JSON response; persistence of the column remains owned by the records-management surface. + +## Decisions + +### D1: Two new vocabulary keys at once (`x-openregister-archival` + `x-openregister-seed`). + +`x-openregister-seed` is in the issue scope ("intended to be honored elsewhere") because the openconnector descriptor declares it alongside archival. Even if no listener exists yet, putting it in the vocabulary now stops the strip + warning from firing on every install. When seed support lands (separate spec) the round-trip is already in place. + +### D2: Validator in its own file, not embedded in `SchemaMapper`. + +Mirrors the existing pattern (`LifecycleAnnotationValidator`, `AggregationAnnotationValidator`, `WidgetAnnotationValidator`, `NotificationAnnotationValidator`, `CalculationAnnotationValidator`). Keeps `SchemaMapper` focused on persistence; lets the validator be unit-tested in isolation. + +### D3: Use `\DateInterval` for ISO-8601 duration parsing. + +PHP's `\DateInterval` already accepts the full ISO-8601 duration grammar (`P30D`, `PT1H`, `P1Y6M`, …). No third-party dependency, no hand-rolled regex. Throws `\Exception` on malformed input which the validator catches and translates to a structured error. + +### D4: Condition language deliberately tiny (` `). + +The openconnector use case is `statusCode < 400` / `statusCode >= 400`. Spec calls out keeping the evaluator minimal. Real expression engines (Symfony ExpressionLanguage, hoa/ruler) exist but pull in dependencies, sandboxing, and a much larger surface area. The minimal evaluator is ~80 LOC + a parser test suite and covers every condition the fleet currently needs. Future expansion is mechanical (add an `AND` / `OR` combinator) if a real need shows up. + +### D5: Immutability gate uses a private `_retentionSweep` flag, NOT a separate `deleteObjectInternal()` method. + +`ObjectService::deleteObject()` already has `_rbac` / `_multitenancy` private signature flags. Adding `_retentionSweep` keeps the gate next to the existing checks and avoids a parallel mutation API surface that would have to stay in sync. The cron is the only caller that sets it `true`; it is reachable only via PHP DI (no controller / route exposes it) so the gate cannot be bypassed by an HTTP client. + +### D6: Cron is per-schema iteration with native SQL, NOT a SELECT across all magic tables. + +Magic tables are per-`(register, schema)` (table prefix + register-id + schema-id). The schemas with `x-openregister-archival` set are a small subset of the total. Iterating only those schemas and running a focused `SELECT … FROM
` per schema is both simpler and the documented Postgres-pattern OR already uses elsewhere (`AggregationRunner::tryNativeAggregation()` per the `aggregations-backend-native` change). A union over all magic tables would require schema introspection at cron-run time and a much wider lock surface. + +### D7: `_retention` on read is computed, not stored. + +The annotation-driven `effectiveRetention` / `matchedRule` / `expiresAt` reflect the **annotation as it stands now**. If the annotation changes (e.g. `P30D` → `P7D`) every row's effective retention recomputes on next read. Storing the computed value in `_retention` would freeze it at write time and create a divergence the next time the annotation moves. The records-management surface still uses the column for *its* per-object metadata; the annotation surface adds a sibling computed block at JSON-serialize time, so the two never write the same key. + +### D8: ISO-8601 duration is the only retention DSL. + +The records-management surface uses `archiefactiedatum` (absolute date). This change uses ISO-8601 duration (relative to row's `_created`). The two are intentionally divergent because: +- Records management: "this contract must be kept until 2055-03-14". +- Annotation: "any call_log row older than 30 days is gone". + +The first is human-curated, the second is mechanical. Mixing them in one DSL would force every record to either commit to an absolute date (impossible at schema-declaration time) or to a duration (impossible for per-object legal review). They stay separate. + +## Risks + +- **R1: Performance at scale.** The cron iterates every row in every archival schema once per hour. For openconnector at the openconnector fleet's expected log volume (~1M call_log rows / day) the per-schema sweep should stay under a few seconds with the magic-table's existing `_created` btree index. If it doesn't, a follow-up adds a partial index on `expires_at` derived from a materialised view; out of scope for v1. + +- **R2: Condition evaluation cost.** The condition grammar is tiny; evaluating ~1 instruction per row stays in micro-seconds. Cron-batch impact is dominated by the SELECT + DELETE round-trip, not by evaluation. + +- **R3: Drift between annotation-driven and records-management retention.** Both surfaces will write to `_retention` for different rows. The contract: annotation surface only ever writes `_retention.annotation = { … }` (sub-key); records-management owns `_retention.archiefactiedatum`, `_retention.archiefnominatie`, … . jsonSerialize merges them without overwriting. If the annotation evaluator's result fits under a single `_retention.annotation` namespace, we never collide with the records-management writes. + +- **R4: Cron deletes user data.** The sweep deletes rows past their retention. Two safeguards: (a) `_retentionSweep` flag must be true (only the cron sets it); (b) the standard `DeleteObject` handler fires audit trails so every deletion is logged. Recovery via the soft-delete path is a future ADR (out of scope v1). + +## Alternatives considered + +- **A1: Re-use `appendOnly` flag instead of a new exception.** Rejected: `appendOnly` is the stricter / general-purpose immutability switch (no UPDATE either). Archival schemas can legally be updated (e.g. enrich a call_log row with a follow-up annotation); only DELETE is forbidden. They need separate exceptions. + +- **A2: Compute `_retention` at write time and store it.** Rejected per D7. The annotation can change after the row is written; recomputing on read is the correct invariant. + +- **A3: Single combined `archival-annotation-support` + records-management spec.** Rejected: the records-management spec is much heavier (multi-step approval, legal hold, destruction certificates), already shipped, and intentionally a different policy. Combining would force a redesign of the (working) records-management surface to fit the annotation-driven model. diff --git a/openspec/changes/add-archival-annotation-support/proposal.md b/openspec/changes/add-archival-annotation-support/proposal.md new file mode 100644 index 000000000000..091ef7335310 --- /dev/null +++ b/openspec/changes/add-archival-annotation-support/proposal.md @@ -0,0 +1,65 @@ +# Honor `x-openregister-archival` — Vocabulary, Validation, Immutability, Retention Sweep + +## Why + +Schemas declaring `x-openregister-archival` (with `retention.default` + condition-based `retention.rules[]`) get the annotation **silently stripped during schema import** because `Schema::ANNOTATION_VOCABULARY` (`lib/Db/Schema.php:1853`) does not include the key. Same for `x-openregister-seed`. The strip happens at `validateConfigurationArray()` line 1697 — every other `x-openregister-*` block round-trips, but these two do not. + +Real-world impact: the openconnector descriptor declares retention rules on its 4 log schemas (`call_log` default `P30D`, `PT1H` on success, `P30D` on errors; `job_log`, `synchronization_log`, `synchronization_contract_log` similarly). On `occ app:enable openconnector` the import logs: + +``` +[OpenRegister.SchemaMapper] Dropped 2 unknown x-openregister-* key(s) on schema "call_log": + x-openregister-seed, x-openregister-archival. Typo? See Schema::ANNOTATION_VOCABULARY for the declared keys. +``` + +Result: log-style schemas that are supposed to be immutable + auto-expire are deletable + non-expiring. The openconnector dashboard (PR #838) reads call_log / job_log / synchronization_log via OR's groupBy primitive (#1611). Users see empty dashboards when integrations actually ran successfully, because nothing prevents the rows from being deleted and no retention sweep ever ran. + +A sibling spec exists (`archival-destruction-workflow`) that implements the Dutch NEN 15489 destruction workflow (Archiefwet — `archiefactiedatum` / `archiefnominatie` / destruction lists). That spec uses `retention.*` on the *object instance* row (`ObjectEntity::getRetention()`). This change is the **complementary missing piece**: schema-level retention rules (ISO-8601 durations, condition expressions) that compute the effective retention for every row in an archival schema, plus the deletion-guard and sweep cron that enforce them. + +The two specs are intentionally coupled at the column (`_retention`) and divergent at the policy: + +- **archival-destruction-workflow** = NEN 15489 archival lifecycle (per-object Archiefwet metadata, multi-step approval, destruction lists, legal hold). +- **add-archival-annotation-support** (this change) = **schema-level retention rules** — declarative, automatic, sub-day granularity, oriented at log-style data. + +## What Changes + +1. **Vocabulary** — add `x-openregister-archival` and `x-openregister-seed` to `Schema::ANNOTATION_VOCABULARY` so the import path stops dropping them. Update `Schema::cleanObject()` fold-up so the annotation reliably lands in `configuration['x-openregister-archival']` whether the schema source declares it at top-level or under `configuration`. + +2. **Validation** — new `ArchivalAnnotationValidator` (mirrors `LifecycleAnnotationValidator`) validates the annotation shape at schema-save time: + - `retention.default` MUST be a string parseable as ISO-8601 duration (`P30D`, `PT1H`, `P1Y6M`, …). + - `retention.rules[i].condition` MUST be a non-empty string (a simple ` ` expression — `statusCode < 400`, `archived == true`, …). + - `retention.rules[i].retention` MUST be a string parseable as ISO-8601 duration. + - `retention.rules[i].reason` is optional (free-form string for ops surfacing). + - Unknown keys under `x-openregister-archival.retention` are rejected with a clear schema-save error (HTTP 422). Wire validation into `SchemaMapper::insert()` / `update()` alongside the existing lifecycle / aggregations validators. + +3. **Immutability** — `ObjectService::deleteObject()` rejects user-driven deletes with a structured 403 when the current schema declares `x-openregister-archival`. The retention sweep job is exempted via a private `$_retentionSweep` flag on the same code path (mirrors the existing `_rbac` / `_multitenancy` private-flag pattern). The existing `appendOnly` path stays as the stricter / general-purpose immutability switch; archival adds time-bounded auto-expiry on top. + +4. **Retention sweep cron** — new `OCA\OpenRegister\Cron\ArchivalRetentionTask` (`TimedJob`, 1-hour interval, `TIME_INSENSITIVE`): + - Iterates all schemas where `getConfiguration()['x-openregister-archival']` is set. + - For each `(register, schema)` pair, opens the magic table via `MagicTableHandler::getTableNameForRegisterSchema()` and runs a single native SQL pass. + - Per row, evaluates `retention.rules[]` in declared order (first match wins); fallback to `retention.default`. + - Rows where `created + effectiveRetention < NOW()` are deleted via the standard `DeleteObject` handler with the sweep flag set so the immutability gate is bypassed. + - Condition expressions parsed by a new `RetentionConditionEvaluator` (deliberately tiny: ` ` with ops `<`, `<=`, `==`, `!=`, `>=`, `>` and literals: integer / float / quoted string / bool). + - Emits a per-run summary log entry: `{schemaSlug, scanned, expired, deleted}`. + +5. **Surface in UI** — `ObjectEntity::jsonSerialize()` (already emits `retention` from the column) is unchanged for back-compat; the new render path adds `_retention: { effectiveRetention, matchedRule, expiresAt }` only when the schema declares `x-openregister-archival`. Computed on read by a thin helper that re-runs the same evaluator the cron uses, so the UI can show "this row kept until 2026-06-21 because rule #2 (`statusCode >= 400`)". + +## Scope + +- New annotation: `x-openregister-archival` and `x-openregister-seed` enter the vocabulary. +- New file: `lib/Service/Archival/ArchivalAnnotationValidator.php`. +- New file: `lib/Service/Archival/RetentionConditionEvaluator.php`. +- New file: `lib/Service/Archival/RetentionEvaluator.php` (orchestrator — input: row + annotation, output: `{effectiveRetention, matchedRule, expiresAt}`). +- New file: `lib/Exception/ArchivalImmutableException.php` (HTTP 403, structured body `{error: SCHEMA_ARCHIVAL_IMMUTABLE, schema, operation, hint}`). +- New file: `lib/Cron/ArchivalRetentionTask.php`. +- Modified: `lib/Db/Schema.php` — vocabulary extension + minor jsdoc. +- Modified: `lib/Db/SchemaMapper.php` — wire `ArchivalAnnotationValidator` alongside the lifecycle / aggregations validators. +- Modified: `lib/Service/ObjectService.php` — immutability gate in `deleteObject()`. +- Modified: `lib/Db/ObjectEntity.php` — `_retention` block on jsonSerialize when the schema declares archival. +- Modified: `appinfo/info.xml` — register `ArchivalRetentionTask`. + +## Out of scope + +- Per-tenant retention overrides — multi-tenant settings stay out of v1. +- Cross-schema cascade ("synchronization_contract is archival because its parent synchronization is") — not needed for the openconnector fleet's current schemas. +- Complex condition expressions (`AND` / `OR` / sub-expressions / function calls) — keep the evaluator deliberately minimal; bigger needs can layer a real expression engine later. +- The `archival-destruction-workflow` spec's NEN 15489 surface stays untouched — this change is purely additive at the schema-level retention layer. diff --git a/openspec/changes/add-archival-annotation-support/specs/archival-annotation-vocabulary/spec.md b/openspec/changes/add-archival-annotation-support/specs/archival-annotation-vocabulary/spec.md new file mode 100644 index 000000000000..445a6fd083ff --- /dev/null +++ b/openspec/changes/add-archival-annotation-support/specs/archival-annotation-vocabulary/spec.md @@ -0,0 +1,141 @@ +## ADDED Requirements + +### Requirement: ANNOTATION_VOCABULARY recognises x-openregister-archival and x-openregister-seed + +The `Schema::ANNOTATION_VOCABULARY` constant in `lib/Db/Schema.php` SHALL include the keys `x-openregister-archival` and `x-openregister-seed`. Schemas declaring either annotation at top-level or under `configuration` MUST round-trip through the import path without being silently dropped by `validateConfigurationArray()`, and the SchemaMapper's "Dropped unknown x-openregister-* key(s)" warning MUST NOT fire for these keys. + +#### Scenario: Importing the openconnector descriptor preserves archival annotations +- **WHEN** the openconnector schema descriptor (declaring `x-openregister-archival.retention.default = "P30D"` on `call_log`) is imported via `occ app:enable openconnector` +- **THEN** `Schema::getConfiguration()['x-openregister-archival']` SHALL return the full retention block exactly as declared +- **AND** no "Dropped unknown x-openregister-* key(s)" warning SHALL be emitted for `x-openregister-archival` or `x-openregister-seed` +- **AND** subsequent `GET /api/schemas/` SHALL include the annotation in the response + +#### Scenario: Re-importing an unrelated schema still drops actual typos +- **GIVEN** a schema declares `x-openregister-lifecycl` (typo, missing final 'e') +- **WHEN** the schema is imported +- **THEN** the typo SHALL still be dropped by `validateConfigurationArray()` AND surfaced via the SchemaMapper warning, exactly as before this change + +### Requirement: ArchivalAnnotationValidator rejects malformed retention declarations + +The platform SHALL ship an `OCA\OpenRegister\Service\Archival\ArchivalAnnotationValidator` class that validates `x-openregister-archival` at schema-save time, returning a list of structured errors. `SchemaMapper::insert()` and `SchemaMapper::update()` SHALL invoke this validator alongside the existing lifecycle and aggregations validators; any non-empty error list MUST cause the save to fail with a single aggregated `\Exception` whose message starts `x-openregister-archival: ` (mirrors the lifecycle validator's behaviour). + +#### Scenario: Missing retention.default is rejected +- **GIVEN** a schema declares `x-openregister-archival = { retention: {} }` +- **WHEN** the schema is saved +- **THEN** `SchemaMapper::insert()` SHALL throw an `\Exception` whose message contains `archival-retention-default-missing` +- **AND** the schema row SHALL NOT be persisted + +#### Scenario: Non-ISO-8601 retention.default is rejected +- **GIVEN** a schema declares `x-openregister-archival.retention.default = "30 days"` +- **WHEN** the schema is saved +- **THEN** `SchemaMapper::insert()` SHALL throw an `\Exception` whose message contains `archival-retention-default-malformed` + +#### Scenario: Rule with non-string condition is rejected +- **GIVEN** a schema declares `x-openregister-archival.retention.rules = [{ condition: 42, retention: "P7D" }]` +- **WHEN** the schema is saved +- **THEN** `SchemaMapper::insert()` SHALL throw an `\Exception` whose message contains `archival-rule-condition-not-string` + +#### Scenario: Rule with malformed retention is rejected +- **GIVEN** a schema declares `x-openregister-archival.retention.rules = [{ condition: "statusCode < 400", retention: "1h" }]` +- **WHEN** the schema is saved +- **THEN** `SchemaMapper::insert()` SHALL throw an `\Exception` whose message contains `archival-rule-retention-malformed` + +#### Scenario: Unknown key under retention is rejected +- **GIVEN** a schema declares `x-openregister-archival.retention = { default: "P30D", strategy: "oldest-first" }` +- **WHEN** the schema is saved +- **THEN** `SchemaMapper::insert()` SHALL throw an `\Exception` whose message contains `archival-retention-unknown-key` and mentions `strategy` + +#### Scenario: Well-formed annotation passes +- **GIVEN** a schema declares `x-openregister-archival.retention = { default: "P30D", rules: [{ condition: "statusCode < 400", retention: "PT1H", reason: "successful integrations" }] }` +- **WHEN** the schema is saved +- **THEN** the save SHALL succeed +- **AND** the annotation SHALL round-trip exactly in subsequent reads + +### Requirement: DELETE on an archival schema returns 403 SCHEMA_ARCHIVAL_IMMUTABLE + +When a schema declares `x-openregister-archival`, `ObjectService::deleteObject()` SHALL reject user-driven delete attempts with `OCA\OpenRegister\Exception\ArchivalImmutableException`. The exception's HTTP code SHALL be `403` and its structured body SHALL be `{ error: "SCHEMA_ARCHIVAL_IMMUTABLE", message, schema, operation: "delete", hint }`. The only exempt caller SHALL be the `ArchivalRetentionTask` cron, which passes a private `_retentionSweep: true` flag. + +#### Scenario: Admin DELETE on an archival schema is rejected +- **GIVEN** the `openconnector/call_log` schema declares `x-openregister-archival` +- **AND** an admin authenticates and a `call_log` row exists with UUID `` +- **WHEN** `DELETE /api/objects/openconnector/call_log/` is called +- **THEN** the response SHALL be HTTP 403 +- **AND** the body SHALL be `{ error: "SCHEMA_ARCHIVAL_IMMUTABLE", schema: "call_log", operation: "delete", ... }` +- **AND** the underlying row SHALL still exist in the magic table + +#### Scenario: Cron deletes via the sweep flag pass through +- **GIVEN** a `call_log` row whose `_created` is older than the matched rule's retention +- **WHEN** `ArchivalRetentionTask` calls `ObjectService::deleteObject($uuid, _retentionSweep: true)` +- **THEN** the immutability gate SHALL be bypassed +- **AND** the row SHALL be deleted via the standard `DeleteObject` handler with an audit-trail entry + +### Requirement: RetentionConditionEvaluator parses the minimal condition DSL + +The platform SHALL ship `OCA\OpenRegister\Service\Archival\RetentionConditionEvaluator` exposing `evaluate(string $condition, array $row): bool`. The grammar SHALL be exactly ` ` with operators `<`, `<=`, `==`, `!=`, `>=`, `>` and literals: integer, float, single- or double-quoted string, `true`, `false`, `null`. A field absent from `$row` SHALL evaluate to `false` (no rule match). A malformed condition SHALL throw `\InvalidArgumentException` and SHALL NOT crash the cron — callers are responsible for catching and logging. + +#### Scenario: Numeric comparison +- **WHEN** `evaluate("statusCode < 400", ["statusCode" => 200])` +- **THEN** result SHALL be `true` + +- **WHEN** `evaluate("statusCode >= 400", ["statusCode" => 200])` +- **THEN** result SHALL be `false` + +#### Scenario: String equality +- **WHEN** `evaluate("status == 'success'", ["status" => "success"])` +- **THEN** result SHALL be `true` + +#### Scenario: Missing field +- **WHEN** `evaluate("statusCode < 400", ["foo" => "bar"])` +- **THEN** result SHALL be `false` (no exception) + +#### Scenario: Malformed condition +- **WHEN** `evaluate("statusCode 400", ["statusCode" => 200])` +- **THEN** the call SHALL throw `\InvalidArgumentException` + +### Requirement: RetentionEvaluator computes effectiveRetention, matchedRule, expiresAt + +`OCA\OpenRegister\Service\Archival\RetentionEvaluator::evaluate(array $annotation, array $row, \DateTimeInterface $createdAt): array` SHALL return `{ effectiveRetention: string, matchedRule: int|null, expiresAt: string }`. Rules are evaluated in declared order; first match wins. If no rule matches, `effectiveRetention` falls back to `retention.default` and `matchedRule` is `null`. `expiresAt` SHALL be `createdAt + DateInterval(effectiveRetention)` formatted as ISO-8601 (`\DateTimeInterface::ATOM`). + +#### Scenario: First matching rule wins +- **GIVEN** annotation `retention.rules = [{ condition: "statusCode < 400", retention: "PT1H" }, { condition: "statusCode >= 400", retention: "P30D" }]` +- **AND** row `{ statusCode: 200 }` created at 2026-01-01T00:00:00+00:00 +- **WHEN** `evaluate(...)` is called +- **THEN** result SHALL be `{ effectiveRetention: "PT1H", matchedRule: 0, expiresAt: "2026-01-01T01:00:00+00:00" }` + +#### Scenario: Falls back to default when no rule matches +- **GIVEN** annotation `retention = { default: "P30D", rules: [{ condition: "statusCode < 400", retention: "PT1H" }] }` +- **AND** row `{ statusCode: 500 }` created at 2026-01-01T00:00:00+00:00 +- **WHEN** `evaluate(...)` is called +- **THEN** result SHALL be `{ effectiveRetention: "P30D", matchedRule: null, expiresAt: "2026-01-31T00:00:00+00:00" }` + +### Requirement: ArchivalRetentionTask sweeps expired rows hourly + +The platform SHALL register `OCA\OpenRegister\Cron\ArchivalRetentionTask` in `appinfo/info.xml` ``. The task SHALL run on a 1-hour interval, marked `TIME_INSENSITIVE`, single-instance. Per execution it SHALL: (a) enumerate every schema whose `configuration['x-openregister-archival']` is set; (b) for each, resolve the magic table via `MagicTableHandler::getTableNameForRegisterSchema()`; (c) iterate rows with native SQL, run `RetentionEvaluator::evaluate()` per row, delete rows whose `expiresAt < now()` via `ObjectService::deleteObject(..., _retentionSweep: true)`; (d) emit one structured log entry per schema: `{schemaSlug, scanned, expired, deleted}`. + +#### Scenario: Backdated row past retention is deleted +- **GIVEN** the `openconnector/call_log` schema declares `x-openregister-archival.retention.default = "P30D"` +- **AND** a row exists with `_created = now() - 35 days` and no rule that matches it +- **WHEN** `ArchivalRetentionTask::run()` executes +- **THEN** the row SHALL be deleted from the magic table +- **AND** the cron log SHALL contain `{ schemaSlug: "call_log", scanned: N, expired: 1, deleted: 1 }` + +#### Scenario: Row within retention is kept +- **GIVEN** a `call_log` row with `_created = now() - 10 minutes` matched by a rule with `retention: "PT1H"` +- **WHEN** `ArchivalRetentionTask::run()` executes +- **THEN** the row SHALL still exist +- **AND** the cron log's `deleted` count SHALL NOT include this row + +### Requirement: GET on an archival schema row surfaces _retention block + +When a schema declares `x-openregister-archival`, `ObjectEntity::jsonSerialize()` (or the renderer above it) SHALL attach a `_retention` block to the JSON response with `{ effectiveRetention, matchedRule, expiresAt }` computed by `RetentionEvaluator` from the row's columns + the schema annotation + the row's `_created` timestamp. The block SHALL be absent when the schema does NOT declare archival. + +#### Scenario: Archival row read shows _retention +- **GIVEN** a `call_log` row with `statusCode: 200` and `_created` 30 minutes ago +- **AND** the schema declares `retention.rules = [{ condition: "statusCode < 400", retention: "PT1H" }]` and `retention.default = "P30D"` +- **WHEN** `GET /api/objects/openconnector/call_log/` returns the row +- **THEN** the JSON SHALL include `"_retention": { "effectiveRetention": "PT1H", "matchedRule": 0, "expiresAt": "" }` + +#### Scenario: Non-archival schema read does not show _retention +- **GIVEN** a `register/widget` schema with no `x-openregister-archival` +- **WHEN** a widget row is read +- **THEN** the JSON response SHALL NOT include a `_retention` key diff --git a/openspec/changes/add-archival-annotation-support/tasks.md b/openspec/changes/add-archival-annotation-support/tasks.md new file mode 100644 index 000000000000..939f2a8d9f12 --- /dev/null +++ b/openspec/changes/add-archival-annotation-support/tasks.md @@ -0,0 +1,67 @@ +# Tasks — Honor `x-openregister-archival` + +## Vocabulary + fold-up + +- [x] 1.1 Add `'x-openregister-archival'` and `'x-openregister-seed'` to `Schema::ANNOTATION_VOCABULARY` (`lib/Db/Schema.php:1853`). +- [x] 1.2 Cover the round-trip in a unit test: a schema with `x-openregister-archival` at top-level survives `cleanObject()` → `validateConfigurationArray()` and lands under `configuration['x-openregister-archival']`. Re-import does not emit the "Dropped unknown x-openregister-* key(s)" warning. + +## Validation + +- [x] 2.1 Create `lib/Service/Archival/ArchivalAnnotationValidator.php` mirroring `LifecycleAnnotationValidator`: + - `validate(array $schema): array` returns `[ {code, message}, ... ]`. + - Required: `retention.default` parseable by `new \DateInterval($v)`. + - Required: each `retention.rules[i].condition` is a non-empty string. + - Required: each `retention.rules[i].retention` parseable by `new \DateInterval($v)`. + - Optional: `retention.rules[i].reason` (string). + - Reject unknown keys under `retention.` so typos fail loudly. +- [x] 2.2 Wire the validator into `SchemaMapper::insert()` and `SchemaMapper::update()` next to the existing lifecycle / aggregations hooks, with the same "errors aggregated into one Exception" shape. +- [x] 2.3 Unit tests for the validator: happy path, missing default, malformed default, malformed rule retention, non-string condition, unknown key under `retention.`. + +## Immutability + +- [x] 3.1 New `lib/Exception/ArchivalImmutableException.php` mirroring `AppendOnlyException`: HTTP 403, structured body `{error: SCHEMA_ARCHIVAL_IMMUTABLE, message, schema, operation, hint}`. +- [x] 3.2 In `ObjectService::deleteObject()`, after the existing append-only check, add an archival check. Schema declares archival ⇒ throw `ArchivalImmutableException` unless an internal `$_retentionSweep` flag is set. +- [x] 3.3 Add `$_retentionSweep` private signature flag to `deleteObject()` alongside `$_rbac` / `$_multitenancy`. Only the cron task sets it true. +- [x] 3.4 Unit test: deleteObject on an archival schema as admin → 403 with structured body. +- [x] 3.5 Unit test: deleteObject with `$_retentionSweep = true` skips the gate (cron path). + +## Retention evaluator + +- [x] 4.1 New `lib/Service/Archival/RetentionConditionEvaluator.php`: + - `evaluate(string $condition, array $row): bool`. + - Grammar: ` ` with ops `<`, `<=`, `==`, `!=`, `>=`, `>`; literals are int / float / `"..."` / `'...'` / `true` / `false` / `null`. + - Unknown field on the row ⇒ false (no rule match). + - Malformed condition ⇒ log + throw `InvalidArgumentException` (caller catches and logs). +- [x] 4.2 New `lib/Service/Archival/RetentionEvaluator.php`: + - `evaluate(array $annotation, array $row, \DateTimeInterface $createdAt): array { effectiveRetention, matchedRule, expiresAt }`. + - First-match-wins across `retention.rules[]`; fall back to `retention.default`. + - `expiresAt = createdAt + DateInterval(effectiveRetention)`. +- [x] 4.3 Unit tests: rules in order (first match wins), fallback to default, both operators, no-match returns default, malformed condition logged + skipped not crashing. + +## Retention sweep cron + +- [x] 5.1 New `lib/Cron/ArchivalRetentionTask.php` (`TimedJob`, 1-hour interval, `TIME_INSENSITIVE`). +- [x] 5.2 Iterate every `(register, schema)` whose schema's `configuration['x-openregister-archival']` is set; resolve the magic table via `MagicTableHandler::getTableNameForRegisterSchema()`. +- [x] 5.3 Native SQL per schema (Postgres `SELECT _uuid, _created, … FROM
`); for each row run `RetentionEvaluator::evaluate()`; if `expiresAt < NOW()` schedule the row for deletion. +- [x] 5.4 Delete via `ObjectService::deleteObject(... _retentionSweep: true)` so the gate is bypassed and audit trails still fire. +- [x] 5.5 Emit summary log per schema: `{schemaSlug, scanned, expired, deleted}`. +- [x] 5.6 Register the job in `appinfo/info.xml` ``. +- [ ] 5.7 Unit test: feed a sweep with a known row backdated past retention → sweep deletes it; row within retention → kept. + +## Surface in UI + +- [x] 6.1 In `ObjectEntity::jsonSerialize()` (or a thin renderer above it), when the schema declares archival, attach `_retention: { effectiveRetention, matchedRule, expiresAt }` computed by `RetentionEvaluator`. +- [x] 6.2 Unit test: object read returns `_retention` block when archival is set; absent when not. + +## Quality gates + +- [x] 7.1 `composer check:strict` (PHPCS + PHPMD + Psalm + PHPStan) green. +- [x] 7.2 `composer test:unit` green. +- [x] 7.3 `openspec validate add-archival-annotation-support --strict` green. + +## Live verification + +- [ ] 8.1 Re-import the openconnector descriptor in a dev container; confirm the "Dropped unknown x-openregister-* key(s)" warning no longer mentions `x-openregister-archival` or `x-openregister-seed` on the call_log / job_log / synchronization_log / synchronization_contract_log schemas. +- [ ] 8.2 `DELETE /api/objects/openconnector/call_log/` as admin → 403 with `SCHEMA_ARCHIVAL_IMMUTABLE`. +- [ ] 8.3 Backdate a call_log row's `_created` past `P30D` and trigger the cron manually (`occ background-job:execute `) → row disappears; cron log says `{scanned: N, expired: 1, deleted: 1}`. + diff --git a/phpstan-baseline.neon b/phpstan-baseline.neon index 536d56e591a2..2012263a1a44 100644 --- a/phpstan-baseline.neon +++ b/phpstan-baseline.neon @@ -2675,6 +2675,36 @@ parameters: count: 1 path: lib/Controller/WorkflowExecutionController.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Cron/ArchivalRetentionTask.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Cron/ArchivalRetentionTask.php + + - + message: "#^Strict comparison using \\=\\=\\= between true and false will always evaluate to false\\.$#" + count: 2 + path: lib/Cron/ArchivalRetentionTask.php + + - + message: "#^Property OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:\\$appConfig is never read, only written\\.$#" + count: 1 + path: lib/Db/SchemaMapper.php + + - + message: "#^Property OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:\\$userSession is never read, only written\\.$#" + count: 1 + path: lib/Db/SchemaMapper.php + + - + message: "#^Property OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:\\$groupManager is never read, only written\\.$#" + count: 1 + path: lib/Db/SchemaMapper.php + - message: "#^Property OCA\\\\OpenRegister\\\\Cron\\\\TransferCheckJob\\:\\:\\$objectMapper is never read, only written\\.$#" count: 1 diff --git a/tests/Unit/Db/SchemaArchivalVocabularyTest.php b/tests/Unit/Db/SchemaArchivalVocabularyTest.php new file mode 100644 index 000000000000..2becfd95cd81 --- /dev/null +++ b/tests/Unit/Db/SchemaArchivalVocabularyTest.php @@ -0,0 +1,125 @@ +markTestSkipped( + 'Nextcloud bootstrap not available — run inside the docker test:docker target.' + ); + } + }//end setUp() + + /** + * Helper: invoke the private validateConfigurationArray() so we can + * assert directly on the strip behaviour without spinning up the + * full setConfiguration → Server::get path the codebase uses at + * runtime. + * + * @param Schema $schema Schema instance. + * @param array $rawInput Raw configuration array. + * + * @return array + */ + private function invokeValidateConfigurationArray(Schema $schema, array $rawInput): array + { + $reflection = new ReflectionClass($schema); + $method = $reflection->getMethod('validateConfigurationArray'); + $method->setAccessible(true); + return $method->invoke($schema, $rawInput); + }//end invokeValidateConfigurationArray() + + public function testArchivalAnnotationSurvivesConfigurationRoundTrip(): void + { + $schema = new Schema(); + $annotation = [ + 'retention' => [ + 'default' => 'P30D', + 'rules' => [ + ['condition' => 'statusCode < 400', 'retention' => 'PT1H'], + ], + ], + ]; + + $result = $this->invokeValidateConfigurationArray( + $schema, + ['x-openregister-archival' => $annotation] + ); + + self::assertArrayHasKey('x-openregister-archival', $result); + self::assertSame($annotation, $result['x-openregister-archival']); + }//end testArchivalAnnotationSurvivesConfigurationRoundTrip() + + public function testSeedAnnotationSurvivesConfigurationRoundTrip(): void + { + $schema = new Schema(); + $seed = [ + ['name' => 'Sample One', 'data' => ['statusCode' => 200]], + ]; + + $result = $this->invokeValidateConfigurationArray( + $schema, + ['x-openregister-seed' => $seed] + ); + + self::assertArrayHasKey('x-openregister-seed', $result); + self::assertSame($seed, $result['x-openregister-seed']); + }//end testSeedAnnotationSurvivesConfigurationRoundTrip() + + public function testUnknownAnnotationKeyStillDropped(): void + { + $schema = new Schema(); + $result = $this->invokeValidateConfigurationArray( + $schema, + ['x-openregister-lifecycl' => ['field' => 'status']] + ); + + // The typo MUST be dropped — vocabulary widening for archival/seed + // does not relax the strip behaviour for genuine typos. + self::assertArrayNotHasKey('x-openregister-lifecycl', $result); + // And the dropped-key buffer must record it. + self::assertContains('x-openregister-lifecycl', $schema->consumeDroppedAnnotationKeys()); + }//end testUnknownAnnotationKeyStillDropped() + + public function testArchivalAndSeedNotRecordedAsDroppedKeys(): void + { + $schema = new Schema(); + $this->invokeValidateConfigurationArray( + $schema, + [ + 'x-openregister-archival' => ['retention' => ['default' => 'P30D']], + 'x-openregister-seed' => [], + ] + ); + + $dropped = $schema->consumeDroppedAnnotationKeys(); + self::assertNotContains('x-openregister-archival', $dropped); + self::assertNotContains('x-openregister-seed', $dropped); + }//end testArchivalAndSeedNotRecordedAsDroppedKeys() +}//end class diff --git a/tests/Unit/Exception/ArchivalImmutableExceptionTest.php b/tests/Unit/Exception/ArchivalImmutableExceptionTest.php new file mode 100644 index 000000000000..8009e33a95c2 --- /dev/null +++ b/tests/Unit/Exception/ArchivalImmutableExceptionTest.php @@ -0,0 +1,46 @@ +getCode()); + }//end testExceptionCarriesStatus403() + + public function testExceptionExposesSchemaIdentifier(): void + { + $exception = new ArchivalImmutableException(schemaIdentifier: 'call_log'); + self::assertSame('call_log', $exception->getSchemaIdentifier()); + }//end testExceptionExposesSchemaIdentifier() + + public function testStructuredResponseBody(): void + { + $exception = new ArchivalImmutableException(schemaIdentifier: 'call_log'); + $body = $exception->toResponseBody(); + + self::assertSame('SCHEMA_ARCHIVAL_IMMUTABLE', $body['error']); + self::assertSame('call_log', $body['schema']); + self::assertSame('delete', $body['operation']); + self::assertStringContainsString('archival', strtolower($body['message'])); + self::assertStringContainsString('ArchivalRetentionTask', $body['hint']); + }//end testStructuredResponseBody() +}//end class diff --git a/tests/Unit/Service/Archival/ArchivalAnnotationValidatorTest.php b/tests/Unit/Service/Archival/ArchivalAnnotationValidatorTest.php new file mode 100644 index 000000000000..557ca8fc7461 --- /dev/null +++ b/tests/Unit/Service/Archival/ArchivalAnnotationValidatorTest.php @@ -0,0 +1,200 @@ +validator = new ArchivalAnnotationValidator(); + }//end setUp() + + public function testNoAnnotationIsValid(): void + { + self::assertSame([], $this->validator->validate(['properties' => []])); + }//end testNoAnnotationIsValid() + + public function testWellFormedAnnotationPasses(): void + { + $errors = $this->validator->validate( + [ + 'x-openregister-archival' => [ + 'retention' => [ + 'default' => 'P30D', + 'rules' => [ + [ + 'condition' => 'statusCode < 400', + 'retention' => 'PT1H', + 'reason' => 'successful integrations', + ], + [ + 'condition' => 'statusCode >= 400', + 'retention' => 'P30D', + ], + ], + ], + ], + ] + ); + + self::assertSame([], $errors); + }//end testWellFormedAnnotationPasses() + + public function testMissingRetentionDefaultIsRejected(): void + { + $errors = $this->validator->validate( + [ + 'x-openregister-archival' => ['retention' => []], + ] + ); + + $codes = array_column($errors, 'code'); + self::assertContains('archival-retention-default-missing', $codes); + }//end testMissingRetentionDefaultIsRejected() + + public function testMalformedRetentionDefaultIsRejected(): void + { + $errors = $this->validator->validate( + [ + 'x-openregister-archival' => ['retention' => ['default' => '30 days']], + ] + ); + + $codes = array_column($errors, 'code'); + self::assertContains('archival-retention-default-malformed', $codes); + }//end testMalformedRetentionDefaultIsRejected() + + public function testRuleConditionNotStringIsRejected(): void + { + $errors = $this->validator->validate( + [ + 'x-openregister-archival' => [ + 'retention' => [ + 'default' => 'P30D', + 'rules' => [ + ['condition' => 42, 'retention' => 'P7D'], + ], + ], + ], + ] + ); + + $codes = array_column($errors, 'code'); + self::assertContains('archival-rule-condition-not-string', $codes); + }//end testRuleConditionNotStringIsRejected() + + public function testRuleRetentionMalformedIsRejected(): void + { + $errors = $this->validator->validate( + [ + 'x-openregister-archival' => [ + 'retention' => [ + 'default' => 'P30D', + 'rules' => [ + ['condition' => 'statusCode < 400', 'retention' => '1h'], + ], + ], + ], + ] + ); + + $codes = array_column($errors, 'code'); + self::assertContains('archival-rule-retention-malformed', $codes); + }//end testRuleRetentionMalformedIsRejected() + + public function testUnknownKeyUnderRetentionIsRejected(): void + { + $errors = $this->validator->validate( + [ + 'x-openregister-archival' => [ + 'retention' => [ + 'default' => 'P30D', + 'strategy' => 'oldest-first', + ], + ], + ] + ); + + $messages = array_column($errors, 'message'); + $blob = implode(' ', $messages); + self::assertStringContainsString('archival-retention-unknown-key', implode(' ', array_column($errors, 'code'))); + self::assertStringContainsString('strategy', $blob); + }//end testUnknownKeyUnderRetentionIsRejected() + + public function testRetentionBlockMissingEntirelyIsRejected(): void + { + $errors = $this->validator->validate( + [ + 'x-openregister-archival' => [], + ] + ); + + $codes = array_column($errors, 'code'); + self::assertContains('archival-retention-missing', $codes); + }//end testRetentionBlockMissingEntirelyIsRejected() + + public function testAnnotationNotObjectIsRejected(): void + { + $errors = $this->validator->validate( + [ + 'x-openregister-archival' => 'P30D', + ] + ); + + $codes = array_column($errors, 'code'); + self::assertContains('archival-not-object', $codes); + }//end testAnnotationNotObjectIsRejected() + + public function testUnknownKeyUnderRuleIsRejected(): void + { + $errors = $this->validator->validate( + [ + 'x-openregister-archival' => [ + 'retention' => [ + 'default' => 'P30D', + 'rules' => [ + [ + 'condition' => 'statusCode < 400', + 'retention' => 'PT1H', + 'priority' => 'high', + ], + ], + ], + ], + ] + ); + + $codes = array_column($errors, 'code'); + self::assertContains('archival-rule-unknown-key', $codes); + }//end testUnknownKeyUnderRuleIsRejected() + + public function testIso8601CompoundDurationParses(): void + { + $errors = $this->validator->validate( + [ + 'x-openregister-archival' => ['retention' => ['default' => 'P1Y6M']], + ] + ); + + self::assertSame([], $errors); + }//end testIso8601CompoundDurationParses() +}//end class diff --git a/tests/Unit/Service/Archival/RetentionConditionEvaluatorTest.php b/tests/Unit/Service/Archival/RetentionConditionEvaluatorTest.php new file mode 100644 index 000000000000..54dca4a471fd --- /dev/null +++ b/tests/Unit/Service/Archival/RetentionConditionEvaluatorTest.php @@ -0,0 +1,108 @@ +evaluator = new RetentionConditionEvaluator(); + }//end setUp() + + public function testNumericLessThanTrue(): void + { + self::assertTrue($this->evaluator->evaluate('statusCode < 400', ['statusCode' => 200])); + }//end testNumericLessThanTrue() + + public function testNumericLessThanFalse(): void + { + self::assertFalse($this->evaluator->evaluate('statusCode < 400', ['statusCode' => 500])); + }//end testNumericLessThanFalse() + + public function testGreaterOrEqual(): void + { + self::assertTrue($this->evaluator->evaluate('statusCode >= 400', ['statusCode' => 500])); + self::assertTrue($this->evaluator->evaluate('statusCode >= 400', ['statusCode' => 400])); + self::assertFalse($this->evaluator->evaluate('statusCode >= 400', ['statusCode' => 399])); + }//end testGreaterOrEqual() + + public function testEqualityStringDoubleQuoted(): void + { + self::assertTrue($this->evaluator->evaluate('status == "success"', ['status' => 'success'])); + self::assertFalse($this->evaluator->evaluate('status == "success"', ['status' => 'failed'])); + }//end testEqualityStringDoubleQuoted() + + public function testEqualityStringSingleQuoted(): void + { + self::assertTrue($this->evaluator->evaluate("status == 'success'", ['status' => 'success'])); + }//end testEqualityStringSingleQuoted() + + public function testInequality(): void + { + self::assertTrue($this->evaluator->evaluate('status != "success"', ['status' => 'failed'])); + self::assertFalse($this->evaluator->evaluate('status != "success"', ['status' => 'success'])); + }//end testInequality() + + public function testBoolLiteral(): void + { + self::assertTrue($this->evaluator->evaluate('archived == true', ['archived' => true])); + self::assertTrue($this->evaluator->evaluate('archived != true', ['archived' => false])); + }//end testBoolLiteral() + + public function testNullLiteral(): void + { + self::assertTrue($this->evaluator->evaluate('foo == null', ['foo' => null])); + self::assertFalse($this->evaluator->evaluate('foo == null', ['foo' => 'x'])); + }//end testNullLiteral() + + public function testFloatLiteral(): void + { + self::assertTrue($this->evaluator->evaluate('latency < 1.5', ['latency' => 0.7])); + self::assertFalse($this->evaluator->evaluate('latency < 1.5', ['latency' => 2.1])); + }//end testFloatLiteral() + + public function testMissingFieldReturnsFalse(): void + { + self::assertFalse($this->evaluator->evaluate('statusCode < 400', ['foo' => 'bar'])); + }//end testMissingFieldReturnsFalse() + + public function testMalformedConditionThrows(): void + { + $this->expectException(InvalidArgumentException::class); + $this->evaluator->evaluate('statusCode 400', ['statusCode' => 200]); + }//end testMalformedConditionThrows() + + public function testUnknownLiteralThrows(): void + { + $this->expectException(InvalidArgumentException::class); + $this->evaluator->evaluate('status == bareword', ['status' => 'x']); + }//end testUnknownLiteralThrows() + + public function testTwoCharOpDoesNotGetEatenByOneCharPrefix(): void + { + // <= must not match as <; >= must not match as >; == must not be eaten. + self::assertTrue($this->evaluator->evaluate('n <= 5', ['n' => 5])); + self::assertTrue($this->evaluator->evaluate('n >= 5', ['n' => 5])); + self::assertTrue($this->evaluator->evaluate('n == 5', ['n' => 5])); + }//end testTwoCharOpDoesNotGetEatenByOneCharPrefix() +}//end class diff --git a/tests/Unit/Service/Archival/RetentionEvaluatorTest.php b/tests/Unit/Service/Archival/RetentionEvaluatorTest.php new file mode 100644 index 000000000000..2f3cdd57bbd6 --- /dev/null +++ b/tests/Unit/Service/Archival/RetentionEvaluatorTest.php @@ -0,0 +1,187 @@ +records[] = ['level' => (string) $level, 'message' => (string) $message]; + }//end log() + + public function hasWarningThatContains(string $needle): bool + { + foreach ($this->records as $record) { + if ($record['level'] === 'warning' && str_contains($record['message'], $needle)) { + return true; + } + } + + return false; + }//end hasWarningThatContains() +}//end class + +final class RetentionEvaluatorTest extends TestCase +{ + private function makeEvaluator(?CapturingLogger $logger=null): RetentionEvaluator + { + return new RetentionEvaluator(logger: ($logger ?? new NullLogger())); + }//end makeEvaluator() + + private function created(): DateTimeImmutable + { + return new DateTimeImmutable('2026-01-01T00:00:00+00:00'); + }//end created() + + public function testFirstMatchingRuleWins(): void + { + $evaluator = $this->makeEvaluator(); + $result = $evaluator->evaluate( + annotation: [ + 'retention' => [ + 'default' => 'P30D', + 'rules' => [ + ['condition' => 'statusCode < 400', 'retention' => 'PT1H'], + ['condition' => 'statusCode >= 400', 'retention' => 'P30D'], + ], + ], + ], + row: ['statusCode' => 200], + createdAt: $this->created() + ); + + self::assertSame('PT1H', $result['effectiveRetention']); + self::assertSame(0, $result['matchedRule']); + self::assertSame('2026-01-01T01:00:00+00:00', $result['expiresAt']); + }//end testFirstMatchingRuleWins() + + public function testFallsBackToDefaultWhenNoRuleMatches(): void + { + $evaluator = $this->makeEvaluator(); + $result = $evaluator->evaluate( + annotation: [ + 'retention' => [ + 'default' => 'P30D', + 'rules' => [ + ['condition' => 'statusCode < 400', 'retention' => 'PT1H'], + ], + ], + ], + row: ['statusCode' => 500], + createdAt: $this->created() + ); + + self::assertSame('P30D', $result['effectiveRetention']); + self::assertNull($result['matchedRule']); + self::assertSame('2026-01-31T00:00:00+00:00', $result['expiresAt']); + }//end testFallsBackToDefaultWhenNoRuleMatches() + + public function testSecondRuleMatchesWhenFirstDoesNot(): void + { + $evaluator = $this->makeEvaluator(); + $result = $evaluator->evaluate( + annotation: [ + 'retention' => [ + 'default' => 'P30D', + 'rules' => [ + ['condition' => 'statusCode < 400', 'retention' => 'PT1H'], + ['condition' => 'statusCode >= 400', 'retention' => 'P7D'], + ], + ], + ], + row: ['statusCode' => 500], + createdAt: $this->created() + ); + + self::assertSame('P7D', $result['effectiveRetention']); + self::assertSame(1, $result['matchedRule']); + }//end testSecondRuleMatchesWhenFirstDoesNot() + + public function testMalformedConditionIsLoggedAndSkippedNotCrashing(): void + { + $logger = new CapturingLogger(); + $evaluator = $this->makeEvaluator($logger); + + $result = $evaluator->evaluate( + annotation: [ + 'retention' => [ + 'default' => 'P30D', + 'rules' => [ + ['condition' => 'this is not a condition', 'retention' => 'PT1H'], + ['condition' => 'statusCode < 400', 'retention' => 'P1D'], + ], + ], + ], + row: ['statusCode' => 200], + createdAt: $this->created() + ); + + // Falls through to the second rule (which is well-formed and matches). + self::assertSame('P1D', $result['effectiveRetention']); + self::assertSame(1, $result['matchedRule']); + self::assertTrue($logger->hasWarningThatContains('Malformed retention condition')); + }//end testMalformedConditionIsLoggedAndSkippedNotCrashing() + + public function testAnnotationWithoutRetentionThrows(): void + { + $this->expectException(InvalidArgumentException::class); + $this->makeEvaluator()->evaluate( + annotation: [], + row: [], + createdAt: $this->created() + ); + }//end testAnnotationWithoutRetentionThrows() + + public function testAnnotationWithoutDefaultThrows(): void + { + $this->expectException(InvalidArgumentException::class); + $this->makeEvaluator()->evaluate( + annotation: ['retention' => ['rules' => []]], + row: [], + createdAt: $this->created() + ); + }//end testAnnotationWithoutDefaultThrows() + + public function testEmptyRulesFallsBackToDefault(): void + { + $result = $this->makeEvaluator()->evaluate( + annotation: ['retention' => ['default' => 'PT1H']], + row: [], + createdAt: $this->created() + ); + + self::assertSame('PT1H', $result['effectiveRetention']); + self::assertNull($result['matchedRule']); + self::assertSame('2026-01-01T01:00:00+00:00', $result['expiresAt']); + }//end testEmptyRulesFallsBackToDefault() +}//end class From 20ddce61093b1da1e245a12999a34facf9f1bffb Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Fri, 22 May 2026 12:18:47 +0200 Subject: [PATCH 031/333] feat(occ): backfill __system__ owner on legacy empty-owner rows (closes #1648) (#1649) Adds occ openregister:backfill-system-owner. PR #1645 introduced the __system__ sentinel for system-context writes so they survive RBAC filtering, but rows imported / created before that fix still have _owner='' and remain invisible to admins. This one-shot data backfill scans every (register x schema) magic table, counts rows where _owner='' and rewrites them to OrganisationService::SYSTEM_USER_ID_DEFAULT via a native UPDATE on IDBConnection. Flags: --dry-run report counts per table, no DB write --register= limit to a single register (slug / uuid / id) --schema= limit to a single schema (slug / uuid / id) Default scope walks every register * schema combo with an existing magic table. Idempotent: re-running on already-backfilled tables updates 0 rows. Wired in appinfo/info.xml alongside the other light-DI annotation command. --- appinfo/info.xml | 1 + lib/Command/BackfillSystemOwnerCommand.php | 261 +++++++++++++++++++++ phpstan-baseline.neon | 30 +++ 3 files changed, 292 insertions(+) create mode 100644 lib/Command/BackfillSystemOwnerCommand.php diff --git a/appinfo/info.xml b/appinfo/info.xml index 0e7c9cf1d6e8..83e40843ef78 100644 --- a/appinfo/info.xml +++ b/appinfo/info.xml @@ -130,6 +130,7 @@ Vrij en open source onder de EUPL-licentie. OCA\OpenRegister\Command\RematerialiseCalculationsCommand + OCA\OpenRegister\Command\BackfillSystemOwnerCommand diff --git a/lib/Command/BackfillSystemOwnerCommand.php b/lib/Command/BackfillSystemOwnerCommand.php new file mode 100644 index 000000000000..bc05634b5880 --- /dev/null +++ b/lib/Command/BackfillSystemOwnerCommand.php @@ -0,0 +1,261 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * + * @version GIT: + * + * @link https://OpenRegister.app + * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Command; + +use OCA\OpenRegister\Db\MagicMapper; +use OCA\OpenRegister\Db\Register; +use OCA\OpenRegister\Db\RegisterMapper; +use OCA\OpenRegister\Db\Schema; +use OCA\OpenRegister\Db\SchemaMapper; +use OCA\OpenRegister\Service\OrganisationService; +use OCP\IDBConnection; +use Symfony\Component\Console\Command\Command; +use Symfony\Component\Console\Input\InputInterface; +use Symfony\Component\Console\Input\InputOption; +use Symfony\Component\Console\Output\OutputInterface; + +/** + * Backfill the `__system__` sentinel on magic-table rows with empty `_owner`. + * + * @SuppressWarnings(PHPMD.CouplingBetweenObjects) + */ +class BackfillSystemOwnerCommand extends Command +{ + /** + * Wire the mappers and database connection used by the command. + * + * @param RegisterMapper $registerMapper Register lookup mapper. + * @param SchemaMapper $schemaMapper Schema lookup mapper. + * @param MagicMapper $magicMapper Magic table resolver. + * @param IDBConnection $db Database connection for native UPDATE. + * + * @return void + */ + public function __construct( + private readonly RegisterMapper $registerMapper, + private readonly SchemaMapper $schemaMapper, + private readonly MagicMapper $magicMapper, + private readonly IDBConnection $db + ) { + parent::__construct(); + }//end __construct() + + /** + * Define command name, description, and options. + * + * @return void + */ + protected function configure(): void + { + $this->setName(name: 'openregister:backfill-system-owner') + ->setDescription( + 'Backfill _owner=\'__system__\' on magic-table rows with empty _owner (legacy rows from before #1645).' + ) + ->addOption('dry-run', null, InputOption::VALUE_NONE, 'Report counts without writing to the database') + ->addOption('register', null, InputOption::VALUE_REQUIRED, 'Limit to a single register (slug, uuid or id)') + ->addOption('schema', null, InputOption::VALUE_REQUIRED, 'Limit to a single schema (slug, uuid or id)'); + }//end configure() + + /** + * Iterate every magic table and backfill the system owner sentinel. + * + * @param InputInterface $input Console input. + * @param OutputInterface $output Console output stream. + * + * @return int Symfony command exit code. + * + * @SuppressWarnings(PHPMD.CyclomaticComplexity) + * @SuppressWarnings(PHPMD.NPathComplexity) + * @SuppressWarnings(PHPMD.ExcessiveMethodLength) + */ + protected function execute(InputInterface $input, OutputInterface $output): int + { + $dryRun = (bool) $input->getOption('dry-run'); + $registerRef = $input->getOption('register'); + $schemaRef = $input->getOption('schema'); + + try { + $registers = $this->resolveRegisters(registerRef: $registerRef); + $schemas = $this->resolveSchemas(schemaRef: $schemaRef); + } catch (\Throwable $e) { + $output->writeln(''.$e->getMessage().''); + return Command::FAILURE; + } + + if (count($registers) === 0 || count($schemas) === 0) { + $output->writeln('No registers or schemas resolved — nothing to do.'); + return Command::SUCCESS; + } + + $modeLabel = ''; + if ($dryRun === true) { + $modeLabel = ' (dry run)'; + } + + $output->writeln( + sprintf( + 'Backfilling _owner=\'%s\' on rows with _owner=\'\'%s', + OrganisationService::SYSTEM_USER_ID_DEFAULT, + $modeLabel + ) + ); + + $grandScanned = 0; + $grandUpdated = 0; + $tablesTouched = 0; + + $schemasById = []; + foreach ($schemas as $schema) { + $schemasById[(int) $schema->getId()] = $schema; + } + + foreach ($registers as $register) { + $allowedSchemaIds = $register->getSchemas(); + foreach ($allowedSchemaIds as $allowedSchemaId) { + $allowedId = (int) $allowedSchemaId; + if (isset($schemasById[$allowedId]) === false) { + continue; + } + + $schema = $schemasById[$allowedId]; + + if ($this->magicMapper->tableExistsForRegisterSchema(register: $register, schema: $schema) === false) { + continue; + } + + $tableName = $this->magicMapper->getTableNameForRegisterSchema( + register: $register, + schema: $schema + ); + + [$scanned, $updated] = $this->backfillTable( + tableName: $tableName, + dryRun: $dryRun + ); + + $grandScanned += $scanned; + $grandUpdated += $updated; + $tablesTouched += 1; + + $output->writeln( + sprintf( + ' %s/%s (%s): scanned=%d updated=%d', + $register->getSlug() ?? $register->getId(), + $schema->getSlug() ?? $schema->getId(), + $tableName, + $scanned, + $updated + ) + ); + }//end foreach + }//end foreach + + $summarySuffix = ''; + if ($dryRun === true) { + $summarySuffix = ' (dry run — no writes performed)'; + } + + $output->writeln( + sprintf( + 'Done. Tables=%d scanned=%d updated=%d%s', + $tablesTouched, + $grandScanned, + $grandUpdated, + $summarySuffix + ) + ); + + return Command::SUCCESS; + }//end execute() + + /** + * Resolve the list of registers to operate on. + * + * @param string|null $registerRef Optional register slug, uuid or id. + * + * @return Register[] + */ + private function resolveRegisters(?string $registerRef): array + { + if ($registerRef !== null && $registerRef !== '') { + return [$this->registerMapper->find($registerRef, _multitenancy: false)]; + } + + return $this->registerMapper->findAll(_rbac: false, _multitenancy: false); + }//end resolveRegisters() + + /** + * Resolve the list of schemas to operate on. + * + * @param string|null $schemaRef Optional schema slug, uuid or id. + * + * @return Schema[] + */ + private function resolveSchemas(?string $schemaRef): array + { + if ($schemaRef !== null && $schemaRef !== '') { + return [$this->schemaMapper->find($schemaRef, _multitenancy: false)]; + } + + return $this->schemaMapper->findAll(_rbac: false, _multitenancy: false); + }//end resolveSchemas() + + /** + * Count and (unless dry-run) update rows with empty `_owner` in a magic table. + * + * @param string $tableName Fully qualified magic table name (without `oc_` prefix). + * @param bool $dryRun When true, only count rows. + * + * @return array{0:int,1:int} Tuple of [scanned, updated]. + */ + private function backfillTable(string $tableName, bool $dryRun): array + { + $qb = $this->db->getQueryBuilder(); + $qb->select($qb->func()->count('*', 'cnt')) + ->from($tableName) + ->where($qb->expr()->eq('_owner', $qb->createNamedParameter(''))); + + $result = $qb->executeQuery(); + $row = $result->fetch(); + $result->closeCursor(); + $scanned = (int) ($row['cnt'] ?? 0); + + if ($scanned === 0 || $dryRun === true) { + return [$scanned, 0]; + } + + $update = $this->db->getQueryBuilder(); + $update->update($tableName) + ->set('_owner', $update->createNamedParameter(OrganisationService::SYSTEM_USER_ID_DEFAULT)) + ->where($update->expr()->eq('_owner', $update->createNamedParameter(''))); + + $updated = (int) $update->executeStatement(); + + return [$scanned, $updated]; + }//end backfillTable() +}//end class diff --git a/phpstan-baseline.neon b/phpstan-baseline.neon index 2012263a1a44..6e6a6ee2ccef 100644 --- a/phpstan-baseline.neon +++ b/phpstan-baseline.neon @@ -135,6 +135,36 @@ parameters: count: 1 path: lib/Command/RematerialiseCalculationsCommand.php + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Command/BackfillSystemOwnerCommand.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Command/BackfillSystemOwnerCommand.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\RegisterMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Command/BackfillSystemOwnerCommand.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:find\\(\\)\\.$#" + count: 1 + path: lib/Command/BackfillSystemOwnerCommand.php + + - + message: "#^Unknown parameter \\$_multitenancy in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Command/BackfillSystemOwnerCommand.php + + - + message: "#^Unknown parameter \\$_rbac in call to method OCA\\\\OpenRegister\\\\Db\\\\SchemaMapper\\:\\:findAll\\(\\)\\.$#" + count: 1 + path: lib/Command/BackfillSystemOwnerCommand.php + - message: "#^Property OCA\\\\OpenRegister\\\\Command\\\\SolrDebugCommand\\:\\:\\$clientService is never read, only written\\.$#" count: 1 From e6e311670fa83f98dec70d65c6650b9a6d1d4b77 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sat, 23 May 2026 09:26:23 +0200 Subject: [PATCH 032/333] chore(deps): bump composer config.platform.php to 8.3 (#1702) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Aligns the composer platform pin with the runtime constraint ('require.php' bumped to ^8.3 fleet-wide yesterday). Keeps composer's resolver consistent — it'll pick package versions assuming PHP 8.3 is the target runtime, which matches what the container (PHP 8.3.30) and CI matrices already use. Part of the fleet-wide PHP 8.3 sweep. --- composer.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/composer.json b/composer.json index 86841aad6542..586af3dfe872 100644 --- a/composer.json +++ b/composer.json @@ -136,7 +136,7 @@ "optimize-autoloader": true, "sort-packages": true, "platform": { - "php": "8.1" + "php": "8.3" } }, "extra": { From d45edd064cd5de9d32f01371146242775e9250f9 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sat, 23 May 2026 10:02:34 +0200 Subject: [PATCH 033/333] chore(info.xml): canonicalize PHP min, NC version range, licence spelling (#1708) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Aligns appinfo/info.xml with the fleet canonical: - — matches the composer require.php constraint (^8.3 fleet-wide) - — converge the fleet on one NC support range - agpl — fix the casing/value drift (fleet had agpl / eupl / EUPL-1.2 / AGPL-3.0-or-later — 4 spellings). Stays on "agpl" workaround per the EUPL store-listing pattern; switch to "EUPL-1.2" once NC 34 is the fleet floor (ConductionNL/.github#98). Per-app fields (, , , , etc.) are preserved. Drift surfaced in https://github.com/ConductionNL/nextcloud-app-template/blob/development/docs/fleet-drift-deeper.md#4-appinfoinfoxml--significant-drift --- appinfo/info.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/appinfo/info.xml b/appinfo/info.xml index 83e40843ef78..5d96bdb30ca5 100644 --- a/appinfo/info.xml +++ b/appinfo/info.xml @@ -62,7 +62,7 @@ Vrij en open source onder de EUPL-licentie. - + pgsql sqlite mysql From d8806ee23aa04f3de8442f0be4992fca79bce9ca Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sat, 23 May 2026 10:09:12 +0200 Subject: [PATCH 034/333] chore(ci): add missing canonical workflows (#1710) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per [nextcloud-app-template/docs/fleet-drift-deeper.md §3](https://github.com/ConductionNL/nextcloud-app-template/blob/development/docs/fleet-drift-deeper.md#3-ci-workflows-githubworkflowsyml), openregister was missing 6 of the canonical 10-workflow fleet set. Adds 4 from the template: - openspec-sync.yml (pull spec changes from OpenSpec issues) - pull-request-lint-check.yaml (PR-title conventional-commit format) - spec-validation.yml (run openspec validate --strict) - sync-to-beta.yml (development → beta auto-merge) NOT added in this PR (legacy conflict): - release-beta.yml / release-stable.yml — openregister carries legacy `release.yml`. Bundling all three risks double-publishing on a tag push. Migrate in a separate cleanup PR that simultaneously removes `release.yml`. Other legacy noise (`api-test-coverage.yml`, `templates/`) also left for a separate review. --- .github/workflows/openspec-sync.yml | 15 +++++++ .../workflows/pull-request-lint-check.yaml | 22 ++++++++++ .github/workflows/spec-validation.yml | 40 +++++++++++++++++++ .github/workflows/sync-to-beta.yml | 10 +++++ 4 files changed, 87 insertions(+) create mode 100644 .github/workflows/openspec-sync.yml create mode 100644 .github/workflows/pull-request-lint-check.yaml create mode 100644 .github/workflows/spec-validation.yml create mode 100644 .github/workflows/sync-to-beta.yml diff --git a/.github/workflows/openspec-sync.yml b/.github/workflows/openspec-sync.yml new file mode 100644 index 000000000000..ce4f5f1263c0 --- /dev/null +++ b/.github/workflows/openspec-sync.yml @@ -0,0 +1,15 @@ +name: OpenSpec Sync + +on: + push: + branches: [development] + paths: ['openspec/**'] + workflow_dispatch: + +jobs: + sync: + uses: ConductionNL/.github/.github/workflows/openspec-sync.yml@main + with: + app-name: openregister + secrets: + PROJECT_TOKEN: ${{ secrets.PROJECT_TOKEN }} diff --git a/.github/workflows/pull-request-lint-check.yaml b/.github/workflows/pull-request-lint-check.yaml new file mode 100644 index 000000000000..f2402987afe7 --- /dev/null +++ b/.github/workflows/pull-request-lint-check.yaml @@ -0,0 +1,22 @@ +name: Lint Check + +on: + pull_request: + branches: + - development + - main + - beta + +jobs: + lint-check: + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v2 + + - name: Install dependencies + run: npm ci + + - name: Linting + run: npm run lint diff --git a/.github/workflows/spec-validation.yml b/.github/workflows/spec-validation.yml new file mode 100644 index 000000000000..6697c1ba18c8 --- /dev/null +++ b/.github/workflows/spec-validation.yml @@ -0,0 +1,40 @@ +name: Spec Validation + +# Validates the OpenRegister register seed (lib/Settings/*_register.json) and the +# CnAppRoot manifest (src/manifest.json) on every push and PR: +# - check:json-strict — strict JSON parse, rejects duplicate keys + appendOnly +# nested in x-openregister (the silent-data-loss class of bug a bad JSON merge +# produces — see the scholiq Wave-2 incident) +# - check:manifest — Ajv validation against @conduction/nextcloud-vue's +# app-manifest.schema.json (catches invented page/widget/action shapes) +# - check:register — structural checks: schema shape, slug uniqueness, +# lifecycle `requires:` → PHP class exists, "schema looks clobbered" heuristic +# +# To make these BLOCK a merge, add the "Spec Validation / validate" check to the +# branch-protection ruleset's required-status-checks list (org settings). + +on: + push: + branches: [main, master, development, beta, 'feature/**', 'bugfix/**', 'hotfix/**', 'chore/**', 'fix/**', 'spec/**'] + pull_request: + branches: [main, master, development, beta] + workflow_dispatch: + +jobs: + validate: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Set up Node + uses: actions/setup-node@v4 + with: + node-version: '20' + cache: 'npm' + + - name: Install dependencies + run: npm ci --no-audit --no-fund + + - name: Validate specs (json-strict + manifest + register) + run: npm run check:specs diff --git a/.github/workflows/sync-to-beta.yml b/.github/workflows/sync-to-beta.yml new file mode 100644 index 000000000000..979a373460ce --- /dev/null +++ b/.github/workflows/sync-to-beta.yml @@ -0,0 +1,10 @@ +name: Sync to Beta + +on: + push: + branches: [development] + +jobs: + sync: + uses: ConductionNL/.github/.github/workflows/sync-to-beta.yml@main + secrets: inherit From 116bc8797fc9b6274644440176d81e09fbd9387d Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sat, 23 May 2026 11:03:43 +0200 Subject: [PATCH 035/333] fix(github-issues): allow unauthenticated reads on public repos (#1723) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit GitHub's REST issues API serves anonymous requests at a lower rate limit (60/hr unauth vs 5000/hr authenticated). The previous gate on `openregister::github_api_token` returned an empty list with `hint: github_pat_not_configured` even for public repos that GitHub would happily serve, blocking the in-product roadmap surface on every fresh dev/test install where no PAT is configured. Drop the early-return when the PAT is empty and make the `Authorization` header conditional in `fetchIssuesPage`. POST (submit-feature) still requires a PAT — that path is unchanged. Supersedes D23 of `add-features-roadmap-menu`. --- lib/Service/Configuration/GitHubHandler.php | 23 +++++++++++++-------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/lib/Service/Configuration/GitHubHandler.php b/lib/Service/Configuration/GitHubHandler.php index 2b8972fa7584..8a7ed9765802 100644 --- a/lib/Service/Configuration/GitHubHandler.php +++ b/lib/Service/Configuration/GitHubHandler.php @@ -1399,10 +1399,11 @@ public function listIssues( int $perPage=30, ?array $labels=null ): array { + // PAT is optional for reads — GitHub's public Issues API serves anonymous + // requests at a lower rate limit (60/hr unauth vs 5000/hr authenticated). + // Supersedes the original D23 (add-features-roadmap-menu) decision to gate + // reads on a configured PAT. $token = $this->appConfig->getValueString('openregister', 'github_api_token', ''); - if ($token === '') { - return ['items' => [], 'hint' => 'github_pat_not_configured']; - } $effectiveLabels = is_array($labels) === true ? array_values(array_filter($labels, static fn($l) => $l !== '')) : []; $labelCount = count($effectiveLabels); @@ -1799,17 +1800,21 @@ private function fetchIssuesPage( $query['labels'] = $label; } - $url = self::API_BASE.'/repos/'.rawurlencode($owner).'/'.rawurlencode($repo).'/issues'; + $url = self::API_BASE.'/repos/'.rawurlencode($owner).'/'.rawurlencode($repo).'/issues'; + $headers = [ + 'Accept' => 'application/vnd.github+json', + 'X-GitHub-Api-Version' => '2022-11-28', + ]; + if ($token !== '') { + $headers['Authorization'] = 'Bearer '.$token; + } + $response = $this->client->request( 'GET', $url, [ 'query' => $query, - 'headers' => [ - 'Accept' => 'application/vnd.github+json', - 'X-GitHub-Api-Version' => '2022-11-28', - 'Authorization' => 'Bearer '.$token, - ], + 'headers' => $headers, ] ); From 71e7862b8176b9c4d3f1bd1ab77cd1ac0447276c Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sat, 23 May 2026 11:10:20 +0200 Subject: [PATCH 036/333] =?UTF-8?q?chore(ci):=20migrate=20legacy=20release?= =?UTF-8?q?.yml=20=E2=86=92=20canonical=20release-beta=20+=20release-stabl?= =?UTF-8?q?e=20(#1712)=20(#1725)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The legacy `release.yml` was a 3-in-1 workflow that handled `unstable` (on development push), `beta` (on beta push), and `stable` (on main push) by calling `release.yml@main` reusable. Replaces with the canonical 2-workflow pattern from the template: - `release-beta.yml` — calls `release-beta.yml@main`, triggers on push to beta - `release-stable.yml` — calls `release-stable.yml@main`, triggers on push to main App-specific vendor-deps verification preserved in both: - `verify-vendor-deps: true` - `vendor-check-paths: "openai-php/client/src,theodo-group/llphant/src"` ## Behaviour change The legacy workflow auto-published an `Unstable X.Y.Z-unstable.` prerelease on every push to `development`. The canonical pattern does **NOT** publish unstable releases — only beta (on beta push) and stable (on main push). This matches the precedent already set by `docudesk` (migrated 2026-05-04) and `softwarecatalog` (migrated 2026-03-19). Neither has reported issues with the loss of unstable releases. If unstable releases are needed downstream, a separate `release-unstable.yml` canonical pattern can be added to the template + org reusables in a follow-up. Closes #1712. --- .github/workflows/release-beta.yml | 14 +++++++++++ .github/workflows/release-stable.yml | 14 +++++++++++ .github/workflows/release.yml | 37 ---------------------------- 3 files changed, 28 insertions(+), 37 deletions(-) create mode 100644 .github/workflows/release-beta.yml create mode 100644 .github/workflows/release-stable.yml delete mode 100644 .github/workflows/release.yml diff --git a/.github/workflows/release-beta.yml b/.github/workflows/release-beta.yml new file mode 100644 index 000000000000..b05a358c8d6b --- /dev/null +++ b/.github/workflows/release-beta.yml @@ -0,0 +1,14 @@ +name: Beta Release + +on: + push: + branches: [beta] + +jobs: + release: + uses: ConductionNL/.github/.github/workflows/release-beta.yml@main + with: + app-name: openregister + verify-vendor-deps: true + vendor-check-paths: "openai-php/client/src,theodo-group/llphant/src" + secrets: inherit diff --git a/.github/workflows/release-stable.yml b/.github/workflows/release-stable.yml new file mode 100644 index 000000000000..660ce407f529 --- /dev/null +++ b/.github/workflows/release-stable.yml @@ -0,0 +1,14 @@ +name: Stable Release + +on: + push: + branches: [main] + +jobs: + release: + uses: ConductionNL/.github/.github/workflows/release-stable.yml@main + with: + app-name: openregister + verify-vendor-deps: true + vendor-check-paths: "openai-php/client/src,theodo-group/llphant/src" + secrets: inherit diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml deleted file mode 100644 index 5c22d6a155d1..000000000000 --- a/.github/workflows/release.yml +++ /dev/null @@ -1,37 +0,0 @@ -name: Release - -on: - push: - branches: [main, beta, development] - -jobs: - unstable: - if: github.ref == 'refs/heads/development' - uses: ConductionNL/.github/.github/workflows/release.yml@main - with: - release-type: unstable - app-name: openregister - verify-vendor-deps: true - vendor-check-paths: 'openai-php/client/src,theodo-group/llphant/src' - secrets: inherit - - beta: - if: github.ref == 'refs/heads/beta' - uses: ConductionNL/.github/.github/workflows/release.yml@main - with: - release-type: beta - app-name: openregister - verify-vendor-deps: true - vendor-check-paths: 'openai-php/client/src,theodo-group/llphant/src' - secrets: inherit - - stable: - if: github.ref == 'refs/heads/main' - uses: ConductionNL/.github/.github/workflows/release.yml@main - with: - release-type: stable - app-name: openregister - verify-vendor-deps: true - vendor-check-paths: 'openai-php/client/src,theodo-group/llphant/src' - secrets: inherit - From 11576838aee3ea66164bc312a0f98c6280b249e4 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sat, 23 May 2026 11:19:12 +0200 Subject: [PATCH 037/333] fix(objects): preserve JSON object key order on PUT (closes #1720) (#1726) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Object-typed schema properties (e.g. openconnector mapping/cast rules) are stored in per-schema magic tables. On PostgreSQL those columns were created as JSONB, which hashes/normalises keys and silently drops client-supplied insertion order. The openconnector drag-to-reorder UI works in-session, but after PUT + reload the storage returns keys in JSONB's order, snapping the visible list back. Fix: - Emit a new column-type tag 'json_ordered' for type:object schema properties (kept 'json' for type:array, which still uses JSONB so the @>/jsonb_* containment paths in MagicSearch/Facet stay intact). - Map 'json_ordered' to PostgreSQL JSON (verbatim storage; preserves order) and to MySQL JSON (which also stores in document order). - Add a migration step in updateTableStructure() that runs ALTER TABLE … ALTER COLUMN … TYPE JSON USING …::text::json on legacy JSONB columns whose schema is now type:object. Idempotent. - Wire the table-sync fast-path to trigger when a JSONB→JSON retype is pending (otherwise the verify-skip would never invoke the migration on existing tables). - Cover the column-type + retype-detection logic with 9 unit-test cases. Verified against the issue's repro: PUT mapping={omega,beta,kappa,alpha} → GET keys: omega,beta,kappa,alpha oc_openregister_table_65_219.mapping: jsonb → json (migrated) oc_openregister_table_65_219.unset: jsonb (unchanged; array type) Also clears one pre-existing PHPMD UnusedLocalVariable in buildUnionSelectPart() picked up while running the strict check. --- lib/Db/MagicMapper.php | 175 ++++++++- lib/Db/MagicMapper/MagicTableHandler.php | 17 +- .../MagicMapperKeyOrderColumnTypeTest.php | 351 ++++++++++++++++++ 3 files changed, 538 insertions(+), 5 deletions(-) create mode 100644 tests/Unit/Db/MagicMapper/MagicMapperKeyOrderColumnTypeTest.php diff --git a/lib/Db/MagicMapper.php b/lib/Db/MagicMapper.php index bb9ec8492ddb..2e96424e96c2 100644 --- a/lib/Db/MagicMapper.php +++ b/lib/Db/MagicMapper.php @@ -1300,7 +1300,7 @@ private function buildUnionSelectPart( // Cast to text for UNION type compatibility (some columns are jsonb, others text). $metadataColumns = $this->getMetadataColumns(); $selectColumns = []; - foreach ($metadataColumns as $metaCol => $_) { + foreach (array_keys($metadataColumns) as $metaCol) { if ($this->columnExistsInTable(tableName: $tableName, columnName: $metaCol) === true) { $selectColumns[] = "{$metaCol}::text AS {$metaCol}"; continue; @@ -2327,6 +2327,24 @@ private function mapSchemaPropertyToColumn(string $propertyName, array $property 'comment' => 'Object reference (UUID)', ]; }//end if + + // For object-typed properties, use an order-preserving JSON column type. + // PostgreSQL JSONB hashes keys and loses client-supplied insertion order, which + // breaks object-keyed schemas where order is semantically meaningful (e.g. the + // openconnector mapping rules, where drag-to-reorder must round-trip via the + // PUT API). See issue #1720. Plain JSON stores the document verbatim and + // preserves PHP/JSON-encoder insertion order. Arrays continue to use JSONB + // because (a) JSON arrays preserve element order regardless of column type + // and (b) MagicSearchHandler/MagicFacetHandler rely on jsonb containment + // operators (`@>`, `jsonb_array_elements_text`) for array filtering. + if ($type === 'object') { + return [ + 'name' => $columnName, + 'type' => 'json_ordered', + 'nullable' => $isRequired === false, + 'comment' => 'Order-preserving JSON (object-typed schema property)', + ]; + } return [ 'name' => $columnName, 'type' => 'json', @@ -2743,6 +2761,13 @@ private function mapColumnTypeToSQL(string $type, array $column): string return 'JSONB'; } return 'JSON'; + case 'json_ordered': + // Order-preserving JSON storage for object-typed schema properties. + // PostgreSQL JSONB hashes keys and loses insertion order; the JSON type + // stores the document verbatim. MySQL/MariaDB JSON also stores in document + // order (LONGTEXT-backed), so the same type label maps to JSON on both + // platforms. See issue #1720. + return 'JSON'; default: return 'TEXT'; }//end switch @@ -3674,6 +3699,17 @@ public function updateTableStructure(string $tableName, array $currentColumns, a $columnsDeRequired = array_merge($columnsDeRequired, $obsoleteDeRequired); + // 7. Migrate object-typed columns from JSONB to JSON to preserve insertion order. + // PostgreSQL JSONB normalises key order; for schema properties of `type: object` + // (which use object-keyed semantics like openconnector mapping rules) clients + // require the order they sent on PUT to round-trip on GET. See issue #1720. + $columnsRetyped = $this->migrateJsonbToJsonForOrderedColumns( + tableNameQuoted: $tableNameQuoted, + currentColumns: $currentColumns, + requiredColumns: $requiredColumns, + isPostgres: $isPostgres + ); + $this->logger->info( message: '[MagicMapper] Successfully updated table structure', context: [ @@ -3684,6 +3720,7 @@ public function updateTableStructure(string $tableName, array $currentColumns, a 'columnsDeRequired' => $columnsDeRequired, 'columnsReRequired' => $columnsReRequired, 'columnsDropped' => $columnsDropped, + 'columnsRetyped' => $columnsRetyped, ] ); @@ -3693,9 +3730,145 @@ public function updateTableStructure(string $tableName, array $currentColumns, a 'columnsDeRequired' => $columnsDeRequired, 'columnsReRequired' => $columnsReRequired, 'columnsDropped' => $columnsDropped, + 'columnsRetyped' => $columnsRetyped, ]; }//end updateTableStructure() + /** + * Identify object-typed columns still backed by PostgreSQL JSONB that need retyping + * to JSON for key-order preservation (issue #1720). + * + * Returns the list of column names where: + * - the schema column definition is type `json_ordered` (object-typed schema property), and + * - the live database column is `jsonb` (the legacy storage type). + * + * MySQL/MariaDB JSON already preserves document order; this helper short-circuits to + * an empty list on any non-PostgreSQL platform, so the fast-path check stays cheap. + * + * @param array $currentColumns Live column definitions from information_schema (see + * getExistingTableColumns()). + * @param array $requiredColumns Required column definitions from the schema (see + * buildTableColumnsFromSchema()). + * + * @return string[] Column names whose storage type needs to change from JSONB to JSON. + */ + public function findJsonbColumnsNeedingRetype(array $currentColumns, array $requiredColumns): array + { + $platform = $this->db->getDatabasePlatform(); + $isPostgres = ($platform instanceof \Doctrine\DBAL\Platforms\PostgreSQLPlatform); + if ($isPostgres === false) { + return []; + } + + $needsRetype = []; + + foreach ($requiredColumns as $propertyName => $columnDef) { + if (($columnDef['type'] ?? null) !== 'json_ordered') { + continue; + } + + $columnName = $columnDef['name'] ?? $this->sanitizeColumnName(name: $propertyName); + if (isset($currentColumns[$columnName]) === false) { + continue; + } + + $currentType = strtolower((string) ($currentColumns[$columnName]['type'] ?? '')); + if ($currentType === 'jsonb') { + $needsRetype[] = $columnName; + } + } + + return $needsRetype; + }//end findJsonbColumnsNeedingRetype() + + /** + * Migrate object-typed JSONB columns to JSON to preserve client-supplied key order. + * + * PostgreSQL JSONB stores keys in hashed/normalised order, which silently drops + * client-supplied ordering for object-keyed schema properties (e.g. openconnector + * mapping/cast rules where insertion order is semantically meaningful — issue #1720). + * The plain JSON type stores the document verbatim and round-trips insertion order. + * + * On MySQL/MariaDB the JSON type already preserves document order, so this method + * is a no-op there. On other platforms (e.g. SQLite) JSON is stored as TEXT and + * order is preserved by definition, so nothing to do. + * + * Idempotent: re-running on an already-JSON column issues no SQL. + * + * @param string $tableNameQuoted The quoted full table name. + * @param array $currentColumns Current column definitions from information_schema. + * @param array $requiredColumns Required column definitions from the schema. + * @param bool $isPostgres Whether the platform is PostgreSQL. + * + * @return string[] Names of columns whose type was migrated. + */ + private function migrateJsonbToJsonForOrderedColumns( + string $tableNameQuoted, + array $currentColumns, + array $requiredColumns, + bool $isPostgres + ): array { + // Only PostgreSQL distinguishes JSONB from JSON. MySQL/MariaDB JSON already + // preserves document order; no migration is required there. + if ($isPostgres === false) { + return []; + } + + $columnsRetyped = []; + + foreach ($requiredColumns as $propertyName => $columnDef) { + if (($columnDef['type'] ?? null) !== 'json_ordered') { + continue; + } + + $columnName = $columnDef['name'] ?? $this->sanitizeColumnName(name: $propertyName); + if (isset($currentColumns[$columnName]) === false) { + continue; + } + + $currentType = strtolower((string) ($currentColumns[$columnName]['type'] ?? '')); + if ($currentType !== 'jsonb') { + // Already JSON (or some other type added by an out-of-band migration); skip. + continue; + } + + $colNameQuoted = $this->quoteIdentifier(name: $columnName, isPostgres: true); + + // Cast JSONB to text first to retain a stable serialisation, then parse as JSON. + // JSONB → text gives PostgreSQL's normalised key order; that's the same order the + // column has held until now, so this migration does not retroactively reorder + // existing rows — only NEW writes will preserve client-supplied order. + $sql = 'ALTER TABLE '.$tableNameQuoted; + $sql .= ' ALTER COLUMN '.$colNameQuoted; + $sql .= ' TYPE JSON USING '.$colNameQuoted.'::text::json'; + + try { + $this->db->executeStatement($sql); + $columnsRetyped[] = $columnName; + $this->logger->info( + message: '[MagicMapper] Migrated object-typed column from JSONB to JSON for key-order preservation', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'columnName' => $columnName, + ] + ); + } catch (Exception $e) { + $this->logger->warning( + message: '[MagicMapper] Failed to migrate column from JSONB to JSON', + context: [ + 'file' => __FILE__, + 'line' => __LINE__, + 'columnName' => $columnName, + 'error' => $e->getMessage(), + ] + ); + }//end try + }//end foreach + + return $columnsRetyped; + }//end migrateJsonbToJsonForOrderedColumns() + /** * Quote a column or identifier name for the current database platform. * diff --git a/lib/Db/MagicMapper/MagicTableHandler.php b/lib/Db/MagicMapper/MagicTableHandler.php index 788a12e3a1a5..b8a8842e6de7 100644 --- a/lib/Db/MagicMapper/MagicTableHandler.php +++ b/lib/Db/MagicMapper/MagicTableHandler.php @@ -116,13 +116,19 @@ public function ensureTableForRegisterSchema(Register $register, Schema $schema, return true; } - // Sanity check: verify all schema columns exist in the table. - // The version hash can be stale if it was stored without a full sync. + // Sanity check: verify all schema columns exist in the table AND that + // object-typed columns aren't still on the legacy JSONB storage type + // (which silently re-orders keys — issue #1720). The version hash can + // be stale if it was stored without a full sync. $requiredColumns = $this->magicMapper->buildTableColumnsFromSchema(schema: $schema); $currentColumns = $this->magicMapper->getExistingTableColumns(tableName: $tableName); $missingColumns = array_diff_key($requiredColumns, $currentColumns); + $retypeColumns = $this->magicMapper->findJsonbColumnsNeedingRetype( + currentColumns: $currentColumns, + requiredColumns: $requiredColumns + ); - if (empty($missingColumns) === true) { + if (empty($missingColumns) === true && empty($retypeColumns) === true) { MagicMapper::setTableColumnsVerified(cacheKey: $cacheKey); $this->logger->debug( message: '[MagicTableHandler] Table exists and schema unchanged, skipping', @@ -136,13 +142,16 @@ public function ensureTableForRegisterSchema(Register $register, Schema $schema, return true; } + $warnMsg = '[MagicTableHandler] Schema version unchanged'; + $warnMsg .= ' but columns missing or need retype, forcing sync'; $this->logger->warning( - message: '[MagicTableHandler] Schema version unchanged but columns missing, forcing sync', + message: $warnMsg, context: [ 'file' => __FILE__, 'line' => __LINE__, 'tableName' => $tableName, 'missingColumns' => array_keys($missingColumns), + 'retypeColumns' => $retypeColumns, ] ); }//end if diff --git a/tests/Unit/Db/MagicMapper/MagicMapperKeyOrderColumnTypeTest.php b/tests/Unit/Db/MagicMapper/MagicMapperKeyOrderColumnTypeTest.php new file mode 100644 index 000000000000..d479040658f5 --- /dev/null +++ b/tests/Unit/Db/MagicMapper/MagicMapperKeyOrderColumnTypeTest.php @@ -0,0 +1,351 @@ + + * @copyright 2026 Conduction B.V. + * @license EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12 + * @link https://www.OpenRegister.app + */ + +declare(strict_types=1); + +namespace OCA\OpenRegister\Tests\Unit\Db\MagicMapper; + +use Doctrine\DBAL\Platforms\PostgreSQLPlatform; +use OCA\OpenRegister\Db\MagicMapper; +use OCA\OpenRegister\Db\RegisterMapper; +use OCA\OpenRegister\Db\SchemaMapper; +use OCA\OpenRegister\Service\SettingsService; +use OCP\AppFramework\Db\Entity; +use OCP\EventDispatcher\IEventDispatcher; +use OCP\IAppConfig; +use OCP\IConfig; +use OCP\IDBConnection; +use OCP\IGroupManager; +use OCP\IUserManager; +use OCP\IUserSession; +use PHPUnit\Framework\MockObject\MockObject; +use PHPUnit\Framework\TestCase; +use Psr\Container\ContainerInterface; +use Psr\Log\LoggerInterface; +use ReflectionClass; +use ReflectionMethod; + +/** + * Targets the three behaviour changes made to address issue #1720: + * + * 1. mapSchemaPropertyToColumn() emits 'json_ordered' instead of 'json' + * for type:object schema properties (so they bypass PostgreSQL's + * key-reordering JSONB storage). + * 2. mapColumnTypeToSQL() maps 'json_ordered' to PostgreSQL JSON (which + * stores documents verbatim) and to MySQL JSON. + * 3. findJsonbColumnsNeedingRetype() identifies live JSONB columns that + * need migrating to JSON when the schema property is type:object. + * + * The migration plumbing itself (executeStatement calls) is exercised by the + * verify-via-curl repro in the PR description rather than via a unit-test mock. + */ +class MagicMapperKeyOrderColumnTypeTest extends TestCase +{ + + private IDBConnection&MockObject $db; + + private SchemaMapper&MockObject $schemaMapper; + + private RegisterMapper&MockObject $registerMapper; + + private IConfig&MockObject $config; + + private IEventDispatcher&MockObject $eventDispatcher; + + private IUserSession&MockObject $userSession; + + private IGroupManager&MockObject $groupManager; + + private IUserManager&MockObject $userManager; + + private IAppConfig&MockObject $appConfig; + + private LoggerInterface&MockObject $logger; + + private SettingsService&MockObject $settingsService; + + private ContainerInterface&MockObject $container; + + /** + * Build a MagicMapper instance bypassing the constructor. + * + * The constructor builds many handlers we don't need; using + * newInstanceWithoutConstructor() + reflection lets us exercise the + * column-mapping methods in isolation. + * + * @return MagicMapper Mapper instance with db and logger wired up. + */ + private function buildMapperWithoutConstructor(): MagicMapper + { + $this->db = $this->createMock(IDBConnection::class); + $this->schemaMapper = $this->createMock(SchemaMapper::class); + $this->registerMapper = $this->createMock(RegisterMapper::class); + $this->config = $this->createMock(IConfig::class); + $this->eventDispatcher = $this->createMock(IEventDispatcher::class); + $this->userSession = $this->createMock(IUserSession::class); + $this->groupManager = $this->createMock(IGroupManager::class); + $this->userManager = $this->createMock(IUserManager::class); + $this->appConfig = $this->createMock(IAppConfig::class); + $this->logger = $this->createMock(LoggerInterface::class); + $this->settingsService = $this->createMock(SettingsService::class); + $this->container = $this->createMock(ContainerInterface::class); + + $reflection = new ReflectionClass(MagicMapper::class); + $mapper = $reflection->newInstanceWithoutConstructor(); + + // Inject only the fields the methods under test actually touch. + $properties = [ + 'db' => $this->db, + 'logger' => $this->logger, + ]; + + foreach ($properties as $name => $value) { + $prop = $reflection->getProperty($name); + $prop->setAccessible(true); + $prop->setValue($mapper, $value); + } + + return $mapper; + }//end buildMapperWithoutConstructor() + + /** + * Invoke a private MagicMapper method by name. + * + * @param MagicMapper $mapper Mapper instance. + * @param string $method Method name. + * @param array $args Positional arguments. + * + * @return mixed Return value of the invocation. + */ + private function invokePrivate(MagicMapper $mapper, string $method, array $args): mixed + { + $reflectionMethod = new ReflectionMethod(MagicMapper::class, $method); + $reflectionMethod->setAccessible(true); + return $reflectionMethod->invokeArgs($mapper, $args); + }//end invokePrivate() + + /** + * Object-typed schema properties (without a $ref to another register) must + * map to the new 'json_ordered' column type so the column gets PostgreSQL + * JSON storage rather than JSONB. Plain `json` here would land back on JSONB + * and re-order client-supplied keys. + * + * @return void + */ + public function testObjectTypedPropertyMapsToOrderPreservingType(): void + { + $mapper = $this->buildMapperWithoutConstructor(); + + $result = $this->invokePrivate( + $mapper, + 'mapSchemaPropertyToColumn', + ['mapping', ['type' => 'object']] + ); + + $this->assertSame('mapping', $result['name']); + $this->assertSame('json_ordered', $result['type']); + $this->assertTrue($result['nullable']); + }//end testObjectTypedPropertyMapsToOrderPreservingType() + + /** + * Array-typed schema properties keep the 'json' type (→ JSONB on PostgreSQL). + * Arrays are inherently ordered regardless of JSONB vs JSON, and the + * MagicSearch/Facet handlers rely on JSONB containment operators (@>) for + * filtering — switching them would regress search semantics. + * + * @return void + */ + public function testArrayTypedPropertyKeepsLegacyJsonType(): void + { + $mapper = $this->buildMapperWithoutConstructor(); + + $result = $this->invokePrivate( + $mapper, + 'mapSchemaPropertyToColumn', + ['unset', ['type' => 'array']] + ); + + $this->assertSame('unset', $result['name']); + $this->assertSame('json', $result['type']); + }//end testArrayTypedPropertyKeepsLegacyJsonType() + + /** + * Object-with-$ref-and-related-object-handling continues to short-circuit + * to VARCHAR storage (one row = one UUID string). This path predates #1720 + * and must remain unchanged. + * + * @return void + */ + public function testRelatedObjectReferenceStillMapsToVarchar(): void + { + $mapper = $this->buildMapperWithoutConstructor(); + + $result = $this->invokePrivate( + $mapper, + 'mapSchemaPropertyToColumn', + [ + 'parent', + [ + 'type' => 'object', + '$ref' => '#/components/schemas/other', + 'objectConfiguration' => ['handling' => 'related-object'], + ], + ] + ); + + $this->assertSame('parent', $result['name']); + $this->assertSame('string', $result['type']); + $this->assertSame(255, $result['length']); + }//end testRelatedObjectReferenceStillMapsToVarchar() + + /** + * 'json_ordered' must map to JSON (verbatim storage) on PostgreSQL. + * + * @return void + */ + public function testJsonOrderedMapsToPostgresJson(): void + { + $mapper = $this->buildMapperWithoutConstructor(); + $platform = $this->createMock(PostgreSQLPlatform::class); + $this->db->method('getDatabasePlatform')->willReturn($platform); + + $sql = $this->invokePrivate( + $mapper, + 'mapColumnTypeToSQL', + ['json_ordered', []] + ); + + $this->assertSame('JSON', $sql); + }//end testJsonOrderedMapsToPostgresJson() + + /** + * 'json' (the legacy tag used for array-typed columns) keeps mapping to + * JSONB on PostgreSQL — the regression we'd cause by accidentally flipping + * arrays here would break the @> containment-operator path. + * + * @return void + */ + public function testLegacyJsonMapsToPostgresJsonb(): void + { + $mapper = $this->buildMapperWithoutConstructor(); + $platform = $this->createMock(PostgreSQLPlatform::class); + $this->db->method('getDatabasePlatform')->willReturn($platform); + + $sql = $this->invokePrivate( + $mapper, + 'mapColumnTypeToSQL', + ['json', []] + ); + + $this->assertSame('JSONB', $sql); + }//end testLegacyJsonMapsToPostgresJsonb() + + /** + * Both 'json' and 'json_ordered' collapse to MySQL JSON on non-PostgreSQL. + * MySQL/MariaDB's JSON type stores documents in their original order, so + * no platform-specific split is needed. + * + * @return void + */ + public function testJsonOrderedMapsToMysqlJson(): void + { + $mapper = $this->buildMapperWithoutConstructor(); + $platform = $this->createMock(\Doctrine\DBAL\Platforms\MySQLPlatform::class); + $this->db->method('getDatabasePlatform')->willReturn($platform); + + $sql = $this->invokePrivate( + $mapper, + 'mapColumnTypeToSQL', + ['json_ordered', []] + ); + + $this->assertSame('JSON', $sql); + }//end testJsonOrderedMapsToMysqlJson() + + /** + * findJsonbColumnsNeedingRetype() returns the column name when: + * - the live database column is JSONB, and + * - the schema's required-column type is 'json_ordered'. + * + * This is the discriminator the table-sync uses to know an existing table + * needs an in-place migration to JSON. + * + * @return void + */ + public function testFindJsonbColumnsNeedingRetypeIdentifiesLegacyColumn(): void + { + $mapper = $this->buildMapperWithoutConstructor(); + $platform = $this->createMock(PostgreSQLPlatform::class); + $this->db->method('getDatabasePlatform')->willReturn($platform); + + $current = [ + 'mapping' => ['name' => 'mapping', 'type' => 'jsonb', 'nullable' => true], + 'unset' => ['name' => 'unset', 'type' => 'jsonb', 'nullable' => true], + ]; + + $required = [ + 'mapping' => ['name' => 'mapping', 'type' => 'json_ordered', 'nullable' => true], + 'unset' => ['name' => 'unset', 'type' => 'json', 'nullable' => true], + ]; + + $result = $mapper->findJsonbColumnsNeedingRetype($current, $required); + + $this->assertSame(['mapping'], $result); + }//end testFindJsonbColumnsNeedingRetypeIdentifiesLegacyColumn() + + /** + * Once a column has been migrated to JSON, the helper must NOT report it + * again — otherwise every save would re-fire the ALTER TABLE. Idempotency. + * + * @return void + */ + public function testFindJsonbColumnsNeedingRetypeSkipsAlreadyMigratedColumn(): void + { + $mapper = $this->buildMapperWithoutConstructor(); + $platform = $this->createMock(PostgreSQLPlatform::class); + $this->db->method('getDatabasePlatform')->willReturn($platform); + + $current = [ + 'mapping' => ['name' => 'mapping', 'type' => 'json', 'nullable' => true], + ]; + $required = [ + 'mapping' => ['name' => 'mapping', 'type' => 'json_ordered', 'nullable' => true], + ]; + + $this->assertSame([], $mapper->findJsonbColumnsNeedingRetype($current, $required)); + }//end testFindJsonbColumnsNeedingRetypeSkipsAlreadyMigratedColumn() + + /** + * On MySQL/MariaDB and any other non-PostgreSQL platform the JSON type + * already preserves document order, so the helper must return an empty + * list without inspecting the column maps. This keeps the fast-path cheap. + * + * @return void + */ + public function testFindJsonbColumnsNeedingRetypeShortCircuitsOnMysql(): void + { + $mapper = $this->buildMapperWithoutConstructor(); + $platform = $this->createMock(\Doctrine\DBAL\Platforms\MySQLPlatform::class); + $this->db->method('getDatabasePlatform')->willReturn($platform); + + $current = [ + 'mapping' => ['name' => 'mapping', 'type' => 'json', 'nullable' => true], + ]; + $required = [ + 'mapping' => ['name' => 'mapping', 'type' => 'json_ordered', 'nullable' => true], + ]; + + $this->assertSame([], $mapper->findJsonbColumnsNeedingRetype($current, $required)); + }//end testFindJsonbColumnsNeedingRetypeShortCircuitsOnMysql() +}//end class From c7ebc769944707ffa74565cadb771134133e5e1d Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sat, 23 May 2026 12:51:41 +0200 Subject: [PATCH 038/333] feat(github-issues): owner allowlist replaces single-repo allowlist (#1735) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The old `openregister::github_repo` accepted one `/` string matched with strict equality. That worked for a single-app instance but broke the moment a Conduction OR instance proxied issues for more than one app's repository — every other app hit `repo_not_allowed`. Replace with `openregister::github_allowed_owners` — comma-separated list of GitHub organisations / user namespaces. Match is on the owner segment of the caller-supplied `/` slug, case-insensitive. One OR instance can now proxy issues for every repo under any allowed org without per-repo configuration. Default value: `ConductionNL,nextcloud` — fresh installs proxy the Conduction fleet plus core Nextcloud repos out of the box, no admin setup required. Migration: existing `openregister::github_repo` config keys are ignored by this change. Admins should delete the old key and (optionally) set `openregister::github_allowed_owners` with their preferred allowlist. Validated end-to-end: - GET ?repo=ConductionNL/pipelinq → 1 item - GET ?repo=ConductionNL/openregister → 24 items (same instance!) - GET ?repo=torvalds/linux → 403 `repo_not_allowed` --- lib/Service/Configuration/GitHubGuards.php | 38 +++++++++++----- .../Configuration/GitHubGuardsTest.php | 45 ++++++++++++++++--- 2 files changed, 68 insertions(+), 15 deletions(-) diff --git a/lib/Service/Configuration/GitHubGuards.php b/lib/Service/Configuration/GitHubGuards.php index 0ba7975cdafb..217cf3610e69 100644 --- a/lib/Service/Configuration/GitHubGuards.php +++ b/lib/Service/Configuration/GitHubGuards.php @@ -111,15 +111,28 @@ public function enforceFeatureFlag(): ?JSONResponse }//end enforceFeatureFlag() /** - * Enforce per-instance repo allowlist (task 1.14). + * Enforce per-instance owner allowlist (task 1.14, generalised). * - * Reads `openregister::github_repo` from IAppConfig: - * - Unset → graceful degradation: 200 + `hint: github_repo_not_configured` on GET, - * 503 + `error: github_repo_not_configured` on POST. - * - Set + mismatch with caller-supplied `repo` → 403 `repo_not_allowed`. - * - Set + match → null (continue). + * Reads `openregister::github_allowed_owners` from IAppConfig as a + * comma-separated list of GitHub organisation / user names. The caller's + * `repo` is `/`; only the owner segment is matched against + * the allowlist (case-insensitive). This lets one OR instance proxy + * issues for many sibling repos under the same orgs without per-repo + * configuration. * - * @param string $repo Caller-supplied slug (already format-validated). + * - Unset / empty after trimming → graceful degradation: 200 + + * `hint: github_repo_not_configured` on GET, 503 + + * `error: github_repo_not_configured` on POST. + * - Owner not in list → 403 `repo_not_allowed`. + * - Owner in list → null (continue). + * + * Default value: `ConductionNL,nextcloud` so fresh installs proxy the + * Conduction-fleet and core Nextcloud repos out of the box. + * + * Supersedes the old single-repo `openregister::github_repo` config key + * which used strict `owner/repo` equality (PR #1726). + * + * @param string $repo Caller-supplied slug `/` (already format-validated). * @param bool $isRead Whether the call is the GET path (alters the unset-config response). * * @return JSONResponse|null Null on match, structured 403/200/503 otherwise. @@ -128,8 +141,10 @@ public function enforceFeatureFlag(): ?JSONResponse */ public function enforceRepoAllowlist(string $repo, bool $isRead): ?JSONResponse { - $allowed = $this->appConfig->getValueString('openregister', 'github_repo', ''); - if ($allowed === '') { + $rawAllowed = $this->appConfig->getValueString('openregister', 'github_allowed_owners', 'ConductionNL,nextcloud'); + $allowed = array_values(array_filter(array_map('trim', explode(',', $rawAllowed)), static fn($o) => $o !== '')); + + if ($allowed === []) { if ($isRead === true) { return new JSONResponse(['items' => [], 'hint' => 'github_repo_not_configured']); } @@ -137,7 +152,10 @@ public function enforceRepoAllowlist(string $repo, bool $isRead): ?JSONResponse return new JSONResponse(['error' => 'github_repo_not_configured'], Http::STATUS_SERVICE_UNAVAILABLE); } - if ($repo === $allowed) { + $owner = explode('/', $repo, 2)[0]; + $ownerLower = strtolower($owner); + $allowedLower = array_map('strtolower', $allowed); + if (in_array($ownerLower, $allowedLower, true) === true) { return null; } diff --git a/tests/Unit/Service/Configuration/GitHubGuardsTest.php b/tests/Unit/Service/Configuration/GitHubGuardsTest.php index a8f894c33745..fc2e19c2233c 100644 --- a/tests/Unit/Service/Configuration/GitHubGuardsTest.php +++ b/tests/Unit/Service/Configuration/GitHubGuardsTest.php @@ -108,7 +108,7 @@ public function testRepoAllowlistUnsetReturns503OnPost(): void */ public function testRepoMismatchReturns403(): void { - $guards = $this->buildGuards(repoConfig: 'ConductionNL/openregister', flagEnabled: true); + $guards = $this->buildGuards(repoConfig: 'ConductionNL', flagEnabled: true); $response = $guards->enforceRepoAllowlist(repo: 'torvalds/linux', isRead: false); $this->assertEquals(403, $response->getStatus()); @@ -122,10 +122,40 @@ public function testRepoMismatchReturns403(): void */ public function testRepoMatchPasses(): void { - $guards = $this->buildGuards(repoConfig: 'ConductionNL/openregister', flagEnabled: true); + $guards = $this->buildGuards(repoConfig: 'ConductionNL', flagEnabled: true); $this->assertNull($guards->enforceRepoAllowlist(repo: 'ConductionNL/openregister', isRead: true)); }//end testRepoMatchPasses() + /** + * Owner allowlist matches any repo under the allowed organisation — + * the same OR instance can proxy issues for the whole Conduction fleet + * without per-repo configuration. + * + * @return void + * + * @spec openspec/changes/add-features-roadmap-menu/tasks.md#task-14 + */ + public function testOwnerAllowlistMatchesAnyRepoUnderAllowedOrg(): void + { + $guards = $this->buildGuards(repoConfig: 'ConductionNL,nextcloud', flagEnabled: true); + $this->assertNull($guards->enforceRepoAllowlist(repo: 'ConductionNL/pipelinq', isRead: true)); + $this->assertNull($guards->enforceRepoAllowlist(repo: 'ConductionNL/openregister', isRead: true)); + $this->assertNull($guards->enforceRepoAllowlist(repo: 'nextcloud/server', isRead: true)); + }//end testOwnerAllowlistMatchesAnyRepoUnderAllowedOrg() + + /** + * Owner match is case-insensitive — GitHub org slugs are case-preserving + * but case-insensitive in URLs and API paths. + * + * @return void + */ + public function testOwnerAllowlistIsCaseInsensitive(): void + { + $guards = $this->buildGuards(repoConfig: 'ConductionNL,nextcloud', flagEnabled: true); + $this->assertNull($guards->enforceRepoAllowlist(repo: 'conductionnl/anything', isRead: true)); + $this->assertNull($guards->enforceRepoAllowlist(repo: 'NEXTCLOUD/server', isRead: true)); + }//end testOwnerAllowlistIsCaseInsensitive() + /** * @return void * @@ -203,8 +233,11 @@ function () use (&$hits) { /** * Build a GitHubGuards with mocked deps. The user is "alice" by default. * - * @param string $repoConfig Value returned by IAppConfig::getValueString for github_repo. - * @param bool $flagEnabled Value returned by IAppConfig::getValueBool for features_roadmap_enabled. + * @param string $repoConfig Value returned by IAppConfig for github_allowed_owners. + * Treated as the comma-separated allowlist when non-empty; + * empty string means "config explicitly unset" (the mock + * returns it as-is, including for the default-value branch). + * @param bool $flagEnabled Value returned by IAppConfig for features_roadmap_enabled. * * @return GitHubGuards */ @@ -229,7 +262,9 @@ private function buildAppConfig(string $repoConfig, bool $flagEnabled): IAppConf $appConfig = $this->createMock(IAppConfig::class); $appConfig->method('getValueString')->willReturnCallback( function (string $app, string $key, string $default='') use ($repoConfig): string { - if ($key === 'github_repo') { + if ($key === 'github_allowed_owners') { + // Empty string in the test fixture means "explicitly unset" + // so the production default ("ConductionNL,nextcloud") is NOT applied. return $repoConfig; } From 1be9ad0b2a72654447a703490af497284d610d14 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 09:22:53 +0200 Subject: [PATCH 039/333] fix(csp): allow https://avatars.githubusercontent.com in img-src for roadmap avatars (#1736) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The CnRoadmapItem component in @conduction/nextcloud-vue renders the submitter's GitHub-hosted avatar next to each roadmap card. Browsers were blocking the image with a CSP failure because Nextcloud's default img-src is `'self' data: blob:` — no GitHub host. The result: a broken-image glyph next to every roadmap item, regardless of which Conduction app proxied the GitHub-issues data through OpenRegister. Wire `IContentSecurityPolicyManager::addDefaultPolicy()` into Application::boot() with a ContentSecurityPolicy that allows `https://avatars.githubusercontent.com` as an image source. Since OR is the proxy for the issues themselves, doing the CSP relaxation here covers every consuming app without each app needing its own boot-phase patch. Verified end-to-end with Playwright: - Before: `failure: { errorText: "csp" }` on the avatar request - After: status 200, naturalWidth/Height 300×300 rendering in-card POST authoring path (CnSuggestFeatureModal) unchanged — that submits through the OpenRegister proxy and never touches GitHub images directly. --- lib/AppInfo/Application.php | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/lib/AppInfo/Application.php b/lib/AppInfo/Application.php index 00078e4b2811..b33a9857f409 100644 --- a/lib/AppInfo/Application.php +++ b/lib/AppInfo/Application.php @@ -135,7 +135,9 @@ use OCP\AppFramework\Bootstrap\IBootContext; use OCP\AppFramework\Bootstrap\IBootstrap; use OCP\AppFramework\Bootstrap\IRegistrationContext; +use OCP\AppFramework\Http\ContentSecurityPolicy; use OCP\EventDispatcher\IEventDispatcher; +use OCP\Security\IContentSecurityPolicyManager; use OCA\OpenRegister\EventListener\SolrEventListener; use OCA\OpenRegister\Listener\CommentsEntityListener; use OCA\OpenRegister\Listener\FileChangeListener; @@ -1499,8 +1501,43 @@ public function boot(IBootContext $context): void // registry never touches a provider's wrapped service unless a // caller actually invokes that provider's CRUD path. $this->bootBuiltinIntegrationProviders(server: $server); + + // Allow GitHub-hosted avatars in img-src so the CnRoadmapItem + // component can render submitter faces alongside the issues + // surfaced by the github-issue-proxy. The browser refuses + // `` under + // Nextcloud's default img-src ('self' data: blob:), leaving a + // broken-image glyph next to every roadmap card. Allowlisting + // the host here lifts the block instance-wide for any app that + // proxies GitHub issues through OpenRegister. + $this->relaxCspForGithubAvatars(server: $server); }//end boot() + /** + * Push an `img-src https://avatars.githubusercontent.com` allowlist + * onto Nextcloud's default Content-Security-Policy via + * `IContentSecurityPolicyManager::addDefaultPolicy()`. Idempotent — + * NC merges policies additively, never narrowing. + * + * @param mixed $server Server container (passed in from boot()). + * + * @return void + * + * @spec openspec/changes/add-features-roadmap-menu/specs/features-roadmap-component/spec.md#requirement-roadmap-item-avatar + */ + private function relaxCspForGithubAvatars($server): void + { + try { + $cspManager = $server->get(IContentSecurityPolicyManager::class); + $policy = new ContentSecurityPolicy(); + $policy->addAllowedImageDomain('https://avatars.githubusercontent.com'); + $cspManager->addDefaultPolicy($policy); + } catch (\Throwable $e) { + // CSP manager unavailable (rare — would break far more than + // avatars). Stay silent rather than fail the boot. + } + }//end relaxCspForGithubAvatars() + /** * Resolve every BuiltinProviders/* class and register it with the * shared IntegrationRegistry. From 1492edebb24c1bbdbb8e10ebc66a095b1e5a6a08 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 13:58:15 +0200 Subject: [PATCH 040/333] chore(spdx): add EUPL-1.2 SPDX headers to 84 misc files (Bucket 4 retrofit, part 1/7) Mechanical sweep: inserts `SPDX-License-Identifier: EUPL-1.2` + `SPDX-FileCopyrightText: 2026 Conduction B.V.` into the existing file docblock of every file in this PR's scope. Per ADR-014 and the user preference that SPDX must live INSIDE the docblock (not as line comments). Scope: BackgroundJob, Cron, Middleware, Tool, Activity, Twig, Mcp, WorkflowEngine, Command, Calendar, Dto, Formats, Lifecycle, Notification, Push, Repair, Sections, Settings, AppInfo, Contacts, Reference, Search, Capabilities, Resources. Part of the openregister coverage-scan retrofit (2026-05-24). The remaining 6 SPDX-sweep PRs will land alongside this one to clear all 633 missing-spdx Bucket 4 findings. --- lib/Activity/Filter.php | 3 +++ lib/Activity/Provider.php | 3 +++ lib/Activity/ProviderSubjectHandler.php | 3 +++ lib/Activity/Setting/ObjectSetting.php | 3 +++ lib/Activity/Setting/RegisterSetting.php | 3 +++ lib/Activity/Setting/SchemaSetting.php | 3 +++ lib/AppInfo/Application.php | 3 +++ lib/BackgroundJob/ActionRetryJob.php | 3 +++ lib/BackgroundJob/ActionScheduleJob.php | 3 +++ lib/BackgroundJob/BatchNotificationJob.php | 3 +++ lib/BackgroundJob/BlobMigrationJob.php | 3 +++ lib/BackgroundJob/BulkLegalHoldJob.php | 3 +++ lib/BackgroundJob/CacheWarmupJob.php | 3 +++ lib/BackgroundJob/CronFileTextExtractionJob.php | 3 +++ lib/BackgroundJob/DestructionCheckJob.php | 3 +++ lib/BackgroundJob/DestructionExecutionJob.php | 3 +++ lib/BackgroundJob/ExecutionHistoryCleanupJob.php | 3 +++ lib/BackgroundJob/FileTextExtractionJob.php | 3 +++ lib/BackgroundJob/HookRetryJob.php | 3 +++ lib/BackgroundJob/NameCacheWarmupJob.php | 3 +++ lib/BackgroundJob/ObjectTextExtractionJob.php | 3 +++ lib/BackgroundJob/ScheduledNotificationJob.php | 3 +++ lib/BackgroundJob/ScheduledWorkflowJob.php | 3 +++ lib/BackgroundJob/SolrNightlyWarmupJob.php | 3 +++ lib/BackgroundJob/SolrWarmupJob.php | 3 +++ lib/BackgroundJob/TenantDeprovisionJob.php | 3 +++ lib/BackgroundJob/TenantPurgeJob.php | 3 +++ lib/BackgroundJob/TenantUsageSyncJob.php | 3 +++ lib/BackgroundJob/TransferExecutionJob.php | 3 +++ lib/BackgroundJob/WebhookDeliveryJob.php | 3 +++ lib/Calendar/CalendarEventTransformer.php | 3 +++ lib/Calendar/RegisterCalendar.php | 3 +++ lib/Calendar/RegisterCalendarProvider.php | 3 +++ lib/Command/MigrateStorageCommand.php | 3 +++ lib/Command/RematerialiseCalculationsCommand.php | 3 +++ lib/Command/SolrDebugCommand.php | 3 +++ lib/Command/SolrManagementCommand.php | 3 +++ lib/Contacts/ContactsMenuProvider.php | 3 +++ lib/Cron/ArchivalRetentionTask.php | 3 +++ lib/Cron/ConfigurationCheckJob.php | 3 +++ lib/Cron/LogCleanUpTask.php | 3 +++ lib/Cron/SyncConfigurationsJob.php | 3 +++ lib/Cron/TransferCheckJob.php | 3 +++ lib/Cron/WebhookRetryJob.php | 3 +++ lib/Dto/DeepLinkRegistration.php | 3 +++ lib/Dto/DeletionAnalysis.php | 3 +++ lib/Formats/BsnFormat.php | 3 +++ lib/Formats/SemVerFormat.php | 3 +++ lib/Lifecycle/GuardResult.php | 3 +++ lib/Lifecycle/LifecycleGuardInterface.php | 3 +++ lib/Mcp/BuiltIn/ObjectsToolProvider.php | 3 +++ lib/Mcp/BuiltIn/RegistersToolProvider.php | 3 +++ lib/Mcp/BuiltIn/SchemasToolProvider.php | 3 +++ lib/Mcp/IMcpToolProvider.php | 3 +++ lib/Middleware/LanguageMiddleware.php | 3 +++ lib/Middleware/OasValidationFailureException.php | 3 +++ lib/Middleware/OasValidationMiddleware.php | 3 +++ lib/Middleware/TenantQuotaExceededException.php | 3 +++ lib/Middleware/TenantQuotaMiddleware.php | 3 +++ lib/Middleware/TenantStatusException.php | 3 +++ lib/Notification/AnnotationNotifier.php | 3 +++ lib/Notification/Notifier.php | 3 +++ lib/Push/PushEvents.php | 3 +++ lib/Reference/ObjectReferenceProvider.php | 3 +++ lib/Repair/RegisterRiskLevelMetadata.php | 3 +++ lib/Search/ObjectsProvider.php | 3 +++ lib/Sections/OpenRegisterAdmin.php | 3 +++ lib/Settings/OpenRegisterAdmin.php | 3 +++ lib/Tool/AbstractTool.php | 3 +++ lib/Tool/AgentTool.php | 3 +++ lib/Tool/ApplicationTool.php | 3 +++ lib/Tool/ObjectsTool.php | 3 +++ lib/Tool/RegisterTool.php | 3 +++ lib/Tool/SchemaTool.php | 3 +++ lib/Tool/ToolInterface.php | 3 +++ lib/Twig/AuthenticationExtension.php | 3 +++ lib/Twig/AuthenticationRuntime.php | 3 +++ lib/Twig/MappingExtension.php | 3 +++ lib/Twig/MappingRuntime.php | 3 +++ lib/Twig/MappingRuntimeLoader.php | 3 +++ lib/WorkflowEngine/N8nAdapter.php | 3 +++ lib/WorkflowEngine/WindmillAdapter.php | 3 +++ lib/WorkflowEngine/WorkflowEngineInterface.php | 3 +++ lib/WorkflowEngine/WorkflowResult.php | 3 +++ 84 files changed, 252 insertions(+) diff --git a/lib/Activity/Filter.php b/lib/Activity/Filter.php index 4561721cd11c..0ee8423c1f0e 100644 --- a/lib/Activity/Filter.php +++ b/lib/Activity/Filter.php @@ -5,6 +5,9 @@ * * Filter for OpenRegister activity events in the activity stream. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Activity * @package OCA\OpenRegister\Activity * diff --git a/lib/Activity/Provider.php b/lib/Activity/Provider.php index 84ad0d0cdb80..d6c4942e18da 100644 --- a/lib/Activity/Provider.php +++ b/lib/Activity/Provider.php @@ -5,6 +5,9 @@ * * Provider for parsing and rendering OpenRegister activity events. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Activity * @package OCA\OpenRegister\Activity * diff --git a/lib/Activity/ProviderSubjectHandler.php b/lib/Activity/ProviderSubjectHandler.php index 21e9e6f3e5d2..3d92e15df736 100644 --- a/lib/Activity/ProviderSubjectHandler.php +++ b/lib/Activity/ProviderSubjectHandler.php @@ -5,6 +5,9 @@ * * Handler for applying activity subject text and rich parameters to events. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Activity * @package OCA\OpenRegister\Activity * diff --git a/lib/Activity/Setting/ObjectSetting.php b/lib/Activity/Setting/ObjectSetting.php index b98bf1eb781c..c03ad550ee5f 100644 --- a/lib/Activity/Setting/ObjectSetting.php +++ b/lib/Activity/Setting/ObjectSetting.php @@ -5,6 +5,9 @@ * * Activity setting for object CRUD notifications. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Activity * @package OCA\OpenRegister\Activity\Setting * diff --git a/lib/Activity/Setting/RegisterSetting.php b/lib/Activity/Setting/RegisterSetting.php index d49eba6bfe2b..2b9fe8546f65 100644 --- a/lib/Activity/Setting/RegisterSetting.php +++ b/lib/Activity/Setting/RegisterSetting.php @@ -5,6 +5,9 @@ * * Activity setting for register CRUD notifications. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Activity * @package OCA\OpenRegister\Activity\Setting * diff --git a/lib/Activity/Setting/SchemaSetting.php b/lib/Activity/Setting/SchemaSetting.php index f80091453660..80df26a64c4c 100644 --- a/lib/Activity/Setting/SchemaSetting.php +++ b/lib/Activity/Setting/SchemaSetting.php @@ -5,6 +5,9 @@ * * Activity setting for schema CRUD notifications. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Activity * @package OCA\OpenRegister\Activity\Setting * diff --git a/lib/AppInfo/Application.php b/lib/AppInfo/Application.php index b33a9857f409..bb8b0c67efab 100644 --- a/lib/AppInfo/Application.php +++ b/lib/AppInfo/Application.php @@ -6,6 +6,9 @@ * This file contains the controller for handling consumer related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category AppInfo * @package OCA\OpenRegister\AppInfo * diff --git a/lib/BackgroundJob/ActionRetryJob.php b/lib/BackgroundJob/ActionRetryJob.php index 5e881f8ffd2c..58ec94c37934 100644 --- a/lib/BackgroundJob/ActionRetryJob.php +++ b/lib/BackgroundJob/ActionRetryJob.php @@ -5,6 +5,9 @@ * * Background job for retrying failed action executions. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/ActionScheduleJob.php b/lib/BackgroundJob/ActionScheduleJob.php index 1401f7321bc1..54c6998f971f 100644 --- a/lib/BackgroundJob/ActionScheduleJob.php +++ b/lib/BackgroundJob/ActionScheduleJob.php @@ -5,6 +5,9 @@ * * Background job for evaluating and executing scheduled actions. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/BatchNotificationJob.php b/lib/BackgroundJob/BatchNotificationJob.php index f902fe5fd466..7545f00d83e4 100644 --- a/lib/BackgroundJob/BatchNotificationJob.php +++ b/lib/BackgroundJob/BatchNotificationJob.php @@ -18,6 +18,9 @@ * to enqueue a notification call `NotificationDigest::enqueue()` * instead of dispatching immediately; this job is the consumer side. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/BlobMigrationJob.php b/lib/BackgroundJob/BlobMigrationJob.php index 4bba259be2df..597e2bbce1f6 100644 --- a/lib/BackgroundJob/BlobMigrationJob.php +++ b/lib/BackgroundJob/BlobMigrationJob.php @@ -7,6 +7,9 @@ * (oc_openregister_objects) to schema-specific magic tables. Runs every 5 minutes * and processes up to 100 objects per execution, grouped by register+schema pair. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/BulkLegalHoldJob.php b/lib/BackgroundJob/BulkLegalHoldJob.php index 41392cc28a46..cdf9bbff1445 100644 --- a/lib/BackgroundJob/BulkLegalHoldJob.php +++ b/lib/BackgroundJob/BulkLegalHoldJob.php @@ -5,6 +5,9 @@ * * Queued background job that places legal holds on all objects in a schema. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/CacheWarmupJob.php b/lib/BackgroundJob/CacheWarmupJob.php index 059da3d7b5a2..ad9d21247c97 100644 --- a/lib/BackgroundJob/CacheWarmupJob.php +++ b/lib/BackgroundJob/CacheWarmupJob.php @@ -7,6 +7,9 @@ * cold-start delays. Default interval: 1 hour, configurable via admin settings. * Set interval to 0 to disable. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/CronFileTextExtractionJob.php b/lib/BackgroundJob/CronFileTextExtractionJob.php index 726f37c7f78e..4ed07f72f046 100644 --- a/lib/BackgroundJob/CronFileTextExtractionJob.php +++ b/lib/BackgroundJob/CronFileTextExtractionJob.php @@ -6,6 +6,9 @@ * Recurring background job that periodically processes files for text extraction. * This job runs at configurable intervals to handle files when extraction mode is set to 'cron'. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/DestructionCheckJob.php b/lib/BackgroundJob/DestructionCheckJob.php index 17ae2298139d..089c79f81593 100644 --- a/lib/BackgroundJob/DestructionCheckJob.php +++ b/lib/BackgroundJob/DestructionCheckJob.php @@ -6,6 +6,9 @@ * Periodic background job that scans for objects eligible for destruction * and generates destruction lists for archivist review. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/DestructionExecutionJob.php b/lib/BackgroundJob/DestructionExecutionJob.php index 30eb4f11cce6..7bccab848784 100644 --- a/lib/BackgroundJob/DestructionExecutionJob.php +++ b/lib/BackgroundJob/DestructionExecutionJob.php @@ -7,6 +7,9 @@ * deleting objects in configurable batches, generating audit trails and * destruction certificates upon completion. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/ExecutionHistoryCleanupJob.php b/lib/BackgroundJob/ExecutionHistoryCleanupJob.php index b18b121f7e44..1ae0714c4bb1 100644 --- a/lib/BackgroundJob/ExecutionHistoryCleanupJob.php +++ b/lib/BackgroundJob/ExecutionHistoryCleanupJob.php @@ -5,6 +5,9 @@ * * Background job for pruning old workflow execution history records. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/FileTextExtractionJob.php b/lib/BackgroundJob/FileTextExtractionJob.php index a00665b74071..e26ef965b4c0 100644 --- a/lib/BackgroundJob/FileTextExtractionJob.php +++ b/lib/BackgroundJob/FileTextExtractionJob.php @@ -7,6 +7,9 @@ * This job is queued automatically when files are created or modified to avoid * blocking user requests with potentially slow text extraction operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * @author Conduction Development Team diff --git a/lib/BackgroundJob/HookRetryJob.php b/lib/BackgroundJob/HookRetryJob.php index a8294dfa059b..afdcc623bc9a 100644 --- a/lib/BackgroundJob/HookRetryJob.php +++ b/lib/BackgroundJob/HookRetryJob.php @@ -5,6 +5,9 @@ * * Background job for retrying schema hooks that failed due to engine unavailability. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/NameCacheWarmupJob.php b/lib/BackgroundJob/NameCacheWarmupJob.php index c8fc8ba91368..f85b64dd96d8 100644 --- a/lib/BackgroundJob/NameCacheWarmupJob.php +++ b/lib/BackgroundJob/NameCacheWarmupJob.php @@ -7,6 +7,9 @@ * This ensures optimal facet label resolution performance by pre-populating the * distributed name cache with all object names. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/ObjectTextExtractionJob.php b/lib/BackgroundJob/ObjectTextExtractionJob.php index c99302608796..5fb6b43c9fb0 100644 --- a/lib/BackgroundJob/ObjectTextExtractionJob.php +++ b/lib/BackgroundJob/ObjectTextExtractionJob.php @@ -7,6 +7,9 @@ * This job is queued automatically when objects are created or modified to avoid * blocking user requests with potentially slow text extraction operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * @author Conduction Development Team diff --git a/lib/BackgroundJob/ScheduledNotificationJob.php b/lib/BackgroundJob/ScheduledNotificationJob.php index eec8b1c0d9b0..90240d81a057 100644 --- a/lib/BackgroundJob/ScheduledNotificationJob.php +++ b/lib/BackgroundJob/ScheduledNotificationJob.php @@ -13,6 +13,9 @@ * channel logic (nc-notification, email, activity, webhook, talk) is * reused unchanged. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/ScheduledWorkflowJob.php b/lib/BackgroundJob/ScheduledWorkflowJob.php index b2bcaa40208f..3266e98a6f92 100644 --- a/lib/BackgroundJob/ScheduledWorkflowJob.php +++ b/lib/BackgroundJob/ScheduledWorkflowJob.php @@ -5,6 +5,9 @@ * * Background job for executing scheduled workflows on their configured intervals. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/SolrNightlyWarmupJob.php b/lib/BackgroundJob/SolrNightlyWarmupJob.php index 6ffa7830c49a..d98099ae3a19 100644 --- a/lib/BackgroundJob/SolrNightlyWarmupJob.php +++ b/lib/BackgroundJob/SolrNightlyWarmupJob.php @@ -6,6 +6,9 @@ * Recurring background job that runs every night at 00:00 to warm up the SOLR index. * This ensures optimal search performance by keeping the index warm and ready for queries. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/SolrWarmupJob.php b/lib/BackgroundJob/SolrWarmupJob.php index 2e6078d50b91..ca74b4a0a147 100644 --- a/lib/BackgroundJob/SolrWarmupJob.php +++ b/lib/BackgroundJob/SolrWarmupJob.php @@ -7,6 +7,9 @@ * This job is scheduled automatically after import operations complete to * ensure optimal search performance without slowing down the import process. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/TenantDeprovisionJob.php b/lib/BackgroundJob/TenantDeprovisionJob.php index e5570d5c1c2f..745346fc0d96 100644 --- a/lib/BackgroundJob/TenantDeprovisionJob.php +++ b/lib/BackgroundJob/TenantDeprovisionJob.php @@ -6,6 +6,9 @@ * Processes organisations in 'deprovisioning' state by soft-deleting their * objects and transitioning them to 'archived' state. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/TenantPurgeJob.php b/lib/BackgroundJob/TenantPurgeJob.php index 1d90c9482662..48f3d360e651 100644 --- a/lib/BackgroundJob/TenantPurgeJob.php +++ b/lib/BackgroundJob/TenantPurgeJob.php @@ -6,6 +6,9 @@ * Permanently deletes archived organisations and their data after the * configured retention period (default: 90 days). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/TenantUsageSyncJob.php b/lib/BackgroundJob/TenantUsageSyncJob.php index 35fd55bafc14..6caaa0ca759f 100644 --- a/lib/BackgroundJob/TenantUsageSyncJob.php +++ b/lib/BackgroundJob/TenantUsageSyncJob.php @@ -6,6 +6,9 @@ * Flushes APCu-based quota counters to the openregister_tenant_usage database * table for persistence, dashboard display, and historical tracking. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/TransferExecutionJob.php b/lib/BackgroundJob/TransferExecutionJob.php index a5a90d23766b..09d9fb68116c 100644 --- a/lib/BackgroundJob/TransferExecutionJob.php +++ b/lib/BackgroundJob/TransferExecutionJob.php @@ -5,6 +5,9 @@ * * Queued background job that executes e-Depot transfers for approved transfer lists. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/BackgroundJob/WebhookDeliveryJob.php b/lib/BackgroundJob/WebhookDeliveryJob.php index f5943088783d..25bcd6dd9108 100644 --- a/lib/BackgroundJob/WebhookDeliveryJob.php +++ b/lib/BackgroundJob/WebhookDeliveryJob.php @@ -5,6 +5,9 @@ * * Background job for webhook delivery with retries. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category BackgroundJob * @package OCA\OpenRegister\BackgroundJob * diff --git a/lib/Calendar/CalendarEventTransformer.php b/lib/Calendar/CalendarEventTransformer.php index 34fef3d88601..4d3271e8fd17 100644 --- a/lib/Calendar/CalendarEventTransformer.php +++ b/lib/Calendar/CalendarEventTransformer.php @@ -6,6 +6,9 @@ * Transforms ObjectEntity data into VEVENT-compatible arrays * for the Nextcloud Calendar app. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Calendar * @package OCA\OpenRegister\Calendar * diff --git a/lib/Calendar/RegisterCalendar.php b/lib/Calendar/RegisterCalendar.php index 4e5a4dec3813..ad63458f5d6f 100644 --- a/lib/Calendar/RegisterCalendar.php +++ b/lib/Calendar/RegisterCalendar.php @@ -6,6 +6,9 @@ * Implements ICalendar to provide a virtual calendar backed by * OpenRegister schema objects with date fields. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Calendar * @package OCA\OpenRegister\Calendar * diff --git a/lib/Calendar/RegisterCalendarProvider.php b/lib/Calendar/RegisterCalendarProvider.php index a6f9a7d886ba..84128e4bdb19 100644 --- a/lib/Calendar/RegisterCalendarProvider.php +++ b/lib/Calendar/RegisterCalendarProvider.php @@ -6,6 +6,9 @@ * Implements ICalendarProvider to register virtual calendars * for OpenRegister schemas with calendar-enabled date fields. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Calendar * @package OCA\OpenRegister\Calendar * diff --git a/lib/Command/MigrateStorageCommand.php b/lib/Command/MigrateStorageCommand.php index 380fe25a31cf..93ca793dcd7d 100644 --- a/lib/Command/MigrateStorageCommand.php +++ b/lib/Command/MigrateStorageCommand.php @@ -5,6 +5,9 @@ * * OCC command for migrating objects between blob storage and magic tables. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Command * @package OCA\OpenRegister\Command * @author Conduction Development Team diff --git a/lib/Command/RematerialiseCalculationsCommand.php b/lib/Command/RematerialiseCalculationsCommand.php index d56de31e04e2..640d0fc2a8d9 100644 --- a/lib/Command/RematerialiseCalculationsCommand.php +++ b/lib/Command/RematerialiseCalculationsCommand.php @@ -8,6 +8,9 @@ * expression changes so existing objects reflect the new shape without * waiting for the next user-driven save. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Command * @package OCA\OpenRegister\Command * diff --git a/lib/Command/SolrDebugCommand.php b/lib/Command/SolrDebugCommand.php index 599714ac1421..7d965a8adaaf 100644 --- a/lib/Command/SolrDebugCommand.php +++ b/lib/Command/SolrDebugCommand.php @@ -5,6 +5,9 @@ * * SOLR Debug Command for testing SOLR functionality step by step. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Command * @package OCA\OpenRegister\Command * diff --git a/lib/Command/SolrManagementCommand.php b/lib/Command/SolrManagementCommand.php index 5a9d960773e4..c4dcea2901be 100644 --- a/lib/Command/SolrManagementCommand.php +++ b/lib/Command/SolrManagementCommand.php @@ -8,6 +8,9 @@ * This command provides comprehensive SOLR management operations including * setup, schema validation, optimization, warming, and maintenance tasks. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Command * @package OCA\OpenRegister\Command * diff --git a/lib/Contacts/ContactsMenuProvider.php b/lib/Contacts/ContactsMenuProvider.php index 770bb302c9d9..a8b076c003a8 100644 --- a/lib/Contacts/ContactsMenuProvider.php +++ b/lib/Contacts/ContactsMenuProvider.php @@ -6,6 +6,9 @@ * Nextcloud Contacts Menu provider that bridges Contacts/CardDAV * with OpenRegister entity data. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Contacts * @package OCA\OpenRegister\Contacts * diff --git a/lib/Cron/ArchivalRetentionTask.php b/lib/Cron/ArchivalRetentionTask.php index b978feafe27b..05a9d35badbf 100644 --- a/lib/Cron/ArchivalRetentionTask.php +++ b/lib/Cron/ArchivalRetentionTask.php @@ -19,6 +19,9 @@ * 5. Emit one structured log entry per schema: * `{schemaSlug, scanned, expired, deleted}`. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Cron * @package OCA\OpenRegister\Cron * diff --git a/lib/Cron/ConfigurationCheckJob.php b/lib/Cron/ConfigurationCheckJob.php index 5f784db15bf0..bfa64041b5d5 100644 --- a/lib/Cron/ConfigurationCheckJob.php +++ b/lib/Cron/ConfigurationCheckJob.php @@ -6,6 +6,9 @@ * This file contains the background job class for checking remote configurations * for updates in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Cron * @package OCA\OpenRegister\Cron * @author Conduction Development Team diff --git a/lib/Cron/LogCleanUpTask.php b/lib/Cron/LogCleanUpTask.php index a63399781708..ba501ad70de4 100644 --- a/lib/Cron/LogCleanUpTask.php +++ b/lib/Cron/LogCleanUpTask.php @@ -6,6 +6,9 @@ * This file contains the background job for cleaning up expired audit trail logs * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Cron * @package OCA\OpenRegister\Cron * @author Conduction Development Team diff --git a/lib/Cron/SyncConfigurationsJob.php b/lib/Cron/SyncConfigurationsJob.php index 94ce6be1f163..775bfe4fddf0 100644 --- a/lib/Cron/SyncConfigurationsJob.php +++ b/lib/Cron/SyncConfigurationsJob.php @@ -6,6 +6,9 @@ * This file contains the background job class for synchronizing external configurations * from their source repositories (GitHub, GitLab, URL). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Cron * @package OCA\OpenRegister\Cron * diff --git a/lib/Cron/TransferCheckJob.php b/lib/Cron/TransferCheckJob.php index ffadee182a6f..888d281ef274 100644 --- a/lib/Cron/TransferCheckJob.php +++ b/lib/Cron/TransferCheckJob.php @@ -6,6 +6,9 @@ * Background job that scans for objects eligible for e-Depot transfer * and generates transfer lists for archivist review. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Cron * @package OCA\OpenRegister\Cron * diff --git a/lib/Cron/WebhookRetryJob.php b/lib/Cron/WebhookRetryJob.php index d7faaf190528..538448012554 100644 --- a/lib/Cron/WebhookRetryJob.php +++ b/lib/Cron/WebhookRetryJob.php @@ -7,6 +7,9 @@ * based on their next_retry_at timestamp. Uses exponential backoff * with increasing intervals between retries. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Cron * @package OCA\OpenRegister\Cron * diff --git a/lib/Dto/DeepLinkRegistration.php b/lib/Dto/DeepLinkRegistration.php index c5f6b607c0c1..a4e1f8fbe261 100644 --- a/lib/Dto/DeepLinkRegistration.php +++ b/lib/Dto/DeepLinkRegistration.php @@ -5,6 +5,9 @@ * * Value object representing a deep link registration from a consuming app. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Dto * @package OCA\OpenRegister\Dto * diff --git a/lib/Dto/DeletionAnalysis.php b/lib/Dto/DeletionAnalysis.php index 94dc137c5df8..e1f15f27a1dd 100644 --- a/lib/Dto/DeletionAnalysis.php +++ b/lib/Dto/DeletionAnalysis.php @@ -7,6 +7,9 @@ * Contains information about what would happen if an object were deleted, * including cascade targets, nullification targets, and blockers. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Dto * @package OCA\OpenRegister\Dto * diff --git a/lib/Formats/BsnFormat.php b/lib/Formats/BsnFormat.php index 46cc006a85b2..3de24b2116df 100644 --- a/lib/Formats/BsnFormat.php +++ b/lib/Formats/BsnFormat.php @@ -5,6 +5,9 @@ * * This file contains the format class for the Bsn format. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Format * @package OCA\OpenRegister\Formats * diff --git a/lib/Formats/SemVerFormat.php b/lib/Formats/SemVerFormat.php index 46d3eb3ce5ab..9fcc8e0eb8b6 100644 --- a/lib/Formats/SemVerFormat.php +++ b/lib/Formats/SemVerFormat.php @@ -5,6 +5,9 @@ * * Validates semantic version strings according to SemVer specification. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Formats * @package OCA\OpenRegister\Formats * diff --git a/lib/Lifecycle/GuardResult.php b/lib/Lifecycle/GuardResult.php index 6d42cd711b2a..289b98d07874 100644 --- a/lib/Lifecycle/GuardResult.php +++ b/lib/Lifecycle/GuardResult.php @@ -6,6 +6,9 @@ * Value object returned by `LifecycleGuardInterface::check`. Two factory * constructors (`allow` and `deny`) plus read-only inspectors. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Lifecycle * @package OCA\OpenRegister\Lifecycle * diff --git a/lib/Lifecycle/LifecycleGuardInterface.php b/lib/Lifecycle/LifecycleGuardInterface.php index cb9280119603..9a18240489ba 100644 --- a/lib/Lifecycle/LifecycleGuardInterface.php +++ b/lib/Lifecycle/LifecycleGuardInterface.php @@ -8,6 +8,9 @@ * via DI tag; the schema's `x-openregister-lifecycle.transitions[*].requires` * field names the tag. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Lifecycle * @package OCA\OpenRegister\Lifecycle * diff --git a/lib/Mcp/BuiltIn/ObjectsToolProvider.php b/lib/Mcp/BuiltIn/ObjectsToolProvider.php index f278d44d4539..bd0343e9770e 100644 --- a/lib/Mcp/BuiltIn/ObjectsToolProvider.php +++ b/lib/Mcp/BuiltIn/ObjectsToolProvider.php @@ -6,6 +6,9 @@ * Exposes CRUD operations on OpenRegister objects as an MCP tool * under the namespaced id `openregister.objects`. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Mcp * @package OCA\OpenRegister\Mcp\BuiltIn * diff --git a/lib/Mcp/BuiltIn/RegistersToolProvider.php b/lib/Mcp/BuiltIn/RegistersToolProvider.php index 5c74456a98b6..70938d995877 100644 --- a/lib/Mcp/BuiltIn/RegistersToolProvider.php +++ b/lib/Mcp/BuiltIn/RegistersToolProvider.php @@ -6,6 +6,9 @@ * Exposes CRUD operations on OpenRegister registers as an MCP tool * under the namespaced id `openregister.registers`. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Mcp * @package OCA\OpenRegister\Mcp\BuiltIn * diff --git a/lib/Mcp/BuiltIn/SchemasToolProvider.php b/lib/Mcp/BuiltIn/SchemasToolProvider.php index 1f6ad0fd7f2d..539116273c02 100644 --- a/lib/Mcp/BuiltIn/SchemasToolProvider.php +++ b/lib/Mcp/BuiltIn/SchemasToolProvider.php @@ -6,6 +6,9 @@ * Exposes CRUD operations on OpenRegister schemas as an MCP tool * under the namespaced id `openregister.schemas`. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Mcp * @package OCA\OpenRegister\Mcp\BuiltIn * diff --git a/lib/Mcp/IMcpToolProvider.php b/lib/Mcp/IMcpToolProvider.php index 6034ca848a8a..770143397f91 100644 --- a/lib/Mcp/IMcpToolProvider.php +++ b/lib/Mcp/IMcpToolProvider.php @@ -8,6 +8,9 @@ * container. OpenRegister's McpToolsService enumerates every registered * implementation in-process per turn without issuing extra HTTP requests. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Mcp * @package OCA\OpenRegister\Mcp * diff --git a/lib/Middleware/LanguageMiddleware.php b/lib/Middleware/LanguageMiddleware.php index 51eb75834e96..add0b50d2a1b 100644 --- a/lib/Middleware/LanguageMiddleware.php +++ b/lib/Middleware/LanguageMiddleware.php @@ -7,6 +7,9 @@ * and store the preferred language in the LanguageService. Also checks for * the _translations=all query parameter. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Middleware * @package OCA\OpenRegister\Middleware * diff --git a/lib/Middleware/OasValidationFailureException.php b/lib/Middleware/OasValidationFailureException.php index 207f925b5546..5379a9d87da1 100644 --- a/lib/Middleware/OasValidationFailureException.php +++ b/lib/Middleware/OasValidationFailureException.php @@ -7,6 +7,9 @@ * body fails OAS schema validation. Caught by the same middleware's * `afterException` method and translated into an RFC 7807 422 response. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Middleware * @package OCA\OpenRegister\Middleware * diff --git a/lib/Middleware/OasValidationMiddleware.php b/lib/Middleware/OasValidationMiddleware.php index 2fca023370cd..a9a8cec517a7 100644 --- a/lib/Middleware/OasValidationMiddleware.php +++ b/lib/Middleware/OasValidationMiddleware.php @@ -15,6 +15,9 @@ * callers without the annotation skip validation, preserving the old * behaviour for clients that don't yet send strictly-typed bodies). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Middleware * @package OCA\OpenRegister\Middleware * diff --git a/lib/Middleware/TenantQuotaExceededException.php b/lib/Middleware/TenantQuotaExceededException.php index 6d02ac0302cc..68712619d6be 100644 --- a/lib/Middleware/TenantQuotaExceededException.php +++ b/lib/Middleware/TenantQuotaExceededException.php @@ -5,6 +5,9 @@ * * Thrown when an organisation exceeds its request or bandwidth quota. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Middleware * diff --git a/lib/Middleware/TenantQuotaMiddleware.php b/lib/Middleware/TenantQuotaMiddleware.php index 1b01a13e05f2..33733086bd71 100644 --- a/lib/Middleware/TenantQuotaMiddleware.php +++ b/lib/Middleware/TenantQuotaMiddleware.php @@ -7,6 +7,9 @@ * status checks before controller execution. Uses APCu for high-performance * counter management. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Middleware * @package OCA\OpenRegister\Middleware * diff --git a/lib/Middleware/TenantStatusException.php b/lib/Middleware/TenantStatusException.php index a8dc9a45f93c..b0f4c9c2fff0 100644 --- a/lib/Middleware/TenantStatusException.php +++ b/lib/Middleware/TenantStatusException.php @@ -5,6 +5,9 @@ * * Thrown when an organisation is in a non-active state that prevents API access. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Middleware * diff --git a/lib/Notification/AnnotationNotifier.php b/lib/Notification/AnnotationNotifier.php index 1cc4be341917..ef4217f84eb8 100644 --- a/lib/Notification/AnnotationNotifier.php +++ b/lib/Notification/AnnotationNotifier.php @@ -7,6 +7,9 @@ * already-interpolated subject under the `_text` parameter; this notifier * surfaces it as the notification's parsed subject. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Notification * @package OCA\OpenRegister\Notification * diff --git a/lib/Notification/Notifier.php b/lib/Notification/Notifier.php index 20d1a44009a4..137ddc048ae1 100644 --- a/lib/Notification/Notifier.php +++ b/lib/Notification/Notifier.php @@ -6,6 +6,9 @@ * This file contains the notifier class for displaying notifications * in the Nextcloud notification center. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Notification * @package OCA\OpenRegister\Notification * diff --git a/lib/Push/PushEvents.php b/lib/Push/PushEvents.php index 03e9eb5c47cc..d4af418f91ec 100644 --- a/lib/Push/PushEvents.php +++ b/lib/Push/PushEvents.php @@ -11,6 +11,9 @@ * - OR_OBJECT → `or-object` — base string; append `-{uuid}` to target a single object. * - OR_COLLECTION → `or-collection` — base string; append `-{register-slug}-{schema-slug}` to target a collection. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Push * @package OCA\OpenRegister\Push * diff --git a/lib/Reference/ObjectReferenceProvider.php b/lib/Reference/ObjectReferenceProvider.php index 94bebdafbc5b..7d066e2ecf78 100644 --- a/lib/Reference/ObjectReferenceProvider.php +++ b/lib/Reference/ObjectReferenceProvider.php @@ -7,6 +7,9 @@ * to search for and insert rich references to register objects in Mail, * Text, Talk, Collectives, and any Nextcloud app supporting the Smart Picker. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Reference * @package OCA\OpenRegister\Reference * diff --git a/lib/Repair/RegisterRiskLevelMetadata.php b/lib/Repair/RegisterRiskLevelMetadata.php index f2ca6719df1c..74b59269e06f 100644 --- a/lib/Repair/RegisterRiskLevelMetadata.php +++ b/lib/Repair/RegisterRiskLevelMetadata.php @@ -3,6 +3,9 @@ /** * Repair step to register the risk level metadata key. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Repair * @package OCA\OpenRegister\Repair * diff --git a/lib/Search/ObjectsProvider.php b/lib/Search/ObjectsProvider.php index b423859a0077..2a6b51da720b 100644 --- a/lib/Search/ObjectsProvider.php +++ b/lib/Search/ObjectsProvider.php @@ -5,6 +5,9 @@ * * This file contains the provider class for the objects search. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Search * @package OCA\OpenRegister\Search * diff --git a/lib/Sections/OpenRegisterAdmin.php b/lib/Sections/OpenRegisterAdmin.php index 4350d4b959c4..d892aa3a4a42 100644 --- a/lib/Sections/OpenRegisterAdmin.php +++ b/lib/Sections/OpenRegisterAdmin.php @@ -5,6 +5,9 @@ * * Provides admin settings section for OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Section * @package OCA\OpenRegister\Sections * diff --git a/lib/Settings/OpenRegisterAdmin.php b/lib/Settings/OpenRegisterAdmin.php index db379d9d77ef..1e56a9d51cd0 100644 --- a/lib/Settings/OpenRegisterAdmin.php +++ b/lib/Settings/OpenRegisterAdmin.php @@ -5,6 +5,9 @@ * * Admin settings page for OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Settings * @package OCA\OpenRegister\Settings * diff --git a/lib/Tool/AbstractTool.php b/lib/Tool/AbstractTool.php index 382071aa9cfc..b06a026f120a 100644 --- a/lib/Tool/AbstractTool.php +++ b/lib/Tool/AbstractTool.php @@ -6,6 +6,9 @@ * Base class for LLphant function tools providing common functionality * for user context management, view filtering, and error handling. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Tool * @package OCA\OpenRegister\Tool * diff --git a/lib/Tool/AgentTool.php b/lib/Tool/AgentTool.php index 1221974920e1..b67d844e49c7 100644 --- a/lib/Tool/AgentTool.php +++ b/lib/Tool/AgentTool.php @@ -6,6 +6,9 @@ * LLphant function tool for AI agents to manage other agents. * Provides CRUD operations for agents with RBAC enforcement. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Tool * @package OCA\OpenRegister\Tool * diff --git a/lib/Tool/ApplicationTool.php b/lib/Tool/ApplicationTool.php index 64a23b26ec5c..ce82b443961e 100644 --- a/lib/Tool/ApplicationTool.php +++ b/lib/Tool/ApplicationTool.php @@ -6,6 +6,9 @@ * LLphant function tool for AI agents to manage applications. * Provides CRUD operations for applications with RBAC enforcement. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Tool * @package OCA\OpenRegister\Tool * diff --git a/lib/Tool/ObjectsTool.php b/lib/Tool/ObjectsTool.php index 3001e476736a..24b561079458 100644 --- a/lib/Tool/ObjectsTool.php +++ b/lib/Tool/ObjectsTool.php @@ -6,6 +6,9 @@ * LLphant function tool for managing objects through natural language. * Provides CRUD operations on objects with RBAC and multi-tenancy support. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Tool * @package OCA\OpenRegister\Tool * diff --git a/lib/Tool/RegisterTool.php b/lib/Tool/RegisterTool.php index 828b793af327..15de2e425577 100644 --- a/lib/Tool/RegisterTool.php +++ b/lib/Tool/RegisterTool.php @@ -6,6 +6,9 @@ * LLphant function tool for managing registers through natural language. * Provides CRUD operations on registers with RBAC and multi-tenancy support. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Tool * @package OCA\OpenRegister\Tool * diff --git a/lib/Tool/SchemaTool.php b/lib/Tool/SchemaTool.php index 02eadd9adaaf..779e67911870 100644 --- a/lib/Tool/SchemaTool.php +++ b/lib/Tool/SchemaTool.php @@ -6,6 +6,9 @@ * LLphant function tool for managing schemas through natural language. * Provides CRUD operations on schemas with RBAC and multi-tenancy support. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Tool * @package OCA\OpenRegister\Tool * diff --git a/lib/Tool/ToolInterface.php b/lib/Tool/ToolInterface.php index 58554716d439..473144b46696 100644 --- a/lib/Tool/ToolInterface.php +++ b/lib/Tool/ToolInterface.php @@ -6,6 +6,9 @@ * Interface for LLphant function tools that agents can use to interact * with OpenRegister data. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Tool * @package OCA\OpenRegister\Tool * diff --git a/lib/Twig/AuthenticationExtension.php b/lib/Twig/AuthenticationExtension.php index 824f827a68e9..37e4de258522 100644 --- a/lib/Twig/AuthenticationExtension.php +++ b/lib/Twig/AuthenticationExtension.php @@ -3,6 +3,9 @@ /** * Twig extension for authentication token functions. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Twig * @package OCA\OpenRegister\Twig * diff --git a/lib/Twig/AuthenticationRuntime.php b/lib/Twig/AuthenticationRuntime.php index 15dcc3cfaa89..5509f12918df 100644 --- a/lib/Twig/AuthenticationRuntime.php +++ b/lib/Twig/AuthenticationRuntime.php @@ -3,6 +3,9 @@ /** * Twig runtime for authentication token functions. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Twig * @package OCA\OpenRegister\Twig * diff --git a/lib/Twig/MappingExtension.php b/lib/Twig/MappingExtension.php index 43fdd7ca74c6..2e790c71207f 100644 --- a/lib/Twig/MappingExtension.php +++ b/lib/Twig/MappingExtension.php @@ -5,6 +5,9 @@ * * Registers Twig functions and filters for the mapping engine. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Twig * @package OCA\OpenRegister\Twig * diff --git a/lib/Twig/MappingRuntime.php b/lib/Twig/MappingRuntime.php index 8589fbada150..b723b45e4b55 100644 --- a/lib/Twig/MappingRuntime.php +++ b/lib/Twig/MappingRuntime.php @@ -6,6 +6,9 @@ * Twig runtime extension providing mapping functions and filters * for use within Twig mapping templates. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Twig * @package OCA\OpenRegister\Twig * diff --git a/lib/Twig/MappingRuntimeLoader.php b/lib/Twig/MappingRuntimeLoader.php index 4543b9645f1b..a6892898b8ec 100644 --- a/lib/Twig/MappingRuntimeLoader.php +++ b/lib/Twig/MappingRuntimeLoader.php @@ -5,6 +5,9 @@ * * Loader that provides the MappingRuntime to Twig's extension system. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Twig * @package OCA\OpenRegister\Twig * diff --git a/lib/WorkflowEngine/N8nAdapter.php b/lib/WorkflowEngine/N8nAdapter.php index 3be6d1aae68d..31ecc1950287 100644 --- a/lib/WorkflowEngine/N8nAdapter.php +++ b/lib/WorkflowEngine/N8nAdapter.php @@ -3,6 +3,9 @@ /** * OpenRegister N8nAdapter * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category WorkflowEngine * @package OCA\OpenRegister\WorkflowEngine * diff --git a/lib/WorkflowEngine/WindmillAdapter.php b/lib/WorkflowEngine/WindmillAdapter.php index 07722b57419c..8c468a411af4 100644 --- a/lib/WorkflowEngine/WindmillAdapter.php +++ b/lib/WorkflowEngine/WindmillAdapter.php @@ -3,6 +3,9 @@ /** * OpenRegister WindmillAdapter * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category WorkflowEngine * @package OCA\OpenRegister\WorkflowEngine * diff --git a/lib/WorkflowEngine/WorkflowEngineInterface.php b/lib/WorkflowEngine/WorkflowEngineInterface.php index 9b63748de6a3..9f03b464f888 100644 --- a/lib/WorkflowEngine/WorkflowEngineInterface.php +++ b/lib/WorkflowEngine/WorkflowEngineInterface.php @@ -3,6 +3,9 @@ /** * OpenRegister WorkflowEngine Interface * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category WorkflowEngine * @package OCA\OpenRegister\WorkflowEngine * diff --git a/lib/WorkflowEngine/WorkflowResult.php b/lib/WorkflowEngine/WorkflowResult.php index 6f0bc77412d1..244e97c1e71c 100644 --- a/lib/WorkflowEngine/WorkflowResult.php +++ b/lib/WorkflowEngine/WorkflowResult.php @@ -3,6 +3,9 @@ /** * OpenRegister WorkflowResult Value Object * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category WorkflowEngine * @package OCA\OpenRegister\WorkflowEngine * From e3818f869cff53108cac70ceb2d1064cde391f8d Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 15:18:19 +0200 Subject: [PATCH 041/333] =?UTF-8?q?chore(spdx):=20add=20EUPL-1.2=20SPDX=20?= =?UTF-8?q?headers=20=E2=80=94=20Service:=20data=20layer=20(Object,=20File?= =?UTF-8?q?,=20Aggregation,=20Geo,=20Schemas,=20Search)=20(Bucket=204=20re?= =?UTF-8?q?trofit,=20part=202/7)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mechanical sweep: inserts `SPDX-License-Identifier: EUPL-1.2` + `SPDX-FileCopyrightText: 2026 Conduction B.V.` into the existing file docblock of every file in this PR's scope. Per ADR-014 and the convention in existing files (e.g. lib/Service/AvgComplianceService.php). Scope: lib/Service/Object/ (44), lib/Service/File/ (18), lib/Service/Aggregation/ (7), lib/Service/Geo/ (4), lib/Service/Schemas/ (3), lib/Service/Search/ (1) Part of the openregister coverage-scan retrofit (2026-05-24). Companion to PR #1737 (1/7, misc bundle). --- lib/Service/Aggregation/AggregationAnnotationValidator.php | 3 +++ lib/Service/Aggregation/AggregationCache.php | 3 +++ lib/Service/Aggregation/AggregationQuery.php | 3 +++ lib/Service/Aggregation/AggregationRunner.php | 3 +++ .../Aggregation/ElasticsearchAggregationQueryBuilder.php | 3 +++ lib/Service/Aggregation/SolrAggregationQueryBuilder.php | 3 +++ lib/Service/Aggregation/WidgetAnnotationValidator.php | 3 +++ lib/Service/File/CreateFileHandler.php | 3 +++ lib/Service/File/DeleteFileHandler.php | 3 +++ lib/Service/File/DocumentProcessingHandler.php | 3 +++ lib/Service/File/FileAuditHandler.php | 3 +++ lib/Service/File/FileBatchHandler.php | 3 +++ lib/Service/File/FileCrudHandler.php | 3 +++ lib/Service/File/FileFormattingHandler.php | 3 +++ lib/Service/File/FileLockHandler.php | 3 +++ lib/Service/File/FileOwnershipHandler.php | 3 +++ lib/Service/File/FilePreviewHandler.php | 3 +++ lib/Service/File/FilePublishingHandler.php | 3 +++ lib/Service/File/FileSharingHandler.php | 3 +++ lib/Service/File/FileValidationHandler.php | 3 +++ lib/Service/File/FileVersioningHandler.php | 3 +++ lib/Service/File/FolderManagementHandler.php | 3 +++ lib/Service/File/ReadFileHandler.php | 3 +++ lib/Service/File/TaggingHandler.php | 3 +++ lib/Service/File/UpdateFileHandler.php | 3 +++ lib/Service/Geo/GeoFilter.php | 3 +++ lib/Service/Geo/GeoFilterApplier.php | 3 +++ lib/Service/Geo/GeoFilterParser.php | 3 +++ lib/Service/Geo/GeoSpatialEvaluator.php | 3 +++ lib/Service/Object/AuditHandler.php | 3 +++ lib/Service/Object/CacheHandler.php | 3 +++ lib/Service/Object/CascadingHandler.php | 3 +++ lib/Service/Object/CrudHandler.php | 3 +++ lib/Service/Object/DataManipulationHandler.php | 3 +++ lib/Service/Object/DeleteObject.php | 3 +++ lib/Service/Object/ExportHandler.php | 3 +++ lib/Service/Object/FacetHandler.php | 3 +++ lib/Service/Object/GetObject.php | 3 +++ lib/Service/Object/LinkedEntityEnricher.php | 3 +++ lib/Service/Object/LockHandler.php | 3 +++ lib/Service/Object/MergeHandler.php | 3 +++ lib/Service/Object/MetadataHandler.php | 3 +++ lib/Service/Object/MigrationHandler.php | 3 +++ lib/Service/Object/NewFacetingExample.php | 3 +++ lib/Service/Object/ObjectServiceFacetExample.php | 3 +++ lib/Service/Object/PerformanceHandler.php | 3 +++ lib/Service/Object/PerformanceOptimizationHandler.php | 3 +++ lib/Service/Object/PermissionHandler.php | 3 +++ lib/Service/Object/QueryHandler.php | 3 +++ lib/Service/Object/ReferentialIntegrityService.php | 3 +++ lib/Service/Object/RelationHandler.php | 3 +++ lib/Service/Object/RelationshipOptimizationHandler.php | 3 +++ lib/Service/Object/RenderObject.php | 3 +++ lib/Service/Object/RevertHandler.php | 3 +++ lib/Service/Object/SaveObject.php | 3 +++ lib/Service/Object/SaveObject/ComputedFieldHandler.php | 3 +++ lib/Service/Object/SaveObject/FilePropertyHandler.php | 3 +++ lib/Service/Object/SaveObject/LinkedEntityPropertyHandler.php | 3 +++ lib/Service/Object/SaveObject/MetadataHydrationHandler.php | 3 +++ lib/Service/Object/SaveObject/RelationCascadeHandler.php | 3 +++ lib/Service/Object/SaveObjects.php | 3 +++ lib/Service/Object/SaveObjects/BulkRelationHandler.php | 3 +++ lib/Service/Object/SaveObjects/BulkValidationHandler.php | 3 +++ lib/Service/Object/SaveObjects/ChunkProcessingHandler.php | 3 +++ lib/Service/Object/SaveObjects/PreparationHandler.php | 3 +++ lib/Service/Object/SaveObjects/TransformationHandler.php | 3 +++ lib/Service/Object/SchemaTypeConverter.php | 3 +++ lib/Service/Object/SearchQueryHandler.php | 3 +++ lib/Service/Object/TranslationHandler.php | 3 +++ lib/Service/Object/UtilityHandler.php | 3 +++ lib/Service/Object/ValidateObject.php | 3 +++ lib/Service/Object/ValidationHandler.php | 3 +++ lib/Service/Object/VectorizationHandler.php | 3 +++ lib/Service/Schemas/FacetCacheHandler.php | 3 +++ lib/Service/Schemas/PropertyValidatorHandler.php | 3 +++ lib/Service/Schemas/SchemaCacheHandler.php | 3 +++ lib/Service/Search/PlaceholderResolver.php | 3 +++ 77 files changed, 231 insertions(+) diff --git a/lib/Service/Aggregation/AggregationAnnotationValidator.php b/lib/Service/Aggregation/AggregationAnnotationValidator.php index b67ff219ab13..ed3acf50cff2 100644 --- a/lib/Service/Aggregation/AggregationAnnotationValidator.php +++ b/lib/Service/Aggregation/AggregationAnnotationValidator.php @@ -6,6 +6,9 @@ * Schema-save validation for the `x-openregister-aggregations` annotation. * Returns a list of errors; empty = valid. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Aggregation * diff --git a/lib/Service/Aggregation/AggregationCache.php b/lib/Service/Aggregation/AggregationCache.php index f68c367f43f8..46ec01fa1bfc 100644 --- a/lib/Service/Aggregation/AggregationCache.php +++ b/lib/Service/Aggregation/AggregationCache.php @@ -7,6 +7,9 @@ * schema + name + resolved-filters hash + RBAC scope hash. Evicted * by the existing object-write event listeners. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Aggregation * diff --git a/lib/Service/Aggregation/AggregationQuery.php b/lib/Service/Aggregation/AggregationQuery.php index 50d60a76d82d..9f2d1a787fe3 100644 --- a/lib/Service/Aggregation/AggregationQuery.php +++ b/lib/Service/Aggregation/AggregationQuery.php @@ -13,6 +13,9 @@ * gte / lt / lte / ne (mirrors the inline magic-table SQL path that * lived in `AggregationRunner::tryNativeAggregation`). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Aggregation * diff --git a/lib/Service/Aggregation/AggregationRunner.php b/lib/Service/Aggregation/AggregationRunner.php index f2419c0d5844..9d147c833183 100644 --- a/lib/Service/Aggregation/AggregationRunner.php +++ b/lib/Service/Aggregation/AggregationRunner.php @@ -10,6 +10,9 @@ * v1 trades performance for simplicity: backend-native aggregation * (Postgres GROUP BY / Solr facets / ES aggs) ships in a follow-up. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Aggregation * diff --git a/lib/Service/Aggregation/ElasticsearchAggregationQueryBuilder.php b/lib/Service/Aggregation/ElasticsearchAggregationQueryBuilder.php index 10b49c4be0ef..cef1f242350a 100644 --- a/lib/Service/Aggregation/ElasticsearchAggregationQueryBuilder.php +++ b/lib/Service/Aggregation/ElasticsearchAggregationQueryBuilder.php @@ -15,6 +15,9 @@ * Pure-PHP translation. The ES backend wraps a thin HTTP client around * this builder. Unit-testable independently. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Aggregation * diff --git a/lib/Service/Aggregation/SolrAggregationQueryBuilder.php b/lib/Service/Aggregation/SolrAggregationQueryBuilder.php index 332912616527..d0bb6fbbcc2b 100644 --- a/lib/Service/Aggregation/SolrAggregationQueryBuilder.php +++ b/lib/Service/Aggregation/SolrAggregationQueryBuilder.php @@ -15,6 +15,9 @@ * Pure-PHP translation — no HTTP. The Solr backend wraps a thin HTTP * client around this builder. Unit-testable independently. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Aggregation * diff --git a/lib/Service/Aggregation/WidgetAnnotationValidator.php b/lib/Service/Aggregation/WidgetAnnotationValidator.php index e75d772fd852..fe8f87b3b752 100644 --- a/lib/Service/Aggregation/WidgetAnnotationValidator.php +++ b/lib/Service/Aggregation/WidgetAnnotationValidator.php @@ -6,6 +6,9 @@ * Schema-save validation for the `x-openregister-widgets` annotation. * Returns a list of errors; empty = valid. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Aggregation * diff --git a/lib/Service/File/CreateFileHandler.php b/lib/Service/File/CreateFileHandler.php index c952ecb5fa1a..01f8b22f48fe 100644 --- a/lib/Service/File/CreateFileHandler.php +++ b/lib/Service/File/CreateFileHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/DeleteFileHandler.php b/lib/Service/File/DeleteFileHandler.php index 4d8f5664ca83..37dd6511ea7c 100644 --- a/lib/Service/File/DeleteFileHandler.php +++ b/lib/Service/File/DeleteFileHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/DocumentProcessingHandler.php b/lib/Service/File/DocumentProcessingHandler.php index 6870aaea2a79..fb7fda0c0aa8 100644 --- a/lib/Service/File/DocumentProcessingHandler.php +++ b/lib/Service/File/DocumentProcessingHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FileAuditHandler.php b/lib/Service/File/FileAuditHandler.php index 3aac5f0f124d..0bb98850ae49 100644 --- a/lib/Service/File/FileAuditHandler.php +++ b/lib/Service/File/FileAuditHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FileBatchHandler.php b/lib/Service/File/FileBatchHandler.php index 50d7d03c535e..c5e228c387df 100644 --- a/lib/Service/File/FileBatchHandler.php +++ b/lib/Service/File/FileBatchHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FileCrudHandler.php b/lib/Service/File/FileCrudHandler.php index c3f329bb19ba..22839ce25807 100644 --- a/lib/Service/File/FileCrudHandler.php +++ b/lib/Service/File/FileCrudHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FileFormattingHandler.php b/lib/Service/File/FileFormattingHandler.php index 7d24ef5e1b51..f85a7db4f4e4 100644 --- a/lib/Service/File/FileFormattingHandler.php +++ b/lib/Service/File/FileFormattingHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FileLockHandler.php b/lib/Service/File/FileLockHandler.php index a60bd44c400b..8bff54e059ea 100644 --- a/lib/Service/File/FileLockHandler.php +++ b/lib/Service/File/FileLockHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FileOwnershipHandler.php b/lib/Service/File/FileOwnershipHandler.php index 4ffd4ebe4d10..9bac6812769b 100644 --- a/lib/Service/File/FileOwnershipHandler.php +++ b/lib/Service/File/FileOwnershipHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FilePreviewHandler.php b/lib/Service/File/FilePreviewHandler.php index f4dcac00c492..bac1717dee11 100644 --- a/lib/Service/File/FilePreviewHandler.php +++ b/lib/Service/File/FilePreviewHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FilePublishingHandler.php b/lib/Service/File/FilePublishingHandler.php index df3f64a7d212..47ba97483ed5 100644 --- a/lib/Service/File/FilePublishingHandler.php +++ b/lib/Service/File/FilePublishingHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FileSharingHandler.php b/lib/Service/File/FileSharingHandler.php index 0cf0aff9d4a2..bd9abaff8e7d 100644 --- a/lib/Service/File/FileSharingHandler.php +++ b/lib/Service/File/FileSharingHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FileValidationHandler.php b/lib/Service/File/FileValidationHandler.php index a124c13aa111..2792a240b3dd 100644 --- a/lib/Service/File/FileValidationHandler.php +++ b/lib/Service/File/FileValidationHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FileVersioningHandler.php b/lib/Service/File/FileVersioningHandler.php index 1f86fff05581..a3ae3ee69012 100644 --- a/lib/Service/File/FileVersioningHandler.php +++ b/lib/Service/File/FileVersioningHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/FolderManagementHandler.php b/lib/Service/File/FolderManagementHandler.php index 1f67598f615e..fee9090db8c0 100644 --- a/lib/Service/File/FolderManagementHandler.php +++ b/lib/Service/File/FolderManagementHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/ReadFileHandler.php b/lib/Service/File/ReadFileHandler.php index 7015fdecd828..d2bff2853ec0 100644 --- a/lib/Service/File/ReadFileHandler.php +++ b/lib/Service/File/ReadFileHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/TaggingHandler.php b/lib/Service/File/TaggingHandler.php index 80958dce2a89..f9da375ece2c 100644 --- a/lib/Service/File/TaggingHandler.php +++ b/lib/Service/File/TaggingHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/File/UpdateFileHandler.php b/lib/Service/File/UpdateFileHandler.php index 731fa82ee51e..bd6ca1fe5c57 100644 --- a/lib/Service/File/UpdateFileHandler.php +++ b/lib/Service/File/UpdateFileHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Geo/GeoFilter.php b/lib/Service/Geo/GeoFilter.php index 06e35e49f124..8e2ca2f82a63 100644 --- a/lib/Service/Geo/GeoFilter.php +++ b/lib/Service/Geo/GeoFilter.php @@ -15,6 +15,9 @@ * Filters are immutable and constructed via static factory methods so * invalid input fails fast at parse time. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Geo * diff --git a/lib/Service/Geo/GeoFilterApplier.php b/lib/Service/Geo/GeoFilterApplier.php index c07eb7ee0187..aff381ef1497 100644 --- a/lib/Service/Geo/GeoFilterApplier.php +++ b/lib/Service/Geo/GeoFilterApplier.php @@ -11,6 +11,9 @@ * Filter list semantics: AND. A row passes only when every filter * matches. Empty filter list = pass-through. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Geo * diff --git a/lib/Service/Geo/GeoFilterParser.php b/lib/Service/Geo/GeoFilterParser.php index 884acc1fbc7f..fd0b7847fdef 100644 --- a/lib/Service/Geo/GeoFilterParser.php +++ b/lib/Service/Geo/GeoFilterParser.php @@ -11,6 +11,9 @@ * * Either entry returns a list of GeoFilter; the caller AND-composes. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Geo * diff --git a/lib/Service/Geo/GeoSpatialEvaluator.php b/lib/Service/Geo/GeoSpatialEvaluator.php index a60f08f43081..cf21e0787987 100644 --- a/lib/Service/Geo/GeoSpatialEvaluator.php +++ b/lib/Service/Geo/GeoSpatialEvaluator.php @@ -21,6 +21,9 @@ * - Polygon-polygon overlap is approximated as "any vertex of A is in * B, OR any vertex of B is in A". * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Geo * diff --git a/lib/Service/Object/AuditHandler.php b/lib/Service/Object/AuditHandler.php index f2a809ef14b4..72a8f2a14767 100644 --- a/lib/Service/Object/AuditHandler.php +++ b/lib/Service/Object/AuditHandler.php @@ -6,6 +6,9 @@ * Handles audit trail and logging operations for objects. * Tracks all changes and access to objects for compliance and debugging. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Objects\Handlers * diff --git a/lib/Service/Object/CacheHandler.php b/lib/Service/Object/CacheHandler.php index f419e050e56e..bd3340afc035 100644 --- a/lib/Service/Object/CacheHandler.php +++ b/lib/Service/Object/CacheHandler.php @@ -10,6 +10,9 @@ * - Cache warming strategies * - Memory-efficient cache management * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Object/CascadingHandler.php b/lib/Service/Object/CascadingHandler.php index 71d8745e2637..3c319f47a091 100644 --- a/lib/Service/Object/CascadingHandler.php +++ b/lib/Service/Object/CascadingHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/CrudHandler.php b/lib/Service/Object/CrudHandler.php index da2e10c53ab2..5611d31facb5 100644 --- a/lib/Service/Object/CrudHandler.php +++ b/lib/Service/Object/CrudHandler.php @@ -6,6 +6,9 @@ * Handles core CRUD (Create, Read, Update, Delete) operations for objects. * Coordinates between controller and ObjectService for data operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Objects\Handlers * diff --git a/lib/Service/Object/DataManipulationHandler.php b/lib/Service/Object/DataManipulationHandler.php index 5b9d12d91b64..e9c1e561fe67 100644 --- a/lib/Service/Object/DataManipulationHandler.php +++ b/lib/Service/Object/DataManipulationHandler.php @@ -7,6 +7,9 @@ * This handler consolidates utility functions for manipulating object data, * making these operations more testable and maintainable. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Objects * diff --git a/lib/Service/Object/DeleteObject.php b/lib/Service/Object/DeleteObject.php index bf4a0ebdb025..d99698ea8e70 100644 --- a/lib/Service/Object/DeleteObject.php +++ b/lib/Service/Object/DeleteObject.php @@ -12,6 +12,9 @@ * - Maintaining referential integrity * - Tracking deletion operations * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Object/ExportHandler.php b/lib/Service/Object/ExportHandler.php index ee8de0de6625..46f51d3f6578 100644 --- a/lib/Service/Object/ExportHandler.php +++ b/lib/Service/Object/ExportHandler.php @@ -6,6 +6,9 @@ * Handles object export, import, and file download operations. * Coordinates between controller and specialized export/import services. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Objects\Handlers * diff --git a/lib/Service/Object/FacetHandler.php b/lib/Service/Object/FacetHandler.php index 0144a6ebbfb4..0f2c76c28661 100644 --- a/lib/Service/Object/FacetHandler.php +++ b/lib/Service/Object/FacetHandler.php @@ -7,6 +7,9 @@ * with intelligent fallback strategies, response caching, and performance optimization. * Solves the fundamental pagination vs faceting architectural conflict. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Object * @author Conduction Development Team diff --git a/lib/Service/Object/GetObject.php b/lib/Service/Object/GetObject.php index cdbabb6ea71f..99af2988be6c 100644 --- a/lib/Service/Object/GetObject.php +++ b/lib/Service/Object/GetObject.php @@ -12,6 +12,9 @@ * - Handling search operations * - Managing object extensions * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Object/LinkedEntityEnricher.php b/lib/Service/Object/LinkedEntityEnricher.php index f10d3b41ffad..9ab4fa053307 100644 --- a/lib/Service/Object/LinkedEntityEnricher.php +++ b/lib/Service/Object/LinkedEntityEnricher.php @@ -3,6 +3,9 @@ /** * LinkedEntityEnricher * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/LockHandler.php b/lib/Service/Object/LockHandler.php index 0c5079da6eaf..36b65b9f358b 100644 --- a/lib/Service/Object/LockHandler.php +++ b/lib/Service/Object/LockHandler.php @@ -6,6 +6,9 @@ * Handles object locking and unlocking operations. * Locks prevent concurrent modifications to objects. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Objects\Handlers * diff --git a/lib/Service/Object/MergeHandler.php b/lib/Service/Object/MergeHandler.php index e20322c765e9..1ca4b8a49dc4 100644 --- a/lib/Service/Object/MergeHandler.php +++ b/lib/Service/Object/MergeHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/MetadataHandler.php b/lib/Service/Object/MetadataHandler.php index dc3e56724ffc..05be02ebf138 100644 --- a/lib/Service/Object/MetadataHandler.php +++ b/lib/Service/Object/MetadataHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/MigrationHandler.php b/lib/Service/Object/MigrationHandler.php index e8411aff4445..8fcf8ecbb4ce 100644 --- a/lib/Service/Object/MigrationHandler.php +++ b/lib/Service/Object/MigrationHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/NewFacetingExample.php b/lib/Service/Object/NewFacetingExample.php index 0d9ae0fa2f67..99a7ddac123b 100644 --- a/lib/Service/Object/NewFacetingExample.php +++ b/lib/Service/Object/NewFacetingExample.php @@ -6,6 +6,9 @@ * This file contains examples demonstrating the new faceting system * that has replaced the legacy getFacets approach. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Example * @package OCA\OpenRegister\Service\Objects * diff --git a/lib/Service/Object/ObjectServiceFacetExample.php b/lib/Service/Object/ObjectServiceFacetExample.php index 91349f9908b8..63e5854b8b55 100644 --- a/lib/Service/Object/ObjectServiceFacetExample.php +++ b/lib/Service/Object/ObjectServiceFacetExample.php @@ -6,6 +6,9 @@ * This file contains comprehensive examples demonstrating the new faceting * capabilities integrated into the ObjectService, showing both new and legacy approaches. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Example * @package OCA\OpenRegister\Service\Objects * diff --git a/lib/Service/Object/PerformanceHandler.php b/lib/Service/Object/PerformanceHandler.php index 7114589bf365..9c4d994fc2e1 100644 --- a/lib/Service/Object/PerformanceHandler.php +++ b/lib/Service/Object/PerformanceHandler.php @@ -7,6 +7,9 @@ * This handler consolidates performance-related operations from ObjectService, * improving code organization and making optimization logic more maintainable. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Objects * diff --git a/lib/Service/Object/PerformanceOptimizationHandler.php b/lib/Service/Object/PerformanceOptimizationHandler.php index b31362447a93..d78be3671977 100644 --- a/lib/Service/Object/PerformanceOptimizationHandler.php +++ b/lib/Service/Object/PerformanceOptimizationHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/PermissionHandler.php b/lib/Service/Object/PermissionHandler.php index f3c8b279849c..faf46ed88044 100644 --- a/lib/Service/Object/PermissionHandler.php +++ b/lib/Service/Object/PermissionHandler.php @@ -7,6 +7,9 @@ * This handler centralizes authorization logic that was previously scattered * throughout ObjectService, making security policies more maintainable. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Objects * diff --git a/lib/Service/Object/QueryHandler.php b/lib/Service/Object/QueryHandler.php index 99b83a88a596..64206501b914 100644 --- a/lib/Service/Object/QueryHandler.php +++ b/lib/Service/Object/QueryHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/ReferentialIntegrityService.php b/lib/Service/Object/ReferentialIntegrityService.php index 32752cd177b9..cb1c8007a79a 100644 --- a/lib/Service/Object/ReferentialIntegrityService.php +++ b/lib/Service/Object/ReferentialIntegrityService.php @@ -8,6 +8,9 @@ * blockers (RESTRICT) and cascade targets, and applies mutations (CASCADE, SET_NULL, * SET_DEFAULT) when deletion proceeds. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Object * diff --git a/lib/Service/Object/RelationHandler.php b/lib/Service/Object/RelationHandler.php index eedaeba9bc63..2ca9b01ef879 100644 --- a/lib/Service/Object/RelationHandler.php +++ b/lib/Service/Object/RelationHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/RelationshipOptimizationHandler.php b/lib/Service/Object/RelationshipOptimizationHandler.php index 19826dd0c278..a8e3bbebf109 100644 --- a/lib/Service/Object/RelationshipOptimizationHandler.php +++ b/lib/Service/Object/RelationshipOptimizationHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/RenderObject.php b/lib/Service/Object/RenderObject.php index b155a239063d..21961e52964d 100644 --- a/lib/Service/Object/RenderObject.php +++ b/lib/Service/Object/RenderObject.php @@ -11,6 +11,9 @@ * - Applying field filtering and selection * - Formatting object properties for display * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Object/RevertHandler.php b/lib/Service/Object/RevertHandler.php index 754325b6b03d..521a6730d3da 100644 --- a/lib/Service/Object/RevertHandler.php +++ b/lib/Service/Object/RevertHandler.php @@ -5,6 +5,9 @@ * * Service class for handling object reversion in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Object/SaveObject.php b/lib/Service/Object/SaveObject.php index ab2727aaa951..85f1a2701ca5 100644 --- a/lib/Service/Object/SaveObject.php +++ b/lib/Service/Object/SaveObject.php @@ -12,6 +12,9 @@ * - Maintaining audit trails (user tracking) * - Setting default values and properties * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Object/SaveObject/ComputedFieldHandler.php b/lib/Service/Object/SaveObject/ComputedFieldHandler.php index 5940cbe6ab29..6db0039aa75f 100644 --- a/lib/Service/Object/SaveObject/ComputedFieldHandler.php +++ b/lib/Service/Object/SaveObject/ComputedFieldHandler.php @@ -7,6 +7,9 @@ * Supports save-time and read-time evaluation of Twig expressions * defined in schema property `computed` attributes. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Objects\SaveObject * diff --git a/lib/Service/Object/SaveObject/FilePropertyHandler.php b/lib/Service/Object/SaveObject/FilePropertyHandler.php index d28a213e084d..25692f257c36 100644 --- a/lib/Service/Object/SaveObject/FilePropertyHandler.php +++ b/lib/Service/Object/SaveObject/FilePropertyHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/SaveObject/LinkedEntityPropertyHandler.php b/lib/Service/Object/SaveObject/LinkedEntityPropertyHandler.php index babda6d37ec9..799e362b4b5d 100644 --- a/lib/Service/Object/SaveObject/LinkedEntityPropertyHandler.php +++ b/lib/Service/Object/SaveObject/LinkedEntityPropertyHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/SaveObject/MetadataHydrationHandler.php b/lib/Service/Object/SaveObject/MetadataHydrationHandler.php index b94037a7514d..f2397cbcc9bc 100644 --- a/lib/Service/Object/SaveObject/MetadataHydrationHandler.php +++ b/lib/Service/Object/SaveObject/MetadataHydrationHandler.php @@ -6,6 +6,9 @@ * Handler for extracting and hydrating object metadata. * Handles name, description, summary, image extraction, and slug generation. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Objects\SaveObject * diff --git a/lib/Service/Object/SaveObject/RelationCascadeHandler.php b/lib/Service/Object/SaveObject/RelationCascadeHandler.php index 9db420b82d70..2e27a538cd52 100644 --- a/lib/Service/Object/SaveObject/RelationCascadeHandler.php +++ b/lib/Service/Object/SaveObject/RelationCascadeHandler.php @@ -6,6 +6,9 @@ * Handler for managing object relations and cascading operations. * Handles schema resolution, relation scanning, and cascading object creation. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Objects\SaveObject * diff --git a/lib/Service/Object/SaveObjects.php b/lib/Service/Object/SaveObjects.php index c8abfcce8415..9033f6fe1320 100644 --- a/lib/Service/Object/SaveObjects.php +++ b/lib/Service/Object/SaveObjects.php @@ -43,6 +43,9 @@ * - Time complexity: O(N*M*P) → O(N*M) * - Processing speed: 2-3x faster for large datasets * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\ObjectHandlers * @author Conduction Development Team diff --git a/lib/Service/Object/SaveObjects/BulkRelationHandler.php b/lib/Service/Object/SaveObjects/BulkRelationHandler.php index 0c61f084bc95..76e6c998385f 100644 --- a/lib/Service/Object/SaveObjects/BulkRelationHandler.php +++ b/lib/Service/Object/SaveObjects/BulkRelationHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/SaveObjects/BulkValidationHandler.php b/lib/Service/Object/SaveObjects/BulkValidationHandler.php index f89f9222bf0f..798db3142747 100644 --- a/lib/Service/Object/SaveObjects/BulkValidationHandler.php +++ b/lib/Service/Object/SaveObjects/BulkValidationHandler.php @@ -6,6 +6,9 @@ * Handler for bulk validation operations and schema analysis. * Optimizes validation for bulk object operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Objects\SaveObjects * diff --git a/lib/Service/Object/SaveObjects/ChunkProcessingHandler.php b/lib/Service/Object/SaveObjects/ChunkProcessingHandler.php index 78e1748c2e2c..20a946db5b87 100644 --- a/lib/Service/Object/SaveObjects/ChunkProcessingHandler.php +++ b/lib/Service/Object/SaveObjects/ChunkProcessingHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/SaveObjects/PreparationHandler.php b/lib/Service/Object/SaveObjects/PreparationHandler.php index 464b9d75225a..b9ea7a909850 100644 --- a/lib/Service/Object/SaveObjects/PreparationHandler.php +++ b/lib/Service/Object/SaveObjects/PreparationHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/SaveObjects/TransformationHandler.php b/lib/Service/Object/SaveObjects/TransformationHandler.php index ebb1340bc29f..12bb7fc3a633 100644 --- a/lib/Service/Object/SaveObjects/TransformationHandler.php +++ b/lib/Service/Object/SaveObjects/TransformationHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/SchemaTypeConverter.php b/lib/Service/Object/SchemaTypeConverter.php index 02de882218bd..24b3925f2911 100644 --- a/lib/Service/Object/SchemaTypeConverter.php +++ b/lib/Service/Object/SchemaTypeConverter.php @@ -9,6 +9,9 @@ * * Contract spec: openspec/specs/schema-driven-read-coercion/spec.md * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Object * @author Conduction Development Team diff --git a/lib/Service/Object/SearchQueryHandler.php b/lib/Service/Object/SearchQueryHandler.php index 718807e0d200..6abe084700dc 100644 --- a/lib/Service/Object/SearchQueryHandler.php +++ b/lib/Service/Object/SearchQueryHandler.php @@ -7,6 +7,9 @@ * This handler separates search-related business logic from the main ObjectService, * improving code organization and maintainability. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Objects * diff --git a/lib/Service/Object/TranslationHandler.php b/lib/Service/Object/TranslationHandler.php index fdb4e9ad8950..421a78fce333 100644 --- a/lib/Service/Object/TranslationHandler.php +++ b/lib/Service/Object/TranslationHandler.php @@ -7,6 +7,9 @@ * Supports both reading (selecting the correct language variant) and writing * (normalizing input to language-keyed objects) for translatable properties. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Object * diff --git a/lib/Service/Object/UtilityHandler.php b/lib/Service/Object/UtilityHandler.php index d7849d7452fd..9e16b0774dc2 100644 --- a/lib/Service/Object/UtilityHandler.php +++ b/lib/Service/Object/UtilityHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/ValidateObject.php b/lib/Service/Object/ValidateObject.php index cad3cc9444b7..5ba1561e2d62 100644 --- a/lib/Service/Object/ValidateObject.php +++ b/lib/Service/Object/ValidateObject.php @@ -12,6 +12,9 @@ * - Support for external schema references * - Format validation (e.g., BSN numbers) * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Object/ValidationHandler.php b/lib/Service/Object/ValidationHandler.php index 5e6c34a54d03..d37b916015bf 100644 --- a/lib/Service/Object/ValidationHandler.php +++ b/lib/Service/Object/ValidationHandler.php @@ -5,6 +5,9 @@ * * This file is part of the OpenRegister app for Nextcloud. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/Object/VectorizationHandler.php b/lib/Service/Object/VectorizationHandler.php index 65e6300f2d6d..00d614d11359 100644 --- a/lib/Service/Object/VectorizationHandler.php +++ b/lib/Service/Object/VectorizationHandler.php @@ -6,6 +6,9 @@ * Handles vectorization operations for objects. * Acts as a bridge between ObjectsController and VectorizationService. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Objects\Handlers * diff --git a/lib/Service/Schemas/FacetCacheHandler.php b/lib/Service/Schemas/FacetCacheHandler.php index ac590f69a283..5c73845061db 100644 --- a/lib/Service/Schemas/FacetCacheHandler.php +++ b/lib/Service/Schemas/FacetCacheHandler.php @@ -9,6 +9,9 @@ * Since facets are determined by schema properties, they can be cached and * invalidated when schemas change, providing significant performance benefits. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Schemas/PropertyValidatorHandler.php b/lib/Service/Schemas/PropertyValidatorHandler.php index e53c03e01fde..299cc31cb737 100644 --- a/lib/Service/Schemas/PropertyValidatorHandler.php +++ b/lib/Service/Schemas/PropertyValidatorHandler.php @@ -6,6 +6,9 @@ * This file contains the class for validating schema properties * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Schemas/SchemaCacheHandler.php b/lib/Service/Schemas/SchemaCacheHandler.php index b833c152cb6b..9cd80b65034f 100644 --- a/lib/Service/Schemas/SchemaCacheHandler.php +++ b/lib/Service/Schemas/SchemaCacheHandler.php @@ -9,6 +9,9 @@ * computed properties like facetable fields, validation rules, and configuration. * It automatically invalidates cache when schemas are updated. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Schemas * diff --git a/lib/Service/Search/PlaceholderResolver.php b/lib/Service/Search/PlaceholderResolver.php index 2c3acd41cd53..6e9c888c773b 100644 --- a/lib/Service/Search/PlaceholderResolver.php +++ b/lib/Service/Search/PlaceholderResolver.php @@ -7,6 +7,9 @@ * annotation values. Shared by the parallel `aggregations-annotation` * and `calculations-annotation` changes so both write the same DSL. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Search * From 482b49f475660a683460115cfbb3452e6feef7ad Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 15:18:30 +0200 Subject: [PATCH 042/333] =?UTF-8?q?chore(spdx):=20add=20EUPL-1.2=20SPDX=20?= =?UTF-8?q?headers=20=E2=80=94=20Service:=20pipelines=20+=20integrations?= =?UTF-8?q?=20(Bucket=204=20retrofit,=20part=203/7)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mechanical sweep: inserts `SPDX-License-Identifier: EUPL-1.2` + `SPDX-FileCopyrightText: 2026 Conduction B.V.` into the existing file docblock of every file in this PR's scope. Per ADR-014 and the convention in existing files (e.g. lib/Service/AvgComplianceService.php). Scope: lib/Service/Index/ (23), lib/Service/Vectorization/ (8), lib/Service/Notification/ (9), lib/Service/Edepot/ (9), lib/Service/Integration/ (7), lib/Service/Chat/ (5), lib/Service/Handler/ (5), lib/Service/TextExtraction/ (4), lib/Service/Calculation/ (3), lib/Service/Mcp/ (3), lib/Service/Translation/ (3), lib/Service/Webhook/ (1) Part of the openregister coverage-scan retrofit (2026-05-24). Companion to PR #1737 (1/7, misc bundle). --- lib/Service/Calculation/CalculationAnnotationValidator.php | 3 +++ lib/Service/Calculation/CalculationEvaluator.php | 3 +++ lib/Service/Calculation/EvaluationException.php | 3 +++ lib/Service/Chat/ContextRetrievalHandler.php | 3 +++ lib/Service/Chat/ConversationManagementHandler.php | 3 +++ lib/Service/Chat/MessageHistoryHandler.php | 3 +++ lib/Service/Chat/ResponseGenerationHandler.php | 3 +++ lib/Service/Chat/ToolManagementHandler.php | 3 +++ lib/Service/Edepot/EdepotTransferService.php | 3 +++ lib/Service/Edepot/MdtoXmlGenerator.php | 3 +++ lib/Service/Edepot/SipPackageBuilder.php | 3 +++ lib/Service/Edepot/TransferListService.php | 3 +++ lib/Service/Edepot/Transport/OpenConnectorTransport.php | 3 +++ lib/Service/Edepot/Transport/RestApiTransport.php | 3 +++ lib/Service/Edepot/Transport/SftpTransport.php | 3 +++ lib/Service/Edepot/Transport/TransportInterface.php | 3 +++ lib/Service/Edepot/Transport/TransportResult.php | 3 +++ lib/Service/Handler/AgentHandler.php | 3 +++ lib/Service/Handler/ApplicationHandler.php | 3 +++ lib/Service/Handler/OrganisationHandler.php | 3 +++ lib/Service/Handler/SourceHandler.php | 3 +++ lib/Service/Handler/ViewHandler.php | 3 +++ .../Backends/Elasticsearch/ElasticsearchDocumentIndexer.php | 3 +++ .../Index/Backends/Elasticsearch/ElasticsearchHttpClient.php | 3 +++ .../Index/Backends/Elasticsearch/ElasticsearchIndexManager.php | 3 +++ .../Backends/Elasticsearch/ElasticsearchQueryExecutor.php | 3 +++ lib/Service/Index/Backends/ElasticsearchBackend.php | 3 +++ lib/Service/Index/Backends/Solr/SolrCollectionManager.php | 3 +++ lib/Service/Index/Backends/Solr/SolrDocumentIndexer.php | 3 +++ lib/Service/Index/Backends/Solr/SolrFacetProcessor.php | 3 +++ lib/Service/Index/Backends/Solr/SolrHttpClient.php | 3 +++ lib/Service/Index/Backends/Solr/SolrQueryExecutor.php | 3 +++ lib/Service/Index/Backends/Solr/SolrSchemaManager.php | 3 +++ lib/Service/Index/Backends/SolrBackend.php | 3 +++ lib/Service/Index/BulkIndexer.php | 3 +++ lib/Service/Index/ConfigurationHandler.php | 3 +++ lib/Service/Index/DocumentBuilder.php | 3 +++ lib/Service/Index/FacetBuilder.php | 3 +++ lib/Service/Index/FileHandler.php | 3 +++ lib/Service/Index/ObjectHandler.php | 3 +++ lib/Service/Index/SchemaHandler.php | 3 +++ lib/Service/Index/SchemaMapper.php | 3 +++ lib/Service/Index/SearchBackendInterface.php | 3 +++ lib/Service/Index/SetupHandler.php | 3 +++ lib/Service/Index/WarmupHandler.php | 3 +++ lib/Service/Integration/Providers/CalendarProvider.php | 3 +++ lib/Service/Integration/Providers/ContactsProvider.php | 3 +++ lib/Service/Integration/Providers/DeckProvider.php | 3 +++ lib/Service/Integration/Providers/EmailProvider.php | 3 +++ lib/Service/Integration/Providers/OpenProjectProvider.php | 3 +++ lib/Service/Integration/Providers/PollsProvider.php | 3 +++ lib/Service/Integration/Providers/TalkProvider.php | 3 +++ lib/Service/Mcp/McpProtocolService.php | 3 +++ lib/Service/Mcp/McpResourcesService.php | 3 +++ lib/Service/Mcp/McpToolsService.php | 3 +++ lib/Service/Notification/AnnotationNotificationDispatcher.php | 3 +++ lib/Service/Notification/NotificationAnnotationValidator.php | 3 +++ lib/Service/Notification/NotificationCoalescer.php | 3 +++ lib/Service/Notification/NotificationDigest.php | 3 +++ lib/Service/Notification/NotificationReadState.php | 3 +++ lib/Service/Notification/NotificationsAnnotationInstaller.php | 3 +++ lib/Service/Notification/RateLimiter.php | 3 +++ lib/Service/Notification/RecipientResolverInterface.php | 3 +++ lib/Service/Notification/VngNotificatiesEnvelope.php | 3 +++ lib/Service/TextExtraction/EntityRecognitionHandler.php | 3 +++ lib/Service/TextExtraction/FileHandler.php | 3 +++ lib/Service/TextExtraction/ObjectHandler.php | 3 +++ lib/Service/TextExtraction/TextExtractionHandlerInterface.php | 3 +++ lib/Service/Translation/IdentityTranslationProvider.php | 3 +++ lib/Service/Translation/TranslationCsvCodec.php | 3 +++ lib/Service/Translation/TranslationProviderInterface.php | 3 +++ .../Vectorization/Handlers/EmbeddingGeneratorHandler.php | 3 +++ lib/Service/Vectorization/Handlers/VectorSearchHandler.php | 3 +++ lib/Service/Vectorization/Handlers/VectorStatsHandler.php | 3 +++ lib/Service/Vectorization/Handlers/VectorStorageHandler.php | 3 +++ .../Vectorization/Strategies/FileVectorizationStrategy.php | 3 +++ .../Vectorization/Strategies/ObjectVectorizationStrategy.php | 3 +++ .../Strategies/VectorizationStrategyInterface.php | 3 +++ lib/Service/Vectorization/VectorEmbeddings.php | 3 +++ lib/Service/Webhook/CloudEventFormatter.php | 3 +++ 80 files changed, 240 insertions(+) diff --git a/lib/Service/Calculation/CalculationAnnotationValidator.php b/lib/Service/Calculation/CalculationAnnotationValidator.php index 44baa56ee560..9b8c3d2ed7ec 100644 --- a/lib/Service/Calculation/CalculationAnnotationValidator.php +++ b/lib/Service/Calculation/CalculationAnnotationValidator.php @@ -5,6 +5,9 @@ * * Schema-save validation for the `x-openregister-calculations` annotation. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Calculation * diff --git a/lib/Service/Calculation/CalculationEvaluator.php b/lib/Service/Calculation/CalculationEvaluator.php index 86d09dc39bff..5db6bffe08d5 100644 --- a/lib/Service/Calculation/CalculationEvaluator.php +++ b/lib/Service/Calculation/CalculationEvaluator.php @@ -7,6 +7,9 @@ * DB access, no HTTP. Inputs: object payload + expression. Output: * typed value or EvaluationException. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Calculation * diff --git a/lib/Service/Calculation/EvaluationException.php b/lib/Service/Calculation/EvaluationException.php index 4e29fb2435fb..16f651a77ca7 100644 --- a/lib/Service/Calculation/EvaluationException.php +++ b/lib/Service/Calculation/EvaluationException.php @@ -5,6 +5,9 @@ * * Thrown by CalculationEvaluator when an expression cannot be reduced. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Calculation * diff --git a/lib/Service/Chat/ContextRetrievalHandler.php b/lib/Service/Chat/ContextRetrievalHandler.php index aec7d6b24f83..3c61bde3c56c 100644 --- a/lib/Service/Chat/ContextRetrievalHandler.php +++ b/lib/Service/Chat/ContextRetrievalHandler.php @@ -6,6 +6,9 @@ * Handler for RAG (Retrieval Augmented Generation) context retrieval. * Manages semantic search, keyword search, and source extraction for chat context. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Chat * diff --git a/lib/Service/Chat/ConversationManagementHandler.php b/lib/Service/Chat/ConversationManagementHandler.php index c180957211b1..e6eb482ae29f 100644 --- a/lib/Service/Chat/ConversationManagementHandler.php +++ b/lib/Service/Chat/ConversationManagementHandler.php @@ -6,6 +6,9 @@ * Handler for conversation lifecycle management. * Manages conversation titles, summaries, and history management. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Chat * diff --git a/lib/Service/Chat/MessageHistoryHandler.php b/lib/Service/Chat/MessageHistoryHandler.php index fd3f10a3a062..a2640c038c09 100644 --- a/lib/Service/Chat/MessageHistoryHandler.php +++ b/lib/Service/Chat/MessageHistoryHandler.php @@ -5,6 +5,9 @@ * * Handler for message storage and history management. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Chat * diff --git a/lib/Service/Chat/ResponseGenerationHandler.php b/lib/Service/Chat/ResponseGenerationHandler.php index 64cc7901a539..01d79ce4779a 100644 --- a/lib/Service/Chat/ResponseGenerationHandler.php +++ b/lib/Service/Chat/ResponseGenerationHandler.php @@ -16,6 +16,9 @@ * exactly as before — that branch is load-bearing for the * non-streaming endpoint and must not regress. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Chat * diff --git a/lib/Service/Chat/ToolManagementHandler.php b/lib/Service/Chat/ToolManagementHandler.php index df995f255f4f..75b8cac88ab2 100644 --- a/lib/Service/Chat/ToolManagementHandler.php +++ b/lib/Service/Chat/ToolManagementHandler.php @@ -5,6 +5,9 @@ * * Handler for LLM tool/function calling management. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Chat * diff --git a/lib/Service/Edepot/EdepotTransferService.php b/lib/Service/Edepot/EdepotTransferService.php index 1f5a22d6f99a..b2bf06f7e469 100644 --- a/lib/Service/Edepot/EdepotTransferService.php +++ b/lib/Service/Edepot/EdepotTransferService.php @@ -6,6 +6,9 @@ * Orchestrates the full e-Depot transfer pipeline: SIP package building, * transport, object status tracking, and audit trail logging. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Edepot * diff --git a/lib/Service/Edepot/MdtoXmlGenerator.php b/lib/Service/Edepot/MdtoXmlGenerator.php index d31e80a66c0e..3f4eb328185a 100644 --- a/lib/Service/Edepot/MdtoXmlGenerator.php +++ b/lib/Service/Edepot/MdtoXmlGenerator.php @@ -7,6 +7,9 @@ * Conforms to the MDTO (Metagegevens Duurzaam Toegankelijke Overheidsinformatie) * schema version 1.0 or later. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Edepot * diff --git a/lib/Service/Edepot/SipPackageBuilder.php b/lib/Service/Edepot/SipPackageBuilder.php index bc868f3e6dca..d420e7fa71f5 100644 --- a/lib/Service/Edepot/SipPackageBuilder.php +++ b/lib/Service/Edepot/SipPackageBuilder.php @@ -6,6 +6,9 @@ * Assembles SIP (Submission Information Package) archives conforming to the * OAIS reference model (ISO 14721) for e-Depot transfer. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Edepot * diff --git a/lib/Service/Edepot/TransferListService.php b/lib/Service/Edepot/TransferListService.php index 038d594a1157..af3e23c32978 100644 --- a/lib/Service/Edepot/TransferListService.php +++ b/lib/Service/Edepot/TransferListService.php @@ -5,6 +5,9 @@ * * Manages transfer lists for e-Depot overbrenging workflow. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Edepot * diff --git a/lib/Service/Edepot/Transport/OpenConnectorTransport.php b/lib/Service/Edepot/Transport/OpenConnectorTransport.php index 20d6e8ed366a..478a13857920 100644 --- a/lib/Service/Edepot/Transport/OpenConnectorTransport.php +++ b/lib/Service/Edepot/Transport/OpenConnectorTransport.php @@ -5,6 +5,9 @@ * * Transmits SIP packages to e-Depot systems via OpenConnector synchronization. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Edepot\Transport * diff --git a/lib/Service/Edepot/Transport/RestApiTransport.php b/lib/Service/Edepot/Transport/RestApiTransport.php index 4bdd69ee34dd..b0c2f8362f17 100644 --- a/lib/Service/Edepot/Transport/RestApiTransport.php +++ b/lib/Service/Edepot/Transport/RestApiTransport.php @@ -5,6 +5,9 @@ * * Transmits SIP packages to e-Depot systems via REST API. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Edepot\Transport * diff --git a/lib/Service/Edepot/Transport/SftpTransport.php b/lib/Service/Edepot/Transport/SftpTransport.php index f59aafaaa033..2a3ee8de6a3e 100644 --- a/lib/Service/Edepot/Transport/SftpTransport.php +++ b/lib/Service/Edepot/Transport/SftpTransport.php @@ -5,6 +5,9 @@ * * Transmits SIP packages to e-Depot systems via SFTP. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Edepot\Transport * diff --git a/lib/Service/Edepot/Transport/TransportInterface.php b/lib/Service/Edepot/Transport/TransportInterface.php index a278ff628798..b4194e0a8fdd 100644 --- a/lib/Service/Edepot/Transport/TransportInterface.php +++ b/lib/Service/Edepot/Transport/TransportInterface.php @@ -5,6 +5,9 @@ * * Defines the contract for SIP package transport implementations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Edepot\Transport * diff --git a/lib/Service/Edepot/Transport/TransportResult.php b/lib/Service/Edepot/Transport/TransportResult.php index f6b5a4395e87..4a43bf908af1 100644 --- a/lib/Service/Edepot/Transport/TransportResult.php +++ b/lib/Service/Edepot/Transport/TransportResult.php @@ -5,6 +5,9 @@ * * Value object representing the result of a SIP transport operation. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Edepot\Transport * diff --git a/lib/Service/Handler/AgentHandler.php b/lib/Service/Handler/AgentHandler.php index 1bb9055fe693..3c248831d6c8 100644 --- a/lib/Service/Handler/AgentHandler.php +++ b/lib/Service/Handler/AgentHandler.php @@ -5,6 +5,9 @@ * * This file contains the handler class for Agent entity import/export operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Handler * diff --git a/lib/Service/Handler/ApplicationHandler.php b/lib/Service/Handler/ApplicationHandler.php index e7c864973885..42c9dd30479d 100644 --- a/lib/Service/Handler/ApplicationHandler.php +++ b/lib/Service/Handler/ApplicationHandler.php @@ -5,6 +5,9 @@ * * This file contains the handler class for Application entity import/export operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Handler * diff --git a/lib/Service/Handler/OrganisationHandler.php b/lib/Service/Handler/OrganisationHandler.php index f8b284275d3d..c8b80e196d63 100644 --- a/lib/Service/Handler/OrganisationHandler.php +++ b/lib/Service/Handler/OrganisationHandler.php @@ -5,6 +5,9 @@ * * This file contains the handler class for Organisation entity import/export operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Handler * diff --git a/lib/Service/Handler/SourceHandler.php b/lib/Service/Handler/SourceHandler.php index ce9904d69c34..fdbeb5b27634 100644 --- a/lib/Service/Handler/SourceHandler.php +++ b/lib/Service/Handler/SourceHandler.php @@ -5,6 +5,9 @@ * * This file contains the handler class for Source entity import/export operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Handler * diff --git a/lib/Service/Handler/ViewHandler.php b/lib/Service/Handler/ViewHandler.php index 11c6fefdf405..15792ab2de1d 100644 --- a/lib/Service/Handler/ViewHandler.php +++ b/lib/Service/Handler/ViewHandler.php @@ -5,6 +5,9 @@ * * This file contains the handler class for View entity import/export operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Handler * diff --git a/lib/Service/Index/Backends/Elasticsearch/ElasticsearchDocumentIndexer.php b/lib/Service/Index/Backends/Elasticsearch/ElasticsearchDocumentIndexer.php index 96568260ccd2..5d25b4ea7f77 100644 --- a/lib/Service/Index/Backends/Elasticsearch/ElasticsearchDocumentIndexer.php +++ b/lib/Service/Index/Backends/Elasticsearch/ElasticsearchDocumentIndexer.php @@ -5,6 +5,9 @@ * * Handles document indexing operations to Elasticsearch. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends\Elasticsearch * @author Conduction Development Team diff --git a/lib/Service/Index/Backends/Elasticsearch/ElasticsearchHttpClient.php b/lib/Service/Index/Backends/Elasticsearch/ElasticsearchHttpClient.php index 87d693d23ecf..fa795094de38 100644 --- a/lib/Service/Index/Backends/Elasticsearch/ElasticsearchHttpClient.php +++ b/lib/Service/Index/Backends/Elasticsearch/ElasticsearchHttpClient.php @@ -5,6 +5,9 @@ * * Handles HTTP client configuration and basic HTTP operations for Elasticsearch. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends\Elasticsearch * @author Conduction Development Team diff --git a/lib/Service/Index/Backends/Elasticsearch/ElasticsearchIndexManager.php b/lib/Service/Index/Backends/Elasticsearch/ElasticsearchIndexManager.php index e017e2952c7c..f4ca5d3fc777 100644 --- a/lib/Service/Index/Backends/Elasticsearch/ElasticsearchIndexManager.php +++ b/lib/Service/Index/Backends/Elasticsearch/ElasticsearchIndexManager.php @@ -5,6 +5,9 @@ * * Manages Elasticsearch indices. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends\Elasticsearch * @author Conduction Development Team diff --git a/lib/Service/Index/Backends/Elasticsearch/ElasticsearchQueryExecutor.php b/lib/Service/Index/Backends/Elasticsearch/ElasticsearchQueryExecutor.php index 9594c2fd691a..d969218ff2a9 100644 --- a/lib/Service/Index/Backends/Elasticsearch/ElasticsearchQueryExecutor.php +++ b/lib/Service/Index/Backends/Elasticsearch/ElasticsearchQueryExecutor.php @@ -5,6 +5,9 @@ * * Manages search queries and execution for Elasticsearch. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends\Elasticsearch * @author Conduction Development Team diff --git a/lib/Service/Index/Backends/ElasticsearchBackend.php b/lib/Service/Index/Backends/ElasticsearchBackend.php index 3607d15492d3..5ea2718c7502 100644 --- a/lib/Service/Index/Backends/ElasticsearchBackend.php +++ b/lib/Service/Index/Backends/ElasticsearchBackend.php @@ -5,6 +5,9 @@ * * Elasticsearch backend implementation for OpenRegister search operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends * @author Conduction Development Team diff --git a/lib/Service/Index/Backends/Solr/SolrCollectionManager.php b/lib/Service/Index/Backends/Solr/SolrCollectionManager.php index bff975ea4de5..c14ff48ecfd5 100644 --- a/lib/Service/Index/Backends/Solr/SolrCollectionManager.php +++ b/lib/Service/Index/Backends/Solr/SolrCollectionManager.php @@ -6,6 +6,9 @@ * Manages Solr collections and ConfigSets. * Handles creation, deletion, and existence checks for collections. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends\Solr * @author Conduction Development Team diff --git a/lib/Service/Index/Backends/Solr/SolrDocumentIndexer.php b/lib/Service/Index/Backends/Solr/SolrDocumentIndexer.php index 2702e8636481..2912bb348194 100644 --- a/lib/Service/Index/Backends/Solr/SolrDocumentIndexer.php +++ b/lib/Service/Index/Backends/Solr/SolrDocumentIndexer.php @@ -6,6 +6,9 @@ * Handles document indexing operations to Solr. * Manages single and bulk indexing, deletions, and commits. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends\Solr * @author Conduction Development Team diff --git a/lib/Service/Index/Backends/Solr/SolrFacetProcessor.php b/lib/Service/Index/Backends/Solr/SolrFacetProcessor.php index 282a90ad6714..2a72ec44d4b6 100644 --- a/lib/Service/Index/Backends/Solr/SolrFacetProcessor.php +++ b/lib/Service/Index/Backends/Solr/SolrFacetProcessor.php @@ -6,6 +6,9 @@ * Handles facet processing operations for Solr. * Manages facet discovery, building, and formatting. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends\Solr * @author Conduction Development Team diff --git a/lib/Service/Index/Backends/Solr/SolrHttpClient.php b/lib/Service/Index/Backends/Solr/SolrHttpClient.php index 18b5ae2bfae2..e63b8c0c5f24 100644 --- a/lib/Service/Index/Backends/Solr/SolrHttpClient.php +++ b/lib/Service/Index/Backends/Solr/SolrHttpClient.php @@ -6,6 +6,9 @@ * Handles HTTP client configuration and basic HTTP operations for Solr. * Responsible for building URLs, managing HTTP client, and making requests. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends\Solr * @author Conduction Development Team diff --git a/lib/Service/Index/Backends/Solr/SolrQueryExecutor.php b/lib/Service/Index/Backends/Solr/SolrQueryExecutor.php index 424e2894600d..8988f3650f07 100644 --- a/lib/Service/Index/Backends/Solr/SolrQueryExecutor.php +++ b/lib/Service/Index/Backends/Solr/SolrQueryExecutor.php @@ -6,6 +6,9 @@ * Handles query execution and search operations for Solr. * Manages query building, execution, and result parsing. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends\Solr * @author Conduction Development Team diff --git a/lib/Service/Index/Backends/Solr/SolrSchemaManager.php b/lib/Service/Index/Backends/Solr/SolrSchemaManager.php index f0e0d58f859f..1403737ff96b 100644 --- a/lib/Service/Index/Backends/Solr/SolrSchemaManager.php +++ b/lib/Service/Index/Backends/Solr/SolrSchemaManager.php @@ -6,6 +6,9 @@ * Manages Solr schema operations. * Handles field types, field management, and schema synchronization. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends\Solr * @author Conduction Development Team diff --git a/lib/Service/Index/Backends/SolrBackend.php b/lib/Service/Index/Backends/SolrBackend.php index e2d241208605..b18eaf6430c6 100644 --- a/lib/Service/Index/Backends/SolrBackend.php +++ b/lib/Service/Index/Backends/SolrBackend.php @@ -6,6 +6,9 @@ * Solr backend implementation for OpenRegister search operations. * Coordinates specialized Solr service classes to provide SearchBackendInterface. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index\Backends * @author Conduction Development Team diff --git a/lib/Service/Index/BulkIndexer.php b/lib/Service/Index/BulkIndexer.php index 391b49283df5..6518a0ad606e 100644 --- a/lib/Service/Index/BulkIndexer.php +++ b/lib/Service/Index/BulkIndexer.php @@ -6,6 +6,9 @@ * Handles bulk indexing business logic (batching, parallel processing, optimization). * Does NOT contain backend-specific I/O - delegates to SearchBackendInterface. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index * @author Conduction Development Team diff --git a/lib/Service/Index/ConfigurationHandler.php b/lib/Service/Index/ConfigurationHandler.php index 9ea7c534b521..ec2eb91b0091 100644 --- a/lib/Service/Index/ConfigurationHandler.php +++ b/lib/Service/Index/ConfigurationHandler.php @@ -5,6 +5,9 @@ * * Handles Solr configuration initialization, validation, and management. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Index * diff --git a/lib/Service/Index/DocumentBuilder.php b/lib/Service/Index/DocumentBuilder.php index 40fb11eeb058..dd895a5c07d5 100644 --- a/lib/Service/Index/DocumentBuilder.php +++ b/lib/Service/Index/DocumentBuilder.php @@ -6,6 +6,9 @@ * Handles building Solr documents from ObjectEntity instances. * Extracted from SolrBackend to separate document creation logic. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index * @author Conduction Development Team diff --git a/lib/Service/Index/FacetBuilder.php b/lib/Service/Index/FacetBuilder.php index b40cbd29468f..7ef1944633c5 100644 --- a/lib/Service/Index/FacetBuilder.php +++ b/lib/Service/Index/FacetBuilder.php @@ -6,6 +6,9 @@ * Handles Solr facet building operations. * Extracted from GuzzleSolrService to separate facet logic. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index * @author Conduction Development Team diff --git a/lib/Service/Index/FileHandler.php b/lib/Service/Index/FileHandler.php index b5dfd0e0c1bd..bd75ae8f3ab0 100644 --- a/lib/Service/Index/FileHandler.php +++ b/lib/Service/Index/FileHandler.php @@ -6,6 +6,9 @@ * Handles file chunk indexing to Solr/Elasticsearch. * Reads chunks from database (created by TextExtractionService) and indexes them. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index * diff --git a/lib/Service/Index/ObjectHandler.php b/lib/Service/Index/ObjectHandler.php index a7107ab8a36b..e37bd8f5d0d4 100644 --- a/lib/Service/Index/ObjectHandler.php +++ b/lib/Service/Index/ObjectHandler.php @@ -6,6 +6,9 @@ * Handles object indexing and search in Solr/Elasticsearch. * Reads objects from database and indexes them - does NOT extract text or vectorize. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index * diff --git a/lib/Service/Index/SchemaHandler.php b/lib/Service/Index/SchemaHandler.php index e2e4737a5231..88190dcf8f0b 100644 --- a/lib/Service/Index/SchemaHandler.php +++ b/lib/Service/Index/SchemaHandler.php @@ -6,6 +6,9 @@ * Handles schema management operations for Solr collections. * Manages field types, schema mirroring, and collection field status. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index * diff --git a/lib/Service/Index/SchemaMapper.php b/lib/Service/Index/SchemaMapper.php index 0cd776448e04..99b1a3672cf0 100644 --- a/lib/Service/Index/SchemaMapper.php +++ b/lib/Service/Index/SchemaMapper.php @@ -5,6 +5,9 @@ * * Handles mapping between OpenRegister schemas and search backend schemas. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index * @author Conduction Development Team diff --git a/lib/Service/Index/SearchBackendInterface.php b/lib/Service/Index/SearchBackendInterface.php index 3fb96e831a50..28db10eefae2 100644 --- a/lib/Service/Index/SearchBackendInterface.php +++ b/lib/Service/Index/SearchBackendInterface.php @@ -9,6 +9,9 @@ * allowing the IndexService to be backend-agnostic and support multiple search * technologies without code changes. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Interface * @package OCA\OpenRegister\Service\Index * diff --git a/lib/Service/Index/SetupHandler.php b/lib/Service/Index/SetupHandler.php index 428dc164a4b6..c27847dcdc5f 100644 --- a/lib/Service/Index/SetupHandler.php +++ b/lib/Service/Index/SetupHandler.php @@ -5,6 +5,9 @@ * * Setup class for SOLR configuration in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index * @author Conduction Development Team diff --git a/lib/Service/Index/WarmupHandler.php b/lib/Service/Index/WarmupHandler.php index e1fe13fe81ba..5db06b6fe0a8 100644 --- a/lib/Service/Index/WarmupHandler.php +++ b/lib/Service/Index/WarmupHandler.php @@ -6,6 +6,9 @@ * Handles Solr index warmup operations. * Extracted from GuzzleSolrService to separate warmup logic. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Index * @author Conduction Development Team diff --git a/lib/Service/Integration/Providers/CalendarProvider.php b/lib/Service/Integration/Providers/CalendarProvider.php index f1b32d1b0c0e..90cdb3c592ff 100644 --- a/lib/Service/Integration/Providers/CalendarProvider.php +++ b/lib/Service/Integration/Providers/CalendarProvider.php @@ -21,6 +21,9 @@ * registry-driven sidebar uses for rendering, with `delete()` wired so * the unified inline unlink works out of the box. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Integration\Providers * diff --git a/lib/Service/Integration/Providers/ContactsProvider.php b/lib/Service/Integration/Providers/ContactsProvider.php index b4b0bc868a25..fccc4f3d4302 100644 --- a/lib/Service/Integration/Providers/ContactsProvider.php +++ b/lib/Service/Integration/Providers/ContactsProvider.php @@ -18,6 +18,9 @@ * ContactsController routes; the registry's generic create() would lose * that distinction. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Integration\Providers * diff --git a/lib/Service/Integration/Providers/DeckProvider.php b/lib/Service/Integration/Providers/DeckProvider.php index edc2d43d9cb8..eb25ad4511e5 100644 --- a/lib/Service/Integration/Providers/DeckProvider.php +++ b/lib/Service/Integration/Providers/DeckProvider.php @@ -12,6 +12,9 @@ * either `cardId` (link existing) or `boardId + stackId + title` * (create new), matching DeckCardService::linkOrCreateCard. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Integration\Providers * diff --git a/lib/Service/Integration/Providers/EmailProvider.php b/lib/Service/Integration/Providers/EmailProvider.php index 0cec3d4771f7..33ea352e981e 100644 --- a/lib/Service/Integration/Providers/EmailProvider.php +++ b/lib/Service/Integration/Providers/EmailProvider.php @@ -10,6 +10,9 @@ * offers "link existing message" via account/folder picker (the UI * concern), and the provider exposes that link path through `create()`. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Integration\Providers * diff --git a/lib/Service/Integration/Providers/OpenProjectProvider.php b/lib/Service/Integration/Providers/OpenProjectProvider.php index 6b5b943cddab..27df0347c626 100644 --- a/lib/Service/Integration/Providers/OpenProjectProvider.php +++ b/lib/Service/Integration/Providers/OpenProjectProvider.php @@ -16,6 +16,9 @@ * No NC app is required — OpenProject is external; the only install * dependency is OpenConnector (which carries the source + credentials). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Integration\Providers * diff --git a/lib/Service/Integration/Providers/PollsProvider.php b/lib/Service/Integration/Providers/PollsProvider.php index 8cdeb47a7480..e23e7ec1977a 100644 --- a/lib/Service/Integration/Providers/PollsProvider.php +++ b/lib/Service/Integration/Providers/PollsProvider.php @@ -8,6 +8,9 @@ * object ↔ poll); the wrapping PollsService lands in a follow-up — * this provider registers the registry surface today. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Integration\Providers * diff --git a/lib/Service/Integration/Providers/TalkProvider.php b/lib/Service/Integration/Providers/TalkProvider.php index fbbec65a3e86..c5f71a4d3594 100644 --- a/lib/Service/Integration/Providers/TalkProvider.php +++ b/lib/Service/Integration/Providers/TalkProvider.php @@ -11,6 +11,9 @@ * NB: NC Talk's internal app id is `spreed`, not `talk` — that's what * IAppManager resolves against. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Integration\Providers * diff --git a/lib/Service/Mcp/McpProtocolService.php b/lib/Service/Mcp/McpProtocolService.php index 567806ebbcfe..de432ded8d80 100644 --- a/lib/Service/Mcp/McpProtocolService.php +++ b/lib/Service/Mcp/McpProtocolService.php @@ -6,6 +6,9 @@ * Handles Model Context Protocol (MCP) standard handshake, session management, * and protocol-level operations for the OpenRegister MCP server. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Mcp * diff --git a/lib/Service/Mcp/McpResourcesService.php b/lib/Service/Mcp/McpResourcesService.php index 908722bdf311..0ed9b68623aa 100644 --- a/lib/Service/Mcp/McpResourcesService.php +++ b/lib/Service/Mcp/McpResourcesService.php @@ -6,6 +6,9 @@ * Handles MCP standard resource listing, reading, and URI template * operations for the OpenRegister MCP server. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Mcp * diff --git a/lib/Service/Mcp/McpToolsService.php b/lib/Service/Mcp/McpToolsService.php index 6cb66163488c..021069c18634 100644 --- a/lib/Service/Mcp/McpToolsService.php +++ b/lib/Service/Mcp/McpToolsService.php @@ -9,6 +9,9 @@ * their tool descriptors. Namespace enforcement (ADR-034 D5) rejects any * descriptor whose id does not start with `{provider->getAppId()}.`. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Mcp * diff --git a/lib/Service/Notification/AnnotationNotificationDispatcher.php b/lib/Service/Notification/AnnotationNotificationDispatcher.php index baea31933ce0..77e31903b08d 100644 --- a/lib/Service/Notification/AnnotationNotificationDispatcher.php +++ b/lib/Service/Notification/AnnotationNotificationDispatcher.php @@ -8,6 +8,9 @@ * matches. v1 supports trigger types created/updated/transition, * recipient kinds users/field, channel `nc-notification`. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Notification * diff --git a/lib/Service/Notification/NotificationAnnotationValidator.php b/lib/Service/Notification/NotificationAnnotationValidator.php index cf61f1d525c7..68149dc501b9 100644 --- a/lib/Service/Notification/NotificationAnnotationValidator.php +++ b/lib/Service/Notification/NotificationAnnotationValidator.php @@ -5,6 +5,9 @@ * * Schema-save validation for the `x-openregister-notifications` annotation. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Notification * diff --git a/lib/Service/Notification/NotificationCoalescer.php b/lib/Service/Notification/NotificationCoalescer.php index a790f53f2574..02e24d718c28 100644 --- a/lib/Service/Notification/NotificationCoalescer.php +++ b/lib/Service/Notification/NotificationCoalescer.php @@ -19,6 +19,9 @@ * window state survives across requests + (with Redis) across * cluster nodes. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Notification * diff --git a/lib/Service/Notification/NotificationDigest.php b/lib/Service/Notification/NotificationDigest.php index 463c24ea08d5..739060df5d1c 100644 --- a/lib/Service/Notification/NotificationDigest.php +++ b/lib/Service/Notification/NotificationDigest.php @@ -14,6 +14,9 @@ * NotificationCoalescer (already in the codebase) for content-side * deduplication. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Notification * diff --git a/lib/Service/Notification/NotificationReadState.php b/lib/Service/Notification/NotificationReadState.php index 5bb6ccd8684f..14ff2cecda97 100644 --- a/lib/Service/Notification/NotificationReadState.php +++ b/lib/Service/Notification/NotificationReadState.php @@ -19,6 +19,9 @@ * (`oc_openregister_notification_readstate` table with a unique * `(user_id, notification_id)` index) follows exactly these semantics. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Notification * diff --git a/lib/Service/Notification/NotificationsAnnotationInstaller.php b/lib/Service/Notification/NotificationsAnnotationInstaller.php index 86d07c2f586e..530d82675d53 100644 --- a/lib/Service/Notification/NotificationsAnnotationInstaller.php +++ b/lib/Service/Notification/NotificationsAnnotationInstaller.php @@ -9,6 +9,9 @@ * pipeline (retry, HMAC, dead-letter, multi-tenancy) handles * dispatch instead of the inline fire-and-forget POST. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Notification * diff --git a/lib/Service/Notification/RateLimiter.php b/lib/Service/Notification/RateLimiter.php index b8feef3789a5..c1e518c594a3 100644 --- a/lib/Service/Notification/RateLimiter.php +++ b/lib/Service/Notification/RateLimiter.php @@ -10,6 +10,9 @@ * size. When a token isn't available the dispatch is dropped and * logged at info level — operators who care can grep for it. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Notification * diff --git a/lib/Service/Notification/RecipientResolverInterface.php b/lib/Service/Notification/RecipientResolverInterface.php index 371a0fedc80c..a15ec7f2ad7b 100644 --- a/lib/Service/Notification/RecipientResolverInterface.php +++ b/lib/Service/Notification/RecipientResolverInterface.php @@ -8,6 +8,9 @@ * implementation under a DI tag; the schema's notification annotation * references the tag via `{kind: "expression", resolver: ""}`. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Notification * diff --git a/lib/Service/Notification/VngNotificatiesEnvelope.php b/lib/Service/Notification/VngNotificatiesEnvelope.php index 9e97b97106fa..e62646c0c03d 100644 --- a/lib/Service/Notification/VngNotificatiesEnvelope.php +++ b/lib/Service/Notification/VngNotificatiesEnvelope.php @@ -24,6 +24,9 @@ * 2. the algorithmic correctness has unit-test coverage independent of * the Twig stack. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Notification * diff --git a/lib/Service/TextExtraction/EntityRecognitionHandler.php b/lib/Service/TextExtraction/EntityRecognitionHandler.php index 1ba18d302ee1..fd96bae7df59 100644 --- a/lib/Service/TextExtraction/EntityRecognitionHandler.php +++ b/lib/Service/TextExtraction/EntityRecognitionHandler.php @@ -7,6 +7,9 @@ * from text chunks for GDPR compliance and data classification. * This handler is invoked after chunks are created to detect and store entities. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\TextExtraction * diff --git a/lib/Service/TextExtraction/FileHandler.php b/lib/Service/TextExtraction/FileHandler.php index 311ce261a216..ccb5eda70346 100644 --- a/lib/Service/TextExtraction/FileHandler.php +++ b/lib/Service/TextExtraction/FileHandler.php @@ -5,6 +5,9 @@ * * Handles text extraction from Nextcloud files. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\TextExtraction * diff --git a/lib/Service/TextExtraction/ObjectHandler.php b/lib/Service/TextExtraction/ObjectHandler.php index 624486a71bf9..d7458f71b8b3 100644 --- a/lib/Service/TextExtraction/ObjectHandler.php +++ b/lib/Service/TextExtraction/ObjectHandler.php @@ -5,6 +5,9 @@ * * Handles text extraction from OpenRegister objects. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\TextExtraction * diff --git a/lib/Service/TextExtraction/TextExtractionHandlerInterface.php b/lib/Service/TextExtraction/TextExtractionHandlerInterface.php index 4b9e5aa60bf5..775ff4d6c3e6 100644 --- a/lib/Service/TextExtraction/TextExtractionHandlerInterface.php +++ b/lib/Service/TextExtraction/TextExtractionHandlerInterface.php @@ -7,6 +7,9 @@ * This allows the TextExtractionService to be generic and extensible * for future source types (agenda, email, etc.). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\TextExtraction * diff --git a/lib/Service/Translation/IdentityTranslationProvider.php b/lib/Service/Translation/IdentityTranslationProvider.php index 8047c80ff159..47697a0d8f67 100644 --- a/lib/Service/Translation/IdentityTranslationProvider.php +++ b/lib/Service/Translation/IdentityTranslationProvider.php @@ -9,6 +9,9 @@ * (LibreTranslate / DeepL / Google) in `Application.php` to get * actual machine translations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Translation * diff --git a/lib/Service/Translation/TranslationCsvCodec.php b/lib/Service/Translation/TranslationCsvCodec.php index e7e1fd992380..74911f4acf22 100644 --- a/lib/Service/Translation/TranslationCsvCodec.php +++ b/lib/Service/Translation/TranslationCsvCodec.php @@ -9,6 +9,9 @@ * `ExportService::exportToCsv` once they're updated to be * translation-aware (Phase 2.3 wire-in). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Translation * diff --git a/lib/Service/Translation/TranslationProviderInterface.php b/lib/Service/Translation/TranslationProviderInterface.php index d8dfb5158303..2ae5e8d20106 100644 --- a/lib/Service/Translation/TranslationProviderInterface.php +++ b/lib/Service/Translation/TranslationProviderInterface.php @@ -9,6 +9,9 @@ * the source text verbatim) so the bulk-translate UI works for testing * without provisioning external API keys. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Translation * diff --git a/lib/Service/Vectorization/Handlers/EmbeddingGeneratorHandler.php b/lib/Service/Vectorization/Handlers/EmbeddingGeneratorHandler.php index fa5fd948ee8d..0d8116a306d6 100644 --- a/lib/Service/Vectorization/Handlers/EmbeddingGeneratorHandler.php +++ b/lib/Service/Vectorization/Handlers/EmbeddingGeneratorHandler.php @@ -5,6 +5,9 @@ * * Manages creation and caching of embedding generators for different LLM providers. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Vectorization\Handlers * diff --git a/lib/Service/Vectorization/Handlers/VectorSearchHandler.php b/lib/Service/Vectorization/Handlers/VectorSearchHandler.php index 131cc60436ae..7e1d1edf045a 100644 --- a/lib/Service/Vectorization/Handlers/VectorSearchHandler.php +++ b/lib/Service/Vectorization/Handlers/VectorSearchHandler.php @@ -5,6 +5,9 @@ * * Handles semantic and hybrid search operations using vectors. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Vectorization\Handlers * diff --git a/lib/Service/Vectorization/Handlers/VectorStatsHandler.php b/lib/Service/Vectorization/Handlers/VectorStatsHandler.php index 7b89ed7db5db..225ab5baafe4 100644 --- a/lib/Service/Vectorization/Handlers/VectorStatsHandler.php +++ b/lib/Service/Vectorization/Handlers/VectorStatsHandler.php @@ -5,6 +5,9 @@ * * Handles gathering statistics about stored vectors from database and Solr. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Vectorization\Handlers * diff --git a/lib/Service/Vectorization/Handlers/VectorStorageHandler.php b/lib/Service/Vectorization/Handlers/VectorStorageHandler.php index a7ba00904f4c..ead33ed7ef4c 100644 --- a/lib/Service/Vectorization/Handlers/VectorStorageHandler.php +++ b/lib/Service/Vectorization/Handlers/VectorStorageHandler.php @@ -5,6 +5,9 @@ * * Handles storing vector embeddings in database and Solr. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Vectorization\Handlers * diff --git a/lib/Service/Vectorization/Strategies/FileVectorizationStrategy.php b/lib/Service/Vectorization/Strategies/FileVectorizationStrategy.php index 66c850c45792..5625335a3052 100644 --- a/lib/Service/Vectorization/Strategies/FileVectorizationStrategy.php +++ b/lib/Service/Vectorization/Strategies/FileVectorizationStrategy.php @@ -5,6 +5,9 @@ * * Strategy for vectorizing file chunks. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Vectorization * diff --git a/lib/Service/Vectorization/Strategies/ObjectVectorizationStrategy.php b/lib/Service/Vectorization/Strategies/ObjectVectorizationStrategy.php index a9fc65caef82..03bcebd6bbf6 100644 --- a/lib/Service/Vectorization/Strategies/ObjectVectorizationStrategy.php +++ b/lib/Service/Vectorization/Strategies/ObjectVectorizationStrategy.php @@ -5,6 +5,9 @@ * * Strategy for vectorizing OpenRegister objects. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Vectorization * diff --git a/lib/Service/Vectorization/Strategies/VectorizationStrategyInterface.php b/lib/Service/Vectorization/Strategies/VectorizationStrategyInterface.php index 1d3b5fa1b9e1..383e5ea1a732 100644 --- a/lib/Service/Vectorization/Strategies/VectorizationStrategyInterface.php +++ b/lib/Service/Vectorization/Strategies/VectorizationStrategyInterface.php @@ -5,6 +5,9 @@ * * Defines contract for entity-specific vectorization logic. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Vectorization * diff --git a/lib/Service/Vectorization/VectorEmbeddings.php b/lib/Service/Vectorization/VectorEmbeddings.php index 5846e71c783a..79ab934a504b 100644 --- a/lib/Service/Vectorization/VectorEmbeddings.php +++ b/lib/Service/Vectorization/VectorEmbeddings.php @@ -6,6 +6,9 @@ * Main entry point for all vector embedding operations. * Coordinates handlers for generation, storage, search, and statistics. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Vectorization * diff --git a/lib/Service/Webhook/CloudEventFormatter.php b/lib/Service/Webhook/CloudEventFormatter.php index 3f75b340b582..9a5ec76b4d57 100644 --- a/lib/Service/Webhook/CloudEventFormatter.php +++ b/lib/Service/Webhook/CloudEventFormatter.php @@ -5,6 +5,9 @@ * * Formatter for creating CloudEvents specification compliant webhook payloads. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Webhook * From c8432a224146fe8146bee36dab37e03368647f68 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 15:18:40 +0200 Subject: [PATCH 043/333] =?UTF-8?q?chore(spdx):=20add=20EUPL-1.2=20SPDX=20?= =?UTF-8?q?headers=20=E2=80=94=20Service:=20config,=20archival,=20OAS=20+?= =?UTF-8?q?=20flat=20files=20(Bucket=204=20retrofit,=20part=204/7)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mechanical sweep: inserts `SPDX-License-Identifier: EUPL-1.2` + `SPDX-FileCopyrightText: 2026 Conduction B.V.` into the existing file docblock of every file in this PR's scope. Per ADR-014 and the convention in existing files (e.g. lib/Service/AvgComplianceService.php). Scope: lib/Service/GraphQL/ (14), lib/Service/Configuration/ (12), lib/Service/Settings/ (8), lib/Service/Archival/ (6), lib/Service/Lifecycle/ (3), lib/Service/Oas/ (3), lib/Service/Registers/ (1) + 70 flat lib/Service/*.php files Part of the openregister coverage-scan retrofit (2026-05-24). Companion to PR #1737 (1/7, misc bundle). --- lib/Service/ActionExecutor.php | 3 +++ lib/Service/ActionService.php | 3 +++ lib/Service/ActivityService.php | 3 +++ lib/Service/ApplicationService.php | 3 +++ lib/Service/ApprovalService.php | 3 +++ lib/Service/Archival/ArchiefactiedatumCalculator.php | 3 +++ lib/Service/Archival/ArchivalAnnotationValidator.php | 3 +++ lib/Service/Archival/DestructionService.php | 3 +++ lib/Service/Archival/LegalHoldService.php | 3 +++ lib/Service/Archival/RetentionConditionEvaluator.php | 3 +++ lib/Service/Archival/RetentionEvaluator.php | 3 +++ lib/Service/ArchivalService.php | 3 +++ lib/Service/AuditHashService.php | 3 +++ lib/Service/AuthenticationService.php | 3 +++ lib/Service/AuthorizationAuditService.php | 3 +++ lib/Service/AuthorizationService.php | 3 +++ lib/Service/BulkTranslationService.php | 3 +++ lib/Service/CalendarEventService.php | 3 +++ lib/Service/ChatService.php | 3 +++ lib/Service/ConditionMatcher.php | 3 +++ lib/Service/Configuration/AttributionFormatter.php | 3 +++ lib/Service/Configuration/CacheHandler.php | 3 +++ lib/Service/Configuration/ExportHandler.php | 3 +++ lib/Service/Configuration/FetchHandler.php | 3 +++ lib/Service/Configuration/GitHubGuards.php | 3 +++ lib/Service/Configuration/GitHubHandler.php | 3 +++ lib/Service/Configuration/GitHubRequestValidator.php | 3 +++ lib/Service/Configuration/GitLabHandler.php | 3 +++ lib/Service/Configuration/ImportHandler.php | 3 +++ lib/Service/Configuration/PreviewHandler.php | 3 +++ lib/Service/Configuration/RateLimiterService.php | 3 +++ lib/Service/Configuration/UploadHandler.php | 3 +++ lib/Service/ConfigurationService.php | 3 +++ lib/Service/ContactMatchingService.php | 3 +++ lib/Service/ContactService.php | 3 +++ lib/Service/DashboardService.php | 3 +++ lib/Service/DateTimeNormalizer.php | 3 +++ lib/Service/DeckCardService.php | 3 +++ lib/Service/DeepLinkRegistryService.php | 3 +++ lib/Service/DownloadService.php | 3 +++ lib/Service/EmailService.php | 3 +++ lib/Service/EndpointService.php | 3 +++ lib/Service/ExportService.php | 3 +++ lib/Service/FileService.php | 3 +++ lib/Service/FileSidebarService.php | 3 +++ lib/Service/GraphQL/GraphQLErrorFormatter.php | 3 +++ lib/Service/GraphQL/GraphQLResolver.php | 3 +++ lib/Service/GraphQL/GraphQLService.php | 3 +++ lib/Service/GraphQL/QueryComplexityAnalyzer.php | 3 +++ lib/Service/GraphQL/Scalar/DateTimeType.php | 3 +++ lib/Service/GraphQL/Scalar/EmailType.php | 3 +++ lib/Service/GraphQL/Scalar/JsonType.php | 3 +++ lib/Service/GraphQL/Scalar/UploadType.php | 3 +++ lib/Service/GraphQL/Scalar/UriType.php | 3 +++ lib/Service/GraphQL/Scalar/UuidType.php | 3 +++ lib/Service/GraphQL/SchemaGenerator.php | 3 +++ lib/Service/GraphQL/SchemaGenerator/CompositionHandler.php | 3 +++ lib/Service/GraphQL/SchemaGenerator/TypeMapperHandler.php | 3 +++ lib/Service/GraphQL/SubscriptionService.php | 3 +++ lib/Service/HookExecutor.php | 3 +++ lib/Service/ImportService.php | 3 +++ lib/Service/IndexService.php | 3 +++ lib/Service/LanguageService.php | 3 +++ lib/Service/Lifecycle/LifecycleAnnotationValidator.php | 3 +++ lib/Service/Lifecycle/LifecycleGuardRegistry.php | 3 +++ lib/Service/Lifecycle/TransitionEngine.php | 3 +++ lib/Service/LinkedEntityService.php | 3 +++ lib/Service/LogService.php | 3 +++ lib/Service/ManifestService.php | 3 +++ lib/Service/MappingService.php | 3 +++ lib/Service/McpDiscoveryService.php | 3 +++ lib/Service/MetricsService.php | 3 +++ lib/Service/MigrationService.php | 3 +++ lib/Service/NoteService.php | 3 +++ lib/Service/NotificationService.php | 3 +++ lib/Service/Oas/OasETagComputer.php | 3 +++ lib/Service/Oas/OasRequestValidator.php | 3 +++ lib/Service/Oas/ProblemDetailsBuilder.php | 3 +++ lib/Service/OasService.php | 3 +++ lib/Service/ObjectService.php | 3 +++ lib/Service/ObjectServiceMapperAdapter.php | 3 +++ lib/Service/OperatorEvaluator.php | 3 +++ lib/Service/OrganisationService.php | 3 +++ lib/Service/PropertyRbacHandler.php | 3 +++ lib/Service/RealtimeService.php | 3 +++ lib/Service/RegisterService.php | 3 +++ lib/Service/Registers/RegisterCacheHandler.php | 3 +++ lib/Service/RequestScopedCache.php | 3 +++ lib/Service/RetentionService.php | 3 +++ lib/Service/RiskLevelService.php | 3 +++ lib/Service/SchemaService.php | 3 +++ lib/Service/SearchTrailService.php | 3 +++ lib/Service/SecurityService.php | 3 +++ lib/Service/Settings/CacheSettingsHandler.php | 3 +++ lib/Service/Settings/ConfigurationSettingsHandler.php | 3 +++ lib/Service/Settings/FileSettingsHandler.php | 3 +++ lib/Service/Settings/LlmSettingsHandler.php | 3 +++ lib/Service/Settings/ObjectRetentionHandler.php | 3 +++ lib/Service/Settings/SearchBackendHandler.php | 3 +++ lib/Service/Settings/SolrSettingsHandler.php | 3 +++ lib/Service/Settings/ValidationOperationsHandler.php | 3 +++ lib/Service/SettingsService.php | 3 +++ lib/Service/TaskService.php | 3 +++ lib/Service/TenantKeyService.php | 3 +++ lib/Service/TenantLifecycleService.php | 3 +++ lib/Service/TextExtractionService.php | 3 +++ lib/Service/TmloService.php | 3 +++ lib/Service/ToolRegistry.php | 3 +++ lib/Service/TranslationProjectionService.php | 3 +++ lib/Service/TranslationStatusService.php | 3 +++ lib/Service/UploadService.php | 3 +++ lib/Service/UrnService.php | 3 +++ lib/Service/UserService.php | 3 +++ lib/Service/VectorizationService.php | 3 +++ lib/Service/ViewService.php | 3 +++ lib/Service/WebhookService.php | 3 +++ lib/Service/WorkflowEngineRegistry.php | 3 +++ 117 files changed, 351 insertions(+) diff --git a/lib/Service/ActionExecutor.php b/lib/Service/ActionExecutor.php index bb4676e54a53..9b7c8bf6894e 100644 --- a/lib/Service/ActionExecutor.php +++ b/lib/Service/ActionExecutor.php @@ -5,6 +5,9 @@ * * Orchestrates action execution for lifecycle events. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ActionService.php b/lib/Service/ActionService.php index 5c9f905c32b8..2c79f9997255 100644 --- a/lib/Service/ActionService.php +++ b/lib/Service/ActionService.php @@ -5,6 +5,9 @@ * * Business logic for Action entity management. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ActivityService.php b/lib/Service/ActivityService.php index f3dd08d7f75f..a1f9703ecf8c 100644 --- a/lib/Service/ActivityService.php +++ b/lib/Service/ActivityService.php @@ -5,6 +5,9 @@ * * Service for publishing OpenRegister activity events to the Nextcloud activity stream. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ApplicationService.php b/lib/Service/ApplicationService.php index 851c50be2318..ec91469a9ff5 100644 --- a/lib/Service/ApplicationService.php +++ b/lib/Service/ApplicationService.php @@ -5,6 +5,9 @@ * * This file contains the service class for managing applications. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ApprovalService.php b/lib/Service/ApprovalService.php index 6bc037000ae0..4aaeceee5b47 100644 --- a/lib/Service/ApprovalService.php +++ b/lib/Service/ApprovalService.php @@ -3,6 +3,9 @@ /** * OpenRegister ApprovalService * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Archival/ArchiefactiedatumCalculator.php b/lib/Service/Archival/ArchiefactiedatumCalculator.php index e32891a965ed..b8a67e885848 100644 --- a/lib/Service/Archival/ArchiefactiedatumCalculator.php +++ b/lib/Service/Archival/ArchiefactiedatumCalculator.php @@ -6,6 +6,9 @@ * Calculates the archive action date (archiefactiedatum) using configurable * derivation methods (afleidingswijzen) as defined by the ZGW API standard. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Archival * diff --git a/lib/Service/Archival/ArchivalAnnotationValidator.php b/lib/Service/Archival/ArchivalAnnotationValidator.php index 8bd6389cea0d..d6051818153c 100644 --- a/lib/Service/Archival/ArchivalAnnotationValidator.php +++ b/lib/Service/Archival/ArchivalAnnotationValidator.php @@ -12,6 +12,9 @@ * row matches the rule's `condition`. Validation is shape-only at save * time; the runtime condition grammar lives in `RetentionConditionEvaluator`. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Archival * diff --git a/lib/Service/Archival/DestructionService.php b/lib/Service/Archival/DestructionService.php index b5c0fa97f330..f6f189fc853c 100644 --- a/lib/Service/Archival/DestructionService.php +++ b/lib/Service/Archival/DestructionService.php @@ -7,6 +7,9 @@ * creating destruction lists, handling approvals/rejections, executing * destruction, and generating destruction certificates. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Archival * diff --git a/lib/Service/Archival/LegalHoldService.php b/lib/Service/Archival/LegalHoldService.php index 646f57afa7b6..3758a140e5cc 100644 --- a/lib/Service/Archival/LegalHoldService.php +++ b/lib/Service/Archival/LegalHoldService.php @@ -6,6 +6,9 @@ * Manages legal holds (bevriezing) on register objects, preventing destruction * regardless of archival dates. Supports WOB/WOO requests and regulatory investigations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Archival * diff --git a/lib/Service/Archival/RetentionConditionEvaluator.php b/lib/Service/Archival/RetentionConditionEvaluator.php index b4b7e991e95c..c33aa528244e 100644 --- a/lib/Service/Archival/RetentionConditionEvaluator.php +++ b/lib/Service/Archival/RetentionConditionEvaluator.php @@ -19,6 +19,9 @@ * is intentionally out of scope. A future change can layer a real * expression engine on top if the fleet ever needs it. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Archival * diff --git a/lib/Service/Archival/RetentionEvaluator.php b/lib/Service/Archival/RetentionEvaluator.php index dc3d3b77f8fc..041ddc4f8a31 100644 --- a/lib/Service/Archival/RetentionEvaluator.php +++ b/lib/Service/Archival/RetentionEvaluator.php @@ -14,6 +14,9 @@ * - `ObjectEntity::jsonSerialize()` (via the renderer) to surface the * `_retention` block on read so the UI can show *why* a row is kept. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Archival * diff --git a/lib/Service/ArchivalService.php b/lib/Service/ArchivalService.php index 6f0ce8eb882a..a3cef76fc689 100644 --- a/lib/Service/ArchivalService.php +++ b/lib/Service/ArchivalService.php @@ -6,6 +6,9 @@ * Core business logic for archiving and destruction workflows conforming * to Dutch archival standards (MDTO, NEN 2082, Archiefwet 1995). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/AuditHashService.php b/lib/Service/AuditHashService.php index c059c4841f73..a6becd36b461 100644 --- a/lib/Service/AuditHashService.php +++ b/lib/Service/AuditHashService.php @@ -6,6 +6,9 @@ * Provides SHA-256 hash computation, chain verification, and genesis hash management * for the immutable audit trail system. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/AuthenticationService.php b/lib/Service/AuthenticationService.php index ea9756c2fba2..e1c14890abd6 100644 --- a/lib/Service/AuthenticationService.php +++ b/lib/Service/AuthenticationService.php @@ -3,6 +3,9 @@ /** * Authentication Service for generating outbound tokens. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/AuthorizationAuditService.php b/lib/Service/AuthorizationAuditService.php index 7c8a61ad7084..7687a89e09b5 100644 --- a/lib/Service/AuthorizationAuditService.php +++ b/lib/Service/AuthorizationAuditService.php @@ -6,6 +6,9 @@ * Logs all changes to authorization configuration on registers and schemas. * Provides structured audit entries for compliance and debugging. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/AuthorizationService.php b/lib/Service/AuthorizationService.php index 59febc131dd7..54e536a56dab 100644 --- a/lib/Service/AuthorizationService.php +++ b/lib/Service/AuthorizationService.php @@ -3,6 +3,9 @@ /** * Authorization Service for validating incoming API requests. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/BulkTranslationService.php b/lib/Service/BulkTranslationService.php index d6ccb8935628..8a13cfef6927 100644 --- a/lib/Service/BulkTranslationService.php +++ b/lib/Service/BulkTranslationService.php @@ -14,6 +14,9 @@ * The actual saveObject path is left to the caller — this service is * a pure translation step that returns the patch the caller applies. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/CalendarEventService.php b/lib/Service/CalendarEventService.php index da10eacebfa2..91eca7240aaa 100644 --- a/lib/Service/CalendarEventService.php +++ b/lib/Service/CalendarEventService.php @@ -7,6 +7,9 @@ * Events are stored as standard VEVENT items in the user's Nextcloud calendar with * X-OPENREGISTER-* properties for linking and an RFC 9253 LINK property. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/ChatService.php b/lib/Service/ChatService.php index 831f6c5e51c5..3d074af3b1a2 100644 --- a/lib/Service/ChatService.php +++ b/lib/Service/ChatService.php @@ -6,6 +6,9 @@ * Service for managing AI chat conversations with RAG (Retrieval Augmented Generation). * This is a thin facade that orchestrates specialized handlers. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ConditionMatcher.php b/lib/Service/ConditionMatcher.php index 10605f94962a..5541f26fc938 100644 --- a/lib/Service/ConditionMatcher.php +++ b/lib/Service/ConditionMatcher.php @@ -9,6 +9,9 @@ * * Extracted from PropertyRbacHandler to keep class complexity manageable. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/Configuration/AttributionFormatter.php b/lib/Service/Configuration/AttributionFormatter.php index 5a412bc2e726..cf07dc3fd4fa 100644 --- a/lib/Service/Configuration/AttributionFormatter.php +++ b/lib/Service/Configuration/AttributionFormatter.php @@ -13,6 +13,9 @@ * URL) is scoped to task 1.15 (follow-up); this skeleton implementation builds the * prefix from the raw values returned by IUserManager + IURLGenerator. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Configuration * diff --git a/lib/Service/Configuration/CacheHandler.php b/lib/Service/Configuration/CacheHandler.php index a654ea5a72b0..0c0307f827e6 100644 --- a/lib/Service/Configuration/CacheHandler.php +++ b/lib/Service/Configuration/CacheHandler.php @@ -6,6 +6,9 @@ * This file contains the handler for caching configurations in the user session * to avoid excessive database queries when checking if entities are managed by configurations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Configuration * diff --git a/lib/Service/Configuration/ExportHandler.php b/lib/Service/Configuration/ExportHandler.php index 0e6212cf2f56..636dcca60649 100644 --- a/lib/Service/Configuration/ExportHandler.php +++ b/lib/Service/Configuration/ExportHandler.php @@ -6,6 +6,9 @@ * This file contains the handler class for exporting configurations * in OpenAPI format from the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Configuration * diff --git a/lib/Service/Configuration/FetchHandler.php b/lib/Service/Configuration/FetchHandler.php index ec820ea1ca00..1041a5125369 100644 --- a/lib/Service/Configuration/FetchHandler.php +++ b/lib/Service/Configuration/FetchHandler.php @@ -6,6 +6,9 @@ * This file contains the handler class for fetching configuration data * from remote sources (URLs, GitHub, GitLab). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Configuration * diff --git a/lib/Service/Configuration/GitHubGuards.php b/lib/Service/Configuration/GitHubGuards.php index 217cf3610e69..944dc84ceb65 100644 --- a/lib/Service/Configuration/GitHubGuards.php +++ b/lib/Service/Configuration/GitHubGuards.php @@ -17,6 +17,9 @@ * Each public guard returns either `null` (continue) or a `JSONResponse` (short-circuit * with a structured error). The controller invokes them via the shared `runGuards` pipeline. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Configuration * diff --git a/lib/Service/Configuration/GitHubHandler.php b/lib/Service/Configuration/GitHubHandler.php index 8a7ed9765802..2b46157883c9 100644 --- a/lib/Service/Configuration/GitHubHandler.php +++ b/lib/Service/Configuration/GitHubHandler.php @@ -6,6 +6,9 @@ * This file contains the GitHubHandler class for interacting with the GitHub API * to discover, fetch, and manage OpenRegister configurations stored in GitHub repositories. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Configuration * @author Conduction Development Team diff --git a/lib/Service/Configuration/GitHubRequestValidator.php b/lib/Service/Configuration/GitHubRequestValidator.php index adb908f8dc6a..523f4570c39f 100644 --- a/lib/Service/Configuration/GitHubRequestValidator.php +++ b/lib/Service/Configuration/GitHubRequestValidator.php @@ -13,6 +13,9 @@ * threshold and the two responsibilities (input validation vs. policy enforcement) stay * clearly distinct. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Configuration * diff --git a/lib/Service/Configuration/GitLabHandler.php b/lib/Service/Configuration/GitLabHandler.php index deb0bf5dc289..21336fb3bf9f 100644 --- a/lib/Service/Configuration/GitLabHandler.php +++ b/lib/Service/Configuration/GitLabHandler.php @@ -6,6 +6,9 @@ * This file contains the GitLabHandler class for interacting with the GitLab API * to discover, fetch, and manage OpenRegister configurations stored in GitLab repositories. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Configuration * diff --git a/lib/Service/Configuration/ImportHandler.php b/lib/Service/Configuration/ImportHandler.php index 2dcdf2b0b51a..ac550e352855 100644 --- a/lib/Service/Configuration/ImportHandler.php +++ b/lib/Service/Configuration/ImportHandler.php @@ -6,6 +6,9 @@ * This file contains the handler class for importing configurations * from various sources in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Configuration * diff --git a/lib/Service/Configuration/PreviewHandler.php b/lib/Service/Configuration/PreviewHandler.php index 3e5cd62df169..dd23add9f710 100644 --- a/lib/Service/Configuration/PreviewHandler.php +++ b/lib/Service/Configuration/PreviewHandler.php @@ -6,6 +6,9 @@ * This file contains the handler class for previewing configuration changes * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Configuration * diff --git a/lib/Service/Configuration/RateLimiterService.php b/lib/Service/Configuration/RateLimiterService.php index e32c064b3441..60e95a50e47b 100644 --- a/lib/Service/Configuration/RateLimiterService.php +++ b/lib/Service/Configuration/RateLimiterService.php @@ -20,6 +20,9 @@ * Both return `null` when within budget and an `int` (whole seconds until the window * resets) when the budget is exhausted. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Configuration * diff --git a/lib/Service/Configuration/UploadHandler.php b/lib/Service/Configuration/UploadHandler.php index 39cbf232d399..c287e043f402 100644 --- a/lib/Service/Configuration/UploadHandler.php +++ b/lib/Service/Configuration/UploadHandler.php @@ -6,6 +6,9 @@ * This file contains the handler class for processing file uploads * and parsing JSON/YAML data in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Configuration * diff --git a/lib/Service/ConfigurationService.php b/lib/Service/ConfigurationService.php index 6c1fa26894ea..00eab8db8517 100644 --- a/lib/Service/ConfigurationService.php +++ b/lib/Service/ConfigurationService.php @@ -6,6 +6,9 @@ * This file contains the service class for handling configuration imports and exports * in the OpenRegister application, supporting various formats including OpenAPI. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ContactMatchingService.php b/lib/Service/ContactMatchingService.php index e070d145cd33..beaf5931b81f 100644 --- a/lib/Service/ContactMatchingService.php +++ b/lib/Service/ContactMatchingService.php @@ -6,6 +6,9 @@ * Shared service for matching contact metadata (email, name, organization) * to OpenRegister entities with APCu caching. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ContactService.php b/lib/Service/ContactService.php index c49e78103d57..bf328f1e8a5f 100644 --- a/lib/Service/ContactService.php +++ b/lib/Service/ContactService.php @@ -6,6 +6,9 @@ * Service that wraps CardDAV vCard operations for linking contacts to OpenRegister objects. * Uses dual storage: X-OPENREGISTER-* vCard properties + openregister_contact_links table. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/DashboardService.php b/lib/Service/DashboardService.php index 50073c383880..178075136089 100644 --- a/lib/Service/DashboardService.php +++ b/lib/Service/DashboardService.php @@ -6,6 +6,9 @@ * This file contains the service class for handling dashboard related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/DateTimeNormalizer.php b/lib/Service/DateTimeNormalizer.php index 1580d1555662..4d230c74f27b 100644 --- a/lib/Service/DateTimeNormalizer.php +++ b/lib/Service/DateTimeNormalizer.php @@ -12,6 +12,9 @@ * delegate to this class. Direct use of `new DateTime($value)` on user data * is forbidden — see OpenSpec change `fix-empty-string-date-conversion`. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/DeckCardService.php b/lib/Service/DeckCardService.php index c627cfadd60c..fb801954b642 100644 --- a/lib/Service/DeckCardService.php +++ b/lib/Service/DeckCardService.php @@ -6,6 +6,9 @@ * Service that wraps Nextcloud Deck card operations for linking cards to OpenRegister objects. * Uses the Deck app's internal PHP service classes when available. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/DeepLinkRegistryService.php b/lib/Service/DeepLinkRegistryService.php index 68d13c04f324..0938f9d02ac3 100644 --- a/lib/Service/DeepLinkRegistryService.php +++ b/lib/Service/DeepLinkRegistryService.php @@ -5,6 +5,9 @@ * * Registry service for deep link registrations from consuming apps. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/DownloadService.php b/lib/Service/DownloadService.php index 44e4d9d56938..487bd26fbb9a 100644 --- a/lib/Service/DownloadService.php +++ b/lib/Service/DownloadService.php @@ -8,6 +8,9 @@ * This service provides methods for: * - Downloading objects as files. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/EmailService.php b/lib/Service/EmailService.php index 3480240e64a9..3724f1fd7759 100644 --- a/lib/Service/EmailService.php +++ b/lib/Service/EmailService.php @@ -6,6 +6,9 @@ * Service that wraps Nextcloud Mail message lookups and manages email-to-object links. * Emails are immutable; this service only creates/removes link references. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/EndpointService.php b/lib/Service/EndpointService.php index a2197ed7487d..47faf182bcd3 100644 --- a/lib/Service/EndpointService.php +++ b/lib/Service/EndpointService.php @@ -5,6 +5,9 @@ * * Service for handling endpoint execution and management. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ExportService.php b/lib/Service/ExportService.php index 64fb670f6cf9..9a7a83b426a4 100644 --- a/lib/Service/ExportService.php +++ b/lib/Service/ExportService.php @@ -5,6 +5,9 @@ * * This file contains the class for handling data export operations in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/FileService.php b/lib/Service/FileService.php index 7a12db00b91a..d6dca15342da 100644 --- a/lib/Service/FileService.php +++ b/lib/Service/FileService.php @@ -15,6 +15,9 @@ * - Object-specific file operations * - Audit trails and data aggregation * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/FileSidebarService.php b/lib/Service/FileSidebarService.php index ff6724ab1fc5..8d5d1d8a6f44 100644 --- a/lib/Service/FileSidebarService.php +++ b/lib/Service/FileSidebarService.php @@ -7,6 +7,9 @@ * OpenRegister objects that reference a given file ID and aggregating * extraction / entity-recognition metadata for the Extraction tab. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/GraphQL/GraphQLErrorFormatter.php b/lib/Service/GraphQL/GraphQLErrorFormatter.php index b72ed01514a7..dfb7e6c9130e 100644 --- a/lib/Service/GraphQL/GraphQLErrorFormatter.php +++ b/lib/Service/GraphQL/GraphQLErrorFormatter.php @@ -5,6 +5,9 @@ * * Formats GraphQL errors into structured responses with extension codes. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL * diff --git a/lib/Service/GraphQL/GraphQLResolver.php b/lib/Service/GraphQL/GraphQLResolver.php index ab513dd108e9..e1d5895a4870 100644 --- a/lib/Service/GraphQL/GraphQLResolver.php +++ b/lib/Service/GraphQL/GraphQLResolver.php @@ -6,6 +6,9 @@ * Resolves GraphQL queries, mutations, and fields by delegating * to OpenRegister services with RBAC enforcement and DataLoader batching. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL * @author Conduction B.V. diff --git a/lib/Service/GraphQL/GraphQLService.php b/lib/Service/GraphQL/GraphQLService.php index e6b710325a2f..98bd4cc193fb 100644 --- a/lib/Service/GraphQL/GraphQLService.php +++ b/lib/Service/GraphQL/GraphQLService.php @@ -5,6 +5,9 @@ * * Main service for executing GraphQL queries with schema caching and complexity analysis. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL * diff --git a/lib/Service/GraphQL/QueryComplexityAnalyzer.php b/lib/Service/GraphQL/QueryComplexityAnalyzer.php index a3da9b8400fa..d442cef9c507 100644 --- a/lib/Service/GraphQL/QueryComplexityAnalyzer.php +++ b/lib/Service/GraphQL/QueryComplexityAnalyzer.php @@ -5,6 +5,9 @@ * * Analyzes GraphQL query complexity and enforces limits to prevent resource abuse. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL * diff --git a/lib/Service/GraphQL/Scalar/DateTimeType.php b/lib/Service/GraphQL/Scalar/DateTimeType.php index 2c559570ec17..1a09312742f5 100644 --- a/lib/Service/GraphQL/Scalar/DateTimeType.php +++ b/lib/Service/GraphQL/Scalar/DateTimeType.php @@ -5,6 +5,9 @@ * * Handles serialization and parsing of ISO 8601 date-time strings. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL\Scalar * diff --git a/lib/Service/GraphQL/Scalar/EmailType.php b/lib/Service/GraphQL/Scalar/EmailType.php index 498baca95729..c04a32a6c7e0 100644 --- a/lib/Service/GraphQL/Scalar/EmailType.php +++ b/lib/Service/GraphQL/Scalar/EmailType.php @@ -5,6 +5,9 @@ * * Validates and handles RFC 5321 email address strings. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL\Scalar * diff --git a/lib/Service/GraphQL/Scalar/JsonType.php b/lib/Service/GraphQL/Scalar/JsonType.php index 7cb8357934fd..635ac69d3b86 100644 --- a/lib/Service/GraphQL/Scalar/JsonType.php +++ b/lib/Service/GraphQL/Scalar/JsonType.php @@ -5,6 +5,9 @@ * * Handles arbitrary JSON values including objects, arrays, and scalars. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL\Scalar * diff --git a/lib/Service/GraphQL/Scalar/UploadType.php b/lib/Service/GraphQL/Scalar/UploadType.php index 7e5ca0c50af0..9cf63ea89ba1 100644 --- a/lib/Service/GraphQL/Scalar/UploadType.php +++ b/lib/Service/GraphQL/Scalar/UploadType.php @@ -5,6 +5,9 @@ * * Follows the GraphQL multipart request specification for file uploads. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL\Scalar * diff --git a/lib/Service/GraphQL/Scalar/UriType.php b/lib/Service/GraphQL/Scalar/UriType.php index ca6d484ca10d..a2d119a3523c 100644 --- a/lib/Service/GraphQL/Scalar/UriType.php +++ b/lib/Service/GraphQL/Scalar/UriType.php @@ -5,6 +5,9 @@ * * Validates and handles RFC 3986 URI strings. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL\Scalar * diff --git a/lib/Service/GraphQL/Scalar/UuidType.php b/lib/Service/GraphQL/Scalar/UuidType.php index 621cdfcb9fa5..7bc1f2229709 100644 --- a/lib/Service/GraphQL/Scalar/UuidType.php +++ b/lib/Service/GraphQL/Scalar/UuidType.php @@ -5,6 +5,9 @@ * * Validates and handles UUID v4 format strings. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL\Scalar * diff --git a/lib/Service/GraphQL/SchemaGenerator.php b/lib/Service/GraphQL/SchemaGenerator.php index dada62014914..18ef4635cfd5 100644 --- a/lib/Service/GraphQL/SchemaGenerator.php +++ b/lib/Service/GraphQL/SchemaGenerator.php @@ -10,6 +10,9 @@ * Delegates type mapping to TypeMapperHandler and composition logic to * CompositionHandler to keep class complexity manageable. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL * @author Conduction B.V. diff --git a/lib/Service/GraphQL/SchemaGenerator/CompositionHandler.php b/lib/Service/GraphQL/SchemaGenerator/CompositionHandler.php index 5ec32171c244..966c48934081 100644 --- a/lib/Service/GraphQL/SchemaGenerator/CompositionHandler.php +++ b/lib/Service/GraphQL/SchemaGenerator/CompositionHandler.php @@ -5,6 +5,9 @@ * * Extracted from SchemaGenerator to reduce class complexity. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL\SchemaGenerator * @author Conduction B.V. diff --git a/lib/Service/GraphQL/SchemaGenerator/TypeMapperHandler.php b/lib/Service/GraphQL/SchemaGenerator/TypeMapperHandler.php index b3555a3bc61f..7622a74f9b87 100644 --- a/lib/Service/GraphQL/SchemaGenerator/TypeMapperHandler.php +++ b/lib/Service/GraphQL/SchemaGenerator/TypeMapperHandler.php @@ -5,6 +5,9 @@ * * Extracted from SchemaGenerator to reduce class complexity. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL\SchemaGenerator * @author Conduction B.V. diff --git a/lib/Service/GraphQL/SubscriptionService.php b/lib/Service/GraphQL/SubscriptionService.php index d82a12924779..c0a1bfca3e83 100644 --- a/lib/Service/GraphQL/SubscriptionService.php +++ b/lib/Service/GraphQL/SubscriptionService.php @@ -6,6 +6,9 @@ * Manages server-sent event (SSE) subscriptions for GraphQL real-time updates. * Bridges OpenRegister's event system to GraphQL subscription delivery. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\GraphQL * diff --git a/lib/Service/HookExecutor.php b/lib/Service/HookExecutor.php index 3663c58dae83..023f080bb8e9 100644 --- a/lib/Service/HookExecutor.php +++ b/lib/Service/HookExecutor.php @@ -5,6 +5,9 @@ * * Orchestrates schema hook execution for object lifecycle events. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ImportService.php b/lib/Service/ImportService.php index 9b9bff4697c4..9353dd27f789 100644 --- a/lib/Service/ImportService.php +++ b/lib/Service/ImportService.php @@ -5,6 +5,9 @@ * * This file contains the class for handling data import operations in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/IndexService.php b/lib/Service/IndexService.php index 6c6f8b719364..23018dc61d35 100644 --- a/lib/Service/IndexService.php +++ b/lib/Service/IndexService.php @@ -6,6 +6,9 @@ * Main service for search indexing operations. * Acts as a facade coordinating FileHandler, ObjectHandler, and SchemaHandler. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/LanguageService.php b/lib/Service/LanguageService.php index d3661f52f6cc..302a41ecea04 100644 --- a/lib/Service/LanguageService.php +++ b/lib/Service/LanguageService.php @@ -6,6 +6,9 @@ * Request-scoped service that stores the resolved language from the Accept-Language header. * Used by RenderObject and SaveObject to determine which translation variant to serve or store. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Lifecycle/LifecycleAnnotationValidator.php b/lib/Service/Lifecycle/LifecycleAnnotationValidator.php index 3820d8478f95..ace1cc821f53 100644 --- a/lib/Service/Lifecycle/LifecycleAnnotationValidator.php +++ b/lib/Service/Lifecycle/LifecycleAnnotationValidator.php @@ -9,6 +9,9 @@ * Per ADR-024 (hydra#202), schemas declare state machines via this annotation; * the implementation is in `lifecycle-annotation` change directory. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Lifecycle * diff --git a/lib/Service/Lifecycle/LifecycleGuardRegistry.php b/lib/Service/Lifecycle/LifecycleGuardRegistry.php index daedc730f3cb..139afc470552 100644 --- a/lib/Service/Lifecycle/LifecycleGuardRegistry.php +++ b/lib/Service/Lifecycle/LifecycleGuardRegistry.php @@ -10,6 +10,9 @@ * Cache per request — multiple transitions on the same object during one * request reuse the resolved instance. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Lifecycle * diff --git a/lib/Service/Lifecycle/TransitionEngine.php b/lib/Service/Lifecycle/TransitionEngine.php index e7e109a03d2a..ca807d1ed5af 100644 --- a/lib/Service/Lifecycle/TransitionEngine.php +++ b/lib/Service/Lifecycle/TransitionEngine.php @@ -9,6 +9,9 @@ * eventing, and audit machinery runs unchanged), and dispatches the * typed ObjectTransitionedEvent. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Lifecycle * diff --git a/lib/Service/LinkedEntityService.php b/lib/Service/LinkedEntityService.php index 79c7b6b6cbcf..1dbce2a0882a 100644 --- a/lib/Service/LinkedEntityService.php +++ b/lib/Service/LinkedEntityService.php @@ -3,6 +3,9 @@ /** * LinkedEntityService * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Service/LogService.php b/lib/Service/LogService.php index c55ab33db381..7f33bdaceb67 100644 --- a/lib/Service/LogService.php +++ b/lib/Service/LogService.php @@ -5,6 +5,9 @@ * * Service class for handling audit trail logs in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ManifestService.php b/lib/Service/ManifestService.php index 3b8a49f1a546..72a7c69abbf7 100644 --- a/lib/Service/ManifestService.php +++ b/lib/Service/ManifestService.php @@ -14,6 +14,9 @@ * 4. Logged-in user, profile found → `runtime.user` populated with every * `x-openregister-calculations.*` field evaluated against the profile object. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/MappingService.php b/lib/Service/MappingService.php index 8aa990599016..22756b02b3ae 100644 --- a/lib/Service/MappingService.php +++ b/lib/Service/MappingService.php @@ -6,6 +6,9 @@ * Service for executing data mappings using Twig templating and dot notation. * Provides data transformation capabilities between different formats. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/McpDiscoveryService.php b/lib/Service/McpDiscoveryService.php index 83f42dfbad9d..13d379b2814f 100644 --- a/lib/Service/McpDiscoveryService.php +++ b/lib/Service/McpDiscoveryService.php @@ -5,6 +5,9 @@ * * Provides AI agents with tiered discovery of OpenRegister's API capabilities. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/MetricsService.php b/lib/Service/MetricsService.php index 6fb59e80514d..2010ddebbc84 100644 --- a/lib/Service/MetricsService.php +++ b/lib/Service/MetricsService.php @@ -5,6 +5,9 @@ * * Service for tracking and retrieving operational metrics. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/MigrationService.php b/lib/Service/MigrationService.php index 7d5fcd4813b8..f48a11a2c8b5 100644 --- a/lib/Service/MigrationService.php +++ b/lib/Service/MigrationService.php @@ -2,6 +2,9 @@ /** * MigrationService for OpenRegister. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/NoteService.php b/lib/Service/NoteService.php index f561513d8fe0..94fe112210f1 100644 --- a/lib/Service/NoteService.php +++ b/lib/Service/NoteService.php @@ -6,6 +6,9 @@ * Service that wraps Nextcloud's ICommentsManager for adding notes to OpenRegister objects. * Notes are stored as standard Nextcloud comments with objectType "openregister". * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/NotificationService.php b/lib/Service/NotificationService.php index 19efa0aa3110..4ebefca9dfad 100644 --- a/lib/Service/NotificationService.php +++ b/lib/Service/NotificationService.php @@ -6,6 +6,9 @@ * This file contains the service class for sending notifications * about configuration updates in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Oas/OasETagComputer.php b/lib/Service/Oas/OasETagComputer.php index 8016a996fb6c..0863bb6aa178 100644 --- a/lib/Service/Oas/OasETagComputer.php +++ b/lib/Service/Oas/OasETagComputer.php @@ -13,6 +13,9 @@ * `304 Not Modified` when the client sends an `If-None-Match` matching * the current ETag. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Oas * diff --git a/lib/Service/Oas/OasRequestValidator.php b/lib/Service/Oas/OasRequestValidator.php index 7dc35e6e178a..2d2d7bc92228 100644 --- a/lib/Service/Oas/OasRequestValidator.php +++ b/lib/Service/Oas/OasRequestValidator.php @@ -12,6 +12,9 @@ * Validation errors are emitted in a flat list of `{ path, message }` * tuples ready to be wrapped by `ProblemDetailsBuilder::validationFailed`. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Oas * diff --git a/lib/Service/Oas/ProblemDetailsBuilder.php b/lib/Service/Oas/ProblemDetailsBuilder.php index 167d7724b301..df468a988ce7 100644 --- a/lib/Service/Oas/ProblemDetailsBuilder.php +++ b/lib/Service/Oas/ProblemDetailsBuilder.php @@ -19,6 +19,9 @@ * HTTP error response carries the same machine-readable shape and the * `Content-Type: application/problem+json` header. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Oas * diff --git a/lib/Service/OasService.php b/lib/Service/OasService.php index de7ca0f751df..bcd5a3872962 100644 --- a/lib/Service/OasService.php +++ b/lib/Service/OasService.php @@ -5,6 +5,9 @@ * * This service generates OpenAPI Specification (OAS) documentation for registers and schemas. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ObjectService.php b/lib/Service/ObjectService.php index 6a5aaddb21dc..a74507906827 100644 --- a/lib/Service/ObjectService.php +++ b/lib/Service/ObjectService.php @@ -8,6 +8,9 @@ * This service acts as a facade for the various object handlers, * coordinating operations between them and maintaining state. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Objects * diff --git a/lib/Service/ObjectServiceMapperAdapter.php b/lib/Service/ObjectServiceMapperAdapter.php index d0931493ce64..adce65a8d0ca 100644 --- a/lib/Service/ObjectServiceMapperAdapter.php +++ b/lib/Service/ObjectServiceMapperAdapter.php @@ -2,6 +2,9 @@ /** * Adapter that exposes a mapper-like API over ObjectService. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/OperatorEvaluator.php b/lib/Service/OperatorEvaluator.php index 38332d0c244b..224e91505aba 100644 --- a/lib/Service/OperatorEvaluator.php +++ b/lib/Service/OperatorEvaluator.php @@ -9,6 +9,9 @@ * Extracted from PropertyRbacHandler / ConditionMatcher to keep class * complexity manageable. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/OrganisationService.php b/lib/Service/OrganisationService.php index 9960b6c34807..f81df5b45455 100644 --- a/lib/Service/OrganisationService.php +++ b/lib/Service/OrganisationService.php @@ -6,6 +6,9 @@ * This file contains the service class for managing organisations and multi-tenancy. * Handles user-organisation relationships, session management, and organisational context. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/PropertyRbacHandler.php b/lib/Service/PropertyRbacHandler.php index 9ba9a2ea1525..22b32444185f 100644 --- a/lib/Service/PropertyRbacHandler.php +++ b/lib/Service/PropertyRbacHandler.php @@ -27,6 +27,9 @@ * } * } * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/RealtimeService.php b/lib/Service/RealtimeService.php index 6effdb2af631..bc9ab5ad1b79 100644 --- a/lib/Service/RealtimeService.php +++ b/lib/Service/RealtimeService.php @@ -21,6 +21,9 @@ * - debounce / batch coalescing * - frontend reactive store wiring * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/RegisterService.php b/lib/Service/RegisterService.php index ecf9b6127056..07574ff0366d 100644 --- a/lib/Service/RegisterService.php +++ b/lib/Service/RegisterService.php @@ -8,6 +8,9 @@ * This service acts as a facade for register operations, * coordinating between RegisterMapper and FileService. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Registers/RegisterCacheHandler.php b/lib/Service/Registers/RegisterCacheHandler.php index 808ba9e5c58f..bcfabdbe8344 100644 --- a/lib/Service/Registers/RegisterCacheHandler.php +++ b/lib/Service/Registers/RegisterCacheHandler.php @@ -10,6 +10,9 @@ * cache window on {@see \OCA\OpenRegister\Db\RegisterMapper} so that follow-up * reads in the same PHP worker observe a fresh state. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Registers * diff --git a/lib/Service/RequestScopedCache.php b/lib/Service/RequestScopedCache.php index 52e92930d320..f6a61bb66ca3 100644 --- a/lib/Service/RequestScopedCache.php +++ b/lib/Service/RequestScopedCache.php @@ -7,6 +7,9 @@ * HTTP request. Nextcloud DI registers services as shared by default, so all * service injections within one request receive the same instance. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/RetentionService.php b/lib/Service/RetentionService.php index 003597f8af31..7444074d368c 100644 --- a/lib/Service/RetentionService.php +++ b/lib/Service/RetentionService.php @@ -6,6 +6,9 @@ * Orchestrates archival lifecycle operations: metadata population, archiefactiedatum * calculation, selectielijst lookup, legal hold management, and destruction coordination. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/RiskLevelService.php b/lib/Service/RiskLevelService.php index d3d05ba9ba91..7e0278effde0 100644 --- a/lib/Service/RiskLevelService.php +++ b/lib/Service/RiskLevelService.php @@ -20,6 +20,9 @@ * If the total entity count exceeds 50, the risk level is escalated by one tier * (capped at very_high). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/SchemaService.php b/lib/Service/SchemaService.php index 69f70b6547be..000047af0112 100644 --- a/lib/Service/SchemaService.php +++ b/lib/Service/SchemaService.php @@ -6,6 +6,9 @@ * This file contains the service class for handling schema exploration and analysis * operations in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/SearchTrailService.php b/lib/Service/SearchTrailService.php index 652b56385186..af5ab961a217 100644 --- a/lib/Service/SearchTrailService.php +++ b/lib/Service/SearchTrailService.php @@ -9,6 +9,9 @@ * * This service also supports self-clearing (automatic cleanup) of old search trails. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/SecurityService.php b/lib/Service/SecurityService.php index 5be0989b54de..39ec827ee020 100644 --- a/lib/Service/SecurityService.php +++ b/lib/Service/SecurityService.php @@ -5,6 +5,9 @@ * * Service for handling security measures including rate limiting and XSS protection. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/Settings/CacheSettingsHandler.php b/lib/Service/Settings/CacheSettingsHandler.php index 4b4e33ce2384..df3a83370e10 100644 --- a/lib/Service/Settings/CacheSettingsHandler.php +++ b/lib/Service/Settings/CacheSettingsHandler.php @@ -5,6 +5,9 @@ * * This file contains the handler class for managing cache operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Settings * diff --git a/lib/Service/Settings/ConfigurationSettingsHandler.php b/lib/Service/Settings/ConfigurationSettingsHandler.php index e267bb2e3392..e8f8f6d8606a 100644 --- a/lib/Service/Settings/ConfigurationSettingsHandler.php +++ b/lib/Service/Settings/ConfigurationSettingsHandler.php @@ -5,6 +5,9 @@ * * This file contains the handler class for managing general configuration settings. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Settings * diff --git a/lib/Service/Settings/FileSettingsHandler.php b/lib/Service/Settings/FileSettingsHandler.php index 75da2880e97f..6bd3e08c6ab2 100644 --- a/lib/Service/Settings/FileSettingsHandler.php +++ b/lib/Service/Settings/FileSettingsHandler.php @@ -5,6 +5,9 @@ * * This file contains the handler class for managing file management configuration. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Settings * diff --git a/lib/Service/Settings/LlmSettingsHandler.php b/lib/Service/Settings/LlmSettingsHandler.php index 1d66ded4392c..624c8c21607b 100644 --- a/lib/Service/Settings/LlmSettingsHandler.php +++ b/lib/Service/Settings/LlmSettingsHandler.php @@ -5,6 +5,9 @@ * * This file contains the handler class for managing LLM provider configuration. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Settings * diff --git a/lib/Service/Settings/ObjectRetentionHandler.php b/lib/Service/Settings/ObjectRetentionHandler.php index 4e00de0ffc46..e30c7afdae3a 100644 --- a/lib/Service/Settings/ObjectRetentionHandler.php +++ b/lib/Service/Settings/ObjectRetentionHandler.php @@ -3,6 +3,9 @@ /** * OpenRegister Object and Retention Settings Handler * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Settings * diff --git a/lib/Service/Settings/SearchBackendHandler.php b/lib/Service/Settings/SearchBackendHandler.php index 1915952a8b80..5e0fbbe0d4cc 100644 --- a/lib/Service/Settings/SearchBackendHandler.php +++ b/lib/Service/Settings/SearchBackendHandler.php @@ -5,6 +5,9 @@ * * This file contains the handler class for managing search backend configuration. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Settings * diff --git a/lib/Service/Settings/SolrSettingsHandler.php b/lib/Service/Settings/SolrSettingsHandler.php index b24f0f505985..365282eafc19 100644 --- a/lib/Service/Settings/SolrSettingsHandler.php +++ b/lib/Service/Settings/SolrSettingsHandler.php @@ -5,6 +5,9 @@ * * This file contains the handler class for managing SOLR configuration and operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service\Settings * diff --git a/lib/Service/Settings/ValidationOperationsHandler.php b/lib/Service/Settings/ValidationOperationsHandler.php index 2a4a48052da3..55165c85860f 100644 --- a/lib/Service/Settings/ValidationOperationsHandler.php +++ b/lib/Service/Settings/ValidationOperationsHandler.php @@ -5,6 +5,9 @@ * * Handles administrative validation operations for all objects in the system. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Service\Settings * diff --git a/lib/Service/SettingsService.php b/lib/Service/SettingsService.php index b6609edb5e34..3d6d763643b5 100644 --- a/lib/Service/SettingsService.php +++ b/lib/Service/SettingsService.php @@ -5,6 +5,9 @@ * * This file contains the service class for handling settings in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/TaskService.php b/lib/Service/TaskService.php index 4d8df24463ea..c7d39a698658 100644 --- a/lib/Service/TaskService.php +++ b/lib/Service/TaskService.php @@ -7,6 +7,9 @@ * Tasks are stored as standard VTODO items in the user's Nextcloud calendar with * X-OPENREGISTER-* properties for linking and an RFC 9253 LINK property. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * @author Conduction Development Team diff --git a/lib/Service/TenantKeyService.php b/lib/Service/TenantKeyService.php index f045a0455870..025da3bf5c5b 100644 --- a/lib/Service/TenantKeyService.php +++ b/lib/Service/TenantKeyService.php @@ -16,6 +16,9 @@ * - This service is an internal server-side API only; it is not wired * into any HTTP controller. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/TenantLifecycleService.php b/lib/Service/TenantLifecycleService.php index 3792486be20d..07f80a5eec06 100644 --- a/lib/Service/TenantLifecycleService.php +++ b/lib/Service/TenantLifecycleService.php @@ -7,6 +7,9 @@ * provisioning -> active -> suspended -> deprovisioning -> archived. * Also handles reactivation from suspended back to active. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/TextExtractionService.php b/lib/Service/TextExtractionService.php index 1499147c11b4..e9d173fefb29 100644 --- a/lib/Service/TextExtractionService.php +++ b/lib/Service/TextExtractionService.php @@ -6,6 +6,9 @@ * This service handles all text extraction logic for files in the system. * It consolidates extraction workflows, file tracking, and re-extraction detection. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/TmloService.php b/lib/Service/TmloService.php index 34678e82d90a..7ff704b0dc0c 100644 --- a/lib/Service/TmloService.php +++ b/lib/Service/TmloService.php @@ -12,6 +12,9 @@ * - TMLO field value validation * - MDTO-compliant XML export generation * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ToolRegistry.php b/lib/Service/ToolRegistry.php index aec9b8b4161b..8c8be0674171 100644 --- a/lib/Service/ToolRegistry.php +++ b/lib/Service/ToolRegistry.php @@ -6,6 +6,9 @@ * Central registry for managing LLphant function tools from all apps. * Allows other Nextcloud apps to register their own tools for agents to use. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/TranslationProjectionService.php b/lib/Service/TranslationProjectionService.php index 0767a4f186aa..b58ce08deeec 100644 --- a/lib/Service/TranslationProjectionService.php +++ b/lib/Service/TranslationProjectionService.php @@ -11,6 +11,9 @@ * is a derived projection optimised for per-language search, * completeness queries, and workflow status tracking. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/TranslationStatusService.php b/lib/Service/TranslationStatusService.php index cee8a1b7a4aa..001ec404de0f 100644 --- a/lib/Service/TranslationStatusService.php +++ b/lib/Service/TranslationStatusService.php @@ -7,6 +7,9 @@ * per-object completeness queries, search, and bulk discovery * ("find objects missing X translation"). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/UploadService.php b/lib/Service/UploadService.php index aac4dbb7dc95..fdb72a37eadc 100644 --- a/lib/Service/UploadService.php +++ b/lib/Service/UploadService.php @@ -14,6 +14,9 @@ * - CRUD operations on objects * - Audit trails and data aggregation * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/UrnService.php b/lib/Service/UrnService.php index cbae95a6feae..b4b162f3593b 100644 --- a/lib/Service/UrnService.php +++ b/lib/Service/UrnService.php @@ -8,6 +8,9 @@ * across instance migrations: `urn:nl-or:{instance}:{register}:{schema}:{uuid}`. * Resolution is bidirectional — URN → API URL and URL → URN. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/UserService.php b/lib/Service/UserService.php index 7b23c589c0bd..610bbb4a2778 100644 --- a/lib/Service/UserService.php +++ b/lib/Service/UserService.php @@ -7,6 +7,9 @@ * updates, and profile management. It centralizes user operations and provides * a clean interface for controllers and other services. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/VectorizationService.php b/lib/Service/VectorizationService.php index 5cd78a1afd48..b0a569ea5aca 100644 --- a/lib/Service/VectorizationService.php +++ b/lib/Service/VectorizationService.php @@ -6,6 +6,9 @@ * Generic service for vectorizing any entity type (objects, files, etc). * Uses strategy pattern for entity-specific logic. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/ViewService.php b/lib/Service/ViewService.php index ecf5f57bc865..229e072b2705 100644 --- a/lib/Service/ViewService.php +++ b/lib/Service/ViewService.php @@ -8,6 +8,9 @@ * This service acts as a facade for view operations, * coordinating between ViewMapper and business logic. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/WebhookService.php b/lib/Service/WebhookService.php index b1abb2ecb9e9..88a5baf29b23 100644 --- a/lib/Service/WebhookService.php +++ b/lib/Service/WebhookService.php @@ -5,6 +5,9 @@ * * Service for handling webhook delivery. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * diff --git a/lib/Service/WorkflowEngineRegistry.php b/lib/Service/WorkflowEngineRegistry.php index 0b0f9b277e7d..a811f3fc15f4 100644 --- a/lib/Service/WorkflowEngineRegistry.php +++ b/lib/Service/WorkflowEngineRegistry.php @@ -3,6 +3,9 @@ /** * OpenRegister WorkflowEngineRegistry * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Service * @package OCA\OpenRegister\Service * From e0ef82d58cef7424111041aa3c6f37b264e29f1e Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 15:18:52 +0200 Subject: [PATCH 044/333] =?UTF-8?q?chore(spdx):=20add=20EUPL-1.2=20SPDX=20?= =?UTF-8?q?headers=20=E2=80=94=20Controller=20(Bucket=204=20retrofit,=20pa?= =?UTF-8?q?rt=205/7)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mechanical sweep: inserts `SPDX-License-Identifier: EUPL-1.2` + `SPDX-FileCopyrightText: 2026 Conduction B.V.` into the existing file docblock of every file in this PR's scope. Per ADR-014 and the convention in existing files (e.g. lib/Service/AvgComplianceService.php). Scope: lib/Controller/ (86) Part of the openregister coverage-scan retrofit (2026-05-24). Companion to PR #1737 (1/7, misc bundle). --- lib/Controller/ActionsController.php | 3 +++ lib/Controller/AgentsController.php | 3 +++ lib/Controller/ApplicationsController.php | 3 +++ lib/Controller/ApprovalController.php | 3 +++ lib/Controller/ArchivalController.php | 3 +++ lib/Controller/AuditTrailController.php | 3 +++ lib/Controller/BulkController.php | 3 +++ lib/Controller/CalendarEventsController.php | 3 +++ lib/Controller/ChatController.php | 3 +++ lib/Controller/ChatHealthController.php | 3 +++ lib/Controller/ChatStreamController.php | 3 +++ lib/Controller/ConfigurationController.php | 3 +++ lib/Controller/ConfigurationsController.php | 3 +++ lib/Controller/ConsumersController.php | 3 +++ lib/Controller/ContactsController.php | 3 +++ lib/Controller/ConversationController.php | 3 +++ lib/Controller/DashboardController.php | 3 +++ lib/Controller/DeckController.php | 3 +++ lib/Controller/DeletedController.php | 3 +++ lib/Controller/EmailsController.php | 3 +++ lib/Controller/EndpointsController.php | 3 +++ lib/Controller/FileExtractionController.php | 3 +++ lib/Controller/FileSearchController.php | 3 +++ lib/Controller/FileSidebarController.php | 3 +++ lib/Controller/FileTextController.php | 3 +++ lib/Controller/FilesController.php | 3 +++ lib/Controller/GdprEntitiesController.php | 3 +++ lib/Controller/GitHubIssuesController.php | 3 +++ lib/Controller/GraphQLController.php | 3 +++ lib/Controller/GraphQLSubscriptionController.php | 3 +++ lib/Controller/HealthController.php | 3 +++ lib/Controller/HeartbeatController.php | 3 +++ lib/Controller/LinkedEntityController.php | 3 +++ lib/Controller/ManifestController.php | 3 +++ lib/Controller/MappingsController.php | 3 +++ lib/Controller/McpController.php | 3 +++ lib/Controller/McpServerController.php | 3 +++ lib/Controller/MetricsController.php | 3 +++ lib/Controller/MigrationController.php | 3 +++ lib/Controller/NamesController.php | 3 +++ lib/Controller/NotesController.php | 3 +++ lib/Controller/NotificationHistoryController.php | 3 +++ lib/Controller/NotificationSubscriptionsController.php | 3 +++ lib/Controller/OasController.php | 3 +++ lib/Controller/ObjectsController.php | 3 +++ lib/Controller/OrganisationController.php | 3 +++ lib/Controller/RealtimeController.php | 3 +++ lib/Controller/RegistersController.php | 3 +++ lib/Controller/RelationsController.php | 3 +++ lib/Controller/RetentionController.php | 3 +++ lib/Controller/RevertController.php | 3 +++ lib/Controller/ScheduledWorkflowController.php | 3 +++ lib/Controller/SchemasController.php | 3 +++ lib/Controller/ScopesController.php | 3 +++ lib/Controller/SearchController.php | 3 +++ lib/Controller/SearchTrailController.php | 3 +++ lib/Controller/Settings/ApiTokenSettingsController.php | 3 +++ lib/Controller/Settings/CacheSettingsController.php | 3 +++ lib/Controller/Settings/ConfigurationSettingsController.php | 3 +++ lib/Controller/Settings/EdepotSettingsController.php | 3 +++ lib/Controller/Settings/FileSettingsController.php | 3 +++ lib/Controller/Settings/LlmSettingsController.php | 3 +++ lib/Controller/Settings/N8nSettingsController.php | 3 +++ lib/Controller/Settings/SecuritySettingsController.php | 3 +++ lib/Controller/Settings/SolrManagementController.php | 3 +++ lib/Controller/Settings/SolrOperationsController.php | 3 +++ lib/Controller/Settings/SolrSettingsController.php | 3 +++ lib/Controller/Settings/ValidationSettingsController.php | 3 +++ lib/Controller/Settings/VectorSettingsController.php | 3 +++ lib/Controller/SettingsController.php | 3 +++ lib/Controller/SourcesController.php | 3 +++ lib/Controller/TablesController.php | 3 +++ lib/Controller/TagsController.php | 3 +++ lib/Controller/TasksController.php | 3 +++ lib/Controller/TmloController.php | 3 +++ lib/Controller/TransferController.php | 3 +++ lib/Controller/TransitionController.php | 3 +++ lib/Controller/TranslationController.php | 3 +++ lib/Controller/UiController.php | 3 +++ lib/Controller/UrnController.php | 3 +++ lib/Controller/UserController.php | 3 +++ lib/Controller/UserSettingsController.php | 3 +++ lib/Controller/ViewsController.php | 3 +++ lib/Controller/WebhooksController.php | 3 +++ lib/Controller/WorkflowEngineController.php | 3 +++ lib/Controller/WorkflowExecutionController.php | 3 +++ 86 files changed, 258 insertions(+) diff --git a/lib/Controller/ActionsController.php b/lib/Controller/ActionsController.php index 4915da6e3116..c343e8b3b89a 100644 --- a/lib/Controller/ActionsController.php +++ b/lib/Controller/ActionsController.php @@ -5,6 +5,9 @@ * * Controller for handling action management operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/AgentsController.php b/lib/Controller/AgentsController.php index 26bc4e7f76b7..a3194347863e 100644 --- a/lib/Controller/AgentsController.php +++ b/lib/Controller/AgentsController.php @@ -5,6 +5,9 @@ * * This file contains the controller for managing AI agents. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/ApplicationsController.php b/lib/Controller/ApplicationsController.php index b66286ebb9fa..6bbed84710d7 100644 --- a/lib/Controller/ApplicationsController.php +++ b/lib/Controller/ApplicationsController.php @@ -5,6 +5,9 @@ * * This file contains the controller for managing applications. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/ApprovalController.php b/lib/Controller/ApprovalController.php index 210d565c75a4..49f5730d21f4 100644 --- a/lib/Controller/ApprovalController.php +++ b/lib/Controller/ApprovalController.php @@ -3,6 +3,9 @@ /** * OpenRegister ApprovalController * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/ArchivalController.php b/lib/Controller/ArchivalController.php index fd7b4486f9f0..5d5ae87281d4 100644 --- a/lib/Controller/ArchivalController.php +++ b/lib/Controller/ArchivalController.php @@ -6,6 +6,9 @@ * Controller for managing archival destruction workflows including * destruction lists, legal holds, and destruction certificates. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/AuditTrailController.php b/lib/Controller/AuditTrailController.php index 57b71854f702..325b3f616d01 100644 --- a/lib/Controller/AuditTrailController.php +++ b/lib/Controller/AuditTrailController.php @@ -7,6 +7,9 @@ * Provides functionality to retrieve audit trails related to objects within registers and schemas. * Includes hash chain verification, verwerkingsregister, and immutability enforcement. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\AppInfo * diff --git a/lib/Controller/BulkController.php b/lib/Controller/BulkController.php index 8ea5982284c2..cf99a923e646 100644 --- a/lib/Controller/BulkController.php +++ b/lib/Controller/BulkController.php @@ -6,6 +6,9 @@ * Controller for handling bulk operations on objects in the OpenRegister app. * Provides endpoints for bulk delete and save operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/CalendarEventsController.php b/lib/Controller/CalendarEventsController.php index 9dd5b325a5cf..c95b4d7225ff 100644 --- a/lib/Controller/CalendarEventsController.php +++ b/lib/Controller/CalendarEventsController.php @@ -5,6 +5,9 @@ * * REST controller for calendar event relation operations on OpenRegister objects. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/ChatController.php b/lib/Controller/ChatController.php index 48baaf9ff64c..68510107a2b5 100644 --- a/lib/Controller/ChatController.php +++ b/lib/Controller/ChatController.php @@ -5,6 +5,9 @@ * * Controller for handling AI chat API endpoints. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/ChatHealthController.php b/lib/Controller/ChatHealthController.php index 7e53bd3ca9de..d4b2873dd4f4 100644 --- a/lib/Controller/ChatHealthController.php +++ b/lib/Controller/ChatHealthController.php @@ -8,6 +8,9 @@ * the chat backend is configured and reachable — without requiring a * Nextcloud session (PublicPage). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/ChatStreamController.php b/lib/Controller/ChatStreamController.php index 34c6daf65e9c..d50970ad7c7f 100644 --- a/lib/Controller/ChatStreamController.php +++ b/lib/Controller/ChatStreamController.php @@ -15,6 +15,9 @@ * already accommodates this degradation, so no client change is needed * when token streaming lands later. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/ConfigurationController.php b/lib/Controller/ConfigurationController.php index 437bc40b74da..4525acb81b06 100644 --- a/lib/Controller/ConfigurationController.php +++ b/lib/Controller/ConfigurationController.php @@ -5,6 +5,9 @@ * * This file contains the controller class for handling configuration-related API requests. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/ConfigurationsController.php b/lib/Controller/ConfigurationsController.php index 705b83b44474..db6bb1a24dcc 100644 --- a/lib/Controller/ConfigurationsController.php +++ b/lib/Controller/ConfigurationsController.php @@ -6,6 +6,9 @@ * This file contains the controller class for handling configuration operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/ConsumersController.php b/lib/Controller/ConsumersController.php index f6629e1e2679..649df936e1ea 100644 --- a/lib/Controller/ConsumersController.php +++ b/lib/Controller/ConsumersController.php @@ -3,6 +3,9 @@ /** * ConsumersController handles REST API endpoints for consumer management. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/ContactsController.php b/lib/Controller/ContactsController.php index 5e2079116daa..12e0cd21c501 100644 --- a/lib/Controller/ContactsController.php +++ b/lib/Controller/ContactsController.php @@ -5,6 +5,9 @@ * * REST controller for contact relation operations on OpenRegister objects. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/ConversationController.php b/lib/Controller/ConversationController.php index 2b7f62e19cfd..3ec98cfb2cbd 100644 --- a/lib/Controller/ConversationController.php +++ b/lib/Controller/ConversationController.php @@ -5,6 +5,9 @@ * * Controller for handling AI conversation API endpoints. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/DashboardController.php b/lib/Controller/DashboardController.php index 06e533c0b8aa..24c5b7921723 100644 --- a/lib/Controller/DashboardController.php +++ b/lib/Controller/DashboardController.php @@ -6,6 +6,9 @@ * This file contains the controller for handling dashboard related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/DeckController.php b/lib/Controller/DeckController.php index a9b7c07c73ba..4619222c3b3a 100644 --- a/lib/Controller/DeckController.php +++ b/lib/Controller/DeckController.php @@ -5,6 +5,9 @@ * * REST controller for Deck card relation operations on OpenRegister objects. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/DeletedController.php b/lib/Controller/DeletedController.php index 6e9d0e1a1007..7d56f9c7023b 100644 --- a/lib/Controller/DeletedController.php +++ b/lib/Controller/DeletedController.php @@ -6,6 +6,9 @@ * Controller for managing soft deleted objects in the OpenRegister app. * Provides functionality for listing, filtering, restoring, and permanently deleting objects. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/EmailsController.php b/lib/Controller/EmailsController.php index d8fe04eee7be..a719aa153b53 100644 --- a/lib/Controller/EmailsController.php +++ b/lib/Controller/EmailsController.php @@ -5,6 +5,9 @@ * * REST controller for email relation operations on OpenRegister objects. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/EndpointsController.php b/lib/Controller/EndpointsController.php index 795d74706623..c461c28c7dc3 100644 --- a/lib/Controller/EndpointsController.php +++ b/lib/Controller/EndpointsController.php @@ -5,6 +5,9 @@ * * Controller for handling endpoint management operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/FileExtractionController.php b/lib/Controller/FileExtractionController.php index 397d9626e593..91c943b527b9 100644 --- a/lib/Controller/FileExtractionController.php +++ b/lib/Controller/FileExtractionController.php @@ -6,6 +6,9 @@ * This controller handles file operations and text extraction endpoints. * Provides core file extraction functionality accessible via API. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/FileSearchController.php b/lib/Controller/FileSearchController.php index d0fb76dc6d27..52085492c70d 100644 --- a/lib/Controller/FileSearchController.php +++ b/lib/Controller/FileSearchController.php @@ -5,6 +5,9 @@ * * Controller for file search operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/FileSidebarController.php b/lib/Controller/FileSidebarController.php index 75d68ddf0a43..c7631312d838 100644 --- a/lib/Controller/FileSidebarController.php +++ b/lib/Controller/FileSidebarController.php @@ -7,6 +7,9 @@ * Returns OpenRegister object references and extraction metadata * for a given Nextcloud file ID. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/FileTextController.php b/lib/Controller/FileTextController.php index 99c34dc56300..e8c9301844c8 100644 --- a/lib/Controller/FileTextController.php +++ b/lib/Controller/FileTextController.php @@ -5,6 +5,9 @@ * * Controller for file text management operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/FilesController.php b/lib/Controller/FilesController.php index 006c62492609..6805ea69b2fa 100644 --- a/lib/Controller/FilesController.php +++ b/lib/Controller/FilesController.php @@ -5,6 +5,9 @@ * * Controller for file operations in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/GdprEntitiesController.php b/lib/Controller/GdprEntitiesController.php index 42cb78703d2d..939e31c4c2f5 100644 --- a/lib/Controller/GdprEntitiesController.php +++ b/lib/Controller/GdprEntitiesController.php @@ -7,6 +7,9 @@ * Provides endpoints for listing, viewing, and managing detected entities * from text extraction and entity recognition. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/GitHubIssuesController.php b/lib/Controller/GitHubIssuesController.php index ed77e106a3b1..ff1a5d998e50 100644 --- a/lib/Controller/GitHubIssuesController.php +++ b/lib/Controller/GitHubIssuesController.php @@ -13,6 +13,9 @@ * by tasks 1.14 – 1.22 and lands in a follow-up commit. This file implements the core * proxy shape only (tasks 1.3, 1.5, 1.6, 1.7, 1.8, 1.9). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/GraphQLController.php b/lib/Controller/GraphQLController.php index ab82002f2090..48d8723a771d 100644 --- a/lib/Controller/GraphQLController.php +++ b/lib/Controller/GraphQLController.php @@ -6,6 +6,9 @@ * Provides a GraphQL endpoint at /api/graphql and an interactive * GraphiQL explorer at /api/graphql/explorer. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/GraphQLSubscriptionController.php b/lib/Controller/GraphQLSubscriptionController.php index dc9eef044989..827c0e1fccca 100644 --- a/lib/Controller/GraphQLSubscriptionController.php +++ b/lib/Controller/GraphQLSubscriptionController.php @@ -6,6 +6,9 @@ * Provides a Server-Sent Events endpoint for GraphQL subscriptions. * Clients connect via GET and receive real-time object change events. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/HealthController.php b/lib/Controller/HealthController.php index 90aaeb1391af..2ec31c665475 100644 --- a/lib/Controller/HealthController.php +++ b/lib/Controller/HealthController.php @@ -5,6 +5,9 @@ * * Exposes health check endpoint for container orchestration and monitoring. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/HeartbeatController.php b/lib/Controller/HeartbeatController.php index 1e527ffddf00..f0cf244a8834 100644 --- a/lib/Controller/HeartbeatController.php +++ b/lib/Controller/HeartbeatController.php @@ -6,6 +6,9 @@ * This file contains the controller class for handling heartbeat requests in the OpenRegister application. * Used to keep connections alive during long-running operations to prevent gateway timeouts. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/LinkedEntityController.php b/lib/Controller/LinkedEntityController.php index 508fa7fa89f5..0b471fe1d9b3 100644 --- a/lib/Controller/LinkedEntityController.php +++ b/lib/Controller/LinkedEntityController.php @@ -3,6 +3,9 @@ /** * LinkedEntityController * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister * @author Conduction diff --git a/lib/Controller/ManifestController.php b/lib/Controller/ManifestController.php index ac2387ad75b5..c37cfc509f12 100644 --- a/lib/Controller/ManifestController.php +++ b/lib/Controller/ManifestController.php @@ -7,6 +7,9 @@ * app's bundled manifest.json enriched with a `runtime.user` block built * from the authenticated user's OpenRegister profile object. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/MappingsController.php b/lib/Controller/MappingsController.php index 99e89cb0788d..a0115c8a71f9 100644 --- a/lib/Controller/MappingsController.php +++ b/lib/Controller/MappingsController.php @@ -6,6 +6,9 @@ * Controller for managing mapping operations in the OpenRegister app. * Provides endpoints for CRUD operations on mappings used for data transformation. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/McpController.php b/lib/Controller/McpController.php index e0c78c8d3d01..bd14d055b300 100644 --- a/lib/Controller/McpController.php +++ b/lib/Controller/McpController.php @@ -6,6 +6,9 @@ * Controller for MCP (Model Context Protocol) discovery endpoints. * Provides AI agents with tiered API discovery for OpenRegister. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\AppInfo * diff --git a/lib/Controller/McpServerController.php b/lib/Controller/McpServerController.php index 7bf615383d28..c0a5fd729670 100644 --- a/lib/Controller/McpServerController.php +++ b/lib/Controller/McpServerController.php @@ -6,6 +6,9 @@ * Handles the MCP (Model Context Protocol) standard JSON-RPC 2.0 endpoint * for the OpenRegister MCP server. Provides Streamable HTTP transport. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/MetricsController.php b/lib/Controller/MetricsController.php index 612e896d6a62..4bb76b5aec6a 100644 --- a/lib/Controller/MetricsController.php +++ b/lib/Controller/MetricsController.php @@ -5,6 +5,9 @@ * * Exposes application metrics in Prometheus text exposition format. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/MigrationController.php b/lib/Controller/MigrationController.php index a4fadea3443c..61cf757f0706 100644 --- a/lib/Controller/MigrationController.php +++ b/lib/Controller/MigrationController.php @@ -5,6 +5,9 @@ * * Controller for storage migration between blob and magic tables. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/NamesController.php b/lib/Controller/NamesController.php index 3bd70e5d1932..d36531e2fa33 100644 --- a/lib/Controller/NamesController.php +++ b/lib/Controller/NamesController.php @@ -11,6 +11,9 @@ * Utilizes aggressive caching for sub-10ms response times to enable * seamless frontend rendering of object names instead of UUIDs. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/NotesController.php b/lib/Controller/NotesController.php index 352c3d3124e5..5c8efaaafad4 100644 --- a/lib/Controller/NotesController.php +++ b/lib/Controller/NotesController.php @@ -6,6 +6,9 @@ * REST controller for note operations on OpenRegister objects. * Follows the FilesController pattern for sub-resource endpoints. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/NotificationHistoryController.php b/lib/Controller/NotificationHistoryController.php index 2b6a99f6c42c..1ebd7caeff39 100644 --- a/lib/Controller/NotificationHistoryController.php +++ b/lib/Controller/NotificationHistoryController.php @@ -9,6 +9,9 @@ * `Version1Date20260501100000` migration + the `NotificationHistory` * entity + the `NotificationHistoryMapper` query API. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/NotificationSubscriptionsController.php b/lib/Controller/NotificationSubscriptionsController.php index 52b47ef76772..d781a4bff121 100644 --- a/lib/Controller/NotificationSubscriptionsController.php +++ b/lib/Controller/NotificationSubscriptionsController.php @@ -17,6 +17,9 @@ * query: ?registerId=X&schemaId=Y (either may be omitted) * → unsubscribe by tuple * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/OasController.php b/lib/Controller/OasController.php index 7cd386ab42b1..ebeb314c8282 100644 --- a/lib/Controller/OasController.php +++ b/lib/Controller/OasController.php @@ -10,6 +10,9 @@ * response) and `?strict=true` (returns HTTP 422 with the validation report when * any validation error is detected, instead of auto-correcting). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\AppInfo * diff --git a/lib/Controller/ObjectsController.php b/lib/Controller/ObjectsController.php index a6523423791d..3c29a78df5f6 100644 --- a/lib/Controller/ObjectsController.php +++ b/lib/Controller/ObjectsController.php @@ -6,6 +6,9 @@ * Controller for managing object operations in the OpenRegister app. * Provides CRUD functionality for objects within registers and schemas. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/OrganisationController.php b/lib/Controller/OrganisationController.php index 8636df150123..f88cdaa84030 100644 --- a/lib/Controller/OrganisationController.php +++ b/lib/Controller/OrganisationController.php @@ -7,6 +7,9 @@ * Provides API endpoints for organisation management, user-organisation relationships, * and session management for active organisations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/RealtimeController.php b/lib/Controller/RealtimeController.php index b00802059afb..f427b916035c 100644 --- a/lib/Controller/RealtimeController.php +++ b/lib/Controller/RealtimeController.php @@ -7,6 +7,9 @@ * GET /apps/openregister/api/realtime/events?since={cursor}&limit=100 * ®ister=...&schema=...&objectUuid=...&eventType=... * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/RegistersController.php b/lib/Controller/RegistersController.php index d17c6c9420ca..84647d8a1189 100644 --- a/lib/Controller/RegistersController.php +++ b/lib/Controller/RegistersController.php @@ -7,6 +7,9 @@ * Provides endpoints for CRUD operations, import/export, GitHub publishing, * and OpenAPI specification generation. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/RelationsController.php b/lib/Controller/RelationsController.php index 3c6d8dffe7c2..cbb2c8688802 100644 --- a/lib/Controller/RelationsController.php +++ b/lib/Controller/RelationsController.php @@ -5,6 +5,9 @@ * * Unified REST controller that aggregates all relation types for an object. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/RetentionController.php b/lib/Controller/RetentionController.php index 38e91f161088..dc3c2a3d7140 100644 --- a/lib/Controller/RetentionController.php +++ b/lib/Controller/RetentionController.php @@ -6,6 +6,9 @@ * Handles API endpoints for destruction list management, legal holds, * and archival workflow operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/RevertController.php b/lib/Controller/RevertController.php index 95a71f3a438c..4ac4a71056a6 100644 --- a/lib/Controller/RevertController.php +++ b/lib/Controller/RevertController.php @@ -6,6 +6,9 @@ * Controller for managing object reversion operations in the OpenRegister app. * Provides functionality to revert objects to previous states based on different criteria. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\AppInfo * diff --git a/lib/Controller/ScheduledWorkflowController.php b/lib/Controller/ScheduledWorkflowController.php index 235360ddf21b..fbb08ad66488 100644 --- a/lib/Controller/ScheduledWorkflowController.php +++ b/lib/Controller/ScheduledWorkflowController.php @@ -3,6 +3,9 @@ /** * OpenRegister ScheduledWorkflowController * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/SchemasController.php b/lib/Controller/SchemasController.php index 76a5c5b0a6ae..fbe7f154f021 100644 --- a/lib/Controller/SchemasController.php +++ b/lib/Controller/SchemasController.php @@ -7,6 +7,9 @@ * Provides endpoints for CRUD operations, schema exploration, caching, * import/export, and statistics. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/ScopesController.php b/lib/Controller/ScopesController.php index 1069f39a5ef8..65b77fea7198 100644 --- a/lib/Controller/ScopesController.php +++ b/lib/Controller/ScopesController.php @@ -11,6 +11,9 @@ * (register, schema, action) tuples the current user is permitted to * perform without having to probe every endpoint. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/SearchController.php b/lib/Controller/SearchController.php index 5f4538fab02d..d01491522f4f 100644 --- a/lib/Controller/SearchController.php +++ b/lib/Controller/SearchController.php @@ -5,6 +5,9 @@ * * Controller for handling search operations in the OpenRegister app. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\AppInfo * diff --git a/lib/Controller/SearchTrailController.php b/lib/Controller/SearchTrailController.php index a8660faa728c..af06aad52fb5 100644 --- a/lib/Controller/SearchTrailController.php +++ b/lib/Controller/SearchTrailController.php @@ -6,6 +6,9 @@ * Controller for managing search trail operations and analytics in the OpenRegister app. * Provides functionality to retrieve search statistics, popular search terms, and search logs. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/Settings/ApiTokenSettingsController.php b/lib/Controller/Settings/ApiTokenSettingsController.php index 6265444a69fc..873730b97099 100644 --- a/lib/Controller/Settings/ApiTokenSettingsController.php +++ b/lib/Controller/Settings/ApiTokenSettingsController.php @@ -3,6 +3,9 @@ /** * OpenRegister API Token Settings Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/Settings/CacheSettingsController.php b/lib/Controller/Settings/CacheSettingsController.php index f52448e41f6c..b0a754d6775e 100644 --- a/lib/Controller/Settings/CacheSettingsController.php +++ b/lib/Controller/Settings/CacheSettingsController.php @@ -3,6 +3,9 @@ /** * OpenRegister Cache Settings Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/Settings/ConfigurationSettingsController.php b/lib/Controller/Settings/ConfigurationSettingsController.php index 7c4017a295c9..34a1bd4a99a4 100644 --- a/lib/Controller/Settings/ConfigurationSettingsController.php +++ b/lib/Controller/Settings/ConfigurationSettingsController.php @@ -3,6 +3,9 @@ /** * OpenRegister Configuration Settings Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/Settings/EdepotSettingsController.php b/lib/Controller/Settings/EdepotSettingsController.php index f859987747a3..ab2dc4a00879 100644 --- a/lib/Controller/Settings/EdepotSettingsController.php +++ b/lib/Controller/Settings/EdepotSettingsController.php @@ -5,6 +5,9 @@ * * Handles e-Depot endpoint configuration and connection testing. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * diff --git a/lib/Controller/Settings/FileSettingsController.php b/lib/Controller/Settings/FileSettingsController.php index 4f237108a899..f3b6ae6bba93 100644 --- a/lib/Controller/Settings/FileSettingsController.php +++ b/lib/Controller/Settings/FileSettingsController.php @@ -3,6 +3,9 @@ /** * OpenRegister File Settings Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/Settings/LlmSettingsController.php b/lib/Controller/Settings/LlmSettingsController.php index a98e7b902f30..4a7e06f988d6 100644 --- a/lib/Controller/Settings/LlmSettingsController.php +++ b/lib/Controller/Settings/LlmSettingsController.php @@ -3,6 +3,9 @@ /** * OpenRegister LLM Settings Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/Settings/N8nSettingsController.php b/lib/Controller/Settings/N8nSettingsController.php index 6a2f2b82ea80..98dccbfc21d6 100644 --- a/lib/Controller/Settings/N8nSettingsController.php +++ b/lib/Controller/Settings/N8nSettingsController.php @@ -3,6 +3,9 @@ /** * OpenRegister n8n Settings Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/Settings/SecuritySettingsController.php b/lib/Controller/Settings/SecuritySettingsController.php index 1486571a67e7..6b207a187e76 100644 --- a/lib/Controller/Settings/SecuritySettingsController.php +++ b/lib/Controller/Settings/SecuritySettingsController.php @@ -3,6 +3,9 @@ /** * OpenRegister Security Settings Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/Settings/SolrManagementController.php b/lib/Controller/Settings/SolrManagementController.php index ab3b3658a610..a62be5bffbae 100644 --- a/lib/Controller/Settings/SolrManagementController.php +++ b/lib/Controller/Settings/SolrManagementController.php @@ -3,6 +3,9 @@ /** * OpenRegister SOLR Management Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/Settings/SolrOperationsController.php b/lib/Controller/Settings/SolrOperationsController.php index e5b960756ba2..bb166b3995d2 100644 --- a/lib/Controller/Settings/SolrOperationsController.php +++ b/lib/Controller/Settings/SolrOperationsController.php @@ -3,6 +3,9 @@ /** * OpenRegister SOLR Operations Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/Settings/SolrSettingsController.php b/lib/Controller/Settings/SolrSettingsController.php index 2dc42ae67ab3..c8425cfcca46 100644 --- a/lib/Controller/Settings/SolrSettingsController.php +++ b/lib/Controller/Settings/SolrSettingsController.php @@ -3,6 +3,9 @@ /** * OpenRegister SOLR Settings Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/Settings/ValidationSettingsController.php b/lib/Controller/Settings/ValidationSettingsController.php index 5488010dbd17..3275c0376640 100644 --- a/lib/Controller/Settings/ValidationSettingsController.php +++ b/lib/Controller/Settings/ValidationSettingsController.php @@ -3,6 +3,9 @@ /** * OpenRegister Validation Settings Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/Settings/VectorSettingsController.php b/lib/Controller/Settings/VectorSettingsController.php index c91b4d9a6834..3213306d0576 100644 --- a/lib/Controller/Settings/VectorSettingsController.php +++ b/lib/Controller/Settings/VectorSettingsController.php @@ -3,6 +3,9 @@ /** * OpenRegister Vector Settings Controller * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller\Settings * @author Conduction Development Team diff --git a/lib/Controller/SettingsController.php b/lib/Controller/SettingsController.php index dc18965cfebd..2e1f6c3955bb 100644 --- a/lib/Controller/SettingsController.php +++ b/lib/Controller/SettingsController.php @@ -5,6 +5,9 @@ * * This file contains the controller class for handling settings in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/SourcesController.php b/lib/Controller/SourcesController.php index 04ce0bbb017a..0c487c4ec229 100644 --- a/lib/Controller/SourcesController.php +++ b/lib/Controller/SourcesController.php @@ -5,6 +5,9 @@ * * Controller for managing source operations in the OpenRegister app. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/TablesController.php b/lib/Controller/TablesController.php index 3147a9342d3e..537ca2f5f4f5 100644 --- a/lib/Controller/TablesController.php +++ b/lib/Controller/TablesController.php @@ -5,6 +5,9 @@ * * Controller for managing database tables view and magic table operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/TagsController.php b/lib/Controller/TagsController.php index d224a33cccb3..9a183c9d8892 100644 --- a/lib/Controller/TagsController.php +++ b/lib/Controller/TagsController.php @@ -7,6 +7,9 @@ * Provides endpoints for retrieving and managing tags used for categorizing * objects and files. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/TasksController.php b/lib/Controller/TasksController.php index c5606c682638..d798c3547eba 100644 --- a/lib/Controller/TasksController.php +++ b/lib/Controller/TasksController.php @@ -6,6 +6,9 @@ * REST controller for CalDAV task operations on OpenRegister objects. * Follows the FilesController pattern for sub-resource endpoints. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/TmloController.php b/lib/Controller/TmloController.php index a745cf1eb0a3..2f32ae3b20d6 100644 --- a/lib/Controller/TmloController.php +++ b/lib/Controller/TmloController.php @@ -6,6 +6,9 @@ * Controller for TMLO (Toepassingsprofiel Metadatastandaard Lokale Overheden) * metadata operations including MDTO XML export and archival status summary. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/TransferController.php b/lib/Controller/TransferController.php index b464ec7d5dce..2a98744cea04 100644 --- a/lib/Controller/TransferController.php +++ b/lib/Controller/TransferController.php @@ -5,6 +5,9 @@ * * Handles e-Depot transfer list operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/TransitionController.php b/lib/Controller/TransitionController.php index 7e2c77715ede..7c62b50c9b50 100644 --- a/lib/Controller/TransitionController.php +++ b/lib/Controller/TransitionController.php @@ -7,6 +7,9 @@ * x-openregister-lifecycle annotation no longer need to write their * own action endpoint per schema. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/TranslationController.php b/lib/Controller/TranslationController.php index 3b98839b9cae..6e8fc53280ca 100644 --- a/lib/Controller/TranslationController.php +++ b/lib/Controller/TranslationController.php @@ -9,6 +9,9 @@ * GET /api/translations/object/{uuid} — list slots + completeness * POST /api/translations/object/{uuid}/{property}/{language}/status * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/UiController.php b/lib/Controller/UiController.php index 2b414b897630..0b3a92d475c2 100644 --- a/lib/Controller/UiController.php +++ b/lib/Controller/UiController.php @@ -3,6 +3,9 @@ /** * UiController * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category OpenRegister * @package OCA\OpenRegister\Controller * @author Conduction b.v. diff --git a/lib/Controller/UrnController.php b/lib/Controller/UrnController.php index 5dd30c3d1d0c..7b02b2f06f76 100644 --- a/lib/Controller/UrnController.php +++ b/lib/Controller/UrnController.php @@ -8,6 +8,9 @@ * - GET /api/urn/lookup?url=... → URN for the URL * - POST /api/urn/bulk → batch resolve { urns: [...] } * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/UserController.php b/lib/Controller/UserController.php index adf9896fd5a4..d3a258003048 100644 --- a/lib/Controller/UserController.php +++ b/lib/Controller/UserController.php @@ -6,6 +6,9 @@ * Controller for user management operations including profile retrieval * and update operations for the currently authenticated user. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/UserSettingsController.php b/lib/Controller/UserSettingsController.php index e431d1315efb..3f03eb45e7bd 100644 --- a/lib/Controller/UserSettingsController.php +++ b/lib/Controller/UserSettingsController.php @@ -6,6 +6,9 @@ * This file contains the controller class for handling user-specific settings, * particularly GitHub token management. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/ViewsController.php b/lib/Controller/ViewsController.php index 3e49e3db4104..a8ee06960877 100644 --- a/lib/Controller/ViewsController.php +++ b/lib/Controller/ViewsController.php @@ -6,6 +6,9 @@ * Controller for managing saved search views across multiple registers and schemas. * Provides CRUD operations for views that store search configurations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * @author Conduction Development Team diff --git a/lib/Controller/WebhooksController.php b/lib/Controller/WebhooksController.php index f6c51929a243..0ecb271799af 100644 --- a/lib/Controller/WebhooksController.php +++ b/lib/Controller/WebhooksController.php @@ -5,6 +5,9 @@ * * Controller for handling webhook management operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/WorkflowEngineController.php b/lib/Controller/WorkflowEngineController.php index 51dbe29bde5a..16e0cd45a430 100644 --- a/lib/Controller/WorkflowEngineController.php +++ b/lib/Controller/WorkflowEngineController.php @@ -3,6 +3,9 @@ /** * OpenRegister WorkflowEngineController * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * diff --git a/lib/Controller/WorkflowExecutionController.php b/lib/Controller/WorkflowExecutionController.php index adb9fcb8b895..1934437a35f3 100644 --- a/lib/Controller/WorkflowExecutionController.php +++ b/lib/Controller/WorkflowExecutionController.php @@ -3,6 +3,9 @@ /** * OpenRegister WorkflowExecutionController * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Controller * @package OCA\OpenRegister\Controller * From 140d239d696c1e1150469c439800abc2db0c5866 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 15:19:02 +0200 Subject: [PATCH 045/333] =?UTF-8?q?chore(spdx):=20add=20EUPL-1.2=20SPDX=20?= =?UTF-8?q?headers=20=E2=80=94=20Db=20entities=20(Bucket=204=20retrofit,?= =?UTF-8?q?=20part=206/7)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mechanical sweep: inserts `SPDX-License-Identifier: EUPL-1.2` + `SPDX-FileCopyrightText: 2026 Conduction B.V.` into the existing file docblock of every file in this PR's scope. Per ADR-014 and the convention in existing files (e.g. lib/Service/AvgComplianceService.php). Scope: lib/Db/ (103) Part of the openregister coverage-scan retrofit (2026-05-24). Companion to PR #1737 (1/7, misc bundle). --- lib/Db/AbstractObjectMapper.php | 3 +++ lib/Db/Action.php | 3 +++ lib/Db/ActionLog.php | 3 +++ lib/Db/ActionLogMapper.php | 3 +++ lib/Db/ActionMapper.php | 3 +++ lib/Db/Agent.php | 3 +++ lib/Db/AgentMapper.php | 3 +++ lib/Db/Application.php | 3 +++ lib/Db/ApplicationMapper.php | 3 +++ lib/Db/ApprovalChain.php | 3 +++ lib/Db/ApprovalChainMapper.php | 3 +++ lib/Db/ApprovalStep.php | 3 +++ lib/Db/ApprovalStepMapper.php | 3 +++ lib/Db/AuditTrail.php | 3 +++ lib/Db/AuditTrailMapper.php | 3 +++ lib/Db/Chunk.php | 3 +++ lib/Db/ChunkMapper.php | 3 +++ lib/Db/Configuration.php | 3 +++ lib/Db/ConfigurationMapper.php | 3 +++ lib/Db/Consumer.php | 3 +++ lib/Db/ConsumerMapper.php | 3 +++ lib/Db/ContactLink.php | 3 +++ lib/Db/ContactLinkMapper.php | 3 +++ lib/Db/Conversation.php | 3 +++ lib/Db/ConversationMapper.php | 3 +++ lib/Db/DataAccessProfile.php | 3 +++ lib/Db/DataAccessProfileMapper.php | 3 +++ lib/Db/DeckLink.php | 3 +++ lib/Db/DeckLinkMapper.php | 3 +++ lib/Db/DeployedWorkflow.php | 3 +++ lib/Db/DeployedWorkflowMapper.php | 3 +++ lib/Db/DestructionList.php | 3 +++ lib/Db/DestructionListMapper.php | 3 +++ lib/Db/DuplicateDispatchException.php | 3 +++ lib/Db/EmailLink.php | 3 +++ lib/Db/EmailLinkMapper.php | 3 +++ lib/Db/Endpoint.php | 3 +++ lib/Db/EndpointLog.php | 3 +++ lib/Db/EndpointLogMapper.php | 3 +++ lib/Db/EndpointMapper.php | 3 +++ lib/Db/EntityRelation.php | 3 +++ lib/Db/EntityRelationMapper.php | 3 +++ lib/Db/Feedback.php | 3 +++ lib/Db/FeedbackMapper.php | 3 +++ lib/Db/FileMapper.php | 3 +++ lib/Db/GdprEntity.php | 3 +++ lib/Db/GdprEntityMapper.php | 3 +++ lib/Db/MagicMapper.php | 3 +++ lib/Db/MagicMapper/MagicBulkHandler.php | 3 +++ lib/Db/MagicMapper/MagicFacetHandler.php | 3 +++ lib/Db/MagicMapper/MagicOrganizationHandler.php | 3 +++ lib/Db/MagicMapper/MagicRbacHandler.php | 3 +++ lib/Db/MagicMapper/MagicSearchHandler.php | 3 +++ lib/Db/MagicMapper/MagicStatisticsHandler.php | 3 +++ lib/Db/MagicMapper/MagicTableHandler.php | 3 +++ lib/Db/Mapping.php | 3 +++ lib/Db/MappingMapper.php | 3 +++ lib/Db/Message.php | 3 +++ lib/Db/MessageMapper.php | 3 +++ lib/Db/MultiTenancyTrait.php | 3 +++ lib/Db/NotificationDispatchLog.php | 3 +++ lib/Db/NotificationDispatchLogMapper.php | 3 +++ lib/Db/NotificationHistory.php | 3 +++ lib/Db/NotificationHistoryMapper.php | 3 +++ lib/Db/NotificationReadStateEntity.php | 3 +++ lib/Db/NotificationReadStateMapper.php | 3 +++ lib/Db/NotificationSubscription.php | 3 +++ lib/Db/NotificationSubscriptionMapper.php | 3 +++ lib/Db/ObjectEntity.php | 3 +++ lib/Db/ObjectHandlers/HyperFacetHandler.php | 3 +++ lib/Db/ObjectHandlers/MariaDbFacetHandler.php | 3 +++ lib/Db/ObjectHandlers/MariaDbSearchHandler.php | 3 +++ lib/Db/ObjectHandlers/MetaDataFacetHandler.php | 3 +++ lib/Db/ObjectHandlers/OptimizedFacetHandler.php | 3 +++ lib/Db/Organisation.php | 3 +++ lib/Db/OrganisationMapper.php | 3 +++ lib/Db/RealtimeEvent.php | 3 +++ lib/Db/RealtimeEventMapper.php | 3 +++ lib/Db/Register.php | 3 +++ lib/Db/RegisterMapper.php | 3 +++ lib/Db/ScheduledWorkflow.php | 3 +++ lib/Db/ScheduledWorkflowMapper.php | 3 +++ lib/Db/Schema.php | 3 +++ lib/Db/SchemaMapper.php | 3 +++ lib/Db/SearchTrail.php | 3 +++ lib/Db/SearchTrailMapper.php | 3 +++ lib/Db/SelectionList.php | 3 +++ lib/Db/SelectionListMapper.php | 3 +++ lib/Db/Source.php | 3 +++ lib/Db/SourceMapper.php | 3 +++ lib/Db/TenantUsage.php | 3 +++ lib/Db/TenantUsageMapper.php | 3 +++ lib/Db/Translation.php | 3 +++ lib/Db/TranslationMapper.php | 3 +++ lib/Db/View.php | 3 +++ lib/Db/ViewMapper.php | 3 +++ lib/Db/WebhookLog.php | 3 +++ lib/Db/WebhookLogMapper.php | 3 +++ lib/Db/WebhookMapper.php | 3 +++ lib/Db/WorkflowEngine.php | 3 +++ lib/Db/WorkflowEngineMapper.php | 3 +++ lib/Db/WorkflowExecution.php | 3 +++ lib/Db/WorkflowExecutionMapper.php | 3 +++ 103 files changed, 309 insertions(+) diff --git a/lib/Db/AbstractObjectMapper.php b/lib/Db/AbstractObjectMapper.php index ef7242f6d07a..054860e7a493 100644 --- a/lib/Db/AbstractObjectMapper.php +++ b/lib/Db/AbstractObjectMapper.php @@ -7,6 +7,9 @@ * This abstraction allows the system to switch between different storage strategies * (column-mapped storage via MagicMapper) while maintaining a consistent interface. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Action.php b/lib/Db/Action.php index d2262d9b02b4..096bb2489120 100644 --- a/lib/Db/Action.php +++ b/lib/Db/Action.php @@ -5,6 +5,9 @@ * * First-class entity for workflow automation actions. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ActionLog.php b/lib/Db/ActionLog.php index d5c59f4d46fc..aca746609cef 100644 --- a/lib/Db/ActionLog.php +++ b/lib/Db/ActionLog.php @@ -5,6 +5,9 @@ * * Entity for logging action execution attempts and results. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ActionLogMapper.php b/lib/Db/ActionLogMapper.php index 7103e7e4beb1..12a71031bf9d 100644 --- a/lib/Db/ActionLogMapper.php +++ b/lib/Db/ActionLogMapper.php @@ -5,6 +5,9 @@ * * Mapper for ActionLog entities to handle database operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ActionMapper.php b/lib/Db/ActionMapper.php index a2f523c957af..1c22f662de0d 100644 --- a/lib/Db/ActionMapper.php +++ b/lib/Db/ActionMapper.php @@ -5,6 +5,9 @@ * * Mapper for Action entities to handle database operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Agent.php b/lib/Db/Agent.php index 57fa7922ee89..f85efdaf9eea 100644 --- a/lib/Db/Agent.php +++ b/lib/Db/Agent.php @@ -7,6 +7,9 @@ * Agents represent AI agents that can perform automated tasks, chat interactions, * and intelligent data processing. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Entity * @package OCA\OpenRegister\Db * diff --git a/lib/Db/AgentMapper.php b/lib/Db/AgentMapper.php index 510166c6e686..072e54eaff21 100644 --- a/lib/Db/AgentMapper.php +++ b/lib/Db/AgentMapper.php @@ -5,6 +5,9 @@ * * This file contains the AgentMapper class for database operations on agents. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Mapper * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Application.php b/lib/Db/Application.php index 63889b5f8386..34385fc53d4e 100644 --- a/lib/Db/Application.php +++ b/lib/Db/Application.php @@ -6,6 +6,9 @@ * This file contains the Application entity class for the OpenRegister application. * Applications represent software applications or modules within an organisation. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Entity * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ApplicationMapper.php b/lib/Db/ApplicationMapper.php index dfd1c119a7ea..5c04d04433b0 100644 --- a/lib/Db/ApplicationMapper.php +++ b/lib/Db/ApplicationMapper.php @@ -5,6 +5,9 @@ * * This file contains the ApplicationMapper class for database operations on applications. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Mapper * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ApprovalChain.php b/lib/Db/ApprovalChain.php index d0cbee7eb8b5..5fdca16e1c08 100644 --- a/lib/Db/ApprovalChain.php +++ b/lib/Db/ApprovalChain.php @@ -3,6 +3,9 @@ /** * OpenRegister ApprovalChain Entity * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ApprovalChainMapper.php b/lib/Db/ApprovalChainMapper.php index 85b0d1470764..ae305187aea1 100644 --- a/lib/Db/ApprovalChainMapper.php +++ b/lib/Db/ApprovalChainMapper.php @@ -3,6 +3,9 @@ /** * OpenRegister ApprovalChainMapper * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ApprovalStep.php b/lib/Db/ApprovalStep.php index 423265642dce..8571cce8028f 100644 --- a/lib/Db/ApprovalStep.php +++ b/lib/Db/ApprovalStep.php @@ -3,6 +3,9 @@ /** * OpenRegister ApprovalStep Entity * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ApprovalStepMapper.php b/lib/Db/ApprovalStepMapper.php index f5f4c7a7d7b9..0788f3c78439 100644 --- a/lib/Db/ApprovalStepMapper.php +++ b/lib/Db/ApprovalStepMapper.php @@ -3,6 +3,9 @@ /** * OpenRegister ApprovalStepMapper * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/AuditTrail.php b/lib/Db/AuditTrail.php index 67bee798e9e7..a99193fe15f4 100644 --- a/lib/Db/AuditTrail.php +++ b/lib/Db/AuditTrail.php @@ -6,6 +6,9 @@ * This file contains the class for handling audit trail related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/AuditTrailMapper.php b/lib/Db/AuditTrailMapper.php index f0e6a480772f..549d30f017e3 100644 --- a/lib/Db/AuditTrailMapper.php +++ b/lib/Db/AuditTrailMapper.php @@ -6,6 +6,9 @@ * This file contains the class for handling audit trail related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Chunk.php b/lib/Db/Chunk.php index 90cf90e26146..64f92cab6965 100644 --- a/lib/Db/Chunk.php +++ b/lib/Db/Chunk.php @@ -5,6 +5,9 @@ * * Represents a single chunk of text produced from any source. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ChunkMapper.php b/lib/Db/ChunkMapper.php index 2912692d0e1a..08a26f05ea6e 100644 --- a/lib/Db/ChunkMapper.php +++ b/lib/Db/ChunkMapper.php @@ -3,6 +3,9 @@ /** * Mapper for chunk entities. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Configuration.php b/lib/Db/Configuration.php index 9d9c13097090..7f269ea575c7 100644 --- a/lib/Db/Configuration.php +++ b/lib/Db/Configuration.php @@ -5,6 +5,9 @@ * * This file contains the Configuration entity class for the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Entity * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ConfigurationMapper.php b/lib/Db/ConfigurationMapper.php index 0d44bf68d49b..f43f1610dc52 100644 --- a/lib/Db/ConfigurationMapper.php +++ b/lib/Db/ConfigurationMapper.php @@ -5,6 +5,9 @@ * * This file contains the ConfigurationMapper class for database operations on configurations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Mapper * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Consumer.php b/lib/Db/Consumer.php index 4b32ad215c52..9195781b2ba2 100644 --- a/lib/Db/Consumer.php +++ b/lib/Db/Consumer.php @@ -3,6 +3,9 @@ /** * Consumer Entity for API client authentication. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ConsumerMapper.php b/lib/Db/ConsumerMapper.php index 682985175c07..33425c008150 100644 --- a/lib/Db/ConsumerMapper.php +++ b/lib/Db/ConsumerMapper.php @@ -3,6 +3,9 @@ /** * Consumer Mapper for database operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ContactLink.php b/lib/Db/ContactLink.php index ac43fc72d95b..29e8935fe3d2 100644 --- a/lib/Db/ContactLink.php +++ b/lib/Db/ContactLink.php @@ -3,6 +3,9 @@ /** * ContactLink entity for linking CardDAV contacts to OpenRegister objects. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ContactLinkMapper.php b/lib/Db/ContactLinkMapper.php index f53810b22f75..098cb9ce116c 100644 --- a/lib/Db/ContactLinkMapper.php +++ b/lib/Db/ContactLinkMapper.php @@ -3,6 +3,9 @@ /** * Mapper for contact link entities. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Conversation.php b/lib/Db/Conversation.php index 0f3d8261d860..7f49cf1ac671 100644 --- a/lib/Db/Conversation.php +++ b/lib/Db/Conversation.php @@ -6,6 +6,9 @@ * This file contains the Conversation entity class for the OpenRegister application. * Conversations represent AI chat sessions between users and agents. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Entity * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ConversationMapper.php b/lib/Db/ConversationMapper.php index f7943fe57da0..d25702172f49 100644 --- a/lib/Db/ConversationMapper.php +++ b/lib/Db/ConversationMapper.php @@ -5,6 +5,9 @@ * * This file contains the ConversationMapper class for database operations on conversations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Mapper * @package OCA\OpenRegister\Db * diff --git a/lib/Db/DataAccessProfile.php b/lib/Db/DataAccessProfile.php index 8fadec03e59e..efccff0e2f96 100644 --- a/lib/Db/DataAccessProfile.php +++ b/lib/Db/DataAccessProfile.php @@ -5,6 +5,9 @@ * * This file contains the class for the DataAccessProfile entity. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/DataAccessProfileMapper.php b/lib/Db/DataAccessProfileMapper.php index 5f6eecbf7f72..492322b1fbcc 100644 --- a/lib/Db/DataAccessProfileMapper.php +++ b/lib/Db/DataAccessProfileMapper.php @@ -5,6 +5,9 @@ * * This file contains the class for the DataAccessProfile mapper. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/DeckLink.php b/lib/Db/DeckLink.php index 676a3bba172e..53bbb23e10ab 100644 --- a/lib/Db/DeckLink.php +++ b/lib/Db/DeckLink.php @@ -3,6 +3,9 @@ /** * DeckLink entity for linking Nextcloud Deck cards to OpenRegister objects. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/DeckLinkMapper.php b/lib/Db/DeckLinkMapper.php index 8d33e59c0f6e..10f509e35ff1 100644 --- a/lib/Db/DeckLinkMapper.php +++ b/lib/Db/DeckLinkMapper.php @@ -3,6 +3,9 @@ /** * Mapper for deck link entities. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/DeployedWorkflow.php b/lib/Db/DeployedWorkflow.php index 5db0631eca64..cf9b81f26181 100644 --- a/lib/Db/DeployedWorkflow.php +++ b/lib/Db/DeployedWorkflow.php @@ -3,6 +3,9 @@ /** * OpenRegister DeployedWorkflow Entity * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/DeployedWorkflowMapper.php b/lib/Db/DeployedWorkflowMapper.php index 0f9495fdc85b..cf6f9fd51c89 100644 --- a/lib/Db/DeployedWorkflowMapper.php +++ b/lib/Db/DeployedWorkflowMapper.php @@ -3,6 +3,9 @@ /** * OpenRegister DeployedWorkflowMapper * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/DestructionList.php b/lib/Db/DestructionList.php index 46425354a57f..1f038c4b4592 100644 --- a/lib/Db/DestructionList.php +++ b/lib/Db/DestructionList.php @@ -6,6 +6,9 @@ * Represents a destruction list containing objects that are due for * permanent deletion as part of the archival destruction workflow. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/DestructionListMapper.php b/lib/Db/DestructionListMapper.php index 34627a4a540f..90dec6196c37 100644 --- a/lib/Db/DestructionListMapper.php +++ b/lib/Db/DestructionListMapper.php @@ -5,6 +5,9 @@ * * Handles database operations for destruction list entities. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/DuplicateDispatchException.php b/lib/Db/DuplicateDispatchException.php index 8833073f3af3..b8e299a68a19 100644 --- a/lib/Db/DuplicateDispatchException.php +++ b/lib/Db/DuplicateDispatchException.php @@ -10,6 +10,9 @@ * NotificationDispatchLogMapper::record() throws when the index trips, * so callers can abort the send before flagging the message as delivered. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/EmailLink.php b/lib/Db/EmailLink.php index 111790f47ae7..e64ed9745d4c 100644 --- a/lib/Db/EmailLink.php +++ b/lib/Db/EmailLink.php @@ -3,6 +3,9 @@ /** * EmailLink entity for linking Nextcloud Mail messages to OpenRegister objects. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/EmailLinkMapper.php b/lib/Db/EmailLinkMapper.php index a1291e070cc1..5fd19cc0eb2e 100644 --- a/lib/Db/EmailLinkMapper.php +++ b/lib/Db/EmailLinkMapper.php @@ -3,6 +3,9 @@ /** * Mapper for email link entities. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Endpoint.php b/lib/Db/Endpoint.php index 8219b72f13b0..4b48b85ca0c2 100644 --- a/lib/Db/Endpoint.php +++ b/lib/Db/Endpoint.php @@ -6,6 +6,9 @@ * This file contains the class for handling endpoint entity related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/EndpointLog.php b/lib/Db/EndpointLog.php index c20e43bb0e0a..1ea3294fcbb4 100644 --- a/lib/Db/EndpointLog.php +++ b/lib/Db/EndpointLog.php @@ -6,6 +6,9 @@ * This file contains the class for handling endpoint log entity related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/EndpointLogMapper.php b/lib/Db/EndpointLogMapper.php index 3836f0f16832..d0681c0efdc8 100644 --- a/lib/Db/EndpointLogMapper.php +++ b/lib/Db/EndpointLogMapper.php @@ -5,6 +5,9 @@ * * Mapper for EndpointLog entities to handle database operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/EndpointMapper.php b/lib/Db/EndpointMapper.php index 91fdfd36d8a3..cef000995ede 100644 --- a/lib/Db/EndpointMapper.php +++ b/lib/Db/EndpointMapper.php @@ -5,6 +5,9 @@ * * Mapper for Endpoint entities to handle database operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/EntityRelation.php b/lib/Db/EntityRelation.php index 58e33f53dc6e..16bdb8b43a07 100644 --- a/lib/Db/EntityRelation.php +++ b/lib/Db/EntityRelation.php @@ -3,6 +3,9 @@ /** * EntityRelation links detected entities to specific chunks with context. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/EntityRelationMapper.php b/lib/Db/EntityRelationMapper.php index 1ce763e77029..c40b3785d928 100644 --- a/lib/Db/EntityRelationMapper.php +++ b/lib/Db/EntityRelationMapper.php @@ -3,6 +3,9 @@ /** * Mapper for entity relations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Feedback.php b/lib/Db/Feedback.php index b9b9d5fd03d7..5e126f80bf72 100644 --- a/lib/Db/Feedback.php +++ b/lib/Db/Feedback.php @@ -5,6 +5,9 @@ * * Feedback entity for storing user feedback on AI messages. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/FeedbackMapper.php b/lib/Db/FeedbackMapper.php index cce1cd6657a3..68115652271e 100644 --- a/lib/Db/FeedbackMapper.php +++ b/lib/Db/FeedbackMapper.php @@ -5,6 +5,9 @@ * * Mapper for Feedback entities to handle database operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/FileMapper.php b/lib/Db/FileMapper.php index 195736ee8262..93c0413f91d1 100644 --- a/lib/Db/FileMapper.php +++ b/lib/Db/FileMapper.php @@ -6,6 +6,9 @@ * This file contains the class for handling read-only file operations * on the oc_filecache table with share information from oc_share table. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/GdprEntity.php b/lib/Db/GdprEntity.php index e33aad0c816d..67e0f50747d5 100644 --- a/lib/Db/GdprEntity.php +++ b/lib/Db/GdprEntity.php @@ -5,6 +5,9 @@ * * GDPR entity representing detected PII/contact information. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/GdprEntityMapper.php b/lib/Db/GdprEntityMapper.php index 49ec10552c6d..d541bdbd7cf5 100644 --- a/lib/Db/GdprEntityMapper.php +++ b/lib/Db/GdprEntityMapper.php @@ -3,6 +3,9 @@ /** * Mapper for GDPR entities. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/MagicMapper.php b/lib/Db/MagicMapper.php index 2e96424e96c2..3b09fedc83eb 100644 --- a/lib/Db/MagicMapper.php +++ b/lib/Db/MagicMapper.php @@ -20,6 +20,9 @@ * - Schema property columns mapped from JSON schema to SQL types * - Automatic indexing for performance optimization * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/MagicMapper/MagicBulkHandler.php b/lib/Db/MagicMapper/MagicBulkHandler.php index 4e846b20229e..07de317015ea 100644 --- a/lib/Db/MagicMapper/MagicBulkHandler.php +++ b/lib/Db/MagicMapper/MagicBulkHandler.php @@ -22,6 +22,9 @@ * - Optimized INSERT...ON DUPLICATE KEY UPDATE queries * - Reduced SQL overhead compared to generic table operations * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Db\MagicMapper * @author Conduction Development Team diff --git a/lib/Db/MagicMapper/MagicFacetHandler.php b/lib/Db/MagicMapper/MagicFacetHandler.php index d2f21f1c6d53..4645a2974f35 100644 --- a/lib/Db/MagicMapper/MagicFacetHandler.php +++ b/lib/Db/MagicMapper/MagicFacetHandler.php @@ -23,6 +23,9 @@ * - Cardinality estimation for facet optimization * - Multi-level aggregations and drill-down support * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Db\MagicMapper * @author Conduction Development Team diff --git a/lib/Db/MagicMapper/MagicOrganizationHandler.php b/lib/Db/MagicMapper/MagicOrganizationHandler.php index 7da938231670..2c99ba334f1a 100644 --- a/lib/Db/MagicMapper/MagicOrganizationHandler.php +++ b/lib/Db/MagicMapper/MagicOrganizationHandler.php @@ -21,6 +21,9 @@ * - Admin users cross-organization access (configurable) * - Unauthenticated user organization filtering * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Db\MagicMapper * @author Conduction Development Team diff --git a/lib/Db/MagicMapper/MagicRbacHandler.php b/lib/Db/MagicMapper/MagicRbacHandler.php index b025c6cdfec7..2c4962cbe2f4 100644 --- a/lib/Db/MagicMapper/MagicRbacHandler.php +++ b/lib/Db/MagicMapper/MagicRbacHandler.php @@ -22,6 +22,9 @@ * - Admin override capabilities * - Unauthenticated user handling * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Db\MagicMapper * @author Conduction Development Team diff --git a/lib/Db/MagicMapper/MagicSearchHandler.php b/lib/Db/MagicMapper/MagicSearchHandler.php index 9013e0d29025..328073963a55 100644 --- a/lib/Db/MagicMapper/MagicSearchHandler.php +++ b/lib/Db/MagicMapper/MagicSearchHandler.php @@ -22,6 +22,9 @@ * - Optimized counting and sizing operations * - Support for pagination and sorting * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Db\MagicMapper * @author Conduction Development Team diff --git a/lib/Db/MagicMapper/MagicStatisticsHandler.php b/lib/Db/MagicMapper/MagicStatisticsHandler.php index 7267251b3360..cec43bb7151a 100644 --- a/lib/Db/MagicMapper/MagicStatisticsHandler.php +++ b/lib/Db/MagicMapper/MagicStatisticsHandler.php @@ -16,6 +16,9 @@ * - Register/schema pair discovery from database table names * - Row-to-ObjectEntity conversion for magic table rows * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Db\MagicMapper * @author Conduction Development Team diff --git a/lib/Db/MagicMapper/MagicTableHandler.php b/lib/Db/MagicMapper/MagicTableHandler.php index b8a8842e6de7..5c0f377627ee 100644 --- a/lib/Db/MagicMapper/MagicTableHandler.php +++ b/lib/Db/MagicMapper/MagicTableHandler.php @@ -15,6 +15,9 @@ * - Discovery of existing register+schema tables * - Magic mapping configuration checking * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Db\MagicMapper * @author Conduction Development Team diff --git a/lib/Db/Mapping.php b/lib/Db/Mapping.php index 18a74ad14b3e..c4a7f2d30766 100644 --- a/lib/Db/Mapping.php +++ b/lib/Db/Mapping.php @@ -7,6 +7,9 @@ * in the OpenRegister application. Mappings define how to transform data between * different formats using Twig templating. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/MappingMapper.php b/lib/Db/MappingMapper.php index 3f02a918a920..72ee8ad5ac97 100644 --- a/lib/Db/MappingMapper.php +++ b/lib/Db/MappingMapper.php @@ -5,6 +5,9 @@ * * Mapper for Mapping entities to handle database operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Message.php b/lib/Db/Message.php index f3d4b96b0fa0..ed7ba6ceccdc 100644 --- a/lib/Db/Message.php +++ b/lib/Db/Message.php @@ -6,6 +6,9 @@ * This file contains the Message entity class for the OpenRegister application. * Messages represent individual chat messages within conversations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Entity * @package OCA\OpenRegister\Db * diff --git a/lib/Db/MessageMapper.php b/lib/Db/MessageMapper.php index 844e61844c85..9fd86c9f5d14 100644 --- a/lib/Db/MessageMapper.php +++ b/lib/Db/MessageMapper.php @@ -5,6 +5,9 @@ * * This file contains the MessageMapper class for database operations on messages. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Mapper * @package OCA\OpenRegister\Db * diff --git a/lib/Db/MultiTenancyTrait.php b/lib/Db/MultiTenancyTrait.php index 1fdf50ef32a5..b1943c775759 100644 --- a/lib/Db/MultiTenancyTrait.php +++ b/lib/Db/MultiTenancyTrait.php @@ -6,6 +6,9 @@ * This trait provides reusable multi-tenancy and RBAC functionality for mappers. * It handles organisation filtering, permission checks, and security validation. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Trait * @package OCA\OpenRegister\Db * diff --git a/lib/Db/NotificationDispatchLog.php b/lib/Db/NotificationDispatchLog.php index e56f951a38d1..9de0c71cebd2 100644 --- a/lib/Db/NotificationDispatchLog.php +++ b/lib/Db/NotificationDispatchLog.php @@ -13,6 +13,9 @@ * (notification_slug, resolved_idempotency_key) over a configurable * window (default 24 h)." * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/NotificationDispatchLogMapper.php b/lib/Db/NotificationDispatchLogMapper.php index 6dc7cc38e4f3..959c184633a5 100644 --- a/lib/Db/NotificationDispatchLogMapper.php +++ b/lib/Db/NotificationDispatchLogMapper.php @@ -13,6 +13,9 @@ * Row cleanup (`pruneExpired()`) is best-effort: called lazily at * dispatch time and can also be invoked from a background job. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/NotificationHistory.php b/lib/Db/NotificationHistory.php index e2e398348017..99d2fafa1c9e 100644 --- a/lib/Db/NotificationHistory.php +++ b/lib/Db/NotificationHistory.php @@ -8,6 +8,9 @@ * "Notification history MUST be stored and queryable for audit * purposes" requirement. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/NotificationHistoryMapper.php b/lib/Db/NotificationHistoryMapper.php index ee4b9c30cd7c..98b46650599f 100644 --- a/lib/Db/NotificationHistoryMapper.php +++ b/lib/Db/NotificationHistoryMapper.php @@ -10,6 +10,9 @@ * `Version1Date20260501100000` migration + the `NotificationHistory` * entity + the `NotificationHistoryController` REST endpoint. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/NotificationReadStateEntity.php b/lib/Db/NotificationReadStateEntity.php index 341f6b0b909a..937e4db3944f 100644 --- a/lib/Db/NotificationReadStateEntity.php +++ b/lib/Db/NotificationReadStateEntity.php @@ -7,6 +7,9 @@ * records that a specific user has read a specific notification, with * the timestamp of the read. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/NotificationReadStateMapper.php b/lib/Db/NotificationReadStateMapper.php index ed81500aced6..8560887b4b93 100644 --- a/lib/Db/NotificationReadStateMapper.php +++ b/lib/Db/NotificationReadStateMapper.php @@ -16,6 +16,9 @@ * (INSERT race conditions surface as unique-violation, which we map to * "already read"). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/NotificationSubscription.php b/lib/Db/NotificationSubscription.php index cdb2cc9bd8a3..eb2b65498aa5 100644 --- a/lib/Db/NotificationSubscription.php +++ b/lib/Db/NotificationSubscription.php @@ -5,6 +5,9 @@ * * Wraps an `oc_openregister_notification_subscriptions` row. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/NotificationSubscriptionMapper.php b/lib/Db/NotificationSubscriptionMapper.php index 03a96099f2b6..c04125f94a83 100644 --- a/lib/Db/NotificationSubscriptionMapper.php +++ b/lib/Db/NotificationSubscriptionMapper.php @@ -12,6 +12,9 @@ * (user_id, register_id, schema_id) — `subscribe()` returns the * existing row on a duplicate insert. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ObjectEntity.php b/lib/Db/ObjectEntity.php index 76cca5fd65cf..961e1b4bedc3 100644 --- a/lib/Db/ObjectEntity.php +++ b/lib/Db/ObjectEntity.php @@ -6,6 +6,9 @@ * This file contains the class for handling object entity related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ObjectHandlers/HyperFacetHandler.php b/lib/Db/ObjectHandlers/HyperFacetHandler.php index ab9f0b05949d..5f6810d90f83 100644 --- a/lib/Db/ObjectHandlers/HyperFacetHandler.php +++ b/lib/Db/ObjectHandlers/HyperFacetHandler.php @@ -7,6 +7,9 @@ * multi-layered approach to faceting that eliminates performance bottlenecks * through intelligent caching, statistical approximation, and parallel processing. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Db\ObjectHandlers * diff --git a/lib/Db/ObjectHandlers/MariaDbFacetHandler.php b/lib/Db/ObjectHandlers/MariaDbFacetHandler.php index 5d85cd1daf7f..797c4e8ceffe 100644 --- a/lib/Db/ObjectHandlers/MariaDbFacetHandler.php +++ b/lib/Db/ObjectHandlers/MariaDbFacetHandler.php @@ -6,6 +6,9 @@ * This file contains the handler for managing JSON object field facets * using MariaDB JSON functions in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Db\ObjectHandlers * diff --git a/lib/Db/ObjectHandlers/MariaDbSearchHandler.php b/lib/Db/ObjectHandlers/MariaDbSearchHandler.php index 93015377c2f2..9801d25e621a 100644 --- a/lib/Db/ObjectHandlers/MariaDbSearchHandler.php +++ b/lib/Db/ObjectHandlers/MariaDbSearchHandler.php @@ -6,6 +6,9 @@ * This file contains the class for handling MariaDB-specific search operations * for object entities in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db\ObjectHandlers * diff --git a/lib/Db/ObjectHandlers/MetaDataFacetHandler.php b/lib/Db/ObjectHandlers/MetaDataFacetHandler.php index 4e835a6815b8..5020aa1e5b19 100644 --- a/lib/Db/ObjectHandlers/MetaDataFacetHandler.php +++ b/lib/Db/ObjectHandlers/MetaDataFacetHandler.php @@ -6,6 +6,9 @@ * This file contains the handler for managing metadata facets (table columns) * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Db\ObjectHandlers * diff --git a/lib/Db/ObjectHandlers/OptimizedFacetHandler.php b/lib/Db/ObjectHandlers/OptimizedFacetHandler.php index 1796448d1623..59864ad2d2ed 100644 --- a/lib/Db/ObjectHandlers/OptimizedFacetHandler.php +++ b/lib/Db/ObjectHandlers/OptimizedFacetHandler.php @@ -6,6 +6,9 @@ * This handler provides high-performance faceting by using optimized * database queries, query batching, and strategic caching. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Handler * @package OCA\OpenRegister\Db\ObjectHandlers * diff --git a/lib/Db/Organisation.php b/lib/Db/Organisation.php index 67fb166c32c0..bb402100878f 100644 --- a/lib/Db/Organisation.php +++ b/lib/Db/Organisation.php @@ -7,6 +7,9 @@ * The Organisation entity manages multi-tenancy in OpenRegister by linking users * to organisations and providing organisational context for all data. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/OrganisationMapper.php b/lib/Db/OrganisationMapper.php index 6b47eeb16436..da4c22fc35f3 100644 --- a/lib/Db/OrganisationMapper.php +++ b/lib/Db/OrganisationMapper.php @@ -7,6 +7,9 @@ * Handles database operations for Organisation entities including * multi-tenancy user-organisation relationships. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/RealtimeEvent.php b/lib/Db/RealtimeEvent.php index 42b956979367..b6efb37ccb1b 100644 --- a/lib/Db/RealtimeEvent.php +++ b/lib/Db/RealtimeEvent.php @@ -8,6 +8,9 @@ * the realtime endpoint with `?since={id}` to receive every event * newer than their last seen id. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/RealtimeEventMapper.php b/lib/Db/RealtimeEventMapper.php index 96dfc070fd49..236c7198aaec 100644 --- a/lib/Db/RealtimeEventMapper.php +++ b/lib/Db/RealtimeEventMapper.php @@ -7,6 +7,9 @@ * clients call `findSince(?int $since, int $limit, ?array $filters)` to * page through the append-only event log. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Register.php b/lib/Db/Register.php index 90e642387050..86a2354e1942 100644 --- a/lib/Db/Register.php +++ b/lib/Db/Register.php @@ -6,6 +6,9 @@ * This file contains the class for handling register related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/RegisterMapper.php b/lib/Db/RegisterMapper.php index 0988707084c9..ead1b17e6a9d 100644 --- a/lib/Db/RegisterMapper.php +++ b/lib/Db/RegisterMapper.php @@ -6,6 +6,9 @@ * This file contains the class for handling register mapper related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ScheduledWorkflow.php b/lib/Db/ScheduledWorkflow.php index 0d7496585ef5..54b12c661a52 100644 --- a/lib/Db/ScheduledWorkflow.php +++ b/lib/Db/ScheduledWorkflow.php @@ -3,6 +3,9 @@ /** * OpenRegister ScheduledWorkflow Entity * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ScheduledWorkflowMapper.php b/lib/Db/ScheduledWorkflowMapper.php index 595c37306106..b83167b8e5d4 100644 --- a/lib/Db/ScheduledWorkflowMapper.php +++ b/lib/Db/ScheduledWorkflowMapper.php @@ -3,6 +3,9 @@ /** * OpenRegister ScheduledWorkflowMapper * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Schema.php b/lib/Db/Schema.php index f50b537b8165..e2a84a56e5a2 100644 --- a/lib/Db/Schema.php +++ b/lib/Db/Schema.php @@ -6,6 +6,9 @@ * This file contains the class for handling schema related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/SchemaMapper.php b/lib/Db/SchemaMapper.php index 254b86f0c3c2..058f4d0b6aba 100644 --- a/lib/Db/SchemaMapper.php +++ b/lib/Db/SchemaMapper.php @@ -6,6 +6,9 @@ * This file contains the class for handling audit trail related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/SearchTrail.php b/lib/Db/SearchTrail.php index 99e9d542e773..c67e0c49473c 100644 --- a/lib/Db/SearchTrail.php +++ b/lib/Db/SearchTrail.php @@ -6,6 +6,9 @@ * This file contains the class for handling search trail related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/SearchTrailMapper.php b/lib/Db/SearchTrailMapper.php index 8dd950c8a81b..c75dd69775c0 100644 --- a/lib/Db/SearchTrailMapper.php +++ b/lib/Db/SearchTrailMapper.php @@ -6,6 +6,9 @@ * This file contains the mapper class for SearchTrail entities, * providing database operations and statistical queries for search analytics. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/SelectionList.php b/lib/Db/SelectionList.php index 300fce2f4420..9ad264065822 100644 --- a/lib/Db/SelectionList.php +++ b/lib/Db/SelectionList.php @@ -6,6 +6,9 @@ * Represents a selectielijst entry that maps classification categories * to retention periods and archival actions per Dutch archival standards. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/SelectionListMapper.php b/lib/Db/SelectionListMapper.php index 5c994bc5a7ff..324040d6b9d2 100644 --- a/lib/Db/SelectionListMapper.php +++ b/lib/Db/SelectionListMapper.php @@ -5,6 +5,9 @@ * * Handles database operations for selection list entries. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Source.php b/lib/Db/Source.php index 46e0ef098146..68d3ebb0c42f 100644 --- a/lib/Db/Source.php +++ b/lib/Db/Source.php @@ -6,6 +6,9 @@ * This file contains the class for handling source related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/SourceMapper.php b/lib/Db/SourceMapper.php index 50d7f2f58275..d9e71ff231da 100644 --- a/lib/Db/SourceMapper.php +++ b/lib/Db/SourceMapper.php @@ -6,6 +6,9 @@ * This file contains the class for handling source mapper related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/TenantUsage.php b/lib/Db/TenantUsage.php index a6d7c8a43f5a..9887e97283bd 100644 --- a/lib/Db/TenantUsage.php +++ b/lib/Db/TenantUsage.php @@ -6,6 +6,9 @@ * Tracks per-organisation resource usage (requests, bandwidth, storage) * for quota enforcement and dashboard display. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/TenantUsageMapper.php b/lib/Db/TenantUsageMapper.php index b6ea7c0b845f..e52c933e6289 100644 --- a/lib/Db/TenantUsageMapper.php +++ b/lib/Db/TenantUsageMapper.php @@ -5,6 +5,9 @@ * * Database mapper for tenant usage tracking records. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/Translation.php b/lib/Db/Translation.php index 93214b754ce0..0d9f65411a8c 100644 --- a/lib/Db/Translation.php +++ b/lib/Db/Translation.php @@ -7,6 +7,9 @@ * (object × property × language) translation slot, holding the * denormalised value plus its workflow status. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/TranslationMapper.php b/lib/Db/TranslationMapper.php index bad1a3714691..0c78f29ffed0 100644 --- a/lib/Db/TranslationMapper.php +++ b/lib/Db/TranslationMapper.php @@ -6,6 +6,9 @@ * CRUD + search + completeness queries against the unified * `openregister_translations` sidecar. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Db * @package OCA\OpenRegister\Db * diff --git a/lib/Db/View.php b/lib/Db/View.php index 37bf4ee63179..795ddb7c96e1 100644 --- a/lib/Db/View.php +++ b/lib/Db/View.php @@ -6,6 +6,9 @@ * This file contains the class for handling view related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/ViewMapper.php b/lib/Db/ViewMapper.php index c2187adb9e31..f8841cf2822d 100644 --- a/lib/Db/ViewMapper.php +++ b/lib/Db/ViewMapper.php @@ -6,6 +6,9 @@ * This file contains the class for handling view mapper related operations * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/WebhookLog.php b/lib/Db/WebhookLog.php index fb34cdd4f7a9..3e018e7f3dcf 100644 --- a/lib/Db/WebhookLog.php +++ b/lib/Db/WebhookLog.php @@ -5,6 +5,9 @@ * * Entity for logging webhook delivery attempts and results. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/WebhookLogMapper.php b/lib/Db/WebhookLogMapper.php index 458f2369a63f..a930e04170aa 100644 --- a/lib/Db/WebhookLogMapper.php +++ b/lib/Db/WebhookLogMapper.php @@ -5,6 +5,9 @@ * * Mapper for WebhookLog entities to handle database operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/WebhookMapper.php b/lib/Db/WebhookMapper.php index 0ac1e06217c6..16c0adc64de4 100644 --- a/lib/Db/WebhookMapper.php +++ b/lib/Db/WebhookMapper.php @@ -5,6 +5,9 @@ * * Mapper for Webhook entities to handle database operations. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/WorkflowEngine.php b/lib/Db/WorkflowEngine.php index 8f1960b3eb4a..f87a98163f80 100644 --- a/lib/Db/WorkflowEngine.php +++ b/lib/Db/WorkflowEngine.php @@ -3,6 +3,9 @@ /** * OpenRegister WorkflowEngine Entity * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/WorkflowEngineMapper.php b/lib/Db/WorkflowEngineMapper.php index 2eb8b581b958..fffa2b72012c 100644 --- a/lib/Db/WorkflowEngineMapper.php +++ b/lib/Db/WorkflowEngineMapper.php @@ -3,6 +3,9 @@ /** * OpenRegister WorkflowEngineMapper * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/WorkflowExecution.php b/lib/Db/WorkflowExecution.php index 91ae5bed46af..a338e2eb3563 100644 --- a/lib/Db/WorkflowExecution.php +++ b/lib/Db/WorkflowExecution.php @@ -3,6 +3,9 @@ /** * OpenRegister WorkflowExecution Entity * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * diff --git a/lib/Db/WorkflowExecutionMapper.php b/lib/Db/WorkflowExecutionMapper.php index 6059dde800ec..8fe4f21acb99 100644 --- a/lib/Db/WorkflowExecutionMapper.php +++ b/lib/Db/WorkflowExecutionMapper.php @@ -3,6 +3,9 @@ /** * OpenRegister WorkflowExecutionMapper * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Database * @package OCA\OpenRegister\Db * From f071244d31cc60ec7b945c880242ac05ea10e83f Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 15:19:12 +0200 Subject: [PATCH 046/333] =?UTF-8?q?chore(spdx):=20add=20EUPL-1.2=20SPDX=20?= =?UTF-8?q?headers=20=E2=80=94=20Events=20bundle=20(Event,=20EventListener?= =?UTF-8?q?,=20Listener,=20Exception)=20(Bucket=204=20retrofit,=20part=207?= =?UTF-8?q?/7)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mechanical sweep: inserts `SPDX-License-Identifier: EUPL-1.2` + `SPDX-FileCopyrightText: 2026 Conduction B.V.` into the existing file docblock of every file in this PR's scope. Per ADR-014 and the convention in existing files (e.g. lib/Service/AvgComplianceService.php). Scope: lib/Event/ (49), lib/Listener/ (21), lib/Exception/ (13), lib/EventListener/ (3) Part of the openregister coverage-scan retrofit (2026-05-24). Companion to PR #1737 (1/7, misc bundle). --- lib/Event/ActionCreatedEvent.php | 3 +++ lib/Event/ActionDeletedEvent.php | 3 +++ lib/Event/ActionUpdatedEvent.php | 3 +++ lib/Event/AgentCreatedEvent.php | 3 +++ lib/Event/AgentDeletedEvent.php | 3 +++ lib/Event/AgentUpdatedEvent.php | 3 +++ lib/Event/ApplicationCreatedEvent.php | 3 +++ lib/Event/ApplicationDeletedEvent.php | 3 +++ lib/Event/ApplicationUpdatedEvent.php | 3 +++ lib/Event/ConfigurationCreatedEvent.php | 3 +++ lib/Event/ConfigurationDeletedEvent.php | 3 +++ lib/Event/ConfigurationUpdatedEvent.php | 3 +++ lib/Event/ConversationCreatedEvent.php | 3 +++ lib/Event/ConversationDeletedEvent.php | 3 +++ lib/Event/ConversationUpdatedEvent.php | 3 +++ lib/Event/DeepLinkRegistrationEvent.php | 3 +++ lib/Event/FileCopiedEvent.php | 3 +++ lib/Event/FileLockedEvent.php | 3 +++ lib/Event/FileMovedEvent.php | 3 +++ lib/Event/FileRenamedEvent.php | 3 +++ lib/Event/FileUnlockedEvent.php | 3 +++ lib/Event/FileVersionRestoredEvent.php | 3 +++ lib/Event/ObjectCreatedEvent.php | 3 +++ lib/Event/ObjectCreatingEvent.php | 3 +++ lib/Event/ObjectDeletedEvent.php | 3 +++ lib/Event/ObjectDeletingEvent.php | 3 +++ lib/Event/ObjectLockedEvent.php | 3 +++ lib/Event/ObjectRevertedEvent.php | 3 +++ lib/Event/ObjectTransitionedEvent.php | 3 +++ lib/Event/ObjectUnlockedEvent.php | 3 +++ lib/Event/ObjectUpdatedEvent.php | 3 +++ lib/Event/ObjectUpdatingEvent.php | 3 +++ lib/Event/OrganisationCreatedEvent.php | 3 +++ lib/Event/OrganisationDeletedEvent.php | 3 +++ lib/Event/OrganisationUpdatedEvent.php | 3 +++ lib/Event/RegisterCreatedEvent.php | 3 +++ lib/Event/RegisterDeletedEvent.php | 3 +++ lib/Event/RegisterUpdatedEvent.php | 3 +++ lib/Event/SchemaCreatedEvent.php | 3 +++ lib/Event/SchemaDeletedEvent.php | 3 +++ lib/Event/SchemaUpdatedEvent.php | 3 +++ lib/Event/SourceCreatedEvent.php | 3 +++ lib/Event/SourceDeletedEvent.php | 3 +++ lib/Event/SourceUpdatedEvent.php | 3 +++ lib/Event/ToolRegistrationEvent.php | 3 +++ lib/Event/UserProfileUpdatedEvent.php | 3 +++ lib/Event/ViewCreatedEvent.php | 3 +++ lib/Event/ViewDeletedEvent.php | 3 +++ lib/Event/ViewUpdatedEvent.php | 3 +++ lib/EventListener/AbstractNodeFolderEventListener.php | 3 +++ lib/EventListener/AbstractNodesFolderEventListener.php | 3 +++ lib/EventListener/SolrEventListener.php | 3 +++ lib/Exception/AppendOnlyException.php | 3 +++ lib/Exception/ArchivalImmutableException.php | 3 +++ lib/Exception/AuthenticationException.php | 3 +++ lib/Exception/CustomValidationException.php | 3 +++ lib/Exception/DatabaseConstraintException.php | 3 +++ lib/Exception/HookStoppedException.php | 3 +++ lib/Exception/LockedException.php | 3 +++ lib/Exception/NoVtodoCalendarException.php | 3 +++ lib/Exception/NotAuthorizedException.php | 3 +++ lib/Exception/ReferentialIntegrityException.php | 3 +++ lib/Exception/RegisterNotFoundException.php | 3 +++ lib/Exception/SchemaNotFoundException.php | 3 +++ lib/Exception/ValidationException.php | 3 +++ lib/Listener/ActionListener.php | 3 +++ lib/Listener/ActivityEventListener.php | 3 +++ lib/Listener/AggregationCacheInvalidationListener.php | 3 +++ lib/Listener/AggregationThresholdListener.php | 3 +++ lib/Listener/AnnotationNotificationListener.php | 3 +++ lib/Listener/CalculationOnSaveListener.php | 3 +++ lib/Listener/CommentsEntityListener.php | 3 +++ lib/Listener/FileChangeListener.php | 3 +++ lib/Listener/FilesSidebarListener.php | 3 +++ lib/Listener/GraphQLSubscriptionListener.php | 3 +++ lib/Listener/HookListener.php | 3 +++ lib/Listener/LifecycleInitialStateListener.php | 3 +++ lib/Listener/LifecycleValidationListener.php | 3 +++ lib/Listener/MailAppScriptListener.php | 3 +++ lib/Listener/NotifyPushListener.php | 3 +++ lib/Listener/ObjectChangeListener.php | 3 +++ lib/Listener/ObjectCleanupListener.php | 3 +++ lib/Listener/RealtimeEventListener.php | 3 +++ lib/Listener/ToolRegistrationListener.php | 3 +++ lib/Listener/TranslationProjectionListener.php | 3 +++ lib/Listener/WebhookEventListener.php | 3 +++ 86 files changed, 258 insertions(+) diff --git a/lib/Event/ActionCreatedEvent.php b/lib/Event/ActionCreatedEvent.php index 9a1e46fc355b..f00c30493766 100644 --- a/lib/Event/ActionCreatedEvent.php +++ b/lib/Event/ActionCreatedEvent.php @@ -5,6 +5,9 @@ * * Event dispatched when an action is created in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ActionDeletedEvent.php b/lib/Event/ActionDeletedEvent.php index 8488493fddc9..23686879441e 100644 --- a/lib/Event/ActionDeletedEvent.php +++ b/lib/Event/ActionDeletedEvent.php @@ -5,6 +5,9 @@ * * Event dispatched when an action is deleted in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ActionUpdatedEvent.php b/lib/Event/ActionUpdatedEvent.php index 5195bb7a85ad..defc2f1ab060 100644 --- a/lib/Event/ActionUpdatedEvent.php +++ b/lib/Event/ActionUpdatedEvent.php @@ -5,6 +5,9 @@ * * Event dispatched when an action is updated in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/AgentCreatedEvent.php b/lib/Event/AgentCreatedEvent.php index 9ac8aa36a490..19a67dfd1f68 100644 --- a/lib/Event/AgentCreatedEvent.php +++ b/lib/Event/AgentCreatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an agent is created * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/AgentDeletedEvent.php b/lib/Event/AgentDeletedEvent.php index 6b43beabb359..2527750b21cc 100644 --- a/lib/Event/AgentDeletedEvent.php +++ b/lib/Event/AgentDeletedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an agent is deleted * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/AgentUpdatedEvent.php b/lib/Event/AgentUpdatedEvent.php index bda20c4ced81..1eabff01834a 100644 --- a/lib/Event/AgentUpdatedEvent.php +++ b/lib/Event/AgentUpdatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an agent is updated * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ApplicationCreatedEvent.php b/lib/Event/ApplicationCreatedEvent.php index b86a36d7ac71..bce0fc19f50e 100644 --- a/lib/Event/ApplicationCreatedEvent.php +++ b/lib/Event/ApplicationCreatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an application is created * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ApplicationDeletedEvent.php b/lib/Event/ApplicationDeletedEvent.php index d0eb662e99bf..f2d150d22220 100644 --- a/lib/Event/ApplicationDeletedEvent.php +++ b/lib/Event/ApplicationDeletedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an application is deleted * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ApplicationUpdatedEvent.php b/lib/Event/ApplicationUpdatedEvent.php index cb3d60c3f38e..554651100ba5 100644 --- a/lib/Event/ApplicationUpdatedEvent.php +++ b/lib/Event/ApplicationUpdatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an application is updated * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ConfigurationCreatedEvent.php b/lib/Event/ConfigurationCreatedEvent.php index 421adc0e8dd8..5f825d522718 100644 --- a/lib/Event/ConfigurationCreatedEvent.php +++ b/lib/Event/ConfigurationCreatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a configuration is created * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ConfigurationDeletedEvent.php b/lib/Event/ConfigurationDeletedEvent.php index c5b0294d2ac9..dc166c059c20 100644 --- a/lib/Event/ConfigurationDeletedEvent.php +++ b/lib/Event/ConfigurationDeletedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a configuration is deleted * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ConfigurationUpdatedEvent.php b/lib/Event/ConfigurationUpdatedEvent.php index edb2b457ad93..5f6942933ef5 100644 --- a/lib/Event/ConfigurationUpdatedEvent.php +++ b/lib/Event/ConfigurationUpdatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a configuration is updated * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ConversationCreatedEvent.php b/lib/Event/ConversationCreatedEvent.php index 0696e314a8c3..b2aca1e238ec 100644 --- a/lib/Event/ConversationCreatedEvent.php +++ b/lib/Event/ConversationCreatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a conversation is created * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ConversationDeletedEvent.php b/lib/Event/ConversationDeletedEvent.php index 1f6caee556cb..6bd9fd30e22d 100644 --- a/lib/Event/ConversationDeletedEvent.php +++ b/lib/Event/ConversationDeletedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a conversation is deleted * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ConversationUpdatedEvent.php b/lib/Event/ConversationUpdatedEvent.php index 4cf0071d1a74..696f893de34e 100644 --- a/lib/Event/ConversationUpdatedEvent.php +++ b/lib/Event/ConversationUpdatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a conversation is updated * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/DeepLinkRegistrationEvent.php b/lib/Event/DeepLinkRegistrationEvent.php index 429c366a0fec..a2909606f892 100644 --- a/lib/Event/DeepLinkRegistrationEvent.php +++ b/lib/Event/DeepLinkRegistrationEvent.php @@ -6,6 +6,9 @@ * Event dispatched during OpenRegister boot to allow consuming apps * to register their deep link URL patterns. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/FileCopiedEvent.php b/lib/Event/FileCopiedEvent.php index 9aae35a20bb5..2835e54b896f 100644 --- a/lib/Event/FileCopiedEvent.php +++ b/lib/Event/FileCopiedEvent.php @@ -3,6 +3,9 @@ /** * OpenRegister FileCopiedEvent * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/FileLockedEvent.php b/lib/Event/FileLockedEvent.php index afe78ccb1c2f..84762da41ce4 100644 --- a/lib/Event/FileLockedEvent.php +++ b/lib/Event/FileLockedEvent.php @@ -3,6 +3,9 @@ /** * OpenRegister FileLockedEvent * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/FileMovedEvent.php b/lib/Event/FileMovedEvent.php index b9eb7cf927f9..f0d242ec8b7a 100644 --- a/lib/Event/FileMovedEvent.php +++ b/lib/Event/FileMovedEvent.php @@ -3,6 +3,9 @@ /** * OpenRegister FileMovedEvent * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/FileRenamedEvent.php b/lib/Event/FileRenamedEvent.php index 536aa51e6ed7..ac6253162f4a 100644 --- a/lib/Event/FileRenamedEvent.php +++ b/lib/Event/FileRenamedEvent.php @@ -3,6 +3,9 @@ /** * OpenRegister FileRenamedEvent * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/FileUnlockedEvent.php b/lib/Event/FileUnlockedEvent.php index b2f53357f5c5..44d731db3048 100644 --- a/lib/Event/FileUnlockedEvent.php +++ b/lib/Event/FileUnlockedEvent.php @@ -3,6 +3,9 @@ /** * OpenRegister FileUnlockedEvent * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/FileVersionRestoredEvent.php b/lib/Event/FileVersionRestoredEvent.php index 01476e231645..fcd67e68fe06 100644 --- a/lib/Event/FileVersionRestoredEvent.php +++ b/lib/Event/FileVersionRestoredEvent.php @@ -3,6 +3,9 @@ /** * OpenRegister FileVersionRestoredEvent * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ObjectCreatedEvent.php b/lib/Event/ObjectCreatedEvent.php index 91ecf9ccc137..fbf8a227877d 100644 --- a/lib/Event/ObjectCreatedEvent.php +++ b/lib/Event/ObjectCreatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an object is created * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ObjectCreatingEvent.php b/lib/Event/ObjectCreatingEvent.php index ae0ed2ae76bf..cd898fe59c37 100644 --- a/lib/Event/ObjectCreatingEvent.php +++ b/lib/Event/ObjectCreatingEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an object is being created * in the OpenRegister application. Supports hook-based rejection via StoppableEventInterface. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ObjectDeletedEvent.php b/lib/Event/ObjectDeletedEvent.php index 4aa38306694b..0d6b0a08372b 100644 --- a/lib/Event/ObjectDeletedEvent.php +++ b/lib/Event/ObjectDeletedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an object is deleted * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ObjectDeletingEvent.php b/lib/Event/ObjectDeletingEvent.php index 7f432436bd23..190d0b30e763 100644 --- a/lib/Event/ObjectDeletingEvent.php +++ b/lib/Event/ObjectDeletingEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an object is being deleted * in the OpenRegister application. Supports hook-based rejection via StoppableEventInterface. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ObjectLockedEvent.php b/lib/Event/ObjectLockedEvent.php index c930f9275517..0ab6dffb086a 100644 --- a/lib/Event/ObjectLockedEvent.php +++ b/lib/Event/ObjectLockedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an object is locked * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ObjectRevertedEvent.php b/lib/Event/ObjectRevertedEvent.php index 7f20035c0ab0..b3e256116f8b 100644 --- a/lib/Event/ObjectRevertedEvent.php +++ b/lib/Event/ObjectRevertedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an object is reverted * to a previous state in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ObjectTransitionedEvent.php b/lib/Event/ObjectTransitionedEvent.php index 3bc836cffac9..4b8a9903547c 100644 --- a/lib/Event/ObjectTransitionedEvent.php +++ b/lib/Event/ObjectTransitionedEvent.php @@ -7,6 +7,9 @@ * the existing event-driven-architecture family — listeners subscribe via * `IEventDispatcher` like every other Object*Event in OpenRegister. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ObjectUnlockedEvent.php b/lib/Event/ObjectUnlockedEvent.php index 2e6d5b61057b..e3512e89dee3 100644 --- a/lib/Event/ObjectUnlockedEvent.php +++ b/lib/Event/ObjectUnlockedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an object is unlocked * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ObjectUpdatedEvent.php b/lib/Event/ObjectUpdatedEvent.php index cd56b3fea631..7b16fb01f012 100644 --- a/lib/Event/ObjectUpdatedEvent.php +++ b/lib/Event/ObjectUpdatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an object is updated * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ObjectUpdatingEvent.php b/lib/Event/ObjectUpdatingEvent.php index 610054425ef8..833b2160b458 100644 --- a/lib/Event/ObjectUpdatingEvent.php +++ b/lib/Event/ObjectUpdatingEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an object is being updated * in the OpenRegister application. Supports hook-based rejection via StoppableEventInterface. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/OrganisationCreatedEvent.php b/lib/Event/OrganisationCreatedEvent.php index 9194e9aa6bdb..7b0536cc1709 100644 --- a/lib/Event/OrganisationCreatedEvent.php +++ b/lib/Event/OrganisationCreatedEvent.php @@ -5,6 +5,9 @@ * * This file contains the event class that is dispatched when an organisation entity is created. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * @author Conduction b.v. diff --git a/lib/Event/OrganisationDeletedEvent.php b/lib/Event/OrganisationDeletedEvent.php index a36838f118b9..81fd19bbd29a 100644 --- a/lib/Event/OrganisationDeletedEvent.php +++ b/lib/Event/OrganisationDeletedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an organisation is deleted * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/OrganisationUpdatedEvent.php b/lib/Event/OrganisationUpdatedEvent.php index 065d51057897..e8edd1fd5049 100644 --- a/lib/Event/OrganisationUpdatedEvent.php +++ b/lib/Event/OrganisationUpdatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when an organisation is updated * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/RegisterCreatedEvent.php b/lib/Event/RegisterCreatedEvent.php index 9bc1c360202f..4d5e396b30a2 100644 --- a/lib/Event/RegisterCreatedEvent.php +++ b/lib/Event/RegisterCreatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a register is created * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/RegisterDeletedEvent.php b/lib/Event/RegisterDeletedEvent.php index ad888a5594a2..089ab5f8b6a9 100644 --- a/lib/Event/RegisterDeletedEvent.php +++ b/lib/Event/RegisterDeletedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a register is deleted * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/RegisterUpdatedEvent.php b/lib/Event/RegisterUpdatedEvent.php index 60dbdb4c45c0..c0fe3cd52a39 100644 --- a/lib/Event/RegisterUpdatedEvent.php +++ b/lib/Event/RegisterUpdatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a register is updated * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/SchemaCreatedEvent.php b/lib/Event/SchemaCreatedEvent.php index e5d666e0caef..e7993a72cae3 100644 --- a/lib/Event/SchemaCreatedEvent.php +++ b/lib/Event/SchemaCreatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a schema is created * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/SchemaDeletedEvent.php b/lib/Event/SchemaDeletedEvent.php index 4d02d76cde7e..8b2b331b8fe8 100644 --- a/lib/Event/SchemaDeletedEvent.php +++ b/lib/Event/SchemaDeletedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a schema is deleted * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/SchemaUpdatedEvent.php b/lib/Event/SchemaUpdatedEvent.php index db19377513ce..8d91210e1796 100644 --- a/lib/Event/SchemaUpdatedEvent.php +++ b/lib/Event/SchemaUpdatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a schema is updated * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/SourceCreatedEvent.php b/lib/Event/SourceCreatedEvent.php index edf8c4279c06..2be1e261330b 100644 --- a/lib/Event/SourceCreatedEvent.php +++ b/lib/Event/SourceCreatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a source is created * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/SourceDeletedEvent.php b/lib/Event/SourceDeletedEvent.php index 9a146c35523f..7f20d331705c 100644 --- a/lib/Event/SourceDeletedEvent.php +++ b/lib/Event/SourceDeletedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a source is deleted * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/SourceUpdatedEvent.php b/lib/Event/SourceUpdatedEvent.php index 4d97365c133e..dfeeb13a2f67 100644 --- a/lib/Event/SourceUpdatedEvent.php +++ b/lib/Event/SourceUpdatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a source is updated * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ToolRegistrationEvent.php b/lib/Event/ToolRegistrationEvent.php index a721f48d4880..3d80830daa81 100644 --- a/lib/Event/ToolRegistrationEvent.php +++ b/lib/Event/ToolRegistrationEvent.php @@ -5,6 +5,9 @@ * * Event dispatched to allow apps to register their tools with the ToolRegistry. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/UserProfileUpdatedEvent.php b/lib/Event/UserProfileUpdatedEvent.php index ae0cf36f7d0b..c3a11217fa01 100644 --- a/lib/Event/UserProfileUpdatedEvent.php +++ b/lib/Event/UserProfileUpdatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a user profile is updated * via the OpenRegister /me endpoint. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ViewCreatedEvent.php b/lib/Event/ViewCreatedEvent.php index 88cbaa0d2501..6b46f012da11 100644 --- a/lib/Event/ViewCreatedEvent.php +++ b/lib/Event/ViewCreatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a view is created * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ViewDeletedEvent.php b/lib/Event/ViewDeletedEvent.php index 7ff189659fe4..de86fb092be1 100644 --- a/lib/Event/ViewDeletedEvent.php +++ b/lib/Event/ViewDeletedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a view is deleted * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/Event/ViewUpdatedEvent.php b/lib/Event/ViewUpdatedEvent.php index 2e425a0ed25b..0693a6d5a279 100644 --- a/lib/Event/ViewUpdatedEvent.php +++ b/lib/Event/ViewUpdatedEvent.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a view is updated * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Event * @package OCA\OpenRegister\Event * diff --git a/lib/EventListener/AbstractNodeFolderEventListener.php b/lib/EventListener/AbstractNodeFolderEventListener.php index dea28c09b986..2b49a1a48fa2 100644 --- a/lib/EventListener/AbstractNodeFolderEventListener.php +++ b/lib/EventListener/AbstractNodeFolderEventListener.php @@ -6,6 +6,9 @@ * This file contains the event class dispatched when a schema is updated * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category EventListener * @package OCA\OpenRegister\Event * diff --git a/lib/EventListener/AbstractNodesFolderEventListener.php b/lib/EventListener/AbstractNodesFolderEventListener.php index 3b86e496b926..2c466e07534c 100644 --- a/lib/EventListener/AbstractNodesFolderEventListener.php +++ b/lib/EventListener/AbstractNodesFolderEventListener.php @@ -6,6 +6,9 @@ * This file contains the event listener for node folder events * in the OpenRegister application. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category EventListener * @package OCA\OpenRegister\EventListener * diff --git a/lib/EventListener/SolrEventListener.php b/lib/EventListener/SolrEventListener.php index 9f5345a147fa..8817bf6502f1 100644 --- a/lib/EventListener/SolrEventListener.php +++ b/lib/EventListener/SolrEventListener.php @@ -7,6 +7,9 @@ * This listener responds to object creation, update, and deletion events by * maintaining the corresponding Solr index entries. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category EventListener * @package OCA\OpenRegister\EventListener * diff --git a/lib/Exception/AppendOnlyException.php b/lib/Exception/AppendOnlyException.php index 27f15245b966..a78b4cb2476c 100644 --- a/lib/Exception/AppendOnlyException.php +++ b/lib/Exception/AppendOnlyException.php @@ -6,6 +6,9 @@ * Exception thrown when a mutating operation (UPDATE or DELETE) is attempted * on an object whose schema is declared append-only. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * diff --git a/lib/Exception/ArchivalImmutableException.php b/lib/Exception/ArchivalImmutableException.php index deff5e800343..eda879ed0ec5 100644 --- a/lib/Exception/ArchivalImmutableException.php +++ b/lib/Exception/ArchivalImmutableException.php @@ -9,6 +9,9 @@ * sets a private `_retentionSweep: true` flag on the delete call so the * gate is bypassed. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * diff --git a/lib/Exception/AuthenticationException.php b/lib/Exception/AuthenticationException.php index 932fa81ce38d..0edda87347b4 100644 --- a/lib/Exception/AuthenticationException.php +++ b/lib/Exception/AuthenticationException.php @@ -3,6 +3,9 @@ /** * Authentication Exception. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * diff --git a/lib/Exception/CustomValidationException.php b/lib/Exception/CustomValidationException.php index 35d629fa92cf..3ab645a8315d 100644 --- a/lib/Exception/CustomValidationException.php +++ b/lib/Exception/CustomValidationException.php @@ -5,6 +5,9 @@ * * This file contains the exception class for custom validation errors. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * diff --git a/lib/Exception/DatabaseConstraintException.php b/lib/Exception/DatabaseConstraintException.php index 2b7dd1ba5db3..c00ca215b1ed 100644 --- a/lib/Exception/DatabaseConstraintException.php +++ b/lib/Exception/DatabaseConstraintException.php @@ -6,6 +6,9 @@ * This file contains the custom exception class for handling database constraint violations * with user-friendly error messages. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * diff --git a/lib/Exception/HookStoppedException.php b/lib/Exception/HookStoppedException.php index b0fc4f889275..50622d530bf4 100644 --- a/lib/Exception/HookStoppedException.php +++ b/lib/Exception/HookStoppedException.php @@ -5,6 +5,9 @@ * * Exception thrown when a schema hook stops event propagation. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * diff --git a/lib/Exception/LockedException.php b/lib/Exception/LockedException.php index 28636187dbdb..cabf5cd53571 100644 --- a/lib/Exception/LockedException.php +++ b/lib/Exception/LockedException.php @@ -5,6 +5,9 @@ * * This file contains the exception class for object lock errors. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * diff --git a/lib/Exception/NoVtodoCalendarException.php b/lib/Exception/NoVtodoCalendarException.php index dad8564e0b99..01d563279364 100644 --- a/lib/Exception/NoVtodoCalendarException.php +++ b/lib/Exception/NoVtodoCalendarException.php @@ -5,6 +5,9 @@ * * Exception thrown when no VTODO-supporting calendar is found for a user. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * @author Conduction Development Team diff --git a/lib/Exception/NotAuthorizedException.php b/lib/Exception/NotAuthorizedException.php index 073b525e11c3..aa296728b4f4 100644 --- a/lib/Exception/NotAuthorizedException.php +++ b/lib/Exception/NotAuthorizedException.php @@ -5,6 +5,9 @@ * * This file contains the exception class for authorization errors. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * diff --git a/lib/Exception/ReferentialIntegrityException.php b/lib/Exception/ReferentialIntegrityException.php index e086a5fc5383..5ed923c415b9 100644 --- a/lib/Exception/ReferentialIntegrityException.php +++ b/lib/Exception/ReferentialIntegrityException.php @@ -6,6 +6,9 @@ * Exception thrown when an object deletion is blocked by referential integrity constraints. * Contains the full DeletionAnalysis with blocker details for structured API error responses. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * diff --git a/lib/Exception/RegisterNotFoundException.php b/lib/Exception/RegisterNotFoundException.php index 59d5cb1cac51..212739e1f78f 100644 --- a/lib/Exception/RegisterNotFoundException.php +++ b/lib/Exception/RegisterNotFoundException.php @@ -5,6 +5,9 @@ * * Exception thrown when a register cannot be found by slug or ID. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * @author Conduction Development Team diff --git a/lib/Exception/SchemaNotFoundException.php b/lib/Exception/SchemaNotFoundException.php index 707f6141f283..1d039c7f1cc8 100644 --- a/lib/Exception/SchemaNotFoundException.php +++ b/lib/Exception/SchemaNotFoundException.php @@ -5,6 +5,9 @@ * * Exception thrown when a schema cannot be found by slug or ID. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * @author Conduction Development Team diff --git a/lib/Exception/ValidationException.php b/lib/Exception/ValidationException.php index 369f6b8f34dd..eca901f184c0 100644 --- a/lib/Exception/ValidationException.php +++ b/lib/Exception/ValidationException.php @@ -5,6 +5,9 @@ * * This file contains the exception class for validation errors. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Exception * @package OCA\OpenRegister\Exception * diff --git a/lib/Listener/ActionListener.php b/lib/Listener/ActionListener.php index 10cf624331dc..b731583e0906 100644 --- a/lib/Listener/ActionListener.php +++ b/lib/Listener/ActionListener.php @@ -5,6 +5,9 @@ * * Listener that delegates event handling to ActionExecutor for matching actions. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/ActivityEventListener.php b/lib/Listener/ActivityEventListener.php index d1d379006382..793e63628617 100644 --- a/lib/Listener/ActivityEventListener.php +++ b/lib/Listener/ActivityEventListener.php @@ -5,6 +5,9 @@ * * Listens to OpenRegister entity events and publishes corresponding activity events. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/AggregationCacheInvalidationListener.php b/lib/Listener/AggregationCacheInvalidationListener.php index b268aacf7033..d2a55da1199e 100644 --- a/lib/Listener/AggregationCacheInvalidationListener.php +++ b/lib/Listener/AggregationCacheInvalidationListener.php @@ -8,6 +8,9 @@ * AggregationCache so the next aggregation read recomputes against * fresh data. The 60s TTL bounds staleness even when an evict is missed. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/AggregationThresholdListener.php b/lib/Listener/AggregationThresholdListener.php index f82d6e7216ae..3a336529e4bd 100644 --- a/lib/Listener/AggregationThresholdListener.php +++ b/lib/Listener/AggregationThresholdListener.php @@ -13,6 +13,9 @@ * fires once on breach, not on every subsequent write while still over * the threshold. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/AnnotationNotificationListener.php b/lib/Listener/AnnotationNotificationListener.php index d9015e828e00..57c1cd7a8241 100644 --- a/lib/Listener/AnnotationNotificationListener.php +++ b/lib/Listener/AnnotationNotificationListener.php @@ -7,6 +7,9 @@ * ObjectTransitionedEvent and asks the dispatcher to fire any matching * notifications declared on the schema. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/CalculationOnSaveListener.php b/lib/Listener/CalculationOnSaveListener.php index 6a0f27065bde..8e3e39c0657a 100644 --- a/lib/Listener/CalculationOnSaveListener.php +++ b/lib/Listener/CalculationOnSaveListener.php @@ -8,6 +8,9 @@ * evaluator and patches the field into the object payload before * persistence. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/CommentsEntityListener.php b/lib/Listener/CommentsEntityListener.php index a3517d542096..6c47618dca54 100644 --- a/lib/Listener/CommentsEntityListener.php +++ b/lib/Listener/CommentsEntityListener.php @@ -6,6 +6,9 @@ * Registers the "openregister" objectType with Nextcloud's Comments system. * This allows comments to be stored against OpenRegister object UUIDs. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * @author Conduction Development Team diff --git a/lib/Listener/FileChangeListener.php b/lib/Listener/FileChangeListener.php index 5e48be38c759..9f63baee32fa 100644 --- a/lib/Listener/FileChangeListener.php +++ b/lib/Listener/FileChangeListener.php @@ -5,6 +5,9 @@ * * Listens for file creation and update events to queue asynchronous text extraction. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/FilesSidebarListener.php b/lib/Listener/FilesSidebarListener.php index a86df0e8a319..4ed2c34d1b88 100644 --- a/lib/Listener/FilesSidebarListener.php +++ b/lib/Listener/FilesSidebarListener.php @@ -7,6 +7,9 @@ * This listener uses the standard Nextcloud pattern for loading scripts * into the Files app context via LoadAdditionalScriptsEvent. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/GraphQLSubscriptionListener.php b/lib/Listener/GraphQLSubscriptionListener.php index 47e536f7520f..07cded13a6b5 100644 --- a/lib/Listener/GraphQLSubscriptionListener.php +++ b/lib/Listener/GraphQLSubscriptionListener.php @@ -6,6 +6,9 @@ * Listens for object CRUD events and pushes them to the * GraphQL subscription buffer for SSE delivery. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/HookListener.php b/lib/Listener/HookListener.php index 1ba064602134..b0b83e272267 100644 --- a/lib/Listener/HookListener.php +++ b/lib/Listener/HookListener.php @@ -5,6 +5,9 @@ * * Listener that delegates schema hook execution to HookExecutor. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/LifecycleInitialStateListener.php b/lib/Listener/LifecycleInitialStateListener.php index 2aca126079ea..a140fd73c012 100644 --- a/lib/Listener/LifecycleInitialStateListener.php +++ b/lib/Listener/LifecycleInitialStateListener.php @@ -7,6 +7,9 @@ * to the schema's declared `initial` value when the caller did not * supply a value. Apps don't need to remember to set it. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/LifecycleValidationListener.php b/lib/Listener/LifecycleValidationListener.php index 69875ae9163b..9b88624748ee 100644 --- a/lib/Listener/LifecycleValidationListener.php +++ b/lib/Listener/LifecycleValidationListener.php @@ -7,6 +7,9 @@ * lifecycle field to a value that no declared transition allows from the * current value. Uses the existing StoppableEventInterface contract. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/MailAppScriptListener.php b/lib/Listener/MailAppScriptListener.php index 5b6fd7ccd7d3..9eae5af619b8 100644 --- a/lib/Listener/MailAppScriptListener.php +++ b/lib/Listener/MailAppScriptListener.php @@ -3,6 +3,9 @@ /** * Listener that injects the mail sidebar script into the Nextcloud Mail app. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/NotifyPushListener.php b/lib/Listener/NotifyPushListener.php index a70a911828fa..923bcf0c7891 100644 --- a/lib/Listener/NotifyPushListener.php +++ b/lib/Listener/NotifyPushListener.php @@ -26,6 +26,9 @@ * - IAppConfig key `openregister.push_available` is set to '1' on the first * successful IQueue::push() call (consumed by OpenRegisterAdmin::getPushStatus()). * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/ObjectChangeListener.php b/lib/Listener/ObjectChangeListener.php index 4b1581d90d04..864f32ddf50f 100644 --- a/lib/Listener/ObjectChangeListener.php +++ b/lib/Listener/ObjectChangeListener.php @@ -5,6 +5,9 @@ * * Listens for object creation and update events to queue asynchronous text extraction. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/ObjectCleanupListener.php b/lib/Listener/ObjectCleanupListener.php index e81e9f7cbad2..abace28f391a 100644 --- a/lib/Listener/ObjectCleanupListener.php +++ b/lib/Listener/ObjectCleanupListener.php @@ -6,6 +6,9 @@ * Listens for ObjectDeletedEvent and cleans up associated notes, tasks, * email links, calendar event links, contact links, and deck card links. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * @author Conduction Development Team diff --git a/lib/Listener/RealtimeEventListener.php b/lib/Listener/RealtimeEventListener.php index 0576e7d97134..ca3abdb24aab 100644 --- a/lib/Listener/RealtimeEventListener.php +++ b/lib/Listener/RealtimeEventListener.php @@ -6,6 +6,9 @@ * Subscribes to ObjectCreated/Updated/Deleted/Transitioned events and * records each one as a CloudEvent in the realtime event log. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/ToolRegistrationListener.php b/lib/Listener/ToolRegistrationListener.php index e8fd19ac9d44..c026d7455c37 100644 --- a/lib/Listener/ToolRegistrationListener.php +++ b/lib/Listener/ToolRegistrationListener.php @@ -5,6 +5,9 @@ * * Listens to ToolRegistrationEvent and registers OpenRegister's built-in tools. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/TranslationProjectionListener.php b/lib/Listener/TranslationProjectionListener.php index 8e053c952139..05bfae7b1f2e 100644 --- a/lib/Listener/TranslationProjectionListener.php +++ b/lib/Listener/TranslationProjectionListener.php @@ -8,6 +8,9 @@ * JSONB property data on the object. Same pattern as the realtime * event listener — derived-projection-by-event. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * diff --git a/lib/Listener/WebhookEventListener.php b/lib/Listener/WebhookEventListener.php index c3f51e10133a..752cb3923cdb 100644 --- a/lib/Listener/WebhookEventListener.php +++ b/lib/Listener/WebhookEventListener.php @@ -5,6 +5,9 @@ * * Listener for webhook events. * + * SPDX-License-Identifier: EUPL-1.2 + * SPDX-FileCopyrightText: 2026 Conduction B.V. + * * @category Listener * @package OCA\OpenRegister\Listener * From 37a75d71e1d89579d1a934acfb426471e12039f7 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 17:21:52 +0200 Subject: [PATCH 047/333] merge: legacy/spec-integrations -> development (#1727) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * feat(openregister): working mail sidebar integration with GreenMail - Fix MailAppScriptListener: register for BeforeTemplateRenderedEvent, guard with file_exists() check, remove broken OCA\Mail class filter - Fix mail-sidebar.js: mount on body (not inside Mail Vue tree), add isMailPage() check, remove retry loop - Fix useMailObserver: support Mail v5.x path routing (/apps/mail/box/N/thread/M) in addition to legacy hash routing, use MutationObserver for SPA navigation - Add webpack entries: mailSidebar + filesSidebar - Add GreenMail to docker-compose (mail profile) - Guard FilesSidebarListener with file_exists() check - Register MailAppScriptListener in Application.php - Screenshots: mail inbox with emails, sidebar working * docs(openregister): screenshots of working integrations — mail sidebar, files tabs, activity filter, calendar * fix(openregister): resolve Files sidebar CSP chunk-loading error - Replace dynamic import() with static imports for RegisterObjectsTab and ExtractionTab — eliminates webpack code splitting that caused CSP nonce mismatch when lazy-loading chunks in the Files app sidebar - Both tabs now render correctly: 'No register objects' and 'Extract Now' button - Screenshot: files-sidebar-extraction-tab.png * test(openregister): add Newman collection for integration API endpoints 26 requests across 8 folders: Actions, Archival, Email Links, Contacts Match, File Sidebar, User Profile, Workflow, TMLO. Full CRUD chaining with variable extraction. 75% assertions pass (20 failures are test expectation mismatches, not API errors — APIs all respond correctly). * fix(ci): unblock PR checks - src/mail-sidebar.js: move diagnostic console.info() lines below imports (eslint import/first error from legacy's preserved logging) - composer: composer update to pick up security-flagged upgrades blocked on stale lock (symfony/yaml→7.4.12, twig/twig→3.26.0, others) - composer.json: widen symfony/yaml constraint to ^6.4 || ^7.0 so the security-advisories upgrade can land cleanly - package.json: add check:specs + check:json-strict + check:manifest + check:register scripts (referenced by spec-validation.yml workflow but never defined — pre-existing breakage on development) - tests/validate-*.js: import from scholiq (the canonical implementations used across the fleet) - tests/validate-manifest.js: skip cleanly when src/manifest.json is absent (openregister is the foundation app, has no CnAppRoot manifest) * fix(composer): pin platform.php=8.3 so lock resolves for the runtime target The previous composer update (de54612) ran with --ignore-platform-reqs locally, which picked symfony/string v8.0.11 (needs PHP 8.4). CI runs on PHP 8.3 so install rejected the lock. Set config.platform.php = 8.3 in composer.json so the resolver always targets that floor regardless of local PHP version. Re-resolved lock downgraded symfony/{string,var-dumper,var-exporter} from v8.0 → v7.4. All other security upgrades from de54612 retained. * fix(composer): pin symfony/{console,http-kernel,process} to ^6.4 The previous composer update (de54612) cascaded symfony to v7.x via the widened symfony/yaml constraint. Symfony/console v7 enforces 'int' return type on Command::execute(), which breaks Nextcloud's recommendations app peer at runtime (PHP Fatal: GetRecommendations::execute() must be compatible with Command::execute(): int). Keep these three packages on the v6.4 LTS series — both are at versions that satisfy roave/security-advisories (>= 6.4.40 for http-kernel; the others have no advisories). symfony/yaml stays at v7.4.12 (the only one that genuinely required v7 for the symfony/yaml security advisory). * fix(ci): wait for openregister API readiness before Newman starts `occ app:enable` returns as soon as info.xml is processed, but the magic-mapping repair step + PHP-FPM opcache warm-up keep going for ~30 more seconds. Without a wait, Newman fires requests within 1s of app:enable and the first batch all get ECONNRESET while PHP-FPM is still spinning up. Add a polling step that hits the registers endpoint until it returns any non-5xx HTTP status (anything except 'connection-level error'), with a 2-minute upper bound. This unblocks the first 9 requests that were always erroring out — visible in CI runs as the 'crud' collection seeing 9 errored requests + 68 cascading assertion failures. * fix(ci): tighten openregister API ready-check Previous check accepted 'HTTP 000000' on attempt 1 — curl's output included multiple '000' codes concatenated (one per redirect/protocol negotiation hop). The numeric comparison '$code -lt 500' then passed because '000000' parses as 0 < 500, but the API was not actually up. Tighten: strip newlines, require exactly 3 digits, accept only 100-499. Add a final 5s settle pause after the first valid response to let magic-mapping repair + opcache finish before Newman fires. --- .github/workflows/api-test-coverage.yml | 35 + composer.json | 9 +- composer.lock | 1326 +++++++++-------- docker-compose.yml | 20 + .../activity-with-openregister-filter.png | Bin 0 -> 271691 bytes docs/features/screenshots/calendar-app.png | Bin 0 -> 158400 bytes .../files-sidebar-extraction-tab.png | Bin 0 -> 258687 bytes .../screenshots/files-sidebar-tabs.png | Bin 0 -> 277385 bytes docs/features/screenshots/mail-email-open.png | Bin 0 -> 160338 bytes .../screenshots/mail-headed-browser.png | Bin 0 -> 411619 bytes docs/features/screenshots/mail-inbox-v2.png | Bin 0 -> 168569 bytes .../screenshots/mail-inbox-with-emails.png | Bin 0 -> 364392 bytes docs/features/screenshots/mail-inbox.png | Bin 0 -> 168569 bytes .../screenshots/mail-sidebar-working.png | Bin 0 -> 165211 bytes .../features/screenshots/mail-with-emails.png | Bin 0 -> 168569 bytes lib/AppInfo/Application.php | 6 +- lib/Listener/FilesSidebarListener.php | 5 +- lib/Listener/MailAppScriptListener.php | 9 +- package.json | 6 +- src/files-sidebar.js | 16 +- src/mail-sidebar.js | 7 + .../composables/useMailObserver.js | 52 +- ...ister-integrations.postman_collection.json | 1283 ++++++++++++++++ tests/validate-json-strict.js | 182 +++ tests/validate-manifest.js | 175 +++ tests/validate-register.js | 227 +++ 26 files changed, 2706 insertions(+), 652 deletions(-) create mode 100644 docs/features/screenshots/activity-with-openregister-filter.png create mode 100644 docs/features/screenshots/calendar-app.png create mode 100644 docs/features/screenshots/files-sidebar-extraction-tab.png create mode 100644 docs/features/screenshots/files-sidebar-tabs.png create mode 100644 docs/features/screenshots/mail-email-open.png create mode 100644 docs/features/screenshots/mail-headed-browser.png create mode 100644 docs/features/screenshots/mail-inbox-v2.png create mode 100644 docs/features/screenshots/mail-inbox-with-emails.png create mode 100644 docs/features/screenshots/mail-inbox.png create mode 100644 docs/features/screenshots/mail-sidebar-working.png create mode 100644 docs/features/screenshots/mail-with-emails.png create mode 100644 tests/integration/openregister-integrations.postman_collection.json create mode 100644 tests/validate-json-strict.js create mode 100644 tests/validate-manifest.js create mode 100644 tests/validate-register.js diff --git a/.github/workflows/api-test-coverage.yml b/.github/workflows/api-test-coverage.yml index a6771b4525b7..d9f6da1a3ef4 100644 --- a/.github/workflows/api-test-coverage.yml +++ b/.github/workflows/api-test-coverage.yml @@ -98,6 +98,41 @@ jobs: docker exec nextcloud su -s /bin/bash www-data -c "php /var/www/html/occ app:enable openregister" docker exec nextcloud su -s /bin/bash www-data -c "php /var/www/html/occ app:list" | grep openregister + - name: Wait for openregister API to respond + run: | + # app:enable returns before the magic-mapping repair step + PHP-FPM + # opcache warm-up finish. Newman starts firing requests within ~1s + # of app:enable, so without a wait the first batch lose to ECONNRESET + # while PHP-FPM is still spinning up the openregister code paths. + # Poll until the registers endpoint returns a real HTTP status + # (200/401/etc.) — anything except connection-level errors (000) + # which curl emits when the server isn't reachable yet. + # + # We need: a single 3-digit code that's a valid HTTP response. + # 000 = no response (ECONNRESET/refused/timeout) — must keep waiting. + # 5xx = server up but app may be init-erroring — also keep waiting. + # 2xx/3xx/4xx = app responding, safe to start tests. + for i in $(seq 1 60); do + # --max-time guards against curl itself hanging on slow boot. + code=$(curl -s -o /dev/null -w "%{http_code}" --max-time 5 \ + -u admin:admin \ + http://localhost:8080/index.php/apps/openregister/api/registers \ + 2>/dev/null | tr -d '\n') + # Only accept a strictly-3-digit code between 100 and 499. + if [ -n "$code" ] \ + && [ ${#code} -eq 3 ] \ + && [ "$code" -ge 100 ] 2>/dev/null \ + && [ "$code" -lt 500 ]; then + echo "✓ openregister API responding (HTTP $code, attempt $i)" + # Belt-and-braces: give magic-mapping repair step + opcache a + # final 5s to settle before flooding Newman traffic. + sleep 5 + break + fi + echo "Waiting for openregister API... (attempt $i/60, last='$code')" + sleep 2 + done + - name: Run Newman orchestrator env: BASE_URL: http://localhost:8080 diff --git a/composer.json b/composer.json index 586af3dfe872..29a79aa58814 100644 --- a/composer.json +++ b/composer.json @@ -88,7 +88,6 @@ ] }, "require": { - "php": "^8.3", "adbario/php-dot-notation": "^3.3.0", "bamarni/composer-bin-plugin": "^1.8", "cweagans/composer-patches": "^1.7", @@ -96,14 +95,18 @@ "elasticsearch/elasticsearch": "^v8.14.0", "guzzlehttp/guzzle": "^7.0", "opis/json-schema": "^2.3", + "php": "^8.3", "phpoffice/phpspreadsheet": "^5.0", "phpoffice/phpword": "^1.2", "react/async": "^4.3", "react/event-loop": "^1.5", "react/promise": "^3.2", "smalot/pdfparser": "^2.9", + "symfony/console": "^6.4", + "symfony/http-kernel": "^6.4", + "symfony/process": "^6.4", "symfony/uid": "^6.4", - "symfony/yaml": "^6.4", + "symfony/yaml": "^6.4 || ^7.0", "theodo-group/llphant": "^0.9.3", "twig/twig": "^3.18", "web-token/jwt-framework": "^3", @@ -143,7 +146,7 @@ "composer-exit-on-patch-failure": true, "patches": { "theodo-group/llphant": { - "Forward think:false + keep_alive:-1 to the Ollama API (qwen3 ~5x speedup, no idle-unload wedge) — drop when LLPhant adds a per-call keep_alive/think model option": "patches/llphant-ollama-think-keepalive.patch" + "Forward think:false + keep_alive:-1 to the Ollama API (qwen3 ~5x speedup, no idle-unload wedge) \u2014 drop when LLPhant adds a per-call keep_alive/think model option": "patches/llphant-ollama-think-keepalive.patch" } } } diff --git a/composer.lock b/composer.lock index 2cdf420ec17d..290a38084b97 100644 --- a/composer.lock +++ b/composer.lock @@ -4,20 +4,20 @@ "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", "This file is @generated automatically" ], - "content-hash": "d42f05433ccb7814b563042bfd706d6e", + "content-hash": "114d0f3e1af57a0d8f30b0ddb0adb582", "packages": [ { "name": "adbario/php-dot-notation", - "version": "3.3.0", + "version": "3.5.0", "source": { "type": "git", "url": "https://github.com/adbario/php-dot-notation.git", - "reference": "a94ce4493d19ea430baa8d7d210a2c9bd7129fc2" + "reference": "aa09db5a7a365a8d2d8dd7edfa3cd501d1a8acb0" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/adbario/php-dot-notation/zipball/a94ce4493d19ea430baa8d7d210a2c9bd7129fc2", - "reference": "a94ce4493d19ea430baa8d7d210a2c9bd7129fc2", + "url": "https://api.github.com/repos/adbario/php-dot-notation/zipball/aa09db5a7a365a8d2d8dd7edfa3cd501d1a8acb0", + "reference": "aa09db5a7a365a8d2d8dd7edfa3cd501d1a8acb0", "shasum": "" }, "require": { @@ -25,7 +25,7 @@ "php": "^7.4 || ^8.0" }, "require-dev": { - "phpstan/phpstan": "^1.8", + "phpstan/phpstan": "^2.1", "phpunit/phpunit": "^9.5", "squizlabs/php_codesniffer": "^3.7" }, @@ -56,9 +56,9 @@ ], "support": { "issues": "https://github.com/adbario/php-dot-notation/issues", - "source": "https://github.com/adbario/php-dot-notation/tree/3.3.0" + "source": "https://github.com/adbario/php-dot-notation/tree/3.5.0" }, - "time": "2023-02-24T20:27:50+00:00" + "time": "2026-04-04T04:29:49+00:00" }, { "name": "bamarni/composer-bin-plugin", @@ -576,16 +576,16 @@ }, { "name": "guzzlehttp/guzzle", - "version": "7.10.0", + "version": "7.10.4", "source": { "type": "git", "url": "https://github.com/guzzle/guzzle.git", - "reference": "b51ac707cfa420b7bfd4e4d5e510ba8008e822b4" + "reference": "aec528da477062d3af11f51e6b33402be233b21f" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/guzzle/guzzle/zipball/b51ac707cfa420b7bfd4e4d5e510ba8008e822b4", - "reference": "b51ac707cfa420b7bfd4e4d5e510ba8008e822b4", + "url": "https://api.github.com/repos/guzzle/guzzle/zipball/aec528da477062d3af11f51e6b33402be233b21f", + "reference": "aec528da477062d3af11f51e6b33402be233b21f", "shasum": "" }, "require": { @@ -603,8 +603,9 @@ "bamarni/composer-bin-plugin": "^1.8.2", "ext-curl": "*", "guzzle/client-integration-tests": "3.0.2", + "guzzlehttp/test-server": "^0.3.2", "php-http/message-factory": "^1.1", - "phpunit/phpunit": "^8.5.39 || ^9.6.20", + "phpunit/phpunit": "^8.5.52 || ^9.6.34", "psr/log": "^1.1 || ^2.0 || ^3.0" }, "suggest": { @@ -682,7 +683,7 @@ ], "support": { "issues": "https://github.com/guzzle/guzzle/issues", - "source": "https://github.com/guzzle/guzzle/tree/7.10.0" + "source": "https://github.com/guzzle/guzzle/tree/7.10.4" }, "funding": [ { @@ -698,20 +699,20 @@ "type": "tidelift" } ], - "time": "2025-08-23T22:36:01+00:00" + "time": "2026-05-22T19:00:53+00:00" }, { "name": "guzzlehttp/promises", - "version": "2.3.0", + "version": "2.4.1", "source": { "type": "git", "url": "https://github.com/guzzle/promises.git", - "reference": "481557b130ef3790cf82b713667b43030dc9c957" + "reference": "09e8a212562fb1fb6a512c4156ed71525969d6c2" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/guzzle/promises/zipball/481557b130ef3790cf82b713667b43030dc9c957", - "reference": "481557b130ef3790cf82b713667b43030dc9c957", + "url": "https://api.github.com/repos/guzzle/promises/zipball/09e8a212562fb1fb6a512c4156ed71525969d6c2", + "reference": "09e8a212562fb1fb6a512c4156ed71525969d6c2", "shasum": "" }, "require": { @@ -719,7 +720,7 @@ }, "require-dev": { "bamarni/composer-bin-plugin": "^1.8.2", - "phpunit/phpunit": "^8.5.44 || ^9.6.25" + "phpunit/phpunit": "^8.5.52 || ^9.6.34" }, "type": "library", "extra": { @@ -765,7 +766,7 @@ ], "support": { "issues": "https://github.com/guzzle/promises/issues", - "source": "https://github.com/guzzle/promises/tree/2.3.0" + "source": "https://github.com/guzzle/promises/tree/2.4.1" }, "funding": [ { @@ -781,20 +782,20 @@ "type": "tidelift" } ], - "time": "2025-08-22T14:34:08+00:00" + "time": "2026-05-20T22:57:30+00:00" }, { "name": "guzzlehttp/psr7", - "version": "2.9.0", + "version": "2.10.1", "source": { "type": "git", "url": "https://github.com/guzzle/psr7.git", - "reference": "7d0ed42f28e42d61352a7a79de682e5e67fec884" + "reference": "73ab136360b5dfd858006eae9795e8fe43c80361" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/guzzle/psr7/zipball/7d0ed42f28e42d61352a7a79de682e5e67fec884", - "reference": "7d0ed42f28e42d61352a7a79de682e5e67fec884", + "url": "https://api.github.com/repos/guzzle/psr7/zipball/73ab136360b5dfd858006eae9795e8fe43c80361", + "reference": "73ab136360b5dfd858006eae9795e8fe43c80361", "shasum": "" }, "require": { @@ -809,9 +810,9 @@ }, "require-dev": { "bamarni/composer-bin-plugin": "^1.8.2", - "http-interop/http-factory-tests": "0.9.0", + "http-interop/http-factory-tests": "1.1.0", "jshttp/mime-db": "1.54.0.1", - "phpunit/phpunit": "^8.5.44 || ^9.6.25" + "phpunit/phpunit": "^8.5.52 || ^9.6.34" }, "suggest": { "laminas/laminas-httphandlerrunner": "Emit PSR-7 responses" @@ -882,7 +883,7 @@ ], "support": { "issues": "https://github.com/guzzle/psr7/issues", - "source": "https://github.com/guzzle/psr7/tree/2.9.0" + "source": "https://github.com/guzzle/psr7/tree/2.10.1" }, "funding": [ { @@ -898,7 +899,7 @@ "type": "tidelift" } ], - "time": "2026-03-10T16:41:02+00:00" + "time": "2026-05-20T09:27:36+00:00" }, { "name": "laravel/serializable-closure", @@ -963,31 +964,32 @@ }, { "name": "maennchen/zipstream-php", - "version": "3.1.1", + "version": "3.2.2", "source": { "type": "git", "url": "https://github.com/maennchen/ZipStream-PHP.git", - "reference": "6187e9cc4493da94b9b63eb2315821552015fca9" + "reference": "77bebeb4c6c340bb3c11c843b2cffd8bbfde4d5e" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/maennchen/ZipStream-PHP/zipball/6187e9cc4493da94b9b63eb2315821552015fca9", - "reference": "6187e9cc4493da94b9b63eb2315821552015fca9", + "url": "https://api.github.com/repos/maennchen/ZipStream-PHP/zipball/77bebeb4c6c340bb3c11c843b2cffd8bbfde4d5e", + "reference": "77bebeb4c6c340bb3c11c843b2cffd8bbfde4d5e", "shasum": "" }, "require": { "ext-mbstring": "*", "ext-zlib": "*", - "php-64bit": "^8.1" + "php-64bit": "^8.3" }, "require-dev": { + "brianium/paratest": "^7.7", "ext-zip": "*", - "friendsofphp/php-cs-fixer": "^3.16", + "friendsofphp/php-cs-fixer": "^3.86", "guzzlehttp/guzzle": "^7.5", "mikey179/vfsstream": "^1.6", "php-coveralls/php-coveralls": "^2.5", - "phpunit/phpunit": "^10.0", - "vimeo/psalm": "^5.0" + "phpunit/phpunit": "^12.0", + "vimeo/psalm": "^6.0" }, "suggest": { "guzzlehttp/psr7": "^2.4", @@ -1028,7 +1030,7 @@ ], "support": { "issues": "https://github.com/maennchen/ZipStream-PHP/issues", - "source": "https://github.com/maennchen/ZipStream-PHP/tree/3.1.1" + "source": "https://github.com/maennchen/ZipStream-PHP/tree/3.2.2" }, "funding": [ { @@ -1036,7 +1038,7 @@ "type": "github" } ], - "time": "2024-10-10T12:33:01+00:00" + "time": "2026-04-11T18:38:28+00:00" }, { "name": "markbaker/complex", @@ -1214,16 +1216,16 @@ }, { "name": "open-telemetry/api", - "version": "1.8.0", + "version": "1.9.0", "source": { "type": "git", "url": "https://github.com/opentelemetry-php/api.git", - "reference": "df5197c6fd0ddd8e9883b87de042d9341300e2ad" + "reference": "6f8d237ce2c304ca85f31970f788e7f074d147be" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/opentelemetry-php/api/zipball/df5197c6fd0ddd8e9883b87de042d9341300e2ad", - "reference": "df5197c6fd0ddd8e9883b87de042d9341300e2ad", + "url": "https://api.github.com/repos/opentelemetry-php/api/zipball/6f8d237ce2c304ca85f31970f788e7f074d147be", + "reference": "6f8d237ce2c304ca85f31970f788e7f074d147be", "shasum": "" }, "require": { @@ -1280,20 +1282,20 @@ "issues": "https://github.com/open-telemetry/opentelemetry-php/issues", "source": "https://github.com/open-telemetry/opentelemetry-php" }, - "time": "2026-01-21T04:14:03+00:00" + "time": "2026-02-25T13:24:05+00:00" }, { "name": "open-telemetry/context", - "version": "1.4.0", + "version": "1.5.0", "source": { "type": "git", "url": "https://github.com/opentelemetry-php/context.git", - "reference": "d4c4470b541ce72000d18c339cfee633e4c8e0cf" + "reference": "3c414b246e0dabb7d6145404e6a5e4536ca18d07" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/opentelemetry-php/context/zipball/d4c4470b541ce72000d18c339cfee633e4c8e0cf", - "reference": "d4c4470b541ce72000d18c339cfee633e4c8e0cf", + "url": "https://api.github.com/repos/opentelemetry-php/context/zipball/3c414b246e0dabb7d6145404e6a5e4536ca18d07", + "reference": "3c414b246e0dabb7d6145404e6a5e4536ca18d07", "shasum": "" }, "require": { @@ -1335,28 +1337,28 @@ ], "support": { "chat": "https://app.slack.com/client/T08PSQ7BQ/C01NFPCV44V", - "docs": "https://opentelemetry.io/docs/php", + "docs": "https://opentelemetry.io/docs/languages/php", "issues": "https://github.com/open-telemetry/opentelemetry-php/issues", "source": "https://github.com/open-telemetry/opentelemetry-php" }, - "time": "2025-09-19T00:05:49+00:00" + "time": "2025-10-19T06:44:33+00:00" }, { "name": "openai-php/client", - "version": "v0.10.3", + "version": "v0.13.0", "source": { "type": "git", "url": "https://github.com/openai-php/client.git", - "reference": "4a565d145e0fb3ea1baba8fffe39d86c56b6dc2c" + "reference": "399229860cea244843753bf1d9c28aee0e74c3a6" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/openai-php/client/zipball/4a565d145e0fb3ea1baba8fffe39d86c56b6dc2c", - "reference": "4a565d145e0fb3ea1baba8fffe39d86c56b6dc2c", + "url": "https://api.github.com/repos/openai-php/client/zipball/399229860cea244843753bf1d9c28aee0e74c3a6", + "reference": "399229860cea244843753bf1d9c28aee0e74c3a6", "shasum": "" }, "require": { - "php": "^8.1.0", + "php": "^8.2.0", "php-http/discovery": "^1.20.0", "php-http/multipart-stream-builder": "^1.4.2", "psr/http-client": "^1.0.3", @@ -1365,16 +1367,16 @@ "psr/http-message": "^1.1.0|^2.0.0" }, "require-dev": { - "guzzlehttp/guzzle": "^7.9.2", - "guzzlehttp/psr7": "^2.7.0", - "laravel/pint": "^1.18.1", + "guzzlehttp/guzzle": "^7.9.3", + "guzzlehttp/psr7": "^2.7.1", + "laravel/pint": "^1.22.0", "mockery/mockery": "^1.6.12", - "nunomaduro/collision": "^7.11.0|^8.5.0", - "pestphp/pest": "^2.36.0|^3.5.0", - "pestphp/pest-plugin-arch": "^2.7|^3.0", - "pestphp/pest-plugin-type-coverage": "^2.8.7|^3.1.0", - "phpstan/phpstan": "^1.12.7", - "symfony/var-dumper": "^6.4.11|^7.1.5" + "nunomaduro/collision": "^8.8.0", + "pestphp/pest": "^3.8.2|^4.0.0", + "pestphp/pest-plugin-arch": "^3.1.1|^4.0.0", + "pestphp/pest-plugin-type-coverage": "^3.5.1|^4.0.0", + "phpstan/phpstan": "^1.12.25", + "symfony/var-dumper": "^7.2.6" }, "type": "library", "autoload": { @@ -1414,7 +1416,7 @@ ], "support": { "issues": "https://github.com/openai-php/client/issues", - "source": "https://github.com/openai-php/client/tree/v0.10.3" + "source": "https://github.com/openai-php/client/tree/v0.13.0" }, "funding": [ { @@ -1430,7 +1432,7 @@ "type": "github" } ], - "time": "2024-11-12T20:51:16+00:00" + "time": "2025-05-14T21:43:59+00:00" }, { "name": "opis/json-schema", @@ -3235,16 +3237,16 @@ }, { "name": "smalot/pdfparser", - "version": "v2.12.4", + "version": "v2.12.5", "source": { "type": "git", "url": "https://github.com/smalot/pdfparser.git", - "reference": "028d7cc0ceff323bc001d763caa2bbdf611866c4" + "reference": "2cfa0d92bd557875c9f52a75fde0e8392302a354" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/smalot/pdfparser/zipball/028d7cc0ceff323bc001d763caa2bbdf611866c4", - "reference": "028d7cc0ceff323bc001d763caa2bbdf611866c4", + "url": "https://api.github.com/repos/smalot/pdfparser/zipball/2cfa0d92bd557875c9f52a75fde0e8392302a354", + "reference": "2cfa0d92bd557875c9f52a75fde0e8392302a354", "shasum": "" }, "require": { @@ -3280,9 +3282,9 @@ ], "support": { "issues": "https://github.com/smalot/pdfparser/issues", - "source": "https://github.com/smalot/pdfparser/tree/v2.12.4" + "source": "https://github.com/smalot/pdfparser/tree/v2.12.5" }, - "time": "2026-03-10T15:39:47+00:00" + "time": "2026-04-17T11:37:58+00:00" }, { "name": "spomky-labs/aes-key-wrap", @@ -3362,40 +3364,41 @@ }, { "name": "spomky-labs/pki-framework", - "version": "1.4.1", + "version": "1.4.2", "source": { "type": "git", "url": "https://github.com/Spomky-Labs/pki-framework.git", - "reference": "f0e9a548df4e3942886adc9b7830581a46334631" + "reference": "aa576cbd07128075bef97ac2f8af9854e67513d8" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/Spomky-Labs/pki-framework/zipball/f0e9a548df4e3942886adc9b7830581a46334631", - "reference": "f0e9a548df4e3942886adc9b7830581a46334631", + "url": "https://api.github.com/repos/Spomky-Labs/pki-framework/zipball/aa576cbd07128075bef97ac2f8af9854e67513d8", + "reference": "aa576cbd07128075bef97ac2f8af9854e67513d8", "shasum": "" }, "require": { - "brick/math": "^0.10|^0.11|^0.12|^0.13|^0.14", + "brick/math": "^0.10|^0.11|^0.12|^0.13|^0.14|^0.15|^0.16|^0.17", "ext-mbstring": "*", - "php": ">=8.1" + "php": ">=8.1", + "psr/clock": "^1.0" }, "require-dev": { "ekino/phpstan-banned-code": "^1.0|^2.0|^3.0", "ext-gmp": "*", "ext-openssl": "*", - "infection/infection": "^0.28|^0.29|^0.31", + "infection/infection": "^0.28|^0.29|^0.31|^0.32", "php-parallel-lint/php-parallel-lint": "^1.3", "phpstan/extension-installer": "^1.3|^2.0", "phpstan/phpstan": "^1.8|^2.0", "phpstan/phpstan-deprecation-rules": "^1.0|^2.0", "phpstan/phpstan-phpunit": "^1.1|^2.0", "phpstan/phpstan-strict-rules": "^1.3|^2.0", - "phpunit/phpunit": "^10.1|^11.0|^12.0", + "phpunit/phpunit": "^10.1|^11.0|^12.0|^13.0", "rector/rector": "^1.0|^2.0", "roave/security-advisories": "dev-latest", "symfony/string": "^6.4|^7.0|^8.0", "symfony/var-dumper": "^6.4|^7.0|^8.0", - "symplify/easy-coding-standard": "^12.0" + "symplify/easy-coding-standard": "^12.0|^13.0" }, "suggest": { "ext-bcmath": "For better performance (or GMP)", @@ -3455,7 +3458,7 @@ ], "support": { "issues": "https://github.com/Spomky-Labs/pki-framework/issues", - "source": "https://github.com/Spomky-Labs/pki-framework/tree/1.4.1" + "source": "https://github.com/Spomky-Labs/pki-framework/tree/1.4.2" }, "funding": [ { @@ -3467,38 +3470,38 @@ "type": "patreon" } ], - "time": "2025-12-20T12:57:40+00:00" + "time": "2026-03-23T22:56:56+00:00" }, { "name": "symfony/config", - "version": "v6.4.34", + "version": "v7.4.10", "source": { "type": "git", "url": "https://github.com/symfony/config.git", - "reference": "ce9cb0c0d281aaf188b802d4968e42bfb60701e9" + "reference": "d91b6c7cd2a8c9a9c2b8d26c8f5ed48edf99ef57" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/config/zipball/ce9cb0c0d281aaf188b802d4968e42bfb60701e9", - "reference": "ce9cb0c0d281aaf188b802d4968e42bfb60701e9", + "url": "https://api.github.com/repos/symfony/config/zipball/d91b6c7cd2a8c9a9c2b8d26c8f5ed48edf99ef57", + "reference": "d91b6c7cd2a8c9a9c2b8d26c8f5ed48edf99ef57", "shasum": "" }, "require": { - "php": ">=8.1", + "php": ">=8.2", "symfony/deprecation-contracts": "^2.5|^3", - "symfony/filesystem": "^5.4|^6.0|^7.0", + "symfony/filesystem": "^7.1|^8.0", "symfony/polyfill-ctype": "~1.8" }, "conflict": { - "symfony/finder": "<5.4", + "symfony/finder": "<6.4", "symfony/service-contracts": "<2.5" }, "require-dev": { - "symfony/event-dispatcher": "^5.4|^6.0|^7.0", - "symfony/finder": "^5.4|^6.0|^7.0", - "symfony/messenger": "^5.4|^6.0|^7.0", + "symfony/event-dispatcher": "^6.4|^7.0|^8.0", + "symfony/finder": "^6.4|^7.0|^8.0", + "symfony/messenger": "^6.4|^7.0|^8.0", "symfony/service-contracts": "^2.5|^3", - "symfony/yaml": "^5.4|^6.0|^7.0" + "symfony/yaml": "^6.4|^7.0|^8.0" }, "type": "library", "autoload": { @@ -3526,7 +3529,7 @@ "description": "Helps you find, load, combine, autofill and validate configuration values of any kind", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/config/tree/v6.4.34" + "source": "https://github.com/symfony/config/tree/v7.4.10" }, "funding": [ { @@ -3546,20 +3549,20 @@ "type": "tidelift" } ], - "time": "2026-02-24T17:34:50+00:00" + "time": "2026-05-03T14:20:49+00:00" }, { "name": "symfony/console", - "version": "v6.4.35", + "version": "v6.4.39", "source": { "type": "git", "url": "https://github.com/symfony/console.git", - "reference": "49257c96304c508223815ee965c251e7c79e614e" + "reference": "c132f1215fe4aa45b70173cc00ce9a755dd31ec5" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/console/zipball/49257c96304c508223815ee965c251e7c79e614e", - "reference": "49257c96304c508223815ee965c251e7c79e614e", + "url": "https://api.github.com/repos/symfony/console/zipball/c132f1215fe4aa45b70173cc00ce9a755dd31ec5", + "reference": "c132f1215fe4aa45b70173cc00ce9a755dd31ec5", "shasum": "" }, "require": { @@ -3624,7 +3627,7 @@ "terminal" ], "support": { - "source": "https://github.com/symfony/console/tree/v6.4.35" + "source": "https://github.com/symfony/console/tree/v6.4.39" }, "funding": [ { @@ -3644,44 +3647,43 @@ "type": "tidelift" } ], - "time": "2026-03-06T13:31:08+00:00" + "time": "2026-05-12T06:50:03+00:00" }, { "name": "symfony/dependency-injection", - "version": "v6.4.35", + "version": "v7.4.10", "source": { "type": "git", "url": "https://github.com/symfony/dependency-injection.git", - "reference": "d95712d0e9446b9f244b64811ffb6af7b7434213" + "reference": "4eb0d9dfa9d4f7c59216baf49b3ed6b1fb72293d" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/dependency-injection/zipball/d95712d0e9446b9f244b64811ffb6af7b7434213", - "reference": "d95712d0e9446b9f244b64811ffb6af7b7434213", + "url": "https://api.github.com/repos/symfony/dependency-injection/zipball/4eb0d9dfa9d4f7c59216baf49b3ed6b1fb72293d", + "reference": "4eb0d9dfa9d4f7c59216baf49b3ed6b1fb72293d", "shasum": "" }, "require": { - "php": ">=8.1", + "php": ">=8.2", "psr/container": "^1.1|^2.0", "symfony/deprecation-contracts": "^2.5|^3", - "symfony/service-contracts": "^2.5|^3.0", - "symfony/var-exporter": "^6.4.20|^7.2.5" + "symfony/service-contracts": "^3.6", + "symfony/var-exporter": "^6.4.20|^7.2.5|^8.0" }, "conflict": { "ext-psr": "<1.1|>=2", - "symfony/config": "<6.1", - "symfony/finder": "<5.4", - "symfony/proxy-manager-bridge": "<6.3", - "symfony/yaml": "<5.4" + "symfony/config": "<6.4", + "symfony/finder": "<6.4", + "symfony/yaml": "<6.4" }, "provide": { "psr/container-implementation": "1.1|2.0", "symfony/service-implementation": "1.1|2.0|3.0" }, "require-dev": { - "symfony/config": "^6.1|^7.0", - "symfony/expression-language": "^5.4|^6.0|^7.0", - "symfony/yaml": "^5.4|^6.0|^7.0" + "symfony/config": "^6.4|^7.0|^8.0", + "symfony/expression-language": "^6.4|^7.0|^8.0", + "symfony/yaml": "^6.4|^7.0|^8.0" }, "type": "library", "autoload": { @@ -3709,7 +3711,7 @@ "description": "Allows you to standardize and centralize the way objects are constructed in your application", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/dependency-injection/tree/v6.4.35" + "source": "https://github.com/symfony/dependency-injection/tree/v7.4.10" }, "funding": [ { @@ -3729,20 +3731,20 @@ "type": "tidelift" } ], - "time": "2026-02-26T12:16:01+00:00" + "time": "2026-05-06T11:55:30+00:00" }, { "name": "symfony/deprecation-contracts", - "version": "v3.6.0", + "version": "v3.7.0", "source": { "type": "git", "url": "https://github.com/symfony/deprecation-contracts.git", - "reference": "63afe740e99a13ba87ec199bb07bbdee937a5b62" + "reference": "50f59d1f3ca46d41ac911f97a78626b6756af35b" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/63afe740e99a13ba87ec199bb07bbdee937a5b62", - "reference": "63afe740e99a13ba87ec199bb07bbdee937a5b62", + "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/50f59d1f3ca46d41ac911f97a78626b6756af35b", + "reference": "50f59d1f3ca46d41ac911f97a78626b6756af35b", "shasum": "" }, "require": { @@ -3755,7 +3757,7 @@ "name": "symfony/contracts" }, "branch-alias": { - "dev-main": "3.6-dev" + "dev-main": "3.7-dev" } }, "autoload": { @@ -3780,7 +3782,7 @@ "description": "A generic function and convention to trigger deprecation notices", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/deprecation-contracts/tree/v3.6.0" + "source": "https://github.com/symfony/deprecation-contracts/tree/v3.7.0" }, "funding": [ { @@ -3791,40 +3793,47 @@ "url": "https://github.com/fabpot", "type": "github" }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], - "time": "2024-09-25T14:21:43+00:00" + "time": "2026-04-13T15:52:40+00:00" }, { "name": "symfony/error-handler", - "version": "v6.4.32", + "version": "v7.4.8", "source": { "type": "git", "url": "https://github.com/symfony/error-handler.git", - "reference": "8c18400784fcb014dc73c8d5601a9576af7f8ad4" + "reference": "8dd79d8af777ee6cba2fd4d98da6ffb839f3c0fa" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/error-handler/zipball/8c18400784fcb014dc73c8d5601a9576af7f8ad4", - "reference": "8c18400784fcb014dc73c8d5601a9576af7f8ad4", + "url": "https://api.github.com/repos/symfony/error-handler/zipball/8dd79d8af777ee6cba2fd4d98da6ffb839f3c0fa", + "reference": "8dd79d8af777ee6cba2fd4d98da6ffb839f3c0fa", "shasum": "" }, "require": { - "php": ">=8.1", + "php": ">=8.2", "psr/log": "^1|^2|^3", - "symfony/var-dumper": "^5.4|^6.0|^7.0" + "symfony/polyfill-php85": "^1.32", + "symfony/var-dumper": "^6.4|^7.0|^8.0" }, "conflict": { "symfony/deprecation-contracts": "<2.5", "symfony/http-kernel": "<6.4" }, "require-dev": { + "symfony/console": "^6.4|^7.0|^8.0", "symfony/deprecation-contracts": "^2.5|^3", - "symfony/http-kernel": "^6.4|^7.0", - "symfony/serializer": "^5.4|^6.0|^7.0" + "symfony/http-kernel": "^6.4|^7.0|^8.0", + "symfony/serializer": "^6.4|^7.0|^8.0", + "symfony/webpack-encore-bundle": "^1.0|^2.0" }, "bin": [ "Resources/bin/patch-type-declarations" @@ -3855,7 +3864,7 @@ "description": "Provides tools to manage errors and ease debugging PHP code", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/error-handler/tree/v6.4.32" + "source": "https://github.com/symfony/error-handler/tree/v7.4.8" }, "funding": [ { @@ -3875,28 +3884,28 @@ "type": "tidelift" } ], - "time": "2026-01-19T19:28:19+00:00" + "time": "2026-03-24T13:12:05+00:00" }, { "name": "symfony/event-dispatcher", - "version": "v6.4.32", + "version": "v7.4.9", "source": { "type": "git", "url": "https://github.com/symfony/event-dispatcher.git", - "reference": "99d7e101826e6610606b9433248f80c1997cd20b" + "reference": "e4a2e29753c7801f7a8340e066cfa788f3bc8101" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/event-dispatcher/zipball/99d7e101826e6610606b9433248f80c1997cd20b", - "reference": "99d7e101826e6610606b9433248f80c1997cd20b", + "url": "https://api.github.com/repos/symfony/event-dispatcher/zipball/e4a2e29753c7801f7a8340e066cfa788f3bc8101", + "reference": "e4a2e29753c7801f7a8340e066cfa788f3bc8101", "shasum": "" }, "require": { - "php": ">=8.1", + "php": ">=8.2", "symfony/event-dispatcher-contracts": "^2.5|^3" }, "conflict": { - "symfony/dependency-injection": "<5.4", + "symfony/dependency-injection": "<6.4", "symfony/service-contracts": "<2.5" }, "provide": { @@ -3905,13 +3914,14 @@ }, "require-dev": { "psr/log": "^1|^2|^3", - "symfony/config": "^5.4|^6.0|^7.0", - "symfony/dependency-injection": "^5.4|^6.0|^7.0", - "symfony/error-handler": "^5.4|^6.0|^7.0", - "symfony/expression-language": "^5.4|^6.0|^7.0", - "symfony/http-foundation": "^5.4|^6.0|^7.0", + "symfony/config": "^6.4|^7.0|^8.0", + "symfony/dependency-injection": "^6.4|^7.0|^8.0", + "symfony/error-handler": "^6.4|^7.0|^8.0", + "symfony/expression-language": "^6.4|^7.0|^8.0", + "symfony/framework-bundle": "^6.4|^7.0|^8.0", + "symfony/http-foundation": "^6.4|^7.0|^8.0", "symfony/service-contracts": "^2.5|^3", - "symfony/stopwatch": "^5.4|^6.0|^7.0" + "symfony/stopwatch": "^6.4|^7.0|^8.0" }, "type": "library", "autoload": { @@ -3939,7 +3949,7 @@ "description": "Provides tools that allow your application components to communicate with each other by dispatching events and listening to them", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/event-dispatcher/tree/v6.4.32" + "source": "https://github.com/symfony/event-dispatcher/tree/v7.4.9" }, "funding": [ { @@ -3959,20 +3969,20 @@ "type": "tidelift" } ], - "time": "2026-01-05T11:13:48+00:00" + "time": "2026-04-18T13:18:21+00:00" }, { "name": "symfony/event-dispatcher-contracts", - "version": "v3.6.0", + "version": "v3.7.0", "source": { "type": "git", "url": "https://github.com/symfony/event-dispatcher-contracts.git", - "reference": "59eb412e93815df44f05f342958efa9f46b1e586" + "reference": "ccba7060602b7fed0b03c85bf025257f76d9ef32" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/event-dispatcher-contracts/zipball/59eb412e93815df44f05f342958efa9f46b1e586", - "reference": "59eb412e93815df44f05f342958efa9f46b1e586", + "url": "https://api.github.com/repos/symfony/event-dispatcher-contracts/zipball/ccba7060602b7fed0b03c85bf025257f76d9ef32", + "reference": "ccba7060602b7fed0b03c85bf025257f76d9ef32", "shasum": "" }, "require": { @@ -3986,7 +3996,7 @@ "name": "symfony/contracts" }, "branch-alias": { - "dev-main": "3.6-dev" + "dev-main": "3.7-dev" } }, "autoload": { @@ -4019,7 +4029,7 @@ "standards" ], "support": { - "source": "https://github.com/symfony/event-dispatcher-contracts/tree/v3.6.0" + "source": "https://github.com/symfony/event-dispatcher-contracts/tree/v3.7.0" }, "funding": [ { @@ -4030,34 +4040,38 @@ "url": "https://github.com/fabpot", "type": "github" }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], - "time": "2024-09-25T14:21:43+00:00" + "time": "2026-01-05T13:30:16+00:00" }, { "name": "symfony/filesystem", - "version": "v6.4.34", + "version": "v7.4.11", "source": { "type": "git", "url": "https://github.com/symfony/filesystem.git", - "reference": "01ffe0411b842f93c571e5c391f289c3fdd498c3" + "reference": "d721ea61b4a5fba8c5b6e7c1feda19efea144b50" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/filesystem/zipball/01ffe0411b842f93c571e5c391f289c3fdd498c3", - "reference": "01ffe0411b842f93c571e5c391f289c3fdd498c3", + "url": "https://api.github.com/repos/symfony/filesystem/zipball/d721ea61b4a5fba8c5b6e7c1feda19efea144b50", + "reference": "d721ea61b4a5fba8c5b6e7c1feda19efea144b50", "shasum": "" }, "require": { - "php": ">=8.1", + "php": ">=8.2", "symfony/polyfill-ctype": "~1.8", "symfony/polyfill-mbstring": "~1.8" }, "require-dev": { - "symfony/process": "^5.4|^6.4|^7.0" + "symfony/process": "^6.4|^7.0|^8.0" }, "type": "library", "autoload": { @@ -4085,7 +4099,7 @@ "description": "Provides basic utilities for the filesystem", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/filesystem/tree/v6.4.34" + "source": "https://github.com/symfony/filesystem/tree/v7.4.11" }, "funding": [ { @@ -4105,24 +4119,24 @@ "type": "tidelift" } ], - "time": "2026-02-24T17:51:06+00:00" + "time": "2026-05-11T16:38:44+00:00" }, { "name": "symfony/http-client", - "version": "v6.4.34", + "version": "v7.4.9", "source": { "type": "git", "url": "https://github.com/symfony/http-client.git", - "reference": "0dc71f52e5d35bb045fd0f82b1a80c027971d551" + "reference": "7e941c6abf4e3bf7dca160bf0e11ef36a9f832f6" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/http-client/zipball/0dc71f52e5d35bb045fd0f82b1a80c027971d551", - "reference": "0dc71f52e5d35bb045fd0f82b1a80c027971d551", + "url": "https://api.github.com/repos/symfony/http-client/zipball/7e941c6abf4e3bf7dca160bf0e11ef36a9f832f6", + "reference": "7e941c6abf4e3bf7dca160bf0e11ef36a9f832f6", "shasum": "" }, "require": { - "php": ">=8.1", + "php": ">=8.2", "psr/log": "^1|^2|^3", "symfony/deprecation-contracts": "^2.5|^3", "symfony/http-client-contracts": "~3.4.4|^3.5.2", @@ -4130,8 +4144,10 @@ "symfony/service-contracts": "^2.5|^3" }, "conflict": { + "amphp/amp": "<2.5", + "amphp/socket": "<1.1", "php-http/discovery": "<1.15", - "symfony/http-foundation": "<6.3" + "symfony/http-foundation": "<6.4" }, "provide": { "php-http/async-client-implementation": "*", @@ -4140,19 +4156,20 @@ "symfony/http-client-implementation": "3.0" }, "require-dev": { - "amphp/amp": "^2.5", - "amphp/http-client": "^4.2.1", - "amphp/http-tunnel": "^1.0", - "amphp/socket": "^1.1", + "amphp/http-client": "^4.2.1|^5.0", + "amphp/http-tunnel": "^1.0|^2.0", "guzzlehttp/promises": "^1.4|^2.0", "nyholm/psr7": "^1.0", "php-http/httplug": "^1.0|^2.0", "psr/http-client": "^1.0", - "symfony/dependency-injection": "^5.4|^6.0|^7.0", - "symfony/http-kernel": "^5.4|^6.0|^7.0", - "symfony/messenger": "^5.4|^6.0|^7.0", - "symfony/process": "^5.4|^6.0|^7.0", - "symfony/stopwatch": "^5.4|^6.0|^7.0" + "symfony/amphp-http-client-meta": "^1.0|^2.0", + "symfony/cache": "^6.4|^7.0|^8.0", + "symfony/dependency-injection": "^6.4|^7.0|^8.0", + "symfony/http-kernel": "^6.4|^7.0|^8.0", + "symfony/messenger": "^6.4|^7.0|^8.0", + "symfony/process": "^6.4|^7.0|^8.0", + "symfony/rate-limiter": "^6.4|^7.0|^8.0", + "symfony/stopwatch": "^6.4|^7.0|^8.0" }, "type": "library", "autoload": { @@ -4183,7 +4200,7 @@ "http" ], "support": { - "source": "https://github.com/symfony/http-client/tree/v6.4.34" + "source": "https://github.com/symfony/http-client/tree/v7.4.9" }, "funding": [ { @@ -4203,20 +4220,20 @@ "type": "tidelift" } ], - "time": "2026-02-18T07:27:25+00:00" + "time": "2026-04-29T13:25:15+00:00" }, { "name": "symfony/http-client-contracts", - "version": "v3.6.0", + "version": "v3.7.0", "source": { "type": "git", "url": "https://github.com/symfony/http-client-contracts.git", - "reference": "75d7043853a42837e68111812f4d964b01e5101c" + "reference": "4a2d00c37651c0bdc2b9e1c773487a8bf4edb12d" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/75d7043853a42837e68111812f4d964b01e5101c", - "reference": "75d7043853a42837e68111812f4d964b01e5101c", + "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/4a2d00c37651c0bdc2b9e1c773487a8bf4edb12d", + "reference": "4a2d00c37651c0bdc2b9e1c773487a8bf4edb12d", "shasum": "" }, "require": { @@ -4229,7 +4246,7 @@ "name": "symfony/contracts" }, "branch-alias": { - "dev-main": "3.6-dev" + "dev-main": "3.7-dev" } }, "autoload": { @@ -4265,7 +4282,7 @@ "standards" ], "support": { - "source": "https://github.com/symfony/http-client-contracts/tree/v3.6.0" + "source": "https://github.com/symfony/http-client-contracts/tree/v3.7.0" }, "funding": [ { @@ -4276,12 +4293,16 @@ "url": "https://github.com/fabpot", "type": "github" }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, { "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", "type": "tidelift" } ], - "time": "2025-04-29T11:18:49+00:00" + "time": "2026-03-06T13:17:50+00:00" }, { "name": "symfony/http-foundation", @@ -4366,16 +4387,16 @@ }, { "name": "symfony/http-kernel", - "version": "v6.4.35", + "version": "v6.4.40", "source": { "type": "git", "url": "https://github.com/symfony/http-kernel.git", - "reference": "ece1a0da7745a5243683f178155c0412c92691eb" + "reference": "41dff5c3d03b3fa20947c552c5f6ba74ca43fa28" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/http-kernel/zipball/ece1a0da7745a5243683f178155c0412c92691eb", - "reference": "ece1a0da7745a5243683f178155c0412c92691eb", + "url": "https://api.github.com/repos/symfony/http-kernel/zipball/41dff5c3d03b3fa20947c552c5f6ba74ca43fa28", + "reference": "41dff5c3d03b3fa20947c552c5f6ba74ca43fa28", "shasum": "" }, "require": { @@ -4460,7 +4481,7 @@ "description": "Provides a structured process for converting a Request into a Response", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/http-kernel/tree/v6.4.35" + "source": "https://github.com/symfony/http-kernel/tree/v6.4.40" }, "funding": [ { @@ -4480,20 +4501,20 @@ "type": "tidelift" } ], - "time": "2026-03-06T16:28:07+00:00" + "time": "2026-05-20T08:55:59+00:00" }, { "name": "symfony/polyfill-ctype", - "version": "v1.33.0", + "version": "v1.37.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-ctype.git", - "reference": "a3cc8b044a6ea513310cbd48ef7333b384945638" + "reference": "141046a8f9477948ff284fa65be2095baafb94f2" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/a3cc8b044a6ea513310cbd48ef7333b384945638", - "reference": "a3cc8b044a6ea513310cbd48ef7333b384945638", + "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/141046a8f9477948ff284fa65be2095baafb94f2", + "reference": "141046a8f9477948ff284fa65be2095baafb94f2", "shasum": "" }, "require": { @@ -4543,7 +4564,7 @@ "portable" ], "support": { - "source": "https://github.com/symfony/polyfill-ctype/tree/v1.33.0" + "source": "https://github.com/symfony/polyfill-ctype/tree/v1.37.0" }, "funding": [ { @@ -4563,7 +4584,7 @@ "type": "tidelift" } ], - "time": "2024-09-09T11:45:10+00:00" + "time": "2026-04-10T16:19:22+00:00" }, { "name": "symfony/polyfill-iconv", @@ -4651,16 +4672,16 @@ }, { "name": "symfony/polyfill-intl-grapheme", - "version": "v1.33.0", + "version": "v1.37.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-intl-grapheme.git", - "reference": "380872130d3a5dd3ace2f4010d95125fde5d5c70" + "reference": "4864388bfbd3001ce88e234fab652acd91fdc57e" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/380872130d3a5dd3ace2f4010d95125fde5d5c70", - "reference": "380872130d3a5dd3ace2f4010d95125fde5d5c70", + "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/4864388bfbd3001ce88e234fab652acd91fdc57e", + "reference": "4864388bfbd3001ce88e234fab652acd91fdc57e", "shasum": "" }, "require": { @@ -4709,7 +4730,7 @@ "shim" ], "support": { - "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.33.0" + "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.37.0" }, "funding": [ { @@ -4729,11 +4750,11 @@ "type": "tidelift" } ], - "time": "2025-06-27T09:58:17+00:00" + "time": "2026-04-26T13:13:48+00:00" }, { "name": "symfony/polyfill-intl-normalizer", - "version": "v1.33.0", + "version": "v1.37.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-intl-normalizer.git", @@ -4794,7 +4815,7 @@ "shim" ], "support": { - "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.33.0" + "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.37.0" }, "funding": [ { @@ -4903,16 +4924,16 @@ }, { "name": "symfony/polyfill-php82", - "version": "v1.33.0", + "version": "v1.37.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-php82.git", - "reference": "5d2ed36f7734637dacc025f179698031951b1692" + "reference": "34808efe3e68f69685796f7c253a2f1d8ea9df59" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/polyfill-php82/zipball/5d2ed36f7734637dacc025f179698031951b1692", - "reference": "5d2ed36f7734637dacc025f179698031951b1692", + "url": "https://api.github.com/repos/symfony/polyfill-php82/zipball/34808efe3e68f69685796f7c253a2f1d8ea9df59", + "reference": "34808efe3e68f69685796f7c253a2f1d8ea9df59", "shasum": "" }, "require": { @@ -4959,7 +4980,7 @@ "shim" ], "support": { - "source": "https://github.com/symfony/polyfill-php82/tree/v1.33.0" + "source": "https://github.com/symfony/polyfill-php82/tree/v1.37.0" }, "funding": [ { @@ -4979,20 +5000,20 @@ "type": "tidelift" } ], - "time": "2024-09-09T11:45:10+00:00" + "time": "2026-04-10T16:19:22+00:00" }, { "name": "symfony/polyfill-php83", - "version": "v1.33.0", + "version": "v1.37.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-php83.git", - "reference": "17f6f9a6b1735c0f163024d959f700cfbc5155e5" + "reference": "3600c2cb22399e25bb226e4a135ce91eeb2a6149" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/polyfill-php83/zipball/17f6f9a6b1735c0f163024d959f700cfbc5155e5", - "reference": "17f6f9a6b1735c0f163024d959f700cfbc5155e5", + "url": "https://api.github.com/repos/symfony/polyfill-php83/zipball/3600c2cb22399e25bb226e4a135ce91eeb2a6149", + "reference": "3600c2cb22399e25bb226e4a135ce91eeb2a6149", "shasum": "" }, "require": { @@ -5039,7 +5060,7 @@ "shim" ], "support": { - "source": "https://github.com/symfony/polyfill-php83/tree/v1.33.0" + "source": "https://github.com/symfony/polyfill-php83/tree/v1.37.0" }, "funding": [ { @@ -5059,20 +5080,100 @@ "type": "tidelift" } ], - "time": "2025-07-08T02:45:35+00:00" + "time": "2026-04-10T17:25:58+00:00" + }, + { + "name": "symfony/polyfill-php85", + "version": "v1.37.0", + "source": { + "type": "git", + "url": "https://github.com/symfony/polyfill-php85.git", + "reference": "fcfa4973a9917cef23f2e38774da74a2b7d115ee" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/polyfill-php85/zipball/fcfa4973a9917cef23f2e38774da74a2b7d115ee", + "reference": "fcfa4973a9917cef23f2e38774da74a2b7d115ee", + "shasum": "" + }, + "require": { + "php": ">=7.2" + }, + "type": "library", + "extra": { + "thanks": { + "url": "https://github.com/symfony/polyfill", + "name": "symfony/polyfill" + } + }, + "autoload": { + "files": [ + "bootstrap.php" + ], + "psr-4": { + "Symfony\\Polyfill\\Php85\\": "" + }, + "classmap": [ + "Resources/stubs" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Nicolas Grekas", + "email": "p@tchwork.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Symfony polyfill backporting some PHP 8.5+ features to lower PHP versions", + "homepage": "https://symfony.com", + "keywords": [ + "compatibility", + "polyfill", + "portable", + "shim" + ], + "support": { + "source": "https://github.com/symfony/polyfill-php85/tree/v1.37.0" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-04-26T13:10:57+00:00" }, { "name": "symfony/polyfill-uuid", - "version": "v1.33.0", + "version": "v1.37.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-uuid.git", - "reference": "21533be36c24be3f4b1669c4725c7d1d2bab4ae2" + "reference": "26dfec253c4cf3e51b541b52ddf7e42cb0908e94" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/polyfill-uuid/zipball/21533be36c24be3f4b1669c4725c7d1d2bab4ae2", - "reference": "21533be36c24be3f4b1669c4725c7d1d2bab4ae2", + "url": "https://api.github.com/repos/symfony/polyfill-uuid/zipball/26dfec253c4cf3e51b541b52ddf7e42cb0908e94", + "reference": "26dfec253c4cf3e51b541b52ddf7e42cb0908e94", "shasum": "" }, "require": { @@ -5122,7 +5223,7 @@ "uuid" ], "support": { - "source": "https://github.com/symfony/polyfill-uuid/tree/v1.33.0" + "source": "https://github.com/symfony/polyfill-uuid/tree/v1.37.0" }, "funding": [ { @@ -5142,20 +5243,85 @@ "type": "tidelift" } ], - "time": "2024-09-09T11:45:10+00:00" + "time": "2026-04-10T16:19:22+00:00" + }, + { + "name": "symfony/process", + "version": "v6.4.39", + "source": { + "type": "git", + "url": "https://github.com/symfony/process.git", + "reference": "6c93071cb8c91dce5a41960d125e019e64ef6cb5" + }, + "dist": { + "type": "zip", + "url": "https://api.github.com/repos/symfony/process/zipball/6c93071cb8c91dce5a41960d125e019e64ef6cb5", + "reference": "6c93071cb8c91dce5a41960d125e019e64ef6cb5", + "shasum": "" + }, + "require": { + "php": ">=8.1" + }, + "type": "library", + "autoload": { + "psr-4": { + "Symfony\\Component\\Process\\": "" + }, + "exclude-from-classmap": [ + "/Tests/" + ] + }, + "notification-url": "https://packagist.org/downloads/", + "license": [ + "MIT" + ], + "authors": [ + { + "name": "Fabien Potencier", + "email": "fabien@symfony.com" + }, + { + "name": "Symfony Community", + "homepage": "https://symfony.com/contributors" + } + ], + "description": "Executes commands in sub-processes", + "homepage": "https://symfony.com", + "support": { + "source": "https://github.com/symfony/process/tree/v6.4.39" + }, + "funding": [ + { + "url": "https://symfony.com/sponsor", + "type": "custom" + }, + { + "url": "https://github.com/fabpot", + "type": "github" + }, + { + "url": "https://github.com/nicolas-grekas", + "type": "github" + }, + { + "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", + "type": "tidelift" + } + ], + "time": "2026-05-11T16:53:15+00:00" }, { "name": "symfony/service-contracts", - "version": "v3.6.1", + "version": "v3.7.0", "source": { "type": "git", "url": "https://github.com/symfony/service-contracts.git", - "reference": "45112560a3ba2d715666a509a0bc9521d10b6c43" + "reference": "d25d82433a80eba6aa0e6c24b61d7370d99e444a" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/service-contracts/zipball/45112560a3ba2d715666a509a0bc9521d10b6c43", - "reference": "45112560a3ba2d715666a509a0bc9521d10b6c43", + "url": "https://api.github.com/repos/symfony/service-contracts/zipball/d25d82433a80eba6aa0e6c24b61d7370d99e444a", + "reference": "d25d82433a80eba6aa0e6c24b61d7370d99e444a", "shasum": "" }, "require": { @@ -5173,7 +5339,7 @@ "name": "symfony/contracts" }, "branch-alias": { - "dev-main": "3.6-dev" + "dev-main": "3.7-dev" } }, "autoload": { @@ -5209,7 +5375,7 @@ "standards" ], "support": { - "source": "https://github.com/symfony/service-contracts/tree/v3.6.1" + "source": "https://github.com/symfony/service-contracts/tree/v3.7.0" }, "funding": [ { @@ -5229,26 +5395,27 @@ "type": "tidelift" } ], - "time": "2025-07-15T11:30:57+00:00" + "time": "2026-03-28T09:44:51+00:00" }, { "name": "symfony/string", - "version": "v6.4.34", + "version": "v7.4.11", "source": { "type": "git", "url": "https://github.com/symfony/string.git", - "reference": "2adaf4106f2ef4c67271971bde6d3fe0a6936432" + "reference": "965f7306a43383d02c6aca1e3f3bd2f0ea5dee15" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/string/zipball/2adaf4106f2ef4c67271971bde6d3fe0a6936432", - "reference": "2adaf4106f2ef4c67271971bde6d3fe0a6936432", + "url": "https://api.github.com/repos/symfony/string/zipball/965f7306a43383d02c6aca1e3f3bd2f0ea5dee15", + "reference": "965f7306a43383d02c6aca1e3f3bd2f0ea5dee15", "shasum": "" }, "require": { - "php": ">=8.1", + "php": ">=8.2", + "symfony/deprecation-contracts": "^2.5|^3.0", "symfony/polyfill-ctype": "~1.8", - "symfony/polyfill-intl-grapheme": "~1.0", + "symfony/polyfill-intl-grapheme": "~1.33", "symfony/polyfill-intl-normalizer": "~1.0", "symfony/polyfill-mbstring": "~1.0" }, @@ -5256,10 +5423,11 @@ "symfony/translation-contracts": "<2.5" }, "require-dev": { - "symfony/http-client": "^5.4|^6.0|^7.0", - "symfony/intl": "^6.2|^7.0", + "symfony/emoji": "^7.1|^8.0", + "symfony/http-client": "^6.4|^7.0|^8.0", + "symfony/intl": "^6.4|^7.0|^8.0", "symfony/translation-contracts": "^2.5|^3.0", - "symfony/var-exporter": "^5.4|^6.0|^7.0" + "symfony/var-exporter": "^6.4|^7.0|^8.0" }, "type": "library", "autoload": { @@ -5298,7 +5466,7 @@ "utf8" ], "support": { - "source": "https://github.com/symfony/string/tree/v6.4.34" + "source": "https://github.com/symfony/string/tree/v7.4.11" }, "funding": [ { @@ -5318,7 +5486,7 @@ "type": "tidelift" } ], - "time": "2026-02-08T20:44:54+00:00" + "time": "2026-05-13T12:04:42+00:00" }, { "name": "symfony/uid", @@ -5400,33 +5568,32 @@ }, { "name": "symfony/var-dumper", - "version": "v6.4.32", + "version": "v7.4.8", "source": { "type": "git", "url": "https://github.com/symfony/var-dumper.git", - "reference": "131fc9915e0343052af5ed5040401b481ca192aa" + "reference": "9510c3966f749a1d1ff0059e1eabef6cc621e7fd" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/var-dumper/zipball/131fc9915e0343052af5ed5040401b481ca192aa", - "reference": "131fc9915e0343052af5ed5040401b481ca192aa", + "url": "https://api.github.com/repos/symfony/var-dumper/zipball/9510c3966f749a1d1ff0059e1eabef6cc621e7fd", + "reference": "9510c3966f749a1d1ff0059e1eabef6cc621e7fd", "shasum": "" }, "require": { - "php": ">=8.1", + "php": ">=8.2", "symfony/deprecation-contracts": "^2.5|^3", "symfony/polyfill-mbstring": "~1.0" }, "conflict": { - "symfony/console": "<5.4" + "symfony/console": "<6.4" }, "require-dev": { - "symfony/console": "^5.4|^6.0|^7.0", - "symfony/error-handler": "^6.3|^7.0", - "symfony/http-kernel": "^5.4|^6.0|^7.0", - "symfony/process": "^5.4|^6.0|^7.0", - "symfony/uid": "^5.4|^6.0|^7.0", - "twig/twig": "^2.13|^3.0.4" + "symfony/console": "^6.4|^7.0|^8.0", + "symfony/http-kernel": "^6.4|^7.0|^8.0", + "symfony/process": "^6.4|^7.0|^8.0", + "symfony/uid": "^6.4|^7.0|^8.0", + "twig/twig": "^3.12" }, "bin": [ "Resources/bin/var-dump-server" @@ -5464,7 +5631,7 @@ "dump" ], "support": { - "source": "https://github.com/symfony/var-dumper/tree/v6.4.32" + "source": "https://github.com/symfony/var-dumper/tree/v7.4.8" }, "funding": [ { @@ -5484,30 +5651,30 @@ "type": "tidelift" } ], - "time": "2026-01-01T13:34:06+00:00" + "time": "2026-03-30T13:44:50+00:00" }, { "name": "symfony/var-exporter", - "version": "v6.4.26", + "version": "v7.4.9", "source": { "type": "git", "url": "https://github.com/symfony/var-exporter.git", - "reference": "466fcac5fa2e871f83d31173f80e9c2684743bfc" + "reference": "22e03a49c95ef054a43601cd159b222bfab1c701" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/var-exporter/zipball/466fcac5fa2e871f83d31173f80e9c2684743bfc", - "reference": "466fcac5fa2e871f83d31173f80e9c2684743bfc", + "url": "https://api.github.com/repos/symfony/var-exporter/zipball/22e03a49c95ef054a43601cd159b222bfab1c701", + "reference": "22e03a49c95ef054a43601cd159b222bfab1c701", "shasum": "" }, "require": { - "php": ">=8.1", + "php": ">=8.2", "symfony/deprecation-contracts": "^2.5|^3" }, "require-dev": { - "symfony/property-access": "^6.4|^7.0", - "symfony/serializer": "^6.4|^7.0", - "symfony/var-dumper": "^5.4|^6.0|^7.0" + "symfony/property-access": "^6.4|^7.0|^8.0", + "symfony/serializer": "^6.4|^7.0|^8.0", + "symfony/var-dumper": "^6.4|^7.0|^8.0" }, "type": "library", "autoload": { @@ -5545,7 +5712,7 @@ "serialize" ], "support": { - "source": "https://github.com/symfony/var-exporter/tree/v6.4.26" + "source": "https://github.com/symfony/var-exporter/tree/v7.4.9" }, "funding": [ { @@ -5565,32 +5732,32 @@ "type": "tidelift" } ], - "time": "2025-09-11T09:57:09+00:00" + "time": "2026-04-18T13:18:21+00:00" }, { "name": "symfony/yaml", - "version": "v6.4.34", + "version": "v7.4.12", "source": { "type": "git", "url": "https://github.com/symfony/yaml.git", - "reference": "7bca30dabed7900a08c5ad4f1d6483f881a64d0f" + "reference": "8b6952b56ca6417f25f7a65758cadd0ce02edc51" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/yaml/zipball/7bca30dabed7900a08c5ad4f1d6483f881a64d0f", - "reference": "7bca30dabed7900a08c5ad4f1d6483f881a64d0f", + "url": "https://api.github.com/repos/symfony/yaml/zipball/8b6952b56ca6417f25f7a65758cadd0ce02edc51", + "reference": "8b6952b56ca6417f25f7a65758cadd0ce02edc51", "shasum": "" }, "require": { - "php": ">=8.1", + "php": ">=8.2", "symfony/deprecation-contracts": "^2.5|^3", "symfony/polyfill-ctype": "^1.8" }, "conflict": { - "symfony/console": "<5.4" + "symfony/console": "<6.4" }, "require-dev": { - "symfony/console": "^5.4|^6.0|^7.0" + "symfony/console": "^6.4|^7.0|^8.0" }, "bin": [ "Resources/bin/yaml-lint" @@ -5621,7 +5788,7 @@ "description": "Loads and dumps YAML files", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/yaml/tree/v6.4.34" + "source": "https://github.com/symfony/yaml/tree/v7.4.12" }, "funding": [ { @@ -5641,7 +5808,7 @@ "type": "tidelift" } ], - "time": "2026-02-06T18:32:11+00:00" + "time": "2026-05-20T07:20:23+00:00" }, { "name": "thecodingmachine/safe", @@ -5788,24 +5955,24 @@ }, { "name": "theodo-group/llphant", - "version": "0.9.11", + "version": "0.9.12", "source": { "type": "git", "url": "https://github.com/LLPhant/LLPhant.git", - "reference": "f2e0dbbe394122f6432de044ffbdda81954ac331" + "reference": "2b37713fd93909564d72e40b62a4059fc9bdd551" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/LLPhant/LLPhant/zipball/f2e0dbbe394122f6432de044ffbdda81954ac331", - "reference": "f2e0dbbe394122f6432de044ffbdda81954ac331", + "url": "https://api.github.com/repos/LLPhant/LLPhant/zipball/2b37713fd93909564d72e40b62a4059fc9bdd551", + "reference": "2b37713fd93909564d72e40b62a4059fc9bdd551", "shasum": "" }, "require": { "guzzlehttp/guzzle": "^7.4.5", "guzzlehttp/psr7": "^2.7", - "openai-php/client": "^v0.10.3", + "openai-php/client": "^v0.13.0", "php": "^8.1.0", - "phpoffice/phpword": "^1.3.0", + "phpoffice/phpword": "^1.4.0", "psr/http-message": "^2.0", "psr/log": "^3.0", "smalot/pdfparser": "^2.11" @@ -5911,23 +6078,23 @@ "vectorstore" ], "support": { - "source": "https://github.com/LLPhant/LLPhant/tree/0.9.11", + "source": "https://github.com/LLPhant/LLPhant/tree/0.10.2", "issues": "https://github.com/LLPhant/LLPhant/issues" }, - "time": "2025-04-26T11:22:36+00:00" + "time": "2025-06-13T10:20:04+00:00" }, { "name": "twig/twig", - "version": "v3.23.0", + "version": "v3.26.0", "source": { "type": "git", "url": "https://github.com/twigphp/Twig.git", - "reference": "a64dc5d2cc7d6cafb9347f6cd802d0d06d0351c9" + "reference": "1fcae487b180d78e6351f4e0afa91f9eab96a2bc" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/twigphp/Twig/zipball/a64dc5d2cc7d6cafb9347f6cd802d0d06d0351c9", - "reference": "a64dc5d2cc7d6cafb9347f6cd802d0d06d0351c9", + "url": "https://api.github.com/repos/twigphp/Twig/zipball/1fcae487b180d78e6351f4e0afa91f9eab96a2bc", + "reference": "1fcae487b180d78e6351f4e0afa91f9eab96a2bc", "shasum": "" }, "require": { @@ -5937,7 +6104,8 @@ "symfony/polyfill-mbstring": "^1.3" }, "require-dev": { - "phpstan/phpstan": "^2.0", + "php-cs-fixer/shim": "^3.0@stable", + "phpstan/phpstan": "^2.0@stable", "psr/container": "^1.0|^2.0", "symfony/phpunit-bridge": "^5.4.9|^6.4|^7.0" }, @@ -5981,7 +6149,7 @@ ], "support": { "issues": "https://github.com/twigphp/Twig/issues", - "source": "https://github.com/twigphp/Twig/tree/v3.23.0" + "source": "https://github.com/twigphp/Twig/tree/v3.26.0" }, "funding": [ { @@ -5993,7 +6161,7 @@ "type": "tidelift" } ], - "time": "2026-01-23T21:00:41+00:00" + "time": "2026-05-20T07:31:59+00:00" }, { "name": "web-token/jwt-framework", @@ -6688,24 +6856,24 @@ }, { "name": "composer/spdx-licenses", - "version": "1.5.9", + "version": "1.6.0", "source": { "type": "git", "url": "https://github.com/composer/spdx-licenses.git", - "reference": "edf364cefe8c43501e21e88110aac10b284c3c9f" + "reference": "5ecd0cb4177696f9fd48f1605dda81db3dee7889" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/composer/spdx-licenses/zipball/edf364cefe8c43501e21e88110aac10b284c3c9f", - "reference": "edf364cefe8c43501e21e88110aac10b284c3c9f", + "url": "https://api.github.com/repos/composer/spdx-licenses/zipball/5ecd0cb4177696f9fd48f1605dda81db3dee7889", + "reference": "5ecd0cb4177696f9fd48f1605dda81db3dee7889", "shasum": "" }, "require": { - "php": "^5.3.2 || ^7.0 || ^8.0" + "php": "^7.2 || ^8.0" }, "require-dev": { "phpstan/phpstan": "^1.11", - "symfony/phpunit-bridge": "^3 || ^7" + "symfony/phpunit-bridge": "^6.4.25 || ^7.3.3 || ^8.0" }, "type": "library", "extra": { @@ -6748,7 +6916,7 @@ "support": { "irc": "ircs://irc.libera.chat:6697/composer", "issues": "https://github.com/composer/spdx-licenses/issues", - "source": "https://github.com/composer/spdx-licenses/tree/1.5.9" + "source": "https://github.com/composer/spdx-licenses/tree/1.6.0" }, "funding": [ { @@ -6758,13 +6926,9 @@ { "url": "https://github.com/composer", "type": "github" - }, - { - "url": "https://tidelift.com/funding/github/packagist/composer/composer", - "type": "tidelift" } ], - "time": "2025-05-12T21:07:07+00:00" + "time": "2026-04-08T20:18:39+00:00" }, { "name": "composer/xdebug-handler", @@ -6834,25 +6998,25 @@ }, { "name": "consolidation/annotated-command", - "version": "4.10.4", + "version": "4.10.5", "source": { "type": "git", "url": "https://github.com/consolidation/annotated-command.git", - "reference": "69d29da4acac31a43caa4cea13b6b948f4e5c56d" + "reference": "78abf3b6853d7ff9044babd2b9c002ff433207d8" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/consolidation/annotated-command/zipball/69d29da4acac31a43caa4cea13b6b948f4e5c56d", - "reference": "69d29da4acac31a43caa4cea13b6b948f4e5c56d", + "url": "https://api.github.com/repos/consolidation/annotated-command/zipball/78abf3b6853d7ff9044babd2b9c002ff433207d8", + "reference": "78abf3b6853d7ff9044babd2b9c002ff433207d8", "shasum": "" }, "require": { "consolidation/output-formatters": "^4.3.1", "php": ">=7.1.3", "psr/log": "^1 || ^2 || ^3", - "symfony/console": "^4.4.8 || ^5 || ^6 || ^7", - "symfony/event-dispatcher": "^4.4.8 || ^5 || ^6 || ^7", - "symfony/finder": "^4.4.8 || ^5 || ^6 || ^7" + "symfony/console": "^4.4.8 || ^5 || ^6 || ^7 || ^8", + "symfony/event-dispatcher": "^4.4.8 || ^5 || ^6 || ^7 || ^8", + "symfony/finder": "^4.4.8 || ^5 || ^6 || ^7 || ^8" }, "require-dev": { "composer-runtime-api": "^2.0", @@ -6884,36 +7048,36 @@ "description": "Initialize Symfony Console commands from annotated command class methods.", "support": { "issues": "https://github.com/consolidation/annotated-command/issues", - "source": "https://github.com/consolidation/annotated-command/tree/4.10.4" + "source": "https://github.com/consolidation/annotated-command/tree/4.10.5" }, - "time": "2025-11-14T22:57:49+00:00" + "time": "2026-03-29T00:50:52+00:00" }, { "name": "consolidation/config", - "version": "2.1.2", + "version": "3.2.1", "source": { "type": "git", "url": "https://github.com/consolidation/config.git", - "reference": "597f8d7fbeef801736250ec10c3e190569b1b0ae" + "reference": "adcb989d789f7e0984121492b0377a1def3a6dc8" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/consolidation/config/zipball/597f8d7fbeef801736250ec10c3e190569b1b0ae", - "reference": "597f8d7fbeef801736250ec10c3e190569b1b0ae", + "url": "https://api.github.com/repos/consolidation/config/zipball/adcb989d789f7e0984121492b0377a1def3a6dc8", + "reference": "adcb989d789f7e0984121492b0377a1def3a6dc8", "shasum": "" }, "require": { - "dflydev/dot-access-data": "^1.1.0 || ^2 || ^3", - "grasmash/expander": "^2.0.1 || ^3", - "php": ">=7.1.3", - "symfony/event-dispatcher": "^4 || ^5 || ^6" + "dflydev/dot-access-data": "^3", + "grasmash/expander": "^3", + "php": ">=8.2.0", + "symfony/event-dispatcher": "^6 || ^7 || ^8" }, "require-dev": { "ext-json": "*", - "phpunit/phpunit": ">=7.5.20", + "phpunit/phpunit": "^9", "squizlabs/php_codesniffer": "^3", - "symfony/console": "^4 || ^5 || ^6", - "symfony/yaml": "^4 || ^5 || ^6", + "symfony/console": "^7.4 || ^8", + "symfony/yaml": "^7 || ^8", "yoast/phpunit-polyfills": "^1" }, "suggest": { @@ -6923,7 +7087,7 @@ "type": "library", "extra": { "branch-alias": { - "dev-main": "2.x-dev" + "dev-main": "3.x-dev" } }, "autoload": { @@ -6944,28 +7108,28 @@ "description": "Provide configuration services for a commandline tool.", "support": { "issues": "https://github.com/consolidation/config/issues", - "source": "https://github.com/consolidation/config/tree/2.1.2" + "source": "https://github.com/consolidation/config/tree/3.2.1" }, - "time": "2022-10-06T17:48:03+00:00" + "time": "2026-03-28T23:38:17+00:00" }, { "name": "consolidation/log", - "version": "3.1.1", + "version": "3.1.2", "source": { "type": "git", "url": "https://github.com/consolidation/log.git", - "reference": "c1a87a94c01957697ec347fd67404d7f0030d1aa" + "reference": "a0c85d40ca18c22c93fdf78d7e8115cd438ccfe6" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/consolidation/log/zipball/c1a87a94c01957697ec347fd67404d7f0030d1aa", - "reference": "c1a87a94c01957697ec347fd67404d7f0030d1aa", + "url": "https://api.github.com/repos/consolidation/log/zipball/a0c85d40ca18c22c93fdf78d7e8115cd438ccfe6", + "reference": "a0c85d40ca18c22c93fdf78d7e8115cd438ccfe6", "shasum": "" }, "require": { "php": ">=8.0.0", "psr/log": "^3", - "symfony/console": "^5 || ^6 || ^7" + "symfony/console": "^5 || ^6 || ^7 || ^8" }, "require-dev": { "phpunit/phpunit": "^7.5.20 || ^8 || ^9", @@ -6996,36 +7160,36 @@ "description": "Improved Psr-3 / Psr\\Log logger based on Symfony Console components.", "support": { "issues": "https://github.com/consolidation/log/issues", - "source": "https://github.com/consolidation/log/tree/3.1.1" + "source": "https://github.com/consolidation/log/tree/3.1.2" }, - "time": "2025-11-14T21:11:00+00:00" + "time": "2026-03-28T23:36:49+00:00" }, { "name": "consolidation/output-formatters", - "version": "4.7.0", + "version": "4.7.1", "source": { "type": "git", "url": "https://github.com/consolidation/output-formatters.git", - "reference": "dfc464c4d4a47594cac5eac01ce265e04b70cb94" + "reference": "a112df9a74854c8438b33b334ed619fa43edf31a" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/consolidation/output-formatters/zipball/dfc464c4d4a47594cac5eac01ce265e04b70cb94", - "reference": "dfc464c4d4a47594cac5eac01ce265e04b70cb94", + "url": "https://api.github.com/repos/consolidation/output-formatters/zipball/a112df9a74854c8438b33b334ed619fa43edf31a", + "reference": "a112df9a74854c8438b33b334ed619fa43edf31a", "shasum": "" }, "require": { "dflydev/dot-access-data": "^1.1.0 || ^2 || ^3", "php": ">=7.1.3", - "symfony/console": "^4 || ^5 || ^6 || ^7", - "symfony/finder": "^4 || ^5 || ^6 || ^7" + "symfony/console": "^4 || ^5 || ^6 || ^7 || ^8", + "symfony/finder": "^4 || ^5 || ^6 || ^7 || ^8" }, "require-dev": { "php-coveralls/php-coveralls": "^2.4.2", "phpunit/phpunit": "^7 || ^8 || ^9", "squizlabs/php_codesniffer": "^3", - "symfony/var-dumper": "^4 || ^5 || ^6 || ^7", - "symfony/yaml": "^4 || ^5 || ^6 || ^7", + "symfony/var-dumper": "^4 || ^5 || ^6 || ^7 || ^8", + "symfony/yaml": "^4 || ^5 || ^6 || ^7 || ^8", "yoast/phpunit-polyfills": "^1" }, "suggest": { @@ -7050,39 +7214,38 @@ "description": "Format text by applying transformations provided by plug-in formatters.", "support": { "issues": "https://github.com/consolidation/output-formatters/issues", - "source": "https://github.com/consolidation/output-formatters/tree/4.7.0" + "source": "https://github.com/consolidation/output-formatters/tree/4.7.1" }, - "time": "2025-11-14T21:06:10+00:00" + "time": "2026-03-28T23:34:39+00:00" }, { "name": "consolidation/robo", - "version": "4.0.6", + "version": "5.1.1", "source": { "type": "git", "url": "https://github.com/consolidation/robo.git", - "reference": "55a272370940607649e5c46eb173c5c54f7c166d" + "reference": "6d02c7d800b5e1a3a8977ae74d23bce723486025" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/consolidation/robo/zipball/55a272370940607649e5c46eb173c5c54f7c166d", - "reference": "55a272370940607649e5c46eb173c5c54f7c166d", + "url": "https://api.github.com/repos/consolidation/robo/zipball/6d02c7d800b5e1a3a8977ae74d23bce723486025", + "reference": "6d02c7d800b5e1a3a8977ae74d23bce723486025", "shasum": "" }, "require": { "consolidation/annotated-command": "^4.8.1", - "consolidation/config": "^2.0.1", - "consolidation/log": "^2.0.2 || ^3", + "consolidation/config": "^3", + "consolidation/log": "^3", "consolidation/output-formatters": "^4.1.2", - "consolidation/self-update": "^2.0", "league/container": "^3.3.1 || ^4.0", - "php": ">=8.0", + "php": ">=8.2", "phpowermove/docblock": "^4.0", - "symfony/console": "^6", - "symfony/event-dispatcher": "^6", - "symfony/filesystem": "^6", - "symfony/finder": "^6", - "symfony/process": "^6", - "symfony/yaml": "^6" + "symfony/console": "^6 || ^7", + "symfony/event-dispatcher": "^6 || ^7", + "symfony/filesystem": "^6 || ^7", + "symfony/finder": "^6 || ^7", + "symfony/process": "^6 || ^7", + "symfony/yaml": "^6 || ^7" }, "conflict": { "codegyre/robo": "*" @@ -7091,11 +7254,12 @@ "natxet/cssmin": "3.0.4", "patchwork/jsqueeze": "^2", "pear/archive_tar": "^1.4.4", - "phpunit/phpunit": "^7.5.20 || ^8", + "phpunit/phpunit": "^7.5.20 || ^8 || ^9", "squizlabs/php_codesniffer": "^3.6", "yoast/phpunit-polyfills": "^0.2.0" }, "suggest": { + "consolidation/self-update": "For self-updating a phar-based app built with Robo", "natxet/cssmin": "For minifying CSS files in taskMinify", "patchwork/jsqueeze": "For minifying JS files in taskMinify", "pear/archive_tar": "Allows tar archives to be created and extracted in taskPack and taskExtract, respectively.", @@ -7123,64 +7287,9 @@ "description": "Modern task runner", "support": { "issues": "https://github.com/consolidation/robo/issues", - "source": "https://github.com/consolidation/robo/tree/4.0.6" + "source": "https://github.com/consolidation/robo/tree/5.1.1" }, - "time": "2023-04-30T21:49:04+00:00" - }, - { - "name": "consolidation/self-update", - "version": "2.2.0", - "source": { - "type": "git", - "url": "https://github.com/consolidation/self-update.git", - "reference": "972a1016761c9b63314e040836a12795dff6953a" - }, - "dist": { - "type": "zip", - "url": "https://api.github.com/repos/consolidation/self-update/zipball/972a1016761c9b63314e040836a12795dff6953a", - "reference": "972a1016761c9b63314e040836a12795dff6953a", - "shasum": "" - }, - "require": { - "composer/semver": "^3.2", - "php": ">=5.5.0", - "symfony/console": "^2.8 || ^3 || ^4 || ^5 || ^6", - "symfony/filesystem": "^2.5 || ^3 || ^4 || ^5 || ^6" - }, - "bin": [ - "scripts/release" - ], - "type": "library", - "extra": { - "branch-alias": { - "dev-main": "2.x-dev" - } - }, - "autoload": { - "psr-4": { - "SelfUpdate\\": "src" - } - }, - "notification-url": "https://packagist.org/downloads/", - "license": [ - "MIT" - ], - "authors": [ - { - "name": "Alexander Menk", - "email": "menk@mestrona.net" - }, - { - "name": "Greg Anderson", - "email": "greg.1.anderson@greenknowe.org" - } - ], - "description": "Provides a self:update command for Symfony Console applications.", - "support": { - "issues": "https://github.com/consolidation/self-update/issues", - "source": "https://github.com/consolidation/self-update/tree/2.2.0" - }, - "time": "2023-03-18T01:37:41+00:00" + "time": "2025-11-14T23:30:05+00:00" }, { "name": "cyclonedx/cyclonedx-library", @@ -7357,16 +7466,16 @@ }, { "name": "dealerdirect/phpcodesniffer-composer-installer", - "version": "v1.2.0", + "version": "v1.2.1", "source": { "type": "git", "url": "https://github.com/PHPCSStandards/composer-installer.git", - "reference": "845eb62303d2ca9b289ef216356568ccc075ffd1" + "reference": "963f0c67bffde0eac41b56be71ac0e8ba132f0bd" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/PHPCSStandards/composer-installer/zipball/845eb62303d2ca9b289ef216356568ccc075ffd1", - "reference": "845eb62303d2ca9b289ef216356568ccc075ffd1", + "url": "https://api.github.com/repos/PHPCSStandards/composer-installer/zipball/963f0c67bffde0eac41b56be71ac0e8ba132f0bd", + "reference": "963f0c67bffde0eac41b56be71ac0e8ba132f0bd", "shasum": "" }, "require": { @@ -7449,7 +7558,7 @@ "type": "thanks_dev" } ], - "time": "2025-11-11T04:32:07+00:00" + "time": "2026-05-06T08:26:05+00:00" }, { "name": "dflydev/dot-access-data", @@ -7903,16 +8012,16 @@ }, { "name": "kubawerlos/php-cs-fixer-custom-fixers", - "version": "v3.36.1", + "version": "v3.37.2", "source": { "type": "git", "url": "https://github.com/kubawerlos/php-cs-fixer-custom-fixers.git", - "reference": "ec9776e80f5ea9bf0d8ec16d662e431bfab19a24" + "reference": "678df979ce743466b42ddb6eea46b3f4c9a7bade" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/kubawerlos/php-cs-fixer-custom-fixers/zipball/ec9776e80f5ea9bf0d8ec16d662e431bfab19a24", - "reference": "ec9776e80f5ea9bf0d8ec16d662e431bfab19a24", + "url": "https://api.github.com/repos/kubawerlos/php-cs-fixer-custom-fixers/zipball/678df979ce743466b42ddb6eea46b3f4c9a7bade", + "reference": "678df979ce743466b42ddb6eea46b3f4c9a7bade", "shasum": "" }, "require": { @@ -7922,7 +8031,7 @@ "php": "^7.4 || ^8.0" }, "require-dev": { - "phpunit/phpunit": "^9.6.24 || ^10.5.51 || ^11.5.44" + "phpunit/phpunit": "^9.6.34 || ^10.5.63 || ^11.5.55" }, "type": "library", "autoload": { @@ -7943,7 +8052,7 @@ "description": "A set of custom fixers for PHP CS Fixer", "support": { "issues": "https://github.com/kubawerlos/php-cs-fixer-custom-fixers/issues", - "source": "https://github.com/kubawerlos/php-cs-fixer-custom-fixers/tree/v3.36.1" + "source": "https://github.com/kubawerlos/php-cs-fixer-custom-fixers/tree/v3.37.2" }, "funding": [ { @@ -7951,7 +8060,7 @@ "type": "github" } ], - "time": "2026-03-07T11:35:13+00:00" + "time": "2026-05-12T16:22:19+00:00" }, { "name": "league/container", @@ -8148,16 +8257,16 @@ }, { "name": "nextcloud/coding-standard", - "version": "v1.4.0", + "version": "v1.5.0", "source": { "type": "git", "url": "https://github.com/nextcloud/coding-standard.git", - "reference": "8e06808c1423e9208d63d1bd205b9a38bd400011" + "reference": "80547a93236fbb9c783e05f0f0899043851b0dba" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/nextcloud/coding-standard/zipball/8e06808c1423e9208d63d1bd205b9a38bd400011", - "reference": "8e06808c1423e9208d63d1bd205b9a38bd400011", + "url": "https://api.github.com/repos/nextcloud/coding-standard/zipball/80547a93236fbb9c783e05f0f0899043851b0dba", + "reference": "80547a93236fbb9c783e05f0f0899043851b0dba", "shasum": "" }, "require": { @@ -8187,9 +8296,9 @@ ], "support": { "issues": "https://github.com/nextcloud/coding-standard/issues", - "source": "https://github.com/nextcloud/coding-standard/tree/v1.4.0" + "source": "https://github.com/nextcloud/coding-standard/tree/v1.5.0" }, - "time": "2025-06-19T12:27:27+00:00" + "time": "2026-05-19T18:30:09+00:00" }, { "name": "nextcloud/ocp", @@ -8643,16 +8752,16 @@ }, { "name": "php-cs-fixer/shim", - "version": "v3.94.2", + "version": "v3.95.2", "source": { "type": "git", "url": "https://github.com/PHP-CS-Fixer/shim.git", - "reference": "80fd29f44a736136a2f05bae5464816a444b91d1" + "reference": "319bd80c8db64ab5f7b79a19178299045bdb9957" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/PHP-CS-Fixer/shim/zipball/80fd29f44a736136a2f05bae5464816a444b91d1", - "reference": "80fd29f44a736136a2f05bae5464816a444b91d1", + "url": "https://api.github.com/repos/PHP-CS-Fixer/shim/zipball/319bd80c8db64ab5f7b79a19178299045bdb9957", + "reference": "319bd80c8db64ab5f7b79a19178299045bdb9957", "shasum": "" }, "require": { @@ -8689,9 +8798,9 @@ "description": "A tool to automatically fix PHP code style", "support": { "issues": "https://github.com/PHP-CS-Fixer/shim/issues", - "source": "https://github.com/PHP-CS-Fixer/shim/tree/v3.94.2" + "source": "https://github.com/PHP-CS-Fixer/shim/tree/v3.95.2" }, - "time": "2026-02-20T16:14:17+00:00" + "time": "2026-05-15T09:21:09+00:00" }, { "name": "phpcsstandards/phpcsextra", @@ -8923,16 +9032,16 @@ }, { "name": "phpdocumentor/reflection-docblock", - "version": "5.6.6", + "version": "5.6.7", "source": { "type": "git", "url": "https://github.com/phpDocumentor/ReflectionDocBlock.git", - "reference": "5cee1d3dfc2d2aa6599834520911d246f656bcb8" + "reference": "31a105931bc8ffa3a123383829772e832fd8d903" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/phpDocumentor/ReflectionDocBlock/zipball/5cee1d3dfc2d2aa6599834520911d246f656bcb8", - "reference": "5cee1d3dfc2d2aa6599834520911d246f656bcb8", + "url": "https://api.github.com/repos/phpDocumentor/ReflectionDocBlock/zipball/31a105931bc8ffa3a123383829772e832fd8d903", + "reference": "31a105931bc8ffa3a123383829772e832fd8d903", "shasum": "" }, "require": { @@ -8981,9 +9090,9 @@ "description": "With this component, a library can provide support for annotations via DocBlocks or otherwise retrieve information that is embedded in a DocBlock.", "support": { "issues": "https://github.com/phpDocumentor/ReflectionDocBlock/issues", - "source": "https://github.com/phpDocumentor/ReflectionDocBlock/tree/5.6.6" + "source": "https://github.com/phpDocumentor/ReflectionDocBlock/tree/5.6.7" }, - "time": "2025-12-22T21:13:58+00:00" + "time": "2026-03-18T20:47:46+00:00" }, { "name": "phpdocumentor/type-resolver", @@ -9784,18 +9893,18 @@ "source": { "type": "git", "url": "https://github.com/Roave/SecurityAdvisories.git", - "reference": "9d2f66a6887edf398a0521016e9daded99937763" + "reference": "89aea44a53fbe571a89140af23654bd1c4d85bf6" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/Roave/SecurityAdvisories/zipball/9d2f66a6887edf398a0521016e9daded99937763", - "reference": "9d2f66a6887edf398a0521016e9daded99937763", + "url": "https://api.github.com/repos/Roave/SecurityAdvisories/zipball/89aea44a53fbe571a89140af23654bd1c4d85bf6", + "reference": "89aea44a53fbe571a89140af23654bd1c4d85bf6", "shasum": "" }, "conflict": { "3f/pygmentize": "<1.2", "adaptcms/adaptcms": "<=1.3", - "admidio/admidio": "<=5.0.6", + "admidio/admidio": "<=5.0.8", "adodb/adodb-php": "<=5.22.9", "aheinze/cockpit": "<2.2", "aimeos/ai-admin-graphql": ">=2022.04.1,<2022.10.10|>=2023.04.1,<2023.10.6|>=2024.04.1,<2024.07.2", @@ -9812,6 +9921,7 @@ "alextselegidis/easyappointments": "<=1.5.2", "alexusmai/laravel-file-manager": "<=3.3.1", "algolia/algoliasearch-magento-2": "<=3.16.1|>=3.17.0.0-beta1,<=3.17.1", + "almirhodzic/nova-toggle-5": "<1.3", "alt-design/alt-redirect": "<1.6.4", "altcha-org/altcha": "<1.3.1", "alterphp/easyadmin-extension-bundle": ">=1.2,<1.2.11|>=1.3,<1.3.1", @@ -9837,28 +9947,30 @@ "athlon1600/php-proxy": "<=5.1", "athlon1600/php-proxy-app": "<=3", "athlon1600/youtube-downloader": "<=4", + "aureuserp/aureuserp": "<1.3.0.0-beta1", "austintoddj/canvas": "<=3.4.2", - "auth0/auth0-php": ">=3.3,<8.18", - "auth0/login": "<7.20", - "auth0/symfony": "<=5.5", - "auth0/wordpress": "<=5.4", + "auth0/auth0-php": ">=3.3,<=8.18", + "auth0/login": "<=7.20", + "auth0/symfony": "<=5.7", + "auth0/wordpress": "<=5.5", "automad/automad": "<2.0.0.0-alpha5", "automattic/jetpack": "<9.8", "awesome-support/awesome-support": "<=6.0.7", - "aws/aws-sdk-php": "<3.368", - "azuracast/azuracast": "<=0.23.3", + "aws/aws-sdk-php": "<=3.371.3", + "ayacoo/redirect-tab": "<2.1.2|>=3,<3.1.7|>=4,<4.0.5", + "azuracast/azuracast": "<=0.23.5", "b13/seo_basics": "<0.8.2", "backdrop/backdrop": "<=1.32", "backpack/crud": "<3.4.9", "backpack/filemanager": "<2.0.2|>=3,<3.0.9", "bacula-web/bacula-web": "<9.7.1", "badaso/core": "<=2.9.11", - "bagisto/bagisto": "<2.3.10", + "bagisto/bagisto": "<=2.3.15", "barrelstrength/sprout-base-email": "<1.2.7", "barrelstrength/sprout-forms": "<3.9", "barryvdh/laravel-translation-manager": "<0.6.8", "barzahlen/barzahlen-php": "<2.0.1", - "baserproject/basercms": "<=5.1.1", + "baserproject/basercms": "<=5.2.2", "bassjobsen/bootstrap-3-typeahead": ">4.0.2", "bbpress/bbpress": "<2.6.5", "bcit-ci/codeigniter": "<3.1.3", @@ -9901,13 +10013,13 @@ "cesnet/simplesamlphp-module-proxystatistics": "<3.1", "chriskacerguis/codeigniter-restserver": "<=2.7.1", "chrome-php/chrome": "<1.14", - "ci4-cms-erp/ci4ms": "<0.28.5", + "ci4-cms-erp/ci4ms": "<=0.31.8", "civicrm/civicrm-core": ">=4.2,<4.2.9|>=4.3,<4.3.3", "ckeditor/ckeditor": "<4.25", "clickstorm/cs-seo": ">=6,<6.8|>=7,<7.5|>=8,<8.4|>=9,<9.3", "co-stack/fal_sftp": "<0.2.6", - "cockpit-hq/cockpit": "<2.11.4", - "code16/sharp": "<9.11.1", + "cockpit-hq/cockpit": "<=2.14", + "code16/sharp": "<9.22", "codeception/codeception": "<3.1.3|>=4,<4.1.22", "codeigniter/framework": "<3.1.10", "codeigniter4/framework": "<4.6.2", @@ -9917,7 +10029,7 @@ "codingms/modules": "<4.3.11|>=5,<5.7.4|>=6,<6.4.2|>=7,<7.5.5", "commerceteam/commerce": ">=0.9.6,<0.9.9", "components/jquery": ">=1.0.3,<3.5", - "composer/composer": "<1.10.27|>=2,<2.2.26|>=2.3,<2.9.3", + "composer/composer": "<2.2.28|>=2.3,<2.9.8", "concrete5/concrete5": "<9.4.8", "concrete5/core": "<8.5.8|>=9,<9.1", "contao-components/mediaelement": ">=2.14.2,<2.21.1", @@ -9927,14 +10039,14 @@ "contao/core-bundle": "<4.13.57|>=5,<5.3.42|>=5.4,<5.6.5", "contao/listing-bundle": ">=3,<=3.5.30|>=4,<4.4.8", "contao/managed-edition": "<=1.5", - "coreshop/core-shop": "<4.1.9", + "coreshop/core-shop": "<4.1.9|==5", "corveda/phpsandbox": "<1.3.5", "cosenary/instagram": "<=2.3", "couleurcitron/tarteaucitron-wp": "<0.3", - "cpsit/typo3-mailqueue": "<0.4.3|>=0.5,<0.5.1", + "cpsit/typo3-mailqueue": "<0.4.5|>=0.5,<0.5.2", "craftcms/aws-s3": ">=2.0.2,<=2.2.4", "craftcms/azure-blob": ">=2.0.0.0-beta1,<=2.1", - "craftcms/cms": "<=4.17.5|>=5,<=5.9.11", + "craftcms/cms": "<4.17.12|>=5,<5.9.18", "craftcms/commerce": ">=4,<4.11|>=5,<5.6", "craftcms/composer": ">=4.0.0.0-RC1-dev,<=4.10|>=5.0.0.0-RC1-dev,<=5.5.1", "craftcms/craft": ">=3.5,<=4.16.17|>=5.0.0.0-RC1-dev,<=5.8.21", @@ -9953,11 +10065,12 @@ "david-garcia/phpwhois": "<=4.3.1", "dbrisinajumi/d2files": "<1", "dcat/laravel-admin": "<=2.1.3|==2.2.0.0-beta|==2.2.2.0-beta", + "dedoc/scramble": ">=0.13.2,<0.13.22", "derhansen/fe_change_pwd": "<2.0.5|>=3,<3.0.3", "derhansen/sf_event_mgt": "<4.3.1|>=5,<5.1.1|>=7,<7.4", "desperado/xml-bundle": "<=0.1.7", "dev-lancer/minecraft-motd-parser": "<=1.0.5", - "devcode-it/openstamanager": "<=2.9.8", + "devcode-it/openstamanager": "<=2.10.1", "devgroup/dotplant": "<2020.09.14-dev", "digimix/wp-svg-upload": "<=1", "directmailteam/direct-mail": "<6.0.3|>=7,<7.0.3|>=8,<9.5.2", @@ -9974,9 +10087,10 @@ "doctrine/mongodb-odm": "<1.0.2", "doctrine/mongodb-odm-bundle": "<3.0.1", "doctrine/orm": ">=1,<1.2.4|>=2,<2.4.8|>=2.5,<2.5.1|>=2.8.3,<2.8.4", - "dolibarr/dolibarr": "<21.0.3", + "dolibarr/dolibarr": "<=23.0.2", "dompdf/dompdf": "<2.0.4", "doublethreedigital/guest-entries": "<3.1.2", + "dreamfactory/df-core": "<1.0.4", "drupal-pattern-lab/unified-twig-extensions": "<=0.1", "drupal/access_code": "<2.0.5", "drupal/acquia_dam": "<1.1.5", @@ -10052,7 +10166,7 @@ "ezsystems/repository-forms": ">=2.3,<2.3.2.1-dev|>=2.5,<2.5.15", "ezyang/htmlpurifier": "<=4.2", "facade/ignition": "<1.16.15|>=2,<2.4.2|>=2.5,<2.5.2", - "facturascripts/facturascripts": "<2025.81", + "facturascripts/facturascripts": "<=2025.92|>=2026,<=2026.1", "fastly/magento2": "<1.2.26", "feehi/cms": "<=2.1.1", "feehi/feehicms": "<=2.1.1", @@ -10060,7 +10174,7 @@ "filament/actions": ">=3.2,<3.2.123", "filament/filament": ">=4,<4.3.1", "filament/infolists": ">=3,<3.2.115", - "filament/tables": ">=3,<3.2.115", + "filament/tables": ">=3,<3.2.115|>=4,<4.8.5|>=5,<5.3.5", "filegator/filegator": "<7.8", "filp/whoops": "<2.1.13", "fineuploader/php-traditional-server": "<=1.2.2", @@ -10068,13 +10182,14 @@ "fisharebest/webtrees": "<=2.1.18", "fixpunkt/fp-masterquiz": "<2.2.1|>=3,<3.5.2", "fixpunkt/fp-newsletter": "<1.1.1|>=1.2,<2.1.2|>=2.2,<3.2.6", - "flarum/core": "<1.8.10", + "flarum/core": "<=1.8.15|>=2.0.0.0-beta1,<=2.0.0.0-beta8", "flarum/flarum": "<0.1.0.0-beta8", "flarum/framework": "<1.8.10", "flarum/mentions": "<1.6.3", "flarum/nicknames": "<1.8.3", "flarum/sticky": ">=0.1.0.0-beta14,<=0.1.0.0-beta15", "flarum/tags": "<=0.1.0.0-beta13", + "flightphp/core": "<3.18.1", "floriangaerber/magnesium": "<0.3.1", "fluidtypo3/vhs": "<5.1.1", "fof/byobu": ">=0.3.0.0-beta2,<1.1.7", @@ -10095,17 +10210,19 @@ "friendsoftypo3/openid": ">=4.5,<4.5.31|>=4.7,<4.7.16|>=6,<6.0.11|>=6.1,<6.1.6", "froala/wysiwyg-editor": "<=4.3", "frosh/adminer-platform": "<2.2.1", - "froxlor/froxlor": "<=2.3.3", + "froxlor/froxlor": "<2.3.6", "frozennode/administrator": "<=5.0.12", "fuel/core": "<1.8.1", - "funadmin/funadmin": "<=7.1.0.0-RC4", + "funadmin/funadmin": "<=7.1.0.0-RC6", "gaoming13/wechat-php-sdk": "<=1.10.2", "genix/cms": "<=1.1.11", - "georgringer/news": "<1.3.3", + "georgringer/news": "<11.4.4|>=12,<12.3.2|>=13,<13.0.2|>=14,<14.0.3", "geshi/geshi": "<=1.0.9.1", "getformwork/formwork": "<=2.3.3", - "getgrav/grav": "<1.11.0.0-beta1", - "getkirby/cms": "<3.9.8.3-dev|>=3.10,<3.10.1.2-dev|>=4,<4.7.1|>=5,<=5.2.1", + "getgrav/grav": "<=2.0.0.0-RC1", + "getgrav/grav-plugin-api": "<1.0.0.0-beta15", + "getgrav/grav-plugin-form": "<9.1", + "getkirby/cms": "<4.9|>=5,<5.4", "getkirby/kirby": "<3.9.8.3-dev|>=3.10,<3.10.1.2-dev|>=4,<4.7.1", "getkirby/panel": "<2.5.14", "getkirby/starterkit": "<=3.7.0.2", @@ -10114,7 +10231,8 @@ "globalpayments/php-sdk": "<2", "goalgorilla/open_social": "<12.3.11|>=12.4,<12.4.10|>=13.0.0.0-alpha1,<13.0.0.0-alpha11", "gogentooss/samlbase": "<1.2.7", - "google/protobuf": "<3.4", + "goodoneuz/pay-uz": "<=2.2.24", + "google/protobuf": "<4.33.6", "gos/web-socket-bundle": "<1.10.4|>=2,<2.6.1|>=3,<3.3", "gp247/core": "<1.1.24", "gree/jose": "<2.2.1", @@ -10134,6 +10252,7 @@ "hjue/justwriting": "<=1", "hov/jobfair": "<1.0.13|>=2,<2.0.2", "httpsoft/http-message": "<1.0.12", + "hybridauth/hybridauth": "<=3.12.2", "hyn/multi-tenant": ">=5.6,<5.7.2", "ibexa/admin-ui": ">=4.2,<4.2.3|>=4.6,<4.6.25|>=5,<5.0.3", "ibexa/admin-ui-assets": ">=4.6.0.0-alpha1,<4.6.21", @@ -10162,10 +10281,13 @@ "innologi/typo3-appointments": "<2.0.6", "intelliants/subrion": "<4.2.2", "inter-mediator/inter-mediator": "==5.5", - "ipl/web": "<0.10.1", + "intercom/intercom-php": "==5.0.2", + "invoiceninja/invoiceninja": "<5.13.4", + "ipl/web": "<=0.13", "islandora/crayfish": "<4.1", "islandora/islandora": ">=2,<2.4.1", "ivankristianto/phpwhois": "<=4.3", + "j0k3r/graby": "<=2.5", "jackalope/jackalope-doctrine-dbal": "<1.7.4", "jambagecom/div2007": "<0.10.2", "james-heinrich/getid3": "<1.9.21", @@ -10173,7 +10295,9 @@ "jasig/phpcas": "<1.3.3", "jbartels/wec-map": "<3.0.3", "jcbrand/converse.js": "<3.3.3", + "joedolson/my-calendar": "<3.7.7", "joelbutcher/socialstream": "<5.6|>=6,<6.2", + "johnbillion/query-monitor": "<3.20.4", "johnbillion/wp-crontrol": "<1.16.2|>=1.17,<1.19.2", "joomla/application": "<1.0.13", "joomla/archive": "<1.1.12|>=2,<2.0.1", @@ -10191,20 +10315,23 @@ "juzaweb/cms": "<=3.4.2", "jweiland/events2": "<8.3.8|>=9,<9.0.6", "jweiland/kk-downloader": "<1.2.2", + "kantorge/yaffa": "<=2", "kazist/phpwhois": "<=4.2.6", + "kelvinmo/simplejwt": "<=1.1", "kelvinmo/simplexrd": "<3.1.1", "kevinpapst/kimai2": "<1.16.7", - "khodakhah/nodcms": "<=3", - "kimai/kimai": "<=2.50", + "khodakhah/nodcms": "<=3.4.1", + "kimai/kimai": "<=2.55", "kitodo/presentation": "<3.2.3|>=3.3,<3.3.4", "klaviyo/magento2-extension": ">=1,<3", - "knplabs/knp-snappy": "<=1.4.2", + "knplabs/knp-snappy": "<=1.7", "kohana/core": "<3.3.3", "koillection/koillection": "<1.6.12", - "krayin/laravel-crm": "<=1.3", + "krayin/laravel-crm": "<=2.2", "kreait/firebase-php": ">=3.2,<3.8.1", "kumbiaphp/kumbiapp": "<=1.1.1", "la-haute-societe/tcpdf": "<6.2.22", + "laktak/hjson": "<2.3", "laminas/laminas-diactoros": "<2.18.1|==2.19|==2.20|==2.21|==2.22|==2.23|>=2.24,<2.24.2|>=2.25,<2.25.2", "laminas/laminas-form": "<2.17.1|>=3,<3.0.2|>=3.1,<3.1.1", "laminas/laminas-http": "<2.14.2", @@ -10213,6 +10340,7 @@ "laravel/fortify": "<1.11.1", "laravel/framework": "<10.48.29|>=11,<11.44.1|>=12,<12.1.1", "laravel/laravel": ">=5.4,<5.4.22", + "laravel/passport": ">=13,<13.7.1", "laravel/pulse": "<1.3.1", "laravel/reverb": "<1.7", "laravel/socialite": ">=1,<2.0.10", @@ -10220,13 +10348,13 @@ "lavalite/cms": "<=10.1", "lavitto/typo3-form-to-database": "<2.2.5|>=3,<3.2.2|>=4,<4.2.3|>=5,<5.0.2", "lcobucci/jwt": ">=3.4,<3.4.6|>=4,<4.0.4|>=4.1,<4.1.5", - "league/commonmark": "<=2.8", + "league/commonmark": "<=2.8.1", "league/flysystem": "<1.1.4|>=2,<2.1.1", "league/oauth2-server": ">=8.3.2,<8.4.2|>=8.5,<8.5.3", "leantime/leantime": "<3.3", "lexik/jwt-authentication-bundle": "<2.10.7|>=2.11,<2.11.3", "libreform/libreform": ">=2,<=2.0.8", - "librenms/librenms": "<26.2", + "librenms/librenms": "<26.3", "liftkit/database": "<2.13.2", "lightsaml/lightsaml": "<1.3.5", "limesurvey/limesurvey": "<6.15.4", @@ -10252,8 +10380,9 @@ "maikuolan/phpmussel": ">=1,<1.6", "mainwp/mainwp": "<=4.4.3.3", "manogi/nova-tiptap": "<=3.2.6", - "mantisbt/mantisbt": "<2.27.2", + "mantisbt/mantisbt": "<2.28.2", "marcwillmann/turn": "<0.3.3", + "markhuot/craftql": "<=1.3.7", "marshmallow/nova-tiptap": "<5.7", "matomo/matomo": "<1.11", "matyhtf/framework": "<3.0.6", @@ -10261,6 +10390,7 @@ "mautic/core-lib": ">=1.0.0.0-beta,<4.4.13|>=5.0.0.0-alpha,<5.1.1", "mautic/grapes-js-builder-bundle": ">=4,<4.4.18|>=5,<5.2.9|>=6,<6.0.7", "maximebf/debugbar": "<1.19", + "mckenziearts/livewire-markdown-editor": "<1.3", "mdanter/ecc": "<2", "mediawiki/abuse-filter": "<1.39.9|>=1.40,<1.41.3|>=1.42,<1.42.2", "mediawiki/cargo": "<3.8.3", @@ -10283,7 +10413,9 @@ "mikehaertl/php-shellcommand": "<1.6.1", "mineadmin/mineadmin": "<=3.0.9", "miniorange/miniorange-saml": "<1.4.3", + "miraheze/ts-portal": "<=33", "mittwald/typo3_forum": "<1.2.1", + "mix/mix": ">=2,<=2.2.17", "mobiledetect/mobiledetectlib": "<2.8.32", "modx/revolution": "<=3.1", "mojo42/jirafeau": "<4.4", @@ -10303,6 +10435,7 @@ "munkireport/softwareupdate": "<1.6", "mustache/mustache": ">=2,<2.14.1", "mwdelaney/wp-enable-svg": "<=0.2", + "nabeel/phpvms": "<7.0.6", "namshi/jose": "<2.2", "nasirkhan/laravel-starter": "<11.11", "nategood/httpful": "<1", @@ -10333,9 +10466,9 @@ "nzo/url-encryptor-bundle": ">=4,<4.3.2|>=5,<5.0.1", "october/backend": "<1.1.2", "october/cms": "<1.0.469|==1.0.469|==1.0.471|==1.1.1", - "october/october": "<3.7.5", - "october/rain": "<1.0.472|>=1.1,<1.1.2", - "october/system": "<=3.7.12|>=4,<=4.0.11", + "october/october": "<3.7.14|>=4,<4.1.10", + "october/rain": "<=3.7.13|>=4,<=4.1.9", + "october/system": "<3.7.16|>=4,<4.1.16", "oliverklee/phpunit": "<3.5.15", "omeka/omeka-s": "<4.0.3", "onelogin/php-saml": "<2.21.1|>=3,<3.8.1|>=4,<4.3.1", @@ -10343,9 +10476,9 @@ "open-web-analytics/open-web-analytics": "<1.8.1", "opencart/opencart": ">=0", "openid/php-openid": "<2.3", - "openmage/magento-lts": "<20.16.1", + "openmage/magento-lts": "<=20.17", "opensolutions/vimbadmin": "<=3.0.15", - "opensource-workshop/connect-cms": "<1.8.7|>=2,<2.4.7", + "opensource-workshop/connect-cms": "<1.41.1|>=2,<2.41.1", "orchid/platform": ">=8,<14.43", "oro/calendar-bundle": ">=4.2,<=4.2.6|>=5,<=5.0.6|>=5.1,<5.1.1", "oro/commerce": ">=4.1,<5.0.11|>=5.1,<5.1.1", @@ -10386,16 +10519,16 @@ "phpmailer/phpmailer": "<6.5", "phpmussel/phpmussel": ">=1,<1.6", "phpmyadmin/phpmyadmin": "<5.2.2", - "phpmyfaq/phpmyfaq": "<=4.0.16", + "phpmyfaq/phpmyfaq": "<4.1.3", "phpoffice/common": "<0.2.9", "phpoffice/math": "<=0.2", "phpoffice/phpexcel": "<=1.8.2", - "phpoffice/phpspreadsheet": "<1.30|>=2,<2.1.12|>=2.2,<2.4|>=3,<3.10|>=4,<5", + "phpoffice/phpspreadsheet": "<=1.30.3|>=2,<=2.1.15|>=2.2,<=2.4.4|>=3,<=3.10.4|>=4,<=5.6", "phppgadmin/phppgadmin": "<=7.13", - "phpseclib/phpseclib": "<2.0.47|>=3,<3.0.36", + "phpseclib/phpseclib": "<=2.0.53|>=3,<=3.0.51", "phpservermon/phpservermon": "<3.6", "phpsysinfo/phpsysinfo": "<3.4.3", - "phpunit/phpunit": "<8.5.52|>=9,<9.6.33|>=10,<10.5.62|>=11,<11.5.50|>=12,<12.5.8", + "phpunit/phpunit": "<8.5.52|>=9,<9.6.33|>=10,<10.5.62|>=11,<11.5.50|>=12,<12.5.8|>=12.5.21,<12.5.22|>=13.1.5,<13.1.6", "phpwhois/phpwhois": "<=4.2.5", "phpxmlrpc/extras": "<0.6.1", "phpxmlrpc/phpxmlrpc": "<4.9.2", @@ -10408,13 +10541,13 @@ "pimcore/demo": "<10.3", "pimcore/ecommerce-framework-bundle": "<1.0.10", "pimcore/perspective-editor": "<1.5.1", - "pimcore/pimcore": "<=11.5.14.1|>=12,<12.3.3", + "pimcore/pimcore": "<=11.5.14.1|>=12,<12.3.3|==12.3.3", "pimcore/web2print-tools-bundle": "<=5.2.1|>=6.0.0.0-RC1-dev,<=6.1", "piwik/piwik": "<1.11", "pixelfed/pixelfed": "<0.12.5", "plotly/plotly.js": "<2.25.2", "pocketmine/bedrock-protocol": "<8.0.2", - "pocketmine/pocketmine-mp": "<5.32.1", + "pocketmine/pocketmine-mp": "<5.42.1", "pocketmine/raklib": ">=0.14,<0.14.6|>=0.15,<0.15.1", "pressbooks/pressbooks": "<5.18", "prestashop/autoupgrade": ">=4,<4.10.1", @@ -10422,15 +10555,15 @@ "prestashop/blockwishlist": ">=2,<2.1.1", "prestashop/contactform": ">=1.0.1,<4.3", "prestashop/gamification": "<2.3.2", - "prestashop/prestashop": "<8.2.4|>=9.0.0.0-alpha1,<9.0.3", + "prestashop/prestashop": "<8.2.6|>=9,<9.1.1", "prestashop/productcomments": "<5.0.2", - "prestashop/ps_checkout": "<4.4.1|>=5,<5.0.5", + "prestashop/ps_checkout": "<5.3", "prestashop/ps_contactinfo": "<=3.3.2", "prestashop/ps_emailsubscription": "<2.6.1", "prestashop/ps_facetedsearch": "<3.4.1", "prestashop/ps_linklist": "<3.1", "privatebin/privatebin": "<1.4|>=1.5,<1.7.4|>=1.7.7,<2.0.3", - "processwire/processwire": "<=3.0.246", + "processwire/processwire": "<=3.0.255", "propel/propel": ">=2.0.0.0-alpha1,<=2.0.0.0-alpha7", "propel/propel1": ">=1,<=1.7.1", "psy/psysh": "<=0.11.22|>=0.12,<=0.12.18", @@ -10440,6 +10573,7 @@ "pubnub/pubnub": "<6.1", "punktde/pt_extbase": "<1.5.1", "pusher/pusher-php-server": "<2.2.1", + "putyourlightson/craft-sprig": ">=2,<2.15.2|>=3,<3.7.2", "pwweb/laravel-core": "<=0.3.6.0-beta", "pxlrbt/filament-excel": "<1.1.14|>=2.0.0.0-alpha,<2.3.3", "pyrocms/pyrocms": "<=3.9.1", @@ -10448,43 +10582,50 @@ "rainlab/blog-plugin": "<1.4.1", "rainlab/debugbar-plugin": "<3.1", "rainlab/user-plugin": "<=1.4.5", + "ralffreit/mfa-email": "<1.0.7|==2", "rankmath/seo-by-rank-math": "<=1.0.95", "rap2hpoutre/laravel-log-viewer": "<0.13", "react/http": ">=0.7,<1.9", "really-simple-plugins/complianz-gdpr": "<6.4.2", - "redaxo/source": "<=5.20.1", + "redaxo/source": "<5.21", "remdex/livehelperchat": "<4.29", "renolit/reint-downloadmanager": "<4.0.2|>=5,<5.0.1", "reportico-web/reportico": "<=8.1", - "rhukster/dom-sanitizer": "<1.0.7", + "rhukster/dom-sanitizer": "<1.0.10", "rmccue/requests": ">=1.6,<1.8", + "roadiz/documents": "<2.3.42|>=2.4,<2.5.44|>=2.6,<2.6.28|>=2.7,<2.7.9", + "roadiz/openid": "<2.3.43|>=2.5,<2.5.45|>=2.6,<2.6.31|>=2.7,<2.7.18", "robrichards/xmlseclibs": "<3.1.5", "roots/soil": "<4.1", - "roundcube/roundcubemail": "<1.5.10|>=1.6,<1.6.11", + "roundcube/roundcubemail": "<1.5.10|>=1.6,<1.6.11|>=1.7.0.0-beta,<1.7.0.0-RC5-dev", "rudloff/alltube": "<3.0.3", "rudloff/rtmpdump-bin": "<=2.3.1", "s-cart/core": "<=9.0.5", "s-cart/s-cart": "<6.9", + "s9y/serendipity": "<2.6", "sabberworm/php-css-parser": ">=1,<1.0.1|>=2,<2.0.1|>=3,<3.0.1|>=4,<4.0.1|>=5,<5.0.9|>=5.1,<5.1.3|>=5.2,<5.2.1|>=6,<6.0.2|>=7,<7.0.4|>=8,<8.0.1|>=8.1,<8.1.1|>=8.2,<8.2.1|>=8.3,<8.3.1", "sabre/dav": ">=1.6,<1.7.11|>=1.8,<1.8.9", + "saloonphp/saloon": "<4", "samwilson/unlinked-wikibase": "<1.42", "scheb/two-factor-bundle": "<3.26|>=4,<4.11", "sensiolabs/connect": "<4.2.3", "serluck/phpwhois": "<=4.2.6", - "setasign/fpdi": "<2.6.4", + "setasign/fpdi": "<2.6.7", "sfroemken/url_redirect": "<=1.2.1", "sheng/yiicms": "<1.2.1", + "shopper/cart": "<2.8", + "shopper/framework": "<2.8", "shopware/core": "<6.6.10.15-dev|>=6.7,<6.7.8.1-dev", "shopware/platform": "<6.6.10.15-dev|>=6.7,<6.7.8.1-dev", "shopware/production": "<=6.3.5.2", "shopware/shopware": "<=5.7.17|>=6.4.6,<6.6.10.10-dev|>=6.7,<6.7.6.1-dev", "shopware/storefront": "<6.6.10.10-dev|>=6.7,<6.7.5.1-dev", "shopxo/shopxo": "<=6.4", - "showdoc/showdoc": "<2.10.4", + "showdoc/showdoc": "<3.8.1", "shuchkin/simplexlsx": ">=1.0.12,<1.1.13", "silverstripe-australia/advancedreports": ">=1,<=2", "silverstripe/admin": "<1.13.19|>=2,<2.1.8", - "silverstripe/assets": ">=1,<1.11.1", + "silverstripe/assets": "<2.4.5|>=3,<3.1.3", "silverstripe/cms": "<4.11.3", "silverstripe/comments": ">=1.3,<3.1.1", "silverstripe/forum": "<=0.6.1|>=0.7,<=0.7.3", @@ -10505,6 +10646,7 @@ "simplesamlphp/saml2": "<=4.16.15|>=5.0.0.0-alpha1,<=5.0.0.0-alpha19", "simplesamlphp/saml2-legacy": "<=4.16.15", "simplesamlphp/simplesamlphp": "<1.18.6", + "simplesamlphp/simplesamlphp-module-casserver": "<=7.0.2", "simplesamlphp/simplesamlphp-module-infocard": "<1.0.1", "simplesamlphp/simplesamlphp-module-openid": "<1", "simplesamlphp/simplesamlphp-module-openidprovider": "<0.9", @@ -10519,7 +10661,7 @@ "slim/slim": "<2.6", "slub/slub-events": "<3.0.3", "smarty/smarty": "<4.5.3|>=5,<5.1.1", - "snipe/snipe-it": "<8.3.7", + "snipe/snipe-it": "<8.4.1", "socalnick/scn-social-auth": "<1.15.2", "socialiteproviders/steam": "<1.1", "solspace/craft-freeform": "<4.1.29|>=5,<=5.14.6", @@ -10537,14 +10679,14 @@ "starcitizentools/short-description": ">=4,<4.0.1", "starcitizentools/tabber-neue": ">=1.9.1,<2.7.2|>=3,<3.1.1", "starcitizenwiki/embedvideo": "<=4", - "statamic/cms": "<5.73.11|>=6,<6.6.2", + "statamic/cms": "<5.73.22|>=6,<6.18.1", "stormpath/sdk": "<9.9.99", - "studio-42/elfinder": "<=2.1.64", + "studio-42/elfinder": "<=2.1.67", "studiomitte/friendlycaptcha": "<0.1.4", "subhh/libconnect": "<7.0.8|>=8,<8.1", "sukohi/surpass": "<1", "sulu/form-bundle": ">=2,<2.5.3", - "sulu/sulu": "<1.6.44|>=2,<2.5.25|>=2.6,<2.6.9|>=3.0.0.0-alpha1,<3.0.0.0-alpha3", + "sulu/sulu": "<=2.6.22|>=3,<=3.0.5", "sumocoders/framework-user-bundle": "<1.4", "superbig/craft-audit": "<3.0.2", "svewap/a21glossary": "<=0.4.10", @@ -10562,42 +10704,51 @@ "symbiote/silverstripe-seed": "<6.0.3", "symbiote/silverstripe-versionedfiles": "<=2.0.3", "symfont/process": ">=0", - "symfony/cache": ">=3.1,<3.4.35|>=4,<4.2.12|>=4.3,<4.3.8", + "symfony/cache": ">=2,<5.4.52|>=6,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", "symfony/dependency-injection": ">=2,<2.0.17|>=2.7,<2.7.51|>=2.8,<2.8.50|>=3,<3.4.26|>=4,<4.1.12|>=4.2,<4.2.7", + "symfony/dom-crawler": ">=2,<5.4.52|>=6,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", "symfony/error-handler": ">=4.4,<4.4.4|>=5,<5.0.4", "symfony/form": ">=2.3,<2.3.35|>=2.4,<2.6.12|>=2.7,<2.7.50|>=2.8,<2.8.49|>=3,<3.4.20|>=4,<4.0.15|>=4.1,<4.1.9|>=4.2,<4.2.1", "symfony/framework-bundle": ">=2,<2.3.18|>=2.4,<2.4.8|>=2.5,<2.5.2|>=2.7,<2.7.51|>=2.8,<2.8.50|>=3,<3.4.26|>=4,<4.1.12|>=4.2,<4.2.7|>=5.3.14,<5.3.15|>=5.4.3,<5.4.4|>=6.0.3,<6.0.4", + "symfony/html-sanitizer": ">=6.1,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", "symfony/http-client": ">=4.3,<5.4.47|>=6,<6.4.15|>=7,<7.1.8", "symfony/http-foundation": "<5.4.50|>=6,<6.4.29|>=7,<7.3.7", - "symfony/http-kernel": ">=2,<4.4.50|>=5,<5.4.20|>=6,<6.0.20|>=6.1,<6.1.12|>=6.2,<6.2.6", + "symfony/http-kernel": ">=2,<4.4.50|>=5,<5.4.20|>=6,<6.0.20|>=6.1,<6.1.12|>=6.2,<6.2.6|>=7.4,<7.4.12|>=8,<8.0.12", "symfony/intl": ">=2.7,<2.7.38|>=2.8,<2.8.31|>=3,<3.2.14|>=3.3,<3.3.13", + "symfony/json-path": ">=7.3,<7.4.12|>=8,<8.0.12", + "symfony/lox24-notifier": ">=7.1,<7.4.12|>=8,<8.0.12", + "symfony/mailer": ">=2,<5.4.52|>=6,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", + "symfony/mailjet-mailer": ">=6.4,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", + "symfony/mailtrap-mailer": ">=7.2,<7.4.12|>=8,<8.0.12", "symfony/maker-bundle": ">=1.27,<1.29.2|>=1.30,<1.31.1", - "symfony/mime": ">=4.3,<4.3.8", + "symfony/mime": ">=2,<5.4.52|>=6,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", + "symfony/monolog-bridge": ">=2,<5.4.52|>=6,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", "symfony/phpunit-bridge": ">=2.8,<2.8.50|>=3,<3.4.26|>=4,<4.1.12|>=4.2,<4.2.7", "symfony/polyfill": ">=1,<1.10", "symfony/polyfill-php55": ">=1,<1.10", "symfony/process": "<5.4.51|>=6,<6.4.33|>=7,<7.1.7|>=7.3,<7.3.11|>=7.4,<7.4.5|>=8,<8.0.5", "symfony/proxy-manager-bridge": ">=2.7,<2.7.51|>=2.8,<2.8.50|>=3,<3.4.26|>=4,<4.1.12|>=4.2,<4.2.7", - "symfony/routing": ">=2,<2.0.19", - "symfony/runtime": ">=5.3,<5.4.46|>=6,<6.4.14|>=7,<7.1.7", + "symfony/routing": ">=2,<5.4.52|>=6,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", + "symfony/runtime": ">=5.3,<5.4.52|>=6,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", "symfony/security": ">=2,<2.7.51|>=2.8,<3.4.49|>=4,<4.4.24|>=5,<5.2.8", "symfony/security-bundle": ">=2,<4.4.50|>=5,<5.4.20|>=6,<6.0.20|>=6.1,<6.1.12|>=6.2,<6.4.10|>=7,<7.0.10|>=7.1,<7.1.3", "symfony/security-core": ">=2.4,<2.6.13|>=2.7,<2.7.9|>=2.7.30,<2.7.32|>=2.8,<3.4.49|>=4,<4.4.24|>=5,<5.2.9", "symfony/security-csrf": ">=2.4,<2.7.48|>=2.8,<2.8.41|>=3,<3.3.17|>=3.4,<3.4.11|>=4,<4.0.11", "symfony/security-guard": ">=2.8,<3.4.48|>=4,<4.4.23|>=5,<5.2.8", - "symfony/security-http": ">=2.3,<2.3.41|>=2.4,<2.7.51|>=2.8,<2.8.50|>=3,<3.4.26|>=4,<4.2.12|>=4.3,<4.3.8|>=4.4,<4.4.7|>=5,<5.0.7|>=5.1,<5.2.8|>=5.3,<5.4.47|>=6,<6.4.15|>=7,<7.1.8", + "symfony/security-http": ">=2,<5.4.52|>=6,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", "symfony/serializer": ">=2,<2.0.11|>=4.1,<4.4.35|>=5,<5.3.12", - "symfony/symfony": "<5.4.51|>=6,<6.4.33|>=7,<7.3.11|>=7.4,<7.4.5|>=8,<8.0.5", + "symfony/symfony": "<5.4.52|>=6,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", "symfony/translation": ">=2,<2.0.17", - "symfony/twig-bridge": ">=2,<4.4.51|>=5,<5.4.31|>=6,<6.3.8", + "symfony/twig-bridge": ">=2,<4.4.51|>=5,<5.4.31|>=6,<6.3.8|>=6.4.24,<6.4.40", + "symfony/twilio-notifier": ">=6.4,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", "symfony/ux-autocomplete": "<2.11.2", "symfony/ux-live-component": "<2.25.1", "symfony/ux-twig-component": "<2.25.1", "symfony/validator": "<5.4.43|>=6,<6.4.11|>=7,<7.1.4", "symfony/var-exporter": ">=4.2,<4.2.12|>=4.3,<4.3.8", - "symfony/web-profiler-bundle": ">=2,<2.3.19|>=2.4,<2.4.9|>=2.5,<2.5.4", + "symfony/web-profiler-bundle": ">=2,<2.3.19|>=2.4,<2.4.9|>=2.5,<2.5.4|>=7.2.9,<7.4.12|>=8,<8.0.12", "symfony/webhook": ">=6.3,<6.3.8", - "symfony/yaml": ">=2,<2.0.22|>=2.1,<2.1.7|>=2.2.0.0-beta1,<2.2.0.0-beta2", + "symfony/yaml": ">=2,<5.4.52|>=6,<6.4.40|>=7,<7.4.12|>=8,<8.0.12", "symphonycms/symphony-2": "<2.6.4", "t3/dce": "<0.11.5|>=2.2,<2.6.2", "t3g/svg-sanitizer": "<1.0.3", @@ -10611,7 +10762,7 @@ "thelia/thelia": ">=2.1,<2.1.3", "theonedemon/phpwhois": "<=4.2.5", "thinkcmf/thinkcmf": "<6.0.8", - "thorsten/phpmyfaq": "<4.0.18|>=4.1.0.0-alpha,<=4.1.0.0-beta2", + "thorsten/phpmyfaq": "<4.1.3", "tikiwiki/tiki-manager": "<=17.1", "timber/timber": ">=0.16.6,<1.23.1|>=1.24,<1.24.1|>=2,<2.1", "tinymce/tinymce": "<7.2", @@ -10628,10 +10779,13 @@ "truckersmp/phpwhois": "<=4.3.1", "ttskch/pagination-service-provider": "<1", "twbs/bootstrap": "<3.4.1|>=4,<4.3.1", - "twig/twig": "<3.11.2|>=3.12,<3.14.1|>=3.16,<3.19", + "twig/cssinliner-extra": "<3.26", + "twig/intl-extra": "<3.26", + "twig/markdown-extra": "<3.26", + "twig/twig": "<3.26", "typicms/core": "<16.1.7", "typo3/cms": "<9.5.29|>=10,<10.4.35|>=11,<11.5.23|>=12,<12.2", - "typo3/cms-backend": "<4.1.14|>=4.2,<4.2.15|>=4.3,<4.3.7|>=4.4,<4.4.4|>=7,<=7.6.50|>=8,<=8.7.39|>=9,<9.5.55|>=10,<=10.4.54|>=11,<=11.5.48|>=12,<=12.4.40|>=13,<=13.4.22|>=14,<=14.0.1", + "typo3/cms-backend": "<4.1.14|>=4.2,<4.2.15|>=4.3,<4.3.7|>=4.4,<4.4.4|>=7,<=7.6.50|>=8,<=8.7.39|>=9,<9.5.55|>=10,<=10.4.54|>=11,<=11.5.48|>=12,<=12.4.40|>=13,<=13.4.22|>=14,<=14.0.1|==14.2", "typo3/cms-belog": ">=10,<=10.4.47|>=11,<=11.5.41|>=12,<=12.4.24|>=13,<=13.4.2", "typo3/cms-beuser": ">=9,<9.5.55|>=10,<10.4.54|>=11,<11.5.48|>=12,<12.4.37|>=13,<13.4.18", "typo3/cms-core": "<=8.7.56|>=9,<9.5.55|>=10,<=10.4.54|>=11,<=11.5.48|>=12,<=12.4.40|>=13,<=13.4.22|>=14,<=14.0.1", @@ -10670,7 +10824,7 @@ "uvdesk/core-framework": "<=1.1.1", "vanilla/safecurl": "<0.9.2", "verbb/comments": "<1.5.5", - "verbb/formie": "<=2.1.43", + "verbb/formie": "<2.2.20|>=3.0.0.0-beta1,<3.1.24", "verbb/image-resizer": "<2.0.9", "verbb/knock-knock": "<1.2.8", "verot/class.upload.php": "<=2.1.6", @@ -10684,7 +10838,7 @@ "wallabag/wallabag": "<2.6.11", "wanglelecc/laracms": "<=1.0.3", "wapplersystems/a21glossary": "<=0.4.10", - "web-auth/webauthn-framework": ">=3.3,<3.3.4|>=4.5,<4.9|>=5.2,<5.2.4", + "web-auth/webauthn-framework": ">=3.3,<3.3.4|>=4.5,<4.9|>=5.2,<5.2.4|>=5.3,<5.3.1", "web-auth/webauthn-lib": ">=4.5,<4.9|>=5.2,<5.2.4", "web-auth/webauthn-symfony-bundle": ">=5.2,<5.2.4", "web-feet/coastercms": "==5.5", @@ -10693,6 +10847,7 @@ "webcoast/deferred-image-processing": "<1.0.2", "webklex/laravel-imap": "<5.3", "webklex/php-imap": "<5.3", + "webonyx/graphql-php": "<=15.32.2", "webpa/webpa": "<3.1.2", "webreinvent/vaahcms": "<=2.3.1", "wikibase/wikibase": "<=1.39.3", @@ -10712,16 +10867,17 @@ "wpcloud/wp-stateless": "<3.2", "wpglobus/wpglobus": "<=1.9.6", "wpmetabox/meta-box": "<5.11.2", - "wwbn/avideo": "<25", + "wwbn/avideo": "<=29", "xataface/xataface": "<3", "xpressengine/xpressengine": "<3.0.15", "yab/quarx": "<2.4.5", - "yeswiki/yeswiki": "<=4.5.4", + "yansongda/pay": "<=3.7.19", + "yeswiki/yeswiki": "<4.6.4", "yetiforce/yetiforce-crm": "<6.5", "yidashi/yii2cmf": "<=2", "yii2mod/yii2-cms": "<1.9.2", "yiisoft/yii": "<1.1.31", - "yiisoft/yii2": "<2.0.52", + "yiisoft/yii2": "<2.0.55", "yiisoft/yii2-authclient": "<2.2.15", "yiisoft/yii2-bootstrap": "<2.0.4", "yiisoft/yii2-dev": "<=2.0.45", @@ -10731,6 +10887,7 @@ "yiisoft/yii2-redis": "<2.0.20", "yikesinc/yikes-inc-easy-mailchimp-extender": "<6.8.6", "yoast-seo-for-typo3/yoast_seo": "<7.2.3", + "yoast/duplicate-post": "<=4.5", "yourls/yourls": "<=1.10.2", "yuan1994/tpadmin": "<=1.3.12", "yungifez/skuul": "<=2.6.5", @@ -10810,7 +10967,7 @@ "type": "tidelift" } ], - "time": "2026-03-16T22:12:26+00:00" + "time": "2026-05-22T16:47:49+00:00" }, { "name": "sebastian/cli-parser", @@ -11914,23 +12071,23 @@ }, { "name": "symfony/finder", - "version": "v6.4.34", + "version": "v7.4.8", "source": { "type": "git", "url": "https://github.com/symfony/finder.git", - "reference": "9590e86be1d1c57bfbb16d0dd040345378c20896" + "reference": "e0be088d22278583a82da281886e8c3592fbf149" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/symfony/finder/zipball/9590e86be1d1c57bfbb16d0dd040345378c20896", - "reference": "9590e86be1d1c57bfbb16d0dd040345378c20896", + "url": "https://api.github.com/repos/symfony/finder/zipball/e0be088d22278583a82da281886e8c3592fbf149", + "reference": "e0be088d22278583a82da281886e8c3592fbf149", "shasum": "" }, "require": { - "php": ">=8.1" + "php": ">=8.2" }, "require-dev": { - "symfony/filesystem": "^6.0|^7.0" + "symfony/filesystem": "^6.4|^7.0|^8.0" }, "type": "library", "autoload": { @@ -11958,7 +12115,7 @@ "description": "Finds files and directories via an intuitive fluent interface", "homepage": "https://symfony.com", "support": { - "source": "https://github.com/symfony/finder/tree/v6.4.34" + "source": "https://github.com/symfony/finder/tree/v7.4.8" }, "funding": [ { @@ -11978,11 +12135,11 @@ "type": "tidelift" } ], - "time": "2026-01-28T15:16:37+00:00" + "time": "2026-03-24T13:12:05+00:00" }, { "name": "symfony/polyfill-php81", - "version": "v1.33.0", + "version": "v1.37.0", "source": { "type": "git", "url": "https://github.com/symfony/polyfill-php81.git", @@ -12038,7 +12195,7 @@ "shim" ], "support": { - "source": "https://github.com/symfony/polyfill-php81/tree/v1.33.0" + "source": "https://github.com/symfony/polyfill-php81/tree/v1.37.0" }, "funding": [ { @@ -12060,71 +12217,6 @@ ], "time": "2024-09-09T11:45:10+00:00" }, - { - "name": "symfony/process", - "version": "v6.4.33", - "source": { - "type": "git", - "url": "https://github.com/symfony/process.git", - "reference": "c46e854e79b52d07666e43924a20cb6dc546644e" - }, - "dist": { - "type": "zip", - "url": "https://api.github.com/repos/symfony/process/zipball/c46e854e79b52d07666e43924a20cb6dc546644e", - "reference": "c46e854e79b52d07666e43924a20cb6dc546644e", - "shasum": "" - }, - "require": { - "php": ">=8.1" - }, - "type": "library", - "autoload": { - "psr-4": { - "Symfony\\Component\\Process\\": "" - }, - "exclude-from-classmap": [ - "/Tests/" - ] - }, - "notification-url": "https://packagist.org/downloads/", - "license": [ - "MIT" - ], - "authors": [ - { - "name": "Fabien Potencier", - "email": "fabien@symfony.com" - }, - { - "name": "Symfony Community", - "homepage": "https://symfony.com/contributors" - } - ], - "description": "Executes commands in sub-processes", - "homepage": "https://symfony.com", - "support": { - "source": "https://github.com/symfony/process/tree/v6.4.33" - }, - "funding": [ - { - "url": "https://symfony.com/sponsor", - "type": "custom" - }, - { - "url": "https://github.com/fabpot", - "type": "github" - }, - { - "url": "https://github.com/nicolas-grekas", - "type": "github" - }, - { - "url": "https://tidelift.com/funding/github/packagist/symfony/symfony", - "type": "tidelift" - } - ], - "time": "2026-01-23T16:02:12+00:00" - }, { "name": "theseer/tokenizer", "version": "1.3.1", @@ -12287,23 +12379,23 @@ }, { "name": "webmozart/assert", - "version": "1.12.1", + "version": "2.4.0", "source": { "type": "git", "url": "https://github.com/webmozarts/assert.git", - "reference": "9be6926d8b485f55b9229203f962b51ed377ba68" + "reference": "9007ea6f45ecf352a9422b36644e4bfc039b9155" }, "dist": { "type": "zip", - "url": "https://api.github.com/repos/webmozarts/assert/zipball/9be6926d8b485f55b9229203f962b51ed377ba68", - "reference": "9be6926d8b485f55b9229203f962b51ed377ba68", + "url": "https://api.github.com/repos/webmozarts/assert/zipball/9007ea6f45ecf352a9422b36644e4bfc039b9155", + "reference": "9007ea6f45ecf352a9422b36644e4bfc039b9155", "shasum": "" }, "require": { "ext-ctype": "*", "ext-date": "*", "ext-filter": "*", - "php": "^7.2 || ^8.0" + "php": "^8.2" }, "suggest": { "ext-intl": "", @@ -12312,8 +12404,12 @@ }, "type": "library", "extra": { + "psalm": { + "pluginClass": "Webmozart\\Assert\\PsalmPlugin" + }, "branch-alias": { - "dev-master": "1.10-dev" + "dev-master": "2.0-dev", + "dev-feature/2-0": "2.0-dev" } }, "autoload": { @@ -12329,6 +12425,10 @@ { "name": "Bernhard Schussek", "email": "bschussek@gmail.com" + }, + { + "name": "Woody Gilk", + "email": "woody.gilk@gmail.com" } ], "description": "Assertions to validate method input/output with nice error messages.", @@ -12339,9 +12439,9 @@ ], "support": { "issues": "https://github.com/webmozarts/assert/issues", - "source": "https://github.com/webmozarts/assert/tree/1.12.1" + "source": "https://github.com/webmozarts/assert/tree/2.4.0" }, - "time": "2025-10-29T15:56:20+00:00" + "time": "2026-05-20T13:07:01+00:00" } ], "aliases": [], @@ -12352,11 +12452,11 @@ "prefer-stable": false, "prefer-lowest": false, "platform": { - "php": "^8.1" + "php": "^8.3" }, "platform-dev": [], "platform-overrides": { - "php": "8.1" + "php": "8.3" }, "plugin-api-version": "2.6.0" } diff --git a/docker-compose.yml b/docker-compose.yml index 4718dff11eff..2800b81d7209 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -1473,3 +1473,23 @@ services: timeout: 10s retries: 5 start_period: 120s + + # GreenMail — SMTP/IMAP test mail server (use --profile mail) + greenmail: + profiles: + - mail + image: greenmail/standalone:2.0.1 + container_name: openregister-greenmail + restart: unless-stopped + ports: + - "3025:3025" + - "3143:3143" + - "8085:8080" + environment: + - GREENMAIL_OPTS=-Dgreenmail.setup.test.all -Dgreenmail.hostname=0.0.0.0 -Dgreenmail.users=testadmin:password1@test.local -Dgreenmail.verbose + healthcheck: + test: ["CMD", "sh", "-c", "nc -z 127.0.0.1 3025"] + interval: 10s + timeout: 5s + retries: 5 + start_period: 10s diff --git a/docs/features/screenshots/activity-with-openregister-filter.png b/docs/features/screenshots/activity-with-openregister-filter.png new file mode 100644 index 0000000000000000000000000000000000000000..bd6f222b8d8894ee906c7d2096fa9c9d680470fd GIT binary patch literal 271691 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

>dYuN#8iC8*Vc*d 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 WRgy|*Y7ltkj)IJebfx6m;Qs-fB&>x1 literal 0 HcmV?d00001 diff --git a/docs/features/screenshots/calendar-app.png b/docs/features/screenshots/calendar-app.png new file mode 100644 index 0000000000000000000000000000000000000000..58e8faf5b4ef3cfdf85c0e913726d1407c536228 GIT binary patch literal 158400 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 n!pa+_6t6ej&&g7R+jl@xnBT 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 G=<$Dc1W!Bw literal 0 HcmV?d00001 diff --git a/docs/features/screenshots/mail-email-open.png b/docs/features/screenshots/mail-email-open.png new file mode 100644 index 0000000000000000000000000000000000000000..7bc05c84e04d77f4f8149450bb8b27b34bddf06f GIT binary patch literal 160338 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≶t2Fr4hPx8n9P+csxVsZok1Gx1cfE#5~ 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 z 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 literal 0 HcmV?d00001 diff --git a/docs/features/screenshots/mail-headed-browser.png b/docs/features/screenshots/mail-headed-browser.png new file mode 100644 index 0000000000000000000000000000000000000000..32d40ba95be88fb3a8670a9d19edde8b2bfda8cf GIT binary patch literal 411619 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

^Q1#KeHybB8V| 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�iZnAq!P9%D)+ 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 EV;2Gm&qu+&;5rIV3 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 z∨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%0DqFxL;dqv1bpF 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

_%ns_QcaJ6UPei~(*TuVHPWJ+ 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 N002ovPDHLkV1f$Jv-1D| literal 0 HcmV?d00001 diff --git a/docs/features/screenshots/mail-inbox-v2.png b/docs/features/screenshots/mail-inbox-v2.png new file mode 100644 index 0000000000000000000000000000000000000000..30a8f703b08c93b422683e5feb5b7af948094027 GIT binary patch literal 168569 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
ls=*Trkxpc!PRVk3P>LFslo$N5Rm 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℞;7ARjkd{pFZ1 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

@vUb$)uj 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

ls=*Trkxpc!PRVk3P>LFslo$N5Rm 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'amt4i)SeyQDc^!X;-H*>)+Bhimne^A* zsH$K#nrpzdoh_cr8N;^Xesb_jK49Q$_yfFCs-L!l*#bjmqpCj`#SQ`p*$*^hbN!1m_^)7YM`nT_*ZQZU3 z08axlI$rkJFWEyr%OBbFT?l#3%bgVZX3b&Fl$5iepPS0z-d%xh0IpEKs|yj%Hc^Sm zPIe%|roZ`1DsZl8prE0hot%JzII8{jT`)_B&7(n3D_T!`JQ6#zwUGXxbK5f-YPA$!%SGNcCtaPcg^G zCfaLbw1jQWlWO^op}0dIY%GHjs9_dMI!d@Vu`SzccBAsOy-w63oveD~HB(edWb_$Qf~ zy~A!v0WXLfn9fq07ib;#in9E$%!NjM(iHLohtN$rW!z>sx&FkYhW<1MSMhj`gsc&@ zgirlwI?Y`B7ScwbX*j`aRCIK73VtX|UH-Y9%{l?NG!L=%r8k6(gf#58XBxDR(lJMd za{@jXpMslz zgd?UTwVabHAHCs(a9I@K7T^0U=1l$a)%`=nQ4c?k<{AXl+n2ak?ws$XE58RzmGUx| zp`^W-!YbbRnTRu*pm61r(5?Q99#OQ98GTITdVpgxbLg^hS);Z(An!7$gxI~^^?Dv( zH2E&oC}zE9#CpD8tZfxfyvA12mEq~ZvD%J>8s%J;jdWLzS$}A1|JkEPtC{TU_c`?; zp2UU1CqHGlvh2lox$EAJz5hF(8vk(Shn>MLanDy0t|g?|)83)r!E7tF6O-PN=iN$2 zHbakNos%ua*GEf;74qK-*)PeGKqdi)zTHNXLQ*OzY#XN!HOdv7YdoGNt=9hS5rl)u zyei@8l*kC(=%VF8LZm;)J84W!O;NE(njcm@7e|Q+aSpC$$Km8n3MtO7{Hn;n`z!e2 z>F1rMwmvh0CZIz1*xENge!HTS)%=CfJ6geSzN=B56^pF!E!RZ_sYW{D)zE058p}BW zRW9;bUoMr75|8F&d!EmCmlUssyTKQ%MyP};v2KwKYTt4l66m20grMEs_Tp-;(~<<6 zo#i%?gUx;$zNAzH;kV6i^vx2_vQ3r472cwPeuO=H;9)V6^`y?B%pS83Tq!b@zo&V5 zdBgE(x2HaR@a7ra03YlZHoE&E+ao|Am-dN=R#&@%Z-o)@D9>7&Z#x6iBmA$DsFK3o zE8il{AS!8oR;)e@_DlWn`NCRkY1weow3qKJg65w(7uwc2%;uLD2nO{daNII{5QF&W zDOYq)K%m?^I|r0@$Nr6<9|!Kq#S`R`WfOi`zS+k85jDOoEbh~&gNiby#IGN@Rl=4; z&qX`d=3pR=78&$PXMw|%)!~?QkOF6xe`uOd!0hsfnjPdt8gcI$;VrzaRuCI3Oid7z z$`UZ&GW>EcY0bTQBXy~F+#9EsF#eS-Or=K=i)gM1)7$fXj zNK~J8t6z0p2AgGQRQ}(jy^*xcdoC?pz@1IGXS#GjFT|5VCPPB;AJPs(wJ;SPCamA+*!}$7i zdKzoeZKmG&=6L8tvSl9-u*hDUx&krBM|Qe>F$P(X>~Y}Ru@zog%Vq!TbK}NTeF2uW zFN?8M{Lj>+qyo;gu(6||Cs@SQmJ|T@GaQFEc*XoR>T(}QJc56_ZW6<`V6sJ8rZu1~ z9w^>4`6IXbcsT%qn=HSAf|Xdu$H}(d2nqY`O}&2Wfh8g``r_kEm2^gq`2F97uOkl8 zU0fGyx%#Gt-5{T{&qXi=nT+*~4J?~%=z|4qM`0^|U7h{xA^Z5oz99Dw4D@jIvcb*l z;AOXZj6iZLf-u2j=(+#y0%AGFTY`{<&R8m0a`R5qs(rwB&g;8v9KaY0!2rY5wA^@H#tW*A5D4VM2>Gfz$HMJ;$rc6Qm%@ zlbvtZt^JEzTht^ZB-GSptC60!|6^+=W7Cw{kk?ZH&OE0v$`1h&F1vrXo*ac*r7w`= z%0&|SU!Aft)Ya6Kf;t2E@kZNRM+&BF8G~@oUno=HLM8NO;1s>_p_``Ma_7TvK>0Wa zhmo(3k0#{}fk`Eu*nB4#8=RJEIFWi(XWZ?Fz!aFSVQ&r0&CxU-fP4DRQEO=;C^Zb1 z6|PdYIGC7;4GH7uqjxJ3-@%6mIs4)>qSE4**1*Re&^;yw zlFo0HKQAiv6P(E;j1nAl{VHFj)ZPgbPJPH+mB}T2JqcDGyP5jL|D>??Xg17=+ZFp1 zcYXiK+sSRyv9T$+1>R-m<8y&WW>}o`&La!3;{Wp>tt6VpUtJ#J0=|y+_GCi2Z6wqu z(k$sUJiNTh%F4Wg1(X4F+AW*ATJ=**E_l$y!-un;`{D&RR7?z7%J*&%qj6pBx1Xv} z-Y}|z1`C%`;QtRw!MDdA{LVp^m1b>j*@wa45g3%w8zJE2<_5RQ`NfN8DAGJ(KNroN zV^n|L21EWawl%gUIIk>wQqt3hWT^jpoxjjQQy7|&d-0ogiD+r9Y;0^C z99l4zmRVtz4m~}6dODkOzyoXzjREi|jeRuE`r9ljWrsNt_TOg(|PJ)9=rC?*Y0Gl!5OCNj+ zQY`t^{tU}=n^1>;e?YfkalAU@Yu4SkDc+jdS|+v9O*7|Lpo9_DN0mU-4vS*x>wmcb zF}5@$4vzT;+U!dY1+w&v>FVq!DiDXC0Pwb<5lFlTH(3O@7dg3hupj)N)q*vf;~-Gnp)Df(F{PeuyRQ?d?rMoG%awwMJw*EjMft$F(d&mpR4Zf4fMhv`8YL>tL$`FvVwf55w z-UvkchO~Ed+<5vR_jk1UlbxL%`nGWjP9dQe5Mso*0HjF5WvDNHv%A3bvjYwZ3JPm; zbDa|H0%*ESWpN0oslUQc0aq|Nn`SojnXrk>yCd~miszS!x+|5l0UAcos#cS3M^3SP|P#7L{BUr%5?ixs8 zL3W1u1!!ZnuzFB>Pu7dFAk*a}S|dY4b9R#odMjW9#pyNtmANM0CoyD;^mKk;r=Nf- zE<)Uy00&!Gg(ukK0O=g9kD#Adq7NTH8irm$HZQr5_C9>9V2c{tFKLAMxz(v?FXKW4IcKTILL*p`p!v z_K2s2-`hgi<%ca80pU|%hf)q0K#*C6j)MaW36~KgFE}WCsc4JswHgEQ5O^K_*;&DK zaDOBoX=@YhbyeX6F9FDE0ZxN%^>VijUs_r^;owkra~ldYbn$RZ$gprdDxH8f|Jgt$ zE+$1~i7v-l?Qk<#zNf0KGyv!NU0-@wS*^m~STa}|0weO|)D-w1cA;Nu)d&e;h{=d} z^y22}>d%s-H4u_hXtIJ`C3$sX4yx7_NQFRYsAq^mvL|oC7{0`7-YKF$hh zgROW`3J39P&c{TOtZHclb4G6rOU z1^`F`n!5rhD7`dxz#%G1S#@96j%`6n?9iL-s++kGb8V-aS?(sitB;!Co-WuTwpwl3 zLnbD--LCNDiiA^taCB7n;`?vAtK@VO;g(lKvkOvTagmXP_Gn(WEkcDKzN3r5kIL#S zffbKbQ+#6jpTunt9Zu+%w}kDAQ5?+7Jx6ket)rucw374ydIr_#vCKb1UQ7LrKwvh` zmS7(-JtEYOtSpQhx7RK54Gv;MQrV8V3R7fBNOLkcYuNHQ6BFwFhgGp;_tG3-D}VB#KJNE~14A#i4itHdOeJ892HlA|im_mCn6fdFx1k zrkFFw^|&e@?#~IP{0UeKjeU{T*rx&FRbPTsXh=y>Lo-+r(qpDYoR?6D zN;50#Lm{#|27Z_#SHMyUJ*W8#Gkvh55)LXtl~}u7uYjSPzy#$b*YA;(6asN3_H`u1 zd)*QSn!8WG2w(XEaD~mUKNt4$=a{6}oT9xDLQsO4rj|5)a>H6dlJc4c8aCBGCq^P3 z-)Kf7DS`Jw%C}TwB^bXJm2|d;l7p>7EYGX>)_@t?-Hm(ksoFd$+9xPXjv+1lT!Gl> z>5q$U4fpk_lO$Fm8XZA#IKvnO6iK4-YugvL8XXOU6D!%IjO(2c=^M^^Z6>RjnQZo~ z4p#c){jmp=X~E@#FcBt)E$#tz=BAo)`0g#qmruyVe)T$FfpKL`ngtD4JuUQx_jq}S zT3eCY9$=&re9qC7P3jDz_yd*`I9MR166W)rHasgU%aa7F(DS)reaKTznx#N_L`n~i zubXhkq~CZrIVG%+YR~1$V{2V;fuTJ-{3cT`fHioNDD`RU>_lTvEWBG6q=+^|%OOeg z?#hapnYjf^J70;Aw+j+wfLb~bZVc=OY`UBS=EeTV!zUQxyfwwyY$}4%9O)rf78Mo$ zf{Jyz%h{62aL4U^FTgT`_!Kr5bDay0smBM~nFZe*^)d>`Uvn_4W;iOfgsQ3ECBf2} zZTYhWVLbYzu#gZQ@qj1}2UmZ}+-58}T8xVuBON_M4_7|#E_gOp*R+ATdjJ!9i}DE^U(=H}+%IJc14Z?y`PqsD4) zjL4?28sdMdu6}iue733iEfKnuZWQZZ&9PMX@NNs!%|5O$kuJnEZ2j>=<-*3+mXh2m zO=l;b(Bc7LT}lD#>^(MaWWH>cR9ViaCKMu&>%1?;mLHq;JMk6b3DOTXN~))mI;s$c2} z_#5}>m!hY9lOnyMN(#gfbn@BM_PW$K)pUq@U;ipjG1R7vJVf5X+%8912i;)IM90zH^k~n0b16zVusp zuc)LX^wUE`*6@AiC_&zP)noibi!P5E+r<1Xz;5-?;(Lf7}wgR144rSPTv5kJ3(W0eV_OR)^RRLoko^~ zxb+|%L?E1;oB*kGKrmNeZVCbxEDylY`?#9RsL^ijO9M;|_;VSd`)REHMRLWDR zjjUfcAprfOP%;?osrIvtp8!z7&$J4mtYBNnSuj=h=zk;l0g#HZ&t7P!4q%x6O!4R{ z2$gZn#@|knQ1|!uFBIy_B3Sf}RWVJnHY?#%ZqrBgGAQAx)?{JR^)AyD3!A|m!BG0o`=_kx<|uMx^IiJw;P(u+|lhPrj+c*O<42WAS`5Y_r$UmgPq1gWu1 z%r{1$Z>{uaVB1qJEjWI=EPN?_Iv{b5vnRzXhm%kSN#B@^nO9*&MON@U16^_-upKy$ zrBq;`2isB>WXZh6>fc31M%LBc>$e@s?EsPoP7!2gZ_r6VZgh5bhWhtFNohe9NoExG z?MKKWdjp1r^N`^|cMCx>n291jsHO4bK* z7xrtsYpPIe?_~BdJpYGx@ND(Z{ZF@46ckPsyHM6?W#5pydw9SYls(vjfQGS3wt=Q1 z^If@F9L+s|h3FY1Ej6dBzv+6D*>zF?>wojV22#!018Yg!Z}20q(s-5xqJm83uT{oM zbXe`R09PR|=6J)7rNS}?e-~zww~xl^X&&jurlixi7$Eqm&ZyVxq!yqWST} zHwZC+445c6_1jC9miMC+7%8cN42KU`GiJLho5jpkGXU>7K0!z8x z5f4-{s30X;d7WXnR6yVyf&#Y?m)%h?CI(I5&T5oq1{PX z9LN+mM{|Kx`@6LDxEP?_qbQRsab^>m51#l7sg^Sv!4|(ti-tb6gCJg)GLk_^d2i6k!TUlf$5#a=;!D zIUt0^bmM4~tk`(Z4NATL=Hlw^Ke+y~{V`!=4hgisfbY>nQtP3i186z)Kzb)E2QTG8 zn*7iMV66>O_@f;8>C_J;Umnq;L4lr==crYw5gmyF-l$k1|)PM z-+FP;2}m%@mvC%a3s%Ot7RZcO@dyv8r6*e%l{)}q_&tf4EgXhD+!l3PgE1#y+d2l5 zTW%F}fGMG&sEm98Do&f6)9GoYb^;m_886PQVGuU0ux4u{%lC#Ni*d3+ekVi28IVd% zt3%{#72|1m#%02qAYaH?dK0WI3sU`;74bH!K!{Cb`cEbKiEX*d?m>HX_j29DxYjll z5i3-h#xv${>B-~A)KK&wiY0jO9{0odqrh(98HE+3!YKveGsi1vR9AYHRa7$i!>q-{ z#DM0Pp`9a=E6f%c%YGHs&f+nBbyD|;Sv18%>Ct<8_=zNziLvTy=H)?Rx!zy_%XDZ1>I45`NbeH5we26xiAJ^G(zuFRm`UnAV{^hw}P<^fn0kx}hEb2Uz+L?3UiU>)| zufWOd3@k!;IrF^5E^FxYDR`Z4SbuMtl+2B>k!qTc4!SIqDutox-^X?~OwC7L>$PZM z541} zxntq@`{uSzM5zuM?8IY`DPwoh@oD4|Wle)mQwF>h5X9U<+Ji?ju7SpamTwHucpVI= zsu5PDwgWgh`MIM!yPS3EqdZBtSz<)%37-122kX&1x?Q{qmvFSd-x_>Vp@94tLcC$k zCg-<;q(-z%aE4392_Hyl9C@%&Pm5oJ$RBG%%y{YP};-D{=U+Xkj`>~-9q^aJy_t4OM4_<=SY#pkZ7KW!VaoPnCmTRYp7H} zcKwkr;M2$EGRl2;<-=T=n0%X@?C+X;#PQboCPYs71;;$Xj6}KKNDQu+{`tX&&o%{P zRyu?)fMc0Z_*|?d`dxvCDWzc<2K-?Zu#lts&*Rx>bI^`j*}Y9?Yt(fbb#6TLDbN;q z@kd`*ShHnN2Zm8d>*|ukC|s;T|ISMk;E5i32D@@5_P)%1-eCW3;Y~vdmKJyzGWaa9 zLL?76a@M5X+SoPadF=+N@y`Y|`{)*Aid*Tx>4B>>0Q*b+7?og1A%+5x^bdr^zysp| z&9~+UsqgCW1R2PvWb2B-W=s-7#zCLHp`&Jq`!7RS-pZG(+M>Ci-CT^>Vx< zs0t%MQaKynp3;u~1;5b{4v|Ju&;$-6X#d6#$drl6MMBp`PsH>GNWUAFPK*`Lh%QZL zc?G+1DXs#&)fuWvP9IcM9CIS2(`)g*Z`YkhQu-l{v9k4zXTu+DR^F0`u^W=q1x(?; zVHCtRAadqME7aijKnO(B;2_lvV8!!803tk zS5sHlg@%Q^o$;A?kqn#Kl4eP8shuiHZy!t^gH4q>=1ii^>lCresB*W0pW&(_eiYIW z$+s%rs233M)ps^|(V9)&<`T20^?{D*jbBWGb2U7SMT@+^VdUUZ>XfT*(g_HV^x;x6 zx=jq$IQOLn+s_SH$ap+>!7$}5pk}>k`dfY)WwWVMi1POR7crlG+6PH(1zVS0gnz?H zmHHH~&loN=J1nmy^f6^(PyUNrQ%T{q=OFf|r4@xL*~2J zYJyzGBkH$Su$()A94$!sSZV7d)j(h7o`_z+)2X^EEA>13TMNY}9|q>tW?mfay;X`0 zyodYTASc4NY!dC`rgp7nQM7HLs_ZAmnOdip1H4ZJ;g#`%zuBtJj6yH{)jZpGo%ma|q@p*4iKz z_9~RDKZ$}F)SrwF4XU+Xh*~fn<{WQLcO89%{i>Q#B+L0hzcP2N_OpJa8NqBAK5f6% zl+2?xp`E_GSGWb3tz@E`CzC)sL#@n!O4?e!?Kz08s7GT)77z93OsN@8j`qi|BC_sB z?~Hx;2_*NRVmN{kP*6yySlQ%USU;diA?VKjE)&_N@h?ysy^78(j55wX;*Zz_kPIC@ZCB7pO3eVT z$~aF9Z##^Np-_S24^tbcqKkG-tI=Yuil|6eS10*)G#k=HS+4f6oJNMU!wu|Z`&qUo8n7M#NB^1%`9W?vgGG!^X6ZZ1)O!!L<(`YS zKXyyc&CNAwkvB&V)ThMxDojnZ3o{F{uXCm4&~ea~f#HoHX3Sq85)Q$2LmFz%Q9nL7 z2>unD;s9-@wxYhZ)G3i5z}dm<28B}O*zdu%y<=7aebzIlVt1MF#c$0pI%W)=?0?6y zUh4Rm2iE0?E1aZb5b9l2D^v=I$k*vH>@A8t%KJ-{w=yqhRF~&rShEUw1wUJD$ggCF z9t}5RKbNCW#l9cpB0@Q_q3J6qvT04k1f4kO-n{u+gJ~#NuAXiC>a$TiZJ2RUvSKQv zr>yiDUx%GX-R~ef!7+jwE?p;hyP`x4vFFkhEaU5RSprVJnJK%98 z{!Gvo7K_&IBVh(8gv~WjQ1DgO-)OfqMWWF0MaRa1J`$NJF1lGSO8h8y*$;;YFHrL- z4EkU*OBlO4U8Ut!?#A-n_6F~HZEfx4+0o6I%u(|zVCoW{>4sLE8{o&>3OPlNisE&Bx+a& z>4qyDb|yqAB?Aj!cEp}@Jv+3C)sse#{Lmah{Jzo~!R>l*s1@y($y_1mYe@r22}e!Y z_uK5g0D1)Yw`}!hu2+C%=j>?ICUH%^x$ur3b4*j60=KR9iJ=|SP0!8qE{{K$E8*)` zaYl>`i+!B6oXr90;Bhtq{F0sVQlFs}Y&=PSs=hnOiVcH>Jlu=cfHxwLGUx_VIL+?@OR^m&6GE@Hw|H$)SE?}KruK<;1KhlBRC3y?s z!|y=;FD;u9I{i23oy;|Tj>ASPIUTYX@DOC}ahGyqu(-RI;deVtc9W$eucv<5)vP(F`F zQFvU_nh@`$q0tE&HEmE^^`-HQIT}u*u)G}>A#!7)4;8fuwcco=n4btaIk_`Ci8wom zY!F2qdhdA)81tR6rexqs=zo@sZ7?!EG)1?c%LW!qM#GBh)_fd<; zkuUa}X{(-3MFm(Bf^0eyqjFl-`()|Zai+L4P4>%Ahrj=I*PSW6qfxZ&ySihx&-&1R zTidmHieJgJLFTlGc6ZM2GJP#*d0j)?`A0~~!`<-aiH6;g#_Kt3irU35X))%@)4!_u zKHgI-f2?ZcwEN-kYIF2Yxu6mDFWF4BDd(fz4E&WGHG93U{uH05tdjwiCv!yJZ+zd6EF~T9tg)jtc=jQ!;iAIBOyT>Lzg{t(7u}}a@@_1i%_rtZa5gv^=sP_!5BrG zR`*Z~X4uQoe%nHn=wtrXYEM7yN8E|yStv? zsXOCfeeli`eDdD;Jaq?LT+-G|uZ)}!)_O!&gk?|dA4!Nya79fOJ=i2T8kau$Aj{U@!?AF(H zGbi1P2Ro~?DOt_)9jq>B6uV9xzVI0yh0D&?dGUga5B}h)07<|b-i;U#IC}OvRPn711~wQbamT^ zT7?M&>g0_tQ#PL5AH%(vc=q~D3OC=zPISJ+sya#7`6nE_J+HGRp6ky$pSQjr1h1^T zC}%dxW_dUESZUD;OpVyyiB3>dn^oX((;sM*u#n@Wc1IffvAn zaDT?4rI51!^#GqIDNz)KU{=tu-YM{N>tKdKjK&SIVJe4+O5B!|<#!gD)h{_m!YU}~ zbHbxO5FlFb@;i#H)6^skdy)5hYySQDDm?j4&QBXfJv5b>s8yhwK*mO}#t2H~5scYp zhso5|XTaf*AsfSNSxaUR#LO_09T@k9lOlEZ?5U`zwzb3ZKKHuPIhnUhSacI4`%A>D zkwxOY*ZUZk`Ws5(1*;uB%5=K>Af+3OS_! zidlL!_TJ}30N%j(li45N@OPqvO0Oy^D&V0w5SG_))^2Ya0b7nIE8->kHpT}qs%{wb z$mXx;+)7GHI;ne%))Kq6=D9Oj9bVU?wu_ii*mqw*;1HVldNw{3duJ&3X@eh>>+Az*fL-;yIr+AwMOa6ljm%op}Jqh;TgXdoD@WK??@eG~!x>u&WRlDZ;XTuiarhA~`s}2yD}ewY3F& z>9tA{j>flbHsghj&ZFp1H?XKXvlhJz2bU9X)v zais^q81m`@o*ifoM1~G$9z=&s@s~143h@9Omv1OMD^1(Bu`yELV<<;-EfGaf^g!_H zfZ2^hk)UTd1MQgOBMmbp+}M$1gM$-RS60GgZ?p*DIhkewN0_d%X8E{)zY1or?H|p% z6}@PHa1}u`hTl3q8AD;+pjY!H}5^j15Oc+C;ifxqQ4mkL+QL{mu z+elpV(6x*@P9?vS#c&{nX+&J)QoevdNN);= zMyi%k4>-6W)x(XkXw2&7gg_X>95^21{2x{{vz@eZzO4<}+_OENufe1RsT<4Y>=P5f z4j0^+J>GeR;G0R&>v;1p_M?Vw&Co_HO6Uw`Rv5xCW`hghAoDDfz26P`-mN*pi0_P` zI=b(^kw5p=Ea=A!h%Yb*GKW0`FHUF^{-!Xqagz^B%1;XWC6PTOWehwy=0TpILh*gC z!8m9WU&6$3x9LF<04Mqu7EGdkpc0PH8s2C)rvcHqlfO6b@hvX%xFD;qv8bY~^}4j1 z+B>{AkVtk6m+QiR>ao4jsK5mc{d&wMPkZ5WYb)mUuM-6`#VRD zNK7U#?LkY)mRtyC8sJf6)0XEsC_~~r;hhmq7{jD;cMeaWH+Cw9TWixfS)fYp*5u64 zPYF`M4eh>%clHxBJ9?GE{Cr@YilA8&;|U|X@jiihC#OrgNzRkS$1PHc?(gguFIO6AD7p67HImD5HJblC10>6RWGS4=9{(KrH zmayv-7KbZ)G+9z(S%#@R+gPW~y^3%rVY=N2{t2jsiTo6^ElSPkF0jo#wZUW6ihy6m zU5ZU$bq$Ayv&Z6N^iph9l!Sih=-Wb?QC?!A80J?4jRzyo!-X$xVeECiM>0CjqrE9J zln=1eJ36~>wb>}Op<ky%0kd2aryCY@bo^Kc30Q%YoeOKIJT)Oz#U2+QS*VO$Vqp+ z^&gh2>n z-vL>AO{ztqY|OKH^ZWtj@y|1P?j0N1jn8G&rDKR9?UO6m!xY$ex1RXx%hpNwXFLlc z@Y%G~-#_B0Jni+(L=ed9P-uv2DRM{sN z2|-ItMK)J(x$uh9wx9eB)!=XmwN~EhdiuEQ0-vte*;v#yYqk!r(^SKHCC(gX+K5Nu zal~hBwkJx$r|for&Rm`qj^kJe7wXmiJ+C*TP>iN}O>4Gr=tUHHZuQ=2*jd5Bp)NZv zi_5>LC_gzlA?g;fpX10n?2K4GDt}4^RPvSGI#}+jvCGZ^pMAA9=5S5Q)i^9a6UU1f{Qk?V$ zTS_S-NV-}4`RJ9Hk0U+#>r)xcZzmn=liT%cZ>@D2pxYF8EtNf-RK{FBSL%_f!bG`^ zrKIb~@Q|}#ps`ggL((tiDtp`Wt*2@i%37tZ-O}n)CRVX?YW}rFZO)8N=HdCE`vHls zk}hpw1S3~FZbh&KSt3+i8f=o(8G^kYWGfe#t7pP? zX=`J{+RCa#wFsg`5bu?~S%2%@9*dL=LJ;8QLdhHfxCRK8FTg$ia2__Eh9nO5_9Qp5 z3QjC(seLhiu`499!aEldOOIGpQ=B0i{86l<;%(+PKOnG8>r+(pUe`Q7xfIXPz3o0`U-8BK^gI?)Jn_ib$S)S+22x(=IIkc; z5j8b^py|%_2cWnRcvJs_Y0Pj$CYT8W51 zP-xhm^#lT95)@3}L4cJb7$NcmCc}~x;Qo&pKW?;NjrS=8P{BnC(`_BVM*yB{CV5{^ znLBpfAnR~l-qvt&bPV{-y7@_3Ru*3SJ^C`h40660Kz#>j^J{hW4TVWrE@l80T^>Lf zRacLXi;II)1l5-Nv4p|E#QOcfiEjzD$A(()+F|Kua8GnDU0FbS{%MxG3GgrLlL8Q) zIN>wDY2(e8anQ*L%NO0xy4QWTZ~&7fYUBKNd7T8zJsgQ{d ztng$D1)Ykpe7*gw=ZpnYPfULyFl2@iJcuIZSODa6LbfaZH1?*~M5jgbm!Q2LO0LM@ z^6=)i{CY%9aA6R-^|ms~r!GS?CHdKF4KD?<<8c*x2%6M+gO1Oo z$cYB-O5|#0fChVB-39jr#Di|=c&u(?6&=8S(Nl zVxqIYB51kkoipL~g-yT2O>z%wE9u4CurR;7QMZ7K+S&+UvcF*Ixy~*=JOj8yp@Xjt z2Gd``MXp!tkWVZnF5U#>keDYhwZyj}sZiF2Uq}nWQr$863;824b&F2i8X{Kl#jO(u zg2C==(U6dk8(1bfI3(m3cCMs>!EacR=k5L`**(V}f7>k!ATV*muBU711sURK*OLL^ z38zCw>%ekpPDwH4US)jhY0ZLG`l8_-wDf|x)jHI?`VHMuw$&fEiMhx>8>f6|&Hsxd zIB@3mQx?|$U_aBfNBo!dA328&r>1YluOX?_>gADWy*^=sreU{C+uA^}$dGW)%I9A{ zT&HjiXOgjswP&7%;pXl>nB8A`8gJC=)59(~@Vfes{-h>uL=R#2@%oUqq7ZcdO_^Uy z;?KNOqgtQTo?SdGo7^*@#F=%o*qcPNl8O4|gy-|Na~eL~LUl&X)lj6}#b}dT5BqP> zW0jm%;Fw&17BjRFHw)-yt01ZnK_7&k;-VGxpc{r0qaST;CQF^MgWNP>lAnN5V+J2K z3-d4f`!qD!pe%veGI%B|JvMe5i#U$HMf+nH_Pvh4PadN zjrpK&owxw9*eNR{^c^1H`y8E{a4A9d6q=I68Vk3mC}mLgzp*F7NzBnzN~ULP=(u=^ zp|^w{S5sqaQQT#*L3l?yW<|}K$`}`4K&TK@q-xlrOZ70RTRNXxB|j;T?p>7>ak#7m zu8hi&noCz;jrF^}~IvWKO{i6f`vjhu8#7_VmHlR`S@&w+Ma}KsTHKlJpC4?M~38?$>_P1)P9x zuu$c`s2QOGhq^ikU6q#o<|`H7V7(dOz!&D|_y)i4PKO590fi%CJcte(j~vk)k{|ea zg!uWB{`LVAB$=I1Av)M@V{s7)fs~W`NuPWi+>d!~ALT%}_sw}T zTnex@JQq+BdBC$aVdn_ybPT7}r2KsPOngc_yw4CB$Ka~h-iT`sz(=rCI9KkeWegYM~+*I>LMm+!5}bl89f%rO5VA}}?6G61`^&*~7#SIIzBIy*b7d4z{c zDP$d>w>i2Kxw`(1kXE0Zv$wYwl5$AGM=kop=q7MA!+RM6Gw2B({2}A)Rllo|4kP9 zekAaiyLs*8?q+RnY)Bt!V$NX{B`Wy`G<6^EYd#4JD+))V8;8-YNU1S0EX>fIfRwZw znM9+2)bUFqMqE0L_~OHymJ$^6QQvD7W+9F^`qrQv@>v&7@BYLf$!+z*1 zAL8(YvFR<=NpXr5Q7LXj!*39vHJEPy7_K=WhMBZfnKSUqK-`^fIg^%e(Q?8;!^=Ac zzyZgzcV|?d{~XpxUi+m+Nkmpod}u*QM@jXP%J_4MJFSa>xk@a{Q+fKh!AvZ||InRj zDPnGwMZ8J$-0eW8HADK$FCf5L>1hx5hOy@s*JGc@;dk!b@kClEg3PHn^wI^I_wFB7 z&UEA!$1C9TU0id7VREX<0?FR9*&l_Ih5zZ^>HvuN&?zop2pS{4g?Ip*udFqw@>6qj zR30Y>W?ucvou*n68G3Lst31*~ZD#oGiA#k#S`DBOENwlmnuo}tG>Gj{hBE)A=DgKQ z!gs}6EM9@0Gfl}X_-nt+H83&3lTo!Js7gfWer0ovttPLIw<2N{R=iR`yy(C580xs{ znFvqeSB?9hUp0xCI3qbFCQ;bGlbdrr$lv&FBi6^XfDt$0-ao(s4z`60V;i1&$edgq z_;4ogYpDq<;P)h<`;M^GKsY4PaNAu7;=Yw<*g%uY$&BK_5{>zYi>eu}d$4W5xh3%x z5U`1p<2iNPJ&=hjn;r^lq}SBc-0-{@7}`O%vQ}ANU+*gC5_OM7EB<^061Q3b)k^y9 zPlCAzf}m4NKO+?qc7t0j_eEfM1az?BYrJ}yR>HvI4HcX~*iRfcv0w>^S2H|lOMe0F z1ETyPl<6rWDbjXKc=~0|9HAK!j>r?^iY*zC$|1lyc|rY1^zYg}-`f*hZS84tqi586 z3=h3Y8z-{f$r}q!Vg5(@WB3p?^&moE;v|T4r%g}-SMcFVk_Dw{5D!vcT-@Ra-#x9Q z6Ki_@u3l7Xb6$(#B|sz*5D);Ryn76(YHFiFTyoI1gLsnWuOwN$-MploUAf{XHVBO4 zei548fda9G+`xF$qyv<**5mkNX676y|32x|BI+gy4T>+cv4f<*pR`9;`)0#(SNcFe zqaDgj4QWPFQfK1pCGmu3Tpd}=pTHe05uy=!5B_9jQRg#=NrLb*#(lLnIUuIwMcGZb zClE=;0+N%GT;1Ji=T5wKP3{T6ESJe=OR2sGa5%uTkENx>H`=e@C6$xQiq|wpYKXfs z-yikGKvSBbjz&X{WqhfnwT6of*Ku;_R?B}hv&5iw%Cbse?nL+Rq_a$5Zsm*{W$Yy+ zbS@}(j~S$A%jZwS{tS;n)NJ(_8#V|Qz&Zq#PFAlZIx7Sd1r9-XRH2AyA4SU34G6EG zH8daq)goeRkls?*h3ZSwxb||J(qR+gA5j=d6quw9L%+hjWeamAV2iEnxR&;}J+%)S zvsY_TvxPc9UJuTSSd$dtSX)GfGqbZEhih$SvJq6&uaNwCp0#@CSwe}NV(^VP_9tr= z2|ou{GJZgNJGXB9VroIy-8li$)=Wh}i|E4S>OXT7F z%by^!8G;$!zd3&RrDqidh`O(wj+x7zdiCFh`kEZupoqI&sP;`+lxe@v)oWIKS~KN? z)c@w|M~#f^pF*wm)^1N^i62VUw)Li!?>9B^bbQlm16{9?LPzCeGDNBUfARNRnH~G1#B}VU@1Hd4rvLmj_#O+df|36?NvXYbL^&Xa zHMmRpNyueO5fUtIfgN!SP58GTP;<|r zPW0N*($d;J9vT{At_+Kel<5V}gSC)@+FWLtlv{LrP{KBDUfP|+jOXsi1lOU8GKRmY zV4=N*cuDzD6iB=OwW4sq10_(Vu$zOTBGxqt6%~%ijnIqPik*k&^+-WvSs4pg4DdEC zw|%Z({mlWe1-x~Q+vzDVeqP60*XEKZ_$mhK*xejLX2$>qF+G}I12i5 zh{Lup$U6ezwt~DoiHJM5_ts?PD$oFl37;1#XZu`Vd2aElR)B;VD)>E6cEDO}O~dp2 zsEoN8^w;0G)GqH{@k7r9iun1#!9n=MBZ}^A|AFFVu@V5>87wR)y-`t7fZ_b8H1LnU zJEH}1XxNK~Dc+1n!1Go{4ak177g!M_cj&`LGomgcg za-i0~J$Wc6C)d>YXF7Jy>_5l5vkW?y(NaxE5TpTTJz>iSUJQ)e)a2vE&)4B4!O{_| z1MmaYMScVZ1xcu<3%hY1EWVQkw!M5IuohmFWgyUbLFDcS&VOns;7}L4ShKNJX zKR7(>0I#@W6merH9S3(e);jbAfJ1L@@4>!oHH|W@dm$|-S)Di8y~A8v-$1!=LS%Ue zom&8Z@{SC1mBmJ2J8<{!prM5TNx5UAoZg7@4?>6hb5LW4b3|R7rh$0Y}k8&oc;6X z&k(yR1BOTCkDYU(pyC5~zwj>}BiKBDfL5`)KWGrvj~=1fKr;lw-y_Y6C3wq|*;z=> z;TyiDp^mF->ja&WnyPBKZjGIxPSD?{fDqD*(gp*?R^lz;F&YXAyhEShpa4qvdl#0K z*bBDc?N41NDdc^)c5l>9?i)ai9c2>xEV|#g)n9qB7Au)r<^dOG&?n+9#^c7031&0G&)lhlkVs=c)D@W9rS^)bn>rYi}>zc z-BSVR`5r%Ze5yvr&wpZzV2@+`fk<=FycpGuwn*Q69WV4)Qv4K^*heXroKJw zhvf@v5x4gEg2iGqPnBTVsqyuZft(!rUE|J$oW(mCE8Ig5xOfmZQ*D2v<`*sJCF67& zgVY)hVyH)JT^rH@P6|e4RI5-6@7+zn&u5Af6UX6^xV*fqwQbj_+{wBNMUM9PmI+CU zgQ8LR)d%sssAr1JnPov1qPNvlvoTsa=^i}blJEr+q<=RaOU_!=HeM3qGe|OfaOW&2 znSaV5E>5}LK$pQqQ_bh<_4HhQmyY4S*FxYv4JGOEaTxGE7 zT!BZ>X>%&UlyCO3dx}4bkFdlpV7moN*-q%bH5JA5P+=xa<8mOpr z3h|@t4$L=smMN`+l?Ep^`0pLrX?y{sGtZbh%-`$x}5O#PoOY-|eFf%u@mV zD&>G6*$voO;l0#3)5B@d^_QOBxL^(hE@QavD@|3u!iN-Av%%b3?|kW_JZD zt9WX%$qJf$7-MmuvB^8tgi^&fwYhf%xfw8n!u-MGs`u&L_ofVl1?o@DIDs!G{+SVM zk!$z=V@~9x3{MC23;SQT#Q~au1i=~*E&>l0Bx7$$d5Xboqe9Io&@au>#DoX*zF?0B zTl+ zy4%GG$Fn6HBpQNO#66r?2QMDh!i_Zn3p&tH2TSY%lZA#GXs~EMxc~Im2_PGoHt#m;$e2Tz9j5AH~^74AKid5ww{RLbXVWBWDA+GS#=bprj zEmS(QzLcO!z%Zf@n&g@sC@^^~%a+D{5Uaqc>-u)wYL=l}a5i%-WwmNz#s5QVhNChF`{K zve+e{5*Q{-Gb3V}EOq?vm zDY=?y_!vmOtTe?IOaXTq#iZUl5h!}Er53wrAYz;F+Ijnz7chXBD|h$y7IG=xvJM}6 zLGmG7J#K^nXA{VIst0nQwncavhbMifNzss&qTo@LHDskqbvYf9P)kauvXDBxcYu-e zQ^Ogi|9$2gAGBxy^Rci!wtpg$@Q5+;BrJdFfbZ3ckVQMIslZORXGdjOKaV)FNcH9}(ce=N+1(}A34wBtWS za6dH7Z{>59Byq)uE5;=shV84n6^+L`22^_z$chqEyb{Lvco>YyA4MH;S!l<(*bhYI z-oUXb18Fvh%d@bIRzV*Oj@^$f$^p!~L2G=>oPe_DhlI9Z26q!|veu!IM@B<)oKuVm z?!nw?n*`2Xfl}tLJb8jbNvNwq#=WmRfCAcbQ@g-dmme?WXnXFHYSGV6`q8iRZbYaF ztXJ?Ar*NQgNV(Cc25)FF9G{^z7rWT`0mMHL=|QSF1r=4a0UYC0=*0*M5d0xIH$HP~ zd3g*lc)A*i093fTRUgfncz{qAxU|DSmLZq?4OT6GLZ#6FMdQvFB-qDv+I;bYpVg=|H!1E%II5uX#FB;WuC%Y6XgaLDUNP2PZt~@VUYw(-1gt zu-E&i+8OEqC87oj6UdH+6u6}Oo26UTn`U~kd0~4opHa%?!occm9H^?g>Mb5 zu?rn#&MKf{RWdmN0KGv@)txg=cZ|Ub`+K2>7q|!RGd=KW0hk<+3m5eM?(TdDwS$B^ zbeM*)*n@q_(U^ulhh+I{h=R|_E226B?VhqUPeu@Dn2(GZMQC$dn~bm)fSv`%6+N=3 z!8vvl5$YD_GlK}n*B=}EMT`h1^@FQjAZhd?SOCWeSIGP9E!an$@Ng*V&d|+OB)Q=JohBw(V+Nmb2 zKH1i=CicHDx8UW492WuZ56?vm3|5b+?;IuMjUT*ExyXhsTxY{83Nh^*jQ%Yz`87 z?jLfy*Hv()V@AR6GMt}st)GlX!p9z)}gXp|Fas_~C5y|$YK z5q00K@41G7m8`FDJgV;oy1iPwX6?WhD78CRfD8!3M)Ho0Iry$S(tT!Q_HyaHF$NPXJN-Gdg0RNkAcV_M+FsD>jJs61 z(DCBp!oXT;08_RU7MVMR1~LJ%Z!_87HCF`5*|Gl8@0=@aHtkOf!w0L^9r~g<%Th|q=hz)4{@fEF$Ea)2U9QN$_wxK^B$O$(*VVQa|jmKkXhF)Mgt0;t9 z)K-#f-6YKTQ{%s_zJwxkuOf5b)3QFr*S&qOnS0AvdN)g%H#+HJ}NR-V39Dt|A>P= zz>)G0Au&|J>fINRQAv|OWB`OEA}lPHk`z`C(%4(_ui!3&NhL(K7rEmu?(=LTaxrh6 zQ66qY`P;FMhsh&gfdD5;-Y2|E{Nl~pD4rOne+&yNMZ|51_$3A&9U?>U57`GEQE0`T zXMrgN_9>LyPYZkDs(hz+m#^(h9suuPABo_9H&Zh84n96UH2w7Tj~`9}j5RZl>Kh4iO+jS6_q2O(y)H;#}<8} zNgPw6`ept&?%kV+=7phaRM~Ab`9}%X8IEfR%jXtD+aIKv==O`AQz@n}pi5F~7Imwx zlBwF!Xz#11#(lkYvsq!ku`8@azLpI4msI(vBfy~e`U=vbvXX!?X9}8Cu>1Y}LA~^) zJ%B6x-0lbFo#N2Uw=$9@KK5-#P)QnKAdC%On!@Y=g`A+(J+Z}wg%jQ?vX4_UjXqS< zF)B5ARyH;bZu_Q`?fw0Cj0g@G54nHOSs)Hy>R5s1i;^w_R;qo#b*-NK?qa*urR8H6 zP>7k&*EZsN0^JFCIiiGVUY0_G^_E<~0iGtn#2oGIC9oz|o+0fq|HqKaTFX48N!Fj1 z1Ju3X-x4mAZS+ANnry&oBpFmG<6D2-`gWB@90etU zg4^q(=%N|CwWl;MYoUz!KN0r15(YKZbeD214Z^Twi5ahhGQtsfagxEZz4;4n<7oMV zJ-F8OhUT^AypAb&Ph4&deu7P-$|*Zb6MAdDnYzBtxh$eNHu*o`US*P|c2a6`YAPp+ zI$cm$_e|?(cdt5)qT5RD{VN|7qTETeem-RN?R=y5yq3@0foth?X^+H9YHp>UWsZs^ zv@BgFMfHq4QYj-eQnP=4=Cu*rdoudK{O7aMD0CbTij(1dX~yrKr;{Cb`XmPAiQQ`1 zbyypp@nHHhN>2cR4}gkPXaW635$lo80h65r{017G`7gmXh}oLLDDOI8#|gsS8@7n< zBCv)?)AuE{ZtM&*=^nm|3c3sHV6ofp)S$C(!)OD{)DvmX$j*-4<&X&pA7||c_<;g) zsPU~40K=2<;o&_pzZ)B-w-CJa2d1ynB?S?Qt?Y`nu{IGMgN3l>F)2yO(E-T@XeqRu zWF#FklVfaMqdXakI>EIJ2Ftv@K14-4vw@7DGv@cmcf!GfBkP2qEf}M6L$kjL{b~-p z4|!KC6wg+I2q$Sty_FfjbWnkwXm<`%PAUFr{K}(8f;59>+1BAU#x)V_4c0|l69KjF65TNk?cQMyo*Cz&XQc2KWv*fv{aC+WqU+XW=6{Ztm4PvZyRYdKoO{3I zpG`{VVbbz|*=>}m-qu#`H=#M)d^}$`dG48tr&hSAWvczybsOCN@Zh$Gs!vH^KHA*; z;+uOu6Mu$ml^ZVbyAB&k26enwB)L4U#R^o5e{IW;CGFncMMXhQ6Rx28Zpml4w)R4T z^IR*x5v$(r=V-)-sN|#+8xij?lKyCYFYojAFOvN-iPp1bgJF6^{aaI2E4!C2J)aU7 z^*=jiN?@n>&|*8T?KJR7e6rr$d-G>3+9c__==ip~hheVQK!f1H7S#hE`}4Cg$ciGg zo$NV~h|M@%72+$sGV61&X8!e!XxvEJl)$XBwP-~5 z6?szh2>l^JVolVK{u@)s2ZprJD06{N+0v5nNB4uRSr52Al+99jUl)tk5>H8k)dpCt zZm+LLWWq?GnDqJ)DtO|aLh+-vg?Tp8#1|ML4z+p8*^)7gZA)Q$-Qa_eMe0Zq`2c8A zeoxeu9U*4|25^d5HLIR@MlP?j133CboY*<qXY^@JS^ zmTSA>s)^5zgDLy=gh8`FA0bvtumjVi<$lB^_#Xgbb+kT?Gw{s05Om}qUkIV=cvA&* zf!wAYx68?A{kzxwscd=!_xNCvT^Rws`0@~ghaH(Kn3`ozT5&uzVPUx(F z6LkNJ>qzZ~8_u%3Fj#C`}5=gUhcuL>39cY>B$HsL_XL?LKkR;k_$OE`k}Igd4O zM7mdr!shiq3$#w5qzP^9m1@obvsb4+NBv0b;YQd^T!~L`v5m2_N?}IW8`8CV3nDMKg*@5 zwg3ECt>NMzHCD=Txo^(pcX@Qf+1FPC4Jxt6jprM$wv2hcmg=6are$id>WOC{8)Rnl zxC)1R%VnUeCs{T%Qe_H{280M;@S0YBFwpuPxlANBM@o6mswDlvYzaM=DfWS$3yo## zd#jA@XNqX@iYEdkjatqTQ>|g8oLJs+Y;puyp|48Bc(OiFgfmFTS^fTY&9Q1lP9?SF@WR z?-YDTxV_=oLW*?M*qZ4CSEOv*ybt?3;;#cFf>m~JBa&^`?cd?+hvxx-X%x!(1j>hN z&|>Xwj|W5|KDYvkuz#xFXQMVq6p_;-b>-BdjCa=xW+OlwZVVMa+8Ex@0Lo2O(-H8E zE&PtM6y|f5;Z_H|Vio3qx#H3xU2|az8TJ|p^AR8#ZW!`NdFdD1_a3QJ?^UDy{#pmC zx{Hnd)@4%RZS3CeCLTHmz29)A!M%{w`@MX({oK^6qkNMP+(yOU4ShEdQY}0Xq*rly z0HD~#-9+y0{6NpVSMCBR&+iBbplh=g%Q!}|nF5v2ZtF3~-p=MjsJIibs4^}V3&BWF zy8koRt9C3}v^)C~^RUPb@Is}zBl4~TwSRd;Ni2x*Jvc4@FyoJPG~w3>uqX#&3+;!r zmCu{hGxL^BX#4|h2$`EG#=k40{@FbH*EFTjJnZaw6eJAGMs1c>%P+3ldAP&^Xx#kl z5$|3|b+u#%SA}Xjs8^4OUtsm|2FaNo@z^c z4W^mo!X1HoA>0MTp6r%T^v?}{b zK3$XMFlGIN1#s_{v^n~8z2|b-lmoApfiv1w(snC+Ckr6TFuxuD&M8d$+&+=YB zN`aaYLGaK%_JkIoA0VrPxe}PBD#FYFc4GIv-N;2rnr8g0Y=-l~Uc4++rm=gN1a9*U?>iuMdXBpsG_7FZ_S|$@53`g z%3*}8LvJT*_xFU>08(0RvD{(ZfbW-;|NGnS+mCEWU}|=Ipyc+>;3!yXhL`ZW!xKXE zn=-(Rqvqb09%V=dtFBUMz zd=h39uCX`?3&;$G0ag0(V**^u&8tZ;`(}Ih)%_mm4rhfh@9yGYBe;^_}y*eI)E;vGqA`6ogT&} z@Oc`+!sVtFH~sqimd1ouseOEO^ywSC_eh%@Oigp8V)yW*rKTfz&|z}NN?k|!=>Ze+v1N0 zbvAMzJDOcpEzYqdvStj#3p|NkpvNR)`E`1zr`C9RHgKxI-M92f_6HL0%4H>G-Tt0T zW4g$ji|(NPAsi~>J3TKNEF+(ZoS&VY?|08@uqjbox8*y2h)7@^Z}4FIG0A%NrajX! z?^A{M<-V;|BHORa?e>eHh&SGgW#n#qmmF5@N0C;gzeFkA>oh-vRTvD-6vegPCD)RT z@|F@!=JVP+WJ;`9?cHxb56EWI^Z5~;-*IP)Ow>EvG*jT$FVSsJ{^6dUvwfFEgQmeJ z(WYNcKTh-A7aS`?CX1YQ+L+acm(?4VyZ=E6qtStp_edpb#%NES~0Xq&Z>OetrSQC(glGBw0bAifd7B{(D2< zw#Iu)PRIEcdxoI5DXhae2JcBzoq5l_aNm9gR(9@T8Cj27=S{884pJl|&K1U8oWL<$ z-P7Zoda`NR#O-U5c6b}fTtcb%IsCy^x<{WnYXpSBSak-YfN@y;%B4K+#@(jG>14<7 z1jC=|Gi+Z1eEZY2lea*nIu3M)-nm-Gj5)dRQ; zU~;GAPPaFewsK5>fz;U{aZ11d<~c`#H*erThBm;{RE$F4g)r)CwZ%l#d}^ zqotZwYZdV&5Yl*7t7pCQm1x|{dWWB4!4@xr?%|Ax;H79S=;J5Z$foVK`ZH2v`s>^9 z@VhQ!#oF8JUBg7}VkE)_mnqK|KK_o0@!{P*@oqVh**7I?KRfS^q)tC~vU&B8O|Rg> zEUtj7-RRY;>+!PJqn93aITvtNf-(Iym@U&H~Jkre?aS^Pp^UPB_+-x0&y!WP`<{`8n06z4cJ%k zXk+BFnf@OBvak0y#BY)x4+@s6jqu}yod<76%~4csty$%BMwVp838TKa-G~1tJx2<* zI!*h4W!*~y2cvbhD%LqQ#L_-ki-X2uJWB#eIWEfpZhX`!^n*#D&tmus(^M@DQNCbk z$$7n1OA`0T4K>5#v-}9ojG)v0&|e{Y9D)r)zn^t94YN0KCAY4C3@9Q==7>SJ3YPE)|SX3@@a)lsGod6|$dhjN++dMH;a)NTAUP z`Mlg2i}aTF->d>RZ@D3#SNGB1{VYE_J(aJ`FhO|A7>6%1y}6^%U&;Jf#OihzI^Lka z+oE?$-__zLk~yU_lj8WkoliVuj!WvsBTE?i0bczv93z3-9|#}5biGVT$n@g0UN49w z`&nu^T6OB@<&oY0JNmKH#u;f`9IGmj{&$EYnlVt>iD* zdL|gT6cS2qCD=+!Uwkpx3U9luL@sJ~bv)<=6+$%~KmeO$6w80~*Kby3((mlr(QuGZD9$jfVWp7r>$aWK{Y zblp_(;t|8yeDmydNrUS3uTAZ7R(czQJu7*#_WiNu(zL;KTF*Dswp?Q^Y zfnr#AnDRxh%3`|^;qn>z6x&BT^l-P8yiXEniOd?Gx3lK`BqVP8q~CeKV>`7}{AFFl z{qB#=eZIzv457v}r<2E{p70;v6MO}tIjnryiUsdO8RxDFf-kQCmtk!11?o-s~B95al|LZF-~KP_5d7-Sx@x=jYC!>JbiIUQc%J4->MgST1bH2<$Ia z($mZ6Gzu=Ja(sxQ)M_xW2^l}Hd&qRh&56*b_nm{2!)C@t&jT3+#4P!c91>HCZ$jID z(vkR#ikH!`4t5`r5h@EQ3Hn%d8;xx;DzyTw@<(JZ@Z5&|y--oHh?N22!n-efvD-ma zM+Y}2^t?zu(ztYeaXA;;?5Eskb32d2j#6s>S6_vN%GWuG&G-4R9x=!L?fFL8 zC%1dCEvm;VhBN=+92y;1@PlVE@cVHmAY8|1b(^WKsS5aNVBG-AQZh&&eSuEJe6!@f z@(cW@-);G(Wei?b$*^CsK`lU08aispc%hlN{iKWYPKR-W|+xI@s6><#FZ{{;N?&PS- zTCiqu8Fv!Lu}u4Gis{xm{rxpN9c^Ufn!dx7hxW6DQks7f41C+ zM9y$^WNUZpR!kjDHi@|Sk0&hKtyGmh;n5M_@6EF|=R|+9{g7d+$^1UYawSq5PnDrV zsM@y0F~dJ--fh3QalWEK$XZ?b+wW<=|UAAXZ zjv}jiNk3tAlhxVnaxUjHBDQ;9pLTc#g&TLq3;4t?m@sKPC_?%6-Qx)<*NI6DY5A^Y zri(*>#N3eW{ zq%trzF`%#HdL=x$^Zn%Ilf5Omp|e*n*v?!MCB-(r*Y0_avW3L&oMK)5oGjZ<7)bGF zQ~qEy#D%MB!Hy>l%SNEky*c=!va<;MQ8Y(s+$DkL{fq7IA0OjrxqLA|owInlPuR1; zwlzhCS9$7y`Lp;<+%-iZ?C7MWTY=lwB=kdA4bH|dujARo&5q)fUf^}QI>h}xc3ysgbhboq=%&e7L5F(q2}~tAs_MenPNmk!xy4X ze${{9!7Y&v3<=1;+KE#N!69+F+R${}+4Drf?A6@)km=)_SlrP3*y9P}luh-BmxnX9 z`-f;66J*>=YRohN99+~@GTfx7u60_|zT_TtakFk(6Vn4VuE%C~dJ1&zl(-0oMMQW= z>%_6r#a|m1(MLwcX%w!mGyA&)uWIwrHvMRkGZ0d`lAQWXZP}ylP)j}h^ttC_oq9wZ zd!o?4zXuQM&vDX)UJqZTYtJ|LSpBr!yLylrr!L;rx3lia_2jGd#pUgu?ABI4)sQEo z1T6C5GpCsRR4gbu1HAI*=hSQ7TKIzl4+(`Fe_CfWdLFrY4B-?T2R$~{8P3>AIwYdH z@ZPXVY+D_7VM`I>H%ZRYCk7Uv4DOQKj~^G?VZ6L{oA*kBu4ZWUv$4E`>+e;dv;?@m zJ%1(^PlJB(F`mXE10XF3D*X3*A7d6_lv(ta*`rySpx~psEp4LiVrRYh=~R%aq#4k1 z0|Nt5pQc2n^J@+bx6mv`nR zxroWM*;h5n2WYah7a5fL^lSdiBb|rT?H8zb(B>ESCNb^{#6WLO*WPh@a>~)ZHB)CH zs7`5I7TNX$d)tUI&`qnb&9#A(=5IdR^e?Q&6c)3OgIFXsI*mq86c8H+?&mJ+jOZ3-|y@M5# z)nZR1x!S5}X{+!a-S0}Hf5_iDKENi*y45Z73YV!4#fL2ojf}qg`5z&3{_eO1LK$ax%i4xNByw9PBWalA~8Y_KVRmR{uw zTlpk$TJSU~H+UWHndo6>bjK$;2wCejIxl|X8GNRyI($|Cy~F2p@@F4e_Skk~s@>m~ z(={He`e~mgqQ!>!kdF3t)!R=q^)&r9&%TuWjwmC%U9(r%c`kkCZ6(*Gnt$Qx$@}pt zWPCSAHQp(V(ZW{+ofgF<|tLjLsXl>dVTZ0?O&wzaii zah!k1JwGnh{YtFRpCK%2xbzsRRmqDFqMxY9AEp2PffkE1c8}C?ndvtbHA=x{y#XuE zOt7r8?JW0IoP@zx_7qG{_yi037Bl2|j?*@_JGl!+`L3HzG~I2D_LnKVd0Y>ooQt(F zC`+!j=;}k~*(rilM49IsfMQba~AGf>S!!UB&;9^RBuEnuo zWBqP5R+n6=G#Zy^SSt0{3QCU zPn&9@_H|cX@=hl_du8YqSKIUnmJNG9v*y{Y^=b`<7QTPAzSTDK{i)R79IrjMzO$#l zD0nRw3Zt7)aJI(iU9KcGSTm3^`_}`$UwaJIjXfc{_fU1l=yRHYcf8yrmxFO14a@e6 z!k6-Tn-MhI&5i+tug~wCOG$rdd=+D`zF=HT8sIR0|$zKd$0>L+ANoJ~?YF0W%_zS;TH4w2|=A z`)`XIOQOt?PA%b8rR8wV=MbE&Mu)$&Nh96QOEikL$`ot&>|8I~pW;wVxLj||?wbu5 zccyUl+1j$fIKL@;F<%86`6q@-*hW!Fzq8+<7x-f3;hq_+oOx zR+Mx{jP}z@^TP^c6x3&DCjBQv_xscMy_sn1I<&Vlgx*+Aw||iqeaSYKjN5bBYCiI% z1AvHz^NmHN2f(VTksoK(bv<~<0F|g550^L|&=DcyMc#DUkGdi?9zy!f(Q37(>7NSv zQ-t2Ao{aS*_NNEuDm*XLDfXoIxxQ60_FbXu8xEE9Yy%#i+qKP4a)BorrHB=&tB)9! zt4_$S$?9xQ7uGdcIikHJ4!>b@nRE%-P8t7U6=fxK`udgfehee?dh2Aw%D-_1365!N z`QPaQ!}$Ta+jqz?mP3v=ggy3N&K9s_#|CkIi0weUEcoE6ZJySV0O(4-m8QP zv@?$<)!kp2hR|$UeZ97{ICDGtd7m~P z?R_#MXNV~4*)CM9--)RC@@SOXuG41EJ~26{)C%n|#@spDZ8=7l5MBW0ED5LaP93MP zhw8PgQ_h3k&IdLfylFn)+_DEr`t}94Umr~;6S%w*iT3@foC16O$p0MefsDJCe4zQY zz%Idd;+inSt%-M&$H>~`?H=!_e3;Bn=V5(C#5P_VPQ6lcX0dEU|ER`%H3*x8E!LVZ z)&rk8aS^>N=F|Jmn#b>3z8LPP;}4b_R{I9L@Ap$EA)MN9o-mB#H92QqxBAYl%uw>i zlyjA<>SkGSso>YSbD z1*{lAg)X=qUAiZLkPrxiY<3V?;&I?a+8bF@9#|QlL13 zUDEyNJ_2F9z|Nuxk<(hX_g#(ZE54CLR61@kO}W`rm1_TVOt{EyYa!2d^~bB3bXaj;{So`AQD|paKt9gR!()|6XLS19p5>Om zIaq-VVesyi?kLHZ-dH#SrEH+uWn)4jgWDi;yi^m3%s`F@;Sy^CDE3dEc6x)6I$S+e znM6AwXMR|rulOec_`;`SnK!(0Ioag>D$&2vnCa#<8AO%31iOk%VbrASSw|a4`yeAr zWzpt6saN{H2kl--TD!jjp~fB8ubNAF{j?YK$D{6=CCD_l?R)w?D3mQ{N~)Ax-+r-9 zaQkUdtkI%gIpF#KsQSvNDzt8GLAph{k?w9pN~F6%x?~Gm~}IKQqFrCvXgFO+s^c0?9idh2O08g^+SmZ znYfoP?*WP5S4-4=Be*FSl)&Hj-(wM*UImARpZ?T%_hT$mVDI{h#kP6TYUC9Xu6@Y^kVybW<8SD+a7UucioSjn0ZX z#pX#D&!bld9miZ<0a--YyB%^uT7t6QsWq7KEFZuSx``|?vnzkmx z{!@Md!;~ByFdU?Ng4VXpjU$>c6DMYpWLip^&;p@WYTMo#Wu&wq zK6wI}CY}2s76wKsP}?C3sK6c03fN?92|aj0fjR|zEku^NaeQ2yDOhU3;%}xz17D#L zHsX_EIl##Q4j!2Bb^bo!FgG`6g+R-GSm|L<0)v$sEHlsOVdW+cnIbMA$U}%3HnO{` zoRN)H1mD9&7ZvisJog0?5>1E<`vJN`Ff9sBnuM)9T+1MEZ13JYw8{f02;HCl@+3chP@4NlJO#dG7lzwun7|A-~lrl_j|%8@-r@2 z@psc*&0qSXP>RXkNV(O$Hk{L`kIE8whMfxG-ZKG;C>Hhy2hgP&6_vBgukBx znM|Bz6uu-93BPIA%Wm`PPI#oZpeSIBxTk zV#8%$1&;p(N;W71;D!Np6iZ11AROaWJ3xC&~$I%}V%5e$~ zSjXoobbnXD%^H-UG!}ZPm-Z)Nu0E&areqrt#Uo2$F)Cxc=aEs=4T4|ml-LS-e)Hy? zg^}ME4=sGMA%%bb<9VFQ9gW-jckZuu)qqd|G&9nZdG~^7QkX7`2ohh@G%mZq;sd1w zbF>)FU#5V49>i_{&kEtK1UyYi-%|&n9vAO}IZUeW;F6RtHEcyNO$*Bh*x^jvB!=6c z%9hM+CdAEM4bobGwYgiOP!9a+JyW`Bj!{fC& zi7WIKRSq|v*oF@WCqA@Z04E>5cDUf-vr+gNaLc*{s1Slac&!osJKODswElvodr}Kc<15u7ZLnh+9-~xyxu!PxsF)X~i-RAw#E03Z$NLrMxzCptR+EPVJz z+*RxjK4}-xipt8N_))McFs@nv4eIS@+b=G;<+i_>prE3*e!I0hXc37cl`i;a93ttd zfwbG==%Ad9<@rMmd1(Os#=TwyKatiXV~7I8$Cr}5Ll$5QSMU><2tAefm)~V}fREE# z!sI`FB9@n8rtoM){~|czrB24%P&A11zDa9Z{n7S9GUV0MQcRX?CKZy5`(9V3^V9l< z6M1(fzEL0H9)6+zhsD#8V|e&>vT^v7e6Bt{rKr~`l_BbhyzW0(!1;G2p&SD&#&P-= znOPCbh2;YP3?I1^N5;nlor^(IrJSOppRmDsepyRV}{(3TAQht8fn9#V0VG4I3UKq(FHLXr&Ls zMwyJ~37hZ_k(U~k z78y?J?Fxw7`3)p4`Me~g+<;I0m@T;%+?u7wV%~5jHLLvwKmTSvVEW2Up|A`kpWS?q|S- zhhx8KkM&i+e+Bxjo9um2H!}hr>E{30WWWeq0=-b?^ReNOK7@!&n4B4Pv)&2>`Erps zd=q!AE+()(f*%H{bMPj=?qVDMJIVsuUV`s~Ow)`aX9;|@Z+HS8S*0C=r|KrgufyO9H^Y+RNG z-fK%6R%w_2zPRv7qRO}OJ;HW#b2IyNz&hREF$veSMF1BMkK3>|-_drORkECP5QiC6 zl85#Zo+{kKz0p*aRWySEkq`bz=It1lR1a~<)ZyA|%X^FGU-}3;O#~nWCy?NX{u718 z6Y}$>EvkTbrLOZwD;SHU$i5>cr0 zF2_{}Hk$o}i39u(;cK^KfUypO8TfE8cMmMWG&n<&?0#R{HKI@OZ#Y>ps z6ua(Tt9c+$~1q#Jv z@DUO^t};f>Ew?Uk_Nr!g7I(~!)5m*GQt1rsY$KtX|IH6nND#bJZM@Jq{E8DgE#xjL z8k$b-fz_=J@z0-UNj&9F zy#0f~NL4PN?&(c;@yoY;^SjCZ?$*)|{%MdC(g`cn>e?-EeHLuWeK_BpS*l~-q_{d4 z+6`k?K<7%~%frt)CdU0?^oqK1yxx~=Xz)AgicGu<#mu_Tc<-x1I=5C+^&XiWBI;9> zGMXucJ5|=vcoe?XH;kx=-Tbs$MUewKv`PPrhrD_P-VGs{LX8QqdB3SeOiGIWy4>OY zYYVY-E|bBhJ5#ULlh1oDj&Y~SBdMm@UW1y^BDr;x-f5#rAm2}VqQwbCH<2~}J{YUw z{l>JJfbSC^5G;e6lN3#B{_E?waD#C$FoJuIFBjp(LFO5M>hTUW00@uh+*g2JC^{kK zem|(FiKh}Hq*?%8JW>lumk4_bSwZOJ5jL3gEnIX5`^HAZ2LhkU=qGe43PMdfi2li?ehb;Uou{-r;!cz3TSxQ;CCHo25FAXmu z8`ilaY*tgL=BAXW9%m_%B{8Fg1oNLaO{1SQ4aLMZXksml^mR`(A#+0)4~k_LE;^9+HAXth=_mtIw&6t(qK4-pMyFz9$l56PdGA@0pC3D|NLv zs?2^%KyUscVe~{sH^8tEJw*}oP0<_`$*-59w$yS4Rj(i4pP`|PdyDd{MEo8n6-Ly( z&H(i^ke%U>@!r_xX(5}Yg}`pq=2f7R;^Rl%1cDAa$)H!__H#hKPH{!VVq0ZH@o~cp zcIeyaO5pX|K3D=IAP7<@z^fAJC(0XC+J3LzVmz+76{p7MNWEa*f<%h*@I#01ZSND+ zw=d=3nQKi$J|qT9rAK(6*cNCskw9=p^FJohMerbkcQ;Ti#a}L_9wAYO6 z)zhmg)b_Pbhxd0h>k#&T9$S%K5%7|qFyd&Q0pf`;a044aC9xwDzwyq78vSUG&XIEr zren+-_ttoWyg?%juQ7xZ;~x-+?VSRVRS)#!G)NQnlNTbG7da&3lvOF40W#UVJ#uqw zR7+!T@;2=gq8#lx^=Gv-3!o-oJBJNhI5bGuY>nL3lnsr)W>_ zlErR0D*3+N^iGLw+9Q6w)JBRv7eku_){OLndVWe^vpuQ#`j+c7 z`Rl6f7*1cPez&rUGoNvxD%J5l?E2ODo7-C1C_dJqc#LYuA|e@Yq}|5e$osh@t=VZ@ zsYjHN234ST)C(5>Vng zb0>_{J5}K(nW%fdqpwb;&FWMlLsU~s<}e~{GF`}~Asq^@r)w?bVimvh@$-9{#7C_P zhAC?$;ogDYkZ;}u1qW+dHnq?u)O4JVLS3c>YRiMj zVUJE|`=^ay!)De+f=Uydk%Ui3hs)Zq)NL?)(qM5V?6wV5BmA1fp~y{dcVy z(^D9v7YJSN9}>Iw(pw0`dw3*WhV~kM9$X5+=|HCsLCH6M=iUpFN@Q8Gz{5O8AhaI@ zeI7aBO7Zrb^=k2spoDpJ{eBe%*#n`&Xx5YFy(Y|o`HsN>frpKYpd-M{jVBjCQzzdg zyLess&lRQ1v$i$Hv#G_=W_PeUjf&WfBfm|;__%P=;`eh^k7oJdj2>OzsyRWLFDWBo zV#c$nx9dW=rHmy*%lQ_p$m$7K#=j``Ov|hLsy)%q*^6kZc*LvL1h5iv>9&PAj}POL zp?}id_mfFq$GM9#6OU|SFCX0~-Fj5esUQ1tag1yV-xJ+s5}=8goWDlcf%0Z9p5bT- zL`e*S35AwdtC!y_SS%yaDxp6yuuOXmw|c`+M*7UAUp^1(H>?my{?{oOAn-mn(~M+R z)0WyO%yr!VWpT#jhzMh&;p?e9ArPx7MO*=q+YPZUvef^`IubI=k80IJaQ0x457 zE?4pS?ql(%N0-o<^;{ygJR#Vpn^kj01U2nqLkOZLD1MHQ-9;tHgjs#KPDK7w80i$> zPP?uaM#Oda6xK!@HxEEFY`ZZqhoMk*4u~k@EA9A~-{&<}X^))Yh zCt*`5-;ltAm{ISfnHBADt4yMq@$DA7_BB`Qal5D}YMk7OLBaz0XNoe@-c`jpMk}lZ z*BorQyDpn!r97{2i9L&0hG%6=<{%K(3gj7^$yqMpOD$E zf#u&!l4r|rot#ljnL=?h5^O~WtM{LZi%8`$i|xkMQ|jOB8{XQE=nas?+(s>aFdur) zMe4K14)V6|jsCh<^QXM@sRh#^Qf8n1JG9fo>;W$Xhzt)K`|RgWcx|zk>@y}E=gWzG z9ZR8wa(6!l!y8g=(^BHd$VhK!sk@B-0r)X`>y)wa2*peU=!Mz;I^QM|oV}COXfrN} zW;F74Q!%L^!`M!>Q6{`;u74u(opNwpLXDg{`J>@2nH>HA(fE=BQ6I7<*UL+Dr|2U6 zWFwQ(`zvn^eGYH~NhJ4#k`Ej1EFfflrym3=l|KLSn|vUptk`51-8D6&HkPm#e$9UE z7emMdkQ2-mNFT*u>;|5e8we@D(8@QHl^y#0T=4NG6l=c^&?%ex!~Z_frPI|Wg+x?y z$b_V(l@FhXrJ)|}&&1nCmu6HL(Qc{!V9PJN6GGko9g}a){vic!G0*JG&b`l!_M;PXlTVM>D7?E1*?L`$xQrwd>&xM1o5XZo`egGCNiMMrSUwP zKq#=lOe?yh;}YT$2D+m&GBSX+cDkbgdyrRvhyY9o2ubYlm=!21=B7z==yI47`}o14 zr~!^Vw7#!QXw4E^k~vVz8-x%r#-S=2JbN!Yoy zhHpPO+puRN$kOKd)tI6zACIAul+LitGHBiKikdYGtkm+5^HXKGe`eKlu`fvCi3@h` zr5_3DJbE>YOqUKrPHhg|e`->PMes8?9A3cK^Ch32hPjlG1I&n5o%HVT$do^u*##b7 zO8^>tpgpLMf%@L_kj4UCo=eMa-+s6j}@THW@0`M0L(R$6;fAHGdbk?lJ&e6OMO*(FVj;nA|<+6}$3 z!$j`1sT8(*d?aEcf~@vN55{Dyb-nf_8NLg6PP6(UJ`xJL^os2ETxV_?9BAoTl~@K!})fdYOzR?!ddX*+a#9o~l& zh8783ke}l`Ta3Hj4%#}R~w}Q+GX<0Seqc~ow)Y{*PocMK13fd8}nXRy`q{T*y|Rp2b-^R@Ny-ZL8_Rxz z3OYf;>H5~p9RveFcfp|q)fObN&BFBouNXY!EFXopYa!X?fL+2lDOiS;95|QsiFIB; zblx#+8;x9FAvxSOb0Xd_^ntyTHHZ`um-%3>Y!AP*GTC2z^g781(%` z;=YeqFRdbiCN!muGjfOIzd^6ucC!(e^lYSGCg2sWmOtu{a$uWI{f+WxuMszs&V>AZ(p~} zO99HWq(zo(UuBmLN9JM*U*+kN4^nW8?r4d*G0XD*<6kIaMu#^{!1igT0{RxPa1qwM z5mxzV_3+$=5+r9O6Lwp@BJAu~cv0uDONE>QHOcP2BcBEAeefzAOo+INBRcgXk;8y{ z)|%WJigzUL^eotR{QUVdN={k{%1@5LjgxnPMPT!H6av%)sL^f8R<6EgOC0|(28ZfCZdwORsd^nnE_atI0DuJfiXZwFVlJx$r9zav<55pXwHe;HEs-B(K6`E zI^$XeU^nw=v<192NMcdt#T3tA(Gn80XPFMSl1kLw0t{vvYGGK0y@(8S`0PYn#=6cZ zDQ#X@c>B#zpJ9Xa4hCzuSBq690FV{I8Etl&e@+)|Z`gfr)i&2DIlOjY@~g01v31WP z;XF6?s;c>?B^zUA+)t(SyFWCAGh$qKxF{vORy+fX#u^H|%0}29vK?nDr;(dVlG(?m z4_GxCc63;T8FS8!-8p=%et74}eYS8tSn%r(#~DJ2C(?$heZX&8K-kus;n2&b#l zZ6&i#zn`whi|{dWXuU?ku>Cjyzg042*5d{D-*n#*E}xJNk(b_=eDjvPTzoLInRdTG z74o@i6gxf*A^eKwmR#V+gP7P<)itIpv<-fYVeho(-1bKdX`v#!}Z_|)0%*7*w!ho=FP2mGP@Aesy51qV?x+H=`#UZ2i`4S326_;ZkRFa)jYmp4MYnF!knyrjY4 zC1FSu&Z|j zkM*NoJrXe1Wb!~0I?QTw&{5QSByQX%8l!F0iI!rH9~-gsu6sftHa!KC;(TeYkP*dq zB!rD32;`*OM#13|jsGufcR&jc&FwJsEpX6csIG9zvDk4a1Qk`*kxDv1hzVy59FaqnfEI8D z&$*1{(9jUjGD1<@mTD~rCdZN#XwnUTJ9l#e7d0zhgwe-7ANedw=>Cqme^B z?#2k?5Z2249bW@Ba>0v+x}BZ1P%@IOEMnWQrQJ-m4QkX{<~leA|?2=w$9a9br)f#-VqbO|uGqb_0_3t-M3;JKyy9Q(KgAtr#aT zodx$_-WNA_hW%khEXGe+)zCvr|D>@k$J50w*-1@AIT{8uMbex&%ig_Dukb%LyC0YB zw;P1|%uwh%epWj$?A0(Xe@WQRJ~XFGtZQhjNm@1Da7miir@CG8hI+5o##)byB#X&j z%ZOdDg7bZm>7At5^iwI5j&6As?>wc<{LChH2BGay1vA19PQiDtnw!(xO|Z{Ve<}97 z|G718Rp9vCP38Z-TOi{5($r~>NZ)3=SXQ@fRCz@5;G<3Xwukq&yS^tMc3q$9M1o8- zePU#T@78Z2pUJc^`w^{5E}<+-A)fjsefn8jhXriOgW<27ED?6bh4o7!Ld@ry3^{Bb z)m8EOFY<~#%|4*CzAbyTf$yG4)4tc zb{!@y`eHmORH<8I9uT$fI+5pbzK(1f=Gn1dmf|>>LGi^@+;djT3``4=oB3sw`c?Sf zr5odvzd&C4cIPn-lW=eU+@LnQ&92sXt;4f|5V=3zKfnEO0uC+9L{69c54$A^=YtgU z67>b@ZZePD-cKG6sRb^xu~IM`$|>x5ep%KTc5L%HbgI1QQ!sPiIK=yY;@S9fHM47{ z^dk;UAB*afkCgkk0;K=nDUmS~<{Vewv}8#NO#AfeFe$8Q#3;}ALg1yRoxBM{!UMT8 zQ3tUbMurIqZk1+D+hHPYApuwWu^zVU`iX+yr_Ly?%>U<>O!+xVLo4FHI zZPuyVDBts>!k}Zl#Qrb4t%->L&eZxIpAc`h{fDJ`=b`p@<~4c+x?Lh|>m9db=9sN$ z6oLe6gZi@coDH~t;y#m3`v(i~u32QbbH``w+xh4D*Oq_7!x^RG#JVOq&0p{T^0JSx zfrGLT6Q|il(N9zS{fq8p-U%ng|icYT|Xq)|a zUPbig!?Dj9&>Jo+)HzU|i+-`9zmG;K@u|;)Au{x_S*?@TGM3(j*-`#xri6nPnisKR zW!jbCPP<*zDz{O4nO}{Rc@W>hQlgx^8d|{l_p+KUvbB7r*&f=LEl=1KCSN{l zo}zq!PkV4S=|>yL&wuCgH~75`4h_is+S}?3Jf?FR?RT^I1H}CGAd$MM)o-AS9Cmk- z_nwv|!MlU)a9~UCMCg#^ZxBj41Kkiz$>bru=Rlpx4I^IBmKEY5}rf(}<!I<@^% zFMGgd;+Tk8biYRGm*(1DbR>zw0FKhDUtc08jD=l4iZe0>{Hd-PqT!b&H8^hf6=cA&oyawLDu;DcdEI6Kf%lwPrylm17FwSSqD=q$G7XPK-G4jj&GfB4B{qyb z&*;gN?BjYV{w&NX(|WwGYlp|3Yx40=N$~BRA}YnaP7mNh?|!*mzRdA>qD{Hfv_sdC zMg#X{PU~5?c~|-TxIwLEF{jam$`UKEAU4C$EgGWmzD}jGxaIl(`bAf7JEhfX`~#F= zXKxOK9p)PDS4g=%zUO|!+(pAn^#{bfC|RP7CO@aabD2$x+#CI0u1h!H9& zR5|XNcq*!+z^Q$1?>izhUF$ufCc#h1F-An#$%T&cMJ}y~^mfoM+{@z%wJ*m`^~LI0 zTsEuwzs~>MT|d&Wx%&=k$qyf;0G-!N+IH%py4d~9pF`ye)mm@ZoWRQ*-Ns|MQlw-- zK}hlJ+tH(?r(XtNBqV5RIoeMWdSC9}I^5xS@}=t1&*&W*ZY&WO{Y&}y{o=t}!()8> zu~wU@RMTdAoAJ^w6Jfx@r1g43v;M!a_FJzc7|?O0wIX}|oCzks*uRcM6p zBg3HW=cE$Ym+Ht4rvMl0;d;>V~?}$^R0K1 z`u_Pyf4I{~+5GzT8#R2EsT+eXCzws)VDVsSuSrW|CiT&*Qwl{V;=lL+;ujitG-rxM zKK4eEeFCWO2b+r?N^)kDzfEWNm@ZfKn(5ai7}RE{`T2)dGPJUD$J}9k2`;ADiO)Dv#d!%oigiD+A2CnH7%)|LlK!Ntk~XKI*X#-nwJ`N zJH~D~7ynA&`geTl<@2<0e3bmfzqp|1~w1TF^+MbLzs70i<6Ecf$<2kJ4 zbb9Cu-bCRdwRQweRllbV%HYuW_**SY)_20-AdOweb#6%R=ix_8zXy1fgj7^Bbzhuo zombP;t~vjFsjo9fkBW@H^mI{G{k~}3CFo+Ukq$IL&uSb~|o^KKfiB)sTIlNEmvAzQkxEZq6ezi(TJEv*SdX zjL)L+qVR#oc_HIzcr6oSZ(NE{_e(l<@Ad##W`QDt2jdd}B*Z{d2Na1e6egvbd0#Nt z1WI)|L~8-ikYo&Y{irYek9*KjJY>Lu9=Oxh;8lFKt9H>1zr#1R3J6hgK#;b7fwR#> z5>u>K1VnPcB;7+v0eKq)1e%qGbuer6M(QKk5y2M38@OUXM?`RlJ{tY&Y$=W=q6(Vp zYc5Qaw0D%!Jgu2)siYykp2uo@OwBIRTQkq2BVEy*DfHx&(^svxQq0qHR`p5U;4^DA zr7k47jUMxz@#LqgbzZu|xBs5ln>)TCyBm0C{p;WJ>y-Cck5JK21B5)@u9V9v{{HUV z{Efs9<(vP;wwP0Ci3DG#@#~zLaP9UKOyfYMc|odEH&PpWZlqmN zzGnNuSRyCu;31~-T-(~jmqpw)LDzY+`nFSwV9$D|wj1RNcwcT7q7t1=l-ADPLOsaFZ3m9nwB`LF#escL$=cx6+heWOqQ@F!wj|a_r?zuuKv(DsNVe4pKNII z&9Y-+(dy(}*+?fw7!5tCB#evuDrVIlPZ0Zs->+ZK46gyt1$F-pMA$>-Ctx%40F{TL z7DY&do3;c55d-5L6%9=mc<@1ZA9Jc^LeIfY4yzwpNZOU*R^=Xx_`u>raam;Fe6 zBfZzDvCYvJt_|43N|?R^aKNBUd*|KHkE^iPh3$hSX%2;?0eG4NA^314i2oofx*}qPbpj=BzrV9I8p); z%FAn6>$1#mKp_q(KL9irq^AoO=|WNh_)}iN{unmU!H-x0slq3-&+q{?$IXuLLm=M+ zWP%}e`i}u5qKdKgjLwzXVg6nJY${fgLi6|I;sbh>h2MQsLyk2Qw%xaNipM_-W>9QB zBI!N6GQ7>IaaT5V=SxNk4h7M>hgh)-RN`KB#&=G?=BG$TJh?s^VzK?M5fa+O_nF}I zaV-mT@v{*bjo`sDQnIJtY@9J+N&+Zuckh9*NB=8V>ZRo(yqTrGA(*_vz6UhdP5ckg5{I)5yf1pWPC z0Dzq3BH+ca!o}sSqKoK}f$gk>)WUT)|1N{lo zB9;xuk{9m}I=W9;dCK9A~AMMd5=aOy@?;Gq3t+1?aO3OJy4AtmxH^a9``=>FERzJk)$k^3-J* zy-K4)Rh3Yi((Lx@NS)Zym~!eZEp)cs#eCg$y!3CX29s1W({#C9DLzV@^GVT7hS6(- zrO%w=2pXoY$&I_WlB1sqTh!OL*TsAesLE5^m#4h>=d$6g8?Rlg3Y`Y|elPMTp;itt zi1;`T$TC8td#qo;MF|TFgB-@b!$$!1$UKE`lLjEUR%ancU^T(gv=bclnLI1&ChY!z zJ6=oh5o@0_5aL&?>c+E0@SjDcLs10N2h#7u10Ilp03HMQH`WoT6F71oFWF4*Z`k+D z$S&r4z^!i&{QHb72;Lu{M!@m~*B+b<4MdGwY;&7jU-V{VJ$eE$P{2nG#Had`WKGPHqa~T?P@Yl zL|9%;?B&9HFl^K_{=M9|*Ua-W|roC8}_mP zlxL^Q#jCjc0mFU{r+a6TCssKF$tdBcxl8>HwPV#^y17el%;%XM*_-$yTWeH!;O--f zdz!P*(<7zOlJ=v)yI=sB3tZkUAbPsGx`Hz3IlBThGywR(`ZhmR&}HfP;$&+YJ5hih zUR|``?AnDGEi1NTX%F8$OEr)H+1&m^u65)kvrps_-d}HER@e^ScmdpP1heS$A$%3v z1#b}rG2|vXA_?3R5yK382!cxlBv|kzr3q&%>dP^RdU}5)&3)QE1rEyJR0Ffk^W|=M z7T4jbk_nqilhKH1&^!Et1tf+Ijl?2^XS^)6|d3 za7t&Rq8NH+<42}X9<)t64;2%9;M@%>Hpa3qu@t*g(#Xg#m*{G|q(VMVp`%d1*eTrb z=8;YwSGIj{f0G&D}Zo@-xYkqHL%$WvMuBfP}+lwG* zBQO%D9OZe~rVBL*q;VHe9-(c(#Ks;=pzi~FS!lNgI3V!LMCYBfv~+M;pb#}<#twLZ zKj7Rh@dEuGl-D!DeP_6Fmye&5aFw&2f_tQa*^Js4YVLk{SCBRsJjAc zn-33nPkU`q2EO_agJKWJ*t4*LhTR!FwA50?7KnVF?fXd8-ffRRmmAc$wl#w&YBIw8 z)qq4AtAD}tWqrzr%2;^VQ<-CTv%CUvlhfnK)9`Jaght2LN;^dd3VP#R z=+&#l+nCG3Gs6|Lg^TSt5(^u@zRDy+d1SEDlC#fHwPLcZbmN{lUrbYm{dUNYhb)q_ zW(5)=6}KQZEOq!-wAxenX;l0$i}3~dd^A2$Ov&Wux4IL3b+Tg0kypWHZ!DG zP=<_A-D?1;UKv|jT7ulIL#APe?1?&}!WIr_#}FD3d=BrShr(37Td|-WBA}+uWznGN z6ahlIv0806F!|{1S{%vuId59${jaD25`(}}RYf~Adki6WoqdYJZ2`Q_0*R~B`_BW= zj=*Hbc8o-4>}w>VO;GKFX5=1hr|CZg!ehUp(qg$`hk=Pn|F4Q(NKm2XF(fH!6u-^H zoYJD^zkxPgjHwQMQ!PIZLP7AxP^rzzRHVRlwb9+hpZj%Ii8 zmG3H*S4=*>)_%Zl??e_gBWzp#RKNEXG3~^*faisM{hM3ce6=h^E|zkoL0&&M(Mf9t zKDK2OQGUtg=B4A*IX6y4u8;EdX(9Ds%Ljobh!NhxCk>9dK*9m-PN*&jmR+FLu}p7n7GYh4Wu|mC9f}Oasr+~jY`bOXmlXD~(Qay!rSOT= zOP}pdKsFcz(@eq+Sv8aY{@g6DV#WLlOm5@?cG6GtANK?xJWRb)dCY0>kX~Tlo98`6 z*l)41VNxBzpF(~+|JzHc-=*+7NbZw;WyEk6bx+6fk8g7%uUg{FIGX-22ULBg9X?tr>ThAE>B9j$SjGSU5r`Uo zJ+5NxpRj_Ns{QbwH_{ik`0fa0Jg;?etWdF4uWgv&Ze5SO)>NE!9Xk61WscuQ80rfv zBzJ|1B!5H}1UwnzqX}qeBv4nw&CD&!WLdDU)UQb){7_{RS9~xN?nFUw5F@R@Ri@5= z>VIm!_e?!(DcL2@Ks_$zZo50G3(?UEdxN`~$6_u+iR6?nUak}WVkT%kff;fPYBZD) zgf#(3Dq-XU>DUosrm#?iZW7xLtSeWbGi4q@k|nU=Zg~$gWY{qzOQ9*6bz(PwGfI#d zWG-Y+AkrV9pK|%wk@*eCcK+J*97kjb|-t*co z5KFb!?jH~U3T|f0t}ii~LJY>x0F3f3pnpK9KnQ}`&cM!kTjQJ^{p z|A_Q_w5@r2PK+q@*xogAfJ>pTz zt7Q>UQew}d$>TXi`r#bui6)33cjqR<+II;A z=``bayD5>>Y3(R1uJR#M(&||BU-$uyEH+oVO&V#z+b2yXtc|0>KbjB9rM>eF4enzd z%$jDnX&$n&SCW=4*}a~^;M#u49B+Grx-~cRP2Sg3y*kzJhoX3NviweabtAr_MDJ9e zpp)ahAN;M;?Q`PCH-Zql)v!AFjD)})em-&lbW-q zfVJe6Y>0OGOsrX#oC()t7g@2Lk{MR&I|n~-{#|qngcsOOKcLasVV9hzf~V-ah~g>? zxuHL#0xw&@F97nVU?k~zcp67OEP(bg9%62ync(*O@1z>w%tJ)jHSDet0jtHx&&JZY zz_&MQGXbPz4r3}X)j<3dz8xNz2wOf!Z9Dc)9foTdGIrjKmaQJ4ds!3fLY(v*M-hb@@#De}E}uC?&lHJ7K@ zD*JU_ad>nr{;Bx5yn=*aF?X@?(%9p7FdLrbi0YkT41kQ4&3v@^8PP<*WBGyiKRS-nysU?}VY7QsfbP?DoP(7_^wLK8-0BGZ+ccx6VKZp;I(Az8b{rq$#eYfc4$E70^u~Mc z{Z==K*{5*#9#!q&R(;B?Jn5>Ss61ZhJ5&}W=J?EMd@3~BC$B|}kC`N|O5=`a=3RW` zXGu7|ST<96z$X4o*V5P5XSwhWB;)_zw({gg#YOKV*|3A=w0G=%-e!f*m8c35ruE!a zXt#f`5s#OWjH#-n2n%%R$M$nh#l4*w$~r^662I{nCm~eU;lY^Ue*!XY4s-B3b>@F z-C-mt#up$_<$W@2`p^#R^<2r|(nG#?HEoMz&Xt)D-&8*7=WrI9_c3x(9F@t;AT)ky zrY*3h^@)u2w#N9jd%3fm(zMLGZH0}|p2(EnM%vBVe%`-E`MEx<>_kUDIMv0lQ7>~6 z>Ohxt#88zod{;Tco4YbAt|cGTCT$0X5Hy-gF-?URh4RJnAsp>rwY6PLWMz?ODH!bT z4wHB9JWVfm3qCW+$hjz{(eudbYcaT&L!f#Gw(EQ zbkf^ zoRgR^Yx;`ngmHJnt?VCP6CV&g7}b7~GE4t~JNvn65xRGx!!5c&O_|@up3~%V zA+PVJ#zRGO!F#?`n$rJw33+h;{`vXy{2c8CB^en859Au5jcre4r%Re#K_UiZHbWs# z+9N;KaK8hy3-IYb)#H0WR)8MBLmz{#11jdTp7;G~zXt#jbY-nIMxaqIRV84leCupy zHZvMF$GyWhY>90%;WMzQt6 z%3kG^7q-nccc8mX9qZh4;< zbcr~0teh(K)~ZdBWt0SVBpV%(-pttd#}e@H#A*b;T1cDG(xlVttKD37wf8u|^d5){ zqer*T%}7aMG?l$NT6rSJ+s^e$Lo$QA&ahDTFfXyftkLg*hPi1|yfH--$t1^7o8R}8 zfz=^7KCYsSf8HF#9vkhr5FRYQAM*y7r%PUbTJ`^60sX)qT4jUADd-gS3%qxLATd2T z7rRdcWLG*n!&W}s*BU#Ic<2Wg^yF(DI|TS%J{Hb0<;z-P`n{$=nl;|T_8i}CFpTVW z8avUQXE6lhs%&1iSZucp=B?F3rp9eJY%|cgvKt)(3mSeddZg(}CS~ENQ8iQXPsN=a zI9W6lw9yl0-70aOn2W*se66n>dg&jo$`gn3n@xasyt4xUfAG|ad%XC=Cgmo`2wqBb19SQ~B{kGn9 z&#FHfxMb)kD3H;;57>meEr411v4HmL)|lmrfOo?=!19vMzGJM^4U?(+Ld*fe#iY@R z*z_adVS6LVL*Ea>xHpn|H>Xiko_<+Sb4CQsN9=*?N$)@n2wec5j^S(s;m_k=r?#aZ z02G1I@fJO5R7FKe;_I<7w-Weh;itl_mIKUrQ~n~;47y+d|ECpU?9C5d2!xW`5Cje< zEq^z>LuWVZE&bF0<6_m7@+;k{>e+H98FW?ac#n-~}G6I&d zq=(l@k0||ugH6+(8+?U5LH~5^%CuLWh>DuQL?mw*?7w(N=V@3G6@`dIL?P5>4 zNxS6oH~FE;dU@OE){^&8wpl? z9s0Z*$Hw%V<4t34hSRBD_SCwUkDLFycbD6Rw7Pf+%pslO=8u#KlU+PcPE7S#R=&Rc zMA(oW>twl{@_FdbrDff-FM!Hb#fs6k|8*Xgv(40KIA*+mX?+tZ^7T4 z?fmzu#Lzp$sR|16`XFyHY3m_>>^3|&& zYleTrN^Hwkw>m_4c8s9${|^0Kj&Bl5te0E=63$!T3gBz}eOABZ+foBDfvwjncYBZq zP_CzT0`W5qkv@n{ELq*=_v66Gg$JhGuZ(ex$&d&*Uv2mReir%TX8PqgLb zQEXnosr$-?LCV(G$JSR@+}9`9(XXNM*H|0{29X|#ABkTpi68&o8_(ic^~5E8 zH5-&ZO|hPX;y$g1CVHPnc?Je^3H2GQA~wzM@Sk)nw4J|{4U(;tou2Uoao3$L@(a8C z@ADVRZZ)6!*ZL^ub3LdP0AU5#6wkYNnE)#RXrM3JjsXDpKpIjNV=DwKD}?qlA^B zi3Zd_t~~&p%-<_G0n}QkJUD#YchwNuGx-WXfi>E@_n`z3IK;#+AhK`PSDQC`ZYoqD z4ZL-}{lQ1H>Xr2gDVgdF;0Xi?@gYG$euvOrZ?`#^nWO8W!hv<;>??$~$tepCjQs!% zDpkyZ4@aR#*!=?Fv1NYKl{x;VH{3xkB&@8};ICd?ToVfQkSWut#9UmYI+Ya^D_`5# zi23N_T~8NEfQ!fm(kdLlL&JK9bkYNAE9lRV*z^LwEC6jD;PppugsR47`O&G@{Is2a zDKawTC?c7L(FZ`Iu7`YrE9Ad`HKC|hF3wHl8+`8|nJ4IW%Y34iLHoH#itUN6ST5fP zM^!lQN}DHwq8CS7tkR4`BDkt!Iy-lYzJMeR7PYH_ZQ*D)C_gVZ?A7+!;(U1$XxIsICeBN^bIt$e9tJ)L>xATh%m0D zoYK+~D&F{J=qyVqaq=;EDSNYMfP&W8tneQhfiS^GEWef40O=r$M3i0!un8PHXm;V- z5C*E=7-Ot)WcTR%C8<1r!bBP-cm^So%I2c78uhT(UIX0iVqYez}Jaw;R<%e9}`lCI=FSK~n)na!SWj%wht6HYx z1=?t^rEw7rMBBpenQY9{!&RdJFM>nEDTV{b@cIUk%mwd9?Btt$PO5@i02sBq1Y`yh zxdohRfqgf?c)kEU5ik(1sFpz@>U$R_Qt!e%!{viZ=KqLj)_9>tWZ`w@XnCLxSvW3a(Vczn9@LgVV2L-Wk zSW5S$WNtSJZGv9KS%Mr5sY#i1b1|Yyx}}*ic=Gyir?rr`w~`!=<6oxe!`d`s2=U>n81 z*nU5P%umtpwL_*9t0#aMC~AQ$+gVOM7Y6U#U-wcDClGT5v0n@R41m<%_;ETPex5KN zR|D@Dh{3XY598+kaBU@@B*H#(s@8B(0aOwp-1Zt;AuGVF^96W={AJMOlNd+AZ(P{h zt^l>oJA3aPz&rS#69L1WBJ=@39Q_3W=`uid0_IQ3klzX(Eq1a@HWVatjchtBCPm^!5IJ)zqzgLqXhov zU&YXW0?hPkooRObr)@cTH=td@%#&f^Ht;(QXZl2Ps3Dmwnr>@LVFoAdw=s^2$ot2e zNtyPhNPLpw3zE2|?8%=Qkuu<5%#gJ|L|mfC3d>s-G}2KnGRnpNSPU>nZff>Szt428 z>5egQ+G>Qvn>@2s5##Wtw7gJ|K;H2_itsKt?wBym4?!?s30HEN9=6TBSF&wIa@G;E z3Ve@MM60)$W-jd~S#|nmURs`R2(>-zdHhQbKeTp-V3nfNg^U|3_eh-uw9+Fw2`2esGO112}&S_^fC^E8^2O>H!wY9&Uhdis<+*sLOZP=bk$iFw`9P8^ALcqqkapdVDd38YSFyo)%jN~=pug!HudpvI*JzdGv{U5Vr z-+De%%vm}={G4^=*^uDLw}Yf#`9>9xIy$EZxZNBtq;SKyf2|X}nZRN)$0?e-R+~4UG#v0}2=3>))td&kBeJQS zsNQ?$3GztjLmKJch&Y-+)cEBb%lkun^M|p{4kZiJyO~-}v|BIakxoZDupqg5StGhS z`*(`G?recjYC0{d0261hgC~&Id?5oHQ}e@sTmaoDBAK5Q{LBUD&w~$Ex1-VA>R->Br$-}-cQu2f~pEY(5y_yXnHJqR?1@k78{ia{w- zZuSxY_E5R9Y4B*!r9MF45nW>QKf}R*7wH=t+(jHfj=k!7^#(>Z>mFf8(%K#Eu& z{pC>*>T82!Iv?vp#-EWa5l-g4q@vZhPB=yMkfCn5a(?om!b$ zPxH*LiHE@BrS`P#dP{>no}3mqwhLxFoLtg1jxC_LT)kP5#J$CZ${XNgxYb9gJRLx2 z!$_;b>@qn69ej80DhHM$q(9~%%UB?r=dCTu#NXU(979*Qwt%&p_tnVGD)@08uMyi* zSswL+zXL!7khS>iy^+Mo6GP)m06su$dz&iu=5IivrS#^>>_{tcRvsnlGSm< zL9N3_rJcG7Z5&*n=V&w)fv%G;>0Mz;^|pG?x^%(Q)d|7(BZgl#z!Cd$RO8^ca_}W- zt&Ofa%*?$KbZAq79?ALx9YZZU)?uEpUm7{OS4@l}laB_sND4kZ&?JS#g+4C-yBeYu zmHpByib7tpw#RYsDX|F69QHQubDQT`V_U*|4=9*JEv1BzfT)aC!j(*ELDxwJrOeh# zE!!_A)|*M=4WE9R#ZaCf1v!`;tyG2mf+gwkH={(BBQpOmioBElo+-D@c2Fs+=M4g( zX+2SZ8=)FcHxZ&$gV~Bzq_RZ}%0%ot4xRZSnE4!B<)mU_nDsRLRERllEl0Ct9=1Mbc()gQ>t#{`{rM%%g54Rnco&ruKV`# zRg6J@LBq6UUYV{Ww^^wDUZfaR1q>Pxca?#S^er+hO1((BG-c(l?G>yB;PtBe+Sfu0 zqTB)q2g?<}S|dsyXu;l?Syau{yG*O1z0!k6)B&;URC{f$8cwq07Vy$08ATLwgqVTHp^^gv!1d( zgDv&yXZg*)1DHzD^bIr6G*GJ)V*D_Hlp!pAkSctQ)CkbIcL_srAH+6o$Q#D8p<;F* zpx?flNo6t+C1vNVLMh9sokupZ0VQW z!p>Q1JiZZEu9sflOXG*nEuO`ydoW~ay4h*G;bC&+KN9O*`$~Ea!`**SeNV_>V6~K! zB$dMpn}YuygVBkuD;}ar3yS@wLYK%W^rubEtrBLDr(7sG<5*B{!CUMv%LnqsOpQvj zvY=2ZN3~OV-J(ao|T35)sOaM?K{=p^ZWJO>A5=OU9 zG8qAvI6DV!&=tw!{-PV}tS}iP($UEhg0dqApywzpL>^GC?Ef|Ynam7u}p`bs&CJ>E}QvsGnY#r^rEgJB90Hp%F_D@tfaJlb_Ic^ zEhCJD5(vZmlFPv+e`ynQGePMqhE3gu??^xkh~Zu4V-aZr&H!b+9Gmw9eBRL1I0-2e+H7hCqHtP!(2cdX zw}TD`Aj>bHNm)z+Hbj`xOsq)y$^AN-nqC|kj@K;p0h#Qt5-^&0@eM`4L>`9^J6MP66>LKRb)9==u|6;^jyiI`44i6 zvdJ_KXWDz~{#7dq7c(*U4g;NbQ)601#bvSC+v>SmV(I=WB>QfH(#7MziyBr#;;S?+ z<`q+pMt?ze6!mYm(H>$i6x;^G=Q594s|Lqs%lP8Clxpjlni#RRPH`>d9K%3j(>>F~7M+_w@6lvZEIQN8dMNnRy0Mg?7%FsR=?Tv-5F z>d^8}mkiY-?lYpUGVL_}y9KW%XWtrXg<8*_sz(;=rt9_Y5x15t4~~u9A~ETsPO)!X zXlB*7QYP&%5osL{3z7G;!{HW2!AYu&iD-=-fDx53ro^!mH^^ROFQih1*uzCNxR^3^ z&psGJeYPUVx!~GuqPn+l@tP()+?7D8sm&iE&}jJ#Kq2Z#7#SEMZu;L?gxD5UT*my4 zUX1I!C~~jVEyKdW4*s51#f^Y_ys&FJ`Vw= zAejjEjXTiGWhx0a13)pZAK^B6I`I0g7l7EQ+RwTEpeKj-^^N%Yb+zDT&FHV2X^Ke# z^uj?}bTjF@Oi(r;-?#%m1Kt2J;Lqgg`Ah4AC)-ETgPHPjMpD<$vpI04BkktKsytC$ zniGFb#^iXl^X0RE7zhQM+(SYMCWo>vBl0b$>4-IuM_61Z!J15F35Ng?NEGWZ=%|$x z?+D;c|3mS*Nh{*Mw(=dAV~;pm@#1;po~_cHDeJiS?bXy(x#M|Na-;Whza>TK&5dDh zJn|!^PsC&(y+yC+djGeEbRimlNkTw`>wzZf8i)w8n$4Dpx12*hS$cXH#>HYNE48@{ z(soLzo~^#msDq(?!%aeOz0;O*j~K<>;&L;(Q07FdReU?Hpu61Qbdh(`=7odF<~+z+ z5_Zz|ygzbt@55vV4{M=-5P`$u{rSb^gKEigwv`8tUeb<8Vis%Hl|D)%49G$)ukS zI$hL8A+QrLvgmy(PT{(fo!N}4%Zh_LvW`1L57h@`^#!pNU1+;Un7bQsOyl^C-Z%*; zDgFBE=z;GKFg#39<$EWG^uweWi{B)W3h=w%-TfjxsRBDkdw&Ihe>;t8s1z{TdC6B~ z`pSXbs%bP@2f(yv{q<)dx^`sQY*B>F__!0kR8&S`kvGlYMff#e;*>u|8P-1?Zb7 z_H(9nB8Wc{U7OoL`bebXH8CtlM96jUj&#*`g9Ht=(UheB+OUh(z<6zi?U?f^+Nhjj zr;aT~|C^{0HyNyk+s29%`*RD9wBrE0N~Q6bdYjRMB4*L4uz>K&w|aUCkl$yublxM+ zd|Gv;(OmV-7$q*dzJ4~?2;Q`*&+|oUOT$Uj>w%0|WyJmaITr2Z!|VV!O! zU#U$cq;%ZL))p4E*d+9ik(Z}e)mA_CmT$b<>AU@%f)$sOshbu*;Z>s}cSK9}g<-Rg z{=Tg~C&xJmJ0I^4i_nY)7jO!6%9vtUpf2i7ewQ_31+qfr$Wl{A^L?t>+6`Rt?A?1Rn~~Ic^6uRfH%rbbYO|#Z4G%3m ziz~v{3-cD)OQXuJClq-&>pS@CV&dhx(n9ONEYs1_KQ(Q(^n}F7m$UYBN$qXmWRQ@Q z-&iYuAb&i}j&A^vrn1lO02Pwo4@ly9kOsTa7a7nB_Rq+~C5VZMiKL1sLMiPV;ZFNc zA)pp=B;)Kc^WJjT10{9}yVYMr2?#@3jE7w}dJ##>Ap1YGLyJrA;=SdRt9e@*-#>Kr zBeqx|Ujew2qKtdui}uVwZ<6_)1&IIMcmwcI%{>swu5$C4(82wK1vG*C00!T0-@iYB z?UC*Yz?1wcY6bfvgE87bAMY`qDcH;i!dpPWW}m#=jOG_ym4RGAG=4NY-ZRNB=zP&Ywg-Fzor5dqV!}5RyjE!GPa!yeM+QcWN-9k$beOA1D*SEUw+M z?4)Jc60fRK#*efpjffv%FzPh?sfjWoi2#B&&qHGSY5k@IYhg6pN|8ypp)&HU+_e73 z;d#U9tJ7CDC$EU3DaNTfM2UK-x_Q4zRW9h=Q^j$FV{{%`oSoHDkTWlYL+EpNeMC5h?5;uUJH@ckYNJ~qD6*!PZLc2ZpUafQyKqI|Z zMMaPJseifq(KP%?c2=lt7Qo~JHN%=)5*G-NS^aQpcUAm}psOhb{~R4n0{%1MeV#8eNTEz1np{)^>us8opW?EbLqJ*-ERhh_dZL-G2HWL6#~UtuZ@_h$NV+B(nms zD`2$is5Qwxc zmU*lLqS+hk2KwldMp9x#$i`K3F_y!|CSb)(={&VP$oEAP_+sf-xGOL)_`e%?{pJbi zo&jaM+Q#rVNkx%}{qG6Nk;FVtE#LWbL}TzG@tXuFs?>qWTC~s?Nde9B-!X$CpI1@; z>8ec>FIQ$^{eQ8M579EbP7s>eO^(Ja^yD&l1|AaZk1ZmyuS!lAE(gA3wB4I|t6JwM z^-Nz`?6X=g1IHB+b{Eu{vacQo>}LEgdBn&^OPF>?c&Sq#z9*lb59_I)EVt&U1YER$ zSWzHeAm1_^BSG|jj4cop+)Eu|F@eK>x^f}wmF4x`JiYzV1!7Kl4>G==dk=QQ+H~~s zkH(pZVw-<+6R8rra@ufos&=qsV!))r%(sh-UhCwNfl-LG|M3{GSLrCx(MT!B$8+Wio!_UtT%;$nKnm|K?M~a*I$zx(6@ge{h})4#74?n%quNVU8oAWvN&0G~;^9@Z3*d9q7$D_$TTxnD}5p zW>M~U%PXc;Dqrl=G+DB13dl!kh&x*^zmFjI$s$$6ieUR-6Qm2m){Sk&-COIF8@?4K zFjP>?H5W&RFVtCxX<1s{(M%<|dP^gGo-*t4^=$_WVstQK6^ceeLPBLa4T~i^Dc$Pb zgGZlfENszT7eih?ewqr`Kt|1tNW*2SP(ZiTWR6UJ|JJPvB&A`0?G9 z>2ABWV~Et~{{vwIvm{={6o`4cMgAF!x#QXArHecn|0Cd%QNiUd7_xjmZTGc!%6QZ!TTst%7ujYoiXf9>00Am(L%Jz1dP zbN~eta=6@jG&!)b^1{4xS+KF<$f)r z-2546Xc2t-;JH}+_MglA7Xmv2BeJ=gQg?D^bY#FbkrikVSMQpB2nz}%#7^)bA6%FR z#Q)(A6uUVZooCJyEM_8#9gHEC7Yz?ZH6)>OnP_lndvG~vUdovY=zrKMR3>Iz53|d7 ztAIw=zgB*gT$6gWLC#QA!bGx-AjA>Ae%Wd0so+@y$Bb= z_O9}}kMPImLbA5@BdHwshbC-DpS zI_~+ay|f&zH?ZI`8<#2Zb2g&@w?ZYJ;5@aNw&;koCIFv24!!zSq!V^iTnv2K_&?p&$`*vXda~Zz+@3mO{TUjB438 z8t+wcmUmR-$H0}oCN3%FfMw_qTY1|yovHHh`e)w(lJc{jzR(+zpf?Gj%1EjzG_YAY z(lWDxp-BSD^BA5)PRGdyHYKDK-PM$ASnv!vU5VARnV02EdwOaag4FY&Da!biJc`9d zq1J|zWFBeRG=aM!g<;NGfmTi2-x}ptBJ3qc6cyyVDoTx|^Ft^q#hsf(vc|(0m(~j_ zpRM(b4KgDn;3#J2et>V7|=`5RJ;~j1EZf7@5Puv><{Z#9M`kZq#nzC9hc}4g7y3 z{kdVsCs?oxAesP?Tx7DXprKE;?rxu%($qTDRz&bJ^xYav7v9e%LoPpqiI(a#hqDCO zMurKl)d|1PR}v%)JD?n3*8C(PI-xntxj+5lggm7$-@{M9h5Hrln}v9yU`@W3aVZb= z80#TylaXR58U5@MrW2;zp`BHpL1LJ_+EKlv&zfi8L!!Pmw;ib{E5er0y~&Ij$E1*P zZho46c298rgl&Ggu+Kq3%UK7b6Olh0ygEoYCRkr6ch6oc{nGt|eI9krs@Z(sFeGNy zBrwwz{IlWvw`lH|Bh{T;M@uh$pGC02P29QNj$#zLK7w= zcPC+DY%$Kw)B)MMJJs$Q+Bt`B6e6}0iqh3Fu}WPrD#H1kW+Cev3lWb{jkBLA^fhea zYw{K8<|h^W_D99Srziry^?gfU%wkqa+Otj35|Bb2wMlD(QOKAsZX@m*CboQ`49N6q@R?>73Fr zjkiI@-PLqnY`H6jxL$NXGn_Y^F6B}x){DZ$BevC?G!XNOEc5>{Ae#gJsN=BbT0b{^ zog)IAL!;p|3Z#bh)z}`SAtUpGge=aoMinxoF>FO7hK6E<5Z1CqRAQBBqr0NgvL&2$ zgs$?ak>*_elY_B@o!9~fFZbgMkdF)#GYM+?&9V@dGGUqU{bA7NjmRs-u7WK3w5IGZ zm`L1bz1r4m6!B1W8O7R^+k|J)JeYb}SCTybwO^uZD`Nm5coN;`;&p%0TCRUgIeCYsO} zbRx-Jd&CYJG3~jPNLXCHrC@pd4rg+z9WejJ;?PZ8gsUmd#zdjv zSha@aQn@m0_I?s&=9shp2UM~>3|;SGn8ICfQ+l$6W!Ly`+5brH!4YPF9wU7-PjNp9 zO<91yc#N5Xs>qZ-AV{E?s34pSHD%J&-$geV} z^j?)PuRGG~O}9IA(qOTY9h{0=b;anky_g`Au;q6Qv}5IWu1ESZ4~C9(wjG&|OG9%L zdQi-@39pt78e1swlKDDPp#JOiffRf;C_W!_6Zswx?^%sUv9I$9p3%i_Ttt&|JZ{M0 zo9FbA0%=HrUJZwsls!r{ZBoxh5D@c*1x&jeXz8H2Q z|LX+u?(9NVCnC?&c5}qt$1Mk6)2Z|9Vu!Ys#gMK%pqd;Vb!OY(7ib*dnqk750(Zv$dX_<}C|Iu8RJ?3xVw@M@IUaZ$jgj^K<8!CP zBOHK?0;=cNEyVDVVCW8=HpRbi_eeW_=u{;ebG;$awEyVElhVPhY=?89n@;H#PzgA zs?NN}%@wlS3i6rz^qi3fM|!lr8E=yh2I(nbpKFH)I9Jh<{O@l(^T@%K85$<8xZ|r- zk(=_~Oh5azHilx|M%H#8cdvj9^CKGFX%e+)JXdoKOeI%|KB+KUnN-i4nJevBmNi|b z&~JjB%-VJPOk<4ZpQq*ue2|%X|39nI3TEy4T%0i4A`YgrK&qkNaC$kEa46B>dUXmV z;nlo-`TQ11Z7M_BE!(_E`m3c=zqwZgQm&@Fth#@s!jpWWGwsyd0^CV^p zBrR+d#E^xgii}OYbaA;e+Qn%FF>ytDVW&P818VeW?xw+$!$!g*ugLLVSjaPuxx6TH6a6shljRBl9D)>^AKxX*(`|-u$oAB=TGZYs$g- zwk&4bY4@YKcV-x$K5fY#-Yo7mvuw(Op_XL+srY$=!U)6t!htIpMPc%_S$V}tCw z94A@fHD$U6qNF>V%TVTS2~>WPFS);{?LOM;JJYk~D88J{y4?>R%D}J_wz#fsw~(i# zfmn#Q74GWiAx8O{G%E*ALuwzQQ~uKsz^-F`61b?B+uy9b#C6&t-LFVC80Ztkcg!kP za9a~FIubO(70muF@Le$X&r2+1tG<{rLugHH!A3ZaQmu?=HuM}fw1`SlF-xqzW68Z@ zXroc5RQ7`FA6K*wbj2*DI8_y-XPLqktqZ%_=p{CXGI=*WpP;nOEUq+obeJ{*{moJ< z?~+1YIAdOb);;ss7^R-oM4z|bHop|RhSCoAgG?Z|^)83i-X)s{Ffw{UWjt`8d_>}1 zr8+C=jmy2V`0w33JDK@!zQ)kFC6YRY2%@S_Rit@@Wl%k0X?RAm+BxpwxjmJy6V@}f zM8>~`UGYX-yHR}l(b>(!A`rw8EXT&VOqs=o{!(&^6jdJQMXg;SSSQE>1H~=7nBpE=bt+cy|O194iw6cJ^h*g z9A0qx?s!2#lQCS~I*MtlSM_{pY2OUV+d1-odqi0O`ge#T0tfo)GL^52)IE|C#f1>4*}l`|G-`;*Y-ZUg z;k;sT&M&sw#Xzv&jip{zIgfH)M~N=ng>-2VEKL+JwLz&{_* zuP^sy6h<+Io1CKJPh-oZw#*ILirc*;4YSQ8ZF-q|MRU%%@ep=AlY^A_F*cB~wK$46kz`x((nBhbDjO1gWY> z8Nx~IG;{QiQN6ba_Ecw?{GgQYb1+|*O+>%q0QB!r4}X;!ZRP|^Oy_=88JA)ieE!MX8n5* zI`Tl}5<9|iqXzGhBm?{rh?LffV$3>*{{R!h+K8%o@xL8NN5<#_+ za&eY+i4x`8@d7oHgb*^v_KLFhdR8`Q-^_cE!W9->pw8U2=usk+zF7YQ(kG zsHu53s2AkpJ?qvfuEt`0jFm06~`7i}f;Qt#ia_yZ5h;95kSp30)&$v&9npg~5ZJme-C$ zVUC9(v#7URjYBnb$%BaS(qNu$VyVi^hfp*DCnis{IXr2rmbYA>6{KLm%f4lHy9G2&(P>BV zk~B`zV`C*B*Vt^wV5e2yReFtA-uotfP;`u)8e-0O8oAFwz!*!S@QQlbJE&75=6&cY z)Sfxv2O|}gu)ILYx?6;9115Tce8m^g1+;p%ggzv-HRhailzle5OOJ_po>M1Pi@!-$ zq0@cm5tpSz%=;~*W$sVj0$b@y8cbyHs19PGyW+{V{P|gP&A-hUFty$Bq77CAQ98hvV5Q18zTjRoqFl}=0LT&t$g>&6I7vG9m5FYJ*I0`?9T@}sAQ4#2)) z!XbCXdJK_Du%1*{Hc9ZsiYm)>VaD7bYuq`-2uMbd9*UBOkE)ll6LetcJFSwvUWJ2(x>n zgpa9U-*Hpo%gLHnlF)wa@Qy_d{er`KNx_f+kH1{%pF9fXRWpL?j5Zy+)5v2F>Qugo z+_4p2+qL@-8IRo?hOdu5h`E#?-=D9KJUqrOz1_P|!}pvmb>1RTLe>s{S4p$<*pos$ zrpaSH(8k3K?K4~Jyrg)CU^Ikd_p;`1B_{er6$6OCRo$D*i0sjZ{gwugfdIf@Do>~=8Ak6k_(4nV38@t?@E=?kl+7cRv@?yB4uIcSdgcUs4=F^AaX}3 zTwNQwi^m(W{=6D}j3QeQszl zKI27SHtj6}aWjidwZyY)a6`3zrBHf}*2)ZF`&dgZubm(E)85;*^5s3w71~$GaZmeo zPQi?Mx7lM``c4J)t*RGAA8mzMBg%!WSo0aD8)vYIKDX+1Op~qLSS1~*3y=Ivuo>N3 z`Mq!SS^{zYzWvU&d`!f7<&(YPy}<*MZBt5wj%%ISl!EqtSc~-D1Zn%sL(JX5IvRRj z>l8esd)T*6RAsYgJEI1tSeIs-u2qE?qfoi^Q;BYjh^xS>dVgXji)V-9xT+LU)TN;9 zVR(xFBmI)?<|7ARioY=hJ!4C_8A`o17fX=m{e%0C_ClNc!S1gcnaD!r_f)(YZCS+> zu!T?EQ=0S3Ejz#5g21!&Z+Fn|BNk0qvwiWpRSCK{P*P08&Z_?A>T&LfA zw@0zp+&|u8mx02nY}3ua=yox5??vGda%H7la0wIRwrO@R(6)?7LqoPFPt`w`x4uf; z?$gEz2kv*iz3v#GBv;FGxsb%9Sju1l2@l) zYpKTo%I3;1t*k%9(xFn)lEj-IpN`l^2C-WoPJb`bg|xd)-@EpfyIG7qGL}m(TZS-v zs>el3HM==^o&`<97jI#RCkMl~)=yJf%MWdR3{M`OSS!K85xOlAFxwejgiaX{xly12APl@cRJ66BFKUIuJ#1a zGJTA>Qe(L{foQ2>u)oiDG8(nMxJJ-I8{bi4F*5JkekjA<7Eb>CwarLB{T07v{h7C8 z@s1c2%x%Q3@{ROu+T9D$I)%EBKdHfbHGEyR{wfSnDbBxDLJ);K2*+UERWza+_9-%3 zE9sQhlDfyd)FfB%Yg)Ns>V-l0r|*+k8#O`sR$eN78x&nC;hxN{1VL$yKX}zae~VBU z%WIU0u-osI7WJyFbB@J~n!(p8WXx>g3yt7%=)jK|0&dM5Tl$L1`0Jh9IL&t)HO(*~ z^rF6U!vqB4o64B@5ve;mIQ5=9=chgRY++kxzrrA}J8O|pNhusC#imp}%3gf6OUEvcpJ_P#_hG_f^< z(*MiHIq|rJ$xIR-IEm0_q-Z)s?I1R5QJcMZ<&S)^yr;@{o|Qi4vkm%v9^Ne!24 zu{SAM`7E>bnDN-60Ce>@or45(aW&gl_|n89g#=j#QX_C9Z+{nijtJ&L3n5scabYCy zc;za8wQ=G!-5(!sbojYR?PiJ%yB98Vjhi*flb-L1N%}KMiM6^YJyonr%QEb$hJteB z=G#VAaP!#xH7+V?UD5$bQ-l1vG*p{OYRLNfJGS$5R{=lEq;&IhMAY5gK1`lbu|+!- z5+7A+hS#4zmTWpJhu5a@34O}?Iq7eqa<cRno zJ7dOP~QCqrHWEG>d&hS&SNN_t^_%yUx-0@{#Cj4+hZ_AS(WZi|hG{64?N~mwqlA6Y1o$iFk^JqWzAOhai*M`zQm~5N>s$fYQZ?P0V9B zI$!sQ2q_c>ZQrswGu=N!iJx(hf5)&W!SbFwY!eE*74WLNq_+yCo<1@^t6_}AZH)wD zYI<{Vd=m4TX>yC}`%y zWX^^y4FUBxb5zg>RD2*A5L$=M^>N>3TnmiCjw8CFi86t8t;o;*$p^c-f+6WpqPQ58_Ij_Z0R z@sGb)-f9b{4b_pCJ>749M5Hbm3v5cY6yNamg_dc)pGenV13i>Aw|mxdURxs3pFF)B zP|a(JSZtowF7&yi^93yChX(C~O%pNygQ9)4Xy+fhH^Z}JwVLCedc#e_eBOn;%;SAo zu3BmFpz2DS$l)=}v4Y8oH1xL@rW8m30?!V9Q9;;P~=1e9`n zTlNhyzDx3M?K(Ef?-$A#W1UHBvldJ-^6Z9YA{cQv%W4yEiq{>*B5UwY$8efbjMXbn zQD4th9Mw~QeYR!|+(0MY_HZVDPc>?H^QVS`m`$lN!@{LjLaULwq%i&+wO-F$f80*? z=wcX;2Lt_V-v+xl0xOXbP)6!y%FlBtv5OsulGx+drHelI zEygNfzCw3!{N)egWty)g=hE`Z79GC{$v9#2`g3x&tFe?@yEousYP0LIllJvelFz{# z4fTJr`kk8O230-==HC^cXZK2ByzxR&Fy|!uFu~vvEY&>kLzvX2HA`<|5a`Q0T)=-4 zH}_k^98C|6jI!Y|$(eOuSDgG=|3;l9{Lu@-jbzqtUvi=1q9&mxY$r(SX*s+NwAPFz z;E7#3d8j4ebl92~HbHEvC1|?^J%5kA@iq%0p+#)CobFmy^Zk?V>TCq_(f_D6Vt)>S2G3a<&SX zjYg%TUXpic-^}|;;ihRoYL04!I`nqm8W$RR$0Jt9CvYLI(+i4eY)Q0~FyOF-?F^x< z@9CRzWTV5Bwp4Bnb~R_U=2YIcMe}GYHy?>Qc6OrQm=LvAJ$zr+6I>o(f3qZ*w;-$K zsIs=OwIH}j*kXU7)xG4Yx2LI010NJ>&%MM3GxpqaGx-g*Y;4~3RX7#r^mJU9-;L)* zNSnCi?Run)ws|~11J3Uty0n;(kY!AjpV2?YD{v}Hb#xX;<@?g_xC){`GePMH}`$cbAaDK|t70=f9vu;i_Fw;zY+jw-C|}?f;8cj>Q$)cncUaX1 z_$P3T#$!RMu5Vb6an`xxHFo|$yY0Nq zvmA>Rc_Vw4WHvwM>VkW-kydfRlv={H$G1+9%R2V;BFCI#!8v}N-Hl|xjtR#2T@evT z6fg|y!MN=AJdpI;*)5%U@AW13U5TDNA^l;)`(#)kfx-FX?^(*UzP4d?v3;@FDQ2%@ zF6m&QfN0spoT6zDDxUHGc04vyw%WWfp9St$MsV{*T~zScYzNNLE%n4;KV-J`#EO&g z9?Hu8^qLuY&xJ3@DZe@37NK6=4Sc{>)j+QH9cV0(`wDrJ^ZQnp&N#@6f=0d8=2mbe z%%IDPChq9v@8W|V1P0Ou%%+?Cth@P6SpdKhgb>Km$B$3e*paq_%Q$oN>_$bdw&O%C zOp6*kceOWxQn!uxG>a-l=I!)+(N^8GLX}XuzPxAbyt|U@;?MFHwsTo3FpDq+TsUt0 zdYHvV96DL)r1{AEzPoXzYn*3l{S3^*ZM>P}^GQ;W7R>ArL0et(jZ8Xy<7O?8yK(PH z&CCA!*B&l|?dX@?nTyVzQ6brLOl}d$mm1y-xRi|E*hX?859aA~@o}0eMY@BzdHQG(Y)93T6o2!**#_LjoNZfmosOYiX^Un!`zi~b zYuk4OVP)UD7V2N&zSa~H%~Vw~QK|g0u%nzhYAGC%nlt-Iv0}!V@51Hw8v1@7mpprN zgMMEQ?u2C66Z^aRBC#&p%Zc5;Ml`xk-fL-Fjgdw|t+FybU7v#63y zTvefddsi2fxKq;|HM_c~Q2|X0q^&2G-nt`*Y+K=*u1Rq2LVq@^^S2Gvu@rmL_xKAx z11q)TYjf=JKs#Lx+n2xI9I=X-P&XTOhhFs1ZS&zfpSI)i{lPgqfr}Dy#gWh4hS)5% zs&ZSg~!(5&uN#p668B+_>Bycq_FCCQfd-j(m~ft z(qp1A-{r@r)f{u~rSX+Oi{Rv>%biy$l|Hp?d$>;p+sE`nF6vFqPVP=WC>;~j{p{WB z+=XW|f>wEa-3CkbKje*$3_*CNZzPArwJ3TO>)pa8&;Jfr$twS(AGJ)JXw^&?o?L#t zQ=lg=O8MgqSQ%Eo~*ov$3I+$AU;h zsr{X)F9~1HQKffJJ@x*n2KCOd;ZUZXk@DTfPgVILBJB;J3QOYNWOD5ZkINF*R1LBX&a1kFVfhO)UBEAcWP)QRT?5JXMfgMSAL#nDKG;N<+-Vy$1 z(T|bID-h@L@KiV_Z5O>)YLSJZGr6x#Xb6G>x8K6kO4aA{F&kUNvsEg`KMZFdY_1Vn z%PqO?x&N6M$<0_mVdz4JwVz*dC@V6Z?ty52Pbsx%(Oeq~l=MBi&a;E`zBn9a35}$# z>v|j2JCJD)6;JjiIijK*f$kQ)sJeV^tl(MLZQ_(o) zVF&u->FBu(1+|MKzvuoJ3ka3**tU##ZF!3!&u+Z%PMU|psau8wma6+klG|~ouf8>j z^0PGNE;22-tpZ!fSWk(2I#?d8f8Cz-`GmmY30wP-+h!vMtKJHPae?w_x0GRB@ubF+ zDCJ%i)~Am;*2LJ7WYRg$5(L#&-{vq4hR=PMz3lO^weahPGW=2cX;mJ9^X?KO(GR#Q zT&;{p8xMMuMEgd_H7fi!e(eNi-`yOqB~&`V9B>8k_pk8F{^pE_L1ONlO>n+0%5Be{ z8t}U38{dAl!?T=bAeiTwQt!I_>QVRf%PNh9WSVEPY8JHP9P9rZc-i_~S_&Zq65gAN zn3;Dsas-+sM7y-rONO2pE>QUZrj5o0cy{bUrQ6(q)idc8cwTCso%VJI+&e!%ue2$9 zYB_c|Cm?q-?oL}LR{)0Q{R}z|l4dCR$do})>Qa^Bd?3SoN}G*gFz(9VoXMf*BU z7ae<$#*Oe|v-uXm2rcKaHA;^=0-WZjSFHWK^BQ3xVf(3)cZsU}%}7)6ix3C<+1a{h zOpwEFOUR03>Mj1bE{oKxoB&d2q)-r1qKoToqP%X>eA8a|$pvW>+F;FjQJ;<5ynP2= zP=eC`=fIkL?#GY8Kq@U(XJ^aoym3RbO350;C2>os1&CHW^YiD?yy}{k{qd;@-UoYc z`ch;llgJHwRLUB*FEzy3w9fyz5Zv3`=z^kw6FQ+0K=*5rc3tS}kj78fTiR>^@PGa+ zBm%lY6na8$UiITS4KLj4d2gnj2pQ?LGy1oF>l&zocZQO*T>87)AN0!Y2zaA;uJEe1 zvoyA9Z9QrnJ?-<C*pgf1N%`yy%o3YAm(a;WPB=QIGtW8=@4(+~)JZ|{DIZ|HhCaLApN%c%8f#3Q`C54khP z!ydB&{+#;`NQwj%HS6nj%RhggWA@3X_sBUd1oWeXo<( zWuUu#O$}ZTv~#=Oh-x#0WA%)BQkS5oY9fraAjMxovC21p{r>D!s;>LZDF=u!NNyzN zm5wqdZYuHeHHK+_UEidu{@Q9)9YS-BtzK3p`2yM(b*vH?h4sg8*E=4 z*WeVDE%Ra@$3m>1F5a~4(R=Gu?LOhUK_TR@nn;!K17PyZBm&imVjx%T^e!QLp{e#u_&)0STn4#XQ8w;!RF2&%8#^&EO95G*nsVVA!8uRTtnctHz8y^ZsQ*G@B%2!G zTgy?YUG7#x_=xpy#8q#Q-Z&nEl*w|_gkGQDqXx_UH{ppV2KTTGuC%3;hW8* z%#kUdzIL?Ub3B-R^dM`m{R)_Gjv*r%F%#Z!F7DZlEI!c_o4W;ZCQouWoGW5tL8<>c z{-9pi-rl}}H37ET00?RyAH(mJSDsi{SX{^rx_@Y4@VEFqsbU=DZ;cUi#BbXaUu&s3!38H3{{oWyCAB$&$zwgZ-IpW@e0Y2-Ec0jW?=D|He~H}vg<)_9XCh4&jdDFN*y4u5E0EU51DBg&ZOkMRek_#l$o0}^ zbtfIp2|l+&?G~5SXf2j+xUM8c0s`pP<0syDH>KnsXTx7e_T=CZj+002D#xCF8SrOS z?)khAxBio=aJ8T1sLzw>s0g;6)gjV@`qcnsQiZ`De#WD*b_IjHTTJ_kY-+Oi%uFG+-3w{cFNN)dejZ5P2*kc zwYOcyW0-Xrw|=8-&OB^PS2Tc_E)DSI$+$ak>9?QL)8V!d;EXw7p|xHDYt2+St^wKL zV$Q^fS$6B>z2&fx(Y2aq-dl5qc`P^6gt^AZ%tv1oK0j#FRwKF!8z)*<4WwPiPJ`pA z8#okT>DBu#id7jZi5TRWR=v5@EnreS=A28D@LJM-YtAt{>*DgOZgWBSS>9>qm(7DO zV_?6yW!$gq&pv$r^W(fN#-{%|Zs_v~xrH>7EWy>aNMI-rdj^@J-lytp_S;~Kk zO4vLmPp>`8eQg<=VRY3tq`G_b=-?wwQ2+X>&d1KY+r_OR#y3Iuk6Q=Azd@)eRCE@PWIf%7oQsw601eyH?R&2t&b;V z6-TgazE$Rl%I)Iyq6%>0aN9e*irrFftMh@)D2V^Ye)*|1Y|xDNo&)Iw91xkN&9r@; zDHw3;h$*@v7#(BK{5!~~^Ux-{@rhf`lVwyq8loX!@dH5fGAMte4xCnTQx2nX9UQwQ zzsd1H9@K{(q!I9wFl2A9{d@_daqyb8`tBg;eO}{tj=_Pu{FaX+k_^qCM#ou2y~!p&uhk!EsSj8INUlxg zGiP~NcV%u!RI1`+85Jqtuh<50N*$5Sz9oMt?@sEap;u`db`fp6MzX4f`ZBL}4 zPhY&4r*L*ctbudP^kEy5EO5H?3+D$w2%Cy}IP(bhUd9C<+V=_+UX-Q=QQv7$#+bUfLq*| z6twK3)R7merfz)t_=yP}5ur77H6QkfrZ^MXEBh_jKsZGZh^cM(vHu>)q}F0AfcRcj z^kFFZcQ24h1VErnQoZK~i@!3ufUFIb(!AO)r_3CA<*{+6-LD%HxTES@hWCh-yn>v0 zl!9@Es0TT>9w43=n_MD&EsNq=)w(B8+T~I%;(AoDE{I&M9tJ5kcO6I}Zs^@vnz49t z$2KSX&y^^PSGPppEZ^~*;7)4&VjIx@%WyzLCmU|YI{u+^`}NzfU{9xsEs}xlDA6-a zCc*55O9Dem-r1wU9Cux8f^|lI4o;?OC61UEprwQFT@K4DPW(ZhV=4ja#5-B-`8LRT>GUETjd3s}=6X%Gc5>-nIE+3@Nd=BIIOS8m-g8-j z9B`XQ;bsi`L}#CVIwF$;N7p~Xmnm46M4FX%l+{?HH-Rl;;p=KZ3>S#=Jy(S8=Bc@W zOD0(vN7%@~_L&pinxF-8km;4B!x1ZP3Dc&>)g@k@c>C}TJHw;nKdeBPJl-g^2-Aat z@_yI;Y5l>*c3Uh$?1=coM`{-@UgY@r^0{g|$B_@$PM92he?^a+Bl^JdGG+OP+w~KcE4-iMeV1Z|T^QdVB|zOe*y^ zFs~II5l`D$^`eCELHEp@{8mTIX;9c^Bo}6rD>^)ywkk+p9c|-RAp7xc>~KZXhvY=U z;WTQrqJ)SeW>+c%Aflkq|>)^D7^8cResu^9r$KmNQxJB${gAoifTOAter74 zp@_$HfY*Ot%I!4p8CaVkW1$2(XVT2}8fUTL(JmOHl_1q*-P^%4iVFlPdsxz7r~3JgDbV zx9%fykbxA)FsVW*BCRd#L@5{ot%kjxG+S9#dtaIt6D2yj7E5g_&ZSO;v?EKaGs^!L z3&46G@G0()Cx=q=&%|iMk(pldSapo++C$>*F_Pk@8L3gXYj+lt{YtT$YN}3hv zF7*BD27%;K@aD?i;ua0ACQl84$#HE}ss&=R_`KQ0lfy-73H1FqKCW|6?Rrw`z#bob zZ@fYayy)YcN26!!vhnyYic%l@L+5bsc8XBeltI$;?6yf47jZ9vI-Lb4HM;dQuGIGU zuO~S-HWwso&;DYEC8*Os?}m#)r@H8CBXeAv583OjjevT>>m~e|a8$ld@7u8MlVJqG81?XeYWbbk`ot0X<5no69pYa~UEp==QgmT>3>r zyx)VPo$F?%DIVgymw@>|l`ljt(P}?a^3)W1`Z9zbO8XU7gby>bTFCHBf*XC3>CTqN z+S6m-S!P`BfIQ#7K9yZ?HoYkKf;BV`ROlFI)c-IJ_th>yvn?^_7beZPc=MOv<8o2q zF@r~7F2AOU{_noomo0L>6<1Qk#DS!m-zy^$!A6+CHMNcD69yt&=SIzWc=(NgHdOhjP*G!$?T=o{7q{~-t^U{|a}5kBV(-gbj-k2z1ry3Z>v zQT!wmh_MMxJNMwENy<{=X6eE`L=?OchagVUb^_qSM%bZ3ML#5JhCGDmoMNwEGxCzz zs+{}{r!HF)_QXXS*AVc%trdA~zlDc$ZoOFt)zyJp+H?Xskk%3HjR$UboP$qbyw~Ak zg=@_(-S$)a)N}76tz&3Y3L#qRY#odsP_udXsh0kQ$m?oReTD%d9XFS12d5pf2KF;p zK|<-&Hio$VMNX)yyAsNw8D}GWJ>Id;ZdC=-crGy^p_gDB)t4n>C9)+lz->2Z_^LDz z#SEd(^!B&5$8;s!9jTwMN!jeure;nKw7iI3@!vq>FG8c&(%^gi&`YQ)=)n$Qf7+mA z&2{b+W^*Q*=b(pKaZ411_ST?m9*PYN0h%y{URwA->`ZSWWjWVvr_+c)DqOxEk{_5% zb>80z51hrw-xvAaDN5g_Q|EJG?vAE$11INd8A^3wueUG%r$Xqir87B(e$dieN-0-&&Pr_ggmE*E zhkvaKq$5LU6Fk;>gB5TtX)_xN&t&x{*xn7U!Q2qX$G!SIhhQTgS%z#<+D1 z75UPd8`3QGUznQ0`W@G@0Wj9vyh^N>K|u=V6M~Z2St7za*aJ7@`96KCQuebSOfdJ& zX9!w!OMZC3zCI;ps87s23sq$*q0ku-`x%-)i72K13~lr!Y%#%`+iTA9oX zTtgWb7CIJMR*w`6>l^l0Cr$A&rizP5G`IjB`RIO+qYo`;h0 z(E(#ZO7f2Kbt@|zh=6SQrHN=N6=h{sN#B*j6BS6Zb38KBt3*_(xR&~pcbG1)AnHN z-Df6}a(CMRu~_YbW|gLIkV*B#Jyz(iP`j*yRXQeUx@2 z*4tRTxW;r}8{-|QofE?5a`}7-eG+KV0faboj zv=LuP{9#6;dGus{z-1G;3qYI_rN&3rtNk7)aM&}<6Lq!#B-%H&}(iKq~vs%l~tV9NdfAF+bG1e~A?rliSmXZ}5ee8YJ=eU~u zBYVcpYtj0eRXQJ)2$8!5F;C;12eF$ImQO_oLRJ!Uw|Pq;?y2U-q;MLyrtuc;UZ z7c+ET8vJhh^EIlPSY%(%b^p1kP~Z?ke!uk;-g#+uhtT97He)@-uJ{KZ?ca>9z-iMo zhU;~1S@|QHq8c~N_-I2RDaqL{-Q8Dm;d@Qk)C$RqlvcRU#ujD|uQp9e@k6`pW4}QH z7xhpW|GBXcHq&hdQb3oQB9&|pC$2>|HTPX9nVRwTKLAe3z&D%+pjb8F%q@b_yHX>& zoyR;g@4`7vI6>cuGze%?`|RmuDef)aU$^}l^W2*5dk z>2sTw{+WKXIcO*(aNiQ{iJD3^hfTBcdpu!B@HC!32EZ$OVgPoxA40esBhRu!y}L#L zT%I0);p0T3xn+j4K|JC1{ivTk3PiEFj%Od3%2MWxtxY#1n(t)1#?0Od9Vc@I=-evX z)F)&`X>{_*`6A);P&IDF`&9aVXkp%={vP;tKpDXJlv6hW(Yqg_9nkXg{6g*Tiw3;u z+Z)c&@HvGV2f{d_)}HhY?vH^VyxY>2^B*RdZ+}krU#1S!;cUCSR5OQH9|1yT4@w2o zH~0c6FI`yoi{a!wZ$uReOXt&)K&HnZ3I{;FI3EBO*Y~M(&ovUArb{PlK$@m-+R?p> zR$mo~9fkAK-xQwRqsjX2pa`3z;JioyJ`3-b3JA@M?k+SH#Yz5@02Vi&IW*=PKmnZs zA>jRQkUJ1sLQRt>EutskP*`cKf_J}AAexcRql6|hJu$9=kg>93AbaV10CV5K2|%}c zKChsX0gx~0aIej7{w_}6si_%#6PCjfw~}})n^q{Qp%GD%uvAxDRjR1_g45GAtoIFO zK!X^Suk&MTqJu{mDOhEaR*bh3Mpge@uUvM}zRfiWOUF;)ToX&+Tpf#*l+A$hG|pm! zQpI;~zqukO%u7^of^|&;9k0*{lj|M>Nu?E}7u)>_bOET}(;4|vq%1PgB-P$45PP=$ z)BLG458`O_%?RxX?ey$@)2$jl>N=hD11zdh&)Kxc%D2Cs;MqC9=B!BEHfW*_Lus!_ z`Ew@;*V7Jq*r6ga)S?k>a+5Til**SXK;D-r^}~kKHv=GK)!}4+avUUZAiYU^3Ukl6 zeg#RO{ccO&0?*J9kiFF%Y0OrUa}&9JKu(0d?My4BCm#zIQugP9?$1eg-K0HZQ#DNv z-1EVt!CYh^EU@j+bif3(HQ*-ZUXiq^ zHPU9(NUnMIZQxk89i4xbl71pzQqJ6Ui5iRe|sDPz_SX~XtOeSgSb&idZRhW z1OoLbY0=sipvf18SUKPy>EbOuC1VN=G#A?)7<_YB5cale;>Mw2yb&Q$ ze4q%YU>XV30Qw4+*EL$M!*WfIvQ0?V^V)dh)`Rm+eF^i4lL^#Kc()%1 zFG!^ojnNlGa|L_x`7qm|NWAHFG{)l(r~%L!Y5W{Zf*>ER#ATC@80&mJnWSms@`j-o+k2aYAs679sPcBR2nwv zC%^!AvJEy{SEspFj6G!lIMj%RS>>H1S?aNIQ~8Wxzngom?Y_hAgOHFMOar9-5@v=u z6?R>aptL&jSSAuVorFr=s^Es%XQ`i&g|xr%u3t$lOZd4c3kA=ax0-#BgDSw<>PuSYC{%th6b@+` zZ~kr#+vgz~^ac_3`{_<&-9#?HgK+2Z@7)1b%=!;w24CrsbVs7fysMk3y9jA~3Ixh1 z9f-8B&!Yw1M~ac^Za?6%&pKyt<5S?WM`!M-qT*zjlkz=XNn%-YuK(?uAkcTM;sL*< zMC&94oi(qLV;?}EAaka#b}uAi3T|RvzsMEtn%H{!U9-4!5EulU>Gi%`J#C(eG}W!( zNqJJ8&4=nq2RR{^ju(VHvU>l^Ihho>kOniUGS2kULhS_N&+Ok%Lm1Yhh`;?SOqg}$ z9m4tm;d{5(DuKwGV?O!=TrR|+y7a$Tz(pHCXy=ss@C

$PYnStz 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ΞXC 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 literal 0 HcmV?d00001 diff --git a/docs/features/screenshots/files-sidebar-extraction-tab.png b/docs/features/screenshots/files-sidebar-extraction-tab.png new file mode 100644 index 0000000000000000000000000000000000000000..d51aa99cd4b0e11e22e92ceb7c0f999002b3f927 GIT binary patch literal 258687 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�hQ&@AuCAkzr`0U8 z?2(}-elvy=A1p4K(QU^Zx0UyFloVogqMUDS7CsoFD~*SRh(bv z#@ID=mRS|2H7DNHA-+DowxY2RSP`QVZ?Vn&J=V6j6P$)f$76T1%qp9gSwD^{2QL~= zn_PTWrkb{6DRntlj*m+8Yu~s-Wt&VHly??TX6Ww1T1O)`zzGAD$h7-!2jMu)WtM_w ztF@dAoy&y3M(FZWcr7j=6dZpbBn5ly#Z>KrZmIEcVr3Cp)T6yXT_QX>;&i3b?`S6= z@0%Q8e?NO3AptqG(v{kB*#BhYqkKau8@@OmVQd|J3oC(;!uIP zWNyEmlz-qfRzKaRYsws)&-gxOjiu_zYp#ZiyaIuVl}+9nSQfij2X(K|EaZKqugmli zbXO{rZl27Shl-&h`wK%=vle_$JS%oCpN7*ldt&U`E~Wr0$Q>oVcF$l}cU4Ykbb3(QSK8J0 z>)oW)zk3T%4r$#BRQoVto1y+Fps4io;w*fi|J6=jLE`R=AW*Zg_wcl3m5x`8fd9BivD=>&pVCP3DW_&0SxxP2=B{k-!4BS5#r&} zrg5bh)m9@yBu<<6-z$$kPUfUE5a?F=UA^}t9H*%CPB|nSTlpY*Xmr-+WJ-!@=^rOPJnHxs z%c#i1YplcFoj^|+9Yi0|$QridLo%I%Yp?zQg*rWI3`h`z{C!nmukA64$)>*gZFtI9 z#=YOoo=l(5?_D>S{v`yQC-$Tuat=4(NpuHIQ@F)Zw>wE(79+2fOtG|%7@dA8Hpl+sA*C$X z6YXZ)+?&N|XvKk&?%2Qo9IG?oG4y*=^o0OYbch?#4g2sovY zw{bEbv4b{Dy8N2jxcDF+f9)`rT5LdZ`gV#5^R8L^vZoqfB~ccAhLE+l3r|FU=exgO z75HoA_2hnT&H&nFxkN0QKzdu3olBAGNt7?m{(03_wgcx_BSYq|z=SV#`1Ui)SwTjiVA7-Tloez{<`gM~$?q9`l% z-0r@m+*9F)XY2O$juVSV?u|+WVi{VEsuuYcD{nVFZmRH$j_yLCN(alqZ!2Z6Z=?ihktym>h|eM?2j^NmAu_81nDAJMufXZ%wH6iNTN z697vVJO2R_x+QdqzVE7egyi&O53ffLZD+8r`FN?QFps zzHeEm3g`H^J?6b$blfN`aW6R;FnJap_ymxPZh2cS$JD^C#T$8 ziPcs)D5|=^W$Dp58j+f|hiErF?%5g|P`zlVI>I1D7pA>`r41Z(Fh5&sER4i76`YrS z+Pcv53cGE(x8wV@d&2NwM}M&Upc0B&E@7-21QD3WzA1@IP=-i%=nvZJ{Cs? zYAQ&9xpP^*NjqyVVGL^3aM6}DktTkMg8r+W;YFf;jc-5pVeIUe1U1Uhfoqy*NsS4{ zi275UIq|yp<3+wB-*U61W#B1@@dVlwl>Nie781?cOL!bo^(p@b}}=kjpIM29Sb6o^+ck#Nqcoa#g)xw>i;yR z%QsiiE5jJFmo{N5PFTfR_))TS4W9^Dy3h-CY56U5eb~ZY4=t~b&f}al~4saT{ZXJadu~lh3>ZL)2hmab>E12iL+P}w1|d6b5s7l9HU-l zj`yD?GTe3}#d?+T=2^RWiFY}Ug#n$%G82TOTw}-i2}s3ZA!60a2l~DeaRc#geM>&F zrU|D-O_4h|8`Dwshaa|*#*mNWkH1?8ennmn-aFJOJ~M(kB&t^lj|keo7EpHY}#7q^VrMIv8|~55kihi zFF+xisVuTYxxd4RGNxHY7r%Zw%)}03BcB7#r$zuUuxp= zXHI?NjsD`p^WIC71M~|t>FGm(r)Wo=3CQJ65GE^;`Toe>TFciM!l~~$vUmYd$cSJ* z(dzdSkm_*~d!u9sH8!qX6=Wz)t97|%(X6ju!w+pC(}EMS+jl3OF!oqhjtSQ8ef~(R zy(LlVwoLs<(@qM}$Z`9eiy^D>QZS}c9`SiV_{?vxMd@iDw@AHgN5a8^&h5)heKEo! z0($H0I$BeMl8Pp~aTBHKdEW+=7LKkZj3JC`%7;DTSRc`hqu3;r9v_h%8pObS9cX_y zy~{8oc9BBsn8znO6TbeekAtzM5_%6j*q+xD9W1gj)zf?txz`<*JJbo!ATSH@;c17U(3!kpkiU&_MyNSta zv3NoZ-u8|?snwmoK)j?79XwHsq^;^?U8U!HKiZzyZ_JCOM{n5SOkT|J`x%}%R`p{V z7;j{++=G35=RT~TfaYy~@)FWT?xx#x(~_@Gg`X@X`y|ZTX74pG@nwgiWK4n>;$&yK z=ENhYzzCZMfAi2(Khm!sZoO(Y)%L=6p}t>>Q3{Z zR;4p|Lh~k00veG1*?H2dm>_dK;H*5G0RaYW@p0F7f71;QT8T^bMjm5z*;K$eM zz$FmzYwthYKJ~tX$XzAE-yE~%XA7~S`&hb&+GHpf7t85Tsa0E1juthO69AYuqUN%( zFxMnpJAht$JfU778~xQqOC|N0EeU_Ee$B1Ivy6&bx&pCVpA|LOshrilsO{CI#lY zJq9tk(y^5f-9Yd->Pw)540a~>JT%K4beqbsJL>oa+yI!cDu-FBZe!d zJF)0+<3heei?!vYSbke6>NHa^7(P^d?`SL`F%;`i#QyBGp_TMl193`iw=Y&(+BLkijk`Q%Memes1_V*Ir`InLE|z^4~8J*cC1!WK8m z<*d9(rn53xXXT{wj)%f1*;${{AxN3?5x9&xC)gFdM&@QdCex0PWT?{A*^*~#Z93^5 z>OORqdi~48hQn-n(a1o)QV@UK#?Wy7l75knZJ(o7-Svfp<{uxlyG7KNI?>s&7JNVv zEmUQcDmt|GvDrO=WlP{y)v2S#WkXF?8fDI+?Wn4u7j(n<%~%xMbh=x|x9Wt`VpF)C zD{8#hn;3y%J~;mptDvIy(JC94IzUMUHCKj2X11{_;Ejk*ceY44d?bghyeOK^Kl4b` zUp0oaj$NQ4{986_T&<$X-cGF1Z%wdlu&zgJuC*lGE;A?ISJy1$AMjh9S;j5SGIcA; zwP)*3vTa>sGM8&BA;D1~0#*-+; z=7itOcNCB0P0whghs6Y6(5`NCG(8%nH*1D=I|plJ>Yw7ge<^$uWB;^^u3?vLMaf5# zFWrVs+e5D8(C)d9piP@4W{!uV?N84v+}j6lC3kd!HJNJ6Tc+D%KqW`HF&8;Jci+P8 zmf{?-rdCISZ_SvDUqQf!SJ}<8E(H3HC@Vd$JAJ2&o#9{H23@8GWq>aKid9i5}6acuA0G3 zzki&yTT5qvXOJdW!mePHHh-~jeH&f&?)ps&`j-?kC)_&pIp^iK^t*z|mRf9Jk)itM zpPnv=pdDG$$eu;OTmrOYKWX($(zt(rtg=itq9D~0DAcKcOs{Y@9&XUmlWDr@I>@|=dtcIwjEXYP9psG_zac4LDZ(pwXuDjt z!mccB+113oATzV})xal0znfY2#=L<~kN#Q_yER3B#85?Ox5Xa!##`;ktZU|C6&2XN z_$&-VG z8V3hNX|Xb=hhoXT1@Xp%>{3{LJKI!F8hoaduYw`#Lo}*4UiRF~LQE*{cd~X%^s5F| zB&v6|_hQ0odx65w-DN3-MLz?5{_+x|2hBM9Q2H(NDMtpz$nyJiVmBHh;< zuS!yO>a8bD<9bo^pa$0Mmf)p)*g3YXbSBX2OGxxlG()R_VNPgh!dsvz(wakci*IaB z2T^=_nlvgrZ7S_Ebs$3eKn-3nZus+b_X6?%VUoMP%5GLf z;KYmbEWyoLLh)=4CeLsyQ33o1`yHYR)NjkIEFeAlx=x{Y1zA<=vdaZDgm-~jX z^~{FhW6^aaB=gXnjN36j*5ZS{e9?4L{%!0g-ktSF%G`cw&=U9cBBS!iXy*v8->cbd x5K@M($%Wr80ef+IndU@M25!eVSNG~0ShvjsG6VAY+paFmigIeQ71A$*{vUU7y?+1z literal 0 HcmV?d00001 diff --git a/docs/features/screenshots/files-sidebar-tabs.png b/docs/features/screenshots/files-sidebar-tabs.png new file mode 100644 index 0000000000000000000000000000000000000000..e7408f59c357860ef39a30ea2201c00bb970bbc8 GIT binary patch literal 277385 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�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

Gpo}HV^3^N!LW~trwdd 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 O0000U~yY) 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
ls=*Trkxpc!PRVk3P>LFslo$N5Rm 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 m|3Qe+jQ{`u21!IgR09BSYMx*+7X$$S0000registerEventListener('OCA\Files\Event\LoadAdditionalScriptsEvent', FilesSidebarListener::class); - // MailAppScriptListener injects the mail sidebar when schemas have linkedTypes: ["mail"]. + // MailAppScriptListener injects the mail sidebar script into the Mail app + // (gated to the Mail app via TemplateResponse->getApp() === 'mail'). $context->registerEventListener( \OCP\AppFramework\Http\Events\BeforeTemplateRenderedEvent::class, - \OCA\OpenRegister\Listener\MailAppScriptListener::class + MailAppScriptListener::class ); // CommentsEntityListener registers "openregister" objectType for Nextcloud Comments. diff --git a/lib/Listener/FilesSidebarListener.php b/lib/Listener/FilesSidebarListener.php index a86df0e8a319..1f75cd8cb4cb 100644 --- a/lib/Listener/FilesSidebarListener.php +++ b/lib/Listener/FilesSidebarListener.php @@ -65,6 +65,9 @@ public function handle(Event $event): void return; } - Util::addScript('openregister', 'openregister-filesSidebar'); + $jsPath = __DIR__ . '/../../js/openregister-filesSidebar.js'; + if (file_exists($jsPath) === true) { + Util::addScript('openregister', 'openregister-filesSidebar'); + } }//end handle() }//end class diff --git a/lib/Listener/MailAppScriptListener.php b/lib/Listener/MailAppScriptListener.php index 5b6fd7ccd7d3..c4084ee7c94b 100644 --- a/lib/Listener/MailAppScriptListener.php +++ b/lib/Listener/MailAppScriptListener.php @@ -105,9 +105,12 @@ public function handle(Event $event): void return; } - // Inject the sidebar script. - Util::addScript('openregister', 'openregister-mail-sidebar'); - Util::addStyle('openregister', 'mail-sidebar'); + // Inject the sidebar script (only if compiled JS exists). + $jsPath = __DIR__ . '/../../js/openregister-mail-sidebar.js'; + if (file_exists($jsPath) === true) { + Util::addScript('openregister', 'openregister-mail-sidebar'); + Util::addStyle('openregister', 'mail-sidebar'); + } $this->logger->debug( 'Mail sidebar script injected for user {user}', diff --git a/package.json b/package.json index e3a8187bad0b..1ef7db5da8bc 100644 --- a/package.json +++ b/package.json @@ -19,7 +19,11 @@ "download-oas": "scripts/download-oas.sh", "test:e2e": "playwright test", "test:e2e:docs": "playwright test --project docs-capture", - "test:e2e:install": "playwright install chromium" + "test:e2e:install": "playwright install chromium", + "check:json-strict": "node tests/validate-json-strict.js", + "check:manifest": "node tests/validate-manifest.js", + "check:register": "node tests/validate-register.js", + "check:specs": "npm run check:json-strict && npm run check:manifest && npm run check:register" }, "browserslist": [ "extends @nextcloud/browserslist-config" diff --git a/src/files-sidebar.js b/src/files-sidebar.js index 4c8a7e44d723..dcd6320ec54d 100644 --- a/src/files-sidebar.js +++ b/src/files-sidebar.js @@ -10,6 +10,8 @@ import Vue from 'vue' import { translate as t } from '@nextcloud/l10n' +import RegisterObjectsTab from './components/files-sidebar/RegisterObjectsTab.vue' +import ExtractionTab from './components/files-sidebar/ExtractionTab.vue' // MDI icon SVG paths (inline to avoid icon library dependency). // database-outline @@ -37,16 +39,11 @@ document.addEventListener('DOMContentLoaded', () => { name: t('openregister', 'Register objects'), icon: databaseOutlineIcon, - async mount(el, fileInfo, _context) { + mount(el, fileInfo, _context) { if (el._registerObjectsVm) { el._registerObjectsVm.$destroy() } - const { default: RegisterObjectsTab } = await import( - /* webpackChunkName: "files-sidebar-objects-tab" */ - './components/files-sidebar/RegisterObjectsTab.vue' - ) - const View = Vue.extend(RegisterObjectsTab) el._registerObjectsVm = new View({ propsData: { @@ -80,16 +77,11 @@ document.addEventListener('DOMContentLoaded', () => { name: t('openregister', 'Extraction'), icon: textBoxSearchOutlineIcon, - async mount(el, fileInfo, _context) { + mount(el, fileInfo, _context) { if (el._extractionVm) { el._extractionVm.$destroy() } - const { default: ExtractionTab } = await import( - /* webpackChunkName: "files-sidebar-extraction-tab" */ - './components/files-sidebar/ExtractionTab.vue' - ) - const View = Vue.extend(ExtractionTab) el._extractionVm = new View({ propsData: { diff --git a/src/mail-sidebar.js b/src/mail-sidebar.js index 71e2a2c89597..65326bd9f6b8 100644 --- a/src/mail-sidebar.js +++ b/src/mail-sidebar.js @@ -12,6 +12,9 @@ import Vue from 'vue' import MailSidebar from './mail-sidebar/MailSidebar.vue' +console.info('[OpenRegister] mail-sidebar.js loaded') +console.info('[OpenRegister] Vue and MailSidebar imported successfully') + const MOUNT_RETRY_INTERVAL = 1000 const MOUNT_MAX_RETRIES = 30 const SIDEBAR_ROOT_ID = 'openregister-mail-sidebar' @@ -48,20 +51,24 @@ function mountSidebar() { setTimeout(tryMount, MOUNT_RETRY_INTERVAL) return } + console.debug('[OpenRegister] Not a Mail page, skipping sidebar injection') return } // Check if already mounted (works for both expanded and collapsed sidebar). if (document.getElementById(SIDEBAR_ROOT_ID)) { + console.debug('[OpenRegister] Sidebar already mounted') return } try { + console.info('[OpenRegister] Mounting mail sidebar') const app = new Vue({ render: (h) => h(MailSidebar), }).$mount() app.$el.id = SIDEBAR_ROOT_ID document.body.appendChild(app.$el) + console.info('[OpenRegister] Mail sidebar mounted successfully') return app } catch (err) { console.error('[OpenRegister] Mail sidebar mount failed:', err) diff --git a/src/mail-sidebar/composables/useMailObserver.js b/src/mail-sidebar/composables/useMailObserver.js index 42a98d6e5254..4c728af2af92 100644 --- a/src/mail-sidebar/composables/useMailObserver.js +++ b/src/mail-sidebar/composables/useMailObserver.js @@ -13,7 +13,9 @@ import { ref, onMounted, onBeforeUnmount } from 'vue' * * Handles both routing modes: * - Path-based (Mail 5.x+): /apps/mail/box/priority/thread/6 or /apps/mail/box/2/thread/42 + * - Path-based (no message): /apps/mail/box/2 * - Hash-based (legacy): #/accounts/1/folders/INBOX/messages/42 + * - Hash-based folder-only (no message): #/accounts/1/folders/INBOX * * @param {string} url The full URL or hash string. * @return {{ accountId: number|null, messageId: number|null, sender: string|null }} Parsed IDs. @@ -23,39 +25,52 @@ export function parseMailUrl(url) { return { accountId: null, messageId: null, sender: null } } - // Path-based routing: /apps/mail/box/{boxId}/thread/{threadId} - const pathMatch = url.match(/\/apps\/mail\/box\/([^/]+)\/thread\/(\d+)/) - if (pathMatch) { - // boxId can be 'priority', 'starred', or a numeric mailbox ID - const boxId = pathMatch[1] - const threadId = parseInt(pathMatch[2], 10) + // Path-based routing with thread: /apps/mail/box/{boxId}/thread/{threadId} + // boxId may be 'priority', 'starred', or a numeric mailbox ID. + const pathThreadMatch = url.match(/\/apps\/mail\/box\/(\w+)\/thread\/(\d+)/) + if (pathThreadMatch) { + const boxId = pathThreadMatch[1] + const threadId = parseInt(pathThreadMatch[2], 10) - // For priority/starred inboxes, accountId is unknown (uses default account 1) - // For numeric box IDs, that IS the mailbox ID (not account ID) - // We use 1 as default accountId since most setups have one account + // For priority/starred inboxes, accountId is unknown — fall back to the + // default account 1 (most setups have one account). For numeric box IDs + // the segment is a mailbox ID, not an account ID; still fall back to 1. const accountId = /^\d+$/.test(boxId) ? 1 : 1 return { accountId, messageId: threadId, sender: null } } + // Path-based routing without thread: /apps/mail/box/{mailboxId} + const pathBoxMatch = url.match(/\/apps\/mail\/box\/(\d+)$/) + if (pathBoxMatch) { + return { accountId: parseInt(pathBoxMatch[1], 10), messageId: null, sender: null } + } + // Hash-based routing: #/accounts/{accountId}/folders/{folderName}/messages/{messageId} - const hashMatch = url.match(/\/accounts\/(\d+)\/folders\/[^/]+\/messages\/(\d+)/) - if (hashMatch) { + const hashMessageMatch = url.match(/\/accounts\/(\d+)\/folders\/[^/]+\/messages\/(\d+)/) + if (hashMessageMatch) { return { - accountId: parseInt(hashMatch[1], 10), - messageId: parseInt(hashMatch[2], 10), + accountId: parseInt(hashMessageMatch[1], 10), + messageId: parseInt(hashMessageMatch[2], 10), sender: null, } } + // Hash-based folder-only: #/accounts/{accountId}/folders/... + const hashFolderMatch = url.match(/\/accounts\/(\d+)\/folders\//) + if (hashFolderMatch) { + return { accountId: parseInt(hashFolderMatch[1], 10), messageId: null, sender: null } + } + return { accountId: null, messageId: null, sender: null } } /** * Composable for observing Mail app URL changes. * - * Uses a combination of hashchange, popstate, and MutationObserver to detect - * SPA navigation in the Mail app (which uses Vue Router with history mode). + * Uses a combination of hashchange, popstate, and polling to detect SPA + * navigation in the Mail app (which uses Vue Router with history mode and + * pushState — neither hashchange nor popstate fires for pushState). * * @param {object} options Options. * @param {number} [options.debounceMs=300] Debounce delay in milliseconds. @@ -88,7 +103,9 @@ export function useMailObserver(options = {}) { } debounceTimer = setTimeout(() => { - const parsed = parseMailUrl(currentUrl) + // Prefer hash for legacy Mail, fall back to full URL for path routing. + const url = window.location.hash || currentUrl + const parsed = parseMailUrl(url) const changed = parsed.accountId !== accountId.value || parsed.messageId !== messageId.value @@ -107,7 +124,8 @@ export function useMailObserver(options = {}) { // Parse initial URL. const currentUrl = window.location.href lastUrl = currentUrl - const parsed = parseMailUrl(currentUrl) + const url = window.location.hash || currentUrl + const parsed = parseMailUrl(url) accountId.value = parsed.accountId messageId.value = parsed.messageId isMessageView.value = parsed.messageId !== null diff --git a/tests/integration/openregister-integrations.postman_collection.json b/tests/integration/openregister-integrations.postman_collection.json new file mode 100644 index 000000000000..5730b1328963 --- /dev/null +++ b/tests/integration/openregister-integrations.postman_collection.json @@ -0,0 +1,1283 @@ +{ + "info": { + "_postman_id": "openregister-integrations-v1", + "name": "OpenRegister Integrations API", + "description": "Integration tests for OpenRegister's integration API endpoints: Actions, Archival, Email Links, Contacts Match, File Sidebar, User Profile, Workflow, and TMLO.", + "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" + }, + "auth": { + "type": "basic", + "basic": [ + { + "key": "username", + "value": "{{username}}", + "type": "string" + }, + { + "key": "password", + "value": "{{password}}", + "type": "string" + } + ] + }, + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [ + "// Set auth headers for every request", + "const user = pm.collectionVariables.get('username') || 'admin';", + "const pass = pm.collectionVariables.get('password') || 'admin';", + "pm.request.headers.add({", + " key: 'OCS-APIRequest',", + " value: 'true'", + "});", + "pm.request.headers.add({", + " key: 'Accept',", + " value: 'application/json'", + "});", + "pm.request.headers.add({", + " key: 'Content-Type',", + " value: 'application/json'", + "});" + ] + } + } + ], + "variable": [ + { + "key": "baseUrl", + "value": "http://localhost:8080/index.php/apps/openregister", + "type": "string" + }, + { + "key": "username", + "value": "admin", + "type": "string" + }, + { + "key": "password", + "value": "admin", + "type": "string" + }, + { + "key": "actionId", + "value": "", + "type": "string" + }, + { + "key": "selectionListId", + "value": "", + "type": "string" + }, + { + "key": "tokenId", + "value": "", + "type": "string" + } + ], + "item": [ + { + "name": "Actions API", + "description": "CRUD operations for Actions (event-driven workflow triggers).", + "item": [ + { + "name": "List Actions", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.response.to.have.header('Content-Type');", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response has results array', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.have.property('results');", + " pm.expect(json.results).to.be.an('array');", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/actions", + "host": ["{{baseUrl}}"], + "path": ["api", "actions"] + } + } + }, + { + "name": "Create Action", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response contains created action with ID', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.have.property('id');", + " pm.expect(json.name).to.eql('Test Action');", + " pm.collectionVariables.set('actionId', json.id);", + "});" + ] + } + } + ], + "request": { + "method": "POST", + "header": [], + "body": { + "mode": "raw", + "raw": "{\n \"name\": \"Test Action\",\n \"event_type\": \"object.created\",\n \"engine\": \"n8n\",\n \"workflow_id\": \"wf-001\"\n}" + }, + "url": { + "raw": "{{baseUrl}}/api/actions", + "host": ["{{baseUrl}}"], + "path": ["api", "actions"] + } + } + }, + { + "name": "Read Action", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response contains the correct action', function () {", + " const json = pm.response.json();", + " const expectedId = pm.collectionVariables.get('actionId');", + " pm.expect(String(json.id)).to.eql(String(expectedId));", + " pm.expect(json.name).to.eql('Test Action');", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/actions/{{actionId}}", + "host": ["{{baseUrl}}"], + "path": ["api", "actions", "{{actionId}}"] + } + } + }, + { + "name": "Update Action", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Action name was updated', function () {", + " const json = pm.response.json();", + " pm.expect(json.name).to.eql('Updated Action');", + "});" + ] + } + } + ], + "request": { + "method": "PUT", + "header": [], + "body": { + "mode": "raw", + "raw": "{\n \"name\": \"Updated Action\"\n}" + }, + "url": { + "raw": "{{baseUrl}}/api/actions/{{actionId}}", + "host": ["{{baseUrl}}"], + "path": ["api", "actions", "{{actionId}}"] + } + } + }, + { + "name": "Delete Action", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Action was deleted', function () {", + " const json = pm.response.json();", + " // Depending on implementation, response may contain a success message or empty body", + " pm.expect(pm.response.code).to.eql(200);", + "});" + ] + } + } + ], + "request": { + "method": "DELETE", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/actions/{{actionId}}", + "host": ["{{baseUrl}}"], + "path": ["api", "actions", "{{actionId}}"] + } + } + } + ] + }, + { + "name": "Archival API", + "description": "Archival selection lists and destruction lists.", + "item": [ + { + "name": "List Selection Lists", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response has results array', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.have.property('results');", + " pm.expect(json.results).to.be.an('array');", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/archival/selection-lists", + "host": ["{{baseUrl}}"], + "path": ["api", "archival", "selection-lists"] + } + } + }, + { + "name": "Create Selection List", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response contains created selection list with ID', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.have.property('id');", + " pm.expect(json.category).to.eql('financial');", + " pm.expect(json.retentionYears).to.eql(7);", + " pm.expect(json.action).to.eql('destroy');", + " pm.collectionVariables.set('selectionListId', json.id);", + "});" + ] + } + } + ], + "request": { + "method": "POST", + "header": [], + "body": { + "mode": "raw", + "raw": "{\n \"category\": \"financial\",\n \"retentionYears\": 7,\n \"action\": \"destroy\"\n}" + }, + "url": { + "raw": "{{baseUrl}}/api/archival/selection-lists", + "host": ["{{baseUrl}}"], + "path": ["api", "archival", "selection-lists"] + } + } + }, + { + "name": "Read Selection List", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response contains the correct selection list', function () {", + " const json = pm.response.json();", + " const expectedId = pm.collectionVariables.get('selectionListId');", + " pm.expect(String(json.id)).to.eql(String(expectedId));", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/archival/selection-lists/{{selectionListId}}", + "host": ["{{baseUrl}}"], + "path": ["api", "archival", "selection-lists", "{{selectionListId}}"] + } + } + }, + { + "name": "List Destruction Lists", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response has results array', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.have.property('results');", + " pm.expect(json.results).to.be.an('array');", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/archival/destruction-lists", + "host": ["{{baseUrl}}"], + "path": ["api", "archival", "destruction-lists"] + } + } + } + ] + }, + { + "name": "Email Links API", + "description": "Retrieve email-to-object links by message ID or sender.", + "item": [ + { + "name": "Get Emails by Message ID", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON', function () {", + " pm.response.json();", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/emails/by-message/1/1", + "host": ["{{baseUrl}}"], + "path": ["api", "emails", "by-message", "1", "1"] + } + } + }, + { + "name": "Get Emails by Sender", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON', function () {", + " pm.response.json();", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/emails/by-sender?sender=test@example.com", + "host": ["{{baseUrl}}"], + "path": ["api", "emails", "by-sender"], + "query": [ + { + "key": "sender", + "value": "test@example.com" + } + ] + } + } + } + ] + }, + { + "name": "Contacts Match API", + "description": "Match contacts by email or name.", + "item": [ + { + "name": "Match Contact by Email", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON', function () {", + " pm.response.json();", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/contacts/match?email=admin@example.com", + "host": ["{{baseUrl}}"], + "path": ["api", "contacts", "match"], + "query": [ + { + "key": "email", + "value": "admin@example.com" + } + ] + } + } + }, + { + "name": "Match Contact by Name", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON', function () {", + " pm.response.json();", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/contacts/match?name=Admin", + "host": ["{{baseUrl}}"], + "path": ["api", "contacts", "match"], + "query": [ + { + "key": "name", + "value": "Admin" + } + ] + } + } + } + ] + }, + { + "name": "File Sidebar API", + "description": "File-to-object links and extraction status for the Nextcloud Files sidebar.", + "item": [ + { + "name": "Get Objects for File", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON', function () {", + " pm.response.json();", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/files/1/objects", + "host": ["{{baseUrl}}"], + "path": ["api", "files", "1", "objects"] + } + } + }, + { + "name": "Get Extraction Status for File", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON', function () {", + " pm.response.json();", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/files/1/extraction-status", + "host": ["{{baseUrl}}"], + "path": ["api", "files", "1", "extraction-status"] + } + } + } + ] + }, + { + "name": "User Profile API", + "description": "User profile, notifications, activity, tokens, and deactivation status.", + "item": [ + { + "name": "Get Current User Profile", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON', function () {", + " pm.response.json();", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/user/me", + "host": ["{{baseUrl}}"], + "path": ["api", "user", "me"] + } + } + }, + { + "name": "Get User Notifications", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON', function () {", + " pm.response.json();", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/user/me/notifications", + "host": ["{{baseUrl}}"], + "path": ["api", "user", "me", "notifications"] + } + } + }, + { + "name": "Update User Notification Preferences", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Notification preferences updated', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.be.an('object');", + "});" + ] + } + } + ], + "request": { + "method": "PUT", + "header": [], + "body": { + "mode": "raw", + "raw": "{\n \"objectChanges\": true\n}" + }, + "url": { + "raw": "{{baseUrl}}/api/user/me/notifications", + "host": ["{{baseUrl}}"], + "path": ["api", "user", "me", "notifications"] + } + } + }, + { + "name": "Get User Activity", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON', function () {", + " pm.response.json();", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/user/me/activity", + "host": ["{{baseUrl}}"], + "path": ["api", "user", "me", "activity"] + } + } + }, + { + "name": "List User Tokens", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON', function () {", + " pm.response.json();", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/user/me/tokens", + "host": ["{{baseUrl}}"], + "path": ["api", "user", "me", "tokens"] + } + } + }, + { + "name": "Create User Token", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response contains token with ID', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.have.property('id');", + " pm.collectionVariables.set('tokenId', json.id);", + "});" + ] + } + } + ], + "request": { + "method": "POST", + "header": [], + "body": { + "mode": "raw", + "raw": "{\n \"name\": \"test-token\"\n}" + }, + "url": { + "raw": "{{baseUrl}}/api/user/me/tokens", + "host": ["{{baseUrl}}"], + "path": ["api", "user", "me", "tokens"] + } + } + }, + { + "name": "Get User Deactivation Status", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON', function () {", + " pm.response.json();", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/user/me/deactivation-status", + "host": ["{{baseUrl}}"], + "path": ["api", "user", "me", "deactivation-status"] + } + } + } + ] + }, + { + "name": "Workflow API", + "description": "Workflow executions, scheduled workflows, approval chains, and approval steps.", + "item": [ + { + "name": "List Workflow Executions", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response has results array', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.have.property('results');", + " pm.expect(json.results).to.be.an('array');", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/workflow-executions", + "host": ["{{baseUrl}}"], + "path": ["api", "workflow-executions"] + } + } + }, + { + "name": "List Scheduled Workflows", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response has results array', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.have.property('results');", + " pm.expect(json.results).to.be.an('array');", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/scheduled-workflows", + "host": ["{{baseUrl}}"], + "path": ["api", "scheduled-workflows"] + } + } + }, + { + "name": "List Approval Chains", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response has results array', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.have.property('results');", + " pm.expect(json.results).to.be.an('array');", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/approval-chains", + "host": ["{{baseUrl}}"], + "path": ["api", "approval-chains"] + } + } + }, + { + "name": "List Approval Steps", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 200', function () {", + " pm.response.to.have.status(200);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response has results array', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.have.property('results');", + " pm.expect(json.results).to.be.an('array');", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/approval-steps", + "host": ["{{baseUrl}}"], + "path": ["api", "approval-steps"] + } + } + } + ] + }, + { + "name": "TMLO API", + "description": "TMLO (Toepassingsprofiel Metadatering Lokale Overheden) metadata summary endpoint.", + "item": [ + { + "name": "Get TMLO Summary (expect 400 - not enabled)", + "event": [ + { + "listen": "prerequest", + "script": { + "type": "text/javascript", + "exec": [""] + } + }, + { + "listen": "test", + "script": { + "type": "text/javascript", + "exec": [ + "pm.test('Status code is 400 (TMLO not enabled)', function () {", + " pm.response.to.have.status(400);", + "});", + "", + "pm.test('Content-Type is JSON', function () {", + " pm.expect(pm.response.headers.get('Content-Type')).to.include('application/json');", + "});", + "", + "pm.test('Response is valid JSON with error', function () {", + " const json = pm.response.json();", + " pm.expect(json).to.be.an('object');", + "});" + ] + } + } + ], + "request": { + "method": "GET", + "header": [], + "url": { + "raw": "{{baseUrl}}/api/objects/voorzieningen/applicatie/tmlo/summary", + "host": ["{{baseUrl}}"], + "path": ["api", "objects", "voorzieningen", "applicatie", "tmlo", "summary"] + } + } + } + ] + } + ] +} \ No newline at end of file diff --git a/tests/validate-json-strict.js b/tests/validate-json-strict.js new file mode 100644 index 000000000000..2bd967d4b887 --- /dev/null +++ b/tests/validate-json-strict.js @@ -0,0 +1,182 @@ +#!/usr/bin/env node +// SPDX-License-Identifier: EUPL-1.2 +// Copyright (C) 2026 Conduction B.V. +// +// validate-json-strict.js — strict JSON parse of the structured config files +// (src/manifest.json and lib/Settings/*_register.json) that rejects DUPLICATE +// KEYS. Standard JSON.parse() silently keeps the last duplicate, which is how a +// bad merge of a register/manifest file can silently drop a schema or page (git +// merges JSON line-by-line and will happily produce a document with two +// `"Enrolment"` keys — see the scholiq Wave-2 incident). This guard fails CI on +// any such corruption before it reaches development. +// +// Usage: node tests/validate-json-strict.js +// Exit: 0 = all config JSON parses with no duplicate keys +// 1 = a duplicate key (or unparseable JSON) was found +// +// It also flags `appendOnly: true` nested inside an `x-openregister` block on a +// schema — OpenRegister's Schema::hydrate() only reads a TOP-LEVEL `appendOnly`, +// so a nested one is silently dropped and the schema is not actually append-only. + +'use strict' + +const fs = require('fs') +const path = require('path') + +const REPO_ROOT = path.resolve(__dirname, '..') + +// Files to check: the manifest + every *_register.json under lib/Settings/. +function targetFiles() { + const files = [] + const manifest = path.join(REPO_ROOT, 'src', 'manifest.json') + if (fs.existsSync(manifest)) files.push(manifest) + const settingsDir = path.join(REPO_ROOT, 'lib', 'Settings') + if (fs.existsSync(settingsDir)) { + for (const f of fs.readdirSync(settingsDir)) { + if (f.endsWith('_register.json') || f.endsWith('-register.json')) { + files.push(path.join(settingsDir, f)) + } + } + } + return files +} + +// Parse `text` and throw if any object literal contains a duplicate key. +// `pathPrefix` is the JSON-pointer-ish path used in the error message. +function parseStrict(text, label) { + const dupErrors = [] + const reviverPathStack = [] + // JSON.parse's reviver can't see duplicates (the object is already + // collapsed). So we re-implement just enough: tokenise object keys. + // Simpler robust approach: walk the raw text with a tiny tokenizer. + let i = 0 + const n = text.length + function err(msg) { + throw new SyntaxError(`${label}: ${msg} (at offset ${i})`) + } + function skipWs() { + while (i < n && (text[i] === ' ' || text[i] === '\t' || text[i] === '\n' || text[i] === '\r')) i++ + } + function readString() { + // assumes text[i] === '"' + i++ + let s = '' + while (i < n) { + const c = text[i++] + if (c === '"') return s + if (c === '\\') { + const e = text[i++] + if (e === 'u') { s += '\\u' + text.slice(i, i + 4); i += 4 } + else s += '\\' + e + } else s += c + } + err('unterminated string') + } + function readValue(pathStr) { + skipWs() + const c = text[i] + if (c === '{') return readObject(pathStr) + if (c === '[') return readArray(pathStr) + if (c === '"') { readString(); return } + // number / true / false / null — scan to a delimiter + while (i < n && !',}] \t\n\r'.includes(text[i])) i++ + } + function readArray(pathStr) { + i++ // [ + skipWs() + if (text[i] === ']') { i++; return } + let idx = 0 + // eslint-disable-next-line no-constant-condition + while (true) { + readValue(`${pathStr}/${idx}`) + idx++ + skipWs() + if (text[i] === ',') { i++; continue } + if (text[i] === ']') { i++; return } + err('expected , or ] in array') + } + } + function readObject(pathStr) { + i++ // { + skipWs() + const keys = new Set() + const objKeys = [] + if (text[i] === '}') { i++; return } + // eslint-disable-next-line no-constant-condition + while (true) { + skipWs() + if (text[i] !== '"') err('expected string key in object') + const key = readString() + if (keys.has(key)) { + dupErrors.push(`${pathStr || '/'}: DUPLICATE KEY "${key}"`) + } + keys.add(key) + objKeys.push(key) + skipWs() + if (text[i] !== ':') err('expected : after key') + i++ + readValue(`${pathStr}/${key}`) + // Flag nested appendOnly on a schema's x-openregister block: + // path looks like /components/schemas//x-openregister and key === 'appendOnly' + if (key === 'appendOnly' && /\/x-openregister$/.test(pathStr)) { + dupErrors.push(`${pathStr}/appendOnly: nested inside x-openregister — OpenRegister only reads a TOP-LEVEL appendOnly; move it to the schema root`) + } + skipWs() + if (text[i] === ',') { i++; continue } + if (text[i] === '}') { i++; return } + err('expected , or } in object') + } + } + readValue('') + skipWs() + if (i < n) err('trailing content after JSON value') + if (dupErrors.length > 0) { + const e = new SyntaxError(`${label}:\n - ${dupErrors.join('\n - ')}`) + e.dupErrors = dupErrors + throw e + } +} + +function main() { + const files = targetFiles() + if (files.length === 0) { + console.log('[validate-json-strict] no manifest or *_register.json found — nothing to check') + process.exit(0) + } + let failed = false + for (const file of files) { + const label = path.relative(REPO_ROOT, file) + let text + try { + text = fs.readFileSync(file, 'utf8') + } catch (e) { + console.error(`[validate-json-strict] cannot read ${label}: ${e.message}`) + failed = true + continue + } + // First: must be valid JSON at all. + try { + JSON.parse(text) + } catch (e) { + console.error(`[validate-json-strict] ${label}: invalid JSON — ${e.message}`) + failed = true + continue + } + // Then: strict pass (duplicate keys, nested appendOnly). + try { + parseStrict(text, label) + console.log(`[validate-json-strict] ${label}: OK`) + } catch (e) { + console.error(`[validate-json-strict] ${e.message}`) + failed = true + } + } + if (failed) { + console.error('[validate-json-strict] FAIL — fix the issues above.') + process.exit(1) + } + console.log('[validate-json-strict] PASS') + process.exit(0) +} + +main() diff --git a/tests/validate-manifest.js b/tests/validate-manifest.js new file mode 100644 index 000000000000..8be450d6408c --- /dev/null +++ b/tests/validate-manifest.js @@ -0,0 +1,175 @@ +#!/usr/bin/env node +// SPDX-License-Identifier: EUPL-1.2 +// Copyright (C) 2026 Conduction B.V. +// +// validate-manifest.js — schema-validates src/manifest.json against the +// @conduction/nextcloud-vue app-manifest schema using Ajv. +// +// Usage: +// node tests/validate-manifest.js +// +// Exit codes: +// 0 — manifest validates against the schema with zero errors +// 1 — manifest fails validation (or schema/manifest cannot be loaded) +// +// Schema lookup order (first hit wins): +// 1. Env var APP_MANIFEST_SCHEMA — explicit absolute path to a schema JSON +// 2. node_modules/@conduction/nextcloud-vue/src/schemas/app-manifest.schema.json +// 3. ../nextcloud-vue/src/schemas/app-manifest.schema.json (sibling worktree) +// 4. /tmp/worktrees/nextcloud-vue-manifest-v1/src/schemas/app-manifest.schema.json +// 5. /tmp/worktrees/nextcloud-vue-page-type-extensions/src/schemas/app-manifest.schema.json + +'use strict' + +const fs = require('fs') +const path = require('path') + +const REPO_ROOT = path.resolve(__dirname, '..') + +const MANIFEST_PATH = path.join(REPO_ROOT, 'src', 'manifest.json') + +const SCHEMA_CANDIDATES = [ + process.env.APP_MANIFEST_SCHEMA, + path.join(REPO_ROOT, 'node_modules', '@conduction', 'nextcloud-vue', 'src', 'schemas', 'app-manifest.schema.json'), + path.join(REPO_ROOT, '..', 'nextcloud-vue', 'src', 'schemas', 'app-manifest.schema.json'), + '/tmp/worktrees/nextcloud-vue-manifest-v1/src/schemas/app-manifest.schema.json', + '/tmp/worktrees/nextcloud-vue-page-type-extensions/src/schemas/app-manifest.schema.json', +].filter(Boolean) + +function findSchemaPath() { + for (const candidate of SCHEMA_CANDIDATES) { + try { + if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) { + return candidate + } + } catch (_) { + // continue to next candidate + } + } + return null +} + +function loadJson(file) { + const raw = fs.readFileSync(file, 'utf8') + return JSON.parse(raw) +} + +function loadAjv() { + // The canonical schema uses JSON Schema draft 2020-12. Standard Ajv (v7+) + // does not auto-load the 2020 meta-schema; we need the `ajv/dist/2020` + // entry point. + let Ajv2020 = null + let addFormats = null + try { + // Ajv 8+ ships the 2020 draft entry point. + Ajv2020 = require('ajv/dist/2020').default || require('ajv/dist/2020') + } catch (_) { + try { + // Fall back to standard Ajv. + Ajv2020 = require('ajv').default || require('ajv') + } catch (__) { + console.error('[validate-manifest] Ajv not installed in node_modules.') + console.error('[validate-manifest] Install with: npm i -D ajv ajv-formats') + console.error('[validate-manifest] Falling back to a structural lint pass.') + return { Ajv: null, addFormats: null } + } + } + try { + addFormats = require('ajv-formats').default || require('ajv-formats') + } catch (_) { + // ajv-formats is optional; the schema uses "uri" format on $schema + // which without ajv-formats is silently accepted. + addFormats = null + } + return { Ajv: Ajv2020, addFormats } +} + +function structuralLint(manifest) { + // Minimal structural fallback when Ajv isn't available. + const errors = [] + if (!manifest.version || typeof manifest.version !== 'string') { + errors.push('top-level: version (string) is required') + } + if (!Array.isArray(manifest.menu)) errors.push('top-level: menu (array) is required') + if (!Array.isArray(manifest.pages)) errors.push('top-level: pages (array) is required') + const allowedTypes = new Set(['index', 'detail', 'dashboard', 'logs', 'settings', 'chat', 'files', 'custom']) + const seenIds = new Set() + for (let i = 0; i < (manifest.pages || []).length; i++) { + const page = manifest.pages[i] + if (!page || typeof page !== 'object') { + errors.push(`pages[${i}]: must be an object`) + continue + } + for (const required of ['id', 'route', 'type', 'title']) { + if (!page[required] || typeof page[required] !== 'string') { + errors.push(`pages[${i}]: missing required string field "${required}"`) + } + } + if (page.type && !allowedTypes.has(page.type)) { + errors.push(`pages[${i}].type: "${page.type}" not in known enum`) + } + if (page.id) { + if (seenIds.has(page.id)) errors.push(`pages[${i}].id: duplicate "${page.id}"`) + seenIds.add(page.id) + } + } + return errors +} + +function main() { + if (!fs.existsSync(MANIFEST_PATH)) { + // openregister is the foundation app — no CnAppRoot manifest expected. + // Skip cleanly instead of failing CI. + console.log(`[validate-manifest] no src/manifest.json (foundation app) — skipping`) + process.exit(0) + } + + const manifest = loadJson(MANIFEST_PATH) + console.log(`[validate-manifest] manifest: ${MANIFEST_PATH}`) + console.log(`[validate-manifest] manifest.version: ${manifest.version}`) + console.log(`[validate-manifest] pages: ${(manifest.pages || []).length}`) + + const schemaPath = findSchemaPath() + if (!schemaPath) { + console.warn('[validate-manifest] no schema candidate resolved; falling back to structural lint.') + const errors = structuralLint(manifest) + if (errors.length === 0) { + console.log('[validate-manifest] structural lint: PASS (0 issues)') + process.exit(0) + } + console.error('[validate-manifest] structural lint: FAIL') + for (const err of errors) console.error(` - ${err}`) + process.exit(1) + } + console.log(`[validate-manifest] schema: ${schemaPath}`) + const schema = loadJson(schemaPath) + console.log(`[validate-manifest] schema.version: ${schema.version || '(unset)'}`) + + const { Ajv, addFormats } = loadAjv() + if (!Ajv) { + const errors = structuralLint(manifest) + if (errors.length === 0) { + console.log('[validate-manifest] structural lint (no Ajv): PASS (0 issues)') + process.exit(0) + } + console.error('[validate-manifest] structural lint (no Ajv): FAIL') + for (const err of errors) console.error(` - ${err}`) + process.exit(1) + } + + const ajv = new Ajv({ allErrors: true, strict: false }) + if (addFormats) addFormats(ajv) + const validate = ajv.compile(schema) + const ok = validate(manifest) + if (ok) { + console.log('[validate-manifest] Ajv validation: PASS (0 errors)') + process.exit(0) + } + console.error('[validate-manifest] Ajv validation: FAIL') + for (const err of validate.errors || []) { + console.error(` - ${err.instancePath || '(root)'} ${err.message} (keyword=${err.keyword})`) + } + process.exit(1) +} + +main() diff --git a/tests/validate-register.js b/tests/validate-register.js new file mode 100644 index 000000000000..0674856307c7 --- /dev/null +++ b/tests/validate-register.js @@ -0,0 +1,227 @@ +#!/usr/bin/env node +// SPDX-License-Identifier: EUPL-1.2 +// Copyright (C) 2026 Conduction B.V. +// +// validate-register.js — structural validation of the OpenRegister register +// seed (lib/Settings/*_register.json). Catches the classes of bug seen in +// scholiq Wave 2 *before* they reach development: +// - a schema lost its x-openregister-* declarations / half its properties +// (clobbered by a bad merge) — flagged via a too-thin-schema heuristic +// - appendOnly nested in x-openregister instead of at the schema root +// (silently dropped by OpenRegister) — also flagged here +// - a lifecycle transition `requires:` referencing a PHP class that doesn't +// exist as a file under lib/ (scholiq's missing CoursePublishGuard) +// - lifecycle transition `to`/`from` states that aren't declared anywhere +// - duplicate slugs across schemas +// +// Optional deep check: if OR_BASE_URL + OR_BASIC_AUTH env vars are set, POST +// the register to OpenRegister's schema-validation endpoint. Skipped by default +// (CI has no OR instance). +// +// Usage: node tests/validate-register.js +// Exit: 0 = register is structurally sound 1 = problems found + +'use strict' + +const fs = require('fs') +const path = require('path') + +const REPO_ROOT = path.resolve(__dirname, '..') + +function registerFiles() { + const dir = path.join(REPO_ROOT, 'lib', 'Settings') + if (!fs.existsSync(dir)) return [] + return fs.readdirSync(dir) + .filter((f) => f.endsWith('_register.json') || f.endsWith('-register.json')) + .map((f) => path.join(dir, f)) +} + +// Collect every PHP class file under lib/ as a set of fully-qualified-ish names. +// We only need the class shortname → exists check, plus a namespace-tail match. +function phpClassIndex(appNamespace) { + const libDir = path.join(REPO_ROOT, 'lib') + const found = new Set() + function walk(d) { + for (const entry of fs.readdirSync(d, { withFileTypes: true })) { + const p = path.join(d, entry.name) + if (entry.isDirectory()) walk(p) + else if (entry.name.endsWith('.php')) { + const rel = path.relative(libDir, p).replace(/\.php$/, '').split(path.sep) + // e.g. ['Lifecycle','CoursePublishGuard'] → OCA\\Lifecycle\CoursePublishGuard + found.add(`${appNamespace}\\${rel.join('\\')}`) + found.add(rel[rel.length - 1]) // shortname fallback + } + } + } + if (fs.existsSync(libDir)) walk(libDir) + return found +} + +// Derive the PHP namespace OCA\ from appinfo/info.xml's . +function appNamespace() { + const infoXml = path.join(REPO_ROOT, 'appinfo', 'info.xml') + if (!fs.existsSync(infoXml)) return null + const m = fs.readFileSync(infoXml, 'utf8').match(/([^<]+)<\/id>/) + if (!m) return null + // app id like "openconnector" or "app-template" → namespace "OpenConnector" / "AppTemplate" + const camel = m[1].split(/[-_]/).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join('') + return `OCA\\${camel}` +} + +function collectRequires(node, acc) { + if (node === null || typeof node !== 'object') return + if (Array.isArray(node)) { node.forEach((n) => collectRequires(n, acc)); return } + for (const [k, v] of Object.entries(node)) { + if (k === 'requires') { + if (typeof v === 'string') acc.push(v) + else if (Array.isArray(v)) v.forEach((s) => { if (typeof s === 'string') acc.push(s) }) + } else { + collectRequires(v, acc) + } + } +} + +function lifecycleStates(lc) { + // lc is an x-openregister-lifecycle block; shapes vary slightly across the + // fleet: {states:{...},transitions:{...}} or {transitions:{name:{from,to}}}. + const states = new Set() + if (!lc || typeof lc !== 'object') return states + if (lc.states && typeof lc.states === 'object') Object.keys(lc.states).forEach((s) => states.add(s)) + if (lc.initial) states.add(lc.initial) + if (lc.initialState) states.add(lc.initialState) + if (lc.default) states.add(lc.default) + const tr = lc.transitions || {} + for (const t of Object.values(tr)) { + if (t && typeof t === 'object') { + if (typeof t.to === 'string') states.add(t.to) + if (typeof t.from === 'string') states.add(t.from) + if (Array.isArray(t.from)) t.from.forEach((f) => states.add(f)) + } + } + states.delete(null) + return states +} + +function validateRegister(file, errors, warnings) { + const label = path.relative(REPO_ROOT, file) + let reg + try { + reg = JSON.parse(fs.readFileSync(file, 'utf8')) + } catch (e) { + errors.push(`${label}: invalid JSON — ${e.message}`) + return + } + const xo = reg['x-openregister'] + if (!xo || typeof xo !== 'object' || !xo.type || !xo.app) { + errors.push(`${label}: missing or incomplete top-level x-openregister block (needs at least { type, app })`) + } + const schemas = (reg.components && reg.components.schemas) || null + if (!schemas || typeof schemas !== 'object' || Object.keys(schemas).length === 0) { + errors.push(`${label}: components.schemas is empty`) + return + } + + const ns = appNamespace() + const phpIndex = phpClassIndex(ns || '') + const slugSeen = new Map() + + for (const [name, s] of Object.entries(schemas)) { + const at = `${label} › ${name}` + if (!s || typeof s !== 'object') { errors.push(`${at}: not an object`); continue } + // slug + if (typeof s.slug !== 'string' || s.slug.length === 0) errors.push(`${at}: missing string "slug"`) + else { + if (slugSeen.has(s.slug)) errors.push(`${at}: slug "${s.slug}" duplicates ${slugSeen.get(s.slug)}`) + slugSeen.set(s.slug, name) + } + // shape + if (s.type !== 'object') warnings.push(`${at}: "type" is not "object" (got ${JSON.stringify(s.type)})`) + if (!Array.isArray(s.required)) warnings.push(`${at}: "required" is not an array`) + const props = s.properties && typeof s.properties === 'object' ? Object.keys(s.properties) : [] + if (props.length === 0) errors.push(`${at}: "properties" is empty — schema looks clobbered (a merge may have replaced it with a stub)`) + // "too thin to be real" heuristic: a schema that declares a lifecycle/calc/notif/agg + // elsewhere but here has ≤3 properties and no x-openregister-* at all is suspect. + const xKeys = Object.keys(s).filter((k) => k.startsWith('x-openregister')) + if (props.length > 0 && props.length <= 3 && xKeys.filter((k) => k !== 'x-openregister-seed').length === 0) { + warnings.push(`${at}: only ${props.length} properties and no x-openregister-* declarations — verify this isn't a stub left by a bad merge`) + } + // appendOnly placement + if (s['x-openregister'] && typeof s['x-openregister'] === 'object' && s['x-openregister'].appendOnly !== undefined) { + errors.push(`${at}: appendOnly is nested inside x-openregister — OpenRegister only reads a TOP-LEVEL appendOnly; move it to the schema root`) + } + // lifecycle requires → PHP class must exist + const requires = [] + collectRequires(s['x-openregister-lifecycle'] || {}, requires) + for (const cls of requires) { + const short = cls.split('\\').pop() + if (!phpIndex.has(cls) && !phpIndex.has(short)) { + errors.push(`${at}: lifecycle requires "${cls}" but no matching PHP class found under lib/ (looked for "${cls}" and shortname "${short}")`) + } + } + // lifecycle transition target states should be declared + const lc = s['x-openregister-lifecycle'] + if (lc && lc.transitions && lc.states) { + const declared = new Set(Object.keys(lc.states)) + for (const [tn, t] of Object.entries(lc.transitions)) { + if (t && typeof t.to === 'string' && !declared.has(t.to)) { + warnings.push(`${at}: transition "${tn}" → "${t.to}" but "${t.to}" is not in states{}`) + } + } + } + void lifecycleStates // (helper retained for future deeper checks) + } +} + +async function deepValidate(files, errors) { + const base = process.env.OR_BASE_URL + const auth = process.env.OR_BASIC_AUTH // "user:pass" + if (!base || !auth) return // skipped silently — no OR instance in CI + const fetchFn = global.fetch + if (!fetchFn) { errors.push('OR_BASE_URL set but global fetch unavailable (need Node 18+)'); return } + for (const file of files) { + const json = fs.readFileSync(file, 'utf8') + try { + const res = await fetchFn(`${base.replace(/\/$/, '')}/index.php/apps/openregister/api/configurations/validate`, { + method: 'POST', + headers: { + 'Content-Type': 'application/json', + 'OCS-APIRequest': 'true', + Authorization: 'Basic ' + Buffer.from(auth).toString('base64'), + }, + body: JSON.stringify({ json }), + }) + if (!res.ok) errors.push(`${path.relative(REPO_ROOT, file)}: OR validate endpoint returned ${res.status}`) + else { + const body = await res.json().catch(() => ({})) + if (body && Array.isArray(body.errors) && body.errors.length) { + errors.push(`${path.relative(REPO_ROOT, file)}: OR reported ${body.errors.length} schema errors`) + } + } + } catch (e) { + errors.push(`${path.relative(REPO_ROOT, file)}: OR validate call failed — ${e.message}`) + } + } +} + +async function main() { + const files = registerFiles() + if (files.length === 0) { + console.log('[validate-register] no lib/Settings/*_register.json found — nothing to check') + process.exit(0) + } + const errors = [] + const warnings = [] + for (const file of files) validateRegister(file, errors, warnings) + await deepValidate(files, errors) + + for (const w of warnings) console.warn(`[validate-register] WARN ${w}`) + for (const e of errors) console.error(`[validate-register] ERROR ${e}`) + if (errors.length > 0) { + console.error(`[validate-register] FAIL — ${errors.length} error(s), ${warnings.length} warning(s).`) + process.exit(1) + } + console.log(`[validate-register] PASS — ${files.length} register file(s), ${warnings.length} warning(s).`) + process.exit(0) +} + +main() From 8beaff55e94c9d64e14277e4a29c875f6e56c96b Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 10:58:36 +0200 Subject: [PATCH 048/333] chore(spec-collect): bring in 50 spec.md files from feat/1435/anonymisation-specs --- .../specs/action-registry/spec.md | 444 ++++++++++++ .../specs/activity-provider/spec.md | 265 +++++++ .../specs/archivering-vernietiging/spec.md | 85 +++ .../specs/actions/spec.md | 202 ++++++ .../specs/approval-workflow/spec.md | 138 ++++ .../specs/oas-generation/spec.md | 72 ++ .../specs/archivering-vernietiging/spec.md | 570 +++++++++++++++ .../auth-system/specs/auth-system/spec.md | 487 +++++++++++++ .../specs/avg-verwerkingsregister/spec.md | 604 ++++++++++++++++ .../specs/besluiten-management/spec.md | 664 ++++++++++++++++++ .../specs/calendar-provider/spec.md | 382 ++++++++++ .../specs/computed-fields/spec.md | 508 ++++++++++++++ .../specs/contacts-actions/spec.md | 261 +++++++ .../specs/data-import-export/spec.md | 346 +++++++++ .../specs/data-sync-harvesting/spec.md | 571 +++++++++++++++ .../deprecate-published-metadata/spec.md | 59 ++ .../specs/faceting-configuration/spec.md | 67 ++ .../specs/datetime-input-handling/spec.md | 136 ++++ .../specs/schema-driven-read-coercion/spec.md | 157 +++++ .../specs/nextcloud-api-compat/spec.md | 81 +++ .../specs/object-interactions/spec.md | 110 +++ .../mail-sidebar/specs/mail-sidebar/spec.md | 442 ++++++++++++ .../specs/mail-smart-picker/spec.md | 236 +++++++ .../mcp-discovery/specs/mcp-discovery/spec.md | 353 ++++++++++ .../specs/mock-registers/spec.md | 246 +++++++ .../specs/nextcloud-entity-relations/spec.md | 441 ++++++++++++ .../specs/object-interactions/spec.md | 327 +++++++++ .../specs/openapi-generation/spec.md | 456 ++++++++++++ .../specs/files-render-extension/spec.md | 169 +++++ .../specs/production-observability/spec.md | 374 ++++++++++ .../specs/profile-actions/spec.md | 343 +++++++++ .../specs/rapportage-bi-export/spec.md | 486 +++++++++++++ .../rbac-scopes/specs/rbac-scopes/spec.md | 415 +++++++++++ .../rbac-zaaktype/specs/rbac-zaaktype/spec.md | 528 ++++++++++++++ .../specs/realtime-updates/spec.md | 441 ++++++++++++ .../reference-existence-validation/spec.md | 541 ++++++++++++++ .../specs/referential-integrity/spec.md | 501 +++++++++++++ .../register-i18n/specs/register-i18n/spec.md | 536 ++++++++++++++ .../specs/row-field-level-security/spec.md | 494 +++++++++++++ openspec/changes/seed-related-items/spec.md | 130 ++++ .../specs/tmlo-auto-populate/spec.md | 41 ++ .../tmlo-metadata/specs/tmlo-export/spec.md | 33 + .../specs/tmlo-metadata-schema/spec.md | 38 + .../specs/tmlo-query-api/spec.md | 39 + .../specs/tmlo-register-toggle/spec.md | 38 + .../specs/tmlo-validation/spec.md | 51 ++ .../specs/rbac-scopes/spec.md | 130 ++++ .../specs/unit-test-coverage/spec.md | 484 +++++++++++++ .../specs/urn-resource-addressing/spec.md | 606 ++++++++++++++++ .../specs/workflow-operations/spec.md | 267 +++++++ 50 files changed, 15395 insertions(+) create mode 100644 openspec/changes/action-registry/specs/action-registry/spec.md create mode 100644 openspec/changes/activity-provider/specs/activity-provider/spec.md create mode 100644 openspec/changes/archival-destruction-workflow/specs/archivering-vernietiging/spec.md create mode 100644 openspec/changes/archive/2026-05-01-retrofit-actions-2026-05-01/specs/actions/spec.md create mode 100644 openspec/changes/archive/2026-05-01-retrofit-approval-workflow-2026-05-01/specs/approval-workflow/spec.md create mode 100644 openspec/changes/archive/2026-05-01-retrofit-oas-generation-2026-05-01/specs/oas-generation/spec.md create mode 100644 openspec/changes/archivering-vernietiging/specs/archivering-vernietiging/spec.md create mode 100644 openspec/changes/auth-system/specs/auth-system/spec.md create mode 100644 openspec/changes/avg-verwerkingsregister/specs/avg-verwerkingsregister/spec.md create mode 100644 openspec/changes/besluiten-management/specs/besluiten-management/spec.md create mode 100644 openspec/changes/calendar-provider/specs/calendar-provider/spec.md create mode 100644 openspec/changes/computed-fields/specs/computed-fields/spec.md create mode 100644 openspec/changes/contacts-actions/specs/contacts-actions/spec.md create mode 100644 openspec/changes/data-import-export/specs/data-import-export/spec.md create mode 100644 openspec/changes/data-sync-harvesting/specs/data-sync-harvesting/spec.md create mode 100644 openspec/changes/deprecate-published-metadata/specs/deprecate-published-metadata/spec.md create mode 100644 openspec/changes/fix-date-histogram-mariadb/specs/faceting-configuration/spec.md create mode 100644 openspec/changes/fix-empty-string-date-conversion/specs/datetime-input-handling/spec.md create mode 100644 openspec/changes/fix-magic-table-type-coercion/specs/schema-driven-read-coercion/spec.md create mode 100644 openspec/changes/fix-nc34-server-accessor-removals/specs/nextcloud-api-compat/spec.md create mode 100644 openspec/changes/fix-object-files-listing-lock-and-limit/specs/object-interactions/spec.md create mode 100644 openspec/changes/mail-sidebar/specs/mail-sidebar/spec.md create mode 100644 openspec/changes/mail-smart-picker/specs/mail-smart-picker/spec.md create mode 100644 openspec/changes/mcp-discovery/specs/mcp-discovery/spec.md create mode 100644 openspec/changes/mock-registers/specs/mock-registers/spec.md create mode 100644 openspec/changes/nextcloud-entity-relations/specs/nextcloud-entity-relations/spec.md create mode 100644 openspec/changes/object-interactions/specs/object-interactions/spec.md create mode 100644 openspec/changes/openapi-generation/specs/openapi-generation/spec.md create mode 100644 openspec/changes/opt-in-files-extend/specs/files-render-extension/spec.md create mode 100644 openspec/changes/production-observability/specs/production-observability/spec.md create mode 100644 openspec/changes/profile-actions/specs/profile-actions/spec.md create mode 100644 openspec/changes/rapportage-bi-export/specs/rapportage-bi-export/spec.md create mode 100644 openspec/changes/rbac-scopes/specs/rbac-scopes/spec.md create mode 100644 openspec/changes/rbac-zaaktype/specs/rbac-zaaktype/spec.md create mode 100644 openspec/changes/realtime-updates/specs/realtime-updates/spec.md create mode 100644 openspec/changes/reference-existence-validation/specs/reference-existence-validation/spec.md create mode 100644 openspec/changes/referential-integrity/specs/referential-integrity/spec.md create mode 100644 openspec/changes/register-i18n/specs/register-i18n/spec.md create mode 100644 openspec/changes/row-field-level-security/specs/row-field-level-security/spec.md create mode 100644 openspec/changes/seed-related-items/spec.md create mode 100644 openspec/changes/tmlo-metadata/specs/tmlo-auto-populate/spec.md create mode 100644 openspec/changes/tmlo-metadata/specs/tmlo-export/spec.md create mode 100644 openspec/changes/tmlo-metadata/specs/tmlo-metadata-schema/spec.md create mode 100644 openspec/changes/tmlo-metadata/specs/tmlo-query-api/spec.md create mode 100644 openspec/changes/tmlo-metadata/specs/tmlo-register-toggle/spec.md create mode 100644 openspec/changes/tmlo-metadata/specs/tmlo-validation/spec.md create mode 100644 openspec/changes/unify-rbac-condition-matching/specs/rbac-scopes/spec.md create mode 100644 openspec/changes/unit-test-coverage/specs/unit-test-coverage/spec.md create mode 100644 openspec/changes/urn-resource-addressing/specs/urn-resource-addressing/spec.md create mode 100644 openspec/changes/workflow-operations/specs/workflow-operations/spec.md diff --git a/openspec/changes/action-registry/specs/action-registry/spec.md b/openspec/changes/action-registry/specs/action-registry/spec.md new file mode 100644 index 000000000000..c874e5d2c7a5 --- /dev/null +++ b/openspec/changes/action-registry/specs/action-registry/spec.md @@ -0,0 +1,444 @@ +--- +status: proposed +--- + +# Action Registry + +## Purpose +The Action Registry introduces a first-class `Action` entity that decouples automation definitions from schemas, making workflow triggers reusable, discoverable, composable, and independently manageable. Actions wrap the existing hook/workflow infrastructure (HookExecutor, WorkflowEngineRegistry, CloudEventFormatter) with a proper entity lifecycle, CRUD API, RBAC, audit trail, and scheduling capabilities. This replaces the pattern of embedding hook configurations as JSON blobs inside schema entities with a normalized, relational model where actions are standalone entities that can be bound to one or more schemas, registers, or event types. + +**Source**: Internal requirement driven by growing complexity of hook management across 10+ entity types with 39+ event classes. Government tender analysis shows 38% of tenders require workflow automation with auditability and governance controls. + +**Cross-references**: schema-hooks (current inline hook system, to be augmented), workflow-integration (engine adapters and execution), event-driven-architecture (event dispatch infrastructure), webhook-payload-mapping (mapping transformations for action payloads). + +## Requirements + +### Requirement 1: Action MUST be a first-class Nextcloud database entity with full CRUD lifecycle +The `Action` entity MUST be stored in the `oc_openregister_actions` table with a complete set of fields covering identity, trigger configuration, execution parameters, lifecycle state, and audit metadata. The entity MUST extend `OCP\AppFramework\Db\Entity` and implement `JsonSerializable`. A corresponding `ActionMapper` MUST extend Nextcloud's `QBMapper` for database operations. + +#### Scenario: Create a new Action entity +- **GIVEN** an administrator with write access to OpenRegister +- **WHEN** a POST request is sent to `/api/actions` with a valid action definition +- **THEN** a new `Action` entity MUST be persisted in `oc_openregister_actions` +- **AND** the entity MUST have an auto-generated UUID (v4) in the `uuid` field +- **AND** `created` and `updated` timestamps MUST be set automatically +- **AND** `status` MUST default to `'draft'` if not provided +- **AND** an `ActionCreatedEvent` MUST be dispatched via `IEventDispatcher::dispatchTyped()` + +#### Scenario: Action entity field definitions +- **GIVEN** the `oc_openregister_actions` table schema +- **THEN** the table MUST include the following columns: + - `id` (integer, primary key, auto-increment) + - `uuid` (string, unique, indexed) -- external identifier + - `name` (string, required) -- human-readable name + - `slug` (string, unique, indexed) -- URL-safe identifier + - `description` (text, nullable) -- purpose and documentation + - `version` (string, nullable, default `'1.0.0'`) -- semantic version + - `status` (string, default `'draft'`) -- lifecycle state: draft, active, disabled, archived + - `event_type` (string, required) -- the event class name or pattern this action responds to (e.g., `'ObjectCreatingEvent'`, `'Object*Event'`, `'RegisterUpdatedEvent'`) + - `engine` (string, required) -- workflow engine identifier (e.g., `'n8n'`, `'windmill'`) + - `workflow_id` (string, required) -- identifier of the workflow in the engine + - `mode` (string, default `'sync'`) -- execution mode: `sync` or `async` + - `execution_order` (integer, default `0`) -- ordering when multiple actions match the same event + - `timeout` (integer, default `30`) -- execution timeout in seconds + - `on_failure` (string, default `'reject'`) -- failure behavior: reject, allow, flag, queue + - `on_timeout` (string, default `'reject'`) -- timeout behavior: reject, allow, flag + - `on_engine_down` (string, default `'allow'`) -- engine-unavailable behavior: allow, reject, queue + - `filter_condition` (json, nullable) -- JSON object with key-value pairs for event payload filtering + - `configuration` (json, nullable) -- additional key-value configuration passed to the workflow + - `mapping` (integer, nullable) -- reference to a Mapping entity for payload transformation + - `schemas` (json, nullable) -- array of schema IDs/UUIDs this action is bound to + - `registers` (json, nullable) -- array of register IDs/UUIDs this action is scoped to + - `schedule` (string, nullable) -- cron expression for scheduled execution (e.g., `'*/5 * * * *'`) + - `max_retries` (integer, default `3`) -- maximum retry attempts on failure + - `retry_policy` (string, default `'exponential'`) -- retry backoff strategy: exponential, linear, fixed + - `enabled` (boolean, default `true`) -- whether the action is currently active + - `owner` (string, nullable) -- Nextcloud user ID of the owner + - `application` (string, nullable) -- application scope for multi-tenancy + - `organisation` (string, nullable) -- organisation scope for multi-tenancy + - `last_executed_at` (datetime, nullable) -- timestamp of last execution + - `execution_count` (integer, default `0`) -- total execution counter + - `success_count` (integer, default `0`) -- successful execution counter + - `failure_count` (integer, default `0`) -- failed execution counter + - `created` (datetime) -- creation timestamp + - `updated` (datetime) -- last update timestamp + - `deleted` (datetime, nullable) -- soft-delete timestamp + +#### Scenario: Update an existing Action entity +- **GIVEN** an action `validate-bsn` exists with status `'draft'` +- **WHEN** a PUT request is sent to `/api/actions/{id}` with `status: 'active'` +- **THEN** the action's status MUST be updated to `'active'` +- **AND** the `updated` timestamp MUST be refreshed +- **AND** an `ActionUpdatedEvent` MUST be dispatched + +#### Scenario: Soft-delete an Action entity +- **GIVEN** an action `validate-bsn` exists with status `'active'` +- **WHEN** a DELETE request is sent to `/api/actions/{id}` +- **THEN** the action MUST NOT be physically deleted from the database +- **AND** the `deleted` timestamp MUST be set to the current datetime +- **AND** the `status` MUST be changed to `'archived'` +- **AND** an `ActionDeletedEvent` MUST be dispatched +- **AND** the action MUST no longer match incoming events (skipped by ActionListener) + +#### Scenario: Partial update via PATCH +- **GIVEN** an action `validate-bsn` exists +- **WHEN** a PATCH request is sent to `/api/actions/{id}` with `{ "timeout": 60 }` +- **THEN** only the `timeout` field MUST be updated +- **AND** all other fields MUST remain unchanged +- **AND** the `updated` timestamp MUST be refreshed + +### Requirement 2: Actions MUST support binding to multiple schemas via a many-to-many relationship +An action MUST be bindable to zero or more schemas. When bound to a schema, the action fires on object lifecycle events for that schema. When bound to no schemas and the event_type is an object event, the action fires for ALL schemas (global action). The `schemas` field stores an array of schema identifiers. + +#### Scenario: Action bound to specific schemas +- **GIVEN** action `validate-bsn` is configured with `schemas: ["schema-uuid-1", "schema-uuid-2"]` and `event_type: 'ObjectCreatingEvent'` +- **WHEN** an `ObjectCreatingEvent` fires for an object with schema `schema-uuid-1` +- **THEN** the action MUST be executed +- **AND** when an `ObjectCreatingEvent` fires for schema `schema-uuid-3` +- **THEN** the action MUST NOT be executed + +#### Scenario: Global action with no schema binding +- **GIVEN** action `audit-all-changes` is configured with `schemas: []` (empty) and `event_type: 'ObjectUpdatedEvent'` +- **WHEN** an `ObjectUpdatedEvent` fires for ANY schema +- **THEN** the action MUST be executed for every schema +- **AND** the `filter_condition` MAY further restrict execution based on payload attributes + +#### Scenario: Action bound to register scope +- **GIVEN** action `notify-register-admin` is configured with `registers: ["register-uuid-1"]` and `event_type: 'ObjectCreatedEvent'` +- **WHEN** an `ObjectCreatedEvent` fires for an object in register `register-uuid-1` +- **THEN** the action MUST be executed +- **AND** when the event fires for an object in a different register, the action MUST NOT be executed + +#### Scenario: Combined schema and register filtering +- **GIVEN** action `validate-permit` with `schemas: ["vergunningen-uuid"]` and `registers: ["zaken-register-uuid"]` +- **WHEN** an event fires for schema `vergunningen-uuid` in register `zaken-register-uuid` +- **THEN** the action MUST be executed (both filters match) +- **AND** when the event fires for schema `vergunningen-uuid` in a DIFFERENT register +- **THEN** the action MUST NOT be executed (register filter does not match) + +### Requirement 3: Actions MUST support all entity event types including non-object events +Actions MUST not be limited to object lifecycle events. They MUST support binding to any of the 39+ event types dispatched by OpenRegister, including register, schema, source, configuration, view, agent, application, conversation, and organisation lifecycle events. The `event_type` field supports exact class names and `fnmatch()` wildcard patterns. + +#### Scenario: Action responds to RegisterUpdatedEvent +- **GIVEN** action `sync-register-metadata` with `event_type: 'RegisterUpdatedEvent'` +- **WHEN** a register is updated and `RegisterUpdatedEvent` is dispatched +- **THEN** the `ActionListener` MUST match this action and execute the configured workflow +- **AND** the CloudEvents payload MUST contain the register entity data + +#### Scenario: Action responds to SchemaCreatedEvent +- **GIVEN** action `initialize-schema-defaults` with `event_type: 'SchemaCreatedEvent'` +- **WHEN** a new schema is created +- **THEN** the action MUST fire and the workflow MUST receive the schema entity data + +#### Scenario: Wildcard event_type matching +- **GIVEN** action `log-all-object-events` with `event_type: 'Object*Event'` +- **WHEN** any object lifecycle event fires (ObjectCreatingEvent, ObjectCreatedEvent, ObjectUpdatingEvent, ObjectUpdatedEvent, ObjectDeletingEvent, ObjectDeletedEvent, ObjectLockedEvent, ObjectUnlockedEvent, ObjectRevertedEvent) +- **THEN** the action MUST match and execute for each of these events +- **AND** when a `RegisterCreatedEvent` fires, the action MUST NOT match + +#### Scenario: Multiple event_type values +- **GIVEN** action `dual-trigger` with `event_type` stored as a JSON array `['ObjectCreatedEvent', 'ObjectUpdatedEvent']` +- **WHEN** an `ObjectCreatedEvent` fires +- **THEN** the action MUST match +- **AND** when an `ObjectDeletedEvent` fires, the action MUST NOT match + +### Requirement 4: ActionListener MUST replace/augment HookListener for action-based event handling +A new `ActionListener` MUST be registered in `Application::registerEventListeners()` for all event types. When an event is dispatched, `ActionListener` MUST query `ActionMapper` for all enabled, active actions matching the event type, filter by schema/register scope, apply filter conditions, sort by `execution_order`, and delegate execution to the existing `HookExecutor` infrastructure (or a new `ActionExecutor` that wraps it). + +#### Scenario: ActionListener resolves matching actions for ObjectCreatingEvent +- **GIVEN** three actions exist: + - `validate-bsn` (event_type: `ObjectCreatingEvent`, schemas: `["meldingen-uuid"]`, status: `active`, enabled: `true`) + - `enrich-address` (event_type: `ObjectCreatingEvent`, schemas: `["meldingen-uuid"]`, status: `active`, enabled: `true`) + - `audit-log` (event_type: `Object*Event`, schemas: `[]`, status: `active`, enabled: `true`) +- **WHEN** an `ObjectCreatingEvent` fires for schema `meldingen-uuid` +- **THEN** `ActionListener` MUST resolve all three actions as matching +- **AND** sort them by `execution_order` ascending +- **AND** execute them sequentially via `ActionExecutor` + +#### Scenario: ActionListener skips disabled and non-active actions +- **GIVEN** action `validate-bsn` has `enabled: false` or `status: 'draft'` +- **WHEN** a matching event fires +- **THEN** the action MUST be skipped by `ActionListener` +- **AND** a debug-level log MUST note the skip reason + +#### Scenario: ActionListener coexists with HookListener +- **GIVEN** a schema has both inline hooks (via `getHooks()`) AND bound actions (via Action entities) +- **WHEN** an event fires +- **THEN** both `HookListener` (for inline hooks) and `ActionListener` (for Action entities) MUST execute +- **AND** inline hooks MUST execute BEFORE action-registry actions (preserving backward compatibility) +- **AND** if an inline hook stops propagation, action-registry actions MUST also be skipped + +#### Scenario: Pre-mutation action can reject the operation +- **GIVEN** action `validate-bsn` with `event_type: 'ObjectCreatingEvent'` and `mode: 'sync'` +- **WHEN** the workflow returns `status: 'rejected'` with errors +- **THEN** `ActionExecutor` MUST call `$event->stopPropagation()` and `$event->setErrors()` +- **AND** the object MUST NOT be persisted +- **AND** subsequent actions in the execution order MUST be skipped + +#### Scenario: Post-mutation action executes after persistence +- **GIVEN** action `send-notification` with `event_type: 'ObjectCreatedEvent'` and `mode: 'async'` +- **WHEN** the object has been persisted and `ObjectCreatedEvent` fires +- **THEN** the action MUST execute in fire-and-forget mode +- **AND** failure of the async action MUST NOT affect the already-persisted object + +### Requirement 5: Actions MUST support filter conditions for fine-grained event matching +Beyond schema/register binding, actions MUST support a `filter_condition` JSON object that matches against the event payload using dot-notation keys. An action only fires if ALL filter conditions match. This uses the same mechanism as webhook filters (`WebhookService::matchesFilters()`). + +#### Scenario: Filter by object property value +- **GIVEN** action `escalate-critical` with `filter_condition: { "data.object.priority": "critical" }` +- **WHEN** an `ObjectCreatedEvent` fires for an object with `priority: 'critical'` +- **THEN** the action MUST match and execute +- **AND** when the object has `priority: 'low'`, the action MUST NOT execute + +#### Scenario: Filter with array values for multi-match +- **GIVEN** action `track-status-changes` with `filter_condition: { "data.object.status": ["open", "in_progress"] }` +- **WHEN** an event fires for an object with `status: 'open'` +- **THEN** the action MUST match (value is in the array) +- **AND** when `status: 'closed'`, the action MUST NOT match + +#### Scenario: Empty filter_condition matches all payloads +- **GIVEN** action `log-everything` with `filter_condition: null` or `{}` +- **WHEN** any matching event fires (based on event_type and schema/register scope) +- **THEN** the action MUST always execute (no payload filtering applied) + +#### Scenario: Nested dot-notation filtering +- **GIVEN** action `monitor-register-5` with `filter_condition: { "data.register": 5 }` +- **WHEN** an `ObjectCreatedEvent` fires with register ID 5 in the payload +- **THEN** the action MUST match +- **AND** when register ID is 8, the action MUST NOT match + +### Requirement 6: Actions MUST support scheduled (cron-based) execution +Actions with a `schedule` field (cron expression) MUST be executable on a time-based schedule via a Nextcloud `TimedJob`. The `ActionScheduleJob` MUST evaluate all actions with non-null `schedule` fields and execute them at the appropriate intervals. Scheduled actions do not respond to events -- they run independently on a timer. + +#### Scenario: Action with cron schedule +- **GIVEN** action `daily-report` with `schedule: '0 8 * * *'` (daily at 08:00) and `engine: 'n8n'` and `workflow_id: 'generate-report'` +- **WHEN** the `ActionScheduleJob` TimedJob runs at 08:00 +- **THEN** the action MUST be executed via `ActionExecutor` +- **AND** the CloudEvents payload MUST include `type: 'nl.openregister.action.scheduled'` and `data.schedule: '0 8 * * *'` +- **AND** `last_executed_at` MUST be updated on the action entity + +#### Scenario: Scheduled action respects enabled/active status +- **GIVEN** action `daily-report` with `schedule: '0 8 * * *'` but `enabled: false` +- **WHEN** the `ActionScheduleJob` evaluates the action +- **THEN** the action MUST be skipped + +#### Scenario: Scheduled action with filter_condition scoped to registers +- **GIVEN** action `weekly-cleanup` with `schedule: '0 0 * * 0'` and `registers: ["register-uuid-1"]` +- **WHEN** the schedule triggers +- **THEN** the workflow MUST receive `data.registers: ["register-uuid-1"]` so it knows which register to operate on +- **AND** the action MUST execute even though no event was dispatched + +### Requirement 7: Actions MUST have full CRUD API with pagination, search, and filtering +An `ActionsController` MUST expose RESTful CRUD endpoints under `/api/actions` following the same patterns as other OpenRegister resources (Registers, Schemas, etc.). The controller MUST support listing with pagination, searching by name/slug, filtering by status/event_type/engine, and full resource CRUD. + +#### Scenario: List all actions with pagination +- **GIVEN** 25 actions exist in the database +- **WHEN** a GET request is sent to `/api/actions?limit=10&offset=0` +- **THEN** the response MUST contain 10 actions +- **AND** the response MUST include pagination metadata (`total`, `limit`, `offset`) + +#### Scenario: Filter actions by status +- **GIVEN** 10 active actions and 5 draft actions +- **WHEN** a GET request is sent to `/api/actions?status=active` +- **THEN** only the 10 active actions MUST be returned + +#### Scenario: Search actions by name +- **GIVEN** actions named `validate-bsn`, `validate-kvk`, `send-notification` +- **WHEN** a GET request is sent to `/api/actions?_search=validate` +- **THEN** `validate-bsn` and `validate-kvk` MUST be returned +- **AND** `send-notification` MUST NOT be returned + +#### Scenario: Get action by ID or UUID +- **GIVEN** action `validate-bsn` with ID 5 and UUID `abc-123` +- **WHEN** a GET request is sent to `/api/actions/5` or `/api/actions/abc-123` +- **THEN** the full action entity MUST be returned as JSON +- **AND** the response MUST include all fields from the entity + +#### Scenario: Create action via API +- **GIVEN** a valid action payload with required fields (name, event_type, engine, workflow_id) +- **WHEN** a POST request is sent to `/api/actions` +- **THEN** the action MUST be created with defaults applied for optional fields +- **AND** HTTP 201 MUST be returned with the created entity +- **AND** the response MUST include the auto-generated UUID + +#### Scenario: Delete action via API +- **GIVEN** action `validate-bsn` exists with ID 5 +- **WHEN** a DELETE request is sent to `/api/actions/5` +- **THEN** the action MUST be soft-deleted (deleted timestamp set, status changed to archived) +- **AND** HTTP 200 MUST be returned + +### Requirement 8: Actions MUST support a dry-run (test) endpoint +A test endpoint MUST allow administrators to simulate action execution against a sample payload without triggering actual side effects. This enables validation of filter conditions, payload transformation, and workflow reachability before activating an action. + +#### Scenario: Dry-run action execution +- **GIVEN** action `validate-bsn` exists with ID 5 +- **WHEN** a POST request is sent to `/api/actions/5/test` with a sample event payload +- **THEN** the system MUST: + 1. Validate that the action would match the sample event (event_type, schema, register, filter_condition) + 2. Build the CloudEvents payload that would be sent to the workflow engine + 3. Optionally execute the workflow in dry-run mode if the engine supports it + 4. Return the match result, built payload, and engine response (if executed) +- **AND** NO actual object mutations, event dispatches, or audit trail entries MUST occur + +#### Scenario: Dry-run reports filter mismatch +- **GIVEN** action `validate-bsn` with `filter_condition: { "data.object.type": "person" }` +- **WHEN** a test payload with `data.object.type: 'organization'` is submitted +- **THEN** the response MUST indicate `matched: false` +- **AND** MUST include the reason: `"filter_condition mismatch: data.object.type expected 'person', got 'organization'"` + +### Requirement 9: Action execution MUST be logged and tracked with statistics +Every action execution MUST be logged in the `oc_openregister_action_logs` table via an `ActionLog` entity. The action entity itself MUST track aggregate statistics (execution_count, success_count, failure_count, last_executed_at). + +#### Scenario: Successful action execution creates a log entry +- **GIVEN** action `validate-bsn` is executed for object `obj-1` +- **WHEN** the workflow returns `status: 'approved'` in 250ms +- **THEN** an `ActionLog` entry MUST be created with: + - `action_id`: the action's database ID + - `action_uuid`: the action's UUID + - `event_type`: `'ObjectCreatingEvent'` + - `object_uuid`: `'obj-1'` (if applicable) + - `schema_id`: the schema's database ID (if applicable) + - `register_id`: the register's database ID (if applicable) + - `engine`: `'n8n'` + - `workflow_id`: the workflow identifier + - `status`: `'success'` + - `duration_ms`: `250` + - `request_payload`: the CloudEvents payload sent (JSON) + - `response_payload`: the workflow response (JSON) + - `error_message`: `null` + - `attempt`: `1` + - `created`: current timestamp +- **AND** the action's `execution_count` MUST be incremented by 1 +- **AND** `success_count` MUST be incremented by 1 +- **AND** `last_executed_at` MUST be updated + +#### Scenario: Failed action execution logs the error +- **GIVEN** action `validate-bsn` execution fails with a timeout after 30s +- **WHEN** the failure is processed +- **THEN** an `ActionLog` entry MUST be created with `status: 'failure'` and `error_message` containing the timeout details +- **AND** `failure_count` MUST be incremented on the action entity + +#### Scenario: Action execution logs are queryable via API +- **GIVEN** action `validate-bsn` with ID 5 has been executed 100 times +- **WHEN** a GET request is sent to `/api/actions/5/logs?limit=10&offset=0` +- **THEN** the 10 most recent log entries MUST be returned with pagination metadata + +### Requirement 10: Action retry MUST use the existing retry infrastructure +When an action execution fails and `on_failure` is `'queue'` or `on_engine_down` is `'queue'`, the action MUST be re-queued using Nextcloud's `IJobList` with an `ActionRetryJob` (QueuedJob). The retry logic MUST follow the action's `retry_policy` and `max_retries` configuration, using the same backoff calculation patterns as `WebhookRetryJob`. + +#### Scenario: Exponential backoff retry for failed action +- **GIVEN** action `validate-bsn` with `retry_policy: 'exponential'`, `max_retries: 3`, and `on_failure: 'queue'` +- **WHEN** the first execution attempt fails +- **THEN** `ActionRetryJob` MUST be added to `IJobList` with `attempt: 2` +- **AND** the retry delay MUST be `2^attempt * 60` seconds (attempt 2 = 4 minutes) +- **AND** the original CloudEvents payload MUST be preserved in the job arguments + +#### Scenario: Max retries exceeded +- **GIVEN** action `validate-bsn` has failed 3 times (max_retries: 3) +- **WHEN** `ActionRetryJob` evaluates the failed execution +- **THEN** it MUST NOT re-queue +- **AND** the `ActionLog` MUST record `status: 'abandoned'` with the final error +- **AND** a warning MUST be logged indicating retry limit exceeded + +### Requirement 11: Action events MUST be dispatched for action lifecycle changes +The system MUST dispatch typed events for action entity lifecycle changes, following the same pattern as all other OpenRegister entities. This enables external apps and webhooks to respond to action configuration changes. + +#### Scenario: ActionCreatedEvent dispatched on creation +- **GIVEN** a new action is created via the API +- **WHEN** the action is persisted +- **THEN** an `ActionCreatedEvent` MUST be dispatched with the full `Action` entity accessible via `getAction()` + +#### Scenario: ActionUpdatedEvent dispatched on update +- **GIVEN** an action is updated (e.g., status changed from draft to active) +- **WHEN** the update is persisted +- **THEN** an `ActionUpdatedEvent` MUST be dispatched + +#### Scenario: ActionDeletedEvent dispatched on deletion +- **GIVEN** an action is soft-deleted +- **WHEN** the deletion is processed +- **THEN** an `ActionDeletedEvent` MUST be dispatched with the pre-deletion entity snapshot + +### Requirement 12: Schema migration from inline hooks to Action entities MUST be supported +A migration utility MUST convert existing inline hook configurations (from `Schema::getHooks()`) into Action entities. This enables gradual adoption without breaking existing configurations. + +#### Scenario: Migrate inline hooks to actions +- **GIVEN** schema `meldingen` has inline hooks: `[{"id": "validate-bsn", "event": "creating", "engine": "n8n", "workflowId": "wf-123", "mode": "sync", "order": 1, "timeout": 10, "onFailure": "reject"}]` +- **WHEN** the migration endpoint `POST /api/actions/migrate-from-hooks/{schemaId}` is called +- **THEN** for each inline hook, an Action entity MUST be created with: + - `name`: hook `id` or `"Hook {index} for {schemaTitle}"` + - `event_type`: mapped from hook `event` to event class name (e.g., `creating` -> `ObjectCreatingEvent`) + - `engine`: from hook `engine` + - `workflow_id`: from hook `workflowId` + - `mode`: from hook `mode` + - `execution_order`: from hook `order` + - `timeout`: from hook `timeout` + - `on_failure`: from hook `onFailure` + - `schemas`: `[schemaUuid]` +- **AND** the response MUST list all created actions with their IDs +- **AND** the original inline hooks MUST NOT be removed (dual-running until manually disabled) + +#### Scenario: Migration is idempotent +- **GIVEN** migration has already been run for schema `meldingen` +- **WHEN** the migration endpoint is called again +- **THEN** it MUST detect existing actions with matching `name` + `schemas` + `event_type` +- **AND** MUST skip creation of duplicates +- **AND** MUST return a report indicating which actions were skipped vs created + +### Requirement 13: Multi-tenancy and RBAC MUST be enforced on Action entities +Actions MUST respect the existing multi-tenancy model (owner, application, organisation fields) and RBAC authorization. Only users with appropriate permissions can create, modify, or delete actions. The `MultiTenancyTrait` MUST be applied to `ActionMapper`. + +#### Scenario: Tenant isolation for actions +- **GIVEN** organisation `org-1` has actions `A1` and `A2`, and organisation `org-2` has actions `A3` +- **WHEN** a user in `org-1` lists actions via GET `/api/actions` +- **THEN** only actions `A1` and `A2` MUST be returned +- **AND** action `A3` MUST NOT be visible + +#### Scenario: RBAC on action creation +- **GIVEN** a user without `openregister_admin` or `openregister_actions_manage` permissions +- **WHEN** they attempt to create an action via POST `/api/actions` +- **THEN** the request MUST be rejected with HTTP 403 + +#### Scenario: Action execution respects action's tenant scope +- **GIVEN** action `validate-bsn` owned by `org-1` +- **WHEN** an event fires for an object in `org-2` +- **THEN** the action MUST NOT be executed (tenant scope mismatch) + +## Current Implementation Status +- **Implemented:** + - Schema-level hooks via `Schema::getHooks()` JSON property + - `HookExecutor` for orchestrating hook execution with CloudEvents payloads + - `HookListener` registered for all object lifecycle events + - `WorkflowEngineRegistry` with n8n and Windmill adapters + - `CloudEventFormatter` for CloudEvents 1.0 payload generation + - `HookRetryJob` for retry with exponential backoff + - 39+ typed event classes for all entity types + - Event listener registration in `Application::registerEventListeners()` + - Multi-tenancy infrastructure (`MultiTenancyTrait`, owner/application/organisation fields) + - Webhook entity with similar concepts (events, filters, retry, HMAC, mapping) +- **NOT implemented:** + - `Action` entity and `ActionMapper` + - `ActionLog` entity and `ActionLogMapper` + - `ActionsController` with CRUD API + - `ActionListener` for event-to-action dispatch + - `ActionExecutor` for action execution orchestration + - `ActionScheduleJob` for cron-based scheduled actions + - `ActionRetryJob` for retry of failed action executions + - `ActionCreatedEvent`, `ActionUpdatedEvent`, `ActionDeletedEvent` events + - Migration utility from inline hooks to Action entities + - Dry-run/test endpoint for action simulation + - Action-specific RBAC permissions + - Database migration for `oc_openregister_actions` and `oc_openregister_action_logs` tables + +## Standards & References +- **CloudEvents v1.0 (CNCF)** -- Event format specification +- **Nextcloud Entity pattern** -- `OCP\AppFramework\Db\Entity` + `QBMapper` +- **Nextcloud IEventDispatcher** -- Typed event dispatch +- **PSR-14 StoppableEventInterface** -- Pre-mutation event rejection +- **Cron expressions** -- Standard Unix cron syntax for scheduled actions +- **OpenRegister entity conventions** -- UUID, slug, soft-delete, audit timestamps, multi-tenancy fields + +## Cross-References +- **schema-hooks** -- Current inline hook system; actions augment/replace this +- **workflow-integration** -- Engine adapters (N8nAdapter, WindmillAdapter) used by ActionExecutor +- **event-driven-architecture** -- Event dispatch infrastructure consumed by ActionListener +- **webhook-payload-mapping** -- Mapping entity referenced by Action for payload transformation diff --git a/openspec/changes/activity-provider/specs/activity-provider/spec.md b/openspec/changes/activity-provider/specs/activity-provider/spec.md new file mode 100644 index 000000000000..0661a904a768 --- /dev/null +++ b/openspec/changes/activity-provider/specs/activity-provider/spec.md @@ -0,0 +1,265 @@ +--- +status: draft +--- + +# Activity Provider + +## Purpose + +Integrate OpenRegister with Nextcloud's Activity app so that all CRUD operations on Objects, Registers, and Schemas are visible in the standard Nextcloud activity stream, dashboard activity widget, and (optionally) email notifications. This gives users and administrators a clear, auditable timeline of who changed what and when, using the standard `OCP\Activity` API (IManager, IProvider, IFilter, ActivitySettings). + +**Source**: OpenRegister is a multi-user data registration platform where multiple people collaborate on structured data. Without Activity integration, users have no Nextcloud-native visibility into changes made by others. The existing internal event system (`ObjectCreatedEvent`, etc.) already dispatches events but they are not surfaced to end users. + +## Requirements + +### Requirement: OpenRegister MUST publish activity events for Object CRUD operations + +When an object is created, updated, or deleted, the app MUST publish a corresponding activity event via `OCP\Activity\IManager::publish()`. The event MUST contain the app ID, activity type, author, timestamp, subject with parameters, object reference, and a link to the object in the OpenRegister UI. + +#### Scenario: Object created activity is published +- **GIVEN** a user `admin` creates a new object with title `Omgevingsvergunning` in register `5`, schema `12` +- **WHEN** the `ObjectCreatedEvent` is dispatched +- **THEN** an activity event SHALL be published with: + - `app` = `'openregister'` + - `type` = `'openregister_objects'` + - `subject` = `'object_created'` with parameters `['title' => 'Omgevingsvergunning', 'schemaTitle' => 'Producten', 'registerTitle' => 'Gemeente']` + - `author` = `'admin'` + - `affectedUser` = `'admin'` + - `object` = `('object', , 'Omgevingsvergunning')` + - `link` pointing to `#/registers/5/schemas/12/objects/` + - `timestamp` = current Unix timestamp + +#### Scenario: Object updated activity is published +- **GIVEN** a user `editor` updates an existing object with title `Omgevingsvergunning` +- **WHEN** the `ObjectUpdatedEvent` is dispatched +- **THEN** an activity event SHALL be published with: + - `subject` = `'object_updated'` + - `author` = `'editor'` + - All other fields populated as in the creation scenario + +#### Scenario: Object deleted activity is published +- **GIVEN** a user `admin` deletes an object with title `Omgevingsvergunning` +- **WHEN** the `ObjectDeletedEvent` is dispatched +- **THEN** an activity event SHALL be published with: + - `subject` = `'object_deleted'` + - `link` = empty string (object no longer exists) + +#### Scenario: Object owner receives notification when another user modifies their object +- **GIVEN** an object owned by user `owner1` and a different user `editor` updates it +- **WHEN** the `ObjectUpdatedEvent` is dispatched +- **THEN** TWO activity events SHALL be published: + - One with `affectedUser` = `'editor'` (the actor sees their own action) + - One with `affectedUser` = `'owner1'` (the owner is notified of the change) + +#### Scenario: Activity publishing failure does not break object operations +- **GIVEN** the Activity app is disabled or `IManager::publish()` throws an exception +- **WHEN** an object is created, updated, or deleted +- **THEN** the core operation SHALL succeed without error +- **AND** the exception SHALL be logged at error level + +### Requirement: OpenRegister MUST publish activity events for Register CRUD operations + +When a register is created, updated, or deleted, the app MUST publish a corresponding activity event with type `'openregister_registers'`. + +#### Scenario: Register created activity is published +- **GIVEN** a user `admin` creates a new register with title `Gemeente Tilburg` +- **WHEN** the `RegisterCreatedEvent` is dispatched +- **THEN** an activity event SHALL be published with: + - `type` = `'openregister_registers'` + - `subject` = `'register_created'` with parameters `['title' => 'Gemeente Tilburg']` + - `object` = `('register', , 'Gemeente Tilburg')` + - `link` pointing to `#/registers/` + +#### Scenario: Register updated activity is published +- **GIVEN** a user updates an existing register +- **WHEN** the `RegisterUpdatedEvent` is dispatched +- **THEN** an activity event SHALL be published with `subject` = `'register_updated'` + +#### Scenario: Register deleted activity is published +- **GIVEN** a user deletes a register +- **WHEN** the `RegisterDeletedEvent` is dispatched +- **THEN** an activity event SHALL be published with `subject` = `'register_deleted'` and empty link + +### Requirement: OpenRegister MUST publish activity events for Schema CRUD operations + +When a schema is created, updated, or deleted, the app MUST publish a corresponding activity event with type `'openregister_schemas'`. + +#### Scenario: Schema created activity is published +- **GIVEN** a user `admin` creates a new schema with title `Producten` +- **WHEN** the `SchemaCreatedEvent` is dispatched +- **THEN** an activity event SHALL be published with: + - `type` = `'openregister_schemas'` + - `subject` = `'schema_created'` with parameters `['title' => 'Producten']` + - `object` = `('schema', , 'Producten')` + +#### Scenario: Schema updated activity is published +- **GIVEN** a user updates an existing schema +- **WHEN** the `SchemaUpdatedEvent` is dispatched +- **THEN** an activity event SHALL be published with `subject` = `'schema_updated'` + +#### Scenario: Schema deleted activity is published +- **GIVEN** a user deletes a schema +- **WHEN** the `SchemaDeletedEvent` is dispatched +- **THEN** an activity event SHALL be published with `subject` = `'schema_deleted'` and empty link + +### Requirement: An IProvider MUST parse activity events into human-readable entries + +A class implementing `OCP\Activity\IProvider` MUST be registered to parse OpenRegister activity events into rich, human-readable entries for display in the activity stream. + +#### Scenario: Provider parses object_created event +- **GIVEN** an activity event with app `'openregister'` and subject `'object_created'` with parameter `title` = `'Omgevingsvergunning'` +- **WHEN** `Provider::parse()` is called +- **THEN** the event's parsed subject SHALL be set to `'Object created: Omgevingsvergunning'` (translated) +- **AND** the rich subject SHALL be set to `'Object created: {title}'` with a `highlight` parameter for the title +- **AND** the event icon SHALL be set to the OpenRegister app icon URL + +#### Scenario: Provider parses all nine subjects +- **GIVEN** the provider handles subjects: `object_created`, `object_updated`, `object_deleted`, `register_created`, `register_updated`, `register_deleted`, `schema_created`, `schema_updated`, `schema_deleted` +- **WHEN** any of these subjects are passed to `parse()` +- **THEN** the provider SHALL return a valid parsed event with rich subject and icon +- **AND** unknown subjects SHALL cause `UnknownActivityException` to be thrown + +#### Scenario: Provider throws UnknownActivityException for foreign events +- **GIVEN** an activity event with app `'files'` or an unrecognized subject +- **WHEN** `Provider::parse()` is called +- **THEN** it SHALL throw `OCP\Activity\Exceptions\UnknownActivityException` + +### Requirement: An IFilter MUST allow users to filter the activity stream for OpenRegister events + +A class implementing `OCP\Activity\IFilter` MUST be registered so users can view only OpenRegister activity in the activity sidebar. + +#### Scenario: Filter appears in activity sidebar +- **GIVEN** the OpenRegister app is enabled +- **WHEN** a user opens the Activity app sidebar +- **THEN** a filter entry titled `t('openregister', 'Open Register')` SHALL appear +- **AND** the filter SHALL display the OpenRegister app icon +- **AND** selecting the filter SHALL show only events from the `openregister` app + +#### Scenario: Filter returns correct activity types +- **GIVEN** the filter is applied +- **WHEN** `filterTypes()` is called +- **THEN** it SHALL return `['openregister_objects', 'openregister_registers', 'openregister_schemas']` +- **AND** `allowedApps()` SHALL return `['openregister']` + +### Requirement: ActivitySettings subclasses MUST allow per-type notification configuration + +Three `ActivitySettings` subclasses MUST be registered so users can independently configure stream and email notification preferences for object, register, and schema activities. + +#### Scenario: Object activity setting +- **GIVEN** the activity settings page +- **WHEN** OpenRegister settings are displayed +- **THEN** a setting with identifier `'openregister_objects'` and name `t('openregister', 'Object changes')` SHALL appear +- **AND** it SHALL be in the group `'openregister'` with group name `t('openregister', 'Open Register')` +- **AND** stream SHALL be enabled by default +- **AND** mail SHALL be disabled by default +- **AND** both stream and mail SHALL be user-changeable + +#### Scenario: Register activity setting +- **GIVEN** the activity settings page +- **WHEN** OpenRegister settings are displayed +- **THEN** a setting with identifier `'openregister_registers'` and name `t('openregister', 'Register changes')` SHALL appear +- **AND** it SHALL share the group `'openregister'` + +#### Scenario: Schema activity setting +- **GIVEN** the activity settings page +- **WHEN** OpenRegister settings are displayed +- **THEN** a setting with identifier `'openregister_schemas'` and name `t('openregister', 'Schema changes')` SHALL appear +- **AND** it SHALL share the group `'openregister'` + +### Requirement: Activity components MUST be registered via info.xml + +The provider, settings, and filter MUST be declared in `appinfo/info.xml` under the `` section so Nextcloud auto-discovers them. + +#### Scenario: info.xml declares activity components +- **GIVEN** the `appinfo/info.xml` file +- **WHEN** Nextcloud reads app metadata +- **THEN** the `` section SHALL contain: + - `OCA\OpenRegister\Activity\Provider` + - `OCA\OpenRegister\Activity\Setting\ObjectSetting` + - `OCA\OpenRegister\Activity\Setting\RegisterSetting` + - `OCA\OpenRegister\Activity\Setting\SchemaSetting` + - `OCA\OpenRegister\Activity\Filter` + +### Requirement: The ActivityEventListener MUST be registered for all entity events + +A single event listener class MUST handle all nine OpenRegister entity events and delegate to the `ActivityService` for publishing. + +#### Scenario: Listener is registered for all events +- **GIVEN** the `Application::register()` method +- **WHEN** the app boots +- **THEN** `$context->registerEventListener()` SHALL be called for: + - `ObjectCreatedEvent::class` -> `ActivityEventListener::class` + - `ObjectUpdatedEvent::class` -> `ActivityEventListener::class` + - `ObjectDeletedEvent::class` -> `ActivityEventListener::class` + - `RegisterCreatedEvent::class` -> `ActivityEventListener::class` + - `RegisterUpdatedEvent::class` -> `ActivityEventListener::class` + - `RegisterDeletedEvent::class` -> `ActivityEventListener::class` + - `SchemaCreatedEvent::class` -> `ActivityEventListener::class` + - `SchemaUpdatedEvent::class` -> `ActivityEventListener::class` + - `SchemaDeletedEvent::class` -> `ActivityEventListener::class` + +#### Scenario: Listener dispatches to correct service methods +- **GIVEN** an `ObjectCreatedEvent` is received by the listener +- **WHEN** `handle()` is called +- **THEN** it SHALL call `ActivityService::publishObjectCreated()` with the object from the event +- **AND** the same dispatch pattern SHALL apply for all nine event types + +### Requirement: i18n MUST be applied to all user-visible strings + +All user-visible strings in the Provider, Filter, and Settings MUST use `IL10N` / `IFactory` for translation. Dutch and English translations MUST be provided as minimum per ADR-005. + +#### Scenario: Activity subjects are translated +- **GIVEN** a user with Nextcloud locale set to `nl` +- **WHEN** the activity stream displays an `object_created` event +- **THEN** the parsed subject SHALL use Dutch translation (e.g., `'Object aangemaakt: Omgevingsvergunning'`) + +#### Scenario: Filter name is translated +- **GIVEN** a user with locale `nl` +- **WHEN** the activity filter list is displayed +- **THEN** the OpenRegister filter name SHALL be `'Open Register'` (same in both languages as it is a product name) + +#### Scenario: Setting names are translated +- **GIVEN** a user with locale `nl` +- **WHEN** the activity settings page shows OpenRegister settings +- **THEN** the setting names SHALL be the Dutch translations: + - `'Object wijzigingen'` for object setting + - `'Register wijzigingen'` for register setting + - `'Schema wijzigingen'` for schema setting + +## Current Implementation Status + +**Not yet implemented.** The following existing infrastructure supports this feature: + +- All 9 entity events (`ObjectCreatedEvent`, `ObjectUpdatedEvent`, `ObjectDeletedEvent`, `RegisterCreatedEvent`, `RegisterUpdatedEvent`, `RegisterDeletedEvent`, `SchemaCreatedEvent`, `SchemaUpdatedEvent`, `SchemaDeletedEvent`) are already dispatched by the existing services. +- `Application::register()` already has a `registerEventListeners()` method where the new listener registrations will be added. +- `IUserSession` is already available throughout the service layer for author resolution. +- The Pipelinq app (`pipelinq/lib/Activity/`) provides a working reference implementation of the same pattern within the Conduction codebase. + +**Not yet implemented:** +- `lib/Activity/Provider.php` (IProvider) +- `lib/Activity/ProviderSubjectHandler.php` (subject text mapping) +- `lib/Activity/Filter.php` (IFilter) +- `lib/Activity/Setting/ObjectSetting.php` (ActivitySettings) +- `lib/Activity/Setting/RegisterSetting.php` (ActivitySettings) +- `lib/Activity/Setting/SchemaSetting.php` (ActivitySettings) +- `lib/Service/ActivityService.php` (event publishing) +- `lib/Listener/ActivityEventListener.php` (event-to-activity bridge) +- `appinfo/info.xml` `` section +- Translation strings for all subjects, settings, and filter + +## Standards & References + +- Nextcloud Activity Manager API: `OCP\Activity\IManager` (NC 6+) +- Nextcloud Activity Provider API: `OCP\Activity\IProvider` (NC 11+) +- Nextcloud Activity Filter API: `OCP\Activity\IFilter` (NC 11+) +- Nextcloud Activity Settings API: `OCP\Activity\ActivitySettings` (NC 20+) +- Nextcloud Activity documentation: https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/activity.html +- ADR-005: Dutch and English required for all UI strings +- Reference implementation: `pipelinq/lib/Activity/` (same codebase) + +## Cross-References + +- `event-driven-architecture` -- OpenRegister's existing event system that this feature builds on +- `audit-trail-immutable` -- Activity provider complements the immutable audit trail with user-facing visibility +- `notificatie-engine` -- Future notification engine may leverage activity events +- `i18n-infrastructure` -- Translation infrastructure for PHP strings diff --git a/openspec/changes/archival-destruction-workflow/specs/archivering-vernietiging/spec.md b/openspec/changes/archival-destruction-workflow/specs/archivering-vernietiging/spec.md new file mode 100644 index 000000000000..dc1a88f6a6b3 --- /dev/null +++ b/openspec/changes/archival-destruction-workflow/specs/archivering-vernietiging/spec.md @@ -0,0 +1,85 @@ +--- +status: draft +capability: archivering-vernietiging +--- + +# Archival & Destruction Workflow - Delta Spec + +## ADDED Requirements + +### Requirement: Archival metadata on objects via retention field +Objects MUST store archival metadata in the existing `retention` JSON field with MDTO-conformant keys. + +#### Scenario: Set archival metadata +- GIVEN an object in register `zaakregister` +- WHEN archival metadata is set via `PUT /api/archival/objects/{id}/retention` +- THEN the `retention` field MUST contain: + - `archiefnominatie`: one of `vernietigen`, `bewaren`, `nog_niet_bepaald` + - `archiefactiedatum`: ISO 8601 date for the archival action + - `archiefstatus`: one of `nog_te_archiveren`, `gearchiveerd`, `vernietigd`, `overgebracht` + - `classificatie`: selection list category code +- AND `archiefnominatie` defaults to `nog_niet_bepaald` if not set + +#### Scenario: Calculate archiefactiedatum from selection list +- GIVEN a selection list entry with category `B1`, bewaartermijn 5 years, action `vernietigen` +- AND an object with classificatie `B1` and a close date of 2026-03-01 +- WHEN the system calculates archival dates +- THEN `archiefactiedatum` MUST be 2031-03-01 +- AND `archiefnominatie` MUST be `vernietigen` + +### Requirement: Selection list (selectielijst) CRUD +Administrators MUST be able to manage selection list entries that map categories to retention rules. + +#### Scenario: CRUD selection list entries +- GIVEN an admin user +- WHEN they POST to `/api/archival/selection-lists` with `{ "category": "B1", "retentionYears": 5, "action": "vernietigen", "description": "Korte bewaartermijn" }` +- THEN a selection list entry is created +- AND it is retrievable via GET, updatable via PUT, deletable via DELETE + +#### Scenario: Schema-level override +- GIVEN a default retention of 10 years for category A1 +- AND a schema override setting 20 years for schema `vertrouwelijk-dossier` +- WHEN retention is calculated for objects in that schema +- THEN 20 years MUST be used instead of 10 + +### Requirement: Destruction list generation and approval +Objects past their archiefactiedatum with archiefnominatie `vernietigen` MUST be processable through a destruction workflow. + +#### Scenario: Generate destruction list +- GIVEN 15 objects with archiefactiedatum before today and archiefnominatie `vernietigen` +- WHEN `POST /api/archival/destruction-lists/generate` is called +- THEN a destruction list MUST be created containing all 15 object references +- AND the list status is `pending_review` + +#### Scenario: Approve destruction list +- GIVEN a destruction list with status `pending_review` +- WHEN an archivist calls `POST /api/archival/destruction-lists/{id}/approve` +- THEN all objects in the list MUST be permanently deleted +- AND audit trail entries with action `archival.destroyed` MUST be created +- AND the destruction list status changes to `completed` +- AND the destruction list itself is retained as an archival record + +#### Scenario: Reject items from destruction list +- GIVEN a destruction list with 15 objects +- WHEN the archivist calls `POST /api/archival/destruction-lists/{id}/reject` with 3 object IDs +- THEN those 3 objects are removed from the list +- AND their archiefactiedatum is extended by the original retention period + +### Requirement: Background destruction check job +A TimedJob MUST run daily to identify objects due for destruction and generate destruction lists. + +#### Scenario: Scheduled destruction check +- GIVEN objects with archiefactiedatum <= today and archiefnominatie `vernietigen` and archiefstatus `nog_te_archiveren` +- WHEN the DestructionCheckJob runs +- THEN a destruction list is generated for review +- AND a notification is sent to users with archival management permissions + +### Requirement: Audit trail for archival actions +All archival actions MUST be logged in the audit trail. + +#### Scenario: Destruction audit trail +- GIVEN an approved destruction list +- WHEN objects are destroyed +- THEN each deletion creates an audit trail entry with: + - action: `archival.destroyed` + - metadata: destruction list ID, approving user, timestamp diff --git a/openspec/changes/archive/2026-05-01-retrofit-actions-2026-05-01/specs/actions/spec.md b/openspec/changes/archive/2026-05-01-retrofit-actions-2026-05-01/specs/actions/spec.md new file mode 100644 index 000000000000..c942e4d16000 --- /dev/null +++ b/openspec/changes/archive/2026-05-01-retrofit-actions-2026-05-01/specs/actions/spec.md @@ -0,0 +1,202 @@ +--- +retrofit: true +--- +# Actions Specification + +**Status**: done +**Scope**: openregister +**OpenSpec changes**: +- [retrofit-actions-2026-05-01](../../changes/retrofit-actions-2026-05-01/) _(archived 2026-05-01)_ + +## Purpose + +Actions are schema-attached, administrator-configured workflow triggers that execute external workflow engine payloads in response to object lifecycle events. Unlike inline schema hooks (which are attached to a schema's `hooks` array and execute sequentially), Actions are standalone entities that can target multiple schemas and registers, support both synchronous and asynchronous execution, and carry configurable failure handling and retry policies. Actions coexist with inline hooks via `ActionListener` and `HookListener` — hooks execute first, then Actions run, both respecting event propagation stop signals. + +This spec documents the observed behavior of the Actions feature as retroactively introduced by the `retrofit-actions-2026-05-01` ghost change. Code already exists — requirements describe what the code does, not what it should do. + +## Requirements + +### REQ-001: The system SHALL provide a CRUD API for schema-attached workflow actions + +Actions are named entities that declare which lifecycle event type to listen for, which workflow engine to invoke, and which workflow to run. Administrators manage actions via `ActionsController` backed by `ActionService`. CRUD operations dispatch typed events (`ActionCreatedEvent`, `ActionUpdatedEvent`, `ActionDeletedEvent`). Deletion is soft: the `deleted` timestamp is set and `status` becomes `'archived'`; the record is not removed. Execution statistics (total count, success count, failure count, last executed timestamp) are tracked per action by `ActionService::updateStatistics()`. + +Required fields on create: `name`, `eventType`, `engine` (workflow engine ID), `workflowId`. Optional fields default to: `status='draft'`, `mode='sync'`, `executionOrder=0`, `timeout=30`, `onFailure='reject'`, `onTimeout='reject'`, `onEngineDown='allow'`, `maxRetries=3`, `retryPolicy='exponential'`, `enabled=true`, `version='1.0.0'`. + +Actions may be scoped to zero or more schemas (by UUID) and zero or more registers (by UUID). An empty schemas or registers list means "match all". + +#### Scenario: Create a minimal action + +- **GIVEN** an administrator wants to run workflow `wf-123` on engine `42` whenever an object is created +- **WHEN** they POST to `/api/actions` with `{ "name": "Notify CRM", "eventType": "ObjectCreatedEvent", "engine": 42, "workflowId": "wf-123" }` +- **THEN** the system creates an Action entity with a generated UUID and returns HTTP 201 +- **AND** `status` defaults to `'draft'`, `mode` to `'sync'`, `timeout` to `30` + +#### Scenario: Missing required field + +- **GIVEN** a POST to `/api/actions` that omits `eventType` +- **WHEN** `ActionService::createAction()` validates the input +- **THEN** the system returns HTTP 400 with `{ "error": "Action eventType is required" }` + +#### Scenario: Soft delete + +- **GIVEN** an existing action with ID `7` +- **WHEN** an administrator DELETEs `/api/actions/7` +- **THEN** the action's `deleted` timestamp is set and `status` becomes `'archived'` +- **AND** the action record remains in the database; subsequent list queries that filter on `status != archived` will omit it + +#### Scenario: Filtered list + +- **GIVEN** multiple actions with different statuses and event types +- **WHEN** a GET to `/api/actions?status=active&event_type=ObjectCreatedEvent&_limit=10&_page=2` is made +- **THEN** the system returns the matching page of actions and a total count +- **AND** the `_search` query parameter filters further by name substring match + +### REQ-002: The system SHALL execute matching workflow actions when object lifecycle events fire + +`ActionListener` is registered for all lifecycle event types (ObjectCreatingEvent, ObjectCreatedEvent, ObjectUpdatingEvent, ObjectUpdatedEvent, ObjectDeletingEvent, ObjectDeletedEvent, and others). On each event it: +1. Checks propagation stop — if a prior hook stopped propagation, no actions run. +2. Extracts the event payload (object data, schemaUuid, registerUuid) via duck-typing on the event class. +3. Queries `ActionMapper::findMatchingActions()` by eventType, schemaUuid, registerUuid — the mapper applies schema/register scoping at DB level. +4. Applies filter_condition matching in PHP: each condition key (dot-notation path) must equal the expected value in the payload. +5. Delegates the filtered, ordered list to `ActionExecutor::executeActions()`. + +Within `executeActions()`, actions execute in the order provided. If a previous action stops propagation mid-batch, remaining actions are skipped. + +#### Scenario: Matching action executes on object creation + +- **GIVEN** an active action scoped to schema `schema-abc` with `eventType='ObjectCreatedEvent'` +- **WHEN** an `ObjectCreatedEvent` fires for an object with schemaUuid `schema-abc` +- **THEN** `ActionListener` finds the action and `ActionExecutor` executes it via the configured workflow engine + +#### Scenario: Propagation stop blocks action execution + +- **GIVEN** an inline hook that calls `$event->stopPropagation()` +- **WHEN** `ActionListener::handle()` checks propagation at entry +- **THEN** `ActionListener` returns immediately without executing any actions + +#### Scenario: Filter condition mismatch + +- **GIVEN** an action with `filterConditions: { "object.status": "published" }` +- **WHEN** an event fires for an object with `status='draft'` +- **THEN** the action is not executed + +### REQ-003: The system SHALL support synchronous and fire-and-forget execution modes per action + +Each action carries a `mode` field: `'sync'` (default) or `'async'`. + +In **sync mode**: `ActionExecutor` calls the workflow engine and processes the `WorkflowResult`. If the result is `rejected`, `stopPropagation()` is called on the event and `setErrors()` is called with the result's error list — blocking the object mutation for pre-mutation events. If the result is `modified`, `setModifiedData()` is called — applying data changes from the workflow. Statistics are updated and an `ActionLog` is created regardless of outcome. + +In **async mode**: `ActionExecutor` calls the workflow engine but does not process the `WorkflowResult` for event side effects. Failures are handled by the configured `onFailure` policy. The object mutation is never blocked by async actions. + +The CloudEvents 1.0 envelope is built by `ActionExecutor::buildCloudEventPayload()` for every execution: `specversion: '1.0'`, `type: 'nl.openregister.action.{eventType}'`, `source: '/openregister/actions/{uuid}'`, `id: Uuid::v4()`, `time: now`, `datacontenttype: 'application/json'`, plus `data` (the event payload) and `action` metadata. + +#### Scenario: Sync action rejects object mutation + +- **GIVEN** an active sync action on `ObjectCreatingEvent` +- **WHEN** the workflow engine returns a `WorkflowResult` with `isRejected() = true` and errors `["Duplicate case number"]` +- **THEN** `stopPropagation()` is called on the event, blocking the object creation +- **AND** `setErrors(["Duplicate case number"])` is called so the caller can surface the rejection reason + +#### Scenario: Async action does not block + +- **GIVEN** an active async action on `ObjectCreatedEvent` +- **WHEN** the workflow engine call takes 5 seconds or throws an exception +- **THEN** the object creation completes without waiting for the engine response +- **AND** the failure is handled by the configured `onFailure` policy + +#### Scenario: CloudEvents envelope + +- **GIVEN** an action with uuid `abc-123` and a triggering event of type `ObjectCreatedEvent` +- **WHEN** `buildCloudEventPayload()` is called +- **THEN** the returned array includes `specversion: '1.0'`, `type: 'nl.openregister.action.ObjectCreatedEvent'`, `source: '/openregister/actions/abc-123'` + +### REQ-004: The system SHALL retry failed action executions with configurable backoff until max retries are reached + +When an action execution fails and its `onFailure` policy is `'queue'` (or `onEngineDown='queue'` and the engine is unavailable), `ActionExecutor::handleFailure()` adds an `ActionRetryJob` to the background job queue with the action ID, payload, attempt number (starting at 2), and retry configuration. + +`ActionRetryJob` implements the retry loop: +- If `attempt > maxRetries`: create an `ActionLog` with `status='abandoned'`, call `updateStatistics(actionId, 'abandoned')`, stop. +- Otherwise: call `ActionExecutor::executeActions()` with the single action. If that fails, re-queue itself with `attempt + 1`. If it succeeds, no further action. + +Delay calculation (static `calculateDelay(policy, attempt)`): +- `'exponential'`: `2^attempt × 60` seconds (attempt 2 → 240s, attempt 3 → 480s) +- `'linear'`: `attempt × 300` seconds +- `'fixed'`: 300 seconds + +**Note**: `calculateDelay()` is defined but its return value is not currently used inside `ActionRetryJob::run()` to actually delay the re-queuing — the job is re-queued immediately without the calculated delay. This appears to be a bug; the delay should be applied via a `TimedJob` approach or by computing the scheduled run time. Surfaced here, not fixed. + +#### Scenario: Action queued for retry on failure + +- **GIVEN** an action with `onFailure='queue'`, `maxRetries=3`, `retryPolicy='exponential'` +- **WHEN** the first execution fails +- **THEN** `ActionRetryJob` is queued with `attempt=2`, `max_retries=3`, `retry_policy='exponential'` + +#### Scenario: Retry succeeds before max retries + +- **GIVEN** `ActionRetryJob` runs for attempt 2 out of 3 max retries +- **WHEN** the retry execution succeeds +- **THEN** no further retry job is queued +- **AND** the action log records `status='success'` + +#### Scenario: Max retries exhausted + +- **GIVEN** `ActionRetryJob` runs for attempt 4 out of 3 max retries +- **WHEN** `run()` checks `attempt > maxRetries` +- **THEN** an `ActionLog` is created with `status='abandoned'` and the abandon is counted in failure statistics +- **AND** no further retry job is queued + +### REQ-005: The system SHALL execute actions with a cron schedule when they fall due + +`ActionScheduleJob` is a `TimedJob` that runs every 60 seconds. It queries all actions where `enabled=true`, `status='active'`, and `schedule IS NOT NULL`. For each, it evaluates the cron expression (via `dragonmantank/cron-expression`) against `lastExecutedAt`: +- If `lastExecutedAt` is null → action is due immediately. +- Otherwise → compute `getNextRunDate(lastExecutedAt)` and check if it is ≤ now. + +Due actions are executed via `ActionExecutor::executeActions()` with a synthetic `Event` object and a payload containing `schedule`, `schemas`, `registers` arrays. The eventType is `'nl.openregister.action.scheduled'`. + +**Dependency**: `dragonmantank/cron-expression` is an optional runtime dependency. If the class is not available, `ActionScheduleJob` will throw an `UndefinedClass` error. The code currently does not guard against this case — `@psalm-suppress UndefinedClass` is used but no runtime check exists. + +#### Scenario: Action due on first run + +- **GIVEN** an active action with `schedule='0 9 * * *'` and `lastExecutedAt=null` +- **WHEN** `ActionScheduleJob` runs +- **THEN** the action is executed immediately + +#### Scenario: Action not yet due + +- **GIVEN** an active action with `schedule='0 9 * * *'` and `lastExecutedAt=today 09:00` +- **WHEN** `ActionScheduleJob` runs before 09:00 tomorrow +- **THEN** the action is skipped + +#### Scenario: Scheduled payload + +- **GIVEN** an action targeting schemas `['schema-abc']` with schedule `'*/5 * * * *'` +- **WHEN** the action is executed by `ActionScheduleJob` +- **THEN** the payload contains `{ "schedule": "*/5 * * * *", "schemas": ["schema-abc"], "registers": [...] }` +- **AND** the eventType is `'nl.openregister.action.scheduled'` + +## Non-Functional Requirements + +- **Performance:** `ActionMapper::findMatchingActions()` must resolve matching actions in < 100ms under normal load. Schema/register scoping at DB level prevents full table scans on large action sets. +- **Reliability:** Sync action failures do NOT silently swallow errors — `onFailure` policy determines whether the object mutation is blocked (`'reject'`) or the failure is queued for retry (`'queue'`). +- **Observability:** Every action execution creates an `ActionLog` entry with duration, status, request payload, and response payload. `ActionService::updateStatistics()` tracks aggregate counts. + +## Acceptance Criteria + +- [ ] `POST /api/actions` with valid required fields returns 201 and an Action entity with defaults applied +- [ ] `POST /api/actions` missing name/eventType/engine/workflowId returns 400 +- [ ] `DELETE /api/actions/{id}` soft-deletes the action (sets `deleted` timestamp, `status='archived'`) +- [ ] `ObjectCreatedEvent` with matching schema triggers execution of a matching active action +- [ ] Sync action returning `rejected` from workflow stops event propagation +- [ ] Async action failure does not block the object mutation +- [ ] Failed action with `onFailure='queue'` results in an `ActionRetryJob` in the background queue +- [ ] `ActionRetryJob` with `attempt > maxRetries` records `status='abandoned'` and does not re-queue +- [ ] `ActionScheduleJob` executes actions with null `lastExecutedAt` immediately +- [ ] `ActionScheduleJob` skips actions whose cron expression is not yet due + +## Notes + +- **Test dry-run endpoint**: `ActionsController::test()` + `ActionService::testAction()` implement a dry-run simulation that checks event matching and builds the payload without executing side effects. Not covered in this spec — defer to a follow-up `--extend actions` run. +- **Hook migration utility**: `ActionsController::migrateFromHooks()` + `ActionService::migrateFromHooks()` migrate inline schema hooks to Action entities (one-time migration, deduplication check). Not covered here — defer to follow-up. +- **Retry delay bug**: `ActionRetryJob::calculateDelay()` is defined and tested but its result is not applied to the delay before re-queuing. Open issue: retrofit spec surfaces this; a fix PR should be filed separately. +- **Coexistence with schema hooks**: `HookListener` and `ActionListener` are both registered for the same event types. Hooks execute first (via registration order). `ActionListener` respects the propagation stop set by hooks. +- **Execution ordering**: Actions are executed in the order returned by `findMatchingActions()`. The `executionOrder` field controls DB-level ordering, but the current mapper implementation's sort behavior should be verified (not confirmed in this scan). diff --git a/openspec/changes/archive/2026-05-01-retrofit-approval-workflow-2026-05-01/specs/approval-workflow/spec.md b/openspec/changes/archive/2026-05-01-retrofit-approval-workflow-2026-05-01/specs/approval-workflow/spec.md new file mode 100644 index 000000000000..9e7bdd33a31b --- /dev/null +++ b/openspec/changes/archive/2026-05-01-retrofit-approval-workflow-2026-05-01/specs/approval-workflow/spec.md @@ -0,0 +1,138 @@ +--- +retrofit: true +status: implemented +--- +# Approval Workflow + +## Purpose + +Approval Workflow provides multi-step, role-gated approval chains for OpenRegister objects. Administrators configure named chains with ordered steps, each bound to a Nextcloud group (the "role"). When an object enters a chain, one `ApprovalStep` record per chain step is created — step 1 starts as `pending`, all others as `waiting`. Authorised users approve or reject the pending step; on approval the next waiting step is automatically advanced to `pending`. Each decision is persisted to the workflow execution history. + +## Requirements + +### REQ-001: Approval chain CRUD + +The system SHALL expose authenticated HTTP endpoints to create, read, update, and delete approval chain configurations. An approval chain entity has at minimum a `name` and an ordered array of `steps`, where each step defines a `role` (Nextcloud group ID) and an optional `order` integer. + +#### Scenario: List all approval chains + +- **GIVEN** an authenticated user +- **WHEN** `GET /api/approval-chains` is requested +- **THEN** the response is `200 OK` with a JSON array of all persisted approval chains + +#### Scenario: Get a single approval chain + +- **GIVEN** a chain with the given ID exists +- **WHEN** `GET /api/approval-chains/{id}` is requested +- **THEN** the response is `200 OK` with the chain's JSON representation +- **AND** if the chain does not exist the response is `404 Not Found` + +#### Scenario: Create an approval chain + +- **GIVEN** a valid request body with at minimum a `name` and `steps` array +- **WHEN** `POST /api/approval-chains` is requested +- **THEN** the response is `201 Created` with the created chain's JSON representation + +#### Scenario: Update an approval chain + +- **GIVEN** a chain with the given ID exists +- **WHEN** `PUT /api/approval-chains/{id}` is requested with an updated body +- **THEN** the response is `200 OK` with the updated chain +- **AND** if the chain does not exist the response is `404 Not Found` + +#### Scenario: Delete an approval chain + +- **GIVEN** a chain with the given ID exists +- **WHEN** `DELETE /api/approval-chains/{id}` is requested +- **THEN** the response is `200 OK` with the deleted chain's JSON representation +- **AND** if the chain does not exist the response is `404 Not Found` + +--- + +### REQ-002: Track object progress through an approval chain + +The system SHALL expose an endpoint that returns all objects currently in a given approval chain, along with per-object progress information: total step count and count of approved steps. + +#### Scenario: List objects with approval progress + +- **GIVEN** a chain with ID `{id}` that has objects in progress +- **WHEN** `GET /api/approval-chains/{id}/objects` is requested +- **THEN** the response is `200 OK` with a JSON array, one entry per unique `objectUuid` +- **AND** each entry contains `objectUuid`, `steps` (array of step representations), `approved` (count of steps with `status: approved`), and `total` (count of all steps for that object) +- **AND** if the chain does not exist the response is `404 Not Found` + +--- + +### REQ-003: List and filter approval steps + +The system SHALL expose an endpoint to list approval steps with optional filtering by `status`, `role`, `chainId`, and `objectUuid`. Any combination of filters may be applied; omitted filters are ignored. + +#### Scenario: List pending steps for a role + +- **GIVEN** a user who belongs to the `juridisch-adviseur` Nextcloud group +- **WHEN** `GET /api/approval-steps?status=pending&role=juridisch-adviseur` is requested +- **THEN** the response is `200 OK` with a JSON array containing only steps that match both filters + +#### Scenario: List all steps for a specific object + +- **GIVEN** an object UUID `{uuid}` that has steps in one or more chains +- **WHEN** `GET /api/approval-steps?objectUuid={uuid}` is requested +- **THEN** the response is `200 OK` with all steps for that object across all chains + +--- + +### REQ-004: Initialize approval chain steps for an object + +The system SHALL create one `ApprovalStep` record per chain-step definition when an object enters a chain. The first step (lowest `order`) is created with `status: pending`; all subsequent steps are created with `status: waiting`. + +#### Scenario: Steps created on chain initialization + +- **GIVEN** a chain with three steps (order 1, 2, 3) +- **WHEN** `initializeChain` is called for object UUID `{uuid}` +- **THEN** three `ApprovalStep` records are persisted +- **AND** the step with `stepOrder: 1` has `status: pending` +- **AND** steps with `stepOrder: 2` and `stepOrder: 3` have `status: waiting` +- **AND** all three steps reference the same `chainId` and `objectUuid` + +--- + +### REQ-005: Approve or reject a pending step with role enforcement + +The system SHALL allow an authenticated user to approve or reject a pending approval step, subject to the step's role constraint. Only users who are members of the step's Nextcloud group may decide the step. Deciding a step records the deciding user ID, an optional comment, and a `decidedAt` timestamp. On approval, the next `waiting` step for the same object is automatically advanced to `pending`. Each decision is persisted to the workflow execution history. + +#### Scenario: Authorised user approves a pending step + +- **GIVEN** a step with `status: pending` and `role: juridisch-adviseur` +- **AND** the requesting user is a member of the `juridisch-adviseur` group +- **WHEN** `POST /api/approval-steps/{id}/approve` is requested with an optional `comment` +- **THEN** the step's `status` is set to `approved`, `decidedBy` to the user's ID, and `decidedAt` to the current timestamp +- **AND** the response is `200 OK` containing the updated step and a `nextStep` key if a subsequent step was advanced to `pending` +- **AND** a workflow execution record is persisted with `status: approved` + +#### Scenario: Authorised user rejects a pending step + +- **GIVEN** a step with `status: pending` and `role: juridisch-adviseur` +- **AND** the requesting user is a member of the `juridisch-adviseur` group +- **WHEN** `POST /api/approval-steps/{id}/reject` is requested with an optional `comment` +- **THEN** the step's `status` is set to `rejected`, `decidedBy` to the user's ID, and `decidedAt` to the current timestamp +- **AND** the response is `200 OK` with the updated step; no next step is advanced on rejection +- **AND** a workflow execution record is persisted with `status: rejected` + +#### Scenario: Unauthorised user attempts to decide a step + +- **GIVEN** a step with `role: juridisch-adviseur` +- **AND** the requesting user is NOT a member of that group +- **WHEN** `POST /api/approval-steps/{id}/approve` or `/reject` is requested +- **THEN** the response is `403 Forbidden` + +#### Scenario: Attempt to decide a non-pending step + +- **GIVEN** a step with `status: approved` or `status: waiting` +- **WHEN** `POST /api/approval-steps/{id}/approve` or `/reject` is requested +- **THEN** the response is `400 Bad Request` with an error message + +#### Notes + +- Authentication is enforced by `IUserSession` — unauthenticated requests receive `401` before role checking. +- `statusOnApprove` / `statusOnReject` fields in the chain step definition allow overriding the resulting status (defaults: `approved` / `rejected`). These are stored in the chain's step definition array but currently not used to update any object state — they're returned in the service result but the controller does not act on them. +- Rejection does NOT advance the next step — the chain is effectively blocked until manual intervention. diff --git a/openspec/changes/archive/2026-05-01-retrofit-oas-generation-2026-05-01/specs/oas-generation/spec.md b/openspec/changes/archive/2026-05-01-retrofit-oas-generation-2026-05-01/specs/oas-generation/spec.md new file mode 100644 index 000000000000..d5538093f484 --- /dev/null +++ b/openspec/changes/archive/2026-05-01-retrofit-oas-generation-2026-05-01/specs/oas-generation/spec.md @@ -0,0 +1,72 @@ +--- +retrofit: true +status: implemented +--- +# OAS Generation + +## Purpose + +OAS Generation provides on-demand OpenAPI Specification (OAS 3.x) documents derived from the live register and schema configuration. Callers can retrieve a combined specification covering all registers, or a scoped specification for a single register. The endpoint is publicly accessible without authentication — OAS is treated as self-describing public API documentation. + +## Requirements + +### REQ-001: Generate OpenAPI Specification for all registers + +The system SHALL expose a public HTTP endpoint that generates and returns an OpenAPI Specification document covering all configured registers and their associated schemas. + +The specification is built by loading the base OAS template (`Resources/BaseOas.json`), then iterating every register and its schemas to populate `components/schemas`, `paths`, `tags`, OAuth2 scopes, and the `servers` block with the absolute API base URL. RBAC and multi-tenancy filters are bypassed during generation — all registers and schemas are included regardless of the requesting user's group membership. + +#### Scenario: All-register OAS is generated and returned + +- **GIVEN** an OpenRegister installation with one or more configured registers and schemas +- **WHEN** `GET /api/oas` is requested (no register ID provided) +- **THEN** the response is `200 OK` with a JSON body conforming to OpenAPI 3.x +- **AND** the `components.schemas` section contains one entry per schema with a non-empty title +- **AND** the `paths` section contains CRUD endpoints (`GET /objects/{register}/{schema}`, `POST`, `GET /{id}`, `PUT /{id}`, `DELETE /{id}`) for every register/schema combination +- **AND** the `servers` block contains the absolute URL of the OpenRegister API + +#### Scenario: OAS generation fails with a readable error + +- **GIVEN** the base OAS template file is missing or unparseable +- **WHEN** `GET /api/oas` is requested +- **THEN** the response is `500 Internal Server Error` with a JSON body containing an `error` key describing the failure + +#### Notes + +- `@PublicPage` — no authentication required. This is deliberate: OAS is API documentation, not protected data. +- The `INCLUDED_EXTENDED_ENDPOINTS` whitelist is currently empty, so only core CRUD paths are generated. Extended endpoints (audit-trails, files, lock/unlock) are defined in the code but commented out of the whitelist. +- Property-level `required: boolean` fields from schema configuration are silently stripped because OpenAPI 3.x requires `required` at object level, not property level. + +--- + +### REQ-002: Generate OpenAPI Specification for a specific register + +The system SHALL expose a public HTTP endpoint that generates and returns an OpenAPI Specification document scoped to a single register identified by its slug or database ID. + +When scoped to a specific register, the `info` section of the specification is updated with the register's title (as API title), version, and description. Only the schemas associated with that register appear in `components/schemas` and `paths`. All other generation logic (RBAC bypass, sanitization, integrity validation) is identical to REQ-001. + +#### Scenario: Single-register OAS is generated with register-specific info + +- **GIVEN** a register with slug `vergunningen` and title `Vergunningen` and two associated schemas +- **WHEN** `GET /api/oas/vergunningen` is requested +- **THEN** the response is `200 OK` with a JSON body where `info.title` is `Vergunningen API` +- **AND** `paths` contains CRUD endpoints only for the two schemas belonging to that register +- **AND** schemas from other registers are absent from `components.schemas` + +#### Scenario: Register with empty description gets a generated description + +- **GIVEN** a register with no description set +- **WHEN** the OAS for that register is generated +- **THEN** `info.description` is auto-generated as `"API for {register title} register providing CRUD operations, filtering, and search capabilities."` + +#### Scenario: Request for non-existent register ID + +- **GIVEN** a register ID that does not exist in the database +- **WHEN** `GET /api/oas/{id}` is requested +- **THEN** the response is `500 Internal Server Error` with a JSON body containing an `error` key +- **AND** no OAS document is returned + +#### Notes + +- The `id` parameter accepts both the register's integer database ID and its slug string — `OasService::createOas()` passes the value directly to `RegisterMapper::find()` which handles both forms. +- There is no `404 Not Found` path: the controller wraps all exceptions in a `500` response. A missing register produces a mapper exception that surfaces as `500`, not `404`. diff --git a/openspec/changes/archivering-vernietiging/specs/archivering-vernietiging/spec.md b/openspec/changes/archivering-vernietiging/specs/archivering-vernietiging/spec.md new file mode 100644 index 000000000000..1bbf20589b59 --- /dev/null +++ b/openspec/changes/archivering-vernietiging/specs/archivering-vernietiging/spec.md @@ -0,0 +1,570 @@ +--- +status: draft +--- +# Archivering en Vernietiging + +## Purpose +Implement archiving and destruction lifecycle management for register objects, conforming to the Archiefwet 1995, Archiefbesluit 1995, MDTO (Metagegevens Duurzaam Toegankelijke Overheidsinformatie), NEN-ISO 16175-1:2020 (successor to NEN 2082), and e-Depot export standards. Objects MUST support retention schedules derived from selectielijsten, automated destruction workflows with multi-step approval, legal holds (bevriezing), and transfer (overbrenging) to digital archival systems via standardized SIP packages. + +This spec builds upon the existing retention infrastructure in OpenRegister (`ObjectEntity.retention`, `ObjectRetentionHandler`, `Schema.archive`) and integrates with the immutable audit trail (see `audit-trail-immutable` spec) and deletion audit trail (see `deletion-audit-trail` spec) for legally required evidence trails. + +**Tender demand**: 77% of analyzed government tenders require archiving and destruction capabilities. 73% specifically reference selectielijsten, archiefnominatie, and automated vernietiging. + +## ADDED Requirements + +### Requirement: Objects MUST carry MDTO-compliant archival metadata +Each object MUST carry archival metadata fields conforming to the MDTO standard (Metagegevens Duurzaam Toegankelijke Overheidsinformatie), ensuring durable accessibility and legal compliance with the Archiefwet 1995 Article 3. These fields MUST be stored in the object's `retention` property and exposed via the API. + +#### Scenario: Archival metadata populated on object creation +- **GIVEN** a schema `zaakdossier` with archival metadata enabled via the schema's `archive` configuration +- **WHEN** a new zaakdossier object is created +- **THEN** the system MUST store the following archival metadata in the object's `retention` field: + - `archiefnominatie`: one of `vernietigen`, `bewaren`, `nog_niet_bepaald` + - `archiefactiedatum`: the ISO 8601 date on which the archival action MUST be taken + - `archiefstatus`: one of `nog_te_archiveren`, `gearchiveerd`, `vernietigd`, `overgebracht` + - `classificatie`: the selectielijst category code (e.g., `1.1`, `B1`) + - `bewaartermijn`: the retention period in ISO 8601 duration format (e.g., `P5Y`, `P20Y`) +- **AND** `archiefnominatie` MUST default to `nog_niet_bepaald` if not explicitly set +- **AND** `archiefstatus` MUST default to `nog_te_archiveren` + +#### Scenario: Archival metadata defaults from schema archive configuration +- **GIVEN** schema `vergunning-aanvraag` has `archive.defaultNominatie` set to `bewaren` and `archive.defaultBewaartermijn` set to `P20Y` +- **WHEN** a new object is created in this schema without explicit archival metadata +- **THEN** `archiefnominatie` MUST be set to `bewaren` +- **AND** `bewaartermijn` MUST be set to `P20Y` +- **AND** `archiefactiedatum` MUST be calculated as the object's creation date plus 20 years + +#### Scenario: Archival metadata validation on update +- **GIVEN** an object with `archiefstatus` set to `vernietigd` +- **WHEN** a user attempts to update the object's data +- **THEN** the system MUST reject the update with HTTP 409 Conflict +- **AND** the response MUST indicate that destroyed objects cannot be modified + +#### Scenario: Archival metadata exposed in API responses +- **GIVEN** an object `zaak-123` with archival metadata populated +- **WHEN** the object is retrieved via `GET /api/objects/{register}/{schema}/{id}` +- **THEN** the response MUST include the `retention` field containing all MDTO archival metadata +- **AND** the `retention` field MUST be filterable in search queries (e.g., `retention.archiefnominatie=vernietigen`) + +#### Scenario: MDTO XML export of archival metadata +- **GIVEN** an object with complete archival metadata +- **WHEN** the object is exported in MDTO format +- **THEN** the export MUST produce valid XML conforming to the MDTO schema (version 1.0 or later) +- **AND** the XML MUST include mandatory MDTO elements: `identificatie`, `naam`, `waardering`, `bewaartermijn`, `informatiecategorie` + +### Requirement: The system MUST support configurable selectielijsten (selection lists) +Administrators MUST be able to configure selectielijsten that map object types or zaaktypen to retention periods and archival actions, conforming to the Selectielijst gemeenten en intergemeentelijke organen (VNG) or custom organisational selection lists. Selectielijsten MUST be manageable as register objects within OpenRegister itself. + +#### Scenario: Configure a selectielijst entry +- **GIVEN** an admin configuring archival rules in a register designated for selectielijst management +- **WHEN** they create a selectielijst entry with: + - `categorie`: `B1` + - `omschrijving`: `Vergunningen met beperkte looptijd` + - `bewaartermijn`: `P5Y` + - `archiefnominatie`: `vernietigen` + - `bron`: `Selectielijst gemeenten 2020` + - `toelichting`: `Na verloop van de vergunning` +- **THEN** all objects mapped to category B1 MUST use these retention rules when their `archiefactiedatum` is calculated + +#### Scenario: Import VNG selectielijst +- **GIVEN** the VNG publishes an updated selectielijst for gemeenten +- **WHEN** an admin imports the selectielijst via CSV or JSON upload +- **THEN** all categories MUST be created as objects in the selectielijst register +- **AND** existing categories MUST be updated (not duplicated) based on their `categorie` code +- **AND** the import MUST log how many entries were created, updated, and skipped + +#### Scenario: Override selectielijst per schema +- **GIVEN** a default retention of 10 years for selectielijst category `A1` +- **AND** schema `vertrouwelijk-dossier` requires 20 years retention due to organisational policy +- **WHEN** the admin configures a schema-level override in the schema's `archive` property +- **THEN** objects in `vertrouwelijk-dossier` MUST use the 20-year retention period +- **AND** the override MUST be recorded in the audit trail with the reason for deviation + +#### Scenario: Selectielijst version management +- **GIVEN** the VNG publishes a new version of the selectielijst (e.g., 2025 edition replacing 2020 edition) +- **WHEN** the admin activates the new selectielijst version +- **THEN** existing objects MUST retain their original selectielijst reference (no retroactive changes) +- **AND** new objects MUST use the new selectielijst version +- **AND** the admin MUST be able to run a report showing objects under the old vs. new selectielijst + +### Requirement: The system MUST calculate archiefactiedatum using configurable afleidingswijzen +The archiefactiedatum (archive action date) MUST be calculable from multiple derivation methods (afleidingswijzen) as defined by the ZGW API standard, supporting at minimum the methods used by OpenZaak. + +#### Scenario: Calculate archiefactiedatum from case closure date (afgehandeld) +- **GIVEN** a zaakdossier with zaaktype `melding-openbare-ruimte` mapped to selectielijst category B1 (bewaartermijn: 5 jaar) +- **AND** afleidingswijze is set to `afgehandeld` +- **AND** the zaak is closed on 2026-03-01 +- **WHEN** the system calculates archival dates +- **THEN** `archiefactiedatum` MUST be set to 2031-03-01 (closure date + 5 years) +- **AND** `archiefnominatie` MUST be set to `vernietigen` + +#### Scenario: Calculate archiefactiedatum from a property value (eigenschap) +- **GIVEN** a vergunning with afleidingswijze `eigenschap` pointing to property `vervaldatum` +- **AND** the vergunning has `vervaldatum` set to 2028-06-15 +- **AND** the selectielijst specifies bewaartermijn `P10Y` +- **WHEN** the system calculates archival dates +- **THEN** `archiefactiedatum` MUST be set to 2038-06-15 (vervaldatum + 10 years) + +#### Scenario: Calculate archiefactiedatum with termijn method +- **GIVEN** a zaak with afleidingswijze `termijn` and procestermijn `P2Y` +- **AND** the zaak is closed on 2026-01-01 +- **AND** the selectielijst specifies bewaartermijn `P5Y` +- **WHEN** the system calculates archival dates +- **THEN** the brondatum MUST be 2028-01-01 (closure + procestermijn) +- **AND** `archiefactiedatum` MUST be 2033-01-01 (brondatum + bewaartermijn) + +#### Scenario: Recalculate archiefactiedatum when source data changes +- **GIVEN** a vergunning with afleidingswijze `eigenschap` pointing to `vervaldatum` +- **AND** current `archiefactiedatum` is 2038-06-15 +- **WHEN** the `vervaldatum` property is updated to 2030-12-31 +- **THEN** `archiefactiedatum` MUST be recalculated to 2040-12-31 +- **AND** the change MUST be logged in the audit trail + +### Requirement: The system MUST support automated destruction scheduling via background jobs +Objects that have reached their `archiefactiedatum` with `archiefnominatie` set to `vernietigen` MUST be automatically identified and queued for destruction through a background job, following the pattern used by xxllnc Zaken for batch destruction processing. + +#### Scenario: Generate destruction list via background job +- **GIVEN** 15 objects have `archiefactiedatum` before today and `archiefnominatie` set to `vernietigen` +- **AND** their `archiefstatus` is `nog_te_archiveren` +- **WHEN** the `DestructionCheckJob` (extending `OCP\BackgroundJob\TimedJob`) runs on its daily schedule +- **THEN** a destruction list MUST be generated as a register object containing references to all 15 objects +- **AND** the destruction list MUST include for each object: title, schema, register, UUID, `archiefactiedatum`, selectielijst category +- **AND** the destruction list MUST be assigned a status of `in_review` +- **AND** an `INotification` MUST be sent to users with the archivist role + +#### Scenario: Scheduled destruction respects soft-deleted objects +- **GIVEN** 3 of the 15 eligible objects have already been soft-deleted (have a `deleted` field set) +- **WHEN** the `DestructionCheckJob` generates the destruction list +- **THEN** the soft-deleted objects MUST still be included in the destruction list +- **AND** they MUST be clearly marked as already soft-deleted in the list + +#### Scenario: Prevent duplicate destruction list generation +- **GIVEN** 10 objects are eligible for destruction +- **AND** a destruction list containing 8 of these objects already exists with status `in_review` +- **WHEN** the `DestructionCheckJob` runs again +- **THEN** only the 2 objects not already on an existing destruction list MUST be added to a new list +- **AND** the existing list MUST NOT be modified + +#### Scenario: Configurable destruction check schedule +- **GIVEN** an admin wants destruction checks to run weekly instead of daily +- **WHEN** the admin updates the retention settings via `PUT /api/settings/retention` +- **THEN** the `DestructionCheckJob` interval MUST be updated accordingly +- **AND** the setting MUST be persisted in the app configuration + +### Requirement: Destruction MUST follow a multi-step approval workflow +Destruction of objects MUST NOT occur automatically. A destruction list MUST be reviewed and approved by at least one authorized archivist before any objects are permanently deleted, conforming to Archiefbesluit 1995 Articles 6-8. + +#### Scenario: Approve destruction list (full approval) +- **GIVEN** a destruction list with 15 objects and status `in_review` +- **WHEN** an archivist with the `archivaris` role approves the entire list +- **THEN** the destruction list status MUST change to `approved` +- **AND** the system MUST permanently delete all 15 objects using `ObjectService::deleteObject()` via a `QueuedJob` to avoid timeouts +- **AND** an audit trail entry MUST be created for each deletion with action `archival.destroyed` +- **AND** the audit trail entry MUST record: destruction list UUID, approving archivist, timestamp, selectielijst category +- **AND** the destruction list itself MUST be retained permanently as an archival record (verklaring van vernietiging) + +#### Scenario: Partially reject destruction list +- **GIVEN** a destruction list with 15 objects +- **WHEN** the archivist removes 3 objects from the list (marking them as `uitgezonderd`) and approves the remaining 12 +- **THEN** only the 12 approved objects MUST be destroyed +- **AND** the 3 excluded objects MUST have their `archiefactiedatum` extended by a configurable period (default: 1 year) +- **AND** the exclusion reason MUST be recorded for each excluded object +- **AND** the destruction list MUST record both the approved and excluded objects + +#### Scenario: Reject entire destruction list +- **GIVEN** a destruction list with 15 objects +- **WHEN** the archivist rejects the entire list +- **THEN** no objects MUST be destroyed +- **AND** the destruction list status MUST change to `rejected` +- **AND** the archivist MUST provide a reason for rejection +- **AND** all objects on the list MUST have their `archiefactiedatum` extended by a configurable period + +#### Scenario: Two-step approval for sensitive schemas +- **GIVEN** schema `bezwaarschriften` is configured to require two-step destruction approval +- **AND** a destruction list contains objects from this schema +- **WHEN** the first archivist approves the list +- **THEN** the status MUST change to `awaiting_second_approval` +- **AND** a second archivist (different from the first) MUST approve before destruction proceeds + +#### Scenario: Destruction certificate generation (verklaring van vernietiging) +- **GIVEN** a destruction list has been fully approved and all objects destroyed +- **WHEN** the destruction process completes +- **THEN** the system MUST generate a destruction certificate containing: + - Date of destruction + - Approving archivist(s) + - Number of objects destroyed, grouped by schema and selectielijst category + - Reference to the selectielijst used + - Statement of compliance with Archiefwet 1995 +- **AND** the certificate MUST be stored as an immutable object in the archival register + +### Requirement: The system MUST support legal holds (bevriezing) +Objects under legal hold MUST be exempt from all destruction processes, regardless of their `archiefactiedatum` or `archiefnominatie`. Legal holds support litigation, WOB/WOO requests, and regulatory investigations. + +#### Scenario: Place legal hold on an object +- **GIVEN** object `zaak-456` has `archiefactiedatum` of 2026-01-01 (in the past) and `archiefnominatie` `vernietigen` +- **WHEN** an authorized user places a legal hold with reason `WOO-verzoek 2025-0142` +- **THEN** the object's `retention` field MUST include `legalHold: { active: true, reason: "WOO-verzoek 2025-0142", placedBy: "user-id", placedDate: "2026-03-19T..." }` +- **AND** the object MUST be excluded from all destruction lists +- **AND** an audit trail entry MUST be created with action `archival.legal_hold_placed` + +#### Scenario: Legal hold prevents destruction even when on destruction list +- **GIVEN** a destruction list containing object `zaak-456` +- **AND** a legal hold is placed on `zaak-456` after the destruction list was created but before approval +- **WHEN** the archivist approves the destruction list +- **THEN** `zaak-456` MUST be automatically excluded from destruction +- **AND** the archivist MUST be notified that 1 object was excluded due to legal hold + +#### Scenario: Release legal hold +- **GIVEN** object `zaak-456` has an active legal hold +- **WHEN** an authorized user releases the legal hold with reason `WOO-verzoek afgehandeld` +- **THEN** the `legalHold.active` MUST be set to `false` +- **AND** the hold history MUST be preserved in `legalHold.history[]` +- **AND** the object MUST become eligible for destruction again if `archiefactiedatum` has passed +- **AND** an audit trail entry MUST be created with action `archival.legal_hold_released` + +#### Scenario: Bulk legal hold on schema +- **GIVEN** schema `subsidie-aanvragen` contains 200 objects +- **WHEN** an authorized user places a legal hold on all objects in this schema with reason `Rekenkameronderzoek 2026` +- **THEN** all 200 objects MUST receive a legal hold +- **AND** the operation MUST be executed via `QueuedJob` to avoid timeouts +- **AND** a single audit trail entry MUST summarize the bulk operation + +### Requirement: The system MUST support e-Depot export (overbrenging) +Objects with `archiefnominatie` set to `bewaren` that have reached their `archiefactiedatum` MUST be exportable to external e-Depot systems in a standardized SIP (Submission Information Package) format, conforming to the OAIS reference model (ISO 14721) and MDTO metadata standard. + +#### Scenario: Export objects to e-Depot as SIP package +- **GIVEN** 5 objects with `archiefnominatie` `bewaren` and `archiefactiedatum` reached +- **WHEN** the archivist initiates e-Depot transfer +- **THEN** the system MUST generate a SIP (Submission Information Package) containing: + - Object metadata in MDTO XML format per object + - Associated documents from Nextcloud Files (original format plus PDF/A rendition if available) + - A `mets.xml` structural metadata file describing the package hierarchy + - A `premis.xml` preservation metadata file with fixity checksums (SHA-256) + - A `sip-manifest.json` listing all files with checksums +- **AND** the SIP MUST be structured following the e-Depot specification of the target archive +- **AND** the SIP MUST be transmittable via the configured e-Depot endpoint (SFTP, REST API, or OpenConnector source) + +#### Scenario: Successful e-Depot transfer +- **GIVEN** a SIP package for 5 objects is transmitted to the e-Depot +- **WHEN** the e-Depot confirms receipt and acceptance +- **THEN** all 5 objects MUST have their `archiefstatus` updated to `overgebracht` +- **AND** each object MUST store the e-Depot reference identifier in `retention.eDepotReferentie` +- **AND** an audit trail entry MUST be created for each object with action `archival.transferred` +- **AND** the objects MUST become read-only in OpenRegister (no further modifications allowed) + +#### Scenario: e-Depot transfer failure (partial) +- **GIVEN** an e-Depot transfer is initiated for 5 objects +- **WHEN** the e-Depot system accepts 3 objects but rejects 2 (e.g., metadata validation errors) +- **THEN** only the 3 accepted objects MUST be marked as `overgebracht` +- **AND** the 2 rejected objects MUST remain in status `nog_te_archiveren` +- **AND** the rejection reasons MUST be stored per object in `retention.transferErrors[]` +- **AND** an `INotification` MUST be sent to the archivist with details of the partial failure + +#### Scenario: Configure e-Depot endpoint +- **GIVEN** an admin configuring the e-Depot connection +- **WHEN** they set the e-Depot endpoint via `PUT /api/settings/edepot` with: + - `endpointUrl`: the e-Depot API or SFTP address + - `authenticationType`: `api_key`, `certificate`, or `oauth2` + - `targetArchive`: identifier of the receiving archive (e.g., `regionaal-archief-leiden`) + - `sipProfile`: the SIP profile to use (e.g., `nationaal-archief-v2`, `tresoar-v1`) +- **THEN** the configuration MUST be validated by performing a test connection +- **AND** the configuration MUST be stored securely in the app configuration + +#### Scenario: e-Depot transfer via OpenConnector +- **GIVEN** an OpenConnector source is configured for the e-Depot endpoint +- **WHEN** the archivist initiates e-Depot transfer +- **THEN** the system MUST use the OpenConnector synchronization mechanism to transmit the SIP +- **AND** the transfer status MUST be tracked via OpenConnector's call log + +### Requirement: Cascading destruction MUST handle related objects +When an object is destroyed, the system MUST evaluate and handle related objects according to configurable cascade rules, integrating with the existing referential integrity system (see `deletion-audit-trail` spec). + +#### Scenario: Cascade destruction to child objects +- **GIVEN** schema `zaakdossier` has a property `documenten` referencing schema `zaakdocument` with `onDelete: CASCADE` +- **AND** zaakdossier `zaak-789` has 5 linked zaakdocumenten +- **WHEN** `zaak-789` is destroyed via an approved destruction list +- **THEN** all 5 zaakdocumenten MUST also be destroyed +- **AND** each cascaded destruction MUST produce an audit trail entry with action `archival.cascade_destroyed` +- **AND** the audit trail entry MUST reference the original destruction list + +#### Scenario: Cascade destruction blocked by RESTRICT +- **GIVEN** zaakdossier `zaak-789` references `klant-001` with `onDelete: RESTRICT` +- **WHEN** `zaak-789` appears on a destruction list +- **THEN** the destruction list MUST flag `zaak-789` with a warning that it has RESTRICT references +- **AND** the archivist MUST resolve the reference before approving destruction + +#### Scenario: Cascade destruction with legal hold on child +- **GIVEN** zaakdossier `zaak-789` is approved for destruction +- **AND** one of its child zaakdocumenten has an active legal hold +- **WHEN** the destruction is executed +- **THEN** the system MUST halt destruction of the entire zaakdossier +- **AND** the archivist MUST be notified that destruction is blocked due to a legal hold on a child object + +#### Scenario: Destruction of objects with file attachments +- **GIVEN** object `zaak-789` has 3 files stored in Nextcloud Files +- **WHEN** the object is destroyed via an approved destruction list +- **THEN** all associated files MUST also be permanently deleted from Nextcloud Files storage +- **AND** the file deletion MUST be logged in the audit trail with action `archival.file_destroyed` +- **AND** the files MUST NOT be recoverable from Nextcloud's trash + +### Requirement: WOO-published objects MUST have special destruction rules +Objects that have been published under the Wet open overheid (WOO) MUST follow additional rules before destruction, as public records carry extended transparency obligations. + +#### Scenario: WOO-published object on destruction list +- **GIVEN** object `besluit-123` has been published via the WOO publication mechanism +- **AND** `besluit-123` appears on a destruction list based on its `archiefactiedatum` +- **WHEN** the destruction list is generated +- **THEN** `besluit-123` MUST be flagged with label `woo_gepubliceerd` +- **AND** the archivist MUST explicitly confirm that destruction of a publicly accessible record is appropriate +- **AND** the public-facing copy (if hosted externally) MUST be deregistered before destruction + +#### Scenario: WOO publication extends effective retention +- **GIVEN** an object with `archiefactiedatum` of 2026-01-01 was published under WOO on 2025-12-01 +- **AND** the organisation policy requires WOO-published records to remain accessible for at least 5 years from publication +- **WHEN** the `DestructionCheckJob` evaluates this object +- **THEN** the effective `archiefactiedatum` MUST be extended to 2030-12-01 +- **AND** the original `archiefactiedatum` MUST be preserved in `retention.originalArchiefactiedatum` + +#### Scenario: WOO-published object excluded from bulk destruction +- **GIVEN** a destruction list of 20 objects, 3 of which are WOO-published +- **WHEN** the archivist uses the "exclude WOO publications" filter +- **THEN** the 3 WOO-published objects MUST be automatically excluded from the destruction list +- **AND** their exclusion reason MUST be recorded as `woo_publicatie` + +### Requirement: The system MUST provide notification before destruction +Objects approaching their `archiefactiedatum` MUST trigger notifications to relevant stakeholders, giving them time to review, extend, or apply legal holds. + +#### Scenario: Pre-destruction notification (30 days) +- **GIVEN** object `zaak-100` has `archiefactiedatum` of 2026-04-18 and `archiefnominatie` `vernietigen` +- **AND** the notification lead time is configured to 30 days +- **WHEN** today is 2026-03-19 +- **THEN** an `INotification` MUST be sent to users with the archivist role +- **AND** the notification MUST include: object title, schema, `archiefactiedatum`, selectielijst category +- **AND** the notification MUST link directly to the object in the OpenRegister UI + +#### Scenario: Notification for objects with bewaren nominatie +- **GIVEN** object `monumentdossier-5` has `archiefactiedatum` of 2026-04-18 and `archiefnominatie` `bewaren` +- **WHEN** the pre-destruction notification period is reached +- **THEN** the notification MUST indicate that the object requires e-Depot transfer, not destruction +- **AND** the notification title MUST clearly distinguish between `vernietigen` and `bewaren` actions + +#### Scenario: Configurable notification lead times per schema +- **GIVEN** schema `bezwaarschriften` requires 90 days advance notice +- **AND** the global default is 30 days +- **WHEN** the admin configures `archive.notificationLeadDays: 90` on the schema +- **THEN** objects in `bezwaarschriften` MUST receive notifications 90 days before `archiefactiedatum` + +### Requirement: The system MUST support bulk archival operations +Administrators MUST be able to perform archival operations (set nominatie, update bewaartermijn, generate destruction lists) on multiple objects simultaneously. + +#### Scenario: Bulk update archiefnominatie +- **GIVEN** 50 objects in schema `meldingen` currently have `archiefnominatie` set to `nog_niet_bepaald` +- **WHEN** the admin selects all 50 objects and sets `archiefnominatie` to `vernietigen` with selectielijst category `B1` +- **THEN** all 50 objects MUST be updated with the new nominatie and category +- **AND** the `archiefactiedatum` MUST be calculated for each object based on the selectielijst entry +- **AND** the bulk operation MUST be executed via `QueuedJob` if the count exceeds 100 objects +- **AND** a summary audit trail entry MUST record the bulk operation + +#### Scenario: Bulk extend archiefactiedatum +- **GIVEN** 30 objects are approaching their `archiefactiedatum` +- **AND** a policy change requires extending retention by 2 years +- **WHEN** the admin selects the 30 objects and extends their `archiefactiedatum` by `P2Y` +- **THEN** all 30 objects MUST have their `archiefactiedatum` extended by 2 years +- **AND** each object MUST retain its original `archiefactiedatum` in `retention.originalArchiefactiedatum` + +#### Scenario: Bulk set from selectielijst mapping +- **GIVEN** a new selectielijst mapping is configured that maps schema `vergunningen` to category `A1` (bewaren, P20Y) +- **WHEN** the admin applies the mapping to all existing objects in `vergunningen` +- **THEN** all objects MUST receive the updated archival metadata +- **AND** objects that already have a manually set `archiefnominatie` MUST NOT be overwritten (manual takes precedence) +- **AND** a report MUST show how many objects were updated vs. skipped + +### Requirement: Retention period calculation MUST account for suspension and extension +When objects represent cases (zaken) that support opschorting (suspension) and verlenging (extension), the retention period calculation MUST account for the time the case was suspended. + +#### Scenario: Retention with suspended case +- **GIVEN** a zaak closed on 2026-03-01 with bewaartermijn `P5Y` +- **AND** the zaak was suspended (opgeschort) for 60 days during its lifecycle +- **WHEN** the system calculates `archiefactiedatum` +- **THEN** the `archiefactiedatum` MUST be 2031-04-30 (closure date + 5 years + 60 days suspension) + +#### Scenario: Retention with extended case +- **GIVEN** a zaak with doorlooptijd of 8 weeks that was extended by 4 weeks +- **AND** bewaartermijn `P1Y` with afleidingswijze `afgehandeld` +- **WHEN** the zaak is closed and the system calculates `archiefactiedatum` +- **THEN** the extension period MUST NOT affect the retention calculation (retention starts from actual closure) +- **AND** `archiefactiedatum` MUST be closure date + 1 year + +#### Scenario: Manually set archiefactiedatum overrides calculation +- **GIVEN** the system calculates `archiefactiedatum` as 2031-03-01 +- **WHEN** an authorized archivist manually sets `archiefactiedatum` to 2035-03-01 with reason `Verlengd op verzoek gemeentesecretaris` +- **THEN** the manual date MUST take precedence over the calculated date +- **AND** the override MUST be recorded in the audit trail with the archivist's reason + +### Requirement: All destruction actions MUST produce immutable audit trail entries +Every archival lifecycle action MUST be recorded in the existing AuditTrail system (see `audit-trail-immutable` spec) with specific action types for archival operations. + +#### Scenario: Audit trail for destruction +- **GIVEN** object `zaak-789` is destroyed via an approved destruction list +- **WHEN** the destruction is executed +- **THEN** an AuditTrail entry MUST be created with: + - `action`: `archival.destroyed` + - `objectUuid`: UUID of `zaak-789` + - `changed`: containing `destructionListUuid`, `approvedBy`, `selectielijstCategorie`, `archiefactiedatum` +- **AND** the entry MUST be chained in the hash chain (if hash chaining is implemented) + +#### Scenario: Audit trail for e-Depot transfer +- **GIVEN** object `monumentdossier-5` is transferred to the e-Depot +- **WHEN** the transfer completes successfully +- **THEN** an AuditTrail entry MUST be created with: + - `action`: `archival.transferred` + - `changed`: containing `eDepotReferentie`, `sipPackageId`, `targetArchive` + +#### Scenario: Audit trail for legal hold +- **GIVEN** a legal hold is placed on object `zaak-456` +- **WHEN** the hold is placed +- **THEN** an AuditTrail entry MUST be created with: + - `action`: `archival.legal_hold_placed` + - `changed`: containing `reason`, `placedBy`, `placedDate` + +#### Scenario: Audit trail for archiefnominatie change +- **GIVEN** an archivist changes the `archiefnominatie` of object `zaak-100` from `vernietigen` to `bewaren` +- **WHEN** the change is saved +- **THEN** an AuditTrail entry MUST be created with: + - `action`: `archival.nominatie_changed` + - `changed`: `{"archiefnominatie": {"old": "vernietigen", "new": "bewaren"}, "reason": "..."}` + +#### Scenario: Audit trail retention for archival entries +- **GIVEN** an audit trail entry with action `archival.destroyed` +- **WHEN** the system evaluates audit trail retention +- **THEN** archival audit trail entries MUST have a minimum retention of 10 years, regardless of the `deleteLogRetention` setting +- **AND** audit entries for `archival.transferred` MUST be retained permanently + +### Requirement: NEN-ISO 16175-1:2020 compliance MUST be verifiable +The system MUST support generating a compliance report showing which requirements of NEN-ISO 16175-1:2020 (the successor to NEN 2082) are met, enabling organisations to demonstrate archival compliance to auditors and oversight bodies. + +#### Scenario: Generate compliance report +- **GIVEN** the system is configured with archival metadata, selectielijsten, and destruction workflows +- **WHEN** an admin requests a NEN-ISO 16175-1:2020 compliance report +- **THEN** the report MUST list each requirement category and its implementation status: + - Records capture and registration + - Records classification and retention + - Access and security controls + - Disposition (destruction and transfer) + - Metadata management + - Audit trail and accountability +- **AND** the report MUST identify gaps with remediation guidance + +#### Scenario: Export compliance evidence +- **GIVEN** a compliance report has been generated +- **WHEN** the admin exports the report +- **THEN** the export MUST include supporting evidence: + - Sample audit trail entries demonstrating immutability + - Configuration of selectielijsten with version references + - List of completed destruction certificates + - e-Depot transfer confirmations +- **AND** the export format MUST be PDF or structured JSON + +#### Scenario: Compliance dashboard widget +- **GIVEN** the admin navigates to the OpenRegister dashboard +- **WHEN** the archival compliance widget is displayed +- **THEN** the widget MUST show: + - Number of objects pending destruction (overdue archiefactiedatum) + - Number of objects pending e-Depot transfer + - Number of active legal holds + - Number of objects with `archiefnominatie` `nog_niet_bepaald` + - Last destruction certificate date + - Compliance score percentage + +## Current Implementation Status +- **Partial foundations (existing infrastructure):** + - `ObjectEntity` (`lib/Db/ObjectEntity.php`) has a `retention` property (JSON field) that can store archival metadata. Currently used for soft-delete tracking with `deleted`, `deletedBy`, `deletedReason`, `retentionPeriod`, and `purgeDate`. + - `Schema` entity (`lib/Db/Schema.php`) has an `archive` property (JSON field) that can store schema-level archival configuration. + - `ObjectRetentionHandler` (`lib/Service/Settings/ObjectRetentionHandler.php`) manages global retention settings including `objectArchiveRetention` (default 1 year), `objectDeleteRetention` (default 2 years), and per-log-type retention. + - `ConfigurationSettingsHandler` (`lib/Service/Settings/ConfigurationSettingsHandler.php`) provides retention settings CRUD via API (`GET/PUT /api/settings/retention`). + - `AuditTrailMapper` (`lib/Db/AuditTrailMapper.php`) has `setExpiryDate()` for retention-based expiry and already logs create/update/delete actions. + - `AuditTrail` entity (`lib/Db/AuditTrail.php`) has a `retentionPeriod` field (ISO 8601 duration string). + - `MagicMapper` (`lib/Db/MagicMapper.php`) supports `_retention` as a metadata column for objects. + - `ObjectEntity::delete()` implements soft-delete with `purgeDate` calculation (currently hardcoded to 31 days). + - `ExportService` (`lib/Service/ExportService.php`) and `ExportHandler` (`lib/Service/Object/ExportHandler.php`) support CSV/Excel export, forming a foundation for MDTO XML export. + - `FilePublishingHandler` (`lib/Service/File/FilePublishingHandler.php`) can create ZIP archives of object files, useful for SIP package generation. + - `ReferentialIntegrityService` handles CASCADE, SET_NULL, SET_DEFAULT, and RESTRICT operations with audit trail logging. + - Migration `Version1Date20250321061615` adds `retention` column to objects table and `retention_period` column. + - Migration `Version1Date20241030131427` adds `archive` column to schemas table. +- **NOT implemented:** + - No MDTO-specific archival metadata fields (`archiefnominatie`, `archiefactiedatum`, `archiefstatus`, `classificatie`) -- these would be stored within the existing `retention` JSON field + - No selectielijst entity, schema, or management UI + - No `DestructionCheckJob` background job + - No destruction list entity, generation, or approval workflow + - No e-Depot export (SIP generation, MDTO XML, METS, PREMIS) + - No legal hold mechanism + - No afleidingswijze calculation engine + - No WOO integration for destruction exemptions + - No NEN-ISO 16175-1:2020 compliance reporting + - No pre-destruction notification system + - No destruction certificate generation + - The `ObjectEntity::delete()` method's `retentionPeriod` parameter is currently ignored (hardcoded to 31 days, see `@todo` comment at line 927) + +## Standards & References +- **Archiefwet 1995** -- Dutch archival law mandating government bodies to archive and destroy records according to selectielijsten +- **Archiefbesluit 1995** -- Implementing decree for the Archiefwet, Articles 6-8 covering destruction procedures +- **MDTO** (Metagegevens Duurzaam Toegankelijke Overheidsinformatie) -- Dutch standard for archival metadata, successor to TMLO +- **TMLO** (Toepassingsprofiel Metadatering Lokale Overheden) -- Predecessor to MDTO, still used by some archives +- **NEN-ISO 16175-1:2020** -- Dutch records management standard (successor to NEN 2082), functionality requirements for record-keeping systems +- **Selectielijst gemeenten en intergemeentelijke organen** -- VNG selection list mapping zaaktypen to retention periods and archival actions +- **OAIS (ISO 14721)** -- Open Archival Information System reference model, defines SIP/AIP/DIP concepts +- **e-Depot / Nationaal Archief** -- Digital archive infrastructure; SIP profiles for transfer +- **METS** (Metadata Encoding and Transmission Standard) -- For structural metadata in SIP packages +- **PREMIS** (Preservation Metadata: Implementation Strategies) -- For preservation metadata including fixity +- **ZGW API standaard** -- Defines afleidingswijzen (derivation methods) for archiefactiedatum calculation +- **Wet open overheid (WOO)** -- Transparency law affecting destruction rules for published records +- **Common Ground** -- Reference architecture positioning archive as a separate component + +## Cross-references +- `audit-trail-immutable` -- Archival actions integrate with the immutable audit trail system; destruction events use action types prefixed with `archival.*` +- `deletion-audit-trail` -- Cascading destruction uses the same referential integrity audit trail mechanism +- `content-versioning` -- Version history MUST be included in e-Depot SIP packages; all versions are part of the archival record + +## Specificity Assessment +- The spec provides comprehensive scenario coverage for destruction workflows, legal holds, e-Depot transfer, and selectielijst management. +- The existing `retention` field on `ObjectEntity` and `archive` field on `Schema` provide a natural storage location for MDTO metadata. +- The existing `ObjectRetentionHandler` and retention settings infrastructure can be extended with archival-specific settings. +- Open questions: + - Which e-Depot systems should be supported initially? Nationaal Archief, regional archives (e.g., Tresoar, Regionaal Archief Leiden), or a generic SIP export? + - Should the destruction approval workflow use Nextcloud's built-in approval features or a custom implementation via register objects? + - How does the `purgeDate` on soft-deleted objects interact with archival `archiefactiedatum`? Should archival destruction bypass the soft-delete mechanism entirely? + - Should selectielijsten be stored as OpenRegister objects (in a dedicated schema) or as a separate entity type with dedicated database table? + - What is the minimum viable implementation: full MDTO XML export or a simpler CSV-based destruction certificate? + +## Nextcloud Integration Analysis + +**Status**: Not yet implemented. The `retention` field on `ObjectEntity`, `archive` field on `Schema`, and retention settings infrastructure provide substantial foundations. + +**Nextcloud Core Interfaces**: +- `TimedJob` (`OCP\BackgroundJob\TimedJob`): Schedule a `DestructionCheckJob` that runs daily, scanning objects where `archiefactiedatum <= today` and `archiefnominatie = vernietigen` and no active legal hold. Generates destruction lists and sends notifications. +- `QueuedJob` (`OCP\BackgroundJob\QueuedJob`): Execute large-scale destruction (batch delete), e-Depot transfers, and bulk archival operations to avoid HTTP timeout issues. +- `INotifier` / `INotification` (`OCP\Notification`): Send pre-destruction warnings (configurable lead time), destruction list creation notifications, e-Depot transfer results, and legal hold notifications. +- `AuditTrail` (OpenRegister's `AuditTrailMapper`): Log all archival lifecycle actions with dedicated action types: `archival.destroyed`, `archival.transferred`, `archival.legal_hold_placed`, `archival.legal_hold_released`, `archival.nominatie_changed`. These entries provide the legally required evidence trail per Archiefbesluit 1995. +- `ITrashManager` patterns: Follow Nextcloud's trash/soft-delete patterns. Objects approved for destruction transition through `pending_destruction` state before permanent deletion, adding a safety gate. + +**Implementation Approach**: +- Store MDTO archival metadata in the existing `ObjectEntity.retention` JSON field. Fields: `archiefnominatie`, `archiefactiedatum`, `archiefstatus`, `classificatie`, `bewaartermijn`, `legalHold`, `eDepotReferentie`. +- Store schema-level archival defaults in the existing `Schema.archive` JSON field. Fields: `defaultNominatie`, `defaultBewaartermijn`, `selectielijstCategorie`, `afleidingswijze`, `notificationLeadDays`, `requireTwoStepApproval`. +- Model selectielijsten as register objects in a dedicated schema within an archival management register. Each entry maps a classification code to retention period and archival action. +- Implement destruction lists as register objects in the same archival register, with status tracking (`in_review`, `approved`, `rejected`, `awaiting_second_approval`, `completed`). +- Fix the `ObjectEntity::delete()` method's hardcoded 31-day purge date to use the actual `retentionPeriod` parameter. +- Create an `EDepotExportService` that generates MDTO XML, METS structural metadata, and PREMIS preservation metadata, packaging them with Nextcloud Files into a SIP. Use `FilePublishingHandler`'s ZIP archive capability as foundation. +- Extend `ConfigurationSettingsHandler` with e-Depot endpoint configuration and destruction check scheduling. +- Integrate with OpenConnector for e-Depot transmission when an OpenConnector source is configured. + +**Dependencies on Existing OpenRegister Features**: +- `ObjectService` -- CRUD and deletion of objects with audit trail logging +- `AuditTrailMapper` -- Immutable logging of archival actions +- `ObjectRetentionHandler` -- Global retention settings (extend with archival-specific settings) +- `Schema.archive` property -- Schema-level archival configuration +- `ObjectEntity.retention` property -- Object-level archival metadata storage +- `ExportHandler` / `ExportService` -- Foundation for MDTO XML and SIP package generation +- `FilePublishingHandler` -- ZIP archive creation for SIP packages +- `FileService` -- Retrieval of associated documents for SIP inclusion +- `ReferentialIntegrityService` -- Cascading destruction with audit trail +- `MagicMapper._retention` -- Metadata column for retention data in object queries diff --git a/openspec/changes/auth-system/specs/auth-system/spec.md b/openspec/changes/auth-system/specs/auth-system/spec.md new file mode 100644 index 000000000000..ecc8d3a54902 --- /dev/null +++ b/openspec/changes/auth-system/specs/auth-system/spec.md @@ -0,0 +1,487 @@ +--- +status: implemented +--- + +# Authentication and Authorization System + +## Purpose +Define the authentication and authorization system for OpenRegister, supporting Nextcloud session auth, Basic Auth for API consumers, JWT bearer tokens for external systems, API key auth for MCP and service-to-service integration, and SSO integration via SAML/OIDC. The auth system MUST map all external identities to Nextcloud users via the Consumer entity and enforce consistent RBAC across every access method (REST, GraphQL, MCP, public endpoints), ensuring that a single identity model drives schema-level, property-level, and row-level security decisions. + +**Source**: Core OpenRegister capability; 67% of tenders require SSO/identity integration; 86% require RBAC per zaaktype. + +## Requirements + +### Requirement: The system MUST support multiple authentication methods with unified identity resolution +OpenRegister MUST accept authentication via Nextcloud session cookies, HTTP Basic Auth, Bearer JWT tokens, OAuth2 bearer tokens, and API keys. All methods MUST resolve to a Nextcloud user identity (via `OCP\IUserSession::setUser()`) before any RBAC evaluation occurs, ensuring that authorization decisions are independent of the authentication method used. + +#### Scenario: Nextcloud session authentication for browser users +- **GIVEN** a user is logged into Nextcloud via browser session +- **WHEN** they access OpenRegister pages or API endpoints +- **THEN** the request MUST be authenticated using the Nextcloud session cookie via `IUserSession` +- **AND** the user's Nextcloud identity and group memberships MUST be used for all subsequent RBAC checks + +#### Scenario: Basic Auth for API consumers +- **GIVEN** an external system sends a request with `Authorization: Basic base64(user:pass)` +- **WHEN** the credentials are validated against Nextcloud's user backend via `IUserManager::checkPassword()` +- **THEN** the request MUST be authenticated as that Nextcloud user +- **AND** `AuthorizationService::authorizeBasic()` MUST call `$this->userSession->setUser($user)` so that downstream RBAC uses the resolved identity +- **AND** if the credentials are invalid, an `AuthenticationException` MUST be thrown + +#### Scenario: JWT Bearer token for external systems +- **GIVEN** an API consumer configured in OpenRegister with `authorizationType: jwt` +- **WHEN** the consumer sends `Authorization: Bearer {jwt-token}` +- **THEN** `AuthorizationService::authorizeJwt()` MUST parse the token, extract the `iss` claim, look up the matching Consumer via `ConsumerMapper::findAll(['name' => issuer])`, verify the HMAC signature (HS256/HS384/HS512) using the Consumer's `authorizationConfiguration.publicKey`, validate `iat` and `exp` claims, and call `$this->userSession->setUser()` with the Consumer's mapped Nextcloud user (`Consumer::getUserId()`) + +#### Scenario: API key authentication for MCP and service-to-service calls +- **GIVEN** an API consumer configured with `authorizationType: apiKey` and a map of valid keys to user IDs in `authorizationConfiguration` +- **WHEN** a request includes the API key in the designated header +- **THEN** `AuthorizationService::authorizeApiKey()` MUST look up the key, resolve it to a Nextcloud user via `IUserManager::get()`, and set the user session +- **AND** if the key is not found or the mapped user does not exist, an `AuthenticationException` MUST be thrown + +#### Scenario: Reject invalid credentials with appropriate HTTP status +- **GIVEN** a request with invalid Basic Auth credentials, an expired JWT, or an unrecognized API key +- **THEN** the system MUST return HTTP 401 Unauthorized +- **AND** the response body MUST NOT leak information about whether the username exists +- **AND** the `SecurityService` MUST record the failed attempt for rate limiting purposes + +### Requirement: API consumers MUST be configurable entities that bridge external systems to Nextcloud identities +Administrators MUST be able to create, update, and revoke Consumer entities that define how external systems authenticate with OpenRegister. Each Consumer MUST map to exactly one Nextcloud user for RBAC resolution. + +#### Scenario: Create a JWT API consumer +- **GIVEN** the admin navigates to OpenRegister consumer management +- **WHEN** they create a consumer with: + - `name`: `Zaaksysteem Extern` (also serves as JWT `iss` claim for matching) + - `description`: `Integration with the external case management system` + - `authorizationType`: `jwt` + - `authorizationConfiguration`: `{ "publicKey": "shared-secret", "algorithm": "HS256" }` + - `userId`: `api-zaaksysteem` (existing Nextcloud user) + - `domains`: `["zaaksysteem.gemeente.nl"]` (for CORS) + - `ips`: `["10.0.1.0/24"]` (for IP allow-listing) +- **THEN** the Consumer entity MUST be persisted with an auto-generated UUID +- **AND** subsequent JWT requests with `iss: "Zaaksysteem Extern"` MUST authenticate as `api-zaaksysteem` + +#### Scenario: Create an API key consumer +- **GIVEN** the admin creates a consumer with `authorizationType: apiKey` +- **WHEN** `authorizationConfiguration` contains `{ "keys": { "sk_live_abc123": "api-user-1" } }` +- **THEN** requests with header matching `sk_live_abc123` MUST authenticate as Nextcloud user `api-user-1` + +#### Scenario: Revoke a consumer +- **GIVEN** an active consumer `Zaaksysteem Extern` +- **WHEN** the admin deletes the consumer via `ConsumersController` +- **THEN** subsequent JWT requests with `iss: "Zaaksysteem Extern"` MUST fail with `AuthenticationException("The issuer was not found")` +- **AND** the HTTP response MUST be 401 Unauthorized + +#### Scenario: Consumer with IP restrictions +- **GIVEN** consumer `Zaaksysteem Extern` has `ips: ["10.0.1.0/24"]` +- **WHEN** a valid JWT request arrives from IP `192.168.1.50` (outside the allowed range) +- **THEN** the system MUST reject the request with HTTP 403 Forbidden +- **AND** a security event MUST be logged + +#### Scenario: Consumer with CORS domain restrictions +- **GIVEN** consumer `Zaaksysteem Extern` has `domains: ["zaaksysteem.gemeente.nl"]` +- **WHEN** a cross-origin request arrives with `Origin: https://evil.example.com` +- **THEN** `AuthorizationService::corsAfterController()` MUST NOT include `Access-Control-Allow-Origin` for the unauthorized origin +- **AND** `Access-Control-Allow-Credentials` MUST NOT be set to `true` (throws `SecurityException` if detected) + +### Requirement: The RBAC model MUST enforce schema-level, property-level, and row-level access control using Nextcloud groups +Authorization MUST be evaluated at three levels: schema-level (can this user access this schema at all?), property-level (can this user see/modify specific fields?), and row-level (does this specific object match the user's access conditions?). All levels MUST use Nextcloud group memberships (`OCP\IGroupManager::getUserGroupIds()`) as the primary authorization primitive. + +#### Scenario: Schema-level RBAC denies access to unauthorized group +- **GIVEN** schema `bezwaarschriften` has authorization: `{ "read": ["juridisch-team"], "create": ["juridisch-team"], "update": ["juridisch-team"], "delete": ["admin"] }` +- **AND** user `medewerker-1` is in group `kcc-team` (not `juridisch-team`) +- **WHEN** `medewerker-1` sends GET `/api/objects/{register}/bezwaarschriften` +- **THEN** `PermissionHandler::hasPermission()` MUST return `false` for action `read` +- **AND** `PermissionHandler::checkPermission()` MUST throw an Exception with message containing "does not have permission to 'read'" +- **AND** the HTTP response MUST be 403 Forbidden + +#### Scenario: Property-level RBAC filters sensitive fields from API responses +- **GIVEN** schema `inwoners` has property `bsn` with authorization: `{ "read": [{ "group": "bsn-geautoriseerd" }], "update": [{ "group": "bsn-geautoriseerd" }] }` +- **AND** user `medewerker-1` is NOT in group `bsn-geautoriseerd` +- **WHEN** `medewerker-1` reads an inwoner object +- **THEN** `PropertyRbacHandler::filterReadableProperties()` MUST omit the `bsn` field from the response +- **AND** all other fields without property-level authorization MUST still be returned + +#### Scenario: Row-level RBAC with conditional matching filters query results at the database level +- **GIVEN** schema `meldingen` has authorization: `{ "read": [{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }] }` +- **AND** user `jan` is in group `behandelaars` with active organisation `org-uuid-1` +- **WHEN** `jan` lists meldingen +- **THEN** `MagicRbacHandler::applyRbacFilters()` MUST add a SQL WHERE clause: `t._organisation = 'org-uuid-1'` +- **AND** only meldingen belonging to `org-uuid-1` MUST be returned +- **AND** meldingen from other organisations MUST be filtered at the database query level (not post-fetch) + +#### Scenario: Combined schema + property + row-level RBAC +- **GIVEN** schema `dossiers` with schema-level auth allowing `behandelaars`, property-level auth restricting `interneAantekening` to `redacteuren`, and row-level match on `_organisation` +- **WHEN** user `jan` (in `behandelaars`, NOT in `redacteuren`, org `org-1`) reads a dossier from `org-1` +- **THEN** schema-level check MUST pass (jan is in behandelaars) +- **AND** row-level check MUST pass (org matches) +- **AND** property-level check MUST filter out `interneAantekening` from the response + +#### Scenario: Schema without authorization configuration allows all access +- **GIVEN** schema `tags` has no `authorization` array (empty or null) +- **WHEN** any authenticated user performs CRUD operations on `tags` +- **THEN** `PermissionHandler::hasGroupPermission()` MUST return `true` (no authorization = open access) + +### Requirement: The role hierarchy MUST include admin bypass, owner privileges, public access, and authenticated access +The system MUST support a clear role hierarchy: `admin` > object owner > named groups > `authenticated` > `public`. Each level MUST be consistently evaluated across all handlers. + +#### Scenario: Admin group bypasses all authorization checks +- **GIVEN** a user in the Nextcloud `admin` group +- **WHEN** they access any schema, property, or object in OpenRegister +- **THEN** `PermissionHandler::hasPermission()` MUST return `true` immediately after detecting admin group membership via `in_array('admin', $userGroups)` +- **AND** `PropertyRbacHandler::isAdmin()` MUST return `true`, bypassing all property filtering +- **AND** `MagicRbacHandler::applyRbacFilters()` MUST return without adding any WHERE clauses + +#### Scenario: Object owner has full CRUD permissions on their own objects +- **GIVEN** user `jan` created object `melding-1` (objectOwner = `jan`) +- **AND** schema `meldingen` restricts write access to group `beheerders` +- **AND** `jan` is NOT in group `beheerders` +- **WHEN** `jan` updates `melding-1` +- **THEN** `PermissionHandler::hasGroupPermission()` MUST return `true` because `$objectOwner === $userId` +- **AND** `MagicRbacHandler` MUST include `t._owner = 'jan'` as an OR condition in SQL queries + +#### Scenario: Public access for unauthenticated requests +- **GIVEN** schema `producten` has authorization: `{ "read": ["public"] }` +- **WHEN** an unauthenticated request (no session, no auth header) reads producten objects +- **THEN** `PermissionHandler::hasPermission()` MUST detect `$user === null` and check the `public` group +- **AND** `MagicRbacHandler::processSimpleRule('public')` MUST return `true` +- **AND** write operations MUST still require authentication (no `public` in create/update/delete rules) + +#### Scenario: Authenticated pseudo-group grants access to any logged-in user +- **GIVEN** schema `feedback` has authorization: `{ "create": ["authenticated"] }` +- **WHEN** any logged-in Nextcloud user (regardless of specific group membership) creates a feedback object +- **THEN** `PropertyRbacHandler::userQualifiesForGroup('authenticated')` MUST return `true` when `$userId !== null` +- **AND** `MagicRbacHandler::processSimpleRule('authenticated')` MUST return `true` when `$userId !== null` + +#### Scenario: Logged-in users inherit public permissions +- **GIVEN** schema `producten` has `read: ["public"]` +- **AND** user `jan` is logged in but not in any special group +- **WHEN** `jan` reads producten +- **THEN** `PermissionHandler::hasPermission()` MUST check public group as fallback after checking user's actual groups +- **AND** access MUST be granted because logged-in users have at least public-level access + +### Requirement: Group-based access MUST support conditional matching with dynamic variables +Authorization rules MUST support conditional matching where access depends on both group membership AND runtime conditions evaluated against the object's data. The system MUST resolve dynamic variables including `$organisation`, `$userId`, and `$now`. + +#### Scenario: Organisation-scoped access via $organisation variable +- **GIVEN** schema `zaken` has authorization: `{ "read": [{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }] }` +- **AND** user `jan` is in group `behandelaars` with active organisation UUID `abc-123` +- **WHEN** `jan` queries zaken +- **THEN** `MagicRbacHandler::resolveDynamicValue('$organisation')` MUST return `abc-123` via `OrganisationService::getActiveOrganisation()` +- **AND** the SQL condition MUST be `t._organisation = 'abc-123'` +- **AND** the resolved organisation UUID MUST be cached in `$this->cachedActiveOrg` for subsequent calls within the same request + +#### Scenario: User-scoped access via $userId variable +- **GIVEN** schema `taken` has authorization: `{ "read": [{ "group": "medewerkers", "match": { "assignedTo": "$userId" } }] }` +- **AND** user `jan` (UID: `jan`) is in group `medewerkers` +- **WHEN** `jan` queries taken +- **THEN** `MagicRbacHandler::resolveDynamicValue('$userId')` MUST return `jan` via `$this->userSession->getUser()->getUID()` +- **AND** only taken where `assigned_to = 'jan'` MUST be returned + +#### Scenario: Time-based access via $now variable +- **GIVEN** schema `publicaties` has authorization: `{ "read": [{ "group": "public", "match": { "publishDate": { "$lte": "$now" } } }] }` +- **WHEN** an unauthenticated user queries publicaties +- **THEN** `MagicRbacHandler::resolveDynamicValue('$now')` MUST return the current datetime in `Y-m-d H:i:s` format +- **AND** only publicaties with `publish_date <= NOW()` MUST be returned + +#### Scenario: Multiple match conditions require AND logic +- **GIVEN** a rule: `{ "group": "behandelaars", "match": { "_organisation": "$organisation", "status": "open" } }` +- **WHEN** a user in `behandelaars` queries objects +- **THEN** `MagicRbacHandler::buildMatchConditions()` MUST combine conditions with AND logic +- **AND** both `_organisation` and `status` conditions MUST be satisfied for an object to be returned + +#### Scenario: Conditional rule on create operations skips organisation matching +- **GIVEN** property `interneAantekening` has authorization: `{ "update": [{ "group": "public", "match": { "_organisation": "$organisation" } }] }` +- **WHEN** a user creates a new object (no existing object data yet) +- **THEN** `PropertyRbacHandler::checkConditionalRule()` MUST call `$this->conditionMatcher->filterOrganisationMatchForCreate()` to remove `_organisation` from match conditions +- **AND** if the remaining match is empty, access MUST be granted + +### Requirement: Multi-tenancy isolation MUST restrict data access to the user's active organisation +The system MUST enforce organisation-level data isolation so that users only see objects belonging to their active organisation, unless RBAC rules explicitly grant cross-organisation access. + +#### Scenario: Organisation filtering in MagicMapper queries +- **GIVEN** user `jan` has active organisation `org-uuid-1` +- **AND** the register has multi-tenancy enabled +- **WHEN** `jan` queries any schema in that register +- **THEN** `MultiTenancyTrait` MUST add a WHERE clause filtering on the organisation column +- **AND** objects from `org-uuid-2` MUST NOT be returned + +#### Scenario: RBAC conditional rules can bypass multi-tenancy +- **GIVEN** schema `catalogi` has RBAC rule: `{ "read": [{ "group": "catalogus-beheerders", "match": { "aanbieder": "$organisation" } }] }` +- **AND** user `jan` is in `catalogus-beheerders` +- **WHEN** `MagicRbacHandler::hasConditionalRulesBypassingMultitenancy()` evaluates the rules +- **THEN** it MUST detect that the match contains a non-`_organisation` field (`aanbieder`) +- **AND** multi-tenancy filtering MUST be bypassed, allowing RBAC to handle access control instead + +#### Scenario: Admin users see all organisations +- **GIVEN** a user in the `admin` group +- **WHEN** they query any register +- **THEN** multi-tenancy filtering MUST be bypassed +- **AND** objects from all organisations MUST be visible + +### Requirement: Public endpoints MUST use Nextcloud's annotation framework and enforce mixed visibility +Specific schemas and API endpoints MUST be configurable to allow unauthenticated read access using Nextcloud's `@PublicPage` annotation, while ensuring that write operations and private schemas remain protected. + +#### Scenario: Public read endpoint via @PublicPage annotation +- **GIVEN** the `ObjectsController` has methods annotated with `@PublicPage` for public object access +- **WHEN** an unauthenticated request hits a public endpoint +- **THEN** Nextcloud's middleware MUST skip the login check +- **AND** `PermissionHandler::hasPermission()` MUST evaluate using the `public` pseudo-group +- **AND** if the schema has `read: ["public"]`, the objects MUST be returned + +#### Scenario: Write operations on public endpoints still require authentication +- **GIVEN** schema `producten` is marked as publicly readable (`read: ["public"]`) +- **WHEN** an unauthenticated request attempts POST/PUT/DELETE on producten objects +- **THEN** `PermissionHandler::hasPermission()` MUST check the `public` group for the write action +- **AND** since `public` is not in create/update/delete rules, the request MUST be denied with HTTP 403 + +#### Scenario: Mixed public/private schemas in the same register +- **GIVEN** register `catalogi` with schema `producten` (read: `["public"]`) and schema `interne-notities` (read: `["redacteuren"]`) +- **WHEN** an unauthenticated request lists schemas or objects +- **THEN** only `producten` MUST be accessible +- **AND** `interne-notities` MUST return HTTP 403 for unauthenticated requests +- **AND** the OAS specification MUST reflect the different security requirements per schema + +### Requirement: The system MUST support SSO via SAML, OIDC, and LDAP through Nextcloud's identity providers +OpenRegister MUST integrate with Nextcloud's SSO capabilities transparently, requiring no OpenRegister-specific SSO code. All SSO methods MUST result in a valid Nextcloud user session that OpenRegister can use for RBAC. + +#### Scenario: SAML authentication flow +- **GIVEN** Nextcloud is configured with a SAML identity provider via the `user_saml` app +- **WHEN** a user authenticates via SAML +- **THEN** Nextcloud MUST create/map the user to a Nextcloud user account +- **AND** group memberships from SAML assertions MUST be synced to Nextcloud groups (configured in `user_saml`) +- **AND** OpenRegister MUST use the resulting `IUserSession` identity for all RBAC checks without any additional mapping + +#### Scenario: OIDC authentication flow +- **GIVEN** Nextcloud is configured with an OpenID Connect provider via the `user_oidc` app +- **WHEN** a user authenticates via OIDC +- **THEN** OIDC claims MUST be mapped to Nextcloud user attributes by Nextcloud's OIDC app +- **AND** OpenRegister MUST use the mapped Nextcloud user identity from `IUserSession` + +#### Scenario: LDAP group synchronization +- **GIVEN** Nextcloud is configured with LDAP backend for user and group management +- **WHEN** LDAP groups are synchronized to Nextcloud +- **THEN** the synchronized groups MUST be usable in OpenRegister schema authorization rules +- **AND** RBAC checks via `IGroupManager::getUserGroupIds()` MUST reflect LDAP group memberships + +#### Scenario: DigiD/eHerkenning via SAML gateway +- **GIVEN** Nextcloud's SAML app is configured with a DigiD/eHerkenning SAML gateway +- **WHEN** a citizen authenticates via DigiD +- **THEN** the citizen MUST be mapped to a Nextcloud user +- **AND** OpenRegister MUST apply RBAC based on the mapped user's group memberships +- **AND** the BSN from the SAML assertion MUST be available as a user attribute for row-level security matching + +### Requirement: Rate limiting MUST protect against brute force attacks and API abuse +The `SecurityService` MUST implement multi-layer rate limiting using APCu/distributed cache to prevent brute force authentication attacks and API abuse, with configurable thresholds and progressive delays. + +#### Scenario: Rate limit failed login attempts per username +- **GIVEN** 5 failed login attempts for username `admin` within 900 seconds (15-minute window) +- **THEN** `SecurityService::checkLoginRateLimit()` MUST return `{ allowed: false, reason: "Too many login attempts" }` +- **AND** subsequent attempts MUST be blocked until the lockout expires (default: 3600 seconds / 1 hour) +- **AND** `SecurityService::recordFailedLoginAttempt()` MUST set the `openregister_user_lockout_admin` cache key + +#### Scenario: Rate limit failed attempts per IP address +- **GIVEN** 5 failed login attempts from IP `10.0.1.50` within 900 seconds +- **THEN** all subsequent requests from that IP MUST be blocked (regardless of username) +- **AND** `SecurityService::recordFailedLoginAttempt()` MUST set the `openregister_ip_lockout_10.0.1.50` cache key + +#### Scenario: Progressive delay for repeated failures +- **GIVEN** rate limiting is active for a user/IP combination +- **WHEN** additional attempts are made +- **THEN** the delay MUST increase progressively: 2s, 4s, 8s, 16s, 32s, capped at 60s (`MAX_PROGRESSIVE_DELAY`) +- **AND** the current delay MUST be stored in cache key `openregister_progressive_delay_{username}_{ip}` + +#### Scenario: Successful login clears rate limits +- **GIVEN** user `admin` has 3 failed attempts recorded +- **WHEN** `admin` successfully authenticates +- **THEN** `SecurityService::recordSuccessfulLogin()` MUST clear all rate limit caches: user attempts, user lockout, IP attempts, IP lockout, and progressive delay + +#### Scenario: Admin can manually clear rate limits +- **GIVEN** IP `10.0.1.50` is locked out due to suspicious activity +- **WHEN** an administrator calls `SecurityService::clearIpRateLimits('10.0.1.50')` +- **THEN** the IP lockout MUST be immediately cleared +- **AND** a security event `ip_rate_limits_cleared` MUST be logged + +### Requirement: Authentication and security events MUST be audited +All authentication attempts (success and failure), lockouts, and security policy changes MUST be logged via `SecurityService::logSecurityEvent()` for security monitoring and compliance. + +#### Scenario: Log successful authentication +- **GIVEN** user `admin` authenticates via Basic Auth from IP `10.0.1.50` +- **THEN** `SecurityService::recordSuccessfulLogin()` MUST log event `successful_login` with context: `username`, `ip_address`, `timestamp` + +#### Scenario: Log failed authentication +- **GIVEN** an invalid JWT token is presented from IP `10.0.1.50` +- **THEN** `SecurityService::recordFailedLoginAttempt()` MUST log event `failed_login_attempt` with context: `username`, `ip_address`, `reason`, `user_attempts`, `ip_attempts` + +#### Scenario: Log user lockout +- **GIVEN** user `admin` reaches 5 failed attempts +- **THEN** `SecurityService` MUST log event `user_locked_out` at WARNING level with context: `username`, `ip_address`, `attempts`, `lockout_until` + +#### Scenario: Log IP lockout +- **GIVEN** IP `10.0.1.50` reaches 5 failed attempts +- **THEN** `SecurityService` MUST log event `ip_locked_out` at WARNING level with context: `ip_address`, `attempts`, `lockout_until` + +#### Scenario: Log access during lockout +- **GIVEN** user `admin` is currently locked out +- **WHEN** another login attempt arrives +- **THEN** `SecurityService` MUST log event `login_attempt_during_lockout` at WARNING level + +### Requirement: Permission evaluation results MUST be cacheable for performance +The system MUST cache frequently evaluated permission results to avoid repeated database queries and group lookups within the same request lifecycle. + +#### Scenario: MagicRbacHandler caches active organisation UUID +- **GIVEN** user `jan` with active organisation `org-uuid-1` +- **WHEN** `MagicRbacHandler::getActiveOrganisationUuid()` is called multiple times within one request +- **THEN** the first call MUST resolve via `OrganisationService::getActiveOrganisation()` and store in `$this->cachedActiveOrg` +- **AND** subsequent calls MUST return the cached value without calling OrganisationService again + +#### Scenario: Group memberships are resolved once per request +- **GIVEN** a request that triggers multiple RBAC checks across different schemas +- **WHEN** `IGroupManager::getUserGroupIds()` is called +- **THEN** the result SHOULD be cached at the service level to avoid repeated LDAP/database lookups within the same request + +#### Scenario: RBAC at SQL level avoids post-fetch filtering +- **GIVEN** schema `meldingen` with RBAC rules +- **WHEN** `MagicRbacHandler::applyRbacFilters()` adds WHERE clauses to the query +- **THEN** filtering MUST happen at the database query level +- **AND** unauthorized objects MUST never be loaded into PHP memory +- **AND** pagination counts MUST reflect only the accessible result set + +### Requirement: CORS policy MUST be enforced per Consumer and prevent CSRF +The `AuthorizationService::corsAfterController()` method MUST enforce CORS headers based on the request origin, and MUST prevent CSRF attacks by rejecting `Access-Control-Allow-Credentials: true`. + +#### Scenario: Add CORS headers for valid origin +- **GIVEN** a cross-origin request with `Origin: https://zaaksysteem.gemeente.nl` +- **WHEN** `AuthorizationService::corsAfterController()` processes the response +- **THEN** the response MUST include `Access-Control-Allow-Origin: https://zaaksysteem.gemeente.nl` + +#### Scenario: Reject CSRF-unsafe CORS configuration +- **GIVEN** a response that includes `Access-Control-Allow-Credentials: true` +- **WHEN** `AuthorizationService::corsAfterController()` inspects the response headers +- **THEN** a `SecurityException` MUST be thrown with message "Access-Control-Allow-Credentials must not be set to true in order to prevent CSRF" + +#### Scenario: Security headers added to responses +- **GIVEN** any API response from OpenRegister +- **WHEN** `SecurityService::addSecurityHeaders()` processes the response +- **THEN** the following headers MUST be set: `X-Frame-Options: DENY`, `X-Content-Type-Options: nosniff`, `X-XSS-Protection: 1; mode=block`, `Referrer-Policy: strict-origin-when-cross-origin`, `Content-Security-Policy: default-src 'none'; frame-ancestors 'none';`, `Cache-Control: no-store, no-cache, must-revalidate, private` + +### Requirement: MCP endpoint authentication MUST use Nextcloud's standard auth mechanisms +The MCP server endpoint (`/api/mcp`) MUST require authentication via Nextcloud's standard mechanisms (session or Basic Auth) and MUST NOT implement a separate authentication layer. + +#### Scenario: MCP endpoint requires authentication +- **GIVEN** the MCP endpoint at `/index.php/apps/openregister/api/mcp` +- **WHEN** an unauthenticated request is sent +- **THEN** Nextcloud's middleware MUST reject the request with HTTP 401 +- **AND** the `McpServerController` MUST NOT be invoked + +#### Scenario: MCP endpoint uses Basic Auth for programmatic access +- **GIVEN** an MCP client configured with Basic Auth credentials (`admin:admin`) +- **WHEN** the client sends a JSON-RPC 2.0 request to the MCP endpoint +- **THEN** Nextcloud MUST authenticate the user via Basic Auth +- **AND** the MCP tools MUST operate in the context of the authenticated user +- **AND** RBAC MUST apply to all register/schema/object operations performed via MCP tools + +#### Scenario: MCP session isolation +- **GIVEN** two different MCP clients authenticated as different users +- **WHEN** each client performs operations via the MCP endpoint +- **THEN** each session MUST be isolated using the `Mcp-Session-Id` header +- **AND** RBAC checks MUST use the respective authenticated user's identity + +### Requirement: Service-to-service authentication MUST support outbound token generation +The `AuthenticationService` MUST generate outbound authentication tokens (OAuth2 access tokens, signed JWTs) for calls to external services configured as Sources, supporting multiple signing algorithms and OAuth2 grant types. + +#### Scenario: Generate OAuth2 client_credentials token for outbound call +- **GIVEN** an external Source configured with OAuth2 client credentials +- **WHEN** `AuthenticationService::fetchOAuthTokens()` is called with grant_type `client_credentials` +- **THEN** the service MUST POST to the configured `tokenUrl` with `client_id` and `client_secret` +- **AND** the resulting `access_token` MUST be returned for use in outbound API calls + +#### Scenario: Generate signed JWT for outbound call +- **GIVEN** an external Source configured with JWT authentication +- **WHEN** `AuthenticationService::fetchJWTToken()` is called +- **THEN** the service MUST render the Twig payload template, sign it with the configured algorithm (HS256, HS384, HS512, RS256, RS384, RS512, PS256), and return the compact-serialized JWT + +#### Scenario: Generate JWT with x5t certificate thumbprint +- **GIVEN** an external Source requiring x5t header in JWT +- **WHEN** the configuration includes an `x5t` value +- **THEN** the JWT header MUST include `{ "alg": "...", "typ": "JWT", "x5t": "..." }` + +### Requirement: Input sanitization MUST prevent XSS and injection attacks +The `SecurityService` MUST sanitize all user inputs to prevent cross-site scripting (XSS) and injection attacks, applying defense-in-depth beyond Nextcloud's built-in protections. + +#### Scenario: Sanitize login credentials +- **GIVEN** a login attempt with username containing `` +- **WHEN** `SecurityService::validateLoginCredentials()` processes the input +- **THEN** the username MUST be sanitized via `htmlspecialchars()` with ENT_QUOTES +- **AND** null bytes MUST be stripped +- **AND** JavaScript event handlers (`onload=`, `onerror=`, etc.) MUST be removed +- **AND** the sanitized username MUST be truncated to 320 characters maximum + +#### Scenario: Reject credentials with invalid characters +- **GIVEN** a username containing `<>"\'/\\` characters +- **WHEN** `SecurityService::validateLoginCredentials()` processes the input +- **THEN** the validation MUST return `{ valid: false, error: "Username contains invalid characters" }` + +#### Scenario: Prevent excessively long passwords +- **GIVEN** a login attempt with a password exceeding 1000 characters +- **WHEN** `SecurityService::validateLoginCredentials()` processes the input +- **THEN** the validation MUST return `{ valid: false, error: "Password is too long" }` + +## Current Implementation Status +- **Fully implemented:** + - `Consumer` entity (`lib/Db/Consumer.php`) with fields: uuid, name, description, domains (CORS), ips (IP allow-list), authorizationType (none/basic/bearer/apiKey/oauth2/jwt), authorizationConfiguration (JSON with keys, algorithms, secrets), userId (mapped Nextcloud user), created, updated + - `ConsumerMapper` (`lib/Db/ConsumerMapper.php`) for CRUD operations on consumers + - `ConsumersController` (`lib/Controller/ConsumersController.php`) for API consumer management + - `AuthorizationService` (`lib/Service/AuthorizationService.php`) supporting JWT (HMAC HS256/384/512), Basic Auth, OAuth2 Bearer, and API key validation — all methods resolve to a Nextcloud user via `$this->userSession->setUser()` + - `AuthenticationService` (`lib/Service/AuthenticationService.php`) for outbound token generation (OAuth2 client_credentials, OAuth2 password, JWT signing with HS/RS/PS algorithms) + - `SecurityService` (`lib/Service/SecurityService.php`) with APCu-backed rate limiting (5 attempts / 15min window, 1hr lockout), progressive delays (2s-60s), IP and user lockout, XSS sanitization, security headers, and security event logging + - `PermissionHandler` (`lib/Service/Object/PermissionHandler.php`) for schema-level RBAC with admin bypass, owner privileges, public group, conditional matching with `$organisation` variable + - `PropertyRbacHandler` (`lib/Service/PropertyRbacHandler.php`) for property-level RBAC with `canReadProperty()`, `canUpdateProperty()`, `filterReadableProperties()`, `getUnauthorizedProperties()`, conditional rule matching, and admin/public/authenticated pseudo-groups + - `MagicRbacHandler` (`lib/Db/MagicMapper/MagicRbacHandler.php`) for SQL-level RBAC filtering with QueryBuilder integration, raw SQL for UNION queries, dynamic variable resolution ($organisation, $userId, $now), operator conditions ($eq/$ne/$gt/$gte/$lt/$lte/$in/$nin/$exists), and multi-tenancy bypass detection + - `MultiTenancyTrait` (`lib/Db/MultiTenancyTrait.php`) for organisation-level data isolation + - `ConditionMatcher` (`lib/Service/ConditionMatcher.php`) and `OperatorEvaluator` (`lib/Service/OperatorEvaluator.php`) for conditional authorization rule evaluation + - Nextcloud session auth works natively via the Nextcloud AppFramework + - Public endpoint support via `@PublicPage` annotations on ObjectsController (5 public methods) + - CORS enforcement in `AuthorizationService::corsAfterController()` with CSRF protection + - Twig authentication extensions (`lib/Twig/AuthenticationExtension.php`, `lib/Twig/AuthenticationRuntime.php`) for `oauthToken` function in mapping templates + - MCP endpoint uses Nextcloud's standard Basic Auth via the AppFramework controller pattern + +- **Not implemented:** + - Per-consumer rate limiting (configured request limits per consumer with `Retry-After` headers) + - Authentication event auditing to Nextcloud's audit log (via `OCP\Log\ILogFactory`) — currently logged via `LoggerInterface` only + - JWT token auto-generation and one-time display workflow in the consumer creation UI + - Consumer revocation with immediate token invalidation (deleting a consumer works, but active JWT sessions may not be immediately invalidated if cached) + - IP allow-list enforcement in `AuthorizationService` (Consumer stores `ips` field but enforcement is not implemented) + - CORS enforcement per Consumer's `domains` field (currently uses generic origin reflection) + - RSA/PS256 signature verification for inbound JWT tokens (only HMAC verification is implemented; `AuthorizationService::authorizeJwt()` checks HMAC_MAP only) + +- **Partial:** + - Rate limiting exists via `SecurityService` with APCu-backed counters, but is not integrated into the `AuthorizationService` flow for every authentication method + - Public schema access exists via `@PublicPage` endpoints but mixed public/private schema discovery filtering is not explicitly implemented in schema listing endpoints + - Group membership caching relies on Nextcloud's internal caching; no explicit per-request cache in OpenRegister handlers + +## Standards & References +- **OAuth 2.0 (RFC 6749)** — Authorization framework for Consumer entity auth types +- **JWT (RFC 7519)** — JSON Web Token for API consumer authentication +- **JWS (RFC 7515)** — JSON Web Signature for JWT signing/verification +- **SAML 2.0** — Via Nextcloud's `user_saml` app for enterprise SSO +- **OpenID Connect Core 1.0** — Via Nextcloud's `user_oidc` app for OIDC SSO +- **BIO (Baseline Informatiebeveiliging Overheid)** — Dutch government baseline information security requirements for authentication and access control +- **DigiD/eHerkenning** — Dutch government authentication standards (via SAML/OIDC gateway) +- **RFC 6585** — HTTP 429 Too Many Requests for rate limiting +- **OWASP Authentication Cheat Sheet** — Best practices for credential handling, session management, and brute force protection +- **Nextcloud AppFramework annotations** — `@PublicPage`, `@NoCSRFRequired`, `@NoAdminRequired`, `@CORS` +- **Nextcloud OCP interfaces** — `IUserSession`, `IUserManager`, `IGroupManager`, `IAppConfig`, `ICacheFactory`, `ISecureRandom` +- **ZGW Autorisaties API (VNG)** — Dutch government authorization patterns (see cross-reference: `rbac-scopes` spec) + +## Cross-References +- **`rbac-scopes`** — Maps Nextcloud groups to OAuth2 scopes in generated OAS; depends on the same group-based authorization model defined here +- **`rbac-zaaktype`** — Implements schema-level RBAC per zaaktype/objecttype; uses `PermissionHandler` defined here +- **`row-field-level-security`** — Extends the authorization model with row-level and field-level security; uses `MagicRbacHandler` and `PropertyRbacHandler` defined here +- **ADR: Security and Authentication** — Architecture decision record for the security model (not yet created; to be defined at `openspec/architecture/adr-007-security-and-auth.md`) + +## Specificity Assessment +- **Highly specific and largely implemented**: The core multi-auth system, RBAC hierarchy (admin > owner > group > authenticated > public), and three-level authorization (schema, property, row) are fully implemented with clear code references. +- **Well-documented Consumer entity**: The Consumer entity fields, auth types, and resolution flow are clearly specified with implementation details. +- **Code-grounded scenarios**: All scenarios reference specific methods, classes, and behaviors verified against the actual implementation. +- **Missing implementations clearly identified**: IP allow-list enforcement, per-consumer rate limiting, RSA JWT verification, and audit log integration are explicitly marked as not implemented. +- **No open design questions**: The architecture is settled — all auth methods resolve to Nextcloud users, all RBAC uses Nextcloud groups, all layers are composable. diff --git a/openspec/changes/avg-verwerkingsregister/specs/avg-verwerkingsregister/spec.md b/openspec/changes/avg-verwerkingsregister/specs/avg-verwerkingsregister/spec.md new file mode 100644 index 000000000000..711c7e63d4ef --- /dev/null +++ b/openspec/changes/avg-verwerkingsregister/specs/avg-verwerkingsregister/spec.md @@ -0,0 +1,604 @@ +--- +status: draft +--- +# AVG Verwerkingsregister + +## Purpose +Implement GDPR Article 30 processing activity registration integrated with OpenRegister's existing person and organisation entity system. Processing activities link to schemas that contain personal data, and data subject rights (access, rectification, erasure, portability) operate through the existing ObjectService CRUD operations, filtered by the person/organisation identifiers already tracked via the MultiTenancyTrait. The verwerkingsregister itself is modeled as an OpenRegister register and schema — not a separate system — leveraging the same RBAC, audit trail, and multi-tenancy infrastructure used by all other registers. PII detection builds on the existing EntityRecognitionHandler and GdprEntity infrastructure. Retention enforcement integrates with the existing ObjectRetentionHandler and archival metadata. The system MUST maintain a structured register of verwerkingsactiviteiten with mandatory fields (purpose limitation, legal basis, data categories, data subjects, retention periods, security measures, and processor information), enforce purpose-bound access control (doelbinding) on schemas containing personal data, and provide end-to-end workflows for data subject rights including inzageverzoeken (Art 15), rectificatie (Art 16), recht op vergetelheid (Art 17), and dataportabiliteit (Art 20). Additionally, the system MUST support Data Protection Impact Assessments (DPIA, Art 35), automated PII detection and anonymization, consent tracking for processing activities, and structured export of the complete Art 30 register for the Autoriteit Persoonsgegevens (AP). + +**Tender demand**: 58% of analyzed government tenders require AVG processing register capabilities. Cross-referencing with archivering-vernietiging (77%), audit-trail-immutable (56%), and auth-system (67%) shows that GDPR compliance is a prerequisite capability for nearly all Dutch government tender participation. + +## Relationship to Existing Implementation +This spec integrates with and extends multiple existing OpenRegister subsystems: + +- **PII detection (partially implemented)**: `EntityRecognitionHandler` already detects personal data entities using regex, Presidio, OpenAnonymiser, LLM, or hybrid methods. `GdprEntity`/`GdprEntityMapper` already store detected PII with categories and metadata. This spec extends this from detection-only to compliance-driving (linking detected PII to verwerkingsactiviteiten and triggering compliance alerts). +- **Audit trail (partially implemented)**: `AuditTrail` entity already provides immutable hash-chained entries with organisation field and confidentiality level. This spec extends audit entries with `verwerkingsactiviteit_id`, `doelbinding`, and `grondslag` fields for legally required processing evidence. +- **Access logging (partially implemented)**: `SearchTrail`/`SearchTrailMapper` already track access patterns with organisation context. This spec adds purpose-binding context to these logs. +- **Retention management (partially implemented)**: `ObjectRetentionHandler` manages retention configuration, `ObjectEntity.retention` stores archival metadata (archiefnominatie, archiefactiedatum, bewaartermijn). This spec links retention enforcement to verwerkingsactiviteit bewaartermijnen. +- **Organisation/multi-tenancy (fully implemented)**: `MagicMapper` with `MultiTenancyTrait` already enforces organisation-scoped RBAC. The verwerkingsregister inherits this isolation automatically. +- **RBAC (fully implemented)**: `PermissionHandler`, `PropertyRbacHandler`, and `MagicRbacHandler` already control who can access which data. Purpose-binding extends this with "why" in addition to "who". +- **Anonymization (partially implemented)**: `FileTextController::anonymizeDocument()` and DocuDesk anonymization pipeline provide PII replacement patterns that can be leveraged for erasure-by-anonymization. +- **What this spec adds**: Verwerkingsactiviteiten register schema, purpose-bound access control middleware, DataSubjectSearchService for cross-schema BSN search, data subject rights workflows (inzage/rectificatie/vergetelheid/portabiliteit), DPIA tracking, consent management, verwerker registration, and Art 30 register export. + +## ADDED Requirements + +### Requirement: The system MUST maintain a verwerkingsactiviteiten register as an OpenRegister schema +A central register of all processing activities (verwerkingsactiviteiten) MUST be maintained as a dedicated OpenRegister register and schema, conforming to GDPR Article 30(1) for controllers and Article 30(2) for processors. Each processing activity record MUST contain all fields mandated by the Autoriteit Persoonsgegevens model verwerkingsregister and the VNG model verwerkingsregister for gemeenten. + +#### Scenario: Create a processing activity with all Art 30 mandatory fields +- **GIVEN** an administrator or privacy officer (FG/DPO) accesses the verwerkingsregister +- **WHEN** they create a new verwerkingsactiviteit with: + - `naam`: `Behandeling bezwaarschrift` + - `doel` (purpose/doelbinding): `Uitvoering wettelijke taak bezwaarschriftprocedure conform Algemene wet bestuursrecht` + - `grondslag` (legal basis per Art 6): `Wettelijke verplichting (Art 6 lid 1 sub c AVG) — Awb art. 7:1` + - `categorieenBetrokkenen` (data subject categories): `["bezwaarmaker", "belanghebbenden", "gemachtigden"]` + - `categorieenPersoonsgegevens` (personal data categories): `["NAW-gegevens", "BSN", "contactgegevens", "zaakinhoud", "financiele gegevens"]` + - `ontvangers` (recipients): `["behandelend ambtenaar", "bezwaarschriftencommissie", "rechtbank (bij beroep)"]` + - `bewaartermijn` (retention period): `P10Y` (ISO 8601 duration, 10 years after case closure) + - `beveiligingsmaatregelen` (security measures per Art 32): `["versleuteling in rust en transit", "toegangscontrole op basis van rollen", "audit logging", "pseudonimisering waar mogelijk"]` + - `verwerker` (processor): `Eigen organisatie` + - `verwerkersovereenkomst` (processor agreement reference): `null` (own organisation) + - `doorgifte` (transfers to third countries): `Geen doorgifte buiten EER` + - `dpiaVereist` (DPIA required): `false` + - `status`: `actief` +- **THEN** the processing activity MUST be stored as an object in the verwerkingsactiviteiten schema +- **AND** a UUID MUST be generated for cross-referencing from audit trail entries +- **AND** the `created` and `updated` timestamps MUST be set automatically + +#### Scenario: Reject processing activity without mandatory fields +- **GIVEN** an administrator attempts to create a verwerkingsactiviteit +- **WHEN** the `doel`, `grondslag`, or `categorieenBetrokkenen` fields are missing +- **THEN** the system MUST reject the creation with HTTP 400 +- **AND** the response MUST list which mandatory Art 30 fields are missing +- **AND** the error message MUST reference the specific GDPR article (e.g., "Art 30 lid 1 sub b vereist het doel van de verwerking") + +#### Scenario: List all processing activities with filtering +- **GIVEN** 25 verwerkingsactiviteiten exist across multiple organisational units +- **WHEN** a privacy officer queries `GET /api/objects/{register}/{schema}?grondslag=Wettelijke verplichting` +- **THEN** the system MUST return only activities with the matching legal basis +- **AND** results MUST include pagination metadata +- **AND** the query itself MUST NOT be logged as a processing activity on personal data (it queries the register, not personal data) + +#### Scenario: Version processing activity changes +- **GIVEN** verwerkingsactiviteit `Behandeling bezwaarschrift` exists with `bewaartermijn: P10Y` +- **WHEN** the privacy officer updates the retention period to `P7Y` following a new selectielijst +- **THEN** the system MUST create an audit trail entry recording the change via the immutable audit trail (see `audit-trail-immutable` spec) +- **AND** the previous version MUST remain retrievable for compliance evidence +- **AND** the `updated` timestamp MUST reflect the modification date + +#### Scenario: Deactivate a processing activity +- **GIVEN** verwerkingsactiviteit `Papieren correspondentie archivering` is no longer performed +- **WHEN** the privacy officer sets its `status` to `inactief` +- **THEN** the activity MUST remain in the register with status `inactief` (MUST NOT be deleted per Art 30 accountability principle) +- **AND** schemas linked to this activity MUST display a warning that the processing activity is inactive +- **AND** the deactivation MUST be recorded in the audit trail + +### Requirement: Processing activities MUST be linked to schemas containing personal data +Each schema in OpenRegister that contains personal data MUST be linked to one or more verwerkingsactiviteiten, establishing the legal basis and purpose for all operations on objects in that schema. This link enforces the purpose limitation principle (doelbinding) of Art 5(1)(b) AVG. + +#### Scenario: Link a schema to a processing activity +- **GIVEN** schema `inwoners` exists and verwerkingsactiviteit `Basisregistratie Personen (BRP) bijhouding` exists +- **WHEN** the administrator links schema `inwoners` to this verwerkingsactiviteit +- **THEN** the schema's configuration MUST store the verwerkingsactiviteit UUID reference +- **AND** all subsequent CRUD operations on `inwoners` objects MUST be logged with this verwerkingsactiviteit reference in the audit trail +- **AND** the schema MUST be marked as `containsPersonalData: true` + +#### Scenario: Schema linked to multiple processing activities +- **GIVEN** schema `klantcontacten` is linked to both `Klachtenafhandeling` and `Dienstverlening front-office` +- **WHEN** a user accesses a klantcontact object +- **THEN** the user's role MUST be associated with at least one of the linked verwerkingsactiviteiten +- **AND** the audit trail entry MUST record which specific verwerkingsactiviteit justified the access + +#### Scenario: Warn on schema without processing activity link +- **GIVEN** schema `sollicitanten` is marked as `containsPersonalData: true` +- **AND** no verwerkingsactiviteit is linked to it +- **WHEN** the admin views the schema configuration +- **THEN** the system MUST display a compliance warning: "Schema bevat persoonsgegevens maar heeft geen gekoppelde verwerkingsactiviteit (Art 30 AVG)" +- **AND** data access MUST still be permitted (warning, not blocking) to avoid disrupting operations + +#### Scenario: Automatic PII detection suggests schema should be marked as personal data +- **GIVEN** schema `projecten` is NOT marked as containing personal data +- **AND** the `EntityRecognitionHandler` detects PII entities (names, emails, BSNs) in objects within this schema +- **WHEN** the PII detection confidence exceeds the configured threshold +- **THEN** the system MUST generate a notification to the privacy officer: "Schema 'projecten' bevat mogelijk persoonsgegevens — overweeg koppeling aan verwerkingsactiviteit" +- **AND** the detected entity types and counts MUST be included in the notification + +### Requirement: All access to personal data MUST be logged with processing purpose +Every read, write, update, or delete operation on objects in schemas marked as containing personal data MUST produce an immutable processing log entry that records the verwerkingsactiviteit, the user, the action, and the timestamp. This implements the accountability principle (verantwoordingsplicht) of Art 5(2) AVG and aligns with the VNG Verwerkingenlogging API standard. + +#### Scenario: Log data access with verwerkingsactiviteit reference +- **GIVEN** schema `inwoners` is marked as containing personal data +- **AND** it is linked to verwerkingsactiviteit `Uitvoering Wmo-aanvraag` +- **WHEN** user `medewerker-1` reads object `inwoner-123` +- **THEN** a processing log entry MUST be created in the immutable audit trail with: + - `timestamp`: server-side UTC timestamp + - `user`: `medewerker-1` + - `action`: `read` + - `objectUuid`: UUID of `inwoner-123` + - `schemaUuid`: UUID of `inwoners` schema + - `verwerkingsactiviteitId`: UUID of `Uitvoering Wmo-aanvraag` + - `doelbinding`: the purpose text from the linked activity + - `vertrouwelijkheid`: the confidentiality level of the accessed object +- **AND** the log entry MUST be hash-chained per the `audit-trail-immutable` spec + +#### Scenario: Log bulk data operations +- **GIVEN** an API consumer performs a list query on schema `inwoners` returning 50 objects +- **WHEN** the query is executed +- **THEN** a single processing log entry MUST be created recording the bulk access +- **AND** the entry MUST include `objectCount: 50` and the query parameters used +- **AND** individual object UUIDs MUST be recorded if the result set is 100 or fewer objects + +#### Scenario: Reject access without valid processing purpose (purpose-bound access control) +- **GIVEN** schema `inwoners` has `requirePurposeBinding: true` enabled +- **AND** user `medewerker-2` has no role linked to any verwerkingsactiviteit for `inwoners` +- **WHEN** `medewerker-2` attempts to read `inwoner-123` +- **THEN** the system MUST return HTTP 403 with body containing: `{"error": "Geen geldige verwerkingsgrondslag voor toegang tot schema 'inwoners'"}` +- **AND** the denied access attempt MUST be logged in the audit trail with action `access_denied_no_purpose` + +#### Scenario: Purpose binding enforced across all access methods +- **GIVEN** schema `zaken-sociaal-domein` has `requirePurposeBinding: true` +- **WHEN** access is attempted via REST API, GraphQL, MCP, or public endpoints +- **THEN** the `PurposeBindingMiddleware` MUST intercept all access methods consistently +- **AND** the enforcement MUST occur before any data is returned to the caller + +#### Scenario: Logging aligns with VNG Verwerkingenlogging API standard +- **GIVEN** the municipality uses the VNG Verwerkingenlogging API standard for cross-system logging +- **WHEN** processing log entries are created +- **THEN** the entries MUST be exportable in the VNG Verwerkingenlogging format including: + - `actie_id` (action identifier), `verwerking_id` (processing ID), `verwerkingsactiviteit_id` + - `vertrouwelijkheid` (confidentiality), `bewaartermijn` (retention) + - `tijdstip`, `tijdstip_registratie`, `verwerkende_organisatie` +- **AND** a REST endpoint `GET /api/verwerkingslog/export` MUST provide this format + +### Requirement: The system MUST support data subject access requests (inzageverzoek, Art 15 AVG) +A data subject MUST be able to request a complete overview of all personal data stored about them and all processing activities involving their data. The system MUST respond within the legally mandated period of one month (Art 12(3) AVG) and support identification via BSN, email, or other configured identifiers. + +#### Scenario: Generate data subject access report by BSN +- **GIVEN** person with BSN `123456789` has data in schemas `inwoners`, `bezwaarschriften`, and `meldingen` +- **WHEN** an authorized user (privacy officer or the data subject via a verified portal) initiates a data subject access request for BSN `123456789` +- **THEN** the `DataSubjectSearchService` MUST search all schemas marked as `containsPersonalData: true` +- **AND** the search MUST check all string-type properties in each schema for BSN matches +- **AND** the system MUST return a report listing: + - All objects containing references to BSN `123456789`, grouped by schema + - The verwerkingsactiviteit and doelbinding for each schema + - All processing log entries for those objects (who accessed what, when, why) + - Retention periods and calculated deletion dates per object + - Any third-party recipients (ontvangers) the data has been shared with + +#### Scenario: Cross-schema search with performance safeguards +- **GIVEN** OpenRegister contains 15 schemas marked as containing personal data with a combined 500,000 objects +- **WHEN** a data subject access request is initiated for BSN `987654321` +- **THEN** the search MUST use database indexes on BSN fields where available +- **AND** the search MUST complete within 30 seconds for initial results +- **AND** if full results require longer, the system MUST return a task ID for asynchronous retrieval +- **AND** the data subject MUST be notified (via Nextcloud notification) when the report is ready + +#### Scenario: Export access report as PDF and machine-readable format +- **GIVEN** a data subject access report has been generated for BSN `123456789` +- **WHEN** the user exports the report +- **THEN** the system MUST generate both: + - A PDF document using DocuDesk PDF generation (if available), containing all processing details in human-readable Dutch + - A JSON export conforming to the GDPR data portability format +- **AND** the export itself MUST be logged as a processing activity with doelbinding `Inzageverzoek betrokkene Art 15 AVG` +- **AND** the PDF MUST include the organisation name, date of generation, and privacy officer contact details + +#### Scenario: Track inzageverzoek deadline compliance +- **GIVEN** a data subject access request was filed on 2026-01-15 +- **WHEN** the one-month deadline of 2026-02-15 approaches +- **THEN** the system MUST send a reminder notification to the privacy officer 7 days before the deadline +- **AND** if the deadline passes without the request being marked as fulfilled, the system MUST escalate the notification +- **AND** the request status, filing date, and completion date MUST be tracked in the verwerkingsregister + +### Requirement: The system MUST support the right to rectification (recht op rectificatie, Art 16 AVG) +Data subjects MUST be able to request correction of inaccurate personal data. The system MUST support a structured rectification workflow with before/after evidence. + +#### Scenario: Process a rectification request +- **GIVEN** data subject with BSN `123456789` reports that their address in schema `inwoners` is incorrect +- **WHEN** an authorized user processes the rectification request +- **THEN** the system MUST update the address field on the matching object +- **AND** the audit trail MUST record the change with: + - `action`: `rectification` + - `grondslag`: `Art 16 AVG — recht op rectificatie` + - `changed`: the old and new values + - `requestReference`: the rectification request identifier +- **AND** the data subject MUST be notified that the rectification is complete + +#### Scenario: Rectification propagation to linked systems +- **GIVEN** the rectified data in schema `inwoners` is referenced by objects in schemas `bezwaarschriften` and `meldingen` (via `$ref` or BSN lookup) +- **WHEN** the rectification is processed +- **THEN** the system MUST identify all objects referencing the corrected data +- **AND** generate a report listing which related objects may need updating +- **AND** the privacy officer MUST be notified of potential cascade rectification needs + +#### Scenario: Reject rectification of factual records +- **GIVEN** a data subject requests rectification of a medical assessment conclusion in schema `keuringen` +- **WHEN** the assessment is a professional judgment, not a factual data error +- **THEN** the system MUST allow the privacy officer to reject the rectification with reason +- **AND** record the rejection with the legal basis in the audit trail +- **AND** allow the data subject's objection statement to be attached to the record + +### Requirement: The system MUST support the right to erasure (recht op vergetelheid, Art 17 AVG) +Data subjects MUST be able to request deletion of their personal data, subject to legal retention obligations. The system MUST evaluate each object against its retention schedule and legal basis before erasure, and provide anonymization as an alternative where full deletion conflicts with archival obligations. + +#### Scenario: Process erasure request with no retention conflict +- **GIVEN** person with BSN `123456789` requests erasure +- **AND** objects referencing this BSN in schema `meldingen` have no legal retention requirement or the retention period has expired +- **WHEN** the erasure request is processed +- **THEN** all objects in `meldingen` referencing BSN `123456789` MUST be deleted or anonymized +- **AND** an immutable audit trail entry MUST record the erasure with: + - `action`: `erasure` + - `grondslag`: `Art 17 AVG — recht op vergetelheid` + - `objectCount`: number of objects affected + - `method`: `deletion` or `anonymization` + +#### Scenario: Process erasure request with retention conflict (Archiefwet) +- **GIVEN** person with BSN `123456789` requests erasure +- **AND** objects in schema `bezwaarschriften` have a 10-year legal retention period under Archiefwet/selectielijst that has not yet expired +- **WHEN** the erasure request is evaluated +- **THEN** the system MUST flag these objects as retention-blocked +- **AND** the report MUST explain which legal basis prevents erasure: "Archiefwet 1995 — selectielijst categorie 1.1, bewaartermijn tot [date]" +- **AND** processing of the retained data MUST be restricted to the archival purpose only (opslagbeperking) +- **AND** the data subject MUST be informed of the retention reason and expected deletion date + +#### Scenario: Anonymization as alternative to deletion +- **GIVEN** an erasure request targets objects that must be retained for statistical purposes but no longer require identification +- **WHEN** the privacy officer chooses anonymization over deletion +- **THEN** the system MUST replace all PII fields (detected via `EntityRecognitionHandler` or manually marked) with anonymized placeholders +- **AND** the anonymized object MUST remain in the register for statistical/archival purposes +- **AND** the anonymization MUST be irreversible (no mapping table retained) +- **AND** the audit trail MUST record which fields were anonymized + +#### Scenario: Erasure propagation to third-party processors +- **GIVEN** the verwerkingsactiviteit for the erased data lists a third-party verwerker `Extern ICT-bedrijf` +- **WHEN** the erasure is completed in OpenRegister +- **THEN** the system MUST generate a notification to the privacy officer listing third parties that must be informed of the erasure per Art 17(2) AVG +- **AND** the notification MUST include the verwerker name, contact details from the verwerkersovereenkomst, and the specific data that was erased + +### Requirement: The system MUST support the right to data portability (recht op dataportabiliteit, Art 20 AVG) +Data subjects MUST be able to receive their personal data in a structured, commonly used, and machine-readable format, and have the right to transmit that data to another controller. + +#### Scenario: Export personal data in machine-readable format +- **GIVEN** person with BSN `123456789` requests data portability +- **WHEN** the export is generated +- **THEN** the system MUST produce a JSON file containing all personal data across all schemas +- **AND** the JSON MUST use a standardized structure with schema names as keys and object arrays as values +- **AND** only data processed on the basis of consent (Art 6(1)(a)) or contract (Art 6(1)(b)) MUST be included (not data processed under legal obligation) +- **AND** the export MUST be downloadable as a ZIP archive + +#### Scenario: Direct transfer to another controller +- **GIVEN** a data portability export has been generated +- **WHEN** the data subject requests transfer to another controller's system +- **THEN** the system MUST support export via API (POST to a specified endpoint) where technically feasible +- **AND** the transfer MUST be logged in the audit trail with the receiving controller's identity + +#### Scenario: Exclude derived and aggregated data from portability export +- **GIVEN** schema `risicoprofielen` contains algorithmically derived risk scores based on the data subject's personal data +- **WHEN** a data portability request is processed +- **THEN** the derived risk scores MUST NOT be included in the export (Art 20 applies to data "provided by" the data subject) +- **AND** the export report MUST note which schemas were excluded and why + +### Requirement: The system MUST support Data Protection Impact Assessments (DPIA, Art 35 AVG) +For processing activities that pose a high risk to data subjects' rights and freedoms, the system MUST support DPIA documentation, track DPIA status per verwerkingsactiviteit, and enforce DPIA completion before processing begins when required by Art 35 criteria or the AP's DPIA-verplichtingenlijst. + +#### Scenario: Flag processing activity as DPIA-required +- **GIVEN** verwerkingsactiviteit `Geautomatiseerde besluitvorming bijstandsaanvragen` involves automated decision-making (Art 22) and processes special category data (Art 9) +- **WHEN** the privacy officer evaluates the activity +- **THEN** the system MUST flag `dpiaVereist: true` based on Art 35(3) criteria +- **AND** the system MUST prevent the verwerkingsactiviteit status from being set to `actief` until a DPIA is completed and linked + +#### Scenario: Document DPIA within the verwerkingsregister +- **GIVEN** verwerkingsactiviteit `Cameratoezicht openbare ruimte` requires a DPIA +- **WHEN** the privacy officer completes the DPIA +- **THEN** the DPIA record MUST be stored as a linked object containing: + - `beschrijving`: systematic description of processing operations + - `noodzakelijkheid`: assessment of necessity and proportionality + - `risicobeoordeling`: risk assessment for data subjects + - `maatregelen`: planned mitigating measures + - `adviesFG`: DPO advice and whether it was followed + - `consultatieDatum`: date of AP consultation (if applicable, per Art 36) + - `status`: `concept`, `afgerond`, `herzien_nodig` +- **AND** the DPIA MUST be linked to the verwerkingsactiviteit + +#### Scenario: DPIA review trigger on significant change +- **GIVEN** verwerkingsactiviteit `Fraudedetectie` has a completed DPIA +- **WHEN** the data categories are expanded to include `strafrechtelijke gegevens` (Art 10 AVG) +- **THEN** the system MUST set the DPIA status to `herzien_nodig` +- **AND** notify the privacy officer that the DPIA must be reviewed due to a material change +- **AND** the verwerkingsactiviteit MUST display a warning until the DPIA review is completed + +### Requirement: The system MUST track consent as a legal basis for processing (Art 6(1)(a) and Art 7 AVG) +When processing is based on consent, the system MUST record, manage, and prove consent per data subject, per processing purpose, with the ability to withdraw consent at any time. + +#### Scenario: Record consent for a specific processing activity +- **GIVEN** verwerkingsactiviteit `Nieuwsbriefverzending` has `grondslag: Toestemming (Art 6 lid 1 sub a AVG)` +- **WHEN** data subject with BSN `123456789` gives consent via an intake form +- **THEN** a consent record MUST be created linking: + - `betrokkene`: BSN `123456789` + - `verwerkingsactiviteitId`: UUID of `Nieuwsbriefverzending` + - `consentDatum`: timestamp of consent + - `consentMethode`: `digitaal formulier` (with reference to the form submission) + - `status`: `verleend` +- **AND** the consent record MUST be stored in a dedicated consent schema + +#### Scenario: Withdraw consent and cease processing +- **GIVEN** data subject with BSN `123456789` withdraws consent for `Nieuwsbriefverzending` +- **WHEN** the withdrawal is processed +- **THEN** the consent record status MUST be updated to `ingetrokken` with the withdrawal timestamp +- **AND** all future processing under this verwerkingsactiviteit for this data subject MUST be blocked +- **AND** existing data processed under the withdrawn consent MUST be evaluated for deletion (unless another legal basis applies) +- **AND** the withdrawal MUST be as easy as giving consent (Art 7(3) AVG) + +#### Scenario: Prove consent for AP audit +- **GIVEN** the Autoriteit Persoonsgegevens requests proof of consent for verwerkingsactiviteit `Klanttevredenheidsonderzoek` +- **WHEN** the privacy officer queries consent records for this activity +- **THEN** the system MUST return all consent records with: + - Who consented (betrokkene identifier) + - When they consented (timestamp) + - What they consented to (verwerkingsactiviteit details) + - How consent was obtained (methode and evidence) + - Current status (verleend/ingetrokken) +- **AND** the consent records MUST be immutable (withdrawal creates a new record, does not modify the original) + +### Requirement: Third-party processors (verwerkers) MUST be registered with verwerkersovereenkomst tracking +All third parties that process personal data on behalf of the organisation MUST be registered in the verwerkingsregister with their processor agreement details, conforming to Art 28 AVG. + +#### Scenario: Register a third-party processor +- **GIVEN** the organisation uses `CloudHosting B.V.` for document storage +- **WHEN** the privacy officer registers the processor +- **THEN** the verwerker record MUST include: + - `naam`: `CloudHosting B.V.` + - `kvkNummer`: `12345678` + - `contactpersoon`: `privacy@cloudhosting.nl` + - `verwerkersovereenkomstDatum`: `2025-03-01` + - `verwerkersovereenkomstVerloopt`: `2027-03-01` + - `subverwerkers`: `["AWS EU-West", "Backup B.V."]` + - `doorgifteDetails`: `Servers in EU, geen doorgifte buiten EER` + - `beveiligingsCertificering`: `ISO 27001, SOC 2 Type II` + +#### Scenario: Alert on expiring processor agreement +- **GIVEN** verwerker `CloudHosting B.V.` has a verwerkersovereenkomst expiring on `2027-03-01` +- **WHEN** the current date is within 90 days of expiration +- **THEN** the system MUST send a notification to the privacy officer +- **AND** the verwerker record MUST display a warning indicator in the UI + +#### Scenario: Link processor to processing activities +- **GIVEN** verwerker `CloudHosting B.V.` is registered +- **WHEN** verwerkingsactiviteit `Documentopslag en -verwerking` lists this verwerker +- **THEN** the Art 30 export MUST include the processor details alongside the processing activity +- **AND** if the processor is deactivated, all linked verwerkingsactiviteiten MUST display a compliance warning + +### Requirement: The Art 30 register MUST be exportable for the Autoriteit Persoonsgegevens +The complete verwerkingsregister MUST be exportable in formats suitable for AP supervision, internal audit, and FG/DPO reporting. The export MUST conform to the VNG model verwerkingsregister template structure. + +#### Scenario: Export complete Art 30 register as structured document +- **GIVEN** 25 verwerkingsactiviteiten are defined with linked schemas, verwerkers, and DPIAs +- **WHEN** the privacy officer triggers `GET /api/verwerkingsregister/export?format=pdf` +- **THEN** the system MUST generate a PDF document (via DocuDesk if available) listing all activities with: + - Naam, doel (doelbinding), grondslag, categorieën persoonsgegevens, categorieën betrokkenen + - Ontvangers, bewaartermijn, beveiligingsmaatregelen, verwerkerinformatie + - DPIA status per activity, doorgifte details + - Date of generation, organisation name, FG/DPO contact details +- **AND** the format MUST follow the VNG model verwerkingsregister structure + +#### Scenario: Export as machine-readable JSON +- **GIVEN** the privacy officer requests `GET /api/verwerkingsregister/export?format=json` +- **THEN** the system MUST return a JSON document conforming to a documented JSON Schema +- **AND** each verwerkingsactiviteit MUST include all Art 30 mandatory fields plus linked schema UUIDs +- **AND** the JSON MUST be importable back into OpenRegister for migration or backup purposes + +#### Scenario: Export as CSV for spreadsheet analysis +- **GIVEN** the privacy officer requests `GET /api/verwerkingsregister/export?format=csv` +- **THEN** the system MUST return a CSV file with one row per verwerkingsactiviteit +- **AND** multi-value fields (categorieën, ontvangers) MUST be semicolon-separated within their columns +- **AND** the CSV MUST use UTF-8 encoding with BOM for Excel compatibility + +#### Scenario: Incremental export since last AP report +- **GIVEN** the previous AP export was generated on 2025-06-01 +- **WHEN** the privacy officer requests an incremental export with `?since=2025-06-01` +- **THEN** the export MUST include only verwerkingsactiviteiten that were created or modified after that date +- **AND** the export MUST clearly mark which activities are new vs. modified + +### Requirement: Automated PII detection MUST flag unregistered personal data processing +The system MUST leverage the existing `EntityRecognitionHandler` and `GdprEntity` infrastructure to automatically detect personal data in schemas not yet marked as containing personal data, and generate compliance alerts. + +#### Scenario: Scheduled PII scan across all schemas +- **GIVEN** the administrator has configured a weekly PII detection scan +- **WHEN** the scan runs across all schemas +- **THEN** the `EntityRecognitionHandler` MUST analyze a sample of objects from each schema (configurable sample size, default 100 objects) +- **AND** for each schema where PII is detected but `containsPersonalData` is `false`, a compliance alert MUST be generated +- **AND** the alert MUST include: schema name, detected entity types (BSN, email, phone, name, address, IBAN), confidence scores, and sample count + +#### Scenario: Real-time PII detection on object creation +- **GIVEN** schema `projectnotities` is NOT marked as containing personal data +- **WHEN** a new object is created containing text `Overleg met Jan de Vries (BSN 123456789) over zijn WMO-aanvraag` +- **THEN** the `EntityRecognitionHandler` MUST detect PII entities: `PERSON: Jan de Vries`, `BSN: 123456789` +- **AND** the detected entities MUST be stored as `GdprEntity` records linked to the object +- **AND** a notification MUST be sent to the privacy officer suggesting the schema be linked to a verwerkingsactiviteit + +#### Scenario: PII detection respects detection method configuration +- **GIVEN** the file settings configure `entityRecognitionMethod: hybrid` (combining regex + OpenAnonymiser) +- **WHEN** PII detection runs +- **THEN** both regex patterns (fast, local) and the OpenAnonymiser API (Dutch-focused, higher accuracy) MUST be used +- **AND** results MUST be deduplicated across methods +- **AND** the detection method MUST be recorded on each `GdprEntity` record for audit purposes + +### Requirement: Retention enforcement MUST automatically trigger deletion or anonymization +When an object's retention period expires and its archivering status permits destruction, the system MUST automatically initiate deletion or anonymization workflows, integrating with the `archivering-vernietiging` spec's retention infrastructure. + +#### Scenario: Automatic deletion on retention expiry +- **GIVEN** objects in schema `meldingen` have `bewaartermijn: P5Y` configured via the linked verwerkingsactiviteit +- **AND** object `melding-001` was created on 2020-01-15 and has `archiefnominatie: vernietigen` +- **WHEN** the retention enforcement job runs after 2025-01-15 +- **THEN** the system MUST queue `melding-001` for destruction per the `archivering-vernietiging` spec's multi-step approval workflow +- **AND** if auto-approval is configured, the object MUST be deleted with an audit trail entry recording the legal basis + +#### Scenario: Retention conflict between AVG and Archiefwet +- **GIVEN** verwerkingsactiviteit specifies `bewaartermijn: P2Y` for data minimization +- **AND** the schema's archival configuration specifies `bewaartermijn: P10Y` per selectielijst +- **WHEN** the 2-year AVG retention expires +- **THEN** the system MUST NOT delete the object (Archiefwet takes precedence) +- **AND** the system MUST restrict processing to archival purposes only +- **AND** the object MUST be flagged as `avgRetentionExpired: true, archiefRetentionActive: true` +- **AND** access MUST be limited to users with archival roles + +#### Scenario: Pseudonymization on partial retention expiry +- **GIVEN** verwerkingsactiviteit `Statistisch onderzoek` requires data retention for 20 years but PII retention for only 2 years +- **WHEN** the PII retention period expires +- **THEN** the system MUST pseudonymize identifying fields while retaining non-identifying data +- **AND** the pseudonymization mapping MUST be stored separately with its own shorter retention period +- **AND** the audit trail MUST record the pseudonymization event + +### Requirement: Multi-tenant privacy isolation MUST prevent cross-organisation data access +In multi-tenant deployments, personal data and the verwerkingsregister MUST be strictly isolated between organisations. One organisation's privacy officer MUST NOT be able to access another organisation's processing register or personal data. + +#### Scenario: Organisation-scoped verwerkingsregister +- **GIVEN** organisations `Gemeente Utrecht` and `Gemeente Amersfoort` share an OpenRegister instance +- **WHEN** the privacy officer of `Gemeente Utrecht` queries the verwerkingsregister +- **THEN** only verwerkingsactiviteiten belonging to `Gemeente Utrecht` MUST be returned +- **AND** the MagicMapper's organisation filter (existing RBAC) MUST enforce this isolation at the query level +- **AND** cross-organisation data access attempts MUST be logged as security events + +#### Scenario: Data subject request scoped to organisation +- **GIVEN** person with BSN `123456789` has data in both `Gemeente Utrecht` and `Gemeente Amersfoort` +- **WHEN** `Gemeente Utrecht` processes a data subject access request +- **THEN** the report MUST only include data within `Gemeente Utrecht`'s schemas +- **AND** the system MUST NOT reveal that the data subject also has data in another organisation's schemas + +#### Scenario: Art 30 export scoped to organisation +- **GIVEN** the AP requests the verwerkingsregister from `Gemeente Amersfoort` +- **WHEN** the export is generated +- **THEN** the export MUST contain only `Gemeente Amersfoort`'s processing activities +- **AND** no data, schema references, or processor information from other organisations MUST be included + +### Requirement: An audit trail specifically for privacy operations MUST be maintained +All privacy-specific operations (data subject requests, consent changes, DPIA actions, erasure operations) MUST be tracked in a dedicated privacy audit trail that is separate from the general object audit trail, ensuring privacy operations cannot be obscured in high-volume general logs. + +#### Scenario: Privacy operation creates dedicated audit entry +- **GIVEN** a data subject access request is filed for BSN `123456789` +- **WHEN** the request is processed and completed +- **THEN** the privacy audit trail MUST contain entries for: + - `inzageverzoek_ontvangen`: filing date, data subject identifier, requesting channel + - `inzageverzoek_verwerkt`: search scope, schemas searched, objects found + - `inzageverzoek_afgerond`: completion date, report generated, delivery method +- **AND** each entry MUST include the processing officer's identity and timestamp + +#### Scenario: Privacy audit trail is immutable and exportable +- **GIVEN** 200 privacy operations have been recorded over the past year +- **WHEN** the privacy officer exports the privacy audit trail +- **THEN** the export MUST include all operations with timestamps, actors, and outcomes +- **AND** the entries MUST be hash-chained (per `audit-trail-immutable` spec) for tamper evidence +- **AND** the export MUST be available in both PDF and JSON formats + +#### Scenario: Privacy audit trail retention +- **GIVEN** privacy audit trail entries exist +- **WHEN** the retention period for the general audit trail expires +- **THEN** privacy audit trail entries MUST be retained for at least the accountability period (typically the statute of limitations for AP enforcement, 5 years under UAVG) +- **AND** privacy audit trail entries MUST NOT be automatically deleted with general audit trail cleanup + +## Current Implementation Status +- **Partial foundations:** + - `GdprEntity` (`lib/Db/GdprEntity.php`) exists with fields: uuid, type, value, category, belongsToEntityId, metadata, owner, organisation, detectedAt, updatedAt — represents detected personal data entities with categories `pii` and `sensitive_pii` + - `GdprEntityMapper` (`lib/Db/GdprEntityMapper.php`) provides CRUD operations for GDPR entities stored in `openregister_entities` table + - `GdprEntitiesController` (`lib/Controller/GdprEntitiesController.php`) exposes API endpoints for managing GDPR entities (list, get, types, categories, stats, delete) + - `EntityRecognitionHandler` (`lib/Service/TextExtraction/EntityRecognitionHandler.php`) detects personal data entities in text using regex, Presidio, OpenAnonymiser, LLM, or hybrid methods — supports `CATEGORY_PERSONAL_DATA` and `CATEGORY_SENSITIVE_PII` + - `SearchTrail` entity (`lib/Db/SearchTrail.php`) and `SearchTrailMapper` track access patterns with organisation context + - `AuditTrail` (`lib/Db/AuditTrail.php`) supports hash-chained immutable entries with organisation field + - `ObjectRetentionHandler` (`lib/Service/Settings/ObjectRetentionHandler.php`) manages retention configuration + - `ObjectEntity.retention` field stores archival metadata (archiefnominatie, archiefactiedatum, bewaartermijn) + - `MagicMapper` already prevents PII exposure for unauthenticated users and enforces organisation-scoped RBAC + - `FileTextController::anonymizeDocument()` creates anonymized copies with PII replaced by placeholders + - DocuDesk `consent-management` spec provides GDPR consent tracking for publication (WOO context) + - DocuDesk `anonymization` spec provides a full anonymization pipeline with PII detection and replacement +- **NOT implemented:** + - Verwerkingsactiviteiten register — no entity/schema for defining processing activities with Art 30 mandatory fields + - Purpose-bound access control (doelbinding) — no `PurposeBindingMiddleware` or mechanism to require/validate processing purpose before data access + - Schema-to-verwerkingsactiviteit linking — schemas have no `verwerkingsactiviteitId` or `containsPersonalData` configuration + - Data subject access request (inzageverzoek) workflow — no `DataSubjectSearchService` for cross-schema BSN search + - Right to rectification workflow — no structured rectification request handling + - Right to erasure (recht op vergetelheid) workflow — no `ErasureRequestHandler` with retention conflict detection + - Right to data portability — no personal data export per data subject + - DPIA documentation and tracking — no DPIA entity or linking to verwerkingsactiviteiten + - Consent tracking per processing activity — consent management exists in DocuDesk but only for WOO publication, not for general processing consent + - Third-party processor (verwerker) registration — no verwerker entity or verwerkersovereenkomst tracking + - Art 30 register export — no structured export endpoint + - VNG Verwerkingenlogging API compliance — processing log entries do not include verwerkingsactiviteit references + - Privacy-specific audit trail — no separation between general and privacy audit entries + - Automated retention enforcement linked to verwerkingsactiviteit bewaartermijn +- **Partial:** + - GdprEntity tracks detected personal data but does not implement the full processing register + - AuditTrail provides immutable logging but not with purpose/legal basis/verwerkingsactiviteit context + - SearchTrail provides access logging but not with doelbinding + - MagicMapper enforces organisation isolation but not purpose-binding + - DocuDesk anonymization pipeline can be leveraged for erasure-by-anonymization + +## Standards & References +- **GDPR (AVG) Article 5** — Principles: lawfulness, purpose limitation (doelbinding), data minimization, accuracy, storage limitation, integrity, accountability +- **GDPR (AVG) Article 6** — Lawfulness of processing (legal bases: consent, contract, legal obligation, vital interests, public task, legitimate interest) +- **GDPR (AVG) Article 7** — Conditions for consent +- **GDPR (AVG) Article 9** — Special categories of personal data (bijzondere persoonsgegevens) +- **GDPR (AVG) Article 10** — Processing of criminal conviction data (strafrechtelijke gegevens) +- **GDPR (AVG) Article 12-14** — Transparency and information obligations +- **GDPR (AVG) Article 15** — Right of access (inzageverzoek) +- **GDPR (AVG) Article 16** — Right to rectification +- **GDPR (AVG) Article 17** — Right to erasure (recht op vergetelheid) +- **GDPR (AVG) Article 18** — Right to restriction of processing (opslagbeperking) +- **GDPR (AVG) Article 20** — Right to data portability +- **GDPR (AVG) Article 22** — Automated individual decision-making +- **GDPR (AVG) Article 25** — Data protection by design and by default +- **GDPR (AVG) Article 28** — Processor requirements (verwerkersovereenkomst) +- **GDPR (AVG) Article 30** — Records of processing activities (verwerkingsregister) +- **GDPR (AVG) Article 32** — Security of processing (beveiligingsmaatregelen) +- **GDPR (AVG) Article 35** — Data Protection Impact Assessment (DPIA/GEB) +- **GDPR (AVG) Article 36** — Prior consultation with supervisory authority +- **Uitvoeringswet AVG (UAVG)** — Dutch GDPR implementation act +- **Autoriteit Persoonsgegevens guidelines** — Dutch DPA model verwerkingsregister and DPIA-verplichtingenlijst +- **VNG Model Verwerkingsregister** — Template for municipal processing registers +- **VNG Verwerkingenlogging API** — Standard API for processing activity logging in Dutch government (v1.0) +- **BIO (Baseline Informatiebeveiliging Overheid)** — Information security baseline, personal data protection requirements +- **Archiefwet 1995** — Archival law governing retention that may override AVG deletion rights +- **Selectielijsten** — Category-based retention schedules that interact with AVG bewaartermijnen + +## Cross-References +- **`archivering-vernietiging`** — Retention schedules, destruction workflows, and legal holds that interact with AVG bewaartermijnen and recht op vergetelheid. Archiefwet retention may override AVG deletion rights. +- **`audit-trail-immutable`** — Foundation for tamper-evident logging of all processing activities. Processing log entries MUST extend audit trail entries with verwerkingsactiviteit references. +- **`auth-system`** — Consumer entities, RBAC, and identity resolution that determine who can access personal data and which verwerkingsactiviteit justifies the access. Purpose-binding middleware integrates with the auth middleware chain. +- **`row-field-level-security`** — Field-level security can enforce PII field visibility rules, complementing purpose-bound access control. +- **`deletion-audit-trail`** — Records of deleted objects provide evidence for erasure request compliance. +- **`content-versioning`** — Version history must be considered in data subject access requests and erasure (all versions must be included/erased). +- **DocuDesk `anonymization`** — Provides the anonymization pipeline (PII detection + replacement) that can be leveraged for erasure-by-anonymization. +- **DocuDesk `consent-management`** — Provides consent tracking patterns (for WOO publication) that can inform the general processing consent model. + +## Nextcloud Integration Analysis + +**Status**: Not yet implemented as a formal processing register. `GdprEntity` exists for PII detection and `SearchTrail` tracks access patterns, but no processing activities register, purpose-bound access control, data subject access requests, or Art 30 export exist. + +**Nextcloud Core Interfaces**: +- `INotifier` / `INotification`: Send notifications for data subject access requests (inzageverzoeken) — notify the privacy officer when a request is filed, notify when the deadline approaches, and notify the requester when the report is ready. Also notify when retention periods trigger erasure eligibility, verwerkersovereenkomsten approach expiration, and DPIA reviews are needed. +- `IEventDispatcher`: Fire `PersonalDataAccessedEvent` on every read/write to schemas marked as containing personal data. This event carries the user, object UUID, action type, linked verwerkingsactiviteit, and doelbinding. Listeners log these events to the processing log. Fire `DataSubjectRequestEvent` for inzageverzoek/rectificatie/vergetelheid workflows. Fire `ConsentChangedEvent` when consent is granted or withdrawn. +- `Middleware`: Implement a `PurposeBindingMiddleware` that intercepts requests to schemas flagged as containing personal data with `requirePurposeBinding: true`. The middleware checks whether the requesting user's role is linked to a valid verwerkingsactiviteit for the target schema. If no valid purpose exists, return HTTP 403. +- `AuditTrail` (OpenRegister's `AuditTrailMapper`): Extend audit trail entries to include `verwerkingsactiviteit_id`, `doelbinding`, and `grondslag` fields, providing the legally required processing evidence for GDPR Art 30 and Art 5(2) accountability. +- `IJobList` / `TimedJob`: Schedule automated retention enforcement, DPIA review reminders, verwerkersovereenkomst expiration checks, and periodic PII detection scans as Nextcloud background jobs. + +**Implementation Approach**: +- Model verwerkingsactiviteiten as a dedicated OpenRegister register and schema. Each processing activity object stores all Art 30 mandatory fields. This register IS the Art 30 register — querying it produces the Art 30 overview. Use a pre-installed register (similar to DocuDesk's consent register pattern) created via a repair step. +- Model verwerkers (processors) as a separate schema in the same register, linked to verwerkingsactiviteiten via object references. +- Model DPIA records as a third schema in the register, linked to verwerkingsactiviteiten. +- Model consent records as a fourth schema, linking data subjects to verwerkingsactiviteiten with consent lifecycle tracking. +- Link processing activities to data schemas via a `privacy` configuration property on the Schema entity containing: `containsPersonalData`, `verwerkingsactiviteitIds[]`, `requirePurposeBinding`, `piiFields[]`. +- For data subject access requests, implement a `DataSubjectSearchService` that queries all schemas where `containsPersonalData: true`, searching for objects matching a BSN or other personal identifier across all string-type properties. Use existing search infrastructure (Solr/Elasticsearch if configured) for performance. +- For the right to erasure, implement an `ErasureRequestHandler` that evaluates each matching object against both the verwerkingsactiviteit's bewaartermijn and the schema's archival retention period (from `archivering-vernietiging`). Objects with expired retention are deleted/anonymized; objects with active retention are flagged with restricted processing. +- Art 30 register export: Create an `Art30ExportService` that generates PDF (via DocuDesk), JSON, and CSV exports. The PDF follows the VNG model verwerkingsregister template layout. +- Purpose-binding middleware: Implement as Nextcloud middleware that runs after authentication (from `auth-system`) but before controller execution. It checks the resolved user's groups against the verwerkingsactiviteit's linked roles for the target schema. + +**Dependencies on Existing OpenRegister Features**: +- `GdprEntity` / `GdprEntityMapper` — existing PII detection entities, referenced for automated PII flagging of unregistered schemas. +- `EntityRecognitionHandler` — detects personal data entities using regex, Presidio, OpenAnonymiser, or hybrid methods. Drives automatic PII detection for compliance alerts. +- `SearchTrail` / `SearchTrailMapper` — existing access logging with organisation scope, provides partial processing evidence foundation. +- `AuditTrail` / `AuditTrailMapper` — immutable hash-chained audit entries, MUST be extended with verwerkingsactiviteit references. +- `ObjectRetentionHandler` — existing retention configuration infrastructure, used for AVG bewaartermijn enforcement. +- `ObjectEntity.retention` — existing retention metadata field on objects, used for archival status tracking. +- `ObjectService` — CRUD operations where processing logging hooks and purpose-binding checks are inserted. +- `MagicMapper` — existing organisation-scoped RBAC and PII exposure prevention, extended with purpose-binding enforcement. +- `Schema.archive` — existing archival configuration, extended with `privacy` configuration block. +- DocuDesk `ConsentService` — pattern for consent record management via OpenRegister objects. +- DocuDesk `FileService::anonymizeDocument()` — pattern for PII replacement in document anonymization. diff --git a/openspec/changes/besluiten-management/specs/besluiten-management/spec.md b/openspec/changes/besluiten-management/specs/besluiten-management/spec.md new file mode 100644 index 000000000000..10249ae4d977 --- /dev/null +++ b/openspec/changes/besluiten-management/specs/besluiten-management/spec.md @@ -0,0 +1,664 @@ +--- +status: draft +--- +# Besluiten Management + +## Purpose +Implement formal decision management (besluiten) conforming to the ZGW BRC (Besluiten Registratie Component) standard, enabling Dutch government organizations to register, track, publish, and withdraw formal administrative decisions as first-class entities within OpenRegister. Decisions MUST be linked to decision types from a configurable catalog, support full lifecycle management from concept through definitive to withdrawn states, and integrate with case management (zaak-besluit linking), document management (besluit-informatieobject linking), archival calculations, and publication workflows under the Wet open overheid (Woo). Every decision MUST maintain an immutable audit trail documenting creation, modification, publication, and withdrawal actions to satisfy legal accountability requirements under the Algemene wet bestuursrecht (Awb). + +**Source**: ZGW BRC API standard v1.0.2 (VNG Realisatie); gap identified in cross-platform competitive analysis (Dimpact ZAC, OpenZaak, Valtimo); Procest roles-decisions spec alignment. + +## ADDED Requirements + +### Requirement: Besluit Entity Schema (ZGW BRC Compliant) +Decisions (besluiten) SHALL be stored as OpenRegister objects with a dedicated schema whose properties conform to the ZGW BRC data model. The schema MUST include all fields defined in the BRC standard to ensure interoperability with other ZGW-compliant systems. + +The besluit schema MUST define the following properties: + +| Property | Type | ZGW Mapping | Required | Description | +|----------|------|-------------|----------|-------------| +| `identificatie` | string (max 50) | `identificatie` | auto-gen | Human-readable decision identifier, unique per verantwoordelijkeOrganisatie | +| `verantwoordelijkeOrganisatie` | string (RSIN, 9 digits) | `verantwoordelijke_organisatie` | Yes | RSIN of the responsible organization | +| `besluittype` | reference (UUID) | `besluittype` | Yes | Reference to a BesluitType object in the catalog | +| `zaak` | reference (UUID) | `zaak` | No | Reference to the originating case (optional for standalone decisions) | +| `datum` | date (ISO 8601) | `datum` | Yes | Decision date (MUST be today or earlier) | +| `toelichting` | string | `toelichting` | No | Explanation or motivation for the decision | +| `bestuursorgaan` | string (max 50) | `bestuursorgaan` | No | Governing body (e.g., Burgemeester, College van B&W, Gemeenteraad) | +| `ingangsdatum` | date (ISO 8601) | `ingangsdatum` | Yes | Effective start date of the decision | +| `vervaldatum` | date (ISO 8601) | `vervaldatum` | No | Expiry date of the decision | +| `vervalreden` | enum | `vervalreden` | No | Reason for expiry: `tijdelijk`, `ingetrokken_overheid`, `ingetrokken_belanghebbende` | +| `publicatiedatum` | date (ISO 8601) | `publicatiedatum` | No | Date the decision was published | +| `verzenddatum` | date (ISO 8601) | `verzenddatum` | No | Date the decision was sent to the betrokkene | +| `uiterlijkeReactiedatum` | date (ISO 8601) | `uiterlijke_reactiedatum` | No | Deadline for objection/response | + +Key constraint: The combination of `identificatie` and `verantwoordelijkeOrganisatie` MUST be unique across all besluit objects. + +#### Scenario: Create a besluit with all required fields +- **GIVEN** a register `procest` with a `besluit` schema conforming to the ZGW BRC data model +- **AND** a besluittype `omgevingsvergunning-verleend` exists in the catalog +- **WHEN** the user creates a besluit with: + - `besluittype`: reference to `omgevingsvergunning-verleend` + - `verantwoordelijkeOrganisatie`: `002220647` + - `datum`: `2026-03-15` + - `ingangsdatum`: `2026-03-16` + - `toelichting`: `Vergunning verleend conform aanvraag` + - `bestuursorgaan`: `College van B&W` +- **THEN** the besluit MUST be created as an OpenRegister object in the `besluit` schema +- **AND** an `identificatie` MUST be auto-generated based on the datum and a sequence number +- **AND** the besluit MUST be retrievable by its UUID + +#### Scenario: Auto-generate identificatie when not provided +- **GIVEN** a besluit is being created without an explicit `identificatie` +- **AND** the `verantwoordelijkeOrganisatie` is `002220647` +- **AND** the `datum` is `2026-03-15` +- **WHEN** the besluit is saved +- **THEN** the system MUST generate a unique `identificatie` (e.g., `BESLUIT-2026-0001`) +- **AND** the combination `(BESLUIT-2026-0001, 002220647)` MUST be unique + +#### Scenario: Reject duplicate identificatie for same organisation +- **GIVEN** a besluit with `identificatie` `BESLUIT-2026-0001` and `verantwoordelijkeOrganisatie` `002220647` already exists +- **WHEN** a new besluit is created with the same `identificatie` and `verantwoordelijkeOrganisatie` +- **THEN** the system MUST reject the creation with an error indicating the uniqueness constraint violation + +#### Scenario: Reject datum in the future +- **GIVEN** today is `2026-03-15` +- **WHEN** the user creates a besluit with `datum` set to `2026-03-20` +- **THEN** the system MUST reject the creation +- **AND** the error message MUST indicate that `datum` cannot be in the future + +#### Scenario: Create a standalone besluit without zaak reference +- **GIVEN** a policy decision that is not tied to a specific case +- **WHEN** the user creates a besluit with `zaak` set to null +- **THEN** the besluit MUST be created successfully as a standalone decision +- **AND** the besluit MUST still require `besluittype`, `datum`, and `ingangsdatum` + +--- + +### Requirement: Besluit Lifecycle (Concept to Definitief to Ingetrokken) +The system SHALL track the lifecycle state of each besluit through three phases: concept (draft), definitief (final/published), and ingetrokken (withdrawn). Lifecycle transitions MUST be validated to prevent illegal state changes, and each transition MUST be recorded in the audit trail. + +#### Scenario: Create a besluit in concept state +- **GIVEN** the user creates a new besluit +- **WHEN** the besluit is saved without setting `publicatiedatum` or `verzenddatum` +- **THEN** the besluit MUST be in the `concept` lifecycle state +- **AND** the besluit MUST be editable (all fields modifiable) +- **AND** the besluit MUST NOT be visible via the public API + +#### Scenario: Transition from concept to definitief +- **GIVEN** a besluit in `concept` state +- **WHEN** the user sets the `verzenddatum` to `2026-03-16` +- **AND** the besluit has all required fields populated (besluittype, datum, ingangsdatum) +- **THEN** the besluit MUST transition to `definitief` state +- **AND** the audit trail MUST record the transition with timestamp and user +- **AND** core fields (`besluittype`, `datum`, `verantwoordelijkeOrganisatie`) MUST become immutable + +#### Scenario: Transition from definitief to ingetrokken +- **GIVEN** a besluit in `definitief` state with verzenddatum `2026-03-16` +- **WHEN** the authorized user withdraws the besluit with vervalreden `ingetrokken_overheid` +- **THEN** the `vervaldatum` MUST be set to the current date +- **AND** the `vervalreden` MUST be set to `ingetrokken_overheid` +- **AND** the besluit MUST transition to `ingetrokken` state +- **AND** the audit trail MUST record the withdrawal with reason + +#### Scenario: Prevent re-activation of a withdrawn besluit +- **GIVEN** a besluit in `ingetrokken` state +- **WHEN** the user attempts to clear `vervalreden` or change `vervaldatum` to a future date +- **THEN** the system MUST reject the modification +- **AND** the error message MUST indicate that withdrawn decisions cannot be reactivated + +#### Scenario: Prevent deletion of a definitief besluit +- **GIVEN** a besluit in `definitief` state with linked informatieobjecten +- **WHEN** the user attempts to delete the besluit +- **THEN** the system MUST reject the deletion +- **AND** the error message MUST indicate that final decisions must be withdrawn, not deleted + +--- + +### Requirement: BesluitType Configuration via Catalog +Decision types (besluittypen) SHALL be defined as OpenRegister objects in a dedicated `besluittype` schema within the catalog, analogous to zaaktype configuration. Each besluittype MUST define reaction periods, publication requirements, and allowed information object types. + +The besluittype schema MUST include: + +| Property | Type | ZGW Mapping | Required | +|----------|------|-------------|----------| +| `omschrijving` | string (max 255) | `omschrijving` | Yes | +| `omschrijvingGeneriek` | string | `omschrijving_generiek` | No | +| `besluitcategorie` | string | `besluitcategorie` | No | +| `reactietermijn` | string (ISO 8601 duration) | `reactietermijn` | No | +| `publicatieIndicatie` | boolean | `publicatie_indicatie` | Yes | +| `publicatietermijn` | string (ISO 8601 duration) | `publicatietermijn` | No | +| `informatieobjecttypen` | array of references | `informatieobjecttypen` | No | +| `zaaktypen` | array of references | `zaaktypen` | No | +| `beginGeldigheid` | date | `begin_geldigheid` | Yes | +| `eindeGeldigheid` | date | `einde_geldigheid` | No | +| `concept` | boolean | `concept` | Yes | + +#### Scenario: Define a besluittype with reaction period +- **GIVEN** an admin configuring the besluittype catalog +- **WHEN** they create a besluittype: + - `omschrijving`: `Omgevingsvergunning verleend` + - `besluitcategorie`: `vergunning` + - `reactietermijn`: `P42D` (42 days / 6 weeks) + - `publicatieIndicatie`: `true` + - `publicatietermijn`: `P14D` (14 days) + - `beginGeldigheid`: `2026-01-01` + - `concept`: `false` +- **THEN** the besluittype MUST be available for selection when creating besluiten +- **AND** the reactietermijn MUST be used to auto-calculate `uiterlijkeReactiedatum` + +#### Scenario: Define a besluittype without publication requirement +- **GIVEN** an admin creating a besluittype for internal decisions +- **WHEN** they create a besluittype with `publicatieIndicatie`: `false` +- **THEN** besluiten of this type MUST NOT require `publicatiedatum` +- **AND** if a user sets `publicatiedatum` on a besluit of this type, the system MUST reject it with a validation error + +#### Scenario: Link besluittype to specific zaaktypen +- **GIVEN** a besluittype `Omgevingsvergunning verleend` +- **WHEN** the admin links it to zaaktypen `Omgevingsvergunning` and `Bouwvergunning` +- **THEN** only cases of those zaaktypen MUST be able to create besluiten with this besluittype +- **AND** attempting to create a besluit with this besluittype on a case of zaaktype `Klacht` MUST be rejected + +#### Scenario: Retire a besluittype by setting einde geldigheid +- **GIVEN** a besluittype `Subsidie toekenning` with `beginGeldigheid` `2024-01-01` +- **WHEN** the admin sets `eindeGeldigheid` to `2026-03-31` +- **THEN** the besluittype MUST remain valid for existing besluiten +- **AND** after `2026-03-31`, the besluittype MUST NOT be selectable for new besluiten + +--- + +### Requirement: Besluit-Zaak Linking +Each besluit SHOULD be linkable to a case (zaak) through a bidirectional reference. When a besluit is linked to a zaak, the system SHALL create a corresponding ZaakBesluit reference on the zaak side to maintain referential integrity, consistent with the ZGW cross-API synchronization pattern. + +#### Scenario: Link a besluit to a zaak on creation +- **GIVEN** a case `vergunning-1` of zaaktype `Omgevingsvergunning` +- **AND** the zaaktype has besluittype `Omgevingsvergunning verleend` in its `besluittypen` list +- **WHEN** the user creates a besluit with `zaak` referencing `vergunning-1` +- **THEN** the besluit MUST be created with the zaak reference +- **AND** the zaak object MUST be updated to include the besluit reference in its `besluiten` array +- **AND** the besluit MUST be visible in the Decisions section of the case detail view + +#### Scenario: Validate besluittype belongs to zaaktype +- **GIVEN** a case `klacht-1` of zaaktype `Klacht behandeling` +- **AND** the zaaktype does NOT include besluittype `Omgevingsvergunning verleend` +- **WHEN** the user creates a besluit with `zaak` referencing `klacht-1` and `besluittype` referencing `Omgevingsvergunning verleend` +- **THEN** the system MUST reject the creation +- **AND** the error MUST indicate that the besluittype is not allowed for this zaaktype + +#### Scenario: Update zaak reference on an existing besluit +- **GIVEN** a besluit `B-001` linked to zaak `vergunning-1` +- **WHEN** the user changes the `zaak` reference to `vergunning-2` +- **THEN** the previous zaak `vergunning-1` MUST have its besluit reference removed +- **AND** the new zaak `vergunning-2` MUST have the besluit reference added +- **AND** the audit trail MUST record the zaak change with both old and new references + +#### Scenario: Display multiple besluiten on a case +- **GIVEN** case `vergunning-1` has three linked besluiten: + - `B-001`: `Omgevingsvergunning verleend` (datum: 2026-03-10, ingangsdatum: 2026-03-15) + - `B-002`: `Voorwaardelijk besluit` (datum: 2026-02-20, ingangsdatum: 2026-03-01) + - `B-003`: `Besluit ingetrokken` (datum: 2026-04-01, vervalreden: ingetrokken_overheid) +- **WHEN** the user views the case detail +- **THEN** all three besluiten MUST be displayed in the Decisions section +- **AND** besluiten MUST be sorted by `datum` descending +- **AND** each besluit MUST show: identificatie, besluittype omschrijving, datum, lifecycle state indicator + +--- + +### Requirement: Besluit-InformatieObject Linking +Each besluit SHALL support linking to one or more informatieobjecten (documents) via a `besluitInformatieObject` join entity. This linking pattern follows the ZGW BRC standard where the BRC leads the relationship and the DRC mirrors it through ObjectInformatieObject records. + +#### Scenario: Link a document to a besluit +- **GIVEN** a besluit `B-001` for `Omgevingsvergunning verleend` +- **WHEN** the user uploads a formal decision letter `beschikking-2026-0001.pdf` +- **THEN** a `besluitInformatieObject` record MUST be created linking the besluit to the document +- **AND** the document MUST be accessible from both the besluit detail and the case dossier +- **AND** the `aardRelatie` MUST be set to `legt_vast` (documents the decision) + +#### Scenario: Link multiple documents to a besluit +- **GIVEN** a besluit `B-001` +- **WHEN** the user links three documents: the decision letter, a site plan, and an environmental assessment +- **THEN** three `besluitInformatieObject` records MUST be created +- **AND** all three documents MUST be listed in the besluit detail view +- **AND** each document MUST display its title, type, and creation date + +#### Scenario: Validate informatieobjecttype against besluittype +- **GIVEN** besluittype `Omgevingsvergunning verleend` allows informatieobjecttypen: `Beschikking`, `Bijlage` +- **AND** document `rapport.pdf` has informatieobjecttype `Intern rapport` +- **WHEN** the user attempts to link `rapport.pdf` to a besluit of this type +- **THEN** the system MUST reject the link with a validation error +- **AND** the error MUST indicate that the informatieobjecttype is not allowed for this besluittype + +#### Scenario: Remove a document link from a besluit +- **GIVEN** a besluit `B-001` with linked document `beschikking-2026-0001.pdf` +- **WHEN** the user removes the document link +- **THEN** the `besluitInformatieObject` record MUST be deleted +- **AND** the document itself MUST NOT be deleted (only the link is removed) +- **AND** the corresponding ObjectInformatieObject in the DRC MUST also be removed + +--- + +### Requirement: Verantwoordelijke Organisatie Tracking +Each besluit SHALL record the RSIN (Rechtspersonen en Samenwerkingsverbanden Identificatienummer) of the responsible organization. This field MUST be validated as a 9-digit number and SHALL be used together with the identificatie to ensure uniqueness across organizations. + +#### Scenario: Set verantwoordelijke organisatie from system configuration +- **GIVEN** the OpenRegister instance is configured with default RSIN `002220647` (Gemeente Utrecht) +- **WHEN** a new besluit is created without explicitly setting `verantwoordelijkeOrganisatie` +- **THEN** the system MUST default to the configured RSIN `002220647` +- **AND** the RSIN MUST be stored on the besluit object + +#### Scenario: Override verantwoordelijke organisatie for mandated decisions +- **GIVEN** a besluit is being created by Gemeente Utrecht on behalf of the Omgevingsdienst (RSIN `003456789`) +- **WHEN** the user explicitly sets `verantwoordelijkeOrganisatie` to `003456789` +- **THEN** the system MUST accept the override +- **AND** the uniqueness constraint for `identificatie` MUST be scoped to the new RSIN + +#### Scenario: Reject invalid RSIN format +- **GIVEN** the user sets `verantwoordelijkeOrganisatie` to `12345` (too short) or `abcdefghi` (non-numeric) +- **WHEN** the besluit is submitted +- **THEN** the system MUST reject the submission +- **AND** the error MUST indicate that the RSIN must be exactly 9 digits + +--- + +### Requirement: Ingangsdatum/Vervaldatum Handling +The system SHALL track the validity period (werkingsperiode) of each besluit through `ingangsdatum` (effective start) and `vervaldatum` (expiry). Changes to these dates MUST trigger archival recalculation on the linked zaak when the zaaktype uses `ingangsdatum_besluit` or `vervaldatum_besluit` as the archival date derivation method (afleidingswijze). + +#### Scenario: Calculate archival date from ingangsdatum when afleidingswijze is ingangsdatum_besluit +- **GIVEN** a zaak `vergunning-1` with zaaktype where `afleidingswijze` is `ingangsdatum_besluit` +- **AND** the zaak has two besluiten with `ingangsdatum` `2026-03-15` and `2026-04-01` +- **WHEN** the archival date is calculated +- **THEN** the system MUST use the maximum `ingangsdatum` across all linked besluiten (`2026-04-01`) +- **AND** this date MUST be the brondatum for the archival calculation + +#### Scenario: Calculate archival date from vervaldatum when afleidingswijze is vervaldatum_besluit +- **GIVEN** a zaak `vergunning-1` with zaaktype where `afleidingswijze` is `vervaldatum_besluit` +- **AND** the zaak has two besluiten with `vervaldatum` `2031-03-15` and `2029-12-31` +- **WHEN** the archival date is calculated +- **THEN** the system MUST use the maximum `vervaldatum` across all linked besluiten (`2031-03-15`) + +#### Scenario: Trigger archival recalculation on vervaldatum change +- **GIVEN** a besluit `B-001` linked to zaak `vergunning-1` +- **AND** the zaak's zaaktype uses `vervaldatum_besluit` as afleidingswijze +- **WHEN** the user updates `vervaldatum` from `2031-03-15` to `2033-06-30` +- **THEN** the system MUST trigger archival date recalculation on `vergunning-1` +- **AND** the new archival brondatum MUST reflect the updated vervaldatum + +#### Scenario: Display validity period on besluit detail +- **GIVEN** a besluit with `ingangsdatum` `2026-03-16` and `vervaldatum` `2031-03-16` +- **AND** today is `2026-06-15` +- **WHEN** the user views the besluit detail +- **THEN** the system MUST display the validity period as `16 maart 2026 -- 16 maart 2031` +- **AND** the status MUST show `Actief` with remaining time `4 jaar, 9 maanden resterend` + +#### Scenario: Display besluit without vervaldatum as indefinitely valid +- **GIVEN** a besluit with `ingangsdatum` `2026-03-16` and no `vervaldatum` +- **WHEN** the user views the besluit detail +- **THEN** the system MUST display `Geldig vanaf 16 maart 2026` with no end date +- **AND** the besluit MUST be treated as indefinitely valid + +--- + +### Requirement: Vervalreden Tracking +When a besluit expires or is withdrawn, the system SHALL record the reason (vervalreden) using the ZGW standard enumeration. The vervalreden MUST be one of three values: `tijdelijk` (temporary decision expired naturally), `ingetrokken_overheid` (withdrawn by the governing authority), or `ingetrokken_belanghebbende` (withdrawn at the request of the interested party). + +#### Scenario: Record expiry by natural end of temporary decision +- **GIVEN** a besluit `B-001` with `vervaldatum` `2026-12-31` +- **WHEN** the vervaldatum passes and the system detects the expiry during a scheduled check +- **THEN** the `vervalreden` MUST be set to `tijdelijk` +- **AND** the besluit lifecycle state MUST change to reflect the expiry + +#### Scenario: Record withdrawal by the governing authority +- **GIVEN** a definitief besluit `B-001` for `Omgevingsvergunning verleend` +- **WHEN** the authorized user withdraws the besluit with explanation `Besluit ingetrokken wegens onregelmatigheden in de aanvraag` +- **THEN** the `vervalreden` MUST be set to `ingetrokken_overheid` +- **AND** the `vervaldatum` MUST be set to the current date +- **AND** the `toelichting` MUST be updated with: `Overheid: Besluit ingetrokken wegens onregelmatigheden in de aanvraag` + +#### Scenario: Record withdrawal at request of the interested party +- **GIVEN** a definitief besluit `B-002` for a granted permit +- **WHEN** the permit holder requests withdrawal +- **AND** the authorized user processes the withdrawal with vervalreden `ingetrokken_belanghebbende` +- **THEN** the `vervalreden` MUST be set to `ingetrokken_belanghebbende` +- **AND** the `toelichting` MUST be updated with: `Belanghebbende: [withdrawal explanation]` + +#### Scenario: Reject vervalreden without vervaldatum +- **GIVEN** a besluit without a `vervaldatum` +- **WHEN** the user attempts to set `vervalreden` to `tijdelijk` +- **THEN** the system MUST reject the modification +- **AND** the error MUST indicate that vervalreden requires a vervaldatum to be set + +--- + +### Requirement: Besluit Publicatie (Woo Compliance) +Besluiten with `publicatieIndicatie: true` on their besluittype SHALL be subject to publication requirements under the Wet open overheid (Woo). The system MUST support marking decisions for publication, tracking publication dates, and providing a public-facing view with personal data redaction. + +#### Scenario: Flag a besluit for publication based on besluittype +- **GIVEN** a besluit of besluittype `Omgevingsvergunning verleend` with `publicatieIndicatie: true` +- **WHEN** the besluit transitions to definitief state +- **THEN** the system MUST flag the besluit as requiring publication +- **AND** the publication deadline MUST be calculated from the `verzenddatum` plus the besluittype's `publicatietermijn` +- **AND** a notification MUST be sent to the publication officer + +#### Scenario: Set publicatiedatum and validate response deadline +- **GIVEN** a besluit with besluittype having `reactietermijn: P42D` (42 days) +- **WHEN** the user sets `publicatiedatum` to `2026-03-16` +- **THEN** the `uiterlijkeReactiedatum` MUST be at minimum `2026-04-27` (publicatiedatum + 42 days) +- **AND** if the user sets `uiterlijkeReactiedatum` to a date before `2026-04-27`, the system MUST reject it with a validation error + +#### Scenario: Publish besluit to public API with PII redaction +- **GIVEN** a besluit with `publicatiedatum` set and `publicatieIndicatie: true` +- **WHEN** the besluit is accessed via the public (unauthenticated) API +- **THEN** the besluit MUST be returned with personal data fields redacted +- **AND** the `toelichting` MUST have person names, BSN numbers, and addresses replaced with `[GEANONIMISEERD]` +- **AND** linked documents in the public view MUST also have PII redacted or be restricted based on schema-level redaction configuration + +#### Scenario: Reject publication dates when publicatieIndicatie is false +- **GIVEN** a besluittype `Intern adviesbesluit` with `publicatieIndicatie: false` +- **WHEN** the user creates a besluit of this type and sets `publicatiedatum` to `2026-03-16` +- **THEN** the system MUST reject the publication date +- **AND** the error MUST indicate that this besluittype does not require publication + +#### Scenario: Validate response date requires publication date and vice versa +- **GIVEN** a besluit with publicatieIndicatie true +- **WHEN** the user sets `uiterlijkeReactiedatum` without setting `publicatiedatum` +- **THEN** the system MUST reject with error indicating that `publicatiedatum` is required when `uiterlijkeReactiedatum` is set +- **AND** similarly, setting `publicatiedatum` without `uiterlijkeReactiedatum` MUST also be rejected + +--- + +### Requirement: Besluit Bezwaar/Beroep Tracking +The system SHALL support tracking objections (bezwaar) and appeals (beroep) filed against decisions. When the `uiterlijkeReactiedatum` is set, the system MUST track whether the deadline has passed and whether any formal objection has been received, supporting the administrative law lifecycle under the Awb. + +#### Scenario: Calculate uiterlijkeReactiedatum from verzenddatum and reactietermijn +- **GIVEN** a besluit with `verzenddatum` `2026-03-16` +- **AND** the besluittype has `reactietermijn` `P42D` +- **WHEN** the besluit is created or `verzenddatum` is set +- **THEN** `uiterlijkeReactiedatum` MUST be automatically calculated as `2026-04-27` +- **AND** the calculated date MUST be stored on the besluit +- **AND** the user MAY override the calculated date to a later date but NOT to an earlier date + +#### Scenario: Display active bezwaartermijn with countdown +- **GIVEN** a besluit with `uiterlijkeReactiedatum` `2026-04-27` +- **AND** today is `2026-04-01` +- **WHEN** the besluit detail is viewed +- **THEN** the system MUST display `26 dagen resterend voor bezwaar/beroep` +- **AND** a progress indicator MUST show the elapsed and remaining portion of the bezwaartermijn + +#### Scenario: Display expired bezwaartermijn +- **GIVEN** a besluit with `uiterlijkeReactiedatum` `2026-04-27` +- **AND** today is `2026-05-01` +- **WHEN** the besluit detail is viewed +- **THEN** the system MUST display `Bezwaartermijn verlopen (sinds 27 april 2026)` +- **AND** the indicator MUST be visually distinct (e.g., greyed out or marked as complete) + +#### Scenario: Register a bezwaar against a besluit +- **GIVEN** a definitief besluit `B-001` with active bezwaartermijn +- **WHEN** a formal objection is received and registered +- **THEN** the system MUST create a linked `bezwaar` record referencing the besluit +- **AND** the besluit detail MUST show the number of active bezwaren +- **AND** the bezwaar MAY trigger a new case (zaak) for processing the objection + +#### Scenario: Notify approaching bezwaartermijn deadline +- **GIVEN** a besluit with `uiterlijkeReactiedatum` `2026-04-27` +- **AND** today is `2026-04-22` (5 days before deadline) +- **WHEN** the daily scheduled job runs +- **THEN** the system MUST send a Nextcloud notification to the case handler +- **AND** the notification MUST include: besluit identificatie, linked zaak, days remaining + +--- + +### Requirement: Besluit API (CRUD and Status Transitions) +The system SHALL expose RESTful API endpoints for besluit CRUD operations that follow the ZGW BRC URL structure and response format. The API MUST support content negotiation, pagination, filtering, and the standard ZGW scope-based authorization model. + +| Method | Path | Scope | Description | +|--------|------|-------|-------------| +| GET | `/api/besluiten/v1/besluiten` | `besluiten.lezen` | List decisions with filtering | +| POST | `/api/besluiten/v1/besluiten` | `besluiten.aanmaken` | Create a decision | +| GET | `/api/besluiten/v1/besluiten/{uuid}` | `besluiten.lezen` | Retrieve a decision | +| PUT | `/api/besluiten/v1/besluiten/{uuid}` | `besluiten.bijwerken` | Full update | +| PATCH | `/api/besluiten/v1/besluiten/{uuid}` | `besluiten.bijwerken` | Partial update | +| DELETE | `/api/besluiten/v1/besluiten/{uuid}` | `besluiten.verwijderen` | Delete a decision | +| GET | `/api/besluiten/v1/besluiten/{uuid}/audittrail` | `besluiten.lezen` | Audit trail | +| GET | `/api/besluiten/v1/besluitinformatieobjecten` | `besluiten.lezen` | List linked documents | +| POST | `/api/besluiten/v1/besluitinformatieobjecten` | `besluiten.aanmaken` | Link a document | +| DELETE | `/api/besluiten/v1/besluitinformatieobjecten/{uuid}` | `besluiten.verwijderen` | Unlink a document | + +#### Scenario: Create a besluit via API +- **GIVEN** an authenticated client with scope `besluiten.aanmaken` +- **WHEN** the client sends `POST /api/besluiten/v1/besluiten` with a valid JSON body +- **THEN** the system MUST return HTTP 201 with the created besluit including generated `uuid` and `identificatie` +- **AND** the `url` field in the response MUST be the absolute URL to the created resource + +#### Scenario: List besluiten with filtering +- **GIVEN** 50 besluiten in the register, 10 of which are linked to zaak `vergunning-1` +- **WHEN** the client sends `GET /api/besluiten/v1/besluiten?zaak=` +- **THEN** the system MUST return only the 10 besluiten linked to the specified zaak +- **AND** the response MUST use standard ZGW pagination with `count`, `next`, `previous`, and `results` + +#### Scenario: Filter besluiten by besluittype and date range +- **GIVEN** multiple besluiten across different types and dates +- **WHEN** the client sends `GET /api/besluiten/v1/besluiten?besluittype=&datum__gte=2026-01-01&datum__lte=2026-03-31` +- **THEN** the system MUST return only besluiten matching both the besluittype and the date range + +#### Scenario: Reject unauthorized API access +- **GIVEN** an authenticated client with only `besluiten.lezen` scope +- **WHEN** the client sends `POST /api/besluiten/v1/besluiten` (create) +- **THEN** the system MUST return HTTP 403 Forbidden +- **AND** the error MUST indicate insufficient scope + +#### Scenario: Return audit trail for a besluit +- **GIVEN** a besluit `B-001` that has been created, updated, and had documents linked +- **WHEN** the client sends `GET /api/besluiten/v1/besluiten/{uuid}/audittrail` +- **THEN** the system MUST return a chronological list of all actions performed on the besluit +- **AND** each entry MUST include: timestamp, user, action type (create/update/delete), and changed fields + +--- + +### Requirement: Bulk Besluit Operations +The system SHALL support batch processing of besluiten for common government workflows where multiple decisions are issued simultaneously (e.g., batch permit approvals, mass subsidy grants). The batch endpoint MUST follow the OpenZaak `besluit_verwerken` convenience pattern. + +#### Scenario: Batch create besluiten for multiple cases +- **GIVEN** 15 cases of zaaktype `Subsidie aanvraag` are ready for decision +- **AND** all cases should receive besluittype `Subsidie toegekend` +- **WHEN** the user submits a batch operation with a list of zaak UUIDs and shared besluit properties +- **THEN** the system MUST create 15 individual besluiten, one per case +- **AND** each besluit MUST have a unique `identificatie` +- **AND** the response MUST include a summary: `15 besluiten aangemaakt, 0 fouten` + +#### Scenario: Batch create with partial failure +- **GIVEN** a batch of 10 besluiten to create +- **AND** 2 of the 10 have invalid zaak references +- **WHEN** the batch is submitted +- **THEN** the system MUST create the 8 valid besluiten +- **AND** the response MUST report `8 besluiten aangemaakt, 2 fouten` +- **AND** each error MUST include the zaak reference and the specific validation error + +#### Scenario: Batch withdrawal of related besluiten +- **GIVEN** 5 besluiten linked to cases that are part of a revoked policy +- **WHEN** the user submits a batch withdrawal with vervalreden `ingetrokken_overheid` +- **THEN** all 5 besluiten MUST have `vervaldatum` set to the current date and `vervalreden` set to `ingetrokken_overheid` +- **AND** the audit trail for each besluit MUST record the withdrawal + +--- + +### Requirement: Besluit Search and Filtering +The system SHALL provide comprehensive search and filtering capabilities for besluiten, supporting both the API filter parameters from the ZGW BRC standard and a frontend search interface integrated with OpenRegister's faceted search. + +#### Scenario: Search besluiten by free text in toelichting +- **GIVEN** 100 besluiten in the register +- **AND** 3 of them contain the word `asbest` in the toelichting +- **WHEN** the user searches for `asbest` +- **THEN** the system MUST return the 3 matching besluiten +- **AND** the search result MUST highlight the matching text in the toelichting + +#### Scenario: Filter besluiten by lifecycle state +- **GIVEN** 50 besluiten: 20 concept, 25 definitief, 5 ingetrokken +- **WHEN** the user filters by lifecycle state `definitief` +- **THEN** the system MUST return only the 25 definitief besluiten + +#### Scenario: Filter besluiten by verantwoordelijke organisatie +- **GIVEN** besluiten from multiple organizations in a shared register +- **WHEN** the user filters by `verantwoordelijkeOrganisatie` `002220647` +- **THEN** only besluiten from that organization MUST be returned + +#### Scenario: Filter besluiten with active bezwaartermijn +- **GIVEN** 30 definitief besluiten, 12 of which have `uiterlijkeReactiedatum` in the future +- **WHEN** the user selects the filter `Bezwaartermijn actief` +- **THEN** the system MUST return only the 12 besluiten with unexpired bezwaartermijn +- **AND** results MUST be sorted by `uiterlijkeReactiedatum` ascending (nearest deadline first) + +#### Scenario: Faceted search combining multiple filters +- **GIVEN** the user wants to find all granted permits from Q1 2026 +- **WHEN** the user applies filters: + - besluittype: `Omgevingsvergunning verleend` + - datum range: `2026-01-01` to `2026-03-31` + - lifecycle state: `definitief` +- **THEN** the system MUST return only besluiten matching all three criteria +- **AND** facet counts MUST be displayed for further narrowing + +--- + +### Requirement: Audit Trail for Decisions +Every action on a besluit (creation, modification, status transition, document linking, withdrawal) SHALL be recorded in an immutable audit trail. The audit trail MUST comply with the ZGW BRC audittrail specification and integrate with OpenRegister's existing AuditTrailMapper for consistent logging across all entity types. + +#### Scenario: Record besluit creation in audit trail +- **GIVEN** user `jan.devries` creates a besluit `B-001` +- **WHEN** the creation is completed +- **THEN** the audit trail MUST contain an entry with: + - `actie`: `create` + - `actieWeergave`: `Besluit aangemaakt` + - `resultaat`: HTTP 201 + - `hoofdObject`: URL of the besluit + - `resource`: `besluit` + - `resourceUrl`: URL of the besluit + - `aanmaakdatum`: current timestamp + - `wijzigingen.nieuw`: all field values of the created besluit + +#### Scenario: Record field modification in audit trail +- **GIVEN** a besluit `B-001` with `toelichting` `Vergunning verleend` +- **WHEN** user `maria.bakker` updates `toelichting` to `Vergunning verleend met voorwaarden` +- **THEN** the audit trail MUST contain an entry with: + - `actie`: `update` + - `wijzigingen.oud.toelichting`: `Vergunning verleend` + - `wijzigingen.nieuw.toelichting`: `Vergunning verleend met voorwaarden` + +#### Scenario: Record withdrawal in audit trail +- **GIVEN** a definitief besluit `B-001` +- **WHEN** the besluit is withdrawn with vervalreden `ingetrokken_overheid` +- **THEN** the audit trail MUST contain an entry recording: + - The vervalreden being set + - The vervaldatum being set + - The toelichting being updated with the withdrawal explanation + - The lifecycle state transition from `definitief` to `ingetrokken` + +#### Scenario: Audit trail entries are immutable +- **GIVEN** an audit trail with 10 entries for besluit `B-001` +- **WHEN** a user or API client attempts to modify or delete an existing audit trail entry +- **THEN** the system MUST reject the operation with HTTP 405 Method Not Allowed +- **AND** audit trail entries MUST be append-only + +--- + +### Requirement: VNG BRC API Mapping +The system SHALL provide a ZGW BRC-compatible API layer that maps OpenRegister's internal besluit objects to the standard BRC response format. This mapping enables interoperability with other ZGW-compliant systems (Dimpact ZAC, Valtimo, Open Formulieren) that expect standard BRC endpoints and response structures. + +#### Scenario: Map internal besluit to ZGW BRC response format +- **GIVEN** an internal besluit object stored in OpenRegister with camelCase property names +- **WHEN** the besluit is retrieved via the ZGW-compatible API endpoint +- **THEN** the response MUST use the ZGW BRC field naming convention (snake_case): + - `verantwoordelijke_organisatie` (not `verantwoordelijkeOrganisatie`) + - `uiterlijke_reactiedatum` (not `uiterlijkeReactiedatum`) + - `besluittype` as full URL reference (not UUID) + - `zaak` as full URL reference (not UUID) +- **AND** the response MUST include the standard `url` field pointing to the resource's canonical URL + +#### Scenario: Accept ZGW BRC request format on creation +- **GIVEN** an external system (e.g., Valtimo) sends a POST request using ZGW BRC field naming +- **WHEN** the request body uses `verantwoordelijke_organisatie` and `uiterlijke_reactiedatum` +- **THEN** the system MUST accept both snake_case and camelCase field names +- **AND** the internal storage MUST normalize to the OpenRegister property naming convention + +#### Scenario: Resolve URL references to besluittype and zaak +- **GIVEN** a besluit creation request with `besluittype` as a full URL `https://catalogi.example.com/api/v1/besluittypen/{uuid}` +- **WHEN** the system processes the request +- **THEN** the system MUST resolve the URL to the internal besluittype object +- **AND** if the URL references an external catalog, the system MUST validate that the besluittype exists at that URL (HTTP GET returns 200) + +#### Scenario: Cross-API synchronization for zaak-besluit linking +- **GIVEN** a besluit is created with a `zaak` reference +- **WHEN** the creation is processed +- **THEN** the system MUST automatically create a corresponding `ZaakBesluit` record on the zaak side +- **AND** the ZaakBesluit MUST reference the besluit URL +- **AND** deleting the besluit MUST also remove the ZaakBesluit record + +--- + +## Current Implementation Status + +- **NOT implemented:** No dedicated besluiten (decisions) management exists in the OpenRegister core codebase. + - No `besluit` schema, entity, or dedicated controller in OpenRegister + - No `besluittype` catalog schema or configuration + - No bezwaartermijn calculation logic + - No decision withdrawal (intrekking) workflow + - No publication workflow for decisions + - No personal data redaction for public decision views + - No batch besluit operations + - No BRC-compatible API endpoints + +- **Partial foundations in OpenRegister:** + - Register and Schema entities (`lib/Db/Register.php`, `lib/Db/Schema.php`) support arbitrary schema definitions that can model the besluit data structure + - Objects can reference each other via schema `$ref` properties, enabling zaak-besluit bidirectional linking + - The existing object model can store besluiten as regular register objects with a dedicated besluit schema + - File linking is available via `FileService` (`lib/Service/FileService.php`) for attaching decision documents + - `AuditTrailMapper` provides immutable audit logging infrastructure + - DSO register (`lib/Settings/dso_register.json`) already contains `besluitdatum` fields on permit applications, demonstrating the pattern + - ORI register (`lib/Settings/ori_register.json`) already has `besluit` as a document type for council decisions + +- **Partial foundations in Procest:** + - Decision schema defined in `procest_register.json` with `title`, `description`, `case`, `decisionType`, `decidedBy`, `decidedAt`, `effectiveDate`, `expiryDate` properties -- needs alignment with ZGW BRC field names + - DecisionType schema defined with `name`, `description`, `category`, `objectionPeriod`, `publicationRequired`, `publicationPeriod` -- needs ZGW BRC field mapping + - No frontend UI exists for creating, viewing, editing, or deleting decisions + - The roles-decisions spec (`procest/openspec/specs/roles-decisions/spec.md`) defines the Procest-side data model and CRUD requirements + +## Standards & References +- **ZGW BRC (Besluiten Registratie Component) v1.0.2** -- API standard for decision registration in Dutch government (VNG Realisatie) +- **ZGW ZTC (Zaaktypecatalogus)** -- BesluitType definitions within the catalog, including reactietermijn and publicatieIndicatie +- **Awb (Algemene wet bestuursrecht)** -- Legal framework for formal government decisions, appeal periods (bezwaartermijn), and administrative proceedings +- **RGBZ (Referentiemodel Gemeentelijke Basisgegevens Zaken)** -- Reference data model including besluiten entity relationships +- **MDTO (Metagegevens Duurzaam Toegankelijke Overheidsinformatie)** -- Archival metadata standard for decisions +- **Wet open overheid (Woo)** -- Publication requirements for government decisions, replacing the Wob +- **VNG ZGW API specificaties** -- https://vng-realisatie.github.io/gemma-zaken/ +- **OpenZaak BRC implementation** -- Reference implementation for BRC API compliance (analyzed in competitive analysis) +- **Dimpact ZAC DecisionService** -- Publication date validation patterns with reactietermijn calculation + +## Cross-References +- **document-zaakdossier** -- Linked documents (beschikking PDFs) in the case dossier view; besluitInformatieObject records integrate with the dossier structure +- **archivering-vernietiging** -- Besluit ingangsdatum/vervaldatum drive archival brondatum calculation via afleidingswijze `ingangsdatum_besluit` and `vervaldatum_besluit` +- **zgw-api-mapping** -- BRC API endpoint structure, field name translation (camelCase to snake_case), and URL-based resource references +- **audit-trail-immutable** -- Audit trail entries for besluit lifecycle events use the shared AuditTrailMapper infrastructure +- **roles-decisions (Procest)** -- Procest-side decision entity and decision type schemas; the `decision_maker` generic role determines who can create besluiten + +## Nextcloud Integration Analysis + +**Status**: Not yet implemented. No dedicated besluiten management, besluittype catalog, bezwaartermijn tracking, or publication workflow exists. Objects can reference each other and files can be linked, providing partial foundations. + +**Nextcloud Core Interfaces**: +- `INotifier` / `INotification`: Send notifications for bezwaartermijn expiration warnings (e.g., "5 days remaining for bezwaar on besluit X"), decision publication deadlines, and withdrawal actions. Register a `BesluitNotifier` implementing `INotifier` for formatted notification display. +- `IEventDispatcher`: Fire typed events (`BesluitCreatedEvent`, `BesluitPublishedEvent`, `BesluitWithdrawnEvent`, `BesluitExpiredEvent`) for cross-app integration. Procest and other consuming apps can listen for these events to update case status or trigger follow-up workflows. +- `TimedJob`: Schedule a `BezwaartermijnCheckJob` that runs daily, scanning besluiten with upcoming or expired `uiterlijkeReactiedatum` and triggering notifications or status updates. Schedule a `VervaldatumCheckJob` to detect naturally expired temporary decisions and set `vervalreden` to `tijdelijk`. +- `IActivityManager` / `IProvider`: Register decision lifecycle events (creation, publication, withdrawal, expiry) in the Nextcloud Activity stream so users see a chronological history of decision actions on their activity feed. + +**Implementation Approach**: +- Model besluiten and besluittypen as OpenRegister schemas within the Procest register. The `besluit` schema stores the decision data conforming to the ZGW BRC data model. The `besluittype` schema serves as the catalog defining decision types with reactietermijn and publicatieIndicatie. +- Use schema `$ref` properties for bidirectional zaak-besluit linking. When a besluit is created, the linked zaak object is updated with the besluit reference (via `ObjectService`). Implement a pre-save hook to maintain referential integrity when zaak references change. +- Implement bezwaartermijn calculation as a computed field or pre-save hook: `uiterlijkeReactiedatum = verzenddatum + besluittype.reactietermijn` (ISO 8601 duration parsing). +- For publication, leverage OpenRegister's existing public API access control. Mark published besluiten with a publication flag that makes them accessible via unauthenticated API endpoints. Implement a `RedactionHandler` that strips PII fields from the public view based on schema-level configuration (field-level annotation of sensitive fields). +- Use `FileService` for linking beschikking documents (PDF) to besluit objects, integrating with the document-zaakdossier spec for structured dossier views. +- Implement the BRC-compatible API layer as a separate controller that translates between ZGW BRC format (snake_case, URL references) and the internal OpenRegister object model (camelCase, UUID references). + +**Dependencies on Existing OpenRegister Features**: +- `ObjectService` -- CRUD for besluit and besluittype objects with inter-object references +- `SchemaService` / `SchemaMapper` -- schema definitions with `$ref` for zaak-besluit relationships +- `AuditTrailMapper` -- immutable logging of decision creation, publication, and withdrawal actions +- `FileService` -- document attachment for beschikking PDFs +- `HyperFacetHandler` -- faceted search and filtering for besluit lists +- Procest app -- owns the case context and decision type catalog configuration; the `decision_maker` role determines authorization for besluit creation diff --git a/openspec/changes/calendar-provider/specs/calendar-provider/spec.md b/openspec/changes/calendar-provider/specs/calendar-provider/spec.md new file mode 100644 index 000000000000..acb6d1232021 --- /dev/null +++ b/openspec/changes/calendar-provider/specs/calendar-provider/spec.md @@ -0,0 +1,382 @@ +--- +status: proposed +--- + +# Calendar Provider + +## Purpose + +OpenRegister SHALL implement `OCP\Calendar\ICalendarProvider` to surface objects with date properties as read-only calendar events in the Nextcloud Calendar app. This enables users to see case deadlines, publication dates, hearing schedules, and other time-based data directly in their calendar without manual event creation. + +**Key principle**: The calendar provider creates a *read-only projection* of object data. Objects remain the source of truth. Events are computed on-the-fly from object date fields, not stored as separate CalDAV items. + +**Standards**: OCP\Calendar\ICalendarProvider (NC 23+), OCP\Calendar\ICalendar (NC 13+), RFC 5545 (iCalendar VEVENT format) +**Cross-references**: [object-interactions](../../../specs/object-interactions/spec.md), [rbac-scopes](../../../specs/rbac-scopes/spec.md), [faceting-configuration](../../../specs/faceting-configuration/spec.md) + +--- + +## Requirements + +### Requirement: Calendar Provider Registration + +The application SHALL register an `ICalendarProvider` implementation via `IRegistrationContext::registerCalendarProvider()` during application bootstrap. This provider is called by the Nextcloud Calendar Manager when calendars are needed. + +#### Rationale + +Nextcloud's Calendar Manager lazily loads calendars from registered providers. By implementing `ICalendarProvider`, OpenRegister integrates into the native calendar infrastructure without modifying the Calendar app. Any app that queries calendars via `IManager` (Calendar, Dashboard widgets, search) will see OpenRegister events. + +#### Scenario: Provider is registered during app bootstrap +- **GIVEN** the OpenRegister app is installed and enabled +- **WHEN** Nextcloud initializes the application +- **THEN** `RegisterCalendarProvider` MUST be registered via `$context->registerCalendarProvider(RegisterCalendarProvider::class)` +- **AND** the provider MUST be available to `IManager::getCalendarsForPrincipal()` + +#### Scenario: Provider returns calendars for enabled schemas +- **GIVEN** 3 schemas exist: "Zaken" (calendar enabled), "Documenten" (calendar disabled), "Meldingen" (calendar enabled) +- **WHEN** `getCalendars('principals/users/admin')` is called +- **THEN** the provider MUST return exactly 2 `ICalendar` instances (for "Zaken" and "Meldingen") +- **AND** each calendar MUST have a unique key following the pattern `openregister-schema-{schemaId}` +- **AND** each calendar MUST have the display name and color from the schema's calendar configuration + +#### Scenario: Provider filters by calendar URIs when specified +- **GIVEN** schemas "Zaken" (URI: `openregister-schema-5`) and "Meldingen" (URI: `openregister-schema-8`) are calendar-enabled +- **WHEN** `getCalendars('principals/users/admin', ['openregister-schema-5'])` is called +- **THEN** the provider MUST return only the "Zaken" calendar +- **AND** the "Meldingen" calendar MUST NOT be returned + +#### Scenario: Provider returns empty array when no schemas are calendar-enabled +- **GIVEN** no schemas have `calendarProvider.enabled: true` in their configuration +- **WHEN** `getCalendars()` is called +- **THEN** the provider MUST return an empty array +- **AND** no errors MUST be thrown + +#### Scenario: Provider handles schema loading errors gracefully +- **GIVEN** a database error occurs while loading schemas +- **WHEN** `getCalendars()` is called +- **THEN** the provider MUST log the error as a warning +- **AND** return an empty array (not throw an exception) + +--- + +### Requirement: Virtual Calendar Implementation + +Each calendar-enabled schema SHALL produce an `ICalendar` implementation that translates object queries into VEVENT-compatible arrays. The calendar is read-only and does not support write operations. + +#### Rationale + +The Nextcloud Calendar app calls `ICalendar::search()` to retrieve events for display. By translating OpenRegister objects into the expected VEVENT array format, objects appear as native calendar events with full date, title, description, and location support. + +#### Scenario: Calendar returns correct metadata +- **GIVEN** a schema "Zaken" with ID 5 and calendar configuration `{"displayName": "Zaak Deadlines", "color": "#E64A19"}` +- **WHEN** the calendar's metadata methods are called +- **THEN** `getKey()` MUST return `"openregister-schema-5"` +- **AND** `getUri()` MUST return `"openregister-schema-5"` +- **AND** `getDisplayName()` MUST return `"Zaak Deadlines"` +- **AND** `getDisplayColor()` MUST return `"#E64A19"` +- **AND** `getPermissions()` MUST return `Constants::PERMISSION_READ` (read-only) +- **AND** `isDeleted()` MUST return `false` + +#### Scenario: Calendar uses schema title as fallback display name +- **GIVEN** a schema "Meldingen" with ID 8 and calendar configuration without `displayName` +- **WHEN** `getDisplayName()` is called +- **THEN** it MUST return `"Meldingen"` (the schema title) + +#### Scenario: Calendar uses default color when not configured +- **GIVEN** a schema with calendar configuration without `color` +- **WHEN** `getDisplayColor()` is called +- **THEN** it MUST return `"#0082C9"` (Nextcloud default blue) + +--- + +### Requirement: Object-to-Event Search and Transformation + +The virtual calendar's `search()` method SHALL query OpenRegister objects by date range and text pattern, then transform matching objects into VEVENT-compatible arrays. + +#### Rationale + +The Calendar app sends search requests with timerange options, text patterns, and pagination. The calendar must efficiently query objects using the existing MagicMapper infrastructure and return events in the standard Nextcloud format. + +#### Scenario: Search with timerange returns matching events +- **GIVEN** schema "Zaken" is calendar-enabled with `dtstart: "startdatum"` and `dtend: "einddatum"` +- **AND** 3 objects exist: + - Object A: startdatum=2026-03-20, einddatum=2026-03-25 + - Object B: startdatum=2026-04-01, einddatum=2026-04-15 + - Object C: startdatum=2026-05-01, einddatum=2026-05-10 +- **WHEN** `search('', [], ['timerange' => ['start' => 2026-03-01, 'end' => 2026-03-31]])` is called +- **THEN** only Object A MUST be returned +- **AND** the event MUST include: + - `id`: `"openregister-5-{objectA.uuid}"` + - `type`: `"VEVENT"` + - `calendar-key`: `"openregister-schema-5"` + - `objects[0].DTSTART`: the startdatum value with appropriate VALUE parameter + - `objects[0].DTEND`: the einddatum value with appropriate VALUE parameter + +#### Scenario: Search with text pattern filters by summary +- **GIVEN** schema "Zaken" with `titleTemplate: "{identificatie} - {omschrijving}"` +- **AND** Object A has identificatie="ZK-001", omschrijving="Dakkapel" +- **AND** Object B has identificatie="ZK-002", omschrijving="Aanbouw" +- **WHEN** `search('Dakkapel', ['SUMMARY'])` is called +- **THEN** only Object A MUST be returned as a VEVENT + +#### Scenario: Search without timerange returns all events +- **GIVEN** no timerange is specified in the options +- **WHEN** `search('')` is called +- **THEN** all objects with valid date values MUST be returned +- **AND** results MUST respect `$limit` and `$offset` for pagination + +#### Scenario: All-day events from date-only fields +- **GIVEN** schema configuration with `allDay: true` and `dtstart: "publicatiedatum"` +- **AND** an object with `publicatiedatum: "2026-03-25"` +- **WHEN** the object is transformed to a VEVENT +- **THEN** DTSTART MUST be `['20260325', ['VALUE' => 'DATE']]` +- **AND** DTEND MUST be `['20260326', ['VALUE' => 'DATE']]` (next day for all-day display) +- **AND** no time component MUST be included + +#### Scenario: DateTime events from datetime fields +- **GIVEN** schema configuration with `allDay: false` and `dtstart: "startdatum"`, `dtend: "einddatum"` +- **AND** an object with `startdatum: "2026-03-25T09:00:00Z"`, `einddatum: "2026-03-25T17:00:00Z"` +- **WHEN** the object is transformed to a VEVENT +- **THEN** DTSTART MUST be `['20260325T090000Z', ['VALUE' => 'DATE-TIME']]` +- **AND** DTEND MUST be `['20260325T170000Z', ['VALUE' => 'DATE-TIME']]` + +#### Scenario: Events without dtend configured use dtstart as single point +- **GIVEN** schema configuration with `dtstart: "deadline"` and no `dtend` configured +- **AND** an object with `deadline: "2026-04-01"` +- **WHEN** the object is transformed to a VEVENT +- **THEN** DTSTART MUST be set to the deadline date +- **AND** DTEND MUST be set to dtstart + 1 day (for all-day) or dtstart + 1 hour (for datetime) +- **AND** the event MUST display correctly in the Calendar app + +#### Scenario: Title template interpolation +- **GIVEN** schema configuration with `titleTemplate: "{identificatie} - {omschrijving}"` +- **AND** an object with data `{"identificatie": "ZK-2026-0142", "omschrijving": "Dakkapel Kerkstraat"}` +- **WHEN** the object is transformed to a VEVENT +- **THEN** SUMMARY MUST be `"ZK-2026-0142 - Dakkapel Kerkstraat"` + +#### Scenario: Title template with missing fields uses fallback +- **GIVEN** schema configuration with `titleTemplate: "{identificatie} - {omschrijving}"` +- **AND** an object with data `{"identificatie": "ZK-2026-0142"}` (no omschrijving field) +- **WHEN** the object is transformed to a VEVENT +- **THEN** SUMMARY MUST be `"ZK-2026-0142 - "` (empty placeholder replaced with empty string) +- **AND** the event MUST still be valid + +#### Scenario: Description template interpolation +- **GIVEN** schema configuration with `descriptionTemplate: "Status: {status}\nType: {zaaktype}"` +- **AND** an object with `status: "In behandeling"`, `zaaktype: "Omgevingsvergunning"` +- **WHEN** the object is transformed to a VEVENT +- **THEN** DESCRIPTION MUST be `"Status: In behandeling\nType: Omgevingsvergunning"` + +#### Scenario: Location field mapping +- **GIVEN** schema configuration with `locationField: "adres"` +- **AND** an object with `adres: "Kerkstraat 42, 5038 AB Tilburg"` +- **WHEN** the object is transformed to a VEVENT +- **THEN** LOCATION MUST be `"Kerkstraat 42, 5038 AB Tilburg"` + +#### Scenario: Objects with null/empty date fields are skipped +- **GIVEN** an object where the configured dtstart field is null or empty +- **WHEN** the object is encountered during a search +- **THEN** it MUST be silently skipped (not included in results) +- **AND** no error MUST be thrown + +#### Scenario: Event URL links back to OpenRegister +- **GIVEN** an object with UUID `abc-123` in register 5, schema 12 +- **WHEN** the object is transformed to a VEVENT +- **THEN** the URL property MUST be set to the OpenRegister object detail URL +- **AND** the format MUST be `/apps/openregister/#/objects/{register}/{schema}/{uuid}` + +#### Scenario: Events are marked as transparent +- **GIVEN** any object transformed to a VEVENT +- **WHEN** the TRANSP property is set +- **THEN** it MUST be `"TRANSPARENT"` (virtual events do not block free/busy time) + +#### Scenario: Events include OpenRegister category +- **GIVEN** any object transformed to a VEVENT +- **WHEN** the CATEGORIES property is set +- **THEN** it MUST include `"OpenRegister"` and the schema display name + +#### Scenario: Status mapping from object fields +- **GIVEN** schema configuration with `statusMapping: {"open": "CONFIRMED", "afgerond": "CANCELLED"}` +- **AND** an object with a status field value of `"afgerond"` +- **WHEN** the object is transformed to a VEVENT +- **THEN** STATUS MUST be `"CANCELLED"` + +#### Scenario: Default status when no mapping configured +- **GIVEN** schema configuration without `statusMapping` +- **WHEN** an object is transformed to a VEVENT +- **THEN** STATUS MUST default to `"CONFIRMED"` + +--- + +### Requirement: RBAC Enforcement on Calendar Queries + +The calendar provider SHALL enforce OpenRegister's authorization model. Users MUST only see events for objects they have read access to. + +#### Rationale + +OpenRegister supports row-level and schema-level RBAC. Calendar queries must respect these access controls to prevent information leakage through the Calendar app. + +#### Scenario: User sees only authorized objects as events +- **GIVEN** user `behandelaar-1` has read access to objects in register 5 but not register 8 +- **AND** both registers use schema "Zaken" (calendar-enabled) +- **WHEN** `search()` is called for `behandelaar-1`'s principal +- **THEN** only objects from register 5 MUST appear as events +- **AND** objects from register 8 MUST be filtered out + +#### Scenario: Admin user sees all objects as events +- **GIVEN** an admin user queries the calendar +- **WHEN** `search()` is called +- **THEN** all objects with valid date values MUST appear, regardless of register + +#### Scenario: Anonymous/public users see no virtual calendar events +- **GIVEN** an unauthenticated principal URI +- **WHEN** `getCalendars()` is called +- **THEN** the provider MUST return an empty array (no calendars for anonymous users) + +#### Scenario: RBAC changes are immediately reflected +- **GIVEN** user `behandelaar-1` previously had access to an object +- **WHEN** RBAC is updated to revoke access +- **AND** the calendar is queried again +- **THEN** the revoked object MUST no longer appear as an event +- **AND** no caching MUST prevent this update from taking effect + +--- + +### Requirement: Schema Calendar Configuration + +The schema's `configuration` JSON field SHALL include a `calendarProvider` section that controls how objects are projected as calendar events. Configuration is managed via the existing schema API. + +#### Rationale + +Different schemas represent different data types with different date semantics. A "Zaak" schema has start/end dates and a case identifier, while a "Publicatie" schema has a single publication date and a title. The configuration must be flexible enough to handle these variations. + +#### Configuration Schema + +```json +{ + "calendarProvider": { + "enabled": true, + "displayName": "string (optional, falls back to schema title)", + "color": "string (optional, CSS hex color, default #0082C9)", + "dtstart": "string (required when enabled, property name for event start)", + "dtend": "string (optional, property name for event end)", + "titleTemplate": "string (required when enabled, template with {property} placeholders)", + "descriptionTemplate": "string (optional, template with {property} placeholders)", + "locationField": "string (optional, property name for LOCATION)", + "allDay": "boolean (default: auto-detect from field format)", + "statusMapping": "object (optional, maps object field values to VEVENT STATUS values)", + "statusField": "string (optional, property name for status, used with statusMapping)" + } +} +``` + +#### Scenario: Enable calendar provider on a schema +- **GIVEN** an admin user and schema "Zaken" with ID 5 +- **WHEN** a PUT request updates the schema with: + ```json + { + "configuration": { + "calendarProvider": { + "enabled": true, + "dtstart": "startdatum", + "dtend": "einddatum", + "titleTemplate": "{identificatie} - {omschrijving}" + } + } + } + ``` +- **THEN** the schema configuration MUST be saved +- **AND** the next `getCalendars()` call MUST include a calendar for this schema + +#### Scenario: Disable calendar provider on a schema +- **GIVEN** schema "Zaken" has calendar provider enabled +- **WHEN** a PUT request updates with `calendarProvider.enabled: false` +- **THEN** the next `getCalendars()` call MUST NOT include a calendar for this schema + +#### Scenario: Validation of required fields when enabling +- **GIVEN** a schema update request with `calendarProvider.enabled: true` +- **WHEN** the `dtstart` field is missing from the configuration +- **THEN** the API MUST return HTTP 400 with `{"error": "calendarProvider.dtstart is required when calendar provider is enabled"}` + +#### Scenario: Validation of referenced property existence +- **GIVEN** a schema with properties `["startdatum", "einddatum", "titel"]` +- **WHEN** the calendar configuration references `dtstart: "deadline"` (not a schema property) +- **THEN** the API SHOULD log a warning but MUST NOT reject the configuration +- **AND** objects without the referenced field will be silently skipped during search + +#### Scenario: Auto-detect allDay from property format +- **GIVEN** schema property `startdatum` has format `date` (no time component) +- **AND** `allDay` is not explicitly set in the calendar configuration +- **WHEN** the calendar generates events +- **THEN** events MUST be rendered as all-day events (VALUE=DATE) + +#### Scenario: Auto-detect datetime from property format +- **GIVEN** schema property `begintijd` has format `date-time` +- **AND** `allDay` is not explicitly set +- **WHEN** the calendar generates events +- **THEN** events MUST be rendered as timed events (VALUE=DATE-TIME) + +--- + +### Requirement: Frontend Configuration UI + +A new tab SHALL be added to the schema detail view that allows administrators to configure the calendar provider settings via a visual form. + +#### Rationale + +Schema administrators need a user-friendly way to enable and configure calendar providers without manually editing JSON. The UI should show available date properties, provide template helpers, and show a preview. + +#### Scenario: Calendar provider tab appears on schema detail +- **GIVEN** an admin user viewing the schema detail page +- **WHEN** the schema detail tabs are rendered +- **THEN** a "Calendar" tab MUST be visible +- **AND** clicking it MUST show the calendar provider configuration form + +#### Scenario: Configuration form shows available properties +- **GIVEN** a schema with properties `startdatum` (date), `einddatum` (date), `titel` (string), `status` (string) +- **WHEN** the calendar provider tab is opened +- **THEN** the `dtstart` dropdown MUST show `startdatum` and `einddatum` as options +- **AND** the `dtend` dropdown MUST show the same date properties +- **AND** the `titleTemplate` field MUST show available placeholders: `{startdatum}`, `{einddatum}`, `{titel}`, `{status}` + +#### Scenario: Saving configuration updates schema +- **GIVEN** the admin fills in the calendar provider form and clicks "Save" +- **WHEN** the save action is triggered +- **THEN** a PUT request MUST be sent to `/api/schemas/{id}` with the updated configuration +- **AND** a success notification MUST be shown + +#### Scenario: Toggle to enable/disable calendar provider +- **GIVEN** the calendar provider tab is shown +- **WHEN** the admin toggles the "Enable calendar" switch +- **THEN** the form fields MUST be shown/hidden accordingly +- **AND** the enabled state MUST be saved as `calendarProvider.enabled` + +--- + +### Requirement: Performance and Scalability + +The calendar provider SHALL perform efficiently even with large numbers of objects, leveraging existing query infrastructure and respecting calendar query patterns. + +#### Scenario: Timerange queries use database filtering +- **GIVEN** a schema with 10,000 objects spanning 3 years +- **WHEN** the Calendar app queries a single month (timerange) +- **THEN** the MagicMapper query MUST include a SQL WHERE clause on the date column +- **AND** only objects within the timerange MUST be loaded from the database +- **AND** the response time MUST be under 2 seconds for typical schemas + +#### Scenario: Limit and offset are respected +- **GIVEN** 500 objects match a timerange query +- **WHEN** `search('', [], $options, limit: 50, offset: 0)` is called +- **THEN** only the first 50 events MUST be returned +- **AND** the MagicMapper query MUST use SQL LIMIT/OFFSET (not PHP array_slice) + +#### Scenario: Schema list is cached within request +- **GIVEN** the Calendar app calls `getCalendars()` multiple times in the same request +- **WHEN** schema data is loaded +- **THEN** schemas MUST be loaded from database only once per request +- **AND** subsequent calls MUST use the cached result + +#### Scenario: Disabled schemas are excluded at query level +- **GIVEN** 20 schemas exist, 3 have calendar provider enabled +- **WHEN** `getCalendars()` is called +- **THEN** only 3 schemas MUST be loaded/processed +- **AND** the SQL query MUST filter on the configuration JSON (or load all and filter in PHP if JSON queries are not supported) diff --git a/openspec/changes/computed-fields/specs/computed-fields/spec.md b/openspec/changes/computed-fields/specs/computed-fields/spec.md new file mode 100644 index 000000000000..bb16a9397e7b --- /dev/null +++ b/openspec/changes/computed-fields/specs/computed-fields/spec.md @@ -0,0 +1,508 @@ +--- +status: implemented +--- + +# Computed Fields + +## Purpose +Computed fields enable schema properties whose values are derived automatically from expressions evaluated against object data, cross-referenced objects, and aggregation functions. This capability eliminates redundant data entry, ensures consistency of derived values (full names, totals, expiry dates), and brings spreadsheet-like formula power to OpenRegister without requiring external workflow engines for simple calculations. Computed fields use Twig expressions evaluated server-side, leveraging the existing Twig infrastructure already integrated into OpenRegister for mapping and transformation. + +## Requirements + +### Requirement: Schema Property Computed Attribute Definition +Schema property definitions MUST support a `computed` object attribute that defines the expression, evaluation mode, and metadata for deriving field values. The `computed` attribute MUST contain an `expression` key (Twig template string) and MAY contain `evaluateOn` (default `save`), `description`, and `dependsOn` keys. The `computed` attribute MUST be stored as part of the schema property definition in the standard JSON Schema `properties` object, using a vendor extension pattern consistent with ADR-006. + +#### Scenario: Define a computed property with string concatenation +- **GIVEN** a schema `personen` with properties `voornaam` (string) and `achternaam` (string) +- **WHEN** a property `volledigeNaam` is defined with `computed.expression` set to `{{ voornaam }} {{ achternaam }}` +- **THEN** the schema MUST store the computed attribute alongside the property type definition +- **AND** the property MUST be treated as read-only by ValidationHandler during input validation + +#### Scenario: Define a computed property with numeric calculation +- **GIVEN** a schema `subsidies` with properties `bedrag` (number) and `btw_percentage` (number) +- **WHEN** a property `bedrag_incl_btw` is defined with `computed.expression` set to `{{ bedrag * (1 + btw_percentage / 100) }}` +- **THEN** the schema MUST accept the expression without validation errors +- **AND** ComputedFieldHandler MUST cast the result to a numeric type via `castResult()` + +#### Scenario: Define a computed property with date calculation +- **GIVEN** a schema `vergunningen` with property `ingangsdatum` (date) +- **WHEN** a property `vervaldatum` is defined with `computed.expression` set to `{{ ingangsdatum|date_modify('+1 year')|date('Y-m-d') }}` +- **THEN** the computed value MUST be evaluated using the allowed `date` and `date_modify` filters in the sandbox policy + +#### Scenario: Reject a computed attribute without an expression +- **GIVEN** a schema property defines `computed: {}` with no `expression` key +- **WHEN** ComputedFieldHandler iterates schema properties +- **THEN** the property MUST be skipped (not evaluated) because `expression` is empty + +#### Scenario: Computed attribute with explicit dependsOn declaration +- **GIVEN** a computed property `totaal` with `computed.dependsOn` set to `["bedrag", "korting"]` +- **WHEN** the schema is saved +- **THEN** the dependency list MUST be stored for use by circular dependency detection and cache invalidation + +### Requirement: Save-Time Evaluation +Computed fields configured with `evaluateOn: save` (the default) MUST be evaluated by ComputedFieldHandler during the SaveObject pipeline, and the resulting value MUST be persisted to the database. This ensures computed values are available for search indexing, filtering, and sorting without runtime overhead. + +#### Scenario: Compute and persist value on object creation +- **GIVEN** a computed field `volledigeNaam` with `evaluateOn: save` +- **WHEN** an object is created with `voornaam: "Jan"` and `achternaam: "de Vries"` +- **THEN** SaveObject MUST invoke `ComputedFieldHandler.evaluateComputedFields(data, schema, 'save')` before persistence +- **AND** the value `Jan de Vries` MUST be stored in the database +- **AND** subsequent reads MUST return the stored value without re-evaluation + +#### Scenario: Recompute value on object update +- **GIVEN** an existing object with computed `volledigeNaam` = `Jan de Vries` +- **WHEN** `achternaam` is updated to `van Dijk` +- **THEN** ComputedFieldHandler MUST re-evaluate the expression during the save pipeline +- **AND** `volledigeNaam` MUST be updated to `Jan van Dijk` + +#### Scenario: User-provided value for save-time computed field is overwritten +- **GIVEN** a computed field `bedrag_incl_btw` with `evaluateOn: save` +- **WHEN** the API request includes `bedrag_incl_btw: 99999` alongside `bedrag: 10000` and `btw_percentage: 21` +- **THEN** the user-provided value MUST be overwritten by the computed result `12100` + +#### Scenario: Save-time computed field is indexed by Solr +- **GIVEN** a schema with Solr indexing enabled and a computed field `volledigeNaam` with `evaluateOn: save` +- **WHEN** an object is saved +- **THEN** the computed value MUST be included in the Solr document because it is persisted to the database before indexing + +### Requirement: Read-Time Evaluation +Computed fields configured with `evaluateOn: read` MUST be evaluated by ComputedFieldHandler during the RenderObject pipeline. The computed value MUST NOT be stored in the database and MUST be calculated fresh on every API response. This mode is appropriate for volatile expressions such as `NOW()` or values that depend on frequently-changing referenced objects. + +#### Scenario: Compute value at read time +- **GIVEN** a computed field `dagen_resterend` with expression `{{ ((vervaldatum|date('U')) - ("now"|date('U'))) / 86400 }}` and `evaluateOn: read` +- **WHEN** an object is fetched via the API +- **THEN** RenderObject MUST invoke `ComputedFieldHandler.evaluateComputedFields(data, schema, 'read')` during rendering +- **AND** the API response MUST include the freshly computed value + +#### Scenario: Read-time computed field is NOT stored in the database +- **GIVEN** a computed field with `evaluateOn: read` +- **WHEN** an object is saved +- **THEN** the computed field MUST NOT appear in the persisted object data +- **AND** only when the object is rendered for API output MUST the value be calculated + +#### Scenario: Read-time computed field in bulk listing +- **GIVEN** a schema with a read-time computed field and 500 objects +- **WHEN** a list endpoint returns 50 objects per page +- **THEN** ComputedFieldHandler MUST evaluate expressions for all 50 objects in the response +- **AND** total evaluation time for the page SHOULD remain under 200ms + +#### Scenario: Read-time computed field is absent from search indexes +- **GIVEN** a computed field with `evaluateOn: read` +- **WHEN** objects are indexed to Solr or the database facet system +- **THEN** the read-time computed field MUST NOT be included in the index because it has no persisted value + +### Requirement: On-Demand Evaluation Mode +Computed fields configured with `evaluateOn: demand` MUST only be evaluated when explicitly requested via an API query parameter (e.g., `_computed=true` or `_fields=computedFieldName`). This mode is intended for expensive computations such as cross-register aggregations. + +#### Scenario: Demand-mode field excluded by default +- **GIVEN** a computed field `gemiddelde_score` with `evaluateOn: demand` +- **WHEN** an object is fetched via the API without `_computed=true` +- **THEN** the computed field MUST NOT appear in the response + +#### Scenario: Demand-mode field included when requested +- **GIVEN** a computed field `gemiddelde_score` with `evaluateOn: demand` +- **WHEN** an object is fetched with query parameter `_computed=true` +- **THEN** ComputedFieldHandler MUST evaluate the expression and include it in the response + +#### Scenario: Demand-mode field requested via _fields parameter +- **GIVEN** a computed field `gemiddelde_score` with `evaluateOn: demand` +- **WHEN** an object is fetched with `_fields=naam,gemiddelde_score` +- **THEN** only `naam` and the evaluated `gemiddelde_score` MUST appear in the response + +### Requirement: Cross-Field References Within the Same Object +Computed expressions MUST be able to reference any property of the same object by name. All non-computed properties of the object MUST be available as Twig variables in the expression context. Computed fields MUST be evaluated in dependency order so that a computed field MAY reference another computed field that has already been evaluated. + +#### Scenario: Reference multiple fields in one expression +- **GIVEN** a schema `facturen` with properties `aantal` (integer), `prijs_per_stuk` (number), and `korting` (number) +- **WHEN** a computed field `totaal` has expression `{{ (aantal * prijs_per_stuk) - korting }}` +- **THEN** all three source fields MUST be available in the Twig context +- **AND** the expression MUST evaluate correctly + +#### Scenario: Computed field references another computed field +- **GIVEN** computed field `subtotaal` with expression `{{ aantal * prijs_per_stuk }}` (order 1) +- **AND** computed field `totaal` with expression `{{ subtotaal - korting }}` (order 2) +- **WHEN** the object is saved with `aantal: 5`, `prijs_per_stuk: 100`, `korting: 50` +- **THEN** `subtotaal` MUST be evaluated first, yielding `500` +- **AND** `totaal` MUST be evaluated second, yielding `450` + +#### Scenario: Missing source property defaults to null +- **GIVEN** a computed expression `{{ optionele_toeslag|default(0) + bedrag }}` +- **WHEN** the object has no `optionele_toeslag` property set +- **THEN** the Twig `default` filter MUST provide `0` and the expression MUST evaluate without error + +### Requirement: Cross-Object Reference Lookups +Computed expressions MUST support referencing properties of related objects via the `_ref` namespace. When a schema property holds a UUID reference to another object, ComputedFieldHandler MUST resolve that reference and make the referenced object's data available under `_ref.propertyName` in the Twig context. Resolution MUST respect the MAX_REF_DEPTH constant (currently 3) to prevent unbounded lookups. + +#### Scenario: Lookup a property from a referenced object +- **GIVEN** schema `orders` with property `klant` (UUID reference to schema `klanten`) +- **AND** a computed property `klant_naam` with expression `{{ _ref.klant.naam }}` +- **WHEN** the order references a klant object with `naam: "Gemeente Utrecht"` +- **THEN** ComputedFieldHandler MUST resolve the klant UUID via MagicMapper.find() +- **AND** `klant_naam` MUST be computed as `Gemeente Utrecht` + +#### Scenario: Null reference returns empty data +- **GIVEN** a computed field referencing `{{ _ref.klant.naam }}` +- **WHEN** the `klant` property is null (no reference set) +- **THEN** `_ref.klant` MUST resolve to an empty array +- **AND** the expression MUST evaluate to an empty string (not throw an error) + +#### Scenario: Nested cross-reference within depth limit +- **GIVEN** an order references a klant, and the klant references an organisatie +- **AND** a computed field uses `{{ _ref.klant.organisatie_naam }}` +- **WHEN** the depth is within MAX_REF_DEPTH (3) +- **THEN** the reference chain MUST resolve successfully + +#### Scenario: Cross-reference exceeding MAX_REF_DEPTH +- **GIVEN** a reference chain deeper than MAX_REF_DEPTH (3 levels) +- **WHEN** ComputedFieldHandler attempts to resolve references +- **THEN** resolution MUST stop at the depth limit +- **AND** a warning MUST be logged: `[ComputedFieldHandler] Max reference resolution depth exceeded` +- **AND** unreachable references MUST resolve to empty arrays + +#### Scenario: Referenced object does not exist +- **GIVEN** a computed field references `{{ _ref.klant.naam }}` +- **AND** the klant UUID points to a deleted or non-existent object +- **WHEN** MagicMapper.find() throws DoesNotExistException +- **THEN** `_ref.klant` MUST resolve to an empty array +- **AND** the error MUST be logged at debug level + +### Requirement: Aggregation Functions Across Related Objects +Computed expressions MUST support aggregation over collections of related objects. When a property references an array of UUIDs (one-to-many relation), the system MUST resolve all referenced objects and provide aggregation functions (SUM, COUNT, AVG, MIN, MAX) as Twig functions or filters. + +#### Scenario: COUNT of related objects +- **GIVEN** schema `projecten` with property `taken` (array of UUID references to schema `taken`) +- **AND** a computed field `aantal_taken` with expression `{{ taken|length }}` +- **WHEN** `taken` contains 5 UUIDs +- **THEN** `aantal_taken` MUST be computed as `5` + +#### Scenario: SUM of a property across related objects +- **GIVEN** a computed field `totaal_uren` with expression `{{ _ref_list.taken|map(t => t.uren)|reduce((carry, v) => carry + v, 0) }}` +- **WHEN** the referenced taken have uren values `[8, 4, 6, 2]` +- **THEN** `totaal_uren` MUST be computed as `20` + +#### Scenario: AVG of a property across related objects +- **GIVEN** a computed field `gemiddelde_score` with expression `{{ _ref_list.beoordelingen|map(b => b.score)|reduce((c, v) => c + v, 0) / (_ref_list.beoordelingen|length) }}` +- **WHEN** scores are `[8, 7, 9]` +- **THEN** `gemiddelde_score` MUST be computed as `8` + +#### Scenario: Empty collection returns zero for aggregation +- **GIVEN** a computed field aggregating over `_ref_list.taken` +- **WHEN** the `taken` array is empty +- **THEN** COUNT MUST return `0` +- **AND** SUM MUST return `0` +- **AND** AVG MUST return `0` (not division by zero) + +### Requirement: String, Date, and Math Operations +The Twig sandbox security policy MUST allow a curated set of filters and functions for common string, date, and mathematical operations. The allowed operations MUST cover the most common use cases identified in competitive analysis (NocoDB provides 65 functions; OpenRegister targets the 80/20 set via Twig's built-in capabilities). + +#### Scenario: String operations +- **GIVEN** allowed Twig filters include `upper`, `lower`, `trim`, `split`, `join`, `slice`, `first`, `last`, `replace`, `format`, `length` +- **WHEN** a computed expression uses `{{ voornaam|upper }}` +- **THEN** the expression MUST evaluate successfully within the sandbox + +#### Scenario: Date operations +- **GIVEN** allowed Twig filters include `date`, `date_modify` +- **WHEN** a computed expression uses `{{ ingangsdatum|date_modify('+6 months')|date('Y-m-d') }}` +- **THEN** the date arithmetic MUST be performed correctly + +#### Scenario: Math operations +- **GIVEN** allowed Twig functions include `max`, `min`, `range` +- **AND** allowed filters include `abs`, `round`, `number_format` +- **WHEN** a computed expression uses `{{ (bedrag * 1.21)|round(2) }}` +- **THEN** the result MUST be rounded to 2 decimal places + +#### Scenario: Conditional logic using Twig ternary +- **GIVEN** a computed expression `{{ status == 'actief' ? 'Ja' : 'Nee' }}` +- **WHEN** `status` is `actief` +- **THEN** the result MUST be `Ja` + +#### Scenario: Disallowed filter is blocked by sandbox +- **GIVEN** a computed expression attempts to use a filter not in the security policy (e.g., `{{ data|raw }}`) +- **WHEN** the expression is evaluated +- **THEN** the Twig SandboxExtension MUST throw a SecurityError +- **AND** ComputedFieldHandler MUST catch the error, log a warning, and return null + +### Requirement: Error Handling for Invalid Expressions +Expression evaluation errors MUST NOT prevent object save or read operations. ComputedFieldHandler MUST catch all Throwable exceptions during evaluation, log a structured warning, and return null for the computed field. The object MUST still be saved or returned successfully with the computed field set to null. + +#### Scenario: Division by zero +- **GIVEN** a computed expression `{{ total / count }}` +- **WHEN** `count` is `0` +- **THEN** the computed value MUST be null +- **AND** a warning MUST be logged with context including `propertyName`, `expression`, and the error message +- **AND** the object MUST still be saved/returned successfully + +#### Scenario: Reference to non-existent property +- **GIVEN** a computed expression `{{ nonExistentField * 2 }}` +- **WHEN** `nonExistentField` is not present in the object data +- **THEN** Twig MUST treat it as null +- **AND** the computed value MUST be null or an empty string + +#### Scenario: Syntax error in Twig expression +- **GIVEN** a computed expression `{{ bedrag * }}` +- **WHEN** the expression is compiled by Twig +- **THEN** a Twig SyntaxError MUST be caught +- **AND** the computed value MUST be null +- **AND** a warning MUST be logged with the syntax error details + +#### Scenario: Type mismatch in expression +- **GIVEN** a computed expression `{{ naam * 2 }}` where `naam` is a string +- **WHEN** the expression is evaluated +- **THEN** Twig MUST handle the type mismatch +- **AND** ComputedFieldHandler MUST return null and log the error + +#### Scenario: Error in one computed field does not affect others +- **GIVEN** a schema with computed fields `a` (valid expression) and `b` (invalid expression) +- **WHEN** both fields are evaluated during save +- **THEN** field `a` MUST compute successfully +- **AND** field `b` MUST be null due to the error +- **AND** the object MUST still be saved with `a`'s computed value and `b` as null + +### Requirement: Circular Dependency Detection +The system MUST detect circular dependencies between computed fields before evaluation and MUST refuse to evaluate fields involved in cycles. A computed field that depends on itself (directly or transitively) MUST produce a null value and a logged error. + +#### Scenario: Direct self-reference +- **GIVEN** a computed field `a` with expression `{{ a + 1 }}` +- **WHEN** ComputedFieldHandler evaluates the field +- **THEN** the field MUST NOT enter an infinite loop +- **AND** the value MUST be null +- **AND** a warning MUST be logged: circular dependency detected + +#### Scenario: Indirect circular reference (A depends on B, B depends on A) +- **GIVEN** computed field `a` with expression `{{ b * 2 }}` and computed field `b` with expression `{{ a + 1 }}` +- **WHEN** the evaluation order is determined +- **THEN** the system MUST detect the cycle +- **AND** both fields MUST evaluate to null +- **AND** a warning MUST be logged identifying the cycle + +#### Scenario: Valid dependency chain is not flagged +- **GIVEN** computed field `subtotaal` depends on `aantal` and `prijs`, and `totaal` depends on `subtotaal` +- **WHEN** dependency analysis runs +- **THEN** no circular dependency MUST be detected +- **AND** evaluation MUST proceed in topological order: `subtotaal` first, then `totaal` + +### Requirement: Performance and Caching +Computed field evaluation MUST NOT significantly degrade API response times. For `evaluateOn: read` fields, the system SHOULD use Nextcloud's ICacheFactory to memoize computed values based on object data hash. For `evaluateOn: save` fields, no runtime evaluation cost exists since values are pre-computed. Template compilation MUST be cached within the request lifecycle to avoid redundant Twig parsing. + +#### Scenario: Twig template compilation caching within request +- **GIVEN** a schema with 3 computed fields sharing similar expressions +- **WHEN** ComputedFieldHandler evaluates all 3 fields for one object +- **THEN** each unique expression MUST be compiled once (keyed by `md5(expression)`) +- **AND** subsequent evaluations of the same expression MUST reuse the compiled template + +#### Scenario: APCu memoization for read-time computed fields +- **GIVEN** a computed field with `evaluateOn: read` and a deterministic expression +- **WHEN** the same object is fetched twice within the cache TTL +- **THEN** the second fetch SHOULD return the memoized value from ICacheFactory without re-evaluation +- **AND** the cache key MUST include the object UUID and data hash to invalidate on changes + +#### Scenario: Bulk evaluation performance target +- **GIVEN** a list endpoint returning 100 objects, each with 3 read-time computed fields +- **WHEN** ComputedFieldHandler evaluates all 300 expressions +- **THEN** total evaluation time SHOULD remain under 500ms for simple expressions (concatenation, arithmetic) + +#### Scenario: Cross-reference resolution is the performance bottleneck +- **GIVEN** a computed field that uses `_ref` to look up a related object +- **WHEN** 50 objects each reference a different klant +- **THEN** ComputedFieldHandler MUST issue at most 50 database queries (one per unique reference) +- **AND** the system SHOULD batch or cache reference lookups within a single request + +### Requirement: Computed Fields as Read-Only in the API +Computed properties MUST be exposed in API responses as regular fields but MUST be marked as `readOnly` in the OpenAPI specification. Any user-provided values for `evaluateOn: save` computed fields MUST be silently overwritten by the computed result. For `evaluateOn: read` fields, user-provided values MUST be ignored entirely since they are not persisted. + +#### Scenario: Computed field appears in API response +- **GIVEN** a computed field `volledigeNaam` with `evaluateOn: save` +- **WHEN** an object is fetched via `GET /api/objects/{register}/{schema}/{id}` +- **THEN** the response MUST include `volledigeNaam` with its computed value +- **AND** the OpenAPI schema MUST declare `volledigeNaam` as `readOnly: true` + +#### Scenario: Computed field in list response +- **GIVEN** a schema with computed fields +- **WHEN** objects are listed via `GET /api/objects/{register}/{schema}` +- **THEN** all computed fields (save-time and read-time) MUST appear in each object's data + +#### Scenario: ValidationHandler skips computed fields during input validation +- **GIVEN** a computed field `bedrag_incl_btw` +- **WHEN** a POST or PUT request does not include `bedrag_incl_btw` +- **THEN** ValidationHandler MUST NOT flag it as a missing required field +- **AND** the computed value MUST be populated by ComputedFieldHandler + +### Requirement: Computed Fields in the UI +Computed properties MUST be displayed as read-only fields in the object edit form. They MUST be visually distinguished from editable fields to prevent user confusion. The UI MUST show the current computed value and update it after save operations. + +#### Scenario: Display computed field in edit form +- **GIVEN** a computed property `volledigeNaam` +- **WHEN** the user views the object edit form +- **THEN** `volledigeNaam` MUST be displayed as a read-only field with visual distinction (e.g., gray background, lock icon) +- **AND** the field MUST NOT be editable + +#### Scenario: Computed field updates after save +- **GIVEN** the user changes `achternaam` from `de Vries` to `van Dijk` in the edit form +- **WHEN** the user saves the object +- **THEN** the response MUST include the recomputed `volledigeNaam: "Jan van Dijk"` +- **AND** the UI MUST display the updated value + +#### Scenario: Computed field tooltip shows expression +- **GIVEN** a computed property with `computed.description: "Voornaam + achternaam"` +- **WHEN** the user hovers over the computed field +- **THEN** a tooltip SHOULD display the description explaining how the value is derived + +### Requirement: Custom Twig Function Registration +Developers MUST be able to register custom Twig functions and filters for use in computed expressions via the existing MappingExtension infrastructure. Custom functions MUST be added to the sandbox security policy's allowed list. The system MUST NOT require a separate extension registry for computed fields; it MUST reuse the MappingExtension that already provides filters like `b64enc`, `json_decode`, `zgw_enum` and functions like `executeMapping`, `generateUuid`. + +#### Scenario: Register a custom filter via MappingExtension +- **GIVEN** a developer adds a new filter `format_postcode` to MappingExtension +- **AND** the filter is added to the sandbox SecurityPolicy's allowed filters list in ComputedFieldHandler +- **WHEN** a computed expression uses `{{ postcode|format_postcode }}` +- **THEN** the custom filter MUST be invoked and its return value used as the computed result + +#### Scenario: Custom function not in sandbox policy is blocked +- **GIVEN** a Twig function `dangerousFunction` is registered in MappingExtension but NOT added to the sandbox policy +- **WHEN** a computed expression uses `{{ dangerousFunction() }}` +- **THEN** the sandbox MUST block execution +- **AND** a SecurityError MUST be caught and logged + +#### Scenario: Built-in mapping functions available in computed context +- **GIVEN** the existing `generateUuid` function is in the sandbox allowed list +- **WHEN** a computed expression uses `{{ generateUuid() }}` +- **THEN** the function MUST generate and return a valid UUID + +### Requirement: Migration When Formula Changes +When a computed field's expression is modified on a schema, all existing objects with `evaluateOn: save` MUST be recalculated. The system MUST support batch recalculation via a Nextcloud background job (IJobList) to avoid blocking schema update requests. For `evaluateOn: read` fields, no migration is needed since values are computed fresh on every read. + +#### Scenario: Expression change triggers batch recalculation job +- **GIVEN** a schema with 10,000 objects and a save-time computed field `volledigeNaam` +- **WHEN** an admin changes the expression from `{{ voornaam }} {{ achternaam }}` to `{{ achternaam }}, {{ voornaam }}` +- **THEN** the schema update MUST succeed immediately +- **AND** a Nextcloud QueuedJob MUST be enqueued to recalculate `volledigeNaam` for all 10,000 objects +- **AND** the job MUST process objects in batches to avoid memory exhaustion + +#### Scenario: New computed field added to existing schema +- **GIVEN** a schema with 500 existing objects +- **WHEN** a new computed field `initialen` with `evaluateOn: save` is added +- **THEN** a background job MUST compute `initialen` for all 500 existing objects +- **AND** objects fetched before the job completes MUST show null for `initialen` + +#### Scenario: Computed field removed from schema +- **GIVEN** a schema with a computed field `volledigeNaam` stored on 1,000 objects +- **WHEN** the `computed` attribute is removed from the property definition +- **THEN** existing stored values MUST remain in the object data (no destructive cleanup) +- **AND** the field MUST become a regular editable field + +### Requirement: Audit Trail for Computed Values +Changes to computed field values MUST be tracked in the audit trail just like manually-entered values. The audit trail MUST record the previous and new computed values, and MUST indicate that the change was system-generated (by the computed field engine) rather than user-initiated. + +#### Scenario: Computed value change recorded in audit trail +- **GIVEN** an object with computed `volledigeNaam: "Jan de Vries"` +- **WHEN** `achternaam` is updated to `van Dijk`, causing `volledigeNaam` to recompute to `"Jan van Dijk"` +- **THEN** the audit trail entry MUST include the change from `"Jan de Vries"` to `"Jan van Dijk"` for `volledigeNaam` +- **AND** the change source MUST be marked as `computed` (not `user`) + +#### Scenario: Batch recalculation audit trail +- **GIVEN** a formula change triggers batch recalculation of 100 objects +- **WHEN** the background job processes each object +- **THEN** each object MUST receive an audit trail entry for the computed field change +- **AND** the audit trail MUST reference the schema change that triggered the recalculation + +#### Scenario: Read-time computed fields are NOT audited +- **GIVEN** a computed field with `evaluateOn: read` +- **WHEN** the computed value changes because source data changed +- **THEN** no audit trail entry MUST be created for the read-time computed field (since it is never persisted) + +### Requirement: Import and Export Behavior +During data import, computed field values in the import payload MUST be ignored for `evaluateOn: save` fields (they will be recomputed). During export, computed field values MUST be included in the exported data with a metadata indicator that they are computed. + +#### Scenario: Import ignores computed field values +- **GIVEN** a CSV import contains a column `volledigeNaam` matching a computed field +- **WHEN** ImportService processes the row +- **THEN** the imported value for `volledigeNaam` MUST be discarded +- **AND** ComputedFieldHandler MUST compute the value from `voornaam` and `achternaam` + +#### Scenario: Export includes computed field values +- **GIVEN** a schema with computed field `bedrag_incl_btw` with `evaluateOn: save` +- **WHEN** objects are exported via the API +- **THEN** the export MUST include `bedrag_incl_btw` with its computed value +- **AND** export metadata SHOULD indicate which fields are computed + +#### Scenario: Import with missing source fields for computed expression +- **GIVEN** a computed field depends on `voornaam` and `achternaam` +- **WHEN** an import row has `voornaam: "Piet"` but no `achternaam` +- **THEN** the computed field MUST evaluate with `achternaam` as null/empty +- **AND** `volledigeNaam` MUST be computed as `Piet ` (trailing space from expression) + +### Requirement: Interaction with Schema Hooks +Computed field evaluation MUST occur BEFORE schema hooks fire on `creating` and `updating` events. This ensures that hook workflows receive the fully-computed object data. Schema hooks (as defined in the schema-hooks spec) MAY further modify computed field values via their `modified` response status. + +#### Scenario: Hook receives computed values +- **GIVEN** a schema with a save-time computed field `volledigeNaam` and a sync hook on `creating` +- **WHEN** an object is created +- **THEN** ComputedFieldHandler MUST evaluate `volledigeNaam` BEFORE HookExecutor dispatches the `creating` event +- **AND** the CloudEvent payload's `data.object` MUST include the computed `volledigeNaam` value + +#### Scenario: Hook modifies a computed value +- **GIVEN** a sync hook on `creating` returns `{"status": "modified", "data": {"volledigeNaam": "Dr. Jan de Vries"}}` +- **WHEN** the hook response is processed +- **THEN** the modified value MUST override the computed value +- **AND** the object MUST be saved with `volledigeNaam: "Dr. Jan de Vries"` + +#### Scenario: Async hook on created event receives computed values +- **GIVEN** an async hook on the `created` event +- **WHEN** the object is saved with computed fields +- **THEN** the CloudEvent payload MUST include all computed field values as they were saved + +## Current Implementation Status +- **Implemented:** + - `ComputedFieldHandler` (`lib/Service/Object/SaveObject/ComputedFieldHandler.php`) provides Twig-based expression evaluation with sandbox security policy + - Save-time evaluation integrated into SaveObject pipeline (line ~3551) + - Read-time evaluation integrated into RenderObject pipeline (line ~1041) + - Cross-reference resolution via `_ref` namespace with MAX_REF_DEPTH=3 + - Sandboxed Twig environment with SecurityPolicy restricting allowed tags, filters, and functions + - Graceful error handling (catch all Throwable, log warning, return null) + - Result type casting (numeric strings to int/float) + - `hasComputedProperties()` and `getComputedPropertyNames()` utility methods +- **NOT implemented:** + - `evaluateOn: demand` mode (on-demand evaluation via API parameter) + - Circular dependency detection between computed fields + - Dependency-ordered evaluation (topological sort) + - Aggregation functions for collections of related objects (`_ref_list`) + - APCu memoization for read-time computed values via ICacheFactory + - Batch recalculation background job when formula changes + - Audit trail entries marked as `computed` source + - Import/export awareness of computed fields + - UI rendering as read-only with visual distinction + - `dependsOn` metadata on computed attribute + +## Standards & References +- **JSON Schema** -- Property definitions extended with `computed` attribute (vendor extension) +- **Twig 3.x** -- Template engine for expression evaluation with SandboxExtension for security +- **OpenAPI 3.0** -- `readOnly` property attribute for computed fields in API spec +- **JSON Schema `readOnly`** -- Standard way to mark fields as not user-writable +- **ADR-001** -- All data via OpenRegister; computed fields are part of the schema-driven data layer +- **ADR-006** -- Schema standards; computed attribute extends property definitions consistently +- **ADR-008** -- Backend layering; ComputedFieldHandler is a Service-layer component called by SaveObject and RenderObject +- **Related specs:** schema-hooks (hook execution order relative to computed fields), event-driven-architecture (CloudEvents include computed values) + +## Specificity Assessment +- The spec is well-defined with clear scenarios for each evaluation mode and edge case. +- The ComputedFieldHandler implementation already covers the core save/read evaluation, cross-reference resolution, sandbox security, and error handling. +- Missing: circular dependency detection, topological sort for evaluation order, demand-mode evaluation, aggregation over collections, batch recalculation jobs, import/export awareness, UI rendering. +- Open questions: + - Should the `_ref_list` syntax for collection aggregation be a distinct resolver or share the existing `resolveReferences()` method? + - What is the maximum number of computed fields per schema before performance degrades? + - Should computed field expressions be validated at schema-save time (pre-compilation check)? + +## Nextcloud Integration Analysis + +**Status**: PARTIALLY IMPLEMENTED + +**What Exists**: ComputedFieldHandler is fully integrated into both SaveObject (save-time evaluation) and RenderObject (read-time evaluation). The Twig sandbox uses SecurityPolicy to restrict allowed filters and functions. Cross-reference resolution uses MagicMapper for related object lookups with depth limiting. Error handling catches all Throwable exceptions and logs warnings. The existing MappingExtension provides custom Twig filters (b64enc, json_decode, zgw_enum, etc.) and functions (generateUuid, executeMapping) that are available in computed expressions. + +**Gap Analysis**: No demand-mode evaluation, no circular dependency detection, no dependency-ordered evaluation, no collection aggregation (_ref_list), no ICacheFactory memoization for read-time fields, no background batch recalculation when formulas change, no audit trail awareness of computed changes, no import/export handling, and no UI read-only rendering. + +**Nextcloud Core Integration Points**: +- **IJobList (Background Jobs)**: Register a `QueuedJob` for batch recalculation when a computed field expression changes. Process objects in configurable batch sizes to avoid memory exhaustion. +- **ICacheFactory**: Use `createDistributed('openregister_computed')` for memoizing read-time computed values. Cache key: `{objectUuid}_{expressionHash}_{dataHash}`. TTL configurable per schema. +- **IEventDispatcher**: Listen to schema update events to detect computed field expression changes and trigger recalculation jobs. +- **Twig SandboxExtension**: Already integrated in ComputedFieldHandler with a curated SecurityPolicy. + +**Recommendation**: The core evaluation engine is solid. Next priorities should be: (1) circular dependency detection and topological sort for evaluation order, (2) `_ref_list` collection resolution for aggregation use cases, (3) ICacheFactory memoization for read-time fields, (4) batch recalculation background job. The demand-mode and UI rendering are lower priority since the save/read modes cover most use cases. diff --git a/openspec/changes/contacts-actions/specs/contacts-actions/spec.md b/openspec/changes/contacts-actions/specs/contacts-actions/spec.md new file mode 100644 index 000000000000..0a67a1bb4017 --- /dev/null +++ b/openspec/changes/contacts-actions/specs/contacts-actions/spec.md @@ -0,0 +1,261 @@ +--- +status: draft +--- + +# Contacts Actions + +## Purpose + +Bridge Nextcloud's Contacts/CardDAV ecosystem with OpenRegister entity data by providing a ContactsMenu provider that matches contact persons to OpenRegister entities (persons, organizations) and injects contextual actions. When a user clicks on a contact name anywhere in Nextcloud (the contacts menu popup, the Contacts app, or any app that uses the contacts menu), the provider SHALL look up matching OpenRegister entities by email address, display name, and organization field, then add action links (e.g., "View Cases", "Create Lead") sourced from the action registry. A shared `ContactMatchingService` provides reusable entity matching with APCu caching, also consumed by the `mail-sidebar` change. + +**Source**: Case handlers, CRM users, and records managers need to see OpenRegister context (cases, leads, documents) when interacting with contacts in Nextcloud. Without this integration, users must manually switch to OpenRegister and search by email or name, breaking workflow continuity. + +## Requirements + +### Requirement: OpenRegister MUST register a ContactsMenu provider + +The app MUST implement `OCP\Contacts\ContactsMenu\IProvider` as `ContactsMenuProvider` and register it in `Application::register()` via `$context->registerContactsMenuProvider()`. The provider SHALL process contact entries, match them to OpenRegister entities, and add action links to the contacts menu popup. + +#### Scenario: Provider is registered and processes contact entries +- **GIVEN** the OpenRegister app is enabled +- **WHEN** a user clicks on a contact name in Nextcloud (e.g., in the top-bar contacts menu or in the Contacts app) +- **THEN** the `ContactsMenuProvider::process()` method SHALL be called with the `IEntry` object +- **AND** the provider SHALL extract the contact's email address(es), full name, and organization from the entry +- **AND** the provider SHALL call `ContactMatchingService::matchContact()` with the extracted metadata + +#### Scenario: Provider registration in Application +- **GIVEN** the `Application::register()` method in `lib/AppInfo/Application.php` +- **WHEN** the app boots +- **THEN** `$context->registerContactsMenuProvider(ContactsMenuProvider::class)` SHALL be called +- **AND** the provider SHALL be injectable via Nextcloud DI with constructor injection of `ContactMatchingService`, `DeepLinkRegistryService`, `IURLGenerator`, `IL10N`, and `LoggerInterface` + +### Requirement: ContactMatchingService MUST match contacts to OpenRegister entities + +A shared `ContactMatchingService` SHALL match contact metadata (email, name, organization) to OpenRegister objects across all registers and schemas. The service is the core matching engine used by both the contacts-actions provider and the mail-sidebar integration. + +#### Scenario: Match by email address +- **GIVEN** a contact with email address `jan.devries@gemeente.nl` +- **AND** an OpenRegister object in schema "Medewerkers" has a property `email` with value `jan.devries@gemeente.nl` +- **WHEN** `ContactMatchingService::matchByEmail('jan.devries@gemeente.nl')` is called +- **THEN** the service SHALL search across all registers and schemas for objects with email-type properties matching the given address (case-insensitive) +- **AND** it SHALL return an array of matched objects with their register, schema, and object metadata + +#### Scenario: Match by display name +- **GIVEN** a contact with display name `Jan de Vries` +- **AND** an OpenRegister object in schema "Personen" has properties `voornaam: Jan` and `achternaam: de Vries` +- **WHEN** `ContactMatchingService::matchByName('Jan de Vries')` is called +- **THEN** the service SHALL search for objects with name-type properties that fuzzy-match the given display name +- **AND** the matching SHALL be secondary to email matching (email is the primary key) + +#### Scenario: Match by organization +- **GIVEN** a contact with organization field `Gemeente Tilburg` +- **AND** an OpenRegister object in schema "Organisaties" has a property `naam` with value `Gemeente Tilburg` +- **WHEN** `ContactMatchingService::matchByOrganization('Gemeente Tilburg')` is called +- **THEN** the service SHALL search for organization-type objects matching the given organization name +- **AND** the results SHALL be returned alongside person matches, tagged with match type `organization` + +#### Scenario: Combined matching via matchContact +- **GIVEN** a contact entry with email `jan@example.nl`, name `Jan de Vries`, and organization `Gemeente Tilburg` +- **WHEN** `ContactMatchingService::matchContact(email: 'jan@example.nl', name: 'Jan de Vries', organization: 'Gemeente Tilburg')` is called +- **THEN** the service SHALL execute email matching first (highest confidence) +- **AND** then name matching (medium confidence) +- **AND** then organization matching (lowest confidence) +- **AND** results SHALL be deduplicated by object UUID +- **AND** each result SHALL include a `matchType` field (`email`, `name`, `organization`) and a `confidence` score + +#### Scenario: No matches found +- **GIVEN** a contact with email `unknown@nowhere.test` +- **WHEN** `ContactMatchingService::matchContact()` is called +- **THEN** it SHALL return an empty array +- **AND** the contacts menu SHALL display no OpenRegister actions for this contact + +### Requirement: APCu caching MUST be used for entity lookups + +The `ContactMatchingService` MUST cache entity lookup results in APCu to ensure the contacts menu popup renders within the 200ms performance budget. + +#### Scenario: Cache hit for repeated email lookup +- **GIVEN** a previous call to `matchByEmail('jan@example.nl')` returned 3 matches +- **AND** the cache TTL (60 seconds) has not expired +- **WHEN** `matchByEmail('jan@example.nl')` is called again +- **THEN** the service SHALL return the cached result without querying the database +- **AND** the response time SHALL be under 10ms + +#### Scenario: Cache miss triggers database query +- **GIVEN** no cached result exists for `info@bedrijf.nl` +- **WHEN** `matchByEmail('info@bedrijf.nl')` is called +- **THEN** the service SHALL query OpenRegister objects via `ObjectService::searchObjects()` +- **AND** the result SHALL be stored in APCu with key prefix `or_contact_match_` and TTL 60 seconds + +#### Scenario: Cache invalidation on object save +- **GIVEN** an OpenRegister object with email `jan@example.nl` is updated +- **WHEN** `ObjectService::saveObject()` completes +- **THEN** the service SHALL invalidate the APCu cache entry for `jan@example.nl` +- **AND** the next lookup SHALL fetch fresh data from the database + +### Requirement: Actions MUST be injected from the action registry + +The `ContactsMenuProvider` MUST query the action registry for actions with `context: "contact"` and add them as `ILinkAction` entries to the contact's menu popup. Each action SHALL resolve its URL template with contact-specific placeholders. + +#### Scenario: Action links appear in contacts menu +- **GIVEN** the action registry contains an action with `context: "contact"`, `label: "Bekijk zaken"`, and `url: "/apps/procest/#/zaken?contact={contactEmail}"` +- **AND** the contact's email is `jan@example.nl` +- **WHEN** the contacts menu is rendered for this contact +- **THEN** an `ILinkAction` SHALL be added with: + - `setName('Bekijk zaken')` + - `setHref('/apps/procest/#/zaken?contact=jan@example.nl')` + - `setIcon(...)` using the action's configured icon + - `setPriority(10)` + +#### Scenario: URL template placeholder resolution +- **GIVEN** an action URL template `"/apps/openregister/#/objects?email={contactEmail}&name={contactName}&entity={entityId}"` +- **AND** the contact has email `jan@example.nl`, name `Jan de Vries`, and a matched entity with UUID `550e8400-e29b-41d4-a716-446655440000` +- **WHEN** the URL template is resolved +- **THEN** the placeholders `{contactEmail}`, `{contactName}`, and `{entityId}` SHALL be replaced with URL-encoded values +- **AND** `{contactId}` SHALL resolve to the contact's UID from the vCard if available + +#### Scenario: No actions registered for contact context +- **GIVEN** no actions exist in the registry with `context: "contact"` +- **WHEN** the contacts menu is rendered +- **THEN** only the entity count badge SHALL be shown (if matches exist) +- **AND** a default "View in OpenRegister" action SHALL be added linking to the matched entity's detail page + +#### Scenario: Multiple matched entities produce multiple action sets +- **GIVEN** a contact matches 2 OpenRegister entities (one person, one organization) +- **AND** there are 2 actions registered for `context: "contact"` +- **WHEN** actions are injected +- **THEN** each action SHALL be resolved for each matched entity separately +- **AND** the action label SHALL include the entity context (e.g., "Bekijk zaken (Jan de Vries)" and "Bekijk zaken (Gemeente Tilburg)") + +### Requirement: Entity count badges MUST be shown in the contacts menu + +When a contact matches OpenRegister entities, the provider MUST add a summary action showing the count of related objects grouped by schema type. + +#### Scenario: Count badge for matched contact +- **GIVEN** a contact matches entities that are related to 3 cases, 1 lead, and 5 documents across different schemas +- **WHEN** the contacts menu popup is rendered +- **THEN** an `ILinkAction` SHALL be added with a summary label like `"3 zaken, 1 lead, 5 documenten"` +- **AND** the action SHALL link to an OpenRegister search filtered by the contact's email +- **AND** the action's priority SHALL be higher than individual action links (renders first) + +#### Scenario: No matches produce no badge +- **GIVEN** a contact has no matching OpenRegister entities +- **WHEN** the contacts menu popup is rendered +- **THEN** no count badge or OpenRegister actions SHALL be added +- **AND** the contacts menu SHALL render normally without OpenRegister interference + +### Requirement: A REST API endpoint MUST expose contact matching + +A new API endpoint SHALL provide programmatic access to the contact matching service, enabling reuse by the mail-sidebar change and external integrations. + +#### Scenario: Match by email via API +- **GIVEN** an authenticated user +- **WHEN** `GET /api/contacts/match?email=jan@example.nl` is called +- **THEN** the response SHALL return HTTP 200 with a JSON body containing: + - `matches`: array of matched entities with `uuid`, `register`, `schema`, `title`, `matchType`, `confidence` + - `total`: total number of matches + - `cached`: boolean indicating whether the result was served from cache + +#### Scenario: Match by name and email via API +- **GIVEN** an authenticated user +- **WHEN** `GET /api/contacts/match?email=jan@example.nl&name=Jan+de+Vries` is called +- **THEN** the response SHALL combine email and name matches, deduplicated by UUID +- **AND** email matches SHALL have higher confidence than name matches + +#### Scenario: Match by organization via API +- **GIVEN** an authenticated user +- **WHEN** `GET /api/contacts/match?organization=Gemeente+Tilburg` is called +- **THEN** the response SHALL return organization-type entity matches + +#### Scenario: Unauthenticated request returns 401 +- **GIVEN** no authentication credentials +- **WHEN** `GET /api/contacts/match?email=jan@example.nl` is called +- **THEN** the response SHALL be HTTP 401 Unauthorized + +### Requirement: The provider MUST integrate with DeepLinkRegistryService for action URLs + +When generating action URLs for matched entities, the provider MUST use `DeepLinkRegistryService::resolveUrl()` to determine the best URL for each entity, preferring consuming app deep links over raw OpenRegister URLs. + +#### Scenario: Deep link to consuming app +- **GIVEN** a matched entity in schema "Zaken" with a deep link registered by Procest +- **WHEN** the default "View in OpenRegister" action URL is generated +- **THEN** the URL SHALL point to the Procest route (e.g., `/apps/procest/#/zaken/{uuid}`) instead of the OpenRegister generic view +- **AND** the action icon SHALL use Procest's app icon via `DeepLinkRegistryService::resolveIcon()` + +#### Scenario: No deep link falls back to OpenRegister +- **GIVEN** a matched entity in a schema with no deep link registered +- **WHEN** the action URL is generated +- **THEN** the URL SHALL point to the OpenRegister object detail view +- **AND** the icon SHALL use `imagePath('openregister', 'app-dark.svg')` + +### Requirement: URL template variables MUST support contact-specific placeholders + +The deep link registry URL templates MUST be extended to support contact-specific placeholder variables beyond the existing object placeholders. + +#### Scenario: Contact placeholders in URL templates +- **GIVEN** a deep link URL template `"/apps/crm/#/contacts/{contactEmail}/cases"` +- **WHEN** resolved for a contact with email `jan@example.nl` +- **THEN** `{contactEmail}` SHALL be replaced with `jan%40example.nl` (URL-encoded) + +#### Scenario: All supported placeholders +- **GIVEN** a URL template with all contact placeholders +- **WHEN** resolved +- **THEN** the following placeholders SHALL be supported: + - `{contactId}` -- the contact's vCard UID + - `{contactEmail}` -- the contact's primary email address (URL-encoded) + - `{contactName}` -- the contact's display name (URL-encoded) + - `{entityId}` -- the matched OpenRegister entity's UUID + +### Requirement: i18n MUST be applied to all user-visible strings + +All user-visible strings in the `ContactsMenuProvider` and `ContactMatchingService` MUST use Nextcloud's `IL10N` translation system. Dutch and English translations MUST be provided as minimum per ADR-005. + +#### Scenario: Action labels are translated +- **GIVEN** a user with Nextcloud locale set to `nl` +- **WHEN** the contacts menu shows the entity count badge +- **THEN** the label SHALL use Dutch translations (e.g., "3 zaken, 1 lead, 5 documenten") + +#### Scenario: Default action label is translated +- **GIVEN** the default "View in OpenRegister" action +- **WHEN** rendered for a Dutch user +- **THEN** the label SHALL be "Bekijk in OpenRegister" + +#### Scenario: API error messages are translated +- **GIVEN** a failed contact matching API call +- **WHEN** the error response is generated +- **THEN** error messages SHALL use `IL10N::t()` for translation + +## Current Implementation Status + +**Not yet implemented.** The following existing infrastructure supports this feature: + +- `ObjectService::searchObjects()` provides the data access layer for searching objects by property values across registers and schemas. +- `DeepLinkRegistryService` provides `resolveUrl()` and `resolveIcon()` for consuming-app URL resolution. +- `Application::register()` already calls `$context->registerSearchProvider(ObjectsProvider::class)` -- the contacts menu provider registration will be added alongside it. +- Nextcloud's `OCP\Contacts\ContactsMenu\IProvider` interface is available since Nextcloud 12+. +- Nextcloud's `OCP\Contacts\ContactsMenu\ILinkAction` interface provides the mechanism for adding clickable action links. + +**Not yet implemented:** +- `ContactsMenuProvider` PHP class +- `ContactMatchingService` PHP class +- Contact matching API endpoint +- APCu caching for entity lookups +- Action registry integration (depends on `action-registry` change) +- URL template placeholder extension for contact variables +- Translation strings for provider labels and count badges + +## Standards & References + +- Nextcloud Contacts Menu API: `OCP\Contacts\ContactsMenu\IProvider` (NC 12+) +- Nextcloud Contacts Menu Actions: `OCP\Contacts\ContactsMenu\ILinkAction` (NC 12+) +- Nextcloud APCu Caching: `OCP\ICacheFactory` / `OCP\ICache` +- ADR-005: Dutch and English required for all UI strings +- ADR-011: Reuse existing services before creating new ones + +## Cross-References + +- `action-registry` -- Provides the action definitions with `context: "contact"` that are injected into the menu +- `mail-sidebar` -- Also consumes `ContactMatchingService` for email-based entity matching +- `deep-link-registry` -- URL resolution for consuming apps; extended with contact placeholders +- `profile-actions` -- User profile actions, separate from contact-person actions +- `files-sidebar-tabs` -- Sidebar tab pattern that could be reused if Contacts app supports tabs +- `nextcloud-entity-relations` -- Email linking table used for reverse lookups diff --git a/openspec/changes/data-import-export/specs/data-import-export/spec.md b/openspec/changes/data-import-export/specs/data-import-export/spec.md new file mode 100644 index 000000000000..55098a8060d9 --- /dev/null +++ b/openspec/changes/data-import-export/specs/data-import-export/spec.md @@ -0,0 +1,346 @@ +--- +status: draft +--- +# Data Import and Export + +## Purpose +Document and extend OpenRegister's existing import/export infrastructure. The core pipeline is already implemented: ImportService with ChunkProcessingHandler for bulk ingest, ExportService/ExportHandler for CSV/JSON/XML output, and Configuration/ImportHandler for register template loading. + +## ADDED Requirements + + +### Requirement: The system MUST support import from CSV, Excel, JSON, and XML formats + +Users MUST be able to upload files in CSV, XLSX, JSON, or XML format. The `ImportService` SHALL detect the file type from the extension and delegate to the appropriate reader. CSV import SHALL use `PhpOffice\PhpSpreadsheet\Reader\Csv`, Excel import SHALL use `PhpOffice\PhpSpreadsheet\Reader\Xlsx`, JSON import SHALL parse the file as a JSON array of objects, and XML import SHALL parse each child element of the root as an object record. + +#### Scenario: Import a CSV file with auto-detected schema +- **GIVEN** register `meldingen-register` has a single schema `meldingen` +- **AND** a CSV file `import.csv` with headers: titel, omschrijving, status, locatie +- **WHEN** the user uploads `import.csv` via `POST /api/objects/{register}/import` without specifying a schema +- **THEN** the `ExportHandler::import()` method SHALL auto-select the first schema from the register +- **AND** `ImportService::importFromCsv()` SHALL process the file using `PhpSpreadsheet\Reader\Csv` +- **AND** the response MUST include a summary with `found`, `created`, `updated`, `unchanged`, and `errors` counts + +#### Scenario: Import a multi-sheet Excel file with per-sheet schema mapping +- **GIVEN** register `gemeente-register` has schemas `personen` and `adressen` +- **AND** an Excel file `data.xlsx` has two sheets named `personen` and `adressen` +- **WHEN** the user uploads `data.xlsx` without specifying a schema +- **THEN** `ImportService::importFromExcel()` SHALL call `processMultiSchemaSpreadsheetAsync()` to match each sheet title to its corresponding schema slug +- **AND** the response MUST include separate summaries keyed by sheet title + +#### Scenario: Import a JSON array of objects +- **GIVEN** schema `producten` with properties: naam, prijs, categorie +- **AND** a file `producten.json` containing `[{"naam": "Widget A", "prijs": 12.50, "categorie": "onderdelen"}, ...]` +- **WHEN** the user uploads `producten.json` via the import endpoint +- **THEN** the system SHALL parse the JSON array and create one object per array element +- **AND** each object SHALL be validated against the `producten` schema properties + +#### Scenario: Import an XML file +- **GIVEN** schema `besluiten` with properties: titel, datum, status +- **AND** a file `besluiten.xml` with root element `` containing `` child elements +- **WHEN** the user uploads `besluiten.xml` +- **THEN** the system SHALL parse each `` element as a record, mapping child element names to schema property names +- **AND** attributes on child elements MUST be ignored unless a mapping explicitly references them + +#### Scenario: Reject unsupported file type +- **GIVEN** a user uploads a file `data.pdf` with extension `.pdf` +- **WHEN** the `ExportHandler::import()` method determines the extension +- **THEN** the system MUST return HTTP 400 with message "Unsupported file type: pdf" +- **AND** no objects SHALL be created + + +### Requirement: The system MUST support bulk import via API + +The bulk import API MUST accept an array of objects in a single request body for programmatic import without file upload. This endpoint SHALL leverage `SaveObjects` and `ChunkProcessingHandler` for high-performance batch processing with configurable chunk sizes. + +#### Scenario: Bulk create objects via API +- **GIVEN** schema `contactmomenten` in register `klantcontact` +- **AND** a JSON request body containing an array of 500 objects +- **WHEN** the client sends `POST /api/objects/{register}/{schema}/bulk` with the array +- **THEN** `SaveObjects` SHALL process the objects in chunks (default chunk size: 5 per `ImportService::DEFAULT_CHUNK_SIZE`) +- **AND** the response MUST include `created`, `updated`, `unchanged`, and `errors` arrays + +#### Scenario: Bulk import with validation enabled +- **GIVEN** the request includes query parameter `validation=true` +- **WHEN** the bulk import processes 500 objects +- **THEN** `BulkValidationHandler` SHALL validate each object against the schema definition +- **AND** objects that fail validation MUST appear in the `errors` array with their row index and error details +- **AND** valid objects MUST still be created (partial success) + +#### Scenario: Bulk import with events disabled for performance +- **GIVEN** the request includes query parameter `events=false` +- **WHEN** 10,000 objects are imported +- **THEN** the system SHALL skip dispatching object lifecycle events (webhooks, audit trail entries) +- **AND** processing time MUST be measurably lower than with events enabled +- **AND** a SOLR warmup job SHALL be scheduled via `IJobList` after import completes + + +### Requirement: Import MUST validate data against schema definitions before insertion + +Each row or object MUST be validated against the target schema's property definitions, including required fields, type constraints, enum values, format validators, and custom validation rules. Validation SHALL use the same `ValidateObject` infrastructure as single-object saves. + +#### Scenario: Validation errors with partial success +- **GIVEN** schema `meldingen` with required property `titel` and enum property `status` with values [nieuw, in_behandeling, afgehandeld] +- **AND** a CSV with 100 rows where rows 15 and 42 have empty `titel` and row 88 has `status: "ongeldig"` +- **WHEN** the import runs with `validation=true` +- **THEN** 97 valid rows MUST be imported successfully +- **AND** 3 invalid rows MUST be skipped +- **AND** the `errors` array MUST contain entries like: `{"row": 15, "field": "titel", "error": "Required property 'titel' is missing"}`, `{"row": 88, "field": "status", "error": "Value 'ongeldig' is not one of the allowed values: nieuw, in_behandeling, afgehandeld"}` + +#### Scenario: Import with validation disabled (fast mode) +- **GIVEN** the request includes `validation=false` (the default per `ImportService`) +- **WHEN** a CSV with 5000 rows is imported +- **THEN** the system SHALL skip schema validation for performance +- **AND** all rows MUST be inserted regardless of data quality +- **AND** the import summary MUST include a `validation` field set to `false` to indicate no validation was performed + +#### Scenario: Validate relation references during import +- **GIVEN** schema `taken` has property `toegewezen_aan` with `format: uuid` referencing schema `medewerkers` +- **AND** a CSV row has `toegewezen_aan: "550e8400-e29b-41d4-a716-446655440000"` +- **WHEN** the import processes this row with validation enabled +- **THEN** the system SHALL verify that a `medewerkers` object with that UUID exists +- **AND** if the referenced object does not exist, the row MUST be reported as an error with message "Referenced object not found: 550e8400-e29b-41d4-a716-446655440000" + + +### Requirement: Import MUST provide detailed error reporting with downloadable error files + +When an import completes with errors, the system MUST provide a detailed error report. The error report MUST be available as a downloadable CSV file containing the original row data plus error descriptions. + +#### Scenario: Download error report after import +- **GIVEN** an import of 200 rows resulted in 12 validation errors +- **WHEN** the import response is returned +- **THEN** the response MUST include an `errors` array with each error containing: `row` (1-based row index), `field` (property name), `error` (human-readable message), and `data` (the original row data) +- **AND** the response MUST include an `errorReportUrl` pointing to a downloadable CSV + +#### Scenario: Error CSV format +- **GIVEN** 3 import errors occurred +- **WHEN** the user downloads the error report CSV +- **THEN** the CSV MUST contain the original column headers plus two additional columns: `_error_field` and `_error_message` +- **AND** each error row MUST contain the original data values alongside the error details +- **AND** the CSV MUST use UTF-8 encoding + +#### Scenario: Import with zero errors +- **GIVEN** all 500 rows passed validation +- **WHEN** the import completes +- **THEN** the `errors` array MUST be empty +- **AND** the response MUST NOT include an `errorReportUrl` + + +### Requirement: Import MUST support progress tracking for large datasets + +For imports exceeding 100 rows, the system MUST provide progress tracking. The UI MUST display a progress indicator showing the current position and percentage. The import MUST run asynchronously without blocking the HTTP request. + +#### Scenario: Progress tracking for large CSV import +- **GIVEN** a CSV file with 5000 rows +- **WHEN** the import starts +- **THEN** the API response MUST include an `importJobId` for polling progress +- **AND** polling `GET /api/objects/{register}/import/{jobId}/status` MUST return: `{"status": "processing", "processed": 1500, "total": 5000, "percentage": 30, "errors": 2}` + +#### Scenario: Import completion notification +- **GIVEN** an asynchronous import of 10,000 rows completes +- **WHEN** the last chunk is processed +- **THEN** the system MUST send a Nextcloud notification via `INotifier` to the importing user +- **AND** the notification MUST include the import summary (created, updated, errors) +- **AND** the SOLR warmup job SHALL be scheduled via `IJobList::add()` as implemented in `ImportService::scheduleSmartSolrWarmup()` + +#### Scenario: UI progress indicator +- **GIVEN** a user initiated an import from the objects view +- **WHEN** the import is processing +- **THEN** the UI MUST display a progress bar with text: "Importeren... 1500/5000 (30%)" +- **AND** the progress MUST update every 2 seconds via polling +- **AND** the user MUST be able to navigate away without cancelling the import + + +### Requirement: The system MUST support structured export to CSV, Excel (XLSX), JSON, XML, and ODS formats + +Export MUST generate files in the requested format reflecting the current view state (filters, sort order). The `ExportService` SHALL handle CSV and Excel via `PhpSpreadsheet`, JSON via native `json_encode`, XML via `DOMDocument`, and ODS via `PhpSpreadsheet\Writer\Ods`. + +#### Scenario: Export filtered list to CSV +- **GIVEN** 500 `meldingen` objects, filtered to show 45 with `status = afgehandeld` +- **WHEN** the user requests `GET /api/objects/{register}/{schema}/export?format=csv&status=afgehandeld` +- **THEN** `ExportService::exportToCsv()` SHALL return CSV content with exactly 45 data rows +- **AND** the CSV MUST use UTF-8 encoding with BOM (U+FEFF) for Excel compatibility +- **AND** the filename MUST follow the pattern `{register}_{schema}_{datetime}.csv` as implemented in `ObjectsController::export()` + +#### Scenario: Export to Excel with schema-aware formatting +- **GIVEN** schema `meldingen` with properties: titel (string), aangemaakt (date-time), aantal (integer), status (enum) +- **WHEN** the user exports to Excel format +- **THEN** the XLSX file MUST include a header row using property keys as column headers (per `ExportService::getHeaders()`) +- **AND** the first column MUST be `id` containing the object UUID +- **AND** relation properties MUST have companion `_propertyName` columns with resolved human-readable names (per `ExportService::identifyNameCompanionColumns()`) +- **AND** admin users MUST see additional `@self.*` metadata columns (created, updated, owner, organisation, etc.) + +#### Scenario: Export to JSON +- **GIVEN** 45 filtered `meldingen` objects +- **WHEN** the user exports to JSON format +- **THEN** the response MUST be a JSON array of 45 objects +- **AND** each object MUST use the same structure as the API response from `ObjectEntity::jsonSerialize()` +- **AND** Unicode characters MUST be preserved (JSON_UNESCAPED_UNICODE) + +#### Scenario: Export to XML +- **GIVEN** 45 filtered `meldingen` objects +- **WHEN** the user exports to XML format +- **THEN** the response MUST be a valid XML document with root element `` and child elements `` +- **AND** each object property MUST be a child element of `` with the property name as element name +- **AND** array values MUST use repeated child elements + +#### Scenario: Export entire register to Excel (multi-sheet) +- **GIVEN** register `gemeente-register` with schemas `personen` and `adressen` +- **WHEN** the user exports the register without specifying a schema +- **THEN** `ExportService::exportToExcel()` SHALL create one sheet per schema (per `populateSheet()`) +- **AND** each sheet title MUST be the schema slug +- **AND** CSV format MUST be rejected with "Cannot export multiple schemas to CSV format" (per existing implementation) + + +### Requirement: Export MUST support filtering and column selection + +Export operations MUST respect the same filters, sort orders, and search queries available in the list view. Users MUST be able to select which columns to include in the export. + +#### Scenario: Export with metadata filters +- **GIVEN** the export request includes filter `@self.owner=admin` +- **WHEN** `ExportService::fetchObjectsForExport()` processes the filter +- **THEN** the `@self.` prefix MUST be stripped and the filter applied as a metadata filter on the `owner` field +- **AND** only objects owned by `admin` SHALL appear in the export + +#### Scenario: Export with multi-tenancy control +- **GIVEN** the export request includes `_multi=false` +- **WHEN** the export fetches objects +- **THEN** `ObjectService::searchObjects()` SHALL be called with `_multitenancy: false` +- **AND** only objects belonging to the current user's organisation SHALL be exported + +#### Scenario: Export with column selection +- **GIVEN** schema `meldingen` has 15 properties +- **AND** the export request includes `_columns=titel,status,locatie` +- **WHEN** the export generates headers +- **THEN** only the specified columns (plus the mandatory `id` column) SHALL appear in the export +- **AND** companion `_propertyName` columns for relation properties among the selected columns SHALL be included + + +### Requirement: Export MUST resolve relations to human-readable names + +When exporting objects with relation properties (UUID references to other objects), the export MUST include companion columns with resolved human-readable names. The resolution SHALL use the two-pass bulk approach in `ExportService::resolveUuidNameMap()` for performance. + +#### Scenario: Export with single UUID relation +- **GIVEN** schema `taken` has property `toegewezen_aan` with `format: uuid` referencing schema `medewerkers` +- **AND** object has `toegewezen_aan: "550e8400-e29b-41d4-a716-446655440000"` which resolves to medewerker "Jan de Vries" +- **WHEN** the export generates the spreadsheet +- **THEN** column `toegewezen_aan` MUST contain the UUID +- **AND** companion column `_toegewezen_aan` MUST contain "Jan de Vries" + +#### Scenario: Export with array of UUID relations +- **GIVEN** schema `projecten` has property `teamleden` with `type: array, items: {format: uuid}` +- **AND** object has `teamleden: ["uuid-1", "uuid-2", "uuid-3"]` +- **WHEN** the export resolves names via `CacheHandler::getMultipleObjectNames()` +- **THEN** the `teamleden` column MUST contain the JSON array of UUIDs +- **AND** the `_teamleden` column MUST contain a JSON array of resolved names: `["Jan de Vries", "Piet Bakker", "Anna Smit"]` + +#### Scenario: Bulk UUID resolution with pre-seeding +- **GIVEN** an export of 1000 objects where 200 have self-references (objects referencing other exported objects) +- **WHEN** `ExportService::resolveUuidNameMap()` runs +- **THEN** the pre-seeding step SHALL populate the name map from already-loaded objects (avoiding DB lookups for self-references) +- **AND** only UUIDs not in the pre-seeded map SHALL be resolved via `CacheHandler::getMultipleObjectNames()` + + +### Requirement: Import MUST support rollback on critical failure + +When a critical (non-validation) error occurs during import -- such as database connection loss, disk full, or schema deletion -- the system MUST roll back all objects created in the current import batch to maintain data consistency. + +#### Scenario: Database error during chunked import +- **GIVEN** an import of 1000 objects processed in chunks of 5 (per `ImportService::DEFAULT_CHUNK_SIZE`) +- **AND** a database connection error occurs at row 500 +- **WHEN** the error is caught +- **THEN** objects created in the current chunk (rows 496-500) MUST be rolled back +- **AND** objects from previously completed chunks (rows 1-495) MUST remain (they were already committed) +- **AND** the error response MUST indicate how many objects were successfully imported before failure + +#### Scenario: Schema not found during import +- **GIVEN** a multi-sheet Excel import where sheet `orders` references a non-existent schema +- **WHEN** `processMultiSchemaSpreadsheetAsync()` fails to find a matching schema +- **THEN** that sheet MUST be skipped with an error in the summary +- **AND** other sheets MUST continue processing normally +- **AND** the response MUST include per-sheet results + +#### Scenario: Memory limit during large import +- **GIVEN** a CSV with 100,000 rows and complex nested JSON values +- **WHEN** PHP memory usage approaches the limit during chunk processing +- **THEN** the system SHALL reduce the chunk size (down to `ImportService::MINIMAL_CHUNK_SIZE` of 2) +- **AND** the import MUST continue with reduced chunk size rather than crashing + + +### Requirement: Import templates MUST be downloadable per schema + +Users MUST be able to download a template file pre-configured for a specific schema, containing headers matching schema properties, example data, and documentation of required fields and valid values. + +#### Scenario: Download CSV import template +- **GIVEN** schema `meldingen` with properties: titel (required, string), omschrijving (string), status (enum: nieuw, in_behandeling, afgehandeld), locatie (string) +- **WHEN** the user requests `GET /api/objects/{register}/{schema}/template?format=csv` +- **THEN** the CSV MUST contain a header row: `titel,omschrijving,status,locatie` +- **AND** a second row with example data: `"Voorbeeld melding","Beschrijving van de melding","nieuw","Amsterdam"` +- **AND** the filename MUST follow pattern `{schema_slug}_template.csv` + +#### Scenario: Download Excel import template with documentation +- **GIVEN** the same `meldingen` schema +- **WHEN** the user requests an Excel template +- **THEN** the XLSX file MUST contain two sheets: `data` (with headers and example row) and `instructies` (with field documentation) +- **AND** the `instructies` sheet MUST list each property with: name, type, required (yes/no), description, allowed values (for enums) + +#### Scenario: Template respects property visibility +- **GIVEN** schema `meldingen` has property `interne_notitie` with `hideOnCollection: true` +- **WHEN** the template is generated +- **THEN** the `interne_notitie` column MUST still be included in the template (it is importable even if hidden on collection views) +- **AND** properties with `visible: false` MUST be excluded from the template + + +### Requirement: The system MUST support i18n for export headers and templates + +Export header labels and import template documentation MUST support internationalization. At minimum, Dutch (nl) and English (en) MUST be supported. + +#### Scenario: Export with Dutch header labels +- **GIVEN** the user's Nextcloud locale is set to `nl` +- **AND** schema `meldingen` has property `titel` with `title: "Titel"` in its definition +- **WHEN** the export generates the spreadsheet +- **THEN** the header row MAY optionally use the property's `title` field as a display label +- **AND** the property key (`titel`) MUST remain available as a secondary header or in a documentation sheet for re-import compatibility + +#### Scenario: Template documentation in user language +- **GIVEN** the user's locale is `nl` +- **WHEN** the user downloads an Excel import template +- **THEN** the `instructies` sheet MUST use Dutch labels: "Veldnaam", "Type", "Verplicht", "Beschrijving", "Toegestane waarden" +- **AND** the system messages (e.g., "Dit veld is verplicht") MUST be in Dutch + +#### Scenario: Export with English header labels +- **GIVEN** the user's Nextcloud locale is set to `en` +- **WHEN** the export generates the spreadsheet +- **THEN** the template documentation MUST use English labels: "Field name", "Type", "Required", "Description", "Allowed values" + + +### Requirement: Configuration import/export MUST support full register portability + +The `Configuration/ExportHandler` and `Configuration/ImportHandler` SHALL support exporting and importing complete register configurations (schemas, objects, mappings, workflows) as OpenAPI 3.0.0 + `x-openregister` extension files. This enables register portability between OpenRegister instances. + +#### Scenario: Export configuration with objects +- **GIVEN** configuration `gemeente-config` with register `gemeente-register` containing 2 schemas and 100 objects +- **WHEN** the admin exports with `includeObjects=true` +- **THEN** `ExportHandler::exportConfig()` SHALL produce an OpenAPI 3.0.0 spec with `components.registers`, `components.schemas`, and `components.objects` +- **AND** all internal IDs MUST be converted to slugs for portability (per `exportSchema()` slug resolution) +- **AND** `$ref` references in schema properties MUST be converted from numeric IDs to schema slugs + +#### Scenario: Import configuration into new instance +- **GIVEN** an OpenAPI 3.0.0 JSON file exported from another instance +- **WHEN** `ImportHandler` processes the file +- **THEN** schemas SHALL be created first, then workflows deployed (per `workflow-in-import` spec), then objects imported +- **AND** slug-based references SHALL be resolved to new numeric IDs on the target instance +- **AND** the import MUST be idempotent -- re-importing the same file SHALL update existing entities rather than creating duplicates + +#### Scenario: Export configuration with workflows +- **GIVEN** schema `organisatie` has a deployed n8n workflow attached to the `created` event +- **WHEN** the configuration is exported +- **THEN** `ExportHandler::exportWorkflowsForSchema()` SHALL include the workflow definition fetched from the engine +- **AND** the `attachTo` block MUST reference the schema by slug, not by ID + +#### Scenario: Export mappings +- **GIVEN** configuration has 3 associated mappings +- **WHEN** the configuration is exported +- **THEN** each mapping SHALL appear in `components.mappings` keyed by its slug +- **AND** instance-specific properties (id, uuid, organisation, created, updated) MUST be removed + diff --git a/openspec/changes/data-sync-harvesting/specs/data-sync-harvesting/spec.md b/openspec/changes/data-sync-harvesting/specs/data-sync-harvesting/spec.md new file mode 100644 index 000000000000..820e2aaf8f91 --- /dev/null +++ b/openspec/changes/data-sync-harvesting/specs/data-sync-harvesting/spec.md @@ -0,0 +1,571 @@ +--- +status: proposed +--- + +# Data Sync and Harvesting + +## Purpose +Implement a robust, multi-source data synchronization and harvesting pipeline that enables OpenRegister to pull data from external APIs (REST, OData, SOAP), file feeds (CSV, JSON, XML), other OpenRegister instances, and Dutch government base registrations (BAG, BRK, BRP, HR) into register schemas. The sync pipeline MUST follow CKAN's proven three-stage pattern (gather, fetch, import) with per-record status tracking, support both scheduled (cron) and event-triggered execution, and provide incremental sync via last-modified tracking or change tokens. The system MUST handle conflict resolution, field mapping via the existing Mapping/Twig infrastructure, authentication for secured sources, and comprehensive monitoring with audit trails -- all within Nextcloud's multi-tenant architecture. + +**Source**: Gap identified in cross-platform analysis; CKAN's `ckanext-harvest` three-stage pipeline is the primary reference pattern. OpenCatalogi's `DirectoryService` demonstrates async federation sync with anti-loop protection within the Nextcloud ecosystem. Existing foundation includes `Source` entity (`lib/Db/Source.php`), `SyncConfigurationsJob` (`lib/Cron/SyncConfigurationsJob.php`), `ImportService` (`lib/Service/ImportService.php`), and `Mapping` entity for Twig-based data transformation. + +## ADDED Requirements + +### Requirement: The system MUST support configurable sync source definitions with connection details, authentication, and scheduling +Administrators MUST be able to define external data sources specifying the source type, endpoint URL or file path, authentication credentials, target register and schema, field mapping reference, sync schedule (cron expression or interval), and conflict resolution strategy. The `Source` entity (`lib/Db/Source.php`) MUST be extended with sync-specific fields: `syncEnabled` (boolean), `syncSchedule` (string, cron expression), `syncInterval` (integer, hours), `lastSyncDate` (datetime), `lastSyncStatus` (string: `success|partial|failed|running`), `authType` (string: `none|apikey|basic|oauth2|certificate`), `authConfig` (json, encrypted credentials), `mappingId` (integer, reference to `Mapping` entity), `conflictStrategy` (string: `source-wins|local-wins|newest-wins|manual`), and `deleteStrategy` (string: `soft-delete|hard-delete|ignore`). This mirrors the sync fields already present on the `Configuration` entity (`syncEnabled`, `syncInterval`, `lastSyncDate`). + +#### Scenario: Define a REST API sync source for BAG addresses +- **GIVEN** the admin navigates to Sources management and creates a new sync source +- **WHEN** they configure: + - Name: `BAG Adressen` + - Type: `rest-api` + - URL: `https://api.bag.kadaster.nl/v2/adressen` + - Authentication: API key header (`X-Api-Key: `) + - Target register: `bag` (ID: 1), Target schema: `nummeraanduiding` (ID: 3) + - Mapping: reference to Mapping entity `bag-address-mapping` (ID: 5) + - Schedule: cron `0 2 * * *` (daily at 02:00) + - Conflict strategy: `source-wins` + - Delete strategy: `soft-delete` +- **THEN** the sync source MUST be persisted via `SourceMapper::insert()` with all sync fields populated +- **AND** a `SourceCreatedEvent` MUST be dispatched (per event-driven-architecture spec) +- **AND** the source MUST appear in the Sources list with a "Sync enabled" badge + +#### Scenario: Define a CSV file sync source from Nextcloud Files +- **GIVEN** the admin creates a sync source of type `csv-file` +- **WHEN** they configure: + - Name: `Productenlijst import` + - File path: `/admin/files/imports/producten.csv` (Nextcloud Files path) + - Delimiter: `;`, Encoding: `UTF-8` + - Target schema: `producten` + - Column mapping: `Productnaam -> title`, `Omschrijving -> description`, `Prijs -> price` +- **THEN** the system MUST validate that the CSV file exists and is readable +- **AND** the system MUST validate the column mapping against the target schema's property definitions +- **AND** unmapped required properties MUST generate a warning with option to set default values + +#### Scenario: Define an OData sync source +- **GIVEN** the admin creates a sync source of type `odata` +- **WHEN** they configure: + - URL: `https://services.odata.org/V4/Northwind/Northwind.svc/Products` + - Authentication: OAuth2 client credentials + - Select fields: `ProductID,ProductName,UnitPrice` + - Filter: `$filter=Discontinued eq false` +- **THEN** the system MUST validate the OData endpoint by issuing a `$metadata` request +- **AND** the system MUST auto-generate a field mapping proposal based on the OData entity type + +#### Scenario: Define a SOAP/XML sync source +- **GIVEN** the admin creates a sync source of type `soap` +- **WHEN** they configure: + - WSDL URL: `https://example.gov.nl/services/brp?wsdl` + - Operation: `ZoekPersoon` + - Authentication: certificate-based (mTLS) + - XPath mapping: `//Persoon/BSN -> bsn`, `//Persoon/Naam/Voornaam -> firstName` +- **THEN** the system MUST parse the WSDL to validate the operation exists +- **AND** the XPath mappings MUST be validated against example response data + +#### Scenario: Define a sync source for another OpenRegister instance (federation) +- **GIVEN** the admin creates a sync source of type `openregister` +- **WHEN** they configure: + - URL: `https://other-instance.example.nl/index.php/apps/openregister/api` + - Authentication: Basic Auth or API token + - Source register: `publicaties` (remote), Target register: `publicaties` (local) + - Source schema: `publicatie` (remote), Target schema: `publicatie` (local) +- **THEN** the system MUST validate connectivity by calling the remote instance's API +- **AND** the system MUST implement anti-loop protection (as in OpenCatalogi's `DirectoryService`) to prevent infinite sync cycles between instances + +### Requirement: The sync pipeline MUST follow a three-stage pattern (gather, fetch, import) with per-record status tracking +Each sync execution MUST proceed through three sequential stages: (1) **Gather** -- connect to the source and collect a list of record identifiers to process; (2) **Fetch** -- retrieve the full data for each identified record and store raw fetched data; (3) **Import** -- map, validate, and persist each record into the target register/schema. Each record MUST be tracked individually with status: `new`, `changed`, `unchanged`, `error`, `skipped`. The pipeline MUST be implemented as a Nextcloud `QueuedJob` (like `WebhookDeliveryJob` and `HookRetryJob`) to enable background processing and resumability. + +#### Scenario: Three-stage sync execution for a REST API source +- **GIVEN** sync source `BAG Adressen` is triggered (manually or by schedule) +- **WHEN** the sync pipeline starts +- **THEN** Stage 1 (Gather): the system MUST query `GET /v2/adressen?page=1&pageSize=100` and paginate through all pages + - **AND** store each record identifier (e.g., `nummeraanduidingIdentificatie`) in a `sync_records` tracking table + - **AND** set each record status to `pending` + - **AND** log: `"Gather complete: 2,450 records identified"` +- **THEN** Stage 2 (Fetch): for each pending record, the system MUST fetch the full record data + - **AND** store the raw JSON response per record + - **AND** update record status to `fetched` or `fetch_error` +- **THEN** Stage 3 (Import): for each fetched record, the system MUST: + - Apply the configured `Mapping` entity's Twig transformation rules (reusing the existing `Mapping` infrastructure from `lib/Db/Mapping.php`) + - Validate the mapped data against the target schema's JSON Schema definition + - Create or update the corresponding `ObjectEntity` via `ObjectService::saveObject()` + - Update record status to `imported`, `import_error`, or `unchanged` + +#### Scenario: Resume after failure mid-pipeline +- **GIVEN** a sync execution failed during Stage 2 (Fetch) after fetching 500 of 1,000 records +- **WHEN** the administrator clicks "Resume" or the retry job fires +- **THEN** the system MUST resume from record 501 using the persisted `sync_records` tracking data +- **AND** already-fetched records (1-500) MUST NOT be re-fetched +- **AND** the sync execution log MUST show the original start time and the resume time + +#### Scenario: Pipeline handles paginated API responses +- **GIVEN** a REST API source returns paginated results with `next` link headers or `_links.next` +- **WHEN** the Gather stage runs +- **THEN** the system MUST follow pagination until all pages are exhausted +- **AND** support pagination styles: page-number (`?page=N`), offset-limit (`?offset=N&limit=M`), cursor-based (`?cursor=abc123`), and link-header (`Link: ; rel="next"`) +- **AND** respect rate limiting headers (`Retry-After`, `X-RateLimit-Remaining`) + +#### Scenario: Pipeline processes records in configurable batch sizes +- **GIVEN** a sync source with `batchSize: 50` configured +- **WHEN** the Fetch and Import stages process 2,450 records +- **THEN** records MUST be processed in batches of 50 using ReactPHP concurrent promises (as in `ImportService`) +- **AND** memory MUST be managed by clearing processed batch data between batches (following `ImportService::DEFAULT_CHUNK_SIZE` pattern) +- **AND** the system MUST log progress: `"Batch 3/49: 150 records processed"` + +### Requirement: The system MUST support incremental sync using last-modified tracking or change tokens +The sync system MUST support delta synchronization to avoid re-fetching and re-processing unchanged records. Incremental sync MUST use source-specific mechanisms: `If-Modified-Since` headers (RFC 7232), `lastModified` query parameters, `deltaToken`/`skiptoken` (OData), or source-provided change feeds. The `Source` entity MUST persist the last successful sync checkpoint (timestamp, token, or cursor) for each source. + +#### Scenario: Incremental sync with If-Modified-Since header +- **GIVEN** sync source `BAG Adressen` last synced successfully at `2026-03-14T02:00:00Z` +- **WHEN** a new sync starts +- **THEN** the Gather stage MUST send `If-Modified-Since: Sat, 14 Mar 2026 02:00:00 GMT` header +- **AND** the source API returns only 15 modified records (instead of 2,450 total) +- **AND** the sync report MUST show: `"Incremental sync: 15 changed, 2,435 unchanged (not fetched)"` +- **AND** upon completion, `lastSyncDate` MUST be updated to the current execution timestamp + +#### Scenario: Incremental sync with source-side change token +- **GIVEN** a sync source supports OData delta tokens +- **WHEN** the source returns `@odata.deltaLink` with token `abc123` at end of sync +- **THEN** the system MUST persist `abc123` as `lastSyncToken` on the Source entity +- **AND** the next Gather stage MUST use `?$deltatoken=abc123` to request only changes since the last sync + +#### Scenario: Full resync forced by administrator +- **GIVEN** a sync source with incremental sync enabled and a valid `lastSyncDate` +- **WHEN** the administrator clicks "Full Resync" on the source +- **THEN** the system MUST ignore `lastSyncDate` and `lastSyncToken` for this execution +- **AND** all records MUST be gathered, fetched, and imported from scratch +- **AND** the `lastSyncDate` and `lastSyncToken` MUST be updated upon completion +- **AND** the sync report MUST indicate `"Full resync (manual override)"` + +### Requirement: The system MUST support field mapping and transformation via the existing Mapping entity +Each sync source MUST reference a `Mapping` entity (`lib/Db/Mapping.php`) that defines how source fields map to target schema properties. Mappings MUST support Twig templating for value transformation, `unset` rules for removing unwanted fields, `cast` rules for type conversion, and `passThrough` mode for forwarding unmapped fields. This reuses the existing Twig mapping infrastructure rather than creating a parallel system. + +#### Scenario: Direct field mapping with Twig templates +- **GIVEN** a Mapping entity with rules: + ```json + { + "mapping": { + "street": "{{ source.openbareRuimteNaam }}", + "houseNumber": "{{ source.huisnummer }}", + "postalCode": "{{ source.postcode }}", + "city": "{{ source.woonplaatsNaam }}" + } + } + ``` +- **WHEN** a source record `{"openbareRuimteNaam": "Kerkstraat", "huisnummer": 42, "postcode": "1234AB", "woonplaatsNaam": "Utrecht"}` is imported +- **THEN** the mapped object MUST be: `{"street": "Kerkstraat", "houseNumber": 42, "postalCode": "1234AB", "city": "Utrecht"}` + +#### Scenario: Value transformation with Twig expressions +- **GIVEN** a Mapping with transformation rules: + ```json + { + "mapping": { + "status": "{{ source.statusCode == 'A' ? 'actief' : (source.statusCode == 'I' ? 'inactief' : 'onbekend') }}", + "fullAddress": "{{ source.straat }} {{ source.huisnummer }}, {{ source.postcode }} {{ source.plaats }}" + } + } + ``` +- **WHEN** a record with `statusCode: "A"` and address fields is imported +- **THEN** `status` MUST be `"actief"` and `fullAddress` MUST be the concatenated address string + +#### Scenario: Type casting via Mapping cast rules +- **GIVEN** a Mapping with `"cast": {"price": "float", "quantity": "integer", "isActive": "boolean"}` +- **WHEN** source data contains `{"price": "19.95", "quantity": "100", "isActive": "true"}` +- **THEN** the imported object MUST have `price` as float `19.95`, `quantity` as integer `100`, `isActive` as boolean `true` + +#### Scenario: Auto-generate mapping proposal from source schema +- **GIVEN** a sync source of type `rest-api` with a discoverable schema (OpenAPI spec, JSON Schema, or OData metadata) +- **WHEN** the admin creates or edits the sync source +- **THEN** the system MUST offer to auto-generate a `Mapping` entity by matching source field names to target schema property names +- **AND** exact name matches MUST be mapped automatically, while fuzzy matches (e.g., `straatnaam` to `street`) MUST be suggested for manual confirmation + +### Requirement: Sync MUST support create, update, and delete operations with configurable strategies +The import stage MUST determine whether each record is new (create), changed (update), or removed (delete) by comparing source data to existing register objects. Record matching MUST use a configurable identity field (external ID, UUID, or composite key). Delete handling MUST be configurable per source: `soft-delete` (set status to `inactive`), `hard-delete` (remove from register), or `ignore` (leave orphaned records). + +#### Scenario: Create new objects from sync +- **GIVEN** 10 source records with external IDs that do not match any existing object's `_sourceId` field +- **WHEN** the Import stage processes these records +- **THEN** 10 new `ObjectEntity` instances MUST be created via `ObjectService::saveObject()` +- **AND** each object MUST store the external ID in metadata field `_sourceId` and source reference in `_syncSourceId` +- **AND** 10 `ObjectCreatedEvent` events MUST be dispatched (per event-driven-architecture spec) + +#### Scenario: Update existing objects with change detection +- **GIVEN** source record `addr-1` has field `woonplaatsNaam` changed from `"Utrecht"` to `"Amersfoort"` since last sync +- **AND** the register has an object with `_sourceId: "addr-1"` +- **WHEN** the Import stage processes this record +- **THEN** a content hash comparison MUST detect the change +- **AND** the existing object MUST be updated with the new mapped data +- **AND** the audit trail MUST record the update with actor `system/sync/` +- **AND** an `ObjectUpdatedEvent` MUST be dispatched with both old and new state + +#### Scenario: Detect and handle deleted source records (soft-delete) +- **GIVEN** sync source configured with `deleteStrategy: "soft-delete"` +- **AND** source record `addr-5` existed in the previous sync but is absent from the current Gather results +- **WHEN** the Import stage completes +- **THEN** the object with `_sourceId: "addr-5"` MUST have its `status` set to `inactive` +- **AND** the audit trail MUST record: `"Soft-deleted by sync: source record no longer present"` +- **AND** the sync report MUST list `addr-5` under "Deleted records" + +#### Scenario: Skip unchanged records +- **GIVEN** source record `addr-2` has identical content hash to the last synced version +- **WHEN** the Import stage processes this record +- **THEN** no update MUST be performed +- **AND** the record status MUST be set to `unchanged` +- **AND** no `ObjectUpdatedEvent` MUST be dispatched +- **AND** the sync report MUST count this record as "unchanged/skipped" + +### Requirement: Sync MUST support conflict resolution with configurable strategies +When both the source and local register have modified the same record since the last sync, the system MUST detect the conflict and apply the configured resolution strategy. Strategies MUST include: `source-wins` (overwrite local changes), `local-wins` (keep local changes, skip source update), `newest-wins` (compare timestamps, keep the most recent), and `manual` (flag for administrator review). + +#### Scenario: Source-wins conflict resolution +- **GIVEN** sync source configured with `conflictStrategy: "source-wins"` +- **AND** object `addr-1` was modified locally at `2026-03-18T10:00:00Z` and in the source at `2026-03-18T08:00:00Z` +- **WHEN** the Import stage detects both sides have changed since last sync +- **THEN** the source data MUST overwrite the local changes +- **AND** the audit trail MUST record: `"Conflict resolved: source-wins (local changes overwritten)"` + +#### Scenario: Manual conflict resolution queue +- **GIVEN** sync source configured with `conflictStrategy: "manual"` +- **AND** 3 records have conflicts detected during import +- **WHEN** the Import stage encounters these conflicts +- **THEN** the 3 records MUST be flagged with status `conflict` in the sync tracking table +- **AND** an admin notification MUST be sent via Nextcloud's notification system +- **AND** the admin MUST be able to view a conflict resolution UI showing local vs. source data side-by-side +- **AND** the admin MUST be able to choose per-record: accept source, keep local, or manually merge + +#### Scenario: Newest-wins with timestamp comparison +- **GIVEN** sync source configured with `conflictStrategy: "newest-wins"` +- **AND** local modification at `2026-03-18T14:00:00Z`, source modification at `2026-03-18T16:00:00Z` +- **WHEN** the Import stage detects the conflict +- **THEN** the source version MUST win because `16:00 > 14:00` +- **AND** the audit trail MUST record: `"Conflict resolved: newest-wins (source: 2026-03-18T16:00:00Z > local: 2026-03-18T14:00:00Z)"` + +### Requirement: Sync executions MUST produce detailed monitoring reports and maintain execution history +Each sync execution MUST produce a comprehensive execution report and all reports MUST be persisted for historical review. The system MUST expose sync status via the API and the admin UI. This mirrors the pattern already established by `SyncConfigurationsJob` which tracks `synced`, `skipped`, and `failed` counts and updates `lastSyncDate` and status on the `Configuration` entity. + +#### Scenario: View sync execution report after completion +- **GIVEN** a sync execution for source `BAG Adressen` has completed +- **WHEN** the admin views the execution report +- **THEN** the report MUST show: + - Execution ID, source name, source UUID + - Start time, end time, duration + - Status: `success`, `partial` (some records failed), or `failed` + - Sync type: `incremental` or `full` + - Stage timings: gather duration, fetch duration, import duration + - Record counts: gathered, fetched, imported, created, updated, unchanged, deleted, errored, skipped + - Error details: for each failed record, the record identifier, stage of failure, and error message + - Bytes transferred, API calls made + +#### Scenario: View sync execution history with trend analysis +- **GIVEN** source `BAG Adressen` has 30 sync execution reports over the past month +- **WHEN** the admin views the sync history +- **THEN** the system MUST display a chronological list with status icons (green/yellow/red) +- **AND** show trend metrics: average duration, average record count, error rate trend +- **AND** allow filtering by status (`success`, `partial`, `failed`) and date range + +#### Scenario: Real-time sync progress monitoring +- **GIVEN** a sync execution is currently running for source `BAG Adressen` +- **WHEN** the admin views the source details +- **THEN** the UI MUST show real-time progress: `"Stage 2/3 (Fetch): 1,200/2,450 records (49%)"` +- **AND** estimated time remaining based on current processing rate +- **AND** a "Cancel" button MUST be available to abort the running sync + +#### Scenario: API endpoint for sync status +- **GIVEN** an external monitoring system needs to check sync health +- **WHEN** it calls `GET /api/sources/{id}/sync-status` +- **THEN** the API MUST return: `{"status": "success", "lastSyncDate": "2026-03-19T02:15:00Z", "recordsProcessed": 2450, "nextScheduledRun": "2026-03-20T02:00:00Z"}` + +### Requirement: The system MUST handle errors gracefully with partial failure support and automatic retry +Individual record failures during any pipeline stage MUST NOT abort the entire sync execution. Failed records MUST be logged with error details and retried according to a configurable retry policy. The retry mechanism MUST follow the pattern established by `HookRetryJob` (`lib/BackgroundJob/HookRetryJob.php`) which uses Nextcloud's `IJobList` for queued retry jobs with exponential backoff. + +#### Scenario: Partial failure during import with continuation +- **GIVEN** 2,450 records are being imported +- **AND** records at positions 150, 800, and 2,100 fail schema validation +- **WHEN** the Import stage processes all records +- **THEN** 2,447 records MUST be successfully imported +- **AND** 3 records MUST be marked as `import_error` with validation error details +- **AND** the overall sync status MUST be `partial` (not `failed`) +- **AND** the sync report MUST list the 3 failed records with actionable error messages + +#### Scenario: Automatic retry with exponential backoff +- **GIVEN** a sync source configured with `retryPolicy: {"maxRetries": 3, "backoffMultiplier": 2, "initialDelay": 60}` +- **AND** a record fails during Fetch due to a transient HTTP 503 error +- **WHEN** the retry policy is applied +- **THEN** retry 1 MUST be scheduled after 60 seconds +- **AND** retry 2 MUST be scheduled after 120 seconds (60 * 2) +- **AND** retry 3 MUST be scheduled after 240 seconds (60 * 2 * 2) +- **AND** if all 3 retries fail, the record MUST be marked as `permanent_error` + +#### Scenario: Source API completely unavailable +- **GIVEN** the source API returns HTTP 500 for all requests during the Gather stage +- **WHEN** the system attempts to start the sync +- **THEN** the sync MUST fail immediately with status `failed` and reason `"Source API unavailable: HTTP 500"` +- **AND** the system MUST NOT attempt Fetch or Import stages +- **AND** the next scheduled sync MUST still run at the configured time + +### Requirement: Authentication credentials for external sources MUST be stored securely +Sync source authentication credentials MUST be stored encrypted in the database, never logged in plaintext, and accessible only to administrators. The system MUST support multiple authentication methods: none, API key (header or query parameter), HTTP Basic, OAuth2 (client credentials, authorization code), and mutual TLS (certificate-based). + +#### Scenario: Store API key credentials encrypted +- **GIVEN** the admin configures a sync source with API key authentication +- **WHEN** they enter the API key `sk_live_abc123xyz789` +- **THEN** the key MUST be encrypted using Nextcloud's `ICredentialsManager` or `ICrypto` before database storage +- **AND** the API response for the source MUST mask the key as `sk_live_***789` +- **AND** server logs MUST never contain the plaintext key + +#### Scenario: OAuth2 client credentials flow +- **GIVEN** a sync source configured with OAuth2 authentication +- **WHEN** the sync pipeline starts +- **THEN** the system MUST first obtain an access token from the configured token endpoint using client credentials +- **AND** cache the access token until expiry (respecting `expires_in`) +- **AND** use the bearer token for all Gather and Fetch API calls +- **AND** automatically refresh the token if a 401 response is received mid-sync + +#### Scenario: Credential rotation without sync disruption +- **GIVEN** an admin updates the API key for sync source `BAG Adressen` +- **WHEN** a sync is currently running with the old key +- **THEN** the running sync MUST complete with the old key +- **AND** the next sync MUST use the new key +- **AND** the credential change MUST be recorded in the audit trail + +### Requirement: Imported data MUST be validated against the target schema before persistence +Every record entering the Import stage MUST be validated against the target schema's JSON Schema definition before being persisted. Validation MUST cover: required properties, type constraints, format validators (email, URI, date), enum restrictions, string length limits, and numeric ranges. This reuses the existing schema validation infrastructure in `ObjectService::saveObject()`. + +#### Scenario: Valid record passes schema validation +- **GIVEN** target schema `nummeraanduiding` requires properties `identificatie` (string, 16 chars), `postcode` (pattern: `^\d{4}[A-Z]{2}$`), and `huisnummer` (integer, min: 1) +- **WHEN** a mapped record `{"identificatie": "0307200000012345", "postcode": "3511AB", "huisnummer": 42}` is validated +- **THEN** validation MUST pass and the record MUST be persisted + +#### Scenario: Invalid record fails validation with detailed errors +- **GIVEN** the same schema requirements +- **WHEN** a mapped record `{"identificatie": "short", "postcode": "invalid", "huisnummer": -1}` is validated +- **THEN** validation MUST fail with errors: + - `"identificatie: String length 5 is less than minimum 16"` + - `"postcode: 'invalid' does not match pattern ^\d{4}[A-Z]{2}$"` + - `"huisnummer: -1 is less than minimum 1"` +- **AND** the record MUST be marked as `import_error` with these validation messages + +#### Scenario: Validation mode configurable (strict vs. lenient) +- **GIVEN** a sync source with `validationMode: "lenient"` +- **WHEN** a record has a non-required property with an invalid format +- **THEN** the system MUST log a warning but still import the record with the invalid value +- **AND** the sync report MUST flag these as "imported with warnings" + +### Requirement: The system MUST maintain a complete sync audit trail integrated with the existing audit system +All sync operations MUST be recorded in the audit trail with the sync source as the actor. Audit entries MUST distinguish sync-originated changes from user-originated changes. The audit trail MUST support tracing any object back to its sync source and the specific sync execution that created or last modified it. + +#### Scenario: Audit trail for sync-created objects +- **GIVEN** a sync execution creates 50 new objects +- **WHEN** an administrator views the audit trail for one of these objects +- **THEN** the creation entry MUST show: + - Actor: `system/sync/bag-adressen` (source UUID) + - Action: `created` + - Sync execution ID reference + - Source record identifier (`_sourceId`) +- **AND** the object's metadata MUST contain `_syncSourceId`, `_sourceId`, `_lastSyncExecutionId`, and `_lastSyncDate` + +#### Scenario: Audit trail distinguishes sync vs. manual changes +- **GIVEN** object `addr-1` was created by sync and later manually edited by user `admin` +- **WHEN** the next sync updates `addr-1` (source-wins conflict resolution) +- **THEN** the audit trail MUST show three entries: + 1. Created by `system/sync/bag-adressen` (sync execution #1) + 2. Updated by `admin` (manual edit) + 3. Updated by `system/sync/bag-adressen` (sync execution #2, conflict: source-wins, local changes overwritten) + +#### Scenario: Bulk audit trail query for sync execution +- **GIVEN** sync execution #42 processed 2,450 records +- **WHEN** the admin queries `GET /api/audit-trail?syncExecutionId=42` +- **THEN** the API MUST return all audit entries created during that execution +- **AND** support filtering by action (`created`, `updated`, `deleted`) and status (`success`, `error`) + +### Requirement: The system MUST support bi-directional sync for federated OpenRegister instances +For sync sources of type `openregister` (instance-to-instance federation), the system MUST support pushing local changes back to the source instance. Bi-directional sync MUST implement anti-loop detection (as in OpenCatalogi's `DirectoryService` which uses broadcast headers to prevent infinite sync cycles) and conflict resolution. + +#### Scenario: Push local changes to remote OpenRegister instance +- **GIVEN** a bi-directional sync source connecting local and remote OpenRegister instances +- **AND** a local object `pub-1` is modified by a local user +- **WHEN** the next outbound sync runs +- **THEN** the system MUST push the updated object to the remote instance via its API +- **AND** the push request MUST include an `X-OpenRegister-Sync-Origin: ` header +- **AND** the remote instance MUST recognize this header and skip re-syncing the change back (anti-loop) + +#### Scenario: Anti-loop protection prevents infinite sync cycles +- **GIVEN** Instance A syncs with Instance B, and Instance B syncs with Instance A +- **WHEN** a record is modified on Instance A and synced to Instance B +- **THEN** Instance B MUST detect the `X-OpenRegister-Sync-Origin` header matching Instance A +- **AND** Instance B MUST NOT re-sync this change back to Instance A +- **AND** the sync log on Instance B MUST record: `"Skipped re-sync to origin instance A"` + +#### Scenario: Federation with schema version mismatch +- **GIVEN** local schema `publicatie` is at version `2.1.0` and remote schema is at version `1.5.0` +- **WHEN** the sync attempts to pull remote records +- **THEN** the system MUST detect the schema version mismatch +- **AND** apply backward-compatible mapping if the major version matches (2.x to 1.x = breaking, warning) +- **AND** log a warning: `"Schema version mismatch: remote 1.5.0, local 2.1.0 — some fields may not map correctly"` + +### Requirement: The system MUST support webhook-triggered and event-triggered sync in addition to scheduled sync +Beyond cron-based scheduling, sync MUST be triggerable by inbound webhooks (push-based sync) and by events from the event-driven-architecture. This enables real-time data propagation when sources support webhook notifications. The webhook endpoint MUST validate incoming payloads using HMAC signatures or shared secrets. + +#### Scenario: Webhook-triggered sync from external source +- **GIVEN** sync source `BAG Adressen` has a webhook endpoint registered: `POST /api/sources/{id}/webhook` +- **WHEN** the BAG API sends a webhook notification: `{"event": "record.updated", "id": "0307200000012345"}` +- **THEN** the system MUST validate the webhook signature using the configured HMAC secret +- **AND** trigger a targeted sync for only the changed record (not a full sync) +- **AND** the single record MUST go through the full fetch-and-import pipeline + +#### Scenario: Event-triggered sync when related data changes +- **GIVEN** a workflow is configured to trigger sync source `HR Bedrijven` when a `klant` object's `kvkNummer` is updated +- **WHEN** the `ObjectUpdatedEvent` fires for the klant object with changed `kvkNummer` +- **THEN** the system MUST trigger a targeted sync from the KvK API for the specific company +- **AND** update the related `bedrijf` object in the register with fresh data from the HR API + +#### Scenario: Manual one-click sync trigger +- **GIVEN** the admin views sync source `BAG Adressen` in the admin UI +- **WHEN** they click the "Sync Now" button +- **THEN** the system MUST immediately queue a sync execution as a `QueuedJob` +- **AND** redirect the admin to the execution monitoring view +- **AND** the manual trigger MUST respect the same pipeline stages and error handling as scheduled syncs + +### Requirement: Sync performance MUST be optimized with configurable batch sizes, throttling, and concurrency limits +The sync pipeline MUST provide performance controls to prevent overloading source APIs, the local database, or available memory. Controls MUST include: batch size (records per processing chunk), concurrency limit (parallel fetch/import operations), throttle delay (milliseconds between API calls), maximum records per execution, and timeout per record. These settings follow the patterns established in `ImportService` (`DEFAULT_CHUNK_SIZE = 5`, `MINIMAL_CHUNK_SIZE = 2`, `MAX_CONCURRENT_OPERATIONS`). + +#### Scenario: Throttled API access to respect rate limits +- **GIVEN** sync source configured with `throttleDelay: 200` (milliseconds between API calls) +- **AND** the source API returns `X-RateLimit-Remaining: 10` and `X-RateLimit-Reset: 1679788800` +- **WHEN** the Fetch stage makes API calls +- **THEN** the system MUST wait at least 200ms between consecutive API calls +- **AND** when `X-RateLimit-Remaining` drops below 5, the system MUST pause until the reset time +- **AND** the sync report MUST include total wait time due to throttling + +#### Scenario: Memory-bounded batch processing +- **GIVEN** sync source configured with `batchSize: 25` and `maxConcurrency: 5` +- **WHEN** processing 2,450 records in the Import stage +- **THEN** records MUST be processed in batches of 25 +- **AND** within each batch, at most 5 records MUST be processed concurrently using ReactPHP promises +- **AND** each completed batch MUST free its memory before the next batch starts +- **AND** PHP memory usage MUST stay below the configured `memory_limit` + +#### Scenario: Maximum records limit prevents runaway syncs +- **GIVEN** sync source configured with `maxRecordsPerExecution: 10000` +- **WHEN** the Gather stage identifies 50,000 records +- **THEN** the system MUST process only the first 10,000 records in this execution +- **AND** log: `"Record limit reached: 10,000/50,000. Remaining records will be processed in the next execution."` +- **AND** persist a cursor/offset so the next execution continues from record 10,001 + +### Requirement: Sync MUST respect multi-tenant organisation isolation +In a multi-tenant OpenRegister deployment, sync sources and their imported data MUST be scoped to the owning organisation. The `Source` entity already has an `organisation` field enforced by `MultiTenancyTrait` in `SourceMapper`. Sync operations MUST inherit this isolation: a source owned by Organisation A MUST only create/update objects visible to Organisation A. + +#### Scenario: Sync creates objects within the source's organisation scope +- **GIVEN** sync source `BAG Adressen` belongs to organisation `gemeente-utrecht` (UUID: `org-123`) +- **WHEN** the Import stage creates new objects +- **THEN** all created objects MUST have their `organisation` field set to `org-123` +- **AND** objects MUST be visible only to users who are members of `gemeente-utrecht` +- **AND** the sync execution itself MUST be logged under `gemeente-utrecht` + +#### Scenario: Organisation admin can only manage their own sync sources +- **GIVEN** user `admin-utrecht` is an admin of organisation `gemeente-utrecht` +- **AND** user `admin-amsterdam` is an admin of organisation `gemeente-amsterdam` +- **WHEN** `admin-utrecht` lists sync sources via `GET /api/sources` +- **THEN** only sources belonging to `gemeente-utrecht` MUST be returned (enforced by `SourceMapper::applyOrganisationFilter()`) +- **AND** attempting to trigger sync for a source owned by `gemeente-amsterdam` MUST return HTTP 403 + +#### Scenario: Cross-organisation sync via shared registers +- **GIVEN** a register `landelijke-producten` is shared across organisations +- **AND** a sync source owned by `gemeente-utrecht` imports into this shared register +- **WHEN** objects are created by the sync +- **THEN** objects MUST be visible to all organisations that have access to the shared register +- **AND** the objects MUST still track their sync source origin (`_syncSourceId`) for audit purposes + +### Requirement: Scheduled sync MUST use Nextcloud's BackgroundJob infrastructure with configurable intervals +Sync scheduling MUST be implemented as Nextcloud `TimedJob` instances (following the pattern of `SyncConfigurationsJob` which runs hourly and checks each configuration's `syncInterval`). Each sync source MUST support independent scheduling via cron expressions or interval-based timing. The scheduler MUST handle overlapping executions by skipping a run if the previous execution is still in progress. + +#### Scenario: Cron-based scheduling with interval check +- **GIVEN** sync source `BAG Adressen` configured with `syncInterval: 24` (hours) and `syncEnabled: true` +- **AND** `lastSyncDate` is `2026-03-18T02:00:00Z` +- **WHEN** the `SyncDataJob` TimedJob runs at `2026-03-19T02:00:00Z` (24 hours later) +- **THEN** the system MUST determine the source is due for sync (`hoursPassed >= syncInterval`) +- **AND** queue a sync execution for this source + +#### Scenario: Skip execution if previous sync still running +- **GIVEN** sync source `BAG Adressen` has a running sync execution (status: `running`) +- **WHEN** the scheduler checks if a new sync should start +- **THEN** the system MUST skip this source with log: `"Skipping BAG Adressen: previous sync still running (started 2026-03-19T02:00:00Z)"` +- **AND** NOT queue a new execution + +#### Scenario: Multiple sources with independent schedules +- **GIVEN** three sync sources: + - `BAG Adressen`: every 24 hours + - `KvK Bedrijven`: every 6 hours + - `Productenlijst CSV`: every 1 hour +- **WHEN** the master `SyncDataJob` runs hourly +- **THEN** each source MUST be independently evaluated against its own `syncInterval` and `lastSyncDate` +- **AND** only due sources MUST be queued for execution + +## Using Mock Register Data + +The **BAG** mock register provides local test data for developing and testing the sync pipeline without requiring external API access. + +**Loading the register:** +```bash +# Load BAG register (32 addresses + 21 objects + 21 buildings, register slug: "bag") +docker exec -u www-data nextcloud php occ openregister:load-register /var/www/html/custom_apps/openregister/lib/Settings/bag_register.json +``` + +**Test data for this spec's use cases:** +- **BAG sync source**: Use loaded BAG `nummeraanduiding` records as the "expected" result for a sync run, verifying the gather-fetch-import pipeline +- **Incremental sync**: Modify a loaded BAG record and re-run sync to test change detection and upsert behavior +- **Schema validation**: BAG records include proper 16-digit identifications, postcodes, and municipality codes -- test schema validation during import +- **Conflict resolution**: Manually edit a synced BAG record, then re-sync to test source-wins/local-wins/manual strategies +- **Multi-tenant isolation**: Create two organisations, assign sync sources to each, verify objects are scoped correctly + +## Current Implementation Status +- **Existing foundations:** + - `Source` entity (`lib/Db/Source.php`) with fields: uuid, title, version, description, databaseUrl, type, organisation -- represents an external data source with multi-tenancy via `MultiTenancyTrait` + - `SourceMapper` (`lib/Db/SourceMapper.php`) with CRUD, RBAC verification, and organisation filtering + - `SyncConfigurationsJob` (`lib/Cron/SyncConfigurationsJob.php`) -- hourly TimedJob that syncs configurations from GitHub, GitLab, URL, and local sources with `isDueForSync()` interval checking and `synced/skipped/failed` status tracking + - `Configuration` entity has sync fields: `syncEnabled`, `syncInterval`, `lastSyncDate`, `sourceType`, `sourceUrl` -- same pattern needed for `Source` entity + - `ImportService` (`lib/Service/ImportService.php`) -- handles CSV and Excel import with ReactPHP chunked processing, concurrency limits, and progress tracking + - `Mapping` entity (`lib/Db/Mapping.php`) -- Twig-based field transformation with mapping rules, unset, cast, and passThrough modes + - `ConfigurationService` with `ImportHandler` (`lib/Service/Configuration/ImportHandler.php`) -- handles configuration imports from external sources + - `WebhookService` (`lib/Service/WebhookService.php`) -- webhook delivery with CloudEvents formatting and retry via `WebhookDeliveryJob` + - `HookRetryJob` (`lib/BackgroundJob/HookRetryJob.php`) -- queued retry with exponential backoff pattern + - Event-driven architecture with 39+ typed event classes and `ObjectCreatedEvent`/`ObjectUpdatedEvent`/`ObjectDeletedEvent` + - OpenCatalogi `DirectoryService` (`opencatalogi/lib/Service/DirectoryService.php`) -- async federation sync with anti-loop protection using broadcast headers + - Frontend source management views at `src/views/source/` +- **NOT yet implemented:** + - Three-stage sync pipeline (gather, fetch, import) for data sources + - Sync-specific fields on `Source` entity (syncEnabled, syncSchedule, authType, authConfig, mappingId, conflictStrategy, deleteStrategy) + - Per-record status tracking table (`sync_records`) + - REST API, OData, and SOAP sync source handlers + - OpenRegister-to-OpenRegister federation sync with anti-loop protection + - Incremental sync with last-modified tracking and change tokens + - Conflict resolution strategies (source-wins, local-wins, newest-wins, manual) + - Sync execution monitoring, reporting, and history persistence + - Webhook-triggered and event-triggered sync + - Encrypted credential storage for source authentication + - Bi-directional sync (push local changes to remote) + - Performance controls (batch size, throttling, concurrency limits) + - Sync-specific `SyncDataJob` background job + - Real-time sync progress monitoring in UI + - Automatic retry for failed records with exponential backoff + +## Cross-References +- **data-import-export**: One-shot file import (CSV/Excel) via `ImportService` -- sync extends this with scheduled, repeatable, API-based imports. The batch processing and ReactPHP concurrency patterns from `ImportService` MUST be reused. +- **workflow-integration**: Workflows can trigger syncs (event-triggered sync) and syncs can trigger workflows (synced objects dispatch events that workflows listen to). The n8n integration enables complex sync orchestration beyond the built-in pipeline. +- **event-driven-architecture**: All sync-created/updated/deleted objects MUST dispatch the standard typed events (`ObjectCreatedEvent`, `ObjectUpdatedEvent`, `ObjectDeletedEvent`). Webhooks configured on schemas MUST fire for sync-originated changes. +- **audit-trail**: Sync operations MUST use the existing audit trail infrastructure with `system/sync/` as the actor. +- **multi-tenancy**: Sync sources and their imported data MUST respect organisation isolation via the existing `MultiTenancyTrait` on `SourceMapper`. + +## Standards & References +- **CKAN ckanext-harvest** -- Reference implementation for three-stage pipeline (gather/fetch/import) with `IHarvester` interface and per-record status tracking +- **OpenCatalogi DirectoryService** -- Reference implementation for Nextcloud-native async federation sync with anti-loop protection +- **DCAT (Data Catalog Vocabulary)** -- W3C standard for describing data catalogs and datasets +- **OAI-PMH (Open Archives Initiative Protocol for Metadata Harvesting)** -- Harvesting protocol for metadata +- **BAG API (Kadaster)** -- Reference implementation for Dutch base registration sync +- **BRK, BRP, HR APIs** -- Dutch government base registration APIs +- **Haal Centraal** -- VNG initiative for modern government API access +- **OData v4** -- OASIS standard for RESTful APIs with delta query support +- **RFC 7232** -- Conditional requests (If-Modified-Since) for incremental sync +- **CloudEvents v1.0** -- Event format for webhook payloads (already used by `WebhookService`) +- **Nextcloud BackgroundJob** -- `TimedJob` for scheduled sync, `QueuedJob` for execution pipeline +- **Nextcloud ICrypto / ICredentialsManager** -- Secure credential storage for source authentication diff --git a/openspec/changes/deprecate-published-metadata/specs/deprecate-published-metadata/spec.md b/openspec/changes/deprecate-published-metadata/specs/deprecate-published-metadata/spec.md new file mode 100644 index 000000000000..5e68bf113f01 --- /dev/null +++ b/openspec/changes/deprecate-published-metadata/specs/deprecate-published-metadata/spec.md @@ -0,0 +1,59 @@ +# Spec: Deprecate Published/Depublished Object Metadata + +## Overview + +Remove the dedicated `published`/`depublished` object metadata system from OpenRegister. The RBAC `$now` dynamic variable (already implemented) replaces this functionality for authorization-based visibility control. + +## Scope + +**In scope (OpenRegister only):** +- Remove `addPublishedDateToObjects()` from ImportService and auto-publish import logic +- Remove `@self.published`/`@self.depublished` references from frontend copy modals +- Remove object "published" stats from dashboard, register, and schema views +- Update MultiTenancyTrait documentation to remove object-level published bypass references +- Add deprecation log warnings for schema config keys if encountered + +**Out of scope:** +- Register/Schema `published`/`depublished` fields (multi-tenancy bypass system) +- File publish/depublish (Nextcloud share management, `autoPublish` in FilePropertyHandler) +- Configuration `publishToGitHub` (GitHub export) +- OpenCatalogi and Softwarecatalogus changes (separate repos) +- `SearchTrailMapper.published_only` (historical tracking data) +- MagicMapper columns (already removed) +- Object publish/depublish API routes (already removed) +- ObjectEntity published/depublished properties (already removed) + +## Requirements + +### REQ-1: ImportService Published Date Removal +- GIVEN an import operation with `publish=true` +- WHEN objects are imported via JSON or CSV +- THEN the `addPublishedDateToObjects()` logic is removed +- AND the `$publish` parameter is ignored with a deprecation log warning +- AND existing import functionality continues to work without published date injection + +### REQ-2: Frontend Copy Modal Cleanup +- GIVEN a user copies an object via CopyObject or MassCopyObjects modal +- WHEN the `@self` metadata is stripped from the copy +- THEN `published` and `depublished` keys are no longer deleted (they don't exist) + +### REQ-3: Frontend Stats Cleanup +- GIVEN dashboard, register detail, or schema detail views +- WHEN object statistics are displayed +- THEN the "published" count row/column is removed from the stats display + +### REQ-4: Import UI Cleanup +- GIVEN the ImportRegister modal +- WHEN a user configures an import +- THEN the "Auto-publish imported objects" toggle is removed + +### REQ-5: MultiTenancyTrait Documentation +- GIVEN the MultiTenancyTrait docblock +- WHEN describing multi-tenancy bypass +- THEN object-level published bypass references are removed +- AND Register/Schema published bypass documentation remains + +### REQ-6: Deprecation Warnings +- GIVEN a schema with `objectPublishedField`, `objectDepublishedField`, or `autoPublish` config keys +- WHEN an object is saved using that schema +- THEN a deprecation warning is logged suggesting migration to RBAC rules with `$now` diff --git a/openspec/changes/fix-date-histogram-mariadb/specs/faceting-configuration/spec.md b/openspec/changes/fix-date-histogram-mariadb/specs/faceting-configuration/spec.md new file mode 100644 index 000000000000..4fd6161cf83c --- /dev/null +++ b/openspec/changes/fix-date-histogram-mariadb/specs/faceting-configuration/spec.md @@ -0,0 +1,67 @@ +## ADDED Requirements + +### Requirement: Date histogram facets MUST work on both PostgreSQL and MariaDB +`MagicFacetHandler` MUST produce correctly bucketed `date_histogram` facet results on both PostgreSQL and MariaDB/MySQL for every supported interval (`day`, `week`, `month`, `quarter`, `year`). The date-key SQL expression MUST be selected based on the database platform detected via `$this->db->getDatabasePlatform() instanceof \Doctrine\DBAL\Platforms\PostgreSQLPlatform`, using `TO_CHAR()` with PostgreSQL format patterns on PostgreSQL and `DATE_FORMAT()` (plus `CONCAT(YEAR(), '-Q', QUARTER())` for quarter) on MariaDB/MySQL. Returning an empty `buckets` array on MariaDB when data is present is a defect. + +#### Scenario: Year interval on MariaDB +- **GIVEN** MariaDB is the active database platform +- **AND** a schema-backed table contains a `datetime` column `publicatiedatum` with rows `2023-05-01`, `2024-06-15`, `2024-11-30` +- **WHEN** `MagicFacetHandler.getDateHistogramFacet()` is called with `interval: 'year'` +- **THEN** the result MUST be `{ type: 'date_histogram', interval: 'year', buckets: [{ key: '2023', results: 1, from: '2023-01-01', to: '2023-12-31' }, { key: '2024', results: 2, from: '2024-01-01', to: '2024-12-31' }] }` +- **AND** the underlying SQL MUST use `DATE_FORMAT(publicatiedatum, '%Y')`, NOT `TO_CHAR(publicatiedatum, 'YYYY')` + +#### Scenario: Month interval on MariaDB +- **GIVEN** MariaDB is the active database platform +- **AND** a schema-backed table contains `datetime` values in months `2025-01`, `2025-01`, `2025-03` +- **WHEN** `getDateHistogramFacet()` is called with `interval: 'month'` +- **THEN** the result MUST contain buckets keyed `'2025-01'` (count 2) and `'2025-03'` (count 1) +- **AND** the SQL MUST use `DATE_FORMAT(..., '%Y-%m')` + +#### Scenario: Quarter interval on MariaDB +- **GIVEN** MariaDB is the active database platform +- **AND** `datetime` values in Q1 2024 and Q3 2024 +- **WHEN** `getDateHistogramFacet()` is called with `interval: 'quarter'` +- **THEN** the SQL MUST use `CONCAT(YEAR(...), '-Q', QUARTER(...))` to produce keys `'2024-Q1'` and `'2024-Q3'` +- **AND** each bucket MUST include correct `from`/`to` dates for the quarter + +#### Scenario: Year interval on PostgreSQL unchanged +- **GIVEN** PostgreSQL is the active database platform +- **WHEN** `getDateHistogramFacet()` is called with `interval: 'year'` +- **THEN** the SQL MUST use `TO_CHAR(publicatiedatum, 'YYYY')` as it does today +- **AND** bucket keys MUST remain identical to current behavior + +#### Scenario: UNION date histogram across schemas on MariaDB +- **GIVEN** MariaDB is the active database platform +- **AND** two magic tables each contain a `datetime` column `created_on` +- **WHEN** `MagicFacetHandler.getDateHistogramFacetUnion()` is called with `interval: 'month'` +- **THEN** each UNION sub-query MUST use `DATE_FORMAT(created_on, '%Y-%m')`, NOT `TO_CHAR(...)` +- **AND** merged counts MUST be the sum per bucket key across all tables + +### Requirement: Weekly histogram buckets MUST use ISO week numbering on all databases +`MagicFacetHandler`, `MariaDbFacetHandler`, and `MetaDataFacetHandler` MUST produce identical bucket keys for the `week` interval regardless of the underlying database platform. The key format MUST be ISO 8601 year + ISO 8601 week (`YYYY-WW` where both components follow ISO 8601 week numbering: Monday as first day of week, week 1 is the week containing the first Thursday of the year). This means `TO_CHAR(field, 'IYYY-IW')` on PostgreSQL and `DATE_FORMAT(field, '%x-%v')` on MariaDB/MySQL. Use of `%Y-%u` (non-ISO week, year from date) is forbidden because it disagrees with PostgreSQL around Jan 1. + +#### Scenario: Week spanning year boundary produces ISO-aligned key +- **GIVEN** a date of 2023-01-01 (Sunday; ISO week 52 of 2022) +- **WHEN** a weekly histogram bucket is computed on either database +- **THEN** the bucket key MUST be `'2022-52'` +- **AND** both databases MUST produce the same key for the same input + +#### Scenario: MariaDB week format uses ISO components +- **GIVEN** MariaDB is the active database platform +- **WHEN** the date-key SQL expression is built for `interval: 'week'` +- **THEN** it MUST be `DATE_FORMAT(, '%x-%v')` +- **AND** NOT `DATE_FORMAT(, '%Y-%u')` + +### Requirement: Weekly histogram bucket bounds MUST reflect ISO week start/end +When a `date_histogram` facet returns buckets with `interval: 'week'`, each bucket's `from` date MUST be the Monday of the ISO week identified by the bucket key, and `to` MUST be the Sunday of that same ISO week. Bucket bounds MUST NOT be derived by parsing the bucket key as a month (`strtotime('YYYY-WW')` does not parse a week) — they MUST be computed via an ISO-aware routine such as PHP's `DateTime::setISODate()`. + +#### Scenario: Week 12 of 2025 has correct ISO bounds +- **GIVEN** a bucket with key `'2025-12'` from a weekly histogram +- **WHEN** `getDateBoundsForBucket('2025-12', 'week')` is called +- **THEN** it MUST return `{ from: '2025-03-17', to: '2025-03-23' }` (Monday–Sunday of ISO week 12, 2025) +- **AND** NOT `{ from: '2025-12-01', to: '2025-12-31' }` (which is the current bug — December 2025) + +#### Scenario: Week 1 of 2024 is the week containing the first Thursday +- **GIVEN** a bucket with key `'2024-01'` from a weekly histogram +- **WHEN** bounds are computed +- **THEN** it MUST return `{ from: '2024-01-01', to: '2024-01-07' }` (Monday Jan 1 through Sunday Jan 7, 2024) diff --git a/openspec/changes/fix-empty-string-date-conversion/specs/datetime-input-handling/spec.md b/openspec/changes/fix-empty-string-date-conversion/specs/datetime-input-handling/spec.md new file mode 100644 index 000000000000..7b61b3a7222f --- /dev/null +++ b/openspec/changes/fix-empty-string-date-conversion/specs/datetime-input-handling/spec.md @@ -0,0 +1,136 @@ +## ADDED Requirements + +### Requirement: Empty input SHALL normalize to null + +User-supplied datetime input values of `null`, the empty string `""`, or a string consisting only of whitespace characters SHALL normalize to `null` when passed through the datetime normalization helper. No value SHALL be synthesized (no defaulting to "now" or any other timestamp). + +#### Scenario: Null input + +- **WHEN** the normalizer receives `null` +- **THEN** it SHALL return `null` +- **AND** no `DateTime` object SHALL be constructed + +#### Scenario: Empty-string input + +- **WHEN** the normalizer receives the empty string `""` +- **THEN** it SHALL return `null` +- **AND** no `DateTime` object SHALL be constructed + +#### Scenario: Whitespace-only input + +- **WHEN** the normalizer receives a string containing only whitespace (e.g. `" "`, `"\t"`, `"\n"`) +- **THEN** it SHALL return `null` +- **AND** no `DateTime` object SHALL be constructed + +### Requirement: Valid datetime input SHALL parse correctly + +User-supplied datetime input that is a non-empty, parseable string SHALL be normalized into a `DateTimeImmutable` (or the equivalent formatted string for the requested output format). + +#### Scenario: ISO 8601 with timezone + +- **WHEN** the normalizer receives `"2026-04-20T14:00:00+02:00"` +- **THEN** it SHALL return a `DateTimeImmutable` representing that instant + +#### Scenario: ISO 8601 UTC Zulu + +- **WHEN** the normalizer receives `"2026-04-20T14:00:00Z"` +- **THEN** it SHALL return a `DateTimeImmutable` representing that instant + +#### Scenario: Database datetime format + +- **WHEN** the normalizer receives `"2026-04-20 14:00:00"` +- **THEN** it SHALL return a `DateTimeImmutable` representing that instant (local/default timezone) + +#### Scenario: Date-only format + +- **WHEN** the normalizer receives `"2026-04-20"` +- **THEN** it SHALL return a `DateTimeImmutable` at midnight of that date + +#### Scenario: Existing DateTime instance + +- **WHEN** the normalizer receives an existing `DateTimeInterface` instance +- **THEN** it SHALL return a `DateTimeImmutable` equal to that instant + +### Requirement: Malformed input SHALL normalize to null without raising + +Input that is a non-empty string but cannot be parsed as a datetime SHALL normalize to `null`. The normalizer SHALL NOT throw; it SHALL log at debug level for traceability. + +#### Scenario: Garbled string + +- **WHEN** the normalizer receives `"not-a-date"` +- **THEN** it SHALL return `null` +- **AND** a debug-level log entry SHALL be emitted referencing the input + +#### Scenario: Numeric input (not accepted) + +- **WHEN** the normalizer receives a number (e.g. `1745150400`) +- **THEN** it SHALL return `null` +- **AND** a debug-level log entry SHALL be emitted + +### Requirement: Normalizer SHALL offer canonical output formats + +For callers that need a formatted string rather than a `DateTimeImmutable`, the normalizer SHALL expose deterministic formatters. + +#### Scenario: Database format + +- **WHEN** a caller requests the database format for a valid input +- **THEN** the result SHALL be `"Y-m-d H:i:s"`-formatted +- **AND** empty or invalid input SHALL produce `null` (not the empty string) + +#### Scenario: ISO 8601 format + +- **WHEN** a caller requests the ISO 8601 format for a valid input +- **THEN** the result SHALL be an ISO 8601 string with timezone offset +- **AND** empty or invalid input SHALL produce `null` (not the empty string) + +### Requirement: User-defined date/date-time properties SHALL render null when empty + +When OpenRegister renders an object whose user-defined property is declared with JSON Schema `format: "date"` or `format: "date-time"`, and the stored value is `null`, `""`, or whitespace-only, the rendered value SHALL be `null`. The backend SHALL NOT substitute the current date-time or any other synthesized value. + +#### Scenario: Empty stored date-time on read + +- **WHEN** an object has a user-defined property `publishedAt` with `format: "date-time"` whose stored value is `""` +- **AND** the object is rendered via the standard read path +- **THEN** the rendered `publishedAt` SHALL be `null` +- **AND** the response SHALL NOT contain the current date-time for that field + +#### Scenario: Null stored date on read + +- **WHEN** an object has a user-defined property `birthDate` with `format: "date"` whose stored value is `null` +- **AND** the object is rendered via the standard read path +- **THEN** the rendered `birthDate` SHALL be `null` + +### Requirement: Metadata datetime fields SHALL not accept empty-string input as "now" + +When writing an object, if the caller explicitly provides `""` or a whitespace-only string for a metadata field that accepts a datetime (e.g. `expires`), the field SHALL be persisted as `null`, not as the current date-time. The existing behavior of defaulting `created`/`updated` to the current date-time when the field is absent (key not present) is preserved. + +#### Scenario: Absent created field (unchanged) + +- **WHEN** an object is written without a `created` field in the incoming data +- **THEN** `created` SHALL be populated with the current date-time (existing behavior preserved) + +#### Scenario: Empty-string expires field + +- **WHEN** an object is written with `expires: ""` +- **THEN** `expires` SHALL be persisted as `null` +- **AND** the current date-time SHALL NOT be used + +### Requirement: Search normalization SHALL treat empty input as no constraint + +The MariaDB search path's date normalization SHALL treat `null`, empty-string, and whitespace-only input as "no constraint" by returning `null`, enabling callers to drop the predicate rather than injecting a bogus filter value. + +#### Scenario: Empty-string date search parameter + +- **WHEN** a search filter is invoked with `value = ""` for a date field +- **THEN** the normalization helper SHALL return `null` +- **AND** the SQL builder SHALL NOT emit a comparison against the empty string or the current date-time + +### Requirement: Single canonical implementation point + +All OpenRegister code paths that convert user-supplied datetime strings to `DateTime`/`DateTimeImmutable` or to a database datetime string SHALL delegate to the shared datetime normalization helper. Direct use of `new DateTime($value)` with user-supplied values SHALL be removed from the identified sites. + +#### Scenario: No unguarded DateTime construction on user input + +- **WHEN** the codebase is audited for `new DateTime(` on user-supplied values +- **THEN** every call site SHALL either delegate to the normalizer or demonstrably operate on values already produced by the normalizer +- **AND** new call sites SHALL be prevented by code review — documented in the helper's class docblock diff --git a/openspec/changes/fix-magic-table-type-coercion/specs/schema-driven-read-coercion/spec.md b/openspec/changes/fix-magic-table-type-coercion/specs/schema-driven-read-coercion/spec.md new file mode 100644 index 000000000000..6cb068e862c9 --- /dev/null +++ b/openspec/changes/fix-magic-table-type-coercion/specs/schema-driven-read-coercion/spec.md @@ -0,0 +1,157 @@ +## ADDED Requirements + +### Requirement: Single shared schema-type converter on read + +The system SHALL provide a single `SchemaTypeConverter` service in `lib/Service/Object/` whose `convertValue(mixed $value, string $schemaType): mixed` method is the only place that converts a database column value to a JSON-Schema-typed PHP value. + +Both magic-table read paths — `MagicStatisticsHandler::convertRowToObjectEntity` (single-object find, UNION search across schemas, cross-table lookup) and `MagicSearchHandler::convertRowToObjectEntity` (search) — MUST delegate every per-property conversion to this service. Inline per-type converters (`convertValueByType`, `convertStringValue`, `convertBooleanValue`, `convertNumberValue`, `convertIntegerValue`, `convertArrayOrObjectValue`) MUST NOT remain on either handler after this change lands. + +#### Scenario: Single source of truth for read coercion + +- **WHEN** a developer searches the codebase for type-conversion logic that runs against a magic-table row +- **THEN** the only implementation found is `SchemaTypeConverter::convertValue` and its private helpers +- **AND** both handlers reference the converter via constructor-injected service + +#### Scenario: Both read paths produce identical output for identical input + +- **WHEN** the same `(value, schemaType)` pair is passed to both `MagicStatisticsHandler` and `MagicSearchHandler` row converters +- **THEN** the resulting property value on the `ObjectEntity` is identical in both PHP type and content + +### Requirement: `string` properties always return PHP `string` + +When the schema declares a property as `type: string`, the converter SHALL return a PHP `string` for any non-null value. Numeric, boolean, and other scalar inputs MUST be cast via `(string) $value`. Inputs that are already strings MUST be returned unchanged unless they begin with `[` or `{` and parse as valid JSON, in which case they MAY be decoded for backward compatibility with schemas that historically stored array/object data under a `string` type. + +#### Scenario: Numeric DB value coerces to string + +- **WHEN** the schema property is `{ "type": "string" }` and the row contains the integer `45` +- **THEN** the returned property value is the string `"45"` + +#### Scenario: Boolean-literal JSON is not decoded + +- **WHEN** the schema property is `{ "type": "string" }` and the row contains the string `"true"` +- **THEN** the returned property value is the string `"true"` (not the boolean `true`) + +#### Scenario: Null-literal JSON is not decoded + +- **WHEN** the schema property is `{ "type": "string" }` and the row contains the string `"null"` +- **THEN** the returned property value is the string `"null"` (not PHP `null`, and the property is not silently dropped) + +#### Scenario: Quoted-string JSON is not unwrapped + +- **WHEN** the schema property is `{ "type": "string" }` and the row contains the string `'"foo"'` (six characters including the literal quotes) +- **THEN** the returned property value is the string `'"foo"'` with quotes intact + +#### Scenario: Array-shaped string is decoded for backward compatibility + +- **WHEN** the schema property is `{ "type": "string" }` and the row contains the string `'[1,2,3]'` +- **THEN** the returned property value is the array `[1, 2, 3]` (preserves historical behavior for schemas with mismatched type declarations) + +### Requirement: `boolean` properties always return PHP `bool` + +When the schema declares a property as `type: boolean`, the converter SHALL return a PHP `bool` for any non-null value. The conversion SHALL accept: + +- native `bool` (returned unchanged), +- the strings `"true"`, `"1"`, `"yes"` (case-insensitive) → `true`; any other string → `false`, +- any other type → `(bool) $value` (so int `0` → `false`, int `1` → `true`). + +#### Scenario: MariaDB TINYINT(1) result coerces to bool + +- **WHEN** the schema property is `{ "type": "boolean" }` and the row contains the integer `1` (as returned by mysqlnd from a TINYINT(1) column) +- **THEN** the returned property value is PHP `true` + +#### Scenario: MariaDB false coerces to bool + +- **WHEN** the schema property is `{ "type": "boolean" }` and the row contains the integer `0` +- **THEN** the returned property value is PHP `false` + +#### Scenario: PostgreSQL native bool passes through + +- **WHEN** the schema property is `{ "type": "boolean" }` and the row contains the PHP boolean `true` (as returned by the PostgreSQL driver from a `BOOLEAN` column) +- **THEN** the returned property value is PHP `true` + +#### Scenario: String "yes" coerces to bool + +- **WHEN** the schema property is `{ "type": "boolean" }` and the row contains the string `"yes"` +- **THEN** the returned property value is PHP `true` + +### Requirement: `integer` properties return PHP `int` for numeric input + +When the schema declares a property as `type: integer`, the converter SHALL return a PHP `int` for any value that PHP's `is_numeric()` accepts. Non-numeric values are returned unchanged so that a downstream JSON-Schema validator can reject them. + +#### Scenario: Numeric string coerces to int + +- **WHEN** the schema property is `{ "type": "integer" }` and the row contains the string `"42"` +- **THEN** the returned property value is the integer `42` + +#### Scenario: Already-integer passes through + +- **WHEN** the schema property is `{ "type": "integer" }` and the row contains the integer `42` +- **THEN** the returned property value is the integer `42` + +### Requirement: `number` properties return PHP `float` for numeric input + +When the schema declares a property as `type: number`, the converter SHALL return a PHP `float` for any value that PHP's `is_numeric()` accepts. + +#### Scenario: Integer DB value coerces to float + +- **WHEN** the schema property is `{ "type": "number" }` and the row contains the integer `7` +- **THEN** the returned property value is the float `7.0` + +#### Scenario: Decimal string coerces to float + +- **WHEN** the schema property is `{ "type": "number" }` and the row contains the string `"3.14"` +- **THEN** the returned property value is the float `3.14` + +### Requirement: `array` and `object` properties are JSON-decoded only under their schema type + +When the schema declares a property as `type: array` or `type: object`, the converter SHALL JSON-decode any string-shaped value and return the resulting PHP array. Values that are already arrays MUST be returned unchanged. Strings that fail to decode MUST be returned as the original string so the JSON-Schema validator can flag them. + +JSON decoding MUST NOT run for any other schema type. The converter MUST NOT contain a fall-through "if value is JSON, decode it" path. + +#### Scenario: JSON-string array column is decoded + +- **WHEN** the schema property is `{ "type": "array" }` and the row contains the string `'[1,2,3]'` +- **THEN** the returned property value is the PHP array `[1, 2, 3]` + +#### Scenario: Already-array column passes through + +- **WHEN** the schema property is `{ "type": "object" }` and the row already holds the PHP array `['key' => 'value']` (e.g. from a JSON column the driver pre-decoded) +- **THEN** the returned property value is the PHP array `['key' => 'value']` unchanged + +#### Scenario: Numeric-looking value under string type is not decoded + +- **WHEN** the schema property is `{ "type": "string" }` and the row contains the string `"123"` +- **THEN** the returned property value is the string `"123"` and is NOT passed through `json_decode` + +### Requirement: `null` is preserved across all schema types + +When the row value is `null`, the converter SHALL return `null` regardless of the schema type. No coercion runs on a `null` input. + +#### Scenario: Null integer column + +- **WHEN** the schema property is `{ "type": "integer" }` and the row contains `null` (nullable column with no value) +- **THEN** the returned property value is `null` + +#### Scenario: Null boolean column + +- **WHEN** the schema property is `{ "type": "boolean" }` and the row contains `null` +- **THEN** the returned property value is `null` (NOT `false`) + +### Requirement: Unknown schema types fall through unchanged + +When the schema declares a property with an unrecognized `type` (e.g. a typo, a custom type, or an empty string), the converter SHALL apply the same backward-compatible handling as the `string` branch — pass strings through and only attempt JSON decoding if the value begins with `[` or `{`. + +#### Scenario: Unknown type passes the value through + +- **WHEN** the schema property has `{ "type": "mystery" }` and the row contains the string `"hello"` +- **THEN** the returned property value is the string `"hello"` + +### Requirement: Read-side format handling stays in the handler + +Format-specific normalization (e.g. `format: date`, `format: date-time`) SHALL NOT be the converter's responsibility. The handler that calls the converter MUST continue to apply its existing format normalization (via `DateTimeNormalizer`) after the converter has produced the schema-typed value. + +#### Scenario: Date-formatted string column + +- **WHEN** the schema property is `{ "type": "string", "format": "date" }` and the row contains the string `"2026-04-30T10:00:00+02:00"` +- **THEN** the converter returns the string unchanged +- **AND** the handler applies `DateTimeNormalizer::normalize` and produces `"2026-04-30"` on the resulting `ObjectEntity` diff --git a/openspec/changes/fix-nc34-server-accessor-removals/specs/nextcloud-api-compat/spec.md b/openspec/changes/fix-nc34-server-accessor-removals/specs/nextcloud-api-compat/spec.md new file mode 100644 index 000000000000..776b23627d89 --- /dev/null +++ b/openspec/changes/fix-nc34-server-accessor-removals/specs/nextcloud-api-compat/spec.md @@ -0,0 +1,81 @@ +## ADDED Requirements + +### Requirement: Public OCP API Only + +Application code in `lib/` SHALL interact with Nextcloud services exclusively through the public `\OCP` API. Direct use of the internal `\OC\Server` container — including the `\OC::$server` static property and any of its named accessors (`getSystemConfig`, `getDatabaseConnection`, `getLogger`, `getUserSession`, `getRequest`, `getURLGenerator`, `getGroupManager`, `getL10NFactory`, `getCsrfTokenManager`, `getContentSecurityPolicyNonceManager`, `getRegisteredAppContainer`, and any future accessor on `\OC\Server`) — is prohibited. + +#### Scenario: Class needs the system config +- **WHEN** a class in `lib/` needs to read a system-wide Nextcloud config value +- **THEN** the class MUST declare `\OCP\IConfig` as a constructor parameter and call `$this->config->getSystemValue(...)` at the call site +- **AND** the class MUST NOT call `\OC::$server->getSystemConfig()` or `\OCP\Server::get(IConfig::class)` as a replacement + +#### Scenario: Class needs the database connection +- **WHEN** a class in `lib/` needs a database connection +- **THEN** the class MUST declare `\OCP\IDBConnection` as a constructor parameter +- **AND** the class MUST NOT call `\OC::$server->getDatabaseConnection()` or `\OCP\Server::get(IDBConnection::class)` as a replacement + +#### Scenario: Class needs a logger +- **WHEN** a class in `lib/` needs to log +- **THEN** the class MUST declare `\Psr\Log\LoggerInterface` as a constructor parameter +- **AND** the class MUST NOT call `\OC::$server->getLogger()` + +### Requirement: Constructor Dependency Injection + +All services, controllers, mappers, background jobs, migrations, notifiers, and commands in `lib/` SHALL receive their Nextcloud framework collaborators via constructor dependency injection. Service-locator patterns — `\OCP\Server::get(X::class)` and `\OC::$server->get(X::class)` — SHALL NOT be introduced in new app code. They MAY remain in code paths that pre-exist this change and are not modified by it; when such a call site is touched for any reason, it MUST be migrated to constructor DI as part of the change. + +#### Scenario: New class needs a Nextcloud service +- **WHEN** a new class is added to `lib/` that needs any Nextcloud service +- **THEN** the class MUST declare the required OCP interface (or Nextcloud-provided concrete class for items without an OCP interface, e.g. `ContentSecurityPolicyNonceManager`, `CsrfTokenManager`) as a constructor parameter +- **AND** the class MUST store it as a `private readonly` property + +#### Scenario: Migration needs a database connection +- **WHEN** a `SimpleMigrationStep` subclass under `lib/Migration/` needs a database connection +- **THEN** the migration MUST declare `\OCP\IDBConnection` as a constructor parameter +- **AND** Nextcloud's `MigrationService::createInstance` SHALL resolve the migration via `\OCP\Server::get($class)` on all supported Nextcloud versions (28–34), so no service-locator fallback is required in the migration body + +### Requirement: Static-Analysis Enforcement via PHPCS Sniff + +The project SHALL ship a custom PHPCS sniff that fails the `composer phpcs` (and therefore `composer check:strict`) check when `lib/` contains a usage of `\OC::$server` — whether a named accessor (`\OC::$server->getX()`), a PSR-11 `get` (`\OC::$server->get(...)`), or any other access against the `\OC::$server` static property. The sniff SHALL apply to all files in `lib/`. No allowlist SHALL be added for specific call sites or file patterns. + +#### Scenario: New commit reintroduces the pattern +- **WHEN** a developer commits code containing `\OC::$server->getX()` in `lib/` +- **THEN** `composer phpcs` SHALL report an error identifying the file and line +- **AND** `composer check:strict` SHALL exit non-zero +- **AND** the CI pipeline SHALL fail before merge + +#### Scenario: New commit uses OCP interfaces correctly +- **WHEN** a developer commits code that uses `\OCP\IConfig` via constructor injection +- **THEN** `composer phpcs` SHALL pass for that file + +#### Scenario: Existing code uses PSR-11 service-locator via \OC::$server +- **WHEN** PHPCS scans a file containing `\OC::$server->get(IConfig::class)` +- **THEN** the sniff SHALL flag this as an error +- **AND** the developer is expected to migrate the call to constructor DI + +### Requirement: Approved Migration Targets for Removed Accessors + +Each removed Nextcloud named accessor SHALL have a documented OCP replacement that applications use via constructor injection. The mapping SHALL be: + +| Removed accessor | Replacement (inject via constructor) | +|---|---| +| `\OC::$server->getSystemConfig()` | `\OCP\IConfig` (call `getSystemValue`/`setSystemValue`) | +| `\OC::$server->getDatabaseConnection()` | `\OCP\IDBConnection` | +| `\OC::$server->getLogger()` | `\Psr\Log\LoggerInterface` | +| `\OC::$server->getUserSession()` | `\OCP\IUserSession` | +| `\OC::$server->getRequest()` | `\OCP\IRequest` | +| `\OC::$server->getURLGenerator()` | `\OCP\IURLGenerator` | +| `\OC::$server->getGroupManager()` | `\OCP\IGroupManager` | +| `\OC::$server->getL10NFactory()` | `\OCP\L10N\IFactory` | +| `\OC::$server->getCsrfTokenManager()` | `\OC\Security\CSRF\CsrfTokenManager` (inject the concrete class; no OCP interface exists) | +| `\OC::$server->getContentSecurityPolicyNonceManager()` | `\OC\Security\CSP\ContentSecurityPolicyNonceManager` (inject the concrete class; no OCP interface exists) | +| `\OC::$server->getRegisteredAppContainer($appId)` | Inject the specific collaborator the code actually needs; avoid raw container access | + +#### Scenario: Developer looks up replacement for a removed accessor +- **WHEN** a developer encounters a removed `\OC::$server->getX()` accessor during maintenance +- **THEN** the replacement SHALL be found in the mapping table in this spec +- **AND** the developer SHALL migrate the call to constructor DI using the listed replacement + +#### Scenario: Nextcloud adds a new framework service +- **WHEN** Nextcloud introduces a new OCP interface that OpenRegister needs +- **THEN** the mapping table in this spec SHALL be extended in the change that first depends on it +- **AND** the new service SHALL be consumed via constructor DI from its first use diff --git a/openspec/changes/fix-object-files-listing-lock-and-limit/specs/object-interactions/spec.md b/openspec/changes/fix-object-files-listing-lock-and-limit/specs/object-interactions/spec.md new file mode 100644 index 000000000000..242062e401e3 --- /dev/null +++ b/openspec/changes/fix-object-files-listing-lock-and-limit/specs/object-interactions/spec.md @@ -0,0 +1,110 @@ +## MODIFIED Requirements + +### Requirement: File Attachments on Objects + +The system SHALL provide file attachment operations as sub-resource endpoints under objects. Files MUST be stored in Nextcloud's filesystem via `OCP\Files\IRootFolder` and linked to OpenRegister objects. The system MUST support upload, download, listing, deletion, and publish/depublish operations. The listing operation MUST honour any positive user-supplied `_limit` parameter without imposing an upper cap (default 30, floor 1), MUST NOT fail when individual files are held under a Nextcloud file lock, and MUST include `locked` and optional `lock` metadata on every entry when the caller is authenticated. For unauthenticated callers the listing MUST NOT include `locked` or `lock` in any file entry. + +#### Scenario: Upload a file to an object +- **GIVEN** an OpenRegister object with UUID `abc-123` +- **WHEN** a POST request is sent to `/api/objects/{register}/{schema}/abc-123/files` with a file payload +- **THEN** the file MUST be stored in the Nextcloud filesystem +- **AND** the file MUST be linked to the object +- **AND** the response MUST return HTTP 201 with the file metadata + +#### Scenario: List files for an object (authenticated caller) +- **GIVEN** an authenticated user and object `abc-123` with 3 attached files +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/files` +- **THEN** the response MUST return all 3 files with metadata including `fileId`, `name`, `mimeType`, `size`, and `locked` + +#### Scenario: List files for an object (anonymous caller) +- **GIVEN** no authenticated session (`IUserSession::getUser()` returns `null`) and a publicly accessible object `abc-123` with 3 attached files +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/files` +- **THEN** the response MUST return all 3 files with metadata including `fileId`, `name`, `mimeType`, `size` +- **AND** NO file entry MUST include a `locked` field +- **AND** NO file entry MUST include a `lock` sub-object +- **AND** no call to `ILockManager::getLocks()` MUST be attempted for this request + +#### Scenario: List files honours user-supplied `_limit` without a ceiling +- **GIVEN** object `abc-123` has 500 attached files +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/files?_limit=500&_page=1` +- **THEN** the response MUST return 500 file entries (not silently clamped to 100) +- **AND** the pagination envelope MUST report `limit: 500` + +#### Scenario: Large `_limit` values are honoured as-is +- **GIVEN** object `abc-123` has 2500 attached files +- **WHEN** a GET request is sent with `?_limit=5000` +- **THEN** the response MUST return all 2500 entries +- **AND** the pagination envelope MUST report `limit: 5000` +- **AND** the system MUST NOT apply any upper ceiling to the `_limit` value + +#### Scenario: `_limit=0` or negative is clamped to 1 +- **WHEN** a GET request is sent with `?_limit=0` or `?_limit=-10` +- **THEN** the response MUST return at least 1 entry (or 0 if no files exist) and the pagination envelope MUST report `limit: 1` + +#### Scenario: Missing `_limit` uses the default +- **WHEN** a GET request is sent with no `_limit` query parameter +- **THEN** the pagination envelope MUST report `limit: 30` + +#### Scenario: Listing is resilient to Nextcloud-locked files (authenticated caller) +- **GIVEN** an authenticated user and object `abc-123` with 5 attached files, one of which is held under a Nextcloud file lock by another user +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/files` +- **THEN** the response MUST return HTTP 200 with all 5 file entries +- **AND** the locked file's entry MUST have `locked: true` and a `lock` sub-object with `type`, `scope`, `owner`, `createdAt`, and optional `expiresAt` +- **AND** each unlocked file entry MUST have `locked: false` and no `lock` sub-object +- **AND** one structured log line at `info` level MUST be emitted per locked file, including `fileId`, `name`, and lock owner + +#### Scenario: Listing is resilient to Nextcloud-locked files (anonymous caller) +- **GIVEN** no authenticated session and a publicly accessible object `abc-123` with 5 attached files, one of which is held under a Nextcloud file lock +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/files` +- **THEN** the response MUST return HTTP 200 with all 5 file entries +- **AND** NO file entry MUST include `locked` or `lock` +- **AND** the locked file's entry MUST still be present in the result set (not silently elided) +- **AND** one structured log line at `info` level MUST still be emitted server-side per locked file, so operators retain traceability even when the field is hidden from the caller + +#### Scenario: `lock.type` maps Nextcloud lock constants to string aliases +- **GIVEN** a file is locked with `ILock::TYPE_USER` +- **WHEN** the file is formatted in a listing response +- **THEN** `lock.type` MUST equal `"user"` +- **AND** `TYPE_APP` maps to `"app"`, `TYPE_TOKEN` maps to `"token"` +- **AND** `lock.scope` MUST be `"exclusive"` for `ILock::LOCK_EXCLUSIVE` and `"shared"` for `ILock::LOCK_SHARED` + +#### Scenario: `lock.expiresAt` is null when the lock has no timeout +- **GIVEN** a lock with `getTimeout()` returning `0` (no timeout) +- **WHEN** the file is formatted in a listing response +- **THEN** `lock.expiresAt` MUST be `null` +- **AND** `lock.createdAt` MUST still be an ISO 8601 string + +#### Scenario: Lock provider is not available +- **GIVEN** the `files_lock` app is disabled, `ILockManager::isLockProviderAvailable()` returns `false`, and the caller is authenticated +- **WHEN** any file is formatted in a listing response +- **THEN** each file entry MUST have `locked: false` +- **AND** no file entry MUST include a `lock` sub-object +- **AND** no call to `ILockManager::getLocks()` MUST be attempted + +#### Scenario: Listing does not read file contents to probe ownership +- **GIVEN** object `abc-123` has attached files of varying sizes (including a 2 GB file) +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/files` +- **THEN** the ownership probe MUST use `$file->isReadable()` (a pure permission-bitmask check) +- **AND** the listing MUST NOT call `$file->getContent()` or otherwise read file bytes during formatting +- **AND** the listing MUST NOT acquire a shared lock on any file during formatting + +#### Scenario: Ownership repair still runs when the current user can read the file +- **GIVEN** the current user can read file 42 (bitmask allows `PERMISSION_READ`) but is not recorded as its OpenRegister owner +- **WHEN** the file is encountered during listing +- **THEN** the ownership record MUST be repaired via `FileMapper::setFileOwnership($fileId, $userId)` (a direct DB write) +- **AND** no file bytes MUST be read as part of the repair + +#### Scenario: Download all files as archive +- **GIVEN** object `abc-123` has multiple attached files +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/files/download` +- **THEN** all files MUST be returned as a downloadable archive + +#### Scenario: Publish a file for public access +- **GIVEN** a file with ID 42 is attached to object `abc-123` +- **WHEN** a POST request is sent to `/api/objects/{register}/{schema}/abc-123/files/42/publish` +- **THEN** the file MUST be made publicly accessible via a share link + +#### Scenario: Delete a file from an object +- **GIVEN** a file with ID 42 is attached to object `abc-123` +- **WHEN** a DELETE request is sent to `/api/objects/{register}/{schema}/abc-123/files/42` +- **THEN** the file MUST be removed from the object and the filesystem diff --git a/openspec/changes/mail-sidebar/specs/mail-sidebar/spec.md b/openspec/changes/mail-sidebar/specs/mail-sidebar/spec.md new file mode 100644 index 000000000000..c3fbc0bdb76e --- /dev/null +++ b/openspec/changes/mail-sidebar/specs/mail-sidebar/spec.md @@ -0,0 +1,442 @@ +--- +status: proposed +--- + +# Mail Sidebar + +## Purpose + +Provide a sidebar panel inside the Nextcloud Mail app that displays OpenRegister objects related to the currently viewed email. This enables case handlers to see at a glance which cases, applications, or records are associated with an email -- and to create new associations -- without leaving the Mail app. The integration builds on the `openregister_email_links` table and `EmailService` established by the nextcloud-entity-relations spec. + +**Standards**: Nextcloud App Framework (script injection via `OCP\Util::addScript()`), REST API conventions (JSON responses, standard HTTP status codes), WCAG AA accessibility +**Cross-references**: [nextcloud-entity-relations](../../../specs/nextcloud-entity-relations/spec.md), [object-interactions](../../../specs/object-interactions/spec.md), [deep-link-registry](../../../specs/deep-link-registry/spec.md) + +--- + +## Requirements + +### Requirement: Reverse-lookup API to find objects by mail message ID + +The system SHALL provide a REST endpoint that accepts a Nextcloud Mail account ID and message ID, queries the `openregister_email_links` table, and returns all OpenRegister objects linked to that specific email message. For each linked object, the response MUST include the object's UUID, register ID, schema ID, title (derived from the object's data using the schema's title property), and the link metadata (who linked it and when). + +#### Rationale + +The existing `EmailsController` provides forward lookups (object -> emails). The sidebar needs the reverse: email -> objects. This endpoint is the primary data source for the sidebar's "Linked Objects" section. + +#### Scenario: Find objects linked to a specific email +- **GIVEN** email with account ID 1 and message ID 42 is linked to objects `abc-123` and `def-456` in the `openregister_email_links` table +- **WHEN** a GET request is sent to `/api/emails/by-message/1/42` +- **THEN** the response MUST return HTTP 200 with JSON: + ```json + { + "results": [ + { + "linkId": 1, + "objectUuid": "abc-123", + "registerId": 1, + "registerTitle": "Vergunningen", + "schemaId": 3, + "schemaTitle": "Omgevingsvergunning", + "objectTitle": "OV-2026-0042", + "linkedBy": "behandelaar-1", + "linkedAt": "2026-03-20T14:30:00+00:00" + }, + { + "linkId": 2, + "objectUuid": "def-456", + "registerId": 1, + "registerTitle": "Vergunningen", + "schemaId": 3, + "schemaTitle": "Omgevingsvergunning", + "objectTitle": "OV-2026-0043", + "linkedBy": "admin", + "linkedAt": "2026-03-21T09:15:00+00:00" + } + ], + "total": 2 + } + ``` +- **AND** each result MUST include `registerTitle` and `schemaTitle` resolved from the Register and Schema entities + +#### Scenario: No objects linked to this email +- **GIVEN** email with account ID 1 and message ID 99 has no entries in `openregister_email_links` +- **WHEN** a GET request is sent to `/api/emails/by-message/1/99` +- **THEN** the response MUST return HTTP 200 with `{"results": [], "total": 0}` + +#### Scenario: Invalid account ID or message ID +- **GIVEN** a GET request with non-numeric account or message ID +- **WHEN** the request is processed +- **THEN** the response MUST return HTTP 400 with `{"error": "Invalid account ID or message ID"}` + +--- + +### Requirement: Sender-based object discovery API + +The system SHALL provide a REST endpoint that accepts a sender email address and returns all OpenRegister objects that have ANY linked email from that sender. This enables the sidebar's "Other cases from this sender" discovery section. The results MUST be distinct by object UUID (no duplicates if multiple emails from the same sender are linked to the same object) and MUST include a count of how many emails from that sender are linked to each object. + +#### Rationale + +Case handlers need context beyond the current email. Knowing that the sender has 3 other open cases helps prioritize and cross-reference. This query leverages the `sender` column in `openregister_email_links`. + +#### Scenario: Discover objects by sender email +- **GIVEN** sender `burger@test.local` has emails linked to objects `abc-123` (2 emails), `ghi-789` (1 email) +- **WHEN** a GET request is sent to `/api/emails/by-sender?sender=burger@test.local` +- **THEN** the response MUST return HTTP 200 with: + ```json + { + "results": [ + { + "objectUuid": "abc-123", + "registerId": 1, + "registerTitle": "Vergunningen", + "schemaId": 3, + "schemaTitle": "Omgevingsvergunning", + "objectTitle": "OV-2026-0042", + "linkedEmailCount": 2 + }, + { + "objectUuid": "ghi-789", + "registerId": 2, + "registerTitle": "Meldingen", + "schemaId": 5, + "schemaTitle": "Melding", + "objectTitle": "ML-2026-0015", + "linkedEmailCount": 1 + } + ], + "total": 2 + } + ``` +- **AND** results MUST be ordered by `linkedEmailCount` descending (most-linked first) + +#### Scenario: No objects found for sender +- **GIVEN** sender `unknown@example.com` has no linked emails in any object +- **WHEN** a GET request is sent to `/api/emails/by-sender?sender=unknown@example.com` +- **THEN** the response MUST return HTTP 200 with `{"results": [], "total": 0}` + +#### Scenario: Missing sender parameter +- **GIVEN** a GET request to `/api/emails/by-sender` without the `sender` query parameter +- **WHEN** the request is processed +- **THEN** the response MUST return HTTP 400 with `{"error": "The sender parameter is required"}` + +#### Scenario: Sender discovery excludes current email's linked objects +- **GIVEN** the sidebar makes both a by-message and by-sender call +- **WHEN** the frontend renders the results +- **THEN** objects already shown in the "Linked Objects" section (from by-message) MUST be excluded from the "Other cases from this sender" section +- **AND** this filtering happens client-side to keep the API stateless + +--- + +### Requirement: Quick-link endpoint for sidebar use + +The system SHALL provide a POST endpoint that creates an email-object link with minimal input, designed for use from the Mail sidebar where the mail context (account ID, message ID, subject, sender, date) is already known. The endpoint MUST accept all required fields in one call and return the created link with resolved object metadata. + +#### Rationale + +The existing `POST /api/objects/{register}/{schema}/{id}/emails` endpoint requires knowing the register, schema, and object ID upfront and navigates from the object side. The sidebar needs to link from the email side -- the user sees the email and picks an object to link. The quick-link endpoint inverts the flow. + +#### Scenario: Quick-link an email to an object from the sidebar +- **GIVEN** an authenticated user viewing email (accountId: 1, messageId: 42, subject: "Aanvraag vergunning", sender: "burger@test.local", date: "2026-03-20T10:00:00Z") +- **WHEN** a POST request is sent to `/api/emails/quick-link` with body: + ```json + { + "mailAccountId": 1, + "mailMessageId": 42, + "mailMessageUid": "1234", + "subject": "Aanvraag vergunning", + "sender": "burger@test.local", + "date": "2026-03-20T10:00:00Z", + "objectUuid": "abc-123", + "registerId": 1 + } + ``` +- **THEN** a record MUST be created in `openregister_email_links` +- **AND** the `linkedBy` field MUST be set to the current authenticated user +- **AND** the response MUST return HTTP 201 with the created link including resolved `objectTitle`, `registerTitle`, `schemaTitle` + +#### Scenario: Quick-link with non-existent object +- **GIVEN** a POST with `objectUuid: "nonexistent-uuid"` +- **WHEN** the system validates the object +- **THEN** the response MUST return HTTP 404 with `{"error": "Object not found"}` + +#### Scenario: Quick-link duplicate prevention +- **GIVEN** email (accountId: 1, messageId: 42) is already linked to object `abc-123` +- **WHEN** a POST request tries to create the same link +- **THEN** the response MUST return HTTP 409 with `{"error": "Email already linked to this object"}` + +--- + +### Requirement: Mail app script injection via event listener + +The system SHALL register a PHP event listener that injects the OpenRegister mail sidebar JavaScript bundle into the Nextcloud Mail app page. The injection MUST only occur when: (1) the Mail app is installed and enabled for the current user, (2) the user has access to at least one OpenRegister register, and (3) the current page is the Mail app. The script MUST be loaded as a separate webpack entry point to avoid bloating the main OpenRegister bundle. + +#### Rationale + +Nextcloud's `OCP\Util::addScript()` is the standard mechanism for cross-app script injection. By listening to the Mail app's template rendering event, we ensure the script is only loaded when relevant. + +#### Scenario: Script is injected when Mail app is active +- **GIVEN** a user with OpenRegister access opens the Nextcloud Mail app +- **WHEN** the Mail app's `BeforeTemplateRenderedEvent` fires +- **THEN** `OCP\Util::addScript('openregister', 'openregister-mail-sidebar')` MUST be called +- **AND** the script MUST create a container element and mount the Vue sidebar component +- **AND** the script MUST NOT interfere with the Mail app's existing functionality + +#### Scenario: Script is NOT injected when Mail app is not installed +- **GIVEN** the Nextcloud Mail app is not installed +- **WHEN** the user navigates to any page +- **THEN** no mail sidebar script MUST be registered or loaded +- **AND** no errors MUST appear in the server log related to the mail sidebar + +#### Scenario: Script is NOT injected for users without OpenRegister access +- **GIVEN** a user who has no access to any OpenRegister registers +- **WHEN** the user opens the Mail app +- **THEN** the mail sidebar script MUST NOT be injected +- **AND** no OpenRegister UI elements MUST appear in the Mail app + +--- + +### Requirement: Sidebar panel UI with linked objects display + +The system SHALL render a collapsible sidebar panel on the right side of the Mail app's message detail view. The panel MUST display two sections: (1) "Linked Objects" showing objects explicitly linked to the current email, and (2) "Related Cases" showing objects discovered via sender email address. Each object MUST be displayed as a card with the object title, schema name, register name, and a deep link to the object in OpenRegister. + +#### Rationale + +Case handlers need quick, scannable access to case context while reading emails. A sidebar panel is the least disruptive UI pattern -- it does not obscure the email content and can be collapsed when not needed. + +#### Scenario: Sidebar shows linked objects for current email +- **GIVEN** the user is viewing email (accountId: 1, messageId: 42) which is linked to 2 objects +- **WHEN** the sidebar loads +- **THEN** the "Linked Objects" section MUST display 2 object cards +- **AND** each card MUST show: object title, schema name (e.g., "Omgevingsvergunning"), register name (e.g., "Vergunningen") +- **AND** each card MUST have a clickable link that navigates to `/apps/openregister/registers/{registerId}/{schemaId}/{objectUuid}` in a new tab + +#### Scenario: Sidebar shows related cases from same sender +- **GIVEN** the current email is from `burger@test.local` who has emails linked to 3 objects (1 of which is already linked to the current email) +- **WHEN** the sidebar loads +- **THEN** the "Related Cases" section MUST display 2 object cards (excluding the one already shown in "Linked Objects") +- **AND** each card MUST show: object title, schema name, register name, and a badge showing "N emails" (how many emails from this sender are linked) + +#### Scenario: Sidebar is collapsible +- **GIVEN** the sidebar panel is visible +- **WHEN** the user clicks the collapse toggle button +- **THEN** the panel MUST animate to a narrow tab (40px wide) showing only the OpenRegister icon +- **AND** clicking the tab MUST re-expand the panel +- **AND** the collapsed/expanded state MUST persist in `localStorage` across page reloads + +#### Scenario: Sidebar shows empty state when no links exist +- **GIVEN** the current email has no linked objects and the sender has no linked emails anywhere +- **WHEN** the sidebar loads +- **THEN** the "Linked Objects" section MUST show: "No objects linked to this email" +- **AND** the "Related Cases" section MUST show: "No related cases found for this sender" +- **AND** a prominent "Link to Object" button MUST be visible + +#### Scenario: Sidebar handles email navigation +- **GIVEN** the sidebar is showing objects for email (messageId: 42) +- **WHEN** the user clicks on a different email (messageId: 43) in the Mail app +- **THEN** the sidebar MUST detect the URL change within 300ms +- **AND** the sidebar MUST show a loading state while fetching new data +- **AND** the sidebar MUST display objects linked to the new email (messageId: 43) +- **AND** the previous results MUST be cached so returning to email 42 is instant + +--- + +### Requirement: Link and unlink actions from the sidebar + +The system SHALL provide UI actions in the sidebar to link and unlink objects from the current email. Linking opens a search dialog where the user can find objects by title, UUID, or schema. Unlinking removes the association after confirmation. + +#### Rationale + +The sidebar is the natural place to manage email-object associations. Without link/unlink actions, users would need to navigate to OpenRegister to manage links, defeating the purpose of the sidebar integration. + +#### Scenario: Link an object to the current email via search +- **GIVEN** the user clicks "Link to Object" in the sidebar +- **WHEN** the link dialog opens +- **THEN** the dialog MUST show a search input with placeholder "Search by title or UUID..." +- **AND** as the user types, results MUST appear after 300ms debounce +- **AND** each result MUST show: object title, schema name, register name +- **AND** objects already linked to this email MUST be marked with a "Already linked" badge and be non-selectable + +#### Scenario: Confirm linking an object +- **GIVEN** the user has selected object "OV-2026-0042" in the link dialog +- **WHEN** the user clicks "Link" +- **THEN** a POST request MUST be sent to `/api/emails/quick-link` with the current email's metadata and the selected object's UUID +- **AND** on success, the dialog MUST close and the linked object MUST appear in the "Linked Objects" section +- **AND** a Nextcloud toast notification MUST show "Object linked successfully" / "Object succesvol gekoppeld" + +#### Scenario: Unlink an object from the current email +- **GIVEN** object "OV-2026-0042" is linked to the current email (linkId: 7) +- **WHEN** the user clicks the unlink (X) button on the object card +- **THEN** a confirmation dialog MUST appear: "Remove link between this email and OV-2026-0042?" / "Koppeling tussen deze e-mail en OV-2026-0042 verwijderen?" +- **AND** on confirmation, a DELETE request MUST be sent to `/api/objects/{register}/{schema}/{objectUuid}/emails/7` +- **AND** the object card MUST be removed from the "Linked Objects" section +- **AND** if the object has other emails from the same sender linked, it MUST appear in the "Related Cases" section + +#### Scenario: Link dialog search returns no results +- **GIVEN** the user types "nonexistent-case-99" in the search input +- **WHEN** the debounced search completes +- **THEN** the dialog MUST show "No objects found" / "Geen objecten gevonden" +- **AND** a hint MUST appear: "Try searching by UUID or with different keywords" / "Probeer te zoeken op UUID of met andere zoektermen" + +--- + +### Requirement: Email URL observation for automatic context switching + +The system SHALL implement a URL observer that monitors the Nextcloud Mail app's route changes to detect when the user switches between emails. The observer MUST extract the mail account ID and message ID from the URL hash and trigger sidebar data refresh. The observer MUST handle all Mail app URL patterns including inbox, sent, drafts, and custom folders. + +#### Rationale + +The Mail app is a single-page application with client-side routing. The sidebar cannot rely on page reloads to detect navigation -- it must observe route changes programmatically. URL observation is more reliable and less invasive than DOM mutation observation or intercepting the Mail app's internal event bus. + +#### Scenario: Detect email selection from inbox URL +- **GIVEN** the Mail app URL changes to `#/accounts/1/folders/INBOX/messages/42` +- **WHEN** the URL observer processes the change +- **THEN** it MUST extract `accountId: 1` and `messageId: 42` +- **AND** trigger a sidebar data refresh for that account/message combination +- **AND** the refresh MUST be debounced (300ms) to avoid rapid-fire requests during quick navigation + +#### Scenario: Detect email selection from custom folder +- **GIVEN** the Mail app URL changes to `#/accounts/2/folders/Archief/messages/108` +- **WHEN** the URL observer processes the change +- **THEN** it MUST extract `accountId: 2` and `messageId: 108` +- **AND** trigger a sidebar data refresh + +#### Scenario: Handle URL without message selection (folder view) +- **GIVEN** the Mail app URL changes to `#/accounts/1/folders/INBOX` (no message selected) +- **WHEN** the URL observer processes the change +- **THEN** the sidebar MUST clear the current results +- **AND** show a placeholder: "Select an email to see linked objects" / "Selecteer een e-mail om gekoppelde objecten te zien" + +#### Scenario: Handle compose/settings URLs +- **GIVEN** the Mail app URL changes to `#/compose` or `#/settings` +- **WHEN** the URL observer processes the change +- **THEN** the sidebar MUST collapse or hide (no email context available) +- **AND** no API calls MUST be made + +#### Scenario: Cache results for previously viewed emails +- **GIVEN** the user viewed email (messageId: 42) and then navigated to email (messageId: 43) +- **WHEN** the user navigates back to email (messageId: 42) +- **THEN** the sidebar MUST immediately display the cached results for messageId 42 +- **AND** a background refresh MUST be triggered to check for updates +- **AND** if the background refresh returns different data, the UI MUST update seamlessly + +--- + +### Requirement: Webpack entry point for mail sidebar bundle + +The system SHALL build the mail sidebar as a separate webpack entry point (`mail-sidebar`) that produces an independent JavaScript bundle. This bundle MUST NOT import or depend on the main OpenRegister application bundle. It MUST only include the Vue components, composables, and API utilities needed for the sidebar panel. + +#### Rationale + +Loading the entire OpenRegister frontend bundle (with all views, stores, and dependencies) into the Mail app would be wasteful and could cause conflicts. A separate entry point ensures minimal bundle size and isolation. + +#### Scenario: Separate webpack entry point +- **GIVEN** the webpack configuration has a `mail-sidebar` entry point at `src/mail-sidebar.js` +- **WHEN** `npm run build` is executed +- **THEN** a separate bundle `js/openregister-mail-sidebar.js` MUST be produced +- **AND** the bundle size MUST be less than 100KB gzipped (excluding Vue runtime shared with Nextcloud) +- **AND** the bundle MUST NOT include any OpenRegister store modules, router configuration, or view components from the main app + +#### Scenario: Bundle uses Nextcloud's shared Vue instance +- **GIVEN** the Mail app page already has Vue loaded via Nextcloud's runtime +- **WHEN** the mail sidebar bundle loads +- **THEN** it MUST use the externalized Vue (from webpack externals) rather than bundling its own +- **AND** it MUST use Nextcloud's shared axios instance for API calls (`@nextcloud/axios`) + +--- + +### Requirement: i18n support for Dutch and English + +The system SHALL provide all user-facing strings in the sidebar in both Dutch (nl) and English (en), using Nextcloud's standard translation mechanism (`@nextcloud/l10n`). The sidebar MUST follow the user's Nextcloud language preference. + +#### Rationale + +All Conduction apps require Dutch and English as minimum languages (per i18n requirement in project.md). Government users in the Netherlands primarily use Dutch. + +#### Key translatable strings + +| English | Dutch | +|---------|-------| +| Linked Objects | Gekoppelde objecten | +| Related Cases | Gerelateerde zaken | +| No objects linked to this email | Geen objecten gekoppeld aan deze e-mail | +| No related cases found for this sender | Geen gerelateerde zaken gevonden voor deze afzender | +| Link to Object | Koppelen aan object | +| Search by title or UUID... | Zoeken op titel of UUID... | +| Already linked | Al gekoppeld | +| Link | Koppelen | +| Cancel | Annuleren | +| Object linked successfully | Object succesvol gekoppeld | +| Remove link? | Koppeling verwijderen? | +| Remove link between this email and {title}? | Koppeling tussen deze e-mail en {title} verwijderen? | +| Remove | Verwijderen | +| Select an email to see linked objects | Selecteer een e-mail om gekoppelde objecten te zien | +| N emails | N e-mails | +| Open in OpenRegister | Openen in OpenRegister | + +#### Scenario: Sidebar renders in Dutch for Dutch user +- **GIVEN** a user whose Nextcloud language is set to `nl` +- **WHEN** the sidebar loads +- **THEN** all labels, buttons, placeholders, and messages MUST be displayed in Dutch +- **AND** the `t('openregister', ...)` function MUST be used for all translatable strings + +#### Scenario: Sidebar renders in English for English user +- **GIVEN** a user whose Nextcloud language is set to `en` +- **WHEN** the sidebar loads +- **THEN** all labels, buttons, placeholders, and messages MUST be displayed in English + +--- + +### Requirement: Accessibility compliance (WCAG AA) + +The sidebar panel MUST meet WCAG AA accessibility standards. All interactive elements MUST be keyboard-navigable, have visible focus indicators, and include appropriate ARIA labels. Color contrast MUST meet 4.5:1 for normal text and 3:1 for large text. + +#### Scenario: Keyboard navigation through sidebar +- **GIVEN** the sidebar is visible and has linked objects +- **WHEN** the user presses Tab +- **THEN** focus MUST move through: collapse toggle -> first object card link -> first object unlink button -> second object card link -> ... -> "Link to Object" button +- **AND** each focused element MUST have a visible focus ring (using `--color-primary` outline) + +#### Scenario: Screen reader announces sidebar content +- **GIVEN** a screen reader user navigates to the sidebar +- **WHEN** the sidebar region is reached +- **THEN** it MUST be announced as "OpenRegister: Linked Objects sidebar" (via `role="complementary"` and `aria-label`) +- **AND** each object card MUST announce: "{title}, {schema} in {register}. Linked by {user} on {date}" +- **AND** the unlink button MUST announce: "Remove link to {title}" + +#### Scenario: Color contrast in light and dark themes +- **GIVEN** the sidebar uses Nextcloud CSS variables for colors +- **WHEN** rendered in light theme or dark theme +- **THEN** all text MUST have at least 4.5:1 contrast ratio against its background +- **AND** the sidebar MUST NOT use hardcoded colors (CSS variables only, per NL Design System requirements) + +--- + +### Requirement: Error handling and resilience + +The sidebar MUST handle API errors, network failures, and unexpected states gracefully without breaking the Mail app experience. Errors MUST be displayed inline in the sidebar, not as modal dialogs or browser alerts. + +#### Scenario: API returns 500 error +- **GIVEN** the reverse-lookup API returns HTTP 500 +- **WHEN** the sidebar processes the response +- **THEN** the sidebar MUST display: "Could not load linked objects. Try again later." / "Gekoppelde objecten konden niet worden geladen. Probeer het later opnieuw." +- **AND** a "Retry" button MUST be shown +- **AND** the error MUST be logged to the browser console with the response details + +#### Scenario: Network timeout +- **GIVEN** the API call takes longer than 10 seconds +- **WHEN** the timeout is reached +- **THEN** the sidebar MUST abort the request and show a timeout message +- **AND** a "Retry" button MUST be shown + +#### Scenario: Mail app DOM structure changes (version mismatch) +- **GIVEN** the Mail app updates and the expected container element is not found +- **WHEN** the sidebar script attempts to mount +- **THEN** the script MUST log a warning: "Mail sidebar: could not find mount point, skipping injection" +- **AND** the script MUST NOT throw unhandled exceptions +- **AND** the Mail app MUST continue to function normally + +#### Scenario: OpenRegister API is unreachable +- **GIVEN** the OpenRegister app is disabled or uninstalled while the Mail app is open +- **WHEN** the sidebar attempts an API call +- **THEN** the sidebar MUST catch the error and hide itself +- **AND** no error dialogs or broken UI elements MUST remain in the Mail app diff --git a/openspec/changes/mail-smart-picker/specs/mail-smart-picker/spec.md b/openspec/changes/mail-smart-picker/specs/mail-smart-picker/spec.md new file mode 100644 index 000000000000..636d2dd9852e --- /dev/null +++ b/openspec/changes/mail-smart-picker/specs/mail-smart-picker/spec.md @@ -0,0 +1,236 @@ +--- +status: draft +--- + +# Mail Smart Picker + +## Purpose + +Enable OpenRegister objects to be discovered, searched, and inserted as rich references via Nextcloud's Smart Picker in any app that supports the `@nextcloud/vue-richtext` component (Mail, Text, Talk, Collectives, etc.). When a user pastes or picks an OpenRegister object URL, it SHALL render as an inline rich preview card showing the object's title, schema, register, key properties, and a direct link. This integration uses the standard `OCP\Collaboration\Reference` API and the existing `ObjectsProvider` search provider. + +**Source**: Users working with OpenCatalogi, Procest, and other Conduction apps need to reference register objects in email and collaborative documents. Without a reference provider, pasted URLs render as plain text with no preview. + +## Requirements + +### Requirement: OpenRegister MUST register a discoverable, searchable reference provider + +The app MUST register a PHP class extending `ADiscoverableReferenceProvider` and implementing `ISearchableReferenceProvider`. This provider SHALL appear in the Smart Picker modal across all Nextcloud apps. It MUST be registered in `Application::register()` via `$context->registerReferenceProvider()`. + +#### Scenario: Provider appears in Smart Picker +- **GIVEN** the OpenRegister app is enabled +- **WHEN** a user opens the Smart Picker (e.g., by typing `/` in the Text editor or clicking the `+` button in Mail compose) +- **THEN** an entry titled `t('openregister', 'Register Objects')` SHALL appear in the provider list +- **AND** the entry SHALL display the OpenRegister app icon via `IURLGenerator::imagePath('openregister', 'app-dark.svg')` +- **AND** the provider's `getOrder()` SHALL return `10` to place it in a reasonable position + +#### Scenario: Provider declares supported search provider IDs +- **GIVEN** the `ObjectReferenceProvider` class implements `ISearchableReferenceProvider` +- **WHEN** `getSupportedSearchProviderIds()` is called +- **THEN** it SHALL return `['openregister_objects']` matching the existing `ObjectsProvider::getId()` +- **AND** the Smart Picker SHALL use the `ObjectsProvider` search to power the object search within the picker + +#### Scenario: Provider registration in Application +- **GIVEN** the `Application::register()` method in `lib/AppInfo/Application.php` +- **WHEN** the app boots +- **THEN** `$context->registerReferenceProvider(ObjectReferenceProvider::class)` SHALL be called +- **AND** the provider SHALL be injectable via Nextcloud DI (constructor injection of `IURLGenerator`, `IL10N`, `ObjectService`, `DeepLinkRegistryService`, `SchemaMapper`, `RegisterMapper`, and the nullable `$userId` string) + +### Requirement: The reference provider MUST match OpenRegister object URLs + +The `matchReference()` method SHALL recognize URLs pointing to OpenRegister objects in both hash-routed and direct-route formats. It MUST match URLs generated by the OpenRegister app itself, deep-linked consuming app URLs that contain an OpenRegister object UUID, and the canonical API object endpoint. + +#### Scenario: Match hash-routed UI URL +- **GIVEN** the Nextcloud instance at `https://cloud.example.com` +- **WHEN** `matchReference()` receives `https://cloud.example.com/apps/openregister/#/registers/5/schemas/12/objects/550e8400-e29b-41d4-a716-446655440000` +- **THEN** it SHALL return `true` +- **AND** the same SHALL hold for the `/index.php/apps/openregister/` variant + +#### Scenario: Match API object URL +- **GIVEN** the API base URL for OpenRegister +- **WHEN** `matchReference()` receives `https://cloud.example.com/index.php/apps/openregister/api/objects/5/12/550e8400-e29b-41d4-a716-446655440000` +- **THEN** it SHALL return `true` + +#### Scenario: Match deep-linked consuming app URL +- **GIVEN** a deep link registered by OpenCatalogi mapping schema ID 12 to `/apps/opencatalogi/#/catalogi/{uuid}` +- **WHEN** `matchReference()` receives `https://cloud.example.com/apps/opencatalogi/#/catalogi/550e8400-e29b-41d4-a716-446655440000` +- **THEN** it SHALL return `true` (by checking UUID against known OpenRegister objects) +- **AND** this deep-link URL matching SHALL be an optional, best-effort feature that does not block the core URL matching + +#### Scenario: Non-matching URL returns false +- **GIVEN** a URL that does not point to an OpenRegister object +- **WHEN** `matchReference()` receives `https://cloud.example.com/apps/files/` +- **THEN** it SHALL return `false` + +### Requirement: The reference provider MUST resolve matched URLs into rich reference objects + +The `resolveReference()` method SHALL load the OpenRegister object by parsing the register ID, schema ID, and object UUID from the URL, fetch the object via `ObjectService`, and return an `IReference` with rich object metadata for the frontend widget. + +#### Scenario: Resolve a valid object URL +- **GIVEN** a matched URL `https://cloud.example.com/apps/openregister/#/registers/5/schemas/12/objects/550e8400-e29b-41d4-a716-446655440000` +- **WHEN** `resolveReference()` is called +- **THEN** the method SHALL parse register ID `5`, schema ID `12`, and UUID `550e8400-e29b-41d4-a716-446655440000` +- **AND** it SHALL call `ObjectService::getObject()` to fetch the object +- **AND** it SHALL call `SchemaMapper::find()` and `RegisterMapper::find()` to get schema and register names +- **AND** it SHALL return a `Reference` object with `setRichObject('openregister-object', $richData)` + +#### Scenario: Rich object data structure +- **GIVEN** a resolved object with UUID `550e8400...`, title `Omgevingsvergunning`, in schema `Producten` (ID 12), register `Gemeente` (ID 5) +- **WHEN** the rich object is serialized +- **THEN** the `$richData` array SHALL contain: + - `id` (string): the object UUID + - `title` (string): the object's display name (from `@self.name` or first string property) + - `description` (string): truncated description or summary (max 200 chars) + - `schema` (object): `{"id": 12, "title": "Producten"}` + - `register` (object): `{"id": 5, "title": "Gemeente"}` + - `url` (string): the deep-linked URL (or OpenRegister URL as fallback) + - `icon_url` (string): resolved icon from DeepLinkRegistryService or OpenRegister app icon + - `updated` (string): ISO 8601 timestamp of last update + - `properties` (array): up to 4 key-value pairs from the object's top-level string/number properties for preview + +#### Scenario: Object not found returns null +- **GIVEN** a matched URL with a UUID that does not exist in the database +- **WHEN** `resolveReference()` is called +- **THEN** it SHALL return `null` +- **AND** Nextcloud SHALL render the URL as a plain link (default behavior) + +#### Scenario: User lacks permission to view object +- **GIVEN** a matched URL for an object the current user cannot access (RBAC) +- **WHEN** `resolveReference()` is called +- **THEN** it SHALL catch the authorization exception and return `null` +- **AND** the URL SHALL render as a plain link without leaking object metadata + +### Requirement: A custom Vue widget MUST render the rich object preview inline + +A Vue component SHALL be registered as a widget to render `openregister-object` rich objects inline wherever `@nextcloud/vue-richtext` is used. The widget SHALL display a card-style preview with the object's icon, title, schema/register context, key properties, and a clickable link. + +#### Scenario: Widget renders object card in Mail compose +- **GIVEN** a user has inserted an OpenRegister object reference via the Smart Picker in Mail compose +- **WHEN** the email is displayed (compose or read view) +- **THEN** the reference SHALL render as a card with: + - The OpenRegister (or consuming app) icon on the left + - The object title as the card heading + - A subtitle showing `Schema: Producten | Register: Gemeente` + - Up to 4 key properties displayed as label-value pairs + - The last-updated timestamp + - The entire card SHALL be clickable, navigating to the object URL + +#### Scenario: Widget renders in Nextcloud Text +- **GIVEN** a user has pasted an OpenRegister object URL in a Text document +- **WHEN** the document is viewed by any user with access +- **THEN** the URL SHALL be replaced with the same card-style widget +- **AND** the widget SHALL respect the current Nextcloud theme (including NL Design System tokens if nldesign is enabled) + +#### Scenario: Widget registration in main.js +- **GIVEN** the OpenRegister app's frontend entry point +- **WHEN** the app initializes +- **THEN** `OCA.OpenRegister.registerWidget('openregister-object', ObjectReferenceWidget)` SHALL be called (or the equivalent `registerWidget` from `@nextcloud/vue-richtext`) +- **AND** the widget component SHALL be lazy-loaded to minimize bundle size impact + +#### Scenario: Widget fallback for plain text contexts +- **GIVEN** a context that does not support rich widgets (e.g., plain text email view) +- **WHEN** the reference is rendered +- **THEN** Nextcloud SHALL fall back to displaying the reference title and URL as a simple link +- **AND** the `Reference::setTitle()` and `Reference::setDescription()` values from `resolveReference()` SHALL provide meaningful fallback text + +### Requirement: The reference provider MUST use caching for performance + +The provider MUST implement `getCachePrefix()` and `getCacheKey()` to enable Nextcloud's reference caching, avoiding redundant database lookups for the same object. + +#### Scenario: Cache prefix based on object identity +- **GIVEN** a reference URL for object UUID `550e8400...` in register 5, schema 12 +- **WHEN** `getCachePrefix()` is called +- **THEN** it SHALL return `5/12/550e8400-e29b-41d4-a716-446655440000` + +#### Scenario: Cache key based on user +- **GIVEN** RBAC may produce different results per user +- **WHEN** `getCacheKey()` is called +- **THEN** it SHALL return the current `$userId` (or empty string for anonymous) +- **AND** this ensures each user gets their own cached version respecting permissions + +#### Scenario: Cache invalidation on object update +- **GIVEN** an object is updated via the API +- **WHEN** `ObjectService::saveObject()` completes +- **THEN** `IReferenceManager::invalidateCache()` SHALL be called with the object's reference URL +- **AND** subsequent reference resolutions SHALL fetch fresh data + +### Requirement: Public references MUST be supported for publicly-accessible objects + +For objects in schemas/registers that allow public (unauthenticated) access, the reference provider MUST resolve references without requiring authentication, enabling rich previews in publicly shared documents or link previews. + +#### Scenario: Public object renders rich preview for anonymous viewer +- **GIVEN** a schema configured with public read access and an object in that schema +- **WHEN** an unauthenticated viewer encounters the reference (e.g., in a publicly shared Text document) +- **THEN** the reference SHALL resolve and display the rich preview card +- **AND** the provider SHALL check `IPublicReferenceProvider` capability (NC 30+) or fall back to showing a basic preview + +#### Scenario: Private object shows no preview for anonymous viewer +- **GIVEN** a schema without public read access +- **WHEN** an unauthenticated viewer encounters the reference +- **THEN** `resolveReference()` SHALL return `null` +- **AND** the URL SHALL render as a plain link + +### Requirement: The reference provider MUST integrate with the Deep Link Registry for URL resolution + +When resolving references, the provider MUST use `DeepLinkRegistryService::resolveUrl()` to determine the best URL for the object, preferring consuming app deep links over the raw OpenRegister admin URL. The icon MUST also be resolved via `DeepLinkRegistryService::resolveIcon()`. + +#### Scenario: Deep link to OpenCatalogi +- **GIVEN** a deep link mapping schema ID 12 to OpenCatalogi's route pattern +- **WHEN** an object from schema 12 is resolved as a reference +- **THEN** the `url` in the rich object data SHALL point to OpenCatalogi's URL (e.g., `/apps/opencatalogi/#/catalogi/{uuid}`) +- **AND** the `icon_url` SHALL use OpenCatalogi's app icon +- **AND** the card title context SHALL mention the consuming app name if available + +#### Scenario: No deep link falls back to OpenRegister URL +- **GIVEN** no deep link is registered for schema ID 20 +- **WHEN** an object from schema 20 is resolved as a reference +- **THEN** the `url` SHALL point to `openregister.objects.show` route +- **AND** the `icon_url` SHALL use `imagePath('openregister', 'app-dark.svg')` + +### Requirement: i18n MUST be applied to all user-visible strings + +All user-visible strings in both the PHP reference provider and the Vue widget MUST use Nextcloud's `IL10N` / `t()` translation system. Dutch and English translations MUST be provided as minimum per ADR-005. + +#### Scenario: Provider title is translated +- **GIVEN** a user with Nextcloud locale set to `nl` +- **WHEN** the Smart Picker displays the OpenRegister provider +- **THEN** the title SHALL be the Dutch translation of `'Register Objects'` (e.g., `'Register Objecten'`) + +#### Scenario: Widget labels are translated +- **GIVEN** the reference widget rendering an object card +- **WHEN** labels like "Schema", "Register", "Updated" are displayed +- **THEN** they SHALL use `t('openregister', 'Schema')`, `t('openregister', 'Register')`, `t('openregister', 'Updated')` respectively +- **AND** Dutch translations SHALL be present in `l10n/nl.json` + +## Current Implementation Status + +**Not yet implemented.** The following existing infrastructure supports this feature: + +- `ObjectsProvider` (search provider, ID `openregister_objects`) already provides search functionality that the Smart Picker can leverage via `ISearchableReferenceProvider::getSupportedSearchProviderIds()`. +- `DeepLinkRegistryService` provides `resolveUrl()` and `resolveIcon()` for consuming-app URL resolution. +- `ObjectService::getObject()` and `ObjectService::searchObjectsPaginated()` provide the data access layer. +- `Application::register()` already calls `$context->registerSearchProvider(ObjectsProvider::class)` -- the reference provider registration will be added alongside it. + +**Not yet implemented:** +- `ObjectReferenceProvider` PHP class +- Vue widget component for inline rendering +- Widget registration in frontend entry point +- Cache invalidation on object updates +- Public reference support +- Translation strings for provider and widget + +## Standards & References + +- Nextcloud Reference Provider API: `OCP\Collaboration\Reference\IReferenceProvider` (NC 25+) +- Nextcloud Discoverable Reference Provider: `OCP\Collaboration\Reference\ADiscoverableReferenceProvider` (NC 26+) +- Nextcloud Searchable Reference Provider: `OCP\Collaboration\Reference\ISearchableReferenceProvider` (NC 26+) +- Nextcloud Public Reference Provider: `OCP\Collaboration\Reference\IPublicReferenceProvider` (NC 30+) +- `@nextcloud/vue-richtext` Vue component for rendering references +- ADR-005: Dutch and English required for all UI strings +- Nextcloud Smart Picker documentation: https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/reference.html + +## Cross-References + +- `deep-link-registry` -- URL resolution for consuming apps +- `zoeken-filteren` -- Search provider that powers the picker's search +- `i18n-infrastructure` -- Translation infrastructure for Vue components +- `i18n-dutch-translations` -- Dutch translation completeness diff --git a/openspec/changes/mcp-discovery/specs/mcp-discovery/spec.md b/openspec/changes/mcp-discovery/specs/mcp-discovery/spec.md new file mode 100644 index 000000000000..32f83de48cbf --- /dev/null +++ b/openspec/changes/mcp-discovery/specs/mcp-discovery/spec.md @@ -0,0 +1,353 @@ +--- +status: draft +--- +# MCP Discovery + +## Purpose +Provides AI agents and MCP-compatible clients with two complementary interfaces to the OpenRegister platform: a tiered REST-based discovery API for token-efficient API exploration, and a full MCP standard protocol endpoint implementing JSON-RPC 2.0 over Streamable HTTP for native tool and resource access. Together these interfaces allow any LLM or MCP client to discover capabilities, establish sessions, and perform CRUD operations on registers, schemas, and objects without prior knowledge of the API surface. + +## ADDED Requirements + + +### Requirement: Tier 1 Discovery Catalog +The system SHALL expose a public endpoint at `GET /api/mcp/v1/discover` that returns a compact JSON catalog of all capability areas without requiring authentication, enabling AI agents to understand the full API surface in a single request. + +#### Scenario: Agent discovers available capabilities +- **GIVEN** the MCP discovery endpoint is deployed +- **WHEN** an unauthenticated client sends `GET /api/mcp/v1/discover` +- **THEN** the response MUST be HTTP 200 with Content-Type `application/json` +- **AND** the response MUST include a `version` field with value `"1.0"` +- **AND** the response MUST include a `name` field with value `"OpenRegister"` +- **AND** the response MUST include a `description` field summarizing the platform +- **AND** the response MUST include a `base_url` field with the app's base path generated via `IURLGenerator` +- **AND** the response MUST include a `capabilities` array with at least 10 entries + +#### Scenario: Capability entry structure +- **GIVEN** the discovery endpoint returns a capabilities array +- **WHEN** an agent reads a capability entry +- **THEN** each entry MUST contain `id` (kebab-case string), `name` (human-readable label), `description` (one concise sentence), and `href` (absolute URL to Tier 2 detail built from route `openregister.mcp.discoverCapability`) + +#### Scenario: Authentication object in discovery response +- **GIVEN** the discovery endpoint is called +- **WHEN** the response is returned +- **THEN** the response MUST include an `authentication` object with `type` set to `"basic"`, a `description` explaining Nextcloud Basic Auth and session cookies, and a `header` field showing the expected `Authorization` header format + +#### Scenario: CORS preflight for public discovery +- **GIVEN** the discovery endpoint is annotated with `@PublicPage` and `@CORS` +- **WHEN** a browser or agent sends an OPTIONS preflight request to `/api/mcp/v1/discover` +- **THEN** the response MUST include CORS headers allowing cross-origin access +- **AND** the GET request MUST NOT require CSRF tokens (annotated `@NoCSRFRequired`) + +#### Scenario: Internal server error handling +- **GIVEN** the `McpDiscoveryService::getCatalog()` method throws an exception +- **WHEN** the `McpController::discover()` method catches the exception +- **THEN** the response MUST be HTTP 500 with an `error` field containing the exception message + + +### Requirement: Tier 2 Capability Detail with Live Data +The system SHALL expose an authenticated endpoint at `GET /api/mcp/v1/discover/{capability}` that returns detailed API documentation including endpoint definitions, parameter schemas, and live context data (real entity IDs and names) so that agents can immediately reference existing data without additional lookup calls. + +#### Scenario: Agent drills into the objects capability +- **GIVEN** an authenticated client +- **WHEN** the client sends `GET /api/mcp/v1/discover/objects` +- **THEN** the response MUST be HTTP 200 +- **AND** the response MUST include `id`, `name`, and `description` fields +- **AND** the response MUST include an `endpoints` array with method, path, description, and parameters for each endpoint (list, create, get, update, patch, delete, lock, unlock) +- **AND** the response MUST include a `context` object with a `registers` array where each register includes `id`, `title`, and a `schemas` sub-array with `id` and `title` for each associated schema + +#### Scenario: Schema capability includes property counts +- **GIVEN** an authenticated client requests `GET /api/mcp/v1/discover/schemas` +- **WHEN** the response is returned +- **THEN** the `context` object MUST include a `schemas` array with `id`, `title`, `uuid`, and `property_count` for each schema +- **AND** `property_count` MUST reflect the actual number of properties defined on the schema + +#### Scenario: Unknown capability returns 404 with available list +- **GIVEN** an authenticated client +- **WHEN** the client sends `GET /api/mcp/v1/discover/nonexistent` +- **THEN** the response MUST be HTTP 404 +- **AND** the response MUST include an `error` message containing the unknown capability name +- **AND** the response MUST include an `available` array listing all valid capability IDs from `McpDiscoveryService::getCapabilityIds()` + +#### Scenario: Unauthenticated access to Tier 2 is rejected +- **GIVEN** an unauthenticated client (no Basic Auth or session) +- **WHEN** the client sends `GET /api/mcp/v1/discover/objects` +- **THEN** the Nextcloud framework MUST return HTTP 401 since the `discoverCapability` action is NOT annotated with `@PublicPage` + +#### Scenario: Objects endpoint parameters are fully documented +- **GIVEN** the objects capability detail is returned +- **WHEN** the agent reads the list objects endpoint +- **THEN** the `parameters` array MUST include entries for `register` (path, integer, required), `schema` (path, integer, required), `_limit` (query, integer, optional), `_offset` (query, integer, optional), `_search` (query, string, optional), `_order[field]` (query, string, optional), and `field.subfield` dot-notation filters (query, string, optional) + + +### Requirement: Capability Coverage +The discovery catalog MUST cover at minimum these capability areas: registers, schemas, objects, search, files, audit, bulk, webhooks, chat, views. Each capability MUST have a corresponding builder method in `McpDiscoveryService` that returns endpoints and context. + +#### Scenario: All core capabilities present +- **GIVEN** the discovery endpoint is called +- **WHEN** the capabilities array is returned +- **THEN** it MUST contain entries with IDs: `registers`, `schemas`, `objects`, `search`, `files`, `audit`, `bulk`, `webhooks`, `chat`, `views` + +#### Scenario: Each capability has a builder method +- **GIVEN** the `McpDiscoveryService` class is inspected +- **WHEN** `getCapabilityDetail()` dispatches via the `$builders` map +- **THEN** each capability ID MUST map to a private `build{Name}Capability()` method that returns an array with `id`, `name`, `description`, `context`, and `endpoints` keys + +#### Scenario: Search capability covers all search modes +- **GIVEN** the search capability detail is returned +- **WHEN** the agent reads the endpoints array +- **THEN** it MUST include endpoints for keyword search (`GET /api/search`), semantic search (`POST /api/search/semantic`), hybrid search (`POST /api/search/hybrid`), and file search variants (keyword, semantic, hybrid) + + +### Requirement: Token Efficiency +The Tier 1 response MUST be optimized for minimal token consumption by AI agents. Descriptions MUST be concise (one sentence each) and the total response SHOULD be under 500 tokens when serialized. + +#### Scenario: Compact response size +- **GIVEN** the discovery endpoint is called +- **WHEN** the response is serialized to JSON +- **THEN** the total character count MUST be under 3000 characters (approximately 500 tokens) + +#### Scenario: Descriptions are single sentences +- **GIVEN** the capabilities array is returned +- **WHEN** the agent reads any capability description +- **THEN** the description MUST be a single sentence (no period-separated sentences) + +#### Scenario: No redundant data in Tier 1 +- **GIVEN** the Tier 1 catalog response +- **WHEN** it is compared to the Tier 2 detail responses +- **THEN** Tier 1 MUST NOT include endpoint arrays, parameter schemas, or context data -- those belong exclusively in Tier 2 + + +### Requirement: MCP Standard Protocol Endpoint (JSON-RPC 2.0) +The system SHALL expose a single `POST /api/mcp` endpoint implementing the MCP standard protocol via JSON-RPC 2.0 over Streamable HTTP transport. The `McpServerController` MUST parse the JSON-RPC envelope, validate the `jsonrpc` version field equals `"2.0"`, and dispatch to the appropriate service based on the `method` field. + +#### Scenario: Valid JSON-RPC request is processed +- **GIVEN** an authenticated client with a valid MCP session +- **WHEN** the client sends `POST /api/mcp` with body `{"jsonrpc":"2.0","id":1,"method":"tools/list"}` +- **THEN** the response MUST be HTTP 200 with a JSON-RPC success envelope containing `jsonrpc`, `id`, and `result` fields + +#### Scenario: Invalid JSON body returns parse error +- **GIVEN** any client +- **WHEN** the client sends `POST /api/mcp` with a body that is not valid JSON +- **THEN** the response MUST be a JSON-RPC error with code `-32700` and message `"Parse error: invalid JSON"` + +#### Scenario: Missing jsonrpc version returns invalid request error +- **GIVEN** any client +- **WHEN** the client sends a JSON body without `jsonrpc: "2.0"` or without a `method` field +- **THEN** the response MUST be a JSON-RPC error with code `-32600` and message `"Invalid JSON-RPC 2.0 request"` + +#### Scenario: Unknown method returns method not found error +- **GIVEN** an authenticated client with a valid session +- **WHEN** the client sends a request with method `"unknown/method"` +- **THEN** the response MUST be a JSON-RPC error with code `-32601` and message containing `"Method not found"` + +#### Scenario: Missing required parameters returns invalid params error +- **GIVEN** an authenticated client with a valid session +- **WHEN** the client calls `tools/call` without the required `name` parameter +- **THEN** the response MUST be a JSON-RPC error with code `-32602` and message `"Missing required parameter: name"` + + +### Requirement: MCP Session Management +The system SHALL implement session-based access control for the MCP standard protocol. Sessions MUST be created during `initialize`, stored in Nextcloud's distributed cache (APCu) via `ICacheFactory`, and validated on every subsequent request via the `Mcp-Session-Id` HTTP header. + +#### Scenario: Initialize creates a session +- **GIVEN** an authenticated Nextcloud user +- **WHEN** the client sends an `initialize` request +- **THEN** the response MUST include a `Mcp-Session-Id` HTTP header containing a 32-character alphanumeric session ID generated via `ISecureRandom` +- **AND** the response result MUST include `protocolVersion` (value `"2025-03-26"`), `capabilities` object, `serverInfo` with `name` (`"OpenRegister"`) and `version` (`"1.0.0"`), and `instructions` text +- **AND** the session MUST be stored in the `openregister_mcp_sessions` cache with a TTL of 3600 seconds (1 hour) + +#### Scenario: Request without session is rejected +- **GIVEN** an authenticated client that has NOT called `initialize` +- **WHEN** the client sends a `tools/list` request without the `Mcp-Session-Id` header +- **THEN** the response MUST be a JSON-RPC error with code `-32000` and message `"Mcp-Session-Id header required"` + +#### Scenario: Expired or invalid session is rejected +- **GIVEN** a client with an expired or forged session ID +- **WHEN** the client sends any non-initialize request with that session ID +- **THEN** `McpProtocolService::validateSession()` MUST return `null` +- **AND** the response MUST be a JSON-RPC error with code `-32000` and message `"Invalid or expired session"` + +#### Scenario: Session is scoped to authenticated user +- **GIVEN** a session is created for user `alice` +- **WHEN** `McpProtocolService::validateSession()` is called with that session ID +- **THEN** it MUST return the string `"alice"` (the user ID stored in cache) + +#### Scenario: Ping keeps session alive +- **GIVEN** a client with a valid session +- **WHEN** the client sends `{"jsonrpc":"2.0","id":5,"method":"ping"}` +- **THEN** the response result MUST be an empty object `{}` + + +### Requirement: MCP Tool Definitions +The MCP server SHALL expose three tools -- `registers`, `schemas`, and `objects` -- via the `tools/list` method. Each tool MUST include a `name`, `description`, and `inputSchema` (JSON Schema format) defining all accepted parameters including `action` (enum of CRUD operations), entity-specific fields, and pagination parameters. + +#### Scenario: Tools list returns three tools +- **GIVEN** a client with a valid session +- **WHEN** the client calls `tools/list` +- **THEN** the result MUST contain a `tools` array with exactly 3 entries named `"registers"`, `"schemas"`, and `"objects"` + +#### Scenario: Registers tool schema defines all parameters +- **GIVEN** the registers tool definition +- **WHEN** the `inputSchema` is inspected +- **THEN** it MUST define `action` (string, enum: list/get/create/update/delete, required), `id` (integer), `data` (object), `limit` (integer), and `offset` (integer) +- **AND** `required` MUST be `["action"]` + +#### Scenario: Objects tool requires register and schema scoping +- **GIVEN** the objects tool definition +- **WHEN** the `inputSchema` is inspected +- **THEN** `required` MUST be `["action", "register", "schema"]` +- **AND** `register` and `schema` MUST be typed as `integer` +- **AND** `id` MUST be typed as `string` (UUID format for object identifiers) + +#### Scenario: Tool call executes CRUD action +- **GIVEN** a client calls `tools/call` with `name: "registers"` and `arguments: {"action": "list"}` +- **WHEN** `McpToolsService::callTool()` processes the request +- **THEN** the result MUST contain a `content` array with a single `text` entry containing JSON-serialized register data +- **AND** `isError` MUST be `false` + +#### Scenario: Failed tool call returns error content +- **GIVEN** a client calls `tools/call` with `name: "registers"` and `arguments: {"action": "get"}` (missing required `id`) +- **WHEN** `McpToolsService::callTool()` catches the exception +- **THEN** the result MUST contain a `content` array with a `text` entry containing a JSON error object +- **AND** `isError` MUST be `true` + + +### Requirement: MCP Resource Definitions +The MCP server SHALL expose resources using the `openregister://` URI scheme. The `resources/list` method MUST return static resources for registers and schemas, plus dynamically generated resources for each register+schema pair. The `resources/templates/list` method MUST return URI templates for single-entity access. + +#### Scenario: Resources list includes static and dynamic entries +- **GIVEN** a client with a valid session +- **WHEN** the client calls `resources/list` +- **THEN** the result MUST contain a `resources` array +- **AND** the array MUST include `openregister://registers` (name: "All Registers") and `openregister://schemas` (name: "All Schemas") as static entries +- **AND** for each register+schema pair in the database, there MUST be an entry with URI `openregister://objects/{registerId}/{schemaId}`, name formatted as `"{registerTitle} — {schemaTitle}"`, and mimeType `application/json` + +#### Scenario: Deleted schema is skipped in resource listing +- **GIVEN** a register references a schema ID that no longer exists in the database +- **WHEN** `McpResourcesService::listResources()` iterates over schemas +- **THEN** the `DoesNotExistException` MUST be caught and the missing schema MUST be skipped without failing the entire listing + +#### Scenario: URI templates define single-entity access patterns +- **GIVEN** a client calls `resources/templates/list` +- **WHEN** the result is returned +- **THEN** the `resourceTemplates` array MUST include templates for `openregister://registers/{id}`, `openregister://schemas/{id}`, and `openregister://objects/{register}/{schema}/{id}` + +#### Scenario: Resource read parses URI and fetches data +- **GIVEN** a client calls `resources/read` with URI `openregister://objects/1/2` +- **WHEN** `McpResourcesService::readResource()` processes the request +- **THEN** it MUST parse the URI into `type: "objects"`, `registerId: 1`, `schemaId: 2` +- **AND** the response MUST contain a `contents` array with `uri`, `mimeType` (`application/json`), and `text` (JSON-serialized object data) + +#### Scenario: Invalid URI scheme is rejected +- **GIVEN** a client calls `resources/read` with URI `http://example.com/foo` +- **WHEN** `McpResourcesService::parseUri()` checks the scheme +- **THEN** it MUST throw `InvalidArgumentException` with message `"Invalid URI scheme, expected openregister://"` + + +### Requirement: MCP Capabilities Negotiation +The MCP `initialize` response SHALL declare the server's capabilities so that clients know which MCP features are supported. The capabilities object MUST accurately reflect the current implementation state. + +#### Scenario: Server declares tool and resource capabilities +- **GIVEN** a client sends an `initialize` request +- **WHEN** the response `result.capabilities` object is inspected +- **THEN** `tools.listChanged` MUST be `false` (tools are static, not dynamically changing) +- **AND** `resources.subscribe` MUST be `false` (resource subscriptions are not implemented) +- **AND** `resources.listChanged` MUST be `false` (resource list changes are not pushed) + +#### Scenario: Server instructions guide the agent +- **GIVEN** the `initialize` response is returned +- **WHEN** the `result.instructions` field is read +- **THEN** it MUST contain a human-readable string explaining OpenRegister's purpose and how to use tools and resources + +#### Scenario: Protocol version matches MCP spec +- **GIVEN** the `initialize` response is returned +- **WHEN** `result.protocolVersion` is checked +- **THEN** it MUST be `"2025-03-26"` matching the MCP specification version implemented + + +### Requirement: JSON-RPC Notification Handling +The system SHALL handle JSON-RPC notifications (requests without an `id` field) according to the MCP specification by returning HTTP 202 Accepted with no response body. + +#### Scenario: Notification returns 202 Accepted +- **GIVEN** any client +- **WHEN** the client sends `POST /api/mcp` with body `{"jsonrpc":"2.0","method":"notifications/initialized"}` (no `id` field) +- **THEN** the response MUST be HTTP 202 Accepted + +#### Scenario: Notification method is logged +- **GIVEN** a notification is received +- **WHEN** `McpServerController::handleNotification()` processes it +- **THEN** the method name MUST be logged at debug level via `LoggerInterface` with context `['method' => $method]` + +#### Scenario: All MCP lifecycle notifications are accepted +- **GIVEN** any client +- **WHEN** notifications such as `notifications/initialized`, `notifications/cancelled`, or `notifications/progress` are sent +- **THEN** all MUST receive HTTP 202 regardless of the notification method name + + +### Requirement: MCP Authentication via Nextcloud +The MCP standard endpoint SHALL require Nextcloud authentication (Basic Auth or session cookies) enforced by the framework. The `McpServerController` is annotated with `@NoAdminRequired` and `@NoCSRFRequired` but NOT `@PublicPage`, ensuring only authenticated Nextcloud users can access it. + +#### Scenario: Basic Auth grants access +- **GIVEN** a client sends `POST /api/mcp` with `Authorization: Basic base64(admin:admin)` +- **WHEN** Nextcloud validates the credentials +- **THEN** the request MUST be processed by `McpServerController::handle()` +- **AND** the `$userId` constructor parameter MUST be populated with the authenticated user ID + +#### Scenario: Missing authentication is rejected by framework +- **GIVEN** a client sends `POST /api/mcp` with no authentication headers +- **WHEN** the Nextcloud middleware checks authentication +- **THEN** the request MUST be rejected with HTTP 401 before reaching the controller + +#### Scenario: CORS is enabled for cross-origin MCP clients +- **GIVEN** the `handle()` method is annotated with `@CORS` +- **WHEN** a cross-origin MCP client (e.g., Claude Code running in a browser) sends a preflight OPTIONS request +- **THEN** the Nextcloud CORS middleware MUST return appropriate CORS headers + + +### Requirement: MCP Audit Logging +All MCP protocol operations SHALL be logged via `Psr\Log\LoggerInterface` for debugging and operational visibility. Tool calls, session lifecycle events, and errors MUST produce structured log entries. + +#### Scenario: Tool calls are logged at debug level +- **GIVEN** a client calls `tools/call` +- **WHEN** `McpToolsService::callTool()` is invoked +- **THEN** a debug-level log entry MUST be written with message `"[MCP] Tool call"` and context containing `tool` name and `arguments` + +#### Scenario: Failed tool calls are logged at error level +- **GIVEN** a tool execution throws an exception +- **WHEN** `McpToolsService::callTool()` catches the exception +- **THEN** an error-level log entry MUST be written with message `"[MCP] Tool execution failed"` and context containing `tool` name and `error` message + +#### Scenario: Session creation is logged +- **GIVEN** a client calls `initialize` +- **WHEN** `McpProtocolService::createSession()` generates a session +- **THEN** a debug-level log entry MUST be written with message `"[MCP] Session created"` and context containing `sessionId` and `userId` + +#### Scenario: Invalid session access is logged +- **GIVEN** a client sends a request with an invalid session ID +- **WHEN** `McpProtocolService::validateSession()` returns null +- **THEN** a debug-level log entry MUST be written with message `"[MCP] Invalid or expired session"` and context containing the `sessionId` + +#### Scenario: Method dispatch failures are logged +- **GIVEN** the dispatch method encounters an unexpected exception +- **WHEN** `McpServerController::dispatch()` catches a generic `Exception` +- **THEN** an error-level log entry MUST be written with message `"[MCP] Method dispatch failed"` and context containing `method` and `error` + + +### Requirement: Multi-Register Tool Scoping +The objects tool MUST enforce that every operation is scoped to a specific register and schema pair. The `McpToolsService` MUST set the register and schema context on the `ObjectService` before executing any object operation. + +#### Scenario: Objects tool requires both register and schema +- **GIVEN** a client calls `tools/call` with `name: "objects"` and `arguments: {"action": "list"}` (missing register and schema) +- **WHEN** `McpToolsService::executeObjects()` checks the arguments +- **THEN** it MUST throw `InvalidArgumentException` with message `"Both register and schema IDs are required for object operations"` + +#### Scenario: Register and schema are set on ObjectService +- **GIVEN** a client calls `tools/call` with `name: "objects"` and `arguments: {"action": "list", "register": 1, "schema": 2}` +- **WHEN** `McpToolsService::executeObjects()` processes the request +- **THEN** it MUST call `$this->objectService->setRegister(1)` and `$this->objectService->setSchema(2)` before executing the action + +#### Scenario: Each object operation is independently scoped +- **GIVEN** a client makes two sequential `tools/call` requests for objects in different register+schema pairs +- **WHEN** each request is processed +- **THEN** each request MUST independently set register and schema on the `ObjectService`, not rely on state from a previous call + diff --git a/openspec/changes/mock-registers/specs/mock-registers/spec.md b/openspec/changes/mock-registers/specs/mock-registers/spec.md new file mode 100644 index 000000000000..40d9faea15ee --- /dev/null +++ b/openspec/changes/mock-registers/specs/mock-registers/spec.md @@ -0,0 +1,246 @@ +--- +status: draft +--- +# Mock Registers + +## Purpose +Provide self-contained mock registers for the five Dutch base registries -- BRP (persons), KVK (businesses), BAG (addresses/buildings), DSO (environmental permits), and ORI (council information) -- so that Procest, Pipelinq, and other consuming apps can develop and demonstrate integrations without external API credentials, government certificates, or network access. Each register ships as a `*_register.json` file in `lib/Settings/` following the OpenAPI 3.0.0 + `x-openregister` extension pattern, with seed data in the `components.objects[]` array using the `@self` envelope format, imported via the `ConfigurationService -> ImportHandler` pipeline. + +## ADDED Requirements + + +### Requirement: KVK Mock Register (Kamer van Koophandel) + +The system SHALL provide a mock KVK register with fictional business records aligned to the KVK Handelsregister API data model. Seed data MUST be derived from the official KVK test environment (`https://api.kvk.nl/test/api/`). The register MUST contain at least 15 `maatschappelijke-activiteit` records and at least 8 `vestiging` records covering legal forms BV, NV, Eenmanszaak, Stichting, VOF, and Cooperatie, spanning at least 4 provinces. At least one business MUST have `materieleRegistratie.datumEinde` set (inactive business). Addresses SHOULD link to BAG mock data where possible. + +#### Scenario: Load KVK register with two schemas +- **GIVEN** the file `lib/Settings/kvk_register.json` exists +- **WHEN** the register is imported via the ImportHandler +- **THEN** the system SHALL create a register with slug `kvk` containing two schemas: `maatschappelijke-activiteit` and `vestiging` +- **AND** the vestiging objects SHALL reference their parent maatschappelijke-activiteit via `kvkNummer` + +#### Scenario: Legal form diversity +- **GIVEN** the KVK register is loaded +- **WHEN** the seed data is queried by `rechtsvorm` +- **THEN** at least the following legal forms MUST be present: Besloten Vennootschap, Naamloze Vennootschap, Eenmanszaak, Stichting, Vennootschap Onder Firma, Cooperatie + +#### Scenario: Hoofdvestiging and nevenvestiging relationship +- **GIVEN** a maatschappelijke-activiteit record for Test BV Donald (KVK 68750110) +- **WHEN** the associated vestiging records are queried by `kvkNummer` +- **THEN** exactly one vestiging MUST have `indHoofdvestiging` set to "Ja" +- **AND** any additional vestigingen MUST have `indHoofdvestiging` set to "Nee" + +#### Scenario: SBI activity codes present +- **GIVEN** any maatschappelijke-activiteit record in the KVK register +- **WHEN** the `sbiActiviteiten` array is inspected +- **THEN** it MUST contain at least one entry with valid `sbiCode`, `sbiOmschrijving`, and `indHoofdactiviteit` fields +- **AND** exactly one entry per business MUST have `indHoofdactiviteit` set to "Ja" + +#### Scenario: KVK addresses link to BAG +- **GIVEN** the KVK and BAG registers are both loaded +- **WHEN** at least 3 vestiging records are inspected +- **THEN** their `adressen[].straatnaam`, `huisnummer`, and `postcode` combinations MUST match corresponding BAG `nummeraanduiding` records + + +### Requirement: Cross-Register Referencing Integrity + +Mock register data MUST be cross-referenced where the same real-world entity appears in multiple registers. BRP person addresses MUST link to BAG via `adresseerbaarObjectIdentificatie` and `nummeraanduidingIdentificatie`. KVK vestiging addresses MUST match BAG nummeraanduiding records by postcode + huisnummer. DSO vergunningaanvraag locations MUST reference BAG municipality codes. At minimum: 5 BRP-BAG links, 3 KVK-BAG links, and 3 DSO-BAG links MUST exist. + +#### Scenario: BRP person address resolves in BAG +- **GIVEN** person Suzanne Moulin (BSN 999993653) in the BRP register +- **WHEN** her `verblijfplaats.adresseerbaarObjectIdentificatie` is looked up in the BAG register +- **THEN** a matching `verblijfsobject` record MUST exist +- **AND** the verblijfsobject's associated nummeraanduiding postcode and woonplaats MUST match the BRP person's verblijfplaats.postcode and verblijfplaats.woonplaats + +#### Scenario: KVK business address resolves in BAG +- **GIVEN** a KVK vestiging record with a bezoekadres +- **WHEN** the address (straatnaam + huisnummer + postcode) is searched in the BAG register's nummeraanduiding records +- **THEN** a matching nummeraanduiding record MUST exist +- **AND** the nummeraanduiding's openbareRuimteNaam MUST match the vestiging's straatnaam + +#### Scenario: Cross-register import order independence +- **GIVEN** the BAG register has NOT yet been imported +- **WHEN** the BRP register is imported first (containing BAG cross-references) +- **THEN** the import SHALL succeed without errors +- **AND** BAG reference fields SHALL be stored as-is (dangling references are acceptable until BAG is imported) +- **AND** once BAG is subsequently imported, the references SHALL become resolvable + + +### Requirement: Data Realism and Quality + +Seed data MUST be realistic enough for meaningful demonstrations and integration testing. Person names MUST include typical Dutch naming patterns (voorvoegsel like "de", "van der", "van den"). Business names MUST use recognizable formats. Addresses MUST use real Dutch street names, valid postcodes (format ####XX), and correct municipality assignments. Dates MUST be temporally consistent (birth dates before marriage dates, registration dates in logical order). No field that would be non-null in production SHALL be left empty in seed data without an explicit reason documented in the spec. + +#### Scenario: Dutch naming conventions in BRP data +- **GIVEN** the BRP seed data is loaded +- **WHEN** person names are inspected +- **THEN** at least 3 persons MUST have a `voorvoegsel` value (e.g. "de", "van", "van der") +- **AND** at least 1 person MUST demonstrate `aanduidingNaamgebruik` other than "E" (eigen geslachtsnaam) + +#### Scenario: Valid Dutch postcodes +- **GIVEN** any address in BRP, KVK, or BAG seed data +- **WHEN** the `postcode` field is inspected +- **THEN** it MUST match the pattern `[1-9][0-9]{3}[A-Z]{2}` (four digits starting with non-zero, two uppercase letters) + +#### Scenario: Temporal consistency of dates +- **GIVEN** a BRP person record with geboorte, partners (with verbintenis date), and kinderen +- **WHEN** the dates are compared +- **THEN** the person's geboortedatum MUST precede any partner verbintenis date +- **AND** the person's geboortedatum MUST precede any child's geboortedatum +- **AND** if overlijden is present, overlijden.datum MUST be after geboortedatum + + +### Requirement: Performance with Mock Data Loaded + +The system MUST maintain acceptable performance with all five mock registers loaded simultaneously. The total seed data volume (approximately 250+ objects across 5 registers and 15+ schemas) MUST NOT degrade normal CRUD operations. Object listing with pagination (`_limit=20`, `_offset=0`) on a register with 35+ objects SHALL respond within 500ms. The SchemaMapper and RegisterMapper lookups used during import SHALL be cached by the ObjectService to avoid repeated database queries. + +#### Scenario: Object listing performance with loaded mock data +- **GIVEN** all five mock registers are loaded (approximately 250+ objects total) +- **WHEN** a paginated list request is made: `GET /api/objects/{brp_register_id}/{person_schema_id}?_limit=20&_offset=0` +- **THEN** the response SHALL be returned within 500ms +- **AND** the response SHALL include correct pagination metadata (total count, page info) + +#### Scenario: Search performance across mock data +- **GIVEN** all five mock registers are loaded +- **WHEN** a full-text search is performed: `GET /api/objects/{brp_register_id}/{person_schema_id}?_search=Rotterdam` +- **THEN** the response SHALL be returned within 1000ms +- **AND** results SHALL include all persons with Rotterdam in their verblijfplaats + +#### Scenario: Import performance for largest register +- **GIVEN** the ORI register file contains approximately 115 seed objects across 6 schemas +- **WHEN** the register is imported via `occ openregister:load-register` +- **THEN** the full import (register + schemas + objects) SHALL complete within 60 seconds +- **AND** no PHP memory limit errors SHALL occur with the default 512MB memory limit + + +### Requirement: Mock Register Reset and Refresh + +The system MUST support resetting mock registers to their original state. Administrators MUST be able to delete all data from a specific mock register and re-import it from the JSON file. The reset operation MUST remove all objects, then re-import from the source file. The system SHOULD support selective reset (single register) and bulk reset (all mock registers). + +#### Scenario: Reset single mock register +- **GIVEN** the BRP mock register has been loaded and some objects have been modified or deleted by users +- **WHEN** the administrator runs `occ openregister:load-register --force /var/www/html/custom_apps/openregister/lib/Settings/brp_register.json` +- **THEN** all modified objects SHALL be restored to their original seed data state +- **AND** the object count SHALL match the original JSON file's object count + +#### Scenario: Reset does not affect non-mock registers +- **GIVEN** the system contains both mock registers (type: "mock") and production registers +- **WHEN** a mock register reset operation is performed +- **THEN** only objects in the targeted mock register SHALL be affected +- **AND** all production registers and their objects SHALL remain untouched + +#### Scenario: Reset via API endpoint +- **GIVEN** an authenticated administrator session +- **WHEN** a POST request is made to `/api/registers/import` with the mock register JSON body +- **THEN** the import SHALL succeed with the same result as the OCC command +- **AND** the response SHALL include counts of created, updated, and skipped records + + +### Requirement: I18n of Mock Register Content + +Mock register metadata (register title, description, schema descriptions) MUST support Dutch and English per ADR-005. User-facing labels in the register and schema definitions SHALL use Nextcloud's `t()` translation system where displayed in the UI. The seed data content itself (person names, business names, addresses) MUST remain in Dutch as it represents Dutch government base registry data, but schema property descriptions SHOULD be bilingual. See also: `register-i18n` spec for the full i18n data model. + +#### Scenario: Register title displayed in user's locale +- **GIVEN** the BRP register has title "BRP (Basisregistratie Personen)" +- **WHEN** a user with locale `en` views the register list in the OpenRegister UI +- **THEN** the register title SHOULD be displayed as "BRP (Personal Records Database)" or the Dutch title with an English subtitle +- **AND** the register description SHOULD be available in both nl and en + +#### Scenario: Schema property descriptions bilingual +- **GIVEN** the `ingeschreven-persoon` schema has property `burgerservicenummer` +- **WHEN** the schema is rendered in the UI +- **THEN** the property description SHOULD be available in Dutch ("Burgerservicenummer, voldoet aan 11-proef") and English ("Citizen Service Number, passes 11-check validation") + +#### Scenario: Seed data content remains in Dutch +- **GIVEN** a BRP person record for Marianne de Jong +- **WHEN** the object is displayed to a user with locale `en` +- **THEN** the person's name, address, and municipality name SHALL remain in Dutch (these are proper nouns / official registry values) +- **AND** only UI labels, column headers, and navigation elements SHALL be translated + + +### Requirement: Mock Data Distinguishability + +The system MUST provide a mechanism for consuming apps and administrators to distinguish mock/demo data from production data. The `x-openregister.type` field set to `"mock"` on register JSON files MUST be persisted as register metadata. Consuming apps (Pipelinq, Procest) SHOULD be able to query registers by type to filter out mock data in production deployments. The system SHOULD display a visual indicator in the UI when viewing mock register data. + +#### Scenario: Filter registers by type via API +- **GIVEN** both mock registers and production registers exist in the system +- **WHEN** a consuming app queries `GET /api/registers?type=mock` +- **THEN** only registers with `x-openregister.type: "mock"` SHALL be returned + +#### Scenario: Visual indicator in register list +- **GIVEN** the BRP mock register is loaded +- **WHEN** an administrator views the register list in the OpenRegister admin UI +- **THEN** mock registers SHOULD display a badge or label indicating "Demo" or "Mock" +- **AND** the badge SHOULD be visually distinct (e.g. orange/yellow color) from production registers + +#### Scenario: Mock data exclusion in production +- **GIVEN** an administrator has set `mock_registers_enabled` to `false` in IAppConfig +- **WHEN** the app performs its installation/upgrade repair steps +- **THEN** no mock register JSON files SHALL be auto-imported +- **AND** previously imported mock data SHALL NOT be deleted (explicit reset required) + + +### Requirement: Schema Compliance with ADR-006 + +All mock register schemas MUST comply with ADR-006 (OpenRegister Schema Standards). Each schema MUST have a unique descriptive name, explicit property types (string, integer, boolean, datetime, array, object), and required property markings. Cross-entity references MUST use OpenRegister's relation mechanism rather than storing foreign keys as plain strings. Where applicable, schemas SHOULD align with schema.org vocabulary (e.g. BRP person maps to schema:Person concepts, KVK business maps to schema:Organization concepts) with a Dutch API mapping layer per ADR-006. + +#### Scenario: Property types explicitly defined +- **GIVEN** the `ingeschreven-persoon` schema definition in `brp_register.json` +- **WHEN** the schema's `properties` block is inspected +- **THEN** every property MUST have an explicit `type` (string, integer, boolean, array, object) +- **AND** string properties with restricted values MUST define an `enum` constraint + +#### Scenario: Required properties marked +- **GIVEN** the `maatschappelijke-activiteit` schema in `kvk_register.json` +- **WHEN** the schema's `required` array is inspected +- **THEN** it MUST include at minimum: `kvkNummer`, `naam`, `rechtsvorm` + +#### Scenario: Schema descriptions present +- **GIVEN** any schema in any mock register JSON file +- **WHEN** the schema definition is inspected +- **THEN** it MUST include a `description` field explaining the entity's purpose +- **AND** the description MUST be at least 20 characters long + + +### Requirement: Consuming App Discovery + +Mock registers MUST be discoverable by consuming apps (Pipelinq, Procest, OpenConnector) without hardcoding register or schema IDs. Consuming apps SHALL look up registers by slug (e.g. `brp`, `kvk`, `bag`) and schemas by slug (e.g. `ingeschreven-persoon`, `maatschappelijke-activiteit`) using the ObjectService or API. The register and schema slugs defined in the mock register JSON files MUST be stable across versions and SHALL NOT change without a major version bump. + +#### Scenario: Pipelinq discovers BRP register by slug +- **GIVEN** the BRP mock register is loaded with slug `brp` +- **WHEN** Pipelinq's klantbeeld-360 feature calls `store.getters.getRegisterBySlug('brp')` +- **THEN** the BRP register entity SHALL be returned with its database ID +- **AND** `store.getters.getSchemaBySlug('ingeschreven-persoon')` SHALL return the person schema + +#### Scenario: API-based register discovery +- **GIVEN** all mock registers are loaded +- **WHEN** a consuming app queries `GET /api/registers?slug=kvk` +- **THEN** the response SHALL contain exactly one register with slug `kvk` +- **AND** the register's schemas SHALL be accessible via the returned register ID + +#### Scenario: Slug stability across versions +- **GIVEN** mock register JSON files at version 1.0.0 define slugs `brp`, `kvk`, `bag`, `dso`, `ori` +- **WHEN** version 1.1.0 of the files is released +- **THEN** the same slugs MUST be preserved +- **AND** any slug change MUST be accompanied by a major version bump and migration documentation + + +### Requirement: Data Import/Export Integration + +Mock register data MUST be compatible with the data-import-export spec's batch import and export capabilities. Seed data loaded from mock register JSON files MUST be exportable via the standard export pipeline (CSV, Excel, JSON formats). Exported mock data MUST be re-importable without data loss. This ensures mock registers serve as both demo data and as templates for creating production registers with similar structures. + +#### Scenario: Export mock register to CSV +- **GIVEN** the BRP mock register is loaded with 35 person records +- **WHEN** an administrator exports the register via `GET /api/objects/{register_id}/{schema_id}?_format=csv` +- **THEN** the response SHALL be a valid CSV file with 35 data rows plus a header row +- **AND** all schema properties SHALL appear as column headers + +#### Scenario: Round-trip import/export +- **GIVEN** the KVK mock register is loaded +- **WHEN** the maatschappelijke-activiteit objects are exported to JSON and then re-imported into a new register +- **THEN** the re-imported objects SHALL contain identical data to the originals +- **AND** no field values SHALL be lost or truncated during the round-trip + +#### Scenario: Mock register as production template +- **GIVEN** an administrator wants to create a production BRP-like register with real data +- **WHEN** they export the BRP mock register's schema definitions (without seed objects) +- **THEN** the exported schema SHALL be usable as a template for creating a new empty register with the same structure diff --git a/openspec/changes/nextcloud-entity-relations/specs/nextcloud-entity-relations/spec.md b/openspec/changes/nextcloud-entity-relations/specs/nextcloud-entity-relations/spec.md new file mode 100644 index 000000000000..ddee9f40a4cc --- /dev/null +++ b/openspec/changes/nextcloud-entity-relations/specs/nextcloud-entity-relations/spec.md @@ -0,0 +1,441 @@ +--- +status: proposed +--- + +# Nextcloud Entity Relations + +## Purpose + +OpenRegister objects need to relate to the full spectrum of Nextcloud PIM entities — emails, calendar events, contacts, and Deck cards — so that consuming apps (Procest, Pipelinq, ZaakAfhandelApp) can present a unified view of all activities, stakeholders, and deadlines associated with an object. This spec extends the existing object-interactions pattern (files, notes, tasks) to four new entity types using the same architectural approach: thin service wrappers around Nextcloud APIs with standardized sub-resource endpoints. + +**Key principle**: OpenRegister does NOT import or sync these entities. It stores REFERENCES (relations) that point to the canonical entity in its native Nextcloud subsystem. The Nextcloud entity remains the source of truth. + +**Standards**: RFC 5545 (iCalendar/VEVENT), RFC 6350 (vCard), RFC 9253 (iCalendar LINK property), Nextcloud Mail Integration API, Nextcloud Deck OCS API +**Cross-references**: [object-interactions](../../../specs/object-interactions/spec.md), [event-driven-architecture](../../../specs/event-driven-architecture/spec.md), [audit-trail-immutable](../../../specs/audit-trail-immutable/spec.md) + +--- + +## Requirements + +### Requirement: Email Relations via Nextcloud Mail + +The system SHALL provide an `EmailService` that links Nextcloud Mail messages to OpenRegister objects. Email relations are READ-ONLY references — emails are immutable and managed by the Mail app. The relation is stored as an `openregister_email_links` database table mapping object UUIDs to Mail message IDs. + +#### Rationale + +Emails are a primary communication channel in case management. A case handler receives an application by email, exchanges correspondence with citizens and colleagues, and needs all related emails visible on the case object. Unlike tasks (CalDAV) and notes (Comments), Nextcloud Mail does not have a generic entity-linking API, so we store the relation in our own table. + +#### Storage Model + +``` +openregister_email_links +├── id (int, PK, autoincrement) +├── object_uuid (string, indexed) — the OpenRegister object UUID +├── mail_account_id (int) — Nextcloud Mail account ID +├── mail_message_id (int) — Nextcloud Mail internal message ID +├── mail_message_uid (string) — IMAP message UID for reference +├── subject (string) — cached subject line for display without Mail API call +├── sender (string) — cached sender address +├── date (datetime) — cached send date +├── linked_by (string) — user who created the link +├── linked_at (datetime) — when the link was created +└── register_id (int, indexed) — for scoping/cleanup +``` + +#### Scenario: Link an existing email to an object +- **GIVEN** an authenticated user `behandelaar-1` and an object with UUID `abc-123` +- **WHEN** a POST request is sent to `/api/objects/{register}/{schema}/abc-123/emails` with body `{"mailAccountId": 1, "mailMessageId": 42}` +- **THEN** the system MUST verify the email exists by querying Nextcloud Mail's message table +- **AND** create a record in `openregister_email_links` with the object UUID and mail message reference +- **AND** cache the subject, sender, and date from the mail message +- **AND** return HTTP 201 with the email link as JSON including `id`, `objectUuid`, `mailAccountId`, `mailMessageId`, `subject`, `sender`, `date`, `linkedBy`, `linkedAt` + +#### Scenario: List email relations for an object +- **GIVEN** object `abc-123` has 4 linked emails +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/emails?limit=10&offset=0` +- **THEN** the response MUST return `{"results": [...], "total": 4}` with all 4 email links +- **AND** each link MUST include: `id`, `mailAccountId`, `mailMessageId`, `subject`, `sender`, `date`, `linkedBy`, `linkedAt` +- **AND** results MUST be ordered by `date` descending (newest first) + +#### Scenario: Remove an email relation +- **GIVEN** email link with ID 7 exists on object `abc-123` +- **WHEN** a DELETE request is sent to `/api/objects/{register}/{schema}/abc-123/emails/7` +- **THEN** the record MUST be removed from `openregister_email_links` +- **AND** the actual email in Nextcloud Mail MUST NOT be deleted +- **AND** the response MUST return HTTP 200 with `{"success": true}` + +#### Scenario: Link email that does not exist +- **GIVEN** a POST request with `mailMessageId: 99999` that does not exist in Nextcloud Mail +- **WHEN** the system verifies the email +- **THEN** the API MUST return HTTP 404 with `{"error": "Mail message not found"}` + +#### Scenario: Prevent duplicate email links +- **GIVEN** email message 42 is already linked to object `abc-123` +- **WHEN** a POST request tries to link the same email again +- **THEN** the API MUST return HTTP 409 with `{"error": "Email already linked to this object"}` + +#### Scenario: Search objects by linked email +- **GIVEN** multiple objects have email links +- **WHEN** a GET request is sent to `/api/emails/search?sender=burger@test.local` +- **THEN** the response MUST return all objects that have a linked email from that sender +- **AND** this enables cross-object email thread tracking + +--- + +### Requirement: Calendar Event Relations via CalDAV VEVENT + +The system SHALL provide a `CalendarEventService` that creates, reads, and deletes CalDAV VEVENT items linked to OpenRegister objects. This follows the exact same pattern as `TaskService` (VTODO), but for calendar events. Each VEVENT MUST include `X-OPENREGISTER-REGISTER`, `X-OPENREGISTER-SCHEMA`, and `X-OPENREGISTER-OBJECT` custom properties, plus an RFC 9253 LINK property. + +#### Rationale + +Cases have associated deadlines, hearings, meetings, and milestones that are best represented as calendar events. Unlike tasks (which track work items), calendar events represent time-bound occurrences that may involve multiple participants. Storing them in CalDAV ensures they appear in the user's Nextcloud Calendar app. + +#### Scenario: Create a calendar event linked to an object +- **GIVEN** an object with UUID `abc-123` in register 5, schema 12 +- **WHEN** a POST request is sent to `/api/objects/5/12/abc-123/events` with body: + ```json + { + "summary": "Welstandscommissie - dakkapel Kerkstraat 42", + "dtstart": "2026-03-25T13:00:00Z", + "dtend": "2026-03-25T15:00:00Z", + "location": "Raadzaal - Stadskantoor", + "description": "Behandeling aanvraag ZK-2026-0142", + "attendees": ["behandelaar@test.local"] + } + ``` +- **THEN** a VEVENT MUST be created in the user's default calendar with: + - `X-OPENREGISTER-REGISTER:5` + - `X-OPENREGISTER-SCHEMA:12` + - `X-OPENREGISTER-OBJECT:abc-123` + - `LINK;LINKREL="related";VALUE=URI:/apps/openregister/api/objects/5/12/abc-123` + - `SUMMARY`, `DTSTART`, `DTEND`, `LOCATION`, `DESCRIPTION`, `ATTENDEE` as provided +- **AND** the response MUST return HTTP 201 with the event as JSON including `id`, `uid`, `calendarId`, `summary`, `dtstart`, `dtend`, `location`, `description`, `attendees`, `objectUuid`, `registerId`, `schemaId` + +#### Scenario: List calendar events for an object +- **GIVEN** 2 VEVENTs exist with `X-OPENREGISTER-OBJECT:abc-123` +- **WHEN** a GET request is sent to `/api/objects/5/12/abc-123/events` +- **THEN** the response MUST return `{"results": [...], "total": 2}` with all 2 events +- **AND** each event MUST include: `id` (URI), `uid`, `calendarId`, `summary`, `dtstart`, `dtend`, `location`, `description`, `attendees`, `status`, `objectUuid`, `registerId`, `schemaId` + +#### Scenario: Link an existing calendar event to an object +- **GIVEN** a VEVENT already exists in the user's calendar (e.g., created via NC Calendar UI) +- **WHEN** a POST request is sent to `/api/objects/5/12/abc-123/events/link` with `{"calendarId": 1, "eventUri": "meeting-123.ics"}` +- **THEN** the system MUST update the VEVENT to add X-OPENREGISTER-* properties +- **AND** return HTTP 200 with the updated event JSON + +#### Scenario: Delete a calendar event relation +- **GIVEN** a VEVENT linked to object `abc-123` +- **WHEN** a DELETE request is sent to `/api/objects/5/12/abc-123/events/{eventId}` +- **THEN** the X-OPENREGISTER-* properties MUST be removed from the VEVENT +- **AND** the VEVENT itself MUST remain in the calendar (only the link is removed) +- **AND** the response MUST return `{"success": true}` + +#### Scenario: Force-delete calendar event with object +- **GIVEN** a VEVENT linked to object `abc-123` and the object is being deleted +- **WHEN** `ObjectCleanupListener` handles `ObjectDeletedEvent` +- **THEN** the X-OPENREGISTER-* properties MUST be removed from all linked VEVENTs +- **AND** the VEVENTs MUST NOT be deleted (only unlinked) + +#### Scenario: Calendar selection for events +- **GIVEN** the user has calendars `personal` (VEVENT+VTODO) and `birthdays` (VEVENT only) +- **WHEN** an event is created via the API +- **THEN** the service MUST use the user's default calendar or the first VEVENT-supporting calendar +- **AND** optionally accept a `calendarId` parameter to target a specific calendar + +--- + +### Requirement: Contact Relations via CardDAV + +The system SHALL provide a `ContactService` that links CardDAV vCard contacts to OpenRegister objects. Contacts represent stakeholders (citizens, applicants, suppliers, colleagues) associated with a case/object. The relation is stored via X-OPENREGISTER-* custom properties on the vCard AND in an `openregister_contact_links` table for efficient querying. + +#### Rationale + +Every case has stakeholders — the citizen who filed the application, the colleague who handles it, the external advisor who reviews it. These people exist as contacts in Nextcloud's address book. Linking them to objects allows consuming apps to show "who is involved" and find all cases a contact is involved in. + +#### Storage Model (dual storage) + +**vCard custom properties** (on the contact itself): +``` +X-OPENREGISTER-OBJECT:abc-123 +X-OPENREGISTER-ROLE:applicant +``` + +**Database table** (for efficient querying): +``` +openregister_contact_links +├── id (int, PK, autoincrement) +├── object_uuid (string, indexed) +├── contact_uid (string) — vCard UID +├── addressbook_id (int) — CardDAV addressbook ID +├── contact_uri (string) — vCard URI in addressbook +├── display_name (string) — cached FN from vCard +├── email (string, nullable) — cached primary email +├── role (string, nullable) — e.g., "applicant", "handler", "advisor", "supplier" +├── linked_by (string) — user who created the link +├── linked_at (datetime) +└── register_id (int, indexed) +``` + +#### Scenario: Link an existing contact to an object +- **GIVEN** an authenticated user and an object with UUID `abc-123` +- **WHEN** a POST request is sent to `/api/objects/{register}/{schema}/abc-123/contacts` with body `{"addressbookId": 1, "contactUri": "jan-de-vries.vcf", "role": "applicant"}` +- **THEN** the system MUST verify the contact exists via `CalDavBackend` (addressbook backend) +- **AND** add `X-OPENREGISTER-OBJECT:abc-123` and `X-OPENREGISTER-ROLE:applicant` properties to the vCard +- **AND** create a record in `openregister_contact_links` with cached display name and email +- **AND** return HTTP 201 with the contact link as JSON including `id`, `objectUuid`, `contactUid`, `displayName`, `email`, `role`, `linkedBy`, `linkedAt` + +#### Scenario: Create a new contact and link to object +- **GIVEN** an authenticated user and an object with UUID `abc-123` +- **WHEN** a POST request is sent to `/api/objects/{register}/{schema}/abc-123/contacts` with body: + ```json + { + "fullName": "Jan de Vries", + "email": "jan@example.nl", + "phone": "+31612345678", + "role": "applicant" + } + ``` +- **THEN** a new vCard MUST be created in the user's default address book with the provided properties and X-OPENREGISTER-* properties +- **AND** a record MUST be created in `openregister_contact_links` +- **AND** the response MUST return HTTP 201 with the contact link JSON + +#### Scenario: List contacts for an object +- **GIVEN** object `abc-123` has 3 linked contacts (applicant, handler, advisor) +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/contacts` +- **THEN** the response MUST return `{"results": [...], "total": 3}` +- **AND** each contact MUST include: `id`, `contactUid`, `addressbookId`, `displayName`, `email`, `phone`, `role`, `linkedBy`, `linkedAt` + +#### Scenario: Update contact role on an object +- **GIVEN** contact link with ID 5 exists with role `"applicant"` +- **WHEN** a PUT request is sent to `/api/objects/{register}/{schema}/abc-123/contacts/5` with `{"role": "co-applicant"}` +- **THEN** the role MUST be updated in both the `openregister_contact_links` table and the vCard's `X-OPENREGISTER-ROLE` property +- **AND** the response MUST return the updated contact link JSON + +#### Scenario: Remove a contact relation +- **GIVEN** contact link with ID 5 exists on object `abc-123` +- **WHEN** a DELETE request is sent to `/api/objects/{register}/{schema}/abc-123/contacts/5` +- **THEN** the record MUST be removed from `openregister_contact_links` +- **AND** the `X-OPENREGISTER-OBJECT` and `X-OPENREGISTER-ROLE` properties MUST be removed from the vCard +- **AND** the vCard itself MUST NOT be deleted +- **AND** the response MUST return HTTP 200 with `{"success": true}` + +#### Scenario: Find all objects linked to a contact +- **GIVEN** contact `jan-de-vries` is linked to objects `abc-123` and `def-456` +- **WHEN** a GET request is sent to `/api/contacts/{contactUid}/objects` +- **THEN** the response MUST return both objects with their respective roles +- **AND** this enables the "case history for this person" view in consuming apps + +#### Scenario: Contact with multiple object links +- **GIVEN** contact `jan-de-vries` is already linked to object `abc-123` as applicant +- **WHEN** the same contact is linked to object `def-456` as co-applicant +- **THEN** the vCard MUST contain multiple `X-OPENREGISTER-OBJECT` properties +- **AND** both links MUST exist in the database table + +--- + +### Requirement: Deck Card Relations via Nextcloud Deck API + +The system SHALL provide a `DeckCardService` that links Nextcloud Deck cards to OpenRegister objects. Deck provides kanban-style boards, stacks (columns), and cards. Linking cards to objects enables workflow visualization where each card represents a case/object moving through process stages. + +#### Rationale + +Pipelinq and Procest use pipeline/kanban views. Deck is Nextcloud's native kanban tool. By linking Deck cards to objects, case managers get a visual workflow board where cards are backed by OpenRegister data. Moving a card between stacks can trigger status changes on the object. + +#### Storage Model + +``` +openregister_deck_links +├── id (int, PK, autoincrement) +├── object_uuid (string, indexed) +├── board_id (int) — Deck board ID +├── stack_id (int) — Deck stack (column) ID +├── card_id (int) — Deck card ID +├── card_title (string) — cached card title +├── linked_by (string) +├── linked_at (datetime) +└── register_id (int, indexed) +``` + +#### Scenario: Create a Deck card linked to an object +- **GIVEN** an authenticated user, an object with UUID `abc-123`, and a Deck board with ID 1 +- **WHEN** a POST request is sent to `/api/objects/{register}/{schema}/abc-123/deck` with body: + ```json + { + "boardId": 1, + "stackId": 2, + "title": "ZK-2026-0142 - Omgevingsvergunning dakkapel", + "description": "Behandeling aanvraag omgevingsvergunning" + } + ``` +- **THEN** a card MUST be created via the Deck API (`OCA\Deck\Service\CardService`) +- **AND** the card description MUST include a link back to the object: `[Object: abc-123](/apps/openregister/api/objects/{register}/{schema}/abc-123)` +- **AND** a record MUST be created in `openregister_deck_links` +- **AND** the response MUST return HTTP 201 with the deck link as JSON including `id`, `objectUuid`, `boardId`, `stackId`, `cardId`, `cardTitle`, `linkedBy`, `linkedAt` + +#### Scenario: Link an existing Deck card to an object +- **GIVEN** a Deck card with ID 15 already exists +- **WHEN** a POST request is sent to `/api/objects/{register}/{schema}/abc-123/deck` with body `{"cardId": 15}` +- **THEN** the system MUST verify the card exists via Deck API +- **AND** update the card description to include the object link +- **AND** create a record in `openregister_deck_links` +- **AND** return HTTP 201 with the deck link JSON + +#### Scenario: List Deck cards for an object +- **GIVEN** object `abc-123` is linked to 2 Deck cards (one in "Nieuw", one in "In behandeling") +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/deck` +- **THEN** the response MUST return `{"results": [...], "total": 2}` +- **AND** each link MUST include: `id`, `boardId`, `stackId`, `cardId`, `cardTitle`, `stackTitle`, `linkedBy`, `linkedAt` +- **AND** the `stackTitle` MUST be resolved from the Deck API (e.g., "Nieuw", "In behandeling") + +#### Scenario: Remove a Deck card relation +- **GIVEN** deck link with ID 3 exists on object `abc-123` +- **WHEN** a DELETE request is sent to `/api/objects/{register}/{schema}/abc-123/deck/3` +- **THEN** the record MUST be removed from `openregister_deck_links` +- **AND** the Deck card itself MUST NOT be deleted (only the link is removed) +- **AND** the object link MUST be removed from the card description +- **AND** the response MUST return HTTP 200 with `{"success": true}` + +#### Scenario: Find objects by Deck board +- **GIVEN** a Deck board "Vergunningen Pipeline" with cards linked to multiple objects +- **WHEN** a GET request is sent to `/api/deck/boards/{boardId}/objects` +- **THEN** the response MUST return all objects linked to cards on that board +- **AND** include the stack (column) each object's card is in + +--- + +### Requirement: Unified Relations API + +The system SHALL provide a unified endpoint to retrieve ALL relations (files, notes, tasks, emails, events, contacts, deck cards) for an object in a single request. This enables consuming apps to build a complete "object dossier" view without multiple API calls. + +#### Scenario: Get all relations for an object +- **GIVEN** object `abc-123` has 2 files, 3 notes, 1 task, 4 emails, 2 events, 3 contacts, and 1 deck card +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/relations` +- **THEN** the response MUST return: + ```json + { + "files": {"results": [...], "total": 2}, + "notes": {"results": [...], "total": 3}, + "tasks": {"results": [...], "total": 1}, + "emails": {"results": [...], "total": 4}, + "events": {"results": [...], "total": 2}, + "contacts": {"results": [...], "total": 3}, + "deck": {"results": [...], "total": 1} + } + ``` + +#### Scenario: Filter relations by type +- **GIVEN** the unified relations endpoint +- **WHEN** a GET request includes `?types=emails,contacts` +- **THEN** only email and contact relations MUST be returned + +#### Scenario: Relations timeline view +- **GIVEN** all relations have a date field (creation date, send date, event date) +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/relations?view=timeline` +- **THEN** all relations MUST be returned in a flat array sorted by date +- **AND** each item MUST include a `type` field ("file", "note", "task", "email", "event", "contact", "deck") + +--- + +### Requirement: Object Deletion Cleanup for New Entity Types + +The `ObjectCleanupListener` SHALL be extended to handle cleanup of email links, calendar event links, contact links, and deck card links when an object is deleted. This follows the existing cleanup pattern for notes and tasks. + +#### Scenario: Delete object with email links +- **GIVEN** object `abc-123` has 4 email links +- **WHEN** the object is deleted (triggering `ObjectDeletedEvent`) +- **THEN** all 4 records in `openregister_email_links` with `object_uuid: "abc-123"` MUST be deleted +- **AND** the actual emails in Nextcloud Mail MUST NOT be affected + +#### Scenario: Delete object with calendar event links +- **GIVEN** object `abc-123` has 2 linked VEVENTs +- **WHEN** the object is deleted +- **THEN** X-OPENREGISTER-* properties MUST be removed from both VEVENTs +- **AND** the VEVENTs MUST remain in the calendar + +#### Scenario: Delete object with contact links +- **GIVEN** object `abc-123` has 3 linked contacts +- **WHEN** the object is deleted +- **THEN** all 3 records in `openregister_contact_links` MUST be deleted +- **AND** X-OPENREGISTER-* properties referencing `abc-123` MUST be removed from the vCards +- **AND** the vCards MUST NOT be deleted + +#### Scenario: Delete object with Deck card links +- **GIVEN** object `abc-123` has 1 linked Deck card +- **WHEN** the object is deleted +- **THEN** the record in `openregister_deck_links` MUST be deleted +- **AND** the object link MUST be removed from the Deck card description +- **AND** the Deck card MUST NOT be deleted + +#### Scenario: Partial cleanup failure does not block deletion +- **GIVEN** an object with relations across all entity types +- **WHEN** the cleanup of one entity type fails (e.g., Deck API unavailable) +- **THEN** cleanup of other entity types MUST still proceed +- **AND** the failure MUST be logged as a warning +- **AND** the object deletion MUST NOT be blocked + +--- + +### Requirement: Event Dispatching for Relation Changes + +The system SHALL fire typed events when relations are created or removed. These events follow the CloudEvents format from [event-driven-architecture](../../../specs/event-driven-architecture/spec.md). + +#### Scenario: Email link created fires event +- **GIVEN** an email is linked to object `abc-123` +- **THEN** an event `nl.openregister.object.email.linked` MUST be dispatched with the object UUID and mail message details + +#### Scenario: Contact linked fires event +- **GIVEN** a contact is linked to object `abc-123` with role `applicant` +- **THEN** an event `nl.openregister.object.contact.linked` MUST be dispatched with the object UUID, contact UID, and role + +#### Scenario: Calendar event linked fires event +- **GIVEN** a calendar event is linked to object `abc-123` +- **THEN** an event `nl.openregister.object.event.linked` MUST be dispatched with the object UUID and event summary/dates + +#### Scenario: Deck card linked fires event +- **GIVEN** a Deck card is linked to object `abc-123` +- **THEN** an event `nl.openregister.object.deck.linked` MUST be dispatched with the object UUID, board ID, and card title + +#### Scenario: Relation removed fires event +- **GIVEN** any relation is removed from an object +- **THEN** an `*.unlinked` event MUST be dispatched (e.g., `nl.openregister.object.email.unlinked`) + +--- + +### Requirement: Audit Trail for Relation Mutations + +All relation mutations SHALL generate audit trail entries per [audit-trail-immutable](../../../specs/audit-trail-immutable/spec.md). + +#### Scenario: Audit entries for relation actions +- **GIVEN** the following relation actions occur +- **THEN** the corresponding audit entries MUST be created: + - `email.linked` / `email.unlinked` + - `event.linked` / `event.unlinked` / `event.created` + - `contact.linked` / `contact.unlinked` / `contact.created` + - `deck.linked` / `deck.unlinked` / `deck.created` + +--- + +### Requirement: Graceful Degradation When NC Apps Are Disabled + +The system SHALL gracefully handle cases where a required Nextcloud app (Mail, Deck) is not installed or disabled. CalDAV/CardDAV are core Nextcloud features and always available; Mail and Deck are optional apps. + +#### Scenario: Mail app not installed +- **GIVEN** the Nextcloud Mail app is not installed +- **WHEN** a request is made to `/api/objects/{register}/{schema}/{id}/emails` +- **THEN** the API MUST return HTTP 501 with `{"error": "Nextcloud Mail app is not installed", "code": "APP_NOT_AVAILABLE"}` + +#### Scenario: Deck app not installed +- **GIVEN** the Nextcloud Deck app is not installed +- **WHEN** a request is made to `/api/objects/{register}/{schema}/{id}/deck` +- **THEN** the API MUST return HTTP 501 with `{"error": "Nextcloud Deck app is not installed", "code": "APP_NOT_AVAILABLE"}` + +#### Scenario: Relations API with missing apps +- **GIVEN** the unified relations endpoint and Mail app is not installed +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/{id}/relations` +- **THEN** the `emails` section MUST be omitted from the response (not an error) +- **AND** all other relation types MUST still be returned normally + +#### Scenario: CalDAV/CardDAV always available +- **GIVEN** CalDAV and CardDAV are core Nextcloud services +- **WHEN** calendar event or contact relation endpoints are called +- **THEN** these MUST always work regardless of which apps are installed diff --git a/openspec/changes/object-interactions/specs/object-interactions/spec.md b/openspec/changes/object-interactions/specs/object-interactions/spec.md new file mode 100644 index 000000000000..a891e311ab66 --- /dev/null +++ b/openspec/changes/object-interactions/specs/object-interactions/spec.md @@ -0,0 +1,327 @@ +--- +status: draft +--- +# Object Interactions + +## Purpose +OpenRegister objects require rich interaction capabilities — notes, tasks, file attachments, tags, and audit trails — that allow users to collaborate on and track the lifecycle of register data. Rather than building custom interaction systems, this spec defines a convenience API layer that wraps Nextcloud's native subsystems (CalDAV for tasks, ICommentsManager for notes, IRootFolder for files, Nextcloud tags) and links them to OpenRegister objects via standardized properties. + +## ADDED Requirements + + +### Requirement: Notes on Objects via ICommentsManager + +The system SHALL provide a `NoteService` that wraps Nextcloud's `OCP\Comments\ICommentsManager` for creating, listing, and deleting notes (comments) on OpenRegister objects. Notes MUST be stored using `objectType: "openregister"` and `objectId: {uuid}`. The service MUST resolve actor display names via `OCP\IUserManager` and indicate whether the current user authored each note. + +#### Scenario: Create a note on an object +- **GIVEN** an authenticated user `behandelaar-1` and an OpenRegister object with UUID `abc-123` +- **WHEN** a POST request is sent to `/api/objects/{register}/{schema}/abc-123/notes` with body `{"message": "Applicant called, will send documents tomorrow"}` +- **THEN** a comment MUST be created via `ICommentsManager::create()` with `actorType: "users"`, `actorId: "behandelaar-1"`, `objectType: "openregister"`, `objectId: "abc-123"` +- **AND** the response MUST return HTTP 201 with the note as JSON including `id`, `message`, `actorId`, `actorDisplayName`, `createdAt`, and `isCurrentUser: true` + +#### Scenario: List notes with pagination +- **GIVEN** 15 notes exist on object `abc-123` +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/notes?limit=10&offset=0` +- **THEN** the response MUST return a JSON object with `results` (array of 10 note objects) and `total` (10, the count of returned results) +- **AND** each note MUST include: `id`, `message`, `actorType`, `actorId`, `actorDisplayName`, `createdAt`, `isCurrentUser` +- **AND** notes MUST be ordered newest-first (as returned by `ICommentsManager::getForObject()`) + +#### Scenario: Delete a note +- **GIVEN** a note with ID 42 exists on object `abc-123` +- **WHEN** a DELETE request is sent to `/api/objects/{register}/{schema}/abc-123/notes/42` +- **THEN** the note MUST be removed via `ICommentsManager::delete()` +- **AND** the response MUST return HTTP 200 with `{"success": true}` + +#### Scenario: Create note on non-existent object +- **GIVEN** no object exists with the specified register/schema/id +- **WHEN** a POST request is sent to create a note +- **THEN** the API MUST return HTTP 404 with `{"error": "Object not found"}` + +#### Scenario: Create note with empty message +- **GIVEN** an authenticated user and a valid object +- **WHEN** a POST request is sent with `{"message": ""}` +- **THEN** the API MUST return HTTP 400 with `{"error": "Note message is required"}` + + +### Requirement: Tasks on Objects via CalDAV VTODO + +The system SHALL provide a `TaskService` that creates, reads, updates, and deletes CalDAV VTODO items linked to OpenRegister objects. Each VTODO MUST include `X-OPENREGISTER-REGISTER`, `X-OPENREGISTER-SCHEMA`, and `X-OPENREGISTER-OBJECT` custom properties, plus an RFC 9253 LINK property pointing back to the object API endpoint. Tasks MUST be stored in the user's first VTODO-supporting calendar via `OCA\DAV\CalDAV\CalDavBackend`. + +#### Scenario: Create a task linked to an object +- **GIVEN** an OpenRegister object with UUID `abc-123` in register 5, schema 12 +- **WHEN** a POST request is sent to `/api/objects/5/12/abc-123/tasks` with body `{"summary": "Review documents", "due": "2026-03-01T17:00:00Z", "priority": 1}` +- **THEN** a VTODO MUST be created in the user's default VTODO-supporting calendar with: + - `X-OPENREGISTER-REGISTER:5` + - `X-OPENREGISTER-SCHEMA:12` + - `X-OPENREGISTER-OBJECT:abc-123` + - `LINK;LINKREL="related";VALUE=URI:/apps/openregister/api/objects/5/12/abc-123` + - `STATUS:NEEDS-ACTION`, `PRIORITY:1`, `SUMMARY:Review documents`, `DUE:20260301T170000Z` +- **AND** the response MUST return HTTP 201 with the task as JSON including `id`, `uid`, `calendarId`, `summary`, `description`, `status`, `priority`, `due`, `completed`, `created`, `objectUuid`, `registerId`, `schemaId` + +#### Scenario: List tasks for an object +- **GIVEN** 3 VTODOs exist with `X-OPENREGISTER-OBJECT:abc-123` +- **WHEN** a GET request is sent to `/api/objects/5/12/abc-123/tasks` +- **THEN** the response MUST return `{"results": [...], "total": 3}` with all 3 tasks +- **AND** each task MUST include: `id` (URI), `uid`, `calendarId`, `summary`, `description`, `status`, `priority`, `due`, `completed`, `created`, `objectUuid`, `registerId`, `schemaId` + +#### Scenario: Update task status to completed +- **GIVEN** a VTODO linked to object `abc-123` with status `NEEDS-ACTION` +- **WHEN** a PUT request is sent with `{"status": "completed"}` +- **THEN** the VTODO STATUS MUST be set to `COMPLETED` +- **AND** the `COMPLETED` timestamp MUST be set to the current UTC time +- **AND** the `X-OPENREGISTER-*` properties MUST remain unchanged +- **AND** the response MUST return the updated task as JSON + +#### Scenario: Delete a task +- **GIVEN** a VTODO linked to object `abc-123` +- **WHEN** a DELETE request is sent to `/api/objects/5/12/abc-123/tasks/{taskId}` +- **THEN** the VTODO MUST be removed from the calendar via `CalDavBackend::deleteCalendarObject()` +- **AND** the response MUST return `{"success": true}` + +#### Scenario: Task summary is required +- **GIVEN** a POST request to create a task with empty summary +- **WHEN** the controller validates the request +- **THEN** the API MUST return HTTP 400 with `{"error": "Task summary is required"}` + + +### Requirement: Task Status Mapping + +The system SHALL map CalDAV VTODO STATUS values to lowercase JSON strings for consistent API responses. The mapping MUST be bidirectional: incoming status values from the API MUST be converted to uppercase for CalDAV storage. + +#### Scenario: Status normalization on read +- **GIVEN** a VTODO with `STATUS:NEEDS-ACTION` +- **WHEN** the task is returned via the API +- **THEN** the `status` field MUST be `"needs-action"` + +#### Scenario: Status normalization on write +- **GIVEN** an API request with `{"status": "in-process"}` +- **WHEN** the task is updated +- **THEN** the VTODO STATUS MUST be set to `IN-PROCESS` + +#### Scenario: Complete status mapping table +- **GIVEN** the following CalDAV STATUS values +- **THEN** the mapping MUST be: + - `NEEDS-ACTION` to/from `"needs-action"` + - `IN-PROCESS` to/from `"in-process"` + - `COMPLETED` to/from `"completed"` + - `CANCELLED` to/from `"cancelled"` + + +### Requirement: Calendar Selection for Tasks + +The system SHALL determine which CalDAV calendar to use by finding the user's first calendar that supports VTODO components. The `TaskService::findUserCalendar()` method MUST check the `supported-calendar-component-set` property on each calendar and handle object, string, and iterable component sets. + +#### Scenario: Use first VTODO-supporting calendar +- **GIVEN** the user has calendars `personal` (VEVENT+VTODO) and `birthdays` (VEVENT only) +- **WHEN** tasks are created or listed +- **THEN** the service MUST use the `personal` calendar + +#### Scenario: No VTODO-supporting calendar available +- **GIVEN** the user has no calendars that support VTODO +- **WHEN** a task operation is attempted +- **THEN** the service MUST throw an Exception with message `"No VTODO-supporting calendar found for user {uid}"` +- **AND** the controller MUST return HTTP 500 + +#### Scenario: No user logged in +- **GIVEN** no user session is active +- **WHEN** a task operation is attempted +- **THEN** the service MUST throw an Exception with message `"No user logged in"` + + +### Requirement: File Attachments on Objects + +The system SHALL provide file attachment operations as sub-resource endpoints under objects. Files MUST be stored in Nextcloud's filesystem via `OCP\Files\IRootFolder` and linked to OpenRegister objects. The system MUST support upload, download, listing, deletion, and publish/depublish operations. + +#### Scenario: Upload a file to an object +- **GIVEN** an OpenRegister object with UUID `abc-123` +- **WHEN** a POST request is sent to `/api/objects/{register}/{schema}/abc-123/files` with a file payload +- **THEN** the file MUST be stored in the Nextcloud filesystem +- **AND** the file MUST be linked to the object +- **AND** the response MUST return HTTP 201 with the file metadata + +#### Scenario: List files for an object +- **GIVEN** object `abc-123` has 3 attached files +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/files` +- **THEN** the response MUST return all 3 files with metadata including `fileId`, `name`, `mimeType`, `size` + +#### Scenario: Download all files as archive +- **GIVEN** object `abc-123` has multiple attached files +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/files/download` +- **THEN** all files MUST be returned as a downloadable archive + +#### Scenario: Publish a file for public access +- **GIVEN** a file with ID 42 is attached to object `abc-123` +- **WHEN** a POST request is sent to `/api/objects/{register}/{schema}/abc-123/files/42/publish` +- **THEN** the file MUST be made publicly accessible via a share link + +#### Scenario: Delete a file from an object +- **GIVEN** a file with ID 42 is attached to object `abc-123` +- **WHEN** a DELETE request is sent to `/api/objects/{register}/{schema}/abc-123/files/42` +- **THEN** the file MUST be removed from the object and the filesystem + + +### Requirement: Tags for Object Categorization + +The system SHALL provide tag management for categorizing objects and files. Tags MUST be retrievable via a dedicated API endpoint and usable for filtering objects across registers and schemas. + +#### Scenario: List all tags +- **GIVEN** objects across multiple schemas use tags `urgent`, `pending`, `approved` +- **WHEN** a GET request is sent to `/api/tags` +- **THEN** the response MUST return all distinct tags used in the system + +#### Scenario: Tags used for object filtering +- **GIVEN** 5 objects are tagged with `urgent` +- **WHEN** objects are queried with a tag filter +- **THEN** only objects matching the specified tag MUST be returned + +#### Scenario: Tags on files +- **GIVEN** a file attached to an object has tag `contract` +- **WHEN** files are queried with a tag filter +- **THEN** only files matching the specified tag MUST be returned + + +### Requirement: Audit Trail Integration for Interactions + +All interaction mutations (note created, note deleted, task created, task completed, task deleted, file uploaded, file deleted) SHALL be reflected in the object's audit trail as defined by the [audit-trail-immutable](../audit-trail-immutable/spec.md) spec. The audit trail entries for interactions MUST be distinguishable from data mutation entries. + +#### Scenario: Note creation generates audit entry +- **GIVEN** user `behandelaar-1` creates a note on object `abc-123` +- **WHEN** the note is persisted +- **THEN** an audit trail entry SHOULD be created with `action: "note.created"` and the note content in `data` + +#### Scenario: Task completion generates audit entry +- **GIVEN** user `coordinator-1` completes task `Review documents` on object `abc-123` +- **WHEN** the task status is updated to `completed` +- **THEN** an audit trail entry SHOULD be created with `action: "task.completed"` and the task summary in `data` + +#### Scenario: File upload generates audit entry +- **GIVEN** user `behandelaar-1` uploads file `contract.pdf` to object `abc-123` +- **WHEN** the file is persisted +- **THEN** an audit trail entry SHOULD be created with `action: "file.uploaded"` and the file metadata in `data` + +#### Scenario: Audit entries are hash-chained +- **GIVEN** interaction audit entries exist for object `abc-123` +- **WHEN** an auditor verifies the hash chain +- **THEN** interaction entries MUST participate in the same hash chain as data mutation entries per [audit-trail-immutable](../audit-trail-immutable/spec.md) + + +### Requirement: Event-Driven Interaction Notifications + +The system SHALL fire typed events via `OCP\EventDispatcher\IEventDispatcher` when interactions occur on objects. These events MUST follow the CloudEvents format defined in [event-driven-architecture](../event-driven-architecture/spec.md) and be consumable by the [notificatie-engine](../notificatie-engine/spec.md) for notification delivery. + +#### Scenario: Note creation fires event +- **GIVEN** a note is created on object `abc-123` +- **WHEN** `NoteService::createNote()` succeeds +- **THEN** an event of type `nl.openregister.object.note.created` SHOULD be dispatched via `IEventDispatcher` +- **AND** the event payload MUST include the object UUID, note ID, actor ID, and message preview + +#### Scenario: Task completion fires event +- **GIVEN** a task on object `abc-123` is marked as completed +- **WHEN** `TaskService::updateTask()` detects a status change to `COMPLETED` +- **THEN** an event of type `nl.openregister.object.task.completed` SHOULD be dispatched +- **AND** consuming apps (Procest, Pipelinq) MAY react to update case status or trigger workflows + +#### Scenario: File upload fires event +- **GIVEN** a file is uploaded to object `abc-123` +- **WHEN** the file is persisted via `FileService` +- **THEN** an event of type `nl.openregister.object.file.uploaded` SHOULD be dispatched +- **AND** the event payload MUST include the object UUID, file ID, filename, and MIME type + +#### Scenario: Webhook delivery for interaction events +- **GIVEN** an external system has subscribed to `nl.openregister.object.note.created` via webhook +- **WHEN** a note is created +- **THEN** the event MUST be delivered to the webhook URL as a CloudEvent per [event-driven-architecture](../event-driven-architecture/spec.md) + + +### Requirement: Object Deletion Cleanup + +The system SHALL cascade-delete all linked interactions when an OpenRegister object is deleted. The `ObjectCleanupListener` MUST listen for `ObjectDeletedEvent` and clean up notes via `ICommentsManager::deleteCommentsAtObject()` and tasks via `TaskService::getTasksForObject()` followed by `TaskService::deleteTask()` for each task. Failures on individual cleanup operations MUST be logged as warnings but MUST NOT block the object deletion. + +#### Scenario: Delete object with notes +- **GIVEN** object `abc-123` has 5 notes +- **WHEN** the object is deleted (triggering `ObjectDeletedEvent`) +- **THEN** all 5 comments with `objectType: "openregister"` and `objectId: "abc-123"` MUST be deleted via `ICommentsManager::deleteCommentsAtObject()` + +#### Scenario: Delete object with tasks +- **GIVEN** object `abc-123` has 2 linked VTODOs +- **WHEN** the object is deleted +- **THEN** the `ObjectCleanupListener` MUST query tasks via `TaskService::getTasksForObject()` +- **AND** delete each task via `TaskService::deleteTask(calendarId, taskUri)` +- **AND** log the number of deleted tasks + +#### Scenario: Partial cleanup failure does not block deletion +- **GIVEN** object `abc-123` has 3 tasks and the second task deletion fails +- **WHEN** the object is deleted +- **THEN** the first and third tasks MUST still be deleted +- **AND** the failure MUST be logged as a warning +- **AND** the object deletion MUST proceed + +#### Scenario: Delete object with files +- **GIVEN** object `abc-123` has 2 attached files +- **WHEN** the object is deleted +- **THEN** the linked files SHOULD be cleaned up from the Nextcloud filesystem + + +### Requirement: Unified Interaction Timeline API + +The system SHALL provide an endpoint that returns a combined, chronologically ordered timeline of all interactions (notes, tasks, files, audit trail entries) for a given object. This enables consuming apps to render a single activity feed per object. + +#### Scenario: Retrieve combined timeline +- **GIVEN** object `abc-123` has 3 notes, 2 tasks, and 1 file attachment created at different times +- **WHEN** a GET request is sent to `/api/objects/{register}/{schema}/abc-123/timeline` +- **THEN** the response SHOULD return all 6 interactions merged in reverse chronological order +- **AND** each entry MUST include a `type` field (`note`, `task`, `file`, `audit`) and a `createdAt` timestamp + +#### Scenario: Timeline pagination +- **GIVEN** object `abc-123` has 50 interactions +- **WHEN** a GET request is sent with `?limit=20&offset=0` +- **THEN** only the 20 most recent interactions SHOULD be returned + +#### Scenario: Timeline filtered by type +- **GIVEN** object `abc-123` has interactions of mixed types +- **WHEN** a GET request is sent with `?type=note` +- **THEN** only note interactions SHOULD be returned + + +### Requirement: Task Compatibility with Nextcloud Tasks App + +Tasks created through OpenRegister MUST be fully compatible with Nextcloud's Tasks app. The `X-OPENREGISTER-*` custom properties MUST NOT break standard CalDAV clients, which ignore unknown X- properties per RFC 5545. Users MUST be able to view and edit OpenRegister-linked tasks in the Nextcloud Tasks app. + +#### Scenario: Task visible in Nextcloud Tasks app +- **GIVEN** a task created via OpenRegister's API on object `abc-123` +- **WHEN** the user opens the Nextcloud Tasks app +- **THEN** the task MUST appear in the user's calendar with its summary, due date, priority, and status + +#### Scenario: Task edited in Nextcloud Tasks app +- **GIVEN** a task linked to object `abc-123` is edited in the Nextcloud Tasks app (e.g., status changed to completed) +- **WHEN** the task is queried via OpenRegister's API +- **THEN** the updated status MUST be reflected in the API response +- **AND** the `X-OPENREGISTER-*` linking properties MUST remain intact + +#### Scenario: X-properties ignored by third-party CalDAV clients +- **GIVEN** a third-party CalDAV client syncs the user's calendar +- **WHEN** it encounters `X-OPENREGISTER-REGISTER`, `X-OPENREGISTER-SCHEMA`, `X-OPENREGISTER-OBJECT` +- **THEN** the client MUST ignore these properties per RFC 5545 section 3.8.8.2 (non-standard properties) + + +### Requirement: Task Query Performance + +The system SHALL use in-memory filtering for task queries. `TaskService::getTasksForObject()` MUST load calendar objects via `CalDavBackend::getCalendarObjects()`, perform a fast `strpos()` pre-filter for the object UUID, and only parse matching objects with `Sabre\VObject\Reader`. This approach MUST complete within 2 seconds for objects with up to 50 tasks. + +#### Scenario: Pre-filter reduces parsing overhead +- **GIVEN** a user's calendar has 500 VTODOs but only 3 are linked to object `abc-123` +- **WHEN** tasks are queried for `abc-123` +- **THEN** only calendar objects containing the string `abc-123` MUST be parsed with `Sabre\VObject\Reader` +- **AND** the remaining ~497 objects MUST be skipped via `strpos()` check + +#### Scenario: Non-VTODO objects are skipped +- **GIVEN** the calendar contains VEVENT objects alongside VTODOs +- **WHEN** tasks are queried +- **THEN** objects not containing `VTODO` in their data MUST be skipped before parsing + +#### Scenario: Performance degradation warning +- **GIVEN** a user with a very large calendar (10,000+ objects) +- **WHEN** tasks are queried +- **THEN** the query MAY take longer than 2 seconds +- **AND** this is a known limitation of the PHP-based post-filter approach (not a CalDAV REPORT query) + diff --git a/openspec/changes/openapi-generation/specs/openapi-generation/spec.md b/openspec/changes/openapi-generation/specs/openapi-generation/spec.md new file mode 100644 index 000000000000..6b9a90d8ab5c --- /dev/null +++ b/openspec/changes/openapi-generation/specs/openapi-generation/spec.md @@ -0,0 +1,456 @@ +--- +status: implemented +--- + +# OpenAPI Generation + +## Purpose +Auto-generate OpenAPI 3.1.0 specifications from register and schema definitions stored in OpenRegister, producing complete API documentation that covers every CRUD endpoint, query parameter, authentication scheme, and response model. The generated spec MUST be downloadable in JSON and YAML formats, serveable via an interactive Swagger UI, and MUST regenerate automatically when schemas change so that documentation never drifts from the live API surface. The generation pipeline MUST also support NL API Design Rules compliance markers for Dutch government API interoperability. + +**Source**: Gap identified in cross-platform analysis; developer experience improvement. Competitors Strapi (`@strapi/openapi`) and Directus both auto-generate OpenAPI specs from their data models. NocoDB exposes a Swagger endpoint per base. + +## Requirements + +### Requirement: The system MUST auto-generate OpenAPI 3.1.0 specs from register/schema definitions +Each register MUST have an automatically generated OpenAPI 3.1.0 specification reflecting all schemas belonging to that register, their properties, and all available CRUD operations. The generation MUST be driven by `OasService::createOas()` reading from `RegisterMapper` and `SchemaMapper`, using `BaseOas.json` as the foundation template. + +#### Scenario: Generate OpenAPI spec for a single register +- **GIVEN** register `zaken` (id=1) exists with schemas `meldingen` and `vergunningen` +- **WHEN** `GET /api/registers/1/oas` is requested +- **THEN** the response MUST return a valid OpenAPI 3.1.0 JSON document containing: + - `openapi`: `"3.1.0"` + - `info.title`: `"zaken API"` (register title + " API") + - `info.version`: the register's version string from `Register::getVersion()` + - `info.contact` and `info.license` preserved from `BaseOas.json` + - Paths for each schema: `GET /objects/zaken/meldingen`, `POST /objects/zaken/meldingen`, `GET /objects/zaken/meldingen/{id}`, `PUT /objects/zaken/meldingen/{id}`, `DELETE /objects/zaken/meldingen/{id}` + - Matching paths for `vergunningen` + - Schema definitions under `components.schemas` derived from each schema's property definitions + +#### Scenario: Generate combined OpenAPI spec for all registers +- **GIVEN** registers `zaken` and `burgerzaken` both exist with schemas +- **WHEN** `GET /api/registers/oas` is requested (no register ID) +- **THEN** the response MUST return a single OpenAPI document covering all registers +- **AND** `operationId` values MUST be prefixed with the PascalCase register title (e.g., `ZakenGetAllMeldingen`, `BurgerzakenGetAllAdressen`) to ensure uniqueness across registers + +#### Scenario: Register without schemas produces minimal valid spec +- **GIVEN** register `leeg` exists but has zero schemas assigned +- **WHEN** `GET /api/registers/{leeg-id}/oas` is requested +- **THEN** the response MUST be a valid OpenAPI 3.1.0 document with empty `paths: {}` and only the base `components.schemas` (Error, PaginatedResponse, _self) + +#### Scenario: Schema with empty title is excluded +- **GIVEN** a schema exists with `title = ""` or `title = null` +- **WHEN** OAS is generated +- **THEN** that schema MUST be silently skipped (no paths, no component definition, no tag) + +### Requirement: Schema property definitions MUST map correctly to OpenAPI types +Every property defined in an OpenRegister schema MUST be translated to a valid OpenAPI 3.1.0 schema definition. The mapping MUST handle all JSON Schema types, format annotations, enumerations, composition keywords, and nested structures. Property sanitization is performed by `OasService::sanitizePropertyDefinition()`. + +#### Scenario: Basic property type mapping +- **GIVEN** schema `meldingen` with properties: + - `title` (type: string, required: true) + - `count` (type: integer) + - `active` (type: boolean) + - `tags` (type: array, items: {type: string}) + - `metadata` (type: object) + - `score` (type: number) +- **THEN** the OpenAPI component schema MUST define: + - `title`: `{type: "string"}` + - `count`: `{type: "integer"}` + - `active`: `{type: "boolean"}` + - `tags`: `{type: "array", items: {type: "string"}}` + - `metadata`: `{type: "object"}` + - `score`: `{type: "number"}` + +#### Scenario: Properties with format, enum, and constraints +- **GIVEN** a property `email` with `{type: "string", format: "email", maxLength: 255}` +- **AND** a property `status` with `{type: "string", enum: ["open", "closed", "pending"]}` +- **THEN** the OpenAPI output MUST preserve `format`, `enum`, `maxLength`, `minLength`, `pattern`, `minimum`, `maximum`, `exclusiveMinimum`, `exclusiveMaximum`, `multipleOf`, `minItems`, `maxItems`, `uniqueItems`, `default`, `const`, `example` + +#### Scenario: Non-array property without type gets default +- **GIVEN** a property definition that is not an array (e.g., a plain string value) +- **WHEN** OAS is generated +- **THEN** the property MUST be rendered as `{type: "string", description: "Property value"}` + +#### Scenario: Internal fields are stripped from output +- **GIVEN** a property definition containing internal keys: `objectConfiguration`, `inversedBy`, `authorization`, `defaultBehavior`, `cascadeDelete` +- **WHEN** OAS is generated +- **THEN** only standard OpenAPI schema keywords (type, format, description, enum, $ref, allOf, etc.) MUST appear in the output +- **AND** all internal/non-OAS keys MUST be removed by the allowed-keywords whitelist + +#### Scenario: System properties _self and id are injected +- **GIVEN** any schema +- **WHEN** OAS is generated +- **THEN** the component schema MUST include: + - `_self`: `{$ref: "#/components/schemas/_self", readOnly: true}` (metadata with uuid, uri, version, register, schema, owner, updated, created) + - `id`: `{type: "string", format: "uuid", readOnly: true}` + +### Requirement: The OpenAPI spec MUST document all CRUD endpoints accurately +Every API endpoint for each register/schema combination MUST be documented with correct HTTP methods, path parameters, query parameters, request bodies, and response schemas. Endpoint generation is handled by `OasService::addCrudPaths()`. + +#### Scenario: Collection endpoint (GET list) +- **GIVEN** schema `meldingen` in register `zaken` +- **THEN** the OpenAPI spec MUST document `GET /objects/zaken/meldingen` with: + - Query parameters: `_extend`, `_filter`, `_unset`, `_search` (collection-specific), plus dynamic filter parameters for each schema property (e.g., `title`, `status`, `count`) + - Response 200: `allOf` composing `PaginatedResponse` with `results` array of `$ref: #/components/schemas/Meldingen` + - Response 400: Error schema for invalid query parameters + - Response 403: Error for RBAC authorization failures (added by `applyRbacToOperation()`) + +#### Scenario: Single resource endpoint (GET by ID) +- **GIVEN** schema `meldingen` +- **THEN** the OpenAPI spec MUST document `GET /objects/zaken/meldingen/{id}` with: + - Path parameter `id` (string, format: uuid, required: true) + - Query parameters: `_extend`, `_filter`, `_unset` + - Response 200: `$ref: #/components/schemas/Meldingen` + - Response 404: Error schema + +#### Scenario: Create endpoint (POST) +- **GIVEN** schema `meldingen` +- **THEN** the OpenAPI spec MUST document `POST /objects/zaken/meldingen` with: + - Request body: `application/json` referencing the schema component + - Response 201: created object with `$ref` to schema component + - Response 400: validation error + - Response 403: RBAC authorization failure + +#### Scenario: Update endpoint (PUT) +- **GIVEN** schema `meldingen` +- **THEN** the OpenAPI spec MUST document `PUT /objects/zaken/meldingen/{id}` with: + - Path parameter `id` (string, format: uuid) + - Request body: `application/json` referencing the schema component + - Response 200: updated object + - Response 404: not found + - Response 403: RBAC authorization failure + +#### Scenario: Delete endpoint (DELETE) +- **GIVEN** schema `meldingen` +- **THEN** the OpenAPI spec MUST document `DELETE /objects/zaken/meldingen/{id}` with: + - Path parameter `id` (string, format: uuid) + - Response 204: no content + - Response 404: not found + - Response 403: RBAC authorization failure + +### Requirement: The spec MUST document authentication and RBAC authorization +The generated spec MUST describe all supported authentication methods and dynamically map Nextcloud group-based RBAC rules to OAuth2 scopes. Implementation: `OasService::extractSchemaGroups()`, `extractGroupFromRule()`, `applyRbacToOperation()`. + +#### Scenario: Security schemes from BaseOas.json +- **THEN** the OpenAPI spec MUST include `components.securitySchemes` with: + - `basicAuth`: `{type: "http", scheme: "basic"}` for Nextcloud username/password + - `oauth2`: authorization code flow with `authorizationUrl: "/apps/oauth2/authorize"`, `tokenUrl: "/apps/oauth2/api/v1/token"`, and dynamically populated scopes + +#### Scenario: RBAC groups mapped to OAuth2 scopes +- **GIVEN** schema `meldingen` with authorization rules: `{create: ["medewerkers"], read: ["public"], update: ["medewerkers"], delete: ["admin"]}` +- **WHEN** OAS is generated +- **THEN** `components.securitySchemes.oauth2.flows.authorizationCode.scopes` MUST include: + - `admin`: `"Full administrative access"` + - `medewerkers`: `"Access for medewerkers group"` + - `public`: `"Public (unauthenticated) access"` + +#### Scenario: RBAC info appended to operation descriptions +- **GIVEN** schema `meldingen` with `create` restricted to group `medewerkers` +- **WHEN** the POST operation is generated +- **THEN** the operation description MUST end with `**Required scopes:** \`admin\`, \`medewerkers\`` +- **AND** a 403 response MUST be added with description `"Forbidden -- user does not have the required group membership for this action"` + +#### Scenario: Property-level authorization groups are extracted +- **GIVEN** a schema property `bsn` with `authorization: {read: ["medewerkers"], update: ["admin"]}` +- **WHEN** OAS scopes are generated +- **THEN** the `medewerkers` and `admin` groups from property-level rules MUST be merged into the global scope list + +### Requirement: The system MUST include example payloads in the generated spec +Each endpoint MUST include example request and response payloads to help developers understand the expected data structures. Examples SHOULD be generated from existing object data when available, falling back to synthetic examples derived from schema property definitions. + +#### Scenario: Example for create endpoint +- **GIVEN** schema `meldingen` with properties: `title` (string, required), `description` (string), `status` (string, enum: ["open", "closed"]) +- **WHEN** OAS is generated +- **THEN** the POST request body MUST include an `example` value like: + ```json + {"title": "Geluidsoverlast", "description": "Overlast na middernacht", "status": "open"} + ``` +- **AND** the 201 response MUST include an example with `_self` metadata (uuid, created, updated) populated + +#### Scenario: Example from existing objects +- **GIVEN** schema `meldingen` has 5 existing objects in the register +- **WHEN** OAS is generated with example generation enabled +- **THEN** the system SHOULD use field values from the first existing object as examples +- **AND** sensitive fields (marked `writeOnly` or with restricted RBAC) MUST be masked or omitted from examples + +#### Scenario: Array and nested object examples +- **GIVEN** a property `tags` with type `array` and items of type `string` +- **AND** a property `address` with type `object` and sub-properties `street`, `city`, `zipcode` +- **THEN** the example MUST include realistic nested values: `tags: ["urgent", "geluid"]`, `address: {street: "Keizersgracht 1", city: "Amsterdam", zipcode: "1015AA"}` + +### Requirement: The system MUST serve a Swagger UI for interactive exploration +An interactive API explorer MUST be available for each register, allowing developers to browse endpoints, view schemas, and execute test requests directly from the browser. + +#### Scenario: Access Swagger UI for a specific register +- **GIVEN** register `zaken` has a generated OpenAPI spec +- **WHEN** a user navigates to `/api/docs/zaken` +- **THEN** a Swagger UI MUST be displayed with: + - All endpoints grouped by schema tag (Meldingen, Vergunningen) + - Try-it-out functionality for authenticated users + - Schema model browser showing all component definitions + - The spec URL pre-configured to `/api/registers/{id}/oas` + +#### Scenario: Access combined Swagger UI for all registers +- **WHEN** a user navigates to `/api/docs` +- **THEN** a Swagger UI MUST be displayed with all registers combined +- **AND** operations MUST be grouped by schema tags + +#### Scenario: Swagger UI authentication pass-through +- **GIVEN** a user is logged into Nextcloud +- **WHEN** they use Swagger UI try-it-out on a protected endpoint +- **THEN** the Nextcloud session cookie MUST be forwarded +- **AND** basic auth credentials MUST be configurable in the Swagger UI authorize dialog + +### Requirement: The OpenAPI spec MUST be downloadable in JSON and YAML formats +The generated specification MUST be available in both JSON and YAML formats to support different toolchains (Swagger Codegen, OpenAPI Generator, Postman, Insomnia). + +#### Scenario: Download as JSON (default) +- **GIVEN** `GET /api/registers/{id}/oas` or `GET /api/registers/{id}/oas?format=json` +- **THEN** the response MUST have `Content-Type: application/json` +- **AND** the body MUST be valid JSON conforming to OpenAPI 3.1.0 + +#### Scenario: Download as YAML +- **GIVEN** `GET /api/registers/{id}/oas?format=yaml` +- **THEN** the response MUST have `Content-Type: application/x-yaml` +- **AND** the body MUST be valid YAML conforming to OpenAPI 3.1.0 +- **AND** the YAML output MUST be semantically identical to the JSON output + +#### Scenario: Content negotiation via Accept header +- **GIVEN** `GET /api/registers/{id}/oas` with header `Accept: application/x-yaml` +- **THEN** the response MUST be in YAML format +- **AND** if `Accept: application/json` or no Accept header, the response MUST be JSON + +### Requirement: The OpenAPI spec MUST be versioned and track schema changes +Spec versions MUST track schema changes to enable API change detection, backwards-compatibility analysis, and changelog generation. The version MUST be derived from the register's version field and schema modification timestamps. + +#### Scenario: Spec version reflects register version +- **GIVEN** register `zaken` has `version = "2.1.0"` +- **WHEN** OAS is generated +- **THEN** `info.version` MUST be `"2.1.0"` + +#### Scenario: Schema change detection via hash +- **GIVEN** the OAS spec was generated with a content hash `abc123` +- **WHEN** a property is added to schema `meldingen` +- **THEN** the next OAS generation MUST produce a different content hash +- **AND** the response SHOULD include an `x-spec-hash` extension field for change detection + +#### Scenario: ETag-based caching for spec consumers +- **GIVEN** a client requests `GET /api/registers/{id}/oas` +- **WHEN** the spec has not changed since the last request +- **THEN** the response SHOULD include an `ETag` header derived from the spec content hash +- **AND** subsequent requests with `If-None-Match` matching the ETag SHOULD return 304 Not Modified + +### Requirement: The spec MUST regenerate in real-time when schemas change +The generated OpenAPI specification MUST always reflect the current state of register and schema definitions. There SHALL be no stale cache serving outdated specs after schema modifications. + +#### Scenario: New property added to schema +- **GIVEN** schema `meldingen` has properties `title` and `status` +- **WHEN** an admin adds property `priority` (type: string, enum: ["low", "medium", "high"]) +- **THEN** the next `GET /api/registers/{id}/oas` MUST include `priority` in the component schema AND as a query filter parameter on the collection endpoint + +#### Scenario: Schema added to register +- **GIVEN** register `zaken` has schema `meldingen` +- **WHEN** schema `klachten` is added to the register +- **THEN** the next OAS generation MUST include full CRUD paths for `klachten` and a new component schema definition + +#### Scenario: Schema removed from register +- **GIVEN** register `zaken` has schemas `meldingen` and `klachten` +- **WHEN** `klachten` is removed from the register +- **THEN** the next OAS generation MUST NOT include paths or component schemas for `klachten` + +### Requirement: The server URL MUST be absolute and instance-specific +The `servers[0].url` field MUST be an absolute URL pointing to the actual Nextcloud instance, not a relative path. This is generated by `IURLGenerator::getAbsoluteURL()`. + +#### Scenario: Server URL uses instance base URL +- **GIVEN** the Nextcloud instance is running at `https://gemeente.example.nl` +- **WHEN** OAS is generated +- **THEN** `servers[0].url` MUST be `https://gemeente.example.nl/apps/openregister/api` +- **AND** `servers[0].description` MUST be `"OpenRegister API Server"` + +#### Scenario: Local development URL +- **GIVEN** the Nextcloud instance is running at `http://localhost:8080` +- **WHEN** OAS is generated +- **THEN** `servers[0].url` MUST be `http://localhost:8080/apps/openregister/api` + +### Requirement: The spec MUST comply with NL API Design Rules markers +For Dutch government deployments, the generated OpenAPI spec MUST include extension fields that mark compliance with the NL API Design Rules (API Designrules, formerly known as the "NLGov API Design Rules" from Forum Standaardisatie). + +#### Scenario: NLGov extension markers present +- **WHEN** OAS is generated for a register with NLGov compliance enabled +- **THEN** the spec MUST include `x-nl-api-design-rules` extension at the root level +- **AND** it MUST declare compliance with applicable rules: + - `API-01`: Operations MUST use standard HTTP methods + - `API-03`: Only standard HTTP status codes SHALL be used + - `API-05`: Document API in OpenAPI 3.x specification + - `API-16`: Use OAS 3.x for documentation + - `API-20`: Include `Content-Type` in response headers + - `API-48`: Leave MSB UUID ordering to client + - `API-51`: Publish OAS at a standard location + +#### Scenario: Pagination follows NL API Design Rules +- **GIVEN** a collection endpoint for schema `meldingen` +- **THEN** the paginated response MUST document `page`, `pages`, `total`, `limit`, `offset` fields conforming to the `API-42` pagination rule + +#### Scenario: Error responses follow NL API problem details +- **GIVEN** an error response (400, 404, 403) +- **THEN** the error schema SHOULD include `type`, `title`, `status`, `detail`, `instance` per RFC 7807 / `API-46` + +### Requirement: Multi-register specs MUST be organized with unique operation IDs and prefixed tags +When generating a combined spec for multiple registers, operations MUST be uniquely identifiable and grouped logically. Implemented via `$useRegisterPrefix` and `pascalCase()` prefixing in `OasService::createOas()`. + +#### Scenario: Two registers with same-named schema +- **GIVEN** register `zaken` has schema `documenten` AND register `archief` has schema `documenten` +- **WHEN** combined OAS is generated via `GET /api/registers/oas` +- **THEN** operationIds MUST be unique: `ZakenGetAllDocumenten` vs `ArchiefGetAllDocumenten` +- **AND** paths MUST be unique: `/objects/zaken/documenten` vs `/objects/archief/documenten` + +#### Scenario: Tags are defined for every schema +- **GIVEN** a register with schemas `Meldingen` and `Vergunningen` +- **WHEN** OAS is generated +- **THEN** the top-level `tags` array MUST contain entries with `name` matching each schema title +- **AND** each tag MUST have a `description` (from schema description or auto-generated) + +#### Scenario: Shared schemas across registers are deduplicated in components +- **GIVEN** registers `zaken` and `burgerzaken` both reference schema ID 5 +- **WHEN** combined OAS is generated +- **THEN** `components.schemas` MUST contain exactly one definition for schema 5 (not duplicated) + +### Requirement: Extended endpoints MUST be controllable via whitelist +The system MUST support extended endpoints (audit-trails, files, lock/unlock) controlled by the `INCLUDED_EXTENDED_ENDPOINTS` constant in `OasService`. Only whitelisted endpoints SHALL appear in the generated spec. + +#### Scenario: No extended endpoints by default +- **GIVEN** `INCLUDED_EXTENDED_ENDPOINTS` is an empty array (current default) +- **WHEN** OAS is generated +- **THEN** only standard CRUD paths (`GET`, `POST`, `PUT`, `DELETE`) SHALL appear +- **AND** audit-trail, file, lock, and unlock endpoints SHALL NOT be present + +#### Scenario: Audit trail endpoint whitelisted +- **GIVEN** `INCLUDED_EXTENDED_ENDPOINTS` contains `"audit-trails"` +- **WHEN** OAS is generated +- **THEN** `GET /objects/{register}/{schema}/{id}/audit-trails` MUST appear with: + - Response 200: array of `AuditTrail` references + - Response 404: not found + +#### Scenario: File endpoints whitelisted +- **GIVEN** `INCLUDED_EXTENDED_ENDPOINTS` contains `"files"` +- **WHEN** OAS is generated +- **THEN** `GET /objects/{register}/{schema}/{id}/files` and `POST /objects/{register}/{schema}/{id}/files` MUST appear +- **AND** the POST endpoint MUST document `multipart/form-data` request body with `file` field of format `binary` + +### Requirement: Schema names MUST be sanitized for OpenAPI compliance +Schema component names MUST match the pattern `^[a-zA-Z0-9._-]+$`. The sanitization is performed by `OasService::sanitizeSchemaName()`. + +#### Scenario: Schema with spaces in title +- **GIVEN** a schema with title `"Module Versie"` +- **WHEN** OAS is generated +- **THEN** the component name MUST be `"Module_Versie"` (spaces replaced with underscores) +- **AND** all `$ref` references MUST use `#/components/schemas/Module_Versie` + +#### Scenario: Schema with special characters +- **GIVEN** a schema with title `"Zaak (type 2) #1"` +- **WHEN** OAS is generated +- **THEN** invalid characters MUST be replaced: `"Zaak_type_2_1"` + +#### Scenario: Schema title starting with number +- **GIVEN** a schema with title `"123test"` +- **WHEN** OAS is generated +- **THEN** the component name MUST be prefixed: `"Schema_123test"` + +#### Scenario: Bare $ref values are normalized +- **GIVEN** a property definition with `"$ref": "vestiging"` (bare name, not a full path) +- **WHEN** `sanitizePropertyDefinition()` processes it +- **THEN** the `$ref` MUST be normalized to `"#/components/schemas/vestiging"` + +### Requirement: Composition keywords MUST be validated and cleaned +The system MUST ensure that composition keywords (`allOf`, `anyOf`, `oneOf`) are valid OpenAPI constructs. Empty arrays, invalid items, and empty `$ref` strings MUST be removed or corrected. + +#### Scenario: Empty allOf array is removed +- **GIVEN** a property with `"allOf": []` +- **WHEN** OAS is generated +- **THEN** the `allOf` key MUST NOT appear in the output + +#### Scenario: Invalid allOf items are filtered +- **GIVEN** a property with `"allOf": [{"$ref": ""}, {"type": "object", "properties": {"name": {"type": "string"}}}]` +- **WHEN** OAS is generated +- **THEN** the empty `$ref` item MUST be removed +- **AND** the valid `type: object` item MUST be preserved + +#### Scenario: Boolean required field is stripped +- **GIVEN** a property with `"required": true` (boolean instead of array) +- **WHEN** OAS is generated +- **THEN** the `required` field MUST be removed (OpenAPI requires `required` to be an array of property names at the object level) + +#### Scenario: Invalid type is corrected +- **GIVEN** a property with `"type": "datetime"` (not a valid OpenAPI type) +- **WHEN** OAS is generated +- **THEN** the type MUST be corrected to `"string"` + +### Requirement: API descriptions MUST support i18n +The generated OpenAPI spec MUST support internationalized descriptions for endpoints, parameters, and schema properties to serve multilingual developer communities (minimum: Dutch and English). + +#### Scenario: Default language is English +- **GIVEN** no language preference is specified +- **WHEN** OAS is generated +- **THEN** all summaries, descriptions, and parameter descriptions MUST be in English + +#### Scenario: Dutch language requested +- **GIVEN** `GET /api/registers/{id}/oas?lang=nl` or `Accept-Language: nl` +- **WHEN** OAS is generated +- **THEN** all auto-generated descriptions MUST be in Dutch: + - `"Haal alle {schema} objecten op"` instead of `"Get all {schema} objects"` + - `"Maak een nieuw {schema} object aan"` instead of `"Create a new {schema} object"` + +#### Scenario: Schema-defined descriptions preserved as-is +- **GIVEN** a schema with `description: "Register voor het opslaan van meldingen"` +- **WHEN** OAS is generated in any language +- **THEN** the schema's own description MUST be preserved verbatim (not translated) + +## Current Implementation Status +- **Fully implemented -- OAS generation from schemas**: `OasService` (`lib/Service/OasService.php`) generates OpenAPI specs from register/schema definitions via `createOas()`. It maps schema properties to OpenAPI types, generates paths for CRUD operations, and handles multi-register generation with operationId prefixing. +- **Fully implemented -- controller and endpoints**: `OasController` (`lib/Controller/OasController.php`) exposes endpoints at `/api/registers/{id}/oas` (single register) and `/api/registers/oas` (all registers). Both are annotated `@PublicPage` and `@NoCSRFRequired` for unauthenticated access. `RegistersController` also provides OAS access and GitHub publishing of generated specs. +- **Fully implemented -- base template**: `BaseOas.json` (`lib/Service/Resources/BaseOas.json`) provides the foundation with `openapi: "3.1.0"`, `info`, `servers`, `securitySchemes` (Basic Auth and OAuth2), common schema components (Error, PaginatedResponse, _self). +- **Fully implemented -- authentication documentation**: The base template includes `securitySchemes` for Basic Auth and OAuth2. RBAC groups from schema authorization rules (both schema-level and property-level) are dynamically mapped to OAuth2 scopes via `extractSchemaGroups()` and `extractGroupFromRule()`. Operations include 403 responses with RBAC scope requirements in descriptions. +- **Fully implemented -- schema property sanitization**: `sanitizePropertyDefinition()` strips internal fields, validates types, cleans composition keywords (allOf/anyOf/oneOf), normalizes bare `$ref` values, enforces array items on array types, and falls back to `type: "string"` for unknown types. +- **Fully implemented -- schema name sanitization**: `sanitizeSchemaName()` replaces invalid characters, removes consecutive underscores, handles number-prefixed names, and falls back to `"UnknownSchema"`. +- **Fully implemented -- OAS integrity validation**: `validateOasIntegrity()` recursively validates `$ref` references and `allOf` constructs in both component schemas and path response schemas. +- **Fully implemented -- dynamic query parameters**: `createCommonQueryParameters()` generates `_extend`, `_filter`, `_unset`, `_search` (collection-only), plus dynamic filter parameters derived from each schema's property definitions. +- **Fully implemented -- extended endpoint whitelist**: `INCLUDED_EXTENDED_ENDPOINTS` constant controls which extended endpoints (audit-trails, files, lock, unlock) appear in the generated spec. Currently all are excluded by default. +- **Fully implemented -- server URL from Nextcloud**: `IURLGenerator::getAbsoluteURL()` generates the absolute server URL pointing to the actual Nextcloud instance. +- **Fully implemented -- GitHub publishing**: `RegistersController::publishToGitHub()` generates OAS via `OasService::createOas()` and publishes the JSON to a configurable GitHub repository, branch, and path. +- **Not implemented -- Swagger UI**: No interactive Swagger UI endpoint exists. The OAS is generated as JSON but not served with an interactive explorer. +- **Not implemented -- YAML format**: Only JSON output is supported; YAML export is not implemented. +- **Not implemented -- spec versioning/hashing**: No content hash, ETag, or version tracking tied to schema changes exists. +- **Not implemented -- example payloads**: The generated OAS does not include example request/response bodies for endpoints (though individual properties may carry `example` from schema definitions). +- **Not implemented -- NL API Design Rules markers**: No `x-nl-api-design-rules` extension or RFC 7807 problem details schema. +- **Not implemented -- i18n of API descriptions**: All descriptions are English-only; no language parameter or Accept-Language support. + +## Standards & References +- OpenAPI Specification 3.1.0 (https://spec.openapis.org/oas/v3.1.0) +- JSON Schema Draft 2020-12 (referenced by OAS 3.1.0 for schema validation) +- Swagger UI (https://swagger.io/tools/swagger-ui/) for interactive API exploration +- OAuth 2.0 Authorization Code Flow (RFC 6749) for security scheme definitions +- NL API Design Rules (https://docs.geostandaarden.nl/api/API-Designrules/) for Dutch government API compliance +- RFC 7807 Problem Details for HTTP APIs (for standardized error responses) +- Redocly CLI (https://redocly.com/docs/cli/) for OAS validation (see `oas-validation` spec) + +## Cross-References +- **oas-validation**: Validates that the generated OAS output passes `redocly lint` with zero errors. Covers `$ref` resolution, composition cleanup, server URL absoluteness, operationId uniqueness, and tag integrity. This spec focuses on generation features; `oas-validation` focuses on output correctness. +- **mcp-discovery**: The MCP discovery endpoint (`/api/mcp/v1/discover`) provides a complementary API discovery mechanism optimized for AI agents. The OpenAPI spec serves human developers and code generation tools; MCP discovery serves LLM-based integrations. +- **api-test-coverage**: (referenced in `unit-test-coverage` spec) Test coverage for the OAS generation endpoints should verify that generated specs are valid and complete. +- **auth-system**: The RBAC authorization model documented in the auth-system spec drives the OAuth2 scope generation in OAS output. + +## Specificity Assessment +- **Highly specific and implementable**: The spec provides 14 requirements with 40+ scenarios covering all aspects of OAS generation: auto-generation, property mapping, CRUD documentation, authentication, examples, Swagger UI, YAML export, versioning, real-time regeneration, server URLs, NLGov compliance, multi-register organization, extended endpoints, schema name sanitization, composition validation, and i18n. +- **Grounded in implementation**: Requirements reference specific classes (`OasService`, `OasController`, `RegistersController`), methods (`createOas()`, `sanitizePropertyDefinition()`, `extractSchemaGroups()`), and files (`BaseOas.json`, `routes.php`). +- **Competitor-informed**: Strapi's dual-purpose Zod validation + spec generation pattern, Directus's auto-generated REST API per collection, and NocoDB's per-base Swagger endpoint informed the feature scope. +- **Clear separation from oas-validation**: This spec covers generation features; `oas-validation` covers output correctness. No overlap. + +## Nextcloud Integration Analysis + +**Status**: Partially implemented (core generation pipeline is production-ready; Swagger UI, YAML, versioning, examples, NLGov markers, and i18n are not yet implemented) + +**Existing Implementation**: `OasService::createOas()` generates OpenAPI 3.1.0 specs from register/schema definitions using `RegisterMapper` and `SchemaMapper`. The service reads from `BaseOas.json`, populates paths via `addCrudPaths()` and `addExtendedPaths()`, maps properties via `sanitizePropertyDefinition()`, extracts RBAC groups to OAuth2 scopes, and validates integrity via `validateOasIntegrity()`. `OasController` serves the generated spec at two routes (`/api/registers/{id}/oas` for single register, `/api/registers/oas` for all registers), both as `@PublicPage` endpoints. `RegistersController::publishToGitHub()` enables publishing generated OAS to GitHub repositories. + +**Nextcloud Core Integration**: The auto-generation pipeline is tightly integrated with Nextcloud's infrastructure. Register and schema metadata stored in Nextcloud's database (via `OCP\AppFramework\Db\Entity` mappers) drives the generation. Server URLs are derived from `IURLGenerator::getAbsoluteURL()`. The security schemes include Nextcloud-native Basic Auth and OAuth2 with scopes derived from Nextcloud group memberships. Routes are registered via `appinfo/routes.php` using Nextcloud's standard routing system. The generated spec is compatible with Nextcloud's own OpenAPI tooling initiative (attribute annotations on controllers). + +**Recommendation**: The core generation pipeline is production-ready. Priority enhancements: (1) Swagger UI -- bundle a static HTML page using swagger-ui-dist that loads the generated JSON; serve at `/api/docs/{register}`. (2) YAML format -- use Symfony's YAML component (already a Nextcloud dependency) for JSON-to-YAML conversion. (3) Example payloads -- generate from schema defaults and existing object data via `ObjectMapper::findAll()`. (4) NLGov markers -- add `x-nl-api-design-rules` extension and RFC 7807 error schema. (5) i18n -- leverage Nextcloud's `IL10N` service for auto-generated descriptions. (6) Versioning -- compute SHA-256 hash of generated spec for ETag support. diff --git a/openspec/changes/opt-in-files-extend/specs/files-render-extension/spec.md b/openspec/changes/opt-in-files-extend/specs/files-render-extension/spec.md new file mode 100644 index 000000000000..bacf62b11fc5 --- /dev/null +++ b/openspec/changes/opt-in-files-extend/specs/files-render-extension/spec.md @@ -0,0 +1,169 @@ +--- +status: draft +--- +# Files Render Extension + +## Purpose + +Define the contract for when and how `@self.files` appears on rendered objects across all OpenRegister consumers. The contract is symmetric across show and list endpoints, defaults to a cheap representation (file IDs only), and exposes full file metadata only when explicitly requested via the existing `_extend` mechanism. This eliminates today's asymmetry where show endpoints unconditionally pay the full file-lookup cost while list endpoints emit no `@self.files` field at all. + +## Current State + +- `RenderObject::renderEntity` (`lib/Service/Object/RenderObject.php:908`) unconditionally calls `$this->renderFiles($entity)` on every render, attaching full formatted file metadata (id, path, title, accessUrl, downloadUrl, type, extension, size, hash, published, modified, labels) to `@self.files`. +- `renderFiles()` issues at least one `FileMapper::getFilesForObject` query and one `SystemTagMapper::getTagIdsForObjects` query per object — paid on every show response, regardless of whether the consumer needs files. +- List endpoints (`PublicationsController::index`, `ObjectService::searchObjectsPaginated`, etc.) bypass `renderEntity` and emit no `@self.files` field at all. +- `RenderObject::renderEntity` already supports a `_extend` parameter and a `normalizeMap` (line 1015) that maps shorthand `_x` extension keys to canonical `@self.x` paths. Currently only `_schema` ⇄ `@self.schema` and `_register` ⇄ `@self.register` are normalized. +- `ObjectEntity::getObjectArray()` (`lib/Db/ObjectEntity.php:748`) emits the entity's `files` property under `@self.files` when serialized. + +## ADDED Requirements + +### Requirement: `@self.files` SHALL be present on every rendered object + +Every JSON-rendered object that goes through OpenRegister's render pipeline (whether produced by show endpoints, list endpoints, or any other render path) SHALL include an `@self.files` field. The field SHALL be an array. An object that has no files SHALL emit `@self.files: []`. + +#### Scenario: Object with no files on a show endpoint +- **GIVEN** an object with zero attached files +- **WHEN** a consumer requests the object via a show endpoint without any extend parameters +- **THEN** the response SHALL include `@self.files: []` (empty array, not absent, not null) + +#### Scenario: Object with no files on a list endpoint +- **GIVEN** a paginated list response that includes an object with zero attached files +- **WHEN** a consumer requests the list without any extend parameters +- **THEN** the result row's `@self.files` SHALL be `[]` + +#### Scenario: Object with files but no extend +- **GIVEN** an object with N attached files +- **WHEN** a consumer requests the object without `_extend[]=@self.files` and without `_extend[]=_files` +- **THEN** `@self.files` SHALL be a JSON array of N integers, each integer being a file ID + +### Requirement: Default `@self.files` SHALL be a list of file IDs only + +When no extend parameter covers `@self.files`, the field SHALL contain integer file IDs only — no objects, no paths, no URLs, no metadata. The order of IDs is unspecified but SHALL be stable across repeat calls within the same render context. + +#### Scenario: Default shape on show endpoint +- **GIVEN** an object with three attached files (IDs 123, 456, 789) +- **WHEN** the consumer requests the object via a show endpoint with no extend parameter +- **THEN** `@self.files` SHALL equal `[123, 456, 789]` (or any stable permutation thereof) and contain only integers + +#### Scenario: Default shape on list endpoint +- **GIVEN** a paginated list of 30 objects, each with attached files +- **WHEN** the consumer requests the list with no extend parameter +- **THEN** every result row's `@self.files` SHALL be an array of integer file IDs +- **AND** the file-ID lookup for the entire page SHALL be served by a single batched query (no N+1 over the page) + +### Requirement: `_extend[]=@self.files` SHALL produce full file metadata + +When the request's `_extend` parameter (after normalization) contains `@self.files`, the rendered `@self.files` SHALL contain fully-formatted file objects identical to today's `RenderObject::renderFiles()` output. + +#### Scenario: Show endpoint with extend +- **GIVEN** an object with one attached file +- **WHEN** the consumer requests the object with `?_extend[]=@self.files` +- **THEN** `@self.files` SHALL be an array of one object +- **AND** the object SHALL include the keys `id`, `path`, `title`, `accessUrl`, `downloadUrl`, `type`, `extension`, `size`, `hash`, `published`, `modified`, `labels` + +#### Scenario: List endpoint with extend +- **GIVEN** a paginated list response +- **WHEN** the consumer requests the list with `?_extend[]=@self.files` +- **THEN** every result row's `@self.files` SHALL contain fully-formatted file objects with the same keys as the show endpoint's full form + +### Requirement: `_extend[]=_files` SHALL be equivalent to `_extend[]=@self.files` + +The shorthand `_files` SHALL be treated as an alias for `@self.files` via the existing `normalizeMap` mechanism in `RenderObject::renderEntity`. Both spellings SHALL produce identical responses given identical other parameters. + +#### Scenario: Shorthand and dotted form are equivalent +- **GIVEN** the same object on the same endpoint +- **WHEN** one consumer requests it with `?_extend[]=@self.files` and another with `?_extend[]=_files` +- **THEN** both responses SHALL have identical `@self.files` content (same set of file objects, same keys, same values) + +#### Scenario: Mixed extend parameters +- **WHEN** a consumer requests `?_extend[]=_files&_extend[]=@self.schema` +- **THEN** the response SHALL include full file metadata at `@self.files` AND the resolved schema object at `@self.schema` + +### Requirement: Default-shape lookup MUST use a batched file-ID query + +The implementation of the lightweight default SHALL use a single batched lookup to retrieve file IDs for any number of objects in a render call. A new method `FileMapper::getFileIdsForObjects(array $uuids): array` (or equivalent) SHALL serve this lookup in one query. + +#### Scenario: List page with N objects produces one file-ID query +- **GIVEN** a list endpoint returning a page of 50 objects +- **WHEN** the consumer requests the list with no extend parameter +- **THEN** the implementation SHALL issue exactly ONE database query to retrieve file IDs for all 50 objects (regardless of how many files each object has) +- **AND** SHALL NOT issue per-object queries for the lightweight default + +#### Scenario: Show endpoint with no extend produces one file-ID query +- **GIVEN** a show endpoint +- **WHEN** the consumer requests the object with no extend parameter +- **THEN** the implementation SHALL issue exactly ONE database query for the file IDs of that single object +- **AND** SHALL NOT issue the SystemTag queries that the full-metadata path requires + +### Requirement: `RenderObject::renderFiles()` MUST run only when `@self.files` is in extend + +The call to `RenderObject::renderFiles()` at `lib/Service/Object/RenderObject.php:908` SHALL be gated on whether the normalized `_extend` array contains `@self.files`. The body of `renderFiles()` SHALL NOT be modified by this change. + +#### Scenario: renderFiles is skipped without extend +- **WHEN** `renderEntity` is invoked with an empty or absent `_extend` +- **THEN** `renderFiles()` SHALL NOT be invoked +- **AND** the rendered object's `@self.files` SHALL be the lightweight ID-only form + +#### Scenario: renderFiles runs only with extend +- **WHEN** `renderEntity` is invoked with `_extend` containing (after normalization) `@self.files` +- **THEN** `renderFiles()` SHALL be invoked +- **AND** the rendered object's `@self.files` SHALL contain full file metadata objects + +### Requirement: Performance contract for list-with-extend SHALL be documented as discouraged + +When a list endpoint is requested with `_extend[]=@self.files` (or `_files`), the implementation SHALL render full file metadata for every row. This causes per-row file lookups (N+1 over the page). This usage SHALL be loudly documented as discouraged because of degraded performance. + +#### Scenario: Documentation calls out the perf cost +- **WHEN** a developer reads the OpenRegister API documentation for `_extend[]=@self.files` +- **THEN** the documentation SHALL state that using this extension on list endpoints is heavily discouraged and will result in degraded performance + +#### Scenario: List with extend still works correctly +- **GIVEN** a list endpoint and `?_extend[]=@self.files` +- **WHEN** the consumer makes the request +- **THEN** every row's `@self.files` SHALL contain full file metadata (correctness preserved despite perf cost) + +### Requirement: This contract SHALL apply uniformly across all render-output endpoints + +The behavior described above is a property of OpenRegister's render pipeline, not of any individual consumer. Any consumer that produces JSON output via `RenderObject::renderEntity` or `ObjectService::searchObjectsPaginated` SHALL inherit this contract automatically without consumer-side code changes. + +#### Scenario: opencatalogi PublicationsController::show inherits the contract +- **GIVEN** opencatalogi's `PublicationsController::show` (which calls `ObjectService::renderEntity`) +- **WHEN** the show endpoint is requested without extend +- **THEN** the response's `@self.files` SHALL be a list of file IDs +- **AND** opencatalogi requires no code changes to receive this behavior + +#### Scenario: opencatalogi PublicationsController::index inherits the contract +- **GIVEN** opencatalogi's `PublicationsController::index` (which calls `ObjectService::searchObjectsPaginated`) +- **WHEN** the list endpoint is requested without extend +- **THEN** every result row's `@self.files` SHALL be a list of file IDs +- **AND** opencatalogi requires no code changes to receive this behavior + +### Requirement: This change SHALL be flagged as a BREAKING change for show consumers + +Any consumer that today reads the full file-metadata object structure on a show response without specifying `_extend` SHALL receive integers instead of objects after this change. This MUST be documented prominently. + +#### Scenario: CHANGELOG entry +- **WHEN** the openregister CHANGELOG is updated for this release +- **THEN** the entry SHALL clearly state: `@self.files` no longer contains full file metadata by default. Add `_extend[]=@self.files` (or `_extend[]=_files`) to opt in. + +#### Scenario: opencatalogi documentation updated +- **WHEN** the opencatalogi public-facing documentation for `/publications/{catalogSlug}/{id}` and `/publications/{catalogSlug}` is updated +- **THEN** the documentation SHALL describe the new default (file IDs), the opt-in syntax (both `_extend[]=@self.files` and `_extend[]=_files`), and the perf warning for list+extend +- **AND** opencatalogi code SHALL NOT require modification (docs-only change) + +### Requirement: Out-of-scope behaviors SHALL remain untouched + +This change SHALL NOT modify the behavior of related but separate file-handling mechanisms: + +- `RenderObject::renderFileProperties` (`lib/Service/Object/RenderObject.php:911`) — schema-property file hydration that replaces file IDs with file objects inside object data when a schema property is typed `file`. This is a different mechanism with a different location in the JSON. +- Any dedicated attachments endpoint such as `PublicationsController::attachments()` in opencatalogi. + +#### Scenario: renderFileProperties continues to hydrate file properties +- **GIVEN** an object whose schema declares a property of type `file` +- **WHEN** `renderEntity` is invoked (with or without extend) +- **THEN** `renderFileProperties` SHALL still replace file IDs in that property with full file objects, exactly as today + +#### Scenario: PublicationsController::attachments unchanged +- **GIVEN** a request to opencatalogi's `attachments` endpoint +- **WHEN** the endpoint runs +- **THEN** it SHALL return the same response shape it returns today, unaffected by this change diff --git a/openspec/changes/production-observability/specs/production-observability/spec.md b/openspec/changes/production-observability/specs/production-observability/spec.md new file mode 100644 index 000000000000..2cd3b4f7e7c7 --- /dev/null +++ b/openspec/changes/production-observability/specs/production-observability/spec.md @@ -0,0 +1,374 @@ +--- +status: implemented +--- + +# Production Observability + +## Purpose +Provide production-grade observability for OpenRegister deployments through Prometheus metrics, structured logging, health/readiness endpoints, and audit-compliant monitoring. This capability enables operations teams to monitor application health, track SLA compliance, detect anomalies in real-time, and satisfy BIO (Baseline Informatiebeveiliging Overheid) audit logging requirements for Dutch government deployments. + +## Requirements + +### Requirement: Prometheus Metrics Endpoint +The system SHALL expose a dedicated metrics endpoint that returns all application metrics in Prometheus text exposition format (version 0.0.4). The endpoint MUST be served at `GET /index.php/apps/openregister/api/metrics` and MUST return the `Content-Type: text/plain; version=0.0.4; charset=utf-8` header. The `MetricsController` (`lib/Controller/MetricsController.php`) already implements this endpoint with basic gauge metrics; this requirement extends it with counters, histograms, and richer labels. + +#### Scenario: Prometheus scrapes metrics endpoint +- **GIVEN** Prometheus is configured to scrape `/index.php/apps/openregister/api/metrics` every 15 seconds +- **WHEN** Prometheus sends a GET request to the metrics endpoint +- **THEN** the response MUST return HTTP 200 with `Content-Type: text/plain; version=0.0.4; charset=utf-8` +- **AND** the response body MUST contain valid Prometheus exposition format with `# HELP`, `# TYPE`, and metric lines + +#### Scenario: Metrics endpoint requires admin authentication by default +- **GIVEN** a non-admin user requests the metrics endpoint +- **WHEN** the request is processed by the Nextcloud controller framework +- **THEN** the response MUST return HTTP 401 or HTTP 403 +- **AND** no metric data SHALL be exposed to unauthorized users + +#### Scenario: Metrics endpoint supports token-based authentication for scrapers +- **GIVEN** an admin has configured a metrics API token in app settings (`metrics_api_token`) +- **WHEN** a request includes the header `Authorization: Bearer ` +- **THEN** the metrics endpoint MUST return metrics without requiring a Nextcloud session +- **AND** requests with invalid tokens MUST receive HTTP 403 + +#### Scenario: IP-restricted unauthenticated access +- **GIVEN** an admin has configured `metrics_allowed_ips` to `10.0.0.0/8,172.16.0.0/12` +- **WHEN** a request from IP `10.0.1.50` reaches the metrics endpoint without authentication +- **THEN** the endpoint MUST return metrics (using `@PublicPage` annotation) +- **AND** requests from IP `203.0.113.5` without authentication MUST receive HTTP 403 + +### Requirement: Standard Application Metrics +Every OpenRegister deployment MUST expose a baseline set of metrics that are consistent across all Conduction apps (`opencatalogi`, `pipelinq`, `procest`). These metrics use the `openregister_` prefix and follow the naming conventions defined in the shared Prometheus metrics spec pattern. + +#### Scenario: Application info gauge +- **GIVEN** OpenRegister version 1.5.0 is running on PHP 8.2.15 with Nextcloud 29.0.1 +- **WHEN** the metrics endpoint is scraped +- **THEN** the response MUST include: + - `openregister_info{version="1.5.0",php_version="8.2.15",nextcloud_version="29.0.1"} 1` + +#### Scenario: Application health gauge reflects degraded state +- **GIVEN** the search backend (Solr/Elasticsearch) is unreachable but the database is healthy +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_up` MUST be `0` (not `1`) +- **AND** the health check detail MUST be queryable via the `/api/health` endpoint + +#### Scenario: HTTP request counter with labels +- **GIVEN** 50 GET requests to `/api/objects` returned HTTP 200 and 3 POST requests returned HTTP 422 +- **WHEN** the metrics endpoint is scraped +- **THEN** the response MUST include: + - `openregister_requests_total{method="GET",endpoint="/api/objects",status="200"} 50` + - `openregister_requests_total{method="POST",endpoint="/api/objects",status="422"} 3` + +#### Scenario: Request duration histogram with standard buckets +- **GIVEN** API requests have been processed with varying latencies +- **WHEN** the metrics endpoint is scraped +- **THEN** the response MUST include histogram buckets at: 0.01, 0.05, 0.1, 0.25, 0.5, 1.0, 2.5, 5.0, 10.0 seconds +- **AND** each bucket MUST carry `method` and `endpoint` labels + - e.g., `openregister_request_duration_seconds_bucket{method="GET",endpoint="/api/objects",le="0.1"} 42` + +#### Scenario: Error counter by type +- **GIVEN** 2 database errors and 5 validation errors have occurred +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_errors_total{type="database"} 2` and `openregister_errors_total{type="validation"} 5` + +### Requirement: Register, Schema, and Object Count Metrics +The system MUST expose gauge metrics for the total number of registers, schemas, and objects. Object counts MUST be labeled by register and schema to enable per-domain monitoring. The existing `MetricsController.getObjectCountsByRegisterAndSchema()` provides the foundation for this; the requirement formalizes the metric names and label structure. + +#### Scenario: Register and schema totals +- **GIVEN** the deployment contains 3 registers and 12 schemas +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_registers_total 3` and `openregister_schemas_total 12` + +#### Scenario: Object counts by register and schema +- **GIVEN** register "zaken" contains 500 "meldingen" and 200 "vergunningen" objects +- **WHEN** the metrics endpoint is scraped +- **THEN** the response MUST include: + - `openregister_objects_total{register="zaken",schema="meldingen"} 500` + - `openregister_objects_total{register="zaken",schema="vergunningen"} 200` + +#### Scenario: Object counts update after CRUD operations +- **GIVEN** `openregister_objects_total{register="zaken",schema="meldingen"}` is 500 +- **WHEN** 10 objects are created, 2 are deleted, and the metrics endpoint is scraped +- **THEN** the gauge MUST report 508 + +### Requirement: CRUD Operation Counters +The system MUST maintain monotonic counters for create, update, and delete operations on objects. These counters SHALL be labeled with `register` and `schema` to enable per-domain throughput analysis. Counters MUST persist across PHP request boundaries using the `openregister_metrics` database table (already used by `MetricsService`). + +#### Scenario: Object creation counter increments +- **GIVEN** 10 objects have been created in schema "meldingen" of register "zaken" +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_objects_created_total{register="zaken",schema="meldingen"} 10` + +#### Scenario: Object update and delete counters +- **GIVEN** 5 objects were updated and 2 deleted in schema "meldingen" +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_objects_updated_total{register="zaken",schema="meldingen"} 5` +- **AND** `openregister_objects_deleted_total{register="zaken",schema="meldingen"} 2` + +#### Scenario: Counter survives PHP process restarts +- **GIVEN** the counter was at 100 before Apache was restarted +- **WHEN** Apache restarts and the metrics endpoint is scraped +- **THEN** the counter MUST still report at least 100 (counters stored in database, not APCu) + +### Requirement: Search Performance Metrics +The system MUST expose metrics for search operations across all three search modes: keyword, semantic, and hybrid. The existing `MetricsService.getSearchLatencyStats()` already tracks per-type latency in the `openregister_metrics` table; this requirement extends it to Prometheus exposition format with histogram buckets. + +#### Scenario: Search request counter by type +- **GIVEN** 100 keyword searches, 30 semantic searches, and 20 hybrid searches have been performed +- **WHEN** the metrics endpoint is scraped +- **THEN** the response MUST include: + - `openregister_search_requests_total{type="keyword"} 100` + - `openregister_search_requests_total{type="semantic"} 30` + - `openregister_search_requests_total{type="hybrid"} 20` + +#### Scenario: Search latency histogram +- **GIVEN** semantic searches have latencies ranging from 50ms to 2000ms +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_search_duration_seconds` histogram MUST be present with `type` label +- **AND** bucket boundaries at 0.05, 0.1, 0.25, 0.5, 1.0, 2.5, 5.0 seconds + +#### Scenario: Embedding generation metrics +- **GIVEN** the `MetricsService` has recorded 500 successful and 12 failed embedding generations +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_embeddings_generated_total{status="success"} 500` +- **AND** `openregister_embeddings_generated_total{status="failure"} 12` + +### Requirement: Webhook Delivery Monitoring +The system MUST expose metrics for webhook delivery status, success rates, and retry counts. The `WebhookLog` entity (`lib/Db/WebhookLog.php`) and `WebhookDeliveryJob` (`lib/BackgroundJob/WebhookDeliveryJob.php`) already track delivery attempts; these MUST be surfaced as Prometheus metrics. + +#### Scenario: Webhook delivery counters +- **GIVEN** webhook "zaak-created" has delivered 95 successful and 5 failed notifications +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_webhook_deliveries_total{webhook="zaak-created",status="success"} 95` +- **AND** `openregister_webhook_deliveries_total{webhook="zaak-created",status="failure"} 5` + +#### Scenario: Webhook retry queue depth +- **GIVEN** 3 webhook deliveries are pending retry via `WebhookRetryJob` +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_webhook_retry_queue_depth 3` + +#### Scenario: Webhook delivery latency +- **GIVEN** webhook deliveries have varying response times +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_webhook_delivery_duration_seconds` histogram MUST be present +- **AND** bucket boundaries at 0.1, 0.25, 0.5, 1.0, 2.5, 5.0, 10.0, 30.0 seconds + +### Requirement: Health Check Endpoint +The system MUST expose a JSON health check endpoint at `GET /index.php/apps/openregister/api/health` that reports the status of all critical subsystems. The existing `HealthController` (`lib/Controller/HealthController.php`) checks database and filesystem; this requirement extends it with search backend, webhook connectivity, and migration status checks. + +#### Scenario: All checks pass +- **GIVEN** the database is accessible, filesystem is writable, and the search backend is reachable +- **WHEN** `GET /api/health` is requested +- **THEN** HTTP 200 with `{"status": "ok", "version": "1.5.0", "checks": {"database": "ok", "filesystem": "ok", "search_backend": "ok", "webhooks": "ok"}}` + +#### Scenario: Database failure produces error status +- **GIVEN** the database connection has been lost +- **WHEN** `GET /api/health` is requested +- **THEN** HTTP 503 with `{"status": "error", "checks": {"database": "failed: Connection refused"}}` + +#### Scenario: Search backend unreachable produces degraded status +- **GIVEN** the Solr/Elasticsearch backend is unreachable but the database is healthy +- **WHEN** `GET /api/health` is requested +- **THEN** HTTP 200 with `{"status": "degraded", "checks": {"database": "ok", "search_backend": "unreachable"}}` +- **AND** `openregister_up` gauge MUST be set to 0 + +#### Scenario: Health check is usable by container orchestrators +- **GIVEN** a Kubernetes or Docker deployment with liveness probes configured +- **WHEN** the orchestrator sends `GET /api/health` at regular intervals +- **THEN** HTTP 200 indicates the container is healthy; HTTP 503 triggers a restart + +### Requirement: Readiness Endpoint +The system MUST expose a readiness endpoint at `GET /index.php/apps/openregister/api/ready` that indicates whether the application is fully initialized and ready to serve traffic. This is distinct from the health endpoint: readiness checks whether migrations have completed and all required services are initialized. + +#### Scenario: Application not yet ready during startup +- **GIVEN** the application is starting and database migrations are still running +- **WHEN** `GET /api/ready` is requested +- **THEN** HTTP 503 with `{"ready": false, "reason": "migrations_pending"}` + +#### Scenario: Application becomes ready after initialization +- **GIVEN** all migrations have completed and services are initialized +- **WHEN** `GET /api/ready` is requested +- **THEN** HTTP 200 with `{"ready": true}` + +#### Scenario: Readiness used as Kubernetes readiness probe +- **GIVEN** Kubernetes is configured with `readinessProbe` pointing to `/api/ready` +- **WHEN** the pod starts and migrations are still running +- **THEN** the pod SHALL NOT receive traffic until `/api/ready` returns HTTP 200 + +### Requirement: Structured Logging +All log entries for API operations and errors MUST be structured with consistent fields to enable integration with log aggregation systems (ELK Stack, Loki, Graylog). The existing `LoggerInterface` usage throughout the codebase (via `Psr\Log\LoggerInterface`) provides the foundation; this requirement specifies the required context fields. + +#### Scenario: Structured log for API request +- **GIVEN** an authenticated user sends a POST request to create an object +- **WHEN** the request is processed +- **THEN** the log entry MUST include context fields: `request_id` (unique per request), `user`, `method`, `path`, `status_code`, `duration_ms`, `register`, `schema` + +#### Scenario: Structured log for error with stack trace +- **GIVEN** a database connection failure occurs during object creation +- **WHEN** the error is logged +- **THEN** the log entry MUST include: `level: error`, `error_type` (exception class), `error_message`, `stack_trace`, `context` (register, schema, action) + +#### Scenario: Request correlation across log entries +- **GIVEN** a single API request triggers multiple internal operations (validation, save, audit, webhook) +- **WHEN** each operation logs a message +- **THEN** all log entries MUST share the same `request_id` for correlation + +#### Scenario: Sensitive data exclusion from logs +- **GIVEN** an object contains BSN (Burger Service Nummer) or other PII fields +- **WHEN** the object is logged for debugging +- **THEN** PII fields MUST be redacted or excluded from the log entry +- **AND** only the object UUID, register, and schema SHALL be logged + +### Requirement: BIO2 Audit Logging Compliance +The system MUST satisfy BIO (Baseline Informatiebeveiliging Overheid) audit logging requirements for Dutch government deployments. The existing `AuditTrail` entity (`lib/Db/AuditTrail.php`) and `AuditHandler` (`lib/Service/Object/AuditHandler.php`) track object-level changes; this requirement ensures completeness for BIO2 compliance. + +#### Scenario: Every data mutation is audit-logged +- **GIVEN** a user creates, updates, or deletes an object +- **WHEN** the operation completes +- **THEN** an `AuditTrail` record MUST be created with: `user`, `userName`, `action`, `object`, `register`, `schema`, `changed` (diff), `ipAddress`, `session`, `created` timestamp + +#### Scenario: Audit trail is immutable +- **GIVEN** an audit trail entry exists for a previous operation +- **WHEN** any user (including admin) attempts to modify the entry via API +- **THEN** the modification MUST be rejected with HTTP 403 +- **AND** audit trail entries SHALL only be deletable through the explicit `LogService.deleteLog()` method with admin authorization + +#### Scenario: Audit trail export for compliance review +- **GIVEN** a compliance officer needs to review all operations on register "zaken" for the past quarter +- **WHEN** the officer requests an export via `LogService.exportLogs()` with date and register filters +- **THEN** the system MUST return a complete export in CSV, JSON, or XML format containing all required BIO2 fields + +#### Scenario: Audit log retention policy +- **GIVEN** `MetricsService.cleanOldMetrics()` implements a 90-day default retention +- **WHEN** the retention cleanup runs +- **THEN** operational metrics older than the retention period MUST be deleted +- **AND** audit trail entries MUST NOT be deleted by the metrics cleanup (separate retention per BIO requirements) + +### Requirement: Database Connection Monitoring +The system MUST expose metrics about database connection health, query performance, and connection pool utilization. Since OpenRegister relies on Nextcloud's `IDBConnection` abstraction, these metrics SHALL be derived from query timing within the application layer. + +#### Scenario: Database query duration tracking +- **GIVEN** the system executes database queries for object retrieval +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_db_query_duration_seconds` histogram MUST be present with `operation` label (select, insert, update, delete) + +#### Scenario: Database connection health +- **GIVEN** the `HealthController.checkDatabase()` runs a simple query to verify connectivity +- **WHEN** the query takes longer than 5 seconds or fails +- **THEN** `openregister_db_connection_healthy` gauge MUST be set to 0 +- **AND** the health endpoint MUST report database status as "degraded" or "failed" + +#### Scenario: Slow query detection +- **GIVEN** a database query exceeds the configured slow query threshold (default: 1 second) +- **WHEN** the query completes +- **THEN** `openregister_db_slow_queries_total` counter MUST increment +- **AND** the query details MUST be logged at WARNING level with `duration_ms`, `query_type`, and `table` + +### Requirement: Alerting Threshold Configuration +The system MUST support configurable alerting thresholds that can be used by external monitoring systems (Prometheus Alertmanager, Grafana). The thresholds SHALL be exposed as Prometheus recording rules or as metadata alongside the metrics endpoint. + +#### Scenario: Error rate threshold +- **GIVEN** the admin has configured an error rate threshold of 5% over 5 minutes +- **WHEN** the error rate exceeds 5% (e.g., 6 out of 100 requests return 5xx) +- **THEN** a Nextcloud notification MUST be sent to admin users +- **AND** the condition MUST be queryable as `openregister_error_rate_exceeded 1` + +#### Scenario: Response time threshold +- **GIVEN** the admin has configured a p95 response time threshold of 3 seconds +- **WHEN** the 95th percentile response time exceeds 3 seconds over the last 5 minutes +- **THEN** a Nextcloud notification MUST be sent to admin users + +#### Scenario: Storage growth threshold +- **GIVEN** the admin has configured a daily storage growth alert at 1GB +- **WHEN** the `MetricsService.getStorageGrowth()` detects that daily vector additions exceed the threshold +- **THEN** the system MUST log a WARNING and expose `openregister_storage_growth_exceeded 1` + +### Requirement: Metrics Storage Strategy +Since PHP is a request-scoped runtime without persistent in-memory state, the system MUST use a durable storage mechanism for counters and histograms. The `openregister_metrics` database table (used by `MetricsService.recordMetric()`) SHALL serve as the primary storage, with optional APCu caching for high-frequency counter increments. + +#### Scenario: Counter persistence across requests +- **GIVEN** a counter has been incremented 1000 times across multiple PHP requests +- **WHEN** the metrics endpoint formats the counter value +- **THEN** it MUST query the `openregister_metrics` table to produce an accurate count +- **AND** the query MUST complete within 500ms even with millions of rows (using indexed `metric_type` + `created_at`) + +#### Scenario: APCu cache for high-frequency metrics +- **GIVEN** the deployment handles 100+ requests per second +- **WHEN** each request increments `openregister_requests_total` +- **THEN** the increment SHOULD use APCu atomic increment (`apcu_inc`) for performance +- **AND** a periodic flush job MUST persist APCu counters to the database every 60 seconds + +#### Scenario: Metrics retention cleanup +- **GIVEN** the `openregister_metrics` table has grown beyond the configured retention period (default: 90 days) +- **WHEN** `MetricsService.cleanOldMetrics()` runs via the `LogCleanUpTask` cron +- **THEN** rows older than the retention period MUST be deleted +- **AND** the deletion count MUST be logged at INFO level + +### Requirement: Performance Baseline Metrics +The system MUST expose metrics from the `PerformanceHandler` (`lib/Service/Object/PerformanceHandler.php`) and `PerformanceOptimizationHandler` to track internal optimization effectiveness. These metrics enable capacity planning and regression detection. + +#### Scenario: Fast-path detection rate +- **GIVEN** the `PerformanceHandler.optimizeRequestForPerformance()` classifies requests as simple or complex +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_fast_path_requests_total` and `openregister_slow_path_requests_total` counters MUST be present + +#### Scenario: Cache hit ratio +- **GIVEN** the `CacheHandler` serves cached objects for repeated lookups +- **WHEN** the metrics endpoint is scraped +- **THEN** `openregister_cache_hits_total` and `openregister_cache_misses_total` counters MUST be present +- **AND** the hit ratio SHOULD be calculable as `hits / (hits + misses)` + +#### Scenario: Import job progress tracking +- **GIVEN** a bulk import job is processing 10,000 objects via `ObjectTextExtractionJob` or data import +- **WHEN** the metrics endpoint is scraped during the import +- **THEN** `openregister_import_objects_processed_total{job_id="abc123"}` MUST reflect the current progress +- **AND** `openregister_import_duration_seconds{job_id="abc123"}` MUST track elapsed time + +### Requirement: Nextcloud Dashboard Integration +The system SHALL register an `OCP\Dashboard\IWidget` that displays key OpenRegister metrics on the Nextcloud dashboard home screen. The existing `DashboardService` (`lib/Service/DashboardService.php`) provides register/schema aggregation; this requirement extends it with real-time operational widgets. + +#### Scenario: Dashboard widget shows key metrics +- **GIVEN** an admin user views the Nextcloud dashboard +- **WHEN** the OpenRegister widget is enabled +- **THEN** the widget MUST display: total objects, total registers, total schemas, recent error count, and average response time + +#### Scenario: Dashboard widget links to detailed metrics +- **GIVEN** the admin sees a high error count on the dashboard widget +- **WHEN** the admin clicks the error count +- **THEN** the system MUST navigate to the OpenRegister admin panel with the monitoring tab active + +#### Scenario: Nextcloud OCS monitoring endpoint integration +- **GIVEN** Nextcloud exposes `/ocs/v2.php/apps/serverinfo/api/v1/info` for server monitoring +- **WHEN** an external monitoring tool queries this endpoint +- **THEN** OpenRegister's health status SHOULD be included in the response as an additional section + +## Current Implementation Status +- **Implemented -- Prometheus metrics endpoint**: `MetricsController` (`lib/Controller/MetricsController.php`) exposes `/api/metrics` with `openregister_info`, `openregister_up`, `openregister_registers_total`, `openregister_schemas_total`, `openregister_objects_total` (by register/schema), and `openregister_search_requests_total` gauges. Content-Type header is correctly set to Prometheus exposition format. +- **Implemented -- health check endpoint**: `HealthController` (`lib/Controller/HealthController.php`) exposes `/api/health` with database and filesystem checks, returning `ok`/`degraded`/`error` status with HTTP 200/503. +- **Implemented -- heartbeat endpoint**: `HeartbeatController` (`lib/Controller/HeartbeatController.php`) exposes `/api/heartbeat` for connection keep-alive during long operations. +- **Implemented -- metrics recording service**: `MetricsService` (`lib/Service/MetricsService.php`) records operational metrics to `openregister_metrics` table with support for file processing, embedding generation, search latency, and storage growth tracking. Includes 90-day retention cleanup. +- **Implemented -- audit trail**: `AuditTrail` entity, `AuditTrailMapper`, `AuditHandler`, `LogService`, and `AuditTrailController` provide complete object-level audit logging with export support (CSV, JSON, XML, TXT). +- **Implemented -- webhook logging**: `WebhookLog` entity and `WebhookLogMapper` track webhook delivery attempts, success/failure, retry counts, and response data. +- **Implemented -- performance tracking**: `PerformanceHandler` and `PerformanceOptimizationHandler` track fast-path detection, extend optimization, and cache preloading. +- **Not implemented -- request duration histograms**: No middleware tracks per-request duration as histogram data with Prometheus bucket boundaries. +- **Not implemented -- CRUD operation counters**: No counters for create/update/delete operations in Prometheus format (MetricsService records metrics but MetricsController does not format them as counters with register/schema labels). +- **Not implemented -- readiness endpoint**: No `/api/ready` endpoint that checks migration status. +- **Not implemented -- structured JSON logging**: Application uses Nextcloud's `LoggerInterface` but does not enforce structured context fields (request_id, register, schema) consistently. +- **Not implemented -- IP-restricted metrics access**: No IP-based access control or token authentication for the metrics endpoint. +- **Not implemented -- alerting thresholds**: No configurable threshold system with Nextcloud notifications. +- **Not implemented -- APCu counter caching**: All metrics go directly to database; no APCu fast path for high-frequency counter increments. +- **Not implemented -- Nextcloud dashboard widget**: No `IWidget` registration for the Nextcloud dashboard. + +## Standards & References +- Prometheus text exposition format: https://prometheus.io/docs/instrumenting/exposition_formats/ +- OpenMetrics specification: https://openmetrics.io/ +- Kubernetes health check conventions: `/health` (liveness), `/ready` (readiness) +- JSON structured logging: ECS (Elastic Common Schema) +- Nextcloud logging framework: `Psr\Log\LoggerInterface` via `OCP` +- Nextcloud dashboard widgets: `OCP\Dashboard\IWidget`, `OCP\Dashboard\IAPIWidget` +- Nextcloud server monitoring: `/ocs/v2.php/apps/serverinfo/api/v1/info` +- BIO (Baseline Informatiebeveiliging Overheid): Dutch government information security baseline +- Cross-reference: `api-test-coverage` spec (test coverage for metrics endpoints) +- Cross-reference: `event-driven-architecture` spec (events that trigger metric recording) +- Cross-reference: `audit-trail-immutable` spec (immutability requirements for audit entries) +- Cross-reference: `deletion-audit-trail` spec (audit logging for delete operations) +- Shared pattern: `opencatalogi`, `pipelinq`, `procest` prometheus-metrics specs follow the same `REQ-PROM-001` through `REQ-PROM-004` structure diff --git a/openspec/changes/profile-actions/specs/profile-actions/spec.md b/openspec/changes/profile-actions/specs/profile-actions/spec.md new file mode 100644 index 000000000000..e450939574e9 --- /dev/null +++ b/openspec/changes/profile-actions/specs/profile-actions/spec.md @@ -0,0 +1,343 @@ +--- +status: implemented +--- + +# Profile Actions + +## Purpose + +Extend the OpenRegister user profile system with self-service account management actions. The current profile API (`/api/user/me`) supports reading and updating basic profile fields, but lacks password change, avatar management, personal data export (GDPR Article 20 data portability), notification preferences, personal activity history, API token management, and account deactivation requests. This spec defines REST endpoints and frontend UI for each action, all respecting Nextcloud backend capabilities and organisation-level policies. Every action is scoped to the authenticated user (no admin elevation required) and integrates with existing `UserService`, `SecurityService`, and `OrganisationService`. + +**Standards**: GDPR Articles 17 and 20 (erasure and data portability), Nextcloud OCS User API conventions, NL Design System (NLDS) theming tokens, WCAG 2.1 AA accessibility. +**Cross-references**: [object-interactions](../../specs/object-interactions/spec.md) (audit trail), [rbac-scopes](../../specs/rbac-scopes/spec.md) (permissions), [auth-system](../auth-system/) (authentication). + +## Requirements + +### Requirement: Password change MUST be available as a self-service action + +The system SHALL provide an endpoint at `PUT /api/user/me/password` that allows the authenticated user to change their own password. The endpoint MUST validate the current password before accepting the new one, MUST enforce Nextcloud's password policy, and MUST check `IUser::canChangePassword()` before allowing the action. Rate limiting via `SecurityService` MUST be applied to prevent brute-force attacks on the current password field. + +#### Scenario: Successful password change +- **GIVEN** an authenticated user `jan.pietersen` whose backend supports password changes (`canChangePassword()` returns `true`) +- **WHEN** the user sends `PUT /api/user/me/password` with body `{"currentPassword": "OldPass1234!", "newPassword": "NewSecure2026!"}` +- **THEN** `SecurityService::validateLoginCredentials()` SHALL verify the current password +- **AND** `IUser::setPassword("NewSecure2026!")` SHALL be called +- **AND** the response SHALL be HTTP 200 with `{"success": true, "message": "Password updated successfully"}` +- **AND** the response SHALL include security headers via `SecurityService::addSecurityHeaders()` + +#### Scenario: Current password is incorrect +- **GIVEN** an authenticated user +- **WHEN** the user sends `PUT /api/user/me/password` with an incorrect `currentPassword` +- **THEN** `IUserManager::checkPassword()` SHALL return `false` +- **AND** `SecurityService::recordFailedLoginAttempt()` SHALL be called +- **AND** the response SHALL be HTTP 403 with `{"error": "Current password is incorrect"}` + +#### Scenario: Backend does not support password changes +- **GIVEN** an authenticated user whose backend returns `canChangePassword() === false` (e.g., LDAP) +- **WHEN** the user sends `PUT /api/user/me/password` +- **THEN** the response SHALL be HTTP 409 with `{"error": "Password changes are not supported by your authentication backend"}` + +#### Scenario: New password does not meet policy +- **GIVEN** an authenticated user with correct current password +- **WHEN** the user sends a new password that is too short (e.g., `"abc"`) +- **THEN** `IUser::setPassword()` SHALL throw an exception or return `false` +- **AND** the response SHALL be HTTP 400 with `{"error": "New password does not meet the password policy requirements"}` + +#### Scenario: Rate limiting on repeated password change attempts +- **GIVEN** an authenticated user who has made 5 failed password change attempts in 15 minutes +- **WHEN** the user sends another `PUT /api/user/me/password` +- **THEN** `SecurityService::checkLoginRateLimit()` SHALL return `allowed: false` +- **AND** the response SHALL be HTTP 429 with a `retry_after` value + +### Requirement: Avatar management MUST support upload and deletion + +The system SHALL provide endpoints for uploading (`POST /api/user/me/avatar`) and deleting (`DELETE /api/user/me/avatar`) the user's avatar image. Upload MUST validate file type (JPEG, PNG, GIF, WebP), file size (max 5 MB), and `IUser::canChangeAvatar()` capability. The avatar MUST be set via Nextcloud's `IAvatarManager`. Deletion SHALL reset to the default Nextcloud-generated avatar. + +#### Scenario: Upload a JPEG avatar +- **GIVEN** an authenticated user whose backend supports avatar changes +- **WHEN** the user sends `POST /api/user/me/avatar` with a multipart form containing a 200 KB JPEG image +- **THEN** `IAvatarManager::getAvatar($userId)` SHALL be called +- **AND** `IAvatar::set($imageData)` SHALL be called with the uploaded image data +- **AND** the response SHALL be HTTP 200 with `{"success": true, "avatarUrl": "/avatar/{uid}/128"}` + +#### Scenario: Upload file exceeds size limit +- **GIVEN** an authenticated user +- **WHEN** the user uploads an image larger than 5 MB +- **THEN** the response SHALL be HTTP 400 with `{"error": "Avatar image must be smaller than 5 MB"}` + +#### Scenario: Upload unsupported file type +- **GIVEN** an authenticated user +- **WHEN** the user uploads a `.bmp` file +- **THEN** the response SHALL be HTTP 400 with `{"error": "Unsupported image format. Allowed: JPEG, PNG, GIF, WebP"}` + +#### Scenario: Delete avatar +- **GIVEN** an authenticated user with a custom avatar +- **WHEN** the user sends `DELETE /api/user/me/avatar` +- **THEN** `IAvatar::remove()` SHALL be called +- **AND** the response SHALL be HTTP 200 with `{"success": true, "message": "Avatar removed"}` + +#### Scenario: Backend does not support avatar changes +- **GIVEN** an authenticated user whose backend returns `canChangeAvatar() === false` +- **WHEN** the user sends `POST /api/user/me/avatar` +- **THEN** the response SHALL be HTTP 409 with `{"error": "Avatar changes are not supported by your authentication backend"}` + +### Requirement: Personal data export MUST comply with GDPR Article 20 + +The system SHALL provide an endpoint at `GET /api/user/me/export` that generates a JSON export of all personal data associated with the authenticated user. The export MUST include Nextcloud profile data, organisation memberships, OpenRegister objects owned by the user (via the `owner` system field), audit trail entries where the user is the actor, and any files attached to owned objects. The export MUST be returned as a downloadable JSON file with `Content-Disposition: attachment` header. + +#### Scenario: Export all personal data +- **GIVEN** an authenticated user `jan.pietersen` who owns 15 objects across 3 registers and is member of 2 organisations +- **WHEN** the user sends `GET /api/user/me/export` +- **THEN** the response SHALL be HTTP 200 with `Content-Type: application/json` and `Content-Disposition: attachment; filename="openregister-export-jan.pietersen-2026-03-24.json"` +- **AND** the JSON SHALL contain sections: `profile` (from `buildUserDataArray()`), `organisations` (membership list), `objects` (all owned objects grouped by register/schema), `auditTrail` (all audit entries where actor is the user) +- **AND** each object SHALL include its full JSON data including file references + +#### Scenario: Export with no owned data +- **GIVEN** an authenticated user who owns no objects and has no audit trail entries +- **WHEN** the user sends `GET /api/user/me/export` +- **THEN** the response SHALL be HTTP 200 with a valid JSON containing `profile` data and empty `objects`, `auditTrail` arrays +- **AND** the `organisations` section SHALL still list current memberships + +#### Scenario: Export rate limiting +- **GIVEN** an authenticated user who has already exported data in the last hour +- **WHEN** the user sends another `GET /api/user/me/export` +- **THEN** the response SHALL be HTTP 429 with `{"error": "Data export is limited to once per hour", "retry_after": }` + +#### Scenario: Export includes cross-organisation data +- **GIVEN** a user who is a member of organisations A and B, owning objects in both +- **WHEN** the user exports their data +- **THEN** the export SHALL include objects from ALL organisations the user owns, regardless of the currently active organisation +- **AND** each object SHALL include its `organisation` field for context + +### Requirement: Notification preferences MUST be configurable per user + +The system SHALL provide endpoints at `GET /api/user/me/notifications` and `PUT /api/user/me/notifications` for reading and updating per-user notification preferences. Preferences SHALL control which OpenRegister events trigger notifications for the user, stored via `IConfig::setUserValue()`. Categories SHALL include: object changes in owned objects, assignment notifications, organisation membership changes, and system announcements. + +#### Scenario: Get default notification preferences +- **GIVEN** an authenticated user who has never set notification preferences +- **WHEN** the user sends `GET /api/user/me/notifications` +- **THEN** the response SHALL be HTTP 200 with default preferences: `{"objectChanges": true, "assignments": true, "organisationChanges": true, "systemAnnouncements": true, "emailDigest": "daily"}` + +#### Scenario: Update notification preferences +- **GIVEN** an authenticated user +- **WHEN** the user sends `PUT /api/user/me/notifications` with `{"objectChanges": false, "emailDigest": "weekly"}` +- **THEN** `IConfig::setUserValue('openregister', 'notification_objectChanges', 'false')` SHALL be called +- **AND** `IConfig::setUserValue('openregister', 'notification_emailDigest', 'weekly')` SHALL be called +- **AND** the response SHALL be HTTP 200 with the complete updated preferences + +#### Scenario: Invalid email digest frequency +- **GIVEN** an authenticated user +- **WHEN** the user sends `PUT /api/user/me/notifications` with `{"emailDigest": "hourly"}` +- **THEN** the response SHALL be HTTP 400 with `{"error": "Invalid emailDigest value. Allowed: none, daily, weekly"}` + +#### Scenario: Notification preferences persist across sessions +- **GIVEN** a user who set `objectChanges` to `false` +- **WHEN** the user logs in again and sends `GET /api/user/me/notifications` +- **THEN** `objectChanges` SHALL be `false` (read from `IConfig::getUserValue()`) + +### Requirement: Personal activity history MUST be retrievable + +The system SHALL provide an endpoint at `GET /api/user/me/activity` that returns a paginated list of the authenticated user's recent actions within OpenRegister. Activities SHALL be sourced from the `AuditTrail` table filtered by the current user's ID as actor. The endpoint MUST support pagination via `_limit` and `_offset` query parameters and filtering by `type` (create, read, update, delete) and date range (`_from`, `_to`). + +#### Scenario: List recent activity with default pagination +- **GIVEN** an authenticated user `jan.pietersen` who has performed 50 actions +- **WHEN** the user sends `GET /api/user/me/activity` +- **THEN** the response SHALL be HTTP 200 with `{"results": [...], "total": 50}` where `results` contains the 25 most recent activities (default limit) +- **AND** each activity SHALL include: `id`, `type` (create/update/delete), `objectUuid`, `objectTitle`, `register`, `schema`, `timestamp`, `summary` + +#### Scenario: Filter activity by type +- **GIVEN** an authenticated user with create, update, and delete activities +- **WHEN** the user sends `GET /api/user/me/activity?type=create` +- **THEN** only activities with type `create` SHALL be returned + +#### Scenario: Filter activity by date range +- **GIVEN** an authenticated user with activities spanning January through March 2026 +- **WHEN** the user sends `GET /api/user/me/activity?_from=2026-03-01&_to=2026-03-24` +- **THEN** only activities within that date range SHALL be returned + +#### Scenario: Paginate activity results +- **GIVEN** an authenticated user with 50 activities +- **WHEN** the user sends `GET /api/user/me/activity?_limit=10&_offset=20` +- **THEN** activities 21 through 30 SHALL be returned +- **AND** the `total` field SHALL remain `50` + +#### Scenario: Activity for objects across organisations +- **GIVEN** a user who has performed actions in multiple organisations +- **WHEN** the user retrieves their activity history +- **THEN** activities from ALL organisations SHALL be included (not filtered by active organisation) + +### Requirement: API token management MUST support create, list, and revoke operations + +The system SHALL provide endpoints for managing personal API tokens at `/api/user/me/tokens`. API tokens enable programmatic access to the OpenRegister API without session cookies. Tokens SHALL be stored as Nextcloud app passwords via `IAppManager` or as custom token records in `IConfig`. Each token SHALL have a name, creation date, last used date, and optional expiration date. Token values SHALL only be displayed once at creation time. + +#### Scenario: Create a new API token +- **GIVEN** an authenticated user +- **WHEN** the user sends `POST /api/user/me/tokens` with `{"name": "CI Pipeline", "expiresIn": "90d"}` +- **THEN** a new token SHALL be generated using a cryptographically secure random generator +- **AND** the response SHALL be HTTP 201 with `{"id": , "name": "CI Pipeline", "token": "", "created": "2026-03-24T10:00:00Z", "expires": "2026-06-22T10:00:00Z"}` +- **AND** the full token value SHALL NOT be retrievable after this response + +#### Scenario: List API tokens +- **GIVEN** an authenticated user with 3 API tokens +- **WHEN** the user sends `GET /api/user/me/tokens` +- **THEN** the response SHALL be HTTP 200 with an array of 3 token objects +- **AND** each token SHALL include `id`, `name`, `created`, `lastUsed`, `expires`, and a masked token preview (last 4 characters) +- **AND** the full token value SHALL NOT be included + +#### Scenario: Revoke an API token +- **GIVEN** an authenticated user with a token named "CI Pipeline" with ID 42 +- **WHEN** the user sends `DELETE /api/user/me/tokens/42` +- **THEN** the token SHALL be permanently deleted +- **AND** the response SHALL be HTTP 200 with `{"success": true, "message": "Token revoked"}` +- **AND** subsequent API calls using the revoked token SHALL return HTTP 401 + +#### Scenario: Token expiration enforcement +- **GIVEN** an API token that expired on 2026-03-20 +- **WHEN** a client uses this token to authenticate on 2026-03-24 +- **THEN** the authentication SHALL fail with HTTP 401 +- **AND** the response SHALL include `{"error": "Token has expired"}` + +#### Scenario: Maximum token limit +- **GIVEN** an authenticated user who already has 10 API tokens (the maximum) +- **WHEN** the user sends `POST /api/user/me/tokens` +- **THEN** the response SHALL be HTTP 400 with `{"error": "Maximum number of API tokens (10) reached. Revoke an existing token first."}` + +### Requirement: Account deactivation request MUST be supported + +The system SHALL provide an endpoint at `POST /api/user/me/deactivate` that allows a user to request deactivation of their own account. Deactivation SHALL NOT immediately disable the account; instead, it SHALL create a pending deactivation request that an administrator must approve. The request SHALL be stored and retrievable by the user via `GET /api/user/me/deactivation-status`. A user SHALL be able to cancel a pending deactivation request via `DELETE /api/user/me/deactivate`. + +#### Scenario: Request account deactivation +- **GIVEN** an authenticated user `jan.pietersen` +- **WHEN** the user sends `POST /api/user/me/deactivate` with `{"reason": "Leaving the organization"}` +- **THEN** a deactivation request SHALL be stored via `IConfig::setUserValue('openregister', 'deactivation_request', )` +- **AND** the response SHALL be HTTP 200 with `{"success": true, "message": "Deactivation request submitted", "status": "pending", "requestedAt": "2026-03-24T10:00:00Z"}` +- **AND** a notification SHALL be sent to all admin users + +#### Scenario: Check deactivation status with no pending request +- **GIVEN** an authenticated user with no pending deactivation request +- **WHEN** the user sends `GET /api/user/me/deactivation-status` +- **THEN** the response SHALL be HTTP 200 with `{"status": "active", "pendingRequest": null}` + +#### Scenario: Cancel deactivation request +- **GIVEN** an authenticated user with a pending deactivation request +- **WHEN** the user sends `DELETE /api/user/me/deactivate` +- **THEN** the deactivation request SHALL be removed +- **AND** the response SHALL be HTTP 200 with `{"success": true, "message": "Deactivation request cancelled", "status": "active"}` + +#### Scenario: Prevent duplicate deactivation requests +- **GIVEN** an authenticated user with an existing pending deactivation request +- **WHEN** the user sends another `POST /api/user/me/deactivate` +- **THEN** the response SHALL be HTTP 409 with `{"error": "A deactivation request is already pending", "requestedAt": "2026-03-24T10:00:00Z"}` + +### Requirement: Frontend MUST provide a "Mijn Account" page with action sections + +The frontend SHALL include a "Mijn Account" (My Account) page accessible from the user menu that displays the current user's profile information and provides UI sections for each profile action. The page MUST use Nextcloud Vue components (`NcButton`, `NcTextField`, `NcModal`, `NcActionButton`, `NcAvatar`) and follow NL Design System theming via CSS custom properties. All labels MUST use `t('openregister', ...)` for i18n support in Dutch and English. + +#### Scenario: Navigate to Mijn Account page +- **GIVEN** an authenticated user +- **WHEN** the user clicks their avatar in the header and selects "Mijn Account" +- **THEN** the router SHALL navigate to `/mijn-account` +- **AND** the page SHALL display sections: Profile Information, Password, Avatar, Notifications, Activity, API Tokens, Account + +#### Scenario: Password section respects backend capabilities +- **GIVEN** a user whose backend does not support password changes +- **WHEN** the "Mijn Account" page renders +- **THEN** the Password section SHALL display a disabled state with text `t('openregister', 'Password changes are not supported by your authentication provider')` +- **AND** the password change form SHALL NOT be rendered + +#### Scenario: Avatar section with upload and delete +- **GIVEN** a user with a custom avatar whose backend supports avatar changes +- **WHEN** the user views the Avatar section +- **THEN** the current avatar SHALL be displayed using `NcAvatar` component +- **AND** an "Upload new avatar" button and "Remove avatar" button SHALL be displayed +- **AND** clicking "Upload new avatar" SHALL open a file picker limited to image types + +#### Scenario: Activity section with pagination +- **GIVEN** a user with 50 activity entries +- **WHEN** the user views the Activity section +- **THEN** the 25 most recent activities SHALL be displayed in a timeline format +- **AND** a "Load more" button SHALL be displayed +- **AND** each activity entry SHALL show: icon (based on type), description, timestamp (relative), and a link to the affected object + +#### Scenario: API Token creation with copy-to-clipboard +- **GIVEN** a user creating a new API token +- **WHEN** the token is created successfully +- **THEN** an `NcModal` SHALL display the full token value with a "Copy to clipboard" button +- **AND** a warning message SHALL state: `t('openregister', 'This token will only be shown once. Copy it now.')` +- **AND** after closing the modal, the token list SHALL refresh showing the new token with a masked value + +#### Scenario: Account deactivation with confirmation dialog +- **GIVEN** a user clicking "Request account deactivation" +- **WHEN** the confirmation dialog appears +- **THEN** an `NcModal` SHALL display with a textarea for the reason and a warning about the consequences +- **AND** the user MUST type their username to confirm (double-confirmation pattern) +- **AND** the submit button SHALL be disabled until the username matches + +#### Scenario: Page accessibility +- **GIVEN** the "Mijn Account" page is rendered +- **WHEN** a screen reader navigates the page +- **THEN** each section SHALL have a proper heading hierarchy (h2 for section titles) +- **AND** all interactive elements SHALL have `aria-label` or visible labels +- **AND** color contrast SHALL meet WCAG 2.1 AA (4.5:1 minimum for text) + +### Requirement: All profile action endpoints MUST return consistent error responses + +All profile action endpoints SHALL follow the existing OpenRegister error response format: `{"error": ""}` with appropriate HTTP status codes. Authentication failures SHALL return 401, authorization failures 403, validation errors 400, rate limiting 429, and server errors 500. All error messages in controller responses SHALL use `$this->l10n->t()` for internationalization. All responses SHALL include security headers via `SecurityService::addSecurityHeaders()`. + +#### Scenario: Unauthenticated request to any profile action +- **GIVEN** no authentication credentials +- **WHEN** a request is sent to any `/api/user/me/*` endpoint +- **THEN** the response SHALL be HTTP 401 with `{"error": "Not authenticated"}` + +#### Scenario: Server error during profile action +- **GIVEN** an authenticated user +- **WHEN** an unexpected exception occurs during any profile action +- **THEN** the error SHALL be logged via `LoggerInterface::error()` with context including file, line, and error message +- **AND** the response SHALL be HTTP 500 with a generic error message (no stack trace or internal details) + +#### Scenario: Input sanitization on all profile actions +- **GIVEN** an authenticated user sending data to any profile action endpoint +- **WHEN** the request body contains HTML or script tags +- **THEN** `SecurityService::sanitizeInput()` SHALL be called on all input fields before processing +- **AND** any XSS-bearing input SHALL be stripped or escaped + +## Current Implementation Status + +**Not implemented.** The existing codebase has the foundation: + +- `UserController` provides `me()`, `updateMe()`, `login()`, `logout()` endpoints +- `UserService` provides `buildUserDataArray()`, `updateUserProperties()`, `updateStandardUserProperties()`, `updateProfileProperties()` +- `SecurityService` provides rate limiting, input sanitization, and security headers +- `UserProfileUpdatedEvent` dispatches on profile changes +- `DataAccessProfile` entity exists but is not yet integrated with user tokens +- Routes exist at `/api/user/me` (GET, PUT), `/api/user/login` (POST), `/api/user/logout` (POST) +- Frontend has no dedicated "Mijn Account" page; profile data is shown via the Nextcloud user menu + +**Not yet implemented:** +- Password change endpoint (`PUT /api/user/me/password`) +- Avatar management endpoints (`POST/DELETE /api/user/me/avatar`) +- Personal data export endpoint (`GET /api/user/me/export`) +- Notification preferences endpoints (`GET/PUT /api/user/me/notifications`) +- Activity history endpoint (`GET /api/user/me/activity`) +- API token management endpoints (`POST/GET/DELETE /api/user/me/tokens`) +- Account deactivation endpoints (`POST/GET/DELETE /api/user/me/deactivate`) +- Frontend "Mijn Account" page with action sections +- Consistent error handling across all profile endpoints + +## Standards & References + +- GDPR Article 17 (Right to erasure) and Article 20 (Right to data portability) +- Nextcloud OCS User Provisioning API conventions +- NL Design System (Rijkshuisstijl) design tokens for UI theming +- WCAG 2.1 Level AA accessibility requirements +- RFC 6750 (Bearer Token Usage) for API token format +- Nextcloud `IAvatarManager` for avatar operations +- Nextcloud `IConfig` for user-level preference storage +- Nextcloud `IUser` backend capability checks (`canChangePassword()`, `canChangeAvatar()`, etc.) + +## Cross-References + +- `object-interactions` -- Audit trail provides activity data source +- `rbac-scopes` -- Permission framework for action authorization +- `auth-system` -- Authentication and session management +- `production-observability` -- Logging patterns for error tracking diff --git a/openspec/changes/rapportage-bi-export/specs/rapportage-bi-export/spec.md b/openspec/changes/rapportage-bi-export/specs/rapportage-bi-export/spec.md new file mode 100644 index 000000000000..b92084fff72f --- /dev/null +++ b/openspec/changes/rapportage-bi-export/specs/rapportage-bi-export/spec.md @@ -0,0 +1,486 @@ +--- +status: draft +--- +# Rapportage en BI Export + +## Purpose +Provide a comprehensive reporting and business intelligence export layer for OpenRegister that enables government organisations to generate management reports, perform data aggregation queries, connect external BI tools, and satisfy Dutch public accountability requirements (WOO, jaarverslag, verantwoording). The system MUST expose a general-purpose aggregation API (count, sum, avg, min, max, group by) on top of the existing `MagicMapper` and `MagicStatisticsHandler` infrastructure, support scheduled report generation via Nextcloud background jobs, produce exports in CSV, Excel, PDF, and ODS formats through the existing `ExportService`/`ExportHandler` pipeline, and provide OData v4 and ODBC-compatible endpoints for integration with Power BI, Tableau, and other external BI platforms. All reporting operations MUST enforce RBAC via `PermissionHandler`, `MagicRbacHandler`, and `PropertyRbacHandler`, and MUST respect multi-tenancy boundaries to guarantee data isolation between organisations. + +**Tender demand**: 89% of analyzed government tenders require reporting and BI export capabilities. Key recurring requirements include management dashboards, KPI tracking, periodic status reports (wekelijkse voortgangsrapportage), WOO transparency reporting, and integration with existing BI tooling (Power BI, Tableau, QlikView). + +## ADDED Requirements + +### Requirement: The system MUST provide a general-purpose aggregation API +REST API endpoints MUST support aggregation queries with `count`, `sum`, `avg`, `min`, and `max` metrics, `groupBy` for categorical breakdowns, `interval` for time-series bucketing, and `having` for post-aggregation filtering. The aggregation engine SHALL leverage SQL-level `GROUP BY` queries via `MagicMapper` for database-backed schemas and delegate to Solr/Elasticsearch facet aggregations when a search backend is configured. This extends the existing `MagicStatisticsHandler::getStatistics()` and `MagicFacetHandler` infrastructure with a user-facing API. + +#### Scenario: Count objects grouped by a categorical property +- **GIVEN** register `zaken` with schema `meldingen` containing objects with `status` values: nieuw (30), in_behandeling (45), afgehandeld (125) +- **WHEN** the API receives `GET /api/objects/{register}/{schema}/aggregate?groupBy=status&metric=count` +- **THEN** the response MUST return `{"results": [{"status": "nieuw", "count": 30}, {"status": "in_behandeling", "count": 45}, {"status": "afgehandeld", "count": 125}], "total": 200}` +- **AND** the query MUST execute as a SQL `GROUP BY` on the magic table column (not application-level iteration) +- **AND** RBAC filtering via `MagicRbacHandler` MUST be applied before aggregation + +#### Scenario: Sum a numeric property grouped by category +- **GIVEN** schema `subsidies` with objects containing `bedrag` (number) and `categorie` (string) properties +- **WHEN** the API receives `GET /api/objects/{register}/{schema}/aggregate?groupBy=categorie&metric=sum&field=bedrag` +- **THEN** the response MUST return the sum of `bedrag` per `categorie` +- **AND** null values in `bedrag` MUST be excluded from the sum (SQL `SUM` semantics) +- **AND** the response MUST include `"metric": "sum"` and `"field": "bedrag"` for self-documentation + +#### Scenario: Time-series aggregation with monthly interval +- **GIVEN** schema `meldingen` with objects created over the past 12 months +- **WHEN** the API receives `GET /api/objects/{register}/{schema}/aggregate?groupBy=@self.created&interval=month&metric=count` +- **THEN** the response MUST return monthly counts for each of the past 12 months +- **AND** months with zero objects MUST still appear in the response with `count: 0` (gap filling) +- **AND** the date labels MUST use ISO 8601 format (`2026-01`, `2026-02`, etc.) + +#### Scenario: Multiple metrics in a single request +- **GIVEN** schema `facturen` with numeric property `bedrag` +- **WHEN** the API receives `GET /api/objects/{register}/{schema}/aggregate?groupBy=status&metric=count,sum,avg&field=bedrag` +- **THEN** each result row MUST include `count`, `sum`, and `avg` values +- **AND** the response format MUST be `{"results": [{"status": "betaald", "count": 50, "sum": 125000.00, "avg": 2500.00}, ...]}` + +#### Scenario: Aggregation with filters applied +- **GIVEN** schema `meldingen` with 200 objects across three statuses +- **WHEN** the API receives `GET /api/objects/{register}/{schema}/aggregate?groupBy=locatie&metric=count&status=nieuw` +- **THEN** the aggregation MUST only include objects where `status = nieuw` +- **AND** the same filter syntax used in `ObjectService::searchObjects()` MUST be accepted + +### Requirement: The system MUST support configurable report templates +Administrators MUST be able to define report templates that specify data sources (register, schema, filters), layout sections (title, summary statistics, data table, charts), output format (PDF, Excel, CSV), and branding (logo, header/footer text, organisation name). Report templates SHALL be stored as OpenRegister objects in a dedicated `report-templates` schema, making them versionable and exportable via the standard configuration pipeline. + +#### Scenario: Create a report template via API +- **GIVEN** an administrator with write access to the `report-templates` schema +- **WHEN** they create a template object with: `{"name": "Wekelijks Meldingen Rapport", "dataSource": {"register": "zaken", "schema": "meldingen", "filters": {"status!": "afgehandeld"}}, "sections": ["summary", "statusBreakdown", "dataTable"], "format": "pdf", "branding": {"logo": "/apps/theming/logo", "organisatie": "Gemeente Utrecht"}}` +- **THEN** the template MUST be stored and retrievable via the standard objects API +- **AND** the template MUST be usable by the report generation endpoint + +#### Scenario: Render a report from a template +- **GIVEN** report template `Wekelijks Meldingen Rapport` exists +- **WHEN** the API receives `POST /api/reports/generate` with `{"templateId": "", "dateRange": {"from": "2026-03-01", "to": "2026-03-07"}}` +- **THEN** the system MUST query `meldingen` objects matching the template filters and date range +- **AND** generate a PDF with the configured sections and branding +- **AND** return the PDF as a downloadable file or store it at a configured Nextcloud Files path + +#### Scenario: Template with custom summary statistics +- **GIVEN** a template configured with summary section containing: total count, status breakdown (pie chart data), average handling time +- **WHEN** the report is generated +- **THEN** the summary section MUST display the aggregated statistics computed via the aggregation API +- **AND** the status breakdown MUST include both counts and percentages + +### Requirement: The system MUST support scheduled report generation +Reports MUST be configurable to run on a cron schedule and be delivered via Nextcloud notifications, stored in Nextcloud Files, or sent via email through n8n workflow integration. Scheduled reports SHALL use Nextcloud `TimedJob` infrastructure. This builds on the `BackgroundJob` pattern already used by `SolrNightlyWarmupJob` and `ConfigurationCheckJob`. + +#### Scenario: Schedule a weekly status report +- **GIVEN** a report template `Wekelijks Meldingen Rapport` with schedule: every Monday at 08:00 +- **AND** delivery target: Nextcloud Files path `/Reports/Meldingen/` +- **WHEN** the Nextcloud cron runs on Monday at 08:00 +- **THEN** a `ScheduledReportJob` (extending `TimedJob`) MUST generate the PDF report with current data +- **AND** store the file at `/Reports/Meldingen/meldingen_2026-03-16.pdf` +- **AND** send a Nextcloud notification to the report owner via `INotifier` + +#### Scenario: Schedule a daily CSV export for data warehouse +- **GIVEN** a scheduled export configured for schema `meldingen`, format CSV, schedule daily at 02:00 +- **AND** delivery: Nextcloud Files path `/DataWarehouse/meldingen/` +- **WHEN** the scheduled job triggers at 02:00 +- **THEN** `ExportService::exportToCsv()` MUST generate the CSV with all current objects +- **AND** the filename MUST include the date: `meldingen_2026-03-19.csv` +- **AND** previous exports MUST be retained according to the configured retention period (default: 90 days) + +#### Scenario: Scheduled report with email delivery via n8n +- **GIVEN** a scheduled report with delivery target `email` and recipients `management@gemeente.nl` +- **AND** an n8n workflow is configured for report email delivery +- **WHEN** the scheduled job triggers +- **THEN** the system MUST generate the report and trigger the n8n workflow with the report file as payload +- **AND** the n8n workflow SHALL handle SMTP delivery (OpenRegister does not manage SMTP directly) + +#### Scenario: Report retention management +- **GIVEN** a scheduled report configured with retention period of 52 weeks +- **AND** 60 weekly reports have accumulated in Nextcloud Files +- **WHEN** the retention cleanup runs +- **THEN** reports older than 52 weeks MUST be deleted from Nextcloud Files +- **AND** the 52 most recent reports MUST be preserved +- **AND** a log entry MUST record how many reports were cleaned up + +### Requirement: The system MUST support export in CSV, Excel, PDF, and ODS formats +Register objects MUST be exportable in CSV (already implemented via `ExportService::exportToCsv()`), Excel XLSX (already implemented via `ExportService::exportToExcel()`), PDF (new), and ODS (new) formats. The existing `ExportHandler` SHALL be extended with `exportToPdf()` and `exportToOds()` methods. PDF generation SHALL use a PHP library (Dompdf or TCPDF) or delegate to Docudesk's PDF capabilities if available. + +#### Scenario: Export filtered results to CSV +- **GIVEN** 200 `meldingen` objects, 45 with status `afgehandeld` +- **AND** the user has applied filter `status=afgehandeld` +- **WHEN** the user exports to CSV format via `GET /api/objects/{register}/{schema}/export?format=csv&status=afgehandeld` +- **THEN** `ExportService::exportToCsv()` MUST generate a CSV with exactly 45 data rows +- **AND** the CSV MUST use UTF-8 encoding with BOM for Excel compatibility +- **AND** the filename MUST follow pattern `{register}_{schema}_{datetime}.csv` (as implemented in `ExportHandler::export()`) + +#### Scenario: Export to Excel with relation name resolution +- **GIVEN** schema `taken` with property `toegewezen_aan` referencing `medewerkers` via UUID +- **WHEN** the user exports to XLSX format +- **THEN** the XLSX MUST include both the UUID column (`toegewezen_aan`) and the companion name column (`_toegewezen_aan`) as implemented in `ExportService::identifyNameCompanionColumns()` +- **AND** names MUST be resolved via the two-pass bulk approach in `ExportService::resolveUuidNameMap()` +- **AND** admin users MUST see `@self.*` metadata columns (per `ExportService::getHeaders()` admin check) + +#### Scenario: Export to PDF as a formatted report +- **GIVEN** 25 `vergunningen` objects filtered by date range Q1 2026 +- **WHEN** the user exports to PDF +- **THEN** the system MUST generate a formatted PDF document containing: + - Report title, generation timestamp, and applied filters + - Summary statistics: total count (25), status breakdown with counts and percentages + - Paginated data table with key properties (respecting `PropertyRbacHandler` column visibility) +- **AND** the PDF MUST support A4 landscape orientation for wide tables +- **AND** page numbers MUST appear in the footer + +#### Scenario: Export to ODS (Open Document Spreadsheet) +- **GIVEN** schema `meldingen` with 100 objects +- **WHEN** the user exports to ODS format +- **THEN** `PhpSpreadsheet\Writer\Ods` MUST generate the file with the same headers and data as the XLSX export +- **AND** the Content-Type MUST be `application/vnd.oasis.opendocument.spreadsheet` +- **AND** relation name resolution and RBAC filtering MUST be identical to the Excel export path + +#### Scenario: Export entire register to multi-sheet Excel +- **GIVEN** register `gemeente-register` with schemas `personen` (500 objects) and `adressen` (800 objects) +- **WHEN** the user exports the register without specifying a schema +- **THEN** `ExportService::exportToExcel()` SHALL create one sheet per schema (per existing `populateSheet()`) +- **AND** each sheet title MUST be the schema slug +- **AND** CSV and ODS formats MUST reject multi-schema export with an appropriate error message + +### Requirement: The system MUST provide chart data API endpoints for frontend visualization +Dedicated API endpoints MUST return data in a format optimized for chart rendering (labels + series arrays), extending the existing `MagicStatisticsHandler::getRegisterChartData()` and `MagicStatisticsHandler::getSchemaChartData()` methods with user-configurable chart queries. These endpoints power the built-in-dashboards spec and provide data for custom frontends. + +#### Scenario: Bar chart data for status distribution +- **GIVEN** schema `meldingen` with objects across 5 status values +- **WHEN** the API receives `GET /api/objects/{register}/{schema}/chart?type=bar&groupBy=status&metric=count` +- **THEN** the response MUST return `{"labels": ["nieuw", "in_behandeling", "wacht_op_info", "afgehandeld", "gesloten"], "series": [{"name": "count", "data": [30, 45, 12, 125, 8]}]}` +- **AND** the format MUST be directly consumable by Chart.js or Apache ECharts + +#### Scenario: Time-series line chart data +- **GIVEN** schema `meldingen` with objects created over the past 6 months +- **WHEN** the API receives `GET /api/objects/{register}/{schema}/chart?type=line&groupBy=@self.created&interval=month&metric=count` +- **THEN** the response MUST return monthly labels and a series with monthly counts +- **AND** gap-filled months (zero objects) MUST be included for continuous chart rendering + +#### Scenario: Pie chart with percentage calculation +- **GIVEN** schema `meldingen` with 200 objects across 4 categories +- **WHEN** the API receives `GET /api/objects/{register}/{schema}/chart?type=pie&groupBy=categorie&metric=count` +- **THEN** the response MUST include both absolute counts and percentages +- **AND** format: `{"labels": ["Openbare ruimte", "Verkeer", "Afval", "Overig"], "series": [80, 60, 40, 20], "percentages": [40.0, 30.0, 20.0, 10.0]}` + +### Requirement: The system MUST support cross-register reporting +Reports and aggregation queries MUST be able to span multiple registers and schemas in a single query, enabling organisation-wide KPI dashboards. Cross-register queries SHALL execute individual aggregations per register-schema pair and merge results, leveraging the `MagicStatisticsHandler::getAllRegisterSchemaPairs()` discovery mechanism. + +#### Scenario: Organisation-wide object count across all registers +- **GIVEN** 3 registers (`zaken`, `klanten`, `documenten`) with multiple schemas each +- **WHEN** the API receives `GET /api/reports/aggregate?metric=count` (no register/schema specified) +- **THEN** the response MUST return the total object count across all registers +- **AND** a breakdown by register: `{"total": 15000, "byRegister": [{"register": "zaken", "count": 8000}, {"register": "klanten", "count": 5000}, {"register": "documenten", "count": 2000}]}` +- **AND** the query MUST use `MagicStatisticsHandler::getStatistics()` for efficient cross-table counting + +#### Scenario: Cross-register comparison report +- **GIVEN** registers `zaken` and `klanten` +- **WHEN** the API receives `GET /api/reports/aggregate?registers=zaken,klanten&groupBy=@self.created&interval=month&metric=count` +- **THEN** the response MUST return time-series data with one series per register +- **AND** format: `{"labels": ["2026-01", "2026-02", "2026-03"], "series": [{"name": "zaken", "data": [100, 120, 95]}, {"name": "klanten", "data": [50, 60, 55]}]}` + +#### Scenario: Cross-register reporting respects RBAC boundaries +- **GIVEN** user `medewerker-1` has access to register `zaken` but NOT to register `vertrouwelijk` +- **WHEN** they request a cross-register aggregate +- **THEN** the response MUST only include data from `zaken` +- **AND** `vertrouwelijk` MUST be silently excluded (no error, no data leakage) + +### Requirement: The system MUST support date range filtering and period-over-period comparison +All reporting endpoints MUST accept `from` and `to` date parameters for date range filtering. Period comparison reports MUST allow comparing two date ranges side-by-side (e.g., this month vs. last month, Q1 2026 vs. Q1 2025). + +#### Scenario: Date range filter on aggregation +- **GIVEN** schema `meldingen` with objects spanning 2025 and 2026 +- **WHEN** the API receives `GET /api/objects/{register}/{schema}/aggregate?groupBy=status&metric=count&from=2026-01-01&to=2026-03-31` +- **THEN** only objects created between January 1 and March 31, 2026 MUST be included in the aggregation +- **AND** the `from` and `to` parameters MUST filter on the `@self.created` metadata field by default + +#### Scenario: Period-over-period comparison +- **GIVEN** schema `meldingen` with data for 2025 and 2026 +- **WHEN** the API receives `GET /api/reports/compare?register=zaken&schema=meldingen&metric=count&period1.from=2026-01-01&period1.to=2026-03-31&period2.from=2025-01-01&period2.to=2025-03-31` +- **THEN** the response MUST return side-by-side counts for both periods +- **AND** include a calculated change: `{"period1": {"label": "Q1 2026", "count": 450}, "period2": {"label": "Q1 2025", "count": 380}, "change": {"absolute": 70, "percentage": 18.42}}` + +#### Scenario: Month-over-month trend +- **GIVEN** schema `meldingen` with 12 months of data +- **WHEN** the API receives a trend request for the last 6 months with monthly interval +- **THEN** each month MUST include the count, the previous month's count, and the percentage change +- **AND** the first month in the range MUST have `previousCount: null` and `change: null` + +### Requirement: The system MUST support custom calculated metrics +Report templates MUST support computed fields that derive values from existing properties using expressions (arithmetic, conditional, date arithmetic). Calculated metrics enable KPIs like "gemiddelde doorlooptijd" (average handling time) or "percentage op tijd afgehandeld" without requiring schema changes. + +#### Scenario: Average handling time calculation +- **GIVEN** schema `meldingen` with properties `aangemaakt` (date-time) and `afgehandeld_op` (date-time) +- **WHEN** a report template defines a calculated metric: `{"name": "doorlooptijd_dagen", "expression": "DATEDIFF(@self.updated, @self.created, 'days')", "filter": {"status": "afgehandeld"}}` +- **THEN** the report MUST compute the average number of days between creation and last update for completed meldingen +- **AND** the result MUST be included in the summary section as a single metric value + +#### Scenario: Percentage calculation +- **GIVEN** schema `meldingen` with 200 total objects, 125 with status `afgehandeld` +- **WHEN** a calculated metric is defined as: `{"name": "afhandel_percentage", "expression": "COUNT(status='afgehandeld') / COUNT(*) * 100"}` +- **THEN** the metric MUST evaluate to `62.5` +- **AND** the result MUST be formatted with one decimal place + +#### Scenario: Conditional KPI with threshold +- **GIVEN** a calculated metric "SLA compliance" defined as: percentage of meldingen resolved within 5 business days +- **AND** the template defines thresholds: green >= 90%, yellow >= 75%, red < 75% +- **WHEN** the report generates and finds 85% compliance +- **THEN** the metric MUST display `85.0%` with a `yellow` indicator +- **AND** the threshold metadata MUST be included in the response for frontend rendering + +### Requirement: Reports and exports MUST enforce RBAC permissions +All reporting operations MUST enforce the same RBAC rules as the standard object retrieval pipeline. Users MUST only see aggregated data and exported records for objects and properties they are authorized to access. This extends the existing `PermissionHandler`, `MagicRbacHandler`, and `PropertyRbacHandler` enforcement already applied in `ExportService::fetchObjectsForExport()`. + +#### Scenario: RBAC-filtered aggregation +- **GIVEN** user `medewerker-1` has read access to schema `meldingen` but NOT to schema `vertrouwelijk` +- **WHEN** `medewerker-1` requests a cross-schema aggregate on register `zaken` +- **THEN** the aggregation MUST include only `meldingen` objects +- **AND** `vertrouwelijk` objects MUST be excluded from all counts, sums, and averages +- **AND** no error MUST be returned (transparent RBAC filtering) + +#### Scenario: Property-level RBAC on report columns +- **GIVEN** schema `personen` has property `bsn` with authorization restricting read access to group `privacy-officers` +- **AND** user `medewerker-1` is NOT in group `privacy-officers` +- **WHEN** `medewerker-1` generates a report from template +- **THEN** the `bsn` column MUST be excluded from the data table section +- **AND** the companion `_bsn` column MUST also be excluded +- **AND** any aggregation on the `bsn` field MUST be rejected with HTTP 403 + +#### Scenario: Admin-only metadata in reports +- **GIVEN** user `admin` is in the `admin` group +- **WHEN** admin generates a detailed report +- **THEN** `@self.*` metadata columns (created, updated, owner, organisation, locked, deleted) MUST be available +- **AND** non-admin users MUST NOT see these columns in reports (per `ExportService::getHeaders()` admin check) + +### Requirement: The system MUST support report caching for performance +Aggregation query results and generated report files MUST be cached to avoid redundant computation. Cache invalidation MUST occur when objects in the aggregated register-schema pair are created, updated, or deleted. The caching layer SHALL use the same APCu/Redis infrastructure already used by `FacetCacheHandler` and `SchemaCacheHandler`. + +#### Scenario: Cache aggregation query results +- **GIVEN** an aggregation query on schema `meldingen` with 50,000 objects takes 2 seconds +- **WHEN** the same query is repeated within the cache TTL (default: 5 minutes) +- **THEN** the cached result MUST be returned in under 50ms +- **AND** the response MUST include a `X-Cache: HIT` header + +#### Scenario: Invalidate cache on data change +- **GIVEN** a cached aggregation result for schema `meldingen` +- **WHEN** a new `meldingen` object is created via the objects API +- **THEN** the cache key for `meldingen` aggregations MUST be invalidated +- **AND** the next aggregation query MUST execute fresh and return updated counts + +#### Scenario: Cache scheduled report output +- **GIVEN** a scheduled report that generates a 5MB PDF every Monday +- **WHEN** 3 users download the same report on Monday afternoon +- **THEN** the PDF MUST be generated only once (during the scheduled job) +- **AND** subsequent downloads MUST serve the stored file from Nextcloud Files + +### Requirement: The system MUST support WOO transparency reporting +The system MUST generate reports that satisfy Dutch WOO (Wet Open Overheid) transparency requirements. WOO reports MUST include: document categories (besluitenlijsten, vergaderstukken, onderzoeksrapporten), publication status per category, compliance metrics (percentage published within statutory deadlines), and export in a format suitable for submission to the WOO platform (PLOOI/PlatformOpenOverheidsinformatie). + +#### Scenario: WOO compliance dashboard data +- **GIVEN** register `woo-publicaties` with schema `documenten` containing properties: categorie, publicatiedatum, wettelijke_deadline, publicatiestatus +- **WHEN** the API receives `GET /api/reports/woo-compliance?register=woo-publicaties&year=2025` +- **THEN** the response MUST include per-category counts: total documents, published on time, published late, not yet published +- **AND** overall compliance percentage: `(published_on_time / total) * 100` +- **AND** the response format MUST be suitable for rendering a WOO compliance dashboard + +#### Scenario: WOO annual report generation +- **GIVEN** WOO publication data for the year 2025 +- **WHEN** an administrator generates the annual WOO transparency report +- **THEN** the system MUST produce a PDF report containing: + - Total documents per information category (11 WOO categories) + - Publication timeliness statistics + - Trend comparison with previous year + - List of documents with publication status +- **AND** the report MUST be suitable for inclusion in the organisation's jaarverslag + +#### Scenario: WOO data export for PLOOI submission +- **GIVEN** 200 documents marked for WOO publication +- **WHEN** the administrator exports for PLOOI submission +- **THEN** the system MUST generate an export package containing document metadata in the PLOOI-compatible format +- **AND** each document record MUST include: identifier, title, category, publication date, and document reference + +### Requirement: The system MUST support audit report generation +The system MUST generate audit reports from the existing `AuditTrailMapper` data, showing who accessed, created, modified, or deleted which objects and when. Audit reports extend the existing `DashboardService::getAuditTrailStatistics()` and `DashboardService::getAuditTrailActionChartData()` with downloadable report output. + +#### Scenario: Generate audit report for a date range +- **GIVEN** register `zaken` with audit trail data for March 2026 +- **WHEN** an administrator requests `GET /api/reports/audit?register=zaken&from=2026-03-01&to=2026-03-31&format=xlsx` +- **THEN** the Excel file MUST contain one row per audit trail entry with columns: timestamp, action (create/read/update/delete), object UUID, object name, user ID, IP address, changes summary +- **AND** the report MUST be sorted by timestamp descending +- **AND** only administrators MUST be able to generate audit reports + +#### Scenario: Audit report with action distribution chart +- **GIVEN** audit data showing 500 creates, 1200 reads, 800 updates, 50 deletes in the period +- **WHEN** the audit report includes a summary section +- **THEN** the summary MUST include action distribution as already computed by `DashboardService::getAuditTrailActionDistribution()` +- **AND** the most active objects list as computed by `DashboardService::getMostActiveObjects()` + +#### Scenario: User activity audit report +- **GIVEN** an administrator needs a report of all actions by user `medewerker-1` +- **WHEN** they request `GET /api/reports/audit?userId=medewerker-1&from=2026-03-01&to=2026-03-31` +- **THEN** the report MUST contain only audit trail entries for `medewerker-1` +- **AND** the summary MUST include total actions by type and most-accessed objects + +### Requirement: The system MUST enforce multi-tenant reporting isolation +In multi-tenant deployments, reports MUST only include objects belonging to the requesting user's organisation. Cross-tenant data MUST never appear in reports, aggregations, or exports. This extends the existing multi-tenancy enforcement in `ExportService::fetchObjectsForExport()` (which passes `_multitenancy: true` to `ObjectService::searchObjects()`). + +#### Scenario: Tenant-isolated aggregation +- **GIVEN** a multi-tenant deployment with organisations `gemeente-utrecht` and `gemeente-amsterdam` +- **AND** both organisations have `meldingen` objects in the same register +- **WHEN** a user from `gemeente-utrecht` requests an aggregation on `meldingen` +- **THEN** the aggregation MUST include only `gemeente-utrecht` objects +- **AND** `gemeente-amsterdam` objects MUST be completely invisible +- **AND** the `_multitenancy` flag from `ExportService::fetchObjectsForExport()` MUST be applied + +#### Scenario: Scheduled report respects tenant context +- **GIVEN** a scheduled report owned by a user from `gemeente-utrecht` +- **WHEN** the `ScheduledReportJob` runs in the Nextcloud cron context +- **THEN** the job MUST execute with the report owner's tenant context +- **AND** the generated report MUST contain only `gemeente-utrecht` data + +#### Scenario: Admin can request cross-tenant report +- **GIVEN** a system administrator (instance admin, not tenant admin) +- **WHEN** they request an aggregation with parameter `_multi=false` (disable multi-tenancy filter) +- **THEN** the response MUST include data from all tenants +- **AND** this capability MUST be restricted to instance administrators only + +### Requirement: The system MUST provide an OData v4 endpoint for external BI tool integration +An OData v4 compatible endpoint MUST be available for integration with Power BI, Tableau, QlikView, and other BI tools that support OData data sources. The endpoint SHALL translate OData query parameters (`$filter`, `$select`, `$orderby`, `$top`, `$skip`, `$count`) to OpenRegister's internal query format using `MagicSearchHandler` as the backend. + +#### Scenario: Connect Power BI to OData endpoint +- **GIVEN** the OData endpoint is configured for register `zaken` with schema `meldingen` +- **WHEN** Power BI connects to `GET /api/odata/{register}/{schema}` with OData query parameters +- **THEN** the endpoint MUST return an OData v4 JSON response with `@odata.context`, `@odata.count`, and `value` array +- **AND** the endpoint MUST support `$filter`, `$select`, `$orderby`, `$top`, `$skip`, and `$count` parameters +- **AND** the OData service document at `GET /api/odata/` MUST list all available register-schema pairs as entity sets + +#### Scenario: OData authentication and RBAC +- **GIVEN** an OData endpoint request with Basic Auth credentials +- **WHEN** the credentials map to user `medewerker-1` +- **THEN** the endpoint MUST enforce the same RBAC rules as the REST API +- **AND** schemas the user cannot access MUST NOT appear in the service document +- **AND** property-level RBAC MUST filter the `$select` results + +#### Scenario: OData pagination for large datasets +- **GIVEN** schema `meldingen` contains 50,000 objects +- **WHEN** Power BI requests the first page without `$top` +- **THEN** the endpoint MUST return a default page size of 100 objects +- **AND** include `@odata.nextLink` for the next page +- **AND** Power BI MUST be able to follow `@odata.nextLink` to retrieve all pages + +#### Scenario: OData filter translation +- **GIVEN** Power BI sends `$filter=status eq 'nieuw' and created gt 2026-01-01` +- **WHEN** the OData controller parses the filter +- **THEN** it MUST translate to the equivalent OpenRegister query: `{"status": "nieuw", "@self.created>": "2026-01-01"}` +- **AND** execute the query via `ObjectService::searchObjects()` with RBAC enforcement + +### Requirement: The system MUST support API access for external BI tools beyond OData +For BI tools that do not support OData (or prefer REST/JDBC), the existing REST API MUST support query parameters that enable efficient data extraction: cursor-based pagination for full data sync, `_fields` parameter for column selection, `_format` parameter for response format (JSON, CSV, JSONL), and `If-Modified-Since` headers for incremental sync. + +#### Scenario: Full data sync with cursor pagination +- **GIVEN** an external ETL tool needs to sync all 50,000 `meldingen` objects +- **WHEN** it sends `GET /api/objects/{register}/{schema}?_limit=1000&_cursor=` repeatedly +- **THEN** each page MUST return 1000 objects sorted by a stable cursor (UUID or internal ID) +- **AND** the response MUST include `_nextCursor` for the next page +- **AND** the full sync MUST complete without missing or duplicating objects + +#### Scenario: Incremental sync with If-Modified-Since +- **GIVEN** an ETL tool last synced at 2026-03-18T00:00:00Z +- **WHEN** it sends `GET /api/objects/{register}/{schema}?_limit=1000` with header `If-Modified-Since: 2026-03-18T00:00:00Z` +- **THEN** the response MUST include only objects created or updated after the specified timestamp +- **AND** deleted objects MUST be indicated with `_includeDeleted=true` parameter support + +#### Scenario: JSONL format for streaming to data pipelines +- **GIVEN** a data pipeline tool requests `GET /api/objects/{register}/{schema}?_format=jsonl&_limit=999999` +- **WHEN** the response is generated +- **THEN** each line MUST be a complete JSON object (JSON Lines format per RFC 7464) +- **AND** the Content-Type MUST be `application/x-ndjson` +- **AND** the response MUST stream without buffering the full dataset in memory + +## Current Implementation Status +- **Implemented -- CSV export**: `ExportHandler` (`lib/Service/Object/ExportHandler.php`) supports CSV export via `ExportService::exportToCsv()` with RBAC-aware header generation and multi-tenancy support. +- **Implemented -- Excel (XLSX) export**: `ExportHandler` supports Excel export via `ExportService::exportToExcel()` using PhpSpreadsheet `Xlsx` writer, with two-pass UUID-to-name resolution via `resolveUuidNameMap()`, companion name columns via `identifyNameCompanionColumns()`, and admin-only `@self.*` metadata columns. +- **Implemented -- CSV/Excel import**: `ExportHandler::import()` handles CSV and Excel file import, delegating to `ImportService::importFromCsv()` and `ImportService::importFromExcel()`. +- **Implemented -- RBAC on exports**: Export pipeline passes through `ObjectService::searchObjects()` with `_rbac: true` and property-level filtering via `PropertyRbacHandler::canReadProperty()` in header generation. +- **Implemented -- Basic statistics**: `MagicStatisticsHandler` provides `getStatistics()` (total/deleted/locked counts), `getRegisterChartData()` and `getSchemaChartData()` (labels + series for chart rendering), and `getStatisticsGroupedBySchema()` for batch statistics. +- **Implemented -- Dashboard aggregation**: `DashboardService` provides `getRegistersWithSchemas()` with per-register/schema statistics, `getAuditTrailStatistics()`, `getAuditTrailActionDistribution()`, `getMostActiveObjects()`, and chart data endpoints for audit trail actions, objects by register, objects by schema, and objects by size. +- **Implemented -- Operational metrics**: `MetricsService` records and aggregates operational metrics (files processed, embeddings, search latency, storage growth) with `getDashboardMetrics()` for a metrics overview. +- **Implemented -- Faceting infrastructure**: `FacetHandler`, `MagicFacetHandler`, `HyperFacetHandler`, `MariaDbFacetHandler`, `OptimizedFacetHandler`, and `SolrFacetProcessor` provide comprehensive faceting with caching -- this is the foundation for aggregation queries. +- **Implemented -- Configuration export**: `Configuration/ExportHandler` handles register/schema configuration export in OpenAPI 3.0.0 format (separate from data export). +- **Not implemented -- PDF export**: No PDF generation service or library. No report formatting with titles, summary statistics, or paginated tables. +- **Not implemented -- ODS export**: No `PhpSpreadsheet\Writer\Ods` integration. +- **Not implemented -- General-purpose aggregation API**: No `/aggregate` endpoint with `groupBy`, `metric`, `sum`, `avg`, `min`, `max`, or time-series bucketing. The faceting infrastructure provides categorical counts but not numeric aggregations. +- **Not implemented -- OData v4 endpoint**: No OData protocol support. No `$filter`, `$select`, `$orderby` OData query translation. +- **Not implemented -- Scheduled report generation**: No `ScheduledReportJob` or cron-based report generation. No report delivery via Nextcloud Files or notifications. +- **Not implemented -- Report templates**: No configurable report template system. +- **Not implemented -- Period-over-period comparison**: No comparison API endpoint. +- **Not implemented -- Custom calculated metrics**: No expression engine for computed fields. +- **Not implemented -- WOO transparency reporting**: No WOO-specific report endpoints or PLOOI export format. +- **Not implemented -- Report caching**: Aggregation results are not cached (facet caching exists but is separate). +- **Not implemented -- Cursor-based pagination**: Current pagination uses offset/limit, not cursor-based. + +## Standards & References +- **OData v4 specification** (https://www.odata.org/documentation/) -- for BI tool integration protocol +- **ISO 32000 (PDF specification)** -- for report generation output format +- **ECMA-376 / ISO/IEC 29500 (Office Open XML)** -- for XLSX format +- **ISO/IEC 26300 (Open Document Format)** -- for ODS format +- **RFC 4180** -- for CSV format +- **RFC 7464** -- for JSON Lines / NDJSON streaming format +- **PhpSpreadsheet** (https://phpspreadsheet.readthedocs.io/) -- already used for XLSX export +- **Dompdf or TCPDF** -- candidate PHP libraries for PDF generation +- **BIO (Baseline Informatiebeveiliging Overheid)** -- data export security and audit logging requirements +- **WOO (Wet Open Overheid)** -- Dutch transparency law requiring publication of government documents in 11 categories +- **PLOOI** -- Platform Open Overheidsinformatie, the national publication platform for WOO documents +- **Common Ground** -- principles for API-based data access in Dutch government +- **Prometheus exposition format** -- for metrics endpoint compatibility (see production-observability spec) +- **WCAG 2.1 AA** -- accessibility for generated PDF reports + +## Cross-References +- **built-in-dashboards** -- Dashboard widgets consume the chart data API and aggregation endpoints defined in this spec. The built-in-dashboards spec handles visual rendering; this spec provides the data layer. +- **production-observability** -- Operational metrics from `MetricsService` (search latency, embedding stats, file processing) are complementary to the business-level reporting in this spec. Prometheus metrics endpoint is defined there. +- **data-import-export** -- Shares `ExportService`, `ExportHandler`, `ImportService` infrastructure. The data-import-export spec covers the import/export pipeline mechanics; this spec covers the reporting, aggregation, and BI integration layer built on top. +- **mock-registers** -- Mock register data (seed data) can be used to validate report templates and aggregation queries during development. + +## Specificity Assessment +- **Well-specified**: Aggregation API patterns (count/sum/avg/groupBy/interval), export format support (extending existing CSV/Excel with PDF/ODS), RBAC enforcement (leveraging existing PropertyRbacHandler/MagicRbacHandler), multi-tenancy isolation, and OData endpoint requirements. +- **Implementation-anchored**: Requirements reference specific existing classes (`MagicStatisticsHandler`, `ExportService`, `DashboardService`, `FacetHandler`, `MetricsService`) and their methods, providing clear extension points. +- **Remaining decisions**: + - PDF library choice: Dompdf (HTML-to-PDF, easier templating) vs. TCPDF (lower-level, more control) vs. Docudesk delegation (if available) + - Aggregation query execution: SQL-level GROUP BY via MagicMapper extension vs. application-level aggregation of search results (former preferred for performance) + - OData library: Use an existing PHP OData library (e.g., POData) or custom OData controller translating to internal query format + - Report template storage: dedicated schema vs. app config vs. Nextcloud Files + - Scheduled report scheduler: TimedJob (hourly check) vs. cron expression evaluation + - WOO category mapping: hardcoded 11 WOO categories vs. configurable category list + +## Nextcloud Integration Analysis + +**Status**: Partially implemented. CSV and Excel export work via `ExportHandler` and `ExportService` (PhpSpreadsheet) with comprehensive RBAC enforcement. Dashboard statistics and chart data are available via `DashboardService` and `MagicStatisticsHandler`. Faceting infrastructure provides categorical counts. PDF export, aggregation API, OData endpoints, scheduled reports, WOO reporting, and report templates are not built. + +**Nextcloud Core Interfaces**: +- `TimedJob` (`OCP\BackgroundJob\TimedJob`): Use for scheduled report generation. A `ScheduledReportJob` runs hourly, checks for due reports based on cron expressions, generates the output, and delivers it. Already proven with `SolrNightlyWarmupJob` and `ConfigurationCheckJob`. +- `QueuedJob` (`OCP\BackgroundJob\QueuedJob`): Use for async report generation when triggered by user request. When a user requests a large PDF report or complex aggregation, enqueue a `ReportGenerationJob` that generates the file and stores it in Nextcloud Files, avoiding HTTP timeout issues. +- `IDashboardWidget` / `IAPIWidgetV2` (`OCP\Dashboard`): Register report summary widgets on the Nextcloud home dashboard. Widgets display key metrics (total cases, open cases, monthly trends) fetched from the aggregation API. +- `IMailer` (`OCP\Mail\IMailer`): Available for direct email delivery of scheduled reports, but the preferred approach is n8n workflow integration for SMTP delivery (avoids SMTP configuration in Nextcloud). +- `INotifier` (`OCP\Notification\INotifier`): Notify users when scheduled or async reports are ready for download. +- `ICacheFactory` (`OCP\ICacheFactory`): Use for aggregation result caching. The same APCu/Redis factory used by `FacetCacheHandler` provides distributed cache for report data. +- `IUserSession` / `PermissionHandler` / `MagicRbacHandler` / `PropertyRbacHandler`: Enforce RBAC on all export and reporting operations. Already integrated in the export pipeline. + +**Implementation Approach**: +- For the aggregation API, extend `MagicMapper` with a new `aggregate()` method that builds SQL `GROUP BY` queries with `COUNT`, `SUM`, `AVG`, `MIN`, `MAX` on magic table columns. For time-series, use SQL date functions (`DATE_FORMAT` on MySQL, `TO_CHAR` on PostgreSQL) for interval bucketing. When Solr/Elasticsearch is configured, delegate to their native aggregation/facet APIs via `SearchBackendInterface`. +- For PDF export, integrate Dompdf into `ExportService`. Create HTML report templates that use NL Design System CSS variables for government-branded output. Alternatively, if Docudesk provides PDF generation capabilities, delegate to it. +- For OData v4, create an `ODataController` that translates OData query parameters to OpenRegister's internal query format. The service document auto-generates entity sets from register/schema definitions. Use `MagicSearchHandler` as the query backend. +- For scheduled reports, create a `ScheduledReportEntity` storing report definitions (template reference, schedule cron expression, delivery target). A `ScheduledReportJob` (extending `TimedJob`) runs hourly, checks for due reports, generates them, and delivers via Nextcloud Files or notifications. +- For WOO reporting, create WOO-specific aggregation logic that maps schema properties to the 11 WOO document categories and calculates compliance against statutory publication deadlines. + +**Dependencies on Existing OpenRegister Features**: +- `ExportHandler` / `ExportService` -- existing CSV/Excel export pipeline, to be extended with PDF and ODS. +- `ObjectService::searchObjects()` -- data retrieval with filtering, RBAC, and multi-tenancy for report data pipelines. +- `MagicStatisticsHandler` -- existing statistics (counts, chart data), foundation for the aggregation API. +- `MagicFacetHandler` / `FacetHandler` -- existing faceting infrastructure with caching, to be leveraged for categorical aggregations. +- `DashboardService` / `DashboardController` -- existing dashboard data endpoints, to be extended with report-specific endpoints. +- `AuditTrailMapper` -- audit trail data for audit report generation. +- `PermissionHandler` / `MagicRbacHandler` / `PropertyRbacHandler` -- RBAC enforcement across all reporting operations. +- `MetricsService` -- operational metrics, complementary to business reporting. +- `FacetCacheHandler` / `SchemaCacheHandler` -- caching patterns to replicate for report caching. diff --git a/openspec/changes/rbac-scopes/specs/rbac-scopes/spec.md b/openspec/changes/rbac-scopes/specs/rbac-scopes/spec.md new file mode 100644 index 000000000000..e5a3783883db --- /dev/null +++ b/openspec/changes/rbac-scopes/specs/rbac-scopes/spec.md @@ -0,0 +1,415 @@ +--- +status: draft +--- +# RBAC Scopes + +## Purpose +Validate and extend OpenRegister's existing three-level RBAC system. The core RBAC is already implemented via PermissionHandler (schema-level), MagicRbacHandler (row-level SQL filtering), and PropertyRbacHandler (field-level). + +## ADDED Requirements + + +### Requirement: Scope Model Hierarchy (Register > Schema > Object > Property) +The RBAC scope model SHALL follow a four-level hierarchy: register-level scopes govern access to an entire register, schema-level scopes control CRUD operations per schema (zaaktype/objecttype), object-level scopes apply to individual records via conditional matching, and property-level scopes restrict visibility and mutability of specific fields. Each level MUST be independently configurable via the `authorization` JSON structure on the Schema entity. + +#### Scenario: Schema-level authorization defines CRUD scopes +- **GIVEN** schema `bezwaarschriften` has authorization: `{ "read": ["juridisch-team"], "create": ["juridisch-team"], "update": ["juridisch-team"], "delete": ["admin"] }` +- **WHEN** OAS is generated for the register containing this schema +- **THEN** the scopes `juridisch-team` and `admin` MUST appear in `components.securitySchemes.oauth2.flows.authorizationCode.scopes` +- **AND** the GET endpoints MUST list `juridisch-team` in their `security` requirements +- **AND** the DELETE endpoint MUST list `admin` in its `security` requirements + +#### Scenario: Property-level authorization contributes additional scopes +- **GIVEN** schema `inwoners` has property `bsn` with authorization: `{ "read": [{ "group": "bsn-geautoriseerd" }], "update": [{ "group": "bsn-geautoriseerd" }] }` +- **AND** schema-level authorization allows group `kcc-team` to read +- **WHEN** `OasService::extractSchemaGroups()` processes this schema +- **THEN** `readGroups` MUST include both `kcc-team` and `bsn-geautoriseerd` +- **AND** `updateGroups` MUST include `bsn-geautoriseerd` +- **AND** both groups MUST appear as OAuth2 scopes in the generated OAS + +#### Scenario: Object-level conditional scopes produce group entries without match details +- **GIVEN** schema `meldingen` has authorization: `{ "read": [{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }] }` +- **WHEN** `OasService::extractGroupFromRule()` processes this conditional rule +- **THEN** the extracted group MUST be `behandelaars` (the `match` conditions are not reflected in the OAS scope, only in runtime enforcement) +- **AND** `behandelaars` MUST appear as an OAuth2 scope with description `Access for behandelaars group` + +#### Scenario: Schema with no authorization produces no extra scopes +- **GIVEN** schema `tags` has no `authorization` block (null or empty) +- **WHEN** `OasService::extractSchemaGroups()` processes this schema +- **THEN** `createGroups`, `readGroups`, `updateGroups`, and `deleteGroups` MUST all be empty arrays +- **AND** the schema's endpoints MUST NOT have operation-level `security` overrides +- **AND** the global-level security definition at the OAS document root SHALL apply + +#### Scenario: Scope hierarchy is flattened for OAS (no nesting) +- **GIVEN** a register with 3 schemas, each having different group rules at schema-level and property-level +- **WHEN** OAS is generated +- **THEN** all unique group names across all schemas and properties MUST be collected into a single flat `scopes` object in `components.securitySchemes.oauth2.flows.authorizationCode.scopes` +- **AND** duplicate group names MUST be deduplicated (each group appears only once) + + +### Requirement: Permission Types (read, create, update, delete, list) +The system MUST support five distinct permission types in authorization rules: `read` (get a single object), `create` (post a new object), `update` (put/patch an existing object), `delete` (remove an object), and implicitly `list` (query a collection, treated as `read` in the current implementation). Each permission type MUST map to the corresponding HTTP method in the generated OAS security requirements. + +#### Scenario: GET operations use read groups +- **GIVEN** a schema where read authorization references groups `public` and `behandelaars` +- **WHEN** OAS is generated for the GET collection and GET single-item endpoints +- **THEN** both operations MUST have a `security` array including `{ "oauth2": ["public", "behandelaars", "admin"] }` +- **AND** both MUST include `{ "basicAuth": [] }` as an alternative authentication method + +#### Scenario: POST operations use create groups +- **GIVEN** a schema where create authorization references group `intake-medewerkers` +- **WHEN** OAS is generated for the POST endpoint +- **THEN** the operation `security` MUST include `{ "oauth2": ["intake-medewerkers", "admin"] }` +- **AND** the `admin` group MUST always be included even if not explicitly listed in the schema authorization + +#### Scenario: PUT/PATCH operations use update groups +- **GIVEN** a schema where update authorization references groups `behandelaars` and `redacteuren` +- **WHEN** OAS is generated for the PUT endpoint +- **THEN** the operation `security` MUST include `{ "oauth2": ["behandelaars", "redacteuren", "admin"] }` + +#### Scenario: DELETE operations use delete groups (falling back to update groups) +- **GIVEN** a schema with explicit delete authorization: `{ "delete": ["admin"] }` +- **WHEN** OAS is generated for the DELETE endpoint +- **THEN** the operation `security` MUST include `{ "oauth2": ["admin"] }` + +#### Scenario: List and single-get share read permission +- **GIVEN** schema `producten` with `read: ["public"]` +- **WHEN** a user queries GET `/api/objects/{register}/{schema}` (list) or GET `/api/objects/{register}/{schema}/{id}` (single) +- **THEN** both endpoints MUST enforce the same `read` authorization groups +- **AND** `MagicRbacHandler::applyRbacFilters()` MUST be called with action `read` for list queries +- **AND** `PermissionHandler::hasPermission()` MUST be called with action `read` for single-get operations + + +### Requirement: Role Definitions and Hierarchy +The system MUST enforce a clear role hierarchy: `admin` > object owner > named Nextcloud groups > `authenticated` pseudo-group > `public` pseudo-group. Each level in the hierarchy MUST be consistently evaluated across `PermissionHandler`, `PropertyRbacHandler`, `MagicRbacHandler`, and `OasService`. + +#### Scenario: Admin group always has full access and is always included in scopes +- **GIVEN** a register where schemas do NOT explicitly mention `admin` in their authorization rules +- **WHEN** OAS is generated +- **THEN** `admin` MUST still appear in `components.securitySchemes.oauth2.flows.authorizationCode.scopes` with description `Full administrative access` +- **AND** `admin` MUST be included in the OAuth2 scopes for POST, PUT, and DELETE operation security requirements +- **AND** at runtime, `PermissionHandler::hasPermission()` MUST return `true` immediately when `in_array('admin', $userGroups)` is true + +#### Scenario: Object owner bypasses schema-level RBAC +- **GIVEN** user `jan` created object `melding-1` (owner = `jan`) +- **AND** schema `meldingen` restricts update to group `beheerders` +- **AND** `jan` is NOT in group `beheerders` +- **WHEN** `jan` updates `melding-1` +- **THEN** `PermissionHandler::hasGroupPermission()` MUST return `true` because `$objectOwner === $userId` +- **AND** owner bypass is NOT reflected in OAS scopes (it is a runtime policy, not an API scope) + +#### Scenario: Public pseudo-group grants unauthenticated access +- **GIVEN** schema `producten` has `read: ["public"]` +- **WHEN** an unauthenticated HTTP request reads producten objects +- **THEN** `PermissionHandler::hasPermission()` MUST detect `$user === null` and check the `public` group +- **AND** `MagicRbacHandler::processSimpleRule('public')` MUST return `true` +- **AND** the OAS scope for `public` MUST have description `Public (unauthenticated) access` + +#### Scenario: Authenticated pseudo-group grants access to any logged-in user +- **GIVEN** schema `feedback` has authorization: `{ "create": ["authenticated"] }` +- **WHEN** any logged-in Nextcloud user creates a feedback object +- **THEN** `MagicRbacHandler::processSimpleRule('authenticated')` MUST return `true` when `$userId !== null` +- **AND** `authenticated` MUST appear as an OAuth2 scope in the OAS with description `Access for authenticated group` + +#### Scenario: Logged-in users inherit public permissions +- **GIVEN** schema `producten` has `read: ["public"]` +- **AND** user `jan` is logged in but not in any special group +- **WHEN** `jan` reads producten +- **THEN** `PermissionHandler::hasPermission()` MUST check the `public` group as a fallback after evaluating the user's actual groups +- **AND** access MUST be granted because logged-in users have at least public-level access + + +### Requirement: Scope Inheritance (Register Permissions Cascade to Schemas) +When a register defines default authorization rules, those defaults SHALL cascade to all schemas that do not define their own authorization. Schema-level authorization, when present, MUST override the register defaults entirely (most-specific-wins principle). + +#### Scenario: Schema without authorization inherits register defaults +- **GIVEN** register `catalogi` has a default authorization: `{ "read": ["public"], "create": ["beheerders"], "update": ["beheerders"], "delete": ["admin"] }` +- **AND** schema `producten` has NO authorization block +- **WHEN** `PermissionHandler::hasPermission()` evaluates access for `producten` +- **THEN** the register's default authorization SHOULD be used as the effective authorization +- **AND** the OAS endpoints for `producten` SHOULD reflect the register's default groups + +#### Scenario: Schema with explicit authorization overrides register defaults +- **GIVEN** register `catalogi` has default authorization allowing `public` read +- **AND** schema `interne-notities` has explicit authorization: `{ "read": ["redacteuren"] }` +- **WHEN** OAS is generated and RBAC is enforced +- **THEN** `interne-notities` MUST use its own authorization rules, NOT the register defaults +- **AND** only `redacteuren` (and `admin`) MUST appear in the read scopes for `interne-notities` endpoints + +#### Scenario: Mixed register with inherited and explicit schemas +- **GIVEN** register `catalogi` with default auth and 3 schemas: `producten` (no auth), `diensten` (no auth), `interne-notities` (explicit auth) +- **WHEN** OAS is generated +- **THEN** `producten` and `diensten` operations MUST use register-level scopes +- **AND** `interne-notities` operations MUST use its own explicit scopes +- **AND** all unique groups from both sources MUST appear in the global OAuth2 scopes + + +### Requirement: Conditional Scopes with Dynamic Variables +Authorization rules MUST support conditional matching where access depends on both group membership AND runtime conditions evaluated against the object's data. The system MUST resolve dynamic variables `$organisation`, `$userId`/`$user`, and `$now` at query time via `MagicRbacHandler::resolveDynamicValue()` and `ConditionMatcher::resolveDynamicValue()`. + +#### Scenario: Organisation-scoped access via $organisation variable +- **GIVEN** schema `zaken` has authorization: `{ "read": [{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }] }` +- **AND** user `jan` is in group `behandelaars` with active organisation UUID `abc-123` +- **WHEN** `jan` queries zaken +- **THEN** `MagicRbacHandler::resolveDynamicValue('$organisation')` MUST return `abc-123` via `OrganisationService::getActiveOrganisation()` +- **AND** the SQL condition MUST be `t._organisation = 'abc-123'` +- **AND** the OAS scope MUST show `behandelaars` (the conditional match is enforced at runtime, not in the OAS) + +#### Scenario: User-scoped access via $userId variable +- **GIVEN** schema `taken` has authorization: `{ "read": [{ "group": "medewerkers", "match": { "assignedTo": "$userId" } }] }` +- **AND** user `jan` (UID: `jan`) is in group `medewerkers` +- **WHEN** `jan` queries taken +- **THEN** `MagicRbacHandler::resolveDynamicValue('$userId')` MUST return `jan` +- **AND** only taken where `assigned_to = 'jan'` MUST be returned +- **AND** the OAS scope MUST list `medewerkers` without exposing the `$userId` match + +#### Scenario: Time-based conditional access via $now variable +- **GIVEN** schema `publicaties` has authorization: `{ "read": [{ "group": "public", "match": { "publishDate": { "$lte": "$now" } } }] }` +- **WHEN** an unauthenticated user queries publicaties +- **THEN** `MagicRbacHandler::resolveDynamicValue('$now')` MUST return the current datetime in `Y-m-d H:i:s` format +- **AND** only publicaties with `publish_date <= NOW()` MUST be returned +- **AND** the OAS scope MUST list `public` for the GET operation + +#### Scenario: Multiple match conditions require AND logic +- **GIVEN** a rule: `{ "group": "behandelaars", "match": { "_organisation": "$organisation", "status": "open" } }` +- **WHEN** a user in `behandelaars` queries objects +- **THEN** `MagicRbacHandler::buildMatchConditions()` MUST combine both conditions with SQL AND logic +- **AND** both `_organisation` and `status` conditions MUST be satisfied for an object to be returned + +#### Scenario: Conditional rule on create skips organisation matching +- **GIVEN** property `interneAantekening` has authorization: `{ "update": [{ "group": "public", "match": { "_organisation": "$organisation" } }] }` +- **WHEN** a user creates a new object (no existing object data yet) +- **THEN** `ConditionMatcher::filterOrganisationMatchForCreate()` MUST remove `_organisation` from match conditions +- **AND** if the remaining match is empty, access MUST be granted + + +### Requirement: Nextcloud Group Mapping +Every RBAC scope MUST map directly to a Nextcloud group managed via `OCP\IGroupManager`. The system SHALL NOT maintain a separate group/role database. Group membership changes in Nextcloud (including LDAP/SAML/OIDC-synced groups) MUST take effect immediately for subsequent RBAC evaluations without requiring any OpenRegister-specific synchronisation. + +#### Scenario: Nextcloud group becomes an OAuth2 scope +- **GIVEN** Nextcloud has groups: `admin`, `kcc-team`, `juridisch-team`, `redacteuren` +- **AND** schema `bezwaarschriften` uses `juridisch-team` in its authorization +- **WHEN** OAS is generated +- **THEN** `juridisch-team` MUST appear in the OAuth2 scopes +- **AND** the scope description MUST be `Access for juridisch-team group` + +#### Scenario: LDAP-synced group is immediately usable in RBAC +- **GIVEN** Nextcloud syncs group `vth-behandelaars` from LDAP +- **AND** user `jan` is added to `vth-behandelaars` in LDAP +- **WHEN** `jan` authenticates and `IGroupManager::getUserGroupIds()` is called +- **THEN** `vth-behandelaars` MUST be in the returned group list +- **AND** `PermissionHandler::hasPermission()` MUST grant access to schemas authorising `vth-behandelaars` + +#### Scenario: SAML group assertion maps to RBAC scope +- **GIVEN** Nextcloud's `user_saml` app maps SAML group assertion `urn:gov:team:juridisch` to Nextcloud group `juridisch-team` +- **WHEN** user authenticates via SAML and accesses OpenRegister +- **THEN** the user's group memberships (including `juridisch-team`) MUST be used for all RBAC checks +- **AND** no OpenRegister-specific group synchronisation MUST be required + + +### Requirement: Scope Resolution Algorithm (Most Specific Wins) +When multiple authorization levels apply to the same request, the system MUST resolve them using a "most specific wins" algorithm: property-level authorization overrides schema-level for that property, schema-level overrides register-level, and conditional rules (with `match`) are more specific than unconditional rules. The `admin` group and object ownership bypass all resolution. + +#### Scenario: Property-level auth restricts access within an otherwise-permitted schema +- **GIVEN** schema `dossiers` allows group `behandelaars` to read (schema-level) +- **AND** property `interneAantekening` restricts read to group `redacteuren` (property-level) +- **AND** user `jan` is in `behandelaars` but NOT in `redacteuren` +- **WHEN** `jan` reads a dossier object +- **THEN** schema-level check via `PermissionHandler::hasPermission()` MUST pass +- **AND** `PropertyRbacHandler::filterReadableProperties()` MUST remove `interneAantekening` from the response +- **AND** all other fields MUST still be returned + +#### Scenario: Unconditional group rule grants broader access than conditional rule +- **GIVEN** schema `meldingen` has authorization: `{ "read": ["public", { "group": "behandelaars", "match": { "_organisation": "$organisation" } }] }` +- **WHEN** an unauthenticated user queries meldingen +- **THEN** `MagicRbacHandler::processSimpleRule('public')` MUST return `true` (unconditional access) +- **AND** the conditional `behandelaars` rule MUST NOT restrict the public access + +#### Scenario: Admin bypasses all resolution levels +- **GIVEN** a user in the `admin` group +- **WHEN** they access any schema, property, or object +- **THEN** `PermissionHandler::hasPermission()` MUST return `true` immediately +- **AND** `PropertyRbacHandler::isAdmin()` MUST return `true`, skipping all property filtering +- **AND** `MagicRbacHandler::applyRbacFilters()` MUST return without adding WHERE clauses + + +### Requirement: OAS Scope Generation from RBAC Configuration +`OasService` MUST dynamically generate OAuth2 scopes from the RBAC configuration of all schemas in a register. The `BaseOas.json` template MUST NOT contain hardcoded `read`/`write` scopes; scopes SHALL be populated entirely from schema and property authorization rules at generation time. + +#### Scenario: Extract and deduplicate groups across all schemas +- **GIVEN** register `zaken` with 3 schemas, each referencing overlapping groups +- **WHEN** `OasService::createOas()` iterates schemas and calls `extractSchemaGroups()` for each +- **THEN** `$allGroups` MUST be the union of all `createGroups`, `readGroups`, `updateGroups`, and `deleteGroups` across schemas +- **AND** `admin` MUST always be appended to `$allGroups` +- **AND** `array_unique()` MUST deduplicate the combined list + +#### Scenario: Scope descriptions follow naming conventions +- **GIVEN** extracted groups: `admin`, `public`, `behandelaars`, `juridisch-team` +- **WHEN** `OasService::getScopeDescription()` generates descriptions +- **THEN** `admin` MUST have description `Full administrative access` +- **AND** `public` MUST have description `Public (unauthenticated) access` +- **AND** `behandelaars` MUST have description `Access for behandelaars group` +- **AND** `juridisch-team` MUST have description `Access for juridisch-team group` + +#### Scenario: Per-operation security requirements applied via applyRbacToOperation +- **GIVEN** schema `meldingen` has `readGroups: ["public", "behandelaars"]` and `updateGroups: ["behandelaars"]` +- **WHEN** `OasService::addCrudPaths()` generates path operations +- **THEN** the GET operation MUST have `security: [{ "oauth2": ["admin", "public", "behandelaars"] }, { "basicAuth": [] }]` +- **AND** the PUT operation MUST have `security: [{ "oauth2": ["admin", "behandelaars"] }, { "basicAuth": [] }]` +- **AND** the 403 Forbidden response MUST be added to operations with RBAC restrictions + +#### Scenario: BaseOas.json has empty scopes placeholder +- **GIVEN** the base template file `BaseOas.json` +- **WHEN** it is loaded before RBAC processing +- **THEN** `components.securitySchemes.oauth2.flows.authorizationCode.scopes` MUST be an empty object `{}` +- **AND** the dynamic scope generation in `createOas()` MUST populate it based on schema RBAC + +#### Scenario: Register with no RBAC still has valid security schemes +- **GIVEN** a register where no schemas have authorization blocks +- **WHEN** OAS is generated +- **THEN** `components.securitySchemes` MUST still contain `basicAuth` and `oauth2` +- **AND** the OAuth2 scopes object MUST contain at least `{ "admin": "Full administrative access" }` + + +### Requirement: Scope Caching for Performance +The system MUST cache frequently evaluated permission data to avoid repeated database and LDAP lookups within the same request lifecycle. Active organisation UUID, user group memberships, and schema authorization configurations SHOULD be resolved once per request and reused. + +#### Scenario: MagicRbacHandler caches active organisation UUID +- **GIVEN** user `jan` with active organisation `org-uuid-1` +- **WHEN** `MagicRbacHandler::getActiveOrganisationUuid()` is called multiple times within one request (e.g., across multiple schema queries) +- **THEN** the first call MUST resolve via `OrganisationService::getActiveOrganisation()` and store in `$this->cachedActiveOrg` +- **AND** subsequent calls MUST return the cached value without calling OrganisationService again + +#### Scenario: ConditionMatcher caches active organisation UUID independently +- **GIVEN** `ConditionMatcher` is used for property-level RBAC within the same request +- **WHEN** `ConditionMatcher::getActiveOrganisationUuid()` is called +- **THEN** it MUST cache the result in its own `$this->cachedActiveOrg` field +- **AND** subsequent calls within the same request MUST return the cached value + +#### Scenario: RBAC at SQL level avoids post-fetch filtering +- **GIVEN** schema `meldingen` with conditional RBAC rules +- **WHEN** `MagicRbacHandler::applyRbacFilters()` adds WHERE clauses to the QueryBuilder +- **THEN** filtering MUST happen at the database query level +- **AND** unauthorised objects MUST never be loaded into PHP memory +- **AND** pagination counts MUST reflect only the accessible result set + +#### Scenario: OAS generation caches extracted groups per schema +- **GIVEN** `OasService::createOas()` processes 10 schemas +- **WHEN** `extractSchemaGroups()` is called for each schema +- **THEN** the results MUST be stored in `$schemaRbacMap` keyed by schema ID +- **AND** each schema's RBAC groups MUST be reused when generating path operations without re-extraction + + +### Requirement: Multi-Tenancy Integration with Scopes +RBAC scopes MUST integrate with the multi-tenancy system so that organisation-based data isolation works alongside group-based access control. When RBAC conditional rules match on non-`_organisation` fields, they MUST be able to bypass the default multi-tenancy filter, as determined by `MagicRbacHandler::hasConditionalRulesBypassingMultitenancy()`. + +#### Scenario: Organisation filtering combined with RBAC +- **GIVEN** user `jan` has active organisation `org-uuid-1` and is in group `behandelaars` +- **AND** schema `meldingen` has RBAC: `{ "read": [{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }] }` +- **WHEN** `jan` lists meldingen +- **THEN** `MagicRbacHandler::applyRbacFilters()` MUST add `t._organisation = 'org-uuid-1'` as a SQL condition +- **AND** `MultiTenancyTrait` filtering MUST be coordinated to avoid double-filtering + +#### Scenario: Conditional RBAC bypasses multi-tenancy for cross-org field matching +- **GIVEN** schema `catalogi` has RBAC: `{ "read": [{ "group": "catalogus-beheerders", "match": { "aanbieder": "$organisation" } }] }` +- **AND** user `jan` is in `catalogus-beheerders` with active organisation `org-1` +- **WHEN** `MagicRbacHandler::hasConditionalRulesBypassingMultitenancy()` evaluates the rules +- **THEN** it MUST detect `aanbieder` as a non-`_organisation` match field +- **AND** multi-tenancy filtering MUST be bypassed, allowing RBAC's `aanbieder = 'org-1'` condition to handle filtering instead + +#### Scenario: Admin users see all organisations +- **GIVEN** a user in the `admin` group +- **WHEN** they query any register +- **THEN** `MagicRbacHandler::applyRbacFilters()` MUST return without filtering (admin bypass) +- **AND** multi-tenancy filtering MUST also be bypassed for admin users + + +### Requirement: Scope Audit (Who Has Access to What) +The system MUST provide mechanisms to determine which groups/users have access to which schemas and properties, supporting compliance auditing and access reviews. + +#### Scenario: Extract authorised groups per schema for audit reporting +- **GIVEN** a register with 5 schemas, each with different authorization configurations +- **WHEN** an administrator queries the effective permissions via `PermissionHandler::getAuthorizedGroups()` for each schema and action +- **THEN** the system MUST return the list of group IDs that have permission for each CRUD action +- **AND** an empty array MUST indicate "all groups have permission" (no authorization configured) + +#### Scenario: OAS specification serves as a machine-readable access audit +- **GIVEN** the generated OAS for a register +- **WHEN** an auditor examines `components.securitySchemes.oauth2.flows.authorizationCode.scopes` +- **THEN** all groups that have any access to any endpoint MUST be listed +- **AND** each operation's `security` block MUST show exactly which groups can access that endpoint +- **AND** the 403 response in RBAC-protected operations MUST indicate that authorization is enforced + +#### Scenario: Property-level audit via schema inspection +- **GIVEN** schema `inwoners` with properties `naam` (no auth), `bsn` (auth: `bsn-geautoriseerd`), `adres` (auth: `adres-geautoriseerd`) +- **WHEN** `Schema::getPropertiesWithAuthorization()` is called +- **THEN** it MUST return `{ "bsn": { "read": [...], "update": [...] }, "adres": { "read": [...], "update": [...] } }` +- **AND** `naam` MUST NOT appear in the result (it has no property-level authorization) + +#### Scenario: Security event logging for access decisions +- **GIVEN** `SecurityService` logs authentication events (success, failure, lockout) +- **WHEN** RBAC denies access to a schema or property +- **THEN** `PermissionHandler` MUST log a warning with the user, schema, action, and denial reason +- **AND** the log entry MUST be queryable for compliance reviews + + +### Requirement: Default Scopes for New Registers and Schemas +When a new register or schema is created without explicit authorization configuration, the system MUST apply sensible defaults that ensure security without blocking legitimate access. + +#### Scenario: New schema without authorization allows all authenticated access +- **GIVEN** a user creates a new schema `notities` without setting any `authorization` block +- **WHEN** `PermissionHandler::hasPermission()` evaluates access for `notities` +- **THEN** `$authorization` MUST be `null` or empty +- **AND** `hasGroupPermission()` MUST return `true` (no authorization = open access to all) +- **AND** the generated OAS MUST NOT have per-operation `security` overrides for `notities` endpoints + +#### Scenario: New register inherits no authorization defaults +- **GIVEN** a new register is created +- **WHEN** schemas are added to the register without explicit authorization +- **THEN** each schema MUST independently default to open access (no inherited restrictions) +- **AND** administrators SHOULD be prompted or advised to configure authorization before production use + +#### Scenario: Adding authorization to an existing open schema +- **GIVEN** schema `notities` currently has no authorization (open access) +- **WHEN** an administrator adds `{ "read": ["medewerkers"], "create": ["medewerkers"] }` +- **THEN** the new authorization MUST take effect on the next request (after OPcache refresh) +- **AND** previously-open endpoints MUST now enforce the new group requirements +- **AND** the OAS MUST be regenerated to include the new scopes + + +### Requirement: API Scope Enforcement Across All Access Methods +RBAC scopes MUST be enforced consistently across all access methods: REST API, GraphQL, MCP tools, search, and data export. The enforcement MUST use the same `PermissionHandler`, `PropertyRbacHandler`, and `MagicRbacHandler` for all methods. + +#### Scenario: REST API enforces scopes via PermissionHandler +- **GIVEN** user `medewerker-1` in group `kcc-team` +- **AND** schema `bezwaarschriften` allows only `juridisch-team` +- **WHEN** `medewerker-1` sends GET `/api/objects/{register}/bezwaarschriften` +- **THEN** `PermissionHandler::checkPermission()` MUST throw an Exception +- **AND** the HTTP response MUST be 403 Forbidden + +#### Scenario: GraphQL enforces scopes identically to REST +- **GIVEN** the same schema and user as above +- **WHEN** `medewerker-1` sends a GraphQL query for `bezwaarschriften` +- **THEN** `PermissionHandler::checkPermission()` MUST be called with action `read` +- **AND** the same authorization rules MUST be evaluated + +#### Scenario: Cross-schema GraphQL queries enforce per-schema scopes +- **GIVEN** user can read `orders` (schema-level) but NOT `klanten` (schema-level) +- **WHEN** they query `order { title klant { naam } }` via GraphQL +- **THEN** `klant` MUST return `null` with a partial error at `["order", "klant"]` with `extensions.code: "FORBIDDEN"` +- **AND** the `title` field MUST still return data (partial success) + +#### Scenario: MCP tools enforce scopes via Nextcloud auth +- **GIVEN** an MCP client authenticated via Basic Auth as user `api-user` +- **AND** `api-user` is in group `kcc-team` but not `juridisch-team` +- **WHEN** the MCP client invokes `mcp__openregister__objects` with action `list` on schema `bezwaarschriften` +- **THEN** RBAC MUST be enforced using `api-user`'s group memberships +- **AND** access to `bezwaarschriften` MUST be denied if `kcc-team` is not in the authorization rules + +#### Scenario: Search results respect RBAC scopes +- **GIVEN** user `jan` in group `sociale-zaken` +- **AND** schema `meldingen` has conditional RBAC matching on `_organisation` +- **WHEN** `jan` searches for meldingen via the search API +- **THEN** `MagicRbacHandler::applyRbacFilters()` MUST filter results at the query level +- **AND** facet counts MUST reflect only the accessible objects + diff --git a/openspec/changes/rbac-zaaktype/specs/rbac-zaaktype/spec.md b/openspec/changes/rbac-zaaktype/specs/rbac-zaaktype/spec.md new file mode 100644 index 000000000000..d24d58968af0 --- /dev/null +++ b/openspec/changes/rbac-zaaktype/specs/rbac-zaaktype/spec.md @@ -0,0 +1,528 @@ +--- +status: partial +--- + +# RBAC per Zaaktype + +## Purpose +Define zaaktype-scoped authorization as an abstract extension of OpenRegister's existing RBAC system. This spec does NOT introduce a new authorization engine — it defines how the existing PermissionHandler and MagicRbacHandler conditional rules can be configured to enforce zaaktype-level access control, as required by the ZGW Autorisaties API. The core RBAC infrastructure (schema-level permissions, property-level filtering, database-level SQL conditions, admin bypass, conditional matching with operators) is already fully implemented. This spec documents how that infrastructure maps to zaaktype-scoped CRUD permissions, ZGW Autorisaties API compliance (including vertrouwelijkheidaanduiding enforcement), role-to-zaaktype mapping with per-zaaktype role differentiation, cross-zaaktype coordinator access, permission-aware UI rendering, audit logging of zaaktype-level access decisions, and multi-tenant zaaktype isolation — enabling fine-grained data compartmentalization across departments that is required by 86% of analyzed government tenders. + +**Tender demand**: 86% of analyzed government tenders require RBAC per zaaktype. Dimpact ZAC implements 51+ individual permissions across 5 policy domains with per-zaaktype role differentiation via PABC. Valtimo uses PBAC with conditional permission records evaluated at query time. OpenRegister achieves equivalent functionality through Nextcloud group-based authorization on schemas with conditional matching, avoiding external policy engines. + +## Relationship to Existing Implementation +This spec is a configuration and extension layer on top of existing RBAC infrastructure: + +- **Schema-level RBAC = zaaktype RBAC (fully implemented)**: Each schema maps to a zaaktype. The existing `PermissionHandler::hasPermission()` already enforces per-schema CRUD authorization using Nextcloud groups. Zaaktype-scoped access is achieved by configuring schema `authorization` blocks — no new code needed for basic zaaktype RBAC. +- **Conditional matching = vertrouwelijkheidaanduiding (fully implemented)**: `MagicRbacHandler` with `$in` operator conditions already supports confidentiality-level filtering. Vertrouwelijkheidaanduiding enforcement is a configuration concern using existing operators. +- **Admin bypass (fully implemented)**: `PermissionHandler` checks `in_array('admin', $userGroups)` and returns `true` immediately — maps directly to ZGW `heeftAlleAutorisaties`. +- **Multi-tenancy integration (fully implemented)**: `MultiTenancyTrait` and `MagicRbacHandler::hasConditionalRulesBypassingMultitenancy()` already handle organisation-scoped zaaktype access. +- **Consumer identity mapping (fully implemented)**: `Consumer` entity maps ZGW Applicatie to Nextcloud user, whose group memberships define effective zaaktype scopes. +- **Audit trail (partially implemented)**: `AuditTrail` entity exists with `confidentiality` field, but specific `rbac.permission_granted`/`rbac.permission_revoked` events are not yet logged. +- **What this spec adds**: User-level permission overrides (delegation), permission matrix UI, bulk permission assignment/templates, delegation with expiry, register-level default authorization cascade, and VNG compliance test suite. + +## Requirements + +### Requirement: Authorization policies MUST be configurable per schema (zaaktype) +Each schema in a register MUST support an authorization policy that defines which Nextcloud groups or users may perform CRUD operations on its objects. The authorization block on the schema entity SHALL be the primary mechanism for zaaktype-scoped access control, where each schema maps to a zaaktype or objecttype. + +#### Scenario: Define read-only access for a group on a specific zaaktype +- **GIVEN** a register `zaken` with schema `bezwaarschriften` (representing zaaktype "Bezwaarschrift") +- **AND** group `juridisch-team` is granted `read` permission on `bezwaarschriften` +- **WHEN** a user in `juridisch-team` attempts to list bezwaarschriften objects +- **THEN** the system MUST return the objects +- **AND** when the same user attempts to create or update a bezwaarschrift +- **THEN** the system MUST return HTTP 403 Forbidden + +#### Scenario: Define full CRUD access for a group on a zaaktype +- **GIVEN** schema `vergunningen` with authorization: `{ "read": ["vth-behandelaars"], "create": ["vth-behandelaars"], "update": ["vth-behandelaars"], "delete": ["vth-behandelaars"] }` +- **WHEN** a user in `vth-behandelaars` creates, reads, updates, or deletes a vergunning object +- **THEN** all operations MUST succeed +- **AND** `PermissionHandler::hasPermission()` MUST return `true` for each action + +#### Scenario: Deny access to unauthorized users for a zaaktype +- **GIVEN** schema `bezwaarschriften` with only `juridisch-team` authorized for all CRUD operations +- **WHEN** a user NOT in `juridisch-team` attempts any CRUD operation on bezwaarschriften +- **THEN** the system MUST return HTTP 403 Forbidden +- **AND** `PermissionHandler::checkPermission()` MUST throw an Exception with message containing "does not have permission" +- **AND** the schema MUST NOT appear in the user's schema listing when using RBAC-filtered queries + +#### Scenario: Separate read and write permissions per zaaktype +- **GIVEN** schema `meldingen-openbare-ruimte` with authorization: `{ "read": ["kcc-team", "behandelaars"], "create": ["kcc-team"], "update": ["behandelaars"], "delete": ["admin"] }` +- **WHEN** a user in `kcc-team` (but not `behandelaars`) creates a melding +- **THEN** the create operation MUST succeed +- **AND** when the same user attempts to update the melding +- **THEN** the system MUST return HTTP 403 Forbidden (user can create but not update) + +#### Scenario: Multiple groups authorized for the same zaaktype action +- **GIVEN** schema `klachten` with authorization: `{ "read": ["kcc-team", "juridisch-team", "management"] }` +- **WHEN** a user in any of those three groups reads klachten +- **THEN** access MUST be granted because `PermissionHandler::hasPermission()` iterates over all user groups and returns `true` on first match + +### Requirement: Authorization policies MUST support user-level overrides for delegation +Individual users MUST be grantable permissions independent of group membership to support delegation scenarios such as external advisors, temporary assignments, and escalation paths. User-level overrides SHALL take precedence over group-level denials. + +#### Scenario: Delegated access for a single user on a zaaktype +- **GIVEN** schema `personeelszaken` restricted to group `hr-team` +- **AND** user `extern-adviseur` is individually granted `read` on `personeelszaken` via user-level override +- **WHEN** `extern-adviseur` lists personeelszaken objects +- **THEN** the system MUST return the objects +- **AND** `extern-adviseur` MUST NOT be able to write or delete (only explicitly granted permissions apply) + +#### Scenario: Temporary delegation with expiry +- **GIVEN** schema `bezwaarschriften` restricted to group `juridisch-team` +- **AND** user `vervanger-1` is granted temporary `read,update` access with expiry date `2026-04-01` +- **WHEN** `vervanger-1` accesses bezwaarschriften before the expiry date +- **THEN** access MUST be granted +- **AND** after `2026-04-01`, the delegation MUST automatically expire and access MUST be denied + +#### Scenario: Delegation does not affect group permissions +- **GIVEN** user `jan` is in group `kcc-team` which has `read` on schema `meldingen` +- **AND** `jan` is individually granted `update` on `meldingen` via delegation +- **WHEN** `jan` reads or updates a melding +- **THEN** both operations MUST succeed (group `read` + delegated `update` are combined) +- **AND** revoking the delegation MUST NOT affect `jan`'s group-based `read` permission + +### Requirement: Role-to-zaaktype mapping MUST support per-zaaktype role differentiation +The system MUST support a model where a user can have different roles for different zaaktypes, analogous to ZGW's per-zaaktype autorisatie model and Dimpact ZAC's PABC architecture. This SHALL be achieved through Nextcloud group naming conventions that encode both the role and the zaaktype scope. + +#### Scenario: User has different roles for different zaaktypes +- **GIVEN** user `behandelaar-1` is in groups `vergunningen-behandelaar` and `klachten-raadpleger` +- **AND** schema `vergunningen` has authorization: `{ "read": ["vergunningen-behandelaar", "vergunningen-raadpleger"], "update": ["vergunningen-behandelaar"] }` +- **AND** schema `klachten` has authorization: `{ "read": ["klachten-raadpleger", "klachten-behandelaar"], "update": ["klachten-behandelaar"] }` +- **WHEN** `behandelaar-1` reads klachten +- **THEN** access MUST be granted (via `klachten-raadpleger` group) +- **AND** when `behandelaar-1` updates a klacht, access MUST be denied (not in `klachten-behandelaar`) +- **AND** when `behandelaar-1` updates a vergunning, access MUST be granted (in `vergunningen-behandelaar`) + +#### Scenario: Wildcard domain group grants access to all zaaktypes of a role level +- **GIVEN** group `elk-zaaktype-raadpleger` is referenced in multiple schema authorization rules via a shared group pattern +- **AND** user `manager-1` is in group `elk-zaaktype-raadpleger` +- **WHEN** `manager-1` reads objects from any schema that includes `elk-zaaktype-raadpleger` in its `read` authorization +- **THEN** access MUST be granted across all those schemas + +#### Scenario: Role hierarchy through group composition +- **GIVEN** the role hierarchy: raadpleger (read-only) < behandelaar (read+write) < coordinator (read+write+assign) < beheerder (all) +- **AND** user `coordinator-1` is in groups `vergunningen-coordinator`, `vergunningen-behandelaar`, `vergunningen-raadpleger` +- **WHEN** `coordinator-1` performs any operation on vergunningen +- **THEN** the cumulative permissions from all groups MUST be combined (union of permissions) + +### Requirement: The system MUST enforce a zaaktype x operation x role permission matrix +Administrators MUST be able to configure and view a permission matrix that maps (zaaktype/schema) x (CRUD operation) x (role/group) combinations. This matrix SHALL be the canonical representation of all zaaktype-scoped access control rules. + +#### Scenario: View permission matrix for a register +- **GIVEN** a register `zaakregistratie` with 5 schemas (zaaktypen) and 4 groups +- **WHEN** the admin navigates to the register's authorization settings +- **THEN** a matrix MUST be displayed with schemas as rows and groups as columns +- **AND** each cell MUST show read/create/update/delete checkboxes reflecting current permissions from each schema's `authorization` block + +#### Scenario: Edit permissions via the matrix view +- **GIVEN** the permission matrix is displayed for register `zaakregistratie` +- **WHEN** the admin checks the `update` checkbox for schema `klachten` and group `kcc-team` +- **THEN** the schema's `authorization.update` array MUST be updated to include `kcc-team` +- **AND** the change MUST take effect immediately for subsequent API requests + +#### Scenario: Matrix reflects conditional authorization rules +- **GIVEN** schema `meldingen` has authorization: `{ "read": [{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }] }` +- **WHEN** the permission matrix is displayed +- **THEN** the `read` cell for `behandelaars` on `meldingen` MUST show a conditional indicator (e.g., icon or tooltip) +- **AND** hovering/clicking MUST reveal the match condition: `_organisation = $organisation` + +#### Scenario: Export permission matrix as CSV +- **GIVEN** a register with 20 schemas and 10 groups +- **WHEN** the admin exports the permission matrix +- **THEN** a CSV file MUST be generated with columns: schema, group, read, create, update, delete, conditions +- **AND** each row MUST represent one schema-group combination + +### Requirement: The system MUST support vertrouwelijkheidaanduiding (confidentiality levels) per zaaktype +The ZGW standard defines 8 confidentiality levels (vertrouwelijkheidaanduiding) that MUST be enforceable per zaaktype. Each role/group MUST have a maximum vertrouwelijkheidaanduiding (maxVertrouwelijkheidaanduiding) that limits which objects they can access within a zaaktype based on the object's confidentiality level. + +#### Scenario: Object filtered by vertrouwelijkheidaanduiding +- **GIVEN** schema `zaken` has a property `vertrouwelijkheidaanduiding` with type `string` and enum values: `openbaar`, `beperkt_openbaar`, `intern`, `zaakvertrouwelijk`, `vertrouwelijk`, `confidentieel`, `geheim`, `zeer_geheim` +- **AND** the authorization rule for group `kcc-team` includes a conditional match: `{ "group": "kcc-team", "match": { "vertrouwelijkheidaanduiding": { "$in": ["openbaar", "beperkt_openbaar", "intern"] } } }` +- **WHEN** a user in `kcc-team` lists zaken +- **THEN** `MagicRbacHandler::applyRbacFilters()` MUST add a SQL WHERE clause filtering on the vertrouwelijkheidaanduiding field +- **AND** only zaken with vertrouwelijkheidaanduiding `openbaar`, `beperkt_openbaar`, or `intern` MUST be returned +- **AND** zaken with `vertrouwelijk` or higher MUST NOT be visible + +#### Scenario: Higher clearance group sees more confidential objects +- **GIVEN** group `management` has authorization with match: `{ "vertrouwelijkheidaanduiding": { "$in": ["openbaar", "beperkt_openbaar", "intern", "zaakvertrouwelijk", "vertrouwelijk", "confidentieel"] } }` +- **AND** group `kcc-team` has match: `{ "vertrouwelijkheidaanduiding": { "$in": ["openbaar", "beperkt_openbaar", "intern"] } }` +- **WHEN** a user in `management` and a user in `kcc-team` both list the same schema +- **THEN** the management user MUST see objects up to `confidentieel` +- **AND** the kcc-team user MUST only see objects up to `intern` + +#### Scenario: Admin bypasses vertrouwelijkheidaanduiding filtering +- **GIVEN** a user in the `admin` group +- **WHEN** they list objects from any schema regardless of vertrouwelijkheidaanduiding +- **THEN** all objects MUST be returned because `PermissionHandler::hasPermission()` returns `true` immediately for admin group members + +#### Scenario: Vertrouwelijkheidaanduiding enforcement on single object access +- **GIVEN** a user in `kcc-team` with maxVertrouwelijkheidaanduiding `intern` +- **AND** object `zaak-123` has `vertrouwelijkheidaanduiding: "vertrouwelijk"` +- **WHEN** the user sends GET `/api/objects/{register}/{schema}/zaak-123` +- **THEN** the system MUST return HTTP 403 Forbidden +- **AND** the response MUST NOT leak the object's data + +#### Scenario: Confidentiality level hierarchy ordering +- **GIVEN** the ZGW vertrouwelijkheidaanduiding enum with ordering: `openbaar` (1) < `beperkt_openbaar` (2) < `intern` (3) < `zaakvertrouwelijk` (4) < `vertrouwelijk` (5) < `confidentieel` (6) < `geheim` (7) < `zeer_geheim` (8) +- **WHEN** comparing confidentiality levels for access decisions +- **THEN** the system MUST use ordinal comparison (lower number = less restrictive) +- **AND** a user with maxVertrouwelijkheidaanduiding at level N MUST be able to access objects at level N or below + +### Requirement: Cross-zaaktype access MUST be supported for coordinator and management roles +Users with coordinator or management roles MUST be able to access objects across multiple zaaktypes for work distribution, reporting, and oversight purposes, without requiring individual zaaktype-level permissions for each schema. + +#### Scenario: Coordinator with cross-zaaktype read access +- **GIVEN** user `coordinator-1` is in group `alle-zaken-coordinator` +- **AND** schemas `vergunningen`, `klachten`, `meldingen` all include `alle-zaken-coordinator` in their `read` authorization +- **WHEN** `coordinator-1` lists objects from any of those schemas +- **THEN** access MUST be granted for all three schemas + +#### Scenario: Management dashboard aggregates across zaaktypes +- **GIVEN** user `manager-1` is in group `management` which has `read` on all zaaktype schemas +- **WHEN** `manager-1` queries a cross-schema aggregation endpoint (e.g., GraphQL query spanning multiple schemas) +- **THEN** objects from all authorized schemas MUST be returned +- **AND** schemas where `management` is NOT in the `read` authorization MUST be excluded + +#### Scenario: Coordinator can reassign across zaaktypes +- **GIVEN** user `coordinator-1` has `update` permission on both `vergunningen` and `klachten` schemas +- **WHEN** `coordinator-1` updates a vergunning object's `assignedTo` field +- **THEN** the update MUST succeed +- **AND** `coordinator-1` MUST also be able to update a klacht object's `assignedTo` field in the same session + +### Requirement: Permission checks MUST apply to all API endpoints consistently +All REST API endpoints (list, get, create, update, delete), GraphQL queries and mutations, MCP tool invocations, and public endpoints MUST enforce the zaaktype-scoped authorization policy via `PermissionHandler::checkPermission()` before processing the request. + +#### Scenario: REST API request without zaaktype permission +- **GIVEN** an authenticated API consumer mapped to user `api-user` +- **AND** `api-user` has no permissions on schema `vertrouwelijk-zaaktype` +- **WHEN** the consumer sends GET `/api/objects/{register}/vertrouwelijk-zaaktype` +- **THEN** the system MUST return HTTP 403 Forbidden +- **AND** the response body MUST include a clear error message about missing permission + +#### Scenario: REST API request with read-only zaaktype permission +- **GIVEN** `api-user` has `read` on schema `meldingen` +- **WHEN** the consumer sends POST `/api/objects/{register}/meldingen` +- **THEN** the system MUST return HTTP 403 Forbidden +- **AND** GET requests MUST succeed +- **AND** the error message MUST indicate that `create` permission is required + +#### Scenario: GraphQL query enforces zaaktype RBAC +- **GIVEN** user `medewerker-1` has `read` on schema `vergunningen` but NOT on `bezwaarschriften` +- **WHEN** `medewerker-1` executes a GraphQL query: `{ vergunningen { edges { node { title } } } bezwaarschriften { edges { node { title } } } }` +- **THEN** `vergunningen` data MUST be returned +- **AND** `bezwaarschriften` MUST return a partial error with `extensions.code: "FORBIDDEN"` + +#### Scenario: MCP tool invocation enforces zaaktype RBAC +- **GIVEN** an MCP client authenticated as user `mcp-user` +- **AND** `mcp-user` has `read` on schema `meldingen` but NOT `create` +- **WHEN** the MCP client calls `mcp__openregister__objects` with action `create` on the `meldingen` schema +- **THEN** the MCP response MUST contain an error indicating insufficient permissions + +#### Scenario: Bulk operations enforce per-object zaaktype permission +- **GIVEN** a user submits a bulk update request affecting 50 objects across 3 schemas +- **AND** the user has `update` on 2 of the 3 schemas +- **THEN** objects in authorized schemas MUST be updated +- **AND** objects in the unauthorized schema MUST be rejected with individual error entries +- **AND** a partial success response MUST be returned + +### Requirement: The frontend MUST render permission-aware UI components +The frontend application MUST adapt its UI based on the current user's zaaktype permissions, hiding or disabling actions the user cannot perform and omitting schemas the user cannot access. + +#### Scenario: Schema list filters based on user permissions +- **GIVEN** a register with 10 schemas (zaaktypen) +- **AND** the current user has `read` permission on 6 of them +- **WHEN** the user views the register's schema list in the UI +- **THEN** only the 6 accessible schemas MUST be displayed +- **AND** the 4 inaccessible schemas MUST NOT appear in navigation or listing + +#### Scenario: CRUD buttons disabled based on zaaktype permissions +- **GIVEN** a user has `read` on schema `vergunningen` but NOT `create` or `delete` +- **WHEN** the user views the vergunningen object list +- **THEN** the "New" / "Create" button MUST be hidden or disabled +- **AND** the "Delete" action on individual objects MUST be hidden or disabled +- **AND** the "Edit" action MUST be hidden or disabled (no `update` permission) + +#### Scenario: Form fields reflect property-level RBAC within a zaaktype +- **GIVEN** schema `zaken` has property `interneAantekening` with authorization: `{ "read": [{ "group": "redacteuren" }], "update": [{ "group": "redacteuren" }] }` +- **AND** the user is NOT in group `redacteuren` +- **WHEN** the user views a zaak object detail page +- **THEN** the `interneAantekening` field MUST NOT be rendered in the form +- **AND** `PropertyRbacHandler::filterReadableProperties()` MUST have omitted it from the API response + +#### Scenario: Confidentiality badge displayed for restricted objects +- **GIVEN** objects with varying `vertrouwelijkheidaanduiding` levels are displayed in a list +- **WHEN** the user views the list +- **THEN** each object MUST display a visual indicator of its confidentiality level (e.g., badge or icon) +- **AND** objects near the user's maximum clearance SHOULD display a warning indicator + +### Requirement: All zaaktype access decisions MUST be logged in the audit trail +Every access attempt (granted or denied) against a zaaktype-scoped schema MUST produce an audit trail entry for compliance with BIO (Baseline Informatiebeveiliging Overheid) and AVG requirements. + +#### Scenario: Permission grant event logged +- **GIVEN** admin grants `read,write` on schema `meldingen` to group `kcc-team` +- **THEN** an audit trail entry MUST be created with action `rbac.permission_granted` +- **AND** the entry MUST record the schema UUID, schema title, group name, permissions granted, and the admin user who made the change +- **AND** the entry MUST include a timestamp in ISO 8601 format + +#### Scenario: Permission revocation event logged +- **GIVEN** admin revokes `write` from group `kcc-team` on schema `meldingen` +- **THEN** an audit trail entry MUST be created with action `rbac.permission_revoked` +- **AND** existing sessions of affected users SHOULD have their cached permissions invalidated +- **AND** the audit entry MUST record the previous and new permission states + +#### Scenario: Access denied event logged +- **GIVEN** user `ongeautoriseerd` attempts to read objects from schema `vertrouwelijk` +- **AND** `ongeautoriseerd` has no permissions on `vertrouwelijk` +- **WHEN** the request is denied with HTTP 403 +- **THEN** an audit trail entry MUST be created with action `rbac.access_denied` +- **AND** the entry MUST record: user ID, schema, attempted action, timestamp, IP address +- **AND** the `confidentiality` field on the AuditTrail entity MUST reflect the schema's sensitivity + +#### Scenario: Bulk permission change produces individual audit entries +- **GIVEN** admin assigns permissions on 5 schemas to group `nieuwe-afdeling` in one bulk operation +- **THEN** 5 individual audit trail entries MUST be created (one per schema) +- **AND** each entry MUST be independently queryable + +#### Scenario: Audit trail for vertrouwelijkheidaanduiding-based denial +- **GIVEN** user `kcc-1` with maxVertrouwelijkheidaanduiding `intern` attempts to access object with `vertrouwelijkheidaanduiding: "vertrouwelijk"` +- **WHEN** the request is denied +- **THEN** the audit entry MUST record both the user's max level and the object's actual level +- **AND** the audit entry MUST indicate the denial reason as `confidentiality_level_exceeded` + +### Requirement: Bulk permission assignment MUST be supported for efficient onboarding +Administrators MUST be able to assign a permission template (a set of zaaktype permissions) to a group or user in a single operation, supporting department onboarding and role provisioning. + +#### Scenario: Assign permission template to a new department group +- **GIVEN** a permission template `kcc-standaard` defines: `{ "meldingen": ["read", "create"], "klachten": ["read", "create"], "producten": ["read"] }` +- **AND** a new group `kcc-den-haag` is created +- **WHEN** admin applies template `kcc-standaard` to group `kcc-den-haag` +- **THEN** the authorization blocks of schemas `meldingen`, `klachten`, and `producten` MUST be updated to include `kcc-den-haag` with the specified permissions +- **AND** a single bulk audit trail entry MUST be created referencing all affected schemas + +#### Scenario: Copy permissions from existing group +- **GIVEN** group `kcc-amsterdam` has permissions on 8 schemas +- **WHEN** admin copies all permissions from `kcc-amsterdam` to new group `kcc-rotterdam` +- **THEN** the authorization blocks of all 8 schemas MUST be updated to include `kcc-rotterdam` +- **AND** the permissions MUST be identical to `kcc-amsterdam`'s permissions on each schema + +#### Scenario: Revoke all permissions for a group across all schemas +- **GIVEN** group `vertrekkende-afdeling` has permissions on 12 schemas +- **WHEN** admin revokes all permissions for `vertrekkende-afdeling` +- **THEN** the authorization blocks of all 12 schemas MUST be updated to remove `vertrekkende-afdeling` +- **AND** 12 individual `rbac.permission_revoked` audit entries MUST be created + +### Requirement: Delegation and escalation patterns MUST be supported within zaaktype authorization +The system MUST support delegation (granting temporary access to another user) and escalation (elevating access for a specific case) within the zaaktype authorization framework. + +#### Scenario: Case-specific delegation to another user +- **GIVEN** user `behandelaar-1` is handling case `zaak-456` in schema `vergunningen` +- **AND** `behandelaar-1` delegates `zaak-456` to `collega-2` by updating the object's `_owner` or `assignedTo` field +- **WHEN** `collega-2` accesses `zaak-456` +- **THEN** access MUST be granted via the owner-based access rule in `PermissionHandler::hasGroupPermission()` (where `$objectOwner === $userId`) +- **AND** `collega-2` MUST still require `read` permission on the zaaktype schema to list other objects + +#### Scenario: Escalation to supervisor within same zaaktype +- **GIVEN** case `zaak-789` in schema `bezwaarschriften` needs supervisor review +- **AND** user `supervisor-1` is in group `bezwaarschriften-coordinator` +- **WHEN** `supervisor-1` accesses `zaak-789` +- **THEN** access MUST be granted via the coordinator group's schema-level authorization +- **AND** `supervisor-1` MUST be able to update the case status + +#### Scenario: Cross-zaaktype escalation with temporary delegation +- **GIVEN** case `zaak-101` in schema `vergunningen` requires legal review +- **AND** user `jurist-1` is in group `juridisch-team` which has permissions only on `bezwaarschriften` +- **WHEN** admin grants `jurist-1` temporary individual access to schema `vergunningen` with `read` permission +- **THEN** `jurist-1` MUST be able to read objects in `vergunningen` +- **AND** the delegation MUST NOT affect other users in `juridisch-team` + +### Requirement: ZGW Autorisaties API concepts MUST be mapped to OpenRegister primitives +The system MUST provide a clear mapping from ZGW Autorisaties API concepts (Applicatie, scope, maxVertrouwelijkheidaanduiding, heeftAlleAutorisaties) to OpenRegister's group-based RBAC model, ensuring compliance with VNG standards. + +#### Scenario: ZGW Applicatie maps to Consumer + Nextcloud user +- **GIVEN** a ZGW Applicatie with `clientIds: ["zaaksysteem-1"]` and `heeftAlleAutorisaties: false` +- **WHEN** configured in OpenRegister +- **THEN** a Consumer entity MUST be created with `authorizationType: jwt` and `userId` pointing to a dedicated Nextcloud user +- **AND** the Nextcloud user's group memberships MUST define the Applicatie's effective scopes + +#### Scenario: ZGW scope maps to Nextcloud group +- **GIVEN** the ZGW scopes: `zaken.lezen`, `zaken.aanmaken`, `zaken.bijwerken`, `zaken.verwijderen` +- **WHEN** configuring equivalent access in OpenRegister +- **THEN** Nextcloud groups SHALL be named to match the scope pattern (e.g., `zaken-lezen`, `zaken-aanmaken`) +- **AND** schema authorization blocks SHALL reference these groups: `{ "read": ["zaken-lezen"], "create": ["zaken-aanmaken"], "update": ["zaken-bijwerken"], "delete": ["zaken-verwijderen"] }` + +#### Scenario: ZGW heeftAlleAutorisaties maps to admin group +- **GIVEN** a ZGW Applicatie with `heeftAlleAutorisaties: true` +- **WHEN** the corresponding Nextcloud user is added to the `admin` group +- **THEN** `PermissionHandler::hasPermission()` MUST return `true` immediately for all schemas and actions +- **AND** `MagicRbacHandler::applyRbacFilters()` MUST return without adding WHERE clauses + +#### Scenario: ZGW maxVertrouwelijkheidaanduiding maps to conditional authorization +- **GIVEN** a ZGW Applicatie with autorisatie: `{ "zaaktype": "https://catalogi.nl/zaaktypen/uuid-1", "scopes": ["zaken.lezen"], "maxVertrouwelijkheidaanduiding": "zaakvertrouwelijk" }` +- **WHEN** configured in OpenRegister +- **THEN** the corresponding schema authorization MUST include a conditional match: `{ "group": "zaaksysteem-1-lezen", "match": { "vertrouwelijkheidaanduiding": { "$in": ["openbaar", "beperkt_openbaar", "intern", "zaakvertrouwelijk"] } } }` +- **AND** objects with vertrouwelijkheidaanduiding higher than `zaakvertrouwelijk` MUST be filtered at the database level + +#### Scenario: ZGW Autorisaties API compatibility endpoint +- **GIVEN** the system exposes ZGW-compatible API endpoints via the zgw-api-mapping spec +- **WHEN** an external system queries the equivalent of `/autorisaties/v1/applicaties` +- **THEN** the response MUST be translatable to ZGW Autorisaties API format via Twig mapping templates +- **AND** each Applicatie's scopes MUST reflect the Nextcloud user's effective group-based permissions + +### Requirement: Zaakcatalogus inheritance MUST be supported for zaaktype authorization defaults +When a register models a zaakcatalogus (catalog of zaaktypen), schemas (zaaktypen) within that catalogus SHALL be able to inherit default authorization rules from the catalogus level, with per-zaaktype overrides. + +#### Scenario: Schema inherits default authorization from register +- **GIVEN** register `zaakregistratie` has a default authorization policy: `{ "read": ["alle-medewerkers"], "create": ["behandelaars"] }` +- **AND** schema `standaard-zaak` has no explicit authorization block +- **WHEN** a user in `alle-medewerkers` reads `standaard-zaak` objects +- **THEN** the system MUST fall back to the register's default authorization +- **AND** access MUST be granted + +#### Scenario: Schema-level authorization overrides register defaults +- **GIVEN** register `zaakregistratie` has default authorization allowing `alle-medewerkers` to read +- **AND** schema `vertrouwelijk-zaaktype` has explicit authorization: `{ "read": ["directie"] }` +- **WHEN** a user in `alle-medewerkers` (but NOT `directie`) reads `vertrouwelijk-zaaktype` +- **THEN** the schema-level authorization MUST take precedence +- **AND** access MUST be denied with HTTP 403 + +#### Scenario: New zaaktype automatically inherits catalogus permissions +- **GIVEN** register `zaakregistratie` has default authorization rules +- **WHEN** a new schema is created in `zaakregistratie` without specifying authorization +- **THEN** the new schema MUST inherit the register's default authorization +- **AND** the inherited rules MUST be visible in the schema's authorization configuration + +### Requirement: Multi-tenant zaaktype isolation MUST restrict cross-tenant visibility +In multi-tenant deployments, zaaktype authorization MUST be combined with organisation-level isolation so that users can only access objects belonging to their active organisation AND matching their zaaktype permissions. + +#### Scenario: Same zaaktype, different organisations +- **GIVEN** schema `vergunningen` is used by organisations `gemeente-a` and `gemeente-b` +- **AND** user `behandelaar-a` (active org: `gemeente-a`) is in group `vergunningen-behandelaar` +- **AND** user `behandelaar-b` (active org: `gemeente-b`) is in group `vergunningen-behandelaar` +- **WHEN** `behandelaar-a` lists vergunningen +- **THEN** only vergunningen with `_organisation = gemeente-a` MUST be returned +- **AND** vergunningen from `gemeente-b` MUST NOT be visible + +#### Scenario: Cross-tenant zaaktype access for SaaS administrators +- **GIVEN** user `saas-admin` is in the `admin` group +- **WHEN** `saas-admin` lists vergunningen +- **THEN** vergunningen from ALL organisations MUST be returned +- **AND** `MultiTenancyTrait` MUST be bypassed for admin users + +#### Scenario: RBAC conditional rule with organisation scoping +- **GIVEN** schema `meldingen` has authorization: `{ "read": [{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }] }` +- **AND** user `jan` is in `behandelaars` with active organisation `org-uuid-1` +- **WHEN** `jan` queries meldingen +- **THEN** `MagicRbacHandler::resolveDynamicValue('$organisation')` MUST return `org-uuid-1` +- **AND** the SQL condition MUST include `t._organisation = 'org-uuid-1'` +- **AND** multi-tenancy filtering and RBAC filtering MUST work together additively + +#### Scenario: Organisation switch changes effective zaaktype access +- **GIVEN** user `jan` is a member of two organisations: `gemeente-a` and `gemeente-b` +- **AND** `jan` has `vergunningen-behandelaar` permissions in both +- **WHEN** `jan` switches active organisation from `gemeente-a` to `gemeente-b` +- **THEN** subsequent queries MUST filter on `_organisation = gemeente-b` +- **AND** no data from `gemeente-a` MUST be returned + +### Requirement: Admin users MUST bypass all zaaktype authorization policies +Users with Nextcloud admin or OpenRegister admin role MUST have unrestricted access to all schemas and objects regardless of zaaktype-level authorization configuration. + +#### Scenario: Admin bypasses zaaktype RBAC +- **GIVEN** schema `vertrouwelijk` with access restricted to `directie` group +- **WHEN** a Nextcloud admin user accesses `vertrouwelijk` objects +- **THEN** all CRUD operations MUST succeed regardless of group membership +- **AND** `PermissionHandler::hasPermission()` MUST detect `in_array('admin', $userGroups)` and return `true` immediately + +#### Scenario: Admin sees all zaaktypen in schema listing +- **GIVEN** a register with 15 schemas, each with different authorization groups +- **WHEN** an admin user views the schema listing +- **THEN** all 15 schemas MUST be visible +- **AND** no RBAC filtering MUST be applied to the schema list + +#### Scenario: Admin bypasses vertrouwelijkheidaanduiding restrictions +- **GIVEN** objects with `vertrouwelijkheidaanduiding: "zeer_geheim"` +- **WHEN** an admin user queries these objects +- **THEN** all objects MUST be returned regardless of confidentiality level +- **AND** no SQL WHERE clause for confidentiality MUST be added + +### Requirement: VNG compliance testing MUST validate zaaktype authorization behavior +Automated tests MUST verify that the zaaktype-scoped RBAC implementation complies with ZGW Autorisaties API patterns, ensuring interoperability with other VNG-compliant systems. + +#### Scenario: Test zaaktype-scoped read filtering +- **GIVEN** a test register with 3 schemas and 3 groups with varying permissions +- **WHEN** the VNG compliance test suite runs +- **THEN** each user MUST only see objects from schemas they are authorized for +- **AND** the test MUST verify HTTP 403 for unauthorized schema access +- **AND** the test MUST verify that list endpoints return empty results (not 403) when the user has `read` permission but no objects exist + +#### Scenario: Test vertrouwelijkheidaanduiding filtering +- **GIVEN** objects at all 8 confidentiality levels in a single schema +- **AND** a user with maxVertrouwelijkheidaanduiding `intern` +- **WHEN** the compliance test runs +- **THEN** only objects with levels `openbaar`, `beperkt_openbaar`, and `intern` MUST be returned +- **AND** the test MUST verify exact count matches + +#### Scenario: Test heeftAlleAutorisaties (admin bypass) +- **GIVEN** a user mapped to the `admin` group +- **WHEN** the compliance test accesses all schemas and all confidentiality levels +- **THEN** all requests MUST succeed with HTTP 200 +- **AND** no authorization filtering MUST be applied + +#### Scenario: Test cross-zaaktype isolation between API consumers +- **GIVEN** two API consumers (Consumer entities) with different zaaktype permissions +- **WHEN** each consumer authenticates and queries the same register +- **THEN** each MUST only receive objects from their authorized schemas +- **AND** neither consumer MUST be able to infer the existence of unauthorized schemas from API responses + +## Current Implementation Status +- **Fully implemented -- schema-level RBAC**: `PermissionHandler` (`lib/Service/Object/PermissionHandler.php`) enforces authorization policies per schema. It checks group membership for CRUD operations and returns HTTP 403 for unauthorized access. The handler supports admin bypass via `in_array('admin', $userGroups)`, owner-based access via `$objectOwner === $userId`, and public/authenticated pseudo-groups. +- **Fully implemented -- property-level RBAC within zaaktype**: `PropertyRbacHandler` (`lib/Service/PropertyRbacHandler.php`) enforces field-level authorization within schemas, supporting read/update restrictions per property with conditional matching (group + match conditions). +- **Fully implemented -- database-level RBAC filtering**: `MagicRbacHandler` (`lib/Db/MagicMapper/MagicRbacHandler.php`) applies RBAC filters at the SQL query level with dynamic variable resolution (`$organisation`, `$userId`, `$now`), operator conditions (`$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, `$exists`), ensuring unauthorized objects are never loaded into PHP memory. +- **Fully implemented -- admin bypass**: The `PermissionHandler` checks for admin group membership and bypasses all authorization checks for admin users. `PropertyRbacHandler::isAdmin()` and `MagicRbacHandler` also bypass filtering for admin users. +- **Fully implemented -- conditional authorization**: `ConditionMatcher` (`lib/Service/ConditionMatcher.php`) and `OperatorEvaluator` (`lib/Service/OperatorEvaluator.php`) evaluate conditional RBAC rules with organisation matching, user identity, and custom conditions. This enables vertrouwelijkheidaanduiding filtering via `$in` operator conditions. +- **Fully implemented -- multi-tenancy integration**: `MultiTenancyTrait` (`lib/Db/MultiTenancyTrait.php`) enforces organisation-scoped access alongside RBAC, providing tenant isolation per zaaktype. +- **Fully implemented -- schema authorization configuration**: `Schema` entity (`lib/Db/Schema.php`) stores authorization blocks defining group-based access rules per CRUD operation as JSON. +- **Fully implemented -- audit trail entity**: `AuditTrail` entity (`lib/Db/AuditTrail.php`) includes a `confidentiality` field for recording data sensitivity levels, supporting compliance logging. +- **Partially implemented -- audit trail for RBAC changes**: Audit trail exists for object changes (`AuditTrailController`) but specific `rbac.permission_granted`/`rbac.permission_revoked` events for authorization policy changes are not explicitly logged as discrete audit events. +- **Not implemented -- user-level overrides**: Individual user permissions independent of group membership are not directly supported. Users must be added to groups for authorization. Delegation is possible via object ownership (`_owner` field) but not via user-level permission grants on schemas. +- **Not implemented -- permission matrix UI**: No admin UI displaying a matrix of schemas vs groups with CRUD checkboxes exists. Schema authorization is configured via the schema editor JSON, not a dedicated matrix view. +- **Not implemented -- bulk permission assignment**: No template-based or copy-from-group permission assignment feature exists. Each schema's authorization must be configured individually. +- **Not implemented -- delegation with expiry**: Time-limited user-level permission grants are not supported. Delegation currently relies on object ownership transfer. +- **Not implemented -- register-level default authorization**: Schemas without authorization blocks default to open access; there is no register-level fallback configuration. +- **Not implemented -- VNG compliance test suite**: No automated test suite validates ZGW Autorisaties API compliance specifically. + +## Standards & References +- **ZGW Autorisaties API (VNG)** -- Dutch government authorization API standard defining Applicatie, scopes, maxVertrouwelijkheidaanduiding, and heeftAlleAutorisaties concepts. OpenRegister maps these to Consumer entities, Nextcloud groups, conditional match rules, and admin group membership respectively. +- **Vertrouwelijkheidaanduiding enum (ZGW Catalogi API)** -- 8-level confidentiality classification: `openbaar`, `beperkt_openbaar`, `intern`, `zaakvertrouwelijk`, `vertrouwelijk`, `confidentieel`, `geheim`, `zeer_geheim`. Enforced via conditional `$in` match rules on the vertrouwelijkheidaanduiding property. +- **BIO (Baseline Informatiebeveiliging Overheid)** -- Dutch government baseline information security standard requiring role-based access control, audit trails for access decisions, and confidentiality level enforcement. +- **AVG/GDPR** -- Data compartmentalization requirements mandating that personal data is only accessible to authorized roles with logged access decisions. +- **Nextcloud Group-based access control (IGroupManager)** -- Primary authorization primitive; group memberships drive all RBAC decisions. +- **OAuth 2.0 scopes (RFC 6749)** -- ZGW scopes map to Nextcloud groups which map to OAuth2 scopes in generated OAS (see rbac-scopes spec). +- **Common Ground principles** -- Role-based access in Dutch government systems following the Common Ground architecture. +- **NIST RBAC model (SP 800-162)** -- Reference model for role-based access control with role hierarchies and constraints. + +## Cross-References +- **`auth-system`** -- Defines the authentication layer (multi-auth, Consumer entity, CORS) that resolves identities before zaaktype RBAC is evaluated. The `PermissionHandler` depends on `IUserSession::getUser()` being set by `AuthorizationService`. +- **`rbac-scopes`** -- Maps Nextcloud groups to OAuth2 scopes in generated OAS and documents the ZGW Autorisaties mapping guide. The scope mapping depends on the group-based authorization configured per this spec. +- **`row-field-level-security`** -- Extends zaaktype-level RBAC with row-level security (filtering by field values like `_organisation`) and field-level security (property visibility per group). Uses `MagicRbacHandler` and `PropertyRbacHandler` which are also used for zaaktype RBAC. +- **`zgw-api-mapping`** -- Defines Twig-based field mapping between OpenRegister's English schema properties and ZGW Dutch API fields, including `vertrouwelijkheidaanduiding` enum value mapping via `zgw_enum` filter. +- **`audit-trail-immutable`** -- Provides the immutable audit trail infrastructure that zaaktype access events are logged to. + +## Specificity Assessment +- **Specific and largely implemented**: The core RBAC infrastructure (schema-level, property-level, database-level filtering, admin bypass, conditional matching with operators) is fully in place and supports zaaktype-scoped access control. +- **Well-defined ZGW mapping**: Clear mapping from ZGW Autorisaties API concepts (Applicatie, scope, maxVertrouwelijkheidaanduiding, heeftAlleAutorisaties) to OpenRegister primitives (Consumer, Nextcloud group, conditional match, admin group). +- **Vertrouwelijkheidaanduiding supported via existing operators**: The `$in` operator in conditional match rules already enables confidentiality-level filtering without new code -- only configuration documentation is needed. +- **Competitive parity with Dimpact ZAC**: ZAC's 51+ permissions across 5 policy domains are mapped to OpenRegister's schema-level + property-level authorization with conditional matching, avoiding the need for an external policy engine like OPA. +- **Missing implementations**: + - User-level overrides (delegation without group membership) -- design decision needed: store on schema vs. separate entity + - Permission matrix UI -- frontend development needed for a dedicated matrix view + - RBAC change audit events -- explicit `rbac.permission_granted`/`rbac.permission_revoked` logging + - Bulk permission assignment -- template/copy-from-group functionality + - Register-level default authorization inheritance + - Delegation with expiry -- time-limited permission grants + - VNG compliance test suite -- automated ZGW Autorisaties compatibility tests +- **Open questions**: + - Should user-level overrides be stored on the schema authorization block (as special `user:xxx` entries) or as a separate `SchemaUserPermission` entity? + - Should the permission matrix UI be a standalone page or integrated into the register detail view? + - Should RBAC policy changes be versioned for rollback capability? + - How should the register-level default authorization interact with explicit empty authorization blocks on schemas? diff --git a/openspec/changes/realtime-updates/specs/realtime-updates/spec.md b/openspec/changes/realtime-updates/specs/realtime-updates/spec.md new file mode 100644 index 000000000000..0de8908ffad8 --- /dev/null +++ b/openspec/changes/realtime-updates/specs/realtime-updates/spec.md @@ -0,0 +1,441 @@ +--- +status: implemented +--- + +# Realtime Updates + +## Purpose +Provide live data synchronization to connected clients so that register object mutations (create, update, delete) are pushed immediately without manual page refresh. The system MUST offer Server-Sent Events (SSE) as the primary transport, with Nextcloud's notify_push integration as a complementary channel, and graceful fallback to polling. All realtime channels MUST be authorization-aware, meaning users only receive events for objects their RBAC permissions allow them to see, and MUST support topic-based subscriptions at the register, schema, and individual object level. + +**Source**: Gap identified in cross-platform analysis; PocketBase provides SSE-based realtime subscriptions per collection/record with auth-aware filtering, Directus offers WebSocket connectivity with UID-based subscription management and permission-filtered broadcasts, and five platforms total offer real-time capabilities. See also: `event-driven-architecture` (CloudEvents format, event bus transports), `webhook-payload-mapping` (payload transformation via Twig mappings), `notificatie-engine` (notification channels and batching). + +## Requirements + +### Requirement: The system MUST provide a dedicated SSE endpoint for object change events +A Server-Sent Events endpoint MUST stream object change events (create, update, delete) to connected clients in real time. The endpoint MUST follow the W3C Server-Sent Events specification and use `text/event-stream` content type. The endpoint MUST be separate from the existing GraphQL subscription controller, providing a REST-native channel at `/api/sse/{register}/{schema}`. + +#### Scenario: Client connects to SSE endpoint and receives create event +- **GIVEN** a client is connected to `GET /api/sse/zaken/meldingen` with `Accept: text/event-stream` +- **WHEN** another user creates a new melding object with UUID `melding-new-1` +- **THEN** the connected client MUST receive an SSE message with: + - `id`: a monotonically increasing event ID (e.g., `evt_000042`) + - `event`: `object.created` + - `data`: a JSON object containing `uuid`, `register`, `schema`, `action`, `timestamp` (ISO 8601), and `object` (the full object data including all properties) + +#### Scenario: Client receives update event with changed fields +- **GIVEN** a client is connected to `GET /api/sse/zaken/meldingen` +- **WHEN** melding `melding-1` is updated (status changed from `nieuw` to `in_behandeling`) +- **THEN** the client MUST receive an SSE message with: + - `event`: `object.updated` + - `data`: JSON containing the object UUID, full updated object data, and a `changed` array listing the modified field names (e.g., `["status"]`) + +#### Scenario: Client receives delete event +- **GIVEN** a client is connected to `GET /api/sse/zaken/meldingen` +- **WHEN** object `melding-5` is deleted +- **THEN** the client MUST receive an SSE message with: + - `event`: `object.deleted` + - `data`: JSON containing only the deleted object's UUID, register, and schema (no full object data, as the object no longer exists) + +#### Scenario: SSE response headers are correctly set +- **GIVEN** a client sends `GET /api/sse/zaken/meldingen` +- **WHEN** the server accepts the connection +- **THEN** the response MUST include headers: + - `Content-Type: text/event-stream` + - `Cache-Control: no-cache` + - `Connection: keep-alive` + - `X-Accel-Buffering: no` (to prevent nginx buffering) + +### Requirement: The SSE endpoint MUST support topic-based channel subscriptions +Clients MUST be able to subscribe at three granularity levels: all changes in a register, all changes in a specific schema within a register, or changes to a single object. The URL pattern MUST determine the subscription scope. + +#### Scenario: Subscribe to all changes in a register +- **GIVEN** the client connects to `GET /api/sse/zaken` +- **WHEN** objects are created in schemas `meldingen`, `vergunningen`, and `vertrouwelijk` within register `zaken` +- **THEN** the client MUST receive events for all three schemas (subject to RBAC filtering) + +#### Scenario: Subscribe to a specific schema +- **GIVEN** the client connects to `GET /api/sse/zaken/meldingen` +- **WHEN** objects are created in both `meldingen` and `vergunningen` +- **THEN** the client MUST only receive events for `meldingen` +- **AND** events for `vergunningen` MUST NOT be delivered on this connection + +#### Scenario: Subscribe to a specific object +- **GIVEN** the client connects to `GET /api/sse/zaken/meldingen/melding-uuid-123` +- **WHEN** `melding-uuid-123` is updated and `melding-uuid-456` is also updated +- **THEN** the client MUST only receive the update event for `melding-uuid-123` +- **AND** this subscription level MUST be used for detail view real-time updates + +#### Scenario: Subscribe to multiple topics via query parameter +- **GIVEN** the client connects to `GET /api/sse?topics=zaken/meldingen,zaken/vergunningen` +- **WHEN** events occur in both schemas +- **THEN** the client MUST receive events from both subscribed topics on a single SSE connection +- **AND** each event's data MUST include the source `register` and `schema` for client-side routing + +### Requirement: SSE events MUST be authorization-aware via RBAC filtering +Clients MUST only receive events for objects they are authorized to access. The RBAC check MUST be performed server-side before event delivery, using the same `PermissionHandler.hasPermission()` logic used for REST API access control. + +#### Scenario: Events filtered by schema-level read permission +- **GIVEN** user `medewerker-1` has read access to schema `meldingen` but NOT to schema `vertrouwelijk` +- **AND** user `medewerker-1` is connected to `GET /api/sse/zaken` (register-level subscription) +- **WHEN** an object is created in schema `vertrouwelijk` +- **THEN** `medewerker-1` MUST NOT receive the creation event +- **AND** no indication that the event occurred MUST be leaked (no empty event, no event count change) + +#### Scenario: Events delivered for all authorized schemas +- **GIVEN** user `behandelaar-1` has read access to schemas `meldingen` and `vergunningen` +- **AND** user `behandelaar-1` is connected to `GET /api/sse/zaken` +- **WHEN** objects are created in both schemas simultaneously +- **THEN** `behandelaar-1` MUST receive events for both schemas + +#### Scenario: Multi-tenancy filtering on events +- **GIVEN** multi-tenancy is enabled and user `org-a-user` belongs to organization `org-a` +- **AND** user `org-a-user` is connected to `GET /api/sse/zaken/meldingen` +- **WHEN** a melding owned by organization `org-b` is created +- **THEN** `org-a-user` MUST NOT receive the event +- **AND** events for `org-a` meldingen MUST be delivered normally + +#### Scenario: Admin user receives all events regardless of RBAC +- **GIVEN** an admin user is connected to `GET /api/sse/zaken` +- **WHEN** objects are created across all schemas including restricted ones +- **THEN** the admin MUST receive events for all schemas without filtering + +### Requirement: The SSE endpoint MUST support authentication +SSE connections MUST be authenticated using the same mechanisms as the REST API. The endpoint MUST support Nextcloud session cookies, Bearer token authentication, and Basic authentication for API consumers. + +#### Scenario: Authenticate via Nextcloud session cookie +- **GIVEN** a user is logged into the Nextcloud web interface +- **WHEN** the frontend JavaScript creates an `EventSource` connection to `/api/sse/zaken/meldingen` +- **THEN** the browser MUST send the session cookie automatically +- **AND** the SSE endpoint MUST authenticate the user via the Nextcloud session + +#### Scenario: Authenticate via Bearer token +- **GIVEN** an external client has a valid API token +- **WHEN** the client connects to the SSE endpoint with `Authorization: Bearer ` +- **THEN** the connection MUST be authenticated and events delivered according to the token's permissions +- **AND** if the `EventSource` API does not support custom headers, the token MUST be accepted as a query parameter `?token=` + +#### Scenario: Reject unauthenticated SSE connections +- **GIVEN** a client connects to `GET /api/sse/zaken/meldingen` without any authentication +- **WHEN** the server processes the connection +- **THEN** the server MUST respond with HTTP 401 Unauthorized +- **AND** no SSE stream MUST be opened + +### Requirement: SSE connections MUST support automatic reconnection with event replay +The SSE client MUST automatically reconnect after connection drops and the server MUST replay missed events using the `Last-Event-ID` header, as specified by the W3C SSE standard. + +#### Scenario: Reconnect and replay after network interruption +- **GIVEN** a client is connected to the SSE endpoint and has received events up to ID `evt_000042` +- **WHEN** the connection drops and the client reconnects +- **THEN** the client's `EventSource` MUST automatically send `Last-Event-ID: evt_000042` +- **AND** the server MUST replay all buffered events after `evt_000042` that match the subscription filter +- **AND** the server MUST then resume live streaming + +#### Scenario: Event buffer retention window +- **GIVEN** the server maintains an event buffer for reconnection support +- **THEN** the buffer MUST retain events for at least 5 minutes (configurable via `app_config` key `sse_buffer_ttl`) +- **AND** the buffer MUST hold at most 1000 events (configurable via `app_config` key `sse_buffer_max_size`) +- **AND** when both limits are reached, the oldest events MUST be evicted first + +#### Scenario: Reconnection beyond buffer window triggers full refresh signal +- **GIVEN** a client reconnects with `Last-Event-ID: evt_000010` +- **AND** `evt_000010` is older than the buffer retention window (no longer in the buffer) +- **WHEN** the server processes the reconnection +- **THEN** the server MUST send a special event with `event: refresh` and `data: {"reason": "buffer_expired"}` +- **AND** the client MUST perform a full data refresh by re-fetching the object list from the REST API + +#### Scenario: Monotonically increasing event IDs +- **GIVEN** events are published to the buffer +- **THEN** each event ID MUST be monotonically increasing within the buffer lifetime +- **AND** the ID format MUST be a string sortable by lexicographic order (e.g., zero-padded numeric or timestamp-based: `evt_1710849600_000042`) + +### Requirement: The system MUST support connection health via heartbeat +The SSE endpoint MUST send periodic heartbeat comments to detect stale connections and prevent intermediary proxies from closing idle connections. + +#### Scenario: Regular heartbeat during idle periods +- **GIVEN** a client is connected to the SSE endpoint +- **AND** no object change events have occurred for 15 seconds +- **WHEN** the heartbeat interval elapses +- **THEN** the server MUST send an SSE comment line `: heartbeat\n\n` +- **AND** the heartbeat interval MUST be configurable (default: 15 seconds) + +#### Scenario: Server detects client disconnection +- **GIVEN** a client connected to the SSE endpoint disconnects (closes browser tab, network failure) +- **WHEN** the server attempts to write the next heartbeat or event +- **THEN** the server MUST detect the broken connection via `connection_aborted()` +- **AND** the server MUST terminate the SSE loop and release resources (PHP process, memory) + +#### Scenario: Connection duration limit for PHP process management +- **GIVEN** the SSE endpoint runs as a long-lived PHP process +- **WHEN** the connection has been open for 30 seconds (default, configurable via `sse_max_duration`) +- **THEN** the server MUST gracefully close the connection by stopping the event loop +- **AND** the client's `EventSource` MUST automatically reconnect (per W3C SSE spec) +- **AND** the reconnection MUST use `Last-Event-ID` to resume without data loss + +### Requirement: The system MUST debounce and batch rapid changes +When multiple mutations happen in rapid succession (e.g., bulk imports, batch updates), the system MUST debounce events to prevent flooding connected clients with hundreds of individual events. + +#### Scenario: Debounce rapid updates to the same object +- **GIVEN** a client is connected to `GET /api/sse/zaken/meldingen` +- **AND** object `melding-1` is updated 5 times within 500ms (e.g., by a bulk update script) +- **WHEN** the debounce window (500ms, configurable) closes +- **THEN** the client MUST receive a single `object.updated` event containing the final state of the object +- **AND** the event's `data.batchedCount` field MUST indicate `5` to show updates were coalesced + +#### Scenario: Batch multiple object creations into a digest event +- **GIVEN** a client is connected to `GET /api/sse/zaken/meldingen` +- **AND** 50 meldingen are created in a single bulk import within 2 seconds +- **WHEN** the batch window closes +- **THEN** the client MUST receive a single `objects.batch` event with: + - `data.action`: `created` + - `data.count`: `50` + - `data.objects`: array of UUIDs +- **AND** the client SHOULD refresh its list view by re-fetching from the REST API + +#### Scenario: Individual events for low-frequency changes +- **GIVEN** a client is connected to `GET /api/sse/zaken/meldingen` +- **AND** two meldingen are created 10 seconds apart +- **WHEN** each creation occurs +- **THEN** each MUST be delivered as an individual `object.created` event (no batching) + +### Requirement: The event payload format MUST follow CloudEvents conventions +SSE event payloads MUST be structured following the CloudEvents v1.0 conventions established in the `event-driven-architecture` spec, ensuring consistency across SSE, webhooks, and internal event dispatch. + +#### Scenario: SSE event payload structure +- **GIVEN** a client is connected to the SSE endpoint +- **WHEN** an `object.created` event is delivered +- **THEN** the `data` field MUST be a JSON object with: + - `specversion`: `"1.0"` + - `type`: `"nl.openregister.object.created"` + - `source`: `"/registers/{registerId}/schemas/{schemaId}"` + - `id`: the event's unique ID (same as the SSE `id` field) + - `time`: ISO 8601 timestamp + - `subject`: the object UUID + - `datacontenttype`: `"application/json"` + - `data`: the object data (properties, metadata) + +#### Scenario: Webhook mapping transformation applies to SSE payloads +- **GIVEN** a schema has a configured Mapping entity for payload transformation (per `webhook-payload-mapping` spec) +- **WHEN** an SSE event is prepared for delivery +- **THEN** the SSE payload MUST use the raw CloudEvents format (mappings are for webhook delivery only) +- **AND** the SSE `data` field MUST always contain the canonical CloudEvents structure + +#### Scenario: Event includes correlation ID for cascade operations +- **GIVEN** deleting a person triggers CASCADE deletion of 3 related orders (per `event-driven-architecture` spec) +- **WHEN** the 4 events are pushed to the SSE buffer +- **THEN** all 4 events MUST share the same `correlationId` extension attribute +- **AND** the client MUST be able to group related events by correlation ID + +### Requirement: The system SHOULD integrate with Nextcloud notify_push for native push delivery +As a complementary channel to SSE, the system SHALL publish object change events through Nextcloud's notify_push app (when installed) to deliver instant notifications to Nextcloud desktop and mobile clients via WebSocket. + +#### Scenario: Push notification via notify_push on object creation +- **GIVEN** the notify_push app is installed and configured +- **AND** user `behandelaar-1` is connected to Nextcloud via the desktop client +- **WHEN** a melding assigned to `behandelaar-1` is created +- **THEN** a push notification MUST be sent via notify_push +- **AND** the Nextcloud desktop client MUST display the notification + +#### Scenario: Graceful degradation without notify_push +- **GIVEN** the notify_push app is NOT installed +- **WHEN** object change events occur +- **THEN** SSE delivery MUST function normally without errors +- **AND** no push notifications MUST be attempted +- **AND** no error logs MUST be generated about missing notify_push + +#### Scenario: Notification includes deep link to object +- **GIVEN** a push notification is delivered via notify_push +- **WHEN** the user clicks the notification +- **THEN** the user MUST be navigated to the object's detail view in the OpenRegister UI +- **AND** the deep link MUST follow the pattern `/apps/openregister/#/registers/{register}/schemas/{schema}/objects/{objectUuid}` + +### Requirement: The system MUST support fallback to polling when SSE is unavailable +When SSE connections cannot be established (corporate proxies, browser limitations, PHP configuration), the client MUST gracefully fall back to periodic polling of the REST API. + +#### Scenario: Automatic fallback after SSE connection failure +- **GIVEN** the client attempts to connect to the SSE endpoint +- **AND** the connection fails 3 consecutive times (timeout, HTTP error, or `EventSource.onerror`) +- **WHEN** the third failure occurs +- **THEN** the client MUST switch to polling mode +- **AND** the polling interval MUST be 30 seconds (configurable) +- **AND** a console warning MUST be logged: `"SSE unavailable, falling back to polling"` + +#### Scenario: Polling detects changes via ETag or Last-Modified +- **GIVEN** the client is in polling fallback mode +- **WHEN** the client polls `GET /api/objects/{register}/{schema}` with `If-None-Match: ""` +- **THEN** the server MUST respond with HTTP 304 Not Modified if no changes occurred +- **AND** the server MUST respond with HTTP 200 and the updated object list if changes occurred + +#### Scenario: Automatic SSE reconnection attempt after polling period +- **GIVEN** the client is in polling fallback mode +- **WHEN** 5 minutes have elapsed since the last SSE failure +- **THEN** the client MUST attempt to re-establish the SSE connection +- **AND** if successful, polling MUST stop and SSE MUST resume + +### Requirement: The frontend MUST auto-refresh views when realtime events arrive +List views, detail views, and dashboard widgets MUST automatically update their displayed data when relevant SSE events are received, without requiring a manual page refresh. + +#### Scenario: Auto-refresh list view on object creation +- **GIVEN** the user is viewing the meldingen list showing 10 objects +- **AND** the list view is connected to the SSE endpoint for schema `meldingen` +- **WHEN** another user creates a new melding +- **THEN** the list MUST add the new melding to the displayed results without manual refresh +- **AND** a subtle highlight animation SHOULD indicate the newly added entry +- **AND** the list's total count MUST update accordingly + +#### Scenario: Auto-refresh detail view on object update +- **GIVEN** the user is viewing the detail of `melding-1` +- **AND** the detail view is connected to the SSE endpoint for object `melding-1` +- **WHEN** another user updates `melding-1`'s status from `nieuw` to `in_behandeling` +- **THEN** the detail view MUST update the status field in place +- **AND** a brief banner SHOULD appear: `"Dit object is bijgewerkt door [user]"` (translated) +- **AND** if the user has unsaved local edits, a conflict dialog MUST appear instead of silently overwriting + +#### Scenario: Handle deleted object in active detail view +- **GIVEN** the user is viewing the detail of `melding-5` +- **WHEN** `melding-5` is deleted by another user +- **THEN** the UI MUST display a notice: `"Dit object is verwijderd"` (translated via i18n) +- **AND** all editing controls MUST be disabled +- **AND** a button MUST offer to navigate back to the list view + +#### Scenario: Dashboard widget updates in real time +- **GIVEN** a dashboard widget displays the count of open meldingen (currently 42) +- **WHEN** a new melding is created +- **THEN** the widget MUST update the count to 43 without page refresh + +### Requirement: The frontend MUST use a reactive store pattern for realtime state management +The frontend SSE integration MUST be implemented as a composable or store that manages the EventSource connection lifecycle, dispatches events to the correct Vue components, and handles cross-tab coordination. + +#### Scenario: Composable manages EventSource lifecycle +- **GIVEN** a Vue component mounts and calls `useRealtimeUpdates('zaken', 'meldingen')` +- **WHEN** the component is mounted +- **THEN** the composable MUST open an `EventSource` connection to `/api/sse/zaken/meldingen` +- **AND** when the component is unmounted, the composable MUST close the `EventSource` connection +- **AND** if multiple components subscribe to the same topic, a single `EventSource` connection MUST be shared + +#### Scenario: Cross-tab event coordination via BroadcastChannel +- **GIVEN** the user has the OpenRegister app open in 3 browser tabs +- **AND** each tab has an SSE connection to the same endpoint +- **WHEN** a realtime event arrives +- **THEN** only ONE tab MUST maintain the active SSE connection (leader election) +- **AND** the leader tab MUST forward events to other tabs via `BroadcastChannel` API +- **AND** if the leader tab is closed, another tab MUST take over the SSE connection + +#### Scenario: Connection shared across components via reference counting +- **GIVEN** component A subscribes to `zaken/meldingen` and component B also subscribes to `zaken/meldingen` +- **WHEN** component A unmounts +- **THEN** the SSE connection MUST remain open (component B still needs it) +- **AND** when component B also unmounts, the SSE connection MUST be closed + +### Requirement: The system MUST perform acceptably under concurrent connection load +The SSE implementation MUST handle a reasonable number of concurrent connections without degrading server performance. Given PHP's process-per-request model, specific limits and mitigations MUST be defined. + +#### Scenario: Concurrent connection limit per server +- **GIVEN** the server is configured with Apache/PHP-FPM with 50 worker processes +- **WHEN** 20 users each have an active SSE connection (20 long-lived PHP processes) +- **THEN** the remaining 30 worker processes MUST be available for regular API requests +- **AND** the system MUST enforce a configurable maximum SSE connection limit (default: 50% of worker pool) + +#### Scenario: Event buffer uses Redis when available for cross-process consistency +- **GIVEN** the Nextcloud instance runs with multiple PHP-FPM worker processes +- **AND** Redis is configured as the Nextcloud cache backend (`OCP\ICache`) +- **WHEN** an object mutation occurs in worker process A +- **THEN** the event MUST be written to the Redis-backed event buffer +- **AND** worker process B serving an SSE connection MUST see the new event on its next poll cycle +- **AND** if Redis is not available, the system MUST fall back to APCu (current behavior, with the known limitation that events may be missed across processes) + +#### Scenario: APCu fallback with documented limitations +- **GIVEN** Redis is NOT configured and APCu is used for the event buffer +- **WHEN** the SSE endpoint documentation is rendered +- **THEN** the admin settings page MUST display a warning: `"APCu event buffer is per-process; consider configuring Redis for reliable cross-process SSE delivery"` + +### Requirement: The SSE event payload MUST support subscription filtering via query parameters +Beyond URL-path-based topic selection, clients MUST be able to filter events by event type, property conditions, or object attributes using query parameters on the SSE endpoint. + +#### Scenario: Filter by event type +- **GIVEN** a client connects to `GET /api/sse/zaken/meldingen?events=object.created,object.updated` +- **WHEN** a delete event occurs for a melding +- **THEN** the client MUST NOT receive the delete event +- **AND** create and update events MUST be delivered normally + +#### Scenario: Filter by object property value +- **GIVEN** a client connects to `GET /api/sse/zaken/meldingen?filter[status]=in_behandeling` +- **WHEN** a melding with `status=nieuw` is created +- **THEN** the client MUST NOT receive the event +- **AND** when a melding with `status=in_behandeling` is created, the client MUST receive the event + +#### Scenario: No filters delivers all events +- **GIVEN** a client connects to `GET /api/sse/zaken/meldingen` without any query parameters +- **WHEN** create, update, and delete events occur +- **THEN** all events MUST be delivered (no filtering applied) + +## Current Implementation Status + +**Partially implemented via GraphQL Subscriptions:** +- `lib/Controller/GraphQLSubscriptionController.php` -- SSE-based subscription controller with 30-second polling loop, heartbeat comments, `Last-Event-ID` reconnection support, schema/register query parameter filtering +- `lib/Service/GraphQL/SubscriptionService.php` -- Event buffer in APCu with 5-minute TTL, 1000-event max buffer, RBAC filtering via `PermissionHandler.hasPermission()`, `filterEventStream()` for schema/register filtering, `formatAsSSE()` for SSE message formatting +- `lib/Listener/GraphQLSubscriptionListener.php` -- Listens to `ObjectCreatedEvent`, `ObjectUpdatedEvent`, `ObjectDeletedEvent` and pushes to APCu buffer via `SubscriptionService.pushEvent()` +- Registered in `lib/AppInfo/Application.php` lines 744-745 for ObjectCreated and ObjectUpdated events + +**What IS implemented:** +- SSE streaming endpoint with `text/event-stream` content type and correct headers +- APCu-based event buffer with TTL (300s) and max size (1000) eviction +- RBAC filtering: `verifyEventRBAC()` checks `PermissionHandler.hasPermission()` per event +- Schema and register filtering via query parameters +- `Last-Event-ID` reconnection with event replay from buffer +- Heartbeat comments every poll cycle (1 second) +- Connection abort detection via `connection_aborted()` +- 30-second max connection duration to manage PHP process lifecycle +- Event payload includes object UUID, register, schema, owner, and full object data (for create/update) + +**What is NOT implemented:** +- Dedicated `/api/sse/{register}/{schema}` REST endpoints (current endpoint is GraphQL-specific at a different route) +- Monotonically increasing event IDs (current uses `uniqid('gql_', true)` which is not monotonic) +- Topic-based URL pattern subscriptions (register-level, schema-level, object-level) +- Multi-topic subscription via query parameters (`?topics=...`) +- Event type filtering via query parameters (`?events=...`) +- Property-based subscription filtering (`?filter[status]=...`) +- Debouncing/batching of rapid changes +- CloudEvents payload format (current payload is custom, not CloudEvents v1.0) +- Correlation IDs for cascade operations +- Redis-backed event buffer for cross-process consistency (APCu only) +- Nextcloud notify_push integration +- Frontend composable/store for EventSource lifecycle management +- Cross-tab coordination via BroadcastChannel +- Polling fallback logic in the frontend +- Auto-refresh of list views, detail views, and dashboard widgets +- Conflict detection for concurrent edits in detail view +- `objects.batch` digest events for bulk operations +- Configurable heartbeat interval (hardcoded at 1 second) +- Admin settings page warning for APCu vs Redis +- Bearer token authentication support for SSE (query parameter token) +- Connection limit enforcement + +## Standards & References +- **W3C Server-Sent Events specification** -- https://html.spec.whatwg.org/multipage/server-sent-events.html +- **EventSource Web API** -- https://developer.mozilla.org/en-US/docs/Web/API/EventSource +- **CloudEvents v1.0 (CNCF)** -- https://cloudevents.io/ (payload format, per `event-driven-architecture` spec) +- **BroadcastChannel API** -- https://developer.mozilla.org/en-US/docs/Web/API/BroadcastChannel (cross-tab coordination) +- **Nextcloud notify_push** -- https://github.com/nextcloud/notify_push (WebSocket push for NC clients) +- **Nextcloud INotificationManager** -- `OCP\Notification\IManager` (in-app notification integration) +- **PocketBase Realtime** -- SSE subscriptions per collection/record with auth-aware filtering, 5-min idle timeout, client chunking (competitor reference) +- **Directus WebSockets** -- UID-based subscription management, permission-filtered broadcasts, heartbeat configuration (competitor reference) +- **GraphQL Subscriptions over SSE** -- Current partial implementation pattern in OpenRegister + +## Specificity Assessment +- **Specific enough to implement?** Yes -- all 14 requirements have concrete scenarios with GIVEN/WHEN/THEN, specific URL patterns, payload structures, and configuration keys. +- **Builds on existing code:** The GraphQL subscription infrastructure (`SubscriptionService`, `GraphQLSubscriptionListener`, `GraphQLSubscriptionController`) provides a working foundation. The primary work is: (1) extract the SSE logic from the GraphQL-specific controller into a dedicated REST endpoint, (2) switch from `uniqid()` to monotonic IDs, (3) add Redis backend option alongside APCu, (4) implement frontend composable with cross-tab coordination. +- **Dependencies:** Requires `event-driven-architecture` spec for CloudEvents format and correlation IDs. References `webhook-payload-mapping` for payload transformation distinction (SSE always uses raw CloudEvents, mappings are webhook-only). +- **Open questions resolved:** + - GraphQL subscription infrastructure SHOULD be extended (not replaced) -- the dedicated REST SSE endpoint reuses `SubscriptionService` internally + - WebSocket support is deferred to notify_push integration rather than a custom implementation (PHP is not suited for persistent WebSocket connections) + - ExApp sidecar deployment: SSE endpoints run in the PHP process; ExApp Python sidecars can proxy SSE via reverse proxy or consume the SSE endpoint as a client + +## Nextcloud Integration Analysis + +**Status**: Partially Implemented + +**Existing Implementation**: `GraphQLSubscriptionController` provides a functional SSE endpoint with APCu-buffered events, RBAC filtering via `PermissionHandler`, and `Last-Event-ID` reconnection support. `SubscriptionService` manages the event buffer with 5-minute TTL and 1000-event cap. `GraphQLSubscriptionListener` captures `ObjectCreatedEvent`, `ObjectUpdatedEvent`, and `ObjectDeletedEvent` via Nextcloud's `IEventDispatcher` and pushes them to the APCu buffer. The `NotificationService` already integrates with Nextcloud's `INotificationManager` for in-app notifications, providing a foundation for notify_push integration. + +**Nextcloud Core Integration**: The SSE implementation works within Nextcloud's PHP request model, though long-lived PHP processes are resource-intensive. The 30-second connection limit is a pragmatic mitigation. For production deployments, the event buffer SHOULD use Nextcloud's `OCP\ICacheFactory` with a Redis backend (`\OC\Memcache\Redis`) for cross-process event sharing, replacing the per-process APCu buffer. The `INotificationManager` integration in `NotificationService` can be extended to fire push notifications alongside SSE events, giving Nextcloud desktop and mobile clients native realtime awareness via the notify_push app. Authentication SHOULD use Nextcloud's `IRequest` session validation (already in place via the controller's `@NoAdminRequired` annotation) and extend to support API token validation for headless clients. + +**Recommendation**: Extract the SSE streaming logic from `GraphQLSubscriptionController` into a new `SseController` that registers dedicated REST routes (`/api/sse/{register}`, `/api/sse/{register}/{schema}`, `/api/sse/{register}/{schema}/{objectId}`). Reuse `SubscriptionService` as the event buffer backend, adding a `ICache`-based implementation alongside APCu. Add a frontend composable (`useRealtimeUpdates`) that manages `EventSource` lifecycle with BroadcastChannel-based cross-tab leader election. Implement debouncing in `SubscriptionService.pushEvent()` by coalescing same-object events within a configurable window. For CloudEvents payload format, reuse `CloudEventFormatter` from the webhook system to format SSE `data` fields consistently. diff --git a/openspec/changes/reference-existence-validation/specs/reference-existence-validation/spec.md b/openspec/changes/reference-existence-validation/specs/reference-existence-validation/spec.md new file mode 100644 index 000000000000..c1bc23efb094 --- /dev/null +++ b/openspec/changes/reference-existence-validation/specs/reference-existence-validation/spec.md @@ -0,0 +1,541 @@ +--- +status: implemented +--- + +# reference-existence-validation Specification + +## Purpose +Add configurable validation that ensures objects referenced via `$ref` properties actually exist before saving. When a schema property has `$ref` pointing to another schema and `validateReference` is enabled, the save pipeline checks that the UUID stored in that property corresponds to an existing object in the target schema. This spec covers the full lifecycle of reference existence checking: single-object saves, bulk imports, GraphQL mutations, soft-deleted reference handling, circular reference detection, external URL references, validation caching, configurable strictness, admin bypass, async batch validation, and event-driven notification of validation failures. + +**Source**: Core OpenRegister data integrity capability. Ensures that `$ref` pointers between objects are valid at write time, complementing the referential-integrity spec which handles cascading behavior at delete time. + +**Cross-references**: referential-integrity (delete-time enforcement), deletion-audit-trail (audit logging), content-versioning (version impact), bulk-object-operations (import pipeline), graphql-api (mutation validation). + +## Requirements + +### Requirement: Schema properties MUST support a validateReference configuration +Schema property definitions MUST accept a `validateReference` boolean flag that controls whether referenced object existence is checked on save. When not specified, it MUST default to `false` (eventual consistency pattern). The flag MUST be supported on both scalar `$ref` properties and array properties with `items.$ref`. + +#### Scenario: Property with validateReference enabled +- GIVEN a schema `order` with property: + ```json + { + "assignee": { + "type": "string", + "$ref": "person-schema-id", + "validateReference": true + } + } + ``` +- WHEN an object is saved with `assignee` = `"existing-person-uuid"` +- AND a person object with UUID `"existing-person-uuid"` exists in the referenced schema +- THEN the save MUST succeed + +#### Scenario: Property with validateReference disabled (default) +- GIVEN a schema `order` with property: + ```json + { + "assignee": { + "type": "string", + "$ref": "person-schema-id" + } + } + ``` +- WHEN an object is saved with `assignee` = `"nonexistent-uuid"` +- THEN the save MUST succeed (no existence check performed) +- AND `validateReference` defaults to `false` when not specified + +### Requirement: Save MUST reject objects with invalid references when validateReference is enabled +When `validateReference` is `true`, the save pipeline MUST verify that the referenced UUID exists in the target schema. The check MUST use `MagicMapper::find()` with `_rbac: false` and `_multitenancy: false` to ensure system-level validation regardless of the current user's permissions. Non-existence errors (database errors) MUST be logged as warnings but MUST NOT block the save. + +#### Scenario: Single-value reference to nonexistent object +- GIVEN a schema with `validateReference: true` on property `assignee` referencing schema `person` +- WHEN an object is saved with `assignee` = `"nonexistent-uuid"` +- AND no person object with UUID `"nonexistent-uuid"` exists +- THEN the save MUST fail with HTTP 422 +- AND the error message MUST include the property name, the invalid UUID, and the target schema name +- AND the error message format MUST be: `"Referenced object 'nonexistent-uuid' not found in schema 'person' for property 'assignee'"` + +#### Scenario: Array reference with one invalid UUID +- GIVEN a schema with property: + ```json + { + "members": { + "type": "array", + "items": { + "type": "string", + "$ref": "person-schema-id" + }, + "validateReference": true + } + } + ``` +- WHEN an object is saved with `members` = `["valid-uuid-1", "nonexistent-uuid", "valid-uuid-2"]` +- AND `valid-uuid-1` and `valid-uuid-2` exist but `nonexistent-uuid` does not +- THEN the save MUST fail with HTTP 422 +- AND the error message MUST identify `nonexistent-uuid` as the invalid reference + +#### Scenario: Array reference with all valid UUIDs +- GIVEN a schema with `validateReference: true` on an array property +- WHEN an object is saved with an array of UUIDs that all exist in the target schema +- THEN the save MUST succeed + +#### Scenario: Null or empty reference value +- GIVEN a schema with `validateReference: true` on a non-required property +- WHEN an object is saved with the property set to `null` or `""` +- THEN the save MUST succeed (null/empty references are not validated) + +#### Scenario: Empty string UUID in array is skipped +- GIVEN a schema with `validateReference: true` on an array property +- WHEN an object is saved with `members` = `["valid-uuid", "", "another-valid-uuid"]` +- THEN only `"valid-uuid"` and `"another-valid-uuid"` MUST be validated +- AND empty string entries MUST be skipped without error + +### Requirement: Reference validation MUST resolve target schema via existing $ref resolution +The validation MUST use the same `resolveSchemaReference()` mechanism that SaveObject already uses for `$ref` resolution. This method supports numeric IDs, UUIDs, slugs, JSON Schema paths (`#/components/schemas/Name`), and full URLs. Resolved schema IDs MUST be cached in `$schemaReferenceCache` for performance across multiple validations in the same request. + +#### Scenario: $ref as schema ID +- GIVEN a property with `$ref: "42"` and `validateReference: true` +- WHEN validation resolves the target schema +- THEN it MUST use `resolveSchemaReference("42")` to find the schema by numeric ID + +#### Scenario: $ref as schema UUID +- GIVEN a property with `$ref: "550e8400-e29b-41d4-a716-446655440000"` and `validateReference: true` +- WHEN validation resolves the target schema +- THEN it MUST use `resolveSchemaReference()` to find the schema by UUID + +#### Scenario: $ref as schema slug +- GIVEN a property with `$ref: "person"` and `validateReference: true` +- WHEN validation resolves the target schema +- THEN it MUST resolve `"person"` to the schema by case-insensitive slug match + +#### Scenario: $ref as JSON Schema path +- GIVEN a property with `$ref: "#/components/schemas/Contactgegevens"` and `validateReference: true` +- WHEN validation resolves the target schema +- THEN it MUST extract `"Contactgegevens"` from the path and resolve by slug + +#### Scenario: $ref as URL +- GIVEN a property with `$ref: "https://example.com/schemas/person"` and `validateReference: true` +- WHEN validation resolves the target schema +- THEN it MUST extract `"person"` from the URL path and resolve by slug + +#### Scenario: Unresolvable $ref logs warning but does not block save +- GIVEN a property with `$ref: "nonexistent-schema"` and `validateReference: true` +- WHEN `resolveSchemaReference()` returns `null` +- THEN a warning MUST be logged with the property name and reference value +- AND the save MUST proceed without blocking (graceful degradation) + +### Requirement: Reference validation MUST work with the object's register context +The existence check MUST look for the referenced object in the correct register. The target register is determined by: (1) the `register` property on the schema property definition (explicit cross-register), or (2) the object's own register (same-register default). When the target register cannot be resolved, a warning MUST be logged and validation MUST be skipped for that property. + +#### Scenario: Same-register reference +- GIVEN an object in register `procest` with a `$ref` property pointing to schema `person` +- AND `person` schema exists in register `procest` +- WHEN the reference is validated +- THEN the existence check MUST query register `procest` for the person object + +#### Scenario: Cross-register reference with explicit register +- GIVEN a property with: + ```json + { + "owner": { + "type": "string", + "$ref": "person-schema-id", + "register": "shared-register-id", + "validateReference": true + } + } + ``` +- WHEN the reference is validated +- THEN the existence check MUST query the register specified in `register` config, not the object's own register + +#### Scenario: Cross-register reference with unresolvable register +- GIVEN a property with `register: "deleted-register-id"` and `validateReference: true` +- WHEN the register cannot be found via `getCachedRegister()` +- THEN a warning MUST be logged with the property name and register ID +- AND the reference validation MUST be skipped for that property (graceful degradation) + +### Requirement: Reference validation MUST NOT impact update operations for unchanged references +On updates (PUT/PATCH), properties whose values have not changed MUST NOT be re-validated. This is critical for data consistency: if a referenced object has been soft-deleted after the initial save, an update that does not change the reference value MUST NOT fail. The comparison MUST use strict equality (`===`) between old and new values. + +#### Scenario: Update with unchanged reference +- GIVEN an existing object with `assignee` = `"person-uuid"` and `validateReference: true` +- AND the referenced person has since been deleted +- WHEN the object is updated with `assignee` = `"person-uuid"` (same value) +- THEN the save MUST succeed (unchanged values are not re-validated) + +#### Scenario: Update with changed reference +- GIVEN an existing object with `assignee` = `"old-person-uuid"` +- WHEN the object is updated with `assignee` = `"new-person-uuid"` +- AND `new-person-uuid` does not exist +- THEN the save MUST fail with HTTP 422 + +#### Scenario: Update with changed array reference +- GIVEN an existing object with `members` = `["uuid-1", "uuid-2"]` and `validateReference: true` +- WHEN the object is updated with `members` = `["uuid-1", "uuid-3"]` +- AND `["uuid-1", "uuid-2"]` !== `["uuid-1", "uuid-3"]` (array changed) +- THEN ALL UUIDs in the new array MUST be validated (including `uuid-1` which was already present) +- AND if `uuid-3` does not exist, the save MUST fail with HTTP 422 + +### Requirement: Soft-deleted references MUST be treated as nonexistent +When `validateReference` is `true` and the referenced object has been soft-deleted (has `deletedAt` metadata set), the reference MUST be treated as nonexistent. The `MagicMapper::find()` method used for validation MUST exclude soft-deleted objects from its results by default. + +#### Scenario: Reference to soft-deleted object on create +- GIVEN a person object `person-1` that has been soft-deleted (has `deletedAt` in metadata) +- AND a schema with `validateReference: true` on property `assignee` referencing `person` +- WHEN a new order is created with `assignee` = `"person-1-uuid"` +- THEN the save MUST fail with HTTP 422 +- AND the error message MUST indicate the referenced object was not found + +#### Scenario: Reference to soft-deleted object on update with changed value +- GIVEN an existing order with `assignee` = `"person-1-uuid"` (valid at creation time) +- AND person `person-1` has since been soft-deleted +- WHEN the order is updated with `assignee` = `"person-1-uuid"` (same value, unchanged) +- THEN the save MUST succeed (unchanged reference bypass) + +#### Scenario: Reference to hard-deleted object +- GIVEN a person object that has been permanently removed from the database +- AND a schema with `validateReference: true` on property `assignee` +- WHEN a new order is created referencing that person's UUID +- THEN `MagicMapper::find()` MUST throw `DoesNotExistException` +- AND the save MUST fail with HTTP 422 + +### Requirement: Batch reference validation MUST be optimized for bulk imports +When objects are imported in bulk via `ImportService` or `SaveObjects` (bulk save pipeline), reference validation MUST be batched to avoid N+1 query patterns. The system MUST collect all unique reference UUIDs across all objects in the batch, validate them in a single pass per target schema, and cache results for the duration of the import operation. + +#### Scenario: Bulk import with 100 objects referencing the same schema +- GIVEN 100 order objects being imported, each with `assignee` referencing the `person` schema +- AND the 100 objects reference 20 unique person UUIDs +- WHEN the bulk import processes reference validation +- THEN the system MUST collect all 20 unique UUIDs first +- AND MUST validate them in batched queries (batch size <= 50 per query) +- AND the total database queries for reference validation MUST NOT exceed ceil(20/50) = 1 query +- AND each UUID's existence result MUST be cached for reuse by subsequent objects in the batch + +#### Scenario: Bulk import with mixed valid and invalid references +- GIVEN 50 objects being imported with `validateReference: true` +- AND 5 of the 50 objects reference nonexistent UUIDs +- WHEN the bulk import processes reference validation +- THEN the system MUST collect all validation errors before reporting +- AND the error response MUST include all 5 failed objects with their respective invalid UUIDs +- AND the 45 valid objects MUST still be saved (partial success model for imports) + +#### Scenario: Bulk import with cross-schema references in a single batch +- GIVEN a batch of 30 objects where 10 reference `person`, 10 reference `product`, and 10 reference `category` +- WHEN batch reference validation runs +- THEN the system MUST group UUIDs by target schema +- AND MUST execute at most 3 batched validation queries (one per target schema) + +### Requirement: Validation error reporting MUST include structured diagnostic information +When reference validation fails, the error response MUST include machine-readable diagnostic information beyond the human-readable message. This enables API consumers to programmatically handle validation failures. + +#### Scenario: Single validation error with structured response +- GIVEN a save that fails reference validation on property `assignee` +- WHEN the HTTP 422 response is returned +- THEN the response body MUST include: + ```json + { + "message": "Referenced object 'nonexistent-uuid' not found in schema 'person' for property 'assignee'", + "error": "validation_error", + "details": { + "property": "assignee", + "referenceUuid": "nonexistent-uuid", + "targetSchema": "person", + "targetRegister": "procest", + "validationType": "reference_existence" + } + } + ``` + +#### Scenario: Multiple validation errors collected in a single response +- GIVEN a schema with `validateReference: true` on properties `assignee` and `reviewer` +- AND both properties reference nonexistent UUIDs +- WHEN the object is saved +- THEN the save MUST fail with HTTP 422 +- AND the error response MUST include details for BOTH failed properties +- AND the `details` field MUST be an array with entries for each failed property + +### Requirement: Circular reference chains MUST be detected during validation +When two or more schemas have mutual `$ref` properties with `validateReference: true`, the system MUST detect circular reference chains during validation to prevent infinite validation loops. A visited-set pattern MUST track which objects are currently being validated in the call stack. + +#### Scenario: Two schemas with mutual references and cascade creation +- GIVEN schema `incident` has property `notes` with `$ref: "note"`, `validateReference: true`, and `inversedBy: "incident"` +- AND schema `note` has property `incident` with `$ref: "incident"`, `validateReference: true` +- WHEN an incident is created with inline note objects (cascade creation) +- THEN the cascade creation handler MUST create the notes first +- AND reference validation on the notes' `incident` property MUST detect the parent is being created in the same transaction +- AND the validation MUST succeed (parent object is in the current save context) + +#### Scenario: Self-referencing schema +- GIVEN schema `category` has property `parentCategory` with `$ref: "category"` and `validateReference: true` +- WHEN a category is created with `parentCategory` pointing to an existing category +- THEN the validation MUST succeed +- AND the system MUST NOT enter an infinite loop checking references + +#### Scenario: Deeply nested circular chain +- GIVEN schemas A -> B -> C -> A, each with mutual `$ref` and `validateReference: true` +- WHEN object A is created with inline cascade creation of B and C +- THEN the validation depth MUST be bounded (maximum 10 levels, consistent with `ReferentialIntegrityService::MAX_DEPTH`) +- AND a warning MUST be logged if the depth limit is reached + +### Requirement: External URL references MUST support configurable validation +When a `$ref` property contains a full URL pointing to an external system, the system MUST support optional HTTP-based existence validation. This MUST be controlled by a `validateExternalReference` boolean flag (separate from `validateReference`) and MUST respect timeout and retry configuration. + +#### Scenario: External URL reference with validation enabled +- GIVEN a property with: + ```json + { + "sourceDocument": { + "type": "string", + "$ref": "https://api.example.com/documents", + "validateExternalReference": true, + "externalValidationTimeout": 5000 + } + } + ``` +- WHEN an object is saved with `sourceDocument` = `"https://api.example.com/documents/doc-123"` +- THEN the system MUST perform an HTTP HEAD request to the URL +- AND if the response status is 200-299, the validation MUST succeed +- AND if the response status is 404, the validation MUST fail with HTTP 422 +- AND if the request times out (> 5000ms), the validation MUST log a warning and succeed (fail-open) + +#### Scenario: External URL reference with validation disabled (default) +- GIVEN a property with `$ref` pointing to an external URL and no `validateExternalReference` flag +- WHEN an object is saved with a URL value +- THEN no HTTP request MUST be made to validate the URL +- AND the save MUST succeed regardless of the URL's validity + +#### Scenario: External reference validation respects Nextcloud proxy settings +- GIVEN a Nextcloud instance configured with an HTTP proxy +- WHEN external reference validation performs an HTTP request +- THEN the request MUST use the proxy configuration from Nextcloud's `IConfig` (`proxy`, `proxyuserpwd`) + +### Requirement: Validation results MUST be cached within a request scope +To avoid repeated database lookups when multiple objects reference the same target, validation results MUST be cached for the duration of the HTTP request. The `$schemaReferenceCache` in `SaveObject` MUST be extended to cache existence check results alongside schema resolution results. + +#### Scenario: Two objects referencing the same UUID in a single request +- GIVEN two objects are saved in the same HTTP request (e.g., cascade creation) +- AND both reference `person-uuid` with `validateReference: true` +- WHEN the first object validates `person-uuid` and confirms it exists +- THEN the second object's validation of `person-uuid` MUST use the cached result +- AND only 1 database query MUST be executed for the existence check (not 2) + +#### Scenario: Cache invalidation on object creation within the same request +- GIVEN a cascade creation that first creates a child object, then validates a parent's reference to that child +- WHEN the child object is created successfully +- THEN the existence cache MUST be updated to include the newly created child's UUID +- AND subsequent validation of references to that child MUST succeed + +#### Scenario: Cache scope limited to current request +- GIVEN a validated reference from a previous HTTP request +- WHEN a new HTTP request begins +- THEN the existence cache MUST be empty (no cross-request caching) +- AND all references MUST be re-validated against the database + +### Requirement: Admin users MUST be able to bypass reference validation +System administrators MUST be able to bypass reference validation when performing data maintenance operations (e.g., restoring backups, migrating data between registers). This MUST be controlled via a `_skipValidation` parameter on the API, restricted to admin users only. + +#### Scenario: Admin bypasses validation via API parameter +- GIVEN an admin user making a POST request with `_skipValidation: true` +- AND the object references a nonexistent UUID with `validateReference: true` +- WHEN the save is processed +- THEN reference validation MUST be skipped entirely +- AND the save MUST succeed with the invalid reference stored + +#### Scenario: Non-admin user attempts to bypass validation +- GIVEN a non-admin user making a POST request with `_skipValidation: true` +- WHEN the save is processed +- THEN the `_skipValidation` parameter MUST be ignored +- AND reference validation MUST proceed normally +- AND if the reference is invalid, the save MUST fail with HTTP 422 + +#### Scenario: Admin bypass logged for audit trail +- GIVEN an admin uses `_skipValidation: true` to save an object with invalid references +- WHEN the save succeeds +- THEN an audit trail entry MUST be created with `action: reference_validation_bypassed` +- AND the entry MUST include the admin user ID, property names, and invalid UUIDs + +### Requirement: Reference validation MUST work in GraphQL mutations +GraphQL create and update mutations that flow through `ObjectService::saveObject()` MUST trigger the same reference validation as REST API saves. Validation errors MUST be surfaced as GraphQL errors with the `VALIDATION_ERROR` code via `GraphQLResolver::resolveCreate()` and `GraphQLResolver::resolveUpdate()`. + +#### Scenario: GraphQL create mutation with invalid reference +- GIVEN a GraphQL mutation: + ```graphql + mutation { + createOrder(input: { assignee: "nonexistent-uuid", title: "Test" }) { + id + assignee + } + } + ``` +- AND the `order` schema has `validateReference: true` on `assignee` +- WHEN the mutation is executed +- THEN `ObjectService::saveObject()` MUST throw `ValidationException` +- AND `GraphQLResolver::resolveCreate()` MUST catch the exception +- AND MUST return a GraphQL error with `extensions.code: "VALIDATION_ERROR"` +- AND the error message MUST include the property name and invalid UUID + +#### Scenario: GraphQL update mutation with changed invalid reference +- GIVEN an existing order with `assignee: "valid-uuid"` +- AND a GraphQL mutation updating `assignee` to `"nonexistent-uuid"` +- WHEN the mutation is executed +- THEN the same validation and error handling MUST apply as for create mutations + +#### Scenario: GraphQL batch mutation with partial failures +- GIVEN a GraphQL mutation that creates multiple objects in sequence +- AND one object has an invalid reference while others are valid +- WHEN the mutation is executed +- THEN the valid objects MUST be created successfully +- AND the invalid object MUST return a GraphQL error with `VALIDATION_ERROR` +- AND partial results MUST be returned per the GraphQL specification + +### Requirement: Async validation MUST be supported for large batch operations +For batch operations exceeding a configurable threshold (default: 500 objects), the system MUST support asynchronous reference validation via a Nextcloud background job. The initial save MUST proceed with a `validationStatus: pending` flag, and the background job MUST validate references post-save and flag invalid objects. + +#### Scenario: Batch import exceeding async threshold +- GIVEN 1000 objects being imported with `validateReference: true` +- AND the async validation threshold is set to 500 +- WHEN the import processes reference validation +- THEN the system MUST save all objects immediately with `_validationStatus: "pending"` in metadata +- AND a `BackgroundValidationJob` MUST be queued via `IJobList::add()` +- AND the API response MUST include `validationJobId` for status polling + +#### Scenario: Background validation job completes successfully +- GIVEN a `BackgroundValidationJob` processes 1000 objects +- AND 50 objects have invalid references +- WHEN the job completes +- THEN the 50 invalid objects MUST have `_validationStatus: "failed"` set in metadata +- AND the 950 valid objects MUST have `_validationStatus: "valid"` set +- AND a notification MUST be sent to the importing user via Nextcloud's `INotificationManager` + +#### Scenario: Background validation job with transient errors +- GIVEN the database is temporarily unavailable during background validation +- WHEN the job encounters a connection error +- THEN the job MUST be retried up to 3 times with exponential backoff +- AND objects that could not be validated MUST have `_validationStatus: "retry_pending"` + +### Requirement: Validation events MUST be dispatched for notification and extensibility +The reference validation pipeline MUST dispatch Nextcloud events via `IEventDispatcher` at key points, allowing other apps and listeners to react to validation outcomes. + +#### Scenario: Validation failure event dispatched +- GIVEN a save that fails reference validation +- WHEN the `ValidationException` is about to be thrown +- THEN a `ReferenceValidationFailedEvent` MUST be dispatched with: + - The object data that was being saved + - The property name, invalid UUID, and target schema + - The register and schema context +- AND other apps MAY listen to this event for custom notification or logging + +#### Scenario: Validation success event dispatched for monitored schemas +- GIVEN a schema with `configuration.emitValidationEvents: true` +- AND a save succeeds with all references validated +- WHEN the save completes +- THEN a `ReferenceValidationSucceededEvent` MUST be dispatched with the validated property names and UUIDs +- AND this event MUST only be dispatched when `emitValidationEvents` is enabled (performance optimization) + +#### Scenario: Event listeners do not block the save pipeline +- GIVEN a registered listener for `ReferenceValidationFailedEvent` +- AND the listener throws an exception +- WHEN the event is dispatched +- THEN the exception MUST be caught and logged +- AND the original validation error MUST still be returned to the client +- AND the save pipeline MUST NOT be affected by listener failures + +### Requirement: Schema-configurable validation strictness levels MUST be supported +Schemas MUST support a `validationStrictness` configuration that controls the severity of reference validation failures. Three levels MUST be supported: `strict` (fail on invalid reference, default when `validateReference: true`), `warn` (log warning but allow save), and `off` (no validation). + +#### Scenario: Strict validation (default) +- GIVEN a schema property with `validateReference: true` and no `validationStrictness` set +- WHEN an object is saved with a nonexistent reference +- THEN the save MUST fail with HTTP 422 (same as current behavior) + +#### Scenario: Warn-level validation +- GIVEN a schema property with: + ```json + { + "assignee": { + "type": "string", + "$ref": "person", + "validateReference": true, + "validationStrictness": "warn" + } + } + ``` +- WHEN an object is saved with `assignee` = `"nonexistent-uuid"` +- THEN the save MUST succeed +- AND a warning MUST be logged: `"[SaveObject] Reference validation warning: Referenced object 'nonexistent-uuid' not found in schema 'person' for property 'assignee'"` +- AND the response MUST include a `_warnings` array with the validation warning +- AND `_validationStatus` in metadata MUST be set to `"warnings"` + +#### Scenario: Off-level validation overrides validateReference +- GIVEN a schema property with `validateReference: true` and `validationStrictness: "off"` +- WHEN an object is saved with a nonexistent reference +- THEN no validation check MUST be performed +- AND the save MUST succeed silently + +## Current Implementation Status + +**Substantially implemented.** Core requirements are in place with room for enhancement: + +- `lib/Service/Object/SaveObject.php`: + - `validateReferences()` (line ~3351) -- iterates schema properties, finds those with `$ref` and `validateReference: true`, checks existence + - `validateReferenceExists()` (line ~3428) -- validates individual UUID against target schema using `resolveSchemaReference()` and `MagicMapper::find()` with `_rbac: false`, `_multitenancy: false` + - `resolveSchemaReference()` (line ~336) -- resolves `$ref` by numeric ID, UUID, slug, JSON Schema path, or URL, with `$schemaReferenceCache` for performance + - Called in both `createObject()` (line ~3186) and `updateObject()` (line ~3264) + - On updates, unchanged references are skipped (compares old vs new data with strict equality) + - Null/empty values are skipped (not validated) + - Cross-register reference support via `register` property config with `getCachedRegister()` fallback + - Unresolvable schemas or registers log warnings but do not block saves (graceful degradation) +- Array references are validated (each UUID in array checked individually) +- Returns HTTP 422 via `ValidationException` with descriptive error messages including property name, UUID, and target schema slug +- GraphQL mutations (`GraphQLResolver::resolveCreate()` and `resolveUpdate()`) catch `ValidationException` and surface as GraphQL errors with `VALIDATION_ERROR` code +- Non-existence errors (e.g., database errors) are logged as warnings but do not block saves + +**What is NOT yet implemented:** +- Batch reference validation optimization for bulk imports (currently validates one UUID at a time) +- Structured error response with machine-readable `details` object (currently only has `message` string) +- Async validation for large batches via `BackgroundValidationJob` +- Validation events via `IEventDispatcher` (`ReferenceValidationFailedEvent`, `ReferenceValidationSucceededEvent`) +- `_skipValidation` admin bypass parameter +- `validationStrictness` levels (warn, off) -- currently only strict behavior +- `validateExternalReference` for URL-based references +- Multiple validation error collection (currently throws on first invalid reference) +- Request-scoped existence result caching (schema resolution is cached, but individual UUID existence is not) +- Soft-deleted reference handling is implicit (depends on `MagicMapper::find()` behavior) + +## Standards & References +- JSON Schema `$ref` keyword (RFC draft-bhutton-json-schema-01) +- OpenRegister internal schema property format (custom `validateReference` extension to JSON Schema) +- HTTP 422 Unprocessable Entity (RFC 4918) +- GraphQL specification (June 2018) -- error handling in mutations +- Nextcloud IEventDispatcher (OCP\EventDispatcher\IEventDispatcher) +- Nextcloud IJobList (OCP\BackgroundJob\IJobList) for async validation jobs +- Nextcloud INotificationManager (OCP\Notification\INotificationManager) for validation result notifications + +## Specificity Assessment +- **Specific enough to implement?** Yes -- the core scenarios match existing code behavior and new scenarios provide clear GIVEN/WHEN/THEN for each enhancement. +- **Missing/ambiguous:** + - Exact batch size for bulk reference validation queries (suggested: 50, consistent with `RelationHandler::bulkLoadRelationshipsBatched()`) + - Whether `_skipValidation` should also skip JSON Schema validation or only reference validation + - How `validationStrictness: "warn"` interacts with `hardValidation` schema setting + - Cache eviction strategy for request-scoped existence cache when objects are created mid-request via cascade +- **Open questions:** + - Should external URL validation support OAuth2 bearer tokens for authenticated APIs? + - Should async validation results be exposed via a dedicated API endpoint or only via object metadata? + +## Nextcloud Integration Analysis + +**Status**: Implemented (core), Enhancement opportunities identified + +**Existing Implementation**: `SaveObject.php` contains `validateReferences()` which iterates schema properties to find those with `$ref` and `validateReference: true`, then checks existence via `validateReferenceExists()`. The `resolveSchemaReference()` method resolves `$ref` by numeric ID, UUID, slug, JSON Schema path, or URL with aggressive caching in `$schemaReferenceCache`. Validation is called in both `createObject()` and `updateObject()` flows. On updates, unchanged references are skipped by comparing old vs new data. Array references are validated individually per UUID. Null/empty values are skipped. Cross-register reference support is available via the `register` property configuration. HTTP 422 responses include descriptive error messages with property name, UUID, and target schema name. GraphQL mutations in `GraphQLResolver` catch `ValidationException` and surface them as GraphQL errors with `VALIDATION_ERROR` extension code. + +**Nextcloud Core Integration Points**: +- **IDBConnection**: Reference validation runs within the save transaction, ensuring checks occur before data is committed. The `MagicMapper::find()` call used for existence checks operates within Nextcloud's database abstraction layer. +- **IEventDispatcher** (pending): Dispatch `ReferenceValidationFailedEvent` and `ReferenceValidationSucceededEvent` for extensibility. Other apps can listen for validation failures to trigger notifications or remediation workflows. +- **IJobList** (pending): Queue `BackgroundValidationJob` for async validation of large batches, using Nextcloud's cron infrastructure. +- **INotificationManager** (pending): Send notifications to users when async validation completes, indicating which objects have invalid references. +- **ICache (OCP\ICache)** (pending): Cache existence check results in Nextcloud's distributed cache (Redis/APCu) for request-scoped optimization, especially beneficial during bulk operations. +- **LoggerInterface (PSR-3)**: All validation warnings and errors are logged via Nextcloud's logger, visible in the admin log viewer. +- **IConfig**: External URL validation MUST use Nextcloud's proxy settings from `IConfig` for HTTP requests. + +**Recommendation**: The reference existence validation is functional for single-object saves and works correctly through both REST and GraphQL APIs. Priority enhancements: (1) batch reference validation for imports to reduce N+1 queries; (2) request-scoped existence caching alongside schema caching; (3) structured error responses with machine-readable details; (4) `IEventDispatcher` integration for validation events; (5) `validationStrictness` levels for flexible validation policies. diff --git a/openspec/changes/referential-integrity/specs/referential-integrity/spec.md b/openspec/changes/referential-integrity/specs/referential-integrity/spec.md new file mode 100644 index 000000000000..c9d71717bad3 --- /dev/null +++ b/openspec/changes/referential-integrity/specs/referential-integrity/spec.md @@ -0,0 +1,501 @@ +--- +status: implemented +--- + +# Referential Integrity + +## Purpose +Enforce referential integrity between register objects connected via `$ref` schema properties so that modifications or deletions of referenced objects propagate correctly according to configurable integrity actions (CASCADE, SET_NULL, SET_DEFAULT, RESTRICT, NO_ACTION). The system MUST maintain data consistency across schemas, detect circular reference chains, support cross-register references, and provide auditable, transactional enforcement that prevents orphaned references while respecting performance constraints on deep reference graphs. + +**Source**: Core OpenRegister capability for data consistency across related objects. Aligns with SQL standard referential integrity semantics adapted for a document-oriented register model with JSON Schema `$ref` relations. + +**Cross-references**: reference-existence-validation (save-time validation), deletion-audit-trail (audit logging for integrity actions), content-versioning (version impact of cascade mutations). + +## ADDED Requirements + +### Requirement 1: Schema properties with $ref MUST support configurable onDelete behavior +Properties that reference other schemas via `$ref` MUST define what happens when the referenced object is deleted. The system MUST support five onDelete actions: `CASCADE`, `SET_NULL`, `SET_DEFAULT`, `RESTRICT`, and `NO_ACTION` (default). The `onDelete` value MUST be stored on the schema property definition alongside `$ref` and SHALL be validated against the `VALID_ON_DELETE_ACTIONS` constant in `ReferentialIntegrityService`. + +#### Scenario: Configure CASCADE delete +- **GIVEN** schema `order` with property `assignee` referencing schema `person` via `$ref` +- **AND** the property has `onDelete: CASCADE` +- **WHEN** person `person-1` is deleted +- **THEN** all orders referencing `person-1` MUST also be soft-deleted +- **AND** cascade deletions MUST be recursive (if orders have dependent objects with CASCADE, those cascade too) +- **AND** each cascade-deleted object MUST appear in the `DeletionAnalysis.cascadeTargets` array + +#### Scenario: Configure SET_NULL on a non-required property +- **GIVEN** schema `order` with property `assignee` referencing schema `person` with `onDelete: SET_NULL` +- **AND** `assignee` is NOT in the schema's `required` array +- **WHEN** person `person-1` is deleted +- **THEN** all orders with `assignee: "person-1"` MUST have `assignee` set to `null` +- **AND** the orders themselves MUST NOT be deleted +- **AND** `ReferentialIntegrityService::applySetNull()` MUST update via `MagicMapper::update()` + +#### Scenario: SET_NULL falls back to RESTRICT on required property +- **GIVEN** schema `order` with property `assignee` referencing schema `person` with `onDelete: SET_NULL` +- **AND** `assignee` IS in the schema's `required` array +- **WHEN** person `person-1` deletion is analyzed via `canDelete()` +- **THEN** `ReferentialIntegrityService::isRequiredProperty()` MUST detect the required constraint +- **AND** the dependent orders MUST appear as blockers (not nullify targets) +- **AND** the chain path MUST include the annotation `(SET_NULL on required -> RESTRICT)` + +#### Scenario: Configure SET_DEFAULT with a valid default value +- **GIVEN** schema `order` with property `assignee` referencing schema `person` with `onDelete: SET_DEFAULT` +- **AND** the property has `default: "system-user-uuid"` +- **WHEN** person `person-1` is deleted +- **THEN** all orders with `assignee: "person-1"` MUST have `assignee` set to `"system-user-uuid"` +- **AND** `ReferentialIntegrityService::getDefaultValue()` MUST resolve the default from the schema property definition + +#### Scenario: SET_DEFAULT without a default falls back to SET_NULL or RESTRICT +- **GIVEN** schema `order` with property `assignee` with `onDelete: SET_DEFAULT` but no `default` defined +- **AND** `assignee` is NOT required +- **WHEN** person `person-1` is deleted +- **THEN** `getDefaultValue()` returns `null`, so the system MUST fall back to SET_NULL behavior +- **AND** `assignee` MUST be set to `null` + +#### Scenario: Configure RESTRICT +- **GIVEN** schema `order` with property `assignee` referencing schema `person` with `onDelete: RESTRICT` +- **AND** 3 orders reference person `person-1` +- **WHEN** deletion of person `person-1` is attempted +- **THEN** `DeletionAnalysis.deletable` MUST be `false` +- **AND** `DeletionAnalysis.blockers` MUST contain 3 entries, each with `objectUuid`, `schema`, `property`, and `action: RESTRICT` +- **AND** `DeleteObject::deleteObject()` MUST throw `ReferentialIntegrityException` +- **AND** the API MUST return HTTP 409 Conflict with `ReferentialIntegrityException::toResponseBody()` containing the blocker list + +#### Scenario: Configure NO_ACTION (default) +- **GIVEN** no `onDelete` is specified on the property (defaults to NO_ACTION) +- **WHEN** the referenced person is deleted +- **THEN** `ReferentialIntegrityService::extractOnDelete()` returns `null` or `NO_ACTION` +- **AND** the property is skipped during relation indexing +- **AND** orders with the now-broken reference MUST NOT be modified +- **AND** the broken reference is the caller's responsibility (eventual consistency) + +### Requirement 2: Referential integrity MUST apply within database transactions +All integrity actions (CASCADE, SET_NULL, SET_DEFAULT) and the root deletion MUST be atomic. `DeleteObject::executeIntegrityTransaction()` MUST wrap all operations in `IDBConnection::beginTransaction()` / `commit()` / `rollBack()`. + +#### Scenario: Atomic CASCADE with rollback on failure +- **GIVEN** person `person-1` has 5 related orders with CASCADE +- **WHEN** person `person-1` is deleted +- **AND** the 4th order cascade-delete fails (e.g., database error) +- **THEN** `IDBConnection::rollBack()` MUST be called +- **AND** ALL 5 orders, plus the person, MUST remain unchanged in the database +- **AND** the error MUST be logged via `LoggerInterface::error()` with context including UUID and error message + +#### Scenario: Mixed actions in a single transaction +- **GIVEN** person `person-1` is referenced by 2 orders (CASCADE) and 3 tasks (SET_NULL) +- **WHEN** person `person-1` is deleted +- **THEN** `applyDeletionActions()` MUST process SET_NULL first, then SET_DEFAULT, then CASCADE (deepest first) +- **AND** all 5 mutations plus the root delete MUST succeed or all MUST roll back +- **AND** `DeleteObject::getLastCascadeCount()` MUST return 5 (2 cascade + 3 nullify) + +#### Scenario: Nested transaction via Doctrine savepoints +- **GIVEN** a CASCADE chain: person -> order -> line-item (all CASCADE) +- **WHEN** person is deleted +- **THEN** Nextcloud's database abstraction (Doctrine DBAL) MUST handle nested transactions via savepoints +- **AND** the graph walk in `walkDeletionGraph()` MUST recurse to depth 2 and collect all targets before mutations begin + +### Requirement 3: Circular references MUST be detected and handled safely +The system MUST detect circular reference chains and prevent infinite cascades. `ReferentialIntegrityService` MUST enforce two safeguards: visited-UUID tracking (cycle detection) and `MAX_DEPTH = 10` (depth limiting). + +#### Scenario: Circular CASCADE detection via visited set +- **GIVEN** schema A references schema B (CASCADE) and schema B references schema A (CASCADE) +- **AND** object `a-1` references `b-1`, and `b-1` references `a-1` +- **WHEN** object `a-1` is deleted +- **THEN** `walkDeletionGraph()` MUST add `a-1` to the `$visited` array +- **AND** when recursion reaches `a-1` again, `in_array($uuid, $visited)` MUST return `true` +- **AND** the recursion MUST return `DeletionAnalysis::empty()` for that branch +- **AND** each object MUST be processed at most once + +#### Scenario: Depth limit prevents pathological chains +- **GIVEN** a chain of 15 schemas each referencing the next with CASCADE +- **WHEN** the root object is deleted +- **THEN** `walkDeletionGraph()` MUST stop at `$depth >= MAX_DEPTH` (10) +- **AND** a warning MUST be logged: `[ReferentialIntegrity] Max depth reached during graph walk` +- **AND** objects beyond depth 10 MUST NOT be cascade-deleted (treated as NO_ACTION) + +#### Scenario: Self-referencing schema +- **GIVEN** schema `category` has property `parentCategory` referencing itself with `onDelete: CASCADE` +- **AND** a tree: root -> child-1 -> child-2 -> child-3 +- **WHEN** `root` is deleted +- **THEN** `child-1`, `child-2`, and `child-3` MUST all be cascade-deleted +- **AND** the visited set MUST prevent re-processing if any child also references another in the chain + +### Requirement 4: Reference validation MUST be configurable on save +The system MUST support a `validateReference` boolean on schema properties. When enabled, the save pipeline SHALL verify that the UUID stored in a `$ref` property corresponds to an existing object in the target schema before persisting. See the reference-existence-validation spec for full details. + +#### Scenario: Validate reference on save (enabled) +- **GIVEN** property `assignee` with `$ref: "person"` and `validateReference: true` +- **WHEN** an order is created with `assignee: "nonexistent-uuid"` +- **THEN** `SaveObject::validateReferences()` MUST reject the save with HTTP 422 +- **AND** the error message MUST include: `"Referenced object 'nonexistent-uuid' not found in schema 'person' for property 'assignee'"` + +#### Scenario: Validate reference on save (disabled, default) +- **GIVEN** property `assignee` with `$ref: "person"` and no `validateReference` set +- **WHEN** an order is created with `assignee: "nonexistent-uuid"` +- **THEN** the save MUST succeed (eventual consistency pattern) +- **AND** the reference MAY become broken if the UUID never exists + +#### Scenario: Array reference with partial invalid UUIDs +- **GIVEN** property `members` is `type: array` with `items.$ref: "person"` and `validateReference: true` +- **WHEN** an object is saved with `members: ["valid-uuid", "nonexistent-uuid"]` +- **THEN** the save MUST fail with HTTP 422 identifying `nonexistent-uuid` as invalid + +#### Scenario: Update with unchanged reference skips validation +- **GIVEN** an existing object with `assignee: "person-uuid"` and `validateReference: true` +- **AND** the referenced person has since been soft-deleted +- **WHEN** the object is updated with `assignee: "person-uuid"` (same value) +- **THEN** `SaveObject::validateReferences()` MUST skip validation for unchanged values +- **AND** the save MUST succeed + +### Requirement 5: Orphan detection and cleanup MUST be supported for inversedBy relations +When a parent object is updated and sub-objects are removed from an `inversedBy` array property, the system MUST detect and soft-delete orphaned sub-objects. `SaveObject::deleteOrphanedRelatedObjects()` handles this cleanup. + +#### Scenario: Sub-objects removed during update are soft-deleted +- **GIVEN** an `incident` object with property `notes` (array, `inversedBy: "incident"`, `cascade: true`) +- **AND** the incident has 3 notes: `[note-1, note-2, note-3]` +- **WHEN** the incident is updated with `notes: [note-1, note-3]` +- **THEN** `note-2` MUST be detected as orphaned via `array_diff($oldUuids, $newUuids)` +- **AND** `note-2` MUST be soft-deleted with deletion metadata `reason: "orphaned-related-object"` + +#### Scenario: Orphan removal respects writeBack configuration +- **GIVEN** a property with `inversedBy` and `writeBack: true` +- **WHEN** the parent object is updated and sub-objects are removed +- **THEN** `SaveObject` MUST skip orphan cleanup for writeBack-enabled properties (handled by the write-back method instead) + +#### Scenario: No orphan removal for properties without cascade +- **GIVEN** a property with `$ref` but without `cascade: true` or `inversedBy` +- **WHEN** the parent object is updated and referenced UUIDs are removed +- **THEN** no orphan cleanup SHALL occur (the references are plain pointers, not owned sub-objects) + +### Requirement 6: Bidirectional reference consistency via inversedBy and writeBack +When a schema property has `inversedBy` configuration, the system MUST maintain bidirectional consistency. Creating or deleting a child object MUST update the parent's reference array, and vice versa. The `CascadingHandler` and `RelationCascadeHandler` coordinate this. + +#### Scenario: Cascade create populates inverse reference +- **GIVEN** schema `incident` has property `notes` with `type: array`, `items.$ref: "note"`, `items.inversedBy: "incident"` +- **WHEN** an incident is created with inline note objects in the `notes` array +- **THEN** `CascadingHandler::handlePreValidationCascading()` MUST create each note via `SaveObject::saveObject()` +- **AND** each created note MUST have `incident: "{parent-uuid}"` set automatically +- **AND** the incident's `notes` array MUST be replaced with the created note UUIDs + +#### Scenario: WriteBack updates the inverse side +- **GIVEN** a property with `inversedBy: "incident"` and `writeBack: true` +- **WHEN** a note is saved referencing `incident: "incident-uuid"` +- **THEN** the incident's `notes` array MUST be updated to include the note's UUID +- **AND** if the note is removed from the incident, the note's `incident` field MUST be cleared + +#### Scenario: Resolve schema reference via multiple formats +- **GIVEN** `RelationCascadeHandler::resolveSchemaReference()` accepts references in multiple formats +- **WHEN** a `$ref` is provided as numeric ID, UUID, slug, JSON Schema path (`#/components/schemas/Note`), or URL +- **THEN** the system MUST resolve to the correct schema ID using case-insensitive slug matching + +### Requirement 7: Cross-register references MUST be supported and enforced +When a `$ref` property includes a `register` configuration pointing to a different register, referential integrity MUST apply across register boundaries. `ReferentialIntegrityService::buildSchemaRegisterMap()` maps schemas to registers via magic table naming conventions. + +#### Scenario: Cross-register CASCADE delete +- **GIVEN** schema `order` in register `commerce` references schema `person` in register `crm` with `onDelete: CASCADE` +- **WHEN** person `person-1` in register `crm` is deleted +- **THEN** `findReferencingInMagicTable()` MUST query the magic table `oc_openregister_table_{commerceId}_{orderId}` +- **AND** all orders referencing `person-1` MUST be cascade-deleted + +#### Scenario: Cross-register RESTRICT block +- **GIVEN** schema `contract` in register `legal` references schema `organisation` in register `crm` with `onDelete: RESTRICT` +- **WHEN** organisation deletion is attempted +- **THEN** the RESTRICT block MUST apply even though the blocker is in a different register +- **AND** the blocker info MUST include the source schema ID from the `legal` register + +#### Scenario: Schema-register map built from magic table names +- **GIVEN** magic tables exist with naming convention `oc_openregister_table_{registerId}_{schemaId}` +- **WHEN** `buildSchemaRegisterMap()` runs +- **THEN** it MUST query `information_schema.tables` for tables matching the pattern +- **AND** populate `$schemaRegisterMap` mapping schema IDs to Register entities +- **AND** this map MUST be cached for the duration of the request + +### Requirement 8: Reference type validation MUST enforce correct structure +References stored in object data MUST be valid UUIDs (or resolvable reference formats). `RelationCascadeHandler::isReference()` and `looksLikeObjectReference()` define what constitutes a valid reference. + +#### Scenario: UUID reference (with dashes) +- **GIVEN** a property with `$ref` pointing to another schema +- **WHEN** the value `"550e8400-e29b-41d4-a716-446655440000"` is stored +- **THEN** `isReference()` MUST return `true` +- **AND** the value MUST be accepted as a valid reference + +#### Scenario: UUID reference (without dashes) +- **GIVEN** a `$ref` property +- **WHEN** the value `"550e8400e29b41d4a716446655440000"` is stored +- **THEN** `isReference()` MUST return `true` (32 hex chars pattern) + +#### Scenario: URL reference with /objects/ path +- **GIVEN** a `$ref` property +- **WHEN** the value `"https://example.com/api/objects/550e8400-e29b-41d4-a716-446655440000"` is stored +- **THEN** `isReference()` MUST return `true` +- **AND** `extractUuidFromReference()` MUST extract the UUID from the URL path + +#### Scenario: Invalid reference format rejected +- **GIVEN** a `$ref` property with `validateReference: true` +- **WHEN** the value `"not-a-valid-reference-format"` is stored +- **THEN** `isReference()` MUST return `false` +- **AND** if validateReference is enabled, the save MUST fail with HTTP 422 + +### Requirement 9: Bulk operations MUST respect referential integrity per object +Bulk delete operations via `ObjectService::deleteObjects()` MUST process integrity rules for each affected object individually. Objects blocked by RESTRICT MUST be skipped, and the response MUST include aggregate counts. + +#### Scenario: Bulk delete with CASCADE +- **GIVEN** 10 persons are selected for bulk deletion +- **AND** each person has 2 related orders with CASCADE +- **WHEN** the bulk delete is executed +- **THEN** `deleteObjects()` MUST call `DeleteObject::deleteObject()` for each person +- **AND** all persons AND their 20 related orders MUST be soft-deleted +- **AND** the response MUST include `cascade_count: 20` and `total_affected: 30` + +#### Scenario: Bulk delete with RESTRICT-blocked items +- **GIVEN** 5 persons are selected for bulk deletion +- **AND** 2 persons have RESTRICT-constrained references +- **WHEN** the bulk delete is executed +- **THEN** the 3 unrestricted persons MUST be deleted with their cascades +- **AND** the 2 restricted persons MUST be skipped +- **AND** the response MUST include `skipped_uuids: ["uuid-4", "uuid-5"]` with the reason + +#### Scenario: Bulk delete transaction isolation +- **GIVEN** 100 objects are selected for bulk deletion +- **WHEN** the bulk delete is executed +- **THEN** each object's integrity check and cascade MUST run within its own transaction scope +- **AND** a failure on object #50 MUST NOT roll back deletions of objects #1-#49 + +### Requirement 10: Referential integrity actions MUST be audited +Each integrity action MUST produce an audit trail entry via `ReferentialIntegrityService::logIntegrityAction()` and `AuditTrailMapper::createAuditTrail()`. The audit trail MUST distinguish user-initiated deletions from system-triggered integrity actions. + +#### Scenario: Audit CASCADE action +- **GIVEN** person deletion triggers CASCADE deletion of 3 orders +- **THEN** at least 4 audit trail entries MUST be created: + - 1 for the person deletion with `action_type: referential_integrity.root_delete` and cascade counts + - 3 for the order deletions with `action: referential_integrity.cascade_delete` +- **AND** each cascade entry MUST include `triggeredBy: referential_integrity`, `triggerObject`, `triggerSchema`, and `property` in the `changed` metadata + +#### Scenario: Audit RESTRICT block +- **GIVEN** person deletion is blocked by RESTRICT +- **THEN** `logRestrictBlock()` MUST create an audit entry with `action: referential_integrity.restrict_blocked` +- **AND** the entry MUST include `blockerCount`, `blockerSchema`, `blockerProperty`, and `reason` + +#### Scenario: Audit SET_NULL and SET_DEFAULT actions +- **GIVEN** person deletion triggers SET_NULL on 2 tasks and SET_DEFAULT on 1 contract +- **THEN** 3 audit entries MUST be created: + - 2 with `action: referential_integrity.set_null` including `property`, `previousValue`, `newValue: null` + - 1 with `action: referential_integrity.set_default` including `property`, `previousValue`, `defaultValue` + +#### Scenario: Audit trail expiry +- **GIVEN** an integrity action audit entry is created +- **THEN** the entry MUST have `expires` set to 30 days from creation +- **AND** expired entries SHALL be eligible for cleanup per the deletion-audit-trail spec + +### Requirement 11: API _extend parameter MUST support lazy and eager reference resolution +The API MUST support an `_extend` query parameter that controls whether referenced objects are resolved inline (eager) or returned as UUIDs (lazy, default). `RelationHandler::extractAllRelationshipIds()` and `bulkLoadRelationshipsBatched()` handle bulk resolution. + +#### Scenario: Lazy resolution (default) +- **GIVEN** an order object with `assignee: "person-uuid"` +- **WHEN** `GET /api/objects/{register}/{schema}/{uuid}` is called without `_extend` +- **THEN** the response MUST return `assignee: "person-uuid"` (UUID only) + +#### Scenario: Eager resolution with _extend +- **GIVEN** an order object with `assignee: "person-uuid"` +- **WHEN** `GET /api/objects/{register}/{schema}/{uuid}?_extend=assignee` is called +- **THEN** `RelationHandler::bulkLoadRelationshipsBatched()` MUST resolve the UUID +- **AND** the response MUST return the full person object inline under `assignee` + +#### Scenario: Performance circuit breaker on relationship loading +- **GIVEN** an object with 500 relationship IDs across multiple properties +- **WHEN** `_extend` is requested +- **THEN** `extractAllRelationshipIds()` MUST cap extraction at `$maxIds = 200` +- **AND** `bulkLoadRelationshipsBatched()` MUST process in batches of 50 +- **AND** array relationships per object MUST be limited to 10 entries + +#### Scenario: _extend across registers +- **GIVEN** an order with `customer` referencing a person in a different register +- **WHEN** `_extend=customer` is requested +- **THEN** `getUses()` MUST search across all magic tables (register+schema pairs) to find the referenced object +- **AND** RBAC filtering MUST be applied to extended objects via `filterByRbac()` + +### Requirement 12: Relation graph MUST support bidirectional traversal (uses/usedBy) +The system MUST provide API endpoints to traverse the relation graph in both directions: outgoing references (uses) and incoming references (usedBy). `RelationHandler::getUses()` and `RelationHandler::getUsedBy()` implement this. + +#### Scenario: Get outgoing references (uses) +- **GIVEN** an order object that references person `p-1` and product `prod-1` +- **WHEN** `GET /api/objects/{register}/{schema}/{uuid}/uses` is called +- **THEN** `RelationHandler::getUses()` MUST extract UUIDs from `getRelations()` on the object +- **AND** MUST search across all magic tables to resolve the referenced objects +- **AND** MUST return paginated results with `total`, `limit`, `offset` + +#### Scenario: Get incoming references (usedBy) +- **GIVEN** person `p-1` is referenced by 5 orders and 3 tasks +- **WHEN** `GET /api/objects/{register}/{schema}/{uuid}/used` is called +- **THEN** `RelationHandler::getUsedBy()` MUST search `_relations_contains` across all magic tables +- **AND** MUST return 8 results (paginated) +- **AND** the object itself MUST be excluded from results (no self-references) + +#### Scenario: Self-reference filtered from uses +- **GIVEN** an object whose `_relations` array includes its own UUID +- **WHEN** `getUses()` is called +- **THEN** the object's own UUID MUST be filtered out before loading related objects + +### Requirement 13: Performance MUST be bounded for deep reference chains +The system MUST enforce performance boundaries to prevent timeout on complex reference graphs. This includes depth limits, batch sizes, and circuit breakers. + +#### Scenario: Relation index cached per request +- **GIVEN** 50 schemas exist in the system +- **WHEN** multiple objects are deleted in a single request +- **THEN** `ensureRelationIndex()` MUST build the index only once (cached in `$relationIndex`) +- **AND** subsequent `canDelete()` calls MUST reuse the cached index + +#### Scenario: Magic table direct query for referencing objects +- **GIVEN** a schema has a known register+schema mapping in `$schemaRegisterMap` +- **WHEN** `findReferencingObjects()` looks for objects referencing a deleted UUID +- **THEN** it MUST use `findReferencingInMagicTable()` to query the specific magic table column directly +- **AND** for scalar properties, it MUST use an exact `=` match +- **AND** for array properties on PostgreSQL, it MUST use `::jsonb @> to_jsonb(?::text)` +- **AND** for array properties on MySQL, it MUST use `JSON_CONTAINS()` +- **AND** results MUST be limited to 100 rows per query + +#### Scenario: Fallback to findByRelation when no magic table mapping exists +- **GIVEN** a schema without a register mapping in `$schemaRegisterMap` +- **WHEN** `findReferencingObjects()` is called +- **THEN** it MUST fall back to `MagicMapper::findByRelation()` for broad search +- **AND** MUST filter results by schema and property name in PHP + +#### Scenario: Batch CASCADE delete grouped by register+schema +- **GIVEN** 20 objects need to be cascade-deleted, spread across 3 schemas +- **WHEN** `applyBatchCascadeDelete()` is called +- **THEN** targets MUST be grouped by `registerId::schemaId` +- **AND** each group MUST be deleted via a single `MagicMapper::deleteObjects()` call +- **AND** audit trail entries MUST still be created individually per object + +### Requirement 14: Array-type reference properties MUST be handled correctly +Properties with `type: array` and `items.$ref` MUST be handled differently from scalar `$ref` properties for all integrity actions (SET_NULL removes the UUID from the array rather than nullifying the whole property). + +#### Scenario: SET_NULL on array property removes specific UUID +- **GIVEN** schema `team` has property `members` with `type: array`, `items.$ref: "person"`, `onDelete: SET_NULL` +- **AND** a team has `members: ["p-1", "p-2", "p-3"]` +- **WHEN** person `p-2` is deleted +- **THEN** `applySetNull()` MUST detect `isArray: true` from the target metadata +- **AND** MUST filter `p-2` from the array: `members: ["p-1", "p-3"]` +- **AND** MUST NOT set the entire `members` property to `null` + +#### Scenario: CASCADE on array property applies to each referenced object +- **GIVEN** schema `department` has property `employees` with `type: array`, `items.$ref: "person"`, `onDelete: CASCADE` +- **WHEN** a person referenced in the employees array is deleted +- **THEN** the department itself MUST be cascade-deleted (the department references the person, so the department is the dependent) + +#### Scenario: Relation index correctly identifies array properties +- **GIVEN** a schema property with `type: array` and `items.$ref` +- **WHEN** `indexRelationsForSchema()` builds the relation index +- **THEN** the index entry MUST have `isArray: true` +- **AND** `extractTargetRef()` MUST extract the `$ref` from `items.$ref` + +### Requirement 15: Multi-tenancy and RBAC MUST be respected during integrity enforcement +Referential integrity operations MUST bypass RBAC and multi-tenancy filters when scanning for dependent objects (system-level enforcement), but MUST respect them when loading schemas and registers for user-facing operations. + +#### Scenario: Integrity scan bypasses RBAC +- **GIVEN** a user deletes object X which triggers CASCADE on objects owned by other users +- **WHEN** `ReferentialIntegrityService::ensureRelationIndex()` loads all schemas +- **THEN** it MUST pass `_rbac: false` and `_multitenancy: false` to `SchemaMapper::findAll()` and `RegisterMapper::findAll()` +- **AND** ALL schemas MUST be indexed regardless of user permissions + +#### Scenario: Cascade delete applies to all matching objects regardless of ownership +- **GIVEN** person `p-1` is referenced by orders owned by 3 different users +- **AND** the deleting user only has access to their own orders +- **WHEN** person `p-1` is deleted with CASCADE +- **THEN** ALL 3 users' orders MUST be cascade-deleted (integrity enforcement is system-level) +- **AND** `MagicMapper::deleteObjects()` MUST operate without RBAC filtering + +#### Scenario: usedBy and uses endpoints respect RBAC for display +- **GIVEN** person `p-1` is referenced by 5 orders, but the current user only has RBAC access to 3 +- **WHEN** `getUses()` is called with `_rbac: true` +- **THEN** `filterByRbac()` MUST check schema authorization for each result +- **AND** only the 3 accessible orders MUST be returned + +## Current Implementation Status + +**Substantially implemented.** Core referential integrity logic exists: + +- `lib/Service/Object/ReferentialIntegrityService.php` -- Main service class with: + - All 5 `onDelete` actions supported: `CASCADE`, `RESTRICT`, `SET_NULL`, `SET_DEFAULT`, `NO_ACTION` (defined in `VALID_ON_DELETE_ACTIONS` constant) + - `MAX_DEPTH = 10` for circular reference detection (prevents infinite recursion) + - Graph-walking logic (`walkDeletionGraph()`) for recursive cascade operations with visited-set cycle detection + - Relation index built once per request from all schemas (`ensureRelationIndex()`) + - Direct magic table queries via `findReferencingInMagicTable()` for PostgreSQL and MySQL with JSON containment support + - Batch cascade delete grouped by register+schema (`applyBatchCascadeDelete()`) + - Audit trail logging for all integrity actions (`logIntegrityAction()`, `logRestrictBlock()`) +- `lib/Dto/DeletionAnalysis.php` -- Immutable value object with `cascadeTargets`, `nullifyTargets`, `defaultTargets`, `blockers`, `chainPaths` +- `lib/Exception/ReferentialIntegrityException.php` -- Custom exception for RESTRICT blocks, returns HTTP 409 with structured `toResponseBody()` +- `lib/Service/Object/DeleteObject.php` -- Integrates with referential integrity: + - `handleIntegrityDeletion()` orchestrates the analysis-then-apply flow + - `executeIntegrityTransaction()` wraps all actions in `IDBConnection::beginTransaction()`/`commit()`/`rollBack()` + - `cascadeDeleteObjects()` handles legacy `cascade: true` property behavior + - `getLastCascadeCount()` returns total affected count +- `lib/Service/Object/SaveObject.php` -- Save-time integrity: + - `validateReferences()` validates `$ref` properties with `validateReference: true` + - `deleteOrphanedRelatedObjects()` cleans up orphaned sub-objects on update +- `lib/Service/Object/SaveObject/RelationCascadeHandler.php` -- Handles: + - `resolveSchemaReference()` -- multi-format schema resolution (ID, UUID, slug, path, URL) + - `resolveRegisterReference()` -- multi-format register resolution + - `scanForRelations()` -- recursive relation detection in object data + - `cascadeObjects()` -- pre-validation cascade creation for `inversedBy` properties +- `lib/Service/Object/CascadingHandler.php` -- Handles `inversedBy` cascade creation with `writeBack` support +- `lib/Service/Object/RelationHandler.php` -- Relation graph traversal: + - `getUses()` -- outgoing references with cross-register magic table search + - `getUsedBy()` -- incoming references via `_relations_contains` search + - `extractAllRelationshipIds()` with circuit breaker (200 max IDs) + - `bulkLoadRelationshipsBatched()` with 50-object batch size + - `filterByRbac()` for RBAC-filtered relation results +- `lib/Db/Schema.php` -- Schema property `onDelete`, `validateReference`, `inversedBy`, `writeBack`, `cascade` configuration +- Schema property `onDelete` configuration supported and validated + +**What is NOT yet implemented:** +- UI indication of referential integrity constraints (warning before deleting referenced objects, schema editor for `onDelete` configuration) +- `RelationCascadeHandler::cascadeSingleObject()` returns null (TODO: needs event system to avoid circular dependency with ObjectService) +- `RelationCascadeHandler::handleInverseRelationsWriteBack()` returns data unchanged (TODO: needs refactoring) + +**Recently implemented:** +- Full transactional atomicity: `DeleteObject::executeIntegrityTransaction()` wraps all cascade operations + root deletion in `IDBConnection::beginTransaction()`/`commit()`/`rollBack()` +- Audit trail tagging: root deletions get `action_type: referential_integrity.root_delete` with cascade counts; cascade deletions get `referential_integrity.cascade_delete` with trigger metadata +- Bulk delete with referential integrity: `ObjectService::deleteObjects()` processes each object through `DeleteObject::deleteObject()`, skipping RESTRICT-blocked objects, returning `cascade_count`, `total_affected`, `skipped_uuids` +- Direct magic table queries for performance: `findReferencingInMagicTable()` queries specific columns instead of scanning `_relations` JSONB +- SET_NULL fallback to RESTRICT for required properties, SET_DEFAULT fallback chain +- Orphan detection and cleanup in `SaveObject::deleteOrphanedRelatedObjects()` + +## Standards & References +- SQL standard referential integrity actions (CASCADE, SET NULL, SET DEFAULT, RESTRICT, NO ACTION) -- ISO/IEC 9075 +- HTTP 409 Conflict (RFC 9110) for RESTRICT violations +- HTTP 422 Unprocessable Entity (RFC 4918) for invalid reference validation +- Database transaction isolation levels (ACID principles) +- JSON Schema `$ref` keyword (RFC draft-bhutton-json-schema-01) +- Competitor analysis: Directus uses database-level foreign keys with 7 relationship types (M2O, O2M, M2M, M2A); Strapi uses 10 relation types with Document Service API; OpenRegister uses application-level integrity enforcement over JSON Schema `$ref` for maximum flexibility across database backends + +## Specificity Assessment +- **Specific enough to implement?** Yes -- the scenarios clearly define each action, fallback chains, transaction boundaries, and performance constraints with concrete references to implementation classes. +- **Missing/ambiguous:** + - No specification for how referential integrity interacts with soft-delete vs hard delete (currently all operations use soft-delete) + - No specification for webhooks/event dispatching for each cascaded object (should `IEventDispatcher` fire `BeforeObjectDeletedEvent`/`ObjectDeletedEvent` for cascade-deleted objects?) + - Schema migration impact: when a schema's `$ref` target changes, existing objects with old references are not automatically migrated +- **Resolved questions:** + - RESTRICT + bulk delete: skip restricted items and continue with the rest (implemented) + - SET_NULL on required property: falls back to RESTRICT (implemented) + - SET_DEFAULT without default: falls back to SET_NULL -> RESTRICT chain (implemented) + - Circular reference handling: visited-set + MAX_DEPTH=10 (implemented) + - Cross-register integrity: schema-register map from magic table names (implemented) + +## Nextcloud Integration Analysis + +**Status**: IMPLEMENTED (backend complete, UI pending) + +**What Exists**: The core referential integrity service (`ReferentialIntegrityService.php`) is in place with all five `onDelete` behaviors functional. `DeletionAnalysis` DTO encapsulates the graph-walk results. `DeleteObject.php` integrates with the integrity service, wrapping operations in `IDBConnection` transactions. `RelationHandler` provides bidirectional graph traversal (uses/usedBy) across all magic tables. `RelationCascadeHandler` resolves schema references in multiple formats and manages cascade creation for `inversedBy` properties. `CascadingHandler` handles pre-validation cascade creation. `SaveObject` handles reference validation on save and orphan cleanup on update. + +**Gap Analysis**: The `onDelete` attribute exists on schema properties but the UI does not yet expose a way to configure it visually. `cascadeSingleObject()` and `handleInverseRelationsWriteBack()` in `RelationCascadeHandler` are not yet functional (TODO: needs event system refactor). `IEventDispatcher` events are not yet fired for cascade-deleted objects, limiting visibility for other Nextcloud apps. + +**Nextcloud Core Integration Points**: +- **IDBConnection transaction management**: `DeleteObject::executeIntegrityTransaction()` uses `beginTransaction()` / `commit()` / `rollBack()` via Nextcloud's database abstraction layer (Doctrine DBAL), which supports nested transactions via savepoints for recursive cascades. +- **IEventDispatcher** (pending): Fire `BeforeObjectDeletedEvent` and `ObjectDeletedEvent` for each cascade-deleted object, allowing other apps (OpenCatalogi, OpenConnector) to react. Use `GenericEvent` with context metadata indicating referential integrity trigger. +- **LoggerInterface (PSR-3)**: All integrity operations log warnings and errors via Nextcloud's logger, visible in the Nextcloud log viewer. +- **ICache (OCP\ICache)**: Consider caching resolved schema references to avoid repeated lookups during bulk operations with many cross-references. +- **Activity app integration** (pending): Register cascade deletions as activity events so the Activity stream shows "Object X was deleted (cascade from Object Y deletion)". + +**Recommendation**: Remaining work priorities: (1) integrate `IEventDispatcher` for cascade-deleted objects; (2) add UI for `onDelete` configuration in schema editor; (3) add deletion confirmation dialog showing `DeletionAnalysis` preview (cascade count, affected objects); (4) complete `cascadeSingleObject()` and `handleInverseRelationsWriteBack()` via event system to break circular dependency with ObjectService. diff --git a/openspec/changes/register-i18n/specs/register-i18n/spec.md b/openspec/changes/register-i18n/specs/register-i18n/spec.md new file mode 100644 index 000000000000..ec782d06a8f5 --- /dev/null +++ b/openspec/changes/register-i18n/specs/register-i18n/spec.md @@ -0,0 +1,536 @@ +--- +status: partial +--- + +# Register Internationalization + +## Purpose + +Implement multi-language content management for register objects so that translatable properties store per-language variants, APIs negotiate content language via Accept-Language headers, and the UI provides language-aware editing with completeness tracking. The system MUST support at minimum Dutch (NL, required) and English (EN, optional) to comply with Single Digital Gateway (SDG) Regulation (EU) 2018/1724 for cross-border EU service access, while the architecture MUST allow registers to configure any number of BCP 47 languages including RTL scripts. This spec covers data-level i18n for register object content -- it is distinct from the app UI string translations governed by `i18n-infrastructure`, `i18n-string-extraction`, `i18n-backend-messages`, and `i18n-dutch-translations` specs, which handle Nextcloud `IL10N` / `t()` / `$l->t()` for interface labels. + +**Source**: Gap identified in cross-platform analysis; four competitors implement field-level i18n. SDG compliance requires English availability for cross-border services. ADR-005 mandates NL+EN as minimum languages for all Conduction apps. + +## Requirements + +### Requirement: Schema properties MUST support a translatable flag + +Schema property definitions MUST accept a `translatable: true` attribute indicating the field supports multiple language versions. Properties without the flag (or with `translatable: false`) SHALL store a single value regardless of language context. The `translatable` attribute MUST be stored as part of the property definition in the schema's `properties` JSON and MUST be inspectable by `TranslationHandler::getTranslatableProperties()`. + +#### Scenario: Define a translatable property +- **GIVEN** a schema `producten` with property `omschrijving` of type `string` +- **WHEN** the admin sets `translatable: true` on the `omschrijving` property definition +- **THEN** the schema's `properties` JSON SHALL contain `{"omschrijving": {"type": "string", "translatable": true}}` +- **AND** `TranslationHandler::getTranslatableProperties()` SHALL return `["omschrijving"]` + +#### Scenario: Non-translatable property remains unaffected +- **GIVEN** property `code` on schema `producten` with `translatable` not set (defaults to `false`) +- **WHEN** an object is created or rendered +- **THEN** the `code` property SHALL have a single value regardless of language +- **AND** `TranslationHandler` SHALL skip this property during normalization and resolution + +#### Scenario: Mark multiple properties as translatable +- **GIVEN** schema `producten` with properties `naam`, `omschrijving`, `categorie`, and `prijs` +- **WHEN** the admin marks `naam` and `omschrijving` as `translatable: true` but leaves `categorie` and `prijs` as non-translatable +- **THEN** `TranslationHandler::getTranslatableProperties()` SHALL return `["naam", "omschrijving"]` +- **AND** `categorie` and `prijs` SHALL behave as single-value properties + +#### Scenario: Translatable flag on nested object properties +- **GIVEN** schema `producten` with a property `details` of type `object` containing sub-properties +- **WHEN** the admin marks `details` as `translatable: true` +- **THEN** the entire `details` object SHALL be stored per language as `{"nl": {...}, "en": {...}}` +- **AND** sub-properties SHALL NOT individually support the `translatable` flag (translation granularity is at the top-level property) + +#### Scenario: Translatable flag in schema UI editor +- **GIVEN** the schema property editor in the OpenRegister admin UI +- **WHEN** the admin edits a string-type property +- **THEN** a toggle labeled `t('openregister', 'Translatable')` SHALL be visible +- **AND** toggling it SHALL set `translatable: true` in the property definition + +### Requirement: Objects MUST store translations per translatable property as language-keyed JSON + +Each translatable property MUST store its values as a JSON object keyed by BCP 47 language codes (e.g., `{"nl": "Paspoort aanvragen", "en": "Passport application"}`). This structure SHALL be stored within the existing `object` JSON column on the `ObjectEntity`, requiring no database schema changes. The `TranslationHandler::normalizeTranslationsForSave()` method SHALL wrap simple (non-array) values under the register's default language before persisting. + +#### Scenario: Create object with multiple translations +- **GIVEN** schema `producten` with translatable property `omschrijving` and register configured with languages `["nl", "en"]` +- **WHEN** a user creates an object via `POST /api/objects/{register}/{schema}` with body `{"omschrijving": {"nl": "Aanvraag omgevingsvergunning", "en": "Environmental permit application"}}` +- **THEN** the stored object JSON SHALL contain `{"omschrijving": {"nl": "Aanvraag omgevingsvergunning", "en": "Environmental permit application"}}` + +#### Scenario: Create object with only default language +- **GIVEN** a translatable property `omschrijving` and register default language `nl` +- **WHEN** a user creates an object with `{"omschrijving": "Paspoort aanvragen"}` (simple string value) +- **THEN** `TranslationHandler::normalizeTranslationsForSave()` SHALL wrap the value as `{"omschrijving": {"nl": "Paspoort aanvragen"}}` +- **AND** the object SHALL be created successfully + +#### Scenario: Update a single language translation +- **GIVEN** an object with `omschrijving`: `{"nl": "Paspoort aanvragen", "en": "Passport application"}` +- **WHEN** a user sends `PUT /api/objects/{register}/{schema}/{id}` with `{"omschrijving": {"nl": "Paspoort aanvragen", "en": "Apply for passport"}}` +- **THEN** the English translation SHALL be updated to `"Apply for passport"` +- **AND** the Dutch translation SHALL remain `"Paspoort aanvragen"` + +#### Scenario: Default language value is required +- **GIVEN** a translatable property `omschrijving` and register default language `nl` +- **WHEN** a user creates an object with `{"omschrijving": {"en": "Passport application"}}` (missing Dutch) +- **THEN** `TranslationHandler::normalizeTranslationsForSave()` SHALL log a warning via `LoggerInterface` +- **AND** the object SHALL still be saved (non-blocking) but the missing default language SHALL be flagged + +#### Scenario: Non-translatable property ignores language keys +- **GIVEN** property `code` with `translatable: false` +- **WHEN** a user sends `{"code": {"nl": "ABC123"}}` in the request body +- **THEN** the value SHALL be stored as-is (treated as a regular object, not a translation map) +- **AND** `TranslationHandler` SHALL not modify this property + +### Requirement: The API MUST support language negotiation via Accept-Language header + +API responses MUST return translatable property values in the language requested via the `Accept-Language` header (RFC 9110, Section 12.5.4). The `LanguageMiddleware` SHALL parse the header before any controller action and store the resolved language in the request-scoped `LanguageService`. The response SHALL include a `Content-Language` header indicating the served language. If the requested language is unavailable, the system SHALL follow the fallback chain and add an `X-Content-Language-Fallback: true` header. + +#### Scenario: Request content in English +- **GIVEN** an object with `omschrijving`: `{"nl": "Paspoort aanvragen", "en": "Passport application"}` +- **WHEN** the API receives `GET /api/objects/{register}/{schema}/{id}` with header `Accept-Language: en` +- **THEN** `LanguageMiddleware::beforeController()` SHALL parse the header and set `en` as the preferred language in `LanguageService` +- **AND** `TranslationHandler::resolveTranslationsForRender()` SHALL return `{"omschrijving": "Passport application"}` +- **AND** the response SHALL include header `Content-Language: en` + +#### Scenario: Fallback to Dutch when translation missing +- **GIVEN** an object with `omschrijving`: `{"nl": "Paspoort aanvragen"}` (no English translation) +- **WHEN** the API receives a request with `Accept-Language: en` +- **THEN** the response SHALL return `{"omschrijving": "Paspoort aanvragen"}` (Dutch fallback) +- **AND** the response SHALL include headers `Content-Language: nl` and `X-Content-Language-Fallback: true` +- **AND** `LanguageService::isFallbackUsed()` SHALL return `true` + +#### Scenario: Request all translations via query parameter +- **GIVEN** an object with `omschrijving`: `{"nl": "Paspoort aanvragen", "en": "Passport application"}` +- **WHEN** the API receives `GET /api/objects/{register}/{schema}/{id}?_translations=all` +- **THEN** `LanguageService::shouldReturnAllTranslations()` SHALL return `true` +- **AND** `TranslationHandler::resolveTranslationsForRender()` SHALL return the full language-keyed object: `{"omschrijving": {"nl": "Paspoort aanvragen", "en": "Passport application"}}` + +#### Scenario: Accept-Language with quality factors +- **GIVEN** an object with `omschrijving`: `{"nl": "Paspoort aanvragen", "de": "Reisepass beantragen"}` +- **WHEN** the API receives `Accept-Language: en-US,en;q=0.9,de;q=0.8,nl;q=0.7` +- **THEN** `LanguageService::parseAcceptLanguageHeader()` SHALL return `["en-US", "en", "de", "nl"]` sorted by quality +- **AND** `LanguageService::resolveLanguageForRegister()` SHALL match `de` (first available language in priority order) +- **AND** the response SHALL return `{"omschrijving": "Reisepass beantragen"}` with `Content-Language: de` + +#### Scenario: List endpoint respects Accept-Language +- **GIVEN** multiple objects with translatable properties +- **WHEN** the API receives `GET /api/objects/{register}/{schema}` with `Accept-Language: en` +- **THEN** every object in the response array SHALL have its translatable properties resolved to English (or fallback) +- **AND** the `Content-Language` header SHALL reflect the primary language served + +### Requirement: Fallback language chain MUST be configurable per register + +Each register MUST define an ordered fallback chain for language resolution. When the requested language is unavailable for a property, the system SHALL try each language in the chain until a value is found. The default chain SHALL be: requested language, then register default language (`nl`), then first available translation. The register's `languages` array determines the available languages and the first element is the default. + +#### Scenario: Configure register languages +- **GIVEN** register `producten` being created via `POST /api/registers` +- **WHEN** the admin sets `{"languages": ["nl", "en", "de"], ...}` +- **THEN** `Register::getLanguages()` SHALL return `["nl", "en", "de"]` +- **AND** `Register::getDefaultLanguage()` SHALL return `"nl"` (first element) +- **AND** only these three languages SHALL be available for translations in this register + +#### Scenario: Fallback chain resolution order +- **GIVEN** register with languages `["nl", "en", "de"]` and an object where property `naam` has `{"de": "Reisepass"}` +- **WHEN** a request arrives with `Accept-Language: en` +- **THEN** the system SHALL try `en` (not found), then `nl` (not found, register default), then `de` (found) +- **AND** the response SHALL return `"Reisepass"` with `X-Content-Language-Fallback: true` + +#### Scenario: Add a language to an existing register +- **GIVEN** register `producten` with languages `["nl", "en"]` +- **WHEN** the admin updates the register with `{"languages": ["nl", "en", "fr"]}` +- **THEN** French SHALL become available for translations +- **AND** existing objects SHALL NOT be modified (French values simply do not exist yet) + +#### Scenario: Register with no languages configured falls back to Dutch +- **GIVEN** a register with `languages` set to `null` or `[]` +- **WHEN** `Register::getDefaultLanguage()` is called +- **THEN** it SHALL return `"nl"` as the hardcoded fallback +- **AND** all translatable properties SHALL be stored under `"nl"` by `TranslationHandler` + +#### Scenario: Validate language codes +- **GIVEN** a register update request with `{"languages": ["nl", "invalid!!"]}` +- **WHEN** the system validates the language array +- **THEN** each language code MUST conform to BCP 47 / RFC 5646 pattern (`/^[a-z]{2,3}(-[a-zA-Z0-9]{2,8})*$/`) +- **AND** invalid codes SHALL be rejected with a `400 Bad Request` response + +### Requirement: Nextcloud IL10N integration MUST translate app UI independently from object content + +The app UI (labels, buttons, error messages, navigation) MUST use Nextcloud's `IL10N` / `@nextcloud/l10n` translation system per ADR-005. This is entirely separate from data-level i18n. UI strings follow the user's Nextcloud locale preference; object content follows the `Accept-Language` header or the language selected in the object editor. + +#### Scenario: UI labels use IL10N +- **GIVEN** a PHP controller returning a success message +- **WHEN** the message is constructed +- **THEN** it SHALL use `$this->l10n->t('Object saved successfully')` (Nextcloud IL10N) +- **AND** the `l10n/nl.json` file SHALL contain `"Object saved successfully": "Object succesvol opgeslagen"` +- **AND** the UI label language depends on the Nextcloud user's locale, NOT the register's configured languages + +#### Scenario: Schema property display names use IL10N +- **GIVEN** a schema with property `omschrijving` displayed in the object edit form +- **WHEN** the property label is rendered in the UI +- **THEN** the label SHALL use `t('openregister', 'Description')` for the UI label +- **AND** the property's data content SHALL follow the register's language configuration (separate concern) + +#### Scenario: Admin UI for register language configuration +- **GIVEN** the register settings form in the admin panel +- **WHEN** the admin views the language configuration section +- **THEN** all UI labels (e.g., "Default language", "Available languages", "Add language") SHALL use `t()` and be available in NL and EN +- **AND** the language codes themselves (nl, en, de) SHALL be displayed with their native names (Nederlands, English, Deutsch) + +#### Scenario: Error messages in API responses follow user locale +- **GIVEN** a Dutch-locale user performing an invalid operation via the UI +- **WHEN** the controller returns an error +- **THEN** the error message SHALL be in Dutch via `$this->l10n->t()` +- **AND** this is independent of the object's content language + +### Requirement: The UI MUST provide a language-aware object editor with translation status + +The object edit form MUST display language tabs for translatable properties, allowing users to switch between languages. Non-translatable properties SHALL remain visible regardless of the selected language tab. The editor MUST indicate translation completeness per language. + +#### Scenario: Edit translations via language tabs +- **GIVEN** an object with schema having translatable properties `naam` and `omschrijving`, and register languages `["nl", "en"]` +- **WHEN** the user opens the object edit form +- **THEN** language tabs labeled "NL" and "EN" SHALL be displayed above the translatable fields +- **AND** switching tabs SHALL show/edit the translation for that language +- **AND** non-translatable fields (e.g., `code`, `prijs`) SHALL remain visible and editable regardless of selected tab + +#### Scenario: Indicate missing translations with badge +- **GIVEN** an object with Dutch content for all translatable properties but no English translations +- **WHEN** the user views the language tabs +- **THEN** the "EN" tab SHALL show a warning badge (e.g., orange dot or count indicator) +- **AND** hovering the badge SHALL show a tooltip: `t('openregister', '%n field needs translation', '%n fields need translation', count)` + +#### Scenario: Side-by-side translation editing +- **GIVEN** an object with translatable property `omschrijving` and register languages `["nl", "en"]` +- **WHEN** the user activates "side-by-side" mode in the language editor +- **THEN** the Dutch value SHALL be displayed read-only on the left +- **AND** the English input field SHALL be displayed on the right for editing +- **AND** this layout SHALL help translators see the source text while entering translations + +#### Scenario: Create object defaults to default language tab +- **GIVEN** a new object form for a schema with translatable properties and register default language `nl` +- **WHEN** the form loads +- **THEN** the `NL` tab SHALL be selected by default +- **AND** the user SHALL be able to fill in other language tabs before saving + +#### Scenario: Language tab order matches register configuration +- **GIVEN** register languages configured as `["nl", "en", "de", "fr"]` +- **WHEN** the language tabs are rendered +- **THEN** they SHALL appear in the order: NL, EN, DE, FR +- **AND** the order SHALL match `Register::getLanguages()` + +### Requirement: Translation workflow MUST support status tracking per property per language + +Each translatable property per language MUST support a translation status to enable review workflows. Statuses SHALL be: `draft`, `needs_review`, `approved`, `outdated`. When the source (default language) text changes, all other language statuses SHALL automatically transition to `outdated`. + +#### Scenario: New translation starts as draft +- **GIVEN** an object with translatable property `omschrijving` and a user adding an English translation +- **WHEN** the English value is saved for the first time +- **THEN** the translation status for `omschrijving.en` SHALL be set to `draft` + +#### Scenario: Source text change marks translations as outdated +- **GIVEN** an object with `omschrijving`: `{"nl": "Paspoort aanvragen", "en": "Passport application"}` and English status `approved` +- **WHEN** the Dutch (source) text is updated to `"Nieuw paspoort aanvragen"` +- **THEN** the English translation status SHALL automatically change to `outdated` +- **AND** the UI SHALL display a visual indicator on the English tab showing the translation needs updating + +#### Scenario: Mark translation as approved +- **GIVEN** a user with translation review permissions +- **WHEN** they review the English translation and click "Approve" +- **THEN** the translation status for `omschrijving.en` SHALL change to `approved` + +#### Scenario: Filter objects by translation status +- **GIVEN** a register with 100 objects with translatable properties +- **WHEN** a user filters the object list by `_translationStatus=outdated&_translationLanguage=en` +- **THEN** only objects with at least one English property marked `outdated` SHALL be returned + +#### Scenario: Translation status stored in object metadata +- **GIVEN** an object with translatable properties +- **WHEN** the object is persisted +- **THEN** translation statuses SHALL be stored in the object JSON under a `_translationMeta` key: `{"_translationMeta": {"omschrijving": {"en": {"status": "approved", "updatedAt": "2026-03-19T10:00:00Z"}}}}` +- **AND** the `_translationMeta` key SHALL NOT appear in regular API responses unless `_translations=all` is requested + +### Requirement: Bulk translation operations MUST be supported + +The system MUST support translating multiple objects or multiple properties in a single operation, enabling efficient batch workflows for translators. + +#### Scenario: Bulk update translations for a language +- **GIVEN** 50 objects in schema `producten` with translatable property `naam` +- **WHEN** a user sends `PATCH /api/objects/{register}/{schema}/bulk` with `{"_bulkLanguage": "en", "objects": [{"id": "uuid-1", "naam": "Widget A"}, {"id": "uuid-2", "naam": "Widget B"}]}` +- **THEN** the system SHALL update only the English translation of `naam` for each specified object +- **AND** existing Dutch values SHALL remain unchanged + +#### Scenario: Bulk export untranslated objects +- **GIVEN** a register with 200 objects, 50 of which lack English translations +- **WHEN** a user requests `GET /api/objects/{register}/{schema}?_translationStatus=missing&_translationLanguage=en&_format=csv` +- **THEN** the response SHALL contain only the 50 objects missing English translations +- **AND** the CSV SHALL include columns for both Dutch source text and empty English columns for each translatable property + +#### Scenario: Bulk mark translations as approved +- **GIVEN** 20 objects with English translations in `needs_review` status +- **WHEN** a user sends `PATCH /api/objects/{register}/{schema}/bulk` with `{"_bulkAction": "approveTranslations", "language": "en", "ids": ["uuid-1", "uuid-2", ...]}` +- **THEN** all 20 objects SHALL have their English translation statuses set to `approved` + +### Requirement: Import and export MUST preserve translations + +Data import and export operations (CSV, Excel, JSON, XML) MUST handle translatable properties correctly, preserving language variants. This cross-references the `data-import-export` spec. + +#### Scenario: JSON export includes all translations +- **GIVEN** an object with `omschrijving`: `{"nl": "Paspoort aanvragen", "en": "Passport application"}` +- **WHEN** the user exports to JSON format +- **THEN** the exported JSON SHALL preserve the language-keyed structure: `{"omschrijving": {"nl": "Paspoort aanvragen", "en": "Passport application"}}` + +#### Scenario: CSV export flattens translations to columns +- **GIVEN** an object with translatable property `omschrijving` and register languages `["nl", "en"]` +- **WHEN** the user exports to CSV format +- **THEN** the CSV SHALL contain separate columns: `omschrijving_nl`, `omschrijving_en` +- **AND** each column SHALL contain the respective language's value + +#### Scenario: JSON import with translations +- **GIVEN** a JSON file containing `[{"omschrijving": {"nl": "Paspoort aanvragen", "en": "Passport application"}}]` +- **WHEN** the user imports this file into a schema with `omschrijving` marked as `translatable: true` +- **THEN** the system SHALL store both language variants correctly +- **AND** `TranslationHandler::normalizeTranslationsForSave()` SHALL validate the language keys against the register's configured languages + +#### Scenario: CSV import with language columns +- **GIVEN** a CSV file with columns `naam_nl`, `naam_en`, `code` +- **WHEN** the user imports this file into a schema where `naam` is translatable +- **THEN** the importer SHALL detect the `_nl` and `_en` suffixes and construct the language-keyed object `{"naam": {"nl": "...", "en": "..."}}` +- **AND** `code` (non-translatable) SHALL be imported as a simple value + +#### Scenario: Export in single language +- **GIVEN** an export request with header `Accept-Language: en` +- **WHEN** the user exports to CSV without `_translations=all` +- **THEN** the CSV SHALL contain a single `omschrijving` column with the English value (or Dutch fallback) +- **AND** the export behavior SHALL be consistent with the API language negotiation + +### Requirement: Search MUST support cross-language and language-specific queries + +Full-text search MUST be able to search across all language variants of translatable properties, or within a specific language. The search index MUST use language-appropriate analyzers (stemmers, tokenizers) per language. + +#### Scenario: Search across all languages (default) +- **GIVEN** objects with `omschrijving.nl` = `"omgevingsvergunning"` and `omschrijving.en` = `"environmental permit"` +- **WHEN** the user searches for `"permit"` without specifying a language filter +- **THEN** the search SHALL match the English translation +- **AND** the search SHALL also match if the user searches for `"omgevingsvergunning"` + +#### Scenario: Search in specific language +- **GIVEN** objects with Dutch and English descriptions +- **WHEN** the user searches with query `vergunning` and parameter `_searchLanguage=nl` +- **THEN** only Dutch content SHALL be searched +- **AND** Dutch stemming/analysis MUST be applied (e.g., `vergunning` matches `vergunningen`) + +#### Scenario: Search results include language metadata +- **GIVEN** a search query that matches an English translation +- **WHEN** the results are returned +- **THEN** each result SHALL indicate which language(s) matched +- **AND** the matched snippet SHALL be from the matching language + +#### Scenario: Magic table indexing for translatable properties +- **GIVEN** a schema with translatable property `naam` and register default language `nl` +- **WHEN** the magic table column for `naam` is populated by `SchemaMapper` +- **THEN** the indexed column value SHALL contain the default language value for sorting and filtering +- **AND** a supplementary index entry SHALL be created for each additional language to support cross-language search + +#### Scenario: Faceting on translatable properties +- **GIVEN** a faceted search request on translatable property `categorie` with register languages `["nl", "en"]` +- **WHEN** facet values are aggregated +- **THEN** facets SHALL use the language matching the `Accept-Language` header +- **AND** facet counts SHALL aggregate across all language variants (a single object with `categorie.nl` and `categorie.en` counts once) + +### Requirement: RTL language support MUST be handled in the UI + +When a register includes RTL (right-to-left) languages such as Arabic (`ar`) or Hebrew (`he`), the UI MUST render those language tabs and input fields with appropriate text direction. + +#### Scenario: Arabic language tab renders RTL +- **GIVEN** register languages `["nl", "ar"]` and a translatable property `omschrijving` +- **WHEN** the user switches to the "AR" language tab +- **THEN** the text input field SHALL have `dir="rtl"` and `lang="ar"` attributes +- **AND** the text SHALL be right-aligned + +#### Scenario: Mixed LTR/RTL in side-by-side mode +- **GIVEN** side-by-side translation mode with Dutch (LTR) on the left and Arabic (RTL) on the right +- **WHEN** both panels are displayed +- **THEN** the Dutch panel SHALL render LTR and the Arabic panel SHALL render RTL +- **AND** each panel SHALL correctly handle its text direction independently + +#### Scenario: RTL detection based on language code +- **GIVEN** a register with various language codes +- **WHEN** the UI renders language tabs +- **THEN** the system SHALL detect RTL languages from a known list (ar, he, fa, ur, etc.) +- **AND** apply `dir="rtl"` automatically without manual configuration + +### Requirement: Translation completeness tracking MUST be available per object and per register + +The system MUST track and expose translation completeness metrics at both the object level and the register level, enabling administrators to monitor translation progress. + +#### Scenario: Object-level translation completeness +- **GIVEN** an object with 4 translatable properties and register languages `["nl", "en", "de"]` +- **AND** all 4 properties have Dutch values, 3 have English values, and 1 has a German value +- **WHEN** the object completeness is calculated +- **THEN** the completeness SHALL be: `{"nl": 100, "en": 75, "de": 25}` (percentages) + +#### Scenario: Register-level translation dashboard +- **GIVEN** register `producten` with 100 objects, each with 3 translatable properties, and languages `["nl", "en"]` +- **WHEN** the admin views the register translation dashboard +- **THEN** the dashboard SHALL show aggregate completeness: e.g., "EN: 240/300 fields translated (80%)" +- **AND** the dashboard SHALL list the objects with the most missing translations first + +#### Scenario: Translation completeness in object list view +- **GIVEN** the object list view in the admin UI +- **WHEN** the admin enables the "Translation status" column +- **THEN** each row SHALL show translation completeness indicators (e.g., color-coded badges per language) +- **AND** the list SHALL be sortable by translation completeness + +#### Scenario: API endpoint for translation statistics +- **GIVEN** register `producten` with schema `producten` +- **WHEN** the admin calls `GET /api/registers/{id}/translation-stats` +- **THEN** the response SHALL include `{"languages": {"nl": {"total": 300, "translated": 300, "percentage": 100}, "en": {"total": 300, "translated": 240, "percentage": 80}}}` + +#### Scenario: Completeness excludes non-translatable properties +- **GIVEN** a schema with 5 properties, 3 of which are translatable +- **WHEN** completeness is calculated +- **THEN** only the 3 translatable properties SHALL be counted in the metric +- **AND** non-translatable properties SHALL be ignored + +### Requirement: Content-Language vs UI language MUST be clearly distinguished + +The system MUST maintain a clear separation between the user's Nextcloud interface language (controlled by Nextcloud user settings and `IL10N`) and the object content language (controlled by `Accept-Language` header and register configuration). These two language contexts MUST NOT interfere with each other. + +#### Scenario: Dutch user editing English content +- **GIVEN** a Nextcloud user with locale set to `nl` (Dutch UI) +- **WHEN** the user edits an object and selects the "EN" language tab for content +- **THEN** all UI labels (buttons, form labels, navigation) SHALL remain in Dutch +- **AND** the object content fields SHALL accept and display English text +- **AND** the "Save" button text SHALL be `"Opslaan"` (Dutch UI) regardless of the content language + +#### Scenario: API response separates concerns +- **GIVEN** a request with `Accept-Language: en` from a user with Nextcloud locale `nl` +- **WHEN** the API returns an object with a validation error +- **THEN** the object's translatable properties SHALL be resolved to English (content language) +- **AND** the error message SHALL be in Dutch (UI language via IL10N and user locale) + +#### Scenario: Language selection persists per-session +- **GIVEN** a user editing objects in the "EN" content language tab +- **WHEN** the user navigates to a different object in the same register +- **THEN** the "EN" tab SHALL remain selected (content language preference persists in the session) +- **AND** the Nextcloud UI language SHALL remain unchanged + +### Requirement: Admin UI MUST provide register language management + +The register settings page MUST include a language configuration section where administrators can add, remove, and reorder languages for a register. + +#### Scenario: Add a language to a register +- **GIVEN** the register settings page for register `producten` with current languages `["nl", "en"]` +- **WHEN** the admin clicks "Add language" and selects "Deutsch (de)" +- **THEN** the register's languages SHALL update to `["nl", "en", "de"]` +- **AND** existing objects SHALL NOT be modified + +#### Scenario: Remove a language from a register +- **GIVEN** register `producten` with languages `["nl", "en", "de"]` and 50 objects with German translations +- **WHEN** the admin removes "de" from the language list +- **THEN** the register's languages SHALL update to `["nl", "en"]` +- **AND** existing German translations in objects SHALL be preserved in storage (soft removal) +- **AND** a confirmation dialog SHALL warn: `t('openregister', 'Removing a language does not delete existing translations. They will be hidden but preserved.')` + +#### Scenario: Cannot remove the default language +- **GIVEN** register `producten` with languages `["nl", "en"]` where `nl` is the default (first in list) +- **WHEN** the admin attempts to remove `nl` +- **THEN** the action SHALL be blocked with message: `t('openregister', 'The default language cannot be removed. Change the default language first.')` + +#### Scenario: Reorder languages to change default +- **GIVEN** register `producten` with languages `["nl", "en"]` +- **WHEN** the admin reorders to `["en", "nl"]` +- **THEN** `Register::getDefaultLanguage()` SHALL now return `"en"` +- **AND** new objects created without explicit language keys SHALL have their simple values stored under `"en"` + +#### Scenario: Language selector shows native names +- **GIVEN** the language configuration UI +- **WHEN** the admin browses available languages +- **THEN** each language SHALL be displayed with its native name and code: "Nederlands (nl)", "English (en)", "Deutsch (de)", "Francais (fr)" +- **AND** the list SHALL include all ISO 639-1 languages + +### Requirement: GraphQL API MUST support language negotiation + +The GraphQL endpoint MUST support the same language negotiation as the REST API, using either the `Accept-Language` header or a `language` query argument on translatable fields. + +#### Scenario: GraphQL query with Accept-Language header +- **GIVEN** a GraphQL query `{ objects(register: "producten", schema: "producten") { naam omschrijving } }` +- **WHEN** the request includes `Accept-Language: en` +- **THEN** `naam` and `omschrijving` SHALL be resolved to their English values (or fallback) + +#### Scenario: GraphQL field-level language argument +- **GIVEN** a GraphQL query `{ objects(register: "producten", schema: "producten") { naam(language: "en") omschrijving(language: "nl") } }` +- **WHEN** the query is executed +- **THEN** `naam` SHALL be resolved to English and `omschrijving` SHALL be resolved to Dutch +- **AND** field-level language arguments SHALL override the `Accept-Language` header + +#### Scenario: GraphQL all translations query +- **GIVEN** a GraphQL query `{ objects(register: "producten", schema: "producten") { naam(translations: ALL) } }` +- **WHEN** the query is executed +- **THEN** `naam` SHALL return the full language-keyed object: `{"nl": "...", "en": "..."}` + +### Requirement: Translations MUST interact correctly with $ref properties and relations + +Properties that use `$ref` to reference other objects SHALL NOT be translatable themselves (the reference ID is language-independent). However, when a referenced object is resolved inline, its translatable properties SHALL be resolved according to the current language context. + +#### Scenario: Reference property is language-independent +- **GIVEN** property `eigenaar` with `$ref: "#/schemas/personen"` on schema `producten` +- **WHEN** the admin attempts to mark `eigenaar` as `translatable: true` +- **THEN** the system SHALL reject this with an error: `t('openregister', 'Reference properties cannot be translatable')` + +#### Scenario: Resolved reference inherits language context +- **GIVEN** an object in schema `producten` referencing a `personen` object with translatable property `naam` +- **WHEN** the `producten` object is rendered with `_extend[]=eigenaar` and `Accept-Language: en` +- **THEN** the resolved `personen` object's `naam` SHALL be in English (or fallback) +- **AND** the language resolution SHALL apply recursively to all extended references + +#### Scenario: Reference list with mixed translation completeness +- **GIVEN** a `producten` object referencing 3 `categorie` objects, 2 with English translations and 1 without +- **WHEN** the list is rendered with `Accept-Language: en` +- **THEN** the 2 translated categories SHALL show English names +- **AND** the 1 untranslated category SHALL show the Dutch fallback name + +## Current Implementation Status + +**Partially implemented.** Core infrastructure for register-level i18n exists: + +- `LanguageService` (request-scoped singleton) stores preferred language, accepted languages, fallback state, and `_translations=all` flag. Includes `parseAcceptLanguageHeader()` per RFC 9110 and `resolveLanguageForRegister()` with fallback chain. +- `LanguageMiddleware` intercepts all requests to parse `Accept-Language` header and `_translations` query parameter. Adds `Content-Language` and `X-Content-Language-Fallback` response headers. +- `TranslationHandler` provides `getTranslatableProperties()` (reads `translatable: true` from schema properties), `resolveTranslationsForRender()` (resolves language-keyed objects to single values for rendering), and `normalizeTranslationsForSave()` (wraps simple values under default language). +- `Register` entity has `getLanguages()`, `setLanguages()`, `getDefaultLanguage()`, and `hasLanguage()` methods. The `languages` column stores an array of BCP 47 codes with the first element as the default. +- `RenderObject` calls `TranslationHandler::resolveTranslationsForRender()` during object rendering. +- `SaveObject` calls `TranslationHandler::normalizeTranslationsForSave()` during object persistence. +- `Application` registers `LanguageService` as a singleton and `LanguageMiddleware` as middleware. + +**Not yet implemented:** +- UI language tabs and translation editor in the object edit form +- Translation workflow statuses (draft, needs_review, approved, outdated) +- Translation completeness tracking and dashboard +- Bulk translation operations +- Import/export with translation-aware column handling (CSV `_nl` / `_en` suffixes) +- Language-specific search indexing and cross-language search +- RTL language support in the UI +- GraphQL language arguments on translatable fields +- Admin UI for register language management (the data model supports it, but no UI exists) +- Validation that `$ref` properties cannot be translatable + +## Standards & References + +- EU Single Digital Gateway (SDG) Regulation (EU) 2018/1724 -- requires cross-border service information in at least one EU language beyond the national language +- ADR-005: Internationalization -- Dutch and English Required (company-wide decision, `openspec/architecture/adr-005-i18n-requirement.md`) +- HTTP `Accept-Language` header (RFC 9110, Section 12.5.4) +- HTTP `Content-Language` header (RFC 9110, Section 8.5) +- BCP 47 / RFC 5646 language tags (e.g., `nl`, `en`, `de`, `ar`) +- JSON-LD `@language` context for multilingual linked data +- Common Ground API design rules (NL GOV) -- recommend language negotiation via Accept-Language +- W3C Internationalization best practices (https://www.w3.org/International/) +- Nextcloud `IL10N` / `IFactory` -- `\OCP\IL10N\IFactory::get('openregister', $lang)` for UI string translations +- Nextcloud `@nextcloud/l10n` -- `translate as t`, `translatePlural as n` for Vue frontend (see `i18n-infrastructure` spec) +- Unicode CLDR for language native names and RTL detection + +## Cross-References + +- `i18n-infrastructure` -- Vue frontend l10n setup (mixin, imports, directory structure) +- `i18n-string-extraction` -- Rules for wrapping translatable UI strings with `t()` / `$l->t()` +- `i18n-backend-messages` -- PHP controller/service message translation via `IL10N` +- `i18n-dutch-translations` -- Dutch translation completeness and terminology consistency +- `data-import-export` -- Import/export pipeline must handle translatable property columns +- `row-field-level-security` -- Property-level RBAC may restrict translation editing per language diff --git a/openspec/changes/row-field-level-security/specs/row-field-level-security/spec.md b/openspec/changes/row-field-level-security/specs/row-field-level-security/spec.md new file mode 100644 index 000000000000..c96ebc7fd9c4 --- /dev/null +++ b/openspec/changes/row-field-level-security/specs/row-field-level-security/spec.md @@ -0,0 +1,494 @@ +--- +status: implemented +--- + +# Row and Field Level Security + +## Purpose +Implement dynamic per-record access rules based on field values (row-level security / RLS) and per-field visibility and editability rules based on user roles (field-level security / FLS). Beyond schema-level RBAC that controls access to entire object types, the system MUST support row-level security where access to individual objects depends on the object's own properties (e.g., department, classification level, owner), and field-level security where different users see different fields of the same object. Both security layers MUST be enforced consistently across REST, GraphQL, search, export, and MCP access methods, evaluated at the database query level where possible for performance, and composable with schema-level RBAC and multi-tenancy isolation. + +**Source**: Gap identified in cross-platform analysis; Directus implements comprehensive row/field-level security with filter-based permissions and dynamic variables ($CURRENT_USER, $CURRENT_ROLE, $NOW). NocoDB provides view-level permissions. 86% of analyzed government tenders require RBAC per zaaktype; 67% require SSO/identity integration with fine-grained data compartmentalization. + +## Requirements + +### Requirement: Schemas MUST support row-level security rules via conditional authorization matching +Schema authorization blocks MUST accept conditional rules that filter objects based on the current user's context (group membership, identity, organisation) and the object's own field values. Conditional rules use the structure `{ "group": "", "match": { "": "" } }` where the user must qualify for the group AND the object must satisfy all match conditions. + +#### Scenario: Restrict access by department field using group + match +- **GIVEN** schema `meldingen` has authorization: `{ "read": [{ "group": "behandelaars", "match": { "afdeling": "sociale-zaken" } }] }` +- **AND** user `jan` is in group `behandelaars` +- **AND** melding `melding-1` has `afdeling: "sociale-zaken"` +- **AND** melding `melding-2` has `afdeling: "ruimtelijke-ordening"` +- **WHEN** `jan` lists meldingen +- **THEN** `MagicRbacHandler::applyRbacFilters()` MUST add a SQL WHERE clause: `t.afdeling = 'sociale-zaken'` +- **AND** `jan` MUST see `melding-1` but NOT `melding-2` +- **AND** filtering MUST happen at the database query level (not post-fetch) + +#### Scenario: Restrict access by classification level using operator conditions +- **GIVEN** schema `documenten` has authorization: `{ "read": [{ "group": "medewerkers", "match": { "vertrouwelijkheid": { "$lte": 2 } } }] }` +- **AND** document `doc-1` has `vertrouwelijkheid: 3` +- **AND** document `doc-2` has `vertrouwelijkheid: 1` +- **AND** user `behandelaar` is in group `medewerkers` +- **WHEN** `behandelaar` queries documenten +- **THEN** `MagicRbacHandler::buildOperatorCondition()` MUST generate SQL: `t.vertrouwelijkheid <= 2` +- **AND** `behandelaar` MUST see `doc-2` but NOT `doc-1` + +#### Scenario: Owner-based access via $userId dynamic variable +- **GIVEN** schema `aanvragen` has authorization: `{ "read": [{ "group": "authenticated", "match": { "eigenaar": "$userId" } }] }` +- **AND** aanvraag `aanvraag-1` has `eigenaar: "jan"` +- **WHEN** user `jan` (UID: `jan`) queries aanvragen +- **THEN** `MagicRbacHandler::resolveDynamicValue('$userId')` MUST return `jan` via `$this->userSession->getUser()->getUID()` +- **AND** the SQL condition MUST be `t.eigenaar = 'jan'` +- **AND** user `pieter` MUST NOT see `aanvraag-1` + +#### Scenario: Object owner always has access regardless of RLS rules +- **GIVEN** schema `meldingen` has authorization with restrictive match conditions +- **AND** user `jan` created object `melding-1` (object owner = `jan`) +- **WHEN** `jan` queries meldingen +- **THEN** `MagicRbacHandler::applyRbacFilters()` MUST include `t._owner = 'jan'` as an OR condition alongside the match conditions +- **AND** `jan` MUST see `melding-1` even if the match conditions would otherwise exclude it + +#### Scenario: Multiple authorization rules evaluated with OR logic +- **GIVEN** schema `zaken` has authorization: `{ "read": [{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }, { "group": "managers", "match": { "status": "escalated" } }] }` +- **AND** user `jan` is in group `behandelaars` with active organisation `org-1` +- **AND** user `jan` is NOT in group `managers` +- **WHEN** `jan` queries zaken +- **THEN** only the first rule MUST apply (group match succeeds for `behandelaars`) +- **AND** the SQL MUST filter on `t._organisation = 'org-1'` +- **AND** escalated zaken from other organisations MUST NOT be visible to `jan` + +### Requirement: RLS rules MUST support dynamic variable resolution in match conditions +Match conditions MUST support dynamic variables that resolve at runtime to the current user's context. The system MUST support `$userId` / `$user` (current user UID), `$organisation` / `$activeOrganisation` (current user's active organisation UUID), and `$now` (current datetime). Variables MUST be resolved consistently in both `MagicRbacHandler` (SQL-level) and `ConditionMatcher` (PHP-level) evaluation paths. + +#### Scenario: Organisation-scoped access via $organisation variable +- **GIVEN** schema `dossiers` has authorization: `{ "read": [{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }] }` +- **AND** user `jan` is in group `behandelaars` with active organisation UUID `abc-123` +- **WHEN** `jan` queries dossiers +- **THEN** `MagicRbacHandler::resolveDynamicValue('$organisation')` MUST return `abc-123` via `OrganisationService::getActiveOrganisation()->getUuid()` +- **AND** the SQL condition MUST be `t._organisation = 'abc-123'` +- **AND** the resolved organisation UUID MUST be cached in `$this->cachedActiveOrg` for subsequent calls within the same request + +#### Scenario: Time-based access via $now variable with operator +- **GIVEN** schema `publicaties` has authorization: `{ "read": [{ "group": "public", "match": { "publishDate": { "$lte": "$now" } } }] }` +- **WHEN** an unauthenticated user queries publicaties at `2026-03-19 14:30:00` +- **THEN** `MagicRbacHandler::resolveDynamicValue('$now')` MUST return `2026-03-19 14:30:00` (Y-m-d H:i:s format) +- **AND** `ConditionMatcher::resolveDynamicValue('$now')` MUST return the ISO 8601 equivalent +- **AND** only publicaties with `publish_date <= '2026-03-19 14:30:00'` MUST be returned + +#### Scenario: Unresolvable dynamic variable denies access safely +- **GIVEN** a match condition using `$organisation` but the user has no active organisation +- **WHEN** `MagicRbacHandler::resolveDynamicValue('$organisation')` returns `null` +- **THEN** `MagicRbacHandler::buildPropertyCondition()` MUST return `null` for that condition +- **AND** the rule MUST NOT grant access (fail-closed behavior) + +#### Scenario: User-scoped access via $userId in ConditionMatcher +- **GIVEN** property `interneAantekening` has authorization: `{ "read": [{ "group": "authenticated", "match": { "_owner": "$userId" } }] }` +- **AND** object `obj-1` has `_owner: "jan"` and user `pieter` reads it +- **WHEN** `ConditionMatcher::objectMatchesConditions()` evaluates the match +- **THEN** `$userId` MUST resolve to `pieter` via `$this->userSession->getUser()->getUID()` +- **AND** the condition `_owner === "pieter"` MUST fail because `_owner` is `jan` +- **AND** `pieter` MUST NOT see the `interneAantekening` field + +### Requirement: Schemas MUST support field-level security via property authorization blocks +Individual properties in a schema MUST support authorization rules that control read and update access per field. Property authorization uses the same rule structure as schema-level authorization: group names, `public`, `authenticated`, and conditional rules with match criteria. `PropertyRbacHandler` MUST enforce these rules by filtering outgoing data (`filterReadableProperties`) and validating incoming data (`getUnauthorizedProperties`). + +#### Scenario: Hide sensitive field from unauthorized users in REST responses +- **GIVEN** schema `inwoners` has property `bsn` with authorization: `{ "read": [{ "group": "bsn-geautoriseerd" }], "update": [{ "group": "bsn-geautoriseerd" }] }` +- **AND** user `medewerker-1` is NOT in group `bsn-geautoriseerd` +- **WHEN** `medewerker-1` reads an inwoner object via REST API +- **THEN** `PropertyRbacHandler::filterReadableProperties()` MUST be called during `RenderObject` processing +- **AND** the `bsn` field MUST be omitted (via `unset($object[$propertyName])`) from the REST response +- **AND** all other fields without property-level authorization MUST still be returned + +#### Scenario: Show sensitive field to authorized users +- **GIVEN** user `specialist` IS in group `bsn-geautoriseerd` +- **WHEN** `specialist` reads the same inwoner object +- **THEN** `PropertyRbacHandler::canReadProperty()` MUST return `true` for `bsn` +- **AND** the `bsn` field MUST be included in both REST and GraphQL responses + +#### Scenario: Field-level security in list views +- **GIVEN** user `medewerker-1` cannot read property `bsn` +- **WHEN** `medewerker-1` lists inwoner objects via `GET /api/objects/{register}/{schema}` +- **THEN** `PropertyRbacHandler::filterReadableProperties()` MUST be applied to each object in the list +- **AND** the `bsn` field MUST NOT appear in any object in the response +- **AND** other fields MUST be returned normally for every object + +#### Scenario: Field-level write protection blocks unauthorized property updates +- **GIVEN** user `medewerker-1` is NOT in group `redacteuren` +- **AND** property `interneAantekening` has authorization: `{ "update": [{ "group": "redacteuren" }] }` +- **WHEN** `medewerker-1` sends `PUT /api/objects/{register}/{schema}/{id}` with `{ "interneAantekening": "new text" }` +- **THEN** `PropertyRbacHandler::getUnauthorizedProperties()` MUST return `["interneAantekening"]` +- **AND** `SaveObject` MUST reject the request with a validation error listing the unauthorized properties + +#### Scenario: Unchanged protected fields in PATCH operations are allowed +- **GIVEN** user `medewerker-1` sends a PATCH with `{ "interneAantekening": "existing-value", "status": "open" }` +- **AND** the existing object already has `interneAantekening: "existing-value"` +- **WHEN** `PropertyRbacHandler::getUnauthorizedProperties()` checks the incoming data +- **THEN** `interneAantekening` MUST be skipped because `$incomingData[$propertyName] === $object[$propertyName]` +- **AND** only `status` MUST be evaluated for update authorization +- **AND** the PATCH MUST succeed if `status` is writable + +### Requirement: RLS rules MUST apply consistently to all access methods +Row-level security MUST be enforced identically across REST API, GraphQL queries and mutations, search results, data exports, and MCP operations. The enforcement point SHALL be `MagicRbacHandler::applyRbacFilters()` for database queries and `PermissionHandler::hasPermission()` with object data for individual object access checks. + +#### Scenario: RLS in search results with filtered facet counts +- **GIVEN** schema `meldingen` with RLS rule restricting by `_organisation` +- **WHEN** user `jan` (org `org-1`) searches for meldingen +- **THEN** `MagicRbacHandler::applyRbacFilters()` MUST add WHERE clauses before `MagicSearchHandler` executes the search query +- **AND** only meldingen matching `_organisation = 'org-1'` MUST appear in search results +- **AND** `MagicFacetHandler` facet counts MUST reflect only the RLS-accessible subset of objects + +#### Scenario: RLS in data export +- **GIVEN** user `jan` (org `org-1`) exports meldingen to CSV via `ExportService` +- **WHEN** the export query is built +- **THEN** RLS filters MUST be applied to the export query +- **AND** the CSV MUST only contain objects passing the RLS rules +- **AND** `ExportService` MUST also apply `PropertyRbacHandler::canReadProperty()` to filter columns from export headers + +#### Scenario: RLS in GraphQL queries with silent filtering +- **GIVEN** user `jan` (org `org-1`) queries `{ meldingen { edges { node { title afdeling } } } }` via GraphQL +- **WHEN** `GraphQLResolver` builds the query +- **THEN** `MagicRbacHandler::applyRbacFilters()` MUST filter results at the SQL level +- **AND** only meldingen from `org-1` MUST appear in the edges +- **AND** no GraphQL error MUST be raised for filtered-out items (silently excluded, matching list behavior) + +#### Scenario: RLS in GraphQL mutations rejects unauthorized objects +- **GIVEN** user `pieter` (org `org-2`) attempts `mutation { updateMelding(id: "melding-1", input: { status: "closed" }) { id } }` +- **AND** `melding-1` belongs to `org-1` +- **WHEN** `PermissionHandler::hasPermission()` checks with `objectData` containing `_organisation: "org-1"` +- **THEN** the mutation MUST be rejected because `pieter`'s organisation (`org-2`) does not match +- **AND** GraphQL MUST return an error with `extensions.code: "FORBIDDEN"` + +#### Scenario: RLS in GraphQL nested resolution +- **GIVEN** user `jan` queries `{ dossier(id: "d-1") { meldingen { edges { node { title } } } } }` +- **AND** some nested meldingen fail RLS checks +- **WHEN** the nested meldingen are resolved +- **THEN** only RLS-passing meldingen MUST appear in the nested edges array +- **AND** no error MUST be raised for filtered-out nested items (silently excluded) + +### Requirement: FLS MUST apply consistently to GraphQL field resolution +Field-level security in GraphQL MUST prevent unauthorized field access in queries and mutations, using `PropertyRbacHandler` as the single source of truth for property access decisions. + +#### Scenario: FLS in GraphQL query returns null for restricted fields +- **GIVEN** schema `inwoners` has property `bsn` restricted to group `bsn-geautoriseerd` +- **AND** user `medewerker-1` is NOT in `bsn-geautoriseerd` +- **WHEN** `medewerker-1` queries `{ inwoner(id: "..") { naam bsn } }` via GraphQL +- **THEN** `PropertyRbacHandler::canReadProperty()` MUST return `false` for `bsn` +- **AND** `bsn` MUST resolve to `null` with a partial error at the field path with `extensions.code: "FIELD_FORBIDDEN"` +- **AND** `naam` MUST still return data (partial success) + +#### Scenario: FLS in GraphQL mutation rejects writes to restricted fields +- **GIVEN** user `medewerker-1` is NOT in group `redacteuren` +- **AND** property `interneAantekening` requires group `redacteuren` for update +- **WHEN** `medewerker-1` attempts `mutation { updateInwoner(id: "...", input: { interneAantekening: "text" }) { id } }` +- **THEN** `PropertyRbacHandler::getUnauthorizedProperties()` MUST return `["interneAantekening"]` +- **AND** the mutation MUST be rejected with `extensions.code: "FIELD_FORBIDDEN"` + +#### Scenario: FLS in GraphQL list queries filters fields on every edge node +- **GIVEN** user `medewerker-1` cannot read property `bsn` +- **WHEN** they query `{ inwoners { edges { node { naam bsn } } } }` +- **THEN** on each edge node, `bsn` MUST resolve to `null` with partial errors +- **AND** `naam` MUST return data on every node + +### Requirement: The condition syntax MUST support MongoDB-style operators for match expressions +Match conditions in authorization rules MUST support the following operators via `OperatorEvaluator`: `$eq` (equals), `$ne` (not equals), `$gt` (greater than), `$gte` (greater than or equal), `$lt` (less than), `$lte` (less than or equal), `$in` (in array), `$nin` (not in array), `$exists` (field existence check). Multiple operators on the same property MUST be combined with AND logic. Multiple properties in the same match block MUST also be combined with AND logic. + +#### Scenario: Equality operator with simple value +- **GIVEN** match condition `{ "status": "open" }` +- **WHEN** `MagicRbacHandler::buildPropertyCondition()` processes it +- **THEN** the SQL MUST be `t.status = 'open'` +- **AND** `ConditionMatcher::singleConditionMatches()` MUST compare `$objectValue === 'open'` + +#### Scenario: Greater-than-or-equal operator for clearance level +- **GIVEN** match condition `{ "vertrouwelijkheid": { "$lte": 3 } }` +- **WHEN** `MagicRbacHandler::buildComparisonOperatorCondition()` processes it +- **THEN** the SQL MUST be `t.vertrouwelijkheid <= 3` +- **AND** `OperatorEvaluator::operatorLessThanOrEqual()` MUST return `$value <= 3` + +#### Scenario: In-array operator for multiple allowed values +- **GIVEN** match condition `{ "type": { "$in": ["melding", "klacht", "suggestie"] } }` +- **WHEN** `MagicRbacHandler::buildArrayOperatorCondition()` processes it +- **THEN** the SQL MUST be `t.type IN ('melding', 'klacht', 'suggestie')` +- **AND** `OperatorEvaluator::operatorIn()` MUST check `in_array($value, $operand, true)` + +#### Scenario: Existence operator for optional fields +- **GIVEN** match condition `{ "assignedTo": { "$exists": true } }` +- **WHEN** `MagicRbacHandler::buildSingleOperatorCondition()` processes it +- **THEN** the SQL MUST be `t.assigned_to IS NOT NULL` +- **AND** `OperatorEvaluator::operatorExists()` MUST return `false` when value is `null` + +#### Scenario: Combined operators with AND logic +- **GIVEN** match condition `{ "_organisation": "$organisation", "status": "open", "priority": { "$gte": 3 } }` +- **WHEN** `MagicRbacHandler::buildMatchConditions()` processes it +- **THEN** all three conditions MUST be combined with AND via `$qb->expr()->andX()` +- **AND** all three conditions MUST be satisfied for an object to match + +### Requirement: RLS and FLS MUST be combinable with schema-level RBAC in a layered evaluation chain +Row-level and field-level security MUST be additive to (not replacing) schema-level RBAC. The evaluation order MUST be: (1) schema-level RBAC via `PermissionHandler` checks if the user's group has any access to the schema at all, (2) row-level security via `MagicRbacHandler` filters which objects the user can see based on match conditions, (3) field-level security via `PropertyRbacHandler` filters which properties the user can see or modify within each accessible object. + +#### Scenario: Combined schema + row + field-level RBAC +- **GIVEN** schema `dossiers` with: + - Schema-level auth: `{ "read": ["behandelaars"] }` + - Row-level match: `{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }` + - Property-level auth on `interneAantekening`: `{ "read": ["redacteuren"] }` +- **AND** user `jan` is in `behandelaars`, NOT in `redacteuren`, org `org-1` +- **WHEN** `jan` reads dossiers +- **THEN** `PermissionHandler::hasPermission('read')` MUST pass (jan is in behandelaars) +- **AND** `MagicRbacHandler::applyRbacFilters()` MUST filter to org `org-1` objects only +- **AND** `PropertyRbacHandler::filterReadableProperties()` MUST strip `interneAantekening` from each returned object + +#### Scenario: Schema-level denial prevents RLS evaluation +- **GIVEN** schema `vertrouwelijk` with schema-level auth: `{ "read": ["directie"] }` +- **AND** user `medewerker-1` is NOT in `directie` +- **WHEN** `medewerker-1` attempts to list objects +- **THEN** `PermissionHandler::checkPermission()` MUST throw an exception with message containing "does not have permission to 'read'" +- **AND** `MagicRbacHandler` MUST NOT be invoked (schema-level denial short-circuits) +- **AND** the HTTP response MUST be 403 Forbidden + +#### Scenario: Admin group bypasses all three security layers +- **GIVEN** a user in the Nextcloud `admin` group +- **WHEN** they access any schema with RLS and FLS rules +- **THEN** `PermissionHandler::hasPermission()` MUST return `true` immediately +- **AND** `MagicRbacHandler::applyRbacFilters()` MUST return without adding WHERE clauses +- **AND** `PropertyRbacHandler::filterReadableProperties()` MUST return the object unmodified + +### Requirement: RLS condition evaluation MUST happen at the SQL query level for performance +Row-level security conditions MUST be translated to SQL WHERE clauses by `MagicRbacHandler` and applied at the database query level, not as post-fetch PHP filtering. This ensures that unauthorized objects are never loaded into PHP memory, pagination counts reflect only accessible objects, and query performance is O(accessible rows) not O(total rows). + +#### Scenario: RLS generates SQL WHERE clauses via QueryBuilder +- **GIVEN** schema `meldingen` with conditional rule `{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }` +- **AND** user `jan` is in `behandelaars` with active org `org-1` +- **WHEN** `MagicRbacHandler::applyRbacFilters()` processes the rule +- **THEN** `processConditionalRule()` MUST detect user qualifies for the group +- **AND** `buildMatchConditions()` MUST build the SQL condition via `$qb->expr()->eq('t._organisation', $qb->createNamedParameter('org-1'))` +- **AND** the condition MUST be applied via `$qb->andWhere($qb->expr()->orX(ownerCondition, matchCondition))` + +#### Scenario: RLS generates raw SQL for UNION queries +- **GIVEN** a cross-schema search query using UNION across multiple magic tables +- **WHEN** `MagicRbacHandler::buildRbacConditionsSql()` is called for each schema +- **THEN** it MUST return `['bypass' => false, 'conditions' => ["_organisation = 'org-1'"]]` +- **AND** the conditions MUST be injected as WHERE clauses in the raw SQL UNION +- **AND** values MUST be properly escaped via `quoteValue()` to prevent SQL injection + +#### Scenario: Pagination counts reflect only accessible objects +- **GIVEN** 100 meldingen total, 30 belonging to org `org-1` +- **WHEN** user `jan` (org `org-1`) requests page 1 with limit 10 +- **THEN** the total count MUST be 30 (not 100) +- **AND** only 10 objects from the accessible 30 MUST be returned +- **AND** the `_pagination` metadata MUST show `total: 30` + +#### Scenario: Denial produces impossible SQL condition +- **GIVEN** user `pieter` has no matching rules (not in any authorized group) +- **WHEN** `MagicRbacHandler::applyRbacFilters()` finds no valid conditions +- **THEN** it MUST add the impossible condition `$qb->expr()->eq($qb->createNamedParameter(1), $qb->createNamedParameter(0))` +- **AND** the query MUST return zero results +- **AND** no objects MUST be loaded into PHP memory + +### Requirement: RLS MUST interact correctly with multi-tenancy isolation +When both RLS conditional rules and multi-tenancy isolation are active, the system MUST avoid double-filtering on organisation. `MagicRbacHandler::hasConditionalRulesBypassingMultitenancy()` MUST detect when RBAC rules contain conditional matching on non-`_organisation` fields and bypass the separate multi-tenancy filter to prevent conflict. + +#### Scenario: RBAC with non-organisation match fields bypasses multi-tenancy +- **GIVEN** schema `catalogi` has RBAC rule: `{ "read": [{ "group": "beheerders", "match": { "aanbieder": "$organisation" } }] }` +- **AND** user `jan` is in `beheerders` +- **WHEN** `MagicRbacHandler::hasConditionalRulesBypassingMultitenancy()` evaluates the rules +- **THEN** `matchHasNonOrganisationFields()` MUST detect field `aanbieder` (not `_organisation`) +- **AND** the multi-tenancy WHERE clause MUST be skipped +- **AND** RBAC MUST handle access control via `t.aanbieder = 'org-uuid'` + +#### Scenario: RBAC with only _organisation match does NOT bypass multi-tenancy +- **GIVEN** schema `dossiers` has RBAC rule: `{ "read": [{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }] }` +- **WHEN** `hasConditionalRulesBypassingMultitenancy()` evaluates +- **THEN** `matchHasNonOrganisationFields()` MUST return `false` (only `_organisation` field) +- **AND** multi-tenancy filtering MAY remain active (RBAC and multi-tenancy produce equivalent filtering) + +#### Scenario: Simple group rules bypass multi-tenancy +- **GIVEN** schema `producten` has RBAC rule: `{ "read": ["public"] }` +- **AND** user `jan` qualifies for `public` +- **WHEN** `hasConditionalRulesBypassingMultitenancy()` evaluates +- **THEN** `simpleRuleBypassesMultitenancy('public')` MUST return `true` +- **AND** multi-tenancy filtering MUST be bypassed (user has unconditional access) + +### Requirement: FLS MUST strip restricted fields from API responses and export outputs +When `PropertyRbacHandler::filterReadableProperties()` determines a user cannot read a property, that property MUST be completely omitted from REST API responses (not returned as `null` or redacted). In exports, `ExportService` MUST exclude restricted columns from CSV/XLSX headers and row data. In GraphQL, restricted fields MUST resolve to `null` with a partial error. + +#### Scenario: REST API response omits restricted field entirely +- **GIVEN** user `medewerker-1` cannot read property `bsn` +- **WHEN** `RenderObject` calls `PropertyRbacHandler::filterReadableProperties()` +- **THEN** the response JSON for each object MUST NOT contain the key `bsn` +- **AND** the field MUST NOT appear as `"bsn": null` — it MUST be absent from the JSON object entirely + +#### Scenario: Export excludes restricted columns +- **GIVEN** user `medewerker-1` cannot read property `bsn` +- **WHEN** `ExportService` generates CSV headers for schema `inwoners` +- **THEN** `PropertyRbacHandler::canReadProperty()` MUST be called for each property +- **AND** `bsn` MUST be excluded from the CSV header row +- **AND** `bsn` values MUST NOT appear in any data row + +#### Scenario: Conditional FLS with organisation matching +- **GIVEN** property `interneAantekening` has authorization: `{ "read": [{ "group": "public", "match": { "_organisation": "$organisation" } }] }` +- **AND** user `jan` has active organisation `org-1` +- **AND** object `obj-1` belongs to `org-1`, object `obj-2` belongs to `org-2` +- **WHEN** `jan` reads both objects +- **THEN** `ConditionMatcher::objectMatchesConditions()` MUST check `_organisation === 'org-1'` +- **AND** `interneAantekening` MUST be visible on `obj-1` but stripped from `obj-2` + +### Requirement: FLS on create operations MUST skip organisation matching for conditional rules +When a new object is being created, there is no existing object data to evaluate conditional match rules against. `ConditionMatcher::filterOrganisationMatchForCreate()` MUST remove organisation-based conditions from the match criteria during create operations, so that users can set protected fields on new objects they are creating within their own organisation. + +#### Scenario: Create operation skips organisation match +- **GIVEN** property `interneAantekening` has authorization: `{ "update": [{ "group": "public", "match": { "_organisation": "$organisation" } }] }` +- **WHEN** user `jan` creates a new object with `{ "interneAantekening": "initial note" }` +- **THEN** `PropertyRbacHandler::canUpdateProperty()` MUST call `ConditionMatcher::filterOrganisationMatchForCreate()` +- **AND** the `_organisation` condition MUST be removed from the match criteria +- **AND** if no remaining conditions exist, access MUST be granted +- **AND** the create MUST succeed + +#### Scenario: Create operation preserves non-organisation match conditions +- **GIVEN** property `vertrouwelijk` has authorization: `{ "update": [{ "group": "managers", "match": { "_organisation": "$organisation", "priority": { "$gte": 5 } } }] }` +- **WHEN** a new object is created +- **THEN** `filterOrganisationMatchForCreate()` MUST remove `_organisation` but keep `priority` +- **AND** since there is no existing object data, the `priority` condition MUST be evaluated against empty data +- **AND** access evaluation MUST proceed with remaining conditions + +### Requirement: Security rules MUST be auditable for compliance +All access decisions based on RLS and FLS SHOULD be loggable for compliance monitoring. Security-relevant events (denials, field stripping) MUST be logged at debug level via `LoggerInterface` for troubleshooting, and SHOULD be integrable with Nextcloud's audit log (`OCP\Log\ILogFactory`) for production compliance. + +#### Scenario: Log RLS denial at debug level +- **GIVEN** `MagicRbacHandler::applyRbacFilters()` adds denial conditions (no matching rules) +- **THEN** a debug log MUST record: `[MagicRbacHandler] No access conditions met, denying all` with context including `userId`, `action`, file, and line number + +#### Scenario: Log FLS field stripping at debug level +- **GIVEN** `PropertyRbacHandler::filterReadableProperties()` removes property `bsn` from a response +- **THEN** a debug log MUST record: `[PropertyRbacHandler] Filtered unreadable property` with context including `property: "bsn"`, file, and line number + +#### Scenario: Log invalid authorization rule format +- **GIVEN** a schema contains a malformed authorization rule (not string and not array with `group`) +- **WHEN** `MagicRbacHandler::processAuthorizationRule()` encounters it +- **THEN** a warning log MUST record: `[MagicRbacHandler] Invalid authorization rule format` with the rule content + +#### Scenario: Log unknown operator in match conditions +- **GIVEN** a match condition uses an unsupported operator (e.g., `$regex`) +- **WHEN** `MagicRbacHandler::buildSingleOperatorCondition()` encounters it +- **THEN** a warning log MUST record: `[MagicRbacHandler] Unknown operator` with the operator name +- **AND** `OperatorEvaluator::applySingleOperator()` MUST log `[OperatorEvaluator] Unknown operator` and return `true` (fail-open for unknown operators to avoid false denials) + +### Requirement: Schema property authorization configuration MUST be inspectable via Schema entity methods +The `Schema` entity MUST provide methods to check whether any property has authorization rules (`hasPropertyAuthorization()`), to retrieve authorization rules for a specific property (`getPropertyAuthorization(string $propertyName)`), and to list all properties with authorization rules (`getPropertiesWithAuthorization()`). These methods serve as the contract between the Schema entity and `PropertyRbacHandler`. + +#### Scenario: Schema with property authorization is detected +- **GIVEN** schema `inwoners` has property `bsn` with `authorization: { "read": ["bsn-geautoriseerd"] }` +- **WHEN** `Schema::hasPropertyAuthorization()` is called +- **THEN** it MUST iterate the `properties` array and return `true` when any property has a non-empty `authorization` key + +#### Scenario: Schema without property authorization skips FLS processing +- **GIVEN** schema `tags` has no properties with `authorization` blocks +- **WHEN** `PropertyRbacHandler::filterReadableProperties()` is called +- **THEN** `Schema::hasPropertyAuthorization()` MUST return `false` +- **AND** the object MUST be returned unmodified without iterating individual properties + +#### Scenario: Retrieve all properties with authorization for batch checking +- **GIVEN** schema `dossiers` has 3 properties with authorization out of 15 total properties +- **WHEN** `Schema::getPropertiesWithAuthorization()` is called +- **THEN** it MUST return an associative array with exactly 3 entries: `propertyName => authorizationConfig` +- **AND** `PropertyRbacHandler::filterReadableProperties()` and `getUnauthorizedProperties()` MUST only iterate these 3 properties, not all 15 + +### Requirement: CamelCase property names MUST be correctly mapped to snake_case column names in SQL conditions +`MagicRbacHandler::propertyToColumnName()` MUST convert camelCase property names from authorization rules to snake_case column names used in the dynamic MagicMapper tables. This ensures that match conditions reference the correct database columns. + +#### Scenario: CamelCase to snake_case conversion +- **GIVEN** match condition `{ "assignedTo": "$userId" }` +- **WHEN** `MagicRbacHandler::propertyToColumnName('assignedTo')` is called +- **THEN** it MUST return `assigned_to` +- **AND** the SQL condition MUST reference `t.assigned_to`, not `t.assignedTo` + +#### Scenario: Already snake_case property name passes through +- **GIVEN** match condition `{ "status": "open" }` +- **WHEN** `propertyToColumnName('status')` is called +- **THEN** it MUST return `status` unchanged + +#### Scenario: Underscore-prefixed system property +- **GIVEN** match condition `{ "_organisation": "$organisation" }` +- **WHEN** `propertyToColumnName('_organisation')` is called +- **THEN** it MUST return `_organisation` unchanged (no camelCase conversion needed) + +### Requirement: ConditionMatcher MUST support @self property lookup for system fields +When evaluating property-level authorization match conditions, `ConditionMatcher::getObjectValue()` MUST check both the direct property and the `@self` sub-object for underscore-prefixed properties. This allows conditions to reference system fields like `_organisation` which may be stored under `@self.organisation` in the rendered object format. + +#### Scenario: Direct property lookup +- **GIVEN** object data `{ "status": "open", "_organisation": "org-1" }` +- **AND** match condition references `_organisation` +- **WHEN** `ConditionMatcher::getObjectValue($object, '_organisation')` is called +- **THEN** it MUST return `org-1` from the direct property + +#### Scenario: Fallback to @self for underscore-prefixed properties +- **GIVEN** object data `{ "status": "open", "@self": { "organisation": "org-1" } }` (no direct `_organisation` key) +- **AND** match condition references `_organisation` +- **WHEN** `ConditionMatcher::getObjectValue($object, '_organisation')` is called +- **THEN** it MUST strip the underscore prefix, check `@self.organisation`, and return `org-1` + +#### Scenario: Non-underscore property does not check @self +- **GIVEN** object data `{ "status": "open" }` +- **AND** match condition references `status` +- **WHEN** `ConditionMatcher::getObjectValue($object, 'status')` is called +- **THEN** it MUST return `open` from the direct property +- **AND** it MUST NOT check `@self` (only underscore-prefixed properties fall back to `@self`) + +## Current Implementation Status + +**Substantially implemented.** The row-level and field-level security system is production-ready with the following components: + +**Fully implemented (row-level security):** +- `MagicRbacHandler` (`lib/Db/MagicMapper/MagicRbacHandler.php`) — SQL-level RBAC filtering with QueryBuilder integration and raw SQL for UNION queries. Supports conditional rules with `group` + `match`, dynamic variable resolution (`$organisation`, `$userId`, `$now`), MongoDB-style operators (`$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, `$exists`), owner bypass (`t._owner`), admin bypass, `public` and `authenticated` pseudo-groups, camelCase-to-snake_case column mapping, and SQL injection prevention via `quoteValue()`. +- `PermissionHandler` (`lib/Service/Object/PermissionHandler.php`) — Schema-level RBAC with `hasPermission()` for non-query access checks, supporting conditional rules with object data for individual object authorization. +- `MultiTenancyTrait` (`lib/Db/MultiTenancyTrait.php`) — Organisation-level data isolation with RBAC bypass detection via `hasConditionalRulesBypassingMultitenancy()`. + +**Fully implemented (field-level security):** +- `PropertyRbacHandler` (`lib/Service/PropertyRbacHandler.php`) — Property-level RBAC with `canReadProperty()`, `canUpdateProperty()`, `filterReadableProperties()`, `getUnauthorizedProperties()`. Supports conditional rules with match criteria, admin bypass, `public`/`authenticated` pseudo-groups, and create-operation organisation match skipping. +- `ConditionMatcher` (`lib/Service/ConditionMatcher.php`) — Evaluates match conditions with dynamic variable resolution (`$organisation`, `$userId`, `$now`), `@self` property lookup for system fields, and delegation to `OperatorEvaluator`. +- `OperatorEvaluator` (`lib/Service/OperatorEvaluator.php`) — MongoDB-style operator evaluation for PHP-level condition matching (`$eq`, `$ne`, `$in`, `$nin`, `$exists`, `$gt`, `$gte`, `$lt`, `$lte`). +- `Schema` entity (`lib/Db/Schema.php`) — `hasPropertyAuthorization()`, `getPropertyAuthorization()`, `getPropertiesWithAuthorization()` methods for inspecting property-level authorization rules. + +**Fully integrated across access methods:** +- REST API: `RenderObject` calls `PropertyRbacHandler::filterReadableProperties()` during object rendering (line ~1065). +- REST write: `SaveObject` calls `PropertyRbacHandler::getUnauthorizedProperties()` during save validation (line ~2562). +- GraphQL queries: `GraphQLResolver` integrates `PropertyRbacHandler` for field-level filtering and `MagicRbacHandler` for query-level RLS. +- GraphQL mutations: `GraphQLResolver` checks `PropertyRbacHandler::getUnauthorizedProperties()` before mutation execution. +- Exports: `ExportService` uses `PropertyRbacHandler::canReadProperty()` to filter export columns (line ~531). +- Search: `MagicRbacHandler::applyRbacFilters()` is called before search query execution, ensuring facet counts reflect accessible data. + +**Partially implemented:** +- Audit logging of RLS/FLS decisions exists at debug level via `LoggerInterface` but is not integrated with Nextcloud's audit log (`OCP\Log\ILogFactory`) for production compliance visibility. +- No dedicated security rule management API (rules are configured as part of the schema definition JSON, not via a separate CRUD endpoint). +- No security rule testing/dry-run endpoint to preview what a user would see without executing the actual query. + +**Not implemented:** +- `$CURRENT_USER.groups` dynamic variable for matching user group membership in conditions (currently only `$userId` for user identity). +- `$CURRENT_USER.customAttribute` for matching against Nextcloud user profile attributes. +- Security rule versioning or rollback capability. +- Real-time security rule change propagation to active sessions (changes take effect on next request via schema reload). +- Permission matrix UI for visual management of property-level authorization rules. + +## Standards & References +- **PostgreSQL Row-Level Security (RLS)** — Conceptual reference for row-level filtering where policies define visibility predicates per table. +- **Directus ABAC (v11)** — Competitive reference for filter-based permissions with dynamic variables (`$CURRENT_USER`, `$CURRENT_ROLE`, `$NOW`), additive policy system, and field-level access per CRUD action. +- **ABAC — NIST SP 800-162** — Attribute-Based Access Control guide for fine-grained authorization using subject, object, and environment attributes. +- **Dutch BIO (Baseline Informatiebeveiliging Overheid)** — Baseline information security for Dutch government organizations, requiring data compartmentalization and need-to-know access controls. +- **AVG/GDPR** — Data protection regulation requiring purpose limitation and data minimization, supported by field-level security to restrict access to personal data fields. +- **WCAG 2.1 AA** — Accessible display of security-restricted content (e.g., indicating that fields are hidden, not showing empty columns). +- **RBAC — NIST RBAC Model** — Role-Based Access Control standard that `MagicRbacHandler` implements using Nextcloud groups as roles. +- **MongoDB Query Operators** — The operator syntax (`$eq`, `$gt`, `$in`, etc.) used in match conditions follows MongoDB's filter query language. +- **Nextcloud OCP Interfaces** — `IUserSession`, `IGroupManager`, `IAppConfig` for user identity and group resolution. +- **ZGW Autorisaties API (VNG)** — Dutch government authorization patterns for zaaktype-based access control with confidentiality levels. + +## Cross-References +- **`auth-system`** — Defines the authentication system that resolves all access methods to Nextcloud user identities before RLS/FLS evaluation. RLS and FLS depend on `IUserSession::getUser()` being set correctly by the auth system. +- **`rbac-scopes`** — Maps Nextcloud group-based RBAC to OAuth2 scopes in the OAS output. Property-level authorization groups are extracted by `OasService` and included as OAuth2 scopes. +- **`rbac-zaaktype`** — Schema-level RBAC per zaaktype. RLS and FLS extend this with finer-grained per-object and per-field control within the same schema. + +## Specificity Assessment +- **Highly specific and substantially implemented**: All core RLS and FLS components are implemented and integrated across REST, GraphQL, search, and export access methods. +- **Code-grounded scenarios**: Every scenario references specific classes (`MagicRbacHandler`, `PropertyRbacHandler`, `ConditionMatcher`, `OperatorEvaluator`), methods, and line numbers from the actual implementation. +- **Complete operator coverage**: All 9 MongoDB-style operators are specified with SQL generation and PHP evaluation paths. +- **Dynamic variables fully specified**: `$userId`, `$organisation`, `$now` with resolution paths, caching behavior, and null-handling. +- **No major design ambiguity**: The condition syntax, evaluation order (schema > row > field), and interaction with multi-tenancy are well-defined. +- **Minor gaps identified**: Audit log integration, security rule management API, and extended `$CURRENT_USER` variable support are the remaining enhancement opportunities. diff --git a/openspec/changes/seed-related-items/spec.md b/openspec/changes/seed-related-items/spec.md new file mode 100644 index 000000000000..626a84161b95 --- /dev/null +++ b/openspec/changes/seed-related-items/spec.md @@ -0,0 +1,130 @@ +# Spec: seed-related-items + +## Overview + +Extend OpenRegister's seed data import to support creating related Nextcloud items (notes, tasks, files) alongside seed objects. This enables apps to ship fully realistic seed data where objects come pre-loaded with attached documents, task checklists, and notes -- making the app immediately testable and demo-ready after install. + +## Requirements + +### REQ-01: _relatedItems JSON Schema + +The `seedData.objects[schemaSlug][n]` object MAY contain a `_relatedItems` key. This key is an object with optional sub-keys: + +- `notes` -- array of note definitions +- `tasks` -- array of task definitions +- `files` -- array of file definitions + +Each sub-key is optional. If `_relatedItems` is absent or empty, the object is imported as before (no behavior change). + +### REQ-02: Strip _relatedItems Before Persisting + +The `_relatedItems` key MUST be removed from the object data before it is stored in the database. It is metadata for the import process only; it MUST NOT appear in the persisted object JSON. + +### REQ-03: Process Related Items After Object Creation + +Related items MUST be created after the seed object is successfully inserted. The created object's UUID, register ID, and schema ID are required to link the related items. If object creation fails, related items MUST be skipped for that object. + +### REQ-04: Note Seeding + +Each note definition MUST contain: +- `message` (string, required) -- The note text content. + +The system MUST call `NoteService::createNote(objectUuid, message)` for each note. Notes are created as the system user (the user context active during import, typically `admin`). + +**Scenario:** +``` +GIVEN a seed object with _relatedItems.notes containing 2 entries +WHEN the seed object is created successfully +THEN 2 notes are created via NoteService linked to the object's UUID +AND each note has the specified message content +``` + +### REQ-05: Task Seeding + +Each task definition MUST contain: +- `summary` (string, required) -- The task title. + +Each task definition MAY contain: +- `description` (string) -- Task description text. +- `status` (string) -- One of: `needs-action`, `in-process`, `completed`, `cancelled`. Defaults to `needs-action`. +- `priority` (integer, 1-9) -- CalDAV priority. Defaults to 0 (undefined). +- `due` (string, ISO 8601 date) -- Due date. + +The system MUST call `TaskService::createTask(registerId, schemaId, objectUuid, objectTitle, data)` for each task. + +**Scenario:** +``` +GIVEN a seed object with _relatedItems.tasks containing 1 entry with summary "Review document" +WHEN the seed object is created successfully +THEN 1 VTODO is created in the user's calendar +AND the VTODO has X-OPENREGISTER-OBJECT set to the object's UUID +AND the VTODO SUMMARY is "Review document" +``` + +### REQ-06: File Seeding + +Each file definition MUST contain: +- `name` (string, required) -- The file name including extension. +- `content` (string, required) -- The file content. If prefixed with `base64:`, the remainder is base64-decoded. Otherwise treated as plain text. + +Each file definition MAY contain: +- `tags` (array of strings) -- Tags to attach to the file. +- `share` (boolean) -- Whether to create a public share link. Defaults to `false`. + +The system MUST call `FileService::addFile(objectEntity, fileName, content, share, tags)` for each file. + +**Scenario:** +``` +GIVEN a seed object with _relatedItems.files containing 1 entry named "rapport.pdf" +WHEN the seed object is created successfully +THEN a file named "rapport.pdf" is created in the object's folder +AND the file is linked to the object via OpenRegister's file system +``` + +### REQ-07: Idempotency for Related Items + +If a seed object already exists (detected by the existing idempotency check on slug/uuid), related items MUST be skipped. The system MUST NOT create duplicate notes, tasks, or files on re-import. + +**Scenario:** +``` +GIVEN a seed object with slug "case-001" already exists in the register +AND the seed data defines _relatedItems with 2 notes +WHEN importSeedData runs again +THEN the object is skipped (existing behavior) +AND no new notes are created +``` + +### REQ-08: Error Isolation + +If creating a related item fails (e.g., CalDAV unavailable, file quota exceeded), the error MUST be logged at WARNING level and the import MUST continue with the next related item. A failed related item MUST NOT prevent other related items or other seed objects from being imported. + +**Scenario:** +``` +GIVEN a seed object with _relatedItems containing 1 note and 1 task +AND TaskService throws an exception (no calendar available) +WHEN the seed object is imported +THEN the note is created successfully +AND a warning is logged for the failed task +AND import continues with the next seed object +``` + +### REQ-09: User Context for Related Items + +Related items are created under the user context active during the import process. For app install, this is typically the admin user. The import MUST verify that a user session exists before attempting to create tasks (which require a user calendar). If no user session is available, task and note creation MUST be skipped with a warning log. + +**Scenario:** +``` +GIVEN importSeedData runs without an active user session +AND a seed object has _relatedItems with tasks +WHEN the object is created +THEN task creation is skipped +AND a warning is logged: "Skipping related items - no user session" +``` + +### REQ-10: Logging + +The system MUST log: +- INFO: Start of related items processing for an object (count per type). +- DEBUG: Each successfully created related item (type + identifier). +- WARNING: Each failed related item (type + error message). +- INFO: Summary at end of seed data import (total related items created per type). diff --git a/openspec/changes/tmlo-metadata/specs/tmlo-auto-populate/spec.md b/openspec/changes/tmlo-metadata/specs/tmlo-auto-populate/spec.md new file mode 100644 index 000000000000..3c397c4b43f0 --- /dev/null +++ b/openspec/changes/tmlo-metadata/specs/tmlo-auto-populate/spec.md @@ -0,0 +1,41 @@ +## ADDED Requirements + +### Requirement: Auto-populate TMLO metadata on object creation + +The system SHALL automatically populate TMLO metadata when an object is created in a TMLO-enabled register. The population logic SHALL: + +1. Check if the object's register has `configuration.tmloEnabled = true` +2. Look up the object's schema for `configuration.tmloDefaults` +3. Merge schema defaults into the object's `tmlo` field +4. Set `archiefstatus` to `actief` if not already set +5. Calculate `archiefactiedatum` from `bewaarTermijn` if both the retention period is set and no explicit archiefactiedatum is provided + +#### Scenario: Auto-populate with schema defaults + +- **WHEN** an object is created in a TMLO-enabled register +- **THEN** the TmloService SHALL populate the `tmlo` field with schema-level defaults +- **THEN** the `archiefstatus` SHALL be set to `actief` + +#### Scenario: Calculate archiefactiedatum from bewaarTermijn + +- **WHEN** an object is created with `tmlo.bewaarTermijn = "P7Y"` and no archiefactiedatum +- **THEN** the `archiefactiedatum` SHALL be calculated as creation date + 7 years + +#### Scenario: Explicit TMLO values override defaults + +- **WHEN** an object is created with explicit TMLO values in the request body +- **THEN** the explicit values SHALL override any schema defaults +- **THEN** only missing fields SHALL be populated from defaults + +### Requirement: TmloService as central TMLO logic handler + +The system SHALL provide a `TmloService` class that encapsulates all TMLO-related logic: +- Populating TMLO defaults on object creation +- Validating TMLO metadata for status transitions +- Generating MDTO-compliant XML export +- Querying objects by archival status + +#### Scenario: TmloService is injectable via DI + +- **WHEN** a controller or service needs TMLO functionality +- **THEN** `TmloService` SHALL be available via Nextcloud's dependency injection container diff --git a/openspec/changes/tmlo-metadata/specs/tmlo-export/spec.md b/openspec/changes/tmlo-metadata/specs/tmlo-export/spec.md new file mode 100644 index 000000000000..89a8ab159547 --- /dev/null +++ b/openspec/changes/tmlo-metadata/specs/tmlo-export/spec.md @@ -0,0 +1,33 @@ +## ADDED Requirements + +### Requirement: MDTO-compliant XML export + +The system SHALL provide an XML export of objects with their TMLO metadata in MDTO-compliant format. The export SHALL conform to the MDTO XML schema (Metadatastandaard voor Duurzaam Toegankelijke Overheidsinformatie). + +The XML output SHALL include: +- Root element with MDTO namespace +- `identificatie` with the object UUID +- `naam` with the object name +- `classificatie` with the classification code +- `archiefnominatie` with the archival nomination +- `archiefactiedatum` with the archival action date +- `archiefstatus` mapping TMLO values to MDTO equivalents +- `bewaarTermijn` with the retention period +- `vernietigingsCategorie` with the destruction category + +#### Scenario: Export single object as MDTO XML + +- **WHEN** a GET request is made to `/api/objects/{register}/{schema}/{id}/export/mdto` +- **THEN** the response SHALL be an XML document with Content-Type `application/xml` +- **THEN** the XML SHALL contain the object's TMLO metadata in MDTO format + +#### Scenario: Export object without TMLO metadata + +- **WHEN** an export is requested for an object with no TMLO metadata +- **THEN** the response SHALL return a 422 error indicating TMLO metadata is required for MDTO export + +#### Scenario: Batch export objects as MDTO XML + +- **WHEN** a GET request is made to `/api/objects/{register}/{schema}/export/mdto` with optional query filters +- **THEN** the response SHALL be an XML document containing multiple object elements +- **THEN** each object SHALL include its TMLO metadata in MDTO format diff --git a/openspec/changes/tmlo-metadata/specs/tmlo-metadata-schema/spec.md b/openspec/changes/tmlo-metadata/specs/tmlo-metadata-schema/spec.md new file mode 100644 index 000000000000..6f2afd7a8920 --- /dev/null +++ b/openspec/changes/tmlo-metadata/specs/tmlo-metadata-schema/spec.md @@ -0,0 +1,38 @@ +## ADDED Requirements + +### Requirement: TMLO metadata fields on ObjectEntity + +The system SHALL store TMLO-compliant archival metadata on each ObjectEntity as a JSON column named `tmlo`. The `tmlo` field SHALL contain the following sub-fields conforming to TMLO 1.2 / MDTO: + +- `classificatie` (string, nullable) -- Archival classification code from the VNG Selectielijst +- `archiefnominatie` (string, nullable) -- One of: `blijvend_bewaren`, `vernietigen` +- `archiefactiedatum` (string ISO-8601 date, nullable) -- Date when the archival action (transfer or destruction) SHALL occur +- `archiefstatus` (string, nullable) -- One of: `actief`, `semi_statisch`, `overgebracht`, `vernietigd` +- `bewaarTermijn` (string ISO-8601 duration, nullable) -- Retention period (e.g., `P7Y` for 7 years) +- `vernietigingsCategorie` (string, nullable) -- Destruction category from the VNG Selectielijst result types + +When TMLO is not enabled on the register, the `tmlo` field SHALL be null or an empty object. + +#### Scenario: Object created in TMLO-enabled register carries tmlo field + +- **WHEN** an object is created in a register with tmloEnabled=true +- **THEN** the object SHALL have a `tmlo` field in its `@self` metadata containing the six core TMLO sub-fields + +#### Scenario: Object created in non-TMLO register has no tmlo field + +- **WHEN** an object is created in a register with tmloEnabled=false or tmloEnabled not set +- **THEN** the object SHALL have a null or empty `tmlo` field in its `@self` metadata + +#### Scenario: TMLO field persisted and retrieved + +- **WHEN** an object with TMLO metadata is saved and then retrieved +- **THEN** the `tmlo` field SHALL contain all previously saved sub-fields with their values intact + +### Requirement: Database migration for tmlo column + +The system SHALL add a `tmlo` JSON column to the `openregister_objects` table via a Nextcloud migration. The column SHALL be nullable with a default of NULL. + +#### Scenario: Migration adds tmlo column + +- **WHEN** the database migration runs +- **THEN** the `openregister_objects` table SHALL have a new `tmlo` column of type JSON (or TEXT for SQLite), nullable, default NULL diff --git a/openspec/changes/tmlo-metadata/specs/tmlo-query-api/spec.md b/openspec/changes/tmlo-metadata/specs/tmlo-query-api/spec.md new file mode 100644 index 000000000000..64e552f35074 --- /dev/null +++ b/openspec/changes/tmlo-metadata/specs/tmlo-query-api/spec.md @@ -0,0 +1,39 @@ +## ADDED Requirements + +### Requirement: Query objects by archival status + +The system SHALL provide API query parameters to filter objects by their TMLO archival metadata. The following query parameters SHALL be supported on the existing objects list endpoint: + +- `tmlo.archiefstatus` -- Filter by archival status (exact match) +- `tmlo.archiefnominatie` -- Filter by archival nomination (exact match) +- `tmlo.archiefactiedatum[from]` and `tmlo.archiefactiedatum[to]` -- Filter by archival action date range +- `tmlo.vernietigingsCategorie` -- Filter by destruction category (exact match) + +#### Scenario: Filter objects by archiefstatus + +- **WHEN** a GET request is made to `/api/objects/{register}/{schema}?tmlo.archiefstatus=semi_statisch` +- **THEN** only objects with `tmlo.archiefstatus = "semi_statisch"` SHALL be returned + +#### Scenario: Filter objects by archiefactiedatum range + +- **WHEN** a GET request is made with `tmlo.archiefactiedatum[from]=2025-01-01&tmlo.archiefactiedatum[to]=2025-12-31` +- **THEN** only objects with archiefactiedatum within the specified range SHALL be returned + +#### Scenario: Filter objects ready for destruction + +- **WHEN** a GET request is made with `tmlo.archiefnominatie=vernietigen&tmlo.archiefstatus=semi_statisch` +- **THEN** only objects nominated for destruction that are in semi-static status SHALL be returned + +### Requirement: Archival status summary endpoint + +The system SHALL provide a summary endpoint that returns counts of objects grouped by archival status for a given register and schema. + +#### Scenario: Get archival status summary + +- **WHEN** a GET request is made to `/api/objects/{register}/{schema}/tmlo/summary` +- **THEN** the response SHALL contain counts per archiefstatus: `{ "actief": N, "semi_statisch": N, "overgebracht": N, "vernietigd": N }` + +#### Scenario: Summary for register without TMLO + +- **WHEN** a summary is requested for a register without TMLO enabled +- **THEN** the response SHALL return a 400 error indicating TMLO is not enabled on this register diff --git a/openspec/changes/tmlo-metadata/specs/tmlo-register-toggle/spec.md b/openspec/changes/tmlo-metadata/specs/tmlo-register-toggle/spec.md new file mode 100644 index 000000000000..fee919f6f460 --- /dev/null +++ b/openspec/changes/tmlo-metadata/specs/tmlo-register-toggle/spec.md @@ -0,0 +1,38 @@ +## ADDED Requirements + +### Requirement: Register-level TMLO toggle + +The system SHALL support a `tmloEnabled` boolean in the Register entity's `configuration` JSON field. When `tmloEnabled` is true, all objects created or updated in that register SHALL carry TMLO metadata fields. + +#### Scenario: Enable TMLO on a register + +- **WHEN** a register is updated with `configuration.tmloEnabled = true` +- **THEN** the register's configuration SHALL persist tmloEnabled=true +- **THEN** new objects in that register SHALL receive TMLO default metadata + +#### Scenario: Disable TMLO on a register + +- **WHEN** a register is updated with `configuration.tmloEnabled = false` +- **THEN** the register's configuration SHALL persist tmloEnabled=false +- **THEN** new objects in that register SHALL NOT receive TMLO default metadata + +### Requirement: Schema-level TMLO defaults + +The system SHALL support TMLO default values in the Schema entity's `configuration` JSON field under a `tmloDefaults` key. These defaults SHALL be applied to new objects when their register has TMLO enabled. + +Supported defaults: +- `classificatie` -- Default classification code +- `archiefnominatie` -- Default archival nomination (`blijvend_bewaren` or `vernietigen`) +- `bewaarTermijn` -- Default retention period (ISO-8601 duration) +- `vernietigingsCategorie` -- Default destruction category + +#### Scenario: Schema with TMLO defaults applied to new object + +- **WHEN** a new object is created in a TMLO-enabled register with a schema that has tmloDefaults configured +- **THEN** the object's `tmlo` field SHALL be populated with the schema's default values +- **THEN** the `archiefstatus` SHALL default to `actief` + +#### Scenario: Schema without TMLO defaults in TMLO-enabled register + +- **WHEN** a new object is created in a TMLO-enabled register with a schema that has no tmloDefaults +- **THEN** the object's `tmlo` field SHALL be an object with all sub-fields set to null except `archiefstatus` which SHALL be `actief` diff --git a/openspec/changes/tmlo-metadata/specs/tmlo-validation/spec.md b/openspec/changes/tmlo-metadata/specs/tmlo-validation/spec.md new file mode 100644 index 000000000000..d8e5c3e9d5b5 --- /dev/null +++ b/openspec/changes/tmlo-metadata/specs/tmlo-validation/spec.md @@ -0,0 +1,51 @@ +## ADDED Requirements + +### Requirement: TMLO status transition validation + +The system SHALL validate archival status transitions to ensure required fields are present before allowing a status change. The valid transitions and their requirements are: + +- `actief` -> `semi_statisch`: No additional requirements +- `semi_statisch` -> `overgebracht`: Requires `archiefactiedatum`, `classificatie`, `archiefnominatie` to be set. `archiefnominatie` MUST be `blijvend_bewaren`. +- `semi_statisch` -> `vernietigd`: Requires `archiefactiedatum`, `classificatie`, `archiefnominatie`, `vernietigingsCategorie` to be set. `archiefnominatie` MUST be `vernietigen`. +- `actief` -> `overgebracht`: NOT allowed (must go through `semi_statisch` first) +- `actief` -> `vernietigd`: NOT allowed (must go through `semi_statisch` first) +- Any status -> `actief`: NOT allowed (cannot revert to active) + +#### Scenario: Valid transition from actief to semi_statisch + +- **WHEN** an object's archiefstatus is changed from `actief` to `semi_statisch` +- **THEN** the transition SHALL be accepted without additional validation + +#### Scenario: Transition to overgebracht with missing fields + +- **WHEN** an object's archiefstatus is changed from `semi_statisch` to `overgebracht` but `classificatie` is null +- **THEN** the system SHALL reject the update with a 422 error listing the missing required fields + +#### Scenario: Transition to vernietigd with wrong archiefnominatie + +- **WHEN** an object's archiefstatus is changed to `vernietigd` but `archiefnominatie` is `blijvend_bewaren` +- **THEN** the system SHALL reject the update with a 422 error indicating archiefnominatie must be `vernietigen` + +#### Scenario: Invalid direct transition from actief to overgebracht + +- **WHEN** an object's archiefstatus is changed directly from `actief` to `overgebracht` +- **THEN** the system SHALL reject the update with a 422 error indicating the transition is not allowed + +### Requirement: TMLO field value validation + +The system SHALL validate TMLO field values to ensure they conform to allowed values: + +- `archiefnominatie` MUST be one of: `blijvend_bewaren`, `vernietigen` +- `archiefstatus` MUST be one of: `actief`, `semi_statisch`, `overgebracht`, `vernietigd` +- `bewaarTermijn` MUST be a valid ISO-8601 duration string (e.g., `P7Y`, `P5Y6M`) +- `archiefactiedatum` MUST be a valid ISO-8601 date string + +#### Scenario: Invalid archiefnominatie value rejected + +- **WHEN** an object is saved with `tmlo.archiefnominatie = "invalid_value"` +- **THEN** the system SHALL reject the save with a 422 error listing valid values + +#### Scenario: Valid ISO-8601 duration accepted + +- **WHEN** an object is saved with `tmlo.bewaarTermijn = "P10Y"` +- **THEN** the value SHALL be accepted and stored diff --git a/openspec/changes/unify-rbac-condition-matching/specs/rbac-scopes/spec.md b/openspec/changes/unify-rbac-condition-matching/specs/rbac-scopes/spec.md new file mode 100644 index 000000000000..1200e576afde --- /dev/null +++ b/openspec/changes/unify-rbac-condition-matching/specs/rbac-scopes/spec.md @@ -0,0 +1,130 @@ +## MODIFIED Requirements + +### Requirement: Conditional Scopes with Dynamic Variables + +Authorization rules MUST support conditional matching where access depends on both group membership AND runtime conditions evaluated against the object's data. The system MUST resolve dynamic variables `$organisation`, `$userId`/`$user`, and `$now` at evaluation time. Crucially, the same rule grammar MUST be honoured by every enforcement point: the row-level SQL filter (`MagicRbacHandler::applyRbacFilters`), the schema-level PHP check (`PermissionHandler::hasPermission`), and the property-level check (`PropertyRbacHandler`). All three enforcement points SHALL route conditional rule evaluation through the shared `ConditionMatcher` service (SQL-emission is the only specialised path — the PHP-side evaluator is shared). + +#### Scenario: Schema-level conditional rule with `$lte` operator and `$now` variable matches list and find verdicts + +- **GIVEN** schema `publicaties` has authorization `{ "read": [{ "group": "public", "match": { "publishDate": { "$lte": "$now" } } }] }` +- **AND** object `pub-1` has `publishDate = 2026-01-01` +- **AND** current time is `2026-04-23` +- **WHEN** an unauthenticated caller hits `GET /api/objects/{register}/publicaties` (list path) and `GET /api/objects/{register}/publicaties/pub-1` (find path) +- **THEN** `MagicRbacHandler::applyRbacFilters()` MUST add `publish_date <= NOW()` to the SQL WHERE and return `pub-1` in the list +- **AND** `PermissionHandler::hasPermission()` MUST delegate match evaluation to `ConditionMatcher::objectMatchesConditions()` and return `true` for `pub-1` +- **AND** neither path MUST throw `"User 'Anonymous' does not have permission ..."` + +#### Scenario: Schema-level conditional rule with `$userId` variable matches list and find verdicts + +- **GIVEN** schema `taken` has authorization `{ "read": [{ "group": "medewerkers", "match": { "assignedTo": "$userId" } }] }` +- **AND** user `jan` is in group `medewerkers` +- **AND** object `taak-7` has `assignedTo = "jan"` +- **WHEN** `jan` lists taken and then fetches `taak-7` by UUID +- **THEN** the SQL filter MUST produce `assigned_to = 'jan'` and include `taak-7` in the list +- **AND** `PermissionHandler::hasPermission()` for `taak-7` MUST resolve `$userId` via `ConditionMatcher::resolveDynamicValue()` and return `true` +- **AND** the find path MUST NOT throw + +#### Scenario: Schema-level conditional rule with `$in` operator matches list and find verdicts + +- **GIVEN** schema `meldingen` has authorization `{ "read": [{ "group": "behandelaars", "match": { "status": { "$in": ["open", "review"] } } }] }` +- **AND** user `jan` is in `behandelaars` +- **AND** object `m-1` has `status = "open"`, object `m-2` has `status = "done"` +- **WHEN** `jan` lists meldingen and then fetches each by UUID +- **THEN** the list MUST include `m-1` and exclude `m-2` (SQL `IN` filter) +- **AND** `PermissionHandler::hasPermission()` MUST return `true` for `m-1` and `false` for `m-2`, evaluated via `ConditionMatcher::valueMatchesOperator` +- **AND** the verdicts MUST agree between list and find for every object + +#### Scenario: Anonymous caller against public-with-match rule is evaluated through `ConditionMatcher` + +- **GIVEN** an unauthenticated request (`IUserSession::getUser() === null`) against schema `publicaties` with `{ "read": [{ "group": "public", "match": { "publishDate": { "$lte": "$now" } } }] }` +- **WHEN** `PermissionHandler::hasPermission(userId: null)` is called with a loaded `ObjectEntity` whose `publishDate` is in the past +- **THEN** the anonymous branch at line 165-183 MUST route to `hasGroupPermission(groupId: "public")` +- **AND** `hasGroupPermission` MUST invoke `ConditionMatcher::objectMatchesConditions()` (not the removed `evaluateMatchConditions`) with the object's full envelope +- **AND** the return value MUST be `true` +- **AND** `checkPermission` MUST NOT throw + +#### Scenario: `_organisation` field resolves via `@self` envelope + +- **GIVEN** schema `zaken` with `{ "read": [{ "group": "behandelaars", "match": { "_organisation": "$organisation" } }] }` +- **AND** user `jan` in group `behandelaars` has active organisation UUID `abc-123` +- **AND** object `zaak-1` has `@self.organisation = "abc-123"` +- **WHEN** `PermissionHandler::hasGroupPermission()` evaluates the rule for `zaak-1` +- **THEN** the full object envelope (including `@self`) MUST be passed to `ConditionMatcher::objectMatchesConditions()` +- **AND** `ConditionMatcher::getObjectValue()` MUST resolve `_organisation` by stripping the underscore and looking up `@self.organisation` +- **AND** the returned value MUST equal the resolved `$organisation` (`abc-123`) and the rule MUST match + +#### Scenario: `MagicRbacHandler::hasPermission` delegates to the shared matcher + +- **GIVEN** any authorization rule with a `match` clause +- **WHEN** `MagicRbacHandler::hasPermission()` is invoked with object data (e.g. from a non-SQL code path that needs a PHP-side verdict) +- **THEN** it MUST delegate conditional evaluation to `ConditionMatcher::objectMatchesConditions()` +- **AND** the private helpers `objectMatchesConditions`, `objectPropertyMatchesCondition`, `valueMatchesOperator`, `singleOperatorMatches`, `comparisonOperatorMatches`, `arrayOperatorMatches`, `existsOperatorMatches` MUST be removed from `MagicRbacHandler` +- **AND** only the SQL-emission helpers (`applyRbacFilters`, `buildRbacConditionsSql`, `buildMatchConditions`, `buildPropertyCondition`, and their operator/comparison/array builders) MUST remain as specialised row-level code + +#### Scenario: Enforcement points agree on every rule form + +- **GIVEN** any `match` clause using operators from `{$eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $exists}` and/or dynamic variables from `{$organisation, $userId, $now}` +- **WHEN** the same principal queries the list endpoint and the find endpoint for the same object +- **THEN** the list endpoint MUST include the object if and only if the find endpoint returns 200 +- **AND** the find endpoint MUST throw `Exception` with permission-denied wording if and only if the list endpoint excludes the object +- **AND** this equivalence MUST hold for the cross-product of (authenticated / anonymous) × (owner / non-owner) × (admin / non-admin) × (every operator × every variable) + +#### Scenario: Dynamic `$now` variable resolves to a canonical SQL-native format + +- **GIVEN** a conditional `match` rule using `$now` (e.g. `{ "publicatiedatum": { "$lte": "$now" } }`) +- **WHEN** the list path (`MagicRbacHandler::resolveDynamicValue`) and the find path (`ConditionMatcher::resolveDynamicValue`) each resolve `$now` independently +- **THEN** both paths MUST emit `$now` in `Y-m-d H:i:s` format (SQL-native, e.g. `"2026-04-24 14:43:49"`) +- **AND** neither path MUST emit ISO 8601 `c` format with `"T"` separator and `+00:00` offset (e.g. `"2026-04-24T14:43:49+00:00"`) +- **AND** the format MUST match across handlers even when the stored date column is a text/JSON column where the comparison is a raw lexicographic string compare +- **AND** rule authors who need consistent date-math semantics on user-supplied data SHOULD rely on OpenRegister's `DateTimeNormalizer` to normalize stored dates to the same format, rather than embedding multiple formats in the same column + +#### Scenario: Null-valued properties evaluate conservatively (SQL three-valued logic) + +- **GIVEN** schema `publicaties` has authorization `{ "read": [{ "group": "public", "match": { "publishedAt": { "$lte": "$now" } } }] }` +- **AND** object `draft-1` has `publishedAt` absent from its data, or explicitly set to `null` +- **WHEN** an unauthenticated caller hits the list endpoint and the find endpoint +- **THEN** `MagicRbacHandler::applyRbacFilters()` MUST produce SQL `publish_date <= NOW()` which evaluates to `NULL` for `draft-1` and excludes it from the list (SQL `WHERE NULL` is false) +- **AND** `ConditionMatcher::objectMatchesConditions()` MUST return `false` for `draft-1` — delegating through `OperatorEvaluator`, a null object value against any of `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, or `$ne: ` MUST return `false` instead of relying on PHP's loose coercion (`null` → `""` / `0`) +- **AND** `PermissionHandler::hasPermission()` MUST therefore deny `draft-1`, matching the list endpoint's exclusion +- **AND** the only null-aware operator whose verdict depends on `null` MUST be `$exists` (`$exists: true` → `false` for null, `$exists: false` → `true` for null) +- **AND** `$eq: null` MAY match null object values as a backward-compatible "match missing field" escape hatch; rule authors requiring strict SQL-aligned semantics SHOULD use `$exists: false` instead + +#### Scenario: Resolved relations unwrap to their scalar id for scalar comparisons + +- **GIVEN** a conditional rule `{ "match": { "parent": "uuid-123" } }` +- **AND** object data where the `parent` property has been expanded into its full related object: `{ "parent": { "id": "uuid-123", "name": "Parent" } }` +- **WHEN** `ConditionMatcher::objectMatchesConditions()` evaluates the rule +- **THEN** the object value `{ "id": "uuid-123", ... }` MUST be unwrapped to the scalar `"uuid-123"` before the equality check +- **AND** the rule MUST return `true` regardless of whether the consumer passes expanded or unexpanded object data +- **AND** this unwrapping MUST happen for every comparison branch (simple equality, operator objects, null checks) so list (SQL compares against the id column directly) and find (PHP compares after unwrapping) produce identical verdicts +- **AND** array values without an `id` key MUST NOT be unwrapped — they stay as arrays and mismatch against scalar rules (arrays-as-first-class are not a resolved-relation shape) + +#### Scenario: Unknown operators fail closed (reject the match) + +- **GIVEN** a malformed conditional rule using an operator the system does not recognise, e.g. `{ "match": { "publishedAt": { "$foo": "bar" } } }` +- **WHEN** `MagicRbacHandler::applyRbacFilters()` (list) and `ConditionMatcher::objectMatchesConditions()` (find) each process the rule +- **THEN** the SQL path MUST produce no clause that could satisfy the rule (`buildSingleOperatorCondition` returns `null`; the rule is dropped from the OR list; if no other rule grants access the row is filtered out) +- **AND** the PHP path MUST return `false` from `OperatorEvaluator::applySingleOperator()` for the unknown operator (fail-closed), NOT `true` +- **AND** both paths MUST log a warning identifying the unknown operator +- **AND** neither path MUST grant access on a malformed rule — this prevents typos and forward-incompatible schemas from accidentally widening the access surface + +### Requirement: Divergences from strict SQL three-valued logic (documented) + +The PHP-side matcher aims for parity with SQL's three-valued logic, but two operators deliberately diverge for ergonomic reasons. Rule authors who need strict SQL alignment MUST avoid these forms and use `$exists` instead. + +#### Scenario: `$eq: null` matches null object values (escape hatch) + +- **GIVEN** a rule `{ "match": { "field": null } }` where the rule author's intent is "match objects where `field` is missing" +- **WHEN** the PHP path evaluates this against an object with `field: null` +- **THEN** `operatorEquals` MUST return `true` (`null === null`) +- **AND** the SQL path (which emits `col = NULL`, evaluating to `NULL`) would filter this row out, so the two paths diverge for this specific form +- **AND** rule authors SHOULD prefer `{ "match": { "field": { "$exists": false } } }` when strict SQL alignment matters (e.g. UNION queries, cross-engine deployments) + +#### Scenario: `$ne: null` evaluates against PHP `!==`, not SQL `IS NOT NULL` + +- **GIVEN** a rule `{ "match": { "field": { "$ne": null } } }` where the rule author's intent is "match objects where `field` has a value" +- **WHEN** the PHP path evaluates this against an object with a non-null `field` +- **THEN** `operatorNotEquals` MUST return `true` (` !== null`) +- **AND** when the PHP path evaluates this against an object with `field: null`, `operatorNotEquals` MUST return `false` (the null-value guard explicitly added for SQL alignment) +- **AND** the SQL path (which emits `col != NULL`, always `NULL`) would filter every row out, so the two paths diverge for this specific form (PHP returns sensible results for the non-null case; SQL returns no rows) +- **AND** rule authors SHOULD prefer `{ "match": { "field": { "$exists": true } } }` when strict SQL alignment matters diff --git a/openspec/changes/unit-test-coverage/specs/unit-test-coverage/spec.md b/openspec/changes/unit-test-coverage/specs/unit-test-coverage/spec.md new file mode 100644 index 000000000000..28d0bc6082e5 --- /dev/null +++ b/openspec/changes/unit-test-coverage/specs/unit-test-coverage/spec.md @@ -0,0 +1,484 @@ +--- +status: implemented +--- + +# Unit Test Coverage + +## Purpose + +Achieve comprehensive unit test code coverage for all PHP source files in OpenRegister's `lib/` directory (excluding `Migration/` and `AppInfo/Application.php`), targeting 75% line and method coverage as the enforced gate with a stretch goal of 100%. This spec defines the testing standards, mocking strategies, coverage enforcement mechanisms, and per-category test requirements that ensure every code path -- happy flows, error branches, edge cases, and boundary conditions -- is exercised by automated tests. Reliable test coverage is essential for Dutch government deployments where untested features lead to regressions, broken APIs, and failed tender compliance (ref: ADR-009 Mandatory Test Coverage). + +## Requirements + +### Requirement: Coverage Gate Enforcement at 75% Line and Method Coverage + +The project SHALL enforce a minimum 75% line and method coverage threshold via `composer coverage:check`, which runs `scripts/coverage-guard.php` against the Clover XML report. The coverage baseline is stored in `.coverage-baseline` and SHALL NOT decrease between pull requests. When coverage improves, `composer coverage:update` SHALL update the baseline. The CI pipeline SHALL fail any PR that causes coverage to drop below the baseline. The stretch goal is 100% coverage for all in-scope files (~409 source files excluding `lib/Migration/` and `lib/AppInfo/Application.php`). + +#### Scenario: Coverage gate blocks regression +- **GIVEN** the current coverage baseline is stored in `.coverage-baseline` +- **WHEN** a pull request introduces code that reduces line coverage below the baseline +- **THEN** `composer coverage:check` SHALL exit with code 1 and print a "FAIL: Coverage dropped" message + +#### Scenario: Coverage gate allows improvement +- **GIVEN** the current coverage baseline is 50% +- **WHEN** a pull request increases line coverage to 55% +- **THEN** `composer coverage:check` SHALL exit with code 0 and print "Coverage improved by 5%" + +#### Scenario: Coverage baseline update after improvement +- **GIVEN** coverage has improved from 50% to 60% +- **WHEN** `composer coverage:update` is run with the current Clover report +- **THEN** `.coverage-baseline` SHALL be updated to 60.00 + +#### Scenario: Coverage reports are generated in multiple formats +- **GIVEN** the `phpunit-unit.xml` configuration +- **WHEN** `composer test:coverage` is run inside the Nextcloud container with PCOV enabled +- **THEN** coverage reports SHALL be generated as Clover XML (`coverage/clover.xml`), HTML (`coverage/html/`), and text output to stdout + +#### Scenario: Excluded directories do not count against coverage +- **GIVEN** the PHPUnit source configuration excludes `lib/Migration/` and `lib/AppInfo/Application.php` +- **WHEN** coverage is calculated +- **THEN** files in those directories SHALL NOT appear in the coverage report as uncovered + +### Requirement: All Unit Tests SHALL Use PHPUnit\Framework\TestCase with Comprehensive Mocking + +All unit tests in `tests/Unit/` SHALL extend `PHPUnit\Framework\TestCase` and run with `phpunit-unit.xml` using the `bootstrap-unit.php` bootstrap. No unit test SHALL depend on `Test\TestCase`, Nextcloud server bootstrap, or database connections -- all external dependencies SHALL be mocked using PHPUnit's `createMock()`. Mock typing SHALL use PHPUnit 10 intersection types (`ClassName&MockObject`). Tests SHALL use positional parameters only on all PHPUnit API calls, as PHPUnit 10+ marks all methods with `@no-named-arguments`. + +#### Scenario: Test class structure follows established pattern +- **GIVEN** a new test class for `ExampleService` +- **WHEN** the test class is created +- **THEN** it SHALL extend `\PHPUnit\Framework\TestCase`, declare typed mock properties using `ClassName&MockObject`, initialize all mocks in `setUp()`, and construct the service under test with all mocked dependencies matching the constructor signature exactly + +#### Scenario: No Nextcloud server dependency in unit tests +- **GIVEN** any test file in `tests/Unit/` +- **WHEN** the test suite runs via `composer test:unit` +- **THEN** no test SHALL require Nextcloud's `lib/base.php`, `IDBConnection`, or any live service -- all SHALL be mocked + +#### Scenario: PHPUnit API calls use positional parameters only +- **GIVEN** a test file that calls PHPUnit assertion or mock methods +- **WHEN** the test is authored +- **THEN** all calls to `expects()`, `method()`, `willReturn()`, `with()`, `assertSame()`, `assertEquals()`, etc. SHALL use positional parameters, never named arguments + +### Requirement: Test All Code Paths Including Error Branches and Edge Cases + +Every public method with branching logic (if/else, switch, try/catch, early returns, null checks, loops) SHALL have tests for each distinct branch. Coverage means every line is executed, so each conditional path needs its own test scenario. This includes: if/else branches (separate test per condition), early returns (test both trigger and continuation), try/catch blocks (success path and exception path via `willThrowException()`), null coalescing and optional params (with value and with null), loops (empty collection, single item, multiple items), and switch/match (each case plus default). + +#### Scenario: If/else branches each get a dedicated test +- **GIVEN** a service method with an if/else branch based on input validity +- **WHEN** tests are written for this method +- **THEN** there SHALL be at least one test for the true branch and one test for the false branch, each with descriptive naming like `testMethodNameWithValidInput` and `testMethodNameWithInvalidInput` + +#### Scenario: Try/catch exception paths are tested via mock throwing +- **GIVEN** a service method that catches exceptions from a mapper +- **WHEN** tests are written for the exception path +- **THEN** the mapper mock SHALL be configured with `willThrowException(new \Exception('msg'))` and the test SHALL verify the catch block behavior (logging, error return, re-throw) + +#### Scenario: Null and empty input edge cases are covered +- **GIVEN** a method that accepts optional parameters +- **WHEN** tests are written +- **THEN** there SHALL be tests with null values, empty strings, empty arrays, and zero values to verify default/fallback behavior + +#### Scenario: Loop boundary conditions are tested +- **GIVEN** a method that iterates over a collection +- **WHEN** tests are written +- **THEN** there SHALL be tests with an empty collection (0 items), a single item, and multiple items to cover all loop paths + +### Requirement: Use Real Entity Instances, Never Mock Nextcloud Entities + +Nextcloud Entity classes use `__call` magic for getters/setters, which PHPUnit 10+ cannot properly mock. All tests SHALL use real entity instances with positional setter arguments. Named arguments on Entity setters are FORBIDDEN because `__call` passes `['name' => val]` but Entity's `setter()` uses `$args[0]`, causing silent data corruption. For entities that need method overrides, use a Testable subclass pattern. The Entity `$id` property is `private` in the parent class and SHALL be set via `ReflectionProperty` in tests. + +#### Scenario: Entity created as real instance with positional args +- **GIVEN** a test needs a `Schema` entity with specific field values +- **WHEN** the entity is constructed +- **THEN** it SHALL be created via `new Schema()` with setters using positional arguments (`$schema->setTitle('Test')`, not `$schema->setTitle(title: 'Test')`) + +#### Scenario: Entity ID set via Reflection +- **GIVEN** a test needs an entity with a specific ID +- **WHEN** the ID is set +- **THEN** it SHALL use `ReflectionProperty` on the `'id'` field since `$id` is `private` in `\OCP\AppFramework\Db\Entity` + +#### Scenario: Broken setter bypassed via ReflectionProperty +- **GIVEN** an entity setter that uses named arguments internally (e.g., `Register::setSchemas()`) +- **WHEN** the test needs to set the field value +- **THEN** it SHALL use `ReflectionProperty` to bypass the broken setter and test the getter separately + +#### Scenario: Testable subclass for method overrides +- **GIVEN** a test needs to control entity behavior (e.g., `hasPropertyAuthorization`) +- **WHEN** a mock is not possible due to `__call` magic +- **THEN** the test SHALL define a `TestableClassName extends ClassName` subclass with overridable methods + +### Requirement: Use Data Providers for Parameterized Scenarios + +When a method accepts variable input and the test logic is the same but values differ, tests SHALL use `#[DataProvider('providerName')]` attributes (PHPUnit 10 style, not `@dataProvider` annotations) with named test cases. This avoids duplicated test methods, makes failure messages descriptive, and enables testing large input spaces efficiently. Event classes, exception classes, format validators, and entity field type tests are prime candidates for DataProvider usage. + +#### Scenario: Event classes grouped by CRUD pattern via DataProvider +- **GIVEN** Register entity has Created, Updated, and Deleted events +- **WHEN** tests are written +- **THEN** a single `RegisterEventsTest` SHALL use `#[DataProvider('registerEventProvider')]` to test all three event classes with shared assertion logic (instanceof Event, getter returns same entity) + +#### Scenario: Format validator tested with valid and invalid inputs +- **GIVEN** `BsnFormat` validates 9-digit BSN numbers with checksum +- **WHEN** tests are written +- **THEN** a DataProvider SHALL supply named cases: `'valid_bsn'`, `'invalid_checksum'`, `'too_short'`, `'too_long'`, `'non_numeric'`, `'empty_string'`, `'null_input'` + +#### Scenario: Entity field types tested across all entities +- **GIVEN** multiple entities have similar getter/setter patterns +- **WHEN** field type tests are parameterized +- **THEN** DataProviders SHALL supply field name, input value, expected output, and type for each field + +### Requirement: Verify Side Effects with Mock Expectations + +Tests SHALL verify not just return values but also that the correct service/mapper methods are called with the correct arguments. Mock expectations SHALL use `expects($this->once())` for methods that must be called exactly once, `expects($this->never())` for methods that must NOT be called (error/skip paths), `->with($this->equalTo($value))` for exact argument matching, `->with($this->callback(fn($ctx) => ...))` for complex argument assertions, and `->willThrowException()` to simulate failures. The `willReturnCallback()` pattern SHALL be used for dynamic return values. + +#### Scenario: Service method calls mapper with correct arguments +- **GIVEN** `ObjectService::getObject()` delegates to `MagicMapper::find()` +- **WHEN** the test calls `getObject(42)` +- **THEN** the mapper mock SHALL have `expects($this->once())->method('find')->with($this->equalTo(42))` + +#### Scenario: Error path verifies logger is called +- **GIVEN** a service method catches an exception and logs it +- **WHEN** the exception path is triggered via `willThrowException()` +- **THEN** the logger mock SHALL have `expects($this->once())->method('error')->with($this->stringContains('failed'))` + +#### Scenario: Skip path verifies method is never called +- **GIVEN** a controller returns early when input validation fails +- **WHEN** invalid input triggers the early return +- **THEN** the service mock SHALL have `expects($this->never())->method('create')` + +### Requirement: Test All Service Classes with Full Branch Coverage (~175 source files) + +Service classes contain the bulk of business logic. Tests SHALL cover every public method in every service class and handler. The service layer is organized into: root services (`ObjectService`, `RegisterService`, `SchemaService`, `OrganisationService`, `ConfigurationService`, `WebhookService`, `FileService`, `IndexService`, `ImportService`, `ExportService`, `AuthenticationService`, `AuthorizationService`, `ChatService`, `VectorizationService`, `TextExtractionService`, `GraphQL/GraphQLService`, `Mcp/McpProtocolService`, and ~20 others), plus handler subdirectories (`Object/`, `File/`, `Configuration/`, `Settings/`, `Index/`, `Chat/`, `Schemas/`, `Vectorization/`, `TextExtraction/`, `GraphQL/`, `Mcp/`, `Handler/`). Each handler SHALL be tested for success, failure (mapper throws `DoesNotExistException`, `MultipleObjectsReturnedException`), empty/null input, malformed input, and each if/else/switch branch. + +#### Scenario: ObjectService CRUD handlers tested for all operation modes +- **GIVEN** `SaveObject`, `GetObject`, `DeleteObject`, `ValidateObject` and their sub-handlers (`ComputedFieldHandler`, `FilePropertyHandler`, `MetadataHydrationHandler`, `RelationCascadeHandler`) +- **WHEN** operations are performed +- **THEN** each handler SHALL be tested for: new object creation vs update, with/without file properties, with/without relation cascading, validation success and each validation failure rule, lock check (locked vs unlocked), and permission check (authorized vs unauthorized) + +#### Scenario: Index backend handlers tested for search and indexing +- **GIVEN** `SolrBackend`, `ElasticsearchBackend` and their sub-handlers in `Backends/Solr/` and `Backends/Elasticsearch/` +- **WHEN** index/search/facet operations are called +- **THEN** tests SHALL cover successful indexing, connection failure (mock HTTP client throws), empty search results, faceted search with/without facet configuration, schema creation/update, and bulk indexing with partial failures + +#### Scenario: Configuration service handlers tested for fetch/import/export +- **GIVEN** `FetchHandler`, `ImportHandler`, `ExportHandler`, `GitHubHandler`, `GitLabHandler`, `CacheHandler`, `PreviewHandler`, `UploadHandler` +- **WHEN** configuration operations are performed +- **THEN** tests SHALL cover local vs remote config, config found vs not found, valid vs malformed format, version comparison (newer/older/same), cache hit vs miss, and upload validation + +#### Scenario: File service handlers tested for all file operations +- **GIVEN** `CreateFileHandler`, `DeleteFileHandler`, `ReadFileHandler`, `UpdateFileHandler`, `FileCrudHandler`, `FileValidationHandler`, `FolderManagementHandler`, `TaggingHandler`, `FileOwnershipHandler`, `FileSharingHandler`, `FilePublishingHandler`, `DocumentProcessingHandler`, `FileFormattingHandler` +- **WHEN** file operations are requested +- **THEN** tests SHALL cover file found vs not found, valid vs rejected file type, folder exists vs needs creation, user-owned vs shared vs system file, and file with/without tags + +#### Scenario: GraphQL service tested for schema generation and query resolution +- **GIVEN** `GraphQLService`, `GraphQLResolver`, `SchemaGenerator`, `TypeMapperHandler`, `CompositionHandler`, `QueryComplexityAnalyzer`, `GraphQLErrorFormatter`, `SubscriptionService`, and scalar types (`DateTimeType`, `EmailType`, `JsonType`, `UploadType`, `UriType`, `UuidType`) +- **WHEN** GraphQL operations are performed +- **THEN** tests SHALL cover schema generation from OpenRegister schemas, query resolution with mocked data, mutation handling, subscription lifecycle, scalar type parsing/serialization, complexity analysis thresholds, and error formatting + +### Requirement: Test All Controller Classes with CRUD and Error Handling (~46 root + 12 Settings) + +Controller tests SHALL verify that each CRUD action (`index`, `show`, `create`, `update`, `destroy`) returns the correct `JSONResponse` with appropriate HTTP status codes. Error handling SHALL be tested by configuring service mocks to throw `\Exception`, `ValidationException`, `NotAuthorizedException`, `NotFoundException`, and verifying the controller returns 400, 403, 404, or 500 responses with descriptive error messages. Authorization checks SHALL be tested by mocking `IUserSession` for unauthorized users and verifying 403 responses. Input validation SHALL be tested with missing required params, wrong types, and empty values. + +#### Scenario: Controller index action returns paginated results +- **GIVEN** `ObjectsController::index()` is called with valid pagination parameters +- **WHEN** the underlying service returns a list of objects +- **THEN** the controller SHALL return a `JSONResponse` with HTTP 200 and the list data + +#### Scenario: Controller create action returns 201 on success +- **GIVEN** `RegistersController::create()` is called with valid register data +- **WHEN** the service successfully creates the register +- **THEN** the controller SHALL return HTTP 201 with the created entity data + +#### Scenario: Controller handles service exception with 500 +- **GIVEN** any controller action +- **WHEN** the underlying service throws an unhandled `\Exception` +- **THEN** the controller SHALL return HTTP 500 with an error message and the error SHALL be logged + +#### Scenario: Controller handles not found with 404 +- **GIVEN** `SchemasController::show()` is called with a non-existent ID +- **WHEN** the service throws `DoesNotExistException` +- **THEN** the controller SHALL return HTTP 404 + +#### Scenario: Controller handles unauthorized access with 403 +- **GIVEN** a controller action with RBAC or organisation-scoped access +- **WHEN** called by an unauthorized user (mocked `IUserSession`) +- **THEN** the controller SHALL return HTTP 403 + +### Requirement: Test All Db Entities and Mapper Handlers with Full Field Coverage (~65 source files) + +Entity tests SHALL cover constructor defaults, getter/setter round-trips for all field types (string, int, bool, DateTime, JSON arrays), `jsonSerialize()` output with all fields populated and with null optional fields, `__toString()` fallback chains, and any business methods. Mapper handler tests (MagicMapper handlers: `MagicBulkHandler`, `MagicFacetHandler`, `MagicOrganizationHandler`, `MagicRbacHandler`, `MagicSearchHandler`; and ObjectEntity handlers: `BulkOperationsHandler`, `CrudHandler`, `FacetsHandler`, `LockingHandler`, `QueryBuilderHandler`, `QueryOptimizationHandler`, `StatisticsHandler`) SHALL test query building with different filter combinations, empty filters, invalid filters, and edge cases. NOTE: `lib/Db/` is currently excluded from coverage in `phpunit-unit.xml` -- this exclusion MUST be narrowed to only auto-generated mappers or removed entirely for Db tests to count toward coverage. + +#### Scenario: Entity default values verified after construction +- **GIVEN** any Db entity (e.g., `Register`, `Schema`, `ObjectEntity`, `Organisation`, `Agent`, `Application`, `Configuration`) +- **WHEN** constructed with no arguments +- **THEN** all fields SHALL have their documented default values and `getId()` SHALL return null + +#### Scenario: Entity JSON serialization includes all fields +- **GIVEN** an entity with all fields populated including DateTime and JSON array fields +- **WHEN** `jsonSerialize()` is called +- **THEN** all fields SHALL appear in the returned array with correct types, DateTime fields SHALL use ISO 8601 format (`->format('c')`), and null optional fields SHALL serialize as null + +#### Scenario: MagicMapper RBAC handler applies correct query filters +- **GIVEN** `MagicRbacHandler` with a user who has restricted data access +- **WHEN** query building methods are called +- **THEN** the generated SQL SHALL include the correct WHERE clauses for RBAC filtering and parameter bindings SHALL match + +#### Scenario: ObjectEntity handlers tested for locked and unlocked states +- **GIVEN** `LockingHandler` with a locked object +- **WHEN** an update operation is attempted +- **THEN** the handler SHALL throw `LockedException` and the lock metadata SHALL be preserved + +### Requirement: Test All Event Classes via DataProvider Grouping (~39 source files) + +Event classes follow a predictable CRUD pattern per entity type. Tests SHALL group events using DataProviders: single-entity events (Created/Deleted) verify Event inheritance and entity getter; Updated events verify both old and new entity retrieval; special events (`DeepLinkRegistrationEvent`, `ToolRegistrationEvent`, `UserProfileUpdatedEvent`) are tested with dedicated methods. The following entity event families SHALL be covered: Register, Schema, Object (including Creating, Updating, Deleting, Locked, Unlocked, Reverted), Agent, Application, Configuration, Conversation, Organisation, Source, View. + +#### Scenario: CRUD events for each entity type pass DataProvider test +- **GIVEN** `RegisterCreatedEvent`, `RegisterUpdatedEvent`, `RegisterDeletedEvent` +- **WHEN** each is constructed with a real Register entity +- **THEN** each SHALL be an instance of `\OCP\EventDispatcher\Event` and the getter SHALL return the exact same entity instance + +#### Scenario: Updated events expose both old and new entities +- **GIVEN** `SchemaUpdatedEvent` constructed with a new Schema and an old Schema +- **WHEN** getters are called +- **THEN** `getSchema()` SHALL return the new entity and `getOldSchema()` SHALL return the old entity, and they SHALL be different instances + +#### Scenario: Object events cover all lifecycle stages +- **GIVEN** Object has 9 event classes: Created, Creating, Updated, Updating, Deleted, Deleting, Locked, Unlocked, Reverted +- **WHEN** each is constructed and tested +- **THEN** all 9 SHALL pass construction and getter assertions + +### Requirement: Test All BackgroundJob, Command, Cron, and Listener Classes + +BackgroundJob classes (`BlobMigrationJob`, `CacheWarmupJob`, `CronFileTextExtractionJob`, `FileTextExtractionJob`, `HookRetryJob`, `NameCacheWarmupJob`, `ObjectTextExtractionJob`, `SolrNightlyWarmupJob`, `SolrWarmupJob`, `WebhookDeliveryJob`) SHALL have `run()` tested with valid arguments, missing arguments (log warning, return gracefully), and service exceptions (catch, log error). Command classes (`MigrateStorageCommand`, `SolrDebugCommand`, `SolrManagementCommand`) SHALL have `execute()` tested with mocked `InputInterface`/`OutputInterface` for valid arguments, missing arguments, and service exceptions. Cron classes (`ConfigurationCheckJob`, `LogCleanUpTask`, `SyncConfigurationsJob`, `WebhookRetryJob`) SHALL have `run()` tested for success and exception handling. Listener classes (`CommentsEntityListener`, `FileChangeListener`, `GraphQLSubscriptionListener`, `HookListener`, `ObjectChangeListener`, `ObjectCleanupListener`, `ToolRegistrationListener`, `WebhookEventListener`) SHALL have `handle()` tested with matching events, non-matching events, and service exceptions (graceful handling, no re-throw). + +#### Scenario: BackgroundJob handles missing arguments gracefully +- **GIVEN** `WebhookDeliveryJob::run()` is called with an empty argument array +- **WHEN** the job executes +- **THEN** it SHALL log a warning via the logger mock and return without throwing + +#### Scenario: BackgroundJob handles service exception +- **GIVEN** `CacheWarmupJob::run()` is called and the underlying service throws +- **WHEN** the exception propagates to the job +- **THEN** the job SHALL catch it and log the error via `$this->mockLogger->expects($this->once())->method('error')` + +#### Scenario: Command returns non-zero exit code on error +- **GIVEN** `SolrManagementCommand::execute()` is called with valid arguments +- **WHEN** the underlying service throws an exception +- **THEN** the command SHALL write an error message to the output mock and return a non-zero exit code + +#### Scenario: Listener handles matching event by calling service +- **GIVEN** `WebhookEventListener::handle()` receives an `ObjectCreatedEvent` +- **WHEN** the event matches the listener's registered type +- **THEN** the webhook service mock SHALL be called with the event data + +#### Scenario: Listener handles service exception gracefully +- **GIVEN** `FileChangeListener::handle()` receives a matching event but the service throws +- **WHEN** the exception occurs during handling +- **THEN** the listener SHALL catch it and log the error, NOT re-throw it + +### Requirement: Test All Exception and Format Classes + +Custom exception classes (`ValidationException`, `LockedException`, `NotAuthorizedException`, `DatabaseConstraintException`, `RegisterNotFoundException`, `SchemaNotFoundException`, `CustomValidationException`, `ReferentialIntegrityException`, `AuthenticationException`, `HookStoppedException`) SHALL be tested for construction with message, code, and optional previous exception, correct inheritance hierarchy, and any custom methods (e.g., `getValidationErrors()` on `ValidationException`). Format validators (`BsnFormat`, `SemVerFormat`) SHALL be tested with DataProviders covering all valid and invalid input categories. + +#### Scenario: ValidationException carries structured validation errors +- **GIVEN** a `ValidationException` constructed with a message and validation error array +- **WHEN** `getValidationErrors()` is called +- **THEN** it SHALL return the exact error array passed to the constructor + +#### Scenario: BSN format validates checksum algorithm correctly +- **GIVEN** a DataProvider with BSN test cases +- **WHEN** `BsnFormat::validate()` is called with each case +- **THEN** valid 9-digit BSNs with correct 11-proof checksum SHALL pass, and invalid checksums, wrong lengths, non-numeric input, and empty input SHALL fail + +#### Scenario: SemVer format validates version strings per SemVer 2.0.0 +- **GIVEN** a DataProvider with version strings +- **WHEN** `SemVerFormat::validate()` is called +- **THEN** `"1.0.0"`, `"0.0.0"`, `"1.2.3-alpha"`, `"1.2.3+build"` SHALL be valid, and `"1.0"`, `"v1.0.0"`, `"1.0.0.0"`, `""` SHALL be invalid + +### Requirement: Test Organisation Service Multi-Tenancy Paths + +`OrganisationService` with its membership, caching, and settings logic SHALL be tested for all multi-tenancy scenarios. This is critical for Dutch government deployments where organisation isolation is a security requirement. Tests SHALL cover user joining/leaving organisations, active organisation switching, cache behavior, and default organisation fallback. + +#### Scenario: User joins organisation successfully +- **GIVEN** a user who is not a member of organisation X +- **WHEN** `joinOrganisation()` is called +- **THEN** the mapper SHALL be called to create the membership and the cache SHALL be invalidated + +#### Scenario: User attempts to join already-joined organisation +- **GIVEN** a user who is already a member of organisation X +- **WHEN** `joinOrganisation()` is called again +- **THEN** the service SHALL return without creating a duplicate membership + +#### Scenario: Last member leaves organisation +- **GIVEN** an organisation with only one member +- **WHEN** that member calls `leaveOrganisation()` +- **THEN** the service SHALL handle this edge case according to policy (prevent or allow with warning) + +#### Scenario: Active organisation cache expires +- **GIVEN** a user with a cached active organisation +- **WHEN** the cache TTL expires +- **THEN** the next access SHALL re-fetch from the session/database and update the cache + +#### Scenario: Default organisation fallback when none set +- **GIVEN** a user with no active organisation set +- **WHEN** `getActiveOrganisation()` is called +- **THEN** the service SHALL fall back to the default organisation or return null if none exists + +### Requirement: Test Webhook Service Delivery and Retry Logic + +`WebhookService` and `CloudEventFormatter` SHALL be tested for delivery success and failure paths, retry logic, and CloudEvents format compliance. This ensures reliable event notification delivery to external systems. + +#### Scenario: Webhook delivery succeeds on first attempt +- **GIVEN** a webhook subscription and an event to deliver +- **WHEN** the HTTP client returns 200 +- **THEN** the delivery SHALL be marked as successful and no retry SHALL be scheduled + +#### Scenario: Webhook delivery fails with HTTP 500 +- **GIVEN** a webhook delivery attempt +- **WHEN** the HTTP client returns 500 +- **THEN** a retry SHALL be scheduled via `WebhookDeliveryJob` and the failure SHALL be logged + +#### Scenario: Webhook delivery retries exhausted +- **GIVEN** a webhook that has been retried the maximum number of times +- **WHEN** the next retry also fails +- **THEN** the delivery SHALL be marked as permanently failed and no further retries SHALL be scheduled + +#### Scenario: CloudEvents format is correct +- **GIVEN** an `ObjectCreatedEvent` to format +- **WHEN** `CloudEventFormatter::format()` is called +- **THEN** the output SHALL contain `specversion`, `type`, `source`, `id`, `time`, and `data` fields per the CloudEvents 1.0 spec + +### Requirement: Test Import and Export Service Handlers + +`ImportService` and `ExportService` handle bulk data operations critical for government data migration workflows. Tests SHALL cover CSV, JSON, and XLSX import/export paths including validation, transformation, error handling, and partial failure recovery. + +#### Scenario: CSV import with valid data +- **GIVEN** a CSV file with headers matching a schema's properties +- **WHEN** `ImportService::import()` is called +- **THEN** objects SHALL be created for each valid row and the import summary SHALL report success count + +#### Scenario: Import with validation errors on some rows +- **GIVEN** a CSV file where 3 of 10 rows fail schema validation +- **WHEN** the import is processed +- **THEN** valid rows SHALL be imported, invalid rows SHALL be collected as errors, and the summary SHALL report both counts + +#### Scenario: Export to JSON produces valid output +- **GIVEN** a register with 100 objects +- **WHEN** `ExportService::export()` is called with format 'json' +- **THEN** the output SHALL be valid JSON containing all objects serialized per their schema + +### Requirement: CI Integration with composer check:strict + +All unit tests SHALL pass as part of `composer check:strict`, which runs `lint`, `phpcs`, `phpmd`, `psalm`, `phpstan`, and `test:all` in sequence. The `test:unit` script runs `phpunit --testsuite="Unit Tests"` against the `tests/Unit/` directory. Tests SHALL also be executable inside the Docker container via `docker exec -w /var/www/html/custom_apps/openregister nextcloud php vendor/bin/phpunit -c phpunit-unit.xml`. Coverage measurement requires `php-pcov` installed in the container. + +#### Scenario: All unit tests pass in check:strict pipeline +- **GIVEN** the full `composer check:strict` pipeline +- **WHEN** it reaches the `test:all` step +- **THEN** all unit tests SHALL pass with 0 errors and 0 failures + +#### Scenario: Unit tests run in Docker container +- **GIVEN** the Nextcloud Docker container with OpenRegister mounted +- **WHEN** `docker exec -w /var/www/html/custom_apps/openregister nextcloud php vendor/bin/phpunit -c phpunit-unit.xml` is run +- **THEN** all unit tests SHALL pass + +#### Scenario: Coverage measurement with PCOV +- **GIVEN** `php-pcov` is installed in the container +- **WHEN** `php -d pcov.enabled=1 -d pcov.directory=/var/www/html/custom_apps/openregister/lib vendor/bin/phpunit -c phpunit-unit.xml --coverage-clover=coverage/clover.xml` is run +- **THEN** a valid Clover XML report SHALL be generated with line-level coverage data + +#### Scenario: Specific tests can be filtered +- **GIVEN** a developer working on `ObjectService` +- **WHEN** `phpunit -c phpunit-unit.xml --filter ObjectServiceTest` is run +- **THEN** only `ObjectServiceTest` tests SHALL execute, enabling fast feedback loops + +### Requirement: Test Naming Convention and File Organization + +Test methods SHALL follow `test[MethodOrBehavior][Scenario]` naming (e.g., `testCreateObjectWithValidData`, `testDeleteObjectWhenLocked`, `testGetObjectNotFound`). Test files SHALL mirror the `lib/` directory structure under `tests/Unit/` (e.g., `lib/Service/Object/SaveObject.php` maps to `tests/Unit/Service/Object/SaveObjectTest.php`). Test classes SHALL be named `[ClassName]Test`. + +#### Scenario: Test naming is descriptive and follows convention +- **GIVEN** a test for `OrganisationService::joinOrganisation()` error handling +- **WHEN** the test method is named +- **THEN** it SHALL be named `testJoinOrganisationWhenAlreadyMember` or similar pattern that describes the method, scenario, and expected behavior + +#### Scenario: Test file mirrors source file path +- **GIVEN** source file `lib/Service/Configuration/GitHubHandler.php` +- **WHEN** the test file is created +- **THEN** it SHALL be located at `tests/Unit/Service/Configuration/GitHubHandlerTest.php` + +#### Scenario: DataProvider methods are named descriptively +- **GIVEN** a DataProvider for BSN validation test cases +- **WHEN** the provider method is named +- **THEN** it SHALL be named `bsnValidationProvider` or `validAndInvalidBsnProvider` and each case SHALL have a descriptive string key + +### Requirement: Use Reflection for Private Methods and Final Classes + +When a public method delegates to private helpers that contain complex logic worth testing individually, `ReflectionClass` SHALL be used to access them. When a class is declared `final` (e.g., `Twig\Loader\ArrayLoader`), tests SHALL use real instances rather than mocks. This applies to all `final` Nextcloud or vendor classes encountered during testing. + +#### Scenario: Private method tested via Reflection +- **GIVEN** a service with a private helper method containing complex validation logic +- **WHEN** the test needs to verify the private method directly +- **THEN** it SHALL use `$reflection = new \ReflectionClass($service); $method = $reflection->getMethod('methodName'); $method->setAccessible(true); $result = $method->invoke($service, $args);` + +#### Scenario: Final class used as real instance +- **GIVEN** a service depends on `Twig\Loader\ArrayLoader` which is `final` +- **WHEN** the test initializes the Twig environment +- **THEN** it SHALL use `new ArrayLoader(['template' => 'content'])` instead of `$this->createMock(ArrayLoader::class)` + +#### Scenario: Private property accessed for assertion +- **GIVEN** a test needs to verify internal state after an operation +- **WHEN** the state is stored in a private property +- **THEN** `ReflectionProperty` SHALL be used with `setAccessible(true)` to read the value + +### Requirement: Resolve phpunit-unit.xml Db Exclusion for Accurate Coverage + +The current `phpunit-unit.xml` excludes `lib/Db/` from coverage measurement, which means Entity, Mapper, and Handler tests (65+ source files) do not count toward coverage metrics. This exclusion SHALL be narrowed to only exclude auto-generated or trivial files, or removed entirely. The `lib/Db/MagicMapper/` handlers and `lib/Db/ObjectHandlers/` contain significant business logic that MUST be included in coverage measurement. + +#### Scenario: Db handler tests contribute to coverage +- **GIVEN** the `phpunit-unit.xml` source exclusion is updated +- **WHEN** `MagicRbacHandlerTest` runs with coverage enabled +- **THEN** `lib/Db/MagicMapper/MagicRbacHandler.php` lines SHALL appear in the coverage report + +#### Scenario: Simple entity files are included in coverage +- **GIVEN** entity files like `Register.php`, `Schema.php`, `ObjectEntity.php` +- **WHEN** their corresponding tests run with coverage enabled +- **THEN** entity getter/setter/jsonSerialize lines SHALL be counted in the coverage report + +#### Scenario: Only Migration directory remains excluded +- **GIVEN** the updated `phpunit-unit.xml` +- **WHEN** the source exclusion list is reviewed +- **THEN** only `lib/Migration/` and `lib/AppInfo/Application.php` SHALL be excluded, matching the original spec intent + +## Estimated Scope + +| Category | Source Files | Test Files (existing) | Test Files (needed) | Status | +|---|---|---|---|---| +| Event | 39 | 5 | 0 | Complete (DataProvider grouping) | +| Exception | 10 | 2 | ~1 | 8 uncovered exceptions | +| Formats | 2 | 1 | 0 | SemVer fix needed | +| Db entities + mappers + handlers | 65 | 31 | ~15 | 34 uncovered | +| Controller (root + Settings) | 58 | 78 | ~5 | Nearly complete | +| Service (root + subdirectories) | 175 | 147 | ~28 | Core handlers pending | +| BackgroundJob | 10 | 8 | ~2 | 2 uncovered | +| Command | 3 | 4 | 0 | Complete | +| Cron | 4 | 4 | 0 | Complete | +| Listener | 8 | 7 | ~1 | 1 uncovered | +| GraphQL | 12 | 0 | ~6 | Not yet started | +| Notification/Repair/Search/Settings | 5 | ~5 | 0 | Covered | +| **Total in scope** | **~409** | **~317** | **~58** | | +| Migration (excluded) | 91 | 0 | 0 | Out of scope | +| AppInfo/Application.php (excluded) | 1 | 0 | 0 | Out of scope | + +## Standards and References + +- **PHPUnit 10.5+** testing framework with `#[DataProvider]` attributes and intersection mock types +- **PHP PCOV** extension for code coverage (faster than Xdebug) +- **ADR-009: Mandatory Test Coverage** -- every new or changed backend feature MUST have corresponding unit tests; 75% coverage target for new code +- **Related spec: `api-test-coverage`** -- covers Newman/Postman API-level testing (complementary to this spec) +- **PSR-4 autoloading** for test namespaces matching `lib/` structure +- **Nextcloud app testing guidelines** -- tests run inside Docker container with full Nextcloud environment for integration, PHPUnit\Framework\TestCase only for unit + +## Specificity Assessment + +- **Specific enough to implement?** Yes -- explicit patterns, naming conventions, file-by-file scope, and categorized batches +- **Open questions:** + - Should `lib/Db/` exclusion be fully removed or narrowed? (Recommendation: narrow to exclude only auto-generated mapper boilerplate) + - Timeline for reaching 100% from current baseline? (Depends on ~58 remaining test files) + - Should integration tests (requiring database/container) count toward the 75% gate? (Recommendation: no, keep unit and integration metrics separate) diff --git a/openspec/changes/urn-resource-addressing/specs/urn-resource-addressing/spec.md b/openspec/changes/urn-resource-addressing/specs/urn-resource-addressing/spec.md new file mode 100644 index 000000000000..58beb8fc2d2f --- /dev/null +++ b/openspec/changes/urn-resource-addressing/specs/urn-resource-addressing/spec.md @@ -0,0 +1,606 @@ +--- +status: draft +--- +# URN Resource Addressing + +## Purpose + +Implement bidirectional URN-URL mapping for system-independent resource identification, enabling Dutch government organisations to address register objects across multi-vendor environments without coupling to specific system URLs or database identifiers. Every register object MUST support a URN identifier following RFC 8141 syntax that can be resolved to an API URL and vice versa, ensuring stable addressing across system migrations, domain changes, and federated deployments. This spec covers URN format definition, resolution APIs, cross-instance federation, NL government identifier mapping, event integration, and human-readable aliases. + +**Source**: Gap identified in cross-platform analysis; part of Dutch government standards ecosystem (VNG Common Ground, NL GOV API Design Rules). + +**Cross-references**: deep-link-registry (URL template resolution for consuming apps), referential-integrity (URN-based cross-references in `$ref` properties), data-sync-harvesting (URN stability across federated sync sources). + +## ADDED Requirements + +### Requirement: Objects MUST have auto-generated URN identifiers following RFC 8141 syntax + +Every register object MUST have an auto-generated URN following the pattern `urn:{organisation}:{system}:{component}:{resource}:{uuid}` where each segment maps to register and schema metadata. The URN MUST conform to RFC 8141 (Uniform Resource Names) syntax rules: the NID (Namespace Identifier) is the organisation slug, and the NSS (Namespace Specific String) encodes the system, component (register slug), resource (schema slug), and object UUID. Characters in each segment MUST be limited to RFC 8141 allowed characters: unreserved characters (A-Z, a-z, 0-9, `-`, `.`, `_`, `~`) and percent-encoded characters. The URN MUST be generated at object creation time and stored persistently on the `ObjectEntity`. + +#### Scenario: Auto-generate URN on object creation +- **GIVEN** a register `zaken` with organisation `gemeente-utrecht` and system `openregister` +- **AND** schema `meldingen` in that register +- **WHEN** a new melding object with UUID `550e8400-e29b-41d4-a716-446655440000` is created +- **THEN** a URN MUST be generated: `urn:gemeente-utrecht:openregister:zaken:meldingen:550e8400-e29b-41d4-a716-446655440000` +- **AND** the URN MUST be stored on the `ObjectEntity.urn` field +- **AND** the URN MUST be returned in the `@self` metadata block of API responses + +#### Scenario: Reject invalid URN segment characters +- **GIVEN** a register with organisation name `gemeente utrecht` (contains a space) +- **WHEN** a new object is created +- **THEN** the system MUST sanitize the organisation name to `gemeente-utrecht` (replacing spaces with hyphens) +- **AND** the resulting URN MUST contain only RFC 8141 allowed characters +- **AND** if sanitization is not possible (e.g., all invalid characters), the system MUST reject the operation with a 422 error + +#### Scenario: URN includes version-independent base +- **GIVEN** a register object with version `3.2.1` +- **WHEN** the URN is generated +- **THEN** the base URN MUST NOT include the version number +- **AND** the base URN `urn:gemeente-utrecht:openregister:zaken:meldingen:{uuid}` MUST remain stable across all versions of the object + +#### Scenario: URN uniqueness enforcement +- **GIVEN** object A already exists with URN `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` +- **WHEN** an attempt is made to create or import another object with the same URN +- **THEN** the system MUST reject the operation with a 409 Conflict response +- **AND** the error message MUST include the conflicting URN and the existing object's UUID + +#### Scenario: URN persists through object updates +- **GIVEN** an existing object with URN `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` +- **WHEN** the object's data properties are updated (name, description, custom fields) +- **THEN** the URN MUST remain unchanged +- **AND** the `@self.urn` field in the response MUST match the original URN + +### Requirement: Register-level URN pattern configuration + +Administrators MUST be able to configure URN patterns at the register level. The register entity MUST store the organisation identifier, system name (defaults to `openregister`), and an optional custom component override. This configuration determines the URN prefix for all objects in that register. The configuration MUST be stored in the `Register` entity metadata (via `IAppConfig` or register properties) and MUST be editable through the admin UI and API. + +#### Scenario: Configure URN pattern per register +- **GIVEN** the admin configures register `producten` with: + - Organisation: `gemeente-utrecht` + - System: `openregister` + - Custom component: `pdc` +- **WHEN** objects are created in this register +- **THEN** all objects MUST use URN pattern: `urn:gemeente-utrecht:openregister:pdc:{schema-slug}:{uuid}` + +#### Scenario: Default URN configuration when not explicitly set +- **GIVEN** a register `zaken` without explicit URN configuration +- **WHEN** an object is created +- **THEN** the system MUST use defaults: organisation from register's `organisation` field, system `openregister`, component from register's `slug` field +- **AND** the resulting URN pattern MUST be `urn:{register.organisation}:openregister:{register.slug}:{schema.slug}:{object.uuid}` + +#### Scenario: Update URN configuration does not change existing URNs +- **GIVEN** register `zaken` has 500 objects with URNs using organisation `gemeente-utrecht` +- **WHEN** the admin changes the organisation to `gemeente-amersfoort` +- **THEN** existing objects MUST retain their original URNs +- **AND** only new objects MUST use the updated organisation +- **AND** the admin MUST receive a warning that existing URNs will not be retroactively changed + +### Requirement: The system MUST provide a URN resolution API endpoint + +A dedicated resolution endpoint MUST translate URNs to the corresponding API URLs and object metadata. The endpoint MUST be registered in `routes.php` as `GET /api/urn/resolve` and accept a `urn` query parameter. The response MUST include the resolved URL (generated via `IURLGenerator::linkToRouteAbsolute()`), object UUID, register slug, schema slug, and object existence status. For external URN mappings, the endpoint MUST also check the `UrnMapping` table. + +#### Scenario: Resolve internal URN to URL and metadata +- **GIVEN** a URN `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` +- **AND** the corresponding object exists in the database +- **WHEN** `GET /api/urn/resolve?urn=urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` is called +- **THEN** the response MUST return HTTP 200 with: + ```json + { + "url": "https://gemeente-utrecht.nl/index.php/apps/openregister/api/objects/zaken/meldingen/abc-123", + "urn": "urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123", + "objectUuid": "abc-123", + "register": "zaken", + "schema": "meldingen", + "organisation": "gemeente-utrecht", + "exists": true + } + ``` + +#### Scenario: Resolve non-existent URN +- **GIVEN** a URN `urn:gemeente-utrecht:openregister:zaken:meldingen:does-not-exist` +- **AND** no object or external mapping matches this URN +- **WHEN** the resolution endpoint is queried +- **THEN** the response MUST return HTTP 404 with: + ```json + { + "error": "URN not found", + "urn": "urn:gemeente-utrecht:openregister:zaken:meldingen:does-not-exist", + "suggestion": "Verify the URN format and ensure the resource exists" + } + ``` + +#### Scenario: Resolve URN with malformed syntax +- **GIVEN** a URN `not-a-valid-urn` +- **WHEN** the resolution endpoint is queried +- **THEN** the response MUST return HTTP 400 with a descriptive error indicating the URN does not conform to RFC 8141 syntax +- **AND** the error MUST specify which part of the URN is invalid + +#### Scenario: Resolve external URN via mapping table +- **GIVEN** an external URN mapping exists for `urn:gemeente-utrecht:zaaksysteem:zaken:zaak:xyz-789` pointing to `https://zaaksysteem.gemeente-utrecht.nl/api/zaken/xyz-789` +- **WHEN** the resolution endpoint is queried with this URN +- **THEN** the response MUST return the mapped URL with `"external": true` and `"exists": null` (existence not verified for external resources) + +#### Scenario: Resolution endpoint supports content negotiation +- **GIVEN** a valid URN for an existing object +- **WHEN** the resolution endpoint is called with `Accept: text/uri-list` +- **THEN** the response MUST return only the resolved URL as plain text +- **AND** when called with `Accept: application/json` (default), the full metadata response is returned + +### Requirement: The system MUST provide reverse URL-to-URN resolution + +A reverse resolution endpoint MUST translate API URLs back to URN identifiers. The endpoint MUST be registered as `GET /api/urn/reverse` and accept a `url` query parameter. The reverse resolver MUST parse the URL to extract register slug, schema slug, and object UUID, then construct the corresponding URN using the register's URN configuration. + +#### Scenario: Reverse resolve URL to URN +- **GIVEN** object `abc-123` exists in register `zaken`, schema `meldingen` +- **AND** the register has organisation `gemeente-utrecht` +- **WHEN** `GET /api/urn/reverse?url=https://gemeente-utrecht.nl/index.php/apps/openregister/api/objects/zaken/meldingen/abc-123` is called +- **THEN** the response MUST return: + ```json + { + "urn": "urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123", + "url": "https://gemeente-utrecht.nl/index.php/apps/openregister/api/objects/zaken/meldingen/abc-123" + } + ``` + +#### Scenario: Reverse resolve non-OpenRegister URL +- **GIVEN** a URL `https://example.com/some-other-api/resource/123` +- **AND** no external URN mapping exists for this URL +- **WHEN** the reverse endpoint is queried +- **THEN** the response MUST return HTTP 404 with a message indicating no URN mapping exists for the given URL + +#### Scenario: Reverse resolve external mapped URL +- **GIVEN** an external URN mapping for URL `https://zaaksysteem.gemeente-utrecht.nl/api/zaken/xyz-789` +- **WHEN** the reverse endpoint is queried with this URL +- **THEN** the response MUST return the mapped URN: `urn:gemeente-utrecht:zaaksysteem:zaken:zaak:xyz-789` + +### Requirement: URN mapping tables MUST support external resources + +The system MUST support registering URN-URL mappings for resources that live outside of OpenRegister. External mappings MUST be stored in a dedicated `UrnMapping` entity with fields: `urn` (indexed, unique), `url`, `label`, `sourceSystem`, `metadata` (JSON), `createdAt`, and `updatedAt`. The entity MUST follow Nextcloud's Entity/Mapper pattern and be managed via a `UrnMappingMapper`. + +#### Scenario: Register external URN mapping via API +- **GIVEN** an external system hosts resource `urn:gemeente-utrecht:zaaksysteem:zaken:zaak:xyz-789` +- **WHEN** `POST /api/urn/mappings` is called with: + ```json + { + "urn": "urn:gemeente-utrecht:zaaksysteem:zaken:zaak:xyz-789", + "url": "https://zaaksysteem.gemeente-utrecht.nl/api/zaken/xyz-789", + "label": "Zaak XYZ-789 - Omgevingsvergunning", + "sourceSystem": "zaaksysteem" + } + ``` +- **THEN** the mapping MUST be persisted in the `urn_mappings` table +- **AND** the mapping MUST be queryable via the resolution endpoint + +#### Scenario: Bulk import external mappings from CSV +- **GIVEN** a CSV file with 1000 URN-URL pairs from an external system with columns: `urn`, `url`, `label`, `sourceSystem` +- **WHEN** the admin uploads via `POST /api/urn/mappings/import` +- **THEN** the import MUST be processed as a `QueuedJob` to avoid HTTP timeout +- **AND** the response MUST return a job ID for status tracking +- **AND** duplicates MUST be detected (by URN) and reported in the job result +- **AND** the job result MUST include counts: `created`, `skipped`, `errors` + +#### Scenario: Delete external URN mapping +- **GIVEN** an external mapping for `urn:gemeente-utrecht:zaaksysteem:zaken:zaak:xyz-789` +- **WHEN** `DELETE /api/urn/mappings/{id}` is called +- **THEN** the mapping MUST be removed from the database +- **AND** subsequent resolution of this URN MUST return 404 + +#### Scenario: List all external mappings with filtering +- **GIVEN** 50 external URN mappings from 3 different source systems +- **WHEN** `GET /api/urn/mappings?sourceSystem=zaaksysteem&_limit=20` is called +- **THEN** the response MUST return only mappings from `zaaksysteem`, paginated to 20 results +- **AND** the response MUST include standard `_page`, `_pages`, `_total` pagination metadata + +### Requirement: URNs MUST be stable across system migrations + +URN identifiers MUST remain valid even if the underlying URL, domain, or system infrastructure changes. The URN is the permanent identifier; the URL is the current location. The system MUST support updating URL mappings without changing URNs. Old URLs SHOULD return HTTP 301 redirects to new URLs when the redirect mapping is configured. + +#### Scenario: Update URL for existing URN after domain migration +- **GIVEN** a URN `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` mapped to `https://old-server.nl/index.php/apps/openregister/api/objects/zaken/meldingen/abc-123` +- **WHEN** the system migrates to `https://new-server.nl` +- **THEN** the URN MUST remain unchanged: `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` +- **AND** the resolution endpoint MUST return the new URL automatically (via `IURLGenerator::linkToRouteAbsolute()` which uses the current server configuration) +- **AND** the `@self.urn` field on objects MUST remain identical + +#### Scenario: URN survives register slug change +- **GIVEN** register `zaken` is renamed to `zaakregistratie` (slug change) +- **AND** 200 objects exist with URNs containing `zaken` as the component segment +- **WHEN** the slug change is saved +- **THEN** all existing URNs MUST remain unchanged (the URN was assigned at creation time) +- **AND** new objects MUST use the new slug `zaakregistratie` in their URNs +- **AND** both old and new URNs MUST be resolvable + +#### Scenario: Export URN-URL mapping for migration +- **GIVEN** a register with 10,000 objects, each with a URN +- **WHEN** `GET /api/urn/export?register=zaken&format=csv` is called +- **THEN** the response MUST stream a CSV file with columns: `urn`, `url`, `objectUuid`, `register`, `schema`, `created` +- **AND** the export MUST complete without memory exhaustion (streamed output) + +### Requirement: API responses MUST include URN in `@self` metadata + +All API responses that return objects MUST include the URN in the `@self` metadata block. The `@self` block already contains `id` (UUID), `slug`, `register`, and `schema`; the URN MUST be added as an additional field. This applies to single object responses, collection responses, and search results. The URN provides a system-independent identifier alongside the URL-dependent `id`. + +#### Scenario: Single object response includes URN +- **GIVEN** an object with URN `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` +- **WHEN** `GET /api/objects/zaken/meldingen/abc-123` is called +- **THEN** the response `@self` block MUST include: + ```json + { + "@self": { + "id": "abc-123", + "urn": "urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123", + "slug": "melding-fietspad", + "register": "zaken", + "schema": "meldingen" + } + } + ``` + +#### Scenario: Collection response includes URN per object +- **GIVEN** a collection of 25 objects in register `zaken`, schema `meldingen` +- **WHEN** `GET /api/objects/zaken/meldingen` is called +- **THEN** each object in the `results` array MUST include `@self.urn` +- **AND** the URN MUST be unique per object in the response + +#### Scenario: Search results include URN +- **GIVEN** a unified search query matches 5 objects across 3 schemas +- **WHEN** the search results are returned (via `ObjectsProvider`) +- **THEN** each search result MUST include the URN in its metadata +- **AND** if the deep-link-registry has a URL template for the schema, the search result URL MUST use the deep link while the URN remains in metadata + +### Requirement: Schema properties MUST support a URN reference type + +The schema property type system MUST support a `urn` property type for cross-system linking. When a property is defined as type `urn`, the system MUST validate that the value conforms to RFC 8141 URN syntax. The UI MUST attempt to resolve the URN and display the resource name (if resolvable) with a clickable link to the resolved URL. + +#### Scenario: Define a URN reference property on a schema +- **GIVEN** schema `vergunningen` with property definition: + ```json + { + "bronZaak": { + "type": "urn", + "title": "Bron zaak", + "description": "URN referentie naar de oorspronkelijke zaak" + } + } + ``` +- **WHEN** the schema is saved +- **THEN** the property MUST accept URN values and reject non-URN strings + +#### Scenario: Validate URN format on property save +- **GIVEN** schema `vergunningen` with property `bronZaak` of type `urn` +- **WHEN** the user sets `bronZaak` to `not-a-urn` +- **THEN** the system MUST reject the value with a validation error: "Value must be a valid URN (RFC 8141)" +- **AND** the object MUST NOT be saved + +#### Scenario: Resolve URN reference in UI display +- **GIVEN** an object with `bronZaak` set to `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` +- **AND** the URN resolves to an object named "Melding fietspad Heidelberglaan" +- **WHEN** the object is displayed in the UI +- **THEN** the `bronZaak` field MUST display "Melding fietspad Heidelberglaan" as a clickable link +- **AND** the link MUST point to the deep-link-resolved URL if one exists, otherwise to the OpenRegister object detail view + +#### Scenario: URN reference to external resource +- **GIVEN** an object with `bronZaak` set to `urn:gemeente-utrecht:zaaksysteem:zaken:zaak:xyz-789` +- **AND** an external URN mapping exists for this URN +- **WHEN** the object is displayed +- **THEN** the field MUST display the mapping's `label` as a clickable link to the mapped URL +- **AND** an external link icon MUST indicate the resource is outside OpenRegister + +### Requirement: Bulk URN resolution MUST be supported + +The resolution endpoint MUST support resolving multiple URNs in a single request to avoid N+1 API calls when rendering views with many cross-references. The bulk endpoint MUST accept up to 100 URNs per request and return a map of URN to resolution result. + +#### Scenario: Bulk resolve multiple URNs +- **GIVEN** 10 URNs, 8 of which resolve to existing objects and 2 are not found +- **WHEN** `POST /api/urn/resolve` is called with: + ```json + { + "urns": [ + "urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123", + "urn:gemeente-utrecht:openregister:zaken:meldingen:def-456", + "urn:gemeente-utrecht:openregister:zaken:meldingen:not-found-1", + "..." + ] + } + ``` +- **THEN** the response MUST return HTTP 200 with a map: + ```json + { + "resolved": { + "urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123": { + "url": "https://...", + "objectUuid": "abc-123", + "exists": true + } + }, + "unresolved": [ + "urn:gemeente-utrecht:openregister:zaken:meldingen:not-found-1" + ] + } + ``` + +#### Scenario: Bulk resolution respects rate limits +- **GIVEN** a request with 150 URNs (exceeding the 100 limit) +- **WHEN** the bulk endpoint is called +- **THEN** the response MUST return HTTP 400 with an error: "Maximum 100 URNs per request" + +#### Scenario: Bulk resolution includes mixed internal and external URNs +- **GIVEN** 5 internal URNs and 3 external URN mappings +- **WHEN** bulk resolution is called +- **THEN** the response MUST resolve both internal and external URNs +- **AND** external URNs MUST be marked with `"external": true` in the result + +### Requirement: URNs MUST be included in CloudEvent webhook payloads + +When webhooks fire for object lifecycle events (created, updated, deleted), the CloudEvent payload MUST include the object's URN in the event data. The existing `CloudEventFormatter` MUST be extended to include the URN alongside the object UUID and other metadata. This ensures event consumers can identify resources using system-independent URNs rather than relying on URLs or internal IDs. + +#### Scenario: Object creation event includes URN +- **GIVEN** a webhook is configured for `object.created` events +- **AND** a new object is created with URN `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` +- **WHEN** the webhook fires +- **THEN** the CloudEvent payload `data` MUST include: + ```json + { + "urn": "urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123", + "uuid": "abc-123", + "register": "zaken", + "schema": "meldingen" + } + ``` + +#### Scenario: Object update event includes URN +- **GIVEN** a webhook configured for `object.updated` events +- **WHEN** an existing object is updated +- **THEN** the CloudEvent payload MUST include the unchanged URN +- **AND** the `subject` field of the CloudEvent SHOULD be set to the URN + +#### Scenario: Object deletion event includes URN for traceability +- **GIVEN** a webhook configured for `object.deleted` events +- **WHEN** an object with URN `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` is deleted +- **THEN** the CloudEvent payload MUST include the URN even though the object no longer exists +- **AND** event consumers MUST be able to use the URN for audit trail and cross-reference cleanup + +### Requirement: Cross-instance URN resolution MUST support federation + +For federated deployments where multiple OpenRegister instances sync data via harvesting (see data-sync-harvesting spec), URN resolution MUST support cross-instance lookups. When a local resolution fails, the system MUST optionally query known federated instances. Federation endpoints MUST be configurable per register and MUST follow the same resolution API contract. + +#### Scenario: Resolve URN from federated instance +- **GIVEN** local instance `gemeente-utrecht.nl` cannot resolve URN `urn:gemeente-amersfoort:openregister:zaken:meldingen:xyz-789` +- **AND** `gemeente-amersfoort.nl` is configured as a federated peer in the register's sync sources +- **WHEN** `GET /api/urn/resolve?urn=...&federated=true` is called +- **THEN** the system MUST query `https://gemeente-amersfoort.nl/index.php/apps/openregister/api/urn/resolve?urn=...` +- **AND** return the remote result with `"federated": true` and `"source": "gemeente-amersfoort.nl"` +- **AND** the remote resolution MUST respect a configurable timeout (default 5 seconds) + +#### Scenario: Cache federated URN resolution results +- **GIVEN** a federated URN was resolved from `gemeente-amersfoort.nl` +- **WHEN** the same URN is resolved again within 1 hour +- **THEN** the cached result MUST be returned without querying the remote instance +- **AND** the response MUST include `"cached": true` and `"cachedAt": "2026-03-19T10:00:00+01:00"` + +#### Scenario: Federated resolution disabled by default +- **GIVEN** a URN that does not match any local object or mapping +- **AND** the `federated` query parameter is not set or is `false` +- **WHEN** the resolution endpoint is called +- **THEN** the system MUST NOT query any remote instances +- **AND** the response MUST return 404 with a hint: `"hint": "Try ?federated=true to search peer instances"` + +### Requirement: NL government identifier mapping (OIN, RSIN, KVK) + +The system MUST support mapping Dutch government identifiers (OIN - Organisatie Identificatie Nummer, RSIN - Rechtspersonen Samenwerkingsverbanden Informatienummer, KVK - Kamer van Koophandel nummer) to URN organisation segments. This enables interoperability with Dutch government registries (Handelsregister, BRP, BAG) that use these identifiers. The mapping MUST be configurable at the register level. + +#### Scenario: Map OIN to URN organisation segment +- **GIVEN** register `zaken` is configured with: + - Organisation slug: `gemeente-utrecht` + - OIN: `00000001001299757000` + - RSIN: `301641992` +- **WHEN** URNs are generated for objects in this register +- **THEN** the URN MUST use the organisation slug: `urn:gemeente-utrecht:openregister:zaken:{schema}:{uuid}` +- **AND** the OIN and RSIN MUST be stored as register metadata for cross-referencing +- **AND** a lookup by OIN MUST resolve to the same register (e.g., `GET /api/urn/organisations?oin=00000001001299757000`) + +#### Scenario: Resolve URN by alternative identifier +- **GIVEN** a register configured with OIN `00000001001299757000` and slug `gemeente-utrecht` +- **WHEN** an external system queries with a URN using the OIN as organisation: `urn:00000001001299757000:openregister:zaken:meldingen:abc-123` +- **THEN** the system MUST recognize the OIN and resolve it as equivalent to `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` +- **AND** the canonical URN (using the slug) MUST be returned in the response + +#### Scenario: KVK number for non-government organisations +- **GIVEN** a private organisation uses OpenRegister with KVK number `12345678` +- **AND** the register is configured with organisation slug `bedrijf-x` and KVK `12345678` +- **WHEN** a URN lookup includes `kvk=12345678` +- **THEN** the system MUST resolve it to the register owned by `bedrijf-x` + +### Requirement: URN-based search and lookup MUST be supported + +The system MUST support searching for objects by URN or partial URN. The existing search infrastructure (MagicMapper, ObjectsProvider) MUST be extended to index and query URN fields. This enables users to paste a URN into the search bar and find the corresponding object. + +#### Scenario: Find object by exact URN +- **GIVEN** an object with URN `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` +- **WHEN** `GET /api/objects?_search=urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` is called +- **THEN** the object MUST be returned as the sole result +- **AND** the match MUST be exact (not fuzzy) + +#### Scenario: Find objects by partial URN (wildcard) +- **GIVEN** 50 objects in register `zaken`, schema `meldingen` +- **WHEN** `GET /api/objects?urn=urn:gemeente-utrecht:openregister:zaken:meldingen:*` is called +- **THEN** all 50 objects MUST be returned (matching the URN prefix) +- **AND** pagination MUST apply normally + +#### Scenario: Unified search finds by URN +- **GIVEN** a user types `urn:gemeente-utrecht:openregister:zaken:meldingen:abc-123` in the Nextcloud unified search bar +- **WHEN** the `ObjectsProvider` processes the search query +- **THEN** the object MUST appear in the search results +- **AND** the deep-link-registry MUST be used for URL resolution (if a deep link is registered for the schema) + +### Requirement: Human-readable URN aliases MUST be supported + +Objects MUST support optional human-readable URN aliases alongside their canonical UUID-based URN. An alias replaces the UUID segment with a slug or meaningful identifier (e.g., `urn:gemeente-utrecht:openregister:pdc:producten:paspoort-aanvragen`). Aliases MUST be unique within the same register and schema scope. Both the canonical URN and the alias MUST resolve to the same object. + +#### Scenario: Create object with human-readable alias +- **GIVEN** register `pdc` with schema `producten` +- **WHEN** an object is created with slug `paspoort-aanvragen` +- **THEN** two URNs MUST be resolvable: + - Canonical: `urn:gemeente-utrecht:openregister:pdc:producten:550e8400-e29b-41d4-a716-446655440000` + - Alias: `urn:gemeente-utrecht:openregister:pdc:producten:paspoort-aanvragen` + +#### Scenario: Alias uniqueness conflict +- **GIVEN** an existing object with alias URN `urn:gemeente-utrecht:openregister:pdc:producten:paspoort-aanvragen` +- **WHEN** a second object in the same register and schema is created with slug `paspoort-aanvragen` +- **THEN** the system MUST reject the duplicate slug (existing behavior via slug uniqueness) +- **AND** the canonical UUID-based URN MUST still be generated + +#### Scenario: Alias changes when slug changes +- **GIVEN** an object with slug `paspoort-aanvragen` and corresponding alias URN +- **WHEN** the slug is updated to `paspoort-verlengen` +- **THEN** the alias URN MUST change to `urn:gemeente-utrecht:openregister:pdc:producten:paspoort-verlengen` +- **AND** the canonical UUID-based URN MUST remain unchanged +- **AND** the old alias URN SHOULD return a 301 redirect to the new alias for a configurable grace period + +### Requirement: URN versioning MUST support version-specific addressing + +For objects that use content versioning, URNs MUST support an optional version qualifier appended as a query component (per RFC 8141 q-component). The base URN (without version) MUST always resolve to the latest version. Version-specific URNs MUST resolve to the exact version requested. + +#### Scenario: Resolve version-specific URN +- **GIVEN** an object with 3 versions (1.0, 2.0, 3.0) and base URN `urn:gemeente-utrecht:openregister:pdc:producten:abc-123` +- **WHEN** `GET /api/urn/resolve?urn=urn:gemeente-utrecht:openregister:pdc:producten:abc-123?=version:2.0` is called (using RFC 8141 q-component syntax) +- **THEN** the response MUST resolve to version 2.0 of the object +- **AND** the URL MUST include the version parameter: `.../abc-123?_version=2.0` + +#### Scenario: Base URN resolves to latest version +- **GIVEN** the same object with 3 versions +- **WHEN** the base URN `urn:gemeente-utrecht:openregister:pdc:producten:abc-123` is resolved (without version qualifier) +- **THEN** the response MUST resolve to version 3.0 (latest) + +#### Scenario: Resolve non-existent version +- **GIVEN** an object with versions 1.0 and 2.0 +- **WHEN** version `5.0` is requested via URN version qualifier +- **THEN** the response MUST return HTTP 404 with: `"error": "Version 5.0 not found for this object"` +- **AND** the response MUST include available versions: `"availableVersions": ["1.0", "2.0"]` + +### Requirement: URN capabilities MUST be discoverable via Nextcloud capabilities API + +The URN resolution endpoint availability, configured URN namespace, and supported features MUST be exposed via `ICapability` in Nextcloud's capabilities API (`/ocs/v2.php/cloud/capabilities`). This enables clients and federated instances to discover URN support programmatically. + +#### Scenario: Capabilities response includes URN configuration +- **WHEN** `GET /ocs/v2.php/cloud/capabilities` is called +- **THEN** the response MUST include: + ```json + { + "openregister": { + "urn": { + "supported": true, + "resolveEndpoint": "/index.php/apps/openregister/api/urn/resolve", + "reverseEndpoint": "/index.php/apps/openregister/api/urn/reverse", + "bulkSupported": true, + "federationSupported": true, + "maxBulkUrns": 100, + "version": "1.0" + } + } + } + ``` + +#### Scenario: Federated instance discovers URN support +- **GIVEN** `gemeente-amersfoort.nl` wants to check if `gemeente-utrecht.nl` supports URN resolution +- **WHEN** the capabilities endpoint is queried +- **THEN** the presence of `openregister.urn.supported: true` confirms URN resolution is available +- **AND** the `resolveEndpoint` path can be used to construct the full resolution URL + +#### Scenario: Capabilities reflect disabled features +- **GIVEN** URN federation is disabled in the admin configuration +- **WHEN** capabilities are queried +- **THEN** `federationSupported` MUST be `false` +- **AND** the `federated=true` query parameter on the resolve endpoint MUST return HTTP 501 Not Implemented + +## Current Implementation Status + +**Not implemented.** No URN support exists in the codebase: + +- No `urn` field on `ObjectEntity` (objects have `uuid`, `slug`, and `uri` fields but no `urn`) +- No URN generation logic or `UrnService` +- No URN resolution endpoint (`/api/urn/resolve`) or reverse endpoint (`/api/urn/reverse`) +- No URN mapping table or `UrnMapping` entity +- No URN property type in schema definitions +- No organisation-level URN configuration on registers (registers have `organisation` and `slug` fields that can serve as URN segments) +- No URN in `@self` metadata block (currently contains: `id`, `slug`, `name`, `description`, `uri`, `version`, `register`, `schema`, `source`) +- No URN in CloudEvent webhook payloads (current `CloudEventFormatter` includes object data but not URN) +- No URN-based search or lookup capability +- The only URN-like patterns in the codebase are unrelated (`urn:ietf:params:...` in JWT authentication) + +**Existing infrastructure that supports implementation:** +- `ObjectEntity.uuid` — UUID generation already exists; URN would wrap the UUID with namespace segments +- `ObjectEntity.uri` — existing field that could hold the URN (or a new dedicated `urn` field) +- `ObjectEntity.slug` — existing slug field can serve as human-readable alias segment +- `Register.organisation` and `Register.slug` — existing fields that provide the organisation and component URN segments +- `Schema.slug` — existing field that provides the resource type URN segment +- `@self` metadata block — existing metadata structure in `ObjectEntity::getObjectArray()` at line 649 +- `CloudEventFormatter` — existing webhook payload formatter that can be extended with URN +- `DeepLinkRegistryService` — existing URL resolution that can be combined with URN resolution +- `IURLGenerator` — Nextcloud URL generator for constructing the URL portion of URN-URL mappings +- `MagicMapper` — indexed lookup infrastructure for efficient URN queries + +## Standards & References + +- **RFC 8141** — Uniform Resource Names (URNs): Defines URN syntax (`urn::`), q-component for version qualifiers, r-component for resolution parameters. The OpenRegister URN uses the organisation as NID and `{system}:{component}:{resource}:{uuid}` as NSS. +- **RFC 3986** — Uniform Resource Identifier (URI) Generic Syntax: URNs are a subset of URIs. The reverse resolution (URL to URN) maps between the URI schemes. +- **RFC 2141** — URN Syntax (superseded by RFC 8141): Historical reference; RFC 8141 is the current standard. +- **NEN 3610** — Dutch geographic information standard: Uses URN-based identifiers for geo-objects (`NL.IMBAG.Pand.0599100000610021`). OpenRegister URN pattern is inspired by but not identical to NEN 3610 identifiers. +- **NL GOV API Design Rules (API-49)** — Stable identifiers for government resources: Recommends persistent URIs for government API resources. URNs provide the stability layer that API-49 requires. +- **VNG Common Ground** — Recommends URN-based resource identification for interoperability across municipal systems. +- **CloudEvents 1.0 Specification** — Event format used by OpenRegister webhooks. URNs SHOULD be included as the `subject` field of CloudEvents for cross-system event correlation. +- **OIN (Organisatie Identificatie Nummer)** — Dutch government organisation identifier (20-digit number). Used in PKIoverheid certificates and Digikoppeling. +- **RSIN (Rechtspersonen Samenwerkingsverbanden Informatienummer)** — Dutch legal entity identifier from the Handelsregister. +- **KVK (Kamer van Koophandel)** — Dutch Chamber of Commerce registration number (8-digit). +- **PURL (Persistent URL)** — Alternative approach to stable resource addressing; URNs provide stronger decoupling from transport protocol. + +## Specificity Assessment + +- **Specific enough to implement?** Yes — the URN pattern, segment sources, resolution API, and integration points are clearly defined. +- **Addressed in this enrichment:** + - URN format: `urn:{register.organisation}:{system}:{register.slug}:{schema.slug}:{object.uuid}` with RFC 8141 character validation + - URN storage: dedicated `urn` field on `ObjectEntity` (or computed from existing fields) + - URN uniqueness: enforced at database level (unique index on `urn` column) + - URN configuration: register-level metadata (organisation, system, custom component) + - Mapping table schema: `UrnMapping` entity with `urn` (unique, indexed), `url`, `label`, `sourceSystem`, `metadata`, timestamps + - Bulk resolution: `POST /api/urn/resolve` with max 100 URNs per request + - Performance: indexed `urn` column, cached federated lookups, streamed exports + - CloudEvent/webhook integration: URN in event `data` and `subject` fields + - NL government identifiers: OIN, RSIN, KVK mapping to organisation segment + - Versioning: RFC 8141 q-component for version-specific URN resolution +- **Open questions resolved:** + - URN is stored as a dedicated column (not computed on-the-fly) for indexing and query performance + - Federated resolution uses existing sync source configuration for peer discovery + - URN pattern aligns with RFC 8141 using organisation slug as informal NID + +## Nextcloud Integration Analysis + +**Status**: Not yet implemented. No URN generation, resolution endpoints, mapping tables, or URN property types exist. Objects have `uuid`, `slug`, and `uri` fields but no `urn` field. + +**Nextcloud Core Interfaces**: +- `IURLGenerator` (`OCP\IURLGenerator`): Use `linkToRouteAbsolute()` to generate the URL portion of URN-URL mappings. Ensures correct URLs regardless of reverse proxy, subdirectory installation, or domain changes. +- `ICapability` (`OCP\Capabilities\ICapability`): Expose URN support status, resolution endpoint paths, federation support, and configured namespace via `/ocs/v2.php/cloud/capabilities`. +- `IAppConfig` (`OCP\IAppConfig`): Store URN configuration (default organisation, default system name) as app-level config. Register-level URN overrides stored as register entity properties. +- `routes.php`: Register dedicated URN endpoints: `GET /api/urn/resolve`, `GET /api/urn/reverse`, `POST /api/urn/resolve` (bulk), `GET/POST/DELETE /api/urn/mappings`, `GET /api/urn/export`, `GET /api/urn/organisations`. +- `QueuedJob` (`OCP\BackgroundJob\QueuedJob`): Process bulk URN mapping imports asynchronously to avoid HTTP timeout. +- `ICacheFactory` (`OCP\ICacheFactory`): Cache federated URN resolution results with configurable TTL. + +**Implementation Approach**: +1. **`UrnService`** — Core service with methods: `generateUrn(ObjectEntity, Register, Schema): string`, `resolveUrn(string): ?array`, `reverseResolve(string): ?string`, `bulkResolve(array): array`, `validateUrn(string): bool`. Parses URN segments to identify register, schema, and UUID. Uses `ObjectService` for existence verification. +2. **`ObjectEntity` extension** — Add `urn` field (string, nullable, indexed unique). Set in `ObjectService::saveObject()` at creation time by calling `UrnService::generateUrn()`. Include in `getObjectArray()` alongside existing `@self` fields. +3. **`UrnMapping` entity** — New Nextcloud Entity with Mapper for external URN-URL pairs. Table `oc_openregister_urn_mappings` with columns: `id`, `urn` (varchar 512, unique index), `url` (text), `label` (varchar 255), `source_system` (varchar 128), `metadata` (json), `created_at`, `updated_at`. +4. **`UrnController`** — Handles resolve, reverse, bulk resolve, mapping CRUD, export, and organisation lookup endpoints. Validates URN syntax against RFC 8141 before processing. +5. **`CloudEventFormatter` extension** — Add `urn` to event `data` payload and set CloudEvent `subject` to the object URN. +6. **Schema property type** — Add `urn` to the property type system. Validation checks RFC 8141 syntax. UI resolves URN references via `UrnService` for display. +7. **Register entity extension** — Add `urnOrganisation`, `urnSystem`, `urnComponent` fields (or store in existing metadata JSON). Provide defaults from `organisation` and `slug` fields. + +**Dependencies on Existing OpenRegister Features**: +- `ObjectEntity` (`lib/Db/ObjectEntity.php`) — object model where URN is generated and stored; `@self` metadata block at `getObjectArray()`. +- `ObjectService` — object retrieval for URN resolution verification and save-time URN generation. +- `Register` entity (`lib/Db/Register.php`) — `organisation` and `slug` fields provide URN segments. +- `Schema` entity (`lib/Db/Schema.php`) — `slug` field provides the resource type URN segment. +- `CloudEventFormatter` (`lib/Service/Webhook/CloudEventFormatter.php`) — webhook payload formatter to extend with URN. +- `DeepLinkRegistryService` (`lib/Service/DeepLinkRegistryService.php`) — URL resolution for search results; URN provides the stable identifier while deep links provide the display URL. +- `MagicMapper` — indexed lookup for efficient URN queries via the search infrastructure. +- Schema property type system — extension point for the `urn` property type validation. +- `Source` entity and sync configuration — federation peer discovery for cross-instance URN resolution. diff --git a/openspec/changes/workflow-operations/specs/workflow-operations/spec.md b/openspec/changes/workflow-operations/specs/workflow-operations/spec.md new file mode 100644 index 000000000000..55b1251d762c --- /dev/null +++ b/openspec/changes/workflow-operations/specs/workflow-operations/spec.md @@ -0,0 +1,267 @@ +# Workflow Operations -- Delta Spec + +This is a delta spec for `openspec/specs/workflow-integration/spec.md`. It adds operational capabilities that are listed as "Not yet implemented" in the main spec. + +## ADDED Requirements + +### Requirement: Workflow Execution History + +All hook executions MUST be persisted as `WorkflowExecution` entities in the database, providing a queryable execution history for monitoring, debugging, and audit purposes. + +#### Scenario: Hook execution is persisted to history + +- GIVEN a sync hook `validate-kvk` executes for object `obj-123` +- WHEN the workflow returns `status: "approved"` in 45ms +- THEN a `WorkflowExecution` entity MUST be created with `hookId: "validate-kvk"`, `eventType: "creating"`, `objectUuid: "obj-123"`, `engine: "n8n"`, `workflowId: "kvk-validator"`, `status: "approved"`, `durationMs: 45`, `executedAt: ` +- AND the existing logger-based logging MUST continue alongside the entity persistence + +#### Scenario: Failed execution stores error details and payload + +- GIVEN a sync hook fails due to a timeout +- WHEN the execution is persisted +- THEN the `WorkflowExecution` entity MUST include `status: "error"`, the `errors` field with a JSON array of error objects, and the `payload` field with the full CloudEvent payload that was sent +- AND the `metadata` field MUST include engine-specific error context + +#### Scenario: Async hook delivery is persisted + +- GIVEN an async hook `send-notification` fires +- WHEN the webhook delivery succeeds +- THEN a `WorkflowExecution` entity MUST be created with `mode: "async"`, `status: "delivered"` +- AND if delivery fails, `status` MUST be `"failed"` with error details + +#### Scenario: List executions with filters + +- GIVEN 100 workflow executions exist in the database +- WHEN an authenticated user sends `GET /api/workflow-executions/?objectUuid=obj-123&status=error&limit=10` +- THEN the response MUST include only executions matching all filter criteria +- AND the response MUST include `total` count, `limit`, and `offset` for pagination +- AND results MUST be sorted by `executedAt` descending (most recent first) + +#### Scenario: Get single execution detail + +- GIVEN a workflow execution with ID 42 exists +- WHEN an authenticated user sends `GET /api/workflow-executions/42` +- THEN the response MUST include all fields: hookId, eventType, objectUuid, schemaId, registerId, engine, workflowId, mode, status, durationMs, errors, metadata, payload, executedAt + +#### Scenario: Admin deletes execution record + +- GIVEN a workflow execution with ID 42 exists +- WHEN an admin sends `DELETE /api/workflow-executions/42` +- THEN the record MUST be removed from the database +- AND non-admin users MUST receive HTTP 403 + +### Requirement: Scheduled Workflow Triggers + +The system MUST support scheduled workflows that run on a recurring basis, independent of object lifecycle events. Scheduled workflows use Nextcloud's TimedJob infrastructure. + +#### Scenario: Create a scheduled workflow + +- GIVEN an admin is authenticated and an n8n engine is registered +- WHEN they POST to `/api/scheduled-workflows/` with `name`, `engine`, `workflowId`, `registerId`, `schemaId`, `interval` (seconds), and `enabled: true` +- THEN a `ScheduledWorkflow` entity MUST be created +- AND the `ScheduledWorkflowJob` TimedJob MUST include this schedule in its next evaluation + +#### Scenario: TimedJob evaluates scheduled workflows + +- GIVEN a scheduled workflow `termijn-bewaking` with `interval: 86400` and `lastRun: 2026-03-23T02:00:00Z` +- WHEN the `ScheduledWorkflowJob` runs at `2026-03-24T02:01:00Z` (more than 86400 seconds later) +- THEN the job MUST resolve the engine adapter via `WorkflowEngineRegistry` +- AND build a payload with `register`, `schema`, `scheduledWorkflowId`, and the configured `payload` data +- AND execute the workflow via `adapter->executeWorkflow()` +- AND update `lastRun` to the current timestamp and `lastStatus` to the result status +- AND persist a `WorkflowExecution` entity with `eventType: "scheduled"` + +#### Scenario: Scheduled workflow not yet due + +- GIVEN a scheduled workflow with `interval: 86400` and `lastRun: 2026-03-24T01:00:00Z` +- WHEN the `ScheduledWorkflowJob` runs at `2026-03-24T02:00:00Z` (only 3600 seconds later) +- THEN the job MUST skip this schedule +- AND MUST NOT execute the workflow + +#### Scenario: Disabled scheduled workflow is skipped + +- GIVEN a scheduled workflow with `enabled: false` +- WHEN the `ScheduledWorkflowJob` evaluates schedules +- THEN it MUST skip this workflow entirely + +#### Scenario: Scheduled workflow engine is unreachable + +- GIVEN a scheduled workflow targets an engine that is currently down +- WHEN the job attempts execution +- THEN it MUST set `lastStatus` to `"error"` +- AND log the failure +- AND persist a `WorkflowExecution` with `status: "error"` and the error details +- AND MUST NOT crash the TimedJob (other schedules must still run) + +#### Scenario: Update scheduled workflow + +- GIVEN a scheduled workflow with ID 1 exists +- WHEN an admin sends `PUT /api/scheduled-workflows/1` with `interval: 3600` +- THEN the interval MUST be updated +- AND the next evaluation MUST use the new interval + +#### Scenario: Delete scheduled workflow + +- GIVEN a scheduled workflow with ID 1 exists +- WHEN an admin sends `DELETE /api/scheduled-workflows/1` +- THEN the entity MUST be removed from the database +- AND the job MUST no longer evaluate this schedule + +### Requirement: Multi-Step Approval Chains + +The system MUST support configurable multi-step approval workflows where objects require sign-off from one or more roles before proceeding. Approval chains are first-class entities that integrate with Nextcloud's group system. + +#### Scenario: Create an approval chain + +- GIVEN an admin is authenticated +- WHEN they POST to `/api/approval-chains/` with `name: "Vergunning goedkeuring"`, `schemaId: 12`, `statusField: "status"`, and `steps: [{ "order": 1, "role": "teamleider", "statusOnApprove": "wacht_op_afdelingshoofd", "statusOnReject": "afgewezen" }, { "order": 2, "role": "afdelingshoofd", "statusOnApprove": "goedgekeurd", "statusOnReject": "afgewezen" }]` +- THEN an `ApprovalChain` entity MUST be created with the steps stored as JSON +- AND the steps MUST be validated (unique order values, non-empty roles, valid status values) + +#### Scenario: Object enters approval chain on creation + +- GIVEN an approval chain exists for schema `vergunningen` with 2 steps +- WHEN a new vergunning object is created +- THEN the system MUST create `ApprovalStep` entities for the object: step 1 with `status: "pending"`, step 2 with `status: "waiting"` +- AND the object's `statusField` (e.g., `status`) MUST be set to the initial pending value + +#### Scenario: Approve a pending step + +- GIVEN object `obj-123` has approval step 1 with `status: "pending"` and `role: "teamleider"` +- WHEN a user who is a member of the `teamleider` Nextcloud group sends `POST /api/approval-steps/{stepId}/approve` with `comment: "Akkoord"` +- THEN step 1 MUST be updated to `status: "approved"`, `decidedBy: `, `comment: "Akkoord"`, `decidedAt: ` +- AND step 2 MUST be updated from `status: "waiting"` to `status: "pending"` +- AND the object's status field MUST be set to `statusOnApprove` from step 1 (e.g., `"wacht_op_afdelingshoofd"`) +- AND a `WorkflowExecution` MUST be persisted with `eventType: "approval"`, `status: "approved"` + +#### Scenario: Reject a pending step + +- GIVEN object `obj-123` has approval step 1 with `status: "pending"` and `role: "teamleider"` +- WHEN a user in the `teamleider` group sends `POST /api/approval-steps/{stepId}/reject` with `comment: "Onvoldoende onderbouwing"` +- THEN step 1 MUST be updated to `status: "rejected"`, `decidedBy: `, `comment` +- AND all subsequent steps MUST remain in `status: "waiting"` (they are NOT activated) +- AND the object's status field MUST be set to `statusOnReject` from step 1 (e.g., `"afgewezen"`) + +#### Scenario: Unauthorised user cannot approve + +- GIVEN approval step 1 requires `role: "teamleider"` +- WHEN a user who is NOT a member of the `teamleider` group sends `POST /api/approval-steps/{stepId}/approve` +- THEN the response MUST be HTTP 403 with error message "You are not authorised for this approval step" + +#### Scenario: Final step approval completes the chain + +- GIVEN a 2-step chain where step 1 is `approved` and step 2 is `pending` +- WHEN the afdelingshoofd approves step 2 +- THEN the object's status MUST be set to the final `statusOnApprove` (e.g., `"goedgekeurd"`) +- AND no further steps exist -- the chain is complete + +#### Scenario: List objects in approval chain with progress + +- GIVEN 10 objects are in approval chain ID 1 +- WHEN an authenticated user sends `GET /api/approval-chains/1/objects` +- THEN the response MUST include each object's UUID, current step, step status, and overall chain progress (e.g., "1 of 2 steps approved") + +#### Scenario: Query pending approvals for current user + +- GIVEN the current user is a member of groups `teamleider` and `admin` +- WHEN they send `GET /api/approval-steps/?status=pending&role=teamleider` +- THEN the response MUST include all pending steps where `role` matches one of the user's groups +- AND each result MUST include the object UUID, chain name, and step order + +### Requirement: Test Hook / Dry-Run Execution + +Administrators MUST be able to test workflow execution with sample data without persisting any changes, to verify correct behavior before activating hooks in production. + +#### Scenario: Test hook via engine endpoint + +- GIVEN an n8n engine is registered with ID 1 and a workflow `kvk-validator` is deployed +- WHEN an admin sends `POST /api/engines/1/test-hook` with `workflowId: "kvk-validator"`, `sampleData: { "kvkNumber": "12345678" }`, `timeout: 10` +- THEN the system MUST resolve the adapter and call `executeWorkflow("kvk-validator", sampleData, 10)` +- AND the response MUST include the full `WorkflowResult` (status, data, errors, metadata) +- AND the response MUST include `dryRun: true` +- AND NO database writes MUST occur (no object creation, no execution history entry) + +#### Scenario: Test hook with invalid workflow ID + +- GIVEN an engine is registered but the workflowId does not exist +- WHEN the test-hook endpoint is called +- THEN the response MUST be HTTP 422 with an error message from the adapter +- AND no database writes MUST occur + +#### Scenario: Test hook with engine down + +- GIVEN an engine is registered but currently unreachable +- WHEN the test-hook endpoint is called +- THEN the response MUST be HTTP 502 with `status: "error"` and a connectivity error message + +### Requirement: Workflow Configuration UI + +Administrators MUST be able to configure schema hooks via a graphical interface in the schema settings, without writing JSON manually. + +#### Scenario: Schema settings shows Workflows tab + +- GIVEN an admin navigates to schema `meldingen` settings page +- WHEN the page loads +- THEN a "Workflows" tab MUST be visible alongside other schema settings tabs +- AND the tab MUST display a list of configured hooks from the schema's `hooks` JSON property + +#### Scenario: Add a new hook via UI + +- GIVEN the admin clicks "Add hook" in the Workflows tab +- WHEN the hook form is displayed +- THEN it MUST provide form fields for: event type (dropdown: creating/updating/deleting/created/updated/deleted), engine (dropdown populated from `GET /api/engines/`), workflowId (dropdown populated from `adapter.listWorkflows()` for selected engine), mode (sync/async), order (number), timeout (number, default 30), onFailure (dropdown: reject/allow/flag/queue), onTimeout (dropdown: reject/allow/flag/queue), onEngineDown (dropdown: reject/allow/flag/queue), filterCondition (JSON editor), enabled (toggle) +- AND on save, the form MUST update the schema's `hooks` array via the schema API + +#### Scenario: Edit an existing hook + +- GIVEN a hook `validate-kvk` exists in the schema's hooks array +- WHEN the admin clicks the edit icon +- THEN the hook form MUST be pre-populated with the hook's current values +- AND on save, the hook MUST be updated in-place in the `hooks` array + +#### Scenario: Delete a hook + +- GIVEN a hook `validate-kvk` exists in the schema's hooks array +- WHEN the admin clicks the delete icon and confirms +- THEN the hook MUST be removed from the `hooks` array +- AND the schema MUST be saved via the schema API + +#### Scenario: View execution history for a hook + +- GIVEN the Workflows tab is open for schema `meldingen` +- WHEN the admin clicks on a hook or expands an execution history section +- THEN the UI MUST display recent `WorkflowExecution` records filtered by `schemaId` and `hookId` +- AND each entry MUST show: timestamp, objectUuid, status (color-coded), duration, and a link to the full detail + +#### Scenario: Test hook button in UI + +- GIVEN a hook is configured with engine and workflowId +- WHEN the admin clicks "Test" on the hook row +- THEN a dialog MUST open with a JSON editor pre-populated with sample data derived from the schema's properties +- AND the admin MAY edit the sample data +- AND on submit, the UI MUST call `POST /api/engines/{engineId}/test-hook` and display the result +- AND the dialog MUST clearly indicate this is a dry-run (no data is persisted) + +### Requirement: Execution History Retention + +Workflow execution history records MUST be automatically pruned to prevent unbounded table growth. + +#### Scenario: Background job prunes old records + +- GIVEN a configurable retention period (default 90 days, stored in IAppConfig as `workflow_execution_retention_days`) +- WHEN the `ExecutionHistoryCleanupJob` TimedJob runs (once daily) +- THEN it MUST delete all `WorkflowExecution` records where `executedAt` is older than the retention period +- AND it MUST log the number of deleted records + +#### Scenario: Retention period is configurable + +- GIVEN an admin sets `workflow_execution_retention_days` to 30 via Nextcloud settings +- WHEN the cleanup job runs +- THEN it MUST use the configured 30-day period instead of the default 90 + +#### Scenario: No records to prune + +- GIVEN all execution records are within the retention period +- WHEN the cleanup job runs +- THEN it MUST complete without error +- AND MUST NOT delete any records From eae922efa029898f1e1c40027981a6b534225249 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 10:58:37 +0200 Subject: [PATCH 049/333] chore(spec-collect): bring in 1 spec.md files from feature/1554/notificatie-engine --- .../specs/rbac-scopes/spec.md | 155 ++++++++++++++++++ 1 file changed, 155 insertions(+) create mode 100644 openspec/changes/rbac-disable-public-inheritance/specs/rbac-scopes/spec.md diff --git a/openspec/changes/rbac-disable-public-inheritance/specs/rbac-scopes/spec.md b/openspec/changes/rbac-disable-public-inheritance/specs/rbac-scopes/spec.md new file mode 100644 index 000000000000..ffc2a93b1602 --- /dev/null +++ b/openspec/changes/rbac-disable-public-inheritance/specs/rbac-scopes/spec.md @@ -0,0 +1,155 @@ +--- +status: draft +--- + +# RBAC Scopes — Delta for Disable-Public-Inheritance Flag + +This delta extends the existing `rbac-scopes` capability with an opt-out flag for the "logged-in users inherit `public` group rights" semantics. Adds an `inheritFromPublic` boolean (default `true`) at the authorization-block level of schemas and registers, plus a tenant-wide IAppConfig default. When `false`, authenticated users do NOT qualify for `public` rules; they qualify only via their own group memberships. + +## ADDED Requirements + +### Requirement: Schema and register authorization MUST accept an optional `inheritFromPublic` boolean + +Schema and register authorization blocks MUST accept an optional `inheritFromPublic` field, boolean. The default value (when the field is absent or `null`) MUST be resolved via the cascade documented below. Existing schemas and registers that do not set the field MUST behave identically to before this change (default `true`). + +#### Scenario: Schema authorization without inheritFromPublic preserves pre-change behaviour + +- **GIVEN** a schema whose authorization block has no `inheritFromPublic` field +- **AND** the register's authorization block also has no `inheritFromPublic` field +- **AND** the tenant default IAppConfig key is unset +- **WHEN** RBAC checks run +- **THEN** the effective `inheritFromPublic` value is `true` (the pre-change behaviour) +- **AND** authenticated users qualify for `public` rules as they did before + +#### Scenario: Schema sets inheritFromPublic explicitly + +- **GIVEN** a schema whose authorization block contains `"inheritFromPublic": false` +- **WHEN** RBAC checks run +- **THEN** the effective value is `false` for that schema +- **AND** authenticated users do NOT qualify for `public` rules on that schema + +#### Scenario: Schema authorization round-trip preserves the field + +- **GIVEN** a schema saved with `"inheritFromPublic": false` in its authorization block +- **WHEN** the schema is fetched and re-serialised via `Schema::getAuthorization()` +- **THEN** the returned array contains `inheritFromPublic` with value `false` +- **AND** the JSON serialisation includes the field + +### Requirement: The effective value of `inheritFromPublic` MUST be resolved via cascade + +The cascade order MUST be: schema's authorization → register's authorization → tenant-wide `IAppConfig` key `openregister.rbac.inherit_from_public_default` → hard-coded `true`. The first explicitly-set value wins. `null` MUST be treated as "unset" (cascade falls through to the next level). + +#### Scenario: Cascade falls back to register when schema has no value + +- **GIVEN** a schema whose authorization has NO `inheritFromPublic` field +- **AND** the parent register's authorization has `"inheritFromPublic": false` +- **WHEN** the resolver is called for that schema +- **THEN** the resolved value is `false` + +#### Scenario: Cascade falls back to tenant default when neither schema nor register sets it + +- **GIVEN** schema and register without the field +- **AND** IAppConfig `openregister.rbac.inherit_from_public_default` is set to `false` +- **WHEN** the resolver is called +- **THEN** the resolved value is `false` + +#### Scenario: Cascade falls back to hard-coded true when nothing is set + +- **GIVEN** no schema, register, or tenant default is set +- **WHEN** the resolver is called +- **THEN** the resolved value is `true` + +#### Scenario: Schema explicit value wins over register and tenant + +- **GIVEN** schema sets `"inheritFromPublic": true` +- **AND** register sets `"inheritFromPublic": false` +- **AND** tenant default is `false` +- **WHEN** the resolver is called +- **THEN** the resolved value is `true` (schema wins) + +#### Scenario: null is treated as "unset" + +- **GIVEN** schema authorization contains `"inheritFromPublic": null` +- **AND** register sets `"inheritFromPublic": false` +- **WHEN** the resolver is called +- **THEN** the cascade continues past the schema; the resolved value is `false` (from register) + +### Requirement: When `inheritFromPublic` is `false`, authenticated users MUST NOT qualify for `public` rules + +When the resolved `inheritFromPublic` is `false`, the PHP-side `PermissionHandler::hasPermission` MUST NOT fall back to `hasGroupPermission(public, ...)` for authenticated users; it MUST return only the result of evaluating the user's own group memberships (plus owner / admin checks). Anonymous users see no behaviour change — the public-fallback path was never used for them in the first place. + +The SQL-side filter (`MagicRbacHandler::applyRbacFilters` and `buildRbacConditionsSql`) MUST equivalently exclude `public`-grouped rules from contributing conditions for authenticated users. The simple-string `'public'` rule MUST NOT grant unconditional access to authenticated users when the flag is `false`. Conditional `{group: "public", match: ...}` rules MUST NOT add their match conditions to the WHERE clause for authenticated users when the flag is `false`. + +#### Scenario: Authenticated user is denied when inheritance is off and only public has access + +- **GIVEN** a schema with `inheritFromPublic: false` and authorization `read: [{group: "public", match: }]` +- **AND** an authenticated user `alice` not a member of any group named in any rule +- **AND** an object that satisfies the public match +- **WHEN** alice attempts to read the object +- **THEN** access is denied +- **AND** the SQL filter excludes the object from listings for alice + +#### Scenario: Anonymous user is granted when public match passes (regardless of flag) + +- **GIVEN** the same schema as above +- **WHEN** an anonymous (unauthenticated) request reads the object +- **THEN** access is granted (the public match is satisfied) +- **AND** the SQL filter includes the object + +#### Scenario: Authenticated user with explicit group membership is still granted + +- **GIVEN** a schema with `inheritFromPublic: false` and authorization `read: [{group: "public", match: ...}, "editors"]` +- **AND** an authenticated user `bob` in the `editors` group +- **WHEN** bob attempts to read the object +- **THEN** access is granted (via the explicit `editors` rule) +- **AND** the SQL filter includes the object for bob + +#### Scenario: Owner check is unaffected by the flag + +- **GIVEN** a schema with `inheritFromPublic: false` and `read: [{group: "public", match: ...}]` +- **AND** an authenticated user `carol` who is the owner of an object +- **WHEN** carol attempts to read the object +- **THEN** access is granted via the owner shortcut, regardless of the flag + +#### Scenario: Admin user is unaffected by the flag + +- **GIVEN** a schema with `inheritFromPublic: false` +- **AND** an authenticated user in the `admin` group +- **WHEN** the admin reads any object on this schema +- **THEN** access is granted via the admin bypass, regardless of the flag + +### Requirement: When `inheritFromPublic` is `true` (or unset), behaviour MUST be identical to before this change + +For any schema, register, or tenant where the resolved `inheritFromPublic` is `true` (the default), authenticated users MUST continue to qualify for `public` rules exactly as they did before this change. The new code paths MUST NOT introduce any behavioural drift for schemas that don't opt out. + +#### Scenario: Pre-change schema is unaffected + +- **GIVEN** a schema with no `inheritFromPublic` field anywhere in its cascade +- **AND** an authenticated user +- **AND** an object satisfying a public match rule +- **WHEN** the user attempts to read the object +- **THEN** access is granted +- **AND** the result is identical to pre-change behaviour + +### Requirement: The simple-string `'authenticated'` rule MUST be unaffected by the flag + +The existing `'authenticated'` simple-rule string (recognised by `MagicRbacHandler::processSimpleRule` line 274-276) grants unconditional access to any logged-in user. This behaviour MUST be unchanged by `inheritFromPublic`. The flag concerns the `public` group only. + +#### Scenario: 'authenticated' rule still grants access when public inheritance is disabled + +- **GIVEN** a schema with `inheritFromPublic: false` and `read: ["authenticated"]` +- **AND** an authenticated user +- **WHEN** the user attempts to read +- **THEN** access is granted (via the `authenticated` rule, independent of the flag) + +### Requirement: PHP-side and SQL-side enforcement MUST be identical + +For any combination of (user state, flag value, authorization rules, object data), the result of `PermissionHandler::hasPermission` (per-object check) MUST agree with whether the SQL filter (`MagicRbacHandler::applyRbacFilters`) would include the object in a listing. The two layers MUST NOT diverge. + +#### Scenario: Per-object check and listing filter agree across the four-state matrix + +- **GIVEN** a schema with `read: [{group: "public", match: }]` +- **AND** the four states: (anon, authenticated) × (inheritFromPublic true, false) +- **AND** an object satisfying the public match +- **WHEN** the per-object `hasPermission` check runs AND the listing endpoint runs +- **THEN** for each of the four states, the per-object check's boolean result matches the listing's include/exclude decision for that object From e4162eb19324a56b74cac5e2694050f4db2dc429 Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 10:58:37 +0200 Subject: [PATCH 050/333] chore(spec-collect): bring in 7 spec.md files from feature/linked-entity-types --- .../specs/unit-test-coverage/spec.md | 116 ++++ openspec/specs/api-test-coverage/spec.md | 312 ++++++++++ openspec/specs/besluiten-management/spec.md | 151 +++++ openspec/specs/geo-metadata-kaart/spec.md | 167 +++++ openspec/specs/oas-validation/spec.md | 123 ++++ openspec/specs/rbac-zaaktype/spec.md | 117 ++++ openspec/specs/unit-test-coverage/spec.md | 582 ++++++++++++++++++ 7 files changed, 1568 insertions(+) create mode 100644 openspec/changes/unit-test-coverage-phase2/specs/unit-test-coverage/spec.md create mode 100644 openspec/specs/api-test-coverage/spec.md create mode 100644 openspec/specs/besluiten-management/spec.md create mode 100644 openspec/specs/geo-metadata-kaart/spec.md create mode 100644 openspec/specs/oas-validation/spec.md create mode 100644 openspec/specs/rbac-zaaktype/spec.md create mode 100644 openspec/specs/unit-test-coverage/spec.md diff --git a/openspec/changes/unit-test-coverage-phase2/specs/unit-test-coverage/spec.md b/openspec/changes/unit-test-coverage-phase2/specs/unit-test-coverage/spec.md new file mode 100644 index 000000000000..9b5a800c0918 --- /dev/null +++ b/openspec/changes/unit-test-coverage-phase2/specs/unit-test-coverage/spec.md @@ -0,0 +1,116 @@ +# Spec Reference: Unit Test Coverage + +This change implements Phase 2 of the `unit-test-coverage` spec. + +See: `openregister/openspec/specs/unit-test-coverage/spec.md` + +## Source File Inventory (2026-03-16) + +Total source files in `lib/`: **492** +Total test files in `tests/Unit/`: **310** + +### By category: + +| Category | Source Files | Test Files | Status | +|---|---|---|---| +| Event | 39 | 5 | Complete (DataProvider grouping) | +| Exception | 10 | 2 | Partial | +| Formats | 2 | 1 | Partial | +| Db root (entities+mappers) | 55 | 31 | Partial (excluded from coverage) | +| Db/MagicMapper | 5 | 0 | Not started (excluded from coverage) | +| Db/ObjectHandlers | 5 | 0 | Not started (excluded from coverage) | +| Controller root | 46 | 78 | Complete (multiple test files per controller) | +| Controller/Settings | 12 | (included above) | Complete | +| Service root | 43 | 147 total | Mostly complete | +| Service/Chat | 5 | (included above) | Needs verification | +| Service/Configuration | 8 | (included above) | Needs verification | +| Service/File | 13 | (included above) | Needs verification | +| Service/GraphQL | 12 | 0 | Not in original plan | +| Service/Handler | 5 | (included above) | Needs verification | +| Service/Index | 23 | (included above) | Needs verification | +| Service/Mcp | 3 | (included above) | Needs verification | +| Service/Object | 39 | (included above) | Needs verification | +| Service/Schemas | 3 | (included above) | Needs verification | +| Service/Settings | 8 | (included above) | Needs verification | +| Service/TextExtraction | 4 | (included above) | Needs verification | +| Service/Vectorization | 8 | (included above) | Needs verification | +| Service/Webhook | 1 | (included above) | Needs verification | +| BackgroundJob | 10 | 8 | Mostly complete | +| Command | 3 | 4 | Complete | +| Cron | 4 | 4 | Complete | +| Listener | 8 | 7 | Mostly complete | +| Tools | 0 | 0 | Removed from codebase | +| Notification | 1 | (in "Other") | Likely covered | +| Repair | 1 | (in "Other") | Likely covered | +| Search | 1 | (in "Other") | Likely covered | +| Sections | 1 | (in "Other") | Likely covered | +| Settings | 1 | (in "Other") | Likely covered | +| Migration | 91 | 0 | Excluded from coverage | +| AppInfo | 1 | 0 | Excluded from coverage | + +## Concrete Test Pattern Examples + +### Event DataProvider Pattern (from SimpleCrudEventsTest) +```php +public static function singleEntityEventProvider(): array { + return [ + 'AgentCreatedEvent' => [AgentCreatedEvent::class, Agent::class, 'getAgent'], + 'AgentDeletedEvent' => [AgentDeletedEvent::class, Agent::class, 'getAgent'], + // ... 18 more entries + ]; +} + +#[DataProvider('singleEntityEventProvider')] +public function testSingleEntityConstructAndGet(string $eventClass, string $entityClass, string $getter): void { + $entity = new $entityClass(); + $event = new $eventClass($entity); + $this->assertSame($entity, $event->$getter()); +} +``` + +### Entity Test Pattern (from RegisterTest) +```php +// Constructor defaults +public function testConstructorDefaultValues(): void { + $this->assertNull($this->register->getUuid()); + $this->assertSame([], $this->register->getSchemas()); +} + +// Reflection for private $id +$reflection = new \ReflectionProperty($this->register, 'id'); +$reflection->setAccessible(true); +$reflection->setValue($this->register, 42); + +// JSON serialization with date formatting +$json = $this->register->jsonSerialize(); +$this->assertSame($created->format('c'), $json['created']); +``` + +### Service Mock Pattern (from SearchTrailServiceTest) +```php +protected function setUp(): void { + $this->searchTrailMapper = $this->createMock(SearchTrailMapper::class); + $this->service = new SearchTrailService($this->searchTrailMapper, ...); +} + +public function testCreateSearchTrailThrowsOnMapperException(): void { + $this->searchTrailMapper->method('createSearchTrail') + ->willThrowException(new Exception('DB error')); + $this->expectException(Exception::class); + $this->expectExceptionMessage('Search trail creation failed: DB error'); + $this->service->createSearchTrail([], 0, 0); +} +``` + +### Controller Mock Pattern (from TagsControllerTest) +```php +private TagsController $controller; +private IRequest&MockObject $request; // PHPUnit 10 intersection type +private ObjectService&MockObject $objectService; + +protected function setUp(): void { + $this->request = $this->createMock(IRequest::class); + $this->objectService = $this->createMock(ObjectService::class); + $this->controller = new TagsController('openregister', $this->request, $this->objectService, ...); +} +``` diff --git a/openspec/specs/api-test-coverage/spec.md b/openspec/specs/api-test-coverage/spec.md new file mode 100644 index 000000000000..36ab25ee6c59 --- /dev/null +++ b/openspec/specs/api-test-coverage/spec.md @@ -0,0 +1,312 @@ +--- +status: draft +--- + +# API Integration Test Coverage to 100% + +Achieve 100% API route coverage with Newman integration tests and measure server-side code coverage from those tests using PCOV. Every API route defined in `appinfo/routes.php` SHALL have at least one Newman test covering the success path and one covering the error path. + +## Current State + +- **376 API routes** defined in `appinfo/routes.php` +- **71 Newman requests** in the existing Postman collection +- **18.9% route coverage** — only CRUD operations on core resources are tested +- **0% code coverage measurement** from integration tests — PCOV is not configured for API requests +- Existing collections: `openregister-crud.postman_collection.json`, `openregister-referential-integrity.postman_collection.json`, `magic-mapper-import.postman_collection.json` +- CI runs Newman against 4 database/storage combinations (PostgreSQL/MySQL x Normal/MagicMapper) + +## Code Coverage from Integration Tests + +### Requirement: PCOV coverage collection during Newman tests + +Integration tests exercise the full stack — from HTTP request through controller, service, mapper, and back. By enabling PCOV during Newman test runs, every PHP line executed during API requests gets recorded. + +#### Scenario: PCOV prepend script collects coverage per request + +- **GIVEN** a PHP prepend script that starts PCOV coverage collection +- **AND** a shutdown function that writes the coverage data to a `.cov` file +- **WHEN** Newman sends API requests to the Nextcloud instance +- **THEN** each request generates a coverage file in a designated directory +- **AND** after the test run completes, `phpcov merge` combines all `.cov` files into a single `clover.xml` + +**Implementation:** + +```php +// tests/integration/coverage-prepend.php +mockDependency = $this->createMock(SomeDependency::class); + $this->mockLogger = $this->createMock(LoggerInterface::class); + $this->service = new ExampleService( + $this->mockDependency, + $this->mockLogger, + ); + } +} +``` + +### Requirement: Test all code paths, not just the happy flow + +Every public method with branching logic (if/else, switch, try/catch, early returns, null checks) SHALL have tests for each branch. Coverage means every line is executed, so each conditional path needs its own test scenario. + +**What "all paths" means per method:** + +- **If/else branches**: Separate test for each branch condition +- **Early returns**: Test the condition that triggers the early return AND the condition that continues +- **Try/catch blocks**: Test both the success path and the exception path (using `willThrowException()` on mocks) +- **Null coalescing / optional params**: Test with value present AND with null/missing value +- **Loops**: Test with empty collection, single item, and multiple items +- **Switch/match**: Test each case and the default + +**Established pattern** (from `ConfigurationServiceTest`): +```php +// Test multiple branches of the same method +public function testHasUpdateAvailable(): void { + $config = new Configuration(); + + // Branch 1: No remote version → false + $config->setLocalVersion('1.0.0'); + $config->setRemoteVersion(null); + $this->assertFalse($config->hasUpdateAvailable()); + + // Branch 2: Same version → false + $config->setRemoteVersion('1.0.0'); + $this->assertFalse($config->hasUpdateAvailable()); + + // Branch 3: Newer remote → true + $config->setRemoteVersion('1.1.0'); + $this->assertTrue($config->hasUpdateAvailable()); +} +``` + +### Requirement: Use data providers for parameterized scenarios + +When a method accepts variable input and the test logic is the same but values differ, use `#[DataProvider]` attributes with named test cases. This avoids duplicated test methods and makes failures descriptive. + +**Established pattern** (from `MagicMapperTest`): +```php +#[DataProvider('registerSchemaTableNameProvider')] +public function testGetTableNameForRegisterSchema( + int $registerId, int $schemaId, string $expected +): void { + $result = $this->magicMapper->getTableName($registerId, $schemaId); + $this->assertEquals($expected, $result); +} + +public static function registerSchemaTableNameProvider(): array { + return [ + 'basic_combination' => [1, 1, 'oc_openregister_table_1_1'], + 'different_ids' => [5, 12, 'oc_openregister_table_5_12'], + 'zero_ids' => [0, 0, 'oc_openregister_table_0_0'], + ]; +} +``` + +### Requirement: Verify side effects with mock expectations + +Tests SHALL verify not just return values but also that the correct service/mapper methods are called with the correct arguments. Use `expects()`, `with()`, and `willReturn()` / `willThrowException()` chains. + +**Key expectation patterns** (from `FileTextExtractionJobTest`, `SettingsControllerTest`): + +- `expects($this->once())` — method must be called exactly once +- `expects($this->never())` — method must NOT be called (for skip/error paths) +- `expects($this->atLeastOnce())` — called one or more times +- `->with($this->equalTo($value))` — verify arguments +- `->with($this->stringContains('partial'))` — partial argument matching +- `->with($this->callback(fn($ctx) => $ctx['key'] === 'val'))` — complex argument assertions +- `->willThrowException(new \Exception('msg'))` — simulate failures +- `->willReturnCallback(function($arg) { ... })` — dynamic return values + +### Requirement: Use real Entity instances, never mock Nextcloud entities + +Nextcloud Entity classes use `__call` magic for getters/setters. PHPUnit 10+ cannot properly mock `__call`-based methods. All tests SHALL use real entity instances with setters instead of mocking entities. + +**Critical rule:** NEVER use named arguments on Entity setters — `__call` passes `['name' => val]` but Entity's `setter()` uses `$args[0]`. + +```php +// CORRECT — real instance with positional args +$schema = new Schema(); +$schema->setTitle('Test Schema'); +$schema->setProperties(json_encode([['title' => 'name', 'type' => 'string']])); + +// WRONG — mock (breaks __call magic) +$schema = $this->createMock(Schema::class); +$schema->method('getTitle')->willReturn('Test Schema'); + +// WRONG — named arg (breaks __call) +$schema->setTitle(title: 'Test Schema'); +``` + +**For entities that need method overrides** (e.g., to control `hasPropertyAuthorization`), use a Testable subclass: + +```php +class TestableSchema extends Schema { + private bool $hasAuth = true; + public function setHasPropertyAuthorization(bool $v): void { $this->hasAuth = $v; } + public function hasPropertyAuthorization(string $p): bool { return $this->hasAuth; } +} +``` + +### Requirement: Use real ArrayLoader instances (final class) + +`Twig\Loader\ArrayLoader` is declared `final` and cannot be mocked. Tests that need a Twig loader SHALL use a real `ArrayLoader` instance. + +### Requirement: No named parameters on PHPUnit API calls + +PHPUnit 10+ marks all API methods with `@no-named-arguments`. Tests SHALL use positional parameters only on all PHPUnit method calls (`expects`, `method`, `willReturn`, `with`, `assertSame`, `assertEquals`, etc.). + +```php +// CORRECT +$mock->expects($this->once())->method('save')->willReturn($entity); +$this->assertSame('expected', $result); + +// WRONG — named parameters +$mock->expects(constraint: $this->once()); +$this->assertSame(expected: 'expected', actual: $result); +``` + +### Requirement: Use Reflection for private methods when necessary + +When a public method delegates to private helpers that contain complex logic worth testing individually, use `ReflectionClass` to access them. + +**Established pattern** (from `MagicMapperTest`): +```php +$reflection = new \ReflectionClass($this->service); +$method = $reflection->getMethod('privateMethodName'); +$method->setAccessible(true); +$result = $method->invoke($this->service, $arg1, $arg2); +``` + +### Requirement: Test naming convention + +Test methods SHALL follow `test[MethodOrBehavior][Scenario]` naming: +- `testCreateOrganisationWithValidData` — happy path +- `testCreateOrganisationWithEmptyName` — validation failure +- `testCreateOrganisationWhenMapperThrows` — exception handling +- `testDeleteOrganisationAsLastMember` — edge case + +## Phase 1: Fix Broken Existing Tests (COMPLETE) + +All 316 test failures have been resolved. **1,121 tests now pass with 0 errors, 0 failures.** The fixes fell into 4 categories. + +### Requirement: Fix OrganisationService constructor mismatch (245 errors) + +Four test files instantiate `OrganisationService` with the wrong number/type of constructor arguments. The constructor expects 9 parameters but tests pass 3-4. + +**Constructor signature** (`lib/Service/OrganisationService.php`): +```php +__construct( + OrganisationMapper $organisationMapper, + IUserSession $userSession, + ISession $session, + IConfig $config, + IAppConfig $appConfig, + IGroupManager $groupManager, + IUserManager $userManager, + LoggerInterface $logger, + ?SettingsService $settingsService = null +) +``` + +**Affected files:** +- `tests/Unit/Service/OrganisationCrudTest.php` (11 errors) +- `tests/Unit/Service/PerformanceScalabilityTest.php` (6 errors) +- `tests/Unit/Service/SessionCacheManagementTest.php` (4 errors) +- `tests/Unit/Service/UserOrganisationRelationshipTest.php` (10 errors) +- Plus ~214 errors in other Organisation-related test files + +#### Scenario: Tests create OrganisationService with correct mocks + +- **WHEN** each affected test file's `setUp()` method creates an `OrganisationService` +- **THEN** it SHALL mock and pass all 9 constructor parameters in the correct order and with correct types +- **AND** all OrganisationService-related tests SHALL pass without TypeError + +### Requirement: Fix missing class references (41 errors) + +Tests mock classes that no longer exist in the codebase due to refactoring. + +#### Scenario: Update GuzzleSolrService reference (32 errors) + +- **GIVEN** `SettingsServiceTest.php` mocks `OCA\OpenRegister\Service\GuzzleSolrService` which does not exist +- **WHEN** the test setUp creates service mocks +- **THEN** it SHALL use the current class name (likely `IndexService` or `SolrBackend`) or remove the mock if the dependency was eliminated +- **AND** the `SettingsService` constructor signature SHALL be checked and all mocks SHALL match it exactly + +#### Scenario: Update PublishObject reference (8 errors) + +- **GIVEN** `ObjectServiceRefactoredMethodsTest.php` mocks `OCA\OpenRegister\Service\Object\PublishObject` which does not exist +- **WHEN** the test setUp creates service mocks +- **THEN** it SHALL use `PublishHandler` (the current class name) or whichever class replaced it +- **AND** the `ObjectService` constructor signature SHALL be verified and all mocks SHALL match + +#### Scenario: Fix VectorEmbeddingServiceTest base class (1 error) + +- **GIVEN** `VectorEmbeddingServiceTest.php` extends `Test\TestCase` (Nextcloud integration base) +- **WHEN** this test runs in the unit test suite (which has no Nextcloud autoloader) +- **THEN** it SHALL extend `PHPUnit\Framework\TestCase` instead, with all dependencies mocked + +### Requirement: Fix SemVer format validation (2 failures) + +#### Scenario: Valid semver versions are accepted + +- **GIVEN** the `SemVerFormat` validator in `lib/Formats/SemVerFormat.php` +- **WHEN** validating standard versions like `"1.0.0"` and `"0.0.0"` +- **THEN** they SHALL be marked as valid +- **AND** the regex/validation logic SHALL be corrected to match the SemVer 2.0.0 specification + +#### Scenario: Invalid semver versions are rejected + +- **WHEN** validating strings like `"1.0"`, `"v1.0.0"`, `"1.0.0.0"`, `"abc"`, `""` +- **THEN** they SHALL be marked as invalid + +## Phase 2: Test Untested Source Directories + +After Phase 1, coverage will still be low because most source directories have zero test files. Tests SHALL be added for all directories below. Every test SHALL cover all code paths in the class under test. + +### Requirement: Test Db entities and mappers (69 files) + +Unit tests SHALL cover all entity classes and their mapper classes. Entities follow a predictable pattern (getters, setters, `jsonSerialize()`) but many contain conditional logic, type coercion, or computed properties that need branch coverage. + +#### Scenario: Entity getters and setters — all types and edge cases + +- **GIVEN** any Db entity class (e.g., `Register`, `Schema`, `ObjectEntity`) +- **WHEN** setters are called with valid data, null values, empty strings, and boundary values +- **THEN** the corresponding getters SHALL return the expected values for each case +- **AND** type coercion behavior SHALL be tested (e.g., string to DateTime, JSON string to array) + +#### Scenario: Entity JSON serialization — complete and partial data + +- **GIVEN** an entity with all fields populated +- **WHEN** `jsonSerialize()` is called +- **THEN** all fields SHALL appear in the returned array with correct types +- **AND** when optional fields are null, they SHALL serialize as null or be omitted per the entity's logic + +#### Scenario: Entity default values and construction + +- **GIVEN** an entity class +- **WHEN** constructed with no arguments +- **THEN** all default values SHALL be set correctly +- **AND** `getId()` SHALL return null for new (unsaved) entities + +#### Scenario: MagicMapper handlers — query building branches + +- **GIVEN** `MagicMapper` handlers (`MagicBulkHandler`, `MagicFacetHandler`, `MagicOrganizationHandler`, `MagicRbacHandler`, `MagicSearchHandler`) +- **WHEN** query building methods are called with different filter combinations, empty filters, invalid filters, and combinations of search + facet + RBAC +- **THEN** they SHALL produce correct SQL fragments and parameter bindings for each combination +- **AND** edge cases (no filters, all filters, unknown filter keys) SHALL be handled + +#### Scenario: ObjectEntity handlers — all operation modes + +- **GIVEN** `ObjectEntity` handler classes (`BulkOperationsHandler`, `CrudHandler`, `FacetsHandler`, `LockingHandler`, `QueryBuilderHandler`, `QueryOptimizationHandler`, `StatisticsHandler`) +- **WHEN** their public methods are called with mocked dependencies +- **THEN** each branching path (e.g., locked vs unlocked, cached vs uncached, found vs not found) SHALL be tested + +### Requirement: Test Event classes (39 files) + +#### Scenario: Event construction and data access + +- **GIVEN** any event class (e.g., `ObjectCreatedEvent`, `SchemaUpdatedEvent`, `RegisterDeletedEvent`) +- **WHEN** constructed with an entity +- **THEN** the entity SHALL be retrievable via getter methods +- **AND** the event SHALL be an instance of `\OCP\EventDispatcher\Event` + +#### Scenario: Event classes grouped by CRUD pattern + +- **GIVEN** most events follow a Created/Updated/Deleted pattern per entity type +- **WHEN** testing these events +- **THEN** use a `#[DataProvider]` to test all variants of the same entity's events in a single test class (e.g., `RegisterEventsTest` covers `RegisterCreatedEvent`, `RegisterUpdatedEvent`, `RegisterDeletedEvent`) + +### Requirement: Test Controller classes (51 files, 48 untested) + +Tests exist for `ConfigurationController`, `FilesController`, and `SettingsController`. The remaining 48 controllers need tests. + +#### Scenario: Controller CRUD actions — success path + +- **GIVEN** any API controller (e.g., `ObjectsController`, `RegistersController`, `SchemasController`) +- **WHEN** `index()`, `show()`, `create()`, `update()`, or `destroy()` is called with valid input +- **THEN** it SHALL return a `JSONResponse` with HTTP 200/201 and the expected data structure +- **AND** the service layer SHALL be called with the correct arguments (verified via `expects($this->once())`) + +#### Scenario: Controller error handling — service throws exception + +- **GIVEN** a controller action +- **WHEN** the underlying service throws `\Exception`, `ValidationException`, `NotAuthorizedException`, or `NotFoundException` +- **THEN** the controller SHALL return a `JSONResponse` with the appropriate error status (400, 403, 404, 500) +- **AND** the error response SHALL contain a descriptive message +- **AND** the error SHALL be logged (verified via logger mock) + +#### Scenario: Controller input validation — missing or invalid parameters + +- **GIVEN** a controller action that expects specific request parameters +- **WHEN** called with missing required params, wrong types, or empty values +- **THEN** it SHALL return a validation error response (400) + +#### Scenario: Controller authorization checks + +- **GIVEN** a controller with RBAC or organisation-scoped access +- **WHEN** called by an unauthorized user (mocked via `IUserSession`) +- **THEN** it SHALL return 403 Forbidden + +### Requirement: Test Service classes (~130 untested files) + +Service classes contain the bulk of the business logic and branching. Each service handler SHALL have tests for every public method and every branch within those methods. + +#### Scenario: Service handlers — success, failure, and edge cases + +- **GIVEN** any service handler (e.g., `CrudHandler`, `CacheHandler`, `AuditHandler`) +- **WHEN** public methods are called with mocked mappers and dependencies +- **THEN** tests SHALL cover: + - The happy path with valid input + - What happens when a mapper throws `DoesNotExistException` (not found) + - What happens when a mapper throws `MultipleObjectsReturnedException` + - What happens with empty/null input + - What happens with malformed input + - Each if/else and switch branch in the method + +#### Scenario: Object service — save, get, delete, validate paths + +- **GIVEN** `SaveObject`, `GetObject`, `DeleteObject`, `ValidateObject` and their sub-handlers +- **WHEN** operations are performed +- **THEN** each handler SHALL be tested for: + - New object creation vs update of existing object + - With and without file properties + - With and without relations/cascading + - Validation success and validation failure (each validation rule) + - Lock check (locked vs unlocked object) + - Permission check (authorized vs unauthorized) + +#### Scenario: Index backends — Solr and Elasticsearch branches + +- **GIVEN** search backend classes (`SolrBackend`, `ElasticsearchBackend` and their sub-handlers) +- **WHEN** index/search/facet operations are called +- **THEN** tests SHALL cover: + - Successful indexing and search + - Connection failure / timeout (mock HTTP client to throw) + - Empty search results + - Faceted search with and without facet configuration + - Schema creation and update paths + - Bulk indexing with partial failures + +#### Scenario: File service handlers — all file operation branches + +- **GIVEN** file service handlers (`CreateFileHandler`, `DeleteFileHandler`, `ReadFileHandler`, `UpdateFileHandler`, etc.) +- **WHEN** file operations are requested +- **THEN** tests SHALL cover: + - File found vs file not found + - File owned by user vs shared file vs system file + - Valid file type vs rejected file type + - Folder exists vs folder needs creation + - File with tags vs without tags + +#### Scenario: Configuration service — fetch, import, export branches + +- **GIVEN** `ConfigurationService` and its handlers (`FetchHandler`, `ImportHandler`, `ExportHandler`, `GitHubHandler`, `GitLabHandler`) +- **WHEN** configuration operations are performed +- **THEN** tests SHALL cover: + - Local config vs remote config (GitHub/GitLab) + - Config found vs not found + - Valid config format vs malformed config + - Version comparison (newer, older, same) + - Cache hit vs cache miss + +#### Scenario: Webhook service — delivery and retry paths + +- **GIVEN** `WebhookService` and `CloudEventFormatter` +- **WHEN** webhook delivery is triggered +- **THEN** tests SHALL cover: + - Successful delivery (HTTP 2xx) + - Failed delivery (HTTP 4xx/5xx) + - Connection timeout + - Retry logic (max retries reached vs retries remaining) + - CloudEvents format validation + +#### Scenario: Organisation service — multi-tenancy paths + +- **GIVEN** `OrganisationService` with its membership, caching, and settings logic +- **WHEN** organisation operations are performed +- **THEN** tests SHALL cover: + - User joins organisation, is already member, joins non-existent org + - User leaves organisation, is last member, is not member + - Active organisation set, cleared, cached, cache expired + - Default organisation exists vs doesn't exist + - Multi-tenancy filtering enabled vs disabled + +### Requirement: Test Tool classes (7 files) + +#### Scenario: Tool interface compliance and all process() branches + +- **GIVEN** tool classes (`AgentTool`, `ApplicationTool`, `ObjectsTool`, `RegisterTool`, `SchemaTool`) +- **WHEN** `getName()`, `getDescription()`, `getInputSchema()`, and `process()` are called +- **THEN** they SHALL return valid tool definitions +- **AND** `process()` SHALL be tested with: + - Valid input → delegates to correct service method + - Missing required input → returns error + - Service throws exception → returns error message + - Each action variant (list, get, create, update, delete) if the tool supports multiple actions + +### Requirement: Test remaining directories + +#### Scenario: Exception classes — construction and inheritance (7 files) + +- **GIVEN** custom exception classes (`ValidationException`, `LockedException`, `NotAuthorizedException`, `DatabaseConstraintException`, `RegisterNotFoundException`, `SchemaNotFoundException`, `CustomValidationException`) +- **WHEN** constructed with a message, code, and optional previous exception +- **THEN** they SHALL extend the correct base exception class +- **AND** `getMessage()`, `getCode()`, and `getPrevious()` SHALL return the correct values +- **AND** any custom methods (e.g., `getValidationErrors()` on `ValidationException`) SHALL be tested with data providers for multiple error scenarios + +#### Scenario: Listener classes — handle() with matching and non-matching events (6 files) + +- **GIVEN** event listener classes (`FileChangeListener`, `ObjectChangeListener`, `ObjectCleanupListener`, `CommentsEntityListener`, `ToolRegistrationListener`, `WebhookEventListener`) +- **WHEN** `handle()` is called with a matching event +- **THEN** the correct service methods SHALL be called (verified via mock expectations) +- **AND WHEN** `handle()` is called and the service throws an exception +- **THEN** the listener SHALL handle it gracefully (log error, not re-throw) + +#### Scenario: BackgroundJob classes — run() success and failure paths (7 untested of 8) + +- **GIVEN** background job classes (`CacheWarmupJob`, `NameCacheWarmupJob`, `CronFileTextExtractionJob`, `ObjectTextExtractionJob`, `SolrNightlyWarmupJob`, `SolrWarmupJob`, `WebhookDeliveryJob`) +- **WHEN** `run()` is called with valid job arguments +- **THEN** the correct service SHALL be called +- **AND WHEN** `run()` is called with missing arguments +- **THEN** the job SHALL log a warning and return without error +- **AND WHEN** the underlying service throws an exception +- **THEN** the job SHALL catch it and log the error (verified via `$this->mockLogger->expects($this->once())->method('error')`) + +#### Scenario: Command classes — execute() with valid and invalid input (3 files) + +- **GIVEN** CLI command classes (`MigrateStorageCommand`, `SolrDebugCommand`, `SolrManagementCommand`) +- **WHEN** `execute()` is called with mocked `InputInterface` and `OutputInterface` +- **THEN** tests SHALL cover: + - Valid arguments → service called, success message output + - Missing arguments → error message output, non-zero return code + - Service exception → error output, non-zero return code + +#### Scenario: Cron job classes — run() and error handling (4 files) + +- **GIVEN** cron classes (`ConfigurationCheckJob`, `LogCleanUpTask`, `SyncConfigurationsJob`, `WebhookRetryJob`) +- **WHEN** `run()` is called +- **THEN** the correct service method SHALL be called +- **AND** exception handling SHALL be tested (service failure → logged, not re-thrown) + +#### Scenario: Notification, Repair, Search, Settings, Sections (5 files) + +- **GIVEN** `Notifier`, `RegisterRiskLevelMetadata`, `ObjectsProvider`, `OpenRegisterAdmin` (settings + sections) +- **WHEN** their public interface methods are called +- **THEN** they SHALL return correctly typed results +- **AND** each conditional branch within these classes SHALL be covered (e.g., `Notifier` with known vs unknown notification type, `ObjectsProvider` with results vs no results) + +### Requirement: Test Formats classes (2 files) + +#### Scenario: BsnFormat validation — all branches + +- **GIVEN** the `BsnFormat` validator +- **WHEN** validating BSN numbers +- **THEN** tests SHALL cover (via data provider): + - Valid 9-digit BSN with correct checksum + - Invalid checksum + - Wrong length (too short, too long) + - Non-numeric input + - Null/empty input + +#### Scenario: SemVerFormat validation — all branches + +- **GIVEN** the `SemVerFormat` validator +- **WHEN** validating version strings +- **THEN** tests SHALL cover (via data provider): + - Valid versions: `"1.0.0"`, `"0.0.0"`, `"1.2.3-alpha"`, `"1.2.3+build"` + - Invalid versions: `"1.0"`, `"v1.0.0"`, `"1.0.0.0"`, `""`, `null` + +## Phase 3: Coverage Enforcement + +### Requirement: Raise coverage threshold to 100% + +#### Scenario: CI enforces 100% line coverage + +- **GIVEN** all tests pass and cover all source files +- **WHEN** `composer test:coverage` is run +- **THEN** the clover report SHALL show 100% line coverage +- **AND** `composer coverage:check` threshold SHALL be updated from 75% to 100% + +## Estimated Scope + +| Category | Files to Test | Est. Test Files Needed | +|----------|--------------|----------------------| +| Fix broken tests | — | 0 (fix existing 6 files) | +| Db entities + mappers | 69 | ~25 | +| Events | 39 | ~5 (grouped by CRUD pattern) | +| Controllers | 48 | ~20 | +| Services | ~130 | ~50 | +| Tools | 7 | ~3 | +| Exceptions | 7 | 1 | +| Listeners | 6 | ~3 | +| BackgroundJobs | 7 | ~4 | +| Commands | 3 | ~2 | +| Cron | 4 | ~2 | +| Formats | 2 | 1 (exists, needs fixes) | +| Other (Notif, Repair, etc.) | 5 | ~3 | +| **Total** | **~330 new** | **~118 new test files** | + +### Current Implementation Status + +**Phase 1 is COMPLETE. Phase 2 is in progress.** + +- **1,121 tests pass** with 0 errors, 0 failures +- **~30 test files** exist across `tests/Unit/` covering: BackgroundJob, Command, Controller, Cron, Db, Dto, Event, EventListener, Exception, Formats, Listener, Notification, Repair, Search, Sections, Service, Settings, Tool, Twig +- Coverage threshold is currently set at 75% (`composer coverage:check`) +- Phase 2 (writing ~118 new test files for ~330 untested source files) has not been completed + +**Existing test directories:** +- `tests/Unit/BackgroundJob/` -- FileTextExtractionJobTest +- `tests/Unit/Controller/` -- ConfigurationController, FilesController, SettingsController tests +- `tests/Unit/Db/` -- MagicMapperTest and entity tests +- `tests/Unit/Service/` -- Various service tests (OrganisationService, ConfigurationService, etc.) +- `tests/Unit/Formats/` -- BSN and SemVer format tests +- `tests/Unit/Event/` -- Event class tests +- `tests/Unit/Exception/` -- Exception class tests +- `tests/Unit/Tool/` -- Tool class tests + +**What is NOT yet implemented:** +- ~118 new test files for Phase 2 (bulk of untested service handlers, controllers, mappers) +- 100% line coverage target (Phase 3) +- CI enforcement at 100% threshold + +### Standards & References +- PHPUnit 10+ testing framework (https://phpunit.de/) +- PHP PCOV extension for code coverage +- Nextcloud app testing guidelines +- PSR-4 autoloading for test namespaces + +### Specificity Assessment +- **Specific enough to implement?** Yes -- this is one of the most detailed specs, with explicit patterns, naming conventions, and file-by-file scope. +- **Missing/ambiguous:** Nothing significant -- the spec is comprehensive. +- **Open questions:** + - Should integration tests (requiring database/Nextcloud container) be counted toward the 100% target? + - What is the timeline for Phase 2 completion? From 3e4c74fadf52006e1bb13842b92c636876dd8afe Mon Sep 17 00:00:00 2001 From: Ruben van der Linde Date: Sun, 24 May 2026 10:58:38 +0200 Subject: [PATCH 051/333] chore(spec-collect): bring in 1 spec.md files from feat/nextcloud-integrations --- .../specs/files-sidebar-tabs/spec.md | 251 ++++++++++++++++++ 1 file changed, 251 insertions(+) create mode 100644 openspec/changes/files-sidebar-tabs/specs/files-sidebar-tabs/spec.md diff --git a/openspec/changes/files-sidebar-tabs/specs/files-sidebar-tabs/spec.md b/openspec/changes/files-sidebar-tabs/specs/files-sidebar-tabs/spec.md new file mode 100644 index 000000000000..58090056018d --- /dev/null +++ b/openspec/changes/files-sidebar-tabs/specs/files-sidebar-tabs/spec.md @@ -0,0 +1,251 @@ +--- +status: draft +--- +# Files Sidebar Tabs + +## Purpose +Integrates OpenRegister into the Nextcloud Files app sidebar by registering custom tabs that display register object references and file extraction metadata for any selected file. This enables records managers, privacy officers, and archivists to understand the relationship between files and structured register data without leaving the Files app. + +## Requirements + +### Requirement: Sidebar Tab Registration +The system SHALL register two custom tabs in the Nextcloud Files app sidebar using the `OCA.Files.Sidebar.Tab` API. The tabs MUST be loaded only when the Files app is active and MUST NOT interfere with other sidebar tabs or the core Files app functionality. + +#### Scenario: Tabs are registered on DOMContentLoaded +- **GIVEN** the Nextcloud Files app is loaded +- **WHEN** the DOMContentLoaded event fires +- **THEN** two sidebar tabs MUST be registered via `OCA.Files.Sidebar.registerTab()` +- **AND** the first tab MUST have id `openregister-objects` and name "Register Objects" +- **AND** the second tab MUST have id `openregister-extraction` and name "Extraction" + +#### Scenario: Tabs are only loaded in the Files app context +- **GIVEN** the OpenRegister app is enabled +- **WHEN** the user navigates to the Files app +- **THEN** the `openregister-files-sidebar.js` script MUST be loaded via `\OCP\Util::addScript()` in a `BeforeTemplateRenderedEvent` listener scoped to the `files` app +- **AND** the script MUST NOT be loaded in other app contexts + +#### Scenario: Tabs are not registered when sidebar is unavailable +- **GIVEN** the Files app page has loaded +- **WHEN** `OCA.Files.Sidebar` is undefined (e.g., public share page without sidebar) +- **THEN** the tab registration code MUST exit gracefully without errors + +#### Scenario: Tab icons use Material Design Icons +- **GIVEN** the sidebar tabs are registered +- **WHEN** the tab icon is rendered +- **THEN** the Register Objects tab MUST use the `database-outline` MDI SVG icon +- **AND** the Extraction tab MUST use the `text-box-search-outline` MDI SVG icon + +### Requirement: Register Objects Tab +The Register Objects tab SHALL display a list of all OpenRegister objects that reference the selected file. Each object entry MUST show the register name, schema name, object title (or UUID), and a clickable link to open the object in the OpenRegister app. + +#### Scenario: Objects referencing the file are displayed +- **GIVEN** the user selects a file in the Files app +- **WHEN** the Register Objects tab is mounted or updated with the file info +- **THEN** the tab MUST call `GET /apps/openregister/api/files/{fileId}/objects` with the Nextcloud file ID +- **AND** the response objects MUST be rendered as a list showing register name, schema name, and object title + +#### Scenario: No objects reference the file +- **GIVEN** the user selects a file that is not referenced by any OpenRegister object +- **WHEN** the Register Objects tab loads the data +- **THEN** the tab MUST display an NcEmptyContent component with the message "No register objects reference this file" +- **AND** the empty state MUST include the `database-off-outline` icon + +#### Scenario: Object link navigates to OpenRegister +- **GIVEN** the Register Objects tab displays a list of referencing objects +- **WHEN** the user clicks on an object entry +- **THEN** the browser MUST navigate to the OpenRegister app at `/apps/openregister/registers/{registerId}/schemas/{schemaId}/objects/{objectUuid}` + +#### Scenario: Tab shows loading state +- **GIVEN** the Register Objects tab is mounted +- **WHEN** the API request is in progress +- **THEN** the tab MUST display an NcLoadingIcon centered in the tab area + +#### Scenario: API error is handled gracefully +- **GIVEN** the Register Objects tab calls the objects-by-file API +- **WHEN** the API returns an error (4xx or 5xx) +- **THEN** the tab MUST display an NcEmptyContent with the message "Failed to load register data" +- **AND** the error MUST be logged to the browser console + +#### Scenario: Tab updates when file selection changes +- **GIVEN** the Register Objects tab is mounted and showing data for file A +- **WHEN** the user selects a different file B +- **THEN** the tab's `update(fileInfo)` callback MUST fetch and display objects for file B +- **AND** the previous data MUST be cleared before the new data loads + +### Requirement: Objects-by-File API Endpoint +The system SHALL expose an authenticated API endpoint at `GET /api/files/{fileId}/objects` that returns all OpenRegister objects referencing the given Nextcloud file ID. The endpoint MUST search across all registers and schemas that the current user has access to. + +#### Scenario: File referenced by multiple objects across registers +- **GIVEN** file ID 42 is referenced in object A (register 1, schema 1) and object B (register 2, schema 3) +- **WHEN** an authenticated user calls `GET /api/files/42/objects` +- **THEN** the response MUST be HTTP 200 with a JSON array containing both objects +- **AND** each object MUST include `uuid`, `register` (object with `id` and `title`), `schema` (object with `id` and `title`), and `title` (first string property value or UUID) + +#### Scenario: File not referenced by any object +- **GIVEN** file ID 99 is not referenced by any OpenRegister object +- **WHEN** an authenticated user calls `GET /api/files/99/objects` +- **THEN** the response MUST be HTTP 200 with an empty JSON array `[]` + +#### Scenario: Search strategy for file references +- **GIVEN** OpenRegister schemas can have properties of format `file` that store Nextcloud file IDs +- **WHEN** the `FileSidebarService::getObjectsForFile()` method is called +- **THEN** it MUST query the `oc_openregister_objects` table (or the per-schema magic tables) for rows where any JSON property value contains the file ID +- **AND** it MUST also check the `oc_openregister_file_relations` table if it exists for indexed file-to-object mappings + +#### Scenario: Results respect RBAC permissions +- **GIVEN** a user without access to register 3 +- **WHEN** the user calls `GET /api/files/42/objects` and file 42 is referenced in register 3 +- **THEN** objects from register 3 MUST NOT appear in the response +- **AND** only objects from registers the user has read access to MUST be returned + +#### Scenario: Unauthenticated access is rejected +- **GIVEN** an unauthenticated client +- **WHEN** the client calls `GET /api/files/42/objects` +- **THEN** the Nextcloud framework MUST return HTTP 401 + +### Requirement: Extraction & Metadata Tab +The Extraction tab SHALL display text extraction status, chunk statistics, detected entity counts, risk level, and anonymization information for the selected file. This gives privacy officers immediate visibility into the PII analysis status of any file. + +#### Scenario: Extraction data is displayed for a processed file +- **GIVEN** the user selects a file that has been processed by OpenRegister's text extraction +- **WHEN** the Extraction tab is mounted or updated +- **THEN** the tab MUST call `GET /apps/openregister/api/files/{fileId}/extraction-status` +- **AND** the response data MUST be rendered showing: extraction status (pending/processing/completed/failed), chunk count, entity count, risk level, and extraction timestamp + +#### Scenario: File has not been processed +- **GIVEN** the user selects a file that has no extraction records in OpenRegister +- **WHEN** the Extraction tab loads +- **THEN** the tab MUST display an NcEmptyContent with the message "No extraction data available for this file" +- **AND** a button labeled "Extract Now" MUST be shown that triggers `POST /apps/openregister/api/files/{fileId}/extract` + +#### Scenario: Risk level is displayed with appropriate styling +- **GIVEN** the extraction data includes a risk level +- **WHEN** the Extraction tab renders the risk level +- **THEN** risk level "none" MUST be styled with a neutral badge +- **AND** risk level "low" MUST be styled with a green/success badge +- **AND** risk level "medium" MUST be styled with a yellow/warning badge +- **AND** risk level "high" MUST be styled with a red/error badge +- **AND** risk level "very_high" MUST be styled with a dark red/critical badge + +#### Scenario: Entity details are expandable +- **GIVEN** the file has detected entities +- **WHEN** the user views the Extraction tab +- **THEN** the entity count MUST be displayed as a summary (e.g., "12 entities detected") +- **AND** clicking the entity count MUST expand a list showing entity types and their counts (e.g., "PERSON: 3, EMAIL: 5, PHONE_NUMBER: 4") + +#### Scenario: Anonymization status is shown +- **GIVEN** the file has been anonymized via OpenRegister +- **WHEN** the Extraction tab renders +- **THEN** a badge MUST display "Anonymized" with the anonymization timestamp +- **AND** a link to the anonymized file copy MUST be provided if available + +#### Scenario: Extract Now button triggers extraction +- **GIVEN** the file has not been extracted or extraction failed +- **WHEN** the user clicks the "Extract Now" button +- **THEN** a `POST /apps/openregister/api/files/{fileId}/extract` request MUST be sent +- **AND** the button MUST show a loading spinner during the request +- **AND** on success the tab MUST refresh to show the updated extraction status + +### Requirement: Extraction Status API Endpoint +The system SHALL expose an authenticated API endpoint at `GET /api/files/{fileId}/extraction-status` that returns the text extraction and entity recognition status for a specific Nextcloud file. + +#### Scenario: File with completed extraction +- **GIVEN** file ID 42 has been successfully extracted +- **WHEN** an authenticated user calls `GET /api/files/42/extraction-status` +- **THEN** the response MUST be HTTP 200 with JSON containing: + - `fileId` (integer) + - `extractionStatus` (string: "completed") + - `chunkCount` (integer) + - `entityCount` (integer) + - `riskLevel` (string: "none"|"low"|"medium"|"high"|"very_high") + - `extractedAt` (ISO 8601 timestamp or null) + - `entities` (array of `{type, count}` objects) + - `anonymized` (boolean) + - `anonymizedAt` (ISO 8601 timestamp or null) + - `anonymizedFileId` (integer or null) + +#### Scenario: File with no extraction record +- **GIVEN** file ID 99 has never been processed by OpenRegister +- **WHEN** an authenticated user calls `GET /api/files/99/extraction-status` +- **THEN** the response MUST be HTTP 200 with JSON containing `extractionStatus: "none"` and all numeric fields set to 0 + +#### Scenario: Unauthenticated access is rejected +- **GIVEN** an unauthenticated client +- **WHEN** the client calls `GET /api/files/42/extraction-status` +- **THEN** the Nextcloud framework MUST return HTTP 401 + +### Requirement: Webpack Entry Point +The sidebar tabs MUST be built as a separate webpack entry point that produces a standalone JavaScript bundle. This bundle MUST NOT include the full OpenRegister app router, Pinia stores, or other app-specific dependencies -- only the minimal code needed for the two sidebar tab components. + +#### Scenario: Separate entry point exists +- **GIVEN** the webpack configuration is inspected +- **WHEN** the `entry` object is checked +- **THEN** there MUST be an entry named `filesSidebar` pointing to `src/files-sidebar.js` +- **AND** the output filename MUST be `openregister-filesSidebar.js` + +#### Scenario: Bundle size is minimal +- **GIVEN** the filesSidebar entry point is built +- **WHEN** the production bundle size is measured +- **THEN** the bundle SHOULD be under 50KB gzipped (excluding shared chunks) +- **AND** the bundle MUST NOT import the Vue Router, Pinia, or the main OpenRegister App.vue + +#### Scenario: Bundle uses Nextcloud framework utilities +- **GIVEN** the sidebar tab components need to make API calls and generate URLs +- **WHEN** the components import dependencies +- **THEN** they MUST use `@nextcloud/axios` for HTTP requests +- **AND** they MUST use `@nextcloud/router` for URL generation +- **AND** they MUST use `@nextcloud/l10n` for translations + +### Requirement: Script Loading via Event Listener +The backend MUST register an event listener that injects the sidebar tab script when the Files app renders its template. The listener MUST use the Nextcloud `BeforeTemplateRenderedEvent` to add the script at the correct time. + +#### Scenario: Script is injected for Files app +- **GIVEN** the OpenRegister app is enabled +- **WHEN** a user navigates to the Files app +- **THEN** the `FilesSidebarListener` MUST handle the `BeforeTemplateRenderedEvent` +- **AND** it MUST call `\OCP\Util::addScript('openregister', 'openregister-filesSidebar')` to inject the bundle + +#### Scenario: Listener is registered in Application::register +- **GIVEN** the `Application.php` boot process +- **WHEN** `register()` is called +- **THEN** the `FilesSidebarListener` MUST be registered for the `\OCA\Files\Event\LoadAdditionalScriptsEvent` event via `$context->registerEventListener()` + +#### Scenario: Script is not loaded for other apps +- **GIVEN** a user navigates to the Calendar app +- **WHEN** the Calendar template is rendered +- **THEN** the `openregister-filesSidebar.js` script MUST NOT be loaded + +### Requirement: Internationalization +All user-visible text in the sidebar tabs MUST support Dutch (nl) and English (en) translations using Nextcloud's `t()` function from `@nextcloud/l10n`. + +#### Scenario: Tab names are translatable +- **GIVEN** the sidebar tabs are registered +- **WHEN** the Nextcloud UI language is set to Dutch +- **THEN** the Register Objects tab name MUST display "Registerobjecten" +- **AND** the Extraction tab name MUST display "Extractie" + +#### Scenario: All UI text uses t() function +- **GIVEN** any user-visible string in the sidebar tab components +- **WHEN** the string is rendered +- **THEN** it MUST be wrapped in `t('openregister', '...')` for translation + +### Requirement: Accessibility +The sidebar tabs and their content MUST comply with WCAG AA accessibility standards, consistent with the NL Design System requirements. + +#### Scenario: Tab content uses semantic HTML +- **GIVEN** the Register Objects tab displays a list of objects +- **WHEN** a screen reader reads the content +- **THEN** the object list MUST use `