Entrega y capacitación

La entrega es el momento que el cliente más recuerda. Un proyecto excelente entregado con prisas ("ahí está tu sitio, cualquier cosa me avisas") se percibe peor que un proyecto bueno entregado con orden, documentación y una capacitación clara. Esta lección te da el proceso y las plantillas para cerrar como profesional.

Concepto

Una buena entrega tiene cinco partes:

1. Verificación final (todo funciona en producción).
2. Transferencia de accesos (el cliente es dueño de todo).
3. Capacitación (sabe usar lo que pagó).
4. Documentación (manual de usuario y documentación técnica).
5. Cierre formal (acta de entrega, testimonio, siguiente paso).

1. Checklist de entrega

• [ ] Pago final recibido.
• [ ] Sitio publicado en el dominio definitivo con HTTPS.
• [ ] Todas las páginas, formularios y funciones probadas en producción.
• [ ] Correos del formulario llegando a la bandeja correcta (y no a spam).
• [ ] Analítica y Google Search Console configurados.
• [ ] Respaldo inicial realizado y respaldos automáticos activos.
• [ ] Datos de prueba eliminados (usuarios "test", pedidos de prueba).
• [ ] Modo depuración desactivado.
• [ ] Cuenta de administrador del cliente creada con su correo.
• [ ] Repositorio transferido o con acceso para el cliente (si así se acordó).

Para la parte técnica, usa la Checklist de producción.

2. Transferencia de accesos

Entrega un documento de accesos (las contraseñas van en el gestor de contraseñas, no en el documento):

DOCUMENTO DE ACCESOS — Dental Sonrisa
Fecha de entrega: 22/11/2026

Servicio            | URL                            | Usuario / cuenta           | Contraseña
--------------------|--------------------------------|----------------------------|-----------------------
Dominio             | registrador.com                | ana@dentalsonrisa.com      | En Bitwarden: "Dominio"
Hosting / servidor  | panel del proveedor            | ana@dentalsonrisa.com      | En Bitwarden: "Hosting"
Panel del sitio     | dentalsonrisa.com/admin        | ana@dentalsonrisa.com      | En Bitwarden: "Panel"
Correo corporativo  | Google Workspace               | citas@dentalsonrisa.com    | En Bitwarden: "Correo"
Google Analytics    | analytics.google.com           | Propietario: ana@...       | Cuenta de Google
Search Console      | search.google.com/search-console | Propietario: ana@...     | Cuenta de Google
Repositorio         | github.com/dentalsonrisa/sitio | Organización del cliente   | —

Renovaciones:
- Dominio: vence el 15/10/2027 (renovación automática activada).
- Hosting: vence el 01/11/2027.

El cliente debe ser el propietario

En Google Analytics, Search Console, el registrador del dominio y el hosting, el cliente debe tener el rol de propietario o administrador principal; tú, de colaborador. Si un día dejan de trabajar juntos, el cliente no queda atrapado.

3. Capacitación

Duración recomendada: 45 a 60 minutos por videollamada (o presencial), grabada con permiso del cliente.

Guion de capacitación

1. Recorrido por el sitio publicado (5 min)
   - Qué hay en cada sección y cómo se ve en el celular.

2. Entrar al panel de administración (5 min)
   - URL, usuario, cómo recuperar la contraseña.

3. Tareas frecuentes — el cliente las hace, tú guías (25 min)
   - Publicar una entrada del blog con imagen.
   - Editar un texto o un precio.
   - Cambiar una foto (y por qué deben optimizarse antes de subirse).
   - Ver las citas recibidas por el formulario.

4. Qué NO tocar (5 min)
   - Configuraciones, plugins, código, DNS.

5. Correo corporativo (5 min)
   - Cómo configurarlo en el celular y en Gmail/Outlook.

6. Estadísticas (5 min)
   - Dónde ver cuántas visitas tiene el sitio.

7. Soporte (5 min)
   - Qué cubre la garantía, cómo pedir ayuda y el plan de mantenimiento.

Deja que el cliente maneje

Durante la capacitación, que el cliente use el mouse y haga las tareas mientras tú lo guías. Lo que uno hace, lo recuerda; lo que solo ve, lo olvida al día siguiente.

4. Documentación

Manual de usuario (para el cliente)

Corto, con capturas de pantalla y en lenguaje no técnico. Una página por tarea.

MANUAL DE USUARIO — Sitio Dental Sonrisa

1. Cómo entrar al panel
   1. Abre dentalsonrisa.com/admin
   2. Escribe tu correo y contraseña.
   3. ¿Olvidaste tu contraseña? Haz clic en "Recuperar contraseña".
   [captura]

2. Cómo publicar una entrada en el blog
   1. En el menú izquierdo, haz clic en "Blog" → "Nueva entrada".
   2. Escribe el título (máximo 60 caracteres).
   3. Sube una imagen horizontal (1200 × 630 px, menos de 300 KB).
   4. Escribe el contenido. Usa "Título 2" para los subtítulos.
   5. Haz clic en "Publicar".
   [captura]

3. Cómo optimizar una foto antes de subirla
   1. Entra a squoosh.app
   2. Arrastra tu foto, elige formato WebP y calidad 75.
   3. Descarga y súbela al sitio.

4. Qué hacer si algo no funciona
   - Escribe a soporte@tumarca.com con: qué intentabas hacer, captura
     de pantalla y desde qué dispositivo.
   - Tiempo de respuesta: 24 h hábiles (o según tu plan de mantenimiento).

Documentación técnica (para ti o el siguiente desarrollador)

Un archivo README.md en la raíz del repositorio con, al menos, estas secciones:

# Sitio Dental Sonrisa

## Tecnologías
- Frontend: Astro 5 + Tailwind CSS
- API: Node 22 + Express, PostgreSQL 16
- Servidor: VPS Ubuntu 24.04, Nginx, PM2
- DNS y CDN: Cloudflare

## Instalación local
1. git clone ...
2. npm install
3. cp .env.example .env   (completar valores)
4. npm run dev

## Variables de entorno
- DATABASE_URL: conexión a PostgreSQL
- SMTP_*: envío de correos del formulario
- SENTRY_DSN: monitoreo de errores

## Despliegue
- Push a main → GitHub Actions compila y despliega al VPS.
- Manual: ssh deploy@servidor y ejecutar ~/apps/dental/deploy.sh

## Respaldos
- Diarios a las 03:15 (cron) → almacenamiento externo con rclone.
- Restaurar: ver scripts/restaurar.md

## Contacto
- Desarrollador: [tu nombre] — [correo]

5. Cierre formal

Acta de entrega

Un documento breve que el cliente firma (o aprueba por correo) confirmando que recibió el proyecto. Marca el inicio del periodo de garantía.

ACTA DE ENTREGA

Proyecto: Sitio web Dental Sonrisa
Cliente: Dra. Ana López — Dental Sonrisa
Prestador: [Tu nombre]
Fecha: 22/11/2026

Se hace constar la entrega de:
[x] Sitio web publicado en https://dentalsonrisa.com
[x] Panel de administración con usuario del cliente
[x] Documento de accesos y bóveda de contraseñas compartida
[x] Capacitación de 1 hora (grabación: [enlace])
[x] Manual de usuario (PDF)
[x] Código fuente en el repositorio del cliente

El periodo de garantía de 30 días para corrección de errores inicia
en esta fecha y termina el 22/12/2026.

Firma del cliente: ____________        Firma del prestador: ____________

Pide testimonio y referidos

El mejor momento es justo después de la entrega, cuando el cliente está contento.

Hola, Dra. López:

¡Fue un gusto trabajar en el sitio de Dental Sonrisa! Me alegra mucho
que ya esté recibiendo citas.

Tengo dos pequeños favores que me ayudarían mucho:

1. ¿Podrías escribir 2 o 3 líneas sobre tu experiencia trabajando
   conmigo? Las usaría en mi portafolio. (Si prefieres, déjala como
   reseña en mi perfil de Google: [enlace])

2. Si conoces a otro colega o negocio que necesite un sitio web,
   te agradecería mucho la recomendación.

¡Gracias de nuevo!

Facilita el testimonio con preguntas guía: ¿qué problema tenías antes?, ¿cómo fue trabajar conmigo?, ¿qué resultado has visto?

Ofrece el siguiente paso

Al cerrar, presenta el plan de mantenimiento (ver Mantenimiento y soporte) y agenda un seguimiento a 30 días para revisar estadísticas juntos. Muchos proyectos nuevos nacen en esa llamada.

Error común

Entregar sin documentación ni capacitación "porque el cliente no la pidió". Semanas después te llamará cada vez que quiera cambiar una coma, y como no hay acuerdo de mantenimiento, ese tiempo no se paga.

Ejercicios

1. Escribe el guion de capacitación para una tienda en línea (productos, pedidos, inventario).
2. Redacta el README técnico de uno de tus proyectos con todas las secciones de la plantilla.
3. Escribe un mensaje para pedir testimonio adaptado a un cliente con el que tienes una relación muy informal.

Ver solución (orientativa)

1. Recorrido, entrar al panel, crear/editar producto con fotos y variantes, gestionar inventario, ver y actualizar el estado de un pedido, reembolsos, cupones, qué no tocar (pasarela de pago, envíos), reportes de ventas, soporte.
2. Debe permitir que otro desarrollador instale el proyecto sin preguntarte nada: tecnologías, instalación, variables de entorno, despliegue y respaldos.
3. "¡Hola, Luis! Qué gusto que la página ya esté funcionando. Oye, ¿me echas la mano con una reseña cortita en Google contándome cómo te fue? Me ayuda un montón para conseguir más clientes. Te dejo el enlace: [...] ¡Gracias, crack!"

Resumen

• Entrega en cinco pasos: verificación, accesos, capacitación, documentación y cierre.
• El cliente debe ser propietario de dominio, hosting y cuentas; contraseñas en un gestor.
• Capacitación grabada donde el cliente hace las tareas.
• Manual de usuario sencillo y README técnico completo.
• Acta de entrega, testimonio, referidos y propuesta de mantenimiento.
• Siguiente: Mantenimiento y soporte.