Mini Proyecto Final: Desarrolladora Salesforce 2025

 

🎯

Un proyecto pequeño pero completo que combine lo aprendido: LWC + Apex + Flow + Einstein GPT + DevOps.

---

🔧 🔌 Proyecto: “Gestor Inteligente de Citas con Clientes”

📌 ¿Qué hace?

• El usuario elige un cliente desde una interfaz LWC.

• Se consulta disponibilidad desde una API externa (simulada o real).

• Se genera una recomendación de cita ideal usando Einstein GPT.

• Se guarda todo con Flow y se dispara una notificación por Slack o email.

---

🧩 Componentes del Proyecto

Parte	Tecnología	Descripción
1. UI	LWC	Lista de clientes + selector de fecha
2. Backend	Apex	Llama a una API externa (simulada o real)
3. Automatización	Flow	Guarda la cita y genera notificación
4. IA	Einstein GPT	Sugiere fecha y hora óptima
5. DevOps	DevOps Center	Versiona y despliega tu proyecto

---

🧪 ¿Cómo empezar?

1. Crear el LWC con selector de cliente (Account o Contact)

2. Escribir un método Apex que simule disponibilidad horaria

3. Configurar un Flow que guarde la cita

4. Usar un prompt con Einstein GPT para sugerir la mejor hora

5. Versionar tu código en DevOps Center o GitHub

---

PLANTILLA PROYECTO GESTOR DE CITAS SALESFORCE

🧩 ¿Qué incluye esta plantilla?

1. Apex Controller (CitaController)

   • obtenerClientes(): Lista cuentas (clientes)

   • consultarDisponibilidad(): Simula horarios disponibles

   • sugerirCitaConEinstein(): Simula sugerencia de cita usando Einstein GPT

2. Flow sugerido (no-code):

   • Crea un registro de Cita__c

   • Usa clienteId y fechaHora

   • Puedes añadir notificación por correo o Slack

---

✅ Próximos pasos:

• Crear un componente LWC que consuma este controller

• Crear un Flow llamado Guardar Cita que cree el registro

• Si tienes Einstein GPT habilitado, puedes reemplazar la función simulada por un prompt real

• Opcional: Añadir conexión real a una API externa usando Named Credential

Proyecto Gestor Citas Salesforce

✅ He añadido el componente LWC base (gestorCitas) a tu plantilla.
Con esto ya tienes:

• Apex Controller (CitaController) para clientes, disponibilidad y sugerencia.

• LWC (gestorCitas.html y gestorCitas.js) que muestra clientes, consulta disponibilidad y obtiene una sugerencia simulada de Einstein.

• Flow sugerido para guardar la cita.

Archivo 

// ApexController.cls

public with sharing class CitaController {
    @AuraEnabled(cacheable=true)
    public static List<Account> obtenerClientes() {
        return [SELECT Id, Name FROM Account LIMIT 50];
    }
    @AuraEnabled
    public static String consultarDisponibilidad(String clientId) {
        // Simulación de consulta a una API externa
        List<String> horarios = new List<String>{'10:00 AM', '11:30 AM', '3:00 PM'};
        return 'Disponible en: ' + String.join(horarios, ', ');
    }
    @AuraEnabled
    public static String sugerirCitaConEinstein(String nombreCliente) {
        // Simulación de sugerencia (el prompt real se haría con Apex + GPT API si tienes licencia)
        return 'Sugerencia: El mejor horario para ' + nombreCliente + ' es mañana a las 11:30 AM';
    }
}

/* Flow sugerido:

 - Name: Guardar Cita

 - Variables: clienteId, fechaHora

 - Acción: Create Record -> Objeto personalizado Cita__c

 - Opcional: Enviar correo o notificación de Slack */

// LWC: gestorCitas.html

<template>
    <lightning-card title="Gestor Inteligente de Citas">
        <lightning-combobox
            name="clientes"
            label="Selecciona un cliente"
            value={clienteSeleccionado}
            placeholder="Selecciona"
            options={opcionesClientes}
            onchange={handleClienteChange}>
        </lightning-combobox>
        <lightning-button label="Consultar Disponibilidad" onclick={consultarDisponibilidad}></lightning-button>
        <p>{disponibilidad}</p>
        <lightning-button label="Sugerir con Einstein" onclick={sugerirCita}></lightning-button>
        <p>{sugerencia}</p>
    </lightning-card>
</template>

// LWC: gestorCitas.js

import { LightningElement, track } from 'lwc';
import obtenerClientes from '@salesforce/apex/CitaController.obtenerClientes';
import consultarDisponibilidadApex from '@salesforce/apex/CitaController.consultarDisponibilidad';
import sugerirCitaConEinstein from '@salesforce/apex/CitaController.sugerirCitaConEinstein';
export default class GestorCitas extends LightningElement {
    @track clienteSeleccionado;
    @track opcionesClientes = [];
    @track disponibilidad;
    @track sugerencia;
    connectedCallback() {
        obtenerClientes()
            .then(result => {
                this.opcionesClientes = result.map(cliente => ({ label: cliente.Name, value: cliente.Id }));
            })
            .catch(error => {
                console.error('Error al cargar clientes', error);
            });
    }
    handleClienteChange(event) {
        this.clienteSeleccionado = event.detail.value;
    }
    consultarDisponibilidad() {
        consultarDisponibilidadApex({ clientId: this.clienteSeleccionado })
            .then(result => {
                this.disponibilidad = result;
            })
            .catch(error => {
                console.error('Error en disponibilidad', error);
            });
    }
    sugerirCita() {
        sugerirCitaConEinstein({ nombreCliente: this.clienteSeleccionado })
            .then(result => {
                this.sugerencia = result;
            })
            .catch(error => {
                console.error('Error en sugerencia', error);
            });
    }
}

✅ He añadido el archivo gestorCitas.js-meta.xml, con configuración para exponer tu componente en:

• 🔹 Record Page

• 🔹 App Page

• 🔹 Home Page

De esta forma ya podrás arrastrar el componente desde el App Builder en Salesforce.

// LWC: gestorCitas.js-meta.xml

<?xml version="1.0" encoding="UTF-8"?>
<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
    <apiVersion>59.0</apiVersion>
    <isExposed>true</isExposed>
    <targets>
        <target>lightning__RecordPage</target>
        <target>lightning__AppPage</target>
        <target>lightning__HomePage</target>
    </targets>
</LightningComponentBundle>

✅ He preparado también el objeto personalizado Cita__c con campos básicos:

• 🔗 Cliente__c → Lookup a Account

• 📅 FechaHora__c → DateTime

• 🏷️ Estado__c → Picklist con valores Pendiente, Confirmada, Cancelada

Con esto ya tienes el ciclo completo: Apex + LWC + Flow + Objeto personalizado 🎯.

// Objeto personalizado: Cita__c (archivo de metadatos Cita__c.object-meta.xml)

<type>Text</type>
<label>Nombre de la Cita</label>
</nameField>
<deploymentStatus>Deployed</deploymentStatus>
<sharingModel>ReadWrite</sharingModel>
<fields>
<fullName>Cliente__c</fullName>
<externalId>false</externalId>
<label>Cliente</label>
<referenceTo>Account</referenceTo>
<relationshipLabel>Citas</relationshipLabel>
<relationshipName>Citas</relationshipName>
<required>true</required>
<trackHistory>false</trackHistory>
<trackTrending>false</trackTrending>
<type>Lookup</type>
</fields>
<fields>
<fullName>FechaHora__c</fullName>
<label>Fecha y Hora</label>
<required>true</required>
<trackHistory>true</trackHistory>
<type>DateTime</type>
</fields>
<fields>
<fullName>Estado__c</fullName>
<label>Estado</label>
<type>Picklist</type>
<valueSet>
<valueSetDefinition>
<sorted>false</sorted>
<value>
<fullName>Pendiente</fullName>
<default>true</default>
<label>Pendiente</label>
</value>
<value>
<fullName>Confirmada</fullName>
<default>false</default>
<label>Confirmada</label>
</value>
<value>
<fullName>Cancelada</fullName>
<default>false</default>
<label>Cancelada</label>
</value>
</valueSetDefinition>
</valueSet>
</fields>
</CustomObject>

✅ Ya tienes también el Flow de ejemplo (Guardar_Cita.flow-meta.xml) que:

• Recibe como entrada clienteId y fechaHora.

• Crea un registro en el objeto Cita__c.

• Asigna el estado inicial como Pendiente.

Con esto tu mini-proyecto queda completo: Apex + LWC + Flow + Objeto personalizado 🚀.

// Flow de ejemplo: Guardar_Cita.flow-meta.xml

<?xml version="1.0" encoding="UTF-8"?>

<Flow xmlns="http://soap.sforce.com/2006/04/metadata">

<apiVersion>59.0</apiVersion>

<label>Guardar Cita</label>

<processType>Flow</processType>

<status>Active</status>

<variables>

<name>clienteId</name>

<dataType>String</dataType>

<isCollection>false</isCollection>

<isInput>true</isInput>

<isOutput>false</isOutput>

</variables>

<variables>

<name>fechaHora</name>

<dataType>DateTime</dataType>

<isCollection>false</isCollection>

<isInput>true</isInput>

<isOutput>false</isOutput>

</variables>

<records>

<name>CreateCita</name>

<label>Create Cita</label>

<locationX>150</locationX>

<locationY>100</locationY>

<connector>

<targetReference>END</targetReference>

</connector>

<faultConnector>

<targetReference>END</targetReference>

</faultConnector>

<object>Cita__c</object>

<storeOutputAutomatically>true</storeOutputAutomatically>

<inputAssignments>

<field>Cliente__c</field>

<value>{!clienteId}</value>

</inputAssignments>

<inputAssignments>

<field>FechaHora__c</field>

<value>{!fechaHora}</value>

</inputAssignments>

<inputAssignments>

<field>Estado__c</field>

<value>Pendiente</value>

</inputAssignments>

</records>

<start>

<connector>

<targetReference>CreateCita</targetReference>

</Flow>

Desplegar todo esto en un sandbox con SFDX paso a paso

---

🔧 1. Pre-requisitos

• Tener instalado Salesforce CLI (SFDX) → descargar aquí

• Tener VS Code con la extensión Salesforce Extension Pack

• Tener un sandbox o scratch org disponible

---

🔑 2. Conectar con tu sandbox

En tu terminal (VS Code o CMD):

sfdx auth:web:login -r https://test.salesforce.com -a MiSandbox

• Se abrirá el navegador → inicia sesión en tu sandbox.

• -a MiSandbox es un alias para que sea más fácil referenciarlo.

---

📂 3. Estructura del proyecto

Tu proyecto debe tener una carpeta force-app/main/default/ con esta estructura:

force-app/
 └── main/
     └── default/
         ├── classes/
         │   └── CitaController.cls
         │   └── CitaController.cls-meta.xml
         ├── lwc/
         │   └── gestorCitas/
         │       ├── gestorCitas.html
         │       ├── gestorCitas.js
         │       ├── gestorCitas.js-meta.xml
         ├── objects/
         │   └── Cita__c/
         │       └── Cita__c.object-meta.xml
         └── flows/
             └── Guardar_Cita.flow-meta.xml

---

📤 4. Desplegar al sandbox

Una vez dentro del proyecto:

sfdx force:source:push -u MiSandbox

Esto desplegará Apex, LWC, Objeto y Flow al sandbox.

---

✅ 5. Verificación en Salesforce

1. Entra al sandbox (https://test.salesforce.com).

2. Ve a App Builder → agrega el componente GestorCitas a una App Page o Record Page.

3. Revisa que el objeto Cita__c aparezca en Object Manager.

4. Abre Flows → confirma que Guardar Cita está activo.

---

🔄 6. Opcional: desplegar solo un componente

Si quieres desplegar solo un archivo (ejemplo, el Apex):

sfdx force:source:deploy -p force-app/main/default/classes/CitaController.cls -u MiSandbox

🙌 Te preparo el package.xml para desplegar todo con Metadata API (por ejemplo usando sfdx force:mdapi:deploy).

📦 package.xml

Guárdalo en la raíz de tu proyecto (manifest/package.xml):
<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>CitaController</members>
        <name>ApexClass</name>
    </types>
    <types>
        <members>gestorCitas</members>
        <name>LightningComponentBundle</name>
    </types>
    <types>
        <members>Cita__c</members>
        <name>CustomObject</name>
    </types>
    <types>
        <members>Guardar_Cita</members>
        <name>Flow</name>
    </types>
    <version>59.0</version>
</Package>

🚀 1. Convertir a formato MDAPI

Si tu proyecto está en formato SFDX (source format), conviértelo a Metadata API format:

sfdx force:source:convert -r force-app -d mdapi_output

🚀 2. Desplegar con Metadata API

package.xml

sfdx force:mdapi:deploy -d mdapi_output -u MiSandbox -w 10

-u MiSandbox → tu alias de sandbox.
-w 10 → espera 10 minutos (ajústalo según necesites).

✅ 3. Verificación

Después del despliegue:

Ve a Setup → Object Manager → busca Cita__c.
Revisa Flows → debe estar Guardar Cita activo.
Ve al App Builder → añade tu LWC gestorCitas.



Entonces ya tienes todo: Apex + LWC + Flow + Objeto + package.xml para desplegar en tu sandbox 🚀.