blackfile / appprestamos

Aplicación para el manejo y recordatorio de préstamos

AppPrestamos

Aplicación para el manejo y recordatorio de préstamos.

Qué queremos lograr?

¿Te ha pasado que prestas plata y luego no consigues que te la paguen de vuelta?

¿Alguna vez has prestado un libro, una calculadora o algún otro objeto y luego se te olvidó a quién se lo prestaste?

Estos son algunos de los casos de uso que queremos resolver con esta aplicación.

Además, como con todo proyecto de Trisfera, queremos aprender algo nuevo. En este caso queremos aprender cómo:

• Desarrollar un REST API con Node.js
• Desarrollar un cliente web con Backbone.js
• Desarrollar clientes móviles para Android y iOS
• Escribir Javascript utilizando CoffeeScript
• Escribir CSS utilizando LESS
• Colaborar como comunidad para el desarrollo de un proyecto open source

Cómo está estructurada la aplicación?

La aplicación la vamos a dividir en dos secciones principales: el servicio y los clientes.

###Servicio

Maneja la "lógica de negocio": crear nuevos préstamos, consultar préstamos existentes, etc. El servicio expondrá un REST API y toda la data será enviada en formato JSON. Nuestro objetivo es hacer el API lo más sencillo posible para que sea fácil de consumir para los clientes.

Todo lo referente al servicio se encuentra en este repositorio. La documentación del servicio la pueden encontrar aquí.

###Clientes

Es cualquier interfaz mediante la cual una persona puede interactuar con el servicio. Algunos ejemplos serían una página web o una aplicación Android.

El cliente web se encuentra en este repositorio, en la carpeta app/ui. Los clientes móviles se van a desarrollar de manera independiente y tendrán sus propios repositorios.

En qué está hecho?

El servicio está siendo desarrollado con Node.js y Express Framework. Además, usamos MongoDB como base de datos y Mongoose como nuestro ODM.

El cliente web utiliza Backbone.js, pero escrito en CoffeeScript. Para escribir CSS se utiliza LESS y aún estamos considerando si utilizar o no una librería como Twitter Bootstrap.

Quieres correr este proyecto en tu máquina?

Primero debes:

• Instalar Node.js
• Instalar MongoDB

Luego debes descargar el código, entrar a la carpeta del proyecto y correr:

npm start

Podrás acceder a la aplicación en la dirección http://127.0.0.1:3000/

Quieres colaborar?

Estos son los pasos a aseguir:

• Haz un Fork
• Clona el proyecto (que se encuentra en tu Fork) a tu máquina
• Modifica/crea los archivos para realizar tu aporte y haz los commits a tu Fork
• Haz un Pull Request para integrar tus cambios a este repositorio

Para aprender a hacer todo lo anterior, puedes seguir esta guía.

Bug o Feature Request?

Por favor añádelo en los issues del repositorio.

Duda, consulta, sugerencia?

Contáctanos por twitter o únete a nuestro grupo de Facebook