mirror of https://github.com/DRYTRIX/TimeTracker.git synced 2025-12-30 15:49:44 -06:00

Files

Dries Peeters 3e100ac4a0 fix(ci): use lowercase image names for Docker registry compatibility

Changes:

- Add step to convert image names to lowercase in CD workflow

- Update docker-compose.production.yml generation to use lowercase image names

- Enhance production deployment with nginx reverse proxy and certgen service

- Update CSRF configuration documentation with IP access guidance

- Improve deployment manifest generation with better service orchestration

2025-11-29 09:25:39 +01:00

31 KiB

Raw Blame History

TimeTracker - Complete Features Documentation

Version: 4.1.0
Last Updated: 2025-01-27

Overview
Time Tracking Features
Project Management
Task Management
Client Management
CRM Features
Invoicing & Billing
Financial Management
Reporting & Analytics
User Management & Security
Productivity Features
User Experience & Interface Enhancements 🆕
Administration
Integration & API
Technical Features

Overview

TimeTracker is a comprehensive, self-hosted time tracking and project management application designed for freelancers, teams, and businesses. This document provides a complete overview of all available features.

Time Tracking Features

Core Time Tracking

1. One-Click Timers

Start tracking time with a single click
Quick timer start from dashboard, projects, or tasks
Visual timer display with running time
Multiple timer support (configurable)

2. Persistent Timers

Server-side timer persistence
Timers continue running after browser closes
Automatic timer recovery on login
Cross-device synchronization

3. Manual Time Entry

Add historical time entries
Flexible date/time selection
Notes and tags support
Billable/non-billable flagging
Project and task association

4. Timer Management

Start, stop, pause, and resume timers
Edit active timers
Delete timers
Timer history and audit trail
Timer duplication for recurring work

5. Idle Detection

Automatic pause after configurable idle time
Configurable idle timeout (default: 30 minutes)
User notification on idle detection
Manual resume after idle pause

Advanced Time Tracking

6. Bulk Time Entry

Create multiple time entries at once
Consecutive day entry with weekend skipping
Batch project/task assignment
Bulk notes and tags application
Date range selection

7. Time Entry Templates

Save common time entries as templates
Quick template application
Template categories and organization
One-click timer start from templates
Template editing and management

8. Time Entry Duplication

Duplicate existing time entries
Quick copy with date adjustment
Preserve notes, tags, and project associations
Batch duplication support

9. Time Rounding

Configurable rounding intervals (1, 5, 15 minutes)
Per-project rounding rules
Automatic rounding on entry save
Rounding preference settings

10. Calendar View

Visual calendar interface for time entries
Month, week, and day views
Drag-and-drop time entry editing
Calendar event creation
Agenda view with upcoming deadlines

11. Focus Sessions (Pomodoro)

Pomodoro-style focus session tracking
Configurable session lengths
Break tracking (short and long breaks)
Cycle completion tracking
Interruption logging
Session notes and outcomes

12. Recurring Time Blocks

Weekly recurring time block templates
Weekday selection (Mon-Sun)
Time window definition (start/end times)
Automatic time entry generation
Active/inactive block management
Date range activation windows

13. Real-time Updates

WebSocket support for live updates
Cross-device timer synchronization
Real-time dashboard updates
Live collaboration features

Project Management

Core Project Features

14. Project Creation & Management

Unlimited projects
Project name, description, and status
Client association
Project archiving and activation
Project deletion (soft delete)

15. Project Details

Project dashboard with overview
Time tracking summary
Budget tracking
Task list integration
Team member assignments
Project notes and documentation

16. Project Status Management

Active/Archived/Inactive status
Status change history
Bulk status updates
Status-based filtering

17. Project Budgeting

Budget amount setting
Budget consumption tracking
Budget alerts and notifications
Burn rate calculation
Budget vs actual reporting
Budget forecasting

18. Project Costs

Track direct project expenses
Cost categories and descriptions
Cost date tracking
Cost amount and currency
Cost reporting and analytics
Integration with budget tracking

19. Extra Goods & Services

Add non-time-based line items to projects
Product/service catalog
Quantity and pricing
Integration with invoicing
Goods management per project

20. Project Favorites

Mark projects as favorites
Quick access to favorite projects
Favorite project dashboard widget
Personal project organization

21. Project Export

CSV export of project data
Time entry export per project
Project report generation
Bulk export capabilities

22. Project Dashboard

Visual project overview
Time tracking charts
Budget status indicators
Task completion metrics
Team activity feed
Recent time entries

Task Management

Core Task Features

23. Task Creation & Management

Unlimited tasks per project
Task name, description, and status
Task priority levels (Low, Medium, High, Urgent)
Task assignment to users
Task due dates and deadlines
Task tags and categorization

24. Task Status Tracking

Customizable status workflow
Status-based filtering
Bulk status updates
Status change history
Task completion tracking

25. Task Priorities

Priority level assignment
Priority-based sorting
Priority filtering
Bulk priority updates
Visual priority indicators

26. Task Assignment

Assign tasks to team members
Multiple assignee support
Assignment notifications
"My Tasks" view
Overdue tasks tracking

27. Task Comments

Threaded comments on tasks
Comment editing and deletion
@mention support
Comment notifications
Activity feed integration

28. Kanban Board

Visual drag-and-drop task management
Customizable columns
Column reordering
Task movement between columns
Column status mapping
Board filtering and search
Auto-refresh functionality

29. Task Board View

List view of tasks
Table view with sorting
Card view for visual management
Task grouping options
Customizable columns

30. Task Filtering & Search

Filter by project, status, priority, assignee
Date range filtering
Tag-based filtering
Full-text search
Saved filters

31. Task Export

CSV export of tasks
Filtered export support
Task detail export
Bulk export capabilities

32. Task Activity Tracking

Automatic activity logging
Status change tracking
Assignment changes
Comment activity
Activity feed per task

33. Bulk Task Operations

Bulk delete tasks
Bulk status updates
Bulk priority changes
Bulk assignment
Bulk project move
Multi-select task operations

Client Management

Core Client Features

34. Client Creation & Management

Unlimited clients
Client name, company, and contact information
Client address and billing details
Client status (Active/Inactive)
Client archiving

35. Client Details

Client dashboard
Associated projects list
Total time tracked
Total revenue
Invoice history
Payment history

36. Client Notes

Internal notes about clients
Note creation and editing
Note history
Private notes (admin only)
Note search and filtering

37. Client Billing Rates

Per-client hourly rates
Rate override per project
Rate history tracking
Multi-currency support
Rate-based invoicing

38. Client Prepaid Consumption

Track prepaid hours/credits
Automatic deduction from prepaid balance
Prepaid balance reporting
Prepaid expiration tracking

39. Client Export

CSV export of client data
Client report generation
Associated data export

CRM Features

Contact Management

40. Multiple Contacts per Client

Unlimited contacts per client
Contact information (name, email, phone, mobile)
Contact title and department
Contact roles (primary, billing, technical, contact)
Primary contact designation
Contact tags and notes
Contact status (active/inactive)

41. Contact Communication History

Track all communications with contacts
Communication types (email, call, meeting, note, message)
Communication direction (inbound, outbound)
Communication dates and follow-up dates
Link communications to projects, quotes, deals
Communication status tracking
Full communication history per contact

Sales Pipeline Management

42. Deal/Opportunity Tracking

Create and manage sales deals
Deal stages (prospecting, qualification, proposal, negotiation, closed_won, closed_lost)
Deal value and currency
Win probability (0-100%)
Expected close date
Weighted value calculation (value × probability)
Deal status (open, won, lost, cancelled)
Loss reason tracking

43. Visual Pipeline View

Kanban-style pipeline visualization
Deal cards by stage
Drag-and-drop deal movement (future enhancement)
Pipeline filtering by owner
Deal count per stage
Quick deal details

44. Deal Activities

Track activities on deals
Activity types (call, email, meeting, note, stage_change, status_change)
Activity dates and due dates
Activity status (completed, pending, cancelled)
Activity history per deal

45. Deal Relationships

Link deals to clients
Link deals to contacts
Link deals to leads
Link deals to quotes
Link deals to projects
Deal owner assignment

Lead Management

46. Lead Capture & Management

Create and manage leads
Lead information (name, company, email, phone)
Lead title and source tracking
Lead status (new, contacted, qualified, converted, lost)
Lead scoring (0-100)
Estimated value
Lead tags and notes

47. Lead Conversion

Convert leads to clients
Convert leads to deals
Automatic contact creation from lead
Conversion tracking
Conversion date and user
Lead conversion history

48. Lead Activities

Track activities on leads
Activity types (call, email, meeting, note, status_change, score_change)
Activity dates and due dates
Activity status tracking
Activity history per lead

49. Lead Scoring

Manual lead scoring (0-100)
Score-based filtering
Score-based sorting
Visual score indicators
Score history tracking

Invoicing & Billing

Core Invoicing Features

50. Invoice Creation

Generate invoices from time entries
Manual invoice creation
Invoice templates
Custom line items
Multiple invoice formats

51. Invoice Management

Invoice list view with filtering
Invoice status tracking (Draft, Sent, Paid, Overdue, Cancelled)
Invoice editing
Invoice duplication
Invoice deletion
Bulk invoice operations

42. Invoice Items

Time entry line items
Expense line items
Custom line items
Item descriptions and quantities
Unit prices and totals
Tax calculation per item

43. Invoice Generation from Time

Select time entries for invoicing
Automatic time entry grouping
Billable hours calculation
Rate application
Time entry filtering

44. Invoice Templates

Customizable invoice templates
Template selection per invoice
Template editing
Default template setting
Template preview

45. PDF Invoice Export

Professional PDF generation
Customizable PDF layout
Company branding (logo)
PDF template editor
PDF preview
PDF download

46. Invoice Status Management

Status workflow (Draft → Sent → Paid)
Status change tracking
Overdue invoice detection
Bulk status updates
Status-based filtering

47. Tax Calculation

Automatic tax calculation
Multiple tax rates
Tax rules per client/project
Tax inclusion/exclusion
Tax reporting

48. Multi-Currency Support

Multiple currency support
Currency selection per invoice
Exchange rate tracking
Currency conversion
Multi-currency reporting

49. Recurring Invoices

Recurring invoice templates
Weekly, monthly, quarterly, yearly recurrence
Automatic invoice generation
Recurring invoice management
Next generation date tracking

50. Invoice Email

Email invoice to clients
Email template customization
Email delivery tracking
Email history
Automated email sending

51. Invoice Numbering

Automatic invoice numbering
Custom numbering format
Number sequence management
Number prefix/suffix

52. Invoice Export

CSV export of invoices
Excel export
PDF export
Bulk export
Filtered export

Financial Management

Expense Tracking

53. Expense Recording

Track business expenses
Expense amount and currency
Expense date tracking
Vendor information
Receipt attachment
Expense categories

54. Expense Categories

Customizable expense categories
Category management
Category-based reporting
Category filtering

55. Expense Approval Workflow

Multi-stage approval process
Approval status tracking
Admin approval required
Approval notifications
Approval history

56. Expense Reimbursement

Track reimbursement status
Reimbursement amount tracking
Reimbursement date
Reimbursement method
Reimbursement reporting

57. Billable Expenses

Mark expenses as billable
Add billable expenses to invoices
Expense markup
Expense-to-invoice integration

58. Expense Filtering & Search

Filter by category, status, date range
Vendor search
Amount range filtering
Billable/non-billable filter
Receipt status filter

59. Expense Export

CSV export of expenses
Expense report generation
Category-based export

Payment Tracking

60. Payment Recording

Record payments against invoices
Payment amount and currency
Payment date tracking
Payment method tracking
Payment reference numbers

61. Payment Methods

Bank transfer
Cash
Check
Credit card
Debit card
PayPal
Stripe
Wire transfer
Other methods

62. Payment Status

Payment status tracking (Completed, Pending, Failed, Refunded)
Partial payment support
Payment history per invoice
Outstanding amount calculation

63. Payment Gateway Integration

Gateway transaction ID tracking
Gateway fee recording
Net amount calculation
Gateway-specific fields

64. Payment Statistics

Payment summary statistics
Payment method breakdown
Payment status analytics
Monthly payment trends
Payment reporting

Additional Financial Features

65. Mileage Tracking

Track business mileage
Mileage rate calculation
Mileage reimbursement
Mileage reporting

66. Per Diem Tracking

Per diem rate management
Per diem expense tracking
Per diem reporting
Rate configuration

Reporting & Analytics

Core Reporting Features

67. Time Reports

Time entry reports by project, user, date range
Billable vs non-billable breakdown
Time summary reports
Detailed time reports
Custom date ranges

68. Project Reports

Project time summary
Project budget reports
Project cost reports
Project profitability analysis
Project completion metrics

69. User Reports

Individual user time reports
User productivity metrics
User activity reports
User performance comparison
User time goals tracking

70. Invoice Reports

Invoice summary reports
Payment reports
Outstanding invoice reports
Revenue reports
Invoice status reports

71. Expense Reports

Expense summary by category
Expense trends
Reimbursement reports
Billable expense reports

72. Saved Filters

Save frequently used report filters
Quick filter application
Filter sharing (admin)
Filter management

73. Report Export

CSV export of reports
Excel export
PDF report generation
Scheduled report emails

Analytics Dashboard

74. Visual Dashboards

Charts and graphs for insights
Time tracking visualizations
Revenue charts
Project status overview
User activity metrics

75. Hours Analytics

Hours by day, week, month
Hours by project
Hours by user
Hours by hour of day
Billable vs non-billable charts

76. Revenue Analytics

Revenue trends over time
Revenue by project
Revenue by client
Payment analytics
Revenue vs payments comparison

77. Project Analytics

Project efficiency metrics
Budget consumption trends
Burn rate analysis
Completion estimates
Resource allocation analysis

78. Task Analytics

Task completion rates
Task duration analysis
Task priority distribution
Task assignment metrics
Task status trends

79. Overtime Tracking

Overtime hour calculation
Overtime reporting
Overtime trends
Overtime alerts

80. Weekly Trends

Weekly time trends
Week-over-week comparison
Weekly goal tracking
Weekly summary reports

81. Budget Alerts & Forecasting

Budget consumption monitoring
Budget threshold alerts (80%, 100%)
Over-budget alerts
Burn rate calculation
Completion date estimation
Cost trend analysis
Resource allocation breakdown

82. Weekly Time Goals

Set weekly hour targets
Track progress against goals
Goal status management (Active, Completed, Failed, Cancelled)
Goal statistics and success rate
Daily breakdown of goal progress
Streak tracking

User Management & Security

User Management

83. User Accounts

User creation and management
Username-based authentication
User profiles with avatars
User roles and permissions
User activation/deactivation
User deletion

84. Profile Management

User profile editing
Avatar upload
Profile picture management
Personal settings
Timezone preferences
Language preferences

85. Role-Based Access Control (RBAC)

Granular permission system
Custom roles creation
Role assignment to users
Permission categories
System roles (Super Admin, Admin, Manager, User, Viewer)
Permission checking in code and templates

86. Authentication Methods

Username-only authentication
OIDC/SSO support (Azure AD, Authelia, etc.)
Session management
Secure cookie handling
Session timeout configuration

87. API Tokens

Generate API tokens for integrations
Token scopes and permissions
Token expiration
Token management
Token security

88. User Preferences

Timezone settings
Date format preferences
Time format preferences
Currency preferences
Language selection
Notification preferences

Productivity Features

89. Command Palette

Keyboard-driven navigation (press ?)
Quick action execution
Search across all features
Command shortcuts
Context-aware commands

90. Keyboard Shortcuts

Global shortcuts (Ctrl+K for search, Ctrl+/ for command palette)
Navigation shortcuts (g d for dashboard, g p for projects)
Action shortcuts (c p for create project, t s for start timer)
Table shortcuts (Ctrl+A for select all, Delete for delete)
Editing shortcuts (Ctrl+S for save, Escape for close)
Customizable shortcuts

91. Quick Search

Fast search across projects, tasks, clients
Search suggestions
Recent searches
Search filters
Keyboard shortcut: Ctrl+K

92. Activity Feed

Recent activity tracking
Activity by user, project, task
Activity filtering
Activity notifications
Activity history

Notifications

93. Email Notifications

Configurable email alerts
Task assignment notifications
Invoice notifications
Deadline reminders
Weekly summaries

94. Toast Notifications

In-app notifications
Success/error messages
Action confirmations
Real-time updates
Notification history

95. Weekly Summaries

Optional weekly time tracking summaries
Email delivery
Summary customization
Summary scheduling

User Experience & Interface Enhancements

Enhanced Data Tables

96. Enterprise-Grade Tables

Sortable columns (click headers to sort)
Bulk selection with checkboxes
Column resizing (drag column borders)
Inline editing (double-click cells)
Bulk actions bar (appears when items selected)
Export to CSV functionality
Column visibility toggle
Row highlighting on hover
Responsive table layout (card view on mobile)

97. Enhanced Search Experience

Instant search with autocomplete
Recent searches tracking
Categorized search results
Search suggestions
Live search with debouncing
Search filter badges
Quick filter presets
Keyboard shortcut: Ctrl+K

Data Visualization

98. Interactive Charts

Chart.js integration
6 chart types (line, bar, doughnut, progress, sparkline, stacked)
Responsive charts
Export charts as images
Custom color schemes
Animation support
Data-driven visualizations
Chart customization options

Design System

99. Unified Component Library

20+ reusable UI components
Consistent design tokens
Standardized buttons, cards, badges
Page headers with breadcrumbs
Empty states with guidance
Loading skeleton components
Alert and notification components
Modal and dialog components

100. Form UX Enhancements

Auto-save with indicators
Form state persistence
Inline validation
Smart defaults
Keyboard shortcuts (Cmd+Enter)
Loading states
Error handling with helpful messages

Context-aware breadcrumb trails
Quick navigation to parent pages
Integrated in page headers
Responsive breadcrumb layout

102. Recently Viewed & Favorites

Recently viewed items tracking
Favorites system for quick access
Quick access dropdowns
LocalStorage persistence
Cross-session persistence

User Feedback & Guidance

103. Enhanced Empty States

Beautiful, actionable empty states
Context-specific guidance
Quick action buttons
Helpful illustrations
Call-to-action messages

104. Loading States

Skeleton loading components
Progress indicators
Loading animations
Context-aware loading states
Non-blocking loading feedback

105. Interactive Onboarding

Step-by-step product tours
Interactive tutorials
Element highlighting
Skip/back/next navigation
Progress indicators
Auto-start for new users

Progressive Web App (PWA)

106. PWA Capabilities

Install as mobile app
Offline support
Background sync for time entries
App shortcuts (4 shortcuts)
Push notification support (ready)
Share target integration
Service worker caching

Accessibility

107. Accessibility Features

WCAG 2.1 AA compliant
Full keyboard navigation
Screen reader support
ARIA labels and roles
Focus management
Reduced motion support
High contrast mode
Semantic HTML structure

Administration

System Administration

108. Admin Dashboard

System overview
User management
System settings
Health monitoring
Quick statistics

109. System Settings

Application configuration
Timer settings (idle timeout, rounding)
User management settings
Security settings
Email configuration
Telemetry settings

110. User Management

Create, edit, delete users
User role assignment
User activation/deactivation
User permission management
User activity monitoring

111. Backup & Restore

Manual backup creation
Scheduled backups
Backup download
Backup restoration
Backup management

112. Logo & Branding

Company logo upload
Logo management
Logo removal
Logo in PDF invoices
Logo in email templates

113. PDF Layout Customization

Customizable PDF invoice layout
PDF template editor
Layout preview
Default layout setting
Layout reset

114. Email Configuration

SMTP server configuration
Email template management
Email sending test
Email delivery status
Email template editing

115. Telemetry Management

Telemetry enable/disable
Telemetry data viewing
Privacy settings
Analytics configuration

116. Audit Logs

System activity logging
User action tracking
Entity change history
Audit log filtering
Audit log export

117. OIDC/SSO Configuration

OIDC provider setup
SSO configuration
User mapping
OIDC debugging
SSO testing

Integration & API

REST API

118. REST API v1

Comprehensive REST API
Token-based authentication
JSON request/response
Pagination support
Error handling

119. API Endpoints

Projects API (CRUD)
Time Entries API (CRUD)
Tasks API (CRUD)
Clients API (CRUD)
Invoices API (CRUD)
Users API (read)
Reports API

120. API Authentication

API token generation
Bearer token authentication
API key header authentication
Token scopes
Token permissions

121. API Documentation

OpenAPI/Swagger specification
Interactive API docs
Endpoint documentation
Request/response examples
Authentication guide

Import/Export

122. Data Import

CSV import of time entries
Project import
Client import
Task import
Import validation
Import error handling

123. Data Export

CSV export of all data types
Excel export
PDF export
Bulk export
Filtered export
Scheduled exports

Technical Features

Deployment & Infrastructure

124. Docker Support

Docker Compose configuration
Multiple deployment profiles
Production-ready setup
Development setup
Local testing setup

125. Database Support

PostgreSQL for production
SQLite for testing/development
Database migrations (Alembic)
Migration management
Database backup/restore

126. HTTPS Support

Automatic HTTPS setup
Self-signed certificates
mkcert integration
Manual certificate setup
SSL/TLS configuration

127. Monitoring Stack

Prometheus metrics
Grafana dashboards
Loki log aggregation
Promtail log shipping
Health check endpoints

128. Internationalization (i18n)

Multiple language support
Translation system
Language switching
Locale-based formatting
Timezone handling

129. Progressive Web App (PWA)

Install as mobile app
Offline support
App manifest
Service worker
Mobile optimization

130. Responsive Design

Mobile-friendly interface
Tablet optimization
Desktop experience
Touch-friendly controls
Adaptive layouts

131. Real-time Features

WebSocket support
Live timer updates
Real-time notifications
Cross-device sync
Collaborative features

132. Performance

Database query optimization
Caching strategies
Lazy loading
Pagination
Efficient data loading

Feature Summary by Category

Time Tracking (13 features)

Timer management, manual entry, bulk entry, templates, calendar view, focus sessions, recurring blocks, idle detection, rounding, duplication, real-time updates

Project Management (9 features)

Project CRUD, budgeting, costs, extra goods, favorites, export, dashboard, status management

Task Management (11 features)

Task CRUD, Kanban board, comments, priorities, assignment, filtering, export, activity tracking, bulk operations

Client Management (6 features)

Client CRUD, notes, billing rates, prepaid consumption, export

CRM Features (10 features)

Multiple contacts per client, communication history, deal tracking, pipeline view, deal activities, lead management, lead conversion, lead activities, lead scoring

Invoicing (13 features)

Invoice creation, templates, PDF export, status management, tax calculation, multi-currency, recurring invoices, email, numbering, export

Financial Management (14 features)

Expense tracking, categories, approval workflow, reimbursement, billable expenses, payment tracking, methods, gateway integration, statistics, mileage, per diem

Reporting & Analytics (16 features)

Time reports, project reports, user reports, invoice reports, expense reports, saved filters, dashboards, hours analytics, revenue analytics, project analytics, task analytics, overtime, weekly trends, budget alerts, forecasting, weekly goals

User Management & Security (6 features)

User accounts, profiles, RBAC, authentication, API tokens, preferences

Productivity (7 features)

Command palette, keyboard shortcuts, quick search, activity feed, email notifications, toast notifications, weekly summaries

User Experience & Interface (12 features)

Enterprise-grade tables, enhanced search, interactive charts, unified component library, form UX enhancements, breadcrumb navigation, recently viewed & favorites, enhanced empty states, loading states, interactive onboarding, PWA capabilities, accessibility features

Administration (10 features)

Admin dashboard, system settings, user management, backup/restore, logo/branding, PDF layout, email configuration, telemetry, audit logs, OIDC/SSO

Integration & API (6 features)

REST API, API endpoints, authentication, documentation, import, export

Technical (9 features)

Docker, database support, HTTPS, monitoring, i18n, PWA, responsive design, real-time, performance

Total Feature Count

140+ Features across 14 major categories

Getting Started with Features

For New Users

Start with Time Tracking - Learn to track your time
Create Projects - Organize your work
Set up Clients - Manage your relationships
Generate Invoices - Bill for your time
Explore Reports - Understand your productivity

For Teams

Set up User Management - Add team members
Configure Permissions - Control access
Use Task Management - Assign and track work
Monitor Analytics - Track team performance
Set Budget Alerts - Manage project budgets

For Administrators

Configure System Settings - Customize the application
Set up Email - Enable notifications
Configure Backups - Protect your data
Set up HTTPS - Secure your installation
Enable Monitoring - Track system health

Note: This document is maintained to reflect all current features. For the most up-to-date feature list, refer to the main README.md and individual feature documentation files.

31 KiB Raw Blame History Unescape Escape