Jeacel Hosting • Código JCL-DOC-MASTER-00

MANUAL INTEGRAL DE OPERACIONES, ARQUITECTURA Y SOPORTE TÉCNICO

Documento maestro consolidado — Módulos Web, Enrutamiento DNS, Variables y Edge Computing

1. Introducción y Marco Operacional

El presente Manual Maestro de Operaciones recopila de manera integral las directrices técnicas, procedimientos normados y protocolos de resolución de incidencias que rigen la totalidad de los servicios de Jeacel Hosting. Su propósito es proveer a los equipos de ingeniería y soporte un marco unificado de referencia bajo los más altos estándares de calidad y seguridad.

2. Módulo de Hospedaje Web y Despliegues Continuos

El sistema de alojamiento web automatiza la integración con repositorios de código, la compilación de paquetes y la distribución de activos estáticos en la red global.

Flujo Estándar: Creación de proyecto -> Parámetros de build ('npm run build') -> Directorio de salida ('dist') -> Activación.
Resolución de Timeout: Optimización de scripts no interactivos y depuración de dependencias.
Diagnóstico de Errores: Lectura en tiempo real de la consola de construcción para corrección temprana.

3. Módulo de Dominios, DNS y Certificación SSL

Administración de identidades de marca mediante enrutamiento inteligente CNAME con diagnóstico en tiempo real.

Propagación Global: Periodo de convergencia mundial normado de 5 a 30 minutos.
Verificación Activa: Motor de consulta directo a servidores autoritativos.
Seguridad SSL/TLS: Criptografía automática de 256 bits y renovación transparente.

4. Módulo de Variables de Entorno y Almacén de Secretos

Gestión centralizada y encriptada de llaves de acceso y parámetros confidenciales.

Política de Redespliegue: Notificación interactiva mediante banner para inyección atómica en contenedores.
Ocultamiento Preventivo: Máscaras visuales para mitigar fugas de información.

5. Módulo de Edge Functions y Cómputo Perimetral

Ejecución serverless de microservicios y pasarelas inteligentes en el borde de la red de Jeacel Hosting.

Soporte TypeScript: Transpilación transparente en el navegador sin fricción.
Firmas de 19 Caracteres: Protección contra ataques de enumeración y aislamiento estricto de rutas.
Protocolo CORS: Estandarización de cabeceras para consumo seguro desde aplicaciones web.

6. Protocolos de Respuesta Rápida para Soporte

Comprobar la consola de registros ('Logs') del proyecto o función afectada.
Para problemas de dominio, validar la ausencia de registros 'A' duplicados y respetar el tiempo de propagación.
Para problemas de variables, verificar la ejecución del redespliegue atómico.
Para Edge Functions, revisar encabezados CORS y la correcta asignación de secretos en el entorno.

Módulo 1 • Código JCL-DOC-WEB-01

MANUAL DE OPERACIONES: DESPLIEGUE DE PÁGINAS WEB Y PROYECTOS

Guía oficial de publicación continua, gestión de compilación y resolución de incidencias

1. Descripción General del Servicio de Hospedaje Web

El entorno de alojamiento web de Jeacel Hosting proporciona una arquitectura de distribución global de alto rendimiento diseñada para compilar, empaquetar y entregar aplicaciones web con latencias mínimas y alta disponibilidad.

2. Procedimiento Operativo para la Creación y Despliegue de Proyectos

Para publicar un nuevo sitio web en la red de Jeacel Hosting, el desarrollador debe seguir rigurosamente los siguientes pasos establecidos:

Paso 1. Inicialización del Asistente: Diríjase al panel de control principal y haga clic en el botón superior '+ Nuevo Proyecto'. Esto inicializará el asistente de configuración.

Paso 2. Selección de la Fuente de Código: Vincule o seleccione el repositorio de código fuente donde residen los archivos de la aplicación.

Paso 3. Configuración de Parámetros de Compilación: Especifique los tres parámetros esenciales de construcción:
a) Nombre del Proyecto: Identificador unívoco dentro de la organización. b) Comando de Compilación (Build Command): Instrucción formal de empaquetado (por ejemplo, 'npm run build' o 'vite build'). c) Directorio de Salida (Destination Dir): Carpeta resultante donde el compilador deposita los archivos estáticos listos para producción (por ejemplo, 'dist', 'build' o 'public').

Paso 4. Ejecución del Despliegue: Presione el botón 'Crear Despliegue'. El motor de automatización ejecutará la instalación de paquetes, la compilación y el aprovisionamiento de rutas en los nodos perimetrales.

Nota Técnica. Todo proyecto nuevo recibe de manera automática una dirección web segura optimizada con compresión HTTP/3 y protocolos criptográficos TLS modernos.

3. Ciclo de Vida y Estados del Proyecto

La plataforma clasifica el estado operacional de cada proyecto bajo cuatro categorías normadas:

Ready (Operativo / Indicador Verde): El proyecto completó satisfactoriamente su proceso de compilación y se encuentra respondiendo peticiones activas a nivel global.
Building (En Compilación / Indicador Azul): El proceso de empaquetado y distribución está en ejecución activa.
Paused (Suspendido / Indicador Ámbar): El servicio ha sido pausado voluntariamente por el administrador, mostrando una página de cortesía.
Error (Falla / Indicador Rojo): Ocurrió una interrupción crítica durante el proceso de despliegue.

4. Protocolo de Diagnóstico y Resolución de Errores

A continuación, se detalla la matriz oficial de incidencias asociadas al ciclo de despliegue web junto a sus respectivas soluciones técnicas normadas:

Tabla 1

Matriz de Diagnóstico y Resolución de Incidentes de Despliegue Web

Incidente / Error	Causa Técnica Principal	Procedimiento de Solución
Timeout / Tiempo de Espera Agotado	El proceso de compilación superó el límite máximo de ejecución debido a descargas excesivas o scripts interactivos en segundo plano.	1. Verifique que el comando de compilación no inicie servidores persistentes (utilice 'npm run build' en lugar de 'npm start'). 2. Optimice dependencias pesadas en el package.json. 3. Ejecute un nuevo despliegue.
Build Failed (Error en Compilación)	Incompatibilidad de sintaxis, ausencia de dependencias obligatorias o falta de variables de entorno requeridas.	1. Acceda a la pestaña 'Despliegues' y pulse 'Ver Logs' en el intento fallido. 2. Localice la línea exacta del compilador con el error de sintaxis. 3. Configure las variables de entorno faltantes y fuerce el redespliegue.
Directorio de Salida No Encontrado (404)	Discrepancia entre la carpeta de salida configurada en Jeacel Hosting y la generada por el framework.	1. Ingrese a la pestaña 'Configuración' del proyecto. 2. Ajuste el 'Destination Dir' según su framework (Vite/React: 'dist', CRA: 'build', Estático: 'public'). 3. Guarde y re-despliegue.

Módulo 2 • Código JCL-DOC-DNS-02

MANUAL DE OPERACIONES: DOMINIOS PERSONALIZADOS, DNS Y CERTIFICADOS SSL

Protocolo formal para el enrutamiento de dominios corporativos, diagnóstico en tiempo real y seguridad criptográfica

1. Fundamentos del Sistema de Nombres de Dominio (DNS)

Jeacel Hosting permite asociar dominios personalizados de segundo y tercer nivel (por ejemplo, 'empresa.com' o 'servicios.empresa.com') a cualquier proyecto hospedado, proporcionando identidad de marca y enrutamiento inteligente.

2. Procedimiento Paso a Paso para la Vinculación de Dominios

La incorporación de un dominio personalizado requiere la ejecución de la siguiente secuencia técnica:

Paso 1. Acceso a la Configuración: Acceda al proyecto deseado y diríjase a la pestaña superior 'Configuración' (Settings).

Paso 2. Registro del Dominio: En el apartado 'Dominios Personalizados', escriba el nombre de dominio en la casilla designada y presione 'Añadir Dominio'.

Paso 3. Generación de Registros de Enrutamiento: La plataforma presentará de inmediato el registro CNAME de destino que debe enlazarse.

Paso 4. Configuración en el Proveedor de Dominio: Inicie sesión en el panel del registrador de su dominio y agregue un registro CNAME asignando como 'Host' el valor '@' o el subdominio correspondiente, y como 'Destino' el endpoint indicado por Jeacel Hosting.

Paso 5. Validación en Tiempo Real: En el panel de Jeacel Hosting, haga clic en el botón 'Verificar DNS' para iniciar la comprobación en tiempo real a través de los servidores de resolución globales.

Aviso de Propagación. AVISO FORMAL SOBRE PROPAGACIÓN DNS: Los cambios en los registros de nombres globales requieren un tiempo de propagación estándar que oscila entre 5 y 30 minutos (y hasta 24 horas en casos de caché residual profunda en proveedores de internet). La plataforma verifica de forma continua hasta detectar la propagación completa.

3. Emisión y Renovación de Certificados SSL/TLS

Tras la confirmación exitosa de los registros DNS, el módulo criptográfico de Jeacel Hosting aprovisiona automáticamente un certificado SSL/TLS de 256 bits, garantizando la navegación bajo HTTPS sin requerir gestión manual de llaves ni costos adicionales.

4. Catálogo de Errores DNS y Protocolo de Resolución

Tabla 2

Matriz de Diagnóstico y Resolución de Problemas de Dominio y Certificados

Incidente / Error	Causa Técnica Principal	Procedimiento de Solución
DNS Not Pointing / Sin Apuntamiento	El registro CNAME aún no se ha creado en el registrador o existe un error tipográfico en el valor de destino.	1. Verifique en su proveedor que el tipo sea estrictamente 'CNAME'. 2. Compruebe que el destino coincida carácter por carácter con la instrucción de Jeacel Hosting. 3. Aguarde 10 minutos y pulse 'Verificar DNS'.
Advertencia de Certificado Pendiente / SSL	El dominio apunta a la red pero el proceso de validación criptográfica se encuentra en curso.	1. No modifique los registros durante la emisión. 2. La emisión concluye en un lapso de 2 a 5 minutos. 3. Limpie la caché del navegador o verifique en una ventana privada.
Conflicto de Registros Duplicados	Coexistencia de registros tipo 'A' obsoletos con el nuevo registro 'CNAME' de Jeacel Hosting para el mismo subdominio.	1. Elimine registros 'A' anteriores que apunten a servidores en desuso. 2. Conserve únicamente el registro oficial entregado por Jeacel Hosting. 3. Guarde y revalide la comprobación.

Módulo 3 • Código JCL-DOC-ENV-03

MANUAL DE OPERACIONES: VARIABLES DE ENTORNO Y GESTIÓN DE SECRETOS

Guía técnica sobre almacenamiento encriptado, inyección en tiempo de ejecución y política de redespliegue

1. Principios de Seguridad y Variables de Entorno

Las variables de entorno constituyen el mecanismo estándar de la industria para separar la configuración sensible (como credenciales de bases de datos, llaves de autenticación y claves privadas) del código fuente, impidiendo filtraciones en repositorios compartidos.

2. Procedimiento para la Administración de Variables

El registro y manipulación de variables de entorno en Jeacel Hosting se efectúa mediante el siguiente procedimiento:

Paso 1. Acceso al Módulo de Variables: Ingrese al proyecto correspondiente y seleccione la pestaña 'Variables de Entorno'.

Paso 2. Declaración de la Clave (Key): Escriba el nombre del identificador en letras MAYÚSCULAS y guiones bajos (ejemplo: 'DATABASE_URL', 'API_KEY_AUTH').

Paso 3. Inserción del Valor Confidencial: Pegue el valor confidencial en el campo de texto adyacente.

Paso 4. Encriptación y Almacenamiento: Haga clic en 'Añadir Variable'. El valor será encriptado de forma inmediata en el almacén seguro.

Política de Redespliegue. POLÍTICA OBLIGATORIA DE REDESPLIEGUE: Toda inserción, edición o eliminación de variables genera un Banner Ámbar en el encabezado del proyecto advirtiendo que los contenedores de producción requieren actualizarse. Para que la aplicación reconozca los nuevos valores, el usuario debe pulsar obligatoriamente el botón 'Re-desplegar Ahora'.

3. Control de Visibilidad y Protección de Datos

Para resguardar la confidencialidad ante espectadores o grabaciones de pantalla, los valores se presentan ofuscados con caracteres de protección (••••••••). El administrador puede presionar el icono del ojo para revelar momentáneamente la información cuando requiera validar su contenido.

4. Catálogo de Errores y Solución en Variables de Entorno

Tabla 3

Matriz de Resolución de Conflictos en Variables de Entorno

Incidente / Error	Causa Técnica Principal	Procedimiento de Solución
Variable No Detectada por la Aplicación	Se registró la variable en el panel pero no se ejecutó la acción de redespliegue requerida.	1. Compruebe la presencia del Banner Ámbar en el panel del proyecto. 2. Presione el botón 'Re-desplegar Ahora'. 3. Si utiliza frameworks como Vite/React, asegúrese de que las variables públicas posean el prefijo exigido (por ejemplo, 'VITE_API_URL').
Error de Caracteres Inválidos o Espacios Ocultos	Existencia de espacios en blanco accidentales al inicio o final de la clave o valor.	1. Elimine la variable afectada. 2. Reingrese los datos verificando que no existan saltos de línea ni espacios periféricos. 3. Guarde y redespliegue.

Módulo 4 • Código JCL-DOC-EDG-04

MANUAL DE OPERACIONES: EDGE FUNCTIONS Y CÓMPUTO SERVERLESS GLOBAL

Guía técnica de arquitectura perimetral, compilación en tiempo real, consumo y resolución de errores

1. Definición y Arquitectura de las Edge Functions

Las Edge Functions de Jeacel Hosting son módulos de ejecución de código sin servidor (serverless) que corren directamente en los puntos de presencia perimetrales distribuidos a nivel mundial, garantizando respuestas ultrarrápidas a escasos milisegundos del cliente.

2. Procedimiento Paso a Paso para la Creación y Despliegue

El desarrollo de una Edge Function se estructura en las siguientes fases operativas:

Paso 1. Ingreso al Entorno: En el menú de navegación lateral, seleccione la sección 'Edge Functions'.

Paso 2. Apertura del Asistente: Haga clic en '+ Nueva Edge Function' para abrir el asistente modal a pantalla completa.

Paso 3. Asignación de Nombre: Asigne un nombre identificador (por ejemplo, 'auth-gateway', 'openrouter', 'pagos').

Paso 4. Elección de Plantilla: Seleccione entre una plantilla optimizada ('Hello Edge', 'OpenRouter AI', etc.) o el modo 'Crear desde Cero'.

Paso 5. Edición de Código y TypeScript: El sistema desplegará el editor a pantalla completa. Puede escribir código tanto en JavaScript moderno como en TypeScript con interfaces y tipos estáticos.

Paso 6. Vinculación de Secretos: En la sección lateral 'Secretos (API Keys)', declare las llaves confidenciales que su función consumirá a través del contexto 'env.NOMBRE_SECRETO'.

Paso 7. Publicación en la Red Perimetral: Presione el botón '🚀 Desplegar a Edge Network'. El compilador del cliente procesará el TypeScript de forma transparente y distribuirá el código a la red global.

Seguridad de Direccionamiento. BLINDAJE MEDIANTE FIRMAS ALEATORIAS DE 19 CARACTERES: Con el fin de impedir colisiones entre clientes y evitar que terceros puedan adivinar las URLs de sus servicios, cada función recibe una firma criptográfica única de 19 caracteres (ejemplo: jeacel-global-pagos-x7f9m2p1q8n4v5c6k3t.jeacellat.workers.dev). La URL pública se exhibe en el encabezado junto al icono del ojo de seguridad.

3. Métodos Oficiales de Invocación y Consumo

Una vez completada la publicación, la Edge Function puede consumirse mediante cualquier protocolo HTTP estándar:

A) Desde PowerShell (Entornos Windows):

Invoke-RestMethod -Uri "https://tu-url-jeacel.workers.dev" `
  -Method Post `
  -ContentType "application/json" `
  -Body '{"prompt": "consulta"}'

B) Desde Terminal cURL (Linux / macOS):

curl -X POST https://tu-url-jeacel.workers.dev \
  -H "Content-Type: application/json" \
  -d '{"prompt": "consulta"}'

C) Desde JavaScript / Navegador Web:

fetch("https://tu-url-jeacel.workers.dev", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "consulta" })
})
.then(res => res.json())
.then(data => console.log(data));

4. Catálogo de Errores en Edge Functions y Soluciones

Tabla 4

Matriz de Diagnóstico y Resolución de Fallas en Edge Functions

Incidente / Error	Causa Técnica Principal	Procedimiento de Solución
SyntaxError: Unexpected strict mode reserved word (10021)	El código contenía declaraciones de TypeScript sin compilar antes del envío a la red.	1. Jeacel Hosting integra el compilador Babel Standalone en el cliente. 2. Presione Ctrl + F5 para limpiar la memoria caché del navegador. 3. Presione nuevamente 'Desplegar a Edge Network' para compilar automáticamente a JavaScript estándar.
Error de CORS (Bloqueo en Navegadores Web)	La función no emite las cabeceras requeridas de Cross-Origin Resource Sharing o no responde a peticiones preflight OPTIONS.	1. Incorpore en la respuesta: 'Access-Control-Allow-Origin': '' y 'Access-Control-Allow-Headers': ''. 2. Maneje el método 'OPTIONS' retornando un estado 200 o 204 antes de procesar el POST.
Error 500: Internal Server Error / Secret Not Defined	El código intenta leer un secreto ('env.LLAVE') no registrado en el panel de la función.	1. En el panel izquierdo de la Edge Function, agregue la clave exacta dentro de 'Secretos (API Keys)'. 2. Presione 'Desplegar a Edge Network' para propagar las variables a los nodos.
Timeout de Ejecución Perimetral	Llamadas a APIs de terceros que superan el tiempo de respuesta o bucles no controlados.	1. Añada un AbortController a las peticiones fetch salientes con un límite razonable (ej. 10s). 2. Valide que las funciones asíncronas utilicen 'await' correctamente.