🏠 Início / 📚 Documentação / Guias De Uso / Faq

Faq

❓ Perguntas Frequentes (FAQ) - CSuite

Versão: 1.0
Última Atualização: 2025-01-02

📋 Índice

  1. Geral
  2. Acesso e Autenticação
  3. APIs e Integração
  4. Dados e Banco de Dados
  5. Performance e Monitoramento
  6. Problemas Comuns
  7. Desenvolvimento

🌐 Geral

O que é o CSuite?

O CSuite é um ecossistema integrado de aplicações que transforma dados operacionais e financeiros em consciência gerencial, alertas inteligentes e decisões melhores. É um Decision Operating System que converte realidade em contexto, contexto em decisões governadas, e decisões em memória institucional.

Mais informações: CSUITE_SUMMARY.md

Quais serviços fazem parte do CSuite?

O CSuite é composto por 15+ serviços, incluindo:

Core:
- csuite-gateway - API Gateway e roteamento
- csuite-context - Context API e Executive Dashboard
- csuite-executive - Policy Engine e governança

Operacionais:
- csuite-cfo-ops - Operações financeiras
- csuite-operations - Operações gerais
- csuite-sales-manager - Gestão de vendas
- csuite-customer-decisions - Decisões de cliente
- csuite-sales-decision - Decisões de vendas

Infraestrutura:
- csuite-feature-store - Feature Store para ML
- csuite-model-registry - Registro de modelos ML
- 4c-decision - Orquestrador 4C
- 4c-ui - Interface 4C

Mais informações: CSUITE_ECOSYSTEM_STATE.md

Como acessar o CSuite?

Gateway Principal:
- URL: https://csuite.internut.com.br/
- Documentação: https://csuite.internut.com.br/docs

Serviços Individuais:
- Cada serviço tem sua própria URL base (ex: /context, /executive, /cfo-ops)

Autenticação:
- O CSuite usa autenticação centralizada
- Faça login através do gateway

🔐 Acesso e Autenticação

Como fazer login no CSuite?

  1. Acesse https://csuite.internut.com.br/
  2. Clique em "Login" ou acesse uma URL protegida
  3. Você será redirecionado para o serviço de autenticação
  4. Após autenticação, será redirecionado de volta para a página original

Mais informações: PLANO_AUTENTICACAO_CENTRALIZADA.md

Esqueci minha senha. Como recuperar?

Entre em contato com o administrador do sistema ou use o fluxo de recuperação de senha (se implementado).

Contato: Ver SUPPORT_CONTACTS.md

Por que não consigo acessar um serviço específico?

Possíveis causas:
1. Falta de permissão: Você não tem permissão para acessar esse serviço
2. Serviço offline: O serviço pode estar temporariamente indisponível
3. Problema de autenticação: Token expirado ou inválido
4. Problema de rede: Conectividade ou DNS

Solução:
- Verifique o status do serviço em: https://csuite.internut.com.br/api/metrics
- Tente fazer logout e login novamente
- Entre em contato com suporte

🔌 APIs e Integração

Como usar as APIs do CSuite?

Cada serviço tem sua própria documentação OpenAPI/Swagger:

Acessar documentação:
- Gateway: https://csuite.internut.com.br/docs
- Serviço específico: https://csuite.internut.com.br/{service}/docs

Guias de uso:
- GUIA_USO_APIS_CONTEXT.md
- GUIA_USO_APIS_EXECUTIVE.md
- GUIA_USO_APIS_CFO_OPS.md
- E outros guias em docs/guides/

Como obter um token de autenticação para APIs?

  1. Faça login no gateway
  2. O token JWT será armazenado em cookie/session
  3. Para uso programático, use o endpoint de autenticação:
    POST /auth/login

Mais informações: Ver guia de autenticação do serviço específico

Qual é o rate limit das APIs?

Os rate limits variam por serviço e endpoint. Consulte a documentação OpenAPI de cada serviço para limites específicos.

Padrão geral:
- APIs públicas: 100 req/min por IP
- APIs autenticadas: 1000 req/min por usuário
- APIs administrativas: 500 req/min por usuário

Mais informações: RATE_LIMITING.md

💾 Dados e Banco de Dados

Quais schemas MySQL existem no CSuite?

O CSuite possui 21 schemas MySQL, organizados em categorias:

Core:
- core - Dados principais de clientes e produtos

CSuite Principal:
- csuite_context - Context API e eventos
- csuite_executive - Policy Engine
- csuite_memory - Memória institucional
- csuite_governance - Governança
- E outros...

Context API:
- context_ai, context_core, context_graph, context_radar, context_risk, context_vault

Mais informações: SCHEMAS_MAP.md

Como fazer backup dos dados?

Os backups são automáticos e executados diariamente:

Mais informações: DISASTER_RECOVERY.md

Como restaurar dados de um backup?

⚠️ CUIDADO: Restaurar dados pode causar perda de dados recentes!

Consulte o DISASTER_RECOVERY.md para procedimentos completos.

Resumo:
1. Identificar backup a restaurar
2. Parar serviços que usam o schema
3. Restaurar backup
4. Verificar integridade
5. Reativar serviços

⚡ Performance e Monitoramento

Como verificar o status dos serviços?

Dashboard de Métricas:
- Acesse: https://csuite.internut.com.br/
- Veja a seção "Métricas e Estatísticas"

API de Status:

curl https://csuite.internut.com.br/api/metrics

Health Checks:
- Gateway: https://csuite.internut.com.br/health
- Serviço específico: https://csuite.internut.com.br/{service}/health

Onde vejo os logs do sistema?

Grafana:
- Acesse: https://grafana.internut.com.br/
- Dashboards de logs e métricas

Kibana:
- Acesse: https://kibana.internut.com.br/
- Análise de logs com KQL

Logs via Docker:

docker service logs csuite-gateway_csuite-gateway

Por que um serviço está lento?

Possíveis causas:
1. Alta carga: Muitas requisições simultâneas
2. Problema de banco de dados: Queries lentas ou locks
3. Problema de rede: Latência ou conectividade
4. Recursos insuficientes: CPU/memória do servidor

Solução:
- Verificar métricas no Grafana
- Verificar logs de erro
- Consultar TROUBLESHOOTING.md

🐛 Problemas Comuns

Erro 404 ao acessar um endpoint

Possíveis causas:
1. URL incorreta: Verifique a URL completa
2. Rota não existe: Consulte a documentação OpenAPI
3. Problema de roteamento: Gateway não está roteando corretamente

Solução:
- Verificar documentação do serviço: https://csuite.internut.com.br/{service}/docs
- Verificar logs do gateway
- Tentar acessar diretamente o serviço (se possível)

Erro 500 (Internal Server Error)

Possíveis causas:
1. Erro no código: Bug no serviço
2. Problema de banco de dados: Query falhou ou timeout
3. Dependência offline: Serviço dependente não está respondendo

Solução:
1. Verificar logs do serviço:
bash docker service logs --tail 100 {service_name}
2. Verificar status de dependências
3. Consultar TROUBLESHOOTING.md
4. Reportar o problema (ver seção de suporte)

Erro 401 (Unauthorized)

Possíveis causas:
1. Token expirado: Faça login novamente
2. Token inválido: Token corrompido ou inválido
3. Falta de permissão: Você não tem permissão para acessar

Solução:
- Fazer logout e login novamente
- Verificar se você tem as permissões necessárias
- Verificar se o token está sendo enviado corretamente (header Authorization)

Erro 503 (Service Unavailable)

Possíveis causas:
1. Serviço offline: Serviço não está rodando
2. Sobrecarga: Serviço sobrecarregado
3. Manutenção: Serviço em manutenção

Solução:
- Verificar status do serviço: https://csuite.internut.com.br/api/metrics
- Aguardar alguns minutos e tentar novamente
- Verificar se há manutenção programada

Como reportar um bug ou problema?

Canais de suporte:
1. Slack: #csuite-support
2. Email: support@internut.com.br
3. GitHub Issues: (se aplicável)

Informações a incluir:
- Descrição do problema
- Passos para reproduzir
- Mensagens de erro (completas)
- Screenshots (se aplicável)
- Timestamp do problema
- Serviço afetado

Mais informações: SUPPORT_CONTACTS.md

👨‍💻 Desenvolvimento

Como contribuir com o CSuite?

Consulte o CONTRIBUTING.md para:
- Processo de pull request
- Padrões de código
- Como reportar bugs
- Como sugerir melhorias

Como configurar ambiente de desenvolvimento?

Pré-requisitos:
- Docker e Docker Compose
- Python 3.11+
- MySQL 8.0+
- Git

Passos:
1. Clonar repositório
2. Configurar variáveis de ambiente
3. Iniciar serviços com Docker Compose
4. Executar migrações de banco de dados

Mais informações: ONBOARDING.md

Onde encontro a documentação de desenvolvimento?

Documentação técnica:
- development/ - Guias de desenvolvimento
- architecture/ - Arquitetura e design
- api/ - Documentação de APIs

Guias específicos:
- BOAS_PRATICAS.md
- TESTING.md
- CODE_REVIEW.md

📞 Suporte Adicional

Não encontrei a resposta para minha pergunta

Canais de suporte:
- Documentação: Explore docs/ para mais informações
- Slack: #csuite-support
- Email: support@internut.com.br

Documentos úteis:
- TROUBLESHOOTING.md - Guia de troubleshooting
- GUIA_USO_ECOSSISTEMA.md - Guia geral de uso
- ONBOARDING.md - Guia de onboarding

Como sugerir melhorias?

Canais:
1. GitHub Issues: (se aplicável)
2. Email: product@internut.com.br
3. Slack: #csuite-feedback

Informações a incluir:
- Descrição da melhoria
- Caso de uso
- Benefícios esperados
- Prioridade sugerida

📝 Notas

Última Atualização: 2025-01-02
Próxima Revisão: 2025-04-02 (trimestral)

Contribuições: Este FAQ é atualizado regularmente. Se você identificar uma pergunta frequente que não está aqui, por favor sugira adicioná-la.

🔗 Documentos Relacionados

🔊 Text-to-Speech

1.0x
1.0
Pronto para reproduzir