{
  "title": "Gutter cleaning quote calculator field specification",
  "version": "1.0",
  "currency_representation": "Three-letter label; no conversion",
  "fields": [
    {
      "name": "length_unit",
      "type": "enum",
      "allowed": [
        "ft",
        "m"
      ],
      "required": true
    },
    {
      "name": "measured_length",
      "type": "finite number",
      "required": true,
      "exclusive_minimum": 0
    },
    {
      "name": "rate_per_length_unit",
      "type": "finite number",
      "required": true,
      "minimum": 0,
      "purpose": "Must use selected length unit."
    },
    {
      "name": "story_count",
      "type": "integer",
      "required": true,
      "minimum": 1,
      "maximum": 20,
      "purpose": "Descriptive scope only; does not generate factor or rate."
    },
    {
      "name": "height_access_factor",
      "type": "finite number",
      "required": true,
      "exclusive_minimum": 0,
      "purpose": "Entered by estimator."
    },
    {
      "name": "addons",
      "type": "array<object>",
      "required": false,
      "fields": [
        {
          "name": "addon_id",
          "type": "stable string",
          "required": true
        },
        {
          "name": "name",
          "type": "string",
          "required": true
        },
        {
          "name": "fixed_amount",
          "type": "finite number",
          "required": true,
          "minimum": 0
        }
      ]
    },
    {
      "name": "minimum_charge",
      "type": "finite number",
      "required": true,
      "minimum": 0
    },
    {
      "name": "currency",
      "type": "string",
      "required": true,
      "pattern": "^[A-Z]{3}$"
    }
  ],
  "formula": {
    "base": "length * own rate per same length unit * user factor",
    "subtotal": "base + sum(fixed add-ons)",
    "minimum_adjustment": "max(0, minimum - subtotal)",
    "total": "subtotal + minimum adjustment"
  },
  "validation": [
    "Do not infer factor from story count.",
    "Length and rate use the same unit.",
    "Do not insert default regional/industry rates.",
    "Exports are itemized CSV and quote PDF.",
    "Tool does not submit a quote request to a nonexistent endpoint."
  ]
}
