feat: Phase 6 – Modul-API-Vertrag mit platform-module-sdk

modules/demo/backend/server.js

@@ -1,9 +1,22 @@
 /**
- * Demo-Modul: Minimaler HTTP-Server, der den Modul-API-Vertrag erfüllt.
+ * Demo-Modul: Referenzimplementierung des Modul-API-Vertrags (Phase 6).
  * Läuft als eigener Node-Prozess im Management-Container (Port via ENV PORT).
+ *
+ * Vertrag (verbindlich für alle Module):
+ *   GET /health        → Liveness/Readiness
+ *   GET /api/manifest  → Manifest zur Laufzeit
+ *   GET /api/me        → Aktueller Benutzer (vom Gateway übergeben)
+ *
+ * Die Identität stammt ausschließlich aus den Gateway-Headern
+ * (siehe platform-module-sdk.js) – niemals aus der URL oder dem Body.
  */
 
 const http = require('node:http');
+const {
+  extractIdentity,
+  healthResponse,
+  meResponse,
+} = require('./platform-module-sdk');
 
 const PORT = Number(process.env.PORT ?? 41001);
 
@@ -19,7 +32,7 @@ const server = http.createServer((request, response) => {
 
   if (url.pathname === '/health') {
     response.writeHead(200, { 'Content-Type': 'application/json' });
-    response.end(JSON.stringify({ moduleId: 'demo', version: '1.0.0', status: 'healthy' }));
+    response.end(JSON.stringify(healthResponse(MANIFEST.moduleId, MANIFEST.version)));
     return;
   }
 
@@ -30,19 +43,26 @@ const server = http.createServer((request, response) => {
   }
 
   if (url.pathname === '/api/me') {
+    const identity = extractIdentity(request.headers);
+    if (!identity) {
+      // Request kam nicht über den Modul-Gateway → keine Identität.
+      response.writeHead(401, { 'Content-Type': 'application/json' });
+      response.end(JSON.stringify({ statusCode: 401, message: 'Keine Identität übergeben' }));
+      return;
+    }
     response.writeHead(200, { 'Content-Type': 'application/json' });
-    response.end(
-      JSON.stringify({
-        user: { id: 'demo', username: 'demo' },
-        module: { id: 'demo' },
-        permissions: [],
-      }),
-    );
+    response.end(JSON.stringify(meResponse(identity, MANIFEST.moduleId, ['demo.read'])));
     return;
   }
 
-  response.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
-  response.end('Demo-Modul läuft');
+  if (url.pathname === '/') {
+    response.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
+    response.end('Demo-Modul läuft');
+    return;
+  }
+
+  response.writeHead(404, { 'Content-Type': 'application/json' });
+  response.end(JSON.stringify({ statusCode: 404, message: 'Nicht gefunden' }));
 });
 
 server.listen(PORT, '127.0.0.1', () => {