TaskRacer

TaskRacer is an ASP.NET Core MVC web application designed to help teams and individuals manage their projects, track progress stages, and organize tasks efficiently. The project leverages Google Cloud Firestore as its real-time database backend.

Features

• User Authentication: Simple Sign Up and Sign In system storing user credentials in Firestore.
• Projects Management: Create, update, and delete projects. Add collaborators to your projects.
• Progress Tracking: Organize work into various progress stages (e.g., To Do, In Progress, Done) within each project.
• Task Management: Create detailed tasks with descriptions, order numbers, and "rewards". Tasks can be managed within specific progress stages.
• Real-Time Data: Uses Google Cloud Firestore to manage and retrieve data persistently.

Technology Stack

• Backend: C# with ASP.NET Core 6.0 MVC
• Database: Google Cloud Firestore (via Google.Cloud.Firestore SDK)
• Frontend: Razor Views (.cshtml), HTML/CSS, jQuery Unobtrusive Ajax
• Environment: Visual Studio / .NET CLI

Project Structure

• Controllers/: Contains the application's routing and logic (e.g., NewController handles most of the CRUD operations for Projects, Progress, and Tasks).
• Models/: Contains the data structures mapping to Firestore documents (User, Project, Progress, Tsk).
• Views/: Contains the Razor views for rendering the UI interfaces (Authentication, Dashboard, Project details).
• wwwroot/: Contains static assets like custom fonts (e.g., Lalezar), CSS, and client-side scripts.

Getting Started

Prerequisites

• .NET 6.0 SDK or later.
• A Google Cloud Platform (GCP) account with Firestore enabled.
• A Firestore Service Account JSON Key for authentication.

Installation & Setup

1. Clone the repository (if you haven't already):

   git clone <repository-url>
   cd TaskRacer/TaskRacer

2. Configure Firestore Credentials: To allow the application to connect to your Firestore database, set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of your Service Account JSON key.

   • Windows (Command Prompt):

     set GOOGLE_APPLICATION_CREDENTIALS="C:\path\to\your\service-account-file.json"

   • Windows (PowerShell):

     $env:GOOGLE_APPLICATION_CREDENTIALS="C:\path\to\your\service-account-file.json"

3. Restore Dependencies: Restore the necessary NuGet packages by running:

   dotnet restore

4. Run the Application: Finally, launch the application:

   dotnet run

   The application will start, usually on https://localhost:5001 or http://localhost:5000. Open your browser and navigate to the indicated URL.