New plugin: weekly technician bonus credit memos (SOP-OPS-012)

Totals the shop's billable hours for a Sunday-Saturday week (picked
projects, trackers and users) against the SOP-OPS-012 target, and
credits each qualifying technician's QuickBooks customer account with a
credit memo: a "Tech Bonus <week> <total>/<goal> hours (total/goal)"
line, plus a separate tier line for every full 15 hours over the goal.
Credit memos are emailed through QuickBooks.

- Bonus technicians (admin): user, QuickBooks customer, role
  (technician/foreman), probation end
- Tech bonuses (global "Run tech bonuses" permission): week preview,
  attendance check, run, PDF and email again; re-running a week never
  credits anyone twice

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
rickyandClaude Opus 5.5 committed 2026-11-16 12:13:30 -05:00
commit a2ecb74c1d
37 files changed
+2274

No files matched your search

@@ -0,0 +1,32 @@
<%= error_messages_for @technician %>
<% taken = BonusTechnician.where.not(id: @technician.id).pluck(:user_id) %>
<% users = User.active.sorted.where.not(id: taken).to_a %>
<% users << @technician.user if @technician.user && !users.include?(@technician.user) %>
<div class="box tabular">
<p>
<%= f.select :user_id, users.map { |user| [user.name, user.id] }, { include_blank: true, required: true, label: :field_user },
{ disabled: @technician.persisted? } %>
</p>
<p>
<label for="bonus_technician_customer_name"><%= l(:label_bonus_technician_customer) %></label>
<%= text_field_tag 'customer_name', @technician.customer&.name, id: 'bonus_technician_customer_name',
class: 'customer-name', autocomplete: 'off', size: 40, placeholder: l(:label_choose_a_customer),
data: { autocomplete_url: '/customers/autocomplete' } %>
<%= f.hidden_field :customer_id, id: 'customer_id' %>
<em class="info"><%= l(:text_bonus_technician_customer) %></em>
</p>
<p><%= f.select :role, BonusTechnician.role_options, required: true %></p>
<p>
<%= f.date_field :probation_until, label: :field_bonus_technician_probation_until %>
<em class="info"><%= l(:text_bonus_technician_probation) %></em>
</p>
<p><%= f.check_box :active %></p>
</div>
<%= javascript_tag do %>
$(function() {
if (window.initCustomerAutocomplete) { window.initCustomerAutocomplete(document); }
$('#bonus_technician_customer_name').on('input', function() {
if (!$(this).val()) { $('#customer_id').val(''); }
});
});
<% end %>
@@ -0,0 +1,8 @@
<h2><%= link_to l(:label_bonus_technician_plural), bonus_technicians_path %> » <%= @technician.name %></h2>
<%= labelled_form_for @technician, url: bonus_technician_path(@technician), method: :patch do |f| %>
<%= render partial: 'bonus_technicians/form', locals: { f: f } %>
<%= submit_tag l(:button_save) %>
<% end %>
<% html_title @technician.name %>
@@ -0,0 +1,45 @@
<div class="contextual">
<%= link_to sprite_icon('add', l(:label_bonus_technician_new)), new_bonus_technician_path, class: 'icon icon-add' %>
<%= link_to sprite_icon('settings', l(:label_settings)), plugin_settings_path('redmine_qbo_bonus'), class: 'icon icon-settings' %>
</div>
<h2><%= l(:label_bonus_technician_plural) %></h2>
<p><em class="info"><%= l(:text_bonus_technicians) %></em></p>
<% if @technicians.empty? %>
<p class="nodata"><%= l(:label_no_data) %></p>
<% else %>
<div class="autoscroll">
<table class="list">
<thead>
<tr>
<th><%= l(:label_user) %></th>
<th><%= l(:field_role) %></th>
<th><%= l(:label_bonus_technician_customer) %></th>
<th><%= l(:field_bonus_technician_probation_until) %></th>
<th><%= l(:field_active) %></th>
<th></th>
</tr>
</thead>
<tbody>
<% @technicians.each do |tech| %>
<tr>
<td class="name"><%= link_to_user tech.user %></td>
<td><%= tech.role_name %></td>
<td><%= tech.customer ? link_to(tech.customer.name, customer_path(tech.customer)) : content_tag(:span, l(:text_tech_bonus_no_customer), class: 'tech-bonus-error') %></td>
<td><%= format_date(tech.probation_until) %></td>
<td><%= checked_image tech.active? %></td>
<td class="buttons">
<%= link_to sprite_icon('edit', l(:button_edit)), edit_bonus_technician_path(tech), class: 'icon icon-edit' %>
<%= link_to sprite_icon('del', l(:button_delete)), bonus_technician_path(tech), method: :delete,
data: { confirm: l(:text_are_you_sure) }, class: 'icon icon-del' %>
</td>
</tr>
<% end %>
</tbody>
</table>
</div>
<% end %>
<% html_title l(:label_bonus_technician_plural) %>
+8
View File
@@ -0,0 +1,8 @@
<h2><%= link_to l(:label_bonus_technician_plural), bonus_technicians_path %> » <%= l(:label_bonus_technician_new) %></h2>
<%= labelled_form_for @technician, url: bonus_technicians_path do |f| %>
<%= render partial: 'bonus_technicians/form', locals: { f: f } %>
<%= submit_tag l(:button_create) %>
<% end %>
<% html_title l(:label_bonus_technician_new) %>
+84
View File
@@ -0,0 +1,84 @@
<%# Settings for redmine_qbo_bonus (Administration » Plugins » Configure) %>
<% s = RedmineQboBonus::Settings %>
<% field = ->(key) { "settings[#{key}]" } %>
<p>
<%= link_to sprite_icon('user', l(:label_bonus_technician_plural)), bonus_technicians_path, class: 'icon icon-user' %>
<%= link_to sprite_icon('time', l(:label_tech_bonus_plural)), tech_bonuses_path, class: 'icon icon-time' %>
</p>
<fieldset class="box tabular">
<legend><%= l(:label_tech_bonus_hours_counted) %></legend>
<p>
<label for="qbo_bonus_projects"><%= l(:label_project_plural) %></label>
<%= hidden_field_tag "#{field.call('project_ids')}[]", '', id: nil %>
<%= select_tag "#{field.call('project_ids')}[]",
project_tree_options_for_select(Project.active.sorted.to_a, selected: Project.where(id: s.project_ids).to_a),
multiple: true, size: 8, id: 'qbo_bonus_projects' %>
<em class="info"><%= l(:text_tech_bonus_projects) %></em>
</p>
<p>
<label for="qbo_bonus_subprojects"><%= l(:label_tech_bonus_include_subprojects) %></label>
<%= hidden_field_tag field.call('include_subprojects'), '0', id: nil %>
<%= check_box_tag field.call('include_subprojects'), '1', s.include_subprojects?, id: 'qbo_bonus_subprojects' %>
</p>
<p>
<label for="qbo_bonus_trackers"><%= l(:label_tracker_plural) %></label>
<%= select_tag field.call('tracker_mode'),
options_for_select([[l(:label_tech_bonus_trackers_exclude), 'exclude'], [l(:label_tech_bonus_trackers_include), 'include']], s.tracker_mode),
id: 'qbo_bonus_tracker_mode' %><br>
<%= hidden_field_tag "#{field.call('tracker_ids')}[]", '', id: nil %>
<%= select_tag "#{field.call('tracker_ids')}[]", options_from_collection_for_select(Tracker.sorted, :id, :name, s.tracker_ids),
multiple: true, size: 8, id: 'qbo_bonus_trackers' %>
<em class="info"><%= l(:text_tech_bonus_trackers) %></em>
</p>
<p>
<label for="qbo_bonus_users"><%= l(:label_tech_bonus_users) %></label>
<%= hidden_field_tag "#{field.call('user_ids')}[]", '', id: nil %>
<%= select_tag "#{field.call('user_ids')}[]", options_from_collection_for_select(User.active.sorted, :id, :name, s.user_ids),
multiple: true, size: 8, id: 'qbo_bonus_users' %>
<em class="info"><%= l(:text_tech_bonus_users) %></em>
</p>
</fieldset>
<fieldset class="box tabular">
<legend><%= l(:label_tech_bonus_target) %></legend>
<p>
<label for="qbo_bonus_goal"><%= l(:label_tech_bonus_goal_hours) %></label>
<%= number_field_tag field.call('goal_hours'), RedmineQboBonus.format_hours(s.goal_hours), id: 'qbo_bonus_goal', min: 0, step: 0.25, style: 'width: 6em' %>
<em class="info"><%= l(:text_tech_bonus_goal) %></em>
</p>
<p>
<label for="qbo_bonus_tier"><%= l(:label_tech_bonus_tier_hours) %></label>
<%= number_field_tag field.call('tier_hours'), RedmineQboBonus.format_hours(s.tier_hours), id: 'qbo_bonus_tier', min: 0.25, step: 0.25, style: 'width: 6em' %>
<em class="info"><%= l(:text_tech_bonus_tier) %></em>
</p>
<% BonusTechnician::ROLES.each do |role| %>
<p>
<label for="qbo_bonus_<%= role %>_amount"><%= l("label_bonus_role_#{role}") %></label>
<%= number_field_tag field.call("#{role}_amount"), RedmineQboBonus.format_hours(s.amount(role)), id: "qbo_bonus_#{role}_amount", min: 0, step: 0.01, style: 'width: 6em' %>
<%= l(:label_tech_bonus_per_tier) %>
<%= number_field_tag field.call("#{role}_tier_amount"), RedmineQboBonus.format_hours(s.tier_amount(role)), id: "qbo_bonus_#{role}_tier_amount", min: 0, step: 0.01, style: 'width: 6em' %>
</p>
<% end %>
</fieldset>
<fieldset class="box tabular">
<legend><%= l(:label_tech_bonus_credit_memo) %></legend>
<p>
<label for="qbo_bonus_item"><%= l(:label_tech_bonus_item) %><span class="required"> *</span></label>
<%= select_tag field.call('item_id'), options_from_collection_for_select(Item.sellable.order(:name), :id, :name, s.item_id),
include_blank: true, id: 'qbo_bonus_item' %>
<em class="info"><%= l(:text_tech_bonus_item) %></em>
</p>
<p>
<label for="qbo_bonus_memo"><%= l(:label_tech_bonus_customer_memo) %></label>
<%= text_area_tag field.call('customer_memo'), s.customer_memo, id: 'qbo_bonus_memo', rows: 2, cols: 60 %>
</p>
<p>
<label for="qbo_bonus_email"><%= l(:label_tech_bonus_email_credits) %></label>
<%= hidden_field_tag field.call('email_credits'), '0', id: nil %>
<%= check_box_tag field.call('email_credits'), '1', s.email_credits?, id: 'qbo_bonus_email' %>
<em class="info"><%= l(:text_tech_bonus_email_credits) %></em>
</p>
</fieldset>
+3
View File
@@ -0,0 +1,3 @@
<% content_for :header_tags do %>
<%= stylesheet_link_tag 'qbo_bonus', plugin: 'redmine_qbo_bonus' %>
<% end %>
+57
View File
@@ -0,0 +1,57 @@
<%= render partial: 'tech_bonuses/styles' %>
<div class="contextual">
<% if User.current.admin? %>
<%= link_to sprite_icon('user', l(:label_bonus_technician_plural)), bonus_technicians_path, class: 'icon icon-user' %>
<%= link_to sprite_icon('settings', l(:label_settings)), plugin_settings_path('redmine_qbo_bonus'), class: 'icon icon-settings' %>
<% end %>
</div>
<h2><%= l(:label_tech_bonus_plural) %></h2>
<%= form_tag(tech_bonuses_path, method: :get, id: 'tech-bonus-week-picker', class: 'tech-bonus-picker') do %>
<label for="tech_bonus_week"><%= l(:label_tech_bonus_week) %></label>
<%= select_tag 'week', options_for_select(@weeks.map { |week| [bonus_week_title(week), week.to_param] }, @week.to_param),
id: 'tech_bonus_week' %>
<%= submit_tag l(:button_tech_bonus_preview), name: nil %>
<% end %>
<h3><%= l(:label_tech_bonus_history) %></h3>
<% if @bonus_weeks.empty? %>
<p class="nodata"><%= l(:label_no_data) %></p>
<% else %>
<div class="autoscroll">
<table class="list tech-bonus-weeks">
<thead>
<tr>
<th><%= l(:label_tech_bonus_week) %></th>
<th><%= l(:label_tech_bonus_hours_total_goal) %></th>
<th><%= l(:label_tech_bonus_tiers) %></th>
<th><%= l(:label_tech_bonus_credits) %></th>
<th><%= l(:label_tech_bonus_amount) %></th>
<th><%= l(:label_tech_bonus_run_by) %></th>
</tr>
</thead>
<tbody>
<% @bonus_weeks.each do |bonus_week| %>
<tr>
<td><%= link_to bonus_week_title(bonus_week.week), tech_bonus_week_path(bonus_week.week.to_param) %></td>
<td class="<%= bonus_week.goal_met? ? 'tech-bonus-ok' : 'tech-bonus-miss' %>">
<%= bonus_hours(bonus_week.total_hours) %>/<%= bonus_hours(bonus_week.goal_hours) %>
</td>
<td><%= bonus_week.tiers %></td>
<td>
<%= bonus_week.credits.count(&:credited?) %>
<% failed = bonus_week.credits.count { |credit| credit.status == 'failed' } %>
<% if failed.positive? %><span class="tech-bonus-error">(<%= l(:label_tech_bonus_failed_count, count: failed) %>)</span><% end %>
</td>
<td><%= bonus_money(bonus_week.credited_total) %></td>
<td><%= bonus_week.run_by ? link_to_user(bonus_week.run_by) : '' %> <%= format_time(bonus_week.updated_at) %></td>
</tr>
<% end %>
</tbody>
</table>
</div>
<% end %>
<% html_title l(:label_tech_bonus_plural) %>
+153
View File
@@ -0,0 +1,153 @@
<%= render partial: 'tech_bonuses/styles' %>
<% report = @report %>
<% previous_week = @week - 1 %>
<% next_week = @week + 1 %>
<div class="contextual">
<%= link_to "« #{previous_week.label}", tech_bonus_week_path(previous_week.to_param) %>
<% if next_week.start_date <= Date.current %>
| <%= link_to "#{next_week.label} »", tech_bonus_week_path(next_week.to_param) %>
<% end %>
| <%= link_to sprite_icon('time', l(:label_tech_bonus_time_report)), report_time_entries_path(report.redmine_report_params), class: 'icon icon-time' %>
</div>
<h2><%= link_to l(:label_tech_bonus_plural), tech_bonuses_path %> » <%= bonus_week_title(@week) %></h2>
<div class="tech-bonus-summary">
<div class="box">
<%= l(:label_tech_bonus_total_hours) %>
<span class="value <%= report.goal_met? ? 'tech-bonus-ok' : 'tech-bonus-miss' %>"><%= bonus_hours(report.total_hours) %></span>
</div>
<div class="box">
<%= l(:label_tech_bonus_goal_hours) %>
<span class="value"><%= bonus_hours(report.goal_hours) %></span>
</div>
<div class="box">
<%= l(:label_tech_bonus_tiers) %>
<span class="value"><%= report.tiers %></span>
<%= l(:text_tech_bonus_tier_every, hours: bonus_hours(report.tier_hours)) %>
</div>
<div class="box">
<% if report.goal_met? %>
<%= l(:label_tech_bonus_next_tier) %>
<% else %>
<%= l(:label_tech_bonus_short_of_goal) %>
<% end %>
<span class="value"><%= bonus_hours(report.hours_to_next_tier) %></span>
</div>
</div>
<% unless @week.completed? %>
<p class="warning"><%= l(:text_tech_bonus_week_in_progress, date: format_date(@week.end_date)) %></p>
<% end %>
<h3><%= l(:label_tech_bonus_technicians) %></h3>
<% if report.lines.empty? %>
<p class="nodata"><%= l(:text_tech_bonus_no_technicians) %>
<% if User.current.admin? %><%= link_to l(:label_bonus_technician_new), new_bonus_technician_path %><% end %></p>
<% else %>
<%= form_tag tech_bonus_week_path(@week.to_param), method: :post, id: 'tech-bonus-run' do %>
<div class="autoscroll">
<table class="list tech-bonus-table">
<thead>
<tr>
<th><%= l(:label_user) %></th>
<th><%= l(:field_role) %></th>
<th><%= l(:label_tech_bonus_hours) %></th>
<th title="<%= l(:text_tech_bonus_attendance) %>"><%= l(:label_tech_bonus_attended) %></th>
<th><%= l(:label_tech_bonus_base) %></th>
<th><%= l(:label_tech_bonus_tier_bonus) %></th>
<th><%= l(:label_tech_bonus_amount) %></th>
<th><%= l(:label_tech_bonus_credit_memo) %></th>
<th><%= l(:field_status) %></th>
<th></th>
</tr>
</thead>
<tbody>
<% report.lines.each do |line| %>
<% tech = line.technician %>
<% credit = @credits[tech.user_id] %>
<% credited = credit&.credited? %>
<tr class="<%= 'ineligible' unless line.eligible? %>">
<td class="name"><%= link_to_user tech.user %><br><small><%= tech.customer&.name || l(:text_tech_bonus_no_customer) %></small></td>
<td><%= tech.role_name %></td>
<td><%= bonus_hours(line.hours) %></td>
<td>
<% if credited %>
<%= sprite_icon('checked', l(:general_text_Yes)) %>
<% elsif line.eligible? %>
<%= check_box_tag 'attended[]', tech.user_id, credit.nil? || credit.message != l(:text_tech_bonus_missed_shift),
id: "attended_#{tech.user_id}", disabled: !report.goal_met? %>
<% end %>
</td>
<% if credited %>
<td><%= bonus_money(credit.base_amount) %></td>
<td><%= bonus_money(credit.tier_amount) %></td>
<td><%= bonus_money(credit.amount) %></td>
<% else %>
<td><%= bonus_money(line.base_amount) %></td>
<td><%= bonus_money(line.tier_amount) %></td>
<td><%= bonus_money(line.amount) %></td>
<% end %>
<td><%= credit_memo_link(credit) %></td>
<td class="message">
<%= bonus_status_tag(credit) %>
<% message = credit&.message.presence || line.ineligible_reason %>
<% if credit&.emailed_to.present? %><br><small><%= credit.emailed_to %></small><% end %>
<% if message %><br><small><%= message %></small><% end %>
</td>
<td>
<% if credited %>
<%= link_to sprite_icon('email', l(:button_tech_bonus_resend)), resend_tech_bonus_credit_path(credit),
method: :post, class: 'icon icon-email',
data: { confirm: l(:text_tech_bonus_resend_confirm) } %>
<% end %>
</td>
</tr>
<% end %>
</tbody>
</table>
</div>
<p><em class="info"><%= l(:text_tech_bonus_attendance) %></em></p>
<% if @week.completed? %>
<p>
<% label = report.goal_met? ? l(:button_tech_bonus_run) : l(:button_tech_bonus_record) %>
<%= submit_tag label, data: { confirm: report.goal_met? ? l(:text_tech_bonus_run_confirm) : nil } %>
<% if @bonus_week %>
<em class="info"><%= l(:text_tech_bonus_already_run, user: @bonus_week.run_by&.name, time: format_time(@bonus_week.updated_at)) %></em>
<% end %>
</p>
<% end %>
<% end %>
<% end %>
<h3><%= l(:label_tech_bonus_shop_hours) %></h3>
<% if report.hours_by_user.empty? %>
<p class="nodata"><%= l(:label_no_data) %></p>
<% else %>
<% tech_ids = report.technicians.map(&:user_id) %>
<div class="autoscroll">
<table class="list tech-bonus-table">
<thead>
<tr><th><%= l(:label_user) %></th><th><%= l(:label_tech_bonus_hours) %></th></tr>
</thead>
<tbody>
<% report.hours_by_user.each do |user_id, hours| %>
<tr>
<td class="name">
<%= report.users[user_id] ? link_to_user(report.users[user_id]) : "##{user_id}" %>
<% unless tech_ids.include?(user_id) %><small>(<%= l(:text_tech_bonus_helping) %>)</small><% end %>
</td>
<td><%= bonus_hours(hours) %></td>
</tr>
<% end %>
</tbody>
<tfoot>
<tr><td class="name"><%= l(:label_total_time) %></td><td><%= bonus_hours(report.total_hours) %></td></tr>
</tfoot>
</table>
</div>
<% end %>
<% html_title "#{l(:label_tech_bonus_plural)} #{@week.label}" %>