TrackFlow

TrackFlow - A Secure Issue Tracking Application

TrackFlow is a full-stack, collaborative issue and project management platform. It features a secure RESTful API built with Spring Boot and a dynamic, responsive frontend built with React. Security is handled by Spring Security and JWT, providing role-based access for users.

Features

• Project & Issue Management: Create projects, assign issues, and track progress.
• Role-Based Access Control: Differentiated permissions for ADMIN and USER roles.
• JWT Authentication: Secure, token-based authentication for all API endpoints.
• Collaborative Comments: Users can communicate within issue threads.
• Containerized Backend: The database is managed with Docker for easy setup.
• Responsive UI: Modern user interface built with React and Material-UI.

Tech Stack

• Backend: Java, Spring Boot, Spring Security, JWT, PostgreSQL
• Frontend: React, Material-UI
• Tools: Docker, Maven, Git

How to Run

The application is split into a backend (Spring Boot) and a frontend (React).

1. Run the Backend

The backend database is containerized for simplicity.

1. Navigate to the backend directory and start the database:

   # From the project's root directory
   cd backend
   docker-compose up

2. Run the Spring Boot application: Open the project in your favorite IDE (like IntelliJ IDEA) and run the main application class. The backend API will be available at http://localhost:8080

2. Run the Frontend

1. Navigate to the frontend directory:

   # From the project's root directory
   cd frontend

2. Install dependencies and start the development server:

   npm install
   npm run dev

The React application will now be running and accessible at http://localhost:5173