395 lines
12 KiB
Markdown
395 lines
12 KiB
Markdown
|
|
# Workweek Presets Refactoring - FØR vs EFTER Sammenligning
|
|||
|
|
|
|||
|
|
## Side-by-Side Comparison
|
|||
|
|
|
|||
|
|
| Aspekt | FØR Refaktorering | EFTER Refaktorering | Forbedring |
|
|||
|
|
|--------|-------------------|---------------------|------------|
|
|||
|
|
| **Ansvarlig Manager** | ViewManager | WorkweekPresetsManager | ✅ Dedicated manager per UI element |
|
|||
|
|
| **Button Setup** | ViewManager.setupButtonGroup() | WorkweekPresetsManager.setupButtonListeners() | ✅ Isolated ansvar |
|
|||
|
|
| **State Management** | ViewManager + Configuration | Configuration (via WorkweekPresetsManager) | ✅ Simplere |
|
|||
|
|
| **CSS Opdatering** | ViewManager kalder ConfigManager.updateCSSProperties() | ConfigManager lytter til WORKWEEK_CHANGED event | ✅ Event-drevet, løsere kobling |
|
|||
|
|
| **Config Mutation** | ViewManager → config.setWorkWeek() | WorkweekPresetsManager → config.currentWorkWeek = | ⚠️ Direkte mutation |
|
|||
|
|
| **ViewManager Ansvar** | View selector + Workweek presets | Kun view selector | ✅ Single Responsibility |
|
|||
|
|
| **Code Duplication** | 35% (static + instance CSS metoder) | 0% | ✅ DRY princip |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Kode Sammenligning
|
|||
|
|
|
|||
|
|
### 1. Button Click Handling
|
|||
|
|
|
|||
|
|
#### FØR - ViewManager
|
|||
|
|
```typescript
|
|||
|
|
// ViewManager.ts
|
|||
|
|
private setupButtonHandlers(): void {
|
|||
|
|
this.setupButtonGroup('swp-view-button[data-view]', 'data-view', (value) => {
|
|||
|
|
if (this.isValidView(value)) {
|
|||
|
|
this.changeView(value as CalendarView);
|
|||
|
|
}
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
// WORKWEEK LOGIK HER - forkert ansvar
|
|||
|
|
this.setupButtonGroup('swp-preset-button[data-workweek]', 'data-workweek', (value) => {
|
|||
|
|
this.changeWorkweek(value);
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private changeWorkweek(workweekId: string): void {
|
|||
|
|
this.config.setWorkWeek(workweekId);
|
|||
|
|
|
|||
|
|
// DIREKTE KALD - tight coupling
|
|||
|
|
ConfigManager.updateCSSProperties(this.config);
|
|||
|
|
|
|||
|
|
this.updateAllButtons();
|
|||
|
|
|
|||
|
|
const settings = this.config.getWorkWeekSettings();
|
|||
|
|
|
|||
|
|
this.eventBus.emit(CoreEvents.WORKWEEK_CHANGED, {
|
|||
|
|
workWeekId: workweekId,
|
|||
|
|
settings: settings
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### EFTER - WorkweekPresetsManager
|
|||
|
|
```typescript
|
|||
|
|
// WorkweekPresetsManager.ts
|
|||
|
|
private setupButtonListeners(): void {
|
|||
|
|
const buttons = document.querySelectorAll('swp-preset-button[data-workweek]');
|
|||
|
|
|
|||
|
|
buttons.forEach(button => {
|
|||
|
|
const clickHandler = (event: Event) => {
|
|||
|
|
event.preventDefault();
|
|||
|
|
const presetId = button.getAttribute('data-workweek');
|
|||
|
|
if (presetId) {
|
|||
|
|
this.changePreset(presetId);
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
button.addEventListener('click', clickHandler);
|
|||
|
|
this.buttonListeners.set(button, clickHandler);
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
this.updateButtonStates();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private changePreset(presetId: string): void {
|
|||
|
|
if (!WORK_WEEK_PRESETS[presetId]) {
|
|||
|
|
console.warn(`Invalid preset ID "${presetId}"`);
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (presetId === this.config.currentWorkWeek) {
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
const previousPresetId = this.config.currentWorkWeek;
|
|||
|
|
this.config.currentWorkWeek = presetId;
|
|||
|
|
|
|||
|
|
const settings = WORK_WEEK_PRESETS[presetId];
|
|||
|
|
|
|||
|
|
this.updateButtonStates();
|
|||
|
|
|
|||
|
|
// Emit event - CSS opdatering sker automatisk via ConfigManager listener
|
|||
|
|
this.eventBus.emit(CoreEvents.WORKWEEK_CHANGED, {
|
|||
|
|
workWeekId: presetId,
|
|||
|
|
previousWorkWeekId: previousPresetId,
|
|||
|
|
settings: settings
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2. CSS Opdatering
|
|||
|
|
|
|||
|
|
#### FØR - ConfigManager
|
|||
|
|
```typescript
|
|||
|
|
// ConfigManager.ts - DUPLIKERET KODE!
|
|||
|
|
|
|||
|
|
// Static metode kaldt fra ViewManager
|
|||
|
|
static updateCSSProperties(config: Configuration): void {
|
|||
|
|
const gridSettings = config.gridSettings;
|
|||
|
|
const workWeekSettings = config.getWorkWeekSettings();
|
|||
|
|
|
|||
|
|
// 6 CSS properties sat
|
|||
|
|
document.documentElement.style.setProperty('--hour-height', `${gridSettings.hourHeight}px`);
|
|||
|
|
document.documentElement.style.setProperty('--day-start-hour', gridSettings.dayStartHour.toString());
|
|||
|
|
document.documentElement.style.setProperty('--day-end-hour', gridSettings.dayEndHour.toString());
|
|||
|
|
document.documentElement.style.setProperty('--work-start-hour', gridSettings.workStartHour.toString());
|
|||
|
|
document.documentElement.style.setProperty('--work-end-hour', gridSettings.workEndHour.toString());
|
|||
|
|
document.documentElement.style.setProperty('--grid-columns', workWeekSettings.totalDays.toString());
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Instance metode i constructor - SAMME KODE!
|
|||
|
|
public updateAllCSSProperties(): void {
|
|||
|
|
const gridSettings = this.config.gridSettings;
|
|||
|
|
|
|||
|
|
// 5 CSS properties sat (mangler --grid-columns!)
|
|||
|
|
document.documentElement.style.setProperty('--hour-height', `${gridSettings.hourHeight}px`);
|
|||
|
|
document.documentElement.style.setProperty('--day-start-hour', gridSettings.dayStartHour.toString());
|
|||
|
|
document.documentElement.style.setProperty('--day-end-hour', gridSettings.dayEndHour.toString());
|
|||
|
|
document.documentElement.style.setProperty('--work-start-hour', gridSettings.workStartHour.toString());
|
|||
|
|
document.documentElement.style.setProperty('--work-end-hour', gridSettings.workEndHour.toString());
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### EFTER - ConfigManager
|
|||
|
|
```typescript
|
|||
|
|
// ConfigManager.ts - INGEN DUPLICATION!
|
|||
|
|
|
|||
|
|
constructor(eventBus: IEventBus, config: Configuration) {
|
|||
|
|
this.eventBus = eventBus;
|
|||
|
|
this.config = config;
|
|||
|
|
|
|||
|
|
this.setupEventListeners();
|
|||
|
|
this.syncGridCSSVariables(); // Kaldt ved initialization
|
|||
|
|
this.syncWorkweekCSSVariables(); // Kaldt ved initialization
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private setupEventListeners(): void {
|
|||
|
|
// Lyt til events - REACTIVE!
|
|||
|
|
this.eventBus.on(CoreEvents.WORKWEEK_CHANGED, (event: Event) => {
|
|||
|
|
const { settings } = (event as CustomEvent<{ settings: IWorkWeekSettings }>).detail;
|
|||
|
|
this.syncWorkweekCSSVariables(settings);
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private syncGridCSSVariables(): void {
|
|||
|
|
const gridSettings = this.config.gridSettings;
|
|||
|
|
|
|||
|
|
document.documentElement.style.setProperty('--hour-height', `${gridSettings.hourHeight}px`);
|
|||
|
|
document.documentElement.style.setProperty('--day-start-hour', gridSettings.dayStartHour.toString());
|
|||
|
|
document.documentElement.style.setProperty('--day-end-hour', gridSettings.dayEndHour.toString());
|
|||
|
|
document.documentElement.style.setProperty('--work-start-hour', gridSettings.workStartHour.toString());
|
|||
|
|
document.documentElement.style.setProperty('--work-end-hour', gridSettings.workEndHour.toString());
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
private syncWorkweekCSSVariables(workWeekSettings?: IWorkWeekSettings): void {
|
|||
|
|
const settings = workWeekSettings || this.config.getWorkWeekSettings();
|
|||
|
|
document.documentElement.style.setProperty('--grid-columns', settings.totalDays.toString());
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// STATIC METODE FJERNET! Ingen duplication!
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3. Configuration Management
|
|||
|
|
|
|||
|
|
#### FØR - Configuration
|
|||
|
|
```typescript
|
|||
|
|
// CalendarConfig.ts
|
|||
|
|
export class Configuration {
|
|||
|
|
public currentWorkWeek: string;
|
|||
|
|
|
|||
|
|
constructor(
|
|||
|
|
config: ICalendarConfig,
|
|||
|
|
gridSettings: IGridSettings,
|
|||
|
|
dateViewSettings: IDateViewSettings,
|
|||
|
|
timeFormatConfig: ITimeFormatConfig,
|
|||
|
|
currentWorkWeek: string,
|
|||
|
|
selectedDate: Date = new Date()
|
|||
|
|
) {
|
|||
|
|
// ...
|
|||
|
|
this.currentWorkWeek = currentWorkWeek;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Metode med side effect
|
|||
|
|
setWorkWeek(workWeekId: string): void {
|
|||
|
|
if (WORK_WEEK_PRESETS[workWeekId]) {
|
|||
|
|
this.currentWorkWeek = workWeekId;
|
|||
|
|
this.dateViewSettings.weekDays = WORK_WEEK_PRESETS[workWeekId].totalDays; // SIDE EFFECT!
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
getWorkWeekSettings(): IWorkWeekSettings {
|
|||
|
|
return WORK_WEEK_PRESETS[this.currentWorkWeek] || WORK_WEEK_PRESETS['standard'];
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### EFTER - Configuration
|
|||
|
|
```typescript
|
|||
|
|
// CalendarConfig.ts
|
|||
|
|
export class Configuration {
|
|||
|
|
public currentWorkWeek: string;
|
|||
|
|
|
|||
|
|
constructor(
|
|||
|
|
config: ICalendarConfig,
|
|||
|
|
gridSettings: IGridSettings,
|
|||
|
|
dateViewSettings: IDateViewSettings,
|
|||
|
|
timeFormatConfig: ITimeFormatConfig,
|
|||
|
|
currentWorkWeek: string,
|
|||
|
|
selectedDate: Date = new Date()
|
|||
|
|
) {
|
|||
|
|
// ...
|
|||
|
|
this.currentWorkWeek = currentWorkWeek;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// setWorkWeek() FJERNET - WorkweekPresetsManager opdaterer direkte
|
|||
|
|
|
|||
|
|
getWorkWeekSettings(): IWorkWeekSettings {
|
|||
|
|
return WORK_WEEK_PRESETS[this.currentWorkWeek] || WORK_WEEK_PRESETS['standard'];
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Arkitektur Diagrammer
|
|||
|
|
|
|||
|
|
### FØR - Tight Coupling
|
|||
|
|
```
|
|||
|
|
User Click
|
|||
|
|
↓
|
|||
|
|
ViewManager (håndterer BÅDE view OG workweek)
|
|||
|
|
↓
|
|||
|
|
├─→ Configuration.setWorkWeek() (side effect på dateViewSettings!)
|
|||
|
|
├─→ ConfigManager.updateCSSProperties() (direkte kald - tight coupling)
|
|||
|
|
├─→ updateAllButtons() (view + workweek blandet)
|
|||
|
|
└─→ EventBus.emit(WORKWEEK_CHANGED)
|
|||
|
|
↓
|
|||
|
|
├─→ GridManager
|
|||
|
|
├─→ CalendarManager → HeaderManager
|
|||
|
|
└─→ ConfigManager (gør INGENTING - CSS allerede sat!)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### EFTER - Loose Coupling
|
|||
|
|
```
|
|||
|
|
User Click
|
|||
|
|
↓
|
|||
|
|
WorkweekPresetsManager (dedicated ansvar)
|
|||
|
|
↓
|
|||
|
|
├─→ config.currentWorkWeek = presetId (simpel state update)
|
|||
|
|
├─→ updateButtonStates() (kun workweek buttons)
|
|||
|
|
└─→ EventBus.emit(WORKWEEK_CHANGED)
|
|||
|
|
↓
|
|||
|
|
├─→ ConfigManager.syncWorkweekCSSVariables() (event-drevet!)
|
|||
|
|
├─→ GridManager.render()
|
|||
|
|
└─→ CalendarManager → HeaderManager
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Metrics Sammenligning
|
|||
|
|
|
|||
|
|
| Metric | FØR | EFTER | Forbedring |
|
|||
|
|
|--------|-----|-------|------------|
|
|||
|
|
| **Lines of Code** | | | |
|
|||
|
|
| ViewManager | 155 linjer | 117 linjer | ✅ -24% (38 linjer) |
|
|||
|
|
| ConfigManager | 122 linjer | 103 linjer | ✅ -16% (19 linjer) |
|
|||
|
|
| WorkweekPresetsManager | 0 linjer | 115 linjer | ➕ Ny fil |
|
|||
|
|
| **Code Duplication** | 35% | 0% | ✅ -35% |
|
|||
|
|
| **Cyclomatic Complexity** | | | |
|
|||
|
|
| ViewManager.changeWorkweek() | 2 | N/A (fjernet) | ✅ |
|
|||
|
|
| WorkweekPresetsManager.changePreset() | N/A | 3 | ➕ |
|
|||
|
|
| ConfigManager (avg) | 1.5 | 1.0 | ✅ Simplere |
|
|||
|
|
| **Coupling** | Tight (direkte kald) | Loose (event-drevet) | ✅ |
|
|||
|
|
| **Cohesion** | Lav (mixed concerns) | Høj (single responsibility) | ✅ |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Dependencies Graf
|
|||
|
|
|
|||
|
|
### FØR
|
|||
|
|
```
|
|||
|
|
ViewManager
|
|||
|
|
├─→ Configuration (read + write via setWorkWeek)
|
|||
|
|
├─→ ConfigManager (direct static call - TIGHT COUPLING)
|
|||
|
|
├─→ CoreEvents
|
|||
|
|
└─→ EventBus
|
|||
|
|
|
|||
|
|
ConfigManager
|
|||
|
|
├─→ Configuration (read only)
|
|||
|
|
├─→ EventBus (NO LISTENER! CSS sat via direct call)
|
|||
|
|
└─→ TimeFormatter
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### EFTER
|
|||
|
|
```
|
|||
|
|
WorkweekPresetsManager
|
|||
|
|
├─→ Configuration (read + direct mutation)
|
|||
|
|
├─→ WORK_WEEK_PRESETS (import fra CalendarConfig)
|
|||
|
|
├─→ CoreEvents
|
|||
|
|
└─→ EventBus
|
|||
|
|
|
|||
|
|
ViewManager
|
|||
|
|
├─→ Configuration (read only)
|
|||
|
|
├─→ CoreEvents
|
|||
|
|
└─→ EventBus
|
|||
|
|
|
|||
|
|
ConfigManager
|
|||
|
|
├─→ Configuration (read only)
|
|||
|
|
├─→ EventBus (LISTENER for WORKWEEK_CHANGED - LOOSE COUPLING)
|
|||
|
|
├─→ CoreEvents
|
|||
|
|
└─→ TimeFormatter
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Fordele ved Refaktorering
|
|||
|
|
|
|||
|
|
### ✅ Single Responsibility Principle
|
|||
|
|
- **ViewManager**: Fokuserer kun på view selector (day/week/month)
|
|||
|
|
- **WorkweekPresetsManager**: Dedikeret til workweek presets UI
|
|||
|
|
- **ConfigManager**: CSS synchronization manager
|
|||
|
|
|
|||
|
|
### ✅ Event-Drevet Arkitektur
|
|||
|
|
- CSS opdatering sker reaktivt via events
|
|||
|
|
- Ingen direkte metode kald mellem managers
|
|||
|
|
- Loose coupling mellem komponenter
|
|||
|
|
|
|||
|
|
### ✅ DRY Princip
|
|||
|
|
- Fjernet 35% code duplication
|
|||
|
|
- Ingen static + instance duplication længere
|
|||
|
|
- CSS sættes præcis 1 gang (ikke 2 gange)
|
|||
|
|
|
|||
|
|
### ✅ Maintainability
|
|||
|
|
- Nemmere at finde workweek logik (én dedikeret fil)
|
|||
|
|
- Ændringer i workweek påvirker ikke view selector
|
|||
|
|
- Klar separation of concerns
|
|||
|
|
|
|||
|
|
### ✅ Testability
|
|||
|
|
- WorkweekPresetsManager kan testes isoleret
|
|||
|
|
- ConfigManager event listeners kan mockes
|
|||
|
|
- Ingen hidden dependencies via static calls
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Ulemper / Trade-offs
|
|||
|
|
|
|||
|
|
### ⚠️ Flere Filer
|
|||
|
|
- +1 ny manager fil (WorkweekPresetsManager.ts)
|
|||
|
|
- Men bedre organisation
|
|||
|
|
|
|||
|
|
### ⚠️ Direkte State Mutation
|
|||
|
|
```typescript
|
|||
|
|
this.config.currentWorkWeek = presetId; // Ikke via setter
|
|||
|
|
```
|
|||
|
|
- Configuration har ingen kontrol over mutation
|
|||
|
|
- Men simplere og mere direkte
|
|||
|
|
|
|||
|
|
### ⚠️ DOM-afhængighed i Constructor
|
|||
|
|
```typescript
|
|||
|
|
constructor(...) {
|
|||
|
|
this.setupButtonListeners(); // Kalder document.querySelectorAll
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
- Kan ikke unit testes uden DOM
|
|||
|
|
- Men fungerer perfekt da DI sker efter DOMContentLoaded
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Konklusion
|
|||
|
|
|
|||
|
|
Refaktoreringen følger princippet **"Each UI element has its own manager"** og resulterer i:
|
|||
|
|
|
|||
|
|
✅ **Bedre struktur**: Klar separation mellem view og workweek
|
|||
|
|
✅ **Mindre kobling**: Event-drevet i stedet for direkte kald
|
|||
|
|
✅ **Mindre duplication**: Fra 35% til 0%
|
|||
|
|
✅ **Simplere kode**: Mindre kompleksitet i hver manager
|
|||
|
|
✅ **Nemmere at udvide**: Kan nemt tilføje ViewSelectorManager, NavigationGroupManager etc.
|
|||
|
|
|
|||
|
|
**Trade-off**: Lidt flere filer, men meget bedre organisation og maintainability.
|