README.md 1.86 KB
Newer Older
1
# Proyecto Manhattan
2

3
> First we take Manhattan, then we take Berlin.
4

5
Manhattan es una aplicación web para gestionar los proyectos de Innovación Docente.
6
Está desarrollada con [Django](https://www.djangoproject.com/) 3, mucho ♥, bastante ☕ y un poco de magia 🧙.
7

8
## Requisitos
9

10 11 12 13 14 15 16 17 18 19 20
1. Python 3.7 o superior. En Debian o Ubuntu instalar los paquetes `python3.7-dev` y `python3-distutils`.
2. [pip](https://pip.pypa.io/en/stable/installing/), instalador de paquetes de Python. (Puede venir con la instalación de Python).
3. [pipenv](https://github.com/pypa/pipenv) para crear un entorno virtual para Python y facilitar el trabajo.

   Se puede instalar con `sudo -H pip3 install pipenv`.
4. Paquetes `libxmlsec1-dev`, `pandoc` y `pkg-config`.
5. Un servidor de bases de datos aceptado por Django (vg PostgreSQL o MariaDB).

  Para MariaDB/MySQL instalar el paquete `libmariadb-dev` o `libmysqlclient-dev`.

  La configuración deberá incluir, si es necesario:
21 22

  ```ini
23 24 25 26
  innodb_file_per_table = On  # Default on MariaDB >= 5.5
  innodb_file_format = Barracuda  # Deprecated in MariaDB 10.2
  innodb_large_prefix  # Deprecated on MariaDB 10.2, Removed in MariaDB 10.3.1
  innodb_default_row_format = dynamic  # Default on MariaDB >= 10.2.2
27
  ```
28

29
## Instalación
30

31
```shell
32
git clone https://gitlab.unizar.es/InnovacionDocente/manhattan.git
33
cd manhattan
34
pipenv install [--dev]
35 36
```

37
## Configuración inicial
38

39
1. Configurar las bases de datos en el fichero `.env` y la sección `DATABASES` de `manhattan_project/settings.py`.
40 41 42 43
2. Configurar los datos para el correo, y la URL del sitio.
3. Configurar los datos para el _Single Sign On_ (SAML).
4. Ejecutar

44
    ```shell
45
    source .env
46 47 48 49 50
    pipenv shell
    ./manage.py migrate
    ./manage.py createsuperuser
    ./manage.py loaddata seed
    ```
51

52
## Servidor web para desarrollo
53

54 55
```shell
pipenv shell
56
./manage.py runserver [<IP>[:<puerto>]]
57
```