README.md

Flexitime

Flexitime is a small Rails app for tracking clock-in/clock-out time, lunch breaks, and weekly hour balances.

It's designed around compressed working weeks (37 hours by default), with carry-over between weeks so overtime or shortfalls roll forward automatically.

I built Flexitime to track my own compressed working week, without the complexity of a full HR system.

Features

• Clock in / clock out with optional lunch breaks
• Weekly totals showing required hours and running balance
• Automatic carry over of credit/debt between weeks
• Configurable contracted hours and working days per user
• Simple personal time tracking workflow (not a full HR system)

Screenshots

Here's a quick look at the core screens.

Time entries

Shows worked hours, target, and remaining balance, alongside the weekly entries list.

New entry screen

Log your start/finish times and optional lunch breaks.

Account settings

Manage your email, password and work schedule.

Requirements

• Ruby (see .tool-versions)
• PostgreSQL

Setup

bundle install
bin/rails db:prepare

Run locally

bin/dev

Then visit: http://localhost:3000

Tests

bundle exec rspec

Documentation

• Domain model: documentation/domain-model.md
• Roadmap: documentation/ROADMAP.md

Notes

• Weeks start on Monday (Mon-Sun).
• Required hours for the week are adjusted using the previous week's balance.
• Originally built for personal use, and focused on being simple and reliable.