Este repositório contém o material do projeto técnico VCheck., uma iniciativa fictícia.
O PROJETO NÃO É UMA SOLUÇÃO COMPLETA E NEM UM MVP.
LOGO NÃO ESTÁ CONTEMPLADO TODOS ASPECTOS DE NEGÓCIO.
Este projeto é fictício e utilizado apenas para fins de demonstração, desafios técnicos e treinamento.
Este projeto está licenciado sob a licença MIT.
/docs— Documentação (ver índice em docs/README.md).- Guia rápido de execução: Getting Started
- Requisitos de negócio: Core Business
- System Design da solução: System Design
- Arquitetura de Monolito Modular: Monolito Modular
/src— Código-fonte (.NET) (detalhes em src/README.md)/infra— Infraestrutura como código (IaC) para Azure (detalhes em infra/README.md)
A solução demonstra um backend .NET 8 em arquitetura de Monólito Modular que expõe uma API para execução de checklists de veículos. A autenticação local é feita via Keycloak orquestrado pelo Host Aspire, suportando perfis (roles) de Executor e Supervisor conforme requisitos de negócio.
Para o racional arquitetural completo consulte o System Design.
Para passos detalhados use o guia: Getting Started. Resumo:
- Pré-requisitos: .NET 8 SDK + Docker.
dotnet run --project src/Host/VCheck.Host.csproj(Aspire sobe SQL Server, Keycloak, jobs de migração e API).- Abrir Swagger da API e autenticar (client:
vcheck-api, secret:S3cr3t, usuários:user.executorouuser.supervisor, senha:123).
Detalhes de infraestrutura (migrações, realm, usuários) em: Infraestrutura / Host.
- Completar fluxos de checklist (listagem, histórico, reprovação com motivo)
- Testes automatizados e cobertura mínima
- Observabilidade (logs estruturados, tracing)
- Builds e pipelines com análise estática (SonarQube)
- Endpoints de consulta para supervisores
- Ajustar fluxo de autenticação para Authorization Code + PKCE ao introduzir frontend SPA
- Leia Core Business
- Leia System Design
- Siga o Getting Started
- Explore a organização de módulos em src/README.md
- Consulte infra/README.md para visão de Terraform (cloud)