Proiect Etapa 2 - J. POO Morgan Chase & Co.

• Responsabili & Autori: Tudorache Alina , Alexandru Gheorghe , Tudor Cristian-Andrei , Dumitrescu Toma-Ioan
• Consultant & Revisor: Stefan Cocioran
• Data publicării: 17 decembrie, ora 10:34
• Deadline HARD: 21 ianuarie, ora 10:00 dimineața
• Ultimele modificări:
  • Publicare schelet - 20 Dec. 2024
  • Adăugat clarificări comandă withdrawSavings - 21 Dec.2024
  • Adăugat teste - 21 Dec.2024
  • Actualizat teste și enunț - 02 Ian. 2025
  • Actualizat teste - 05 Ian. 2025
  • Actualizat enunț și ref-uri pentru t14 si t18-20 pentru cazul unui asociat cu 2 roluri - 11 Ian. 2025
  • Actualizat DEADLINE HARD - 11 Ian. 2025
  • Publicare soluție oficială pentru etapa 1 în secțiunea resurse - 14 Ian. 2025

Ați supraviețuit primelor etape, dar acum vine partea cu adevărat interesantă: să adăugați funcționalitățile care vor transforma acest sistem de e-banking dintr-un simplu “salut” într-un “wow!” complet funcțional.

Așadar, echipati-va în tricoul de programator „Coffee + Code = Success” (și o cantitate semnificativă de cofeină), si puneti-va pe treabă ca sa securizati pozitia aia de CEO ! 😎

• Implementarea a cel puțin 4 design patterns POO si folosirea cunostintelor acumulate pana la laboratorul 9 inclusiv.
• Refactorizarea codului pentru a permite adăugarea funcționalităților noi.

Scopul acestui proiect este să creăm o aplicație revoluționară, asemănătoare cu Revolut, dar cu un twist! Vrem să aducem o gamă largă de funcționalități care să îmbunătățească viața financiară a utilizatorilor. De la gestionarea rapidă a conturilor personale și tranzacțiilor, până la noi opțiuni super utile precum conturile pentru afaceri, care vor face viața antreprenorilor mult mai ușoară.

Mai mult, vom adăuga cashback pentru diverse plăți, astfel încât fiecare achiziție să devină o mică recompensă. Și dacă vrei să fii tratat ca un VIP, vei putea opta pentru un plan premium, care îți va oferi beneficii exclusive, cum ar fi tranzacții mai rapide, reduceri speciale și funcționalități avansate.

Așadar, nu e doar o aplicație bancară, ci o adevărată platformă care îți pune la dispoziție toate uneltele necesare pentru a-ți gestiona banii inteligent și cu stil!

Toate comenzile de la etapa I rămân valabile, doar că vor suferi mici modificări.

Comenzile posibile de la etapa anterioară sunt :

• addAccount
• addFunds
• createCard / createOneTimeCard
• deleteAccount
• deleteCard
• setMinBalance
• checkCardStatus
• payOnline
• sendMoney
• setAlias
• splitPayment
• addInterest
• changeInterestRate
• report / spendingReport

Față de etapa anterioară, vom adaugă niște date suplimentare pentru utilizatori - data nașterii, ocupația și tipul de plan de administrare al contului.

Asemănător ca la etapa I, la inceputul fiecarui test va fi o listă cu utilizatori, iar noul format de date ale utilizatorilor vor fi :

• firstName (String): prenumele utilizatorului.
• lastName (String): numele de familie al utilizatorului.
• email (String) : email-ul utilizatorului.
• birthDate (String) : data de naștere a utilizatorului.
• occupation (String) : ocupația utilizatorului.

Similar cu utilizatorii, comercianții vor fi primiți la începutul fiecărui test după lista cu utilizatori.

Fiecare comerciant va avea următoarele informații:

• commerciant (String) - numele comerciantului
• id (int) - id-ul comerciantului
• account (String) - IBAN-ul contului corespunzator comerciantului
• type (String) - tipul de comerciant (ex: Tech)
• cashbackStrategy (String) - metoda de cashback a comerciantului

Fiecare comerciant vrea să atragă cât mai mulți clienți, așa că introduce strategia de cashback. Cu cât cheltui mai mult, cu atât câștigi mai mult înapoi 🤑.

Un comerciant poate să aleagă unul din următoarele planuri de cashback:

nrOfTransactions

• acest tip de cashback este cumulativ
  • pentru 2 tranzacții → 2% cashback pentru următoarea tranzacție la un comerciant de tip Food
  • pentru 5 tranzacții → 5% cashback pentru următoarea tranzacție la un comerciant de tip Clothes
  • pentru 10 tranzacții → 10% cashback pentru următoarea tranzacție la un comerciant de tip Tech

Se contorizează numărul de tranzacții de la fiecare comerciant de acest tip în ordinea în care se primesc comenzile de plată cu cardul sau transfer bancar. În momentul în care se atinge unul dintre pragurile pentru numărul de tranzacții, atunci se va primi cashbackul aferent.

spendingThreshold (currency-ul va fi RON)

• depinde de planul pe care îl are utilizatorul - standard, student, silver sau gold
• pentru 100RON cheltuiți (suma totală a tranzacțiilor până acum)
  • 0.1% cashback pentru standard și student
  • 0.3% cashback pentru silver
  • 0.5% cashback pentru gold
• pentru 300RON cheltuiți
  • 0.2% cashback pentru standard și student
  • 0.4% cashback pentru silver
  • 0.55% cashback pentru gold
• pentru 500RON cheltuiți
  • 0.25% cashback pentru standard și student
  • 0.5% cashback pentru silver
  • 0.7% cashback pentru gold

Cashback-ul se va primi la tranzacția curentă pentru care s-a îndeplinit unul din pragurile precizate anterior.

Acesta se va regăsi în teste după lista de comercianți și va fi o listă goală dacă nu este folosit în testul curent.

Structura acestuia este:

• from (String) - moneda care se dorește a fi convertită
• to (String) - moneda în care se dorește conversia
• rate (double) - rata de conversie

Acum vrem să ne mărim și noi profiturile ca să dezvoltăm afacerea. 😁

Lansăm planuri personalizate, create să se muleze perfect pe nevoile fiecărui utilizator. Cu un mic fee, vor putea debloca beneficii extra și funcționalități exclusive, iar upgrade-ul la un plan superior le va transforma complet experiența financiară!

• standard
  • se va percepe 0.2% comision pentru fiecare tip de tranzacție → money transfer, card payment, cash withdrawal
• student
  • nu se va percepe comision pentru niciun fel de tranzacție
• silver
  • nu va fi perceput comision pentru tranzacții mai mici de 500RON, altfel se va lua 0.1% comision
• gold
  • nu se va percepe comision pentru niciun fel de tranzacție

Un utilizator va avea opțiunea de a trece la un plan mai bun prin efectuarea unei tranzacții de acest tip. În funcție de numărul de nivele pentru upgrade, se vor percepe următoarele fee-uri:

• standard/ student to silver: 100RON fee
• silver to gold: 250RON fee
• standard/ student to gold: 350RON fee

Formatul comenzii pentru această acțiune este:

• command (String) - “upgradePlan” - numele comenzii
• newPlanType (String) - tipul de plan la care se face upgrade
• account (String) - IBAN-ul contului corespunzător utlizatorului
• timestamp (int) - momentul de timp în care comanda a fost solicitată

{
   "command": "upgradePlan",
   "newPlanType”: "silver",
   "account": "RO69POOB6209498372540635",
   "timestamp": 3
}

Mesaje posibile pentru această comandă:

• “Upgrade plan”
• “The user already has the ${newPlanType} plan.”
• “You cannot downgrade your plan.”
• “Insufficient funds”
• “Account not found”

Vom introduce update-uri pentru contul de savings și un nou tip de cont - cel de business.

Uneori se întâmplă situații neprevăzute și să stăm mai prost cu banii așa că suntem nevoiți să retragem din contul de economii ca să ne rezolvăm problemele 💸💸.

Un utilizator ce are un cont de tip savings și cel puțin unul de tipul clasic va putea adăuga fonduri din cel de savings în unul din cele clasice, în funcție de currency-ul specificat în comandă.

Și cum anumiți părinți deschid conturi pentru copii ca să le ofere un viitor mai bun și să nu cheltuiască banii strânși, vom avea un minim de vârstă pentru a putea retrage bani - 21 de ani.

Structura comenzii este:

• command (String) - ”withdrawSavings” - numele comenzii
• account (String) - IBAN-ul contului corespunzător contului de savings al utilizatorului
• amount (double) - suma care va fi retrasă din cont
• currency (String) - moneda care va fi folosită pentru suma retrasă din cont
• timestamp (int) - momentul de timp la care are loc această operație

{
    "command": "withdrawSavings",
    "account": "RO58POOB7344468893732422",
    "amount": 475.95,
    "currency": "RON",
    "timestamp": 2
}

Mesaje posibile pentru această comandă:

• “Savings withdrawal”
• “You don't have the minimum age required.”
• “You do not have a classic account.”
• “Account is not of type savings.”
• “Insufficient funds”
• “Account not found”

Vrem să ne extindem clientela și să oferim un plan de banking pentru antreprenori. Aceștia vor avea avantajul de a împărți un singur cont cu toți angajații și să gestioneze ușor tranzacțiile pentru afacerea lor 📝.

Când se primește comanda de creare a unui cont business, userul primit va fi ownerul contului și apoi se vor putea adăuga utilizatori cu drept de acces la cont. De asemenea, ownerul poate seta balanța minimă (recap de la etapa 1 - suma sub care nu trebuie să scadă valoare contului altfel cardurile asociate vor fi blocate) și limite pentru tranzacțiile făcute de ceilalti utilizatori.

Vor fi 3 tipuri de utilizatori cu acces la cont:

• owner
  • are drepturi depline, în special să seteze limite pentru fiecare tip de tranzacție
• manager
  • are dreptul să facă orice fel de tranzacție: adăugare fonduri, făcut plăți, transferuri și să creeze sau să șteargă orice card asociat contului
  • poate sa faca plati cu orice fel de card
• employee
  • poate să efectueze plăți - plăți cu cardul sau transfer bancar - în limita la 500RON inițial
  • poate să depună bani în contul de business în limita la 500RON inițial
  • poate să creeze carduri și să le șteargă doar pe cele create de el
  • poate sa faca plati cu orice fel de card

• creare cont business
  • command (String) - ”addAccount” - numele comenzii
  • email (String) - email-ul utilizatorului căruia i se va crea un cont nou
  • currency (String) - moneda asociată contului
  • accountType (String) - tipul de cont care va fi creat
  • timestamp (int) - momentul solicitării comenzii

• adaugare noi asociati pentru contul business
  • command (String) - ”addNewBusinessAssociate” - numele comenzii
  • account (String) - IBAN-ul contului business
  • role (String) - rolul utilizatorului care va fi adăugat - manager sau employee
  • email (String) - email-ul utilizatorului
  • timestamp (int) - momentul solicitării comenzii

• schimbare limita de plati pentru employees
  • command (String) - ”changeSpendingLimit” - numele comenzii
  • email (String) - email-ul utilizatorului
  • account (String) - IBAN-ul contului business
  • amount (double) - noua limita pentru spending
  • timestamp (int) - momentul solicitării comenzii

• schimbare limita de depus bani pentru employees
  • command (String) - ”changeDepositLimit” - numele comenzii
  • email (String) - email-ul utilizatorului
  • account (String) - IBAN-ul contului business
  • amount (double) - noua limita pentru deposit
  • timestamp (int) - momentul solicitării comenzii

{
            "command": "addAccount",
            "email": "Amber_Morris@yahoo.us",
            "currency": "USD",
            "accountType": "business",
            "timestamp": 40
},
{
            "command": "addNewBusinessAssociate",
            "account": "RO98POOB8412955460158769",
            "role": "employee",
            "email": "Tudor_Nemes@yahoo.ro",
            "timestamp": 42
},
{
            "command": "changeSpendingLimit",
            "email": "Amber_Morris@yahoo.us",
            "account": "RO98POOB8412955460158769",
            "amount": 199,
            "timestamp": 83
},
{
            "command": "changeDepositLimit",
            "email": "Julien_Techer@hotmail.fr",
            "account": "RO69POOB9846198978826791",
            "amount": 384,
            "timestamp": 52
}

Mesaje posibile pentru această comandă:

• “You are not authorized to make this transaction.”
• “The user is already an associate of the account.”
• “User not found”

Vom avea câteva tranzacții noi și mici modificări la cele de bază implementate la etapa anterioară.

Întrucât introducem un nou tip de cont - cel de business, va fi necesar adăugarea câmpului de email la comenzi:

• addFunds
  • pot fi adaugate fonduri de catre orice asociat sau de proprietar, conform limitei setate
• createCard / createOneTimeCard
  • se primeste si email-ul utlizatorului care il creeaza pentru a putea tine evidenta cardurilor pentru contul business
  • se poate crea un card catre owner sau oricare asociat
• deleteAccount
  • numai ownerul contului de business va putea face asta
• deleteCard
  • un employee poate șterge doar cardurile create de el, un manager și ownerul pot șterge orice card
• payOnline
  • se poate primi si un comerciant invalid
• sendMoney
  • se pot trimite bani si catre comercianti, nu doar catre utilizatori normali
  • in acest caz:
    • doar se deduce suma aferenta din comanda din contul dat ca parametru, incluzand comision daca se aplica
    • se considera ca suma data ca parametru este in currency-ul contului din care se retrage suma

Evident că mai există situații când avem nevoie și de numerar, din nefericire nu există peste tot POS-uri încă 😢.

Un utillizator va putea retrage bani de la un bancomat din diverse locatii, comanda având următoarea structură:

• command (String) - “cashWithdrawal” - numele comenzii
• cardNumber (String) - numărul cardului care va fi folosit pentru plată
• amount (double) - suma totală de retras in numerar
• email (String) - email-ul utilizatorului
• location (String) - locatia ATM-ului de unde se efectuează retragerea
• timestamp (int) - momentul de timp în care comanda a fost solicitată

{
  "command": "cashWithdrawal",
  "cardNumber": "5873444688937324",
  "amount": 45.5,
  "email": "Joshua_Wood@gmail.us"
  "location": "Ourense",
  "timestamp": 5
}

Mesaje posibile pentru această comandă:

• “Cash withdrawal of ${amount}.”
• “Insufficient funds”
• “Card has already been used”
• “The card is frozen”
• “Card not found”
• “User not found”
• “Cannot perform payment due to a minimum balance being set”

Nu la toate date-urile trebuie mereu să fie mereu 50-50 împărțirea, așadar este normal ca fiecare să plătească cât consumă 🤵.

Pentru un split payment de tip custom, se va primi lista de utilizatori care participă la tranzacție și lista cu suma de plată corespunzătoare pentru fiecare utilizator.

• accounts: [account1, account2,…]
• amountForUsers: [sum_for_account1, sum_for_account2,…]

Posesorul contului inclus în split payment acceptă sau refuză plata (OBLIGATORIU). În cazul în care acesta acceptă plata, se așteaptă ca toți ceilalti implicati sa accepte, ulterior, odată ce toți au acceptat, să se porneasca mecanismul de plată care verifică dacă fiecare cont conține minim suma de plată atașată lui.

Un mesaj de eroare se va genera și atunci când un utilizator refuză plata, anulând întreg split payment-ul pentru toți ceilalți.

• split payment
  • command (String) - “splitPayment” - numele comenzii
    • splitPaymentType (String) - tipul de split payment
    • accounts (List<String>) - lista cu conturile pentru care se va face împărțirea
    • amount (double) - suma totală în moneda menționată în comandă
    • amountForUsers (List<Double>) - lista cu sumele de plată pentru utilizatori
    • currency (String) - moneda folosită pentru plată
    • timestamp (int) - momentul de timp la care a avut loc comanda

• accept split payment
  • command (String) - “acceptSplitPayment” - numele comenzii
  • email (String) - email-ul utilizatorului
  • timestamp (int) - momentul de timp la care a avut loc comanda

• reject split payment
  • command (String) - “rejectSplitPayment” - numele comenzii
  • email (String) - email-ul utilizatorului
  • timestamp (int) - momentul de timp la care a avut loc comanda

{
        	"command": "splitPayment",
        	"splitPaymentType": "custom",
        	"accounts": [
            	"RO69POOB6209498372540635",
            	"RO58POOB7344468893732422"
        	],
        	"amount": 25,
        	"amountForUsers": [
            	10, 15
        	],
        	"currency": "EUR",
        	"timestamp": 19
},
{
        	"command": "acceptSplitPayment",
        	"email": "Lucas_Garnier@outlook.fr",
        	"timestamp": 20
 },
{
        	"command": "rejectSplitPayment",
        	"email": "Margaux_Nicolas@gmail.fr",
        	"timestamp": 21
 }

Mesaje posibile pentru aceasta comandă:

• “Split payment of ${amount} ${currency}” → apare la fiecare comandă de plată distribuită
• “Account ${accounts[current_index]} has insufficient funds for a split payment.” → se ia primul cont găsit că are fonduri insuficiente pentru plata distribuită
• “One user rejected the payment.” → cand unul din utilizatori a dat reject la plata
• “User not found”

Un CEO mereu o să fie interesat de ce se întâmplă cu afacerea sa, în special cu banii săi, așa că vom oferi rapoarte special pentru ei 📊.

Aceștia vor putea alege între un raport legat de tranzacții sau de comercianți - “transaction” sau “commerciant”. Modalitățile de plată luate în calcul pentru acest tip de raport sunt: plata cu cardul și transferul bancar. Ordinea utilizatorilor este cea reținută de contul de business, întâi afișându-se informațiile de utilizare a contului de către manageri, apoi pentru angajați.

• transaction
  • se va specifica pentru fiecare manager și employee numele lor și suma totală cheltuită și cea depusă folosind contul business
• commerciant
  • pentru fiecare comerciant la care s-au efectuat plăți sau transferuri, va fi afișată suma totală cheltuită la acesta și lista de manageri și cea de angajați care au făcut plățile la acel comerciant
  • comercianții, managerii și angajații vor fi sortați crescător după nume

Comanda pentru generarea acestui tip de raport are următorul format:

• command (String) - “businessReport” - numele comenzii
• type (String) - tipul de raport de business
• startTimestamp (int) - momentul de timp de start în care comanda a fost solicitată
• endTimestamp (int) - momentul de timp de încheiere în care comanda a fost solicitată
• account (String) - IBAN-ul contului corespunzator utlizatorului
• timestamp (int) - momentul de timp în care comanda a fost solicitată

{
  "command" : "businessReport",
  "output" : {
    "IBAN" : "RO69POOB1234567898765432",
    "balance" : 891.5,
    "currency" : "RON",
    “spending limit “: 10000000
    “deposit limit”: 10000000
    "commerciants" : [ {
      "commerciant" : “Lenovo”,
      "totalReceived" : 2500
      “managers”: [
	“Popescu Marius”
      ],
      “employers”:[
	“Ionescu Ion”,
	“Maiorescu Titu”
      ]
     } ]
  },
  "timestamp" : 77
}

Mesaje posibile pentru această comandă:

• “Account is not of type business”
• “Account not found”

În rezolvarea temei va fi nevoie de folosirea unor obiecte pentru stocarea și maparea datelor primite în format JSON. Scheletul temei vă oferă mai multe clase utile pentru citirea și rularea temei. Acestea se regăsesc în cadrul scheletului astfel:

• Clasele de input din cadrul pachetului fileio : Acestea se vor folosi pentru parsarea datelor de input. Astfel preluați toate informațiile necesare pentru a crea propriile clase pentru rezolvarea temei.
• Clasa Main care este punctul de intrare pentru logica de rezolvare a temei.

Pentru a întelege mai bine cum funcționează citirea/scrie în fișierele JSON vă recomandăm să citiți Json & Jackson sau să folosiți biblioteca GSON.

1. Se încarcă datele citite din fișierul de test, în format JSON, în obiecte.
2. Se primesc secvențial acțiuni și se execută pe măsură ce sunt primite, rezultatul lor având efect asupra Repository-ului.
3. După executarea unei acțiuni, se afișează rezultatul ei în fișierul JSON de ieșire.
4. La terminarea tuturor acțiunilor se termină și execuția programului.

• Tema a fost concepută pentru a vă testa cunoștințele dobândite în urma parcurgerii laboratoarelor 1-9, aceasta putând fi rezolvată doar cu noțiunile invățate din acele laboratoare.
• Tema fiind o specificație destul de stufoasă recomandăm citirea de cel putin două ori a enunțului inainte de inceperea implementării.
• Pentru depanarea diferențelor dintre output-ul vostru si fișierele ref, vă recomandăm acest site.
• Verificați periodic această pagină, deoarece scheletul/cerința pot suferi modificări în urma unor erori din partea noastră.

Punctajul constă din:

• 80p implementare - trecerea testelor
• 10p coding style (vezi checkstyle)
• 5p README clar, concis, explicații axate pe design (flow, interacțiuni)
• 5p folosire git pentru versionarea temei

Folosirea git pentru versionare va fi verificata din folderul .git pe care trebuie să îl includeți în arhiva temei. Punctajul se va acorda dacă ați făcut minim 3 commit-uri relevante și cu mesaj sugestiv. NU este permis să aveți repository-urile de git publice până la deadline-ul hard.

Bonusuri: La evaluare, putem oferi bonusuri pentru design foarte bun, cod bine documentat dar și pentru diverse elemente suplimentare alese de voi.

Unul din obiectivele temei este învățarea respectării code-style-ului limbajului pe care îl folosiți. Aceste convenții (de exemplu cum numiți fișierele, clasele, variabilele, cum indentați) sunt verificate pentru temă de către tool-ul checkstyle.

Pe pagina de Recomandări cod găsiți câteva exemple de coding style.

Dacă numărul de erori depistate de checkstyle depășește 30, atunci punctele pentru coding-style nu vor fi acordate. Dacă punctajul este negativ, acesta se trunchiază la 0.

Exemple:

• punctaj_total = 100 și nr_erori = 200 ⇒ nota_finala = 90
• punctaj_total = 100 și nr_erori = 29 ⇒ nota_finala = 100
• punctaj_total = 80 și nr_erori = 30 ⇒ nota_finala = 80
• punctaj_total = 80 și nr_erori = 31 ⇒ nota_finala = 70

Arhiva o veţi urca pe VMChecker Next, unde sunt si informații despre structura ei.

Q: Pot folosi biblioteca “X”?
A: Dacă doriți să folosiți o anumită bibliotecă vă recomandăm să întrebați pe forum, ca apoi să o validăm și să o includem și pe Vmchecker Next. Nu veți uploada pom.xml în arhivă deci nu este suficient doar să modificați acel fișier.

Q: Am descoperit edge case-ul “Y”, trebuie să îl tratez?
A: Nu. Toate datele necesare pentru soluționarea temei vă sunt date in cerință. Dacă totuși am omis ceva ne puteți contacta pe forum.

Q: Pot folosi clase de tip “Enum” pentru constante?
A: Da.

Q: Ce JDK recomandați?
A: 21

Q: Pot să fac în orice ordine testele?
A: Testele sunt incrementale, dar vă recomandăm să le implementați în ordinea dată de noi.

• Schelet de cod
• Soluție oficială etapa 1
• Forum
• Vmchecker Next
• Indicații pentru teme
• Recomandări coding style & javadoc