emilsoftware-utilities 2.0.0-dev.83 → 2.0.0-dev.85

package/dist/scripts/generateAccessiOpenApi.js

@@ -18,7 +18,7 @@ const platform_express_1 = require("@nestjs/platform-express");
 const express_1 = __importDefault(require("express"));
 const promises_1 = require("fs/promises");
 const path_1 = require("path");
-const AccessiModule_1 = require("../accessi-module/AccessiModule");
+const AccessiModule_1 = require("../accessi-service/AccessiModule");
 /**
  * Esporta il contratto OpenAPI dai decorator Nest senza avviare il database.
  * Il file risultante e l'unica sorgente per il client Orval della console.
@@ -44,7 +44,7 @@ function generateAccessiOpenApi() {
         app.setGlobalPrefix('api');
         // Decorator inspection requires no lifecycle hooks or database connection.
         const document = swagger_1.SwaggerModule.createDocument(app, new swagger_1.DocumentBuilder().setTitle('Accessi API').setVersion('1.0').addBearerAuth().build());
-        const outputDirectory = (0, path_1.join)(process.cwd(), 'src', 'accessi-module', 'openapi');
+        const outputDirectory = (0, path_1.join)(process.cwd(), 'src', 'accessi-service', 'openapi');
         yield (0, promises_1.mkdir)(outputDirectory, { recursive: true });
         yield (0, promises_1.writeFile)((0, path_1.join)(outputDirectory, 'accessi.openapi.json'), `${JSON.stringify(document, null, 2)}\n`);
         yield app.close();

package/dist/scripts/generateAccessiOpenApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateAccessiOpenApi.js","sourceRoot":"","sources":["../../src/scripts/generateAccessiOpenApi.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,6CAAiE;AACjE,uCAA2C;AAC3C,+DAA0D;AAC1D,sDAA8B;AAC9B,0CAA+C;AAC/C,+BAA4B;AAC5B,mEAAgF;AAEhF;;;GAGG;AACH,SAAe,sBAAsB;;QACnC,MAAM,OAAO,GAAmB;YAC9B,eAAe,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;YACvF,oBAAoB,EAAE,uBAAuB;YAC7C,0BAA0B,EAAE,uBAAuB;YACnD,aAAa,EAAE,yBAAyB;YACxC,YAAY,EAAE,KAAK;YACnB,kBAAkB,EAAE,KAAK;YACzB,gCAAgC,EAAE,KAAK;YACvC,UAAU,EAAE,EAAE,MAAM,EAAE,yBAAyB,EAAE,SAAS,EAAE,IAAI,EAAE;YAClE,YAAY,EAAE;gBACZ,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK;gBAC7D,GAAG,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;aAC/F;YACD,uBAAuB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;SAC5C,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAClC,6BAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAC9B,IAAI,iCAAc,CAAC,IAAA,iBAAO,GAAE,CAAC,EAC7B,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;QACF,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC3B,2EAA2E;QAE3E,MAAM,QAAQ,GAAG,uBAAa,CAAC,cAAc,CAC3C,GAAG,EACH,IAAI,yBAAe,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,CACxF,CAAC;QACF,MAAM,eAAe,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC;QAChF,MAAM,IAAA,gBAAK,EAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,IAAA,oBAAS,EAAC,IAAA,WAAI,EAAC,eAAe,EAAE,sBAAsB,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACzG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CAAA;AAED,sBAAsB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACvC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC","sourcesContent":["import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';\nimport { NestFactory } from '@nestjs/core';\nimport { ExpressAdapter } from '@nestjs/platform-express';\nimport express from 'express';\nimport { mkdir, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { AccessiModule, AccessiOptions } from '../accessi-module/AccessiModule';\n\n/**\n * Esporta il contratto OpenAPI dai decorator Nest senza avviare il database.\n * Il file risultante e l'unica sorgente per il client Orval della console.\n */\nasync function generateAccessiOpenApi(): Promise<void> {\n  const options: AccessiOptions = {\n    databaseOptions: { host: 'openapi-generation', database: 'not-used', user: 'not-used' },\n    confirmationEmailUrl: 'https://invalid.local',\n    confirmationEmailReturnUrl: 'https://invalid.local',\n    encryptionKey: 'openapi-generation-only',\n    mockDemoUser: false,\n    autoUpdateDatabase: false,\n    legacyPasswordMigrationOnStartup: false,\n    jwtOptions: { secret: 'openapi-generation-only', expiresIn: '1h' },\n    emailOptions: {\n      host: 'localhost', port: 25, secure: false, requireTLS: false,\n      tls: { rejectUnauthorized: true }, from: 'openapi@invalid.local', auth: { user: '', pass: '' },\n    },\n    federatedAuthentication: { enabled: false },\n  };\n\n  const app = await NestFactory.create(\n    AccessiModule.forRoot(options),\n    new ExpressAdapter(express()),\n    { logger: false },\n  );\n  app.setGlobalPrefix('api');\n  // Decorator inspection requires no lifecycle hooks or database connection.\n\n  const document = SwaggerModule.createDocument(\n    app,\n    new DocumentBuilder().setTitle('Accessi API').setVersion('1.0').addBearerAuth().build(),\n  );\n  const outputDirectory = join(process.cwd(), 'src', 'accessi-module', 'openapi');\n  await mkdir(outputDirectory, { recursive: true });\n  await writeFile(join(outputDirectory, 'accessi.openapi.json'), `${JSON.stringify(document, null, 2)}\\n`);\n  await app.close();\n}\n\ngenerateAccessiOpenApi().catch((error) => {\n  console.error(error);\n  process.exitCode = 1;\n});\n"]}
+{"version":3,"file":"generateAccessiOpenApi.js","sourceRoot":"","sources":["../../src/scripts/generateAccessiOpenApi.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,6CAAiE;AACjE,uCAA2C;AAC3C,+DAA0D;AAC1D,sDAA8B;AAC9B,0CAA+C;AAC/C,+BAA4B;AAC5B,oEAAiF;AAEjF;;;GAGG;AACH,SAAe,sBAAsB;;QACnC,MAAM,OAAO,GAAmB;YAC9B,eAAe,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;YACvF,oBAAoB,EAAE,uBAAuB;YAC7C,0BAA0B,EAAE,uBAAuB;YACnD,aAAa,EAAE,yBAAyB;YACxC,YAAY,EAAE,KAAK;YACnB,kBAAkB,EAAE,KAAK;YACzB,gCAAgC,EAAE,KAAK;YACvC,UAAU,EAAE,EAAE,MAAM,EAAE,yBAAyB,EAAE,SAAS,EAAE,IAAI,EAAE;YAClE,YAAY,EAAE;gBACZ,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK;gBAC7D,GAAG,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;aAC/F;YACD,uBAAuB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;SAC5C,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAClC,6BAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAC9B,IAAI,iCAAc,CAAC,IAAA,iBAAO,GAAE,CAAC,EAC7B,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;QACF,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC3B,2EAA2E;QAE3E,MAAM,QAAQ,GAAG,uBAAa,CAAC,cAAc,CAC3C,GAAG,EACH,IAAI,yBAAe,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,CACxF,CAAC;QACF,MAAM,eAAe,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC;QACjF,MAAM,IAAA,gBAAK,EAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,IAAA,oBAAS,EAAC,IAAA,WAAI,EAAC,eAAe,EAAE,sBAAsB,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACzG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CAAA;AAED,sBAAsB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACvC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC","sourcesContent":["import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';\nimport { NestFactory } from '@nestjs/core';\nimport { ExpressAdapter } from '@nestjs/platform-express';\nimport express from 'express';\nimport { mkdir, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { AccessiModule, AccessiOptions } from '../accessi-service/AccessiModule';\n\n/**\n * Esporta il contratto OpenAPI dai decorator Nest senza avviare il database.\n * Il file risultante e l'unica sorgente per il client Orval della console.\n */\nasync function generateAccessiOpenApi(): Promise<void> {\n  const options: AccessiOptions = {\n    databaseOptions: { host: 'openapi-generation', database: 'not-used', user: 'not-used' },\n    confirmationEmailUrl: 'https://invalid.local',\n    confirmationEmailReturnUrl: 'https://invalid.local',\n    encryptionKey: 'openapi-generation-only',\n    mockDemoUser: false,\n    autoUpdateDatabase: false,\n    legacyPasswordMigrationOnStartup: false,\n    jwtOptions: { secret: 'openapi-generation-only', expiresIn: '1h' },\n    emailOptions: {\n      host: 'localhost', port: 25, secure: false, requireTLS: false,\n      tls: { rejectUnauthorized: true }, from: 'openapi@invalid.local', auth: { user: '', pass: '' },\n    },\n    federatedAuthentication: { enabled: false },\n  };\n\n  const app = await NestFactory.create(\n    AccessiModule.forRoot(options),\n    new ExpressAdapter(express()),\n    { logger: false },\n  );\n  app.setGlobalPrefix('api');\n  // Decorator inspection requires no lifecycle hooks or database connection.\n\n  const document = SwaggerModule.createDocument(\n    app,\n    new DocumentBuilder().setTitle('Accessi API').setVersion('1.0').addBearerAuth().build(),\n  );\n  const outputDirectory = join(process.cwd(), 'src', 'accessi-service', 'openapi');\n  await mkdir(outputDirectory, { recursive: true });\n  await writeFile(join(outputDirectory, 'accessi.openapi.json'), `${JSON.stringify(document, null, 2)}\\n`);\n  await app.close();\n}\n\ngenerateAccessiOpenApi().catch((error) => {\n  console.error(error);\n  process.exitCode = 1;\n});\n"]}

package/dist/scripts/generateAccessiWiki.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * Genera la Wiki in Markdown per GitHub a partire dalla stessa fonte usata
- * dalla console: `src/accessi-module/Console/wiki.ts`.
+ * dalla console: `src/accessi-service/console/wiki.ts`.
  *
  * Output:
  * - WIKI.md      documentazione completa con indice
@@ -13,7 +13,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  */
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const wiki_1 = require("../accessi-module/Console/wiki");
+const wiki_1 = require("../accessi-service/console/wiki");
 const REPO_ROOT = (0, node_path_1.join)(__dirname, '..', '..');
 /** Riproduce la slug dei titoli usata da GitHub per generare gli anchor. */
 function githubSlug(title) {
@@ -99,12 +99,14 @@ function buildMarkdown() {
     return [
         '# Wiki del modulo Accessi',
         '',
-        '> Documento generato automaticamente da `src/accessi-module/Console/wiki.ts` (la stessa fonte della Wiki nella console).',
+        '> Documento generato automaticamente da `src/accessi-service/console/wiki.ts` (la stessa fonte della Wiki nella console).',
         '> Non modificarlo a mano: esegui `npm run generate:accessi-wiki`.',
         '',
         'La stessa documentazione è disponibile, resa in modo interattivo, nella console Accessi su `/api/accessi/console/wiki`.',
         'Per una versione compatta da fornire a un\'IA che costruisce il backend integratore, vedi [`WIKI.ai.md`](WIKI.ai.md).',
         '',
+        'Percorsi per ruolo: [`docs/README.md`](docs/README.md) · quickstart [`service`](docs/quickstart-service.md), [`resource server`](docs/quickstart-resource-server.md), [`frontend`](docs/quickstart-frontend.md).',
+        '',
         '## Indice',
         '',
         toc,
@@ -114,7 +116,7 @@ function buildMarkdown() {
     ].join('\n').replace(/\n{3,}/g, '\n\n');
 }
 const aiHeader = [
-    '<!-- Documento generato automaticamente da src/accessi-module/Console/wiki.ts. Non modificare a mano: npm run generate:accessi-wiki. -->',
+    '<!-- Documento generato automaticamente da src/accessi-service/console/wiki.ts. Non modificare a mano: npm run generate:accessi-wiki. -->',
     '',
     '# Guida compatta per l\'IA',
     '',

package/dist/scripts/generateAccessiWiki.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateAccessiWiki.js","sourceRoot":"","sources":["../../src/scripts/generateAccessiWiki.ts"],"names":[],"mappings":";;AAAA;;;;;;;;;;GAUG;AACH,qCAAwC;AACxC,yCAAiC;AACjC,yDAA0F;AAG1F,MAAM,SAAS,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAE9C,4EAA4E;AAC5E,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK;SACT,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC;SAClC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,KAAK,GAA6B;IACtC,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;CAClB,CAAC;AAEF,SAAS,UAAU,CAAC,KAA2C;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,KAAK,MAAM;QACpC,CAAC,CAAC,qBAAqB,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI;QACjE,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK;YACvB,CAAC,CAAC,uBAAuB,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI;YACnE,CAAC,CAAC,KAAK,CAAC,KAAK;gBACX,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,IAAI;gBACtB,CAAC,CAAC,EAAE,CAAC;IACX,MAAM,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,WAAW,CAAC,KAAgB;IACnC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,GAAG;YACN,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,GAAG;YACN,OAAO,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,KAAK;iBACf,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;iBAClF,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3B,KAAK,SAAS;YACZ,OAAO;gBACL,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;gBAC3B,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,KAAK,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;aAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAC3D,MAAM,SAAS,GAAG,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACnE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnH,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa;IACpB,MAAM,MAAM,GAAG,IAAA,iBAAU,GAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,MAAM;SACf,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC5B,KAAK,KAAK,IAAI;QACd,EAAE;QACF,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;QAC7F,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACZ,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,IAAI,GAAG,oBAAa;SACvB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAChB,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QAC/B,EAAE;QACF,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG;QAChC,EAAE;QACF,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAC5C,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACZ,IAAI,CAAC,WAAW,CAAC,CAAC;IAErB,OAAO;QACL,2BAA2B;QAC3B,EAAE;QACF,0HAA0H;QAC1H,mEAAmE;QACnE,EAAE;QACF,yHAAyH;QACzH,uHAAuH;QACvH,EAAE;QACF,WAAW;QACX,EAAE;QACF,GAAG;QACH,KAAK;QACL,EAAE;QACF,IAAI;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,QAAQ,GAAG;IACf,0IAA0I;IAC1I,EAAE;IACF,4BAA4B;IAC5B,EAAE;IACF,6GAA6G;IAC7G,+FAA+F;IAC/F,EAAE;IACF,8GAA8G;IAC9G,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,2FAA2F;AAC3F,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,SAAS,CAAC,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,CAAC;AACnE,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,YAAY,CAAC,EAAE,GAAG,QAAQ,mBAAmB,IAAA,oBAAa,GAAE,cAAc,EAAE,MAAM,CAAC,CAAC;AAClH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC","sourcesContent":["/**\n * Genera la Wiki in Markdown per GitHub a partire dalla stessa fonte usata\n * dalla console: `src/accessi-module/Console/wiki.ts`.\n *\n * Output:\n * - WIKI.md      documentazione completa con indice\n * - WIKI.ai.md   digest compatto pensato per l'IA\n *\n * La wiki della console e questi file non possono divergere: entrambi derivano\n * dagli stessi dati. Non modificare WIKI.md a mano, esegui `npm run generate:accessi-wiki`.\n */\nimport { writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { WIKI_SECTIONS, wikiGroups, buildAiDigest } from '../accessi-module/Console/wiki';\nimport type { WikiBlock, WikiTone } from '../accessi-module/Console/wiki';\n\nconst REPO_ROOT = join(__dirname, '..', '..');\n\n/** Riproduce la slug dei titoli usata da GitHub per generare gli anchor. */\nfunction githubSlug(title: string): string {\n  return title\n    .toLowerCase()\n    .trim()\n    .replace(/[^\\p{L}\\p{N}\\s_-]/gu, '')\n    .replace(/\\s+/g, '-');\n}\n\n/**\n * Escapa i caratteri che Markdown interpreterebbe come formattazione.\n * Serve per token come `/api/accessi/*`, `ACCESSI_*` o `<jwt>`: senza escaping\n * gli asterischi diventano corsivo e `<...>` viene scambiato per un tag HTML.\n */\nfunction escapeMd(text: string): string {\n  return text.replace(/([\\\\`*_{}[\\]<>#])/g, '\\\\$1');\n}\n\nconst ALERT: Record<WikiTone, string> = {\n  info: 'NOTE',\n  ok: 'TIP',\n  warn: 'WARNING',\n  danger: 'CAUTION',\n};\n\nfunction renderCode(block: Extract<WikiBlock, { kind: 'code' }>): string {\n  const label = block.variant === 'good'\n    ? `**Esempio corretto${block.title ? ` — ${block.title}` : ''}**`\n    : block.variant === 'bad'\n      ? `**Esempio da evitare${block.title ? ` — ${block.title}` : ''}**`\n      : block.title\n        ? `**${block.title}**`\n        : '';\n  const fence = '```' + block.language;\n  return [...(label ? [label, ''] : []), fence, block.code, '```'].join('\\n');\n}\n\nfunction renderBlock(block: WikiBlock): string {\n  switch (block.kind) {\n    case 'p':\n      return escapeMd(block.text);\n    case 'h':\n      return `### ${escapeMd(block.text)}`;\n    case 'list':\n      return block.items\n        .map((item, index) => `${block.ordered ? `${index + 1}.` : '-'} ${escapeMd(item)}`)\n        .join('\\n');\n    case 'code':\n      return renderCode(block);\n    case 'callout':\n      return [\n        `> [!${ALERT[block.tone]}]`,\n        ...(block.title ? [`> **${escapeMd(block.title)}**`] : []),\n        `> ${escapeMd(block.text)}`,\n      ].join('\\n');\n    case 'table': {\n      const head = `| ${block.head.map(escapeMd).join(' | ')} |`;\n      const separator = `| ${block.head.map(() => '---').join(' | ')} |`;\n      const rows = block.rows.map((row) => `| ${row.map((cell) => escapeMd(cell).replace(/\\|/g, '\\\\|')).join(' | ')} |`);\n      return [head, separator, ...rows].join('\\n');\n    }\n    default:\n      return '';\n  }\n}\n\nfunction buildMarkdown(): string {\n  const groups = wikiGroups();\n  const toc = groups\n    .map(({ group, sections }) => [\n      `**${group}**`,\n      '',\n      ...sections.map((section) => `- [${escapeMd(section.title)}](#${githubSlug(section.title)})`),\n      '',\n    ].join('\\n'))\n    .join('\\n');\n\n  const body = WIKI_SECTIONS\n    .map((section) => [\n      `## ${escapeMd(section.title)}`,\n      '',\n      `_${escapeMd(section.summary)}_`,\n      '',\n      section.blocks.map(renderBlock).join('\\n\\n'),\n      '',\n    ].join('\\n'))\n    .join('\\n---\\n\\n');\n\n  return [\n    '# Wiki del modulo Accessi',\n    '',\n    '> Documento generato automaticamente da `src/accessi-module/Console/wiki.ts` (la stessa fonte della Wiki nella console).',\n    '> Non modificarlo a mano: esegui `npm run generate:accessi-wiki`.',\n    '',\n    'La stessa documentazione è disponibile, resa in modo interattivo, nella console Accessi su `/api/accessi/console/wiki`.',\n    'Per una versione compatta da fornire a un\\'IA che costruisce il backend integratore, vedi [`WIKI.ai.md`](WIKI.ai.md).',\n    '',\n    '## Indice',\n    '',\n    toc,\n    '---',\n    '',\n    body,\n  ].join('\\n').replace(/\\n{3,}/g, '\\n\\n');\n}\n\nconst aiHeader = [\n  '<!-- Documento generato automaticamente da src/accessi-module/Console/wiki.ts. Non modificare a mano: npm run generate:accessi-wiki. -->',\n  '',\n  '# Guida compatta per l\\'IA',\n  '',\n  'Versione sintetica della wiki, pensata per essere incollata a un\\'IA che costruisce il backend integratore.',\n  'Disponibile anche nella console con il pulsante \"Copia per AI\" (`/api/accessi/console/wiki`).',\n  '',\n  'Il contenuto è racchiuso in un blocco di codice per essere copiato verbatim, senza interpretazione Markdown.',\n  '',\n].join('\\n');\n\n// Fence a quattro backtick: il digest contiene fence a tre backtick che restano letterali.\nwriteFileSync(join(REPO_ROOT, 'WIKI.md'), buildMarkdown(), 'utf8');\nwriteFileSync(join(REPO_ROOT, 'WIKI.ai.md'), `${aiHeader}\\n\\`\\`\\`\\`text\\n${buildAiDigest()}\\n\\`\\`\\`\\`\\n`, 'utf8');\nprocess.stdout.write('Wiki generata: WIKI.md e WIKI.ai.md\\n');\n"]}
+{"version":3,"file":"generateAccessiWiki.js","sourceRoot":"","sources":["../../src/scripts/generateAccessiWiki.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Genera la Wiki in Markdown per GitHub a partire dalla stessa fonte usata\n * dalla console: `src/accessi-service/console/wiki.ts`.\n *\n * Output:\n * - WIKI.md      documentazione completa con indice\n * - WIKI.ai.md   digest compatto pensato per l'IA\n *\n * La wiki della console e questi file non possono divergere: entrambi derivano\n * dagli stessi dati. Non modificare WIKI.md a mano, esegui `npm run generate:accessi-wiki`.\n */\nimport { writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { WIKI_SECTIONS, wikiGroups, buildAiDigest } from '../accessi-service/console/wiki';\nimport type { WikiBlock, WikiTone } from '../accessi-service/console/wiki';\n\nconst REPO_ROOT = join(__dirname, '..', '..');\n\n/** Riproduce la slug dei titoli usata da GitHub per generare gli anchor. */\nfunction githubSlug(title: string): string {\n  return title\n    .toLowerCase()\n    .trim()\n    .replace(/[^\\p{L}\\p{N}\\s_-]/gu, '')\n    .replace(/\\s+/g, '-');\n}\n\n/**\n * Escapa i caratteri che Markdown interpreterebbe come formattazione.\n * Serve per token come `/api/accessi/*`, `ACCESSI_*` o `<jwt>`: senza escaping\n * gli asterischi diventano corsivo e `<...>` viene scambiato per un tag HTML.\n */\nfunction escapeMd(text: string): string {\n  return text.replace(/([\\\\`*_{}[\\]<>#])/g, '\\\\$1');\n}\n\nconst ALERT: Record<WikiTone, string> = {\n  info: 'NOTE',\n  ok: 'TIP',\n  warn: 'WARNING',\n  danger: 'CAUTION',\n};\n\nfunction renderCode(block: Extract<WikiBlock, { kind: 'code' }>): string {\n  const label = block.variant === 'good'\n    ? `**Esempio corretto${block.title ? ` — ${block.title}` : ''}**`\n    : block.variant === 'bad'\n      ? `**Esempio da evitare${block.title ? ` — ${block.title}` : ''}**`\n      : block.title\n        ? `**${block.title}**`\n        : '';\n  const fence = '```' + block.language;\n  return [...(label ? [label, ''] : []), fence, block.code, '```'].join('\\n');\n}\n\nfunction renderBlock(block: WikiBlock): string {\n  switch (block.kind) {\n    case 'p':\n      return escapeMd(block.text);\n    case 'h':\n      return `### ${escapeMd(block.text)}`;\n    case 'list':\n      return block.items\n        .map((item, index) => `${block.ordered ? `${index + 1}.` : '-'} ${escapeMd(item)}`)\n        .join('\\n');\n    case 'code':\n      return renderCode(block);\n    case 'callout':\n      return [\n        `> [!${ALERT[block.tone]}]`,\n        ...(block.title ? [`> **${escapeMd(block.title)}**`] : []),\n        `> ${escapeMd(block.text)}`,\n      ].join('\\n');\n    case 'table': {\n      const head = `| ${block.head.map(escapeMd).join(' | ')} |`;\n      const separator = `| ${block.head.map(() => '---').join(' | ')} |`;\n      const rows = block.rows.map((row) => `| ${row.map((cell) => escapeMd(cell).replace(/\\|/g, '\\\\|')).join(' | ')} |`);\n      return [head, separator, ...rows].join('\\n');\n    }\n    default:\n      return '';\n  }\n}\n\nfunction buildMarkdown(): string {\n  const groups = wikiGroups();\n  const toc = groups\n    .map(({ group, sections }) => [\n      `**${group}**`,\n      '',\n      ...sections.map((section) => `- [${escapeMd(section.title)}](#${githubSlug(section.title)})`),\n      '',\n    ].join('\\n'))\n    .join('\\n');\n\n  const body = WIKI_SECTIONS\n    .map((section) => [\n      `## ${escapeMd(section.title)}`,\n      '',\n      `_${escapeMd(section.summary)}_`,\n      '',\n      section.blocks.map(renderBlock).join('\\n\\n'),\n      '',\n    ].join('\\n'))\n    .join('\\n---\\n\\n');\n\n  return [\n    '# Wiki del modulo Accessi',\n    '',\n    '> Documento generato automaticamente da `src/accessi-service/console/wiki.ts` (la stessa fonte della Wiki nella console).',\n    '> Non modificarlo a mano: esegui `npm run generate:accessi-wiki`.',\n    '',\n    'La stessa documentazione è disponibile, resa in modo interattivo, nella console Accessi su `/api/accessi/console/wiki`.',\n    'Per una versione compatta da fornire a un\\'IA che costruisce il backend integratore, vedi [`WIKI.ai.md`](WIKI.ai.md).',\n    '',\n    'Percorsi per ruolo: [`docs/README.md`](docs/README.md) · quickstart [`service`](docs/quickstart-service.md), [`resource server`](docs/quickstart-resource-server.md), [`frontend`](docs/quickstart-frontend.md).',\n    '',\n    '## Indice',\n    '',\n    toc,\n    '---',\n    '',\n    body,\n  ].join('\\n').replace(/\\n{3,}/g, '\\n\\n');\n}\n\nconst aiHeader = [\n  '<!-- Documento generato automaticamente da src/accessi-service/console/wiki.ts. Non modificare a mano: npm run generate:accessi-wiki. -->',\n  '',\n  '# Guida compatta per l\\'IA',\n  '',\n  'Versione sintetica della wiki, pensata per essere incollata a un\\'IA che costruisce il backend integratore.',\n  'Disponibile anche nella console con il pulsante \"Copia per AI\" (`/api/accessi/console/wiki`).',\n  '',\n  'Il contenuto è racchiuso in un blocco di codice per essere copiato verbatim, senza interpretazione Markdown.',\n  '',\n].join('\\n');\n\n// Fence a quattro backtick: il digest contiene fence a tre backtick che restano letterali.\nwriteFileSync(join(REPO_ROOT, 'WIKI.md'), buildMarkdown(), 'utf8');\nwriteFileSync(join(REPO_ROOT, 'WIKI.ai.md'), `${aiHeader}\\n\\`\\`\\`\\`text\\n${buildAiDigest()}\\n\\`\\`\\`\\`\\n`, 'utf8');\nprocess.stdout.write('Wiki generata: WIKI.md e WIKI.ai.md\\n');\n"]}

package/docs/README.md

@@ -0,0 +1,116 @@
+# Documentazione Accessi
+
+Accessi è il servizio di identità di `emilsoftware-utilities`: autenticazione
+JWT, autorizzazione per menu, utenti, ruoli, 2FA, SSO, token macchina-a-macchina
+e console amministrativa.
+
+Questa pagina è il punto di partenza. Scegli il tuo ruolo: ogni percorso indica
+cosa leggere e quale entry point usare.
+
+## Da dove iniziare
+
+| Sei... | Parti da | Poi leggi |
+| --- | --- | --- |
+| Sviluppatore frontend | [Quickstart frontend](quickstart-frontend.md) | [WIKI.md](../WIKI.md#login-refresh-2fa-e-reset-password), [auth-cookies.md](auth-cookies.md) |
+| Backend che possiede il database Accessi | [Quickstart servizio](quickstart-service.md) | [standalone-service.md](standalone-service.md), [WIKI.md](../WIKI.md#deploy-del-servizio) |
+| Backend fratello (resource server) | [Quickstart resource server](quickstart-resource-server.md) | [WIKI.md](../WIKI.md#resource-server-e-introspection), [proxy-ip.md](proxy-ip.md) |
+| Console o tool amministrativo | [WIKI.md](../WIKI.md#console-amministrativa) | [WIKI.md](../WIKI.md#utenti), [WIKI.md](../WIKI.md#ruoli-e-permessi) |
+| Operations / SRE | [WIKI.md](../WIKI.md#deploy-del-servizio) | [standalone-service.md](standalone-service.md), [metrics.md](metrics.md), [audit.md](audit.md) |
+| DBA | [WIKI.md](../WIKI.md#schema-e-aggiornamento-del-database) | [WIKI.md](../WIKI.md#catalog-migrations-sql) |
+| Sicurezza / compliance | [WIKI.md](../WIKI.md#hardening-e-checklist-di-sicurezza) | [security-headers.md](security-headers.md), [jwt-key-rotation.md](jwt-key-rotation.md) |
+| Multi-tenant | [WIKI.md](../WIKI.md#multi-tenancy-operativa) | [multi-tenancy.md](multi-tenancy.md), [deploy/README.md](../deploy/README.md) |
+| Migrazione da V1 o da Accessi embedded | [import-migration.md](import-migration.md) | [WIKI.md](../WIKI.md#versioni-migrazioni-e-deprecazioni) |
+| Agente AI | [WIKI.ai.md](../WIKI.ai.md) | [integration-prompt.md](../integration-prompt.md) |
+
+## Come è organizzato il progetto
+
+Accessi ha due livelli distinti:
+
+| Livello | Percorso | Contenuto |
+| --- | --- | --- |
+| Facciata pubblica | `src/accessi/` | Entry point esportati: `server`, `client`, `contracts`, `resource-server`, `openapi`, `console`, `ui` |
+| Implementazione | `src/accessi-service/` | Modulo Nest, controller, service, DTO, database, console, sicurezza, tenancy |
+
+I consumer importano solo `emilsoftware-utilities/accessi/*`. Il codice
+applicativo e i dettagli interni vivono in `src/accessi-service/`.
+La regola completa è in [conventions.md](conventions.md#layout-di-accessi).
+
+## Entry point
+
+| Import | Quando usarlo |
+| --- | --- |
+| `emilsoftware-utilities/accessi/server` | Backend che possiede Accessi: modulo Nest, bootstrap Express, updater DB, migrazioni, console, health |
+| `emilsoftware-utilities/accessi/resource-server` | Backend fratello: middleware Express, guard Nest, verifica JWT e introspection |
+| `emilsoftware-utilities/accessi/client` | Client OpenAPI completo; strumenti interni e compatibilità |
+| `emilsoftware-utilities/accessi/client/public` | Solo API pubbliche: login, refresh, 2FA, reset password, registrazione, ticket console |
+| `emilsoftware-utilities/accessi/client/admin` | Solo API amministrative: utenti, ruoli, menu, filtri, SSO, schema, audit |
+| `emilsoftware-utilities/accessi/client/service` | Solo API service-to-service: service token e introspezione. Mai nel browser |
+| `emilsoftware-utilities/accessi/contracts` | Tipi, enum e helper puri browser-safe |
+| `emilsoftware-utilities/accessi/contracts/dtos` | DTO Nest con `class-validator`; solo backend |
+| `emilsoftware-utilities/accessi/openapi` | `setupOpenApi` e merge del documento OpenAPI |
+| `emilsoftware-utilities/accessi/console` | URL console, ticket e handoff 2FA |
+| `emilsoftware-utilities/accessi/ui` | Percorsi degli asset Web Component frameworkless |
+
+Il root import `emilsoftware-utilities` e i deep import restano supportati fino
+alla prossima major, ma sono legacy. La mappa di migrazione è in
+[import-migration.md](import-migration.md).
+
+## Regole non negoziabili
+
+- Un solo Accessi Service possiede database, `encryptionKey`, SMTP, chiavi JWT e console.
+- I backend fratelli non hanno credenziali del database Accessi: usano `accessi/resource-server`.
+- Non montare `AccessiModule` in due backend puntati allo stesso database.
+- In multi-servizio usa RS256/ES256 con JWKS; HS256 con segreto condiviso è solo transitorio.
+- Configura `issuer` e `audience` espliciti per ambiente.
+- Non inserire JWT, ticket console, service token, password o chiavi nei log e negli URL.
+- Service token con lo scope minimo e mai nel browser.
+- In multi-istanza configura gli store Redis: ticket, revoche e rate limit devono essere condivisi.
+- Le richieste con introspection o JWKS non raggiungibili falliscono chiuse.
+
+## Mappa dei documenti
+
+| Documento | Contenuto | Pubblico |
+| --- | --- | --- |
+| [WIKI.md](../WIKI.md) | Guida completa generata dalla console: percorsi, bootstrap, configurazione, autenticazione, autorizzazione, frontend, dominio, console, operazioni, FAQ e glossario | Tutti |
+| [WIKI.ai.md](../WIKI.ai.md) | Digest compatto in un blocco copiabile | Agenti AI |
+| [integration-prompt.md](../integration-prompt.md) | Contesto completo e prompt operativi per backend, frontend e agenti | Integratori e AI |
+| [quickstart-service.md](quickstart-service.md) | Bootstrap minimo del servizio che possiede Accessi | Backend owner |
+| [quickstart-resource-server.md](quickstart-resource-server.md) | Proteggere un backend fratello | Backend fratelli |
+| [quickstart-frontend.md](quickstart-frontend.md) | Login, refresh, 2FA e chiamate ai backend | Frontend |
+| [standalone-service.md](standalone-service.md) | Avvio standalone, systemd, health, shutdown | Operations |
+| [multi-tenancy.md](multi-tenancy.md) | Tenant, configurazione, supervisore, hot reload, router, store | Operations e architetti |
+| [audit.md](audit.md) | Audit persistente, sink, retention, export | Sicurezza e operations |
+| [metrics.md](metrics.md) | Metriche Prometheus e alert | Operations |
+| [auth-cookies.md](auth-cookies.md) | Cookie HttpOnly, CSRF, CORS | Frontend e backend |
+| [security-headers.md](security-headers.md) | Header di sicurezza e CSP | Backend e sicurezza |
+| [jwt-key-rotation.md](jwt-key-rotation.md) | Rotazione chiavi e JWKS | Sicurezza e operations |
+| [proxy-ip.md](proxy-ip.md) | IP reali, `trust proxy`, rate limit | Operations |
+| [gateway-rate-limit.md](gateway-rate-limit.md) | Rate limit al gateway | Operations |
+| [redis-load-testing.md](redis-load-testing.md) | Test di carico e concorrenza Redis | Sviluppatori e operations |
+| [import-migration.md](import-migration.md) | Migrazione agli entry point e deprecazioni | Integratori |
+| [conventions.md](conventions.md) | Naming, layout e pulizia del repository | Contributori |
+| [adr/0001-split-package.md](adr/0001-split-package.md) | Decisione sullo split in pacchetti | Architetti |
+| [adr/0002-multi-tenancy.md](adr/0002-multi-tenancy.md) | Decisione sulla multi-tenancy | Architetti |
+
+## Compatibilità
+
+- Node.js 18 o superiore.
+- Firebird/InterBase 2.5 o superiore.
+- Package CommonJS con export map esplicita; gli import ESM funzionano per interop.
+- `sideEffects` limitato a root barrel, `firebirdCompat` e bundle console.
+- Le versioni `2.0.0-dev.N` sono pubblicate su `@dev`; il merge su `main` produce la stabile.
+
+## Verifiche prima di un rilascio
+
+```bash
+npm run typecheck
+npm test
+npm run build
+npm run test:pack
+npm run check:naming
+npm run check:deploy
+npm run check:accessi-openapi
+```
+
+Se modifichi intenzionalmente il contratto OpenAPI, aggiorna il fingerprint con
+`npm run accessi:update-openapi-fingerprint` e includilo nel commit.

package/docs/adr/0002-multi-tenancy.md

@@ -173,9 +173,11 @@ Negative:
 3. **Fase 3**: migrazione del deployment single-tenant esistente: creare
    `tenants/<id>.environment.ts` dalla configurazione attuale, avviare in parallelo, spostare il DNS,
    spegnere il vecchio servizio.
-4. **Fase 4 (opzionale)**: router in-process con `createAccessiTenantRouter`
-   solo se il costo dei processi diventa un problema e dopo test di leakage
-   dedicati; richiede audit/metriche per istanza, non globali.
+4. **Fase 4 (opt-in, implementata come building block)**: router in-process
+   `createAccessiTenantRouter` con contesto `runWithAccessiTenant`, audit e
+   metriche per tenant. Le app Accessi restano indipendenti e il
+   processo-per-tenant resta il default; le API globali (`authorizeAccessi`)
+   non sono tenant-aware e non vanno usate in questa modalità.
 
 ## Migrazione
 

package/docs/audit.md

@@ -1,5 +1,9 @@
 # Audit persistente
 
+Per sicurezza, compliance e operations. Indice completo della documentazione in
+[README.md](README.md); panoramica delle operazioni in
+[WIKI.md](../WIKI.md#health-metriche-e-audit).
+
 `auditAccessi` scrive un record strutturato per ogni evento di sicurezza. Di
 default il record finisce nel log (`AccessiAudit`); con `audit.sinks` può essere
 persistito su Redis, inoltrato a un collector HTTP o scritto su database e

package/docs/auth-cookies.md

@@ -1,5 +1,9 @@
 # Autenticazione via cookie httpOnly e CSRF
 
+Per frontend e backend che non possono custodire un access token in memoria.
+Indice completo in [README.md](README.md); flusso browser in
+[quickstart-frontend.md](quickstart-frontend.md).
+
 Bearer resta il default: nessun comportamento cambia finché non si abilita
 esplicitamente la modalità cookie.
 

package/docs/conventions.md

@@ -0,0 +1,86 @@
+# Convenzioni di nomenclatura
+
+Per chi contribuisce al repository. Indice della documentazione per ruolo in
+[README.md](README.md).
+
+Regole applicate a tutto il repository e verificate da `npm run check:naming`
+in CI.
+
+## Cartelle
+
+- `src/`, `scripts/`, `test/`, `docs/`, `deploy/`: **kebab-case**
+  (`database-updates`, `federated-auth`, `angular-components`).
+- Eccezioni: directory generate (`generated`) e nomi convenzionali con punto
+  (`.github`, `.vscode`).
+- Non creare nuove cartelle PascalCase o camelCase.
+
+## Layout di Accessi
+
+Accessi è diviso in due livelli con responsabilità diverse:
+
+- `src/accessi/`: **facciata pubblica**. Contiene solo gli entry point
+  esportati in `package.json#exports` (`accessi/server`, `accessi/client`,
+  `accessi/contracts`, `accessi/resource-server`, `accessi/openapi`,
+  `accessi/console`, `accessi/ui`). Non contiene implementazione: riesporta,
+  adatta e documenta.
+- `src/accessi-service/`: **implementazione del servizio**. Contiene il modulo
+  Nest, controller, service, DTO, migrazioni database, console, sicurezza,
+  tenancy e osservabilità.
+
+Regola: il codice applicativo vive in `accessi-service`; se un consumer deve
+importarlo, va esposto da un entry point in `accessi/`. Non importare
+`src/accessi-service/...` direttamente da fuori del pacchetto.
+
+## File
+
+### `src/`
+
+- **PascalCase** per file il cui export principale è una classe: controller,
+  service, DTO, guard, filter.
+  Esempi: `AuthController.ts`, `JwtSimpleGuard.ts`, `UserDto.ts`.
+- **camelCase** per moduli, helper, factory e file di bootstrap:
+  `tenantSupervisor.ts`, `accessiOptionsFromEnv.ts`, `readiness.ts`.
+- Niente punti nel nome, salvo dichiarazioni ambientali (`.d.ts`).
+- `index.ts` è ammesso come barrel.
+- File generati (`**/generated/**`) e migrazioni SQL (`V1.0.0_to_V1.1.0.sql`)
+  sono esclusi.
+
+### `scripts/`, `test/`, `docs/`, `deploy/`
+
+- **kebab-case** con eventuali segmenti separati da punto:
+  `redis-load.integration.cjs`, `docker-compose.test.yml`.
+- Eccezioni documentali: `README.md`, `CHANGELOG.md`, `WIKI.md`, `WIKI.ai.md`.
+- `index.ts` è ammesso per entry point generati.
+
+### Root
+
+- File convenzionali in maiuscolo: `README.md`, `CHANGELOG.md`, `WIKI.md`,
+  `WIKI.ai.md`, `LICENSE`, `SECURITY.md`.
+- Configurazione in minuscolo/kebab: `package.json`, `tsconfig.json`,
+  `docker-compose.test.yml`.
+- Nessun artefatto locale o IDE tracciato.
+
+## Pulizia
+
+Non vanno versionati:
+
+- `.DS_Store`, `.idea/`, `.vscode/settings.json`;
+- `*.tsbuildinfo`, `*.tgz`, `*.log`;
+- `dist/`, `node_modules/`, `logs/`;
+- output generati già coperti da `.gitignore`.
+
+## Migrazione
+
+1. Rinominare con `git mv` (mai copiare/incollare).
+2. Aggiornare import, `package.json#exports`, config e documentazione.
+3. Non cambiare comportamento: la rinomina è un refactor separato.
+4. Eseguire `npm run typecheck`, `npm test`, `npm run build` e `npm run test:pack`.
+
+## Verifica
+
+```bash
+npm run check:naming
+```
+
+Lo script controlla i file tracciati da Git, quindi ignora automaticamente
+`dist/`, `node_modules/` e gli altri path in `.gitignore`.

package/docs/gateway-rate-limit.md

@@ -1,5 +1,8 @@
 # Gateway rate limit per Accessi Service
 
+Per operations e sicurezza. Indice completo in [README.md](README.md); rate
+limit applicativo in [WIKI.md](../WIKI.md#store-condivisi-e-multi-istanza).
+
 Il rate limit applicativo di Accessi protegge login, 2FA, reset password, console entry e service token. Il gateway/API gateway resta utile per una protezione per IP, connessioni e bot prima che la richiesta raggiunga Node.
 
 Regole consigliate:

package/docs/import-migration.md

@@ -1,18 +1,24 @@
 # Migrazione agli entry point Accessi
 
+Per chi aggiorna da V1, dal root barrel o dai deep import. Indice completo in
+[README.md](README.md); percorso di upgrade in
+[WIKI.md](../WIKI.md#versioni-migrazioni-e-deprecazioni).
+
 Il root barrel (`emilsoftware-utilities`) e i deep import
-(`emilsoftware-utilities/dist/accessi-module/...`) restano supportati **fino
-alla prossima major**. Da questa minor sono considerati legacy: i consumer
+(`emilsoftware-utilities/dist/accessi-service/...`) restano supportati **fino
+alla prossima major**. Il layout interno è cambiato: la vecchia cartella
+`dist/accessi-module` ora è `dist/accessi-service`; i subpath pubblici
+(`emilsoftware-utilities/accessi/*`) non cambiano. Da questa minor sono considerati legacy: i consumer
 devono passare agli entry point dichiarati in `package.json#exports`.
 
 ## Mappa consigliata
 
 | Uso | Import consigliato | Legacy |
 | --- | --- | --- |
-| Avvio Accessi Service | `emilsoftware-utilities/accessi/server` | root barrel, `dist/accessi-module` |
-| Contratti e helper browser-safe | `emilsoftware-utilities/accessi/contracts` | `dist/accessi-module/Dtos` |
-| DTO Nest con validazione | `emilsoftware-utilities/accessi/contracts/dtos` | `dist/accessi-module/Dtos` |
-| Verifica JWT in un backend fratello | `emilsoftware-utilities/accessi/resource-server` | `dist/accessi-module/...` |
+| Avvio Accessi Service | `emilsoftware-utilities/accessi/server` | root barrel, `dist/accessi-service` |
+| Contratti e helper browser-safe | `emilsoftware-utilities/accessi/contracts` | `dist/accessi-service/dtos` |
+| DTO Nest con validazione | `emilsoftware-utilities/accessi/contracts/dtos` | `dist/accessi-service/dtos` |
+| Verifica JWT in un backend fratello | `emilsoftware-utilities/accessi/resource-server` | `dist/accessi-service/...` |
 | Client OpenAPI completo | `emilsoftware-utilities/accessi/client` | root barrel |
 | Client solo API pubbliche | `emilsoftware-utilities/accessi/client/public` | — |
 | Client solo API admin | `emilsoftware-utilities/accessi/client/admin` | — |

package/docs/jwt-key-rotation.md

@@ -1,5 +1,8 @@
 # Rotazione delle chiavi JWT
 
+Per sicurezza e operations. Indice completo in [README.md](README.md);
+procedura di upgrade in [WIKI.md](../WIKI.md#versioni-migrazioni-e-deprecazioni).
+
 Accessi firma gli access token (e i refresh token, se abilitati) con una chiave
 corrente e pubblica le chiavi pubbliche nella JWKS. La rotazione non deve
 invalidare i token gia emessi: durante il rollout la JWKS contiene la chiave

package/docs/metrics.md

@@ -1,5 +1,8 @@
 # Metriche e alert
 
+Per operations e SRE. Indice completo in [README.md](README.md); checklist
+operativa in [WIKI.md](../WIKI.md#health-metriche-e-audit).
+
 Accessi espone metriche di dominio in formato Prometheus. Il servizio standalone
 le include in `/health/metrics` insieme alle metriche HTTP di base; un host
 Nest/Express può montare `renderAccessiMetrics()` su una propria rotta protetta.

package/docs/multi-tenancy.md

@@ -1,5 +1,11 @@
 # Multi-tenancy operativa
 
+Questa guida è per chi deve isolare più clienti sullo stesso Accessi. Se ti
+serve un solo database per tutte le applicazioni, non usare la multi-tenancy:
+un Accessi Service con più backend resource server è più semplice e sufficiente
+per la maggior parte dei casi. La mappa completa della documentazione è in
+[README.md](README.md).
+
 Accessi supporta più tenant con **un database per tenant** e un processo di
 servizio per tenant. La configurazione sta in una cartella di file
 `*.environment.ts` tipizzati; la decisione architetturale è in
@@ -275,6 +281,54 @@ proxy_set_header X-Accessi-Tenant acme;
 e avviare il router con `allowHeader: true` solo nel servizio che si fida del
 proxy.
 
+## Router in-process (opt-in, fase 4)
+
+In alternativa al processo per tenant, un host può montare più app Accessi nello
+stesso processo e usare `createAccessiTenantRouter`:
+
+```ts
+import {
+  configureAccessiTenantAudit,
+  createAccessiService,
+  createAccessiTenantRouter,
+  loadAccessiTenants,
+} from 'emilsoftware-utilities/accessi/server';
+
+const registry = loadAccessiTenants({ directory: './tenants' });
+const acmeService = await createAccessiService({ accessiOptions: acmeOptions });
+const betaService = await createAccessiService({ accessiOptions: betaOptions });
+
+configureAccessiTenantAudit('acme', { store: acmeAuditStore, logger: false });
+configureAccessiTenantAudit('beta', { store: betaAuditStore, logger: false });
+
+const router = createAccessiTenantRouter({
+  registry,
+  handlers: { acme: acmeService.app, beta: betaService.app },
+  allowHeader: false,
+});
+app.use('/api/accessi', router);
+```
+
+Comportamento:
+
+- risoluzione host → path → header fidato, senza fallback;
+- `req.accessiTenant` contiene il tenant risolto;
+- il handler gira dentro `runWithAccessiTenant`, quindi audit e metriche
+  ricevono il label `tenant`;
+- tenant sconosciuto → `404 ACCESSI_TENANT_NOT_FOUND`;
+- tenant senza handler → `501 ACCESSI_TENANT_HANDLER_MISSING`.
+
+Limiti importanti:
+
+- le app devono essere indipendenti (un `createAccessiService` per tenant);
+- le API globali `authorizeAccessi` e `setAccessiAuthService` usano l'ultima
+  istanza inizializzata: in modalità router non sono tenant-aware e vanno
+  evitate; usare i guard/middleware dell'app del tenant;
+- audit e metriche di background (fuori da una richiesta) usano la
+  configurazione di default del processo;
+- il processo-per-tenant resta il default raccomandato: il router è opt-in e
+  non riduce i pool Firebird se le app sono comunque tutte inizializzate.
+
 ## Store Redis condivisi
 
 Con Redis condiviso usare l'helper: crea tutti gli store con prefissi

package/docs/proxy-ip.md

@@ -1,5 +1,9 @@
 # IP reali dietro proxy
 
+Per operations: rate limit, audit e revoca dipendono da `req.ip`. Indice completo
+in [README.md](README.md); deploy e proxy in
+[WIKI.md](../WIKI.md#deploy-del-servizio).
+
 Rate limit, audit e revoca usano `req.ip`. Se il servizio sta dietro un load balancer o un reverse
 proxy, `req.ip` e l'indirizzo del proxy finche `http.trustProxy` non e configurato correttamente:
 
@@ -18,6 +22,10 @@ e accetta la stessa sintassi di Express: `false`, numero di hop, `true`, `'loopb
 | Servizio esposto direttamente | `false` (default) | `X-Forwarded-For` viene ignorato: nessun bypass via header |
 | Un proxy davanti (Nginx, Traefik, ALB) | `1` | Il proxy deve **accodare** l'IP reale in `X-Forwarded-For` |
 | Due proxy (Cloudflare + Nginx, CDN + ingress) | `2` | Contare solo i proxy che il servizio vede davvero |
+
+Nel servizio standalone il valore si imposta anche con
+`ACCESSI_HTTP_TRUST_PROXY` (per esempio `1`). Un valore non valido blocca
+l'avvio.
 | Solo proxy locali | `'loopback'` | Fidarsi di `127.0.0.1`/`::1`, non di altre reti |
 | Rete privata dedicata ai proxy | `'loopback, 10.0.0.0/8'` | Elencare le CIDR dei proxy, non usare `true` |
 | `trustProxy: true` | **sconsigliato** | Fidarsi di tutti gli hop rende scegliibile dal client il valore piu a sinistra |