Plantilla de Backend para la App CRM
React — Guía de Esquema, API y AI
Un esquema de backend de React CRM listo para producción y un Kit de Inicio en Back4app: Contacto, Empresa, Negocio, Actividad, etapas del pipeline, diagrama ER, diccionario de datos, esquema JSON, playground de API, y un prompt de Agente de AI con un clic para desplegar en minutos.
Puntos Clave
En esta página obtienes un esquema de CRM listo para producción, un prompt de AI con un clic, y código React paso a paso — para que puedas lanzar una app CRM sin construir el backend.
- Despliega en minutos — Pega el aviso del Agente de IA y obtén una aplicación en funcionamiento con contactos, empresas, ofertas y pipeline.
- Seguro por defecto — ACLs y acceso basado en roles para que los usuarios vean solo sus ofertas y datos asignados.
- React-SDK nativo — Objetos tipados, async/await, fijación offline y Live Queries para actualizaciones de pipeline.
- REST + GraphQL — Ambas APIs generadas automáticamente; filtra ofertas por etapa, lista actividades por relacionado con.
- Cinco clases — _Usuario (incorporado), Empresa, Contacto, Oferta (pipeline), Actividad (tareas/eventos).
¿Qué es la plantilla de backend de la aplicación CRM de React?
La plantilla de backend de la aplicación CRM de React empareja el esquema CRM de Back4app (Contact, Company, Deal, Activity) con el SDK de Parse JavaScript y React. Usa hooks para obtener contactos y ofertas, filtrar por etapa del canal de ventas y suscribirte a Live Queries para actualizaciones en tiempo real. Ideal para paneles de control y herramientas internas: conecta tus componentes a un backend gestionado sin escribir rutas de API ni gestionar la autenticación tú mismo.
Mejor para:
Descripción general
Las interfaces de usuario CRM de React típicamente muestran un pipeline (ofertas por etapa), listas de contactos y empresas, y líneas de tiempo de actividades. Back4app proporciona el backend; el SDK Parse JavaScript y los hooks de React manejan la obtención, el estado y las actualizaciones en tiempo real a través de Live Queries.
El esquema define _User, Company, Contact, Deal, y Activity. En React usas nuevo Parse.Query('Deal').equalTo('stage', stage) y almacenas resultados en estado o contexto. El SDK Back4app React/JS soporta autenticación de sesión, por lo que solo se devuelve datos asignados o de propiedad.
Características principales del CRM
Un backend de CRM de React con gestión de contactos y empresas integrada, etapas del pipeline de negocios y seguimiento de actividades. Utiliza hooks y el SDK de Parse para actualizaciones en tiempo real del pipeline.
Gestión de contactos
Almacena y gestiona contactos con nombre, correo electrónico, teléfono, empresa y notas. Ideal para aplicaciones React.
Gestión de empresas
Rastrea empresas con nombre, sitio web, industria y dirección. Enlaces a contactos y ofertas.
Tubería de ofertas
Tubería de ventas con etapas, monto, fecha de cierre esperada y asignación. Construido para backends de React.
Seguimiento de actividades
Registra llamadas, correos electrónicos, reuniones y notas vinculadas a contactos y negocios. Funciona con el SDK de React.
Usuario y permisos
Modelo de usuario integrado y punteros para propiedad y asignación. ACLs listos para usar para React.
¿Por qué construir tu backend de CRM React con Back4app?
Back4app elimina la necesidad de un backend personalizado para que puedas concentrarte en las vistas del pipeline y la gestión de contactos/negocios.
- •SDK amigable con ganchos: Usa el SDK Back4app JavaScript con useEffect y useState; obtiene contactos y negocios al montar y actualiza el estado después de las mutaciones.
- •Autenticación lista para usar: Parse.User.login() y signUp() te dan tokens de sesión; restringe datos por assignedTo o createdBy.
- •Tiempo real con Live Queries: Suscríbete a cambios en Deal y Activity para que el pipeline y el dashboard se mantengan sincronizados sin sondeos.
Ideal para desarrolladores de React que construyen CRM o dashboards de ventas—mismo backend, cualquier frontend.
Beneficios principales
Un backend CRM listo para producción para que puedas enviar más rápido y concentrarte en tu aplicación.
Envía más rápido, sin código de backend
APIs REST y GraphQL y un esquema listo para usar — conecta tu aplicación y listo.
Seguro por defecto
ACLs y permisos a nivel de clase; restringir por assignedTo y createdBy.
Pipeline en Tiempo Real
Live Queries sobre WebSockets para actualizaciones instantáneas de ofertas y actividades.
Autenticación Integrada
Registro de usuario, inicio de sesión y manejo de sesiones listos para usar.
Funciona Sin Conexión
El anclaje local mantiene contactos y ofertas disponibles sin conexión y se sincroniza cuando te reconectas.
Despliega en Minutos
Usa el Agente de IA para crear y desplegar tu aplicación CRM a partir de esta plantilla.
¿Listo para probarlo?
Deja que el agente de IA de Back4app cree el backend de tu aplicación CRM, conecte el frontend React y despliegue — todo desde un solo aviso.
Gratis para comenzar — 50 avisos de agente de IA/mes, no se requiere tarjeta de crédito
Pila técnica
Todo lo que impulsa esta plantilla de aplicación CRM de un vistazo.
Diagrama ER
Diagrama de entidad-relación para el modelo de datos de la aplicación CRM React.
Esquema CRM: _Usuario, Empresa, Contacto, Negocio, Actividad con punteros para empresa, contacto, negocio, asignado a, relacionado con, creado por.
Ver fuente del 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"
Flujo de integración
Secuencia de Auth-to-CRUD: cómo tu aplicación React se comunica con Back4app — iniciar sesión, luego consultar contactos y negocios, actualizar el pipeline.
Ver fuente del diagrama
sequenceDiagram
participant User
participant App as React App
participant Back4app as Back4app Cloud
User->>App: Login
App->>Back4app: Parse.User.logIn(username, password)
Back4app-->>App: Session token
App-->>User: Logged in
User->>App: Load contacts and deals
App->>Back4app: new Parse.Query('Deal').find() or Parse.Query('Contact').find()
Back4app-->>App: List of Deal / Contact
App-->>User: Show pipeline
User->>App: Create deal or contact
App->>Back4app: deal.save() or contact.save()
Back4app-->>App: Deal (objectId)
App-->>User: Updated listDiccionario de datos
Referencia completa de campos para cada clase en el esquema.
| Campo | Tipo | Descripción | Requerido |
|---|---|---|---|
| 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 en Contact
Seguridad y permisos
Cómo la propiedad, ACLs y permisos a nivel de clase protegen los datos en este esquema de CRM.
ACLs a Nivel de Fila
Usa ACLs y punteros (assignedTo, createdBy) para que los usuarios solo vean y editen sus tratos asignados y datos relacionados.
Permisos a Nivel de Clase
Los CLPs restringen qué roles o usuarios pueden crear, leer, actualizar o eliminar objetos a nivel de clase.
Propiedad Basada en Punteros
Deal.assignedTo y Activity.createdBy se vinculan a _User; Cloud Code puede hacer cumplir la visibilidad y las ediciones por rol.
Esquema (JSON)
Definición de esquema JSON en bruto — copia y usa en tu aplicación Back4app o importa a través de la 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
}
}
}
]
}Construir con el Agente de IA
Utiliza el Agente de IA de Back4app para construir una aplicación CRM real a partir de esta plantilla: creará el frontend, el backend (este esquema, autenticación y APIs) y lo desplegará — sin configuración manual. El aviso a continuación describe esta pila CRM para que el Agente pueda generar una aplicación lista para producción de una sola vez.
Crea una aplicación CRM en Back4app con este esquema y comportamiento exactos. Esquema: 1. _Usuario (usar Back4app incorporado): nombre de usuario (String, requerido), correo electrónico (String, requerido), contraseña (String, requerido); objectId, createdAt, updatedAt (sistema). 2. Empresa: nombre (String, requerido), sitio web (String), industria (String), dirección (String), notas (String), creadoPor (Puntero a _Usuario); objectId, createdAt, updatedAt (sistema). 3. Contacto: nombre (String, requerido), correo electrónico (String), teléfono (String), empresa (Puntero a Empresa), notas (String), creadoPor (Puntero a _Usuario); objectId, createdAt, updatedAt (sistema). 4. Negocio: título (String, requerido), monto (Número), etapa (String; por ejemplo, cliente potencial, calificado, propuesta, negociación, ganado, perdido), contacto (Puntero a Contacto), empresa (Puntero a Empresa), fechaEsperadaCierre (Fecha), notas (String), asignadoA (Puntero a _Usuario); objectId, createdAt, updatedAt (sistema). 5. Actividad: tipo (String; por ejemplo, llamada, correo electrónico, reunión, nota), asunto (String), descripción (String), fechaVencimiento (Fecha), completadoEn (Fecha), relacionadoCon (Puntero a Contacto o Negocio), creadoPor (Puntero a _Usuario); objectId, createdAt, updatedAt (sistema). Seguridad: - Establecer ACLs para que solo los usuarios autenticados puedan acceder a los datos; usar reglas basadas en roles o basadas en propietarios donde sea apropiado (por ejemplo, asignadoA, creadoPor). - Usar Permisos a Nivel de Clase para que solo los usuarios autenticados puedan crear/leer/actualizar/eliminar estas clases. Autenticación: - Registro (nombre de usuario, correo electrónico, contraseña) e inicio de sesión; soporte para cerrar sesión/sesión. Comportamiento: - CRUD completo para Empresa, Contacto, Negocio y Actividad. - Listar negocios con filtro por etapa y ordenar por fechaEsperadaCierre o updatedAt (vista de pipeline). - Listar actividades por relacionadoCon (Contacto o Negocio). - Opcional: Live Queries en tiempo real para Negocio y Actividad para actualizaciones de panel/pipeline. - Opcional: fijación fuera de línea para móvil (Contactos, Negocios, Actividades). Entregar: - Crear la aplicación Back4app con el esquema anterior, ACLs y cualquier Código en la Nube necesario. - Generar el frontend y conectarlo a este backend; desplegar para que la aplicación sea ejecutable de extremo a extremo.
Presiona el botón a continuación para abrir el Agente con el aviso de esta plantilla prellenado.
API Playground
Prueba los endpoints REST y GraphQL para el esquema CRM. Respuestas de los datos de ejemplo anteriores — no se necesita cuenta de Back4app.
Utiliza el mismo esquema CRM (Contacto, Empresa, Negocio, Actividad) que esta plantilla.
Integración paso a paso React
Conéctate a tu backend de Back4app desde una app React utilizando el SDK Back4app React.
Paso 1: Instalar el SDK Back4app React
Agrega el SDK Back4app para tu stack (por ejemplo, npm, pubspec o gestor de paquetes).
Bashnpm install parsePaso 2: Inicializa Back4app en tu app
Inicializa el SDK de Back4app al iniciar la aplicación con tu ID de aplicación y URL del servidor.
JavaScriptimport Parse from 'parse'; Parse.initialize( 'YOUR_APP_ID', 'YOUR_JAVASCRIPT_KEY', { serverURL: 'https://parseapi.back4app.com' } ); Parse.serverURL = 'https://parseapi.back4app.com';Paso 3: Consultar contactos y ofertas
Utiliza el SDK para obtener objetos de Contacto y Oferta; filtra las ofertas por etapa para el pipeline.
JavaScriptasync function getDeals(stage = 'qualified') { const query = new Parse.Query('Deal'); query.equalTo('stage', stage); query.ascending('expectedCloseDate'); const results = await query.find(); return results; } async function getContacts() { const query = new Parse.Query('Contact'); return await query.find(); }Paso 4: Crear un contacto u oferta
Crea un nuevo Contacto u Oferta con los campos y punteros requeridos (empresa, contacto, asignadoA), luego guarda.
JavaScriptasync function createDeal(title, stage = 'lead', amount) { const Deal = Parse.Object.extend('Deal'); const deal = new Deal(); deal.set('title', title); deal.set('stage', stage); if (amount != null) deal.set('amount', amount); await deal.save(); return deal; } async function createContact(name, email, phone) { const Contact = Parse.Object.extend('Contact'); const contact = new Contact(); contact.set('name', name); if (email) contact.set('email', email); if (phone) contact.set('phone', phone); await contact.save(); return contact; }Paso 5: Actualizar la etapa de la oferta y actividades
Actualiza Deal.stage al mover en el pipeline; crea y lista Actividad por relacionadoCon.
JavaScript// Update deal stage (e.g. move in pipeline) async function updateDealStage(objectId, stage) { const query = new Parse.Query('Deal'); const deal = await query.get(objectId); deal.set('stage', stage); await deal.save(); } // Delete a deal async function deleteDeal(objectId) { const query = new Parse.Query('Deal'); const deal = await query.get(objectId); await deal.destroy(); }
Integración de Gestión de Estado
Integra el SDK de Back4app con la capa de estado de tu aplicación (por ejemplo, contexto, tienda o servicios) para el estado de pipeline y contacto.
Modelo de Datos Completo
Copia un modelo CRM completo para la serialización segura por tipo (por ejemplo, clase, interfaz o definición de tipo).
// TypeScript interfaces for Deal and Contact (matches Back4app schema)
interface Deal {
objectId?: string;
title: string;
amount?: number;
stage?: string;
expectedCloseDate?: string;
contact?: { __type: string; className: string; objectId: string };
company?: { __type: string; className: string; objectId: string };
assignedTo?: { __type: string; className: string; objectId: string };
createdAt?: string;
updatedAt?: string;
}
interface Contact {
objectId?: string;
name: string;
email?: string;
phone?: string;
company?: { __type: string; className: string; objectId: string };
createdAt?: string;
updatedAt?: string;
}
function toDeal(obj: Parse.Object): Deal {
return {
objectId: obj.id,
title: obj.get('title'),
amount: obj.get('amount'),
stage: obj.get('stage'),
expectedCloseDate: obj.get('expectedCloseDate')?.toISOString?.() ?? undefined,
contact: obj.get('contact'),
company: obj.get('company'),
assignedTo: obj.get('assignedTo'),
createdAt: obj.get('createdAt')?.toISOString?.() ?? undefined,
updatedAt: obj.get('updatedAt')?.toISOString?.() ?? undefined,
};
}Offline-First y Almacenamiento Local
Utiliza pin() y unpin() para que los contactos y las ofertas estén disponibles sin conexión y se sincronicen al volver a estar en línea.
Los SDK compatibles incluyen un almacenamiento local. Fija objetos de Contacto, Oferta y Actividad para mantenerlos en el dispositivo; consulta datos fijados cuando estés sin conexión. Cuando la aplicación vuelva a estar en línea, sincroniza con el servidor.
A continuación: fija resultados después de la búsqueda y deshazte de la fijación cuando ya no necesites copias locales.
// 1. Enable local datastore (e.g. before Parse.initialize)
Parse.enableLocalDatastore();
// 2. After fetching deals, pin them for offline access
async function fetchAndPinDeals() {
const query = new Parse.Query('Deal');
query.equalTo('stage', 'qualified');
query.ascending('expectedCloseDate');
const results = await query.find();
await Parse.Object.pinAll(results);
return results;
}
// 3. When offline (or for instant load), query from local datastore
async function getDealsFromLocal() {
const query = new Parse.Query('Deal');
query.fromLocalDatastore();
return await query.find();
}
// 4. Unpin when no longer needed
async function unpinAllDeals() {
await Parse.Object.unpinAll('Deal');
}Preguntas Frecuentes
Preguntas comunes sobre la plantilla del backend de la aplicación CRM.
¿Listo para construir tu aplicación CRM?
Comienza tu proyecto React en minutos. No se requiere tarjeta de crédito.