From a95d9f12a32beeed2eabc5c18c1b50a706638d24 Mon Sep 17 00:00:00 2001
From: Sercan Sahin <s.sahin@iat.rwth-aachen.de>
Date: Mon, 1 Dec 2025 17:14:41 +0100
Subject: [PATCH] move documentation of unimplemented routes

---
 server/README.md                    | 28 ++++++++++++++++++++++++++++
 server/app/interfaces/repository.py | 26 --------------------------
 2 files changed, 28 insertions(+), 26 deletions(-)

diff --git a/server/README.md b/server/README.md
index 888024ab..d368d4ae 100644
--- a/server/README.md
+++ b/server/README.md
@@ -126,6 +126,34 @@ The server can also be run directly on the host system without Docker, NGINX and
 
 The server can be accessed at http://localhost:8080/api/v3.0/ from your host system. 
 
+## Currently Unimplemented
+Several features and routes are currently not supported:
+
+1. Correlation ID: Not implemented because it was deemed unnecessary for this server.
+
+2. Extent Parameter (`withBlobValue/withoutBlobValue`):
+   Not implemented due to the lack of support in JSON/XML serialization.
+
+3. Route `/shells/{aasIdentifier}/asset-information/thumbnail`: Not implemented because the specification lacks clarity.
+
+4. Serialization and Description Routes:
+   - `/serialization`
+   - `/description`
+   These routes are not implemented at this time.
+
+5. Value, Path, and PATCH Routes:
+   - All `/…/value$`, `/…/path$`, and `PATCH` routes are currently not implemented.
+
+6. Operation Invocation Routes: The following routes are not implemented because operation invocation
+   is not yet supported by the `basyx-python-sdk`:
+   - `POST /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/invoke`
+   - `POST /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/invoke/$value`
+   - `POST /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/invoke-async`
+   - `POST /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/invoke-async/$value`
+   - `GET /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/operation-status/{handleId}`
+   - `GET /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/operation-results/{handleId}`
+   - `GET /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/operation-results/{handleId}/$value`
+
 ## Acknowledgments
 
 This Dockerfile is inspired by the [tiangolo/uwsgi-nginx-docker][10] repository.
diff --git a/server/app/interfaces/repository.py b/server/app/interfaces/repository.py
index 03a3974c..713023d0 100644
--- a/server/app/interfaces/repository.py
+++ b/server/app/interfaces/repository.py
@@ -6,32 +6,6 @@
 # SPDX-License-Identifier: MIT
 """
 This module implements the "Specification of the Asset Administration Shell Part 2 Application Programming Interfaces".
-However, several features and routes are currently not supported:
-
-1. Correlation ID: Not implemented because it was deemed unnecessary for this server.
-
-2. Extent Parameter (`withBlobValue/withoutBlobValue`):
-   Not implemented due to the lack of support in JSON/XML serialization.
-
-3. Route `/shells/{aasIdentifier}/asset-information/thumbnail`: Not implemented because the specification lacks clarity.
-
-4. Serialization and Description Routes:
-   - `/serialization`
-   - `/description`
-   These routes are not implemented at this time.
-
-5. Value, Path, and PATCH Routes:
-   - All `/…/value$`, `/…/path$`, and `PATCH` routes are currently not implemented.
-
-6. Operation Invocation Routes: The following routes are not implemented because operation invocation
-   is not yet supported by the `basyx-python-sdk`:
-   - `POST /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/invoke`
-   - `POST /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/invoke/$value`
-   - `POST /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/invoke-async`
-   - `POST /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/invoke-async/$value`
-   - `GET /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/operation-status/{handleId}`
-   - `GET /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/operation-results/{handleId}`
-   - `GET /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/operation-results/{handleId}/$value`
 """
 
 import io