@atlashub/smartstack-cli 1.13.2 → 1.14.0

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

@@ -1,463 +0,0 @@
-# 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 | |