bug_reports_client 0.1.0

data/app/views/bug_reports_client/bug_reports/all.html.erb

@@ -0,0 +1,66 @@
+<%# Admin-only list of every report from this app, gated by config.admin_check. %>
+<% content_for(:title) { t("bug_reports_client.titles.all") } %>
+
+<%# No page container here - the host layout owns page width and padding. %>
+<div>
+  <div class="mb-6">
+    <div class="flex justify-between items-center">
+      <div>
+        <h1 class="font-bold text-3xl mb-2 text-slate-900"><%= t("bug_reports_client.all.heading") %></h1>
+        <p class="text-sm text-slate-600"><%= t("bug_reports_client.all.subheading") %></p>
+      </div>
+      <div class="flex items-center gap-2">
+        <%= link_to bug_reports_path, class: "inline-flex items-center rounded-lg border border-slate-300 px-3 py-1.5 text-sm font-medium text-slate-700 hover:bg-slate-100", title: t("bug_reports_client.index.heading") do %>
+          <svg xmlns="http://www.w3.org/2000/svg" class="h-5 w-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 19l-7-7m0 0l7-7m-7 7h18" />
+          </svg>
+        <% end %>
+      </div>
+    </div>
+  </div>
+
+  <%= render "filters" %>
+
+  <% if @bug_reports.present? %>
+    <div class="bg-slate-50 rounded-xl overflow-hidden border border-slate-200">
+      <table class="w-full text-sm text-left">
+        <thead class="text-xs text-slate-500 uppercase bg-slate-100 border-b border-slate-200">
+          <tr>
+            <th scope="col" class="px-6 py-4"><%= t("bug_reports_client.index.table.title") %></th>
+            <th scope="col" class="px-6 py-4"><%= t("bug_reports_client.all.reporter") %></th>
+            <th scope="col" class="px-6 py-4"><%= t("bug_reports_client.index.table.priority") %></th>
+            <th scope="col" class="px-6 py-4"><%= t("bug_reports_client.index.table.status") %></th>
+            <th scope="col" class="px-6 py-4"><%= t("bug_reports_client.index.table.submitted") %></th>
+          </tr>
+        </thead>
+        <tbody class="divide-y divide-slate-200">
+          <% @bug_reports.each do |report| %>
+            <tr class="bg-white hover:bg-slate-50 transition-colors">
+              <td class="px-6 py-4 font-medium text-slate-900">
+                <div class="flex items-center gap-2">
+                  <%= render "type_badge", report_type: report.report_type %>
+                  <%= link_to report.title, edit_bug_report_path(report), class: "text-slate-800 hover:underline" %>
+                </div>
+              </td>
+              <td class="px-6 py-4 text-slate-600">
+                <%= BugReportsClient.config.reporter_name_for(report.user).presence || BugReportsClient.config.reporter_email_for(report.user) %>
+              </td>
+              <td class="px-6 py-4"><%= render "rating_badge", value: report.importance %></td>
+              <td class="px-6 py-4"><%= render "status_badge", status: report.status %></td>
+              <td class="px-6 py-4 text-slate-500"><%= report.created_at.strftime("%-d %b %Y") %></td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+
+    <%= render "pagination" %>
+  <% else %>
+    <div class="bg-slate-50 rounded-xl border border-slate-200 p-12 text-center">
+      <h3 class="text-sm font-medium text-slate-900"><%= t("bug_reports_client.index.empty.filtered") %></h3>
+      <p class="mt-1 text-sm text-slate-500">
+        <%= link_to t("bug_reports_client.index.empty.view_all"), all_bug_reports_path, class: "text-slate-800 hover:underline font-medium" %>
+      </p>
+    </div>
+  <% end %>
+</div>

data/app/views/bug_reports_client/bug_reports/edit.html.erb

@@ -0,0 +1,40 @@
+<% content_for(:title) { @bug_report.title } %>
+
+<%# No page container here - the host layout owns page width and padding. %>
+<div>
+  <div class="mb-6">
+    <div class="flex justify-between items-center">
+      <div>
+        <h1 class="font-bold text-3xl mb-2 text-slate-900"><%= @bug_report.title %></h1>
+        <div class="flex flex-wrap items-center gap-3">
+          <%= render "type_badge", report_type: @bug_report.report_type %>
+          <%= render "status_badge", status: @bug_report.status %>
+          <%= render "rating_badge", value: @bug_report.importance %>
+          <span class="text-sm text-slate-500"><%= t("bug_reports_client.edit.submitted_at", timestamp: @bug_report.created_at.strftime("%-d %b %Y at %H:%M")) %></span>
+        </div>
+      </div>
+      <div class="flex items-center gap-2">
+        <%= link_to bug_reports_path, class: "inline-flex items-center rounded-lg border border-slate-300 px-3 py-1.5 text-sm font-medium text-slate-700 hover:bg-slate-100", title: t("bug_reports_client.edit.back") do %>
+          <svg xmlns="http://www.w3.org/2000/svg" class="h-5 w-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 19l-7-7m0 0l7-7m-7 7h18" />
+          </svg>
+        <% end %>
+      </div>
+    </div>
+  </div>
+
+  <% unless @bug_report.open? %>
+    <div class="bg-green-50 border border-green-200 rounded-lg p-4 mb-6">
+      <div class="flex gap-3">
+        <div class="flex-shrink-0">
+          <svg class="h-5 w-5 text-green-500" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+            <path stroke-linecap="round" stroke-linejoin="round" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
+          </svg>
+        </div>
+        <p class="text-sm text-green-800"><%= t("bug_reports_client.edit.resolved_notice", type_noun: @bug_report.type_noun) %></p>
+      </div>
+    </div>
+  <% end %>
+
+  <%= render "form", bug_report: @bug_report %>
+</div>

data/app/views/bug_reports_client/bug_reports/index.html.erb

@@ -0,0 +1,104 @@
+<% content_for(:title) { t("bug_reports_client.titles.index") } %>
+
+<%# No page container here - the host layout owns page width and padding. %>
+<div>
+  <div class="mb-6">
+    <div class="flex justify-between items-center">
+      <div>
+        <h1 class="font-bold text-3xl mb-2 text-slate-900"><%= t("bug_reports_client.index.heading") %></h1>
+        <p class="text-sm text-slate-600"><%= t("bug_reports_client.index.subheading") %></p>
+      </div>
+      <div class="flex items-center gap-2">
+        <% if bug_reports_admin? %>
+          <%= link_to all_bug_reports_path, class: "inline-flex items-center rounded-lg border border-slate-300 px-3 py-1.5 text-sm font-medium text-slate-700 hover:bg-slate-100", title: t("bug_reports_client.index.all_reports") do %>
+            <svg xmlns="http://www.w3.org/2000/svg" class="h-5 w-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0zm6 3a2 2 0 11-4 0 2 2 0 014 0zM7 10a2 2 0 11-4 0 2 2 0 014 0z" />
+            </svg>
+          <% end %>
+        <% end %>
+        <%= link_to new_bug_report_path, class: "inline-flex items-center rounded-lg bg-slate-800 px-3 py-1.5 text-sm font-medium text-white hover:bg-slate-700", title: t("bug_reports_client.index.new_report") do %>
+          <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 6v6m0 0v6m0-6h6m-6 0H6" />
+          </svg>
+        <% end %>
+      </div>
+    </div>
+  </div>
+
+  <%= render "filters" %>
+
+  <% if @bug_reports.present? %>
+    <div class="bg-slate-50 rounded-xl overflow-hidden border border-slate-200">
+      <div class="hidden md:block">
+        <table class="w-full text-sm text-left">
+          <thead class="text-xs text-slate-500 uppercase bg-slate-100 border-b border-slate-200">
+            <tr>
+              <th scope="col" class="px-6 py-4"><%= t("bug_reports_client.index.table.title") %></th>
+              <th scope="col" class="px-6 py-4"><%= t("bug_reports_client.index.table.priority") %></th>
+              <th scope="col" class="px-6 py-4"><%= t("bug_reports_client.index.table.status") %></th>
+              <th scope="col" class="px-6 py-4"><%= t("bug_reports_client.index.table.submitted") %></th>
+            </tr>
+          </thead>
+          <tbody class="divide-y divide-slate-200">
+            <% @bug_reports.each do |report| %>
+              <tr class="bg-white hover:bg-slate-50 transition-colors">
+                <td class="px-6 py-4 font-medium text-slate-900">
+                  <div class="flex items-center gap-2">
+                    <%= render "type_badge", report_type: report.report_type %>
+                    <%= link_to report.title, edit_bug_report_path(report), class: "text-slate-800 hover:underline" %>
+                  </div>
+                </td>
+                <td class="px-6 py-4">
+                  <%= render "rating_badge", value: report.importance %>
+                </td>
+                <td class="px-6 py-4">
+                  <%= render "status_badge", status: report.status %>
+                </td>
+                <td class="px-6 py-4 text-slate-500">
+                  <%= report.created_at.strftime("%-d %b %Y") %>
+                </td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      </div>
+
+      <div class="md:hidden divide-y divide-slate-200">
+        <% @bug_reports.each do |report| %>
+          <%= link_to edit_bug_report_path(report), class: "block p-4 bg-white hover:bg-slate-50 transition-colors" do %>
+            <div class="flex items-start justify-between mb-2">
+              <span class="font-medium text-slate-900"><%= report.title %></span>
+              <%= render "status_badge", status: report.status %>
+            </div>
+            <div class="flex flex-wrap items-center gap-2 text-xs text-slate-500">
+              <%= render "type_badge", report_type: report.report_type %>
+              <%= render "rating_badge", value: report.importance %>
+              <span>&middot;</span>
+              <span><%= report.created_at.strftime("%-d %b %Y") %></span>
+            </div>
+          <% end %>
+        <% end %>
+      </div>
+    </div>
+
+    <%= render "pagination" %>
+  <% else %>
+    <div class="bg-slate-50 rounded-xl border border-slate-200 p-12 text-center">
+      <svg class="mx-auto h-12 w-12 text-slate-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
+      </svg>
+      <% if params[:status].present? || params[:report_type].present? %>
+        <h3 class="mt-2 text-sm font-medium text-slate-900"><%= t("bug_reports_client.index.empty.filtered") %></h3>
+        <p class="mt-1 text-sm text-slate-500">
+          <%= link_to t("bug_reports_client.index.empty.view_all"), bug_reports_path, class: "text-slate-800 hover:underline font-medium" %>
+        </p>
+      <% else %>
+        <h3 class="mt-2 text-sm font-medium text-slate-900"><%= t("bug_reports_client.index.empty.none") %></h3>
+        <p class="mt-1 text-sm text-slate-500">
+          <%= t("bug_reports_client.index.empty.prompt") %>
+          <%= link_to t("bug_reports_client.index.empty.submit"), new_bug_report_path, class: "text-slate-800 hover:underline font-medium" %>
+        </p>
+      <% end %>
+    </div>
+  <% end %>
+</div>

data/app/views/bug_reports_client/bug_reports/new.html.erb

@@ -0,0 +1,33 @@
+<% content_for(:title) { t("bug_reports_client.titles.new") } %>
+
+<%# No page container here - the host layout owns page width and padding. %>
+<div>
+  <div class="mb-6">
+    <div class="flex justify-between items-center">
+      <div>
+        <h1 class="font-bold text-3xl mb-2 text-slate-900"><%= t("bug_reports_client.new.heading") %></h1>
+        <p class="text-sm text-slate-600"><%= t("bug_reports_client.new.subheading") %></p>
+      </div>
+      <div class="flex items-center gap-2">
+        <%= link_to bug_reports_path, class: "inline-flex items-center rounded-lg border border-slate-300 px-3 py-1.5 text-sm font-medium text-slate-700 hover:bg-slate-100", title: t("bug_reports_client.new.my_reports") do %>
+          <svg xmlns="http://www.w3.org/2000/svg" class="h-5 w-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 10h16M4 14h16M4 18h16" />
+          </svg>
+        <% end %>
+      </div>
+    </div>
+  </div>
+
+  <div class="bg-blue-50 border border-blue-200 rounded-lg p-4 mb-6">
+    <div class="flex gap-3">
+      <div class="flex-shrink-0">
+        <svg class="h-5 w-5 text-blue-500" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+          <path stroke-linecap="round" stroke-linejoin="round" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+        </svg>
+      </div>
+      <p class="text-sm text-blue-800"><%= t("bug_reports_client.new.intro") %></p>
+    </div>
+  </div>
+
+  <%= render "form", bug_report: @bug_report %>
+</div>

data/app/views/bug_reports_client/shared/_after_dismiss.turbo_stream.erb

@@ -0,0 +1,4 @@
+<%# Hook rendered into the Turbo Stream response after an alert is dismissed.
+    Empty by default - hosts can override this partial (create
+    app/views/bug_reports_client/shared/_after_dismiss.turbo_stream.erb) to
+    update their own UI, e.g. refresh a notification badge count. %>

data/app/views/bug_reports_client/shared/_alerts.html.erb

@@ -0,0 +1,22 @@
+<%# Dismissable alerts for resolved reports. Rendered in HOST layouts via the
+    bug_report_alerts helper, so routes go through the mount proxy. %>
+<div id="bug_report_alerts" class="mb-6">
+  <% resolved_bug_reports.each do |report| %>
+    <div id="bug_report_<%= report.id %>" class="flex items-center justify-between p-3 mb-2 border border-green-200 rounded-lg bg-green-50">
+      <div class="flex items-center gap-2">
+        <svg class="flex-shrink-0 w-4 h-4 text-green-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"/>
+        </svg>
+        <span class="text-sm text-green-800">
+          <%= t("bug_reports_client.alerts.resolved_html", type_noun: report.type_noun, title: report.title) %>
+        </span>
+      </div>
+      <%= button_to bug_reports_client.bug_report_path(report),
+          method: :patch,
+          class: "text-xs text-green-600 hover:text-green-800 font-medium flex-shrink-0 cursor-pointer",
+          data: { turbo_stream: true } do %>
+        <%= t("bug_reports_client.alerts.dismiss") %>
+      <% end %>
+    </div>
+  <% end %>
+</div>

data/config/form_schema.yml

@@ -0,0 +1,114 @@
+# Default form definition for bug_reports_client. Host apps can replace this
+# wholesale by creating config/bug_report_form.yml (copied for you by the
+# install generator). Field wording lives in i18n under
+# bug_reports_client.fields.<field>.* unless overridden inline here.
+#
+# Each field: field (snake_case key), type (text|textarea|select|checkbox),
+# required, section (starts a new card), rows (textareas), options (selects -
+# strings, or {value:, label:} pairs when the stored value should differ).
+bug:
+  - field: impact
+    type: textarea
+    required: true
+    section: about_the_bug
+
+  - field: expected_behaviour
+    type: textarea
+    required: true
+    section: behaviour
+
+  - field: actual_behaviour
+    type: textarea
+    required: true
+    section: behaviour
+
+  - field: steps_to_reproduce
+    type: textarea
+    rows: 4
+    section: reproduction
+
+  - field: specific_examples
+    type: textarea
+    rows: 4
+    section: reproduction
+
+  - field: page_url
+    type: text
+    section: reproduction
+
+  - field: browser
+    type: select
+    options: [Chrome, Safari, Firefox, Edge, Other]
+    section: reproduction
+
+  - field: additional_context
+    type: textarea
+    section: additional_information
+
+feature:
+  - field: priority
+    type: select
+    required: true
+    section: your_idea
+    options:
+      - { value: high, label: "High - would save significant time or unblock something" }
+      - { value: medium, label: "Medium - a real improvement, but manageable for now" }
+      - { value: low, label: "Low - nice to have, no rush" }
+
+  - field: problem
+    type: textarea
+    required: true
+    rows: 4
+    section: your_idea
+
+  - field: solution
+    type: textarea
+    required: true
+    rows: 4
+    section: your_idea
+
+  - field: time_per_occurrence
+    type: select
+    required: true
+    section: impact_and_frequency
+    options:
+      - "Less than 5 minutes"
+      - "5-15 minutes"
+      - "15-30 minutes"
+      - "30 minutes to 1 hour"
+      - "1-2 hours"
+      - "More than 2 hours"
+      - "Not sure"
+
+  - field: frequency
+    type: select
+    required: true
+    section: impact_and_frequency
+    options:
+      - "Multiple times a day"
+      - "Daily"
+      - "A few times a week"
+      - "Weekly"
+      - "A few times a month"
+      - "Monthly"
+      - "Rarely"
+
+  - field: people_affected
+    type: text
+    section: impact_and_frequency
+
+  - field: user_story
+    type: textarea
+    section: success_criteria_and_risks
+
+  - field: done_criteria
+    type: textarea
+    section: success_criteria_and_risks
+
+  - field: edge_cases
+    type: textarea
+    section: success_criteria_and_risks
+
+  - field: additional_context
+    type: textarea
+    section: additional_information

data/config/importmap.rb

@@ -0,0 +1,6 @@
+# Pins the engine's Stimulus controllers into the host importmap. The
+# controllers/ prefix means the host's standard Stimulus loading picks them up
+# automatically with namespaced identifiers (bug-reports-client--*).
+pin_all_from BugReportsClient::Engine.root.join("app/javascript/bug_reports_client/controllers"),
+             under: "controllers/bug_reports_client",
+             to: "bug_reports_client/controllers"

data/config/locales/en.yml

@@ -0,0 +1,213 @@
+# All user-facing wording for bug_reports_client. Host apps override any
+# subset of these keys in their own config/locales files - no view copying
+# needed for wording changes. Field keys mirror the form schema; a custom
+# schema field picks up wording from bug_reports_client.fields.<field>.*.
+en:
+  bug_reports_client:
+    type_nouns:
+      bug: "bug report"
+      feature: "feature request"
+
+    titles:
+      new: "Report a Bug or Request a Feature"
+      index: "My Reports"
+      all: "All Reports"
+
+    new:
+      heading: "Report a Bug or Request a Feature"
+      subheading: "We'll create a ticket and notify you when it's resolved."
+      intro: "Please fill in as much as you can - it really helps us address your report."
+      my_reports: "My Reports"
+
+    index:
+      heading: "My Reports"
+      subheading: "Track the status of the bugs and features you've reported."
+      new_report: "New report"
+      all_reports: "All Reports"
+      table:
+        title: "Title"
+        priority: "Priority"
+        status: "Status"
+        submitted: "Submitted"
+      empty:
+        filtered: "No reports match this filter."
+        view_all: "View all reports"
+        none: "You haven't submitted any reports yet."
+        prompt: "Found a bug or have an idea?"
+        submit: "Submit a report"
+
+    all:
+      heading: "All Reports"
+      subheading: "Every report submitted from this app."
+      reporter: "Reporter"
+
+    edit:
+      back: "Back to My Reports"
+      submitted_at: "Submitted %{timestamp}"
+      resolved_notice: "This %{type_noun} has been resolved. The details below are shown for reference only."
+
+    form:
+      errors_heading: "Please fix the following errors:"
+      overview: "Overview"
+      report_type:
+        label: "What are you reporting?"
+        prompt: "Select report type"
+        bug: "Bug - something isn't working"
+        feature: "Feature request - an idea or improvement"
+        bug_title: "Bug"
+        bug_description: "Something isn't working"
+        feature_title: "Feature request"
+        feature_description: "An idea or improvement"
+        locked: "The report type can't be changed after submission."
+      title:
+        label: "What's the short summary?"
+        help: "A brief one-line summary."
+        bug_placeholder: "e.g. Page not loading on mobile"
+        feature_placeholder: "e.g. Add a way to export my data"
+      severity:
+        label: "How serious is this?"
+        prompt: "Select severity"
+        low: "Low - minor or cosmetic issue"
+        medium: "Medium - it works, but something is off"
+        high: "High - a key feature is broken, but there's a workaround"
+        critical: "Critical - something important is completely broken"
+      related_error:
+        label: "Is this about a problem you ran into?"
+        prompt: "Not related / not sure"
+        help: "We noticed something went wrong for you recently. Linking it helps us find the cause much faster."
+        option_with_activity: "Something went wrong while %{activity}"
+        option_generic: "Something went wrong"
+      screenshots:
+        label: "Screenshots or mockups"
+        hint: "(optional, up to %{max})"
+        replace_notice: "Uploading new images will replace the existing ones."
+        drop_prompt: "Drag and drop images here, or click to browse"
+        drop_hint: "Up to %{max} images"
+        limit: "You can attach a maximum of %{max} images."
+      optional: "(optional)"
+      select_prompt: "Select an option"
+      submit: "Submit Report"
+      update: "Update Report"
+      submitting: "Submitting..."
+
+    sections:
+      about_the_bug: "About the Bug"
+      behaviour: "Expected vs Actual Behaviour"
+      reproduction: "Reproduction Details"
+      your_idea: "Your Idea"
+      impact_and_frequency: "Impact & Frequency"
+      success_criteria_and_risks: "Success Criteria & Risks"
+      additional_information: "Additional Information"
+
+    fields:
+      impact:
+        label: "Who does this affect and why does it matter?"
+        placeholder: "e.g. I can't complete my task because the page never finishes loading"
+        help: "Help us understand who's affected and the real-world impact."
+      expected_behaviour:
+        label: "What should happen?"
+        placeholder: "e.g. The page should load and show the latest information"
+      actual_behaviour:
+        label: "What actually happens?"
+        placeholder: "e.g. The page shows an error message or stays blank"
+      steps_to_reproduce:
+        label: "How can we see this?"
+        placeholder: "1. Go to the page\n2. Try to use the filter\n3. Notice it doesn't work"
+        help: "Numbered steps are ideal, but describe it however makes sense."
+      specific_examples:
+        label: "Specific examples"
+        placeholder: "Any specific records, names, or dates involved"
+        help: "Any specific examples that show the problem."
+      page_url:
+        label: "Page or URL"
+        placeholder: "e.g. https://example.com/some/page"
+      browser:
+        label: "Browser"
+        prompt: "Select browser"
+      additional_context:
+        label: "Anything else?"
+        placeholder: "Any other context, links, or related requests"
+      priority:
+        label: "How important is this to you?"
+        prompt: "Select priority"
+      problem:
+        label: "What problem does this solve?"
+        placeholder: "e.g. There's no easy way to see everything in one place, so I keep missing things."
+        help: "Tell us about the pain point or frustration this would fix."
+      solution:
+        label: "What would the ideal solution look like?"
+        placeholder: "e.g. Add a page that lists everything with the key details."
+        help: "Don't worry about technical details - just describe what you'd want to happen."
+      time_per_occurrence:
+        label: "How long does it currently take each time?"
+        prompt: "Select an estimate"
+      frequency:
+        label: "How often does this come up?"
+        prompt: "Select frequency"
+      people_affected:
+        label: "How many people would this help?"
+        placeholder: "e.g. just me, or lots of users"
+      user_story:
+        label: "Who benefits and how?"
+        placeholder: "e.g. As a user, I want to see everything in one place, so that I never miss anything."
+      done_criteria:
+        label: "How would we know this is done?"
+        placeholder: "- I can see everything on one page\n- Each item shows the key details"
+      edge_cases:
+        label: "Anything that might complicate this?"
+        placeholder: "e.g. What should happen if something is rescheduled or cancelled?"
+
+    flashes:
+      created: "%{type_noun} submitted successfully. We'll notify you when it's resolved."
+      updated: "%{type_noun} updated successfully."
+      submit_failed: "Unable to submit your report. Please try again later."
+      only_open_editable: "Only open %{type_noun}s can be updated."
+      dismissed: "%{type_noun} notification dismissed."
+      not_permitted: "You do not have permission for this action."
+
+    alerts:
+      resolved_html: "Your %{type_noun} <span class=\"font-medium\">\"%{title}\"</span> has been resolved."
+      dismiss: "Dismiss"
+
+    filters:
+      type_label: "Type"
+      all: "All"
+      open: "Open"
+      resolved: "Resolved"
+      all_types: "All types"
+      bugs: "Bugs"
+      features: "Features"
+
+    badges:
+      bug: "Bug"
+      feature: "Feature"
+      open: "Open"
+      resolved: "Resolved"
+
+    pagination:
+      previous: "Previous"
+      next: "Next"
+
+    # Verbs for the human-readable "what you were doing" descriptions built
+    # from the controller/action where an error was captured.
+    activities:
+      index: "viewing"
+      show: "viewing"
+      new: "adding to"
+      create: "saving to"
+      edit: "editing"
+      update: "saving changes to"
+      destroy: "deleting from"
+      other: "using"
+
+    errors:
+      required_field: "%{field} can't be blank"
+      too_many_screenshots: "You can attach a maximum of %{max} images"
+      screenshot_type: "%{filename} is not a supported image type"
+      screenshot_size: "%{filename} is too large (maximum %{max_mb} MB)"
+
+    description:
+      severity: "Severity"
+      screenshots: "Screenshots"
+      reported_by: "Reported by"
+      related_error: "Related captured error"

data/config/routes.rb

@@ -0,0 +1,14 @@
+# Engine routes. Hosts mount the engine (usually at /bug_reports), giving:
+#   GET  /bug_reports          - my reports
+#   GET  /bug_reports/new      - the report form
+#   GET  /bug_reports/all      - every report (admins, via config.admin_check)
+#   POST /bug_reports/webhook  - signed closure callbacks from the API
+BugReportsClient::Engine.routes.draw do
+  resources :bug_reports, path: "", only: %i[index new create edit update] do
+    collection do
+      get :all
+    end
+  end
+
+  post "webhook", to: "webhooks#receive"
+end

data/db/migrate/20260721000001_create_bug_reports.rb

@@ -0,0 +1,32 @@
+# Creates the local bug_reports table. Deliberately unnamespaced so an app
+# with an existing bug_reports table (from a bespoke integration) can adopt
+# the engine without moving data - the guard below makes this migration a
+# no-op in that case.
+class CreateBugReports < ActiveRecord::Migration[8.0]
+  def change
+    return if table_exists?(:bug_reports)
+
+    create_table :bug_reports do |t|
+      t.bigint :user_id, null: false
+      t.string :title, null: false
+      t.string :status, null: false, default: "open"
+      t.string :severity
+      t.string :report_type, null: false, default: "bug"
+      t.integer :remote_bug_report_id
+      t.datetime :dismissed_at
+
+      # All schema-driven form answers, keyed by field name. jsonb on
+      # PostgreSQL, plain json elsewhere (e.g. SQLite in tests).
+      if connection.adapter_name.match?(/postg/i)
+        t.jsonb :responses, null: false, default: {}
+      else
+        t.json :responses, null: false, default: {}
+      end
+
+      t.timestamps
+    end
+
+    add_index :bug_reports, :user_id
+    add_index :bug_reports, :remote_bug_report_id, unique: true
+  end
+end