SaasSubscription API

API REST para gestão de assinaturas SaaS. Projeto em .NET com arquitetura em camadas.

Nota: Este projeto está em evolução. O README e a documentação serão atualizados conforme novas funcionalidades forem adicionadas.

---

Stack

Camada	Tecnologia
Runtime	.NET 10
API	ASP.NET Core Minimal APIs
Documentação	OpenAPI 3.x

---

Estrutura do projeto

SaasSubscription/
├── SaasSubscription.API/           # Camada de apresentação (endpoints, pipeline)
├── SaasSubscription.Application/   # Casos de uso, orquestração
├── SaasSubscription.Domain/        # Entidades, regras de negócio (núcleo)
├── SaasSubscription.Infrastructure/ # Persistência, serviços externos
└── README.md

• API: expõe HTTP, configuração de serviços e pipeline. Depende de Application e Infrastructure.
• Application: orquestra fluxos e usa o Domain. Sem dependência de infra ou API.
• Domain: entidades e regras puras. Sem dependências externas.
• Infrastructure: implementa repositórios, DbContext, integrações. Depende de Domain e Application (interfaces).

---

Pré-requisitos

• .NET 10 SDK

---

Como rodar

cd SaasSubscription.API
dotnet run

A API sobe por padrão em https://localhost:5xxx (ou porta indicada no console). Em Development, o OpenAPI fica disponível em /openapi/v1.json.

---

Endpoints (estado atual)

Método	Rota	Descrição
GET	/weatherforecast	Endpoint de exemplo (template)

Documentação OpenAPI disponível em ambiente de desenvolvimento.

---

Notas do projeto

• Autor: Vitor Tresoldi
• Versão: 1.0.0

Decisões de arquitetura

• Clean Architecture: Domain no centro; Application e Infrastructure implementam interfaces definidas no Domain ou Application.
• Minimal APIs para manter a API enxuta; controllers podem ser adicionados depois se fizer sentido.
• OpenAPI habilitado apenas em Development (conforme Program.cs).

Próximos passos sugeridos

1. Domain: modelar entidades de assinatura (Plano, Assinatura, Cliente, etc.) e substituir/remover Class1.cs.
2. Application: definir interfaces de repositório e serviços; implementar casos de uso (criar/renovar/cancelar assinatura).
3. Infrastructure: configurar DbContext (ex.: EF Core), repositórios e, se necessário, clientes HTTP para gateways de pagamento.
4. API: registrar serviços (DI), mapear endpoints de assinaturas e configurar autenticação/autorização quando houver.
5. Config: usar appsettings.json e variáveis de ambiente para connection strings e segredos; não versionar .env ou segredos.

Convenções

• C# com Nullable e ImplicitUsings habilitados.
• Nomes de projetos e namespaces seguem o padrão SaasSubscription.{Camada}.

---

Licença

Uso interno / sob definição do titular do repositório.