Qué vamos a construir

Esta guía construye, desde cero y sin saltarse pasos, la app Gestão de Clientes (Gestión de Clientes) — un CRM con cuentas, contactos y oportunidades de negocio. Es la misma app que ilustra toda esta documentación: cada figura que veas en los otros capítulos viene de ella.

Al final de la guía tienes una aplicación funcionando en una dirección propia, con su pantalla de login, sus usuarios y sus datos — lista para ser usada por quien nunca ha oído hablar de Keplin.

#La app en dos frases

La Gestión de Clientes gestiona empresas (cuentas), las personas de esas empresas (contactos) y los negocios en curso con ellas (oportunidades). El equipo comercial consulta y edita todo en cuatro pantallas — un dashboard, una lista de cuentas, una ficha de cuenta y un tablero kanban de oportunidades — y recibe todas las mañanas un resumen automático de lo que está por calificar.

#Qué queda hecho, etapa a etapa

La guía está partida en seis etapas. Cada una es una página de este capítulo, y cada una termina con algo funcionando — puedes parar entre etapas y retomar más tarde.

Etapa	Qué construyes	Qué aprendes por el camino
Crear la app	La app vacía, con nombre, icono y descripción.	El espacio de trabajo: el árbol lateral, las pestañas y la Vista general.
El modelo de datos	Una base de datos de la app con 3 tablas y 2 relaciones.	Crear tablas y columnas, importar tablas al modelo, conectar entidades.
Las pantallas	Las APIs de tabla y las 4 pantallas: dashboard con KPIs, tabla de cuentas, ficha de cuenta y kanban.	Datastores, widgets, conexiones a datos, acciones de tabla, parámetros de ruta.
Navegación y tema	El menú de la app, el logo y los colores de la marca.	El editor de navegación por dispositivo y el editor de tema.
Lógica y automatización	Un script Python que cuenta oportunidades por calificar y avisa al equipo, programado para las mañanas laborables.	El editor de scripts, ejecuciones, y programaciones con recuperación.
Publicar y usar	La app publicada, con el primer usuario y el primer login.	Versiones, publicación en hosts, usuarios de la app y roles.

#El modelo de datos en resumen

Tres tablas bastan para un CRM funcional — y para tocar casi todo lo que el modelo de datos de Keplin sabe hacer:

Tabla	Qué guarda	Se conecta a
contas	Las empresas: nombre, NIF, sector, ciudad, contactos generales.	—
contactos	Las personas de cada empresa: nombre, cargo, correo, móvil.	Cada contacto pertenece a una cuenta.
oportunidades	Los negocios: título, valor, fase (kanban) y fecha prevista de cierre.	Cada oportunidad pertenece a una cuenta.

El campo fase de las oportunidades es lo que da vida al tablero kanban: cada valor es una columna del tablero, y arrastrar una tarjeta de columna en columna guarda la nueva fase en el registro. Las seis fases de nuestro CRM son prospecao, qualificacao, proposta, negociacao, fechada_ganha y fechada_perdida.

#Qué necesitas antes de empezar

1. Una cuenta en la plataforma con perfil de administrador o developer — si aún no has entrado, el capítulo Primeros pasos muestra cómo.
2. Nada más. La base de datos de la app se crea dentro de la propia app, durante la guía — no necesitas servidor de base de datos, ni archivos, ni credenciales externas.

¿Listo? Sigue a la página siguiente — Crear la app.