• Cílem projektu bylo vytvořit zjednodušenou poštovní aplikaci, která by umožňovala podání a zpracování zásilek.
• Aplikace obsahuje přihlášení dle rolí - Customer a Admin.
• K ukládání dat je možné využívat buď soubory nebo DB.
• Jako externí knihovna byl použit JUnit.

• V aplikace jsou používána data všech adres v ČR. Data jsou z RÚIAN.
• Knihovna AddressLibrary podporuje získávání adres podle ID nebo podle adresy
  • Adresa musí být ve formátu nazevUlice + cisloPopisny (případně ještě /cisloOrientacni) + psc
  • Pokud adresa nemá název ulice, tak je taky podporováno obec + cisloPopisny + psc

Aplikace podporuje 2 typy zásilek, které se dělí na podtypy

1. Psaní

• Doporučené psaní
• Cenné psaní

2. Balík

Dělí se dle velikosti

• S <= 35 cm
• M <= 50 cm
• L <= 100 cm

Dále uvádím větvenní menu jako ukázku funkcí:

• Menu pro nepřihlášené:

    - Sledování zásilky
        - Výběr filtrování
    - Přihlášení
    - Registrace
    - O aplikaci
    - Ukončit
  

• Menu pro zákazníka:

    - Sledování zásilky
      - Výběr filtrování
    - Registrace zásilky
    - Odhlásit
  

• Menu pro admina:

    - Sklad
        - Sledování zásilky
            - Výběr filtrování
        - Odeslání transportu
        - Odhlásit
    - Pobočka pošty
        - Zásilky na skladě
        - Přijmutí zásilky
        - Odeslat transport do centrálního skladu
        - Roznést zásilky v našem PSČ
        - Odhlásit
  

Aplikace může běžet buď na datech ze souborů nebo z databáze. V této sekci si představíme strukturu souborů. Soubory jsou uloženy v data/storage/*.csv ve formátu csv s oddělovačem ,.

• users.csv

• mails.csv

• post_offices.csv

Aplikace používá knihovnu JUnit. Stěžejní chování je tedy testováno tímto způsobem. Ukázka jednotkového testu:

import org.junit.jupiter.api.Disabled;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;

import static org.junit.jupiter.api.Assertions.*;

class AuthTest {

  @Test
  @DisplayName("Hashování")
  void hash() {
    String password = "mojetajneheslo";

    assertEquals(
            "9255d313f3f60aadae......",
            Auth.hash(password),
            "Hash"
    );

  }

  @Test
  @DisplayName("Přihlášení")
  void login() throws StorageException {
    System.out.println("storageUsed: "+ Datastore.getStorageUsed());

    String email = "[email protected]";
    String password = "mojeheslo";

    assertTrue(Auth.login(email,password),"Kontrola přihlášení");
  }
}

• JUnit poskytuje mnoho typu testu, testy se volají metodou assertXXX - např: assertEquals, assertTrue, assertNotNull

• Každá testovací metoda musí být opatřena anotací @Test, můžeme uvést i název testu pomocí @DisplayName(...)

• První test nám kontroluje hashování hesel

• Druhý test zkouší funkčnost přihlašování