Sistema de Gerenciamento Centralizado
Este projeto possui código-fonte privado hospedado no GitHub e é protegido por licença proprietária da Cara Core Informática. A documentação aqui presente tem caráter informativo sobre as funcionalidades e arquitetura conceitual do sistema.
O Cara Core Hub é como o "cérebro central" da nossa empresa. Imagine um painel de controle de uma nave espacial - ele conecta e gerencia todos os outros projetos da Cara Core.
O que ele faz:
Sistema de gerenciamento microserviços-ready com arquitetura modular baseada em Flask. Implementa padrões de autenticação centralizada e orquestração de serviços.
Componentes principais:
Para leigos: Painel que mostra tudo importante de uma vez - como usuários online, sistemas funcionando, problemas que precisam de atenção.
Técnico: Interface responsiva com widgets customizáveis, métricas em tempo real, alertas configuráveis.
Para leigos: Controla quem pode fazer o quê - como um "porteiro digital" que decide quem entra onde.
Técnico: Sistema RBAC completo, integração OAuth2/OIDC, perfis personalizáveis, auditoria de acesso.
Para leigos: Faz diferentes partes do sistema trabalharem juntas - como um maestro organizando uma orquestra.
Técnico: Service discovery, load balancing, circuit breakers, health monitoring, auto-scaling triggers.
Para leigos: Sistema de segurança que protege tudo - como alarmes e câmeras em uma empresa.
Técnico: JWT tokens, rate limiting, CORS policies, audit logging, vulnerability scanning.
Cliente faz login no sistema através do frontend
Sistema valida credenciais e gera JWT token
Carrega métricas e status dos serviços
Gerencia usuários, monitora sistemas, configura serviços
Interface web responsiva, dashboard administrativo, formulários de configuração
REST APIs, autenticação JWT, validação de dados, rate limiting
Lógica de negócio, orquestração de serviços, processamento de tarefas
PostgreSQL, Redis, modelos SQLAlchemy, migrações automáticas
# Clonar repositório
git clone https://github.com/cara-core/hub
cd hub
# Criar ambiente virtual
python -m venv venv
venv\Scripts\activate # Windows
# source venv/bin/activate # Linux/Mac
# Instalar dependências
pip install -r requirements.txt
# Configurar banco (Docker)
docker-compose up -d postgres redis
# Executar migrações
flask db upgrade
# Rodar aplicação
python main.pyPara desenvolvimento completo usando Docker:
# Subir todos os serviços
docker-compose up -d
# Ver logs em tempo real
docker-compose logs -f web
# Executar comandos no container
docker-compose exec web flask db upgrade
docker-compose exec web python manage.py seed-dataAcesse /docs para ver a documentação Swagger interativa com todos os endpoints, schemas e exemplos.
# Todos os testes
pytest
# Com coverage
pytest --cov=app --cov-report=html
# Testes específicos
pytest tests/test_auth.py
pytest -k "test_login"
# Modo verbose
pytest -v --tb=short# Formatação automática
black app/ tests/
# Linting
flake8 app/ tests/
# Type checking
mypy app/
# Verificar tudo
python scripts/check_quality.pyGitHub Actions configurado para deploy automático:
# Build da imagem
docker build -t hub:latest .
# Tag para registry
docker tag hub:latest \
caracore.azurecr.io/hub:latest
# Push para Azure Container Registry
docker push caracore.azurecr.io/hub:latest
# Deploy no App Service
az webapp config container set \
--name cara-core-hub \
--resource-group cara-core-rg \
--docker-custom-image-name \
caracore.azurecr.io/hub:latestVerificar estas configurações antes do deploy:
Interessado em contribuir com o Cara Core Hub?
Para começar a desenvolver no Hub, siga a configuração do ambiente no Guia do Estagiário e veja as issues abertas no GitHub.