Indholdsfortegnelse

Indledning

Se GM Arkitektur og design for en overordnet arkitekturbeskrivelse.

Formål

Formålet med dette dokument er at beskrive design og arkitektur af app'en

Android app arkitektur

Android app'en er lavet ud fra Google Jetpack Architecture Components guidelines, som er deres anbefalede måde at lave en app på.

Strukturen kan ses herunder:

:app
:build-logic
    :convention
:core
    :data
    :database
    :datastore
    :designsystem
    :model
    :network
    :shared
:feature
    :biometricdialog
    :careplanactivities
    :knowledge
    :more
    :overview
    :useradmission
:TestAssertions

:app

Indeholder MainActivity og roden af navigationen. Den inkluderer feature modulerne, for at binde deres funktionalitet sammen.

:build-logic

Er beskrevet på https://www.nspop.dk/pages/viewpage.action?pageId=121373668#GravidiDK(Android)Guidetiludviklere-BuildLogicmodulet

:core

Indeholder appens "backend", business logic og udstiller modulerne til brug for andre moduler

 :authentication

The core:authentication module provides authentication functionality for the project. It acts as the bridge between the app’s authentication UI/logic and the underlying secure storage and identity management mechanisms. Its main responsibilities include:

• Managing user authentication flows using the TIM (Trifork Identity Management) library.
• Handling storage and retrieval of authentication tokens.
  • The refresh token is stored as an encrypted value on the device and is used to get a new access token. 
• Integrating with Android Keystore and device biometrics to securely store keys.
  • The key for encrypting and decrypting the refresh token is securely stored in Android Keystore. The access to the key is provided through device authentication (biometrics, pin, pattern etc). 
  • Hence, if a user does not have device authentication enabled, the refresh token cannot be stored on the device, and the user is forced to login with MitID for each session.
• Providing an abstraction (IAuthController) for authentication operations, such as login, logout, token retrieval, and user deletion.
• Adapting the TIM library’s storage interface to use device-based secure storage instead of a remote key service.

:data

Repositories, som samler data fra :api og :database

:database

Room database til at holde artikler 

:datastore

Holder på brugerens præferencer (terminsdato, fødselsdato, checklister, sikkerhed osv)

:designsystem

Et fælles sted hvor at UI elementer fra projektets figma er samlet. Optimalt set vil alle elementer i appens design være defineret herinde, således at appen bliver mest ensartet. Dette modul bliver brugt af alle feature moduler, så alle UI moduler bør bruge de samme composables.

:model

Domænespecifikke modeller, som bruges på tværs af moduler.

:network

Bruges til at kommunikerer eksternt til API og andre endpoints.

:shared

Delt logik, som bruges af flere moduler; F.eks. Result bruges på tværs af både :network og :data

:feature

Dette modul består af UI features, som kan vises til brugere

:authentication

Skærme og logik for flows omhandlede onboarding, login med MitID og enhedsautentificering. Nedenstående diagrammer dokumenter de forskellige variatoner af flowet for at logge ind med MitID og registrere sig i appen:

Man kan som anonym bruger vælge at benytte appen uden at logge ind med MitID. For disse brugere vil der ikke blive hentet graviditetsdata, så terminsdatoen skal indtastes manuelt. Brugeren kan beskytte sin app bag enhedsautentificering ved at aktivere dette i indstillinger i appen. 

:careplanactivites

Skærme omhandlende et graviditetsforløb

:knowledge

Vidensskærmen og alle dens undersider

:more

Indeholder indstillinger og "om" sektioner, som linker til privatlivspolitikken og diverse andre sider

:overview

Forsiden af appen; Overbliksiden

:useradmission

Bruges når brugeren har slået biometrisk login til

:TestAssertions

Har logik til at hjælpe med at teste mere effektivt - Dette modul bliver automatisk inkluderet når et modul bruger jacoco-pluginet