ProMESA

ProMESA is a command-line application that processes a text file and creates a report in form of a PDF. The name ProMESA stands for: Productivity Measurement and Enhancement System Application.

Motivation

If you are a software developer and you ask yourself: Am I doing the right things; am I doing it right? Then ProMESA will give you another look at work item estimates, project schedules, number of bugs, test coverage and other to-do that fill out your working day.

Getting Started

1. Download the Excel timesheet template
2. Enter your tasks on the tab "Zeiterfassung". Add the task to one of the categories: constructive work, adaptive work, corrective work, testing, support or coaching. If a meeting took place, add the task to either team-internal meeting or external meeting (external: e.g. a meeting with a product manager or members or other teams)
3. Once you have collected data for a some weeks you can create your first report. For that, you copy-paste the cells from the “ProMES” tab in the Excel file into a text file and process it with the command-line tool “reportPDF.exe” or “reportConsole.exe”.

Features

• PDF report
• Graphical visualization between efficiency and effectiveness

Installation

1. Download the binaries
2. Open a Command Prompt and go to the installation directory
3. Type: >reportPDF.exe -file Example-2019_41-44.txt -name Test -team ATeam -year 2019 -tp 2019 41 2019 44
4. Open the created file report.pdf to check if the installation was successful

Usage

reportPDF.exe -file Example-2019_41-44.txt -name Test -team ATeam -year 2019 -tp 2019 41 2019 44

• -file: The input
• -name: The employees name that is shown on the report's front page
• -team: Not used
• -year: The year the report was created; shown on the front page
• -tp: time period, begin year/week to end year/week. more than one time periods are possible

Source Code

ProMESA is written in Haskell and built with nmake/Makefile.

Installing the Development Environment

1. Download and install the HaskellPlatform-7.10.3 (https://www.haskell.org/platform/prior.html)
2. Download and install the package datetime and HPDF (https://hackage.haskell.org/)
3. Download nmake; I use the Developer Command Prompt for VS 2017

Building reportPDF.exe

1. Download the latest source code
2. Open Developer Command Prompt for VS 2017 go to the source code directory
3. >nmake reportPDF

Tests

Unit tests and system tests are in the source folder and can be executed using nmake/Makefile:

• Unit tests: >nmake ut

• System tests >nmake st

Documentation

The productivity measurement and enhancement system is documented in a PDF.

The documentation of the source code is available as zip file or can be generated from the source code using nmake/Makefile:

>nmake doc

License

This source code is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Project History

I started the project on sourceforge in 2004 using CVS. The first release in 2010 was without binaries. In the meanwhile, git is used and a first release with binaries is available.

Change History

1.1.0

• First version with binaries

1.0.0

• Initial Version