mirror of
https://github.com/DRYTRIX/TimeTracker.git
synced 2026-05-19 04:40:32 -05:00
7ae7de12d2
Replace the single-page setup (telemetry + optional Google Calendar) with a guided wizard that collects all base settings before completion. Wizard steps: 1. Welcome - intro and Next 2. Region & time - timezone, date/time format, currency (Settings) 3. Company - name, address, email, optional phone/website (Settings) 4. System - allow self-registration, rounding minutes, single active timer, idle timeout (Settings) 5. Integrations (optional) - Google Calendar OAuth; can skip 6. Privacy & finish - telemetry opt-in; Complete Setup submits form Backend (app/routes/setup.py): - GET: pass settings and timezones to template for prefilling - POST: validate timezone, date_format, currency, rounding_minutes, idle_timeout_minutes; persist all fields to Settings and mark_setup_complete(telemetry_enabled) - Default timezone/currency to UTC/EUR when missing (keeps tests passing) Frontend: - initial_setup.html: 6 wizard steps, progress bar (Step X of 6), Back/Next and submit on last step - setup-wizard.js: step navigation, progress update, optional client-side validation for step 2 (timezone, currency required) Docs updated: TELEMETRY_QUICK_START.md, GETTING_STARTED.md, TELEMETRY_IMPLEMENTATION_SUMMARY.md.
Administrator Documentation
Complete guides for TimeTracker administrators.
📖 Quick Links
Configuration
- Docker Compose Setup - Docker deployment guide
- Docker Public Setup - Production deployment
- Docker Startup Troubleshooting - Fix startup issues
- Email Configuration - Email setup
- OIDC Setup - OIDC/SSO authentication setup
Deployment
- Version Management - Managing versions
- Release Process - Release workflow
- Official Builds - Official build information
Security
- See security/ for security documentation
Monitoring
- See monitoring/ for monitoring and analytics setup
🔧 Common Tasks
- Initial Setup: Start with Docker Compose Setup
- Configure Email: See Email Configuration
- Set Up OIDC/SSO: Follow OIDC Setup
- Monitor System: Check monitoring/ documentation
📚 Related Documentation
- Main Documentation Index - Complete documentation overview
- User Guides - User-facing guides