Fixing issue from creating / generator complete golang restfulapi

Author: zeroc0d3

Dockerfile

@@ -70,7 +70,7 @@ RUN /telemetryflow-gen version && /telemetryflow-restapi version
 # -----------------------------------------------------------------------------
 # Stage 2: Runtime
 # -----------------------------------------------------------------------------
-FROM alpine:3.21
+FROM alpine:3.23
 
 # =============================================================================
 # TelemetryFlow Metadata Labels (OCI Image Spec)

docs/GENERATOR_RESTAPI.md

@@ -510,6 +510,7 @@ Templates support the following helper functions:
 | `replace` | Replace string | `{{replace .Name "-" "_"}}` |
 | `trimSuffix` | Trim suffix | `{{trimSuffix .Name "_id"}}` |
 | `trimPrefix` | Trim prefix | `{{trimPrefix .Name "tbl_"}}` |
+| `add` | Add numbers | `{{add 1 2}}` → `3` |
 
 ## Custom Templates
 
@@ -533,6 +534,7 @@ type TemplateData struct {
     ServiceName    string
     ServiceVersion string
     Environment    string
+    EnvPrefix      string  // Environment variable prefix (e.g., ORDER_SERVICE)
 
     // Database
     DBDriver string

pkg/telemetryflow/client.go

@@ -197,24 +197,14 @@ func (c *Client) LogError(ctx context.Context, message string, attributes map[st
 
 // ===== TRACES API =====
 
-// StartSpan starts a new trace span
+// StartSpan starts a new trace span and returns the span ID
 func (c *Client) StartSpan(ctx context.Context, name string, kind string, attributes map[string]interface{}) (string, error) {
 	if !c.isInitialized() {
 		return "", fmt.Errorf("client not initialized")
 	}
 
-	cmd := &application.StartSpanCommand{
-		Name:       name,
-		Kind:       kind,
-		Attributes: attributes,
-	}
-
-	if err := c.commandHandler.Handle(ctx, cmd); err != nil {
-		return "", err
-	}
-
-	// In production, return the actual span ID
-	return "span-id-placeholder", nil
+	// Use the direct method that returns the span ID
+	return c.commandHandler.StartSpanDirect(ctx, name, kind, attributes)
 }
 
 // EndSpan ends an active span

pkg/telemetryflow/infrastructure/handlers.go

@@ -297,15 +297,17 @@ func (h *TelemetryCommandHandler) handleEmitLog(ctx context.Context, cmd *applic
 
 // ===== TRACE HANDLERS =====
 
-func (h *TelemetryCommandHandler) handleStartSpan(ctx context.Context, cmd *application.StartSpanCommand) error {
+// StartSpanDirect starts a new span and returns its ID directly
+// This is the preferred method for starting spans as it returns the span ID
+func (h *TelemetryCommandHandler) StartSpanDirect(ctx context.Context, name string, kind string, attributes map[string]interface{}) (string, error) {
 	if !h.initialized || h.tracer == nil {
-		return fmt.Errorf("traces not initialized")
+		return "", fmt.Errorf("traces not initialized")
 	}
 
-	attrs := convertAttributes(cmd.Attributes)
+	attrs := convertAttributes(attributes)
 
 	var spanKind trace.SpanKind
-	switch cmd.Kind {
+	switch kind {
 	case "internal":
 		spanKind = trace.SpanKindInternal
 	case "server":
@@ -320,7 +322,7 @@ func (h *TelemetryCommandHandler) handleStartSpan(ctx context.Context, cmd *appl
 		spanKind = trace.SpanKindInternal
 	}
 
-	_, span := h.tracer.Start(ctx, cmd.Name,
+	_, span := h.tracer.Start(ctx, name,
 		trace.WithSpanKind(spanKind),
 		trace.WithAttributes(attrs...),
 	)
@@ -331,7 +333,12 @@ func (h *TelemetryCommandHandler) handleStartSpan(ctx context.Context, cmd *appl
 	h.activeSpans[spanID] = span
 	h.spansMutex.Unlock()
 
-	return nil
+	return spanID, nil
+}
+
+func (h *TelemetryCommandHandler) handleStartSpan(ctx context.Context, cmd *application.StartSpanCommand) error {
+	_, err := h.StartSpanDirect(ctx, cmd.Name, cmd.Kind, cmd.Attributes)
+	return err
 }
 
 func (h *TelemetryCommandHandler) handleEndSpan(ctx context.Context, cmd *application.EndSpanCommand) error {