Files
PowderCoatingLogix/src/PowderCoating.Core/Entities/QuoteItem.cs
T
spouliot 1eba50cf0f Add Custom Formula Item Templates with AI generation and wizard integration
Introduces per-company reusable NCalc2 pricing formula templates for complex
fabricated items (roof curbs, enclosures, welded frames). Templates support
two output modes — FixedRate (formula yields a dollar amount) and SurfaceAreaSqFt
(formula yields sq ft fed into the standard coating engine). Includes:

- CustomItemTemplate entity, migration (AddCustomItemTemplates), IUnitOfWork repo
- IsCustomFormulaItem / CustomItemTemplateId / FormulaFieldValuesJson flags on
  QuoteItem, JobItem, CreateQuoteItemDto; mapped in all 3 JobItemAssemblyService
  overloads and all existingItemsData JSON projections + pageMeta blocks
- ICustomFormulaAiService / CustomFormulaAiService: Claude-powered formula
  generator (natural language + optional diagram image) and NCalc2 evaluator
- CompanySettings CRUD endpoints: GetCustomItemTemplates, Create/Update/Delete,
  UploadTemplateDiagram, TemplateDiagram (blob serve), EvaluateFormula, GenerateFormulaFromAi
- Company Settings "Custom Formulas" tab + cfModal + company-settings-custom-formulas.js
- item-wizard.js: formula item type card, renderFormulaFields, wzFormulaRecalc
  (live evaluate via POST), collectStep2 formula branch, buildCardHtml / emitHiddenFields
- Formula badge in Quotes/Details and Jobs/Details; AI badge gap fixed in Jobs/Details
- Help article (CustomFormulaTemplates.cshtml), Help Index card, HelpController action,
  HelpKnowledgeBase entry; 225/225 unit tests passing

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-23 15:09:22 -04:00

73 lines
3.2 KiB
C#

namespace PowderCoating.Core.Entities;
public class QuoteItem : BaseEntity
{
public int QuoteId { get; set; }
public string Description { get; set; } = string.Empty;
public decimal Quantity { get; set; }
// Measurements (optional for quoting)
public decimal? SurfaceArea { get; set; }
public decimal SurfaceAreaSqFt { get; set; } // Surface area in square feet for pricing
// Catalog item reference (optional)
public int? CatalogItemId { get; set; } // Link to catalog item (optional)
// Pricing
public decimal UnitPrice { get; set; }
public decimal TotalPrice { get; set; }
// Cost breakdown snapshot (set at save time for breakdown display)
public decimal ItemMaterialCost { get; set; }
public decimal ItemLaborCost { get; set; }
public decimal ItemEquipmentCost { get; set; }
public bool IsGenericItem { get; set; }
public decimal? ManualUnitPrice { get; set; }
public decimal? PowderCostOverride { get; set; } // Optional unit price override for catalog items
public bool IsLaborItem { get; set; }
public bool IsSalesItem { get; set; }
public string? Sku { get; set; }
// Processing estimates
public bool RequiresSandblasting { get; set; }
public bool RequiresMasking { get; set; }
public int EstimatedMinutes { get; set; }
// Whether to add prep service labor cost on top of this item's base price.
// Defaults to false for catalog items (catalog price assumed to include standard labor);
// true for calculated items where prep is a separate billable add-on.
public bool IncludePrepCost { get; set; }
public string? Notes { get; set; }
// Part complexity level — applies a price multiplier for calculated items
// Values: "Simple" | "Moderate" | "Complex" | "Extreme"
public string? Complexity { get; set; }
// True when this item was generated via AI photo analysis.
// Must be persisted so that recalculations (Details view, Edit view) can
// honour ManualUnitPrice instead of running the regular pricing engine.
public bool IsAiItem { get; set; }
// AI-generated standardized tags (comma-separated, e.g. "automotive,tubular")
public string? AiTags { get; set; }
// Link to shared AI prediction record (null for non-AI items)
public int? AiPredictionId { get; set; }
public virtual AiItemPrediction? AiPrediction { get; set; }
// Custom formula item — see IsCustomFormulaItem routing in PricingCalculationService
public bool IsCustomFormulaItem { get; set; }
public int? CustomItemTemplateId { get; set; }
public virtual CustomItemTemplate? CustomItemTemplate { get; set; }
/// <summary>Snapshot of field name/value pairs used in the formula, stored as JSON for display on details views.</summary>
public string? FormulaFieldValuesJson { get; set; }
// Relationships
public virtual Quote Quote { get; set; } = null!;
public virtual CatalogItem? CatalogItem { get; set; }
public virtual ICollection<QuoteItemCoat> Coats { get; set; } = new List<QuoteItemCoat>();
public virtual ICollection<QuoteItemPrepService> PrepServices { get; set; } = new List<QuoteItemPrepService>();
}