jorgeamadosoria / currentcy

Currency exchange aggregator for Uruguayan Peso against American Dollar (UYU - USD) and European Euro (EUR - UYU). Simple training project for Responsive web, javascript, cloud deployment and such.

Currentcy Currentcy is an exchange rate aggregator that basically parses info from public sites belonging to official exchanges. A list of supported exchanges can be seen here listed alphabetically:

• Abitab (Cambilex) http://www.cambilex.com.uy
• Altercambio SA http://www.altercambio.com.uy
• BBVa https://www.bbva.com.uy/Inicio/Personas/
• Banco Central del Uruguay http://www.bcu.gub.uy
• Banco República http://www.brou.com.uy
• Cambio 18 http://www.cambio18.com
• Cambio Aspen http://www.aspen.com.uy
• Cambio SIR http://www.cambiosir.com.uy
• Cotización Dólar Uruguay http://uy.cotizacion-dolar.com
• Currency.wiki http://currency.wiki
• Gales SA http://www.gales.com.uy/home/
• Google Finance https://www.google.com
• Intercambio Idel SA http://www.intercambio.com.uy
• Indumex http://www.indumex.com
• Nixus Servicios Financieros http://www.nixus.com.uy
• Cambio Regul SA http://www.cambioregul.com/portal/hgxpp001.aspx
• Yahoo http://finance.yahoo.com

This project is just a test ground for technology I like to learn or keep current with, and it is not intended for profit or any other purpose. I'm scratching my own itch here, and if it helps someone else, well, that´s a very nice bonus :)

This is also a test for cloud deployment. I´m using Openshift (openshift.com) from Redhat, which is free for small projects like this as long as it gets used at least once a day. this means that some configuration is externalized in environment variables.

i'm using Spring Tool Suite (Eclipse with EGit). To set this variables on a working copy of these repository: Go to Run -> Run Configurations -> Environments

add the following variables with values that make sense to your setup:

• MAIL_PASSWORD
• MAIL_USERNAME
• OPENSHIFT_MYSQL_DB_HOST
• OPENSHIFT_MYSQL_DB_PASSWORD
• OPENSHIFT_MYSQL_DB_PORT
• OPENSHIFT_MYSQL_DB_USERNAME

Mail variables are needed for registering and suscribing to exchange updates. The sender must be a Gmail account (settings for GMail through SSL are hardwired, though changing those is pretty simple). All other variables are Openshift standard variables to connect to a MySQL instance.

Happy coding.

currentcy's Issues

Document Javascript code with JSDocs

document currentcy namespace with JSDocs, process with dox or jsdoc toolkit, and publish the resulting documentation on github pages.

Test: Junit for Sampler AlterCambio

Circular Logo

modify the logo to be circular to separate logo background from the page background.

Add best exchange highlight to calculator table

bold the rows corresponding to best buy and best sell exchanges in the calculator table.

Test: Junit for Sampler GalesSA

Add Gales Exchange

Add Gales Servicios Financieros to the exchanges

Test: Junit for Sampler Idel

Fix navbar

Fix menu bar to the top of the page at all times.

Add a JS dependencies management system

To experiment with Javascript management systems. Maybe Grunt or Yeoman? I have no idea about this technology yet.

Test: Junit for Sampler Nixus

Feature: subscribe to changes to specific exchange

Subscribe should be specified for a single exchange of preference for the user. Alternatively, the exchange that has the changed from the last time should be highlighted on the email.

Add Freemarker support for Email generation

Need Freemarker to generate the template for register and update emails. Infrastructure is already setup on pom.xml and EmailBuilder class. Need to generate the templates and test the setup.

Add Swagger docs to the REST API

Add Swagger support for documentation on the REST API. The API is simple and doesnt need it, but this is important to familiarize with Swagger

Test: Junit for Sampler Cambio Suizo

add JS localStorage

use store.js to add localStorage for keeping the preferred currency (USD or EUR) or locale (US, CU, UY) selected for each user.

Share app on Facebook

Add a button to the app to allow users to share the app on their Facebook profiles.

Document features with Javadoc in code

Integrate javadoc comments. Later in development to make sure code is stable enough.

Test: Junit for Sampler Regul

Port the application to AngularJS

This is the most ambitious part of the project, only to be engaged when all feature development, testing and documentation is done.

Test: Junit for Sampler BROU

Test: Junit for Sampler BCU

Add Paypal Integration

Add Paypal button (linked to a valid Paypal account) to allow donations. This is more of a theoretical feature, but still, gonna learn how!

Test: Junit for Sampler CambioAspen

Test: Junit for Sampler BBVa

Feature: Enable some control on the ticker

Enable control for the ticker jquery control, so it moves automatically, but it also allows the user to select an specific exchange they know and that is going to take long to come up.

Add Euro exchange rate

Add Euro exchange for all possible exchange. Need to refactor the UI to include Euro exchanges along USD ones.
Need also to include the exchange updates for Euro on email and in the calculator table.

Test: Junit for Sampler CotizacionDolar

Test: Junit for Sampler Cambio Iberia

UI Bug in Paypal link

Paypal link does not change pointer to :hand

Test: Junit for HomeController

Test: Junit for Sampler Indumex

Test: Junit for Sampler CambioSir

Test: Junit for Sampler YahooFinance

Remove Openshift configuration from Github repository

This is a security risk as well as a non necessary piece of crud in the repo.

Test: Junit for SamplerService

i18n localization for Cuba and Uruguay

Differenciate the Spanish dialects for Uruguay and Cuba

new exchanges

add exchanges in these urls:
http://www.varlix.com.uy/
http://www.cambiobacacay.com/
http://www.fortex.com.uy/sitio/index.php?lang=es
http://www.scotiabank.com.uy/

add these also to Readme.md

Test: Junit for Sampler Cambio18

Add Jasmine coverage

Jasmine is an unit testing framework for JS. We will learn how to use it.

Circular logo

Circular logo for snapshots. Important to separate the background color from the page, as some logos as jpgs or similar that cannot have transparent filters.

Add Google Analytics

add google analytics to the system to know how many people and from where is the app used from.

Bug: Update email is not sent

Email is not being sent while changes are happening. Probably a code error

Slide view and other UI enhancements

Show exchanges as slide show, continuously. Allow selection and highlight of one exchange. Show trend and calculator for the selected exchange only. Fix Navbar. Hide language flags into a menu or reduce icons size.

Test: Junit for Sampler Abitab

Add PMD and Cobertura

Add static code analyzers and its associated refactorings.

Add Junit coverage

add Junit, hamcrest and easymock for Spring MVC integration and unit testing.

Add best exchange highlight to snapshots

Compare all exchange rates and select the best for buying and the best for selling, and put it on top of all snapshots.

Help: Add help page or FAQ to explain the features of the page

the page aims for simplicity, as such, it is not heavy on explanation or text in general. Maybe it requires a FAQ to explain things as the trend definition or the calculator, or currency selection.

Test: Junit for Sampler CWiki

Test: Junit for Sampler GoogleFinance