Skip to content

Latest commit

 

History

History
143 lines (93 loc) · 4.61 KB

README-devs-design-es.md

File metadata and controls

143 lines (93 loc) · 4.61 KB

Developers

Este proyecto no sería posible sin la colaboración de otros developers que han donado su tiempo para crear esta aplicación. Si encuentras un error por favor crea un issue y si puedes arreglarlo te invitamos a hacer y someter un pull request.

Tenemos un chat room - #horas-project para facilitar la comunicación y coordinación del equipo. Si necesitas una cuenta puedes crearla aqui.

Si necesitas ideas de como ayudar puede ver la lista de tareas pendientes.

Github issues

Para correr el proyecto

Hay dos opciones para correr el proyecto, la primera usando Docker y la segunda instalandolo en tu ambiente local.

Opción 1: Docker

Instalación

Linux

Puedes encontrar instrucciones de como instalar Docker para diferentes distribuciones de Linux aqui.

Distribuciones populares:

Mac OS

La mejor manera de utilizar Docker en Mac Os es utilizando Docker for Mac.

Windows

La mejor manera de utilizar Docker en Mac Os es utilizando Docker for Windows.

** Como crear imagenes de Horas con Docker **

# Clonear repositorio
$ git clone https://github.com/SoPR/horas.git

# Instalar dependencias para el build de JS / CSS
$ cd horas/static
$ npm install  # 'yarn' si lo tienes instalado

# Crear la imagen de Docker.
$ cd ..
$ docker-compose build

# Once the image is created you can create the container
$ docker-compose up -d

# When the containers are created and running you can then run Django manage commands
$ docker-compose exec web python manage.py collectstatic

# Migración y data inicial
$ python manage.py migrate
$ python manage.py loaddata apps/profiles/fixtures/admin.json

El archivo docker-compose.yml contiene toda la configuración de los servicios de Docker necesarios tener una instancia de Horas corriendo.

Abre tu browser en http://localhost:8000/. Para accesar la sección de administración ve a http://localhost:8000/admin/, y usa el username admin y el password abc123.

Opción 2: Local

Requisitos

# Clonear repositorio
$ git clone https://github.com/SoPR/horas.git

# Instalar dependencias para el build de JS / CSS
$ cd horas/static
$ npm install  # 'yarn' si lo tienes instalado

# Copiar archivo de variables de ambiente
$ cd ..
$ cp .env.example .env

# Instalar dependencias python
$ pipenv install --dev

# Migración y data inicial
$ pipenv run python manage.py migrate
$ pipenv run python manage.py loaddata apps/profiles/fixtures/admin.json

# Correr server de django 
$ pipenv run python manage.py runserver

Abre tu browser en http://localhost:8000/. Para accesar la sección de administración ve a http://localhost:8000/admin/, y usa el username admin y el password abc123.

Para los usuarios de Mac OSX

Durante la instalacion de los requerimientos con pip:

$ pipenv install --dev

Es posible que se encuentren con este error:

src/_pylibmcmodule.h:42:10: fatal error: 'libmemcached/memcached.h' file not found
    #include <libmemcached/memcached.h>
             ^
    1 error generated.

Esto se puede dar cuando libmemcached no esta instalada en su sistema. La solucion es instalar libmemcached de una de las siguientes maneras:

Homebrew

$ brew install libmemcached

Ports

$ sudo port install libmemcached

Una vez hecho esto pueden volver al paso $ pipenv install --dev y continuar con las instrucciones.

Para correr tests

$ pipenv run python manage.py test --configuration=Testing --verbosity=3 --noinput

Diseñadores

Tenemos un branch dedicado para compartir y colaborar sobre el diseño de la plataforma. Mantendremos el diseño más reciente en ese branch.

Design - Branch dedicado al diseño de este proyecto.