@greatapps/greatagents 0.0.1 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@greatapps/greatagents",
-  "version": "0.0.1",
+  "version": "0.1.1",
   "description": "Schemas para GreatAgents",
   "main": "./src/product.js",
   "type": "module"

package/scripts/README.md

@@ -0,0 +1,272 @@
+# Scripts PostgreSQL - GreatAgents
+
+Sistema de scripts SQL para criação e manutenção do banco de dados PostgreSQL do projeto GreatAgents.
+
+## Introdução
+
+O **gagents-schemas** é um sistema de definição e implementação de esquemas de banco de dados para o GreatAgents. O sistema funciona em duas camadas complementares:
+
+- **Schemas JavaScript** (`src/modules/`): Definem a estrutura canônica dos dados, propriedades, validações e interfaces
+- **Scripts SQL** (`scripts/`): Implementam essas estruturas no PostgreSQL com comandos DDL otimizados
+
+Os scripts SQL são gerados e mantidos em sincronia com os schemas JavaScript, garantindo consistência entre a definição lógica dos dados e sua implementação física no banco.
+
+### Propósito
+
+Este diretório contém scripts SQL PostgreSQL prontos para produção que criam todas as tabelas necessárias para o funcionamento do sistema GreatAgents, incluindo índices otimizados, comentários de documentação e referências de integridade.
+
+## Arquitetura do Sistema
+
+### Schemas JavaScript como Fonte da Verdade
+
+Os schemas JavaScript em [`src/modules/`](../src/modules/) definem:
+- Estrutura dos dados e tipos de campos
+- Validações e restrições
+- Relacionamentos entre entidades
+- Configurações de cache e parâmetros
+- Interfaces de usuário e labels
+
+### Scripts SQL como Implementação
+
+Os scripts SQL em [`scripts/`](.) implementam:
+- Comandos `CREATE TABLE` com tipos PostgreSQL correspondentes
+- Índices otimizados para consultas frequentes
+- Chaves estrangeiras e integridade referencial
+- Comentários detalhados de documentação
+- Execução segura com `CREATE IF NOT EXISTS`
+
+### Sincronização
+
+A relação entre os módulos garante que:
+- Cada schema JavaScript tem um script SQL correspondente
+- Os tipos de dados são consistentes entre as duas representações
+- As modificações nos schemas refletem automaticamente nos scripts
+- A estrutura permanece sincronizada em todas as camadas
+
+## Estrutura dos Dados
+
+O sistema GreatAgents é organizado em **17 módulos** distribuídos em duas categorias:
+
+### Módulos Principais (13)
+
+| Módulo | Descrição | Dependências |
+|--------|-----------|--------------|
+| [`accounts`](accounts/) | Contas/organizações do sistema | - |
+| [`agents`](agents/) | Agentes de IA e suas configurações | accounts |
+| [`channels`](channels/) | Canais de comunicação (WhatsApp, Telegram, etc.) | accounts, credentials |
+| [`companies`](companies/) | Empresas dos leads | - |
+| [`conversations`](conversations/) | Conversas entre usuários e agentes | accounts, agents, leads_channels |
+| [`credentials`](credentials/) | Credenciais de autenticação para integrações | accounts |
+| [`leads`](leads/) | Leads/contatos do sistema | accounts, companies |
+| [`messages`](messages/) | Mensagens das conversas | accounts, conversations |
+| [`missions`](missions/) | Missões/tarefas complexas dos agentes | accounts, agents |
+| [`objectives`](objectives/) | Objetivos específicos dentro das missões | accounts, agents, missions |
+| [`tags`](tags/) | Sistema de tags para categorização | accounts |
+| [`tools`](tools/) | Ferramentas disponíveis para os agentes | accounts, credentials |
+| [`users`](users/) | Usuários do sistema | accounts |
+
+### Tabelas de Relacionamento (4)
+
+| Módulo | Descrição | Relaciona |
+|--------|-----------|-----------|
+| [`conversations_tags`](conversations_tags/) | Tags das conversas | conversations ↔ tags |
+| [`leads_channels`](leads_channels/) | Canais dos leads | leads ↔ channels |
+| [`leads_tags`](leads_tags/) | Tags dos leads | leads ↔ tags |
+| [`objectives_tools`](objectives_tools/) | Ferramentas dos objetivos | objectives ↔ tools |
+
+### Categorização Funcional
+
+**Núcleo do Sistema:**
+- `accounts` - Base organizacional
+- `users` - Gestão de usuários
+- `credentials` - Autenticação
+
+**Agentes e IA:**
+- `agents` - Agentes de IA
+- `missions` - Tarefas complexas
+- `objectives` - Objetivos específicos
+- `tools` - Ferramentas disponíveis
+
+**Comunicação:**
+- `channels` - Canais de comunicação
+- `conversations` - Conversas
+- `messages` - Mensagens
+
+**Gestão de Leads:**
+- `leads` - Contatos
+- `companies` - Empresas
+- `leads_channels` - Associações lead-canal
+
+**Organização:**
+- `tags` - Sistema de categorização
+- `conversations_tags` - Tags de conversas
+- `leads_tags` - Tags de leads
+
+## Como Usar
+
+### Pré-requisitos
+
+- PostgreSQL 12 ou superior
+- Permissões para criação de tabelas e índices
+- Cliente `psql` ou ferramenta equivalente
+
+### Instalação Rápida
+
+Execute todos os scripts de uma vez:
+
+```bash
+# Navegar para o diretório de scripts
+cd gagents-schemas/scripts
+
+# Executar todos os 17 scripts
+for module in accounts agents channels companies conversations conversations_tags credentials leads leads_channels leads_tags messages missions objectives objectives_tools tags tools users; do
+    echo "Criando tabela: $module"
+    psql -d sua_base_dados -f "$module/create_table.sql"
+done
+```
+
+### Instalação Respeitando Dependências
+
+Para uma nova instalação, execute na ordem recomendada:
+
+```bash
+# 1. Tabelas base (sem dependências)
+psql -d sua_base_dados -f accounts/create_table.sql
+psql -d sua_base_dados -f tags/create_table.sql
+psql -d sua_base_dados -f companies/create_table.sql
+
+# 2. Tabelas dependentes de accounts
+psql -d sua_base_dados -f users/create_table.sql
+psql -d sua_base_dados -f credentials/create_table.sql
+psql -d sua_base_dados -f agents/create_table.sql
+psql -d sua_base_dados -f leads/create_table.sql
+
+# 3. Tabelas com múltiplas dependências
+psql -d sua_base_dados -f tools/create_table.sql
+psql -d sua_base_dados -f channels/create_table.sql
+psql -d sua_base_dados -f missions/create_table.sql
+psql -d sua_base_dados -f leads_channels/create_table.sql
+
+# 4. Tabelas de nível superior
+psql -d sua_base_dados -f conversations/create_table.sql
+psql -d sua_base_dados -f messages/create_table.sql
+psql -d sua_base_dados -f objectives/create_table.sql
+
+# 5. Tabelas de relacionamento
+psql -d sua_base_dados -f conversations_tags/create_table.sql
+psql -d sua_base_dados -f leads_tags/create_table.sql
+psql -d sua_base_dados -f objectives_tools/create_table.sql
+```
+
+### Execução Individual
+
+Para executar scripts específicos:
+
+```bash
+# Exemplo: criar apenas a tabela de agentes
+psql -d sua_base_dados -f agents/create_table.sql
+
+# Exemplo: recriar múltiplas tabelas
+psql -d sua_base_dados -f accounts/create_table.sql
+psql -d sua_base_dados -f agents/create_table.sql
+psql -d sua_base_dados -f conversations/create_table.sql
+```
+
+### Verificação da Instalação
+
+Após a execução, verifique se todas as tabelas foram criadas:
+
+```sql
+-- Verificar contagem de tabelas criadas
+SELECT COUNT(*) as total_tabelas 
+FROM information_schema.tables 
+WHERE table_schema = 'public' 
+AND table_name IN (
+    'accounts', 'agents', 'channels', 'companies', 'conversations', 
+    'conversations_tags', 'credentials', 'leads', 'leads_channels', 
+    'leads_tags', 'messages', 'missions', 'objectives', 
+    'objectives_tools', 'tags', 'tools', 'users'
+);
+-- Resultado esperado: 17
+
+-- Verificar integridade referencial
+SELECT 
+    tc.table_name, 
+    kcu.column_name, 
+    ccu.table_name AS tabela_referenciada,
+    ccu.column_name AS coluna_referenciada 
+FROM information_schema.table_constraints AS tc 
+JOIN information_schema.key_column_usage AS kcu
+    ON tc.constraint_name = kcu.constraint_name
+JOIN information_schema.constraint_column_usage AS ccu
+    ON ccu.constraint_name = tc.constraint_name
+WHERE tc.constraint_type = 'FOREIGN KEY'
+ORDER BY tc.table_name;
+```
+
+## Informações Técnicas
+
+### Características dos Scripts
+
+**Execução Segura:**
+- Todos os scripts usam `CREATE IF NOT EXISTS`
+- Podem ser executados múltiplas vezes sem riscos
+- Não há perda de dados em re-execuções
+
+**Índices Automáticos:**
+- Todos os índices usam `CREATE INDEX IF NOT EXISTS`
+- Índices otimizados para consultas frequentes
+- Cobertura de chaves estrangeiras e campos de busca
+
+**Documentação Integrada:**
+- Comentários detalhados em todas as tabelas e colunas
+- Descrição do propósito de cada campo
+- Explicação de relacionamentos e dependências
+
+### Campos Automáticos Padrão
+
+Todas as tabelas incluem os seguintes campos automáticos:
+
+```sql
+id SERIAL PRIMARY KEY,                              -- Chave primária auto-incremento
+deleted BOOLEAN DEFAULT false NOT NULL,            -- Exclusão lógica
+datetime_add TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,  -- Data de criação
+datetime_alt TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,  -- Data de alteração
+datetime_del TIMESTAMP NULL                        -- Data de exclusão lógica
+```
+
+### Convenções de Nomenclatura
+
+**Tabelas:** Snake case no plural (`conversations`, `leads_tags`)  
+**Colunas:** Snake case no singular (`id_account`, `datetime_add`)  
+**Índices:** Prefixo `idx_` + nome da tabela + campo(s) (`idx_agents_id_account`)  
+**Chaves estrangeiras:** Prefixo `id_` + nome da tabela referenciada (`id_account`, `id_conversation`)
+
+### Tipos de Dados Utilizados
+
+| Tipo PostgreSQL | Uso | Exemplo |
+|------------------|-----|---------|
+| `SERIAL` | Chaves primárias auto-incremento | `id` |
+| `INTEGER` | Chaves estrangeiras e números | `id_account`, `verified` |
+| `VARCHAR(n)` | Textos com limite definido | `name VARCHAR(100)` |
+| `TEXT` | Textos longos sem limite | `prompt`, `content` |
+| `BOOLEAN` | Valores verdadeiro/falso | `deleted` |
+| `TIMESTAMP` | Datas e horários | `datetime_add` |
+
+### Relacionamentos e Integridade
+
+**Cascata de Exclusão:**
+- Configurada com `ON DELETE CASCADE` onde apropriado
+- Garante limpeza automática de registros dependentes
+
+**Restrições de Integridade:**
+- Todas as chaves estrangeiras são validadas
+- Campos obrigatórios definidos com `NOT NULL`
+- Valores padrão configurados onde aplicável
+
+### Compatibilidade
+
+**PostgreSQL:** 12, 13, 14, 15, 16+  
+**Encoding:** UTF-8  
+**Timezone:** Suporte completo a fusos horários  
+**Collation:** Compatível com diferentes locales

package/scripts/agents/create_table.sql

@@ -0,0 +1,46 @@
+-- =====================================================
+-- Script de criação da tabela AGENTS
+-- =====================================================
+-- Descrição: Tabela que armazena informações dos agentes de IA
+-- Dependências: accounts
+-- =====================================================
+
+-- Cria a tabela agents
+CREATE TABLE IF NOT EXISTS agents (
+    -- Propriedades automáticas (padrão para todas as tabelas)
+    id SERIAL PRIMARY KEY,
+    deleted BOOLEAN DEFAULT false NOT NULL,
+    datetime_add TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_alt TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_del TIMESTAMP NULL,
+    
+    -- Propriedades específicas da tabela agents
+    id_account INTEGER NOT NULL,
+    title VARCHAR(255) NOT NULL,
+    photo VARCHAR(255),
+    prompt TEXT,
+    llm_model VARCHAR(255),
+    delayTyping INTEGER DEFAULT 0 NOT NULL,
+    waitingTime INTEGER DEFAULT 0 NOT NULL
+);
+
+-- Cria índices para otimização de consultas
+CREATE INDEX IF NOT EXISTS idx_agents_deleted ON agents(deleted);
+CREATE INDEX IF NOT EXISTS idx_agents_id_account ON agents(id_account);
+CREATE INDEX IF NOT EXISTS idx_agents_title ON agents(title);
+CREATE INDEX IF NOT EXISTS idx_agents_llm_model ON agents(llm_model);
+
+-- Adiciona comentários para documentação
+COMMENT ON TABLE agents IS 'Tabela que armazena informações dos agentes de IA do sistema';
+COMMENT ON COLUMN agents.id IS 'Identificador único do agente (chave primária)';
+COMMENT ON COLUMN agents.deleted IS 'Flag indicando se o registro foi excluído logicamente';
+COMMENT ON COLUMN agents.datetime_add IS 'Data e hora de criação do registro';
+COMMENT ON COLUMN agents.datetime_alt IS 'Data e hora da última alteração do registro';
+COMMENT ON COLUMN agents.datetime_del IS 'Data e hora da exclusão lógica do registro';
+COMMENT ON COLUMN agents.id_account IS 'Referência para a conta proprietária do agente';
+COMMENT ON COLUMN agents.title IS 'Nome/título do agente';
+COMMENT ON COLUMN agents.photo IS 'URL ou caminho para a foto/avatar do agente';
+COMMENT ON COLUMN agents.prompt IS 'Prompt base/personalidade do agente para interações';
+COMMENT ON COLUMN agents.llm_model IS 'Modelo de linguagem utilizado pelo agente (referência para enum de modelos)';
+COMMENT ON COLUMN agents.delayTyping IS 'Delay em milissegundos para simular digitação humana';
+COMMENT ON COLUMN agents.waitingTime IS 'Tempo de espera em milissegundos antes de responder';

package/scripts/channels/create_table.sql

@@ -0,0 +1,48 @@
+-- =====================================================
+-- Script de criação da tabela CHANNELS
+-- =====================================================
+-- Descrição: Tabela que armazena informações dos canais de comunicação
+-- Dependências: accounts, credentials
+-- =====================================================
+
+-- Cria a tabela channels
+CREATE TABLE IF NOT EXISTS channels (
+    -- Propriedades automáticas (padrão para todas as tabelas)
+    id SERIAL PRIMARY KEY,
+    deleted BOOLEAN DEFAULT false NOT NULL,
+    datetime_add TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_alt TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_del TIMESTAMP NULL,
+    
+    -- Propriedades específicas da tabela channels
+    id_account INTEGER NOT NULL,
+    title VARCHAR(255) NOT NULL,
+    provider VARCHAR(50) NOT NULL DEFAULT 'web-chat',
+    url VARCHAR(255),
+    active BOOLEAN DEFAULT true NOT NULL,
+    id_credential INTEGER REFERENCES credentials(id) ON DELETE SET NULL,
+    handle VARCHAR(255)
+);
+
+-- Cria índices para otimização de consultas
+CREATE INDEX IF NOT EXISTS idx_channels_deleted ON channels(deleted);
+CREATE INDEX IF NOT EXISTS idx_channels_id_account ON channels(id_account);
+CREATE INDEX IF NOT EXISTS idx_channels_provider ON channels(provider);
+CREATE INDEX IF NOT EXISTS idx_channels_active ON channels(active);
+CREATE INDEX IF NOT EXISTS idx_channels_id_credential ON channels(id_credential);
+CREATE INDEX IF NOT EXISTS idx_channels_handle ON channels(handle);
+
+-- Adiciona comentários para documentação
+COMMENT ON TABLE channels IS 'Tabela que armazena informações dos canais de comunicação (WhatsApp, Telegram, etc.)';
+COMMENT ON COLUMN channels.id IS 'Identificador único do canal (chave primária)';
+COMMENT ON COLUMN channels.deleted IS 'Flag indicando se o registro foi excluído logicamente';
+COMMENT ON COLUMN channels.datetime_add IS 'Data e hora de criação do registro';
+COMMENT ON COLUMN channels.datetime_alt IS 'Data e hora da última alteração do registro';
+COMMENT ON COLUMN channels.datetime_del IS 'Data e hora da exclusão lógica do registro';
+COMMENT ON COLUMN channels.id_account IS 'Referência para a conta proprietária do canal';
+COMMENT ON COLUMN channels.title IS 'Nome/título do canal';
+COMMENT ON COLUMN channels.provider IS 'Tipo de provedor do canal (0=WhatsApp, 1=Telegram, 2=Discord, etc.)';
+COMMENT ON COLUMN channels.url IS 'URL de conexão ou webhook do canal';
+COMMENT ON COLUMN channels.active IS 'Flag indicando se o canal está ativo';
+COMMENT ON COLUMN channels.id_credential IS 'Referência para as credenciais de autenticação do canal';
+COMMENT ON COLUMN channels.handle IS 'Identificador único do canal no provedor (ex: número do WhatsApp, bot token, etc.)';

package/scripts/companies/create_table.sql

@@ -0,0 +1,49 @@
+-- =====================================================
+-- Script de criação da tabela COMPANIES
+-- =====================================================
+-- Descrição: Tabela que armazena informações das empresas associadas aos leads
+-- Dependências: accounts, leads
+-- =====================================================
+
+-- Cria a tabela companies
+CREATE TABLE IF NOT EXISTS companies (
+    -- Propriedades automáticas (padrão para todas as tabelas)
+    id SERIAL PRIMARY KEY,
+    deleted BOOLEAN DEFAULT false NOT NULL,
+    datetime_add TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_alt TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_del TIMESTAMP NULL,
+    
+    -- Propriedades específicas da tabela companies
+    id_account INTEGER NOT NULL,
+    id_lead INTEGER REFERENCES leads(id) ON DELETE CASCADE,
+    name VARCHAR(255),
+    domain VARCHAR(255),
+    notes TEXT,
+    industry VARCHAR(255),
+    size VARCHAR(255)
+);
+
+-- Cria índices para otimização de consultas
+CREATE INDEX IF NOT EXISTS idx_companies_deleted ON companies(deleted);
+CREATE INDEX IF NOT EXISTS idx_companies_id_account ON companies(id_account);
+CREATE INDEX IF NOT EXISTS idx_companies_id_lead ON companies(id_lead);
+CREATE INDEX IF NOT EXISTS idx_companies_name ON companies(name);
+CREATE INDEX IF NOT EXISTS idx_companies_domain ON companies(domain);
+CREATE INDEX IF NOT EXISTS idx_companies_industry ON companies(industry);
+CREATE INDEX IF NOT EXISTS idx_companies_size ON companies(size);
+
+-- Adiciona comentários para documentação
+COMMENT ON TABLE companies IS 'Tabela que armazena informações das empresas associadas aos leads';
+COMMENT ON COLUMN companies.id IS 'Identificador único da empresa (chave primária)';
+COMMENT ON COLUMN companies.deleted IS 'Flag indicando se o registro foi excluído logicamente';
+COMMENT ON COLUMN companies.datetime_add IS 'Data e hora de criação do registro';
+COMMENT ON COLUMN companies.datetime_alt IS 'Data e hora da última alteração do registro';
+COMMENT ON COLUMN companies.datetime_del IS 'Data e hora da exclusão lógica do registro';
+COMMENT ON COLUMN companies.id_account IS 'Referência para a conta proprietária da empresa';
+COMMENT ON COLUMN companies.id_lead IS 'Referência para o lead associado à empresa';
+COMMENT ON COLUMN companies.name IS 'Nome da empresa';
+COMMENT ON COLUMN companies.domain IS 'Domínio/website da empresa';
+COMMENT ON COLUMN companies.notes IS 'Notas e observações sobre a empresa';
+COMMENT ON COLUMN companies.industry IS 'Setor/indústria da empresa';
+COMMENT ON COLUMN companies.size IS 'Tamanho da empresa (pequena, média, grande, etc.)';

package/scripts/conversations/add_messages_reference.sql

@@ -0,0 +1,42 @@
+-- Script para conectar tabela conversations com tabela messages
+-- Adiciona campo id_last_message e cria foreign key constraint
+-- 
+-- Autor: Sistema GAgents
+-- Data: 2025-01-14
+-- Descrição: Conecta conversations com messages através do campo id_last_message
+
+-- =====================================================
+-- 1. Adicionar campo id_last_message na tabela conversations
+-- =====================================================
+-- Campo nullable para permitir conversas sem mensagens ainda
+ALTER TABLE conversations 
+ADD COLUMN IF NOT EXISTS id_last_message INTEGER;
+
+-- =====================================================
+-- 2. Criar foreign key constraint
+-- =====================================================
+-- Conecta conversations.id_last_message → messages.id
+-- ON DELETE SET NULL: se a mensagem for deletada, apenas remove a referência
+ALTER TABLE conversations 
+ADD CONSTRAINT IF NOT EXISTS fk_conversations_last_message 
+FOREIGN KEY (id_last_message) REFERENCES messages(id) ON DELETE SET NULL;
+
+-- =====================================================
+-- 3. Criar índice para otimização de consultas
+-- =====================================================
+-- Melhora performance em consultas que filtram por id_last_message
+CREATE INDEX IF NOT EXISTS idx_conversations_last_message 
+ON conversations(id_last_message);
+
+-- =====================================================
+-- Comentários sobre o uso:
+-- =====================================================
+-- Este campo permite:
+-- - Identificar rapidamente a última mensagem de uma conversa
+-- - Otimizar consultas de listagem de conversas com preview da última mensagem
+-- - Manter integridade referencial com comportamento seguro (SET NULL)
+-- 
+-- Exemplo de uso:
+-- SELECT c.*, m.content as last_message_content 
+-- FROM conversations c 
+-- LEFT JOIN messages m ON c.id_last_message = m.id;

package/scripts/conversations/create_table.sql

@@ -0,0 +1,55 @@
+-- =====================================================
+-- Script de criação da tabela CONVERSATIONS
+-- =====================================================
+-- Descrição: Tabela que armazena informações das conversas entre usuários e agentes
+-- Dependências: accounts, agents, channels
+-- =====================================================
+
+-- Cria a tabela conversations
+CREATE TABLE IF NOT EXISTS conversations (
+    -- Propriedades automáticas (padrão para todas as tabelas)
+    id SERIAL PRIMARY KEY,
+    deleted BOOLEAN DEFAULT false NOT NULL,
+    datetime_add TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_alt TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_del TIMESTAMP NULL,
+    
+    -- Propriedades específicas da tabela conversations
+    id_account INTEGER NOT NULL,
+    id_agent INTEGER REFERENCES agents(id) ON DELETE SET NULL,
+    id_channel INTEGER REFERENCES channels(id) ON DELETE SET NULL,
+    id_lead_channel INTEGER REFERENCES leads_channels(id) ON DELETE SET NULL,
+    id_assignee INTEGER,
+    last_message_at TIMESTAMP,
+    id_last_message INTEGER REFERENCES messages(id) ON DELETE SET NULL,
+    stop_ai BOOLEAN DEFAULT false NOT NULL,
+    status VARCHAR(20) DEFAULT 'open' NOT NULL
+);
+
+-- Cria índices para otimização de consultas
+CREATE INDEX IF NOT EXISTS idx_conversations_deleted ON conversations(deleted);
+CREATE INDEX IF NOT EXISTS idx_conversations_id_account ON conversations(id_account);
+CREATE INDEX IF NOT EXISTS idx_conversations_id_agent ON conversations(id_agent);
+CREATE INDEX IF NOT EXISTS idx_conversations_id_channel ON conversations(id_channel);
+CREATE INDEX IF NOT EXISTS idx_conversations_id_lead_channel ON conversations(id_lead_channel);
+CREATE INDEX IF NOT EXISTS idx_conversations_id_assignee ON conversations(id_assignee);
+CREATE INDEX IF NOT EXISTS idx_conversations_status ON conversations(status);
+CREATE INDEX IF NOT EXISTS idx_conversations_last_message_at ON conversations(last_message_at);
+CREATE INDEX IF NOT EXISTS idx_conversations_stop_ai ON conversations(stop_ai);
+
+-- Adiciona comentários para documentação
+COMMENT ON TABLE conversations IS 'Tabela que armazena informações das conversas entre usuários e agentes';
+COMMENT ON COLUMN conversations.id IS 'Identificador único da conversa (chave primária)';
+COMMENT ON COLUMN conversations.deleted IS 'Flag indicando se o registro foi excluído logicamente';
+COMMENT ON COLUMN conversations.datetime_add IS 'Data e hora de criação do registro';
+COMMENT ON COLUMN conversations.datetime_alt IS 'Data e hora da última alteração do registro';
+COMMENT ON COLUMN conversations.datetime_del IS 'Data e hora da exclusão lógica do registro';
+COMMENT ON COLUMN conversations.id_account IS 'Referência para a conta proprietária da conversa';
+COMMENT ON COLUMN conversations.id_agent IS 'Referência para o agente responsável pela conversa';
+COMMENT ON COLUMN conversations.id_channel IS 'Referência para o canal onde a conversa está acontecendo';
+COMMENT ON COLUMN conversations.id_lead_channel IS 'Identificador do lead/canal na conversa';
+COMMENT ON COLUMN conversations.id_assignee IS 'Identificador do usuário humano responsável pela conversa';
+COMMENT ON COLUMN conversations.last_message_at IS 'Data e hora da última mensagem na conversa';
+COMMENT ON COLUMN conversations.id_last_message IS 'Identificador da última mensagem na conversa';
+COMMENT ON COLUMN conversations.stop_ai IS 'Flag indicando se o agente de IA deve parar de responder automaticamente';
+COMMENT ON COLUMN conversations.status IS 'Status da conversa (open, closed, pending, etc.)';

package/scripts/conversations_tags/create_table.sql

@@ -0,0 +1,39 @@
+-- =====================================================
+-- Script de criação da tabela CONVERSATIONS_TAGS
+-- =====================================================
+-- Descrição: Tabela de relacionamento entre conversas e tags (many-to-many)
+-- Dependências: accounts, conversations, tags
+-- =====================================================
+
+-- Cria a tabela conversations_tags
+CREATE TABLE IF NOT EXISTS conversations_tags (
+    -- Propriedades automáticas (padrão para todas as tabelas)
+    id SERIAL PRIMARY KEY,
+    deleted BOOLEAN DEFAULT false NOT NULL,
+    datetime_add TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_alt TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_del TIMESTAMP NULL,
+    
+    -- Propriedades específicas da tabela conversations_tags
+    id_account INTEGER NOT NULL,
+    id_conversation INTEGER REFERENCES conversations(id) ON DELETE CASCADE,
+    id_tag INTEGER REFERENCES tags(id) ON DELETE CASCADE
+);
+
+-- Cria índices para otimização de consultas
+CREATE INDEX IF NOT EXISTS idx_conversations_tags_deleted ON conversations_tags(deleted);
+CREATE INDEX IF NOT EXISTS idx_conversations_tags_id_account ON conversations_tags(id_account);
+CREATE INDEX IF NOT EXISTS idx_conversations_tags_id_conversation ON conversations_tags(id_conversation);
+CREATE INDEX IF NOT EXISTS idx_conversations_tags_id_tag ON conversations_tags(id_tag);
+CREATE INDEX IF NOT EXISTS idx_conversations_tags_conversation_tag ON conversations_tags(id_conversation, id_tag);
+
+-- Adiciona comentários para documentação
+COMMENT ON TABLE conversations_tags IS 'Tabela de relacionamento entre conversas e tags para categorização';
+COMMENT ON COLUMN conversations_tags.id IS 'Identificador único do relacionamento conversa-tag (chave primária)';
+COMMENT ON COLUMN conversations_tags.deleted IS 'Flag indicando se o registro foi excluído logicamente';
+COMMENT ON COLUMN conversations_tags.datetime_add IS 'Data e hora de criação do registro';
+COMMENT ON COLUMN conversations_tags.datetime_alt IS 'Data e hora da última alteração do registro';
+COMMENT ON COLUMN conversations_tags.datetime_del IS 'Data e hora da exclusão lógica do registro';
+COMMENT ON COLUMN conversations_tags.id_account IS 'Referência para a conta proprietária do relacionamento';
+COMMENT ON COLUMN conversations_tags.id_conversation IS 'Referência para a conversa associada à tag';
+COMMENT ON COLUMN conversations_tags.id_tag IS 'Referência para a tag associada à conversa';

package/scripts/credentials/create_table.sql

@@ -0,0 +1,63 @@
+-- =====================================================
+-- Script de criação da tabela CREDENTIALS
+-- =====================================================
+-- Descrição: Tabela que armazena credenciais de autenticação para integrações
+-- Dependências: accounts
+-- =====================================================
+
+-- Cria a tabela credentials
+CREATE TABLE IF NOT EXISTS credentials (
+    -- Propriedades automáticas (padrão para todas as tabelas)
+    id SERIAL PRIMARY KEY,
+    deleted BOOLEAN DEFAULT false NOT NULL,
+    datetime_add TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_alt TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    datetime_del TIMESTAMP NULL,
+    
+    -- Propriedades específicas da tabela credentials
+    id_account INTEGER NOT NULL,
+    title VARCHAR(255) NOT NULL,
+    integration VARCHAR(50) DEFAULT 'web-chat' NOT NULL,
+    authType VARCHAR(20) DEFAULT 'none' NOT NULL,
+    userName VARCHAR(255),
+    password VARCHAR(255),
+    apiKey VARCHAR(255),
+    token VARCHAR(255),
+    paramName VARCHAR(255),
+    refreshToken VARCHAR(255),
+    clientSecret VARCHAR(255),
+    clientId VARCHAR(255),
+    sendIn VARCHAR(255) DEFAULT 'none' NOT NULL,
+    scheme VARCHAR(255) DEFAULT 'none' NOT NULL,
+    prefix VARCHAR(255)
+);
+
+-- Cria índices para otimização de consultas
+CREATE INDEX IF NOT EXISTS idx_credentials_deleted ON credentials(deleted);
+CREATE INDEX IF NOT EXISTS idx_credentials_id_account ON credentials(id_account);
+CREATE INDEX IF NOT EXISTS idx_credentials_integration ON credentials(integration);
+CREATE INDEX IF NOT EXISTS idx_credentials_authType ON credentials(authType);
+CREATE INDEX IF NOT EXISTS idx_credentials_title ON credentials(title);
+
+-- Adiciona comentários para documentação
+COMMENT ON TABLE credentials IS 'Tabela que armazena credenciais de autenticação para integrações com serviços externos';
+COMMENT ON COLUMN credentials.id IS 'Identificador único da credencial (chave primária)';
+COMMENT ON COLUMN credentials.deleted IS 'Flag indicando se o registro foi excluído logicamente';
+COMMENT ON COLUMN credentials.datetime_add IS 'Data e hora de criação do registro';
+COMMENT ON COLUMN credentials.datetime_alt IS 'Data e hora da última alteração do registro';
+COMMENT ON COLUMN credentials.datetime_del IS 'Data e hora da exclusão lógica do registro';
+COMMENT ON COLUMN credentials.id_account IS 'Referência para a conta proprietária da credencial';
+COMMENT ON COLUMN credentials.title IS 'Título/nome identificador da credencial';
+COMMENT ON COLUMN credentials.integration IS 'Tipo da integração (web-chat, whatsapp, z-api, evolution-api, telegram, facebook, instagram)';
+COMMENT ON COLUMN credentials.authType IS 'Tipo de autenticação (0=Nenhum, 1=Básico, 2=OAuth2, 3=API Key)';
+COMMENT ON COLUMN credentials.userName IS 'Nome de usuário para autenticação básica';
+COMMENT ON COLUMN credentials.password IS 'Senha para autenticação básica (deve ser criptografada)';
+COMMENT ON COLUMN credentials.apiKey IS 'Chave de API para autenticação por API Key';
+COMMENT ON COLUMN credentials.token IS 'Token de acesso para autenticação por token';
+COMMENT ON COLUMN credentials.paramName IS 'Nome do parâmetro para envio da credencial';
+COMMENT ON COLUMN credentials.refreshToken IS 'Token de renovação para OAuth';
+COMMENT ON COLUMN credentials.clientSecret IS 'Segredo do cliente para OAuth';
+COMMENT ON COLUMN credentials.clientId IS 'ID do cliente para OAuth';
+COMMENT ON COLUMN credentials.sendIn IS 'Local de envio da credencial (0=header, 1=query, 2=body)';
+COMMENT ON COLUMN credentials.scheme IS 'Esquema de autenticação (0=Bearer, 1=Basic, 2=Custom)';
+COMMENT ON COLUMN credentials.prefix IS 'Prefixo para o valor da credencial (ex: "Bearer ", "API-Key ")';