DotCraft 1.0.3

DotCraft

O CLI de scaffolding de soluções .NET

DotCraft é uma ferramenta de linha de comando que gera soluções .NET completas e prontas para produção seguindo padrões modernos de arquitetura — Clean Architecture ou Vertical Slice — com todo o boilerplate já configurado para que você foque no que importa: a lógica de negócio.

Instalação

dotnet tool install --global DotCraft

Atualização

dotnet tool update --global DotCraft

Uso

dotcraft new solution [opções]

Opções

Exemplos

# Clean Architecture com PostgreSQL e Scalar
dotcraft new solution -n MeuProjeto -a clean -d postgres --docs scalar -v 10 --tests all

# Vertical Slice com SQL Server e Swagger
dotcraft new solution -n MeuProjeto -a vertical -d sqlserver --docs swagger -v 9 --tests integration

# Setup mínimo sem testes adicionais
dotcraft new solution -n MeuProjeto -a clean -d postgres --docs scalar --tests none

O que é gerado

Clean Architecture

MeuProjeto/
├── src/
│   ├── MeuProjeto.Api            # Camada HTTP (endpoints, middleware, setup)
│   ├── MeuProjeto.Application    # Lógica de negócio (CQRS, validação)
│   ├── MeuProjeto.Infrastructure # Persistência, EF Core, repositórios
│   └── MeuProjeto.Domain         # Entidades, value objects, exceções
├── tests/
│   ├── MeuProjeto.UnitTests
│   ├── MeuProjeto.IntegrationTests
│   └── MeuProjeto.AcceptanceTests
├── docs/
├── .editorconfig
├── .gitignore
├── Directory.Build.props
├── Directory.Packages.props
├── Dockerfile
└── docker-compose.yml

Vertical Slice

MeuProjeto/
├── src/
│   └── MeuProjeto.Api
│       ├── Features/          # Uma pasta por feature
│       ├── Shared/            # Abstrações, Result pattern, behaviors
│       ├── Infrastructure/    # Persistência, DbContext, repositórios
│       └── Setups/            # Configuração do builder e pipeline
├── tests/
│   ├── MeuProjeto.UnitTests
│   ├── MeuProjeto.IntegrationTests
│   └── MeuProjeto.AcceptanceTests
├── .editorconfig
├── .gitignore
├── Directory.Build.props
├── Directory.Packages.props
├── Dockerfile
└── docker-compose.yml

O que está incluído

Sempre gerado

• Directory.Build.props — configuração de build centralizada
• Directory.Packages.props — versões de pacotes NuGet centralizadas via CPM
• .editorconfig — convenções de estilo de código
• .gitignore — gitignore padrão para .NET
• Dockerfile — build multi-stage Alpine com usuário não-root
• docker-compose.yml — pré-configurado para o banco de dados escolhido

Por arquitetura

• Result pattern (Result<T>, Error, ErrorType)
• Contratos CQRS (ICommand, IQuery, ICommandHandler, IQueryHandler)
• ValidationBehavior com pipeline do FluentValidation
• GlobalExceptionHandler com ProblemDetails
• Classe base Entity com UUIDv7, campos de auditoria e eventos de domínio
• Classe base ValueObject
• Contratos IRepository<T> e IUnitOfWork
• AppDbContext com ApplyConfigurationsFromAssembly
• BaseEntityTypeConfiguration<T> para mapeamentos do EF Core
• Implementação de UnitOfWork
• Extensions de DependencyInjection por camada
• BuilderSetup e PipelineSetup
• Health checks configurados para o banco escolhido
• Documentação da API (Scalar ou Swagger)
• Program.cs pronto para rodar

Versões de pacotes

Todas as versões de pacotes NuGet são resolvidas em tempo de geração diretamente da API do NuGet — sempre atualizadas e compatíveis com a versão do .NET escolhida.

Stack técnica

Requisitos

• .NET 9 SDK ou superior

Licença

MIT