@lastbrain/app 0.1.34 → 0.1.37

package/src/scripts/module-create.ts

@@ -2,25 +2,39 @@ import fs from "fs-extra";
 import path from "path";
 import chalk from "chalk";
 import inquirer from "inquirer";
+import { fileURLToPath } from "url";
 
-interface PageConfig {
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export interface PageConfig {
   section: "public" | "auth" | "admin";
   path: string;
   name: string;
 }
 
-interface TableConfig {
+export interface TableConfig {
   name: string;
   sections: ("public" | "auth" | "admin")[];
 }
 
-interface ModuleConfig {
+export interface ModuleConfig {
   slug: string;
   moduleName: string;
   pages: PageConfig[];
   tables: TableConfig[];
 }
 
+// Noms réservés pour éviter les collisions avec le routeur/app
+const RESERVED_PAGE_NAMES = new Set([
+  "layout",
+  "page",
+  "api",
+  "admin",
+  "auth",
+  "public",
+]);
+
 /**
  * Parse une chaîne de pages séparées par des virgules
  * Ex: "legal, privacy, terms" => ["legal", "privacy", "terms"]
@@ -33,6 +47,19 @@ function parsePagesList(input: string): string[] {
     .filter((p) => p.length > 0);
 }
 
+/**
+ * Slugifie un nom de page: minuscules, tirets, alphanum uniquement
+ */
+function slugifyPageName(name: string): string {
+  return name
+    .trim()
+    .toLowerCase()
+    .replace(/[\s_]+/g, "-")
+    .replace(/[^a-z0-9-]/g, "")
+    .replace(/--+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
 /**
  * Parse une chaîne de tables séparées par des virgules
  * Ex: "settings, users" => ["settings", "users"]
@@ -92,7 +119,8 @@ function generatePackageJson(
   rootDir: string,
 ): string {
   const versions = getLastBrainPackageVersions(rootDir);
-  const buildConfigExport = `./${slug}.build.config`;
+  const moduleNameOnly = slug.replace("module-", "");
+  const buildConfigExport = `./${moduleNameOnly}.build.config`;
   return JSON.stringify(
     {
       name: moduleName,
@@ -126,8 +154,8 @@ function generatePackageJson(
           default: "./dist/server.js",
         },
         [buildConfigExport]: {
-          types: `./dist/${slug}.build.config.d.ts`,
-          default: `./dist/${slug}.build.config.js`,
+          types: `./dist/${moduleNameOnly}.build.config.d.ts`,
+          default: `./dist/${moduleNameOnly}.build.config.js`,
         },
         "./api/*": {
           types: "./dist/api/*.d.ts",
@@ -165,6 +193,46 @@ function generateTsConfig(): string {
  */
 function generateBuildConfig(config: ModuleConfig): string {
   const { moduleName, pages, tables } = config;
+  const moduleNameOnly = config.slug.replace("module-", "");
+
+  // Helper pour normaliser les chemins (évite // et trim)
+  function normalizePath(...segments: string[]): string {
+    return (
+      "/" +
+      segments
+        .map((s) => s.replace(/^\/+/g, "").replace(/\/+$/g, ""))
+        .filter(Boolean)
+        .join("/")
+    );
+  }
+
+  // Construit un path de menu selon la section en respectant le pattern attendu
+  function buildMenuPath(
+    section: string,
+    pagePath: string,
+    pageName: string,
+  ): string {
+    const cleanedPagePath = pagePath.replace(/^\/+/g, "");
+    switch (section) {
+      case "public": {
+        // Public: /<module>/<page> (si non déjà préfixé)
+        if (cleanedPagePath.startsWith(moduleNameOnly + "/")) {
+          return normalizePath(cleanedPagePath); // déjà préfixé
+        }
+        return normalizePath(moduleNameOnly, cleanedPagePath);
+      }
+      case "auth": {
+        // Auth: /auth/<module>/<page>
+        return normalizePath("auth", moduleNameOnly, cleanedPagePath);
+      }
+      case "admin": {
+        // Admin: /admin/<module>/<pageName> (utilise le slug brut)
+        return normalizePath("admin", moduleNameOnly, pageName);
+      }
+      default:
+        return normalizePath(cleanedPagePath);
+    }
+  }
 
   // Générer la liste des pages
   const pagesConfig = pages.map((page) => {
@@ -207,11 +275,12 @@ function generateBuildConfig(config: ModuleConfig): string {
         .split("-")
         .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
         .join(" ");
+      const menuPath = buildMenuPath("public", page.path, page.name);
       return `      {
         title: "${title}",
         description: "Page ${title}",
         icon: "FileText",
-        path: "${page.path}",
+        path: "${menuPath}",
         order: ${index + 1},
       }`;
     });
@@ -226,11 +295,12 @@ function generateBuildConfig(config: ModuleConfig): string {
         .split("-")
         .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
         .join(" ");
+      const menuPath = buildMenuPath("auth", page.path, page.name);
       return `      {
         title: "${title}",
         description: "Page ${title}",
         icon: "FileText",
-        path: "${page.path}",
+        path: "${menuPath}",
         order: ${index + 1},
       }`;
     });
@@ -245,11 +315,12 @@ function generateBuildConfig(config: ModuleConfig): string {
         .split("-")
         .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
         .join(" ");
+      const menuPath = buildMenuPath("admin", page.path, page.name);
       return `      {
         title: "${title}",
         description: "Page ${title}",
         icon: "Settings",
-        path: "${page.path}",
+        path: "${menuPath}",
         order: ${index + 1},
       }`;
     });
@@ -296,24 +367,32 @@ export default buildConfig;
 /**
  * Génère le contenu du fichier index.ts
  */
-function generateIndexTs(pages: PageConfig[]): string {
+function toPascalCase(value: string): string {
+  return value
+    .split(/[-_]/g)
+    .filter(Boolean)
+    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+    .join("");
+}
+
+function generateIndexTs(pages: PageConfig[], moduleNameOnly: string): string {
   const exports = pages.map((page) => {
-    const componentName = page.name
-      .split("-")
-      .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
-      .join("");
-    const fileName = page.name
-      .split("-")
-      .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
-      .join("");
-    return `export { ${componentName}Page } from "./web/${page.section}/${fileName}Page.js";`;
+    const componentName = toPascalCase(page.name);
+    const fileName = toPascalCase(page.name);
+    return `export { ${componentName}Page } from "./web/${page.section}/${fileName}Page";`;
   });
 
+  const moduleAlias = toPascalCase(moduleNameOnly);
+
   return `// Client Components
 ${exports.join("\n")}
 
+// Documentation Component 
+export { Doc } from "./components/Doc";
+export { Doc as ${moduleAlias}ModuleDoc } from "./components/Doc";
+
 // Configuration de build
-export { default as buildConfig } from "./build.config.js";
+export { default as buildConfig } from "./${moduleNameOnly}.build.config";
 `;
 }
 
@@ -373,8 +452,16 @@ export function ${componentName}Page() {
  */
 function generateApiRoute(tableName: string, section: string): string {
   const authRequired = section !== "public";
+  const clientImport =
+    section === "admin"
+      ? 'import { getSupabaseServiceClient } from "@lastbrain/core/server"'
+      : 'import { getSupabaseServerClient } from "@lastbrain/core/server"';
+  const clientGetter =
+    section === "admin"
+      ? "getSupabaseServiceClient"
+      : "getSupabaseServerClient";
 
-  return `import { getSupabaseServerClient } from "@lastbrain/core/server";
+  return `${clientImport};
 
 const jsonResponse = (payload: unknown, status = 200) => {
   return new Response(JSON.stringify(payload), {
@@ -389,7 +476,7 @@ const jsonResponse = (payload: unknown, status = 200) => {
  * GET - Liste tous les enregistrements de ${tableName}
  */
 export async function GET(request: Request) {
-  const supabase = await getSupabaseServerClient();
+  const supabase = await ${clientGetter}();
   ${
     authRequired
       ? `
@@ -416,7 +503,7 @@ export async function GET(request: Request) {
  * POST - Crée un nouvel enregistrement dans ${tableName}
  */
 export async function POST(request: Request) {
-  const supabase = await getSupabaseServerClient();
+  const supabase = await ${clientGetter}();
   ${
     authRequired
       ? `
@@ -430,9 +517,12 @@ export async function POST(request: Request) {
 
   const body = await request.json();
 
+  // Injection côté serveur de owner_id si l'utilisateur est authentifié (sécurité)
+  const insertPayload = ${authRequired ? `{ ...body, owner_id: user.id }` : "body"};
+
   const { data, error } = await supabase
     .from("${tableName}")
-    .insert(body)
+    .insert(insertPayload)
     .select()
     .single();
 
@@ -447,7 +537,7 @@ export async function POST(request: Request) {
  * PUT - Met à jour un enregistrement dans ${tableName}
  */
 export async function PUT(request: Request) {
-  const supabase = await getSupabaseServerClient();
+  const supabase = await ${clientGetter}();
   ${
     authRequired
       ? `
@@ -484,7 +574,7 @@ export async function PUT(request: Request) {
  * DELETE - Supprime un enregistrement de ${tableName}
  */
 export async function DELETE(request: Request) {
-  const supabase = await getSupabaseServerClient();
+  const supabase = await ${clientGetter}();
   ${
     authRequired
       ? `
@@ -605,10 +695,642 @@ ${tablesSQL}
 `;
 }
 
+/**
+ * Generate Doc.tsx component for the module
+ */
+function generateDocComponent(config: ModuleConfig): string {
+  const moduleNameClean = config.slug.replace("module-", "");
+  const moduleNameOnly = moduleNameClean;
+
+  // Generate pages sections
+  const publicPages = config.pages.filter((p) => p.section === "public");
+  const authPages = config.pages.filter((p) => p.section === "auth");
+  const adminPages = config.pages.filter((p) => p.section === "admin");
+
+  let pagesSection = "";
+  if (config.pages.length > 0) {
+    pagesSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2">
+            <FileText size={24} />
+            Pages Disponibles
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-4">`;
+
+    if (publicPages.length > 0) {
+      pagesSection += `
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Pages Publiques</h3>
+            <div className="space-y-2">`;
+      for (const page of publicPages) {
+        const componentName = page.name
+          .split("-")
+          .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+          .join("");
+        pagesSection += `
+              <div className="flex items-start gap-2">
+                <Chip size="sm" color="success" variant="flat">GET</Chip>
+                <code className="text-sm">${page.path}</code>
+                <span className="text-sm text-slate-600 dark:text-slate-400">- ${componentName}</span>
+              </div>`;
+      }
+      pagesSection += `
+            </div>
+          </div>`;
+    }
+
+    if (authPages.length > 0) {
+      pagesSection += `
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Pages Protégées (Auth)</h3>
+            <div className="space-y-2">`;
+      for (const page of authPages) {
+        const componentName = page.name
+          .split("-")
+          .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+          .join("");
+        pagesSection += `
+              <div className="flex items-start gap-2">
+                <Chip size="sm" color="primary" variant="flat">GET</Chip>
+                <code className="text-sm">${page.path}</code>
+                <span className="text-sm text-slate-600 dark:text-slate-400">- ${componentName}</span>
+              </div>`;
+      }
+      pagesSection += `
+            </div>
+          </div>`;
+    }
+
+    if (adminPages.length > 0) {
+      pagesSection += `
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Pages Admin</h3>
+            <div className="space-y-2">`;
+      for (const page of adminPages) {
+        const componentName = page.name
+          .split("-")
+          .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+          .join("");
+        pagesSection += `
+              <div className="flex items-start gap-2">
+                <Chip size="sm" color="secondary" variant="flat">GET</Chip>
+                <code className="text-sm">/admin/${moduleNameOnly}/${page.name}</code>
+                <span className="text-sm text-slate-600 dark:text-slate-400">- ${componentName}</span>
+              </div>`;
+      }
+      pagesSection += `
+            </div>
+          </div>`;
+    }
+
+    pagesSection += `
+        </CardBody>
+      </Card>
+`;
+  }
+
+  // Generate APIs section
+  let apisSection = "";
+  if (config.tables.length > 0) {
+    apisSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2">
+            <Zap size={24} />
+            API Routes
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-4">`;
+
+    for (const table of config.tables) {
+      for (const section of table.sections) {
+        apisSection += `
+          <div>
+            <h3 className="text-lg font-semibold mb-2">
+              <code>/api/${section}/${table.name}</code>
+            </h3>
+            <div className="flex gap-2">
+              <Chip size="sm" color="success" variant="flat">GET</Chip>
+              <Chip size="sm" color="primary" variant="flat">POST</Chip>
+              <Chip size="sm" color="warning" variant="flat">PUT</Chip>
+              <Chip size="sm" color="danger" variant="flat">DELETE</Chip>
+            </div>
+          </div>`;
+      }
+    }
+
+    apisSection += `
+        </CardBody>
+      </Card>
+`;
+  }
+
+  // Generate tables section
+  let tablesSection = "";
+  if (config.tables.length > 0) {
+    tablesSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2">
+            <Database size={24} />
+            Base de Données
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-6">`;
+
+    for (const table of config.tables) {
+      tablesSection += `
+          <TableStructure
+            tableName="${table.name}"
+            title="${table.name}"
+            description="Table ${table.name} du module ${moduleNameClean}"
+          />`;
+    }
+
+    tablesSection += `
+        </CardBody>
+      </Card>
+`;
+  }
+
+  // Installation commands
+  const installSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2">
+            <Package size={24} />
+            Installation
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-4">
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Ajouter le module</h3>
+            <Snippet symbol="" hideSymbol className="text-sm mb-2">
+              pnpm lastbrain add-module ${moduleNameClean}
+            </Snippet>
+            <Snippet symbol="" hideSymbol className="text-sm mb-2">
+              pnpm build:modules
+            </Snippet>
+          </div>
+          
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Appliquer les migrations</h3>
+            <Snippet symbol="" hideSymbol className="text-sm mb-2">
+              cd apps/votre-app
+            </Snippet>
+            <Snippet symbol="" hideSymbol className="text-sm mb-2">
+              supabase migration up
+            </Snippet>
+          </div>
+        </CardBody>
+      </Card>
+`;
+
+  // Usage section with placeholder
+  const usageSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2">
+            <BookOpen size={24} />
+            Utilisation
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-4">
+          <Alert color="default" className="mb-4">
+            <p className="text-sm">
+              📝 <strong>Section à compléter par l'auteur du module</strong>
+            </p>
+            <p className="text-sm text-slate-600 dark:text-slate-400 mt-2">
+              Ajoutez ici des exemples d'utilisation, des configurations spécifiques,
+              et toute information utile pour les développeurs utilisant ce module.
+            </p>
+          </Alert>
+          
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Exemple d'utilisation</h3>
+            <Alert color="primary" className="p-4 mb-4">
+              <pre className="whitespace-pre-wrap">{\`// Importez les composants depuis le module
+import { ${
+    config.pages.length > 0
+      ? config.pages[0].name
+          .split("-")
+          .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+          .join("") + "Page"
+      : "Component"
+  } } from "${config.moduleName}";
+
+// Utilisez-les dans votre application
+<${
+    config.pages.length > 0
+      ? config.pages[0].name
+          .split("-")
+          .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+          .join("") + "Page"
+      : "Component"
+  } />\`}</pre>
+            </Alert>
+          </div>
+        </CardBody>
+      </Card>
+`;
+
+  // Danger zone
+  const dangerSection = `
+      <Card>
+        <CardHeader>
+          <h2 className="text-2xl font-semibold flex items-center gap-2 text-danger">
+            <AlertTriangle size={24} />
+            Danger Zone
+          </h2>
+        </CardHeader>
+        <CardBody className="space-y-4">
+          <Alert color="danger" className="mb-4">
+            <p className="text-sm font-semibold">
+              ⚠️ Cette action est irréversible
+            </p>
+            <p className="text-sm mt-2">
+              La suppression du module supprimera toutes les pages, routes API et migrations associées.
+            </p>
+          </Alert>
+          
+          <div>
+            <h3 className="text-lg font-semibold mb-2">Supprimer le module</h3>
+            <Snippet symbol="" hideSymbol color="danger" className="text-sm mb-2">
+              pnpm lastbrain remove-module ${moduleNameClean}
+            </Snippet>
+            <Snippet symbol="" hideSymbol color="danger" className="text-sm mb-2">
+              pnpm build:modules
+            </Snippet>
+          </div>
+        </CardBody>
+      </Card>
+`;
+
+  return `"use client";
+
+import { Card, CardBody, CardHeader } from "@lastbrain/ui";
+import { Chip } from "@lastbrain/ui";
+import { Snippet } from "@lastbrain/ui";
+import { Alert } from "@lastbrain/ui";
+import { TableStructure } from "@lastbrain/ui";
+import { 
+  FileText, 
+  Zap, 
+  Database, 
+  Package, 
+  BookOpen, 
+  AlertTriangle 
+} from "lucide-react";
+
+/**
+ * Documentation component for ${config.moduleName}
+ * Auto-generated from ${config.slug}.build.config.ts
+ * 
+ * To regenerate this file, run:
+ * pnpm generate:module-docs
+ */
+export function Doc() {
+  return (
+    <div className="container mx-auto p-6 space-y-6">
+      <Card>
+        <CardHeader>
+          <div>
+            <h1 className="text-3xl font-bold mb-2">📦 Module ${moduleNameClean}</h1>
+            <p className="text-slate-600 dark:text-slate-400">${config.moduleName}</p>
+          </div>
+        </CardHeader>
+        <CardBody>
+          <div className="grid grid-cols-1 md:grid-cols-3 gap-4">
+            <div>
+              <p className="text-sm text-slate-600 dark:text-slate-400">Package</p>
+              <code className="text-sm font-semibold">${config.moduleName}</code>
+            </div>
+            <div>
+              <p className="text-sm text-slate-600 dark:text-slate-400">Slug</p>
+              <code className="text-sm font-semibold">${config.slug}</code>
+            </div>
+            <div>
+              <p className="text-sm text-slate-600 dark:text-slate-400">Type</p>
+              <code className="text-sm font-semibold">Module LastBrain</code>
+            </div>
+          </div>
+        </CardBody>
+      </Card>
+${pagesSection}${apisSection}${tablesSection}${installSection}${usageSection}${dangerSection}
+    </div>
+  );
+}
+`;
+}
+
+/**
+ * Generate README.md for the module
+ */
+async function generateModuleReadme(config: ModuleConfig, moduleDir: string) {
+  const moduleNameClean = config.slug.replace("module-", "");
+
+  let md = `# 📦 Module ${moduleNameClean}\n\n`;
+  md += `> ${config.moduleName}\n\n`;
+
+  // Information section
+  md += `## 📋 Informations\n\n`;
+  md += `- **Nom du package**: \`${config.moduleName}\`\n`;
+  md += `- **Slug**: \`${config.slug}\`\n`;
+  md += `- **Type**: Module LastBrain\n\n`;
+
+  // Pages section
+  if (config.pages.length > 0) {
+    md += `## 📄 Pages Disponibles\n\n`;
+
+    const publicPages = config.pages.filter((p) => p.section === "public");
+    const authPages = config.pages.filter((p) => p.section === "auth");
+    const adminPages = config.pages.filter((p) => p.section === "admin");
+
+    if (publicPages.length > 0) {
+      md += `### Pages Publiques\n\n`;
+      for (const page of publicPages) {
+        const componentName = page.name
+          .split("-")
+          .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+          .join("");
+        md += `- **GET** \`${page.path}\` - ${componentName}\n`;
+      }
+      md += `\n`;
+    }
+
+    if (authPages.length > 0) {
+      md += `### Pages Protégées (Auth)\n\n`;
+      for (const page of authPages) {
+        const componentName = page.name
+          .split("-")
+          .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+          .join("");
+        md += `- **GET** \`${page.path}\` - ${componentName}\n`;
+      }
+      md += `\n`;
+    }
+
+    if (adminPages.length > 0) {
+      md += `### Pages Admin\n\n`;
+      for (const page of adminPages) {
+        const componentName = page.name
+          .split("-")
+          .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+          .join("");
+        md += `- **GET** \`/admin/${config.slug.replace("module-", "")}/${page.name}\` - ${componentName}\n`;
+      }
+      md += `\n`;
+    }
+  }
+
+  // APIs section
+  if (config.tables.length > 0) {
+    md += `## 🔌 API Routes\n\n`;
+
+    for (const table of config.tables) {
+      for (const section of table.sections) {
+        md += `### \`/api/${section}/${table.name}\`\n\n`;
+        md += `**Méthodes supportées**: GET, POST, PUT, DELETE\n\n`;
+      }
+    }
+  }
+
+  // Database section
+  if (config.tables.length > 0) {
+    md += `## 🗄️ Base de Données\n\n`;
+    md += `### Tables\n\n`;
+
+    for (const table of config.tables) {
+      md += `#### \`${table.name}\`\n\n`;
+      md += `\`\`\`tsx\n`;
+      md += `<TableStructure\n`;
+      md += `  tableName="${table.name}"\n`;
+      md += `  title="${table.name}"\n`;
+      md += `  description="Table ${table.name} du module ${moduleNameClean}"\n`;
+      md += `/>\n`;
+      md += `\`\`\`\n\n`;
+    }
+
+    // Get migration files
+    const migrationsPath = path.join(moduleDir, "supabase", "migrations");
+    if (fs.existsSync(migrationsPath)) {
+      const migrationFiles = fs
+        .readdirSync(migrationsPath)
+        .filter((f) => f.endsWith(".sql"))
+        .sort();
+
+      if (migrationFiles.length > 0) {
+        md += `### Migrations\n\n`;
+        for (const migration of migrationFiles) {
+          md += `- \`${migration}\`\n`;
+        }
+        md += `\n`;
+      }
+    }
+  }
+
+  // Installation section
+  md += `## 📦 Installation\n\n`;
+  md += `\`\`\`bash\n`;
+  md += `pnpm lastbrain add-module ${moduleNameClean}\n`;
+  md += `pnpm build:modules\n`;
+  md += `\`\`\`\n\n`;
+
+  md += `### Appliquer les migrations\n\n`;
+  md += `\`\`\`bash\n`;
+  md += `cd apps/votre-app\n`;
+  md += `supabase migration up\n`;
+  md += `\`\`\`\n\n`;
+
+  // Usage section
+  md += `## 💡 Utilisation\n\n`;
+  md += `<!-- 📝 Section à compléter par l'auteur du module -->\n\n`;
+  md += `### Exemple d'utilisation\n\n`;
+  md += `\`\`\`tsx\n`;
+  md += `// Importez les composants depuis le module\n`;
+  if (config.pages.length > 0) {
+    const firstPage = config.pages[0];
+    const componentName = firstPage.name
+      .split("-")
+      .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+      .join("");
+    md += `import { ${componentName}Page } from "${config.moduleName}";\n\n`;
+    md += `// Utilisez-les dans votre application\n`;
+    md += `<${componentName}Page />\n`;
+  }
+  md += `\`\`\`\n\n`;
+
+  md += `### Configuration\n\n`;
+  md += `<!-- Ajoutez ici les détails de configuration spécifiques -->\n\n`;
+
+  // Danger zone
+  md += `## ⚠️ Danger Zone\n\n`;
+  md += `La suppression du module supprimera toutes les pages, routes API et migrations associées. **Cette action est irréversible.**\n\n`;
+  md += `\`\`\`bash\n`;
+  md += `pnpm lastbrain remove-module ${moduleNameClean}\n`;
+  md += `pnpm build:modules\n`;
+  md += `\`\`\`\n\n`;
+
+  // Write README.md
+  const readmePath = path.join(moduleDir, "README.md");
+  await fs.writeFile(readmePath, md);
+
+  console.log(chalk.yellow("  📄 README.md"));
+}
+
+/**
+ * Met à jour le registre des modules dans core/src/config/modules.ts
+ */
+async function updateModuleRegistry(config: ModuleConfig, rootDir: string) {
+  const moduleRegistryPath = path.join(
+    rootDir,
+    "packages",
+    "core",
+    "src",
+    "config",
+    "modules.ts",
+  );
+
+  if (!fs.existsSync(moduleRegistryPath)) {
+    console.log(
+      chalk.yellow("  ⚠️  Fichier de registre non trouvé, création..."),
+    );
+    // Si le fichier n'existe pas, on le crée avec le module actuel
+    const content = `/**
+ * Configuration centralisée des modules LastBrain
+ * Ce fichier est auto-généré et maintenu par les scripts de gestion des modules
+ */
+
+export interface ModuleMetadata {
+  name: string;
+  package: string;
+  description: string;
+  emoji: string;
+  version?: string;
+}
+
+export const AVAILABLE_MODULES: ModuleMetadata[] = [
+  {
+    name: "${config.slug.replace("module-", "")}",
+    package: "@lastbrain/${config.slug}",
+    description: "Module ${config.moduleName}",
+    emoji: "📦",
+  },
+];
+
+/**
+ * Récupère les métadonnées d'un module par son nom
+ */
+export function getModuleMetadata(name: string): ModuleMetadata | undefined {
+  return AVAILABLE_MODULES.find((m) => m.name === name);
+}
+
+/**
+ * Vérifie si un module existe
+ */
+export function moduleExists(name: string): boolean {
+  return AVAILABLE_MODULES.some((m) => m.name === name);
+}
+
+/**
+ * Récupère la liste des noms de modules disponibles
+ */
+export function getAvailableModuleNames(): string[] {
+  return AVAILABLE_MODULES.map((m) => m.name);
+}
+`;
+    await fs.writeFile(moduleRegistryPath, content, "utf-8");
+    console.log(chalk.green("  ✓ Registre créé"));
+    return;
+  }
+
+  try {
+    let content = await fs.readFile(moduleRegistryPath, "utf-8");
+
+    const moduleName = config.slug.replace("module-", "");
+    const moduleEntry = `  {
+    name: "${moduleName}",
+    package: "@lastbrain/${config.slug}",
+    description: "Module ${config.moduleName}",
+    emoji: "📦",
+  },`;
+
+    // Vérifier si le module existe déjà
+    if (content.includes(`name: "${moduleName}"`)) {
+      console.log(
+        chalk.yellow(
+          `  ⚠️  Module ${moduleName} déjà présent dans le registre`,
+        ),
+      );
+      return;
+    }
+
+    // Trouver le tableau AVAILABLE_MODULES et ajouter le module
+    const arrayMatch = content.match(
+      /export const AVAILABLE_MODULES: ModuleMetadata\[\] = \[([\s\S]*?)\];/,
+    );
+    if (arrayMatch) {
+      const arrayContent = arrayMatch[1];
+      const lastItem = arrayContent.trim().split("\n").pop();
+
+      // Ajouter le nouveau module à la fin du tableau
+      const newArrayContent =
+        arrayContent.trimEnd() + "\n" + moduleEntry + "\n";
+      content = content.replace(
+        /export const AVAILABLE_MODULES: ModuleMetadata\[\] = \[([\s\S]*?)\];/,
+        `export const AVAILABLE_MODULES: ModuleMetadata[] = [${newArrayContent}];`,
+      );
+
+      await fs.writeFile(moduleRegistryPath, content, "utf-8");
+      console.log(chalk.green(`  ✓ Module ${moduleName} ajouté au registre`));
+    } else {
+      console.log(
+        chalk.yellow(
+          "  ⚠️  Format du registre non reconnu, ajout manuel requis",
+        ),
+      );
+    }
+  } catch (error) {
+    console.log(
+      chalk.yellow(`  ⚠️  Erreur lors de la mise à jour du registre: ${error}`),
+    );
+    console.log(
+      chalk.gray("  Vous devrez ajouter manuellement le module au registre"),
+    );
+  }
+}
+
+/**
+ * Trouve le répertoire racine du workspace (avec pnpm-workspace.yaml)
+ */
+export function findWorkspaceRoot(): string {
+  let rootDir = process.cwd();
+  let attempts = 0;
+  const maxAttempts = 5;
+
+  while (attempts < maxAttempts) {
+    const workspaceFile = path.join(rootDir, "pnpm-workspace.yaml");
+    if (fs.existsSync(workspaceFile)) {
+      return rootDir;
+    }
+    rootDir = path.resolve(rootDir, "..");
+    attempts++;
+  }
+
+  throw new Error(
+    "Impossible de trouver le répertoire racine du workspace (pnpm-workspace.yaml non trouvé)",
+  );
+}
+
 /**
  * Crée la structure du module
  */
-async function createModuleStructure(config: ModuleConfig, rootDir: string) {
+export async function createModuleStructure(
+  config: ModuleConfig,
+  rootDir: string,
+) {
   const moduleDir = path.join(rootDir, "packages", config.slug);
 
   console.log(chalk.blue(`\n📦 Création du module ${config.slug}...\n`));
@@ -618,7 +1340,9 @@ async function createModuleStructure(config: ModuleConfig, rootDir: string) {
   await fs.ensureDir(path.join(moduleDir, "src"));
   await fs.ensureDir(path.join(moduleDir, "src", "web"));
   await fs.ensureDir(path.join(moduleDir, "src", "api"));
+  await fs.ensureDir(path.join(moduleDir, "src", "components"));
   await fs.ensureDir(path.join(moduleDir, "supabase", "migrations"));
+  await fs.ensureDir(path.join(moduleDir, "supabase", "migrations-down"));
 
   // Créer package.json
   console.log(chalk.yellow("  📄 package.json"));
@@ -631,8 +1355,9 @@ async function createModuleStructure(config: ModuleConfig, rootDir: string) {
   console.log(chalk.yellow("  📄 tsconfig.json"));
   await fs.writeFile(path.join(moduleDir, "tsconfig.json"), generateTsConfig());
 
-  // Créer {slug}.build.config.ts
-  const buildConfigFileName = `${config.slug}.build.config.ts`;
+  // Créer {name}.build.config.ts (sans le préfixe module-)
+  const moduleNameOnly = config.slug.replace("module-", "");
+  const buildConfigFileName = `${moduleNameOnly}.build.config.ts`;
   console.log(chalk.yellow(`  📄 src/${buildConfigFileName}`));
   await fs.writeFile(
     path.join(moduleDir, "src", buildConfigFileName),
@@ -643,14 +1368,17 @@ async function createModuleStructure(config: ModuleConfig, rootDir: string) {
   console.log(chalk.yellow("  📄 src/index.ts"));
   await fs.writeFile(
     path.join(moduleDir, "src", "index.ts"),
-    generateIndexTs(config.pages),
+    generateIndexTs(config.pages, moduleNameOnly),
   );
 
-  // Créer server.ts
-  console.log(chalk.yellow("  📄 src/server.ts"));
+  // Note: server.ts n'est plus généré pour éviter les conflits d'exports
+  // Les routes API sont exposées via le build.config et l'app les importe dynamiquement
+
+  // Créer Doc.tsx
+  console.log(chalk.yellow("  📄 src/components/Doc.tsx"));
   await fs.writeFile(
-    path.join(moduleDir, "src", "server.ts"),
-    generateServerTs(config.tables),
+    path.join(moduleDir, "src", "components", "Doc.tsx"),
+    generateDocComponent(config),
   );
 
   // Créer les pages
@@ -705,19 +1433,82 @@ async function createModuleStructure(config: ModuleConfig, rootDir: string) {
       path.join(moduleDir, "supabase", "migrations", migrationFileName),
       generateMigration(config.tables, config.slug),
     );
+
+    // Génération du fichier DOWN correspondant pour rollback
+    const downFileName = `${timestamp}_${config.slug}_init.sql`;
+    const downContent = config.tables
+      .map(
+        (t) =>
+          `-- Rollback for table ${t.name}\nDROP POLICY IF EXISTS ${t.name}_owner_delete ON public.${t.name};\nDROP POLICY IF EXISTS ${t.name}_owner_update ON public.${t.name};\nDROP POLICY IF EXISTS ${t.name}_owner_insert ON public.${t.name};\nDROP POLICY IF EXISTS ${t.name}_owner_select ON public.${t.name};\nDROP TRIGGER IF EXISTS set_${t.name}_updated_at ON public.${t.name};\nDROP INDEX IF EXISTS idx_${t.name}_owner_id;\nDROP TABLE IF EXISTS public.${t.name};\n`,
+      )
+      .join("\n");
+    console.log(chalk.yellow(`  📄 supabase/migrations-down/${downFileName}`));
+    await fs.writeFile(
+      path.join(moduleDir, "supabase", "migrations-down", downFileName),
+      `-- DOWN migration for ${config.slug}\n${downContent}`,
+    );
+  }
+
+  // Générer la documentation du module
+  console.log(chalk.blue("\n📝 Génération de la documentation..."));
+  await generateModuleReadme(config, moduleDir);
+
+  // Installer les dépendances
+  console.log(chalk.blue("\n📦 Installation des dépendances..."));
+  const { execSync } = await import("child_process");
+  const installCmd = process.env.CI
+    ? "pnpm install --no-frozen-lockfile"
+    : "pnpm install";
+  try {
+    execSync(installCmd, {
+      cwd: moduleDir,
+      stdio: "inherit",
+    });
+    console.log(chalk.green("\n✅ Dépendances installées avec succès!"));
+  } catch (error) {
+    console.log(
+      chalk.yellow(
+        "\n⚠️  Erreur lors de l'installation, veuillez exécuter manuellement:",
+      ),
+    );
+    console.log(chalk.gray(`  cd ${moduleDir} && pnpm install`));
+  }
+
+  // Mettre à jour le registre des modules dans le core
+  console.log(chalk.blue("\n📝 Mise à jour du registre des modules..."));
+  await updateModuleRegistry(config, rootDir);
+
+  // Build auto du module pour générer dist immédiatement
+  console.log(chalk.blue("\n🏗️  Build initial du module..."));
+  try {
+    execSync(`pnpm --filter ${config.slug} build`, {
+      cwd: rootDir,
+      stdio: "inherit",
+    });
+    console.log(chalk.green("✓ Module compilé"));
+  } catch (error) {
+    console.log(
+      chalk.yellow("⚠️  Build automatique échoué, exécutez: cd"),
+      config.slug,
+      "&& pnpm build",
+    );
   }
 
   console.log(chalk.green(`\n✅ Module ${config.slug} créé avec succès!\n`));
   console.log(chalk.gray(`📂 Emplacement: ${moduleDir}\n`));
   console.log(chalk.blue("Prochaines étapes:"));
-  console.log(chalk.gray(`  1. cd ${moduleDir}`));
-  console.log(chalk.gray(`  2. pnpm install`));
-  console.log(chalk.gray(`  3. pnpm build`));
   console.log(
     chalk.gray(
-      `  4. Ajouter le module à votre app avec: pnpm lastbrain add ${config.slug.replace("module-", "")}\n`,
+      `  1. Ajouter à une app: pnpm lastbrain add-module ${config.slug.replace("module-", "")}`,
+    ),
+  );
+  console.log(
+    chalk.gray(
+      "  2. (Optionnel) Modifier Doc.tsx pour documentation personnalisée",
     ),
   );
+  console.log(chalk.gray("  3. Publier: pnpm publish:" + config.slug));
+  console.log(chalk.gray("  4. Générer docs globales: pnpm generate:all\n"));
 }
 
 /**
@@ -779,31 +1570,76 @@ export async function createModule() {
 
   // Pages publiques
   const publicPages = parsePagesList(answers.pagesPublic);
+  const invalidPublic = publicPages.filter((n) => RESERVED_PAGE_NAMES.has(n));
+  if (invalidPublic.length) {
+    console.error(
+      chalk.red(
+        `❌ Noms de pages publiques réservés détectés: ${invalidPublic.join(", ")}`,
+      ),
+    );
+    console.error(
+      chalk.yellow(
+        "Noms interdits: layout, page, api, admin, auth, public. Choisissez des noms métier distincts.",
+      ),
+    );
+    process.exit(1);
+  }
   for (const pageName of publicPages) {
+    const slugName = slugifyPageName(pageName);
     pages.push({
       section: "public",
-      path: `/${pageName}`,
-      name: pageName,
+      path: `/${slugName}`,
+      name: slugName,
     });
   }
 
   // Pages auth
   const authPages = parsePagesList(answers.pagesAuth);
+  const invalidAuth = authPages.filter((n) => RESERVED_PAGE_NAMES.has(n));
+  if (invalidAuth.length) {
+    console.error(
+      chalk.red(
+        `❌ Noms de pages auth réservés détectés: ${invalidAuth.join(", ")}`,
+      ),
+    );
+    console.error(
+      chalk.yellow(
+        "Noms interdits: layout, page, api, admin, auth, public. Utilisez des noms métier (ex: dashboard, profile).",
+      ),
+    );
+    process.exit(1);
+  }
   for (const pageName of authPages) {
+    const slugName = slugifyPageName(pageName);
     pages.push({
       section: "auth",
-      path: `/${pageName}`,
-      name: pageName,
+      path: `/${slugName}`,
+      name: slugName,
     });
   }
 
   // Pages admin
   const adminPages = parsePagesList(answers.pagesAdmin);
+  const invalidAdmin = adminPages.filter((n) => RESERVED_PAGE_NAMES.has(n));
+  if (invalidAdmin.length) {
+    console.error(
+      chalk.red(
+        `❌ Noms de pages admin réservés détectés: ${invalidAdmin.join(", ")}`,
+      ),
+    );
+    console.error(
+      chalk.yellow(
+        "Noms interdits: layout, page, api, admin, auth, public. Utilisez des noms métier (ex: settings, users).",
+      ),
+    );
+    process.exit(1);
+  }
   for (const pageName of adminPages) {
+    const slugName = slugifyPageName(pageName);
     pages.push({
       section: "admin",
-      path: `/${pageName}`,
-      name: pageName,
+      path: `/${slugName}`,
+      name: slugName,
     });
   }
 
@@ -836,25 +1672,11 @@ export async function createModule() {
   };
 
   // Trouver le répertoire racine du workspace (chercher pnpm-workspace.yaml)
-  let rootDir = process.cwd();
-  let attempts = 0;
-  const maxAttempts = 5;
-
-  while (attempts < maxAttempts) {
-    const workspaceFile = path.join(rootDir, "pnpm-workspace.yaml");
-    if (fs.existsSync(workspaceFile)) {
-      break;
-    }
-    rootDir = path.resolve(rootDir, "..");
-    attempts++;
-  }
-
-  if (attempts === maxAttempts) {
-    console.error(
-      chalk.red(
-        "❌ Impossible de trouver le répertoire racine du workspace (pnpm-workspace.yaml non trouvé)",
-      ),
-    );
+  let rootDir: string;
+  try {
+    rootDir = findWorkspaceRoot();
+  } catch (error) {
+    console.error(chalk.red("❌ " + (error as Error).message));
     process.exit(1);
   }