Help Me Help (HmH)

A Java desktop application for discovering charitable organizations and recording donations.

GROUP 24 - IDATT1005 - Systemutvikling (BIDATA) - NTNU Trondheim, Spring 2026 Inspera pin: 0024

About

Help Me Help lets users browse verified charitable organizations fetched from Innsamlingskontrollen, search and filter by cause area, and register donations. The application stores user profiles and donation history in a local SQLite database.

This project was developed for the course IDATT1005 — Systemutvikling (BIDATA) at NTNU Trondheim, Spring 2026.

Features

Browse organizations from Innsamlingskontrollen API
Filter by cause area (Humanitarian, Health, Children, Environment, Education, Other)
Search organizations by name
Register donations to organizations
View personal profile with donation history
Local SQLite persistence
Favorite organizations
Dashboard with donation metrics

Requirements

Java 21
Maven

Installation

git clone https://git.ntnu.no/<repository>/idatt1005_2026_24.git
cd idatt1005_2026_24

Running the Application

mvn javafx:run

On first startup, the database is created automatically in the data/ folder.

Running Tests

mvn test

Project Structure

src/
├── main/
│   ├── java/edu/ntnu/idi/idatt1005/hmh/
│   │   ├── Main.java              # Application entry point
│   │   ├── model/               # Domain models: User, Organization, Donation
│   │   ├── registers/           # Business logic: OrganizationRegister, DonationRegister
│   │   ├── util/                # Database and hashing utilities
│   │   └── ui/                  # JavaFX views and controllers
│   └── resources/               # Stylesheets and resources
└── test/                        # JUnit 5 tests

Architecture

The application follows a layered MVC architecture:

Views (JavaFX FXML) → Controllers → Registers → SQLite

ui/ — JavaFX views and controllers handle user interaction
registers/ — contain business logic for organizations and donations
util/ — database access (UserDatabase, DonationDatabase) and password hashing
model/ — plain data objects

Dependencies

Managed via pom.xml:

Dependency	Version
JavaFX	21.0.2
SQLite JDBC	3.46.1.3
Jsoup	1.18.1
Jackson	2.17.2
JUnit 5	5.10.2

Team

Developed by students in the Bachelor's programme in Data Engineering at NTNU Trondheim:

Brage Sebastian Sandli-Løvgren
Sigurd Evensen
Joachim Valdersnes Nilsen

Wiki

For detailed documentation, design decisions, and development process, see the project wiki: HelpMeHelp Wiki

Status

Completed and delivered — NTNU IDATT1005, Spring 2026

License

Gruppe-24-IDATT1005/idatt1005_2026_24

About

Topics

Resources

License

Stars

Watchers

Forks

Releases 7

Contributors 3

Languages