Guía de Usuario (Acceso private)

¡Bienvenido a la sección confidencial de la documentación de AA Digital Business! Esta guía está diseñada para que el equipo pueda gestionar fácilmente el contenido de la plataforma.

1. Acceso al Panel de Administración

Nuestra plataforma está basada en un enfoque Git-First y una arquitectura estática rápida (Astro). Para editar el contenido de forma amigable sin tocar código, utilizaremos un Gestor de Contenidos Visual (como Keystatic o Decap CMS).

1. Navega a la URL de administración (ej. [tudominio].com/admin o [tudominio].com/keystatic).
2. Inicia sesión usando la opción requerida (GitHub, o tu correo autenticado).
3. Una vez dentro, verás el panel de control con las distintas colecciones de tu sitio web (Documentación, Páginas públicas, etc.).

2. Creación y Actualización de Contenido

Crear una nueva página o documento

1. En el panel lateral del CMS, selecciona la colección en la que deseas trabajar (por ejemplo, Docs).
2. Haz clic en el botón “Create New” (Crear nuevo).
3. Rellena los campos principales:
   • Título: El nombre principal recurrente en la interfaz.
   • URL / Slug: La dirección web del contenido (usualmente se auto-genera).
4. Usa el editor visual para redactar el cuerpo de la página. Puedes usar los formatos habituales de texto, insertar bloques de código, alertas y subir imágenes arrastrándolas desde tu escritorio.

Actualizar una página existente

1. En la lista de contenido de tu CMS, haz clic en la página que deseas modificar.
2. Realiza los cambios necesarios dentro del editor.
3. Haz clic en “Save” (Guardar). Nota técnica: Al guardar, el CMS crea internamente un “Commit” en GitHub, lo que le indica a Cloudflare Pages que debe reconstruir el sitio. En 1-2 minutos la versión en vivo reflejará tus cambios.

3. Gestionar SEO y Metadata

El SEO (Search Engine Optimization) es vital para las páginas públicas. En el editor de cada documento, verás una sección o campos específicos para esto:

• Title (Título SEO): Lo que verán los usuarios en la pestaña del navegador y en el título azul grande de Google. Limítalo a 50-60 caracteres.
• Description (Descripción SEO): Un párrafo breve y persuasivo de lo que trata la página. Debe invitar al clic. Mantenlo por debajo de 160 caracteres.
• Imagen Social (OG Image): Es la foto en miniatura que aparece en WhatsApp, Slack o LinkedIn cuando alguien pega el enlace de tu página.

Recomendación: Asegúrate de completar estos campos en cada página pública para asegurar un buen rendimiento orgánico.

4. La Sección Autenticada (Cloudflare Zero Trust)

Esta página que estás leyendo se encuentra dentro de la carpeta /private/. Para lograr que sólo usuarios autenticados la vean sin usar bases de datos complejas, implementamos Cloudflare Access (Zero Trust) a nivel de CDN.

¿Cómo funciona la seguridad?

1. Todas las peticiones a tudominio.com/private/* son detenidas por la red perimetral de Cloudflare.
2. Si el visitante no tiene una cookie de sesión criptográfica válida, es redirigido a una pasarela de “Login” alojada por Cloudflare.
3. El visitante introduce su correo; si está en la lista blanca, recibe un código PIN de un solo uso (One-Time PIN).
4. Al verificarlo, Cloudflare le permite cruzar la barrera y visualizar la documentación confidencial.

¿Cómo dar acceso a nuevos usuarios privates?

Para añadir lectores o colaboradores a esta u otras secciones privadas:

1. Ingresa a tu panel de administración en Cloudflare.
2. Ve a la sección Zero Trust > Access > Applications.
3. Selecciona la aplicación que protege el directorio private.
4. En sus Políticas (Policies), podrás añadir correos electrónicos individuales (ejemplo@cliente.com) o dominios enteros (ej. @tuempresa.com) que estarán autorizados para entrar.

---

Tip: Al mantener los datos confidenciales protegidos por Cloudflare Edge y construidos estáticamente, reduces casi al 0% el riesgo de ataques comunes por fuerza bruta a bases de datos o vulnerabilidades de inyección en servidores de aplicaciones.