-
Notifications
You must be signed in to change notification settings - Fork 0
Utvalgt detaljdesign


Figur 8: Detaljdesign av databasemodellen
Som utvalgt detaljdesign har gruppen valgt å fokusere på databasemodellen, ettersom den danner grunnlaget for flere av HelpingHands sentrale funksjoner. Modellen omfatter brukere, gjenstander og låneforespørsler, samt håndtering av bildeopplastning og bilder tilknyttet gjenstander.
Figur 8 viser databasens oppbygging gjennom et ER-diagram og dataordbok. Diagrammet viser sentrale entiteter, deres attributter, relasjoner mellom hverandre og tilhørende kardinaliteter. Dataordboken beskriver attributtenes betydning og domener.
Databasen er implementert i PostgreSQL og bygger på en relasjonell struktur. Tabellene knyttes sammen ved hjelp av primærnøkler (PK) og fremmednøkler (FK), som bidrar til å sikre referanseintegritet. Modellen tar utgangspunkt i prinsipper for normalisering, der informasjon organiseres i separate tabeller for å redusere dataredundans og inkonsistente data. Som eksempel refererer items og lending_requests til users gjennom fremmednøkler, dermed unngås lagring av brukeropplysninger direkte i hver tabell. Låneforespørsler på sin side inneholder referanser til utlåner og låntaker, som muliggjør for én enkelt bruker å opptre i begge roller.
For bildehåndtering benyttes tabellene uploads og item_images, hvor førstnevnte benyttes til lagring av metadata for opplastede filer, mens sistnevnte fungerer som koblingstabell mellom bilder og gjenstander. Selve bildefilene lagres i objektlagringstjenesten Cloudflare R2 fremfor PostgreSQL, ettersom objektlagring er bedre egnet til lagring og overføring av større binære filer. Dette reduserer lagringsbelastningen på databasen og gjør det mulig å skalere bildelagringen uavhengig av den relasjonelle databasen. Ved opplastning av et bilde benyttes en tidsbegrenset, signert URL som overfører filen direkte til R2. Dermed trenger backenden kun å kontrollere gyldigheten av filen og registrere den som fullført. Koblingstabellen benytter en sammensatt primærnøkkel av item_id og upload_id, som gjør at samme bildet ikke kan knyttes til samme gjenstand flere ganger.
For å videre ivareta dataintegritet håndheves en rekke forretningsregler gjennom integritetsbegrensninger av PostgreSQL. Eksempelvis forhindres samme bruker å kunne legge inn flere ventende låneforespørsler for samme gjenstand. Dermed kan utlåner forvente at de ventende forespørslene på en enkelt gjenstand kommer fra forskjellige brukere, mens databasen unngår lagring av dupliserte forespørsler.
Begrensningene er implementert på databasenivå for å sikre at reglene håndheves konsistent, uavhengig av applikasjonens validering. Dette er særlig viktig når flere forespørsler behandles samtidig, da separate kontroller i backenden kan medføre godkjenning av operasjoner basert på utdatert informasjon. Et eksempel er hvordan to låneforespørsler for samme gjenstand forsøkes godkjent med overlappende utlånsperioder. Ved å håndheve begrensningene direkte i PostgreSQL forhindres motstridende godkjenninger, selv når flere forespørsler behandles parallelt.
Låneforespørsler har en definert livssyklus med fem mulige statuser: pending, approved, rejected, cancelled og returned. Den gjeldende statusen er den som lagres i lending_requests, mens for å registrere en endring i status tas det i bruk lending_request_events. Hver hendelse inneholder informasjon om statusen forespørselen fikk, hvilken aktør som utførte endringen og når den ble utført. Statusendringen og registrering av tilhørende hendelse utføres i samme databasetransaksjon, som sikrer at begge operasjonene enten gjennomføres eller avbrytes samlet, slik at gjeldende status og historikk holdes konsistent.