Opciones que cambian por instalación
Dominio, URL pública, puertos, endpoints, directorios de datos y respaldos, identidad de instancia y marca deben poder cambiar sin editar la lógica reutilizable.
Se prefieren las opciones nativas de cada sistema. No se introducen nombres nuevos si un mecanismo existente ya resuelve la variación.
Perfil del docsite
config/publication.json contiene identidad de proyecto, servicio, entorno, título, URL pública, repositorio y fecha de revisión. Es un perfil público y versionado, sin secretos.
Astro consume la URL durante la compilación para generar referencias canónicas. El layout consume el título y la fecha. Cambiar estos valores requiere volver a compilar y versionar dist.
El destino SSH y su clave están en la configuración privada del proceso de publicación. Las rutas del servidor se cargan desde un perfil JSON privado que utiliza el desplegador; no se incrustan en el código de Astro.
Secretos y frontend
Ninguna clave privada, token, contraseña o archivo .env privado debe entrar al repositorio ni al sitio compilado. Una variable que llega al navegador es pública.
Las credenciales para leer GitHub desde la VPS y para solicitar un despliegue desde GitHub Actions son diferentes. El proceso de CI no utiliza la clave personal de administración.
Verificación del consumo
Al añadir una opción, documentar su ubicación, precedencia, momento de aplicación y consumidor. La compilación y la publicación deben fallar si falta una configuración obligatoria o si el perfil no coincide con el destino.
Una adaptación se considera terminada cuando se comprueba que cambia el comportamiento previsto sin modificar otros sistemas ni usar un destino de respaldo de otra instalación.