hr_lite 0.31.0 → 0.35.0

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

@@ -43,7 +43,7 @@
       <dt>Worked</dt><dd><%= hrl_duration(rec&.worked_duration) %></dd>
       <% if part %><dt>Half</dt><dd><%= HrLite::DAY_PARTS.rassoc(part)&.first %></dd><% end %>
       <% if leave %><dt>Leave</dt><dd><%= leave.leave_type.name %></dd><% end %>
-      <% if @day_info.kind == :holiday %><dt>Holiday</dt><dd><%= HrLite::Holiday.find_by(date: @day)&.name %></dd><% end %>
+      <% if @day_info.kind == :holiday %><dt>Holiday</dt><dd><%= HrLite::Holiday.company_wide.for_office(HrLite::WorkingCalendar.office_for(hr_current_user.id)).where(date: @day).pick(:name) %></dd><% end %>
       <% if rec&.flagged? %><dt>Flag</dt><dd><%= rec.flag_note %></dd><% end %>
       <% if @day_ticket %><dt>Ticket</dt><dd><%= hrl_request_status_badge(@day_ticket.status) %> <%= @day_ticket.times_label %></dd><% end %>
     </dl>
@@ -55,4 +55,7 @@
 
 <% content_for :scripts do %>
   <%= javascript_include_tag "hr_lite/geo_punch", defer: true %>
+  <%= javascript_include_tag "hr_lite/countdown", defer: true %>
+  <%= javascript_include_tag "hr_lite/crm_picker", defer: true %>
+  <%= javascript_include_tag "hr_lite/emoji_pick", defer: true %>
 <% end %>

data/app/views/hr_lite/holidays/_next_holiday.html.erb

@@ -1,6 +1,6 @@
 <section class="hrl-card">
   <h2 class="hrl-card__title">Upcoming holidays</h2>
-  <% holidays = HrLite::Holiday.company_wide.upcoming.where(date: ..Date.current + 60).limit(3).to_a %>
+  <% holidays = HrLite::Holiday.company_wide.for_office(HrLite::WorkingCalendar.office_for(hr_current_user.id)).upcoming.where(date: ..Date.current + 60).limit(3).to_a %>
   <% if holidays.any? %>
     <div class="hrl-feed">
       <% holidays.each do |holiday| %>

data/app/views/hr_lite/home/_today_checkins.html.erb

@@ -0,0 +1,31 @@
+<%# Today's check-ins: on time, late, not in yet. Hover or tap a person for times. %>
+<% groups = HrLite::TodayCheckins.new.groups
+   tip = ->(p) do
+     r = p.record
+     parts = [ hr_display_name(p.user) ]
+     if r
+       parts << "In #{r.check_in_at.strftime('%H:%M')}#{" (#{p.late_minutes} min late)" if p.late?}"
+       parts << (r.check_out_at ? "Out #{r.check_out_at.strftime('%H:%M')} · #{hrl_duration(r.worked_duration)} worked" : "#{hrl_duration(Time.current - r.check_in_at)} so far")
+     else
+       parts << "Not checked in yet"
+     end
+     parts.join(" · ")
+   end %>
+<section class="hrl-card">
+  <h2 class="hrl-card__title">Today's check-ins</h2>
+  <% [ [ :on_time, "On time", "ok" ], [ :late, "Late", "warn" ], [ :not_in, "Not in yet", "muted" ] ].each do |key, label, tone| %>
+    <div class="hrl-checkins">
+      <p class="hrl-small"><span class="hrl-badge hrl-badge--<%= tone %>"><%= label %> · <%= groups[key].size %></span></p>
+      <% if groups[key].any? %>
+        <ul class="hrl-checkins__people">
+          <% groups[key].each do |p| %>
+            <li><button type="button" class="hrl-person hrl-person--<%= tone %>" data-hrl-tip="<%= tip.(p) %>" title="<%= tip.(p) %>" aria-label="<%= tip.(p) %>">
+              <%= hr_display_name(p.user).to_s.scan(/[[:alpha:]]+/).first(2).map { |w| w[0] }.join.upcase %>
+            </button></li>
+          <% end %>
+        </ul>
+      <% end %>
+    </div>
+  <% end %>
+  <a class="hrl-card__link" href="<%= hr_lite.team_path %>">Team board</a>
+</section>

data/app/views/hr_lite/home/index.html.erb

@@ -30,6 +30,7 @@
       <% end %>
     </section>
   <% end %>
+  <%= render "hr_lite/home/today_checkins" %>
   <%= render "hr_lite/holidays/next_holiday" %>
 
   <section class="hrl-card">
@@ -72,4 +73,8 @@
 
 <% content_for :scripts do %>
   <%= javascript_include_tag "hr_lite/geo_punch", defer: true %>
+  <%= javascript_include_tag "hr_lite/chart_tip", defer: true %>
+  <%= javascript_include_tag "hr_lite/countdown", defer: true %>
+  <%= javascript_include_tag "hr_lite/crm_picker", defer: true %>
+  <%= javascript_include_tag "hr_lite/emoji_pick", defer: true %>
 <% end %>

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

@@ -20,19 +20,40 @@
   <div class="hrl-kpi"><div class="hrl-kpi__value"><%= @board.rows.size %></div><div class="hrl-kpi__label">Team size</div></div>
 </div>
 
+<% if @statuses %>
+  <section class="hrl-card">
+    <%= form_with url: hr_lite.team_path, method: :get, local: true, class: "hrl-row" do %>
+      <% if @departments.any? %>
+        <div class="hrl-field"><label for="team-dept">Department</label><%= select_tag :department, options_for_select(@departments, params[:department]), include_blank: "All", id: "team-dept" %></div>
+      <% end %>
+      <div class="hrl-field"><label for="team-mode">Mode</label><%= select_tag :mode, options_for_select(HrLite::WorkModeEvent::MODES.map { |k, v| [ v[0], k ] } + HrLite::WorkStatus::DERIVED.map { |k, v| [ v, k ] }.reject { |_, k| k == "offline" }, @mode), include_blank: "All", id: "team-mode" %></div>
+      <div class="hrl-field"><label for="team-avail">Availability</label><%= select_tag :availability, options_for_select([ [ "Available", "available" ], [ "Not available", "unavailable" ] ], @availability), include_blank: "All", id: "team-avail" %></div>
+      <div class="hrl-form-actions"><button type="submit" class="hrl-btn">Filter</button></div>
+    <% end %>
+  </section>
+<% end %>
+
 <section class="hrl-card">
-  <% if @board.rows.any? %>
+  <% rows = @rows || @board.rows %>
+  <% if 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>
+        <thead><tr><th>Name</th><% if @statuses %><th>Now</th><% end %><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| %>
+          <% rows.each do |row| %>
             <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 %><% 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>
+              <% if (st = @statuses&.dig(row.user.id)) %>
+                <td data-label="Now"><span class="hrl-modes"><%= hrl_status_icons(st) %></span>
+                  <span class="hrl-small"><%= st.primary.place || st.primary.label %><% if st.overlay %> · <%= st.overlay.label %><% end %>
+                    <% if (till = st.overlay&.until || (st.primary.until if st.primary.until.respond_to?(:hour))) %> · until <%= till.strftime("%H:%M") %><% end %></span>
+                  <% if st.updated_at %><span class="hrl-small hrl-muted"> · since <%= st.updated_at.strftime("%H:%M") %></span><% end %>
+                  <% if st.custom %><div class="hrl-custom-status hrl-small"><% if st.custom.emoji %><span aria-hidden="true"><%= st.custom.emoji %></span> <% end %><%= st.custom.title %></div><% end %></td>
+              <% end %>
               <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>
               <td data-label="Hours this month" class="hrl-num"><%= hrl_duration(row.month_seconds) %></td>
@@ -42,7 +63,7 @@
       </table>
     </div>
   <% else %>
-    <p class="hrl-card--empty">Nobody to show for this date.</p>
+    <p class="hrl-card--empty">Nobody to show<%= @rows ? " for these filters" : " for this date" %>.</p>
   <% end %>
   <p class="hrl-small hrl-muted hrl-mt">Forgot a punch yourself?
     <a class="hrl-card__link" href="<%= hr_lite.new_regularization_request_path %>">Raise a regularization ticket</a></p>

data/app/views/hr_lite/work_locations/index.html.erb

@@ -0,0 +1,52 @@
+<% content_for(:page_title) { "WFH locations" } %>
+<% content_for(:back, "Attendance") %>
+<div class="hrl-page__head">
+  <h1 class="hrl-page__title">My WFH locations</h1>
+</div>
+
+<section class="hrl-card">
+  <p class="hrl-small hrl-muted">On an approved WFH day you check in within <%= HrLite::WorkLocation::FENCE_M %> m of your active location.
+    Register up to <%= HrLite::WorkLocation::MAX_LIVE %> places; HR approves each one. Your location is read only when you check in or tap
+    "Register here" — never tracked in between. Teammates see "Home", never the address.</p>
+  <% if @locations.any? %>
+    <% @locations.each do |location| %>
+      <div class="hrl-feed__item hrl-row">
+        <div class="hrl-feed__body">
+          <strong><%= location.name %></strong>
+          <% if location.active? %><span class="hrl-badge hrl-badge--ok">Active</span><% end %>
+          <%= hrl_request_status_badge(location.status) %>
+          <% if location.address.present? %><div class="hrl-small hrl-muted"><%= location.address %></div><% end %>
+          <% if location.decision_note.present? %><div class="hrl-small hrl-muted">HR: <%= location.decision_note %></div><% end %>
+        </div>
+        <% if location.approved? && !location.active? %>
+          <%= button_to "Use this", hr_lite.activate_work_location_path(location), method: :post, class: "hrl-btn" %>
+        <% end %>
+        <%= button_to "Remove", hr_lite.remove_work_location_path(location), method: :post, class: "hrl-btn hrl-btn--danger",
+                      form: { data: { turbo_confirm: "Remove #{location.name}?" } } %>
+      </div>
+    <% end %>
+  <% else %>
+    <p class="hrl-card--empty">No locations yet.</p>
+  <% end %>
+</section>
+
+<%= render "hr_lite/shared/form_errors", record: @location %>
+
+<% if @locations.size < HrLite::WorkLocation::MAX_LIVE %>
+  <section class="hrl-card">
+    <h2 class="hrl-card__title">Register where you are now</h2>
+    <%= form_with url: hr_lite.work_locations_path, method: :post, local: true,
+                  html: { data: { "hrl-geo-punch": true, "hrl-geo-required": true } } do %>
+      <div class="hrl-field"><label for="loc-name">Name</label><%= text_field_tag :name, @location.name, required: true, maxlength: 60, placeholder: "Home", id: "loc-name" %></div>
+      <div class="hrl-field"><label for="loc-address">Address or landmark (optional, HR only)</label><%= text_field_tag :address, @location.address, maxlength: 200, id: "loc-address" %></div>
+      <input type="hidden" name="lat"><input type="hidden" name="lng">
+      <input type="hidden" name="accuracy_m"><input type="hidden" name="geo_status">
+      <button type="submit" class="hrl-btn hrl-btn--primary hrl-btn--block">Register here</button>
+      <p class="hrl-small hrl-muted" data-hrl-geo-status role="status" aria-live="polite"></p>
+    <% end %>
+  </section>
+<% end %>
+
+<% content_for :scripts do %>
+  <%= javascript_include_tag "hr_lite/geo_punch", defer: true %>
+<% end %>

data/app/views/hr_lite/work_time/_bars.html.erb

@@ -0,0 +1,44 @@
+<%# Stacked bars per bucket (day / week / month), Offline left out. %>
+<% buckets = result.by_bucket
+   totals = buckets.transform_values { |m| m.except("offline").values.sum }
+   max = [ totals.values.max.to_f, 1 ].max
+   w = 12; gap = 4; h = 100
+   fmt = { day: "%-d", week: "%-d %b", month: "%b" }[period.bucket] %>
+<section class="hrl-card">
+  <h2 class="hrl-card__title">By <%= period.bucket %></h2>
+  <div class="hrl-chart-scroll">
+    <svg class="hrl-bars" viewBox="0 0 <%= buckets.size * (w + gap) %> <%= h + 14 %>" role="img"
+         aria-label="Time per <%= period.bucket %> stacked by work mode; tallest bar <%= hrl_duration(max) %>; details in the table">
+      <% buckets.each_with_index do |(key, modes), i| %>
+        <% x = i * (w + gap); y = h %>
+        <a href="<%= path.(period: period.bucket == :day ? "day" : (period.bucket == :week ? "week" : "month"), date: key) %>">
+          <% modes.except("offline").sort.each do |mode, secs| %>
+            <% next unless secs.positive? %>
+            <% bh = secs / max * h; y -= bh %>
+            <rect x="<%= x %>" y="<%= y.round(2) %>" width="<%= w %>" height="<%= bh.round(2) %>" class="hrl-fill--<%= mode %>">
+              <title><%= key.strftime(fmt) %> · <%= label.(mode) %>: <%= hrl_duration(secs) %></title>
+            </rect>
+          <% end %>
+          <rect x="<%= x %>" y="0" width="<%= w %>" height="<%= h %>" fill="transparent"><title><%= key.strftime(fmt) %>: <%= hrl_duration(totals[key]) %> — open</title></rect>
+        </a>
+        <% if buckets.size <= 16 || (i % 7).zero? %>
+          <text x="<%= x + w / 2.0 %>" y="<%= h + 11 %>" text-anchor="middle" class="hrl-bars__label"><%= key.strftime(fmt) %></text>
+        <% end %>
+      <% end %>
+    </svg>
+  </div>
+  <details class="hrl-small">
+    <summary>Show as a table</summary>
+    <table class="hrl-table">
+      <thead><tr><th><%= period.bucket.to_s.capitalize %></th><th class="hrl-num">Working</th><th class="hrl-num">Breaks</th><th class="hrl-num">Total</th></tr></thead>
+      <tbody>
+        <% buckets.each do |key, modes| %>
+          <tr><td><%= key.strftime(period.bucket == :day ? "%a %-d %b" : fmt) %></td>
+            <td class="hrl-num"><%= hrl_duration(HrLite::WorkModeDurations::WORKING.sum { |m| modes[m] }) %></td>
+            <td class="hrl-num"><%= hrl_duration(HrLite::WorkModeDurations::BREAKS.sum { |m| modes[m] }) %></td>
+            <td class="hrl-num"><%= hrl_duration(totals[key]) %></td></tr>
+        <% end %>
+      </tbody>
+    </table>
+  </details>
+</section>

data/app/views/hr_lite/work_time/_donut.html.erb

@@ -0,0 +1,36 @@
+<%# Share of tracked time (working + breaks + out of office; Offline excluded). %>
+<% total = result.tracked
+   modes = result.by_mode.except("offline").select { |_, s| s.positive? }.sort_by { |_, s| -s }
+   counts = result.segments.group_by(&:mode).transform_values(&:size)
+   offset = 25.0 %>
+<section class="hrl-card">
+  <h2 class="hrl-card__title">Where the time went</h2>
+  <% if total.positive? %>
+    <div class="hrl-chart-row">
+      <svg class="hrl-donut" viewBox="0 0 42 42" role="img" aria-label="Share of tracked time by work mode; details in the table">
+        <circle cx="21" cy="21" r="15.915" fill="none" class="hrl-donut__track" stroke-width="6"></circle>
+        <% modes.each do |mode, secs| %>
+          <% pct = secs * 100.0 / total %>
+          <circle cx="21" cy="21" r="15.915" fill="none" stroke-width="6" class="hrl-stroke--<%= mode %>" data-hrl-tip tabindex="0"
+                  stroke-dasharray="<%= pct.round(3) %> <%= (100 - pct).round(3) %>" stroke-dashoffset="<%= offset.round(3) %>">
+            <title><%= label.(mode) %>: <%= hrl_duration(secs) %> (<%= pct.round %>%)</title>
+          </circle>
+          <% offset -= pct %>
+        <% end %>
+      </svg>
+      <table class="hrl-table hrl-small">
+        <thead><tr><th>Mode</th><th class="hrl-num">Time</th><th class="hrl-num">Share</th><th class="hrl-num">Stretches</th></tr></thead>
+        <tbody>
+          <% modes.each do |mode, secs| %>
+            <tr><td><span class="hrl-swatch hrl-fill-bg--<%= mode %>" aria-hidden="true"></span> <%= label.(mode) %></td>
+              <td class="hrl-num"><%= hrl_duration(secs) %></td><td class="hrl-num"><%= (secs * 100.0 / total).round %>%</td>
+              <td class="hrl-num"><%= counts[mode] %></td></tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+    <p class="hrl-small hrl-muted">Shares are of tracked time (<%= hrl_duration(total) %>: working, breaks and out of office). Offline (<%= hrl_duration(result.offline) %>) is not included.</p>
+  <% else %>
+    <p class="hrl-card--empty">Only offline time recorded.</p>
+  <% end %>
+</section>

data/app/views/hr_lite/work_time/_report.html.erb

@@ -0,0 +1,74 @@
+<%# locals: result (WorkModeDurations::Result), period, path (->(params) { url }), records, names, keep, timeline (all optional) %>
+<% path = local_assigns[:path]
+   records = local_assigns[:records] || []
+   names = local_assigns[:names]
+   label = ->(m) { HrLite::WorkModeEvent.label(m) || m.humanize } %>
+
+<section class="hrl-card">
+  <div class="hrl-row hrl-row--tabs hrl-row--mb">
+    <% HrLite::WorkModeDurations::Period::KINDS.excluding("custom").each do |kind| %>
+      <a class="hrl-btn <%= 'hrl-btn--primary' if period.kind == kind %>" <%= 'aria-current="page"'.html_safe if period.kind == kind %>
+         href="<%= path.(period: kind, date: period.from) %>"><%= kind.capitalize %></a>
+    <% end %>
+  </div>
+  <div class="hrl-row hrl-row--mb">
+    <% unless period.kind == "custom" %>
+      <a class="hrl-btn" href="<%= path.(period: period.kind, date: period.shift(-1)) %>" aria-label="Previous <%= period.kind %>">&lsaquo;</a>
+    <% end %>
+    <strong><%= period.label %></strong>
+    <% if period.kind != "custom" && period.to < Date.current %>
+      <a class="hrl-btn" href="<%= path.(period: period.kind, date: period.shift(1)) %>" aria-label="Next <%= period.kind %>">&rsaquo;</a>
+    <% end %>
+  </div>
+  <%= form_with url: path.({}), method: :get, local: true, class: "hrl-row" do %>
+    <input type="hidden" name="period" value="custom">
+    <% (local_assigns[:keep] || {}).each do |k, v| %><input type="hidden" name="<%= k %>" value="<%= v %>"><% end %>
+    <div class="hrl-field"><label for="wt-from">From</label><%= date_field_tag :from, period.from, max: Date.current, id: "wt-from" %></div>
+    <div class="hrl-field"><label for="wt-to">To</label><%= date_field_tag :to, period.to, max: Date.current, id: "wt-to" %></div>
+    <div class="hrl-form-actions"><button type="submit" class="hrl-btn">Show range</button></div>
+  <% end %>
+</section>
+
+<% if result.days_with_data.empty? %>
+  <section class="hrl-card"><p class="hrl-card--empty">No recorded activity in <%= period.label %>. Days with nothing recorded are left out rather than shown as zero.</p></section>
+<% else %>
+  <% office = result.by_mode["office"]; wfh = result.by_mode["wfh"]; field = result.by_mode["travelling"] + result.by_mode["outside_meeting"] %>
+  <div class="hrl-kpis">
+    <% [ [ "Attendance (check-in to check-out)", result.attendance ], [ "Working time", result.working ], [ "Breaks", result.breaks ],
+         [ "In office", office ], [ "Work from home", wfh ], [ "Travel and client meetings", field ], [ "Out of office", result.other ] ].each do |kpi_label, secs| %>
+      <div class="hrl-kpi"><div class="hrl-kpi__value"><%= hrl_duration(secs) %></div><div class="hrl-kpi__label"><%= kpi_label %></div></div>
+    <% end %>
+  </div>
+  <p class="hrl-small hrl-muted">Working time = in office, work from home, travelling, client and other meetings, and busy. It is time in those modes, not a measure of output.
+    Recorded on <%= pluralize(result.days_with_data.size, "day") %>.</p>
+
+  <%= render "hr_lite/work_time/donut", result: result, label: label %>
+  <% if period.kind == "day" %>
+    <% if local_assigns.fetch(:timeline, true) %>
+      <%= render "hr_lite/work_time/timeline", result: result, period: period, label: label, names: names %>
+    <% end %>
+  <% else %>
+    <%= render "hr_lite/work_time/bars", result: result, period: period, label: label, path: path %>
+  <% end %>
+
+  <% manual = result.by_source["employee"] + result.by_source["hr"] %>
+  <section class="hrl-card">
+    <h2 class="hrl-card__title">Set automatically vs chosen</h2>
+    <p class="hrl-small">Automatic (check-in, check-out, timers): <strong><%= hrl_duration(result.by_source["system"]) %></strong> ·
+      chosen by the employee: <strong><%= hrl_duration(result.by_source["employee"]) %></strong>
+      <% if result.by_source["hr"].positive? %> · set by HR: <strong><%= hrl_duration(result.by_source["hr"]) %></strong><% end %></p>
+  </section>
+
+  <% if records.any? %>
+    <section class="hrl-card">
+      <h2 class="hrl-card__title">Check-ins</h2>
+      <% records.each do |r| %>
+        <div class="hrl-feed__item hrl-small"><div class="hrl-feed__body">
+          <% if names %><strong><%= names[r.user_id] %></strong> · <% end %>
+          <%= r.date.strftime("%a %-d %b") %> · in <%= r.check_in_at.strftime("%H:%M") %> · out <%= r.check_out_at&.strftime("%H:%M") || "—" %>
+          <% if r.work_mode_label %> · <%= r.work_mode_label %><% end %>
+        </div></div>
+      <% end %>
+    </section>
+  <% end %>
+<% end %>

data/app/views/hr_lite/work_time/_timeline.html.erb

@@ -0,0 +1,26 @@
+<%# A day as one horizontal strip per person: 00:00 to 24:00. A dashed edge marks a system-set stretch. %>
+<% day_start = period.from.in_time_zone(HrLite.config.time_zone)
+   rows = result.segments.group_by(&:user_id)
+   pct = ->(t) { ((t - day_start) / 86_400.0 * 100).clamp(0, 100) } %>
+<section class="hrl-card">
+  <h2 class="hrl-card__title">The day, hour by hour</h2>
+  <% rows.each do |user_id, segs| %>
+    <% if names %><p class="hrl-small"><strong><%= names[user_id] %></strong></p><% end %>
+    <svg class="hrl-timeline" viewBox="0 0 100 10" preserveAspectRatio="none" role="img" aria-label="Work modes through the day; details in the list below">
+      <% segs.each do |seg| %>
+        <rect x="<%= pct.(seg.from).round(3) %>" y="1" width="<%= [ pct.(seg.to) - pct.(seg.from), 0.15 ].max.round(3) %>" height="8"
+              class="<%= class_names("hrl-fill--#{seg.mode}", "hrl-timeline__auto": seg.source == "system") %>" data-hrl-tip tabindex="0">
+          <title><%= label.(seg.mode) %> · <%= seg.from.strftime("%H:%M") %>–<%= seg.to.strftime("%H:%M") %> · <%= hrl_duration(seg.seconds) %> · <%= HrLite::ApplicationHelper::MODE_SOURCES[seg.source] %></title>
+        </rect>
+      <% end %>
+    </svg>
+    <div class="hrl-timeline__axis hrl-small hrl-muted" aria-hidden="true"><span>00</span><span>06</span><span>12</span><span>18</span><span>24</span></div>
+    <ol class="hrl-timeline__list hrl-small">
+      <% segs.each do |seg| %>
+        <li><span class="hrl-swatch hrl-fill-bg--<%= seg.mode %>" aria-hidden="true"></span>
+          <strong><%= seg.from.strftime("%H:%M") %>–<%= seg.to.strftime("%H:%M") %></strong> <%= label.(seg.mode) %> · <%= hrl_duration(seg.seconds) %>
+          <span class="hrl-muted">· <%= HrLite::ApplicationHelper::MODE_SOURCES[seg.source] %></span></li>
+      <% end %>
+    </ol>
+  <% end %>
+</section>

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

@@ -0,0 +1,10 @@
+<% content_for(:page_title) { "My work time" } %>
+<% content_for(:back, "Attendance") %>
+<div class="hrl-page__head">
+  <h1 class="hrl-page__title">My work time</h1>
+</div>
+<p class="hrl-small hrl-muted">Only you and HR can see this page's detail. Times come from your recorded check-ins and work modes.</p>
+<% if @period_error %><div class="hrl-errors" role="alert"><%= @period_error %></div><% end %>
+<%= render "hr_lite/work_time/report", result: @result, period: @period, records: @records,
+           path: ->(p) { hr_lite.work_time_path(p) } %>
+<% content_for :scripts do %><%= javascript_include_tag "hr_lite/chart_tip", defer: true %><% end %>

data/config/routes.rb

@@ -23,6 +23,16 @@ HrLite::Engine.routes.draw do
   resources :wfh_requests, only: %i[index create] do
     member { post :cancel }
   end
+  get "work_time", to: "work_time#show", as: :work_time
+  resource :work_mode, only: :create do
+    post :end_overlay
+    get :crm_search
+    post :status
+    post :clear_status
+  end
+  resources :work_locations, only: %i[index create] do
+    member { post :activate; post :remove }
+  end
   resources :approvals, only: :index
   resources :expenses, only: %i[index new create] do
     member { post :cancel }
@@ -80,6 +90,12 @@ HrLite::Engine.routes.draw do
     resources :wfh_requests, only: %i[index show create] do
       member { post :approve; post :reject }
     end
+    resources :work_locations, only: :index do
+      member { post :approve; post :reject }
+    end
+    get "work_modes", to: "work_modes#index", as: :work_modes
+    get "work_time", to: "work_time#index", as: :work_time
+    post "work_modes/:user_id", to: "work_modes#override", as: :work_mode_override
     resources :roles, except: :show do
       resources :assignments, only: %i[create destroy], controller: "role_assignments"
     end

data/db/migrate/20261013110000_create_hr_lite_work_locations.rb

@@ -0,0 +1,23 @@
+class CreateHrLiteWorkLocations < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_work_locations do |t|
+      t.bigint :user_id, null: false
+      t.string :name, null: false
+      t.decimal :lat, precision: 9, scale: 6, null: false
+      t.decimal :lng, precision: 9, scale: 6, null: false
+      t.integer :accuracy_m, null: false
+      t.string :address
+      t.string :status, null: false, default: "pending"
+      t.boolean :active, null: false, default: false
+      t.bigint :decided_by_id
+      t.datetime :decided_at
+      t.text :decision_note
+
+      t.timestamps
+    end
+    add_index :hr_lite_work_locations, [ :user_id, :status ]
+    add_index :hr_lite_work_locations, :user_id, unique: true, where: "active", name: "index_hr_lite_work_locations_one_active"
+    add_check_constraint :hr_lite_work_locations, "status IN ('pending','approved','rejected','removed')",
+                         name: "hr_lite_work_locations_status"
+  end
+end

data/db/migrate/20261013110100_add_work_mode_to_hr_lite_attendance_records.rb

@@ -0,0 +1,7 @@
+class AddWorkModeToHrLiteAttendanceRecords < ActiveRecord::Migration[8.1]
+  def change
+    add_column :hr_lite_attendance_records, :work_mode, :string
+    add_column :hr_lite_attendance_records, :work_location_id, :bigint
+    remove_column :hr_lite_attendance_records, :wfh, :boolean, null: false, default: false
+  end
+end

data/db/migrate/20261013110200_add_field_staff_to_hr_lite_employee_profiles.rb

@@ -0,0 +1,5 @@
+class AddFieldStaffToHrLiteEmployeeProfiles < ActiveRecord::Migration[8.1]
+  def change
+    add_column :hr_lite_employee_profiles, :field_staff, :boolean, null: false, default: false
+  end
+end

data/db/migrate/20261013110300_create_hr_lite_work_mode_events.rb

@@ -0,0 +1,30 @@
+class CreateHrLiteWorkModeEvents < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_work_mode_events do |t|
+      t.bigint :user_id, null: false
+      t.string :mode, null: false
+      t.string :layer, null: false
+      t.string :source, null: false
+      t.datetime :started_at, null: false
+      t.datetime :ends_at
+      t.datetime :ended_at
+      t.string :end_reason
+      t.boolean :overrun, null: false, default: false
+      t.bigint :attendance_record_id
+      t.bigint :wfh_request_id
+      t.bigint :work_location_id
+      t.bigint :set_by_id
+      t.string :title
+      t.string :client
+      t.string :destination
+      t.text :reason
+
+      t.timestamps
+    end
+    add_index :hr_lite_work_mode_events, [ :user_id, :started_at ]
+    add_index :hr_lite_work_mode_events, [ :user_id, :layer ], unique: true, where: "ended_at IS NULL",
+              name: "index_hr_lite_work_mode_events_one_open"
+    add_check_constraint :hr_lite_work_mode_events, "source IN ('system','employee','hr')", name: "hr_lite_work_mode_events_source"
+    add_check_constraint :hr_lite_work_mode_events, "layer IN ('primary','overlay')", name: "hr_lite_work_mode_events_layer"
+  end
+end

data/db/migrate/20261013110400_add_break_minutes_to_hr_lite_settings.rb

@@ -0,0 +1,6 @@
+class AddBreakMinutesToHrLiteSettings < ActiveRecord::Migration[8.1]
+  def change
+    add_column :hr_lite_settings, :lunch_break_minutes, :integer, null: false, default: 30
+    add_column :hr_lite_settings, :short_break_minutes, :integer, null: false, default: 10
+  end
+end

data/db/migrate/20261013120000_grant_hr_lite_work_analytics.rb

@@ -0,0 +1,14 @@
+class GrantHrLiteWorkAnalytics < ActiveRecord::Migration[8.1]
+  # work_analytics.view is new in 0.31.0. RoleSeeds only creates missing
+  # roles, so the existing HR, Leadership and Super Admin roles get it here.
+  # Manager deliberately does not.
+  def up
+    return unless HrLite::Role.exists?
+
+    HrLite::Role.where(name: [ "HR", "Leadership", "Super Admin" ]).find_each do |role|
+      HrLite::RoleGrant.find_or_initialize_by(role: role, permission_key: "work_analytics.view").update!(scope: "all")
+    end
+  end
+
+  def down; end
+end

data/db/migrate/20261013130000_add_office_location_to_hr_lite_holidays.rb

@@ -0,0 +1,12 @@
+class AddOfficeLocationToHrLiteHolidays < ActiveRecord::Migration[8.1]
+  # A holiday is for every office (office_location_id null) or for one; two
+  # offices may close on the same date for different reasons.
+  def change
+    add_column :hr_lite_holidays, :office_location_id, :bigint
+    remove_index :hr_lite_holidays, :date, unique: true
+    add_index :hr_lite_holidays, :date, unique: true, where: "office_location_id IS NULL",
+              name: "index_hr_lite_holidays_all_offices"
+    add_index :hr_lite_holidays, [ :date, :office_location_id ], unique: true,
+              name: "index_hr_lite_holidays_per_office"
+  end
+end

data/db/migrate/20261013130100_add_office_location_to_hr_lite_employee_profiles.rb

@@ -0,0 +1,6 @@
+class AddOfficeLocationToHrLiteEmployeeProfiles < ActiveRecord::Migration[8.1]
+  def change
+    add_column :hr_lite_employee_profiles, :office_location_id, :bigint
+    add_index :hr_lite_employee_profiles, :office_location_id
+  end
+end

data/db/migrate/20261013140000_add_calendar_and_crm_to_hr_lite_work_mode_events.rb

@@ -0,0 +1,9 @@
+class AddCalendarAndCrmToHrLiteWorkModeEvents < ActiveRecord::Migration[8.1]
+  def change
+    add_column :hr_lite_work_mode_events, :calendar_event_id, :string
+    add_column :hr_lite_work_mode_events, :crm_ref, :string
+    # A calendar meeting opens at most once per person, however often we sync.
+    add_index :hr_lite_work_mode_events, [ :user_id, :calendar_event_id ], unique: true,
+              where: "calendar_event_id IS NOT NULL", name: "index_hr_lite_work_mode_events_one_per_calendar_event"
+  end
+end

data/db/migrate/20261013140100_add_custom_status_to_hr_lite_work_mode_events.rb

@@ -0,0 +1,9 @@
+class AddCustomStatusToHrLiteWorkModeEvents < ActiveRecord::Migration[8.1]
+  # A third layer: a person's own status ("In Goa till Friday" + an emoji),
+  # alongside their work mode and any break or meeting.
+  def change
+    add_column :hr_lite_work_mode_events, :emoji, :string
+    remove_check_constraint :hr_lite_work_mode_events, "layer IN ('primary','overlay')", name: "hr_lite_work_mode_events_layer"
+    add_check_constraint :hr_lite_work_mode_events, "layer IN ('primary','overlay','status')", name: "hr_lite_work_mode_events_layer"
+  end
+end

data/lib/hr_lite/configuration.rb

@@ -20,7 +20,19 @@ module HrLite
                   # true = check-in slots, late penalties and HR buffers (default off)
                   :attendance_slots,
                   # true = check-in only inside an active office radius, unless WFH is approved for the day
-                  :office_geofence
+                  :office_geofence,
+                  # ->(user, from, to) { [{ id:, title:, starts_at:, ends_at: }] } — timed,
+                  # accepted events; starts Meeting mode by itself. Pairs with calendar_users.
+                  :calendar_events,
+                  # -> { user ids with a connected calendar }
+                  :calendar_users,
+                  # ->(user) { { connected:, label:, connect_url:, disconnect_url: } or nil } —
+                  # the one-click "Connect Google Calendar" button (nil = no button)
+                  :calendar_connection,
+                  # ->(user, query) { [{ id:, label: }] } — leads to link to a client meeting
+                  :crm_search,
+                  # ->(id) { { label:, url: } or nil } — one lead, to validate and link it
+                  :crm_find
 
     attr_reader :leave_year_start_month, :slip_release_day, :self_regularization, :work_hours
 

data/lib/hr_lite/notifications.rb

@@ -72,7 +72,10 @@ module HrLite
       "wfh.requested"         => { bell: true,  email: false, leadership_email: true,  leadership_bell: false },
       "wfh.approved"          => { bell: true,  email: true,  leadership_email: false, leadership_bell: false },
       "wfh.rejected"          => { bell: true,  email: true,  leadership_email: false, leadership_bell: false },
-      "wfh.cancelled"         => { bell: true,  email: false, leadership_email: false, leadership_bell: false }
+      "wfh.cancelled"         => { bell: true,  email: false, leadership_email: false, leadership_bell: false },
+      "work_location.requested" => { bell: true, email: false, leadership_email: false, leadership_bell: false },
+      "work_location.approved"  => { bell: true, email: true,  leadership_email: false, leadership_bell: false },
+      "work_location.rejected"  => { bell: true, email: true,  leadership_email: false, leadership_bell: false }
     }.freeze
 
     class << self
@@ -131,9 +134,11 @@ module HrLite
           next if user.email.blank?
 
           begin
-            EventMailer.event(to: user.email, subject: title, heading: title,
-                              body: body, lines: lines, path: path,
-                              link_url: link_url).deliver_later
+            mail = EventMailer.event(to: user.email, subject: title, heading: title,
+                                     body: body, lines: lines, path: path, link_url: link_url)
+            # Busy or in a meeting: the email waits until that ends.
+            held = WorkStatus.do_not_disturb_until(user.id) if HrLite.config.office_geofence
+            held ? mail.deliver_later(wait_until: held) : mail.deliver_later
           rescue => e
             Rails.logger.error("[hr_lite] event email failed: #{e.class}: #{e.message}")
           end

data/lib/hr_lite/permissions.rb

@@ -30,6 +30,7 @@ module HrLite
       "profile.manage" => [ "People", "Create and edit employee profiles, onboard and offboard" ],
       "attendance.view" => [ "Attendance", "See attendance records" ],
       "attendance.manage" => [ "Attendance", "Correct punches and decide regularization tickets" ],
+      "work_analytics.view" => [ "Attendance", "See another person's work-time analytics (time per work mode, day timelines)" ],
       "leave.request" => [ "Leave", "Apply for leave and comp-off" ],
       "leave.view" => [ "Leave", "See leave requests and balances" ],
       "leave.approve" => [ "Leave", "Approve, reject and cancel leave and comp-off" ],