go-duck-cli 1.0.8 → 1.1.1

package/templates/docs/pages/audit.hbs

@@ -1,39 +1,87 @@
-<h1 class="text-4xl font-extrabold text-gray-900 mb-4">Audit Trails & Tenant Metering</h1>
-<p class="text-lg text-gray-600 mb-8">Maintain strict compliance and automatically track API consumption rates for multi-tenant applications.</p>
-
-<section class="mb-10">
-    <h2 class="text-2xl font-bold text-gray-800 mb-4 border-b pb-2">The `@Audited` Engine (Dual Layer)</h2>
-    <p class="mb-4">By tagging an entity with <code>@Audited</code> inside your <code>GDL</code> file, GO-DUCK injects an advanced two-tier auditing strategy automatically into your microservice.</p>
-    
-    <div class="bg-indigo-50 border-l-4 border-indigo-500 p-4 mb-6 rounded-r">
-        <p class="text-indigo-900"><strong>Note:</strong> All Audit Logs are automatically driven completely via Keycloak JWT Token Extraction!</p>
+<div class="prose prose-slate max-w-none">
+    <div class="flex items-center space-x-3 mb-8 text-amber-700">
+        <div class="p-4 bg-gradient-to-br from-amber-600 to-orange-700 rounded-2xl shadow-lg shadow-amber-200">
+            <svg class="w-8 h-8 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z" />
+            </svg>
+        </div>
+        <h1 class="text-5xl font-black text-slate-900 m-0 tracking-tight leading-tight">Forensic Accountability <br><span class="text-amber-600 italic">& Metering Engine.</span></h1>
     </div>
 
-    <h3 class="font-semibold mb-2 mt-6">Layer 1: Inline Entity Columns</h3>
-    <p class="mb-4 text-gray-700">Instead of generic <code>created_at</code> and <code>updated_at</code> timestamps, an <code>@Audited</code> object inherently gains these columns directly on the database row:</p>
-    <ul class="list-disc pl-6 space-y-2 mb-4 text-gray-700 font-mono text-sm bg-gray-100 p-4 rounded">
-        <li>created_by (String - e.g., "John Doe")</li>
-        <li>created_date (TIMESTAMP)</li>
-        <li>last_modified_by (String - e.g., "Jane Doe")</li>
-        <li>last_modified_date (TIMESTAMP)</li>
-        <li>last_modified_user_id (String - Global Auth Provider UUID)</li>
-    </ul>
+    <p class="text-2xl text-slate-500 font-medium mb-12 leading-relaxed">
+        Achieve sub-millisecond accountability. GO-DUCK generates a forensic-grade auditing and hierarchical metering engine that tracks every action across your entire distributed ecosystem.
+    </p>
+
+    <!-- Key Stats Block -->
+    <div class="grid grid-cols-1 md:grid-cols-2 gap-8 mb-20">
+        <div class="bg-amber-50 p-8 rounded-3xl border border-amber-100 shadow-sm">
+            <h3 class="text-xl font-bold mb-4 flex items-center text-amber-900">
+                🔍 Row-Level Forensics
+            </h3>
+            <p class="text-amber-800/80 mb-4 font-medium italic">
+                Any GDL entity marked <code>@Audited</code> automatically tracks "Who did What and When" at the row level—persisting exact deltas into the global <code>audit_log</code>.
+            </p>
+            <div class="flex flex-wrap gap-2">
+                <span class="px-3 py-1 bg-white rounded-lg border border-amber-200 text-xs font-bold text-amber-700 uppercase">Keycloak Role Tracking</span>
+                <span class="px-3 py-1 bg-white rounded-lg border border-amber-200 text-xs font-bold text-amber-700 uppercase">Tenant Partitioning</span>
+            </div>
+        </div>
+        <div class="bg-slate-900 p-8 rounded-3xl border border-slate-800 shadow-xl border-t-4 border-t-amber-500">
+            <h3 class="text-xl font-bold mb-4 flex items-center text-amber-400">
+                📊 Hierarchical SaaS Metering
+            </h3>
+            <p class="text-indigo-100/70 mb-4 font-medium italic">
+                Track and limit API bandwidth in real-time via Redis. Automatically enforce dynamic quotas targeted at <strong>Individual Users</strong> or <strong>Realm Roles</strong>.
+            </p>
+            <div class="px-4 py-2 bg-indigo-500/20 rounded-xl border border-indigo-400/20 text-xs font-mono text-indigo-200">
+                X-Quota-Remaining: 984
+            </div>
+        </div>
+    </div>
 
-    <h3 class="font-semibold mb-2 mt-8">Layer 2: The Central `audit_log` Tracker Table</h3>
-    <p class="mb-4 text-gray-700">A global <code>audit_log</code> timeline is maintained across your database. For every mutable Action (CREATE, UPDATE, DELETE), the middleware diffs the pre-mutation HTTP object and the post-mutation object. It stores the explicit JSON payload changes asynchronously!</p>
-    <pre><code class="language-bash"># Quickly view all changes securely over REST 
-curl -X GET "http://localhost:8080/api/audit?entityName={{capitalize (defaultStr (lookup entities "0.name") "Entity")}}" \
-  -H "Authorization: Bearer YOUR_JWT"
-</code></pre>
-</section>
+    <!-- The Accountability Loop Section -->
+    <section class="mb-20">
+        <div class="bg-slate-950 rounded-[2.5rem] p-12 text-white shadow-2xl relative overflow-hidden">
+            <h2 class="text-3xl font-black mb-8 leading-tight tracking-tight">The Forensic Loop <br><span class="text-amber-500 italic font-medium tracking-wide italic leading-snug">Immutable Evidence.</span></h2>
+            
+            <div class="grid grid-cols-1 lg:grid-cols-3 gap-8 mb-12">
+                <div class="p-8 bg-white/5 rounded-3xl backdrop-blur-sm border border-white/10 hover:bg-white/10 transition-all duration-300">
+                    <div class="text-amber-500 text-4xl font-black mb-4">01</div>
+                    <h6 class="font-bold mb-2">Interception</h6>
+                    <p class="text-xs text-slate-400 leading-relaxed font-medium">Middleware extracts Keycloak Role, UserID, and TenantID from the incoming request envelope.</p>
+                </div>
+                <div class="p-8 bg-white/5 rounded-3xl backdrop-blur-sm border border-white/10 hover:bg-white/10 transition-all duration-300">
+                    <div class="text-amber-500 text-4xl font-black mb-4">02</div>
+                    <h6 class="font-bold mb-2">Verification</h6>
+                    <p class="text-xs text-slate-400 leading-relaxed font-medium">The SaaS Metering engine checks Redis for remaining bandwidth. Rejects if Daily/Monthly limits are exceeded.</p>
+                </div>
+                <div class="p-8 bg-white/5 rounded-3xl backdrop-blur-sm border border-white/10 hover:bg-white/10 transition-all duration-300">
+                    <div class="text-amber-500 text-4xl font-black mb-4">03</div>
+                    <h6 class="font-bold mb-2">Persistence</h6>
+                    <p class="text-xs text-slate-400 leading-relaxed font-medium">After the mutation succeeds, the GORM hook persists the full audit delta atomically within the same silo transaction.</p>
+                </div>
+            </div>
+        </div>
+    </section>
 
-<section class="mb-10">
-    <h2 class="text-2xl font-bold text-gray-800 mb-4 border-b pb-2">Multi-Tenant Metering</h2>
-    <p class="mb-4">API consumption tracking is inherently built in. When fully enabled, this records usage hits explicitly tracked against the <code>X-Tenant-ID</code> attached to the requests over time. This metric is ideal for setting up a usage-based billing logic or preventing internal abuse.</p>
-    
-    <pre><code class="language-bash"># The Tenant retrieves their own API request footprints:
-curl -X GET "http://localhost:8080/api/metering/usage" \
-  -H "Authorization: Bearer YOUR_JWT" \
-  -H "X-Tenant-ID: tenant_B_stripe"
-</code></pre>
-</section>
+    <!-- Detailed Audit Fields Section -->
+    <section class="mb-16">
+        <h2 class="text-3xl font-black text-slate-900 mb-8 tracking-tight italic tracking-widest text-center uppercase">Audit Schema Excellence</h2>
+        <div class="overflow-x-auto rounded-[2rem] border border-slate-200">
+            <table class="min-w-full divide-y divide-slate-200">
+                <thead class="bg-slate-50">
+                    <tr>
+                        <th class="px-6 py-4 text-left text-xs font-black text-slate-500 uppercase tracking-[0.1em]">Event Attribute</th>
+                        <th class="px-6 py-4 text-left text-xs font-black text-slate-500 uppercase tracking-[0.1em]">Security Value</th>
+                    </tr>
+                </thead>
+                <tbody class="bg-white divide-y divide-slate-100">
+                    <tr><td class="px-6 py-4 font-bold text-slate-900">Actor Identity</td><td class="px-6 py-4 text-sm text-slate-600 font-medium italic">Captures the Subject (UserID) and Realm Role of the initiator.</td></tr>
+                    <tr><td class="px-6 py-4 font-bold text-slate-900">Historical Delta</td><td class="px-6 py-4 text-sm text-slate-600 font-medium italic">Full JSONB diff of the object before and after the mutation.</td></tr>
+                    <tr><td class="px-6 py-4 font-bold text-slate-900">Trace Propogation</td><td class="px-6 py-4 text-sm text-slate-600 font-medium italic">Links the audit log directly to the OpenTelemetry TraceID.</td></tr>
+                    <tr><td class="px-6 py-4 font-bold text-slate-900">Tenant Isolation</td><td class="px-6 py-4 text-sm text-slate-600 font-medium italic">Audit logs are partitioned by Silo, ensuring no cross-tenant leakage.</td></tr>
+                </tbody>
+            </table>
+        </div>
+    </section>
+</div>

package/templates/docs/pages/cli.hbs

@@ -81,3 +81,21 @@ go-duck import-gdl my_new_schema.gdl -o ./MY_APP</code></pre>
         </ul>
     </div>
 </section>
+
+<!-- NEXT STEPS -->
+<div class="flex flex-col md:flex-row gap-4 mt-20">
+    <a href="gdl-advanced.html" class="flex-1 p-6 bg-slate-100 rounded-2xl text-slate-900 hover:bg-slate-200 transition-colors group">
+        <div class="text-xs font-bold text-slate-500 uppercase tracking-widest mb-2">Previous Category</div>
+        <div class="text-xl font-bold flex items-center text-slate-800">
+            <svg class="w-5 h-5 mr-2 group-hover:-translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 17l-5-5m0 0l5-5m-5 5h12" /></svg>
+            🔮 Advanced GDL
+        </div>
+    </a>
+    <a href="configuration.html" class="flex-1 p-6 bg-indigo-700 rounded-2xl text-white hover:bg-indigo-800 transition-colors group text-right">
+        <div class="text-xs font-bold text-indigo-200 uppercase tracking-widest mb-2">Next Category</div>
+        <div class="text-xl font-bold flex items-center justify-end">
+            ⚙️ Master Configuration
+            <svg class="w-5 h-5 ml-2 group-hover:translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 7l5 5m0 0l-5 5m5-5H6" /></svg>
+        </div>
+    </a>
+</div>

package/templates/docs/pages/configuration.hbs

@@ -0,0 +1,241 @@
+<div class="prose prose-slate max-w-none">
+    <!-- Hero Section -->
+    <div class="flex items-center space-x-3 mb-10 text-indigo-700">
+        <div class="p-4 bg-gradient-to-br from-indigo-600 to-violet-800 rounded-3xl shadow-xl shadow-indigo-100">
+            <svg class="w-10 h-10 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z" />
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
+            </svg>
+        </div>
+        <div>
+            <h1 class="text-4xl font-black text-slate-900 m-0 tracking-tight leading-none">Master Configuration</h1>
+            <p class="text-indigo-600 font-bold tracking-widest uppercase text-[10px] mt-2 ml-1">The Fullest config.yaml Technical Reference</p>
+        </div>
+    </div>
+
+    <p class="text-xl text-slate-600 mb-12 italic border-l-4 border-indigo-500 pl-6 leading-relaxed">
+        The <code>config.yaml</code> file is the "Central Nervous System" of your GO-DUCK microservice. It controls everything from high-performance server tuning to distributed resilience and multi-cloud object storage.
+    </p>
+
+    <!-- YAML PREVIEW -->
+    <div class="bg-slate-900 rounded-[2.5rem] p-10 text-white mb-16 shadow-2xl relative overflow-hidden group">
+        <div class="absolute inset-0 bg-gradient-to-br from-indigo-900/40 to-transparent"></div>
+        <div class="flex justify-between items-center mb-6 relative z-10">
+            <h3 class="text-emerald-400 font-mono text-sm tracking-widest uppercase">The "Fullest" Template</h3>
+            <span class="px-3 py-1 bg-white/10 rounded-full text-[10px] font-bold tracking-widest text-slate-400 uppercase">YAML 1.2</span>
+        </div>
+        <pre class="bg-transparent border-none p-0 m-0 overflow-x-auto relative z-10"><code class="language-yaml">go-duck:
+  name: "go-duck-master-app"
+  version: "1.0.0"
+  
+  # --- Network & Server ---
+  server:
+    port: 8080
+    read-timeout: "30s"
+    write-timeout: "30s"
+    grpc:
+      addr: ":9000"
+      network: "tcp"
+    cors:
+      allow-origins: ["*"]
+      allow-methods: ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"]
+      
+  # --- Persistence (Hybrid Store) ---
+  datasource:
+    host: "localhost"
+    port: 5432
+    username: "postgres"
+    password: "password"
+    database: "go_duck_db"
+    max-open-conns: 25
+    mongodb:
+      enabled: true
+      uri: "mongodb://localhost:27017"
+      database: "go_duck_mongo"
+
+  # --- Messaging Hub ---
+  messaging:
+    mqtt:
+      enabled: true
+      broker: "tcp://localhost:1883"
+    nats:
+      enabled: true
+      url: "nats://localhost:4222"
+
+  # --- Object Storage ---
+  storage:
+    s3: { enabled: false, bucket: "bucket-name", region: "us-east-1" }
+    gcs: { enabled: false, bucket: "bucket-name", credentials-file: "keys.json" }
+    minio: { enabled: true, bucket: "dev", endpoint: "localhost:9000" }
+
+  # --- Search Engine ---
+  elasticsearch:
+    enabled: true
+    addresses: ["http://localhost:9200"]
+    auto_sync: true</code></pre>
+    </div>
+
+    <!-- PARAMETER REFERENCE -->
+    <h2 class="text-3xl font-black text-slate-900 mb-8 tracking-tight">Technical Guideline Reference</h2>
+
+    <!-- SECTION: PROJECT -->
+    <section class="mb-16">
+        <h3 class="text-xl font-bold text-indigo-700 mb-4 flex items-center">
+            <span class="w-2 h-2 rounded-full bg-indigo-600 mr-2"></span>
+            1. Project Identity (go-duck)
+        </h3>
+        <div class="overflow-hidden border border-slate-200 rounded-2xl shadow-sm">
+            <table class="w-full text-left border-collapse">
+                <thead class="bg-slate-50 border-b border-slate-200">
+                    <tr>
+                        <th class="p-4 text-xs font-black text-slate-500 uppercase tracking-widest">Parameter</th>
+                        <th class="p-4 text-xs font-black text-slate-500 uppercase tracking-widest">Purpose</th>
+                    </tr>
+                </thead>
+                <tbody class="text-sm">
+                    <tr class="border-b border-slate-100">
+                        <td class="p-4 font-mono text-indigo-600">name</td>
+                        <td class="p-4 text-slate-600">The root Go module name. Used for all internal imports and project scaffolding.</td>
+                    </tr>
+                    <tr>
+                        <td class="p-4 font-mono text-indigo-600">version</td>
+                        <td class="p-4 text-slate-600">Semantic versioning injected into Swagger docs and internal build manifests.</td>
+                    </tr>
+                </tbody>
+            </table>
+        </div>
+    </section>
+
+    <!-- SECTION: PERSISTENCE -->
+    <section class="mb-16">
+        <h3 class="text-xl font-bold text-emerald-700 mb-4 flex items-center">
+            <span class="w-2 h-2 rounded-full bg-emerald-600 mr-2"></span>
+            2. Hybrid Persistence (datasource)
+        </h3>
+        <div class="overflow-hidden border border-slate-200 rounded-2xl shadow-sm">
+            <table class="w-full text-left border-collapse">
+                <thead class="bg-slate-50 border-b border-slate-200">
+                    <tr>
+                        <th class="p-4 text-xs font-black text-slate-500 uppercase tracking-widest">Parameter</th>
+                        <th class="p-4 text-xs font-black text-slate-500 uppercase tracking-widest">Purpose</th>
+                    </tr>
+                </thead>
+                <tbody class="text-sm">
+                    <tr class="border-b border-slate-100">
+                        <td class="p-4 font-mono text-emerald-600">host/port/database</td>
+                        <td class="p-4 text-slate-600">PostgreSQL connection details for the Relational Silo and Multi-Tenant Registry.</td>
+                    </tr>
+                    <tr class="border-b border-slate-100">
+                        <td class="p-4 font-mono text-emerald-600">max-open-conns</td>
+                        <td class="p-4 text-slate-600">GORM connection pool limit. Critical for preventing port exhaustion in federated environments.</td>
+                    </tr>
+                    <tr>
+                        <td class="p-4 font-mono text-emerald-600">mongodb.enabled</td>
+                        <td class="p-4 text-slate-600">Toggles the NoSQL Document engine. If true, the app supports <code>@isDocument</code> and recursive GDL structures.</td>
+                    </tr>
+                </tbody>
+            </table>
+        </div>
+    </section>
+
+    <!-- SECTION: MESSAGING -->
+    <section class="mb-16">
+        <h3 class="text-xl font-bold text-sky-700 mb-4 flex items-center">
+            <span class="w-2 h-2 rounded-full bg-sky-600 mr-2"></span>
+            3. Unified Messaging Hub (messaging)
+        </h3>
+        <div class="overflow-hidden border border-slate-200 rounded-2xl shadow-sm">
+            <table class="w-full text-left border-collapse">
+                <thead class="bg-slate-50 border-b border-slate-200">
+                    <tr>
+                        <th class="p-4 text-xs font-black text-slate-500 uppercase tracking-widest">Parameter</th>
+                        <th class="p-4 text-xs font-black text-slate-500 uppercase tracking-widest">Purpose</th>
+                    </tr>
+                </thead>
+                <tbody class="text-sm">
+                    <tr class="border-b border-slate-100">
+                        <td class="p-4 font-mono text-sky-600">mqtt.broker</td>
+                        <td class="p-4 text-slate-600">Real-time notification hub. Broadcasts schema mutations directly to the frontend for UI reactivity.</td>
+                    </tr>
+                    <tr>
+                        <td class="p-4 font-mono text-sky-600">nats.url</td>
+                        <td class="p-4 text-slate-600">High-performance internal streaming. Powering the CQRS logic and cross-microservice events.</td>
+                    </tr>
+                </tbody>
+            </table>
+        </div>
+    </section>
+
+    <!-- SECTION: STORAGE -->
+    <section class="mb-16">
+        <h3 class="text-xl font-bold text-amber-700 mb-4 flex items-center">
+            <span class="w-2 h-2 rounded-full bg-amber-600 mr-2"></span>
+            4. Universal Storage Bridge (storage)
+        </h3>
+        <p class="text-sm text-slate-500 mb-4 italic leading-relaxed">GO-DUCK provides a unified Go Interface for 7 different providers. Switch providers by simply changing the 'enabled' flag.</p>
+        <div class="overflow-hidden border border-slate-200 rounded-2xl shadow-sm">
+            <table class="w-full text-left border-collapse">
+                <thead class="bg-slate-50 border-b border-slate-200">
+                    <tr>
+                        <th class="p-4 text-xs font-black text-slate-500 uppercase tracking-widest">Provider</th>
+                        <th class="p-4 text-xs font-black text-slate-500 uppercase tracking-widest">Key Configuration</th>
+                    </tr>
+                </thead>
+                <tbody class="text-sm text-slate-600">
+                    <tr class="border-b border-slate-100 italic">
+                        <td class="p-4 font-bold text-slate-900">AWS S3 / R2</td>
+                        <td class="p-4">bucket, region, access-key, secret-key</td>
+                    </tr>
+                    <tr class="border-b border-slate-100 italic font-medium">
+                        <td class="p-4 font-bold text-slate-900">Google GCS</td>
+                        <td class="p-4 italic underline decoration-amber-200 underline-offset-4">credentials-file (JSON service account path)</td>
+                    </tr>
+                    <tr class="border-b border-slate-100 italic">
+                        <td class="p-4 font-bold text-slate-900">SFTP / SSH</td>
+                        <td class="p-4">host, port, username, key-file</td>
+                    </tr>
+                    <tr>
+                        <td class="p-4 font-bold text-slate-900">GitHub Bootstrap</td>
+                        <td class="p-4 italic">owner, repo, token, files (Automated infrastructure discovery)</td>
+                    </tr>
+                </tbody>
+            </table>
+        </div>
+    </section>
+
+    <!-- RESILIENCE & SEARCH -->
+    <div class="grid grid-cols-1 md:grid-cols-2 gap-8 mb-20">
+        <div class="p-8 bg-rose-50 rounded-[2.5rem] border border-rose-100">
+            <h4 class="text-lg font-black text-rose-900 mb-4 uppercase tracking-tighter">Distributed Resilience</h4>
+            <ul class="text-sm text-rose-700 italic space-y-4">
+                <li><strong>Circuit Breaker:</strong> Prevents cascading failures when DB/MQ or Search is down.</li>
+                <li><strong>Rate Limit:</strong> Distributed Redis-backed throttler (RPS/Burst) targeting by Keycloak Identity.</li>
+            </ul>
+        </div>
+        <div class="p-8 bg-blue-50 rounded-[2.5rem] border border-blue-100">
+            <h4 class="text-lg font-black text-blue-900 mb-4 uppercase tracking-tighter">Industrial Search</h4>
+            <ul class="text-sm text-blue-700 italic space-y-4">
+                <li><strong>Elasticsearch:</strong> Full-text engine with Spring-style query string mapping.</li>
+                <li><strong>Auto Sync:</strong> Real-time indexing triggered by Repository mutators.</li>
+            </ul>
+        </div>
+    </div>
+
+    <!-- NEXT LINK -->
+    <div class="flex flex-col md:flex-row gap-4 mt-20">
+        <a href="cli.html" class="flex-1 p-6 bg-slate-100 rounded-2xl text-slate-900 hover:bg-slate-200 transition-colors group">
+            <div class="text-xs font-bold text-slate-500 uppercase tracking-widest mb-2">Previous Category</div>
+            <div class="text-xl font-bold flex items-center text-slate-800">
+                <svg class="w-5 h-5 mr-2 group-hover:-translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 17l-5-5m0 0l5-5m-5 5h12" /></svg>
+                💻 CLI Reference
+            </div>
+        </a>
+        <a href="rest.html" class="flex-1 p-6 bg-indigo-700 rounded-2xl text-white hover:bg-indigo-800 transition-colors group text-right">
+            <div class="text-xs font-bold text-indigo-200 uppercase tracking-widest mb-2">Next Category</div>
+            <div class="text-xl font-bold flex items-center justify-end">
+                📡 REST & Search API
+                <svg class="w-5 h-5 ml-2 group-hover:translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 7l5 5m0 0l-5 5m5-5H6" /></svg>
+            </div>
+        </a>
+    </div>
+</div>

package/templates/docs/pages/datadog.hbs

@@ -0,0 +1,46 @@
+<h1 class="text-4xl font-extrabold text-gray-900 mb-4">Datadog & Cloud Monitoring</h1>
+<p class="text-lg text-gray-600 mb-8">Harness the power of enterprise-grade observability with GO-DUCK's native Datadog integration for logs, metrics, and APM.</p>
+
+<section class="mb-10">
+    <h2 class="text-2xl font-bold text-gray-800 mb-4 border-b pb-2">Overview</h2>
+    <p class="mb-4 text-gray-700">GO-DUCK provides a specialized <code>logger</code> package that abstracts the complexity of streaming logs and metrics to Datadog. It supports environment-based configuration, ensuring you only pay for what you need in production while keeping local development logs clean.</p>
+</section>
+
+<section class="mb-10">
+    <h2 class="text-2xl font-bold text-gray-800 mb-4 border-b pb-2">Log Streaming</h2>
+    <p class="mb-4">Our logger is designed to be Datadog-ready. When <code>datadog.enabled</code> is set to true, logs are formatted as JSON and sent directly to the Datadog API or via a local Datadog Agent.</p>
+    
+    <div class="bg-blue-50 border-l-4 border-blue-500 p-4 mb-6 rounded-r">
+        <p class="text-blue-900"><strong>Pro-Tip:</strong> Use structured logging with <code>logger.Info("User logged in", zap.String("userID", user.ID))</code> to enable powerful faceted searches in the Datadog Log Explorer.</p>
+    </div>
+
+    <h3 class="font-semibold mb-2 mt-6 text-xl">Configuration</h3>
+    <pre><code class="language-yaml">go-duck:
+  logging:
+    level: "info"
+    datadog:
+      enabled: true
+      api-key: "${DD_API_KEY}"
+      site: "datadoghq.com"
+      service: "{{appName}}"
+      env: "production"</code></pre>
+</section>
+
+<section class="mb-10">
+    <h2 class="text-2xl font-bold text-gray-800 mb-4 border-b pb-2">Custom Metrics (DogStatsD)</h2>
+    <p class="mb-4 text-gray-700">The generated code includes a pre-initialized Statsd client. You can push custom business metrics directly from your Go services:</p>
+    <ul class="list-disc pl-8 mb-4 text-gray-700 space-y-2">
+        <li><code>logger.Count("orders.placed", 1, tags, 1.0)</code> - Tracks volume.</li>
+        <li><code>logger.Histogram("payment.latency", duration, tags, 1.0)</code> - Tracks performance distribution.</li>
+        <li><code>logger.Gauge("active.users", count, tags, 1.0)</code> - Tracks point-in-time value.</li>
+    </ul>
+</section>
+
+<section class="mb-10">
+    <h2 class="text-2xl font-bold text-gray-800 mb-4 border-b pb-2">External Resources</h2>
+    <ul class="space-y-2">
+        <li><a href="https://docs.datadoghq.com/logs/" target="_blank" class="text-indigo-600 hover:underline">Datadog Logs Documentation &rarr;</a></li>
+        <li><a href="https://docs.datadoghq.com/metrics/dogstatsd/" target="_blank" class="text-indigo-600 hover:underline">DogStatsD Guide &rarr;</a></li>
+        <li><a href="https://docs.datadoghq.com/tracing/" target="_blank" class="text-indigo-600 hover:underline">Datadog APM & Distributed Tracing &rarr;</a></li>
+    </ul>
+</section>

package/templates/docs/pages/elasticsearch.hbs

@@ -0,0 +1,121 @@
+<div class="prose prose-slate max-w-none">
+    <!-- Marketing Hero -->
+    <div class="flex items-center space-x-3 mb-8 text-orange-600">
+        <div class="p-4 bg-gradient-to-br from-orange-500 to-orange-700 rounded-2xl shadow-lg shadow-orange-100">
+            <svg class="w-8 h-8 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
+            </svg>
+        </div>
+        <h1 class="text-5xl font-black text-slate-900 m-0 tracking-tight leading-tight">Elasticsearch: The Search Powerhouse</h1>
+    </div>
+
+    <p class="text-2xl text-slate-500 font-medium mb-12 leading-relaxed">
+        Unlock high-performance, fuzzy full-text search across your entire federated ecosystem. GO-DUCK bridges your relational silos with an elite Elasticsearch sync engine.
+    </p>
+
+    <!-- Marketing Hero Section -->
+    <section class="grid grid-cols-1 md:grid-cols-3 gap-8 mb-20">
+        <div class="bg-gradient-to-br from-orange-50 to-white p-8 rounded-[2rem] border border-orange-100 shadow-sm">
+            <h3 class="text-orange-900 font-black mb-4">Spring-Style Queries</h3>
+            <p class="text-slate-600 leading-relaxed text-sm">Query your data using a simple, powerful query string syntax inspired by Spring Data Elasticsearch.</p>
+        </div>
+        <div class="bg-gradient-to-br from-blue-50 to-white p-8 rounded-[2rem] border border-blue-100 shadow-sm">
+            <h3 class="text-blue-900 font-black mb-4">Transactional Sync</h3>
+            <p class="text-slate-600 leading-relaxed text-sm">Entities marked with <code class="bg-blue-100 px-2 rounded">@Searchable</code> are automatically indexed the moment they hit the database.</p>
+        </div>
+        <div class="bg-gradient-to-br from-purple-50 to-white p-8 rounded-[2rem] border border-purple-100 shadow-sm">
+            <h3 class="text-purple-900 font-black mb-4">Multi-Tenant Isolation</h3>
+            <p class="text-slate-600 leading-relaxed text-sm">Search indices are automatically prefixed and partitioned to ensure zero data leakage between tenants.</p>
+        </div>
+    </section>
+
+    <!-- Technical Core -->
+    <section class="mb-20">
+        <h2 class="text-3xl font-black text-slate-900 mb-8 tracking-tight italic underline decoration-orange-600 underline-offset-8">Search Controller Reference</h2>
+        <div class="bg-slate-900 rounded-[2.5rem] p-10 border border-slate-800 shadow-2xl">
+            <div class="flex items-center space-x-2 mb-6">
+                <span class="px-3 py-1 bg-green-500/20 text-green-400 rounded-full text-xs font-black uppercase tracking-widest">GET</span>
+                <code class="text-indigo-400 font-mono">/api/search/:entity?q=...</code>
+            </div>
+            
+            <div class="space-y-6">
+                <div>
+                    <h5 class="text-white font-bold mb-2">Example: Fuzzy Search</h5>
+                    <div class="p-4 bg-slate-800 rounded-2xl font-mono text-sm text-indigo-300">
+                        GET /api/search/car?q=Toyta
+                    </div>
+                    <p class="text-slate-400 text-xs mt-2 italic">// Matches "Toyota" via automatic ES Fuzziness</p>
+                </div>
+
+                <div class="overflow-x-auto rounded-2xl border border-white/5">
+                    <table class="min-w-full divide-y divide-slate-800">
+                        <thead class="bg-slate-800/50">
+                            <tr>
+                                <th class="px-6 py-4 text-left text-xs font-black uppercase text-slate-500">Query Pattern</th>
+                                <th class="px-6 py-4 text-left text-xs font-black uppercase text-slate-500">Elasticsearch Execution</th>
+                            </tr>
+                        </thead>
+                        <tbody class="divide-y divide-slate-800 text-sm text-slate-300">
+                            <tr>
+                                <td class="px-6 py-4 font-mono font-bold text-orange-400">q=...</td>
+                                <td class="px-6 py-4 italic">multi_match with fuzziness: AUTO on all fields</td>
+                            </tr>
+                            <tr>
+                                <td class="px-6 py-4 font-mono font-bold text-orange-400">(empty)</td>
+                                <td class="px-6 py-4 italic">match_all (standard listing)</td>
+                            </tr>
+                        </tbody>
+                    </table>
+                </div>
+            </div>
+        </div>
+    </section>
+
+    <!-- Configuration -->
+    <section class="mb-20">
+        <h2 class="text-3xl font-black text-slate-900 mb-8 tracking-tight">Activating the Search Engine</h2>
+        <div class="grid grid-cols-1 md:grid-cols-2 gap-12 items-start">
+            <div class="space-y-6">
+                <div class="bg-white p-8 rounded-[2rem] border border-slate-200 shadow-sm relative overflow-hidden group">
+                    <div class="absolute top-0 right-0 p-4 opacity-5 group-hover:opacity-20 transition-opacity">
+                        <svg class="w-24 h-24 text-orange-600" fill="currentColor" viewBox="0 0 24 24"><path d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/></svg>
+                    </div>
+                    <h4 class="text-xl font-black mb-4">1. Annotate your GDL</h4>
+                    <p class="text-slate-500 text-sm leading-relaxed mb-6">Simply add <code class="bg-orange-100 text-orange-700 px-2 rounded">@Searchable</code> to any entity block.</p>
+                    <div class="bg-slate-900 rounded-2xl p-4 font-mono text-xs text-indigo-300">
+                        @Searchable @Audited<br>
+                        entity Car { ... }
+                    </div>
+                </div>
+
+                <div class="bg-white p-8 rounded-[2rem] border border-slate-200 shadow-sm relative overflow-hidden group">
+                    <h4 class="text-xl font-black mb-4">2. Enable in Config</h4>
+                    <p class="text-slate-500 text-sm leading-relaxed mb-6">Toggle the search engine globally in your <code class="bg-slate-100 px-1 rounded">config.yaml</code>.</p>
+                    <div class="bg-slate-900 rounded-2xl p-4 font-mono text-xs text-indigo-300">
+                        elasticsearch:<br>
+                        &nbsp;&nbsp;enabled: true<br>
+                        &nbsp;&nbsp;auto_sync: true
+                    </div>
+                </div>
+            </div>
+            
+            <div class="bg-orange-50 rounded-[2.5rem] p-10 border border-orange-100">
+                <h4 class="text-2xl font-black text-orange-900 mb-6 italic italic underline decoration-orange-300 underline-offset-4">Why Elasticsearch?</h4>
+                <ul class="space-y-4">
+                    <li class="flex items-start space-x-3">
+                        <div class="mt-1 flex-shrink-0 w-2 h-2 bg-orange-600 rounded-full"></div>
+                        <p class="text-sm text-orange-800 font-medium">Offload heavy search queries from your transactional database.</p>
+                    </li>
+                    <li class="flex items-start space-x-3">
+                        <div class="mt-1 flex-shrink-0 w-2 h-2 bg-orange-600 rounded-full"></div>
+                        <p class="text-sm text-orange-800 font-medium">Enterprise-grade relevancy scoring and multi-language support.</p>
+                    </li>
+                    <li class="flex items-start space-x-3">
+                        <div class="mt-1 flex-shrink-0 w-2 h-2 bg-orange-600 rounded-full"></div>
+                        <p class="text-sm text-orange-800 font-medium">Handle millions of records with sub-millisecond response times.</p>
+                    </li>
+                </ul>
+            </div>
+        </div>
+    </section>
+</div>