Update AI assistant and help docs for recent changes

HelpKnowledgeBase:
- Jobs list: document On Floor default view and 5 filter pills (All/On Floor/Overdue/Ready/Completed) with global counts
- Creating a job: add Oven & Batch Settings step
- Completing a job: new entry explaining Complete Job modal, per-color powder grouping, QR scan credit
- Invoice from job: note that coat colors appear in line item descriptions

Help/Jobs.cshtml:
- Overview: mention On Floor default and filter pills
- Creating a job: add oven/batch settings step in the numbered list
- New "Completing a Job" section: modal fields, powder grouping by color, QR credit, SMS behavior
- Invoice from job step: mention coat color in line item descriptions
- Add "Completing a Job" to page nav

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-19 20:15:58 -04:00
parent 24f3df1bbc
commit 9b34ff564e
2 changed files with 55 additions and 6 deletions
+48 -4
View File
@@ -25,9 +25,13 @@
a priority level, a due date, and one or more line items describing the work to be performed.
</p>
<p>
You can find Jobs under <strong>Operations &rsaquo; Jobs</strong> in the left sidebar. The list is
searchable and sortable by job number, status, priority, scheduled date, due date, and price. Jobs
can be created manually or converted automatically from an approved quote — no need to re-enter
You can find Jobs under <strong>Operations &rsaquo; Jobs</strong> in the left sidebar. The list
opens on the <strong>On Floor</strong> filter by default, showing only active in-progress work
so completed jobs don&rsquo;t clutter the screen. Use the filter pills at the top to switch
views: <strong>All</strong>, <strong>On Floor</strong>, <strong>Overdue</strong>,
<strong>Ready</strong> (awaiting pickup), and <strong>Completed</strong>. The list is sortable
and searchable by job number, status, priority, scheduled date, due date, and price. Jobs can be
created manually or converted automatically from an approved quote &mdash; no need to re-enter
information that is already in the system.
</p>
<div class="alert alert-permanent alert-info d-flex gap-2 mb-0" role="alert">
@@ -54,6 +58,11 @@
<li class="mb-2">Enter the customer's <strong>PO Number</strong> if they require one for their own records.</li>
<li class="mb-2">Add any <strong>Special Instructions</strong> your team needs to know before starting work.</li>
<li class="mb-2">Add one or more <strong>Line Items</strong> describing each piece being coated. See the Job Items section below.</li>
<li class="mb-2">
Optionally expand <strong>Oven &amp; Batch Settings</strong> to assign a named oven, set the
number of batches, and enter the cure cycle time. These values feed directly into the oven cost
calculation so the job&rsquo;s pricing reflects the actual oven run.
</li>
<li class="mb-2">Click <strong>Save Job</strong>.</li>
</ol>
<p>
@@ -353,7 +362,7 @@
<li>If an invoice already exists, you will see a link to open it.</li>
</ul>
</li>
<li class="mb-2">Click <strong>Create Invoice</strong>. The system generates a new invoice pre-filled with all the job's line items and the final pricing.</li>
<li class="mb-2">Click <strong>Create Invoice</strong>. The system generates a new invoice pre-filled with all the job&rsquo;s line items and the final pricing. Line item descriptions include the coat color(s) for each item (e.g., <em>Gloss Black / Satin Clear</em>), which helps customers distinguish repeated items such as multiple sets of calipers.</li>
<li class="mb-2">Review the invoice, confirm the due date, and save it.</li>
</ol>
<p>
@@ -370,6 +379,40 @@
</div>
</section>
<section id="completing-a-job" class="mb-5">
<h2 class="h4 fw-bold border-bottom pb-2 mb-3">
<i class="bi bi-check-circle text-primary me-2"></i>Completing a Job
</h2>
<p>
When work is done and the parts have passed quality check, click the <strong>Complete Job</strong>
button on the Job Details page. A modal opens where you confirm:
</p>
<ul class="mb-3">
<li><strong>Completion date</strong> &mdash; defaults to today.</li>
<li><strong>Actual hours spent</strong> on the job.</li>
<li><strong>Final price</strong> &mdash; pre-filled from the job; adjust if needed.</li>
<li>
<strong>Powder usage</strong> &mdash; if the job used powder from inventory, you are asked
to enter actual lbs used. The modal groups all coats by <em>unique powder color</em> and
shows one input row per powder, regardless of how many items or coats used that color.
This avoids entering the same number repeatedly. Any lbs already scanned via QR code on
the shop floor are credited automatically &mdash; you only enter the remaining amount.
</li>
</ul>
<p>
Once confirmed, the job advances to <span class="badge bg-success">Completed</span> status,
inventory is updated, and you are prompted to create an invoice if one does not already exist.
</p>
<div class="alert alert-permanent alert-info d-flex gap-2 mb-0" role="alert">
<i class="bi bi-lightbulb-fill flex-shrink-0 mt-1"></i>
<div>
Shop floor workers who complete a job via QR scan bypass the modal &mdash; the SMS
notification is sent immediately using the configured template. Managers and admins
get the full modal with a compose step before the SMS goes out.
</div>
</div>
</section>
<section id="photos-notes" class="mb-5">
<h2 class="h4 fw-bold border-bottom pb-2 mb-3">
<i class="bi bi-camera text-primary me-2"></i>Photos and Notes
@@ -699,6 +742,7 @@
<a class="nav-link py-1 px-3 small text-body" href="#job-items">Job Items</a>
<a class="nav-link py-1 px-3 small text-body" href="#converting-from-quote">Converting from a Quote</a>
<a class="nav-link py-1 px-3 small text-body" href="#creating-an-invoice">Creating an Invoice</a>
<a class="nav-link py-1 px-3 small text-body" href="#completing-a-job">Completing a Job</a>
<a class="nav-link py-1 px-3 small text-body" href="#photos-notes">Photos and Notes</a>
<a class="nav-link py-1 px-3 small text-body" href="#time-and-rework">Time Entries and Rework</a>
<a class="nav-link py-1 px-3 small text-body" href="#job-templates">Job Templates</a>