# miracleyosuak/android-project architecture

> Architecture diagram of the GitHub repository miracleyosuak/android-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/miracleyosuak/android-project
- Repository: https://github.com/miracleyosuak/android-project

## Overview

Wazuh Mobile is an Android security-monitoring app. Users register or sign in, then the main activity routes them to dashboard, alert/event, or server-settings views; those views fetch data through ApiClient and render agents and alerts. The README also describes backend AI summaries and notification support. Backend internals are included as distinct subsystems, but their connections are not asserted because their implementation excerpts were not provided; the documented Wazuh/OpenAI integrations are shown as unverified. Some secondary Android behavior is likewise inferred only from indexed references.

Main entry points: [`app/src/main/java/com/wazuh/mobile/ApiClient.java`](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/ApiClient.java) (API client), [`app/src/main/java/com/wazuh/mobile/MainActivity.java`](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/MainActivity.java) (Main navigation), [`back-end/appv13.py`](https://github.com/miracleyosuak/android-project/blob/main/back-end/appv13.py) (Application API), [`app/src/main/java/com/wazuh/mobile/LoginActivity.java`](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/LoginActivity.java) (Login and registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android app"]
  node_welcome["Welcome screen"]
  node_auth["Login and registration<br/>[LoginActivity.java]"]
  node_register["Account registration"]
  node_main["Main navigation<br/>[MainActivity.java]"]
  node_api["API client<br/>[ApiClient.java]"]
end

subgraph group_monitoring["Monitoring views"]
  node_dashboard["Dashboard"]
  node_alerts["Alert history"]
  node_events["Security events"]
  node_settings["Server settings"]
end

subgraph group_backend["Backend services"]
  node_backend["Application API<br/>[appv13.py]"]
  node_ai["AI summaries<br/>[ai.py]"]
  node_notif["Notification worker"]
end

subgraph group_domain["Monitoring data"]
  node_agents["Agent model and list<br/>[AgentAdapter.java]"]
  node_alertsdata["Alert model and list<br/>[AlertAdapter.java]"]
  node_serverdata["Server record<br/>[WazuhServer.java]"]
end

node_user(("Mobile user"))
node_wazuh{{"Wazuh services"}}
node_openai{{"OpenAI API"}}
node_firebase{{"Firebase messaging"}}

node_user -->|"opens"| node_welcome
node_welcome -->|"starts login"| node_auth
node_welcome -->|"starts registration"| node_register
node_auth -->|"authenticates"| node_api
node_auth -->|"opens on success"| node_main
node_register -->|"submits account"| node_api
node_main -->|"requires session"| node_auth
node_main -->|"loads view"| node_dashboard
node_main -->|"routes navigation"| node_alerts
node_main -->|"routes navigation"| node_events
node_main -->|"routes navigation"| node_settings
node_dashboard -->|"fetches dashboard data"| node_api
node_alerts -->|"fetches history"| node_api
node_events -->|"fetches events"| node_api
node_settings -->|"manages servers"| node_api
node_dashboard -->|"renders agents"| node_agents
node_alerts -->|"renders alerts"| node_alertsdata
node_events -->|"builds event records"| node_alertsdata
node_settings -->|"displays servers"| node_serverdata
node_api -->|"sends API requests"| node_backend
node_backend -.->|"queries monitoring data"| node_wazuh
node_backend -.->|"obtains summaries"| node_ai
node_ai -.->|"requests insights"| node_openai
node_backend -.->|"dispatches notifications"| node_notif
node_notif -.->|"delivers notifications"| node_firebase

click node_welcome "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/WelcomeActivity.java"
click node_auth "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/LoginActivity.java"
click node_register "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/RegisterActivity.java"
click node_main "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/MainActivity.java"
click node_api "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/ApiClient.java"
click node_dashboard "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/DashboardFragment.java"
click node_alerts "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/AlertsFragment.java"
click node_events "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/EventsFragment.java"
click node_settings "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/SettingsFragment.java"
click node_agents "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/AgentAdapter.java"
click node_alertsdata "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/AlertAdapter.java"
click node_serverdata "https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/WazuhServer.java"
click node_backend "https://github.com/miracleyosuak/android-project/blob/main/back-end/appv13.py"
click node_ai "https://github.com/miracleyosuak/android-project/blob/main/back-end/ai.py"
click node_notif "https://github.com/miracleyosuak/android-project/blob/main/back-end/notifworker_harusnyafinalv7.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_welcome,node_auth,node_register,node_main,node_api,node_user toneBlue
class node_dashboard,node_alerts,node_events,node_settings toneAmber
class node_backend,node_ai,node_notif,node_openai toneMint
class node_agents,node_alertsdata,node_serverdata toneRose
class node_wazuh,node_firebase toneIndigo
```

## Components

### Android app

- [Welcome screen](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/WelcomeActivity.java): `app/src/main/java/com/wazuh/mobile/WelcomeActivity.java`
- [Login and registration](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/LoginActivity.java): `app/src/main/java/com/wazuh/mobile/LoginActivity.java`
- [Account registration](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/RegisterActivity.java): `app/src/main/java/com/wazuh/mobile/RegisterActivity.java`
- [Main navigation](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/MainActivity.java): `app/src/main/java/com/wazuh/mobile/MainActivity.java`
- [API client](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/ApiClient.java): `app/src/main/java/com/wazuh/mobile/ApiClient.java`

### Monitoring views

- [Dashboard](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/DashboardFragment.java): `app/src/main/java/com/wazuh/mobile/DashboardFragment.java`
- [Alert history](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/AlertsFragment.java): `app/src/main/java/com/wazuh/mobile/AlertsFragment.java`
- [Security events](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/EventsFragment.java): `app/src/main/java/com/wazuh/mobile/EventsFragment.java`
- [Server settings](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/SettingsFragment.java): `app/src/main/java/com/wazuh/mobile/SettingsFragment.java`

### Backend services

- [Application API](https://github.com/miracleyosuak/android-project/blob/main/back-end/appv13.py): `back-end/appv13.py`
- [AI summaries](https://github.com/miracleyosuak/android-project/blob/main/back-end/ai.py): `back-end/ai.py`
- [Notification worker](https://github.com/miracleyosuak/android-project/blob/main/back-end/notifworker_harusnyafinalv7.py): `back-end/notifworker_harusnyafinalv7.py`

### Monitoring data

- [Agent model and list](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/AgentAdapter.java): `app/src/main/java/com/wazuh/mobile/AgentAdapter.java`
- [Alert model and list](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/AlertAdapter.java): `app/src/main/java/com/wazuh/mobile/AlertAdapter.java`
- [Server record](https://github.com/miracleyosuak/android-project/blob/main/app/src/main/java/com/wazuh/mobile/WazuhServer.java): `app/src/main/java/com/wazuh/mobile/WazuhServer.java`

### Other components

- **Mobile user**
- **Wazuh services**
- **OpenAI API**
- **Firebase messaging**

## Connections

- Mobile user → Welcome screen: opens (evidence: `app/src/main/java/com/wazuh/mobile/WelcomeActivity.java`)
- Welcome screen → Login and registration: starts login (evidence: `app/src/main/java/com/wazuh/mobile/WelcomeActivity.java`)
- Welcome screen → Account registration: starts registration (evidence: `app/src/main/java/com/wazuh/mobile/WelcomeActivity.java`)
- Login and registration → API client: authenticates (evidence: `app/src/main/java/com/wazuh/mobile/LoginActivity.java`)
- Login and registration → Main navigation: opens on success (evidence: `app/src/main/java/com/wazuh/mobile/LoginActivity.java`)
- Account registration → API client: submits account (evidence: `app/src/main/java/com/wazuh/mobile/RegisterActivity.java`)
- Main navigation → Login and registration: requires session (evidence: `app/src/main/java/com/wazuh/mobile/MainActivity.java`)
- Main navigation → Dashboard: loads view (evidence: `app/src/main/java/com/wazuh/mobile/MainActivity.java`)
- Main navigation → Alert history: routes navigation (evidence: `app/src/main/java/com/wazuh/mobile/MainActivity.java`)
- Main navigation → Security events: routes navigation (evidence: `app/src/main/java/com/wazuh/mobile/MainActivity.java`)
- Main navigation → Server settings: routes navigation (evidence: `app/src/main/java/com/wazuh/mobile/MainActivity.java`)
- Dashboard → API client: fetches dashboard data (evidence: `app/src/main/java/com/wazuh/mobile/DashboardFragment.java`)
- Alert history → API client: fetches history (evidence: `app/src/main/java/com/wazuh/mobile/AlertsFragment.java`)
- Security events → API client: fetches events (evidence: `app/src/main/java/com/wazuh/mobile/EventsFragment.java`)
- Server settings → API client: manages servers (evidence: `app/src/main/java/com/wazuh/mobile/SettingsFragment.java`)
- Dashboard → Agent model and list: renders agents (evidence: `app/src/main/java/com/wazuh/mobile/DashboardFragment.java`)
- Alert history → Alert model and list: renders alerts (evidence: `app/src/main/java/com/wazuh/mobile/AlertsFragment.java`)
- Security events → Alert model and list: builds event records (evidence: `app/src/main/java/com/wazuh/mobile/EventsFragment.java`)
- Server settings → Server record: displays servers (evidence: `app/src/main/java/com/wazuh/mobile/SettingsFragment.java`)
- API client → Application API: sends API requests (evidence: `app/src/main/java/com/wazuh/mobile/ApiClient.java`)
- Application API → Wazuh services: queries monitoring data
- Application API → AI summaries: obtains summaries
- AI summaries → OpenAI API: requests insights
- Application API → Notification worker: dispatches notifications
- Notification worker → Firebase messaging: delivers notifications
