go-duck-cli 1.2.11 → 1.3.0

package/templates/docs/index.html.hbs

@@ -69,7 +69,8 @@ go run main.go</code></pre>
                 <h2 class="text-2xl font-bold text-gray-800 mb-4 border-b pb-2">1. REST APIs & Generic Search</h2>
                 <p class="mb-4">The application provides standard RESTful CRUD endpoints for all generated entities (e.g., {{#if entities.length}}{{entities.[0].name}}{{else}}Entity{{/if}}).</p>
                 
-                <h3 class="font-semibold mb-2">Standard CRUD:</h3>
+                <h3 class="font-semibold mb-2">Standard CRUD (Multi-Protocol):</h3>
+                <p class="mb-2 text-sm text-gray-600">The REST API natively supports JSON and MessagePack based on your <code>application.yml</code> settings.</p>
                 <pre><code class="language-http">GET /api/{{#if entities.length}}{{toLowerCase entities.[0].name}}s{{else}}entities{{/if}}?page=1&pageSize=10
 POST /api/{{#if entities.length}}{{toLowerCase entities.[0].name}}s{{else}}entities{{/if}}
 PUT /api/{{#if entities.length}}{{toLowerCase entities.[0].name}}s{{else}}entities{{/if}}/:id
@@ -138,6 +139,17 @@ mosquitto_sub -h localhost -p {{mqttPort}} -t "go-duck/events/#" -u dev_user -P
                 <p class="text-sm mt-2">Example topic: <code>go-duck/events/{{#if entities.length}}{{toLowerCase entities.[0].name}}{{else}}entity{{/if}}/CREATE</code></p>
             </section>
 
+            <!-- gRPC-Web -->
+            <section id="grpc-web" class="content-section">
+                <h2 class="text-2xl font-bold text-gray-800 mb-4 border-b pb-2">gRPC & gRPC-Web</h2>
+                <p class="mb-4">The Kratos gRPC engine powers blazing fast service-to-service communication. For frontend developers, we automatically start a <strong>gRPC-Web Proxy</strong>.</p>
+                <ul class="list-disc pl-6 space-y-2 mb-4">
+                    <li>The core Kratos gRPC server runs on <code>:9000</code> (configurable).</li>
+                    <li>The <strong>gRPC-Web Proxy</strong> runs on <code>:9090</code>, translating HTTP/1.1 calls to HTTP/2.</li>
+                    <li>Frontend apps (React/Angular) can directly call Protobuf endpoints using standard <code>grpc-web</code> generated clients without hitting the REST APIs!</li>
+                </ul>
+            </section>
+
             <!-- Kratos gRPC -->
             <section id="grpc-kratos" class="content-section">
                 <h2 class="text-2xl font-bold text-gray-800 mb-4 border-b pb-2">Kratos Secured gRPC APIs</h2>

package/templates/docs/pages/cli.hbs

@@ -44,17 +44,33 @@ go-duck import-gdl my_new_schema.gdl -o ./MY_APP</code></pre>
         <span class="w-8 h-8 rounded-lg bg-emerald-100 text-emerald-600 flex items-center justify-center mr-3 text-sm">
             <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7v8a2 2 0 002 2h6M8 7V5a2 2 0 012-2h4.586a1 1 0 01.707.293l4.414 4.414a1 1 0 01.293.707V15a2 2 0 01-2 2h-2M8 7H6a2 2 0 00-2 2v10a2 2 0 002 2h8a2 2 0 002-2v-2"></path></svg>
         </span>
-        2. Persistence Intelligence & the `.go-duck/` Folder
+        2. Schema Evolution & the `.go-duck/` State
     </h2>
-    <p class="mb-4 text-slate-600 leading-relaxed font-medium">"If I run the generator twice, will it overwrite my database migrations?" <strong>No.</strong></p>
+    <p class="mb-4 text-slate-600 leading-relaxed font-medium">"If I run the generator to import a new GDL, will it overwrite my database or delete existing entities?" <strong>No, thanks to stateful evolution.</strong></p>
     
-    <p class="mb-6 text-slate-600 leading-relaxed">The generator maintains a stateful snapshot of every entity it has ever generated inside the hidden <code class="bg-slate-100 px-1 py-0.5 rounded text-slate-800 font-mono text-sm">.go-duck/</code> directory at the root of your target project. When you run <code>import-gdl</code>, the code parser literally diffs your new file against the JSON representations in <code>.go-duck/</code> to intelligently assess the exact Table changes necessary without executing ghost migrations.</p>
+    <p class="mb-6 text-slate-600 leading-relaxed">The generator maintains a stateful snapshot of every entity it has ever generated inside the hidden <code class="bg-slate-100 px-1 py-0.5 rounded text-slate-800 font-mono text-sm">.go-duck/</code> directory at the root of your target project. When you run <code>import-gdl</code>, the CLI intelligently merges existing entities with newly parsed entities and executes targeted diff operations:</p>
+
+    <!-- EVOLUTION TYPE CARDS -->
+    <div class="grid grid-cols-1 md:grid-cols-3 gap-6 mb-8">
+        <div class="p-6 bg-slate-50 border border-slate-200 rounded-2xl">
+            <span class="text-xs font-bold text-indigo-600 uppercase tracking-wide block mb-2 font-mono">1. Snapshot Merging</span>
+            <p class="text-xs text-slate-600 leading-relaxed m-0">Supports splitting your entities into multiple GDL files. Unspecified active models are loaded from the <code>.go-duck/</code> folder and merged with new entities, keeping active routers and endpoints in sync.</p>
+        </div>
+        <div class="p-6 bg-slate-50 border border-slate-200 rounded-2xl">
+            <span class="text-xs font-bold text-emerald-600 uppercase tracking-wide block mb-2 font-mono">2. Column Alterations</span>
+            <p class="text-xs text-slate-600 leading-relaxed m-0">Adding, dropping, or modifying fields inside entity blocks generates specific <code>ADD COLUMN</code> or <code>DROP COLUMN</code> SQL statements in a timestamped Goose migration file.</p>
+        </div>
+        <div class="p-6 bg-slate-50 border border-slate-200 rounded-2xl">
+            <span class="text-xs font-bold text-rose-600 uppercase tracking-wide block mb-2 font-mono">3. Complete Purging</span>
+            <p class="text-xs text-slate-600 leading-relaxed m-0">Marking an entity with the <code>@Delete</code> annotation automatically triggers a database <code>DROP TABLE</code> SQL migration, purges all generated Go/Protobuf code files, and clears its snapshot.</p>
+        </div>
+    </div>
 
     <div class="bg-rose-50 border border-rose-200 p-5 mb-6 rounded-xl flex items-start shadow-sm shadow-rose-100/50">
         <svg class="w-6 h-6 text-rose-500 mt-0.5 mr-3 flex-shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"></path></svg>
         <div>
             <h4 class="font-bold text-rose-900 mb-1">Warning</h4>
-            <p class="text-rose-800 text-sm leading-relaxed"><strong>Never delete `.go-duck/`</strong> unless you are intentionally wiping the database and starting configuration completely from zero.</p>
+            <p class="text-rose-800 text-sm leading-relaxed"><strong>Never manually delete `.go-duck/`</strong> unless you are intentionally wiping the entire database state and starting configuration completely from scratch.</p>
         </div>
     </div>
 </section>

package/templates/docs/pages/gdl-annotations.hbs

@@ -100,6 +100,23 @@
                 <p class="text-[11px] text-indigo-900 m-0 font-medium font-mono leading-tight">Architectural Impact: Scaffolds routes into the <code class="text-indigo-600 text-[10px]">/api/open/*</code> group, bypassing the OIDC Validator middleware chain.</p>
             </div>
         </div>
+
+        <!-- @Delete -->
+        <div class="p-10 bg-rose-50 border border-rose-100 rounded-[3rem] shadow-sm transition-all duration-300 hover:shadow-rose-200 group relative overflow-hidden">
+            <div class="absolute top-0 right-0 p-6 opacity-[0.03] group-hover:opacity-[0.07] transition-opacity">
+                <svg class="w-32 h-32 text-rose-900" fill="currentColor" viewBox="0 0 20 20"><path fill-rule="evenodd" d="M9 2a1 1 0 00-.894.553L7.382 4H4a1 1 0 000 2v10a2 2 0 002 2h8a2 2 0 002-2V6a1 1 0 100-2h-3.382l-.724-1.447A1 1 0 0011 2H9zM7 8a1 1 0 012 0v6a1 1 0 11-2 0V8zm5-1a1 1 0 00-1 1v6a1 1 0 102 0V8a1 1 0 00-1-1z" clip-rule="evenodd"></path></svg>
+            </div>
+            <div class="flex items-center justify-between mb-8">
+                <code class="text-rose-700 font-mono font-black text-2xl group-hover:scale-105 transition-transform">@Delete</code>
+                <div class="w-12 h-12 bg-white rounded-2xl flex items-center justify-center text-2xl shadow-sm">🗑️</div>
+            </div>
+            <h4 class="text-lg font-black text-slate-900 mb-4 m-0 uppercase tracking-tighter">Entity Deletion</h4>
+            <p class="text-sm text-slate-700 leading-relaxed m-0 italic mb-6">Triggers full entity cleanup. Upon import, the generator purges all generated source code (models, controllers, repositories) and generates a database <code>DROP TABLE</code> migration.</p>
+            <div class="p-4 bg-white/50 rounded-2xl border border-rose-200 border-dashed">
+                <span class="text-[10px] font-bold text-rose-400 uppercase tracking-widest block mb-2 font-mono">Architectural Impact</span>
+                <p class="text-[11px] text-rose-900 m-0 font-medium font-mono leading-tight">Removes snapshots from .go-duck/, wipes Go files, and scaffolds drop SQL statements.</p>
+            </div>
+        </div>
     </div>
 
     <!-- COMPLEX EXAMPLE -->

package/templates/docs/pages/rest.hbs

@@ -129,6 +129,27 @@
         </div>
     </section>
 
+    <!-- PAGINATION & SORTING -->
+    <section class="mb-20">
+        <h2 class="text-3xl font-black text-slate-900 mb-8 tracking-tight italic underline decoration-indigo-600 underline-offset-8">Pagination & Dynamic Sorting</h2>
+        <div class="p-8 bg-slate-50 border border-slate-200 rounded-[2.5rem] shadow-sm">
+            <p class="text-slate-600 mb-6">List endpoints support pagination and dynamic sorting for both relational (PostgreSQL) and document-based (MongoDB) silos.</p>
+            
+            <div class="grid grid-cols-1 md:grid-cols-2 gap-8">
+                <div class="p-6 bg-white rounded-2xl border border-slate-100 shadow-sm border-l-4 border-l-indigo-600">
+                    <h4 class="font-bold text-slate-900 mb-2">Pagination</h4>
+                    <p class="text-xs text-slate-500 mb-4">Specify the page number (1-indexed) and limit size via standard query parameters. The response contains total count in the <code>X-Total-Count</code> header.</p>
+                    <code class="text-xs font-mono font-bold text-indigo-700 bg-indigo-50 px-3 py-1 rounded-full">GET /api/v1/car?page=1&amp;size=20</code>
+                </div>
+                <div class="p-6 bg-white rounded-2xl border border-slate-100 shadow-sm border-l-4 border-l-emerald-600">
+                    <h4 class="font-bold text-slate-900 mb-2">Dynamic Sorting</h4>
+                    <p class="text-xs text-slate-500 mb-4">Sort fields dynamically in ascending (default or <code>asc</code>) or descending (<code>desc</code>) order. The sorting format is <code>?sort=fieldname,direction</code>.</p>
+                    <code class="text-xs font-mono font-bold text-emerald-700 bg-emerald-50 px-3 py-1 rounded-full">GET /api/v1/car?sort=price,desc</code>
+                </div>
+            </div>
+        </div>
+    </section>
+
     <!-- RPC OPERATORS -->
     <section class="mb-10 text-center">
         <h2 class="text-2xl font-black text-slate-900 mb-6 italic italic underline decoration-indigo-200 underline-offset-8 decoration-8 font-serif uppercase tracking-widest">GORM Filter Reference</h2>

package/templates/go/controller.go.hbs

@@ -3,6 +3,7 @@ package controllers
 import (
 	"net/http"
 	"strconv"
+	"strings"
 	{{#if isSearchable}}
 	"context"
 	{{/if}}
@@ -22,6 +23,8 @@ import (
 	"{{app_name}}/internal/search"
 	{{/if}}
 	"github.com/gin-gonic/gin"
+	"github.com/gin-gonic/gin/binding"
+	"github.com/gin-gonic/gin/render"
 	{{#if isDocument}}
 	"go.mongodb.org/mongo-driver/bson"
 	"go.mongodb.org/mongo-driver/mongo"
@@ -44,9 +47,16 @@ type {{capitalize name}}Controller struct {
 func (ctrl *{{capitalize name}}Controller) Create(c *gin.Context) {
 	ctx := c.Request.Context()
 	var entity models.{{capitalize name}}
-	if err := c.ShouldBindJSON(&entity); err != nil {
-		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
-		return
+	if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+		if err := c.ShouldBindWith(&entity, binding.MsgPack); err != nil {
+			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+			return
+		}
+	} else {
+		if err := c.ShouldBindJSON(&entity); err != nil {
+			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+			return
+		}
 	}
 
 	{{#if isDocument}}
@@ -138,7 +148,11 @@ func (ctrl *{{capitalize name}}Controller) Create(c *gin.Context) {
 	}
 	{{/if}}
 
-	c.JSON(http.StatusCreated, entity)
+	if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+		c.Render(http.StatusCreated, render.MsgPack{Data: entity})
+	} else {
+		c.JSON(http.StatusCreated, entity)
+	}
 }
 
 // GetAll handles parallel read aggregation for both SQL and Mongo
@@ -146,6 +160,7 @@ func (ctrl *{{capitalize name}}Controller) GetAll(c *gin.Context) {
 	ctx := c.Request.Context()
 	page, _ := strconv.Atoi(c.DefaultQuery("page", "0"))
 	size, _ := strconv.Atoi(c.DefaultQuery("size", "20"))
+	sortParam := c.DefaultQuery("sort", "")
 	
 	offset := 0
 	if page > 0 {
@@ -169,6 +184,15 @@ func (ctrl *{{capitalize name}}Controller) GetAll(c *gin.Context) {
 				defer wg.Done()
 				var entities []models.{{capitalize name}}
 				opts := options.Find().SetSkip(int64(offset)).SetLimit(int64(size))
+				if sortParam != "" {
+					parts := strings.Split(sortParam, ",")
+					field := parts[0]
+					order := 1
+					if len(parts) > 1 && strings.ToLower(parts[1]) == "desc" {
+						order = -1
+					}
+					opts.SetSort(bson.D{bson.E{Key: field, Value: order}})
+				}
 				cursor, err := db.Collection("{{toLowerCase name}}s").Find(ctx, bson.M{}, opts)
 				if err == nil {
 					cursor.All(ctx, &entities)
@@ -179,7 +203,11 @@ func (ctrl *{{capitalize name}}Controller) GetAll(c *gin.Context) {
 			}(role, siloDB)
 		}
 		wg.Wait()
-		c.JSON(http.StatusOK, federatedData)
+		if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+			c.Render(http.StatusOK, render.MsgPack{Data: federatedData})
+		} else {
+			c.JSON(http.StatusOK, federatedData)
+		}
 		return
 	}
 	{{/if}}
@@ -200,13 +228,26 @@ func (ctrl *{{capitalize name}}Controller) GetAll(c *gin.Context) {
 
 	var entities []models.{{capitalize name}}
 	opts := options.Find().SetSkip(int64(offset)).SetLimit(int64(size))
+	if sortParam != "" {
+		parts := strings.Split(sortParam, ",")
+		field := parts[0]
+		order := 1
+		if len(parts) > 1 && strings.ToLower(parts[1]) == "desc" {
+			order = -1
+		}
+		opts.SetSort(bson.D{bson.E{Key: field, Value: order}})
+	}
 	cursor, err := tenantDB.Collection("{{toLowerCase name}}s").Find(ctx, filter, opts)
 	if err != nil {
 		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
 		return
 	}
 	cursor.All(ctx, &entities)
-	c.JSON(http.StatusOK, entities)
+	if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+		c.Render(http.StatusOK, render.MsgPack{Data: entities})
+	} else {
+		c.JSON(http.StatusOK, entities)
+	}
 
 	{{else}}
 	// 🦆 GORM Path
@@ -227,7 +268,11 @@ func (ctrl *{{capitalize name}}Controller) GetAll(c *gin.Context) {
 			go func(r string, db *gorm.DB) {
 				defer wg.Done()
 				var entities []models.{{capitalize name}}
-				if err := db.WithContext(ctx).Offset(offset).Limit(size).Find(&entities).Error; err == nil {
+				query := db.WithContext(ctx)
+				if sortParam != "" {
+					query = query.Order(strings.ReplaceAll(sortParam, ",", " "))
+				}
+				if err := query.Offset(offset).Limit(size).Find(&entities).Error; err == nil {
 					mu.Lock()
 					federatedData[r] = entities
 					mu.Unlock()
@@ -235,7 +280,11 @@ func (ctrl *{{capitalize name}}Controller) GetAll(c *gin.Context) {
 			}(role, siloDB)
 		}
 		wg.Wait()
-		c.JSON(http.StatusOK, federatedData)
+		if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+			c.Render(http.StatusOK, render.MsgPack{Data: federatedData})
+		} else {
+			c.JSON(http.StatusOK, federatedData)
+		}
 		return
 	}
 	{{/if}}
@@ -248,11 +297,19 @@ func (ctrl *{{capitalize name}}Controller) GetAll(c *gin.Context) {
 	c.Header("X-Total-Count", strconv.FormatInt(totalCount, 10))
 
 	var entities []models.{{capitalize name}}
-	if err := tenantDB.WithContext(ctx).Offset(offset).Limit(size).Find(&entities).Error; err != nil {
+	query := tenantDB.WithContext(ctx)
+	if sortParam != "" {
+		query = query.Order(strings.ReplaceAll(sortParam, ",", " "))
+	}
+	if err := query.Offset(offset).Limit(size).Find(&entities).Error; err != nil {
 		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
 		return
 	}
-	c.JSON(http.StatusOK, entities)
+	if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+		c.Render(http.StatusOK, render.MsgPack{Data: entities})
+	} else {
+		c.JSON(http.StatusOK, entities)
+	}
 	{{/if}}
 }
 
@@ -269,7 +326,11 @@ func (ctrl *{{capitalize name}}Controller) GetByID(c *gin.Context) {
 		c.JSON(http.StatusNotFound, gin.H{"error": "Not found"})
 		return
 	}
-	c.JSON(http.StatusOK, entity)
+	if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+		c.Render(http.StatusOK, render.MsgPack{Data: entity})
+	} else {
+		c.JSON(http.StatusOK, entity)
+	}
 	{{else}}
 	db, _ := c.Get("tenantDBConn")
 	tenantDB := db.(*gorm.DB)
@@ -278,7 +339,11 @@ func (ctrl *{{capitalize name}}Controller) GetByID(c *gin.Context) {
 		c.JSON(http.StatusNotFound, gin.H{"error": "Not found"})
 		return
 	}
-	c.JSON(http.StatusOK, entity)
+	if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+		c.Render(http.StatusOK, render.MsgPack{Data: entity})
+	} else {
+		c.JSON(http.StatusOK, entity)
+	}
 	{{/if}}
 }
 
@@ -286,9 +351,16 @@ func (ctrl *{{capitalize name}}Controller) Update(c *gin.Context) {
 	ctx := c.Request.Context()
 	id := c.Param("id")
 	var entity models.{{capitalize name}}
-	if err := c.ShouldBindJSON(&entity); err != nil {
-		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
-		return
+	if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+		if err := c.ShouldBindWith(&entity, binding.MsgPack); err != nil {
+			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+			return
+		}
+	} else {
+		if err := c.ShouldBindJSON(&entity); err != nil {
+			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+			return
+		}
 	}
 
 	{{#if isDocument}}
@@ -320,7 +392,11 @@ func (ctrl *{{capitalize name}}Controller) Update(c *gin.Context) {
 	messaging.PublishEvent(ctrl.Config.GoDuck.Messaging.MQTT.TopicPrefix, "tenant", "UPDATE", "{{capitalize name}}", entity, nil)
 	{{/if}}
 
-	c.JSON(http.StatusOK, entity)
+	if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+		c.Render(http.StatusOK, render.MsgPack{Data: entity})
+	} else {
+		c.JSON(http.StatusOK, entity)
+	}
 }
 
 func (ctrl *{{capitalize name}}Controller) Delete(c *gin.Context) {
@@ -356,9 +432,16 @@ func (ctrl *{{capitalize name}}Controller) Patch(c *gin.Context) {
 	ctx := c.Request.Context()
     id := c.Param("id")
     var updates map[string]interface{}
-    if err := c.ShouldBindJSON(&updates); err != nil {
-        c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
-        return
+    if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+        if err := c.ShouldBindWith(&updates, binding.MsgPack); err != nil {
+            c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+            return
+        }
+    } else {
+        if err := c.ShouldBindJSON(&updates); err != nil {
+            c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+            return
+        }
     }
 
     {{#if isDocument}}
@@ -383,7 +466,11 @@ func (ctrl *{{capitalize name}}Controller) Patch(c *gin.Context) {
 	messaging.PublishEvent(ctrl.Config.GoDuck.Messaging.MQTT.TopicPrefix, "tenant", "PATCH", "{{capitalize name}}", updates, nil)
 	{{/if}}
 
-    c.JSON(http.StatusOK, gin.H{"message": "Patch successful"})
+    if ctrl.Config.GoDuck.Server.REST.Protocol == "messagepack" {
+        c.Render(http.StatusOK, render.MsgPack{Data: gin.H{"message": "Patch successful"}})
+    } else {
+        c.JSON(http.StatusOK, gin.H{"message": "Patch successful"})
+    }
 }
 
 func (ctrl *{{capitalize name}}Controller) BulkCreate(c *gin.Context) { c.JSON(http.StatusNotImplemented, gin.H{"error": "Bulk operations use primary silo isolation by default."}) }

package/templates/go/main.go.hbs

@@ -14,6 +14,8 @@ import (
     "{{app_name}}/integrations/wso2"
     "gorm.io/driver/postgres"
     "gorm.io/gorm"
+    "net/http"
+    "github.com/improbable-eng/grpc-web/go/grpcweb"
 )
 
 func main() {
@@ -40,6 +42,18 @@ func main() {
         go func() {
             grpcSrv := server.NewGRPCServer(appConfig, repo)
             logger.Info("Starting Kratos gRPC server on %s", appConfig.GoDuck.Server.GRPC.Addr)
+            
+            if appConfig.GoDuck.Server.GRPC.WebEnabled {
+                wrappedGrpc := grpcweb.WrapServer(grpcSrv.Server)
+                go func() {
+                    webPort := fmt.Sprintf(":%d", appConfig.GoDuck.Server.GRPC.WebPort)
+                    logger.Info("Starting gRPC-Web Proxy on %s", webPort)
+                    if err := http.ListenAndServe(webPort, wrappedGrpc); err != nil {
+                        logger.Error("Failed to start gRPC-Web Proxy: %v", err)
+                    }
+                }()
+            }
+            
             if err := grpcSrv.Start(context.Background()); err != nil {
                 logger.Error("Failed to start Kratos gRPC server: %v", err)
             }
@@ -56,7 +70,7 @@ func main() {
 	}
 
 	// 6. Start HTTP Server
-	port := fmt.Sprintf(":%d", appConfig.GoDuck.Server.Port)
-	logger.Info("Starting HTTP server on %s", port)
+	port := fmt.Sprintf(":%d", appConfig.GoDuck.Server.REST.Port)
+	logger.Info("Starting HTTP REST server on %s", port)
 	r.Run(port)
 }

package/templates/go/router.go.hbs

@@ -209,8 +209,13 @@ func SetupRouter(appConfig *config.Config) *gin.Engine {
     }
     {{/if}}
 
+    apiPrefix := appConfig.GoDuck.Server.REST.ApiPathPrefix
+    if apiPrefix == "" {
+        apiPrefix = "/api"
+    }
+
     // Open Application APIs (No Auth)
-    openApi := r.Group("/open/api")
+    openApi := r.Group("/open" + apiPrefix)
     if appConfig.GoDuck.Multitenancy.Enabled {
         openApi.Use(middleware.PublicTenantMiddleware(masterDB, appConfig))
     }
@@ -246,7 +251,7 @@ func SetupRouter(appConfig *config.Config) *gin.Engine {
     }
 
     // Secured Application APIs
-    api := r.Group("/api")
+    api := r.Group(apiPrefix)
     api.Use(middleware.JWTMiddleware())
     api.Use(middleware.TenantMiddleware(masterDB, appConfig))
     // Log request DB resolution for debugging
@@ -270,7 +275,7 @@ func SetupRouter(appConfig *config.Config) *gin.Engine {
         api.GET("/metering/history", meteringCtrl.GetHistory)
 
         // --- Infrastructure/Confidential Layer ---
-        admin := r.Group("/api/admin")
+        admin := r.Group(apiPrefix + "/admin")
         admin.Use(middleware.JWTMiddleware())
         admin.Use(middleware.SuperAdminRoleMiddleware(appConfig))
         {

package/templates/kratos/service.go.hbs

@@ -2,6 +2,7 @@ package service
 
 import (
 	"context"
+	"strings"
 	{{#if needFmt}}
 	"fmt"
 	{{/if}}
@@ -283,6 +284,15 @@ func (s *{{capitalize name}}Service) List{{capitalize name}}(ctx context.Context
 	for role, db := range siloConns {
 		var results []models.{{capitalize name}}
 		opts := options.Find().SetSkip(int64((req.Page - 1) * req.PageSize)).SetLimit(int64(req.PageSize))
+		if req.Sort != "" {
+			parts := strings.Split(req.Sort, ",")
+			field := parts[0]
+			order := 1
+			if len(parts) > 1 && strings.ToLower(parts[1]) == "desc" {
+				order = -1
+			}
+			opts.SetSort(bson.D{bson.E{Key: field, Value: order}})
+		}
 		cursor, err := db.Collection("{{toLowerCase name}}s").Find(ctx, bson.M{}, opts)
 		if err == nil {
 			cursor.All(ctx, &results)
@@ -300,6 +310,15 @@ func (s *{{capitalize name}}Service) List{{capitalize name}}(ctx context.Context
 	if ok {
 		var results []models.{{capitalize name}}
 		opts := options.Find().SetSkip(int64((req.Page - 1) * req.PageSize)).SetLimit(int64(req.PageSize))
+		if req.Sort != "" {
+			parts := strings.Split(req.Sort, ",")
+			field := parts[0]
+			order := 1
+			if len(parts) > 1 && strings.ToLower(parts[1]) == "desc" {
+				order = -1
+			}
+			opts.SetSort(bson.D{bson.E{Key: field, Value: order}})
+		}
 		cursor, err := db.Collection("{{toLowerCase name}}s").Find(ctx, bson.M{}, opts)
 		if err == nil {
 			cursor.All(ctx, &results)
@@ -319,7 +338,9 @@ func (s *{{capitalize name}}Service) List{{capitalize name}}(ctx context.Context
 	for role, db := range siloConns {
 		var results []models.{{capitalize name}}
 		query := db.WithContext(ctx).Model(&models.{{capitalize name}}{})
-		
+		if req.Sort != "" {
+			query = query.Order(strings.ReplaceAll(req.Sort, ",", " "))
+		}
 		var count int64
 		query.Count(&count)
 		total += count
@@ -338,7 +359,9 @@ func (s *{{capitalize name}}Service) List{{capitalize name}}(ctx context.Context
 	if ok {
 		var results []models.{{capitalize name}}
 		query := db.WithContext(ctx).Model(&models.{{capitalize name}}{})
-		
+		if req.Sort != "" {
+			query = query.Order(strings.ReplaceAll(req.Sort, ",", " "))
+		}
 		var count int64
 		query.Count(&count)
 		total = count

package/templates/proto/entity.proto.hbs

@@ -83,6 +83,7 @@ message List{{capitalize name}}Request {
   int32 page = 1;
   int32 page_size = 2;
   string query = 3;
+  string sort = 4;
 }
 
 message List{{capitalize name}}Reply {