feat(cmdb-import): run the mapping packs stored in OpenRegister, seeded from the shipped files

CHANGELOG.md

@@ -7,6 +7,22 @@
   sheets becomes or updates a module, its vendor, a usage for the municipality
   and a contact person for its owner; a repeat import matches on APPID, so it
   updates instead of duplicating. See `docs/features/cmdb-import.md`.
+- CMDB import: on an OpenRegister with the migration-pack editor
+  (openregister#4602), the import runs the mapping packs kept in
+  OpenRegister's migration pack store, where an administrator edits them.
+  The `SeedCmdbImportPacks` repair step stores them on install and upgrade;
+  a pack nobody edited follows newer releases, an edited one is kept.
+  Viewing the mapping writes nothing. An older OpenRegister keeps the packs
+  that ship with stackiq.
+- CMDB import, repeat imports: applications that left the CMDB sheets are
+  archived when the sheet "Gearchiveerde Applicaties" lists them and moved to
+  OpenRegister's trash when no sheet does; one that returns is unarchived or
+  restored, never duplicated. The new option `missingRecords` (`archive`, the
+  default, or `keep`) is a choice in the CMDB import section, and the report
+  counts archived, unarchived, deleted and restored applications. The module
+  (0.3.9) and usage (1.5.7) schemas opt into OpenRegister's archive state, and
+  the Applications and Applications in use pages get an "Archived" quick
+  filter. (cmdb-import-archive-reconciliation)
 
 ### Changed
 - EOL feed: the register and schema slugs the feature reads from are corrected.

appinfo/info.xml

@@ -50,7 +50,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.2.5-unstable.20261008120000</version>
+    <version>0.2.6-unstable.20261012120000</version>
     <licence>EUPL-1.2</licence>
     <author mail="info@conduction.nl" homepage="https://www.conduction.nl/">Conduction</author>
     <namespace>Stackiq</namespace>
@@ -250,6 +250,14 @@ Vrij en open source onder de EUPL-licentie.
 				instead of failing.
 			-->
 			<step>OCA\Stackiq\Repair\RenameDutchCatalogValues</step>
+			<!--
+				Stores the CMDB import's sheet packs in OpenRegister's migration-pack
+				store, where an administrator edits them; the import reads them from
+				there. Creates a missing pack and replaces one nobody edited with this
+				release's shipped pack; an edited pack is kept and reported. Never
+				throws, and does nothing without OpenRegister's store.
+			-->
+			<step>OCA\Stackiq\Repair\SeedCmdbImportPacks</step>
 		</post-migration>
 		<!--
 			FRESH INSTALL. Nextcloud does NOT run post-migration on a first install:
@@ -324,6 +332,8 @@ Vrij en open source onder de EUPL-licentie.
 			     exact stored value so an admin's own register is never touched. -->
 			<step>OCA\Stackiq\Repair\RepointEolSyncConfig</step>
 			<step>OCA\Stackiq\Repair\InitializeSettings</step>
+			<!-- A fresh install seeds the CMDB import packs too; see <post-migration> above. -->
+			<step>OCA\Stackiq\Repair\SeedCmdbImportPacks</step>
 		</install>
 	</repair-steps>
 

appinfo/routes.php

@@ -109,6 +109,9 @@
         // @spec openspec/changes/cmdb-export-import/tasks.md#task-8
         ['name' => 'cmdbImport#import', 'url' => '/api/cmdb-import', 'verb' => 'POST'],
         ['name' => 'cmdbImport#cancel', 'url' => '/api/cmdb-import/{operationId}/cancel', 'verb' => 'POST'],
+        // The mapping the CMDB import uses, read-only — same posture as the import (Nextcloud admins only, CSRF).
+        // @spec openspec/changes/cmdb-import-mapping-view/specs/cmdb-export-import/spec.md#requirement-the-admin-settings-shall-show-the-mapping-the-import-uses-req-cmdb-020
+        ['name' => 'settings#getCmdbImportMapping', 'url' => '/api/settings/cmdb-import/mapping', 'verb' => 'GET'],
 
         // User Groups management routes
         ['name' => 'settings#getGenericUserGroups', 'url' => '/api/settings/user-groups/generic', 'verb' => 'GET'],

docs/features/README.md

@@ -158,7 +158,7 @@ The ArchiMate integration maps GEMMA Softwarecatalogus objects to ArchiMate appl
 
 ## CMDB Import
 
-Import a TOPdesk CMDB export (`.xlsx`) for one municipality from the **CMDB import** section of the admin settings. Every application row of the two CMDB sheets ("Onbeh Applicaties CMDB" and "Beheerde Applicaties CMDB") becomes or updates a module, its vendor as a Supplier organisation, a usage that links it to the municipality and records whether maintenance is arranged, and a contact person for its owner (identity in Nextcloud Contacts, never public). A repeat import matches on APPID per municipality, so it updates instead of duplicating, and leaves applications missing from the newer export as they are. The column mapping is declarative JSON executed by OpenRegister's mapping engine.
+Import a TOPdesk CMDB export (`.xlsx`) for one municipality from the **CMDB import** section of the admin settings. Every application row of the two CMDB sheets ("Onbeh Applicaties CMDB" and "Beheerde Applicaties CMDB") becomes or updates a module, its vendor as a Supplier organisation, a usage that links it to the municipality and records whether maintenance is arranged, and a contact person for its owner (identity in Nextcloud Contacts, never public). A repeat import matches on APPID per municipality, so it updates instead of duplicating. By default it archives the applications that moved to the sheet "Gearchiveerde Applicaties" and moves those on no sheet any more to OpenRegister's trash, and brings either back when it returns; the admin can choose to keep them instead. The Applications and Applications in use pages list the archive under the quick filter "Archived". The column mapping is declarative JSON executed by OpenRegister's mapping engine.
 
 See [CMDB import](cmdb-import.md) for the steps, the expected file structure, the error codes and how to adjust the mapping.