📦 Proyecto Garriga

Este repositorio contiene el código fuente para el paquete npm del proyecto.

[!IMPORTANT] LEER ANTES DE MODIFICAR: Es crítico seguir las instrucciones de flujo de trabajo descritas abajo para evitar desincronizaciones graves.

⚠️ Flujo de Trabajo Crítico

Este es un paquete npm. La relación entre el repositorio y el registro es la siguiente:

1. Gitea: Almacenamos el proyecto aquí para tener una copia de seguridad y un registro histórico de cambios (git commits).
2. npm: El código que realmente vale y se utiliza en producción es el que está alojado en npm.

REGLA DE ORO: Cada vez que se suba una nueva versión del código a Gitea, ES OBLIGATORIO realizar un npm publish.

De no hacerlo, se producirá una desincronización entre el repositorio y el paquete que puede causar conflictos graves.

🛠️ Instalación y Configuración

1. Clonar el repositorio

Para bajarte el código a tu máquina local:

git clone ssh://IPdesarrollo:222/empresa/garriga.git

2. Configuración de SSH (Importante)

Para poder subir cambios, debes configurar tu acceso en Gitea:

1. Añade tu clave pública SSH en las Claves de implementación (Deploy Keys) del proyecto en Gitea.
2. ✅ Asegúrate de marcar la casilla: "Habilitar acceso de escritura".

🚀 Publicación en npm

El proceso de autenticación en npm utiliza autenticación de dos factores (2FA) y WebAuthn. Sigue estos pasos meticulosamente.

Paso 1: Login (npm login)

Ejecuta el siguiente comando en tu terminal:

npm login

Sigue estos pasos exactos:

1. La terminal te pedirá presionar ENTER para abrir el navegador.
   • ⚠️ Nota: Debes usar Google Chrome. (Firefox suele dar problemas con este flujo).
2. Introduce las credenciales de la cuenta Cardus.
   • ¿No tienes las claves? Búscalas en Discord, en el canal #docs-it.
3. Pulsa el botón de 2FA. Aparecerá un código QR en la pantalla.
4. Escanea el QR con tu móvil.
5. El móvil te pedirá activar el Bluetooth. Acéptalo.
6. En tu ordenador, ve a la configuración de Bluetooth. Verás una solicitud de conexión de tu teléfono; acéptala.
7. El teléfono te pedirá identificación biométrica (PIN, Huella Dactilar o FaceID).

Paso 2: Publicar (npm publish)

Una vez logueado correctamente (y si todo ha salido bien), ejecuta:

npm publish

Nota: El proceso de validación es exactamente el mismo que en el login (QR, Bluetooth, Biometría).

🆘 ¿Necesitas ayuda?

Si no has entendido el proceso o algo falla, NO fuerces la subida.

Este flujo tiene cierta complejidad técnica. Por favor, contacta con alguien del equipo que conozca el proceso antes de modificar nada. Es mejor preguntar que desincronizar el repositorio.