Skip to main content
Version: 1.2.3

SUDOCU

SUDOCU (Sistema Único Documental) es un sistema distribuido de gestión documental integral, que permite gestionar todos los documentos, expedientes y trámites de una institución. Es desarrollado y mantenido por el equipo de la Dirección General de Sistemas y Tecnología de la Universidad Nacional de General Sarmiento.

SUDOCU se integra naturalmente con el ecosistema de expediente eléctronico desarrollado por el SIU, y con otros sistemas productores de documentación, gracias a su arquitectura orientada a microservicios.

Si desea testear o desplegar el ecosistema completo de expediente electrónico por favor dirijase a expedientes.siu.edu.ar. Si en cambio quiere hacer un despliegue rápido de sudocu, siga nuestra Guia de Inicio Rápido:

Inicio rápido#

Si querés probar sudocu rapidamente, solicitanos un acceso escribiendo a sudocu@campus.ungs.edu.ar te recomendamos seguir los pasos para levantar la versión DEMO:

Requisitos previos#

  • docker

  • docker-compose

  • git

  • jq

    Pasos para instalar Docker: https://docs.docker.com/install/

    Pasos para instalar docker-compose: https://docs.docker.com/compose/install/

    Instalación de git y jq en Debian/Ubuntu.

    $ sudo apt install git jq

    Se puede chequear las dependencias con el comando './sudocu.sh check':

    $ ./sudocu.sh check
    docker instalado. Version: Docker version 19.03.1, build 74b1e89
    docker-compose instalado. Version: docker-compose version 1.24.1, build 4667896b
    jq instalado. Version: jq-1.5-1-a5b5cbe

Instalación DEMO#

Los pasos a seguir son los siguientes:

  1. Clonar el proyecto:

    $ git clone https://gitlab.ungs.edu.ar/sudocu/sudocu/sudocu.git
    $ cd sudocu/
  2. Configurar el entorno en modo Producción (primera pregunta). Es necesario especificar si se utilizara SSL y la url desde donde se accederá:

    $ ./sudocu.sh config
    ------------------------------
    Configuración de variables de entorno
    ------------------------------
    Instalación de Producción? (s/n): s
    Instalación segura? (s/n): n
    Ingresar Url (sudocu.local): sudocu.local
    Importando variables...
    Se crea el archivo '.env'
    Se crea el archivo de configuración config/traefik.toml.
    Generando config de sudocu-gestion...
    Generando config de sudocu-login...
    Generando config de sudocu-mpd...
    Generando config de sudocu-mpc...
    Generando config de api-server...

    El comando './sudocu.sh config' genera el archivo '.env' de los cuales se genera cada archivo de configuración, propio de cada subproyecto.

    $ cat .env
    # Configuracion de variables
    SUDOCU_DOMAIN=.ungs.edu.ar
    SUDOCU_VERSION=
    SUDOCU_ENVIRONMENT=production
    SUDOCU_URL=sudocu.local
    SSL=false
    ...
  3. Levantar todo el entorno con el comando './sudocu.sh start':

    $ ./sudocu.sh start
    Creando contenedores...
    Creating network "sudocu_backend" with driver "bridge"
    Creating network "sudocu_frontend" with driver "bridge"
    Creating sudocu_reverse-proxy_1 ... done
    Creating sudocu_db_1 ... done
    Creating sudocu_cache_1 ... done
    Creating sudocu_api-server_1 ... done
    Creating sudocu_login_1 ... done
    Creating sudocu_gestion_1 ... done
    Creating sudocu_mpd_1 ... done
    Creating sudocu_mpc_1 ... done
    Creating sudocu_pdf_1 ... done
    Levantando contenedores...
    Starting sudocu_reverse-proxy_1 ... done
    Starting sudocu_db_1 ... done
    Starting sudocu_cache_1 ... done
    Starting sudocu_api-server_1 ... done
    Starting sudocu_login_1 ... done
    Starting sudocu_gestion_1 ... done
    Starting sudocu_mpd_1 ... done
    Starting sudocu_mpc_1 ... done
    Starting sudocu_pdf_1 ... done
  4. Agregar la URL indicada (en el ejemplo 'sudocu.local') al archivo /etc/hosts.

  5. Probar acceder desde un browser a http://sudocu.local.

  6. Para ayuda de los comandos disponibles se puede utilizar './sudocu.sh help':

    $ ./sudocu.sh help
    SUDOCU
    Uso: ./sudocu.sh [argumento]
    Argumentos:
    build [<image>] Crea las imagenes.
    check Chequea la instalación de dependencias.
    config Crea todos los archivos de configuración.
    db backup Realiza un backup de la base de datos 'sudocu'.
    help Se muestra esta ayuda.
    pull [<branch>] Descarga todos los proyectos (branch default: 'master').
    restart [<container>] Reinicia los contenedores.
    rm [<container>] Elimina los contenedores.
    start [<container>] Inicia los contenedores.
    stop [<container>] Detiene los contenedores.
    version Muestra la versión de sudocu y de todos sus componentes.

Una vez instalado SUDOCU, te recomendamos seguir con el Inicio Rápido Funcional