feat: Unified Nextcloud entity linking system

.gitignore

@@ -13,6 +13,7 @@
 
 /node_modules/
 /website/node_modules/
+/docs/node_modules/
 /website/.docusaurus/
 /js/
 /custom_apps/

.license-overrides.json

@@ -1,4 +1,5 @@
 {
 	"@fortawesome/free-solid-svg-icons": "License is (CC-BY-4.0 AND MIT) — both are approved open-source licenses, compound AND expression not parsed by checker",
-	"smalot/pdfparser": "License is LGPL-3.0 — equivalent to LGPL-3.0-only which is on the allowlist, SPDX identifier variation not recognized by checker"
+	"smalot/pdfparser": "License is LGPL-3.0 — equivalent to LGPL-3.0-only which is on the allowlist, SPDX identifier variation not recognized by checker",
+	"apexcharts": "License is MIT — license-checker misreads logo URL as custom license, see https://github.com/apexcharts/apexcharts.js/blob/main/LICENSE"
 }

appinfo/routes.php

@@ -24,12 +24,39 @@
         ['name' => 'endpoints#patch', 'url' => '/api/endpoints/{id}', 'verb' => 'PATCH', 'requirements' => ['id' => '[^/]+']],
         ['name' => 'mappings#patch', 'url' => '/api/mappings/{id}', 'verb' => 'PATCH', 'requirements' => ['id' => '[^/]+']],
         ['name' => 'consumers#patch', 'url' => '/api/consumers/{id}', 'verb' => 'PATCH', 'requirements' => ['id' => '[^/]+']],
+        ['name' => 'actions#patch', 'url' => '/api/actions/{id}', 'verb' => 'PATCH', 'requirements' => ['id' => '[^/]+']],
+
+        // Actions - Custom routes.
+        ['name' => 'actions#test', 'url' => '/api/actions/{id}/test', 'verb' => 'POST', 'requirements' => ['id' => '\d+']],
+        ['name' => 'actions#logs', 'url' => '/api/actions/{id}/logs', 'verb' => 'GET', 'requirements' => ['id' => '\d+']],
+        ['name' => 'actions#migrateFromHooks', 'url' => '/api/actions/migrate-from-hooks/{schemaId}', 'verb' => 'POST', 'requirements' => ['schemaId' => '\d+']],
+
+        // Contacts - matching.
+        ['name' => 'contacts#match', 'url' => '/api/contacts/match', 'verb' => 'GET'],
+
+        // Archival and destruction workflow.
+        ['name' => 'archival#listSelectionLists', 'url' => '/api/archival/selection-lists', 'verb' => 'GET'],
+        ['name' => 'archival#createSelectionList', 'url' => '/api/archival/selection-lists', 'verb' => 'POST'],
+        ['name' => 'archival#getSelectionList', 'url' => '/api/archival/selection-lists/{id}', 'verb' => 'GET', 'requirements' => ['id' => '[^/]+']],
+        ['name' => 'archival#updateSelectionList', 'url' => '/api/archival/selection-lists/{id}', 'verb' => 'PUT', 'requirements' => ['id' => '[^/]+']],
+        ['name' => 'archival#deleteSelectionList', 'url' => '/api/archival/selection-lists/{id}', 'verb' => 'DELETE', 'requirements' => ['id' => '[^/]+']],
+        ['name' => 'archival#getRetention', 'url' => '/api/archival/objects/{id}/retention', 'verb' => 'GET', 'requirements' => ['id' => '[^/]+']],
+        ['name' => 'archival#setRetention', 'url' => '/api/archival/objects/{id}/retention', 'verb' => 'PUT', 'requirements' => ['id' => '[^/]+']],
+        ['name' => 'archival#listDestructionLists', 'url' => '/api/archival/destruction-lists', 'verb' => 'GET'],
+        ['name' => 'archival#generateDestructionList', 'url' => '/api/archival/destruction-lists/generate', 'verb' => 'POST'],
+        ['name' => 'archival#getDestructionList', 'url' => '/api/archival/destruction-lists/{id}', 'verb' => 'GET', 'requirements' => ['id' => '[^/]+']],
+        ['name' => 'archival#approveDestructionList', 'url' => '/api/archival/destruction-lists/{id}/approve', 'verb' => 'POST', 'requirements' => ['id' => '[^/]+']],
+        ['name' => 'archival#rejectFromDestructionList', 'url' => '/api/archival/destruction-lists/{id}/reject', 'verb' => 'POST', 'requirements' => ['id' => '[^/]+']],
+
+        // Linked entities — generic API for ad-hoc linking and reverse lookups.
+        ['name' => 'linked_entity#addObjectLink', 'url' => '/api/objects/{uuid}/_linked/{type}', 'verb' => 'POST', 'requirements' => ['uuid' => '[^/]+', 'type' => '[a-z]+']],
+        ['name' => 'linked_entity#removeObjectLink', 'url' => '/api/objects/{uuid}/_linked/{type}/{entityId}', 'verb' => 'DELETE', 'requirements' => ['uuid' => '[^/]+', 'type' => '[a-z]+', 'entityId' => '.+']],
+        ['name' => 'linked_entity#addRegisterLink', 'url' => '/api/registers/{uuid}/_linked/{type}', 'verb' => 'POST', 'requirements' => ['uuid' => '[^/]+', 'type' => '[a-z]+']],
+        ['name' => 'linked_entity#addSchemaLink', 'url' => '/api/schemas/{uuid}/_linked/{type}', 'verb' => 'POST', 'requirements' => ['uuid' => '[^/]+', 'type' => '[a-z]+']],
+        ['name' => 'linked_entity#reverseLookup', 'url' => '/api/linked/{type}/{entityId}', 'verb' => 'GET', 'requirements' => ['type' => '[a-z]+', 'entityId' => '.+']],
 
-        // Email links (mail sidebar).
-        ['name' => 'emails#byMessage', 'url' => '/api/emails/by-message/{accountId}/{messageId}', 'verb' => 'GET', 'requirements' => ['accountId' => '\d+', 'messageId' => '\d+']],
+        // Email links — sender-based lookup (uses Mail app DB directly).
         ['name' => 'emails#bySender', 'url' => '/api/emails/by-sender', 'verb' => 'GET'],
-        ['name' => 'emails#quickLink', 'url' => '/api/emails/quick-link', 'verb' => 'POST'],
-        ['name' => 'emails#deleteLink', 'url' => '/api/emails/{linkId}', 'verb' => 'DELETE', 'requirements' => ['linkId' => '\d+']],
 
         // Workflow executions.
         ['name' => 'workflowExecution#index', 'url' => '/api/workflow-executions', 'verb' => 'GET'],
@@ -324,14 +351,14 @@
         // Contact relations (CardDAV wrapper).
         ['name' => 'contacts#index', 'url' => '/api/objects/{register}/{schema}/{id}/contacts', 'verb' => 'GET', 'requirements' => ['id' => '[^/]+']],
         ['name' => 'contacts#create', 'url' => '/api/objects/{register}/{schema}/{id}/contacts', 'verb' => 'POST', 'requirements' => ['id' => '[^/]+']],
-        ['name' => 'contacts#update', 'url' => '/api/objects/{register}/{schema}/{id}/contacts/{contactId}', 'verb' => 'PUT', 'requirements' => ['id' => '[^/]+', 'contactId' => '\d+']],
-        ['name' => 'contacts#destroy', 'url' => '/api/objects/{register}/{schema}/{id}/contacts/{contactId}', 'verb' => 'DELETE', 'requirements' => ['id' => '[^/]+', 'contactId' => '\d+']],
+        ['name' => 'contacts#update', 'url' => '/api/objects/{register}/{schema}/{id}/contacts/{contactUid}', 'verb' => 'PUT', 'requirements' => ['id' => '[^/]+', 'contactUid' => '[^/]+']],
+        ['name' => 'contacts#destroy', 'url' => '/api/objects/{register}/{schema}/{id}/contacts/{contactUid}', 'verb' => 'DELETE', 'requirements' => ['id' => '[^/]+', 'contactUid' => '[^/]+']],
         ['name' => 'contacts#objects', 'url' => '/api/contacts/{contactUid}/objects', 'verb' => 'GET'],
 
         // Deck card relations (Nextcloud Deck wrapper).
         ['name' => 'deck#index', 'url' => '/api/objects/{register}/{schema}/{id}/deck', 'verb' => 'GET', 'requirements' => ['id' => '[^/]+']],
         ['name' => 'deck#create', 'url' => '/api/objects/{register}/{schema}/{id}/deck', 'verb' => 'POST', 'requirements' => ['id' => '[^/]+']],
-        ['name' => 'deck#destroy', 'url' => '/api/objects/{register}/{schema}/{id}/deck/{deckId}', 'verb' => 'DELETE', 'requirements' => ['id' => '[^/]+', 'deckId' => '\d+']],
+        ['name' => 'deck#destroy', 'url' => '/api/objects/{register}/{schema}/{id}/deck/{deckRef}', 'verb' => 'DELETE', 'requirements' => ['id' => '[^/]+', 'deckRef' => '[^/]+']],
         ['name' => 'deck#objects', 'url' => '/api/deck/boards/{boardId}/objects', 'verb' => 'GET', 'requirements' => ['boardId' => '\d+']],
 
         // Unified entity relations.

css/mail-sidebar.css

@@ -65,7 +65,10 @@
 .or-mail-sidebar__content {
 	flex: 1;
 	overflow-y: auto;
+	overflow-x: hidden;
 	padding: 12px;
+	display: flex;
+	flex-direction: column;
 }
 
 /* Header */
@@ -431,3 +434,200 @@
 		max-width: 320px;
 	}
 }
+
+/* Tabs are handled by NcAppSidebar/NcAppSidebarTab components */
+
+/* ========================================
+   Tab: Common
+   ======================================== */
+.or-tab-empty {
+	color: var(--color-text-maxcontrast);
+	font-size: 13px;
+	padding: 16px 0;
+	text-align: center;
+}
+
+.or-tab-loading {
+	color: var(--color-text-maxcontrast);
+	font-size: 13px;
+	padding: 16px 0;
+	text-align: center;
+}
+
+/* ========================================
+   Tab: Actions
+   ======================================== */
+.or-action-block {
+	margin-bottom: 16px;
+}
+
+.or-action-label {
+	display: block;
+	font-size: 13px;
+	font-weight: 600;
+	color: var(--color-main-text);
+	margin-bottom: 4px;
+}
+
+.or-action-search {
+	position: relative;
+}
+
+.or-action-input {
+	width: 100%;
+	padding: 8px 10px;
+	border: 1px solid var(--color-border);
+	border-radius: var(--border-radius-large, 6px);
+	background: var(--color-main-background);
+	color: var(--color-main-text);
+	font-size: 13px;
+	box-sizing: border-box;
+	height: 36px;
+}
+
+.or-action-input:focus {
+	border-color: var(--color-primary);
+	outline: none;
+}
+
+.or-action-results {
+	position: absolute;
+	top: 100%;
+	left: 0;
+	right: 0;
+	background: var(--color-main-background);
+	border: 1px solid var(--color-border);
+	border-top: none;
+	border-radius: 0 0 var(--border-radius, 3px) var(--border-radius, 3px);
+	max-height: 200px;
+	overflow-y: auto;
+	z-index: 10;
+	list-style: none;
+	margin: 0;
+	padding: 0;
+	box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+}
+
+.or-action-result {
+	padding: 8px 10px;
+	cursor: pointer;
+	font-size: 13px;
+}
+
+.or-action-result:hover {
+	background: var(--color-background-hover);
+}
+
+.or-action-result-name {
+	color: var(--color-main-text);
+}
+
+.or-action-searching {
+	font-size: 12px;
+	color: var(--color-text-maxcontrast);
+	padding: 4px 0;
+}
+
+/* ========================================
+   Tab: Objects
+   ======================================== */
+.or-objects-list {
+	list-style: none;
+	margin: 0;
+	padding: 0;
+}
+
+.or-object-item {
+	display: flex;
+	justify-content: space-between;
+	align-items: center;
+	padding: 8px 0;
+	border-bottom: 1px solid var(--color-border-dark, var(--color-border));
+}
+
+.or-object-item:last-child {
+	border-bottom: none;
+}
+
+.or-object-info {
+	flex: 1;
+	min-width: 0;
+}
+
+.or-object-name {
+	display: block;
+	font-size: 13px;
+	font-weight: 600;
+	color: var(--color-main-text);
+	white-space: nowrap;
+	overflow: hidden;
+	text-overflow: ellipsis;
+}
+
+.or-object-schema {
+	display: block;
+	font-size: 11px;
+	color: var(--color-text-maxcontrast);
+}
+
+.or-object-unlink {
+	background: none;
+	border: none;
+	color: var(--color-text-maxcontrast);
+	cursor: pointer;
+	font-size: 14px;
+	padding: 4px 6px;
+	border-radius: var(--border-radius, 3px);
+	flex-shrink: 0;
+}
+
+.or-object-unlink:hover {
+	color: var(--color-error);
+	background: var(--color-background-hover);
+}
+
+/* ========================================
+   Tab: Entities
+   ======================================== */
+.or-entity-group {
+	margin-bottom: 12px;
+}
+
+.or-entity-group-title {
+	font-size: 12px;
+	font-weight: 600;
+	color: var(--color-text-maxcontrast);
+	text-transform: uppercase;
+	letter-spacing: 0.5px;
+	margin: 0 0 4px;
+}
+
+.or-entity-list {
+	list-style: none;
+	margin: 0;
+	padding: 0;
+}
+
+.or-entity-item {
+	display: flex;
+	justify-content: space-between;
+	align-items: center;
+	padding: 4px 0;
+	font-size: 13px;
+}
+
+.or-entity-value {
+	color: var(--color-main-text);
+	flex: 1;
+	min-width: 0;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	white-space: nowrap;
+}
+
+.or-entity-confidence {
+	font-size: 11px;
+	color: var(--color-text-maxcontrast);
+	flex-shrink: 0;
+	margin-left: 8px;
+}

docusaurus/docusaurus.config.js → docs/docusaurus.config.js

@@ -20,7 +20,11 @@ const config = {
   // metadata like html lang
   i18n: {
     defaultLocale: 'en',
-    locales: ['en'],
+    locales: ['en', 'nl'],
+    localeConfigs: {
+      en: { label: 'English' },
+      nl: { label: 'Nederlands' },
+    },
   },
 
   presets: [
@@ -29,10 +33,11 @@ const config = {
       /** @type {import('@docusaurus/preset-classic').Options} */
       ({
         docs: {
-          path: '../docs',
+          path: './',
+          exclude: ['**/node_modules/**'],
           sidebarPath: require.resolve('./sidebars.js'),
           editUrl:
-            'https://github.com/conductionnl/openregister/tree/main/docusaurus/',
+            'https://github.com/conductionnl/openregister/tree/main/docs/',
         },
         blog: false,
         theme: {
@@ -94,6 +99,10 @@ const config = {
             label: 'GitHub',
             position: 'right',
           },
+          {
+            type: 'localeDropdown',
+            position: 'right',
+          },
         ],
       },
       footer: {