Modelo de Backend para App de CRM
GraphQL — Guia de Schema, API e IA
Um schema de backend de GraphQL CRM pronto para produção e Starter Kit na Back4app: Contato, Empresa, Negócio, Atividade, estágios do pipeline, diagrama ER, dicionário de dados, schema JSON, playground de API e um prompt de Agente de IA com um clique para implantar em minutos.
Principais Conclusões
Nesta página você obtém um schema de CRM pronto para produção, um prompt de IA com um clique e código GraphQL passo a passo — para que você possa lançar um app de CRM sem construir o backend.
- Implante em minutos — Cole o prompt do Agente de IA e obtenha um aplicativo em funcionamento com contatos, empresas, negócios e pipeline.
- Seguro por padrão — ACLs e acesso baseado em funções para que os usuários vejam apenas seus negócios e dados atribuídos.
- GraphQL-nativo SDK — Objetos tipados, async/await, fixação offline e Live Queries para atualizações de pipeline.
- REST + GraphQL — Ambas as APIs geradas automaticamente; filtre negócios por estágio, liste atividades por relacionado a.
- Cinco classes — _Usuário (embutido), Empresa, Contato, Negócio (pipeline), Atividade (tarefas/eventos).
O que é o template de backend do aplicativo CRM GraphQL?
Back4app é um backend como serviço (BaaS) ideal para aplicativos CRM: banco de dados gerenciado, sincronização em tempo real, acesso baseado em funções e SDKs para mais de 13 tecnologias. O template de backend do aplicativo CRM é um esquema de backend pré-construído e pronto para produção no Back4app. Ele oferece cinco classes (_User, Company, Contact, Deal, Activity), estágios de pipeline, APIs REST e GraphQL, e um prompt de agente de IA com um clique — para que você possa conectar um frontend GraphQL e enviar um aplicativo CRM funcional em minutos em vez de dias. Escolha sua tecnologia abaixo para integração passo a passo do SDK.
Melhor para:
Visão Geral
Back4app expõe seu esquema de CRM sobre GraphQL: consulte contatos, negócios (com onde: { stage }) e atividades; mutações com createDeal, updateDeal, createContact, createActivity. Um endpoint, esquema tipado e autenticação baseada em sessão.
As mesmas cinco classes — _User, Company, Contact, Deal, Activity — suportam tanto REST quanto GraphQL. Use seu cliente GraphQL favorito (Apollo, urql) para solicitar apenas os campos que você precisa e mantenha o pipeline e as listas de contatos em sincronia.
Recursos principais do CRM
GraphQL API CRM com tipos de Contato, Empresa, Negócio e Atividade. Consultas e mutações para gerenciamento de pipeline, ACLs e rastreamento de atividades — sem cola REST.
Gerenciamento de contatos
Armazene e gerencie contatos com nome, e-mail, telefone, empresa e notas. Ideal para aplicativos GraphQL.
Gestão de empresas
Rastreie empresas com nome, site, setor e endereço. Links para contatos e negócios.
Pipeline de negócios
Pipeline de vendas com etapas, valor, data de fechamento esperada e atribuição. Construído para backends GraphQL.
Rastreamento de atividades
Registre chamadas, e-mails, reuniões e notas vinculadas a contatos e negócios. Funciona com o SDK GraphQL.
Usuário e permissões
Modelo de usuário embutido e referências para propriedade e atribuição. ACLs prontas para uso para GraphQL.
Por que construir sua API de CRM GraphQL com Back4app?
Back4app fornece um endpoint GraphQL para que você possa consultar e modificar Contato, Empresa, Negócio e Atividade com um único endpoint.
- •Endpoint único: POST para o endpoint GraphQL com consultas e mutações; solicite apenas os campos que você precisa.
- •Esquema tipado: Os tipos de Contato, Empresa, Negócio e Atividade são gerados a partir do seu esquema Back4app; use-os em seu cliente para solicitações seguras em tipo.
- •Pipeline e atividades: Consultas de negócios por estágio e atividades relacionadas; mutações para atualizar o estágio do negócio e criar atividades.
Ideal para equipes que usam GraphQL clientes (Apollo, urql) para CRM ou painéis.
Benefícios Principais
Um backend CRM pronto para produção para que você possa enviar mais rápido e focar no seu aplicativo.
Envie Mais Rápido, Sem Código de Backend
APIs REST & GraphQL e um esquema pronto para uso — conecte seu aplicativo e vá.
Seguro por Padrão
ACLs e permissões em nível de classe; restrição por assignedTo e createdBy.
Pipeline em Tempo Real
Live Queries sobre WebSockets para atualizações instantâneas de negócios e atividades.
Autenticação Integrada
Cadastro de usuário, login e gerenciamento de sessão prontos para uso.
Funciona Offline
O pinning local mantém contatos e negócios disponíveis offline e sincroniza quando você se reconecta.
Implante em Minutos
Use o Agente de IA para criar e implantar seu aplicativo CRM a partir deste modelo.
Pronto para experimentar?
Deixe o agente de IA da Back4app criar o backend do seu aplicativo CRM, conectar o frontend GraphQL e implantar — tudo a partir de um único comando.
Grátis para começar — 50 comandos de Agente de IA/mês, sem necessidade de cartão de crédito
Pilha Técnica
Tudo que alimenta este modelo de aplicativo CRM em um relance.
Diagrama ER
Diagrama de Entidade-Relacionamento para o modelo de dados do aplicativo GraphQL CRM.
Esquema CRM: _Usuário, Empresa, Contato, Negócio, Atividade com ponteiros para empresa, contato, negócio, atribuído a, relacionado a, criado por.
Ver fonte do diagrama
erDiagram
_User {
String objectId PK
String username
String email
String password
Date createdAt
Date updatedAt
}
Company {
String objectId PK
String name
String website
String industry
String address
String notes
Pointer createdBy FK
Date createdAt
Date updatedAt
}
Contact {
String objectId PK
String name
String email
String phone
Pointer company FK
String notes
Pointer createdBy FK
Date createdAt
Date updatedAt
}
Deal {
String objectId PK
String title
Number amount
String stage
Pointer contact FK
Pointer company FK
Date expectedCloseDate
String notes
Pointer assignedTo FK
Date createdAt
Date updatedAt
}
Activity {
String objectId PK
String type
String subject
String description
Date dueDate
Date completedAt
Pointer relatedTo FK
Pointer createdBy FK
Date createdAt
Date updatedAt
}
Company ||--o{ Contact : "has"
Company ||--o{ Deal : "has"
Contact ||--o{ Deal : "has"
_User ||--o{ Deal : "assignedTo"
_User ||--o{ Activity : "createdBy"
Contact ||--o{ Activity : "relatedTo"
Deal ||--o{ Activity : "relatedTo"
_User ||--o{ Company : "createdBy"
_User ||--o{ Contact : "createdBy"
Fluxo de Integração
Sequência Auth-to-CRUD: como seu aplicativo GraphQL se comunica com Back4app — login, depois consulta contatos e negócios, atualiza o pipeline.
Ver fonte do diagrama
sequenceDiagram
participant User
participant Client as GraphQL Client
participant Back4app as Back4app Cloud
User->>Client: Login
Client->>Back4app: mutation { logIn(username, password) }
Back4app-->>Client: Session token
Client-->>User: Logged in
User->>Client: Load contacts and deals
Client->>Back4app: query { deals { edges { node { objectId title stage } } } }
Back4app-->>Client: Deal list
Client-->>User: Show pipeline
User->>Client: Create deal or contact
Client->>Back4app: mutation { createDeal(input: { ... }) }
Back4app-->>Client: Deal (objectId)
Client-->>User: Updated listDicionário de Dados
Referência completa de campos para cada classe no esquema.
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| objectId | String | Auto-generated unique identifier | automático |
| name | String | Full name of the contact | |
| String | Email address | — | |
| phone | String | Phone number | — |
| company | Pointer<Company> | Company this contact belongs to | — |
| notes | String | Free-form notes | — |
| createdBy | Pointer<_User> | User who created this contact | — |
| createdAt | Date | Auto-generated creation timestamp | automático |
| updatedAt | Date | Auto-generated last-update timestamp | automático |
9 campos em Contact
Segurança e Permissões
Como a propriedade, ACLs e permissões em nível de classe protegem os dados neste esquema de CRM.
ACLs em Nível de Linha
Use ACLs e ponteiros (assignedTo, createdBy) para que os usuários vejam e editem apenas seus negócios atribuídos e dados relacionados.
Permissões em Nível de Classe
CLPs restringem quais funções ou usuários podem criar, ler, atualizar ou excluir objetos em nível de classe.
Propriedade Baseada em Ponteiro
Deal.assignedTo e Activity.createdBy vinculam-se a _User; o Cloud Code pode impor visibilidade e edições por função.
Esquema (JSON)
Definição de esquema JSON bruto — copie e use em seu aplicativo Back4app ou importe via API.
{
"classes": [
{
"className": "Contact",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"name": {
"type": "String",
"required": true
},
"email": {
"type": "String",
"required": false
},
"phone": {
"type": "String",
"required": false
},
"company": {
"type": "Pointer",
"targetClass": "Company",
"required": false
},
"notes": {
"type": "String",
"required": false
},
"createdBy": {
"type": "Pointer",
"targetClass": "_User",
"required": false
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "Company",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"name": {
"type": "String",
"required": true
},
"website": {
"type": "String",
"required": false
},
"industry": {
"type": "String",
"required": false
},
"address": {
"type": "String",
"required": false
},
"notes": {
"type": "String",
"required": false
},
"createdBy": {
"type": "Pointer",
"targetClass": "_User",
"required": false
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "Deal",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"title": {
"type": "String",
"required": true
},
"amount": {
"type": "Number",
"required": false
},
"stage": {
"type": "String",
"required": false
},
"contact": {
"type": "Pointer",
"targetClass": "Contact",
"required": false
},
"company": {
"type": "Pointer",
"targetClass": "Company",
"required": false
},
"expectedCloseDate": {
"type": "Date",
"required": false
},
"notes": {
"type": "String",
"required": false
},
"assignedTo": {
"type": "Pointer",
"targetClass": "_User",
"required": false
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "Activity",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"type": {
"type": "String",
"required": false
},
"subject": {
"type": "String",
"required": false
},
"description": {
"type": "String",
"required": false
},
"dueDate": {
"type": "Date",
"required": false
},
"completedAt": {
"type": "Date",
"required": false
},
"relatedTo": {
"type": "Pointer",
"required": false
},
"createdBy": {
"type": "Pointer",
"targetClass": "_User",
"required": false
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "_User",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"username": {
"type": "String",
"required": true
},
"email": {
"type": "String",
"required": true
},
"password": {
"type": "String",
"required": true
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
}
]
}Construa com o Agente de IA
Use o Agente de IA Back4app para construir um aplicativo CRM real a partir deste modelo: ele criará o frontend, o backend (este esquema, autenticação e APIs) e fará a implantação — sem configuração manual. O prompt abaixo descreve esta pilha de CRM para que o Agente possa gerar um aplicativo pronto para produção de uma só vez.
Crie um aplicativo CRM no Back4app com este esquema e comportamento exatos. Esquema: 1. _Usuário (use Back4app embutido): nome de usuário (String, obrigatório), email (String, obrigatório), senha (String, obrigatório); objectId, createdAt, updatedAt (sistema). 2. Empresa: nome (String, obrigatório), site (String), setor (String), endereço (String), notas (String), criadoPor (Ponteiro para _Usuário); objectId, createdAt, updatedAt (sistema). 3. Contato: nome (String, obrigatório), email (String), telefone (String), empresa (Ponteiro para Empresa), notas (String), criadoPor (Ponteiro para _Usuário); objectId, createdAt, updatedAt (sistema). 4. Negócio: título (String, obrigatório), valor (Número), estágio (String; por exemplo, lead, qualificado, proposta, negociação, ganho, perdido), contato (Ponteiro para Contato), empresa (Ponteiro para Empresa), dataFechamentoEsperada (Data), notas (String), atribuídoA (Ponteiro para _Usuário); objectId, createdAt, updatedAt (sistema). 5. Atividade: tipo (String; por exemplo, chamada, email, reunião, nota), assunto (String), descrição (String), dataVencimento (Data), concluídoEm (Data), relacionadoA (Ponteiro para Contato ou Negócio), criadoPor (Ponteiro para _Usuário); objectId, createdAt, updatedAt (sistema). Segurança: - Defina ACLs para que apenas usuários autenticados possam acessar os dados; use regras baseadas em função ou baseadas em proprietário onde apropriado (por exemplo, atribuídoA, criadoPor). - Use Permissões em Nível de Classe para que apenas usuários autenticados possam criar/ler/atualizar/excluir essas classes. Autenticação: - Cadastro (nome de usuário, email, senha) e login; suporte para logout/sessão. Comportamento: - CRUD completo para Empresa, Contato, Negócio e Atividade. - Liste negócios com filtro por estágio e ordene por dataFechamentoEsperada ou updatedAt (visualização de pipeline). - Liste atividades por relacionadoA (Contato ou Negócio). - Opcional: Live Queries em tempo real para Negócio e Atividade para atualizações de painel/pipeline. - Opcional: fixação offline para mobile (Contatos, Negócios, Atividades). Entregar: - Crie o aplicativo Back4app com o esquema acima, ACLs e qualquer Cloud Code necessário. - Gere o frontend e conecte-o a este backend; implante para que o aplicativo seja executável de ponta a ponta.
Pressione o botão abaixo para abrir o Agente com o prompt deste modelo pré-preenchido.
API Playground
Experimente os endpoints REST e GraphQL para o esquema CRM. Respostas dos dados de exemplo acima — nenhuma conta Back4app necessária.
Usa o mesmo esquema CRM (Contato, Empresa, Negócio, Atividade) que este modelo.
Integração GraphQL Passo a Passo
Conecte-se ao seu backend Back4app a partir de um app GraphQL usando o SDK Back4app GraphQL.
Consultar contatos e negócios
Enviar uma consulta GraphQL para buscar contatos ou negócios (com token de sessão nos cabeçalhos).
GraphQLquery GetDeals { deals { edges { node { objectId title done dueDate priority createdAt } } } }Criar um negócio
Usar a mutação createDeal com variáveis para título, estágio, valor e contato/empresa relacionado.
GraphQLmutation CreateDeal($title: String!, $stage: String, $amount: Float) { createDeal(input: { fields: { title: $title stage: $stage amount: $amount } }) { deal { objectId title stage amount createdAt } } } mutation CreateContact($name: String!, $email: String, $phone: String) { createContact(input: { fields: { name: $name email: $email phone: $phone } }) { contact { objectId name createdAt } } }Atualizar e excluir
Mutações UpdateDeal e DeleteDeal com objectId.
GraphQLmutation UpdateDeal($objectId: ID!, $stage: String) { updateDeal(input: { objectId: $objectId fields: { stage: $stage } }) { deal { objectId stage } } } mutation DeleteDeal($objectId: ID!) { deleteDeal(input: { objectId: $objectId }) { success } }
Perguntas Frequentes
Perguntas comuns sobre o modelo de backend do aplicativo CRM.
Pronto para Construir Seu App de CRM?
Comece seu projeto GraphQL em minutos. Nenhum cartão de crédito necessário.