Task Distributor: Fair Share

Google Play Download Link

Play Store Link

Quick Start

Prerequisites

-.NET SDK 10
-Docker Desktop (running)

To run the application locally, start the Aspire AppHost project with

dotnet run --project aspire/Fair-Share.AppHost

This will start up all dependecies: API, Function, Service Bus and local PostgreSQL DB, and open up the Aspire Dashboard

To deploy with Aspire, sign in with valid credentials to Azure and run

aspire deploy

Overview

A mobile application that automatically distributes tasks among team members in a fair and balanced way. It ensures equal workload distribution while also considering individual preferences when assigning tasks.

This repository contains the backend system, built as a distributed .NET solution using .NET Aspire.

Frontend repository: https://github.com/Fair-Share-Task-Distributor-App/Fair-Share-Frontend

Architecture

This project uses .NET Aspire to orchestrate multiple backend services.

The system is split into multiple services:

• API Service = Handles authentication, task and client management, and schedules to service bus
• Serverless Functions = Distribute tasks using weight balancing algorithmn at service bus trigger
• Service Bus = Enables asynchronous communication between services
• PostgreSQL server = Local database used to store data

Project Structure

src/
├── Api/              # ASP.NET MVC
├── Functions/        # Serverless Functions
aspire/
└── AppHost/          # .NET Aspire orchestration layer
└── ServiceDefault/   # Provides logging, telemetry