ci(docs): sync documentation branch with development

.github/workflows/code-quality.yml

@@ -19,5 +19,12 @@ jobs:
       enable-phpunit: true
       enable-sbom: true
       additional-apps: '[{"repo":"ConductionNL/openregister","app":"openregister"}]'
-      enable-newman: true
+      # Newman disabled: tests/magic-mapper-import.postman_collection.json was
+      # written against a dev env with URL rewriting + a fixed disk layout — it
+      # hits bare paths like `/configurations` and uploads files from
+      # `/var/www/html/custom_apps/openregister/...`, neither of which exists on
+      # the CI runner (NC lives under `server/apps/`, no rewrite → `/index.php/...`).
+      # Re-enable after the collection is rewritten to the CI base_url/paths +
+      # a seed step provisions the `voorzieningen` register/`module` schema.
+      enable-newman: false
       newman-collection-path: "tests"

.npmrc

@@ -0,0 +1 @@
+legacy-peer-deps=true

appinfo/info.xml

@@ -42,7 +42,7 @@ Vrij en open source onder de EUPL-licentie.
 
 **Ondersteuning:** Voor ondersteuning, neem contact op via support@conduction.nl. Voor een Service Level Agreement (SLA), neem contact op via sales@conduction.nl.
     ]]></description>
-    <version>0.1.141</version>
+    <version>0.2.0</version>
     <licence>agpl</licence>
     <author mail="info@conduction.nl" homepage="https://www.conduction.nl/">Conduction</author>
     <namespace>SoftwareCatalog</namespace>

composer.json

@@ -14,6 +14,11 @@
 			"OCA\\SoftwareCatalog\\": "lib/"
 		}
 	},
+	"autoload-dev": {
+		"psr-4": {
+			"OCA\\OpenRegister\\": "tests/Stubs/"
+		}
+	},
 	"scripts": {
 		"post-install-cmd": [
 			"@composer bin all install --ansi"

docs/package.json

@@ -15,7 +15,7 @@
     "ci": "npm ci --legacy-peer-deps && npm run build"
   },
   "dependencies": {
-    "@conduction/docusaurus-preset": "^1.5.1",
+    "@conduction/docusaurus-preset": "^2.6.1",
     "@docusaurus/core": "^3.7.0",
     "@docusaurus/preset-classic": "^3.7.0",
     "@docusaurus/theme-mermaid": "^3.7.0",

eslint.config.js

@@ -34,7 +34,9 @@ module.exports = defineConfig([
 		settings: {
 			'import/resolver': {
 				alias: {
-					map: [['@', './src']],
+					map: [
+						['@', './src'],
+					],
 					extensions: ['.js', '.ts', '.vue', '.json'],
 				},
 			},
@@ -52,11 +54,37 @@ module.exports = defineConfig([
 
 		rules: {
 			'jsdoc/require-jsdoc': 'off',
+			// Allow @spec tag used for OpenSpec traceability links
+			'jsdoc/check-tag-names': ['warn', { definedTags: ['spec'] }],
 			'vue/first-attribute-linebreak': 'off',
 			'vue/enforce-style-attribute': ['error', { allow: ['scoped'] }],
 			'@typescript-eslint/no-explicit-any': 'off',
 			'n/no-missing-import': 'off',
+			'n/no-missing-require': 'off',
+			'n/no-extraneous-require': 'off',
+			'n/no-process-exit': 'off',
+			'n/shebang': 'off',
+			'no-console': 'off',
 			'import/no-unresolved': ['error', { ignore: ['^@conduction/nextcloud-vue'] }],
+			// `import/named` cannot statically resolve barrel re-exports through
+			// the npm package's frozen ESM module records (CnAppRoot,
+			// CnPageRenderer, defaultPageTypes are re-exported from internal
+			// modules). Disabled here; webpack + runtime catches real issues.
+			'import/named': 'off',
+			// Library re-exports CnAppRoot/CnPageRenderer/etc as part of v1.x —
+			// the static analyser can't introspect frozen/aliased exports cleanly.
+			// CI and runtime catch real issues.
+			'import/namespace': 'off',
+			'import/default': 'off',
+			'import/no-named-as-default': 'off',
+			'import/no-named-as-default-member': 'off',
+		},
+	},
+	{
+		// validate-manifest.js is a Node script — relax browser-oriented rules.
+		files: ['tests/validate-manifest.js'],
+		rules: {
+			'import/named': 'off',
 		},
 	},
 ])

l10n/en_US.js

@@ -0,0 +1,140 @@
+OC.L10N.register(
+    "softwarecatalog",
+    {
+    "+31 20 123 4567" : "+31 20 123 4567",
+    "Accept" : "Accept",
+    "Actions" : "Actions",
+    "Activate" : "Activate",
+    "Add Contactpersoon" : "Add Contactpersoon",
+    "Add Contract" : "Add Contract",
+    "Add Voorziening" : "Add Voorziening",
+    "Add a new contactpersoon to organisation: {name}" : "Add a new contactpersoon to organisation: {name}",
+    "Add contactpersoon" : "Add contactpersoon",
+    "Ask your administrator to install the OpenRegister app." : "Ask your administrator to install the OpenRegister app.",
+    "Brief description of the organisation" : "Brief description of the organisation",
+    "CBS" : "CBS",
+    "CBS number" : "CBS number",
+    "Cancel" : "Cancel",
+    "Cards" : "Cards",
+    "Catalog Location URL" : "Catalog Location URL",
+    "Change Password" : "Change Password",
+    "Columns" : "Columns",
+    "Contactpersonen" : "Contactpersonen",
+    "Contactpersoon added successfully" : "Contactpersoon added successfully",
+    "Contract number" : "Contract number",
+    "Contract type" : "Contract type",
+    "Contracten" : "Contracten",
+    "Copy" : "Copy",
+    "Copy Organisation" : "Copy Organisation",
+    "Create Organisation" : "Create Organisation",
+    "Deactivate" : "Deactivate",
+    "Delete" : "Delete",
+    "Delete Selected" : "Delete Selected",
+    "Depublish Selected" : "Depublish Selected",
+    "Edit" : "Edit",
+    "Edit Organisation" : "Edit Organisation",
+    "Email" : "Email",
+    "Email Address" : "Email Address",
+    "Email address" : "Email address",
+    "End date" : "End date",
+    "Enter email address" : "Enter email address",
+    "Enter first name" : "Enter first name",
+    "Enter last name" : "Enter last name",
+    "Enter new password" : "Enter new password",
+    "Failed to add contactpersoon: {error}" : "Failed to add contactpersoon: {error}",
+    "Failed to change password: {error}" : "Failed to change password: {error}",
+    "Failed to create user account: {error}" : "Failed to create user account: {error}",
+    "Failed to disable user: {error}" : "Failed to disable user: {error}",
+    "Failed to enable user: {error}" : "Failed to enable user: {error}",
+    "Failed to save organisation: {error}" : "Failed to save organisation: {error}",
+    "Failed to update user groups: {error}" : "Failed to update user groups: {error}",
+    "First" : "First",
+    "First Name" : "First Name",
+    "First name" : "First name",
+    "Function" : "Function",
+    "No concept organisations found" : "No concept organisations found",
+    "Go to organisation" : "Go to organisation",
+    "Help" : "Help",
+    "Install OpenRegister" : "Install OpenRegister",
+    "Invalid contactpersoon data structure" : "Invalid contactpersoon data structure",
+    "Items per page" : "Items per page",
+    "Items per page:" : "Items per page:",
+    "Last" : "Last",
+    "Last Name" : "Last Name",
+    "Last name" : "Last name",
+    "Loading {type}..." : "Loading {type}...",
+    "Manage User Groups" : "Manage User Groups",
+    "Manage your contactpersonen and their information" : "Manage your contactpersonen and their information",
+    "Manage your contracten and their specifications" : "Manage your contracten and their specifications",
+    "Manage your organisaties and their configurations" : "Manage your organisaties and their configurations",
+    "Manage your voorzieningen and their specifications" : "Manage your voorzieningen and their specifications",
+    "Mass Actions ({count})" : "Mass Actions ({count})",
+    "Mass actions ({count} selected)" : "Mass actions ({count} selected)",
+    "Metadata" : "Metadata",
+    "Name" : "Name",
+    "New password" : "New password",
+    "Next" : "Next",
+    "No background jobs configured" : "No background jobs configured",
+    "No changes to save" : "No changes to save",
+    "No contactpersonen found" : "No contactpersonen found",
+    "No description available" : "No description available",
+    "No {type} are available." : "No {type} are available.",
+    "No {type} found" : "No {type} found",
+    "OIN" : "OIN",
+    "OpenRegister is required" : "OpenRegister is required",
+    "Organisaties" : "Organisaties",
+    "Organisation" : "Organisation",
+    "Organisation Identification Number" : "Organisation Identification Number",
+    "Organisation created successfully" : "Organisation created successfully",
+    "Organisation name" : "Organisation name",
+    "Organisation updated successfully" : "Organisation updated successfully",
+    "Owner organisation" : "Owner organisation",
+    "Page {current} of {total}" : "Page {current} of {total}",
+    "Password changed successfully" : "Password changed successfully",
+    "Phone" : "Phone",
+    "Phone number" : "Phone number",
+    "Please fill in all required fields" : "Please fill in all required fields",
+    "Please fill in all required fields with valid data" : "Please fill in all required fields with valid data",
+    "Please wait while we fetch your {type}." : "Please wait while we fetch your {type}.",
+    "Previous" : "Previous",
+    "Properties" : "Properties",
+    "Property" : "Property",
+    "Provision offer" : "Provision offer",
+    "Provision usage" : "Provision usage",
+    "Publish Selected" : "Publish Selected",
+    "Refresh" : "Refresh",
+    "Search..." : "Search...",
+    "See {type} as a table" : "See {type} as a table",
+    "See {type} as cards" : "See {type} as cards",
+    "Select one or more {type} to use mass actions" : "Select one or more {type} to use mass actions",
+    "Select organisation type" : "Select organisation type",
+    "Short Description" : "Short Description",
+    "Short description" : "Short description",
+    "Showing {showing} of {total} {type}" : "Showing {showing} of {total} {type}",
+    "Software Catalog Location URL" : "Software Catalog Location URL",
+    "Software Catalogus needs the OpenRegister app to store and manage data. Please install OpenRegister from the app store to get started." : "Software Catalogus needs the OpenRegister app to store and manage data. Please install OpenRegister from the app store to get started.",
+    "Start date" : "Start date",
+    "Status" : "Status",
+    "Table" : "Table",
+    "There are no background jobs available for configuration." : "There are no background jobs available for configuration.",
+    "This dialog will close automatically in {seconds} seconds..." : "This dialog will close automatically in {seconds} seconds...",
+    "This organisation has no contactpersonen." : "This organisation has no contactpersonen.",
+    "Type" : "Type",
+    "Unknown" : "Unknown",
+    "Unknown organisation" : "Unknown organisation",
+    "Update Organisation" : "Update Organisation",
+    "User account created successfully" : "User account created successfully",
+    "User disabled successfully" : "User disabled successfully",
+    "User enabled successfully" : "User enabled successfully",
+    "User groups updated successfully" : "User groups updated successfully",
+    "Value" : "Value",
+    "View" : "View",
+    "Voorzieningen" : "Voorzieningen",
+    "Website" : "Website",
+    "contact@example.com" : "contact@example.com",
+    "https://catalog.example.com" : "https://catalog.example.com",
+    "https://example.com" : "https://example.com",
+    "{count} selected" : "{count} selected"
+},
+"nplurals=2; plural=(n != 1);"
+);

l10n/en_US.json

@@ -0,0 +1,138 @@
+{
+    "translations": {
+        "+31 20 123 4567": "+31 20 123 4567",
+        "Accept": "Accept",
+        "Actions": "Actions",
+        "Activate": "Activate",
+        "Add Contactpersoon": "Add Contactpersoon",
+        "Add Contract": "Add Contract",
+        "Add Voorziening": "Add Voorziening",
+        "Add a new contactpersoon to organisation: {name}": "Add a new contactpersoon to organisation: {name}",
+        "Add contactpersoon": "Add contactpersoon",
+        "Ask your administrator to install the OpenRegister app.": "Ask your administrator to install the OpenRegister app.",
+        "Brief description of the organisation": "Brief description of the organisation",
+        "CBS": "CBS",
+        "CBS number": "CBS number",
+        "Cancel": "Cancel",
+        "Cards": "Cards",
+        "Catalog Location URL": "Catalog Location URL",
+        "Change Password": "Change Password",
+        "Columns": "Columns",
+        "Contactpersonen": "Contactpersonen",
+        "Contactpersoon added successfully": "Contactpersoon added successfully",
+        "Contract number": "Contract number",
+        "Contract type": "Contract type",
+        "Contracten": "Contracten",
+        "Copy": "Copy",
+        "Copy Organisation": "Copy Organisation",
+        "Create Organisation": "Create Organisation",
+        "Deactivate": "Deactivate",
+        "Delete": "Delete",
+        "Delete Selected": "Delete Selected",
+        "Depublish Selected": "Depublish Selected",
+        "Edit": "Edit",
+        "Edit Organisation": "Edit Organisation",
+        "Email": "Email",
+        "Email Address": "Email Address",
+        "Email address": "Email address",
+        "End date": "End date",
+        "Enter email address": "Enter email address",
+        "Enter first name": "Enter first name",
+        "Enter last name": "Enter last name",
+        "Enter new password": "Enter new password",
+        "Failed to add contactpersoon: {error}": "Failed to add contactpersoon: {error}",
+        "Failed to change password: {error}": "Failed to change password: {error}",
+        "Failed to create user account: {error}": "Failed to create user account: {error}",
+        "Failed to disable user: {error}": "Failed to disable user: {error}",
+        "Failed to enable user: {error}": "Failed to enable user: {error}",
+        "Failed to save organisation: {error}": "Failed to save organisation: {error}",
+        "Failed to update user groups: {error}": "Failed to update user groups: {error}",
+        "First": "First",
+        "First Name": "First Name",
+        "First name": "First name",
+        "Function": "Function",
+        "No concept organisations found": "No concept organisations found",
+        "Go to organisation": "Go to organisation",
+        "Help": "Help",
+        "Install OpenRegister": "Install OpenRegister",
+        "Invalid contactpersoon data structure": "Invalid contactpersoon data structure",
+        "Items per page": "Items per page",
+        "Items per page:": "Items per page:",
+        "Last": "Last",
+        "Last Name": "Last Name",
+        "Last name": "Last name",
+        "Loading {type}...": "Loading {type}...",
+        "Manage User Groups": "Manage User Groups",
+        "Manage your contactpersonen and their information": "Manage your contactpersonen and their information",
+        "Manage your contracten and their specifications": "Manage your contracten and their specifications",
+        "Manage your organisaties and their configurations": "Manage your organisaties and their configurations",
+        "Manage your voorzieningen and their specifications": "Manage your voorzieningen and their specifications",
+        "Mass Actions ({count})": "Mass Actions ({count})",
+        "Mass actions ({count} selected)": "Mass actions ({count} selected)",
+        "Metadata": "Metadata",
+        "Name": "Name",
+        "New password": "New password",
+        "Next": "Next",
+        "No background jobs configured": "No background jobs configured",
+        "No changes to save": "No changes to save",
+        "No contactpersonen found": "No contactpersonen found",
+        "No description available": "No description available",
+        "No {type} are available.": "No {type} are available.",
+        "No {type} found": "No {type} found",
+        "OIN": "OIN",
+        "OpenRegister is required": "OpenRegister is required",
+        "Organisaties": "Organisaties",
+        "Organisation": "Organisation",
+        "Organisation Identification Number": "Organisation Identification Number",
+        "Organisation created successfully": "Organisation created successfully",
+        "Organisation name": "Organisation name",
+        "Organisation updated successfully": "Organisation updated successfully",
+        "Owner organisation": "Owner organisation",
+        "Page {current} of {total}": "Page {current} of {total}",
+        "Password changed successfully": "Password changed successfully",
+        "Phone": "Phone",
+        "Phone number": "Phone number",
+        "Please fill in all required fields": "Please fill in all required fields",
+        "Please fill in all required fields with valid data": "Please fill in all required fields with valid data",
+        "Please wait while we fetch your {type}.": "Please wait while we fetch your {type}.",
+        "Previous": "Previous",
+        "Properties": "Properties",
+        "Property": "Property",
+        "Provision offer": "Provision offer",
+        "Provision usage": "Provision usage",
+        "Publish Selected": "Publish Selected",
+        "Refresh": "Refresh",
+        "Search...": "Search...",
+        "See {type} as a table": "See {type} as a table",
+        "See {type} as cards": "See {type} as cards",
+        "Select one or more {type} to use mass actions": "Select one or more {type} to use mass actions",
+        "Select organisation type": "Select organisation type",
+        "Short Description": "Short Description",
+        "Short description": "Short description",
+        "Showing {showing} of {total} {type}": "Showing {showing} of {total} {type}",
+        "Software Catalog Location URL": "Software Catalog Location URL",
+        "Software Catalogus needs the OpenRegister app to store and manage data. Please install OpenRegister from the app store to get started.": "Software Catalogus needs the OpenRegister app to store and manage data. Please install OpenRegister from the app store to get started.",
+        "Start date": "Start date",
+        "Status": "Status",
+        "Table": "Table",
+        "There are no background jobs available for configuration.": "There are no background jobs available for configuration.",
+        "This dialog will close automatically in {seconds} seconds...": "This dialog will close automatically in {seconds} seconds...",
+        "This organisation has no contactpersonen.": "This organisation has no contactpersonen.",
+        "Type": "Type",
+        "Unknown": "Unknown",
+        "Unknown organisation": "Unknown organisation",
+        "Update Organisation": "Update Organisation",
+        "User account created successfully": "User account created successfully",
+        "User disabled successfully": "User disabled successfully",
+        "User enabled successfully": "User enabled successfully",
+        "User groups updated successfully": "User groups updated successfully",
+        "Value": "Value",
+        "View": "View",
+        "Voorzieningen": "Voorzieningen",
+        "Website": "Website",
+        "contact@example.com": "contact@example.com",
+        "https://catalog.example.com": "https://catalog.example.com",
+        "https://example.com": "https://example.com",
+        "{count} selected": "{count} selected"
+    }
+}