# Project Time Tracker

## Content:

1. Introduction
2. Requirements
3. Getting started
4. Contact

======================================

### 1. Introduction

The "Project Time Tracker" application is a tool for recording and evaluating time spent on various projects. The functionality includes:

- Creation of projects, subprojects, categories and statuses
- Time recording with assignment to projects
- Evaluation of the recorded times depending on the selected period, category and status

======================================

### 2. Requirements

For the execution of the program a Java Runtime Environment (JRE) is necessary. A current version can be downloaded at LINK. The program uses a SQL database "PTT_database.db" created with "SQLite", which must be located in the same directory as the executable JAR file.

======================================

### 3. Getting started

The program includes 3 windows, which are briefly explained below.

Window | What? | How?
--- | --- | ---
"Project Time Tracker" (home window) | Recording as well as modification/deletion of time efforts. | Select date (standard = today). Press Start to write current time into Start-Field. Press Stop to write current time into Stop-Field. Enter additional information (project + status are mandatory!). Press „save“ to record in database. Click entry in the bottom to edit/delete (note: Status only can changed at „Time overview“!).
"Projects/Categories/Status" (Button „Projects“ in home window) | Manage projects and their subprojects, categories and statuses. | Enter new Order No. + Description for new project or click existing project to modify/delete. To manage suborders, first click on corresponding order. To manage Categories/Status, click on the corresponding tab above.
"Time Overview" (Button „Overview“ in home window) | Evaluation of recorded times. | Select Start + END Date and, if necessary, category and status. Click „Search“ to display a summary of all efforts within the selected time (grouped by order and suborder). Status of efforts can be changed by selecting another entry in the corresponding cell. Click on a specific line to display all individual efforts in the lower area.

Further hints:

- Pause field (window "Project Time Tracker"): In the Pause field, minutes can be entered which are to be subtracted from the recorded time (end time minus start time). The pause time is calculated automatically when the "Start" button is pressed again after confirming the "STOP/Pause" button. The time difference between stop and start is then entered in Pause (+ any previously recorded pause times).

- Option „visible?“ (window: "Projects/Categories/Status"): In order to keep the selection lists of orders/suborders clear, entries that are no longer required can be hidden. This is done via the checkbox "visible?". If the checkbox is removed, the corresponding order/suborder is no longer displayed in the selection lists (but still in the "Time Overview" window). If the entry is to be displayed again later, the hidden entries can be selected by removing the checkmark from "Show only visible" and accordingly the option "visible" can be checked again.

======================================

### 4. Contact

Please send questions or feedback to info@CodeCompounder.de