feat: add INSPECTION_FAILED state, enforce inspection scheduling locks, and improve adjustment round UI for section locking and remark labeling

libs/api/src/lib/features/licensing/licensing.helpers.ts

@@ -67,6 +67,7 @@ export const STATUS_LABELS: Record<LicenseStatus, string> = {
   RESUBMIT_REQUIRED: 'Resubmit Required',
   INSPECTION_PENDING: 'Inspection Pending',
   INSPECTION_COMPLETED: 'Inspection Completed',
+  INSPECTION_FAILED: 'Inspection Failed',
   APPROVED: 'Approved',
   REJECTED: 'Rejected',
   ON_HOLD: 'On Hold',
@@ -94,6 +95,8 @@ export const STATUS_COLORS: Record<LicenseStatus, string> = {
   RESUBMIT_REQUIRED: 'orange',
   INSPECTION_PENDING: 'cyan',
   INSPECTION_COMPLETED: 'cyan',
+  // Orange, not red: recoverable — a re-inspection can still pass.
+  INSPECTION_FAILED: 'orange',
   APPROVED: 'teal',
   REJECTED: 'red',
   ON_HOLD: 'gray',
@@ -127,6 +130,8 @@ export const STATUS_PROGRESS: Record<LicenseStatus, number> = {
   RESUBMIT_REQUIRED: 30,
   INSPECTION_PENDING: 55,
   INSPECTION_COMPLETED: 65,
+  // A re-inspection returns to the pending step, so no further along than it.
+  INSPECTION_FAILED: 55,
   APPROVED: 75,
   // Parked, so it keeps the progress of wherever it was held from.
   ON_HOLD: 45,
@@ -376,6 +381,10 @@ const ERROR_MESSAGES: Record<string, string> = {
   application_not_awaiting_inspection:
     'This application is not waiting for an inspection.',
   inspection_already_completed: 'This inspection has already been recorded.',
+  inspection_not_yet_due:
+    'Inspection results can be recorded after the scheduled inspection date and time.',
+  inspection_not_passed:
+    'Approval requires a passed inspection. Schedule a re-inspection or request corrections.',
   license_type_inactive: 'This licence type is not currently accepting applications.',
 };
 

libs/api/src/lib/features/licensing/licensing.types.ts

@@ -29,6 +29,10 @@ export type LicenseStatus =
   | "RESUBMIT_REQUIRED"
   | "INSPECTION_PENDING"
   | "INSPECTION_COMPLETED"
+  // The inspection was conducted and failed. Approval and issuance are
+  // unreachable until a re-inspection passes; the officer chooses between a
+  // repeat visit, an adjustment round, and rejection.
+  | "INSPECTION_FAILED"
   | "APPROVED"
   | "REJECTED"
   | "ON_HOLD"