https://github.com/fheinke/chronolog
ChronoLog is a simple and efficient worktime tracking application designed to help individuals and teams monitor their productivity and manage their time effectively.
https://github.com/fheinke/chronolog
overtime-tracking projecttime projecttrack tracking worktime
Last synced: 2 months ago
JSON representation
ChronoLog is a simple and efficient worktime tracking application designed to help individuals and teams monitor their productivity and manage their time effectively.
- Host: GitHub
- URL: https://github.com/fheinke/chronolog
- Owner: fheinke
- License: mit
- Created: 2025-11-14T10:14:11.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-03-27T21:26:40.000Z (3 months ago)
- Last Synced: 2026-04-03T02:45:29.628Z (3 months ago)
- Topics: overtime-tracking, projecttime, projecttrack, tracking, worktime
- Language: C#
- Homepage:
- Size: 2.95 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# ChronoLog - Worktime Tracking Application
[](https://github.com/fheinke/ChronoLog/pkgs/container/chronolog)
[](LICENSE.txt)
ChronoLog is a modern, efficient worktime tracking application built with **ASP.NET Core** and **Blazor Server**. Designed for individuals and teams, ChronoLog helps you monitor productivity, manage time effectively, and streamline reporting processes. Track your work hours, manage projects, and copy the worktime data directly to enterprise systems like SAP to book your times.
## ✨ Features
- **⏱️ Time Tracking**: Log work hours
- **📊 Project Management**: Organize work by projects with detailed time allocation
- **📈 Reporting & Analytics**: Generate comprehensive reports with copy-to-clipboard functionality for SAP integration
- **🎯 Personal Dashboard**: View overtime balance, vacation days, and time statistics at a glance
- **🔒 Enterprise Authentication**: Secure login via Microsoft Entra ID (Azure AD)
- **👥 User Management**: Admin interface for managing permissions of employees
- **🏢 Multi-Province Support**: Configure workday types and holidays per region
- **🐳 Dockerized Deployment**: Simple deployment using Docker and Docker Compose
- **🌐 RESTful API**: Full API support for external integrations
- **📱 Responsive Design**: Modern UI that works seamlessly on desktops
## 🏗️ Technology Stack
- **Backend**: ASP.NET Core 10 (.NET 10)
- **Frontend**: Blazor Server with Radzen UI Components
- **Database**: MySQL 8 with Entity Framework Core
- **Authentication**: Microsoft Entra ID (Azure AD) with OpenID Connect
- **API Documentation**: Swagger/OpenAPI
- **Containerization**: Docker & Docker Compose
## 🚀 Quick Start
### Prerequisites
- Docker and Docker Compose installed on your machine
- An Azure account with permissions to create App Registrations
- (Optional) A reverse proxy like nginx for production deployment
### Installation
For detailed installation instructions, please see the [Getting Started Guide](docs/getting-started.md).
**Quick installation steps:**
1. Clone the repository
2. Configure Azure AD App Registration (see [Getting Started Guide](docs/getting-started.md))
3. Copy `.env.example` to `.env` and configure your environment variables
4. Run `docker compose up -d`
5. Access the application at `http://localhost:8080`
6. Set the first admin user after initial login
For detailed configuration options, see [Configuration Guide](docs/configuration.md).
## 📚 Documentation
- **[Getting Started Guide](docs/getting-started.md)** - Step-by-step installation and setup
- **[Configuration Guide](docs/configuration.md)** - Detailed configuration options and best practices
- **[API Reference](docs/api-reference.md)** - Complete API documentation for integrations
## 🔧 Configuration Overview
ChronoLog uses environment variables for configuration. Key settings include:
```bash
# Azure AD Authentication
AZURE_AD_DOMAIN=yourdomain.onmicrosoft.com
AZURE_AD_TENANT_ID=your-tenant-id
AZURE_AD_CLIENT_ID=your-client-id
AZURE_AD_CLIENT_SECRET=your-client-secret
# Database Configuration
MYSQL_HOST=chronoLogDatabase
MYSQL_USER=chronolog
MYSQL_PASSWORD=your-secure-password
MYSQL_DATABASE=ChronoLog
# Reverse Proxy (for production)
REVERSE_PROXY_ENABLED=true
REVERSE_PROXY_BASE_URL=https://chronolog.yourdomain.com
REVERSE_PROXY_KNOWN_PROXIES="172.16.0.0/12"
```
See the [Configuration Guide](docs/configuration.md) for all available options.
## 🔐 Security
- All API endpoints require authentication
- Role-based authorization for admin and project management features
- Secure cookie handling with SameSite and HttpOnly flags
- HTTPS enforcement in production environments
- Database migrations run automatically on startup
- Health checks for service monitoring
## 📄 License
This project is licensed under the terms specified in [LICENSE.txt](LICENSE.txt).
Feel free to use, modify, and distribute it as per the license terms.