# it21834592/emergancy-situation-managment architecture

> Architecture diagram of the GitHub repository it21834592/emergancy-situation-managment, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/it21834592/emergancy-situation-managment
- Repository: https://github.com/it21834592/emergancy-situation-managment

## Overview

This is a **single-module Android application** (Gradle-based) whose primary purpose is to:
- Let users **create and store “Emergency situations”** (title, district, description, photo).
- **Display stored emergencies in a list** (RecyclerView with adapter/viewholder).
- Provide **quick access to emergency contacts (phone calls) and web resources** (browser intents).

So the “system” is mostly **on-device**: UI → local persistence (Room/SQLite) → UI rendering, plus outbound interactions via Android OS (dialer/browser) and possibly image pick/capture for the photo.

##### Data / Persistence layer (Room)
Located in:
`app/src/main/java/com/example/emergancysituationmanagment/database/`
- `Emergency.kt` — Room Entity (table model).
- `EmergencyDao.kt` — DAO interface for queries/inserts/updates.
- `EmergencyDatabase.kt` — Room database definition (SQLite under the hood).
- `EmergencyRepository.kt` — abstraction boundary between UI and DAO.

##### Resources / Views
Located in:
`app/src/main/res/layout/`
- `activity_main.xml`, `fragment_home.xml` — main UI + list UI
- `activity_add_emergencys.xml`, `add_emergency_dialog.xml` — add flow UI
- `viewemergency.xml` — list row layout (used by adapter/viewholder)
- `activity_imargancy_contact.xml` — contact + web links UI

##### Platform/Build/Config
- `AndroidManifest.xml` — declares Activities, permissions (e.g., CALL_PHONE if used, INTERNET if webview/browser usage).
- Gradle files: `build.gradle.kts` (root), `app/build.gradle.kts` (module), wrapper config.

Even though everything ships as one APK, represent containers as logical runtime blocks:
- **Presentation/UI container**
- **Data container (Room / SQLite)**
- **Android OS services container** (Dialer, Browser, Content Providers)

This helps communicate dependencies and responsibilities clearly.

**Presentation components**
- `MainActivity`
- `HomeFragment`
- `AddEmergencys`
- `imargancyContact`
- `EmergencyAdapter`
- `EmergencyViewHolder`

**Data components**
- `EmergencyRepository`
- `EmergencyDao`
- `EmergencyDatabase`
- `Emergency` (entity model)

**Resources**
- Layouts used by each screen (`activity_*`, `fragment_*`, `viewemergency.xml`)

**Platform integrations**
- Intent calls:
- ACTION_DIAL / ACTION_CALL to Dialer
- ACTION_VIEW for URLs to Browser
- (Optional) image picker/camera intents for “photo”

- Presentation Layer: Activities/Fragments + Adapter
- Data Layer: Repository + Room DAO + Database + Entity
- Platform Layer: Android OS intents/services

- “Add emergency” end-to-end (UI → Repo → DAO → Room → UI refresh).
- `MainActivity` → `HomeFragment` / `AddEmergencys` / `imargancyContact` transitions (based on actual navigation).

- Presentation:
- `MainActivity`
- `HomeFragment`
- `AddEmergencys`
- `imargancyContact`
- `EmergencyAdapter`
- `EmergencyViewHolder`
- `MainActivityData`
- Data:
- `EmergencyRepository`
- `EmergencyDao`
- `EmergencyDatabase`
- `Emergency`
- Views (as artifacts attached to components):
- `activity_main.xml` → MainActivity
- `fragment_home.xml` → HomeFragment
- `activity_add_emergencys.xml` + `add_emergency_dialog.xml` → AddEmergencys
- `activity_imargancy_contact.xml` → imargancyContact
- `viewemergency.xml` → ViewHolder/Adapter row

- Whether `HomeFragment` observes LiveData/Flow or manually queries.
- Whether `MainActivityData` is a ViewModel, singleton, or simple data class.
- How “photo” is implemented (URI string stored in DB? bitmap? file path?), and which Android provider it uses—then add that external dependency explicitly.

## Diagram (Mermaid)

```mermaid
flowchart TD

%% =========================
%% Context (C4-L1)
%% =========================
subgraph "System Context (On-device Android App)"
  direction TB

  U["User"]:::external

  subgraph "Emergency Situation Management App (Android APK)"
    direction TB

    APP["App Boundary"]:::boundary

    subgraph "Presentation Layer (UI)"
      direction TB
      MA["MainActivity"]:::ui
      HF["HomeFragment"]:::ui
      AE["AddEmergencys"]:::ui
      IC["imargancyContact"]:::ui

      MAD["MainActivityData"]:::state

      subgraph "RecyclerView Rendering"
        direction TB
        AD["EmergencyAdapter"]:::ui
        VH["EmergencyViewHolder"]:::ui
      end
    end

    subgraph "Data Layer (Repository + Room)"
      direction TB
      REPO["EmergencyRepository\n<<Repository>>"]:::data

      subgraph "Room Persistence"
        direction TB
        DAO["EmergencyDao\n<<DAO>>"]:::dao
        DB["EmergencyDatabase\n<<RoomDatabase>>"]:::db
        ENT["Emergency\n<<Entity>>"]:::entity
        SQLITE[("SQLite (on-device storage)")]:::sqlite
      end
    end

    subgraph "Resources (XML Layouts)"
      direction TB
      L_MAIN["activity_main.xml"]:::res
      L_HOME["fragment_home.xml"]:::res
      L_ADD["activity_add_emergencys.xml"]:::res
      L_ADD_DLG["add_emergency_dialog.xml"]:::res
      L_CONTACT["activity_imargancy_contact.xml"]:::res
      L_ROW["viewemergency.xml"]:::res
    end

    subgraph "Platform/Config"
      direction TB
      MAN["AndroidManifest.xml"]:::config
      GRADLE["app/build.gradle.kts"]:::config
    end
  end

  subgraph "Android OS / External Apps & Services"
    direction TB
    OS["Android OS (Intents/Permissions)"]:::platform
    DIALER["Phone Dialer / Telephony"]:::external
    BROWSER["Web Browser"]:::external
    MEDIA["Camera / Image Picker / Storage Provider"]:::external
  end
end

%% =========================
%% Relationships / Flows
%% =========================

%% User interactions / navigation
U -->|"uses"| MA
MA -->|"hosts"| HF
MA -->|"navigatesTo"| AE
MA -->|"navigatesTo"| IC
MA -->|"coordinates"| MAD
HF -->|"uses"| MAD
AE -->|"uses"| MAD

%% Layout bindings
MA -->|"inflates"| L_MAIN
HF -->|"inflates"| L_HOME
AE -->|"inflates"| L_ADD
AE -->|"showsDialog"| L_ADD_DLG
IC -->|"inflates"| L_CONTACT
VH -->|"bindsRow"| L_ROW

%% Data access (strict layering)
HF -->|"getEmergencies()"| REPO
AE -->|"insertEmergency()"| REPO
REPO -->|"calls"| DAO
DAO -->|"managedBy"| DB
DB -->|"persistsTo"| SQLITE
DAO -->|"mapsTo"| ENT

%% List rendering
HF -->|"setsAdapter"| AD
AD -->|"creates/binds"| VH

%% UI refresh (observation unspecified; show as refresh trigger)
AE -.->|"navigateBack/refreshList"| HF

%% Platform intents
IC -->|"startActivity(Intent)\nACTION_DIAL/ACTION_CALL"| OS
OS -->|"routesTo"| DIALER
IC -->|"startActivity(Intent)\nACTION_VIEW(URL)"| OS
OS -->|"routesTo"| BROWSER

%% Photo capture/selection (optional)
AE -->|"startActivityForResult/ActivityResult\npick/capturePhoto"| OS
OS -->|"routesTo"| MEDIA

%% Config dependencies (declarations only)
MAN -->|"declaresActivities/permissions"| OS
GRADLE -->|"addsDeps(Room/RecyclerView)"| APP

%% =========================
%% Click Events (from mapping)
%% =========================
click MA "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/java/com/example/emergancysituationmanagment/MainActivity.kt"
click HF "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/java/com/example/emergancysituationmanagment/HomeFragment.kt"
click AE "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/java/com/example/emergancysituationmanagment/AddEmergencys.kt"
click IC "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/java/com/example/emergancysituationmanagment/imargancyContact.kt"
click AD "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/java/com/example/emergancysituationmanagment/EmergencyAdapter.kt"
click VH "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/java/com/example/emergancysituationmanagment/EmergencyViewHolder.kt"
click MAD "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/java/com/example/emergancysituationmanagment/MainActivityData.kt"

click REPO "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/java/com/example/emergancysituationmanagment/database/EmergencyRepository.kt"
click DAO "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/java/com/example/emergancysituationmanagment/database/EmergencyDao.kt"
click DB "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/java/com/example/emergancysituationmanagment/database/EmergencyDatabase.kt"
click ENT "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/java/com/example/emergancysituationmanagment/database/Emergency.kt"

click L_MAIN "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/res/layout/activity_main.xml"
click L_HOME "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/res/layout/fragment_home.xml"
click L_ADD "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/res/layout/activity_add_emergencys.xml"
click L_ADD_DLG "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/res/layout/add_emergency_dialog.xml"
click L_CONTACT "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/res/layout/activity_imargancy_contact.xml"
click L_ROW "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/res/layout/viewemergency.xml"

click MAN "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/src/main/AndroidManifest.xml"
click GRADLE "https://github.com/it21834592/emergancy-situation-managment/blob/master/app/build.gradle.kts"

%% =========================
%% Styles
%% =========================
classDef boundary fill:#E8F0FF,stroke:#2F5FB3,stroke-width:2,color:#0B1B3A;
classDef ui fill:#D7EBFF,stroke:#1D6FA5,stroke-width:1.5,color:#0B1B3A;
classDef state fill:#CFE7FF,stroke:#1C4E80,stroke-width:1.5,color:#0B1B3A;
classDef data fill:#FFF2B3,stroke:#B58100,stroke-width:1.5,color:#3A2A00;
classDef dao fill:#FFE7A3,stroke:#B58100,stroke-width:1.5,color:#3A2A00;
classDef db fill:#CFF5D6,stroke:#2B8A3E,stroke-width:1.8,color:#0E2B14;
classDef sqlite fill:#BFF0C8,stroke:#2B8A3E,stroke-width:2,color:#0E2B14;
classDef entity fill:#D9F7DE,stroke:#2B8A3E,stroke-width:1.2,color:#0E2B14;
classDef res fill:#F2E6FF,stroke:#6F42C1,stroke-width:1.2,color:#2A114A;
classDef platform fill:#E6E6E6,stroke:#666666,stroke-width:1.5,color:#1F1F1F;
classDef external fill:#F0F0F0,stroke:#7A7A7A,stroke-width:1.5,color:#1F1F1F;
classDef config fill:#EDEDED,stroke:#4B4B4B,stroke-width:1.2,color:#1F1F1F;
```
