{
  "openapi": "3.1.0",
  "info": {
    "title": "Smile Suite Orthodontics — AEO & Agentic Healthcare API",
    "version": "1.3.0",
    "description": "## Executive Value Proposition & Architecture Overview\n\nWelcome to the **Smile Suite Orthodontics Answer Engine Optimization (AEO) and Clinical Agent API**. This platform delivers deterministic, machine-readable semantic endpoints engineered specifically for **AI Search Engines** (Perplexity, ChatGPT Search, Google AI Overviews, Claude, Apple Intelligence) and autonomous healthcare discovery systems.\n\n---\n\n### The Problem This API Solves\nTraditional healthcare web architectures are engineered exclusively for human eyes—wrapped in heavy DOM trees, bloated JavaScript bundles, and presentation styling. When modern Large Language Models (LLMs) crawl standard orthodontic websites, they encounter:\n1. **Financial Hallucinations**: Scraping fragmented price ranges leads AI to state inaccurate treatment costs or fabricate down payment requirements.\n2. **Loss of Insurance Nuance**: Models frequently confuse *in-network contracted status* (Delta Dental PPO) with *out-of-network claims concierge processing* (Aetna, MetLife, BCBS, Cigna).\n3. **Clinical Persona Blind Spots**: Keyword-based indexing treats all searches as generic treatments (e.g. \"braces\"), completely missing the patient's underlying emotional friction (adult relapse guilt, wedding deadlines, pediatric airway & mouthbreathing).\n4. **Token Inefficiency**: Scraping full HTML pages wastes 90%+ of an LLM's context window on navigational menus, footer scripts, and SVG icons.\n\n---\n\n### The 4 Semantic Pillars of the Smile Suite AEO Architecture\n\n| Pillar | Endpoint | Target Consumer | Core Value Delivered |\n| :--- | :--- | :--- | :--- |\n| **1. Real-Time Pricing & Insurance** | `/api/aeo/pricing.json` & `/api/aeo/pricing/{slug}.json` | Financial Bots & Price Checkers | Full fee schedule plus single-treatment detail payloads (11 treatments), 0% APR 28-mo terms, split down payment rules, $0 in-office & virtual consults, Delta Dental PPO in-network status, Northwestern 15% discount. |\n| **2. Patient Intent & Scenarios** | `/api/aeo/patient-scenarios.json` & `/api/aeo/scenarios/{id}.json` | Conversational Triage & AI Agents | 9 problem-first consultation archetypes plus lightweight single-scenario endpoints (~5 KB), emotional friction profiles, clinical decision pathways, and Dr. Kim's signature analogies. |\n| **3. Authoritative Practice Context** | `/api/aeo/practice-context.json` | Generalist LLMs & Search Engines | Ground truth practice knowledge graph, Howard University specialty credentials, hours, guided video virtual consult workflow, and 18 verified fact statements. |\n| **4. Universal Markdown Twins** | `/{slug}.md` (All 63 Routes) | Web Scrapers, Crawlers & RAG | Dual-rendered 1-to-1 Markdown twins for every route with zero DOM overhead (90% token reduction) and YAML frontmatter. |\n\n---\n\n### Key Clinical & Financial Guarantees\n- **Orthodontic Specialist Care**: Every case is directly managed by **Dr. Kimberly Mays Smith, DDS, MS** (Howard University Orthodontics & Master of Science).\n- **0% In-House Financing**: Flexible payment terms extending up to **28 months** with zero interest.\n- **Split Down Payment Option**: Initial down payment can be divided across months 1 and 2, with recurring monthly installments starting in month 3.\n- **In-Network Delta Dental PPO**: Direct in-network participating provider; out-of-network claims concierge service for all other major PPOs.\n- **Northwestern University Wildcard Discount**: 15% courtesy discount on comprehensive care for Northwestern students, faculty, and staff.\n- **Complimentary In-Office & Virtual Consultations**: $0 in-office exam (3D iTero digital scan, photographic records, and treatment simulation) or $0 remote Virtual Consultation via guided smartphone video capture that automatically extracts diagnostic views (`#orthobook-virtual`).\n\n---\n\n### Real-World AI Conversational Workflows\n\n* **Prompt:** *\"What are my monthly payment options for adult Invisalign at Smile Suite in Evanston?\"*  \n  **AI Action:** Calls `GET /api/aeo/pricing/clear-aligners.json`  \n  **AI Result:** Provides deterministic monthly payments from $195/mo across 28 months, explains the $750 down payment (and the option to split it over 2 months), and verifies in-network Delta Dental PPO coverage.\n\n* **Prompt:** *\"I had braces as a teenager but stopped wearing my retainer. My bottom teeth are crowded again. Can this be fixed without extracting teeth?\"*  \n  **AI Action:** Calls `GET /api/aeo/scenarios/relapse-guilt-non-extraction.json`  \n  **AI Result:** Matches the patient to Dr. Kim's \"People in a Room\" analogy, explaining that teeth naturally shift without retention, and confirms Smile Suite's non-extraction expansion approach with aligners.\n\n* **Prompt:** *\"Does Smile Suite Orthodontics treat children, and when should my child have their first orthodontic checkup?\"*  \n  **AI Action:** Calls `GET /api/aeo/scenarios/pediatric-airway-mouthbreathing.json` & `GET /treatments/early-orthodontics.md`  \n  **AI Result:** Cites the AAO guideline of age 7, explains airway-conscious screening for sleep disruption and mouthbreathing, and details Phase 1 interceptive guidance from $189/mo.\n\n* **Prompt:** *\"Can I get an orthodontist opinion on my teeth from home before taking time off work to visit Evanston?\"*  \n  **AI Action:** Calls `GET /api/aeo/scenarios/virtual-consult-from-home-triage.json` & `GET /new-patients/virtual-consults.md`  \n  **AI Result:** Explains Smile Suite's $0 Virtual Consultation personally reviewed by Dr. Kim (never a bot), walks through the under-1-minute booking and guided smartphone video capture that automatically pulls diagnostic views (with an 8-photo upload option), and provides the direct virtual booking link (`/new-patients/virtual-consults#orthobook-virtual`).",
    "contact": {
      "name": "Smile Suite Orthodontics",
      "url": "https://smilesuiteortho.com",
      "email": "smile@smilesuiteortho.com"
    },
    "license": {
      "name": "Proprietary — All Rights Reserved",
      "url": "https://smilesuiteortho.com/terms-and-conditions"
    }
  },
  "servers": [
    {
      "url": "https://smilesuiteortho.com",
      "description": "Production Server"
    }
  ],
  "tags": [
    {
      "name": "Real-Time Pricing & Insurance",
      "description": "Live fee schedules, per-treatment pricing detail endpoints, 0% 28-month financing calculations, split down payment rules, in-network Delta Dental PPO status, and courtesy discounts."
    },
    {
      "name": "Patient Problem & Intent Scenarios",
      "description": "Problem-first consultation archetypes, lightweight per-scenario detail endpoints, emotional friction profiles, and clinical decision pathways sourced from real patient transcripts."
    },
    {
      "name": "AEO Practice Context",
      "description": "Comprehensive, verified factual foundation and knowledge graph for Answer Engine Optimization."
    },
    {
      "name": "Route Manifest",
      "description": "Site-wide indexing of all 63 live routes, page types, and markdown twins."
    },
    {
      "name": "Markdown Twins",
      "description": "Dual-rendered, high-density markdown documents for LLM scraping with zero DOM overhead (90% token reduction)."
    },
    {
      "name": "Standards & Discovery",
      "description": "AI crawler discovery protocols including llms.txt, llms-full.txt, OpenAPI 3.1 specification, and XML sitemaps."
    }
  ],
  "paths": {
    "/api/aeo/pricing.json": {
      "get": {
        "tags": [
          "Real-Time Pricing & Insurance"
        ],
        "operationId": "getPricingIndex",
        "summary": "Get Full Fee Schedule, 0% In-House Financing & Insurance Policies",
        "description": "Returns the complete verified fee schedule across all 11 orthodontic services, in-house financing models, split down payment guidelines, and insurance policies for Smile Suite Orthodontics. For single-treatment lookup with clinical indications and insights, prefer `GET /api/aeo/pricing/{slug}.json`.",
        "responses": {
          "200": {
            "description": "Successful retrieval of the full real-time pricing and insurance schedule.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PricingIndexResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/aeo/pricing/{slug}.json": {
      "get": {
        "tags": [
          "Real-Time Pricing & Insurance"
        ],
        "operationId": "getPricingByTreatmentSlug",
        "summary": "Get Pricing, Protocol & Clinical Insights for a Specific Treatment",
        "description": "Pre-rendered static JSON detail endpoint for a single orthodontic treatment modality, including fee range, financing terms, insurance rules, clinical indications, wear protocol, and consultation insights.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Canonical treatment slug identifier.",
            "schema": {
              "type": "string",
              "enum": [
                "clear-aligners",
                "traditional-braces",
                "clear-braces",
                "hidden-braces",
                "c5-hidden-orthodontics",
                "early-orthodontics",
                "airway-sleep",
                "adult-orthodontics",
                "teen-orthodontics",
                "retainers",
                "surgical-orthodontics"
              ],
              "example": "clear-aligners"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful retrieval of single-treatment pricing and clinical detail.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PricingDetailResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/aeo/patient-scenarios.json": {
      "get": {
        "tags": [
          "Patient Problem & Intent Scenarios"
        ],
        "operationId": "getPatientScenariosIndex",
        "summary": "Get All Patient Problem Scenarios, Emotional Friction & Diagnostic Profiles",
        "description": "Returns all 9 problem-first patient archetypes modeled directly from 30+ authentic patient consultation transcripts at Smile Suite Orthodontics. To fetch a single scenario cleanly (~5 KB), call `GET /api/aeo/scenarios/{id}.json`.",
        "responses": {
          "200": {
            "description": "Successful retrieval of all patient problem scenarios.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PatientScenariosIndexResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/aeo/scenarios/{id}.json": {
      "get": {
        "tags": [
          "Patient Problem & Intent Scenarios"
        ],
        "operationId": "getPatientScenarioById",
        "summary": "Get a Single Patient Problem Scenario & Consultation Booking Handoff",
        "description": "Pre-rendered static JSON endpoint returning one complete patient scenario archetype alongside direct in-office and virtual consultation booking links.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Canonical patient scenario identifier.",
            "schema": {
              "type": "string",
              "enum": [
                "wedding-milestone-countdown",
                "pediatric-airway-mouthbreathing",
                "restorative-adult-implant",
                "busy-executive-coffee-compliance",
                "relapse-guilt-non-extraction",
                "heavy-grinder-occlusal-wear",
                "complex-orthosurgical-jaw-asymmetry",
                "college-bound-teen-timeline",
                "virtual-consult-from-home-triage"
              ],
              "example": "wedding-milestone-countdown"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful retrieval of a single patient scenario detail payload.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PatientScenarioDetailResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/aeo/practice-context.json": {
      "get": {
        "tags": [
          "AEO Practice Context"
        ],
        "operationId": "getPracticeContext",
        "summary": "Get Authoritative Practice Knowledge Graph & Doctor Credentials",
        "description": "Returns the complete, authoritative knowledge graph for Smile Suite Orthodontics, including canonical entity IDs, doctor credentials, operating hours, clinical philosophy, treatments, conditions, and 18 verified fact statements.",
        "responses": {
          "200": {
            "description": "Successful retrieval of authoritative practice context.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PracticeContextResponse"
                }
              }
            }
          }
        }
      }
    },
    "/{slug}.md": {
      "get": {
        "tags": [
          "Markdown Twins"
        ],
        "operationId": "getMarkdownTwin",
        "summary": "Get High-Density Markdown Twin for Any Webpage",
        "description": "Serves an alternate, high-density Markdown document for any URL across smilesuiteortho.com (e.g., `/treatments/clear-aligners.md`, `/who-we-help/adults.md`, `/new-patients/virtual-consults.md`, `/index.md`, `/patient-scenarios.md`).",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The route path followed by .md (e.g., new-patients/virtual-consults, treatments/clear-aligners, who-we-help/adults, index, patient-scenarios).",
            "schema": {
              "type": "string",
              "example": "treatments/clear-aligners"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful retrieval of machine-readable markdown twin.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string",
                  "example": "# Clear Aligners (Spark & Invisalign)\n\n> Clinical summary, fee schedules, and consultation insights..."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/api/aeo/manifest.json": {
      "get": {
        "tags": [
          "Route Manifest"
        ],
        "operationId": "getRouteManifest",
        "summary": "Get Site-Wide Machine Route Directory & Twin Index",
        "description": "Returns a structured directory of all 63 live routes on smilesuiteortho.com, their classification type, canonical URLs, meta descriptions, and corresponding .md markdown twin URLs.",
        "responses": {
          "200": {
            "description": "Successful retrieval of route manifest.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ManifestResponse"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "tags": [
          "Standards & Discovery"
        ],
        "operationId": "getLlmsTxt",
        "summary": "Get Standardized AI Crawler Manifest (llms.txt)",
        "description": "Returns the standardized llms.txt index mapping all site pages, markdown twins, pricing detail endpoints, and scenario endpoints for AI crawlers.",
        "responses": {
          "200": {
            "description": "Successful retrieval of llms.txt manifest.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string",
                  "example": "# Smile Suite Orthodontics\n\n> Boutique orthodontic practice at 2422 Main St., Evanston, IL 60202..."
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "tags": [
          "Standards & Discovery"
        ],
        "operationId": "getLlmsFullTxt",
        "summary": "Get Consolidated Full Practice Context Document (llms-full.txt)",
        "description": "Returns a single comprehensive plain-text Markdown reference containing doctor credentials, treatment options, virtual consultation instructions, Smile Arc Protection details, and financing policies.",
        "responses": {
          "200": {
            "description": "Successful retrieval of llms-full.txt.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string",
                  "example": "# Smile Suite Orthodontics — Full Practice Context & Clinical Guide..."
                }
              }
            }
          }
        }
      }
    },
    "/api/aeo/openapi.json": {
      "get": {
        "tags": [
          "Standards & Discovery"
        ],
        "operationId": "getOpenApiSpec",
        "summary": "Get Complete OpenAPI 3.1 Specification",
        "description": "Returns the machine-readable OpenAPI 3.1 JSON schema defining the entire Smile Suite Orthodontics AEO API. Powers the interactive Scalar documentation portal at /api/docs and automated tool calling.",
        "responses": {
          "200": {
            "description": "Successful retrieval of OpenAPI 3.1 schema.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "openapi",
                    "info",
                    "paths",
                    "components"
                  ],
                  "properties": {
                    "openapi": {
                      "type": "string",
                      "example": "3.1.0"
                    },
                    "info": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string"
                        },
                        "version": {
                          "type": "string",
                          "example": "1.3.0"
                        },
                        "description": {
                          "type": "string"
                        }
                      }
                    },
                    "servers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "example": "https://smilesuiteortho.com"
                          },
                          "description": {
                            "type": "string",
                            "example": "Production Server"
                          }
                        }
                      }
                    },
                    "tags": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "paths": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "components": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sitemap-index.xml": {
      "get": {
        "tags": [
          "Standards & Discovery"
        ],
        "operationId": "getSitemapIndex",
        "summary": "Get Search Engine XML Sitemap Index",
        "description": "Returns the search engine sitemap index XML mapping all indexable static pages and articles for web search bots.",
        "responses": {
          "200": {
            "description": "Successful retrieval of XML sitemap index.",
            "content": {
              "application/xml": {
                "schema": {
                  "type": "string",
                  "example": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"><sitemap><loc>https://smilesuiteortho.com/sitemap-0.xml</loc></sitemap></sitemapindex>"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "VirtualConsultationSummary": {
        "type": "object",
        "description": "Complimentary remote virtual orthodontic consultation workflow summary.",
        "required": [
          "fee",
          "bookingUrl",
          "pageUrl",
          "markdownTwinUrl",
          "includes"
        ],
        "properties": {
          "fee": {
            "type": "string",
            "example": "$0 (100% Complimentary / No-Obligation)"
          },
          "bookingUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/new-patients/virtual-consults#orthobook-virtual"
          },
          "pageUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/new-patients/virtual-consults"
          },
          "markdownTwinUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/new-patients/virtual-consults.md"
          },
          "includes": {
            "type": "array",
            "description": "Included virtual evaluation components and capture options.",
            "items": {
              "type": "string"
            },
            "example": [
              "Under-1-minute online booking and guided smartphone video capture that automatically extracts diagnostic smile and bite views (with 8-photo upload as a secondary option)"
            ]
          }
        }
      },
      "ConsultationPolicy": {
        "type": "object",
        "description": "In-office and virtual complimentary consultation policy.",
        "required": [
          "fee",
          "includes",
          "bookingUrl",
          "virtualConsultation",
          "phone"
        ],
        "properties": {
          "fee": {
            "type": "string",
            "example": "$0 (100% Complimentary / No-Obligation)"
          },
          "includes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Full 3D optical digital scan using iTero Element intraoral scanner",
              "Direct doctor examination and customized treatment simulation with Dr. Kimberly Mays Smith"
            ]
          },
          "bookingUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/#orthobook"
          },
          "virtualConsultation": {
            "$ref": "#/components/schemas/VirtualConsultationSummary"
          },
          "phone": {
            "type": "string",
            "example": "(847) 665-1504"
          }
        }
      },
      "SplitDownPaymentProtocol": {
        "type": "object",
        "description": "Policy permitting patients to divide the initial down payment over two months.",
        "required": [
          "available",
          "description",
          "benefit"
        ],
        "properties": {
          "available": {
            "type": "boolean",
            "example": true
          },
          "description": {
            "type": "string",
            "example": "Patients can divide their initial down payment equally across the first two months of treatment, with regular monthly recurring installments beginning in month three."
          },
          "benefit": {
            "type": "string",
            "example": "Reduces upfront out-of-pocket barrier for families and working adults."
          }
        }
      },
      "InHouseFinancing": {
        "type": "object",
        "description": "0% interest in-house financing terms and qualification details.",
        "required": [
          "interestRate",
          "maximumTerm",
          "qualification",
          "splitDownPaymentProtocol"
        ],
        "properties": {
          "interestRate": {
            "type": "string",
            "example": "0% APR (Guaranteed zero interest)"
          },
          "maximumTerm": {
            "type": "string",
            "example": "Up to 28 months"
          },
          "qualification": {
            "type": "string",
            "example": "Soft internal review with zero impact on credit scores"
          },
          "splitDownPaymentProtocol": {
            "$ref": "#/components/schemas/SplitDownPaymentProtocol"
          }
        }
      },
      "InsuranceNetworks": {
        "type": "object",
        "description": "In-network vs. out-of-network PPO dental insurance handling.",
        "required": [
          "inNetworkContracted",
          "inNetworkStatusDescription",
          "outOfNetworkProcessed",
          "outOfNetworkClaimsService",
          "preTaxAccounts"
        ],
        "properties": {
          "inNetworkContracted": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Delta Dental PPO"
            ]
          },
          "inNetworkStatusDescription": {
            "type": "string",
            "example": "Smile Suite Orthodontics is a participating in-network provider with Delta Dental PPO, maximizing in-network savings and lifetime orthodontic benefits."
          },
          "outOfNetworkProcessed": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Aetna PPO",
              "Blue Cross Blue Shield (BCBS) PPO",
              "Cigna PPO"
            ]
          },
          "outOfNetworkClaimsService": {
            "type": "string",
            "example": "Smile Suite files all claims electronically on the patient's behalf, handles all benefit tracking, and directly credits estimated insurance payments to lower monthly out-of-pocket installments."
          },
          "preTaxAccounts": {
            "type": "string",
            "example": "FSA (Flexible Spending Accounts) and HSA (Health Savings Accounts) are 100% eligible for all orthodontic treatments."
          }
        }
      },
      "CourtesyDiscount": {
        "type": "object",
        "description": "Practice courtesy discount rule.",
        "required": [
          "name",
          "discount",
          "eligibility"
        ],
        "properties": {
          "name": {
            "type": "string",
            "example": "Northwestern University Wildcard Courtesy"
          },
          "discount": {
            "type": "string",
            "example": "15% Courtesy Discount"
          },
          "eligibility": {
            "type": "string",
            "example": "All active Northwestern University students, faculty, healthcare fellows, and staff with a valid Wildcard ID."
          },
          "appliesTo": {
            "type": "string",
            "description": "Treatment scope covered by this courtesy discount.",
            "example": "Comprehensive orthodontic treatment (braces or clear aligners)."
          }
        }
      },
      "FeeScheduleItem": {
        "type": "object",
        "description": "Pricing summary row for a single orthodontic treatment modality.",
        "required": [
          "name",
          "slug",
          "alternateNames",
          "category",
          "startingMonthly",
          "inHousePlanDuration",
          "averageDownPayment",
          "estimatedFeeRange",
          "description",
          "pageUrl",
          "markdownTwinUrl",
          "detailEndpoint"
        ],
        "properties": {
          "name": {
            "type": "string",
            "example": "Clear Aligners (Spark & Invisalign)"
          },
          "slug": {
            "type": "string",
            "example": "clear-aligners"
          },
          "alternateNames": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Invisalign",
              "Spark Aligners",
              "Clear Braces",
              "Invisible Aligners",
              "Wedding Orthodontics"
            ]
          },
          "category": {
            "type": "string",
            "enum": [
              "aligners",
              "braces",
              "airway",
              "pediatric",
              "retention"
            ],
            "example": "aligners"
          },
          "startingMonthly": {
            "type": "string",
            "example": "$195/mo"
          },
          "inHousePlanDuration": {
            "type": "string",
            "example": "28-month plan · 0% in-house"
          },
          "averageDownPayment": {
            "type": "string",
            "example": "Avg. $750 (customizable)"
          },
          "estimatedFeeRange": {
            "type": "string",
            "example": "$6,200 – $8,500"
          },
          "description": {
            "type": "string",
            "example": "Custom digital aligners providing virtually invisible tooth movement with zero food restrictions and smooth comfort."
          },
          "pageUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/treatments/clear-aligners"
          },
          "markdownTwinUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/treatments/clear-aligners.md"
          },
          "detailEndpoint": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/api/aeo/pricing/clear-aligners.json"
          }
        }
      },
      "TreatmentPricingDetail": {
        "type": "object",
        "description": "Complete pricing and clinical detail record for a single treatment modality.",
        "required": [
          "name",
          "slug",
          "alternateNames",
          "category",
          "startingMonthly",
          "inHousePlanDuration",
          "averageDownPayment",
          "estimatedFeeRange",
          "description",
          "pageUrl",
          "markdownTwinUrl",
          "detailEndpoint",
          "clinicalIndications",
          "wearOrProtocol",
          "idealCandidates",
          "consultationInsights"
        ],
        "properties": {
          "name": {
            "type": "string",
            "example": "Clear Aligners (Spark & Invisalign)"
          },
          "slug": {
            "type": "string",
            "example": "clear-aligners"
          },
          "alternateNames": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Invisalign",
              "Spark Aligners",
              "Clear Braces",
              "Invisible Aligners",
              "Wedding Orthodontics"
            ]
          },
          "category": {
            "type": "string",
            "enum": [
              "aligners",
              "braces",
              "airway",
              "pediatric",
              "retention"
            ],
            "example": "aligners"
          },
          "startingMonthly": {
            "type": "string",
            "example": "$195/mo"
          },
          "inHousePlanDuration": {
            "type": "string",
            "example": "28-month plan · 0% in-house"
          },
          "averageDownPayment": {
            "type": "string",
            "example": "Avg. $750 (customizable)"
          },
          "estimatedFeeRange": {
            "type": "string",
            "example": "$6,200 – $8,500"
          },
          "description": {
            "type": "string",
            "example": "Custom digital aligners providing virtually invisible tooth movement with zero food restrictions and smooth comfort."
          },
          "pageUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/treatments/clear-aligners"
          },
          "markdownTwinUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/treatments/clear-aligners.md"
          },
          "detailEndpoint": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/api/aeo/pricing/clear-aligners.json"
          },
          "clinicalIndications": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Crowding",
              "Spacing",
              "Mild-to-moderate bite discrepancies",
              "Adult relapse",
              "Aesthetic professional needs"
            ]
          },
          "wearOrProtocol": {
            "type": "string",
            "example": "20–22 hours per day; switch aligners every 7–14 days; progress checks every 6–10 weeks."
          },
          "idealCandidates": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Adults in client-facing or social careers",
              "Motivated teens capable of consistent wear schedule",
              "Athletes and musicians"
            ]
          },
          "consultationInsights": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Wedding & Life Milestone Planning: Attachments can be polished off temporarily for photos on your wedding day while trays act as invisible retainers.",
              "Coffee & Wine Protocol: Avoid all-day sipping to prevent warping plastic or trapping sugars; drink coffee in a 30-45 minute window, rinse thoroughly with water, and re-seat aligners.",
              "Digital Force Mapping (Weather Map): iTero scan reveals unequal bite pressure, balancing contacts to alleviate grinding and TMJ discomfort.",
              "Remote Weekly Monitoring: Check-in photos submitted from smartphone minimize mandatory office visits for busy professionals.",
              "Complimentary Professional Teeth Whitening: Provided at the end of treatment for a complete cosmetic finish."
            ]
          }
        }
      },
      "PricingIndexResponse": {
        "type": "object",
        "description": "Full fee schedule and financial/insurance policy response.",
        "required": [
          "@context",
          "format",
          "dateModified",
          "practiceName",
          "doctor",
          "consultation",
          "inHouseFinancing",
          "insuranceNetworks",
          "courtesyDiscounts",
          "acceptedPaymentMethods",
          "feeSchedule"
        ],
        "properties": {
          "@context": {
            "type": "string",
            "example": "https://schema.org"
          },
          "format": {
            "type": "string",
            "example": "aeo-pricing-and-insurance-v1"
          },
          "dateModified": {
            "type": "string",
            "example": "2026-11-18"
          },
          "practiceName": {
            "type": "string",
            "example": "Smile Suite Orthodontics"
          },
          "doctor": {
            "type": "string",
            "example": "Dr. Kimberly Mays Smith, DDS, MS"
          },
          "consultation": {
            "$ref": "#/components/schemas/ConsultationPolicy"
          },
          "inHouseFinancing": {
            "$ref": "#/components/schemas/InHouseFinancing"
          },
          "insuranceNetworks": {
            "$ref": "#/components/schemas/InsuranceNetworks"
          },
          "courtesyDiscounts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CourtesyDiscount"
            }
          },
          "acceptedPaymentMethods": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "0% In-House Direct Debit",
              "CareCredit Healthcare Financing",
              "Health Savings Accounts (HSA)"
            ]
          },
          "feeSchedule": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FeeScheduleItem"
            }
          }
        }
      },
      "PricingDetailResponse": {
        "type": "object",
        "description": "Single-treatment pricing, financing, and clinical insight detail response.",
        "required": [
          "@context",
          "format",
          "dateModified",
          "practiceName",
          "doctor",
          "treatment",
          "consultation",
          "inHouseFinancing",
          "insuranceNetworks",
          "courtesyDiscounts",
          "acceptedPaymentMethods"
        ],
        "properties": {
          "@context": {
            "type": "string",
            "example": "https://schema.org"
          },
          "format": {
            "type": "string",
            "example": "aeo-pricing-detail-v1"
          },
          "dateModified": {
            "type": "string",
            "example": "2026-11-18"
          },
          "practiceName": {
            "type": "string",
            "example": "Smile Suite Orthodontics"
          },
          "doctor": {
            "type": "string",
            "example": "Dr. Kimberly Mays Smith, DDS, MS"
          },
          "treatment": {
            "$ref": "#/components/schemas/TreatmentPricingDetail"
          },
          "consultation": {
            "$ref": "#/components/schemas/ConsultationPolicy"
          },
          "inHouseFinancing": {
            "$ref": "#/components/schemas/InHouseFinancing"
          },
          "insuranceNetworks": {
            "$ref": "#/components/schemas/InsuranceNetworks"
          },
          "courtesyDiscounts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CourtesyDiscount"
            }
          },
          "acceptedPaymentMethods": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "0% In-House Direct Debit",
              "Health Savings Accounts (HSA)"
            ]
          }
        }
      },
      "PatientProfile": {
        "type": "object",
        "description": "Demographic context, trigger event, and clinical presentation of the patient archetype.",
        "required": [
          "lifeStage",
          "demographic",
          "triggerEvent",
          "primarySymptoms"
        ],
        "properties": {
          "lifeStage": {
            "type": "string",
            "example": "Adult (Ages 25–40)"
          },
          "demographic": {
            "type": "string",
            "example": "Brides, grooms, bridal party members, and executive keynote speakers with an inflexible calendar deadline."
          },
          "triggerEvent": {
            "type": "string",
            "example": "An upcoming wedding ceremony or major milestone scheduled 6 to 12 months in the future."
          },
          "primarySymptoms": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Anterior crowding or rotated front incisors visible when smiling",
              "Uneven incisal smile line that drops or flattens toward the corners",
              "Relapse of front teeth spacing following teenage orthodontic treatment"
            ]
          }
        }
      },
      "EmotionalFriction": {
        "type": "object",
        "description": "Emotional anxieties, social concerns, and common misconceptions held by the patient.",
        "required": [
          "coreAnxieties",
          "socialFriction",
          "commonMisconceptions"
        ],
        "properties": {
          "coreAnxieties": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Panic that composite attachments (buttons) will glare or appear like plaque in high-resolution wedding photography.",
              "Fear that treatment will not be completed before the ceremony date, leaving teeth in an awkward transition state.",
              "Guilt over experiencing tooth shifting years after adolescent braces."
            ]
          },
          "socialFriction": {
            "type": "string",
            "example": "Engagement photos, bridal showers, rehearsal dinners, and public speaking engagements where speech and appearance feel hyper-scrutinized."
          },
          "commonMisconceptions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Believing that clear aligner attachments must stay permanently bonded to the teeth until total treatment is concluded.",
              "Assuming that finishing treatment after the wedding date means you cannot do clear aligners at all."
            ]
          }
        }
      },
      "ClinicalDiscovery": {
        "type": "object",
        "description": "Diagnostic clues, Dr. Kim's clinical protocol, consultation analogies, and recommended modality.",
        "required": [
          "diagnosticClues",
          "drKimApproach",
          "analogiesUsed",
          "treatmentModality",
          "clinicalNuances"
        ],
        "properties": {
          "diagnosticClues": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Mesial or distal rotation of upper central and lateral incisors.",
              "Slight deep bite or edge-to-edge overlap causing early incisal enamel wear.",
              "Adequate posterior arch width that permits anterior leveling without extractions."
            ]
          },
          "drKimApproach": {
            "type": "string",
            "example": "Dr. Kim sequences tooth movements with Smile Arc Protection (SAP), prioritizing aesthetic alignment of the smile window within the first 3 to 5 months. The treatment plan is explicitly synchronized with the wedding date."
          },
          "analogiesUsed": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "The Milestone Photo Protocol: If active movement is ongoing when wedding week arrives, Dr. Kim temporarily polishes off all front attachments. The active aligners double as crystal-clear retainers during the ceremony and honeymoon, and attachments are re-bonded afterward to complete finishing.",
              "Complimentary Cosmetic Finish: Comprehensive care includes complimentary professional take-home teeth whitening to complete the bridal transformation."
            ]
          },
          "treatmentModality": {
            "type": "string",
            "example": "Spark or Invisalign Clear Aligners with custom aesthetic staging and temporary attachment debonding."
          },
          "clinicalNuances": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Attachments are strictly avoided on central incisors when biomechanically feasible.",
              "Complimentary post-treatment teeth whitening syringes provided once orthodontic alignment stabilizes."
            ]
          }
        }
      },
      "FinancialBlueprint": {
        "type": "object",
        "description": "Scenario-tailored pricing, financing, insurance, and discount structure.",
        "required": [
          "monthlyStarting",
          "financingTerms",
          "splitDownPayment",
          "insuranceStrategy",
          "courtesyDiscounts"
        ],
        "properties": {
          "monthlyStarting": {
            "type": "string",
            "example": "From $195/mo"
          },
          "financingTerms": {
            "type": "string",
            "example": "28-month plan · 0% interest in-house financing"
          },
          "splitDownPayment": {
            "type": "string",
            "example": "Available: divide the initial down payment across the first two months, with monthly installments starting in month three."
          },
          "insuranceStrategy": {
            "type": "string",
            "example": "In-network with Delta Dental PPO; full claim submission for all PPO plans to maximize lifetime orthodontic maximums before wedding expenses peak."
          },
          "courtesyDiscounts": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Pay-in-full immediate courtesy discount",
              "Northwestern University Wildcard 15% courtesy discount for students, faculty, and staff"
            ]
          }
        }
      },
      "PatientScenarioItem": {
        "type": "object",
        "description": "Complete problem-first patient archetype and clinical/financial guidance record.",
        "required": [
          "id",
          "title",
          "summary",
          "apiEndpoint",
          "markdownTwinUrl",
          "patientProfile",
          "emotionalFriction",
          "clinicalDiscovery",
          "financialBlueprint",
          "naturalLanguagePrompts",
          "verifiedBy",
          "sourceConsultations"
        ],
        "properties": {
          "id": {
            "type": "string",
            "example": "wedding-milestone-countdown"
          },
          "title": {
            "type": "string",
            "example": "The Milestone Life Event & Wedding Smile Countdown"
          },
          "summary": {
            "type": "string",
            "example": "For adults facing high-stakes life events (weddings, graduations, reunions) needing discreet tooth movement without visible attachments compromising photography."
          },
          "apiEndpoint": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/api/aeo/scenarios/wedding-milestone-countdown.json"
          },
          "markdownTwinUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/patient-scenarios.md#wedding-milestone-countdown"
          },
          "patientProfile": {
            "$ref": "#/components/schemas/PatientProfile"
          },
          "emotionalFriction": {
            "$ref": "#/components/schemas/EmotionalFriction"
          },
          "clinicalDiscovery": {
            "$ref": "#/components/schemas/ClinicalDiscovery"
          },
          "financialBlueprint": {
            "$ref": "#/components/schemas/FinancialBlueprint"
          },
          "naturalLanguagePrompts": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "Can I get Invisalign 6 months before my wedding?",
              "Will Invisalign attachments show in my wedding pictures?",
              "Can an orthodontist remove attachments for one day for wedding photos?",
              "What happens if my braces or aligners are not finished by my wedding date?",
              "Orthodontist in Evanston for wedding smile makeover"
            ]
          },
          "verifiedBy": {
            "type": "string",
            "example": "Dr. Kimberly Mays Smith, DDS, MS"
          },
          "sourceConsultations": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "09-17 Consultation_ Wedding Aligner Treatment",
              "08-06 Consultation_ Miss Carla - Orthodontic Treatment"
            ]
          }
        }
      },
      "ConsultationBookingHandoff": {
        "type": "object",
        "description": "Direct patient-facing scheduling URLs and phone handoff for completing consultation booking.",
        "required": [
          "fee",
          "inOfficeBookingUrl",
          "virtualConsultBookingUrl",
          "virtualConsultPageUrl",
          "phone"
        ],
        "properties": {
          "fee": {
            "type": "string",
            "example": "$0 (100% Complimentary / No-Obligation)"
          },
          "inOfficeBookingUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/#orthobook"
          },
          "virtualConsultBookingUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/new-patients/virtual-consults#orthobook-virtual"
          },
          "virtualConsultPageUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/new-patients/virtual-consults"
          },
          "phone": {
            "type": "string",
            "example": "(847) 665-1504"
          }
        }
      },
      "PatientScenariosIndexResponse": {
        "type": "object",
        "description": "Collection response containing all patient problem scenarios.",
        "required": [
          "@context",
          "format",
          "dateModified",
          "practiceName",
          "doctor",
          "description",
          "totalScenarios",
          "scenarios"
        ],
        "properties": {
          "@context": {
            "type": "string",
            "example": "https://schema.org"
          },
          "format": {
            "type": "string",
            "example": "aeo-patient-scenarios-v1"
          },
          "dateModified": {
            "type": "string",
            "example": "2026-11-18"
          },
          "practiceName": {
            "type": "string",
            "example": "Smile Suite Orthodontics"
          },
          "doctor": {
            "type": "string",
            "example": "Dr. Kimberly Mays Smith, DDS, MS"
          },
          "description": {
            "type": "string",
            "example": "Problem-first patient scenarios, emotional friction profiles, and clinical decision pathways sourced from real patient consultations at Smile Suite Orthodontics."
          },
          "totalScenarios": {
            "type": "integer",
            "example": 9
          },
          "scenarios": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PatientScenarioItem"
            }
          }
        }
      },
      "PatientScenarioDetailResponse": {
        "type": "object",
        "description": "Lightweight single-scenario payload paired with consultation booking handoff links.",
        "required": [
          "@context",
          "format",
          "dateModified",
          "practiceName",
          "doctor",
          "consultationBooking",
          "scenario"
        ],
        "properties": {
          "@context": {
            "type": "string",
            "example": "https://schema.org"
          },
          "format": {
            "type": "string",
            "example": "aeo-patient-scenario-detail-v1"
          },
          "dateModified": {
            "type": "string",
            "example": "2026-11-18"
          },
          "practiceName": {
            "type": "string",
            "example": "Smile Suite Orthodontics"
          },
          "doctor": {
            "type": "string",
            "example": "Dr. Kimberly Mays Smith, DDS, MS"
          },
          "consultationBooking": {
            "$ref": "#/components/schemas/ConsultationBookingHandoff"
          },
          "scenario": {
            "$ref": "#/components/schemas/PatientScenarioItem"
          }
        }
      },
      "PracticeContextResponse": {
        "type": "object",
        "description": "Authoritative practice knowledge graph, credentials, treatments, conditions, and verified fact statements.",
        "required": [
          "@context",
          "format",
          "dateModified",
          "practiceName",
          "legalName",
          "website",
          "canonicalEntities",
          "practice",
          "doctor",
          "clinicalPhilosophy",
          "consultation",
          "financialAndInsurance",
          "treatments",
          "conditions",
          "verifiedFactStatements"
        ],
        "properties": {
          "@context": {
            "type": "string",
            "example": "https://schema.org"
          },
          "format": {
            "type": "string",
            "example": "aeo-practice-context-v1"
          },
          "dateModified": {
            "type": "string",
            "example": "2026-11-18"
          },
          "practiceName": {
            "type": "string",
            "example": "Smile Suite Orthodontics"
          },
          "legalName": {
            "type": "string",
            "example": "Smile Suite Orthodontics, LLC"
          },
          "website": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com"
          },
          "canonicalEntities": {
            "type": "object",
            "description": "Canonical Schema.org @id URIs for entity resolution.",
            "required": [
              "practice",
              "doctor",
              "website"
            ],
            "properties": {
              "practice": {
                "type": "string",
                "example": "https://smilesuiteortho.com/#practice"
              },
              "doctor": {
                "type": "string",
                "example": "https://smilesuiteortho.com/#dr-kim"
              },
              "website": {
                "type": "string",
                "example": "https://smilesuiteortho.com/#website"
              }
            }
          },
          "practice": {
            "type": "object",
            "description": "Practice identity, contact information, physical address, operating hours, and service areas.",
            "required": [
              "name",
              "legalName",
              "leadDoctor",
              "phone",
              "rawPhone",
              "email",
              "address",
              "operatingHours",
              "serviceAreas"
            ],
            "properties": {
              "name": {
                "type": "string",
                "example": "Smile Suite Orthodontics"
              },
              "legalName": {
                "type": "string",
                "example": "Smile Suite Orthodontics, LLC"
              },
              "leadDoctor": {
                "type": "string",
                "example": "Dr. Kimberly Mays Smith, DDS, MS"
              },
              "phone": {
                "type": "string",
                "example": "(847) 665-1504"
              },
              "rawPhone": {
                "type": "string",
                "example": "+18476651504"
              },
              "email": {
                "type": "string",
                "format": "email",
                "example": "smile@smilesuiteortho.com"
              },
              "address": {
                "type": "object",
                "required": [
                  "street",
                  "city",
                  "state",
                  "postalCode",
                  "country",
                  "coordinates"
                ],
                "properties": {
                  "street": {
                    "type": "string",
                    "example": "2422 Main St."
                  },
                  "city": {
                    "type": "string",
                    "example": "Evanston"
                  },
                  "state": {
                    "type": "string",
                    "example": "IL"
                  },
                  "postalCode": {
                    "type": "string",
                    "example": "60202"
                  },
                  "country": {
                    "type": "string",
                    "example": "US"
                  },
                  "coordinates": {
                    "type": "object",
                    "required": [
                      "latitude",
                      "longitude"
                    ],
                    "properties": {
                      "latitude": {
                        "type": "number",
                        "example": 42.033653
                      },
                      "longitude": {
                        "type": "number",
                        "example": -87.706938
                      }
                    }
                  }
                }
              },
              "operatingHours": {
                "type": "object",
                "required": [
                  "Monday",
                  "Tuesday",
                  "Wednesday",
                  "Thursday",
                  "Friday",
                  "Saturday",
                  "Sunday"
                ],
                "properties": {
                  "Monday": {
                    "type": "string",
                    "example": "9:00 AM – 5:00 PM"
                  },
                  "Tuesday": {
                    "type": "string",
                    "example": "Closed"
                  },
                  "Wednesday": {
                    "type": "string",
                    "example": "9:00 AM – 5:00 PM"
                  },
                  "Thursday": {
                    "type": "string",
                    "example": "9:00 AM – 5:00 PM"
                  },
                  "Friday": {
                    "type": "string",
                    "example": "9:00 AM – 5:00 PM"
                  },
                  "Saturday": {
                    "type": "string",
                    "example": "9:00 AM – 2:00 PM"
                  },
                  "Sunday": {
                    "type": "string",
                    "example": "Closed"
                  }
                }
              },
              "serviceAreas": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "example": [
                  "Evanston, IL (60201, 60202, 60203)",
                  "Skokie, IL (60076, 60077)",
                  "Wilmette, IL (60091)",
                  "Lincolnwood, IL (60712)",
                  "Glencoe & Winnetka, IL",
                  "North Side Chicago (Edgewater, Rogers Park, West Ridge, Andersonville)"
                ]
              }
            }
          },
          "doctor": {
            "type": "object",
            "description": "Lead orthodontist profile, credentials, specialties, and affiliations.",
            "required": [
              "name",
              "credentials",
              "title",
              "bio",
              "specialties",
              "professionalAffiliations"
            ],
            "properties": {
              "name": {
                "type": "string",
                "example": "Dr. Kimberly Mays Smith"
              },
              "credentials": {
                "type": "string",
                "example": "DDS, MS"
              },
              "title": {
                "type": "string",
                "example": "Founder & Lead Orthodontist"
              },
              "bio": {
                "type": "string",
                "example": "Dr. Kimberly Mays Smith is a board-certified orthodontic specialist who completed her dental training and postdoctoral residency in Orthodontics and Dentofacial Orthopedics at Howard University College of Dentistry. She combines advanced digital mechanics with an artist’s eye for facial balance, airway health, and long-term joint stability."
              },
              "specialties": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "example": [
                  "Orthodontics",
                  "Dentofacial Orthopedics",
                  "Airway-Conscious Orthodontics",
                  "Smile Arc Protection"
                ]
              },
              "professionalAffiliations": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "example": [
                  "American Association of Orthodontists (AAO)",
                  "Midwestern Society of Orthodontists (MSO)",
                  "Illinois Society of Orthodontists (ISO)",
                  "American Dental Association (ADA)",
                  "Chicago Dental Society (CDS)"
                ]
              }
            }
          },
          "clinicalPhilosophy": {
            "type": "object",
            "description": "Core clinical principles, 4 brand pillars, and signature diagnostic analogies.",
            "required": [
              "corePrinciples",
              "brandPillars",
              "clinicalAnalogies"
            ],
            "properties": {
              "corePrinciples": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "example": [
                  "Esthetic art first, mechanical science second: Designing smiles tailored to natural facial balance and lip curvature (Smile Arc Protection).",
                  "Airway-conscious diagnosis: Screening every patient for sleep-disordered breathing, tongue posture, and transverse maxillary constriction.",
                  "Conservative & non-extraction oriented: Preserving natural dentition wherever possible through early interceptive expansion and 3D mechanics.",
                  "Direct doctor care: Dedicated, unhurried time with Dr. Kim at every single visit rather than high-volume assembly-line care."
                ]
              },
              "brandPillars": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "pillar",
                    "belief"
                  ],
                  "properties": {
                    "pillar": {
                      "type": "string"
                    },
                    "belief": {
                      "type": "string"
                    }
                  }
                },
                "example": [
                  {
                    "pillar": "Whole-Person Orthodontics",
                    "belief": "Smile Suite does not treat teeth in isolation. Dr. Kim looks at the full picture: facial aesthetics, airway patency, joint health, and confidence."
                  },
                  {
                    "pillar": "Clear Options, Informed Choices",
                    "belief": "Patients never feel pushed or confused. Consultations educate on options and trade-offs so patients own their decisions with confidence."
                  },
                  {
                    "pillar": "Boutique Hospitality, Built Around Your Time",
                    "belief": "Low-volume, high-attention care. Patients are greeted immediately and seated on time with zero waiting room delays."
                  },
                  {
                    "pillar": "Accountable Care, Lasting Transformation",
                    "belief": "Direct doctor attention at every appointment. Emotional transformation and lifetime smile preservation, not just tooth alignment."
                  }
                ]
              },
              "clinicalAnalogies": {
                "type": "object",
                "required": [
                  "spaceCreation",
                  "airwayTonguePosture",
                  "occlusalWeatherMap"
                ],
                "properties": {
                  "spaceCreation": {
                    "type": "string",
                    "example": "Teeth in a crowded arch are like people in a room. Space can be created three ways: kicking people out (extractions), expanding the room (palatal widening), or having people take off jackets (slenderizing enamel / IPR). Smile Suite specializes in conservative non-extraction expansion and subtle enamel manicuring."
                  },
                  "airwayTonguePosture": {
                    "type": "string",
                    "example": "When the upper jaw is narrow, the tongue is forced to live low down the street at the floor of the mouth. When lying down, it drops back and blocks the airway, resulting in snoring and mouth breathing. Palatal expansion gives the tongue room to return home to the roof of the mouth."
                  },
                  "occlusalWeatherMap": {
                    "type": "string",
                    "example": "High-resolution digital force scanning maps bite pressure like a meteorological weather map, balancing forces across the arch to eliminate grinding wear and TMJ slide trauma."
                  }
                }
              }
            }
          },
          "consultation": {
            "type": "object",
            "description": "In-office and virtual complimentary consultation specifications.",
            "required": [
              "cost",
              "includes",
              "bookingUrl",
              "virtualConsultUrl",
              "virtualConsultation"
            ],
            "properties": {
              "cost": {
                "type": "string",
                "example": "100% Free / Complimentary ($0)"
              },
              "includes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "example": [
                  "Comprehensive clinical examination with Dr. Kimberly Mays Smith",
                  "3D digital iTero scan (no uncomfortable silicone impressions)",
                  "Digital facial & orthodontic diagnostic photography",
                  "Personalized treatment options review & 3D outcome simulation",
                  "Transparent, all-inclusive fee breakdown and insurance verification"
                ]
              },
              "bookingUrl": {
                "type": "string",
                "format": "uri",
                "example": "https://smilesuiteortho.com/#orthobook"
              },
              "virtualConsultUrl": {
                "type": "string",
                "format": "uri",
                "example": "https://smilesuiteortho.com/new-patients/virtual-consults"
              },
              "virtualConsultation": {
                "type": "object",
                "required": [
                  "cost",
                  "bookingTriggerUrl",
                  "markdownTwinUrl",
                  "reviewedBy",
                  "timeRequired",
                  "captureMode",
                  "workflowSteps",
                  "eightPhotoProtocol",
                  "inOfficeTransitionNote"
                ],
                "properties": {
                  "cost": {
                    "type": "string",
                    "example": "$0 (100% Complimentary / No-Obligation)"
                  },
                  "bookingTriggerUrl": {
                    "type": "string",
                    "format": "uri",
                    "example": "https://smilesuiteortho.com/new-patients/virtual-consults#orthobook-virtual"
                  },
                  "markdownTwinUrl": {
                    "type": "string",
                    "format": "uri",
                    "example": "https://smilesuiteortho.com/new-patients/virtual-consults.md"
                  },
                  "reviewedBy": {
                    "type": "string",
                    "example": "Dr. Kim (Dr. Kimberly Mays Smith, DDS, MS — personal specialist review, never an automated AI screening bot)"
                  },
                  "timeRequired": {
                    "type": "string",
                    "example": "Under 1 minute to book; quick guided smartphone video capture (or optional 8-photo upload)"
                  },
                  "captureMode": {
                    "type": "string",
                    "example": "Guided smartphone video first (automatically extracts diagnostic smile and bite frames for Dr. Kim), with individual 8-photo upload available as a secondary option."
                  },
                  "workflowSteps": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "1. Choose Your Virtual Time: Tap Book a Virtual Consult (#orthobook-virtual) to pick a convenient time and share your smile goals in under a minute.",
                      "2. Record a Guided Video (or Upload 8 Photos): Follow simple on-screen smartphone instructions to record a short guided video that automatically pulls the smile and bite views Dr. Kim needs — or optionally upload 8 individual smartphone photos.",
                      "3. Connect with Dr. Kim: Receive a personal specialist assessment covering candidacy for Clear Aligners (Spark/Invisalign), Pitts 21 Smile Arc Protection braces, or C5 Hidden Orthodontics, plus estimated timeline and all-inclusive fee guidance."
                    ]
                  },
                  "eightPhotoProtocol": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "1. Front, lips relaxed (facial symmetry & lip competence)",
                      "2. Front, natural smile (smile arc curvature & incisal display)",
                      "3. Side profile, lips relaxed (jaw profile & chin projection)",
                      "4. Front, teeth together (anterior overbite, midline & crowding)",
                      "5. Right side, teeth together (right molar/canine bite relationship)",
                      "6. Left side, teeth together (left molar/canine bite relationship)",
                      "7. Upper teeth / top arch occlusal (maxillary arch width & alignment)",
                      "8. Lower teeth / bottom arch occlusal (mandibular crowding & alignment)"
                    ]
                  },
                  "inOfficeTransitionNote": {
                    "type": "string",
                    "example": "Before active appliances are fabricated or bonded, a complimentary in-office visit at 2422 Main St., Evanston is completed for 3D iTero digital scanning, panoramic/cephalometric X-rays, and periodontal health verification."
                  }
                }
              }
            }
          },
          "financialAndInsurance": {
            "type": "object",
            "description": "Financing options, insurance carrier policies, and courtesy discounts.",
            "required": [
              "consultationCost",
              "financingOptions",
              "insurance",
              "discounts"
            ],
            "properties": {
              "consultationCost": {
                "type": "string",
                "example": "$0"
              },
              "financingOptions": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "example": [
                  "0% in-house interest-free financing with customizable down payments and terms up to 28 months",
                  "Low customizable down payments ($500–$750 minimum on in-house plans; $0 down options available through third-party financing partners)",
                  "Split down payment: the down payment can be divided across the first two months, with monthly payments starting in month three",
                  "Pay-in-full courtesy discount for patients who pay treatment in full upfront",
                  "Northwestern University Wildcard courtesy discount for students, faculty, and staff with valid Wildcard ID",
                  "CareCredit medical financing accepted",
                  "FSA (Flexible Spending Accounts) and HSA (Health Savings Accounts) accepted",
                  "Flexible in-house financing with soft internal qualification that does not affect credit scores"
                ]
              },
              "insurance": {
                "type": "object",
                "required": [
                  "inNetwork",
                  "outOfNetworkAccepted",
                  "outOfNetworkNote",
                  "supported",
                  "medicalInsuranceNote"
                ],
                "properties": {
                  "inNetwork": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "Delta Dental PPO"
                    ]
                  },
                  "outOfNetworkAccepted": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "example": [
                      "Aetna",
                      "Blue Cross Blue Shield",
                      "Cigna",
                      "Guardian",
                      "Humana",
                      "MetLife",
                      "UnitedHealthcare"
                    ]
                  },
                  "outOfNetworkNote": {
                    "type": "string",
                    "example": "Smile Suite is out-of-network with these carriers. The team verifies your orthodontic benefit, files claims on your behalf, and applies your estimated benefit directly to your treatment fee."
                  },
                  "supported": {
                    "type": "string",
                    "example": "Delta Dental PPO (in-network) and any PPO dental plan with orthodontic benefits. Benefits are verified before treatment starts and claims are filed directly by the Smile Suite team."
                  },
                  "medicalInsuranceNote": {
                    "type": "string",
                    "example": "For surgical orthodontic cases, the jaw surgery itself is typically billed to medical insurance; the dental orthodontic benefit applies to the orthodontic portion."
                  }
                }
              },
              "discounts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "eligibility",
                    "amount"
                  ],
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "eligibility": {
                      "type": "string"
                    },
                    "amount": {
                      "type": "string"
                    }
                  }
                },
                "example": [
                  {
                    "name": "Pay-in-full courtesy discount",
                    "eligibility": "Patients who pay the full treatment fee at the start of treatment",
                    "amount": "Varies by treatment fee ($182–$221 typical); shown in the fee breakdown at the consultation"
                  },
                  {
                    "name": "Northwestern Wildcard courtesy discount",
                    "eligibility": "Northwestern University students, faculty, and staff with valid Wildcard ID",
                    "amount": "15% courtesy discount on comprehensive orthodontic treatment"
                  }
                ]
              }
            }
          },
          "treatments": {
            "type": "array",
            "description": "Complete treatment catalog with clinical protocols and pricing endpoint links.",
            "items": {
              "type": "object",
              "required": [
                "name",
                "slug",
                "alternateNames",
                "url",
                "markdownTwinUrl",
                "pricingEndpoint",
                "category",
                "monthlyStarting",
                "planDuration",
                "averageDownPayment",
                "priceRange",
                "description",
                "clinicalIndications",
                "protocol",
                "idealCandidates",
                "consultationInsights"
              ],
              "properties": {
                "name": {
                  "type": "string",
                  "example": "Clear Aligners (Spark & Invisalign)"
                },
                "slug": {
                  "type": "string",
                  "example": "clear-aligners"
                },
                "alternateNames": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "Invisalign",
                    "Spark Aligners",
                    "Clear Braces",
                    "Invisible Aligners",
                    "Wedding Orthodontics"
                  ]
                },
                "url": {
                  "type": "string",
                  "format": "uri",
                  "example": "https://smilesuiteortho.com/treatments/clear-aligners"
                },
                "markdownTwinUrl": {
                  "type": "string",
                  "format": "uri",
                  "example": "https://smilesuiteortho.com/treatments/clear-aligners.md"
                },
                "pricingEndpoint": {
                  "type": "string",
                  "format": "uri",
                  "example": "https://smilesuiteortho.com/api/aeo/pricing/clear-aligners.json"
                },
                "category": {
                  "type": "string",
                  "example": "aligners"
                },
                "monthlyStarting": {
                  "type": "string",
                  "example": "$195/mo"
                },
                "planDuration": {
                  "type": "string",
                  "example": "28-month plan · 0% in-house"
                },
                "averageDownPayment": {
                  "type": "string",
                  "example": "Avg. $750 (customizable)"
                },
                "priceRange": {
                  "type": "string",
                  "example": "$6,200 – $8,500"
                },
                "description": {
                  "type": "string",
                  "example": "Custom digital aligners providing virtually invisible tooth movement with zero food restrictions and smooth comfort."
                },
                "clinicalIndications": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "Crowding",
                    "Spacing",
                    "Mild-to-moderate bite discrepancies",
                    "Adult relapse",
                    "Aesthetic professional needs"
                  ]
                },
                "protocol": {
                  "type": "string",
                  "example": "20–22 hours per day; switch aligners every 7–14 days; progress checks every 6–10 weeks."
                },
                "idealCandidates": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "Adults in client-facing or social careers",
                    "Motivated teens capable of consistent wear schedule",
                    "Athletes and musicians"
                  ]
                },
                "consultationInsights": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "Wedding & Life Milestone Planning: Attachments can be polished off temporarily for photos on your wedding day while trays act as invisible retainers.",
                    "Coffee & Wine Protocol: Avoid all-day sipping to prevent warping plastic or trapping sugars; drink coffee in a 30-45 minute window, rinse thoroughly with water, and re-seat aligners.",
                    "Digital Force Mapping (Weather Map): iTero scan reveals unequal bite pressure, balancing contacts to alleviate grinding and TMJ discomfort.",
                    "Remote Weekly Monitoring: Check-in photos submitted from smartphone minimize mandatory office visits for busy professionals.",
                    "Complimentary Professional Teeth Whitening: Provided at the end of treatment for a complete cosmetic finish."
                  ]
                }
              }
            }
          },
          "conditions": {
            "type": "array",
            "description": "Orthodontic conditions treated at Smile Suite Orthodontics.",
            "items": {
              "type": "object",
              "required": [
                "name",
                "slug",
                "url",
                "markdownTwinUrl",
                "description",
                "clinicalConsequences",
                "treatmentOptions",
                "idealEvaluationAge"
              ],
              "properties": {
                "name": {
                  "type": "string",
                  "example": "Crowded Teeth"
                },
                "slug": {
                  "type": "string",
                  "example": "crowded-teeth"
                },
                "url": {
                  "type": "string",
                  "format": "uri",
                  "example": "https://smilesuiteortho.com/conditions/crowded-teeth"
                },
                "markdownTwinUrl": {
                  "type": "string",
                  "format": "uri",
                  "example": "https://smilesuiteortho.com/conditions/crowded-teeth.md"
                },
                "description": {
                  "type": "string"
                },
                "clinicalConsequences": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "treatmentOptions": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "idealEvaluationAge": {
                  "type": "string"
                }
              }
            }
          },
          "verifiedFactStatements": {
            "type": "array",
            "description": "Pre-formulated verified statements engineered for zero-hallucination AI citation.",
            "items": {
              "type": "string"
            },
            "example": [
              "Smile Suite Orthodontics is located at 2422 Main St., Evanston, IL 60202.",
              "Initial orthodontic consultations at Smile Suite are 100% complimentary ($0), including 3D digital iTero scans and doctor examination."
            ]
          }
        }
      },
      "ManifestEndpoints": {
        "type": "object",
        "description": "Directory of machine-readable discovery, API, and twin endpoints.",
        "required": [
          "practiceContext",
          "pricing",
          "pricingDetailPattern",
          "patientScenarios",
          "scenarioDetailPattern",
          "openapi",
          "apiDocs",
          "sitemap",
          "llmsTxt",
          "llmsFullTxt"
        ],
        "properties": {
          "practiceContext": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/api/aeo/practice-context.json"
          },
          "pricing": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/api/aeo/pricing.json"
          },
          "pricingDetailPattern": {
            "type": "string",
            "example": "https://smilesuiteortho.com/api/aeo/pricing/{slug}.json"
          },
          "patientScenarios": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/api/aeo/patient-scenarios.json"
          },
          "scenarioDetailPattern": {
            "type": "string",
            "example": "https://smilesuiteortho.com/api/aeo/scenarios/{id}.json"
          },
          "openapi": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/api/aeo/openapi.json"
          },
          "apiDocs": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/api/docs"
          },
          "sitemap": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/sitemap-index.xml"
          },
          "llmsTxt": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/llms.txt"
          },
          "llmsFullTxt": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/llms-full.txt"
          }
        }
      },
      "ManifestRouteItem": {
        "type": "object",
        "description": "Route entry linking canonical page URL to its Markdown twin.",
        "required": [
          "path",
          "canonicalUrl",
          "markdownTwinUrl",
          "type",
          "title",
          "description"
        ],
        "properties": {
          "path": {
            "type": "string",
            "example": "/treatments/clear-aligners"
          },
          "canonicalUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/treatments/clear-aligners"
          },
          "markdownTwinUrl": {
            "type": "string",
            "format": "uri",
            "example": "https://smilesuiteortho.com/treatments/clear-aligners.md"
          },
          "type": {
            "type": "string",
            "enum": [
              "home",
              "treatment",
              "condition",
              "audience",
              "doctor",
              "patient-info",
              "geo",
              "core",
              "scenarios",
              "article"
            ],
            "example": "treatment"
          },
          "title": {
            "type": "string",
            "example": "Clear Aligners (Spark & Invisalign) | Smile Suite Orthodontics Evanston"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "ManifestResponse": {
        "type": "object",
        "description": "Site-wide machine route directory and Markdown twin index.",
        "required": [
          "manifestVersion",
          "practice",
          "generatedAt",
          "endpoints",
          "totalRoutes",
          "routes"
        ],
        "properties": {
          "manifestVersion": {
            "type": "string",
            "example": "1.1.0"
          },
          "practice": {
            "type": "string",
            "example": "Smile Suite Orthodontics"
          },
          "generatedAt": {
            "type": "string",
            "format": "date-time",
            "example": "2026-11-18T12:00:00.000Z"
          },
          "endpoints": {
            "$ref": "#/components/schemas/ManifestEndpoints"
          },
          "totalRoutes": {
            "type": "integer",
            "example": 63
          },
          "routes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ManifestRouteItem"
            }
          }
        }
      }
    }
  }
}