SF Academy @Ichicoro

Contesto

Viene richiesto di sviluppare una piattaforma che consenta agli utenti autenticati di simulare l'acquisto di dollari in cambio di euro e viceversa. La piattaforma dovrà prevedere una registrazione degli utenti, la visualizzazione del proprio saldo e dello storico delle transazioni, e la possibilità di eseguire versamenti acquisti e ritiri di denaro.

Componenti

• Backend
  • exchange microservice
  • users microservice
  • api microservice
• Frontend
  • react webapp

Backend

Il backend e' costituito da tre microservizi hostati su una EC2, ed un database MySql su RDS.

I microservizi devono comunicare tra loro in GRPC, esponendo rispettivamente la porta 9000 (exchange) e 9001 (users). L' API dovrà invece deve esporre pubblicamente sulla porta 80 gli endpoint dell'applicazione seguendo il comune paradigma RPC. Si suggerisce l'utilizzo di NGINX per la gestione del traffico da internet all'API. Tutti i microservizi devono essere sviluppati in NodeJs.

Suggeriamo di visionare un semplice esempio di implementazione di GRPC

Di seguito sono elencati più nello specifico i vari microservizi; NB. tutte le funzioni successivamente presentate hanno la funzione di chiarire le feature richieste e non sono da considerarsi necessariamente esaustive o immodificabili ma possono e devono adattarsi secondo le esigenze che eventualmente nasceranno durante lo sviluppo:

• EXCHANGE: questo servizio si occupa di fare il calcolo di cambio valuta su una quantità data di euro in dollari o viceversa nel momento in cui si riceve la richiesta. Il tasso di cambio aggiornato può essere recuperato da questo servizio comodamente in formato JSON o meglio ancora, tagliando ogni intermediario e parsando l'xml fornito direttamente dalla Banca Centrale Europea L'interfaccia di questo microservizio è quindi molto semplice ed espone una sola funzione GRPC:

  • exchange(number value, string from, string to) // ex: exchange(10, "EUR", "USD")

• USERS: questo microservizio si occupa di tutta la parte di registrazione, login e gestione ordini degli utenti. L'interfaccia di questo microservizio deve prevedere le seguenti funzioni GRPC:

  • signup(string email, string password, string name, string iban): questa funzione salva sul DB i dati dell'utente appena registrato. NB. la password dell'utente non deve essere salvata in chiaro sul DB ma deve prima essere hashata per questioni di sicurezza.
  • login(string email, string password): questa funzione rilascia un JWT all'utente che sarà quindi abilitato alla chiamata di endpoint protetti dell'api.
  • deposit(nubmer value, string symbol): permette all'utente di depositare sul suo conto il valore specificato nella valuta specificata
  • withdraw(number value, string synbol): permette all'utente di spostare dalla piattaforma al suo iban la quantità di denaro specificata nella valuta specificata. NB. le due funzioni deposit e withdraw sono funzioni che simulano unicamente degli spostamenti di denaro limitandosi ad aggiornare dei valori sul DB dell'applicativo
  • buy(number value, string symbol): permette all'utente di comprare con una valuta la quantità specificata di denaro nell'altra valuta disponibile secondo il tasso di cambio recuperato dall'Exchange microservice; per ogni transazione è necessario archiviare in una tabella di DB appositamente strutturata tutte le informazioni riguardo l'operazione
  • listTransations(object filter): permette all'utente di visualizzare le sue transazioni con la possibilità di filtrarle per date e/o valuta di riferimento

• API: questo microservizio è l'unico accessibile direttamente da internet e deve essere sviluppato usando open api ed express vedi esempio. Lo scopo dell'api è quello di ricevere le chiamate dell'esterno e smistarle ai vari microservizi, rispondendo con i risultati effettivamente restituiti dagli stessi

Frontend

E’ richiesto lo sviluppo di una semplice pagina web interattiva che permetta l’interazione con tutte le componenti dell’API (signup, login, acquisto, vendita e visualizzazione ordini). Questa può essere realizzata a discrezione del candidato con React o con semplice JavaScript senza frameworks (no jquery). La grafica e la UI della pagina non sarà discriminante per il successo della prova, ma apprezzata. La webapp deve essere servita da AWS S3.

NB

L'intero applicativo deve poter essere testato localmente con Docker anche se non è richiesto che gli applicativi siano eseguiti effettivamente su Docker nella EC2. L’infrastruttura deve essere realizzata utilizzando un template di Terraform per permettere una riproduzione perfetta del sistema in fase di valutazione. Verrà attentamente valutato l’utilizzo di GIT (soprattutto i messaggi dei commit). Obbligatoria la stesura di un README esplicativo del progetto realizzato. Tutte le interazioni con i supervisori riguardanti la prova dovranno avvenire nella sezione issues.

Data di consegna: 15/01/2020