ConnectVeiculos

Demo no ar: connectveiculos.dev.br

Codigo publicado para fins de portfolio. Uso comercial requer autorizacao — ver LICENSE.

Sistema multi-tenant de gestao para revendas de veiculos: catalogo publico SEO + admin (RBAC) + integracoes com Mercado Livre, Facebook Catalog, Google Merchant e WhatsApp Business.

Stack

• Backend: .NET 8 (API + Entity Framework Core + SignalR + Hangfire + Serilog)
• Frontend: Angular 18 (PWA + SSR + SignalR Client + Chart.js)
• Banco: SQLite — um banco por tenant (ver MULTI_TENANT.md). Postgres como fallback single-tenant.
• Deploy: Docker Compose + Nginx + Let's Encrypt + Oracle Cloud Always Free
• Multi-tenancy: subdomain routing (acme.connectveiculos.dev.br → tenant acme), banco isolado em data/{slug}.db

Pre-requisitos (local)

• .NET 8 SDK
• Node.js 22+ — nao funciona em Node 14
• Git

Setup local (5 minutos)

# 1. Clonar
git clone https://github.com/Nunes-99/ConnectVeiculos.git
cd ConnectVeiculos

# 2. Backend
cd back-end/ConnectVeiculos.API
cp appsettings.Development.example.json appsettings.Development.json
dotnet run --launch-profile http
# → http://localhost:5219 (banco SQLite criado automaticamente, admin seeded)

# 3. Frontend (em outro terminal)
cd ../front-end/ConnectVeiculos.Web
npm install
npx ng serve
# → http://localhost:4200

Login default: [email protected] / admin123 (criado automaticamente no primeiro startup do backend).

Configurar integracoes (opcionais em dev)

Integracao	Funciona local?	O que precisa
FIPE (autocomplete marca/modelo)	✅	Nada — usa API publica gratuita
Detran (consulta debitos)	✅	Nada — redireciona pro site oficial do estado
Mercado Livre	❌ (so prod)	App em developers.mercadolivre.com.br + HTTPS publico
WhatsApp Business	❌ (so prod)	Conta Meta Business + numero verificado + HTTPS publico
Facebook Catalog	❌ (so prod)	URL publica pro feed
Google Merchant	❌ (so prod)	Dominio verificado
Push PWA	⚠️ Opcional	Gerar VAPID keys (ver abaixo)

Push PWA (opcional)

Gerar uma vez:

npx web-push generate-vapid-keys

Adicione as 2 strings em appsettings.Development.json:

"Vapid": {
  "PublicKey": "BCoEQ...",
  "PrivateKey": "PfIeB...",
  "Subject": "mailto:[email protected]"
}

Sem isso, push fica desligado — resto do sistema funciona normal.

Rodar testes

# Unitarios backend (275 testes)
cd back-end
dotnet test ConnectVeiculos.sln

cd ../front-end/ConnectVeiculos.Web

# Unitarios frontend (6 testes Karma/Jasmine)
npx ng test --watch=false --browsers=ChromeHeadless

# E2E (17 testes Playwright) — precisa backend rodando
npx playwright install chromium  # primeira vez
npx playwright test

Deploy producao

Veja DEPLOY_ORACLE.md para o passo-a-passo completo. Resumo:

1. VM Ubuntu 22.04+ com Docker
2. DNS apontando pro IP da VM (recomenda wildcard *.dominio para multi-tenant)
3. Portas 80/443 abertas no firewall
4. cp .env.example .env + preencher credenciais
5. docker compose up -d --build
6. bash scripts/setup-https.sh para HTTPS via Let's Encrypt

Multi-tenant

O sistema serve N clientes (concessionarias) numa mesma instalacao Docker, cada um com banco SQLite isolado. Resolucao por subdomain:

connectveiculos.dev.br        -> tenant "default" (banco data/cliente.db)
acme.connectveiculos.dev.br   -> tenant "acme"    (banco data/acme.db)
motorsbr.connectveiculos.dev.br -> tenant "motorsbr"  (banco data/motorsbr.db)

Onboarding em ~2 min via script:

bash scripts/criar-tenant.sh \
    --slug acme \
    --nome "Acme Veiculos LTDA" \
    --admin-email [email protected] \
    --admin-senha SenhaForte123

Detalhes:

• MULTI_TENANT.md — plano arquitetural completo (entities, factories, middleware)
• GUIA-OPERACAO-MULTI-TENANT.md — playbook operacional (criar/suspender/restaurar tenants, troubleshooting)

Documentacao

• MANUAL_USUARIO.md — manual nao tecnico para o dono da loja
• GUIA-INTEGRACOES.md — passo-a-passo de cada integracao (ML, Facebook, Google, WhatsApp)
• DEPLOY_ORACLE.md — guia completo de deploy
• MULTI_TENANT.md — arquitetura multi-tenant
• GUIA-OPERACAO-MULTI-TENANT.md — operar multi-tenant
• GUIA-SEO-GOOGLE.md — Search Console + sitemap
• PRODUCAO_CHECKLIST.md — checklist pre-deploy
• PENDENCIAS.md — historico de melhorias

Estado atual

Item	Status
Backend builda	✅ 0 erros, 0 warnings
Frontend builda	✅
Testes unitarios	✅ 275/275 backend + 6/6 frontend
Testes E2E	✅ 17/17
Multi-tenant	✅ ativo em producao com tenant default
Deploy em producao	✅ https://connectveiculos.dev.br (Oracle Free Tier)
Cert SSL Lets Encrypt	✅ renovacao automatica + alerta no Discord se < 7 dias
Backup off-site	✅ daily SQLite -> Object Storage Oracle (retencao 30 dias)
Health check + monitoring externo	✅ UptimeRobot + status page
Credenciais ML/Meta/Google/WhatsApp	⏳ cliente operador configura via /integracoes

Estrutura

ConnectVeiculos/
├── back-end/                # .NET 8 (Clean Architecture)
│   ├── ConnectVeiculos.API/         # Controllers, middleware
│   ├── ConnectVeiculos.Application/ # UseCases, ViewModels
│   ├── ConnectVeiculos.Core/        # Entities, interfaces
│   ├── ConnectVeiculos.Infrastructure/ # EF Core, services externos
│   └── ConnectVeiculos.Tests/       # xUnit + Moq + FluentAssertions
├── front-end/ConnectVeiculos.Web/   # Angular 18 + SSR
├── nginx/                   # Config reverse proxy
├── scripts/                 # Setup HTTPS, criar cliente
├── banco-de-dados/          # Schema SQL de referencia
└── docker-compose.yml

Troubleshooting

Frontend nao builda com erro de Node: rode nvm use 22 antes de npm install. Backend porta 5219 em uso: mate o processo ou troque a porta em Properties/launchSettings.json. E2E falha com timeout: o backend precisa estar rodando antes de npx playwright test. Login admin nao funciona: apague back-end/ConnectVeiculos.API/ConnectVeiculos.db e rode dotnet run de novo (recria com seed limpo).