馃殌 Gu铆a de Instalaci贸n - SGE PatagoNiKo

Sigue estos pasos para poner en marcha el Sistema de Gesti贸n de Trayectorias Escolares en tu equipo local.

1. Requisito Primordial: Docker

Docker es el motor que permite que el sistema funcione sin instalaciones complicadas.

Windows Mac
Descarga e instala Docker Desktop:
馃憠 Descargar Docker Desktop aqu铆
Linux

Instala el motor de Docker y Compose abriendo una terminal y ejecutando:

sudo apt update
    sudo apt install docker.io docker-compose-v2 -y
    sudo usermod -aG docker $USER

*Nota: Es posible que necesites cerrar sesi贸n y volver a entrar para que los permisos se apliquen. hasta que no hagas docker ps y te deje ejecutar el comando significa que tu usuario a煤n no tiene los permisos necesarios (no est谩 en el grupo de docker).

2. Configuraci贸n de Archivos

Crea una carpeta llamada SGE_Patagoniko en tu Escritorio. Dentro de ella debes tener los siguientes dos archivos:

A. El archivo de configuraci贸n (docker-compose.yml)

Copia el contenido del archivo YAML que te enviamos originalmente en esta carpeta.

Te enviaremos el docker-compose.yml m谩s otro archivo con una serie de claves en su interior. Se llama .env-ejemplo. Va a ser necesario que le cambies el nombre a: .env

Pero no te preocupes por eso... lo que no logras por tus medios, te ayuda GPT 馃榾

B. El Lanzador de Sistema

Crea un archivo de texto, pega el c贸digo correspondiente y gu谩rdalo en la misma carpeta:

Para Windows iniciar_sistema.bat
            @echo off
            title Lanzador Patag贸niko SGE
            echo -------------------------------------------------------
            echo   SISTEMA DE GESTION DE ESTUDIANTES - PATAGONIKO
            echo -------------------------------------------------------
            docker compose up -d
            echo.
            echo 隆Todo listo! El sistema esta corriendo.
            echo.
            echo    - Acceso a la APP: http://localhost:8000
            echo    - Acceso a la DB:   http://localhost:8081
            echo.
            pause
        

La clave es esta instrucci贸n: docker compose up -d, todo lo dem谩s es adorno.

Para Mac/Linux iniciar_sistema.sh
#!/bin/bash
echo "Iniciando Sistema Patag贸niko..."
docker compose up -d
echo "Acceso App: http://localhost:8000"
read -p "Presiona Enter para finalizar..."

3. Puesta en Marcha

Haz doble clic en el archivo que creaste (.bat o .sh).
Nota: La primera vez demorar谩 unos minutos mientras descarga los componentes desde la nube.

4. 驴C贸mo actualizar el sistema?

Como estamos en etapa de desarrollo, enviar茅 mejoras seguido. Para actualizar a la 煤ltima versi贸n disponible, no necesitas borrar nada, solo:

  1. Abre una terminal en la carpeta del sistema.
  2. Escribe: docker compose pull
  3. Escribe: docker compose up -d

馃敆 Enlace de Acceso Directo

馃憠 ENTRAR AL SISTEMA (http://localhost:8000)

馃挕 Notas Importantes