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
@@ -265,12 +265,15 @@ public static class HelpKnowledgeBase
**Job Priorities (color-coded):**
- Low (grey), Normal (blue), High (orange), Urgent (red), Rush (purple)
**Jobs list default view:** The Jobs list opens on the **On Floor** filter by default showing only active jobs (excludes Completed, Ready for Pickup, Delivered, Cancelled). Use the filter pills at the top to switch views: **All** shows every job regardless of status; **On Floor** shows active work; **Overdue** shows past-due active jobs; **Ready** shows jobs awaiting customer pickup; **Completed** shows all finished jobs (Completed + Ready for Pickup + Delivered). Each pill shows a live global count.
**How to create a job:**
1. Go to [Jobs](/Jobs) "New Job"
2. Select customer
3. Add line items (same wizard as quotes: Calculated, Custom Work, or AI Photo)
4. Set priority, due date, assigned worker, special instructions
5. Save
5. Optionally set Oven & Batch Settings select a named oven, number of batches, and cycle time. These affect the oven cost in pricing.
6. Save
**Job Priority Board:** [/JobsPriority](/JobsPriority) Kanban-style view of all active jobs sorted by priority and status.
@@ -302,7 +305,9 @@ public static class HelpKnowledgeBase
**Changing the customer on a job:** On the Job Details page, the Customer field is an always-visible dropdown. Select a different customer a confirmation banner appears. Click **Save** to apply or **Cancel** to revert. Use this to correct a misassigned job or to move a walk-in job to a customer's proper record after they've been added to the system.
**Creating an invoice from a job:** On the Job Details page, look for the Invoice section and click "Create Invoice." The system pre-fills all line items, pricing, discount, tax rate, payment terms, and due date from the job and customer automatically. Review the Totals panel on the right if a discount was applied to the job it will show as a red "Discount Applied" line. Adjust anything you need, then save.
**Completing a job:** When a job is ready to mark complete, click the **Complete Job** button on the Job Details page. A modal appears asking you to confirm the completion date, actual hours spent, and final price. If the job used powder from inventory, you will be asked to enter the actual lbs used the modal groups all coats by unique powder color (not per coat or per item) so you fill in one quantity per powder. The system deducts the entered amounts from inventory, crediting any quantities already logged via QR scan. Once confirmed, the job advances to Completed status, and you are prompted to create the invoice if one does not exist.
**Creating an invoice from a job:** On the Job Details page, look for the Invoice section and click "Create Invoice." The system pre-fills all line items, pricing, discount, tax rate, payment terms, and due date from the job and customer automatically. Line item descriptions include the coat color(s) for each item (e.g., "Color1 / Color2" if multiple coats), helping customers distinguish repeated items on the invoice. Review the Totals panel on the right if a discount was applied to the job it will show as a red "Discount Applied" line. Adjust anything you need, then save.
**Work Order QR Codes:** Every printed job work order includes two tiers of QR codes one for viewing the job, and a separate set for taking action on it. All QR codes require the worker to be logged in.
+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>