+ {{ message }}
+
+
+ {% endfor %}
+ {% endif %}
+ {% endwith %}
+
+
+ {% block content %}{% endblock %}
+
+
+{% endblock %}
+
+
diff --git a/app/templates/auth/login.html b/app/templates/auth/login.html
new file mode 100644
index 0000000..4f439a8
--- /dev/null
+++ b/app/templates/auth/login.html
@@ -0,0 +1,90 @@
+{% extends "base.html" %}
+
+{% block title %}Login - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+ Edit Profile
+
+
+
+
+
+
+{% endblock %}
+
+{% block extra_js %}
+
+{% endblock %}
diff --git a/app/templates/auth/profile.html b/app/templates/auth/profile.html
new file mode 100644
index 0000000..6cd1508
--- /dev/null
+++ b/app/templates/auth/profile.html
@@ -0,0 +1,46 @@
+{% extends "base.html" %}
+
+{% block title %}Profile - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+ +
+
+  }})
+
+
+
+ Welcome to TimeTracker
+Powered by DryTrix
++ Enter your username to start tracking time +
+ + + ++ +
+
+ Internal Tool: This is a private time tracking application for internal use only.
+
+
+ {% if settings and settings.allow_self_register %}
+ + + New users will be created automatically +
+ {% endif %} +
+
+{% endblock %}
+
+
diff --git a/app/templates/base.html b/app/templates/base.html
new file mode 100644
index 0000000..0e768f3
--- /dev/null
+++ b/app/templates/base.html
@@ -0,0 +1,821 @@
+
+
+
+
+
+
+
+
+
+
+ Your Profile
+
+ Edit Profile
+
+
+
+
+
+
+ Username
+ {{ current_user.username }}
+
+
+ Role
+
+
+ {{ current_user.role|capitalize }}
+
+
+
+
+ Member since
+ {{ current_user.created_at.strftime('%Y-%m-%d %H:%M') if current_user.created_at else '—' }}
+
+
+ Last login
+ {{ current_user.last_login.strftime('%Y-%m-%d %H:%M') if current_user.last_login else '—' }}
+
+
+ Total hours
+ {{ current_user.total_hours }}
+
+
+{% endblock %}
diff --git a/app/templates/errors/403.html b/app/templates/errors/403.html
new file mode 100644
index 0000000..e9f748d
--- /dev/null
+++ b/app/templates/errors/403.html
@@ -0,0 +1,38 @@
+{% extends "base.html" %}
+
+{% block title %}403 Forbidden - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+ + 400 Bad Request +
+
+
+ Invalid Request
++ The request you made is invalid or contains errors. This could be due to: +
+-
+
- Missing or invalid form data +
- Malformed request parameters +
+
+ Go to Dashboard
+
+
+
+
+
+{% endblock %}
diff --git a/app/templates/errors/404.html b/app/templates/errors/404.html
new file mode 100644
index 0000000..8e9c7f0
--- /dev/null
+++ b/app/templates/errors/404.html
@@ -0,0 +1,28 @@
+{% extends "base.html" %}
+
+{% block title %}Page Not Found - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+ + 403 Forbidden +
+
+
+ Access Denied
++ You don't have permission to access this resource. This could be due to: +
+-
+
- Insufficient privileges +
- Not logged in +
- Resource access restrictions +
+
+ Go to Dashboard
+
+
+ Login
+
+
+
+
+{% endblock %}
diff --git a/app/templates/errors/500.html b/app/templates/errors/500.html
new file mode 100644
index 0000000..82b6b34
--- /dev/null
+++ b/app/templates/errors/500.html
@@ -0,0 +1,28 @@
+{% extends "base.html" %}
+
+{% block title %}Server Error - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+ 404
+Page Not Found
++ The page you're looking for doesn't exist or has been moved. +
+ +
+
+{% endblock %}
diff --git a/app/templates/errors/generic.html b/app/templates/errors/generic.html
new file mode 100644
index 0000000..b1dba9d
--- /dev/null
+++ b/app/templates/errors/generic.html
@@ -0,0 +1,37 @@
+{% extends "base.html" %}
+
+{% block title %}{{ error.code }} {{ error.name }} - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+ 500
+Server Error
++ Something went wrong on our end. Please try again later. +
+ +
+
+{% endblock %}
diff --git a/app/templates/main/dashboard.html b/app/templates/main/dashboard.html
new file mode 100644
index 0000000..0f8f85a
--- /dev/null
+++ b/app/templates/main/dashboard.html
@@ -0,0 +1,479 @@
+{% extends "base.html" %}
+
+{% block title %}Dashboard - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+
+
+
+ + {{ error.code }} {{ error.name }} +
+
+
+ {{ error.name }}
++ {% if error.description %} + {{ error.description }} + {% else %} + An error occurred while processing your request. + {% endif %} +
+
+
+ Go to Dashboard
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Welcome back, {{ current_user.username }}!
+Track your productivity and manage your time effectively with DryTrix TimeTracker
+
+
+
+
+
+
+ {{ today_hours|round(1) }}
+ Hours Today
+
+
+
+
+
+
+
+
+
+
+ + Timer Status +
+
+
+
+
+
+ {% if active_timer %}
+
+
+
+ {% else %}
+
+
+
+
+
+
+
+ Timer Running
++ {{ active_timer.project.name }} +
+
+ {{ active_timer.duration_formatted }}
+
+
+ Started at {{ active_timer.start_utc.strftime('%H:%M') }}
+
+
+
+ {% endif %}
+
+
+
+
+
+
+
+ No Active Timer
+Ready to start tracking your time?
+
+ Idle
+
+
+ {% if active_timer %}
+
+ {% else %}
+
+ {% endif %}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {{ "%.1f"|format(today_hours) }}
+Hours Today
+ + {% if today_hours > 0 %}Active day{% else %}No activity yet{% endif %} + +
+
+
+
+
+
+
+
+
+ {{ "%.1f"|format(week_hours) }}
+Hours This Week
+ + {% if week_hours > 0 %}Good progress{% else %}Start tracking{% endif %} + +
+
+
+
+
+
+
+
+
+ {{ "%.1f"|format(month_hours) }}
+Hours This Month
+ + {% if month_hours > 0 %}Consistent work{% else %}New month{% endif %} + +
+
+
+
+
+
+
+
+
+
+
+ + Quick Actions +
+
+
+
+
+
+
+
+
+
+
+ + Recent Entries +
+ + View All + +
+ {% if recent_entries %}
+
+
+
+
+
+
+ {% else %}
+ | Project | +Duration | +Date | +Notes | +Actions | +
|---|---|---|---|---|
|
+
+
+
+
+
+
+
+
+ {{ entry.project.name }}
+ {{ entry.project.client }}
+
+ |
+ + {{ entry.duration_formatted }} + | +
+
+ {{ entry.start_utc.strftime('%b %d') }}
+ {{ entry.start_utc.strftime('%H:%M') }}
+
+ |
+
+ {% if entry.notes %}
+
+ {{ entry.notes[:50] }}{% if entry.notes|length > 50 %}...{% endif %}
+
+ {% else %}
+ No notes
+ {% endif %}
+ |
+
+
+
+
+
+ {% if current_user.is_admin or entry.user_id == current_user.id %}
+
+ {% endif %}
+
+ |
+
+
+ {% endif %}
+
+
+
+ No recent entries
+Start tracking your time to see entries here
+ + Log Your First Entry + +
+
+
+
+
+
+
+
+
+{% endblock %}
+
+{% block extra_js %}
+
+{% endblock %}
diff --git a/app/templates/main/search.html b/app/templates/main/search.html
new file mode 100644
index 0000000..fa28bcf
--- /dev/null
+++ b/app/templates/main/search.html
@@ -0,0 +1,115 @@
+{% extends "base.html" %}
+
+{% block title %}Search - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+{% endblock %}
+
+
diff --git a/app/utils/cli.py b/app/utils/cli.py
new file mode 100644
index 0000000..4cd27a7
--- /dev/null
+++ b/app/utils/cli.py
@@ -0,0 +1,142 @@
+import click
+from flask.cli import with_appcontext
+from app import db
+from app.models import User, Project, TimeEntry, Settings
+from datetime import datetime, timedelta
+import os
+import shutil
+
+def register_cli_commands(app):
+ """Register CLI commands for the application"""
+
+ @app.cli.command()
+ @with_appcontext
+ def init_db():
+ """Initialize the database with tables and default data"""
+ # Create all tables
+ db.create_all()
+
+ # Initialize settings if they don't exist
+ if not Settings.query.first():
+ settings = Settings()
+ db.session.add(settings)
+ db.session.commit()
+ click.echo("Database initialized with default settings")
+
+ # Create admin user if it doesn't exist
+ admin_username = os.getenv('ADMIN_USERNAMES', 'admin').split(',')[0]
+ if not User.query.filter_by(username=admin_username).first():
+ admin_user = User(username=admin_username, role='admin')
+ db.session.add(admin_user)
+ db.session.commit()
+ click.echo(f"Created admin user: {admin_username}")
+
+ click.echo("Database initialization complete!")
+
+ @app.cli.command()
+ @with_appcontext
+ def create_admin():
+ """Create an admin user"""
+ username = click.prompt("Enter admin username")
+ if not username:
+ click.echo("Username cannot be empty")
+ return
+
+ if User.query.filter_by(username=username).first():
+ click.echo(f"User {username} already exists")
+ return
+
+ user = User(username=username, role='admin')
+ db.session.add(user)
+ db.session.commit()
+ click.echo(f"Created admin user: {username}")
+
+ @app.cli.command()
+ @with_appcontext
+ def backup_db():
+ """Create a backup of the database"""
+ from app.config import Config
+
+ url = Config.SQLALCHEMY_DATABASE_URI
+ timestamp = datetime.now().strftime('%Y%m%d_%H%M%S')
+
+ if url.startswith('sqlite:///'):
+ # SQLite file copy
+ db_path = url.replace('sqlite:///', '')
+ if not os.path.exists(db_path):
+ click.echo(f"Database file not found: {db_path}")
+ return
+ backup_dir = os.path.join(os.path.dirname(db_path), 'backups')
+ os.makedirs(backup_dir, exist_ok=True)
+ backup_filename = f"timetracker_backup_{timestamp}.db"
+ backup_path = os.path.join(backup_dir, backup_filename)
+ shutil.copy2(db_path, backup_path)
+ click.echo(f"Database backed up to: {backup_path}")
+ else:
+ click.echo("For PostgreSQL, please use pg_dump, e.g.: pg_dump --format=custom --dbname=\"$DATABASE_URL\" --file=backup.dump")
+
+ # Clean up old backups
+ cleanup_old_backups(backup_dir)
+
+ @app.cli.command()
+ @with_appcontext
+ def cleanup_old_entries():
+ """Clean up old time entries (older than specified days)"""
+ days = click.prompt("Delete entries older than (days)", type=int, default=365)
+
+ cutoff_date = datetime.utcnow() - timedelta(days=days)
+ old_entries = TimeEntry.query.filter(
+ TimeEntry.end_utc < cutoff_date
+ ).all()
+
+ if not old_entries:
+ click.echo("No old entries found")
+ return
+
+ count = len(old_entries)
+ if click.confirm(f"Delete {count} old entries?"):
+ for entry in old_entries:
+ db.session.delete(entry)
+ db.session.commit()
+ click.echo(f"Deleted {count} old entries")
+ else:
+ click.echo("Operation cancelled")
+
+ @app.cli.command()
+ @with_appcontext
+ def stats():
+ """Show database statistics"""
+ total_users = User.query.count()
+ active_users = User.query.filter_by(is_active=True).count()
+ total_projects = Project.query.count()
+ active_projects = Project.query.filter_by(status='active').count()
+ total_entries = TimeEntry.query.count()
+ completed_entries = TimeEntry.query.filter(TimeEntry.end_utc.isnot(None)).count()
+ active_timers = TimeEntry.query.filter_by(end_utc=None).count()
+
+ click.echo("Database Statistics:")
+ click.echo(f" Users: {total_users} (active: {active_users})")
+ click.echo(f" Projects: {total_projects} (active: {active_projects})")
+ click.echo(f" Time Entries: {total_entries} (completed: {completed_entries}, active: {active_timers})")
+
+ # Calculate total hours
+ total_hours = db.session.query(
+ db.func.sum(TimeEntry.duration_seconds)
+ ).filter(
+ TimeEntry.end_utc.isnot(None)
+ ).scalar() or 0
+
+ total_hours = round(total_hours / 3600, 2)
+ click.echo(f" Total Hours: {total_hours}")
+
+def cleanup_old_backups(backup_dir, retention_days=30):
+ """Clean up old backup files"""
+ cutoff_date = datetime.now() - timedelta(days=retention_days)
+
+ for filename in os.listdir(backup_dir):
+ file_path = os.path.join(backup_dir, filename)
+ if os.path.isfile(file_path):
+ file_time = datetime.fromtimestamp(os.path.getctime(file_path))
+ if file_time < cutoff_date:
+ os.remove(file_path)
+ click.echo(f"Removed old backup: {filename}")
diff --git a/app/utils/context_processors.py b/app/utils/context_processors.py
new file mode 100644
index 0000000..e756647
--- /dev/null
+++ b/app/utils/context_processors.py
@@ -0,0 +1,36 @@
+from flask import g, request
+from app.models import Settings
+
+def register_context_processors(app):
+ """Register context processors for the application"""
+
+ @app.context_processor
+ def inject_settings():
+ """Inject settings into all templates"""
+ try:
+ settings = Settings.get_settings()
+ return {
+ 'settings': settings,
+ 'currency': settings.currency,
+ 'timezone': settings.timezone
+ }
+ except:
+ # Return defaults if settings not available
+ return {
+ 'settings': None,
+ 'currency': 'EUR',
+ 'timezone': 'Europe/Brussels'
+ }
+
+ @app.context_processor
+ def inject_globals():
+ """Inject global variables into all templates"""
+ return {
+ 'app_name': 'Time Tracker',
+ 'app_version': '1.0.0'
+ }
+
+ @app.before_request
+ def before_request():
+ """Set up request-specific data"""
+ g.request_start_time = request.start_time if hasattr(request, 'start_time') else None
diff --git a/app/utils/error_handlers.py b/app/utils/error_handlers.py
new file mode 100644
index 0000000..c624942
--- /dev/null
+++ b/app/utils/error_handlers.py
@@ -0,0 +1,46 @@
+from flask import render_template, request, jsonify
+from werkzeug.exceptions import HTTPException
+import traceback
+
+def register_error_handlers(app):
+ """Register error handlers for the application"""
+
+ @app.errorhandler(404)
+ def not_found_error(error):
+ if request.path.startswith('/api/'):
+ return jsonify({'error': 'Not found'}), 404
+ return render_template('errors/404.html'), 404
+
+ @app.errorhandler(500)
+ def internal_error(error):
+ if request.path.startswith('/api/'):
+ return jsonify({'error': 'Internal server error'}), 500
+ return render_template('errors/500.html'), 500
+
+ @app.errorhandler(403)
+ def forbidden_error(error):
+ if request.path.startswith('/api/'):
+ return jsonify({'error': 'Forbidden'}), 403
+ return render_template('errors/403.html'), 403
+
+ @app.errorhandler(400)
+ def bad_request_error(error):
+ if request.path.startswith('/api/'):
+ return jsonify({'error': 'Bad request'}), 400
+ return render_template('errors/400.html'), 400
+
+ @app.errorhandler(HTTPException)
+ def handle_http_exception(error):
+ if request.path.startswith('/api/'):
+ return jsonify({'error': error.description}), error.code
+ return render_template('errors/generic.html', error=error), error.code
+
+ @app.errorhandler(Exception)
+ def handle_exception(error):
+ # Log the error
+ app.logger.error(f'Unhandled exception: {error}')
+ app.logger.error(traceback.format_exc())
+
+ if request.path.startswith('/api/'):
+ return jsonify({'error': 'Internal server error'}), 500
+ return render_template('errors/500.html'), 500
diff --git a/assets/README.md b/assets/README.md
new file mode 100644
index 0000000..c841263
--- /dev/null
+++ b/assets/README.md
@@ -0,0 +1,57 @@
+# Assets Directory
+
+This directory contains static assets for the TimeTracker GitHub Pages website.
+
+## Files to Add
+
+### Required Assets
+- `favicon.ico` - Website favicon (16x16 or 32x32 pixels)
+- `og-image.png` - Open Graph image for social media sharing (1200x630 pixels recommended)
+
+### Optional Assets
+- `logo.png` - Project logo (various sizes: 32x32, 64x64, 128x128, 256x256)
+- `screenshots/` - Directory for application screenshots
+- `icons/` - Additional icon files
+
+## Image Guidelines
+
+### Favicon
+- Format: ICO or PNG
+- Size: 16x16, 32x32, or 48x48 pixels
+- Should be simple and recognizable
+
+### Open Graph Image
+- Format: PNG or JPG
+- Size: 1200x630 pixels (1.91:1 aspect ratio)
+- Should include project name and key visual elements
+- Text should be readable at small sizes
+
+### Screenshots
+- Format: PNG or JPG
+- Size: Minimum 800x600 pixels
+- Should showcase key features of the application
+- Include descriptive filenames
+
+## Current Status
+- ✅ `README.md` - This file
+- ✅ `screenshots/` - Added 3 application screenshots
+- ❌ `favicon.ico` - Need to create
+- ❌ `og-image.png` - Need to create
+
+## Creating Assets
+
+### Favicon
+You can create a simple favicon using online tools like:
+- [Favicon.io](https://favicon.io/)
+- [RealFaviconGenerator](https://realfavicongenerator.net/)
+
+### Open Graph Image
+Create using design tools like:
+- Canva
+- Figma
+- GIMP
+- Photoshop
+
+Or use online tools like:
+- [Canva](https://canva.com/)
+- [Bannerbear](https://bannerbear.com/)
diff --git a/assets/screenshots/Dashboard.png b/assets/screenshots/Dashboard.png
new file mode 100644
index 0000000..af5ef33
Binary files /dev/null and b/assets/screenshots/Dashboard.png differ
diff --git a/assets/screenshots/Projects.png b/assets/screenshots/Projects.png
new file mode 100644
index 0000000..75bddc6
Binary files /dev/null and b/assets/screenshots/Projects.png differ
diff --git a/assets/screenshots/Reports.png b/assets/screenshots/Reports.png
new file mode 100644
index 0000000..826133d
Binary files /dev/null and b/assets/screenshots/Reports.png differ
diff --git a/deploy.sh b/deploy.sh
new file mode 100644
index 0000000..2dfcc5c
--- /dev/null
+++ b/deploy.sh
@@ -0,0 +1,100 @@
+#!/bin/bash
+
+# Time Tracker Deployment Script for Raspberry Pi
+# This script sets up the Time Tracker application on a Raspberry Pi
+
+set -e
+
+echo "🚀 Time Tracker Deployment Script"
+echo "=================================="
+
+# Check if running on Raspberry Pi
+if ! grep -q "Raspberry Pi" /proc/cpuinfo 2>/dev/null; then
+ echo "⚠️ Warning: This script is designed for Raspberry Pi"
+ echo " It may work on other systems but is not tested"
+fi
+
+# Check if Docker is installed
+if ! command -v docker &> /dev/null; then
+ echo "❌ Docker is not installed. Please install Docker first:"
+ echo " curl -fsSL https://get.docker.com -o get-docker.sh"
+ echo " sudo sh get-docker.sh"
+ echo " sudo usermod -aG docker $USER"
+ exit 1
+fi
+
+# Check if Docker Compose is installed
+if ! command -v docker-compose &> /dev/null; then
+ echo "❌ Docker Compose is not installed. Please install Docker Compose first:"
+ echo " sudo apt-get update"
+ echo " sudo apt-get install docker-compose-plugin"
+ exit 1
+fi
+
+echo "✅ Docker and Docker Compose are installed"
+
+# Create necessary directories
+echo "📁 Creating directories..."
+mkdir -p data logs backups
+
+# Copy environment file if it doesn't exist
+if [ ! -f .env ]; then
+ echo "📝 Creating .env file from template..."
+ cp env.example .env
+ echo "⚠️ Please edit .env file with your configuration before starting"
+ echo " Key settings to review:"
+ echo " - SECRET_KEY: Change this to a secure random string"
+ echo " - ADMIN_USERNAMES: Set your admin usernames"
+ echo " - TZ: Set your timezone"
+ echo " - CURRENCY: Set your currency"
+else
+ echo "✅ .env file already exists"
+fi
+
+# Build and start the application
+echo "🔨 Building Docker image..."
+docker-compose build
+
+echo "🚀 Starting Time Tracker..."
+docker-compose up -d
+
+# Wait for application to start
+echo "⏳ Waiting for application to start..."
+sleep 10
+
+# Check if application is running
+if curl -f http://localhost:8080/_health > /dev/null 2>&1; then
+ echo "✅ Time Tracker is running successfully!"
+ echo ""
+ echo "🌐 Access the application at:"
+ echo " http://$(hostname -I | awk '{print $1}'):8080"
+ echo ""
+ echo "📋 Next steps:"
+ echo " 1. Open the application in your browser"
+ echo " 2. Log in with your admin username"
+ echo " 3. Create your first project"
+ echo " 4. Start tracking time!"
+ echo ""
+ echo "🔧 Useful commands:"
+ echo " View logs: docker-compose logs -f"
+ echo " Stop app: docker-compose down"
+ echo " Restart: docker-compose restart"
+ echo " Update: git pull && docker-compose up -d --build"
+else
+ echo "❌ Application failed to start. Check logs with:"
+ echo " docker-compose logs"
+ exit 1
+fi
+
+# Optional: Enable TLS with reverse proxy
+read -p "🔒 Enable HTTPS with reverse proxy? (y/N): " -n 1 -r
+echo
+if [[ $REPLY =~ ^[Yy]$ ]]; then
+ echo "🔒 Starting with TLS support..."
+ docker-compose --profile tls up -d
+ echo "✅ HTTPS enabled! Access at:"
+ echo " https://$(hostname -I | awk '{print $1}')"
+fi
+
+echo ""
+echo "🎉 Deployment complete!"
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..8e22c63
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,74 @@
+services:
+ app:
+ build: .
+ container_name: timetracker-app
+ environment:
+ - TZ=${TZ:-Europe/Brussels}
+ - CURRENCY=${CURRENCY:-EUR}
+ - ROUNDING_MINUTES=${ROUNDING_MINUTES:-1}
+ - SINGLE_ACTIVE_TIMER=${SINGLE_ACTIVE_TIMER:-true}
+ - ALLOW_SELF_REGISTER=${ALLOW_SELF_REGISTER:-true}
+ - IDLE_TIMEOUT_MINUTES=${IDLE_TIMEOUT_MINUTES:-30}
+ - ADMIN_USERNAMES=${ADMIN_USERNAMES:-admin}
+ - SECRET_KEY=${SECRET_KEY:-your-secret-key-change-this}
+ - DATABASE_URL=postgresql+psycopg2://timetracker:timetracker@db:5432/timetracker
+ ports:
+ - "8080:8080"
+ volumes:
+ - app_data:/data
+ - ./logs:/app/logs
+ depends_on:
+ - db
+ restart: unless-stopped
+ healthcheck:
+ test: ["CMD", "curl", "-f", "http://localhost:8080/_health"]
+ interval: 30s
+ timeout: 10s
+ retries: 3
+ start_period: 40s
+
+ db:
+ image: postgres:16-alpine
+ container_name: timetracker-db
+ environment:
+ - POSTGRES_DB=${POSTGRES_DB:-timetracker}
+ - POSTGRES_USER=${POSTGRES_USER:-timetracker}
+ - POSTGRES_PASSWORD=${POSTGRES_PASSWORD:-timetracker}
+ - TZ=${TZ:-Europe/Brussels}
+ volumes:
+ - db_data:/var/lib/postgresql/data
+ ports:
+ - "5432:5432"
+ healthcheck:
+ test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]
+ interval: 10s
+ timeout: 5s
+ retries: 5
+ restart: unless-stopped
+
+ # Optional reverse proxy for TLS on LAN
+ proxy:
+ image: caddy:2-alpine
+ container_name: timetracker-proxy
+ volumes:
+ - ./docker/Caddyfile:/etc/caddy/Caddyfile:ro
+ - caddy_data:/data
+ - caddy_config:/config
+ ports:
+ - "80:80"
+ - "443:443"
+ depends_on:
+ - app
+ restart: unless-stopped
+ profiles:
+ - tls
+
+volumes:
+ app_data:
+ driver: local
+ db_data:
+ driver: local
+ caddy_data:
+ driver: local
+ caddy_config:
+ driver: local
diff --git a/docker/Caddyfile b/docker/Caddyfile
new file mode 100644
index 0000000..6d50acf
--- /dev/null
+++ b/docker/Caddyfile
@@ -0,0 +1,60 @@
+# Caddyfile for Time Tracker reverse proxy
+# This provides TLS termination and static asset caching
+
+# Main application
+:80 {
+ # Redirect HTTP to HTTPS
+ redir https://{host}{uri} permanent
+}
+
+:443 {
+ # TLS configuration
+ tls internal
+
+ # Reverse proxy to the Flask application
+ reverse_proxy app:8080 {
+ # Health checks
+ health_uri /_health
+ health_interval 30s
+ health_timeout 10s
+
+ # Headers
+ header_up X-Real-IP {remote_host}
+ header_up X-Forwarded-For {remote_host}
+ header_up X-Forwarded-Proto {scheme}
+ header_up Host {host}
+ }
+
+ # Security headers
+ header {
+ # Security headers
+ X-Content-Type-Options nosniff
+ X-Frame-Options DENY
+ X-XSS-Protection "1; mode=block"
+ Referrer-Policy strict-origin-when-cross-origin
+ Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; connect-src 'self' ws: wss:;"
+
+ # Remove server header
+ -Server
+ }
+
+ # Gzip compression
+ encode gzip
+
+ # Static file caching
+ @static {
+ path *.css *.js *.png *.jpg *.jpeg *.gif *.ico *.svg *.woff *.woff2 *.ttf *.eot
+ }
+ header @static Cache-Control "public, max-age=31536000"
+
+ # Logging
+ log {
+ output file /var/log/caddy/access.log
+ format json
+ }
+}
+
+# Health check endpoint (no TLS required)
+:8080 {
+ reverse_proxy app:8080
+}
diff --git a/env.example b/env.example
new file mode 100644
index 0000000..c1b8744
--- /dev/null
+++ b/env.example
@@ -0,0 +1,39 @@
+# Time Tracker Configuration
+# Copy this file to .env and modify as needed
+
+# Application Settings
+SECRET_KEY=your-secret-key-change-this-in-production
+FLASK_ENV=production
+FLASK_DEBUG=false
+
+# Database
+DATABASE_URL=postgresql+psycopg2://timetracker:timetracker@localhost:5432/timetracker
+POSTGRES_DB=timetracker
+POSTGRES_USER=timetracker
+POSTGRES_PASSWORD=timetracker
+
+# Timezone and Localization
+TZ=Europe/Brussels
+CURRENCY=EUR
+
+# Time Tracking Settings
+ROUNDING_MINUTES=1
+SINGLE_ACTIVE_TIMER=true
+IDLE_TIMEOUT_MINUTES=30
+
+# User Management
+ALLOW_SELF_REGISTER=true
+ADMIN_USERNAMES=admin
+
+# Session Settings
+SESSION_COOKIE_SECURE=false
+SESSION_COOKIE_HTTPONLY=true
+PERMANENT_SESSION_LIFETIME=86400
+
+# Backup Settings
+BACKUP_RETENTION_DAYS=30
+BACKUP_TIME=02:00
+
+# Logging
+LOG_LEVEL=INFO
+LOG_FILE=/app/logs/timetracker.log
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..c0397ff
--- /dev/null
+++ b/index.html
@@ -0,0 +1,899 @@
+
+
+
+
+
+
+
+
+
+
+
+
+ + Search Results +
+ +
+
+
+
+
+
+
+
+ Results
+
+ {% if entries and entries.items %}
+
+
+
+
+
+
+
+
+
+ {% else %}
+ | Project | +Start | +End | +Duration | +Notes | +Tags | +Actions | +
|---|---|---|---|---|---|---|
| + {{ entry.project.name }} + | +{{ entry.start_utc.strftime('%Y-%m-%d %H:%M') }} | +{{ entry.end_utc.strftime('%Y-%m-%d %H:%M') if entry.end_utc else '-' }} | +{{ entry.duration_formatted }} | ++ {% if entry.notes %} + {{ entry.notes[:80] }}{% if entry.notes|length > 80 %}...{% endif %} + {% else %}-{% endif %} + | +{{ entry.tags or '-' }} | +
+
+
+
+
+ {% if current_user.is_admin or entry.user_id == current_user.id %}
+
+ {% endif %}
+
+ |
+
+
+
+ {% endif %}
+ No results found
+Try a different query or check your spelling.
+
+
+
+
+
+ ⏱️ TimeTracker
+
+ Self-hosted time tracking for teams and freelancers
+ +
+
+ Why Choose TimeTracker?
+Built for reliability, designed for simplicity, and engineered for performance
+ +
+
+
+
+
+
+ Persistent Timers
+Server-side timers that survive browser restarts and computer reboots. Never lose track of your time again.
+
+
+
+
+ Self-Hosted
+Full control over your data with no cloud dependencies. Deploy on your own infrastructure with confidence.
+
+
+
+
+ Rich Reporting
+Comprehensive reports and analytics with CSV export capabilities for external analysis and billing.
+
+
+
+
+ Team Management
+User roles, project organization, and billing support for teams of any size.
+
+
+
+
+ Docker Ready
+Simple deployment with Docker and Docker Compose. Perfect for Raspberry Pi and production environments.
+
+
+
+ Open Source
+Licensed under GPL v3, ensuring derivatives remain open source and accessible to everyone.
+
+
+ See TimeTracker in Action
+Beautiful, intuitive interface designed for productivity and ease of use
+ +
+
+
+
+
+
+ 
+
+
+
+
+ Dashboard View
+Clean, intuitive interface showing active timers and recent activity. Quick access to start/stop timers and manual time entry.
+
+
+
+
+ 
+
+
+
+
+ Project Management
+Client and project organization with billing information. Time tracking across multiple projects simultaneously.
+
+
+
+ 
+
+
+
+
+ Reports & Analytics
+Comprehensive time reports with export capabilities. Visual breakdowns of time allocation and productivity.
+
+
+
+
+
+
+ Solving Real Time Tracking Problems
+-
+
- + + Traditional timers lose data when browsers close + +
- + + Cloud dependencies and privacy concerns + +
- + + Complex setup and maintenance + +
- + + Limited reporting and export options + +
+
+ TimeTracker Solutions
+✅ Persistent server-side timers
+✅ Self-hosted, no cloud required
+✅ Simple Docker deployment
+✅ Rich reporting and exports
+✅ Team collaboration features
+
+
+ Get Started in Minutes
+Deploy TimeTracker on your Raspberry Pi or any Linux system with just a few commands
+ +
+
+
+
+
+ 1
+ Clone Repository
+Get the latest version of TimeTracker from GitHub
+
+ # Clone the repository
+ git clone https://github.com/yourusername/TimeTracker.git
+ cd TimeTracker +
+ + git clone https://github.com/yourusername/TimeTracker.git
+ cd TimeTracker +
+
+
+ 2
+ Configure Environment
+Set up your environment variables and preferences
+
+ # Copy and edit environment file
+ cp .env.example .env
+ # Edit with your settings +
+ + cp .env.example .env
+ # Edit with your settings +
+
+
+ 3
+ Start Application
+Launch TimeTracker with Docker Compose
+
+ # Start the application
+ docker-compose up -d +
+ + docker-compose up -d +
+
+ 4
+ Access & Use
+Open your browser and start tracking time
+
+ # Access at
+ http://your-pi-ip:8080 +
+ + http://your-pi-ip:8080 +
+
+
+
+
+
+ 100%
+Open Source
+
+
+ 0
+Cloud Dependencies
+
+
+ ∞
+Customization
+
+
+ 🚀
+Easy Deployment
+
+
+{% endblock %}
+
+
diff --git a/templates/admin/dashboard.html b/templates/admin/dashboard.html
new file mode 100644
index 0000000..437a7c8
--- /dev/null
+++ b/templates/admin/dashboard.html
@@ -0,0 +1,245 @@
+{% extends "base.html" %}
+
+{% block title %}Admin Dashboard - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+
+
+ + New User +
+
+
+
+
+
+
+
+
+ + User Information +
+
+
+
+
+
+{% endblock %}
diff --git a/templates/admin/settings.html b/templates/admin/settings.html
new file mode 100644
index 0000000..7b767ed
--- /dev/null
+++ b/templates/admin/settings.html
@@ -0,0 +1,108 @@
+{% extends "base.html" %}
+
+{% block title %}Settings - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+ + Admin Dashboard +
+
+
+ System Info
+
+
+ Backup
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {{ stats.total_users }}
+Total Users
+
+
+
+
+
+
+
+ {{ stats.total_projects }}
+Total Projects
+
+
+
+
+
+
+
+ {{ stats.total_entries }}
+Time Entries
+
+
+
+
+
+
+
+ {{ "%.1f"|format(stats.total_hours) }}h
+Total Hours
+
+
+
+
+
+
+
+
+
+
+
+ + User Management +
+
+
+
+
+
+
+
+
+
+ + System Settings +
+
+
+
+
+
+
+
+
+
+
+
+
+ + Recent Activity +
+
+ {% if recent_entries %}
+
+
+
+
+
+
+ {% else %}
+ | User | +Project | +Date | +Duration | +Status | +
|---|---|---|---|---|
| {{ entry.user.username }} | ++ + {{ entry.project.name }} + + | +{{ entry.start_utc.strftime('%Y-%m-%d %H:%M') }} | ++ {{ entry.duration_formatted }} + | ++ {% if entry.end_utc %} + Completed + {% else %} + Running + {% endif %} + | +
+
+
+ {% endif %}
+ No Recent Activity
+No time entries have been recorded recently.
+
+
+
+
+
+
+
+ + System Overview +
+
+
+
+
+
+ Active Users
+
+
+
+
+
+
+ Active Projects
+
+
+
+
+
+
+ Billable Hours
+
+
+
+
+
+ System Health
+
+ Database
+ Healthy
+
+
+ Backup Status
+ {% if stats.last_backup %}
+ {{ stats.last_backup.strftime('%Y-%m-%d') }}
+ {% else %}
+ No Backup
+ {% endif %}
+
+
+
+
+
+ + Quick Actions +
+
+
+
+
+
+{% endblock %}
+
+
diff --git a/templates/admin/system_info.html b/templates/admin/system_info.html
new file mode 100644
index 0000000..8e22cad
--- /dev/null
+++ b/templates/admin/system_info.html
@@ -0,0 +1,41 @@
+{% extends "base.html" %}
+
+{% block title %}System Info - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+ + System Settings +
+ + Back to Dashboard + +
+
+
+
+
+
+
+
+
+ Configuration
+
+
+
+
+
+
+
+
+
+ Help
+
+
+ Configure application-wide settings such as timezone, currency, timer behavior, and data export options.
+-
+
- Rounding affects how durations are rounded when displayed. +
- Single Active Timer stops any running timer when a new one is started. +
- Self Register allows new usernames to be created on login. +
+
+{% endblock %}
+
+
diff --git a/templates/admin/user_form.html b/templates/admin/user_form.html
new file mode 100644
index 0000000..2df6b3a
--- /dev/null
+++ b/templates/admin/user_form.html
@@ -0,0 +1,205 @@
+{% extends "base.html" %}
+
+{% block title %}{% if user %}Edit{% else %}New{% endif %} User - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+ System Information
+
+
+
+
+
+ Total Users
+ {{ total_users }}
+
+
+ Total Projects
+ {{ total_projects }}
+
+
+ Time Entries
+ {{ total_entries }}
+
+
+ Active Timers
+ {{ active_timers }}
+
+
+ Database Size
+ {{ db_size_mb }} MB
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + + {% if user %}Edit User{% else %}New User{% endif %} +
+
+
+
+
+
+
+
+
+
+ + User Information +
+
+
+
+
+
+
+
+
+ {% if user and user.id != current_user.id %}
+
+
+ + Help +
+
+
+
+ Username
+Choose a unique username for the user. This will be used for login.
+ +Role
+
+ User: Can track time, view projects, and generate reports.
+ Admin: Can manage users, projects, and system settings.
+
Active Status
+Inactive users cannot log in or access the system.
+ + {% if user %} ++
User Statistics
+
+
+
+
+
+ {{ "%.1f"|format(user.total_hours) }}
+ Total Hours
+
+
+ {{ user.time_entries.count() }}
+ Time Entries
+
+
+ {% endif %}
+ Account Information
+ +Created: {{ user.created_at.strftime('%Y-%m-%d %H:%M') }}
+ {% if user.last_login %}
+ Last Login: {{ user.last_login.strftime('%Y-%m-%d %H:%M') }}
+ {% else %}
+ Last Login: Never
+ {% endif %}
+
+
+
+ {% endif %}
+
+
+ + Danger Zone +
+
+
+ These actions cannot be undone.
+ +
+
+
+
+{% endblock %}
diff --git a/templates/admin/users.html b/templates/admin/users.html
new file mode 100644
index 0000000..80dc62b
--- /dev/null
+++ b/templates/admin/users.html
@@ -0,0 +1,216 @@
+{% extends "base.html" %}
+
+{% block title %}User Management - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + User Management +
+
+
+ New User
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {{ stats.total_users }}
+Total Users
+
+
+
+
+
+
+
+ {{ stats.active_users }}
+Active Users
+
+
+
+
+
+
+
+ {{ stats.admin_users }}
+Admin Users
+
+
+
+
+
+
+
+ {{ "%.1f"|format(stats.total_hours) }}h
+Total Hours
+
+
+
+
+
+
+
+
+ + Users ({{ users|length }}) +
+
+ {% if users %}
+
+
+
+
+
+
+ {% else %}
+
+ {% endif %}
+ | Username | +Role | +Status | +Created | +Last Login | +Total Hours | +Actions | +
|---|---|---|---|---|---|---|
|
+
+ {{ user.username }}
+ {% if user.active_timer %}
+
+ + Timer Running + + {% endif %} + |
+ + {% if user.role == 'admin' %} + Admin + {% else %} + User + {% endif %} + | ++ {% if user.is_active %} + Active + {% else %} + Inactive + {% endif %} + | +{{ user.created_at.strftime('%Y-%m-%d') }} | ++ {% if user.last_login %} + {{ user.last_login.strftime('%Y-%m-%d %H:%M') }} + {% else %} + Never + {% endif %} + | ++ {{ "%.1f"|format(user.total_hours) }}h + | +
+
+
+
+
+ {% if user.id != current_user.id %}
+
+ {% endif %}
+
+ |
+
+
+
+
+{% endblock %}
diff --git a/templates/errors/400.html b/templates/errors/400.html
new file mode 100644
index 0000000..c26a8b0
--- /dev/null
+++ b/templates/errors/400.html
@@ -0,0 +1,37 @@
+{% extends "base.html" %}
+
+{% block title %}400 Bad Request - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+{% endblock %}
diff --git a/templates/errors/403.html b/templates/errors/403.html
new file mode 100644
index 0000000..e9f748d
--- /dev/null
+++ b/templates/errors/403.html
@@ -0,0 +1,38 @@
+{% extends "base.html" %}
+
+{% block title %}403 Forbidden - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+ + 400 Bad Request +
+
+
+ Invalid Request
++ The request you made is invalid or contains errors. This could be due to: +
+-
+
- Missing or invalid form data +
- Malformed request parameters +
+
+ Go to Dashboard
+
+
+
+
+
+{% endblock %}
diff --git a/templates/errors/404.html b/templates/errors/404.html
new file mode 100644
index 0000000..8e9c7f0
--- /dev/null
+++ b/templates/errors/404.html
@@ -0,0 +1,28 @@
+{% extends "base.html" %}
+
+{% block title %}Page Not Found - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+ + 403 Forbidden +
+
+
+ Access Denied
++ You don't have permission to access this resource. This could be due to: +
+-
+
- Insufficient privileges +
- Not logged in +
- Resource access restrictions +
+
+ Go to Dashboard
+
+
+ Login
+
+
+
+
+{% endblock %}
diff --git a/templates/errors/500.html b/templates/errors/500.html
new file mode 100644
index 0000000..82b6b34
--- /dev/null
+++ b/templates/errors/500.html
@@ -0,0 +1,28 @@
+{% extends "base.html" %}
+
+{% block title %}Server Error - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+ 404
+Page Not Found
++ The page you're looking for doesn't exist or has been moved. +
+ +
+
+{% endblock %}
diff --git a/templates/main/about.html b/templates/main/about.html
new file mode 100644
index 0000000..04fe019
--- /dev/null
+++ b/templates/main/about.html
@@ -0,0 +1,202 @@
+{% extends "base.html" %}
+
+{% block title %}About - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+ 500
+Server Error
++ Something went wrong on our end. Please try again later. +
+ +
+
+{% endblock %}
diff --git a/templates/main/help.html b/templates/main/help.html
new file mode 100644
index 0000000..5a6d03a
--- /dev/null
+++ b/templates/main/help.html
@@ -0,0 +1,268 @@
+{% extends "base.html" %}
+
+{% block title %}Help - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+ About TimeTracker
++ A simple, efficient time tracking solution for teams and individuals. +
++ Developed by DryTrix +
+
+
+
+
+
+ + What is {{ app_name }}? +
+
+
+ + {{ app_name }} is a web-based time tracking application designed for internal use within organizations. + It provides a simple and intuitive interface for tracking time spent on various projects and tasks. +
++ Built with modern web technologies, it offers real-time timer functionality, comprehensive reporting, + and user management features while maintaining simplicity and ease of use. +
+
+
+
+
+
+
+
+
+
+
+ + Key Features +
+
+
+ -
+
- + + Real-time timer tracking + +
- + + Project and client management + +
- + + Comprehensive reporting + +
- + + User role management + +
- + + Billable time tracking + +
- + + Data export capabilities + +
+
+
+
+
+
+ + Technology +
+
+
+ -
+
- + + Python 3.11+ + +
- + + Flask web framework + +
- + + SQLAlchemy ORM + +
- + + Bootstrap 5 UI + +
- + + WebSocket support + +
- + + Docker deployment + +
+
+
+
+
+ + About DryTrix +
+
+
+
+
+
+
+ + DryTrix is a software development company specializing in creating efficient, + user-friendly business applications. Our focus is on delivering solutions that streamline + workflows and improve productivity. +
++ TimeTracker represents our commitment to building software that is both powerful and + accessible, designed with the end-user in mind. We believe in creating tools that + teams actually want to use. +
+
+
+
+
+
+
+
+
+
+ + Security & Privacy +
+
+
+ + {{ app_name }} is designed for internal use and prioritizes data security and privacy: +
+-
+
- Username-only authentication for simplicity +
- Role-based access control +
- Secure session management +
- Data stored locally on your infrastructure +
- No external data sharing or tracking +
+
+
+
+ + Getting Help +
+
+
+ + Need help using {{ app_name }}? Here are some resources: +
+
+
+
+
+ Documentation
++ Check the help section for detailed instructions on using all features. +
+ + View Help + +
+
+ System Information
++ View system status and configuration details. +
+ {% if current_user.is_admin %} + + System Info + + {% else %} + Admin access required + {% endif %} +
+
+{% endblock %}
diff --git a/templates/projects/client_view.html b/templates/projects/client_view.html
new file mode 100644
index 0000000..0ec5048
--- /dev/null
+++ b/templates/projects/client_view.html
@@ -0,0 +1,88 @@
+{% extends "base.html" %}
+
+{% block title %}Client - {{ client_name }} - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+
+ + Contents +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {% if current_user.is_admin %}
+
+
+
+ {% endif %}
+
+
+
+
+
+
+
+
+
+
+
+ Help & Documentation
+TimeTracker by DryTrix
+Getting Started
+
+
+
+
+ First Time Setup
+-
+
- Log in with your username (no password required) +
- If you're an admin, create projects for your team +
- Start tracking time on your first project +
Navigation
+-
+
- Dashboard: Overview of your current timer and recent activity +
- Timer: Start, stop, and manage time tracking +
- Projects: View and manage projects (admin only) +
- Reports: Generate time reports and export data + {% if current_user.is_admin %} +
- Admin: Manage users and system settings + {% endif %} +
Using the Timer
+
+
+
+
+ Starting a Timer
+-
+
- Go to the Timer page or use the "Start Timer" button on the dashboard +
- Select a project from the dropdown +
- Add optional notes about what you're working on +
- Add optional tags (separated by commas) +
- Click "Start Timer" +
Active Timer
+-
+
- The timer runs continuously until you stop it +
- You can see the current duration in real-time +
- The timer persists even if you close your browser +
- Only one timer can be active at a time per user +
Stopping a Timer
+-
+
- Click the "Stop Timer" button to end the current session +
- The time entry will be saved automatically +
- You can edit the entry later if needed +
Manual Time Entries
+You can also create time entries manually by specifying start and end times, useful for recording time spent away from the computer.
+Managing Projects
+
+
+
+
+ Project Structure
+-
+
- Name: Descriptive project name +
- Client: Optional client name for organization +
- Description: Project details and scope +
- Billable: Whether time should be tracked for billing +
- Hourly Rate: Rate for billable time calculations +
- Status: Active or archived +
Admin Project Management
+-
+
- Create new projects with the "New Project" button +
- Edit existing projects to update details +
- Archive projects to hide them from timers (data is preserved) +
- Delete projects (use with caution - this removes all associated time entries) +
Viewing Project Details
+Click on any project to view detailed statistics, time entries, and user breakdowns.
+Reports
+
+
+
+
+ Available Reports
+-
+
- Project Report: Time breakdown by project with filtering options +
- User Report: Time tracking statistics by user +
- Summary Report: Overview of key metrics and trends +
- CSV Export: Export time entries for external analysis +
Filtering Options
+-
+
- Date Range: Filter by start and end dates +
- Project: Filter by specific project +
- User: Filter by specific user +
- Status: Filter by project status +
Exporting Data
+Use the CSV export feature to download time entries for use in external tools like Excel or accounting software.
+Admin Features
+
+
+
+
+ User Management
+-
+
- Create new users with username-only authentication +
- Assign user roles (user or admin) +
- Activate/deactivate user accounts +
- View user statistics and activity +
System Settings
+-
+
- Configure timezone and currency +
- Set time rounding rules +
- Enable/disable self-registration +
- Configure backup settings +
System Maintenance
+-
+
- Create manual database backups +
- View system information and health +
- Monitor system statistics +
- Clean up old data +
Frequently Asked Questions
+
+
+
+
+
+
+
+
+
+ + +
+
+
+
+ The timer will continue running until you stop it. You can see your active timer on the dashboard and timer page. The timer persists even if you close your browser.
+
+
+
+
+ + +
+
+
+
+ Yes, you can edit any time entry by clicking the edit button. You can modify the project, start/end times, notes, tags, and billable status.
+
+
+
+
+ + +
+
+
+
+ You can only have one active timer at a time. To switch projects, stop your current timer and start a new one for the different project. You can also create manual time entries for past work.
+
+
+
+
+ + +
+
+
+
+ Go to the Reports page and use the "Export CSV" feature. You can apply filters to export specific data, or export all time entries. The CSV file can be opened in Excel or other spreadsheet applications.
+
+
+
+ + +
+
+
+
+ Billable time is tracked for client billing purposes and can have an hourly rate associated with it. Non-billable time is for internal work that doesn't get charged to clients. You can mark individual time entries as billable or non-billable.
+
+
+
+{% endblock %}
+
+
diff --git a/templates/projects/clients.html b/templates/projects/clients.html
new file mode 100644
index 0000000..3ce1895
--- /dev/null
+++ b/templates/projects/clients.html
@@ -0,0 +1,51 @@
+{% extends "base.html" %}
+
+{% block title %}Clients - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+ + {{ client_name }} +
+ + Back to Clients + +
+
+
+
+
+
+
+
+ Projects ({{ projects|length }})
+
+ {% if projects %}
+
+
+
+
+
+
+ {% else %}
+ | Project | +Status | +Total Hours | +Billable Hours | +Actions | +
|---|---|---|---|---|
|
+
+ {{ project.name }}
+
+ {% if project.description %}
+ {{ project.description[:100] }}{% if project.description|length > 100 %}...{% endif %} + {% endif %} + |
+ + {% if project.status == 'active' %} + Active + {% else %} + Archived + {% endif %} + | +{{ "%.1f"|format(project.total_hours) }}h | ++ {% if project.billable %} + {{ "%.1f"|format(project.total_billable_hours) }}h + {% else %} + - + {% endif %} + | ++ + View + + | +
+
+
+ {% endif %}
+ No Projects for this Client
+
+
+{% endblock %}
+
+
diff --git a/templates/projects/create.html b/templates/projects/create.html
new file mode 100644
index 0000000..05a2926
--- /dev/null
+++ b/templates/projects/create.html
@@ -0,0 +1,99 @@
+{% extends "base.html" %}
+
+{% block title %}New Project - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+ + Clients +
+
+
+
+
+
+
+
+
+ Client List ({{ clients|length }})
+
+ {% if clients %}
+
+
+ {% for client in clients %}
+
+ {% endfor %}
+
+ {% else %}
+
+
+
+ {% endif %}
+ No Clients Found
+
+
+{% endblock %}
+
+
diff --git a/templates/projects/edit.html b/templates/projects/edit.html
new file mode 100644
index 0000000..5f19f1f
--- /dev/null
+++ b/templates/projects/edit.html
@@ -0,0 +1,100 @@
+{% extends "base.html" %}
+
+{% block title %}Edit Project - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+
+
+ + New Project +
+
+
+
+
+
+
+
+
+ + Project Information +
+
+
+
+
+
+{% endblock %}
+
+
diff --git a/templates/projects/form.html b/templates/projects/form.html
new file mode 100644
index 0000000..11d406c
--- /dev/null
+++ b/templates/projects/form.html
@@ -0,0 +1,246 @@
+{% extends "base.html" %}
+
+{% block title %}{% if project %}Edit{% else %}New{% endif %} Project - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+
+
+ + Edit Project +
+
+
+
+
+
+
+
+
+ + Project Information +
+
+
+
+
+
+{% endblock %}
+
+{% block scripts %}
+
+{% endblock %}
diff --git a/templates/projects/list.html b/templates/projects/list.html
new file mode 100644
index 0000000..7d28352
--- /dev/null
+++ b/templates/projects/list.html
@@ -0,0 +1,336 @@
+{% extends "base.html" %}
+
+{% block title %}Projects - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+
+
+ + + {% if project %}Edit Project{% else %}New Project{% endif %} +
+
+
+
+
+
+
+
+
+
+ + Project Information +
+
+
+
+
+
+
+
+
+ {% if project %}
+
+
+ + Help +
+
+
+ Project Name
+Choose a descriptive name that clearly identifies the project.
+ +Client
+Optional client name for organization. You can group projects by client.
+ +Description
+Provide details about the project scope, objectives, or any relevant information.
+ +Billable
+Check this if time spent on this project should be tracked for billing purposes.
+ +Hourly Rate
+Set the hourly rate for billable time. Leave empty for non-billable projects.
+ +Billing Reference
+Optional reference number or code for billing systems.
+ +Status
+Active projects can have time tracked. Archived projects are hidden from timers but retain data.
+
+
+ {% endif %}
+
+
+ + Current Statistics +
+
+
+
+
+
+
+ {{ "%.1f"|format(project.total_hours) }}
+ Total Hours
+
+
+ {% if project.billable and project.hourly_rate %}
+ {{ "%.1f"|format(project.total_billable_hours) }}
+ Billable Hours
+
+
+ {% endif %}
+ {{ currency }} {{ "%.2f"|format(project.estimated_cost) }}
+ Estimated Cost
+
+
+
+
+
+
+
+
+
+
+
+
+ + Projects +
+ {% if current_user.is_admin %} +
+
+ New Project
+
+
+ {% endif %}
+
+
+
+
+
+
+
+
+
+
+ + Filters +
+
+
+
+
+
+
+
+
+
+
+
+ + Projects ({{ projects|length }}) +
+
+ {% if projects %}
+
+
+
+
+
+
+ {% else %}
+ | Project | +Client | +Status | +Total Hours | +Billable Hours | +Rate | +Actions | +
|---|---|---|---|---|---|---|
|
+
+ {{ project.name }}
+ {% if project.description %}
+
+ {{ project.description[:100] }}{% if project.description|length > 100 %}...{% endif %} + {% endif %} + |
+ + {% if project.client %} + + {{ project.client }} + + {% else %} + - + {% endif %} + | ++ {% if project.status == 'active' %} + Active + {% else %} + Archived + {% endif %} + | ++ {{ "%.1f"|format(project.total_hours) }}h + | ++ {% if project.billable %} + {{ "%.1f"|format(project.total_billable_hours) }}h + {% else %} + - + {% endif %} + | ++ {% if project.billable and project.hourly_rate %} + {{ currency }} {{ "%.2f"|format(project.hourly_rate) }} + {% else %} + - + {% endif %} + | ++ + | +
+
+
+ {% endif %}
+ No Projects Found
++ {% if request.args.get('status') or request.args.get('client') or request.args.get('search') %} + Try adjusting your filters or + view all projects. + {% else %} + {% if current_user.is_admin %} + Get started by creating your first project. + {% else %} + No projects have been created yet. + {% endif %} + {% endif %} +
+ {% if current_user.is_admin and not (request.args.get('status') or request.args.get('client') or request.args.get('search')) %} + + Create First Project + + {% endif %} +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+{% endblock %}
diff --git a/templates/projects/view.html b/templates/projects/view.html
new file mode 100644
index 0000000..88e3c60
--- /dev/null
+++ b/templates/projects/view.html
@@ -0,0 +1,350 @@
+{% extends "base.html" %}
+
+{% block title %}{{ project.name }} - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + {{ project.name }} +
+
+ {% if current_user.is_admin %}
+
+ Edit
+
+ {% endif %}
+
+ Start Timer
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + Project Details +
+
+
+
+
+
+ {% if project.description %}
+
+
+ -
+
- Name: +
- {{ project.name }} + +
- Client: +
- + {% if project.client %} + + {{ project.client }} + + {% else %} + - + {% endif %} + + +
- Status: +
- + {% if project.status == 'active' %} + Active + {% else %} + Archived + {% endif %} + + +
- Created: +
- {{ project.created_at.strftime('%Y-%m-%d %H:%M') }} +
+
+ -
+
- Billable: +
- + {% if project.billable %} + Yes + {% else %} + No + {% endif %} + + + {% if project.billable and project.hourly_rate %} +
- Hourly Rate: +
- {{ currency }} {{ "%.2f"|format(project.hourly_rate) }} + {% endif %} + + {% if project.billing_ref %} +
- Billing Ref: +
- {{ project.billing_ref }} + {% endif %} + +
- Last Updated: +
- {{ project.updated_at.strftime('%Y-%m-%d %H:%M') }} +
+
+ {% endif %}
+ Description:
+{{ project.description }}
+
+
+
+
+
+ {% if project.billable and project.hourly_rate %}
+
+
+ + Statistics +
+
+
+
+
+
+
+ {{ "%.1f"|format(project.total_hours) }}
+ Total Hours
+
+
+ {% if project.billable and project.hourly_rate %}
+ {{ "%.1f"|format(project.total_billable_hours) }}
+ Billable Hours
+
+
+ {% endif %}
+ {{ currency }} {{ "%.2f"|format(project.estimated_cost) }}
+ Estimated Cost
+
+
+ {% endif %}
+
+
+ + User Breakdown +
+
+ {% for user_total in project.get_user_totals() %}
+
+
+ {{ user_total.username }}
+ {{ "%.1f"|format(user_total.total_hours) }}h
+
+ {% endfor %}
+
+
+
+
+
+
+
+
+ + Time Entries +
+
+
+ View Report
+
+
+
+ {% if entries %}
+
+
+
+
+
+
+
+
+ {% if pagination.pages > 1 %}
+
+ {% endif %}
+ {% else %}
+
+ {% endif %}
+ | User | +Date | +Time | +Duration | +Notes | +Tags | +Billable | +Actions | +
|---|---|---|---|---|---|---|---|
| {{ entry.user.username }} | +{{ entry.start_utc.strftime('%Y-%m-%d') }} | ++ {{ entry.start_utc.strftime('%H:%M') }} - + {% if entry.end_utc %} + {{ entry.end_utc.strftime('%H:%M') }} + {% else %} + Running + {% endif %} + | ++ {{ entry.duration_formatted }} + | ++ {% if entry.notes %} + {{ entry.notes[:50] }}{% if entry.notes|length > 50 %}...{% endif %} + {% else %} + - + {% endif %} + | ++ {% if entry.tag_list %} + {% for tag in entry.tag_list %} + {{ tag }} + {% endfor %} + {% else %} + - + {% endif %} + | ++ {% if entry.billable %} + Yes + {% else %} + No + {% endif %} + | +
+
+
+
+
+ {% if current_user.is_admin or entry.user_id == current_user.id %}
+
+ {% endif %}
+
+ |
+
+
+
+
+{% endblock %}
diff --git a/templates/reports/index.html b/templates/reports/index.html
new file mode 100644
index 0000000..98080d7
--- /dev/null
+++ b/templates/reports/index.html
@@ -0,0 +1,204 @@
+{% extends "base.html" %}
+
+{% block title %}Reports - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+{% endblock %}
diff --git a/templates/reports/project_report.html b/templates/reports/project_report.html
new file mode 100644
index 0000000..0684765
--- /dev/null
+++ b/templates/reports/project_report.html
@@ -0,0 +1,311 @@
+{% extends "base.html" %}
+
+{% block title %}Project Report - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+ + Reports +
+
+
+ Export CSV
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {{ "%.1f"|format(summary.total_hours) }}h
+Total Hours
+
+
+
+
+
+
+
+ {{ "%.1f"|format(summary.billable_hours) }}h
+Billable Hours
+
+
+
+
+
+
+
+ {{ summary.active_projects }}
+Active Projects
+
+
+
+
+
+
+
+ {{ summary.total_users }}
+Users
+
+
+
+
+
+
+
+
+
+
+
+ + Project Reports +
+
+
+ Generate detailed reports by project with time breakdowns and user statistics.
+ +
+
+
+
+
+
+
+ + User Reports +
+
+
+ View time tracking statistics by user with project breakdowns and productivity metrics.
+
+
+ User Report
+
+
+
+
+
+
+
+
+
+ + Summary Report +
+
+
+ Get an overview of key metrics including total hours, billable amounts, and trends.
+ +
+
+
+
+
+
+ + Data Export +
+
+
+ Export time entries to CSV format for external analysis or backup purposes.
+
+
+ Export CSV
+
+
+
+
+
+
+
+
+
+
+ + Recent Activity +
+
+ {% if recent_entries %}
+
+
+
+
+
+
+ {% else %}
+ | User | +Project | +Date | +Duration | +Notes | +Billable | +
|---|---|---|---|---|---|
| {{ entry.user.username }} | ++ + {{ entry.project.name }} + + | +{{ entry.start_utc.strftime('%Y-%m-%d') }} | ++ {{ entry.duration_formatted }} + | ++ {% if entry.notes %} + {{ entry.notes[:50] }}{% if entry.notes|length > 50 %}...{% endif %} + {% else %} + - + {% endif %} + | ++ {% if entry.billable %} + Yes + {% else %} + No + {% endif %} + | +
+
+
+ {% endif %}
+ No Recent Activity
+No time entries have been recorded recently.
+
+
+{% endblock %}
diff --git a/templates/reports/summary.html b/templates/reports/summary.html
new file mode 100644
index 0000000..804ad29
--- /dev/null
+++ b/templates/reports/summary.html
@@ -0,0 +1,105 @@
+{% extends "base.html" %}
+
+{% block title %}Summary Report - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+
+
+ + Project Report +
+
+
+ Export CSV
+
+
+
+
+
+
+
+
+
+
+
+
+ + Filters +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {{ "%.1f"|format(summary.total_hours) }}h
+Total Hours
+
+
+
+
+
+
+
+ {{ "%.1f"|format(summary.billable_hours) }}h
+Billable Hours
+
+
+
+
+
+
+
+ {{ currency }} {{ "%.2f"|format(summary.total_billable_amount) }}
+Billable Amount
+
+
+
+
+
+
+
+ {{ summary.projects_count }}
+Projects
+
+
+
+
+ {% if entries %}
+
+
+
+
+
+
+ + Project Breakdown ({{ projects_data|length }}) +
+
+ {% if projects_data %}
+
+
+
+
+
+
+ {% else %}
+ | Project | +Client | +Total Hours | +Billable Hours | +Billable Amount | +Users | +Actions | +
|---|---|---|---|---|---|---|
|
+
+ {{ project.name }}
+ {% if project.description %}
+
+ {{ project.description[:50] }}{% if project.description|length > 50 %}...{% endif %} + {% endif %} + |
+ + {% if project.client %} + {{ project.client }} + {% else %} + - + {% endif %} + | ++ {{ "%.1f"|format(project.total_hours) }}h + | ++ {% if project.billable %} + {{ "%.1f"|format(project.billable_hours) }}h + {% else %} + - + {% endif %} + | ++ {% if project.billable and project.billable_amount > 0 %} + {{ currency }} {{ "%.2f"|format(project.billable_amount) }} + {% else %} + - + {% endif %} + | +
+
+ {% for user_total in project.user_totals %}
+
+ {{ user_total.username }}: {{ "%.1f"|format(user_total.hours) }}h
+
+ {% endfor %}
+
+ |
+ + + | +
+
+
+ {% endif %}
+ No Data Found
++ {% if request.args.get('start_date') or request.args.get('end_date') or request.args.get('project_id') or request.args.get('user_id') %} + Try adjusting your filters or + view all projects. + {% else %} + No time entries have been recorded yet. + {% endif %} +
+
+
+ {% endif %}
+
+
+
+
+
+
+ + Time Entries ({{ entries|length }}) +
+
+
+
+
+
+
+
+ | User | +Project | +Date | +Time | +Duration | +Notes | +Tags | +Billable | +
|---|---|---|---|---|---|---|---|
| {{ entry.user.username }} | ++ + {{ entry.project.name }} + + | +{{ entry.start_utc.strftime('%Y-%m-%d') }} | ++ {{ entry.start_utc.strftime('%H:%M') }} - + {% if entry.end_utc %} + {{ entry.end_utc.strftime('%H:%M') }} + {% else %} + Running + {% endif %} + | ++ {{ entry.duration_formatted }} + | ++ {% if entry.notes %} + {{ entry.notes[:50] }}{% if entry.notes|length > 50 %}...{% endif %} + {% else %} + - + {% endif %} + | ++ {% if entry.tag_list %} + {% for tag in entry.tag_list %} + {{ tag }} + {% endfor %} + {% else %} + - + {% endif %} + | ++ {% if entry.billable %} + Yes + {% else %} + No + {% endif %} + | +
+
+{% endblock %}
+
+
diff --git a/templates/reports/user_report.html b/templates/reports/user_report.html
new file mode 100644
index 0000000..3d86ac5
--- /dev/null
+++ b/templates/reports/user_report.html
@@ -0,0 +1,258 @@
+{% extends "base.html" %}
+
+{% block title %}User Report - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+
+
+ + Summary Report +
+
+
+
+
+
+
+
+
+
+
+
+ {{ "%.1f"|format(today_hours) }}h
+Today
+
+
+
+
+
+
+
+ {{ "%.1f"|format(week_hours) }}h
+Last 7 Days
+
+
+
+
+
+
+
+ {{ "%.1f"|format(month_hours) }}h
+Last 30 Days
+
+
+
+
+
+
+
+
+ + Top Projects ({{ project_stats|length }}) +
+
+ {% if project_stats %}
+
+
+
+
+
+
+ {% else %}
+ | Project | +Client | +Total Hours | +
|---|---|---|
| + + {{ item.project.name }} + + | +{{ item.project.client }} | +{{ "%.1f"|format(item.hours) }}h | +
+
+
+ {% endif %}
+ No Data Found
+No time entries available for the selected period.
+
+
+{% endblock %}
+
+
diff --git a/templates/timer/edit_timer.html b/templates/timer/edit_timer.html
new file mode 100644
index 0000000..a004ebb
--- /dev/null
+++ b/templates/timer/edit_timer.html
@@ -0,0 +1,92 @@
+{% extends "base.html" %}
+
+{% block title %}Edit Time Entry - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+
+
+ + User Report +
+
+
+ Export CSV
+
+
+
+
+
+
+
+
+
+
+
+
+ + Filters +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {{ "%.1f"|format(summary.total_hours) }}h
+Total Hours
+
+
+
+
+
+
+
+ {{ "%.1f"|format(summary.billable_hours) }}h
+Billable Hours
+
+
+
+
+
+
+
+ {{ summary.users_count }}
+Users
+
+
+
+
+
+
+
+ {{ summary.projects_count }}
+Projects
+
+
+
+
+ {% if entries %}
+
+
+
+
+
+
+ + User Breakdown ({{ user_totals|length }}) +
+
+ {% if user_totals %}
+
+
+
+
+
+
+ {% else %}
+ | User | +Total Hours | +Billable Hours | +
|---|---|---|
| {{ username }} | +{{ "%.1f"|format(totals.hours) }}h | ++ {% if totals.billable_hours > 0 %} + {{ "%.1f"|format(totals.billable_hours) }}h + {% else %} + - + {% endif %} + | +
+
+
+ {% endif %}
+ No Data Found
+Try adjusting your filters.
+
+
+ {% endif %}
+
+
+
+
+
+
+ + Time Entries ({{ entries|length }}) +
+
+
+
+
+
+
+
+ | User | +Project | +Date | +Time | +Duration | +Notes | +Tags | +Billable | +
|---|---|---|---|---|---|---|---|
| {{ entry.user.username }} | ++ + {{ entry.project.name }} + + | +{{ entry.start_utc.strftime('%Y-%m-%d') }} | ++ {{ entry.start_utc.strftime('%H:%M') }} - + {% if entry.end_utc %} + {{ entry.end_utc.strftime('%H:%M') }} + {% else %} + Running + {% endif %} + | ++ {{ entry.duration_formatted }} + | ++ {% if entry.notes %} + {{ entry.notes[:50] }}{% if entry.notes|length > 50 %}...{% endif %} + {% else %} + - + {% endif %} + | ++ {% if entry.tag_list %} + {% for tag in entry.tag_list %} + {{ tag }} + {% endfor %} + {% else %} + - + {% endif %} + | ++ {% if entry.billable %} + Yes + {% else %} + No + {% endif %} + | +
+
+{% endblock %}
+
+
diff --git a/templates/timer/manual_entry.html b/templates/timer/manual_entry.html
new file mode 100644
index 0000000..c25814f
--- /dev/null
+++ b/templates/timer/manual_entry.html
@@ -0,0 +1,105 @@
+{% extends "base.html" %}
+
+{% block title %}Log Time - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+ Edit Time Entry
+
+
+
+
+
+
+
+
+
+
+
+ Project: {{ timer.project.name }}
+
+
+
+
+ Start: {{ timer.start_utc.strftime('%Y-%m-%d %H:%M') }}
+
+
+
+
+ End:
+ {% if timer.end_utc %}
+ {{ timer.end_utc.strftime('%Y-%m-%d %H:%M') }}
+ {% else %}
+ Running
+ {% endif %}
+
+
+ Duration: {{ timer.duration_formatted }}
+ {% if timer.source == 'manual' %}
+ Manual
+ {% else %}
+ Automatic
+ {% endif %}
+
+
+
+{% endblock %}
+
+
diff --git a/templates/timer/timer.html b/templates/timer/timer.html
new file mode 100644
index 0000000..8650dc6
--- /dev/null
+++ b/templates/timer/timer.html
@@ -0,0 +1,682 @@
+{% extends "base.html" %}
+
+{% block title %}Timer - {{ app_name }}{% endblock %}
+
+{% block content %}
+
+
+
+
+
+
+
+
+
+ Log Time Manually
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + Timer +
+Track your time with precision
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ No Active Timer
+Start a timer to begin tracking your time effectively.
+ +
+
+
+
+
+
+
+
+ + Recent Time Entries +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+{% endblock %}
+
+{% block scripts %}
+
+{% endblock %}
diff --git a/tests/test_basic.py b/tests/test_basic.py
new file mode 100644
index 0000000..70d6a5b
--- /dev/null
+++ b/tests/test_basic.py
@@ -0,0 +1,233 @@
+import pytest
+from app import create_app, db
+from app.models import User, Project, TimeEntry, Settings
+from datetime import datetime, timedelta
+
+@pytest.fixture
+def app():
+ """Create application for testing"""
+ app = create_app({
+ 'TESTING': True,
+ 'SQLALCHEMY_DATABASE_URI': 'sqlite:///:memory:',
+ 'WTF_CSRF_ENABLED': False,
+ 'SECRET_KEY': 'test-secret-key'
+ })
+
+ with app.app_context():
+ db.create_all()
+ yield app
+ db.drop_all()
+
+@pytest.fixture
+def client(app):
+ """Create test client"""
+ return app.test_client()
+
+@pytest.fixture
+def runner(app):
+ """Create test CLI runner"""
+ return app.test_cli_runner()
+
+@pytest.fixture
+def user(app):
+ """Create a test user"""
+ user = User(username='testuser', role='user')
+ db.session.add(user)
+ db.session.commit()
+ return user
+
+@pytest.fixture
+def admin_user(app):
+ """Create a test admin user"""
+ admin = User(username='admin', role='admin')
+ db.session.add(admin)
+ db.session.commit()
+ return admin
+
+@pytest.fixture
+def project(app):
+ """Create a test project"""
+ project = Project(
+ name='Test Project',
+ client='Test Client',
+ description='Test project description',
+ billable=True,
+ hourly_rate=50.00
+ )
+ db.session.add(project)
+ db.session.commit()
+ return project
+
+def test_app_creation(app):
+ """Test that the app can be created"""
+ assert app is not None
+ assert app.config['TESTING'] is True
+
+def test_database_creation(app):
+ """Test that database tables can be created"""
+ with app.app_context():
+ # Check that tables exist
+ assert db.engine.dialect.has_table(db.engine, 'users')
+ assert db.engine.dialect.has_table(db.engine, 'projects')
+ assert db.engine.dialect.has_table(db.engine, 'time_entries')
+ assert db.engine.dialect.has_table(db.engine, 'settings')
+
+def test_user_creation(app):
+ """Test user creation"""
+ with app.app_context():
+ user = User(username='testuser', role='user')
+ db.session.add(user)
+ db.session.commit()
+
+ assert user.id is not None
+ assert user.username == 'testuser'
+ assert user.role == 'user'
+ assert user.is_admin is False
+
+def test_admin_user(app):
+ """Test admin user properties"""
+ with app.app_context():
+ admin = User(username='admin', role='admin')
+ db.session.add(admin)
+ db.session.commit()
+
+ assert admin.is_admin is True
+
+def test_project_creation(app):
+ """Test project creation"""
+ with app.app_context():
+ project = Project(
+ name='Test Project',
+ client='Test Client',
+ description='Test description',
+ billable=True,
+ hourly_rate=50.00
+ )
+ db.session.add(project)
+ db.session.commit()
+
+ assert project.id is not None
+ assert project.name == 'Test Project'
+ assert project.client == 'Test Client'
+ assert project.billable is True
+ assert float(project.hourly_rate) == 50.00
+
+def test_time_entry_creation(app, user, project):
+ """Test time entry creation"""
+ with app.app_context():
+ start_time = datetime.utcnow()
+ end_time = start_time + timedelta(hours=2)
+
+ entry = TimeEntry(
+ user_id=user.id,
+ project_id=project.id,
+ start_utc=start_time,
+ end_utc=end_time,
+ notes='Test entry',
+ tags='test,work',
+ source='manual'
+ )
+ db.session.add(entry)
+ db.session.commit()
+
+ assert entry.id is not None
+ assert entry.duration_hours == 2.0
+ assert entry.duration_formatted == '02:00:00'
+ assert entry.tag_list == ['test', 'work']
+
+def test_active_timer(app, user, project):
+ """Test active timer functionality"""
+ with app.app_context():
+ # Create active timer
+ timer = TimeEntry(
+ user_id=user.id,
+ project_id=project.id,
+ start_utc=datetime.utcnow(),
+ source='auto'
+ )
+ db.session.add(timer)
+ db.session.commit()
+
+ assert timer.is_active is True
+ assert timer.end_utc is None
+
+ # Stop timer
+ timer.stop_timer()
+ assert timer.is_active is False
+ assert timer.end_utc is not None
+ assert timer.duration_seconds > 0
+
+def test_user_active_timer_property(app, user, project):
+ """Test user active timer property"""
+ with app.app_context():
+ # No active timer initially
+ assert user.active_timer is None
+
+ # Create active timer
+ timer = TimeEntry(
+ user_id=user.id,
+ project_id=project.id,
+ start_utc=datetime.utcnow(),
+ source='auto'
+ )
+ db.session.add(timer)
+ db.session.commit()
+
+ # Check active timer
+ assert user.active_timer is not None
+ assert user.active_timer.id == timer.id
+
+def test_project_totals(app, user, project):
+ """Test project total calculations"""
+ with app.app_context():
+ # Create time entries
+ start_time = datetime.utcnow()
+ entry1 = TimeEntry(
+ user_id=user.id,
+ project_id=project.id,
+ start_utc=start_time,
+ end_utc=start_time + timedelta(hours=2),
+ source='manual'
+ )
+ entry2 = TimeEntry(
+ user_id=user.id,
+ project_id=project.id,
+ start_utc=start_time + timedelta(hours=3),
+ end_utc=start_time + timedelta(hours=5),
+ source='manual'
+ )
+ db.session.add_all([entry1, entry2])
+ db.session.commit()
+
+ # Check totals
+ assert project.total_hours == 4.0
+ assert project.total_billable_hours == 4.0
+ assert float(project.estimated_cost) == 200.00 # 4 hours * 50 EUR
+
+def test_settings_singleton(app):
+ """Test settings singleton pattern"""
+ with app.app_context():
+ # Get settings (should create if not exists)
+ settings1 = Settings.get_settings()
+ settings2 = Settings.get_settings()
+
+ assert settings1.id == settings2.id
+ assert settings1 is settings2
+
+def test_health_check(client):
+ """Test health check endpoint"""
+ response = client.get('/_health')
+ assert response.status_code == 200
+ data = response.get_json()
+ assert data['status'] == 'healthy'
+
+def test_login_page(client):
+ """Test login page accessibility"""
+ response = client.get('/login')
+ assert response.status_code == 200
+
+def test_protected_route_redirect(client):
+ """Test that protected routes redirect to login"""
+ response = client.get('/dashboard', follow_redirects=False)
+ assert response.status_code == 302
+ assert '/login' in response.location
+
+
+