{
  "project": "voltbridge_web",
  "last_updated": "2026-06-06T21:48:53+08:00",
  "status": "planned_waiting_ping_provider_decision",
  "current_behavior": {
    "mailto_fallback": true,
    "recipient": "rfq@voltbridgeglobal.com",
    "backend_enabled": false,
    "crm_auto_write": false
  },
  "recommended_endpoint": {
    "method": "POST",
    "path": "/api/inquiries",
    "content_type": "application/json",
    "same_origin_preferred": true,
    "success_status": 202
  },
  "required_core_fields": [
    "name",
    "email",
    "category",
    "testedProduct",
    "range",
    "quantity",
    "destination",
    "message"
  ],
  "optional_fields": [
    "company",
    "buyerType",
    "modelEquivalent",
    "scenario",
    "interface",
    "documents",
    "standards",
    "timeline",
    "urgency",
    "decisionStage",
    "deliveryQuestion",
    "confirmationPriority"
  ],
  "source_tracking": {
    "capture_client_side": [
      "sourcePage",
      "utm_source",
      "utm_medium",
      "utm_campaign",
      "utm_term",
      "utm_content",
      "source",
      "category"
    ],
    "do_not_email_or_store_by_default": [
      "full_referrer",
      "ip_address",
      "user_agent"
    ],
    "server_side_allowed_for_security_only": [
      "ip_hash_or_rate_limit_key",
      "timestamp",
      "origin"
    ]
  },
  "anti_spam_controls": [
    "honeypot field",
    "Turnstile or equivalent challenge after provider decision",
    "server-side field length limits",
    "origin check",
    "rate limit by IP hash or edge key",
    "reject links in first message above threshold"
  ],
  "notification_contract": {
    "to": "rfq@voltbridgeglobal.com",
    "subject_template": "VoltBridge inquiry: {category} - {company_or_name}",
    "include": [
      "inquiryId",
      "readiness score",
      "core buyer fields",
      "technical/commercial fields",
      "source tracking",
      "confirmation boundary note"
    ]
  },
  "response_contract": {
    "success": {
      "status": 202,
      "body": {
        "ok": true,
        "inquiryId": "VBG-YYYYMMDD-0001",
        "message": "Inquiry received for review."
      }
    },
    "validation_error": {
      "status": 400,
      "body": {
        "ok": false,
        "error": "missing_required_fields",
        "fields": [
          "email"
        ]
      }
    },
    "spam_or_rate_limit": {
      "status": 429,
      "body": {
        "ok": false,
        "error": "try_again_later"
      }
    }
  },
  "implementation_gate": {
    "requires_ping_decision": [
      "hosting/provider target",
      "notification mailbox",
      "anti-spam provider or challenge preference",
      "whether to store submissions, email only, or add CRM later",
      "credential owner and secret storage path",
      "publish/deploy approval"
    ]
  }
}