# eternals2346/26su_se20b02_g4_iot102_finalreport architecture

> Architecture diagram of the GitHub repository eternals2346/26su_se20b02_g4_iot102_finalreport, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eternals2346/26su_se20b02_g4_iot102_finalreport
- Repository: https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport

## Overview

SafeStep AI is presented as an elderly fall-detection platform. Its sampled Java web application supports staff sign-in, a dashboard for devices, incidents and alarm status, incident handling, and administrative device and AI-threshold configuration; data access uses Firebase with an in-memory fallback. The tree also contains a substantial Python program, but its behavior and its connection to the web app are not established by the available excerpts, so it is shown separately. Several controller-to-DAO links are supported by the source index; unsampled subsystems are not wired speculatively.

Main entry points: [`SourceCode/src/main/java/com/mycompany/dao/AppDAO.java`](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/dao/AppDAO.java) (Application data access), [`SourceCode/src/main/java/com/mycompany/controller/AuthenticationFilter.java`](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/AuthenticationFilter.java) (Access filter), [`SourceCode/src/main/java/com/mycompany/controller/DashboardServlet.java`](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/DashboardServlet.java) (Dashboard handler), [`SourceCode/src/main/java/com/mycompany/controller/DeviceServlet.java`](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/DeviceServlet.java) (Device management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_auth["Sign-in and access<br/>[LoginServlet.java]"]
  node_auth_filter["Access filter"]
  node_dashboard["Dashboard handler"]
  node_dashboard_view["Dashboard view<br/>[dashboard.jsp]"]
end

subgraph group_ops["Operations"]
  node_device_handler["Device management<br/>[DeviceServlet.java]"]
  node_device_view["Device management view"]
  node_incident_handler["Incident handling"]
  node_threshold_handler["AI threshold settings"]
  node_app_listener["Startup seeding<br/>[AppListener.java]"]
end

subgraph group_data["Data access"]
  node_app_dao["Application data access<br/>[AppDAO.java]"]
  node_firebase_dao["Firebase REST client<br/>[FirebaseDAO.java]"]
end

subgraph group_domain["Domain models"]
  node_user_model["User model<br/>[User.java]"]
  node_device_model["Device model<br/>[Device.java]"]
  node_incident_model["Incident model<br/>[Incident.java]"]
  node_threshold_model["Threshold model<br/>[Threshold.java]"]
end

subgraph group_detection["Fall detection"]
  node_python_detection["Detection program<br/>[safestep.py]"]
end

node_staff(("Care staff"))
node_firebase[("Firebase Realtime Database")]

node_staff -->|"signs in"| node_auth
node_auth_filter -->|"filters access"| node_dashboard
node_auth_filter -->|"filters access"| node_device_handler
node_auth_filter -->|"filters access"| node_incident_handler
node_auth_filter -->|"filters access"| node_threshold_handler
node_dashboard -->|"loads dashboard data"| node_app_dao
node_dashboard -->|"forwards to"| node_dashboard_view
node_device_handler -->|"manages devices"| node_app_dao
node_device_handler -->|"forwards to"| node_device_view
node_incident_handler -->|"updates incidents"| node_app_dao
node_threshold_handler -->|"reads and saves"| node_app_dao
node_threshold_handler -->|"forwards to"| node_dashboard
node_app_listener -->|"seeds defaults"| node_app_dao
node_app_dao -->|"requests data"| node_firebase_dao
node_firebase_dao -->|"sends REST requests"| node_firebase
node_app_dao -->|"reads and writes"| node_user_model
node_app_dao -->|"reads and writes"| node_device_model
node_app_dao -->|"reads and writes"| node_incident_model
node_app_dao -->|"reads and writes"| node_threshold_model

click node_auth "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/LoginServlet.java"
click node_auth_filter "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/AuthenticationFilter.java"
click node_dashboard "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/DashboardServlet.java"
click node_dashboard_view "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/webapp/dashboard.jsp"
click node_device_handler "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/DeviceServlet.java"
click node_device_view "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/webapp/devicemanagement.jsp"
click node_incident_handler "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/IncidentServlet.java"
click node_threshold_handler "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/ThresholdServlet.java"
click node_app_listener "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/listener/AppListener.java"
click node_app_dao "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/dao/AppDAO.java"
click node_firebase_dao "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/dao/FirebaseDAO.java"
click node_user_model "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/entity/User.java"
click node_device_model "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/entity/Device.java"
click node_incident_model "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/entity/Incident.java"
click node_threshold_model "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/entity/Threshold.java"
click node_python_detection "https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/safestep.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_auth,node_auth_filter,node_dashboard,node_dashboard_view toneBlue
class node_device_handler,node_device_view,node_incident_handler,node_threshold_handler,node_app_listener,node_firebase toneAmber
class node_app_dao,node_firebase_dao toneMint
class node_user_model,node_device_model,node_incident_model,node_threshold_model toneRose
class node_python_detection,node_staff toneIndigo
```

## Components

### Web application

- [Sign-in and access](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/LoginServlet.java): `SourceCode/src/main/java/com/mycompany/controller/LoginServlet.java`
- [Access filter](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/AuthenticationFilter.java): `SourceCode/src/main/java/com/mycompany/controller/AuthenticationFilter.java`
- [Dashboard handler](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/DashboardServlet.java): `SourceCode/src/main/java/com/mycompany/controller/DashboardServlet.java`
- [Dashboard view](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/webapp/dashboard.jsp): `SourceCode/src/main/webapp/dashboard.jsp`

### Operations

- [Device management](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/DeviceServlet.java): `SourceCode/src/main/java/com/mycompany/controller/DeviceServlet.java`
- [Device management view](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/webapp/devicemanagement.jsp): `SourceCode/src/main/webapp/devicemanagement.jsp`
- [Incident handling](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/IncidentServlet.java): `SourceCode/src/main/java/com/mycompany/controller/IncidentServlet.java`
- [AI threshold settings](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/controller/ThresholdServlet.java): `SourceCode/src/main/java/com/mycompany/controller/ThresholdServlet.java`
- [Startup seeding](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/listener/AppListener.java): `SourceCode/src/main/java/com/mycompany/listener/AppListener.java`

### Data access

- [Application data access](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/dao/AppDAO.java): `SourceCode/src/main/java/com/mycompany/dao/AppDAO.java`
- [Firebase REST client](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/dao/FirebaseDAO.java): `SourceCode/src/main/java/com/mycompany/dao/FirebaseDAO.java`

### Domain models

- [User model](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/entity/User.java): `SourceCode/src/main/java/com/mycompany/entity/User.java`
- [Device model](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/entity/Device.java): `SourceCode/src/main/java/com/mycompany/entity/Device.java`
- [Incident model](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/entity/Incident.java): `SourceCode/src/main/java/com/mycompany/entity/Incident.java`
- [Threshold model](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/src/main/java/com/mycompany/entity/Threshold.java): `SourceCode/src/main/java/com/mycompany/entity/Threshold.java`

### Fall detection

- [Detection program](https://github.com/eternals2346/26su_se20b02_g4_iot102_finalreport/blob/main/SourceCode/safestep.py): `SourceCode/safestep.py`

### Other components

- **Care staff**
- **Firebase Realtime Database**

## Connections

- Care staff → Sign-in and access: signs in (evidence: `SourceCode/src/main/java/com/mycompany/controller/LoginServlet.java`)
- Access filter → Dashboard handler: filters access (evidence: `SourceCode/src/main/java/com/mycompany/controller/AuthenticationFilter.java`)
- Access filter → Device management: filters access (evidence: `SourceCode/src/main/java/com/mycompany/controller/AuthenticationFilter.java`)
- Access filter → Incident handling: filters access (evidence: `SourceCode/src/main/java/com/mycompany/controller/AuthenticationFilter.java`)
- Access filter → AI threshold settings: filters access (evidence: `SourceCode/src/main/java/com/mycompany/controller/AuthenticationFilter.java`)
- Dashboard handler → Application data access: loads dashboard data (evidence: `SourceCode/src/main/java/com/mycompany/controller/DashboardServlet.java`)
- Dashboard handler → Dashboard view: forwards to (evidence: `SourceCode/src/main/java/com/mycompany/controller/DashboardServlet.java`)
- Device management → Application data access: manages devices (evidence: `SourceCode/src/main/java/com/mycompany/controller/DeviceServlet.java`)
- Device management → Device management view: forwards to (evidence: `SourceCode/src/main/java/com/mycompany/controller/DeviceServlet.java`)
- Incident handling → Application data access: updates incidents (evidence: `SourceCode/src/main/java/com/mycompany/controller/IncidentServlet.java`)
- AI threshold settings → Application data access: reads and saves (evidence: `SourceCode/src/main/java/com/mycompany/controller/ThresholdServlet.java`)
- AI threshold settings → Dashboard handler: forwards to (evidence: `SourceCode/src/main/java/com/mycompany/controller/ThresholdServlet.java`)
- Startup seeding → Application data access: seeds defaults (evidence: `SourceCode/src/main/java/com/mycompany/listener/AppListener.java`)
- Application data access → Firebase REST client: requests data (evidence: `SourceCode/src/main/java/com/mycompany/dao/AppDAO.java`)
- Firebase REST client → Firebase Realtime Database: sends REST requests (evidence: `SourceCode/src/main/java/com/mycompany/dao/FirebaseDAO.java`)
- Application data access → User model: reads and writes (evidence: `SourceCode/src/main/java/com/mycompany/dao/AppDAO.java`)
- Application data access → Device model: reads and writes (evidence: `SourceCode/src/main/java/com/mycompany/dao/AppDAO.java`)
- Application data access → Incident model: reads and writes (evidence: `SourceCode/src/main/java/com/mycompany/dao/AppDAO.java`)
- Application data access → Threshold model: reads and writes (evidence: `SourceCode/src/main/java/com/mycompany/dao/AppDAO.java`)
