Visão geral da arquitetura
SGApi é um monólito modular .NET 10 que expõe REST para o SuperApp e persiste no MySQL do SG Linear.
Organização
SGApi Solution/
├── src/
│ ├── Features/ # Auth, Comercial, Geral, Financeiro, Fiscal…
│ ├── Shared/ # Infra, Logging, Health, Utilities
│ ├── Database/ # EF Core (Data/)
│ ├── Configuration/ # Args, bootstrap
│ ├── Program.cs
│ └── SGApi.csproj
└── tests/
├── SGApi.TestCommon/
├── SGApi.UnitTests/
├── SGApi.ArchitectureTests/
└── SGApi.IntegrationTests/
Namespaces unificados em SGApi.* (migrados de WSLinear.Consultas.*).
Vertical slice por subfeature
Cada caso de uso em src/Features/{Feature}/{Subfeature}/:
Controllers/ # API — rotas inalteradas
Services/ # regras + helpers de domínio (ex.: *Calculator)
Dtos/
Entities/
Interfaces/
Mappings/ # quando houver AutoMapper
Enums/ # quando aplicável
Attributes/ # ex.: Auth
Exemplo: Comercial/AjustesEstoque/ — AjustesEstoqueController em Controllers/, rota produtos-gestao/ajustes-estoques.