Taskman Dashboard

A Python-based project management dashboard that integrates with Redmine/Taskman API to track project hours and visualize work progress. Built with Streamlit for an interactive web interface.

Features

• Real-time Project Monitoring: Sync data directly from Taskman API
• Executive Dashboard: Key metrics including total issues, hours logged, progress, and overdue alerts
• Parent Task Summary: Comprehensive view of parent tasks with estimated, completed, and remaining hours
• Time Series Analysis: Track hours spent vs estimated over time
• Progress Visualization: Burndown charts, velocity tracking, and progress indicators
• Timeline Management: Gantt charts and due date analysis
• Issue Prioritization: Filter and sort issues by status, budget, and deadlines
• Change Detection: Compare work items between different dates

Prerequisitesßs

• Python 3.7 or higher
• Taskman/Redmine API access with valid API key
• Internet connection for initial data sync

Installation

1. Clone or download this repository

git clone https://github.com/eea/taskmanDashboard
cd Taskman

2. Create a virtual environment

Mac/Linux:

python3 -m venv venv
source ./venv/bin/activate

Windows:

python -m venv venv
venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

Configuration

1. Create API Key file

Create a .env file at the root of the project folder:

TASKMAN_API_KEY=your_api_key_here

Replace your_api_key_here with your actual Taskman API key (e.g., 3c4ff7b5b3defd48a39860b3...)

2. Configure Projects to Monitor

Edit ExtractTaskmanProject.py and update the project IDs:

PROJECT_IDS = [176, 45, 6]  # Replace with your project IDs

You can find project IDs by running:

python ListTaskmanProject.py

3. Initial Data Sync

Before running the dashboard for the first time, sync your data:

python ExtractTaskmanProject.py

This will create the taskman_hours.db SQLite database with your project data.

Usage

Running the Dashboard

Mac/Linux:

source ./venv/bin/activate
streamlit run Dashboard.py

Windows:

venv\Scripts\activate
streamlit run Dashboard.py

The dashboard will open automatically in your default web browser at http://localhost:8501

Syncing Data

You can sync data in two ways:

1. From the Dashboard: Click the "🔄 Sync Taskman Data" button in the web interface
2. From Command Line: Run python ExtractTaskmanProject.py

Debugging

VS Code:

1. Activate the virtual environment: source ./venv/bin/activate
2. Open Dashboard.py in VS Code
3. Press F5 to start debugging