OpenJornada
Comença Gratuïtament

Instal·lació i Desplegament

Desplega OpenJornada a la teva pròpia infraestructura en minuts.

Contingut

1. Requisits previs

Programari necessari

  • Docker 20.10+ y Docker Compose v2+
  • Git para clonar repositorios
  • Opcionalmente: Docker Swarm para produccion

Recursos mínims

ComponentDesenvolupamentProducció
CPU2 cores4+ cores
RAM4 GB8+ GB
Disco20 GB50+ GB

2. Arquitectura del sistema

OpenJornada està compost pels serveis següents:

API (FastAPI)

Backend de l'API REST amb Python

ghcr.io/openjornada/openjornada-api

Admin (Next.js)

Panell d'administració

ghcr.io/openjornada/openjornada-admin

Webapp (React + Vite)

Aplicació per als treballadors

ghcr.io/openjornada/openjornada-trabajadores

MongoDB

Base de dades

mongo:7-jammy
┌─────────────────────────────────────────────────┐
│                   INTERNET                      │
└─────────────────────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────┐
│              Caddy (Reverse Proxy)              │
│         SSL automatico + Load Balancing         │
└─────────────────────────────────────────────────┘
        │               │               │
        ▼               ▼               ▼
┌───────────┐   ┌───────────┐   ┌───────────┐
│   Admin   │   │  Webapp   │   │    API    │
│  :3000    │   │   :80     │   │   :8000   │
└───────────┘   └───────────┘   └───────────┘
                                        │
                                        ▼
                              ┌───────────────┐
                              │    MongoDB    │
                              │    :27017     │
                              └───────────────┘

3. Docker Compose (desenvolupament)

Inici ràpid

# Clonar repositorio
git clone https://github.com/openjornada/openjornada-api.git
cd openjornada-api

# Configurar variables
cp .env.example .env
# Editar .env con tu configuracion

# Iniciar servicios
docker-compose up -d

# Ver logs
docker-compose logs -f

docker-compose.yml bàsic

version: '3.8'

services:
  mongodb:
    image: mongo:7-jammy
    environment:
      MONGO_INITDB_ROOT_USERNAME: admin
      MONGO_INITDB_ROOT_PASSWORD: changeme123
    volumes:
      - mongodb_data:/data/db
    ports:
      - "27017:27017"

  api:
    image: ghcr.io/openjornada/openjornada-api:latest
    environment:
      - MONGODB_URL=mongodb://admin:changeme123@mongodb:27017
      - SECRET_KEY=your-secret-key-here
    ports:
      - "8000:8000"
    depends_on:
      - mongodb

  admin:
    image: ghcr.io/openjornada/openjornada-admin:latest
    environment:
      - NEXT_PUBLIC_API_URL=http://localhost:8000
    ports:
      - "3001:3000"

  webapp:
    image: ghcr.io/openjornada/openjornada-trabajadores:latest
    environment:
      - VITE_API_URL=http://localhost:8000
      - VITE_API_USERNAME=admin
      - VITE_API_PASSWORD=your-password
    ports:
      - "5173:80"

volumes:
  mongodb_data:

4. Docker Swarm (producció)

Inicialitzar Swarm

# Inicializar Swarm (solo primera vez)
docker swarm init

# Crear red overlay
docker network create --driver overlay --attachable frontend

# Desplegar stack
docker stack deploy -c docker-compose.swarm.yml openjornada

# Ver servicios
docker stack services openjornada

# Ver logs de un servicio
docker service logs openjornada_api -f

Actualitzar serveis

# Actualizar imagen de un servicio
docker service update --image ghcr.io/openjornada/openjornada-api:1.0.5 openjornada_api

# Forzar actualizacion
docker service update --force openjornada_api

# Rollback si hay problemas
docker service rollback openjornada_api

Alta disponibilidad

Per a alta disponibilitat, utilitza múltiples rèpliques dels serveis web. MongoDB requereix una configuració de replica set per a HA.

5. Variables d'entorn

API (openjornada-api)

VariableDescripcióExemple
MONGODB_URLURL de conexion MongoDBmongodb://user:pass@host:27017
SECRET_KEYClave para JWT (min 32 chars)your-secret-key-min-32-characters
SMTP_HOSTServidor SMTPsmtp.gmail.com
SMTP_PORTPuerto SMTP587
SMTP_USERUsuario SMTPnoreply@empresa.com
SMTP_PASSWORDContrasena SMTPapp-password

Panell d'administració

VariableDescripció
NEXT_PUBLIC_API_URLURL de la API
NEXT_PUBLIC_APP_NAMENombre de la aplicacion
NEXT_PUBLIC_APP_LOGORuta del logo

Webapp (treballadors)

VariableDescripció
VITE_API_URLURL de la API
VITE_API_USERNAMEUsuario API para auth JWT
VITE_API_PASSWORDContrasena API para auth JWT
VITE_APP_NAMENombre de la app

6. Configuració SSL

Utilitzem Caddy com a reverse proxy. Obté certificats SSL automàticament de Let's Encrypt.

Caddyfile d'exemple

# Dominio principal
app.tuempresa.com {
    # Admin panel
    handle /admin* {
        reverse_proxy admin:3000
    }

    # API
    handle /api* {
        reverse_proxy api:8000
    }

    # Webapp (default)
    handle {
        reverse_proxy webapp:80
    }
}

# Redirect www a non-www
www.tuempresa.com {
    redir https://app.tuempresa.com{uri} permanent
}

SSL Automatico

Caddy obté i renova certificats SSL automàticament. Assegura't només que el teu domini apunti a la IP del servidor.

7. MongoDB

Configuració recomanada

# docker-compose.yml
mongodb:
  image: mongo:7-jammy
  environment:
    MONGO_INITDB_ROOT_USERNAME: admin
    MONGO_INITDB_ROOT_PASSWORD: ${MONGO_PASSWORD}
    MONGO_INITDB_DATABASE: openjornada
  volumes:
    - mongodb_data:/data/db
    - mongodb_config:/data/configdb
  deploy:
    placement:
      constraints:
        - node.role == manager

Connexió des de CLI

# Conectar a MongoDB
docker exec -it openjornada_mongodb mongosh

# Autenticar
use admin
db.auth("admin", "password")

# Ver bases de datos
show dbs

# Usar base de datos
use openjornada

# Ver colecciones
show collections

8. Crear el primer usuari

Després de desplegar, crea el primer usuari administrador utilitzant el CLI de l'API.

Crear usuari admin

# Acceder al contenedor de la API
docker exec -it openjornada_api bash

# Crear usuario administrador
python -m api.manage_api_users create admin admin@empresa.com admin

# Se te pedira una contrasena

# Verificar que se creo
python -m api.manage_api_users list

Altres comandes útils

# Ver usuarios
python -m api.manage_api_users list

# Cambiar contrasena
python -m api.manage_api_users password admin

# Cambiar rol
python -m api.manage_api_users role admin tracker

# Activar/desactivar usuario
python -m api.manage_api_users toggle admin

Siguiente paso

Un cop creat l'usuari admin, accedeix al panell d'administració i crea la teva primera empresa i els treballadors.

Guia per a administradorsReferència de l'API
Instal·lació d'OpenJornada - Docker, Kubernetes i Self-Hosted