1. Bevezetés
Ennek a dokumentumnak a célja egy alapos analízis modell bemutatása, amely hatékony és konkrét iránymutatásokat nyújt a mobil applikáció fejlesztése során. Az analízis modell kiemelt figyelmet szentel a szoftver finomhangolásának és a felhasználói elégedettség fokozásának.2. Kezdeti osztálydiagram
- 2.1 Osztálydiagram
- 2.2 Osztályok felsorolása
- Person:
Az alkalmazásban minden felhasználó (végfelhasználó, dolgozó vagy admin) alapvető adatait és autentikációs logikáját biztosító alaposztály. - User:
A végfelhasználókat reprezentáló osztály, amely kezeli a rendeléseket, a kosarat, a mentett címeket és fizetési módokat. - Worker:
Az éttermi dolgozókat reprezentáló osztály, amely felelős az étlap kezeléséért, a rendelések állapotának frissítéséért és a napi ajánlatok meghatározásáért. - Admin:
Az adminisztrátorok jogosultságait kezelő osztály, amely lehetőséget nyújt a felhasználói fiókok és a rendszer beállításainak felügyeletére. - Cart:
A felhasználók kosarát kezelő osztály, amely tartalmazza a hozzáadott ételeket és az aktuális rendelés összegét számolja ki. - CartItem:
A kosár egy-egy elemét reprezentáló osztály, amely a rendelt menüpontot és annak mennyiségét tárolja. - Order:
A rendeléseket reprezentáló osztály, amely tartalmazza az adott rendelés részleteit, állapotát és a hozzá kapcsolódó szállítási információkat. - MenuItem:
Az étlap egy-egy elemét reprezentáló osztály, amely tartalmazza az étel nevét, árát, kategóriáját és elérhetőségét. - Address:
A felhasználók által mentett szállítási címeket kezelő osztály, amely tárolja az utcát, várost, irányítószámot és országot. - PaymentMethod:
A felhasználók által mentett fizetési módokat reprezentáló osztály, amely tárolja a fizetési típusokat és részleteket. - Log:
A rendszerben végrehajtott műveletekről készült naplóbejegyzéseket tároló osztály, amely az auditálásért felelős. - Server:
A központi szervert reprezentáló osztály, amely kezeli a kliensek kéréseit, továbbítja az adatokat, és kommunikál az adatbázissal és API-kkal. - DatabaseConnection:
Az adatbázishoz való kapcsolódásért felelős osztály, amely végrehajtja az SQL-lekérdezéseket és a kapcsolat kezelését biztosítja. - APIManager:
Az API-integrációk kezelését végző osztály, amely biztosítja az adatcserét a külső szolgáltatásokkal (SimplePay, Billingo, Google Maps). - SimplePayIntegration:
A SimplePay fizetési rendszerhez kapcsolódó műveleteket kezelő osztály, amely a fizetések elindítását és ellenőrzését végzi. - BillingoIntegration:
A Billingo számlázórendszer integrációját kezelő osztály, amely felelős a számlák generálásáért és elküldéséért. - GoogleMapsIntegration:
A Google Maps szolgáltatások integrációját biztosító osztály, amely térképes megjelenítést és útvonaltervezést végez. - Client:
Az ügyféloldali eszközöket reprezentáló osztály, amely a szerverrel való kommunikációt és az adatok szinkronizálását kezeli.
- Person:
- 2.3 Alrendszerek
- 2.3.1. Megjelenítés alrendszer
Leírás:
Ez az alrendszer a felhasználói interfészekért felelős, biztosítja a rendszer által nyújtott funkciókhoz szükséges interakciókat és az adatok megjelenítését. A mobilalkalmazás és a kliens eszközök működését támogatja.
Osztályok:
Client - 2.3.2. Üzleti logika alrendszer
Leírás:
Az üzleti logika alrendszer biztosítja az alkalmazás alapvető funkcióinak végrehajtását, például a rendeléskezelést, a kosárkezelést, és a felhasználói jogosultságok ellenőrzését. Ide tartoznak azok az osztályok, amelyek közvetlenül végrehajtják a rendszer használati eseteit.
Osztályok:
Person
User
Worker
Admin
Cart
CartItem
Order
MenuItem
Address
PaymentMethod
Log - 2.3.3. Adatkezelés alrendszer
Leírás:
Ez az alrendszer felelős az adatok tárolásáért és kezeléséért, az adatbázis-kapcsolat fenntartásáért, valamint az adatok lekérdezéséért és módosításáért.
Osztályok:
DatabaseConnection - 2.3.4. Integrációs réteg alrendszer
Leírás:
Ez az alrendszer a külső API-k integrációját valósítja meg. A fizetési rendszerek, a számlázási szolgáltatás és a térkép megjelenítéséért felelős osztályokat foglalja magában.
Osztályok:
APIManager
SimplePayIntegration
BillingoIntegration
GoogleMapsIntegration - 2.3.5. Kiszolgálói kommunikáció alrendszer
Leírás:
Ez az alrendszer a szerver működését és a kliensekkel való kommunikációt irányítja. Felelős a kérések feldolgozásáért és az adatok továbbításáért a megfelelő alrendszerekhez.
Osztályok:
Server
- 2.3.1. Megjelenítés alrendszer
3. Az első alrendszer modellje
- 3.1 Statikus modell - kapcsoaltok pontosítása
- 3.1.1 Megjelenítási alrendszer
A Megjelenítés alrendszerhez tartozik a Client, a HTTPRequest, és a HTTPResponse, amelyek a felhasználói interakciókat és a szerverrel való kommunikációt kezelik.
Client
Attribúrumok:
deviceId
userId
sessionToken
appVersion
deviceType
Metódusok:
sendRequest()
receiveResponse()
handleError()
syncDataWithServer()
- 3.1.2 Üzleti logika alrendszer
Az Üzleti logika alrendszerhez tartozik a Person, a User, a Worker, az Admin, a Cart, a CartItem, az Order, a MenuItem, az Address, a PaymentMethod, és a Log, amelyek a rendszer fő funkcióit és a kapcsolódó üzleti logikát valósítják meg.
Person
Attribúrumok:
id
name
email
password
phoneNumber
address
Metódusok:
login()
requestNewPassword()
User
Attribúrumok:
cart
orderHistory
savedPaymentMethods
savedAddresses
notificationPreferences
points
Metódusok:
register()
updateProfile()
addToCart()
removeFromCart()
placeOrder()
rateOrder()
Worker
Attribúrumok:
restaurantId
role
Metódusok:
viewOrders()
updateOrderStatus()
manageMenu()
Admin
Attribúrumok:
permissions
Metódusok:
manageUsers()
viewAuditLogs()
updatePaymentSettings()
Cart
Attribúrumok:
id
items
total
Metódusok:
addItem()
removeItem()
calculateTotal()
CartItem
Attribúrumok:
menuItem
quantity
Metódusok:
updateQuantity()
Order
Attribúrumok:
id
userId
status
items
total
deliveryAddress
Metódusok:
trackOrder()
cancelOrder()
MenuItem
Attribúrumok:
id
name
description
price
category
availability
Metódusok:
updateAvailability()
Address
Attribúrumok:
id
street
city
zipCode
country
Metódusok:
updateAddress()
PaymentMethod
Attribúrumok:
id
type
details
Metódusok:
updateDetails()
Log
Attribúrumok:
id
action
timestamp
userId
Metódusok:
filterLogs()
- 3.1.3 Adatkezelés alrendszer
Az Adatkezelés alrendszerhez tartozik a DatabaseConnection, amely az adatbázis-kapcsolatot kezeli.
DatabaseConnection
Attribúrumok:
host
port
databaseName
username
password
Metódusok:
connect()
disconnect()
executeQuery()
- 3.1.4 Integrációs réteg alrendszer
Az Integrációs réteg alrendszerhez tartozik az APIManager, a SimplePayIntegration, a BillingoIntegration, és a GoogleMapsIntegration, amelyek a külső szolgáltatásokkal történő kommunikációért felelősek.
APIManager
Attribúrumok:
apiEndpoints
apiKeys
Metódusok:
sendRequest()
handleResponse()
SimplePayIntegration
Attribúrumok:
merchantId
apiSecret
paymentEndpoint
Metódusok:
initiatePayment()
verifyPayment()
Client
Attribúrumok:
apiKey
invoiceEndpoint
Metódusok:
generateInvoice()
sendInvoice()
Client
Attribúrumok:
apiKey
mapsEndpoint
Metódusok:
getMap()
calculateRoute()
- 3.1.5 Kiszolgálói kommunikáció alrendszer
A Kiszolgálói kommunikáció alrendszerhez tartozik a Server, amely biztosítja a szerver és a kliensek közötti kommunikációt.
Server
Attribúrumok:
host
port
connectedClients
Metódusok:
startServer()
stopServer()
handleRequest()
- 3.1.1 Megjelenítási alrendszer
- 3.2 Dinamikus modell
- 3.3 Funkcionális modell
- 3.4 Az analízis modell osztálydiagramja
- 3.4.1 Client
Felelőssége, feladata:
Az ügyféloldali eszközöket reprezentálja, kezeli a szerverrel való kommunikációt, és biztosítja az adatok szinkronizálását az eszköz és a szerver között.
Együttműködők:
Server, HTTPRequest, HTTPResponse
Attribútumok:
Név Típus Leírás deviceId String Az eszköz egyedi azonosítója. userId int A bejelentkezett felhasználó azonosítója. sessionToken String Az aktuális munkamenet tokenje. appVersion String Az alkalmazás verziószáma. deviceType String Az eszköz típusa (pl. iOS, Android).
Operációk:
Név Argumentumok Leírás sendRequest endpoint: String, data: Map<String, String> HTTP-kérést küld a szerver megfelelő végpontjára. receiveResponse response: HTTPResponse A szerver által visszaküldött válasz feldolgozása. handleError error: APIResponse Hiba kezelése: újrapróbálkozás vagy értesítés megjelenítése. syncDataWithServer - Az eszköz adatainak szinkronizálása a szerverrel.
- 3.4.2 Person
Felelőssége, feladata:
Az alaposztály minden felhasználói entitás számára. Kezeli az általános adatokat (pl. név, email) és az autentikációt.
Együttműködők:
User, Worker, Admin
Attribútumok:
Név Típus Leírás id int Egyedi azonosító minden felhasználóhoz. name String A felhasználó neve. email String A felhasználó email címe. password String A felhasználó jelszava. phoneNumber String A felhasználó telefonszáma. address String A felhasználó alapértelmezett címe.
Operációk:
Név Argumentumok Leírás login email, password A felhasználó hitelesítése a megadott adatokkal. requestNewPassword email Új jelszó igénylése a megadott email címre.
- 3.4.3 User
Felelőssége, feladata:
A végfelhasználói entitás reprezentálása. Kezeli a kosarat, a mentett fizetési módokat, és a rendeléseket.
Együttműködők:
Cart, Order, PaymentMethod, Address, Person
Attribútumok:
Név Típus Leírás cart Cart A felhasználó kosara. orderHistory List<Order> A felhasználó korábbi rendelései. savedPaymentMethods List<PaymentMethod> A felhasználó mentett fizetési módjai. savedAddresses List A felhasználó mentett címei. notificationPreferences Map<String, boolean> Értesítési beállítások. points int A felhasználó által gyűjtött pontok száma.
Operációk:
Név Argumentumok Leírás register name, email, password Új felhasználói fiók létrehozása. updateProfile data: Map<String, String> Felhasználói profiladatok frissítése. addToCart item: MenuItem, quantity: int Tétel hozzáadása a kosárhoz. removeFromCart item: MenuItem Tétel eltávolítása a kosárból. placeOrder - A kosár tartalmából rendelés készítése. rateOrder orderId: int, rating: int Rendelés értékelése a megadott pontszámmal.
- 3.4.4 Worker
Felelőssége, feladata:
Az éttermi dolgozók reprezentálása, akik az étlap és a rendelési folyamatokat kezelik.
Együttműködők:
Order, MenuItem, Person
Attribútumok:
Név Típus Leírás restaurantId int Az adott dolgozó által kezelt étterem azonosítója. role String A dolgozó szerepköre az étteremben.
Operációk:
Név Argumentumok Leírás viewOrders - Bejövő rendelések listájának megtekintése. updateOrderStatus orderId: int, status: String Rendelés állapotának módosítása. manageMenu action: String, menuItem: MenuItem Az étlap kezelése (hozzáadás, törlés, módosítás).
- 3.4.5 Admin
Felelőssége, feladata:
A rendszergazdák jogosultságainak és adminisztratív műveleteinek kezelése.
Együttműködők:
Log, Person, User
Attribútumok:
permissions List<String> Az admin által elvégezhető műveletek listája. id int leiras
Operációk:
Név Argumentumok Leírás manageUsers action: String, userId: int Felhasználói fiókok kezelése (pl. törlés, módosítás). viewAuditLogs - Naplóbejegyzések megtekintése a rendszerből. updatePaymentSettings settings: Map<String, String> Fizetési beállítások módosítása.
- 3.4.6 Cart
Felelőssége, feladata:
A felhasználó által kiválasztott termékek és azok mennyiségének tárolása, valamint a teljes összeg kiszámítása a rendelés leadásához.
Együttműködők:
User, CartItem
Attribútumok:
Név Típus Leírás id int A kosár egyedi azonosítója. item List<CartItem> A kosárban lévő tételek listája. total float A kosárban lévő termékek teljes összege.
Operációk:
Név Argumentumok Leírás addItem item: MenuItem, quantity: int Új tételt ad a kosárhoz a megadott mennyiségben. removeItem item: MenuItem Egy tételt eltávolít a kosárból. calculateTotal - Újraszámolja a kosárban lévő tételek teljes összegét.
- 3.4.7 CartItem
Felelőssége, feladata:
A kosár egy-egy elemét reprezentálja, amely tartalmazza a menüelemet és annak mennyiségét.
Együttműködők:
Cart, MenuItem
Attribútumok:
Név Típus Leírás menuItem MenuItem A kosárban lévő tétel. quantity int A tételhez rendelt darabszám.
Operációk:
Név Argumentumok Leírás updateQuantity quantity: int Frissíti a tétel darabszámát a megadott értékre.
- 3.4.8 Order
Felelőssége, feladata:
A felhasználók által leadott rendeléseket reprezentálja, tárolja a rendeléssel kapcsolatos információkat, például az állapotot, a tételeket, és a szállítási címet.
Együttműködők:
User, CartItem, Address
Attribútumok:
Név Típus Leírás id int A rendelés egyedi azonosítója. userId int A rendelést leadó felhasználó azonosítója. status String A rendelés aktuális állapota (pl. "Feldolgozás alatt"). items List<CartItem> A rendeléshez tartozó tételek listája. total float A rendelés teljes összege. deliveryAddress Address A rendeléshez tartozó szállítási cím.
Operációk:
Név Argumentumok Leírás trackOrder - Visszaadja a rendelés aktuális státuszát. cancelOrder - Törli a rendelést, ha még nem került feldolgozásra.
- 3.4.9 MenuItem
Felelőssége, feladata:
Az étlap egy-egy elemét reprezentálja, amely tartalmazza az étel nevét, árát, kategóriáját és elérhetőségét.
Együttműködők:
CartItem
Attribútumok:
Név Típus Leírás id int A menüelem egyedi azonosítója. name String Az étel neve. description String Az étel leírása. price float Az étel ára. category String Az étel kategóriája (pl. "Levesek"). availability boolean Az étel elérhetősége.
Operációk:
Név Argumentumok Leírás updateAvailability status: boolean Frissíti az étel elérhetőségi állapotát.
- 3.4.10 Address
Felelőssége, feladata:
A felhasználók által megadott szállítási címeket reprezentálja, amelyeket a rendszer a rendeléseknél használ.
Együttműködők:
User, Order
Attribútumok:
Név Típus Leírás id int A cím egyedi azonosítója. street String Az utca neve és házszám. city String A város neve. zipCode String Az irányítószám. country String Az ország neve.
Operációk:
Név Argumentumok Leírás updateAddress data: Map<String, String> Frissíti a cím adatait a megadott értékekkel.
- 3.4.11 PaymentMethod
Felelőssége, feladata:
A felhasználók által mentett fizetési módokat reprezentálja, amelyeket a rendszer a fizetési folyamat során használ.
Együttműködők:
User, Order
Attribútumok:
Név Típus Leírás id int A fizetési mód egyedi azonosítója. type String A fizetési mód típusa (pl. "Bankkártya"). details String A fizetési mód részletei (pl. kártyaszám).
Operációk:
Név Argumentumok Leírás updateDetails data: String Frissíti a fizetési módhoz tartozó részleteket.
- 3.4.12 Log
Felelőssége, feladata:
A rendszerben végzett műveletekről készült naplóbejegyzéseket tárolja, amelyek az auditálást és a hibakeresést segítik.
Együttműködők:
Admin, DatabaseConnection
Attribútumok:
Név Típus Leírás id int A naplóbejegyzés egyedi azonosítója. action String A rendszerben végrehajtott művelet leírása. timestamp Date A naplózott esemény időbélyege. userId int Az eseményt végrehajtó felhasználó azonosítója.
Operációk:
Név Argumentumok Leírás filterLogs criteria: Map<String, String> A naplóbejegyzések szűrése a megadott kritériumok alapján.
- 3.4.13 DatabaseConnection
Felelőssége, feladata:
Az adatbázissal való kapcsolódásért és az adatkezelési műveletek végrehajtásáért felelős osztály.
Együttműködők:
Üzleti logika alrendszer, Log
Attribútumok:
Név Típus Leírás host String Az adatbázis szerverének címe. port int Az adatbázis kapcsolat portja. databaseName String Az adatbázis neve. username String Az adatbázishoz való kapcsolódáshoz használt felhasználónév. password String Az adatbázishoz való kapcsolódáshoz használt jelszó.
Operációk:
Név Argumentumok Leírás connect - Kapcsolódik az adatbázishoz a megadott hitelesítési adatokkal. disconnect - Megszakítja az adatbáziskapcsolatot. executeQuery query: String Végrehajt egy SQL-lekérdezést vagy módosítást az adatbázisban.
- 3.4.14 ApiManager
Felelőssége, feladata:
Kezeli a rendszer és a külső API-k közötti kommunikációt, biztosítva az adatok megfelelő továbbítását és fogadását.
Együttműködők:
SimplePayIntegration, BillingoIntegration, GoogleMapsIntegration
Attribútumok:
Név Típus Leírás apiEndpoints Map<String, String> Az egyes API-k végpontjainak URL-jei. apiKeys Map<String, String> Az API-khoz tartozó hitelesítési kulcsok.
Operációk:
Név Argumentumok Leírás sendRequest api: String, data: Map<String, String> Adatok küldése a megadott API-nak. handleResponse api: String, response: APIResponse Az API-tól érkező válasz feldolgozása.
- 3.4.15 SimplePayIntegration
Felelőssége, feladata:
A SimplePay fizetési szolgáltatás integrációját biztosítja, amely lehetővé teszi a rendszer számára az online fizetések végrehajtását és ellenőrzését.
Együttműködők:
ApiManager, Order
Attribútumok:
Név Típus Leírás merchantId String A SimplePay által kiadott kereskedői azonosító. apiSecret String A SimplePay hitelesítési titkos kulcsa. paymentEndpoint String A SimplePay fizetési végpontjának URL-je.
Operációk:
Név Argumentumok Leírás initiatePayment orderId: int, amount: float Új fizetési tranzakciót indít a SimplePay-en keresztül. verifyPayment transactionId: String Ellenőrzi, hogy a fizetési tranzakció sikeresen megtörtént-e.
- 3.4.16 BillingoIntegration
Felelőssége, feladata:
A Billingo számlázórendszer integrációját biztosítja, lehetővé téve számlák automatikus generálását és továbbítását a rendelési folyamat során.
Együttműködők:
ApiManager, Order, User
Attribútumok:
Név Típus Leírás apiKey String A Billingo API használatához szükséges kulcs. invoiceEndpoint String A Billingo számlázási végpontjának URL-je.
Operációk:
Név Argumentumok Leírás generateInvoice orderId: int, user: User Számlát készít a rendelés és a felhasználó adatai alapján. sendInvoice invoiceId: String, email: String Az elkészült számlát elküldi a megadott email címre.
- 3.4.17 GoogleMapsIntegration
Felelőssége, feladata:
A Google Maps szolgáltatások integrációját biztosítja, lehetővé téve térképmegjelenítést és útvonaltervezést a rendszerben.
Együttműködők:
ApiManager, Address, Order
Attribútumok:
Név Típus Leírás apiKey String A Google Maps API használatához szükséges kulcs. mapsEndpoint String A Google Maps API végpontjának URL-je.
Operációk:
Név Argumentumok Leírás getMap location: Address Megjeleníti a megadott címhez tartozó térképet. calculateRoute origin: Address, destination: Address Útvonalat számít ki a kiindulási és célállomás között.
- 3.4.18 Server
Felelőssége, feladata:
A rendszer központi szervere, amely a kliensektől érkező kéréseket kezeli, végrehajtja az üzleti logikát, és kommunikál a külső szolgáltatásokkal, valamint az adatbázissal.
Együttműködők:
Client, DatabaseConnection, ApiManager, Order
Attribútumok:
Név Típus Leírás host String A szerver címe. port int A szerver kapcsolati portja. connectedClients List<Client> Az aktuálisan csatlakozott kliensek listája.
Operációk:
Név Argumentumok Leírás startServer - Elindítja a szervert, és fogadja a beérkező kéréseket. stopServer - Leállítja a szervert és a kapcsolódásokat. handleRequest request: HTTPRequest Feldolgozza a klienstől érkező kérést, és továbbítja az üzleti logika alrendszerhez. sendResponse response: HTTPResponse A kérést feldolgozva válasz küldése a kliensnek.
- 3.4.1 Client
