lxe/mpm
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Phase 8 – Modul-SDK (createModuleServer, Config, Logger, Platform-Client)

Browse Source
This commit is contained in:
MPM Dev
2026-10-07 16:29:40 +02:00
parent 0abe7b7abc
commit e6219e8cf9
9 changed files with 1081 additions and 107 deletions
Download Patch File Download Diff File Expand all files Collapse all files

76
modules/demo/backend/server.js
View File

@@ -1,70 +1,40 @@
/**
* Demo-Modul: Referenzimplementierung des Modul-API-Vertrags (Phase 6).
* Demo-Modul: Referenzimplementierung auf Basis des Modul-SDKs (Phase 8).
* Läuft als eigener Node-Prozess im Management-Container (Port via ENV PORT).
*
* Vertrag (verbindlich für alle Module):
* Der vollständige Modul-API-Vertrag wird vom SDK verdrahtet:
* 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.
* GET / → fachliche Route (routes-Handler)
*/
const http = require('node:http');
const path = require('node:path');
const {
extractIdentity,
healthResponse,
meResponse,
createModuleServer,
loadManifest,
createLogger,
} = require('./platform-module-sdk');
const PORT = Number(process.env.PORT ?? 41001);
const manifest = loadManifest(path.join(__dirname, '..', 'module.json'));
const logger = createLogger({ moduleId: manifest.id });
const port = Number(process.env.PORT ?? manifest.port);
/** Manifest des Moduls (identisch zu module.json). */
const MANIFEST = {
moduleId: 'demo',
version: '1.0.0',
status: 'healthy',
};
const server = http.createServer((request, response) => {
const url = new URL(request.url ?? '/', `http://127.0.0.1:${PORT}`);
if (url.pathname === '/health') {
response.writeHead(200, { 'Content-Type': 'application/json' });
response.end(JSON.stringify(healthResponse(MANIFEST.moduleId, MANIFEST.version)));
return;
}
if (url.pathname === '/api/manifest') {
response.writeHead(200, { 'Content-Type': 'application/json' });
response.end(JSON.stringify(MANIFEST));
return;
}
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' }));
const server = createModuleServer({
manifest,
logger,
permissions: ['demo.read'],
routes: (request, response, context) => {
if (request.method === 'GET' && context.path === '/') {
response.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
response.end('Demo-Modul läuft');
return;
}
response.writeHead(200, { 'Content-Type': 'application/json' });
response.end(JSON.stringify(meResponse(identity, MANIFEST.moduleId, ['demo.read'])));
return;
}
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' }));
response.writeHead(404, { 'Content-Type': 'application/json' });
response.end(JSON.stringify({ statusCode: 404, message: 'Nicht gefunden' }));
},
});
server.listen(PORT, '127.0.0.1', () => {
console.log(`Demo-Modul läuft auf Port ${PORT}`);
server.listen(port, '127.0.0.1', () => {
logger.info('Demo-Modul gestartet', { port });
});