munawaba 0.1.0

data/app/services/munawaba/timing/boundary_calculator.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require "tzinfo"
+
+module Munawaba
+  module Timing
+    # Resolve each handoff from the original local rule so short months and DST
+    # adjustments do not shift later handoffs.
+    class BoundaryCalculator
+      Boundary = Struct.new(:index, :nominal_local_date, :nominal_local_seconds,
+                            :resolved_at, :resolution, :adjustment_seconds, :utc_offset_seconds, keyword_init: true)
+
+      def self.timezone(iana) = TZInfo::Timezone.get(iana)
+
+      def initialize(schedule, provider: Timing::BoundaryCalculator.method(:timezone))
+        @schedule = schedule
+        @zone = provider.call(schedule.time_zone)
+      end
+
+      def boundary(index)
+        raise ArgumentError, "Boundary index must be nonnegative" unless index.is_a?(Integer) && index >= 0
+
+        anchor = @schedule.anchor_local_date
+        date = case @schedule.cadence
+               when "one_week" then anchor + (7 * index)
+               when "two_weeks" then anchor + (14 * index)
+               when "calendar_month" then anchor >> index
+               else raise ArgumentError, "Unknown cadence"
+               end
+        seconds = @schedule.anchor_local_seconds
+        local = Time.utc(date.year, date.month, date.day) + seconds
+        periods = @zone.periods_for_local(local)
+        adjustment = 0
+        if periods.any?
+          candidates = periods.map { |period| [local - period.utc_total_offset, period.utc_total_offset] }
+          resolved, offset = candidates.min_by(&:first)
+          resolution = periods.length > 1 ? "ambiguous_earlier" : "exact"
+        else
+          # A transition's local gap is [UTC + old offset, UTC + new offset).
+          transition = @zone.transitions_up_to(local + (3 * 86_400), local - (3 * 86_400)).find do |item|
+            old_offset = item.previous_offset.utc_total_offset
+            new_offset = item.offset.utc_total_offset
+            instant = item.at.to_time.utc
+            new_offset > old_offset && local >= instant + old_offset && local < instant + new_offset
+          end
+          raise ArgumentError, "Timezone provider did not resolve the local gap" unless transition
+
+          offset = transition.offset.utc_total_offset
+          adjustment = offset - transition.previous_offset.utc_total_offset
+          resolved = local + adjustment - offset
+          resolution = "gap_forward"
+        end
+        Boundary.new(index: index, nominal_local_date: date, nominal_local_seconds: seconds,
+                     resolved_at: resolved.utc.freeze, resolution: resolution.freeze,
+                     adjustment_seconds: adjustment, utc_offset_seconds: offset).freeze
+      end
+      alias call boundary
+
+      def slot_at(instant)
+        instant = instant.utc
+        raise ArgumentError, "Instant precedes the nominal anchor" if instant < boundary(0).resolved_at
+
+        date = instant.to_date
+        anchor = @schedule.anchor_local_date
+        index = case @schedule.cadence
+                when "one_week" then ((date - anchor).to_i / 7)
+                when "two_weeks" then ((date - anchor).to_i / 14)
+                when "calendar_month" then ((date.year - anchor.year) * 12) + date.month - anchor.month
+                end
+        index = [index, 0].max
+        index -= 1 while index.positive? && boundary(index).resolved_at > instant
+        index += 1 while boundary(index + 1).resolved_at <= instant
+        raise ArgumentError,
+              "Non-monotonic canonical boundaries" unless boundary(index).resolved_at < boundary(index + 1).resolved_at
+
+        index
+      end
+
+      def selectable_boundaries(now:, limit: Munawaba.config.calendar_future_limit)
+        first = now < boundary(0).resolved_at ? 0 : slot_at(now)
+        first += 1 if boundary(first).resolved_at < now
+        last_at = now + limit
+        values = []
+        while (item = boundary(first)).resolved_at <= last_at
+          values << item
+          first += 1
+        end
+        values.freeze
+      end
+    end
+  end
+end

data/app/services/munawaba/timing/persisted_interval_verifier.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Munawaba
+  module Timing
+    class PersistedIntervalVerifier
+      def self.valid?(shift:, now:, provider: Timing::BoundaryCalculator.method(:timezone))
+        return false if shift.canceled_at || shift.coverage_revision != shift.schedule.coverage_revision
+
+        # Started shifts keep their saved times. Check future shifts with the same
+        # boundary and start rules used when preparing a scheduling change.
+        if shift.starts_at <= now
+          calculator = BoundaryCalculator.new(shift.schedule, provider: provider)
+          changed = calculator.boundary(shift.boundary_index + 1).resolved_at != shift.ends_at
+          ActiveSupport::Notifications.instrument("timing.frozen_interval_rule_change.munawaba",
+                                                  schedule_id: shift.schedule_id, shift_id: shift.id) if changed
+          return !changed
+        end
+        prepared = Shifts::NormalizeFutureTiming.prepare(schedule: shift.schedule, now: now, provider: provider)
+        virtual = prepared.slots.find { |slot| slot[:id] == shift.id }
+        virtual && virtual[:starts_at] == shift.starts_at && virtual[:ends_at] == shift.ends_at && !prepared.clipping
+      rescue ArgumentError, TZInfo::InvalidTimezoneIdentifier
+        false
+      end
+    end
+  end
+end

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

@@ -0,0 +1,61 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="color-scheme" content="dark light">
+    <meta name="turbo-visit-control" content="reload">
+    <title><%= content_for?(:title) ? "#{yield(:title)} · Munawaba" : "Munawaba" %></title>
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+    <link rel="icon" type="image/png" href="<%= frontend_asset_path(version: Munawaba::VERSION, id: "logo.png") %>">
+    <%= stylesheet_link_tag frontend_asset_path(version: Munawaba::VERSION, id: "dashboard.css"), nonce: content_security_policy_nonce %>
+    <%= javascript_include_tag frontend_asset_path(version: Munawaba::VERSION, id: "dashboard.js"), defer: true, nonce: content_security_policy_nonce %>
+  </head>
+  <body>
+    <div class="mn-app" data-mn-theme="<%= munawaba_theme %>" data-turbo="false">
+      <a href="#mn-main" class="mn-skip-link">Skip to content</a>
+      <aside class="mn-sidebar" aria-label="Munawaba navigation">
+        <%= link_to root_path, class: "mn-brand" do %>
+          <%= image_tag frontend_asset_path(version: Munawaba::VERSION, id: "logo.png"), alt: "", class: "mn-brand-logo", width: 18, height: 18 %>
+          <span class="mn-brand-name">munawaba</span>
+          <span class="mn-version">v<%= Munawaba::VERSION %></span>
+        <% end %>
+        <div class="mn-desktop-navigation">
+          <%= render "munawaba/shared/navigation" %>
+        </div>
+        <details class="mn-menu" data-mn-menu>
+          <summary>Menu <span aria-hidden="true">☰</span></summary>
+          <%= render "munawaba/shared/navigation" %>
+        </details>
+        <div class="mn-sidebar-footer">
+          <span>On-call rotations</span>
+        </div>
+      </aside>
+      <div class="mn-workspace">
+        <header class="mn-topbar">
+          <nav class="mn-breadcrumbs" aria-label="Breadcrumb">
+            <%= link_to "Munawaba", root_path %>
+            <span class="mn-breadcrumb-separator" aria-hidden="true">/</span>
+            <span aria-current="page"><%= content_for?(:title) ? yield(:title) : "Overview" %></span>
+          </nav>
+          <% theme_action = munawaba_theme == "dark" ? "Light theme" : "Dark theme" %>
+          <%= form_with url: theme_path, method: :patch, local: true, class: "mn-theme-form" do %>
+            <%= hidden_field_tag :theme, munawaba_theme == "dark" ? "light" : "dark" %>
+            <%= button_tag type: "submit", class: "mn-theme-button", title: theme_action, aria: { label: theme_action } do %>
+              <span aria-hidden="true"><%= munawaba_theme == "dark" ? "◐" : "◑" %></span>
+              <span class="mn-sr-only"><%= theme_action %></span>
+            <% end %>
+          <% end %>
+        </header>
+        <main id="mn-main" class="mn-main" tabindex="-1">
+          <% if flash[:notice].present? %>
+            <div class="mn-notice" role="status"><%= flash[:notice] %></div>
+          <% end %>
+          <%= render "munawaba/shared/errors", record: (@person || @schedule || @record) %>
+          <%= yield %>
+        </main>
+      </div>
+    </div>
+  </body>
+</html>

data/app/views/munawaba/audit_events/index.html.erb

@@ -0,0 +1,85 @@
+<%= page_title "Activity", "Recent changes to people, schedules, and Slack settings. Times: #{Munawaba.config.organization_time_zone}." %>
+
+<%= form_with url: activity_path, method: :get, local: true, class: "mn-filter-bar", id: "mn-form" do %>
+  <div>
+    <%= label_tag :schedule_id, "Schedule" %>
+    <%= select_tag :schedule_id, options_from_collection_for_select(@schedules, :id, :name, params[:schedule_id]), include_blank: "All schedules" %>
+  </div>
+  <div>
+    <%= label_tag :person_id, "Person" %>
+    <%= select_tag :person_id, options_from_collection_for_select(@people, :id, :name, params[:person_id]), include_blank: "All people" %>
+  </div>
+  <div>
+    <%= label_tag :event_type, "Event" %>
+    <%= text_field_tag :event_type, params[:event_type], placeholder: "rotation.changed" %>
+  </div>
+  <div>
+    <%= label_tag :shift_id, "Shift ID" %>
+    <%= number_field_tag :shift_id, params[:shift_id], min: 1 %>
+  </div>
+  <div>
+    <%= label_tag :actor_type, "Actor type" %>
+    <%= text_field_tag :actor_type, params[:actor_type] %>
+  </div>
+  <div>
+    <%= label_tag :actor_id, "Actor ID" %>
+    <%= text_field_tag :actor_id, params[:actor_id] %>
+  </div>
+  <div>
+    <%= label_tag :from, "From date" %>
+    <%= date_field_tag :from, params[:from] %>
+  </div>
+  <div>
+    <%= label_tag :until, "Through date" %>
+    <%= date_field_tag :until, params[:until] %>
+  </div>
+  <%= submit_tag "Filter", class: "mn-button" %>
+  <%= link_to "Clear", activity_path %>
+<% end %>
+
+<% if @events.empty? %>
+  <%= render "munawaba/shared/empty", title: "No activity found", description: "Changes matching these filters will appear here." %>
+<% else %>
+  <div class="mn-table-scroll" role="region" aria-label="Activity" tabindex="0">
+    <table class="mn-table">
+      <thead>
+        <tr>
+          <th scope="col">When</th>
+          <th scope="col">Event</th>
+          <th scope="col">Actor</th>
+          <th scope="col">Details</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @events.each do |event| %>
+          <tr>
+            <td class="mn-mono"><%= local_time(event.occurred_at) %></td>
+            <td>
+              <strong><%= event.event_type.tr("._", " ").humanize %></strong>
+              <span class="mn-cell-sub mn-mono"><%= event.event_type %></span>
+            </td>
+            <td><%= event.actor_name.presence || event.actor_id.presence || "—" %></td>
+            <td>
+              <details class="mn-event-details">
+                <summary>View details</summary>
+                <dl class="mn-detail-list">
+                  <dt>Operation</dt>
+                  <dd class="mn-mono"><%= event.operation_id %></dd>
+                  <% event.metadata.each do |key, value| %>
+                    <dt><%= key.humanize %></dt>
+                    <dd><%= value.is_a?(Hash) || value.is_a?(Array) ? JSON.pretty_generate(value) : value %></dd>
+                  <% end %>
+                </dl>
+              </details>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+  <% if @more %>
+    <div class="mn-pagination">
+      <%= link_to "Older activity →", activity_path(request.query_parameters.merge(before: cursor_for(@events.last, :occurred_at))), class: "mn-button" %>
+    </div>
+  <% end %>
+<% end %>

data/app/views/munawaba/calendars/_shift.html.erb

@@ -0,0 +1,17 @@
+<%= link_to shift_path(shift), class: "mn-calendar-shift" do %>
+  <strong><%= shift.schedule.name %></strong>
+  <span><%= shift.effective_person.name %></span>
+  <span class="mn-mono"><%= local_time(shift.starts_at, @time_zone, format: "%b %-d %H:%M") %> → <%= local_time(shift.ends_at, @time_zone, format: "%b %-d %H:%M") %></span>
+  <% if shift.starts_at <= Time.current && shift.ends_at > Time.current %>
+    <span>● Current shift</span>
+  <% end %>
+  <% if shift.effective_person_id != shift.base_person_id %>
+    <span>Override</span>
+  <% end %>
+  <% shift_dst_adjustments(shift).each do |adjustment| %>
+    <span class="mn-dst-cue"><%= adjustment %></span>
+  <% end %>
+  <% if conflicts[shift.id].present? %>
+    <span class="mn-conflict">Conflict: <%= conflicts[shift.id].map { |row| row["name"] }.uniq.join(", ") %></span>
+  <% end %>
+<% end %>

data/app/views/munawaba/calendars/show.html.erb

@@ -0,0 +1,81 @@
+<div class="mn-page-heading">
+  <%= page_title "Calendar", "Coverage · #{@time_zone}" %>
+  <div class="mn-segment">
+    <%= link_to "Agenda", calendar_link(@from, "agenda"), aria: { current: ("page" if @view == "agenda") } %>
+    <%= link_to "Month", calendar_link(@from, "month"), aria: { current: ("page" if @view == "month") } %>
+  </div>
+</div>
+
+<%= form_with url: calendar_path, method: :get, local: true, class: "mn-filter-bar", id: "mn-form" do %>
+  <%= hidden_field_tag :view, @view %>
+  <div>
+    <%= label_tag :schedule_id, "Schedule" %>
+    <%= select_tag :schedule_id, options_from_collection_for_select(@schedules, :id, :name, params[:schedule_id]), include_blank: "All schedules" %>
+  </div>
+  <div>
+    <%= label_tag :person_id, "Person" %>
+    <%= select_tag :person_id, options_from_collection_for_select(@people, :id, :name, params[:person_id]), include_blank: "All people" %>
+  </div>
+  <div>
+    <%= label_tag :date, "From date" %>
+    <%= date_field_tag :date, @from %>
+  </div>
+  <%= submit_tag "Apply", class: "mn-button" %>
+  <%= link_to "Clear", calendar_path %>
+<% end %>
+
+<div class="mn-section-heading">
+  <h2><%= @view == "month" ? @from.strftime("%B %Y") : "#{@from.strftime('%b %-d')} – #{(@until - 1).strftime('%b %-d, %Y')}" %></h2>
+  <div class="mn-actions">
+    <%= link_to "← Previous", calendar_link(@previous_date), class: "mn-button" if @previous_date %>
+    <%= link_to "Today", calendar_path(request.query_parameters.except("date", "until").merge(date: Time.current.in_time_zone(@time_zone).to_date)), class: "mn-button" %>
+    <%= link_to "Next →", calendar_link(@next_date), class: "mn-button" if @next_date %>
+  </div>
+</div>
+
+<% if @view == "month" && @errors.blank? %>
+  <%
+    conflicts = conflicts_for(@shifts)
+    shift_cards = {}
+  %>
+  <div class="mn-calendar-scroll" role="region" aria-label="Month calendar, <%= @time_zone %>" tabindex="0">
+    <div class="mn-month-grid">
+      <% calendar_days.first(7).each do |day| %>
+        <div class="mn-weekday"><%= day.strftime("%A") %></div>
+      <% end %>
+      <% calendar_days.each do |day| %>
+        <section class="mn-day <%= 'mn-day-outside' if day.month != @from.month %>">
+          <h3><time datetime="<%= day.iso8601 %>"><%= day.day %></time><%= " · Today" if day == Time.current.in_time_zone(@time_zone).to_date %></h3>
+          <% day_shifts = shifts_on(day) %>
+          <% day_shifts.first(3).each do |shift| %>
+            <%= shift_cards[shift.id] ||= render("munawaba/calendars/shift", shift: shift, conflicts: conflicts) %>
+          <% end %>
+          <% if day_shifts.size > 3 %>
+            <details class="mn-day-more">
+              <summary><%= day_shifts.size - 3 %> more shifts</summary>
+              <% day_shifts.drop(3).each do |shift| %>
+                <%= shift_cards[shift.id] ||= render("munawaba/calendars/shift", shift: shift, conflicts: conflicts) %>
+              <% end %>
+            </details>
+          <% end %>
+        </section>
+      <% end %>
+    </div>
+  </div>
+<% elsif @errors.blank? %>
+  <%
+    conflicts = conflicts_for(@shifts)
+    weeks = @shifts.group_by do |shift|
+      [shift.starts_at.in_time_zone(@time_zone).to_date, @from].max.beginning_of_week(Munawaba.config.week_starts_on)
+    end
+  %>
+  <% if weeks.empty? %>
+    <%= render "munawaba/shared/shifts", shifts: [], zone: @time_zone %>
+  <% end %>
+  <% weeks.each do |week, shifts| %>
+    <div class="mn-section-heading">
+      <h2>Week of <%= week.strftime("%b %-d, %Y") %></h2>
+    </div>
+    <%= render "munawaba/shared/shifts", shifts: shifts, zone: @time_zone, conflicts: conflicts %>
+  <% end %>
+<% end %>

data/app/views/munawaba/notification_deliveries/index.html.erb

@@ -0,0 +1,65 @@
+<%= page_title "Slack deliveries", "Times: #{Munawaba.config.organization_time_zone}" %>
+<div class="mn-notice">An unknown outcome means Slack may have received the message. Retrying can send it twice.</div>
+
+<%= form_with url: notification_deliveries_path, method: :get, local: true, class: "mn-filter-bar", id: "mn-form" do %>
+  <div>
+    <%= label_tag :schedule_id, "Schedule" %>
+    <%= select_tag :schedule_id, options_from_collection_for_select(@schedules, :id, :name, params[:schedule_id]), include_blank: "All schedules" %>
+  </div>
+  <div>
+    <%= label_tag :status, "Status" %>
+    <%= select_tag :status, options_for_select(%w[pending enqueued processing delivered failed canceled stale].map { |status| [status.humanize, status] }, params[:status]), include_blank: "All statuses" %>
+  </div>
+  <%= submit_tag "Filter", class: "mn-button" %>
+  <%= link_to "Clear", notification_deliveries_path %>
+<% end %>
+
+<% if @deliveries.empty? %>
+  <%= render "munawaba/shared/empty", title: "No deliveries found", description: "Try another filter, or check the schedule's Slack settings." %>
+<% else %>
+  <div class="mn-table-scroll" role="region" aria-label="Notification deliveries" tabindex="0">
+    <table class="mn-table">
+      <thead>
+        <tr>
+          <th scope="col">Created / schedule</th>
+          <th scope="col">Kind</th>
+          <th scope="col">Status</th>
+          <th scope="col">Attempts</th>
+          <th scope="col">Outcome / action</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @deliveries.each do |delivery| %>
+          <tr>
+            <td class="mn-mono">
+              <%= local_time(delivery.created_at) %>
+              <span class="mn-cell-sub"><%= link_to delivery.schedule.name, edit_schedule_slack_integration_path(delivery.schedule) %></span>
+            </td>
+            <td><%= delivery.kind.humanize %></td>
+            <td><%= state_badge(delivery.status) %></td>
+            <td class="mn-mono"><%= delivery.attempt_count %></td>
+            <td>
+              <% if delivery.last_error_code == "delivery_outcome_unknown" %>
+                <p class="mn-conflict">Unknown outcome · may have reached Slack</p>
+              <% end %>
+              <span class="mn-mono"><%= delivery.last_error_code.presence || (delivery.delivered_at ? "Delivered #{local_time(delivery.delivered_at)}" : "—") %></span>
+              <% if delivery.status == "failed" %>
+                <%= form_with url: retry_notification_delivery_path(delivery), local: true do %>
+                  <% if delivery.last_error_code == "delivery_outcome_unknown" %>
+                    <label class="mn-checkbox"><%= check_box_tag :acknowledge_duplicate, "1", false, required: true %><span>I accept the risk of a duplicate message.</span></label>
+                  <% end %>
+                  <%= submit_tag "Retry failed delivery", class: "mn-button" %>
+                <% end %>
+              <% end %>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+  <% if @more %>
+    <div class="mn-pagination">
+      <%= link_to "Older deliveries →", notification_deliveries_path(request.query_parameters.merge(before: cursor_for(@deliveries.last, :created_at))), class: "mn-button" %>
+    </div>
+  <% end %>
+<% end %>

data/app/views/munawaba/overrides/new.html.erb

@@ -0,0 +1,19 @@
+<%= page_title "Override whole shift", "#{@shift.schedule.name} · #{local_time(@shift.starts_at, @shift.schedule.time_zone)} – #{local_time(@shift.ends_at, @shift.schedule.time_zone)} · #{@shift.schedule.time_zone}" %>
+
+<%= form_with url: preview_shift_override_path(@shift), local: true, class: "mn-card mn-form", id: "mn-form" do %>
+  <%= hidden_field_tag :operation, "apply" %>
+  <%= hidden_field_tag :lock_version, @shift.lock_version %>
+  <div class="mn-field">
+    <%= label_tag :person_id, "Replacement person (required)" %>
+    <%= select_tag :person_id, options_from_collection_for_select(@people, :id, :name, params[:person_id]), required: true, include_blank: "Choose an active person" %>
+    <p class="mn-hint">Any active person can cover this shift, including someone outside the roster.</p>
+  </div>
+  <div class="mn-field">
+    <%= label_tag :reason, "Reason (optional)" %>
+    <%= text_area_tag :reason, params[:reason], maxlength: 1000, rows: 4, placeholder: "Add context for this change" %>
+  </div>
+  <div class="mn-form-actions">
+    <%= submit_tag "Preview override", class: "mn-button mn-button-primary" %>
+    <%= link_to "Cancel", shift_path(@shift), class: "mn-button" %>
+  </div>
+<% end %>

data/app/views/munawaba/overviews/show.html.erb

@@ -0,0 +1,76 @@
+<div class="mn-overview">
+  <div class="mn-page-heading">
+    <%= page_title "Overview" %>
+    <%= link_to "New schedule", new_schedule_path, class: "mn-button mn-button-primary" %>
+  </div>
+
+  <% if @schedules.empty? %>
+    <%= render "munawaba/shared/empty", title: "Your first handoff starts here", description: "Register your people, create a schedule, and set the rotation order.", action: link_to("Add a person", new_person_path, class: "mn-button mn-button-primary") %>
+  <% else %>
+    <div class="mn-stats">
+      <div>
+        <span>Schedules</span>
+        <strong><%= @schedules.size %></strong>
+      </div>
+      <div>
+        <span>Active</span>
+        <strong><%= @schedules.count { |schedule| effective_schedule_state(schedule) == "active" } %></strong>
+      </div>
+      <div>
+        <span>Scheduled</span>
+        <strong><%= @schedules.count { |schedule| effective_schedule_state(schedule) == "scheduled" } %></strong>
+      </div>
+      <div>
+        <span>Without a roster</span>
+        <strong><%= @schedules.count { |schedule| @roster_counts[schedule.id].to_i.zero? } %></strong>
+      </div>
+    </div>
+    <div class="mn-section-heading">
+      <h2 id="mn-overview-schedules">All schedules</h2>
+      <span class="mn-muted">Times use each schedule’s timezone</span>
+    </div>
+    <div class="mn-table-scroll" role="region" aria-labelledby="mn-overview-schedules" tabindex="0">
+      <table class="mn-table mn-overview-table">
+        <thead>
+          <tr>
+            <th scope="col">Schedule</th>
+            <th scope="col">Cadence</th>
+            <th scope="col">State</th>
+            <th scope="col">On call now</th>
+            <th scope="col">Next</th>
+            <th scope="col">Next handoff</th>
+            <th scope="col">Scheduled through</th>
+          </tr>
+        </thead>
+        <tbody>
+          <% @schedules.each do |schedule| %>
+            <%
+              display_state = effective_schedule_state(schedule)
+              shifts = display_state == "paused" ? [] : @shifts.fetch(schedule.id, [])
+              current = shifts.find { |shift| shift.starts_at <= @now }
+              upcoming = shifts.find { |shift| shift.starts_at > @now }
+            %>
+            <tr>
+              <td class="mn-overview-schedule">
+                <%= link_to schedule.name, schedule_path(schedule), class: "mn-primary-text" %>
+                <span class="mn-cell-sub mn-mono"><%= schedule.time_zone %></span>
+                <% if (warning = lifecycle_maintenance_warning(schedule)) %>
+                  <span class="mn-conflict mn-maintenance-warning"><%= warning %></span>
+                <% end %>
+                <% if @roster_counts[schedule.id].to_i.zero? %>
+                  <span class="mn-conflict">Add people to complete this roster.</span>
+                <% end %>
+              </td>
+              <td><%= cadence_name(schedule) %></td>
+              <td><%= state_badge(display_state) %></td>
+              <td class="mn-overview-person"><span class="<%= current ? "mn-primary-text" : "mn-muted" %>"><%= current&.effective_person&.name || "No current coverage" %></span></td>
+              <td class="mn-overview-person"><%= upcoming&.effective_person&.name || "—" %></td>
+              <td class="mn-mono"><%= local_time(current&.ends_at || upcoming&.starts_at, schedule.time_zone) %></td>
+              <td class="mn-mono"><%= local_time(display_state == "paused" ? nil : @projected_through[schedule.id], schedule.time_zone) %></td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  <% end %>
+</div>

data/app/views/munawaba/people/_form.html.erb

@@ -0,0 +1,25 @@
+<%= form_with model: @person, url: @person.persisted? ? person_path(@person) : people_path, local: true, class: "mn-form mn-card", id: "mn-form" do |form| %>
+  <% if @person.persisted? %>
+    <%= form.hidden_field :lock_version %>
+  <% end %>
+  <div class="mn-field">
+    <%= form.label :name, "Display name (required)" %>
+    <%= form.text_field :name, required: true, maxlength: 120, autocomplete: "name", autofocus: @errors.blank? %>
+    <%= model_errors(@person, :name) %>
+  </div>
+  <div class="mn-field">
+    <%= form.label :email, "Organization email (required)" %>
+    <%= form.email_field :email, required: true, maxlength: 320, autocomplete: "email" %>
+    <%= model_errors(@person, :email) %>
+  </div>
+  <div class="mn-field">
+    <%= form.label :slack_member_id, "Slack member ID (optional)" %>
+    <%= form.text_field :slack_member_id, maxlength: 32, placeholder: "U012ABC34", spellcheck: false, autocomplete: "off", aria: { describedby: "mn-slack-id-hint" } %>
+    <p id="mn-slack-id-hint" class="mn-hint">For Slack mentions. Without an ID, messages use the person’s display name.</p>
+    <%= model_errors(@person, :slack_member_id) %>
+  </div>
+  <div class="mn-form-actions">
+    <%= form.submit @person.persisted? ? "Save person" : "Add person", class: "mn-button mn-button-primary" %>
+    <%= link_to "Cancel", @person.persisted? ? person_path(@person) : people_path, class: "mn-button" %>
+  </div>
+<% end %>

data/app/views/munawaba/people/edit.html.erb

@@ -0,0 +1,2 @@
+<%= page_title "Edit #{@person.name}" %>
+<%= render "form" %>

data/app/views/munawaba/people/index.html.erb

@@ -0,0 +1,49 @@
+<div class="mn-page-heading">
+  <%= page_title "People", "Register people once. Include them in any number of schedules." %>
+  <%= link_to "Add person", new_person_path, class: "mn-button mn-button-primary" %>
+</div>
+
+<%= form_with url: people_path, method: :get, local: true, class: "mn-filter-bar" do %>
+  <div>
+    <%= label_tag :q, "Search people" %>
+    <%= search_field_tag :q, params[:q], placeholder: "Name or email" %>
+  </div>
+  <div>
+    <%= label_tag :state, "Status" %>
+    <%= select_tag :state, options_for_select([["All people", ""], ["Active", "active"], ["Inactive", "inactive"]], params[:state]) %>
+  </div>
+  <%= submit_tag "Filter", class: "mn-button" %>
+  <%= link_to "Clear", people_path %>
+<% end %>
+
+<% if @people.empty? %>
+  <%= render "munawaba/shared/empty", title: "No people found", description: "Add a person to start building your rotations." %>
+<% else %>
+  <div class="mn-table-scroll" role="region" aria-label="People" tabindex="0">
+    <table class="mn-table">
+      <thead>
+        <tr>
+          <th scope="col">Person</th>
+          <th scope="col">Email</th>
+          <th scope="col">Schedules</th>
+          <th scope="col">Status</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @people.each do |person| %>
+          <tr>
+            <td><%= link_to person.name, person_path(person), class: "mn-primary-text" %></td>
+            <td><%= person.email %></td>
+            <td class="mn-mono"><%= @membership_counts[person.id].to_i %></td>
+            <td><%= state_badge(person.active? ? "active" : "inactive") %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+  <% if @more %>
+    <div class="mn-pagination">
+      <%= link_to "More people →", people_path(request.query_parameters.merge(after: name_cursor_for(@people.last))), class: "mn-button" %>
+    </div>
+  <% end %>
+<% end %>

data/app/views/munawaba/people/new.html.erb

@@ -0,0 +1,2 @@
+<%= page_title "Add person" %>
+<%= render "form" %>

data/app/views/munawaba/people/show.html.erb

@@ -0,0 +1,34 @@
+<div class="mn-page-heading">
+  <%= page_title @person.name, @person.email %>
+  <div class="mn-actions">
+    <%= state_badge(@person.active? ? "active" : "inactive") %>
+    <%= link_to "Edit person", edit_person_path(@person), class: "mn-button" %>
+  </div>
+</div>
+
+<div class="mn-card mn-compact-card">
+  <dl class="mn-detail-list">
+    <dt>Slack member ID</dt>
+    <dd class="mn-mono"><%= @person.slack_member_id.presence || "Not provided" %></dd>
+    <dt>Schedules</dt>
+    <dd><%= safe_join(@memberships.map { |membership| link_to membership.schedule.name, schedule_path(membership.schedule) }, ", ").presence || "No memberships" %></dd>
+  </dl>
+  <div class="mn-actions">
+    <%= link_to "View activity", activity_path(person_id: @person.id) %>
+    <%= link_to "View calendar", calendar_path(person_id: @person.id) %>
+    <% if @person.active? %>
+      <%= link_to "Deactivate person", deactivation_person_path(@person), class: "mn-danger-link" %>
+    <% else %>
+      <%= button_to "Reactivate person", reactivate_person_path(@person), method: :patch, params: { lock_version: @person.lock_version }, class: "mn-button" %>
+    <% end %>
+  </div>
+  <% unless @person.active? %>
+    <p class="mn-hint">Reactivation makes this person selectable again. Former memberships are not restored.</p>
+  <% end %>
+</div>
+
+<div class="mn-section-heading">
+  <h2>Current and upcoming assignments</h2>
+  <span class="mn-muted"><%= Munawaba.config.organization_time_zone %></span>
+</div>
+<%= render "munawaba/shared/shifts", shifts: @shifts, zone: Munawaba.config.organization_time_zone %>