Skip to content
Alvar Mathias Løvvang Aasgaard edited this page Apr 23, 2026 · 9 revisions

Semester Project - IDATG1005 System Development

Team Members

  • Alvar Aasgaard
  • Erik Schieldrop
  • Jørgen Nilsen
  • Oliver Buøen

Project Description

This project focuses on developing an application for managing donations to charitable organizations.
The system will allow users to:

  • Register and log in
  • Donate money to charities
  • Search for desired charity
  • View donation history

Technologies

  • Java
  • API
  • Git
  • IntelliJ
  • MySQL

Project Structure

src
└── main
    └── java
        └── edu.ntnu.idatg1005.group13
            ├── base
            │   ├── AccountExistsException
            │   ├── DatabaseConnection
            │   ├── DatabaseException
            │   ├── DatabaseInitializer
            │   └── FailedLoginException
            │
            ├── database
            │   └── repositories
            │       ├── AccountRepository
            │       ├── CharityRepository
            │       ├── DonationHistoryRepository
            │       ├── DonationRepository
            │       └── UserRepository
            │
            ├── service
            │   ├── AccountService
            │   ├── CharityService
            │   ├── DonationHistoryService
            │   ├── DonationService
            │   └── UserService
            │
            ├── ui
            │   ├── actions
            │   │   ├── CharityAction
            │   │   ├── DonateAction
            │   │   ├── LoginAction
            │   │   ├── RegisterAction
            │   │   └── SearchAction
            │   │
            │   ├── controllers
            │   │   ├── AboutController
            │   │   ├── AccountController
            │   │   ├── CharityController
            │   │   ├── Controller
            │   │   ├── HomeController
            │   │   └── MainController
            │   │
            │   ├── model
            │   │   ├── AccountInstance
            │   │   ├── CharitiesSubject
            │   │   ├── Subject
            │   │   └── UserInstance
            │   │
            │   └── views
            │       ├── account.elements
            │       │   └── DonationHistoryElement
            │       ├── charity.elements
            │       │   └── DonationField
            │       ├── home.elements
            │       │   ├── CharitySmallView
            │       │   ├── LeftBarView
            │       │   └── MiddlePageView
            │       └── main.content
            │           ├── AboutView
            │           ├── AccountView
            │           ├── CharityView
            │           ├── HomeView
            │           ├── MainView
            │           ├── Observer
            │           └── TopBarView
            │
            ├── utility
            │   ├── FailedToGetRequestException
            │   ├── FetchApi
            │   ├── ParseCharityText
            │   ├── ParseHtml
            │   └── ParseJson
            │
            └── App

Git Workflow

Branches

  • main→ stable version
  • develop→ integration branch
  • feature/*→ new features

Workflow

  1. Create a branch from develop:
    git checkout develop
    git pull
    git checkout -b feature/feature-name
  2. Work and commit:
    git add .
    git commit -m "Describe your changes"
  3. Push:
    git push origin feature/feature-name
  4. Create a Merge Request to develop

Domain Overview

Main Entities

  • User
  • Donation
  • Charity
  • Payment

Relationships

  • A user can have multiple donations
  • A donation belongs to one charity
  • A payment is linked to a donation

Testing

  • Unit testing with JUnit
  • API testing with Postman
  • Manual UI testing

Timeline

Week Phase Description
2–3 Planning Requirements, design, domain model
4–6 Backend Development API, database, business logic
7–11 Frontend & Integration UI + connect frontend/backend
12-16 Testing Unit tests, integration testing
17 Finalization Bug fixing, polishing, delivery

Rules

  • Do not push directly to main
  • All changes must go through Merge Request
  • At least one review before merging
  • Write clear commit messages

Resources

  • Git repository
  • Figma wireframes
  • API documentation
Clone this wiki locally