id: eo_business_card_ocr
version: "1.0.0"
task_type: eo_business_card_ocr
description: Post-process OCR output from business card scanning into structured contact data with company type enrichment for Flexoptix sales team
model_preference: qwen2.5:7b
model_minimum: qwen2.5:3b
temperature: 0.1
max_tokens: 1024
output_format: json

system_prompt: |
  You are a contact data specialist for EO Global Pulse, the Flexoptix sales team collaboration platform.
  Your task is to clean and structure raw OCR output from business card scans, and enrich with inferred company type.

  Return ONLY valid JSON:
  {
    "name": "string",
    "title": "string or null",
    "company": "string",
    "email": "string or null",
    "phone": "string or null",
    "phone_mobile": "string or null",
    "linkedin": "string or null",
    "website": "string or null",
    "address": {
      "street": "string or null",
      "city": "string or null",
      "country": "string or null",
      "country_code": "ISO 3166-1 alpha-2 or null"
    },
    "company_type": "ISP|IXP|carrier|DC|cloud|vendor|enterprise|NOG|research|government|unknown",
    "company_type_confidence": 1-10,
    "company_type_reasoning": "string",
    "flexoptix_relevance": 1-10,
    "flexoptix_relevance_reasoning": "string",
    "ocr_quality": "clean|noisy|partial",
    "corrections_made": ["list of corrections applied to OCR output"]
  }

  Company type inference rules (based on company name, domain, title):
  - ISP: "Internet", "Telecom", "Communications", ".isp", broadband provider indicators
  - IXP: "Internet Exchange", "IX", "AMSIX", "DE-CIX", "LINX", "AMS-IX" in name
  - carrier: "Telekom", "Telecom", "T-Systems", "Orange", "BT", "Lumen", "NTT" — large carriers
  - DC: "Data Center", "Datacenter", "Colocation", "Colo", "Equinix", "Digital Realty"
  - cloud: "AWS", "Azure", "Google Cloud", "Cloudflare", "Fastly", "Akamai"
  - vendor: Hardware/software vendor (not Flexoptix itself), networking equipment companies
  - enterprise: Large company with own network infrastructure (bank, manufacturer, university)
  - NOG: Network Operator Group, regional NOG organizations
  - research: University, research institute, RIPE, ARIN, APNIC
  - government: Government agency with network infrastructure

  Flexoptix relevance (for a network equipment company focused on optical transceivers):
  - 10: IXP, large ISP, carrier, DC operator — direct buyers of transceivers in volume
  - 7-9: Mid-size ISP, enterprise with own network, managed service provider
  - 4-6: Vendor (potential partner), research (academic partnership)
  - 1-3: Enterprise end-user with limited network, consultant, non-technical role

  OCR correction rules:
  - Fix common OCR errors: 0→O, 1→l in names, rn→m
  - Normalize phone numbers to international format (+XX...)
  - Fix email addresses: remove spaces, fix .corn→.com, etc.
  - If LinkedIn URL is partial, complete to linkedin.com/in/...

  {{few_shot_examples}}

user_template: |
  Raw OCR output from business card:
  {{ocr_text}}

  Event context: {{event_context}}

  Process and structure this contact:

few_shot_examples:
  - user: |
      Raw OCR output from business card:
      Markus Sch0lz
      Senior Network Engineer
      DE-C|X German Internet Exchange
      m.scholz@de-cix net
      +49 69 1730902-0
      www.de-cix.net
      Seilerstr. 31 · 60313 Frankfurt

      Event context: DENOG 39, Frankfurt
    assistant: |
      {
        "name": "Markus Scholz",
        "title": "Senior Network Engineer",
        "company": "DE-CIX German Internet Exchange",
        "email": "m.scholz@de-cix.net",
        "phone": "+49 69 1730902-0",
        "phone_mobile": null,
        "linkedin": null,
        "website": "https://www.de-cix.net",
        "address": {
          "street": "Seilerstr. 31",
          "city": "Frankfurt",
          "country": "Germany",
          "country_code": "DE"
        },
        "company_type": "IXP",
        "company_type_confidence": 10,
        "company_type_reasoning": "DE-CIX is one of the world's largest Internet Exchange Points, headquartered in Frankfurt. Name explicitly contains 'Internet Exchange'.",
        "flexoptix_relevance": 10,
        "flexoptix_relevance_reasoning": "DE-CIX operates massive switching infrastructure and is a high-volume buyer of optical transceivers for their peering switches and metro transport links. Direct sales opportunity.",
        "ocr_quality": "noisy",
        "corrections_made": [
          "Sch0lz → Scholz (0 was OCR error for o)",
          "DE-C|X → DE-CIX (| was OCR error for I)",
          "m.scholz@de-cix net → m.scholz@de-cix.net (missing period in domain)"
        ]
      }

variables:
  - ocr_text
  - event_context
  - few_shot_examples

validation_rules:
  output_must_be_json: true
  required_fields: ["name", "company", "company_type", "flexoptix_relevance"]