@greatapps/greatagents 0.1.10 → 0.1.12

package/docs/ERD_GAGents_Database.mmd

@@ -1,331 +0,0 @@
-%%{init: {
-  'title': 'GAGents Database - Entity Relationship Diagram',
-  'theme': 'base',
-  'themeVariables': {
-    'primaryColor': '#2E86AB',
-    'primaryTextColor': '#000000',
-    'primaryBorderColor': '#A23B72',
-    'lineColor': '#F18F01',
-    'sectionBkgColor': '#A23B72',
-    'altSectionBkgColor': '#C73E1D'
-  }
-}}%%
-
-erDiagram
-    
-    accounts {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        VARCHAR(100) name "searchable, maxLength=100"
-        BOOLEAN deleted "DEFAULT false"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    users {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        VARCHAR(50) name "searchable, maxLength=50"
-        VARCHAR last_name "searchable"
-        VARCHAR email "NOT NULL, searchable, filterable, format=email"
-        VARCHAR profile "DEFAULT 'collaborator'"
-        IMAGE photo "types=[png,jpg,jpeg,gif,svg,webp], storage=gapps-r1-storage, 160x160"
-        BOOLEAN deleted "DEFAULT false"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    people {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        VARCHAR(255) full_name "searchable, maxLength=255"
-        VARCHAR(255) first_name "searchable, maxLength=255"
-        VARCHAR(255) last_name "searchable, maxLength=255"
-        IMAGE photo "types=[png,jpg,jpeg,gif,svg,webp], storage=gpages, 200x200"
-        VARCHAR(50) document "searchable, maxLength=50"
-        DATE birth_date "filterable"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    tags {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        VARCHAR(255) name "NOT NULL, searchable, filterable, maxLength=255"
-        VARCHAR color "DEFAULT '#000000', filterable"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    credentials {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        VARCHAR(255) title "NOT NULL, searchable, filterable, maxLength=255"
-        VARCHAR provider "NOT NULL, filterable, DEFAULT 'web-chat'"
-        VARCHAR authType "NOT NULL, filterable, DEFAULT 'none'"
-        VARCHAR userName
-        VARCHAR password
-        VARCHAR apiKey
-        VARCHAR token
-        VARCHAR paramName
-        VARCHAR refreshToken
-        VARCHAR clientSecret
-        VARCHAR clientId
-        VARCHAR sendIn "DEFAULT 'none'"
-        VARCHAR scheme "DEFAULT 'none'"
-        VARCHAR prefix
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    %% ==========================================
-    %% AI & AUTOMATION DOMAIN (Domínio de IA)
-    %% ==========================================
-    
-    agents {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        VARCHAR(255) title "NOT NULL, searchable, filterable, maxLength=255"
-        IMAGE photo "types=[png,jpg,jpeg,gif,svg,webp], storage=gpages, 200x200"
-        TEXT prompt
-        INTEGER delay_typing "DEFAULT 0, filterable"
-        INTEGER waiting_time "DEFAULT 0, filterable"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    tools {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        VARCHAR(255) title "NOT NULL, searchable, filterable, maxLength=255"
-        VARCHAR type "filterable, DEFAULT 'mcp'"
-        VARCHAR(1000) description "searchable, filterable, maxLength=1000"
-        INTEGER id_credential FK "filterable, index, optional"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    missions {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        INTEGER id_agent FK "NOT NULL, filterable, index, reference=agents.id"
-        VARCHAR(255) title "NOT NULL, searchable, filterable, maxLength=255"
-        TEXT prompt
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    objectives {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        INTEGER id_mission FK "NOT NULL, filterable, index, reference=missions.id"
-        INTEGER order "NOT NULL, filterable, DEFAULT 0"
-        VARCHAR(255) title "NOT NULL, searchable, filterable, maxLength=255"
-        TEXT prompt
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    objectives_tools {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        INTEGER id_objective FK "NOT NULL, filterable, index, reference=objectives.id"
-        INTEGER id_tool FK "NOT NULL, filterable, index, reference=tools.id"
-        TEXT instructions
-        BOOLEAN wait "DEFAULT false"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    %% ==========================================
-    %% COMMUNICATION DOMAIN (Domínio de Comunicação)
-    %% ==========================================
-    
-    channels {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        VARCHAR(255) title "NOT NULL, searchable, filterable, maxLength=255"
-        VARCHAR provider "NOT NULL, filterable, DEFAULT 'web-chat'"
-        VARCHAR url
-        BOOLEAN active "DEFAULT true, filterable"
-        INTEGER id_credential FK "optional, reference=credentials.id"
-        VARCHAR(255) handle "filterable, maxLength=255"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    conversations {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        INTEGER id_lead FK "NOT NULL, filterable, index, reference=leads.id"
-        INTEGER id_channel FK "NOT NULL, filterable, index, reference=channels.id"
-        INTEGER id_assignee FK "filterable, index, reference=users.id"
-        TIMESTAMP last_message_at "filterable, optional"
-        INTEGER id_last_message FK "filterable, index, optional, reference=messages.id"
-        BOOLEAN stop_ai "DEFAULT false, filterable"
-        VARCHAR status "filterable, DEFAULT 'open'"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    messages {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        INTEGER id_conversation FK "NOT NULL, filterable, index, reference=conversations.id"
-        INTEGER id_agent FK "filterable, index, optional, reference=agents.id"
-        INTEGER id_user FK "filterable, index, optional, reference=users.id"
-        VARCHAR direction "DEFAULT 'in', filterable"
-        VARCHAR role "DEFAULT 'user', filterable"
-        TEXT content "NOT NULL"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    %% ==========================================
-    %% CRM & ORGANIZATION DOMAIN (Domínio CRM)
-    %% ==========================================
-    
-    leads {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        INTEGER id_person FK "NOT NULL, filterable, reference=people.id"
-        VARCHAR(255) email "searchable, maxLength=255, pattern=email"
-        VARCHAR(20) phone "searchable, maxLength=20, pattern=phone"
-        INTEGER id_user_owner FK "filterable, index, reference=users.id"
-        INTEGER id_current_agent FK "filterable, index, reference=agents.id"
-        INTEGER id_current_mission FK "filterable, index, reference=missions.id"
-        INTEGER id_current_objective FK "filterable, index, reference=objectives.id"
-        TEXT notes "searchable"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    companies {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        INTEGER id_lead FK "NOT NULL, filterable, reference=leads.id"
-        VARCHAR(255) name "searchable, maxLength=255"
-        VARCHAR(255) website "searchable, maxLength=255, pattern=url"
-        VARCHAR(50) document "searchable, maxLength=50"
-        TEXT notes "searchable"
-        VARCHAR industry "searchable"
-        VARCHAR size "searchable"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    conversations_tags {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        INTEGER id_conversation FK "filterable, index, reference=conversations.id"
-        INTEGER id_tag FK "filterable, index, reference=tags.id"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    leads_tags {
-        SERIAL id PK "AUTO_INCREMENT, UNIQUE, INDEX"
-        INTEGER id_account FK "NOT NULL, filterable, reference=accounts.id"
-        INTEGER id_lead FK "filterable, index, reference=leads.id"
-        INTEGER id_tag FK "filterable, index, reference=tags.id"
-        BOOLEAN deleted "DEFAULT false, filterable"
-        TIMESTAMP datetime_add "filterable, updatable=false"
-        TIMESTAMP datetime_alt "filterable"
-        TIMESTAMP datetime_del "filterable"
-    }
-    
-    %% ==========================================
-    %% RELACIONAMENTOS 1:N (Um para Muitos)
-    %% ==========================================
-    
-    %% ACCOUNTS como entidade central (Multi-tenancy)
-    accounts ||--o{ users : "Multi-tenant"
-    accounts ||--o{ people : "Multi-tenant"
-    accounts ||--o{ tags : "Multi-tenant"
-    accounts ||--o{ credentials : "Multi-tenant"
-    accounts ||--o{ agents : "Multi-tenant"
-    accounts ||--o{ tools : "Multi-tenant"
-    accounts ||--o{ missions : "Multi-tenant"
-    accounts ||--o{ objectives : "Multi-tenant"
-    accounts ||--o{ objectives_tools : "Multi-tenant"
-    accounts ||--o{ channels : "Multi-tenant"
-    accounts ||--o{ conversations : "Multi-tenant"
-    accounts ||--o{ messages : "Multi-tenant"
-    accounts ||--o{ leads : "Multi-tenant"
-    accounts ||--o{ companies : "Multi-tenant"
-    accounts ||--o{ conversations_tags : "Multi-tenant"
-    accounts ||--o{ leads_tags : "Multi-tenant"
-    
-    %% RELACIONAMENTOS PRINCIPAIS
-    people ||--o{ leads : "Person-Lead"
-    leads ||--o{ companies : "Lead-Company"
-    leads ||--o{ conversations : "Lead-Conversation"
-    
-    %% AI & AUTOMATION RELATIONSHIPS
-    agents ||--o{ missions : "Agent-Mission"
-    missions ||--o{ objectives : "Mission-Objective"
-    objectives ||--o{ objectives_tools : "Objective-ObjectiveTool"
-    tools ||--o{ objectives_tools : "Tool-ObjectiveTool"
-    
-    %% COMMUNICATION RELATIONSHIPS
-    channels ||--o{ conversations : "Channel-Conversation"
-    conversations ||--o{ messages : "Conversation-Message"
-    
-    %% USER ASSIGNMENTS
-    users ||--o{ conversations : "User-ConversationAssignee"
-    users ||--o{ leads : "User-LeadOwner"
-    users ||--o{ messages : "User-Message"
-    
-    %% AGENT RELATIONSHIPS
-    agents ||--o{ messages : "Agent-Message"
-    agents ||--o{ leads : "Agent-CurrentAgent"
-    
-    %% MISSION & OBJECTIVE CURRENT STATES
-    missions ||--o{ leads : "Mission-CurrentMission"
-    objectives ||--o{ leads : "Objective-CurrentObjective"
-    
-    %% CREDENTIAL RELATIONSHIPS
-    credentials ||--o{ tools : "Credential-Tool"
-    credentials ||--o{ channels : "Credential-Channel"
-    
-    %% TAG RELATIONSHIPS
-    tags ||--o{ conversations_tags : "Tag-ConversationTag"
-    tags ||--o{ leads_tags : "Tag-LeadTag"
-    conversations ||--o{ conversations_tags : "Conversation-ConversationTag"
-    leads ||--o{ leads_tags : "Lead-LeadTag"
-    
-    %% ==========================================
-    %% RELACIONAMENTO CÍCLICO ESPECIAL
-    %% ==========================================
-    
-    %% CYCLIC REFERENCE: conversations ↔ messages
-    conversations ||--o| messages : "LastMessage"