itk-dev · rimi-itk · Sep 9, 2026 · Sep 1, 2026 · Sep 1, 2026 · Sep 1, 2026
diff --git a/.env b/.env
@@ -32,4 +32,9 @@ DEFAULT_URI=http://localhost
 
 ###> app ###
 APP_BROKER_BASE_URI=http://scorpio.local:9090/
+
+# JSON-LD contexts attached to every entity, outermost last so the ETSI core
+# context resolves the NGSI-LD terms and the domain context resolves the
+# Smart Data Models ones.
+ENTER_NGSI_CONTEXT_URLS='https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld'
 ###< app ###
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,18 @@
+#### Link to ticket
+
+Please add a link to the ticket being addressed by this change.
+
+#### Description
+
+Please include a short description of the suggested change and the reasoning behind the approach you have chosen.
+
+#### Screenshot of the result
+
+If your change affects the user interface you should include a screenshot of the result with the pull request.
+
+#### Checklist
+
+- [ ] My code is covered by test cases.
+- [ ] My code passes our test (all our tests).
+- [ ] My code passes our static analysis suite.
+- [ ] My code passes our continuous integration process.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,4 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+* [#3](https://github.com/itk-dev/enter/pull/3)
+  * Import command that reads a geospatial feed, reprojects it to WGS84 and upserts it to an NGSI-LD broker.
+  * A committed record per data set — feed, CRS, model, DCAT-AP metadata.
+  * An extension point for adding data sets, a test suite, and architecture decision records.
+  * Source manifest validated against a Symfony config tree and read during container warm-up, so a malformed
+    entry fails the build rather than the one import that selects it.
+
 [Unreleased]: https://github.com/itk-dev/enter
diff --git a/README.md b/README.md
@@ -4,6 +4,7 @@ We use [DDEV](https://ddev.com/) and [Task](https://taskfile.dev/) for developme
 
 ``` shell
 task site:install
+```
 
 ``` shell
 task site:update
@@ -12,150 +13,43 @@ ddev launch
 
 Run `task` to see what cool task are available. Running `ddev` can help with other stuff.
 
-## Broker
-
-A [Scorpio Broker](https://scorpio.readthedocs.io/) is part of the development setup.
-
-``` shell
-ddev exec "curl --silent http://scorpio.local:9090/ngsi-ld/v1/types | jq"
-```
-
-Load some example data:
+## Adapter
 
-``` shell name=import-toilet
-ddev console app:broker:entity:delete toilet
-ddev console app:broker:import:geojson toilet 'https://webkort.aarhuskommune.dk/spatialmap?page=get_geojson_opendata&datasource=andre_toiletter'
-ddev exec "curl --silent http://scorpio.local:9090/ngsi-ld/v1/entities --get --data-urlencode type=toilet" | jq '.[]|with_entries(select([.key] | inside(["id", "type", "location"])))'
-```
+Takes an open-data set, converts it to [NGSI-LD], and upserts it into the
+context broker.
 
-``` shell name=import-handicapparkering
-ddev console app:broker:entity:delete handicapparkering
-ddev console app:broker:import:geojson handicapparkering 'https://webkort.aarhuskommune.dk/spatialmap?page=get_geojson_opendata&datasource=invap'
-ddev exec "curl --silent http://scorpio.local:9090/ngsi-ld/v1/entities --get --data-urlencode type=handicapparkering" | jq '.[]|with_entries(select([.key] | inside(["id", "type", "location"])))'
+``` text
+source feed (JSON)
+  → SourceInterface implementation   maps fields, fixes quirks, picks the data model
+    → NgsiEntity                     normalized NGSI-LD: Property / GeoProperty / Relationship
+      → NgsiLdBroker                 POST /ngsi-ld/v1/entityOperations/upsert
+        → context broker
 ```
 
-``` shell name=import-hundeskov
-ddev console app:broker:entity:delete hundeskov
-ddev console app:broker:import:geojson hundeskov 'https://webkort.aarhuskommune.dk/spatialmap?page=get_geojson_opendata&datasource=hundeskove_friluftsliv_aarhus'
-ddev exec "curl --silent http://scorpio.local:9090/ngsi-ld/v1/entities --get --data-urlencode type=hundeskov" | jq '.[]|with_entries(select([.key] | inside(["id", "type", "location", "geometry"])))'
+``` shell
+task import                                                # list the available sources
+task import -- mtm_spatialmaps-handicap-parking                        # import one
+task import -- mtm_spatialmaps-handicap-parking --dry-run --limit 5    # print the payload instead
 ```
 
-### Broker API request examples
-
-<https://scorpio.readthedocs.io/en/latest/API_walkthrough.html#entity-creation>
-
-``` shell name=scorpio-entity-create substitutions="{«entity-type»: Room, «entity-id»: 'house2:smartrooms:room1'}"
-ddev exec "curl --silent http://scorpio.local:9090/ngsi-ld/v1/entities --header 'content-type: application/json' --data @-" <<'JSON'
-{
- "type": "«entity-type»",
- "id": "«entity-id»"
-}
-JSON
-
+### Source manifest
 
-# EPSG:4326?!
-ddev exec "curl --silent http://scorpio.local:9090/ngsi-ld/v1/entities/«entity-id»/attrs --header 'content-type: application/json' --data @-" <<'JSON'
-{
- "location": {
-  "type": "geo:json",
-  "value": {
-   "type": "Point",
-   "coordinates": [
-      10.15711687080293, 56.126271111641266
-   ]
-  }
- }
-}
-JSON
+Every data set is recorded in [config/sources.yaml](config/sources.yaml), keyed
+by the identifier `app:import` takes as its argument. See [ADR 007](docs/adr/007-source-manifest.md).
 
+Adding a data set means adding one `SourceInterface` implementation and one
+manifest entry. The class is discovered through
+`#[AutoconfigureTag('app.source')]` and shows up as an `app:import` argument
+with no further wiring.
 
-# Get the entities
-ddev exec "curl --silent --header 'accept: application/ld+json' http://scorpio.local:9090/ngsi-ld/v1/entities?type=«entity-type» | jq"
+Design decisions are recorded in [docs/adr](docs/adr/README.md).
 
-# Get the entities as GeoJSON
-ddev exec "curl --silent --header 'accept: application/geo+json' http://scorpio.local:9090/ngsi-ld/v1/entities?type=«entity-type» | jq"
-```
-
-> [!CAUTION]
-> Excuse me what?!
->
-> ``` shell
-> ddev exec "curl --silent --header 'accept: application/geo+json' 'http://scorpio.local:9090/ngsi-ld/v1/entities?georel=near;maxDistance%3D%3D2000&geometry=Point&coordinates=%5B8,40%5D'"
-> ddev exec "curl --silent --header 'accept: application/geo+json' 'http://scorpio.local:9090/ngsi-ld/v1/entities?georel=near;maxDistance==2000&geometry=Point&coordinates=%5B8,40%5D'"
-> ddev exec "curl --silent --header 'accept: application/geo+json' 'http://scorpio.local:9090/ngsi-ld/v1/entities?georel=near;maxDistance==2000&geometry=Point&coordinates=[10,56]'"
-> > ```
-
-## GeoJSON
-
-* "[Position](https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.1)": `(longitude, latitude)`
-  * "[Coordinate Reference System](https://datatracker.ietf.org/doc/html/rfc7946#section-4)"
-  * But … <https://gis.stackexchange.com/a/437311>
-
-    <https://www.opendata.dk/city-of-aarhus/toiletter-i-aarhus-kommune> → <https://webkort.aarhuskommune.dk/spatialmap?page=get_geojson_opendata&datasource=andre_toiletter>:
-
-    ```json
-    {
-      "type": "FeatureCollection",
-      "crs": {
-        "type": "name",
-        "properties": {
-          "name": "EPSG:25832"
-        }
-      },
-      "bbox": [563262.0903961, 6209995.05346621, 579587.800694027, 6231954.36230685],
-      "features": [
-        {
-          "type": "Feature",
-          "geometry": {
-            "type": "MultiPoint",
-            "coordinates": [
-              [576933.018139537, 6218035.22691216]
-            ]
-          },
-          "properties": {
-    …
-    ```
-
-* <https://geojson.com/>
-
----
-
-* <https://http.dev/tools>
-* <https://httpbin.io/>
-* <https://epsg.io/transform#s_srs=4326&t_srs=25832&x=NaN&y=NaN>
-* <https://fiware-datamodels.readthedocs.io/en/stable/guidelines/index.html#modelling-location>
-
-Must `location` be a `Point` in ngsi-ld?
+[NGSI-LD]: https://www.etsi.org/committee/cim
 
-``` shell
-ddev exec --service scorpio-db "psql ngb ngb"
-```
-
-``` sql
-2026-08-30 10:26:19.789 UTC [41] LOG:  execute 0000000: WITH D0 AS (SELECT ID, ENTITY, TRUE as PARENT FROM ENTITY WHERE ST_DWithin( location::geography, ST_SetSRID(ST_GeomFromGeoJSON('{"type": "Point", "coordinates": [10.236808047161853,56.101226991176155] }'), 4326)::geography, 2000.0)  ORDER BY createdAt limit $1 offset $2) SELECT ID, ENTITY, PARENT FROM D0
-```
+## Broker
 
-<https://postgis.net/docs/ST_GeomFromGeoJSON.html>
+A [Scorpio Broker](https://scorpio.readthedocs.io/) is part of the development setup.
 
 ``` shell
-ddev exec --service scorpio-db "psql ngb ngb" <<< "SELECT id , e_types, location FROM entity;"
-```
-
-``` shell name=hmm
-ddev console app:import:geojson toilet 'https://webkort.aarhuskommune.dk/spatialmap?page=get_geojson_opendata&datasource=andre_toiletter' \
-    && ddev exec --service scorpio-db "psql ngb ngb" <<< "SELECT id , e_types, ST_AsText(location) AS location FROM entity WHERE id = 'toilet:0000';" \
-    && ddev exec --service scorpio-db "psql ngb ngb" <<< "SELECT temporalentity_id, ST_AsText(location) AS location, ST_asText(geovalue) AS geovalue, createdat FROM temporalentityattrinstance WHERE temporalentity_id = 'toilet:0000' ORDER BY createdat DESC LIMIT 10;"
+ddev exec "curl --silent http://scorpio.local:9090/ngsi-ld/v1/types | jq"
 ```
-
-<https://www.opendata.dk/search?q=res_format:GeoJSON%20organization:city-of-aarhus>
-
-* [Public toilets in Aarhus Municipality](https://www.opendata.dk/city-of-aarhus/toiletter-i-aarhus-kommune)
-  * [Offentlige
-    toiletter](http://webkort.aarhuskommune.dk/spatialmap?page=get_geojson_opendata&datasource=andre_toiletter):
-    <http://webkort.aarhuskommune.dk/spatialmap?page=get_geojson_opendata&datasource=andre_toiletter>
-* [Parking in Aarhus Municipality – Zones, Permits and
-  Spaces](https://www.opendata.dk/city-of-aarhus/parkering-i-aarhus-kommune)
-  * [Handicapparkering](https://webkort.aarhuskommune.dk/spatialmap?page=get_geojson_opendata&datasource=invap):
-    <https://webkort.aarhuskommune.dk/spatialmap?page=get_geojson_opendata&datasource=invap>
-
-* <https://enter.ddev.site:33001/data/ngsi-ld/v1/types>
diff --git a/Taskfile.yml b/Taskfile.yml
@@ -36,6 +36,10 @@ tasks:
   test:integration: *test_task
   test:application: *test_task
 
+  import:
+    desc: 'Import a source into the broker, e.g. task import -- mtm_spatialmaps-handicap-parking'
+    cmd: ddev console app:import {{.CLI_ARGS}}
+
   coding-standards:apply:
     desc: 'Apply coding standards'
     cmds:

diff --git a/composer.json b/composer.json
@@ -13,6 +13,7 @@
         "proj4php/proj4php": "^2.0",
         "symfony/asset": "~8.1.0",
         "symfony/asset-mapper": "~8.1.0",
+        "symfony/config": "~8.1.0",
         "symfony/console": "~8.1.6",
         "symfony/dotenv": "~8.1.6",
         "symfony/flex": "^2",

diff --git a/composer.lock b/composer.lock
diff --git a/config/sources.yaml b/config/sources.yaml
@@ -0,0 +1,37 @@
+# The data sets this application publishes, one entry per source key.
+#
+# Field names follow DCAT-AP, the metadata profile European data portals
+# harvest, so registering a data set is a translation of its entry rather than
+# a new survey. See docs/adr/007-source-manifest.md.
+
+sources:
+    mtm_spatialmaps-handicap-parking:
+        title: 'Handicapparkering, Aarhus Kommune'
+        description: >-
+            Disabled parking bays in Aarhus Municipality, with the number of
+            reserved bays per location.
+        publisher: 'Aarhus Kommune'
+        contact: ppg@aarhus.dk
+        landing_page: 'https://www.opendata.dk/city-of-aarhus/parkering-i-aarhus-kommune'
+        access_url: 'https://webkort.aarhuskommune.dk/spatialmap?page=get_geojson_opendata&datasource=invap'
+        media_type: application/geo+json
+        crs: 'EPSG:25832'
+        model: OnStreetParking
+        context_url: 'https://raw.githubusercontent.com/smart-data-models/dataModel.Parking/master/context.jsonld'
+        update_frequency: continuous
+
+        # The portal states no licence for this data set. DCAT-AP requires
+        # one, so it has to be settled with the data owner before the
+        # catalogue can be registered anywhere.
+        licence: ~
+
+        # Fields the feed carries that are not published. Recorded here
+        # because the source class shows what is mapped but cannot show what
+        # was left out, or why.
+        omitted_fields:
+            ident: 'Single-letter code; its meaning is not documented and not confirmed by the data owner.'
+            oprettet_af: 'Directory username of the municipal employee who created the record.'
+            rettet_af: 'Directory username of the municipal employee who last edited the record.'
+            oprettet_dato: 'Describes the register record.'
+            rettet_dato: 'Describes the register record.'
+            mi_style: 'MapInfo rendering style, empty throughout the export.'
diff --git a/docs/adr/001-architecture-symfony-docker.md b/docs/adr/001-architecture-symfony-docker.md
@@ -0,0 +1,74 @@
+# 001: Architecture — Symfony 8 on the ITK Dev Docker template
+
+| Field              | Value                                  |
+|--------------------|----------------------------------------|
+| **Created By**     | Jeppe Krogh                            |
+| **Date**           | 2026-08-24                             |
+| **Decision Maker** | ITK Dev team                           |
+| **Stakeholders**   | ITK Dev developers, future maintainers |
+| **Status**         | Draft                                  |
+
+## Context
+
+This application reads open data sets, converts them to a standard smart-city
+representation, and publishes them to a context broker. The organisation
+maintains its PHP services on a versioned Docker template carrying shared CI
+and coding-standards configuration. This ADR serves to decide the runtime,
+framework and development environment the application is built on.
+
+### Drivers
+
+- **Functional:** scheduled console commands, outbound HTTP, and a local broker
+  to import into. No database and no HTTP surface of its own.
+- **Non-functional:** shared tooling rather than reimplemented tooling, minimal
+  onboarding, reproducible across developers and CI, long-term vendor support.
+
+### Options Considered
+
+1. **PHP 8.4 / Symfony 8 on the maintained template.** CI, coding standards and
+   task runner come for free, and its console suits scheduled imports; it
+   provisions services this application never uses, and its PHP runs ahead of
+   developer hosts.
+2. **A minimal project on the host, without the template.** No unused services
+   and no container requirement, but shared configuration is rebuilt by hand
+   and a local broker needs containers anyway, moving the requirement rather
+   than removing it.
+3. **A second entry point in an existing internal application.** One deployment
+   to operate, but couples a batch importer to a user-facing release cycle and
+   inherits dependencies it has no use for.
+4. **A different language ecosystem on a bespoke setup.** Richer geospatial
+   libraries, but no internal expertise and no shared tooling; the needed
+   transformations exist as mature libraries in the established stack.
+
+## Decision
+
+**PHP 8.4 + Symfony 8** on the ITK Dev Docker template, as its **own deployable
+service**, with a containerised broker overlay for local development.
+
+- Standardising costs less over the application's lifetime than trimming unused
+  services: a second toolchain must be learned and patched; idle containers
+  cost only disk.
+- A batch importer's lifecycle and failure modes differ from a user-facing
+  application's, so it stays its own service.
+- No domain persistence is needed — the broker is the system of record — so the
+  template's database is left unused rather than removed, keeping template
+  updates a clean diff.
+- Local development includes a real broker, so imports are verified end to end
+  rather than only as serialised output.
+
+## Consequences
+
+### Positive
+
+- Onboarding cost close to zero; CI and coding standards work from the first
+  commit.
+- No schema, no migrations, no state to keep consistent with the broker.
+
+### Negative / Trade-offs
+
+- Containers are mandatory; dependency management, console commands and tests
+  cannot run natively.
+- A web server, database and mail catcher are provisioned and never used.
+- Broker images are not published for every CPU architecture, so local start-up
+  may be slow under emulation.
+- The application follows the template's choices; deviating later has a cost.