@atlashub/smartstack-cli 1.1.0

package/templates/commands/application/templates-backend.md

@@ -0,0 +1,463 @@
+# Templates Backend - Application Skill
+
+> Ces templates génèrent le code C# pour les nouvelles applications/modules.
+> **RAPPEL:** Seules les applications dans le context `business` sont autorisées.
+
+---
+
+## TEMPLATE: PERMISSIONS CLASS
+
+```csharp
+// Ajouter dans src/SmartStack.Application/Common/Authorization/Permissions.cs
+
+// IMPORTANT: Les permissions client sont TOUJOURS sous "business.*"
+public static class Business
+{
+    public const string Access = "business";
+
+    public static class $APP_PASCAL
+    {
+        public const string Access = "business.$app";
+
+        public static class $MODULE_PASCAL
+        {
+            public const string View = "business.$app.$module.read";
+            public const string Create = "business.$app.$module.create";
+            public const string Update = "business.$app.$module.update";
+            public const string Delete = "business.$app.$module.delete";
+            public const string Assign = "business.$app.$module.assign";
+            public const string Execute = "business.$app.$module.execute";
+        }
+    }
+}
+```
+
+### Exemple pour Business > CRM > Leads
+
+```csharp
+public static class Business
+{
+    public const string Access = "business";
+
+    public static class Crm
+    {
+        public const string Access = "business.crm";
+
+        public static class Leads
+        {
+            public const string View = "business.crm.leads.read";
+            public const string Create = "business.crm.leads.create";
+            public const string Update = "business.crm.leads.update";
+            public const string Delete = "business.crm.leads.delete";
+        }
+    }
+}
+```
+
+---
+
+## TEMPLATE: SERVICE INTERFACE
+
+```csharp
+// src/SmartStack.Application/Common/Interfaces/I{Module}Service.cs
+
+using SmartStack.Application.$MODULE_PASCAL.Models;
+
+namespace SmartStack.Application.Common.Interfaces;
+
+public interface I$MODULE_PASCALService
+{
+    Task<PagedResult<$ENTITY_PASCALDto>> GetAllAsync(
+        $ENTITY_PASCALQueryParameters parameters,
+        CancellationToken cancellationToken = default);
+
+    Task<$ENTITY_PASCALDto?> GetByIdAsync(
+        Guid id,
+        CancellationToken cancellationToken = default);
+
+    Task<$ENTITY_PASCALDto> CreateAsync(
+        Create$ENTITY_PASCALRequest request,
+        CancellationToken cancellationToken = default);
+
+    Task<$ENTITY_PASCALDto> UpdateAsync(
+        Guid id,
+        Update$ENTITY_PASCALRequest request,
+        CancellationToken cancellationToken = default);
+
+    Task<bool> DeleteAsync(
+        Guid id,
+        CancellationToken cancellationToken = default);
+}
+```
+
+---
+
+## TEMPLATE: SERVICE IMPLEMENTATION
+
+```csharp
+// src/SmartStack.Infrastructure/Services/$MODULE_PASCAL/$MODULE_PASCALService.cs
+
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+using SmartStack.Application.Common.Interfaces;
+using SmartStack.Application.$MODULE_PASCAL.Models;
+using SmartStack.Domain.$MODULE_PASCAL;
+
+namespace SmartStack.Infrastructure.Services.$MODULE_PASCAL;
+
+public class $MODULE_PASCALService : I$MODULE_PASCALService
+{
+    private readonly IApplicationDbContext _context;
+    private readonly ICurrentUserService _currentUser;
+    private readonly ILogger<$MODULE_PASCALService> _logger;
+
+    public $MODULE_PASCALService(
+        IApplicationDbContext context,
+        ICurrentUserService currentUser,
+        ILogger<$MODULE_PASCALService> logger)
+    {
+        _context = context;
+        _currentUser = currentUser;
+        _logger = logger;
+    }
+
+    public async Task<PagedResult<$ENTITY_PASCALDto>> GetAllAsync(
+        $ENTITY_PASCALQueryParameters parameters,
+        CancellationToken cancellationToken = default)
+    {
+        var query = _context.$ENTITY_PLURAL
+            .AsNoTracking();
+
+        // Apply filters
+        if (!string.IsNullOrWhiteSpace(parameters.SearchTerm))
+        {
+            query = query.Where(x =>
+                x.Name.Contains(parameters.SearchTerm) ||
+                x.Description.Contains(parameters.SearchTerm));
+        }
+
+        // Apply sorting
+        query = parameters.SortColumn?.ToLower() switch
+        {
+            "name" => parameters.SortDirection == "desc"
+                ? query.OrderByDescending(x => x.Name)
+                : query.OrderBy(x => x.Name),
+            "createdat" => parameters.SortDirection == "desc"
+                ? query.OrderByDescending(x => x.CreatedAt)
+                : query.OrderBy(x => x.CreatedAt),
+            _ => query.OrderByDescending(x => x.CreatedAt)
+        };
+
+        var totalCount = await query.CountAsync(cancellationToken);
+
+        var items = await query
+            .Skip((parameters.Page - 1) * parameters.PageSize)
+            .Take(parameters.PageSize)
+            .Select(x => new $ENTITY_PASCALDto
+            {
+                Id = x.Id,
+                Name = x.Name,
+                Description = x.Description,
+                IsActive = x.IsActive,
+                CreatedAt = x.CreatedAt,
+                UpdatedAt = x.UpdatedAt
+            })
+            .ToListAsync(cancellationToken);
+
+        return new PagedResult<$ENTITY_PASCALDto>
+        {
+            Items = items,
+            TotalCount = totalCount,
+            Page = parameters.Page,
+            PageSize = parameters.PageSize
+        };
+    }
+
+    public async Task<$ENTITY_PASCALDto?> GetByIdAsync(
+        Guid id,
+        CancellationToken cancellationToken = default)
+    {
+        var entity = await _context.$ENTITY_PLURAL
+            .AsNoTracking()
+            .FirstOrDefaultAsync(x => x.Id == id, cancellationToken);
+
+        if (entity == null)
+            return null;
+
+        return new $ENTITY_PASCALDto
+        {
+            Id = entity.Id,
+            Name = entity.Name,
+            Description = entity.Description,
+            IsActive = entity.IsActive,
+            CreatedAt = entity.CreatedAt,
+            UpdatedAt = entity.UpdatedAt
+        };
+    }
+
+    public async Task<$ENTITY_PASCALDto> CreateAsync(
+        Create$ENTITY_PASCALRequest request,
+        CancellationToken cancellationToken = default)
+    {
+        var entity = $ENTITY_PASCAL.Create(
+            request.Name,
+            request.Description);
+
+        _context.$ENTITY_PLURAL.Add(entity);
+        await _context.SaveChangesAsync(cancellationToken);
+
+        _logger.LogInformation(
+            "User {User} created $ENTITY_PASCAL {Id} ({Name})",
+            _currentUser.Email,
+            entity.Id,
+            entity.Name);
+
+        return new $ENTITY_PASCALDto
+        {
+            Id = entity.Id,
+            Name = entity.Name,
+            Description = entity.Description,
+            IsActive = entity.IsActive,
+            CreatedAt = entity.CreatedAt
+        };
+    }
+
+    public async Task<$ENTITY_PASCALDto> UpdateAsync(
+        Guid id,
+        Update$ENTITY_PASCALRequest request,
+        CancellationToken cancellationToken = default)
+    {
+        var entity = await _context.$ENTITY_PLURAL
+            .FirstOrDefaultAsync(x => x.Id == id, cancellationToken)
+            ?? throw new NotFoundException("$ENTITY_PASCAL", id);
+
+        entity.Update(request.Name, request.Description);
+
+        await _context.SaveChangesAsync(cancellationToken);
+
+        _logger.LogInformation(
+            "User {User} updated $ENTITY_PASCAL {Id} ({Name})",
+            _currentUser.Email,
+            entity.Id,
+            entity.Name);
+
+        return new $ENTITY_PASCALDto
+        {
+            Id = entity.Id,
+            Name = entity.Name,
+            Description = entity.Description,
+            IsActive = entity.IsActive,
+            CreatedAt = entity.CreatedAt,
+            UpdatedAt = entity.UpdatedAt
+        };
+    }
+
+    public async Task<bool> DeleteAsync(
+        Guid id,
+        CancellationToken cancellationToken = default)
+    {
+        var entity = await _context.$ENTITY_PLURAL
+            .FirstOrDefaultAsync(x => x.Id == id, cancellationToken);
+
+        if (entity == null)
+            return false;
+
+        _context.$ENTITY_PLURAL.Remove(entity);
+        await _context.SaveChangesAsync(cancellationToken);
+
+        _logger.LogWarning(
+            "User {User} deleted $ENTITY_PASCAL {Id} ({Name})",
+            _currentUser.Email,
+            id,
+            entity.Name);
+
+        return true;
+    }
+}
+```
+
+---
+
+## TEMPLATE: DTOs
+
+```csharp
+// src/SmartStack.Application/$MODULE_PASCAL/Models/$ENTITY_PASCALDto.cs
+
+namespace SmartStack.Application.$MODULE_PASCAL.Models;
+
+public record $ENTITY_PASCALDto
+{
+    public Guid Id { get; init; }
+    public string Name { get; init; } = null!;
+    public string? Description { get; init; }
+    public bool IsActive { get; init; }
+    public DateTime CreatedAt { get; init; }
+    public DateTime? UpdatedAt { get; init; }
+}
+
+public record Create$ENTITY_PASCALRequest
+{
+    public string Name { get; init; } = null!;
+    public string? Description { get; init; }
+}
+
+public record Update$ENTITY_PASCALRequest
+{
+    public string Name { get; init; } = null!;
+    public string? Description { get; init; }
+}
+
+public record $ENTITY_PASCALQueryParameters
+{
+    public int Page { get; init; } = 1;
+    public int PageSize { get; init; } = 10;
+    public string? SearchTerm { get; init; }
+    public string? SortColumn { get; init; } = "createdAt";
+    public string? SortDirection { get; init; } = "desc";
+}
+```
+
+---
+
+## TEMPLATE: DOMAIN ENTITY
+
+```csharp
+// src/SmartStack.Domain/$MODULE_PASCAL/$ENTITY_PASCAL.cs
+
+using SmartStack.Domain.Common;
+
+namespace SmartStack.Domain.$MODULE_PASCAL;
+
+public class $ENTITY_PASCAL : BaseEntity
+{
+    public string Name { get; private set; } = null!;
+    public string? Description { get; private set; }
+    public bool IsActive { get; private set; }
+
+    private $ENTITY_PASCAL() { }
+
+    public static $ENTITY_PASCAL Create(string name, string? description = null)
+    {
+        if (string.IsNullOrWhiteSpace(name))
+            throw new Exceptions.DomainException("Name is required");
+
+        return new $ENTITY_PASCAL
+        {
+            Id = Guid.NewGuid(),
+            Name = name,
+            Description = description,
+            IsActive = true,
+            CreatedAt = DateTime.UtcNow
+        };
+    }
+
+    public void Update(string name, string? description)
+    {
+        if (string.IsNullOrWhiteSpace(name))
+            throw new Exceptions.DomainException("Name is required");
+
+        Name = name;
+        Description = description;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Activate() => IsActive = true;
+    public void Deactivate() => IsActive = false;
+}
+```
+
+---
+
+## TEMPLATE: EF CONFIGURATION
+
+```csharp
+// src/SmartStack.Infrastructure/Persistence/Configurations/$MODULE_PASCAL/$ENTITY_PASCALConfiguration.cs
+
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using SmartStack.Domain.$MODULE_PASCAL;
+
+namespace SmartStack.Infrastructure.Persistence.Configurations.$MODULE_PASCAL;
+
+public class $ENTITY_PASCALConfiguration : IEntityTypeConfiguration<$ENTITY_PASCAL>
+{
+    public void Configure(EntityTypeBuilder<$ENTITY_PASCAL> builder)
+    {
+        // Tables métier client dans le schéma "biz" (business)
+        builder.ToTable("$ENTITY_PLURAL", "biz");
+
+        builder.HasKey(x => x.Id);
+
+        builder.Property(x => x.Name)
+            .HasMaxLength(200)
+            .IsRequired();
+
+        builder.Property(x => x.Description)
+            .HasMaxLength(1000);
+
+        builder.HasIndex(x => x.Name)
+            .IsUnique();
+    }
+}
+```
+
+---
+
+## TEMPLATE: DBCONTEXT UPDATE
+
+```csharp
+// Ajouter dans IApplicationDbContext.cs
+DbSet<$ENTITY_PASCAL> $ENTITY_PLURAL { get; }
+
+// Ajouter dans ApplicationDbContext.cs
+public DbSet<$ENTITY_PASCAL> $ENTITY_PLURAL => Set<$ENTITY_PASCAL>();
+```
+
+---
+
+## TEMPLATE: DI REGISTRATION
+
+```csharp
+// Ajouter dans src/SmartStack.Infrastructure/DependencyInjection.cs
+
+services.AddScoped<I$MODULE_PASCALService, $MODULE_PASCALService>();
+```
+
+---
+
+## CHAÎNAGE AVEC /controller:create
+
+Après génération des templates backend, le skill appelle automatiquement :
+
+```
+/controller:create Business $MODULE $ENTITY
+```
+
+Exemple :
+```
+/controller:create Business Leads Lead
+```
+
+Cela génère :
+- Controller avec CRUD complet
+- Endpoints REST
+- ProducesResponseType
+- Logging approprié
+- Tests Postman
+
+---
+
+## CHECKLIST BACKEND
+
+| Vérification | Status |
+|--------------|--------|
+| ☐ Permissions.cs mis à jour (sous Business.*) | |
+| ☐ Service interface créée | |
+| ☐ Service implementation créée | |
+| ☐ DTOs créés | |
+| ☐ Domain entity créée | |
+| ☐ EF Configuration créée (schéma "biz") | |
+| ☐ DbContext mis à jour | |
+| ☐ DI registration ajoutée | |
+| ☐ /controller:create exécuté | |
+| ☐ dotnet build réussi | |