@mostajs/orm-samples 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog — `@mostajs/orm-samples`
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] — 2026-05-25
+
+### Added — Lot 1 : Fondamentaux (5 samples)
+
+- **`01-quickstart-sqlite`** — Pattern de base reproduisant le snippet
+  `## PATTERN` du llms.txt @mostajs/orm. Démontre : `createConnection`,
+  `BaseRepository`, `EntitySchema`, `FieldType`, `FieldDef`, `create`,
+  `findOne`, `ConnectionConfig`, `SchemaStrategy: 'update'`.
+
+- **`02-multi-dialect-switch`** — Un seul code TypeScript, dialect changé
+  via `.env`. Démontre : `getConfigFromEnv`, `DialectType`, `ConnectionConfig`,
+  `SchemaStrategy`, `DIALECT_CONFIGS`, `getSupportedDialects`,
+  `getDialectConfig`, `DialectConfig`, `getCurrentDialectType`.
+
+- **`03-isolated-connections`** — Multi-tenant via `createIsolatedDialect`
+  + named connections. Démontre : `createIsolatedDialect`, `getDialect`
+  singleton (piège), `registerNamedConnection`, `getNamedConnection`,
+  `listNamedConnections`, `clearNamedConnections`.
+
+- **`04-schema-registry`** — Registre global de schémas. Démontre :
+  `registerSchema`, `registerSchemas`, `getSchema`, `getSchemaByCollection`,
+  `getAllSchemas`, `getEntityNames`, `hasSchema`, `validateSchemas`,
+  `clearRegistry`.
+
+- **`05-types-cles-entity-schema`** — Tous les champs `EntitySchema` au moins
+  une fois. Démontre : `EntitySchema`, `FieldDef` exhaustif, `FieldType`
+  (string/text/number/boolean/date/json/array), `EmbeddedSchemaDef`,
+  `IndexDef`, `IndexType` (asc/desc/text), `discriminator`, `softDelete`,
+  `timestamps`.
+
+### Added — Scaffold module
+
+- `package.json` (peer dep `@mostajs/orm ≥ 2.1.0`, bin `mostajs-orm-samples`)
+- `tsconfig.json` strict
+- `src/cli.ts` — CLI `list | scaffold | check | help`
+- `README.md`, `llms.txt`, `LICENSE` (AGPL-3.0-or-later)
+- `.gitignore` (exclut `examples/**/node_modules`, `*.db`, etc.)
+
+### Décisions design
+
+- Module npm séparé de `@mostajs/orm` (peer dep)
+- Substitut public des tests internes (qui restent propriétaires entreprise —
+  cf. règle `feedback_public_vs_private_repo`)
+- Chaque sample est autonome : `npm install` dans le sample lui-même quand
+  l'utilisateur le copie
+- Default SQLite (zéro install externe) ; alternatives Postgres/MySQL
+  commentées dans `.env.example`
+
+**Author** : Dr Hamid MADANI <drmdh@msn.com>

package/LICENSE

@@ -0,0 +1,29 @@
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (c) 2026 Dr Hamid MADANI <drmdh@msn.com>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+COMMERCIAL LICENSE
+
+For organizations that cannot comply with the AGPL open-source requirements,
+a commercial license is available. Contact: drmdh@msn.com
+
+The commercial license allows you to:
+- Use the software in proprietary/closed-source projects
+- Modify without publishing your source code
+- Get priority support and SLA
+
+Contact: Dr Hamid MADANI <drmdh@msn.com>

package/README.md

@@ -0,0 +1,78 @@
+# `@mostajs/orm-samples`
+
+> Runnable samples covering 100% of `@mostajs/orm`'s public API — copy-paste install per feature.
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com>
+**Statut** : V1 — Lot 1 (samples 01-05) livré
+
+---
+
+## Pourquoi ce module ?
+
+Chaque sample démontre **une fonctionnalité** de `@mostajs/orm` en moins de
+100 lignes de code, runnable en une commande, **sans framework parasite**
+(pas d'Express, pas de Next.js — juste l'ORM).
+
+Couverture cible : **chaque ligne du `llms.txt` de `@mostajs/orm` est démontrée
+par au moins un sample** (garde-fou via test pérenne).
+
+## Install rapide
+
+```bash
+# 1. Lister tous les samples
+npx @mostajs/orm-samples list
+
+# 2. Scaffolder un sample chez vous
+npx @mostajs/orm-samples scaffold <feature> ~/my-app
+
+# 3. Lancer
+cd ~/my-app && ./<feature>.sh
+```
+
+## Pattern d'install copier-coller (par feature)
+
+Chaque sample s'installe via 4 commandes :
+
+```bash
+# 1. Install package (cwd ne compte pas — temporaire)
+mkdir tmp && cd tmp && npm init -y && npm install @mostajs/orm-samples
+
+# 2. Copy the scaffold to your project location
+cp -r node_modules/@mostajs/orm-samples/examples/<feature> ~/my-<feature>-app
+cd ~/my-<feature>-app
+rm -rf ../tmp
+
+# 3. Install external resources éventuelles (driver SGBD, ffmpeg, etc.)
+sudo apt install <package>           # ou : brew install <package>
+
+# 4. Launch (auto-handles npm install)
+./<feature>.sh
+```
+
+## Catalogue (Lot 1 — Fondamentaux)
+
+| # | Sample | Démontre |
+|---|---|---|
+| 01 | [`01-quickstart-sqlite`](examples/01-quickstart-sqlite/) | Pattern de base : `createConnection` + `BaseRepository` + `create` + `findOne` |
+| 02 | [`02-multi-dialect-switch`](examples/02-multi-dialect-switch/) | `getConfigFromEnv` + `DialectType` + `DIALECT_CONFIGS` — un seul code, plusieurs SGBD |
+| 03 | [`03-isolated-connections`](examples/03-isolated-connections/) | `createIsolatedDialect` + connexions nommées pour multi-tenant |
+| 04 | [`04-schema-registry`](examples/04-schema-registry/) | Registre global `registerSchema`/`getSchema`/`validateSchemas`/`clearRegistry` |
+| 05 | [`05-types-cles-entity-schema`](examples/05-types-cles-entity-schema/) | Tous les `FieldType`/`FieldDef`/`IndexDef` + `softDelete` + `discriminator` |
+
+Lots suivants (cf. ROADMAP propriétaire entreprise) : CRUD & queries (06-09),
+Relations & lifecycle (10-15), Plugins & sous-modules (16-18), Validator
+& erreurs (19-25).
+
+## CLI `mostajs-orm-samples`
+
+```bash
+mostajs-orm-samples list                       # liste les samples
+mostajs-orm-samples list --json                # machine-readable
+mostajs-orm-samples scaffold <feature> [dest]  # copie le scaffold
+mostajs-orm-samples check <feature>            # ressources requises
+mostajs-orm-samples help [feature]             # aide globale ou par sample
+```
+
+## Licence
+
+AGPL-3.0-or-later — voir [LICENSE](LICENSE).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+// @mostajs/orm-samples — CLI
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+//
+// Commands :
+//   mostajs-orm-samples list [--json]
+//   mostajs-orm-samples scaffold <feature> [dest]
+//   mostajs-orm-samples check <feature>
+//   mostajs-orm-samples help [feature]
+import { readdirSync, statSync, readFileSync, cpSync, existsSync, mkdirSync } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const examplesDir = resolve(__dirname, '..', 'examples');
+function listSamples() {
+    if (!existsSync(examplesDir))
+        return [];
+    const entries = readdirSync(examplesDir).filter((e) => {
+        if (e.startsWith('_'))
+            return false;
+        const full = join(examplesDir, e);
+        try {
+            return statSync(full).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+    entries.sort();
+    return entries.map((id) => {
+        const readmePath = join(examplesDir, id, 'README.md');
+        let pitch = '';
+        let covers = '';
+        if (existsSync(readmePath)) {
+            const content = readFileSync(readmePath, 'utf-8');
+            const pitchMatch = content.match(/^>\s+(.+)$/m);
+            pitch = pitchMatch ? pitchMatch[1].trim() : '';
+            const coversMatch = content.match(/^\*\*Couvre\*\*\s*:\s*(.+)$/m);
+            covers = coversMatch ? coversMatch[1].trim() : '';
+        }
+        return { id, name: id, pitch, covers };
+    });
+}
+function cmdList(args) {
+    const samples = listSamples();
+    const json = args.includes('--json');
+    if (json) {
+        console.log(JSON.stringify(samples, null, 2));
+        return;
+    }
+    if (samples.length === 0) {
+        console.log('No samples found.');
+        return;
+    }
+    console.log(`\nAvailable samples (${samples.length}):\n`);
+    for (const s of samples) {
+        const pitch = s.pitch || '(no pitch)';
+        console.log(`  ${s.id.padEnd(36)} ${pitch}`);
+    }
+    console.log('');
+    console.log(`Run \`mostajs-orm-samples help <feature>\` for details.`);
+    console.log(`Run \`mostajs-orm-samples scaffold <feature> [dest]\` to copy a sample.`);
+}
+function cmdScaffold(args) {
+    const feature = args[0];
+    if (!feature) {
+        console.error('Usage: mostajs-orm-samples scaffold <feature> [dest]');
+        process.exit(2);
+    }
+    const src = join(examplesDir, feature);
+    if (!existsSync(src)) {
+        console.error(`Sample '${feature}' not found. Run \`mostajs-orm-samples list\` to see available samples.`);
+        process.exit(1);
+    }
+    const dest = resolve(args[1] ?? join(process.cwd(), `my-${feature}-app`));
+    if (existsSync(dest)) {
+        console.error(`Destination '${dest}' already exists. Refusing to overwrite.`);
+        process.exit(1);
+    }
+    mkdirSync(dirname(dest), { recursive: true });
+    cpSync(src, dest, { recursive: true });
+    console.log(`\n✅ Scaffolded '${feature}' to:\n   ${dest}\n`);
+    console.log('Next steps:');
+    console.log(`   cd ${dest}`);
+    // Hint pour ressources externes éventuelles
+    const readmePath = join(dest, 'README.md');
+    if (existsSync(readmePath)) {
+        const content = readFileSync(readmePath, 'utf-8');
+        const extMatch = content.match(/## External resources\n([\s\S]*?)(?=\n##|$)/i);
+        if (extMatch && !/aucun/i.test(extMatch[1])) {
+            console.log('');
+            console.log('External resources required (cf. README.md):');
+            console.log(extMatch[1].trim().split('\n').map((l) => '   ' + l).join('\n'));
+        }
+    }
+    console.log('');
+    console.log(`   ./${feature}.sh        # launch sample`);
+    console.log('');
+}
+function cmdCheck(args) {
+    const feature = args[0];
+    if (!feature) {
+        console.error('Usage: mostajs-orm-samples check <feature>');
+        process.exit(2);
+    }
+    const readmePath = join(examplesDir, feature, 'README.md');
+    if (!existsSync(readmePath)) {
+        console.error(`Sample '${feature}' not found.`);
+        process.exit(1);
+    }
+    const content = readFileSync(readmePath, 'utf-8');
+    const extMatch = content.match(/## External resources\n([\s\S]*?)(?=\n##|$)/i);
+    if (!extMatch || /aucun/i.test(extMatch[1])) {
+        console.log(`Sample '${feature}': aucune ressource externe requise.`);
+        return;
+    }
+    console.log(`Sample '${feature}' — external resources required :\n`);
+    console.log(extMatch[1].trim());
+}
+function cmdHelp(args) {
+    const feature = args[0];
+    if (feature) {
+        const readmePath = join(examplesDir, feature, 'README.md');
+        if (!existsSync(readmePath)) {
+            console.error(`Sample '${feature}' not found.`);
+            process.exit(1);
+        }
+        console.log(readFileSync(readmePath, 'utf-8'));
+        return;
+    }
+    console.log(`
+@mostajs/orm-samples — runnable samples for @mostajs/orm
+
+USAGE
+  mostajs-orm-samples <command> [args]
+
+COMMANDS
+  list [--json]                  List all available samples
+  scaffold <feature> [dest]      Copy a sample to dest (default: ./my-<feature>-app)
+  check <feature>                Show external resources required by the sample
+  help [feature]                 Show this help, or the README of a specific sample
+
+EXAMPLES
+  mostajs-orm-samples list
+  mostajs-orm-samples scaffold 01-quickstart-sqlite
+  mostajs-orm-samples scaffold 02-multi-dialect-switch ~/my-app
+  mostajs-orm-samples check 18-bridge-jdbc
+  mostajs-orm-samples help 09-findbyid-polymorphic
+
+Author: Dr Hamid MADANI <drmdh@msn.com>
+`);
+}
+// ─── Dispatcher ────────────────────────────────────────────────────
+const [cmd, ...args] = process.argv.slice(2);
+switch (cmd) {
+    case 'list':
+        cmdList(args);
+        break;
+    case 'scaffold':
+        cmdScaffold(args);
+        break;
+    case 'check':
+        cmdCheck(args);
+        break;
+    case 'help':
+    case undefined:
+    case '--help':
+    case '-h':
+        cmdHelp(args);
+        break;
+    default:
+        console.error(`Unknown command: ${cmd}`);
+        cmdHelp([]);
+        process.exit(2);
+}

package/examples/01-quickstart-sqlite/.env.example

@@ -0,0 +1,6 @@
+# Default — SQLite local, zéro install externe.
+DB_DIALECT=sqlite
+SGBD_URI=./app.db
+
+# Ce sample ne lit pas .env (config est en dur dans app.ts).
+# Voir sample 02-multi-dialect-switch pour l'usage de getConfigFromEnv().

package/examples/01-quickstart-sqlite/01-quickstart-sqlite.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -e
+cd "$(dirname "$0")"
+
+# ─── Install deps if missing ───
+if [ ! -d node_modules ]; then
+  echo "─── Installing dependencies (first run) ───"
+  npm install --silent --no-audit --no-fund
+fi
+
+# ─── Reset DB for clean re-run ───
+rm -f app.db
+
+# ─── Run sample ───
+npx -y tsx app.ts
+
+# ─── Verify file artefact ───
+if [ ! -f app.db ]; then
+  echo "❌ app.db not created"
+  exit 1
+fi
+
+echo "✓ app.db présent ($(stat -c %s app.db) bytes)"

package/examples/01-quickstart-sqlite/README.md

@@ -0,0 +1,52 @@
+# 01-quickstart-sqlite
+
+> Pattern de base ORM en SQLite — createConnection + BaseRepository + create + findOne.
+
+**Couvre** : `createConnection`, `BaseRepository`, `EntitySchema`, `FieldType`,
+`FieldDef`, `create`, `findOne`, `ConnectionConfig`, `SchemaStrategy: 'update'`.
+
+## Install
+
+```bash
+mkdir tmp && cd tmp && npm init -y && npm install @mostajs/orm-samples
+cp -r node_modules/@mostajs/orm-samples/examples/01-quickstart-sqlite ~/my-quickstart-app
+cd ~/my-quickstart-app
+rm -rf ../tmp
+```
+
+## External resources
+
+aucune *(SQLite via better-sqlite3 inclus en dev dependency)*.
+
+## Run
+
+```bash
+./01-quickstart-sqlite.sh
+```
+
+## Expected output
+
+```
+─── Quickstart SQLite — @mostajs/orm ───
+✓ Connected to SQLite (./app.db)
+✓ User created (id=…)
+✓ findOne by email returned: { id: '…', email: 'alice@example.com', name: 'Alice' }
+✓ count = 1
+✅ Smoke OK
+```
+
+## What it shows
+
+- Le `EntitySchema` minimal (fields + indexes vides + timestamps)
+- L'`createConnection` synchrone avec `SchemaStrategy: 'update'` qui crée la
+  table automatiquement
+- L'instanciation du `BaseRepository<TUser>` typé
+- Le cycle `create()` → `findOne()` → `count()` en 4 lignes
+
+## Files
+
+- `app.ts` — main code
+- `schemas/user.schema.ts` — schéma User minimal
+- `.env.example` — config (DB_DIALECT=sqlite par défaut)
+
+**Author** : Dr Hamid MADANI <drmdh@msn.com>

package/examples/01-quickstart-sqlite/app.ts

@@ -0,0 +1,52 @@
+// Quickstart SQLite — pattern de base de @mostajs/orm.
+//
+// Démontre la séquence minimale :
+//   1. EntitySchema (fields + indexes + timestamps)
+//   2. createConnection(config, [schema])
+//   3. new BaseRepository<TRow>(schema, dialect)
+//   4. create / findOne / count
+//
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+
+import { createConnection, BaseRepository } from '@mostajs/orm'
+import { UserSchema, type UserRow } from './schemas/user.schema.js'
+
+async function main(): Promise<void> {
+  console.log('─── Quickstart SQLite — @mostajs/orm ───')
+
+  // 1. Connexion SQLite. schemaStrategy: 'update' crée/migre les tables.
+  const dialect = await createConnection(
+    { dialect: 'sqlite', uri: './app.db', schemaStrategy: 'update' },
+    [UserSchema],
+  )
+  console.log('✓ Connected to SQLite (./app.db)')
+
+  // 2. BaseRepository typé.
+  const users = new BaseRepository<UserRow>(UserSchema, dialect)
+
+  // 3. Create — insère et retourne le row avec id généré.
+  const created = await users.create({ email: 'alice@example.com', name: 'Alice' })
+  console.log(`✓ User created (id=${created.id})`)
+
+  // 4. findOne — lookup par n'importe quel field, retourne null si absent.
+  const found = await users.findOne({ email: 'alice@example.com' })
+  console.log('✓ findOne by email returned:', { id: found?.id, email: found?.email, name: found?.name })
+
+  // 5. count — total des rows matching le filter.
+  const total = await users.count({})
+  console.log(`✓ count = ${total}`)
+
+  // Assertions smoke pour le .sh
+  if (!found || found.email !== 'alice@example.com') throw new Error('findOne assertion failed')
+  if (total !== 1) throw new Error(`count expected 1, got ${total}`)
+
+  console.log('✅ Smoke OK')
+
+  // Cleanup connexion (le sample se termine, la DB ./app.db reste pour inspection)
+  await dialect.disconnect?.()
+}
+
+main().catch((err) => {
+  console.error('❌ Sample failed:', err)
+  process.exit(1)
+})

package/examples/01-quickstart-sqlite/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "01-quickstart-sqlite",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "tsx app.ts"
+  },
+  "dependencies": {
+    "@mostajs/orm": "^2.1.0",
+    "better-sqlite3": "^12.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/examples/01-quickstart-sqlite/schemas/user.schema.ts

@@ -0,0 +1,27 @@
+// Schéma User minimal — démontre EntitySchema + FieldType + FieldDef.
+// Author: Dr Hamid MADANI <drmdh@msn.com>
+
+import type { EntitySchema } from '@mostajs/orm'
+
+export const UserSchema: EntitySchema = {
+  name: 'User',
+  collection: 'users',
+  // FieldDef avec required + unique. FieldType 'string' parmi
+  // ('string'|'text'|'number'|'boolean'|'date'|'json'|'array').
+  fields: {
+    email: { type: 'string', required: true, unique: true },
+    name:  { type: 'string' },
+  },
+  relations: {},
+  indexes: [],
+  timestamps: true,   // createdAt / updatedAt auto-gérés
+}
+
+// Type pour le BaseRepository<TUser>
+export interface UserRow {
+  id: string
+  email: string
+  name?: string
+  createdAt?: Date
+  updatedAt?: Date
+}

package/examples/02-multi-dialect-switch/.env.example

@@ -0,0 +1,18 @@
+# Default — SQLite local, zéro install externe.
+DB_DIALECT=sqlite
+SGBD_URI=./app.db
+
+# Postgres
+# DB_DIALECT=postgres
+# SGBD_URI=postgresql://postgres:password@localhost:5432/test
+
+# MySQL / MariaDB
+# DB_DIALECT=mysql
+# SGBD_URI=mysql://root:password@localhost:3306/test
+
+# MongoDB
+# DB_DIALECT=mongodb
+# SGBD_URI=mongodb://localhost:27017/test
+
+# Profil pour cascade .env.<profile> via @mostajs/config
+# MOSTA_ENV=production

package/examples/02-multi-dialect-switch/02-multi-dialect-switch.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -e
+cd "$(dirname "$0")"
+
+if [ ! -d node_modules ]; then
+  echo "─── Installing dependencies (first run) ───"
+  npm install --silent --no-audit --no-fund
+fi
+
+# Reset only the local SQLite (les Postgres/MySQL externes ne sont pas reset ici)
+rm -f app.db
+
+npx -y tsx app.ts

package/examples/02-multi-dialect-switch/README.md

@@ -0,0 +1,68 @@
+# 02-multi-dialect-switch
+
+> Un seul code TypeScript, dialect changé via `.env` — démontre la portabilité multi-dialecte de @mostajs/orm.
+
+**Couvre** : `getConfigFromEnv`, `DialectType`, `ConnectionConfig`,
+`SchemaStrategy`, `DIALECT_CONFIGS`, `getSupportedDialects`,
+`getDialectConfig`, `DialectConfig`, `getCurrentDialectType`.
+
+## Install
+
+```bash
+mkdir tmp && cd tmp && npm init -y && npm install @mostajs/orm-samples
+cp -r node_modules/@mostajs/orm-samples/examples/02-multi-dialect-switch ~/my-multi-dialect-app
+cd ~/my-multi-dialect-app
+rm -rf ../tmp
+```
+
+## External resources
+
+- **Default SQLite** : aucune (better-sqlite3 inclus)
+- **Postgres** *(optionnel)* : `brew install postgresql` ou Docker
+  `docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=test postgres:16`
+- **MySQL** *(optionnel)* : `brew install mysql` ou Docker
+  `docker run -d -p 3306:3306 -e MYSQL_ROOT_PASSWORD=test mysql:8`
+
+## Run
+
+```bash
+# Default SQLite :
+./02-multi-dialect-switch.sh
+
+# Postgres :
+DB_DIALECT=postgres SGBD_URI=postgresql://postgres:test@localhost:5432/test ./02-multi-dialect-switch.sh
+
+# MySQL :
+DB_DIALECT=mysql SGBD_URI=mysql://root:test@localhost:3306/test ./02-multi-dialect-switch.sh
+```
+
+## Expected output
+
+```
+─── Multi-dialect switch — @mostajs/orm ───
+Dialects supportés :
+  - sqlite     SQLite (better-sqlite3)
+  - postgres   PostgreSQL (pg)
+  - mysql      MySQL (mysql2)
+  …
+✓ Config courante : { dialect: 'sqlite', uri: './app.db', … }
+✓ Connecté à : sqlite
+✓ User créé sur sqlite (id=…)
+✅ Smoke OK — le même code marche sur n'importe quel dialect.
+```
+
+## What it shows
+
+- `getSupportedDialects()` retourne les 13 dialects connus
+- `getDialectConfig(name)` retourne la métadata d'un dialect (driver, etc.)
+- `getConfigFromEnv()` lit `DB_DIALECT` + `SGBD_URI` (+ cascade MOSTA_ENV)
+- Le **même code applicatif** tourne sur SQLite / Postgres / MySQL en ne
+  changeant que le `.env`
+
+## Files
+
+- `app.ts` — main code (entièrement dialect-agnostic)
+- `schemas/user.schema.ts` — schéma User minimal
+- `.env.example` — 3 dialects commentés
+
+**Author** : Dr Hamid MADANI <drmdh@msn.com>