🚴 Ameciclo Bot

Bot do Telegram desenvolvido para automatizar e otimizar os processos internos da Ameciclo (Associação Metropolitana de Ciclistas do Recife). O bot integra múltiplos serviços Google, Azure AI e Firebase para oferecer uma solução completa de gestão organizacional através do Telegram.

🎯 Sobre a Ameciclo

A Ameciclo é uma organização da sociedade civil que promove o uso da bicicleta como meio de transporte sustentável no Grande Recife. Este bot foi desenvolvido para digitalizar e automatizar processos administrativos, financeiros e de comunicação da associação.

🚀 Funcionalidades Principais

O bot oferece 20 comandos ativos organizados em categorias funcionais:

📄 Gestão de Documentos e Arquivos

/documento - Cria Google Docs automaticamente em pastas organizadas por grupo de trabalho
/apresentacao - Cria Google Slides com templates organizacionais
/planilha - Cria Google Sheets para análise de dados
/formulario - Cria Google Forms automaticamente com monitoramento de respostas
/modelo - Biblioteca de modelos de documentos com sistema de cópia inteligente
/novo_arquivo - Sistema unificado para criação de arquivos Google (Docs, Sheets, Slides, Forms)
/unir_pdfs - Une múltiplos arquivos PDF em um único documento usando PDF-lib
/transcrever - Transcreve áudios e vídeos para texto usando Azure Whisper AI
/registrar_planilha - Sistema de registro e catalogação de planilhas organizacionais

💰 Gestão Financeira Avançada

/ajudante_financeiro - Assistente unificado que integra 6 comandos financeiros:
- Arquivar comprovantes de pagamento no Google Drive
- Gerar recibos de ressarcimento com notas fiscais
- Arquivar extratos bancários em PDF com OCR inteligente
- Processar extratos CSV/TXT com reconciliação automática
- Atualizar pendências financeiras em planilhas Google Sheets
- Monitorar e atualizar status de projetos em tempo real
/processar_extrato - Processamento geral de extratos bancários com IA
Sistema de Aprovação: Workflow automatizado com notificações para coordenadores
Central Ameciclista: Interface web para solicitações de pagamento (comando /pagamento desativado)

📅 Eventos e Comunicação

/evento - Cria eventos no Google Calendar com IA para extração de dados de texto natural
/atribuir_evento - Atribui eventos a grupos de trabalho específicos
/complementar_evento - Adiciona informações complementares a eventos existentes
/clipping - Gestão de clipping de notícias e mídia
/informe - Sistema de criação e distribuição de informes organizacionais
Agenda Automática: Envio diário (16:20) e semanal (domingos) de agenda para grupos de trabalho
Notificações de Eventos: Lembretes 30 minutos antes para participantes confirmados

📊 Gestão Organizacional e Transparência

/pauta - Criação e gestão de pautas de reuniões com templates automáticos
/demanda - Sistema completo de gestão de demandas internas com rastreamento
/pedido_de_informacao - Sistema avançado de gestão de pedidos de informação pública com:
- Scraping automático de portais governamentais
- Monitoramento de prazos e status
- Notificações de respostas e recursos
- Workflow completo de acompanhamento
/resumo - Gera resumos executivos de atividades
/denuncia - Sistema de registro e acompanhamento de denúncias

🔧 Utilitários e Ferramentas

/enquete - Cria enquetes interativas no Telegram
/qrcode - Gera códigos QR para links e textos
/testar_rotinas - Executa testes dos schedulers e rotinas automáticas
/ajuda - Sistema de ajuda contextual com IA para encontrar comandos
/versao - Controle de versão e changelog do bot
/quem_sou_eu - Perfil do usuário, permissões e cadastro de email
/start - Inicialização do bot com lista completa de comandos

🛠️ Stack Tecnológica

Core

Node.js 22 - Runtime JavaScript com suporte às últimas funcionalidades
TypeScript 5.7 - Linguagem tipada para maior robustez e manutenibilidade
Telegraf.js 4.10 - Framework moderno para bots do Telegram
ESLint + Google Config - Padronização de código

Cloud & Serverless

Firebase Functions - Computação serverless para escalabilidade automática
Firebase Admin SDK 13.0 - Gerenciamento de dados e autenticação
Firebase Realtime Database - Banco de dados em tempo real para workflows
Google Cloud Run - Hospedagem de funções serverless

Integrações Google

Google Drive API - Armazenamento e organização de arquivos
Google Sheets API - Manipulação de planilhas e relatórios
Google Calendar API - Gestão de eventos e agendas
Google Docs API - Criação e edição de documentos
Google Slides API - Apresentações automatizadas
Google Forms API - Formulários dinâmicos
Google APIs Client 144.0 - Cliente unificado para APIs Google

Integrações Azure AI

Azure OpenAI (GPT-3.5) - Processamento de linguagem natural
Azure Whisper - Transcrição de áudio e vídeo
Azure Cognitive Services - Serviços de IA

Bibliotecas Especializadas

PDF-lib 1.17 - Manipulação avançada de PDFs
pdf-parse 1.1 - Extração de texto de PDFs
csv-parse 5.6 - Processamento de arquivos CSV
cheerio 1.1 - Web scraping e parsing HTML
axios 1.8 - Cliente HTTP robusto
form-data 4.0 - Upload de arquivos multipart
qrcode 1.5 - Geração de códigos QR
dotenv 16.4 - Gerenciamento de variáveis de ambiente

🏗️ Arquitetura do Sistema

Estrutura Modular

functions/src/
├── commands/          # 20 comandos ativos do bot
├── callbacks/         # 12 handlers de callbacks inline
├── handlers/          # 2 handlers especializados (pagamentos e eventos)
├── services/          # 6 integrações externas (Google, Azure, Firebase)
├── scheduler/         # 7 tarefas agendadas (cron jobs)
├── utils/             # Utilitários e helpers
├── config/            # Configurações e tipos
├── credentials/       # Configurações de APIs (não versionadas)
└── messages/          # Templates de mensagens

Fluxos Principais

1. Fluxo de Pagamentos (Desativado - Migrado para Central Ameciclista)

Usuário → Central Ameciclista → Validação → Aprovação → Planilha → Arquivo

2. Gestão de Eventos com IA

Texto Natural → IA (GPT-3.5) → Extração de Dados → Google Calendar → Notificações → Lembretes

3. Processamento de Documentos Inteligente

Upload → Processamento/OCR → Categorização → Google Drive → Notificação

4. Sistema de Pedidos de Informação

Criação → Scraping Portal → Monitoramento → Notificação → Recurso/Aceitação

5. Assistente Financeiro Unificado

Comando → Detecção de Contexto → Seleção de Ação → Processamento → Resultado

Tarefas Agendadas (Schedulers)

Formulários: Verifica novas respostas a cada 2 horas e notifica grupos responsáveis
Pagamentos Agendados: Monitora pagamentos bancários agendados (seg/qua/sex às 8h)
Agenda de Eventos: Envia agenda diária (16:20) e semanal (domingos) para grupos de trabalho
Pedidos de Informação: Verifica status e prazos diariamente (19h) com scraping automático
Eventos Próximos: Notifica participantes 30 minutos antes dos eventos
Relatório Semanal: Envia relatório de atividades às segundas-feiras (8h)
Lembretes de Demandas: Sistema de notificações para demandas pendentes

📦 Instalação e Configuração

Pré-requisitos

Node.js 22+
Firebase CLI
Conta Google Cloud com APIs habilitadas
Conta Azure com serviços de IA
Bot do Telegram criado via @BotFather

1. Clone e Instale

git clone <repository-url>
cd ameciclobot
cd functions
npm install

2. Configure Firebase

firebase login
firebase use --add
# Selecione seu projeto Firebase

3. Configure Variáveis de Ambiente

Crie o arquivo .env em functions/:

# Telegram
BOT_TOKEN=seu_token_do_telegram_bot
DEV_BOT_TOKEN=token_do_bot_de_desenvolvimento

# Firebase
FB_BOTFUNCTION_URL=https://sua-funcao.cloudfunctions.net
API_KEY=sua_api_key_firebase
FB_PROJECT_ID=seu-projeto-firebase
FB_PRIVATE_KEY_ID=id_da_chave_privada
FB_CLIENT_EMAIL=email_do_service_account
FB_CLIENT_ID=id_do_cliente
FB_CLIENT_X509_CERT_URL=url_do_certificado
FB_CLIENT_SECRET=secret_do_cliente

# Desenvolvimento
DEV_MODE=false

4. Configure Credenciais

Crie os arquivos JSON em functions/src/credentials/:

`telegram.json`

{
  "token": "seu_token_do_bot",
  "devToken": "token_de_desenvolvimento"
}

`google.json`

{
  "type": "service_account",
  "project_id": "seu-projeto",
  "private_key_id": "id-da-chave",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...",
  "client_email": "bot@projeto.iam.gserviceaccount.com",
  "client_id": "123456789",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token"
}

`gpt35.json`

{
  "endpoint": "https://seu-recurso.openai.azure.com/",
  "apiKey": "sua-chave-azure-openai"
}

`whisper.json`

{
  "endpoint": "https://seu-whisper.cognitiveservices.azure.com/",
  "apiKey": "sua-chave-whisper"
}

`workgroupsfolders.json`

[
  {
    "label": "Secretaria",
    "value": -123456789,
    "folderId": "id-da-pasta-drive"
  },
  {
    "label": "Financeiro",
    "value": -987654321,
    "folderId": "id-da-pasta-drive"
  }
]

`calendars.json`

{
  "primary": "calendario@ameciclo.org",
  "events": "eventos@ameciclo.org"
}

🚀 Desenvolvimento

Scripts disponíveis:

# Compilar TypeScript
npm run build

# Executar em modo de desenvolvimento
npm run serve

# Assistir mudanças (recompilação automática)
npm run watch

# Deploy para produção
npm run deploy

# Executar linter (ESLint)
npm run lint

# Ver logs do Firebase Functions
npm run logs

# Executar testes
npm test

# Testar pedidos de informação
npm run test:pedidos

Estrutura do projeto:

ameciclobot/
├── functions/
│   ├── src/
│   │   ├── commands/          # 20 comandos ativos do bot
│   │   ├── callbacks/         # 12 handlers de callbacks inline
│   │   ├── handlers/          # 2 handlers especializados
│   │   ├── services/          # 6 integrações (Google, Azure, Firebase)
│   │   ├── scheduler/         # 7 tarefas agendadas (cron jobs)
│   │   ├── utils/             # Utilitários e helpers
│   │   ├── config/            # Configurações e tipos
│   │   ├── credentials/       # Arquivos de credenciais (não versionados)
│   │   ├── messages/          # Templates de mensagens
│   │   ├── test/              # Testes unitários
│   │   ├── commands.ts        # Registro de comandos
│   │   └── index.ts           # Ponto de entrada principal
│   ├── lib/                   # Código TypeScript compilado
│   ├── .env                   # Variáveis de ambiente
│   ├── package.json           # Dependências e scripts
│   ├── tsconfig.json          # Configuração TypeScript
│   └── eslint.config.js       # Configuração ESLint
├── .github/workflows/         # CI/CD GitHub Actions
├── firebase.json              # Configuração Firebase
├── .firebaserc                # Projetos Firebase
└── README.md                  # Documentação

## 🔧 Configuração Detalhada

### 5. Configure Google Cloud APIs

1. **Acesse o Google Cloud Console**:
   - Crie um novo projeto ou use existente
   - Ative as seguintes APIs:
     - Google Drive API
     - Google Sheets API
     - Google Calendar API
     - Google Docs API
     - Google Slides API
     - Google Forms API

2. **Crie Service Account**:
   ```bash
   # Via gcloud CLI
   gcloud iam service-accounts create ameciclo-bot \
     --display-name="Ameciclo Bot Service Account"
   
   # Gere chave JSON
   gcloud iam service-accounts keys create google.json \
     --iam-account=ameciclo-bot@seu-projeto.iam.gserviceaccount.com

Configure Domain-wide Delegation:

No Google Admin Console
Adicione o Client ID do service account

Escopos necessários:

https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/presentations
https://www.googleapis.com/auth/forms

6. Configure Azure AI Services

Azure OpenAI:

# Crie recurso via Azure CLI
az cognitiveservices account create \
  --name ameciclo-openai \
  --resource-group ameciclo-rg \
  --kind OpenAI \
  --sku S0 \
  --location eastus

# Deploy modelo GPT-3.5-turbo
az cognitiveservices account deployment create \
  --name ameciclo-openai \
  --resource-group ameciclo-rg \
  --deployment-name gpt-35-turbo \
  --model-name gpt-35-turbo \
  --model-version "0613"

Azure Speech Services (Whisper):

az cognitiveservices account create \
  --name ameciclo-speech \
  --resource-group ameciclo-rg \
  --kind SpeechServices \
  --sku S0 \
  --location eastus

7. Configure Firebase

Estrutura do Realtime Database:

{
  "requests": {
    "request_id": {
      "status": "pending|confirmed|cancelled",
      "transactionType": "string",
      "project": { "name": "string", "id": "string" },
      "supplier": { "name": "string", "nickname": "string" },
      "value": "number",
      "paymentDate": "string",
      "createdAt": "timestamp"
    }
  },
  "calendar": {
    "event_id": {
      "title": "string",
      "date": "string",
      "workgroup": "string",
      "participants": ["user_ids"]
    }
  },
  "forms": {
    "form_id": {
      "sheetId": "string",
      "telegramGroupId": "number",
      "lastRow": "number",
      "responsesTabGid": "string",
      "formName": "string"
    }
  },
  "users": {
    "user_id": {
      "name": "string",
      "username": "string",
      "workgroup": "string",
      "permissions": ["array"]
    }
  },
  "informationRequests": {
    "request_id": {
      "title": "string",
      "entity": "string",
      "deadline": "string",
      "status": "pending|sent|received|expired"
    }
  }
}

Regras de Segurança:

{
  "rules": {
    ".read": "auth != null",
    ".write": "auth != null",
    "requests": {
      ".indexOn": ["status", "transactionType", "paymentDate"]
    },
    "calendar": {
      ".indexOn": ["date", "workgroup"]
    }
  }
}

8. Deploy e Testes

Deploy Inicial:

# Compile o projeto
npm run build

# Deploy para Firebase
npm run deploy

# Verifique os logs
npm run logs

Teste Local:

# Inicie emuladores Firebase
npm run serve

# Em outro terminal, teste comandos
npm run test:pedidos

Configuração do Webhook:

# Configure webhook do Telegram
curl -X POST "https://api.telegram.org/bot<BOT_TOKEN>/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://sua-funcao.cloudfunctions.net/botFunction"}'

9. Configuração de Schedulers

Os schedulers são configurados automaticamente no deploy. Para ajustar horários:

// Em functions/src/index.ts
export const scheduledCheckEvents = functions
  .region('us-central1')
  .pubsub
  .schedule('20 16 * * *') // Diário às 16:20
  .timeZone('America/Recife')
  .onRun(async (context) => {
    await checkEvents(bot);
  });

10. Monitoramento e Logs

Firebase Console: Monitore execuções e erros
Google Cloud Logging: Logs detalhados
Telegram: Notificações de erro em grupos administrativos

# Ver logs em tempo real
firebase functions:log --follow

# Filtrar logs por função
firebase functions:log --only functions:botFunction

📊 Estatísticas do Projeto Atual

Versão: 3.0.0
20 Comandos ativos implementados
12 Callbacks para interações inline avançadas
7 Schedulers para automações completas
6 Integrações principais (Google APIs, Azure AI, Firebase)
2 Handlers especializados (pagamentos e eventos)
6 Serviços externos especializados
15+ Tipos de documentos suportados
Múltiplos grupos de trabalho gerenciados
Processamento em tempo real de solicitações
Backup automático e sincronização contínua
IA Integrada para processamento de linguagem natural
Scraping Automático de portais governamentais
Sistema de Notificações inteligente e contextual

📊 Recursos Avançados e Inteligência Artificial

🤖 Processamento de Linguagem Natural

Extração Automática de Eventos: Converte texto livre em eventos estruturados do Google Calendar
Sistema de Ajuda Inteligente: IA identifica comandos baseado em descrições naturais
Processamento de Documentos: OCR e análise inteligente de PDFs e extratos bancários
Geração de Conteúdo: Criação automática de documentos, apresentações e formulários

🔍 Automação e Scraping

Monitoramento de Portais: Scraping automático de sites governamentais para pedidos de informação
Reconciliação Bancária: Matching automático entre extratos e planilhas financeiras
Detecção de Contexto: O assistente financeiro identifica automaticamente o tipo de arquivo e ação necessária
Notificações Inteligentes: Alertas contextuais baseados em prazos, eventos e status

📈 Monitoramento e Relatórios

Health Checks: Verificação automática de APIs e serviços
Métricas de Uso: Acompanhamento de comandos mais utilizados e performance
Relatórios Automáticos: Geração semanal de relatórios de atividades
Auditoria Completa: Log de todas as ações sensíveis com timestamp e usuário

🔄 Workflows Automatizados

Sistema de Aprovação: Workflow completo para pagamentos com notificações
Gestão de Demandas: Rastreamento automático com lembretes e atualizações
Backup Automático: Sincronização contínua com Google Drive e Firebase
Agenda Inteligente: Distribuição automática de eventos por grupos de trabalho

📝 Guia de Uso Detalhado

Primeiros Passos

Configuração Inicial:
- Adicione o bot aos grupos de trabalho da Ameciclo
- Configure permissões de administrador
- Execute /start para inicializar

Comandos Básicos:

/ajuda - Lista todos os comandos disponíveis com IA
/versao - Versão atual e changelog
/quem_sou_eu - Suas informações e permissões

Fluxos de Trabalho Principais

💰 Gestão Financeira Unificada

1. /ajudante_financeiro
2. Responda a um arquivo (PDF/CSV) ou use sem arquivo
3. Selecione a ação desejada no menu interativo
4. Acompanhe o processamento automático

Ações disponíveis:

Arquivar Comprovante: /ajudante_financeiro [id_transacao] (respondendo a arquivo)
Recibo de Ressarcimento: /ajudante_financeiro [id_ressarcimento] (respondendo a PDF)
Arquivar Extrato PDF: Detecta automaticamente extratos bancários
Processar Extrato CSV: Reconciliação automática com planilhas
Atualizar Pendências: Monitora status de projetos
Atualizar Projetos: Sincroniza dados no Firebase

📅 Criação de Eventos com IA

1. /evento Reunião da diretoria amanhã às 14h na sede
2. IA extrai dados automaticamente (data, hora, local)
3. Confirme os detalhes extraídos
4. Evento criado no Google Calendar
5. Atribuição automática ou manual a grupos

📄 Gestão de Documentos

1. /documento Ata da Reunião de Janeiro
2. Google Docs criado automaticamente
3. Escolha a pasta de destino
4. Arquivo movido e link compartilhado

Outros comandos de documentos:

/apresentacao - Google Slides
/planilha - Google Sheets
/formulario - Google Forms com monitoramento
/modelo - Clona documentos de templates

📊 Pedidos de Informação Pública

1. /pedido_de_informacao
2. Preencha os dados do pedido
3. Sistema faz scraping automático do portal
4. Monitoramento diário de status
5. Notificações de respostas e prazos
6. Opção de recurso automático

📋 Gestão de Demandas

1. /demanda
2. Descreva a demanda e prazo
3. Sistema cria rastreamento automático
4. Lembretes periódicos
5. Atualizações de status

Grupos de Trabalho

O bot reconhece diferentes grupos de trabalho:

Secretaria - Gestão geral e administrativa
Financeiro - Controle financeiro e pagamentos (restrições especiais)
Captação - Captação de recursos e parcerias
Advocacy - Ações de advocacy e políticas públicas
Comunicação - Marketing e comunicação

Permissões e Segurança

Comandos financeiros restritos ao grupo Financeiro
Validação de grupos para comandos sensíveis
Log completo de todas as ações
Backup automático de dados importantes
Sistema de aprovação para pagamentos

Automações Ativas

Diárias:

16:20 - Agenda do dia seguinte para cada grupo
19:00 - Verificação de pedidos de informação
A cada 30min - Lembretes de eventos próximos

Semanais:

Domingos - Agenda semanal completa
Segundas 8h - Relatório semanal de atividades

Periódicas:

A cada 2h - Verificação de formulários
Seg/Qua/Sex 8h - Pagamentos agendados

🔄 Recursos Avançados

Inteligência Artificial

Processamento de Linguagem Natural: Extração automática de dados de eventos a partir de texto livre
Transcrição Automática: Conversão de áudios e vídeos em texto usando Azure Whisper
Análise de Documentos: Processamento inteligente de PDFs e extratos bancários

Automações

Reconciliação Bancária: Matching automático entre extratos e planilhas
Notificações Inteligentes: Alertas contextuais baseados em prazos e eventos
Backup Automático: Sincronização contínua com Google Drive
Relatórios Automáticos: Geração de relatórios financeiros e de atividades

Monitoramento

Health Checks: Verificação automática de APIs e serviços
Logs Estruturados: Sistema completo de logging para debugging
Métricas de Uso: Acompanhamento de comandos mais utilizados
Error Tracking: Captura e notificação de erros em tempo real

🤝 Contribuição e Desenvolvimento

Como Contribuir

Fork e Clone:

git clone https://github.com/seu-usuario/ameciclobot.git
cd ameciclobot

Configuração de Desenvolvimento:

cd functions
npm install
cp .env.example .env
# Configure suas variáveis de ambiente

Desenvolvimento:

npm run watch  # Compilação automática
npm run serve  # Servidor local

Testes:

npm run lint   # Verificação de código
npm test       # Testes unitários

Deploy:
```
npm run deploy # Deploy para produção
```

Padrões de Código

TypeScript obrigatório para type safety
ESLint configurado com regras do Google
Prettier para formatação consistente
Conventional Commits para mensagens de commit
Documentação JSDoc para funções públicas

Estrutura de Comandos

Todos os comandos seguem o padrão:

export const nomeCommand = {
  register: (bot: Telegraf) => void,
  name: () => string,
  description: () => string,
  help: () => string
};

📋 Roadmap e Melhorias

Em Desenvolvimento

Interface web para administração
API REST para integrações externas
Sistema de plugins para comandos customizados
Dashboard de métricas e analytics
Integração com WhatsApp Business

Melhorias Planejadas

Cache inteligente para melhor performance
Sistema de backup incremental
Notificações push personalizadas
Integração com sistemas de terceiros
Modo offline para comandos críticos

🔒 Segurança e Privacidade

Criptografia: Todas as comunicações são criptografadas
Controle de Acesso: Sistema de permissões por grupo e usuário
Auditoria: Log completo de todas as ações sensíveis
Backup Seguro: Dados armazenados com redundância
Compliance: Adequação à LGPD e boas práticas de segurança

🆘 Suporte e Documentação

Canais de Suporte

Issues GitHub: Para bugs e solicitações de features
Documentação: Wiki completa no repositório
Telegram: Grupo de suporte técnico interno
Email: Contato direto com a equipe de desenvolvimento

Recursos Adicionais

📄 Licença e Créditos

Este projeto está sob a licença AGPL-3.0. Veja o arquivo LICENSE para mais detalhes.

IMPORTANTE: Este software é licenciado sob a GNU Affero General Public License v3.0 (AGPL-3.0). Isso significa que:

✅ Você pode usar, modificar e distribuir este software livremente
✅ Você pode usar este software para fins comerciais
⚠️ Se você executar este software em um servidor e oferecer acesso via rede, deve disponibilizar o código fonte completo
⚠️ Qualquer modificação deve ser disponibilizada sob a mesma licença AGPL-3.0
⚠️ Deve incluir aviso de copyright e licença em todas as cópias

Para mais informações sobre a licença AGPL-3.0, visite: https://www.gnu.org/licenses/agpl-3.0.html

Tecnologias Utilizadas

Telegraf.js - Framework para bots Telegram
Firebase - Plataforma de desenvolvimento
Google APIs - Integrações Google
Azure AI - Serviços de IA
PDF-lib - Manipulação de PDFs

🔒 Segurança e Compliance

Criptografia: Todas as comunicações são criptografadas via HTTPS/TLS
Controle de Acesso: Sistema de permissões granular por grupo e usuário
Auditoria: Log completo de todas as ações sensíveis com rastreabilidade
Backup Seguro: Dados armazenados com redundância no Firebase e Google Drive
Compliance: Adequação à LGPD e boas práticas de segurança
Validação de Entrada: Sanitização e validação de todos os inputs do usuário
Rate Limiting: Proteção contra spam e uso abusivo

🌐 Integrações Externas

APIs Google (6 integrações)

Google Drive: Armazenamento e organização hierárquica de arquivos
Google Sheets: Manipulação avançada de planilhas com fórmulas
Google Calendar: Gestão completa de eventos com recorrência
Google Docs: Criação e edição colaborativa de documentos
Google Slides: Apresentações automatizadas com templates
Google Forms: Formulários dinâmicos com monitoramento de respostas

Azure AI Services (2 integrações)

Azure OpenAI GPT-3.5: Processamento de linguagem natural avançado
Azure Whisper: Transcrição de áudio/vídeo com alta precisão

Firebase (3 serviços)

Firebase Functions: Computação serverless escalável
Firebase Realtime Database: Banco de dados em tempo real
Firebase Admin SDK: Gerenciamento de autenticação e dados

📝 Documentação Adicional

ANALISE_MELHORIAS.md - Análise detalhada de melhorias
PADRONIZACAO_COMANDOS.md - Padrões de desenvolvimento
PLANO_UNIFORMIZACAO_COMANDOS.md - Plano de uniformização
.github/workflows/deploy.yml - Pipeline CI/CD

🔄 Roadmap e Melhorias

Em Desenvolvimento

Interface web administrativa completa
API REST pública para integrações externas
Sistema de plugins para comandos customizados
Dashboard de métricas e analytics em tempo real
Integração com WhatsApp Business API
Expansão do sistema de scraping para mais portais

Melhorias Planejadas

Cache inteligente Redis para melhor performance
Sistema de backup incremental automatizado
Notificações push personalizadas por usuário
Integração com sistemas ERP de terceiros
Modo offline para comandos críticos
Machine Learning para predição de demandas
Sistema de aprovação multi-nível
Relatórios avançados com gráficos

Versão atual: 3.0.0 | Última atualização: Dezembro 2024

Desenvolvido com ❤️ para a Ameciclo - Promovendo a mobilidade sustentável no Grande Recife

Este bot é uma ferramenta open-source desenvolvida para otimizar os processos internos da Ameciclo e pode ser adaptado para outras organizações da sociedade civil.

📞 Suporte e Contato

Issues GitHub: Reportar bugs e solicitar features
Telegram: @ameciclo_info
Email: contato@ameciclo.org
Site: ameciclo.org

📜 Licença

Este projeto está licenciado sob a GNU Affero General Public License v3.0 (AGPL-3.0).

Para mais informações, consulte o arquivo LICENSE ou visite: https://www.gnu.org/licenses/agpl-3.0.html

Name		Name	Last commit message	Last commit date
Latest commit History 317 Commits
.github/workflows		.github/workflows
functions		functions
.gitignore		.gitignore
ESTUDO_MIGRACAO_PASTAS.md		ESTUDO_MIGRACAO_PASTAS.md
LICENSE		LICENSE
README.md		README.md
ameciclo-admin-bot-sales-export.json		ameciclo-admin-bot-sales-export.json
firebase.json		firebase.json
fluxos-comandos-bot.md		fluxos-comandos-bot.md
package-lock.json		package-lock.json
package.json		package.json
run.sh		run.sh

Folders and files

Latest commit

History

Repository files navigation

🚴 Ameciclo Bot

🎯 Sobre a Ameciclo

🚀 Funcionalidades Principais

📄 Gestão de Documentos e Arquivos

💰 Gestão Financeira Avançada

📅 Eventos e Comunicação

📊 Gestão Organizacional e Transparência

🔧 Utilitários e Ferramentas

🛠️ Stack Tecnológica

Core

Cloud & Serverless

Integrações Google

Integrações Azure AI

Bibliotecas Especializadas

🏗️ Arquitetura do Sistema

Estrutura Modular

Fluxos Principais

1. Fluxo de Pagamentos (Desativado - Migrado para Central Ameciclista)

2. Gestão de Eventos com IA

3. Processamento de Documentos Inteligente

4. Sistema de Pedidos de Informação

5. Assistente Financeiro Unificado

Tarefas Agendadas (Schedulers)

📦 Instalação e Configuração

Pré-requisitos

1. Clone e Instale

2. Configure Firebase

3. Configure Variáveis de Ambiente

4. Configure Credenciais

telegram.json

google.json

gpt35.json

whisper.json

workgroupsfolders.json

calendars.json

🚀 Desenvolvimento

Scripts disponíveis:

Estrutura do projeto:

6. Configure Azure AI Services

7. Configure Firebase

8. Deploy e Testes

9. Configuração de Schedulers

10. Monitoramento e Logs

📊 Estatísticas do Projeto Atual

📊 Recursos Avançados e Inteligência Artificial

🤖 Processamento de Linguagem Natural

🔍 Automação e Scraping

📈 Monitoramento e Relatórios

🔄 Workflows Automatizados

📝 Guia de Uso Detalhado

Primeiros Passos

Fluxos de Trabalho Principais

💰 Gestão Financeira Unificada

📅 Criação de Eventos com IA

📄 Gestão de Documentos

📊 Pedidos de Informação Pública

📋 Gestão de Demandas

Grupos de Trabalho

Permissões e Segurança

Automações Ativas

🔄 Recursos Avançados

Inteligência Artificial

Automações

Monitoramento

🤝 Contribuição e Desenvolvimento

Como Contribuir

Padrões de Código

Estrutura de Comandos

📋 Roadmap e Melhorias

Em Desenvolvimento

Melhorias Planejadas

🔒 Segurança e Privacidade

🆘 Suporte e Documentação

Canais de Suporte

Recursos Adicionais

📄 Licença e Créditos

`telegram.json`

`google.json`

`gpt35.json`

`whisper.json`

`workgroupsfolders.json`

`calendars.json`

Packages