@lastbrain/app 0.1.34 → 0.1.36

package/dist/templates/DocPage.js

@@ -172,7 +172,7 @@ export function DocPage({ modules = [], defaultContent }) {
     ];
     return (_jsx("div", { className: "w-full pt-8 md:pt-12 pb-24 lg:pb-8", children: _jsxs("div", { className: "container mx-auto md:px-4 py-8", children: [_jsx("div", { className: "fixed w-full h-16 left-0 bottom-0 bg-background/20 backdrop-blur-lg z-50 lg:hidden p-2", children: _jsx("div", { className: "flex justify-center", children: _jsx(Button, { isIconOnly: true, variant: "solid", onPress: () => setIsDrawerOpen(true), children: _jsx(Menu, { size: 24 }) }) }) }), _jsx(Drawer, { isOpen: isDrawerOpen, onOpenChange: setIsDrawerOpen, placement: "left", children: _jsxs(DrawerContent, { children: [_jsx(DrawerHeader, { children: _jsx("h2", { className: "text-xl font-semibold", children: "Navigation" }) }), _jsx(DrawerBody, { children: _jsx(NavigationListbox, { navigationItems: navigationItems, selectedModule: selectedModule, scrollToSection: scrollToSection, setSelectedModule: setSelectedModule }) })] }) }), _jsxs("div", { className: "flex gap-8", children: [_jsx("aside", { className: "hidden lg:block w-64 shrink-0 sticky top-18 self-start", children: _jsxs(Card, { children: [_jsx(CardHeader, { className: "pb-2", children: _jsx("h2", { className: "text-xl font-semibold", children: "Navigation" }) }), _jsx(CardBody, { children: _jsx(NavigationListbox, { navigationItems: navigationItems, selectedModule: selectedModule, scrollToSection: scrollToSection, setSelectedModule: setSelectedModule }) })] }) }), _jsxs("main", { className: "flex-1 w-full min-w-0 space-y-8", children: [defaultContent ? (_jsx("div", { children: defaultContent })) : (_jsx(DefaultDocumentation, {})), modules.length > 0 && (_jsxs("div", { className: "space-y-6", children: [_jsxs(Card, { id: "section-modules", className: "scroll-mt-32", children: [_jsx(CardHeader, { children: _jsx("h2", { className: "text-2xl font-semibold", children: "Modules disponibles" }) }), _jsxs(CardBody, { children: [_jsx("p", { className: "text-slate-600 dark:text-slate-400 mb-4", children: "Voici la liste de tous les modules disponibles dans LastBrain. Les modules actifs sont utilis\u00E9s dans votre application." }), _jsx("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-4", children: modules.map((module) => (_jsx(Card, { isPressable: module.available, onPress: () => module.available && scrollToSection(module.id), className: `${module.available
                                                                     ? "cursor-pointer hover:shadow-lg"
-                                                                    : "opacity-70"} transition-shadow`, children: _jsxs(CardBody, { children: [_jsxs("div", { className: "flex items-start justify-between mb-2", children: [_jsx("h3", { className: "text-lg font-semibold", children: module.name }), _jsx(Chip, { size: "sm", color: module.available ? "success" : "warning", variant: "flat", children: module.available ? "Actif" : "Inactif" })] }), _jsx("p", { className: "text-sm text-slate-600 dark:text-slate-400 mb-2", children: module.description }), !module.available && (_jsxs("div", { className: "flex justify-between items-center text-xs text-default-700 mt-2", children: [_jsx("span", { children: "Pour activer : " }), _jsx(Snippet, { hideSymbol: true, color: "primary", children: `pnpm lastbrain add-module ${module.id}` })] }))] }) }, module.id))) })] })] }), modules
+                                                                    : "opacity-70"} transition-shadow`, children: _jsxs(CardBody, { children: [_jsxs("div", { className: "flex items-start justify-between mb-2", children: [_jsxs("h3", { className: "text-lg font-semibold flex flex-inline items-center gap-2", children: [_jsx(Blocks, { size: 20, className: "shrink-0" }), module.name] }), _jsx(Chip, { size: "sm", color: module.available ? "success" : "warning", variant: "flat", children: module.available ? "Actif" : "Inactif" })] }), _jsx("p", { className: "text-sm text-slate-600 dark:text-slate-400 mb-2", children: module.description }), !module.available && (_jsxs("div", { className: "flex justify-between items-center text-xs text-default-700 mt-2", children: [_jsx("span", { children: "Pour activer : " }), _jsx(Snippet, { hideSymbol: true, color: "primary", children: `pnpm lastbrain add-module ${module.id}` })] }))] }) }, module.id))) })] })] }), modules
                                             .filter((m) => m.available)
                                             .map((module) => (_jsx("div", { id: `module-${module.id}`, className: "scroll-mt-32", children: module.content }, module.id)))] }))] })] })] }) }));
 }

package/dist/templates/migrations/20201010100000_app_base.sql

@@ -177,33 +177,32 @@ BEGIN
       ), false
     ) as is_foreign_key,
     (
-      SELECT ccu.table_name::text
-      FROM information_schema.table_constraints tc
-      JOIN information_schema.key_column_usage kcu 
-        ON tc.constraint_name = kcu.constraint_name 
-        AND tc.table_schema = kcu.table_schema
-      JOIN information_schema.constraint_column_usage ccu
-        ON ccu.constraint_name = tc.constraint_name
-        AND ccu.table_schema = tc.table_schema
-      WHERE tc.constraint_type = 'FOREIGN KEY'
-        AND tc.table_schema = 'public'
-        AND tc.table_name = p_table_name
-        AND kcu.column_name = c.column_name
+      SELECT 
+        CASE 
+          WHEN nsp.nspname = 'public' THEN ref_table.relname::text
+          ELSE nsp.nspname::text || '.' || ref_table.relname::text
+        END
+      FROM pg_constraint con
+      JOIN pg_attribute att ON att.attrelid = con.conrelid AND att.attnum = ANY(con.conkey)
+      JOIN pg_class tbl ON tbl.oid = con.conrelid
+      JOIN pg_class ref_table ON ref_table.oid = con.confrelid
+      JOIN pg_namespace nsp ON nsp.oid = ref_table.relnamespace
+      WHERE con.contype = 'f'
+        AND tbl.relnamespace = (SELECT oid FROM pg_namespace WHERE nspname = 'public')
+        AND tbl.relname = p_table_name
+        AND att.attname = c.column_name
       LIMIT 1
     ) as foreign_table,
     (
-      SELECT ccu.column_name::text
-      FROM information_schema.table_constraints tc
-      JOIN information_schema.key_column_usage kcu 
-        ON tc.constraint_name = kcu.constraint_name 
-        AND tc.table_schema = kcu.table_schema
-      JOIN information_schema.constraint_column_usage ccu
-        ON ccu.constraint_name = tc.constraint_name
-        AND ccu.table_schema = tc.table_schema
-      WHERE tc.constraint_type = 'FOREIGN KEY'
-        AND tc.table_schema = 'public'
-        AND tc.table_name = p_table_name
-        AND kcu.column_name = c.column_name
+      SELECT ref_att.attname::text
+      FROM pg_constraint con
+      JOIN pg_attribute att ON att.attrelid = con.conrelid AND att.attnum = ANY(con.conkey)
+      JOIN pg_class tbl ON tbl.oid = con.conrelid
+      JOIN pg_attribute ref_att ON ref_att.attrelid = con.confrelid AND ref_att.attnum = ANY(con.confkey)
+      WHERE con.contype = 'f'
+        AND tbl.relnamespace = (SELECT oid FROM pg_namespace WHERE nspname = 'public')
+        AND tbl.relname = p_table_name
+        AND att.attname = c.column_name
       LIMIT 1
     ) as foreign_column,
     pgd.description::text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lastbrain/app",
-  "version": "0.1.34",
+  "version": "0.1.36",
   "description": "Framework modulaire Next.js avec CLI et système de modules",
   "private": false,
   "type": "module",

package/src/scripts/db-init.ts

@@ -117,7 +117,7 @@ function parseEnvFile(filePath: string) {
 function ensureEnvFile(values: Record<string, string>) {
   envTargets.forEach((target) => {
     let existingVars: Record<string, string> = {};
-    
+
     // Lire le fichier .env.local existant pour préserver les variables personnalisées
     if (fs.existsSync(target)) {
       try {
@@ -138,7 +138,7 @@ function ensureEnvFile(values: Record<string, string>) {
 
     // Fusionner les nouvelles valeurs avec les existantes (nouvelles valeurs prioritaires)
     const mergedValues = { ...existingVars, ...values };
-    
+
     const content = Object.entries(mergedValues)
       .map(([key, value]) => `${key}=${value}`)
       .join("\n");

package/src/scripts/module-create.ts

@@ -312,6 +312,9 @@ function generateIndexTs(pages: PageConfig[]): string {
   return `// Client Components
 ${exports.join("\n")}
 
+// Documentation Component
+export { Doc } from "./components/Doc.js";
+
 // Configuration de build
 export { default as buildConfig } from "./build.config.js";
 `;
@@ -605,6 +608,490 @@ ${tablesSQL}
 `;
 }
 
+/**
+ * Generate Doc.tsx component for the module
+ */
+function generateDocComponent(config: ModuleConfig): string {
+  const moduleNameClean = config.slug.replace("module-", "");
+
+  // 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">${page.path}</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** \`${page.path}\` - ${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"));
+}
+
 /**
  * Crée la structure du module
  */
@@ -618,6 +1105,7 @@ 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"));
 
   // Créer package.json
@@ -653,6 +1141,13 @@ async function createModuleStructure(config: ModuleConfig, rootDir: string) {
     generateServerTs(config.tables),
   );
 
+  // Créer Doc.tsx
+  console.log(chalk.yellow("  📄 src/components/Doc.tsx"));
+  await fs.writeFile(
+    path.join(moduleDir, "src", "components", "Doc.tsx"),
+    generateDocComponent(config),
+  );
+
   // Créer les pages
   console.log(chalk.blue("\n📄 Création des pages..."));
   for (const page of config.pages) {
@@ -707,6 +1202,10 @@ async function createModuleStructure(config: ModuleConfig, rootDir: string) {
     );
   }
 
+  // Générer la documentation du module
+  console.log(chalk.blue("\n📝 Génération de la documentation..."));
+  await generateModuleReadme(config, moduleDir);
+
   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:"));