¶ 📌 Geração Automática de Código no SSAG3.0
¶ 📚 Visão Geral
A geração automática de código no SSAG3.0 garante padronização, produtividade e conformidade com DDD, SOLID e Clean Code. A funcionalidade permite criar entidades, repositórios, serviços, DTOs, validações, controllers e UI Blazor de forma automática, baseada nos metadados das tabelas.
¶ Arquitetura
¶ 🛠️ Estrutura da Geração de Código
Os templates estão organizados em:
SSAG3.ERP.Shared/Templates/
├── BackEnd/
│ ├── Domain/
│ │ ├── Entity.template
│ │ ├── RepositoryInterface.template
│ ├── Application/
│ │ ├── Service.template
│ │ ├── ServiceInterface.template
│ │ ├── BackendValidator.template
│ ├── Infrastructure/
│ │ ├── Configuration.template
│ │ ├── Repository.template
│ ├── API/
│ │ ├── Controller.template
│ │ ├── DependencyInjection.template
│ ├── Shared/
│ │ ├── DTO.template
│ │ ├── Validation.template
├── FrontEnd/
│ ├── UIWeb/
│ │ ├── EntityForm.template
│ │ ├── ListPage.template
│ │ ├── Service.template
│ │ ├── InjecoesDependencias.template
¶ 🛠️ Processo de Geração de Código
¶ 1. Obter Metadados da Tabela
Consulta SYS_BDF para obter:
- Nome da tabela
- Campos
- Relacionamentos
- Regras de validação
- Configuração de persistência
¶ 2. Selecionar Template Base
Definição do modelo:
public enum TipoModeloFonte
{
BackEndDDD,
FrontBlazorServer,
FrontUIMobile,
FrontUIMaui,
SqlServer
}
¶ 3. Aplicar Placeholders
Os placeholders do template são preenchidos dinamicamente:
{{EntityAlias}}→ Nome da classe entidade{{Namespace}}→ Namespace correto{{Propriedades}}→ Lista de propriedades geradas{{DataAtual}}→ Data da geração
¶ 4. Gerar Código para Cada Camada
GeradorEntidade.Gerar(metadados, _templates["Entidade"]);
GeradorRepositorio.Gerar(metadados, _templates["Repositorio"]);
GeradorService.Gerar(metadados, _templates["Service"]);
GeradorDTO.Gerar(metadados, _templates["DTO"]);
GeradorValidator.Gerar(metadados, _templates["Validator"]);
GeradorController.Gerar(metadados, _templates["Controller"]);
GeradorConfiguration.Gerar(metadados, _templates["Configuration"]);
¶ 📂 Regras para Geração de Código
¶ 🔹 Geração de Entidades
- Ordem dos campos respeitada (
Ordem). - Campos
Virtualnão são persistidos ([NotMapped]). - Campos
SomenteLeiturasão protegidos na UI. - PKs marcadas com
[Key]. - Campos obrigatórios recebem
[Required]. - Strings recebem
[MaxLength]conforme a tabela.
Exemplo:
public class SYS_BDT : BaseEntity
{
[Key]
[Required]
[MaxLength(10)]
public string Id { get; set; } // Identificador da tabela.
[Required]
[MaxLength(120)]
public string Nome { get; set; } // Nome da tabela.
[NotMapped]
public string NomeFormatado { get; set; } // Apenas para UI
}
¶ 🔹 Geração de Validações
public class TabelaDTOValidator : AbstractValidator<TabelaDTO>
{
public TabelaDTOValidator()
{
RuleFor(x => x.Id).NotEmpty().WithMessage("O Id é obrigatório.");
RuleFor(x => x.Nome).NotEmpty().WithMessage("O Nome é obrigatório.")
.MaximumLength(120).WithMessage("Máximo de 120 caracteres.");
}
}
¶ 📁 Estrutura do Código Gerado
SSAG3.ERP/
├── Domain/
│ ├── Entities/
│ │ ├── Tabela.cs
│ ├── Repositories/
│ │ ├── ITabelaRepository.cs
├── Application/
│ ├── DTOs/
│ │ ├── TabelaDTO.cs
│ ├── Services/
│ │ ├── TabelaService.cs
│ ├── Validators/
│ │ ├── TabelaDTOValidator.cs
├── Infrastructure/
│ ├── Repositories/
│ │ ├── TabelaRepository.cs
├── API/
│ ├── Controllers/
│ │ ├── TabelaController.cs
├── UIWeb/
│ ├── Pages/
│ │ ├── TabelaList.razor
│ │ ├── TabelaForm.razor
¶ 💪 Boas Práticas
- Apenas templates versionados devem ser usados.
- Evitar alterações manuais no código gerado.
- Validar
SYS_BDTeSYS_BDCantes da geração. - Seguir a estrutura do modelo de código.
📝 Autor: Márcio de Matos Costa
🗓️ Última Atualização: 07/02/2025
🌐 Projeto: SSAG3.0 - ERP Inteligente