Squashed commit of the following:
commit 1eeea9f83ad9230a5c1f7a75662770eaab0df837 Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 21:15:41 2025 +0200 Disable resuming of old time entries. commit 3e3ec2f01cb7943622b819a19179388078ae1315 Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 20:59:19 2025 +0200 Refactor db migrations. commit 15a51a569da36c6b7c9e01ab17b6fdbdee6ad994 Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 19:58:04 2025 +0200 Apply new style for Time Tracking view. commit 77e5278b303e060d2b03853b06277f8aa567ae68 Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 18:06:04 2025 +0200 Allow direct registrations as a Company. commit 188a8772757cbef374243d3a5f29e4440ddecabe Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 18:04:45 2025 +0200 Add email invitation feature. commit d9ebaa02aa01b518960a20dccdd5a327d82f30c6 Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 17:12:32 2025 +0200 Apply common style for Company, User, Team management pages. commit 81149caf4d8fc6317e2ab1b4f022b32fc5aa6d22 Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 16:44:32 2025 +0200 Move export functions to own module. commit 1a26e19338e73f8849c671471dd15cc3c1b1fe82 Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 15:51:15 2025 +0200 Split up models.py. commit 61f1ccd10f721b0ff4dc1eccf30c7a1ee13f204d Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 12:05:28 2025 +0200 Move utility function into own modules. commit 84b341ed35e2c5387819a8b9f9d41eca900ae79f Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 11:44:24 2025 +0200 Refactor auth functions use. commit 923e311e3da5b26d85845c2832b73b7b17c48adb Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 11:35:52 2025 +0200 Refactor route nameing and fix bugs along the way. commit f0a5c4419c340e62a2615c60b2a9de28204d2995 Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 10:34:33 2025 +0200 Fix URL endpoints in announcement template. commit b74d74542a1c8dc350749e4788a9464d067a88b5 Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 09:25:53 2025 +0200 Move announcements to own module. commit 9563a28021ac46c82c04fe4649b394dbf96f92c7 Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 09:16:30 2025 +0200 Combine Company view and edit templates. commit 6687c373e681d54e4deab6b2582fed5cea9aadf6 Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 08:17:42 2025 +0200 Move Users, Company and System Administration to own modules. commit 8b7894a2e3eb84bb059f546648b6b9536fea724e Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 07:40:57 2025 +0200 Move Teams and Projects to own modules. commit d11bf059d99839ecf1f5d7020b8c8c8a2454c00b Author: Jens Luedicke <jens@luedicke.me> Date: Mon Jul 7 07:09:33 2025 +0200 Move Tasks and Sprints to own modules.
This commit is contained in:
176
SCHEMA_CHANGES_SUMMARY.md
Normal file
176
SCHEMA_CHANGES_SUMMARY.md
Normal file
@@ -0,0 +1,176 @@
|
||||
# Database Schema Changes Summary
|
||||
|
||||
This document summarizes all database schema changes between commit 4214e88 and the current state of the TimeTrack application.
|
||||
|
||||
## Architecture Changes
|
||||
|
||||
### 1. **Model Structure Refactoring**
|
||||
- **Before**: Single monolithic `models.py` file containing all models
|
||||
- **After**: Models split into domain-specific modules:
|
||||
- `models/__init__.py` - Package initialization
|
||||
- `models/base.py` - Base model definitions
|
||||
- `models/company.py` - Company-related models
|
||||
- `models/user.py` - User-related models
|
||||
- `models/project.py` - Project-related models
|
||||
- `models/task.py` - Task-related models
|
||||
- `models/time_entry.py` - Time entry model
|
||||
- `models/sprint.py` - Sprint model
|
||||
- `models/team.py` - Team model
|
||||
- `models/system.py` - System settings models
|
||||
- `models/announcement.py` - Announcement model
|
||||
- `models/dashboard.py` - Dashboard-related models
|
||||
- `models/work_config.py` - Work configuration model
|
||||
- `models/invitation.py` - Company invitation model
|
||||
- `models/enums.py` - All enum definitions
|
||||
|
||||
## New Tables Added
|
||||
|
||||
### 1. **company_invitation** (NEW)
|
||||
- Purpose: Email-based company registration invitations
|
||||
- Columns:
|
||||
- `id` (INTEGER, PRIMARY KEY)
|
||||
- `company_id` (INTEGER, FOREIGN KEY → company.id)
|
||||
- `email` (VARCHAR(120), NOT NULL)
|
||||
- `token` (VARCHAR(64), UNIQUE, NOT NULL)
|
||||
- `role` (VARCHAR(50), DEFAULT 'Team Member')
|
||||
- `invited_by_id` (INTEGER, FOREIGN KEY → user.id)
|
||||
- `created_at` (TIMESTAMP, DEFAULT CURRENT_TIMESTAMP)
|
||||
- `expires_at` (TIMESTAMP, NOT NULL)
|
||||
- `accepted` (BOOLEAN, DEFAULT FALSE)
|
||||
- `accepted_at` (TIMESTAMP)
|
||||
- `accepted_by_user_id` (INTEGER, FOREIGN KEY → user.id)
|
||||
- Indexes:
|
||||
- `idx_invitation_token` on token
|
||||
- `idx_invitation_email` on email
|
||||
- `idx_invitation_company` on company_id
|
||||
- `idx_invitation_expires` on expires_at
|
||||
|
||||
## Modified Tables
|
||||
|
||||
### 1. **company**
|
||||
- Added columns:
|
||||
- `updated_at` (TIMESTAMP, DEFAULT CURRENT_TIMESTAMP) - NEW
|
||||
|
||||
### 2. **user**
|
||||
- Added columns:
|
||||
- `two_factor_enabled` (BOOLEAN, DEFAULT FALSE) - NEW
|
||||
- `two_factor_secret` (VARCHAR(32), NULLABLE) - NEW
|
||||
- `avatar_url` (VARCHAR(255), NULLABLE) - NEW
|
||||
|
||||
### 3. **user_preferences**
|
||||
- Added columns:
|
||||
- `theme` (VARCHAR(20), DEFAULT 'light')
|
||||
- `language` (VARCHAR(10), DEFAULT 'en')
|
||||
- `timezone` (VARCHAR(50), DEFAULT 'UTC')
|
||||
- `date_format` (VARCHAR(20), DEFAULT 'YYYY-MM-DD')
|
||||
- `time_format` (VARCHAR(10), DEFAULT '24h')
|
||||
- `email_notifications` (BOOLEAN, DEFAULT TRUE)
|
||||
- `email_daily_summary` (BOOLEAN, DEFAULT FALSE)
|
||||
- `email_weekly_summary` (BOOLEAN, DEFAULT TRUE)
|
||||
- `default_project_id` (INTEGER, FOREIGN KEY → project.id)
|
||||
- `timer_reminder_enabled` (BOOLEAN, DEFAULT TRUE)
|
||||
- `timer_reminder_interval` (INTEGER, DEFAULT 60)
|
||||
- `dashboard_layout` (JSON, NULLABLE)
|
||||
|
||||
### 4. **user_dashboard**
|
||||
- Added columns:
|
||||
- `layout` (JSON, NULLABLE) - Alternative grid layout configuration
|
||||
- `is_locked` (BOOLEAN, DEFAULT FALSE) - Prevent accidental changes
|
||||
|
||||
### 5. **company_work_config**
|
||||
- Added columns:
|
||||
- `standard_hours_per_day` (FLOAT, DEFAULT 8.0)
|
||||
- `standard_hours_per_week` (FLOAT, DEFAULT 40.0)
|
||||
- `overtime_enabled` (BOOLEAN, DEFAULT TRUE)
|
||||
- `overtime_rate` (FLOAT, DEFAULT 1.5)
|
||||
- `double_time_enabled` (BOOLEAN, DEFAULT FALSE)
|
||||
- `double_time_threshold` (FLOAT, DEFAULT 12.0)
|
||||
- `double_time_rate` (FLOAT, DEFAULT 2.0)
|
||||
- `require_breaks` (BOOLEAN, DEFAULT TRUE)
|
||||
- `break_duration_minutes` (INTEGER, DEFAULT 30)
|
||||
- `break_after_hours` (FLOAT, DEFAULT 6.0)
|
||||
- `weekly_overtime_threshold` (FLOAT, DEFAULT 40.0)
|
||||
- `weekly_overtime_rate` (FLOAT, DEFAULT 1.5)
|
||||
|
||||
### 6. **company_settings**
|
||||
- Added columns:
|
||||
- `work_week_start` (INTEGER, DEFAULT 1)
|
||||
- `work_days` (VARCHAR(20), DEFAULT '1,2,3,4,5')
|
||||
- `allow_overlapping_entries` (BOOLEAN, DEFAULT FALSE)
|
||||
- `require_project_for_time_entry` (BOOLEAN, DEFAULT TRUE)
|
||||
- `allow_future_entries` (BOOLEAN, DEFAULT FALSE)
|
||||
- `max_hours_per_entry` (FLOAT, DEFAULT 24.0)
|
||||
- `enable_tasks` (BOOLEAN, DEFAULT TRUE)
|
||||
- `enable_sprints` (BOOLEAN, DEFAULT FALSE)
|
||||
- `enable_client_access` (BOOLEAN, DEFAULT FALSE)
|
||||
- `notify_on_overtime` (BOOLEAN, DEFAULT TRUE)
|
||||
- `overtime_threshold_daily` (FLOAT, DEFAULT 8.0)
|
||||
- `overtime_threshold_weekly` (FLOAT, DEFAULT 40.0)
|
||||
|
||||
### 7. **dashboard_widget**
|
||||
- Added columns:
|
||||
- `config` (JSON) - Widget-specific configuration
|
||||
- `is_visible` (BOOLEAN, DEFAULT TRUE)
|
||||
|
||||
## Enum Changes
|
||||
|
||||
### 1. **WorkRegion** enum
|
||||
- Added value:
|
||||
- `GERMANY = "Germany"` - NEW
|
||||
|
||||
### 2. **TaskStatus** enum
|
||||
- Added value:
|
||||
- `ARCHIVED = "Archived"` - NEW
|
||||
|
||||
### 3. **WidgetType** enum
|
||||
- Expanded with many new widget types:
|
||||
- Time Tracking: `CURRENT_TIMER`, `DAILY_SUMMARY`, `WEEKLY_CHART`, `BREAK_REMINDER`, `TIME_SUMMARY`
|
||||
- Project Management: `ACTIVE_PROJECTS`, `PROJECT_PROGRESS`, `PROJECT_ACTIVITY`, `PROJECT_DEADLINES`, `PROJECT_STATUS`
|
||||
- Task Management: `ASSIGNED_TASKS`, `TASK_PRIORITY`, `TASK_CALENDAR`, `UPCOMING_TASKS`, `TASK_LIST`
|
||||
- Sprint: `SPRINT_OVERVIEW`, `SPRINT_BURNDOWN`, `SPRINT_PROGRESS`
|
||||
- Team & Analytics: `TEAM_WORKLOAD`, `TEAM_PRESENCE`, `TEAM_ACTIVITY`
|
||||
- Performance: `PRODUCTIVITY_STATS`, `TIME_DISTRIBUTION`, `PERSONAL_STATS`
|
||||
- Actions: `QUICK_ACTIONS`, `RECENT_ACTIVITY`
|
||||
|
||||
## Migration Requirements
|
||||
|
||||
### PostgreSQL Migration Steps:
|
||||
|
||||
1. **Add company_invitation table** (migration 19)
|
||||
2. **Add updated_at to company table** (migration 20)
|
||||
3. **Add new columns to user table** for 2FA and avatar
|
||||
4. **Add new columns to user_preferences table**
|
||||
5. **Add new columns to user_dashboard table**
|
||||
6. **Add new columns to company_work_config table**
|
||||
7. **Add new columns to company_settings table**
|
||||
8. **Add new columns to dashboard_widget table**
|
||||
9. **Update enum types** for WorkRegion and TaskStatus
|
||||
10. **Update WidgetType enum** with new values
|
||||
|
||||
### Data Migration Considerations:
|
||||
|
||||
1. **Default values**: All new columns have appropriate defaults
|
||||
2. **Nullable fields**: Most new fields are nullable or have defaults
|
||||
3. **Foreign keys**: New invitation table has proper FK constraints
|
||||
4. **Indexes**: Performance indexes added for invitation lookups
|
||||
5. **Enum migrations**: Need to handle enum type changes carefully in PostgreSQL
|
||||
|
||||
### Breaking Changes:
|
||||
|
||||
- None identified - all changes are additive or have defaults
|
||||
|
||||
### Rollback Strategy:
|
||||
|
||||
1. Drop new tables (company_invitation)
|
||||
2. Drop new columns from existing tables
|
||||
3. Revert enum changes (remove new values)
|
||||
|
||||
## Summary
|
||||
|
||||
The main changes involve:
|
||||
1. Adding email invitation functionality with a new table
|
||||
2. Enhancing user features with 2FA and avatars
|
||||
3. Expanding dashboard and widget capabilities
|
||||
4. Adding comprehensive work configuration options
|
||||
5. Better tracking with updated_at timestamps
|
||||
6. Regional compliance support with expanded WorkRegion enum
|
||||
Reference in New Issue
Block a user