29_timesheet-management #64

Merged

kfickel merged 9 commits from 29_timesheet-management into main 2026-04-02 18:17:37 +02:00

Conversation 0 Commits 9 Files changed 11 +1654 -20

kfickel commented 2026-03-29 22:10:08 +02:00

Owner

Copy link

No description provided.

kfickel added 6 commits 2026-03-29 22:10:08 +02:00

feat(timesheet): add configuration model with period validation ... 86433ca3dc

Add TimesheetConfig and Period structs for configuring timesheet
periods with expected working hours per week. Include RepositoryConfig
for loading .streamd.toml with timezone and timesheet configuration.

Validation ensures:
- No overlapping periods
- Valid date ranges (start <= end)

Also adds chrono-tz dependency for timezone support.

feat(timesheet): add report data structures ... 7abf056609

Add DayReport, DayType, DayWarning, MonthReport, and TimesheetReport
structs for generating timesheet reports. These support:
- Day types (Regular, SickLeave, Vacation, Holiday, FlexDay, Weekend, Missing, OutsidePeriod)
- Warnings for missing days, overlapping timecards, and outside-period work
- Monthly and cumulative calculations

feat(timesheet): add overlap detection for timecards ... 282d83bedb

Add find_overlapping_timecards function to detect overlapping time
ranges on the same day. This is used to generate warnings in the
timesheet report.

feat(timesheet): add report generation logic ... 3429f2e65d

Implement the core report generation that:
- Loads .streamd.toml configuration
- Calculates expected hours based on periods and day types
- Calculates actual hours following day type rules:
  - Sick leave: max(expected, worked)
  - Vacation: expected + worked
  - Flex day: 0
  - Holiday: 0 expected
- Generates warnings for missing days, overlapping timecards,
  and work outside configured periods
- Calculates monthly and cumulative balances
- Sorts months in descending order

feat(timesheet): add formatted report output to CLI ... 1119d91854

Replace CSV output with formatted table display showing:
- Monthly breakdown with expected/actual hours per day
- Day types (Regular, Sick Leave, Vacation, Holiday, Flex Day, etc.)
- Warning indicators for missing days and overlapping timecards
- Monthly summaries with total expected/actual hours
- Cumulative balance across all months
- Detailed warnings section at the end

Shows helpful message when no .streamd.toml configuration is found.

docs: add timesheet management documentation ... 14ae2909e4

Update README.md with:
- Repository configuration section for .streamd.toml
- Timesheet periods configuration example
- Description of timesheet report features

Update REQUIREMENTS.md with:
- R18a: Timesheet report configuration format
- R18b: Day type rules for expected/actual hours calculation
- R18c: Timesheet report warning types
- Updated R20 command description

kfickel force-pushed 29_timesheet-management from 14ae2909e4 to d11a35c157 2026-04-02 17:10:21 +02:00 Compare

kfickel merged commit d11a35c157 into main 2026-04-02 18:17:37 +02:00

kfickel deleted branch 29_timesheet-management 2026-04-02 18:17:37 +02:00

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

planned

The feature is ready to be implemented by an AI agent

No labels

planned

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference: kfickel/streamd#64

No description provided.