# mayurdhomne/metacore_lab_android architecture

> Architecture diagram of the GitHub repository mayurdhomne/metacore_lab_android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mayurdhomne/metacore_lab_android
- Repository: https://github.com/mayurdhomne/metacore_lab_android

## Overview

##### Project type and purpose
- This is a native Android mobile application (module “app”) named METACORE_LAB_ANDROID.
- From the package names and README title, it appears to be a laboratory management or analytics app with screens for authentication, dashboards, patient management, testing, reporting, and analytics.

##### File structure
- Top-level Gradle files (build.gradle.kts, settings.gradle.kts, gradle wrapper) indicate a standard Android Studio project.
- Single application module “app” containing:
- AndroidManifest.xml
- Kotlin sources under com.app.metacore, subdivided into ui/auth, ui/dashboard, ui/patients, ui/tests, ui/reports, ui/analytics, plus MainActivity and SplashActivity
- Instrumented and local unit tests.
- Resources: layouts, drawables, menus, values, raw assets, XML rules for backup and data extraction.

##### README for additional insights
- You must infer architecture from code structure and typical Android best practices.

a. Main components to represent
- Android Device (smartphone/tablet) as the runtime container
- Android OS / Application Runtime (Dalvik/ART)
- METACORE_LAB_ANDROID App
– UI Layer: Activities grouped by feature (Auth, Dashboard, Patients, Tests, Reports, Analytics)
– Business Logic Layer (e.g., ViewModels or Presenters if present)
– Data Layer: local storage (SQLite/Room or SharedPreferences), raw resource rules, network client to external Lab API (if any)
- External Services (e.g., Lab backend REST API, Firebase Analytics, remote config)
- Data Store (Cloud DB or on-device DB)
b. Relationships & interactions
- UI Activities communicate with business logic components (ViewModel/Controller) to fetch or update data
- Business logic delegates to the Data Layer for persistence or remote calls
- Data Layer calls External Services over HTTP/HTTPS
- Intents and navigation flows connecting Activities (e.g., Splash → Login → Dashboard → Feature screens)
c. Architectural patterns & design principles
- Layered architecture (Presentation → Domain → Data)
- Feature-based packaging (each feature in its own package)
- Resource separation (layouts, drawables, values)
- Android lifecycle components (Activities + possible ViewModel)
d. Key technologies & frameworks
- Kotlin on Android (ART runtime)
- AndroidX libraries (AppCompat, Material Components, Navigation)
- Gradle/Kotlin DSL for build
- Potential use of Room or Retrofit (if present in Gradle dependencies)
- Data extraction/backup via XML rules

##### Detailed capture of essential elements
- Activities as distinct UI components (SplashActivity, LoginActivity, DashboardActivity, etc.)
- Navigation edges between them
- Resources (layouts, drawables) as supporting artifacts under the UI layer
- Gradle build system as part of the developer/deployment view if desired

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Device and Runtime
    Device["Android Device"]:::external
    Runtime["Android Runtime (ART/Dalvik)"]:::external
    Device --> Runtime
    Runtime --> AppContainer

    subgraph "METACORE_LAB_ANDROID App"
        direction TB

        %% Presentation Layer
        subgraph "UI Layer"
            direction TB
            SplashActivity["SplashActivity"]:::ui
            LoginActivity["LoginActivity"]:::ui
            MainActivity["MainActivity"]:::ui
            DashboardActivity["DashboardActivity"]:::ui
            PatientListActivity["PatientListActivity"]:::ui
            PatientDetailsActivity["PatientDetailsActivity"]:::ui
            AddPatientActivity["AddPatientActivity"]:::ui
            TestListActivity["TestListActivity"]:::ui
            TestDetailsActivity["TestDetailsActivity"]:::ui
            AddTestActivity["AddTestActivity"]:::ui
            ReportsActivity["ReportsActivity"]:::ui
            ReportDetailsActivity["ReportDetailsActivity"]:::ui
            AnalyticsActivity["AnalyticsActivity"]:::ui
        end

        %% Navigation flows
        SplashActivity -->|onCreate| LoginActivity
        LoginActivity -->|loginSuccess| MainActivity
        MainActivity -->|navigate| DashboardActivity
        MainActivity -->|navigate| PatientListActivity
        MainActivity -->|navigate| TestListActivity
        MainActivity -->|navigate| ReportsActivity
        MainActivity -->|navigate| AnalyticsActivity
        PatientListActivity -->|select| PatientDetailsActivity
        PatientListActivity -->|add| AddPatientActivity
        TestListActivity -->|select| TestDetailsActivity
        TestListActivity -->|add| AddTestActivity
        ReportsActivity -->|select| ReportDetailsActivity

        %% Business Logic Layer
        subgraph "Business Logic Layer"
            direction TB
            AuthViewModel["AuthViewModel"]:::logic
            DashboardViewModel["DashboardViewModel"]:::logic
            PatientsViewModel["PatientsViewModel"]:::logic
            TestsViewModel["TestsViewModel"]:::logic
            ReportsViewModel["ReportsViewModel"]:::logic
            AnalyticsViewModel["AnalyticsViewModel"]:::logic
        end

        %% Data Layer
        subgraph "Data Layer"
            direction TB
            Repository["Repository"]:::data
            LocalDB["Local Database (Room)"]:::data
            SharedPrefs["SharedPreferences"]:::data
            NetworkService["NetworkService (Retrofit)"]:::data
        end
    end

    %% Flow between layers
    SplashActivity -->|"use"| AuthViewModel
    LoginActivity -->|"use"| AuthViewModel
    MainActivity -->|"use"| DashboardViewModel
    DashboardActivity -->|"use"| DashboardViewModel
    PatientListActivity -->|"use"| PatientsViewModel
    PatientDetailsActivity -->|"use"| PatientsViewModel
    AddPatientActivity -->|"use"| PatientsViewModel
    TestListActivity -->|"use"| TestsViewModel
    TestDetailsActivity -->|"use"| TestsViewModel
    AddTestActivity -->|"use"| TestsViewModel
    ReportsActivity -->|"use"| ReportsViewModel
    ReportDetailsActivity -->|"use"| ReportsViewModel
    AnalyticsActivity -->|"use"| AnalyticsViewModel

    AuthViewModel -->|"calls"| Repository
    DashboardViewModel -->|"calls"| Repository
    PatientsViewModel -->|"calls"| Repository
    TestsViewModel -->|"calls"| Repository
    ReportsViewModel -->|"calls"| Repository
    AnalyticsViewModel -->|"calls"| Repository

    Repository -->|"persist"| LocalDB
    Repository -->|"storePrefs"| SharedPrefs
    Repository -->|"request"| NetworkService

    NetworkService -->|"HTTP/HTTPS"| LabBackendAPI
    NetworkService -->|"HTTP/HTTPS"| FirebaseService

    %% External Services
    subgraph "External Services"
        direction TB
        LabBackendAPI["Lab Backend REST API"]:::external
        FirebaseService["Firebase Analytics/Config"]:::external
    end

    %% Configuration & Manifest
    GradleConfig["app/build.gradle.kts"]:::data
    AndroidManifest["AndroidManifest.xml"]:::data
    AppContainer["App Process"] --> GradleConfig
    AppContainer --> AndroidManifest

    %% Resource Assets
    Drawables["Drawable Resources"]:::data
    RawAssets["lab_logo.json"]:::data
    XMLRules["Backup/Data Extraction Rules"]:::data

    AppContainer --> Drawables
    AppContainer --> RawAssets
    AppContainer --> XMLRules

    %% Click Events
    click GradleConfig "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/build.gradle.kts"
    click AndroidManifest "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/AndroidManifest.xml"
    click SplashActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/SplashActivity.kt"
    click LoginActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/auth/LoginActivity.kt"
    click MainActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/MainActivity.kt"
    click DashboardActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/dashboard/DashboardActivity.kt"
    click PatientListActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/patients/PatientListActivity.kt"
    click PatientDetailsActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/patients/PatientDetailsActivity.kt"
    click AddPatientActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/patients/AddPatientActivity.kt"
    click TestListActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/tests/TestListActivity.kt"
    click TestDetailsActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/tests/TestDetailsActivity.kt"
    click AddTestActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/tests/AddTestActivity.kt"
    click ReportsActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/reports/ReportsActivity.kt"
    click ReportDetailsActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/reports/ReportDetailsActivity.kt"
    click AnalyticsActivity "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/java/com/app/metacore/ui/analytics/AnalyticsActivity.kt"
    click Drawables "https://github.com/mayurdhomne/metacore_lab_android/tree/main/app/src/main/res/drawable/"
    click RawAssets "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/res/raw/lab_logo.json"
    click XMLRules "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/res/xml/backup_rules.xml"
    click XMLRules "https://github.com/mayurdhomne/metacore_lab_android/blob/main/app/src/main/res/xml/data_extraction_rules.xml"

    %% Styles
    classDef ui fill:#D0E6FF,stroke:#0366d6,stroke-width:1px
    classDef logic fill:#DFFFD0,stroke:#3E8E41,stroke-width:1px
    classDef data fill:#FFF4C1,stroke:#D4A017,stroke-width:1px
    classDef external fill:#F0F0F0,stroke-dasharray: 5 5,stroke:#999
    class SplashActivity,LoginActivity,MainActivity,DashboardActivity,PatientListActivity,PatientDetailsActivity,AddPatientActivity,TestListActivity,TestDetailsActivity,AddTestActivity,ReportsActivity,ReportDetailsActivity,AnalyticsActivity ui
    class AuthViewModel,DashboardViewModel,PatientsViewModel,TestsViewModel,ReportsViewModel,AnalyticsViewModel logic
    class Repository,LocalDB,SharedPrefs,NetworkService,GradleConfig,AndroidManifest,Drawables,RawAssets,XMLRules data
    class Device,Runtime,LabBackendAPI,FirebaseService external
```
