Skip to content

netresearch/timetracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Netresearch TimeTracker

PHP Version Symfony License CI Status codecov Code Quality Latest Release OpenSSF Scorecard OpenSSF Best Practices SLSA 3

Professional time tracking solution for teams and enterprises with advanced LDAP integration, Jira synchronization, and comprehensive reporting.


Features

  • Time Entry Management - Quick time entry with smart autocompletion and real-time validation
  • Bulk Operations - Efficient handling of vacation, sick leave, and recurring tasks
  • XLSX Export - Export reports for controlling and compliance
  • LDAP/Active Directory - Seamless authentication with automatic user provisioning
  • Jira Synchronization - Bidirectional worklog sync with OAuth 2.0 support
  • Role-based Access Control - Developer, Controller, and Project Leader roles
  • Multi-tenant Architecture - Support for multiple customers and projects

Quick Start

Using Docker (Recommended)

git clone https://github.com/netresearch/timetracker.git
cd timetracker

make up
make install
make db-migrate

# Access the application
open http://localhost:8765

Manual Installation

# Prerequisites: PHP 8.4+, MySQL/MariaDB, Composer, Node.js 18+
composer install
npm install && npm run build

cp .env.example .env.local
# Edit .env.local with your database and LDAP settings

php bin/console doctrine:database:create
php bin/console doctrine:migrations:migrate

symfony server:start

Requirements

  • PHP: 8.4 with extensions: ldap, pdo_mysql, intl, mbstring
  • Database: MySQL 8.0+ or MariaDB 10.5+
  • Node.js: 18+ (for asset compilation)

Technology Stack

  • Backend: PHP 8.4, Symfony 7.3, Doctrine ORM 3
  • Frontend: Stimulus, SCSS, Webpack Encore
  • Testing: PHPUnit 12, PHPStan Level 10, PHP-CS-Fixer, Rector
  • Infrastructure: Docker, GitHub Actions CI/CD

See docs/techstack.md for details.


Documentation

Guide Description
Development Local setup and development workflow
Configuration Environment variables and settings
API Reference REST API endpoints and examples
Testing Testing strategy and commands
Security Security implementation details
Deployment Production deployment guide
Troubleshooting Common issues and solutions

Development

# Run tests
make test

# Run tests in parallel
make test-parallel

# Static analysis & code style
make check-all

# Fix code style
make fix-all

Code Quality Standards

  • PSR-12 code style (PHP-CS-Fixer)
  • PHPStan Level 10 static analysis
  • PHPUnit tests
  • Conventional Commits

See CONTRIBUTING.md for contribution guidelines.


License

This project is licensed under the AGPL-3.0 License - see LICENSE for details.

For commercial licensing, contact [email protected].


Support


Built by Netresearch

About

Simple time tracking front end with optional Jira synchronization, AD/LDAP integration and XLSX export.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors 10