@atlashub/smartstack-cli 1.37.0 → 2.0.0

package/templates/mcp-scaffolding/entity-extension.cs.hbs

@@ -0,0 +1,231 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+using SmartStack.Domain.Common;
+using SmartStack.Domain.Common.Interfaces;
+
+namespace {{namespace}};
+
+/// <summary>
+/// {{name}} entity{{#if baseEntity}} extending {{baseEntity}}{{/if}}
+/// </summary>
+{{#if isSystemEntity}}
+public class {{name}} : SystemEntity
+{{else}}
+public class {{name}} : BaseEntity
+{{/if}}
+{
+{{#if baseEntity}}
+    /// <summary>
+    /// Foreign key to {{baseEntity}}
+    /// </summary>
+    public Guid {{baseEntity}}Id { get; private set; }
+
+    /// <summary>
+    /// Navigation property to {{baseEntity}}
+    /// </summary>
+    public virtual {{baseEntity}}? {{baseEntity}} { get; private set; }
+
+{{/if}}
+    // === BUSINESS PROPERTIES ===
+    // TODO: Add {{name}} specific properties here
+
+    /// <summary>
+    /// Private constructor for EF Core
+    /// </summary>
+    private {{name}}() { }
+
+    /// <summary>
+    /// Factory method to create a new {{name}}
+    /// </summary>
+{{#if isSystemEntity}}
+    public static {{name}} Create(
+        string code,
+        string? createdBy = null)
+    {
+        return new {{name}}
+        {
+            Id = Guid.NewGuid(),
+            Code = code.ToLowerInvariant(),
+            CreatedAt = DateTime.UtcNow,
+            CreatedBy = createdBy
+        };
+    }
+{{else}}
+    public static {{name}} Create(
+        Guid tenantId,
+        string code,
+        string? createdBy = null)
+    {
+        return new {{name}}
+        {
+            Id = Guid.NewGuid(),
+            TenantId = tenantId,
+            Code = code.ToLowerInvariant(),
+            CreatedAt = DateTime.UtcNow,
+            CreatedBy = createdBy
+        };
+    }
+{{/if}}
+
+    /// <summary>
+    /// Update the entity
+    /// </summary>
+    public void Update(string? updatedBy = null)
+    {
+        UpdatedAt = DateTime.UtcNow;
+        UpdatedBy = updatedBy;
+    }
+
+    /// <summary>
+    /// Soft delete the entity
+    /// </summary>
+    public void SoftDelete(string? deletedBy = null)
+    {
+        IsDeleted = true;
+        DeletedAt = DateTime.UtcNow;
+        DeletedBy = deletedBy;
+    }
+
+    /// <summary>
+    /// Restore a soft-deleted entity
+    /// </summary>
+    public void Restore(string? restoredBy = null)
+    {
+        IsDeleted = false;
+        DeletedAt = null;
+        DeletedBy = null;
+        UpdatedAt = DateTime.UtcNow;
+        UpdatedBy = restoredBy;
+    }
+}
+
+// ============================================================================
+// Base Entity Classes (SmartStack.Domain.Common)
+// ============================================================================
+/*
+/// <summary>
+/// Base entity for tenant-scoped entities (default)
+/// </summary>
+public abstract class BaseEntity : ITenantEntity, IHasCode, ISoftDeletable, IVersioned
+{
+    public Guid Id { get; set; } = Guid.NewGuid();
+    public Guid TenantId { get; set; }
+
+    private string _code = string.Empty;
+    public string Code
+    {
+        get => _code;
+        set => _code = value?.ToLowerInvariant() ?? string.Empty;
+    }
+
+    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
+    public DateTime? UpdatedAt { get; set; }
+    public string? CreatedBy { get; set; }
+    public string? UpdatedBy { get; set; }
+
+    public bool IsDeleted { get; set; }
+    public DateTime? DeletedAt { get; set; }
+    public string? DeletedBy { get; set; }
+
+    public byte[] RowVersion { get; set; } = Array.Empty<byte>();
+}
+
+/// <summary>
+/// Base entity for system-wide entities (no tenant isolation)
+/// </summary>
+public abstract class SystemEntity : ISystemEntity, IHasCode, ISoftDeletable, IVersioned
+{
+    public Guid Id { get; set; } = Guid.NewGuid();
+
+    private string _code = string.Empty;
+    public string Code
+    {
+        get => _code;
+        set => _code = value?.ToLowerInvariant() ?? string.Empty;
+    }
+
+    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
+    public DateTime? UpdatedAt { get; set; }
+    public string? CreatedBy { get; set; }
+    public string? UpdatedBy { get; set; }
+
+    public bool IsDeleted { get; set; }
+    public DateTime? DeletedAt { get; set; }
+    public string? DeletedBy { get; set; }
+
+    public byte[] RowVersion { get; set; } = Array.Empty<byte>();
+}
+*/
+
+// ============================================================================
+// EF Core Configuration
+// ============================================================================
+namespace {{infrastructureNamespace}}.Persistence.Configurations;
+
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using {{domainNamespace}};
+
+public class {{name}}Configuration : IEntityTypeConfiguration<{{name}}>
+{
+    public void Configure(EntityTypeBuilder<{{name}}> builder)
+    {
+        // Table name with schema and domain prefix
+        builder.ToTable("{{tablePrefix}}{{name}}s", "{{schema}}");
+
+        // Primary key
+        builder.HasKey(e => e.Id);
+
+{{#unless isSystemEntity}}
+        // Multi-tenant
+        builder.Property(e => e.TenantId).IsRequired();
+        builder.HasIndex(e => e.TenantId);
+
+        // Code: lowercase, unique per tenant (filtered for soft delete)
+        builder.Property(e => e.Code).HasMaxLength(100).IsRequired();
+        builder.HasIndex(e => new { e.TenantId, e.Code })
+            .IsUnique()
+            .HasFilter("[IsDeleted] = 0")
+            .HasDatabaseName("IX_{{tablePrefix}}{{name}}s_Tenant_Code_Unique");
+{{else}}
+        // Code: lowercase, unique (filtered for soft delete)
+        builder.Property(e => e.Code).HasMaxLength(100).IsRequired();
+        builder.HasIndex(e => e.Code)
+            .IsUnique()
+            .HasFilter("[IsDeleted] = 0")
+            .HasDatabaseName("IX_{{tablePrefix}}{{name}}s_Code_Unique");
+{{/unless}}
+
+        // Concurrency token
+        builder.Property(e => e.RowVersion).IsRowVersion();
+
+        // Audit fields
+        builder.Property(e => e.CreatedBy).HasMaxLength(256);
+        builder.Property(e => e.UpdatedBy).HasMaxLength(256);
+        builder.Property(e => e.DeletedBy).HasMaxLength(256);
+
+{{#if baseEntity}}
+        // Relationship to {{baseEntity}} (1:1)
+        builder.HasOne(e => e.{{baseEntity}})
+               .WithOne()
+               .HasForeignKey<{{name}}>(e => e.{{baseEntity}}Id)
+               .OnDelete(DeleteBehavior.Cascade);
+
+        // Index on foreign key
+        builder.HasIndex(e => e.{{baseEntity}}Id)
+               .IsUnique();
+{{/if}}
+
+        // TODO: Add additional configuration
+    }
+}
+
+// ============================================================================
+// DbContext Update (add to ApplicationDbContext.cs)
+// ============================================================================
+// public DbSet<{{name}}> {{name}}s => Set<{{name}}>();
+
+// ============================================================================
+// Migration Command
+// ============================================================================
+// dotnet ef migrations add core_vX.X.X_XXX_Add{{name}} --context ApplicationDbContext

package/templates/mcp-scaffolding/frontend/api-client.ts.hbs

@@ -0,0 +1,116 @@
+{{!-- SmartStack API Client Template --}}
+{{!-- Generates type-safe API client with NavRoute integration --}}
+
+/**
+ * {{name}} API Client
+ *
+ * Auto-generated by SmartStack MCP - DO NOT EDIT MANUALLY
+ * NavRoute: {{navRoute}}
+ * API Path: {{apiPath}}
+ */
+
+import { getRoute } from '../routes/navRoutes.generated';
+import { apiClient } from '../lib/apiClient';
+import type {
+  {{name}},
+  {{name}}CreateRequest,
+  {{name}}UpdateRequest,
+  {{name}}ListResponse,
+  PaginatedRequest,
+  PaginatedResponse
+} from '../types/{{nameLower}}';
+
+const ROUTE = getRoute('{{navRoute}}');
+
+export const {{nameLower}}Api = {
+{{#if includeGetAll}}
+  /**
+   * Get all {{name}}s with pagination
+   */
+  async getAll(params?: PaginatedRequest): Promise<PaginatedResponse<{{name}}>> {
+    const response = await apiClient.get<{{name}}ListResponse>(ROUTE.api, { params });
+    return response.data;
+  },
+
+{{/if}}
+{{#if includeGetById}}
+  /**
+   * Get {{name}} by ID
+   */
+  async getById(id: string): Promise<{{name}}> {
+    const response = await apiClient.get<{{name}}>(`${ROUTE.api}/${id}`);
+    return response.data;
+  },
+
+{{/if}}
+{{#if includeCreate}}
+  /**
+   * Create new {{name}}
+   */
+  async create(data: {{name}}CreateRequest): Promise<{{name}}> {
+    const response = await apiClient.post<{{name}}>(ROUTE.api, data);
+    return response.data;
+  },
+
+{{/if}}
+{{#if includeUpdate}}
+  /**
+   * Update existing {{name}}
+   */
+  async update(id: string, data: {{name}}UpdateRequest): Promise<{{name}}> {
+    const response = await apiClient.put<{{name}}>(`${ROUTE.api}/${id}`, data);
+    return response.data;
+  },
+
+{{/if}}
+{{#if includeDelete}}
+  /**
+   * Delete {{name}}
+   */
+  async delete(id: string): Promise<void> {
+    await apiClient.delete(`${ROUTE.api}/${id}`);
+  },
+
+{{/if}}
+{{#if includeSearch}}
+  /**
+   * Search {{name}}s
+   */
+  async search(query: string, params?: PaginatedRequest): Promise<PaginatedResponse<{{name}}>> {
+    const response = await apiClient.get<{{name}}ListResponse>(`${ROUTE.api}/search`, {
+      params: { q: query, ...params }
+    });
+    return response.data;
+  },
+
+{{/if}}
+{{#if includeExport}}
+  /**
+   * Export {{name}}s to file
+   */
+  async export(format: 'csv' | 'xlsx' | 'pdf' = 'xlsx'): Promise<Blob> {
+    const response = await apiClient.get(`${ROUTE.api}/export`, {
+      params: { format },
+      responseType: 'blob'
+    });
+    return response.data;
+  },
+
+{{/if}}
+  /**
+   * Get the NavRoute configuration for this API
+   */
+  getRoute() {
+    return ROUTE;
+  },
+
+  /**
+   * Check if user has permission to access this API
+   */
+  hasPermission(userPermissions: string[]): boolean {
+    if (ROUTE.permissions.length === 0) return true;
+    return ROUTE.permissions.some(p => userPermissions.includes(p));
+  },
+};
+
+export default {{nameLower}}Api;

package/templates/mcp-scaffolding/frontend/nav-routes.ts.hbs

@@ -0,0 +1,133 @@
+{{!-- SmartStack NavRoute Registry Template --}}
+{{!-- Generates centralized route registry for frontend --}}
+
+/**
+ * NavRoute Registry
+ *
+ * Auto-generated by SmartStack MCP - DO NOT EDIT MANUALLY
+ * Generated: {{generatedAt}}
+ * Source: {{source}}
+ * Routes: {{routeCount}}
+ */
+
+export interface NavRoute {
+  /** NavRoute path (e.g., "platform.administration.users") */
+  navRoute: string;
+  /** API endpoint path (e.g., "/api/platform/administration/users") */
+  api: string;
+  /** Frontend route path (e.g., "/platform/administration/users") */
+  web: string;
+  /** Required permissions to access this route */
+  permissions: string[];
+  /** Backend controller name */
+  controller?: string;
+  /** Supported HTTP methods */
+  methods: string[];
+}
+
+/**
+ * All registered NavRoutes
+ */
+export const ROUTES: Record<string, NavRoute> = {
+{{#each routes}}
+  '{{this.navRoute}}': {
+    navRoute: '{{this.navRoute}}',
+    api: '{{this.apiPath}}',
+    web: '{{this.webPath}}',
+    permissions: [{{#each this.permissions}}'{{this}}'{{#unless @last}}, {{/unless}}{{/each}}],
+{{#if this.controller}}
+    controller: '{{this.controller}}',
+{{/if}}
+    methods: [{{#each this.methods}}'{{this}}'{{#unless @last}}, {{/unless}}{{/each}}],
+  },
+{{/each}}
+};
+
+/**
+ * Get route configuration by NavRoute path
+ * @throws Error if route not found
+ */
+export function getRoute(navRoute: string): NavRoute {
+  const route = ROUTES[navRoute];
+  if (!route) {
+    throw new Error(`Route not found: ${navRoute}. Run scaffold_routes to regenerate.`);
+  }
+  return route;
+}
+
+/**
+ * Safely get route configuration, returns undefined if not found
+ */
+export function tryGetRoute(navRoute: string): NavRoute | undefined {
+  return ROUTES[navRoute];
+}
+
+/**
+ * Check if user has permission for route
+ */
+export function hasRoutePermission(navRoute: string, userPermissions: string[]): boolean {
+  const route = ROUTES[navRoute];
+  if (!route || route.permissions.length === 0) return true;
+  return route.permissions.some(p => userPermissions.includes(p));
+}
+
+/**
+ * Get all routes for a context (e.g., "platform")
+ */
+export function getRoutesByContext(context: string): NavRoute[] {
+  return Object.values(ROUTES).filter(r => r.navRoute.startsWith(`${context}.`));
+}
+
+/**
+ * Get all routes for a context and application (e.g., "platform.administration")
+ */
+export function getRoutesByApplication(context: string, application: string): NavRoute[] {
+  const prefix = `${context}.${application}`;
+  return Object.values(ROUTES).filter(r => r.navRoute.startsWith(`${prefix}.`) || r.navRoute === prefix);
+}
+
+/**
+ * Get all unique contexts
+ */
+export function getContexts(): string[] {
+  const contexts = new Set<string>();
+  for (const route of Object.values(ROUTES)) {
+    contexts.add(route.navRoute.split('.')[0]);
+  }
+  return Array.from(contexts);
+}
+
+/**
+ * Get all unique applications within a context
+ */
+export function getApplications(context: string): string[] {
+  const apps = new Set<string>();
+  for (const route of Object.values(ROUTES)) {
+    const parts = route.navRoute.split('.');
+    if (parts[0] === context && parts.length >= 2) {
+      apps.add(parts[1]);
+    }
+  }
+  return Array.from(apps);
+}
+
+/**
+ * Build API URL from NavRoute with optional path segments
+ */
+export function buildApiUrl(navRoute: string, ...segments: string[]): string {
+  const route = getRoute(navRoute);
+  if (segments.length === 0) return route.api;
+  return `${route.api}/${segments.join('/')}`;
+}
+
+/**
+ * Build frontend URL from NavRoute with optional path segments
+ */
+export function buildWebUrl(navRoute: string, ...segments: string[]): string {
+  const route = getRoute(navRoute);
+  if (segments.length === 0) return route.web;
+  return `${route.web}/${segments.join('/')}`;
+}
+
+// Route count for debugging
+export const ROUTE_COUNT = {{routeCount}};

package/templates/mcp-scaffolding/frontend/routes.tsx.hbs

@@ -0,0 +1,134 @@
+{{!-- SmartStack React Router Configuration Template --}}
+{{!-- Generates router configuration from NavRoute registry --}}
+
+/**
+ * React Router Configuration
+ *
+ * Auto-generated by SmartStack MCP - DO NOT EDIT MANUALLY
+ * Generated: {{generatedAt}}
+ */
+
+import React, { Suspense, lazy } from 'react';
+import { createBrowserRouter, RouteObject, Navigate } from 'react-router-dom';
+import { ROUTES } from './navRoutes.generated';
+{{#if includeGuards}}
+import { ProtectedRoute, PermissionGuard } from './guards';
+{{/if}}
+
+// ============================================================================
+// Layouts
+// ============================================================================
+
+{{#each contexts}}
+import { {{capitalize this}}Layout } from '../layouts/{{capitalize this}}Layout';
+{{/each}}
+
+// ============================================================================
+// Pages (lazy loaded for code splitting)
+// ============================================================================
+
+{{#each routes}}
+const {{pageName this.navRoute}}Page = lazy(() => import('../pages/{{pagePath this.navRoute}}'));
+{{/each}}
+
+// ============================================================================
+// Loading Component
+// ============================================================================
+
+const PageLoader: React.FC = () => (
+  <div className="flex items-center justify-center h-64">
+    <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-blue-500" />
+  </div>
+);
+
+// ============================================================================
+// Route Configuration
+// ============================================================================
+
+const routes: RouteObject[] = [
+  // Root redirect
+  {
+    path: '/',
+    element: <Navigate to="{{defaultPath}}" replace />,
+  },
+
+{{#each contextTree}}
+  // {{uppercase @key}} Context
+  {
+    path: '{{@key}}',
+    element: <{{capitalize @key}}Layout />,
+    children: [
+{{#each this}}
+      // {{uppercase @key}} Application
+      {
+        path: '{{@key}}',
+        children: [
+{{#each this}}
+          {
+            path: '{{modulePath this.navRoute}}',
+{{#if this.permissions.length}}
+            element: (
+              <PermissionGuard permissions={ROUTES['{{this.navRoute}}'].permissions}>
+                <Suspense fallback={<PageLoader />}>
+                  <{{pageName this.navRoute}}Page />
+                </Suspense>
+              </PermissionGuard>
+            ),
+{{else}}
+            element: (
+              <Suspense fallback={<PageLoader />}>
+                <{{pageName this.navRoute}}Page />
+              </Suspense>
+            ),
+{{/if}}
+          },
+{{/each}}
+        ],
+      },
+{{/each}}
+    ],
+  },
+{{/each}}
+
+  // 404 Not Found
+  {
+    path: '*',
+    element: (
+      <div className="flex flex-col items-center justify-center h-screen">
+        <h1 className="text-4xl font-bold text-gray-900">404</h1>
+        <p className="mt-2 text-gray-600">Page not found</p>
+        <a href="{{defaultPath}}" className="mt-4 text-blue-600 hover:underline">
+          Return to home
+        </a>
+      </div>
+    ),
+  },
+];
+
+// ============================================================================
+// Router Export
+// ============================================================================
+
+{{#if includeGuards}}
+export const router = createBrowserRouter([
+  {
+    element: <ProtectedRoute />,
+    children: routes,
+  },
+]);
+{{else}}
+export const router = createBrowserRouter(routes);
+{{/if}}
+
+export default router;
+
+// ============================================================================
+// Type Exports
+// ============================================================================
+
+export type { RouteObject };
+
+/**
+ * Get route configuration by NavRoute path
+ */
+export const getRouteConfig = (navRoute: string) => ROUTES[navRoute];