Skip to content

Migrar Commander API para .NET 10 LTS #1

Closed

Description

@savaladaojr

Contexto

A analise registrada em docs/REQUISITOS_APLICACAO.md identificou que a Commander API ainda usa ASP.NET Core/.NET Core 3.1, que esta fora de suporte. A aplicacao deve ser migrada para a versao suportada mais recente do ecossistema .NET.

Versao alvo

  • Migrar para .NET 10 LTS (net10.0), versao LTS atual recomendada pela Microsoft.
  • Atualizar ASP.NET Core, Entity Framework Core, JsonPatch/NewtonsoftJson e demais pacotes compatíveis.

Escopo previsto

  • Atualizar Commander.csproj para net10.0.
  • Atualizar referencias NuGet para versoes compativeis com .NET 10.
  • Migrar o bootstrap da aplicacao do modelo Startup.cs/CreateHostBuilder para o hosting moderno com WebApplicationBuilder, se aplicavel.
  • Ajustar configuracao de controllers, Newtonsoft.Json e JSON Patch para os padroes atuais.
  • Atualizar Entity Framework Core e manter compatibilidade com SQL Server e migrations existentes.
  • Revisar nullable reference types e inicializacao de propriedades obrigatorias.
  • Corrigir nomes de metodos/variaveis com typos quando isso nao quebrar contratos publicos.
  • Ajustar launchSettings.json para apontar para a rota real da API.
  • Atualizar documentacao de requisitos para refletir a nova versao, componentes e proximos passos remanescentes.

Fora de escopo desta issue

  • Implementar autenticacao/autorizacao.
  • Criar paginacao, filtros ou busca.
  • Trocar banco de dados.
  • Remover completamente secrets reais do historico Git.
  • Criar uma suite completa de testes automatizados, salvo ajustes mínimos se o projeto ja oferecer estrutura.

Criterios de aceite

  • O projeto aponta para net10.0.
  • Pacotes principais estao em versoes compativeis com .NET 10.
  • A API preserva os endpoints REST atuais de /api/commands.
  • O suporte a JSON Patch continua configurado.
  • A configuracao de SQL Server via CommanderConnection continua funcionando.
  • A documentacao criada em docs/REQUISITOS_APLICACAO.md e atualizada com o status da migracao.
  • Build/testes locais sao executados quando o SDK estiver disponivel; caso contrario, a limitacao e documentada.

Riscos e pontos de atencao

  • EF Core 10 pode exigir ajustes em migrations ou design-time packages.
  • JsonPatch depende de Newtonsoft.Json e deve ser mantido explicitamente.
  • O ambiente atual pode nao ter o SDK do .NET instalado, limitando validacao local.

Activity

  1. savaladaojr commented on Jun 3, 2026

    @savaladaojr
    OwnerAuthor

    Atualizacao executada na branch codex/issue-1-dotnet10-migration

    Resumo das alteracoes realizadas:

    • Projeto migrado de netcoreapp3.1 para net10.0.
    • Pacotes NuGet atualizados para as versoes mais recentes disponiveis nas fontes configuradas:
      • AutoMapper 16.1.1
      • Microsoft.AspNetCore.JsonPatch 10.0.8
      • Microsoft.AspNetCore.Mvc.NewtonsoftJson 10.0.8
      • Microsoft.EntityFrameworkCore 10.0.8
      • Microsoft.EntityFrameworkCore.Design 10.0.8
      • Microsoft.EntityFrameworkCore.SqlServer 10.0.8
    • Bootstrap migrado para hosting moderno com WebApplicationBuilder em Program.cs.
    • Startup.cs removido.
    • Nullable reference types e implicit usings habilitados.
    • DTOs/modelo ajustados para inicializacao segura de strings.
    • CommandReadDto agora retorna platform.
    • Typos internos corrigidos em metodos/variaveis do controller.
    • launchSettings.json atualizado para abrir api/commands.
    • Connection string local removida de usuario/senha explicitos e mantida com Trusted Connection.
    • README.md atualizado para .NET 10, endpoints atuais, PATCH, setup de banco e notas de migracao.
    • Documento docs/REQUISITOS_APLICACAO.md atualizado com o novo estado da aplicacao e proximos passos.

    Validacoes locais:

    • dotnet build: sucesso, 0 warnings, 0 errors.
    • dotnet list package --outdated: nenhum pacote desatualizado.
    • dotnet test --no-build: executado, sem projetos/testes automatizados encontrados.
    • dotnet ef migrations list --no-build: migration inicial carregada como pendente; aviso apenas de ferramenta global dotnet-ef 10.0.5 versus runtime/pacotes 10.0.8.
  2. savaladaojr commented on Jun 3, 2026

    @savaladaojr
    OwnerAuthor

    Resolved by merged PR #2.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions