Documento 021 · Enterprise Data Model · Banco de Dados

O modelo de dados corporativo da K10AI

O Enterprise Data Model (EDM) define toda a estrutura de dados da plataforma — referência oficial para todos os módulos, projetada para consistência, escalabilidade, IA e auditoria.

Objetivo

Uma única fonte de verdade

Todos os módulos utilizam este modelo como referência oficial de dados.

Eliminar duplicidade de dados
Garantir escalabilidade
Facilitar integrações
Permitir crescimento futuro
Garantir consistência entre módulos
Facilitar Analytics
Facilitar IA
Facilitar auditoria

Colunas Base Obrigatórias

Toda entidade possui obrigatoriamente. Nunca IDs sequenciais — sempre UUID.

id (UUID)createdAtupdatedAtdeletedAt (Soft Delete)createdByupdatedByorganizationIdworkspaceIdversionstatus

Arquitetura do Banco

Organizations
Users
Workspaces
Projects
Modules
Resources
Assets
Analytics
Audit
Billing
Domínios & Tabelas

Entidades por módulo

Toda tabela herda as colunas base. Abaixo, os campos específicos de cada domínio.

Identidade

USERS

idnameemailpasswordHashavatarphonelanguagetimezonecountrystatuslastLoginemailVerifiedmfaEnabled

USER_SESSIONS

iduserIdrefreshTokendevicebrowseripexpiresAt

USER_API_KEYS

iduserIdnamekeyHashlastUsedexpiresAt

Organizações

ORGANIZATIONS

idnamesluglogodomainplanindustrycountrytimezonestatus

Workspaces & Projetos

WORKSPACES

idorganizationIdnamedescriptionlogocolorstatus

PROJECTS

idworkspaceIdnamedescriptionobjectivelanguagebrandIdstatus

Brands

BRANDS

idorganizationIdnamelogoprimaryColorsecondaryColorfontvoicemissionvision

Produtos

COURSES

idprojectIdtitledescriptioncoverstatuspublishedAt

COURSE_MODULES

idcourseIdtitleorder

LESSONS

idmoduleIdtitlecontentdurationvideoattachments

EBOOKS

idprojectIdtitlecoverlanguagepagesstatus

LANDING_PAGES

idprojectIdtemplateslugdomainseopublished

Prompts

PROMPTS

idprojectIdagentIdcategorytitlecontentvariablesversionstatus

Agentes IA

AI_AGENTS

idnamecategorydescriptionmasterPromptmodeltemperaturemaxTokensstatus

AGENT_EXECUTIONS

idagentIduserIdprojectIdtokenscostdurationsuccess

Workflows

WORKFLOWS

idprojectIdnametriggerstatusscheduleversion

WORKFLOW_STEPS

idworkflowIdtypepositionconfignextStep

EXECUTIONS

idworkflowIdstartedAtfinishedAtdurationstatus

AI Kernel

CONVERSATIONS

iduserIdprojectIdtitle

MESSAGES

idconversationIdrolecontenttokensmodelcost

MEMORY

iduserIdprojectIdtypecontentembedding

Knowledge Graph

KNOWLEDGE_NODES

idtypetitlemetadata

KNOWLEDGE_EDGES

idsourceNodetargetNoderelation

Files

FILES

idprojectIdnametypesizemimestorageUrlchecksum

Marketplace

TEMPLATES

idauthorcategorypricedownloadsrating

PLUGINS

iddeveloperversionstatus

PROMPT_PACKS

idtitlepricedownloads

Billing

PLANS

idnamepricecreditsstoragelimits

SUBSCRIPTIONS

idorganizationIdplanIdstatusrenewDate

PAYMENTS

idsubscriptionIdgatewayamountstatus

Analytics

EVENTS

idorganizationIduserIdeventresourcemetadatatimestamp

DASHBOARD_METRICS

idorganizationIdmetricvalueperiod

Auditoria & Notificações

AUDIT_LOG

idactorresourceactionoldValuenewValueipdevicecreatedAt

NOTIFICATIONS

iduserIdtitlebodytyperead

Configurações & Integrações

SETTINGS

idorganizationIdcategorykeyvalue

INTEGRATIONS

idprovidercredentialsstatus

API_KEYS

idorganizationIdkeyHashpermissionsexpiresAt
ERD Lógico

Relacionamento geral

A hierarquia completa de entidades, da organização aos recursos de cada projeto.

Organization
│
├── Users
├── Billing
├── Analytics
├── Integrations
├── API Keys
├── Workspaces
│
└── Workspace
      │
      ├── Projects
      │      │
      │      ├── Courses
      │      ├── Ebooks
      │      ├── Landing Pages
      │      ├── Workflows
      │      ├── AI Conversations
      │      ├── Files
      │      ├── Prompts
      │      └── Knowledge Graph
      │
      └── Brands

Índices Obrigatórios

Todas as tabelas indexam:

UUIDorganizationIdworkspaceIdprojectIdcreatedAtstatus

Índices Adicionais

emailslugdomínio personalizadoAPI KeysConversation IDWorkflow IDAgent ID
Escalabilidade

Projetado para crescer

O modelo suporta desde multi-tenant até busca vetorial para IA.

Multi-Tenant
Soft Delete
Versionamento
Auditoria
Particionamento de tabelas grandes
Arquivamento de dados históricos
Busca vetorial para IA (embeddings)
Expansão modular sem quebra de compatibilidade
Critérios de Aprovação

Quando o modelo está pronto

O EDM só é considerado concluído quando todos os critérios abaixo forem atendidos.

Todas as entidades possuírem UUIDRelacionamentos normalizadosSuporte a multi-tenant garantidoEstratégia para auditoria e versionamentoÍndices críticos definidosSuporte à expansão futura sem migrações disruptivas