hr_lite 0.2.0 → 0.3.0

data/app/views/hr_lite/regularization_requests/new.html.erb

@@ -0,0 +1,30 @@
+<% content_for(:page_title) { "Raise a regularization ticket" } %>
+<div class="hrl-page__head">
+  <h1 class="hrl-page__title">Raise a regularization ticket</h1>
+</div>
+
+<section class="hrl-card">
+  <%= form_with model: @request, url: hr_lite.regularization_requests_path, scope: :regularization_request, local: true do |f| %>
+    <%= render "hr_lite/shared/form_errors", record: @request %>
+    <div class="hrl-field">
+      <%= f.label :date, "Which day needs fixing?" %>
+      <%= f.date_field :date, value: @request.date&.strftime("%Y-%m-%d"), max: Date.current %>
+    </div>
+    <div class="hrl-field">
+      <%= f.label :check_in_at, "Actual check-in (leave blank if only check-out is missing)" %>
+      <%= f.datetime_local_field :check_in_at, value: @request.check_in_at&.strftime("%Y-%m-%dT%H:%M"), max: Date.current.strftime("%Y-%m-%dT23:59") %>
+    </div>
+    <div class="hrl-field">
+      <%= f.label :check_out_at, "Actual check-out (leave blank if only check-in is missing)" %>
+      <%= f.datetime_local_field :check_out_at, value: @request.check_out_at&.strftime("%Y-%m-%dT%H:%M"), max: Date.current.strftime("%Y-%m-%dT23:59") %>
+    </div>
+    <div class="hrl-field">
+      <%= f.label :reason, "Why was the punch missed? (required)" %>
+      <%= f.text_area :reason %>
+    </div>
+    <div class="hrl-form-actions">
+      <%= f.submit "Raise ticket", class: "hrl-btn hrl-btn--primary" %>
+      <a class="hrl-btn" href="<%= hr_lite.regularization_requests_path %>">Cancel</a>
+    </div>
+  <% end %>
+</section>

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

@@ -0,0 +1,48 @@
+<% content_for(:page_title) { "Team" } %>
+<div class="hrl-page__head">
+  <h1 class="hrl-page__title">Team — <%= @date == Date.current ? "today" : @date.strftime("%A, %d %B") %></h1>
+  <div class="hrl-page__actions">
+    <a class="hrl-btn" aria-label="Previous day" href="<%= hr_lite.team_path(date: (@date - 1).strftime("%Y-%m-%d")) %>">&larr;</a>
+    <% unless @date == Date.current %>
+      <a class="hrl-btn" href="<%= hr_lite.team_path %>">Today</a>
+    <% end %>
+    <% if @date < Date.current %>
+      <a class="hrl-btn" aria-label="Next day" href="<%= hr_lite.team_path(date: (@date + 1).strftime("%Y-%m-%d")) %>">&rarr;</a>
+    <% end %>
+  </div>
+</div>
+
+<% kpis = @board.kpis %>
+<div class="hrl-kpis">
+  <div class="hrl-kpi"><div class="hrl-kpi__value"><%= kpis[:checked_in] %></div><div class="hrl-kpi__label">Checked in</div></div>
+  <div class="hrl-kpi"><div class="hrl-kpi__value"><%= kpis[:on_leave] %></div><div class="hrl-kpi__label">On leave</div></div>
+  <div class="hrl-kpi"><div class="hrl-kpi__value"><%= kpis[:not_in] %></div><div class="hrl-kpi__label">Not in</div></div>
+  <div class="hrl-kpi"><div class="hrl-kpi__value"><%= @board.rows.size %></div><div class="hrl-kpi__label">Team size</div></div>
+</div>
+
+<section class="hrl-card">
+  <% if @board.rows.any? %>
+    <div class="hrl-table-wrap">
+      <table class="hrl-table hrl-table--stack">
+        <thead><tr><th>Name</th><th>Status</th><th>Hours <%= @date == Date.current ? "today" : "that day" %></th><th>Hours this month</th></tr></thead>
+        <tbody>
+          <% @board.rows.each do |row| %>
+            <tr>
+              <td data-label="Name">
+                <span><strong><%= hr_display_name(row.user) %></strong><% if row.profile&.designation.present? %>
+                  <span class="hrl-small hrl-muted"> · <%= row.profile.designation %></span><% end %></span>
+              </td>
+              <td data-label="Status"><%= hrl_team_status(row) %></td>
+              <td data-label="Hours" class="hrl-num"><%= hrl_duration(row.day_seconds) %></td>
+              <td data-label="Hours this month" class="hrl-num"><%= hrl_duration(row.month_seconds) %></td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  <% else %>
+    <p class="hrl-card--empty">Nobody to show for this date.</p>
+  <% end %>
+  <p class="hrl-small hrl-muted hrl-mt">Forgot a punch yourself?
+    <a href="<%= hr_lite.new_regularization_request_path %>">Raise a regularization ticket</a>.</p>
+</section>

data/app/views/layouts/hr_lite/application.html.erb

@@ -31,7 +31,7 @@
         <% end %>
 
         <% if hr_admin? || hr_leadership? %>
-          <span class="hrl-side__group">Team</span>
+          <span class="hrl-side__group">Manage</span>
           <% hrl_nav_items(HrLite::ApplicationHelper::ADMIN_NAV_ITEMS).each do |item| %>
             <%= hrl_nav_link(item) %>
           <% end %>

data/config/routes.rb

@@ -13,6 +13,13 @@ HrLite::Engine.routes.draw do
     member { post :cancel }
   end
   resources :leave_balances, only: :index
+  resources :comp_off_requests, only: %i[index new create] do
+    member { post :cancel }
+  end
+  resources :regularization_requests, only: %i[index new create] do
+    member { post :cancel }
+  end
+  get "team", to: "team#show"
   resources :holidays, only: :index
   get "calendar", to: "calendar#show"
   resources :salary_slips, only: %i[index show]
@@ -32,6 +39,12 @@ HrLite::Engine.routes.draw do
     resources :leave_balances, only: :index do
       collection { post :adjust }
     end
+    resources :comp_off_requests, only: %i[index show] do
+      member { post :approve; post :reject }
+    end
+    resources :regularization_requests, only: %i[index show] do
+      member { post :approve; post :reject }
+    end
     resources :leave_types, except: :show
     resources :office_locations, except: :show
     resources :holidays, only: %i[index create update destroy] do

data/db/migrate/20260719104315_add_comp_off_to_hr_lite_leave_types.rb

@@ -0,0 +1,6 @@
+class AddCompOffToHrLiteLeaveTypes < ActiveRecord::Migration[8.0]
+  def change
+    # Marks which leave type approved comp-off requests credit into.
+    add_column :hr_lite_leave_types, :comp_off, :boolean, null: false, default: false
+  end
+end

data/db/migrate/20260719104316_create_hr_lite_comp_off_requests.rb

@@ -0,0 +1,24 @@
+class CreateHrLiteCompOffRequests < ActiveRecord::Migration[8.0]
+  def change
+    create_table :hr_lite_comp_off_requests do |t|
+      t.bigint :user_id, null: false
+      t.date :date_worked, null: false
+      t.boolean :half_day, null: false, default: false
+      t.text :reason, null: false
+      t.string :status, null: false, default: "pending"
+      t.bigint :decided_by_id
+      t.datetime :decided_at
+      t.text :decision_note
+
+      t.timestamps
+    end
+    add_index :hr_lite_comp_off_requests, [ :user_id, :status ]
+    add_index :hr_lite_comp_off_requests, [ :user_id, :date_worked ]
+    add_index :hr_lite_comp_off_requests, [ :status, :date_worked ]
+    # Two tabs / a double-tap racing past the app-level duplicate check
+    # must not create two live requests for one worked day.
+    add_index :hr_lite_comp_off_requests, [ :user_id, :date_worked ],
+              unique: true, where: "status IN ('pending', 'approved')",
+              name: "index_hr_lite_comp_off_requests_live_uniqueness"
+  end
+end

data/db/migrate/20260719104317_create_hr_lite_regularization_requests.rb

@@ -0,0 +1,20 @@
+class CreateHrLiteRegularizationRequests < ActiveRecord::Migration[8.0]
+  def change
+    create_table :hr_lite_regularization_requests do |t|
+      t.bigint :user_id, null: false
+      t.date :date, null: false
+      t.datetime :check_in_at
+      t.datetime :check_out_at
+      t.text :reason, null: false
+      t.string :status, null: false, default: "pending"
+      t.bigint :decided_by_id
+      t.datetime :decided_at
+      t.text :decision_note
+
+      t.timestamps
+    end
+    add_index :hr_lite_regularization_requests, [ :user_id, :status ]
+    add_index :hr_lite_regularization_requests, [ :user_id, :date ]
+    add_index :hr_lite_regularization_requests, [ :status, :date ]
+  end
+end

data/lib/hr_lite/configuration.rb

@@ -9,7 +9,7 @@ module HrLite
                   :time_zone, :currency_symbol, :on_designation_change,
                   :leadership_emails, :leadership_check, :extra_stylesheets,
                   :mailer_from, :public_url_base, :notification_matrix, :back_link,
-                  :onboard_user, :offboard_user
+                  :onboard_user, :offboard_user, :invite_url_for
 
     # 0.1.0 pre-release name for public_url_base; kept as an alias so early
     # adopters' initializers don't break.
@@ -58,6 +58,10 @@ module HrLite
         klass.create!(attributes)
       }
       @offboard_user = ->(user) { }
+      # Optional: return an absolute set-your-password URL for a freshly
+      # onboarded user (e.g. a Devise reset link). When present, the welcome
+      # email carries it and leadership never needs to hand over a password.
+      @invite_url_for = nil
     end
   end
 

data/lib/hr_lite/notifications.rb

@@ -29,15 +29,27 @@ module HrLite
       "resignation.accepted"  => { bell: true,  email: true,  leadership_email: true,  leadership_bell: false },
       "resignation.withdrawn" => { bell: true,  email: false, leadership_email: true,  leadership_bell: false },
       "employee.onboarded"    => { bell: true,  email: true,  leadership_email: true,  leadership_bell: false },
-      "payroll.draft_ready"   => { bell: false, email: false, leadership_email: true,  leadership_bell: true  }
+      "payroll.draft_ready"   => { bell: false, email: false, leadership_email: true,  leadership_bell: true  },
+      "leave.team_notice"     => { bell: true,  email: true,  leadership_email: false, leadership_bell: false },
+      "comp_off.requested"    => { bell: true,  email: false, leadership_email: true,  leadership_bell: true  },
+      "comp_off.approved"     => { bell: true,  email: true,  leadership_email: true,  leadership_bell: false },
+      "comp_off.rejected"     => { bell: true,  email: true,  leadership_email: false, leadership_bell: false },
+      "comp_off.cancelled"    => { bell: true,  email: false, leadership_email: true,  leadership_bell: false },
+      "regularization.requested" => { bell: true, email: false, leadership_email: true,  leadership_bell: false },
+      "regularization.approved"  => { bell: true, email: true,  leadership_email: true,  leadership_bell: false },
+      "regularization.rejected"  => { bell: true, email: true,  leadership_email: false, leadership_bell: false },
+      "regularization.cancelled" => { bell: true, email: false, leadership_email: true,  leadership_bell: false }
     }.freeze
 
     class << self
+      # DEFAULT under the host override: a host matrix pinned on an older
+      # gem version keeps working when new events ship (rows it doesn't
+      # know about fall back to the defaults instead of vanishing).
       def matrix
-        HrLite.config.notification_matrix || DEFAULT_MATRIX
+        DEFAULT_MATRIX.merge(HrLite.config.notification_matrix || {})
       end
 
-      def publish(event, title:, body: nil, path: nil, bell_to: [], email_to: [], lines: [], diff: nil)
+      def publish(event, title:, body: nil, path: nil, bell_to: [], email_to: [], lines: [], diff: nil, link_url: nil)
         row = matrix[event.to_s]
         unless row
           Rails.logger.warn("[hr_lite] unknown notification event #{event}")
@@ -45,7 +57,7 @@ module HrLite
         end
 
         deliver_bells(event, row, bell_to, title, body, path)
-        deliver_emails(row, email_to, title, body, path, lines)
+        deliver_emails(row, email_to, title, body, path, lines, link_url)
         deliver_leadership_email(event, row, title, body, path, lines, diff)
         deliver_leadership_bells(event, row, bell_to, title, body, path)
         nil
@@ -61,14 +73,15 @@ module HrLite
         end
       end
 
-      def deliver_emails(row, email_to, title, body, path, lines)
+      def deliver_emails(row, email_to, title, body, path, lines, link_url = nil)
         return unless row[:email]
 
         Array(email_to).compact.uniq.each do |user|
           next if user.email.blank?
 
           EventMailer.event(to: user.email, subject: title, heading: title,
-                            body: body, lines: lines, path: path).deliver_later
+                            body: body, lines: lines, path: path,
+                            link_url: link_url).deliver_later
         end
       rescue => e
         Rails.logger.error("[hr_lite] event email failed: #{e.class}: #{e.message}")

data/lib/hr_lite/seeds.rb

@@ -7,13 +7,28 @@ module HrLite
       { code: "SL", name: "Sick leave", color: "#f59e0b", paid: true, annual_quota: 6, accrual: "yearly_upfront", carry_forward_cap: 0, position: 2 },
       { code: "EL", name: "Earned leave", color: "#10b981", paid: true, annual_quota: 15, accrual: "monthly", carry_forward_cap: 30, position: 3 },
       { code: "LWP", name: "Leave without pay", color: "#6b7280", paid: false, annual_quota: nil, accrual: "yearly_upfront", carry_forward_cap: 0, position: 4 },
-      { code: "CO", name: "Comp off", color: "#8b5cf6", paid: true, annual_quota: 0, accrual: "yearly_upfront", carry_forward_cap: 0, position: 5 }
+      { code: "CO", name: "Comp off", color: "#8b5cf6", paid: true, annual_quota: 0, accrual: "yearly_upfront", carry_forward_cap: 0, position: 5, comp_off: true }
     ].freeze
 
     def self.run!
       seed_leave_types! + seed_holidays!
     end
 
+    # Deliberately NOT auto-run from run!: an operator unticking every
+    # comp-off flag to disable the feature must stay disabled across
+    # deploys ("re-runs never overwrite operator edits"). Pre-0.3.0
+    # installs call this once from their own upgrade seed, or just tick
+    # the box under Settings -> Leave types.
+    def self.seed_comp_off_flag!
+      return [] if LeaveType.exists?(comp_off: true)
+
+      type = LeaveType.find_by(code: "CO")
+      return [] if type.nil?
+
+      type.update!(comp_off: true)
+      [ "comp_off flag on CO" ]
+    end
+
     def self.seed_leave_types!
       DEFAULT_LEAVE_TYPES.filter_map do |attrs|
         next if LeaveType.exists?(code: attrs[:code])

data/lib/hr_lite/version.rb

@@ -1,3 +1,3 @@
 module HrLite
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/hr_lite.rb

@@ -57,6 +57,13 @@ module HrLite
       config.employees_scope.call.sort_by { |u| display_name(u).downcase }
     end
 
+    # employees minus anyone whose profile says they have exited — user
+    # accounts outlive employment (slip access), broadcasts must not.
+    def active_employees(on: Date.current)
+      exits = HrLite::EmployeeProfile.where.not(date_of_exit: nil).pluck(:user_id, :date_of_exit).to_h
+      employees.select { |u| exits[u.id].nil? || exits[u.id] >= on }
+    end
+
     def display_name(user)
       return "" if user.nil?
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hr_lite
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - kshitiz sinha
@@ -58,6 +58,7 @@ files:
 - app/controllers/hr_lite/admin/attendances_controller.rb
 - app/controllers/hr_lite/admin/audit_logs_controller.rb
 - app/controllers/hr_lite/admin/base_controller.rb
+- app/controllers/hr_lite/admin/comp_off_requests_controller.rb
 - app/controllers/hr_lite/admin/designation_changes_controller.rb
 - app/controllers/hr_lite/admin/employees_controller.rb
 - app/controllers/hr_lite/admin/holidays_controller.rb
@@ -68,6 +69,7 @@ files:
 - app/controllers/hr_lite/admin/office_locations_controller.rb
 - app/controllers/hr_lite/admin/overview_controller.rb
 - app/controllers/hr_lite/admin/payroll_runs_controller.rb
+- app/controllers/hr_lite/admin/regularization_requests_controller.rb
 - app/controllers/hr_lite/admin/resignations_controller.rb
 - app/controllers/hr_lite/admin/salary_slips_controller.rb
 - app/controllers/hr_lite/admin/salary_structures_controller.rb
@@ -77,14 +79,17 @@ files:
 - app/controllers/hr_lite/attendance_controller.rb
 - app/controllers/hr_lite/calendar_controller.rb
 - app/controllers/hr_lite/career_controller.rb
+- app/controllers/hr_lite/comp_off_requests_controller.rb
 - app/controllers/hr_lite/employee_profiles_controller.rb
 - app/controllers/hr_lite/holidays_controller.rb
 - app/controllers/hr_lite/home_controller.rb
 - app/controllers/hr_lite/kudos_controller.rb
 - app/controllers/hr_lite/leave_balances_controller.rb
 - app/controllers/hr_lite/leave_requests_controller.rb
+- app/controllers/hr_lite/regularization_requests_controller.rb
 - app/controllers/hr_lite/resignations_controller.rb
 - app/controllers/hr_lite/salary_slips_controller.rb
+- app/controllers/hr_lite/team_controller.rb
 - app/controllers/hr_lite/users_controller.rb
 - app/helpers/hr_lite/application_helper.rb
 - app/jobs/hr_lite/application_job.rb
@@ -99,6 +104,7 @@ files:
 - app/models/hr_lite/appraisal.rb
 - app/models/hr_lite/attendance_record.rb
 - app/models/hr_lite/audit_log.rb
+- app/models/hr_lite/comp_off_request.rb
 - app/models/hr_lite/designation_change.rb
 - app/models/hr_lite/employee_profile.rb
 - app/models/hr_lite/holiday.rb
@@ -109,6 +115,7 @@ files:
 - app/models/hr_lite/leave_type.rb
 - app/models/hr_lite/office_location.rb
 - app/models/hr_lite/payroll_run.rb
+- app/models/hr_lite/regularization_request.rb
 - app/models/hr_lite/resignation.rb
 - app/models/hr_lite/salary_slip.rb
 - app/models/hr_lite/salary_structure.rb
@@ -126,6 +133,7 @@ files:
 - app/services/hr_lite/payroll_run_processor.rb
 - app/services/hr_lite/pdf_renderer.rb
 - app/services/hr_lite/slip_builder.rb
+- app/services/hr_lite/team_day.rb
 - app/services/hr_lite/working_calendar.rb
 - app/views/hr_lite/admin/appraisals/_form.html.erb
 - app/views/hr_lite/admin/appraisals/edit.html.erb
@@ -133,6 +141,8 @@ files:
 - app/views/hr_lite/admin/attendances/index.html.erb
 - app/views/hr_lite/admin/attendances/show.html.erb
 - app/views/hr_lite/admin/audit_logs/index.html.erb
+- app/views/hr_lite/admin/comp_off_requests/index.html.erb
+- app/views/hr_lite/admin/comp_off_requests/show.html.erb
 - app/views/hr_lite/admin/designation_changes/new.html.erb
 - app/views/hr_lite/admin/employees/_form.html.erb
 - app/views/hr_lite/admin/employees/edit.html.erb
@@ -155,11 +165,14 @@ files:
 - app/views/hr_lite/admin/payroll_runs/index.html.erb
 - app/views/hr_lite/admin/payroll_runs/new.html.erb
 - app/views/hr_lite/admin/payroll_runs/show.html.erb
+- app/views/hr_lite/admin/regularization_requests/index.html.erb
+- app/views/hr_lite/admin/regularization_requests/show.html.erb
 - app/views/hr_lite/admin/salary_slips/show.html.erb
 - app/views/hr_lite/admin/salary_structures/_form.html.erb
 - app/views/hr_lite/admin/salary_structures/edit.html.erb
 - app/views/hr_lite/admin/salary_structures/new.html.erb
 - app/views/hr_lite/admin/settings/edit.html.erb
+- app/views/hr_lite/admin/shared/_approvals_tabs.html.erb
 - app/views/hr_lite/appraisals/index.html.erb
 - app/views/hr_lite/appraisals/show.html.erb
 - app/views/hr_lite/attendance/_month_grid.html.erb
@@ -167,6 +180,8 @@ files:
 - app/views/hr_lite/attendance/show.html.erb
 - app/views/hr_lite/calendar/show.html.erb
 - app/views/hr_lite/career/show.html.erb
+- app/views/hr_lite/comp_off_requests/index.html.erb
+- app/views/hr_lite/comp_off_requests/new.html.erb
 - app/views/hr_lite/employee_profiles/show.html.erb
 - app/views/hr_lite/event_mailer/event.html.erb
 - app/views/hr_lite/event_mailer/event.text.erb
@@ -182,6 +197,8 @@ files:
 - app/views/hr_lite/leave_requests/index.html.erb
 - app/views/hr_lite/leave_requests/new.html.erb
 - app/views/hr_lite/leave_requests/show.html.erb
+- app/views/hr_lite/regularization_requests/index.html.erb
+- app/views/hr_lite/regularization_requests/new.html.erb
 - app/views/hr_lite/resignations/show.html.erb
 - app/views/hr_lite/salary_slips/_slip_detail.html.erb
 - app/views/hr_lite/salary_slips/index.html.erb
@@ -189,6 +206,7 @@ files:
 - app/views/hr_lite/salary_slips/show.html.erb
 - app/views/hr_lite/shared/_form_errors.html.erb
 - app/views/hr_lite/shared/_pagination.html.erb
+- app/views/hr_lite/team/show.html.erb
 - app/views/layouts/hr_lite/application.html.erb
 - app/views/layouts/hr_lite/mailer.html.erb
 - app/views/layouts/hr_lite/mailer.text.erb
@@ -211,6 +229,9 @@ files:
 - db/migrate/20260718195953_create_hr_lite_appraisals.rb
 - db/migrate/20260718195954_create_hr_lite_designation_changes.rb
 - db/migrate/20260719065841_create_hr_lite_resignations.rb
+- db/migrate/20260719104315_add_comp_off_to_hr_lite_leave_types.rb
+- db/migrate/20260719104316_create_hr_lite_comp_off_requests.rb
+- db/migrate/20260719104317_create_hr_lite_regularization_requests.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