mirror of
https://github.com/DRYTRIX/TimeTracker.git
synced 2026-01-14 07:50:18 -06:00
7486037307
- UI/UX: Refine layouts and responsive styles; fix task and timer views; update
shared components and dashboard templates
- Updates across `app/templates/**`, `templates/**`, `app/static/base.css`,
and `app/static/mobile.css`
- Backend: Route cleanups and minor fixes for admin, auth, invoices, and timer
- Touches `app/routes/admin.py`, `app/routes/auth.py`, `app/routes/api.py`,
`app/routes/invoices.py`, `app/routes/timer.py`
- DevOps: Improve Docker setup and add local testing workflow
- Update `Dockerfile`, `docker/start-fixed.py`
- Add `docker-compose.local-test.yml`, `.env.local-test`, start scripts
- Docs: Update `README.md` and add `docs/LOCAL_TESTING_WITH_SQLITE.md`
- Utilities: Adjust CLI and PDF generator behavior
Database (Alembic) migrations:
- 005_add_missing_columns.py
- 006_add_logo_and_task_timestamps.py
- 007_add_invoice_and_more_settings_columns.py
- 008_align_invoices_and_settings_more.py
- 009_add_invoice_created_by.py
- 010_enforce_single_active_timer.py
BREAKING CHANGE: Only one active timer per user is now enforced.
Note: Apply database migrations after deploy (e.g., `alembic upgrade head`).
TimeTracker Documentation
Welcome to the TimeTracker documentation. This directory contains comprehensive documentation for all aspects of the application.
📚 Documentation Index
🚀 Getting Started
- README.md - Main project overview and quick start guide
- REQUIREMENTS.md - System requirements and dependencies
- PROJECT_STRUCTURE.md - Detailed project architecture
🐳 Docker & Deployment
- DOCKER_PUBLIC_SETUP.md - Public Docker deployment guide
- DOCKER_STARTUP_TROUBLESHOOTING.md - Docker troubleshooting
- SOLUTION_GUIDE.md - Common problems and solutions
- GITHUB_WORKFLOW_IMAGES.md - Images built on releases and main
🔧 Features
- TASK_MANAGEMENT.md - Task management system overview
- TASK_MANAGEMENT_README.md - Detailed task management guide
- CLIENT_MANAGEMENT_README.md - Client model and relationships
- INVOICE_FEATURE_README.md - Invoice system documentation
- ENHANCED_INVOICE_SYSTEM_README.md - Advanced invoice features
- INVOICE_INTERFACE_IMPROVEMENTS.md - Invoice UI improvements
- Analytics and reporting features (see the Reports section in the app)
- MOBILE_IMPROVEMENTS.md - Mobile interface enhancements
🛠️ Technical Details
- LOGO_UPLOAD_SYSTEM_README.md - Logo upload functionality
- LOGO_UPLOAD_IMPLEMENTATION_SUMMARY.md - Logo system implementation
- PDF_GENERATION_TROUBLESHOOTING.md - PDF generation issues and fixes
📋 Project Guidelines
- CODE_OF_CONDUCT.md - Community guidelines
- CONTRIBUTING.md - How to contribute to the project
- GITHUB_WORKFLOW_IMAGES.md - GitHub workflow documentation
🔍 Quick Navigation
For New Users
- Start with the main README.md
- Check REQUIREMENTS.md for system requirements
- Review PROJECT_STRUCTURE.md for architecture overview
For Developers
- Read CONTRIBUTING.md for contribution guidelines
- Review feature-specific documentation for areas you're working on
- Check SOLUTION_GUIDE.md for common issues
For Deployment
- Review DOCKER_PUBLIC_SETUP.md for Docker deployment
- Check DOCKER_STARTUP_TROUBLESHOOTING.md if you encounter issues
- See SOLUTION_GUIDE.md for deployment solutions
📝 Documentation Structure
All documentation files are organized by category and purpose:
- Feature Documentation: Explains specific application features
- Technical Guides: Implementation details and technical information
- Deployment Guides: Setup and deployment instructions
- Troubleshooting: Common issues and their solutions
- Project Guidelines: Community and contribution guidelines
🤝 Contributing to Documentation
If you find errors or want to improve the documentation:
- Check the CONTRIBUTING.md guidelines
- Make your changes
- Submit a pull request
Good documentation helps everyone use and contribute to the project effectively!