📚 Documentação Completa - Serviços AWS do Lumina Flow Builder
📋 Índice Geral
Este diretório contém a documentação completa de 56 operações distribuídas em 8 serviços AWS avançados integrados ao Lumina Flow Builder.
🔍 AWS REKOGNITION - Visão Computacional (6 operações)
Serviço de análise de imagens e vídeos usando machine learning para detectar objetos, rostos, texto, cenas e atividades.
Operações Disponíveis
| Operação | Arquivo | Descrição |
|---|---|---|
| detectLabels | rekognition_detect_labels.md | Detecta objetos, cenas e conceitos em imagens |
| detectFaces | rekognition_detect_faces.md | Detecta rostos e extrai atributos faciais (emoções, idade, gênero) |
| compareFaces | rekognition_compare_faces.md | Compara rostos entre duas imagens para verificação de identidade |
| detectText | rekognition_detect_text.md | Extrai texto de imagens usando OCR |
| detectModerationLabels | rekognition_detect_moderation_labels.md | Detecta conteúdo impróprio, violento ou adulto |
| recognizeCelebrities | rekognition_recognize_celebrities.md | Identifica celebridades e figuras públicas |
Casos de Uso
- ✅ Moderação automática de conteúdo em plataformas sociais
- ✅ Verificação KYC (Know Your Customer) com comparação facial
- ✅ Catalogação automática de produtos em e-commerce
- ✅ Análise de emoções em eventos e pesquisas
- ✅ Extração de texto de documentos e placas
- ✅ Detecção de celebridades em fotos de eventos
🎤 AWS TRANSCRIBE - Transcrição de Áudio (4 operações)
Serviço de conversão automática de fala para texto com suporte a múltiplos idiomas e identificação de speakers.
Operações Disponíveis
| Operação | Arquivo | Descrição |
|---|---|---|
| startJob | transcribe_start_job.md | Inicia transcrição assíncrona de áudio |
| getJob | transcribe_get_job.md | Consulta status e resultado de transcrição |
| deleteJob | transcribe_delete_job.md | Exclui trabalho de transcrição |
| listJobs | transcribe_list_jobs.md | Lista trabalhos de transcrição com filtros |
Casos de Uso
- ✅ Transcrição de chamadas de call center
- ✅ Geração automática de legendas para vídeos
- ✅ Documentação de reuniões e entrevistas
- ✅ Análise de sentimento em áudios transcritos
- ✅ Acessibilidade para conteúdo de áudio
📄 AWS TEXTRACT - OCR Avançado (6 operações)
Serviço de extração de texto e dados de documentos estruturados (formulários, tabelas, notas fiscais, IDs).
Operações Disponíveis
| Operação | Arquivo | Descrição |
|---|---|---|
| analyzeDocument | textract_analyzeDocument.md | Analisa documentos estruturados com forms e tables |
| detectText | textract_detectText.md | Detecta e extrai texto simples de documentos |
| analyzeExpense | textract_analyzeExpense.md | Analisa notas fiscais e recibos |
| analyzeID | textract_analyzeID.md | Extrai dados de documentos de identidade |
| startAnalysis | textract_startAnalysis.md | Inicia análise assíncrona de documentos grandes |
| getAnalysisResult | textract_getAnalysisResult.md | Obtém resultado de análise assíncrona |
Casos de Uso
- ✅ Digitalização automática de documentos fiscais
- ✅ Extração de dados de RG, CNH, passaportes
- ✅ Processamento de formulários preenchidos à mão
- ✅ Análise de contratos e documentos legais
- ✅ Automação de entrada de dados
🧠 AWS COMPREHEND - NLP e Análise de Texto (5 operações)
Serviço de processamento de linguagem natural para extrair insights de textos.
Operações Disponíveis
| Operação | Arquivo | Descrição |
|---|---|---|
| detectSentiment | comprehend_detectSentiment.md | Detecta sentimento (positivo, negativo, neutro, misto) |
| detectEntities | comprehend_detectEntities.md | Detecta entidades nomeadas (pessoas, locais, organizações) |
| detectKeyPhrases | comprehend_detectKeyPhrases.md | Extrai frases-chave e conceitos principais |
| detectLanguage | comprehend_detectLanguage.md | Detecta idioma do texto automaticamente |
| detectSyntax | comprehend_detectSyntax.md | Analisa sintaxe gramatical (substantivos, verbos, etc) |
Casos de Uso
- ✅ Análise de sentimento em avaliações de clientes
- ✅ Extração de entidades de notícias e artigos
- ✅ Categorização automática de documentos
- ✅ Detecção de idioma em chat multilíngue
- ✅ Análise de feedback de produtos
🔐 AWS COGNITO - Gerenciamento de Usuários (8 operações)
Serviço de autenticação e gerenciamento de identidades de usuários.
Operações Disponíveis
| Operação | Arquivo | Descrição |
|---|---|---|
| listUserPools | cognito_listUserPools.md | Lista user pools existentes |
| getUserPool | cognito_getUserPool.md | Obtém detalhes de user pool específico |
| createUserPool | cognito_createUserPool.md | Cria novo user pool |
| deleteUserPool | cognito_deleteUserPool.md | Exclui user pool |
| createUser | cognito_createUser.md | Cria novo usuário no pool |
| deleteUser | cognito_deleteUser.md | Exclui usuário do pool |
| getUser | cognito_getUser.md | Obtém informações de usuário |
| listUsers | cognito_listUsers.md | Lista usuários do pool |
Casos de Uso
- ✅ Sistema de cadastro e login de usuários
- ✅ Autenticação federada (Google, Facebook, etc)
- ✅ Gerenciamento de perfis de usuários
- ✅ Controle de acesso baseado em grupos
- ✅ Multi-factor authentication (MFA)
👤 AWS IAM - Identity and Access Management (13 operações)
Serviço de gerenciamento de permissões e políticas de acesso AWS.
Operações Disponíveis
| Operação | Arquivo | Descrição |
|---|---|---|
| listUsers | iam_listUsers.md | Lista usuários IAM |
| getUser | iam_getUser.md | Obtém detalhes de usuário IAM |
| createUser | iam_createUser.md | Cria novo usuário IAM |
| deleteUser | iam_deleteUser.md | Exclui usuário IAM |
| createAccessKey | iam_createAccessKey.md | Cria chave de acesso programático |
| deleteAccessKey | iam_deleteAccessKey.md | Exclui chave de acesso |
| listAccessKeys | iam_listAccessKeys.md | Lista chaves de acesso do usuário |
| listRoles | iam_listRoles.md | Lista roles IAM |
| getRole | iam_getRole.md | Obtém detalhes de role |
| createRole | iam_createRole.md | Cria novo role IAM |
| deleteRole | iam_deleteRole.md | Exclui role IAM |
| attachRolePolicy | iam_attachRolePolicy.md | Anexa policy a role |
| detachRolePolicy | iam_detachRolePolicy.md | Remove policy de role |
Casos de Uso
- ✅ Provisionamento automático de usuários AWS
- ✅ Gestão de permissões em pipelines CI/CD
- ✅ Criação de roles para Lambda e EC2
- ✅ Auditoria de acessos e políticas
- ✅ Rotação automática de chaves de acesso
⚖️ AWS ELB - Elastic Load Balancing (10 operações)
Serviço de balanceamento de carga para distribuir tráfego entre instâncias.
Operações Disponíveis
| Operação | Arquivo | Descrição |
|---|---|---|
| listLoadBalancers | elb_listLoadBalancers.md | Lista load balancers existentes |
| getLoadBalancer | elb_getLoadBalancer.md | Obtém detalhes de load balancer |
| createLoadBalancer | elb_createLoadBalancer.md | Cria novo load balancer |
| deleteLoadBalancer | elb_deleteLoadBalancer.md | Exclui load balancer |
| listTargetGroups | elb_listTargetGroups.md | Lista target groups |
| createTargetGroup | elb_createTargetGroup.md | Cria novo target group |
| deleteTargetGroup | elb_deleteTargetGroup.md | Exclui target group |
| registerTargets | elb_registerTargets.md | Registra instâncias no target group |
| deregisterTargets | elb_deregisterTargets.md | Remove instâncias do target group |
| getTargetHealth | elb_getTargetHealth.md | Verifica saúde dos targets |
Casos de Uso
- ✅ Provisionamento automático de infraestrutura
- ✅ Escalonamento horizontal de aplicações
- ✅ Health checks automatizados
- ✅ Distribuição de tráfego entre zonas
- ✅ Blue-green deployments
🔒 AWS ACM - Certificate Manager (4 operações)
Serviço de gerenciamento de certificados SSL/TLS para aplicações.
Operações Disponíveis
| Operação | Arquivo | Descrição |
|---|---|---|
| list | acm_list.md | Lista certificados SSL/TLS |
| get | acm_get.md | Obtém detalhes de certificado |
| request | acm_request.md | Solicita novo certificado |
| delete | acm_delete.md | Exclui certificado |
Casos de Uso
- ✅ Provisionamento automático de certificados SSL
- ✅ Renovação automática de certificados
- ✅ Gerenciamento de domínios e subdomínios
- ✅ Validação DNS automatizada
- ✅ Integração com CloudFront e ALB
📊 Estatísticas da Documentação
Resumo Geral
- Total de Serviços: 8
- Total de Operações Documentadas: 56
- Serviço com Mais Operações: AWS IAM (13 operações)
- Padrão Seguido: 100% conforme DOCUMENTATION_GUIDE.md
Distribuição por Serviço
| Serviço | Operações | Categoria |
|---|---|---|
| AWS Rekognition | 6 | Visão Computacional |
| AWS Transcribe | 4 | Áudio/Voz |
| AWS Textract | 6 | OCR/Documentos |
| AWS Comprehend | 5 | NLP/Texto |
| AWS Cognito | 8 | Autenticação |
| AWS IAM | 13 | Segurança |
| AWS ELB | 10 | Infraestrutura |
| AWS ACM | 4 | Certificados |
🎯 Como Usar Esta Documentação
1. Encontrar uma Operação Específica
Use o índice acima ou navegue pelos arquivos .md correspondentes.
2. Estrutura de Cada Arquivo
Cada operação documentada contém: - ✅ O que é e por que existe - ✅ Como funciona internamente (código TypeScript real) - ✅ Parâmetros detalhados com exemplos - ✅ Flows JSON completos e testáveis - ✅ Exemplos de uso real - ✅ Boas práticas e dicas - ✅ Links para operações relacionadas
3. Testar no Lumina Flow Builder
Todos os flows JSON podem ser importados diretamente no editor visual do Lumina.
4. Código-Fonte
Os executors estão localizados em:
src/whatsapp-flows/node-executors/
├── aws-rekognition.executor.ts
├── aws-transcribe.executor.ts
├── aws-textract.executor.ts
├── aws-comprehend.executor.ts
├── aws-cognito.executor.ts
├── aws-iam.executor.ts
├── aws-elb.executor.ts
└── aws-certificate-manager.executor.ts
🔗 Serviços AWS Básicos (Já Documentados)
Além dos serviços avançados acima, também temos documentação completa para:
- ✅ AWS S3 - Armazenamento de objetos
- ✅ AWS SQS - Filas de mensagens
- ✅ AWS SNS - Notificações pub/sub
- ✅ AWS DynamoDB - Banco NoSQL
📞 Suporte
Para dúvidas sobre:
- Uso das Operações: Consulte a documentação específica de cada operação
- Código-Fonte: Veja os executors em
src/whatsapp-flows/node-executors/ - Padrão de Documentação: Leia DOCUMENTATION_GUIDE.md
📝 Notas Importantes
Credenciais AWS
Todas as operações requerem credenciais AWS válidas:
{
"config": {
"region": "us-east-1",
"accessKeyId": "YOUR_ACCESS_KEY_ID",
"secretAccessKey": "YOUR_SECRET_ACCESS_KEY"
}
}
Custos AWS
⚠️ ATENÇÃO: Cada chamada a esses serviços AWS gera custos. Consulte a calculadora de preços da AWS para estimar custos.
Limites e Quotas
Cada serviço AWS possui limites de taxa e quotas. Consulte a documentação oficial da AWS para detalhes.
Última Atualização: 2025-10-13 Status: Documentação completa de todos os 8 serviços AWS avançados Total de Arquivos: 56 operações documentadas Conformidade: 100% com o padrão DOCUMENTATION_GUIDE.md