Resolved merge conflicts by accepting incoming deletions and modifica…

…tions

.github/workflows/CI-workflows.yaml

@@ -0,0 +1,120 @@
+name: CI Workflow
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.2'
+          extensions: mbstring, zip, xml, curl, intl, sqlite, gd, pdo_mysql
+          tools: cs2pr, phpcbf, phpcs, phpmd, phpunit
+
+      - name: Install Composer dependencies
+        run: composer install
+
+      - name: Run phpcbf
+        run: phpcbf .
+        continue-on-error: ${{ github.ref != 'refs/heads/main' }}
+
+      #- name: Commit code formatting changes
+      #  if: success() && github.ref != 'refs/heads/main'
+      #  run: |
+      #    git config user.name "GitHub Actions"
+      #    git config user.email "[email protected]"
+      #    git add src
+      #    git diff --cached --quiet || (git commit -m "Update src from PHP Codesniffer" && git pull origin $(git rev-parse --abbrev-ref HEAD) --rebase --autostash && git push)
+
+      - name: Run phpcs
+        run: phpcs -q --report=checkstyle src | cs2pr
+        continue-on-error: ${{ github.ref != 'refs/heads/main' }}
+
+      - name: Run phpmd
+        run: phpmd src xml phpmd.xml --not-strict
+        continue-on-error: ${{ github.ref != 'refs/heads/main' }}
+
+      - name: List files in repository root
+        run: ls -alh
+
+      - name: List files in tests directory
+        run: ls -alh ./tests
+
+      - name: List files in vendor directory
+        run: ls -alh ./vendor
+
+      - name: Run PHPUnit tests
+        env:
+          XDEBUG_MODE: coverage
+        run: |
+          phpunit --bootstrap ./tests/bootstrap.php --configuration phpunit.xml --coverage-html ./coverage --coverage-text | tee coverage.txt
+        continue-on-error: ${{ github.ref != 'refs/heads/main' }}
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install remark presets
+        run: npm install remark-cli remark-preset-lint-consistent remark-preset-lint-recommended remark-lint-list-item-indent
+      - name: Run remark
+        run: npx remark . --output --use remark-preset-lint-consistent --use remark-preset-lint-recommended --use remark-lint-list-item-indent
+      - name: Check for linting errors
+        run: |
+          npx remark . --use remark-preset-lint-consistent --use remark-preset-lint-recommended --use remark-lint-list-item-indent
+        continue-on-error: ${{ github.ref != 'refs/heads/main' }}
+      - name: Git commit
+        if: success() && github.ref != 'refs/heads/main'
+        run: |
+          git config user.name "GitHub Actions"
+          git config user.email "[email protected]"
+          git add .
+          git add package.json package-lock.json
+          git diff --cached --quiet || (git commit -m "Update src from remark-lint" && git pull origin $(git rev-parse --abbrev-ref HEAD) --rebase --autostash && git push)
+
+  checks:
+    needs: [build, lint]
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Setup PHP (for checks)
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.2'
+          extensions: mbstring, zip, xml, curl, intl, sqlite, gd, pdo_mysql
+          tools: cs2pr, phpcs, phpmd, phpunit
+
+      - name: Run Checks
+        run: |
+          if ! command -v phpcs &> /dev/null; then
+            echo "phpcs could not be found. Please ensure it's installed."
+            exit 1
+          fi
+          if ! command -v phpmd &> /dev/null; then
+            echo "phpmd could not be found. Please ensure it's installed."
+            exit 1
+          fi
+          if phpcs -q --report=checkstyle src | grep -q "ERROR"; then
+            echo "PHP CodeSniffer found issues. Please fix them before merging."
+            exit 1
+          fi
+          if phpmd src xml phpmd.xml --strict | grep -q "ERROR"; then
+            echo "PHP Mess Detector found issues. Please fix them before merging."
+            exit 1
+          fi
+          # if ! phpunit --bootstrap ./tests/bootstrap.php --configuration phpunit.xml; then
+          #  echo "PHPUnit tests failed. Please fix them before merging."
+          #  exit 1
+          #fi
+          if ! npx remark . --use remark-preset-lint-consistent --use remark-preset-lint-recommended --use remark-lint-list-item-indent; then
+            echo "Markdown linting failed. Please fix them before merging."
+            exit 1
+          fi
+        continue-on-error: false

.vscode/settings.json

@@ -1,10 +1,21 @@
 {
-  "files.autoSave": "afterDelay",
-"editor.defaultFormatter": "dbaeumer.vscode-eslint",
-"editor.formatOnSave": true,
-"cSpell.words": [
-    "nextcloud",
-    "opencatalogi",
-    "pinia"
-]
+    "files.autoSave": "afterDelay",
+    "editor.defaultFormatter": "dbaeumer.vscode-eslint",
+    "editor.formatOnSave": true,
+    "eslint.format.enable": true,
+    "cSpell.words": [
+        "depubliceren",
+        "Depubliceren",
+        "gedepubliceerd",
+        "Matadata",
+        "nextcloud",
+        "opencatalogi",
+        "organisation",
+        "Organisation",
+        "pinia",
+        "Toegangs"
+    ],
+    "[javascript]": {
+        "editor.defaultFormatter": "dbaeumer.vscode-eslint"
+    },
 }

README.md

@@ -1,36 +1,20 @@
----
-description: >-
-  Welkom bij de gebruikersdocumentatie voor de OpenCatalogi Nextcloud App. Veel
-  succes met het gebruik van de app. Voor vragen of bijdragen, neem gerust
-  contact met ons op.
-coverY: 0
----
+# Welkom
 
-# Open Catalogi
+> \[!NOTE] Mocht je de deze documentatie gevonden hebben in een andere vorm dan Gitbook, kijk dan vooral eerst even [op de Nextcloud OpenCatalogi-Gitbook](https://conduction.gitbook.io/opencatalogi-nextcloud)
 
-## Documentatie
+Deze documentatie richt zich op het gebruik van onze beheerapplicatie, speciaal ontworpen voor het beheren van publicaties en catalogi binnen het federatief netwerk. De OpenCatalogi Nextcloud App is een eenvoudig te installeren:
 
-- [Icons](https://pictogrammers.com/library/mdi/)
-- [Layout](https://docs.nextcloud.com/server/latest/developer_manual/design/layout.html)
-- [Componenten](https://nextcloud-vue-components.netlify.app/)
-- [Developing on wsl with visual studio](https://code.visualstudio.com/docs/remote/wsl)
+* [Quickstart ](installatie/instructies.md)voor een test/demo-omgeving
+* [**Quickstart** ](developers/installatie-van-nextcloud-development-omgeving.md)voor een development-omgeving
 
-## Onze favo dev omgeving
+Onze app ondersteunt de Common Ground-aanpak, waardoor je snel toegang hebt tot bestaande IT-oplossingen die je kunt hergebruiken om de ontwikkeltijd te verkorten en de kosten te verlagen. In deze gids vind je stapsgewijze instructies, nuttige tips en best practices om je te helpen bij het optimaal beheren van je federatief netwerk, zoals publicaties of softwarecomponenten.
 
-- https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl
-- https://marketplace.visualstudio.com/items?itemName=Vue.volar
-
-# Frontend veranderen
-Om de frontend te veranderen verander je de content in de .vue bestanden.
-Elke keer als je iets hebt gewijzigd in en .vue bestand dan moet je `npm run dev` draaien. Een makkelijkere manier om dit bij te houden is `npm run watch` dit commando kijkt naar veranderingen in de .vue bestanden en zet dit meteen door.
-Je moet wel elke keer als je iets veranderd verversen
-
-## De repository draaien
-### Quick start
-Deze repository bevat een quick start docker compose file. Deze docker compose file bevat een init-container die ervoor zorgt dat de applicatie in één keer kan worden gestart. Om deze te gebruiken is [docker](https://docker.com) vereist. Als docker is geïnstalleerd kan de applicatie worden gestart door in deze map het commando `docker compose up` te draaien.
-Wanneer de nextcloud container aangeeft ready te zijn (`[core:notice] [pid 1] AH00094: Command line: 'apache2 -D FOREGROUND'`), kan deze benaderd worden via http://localhost:8080. Na inloggen (er komt eerst een scherm om een account aan te maken) kan in het rechtermenu de app aangezet worden onder het gebruikersmenu en dan 'apps' -> 'jouw apps' -> opencatalogi -> inschakelen.
-
-Daarna kan de opencatalogi-app worden geopend via het hoofdmenu, en bij instellingen -> configuratie moeten dan worden ingevuld: een MongoDB API met sleutel en clusternaam, en voor het activeren van het zoekendpoint een elasticsearch met API key en index.
+Deze documentatie is bedoeld voor diverse doelgroepen:
 
+* [**Gebruikers:**](broken-reference/) iedereen die wilt delen binnen het netwerk.
+* [**Developers**](broken-reference/)**:** Ontwikkelaars die bijdragen aan de OpenCatalogi-projecten en behoefte hebben aan gedetailleerde technische informatie en API-documentatie.
+* [**Beheerders van OpenCatalogi-publicaties**](broken-reference/)**:** Professionals die verantwoordelijk zijn voor het beheren en onderhouden van het federatief netwerk voor publicaites en componenten.
 
+Voor meer informatie over OpenCatalogi en onze gemeenschappelijke inspanningen, bezoek onze [GitHub-pagina](https://github.com/OpenCatalogi) of de officiële website op [OpenCatalogi.nl](https://opencatalogi.nl).
 
+Veel succes met het gebruik van de app. Voor vragen of bijdragen, neem gerust contact met ons op via [email protected].

appinfo/routes.php

@@ -4,6 +4,8 @@
     'resources' => [
         'metadata' => ['url' => '/api/metadata'],
         'publications' => ['url' => '/api/publications'],
+        'organisations' => ['url' => '/api/organisations'],
+        'themes' => ['url' => '/api/themes'],
         'attachments' => ['url' => '/api/attachments'],
         'catalogi' => ['url' => '/api/catalogi'],
         'directory' => ['url' => '/api/directory']
@@ -17,7 +19,9 @@
 		['name' => 'search#index', 'url' => '/api/search', 'verb' => 'GET'],
 		['name' => 'search#show', 'url' => '/api/search/{id}', 'verb' => 'GET'],
 		['name' => 'directory#page', 'url' => '/directory', 'verb' => 'GET'],
+		['name' => 'directory#add', 'url' => '/api/directory/add', 'verb' => 'POST'],
         ['name' => 'configuration#index', 'url' => '/configuration', 'verb' => 'GET'],
-        ['name' => 'configuration#create', 'url' => '/configuration', 'verb' => 'POST']
+        ['name' => 'configuration#create', 'url' => '/configuration', 'verb' => 'POST'],
+		['name' => 'search#preflighted_cors', 'url' => '/api/{path}', 'verb' => 'OPTIONS', 'requirements' => ['path' => '.+']]
 	],
 ];

composer.json

@@ -39,11 +39,13 @@
 		"openapi": "generate-spec"
 	},
 	"require": {
-		"bamarni/composer-bin-plugin": "^1.8",
 		"php": "^8.1",
+		"adbario/php-dot-notation": "^3.3.0",
+		"bamarni/composer-bin-plugin": "^1.8",
 		"elasticsearch/elasticsearch": "^v8.14.0",
 		"adbario/php-dot-notation": "^3.3.0",
-		"guzzlehttp/guzzle": "^7.0"
+		"guzzlehttp/guzzle": "^7.0",
+		"symfony/uid": "^6.4"
 	},
 	"require-dev": {
 		"nextcloud/ocp": "dev-stable29",