How isorahmonov/stundenfassen works
This is a German-language shift, wage, and availability tracker. The main workflow records shifts for employers, stores them per user, and presents monthly aggregates, warnings, reconciliation, and exports. Separate screens manage planned shifts and calendar-based availability, including iCal feeds and an export archive; settings manage calendars and minus entries. The graph reflects documented imports and excerpted calls; several component implementations and API route bodies were not shown, so their internal connections are omitted.
Main entry points: MonatsUebersicht.tsx Monthly overview · index.ts Repository access · verfuegbarkeit/page.tsx Availability screen · schichten/page.tsx Planned shifts
Components 26
App screens
- Monthly overview
app/components/MonatsUebersicht.tsx - Employer management
app/components/ArbeitgeberVerwaltung.tsx - Planned shifts
app/schichten/page.tsx - Settings
app/einstellungen/page.tsx
Availability
- Availability screen
app/verfuegbarkeit/page.tsx - iCal API
app/api/ical/route.ts - iCal feed route
app/api/ical/[id]/route.ts - Availability logic
lib/verfuegbarkeit/verfuegbarkeit.ts - iCal parser
lib/verfuegbarkeit/icalParser.ts - Event selection cache
lib/verfuegbarkeit/eventCache.ts - Calendar helpers
lib/verfuegbarkeit - Availability PDF
app/components/VerfuegbarkeitPDF.tsx
Shift and wage domain
- Shift and employer models
lib/types.ts - Monthly calculations
lib/calc/aggregate.ts - Wage calculations
lib/calc/lohn.ts - Shift warnings
lib/calc/warnings.ts - Time calculations
lib/calc/time.ts - Holiday and premiums
lib/calc/zuschlaege.ts - Calculation helpers
lib/calc
Persistence
- Repository access
lib/storage/index.ts - Firestore repositories
lib/storage/firestore - User-scoped mapping
lib/storage/firestore/shared.ts - Firebase client
lib/firebase/client.ts - Firebase admin
lib/firebase/admin.ts - Cloud Firestore
Other components
- Worker
Connections 31
- Worker → Monthly overview: views
- Worker → Employer management: manages
- Monthly overview → Monthly calculations: calculates with
app/components/MonatsUebersicht.tsx - Monthly overview → Repository access: loads data
app/components/MonatsUebersicht.tsx - Monthly overview → Shift and employer models: uses types
app/components/MonatsUebersicht.tsx - Monthly overview → Calculation helpers: formats results
app/components/MonatsUebersicht.tsx - Monthly calculations → Wage calculations: calculates with
lib/calc/aggregate.ts - Monthly calculations → Shift warnings: checks shifts
lib/calc/aggregate.ts - Wage calculations → Time calculations: uses
lib/calc/lohn.ts - Wage calculations → Holiday and premiums: uses
lib/calc/lohn.ts - Shift warnings → Time calculations: uses
lib/calc/warnings.ts - Holiday and premiums → Time calculations: uses
lib/calc/zuschlaege.ts - Planned shifts → Repository access: loads and edits
app/schichten/page.tsx - Planned shifts → Calendar helpers: uses week dates
app/schichten/page.tsx - Planned shifts → Cloud Firestore: reads archive
app/schichten/page.tsx - Employer management → Repository access: manages employers
app/components/ArbeitgeberVerwaltung.tsx - Settings → Repository access: loads minus entries
app/einstellungen/page.tsx - Settings → iCal API: requests calendars
app/einstellungen/page.tsx - Availability screen → Availability logic: calculates availability
app/verfuegbarkeit/page.tsx - Availability screen → Event selection cache: loads and saves selection
app/verfuegbarkeit/page.tsx - Availability screen → Calendar helpers: uses calendar helpers
app/verfuegbarkeit/page.tsx - Availability screen → Cloud Firestore: archives exports
app/verfuegbarkeit/page.tsx - iCal API → Firebase admin: uses
app/api/ical/route.ts - iCal API → iCal parser: parses feeds
app/api/ical/route.ts - iCal feed route → Firebase admin: uses
app/api/ical/[id]/route.ts - Availability logic → iCal parser: parses calendar text
lib/verfuegbarkeit/verfuegbarkeit.ts - Repository access → Firestore repositories: instantiates
lib/storage/index.ts - Firestore repositories → User-scoped mapping: uses mappings
lib/storage/firestore/ShiftRepository.ts - Firestore repositories → Cloud Firestore: reads and writes
lib/storage/firestore/ShiftRepository.ts - User-scoped mapping → Firebase client: uses
lib/storage/firestore/shared.ts - User-scoped mapping → Cloud Firestore: scopes user data
lib/storage/firestore/shared.ts