hr_lite 0.29.0 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a5463a93b5739d60f73bd2cd554fce576f754218a8415fbd81ae35bdadc6ebcf
-  data.tar.gz: dadfaf0eb389d5cbe4fd012ef47d05561d03bc7e313462c491359114bb5cf294
+  metadata.gz: 2f6f41c24e52098ad42a4af7b5827a3fb2fc09a56e5d46d2194122506faa088b
+  data.tar.gz: 6c2323f7e9db6bf95db8f28fac7261b7a670dbdb486b902e30809f5331c95a58
 SHA512:
-  metadata.gz: e9d1029c660d36bca33f79ede86ca0684a48616824f243a42df8c8a944b2b1b8fd55401e2cf3fafdf4411e9e33bcca24a9ddbc99c5337ed45db6a0e0830db541
-  data.tar.gz: 5c7a048e80c6522360eae49ddedf37589762ac548fa4768c5f6d3ff9d2a25be3c5fd8925dcdfdce79ee35daf003c13efd8eb9ecbab29567c83983b87cc5cb70c
+  metadata.gz: c62ee058dcc94b38c24976b2120d7adcb4df515796c92ccb6201b655ea5ee1e54b5b5b8e45c83c34ec811463c50fbc35c651c4d1ae0940317cdb76bf4773bfbc
+  data.tar.gz: 5d130419f330d6aa715f4c43d36e8d7acf10be7df700930514666600659ab2cb241b70311df969aefbc1ab3e879729680b85b4ea9740311b78b305c4a82a0dc4

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.30.0] - 2026-10-13
+
+- Attendance slots (`config.attendance_slots = true`, off by default). Employees pick a check-in slot (09:00, 09:30, 10:00 or 10:30; checkout 8h30 later) for today, this week or this month. Saving locks it. HR sets or unlocks a slot from the employee's attendance page. No slot means 10:00.
+- Late penalties. After 5 minutes of grace, each started half hour late adds 30 minutes to that day's checkout. A check-in after 11:00 also adds 1 hour to each of the next two working days, and one after 11:30 makes the day a half day (an approved regularization ticket lifts it). Leaving before the required checkout adds 30 minutes to the next working day (nightly close job). The punch card shows the slot, the required checkout, time left and any shortage, and My attendance lists the month's penalties. HR removes a penalty with a reason; the row is kept.
+- Late buffer. HR gives an employee 1h or 2h with a reason (parental care, medical, health, other) on their profile. It delays the penalty clock. Colleagues see the category on the team board; the note is HR-only and encrypted.
+
 ## [0.29.0] - 2026-10-11
 
 - ID card: Share button. Draws front and back side by side into one PNG and opens the phone's share sheet (WhatsApp, mail…); desktops download the PNG. The card photo is now served through the Active Storage proxy (same site), so it shows up in the image when storage redirects to a cloud bucket. Vendors html-to-image 1.11.11 (MIT).

data/app/controllers/hr_lite/admin/attendances_controller.rb

@@ -111,6 +111,35 @@ module HrLite
         end
       end
 
+      # HR sets a locked slot from today for the period.
+      def slot
+        @employee = find_manageable_employee
+        period = params[:period].to_s
+        slot = AttendanceSlot.new(user_id: @employee.id, set_by_id: hr_current_user.id, period: period,
+                                  start_minute: params[:start_minute].to_i, starts_on: Date.current,
+                                  ends_on: AttendanceSlot.ends_on_for(period, Date.current))
+        flash_for = slot.save ? { notice: "Slot set to #{AttendanceSlot.label(slot.start_minute)}." } : { alert: slot.errors.full_messages.to_sentence }
+        redirect_to admin_attendance_path(@employee.id), flash_for
+      end
+
+      # Lets the employee pick a new slot themselves.
+      def unlock_slot
+        @employee = find_manageable_employee
+        AttendanceSlot.where(user_id: @employee.id, locked: true).where(ends_on: Date.current..).find_each { |s| s.update!(locked: false) }
+        redirect_to admin_attendance_path(@employee.id), notice: "Slot unlocked. #{hr_display_name(@employee)} can pick a new one."
+      end
+
+      def remove_penalty
+        @employee = find_manageable_employee
+        penalty = AttendancePenalty.active.where(user_id: @employee.id).find(params[:penalty_id])
+        reason = params[:removal_reason].to_s.strip
+        month = penalty.date.strftime("%Y-%m")
+        return redirect_to admin_attendance_path(@employee.id, month: month), alert: "A reason is required." if reason.blank?
+
+        penalty.update!(removed_at: Time.current, removed_by_id: hr_current_user.id, removal_reason: reason)
+        redirect_to admin_attendance_path(@employee.id, month: month), notice: "Penalty removed."
+      end
+
       private
 
       # Viewing somebody's month and rewriting their punches are different

data/app/controllers/hr_lite/admin/employees_controller.rb

@@ -115,7 +115,8 @@ module HrLite
           :user_id, :manager_id, :designation, :date_of_birth, :date_of_joining,
           :date_of_exit, :probation_until, :department, :work_location, :pan_number, :pf_uan, :esi_number,
           :bank_account_number, :bank_ifsc, :bank_name, :tax_regime, :declared_annual_deductions,
-          :fy_opening_gross, :fy_opening_tds, :blood_group, :emergency_contact
+          :fy_opening_gross, :fy_opening_tds, :blood_group, :emergency_contact,
+          :buffer_minutes, :buffer_reason, :buffer_note
         )
       end
 

data/app/controllers/hr_lite/attendance_controller.rb

@@ -25,6 +25,29 @@ module HrLite
       punch(:check_out)
     end
 
+    # Saving locks the slot for the period; a locked one only HR changes.
+    def slot
+      raise ActiveRecord::RecordNotFound unless HrLite.config.attendance_slots
+
+      period = params[:period].to_s
+      to = AttendanceSlot.ends_on_for(period, Date.current)
+      if AttendanceSlot.where(user_id: hr_current_user.id, locked: true).overlapping(Date.current, to).exists?
+        return redirect_to attendance_path, alert: "Your slot is locked for that period. Ask HR to change it."
+      end
+      # Today's penalty was priced on the slot at check-in; picking one now would rewrite it.
+      if AttendanceRecord.where(user_id: hr_current_user.id, date: Date.current).where.not(check_in_at: nil).exists?
+        return redirect_to attendance_path, alert: "Pick your slot before checking in."
+      end
+
+      slot = AttendanceSlot.new(user_id: hr_current_user.id, set_by_id: hr_current_user.id, period: period,
+                                start_minute: params[:start_minute].to_i, starts_on: Date.current, ends_on: to)
+      if slot.save
+        redirect_to attendance_path, notice: "Slot #{AttendanceSlot.label(slot.start_minute)} saved and locked until #{to.strftime('%d %b')}."
+      else
+        redirect_to attendance_path, alert: slot.errors.full_messages.to_sentence
+      end
+    end
+
     private
 
     def punch(kind)

data/app/jobs/hr_lite/attendance_close_job.rb

@@ -27,11 +27,23 @@ module HrLite
           tell(user, date, "attendance.short_day",
                "You worked #{(record.worked_duration / 3600.0).round(1)} of #{record.required_hours}h on #{day} — marked half day")
         end
+        penalize_short_day(record) if record&.check_out_at
       end
     end
 
     private
 
+    # Out before the slot's required checkout: +30 min on the next working day.
+    def penalize_short_day(record)
+      return unless HrLite.config.attendance_slots && record.check_out_at < record.required_check_out_at
+
+      next_day = AttendancePenalty.next_working_days(record.date, 1).first
+      AttendancePenalty.find_or_create_by!(attendance_record: record, reason: "short_day", date: next_day) do |p|
+        p.user_id = record.user_id
+        p.minutes = AttendanceSlot::STEP_MINUTES
+      end
+    end
+
     def tell(user, date, event, title)
       rule = HrLite.config.self_regularization
       body = if rule

data/app/models/hr_lite/attendance_penalty.rb

@@ -0,0 +1,30 @@
+module HrLite
+  # Minutes added to one day's required checkout. Never deleted: HR removes
+  # one with a reason and the row stays as the record.
+  class AttendancePenalty < ApplicationRecord
+    include Audited
+
+    REASONS = {
+      "late" => "Late check-in",
+      "late_carry" => "Checked in after 11:00",
+      "short_day" => "Left before the required checkout"
+    }.freeze
+
+    belongs_to :user, class_name: HrLite.config.user_class
+    belongs_to :attendance_record
+    belongs_to :removed_by, class_name: HrLite.config.user_class, optional: true
+
+    validates :reason, inclusion: { in: REASONS.keys }
+    validates :minutes, numericality: { greater_than: 0 }
+    validates :removal_reason, presence: true, if: :removed_at
+
+    scope :active, -> { where(removed_at: nil) }
+
+    def self.next_working_days(date, count)
+      calendar = WorkingCalendar.new((date + 1)..(date + 31))
+      ((date + 1)..(date + 31)).select { |d| calendar.working_day?(d) }.first(count)
+    end
+
+    def label = REASONS.fetch(reason)
+  end
+end

data/app/models/hr_lite/attendance_record.rb

@@ -3,8 +3,9 @@ module HrLite
     STATUSES = %w[present half_day].freeze
     AUTO_CHECKOUT_NOTE = "Auto check-out: no check-out punched".freeze
     SHORT_DAY_NOTE = "Short day: under the required hours".freeze
-    # Half days the close job set (not HR); an approved ticket lifts them.
-    AUTO_NOTES = [ AUTO_CHECKOUT_NOTE, SHORT_DAY_NOTE ].freeze
+    LATE_HALF_DAY_NOTE = "Half day: checked in after 11:30".freeze
+    # Half days the system set (not HR); an approved ticket lifts them.
+    AUTO_NOTES = [ AUTO_CHECKOUT_NOTE, SHORT_DAY_NOTE, LATE_HALF_DAY_NOTE ].freeze
     # Check-in and check-out further apart than this are called out on the board.
     PUNCH_GAP_ALERT_M = 500
 
@@ -45,6 +46,15 @@ module HrLite
       !!(hours && worked_duration && worked_duration < hours.hours)
     end
 
+    # config.attendance_slots: slot start + 8h30 + the day's active penalties.
+    def required_check_out_at
+      return unless HrLite.config.attendance_slots && check_in_at
+
+      extra = AttendancePenalty.active.where(user_id: user_id, date: date).sum(:minutes)
+      date.in_time_zone(HrLite.config.time_zone) +
+        (AttendanceSlot.start_minute_for(user_id, date) + AttendanceSlot::DAY_MINUTES + extra).minutes
+    end
+
     # Metres between where the day was checked in and checked out.
     def punch_gap_m
       return unless check_in_lat && check_in_lng && check_out_lat && check_out_lng

data/app/models/hr_lite/attendance_slot.rb

@@ -0,0 +1,38 @@
+module HrLite
+  # The check-in slot an employee commits to for a day, week or month.
+  # Saving locks it; only an attendance manager changes or unlocks it.
+  class AttendanceSlot < ApplicationRecord
+    include Audited
+
+    START_MINUTES = [ 540, 570, 600, 630 ].freeze # 09:00 09:30 10:00 10:30
+    DEFAULT_START_MINUTE = 600
+    PERIODS = { "day" => "Today", "week" => "This week", "month" => "This month" }.freeze
+    DAY_MINUTES = 510 # 8h30m from slot to checkout
+    GRACE_MINUTES = 5
+    STEP_MINUTES = 30
+    CARRY_AFTER_MINUTE = 660 # 11:00 — +1h on the next 2 working days
+    HALF_DAY_AFTER_MINUTE = 690 # 11:30 — the day is a half day
+
+    belongs_to :user, class_name: HrLite.config.user_class
+
+    validates :start_minute, inclusion: { in: START_MINUTES }
+    validates :period, inclusion: { in: PERIODS.keys }
+    validates :starts_on, :ends_on, presence: true
+
+    scope :overlapping, ->(from, to) { where("starts_on <= ? AND ends_on >= ?", to, from) }
+
+    def self.current(user_id, date) = where(user_id: user_id).overlapping(date, date).order(:created_at).last
+    def self.start_minute_for(user_id, date) = current(user_id, date)&.start_minute || DEFAULT_START_MINUTE
+
+    def self.ends_on_for(period, from)
+      { "week" => from.end_of_week(:monday), "month" => from.end_of_month }.fetch(period, from)
+    end
+
+    # 0 within grace, then +30 for every started half hour: 6–35 late = 30, 36–65 = 60.
+    def self.penalty_minutes(late)
+      late <= GRACE_MINUTES ? 0 : STEP_MINUTES * ((late - GRACE_MINUTES) / STEP_MINUTES.to_f).ceil
+    end
+
+    def self.label(minute) = format("%02d:%02d", *minute.divmod(60))
+  end
+end

data/app/models/hr_lite/employee_profile.rb

@@ -20,6 +20,17 @@ module HrLite
     # read as zero income for the months it cannot see.
     encrypted_money :declared_annual_deductions, :fy_opening_gross, :fy_opening_tds
 
+    # HR-granted late allowance; it delays the penalty clock. Colleagues see
+    # the category, only HR sees the note (encrypted: it can be medical).
+    BUFFER_MINUTES = [ 60, 120 ].freeze
+    BUFFER_REASONS = { "parental_care" => "Parental care", "medical" => "Medical",
+                       "health" => "Health", "other" => "Other" }.freeze
+    encrypts :buffer_note
+    normalizes :buffer_minutes, with: ->(v) { v.presence }
+    validates :buffer_minutes, inclusion: { in: BUFFER_MINUTES }, allow_nil: true
+    validates :buffer_reason, inclusion: { in: BUFFER_REASONS.keys }, if: :buffer_minutes
+    validates :buffer_note, presence: true, if: -> { buffer_minutes && buffer_reason == "other" }
+
     TAX_REGIMES = %w[new old].freeze
     BLOOD_GROUPS = %w[A+ A- B+ B- AB+ AB- O+ O-].freeze
     normalizes :blood_group, with: ->(v) { v.presence } # the "Not set" chip posts ""

data/app/services/hr_lite/attendance_puncher.rb

@@ -53,6 +53,7 @@ module HrLite
 
         apply_geo_flags(record)
         record.save!
+        apply_slot_rules(record) if @kind == :check_in && HrLite.config.attendance_slots
       end
       notify_if_flagged(record)
       Result.new(record: record)
@@ -86,6 +87,25 @@ module HrLite
       "Already checked in at #{record.check_in_at.in_time_zone(HrLite.config.time_zone).strftime('%H:%M')}."
     end
 
+    # Late ladder against slot + buffer; after 11:00 also +1h on the next two
+    # working days; after 11:30 the day is a half day. The buffer shifts all three.
+    def apply_slot_rules(record)
+      local = record.check_in_at.in_time_zone(HrLite.config.time_zone)
+      arrived = local.hour * 60 + local.min - EmployeeProfile.where(user_id: @user.id).pick(:buffer_minutes).to_i
+      late = AttendanceSlot.penalty_minutes(arrived - AttendanceSlot.start_minute_for(@user.id, record.date))
+      penalize(record, record.date, late, "late") if late.positive?
+      return if arrived <= AttendanceSlot::CARRY_AFTER_MINUTE
+
+      AttendancePenalty.next_working_days(record.date, 2).each { |day| penalize(record, day, 60, "late_carry") }
+      return if arrived <= AttendanceSlot::HALF_DAY_AFTER_MINUTE
+
+      record.update!(status: "half_day", regularization_note: AttendanceRecord::LATE_HALF_DAY_NOTE)
+    end
+
+    def penalize(record, date, minutes, reason)
+      AttendancePenalty.create!(user_id: @user.id, date: date, minutes: minutes, reason: reason, attendance_record: record)
+    end
+
     def apply_geo_flags(record)
       label = @kind == :check_in ? "Check-in" : "Check-out"
 

data/app/views/hr_lite/admin/attendances/_slot.html.erb

@@ -0,0 +1,24 @@
+<% slot = HrLite::AttendanceSlot.current(employee.id, Date.current) %>
+<section class="hrl-card">
+  <h2 class="hrl-card__title">Check-in slot</h2>
+  <p class="hrl-small">
+    <span class="hrl-badge"><%= HrLite::AttendanceSlot.label(slot&.start_minute || HrLite::AttendanceSlot::DEFAULT_START_MINUTE) %><%= " (default)" unless slot %></span>
+    <% if slot %><%= slot.locked? ? "Locked" : "Unlocked" %> till <%= slot.ends_on.strftime("%-d %b") %><% end %>
+  </p>
+  <% if slot&.locked? %>
+    <%= form_with url: hr_lite.unlock_slot_admin_attendance_path(employee.id), method: :post, local: true do %>
+      <button type="submit" class="hrl-btn">Unlock so they can pick again</button>
+    <% end %>
+  <% end %>
+  <%= form_with url: hr_lite.slot_admin_attendance_path(employee.id), method: :post, local: true, class: "hrl-mt" do %>
+    <div class="hrl-field">
+      <label for="hrl-admin-slot-start">Set slot</label>
+      <%= select_tag :start_minute, options_for_select(HrLite::AttendanceSlot::START_MINUTES.map { |m| [ HrLite::AttendanceSlot.label(m), m ] }, slot&.start_minute || HrLite::AttendanceSlot::DEFAULT_START_MINUTE), id: "hrl-admin-slot-start" %>
+    </div>
+    <div class="hrl-field">
+      <label for="hrl-admin-slot-period">For</label>
+      <%= select_tag :period, options_for_select(HrLite::AttendanceSlot::PERIODS.invert), id: "hrl-admin-slot-period" %>
+    </div>
+    <button type="submit" class="hrl-btn">Set and lock</button>
+  <% end %>
+</section>

data/app/views/hr_lite/admin/attendances/show.html.erb

@@ -24,6 +24,11 @@
   <p class="hrl-small hrl-muted hrl-mt">Tap a date to fix its punches.</p>
 </section>
 
+<% if HrLite.config.attendance_slots %>
+  <%= render "slot", employee: @employee %>
+  <%= render "hr_lite/attendance/penalties", user: @employee, month: @month, removable: @employee.id != hr_current_user.id %>
+<% end %>
+
 <% if @punches.any? %>
   <section class="hrl-card">
     <h2 class="hrl-card__title">Where they punched</h2>

data/app/views/hr_lite/admin/employees/_form.html.erb

@@ -74,6 +74,17 @@
       <%= f.label :probation_until, "On probation until (blank = not on probation)" %>
       <%= f.date_field :probation_until %>
     </div>
+    <% if HrLite.config.attendance_slots %>
+      <div class="hrl-field">
+        <%= f.label :buffer_minutes, "Late buffer (delays late penalties; colleagues see the reason category)" %>
+        <%= f.select :buffer_minutes, HrLite::EmployeeProfile::BUFFER_MINUTES.map { |m| [ "#{m / 60}h", m ] }, include_blank: "None" %>
+      </div>
+      <div class="hrl-field">
+        <%= f.label :buffer_reason, "Buffer reason" %>
+        <%= f.select :buffer_reason, HrLite::EmployeeProfile::BUFFER_REASONS.invert, include_blank: "Choose one" %>
+      </div>
+      <div class="hrl-field"><%= f.label :buffer_note, "Buffer note (HR only; required for Other)" %><%= f.text_area :buffer_note, rows: 2 %></div>
+    <% end %>
     <div class="hrl-field">
       <%= f.label :date_of_exit, "Date of exit (leave blank while employed)" %>
       <%= f.date_field :date_of_exit %>

data/app/views/hr_lite/attendance/_penalties.html.erb

@@ -0,0 +1,25 @@
+<% penalties = HrLite::AttendancePenalty.where(user_id: user.id, date: month.all_month).order(:date, :id) %>
+<section class="hrl-card">
+  <h2 class="hrl-card__title">Penalties in <%= month.strftime("%B") %></h2>
+  <% if penalties.empty? %>
+    <p class="hrl-card--empty">No penalties this month.</p>
+  <% end %>
+  <% penalties.each do |penalty| %>
+    <div class="hrl-feed__item hrl-small">
+      <div class="hrl-feed__body">
+        <strong><%= penalty.date.strftime("%a %-d %b") %></strong> ·
+        <span class="<%= class_names("hrl-badge", penalty.removed_at ? "hrl-badge--muted" : "hrl-badge--warn") %>">+<%= penalty.minutes %> min</span>
+        <%= penalty.label %>
+        <% if penalty.removed_at %>
+          <div class="hrl-muted">Removed by HR: <%= penalty.removal_reason %></div>
+        <% elsif local_assigns[:removable] %>
+          <%= form_with url: hr_lite.remove_penalty_admin_attendance_path(user.id, penalty_id: penalty.id), method: :post, local: true, class: "hrl-row" do %>
+            <label class="hrl-sr-only" for="hrl-remove-<%= penalty.id %>">Reason to remove</label>
+            <input type="text" class="hrl-input" name="removal_reason" id="hrl-remove-<%= penalty.id %>" required placeholder="Reason to remove">
+            <button type="submit" class="hrl-btn">Remove</button>
+          <% end %>
+        <% end %>
+      </div>
+    </div>
+  <% end %>
+</section>

data/app/views/hr_lite/attendance/_punch_card.html.erb

@@ -28,6 +28,9 @@
       <span class="hrl-muted">Not checked in yet.</span>
     <% end %>
   </div>
+  <% if HrLite.config.attendance_slots %>
+    <%= render "hr_lite/attendance/slot", record: record %>
+  <% end %>
   <% if record&.flagged? %>
     <p class="hrl-small">Flagged: <%= record.flag_note %></p>
   <% end %>

data/app/views/hr_lite/attendance/_slot.html.erb

@@ -0,0 +1,33 @@
+<% slot = HrLite::AttendanceSlot.current(hr_current_user.id, Date.current)
+   start = slot&.start_minute || HrLite::AttendanceSlot::DEFAULT_START_MINUTE
+   due = record&.required_check_out_at %>
+<div class="hrl-row hrl-row--mb hrl-small">
+  <span class="hrl-badge">Slot <%= HrLite::AttendanceSlot.label(start) %><%= " (default)" unless slot %></span>
+  <% if slot&.locked? %><span class="hrl-muted">Locked till <%= slot.ends_on.strftime("%-d %b") %></span><% end %>
+</div>
+<% if due && record.check_out_at %>
+  <% short = due - record.check_out_at %>
+  <p class="hrl-small">Checkout was due <%= due.strftime("%H:%M") %>.
+    <% if short.positive? %><span class="hrl-badge hrl-badge--bad">Short by <%= hrl_duration(short) %></span> +30 min goes on your next working day.<% end %></p>
+<% elsif due %>
+  <% left = due - Time.current %>
+  <p class="hrl-small">Checked in <%= record.check_in_at.strftime("%H:%M") %> · checkout at <strong><%= due.strftime("%H:%M") %></strong> ·
+    <%= left.positive? ? "#{hrl_duration(left)} left" : "you can check out" %></p>
+<% end %>
+<% HrLite::AttendancePenalty.active.where(user_id: hr_current_user.id, date: Date.current).each do |penalty| %>
+  <p class="hrl-small"><span class="hrl-badge hrl-badge--warn">+<%= penalty.minutes %> min</span> <%= penalty.label %></p>
+<% end %>
+<% unless slot&.locked? || record&.check_in_at %>
+  <%= form_with url: hr_lite.slot_attendance_path, method: :post, local: true, class: "hrl-mt" do %>
+    <div class="hrl-field">
+      <label for="hrl-slot-start">Check-in slot</label>
+      <%= select_tag :start_minute, options_for_select(HrLite::AttendanceSlot::START_MINUTES.map { |m| [ "#{HrLite::AttendanceSlot.label(m)} – out #{HrLite::AttendanceSlot.label(m + HrLite::AttendanceSlot::DAY_MINUTES)}", m ] }, start), id: "hrl-slot-start" %>
+    </div>
+    <div class="hrl-field">
+      <label for="hrl-slot-period">For</label>
+      <%= select_tag :period, options_for_select(HrLite::AttendanceSlot::PERIODS.invert), id: "hrl-slot-period" %>
+    </div>
+    <button type="submit" class="hrl-btn hrl-btn--block">Save and lock slot</button>
+    <p class="hrl-small hrl-muted">Once saved, only HR can change it for that period.</p>
+  <% end %>
+<% end %>

data/app/views/hr_lite/attendance/show.html.erb

@@ -25,6 +25,10 @@
     · <a href="<%= hr_lite.regularization_requests_path %>">My tickets</a></p>
 </section>
 
+<% if HrLite.config.attendance_slots %>
+  <%= render "hr_lite/attendance/penalties", user: hr_current_user, month: @month %>
+<% end %>
+
 <% if @day %>
   <% rec, leave = @day_info.record, @day_info.leave
      part = rec&.half_day_part.presence || leave&.half_day_part.presence

data/app/views/hr_lite/team/show.html.erb

@@ -30,7 +30,8 @@
             <tr>
               <td data-label="Name">
                 <span><%= tag.strong hr_display_name(row.user), title: ("On leave: #{row.leave.date_range_label}" if row.leave) %><% if row.profile&.designation.present? %>
-                  <span class="hrl-small hrl-muted"> · <%= row.profile.designation %></span><% end %></span>
+                  <span class="hrl-small hrl-muted"> · <%= row.profile.designation %></span><% end %><% if HrLite.config.attendance_slots && row.profile&.buffer_minutes %>
+                  <span class="hrl-badge hrl-badge--muted">+<%= row.profile.buffer_minutes / 60 %>h buffer · <%= HrLite::EmployeeProfile::BUFFER_REASONS[row.profile.buffer_reason] %></span><% end %></span>
               </td>
               <td data-label="Status"><%= hrl_team_status(row) %></td>
               <td data-label="Hours <%= @date == Date.current ? "today" : "that day" %>" class="hrl-num"><%= hrl_duration(row.day_seconds) %></td>

data/config/routes.rb

@@ -7,6 +7,7 @@ HrLite::Engine.routes.draw do
   resource :attendance, only: :show, controller: "attendance" do
     post :check_in
     post :check_out
+    post :slot
   end
 
   resources :leave_requests, only: %i[index show new create] do
@@ -59,6 +60,7 @@ HrLite::Engine.routes.draw do
     get "overview", to: "overview#index"
     resources :attendances, only: %i[index show update], param: :user_id do
       collection { get :week }
+      member { post :slot; post :unlock_slot; post :remove_penalty }
     end
     resources :leave_requests, only: %i[index show new create edit update] do
       member { post :approve; post :reject; post :cancel }

data/db/migrate/20261013090000_create_hr_lite_attendance_slots.rb

@@ -0,0 +1,16 @@
+class CreateHrLiteAttendanceSlots < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_attendance_slots do |t|
+      t.bigint :user_id, null: false
+      t.date :starts_on, null: false
+      t.date :ends_on, null: false
+      t.string :period, null: false
+      t.integer :start_minute, null: false
+      t.boolean :locked, null: false, default: true
+      t.bigint :set_by_id
+
+      t.timestamps
+    end
+    add_index :hr_lite_attendance_slots, [ :user_id, :starts_on, :ends_on ]
+  end
+end

data/db/migrate/20261013090100_create_hr_lite_attendance_penalties.rb

@@ -0,0 +1,19 @@
+class CreateHrLiteAttendancePenalties < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_attendance_penalties do |t|
+      t.bigint :user_id, null: false
+      t.date :date, null: false
+      t.integer :minutes, null: false
+      t.string :reason, null: false
+      t.bigint :attendance_record_id, null: false
+      t.datetime :removed_at
+      t.bigint :removed_by_id
+      t.text :removal_reason
+
+      t.timestamps
+    end
+    add_index :hr_lite_attendance_penalties, [ :user_id, :date ]
+    add_index :hr_lite_attendance_penalties, [ :attendance_record_id, :reason, :date ], unique: true,
+              name: "index_hr_lite_attendance_penalties_once"
+  end
+end

data/db/migrate/20261013090200_add_buffer_to_hr_lite_employee_profiles.rb

@@ -0,0 +1,7 @@
+class AddBufferToHrLiteEmployeeProfiles < ActiveRecord::Migration[8.1]
+  def change
+    add_column :hr_lite_employee_profiles, :buffer_minutes, :integer
+    add_column :hr_lite_employee_profiles, :buffer_reason, :string
+    add_column :hr_lite_employee_profiles, :buffer_note, :text
+  end
+end

data/lib/hr_lite/configuration.rb

@@ -16,7 +16,9 @@ module HrLite
                   # e.g. 6 — default probation for new hires (admin edits per employee)
                   :probation_months,
                   # true = a punch without GPS is refused (default: recorded and flagged)
-                  :require_punch_location
+                  :require_punch_location,
+                  # true = check-in slots, late penalties and HR buffers (default off)
+                  :attendance_slots
 
     attr_reader :leave_year_start_month, :slip_release_day, :self_regularization, :work_hours
 
@@ -102,6 +104,7 @@ module HrLite
       @slip_release_day       = nil # e.g. 10 = slips open on the 10th of the next month
       @self_regularization    = nil # e.g. { within_days: 2, per_week: 2 } — employees fix their own missed punch
       @require_punch_location = false
+      @attendance_slots       = false
       @work_hours             = nil # e.g. { day: 8, probation_day: 9, week: 40 } — short days close as half days
 
       # Leadership onboarding/offboarding. onboard_user must return a saved

data/lib/hr_lite/version.rb

@@ -1,3 +1,3 @@
 module HrLite
-  VERSION = "0.29.0"
+  VERSION = "0.30.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hr_lite
 version: !ruby/object:Gem::Version
-  version: 0.29.0
+  version: 0.30.0
 platform: ruby
 authors:
 - kshitiz sinha
@@ -168,7 +168,9 @@ files:
 - app/models/hr_lite/approval_step.rb
 - app/models/hr_lite/asset.rb
 - app/models/hr_lite/asset_assignment.rb
+- app/models/hr_lite/attendance_penalty.rb
 - app/models/hr_lite/attendance_record.rb
+- app/models/hr_lite/attendance_slot.rb
 - app/models/hr_lite/audit_log.rb
 - app/models/hr_lite/award.rb
 - app/models/hr_lite/benefit.rb
@@ -234,6 +236,7 @@ files:
 - app/views/hr_lite/admin/appraisals/new.html.erb
 - app/views/hr_lite/admin/assets/index.html.erb
 - app/views/hr_lite/admin/assets/new.html.erb
+- app/views/hr_lite/admin/attendances/_slot.html.erb
 - app/views/hr_lite/admin/attendances/index.html.erb
 - app/views/hr_lite/admin/attendances/show.html.erb
 - app/views/hr_lite/admin/attendances/week.html.erb
@@ -318,7 +321,9 @@ files:
 - app/views/hr_lite/appraisals/show.html.erb
 - app/views/hr_lite/approvals/index.html.erb
 - app/views/hr_lite/attendance/_month_grid.html.erb
+- app/views/hr_lite/attendance/_penalties.html.erb
 - app/views/hr_lite/attendance/_punch_card.html.erb
+- app/views/hr_lite/attendance/_slot.html.erb
 - app/views/hr_lite/attendance/show.html.erb
 - app/views/hr_lite/benefits/index.html.erb
 - app/views/hr_lite/calendar/show.html.erb
@@ -423,6 +428,9 @@ files:
 - db/migrate/20261010100500_grant_hr_lite_tax_to_hr.rb
 - db/migrate/20261010110000_create_hr_lite_ca_reviews.rb
 - db/migrate/20261010110100_seed_hr_lite_ca_role.rb
+- db/migrate/20261013090000_create_hr_lite_attendance_slots.rb
+- db/migrate/20261013090100_create_hr_lite_attendance_penalties.rb
+- db/migrate/20261013090200_add_buffer_to_hr_lite_employee_profiles.rb
 - lib/generators/hr_lite/install/install_generator.rb
 - lib/generators/hr_lite/install/templates/AFTER_INSTALL
 - lib/generators/hr_lite/install/templates/initializer.rb