{
  "openapi": "3.1.0",
  "info": {
    "title": "DYR Real Estate Management System",
    "version": "1.8.26",
    "description": "DYR is a comprehensive real estate development management platform for Windows and Android. It manages properties, clients, contracts, installments, cheques, commissions, and financial wallets for real estate developers in Egypt and the MENA region.\n\n## Key Features\n- Property & unit management with status tracking\n- Client database with full profiles\n- Contract & offer creation with auto-installment schedules\n- Installment tracking with overdue alerting and late fee calculation\n- Cheque management with PDF custody reports\n- Sales team & commission tracking\n- Financial wallets & transaction log\n- Real-time cloud sync via Supabase\n- AI Assistant (DYRai) powered by Ollama\n- Available in Arabic & English\n\n## Contact\n- WhatsApp: +201008515995 (24/7 support)\n- Email: invoker89719@Gmail.com",
    "contact": {
      "name": "DYR Support",
      "url": "https://dyr-app.com/#contact",
      "email": "invoker89719@Gmail.com"
    },
    "license": {
      "name": "Commercial — Per Company License",
      "url": "https://dyr-app.com/#about"
    },
    "x-logo": {
      "url": "https://dyr-app.com/assets/favicon.png",
      "altText": "DYR Logo"
    }
  },
  "servers": [
    {
      "url": "https://dyr-app.com",
      "description": "DYR Marketing Website"
    }
  ],
  "security": [],
  "tags": [
    {
      "name": "discovery",
      "description": "AI agent discovery and product information endpoints"
    },
    {
      "name": "contact",
      "description": "Contact and demo booking"
    },
    {
      "name": "documentation",
      "description": "Product documentation and tutorials"
    }
  ],
  "paths": {
    "/llms.txt": {
      "get": {
        "tags": ["discovery"],
        "summary": "AI agent product description",
        "description": "Returns the full LLMs.txt file — a structured plain-text description of DYR for AI agents and large language models. Contains feature list, pricing, contact info, and skills.",
        "operationId": "getLlmsTxt",
        "responses": {
          "200": {
            "description": "LLMs.txt content in plain text",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string",
                  "example": "# DYR — Real Estate Development Management System\n> Version: 1.8.26"
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "tags": ["discovery"],
        "summary": "Full AI agent product description in Markdown",
        "description": "Returns the complete DYR product description in Markdown format. Includes all features, pricing, contact, tutorial, and skills information.",
        "operationId": "getLlmsFullTxt",
        "responses": {
          "200": {
            "description": "Full Markdown product description",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "tags": ["discovery"],
        "summary": "API catalog (RFC 9727)",
        "description": "Returns the RFC 9727 API catalog listing all DYR APIs and their OpenAPI specification URLs.",
        "operationId": "getApiCatalog",
        "responses": {
          "200": {
            "description": "API catalog JSON",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiCatalog"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/mcp.json": {
      "get": {
        "tags": ["discovery"],
        "summary": "MCP server configuration",
        "description": "Returns the Model Context Protocol server configuration for DYR. Lists available tools and resources for AI agents.",
        "operationId": "getMcpConfig",
        "responses": {
          "200": {
            "description": "MCP server configuration",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/McpConfig"
                }
              }
            }
          }
        }
      }
    },
    "/schema.json": {
      "get": {
        "tags": ["discovery"],
        "summary": "Schema.org structured data",
        "description": "Returns Schema.org JSON-LD structured data describing DYR as a SoftwareApplication.",
        "operationId": "getSchemaOrg",
        "responses": {
          "200": {
            "description": "Schema.org JSON-LD",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/sitemap.xml": {
      "get": {
        "tags": ["documentation"],
        "summary": "XML sitemap",
        "operationId": "getSitemap",
        "responses": {
          "200": {
            "description": "XML sitemap of all pages",
            "content": {
              "application/xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {},
    "schemas": {
      "ApiCatalog": {
        "type": "object",
        "description": "RFC 9727 API Catalog",
        "properties": {
          "apis": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiEntry"
            }
          }
        }
      },
      "ApiEntry": {
        "type": "object",
        "properties": {
          "title": { "type": "string" },
          "description": { "type": "string" },
          "openAPI": { "type": "string", "format": "uri" },
          "humanURL": { "type": "string", "format": "uri" },
          "baseURL": { "type": "string", "format": "uri" }
        }
      },
      "McpConfig": {
        "type": "object",
        "description": "MCP server configuration",
        "properties": {
          "name": { "type": "string" },
          "description": { "type": "string" },
          "capabilities": {
            "type": "array",
            "items": { "type": "string" }
          },
          "tools": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/McpTool" }
          }
        }
      },
      "McpTool": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "description": { "type": "string" },
          "inputSchema": { "type": "object" }
        }
      },
      "ProductInfo": {
        "type": "object",
        "description": "DYR product metadata",
        "properties": {
          "name": { "type": "string", "example": "DYR" },
          "version": { "type": "string", "example": "1.8.26" },
          "category": { "type": "string", "example": "Real Estate Management Software" },
          "platforms": {
            "type": "array",
            "items": { "type": "string" },
            "example": ["Windows 10/11 Desktop", "Android 8+"]
          },
          "languages": {
            "type": "array",
            "items": { "type": "string" },
            "example": ["Arabic", "English"]
          },
          "pricingModel": { "type": "string", "example": "Per-company license, no monthly subscription" },
          "contact": { "type": "string", "example": "+201008515995" }
        }
      }
    }
  },
  "x-skills": [
    {
      "name": "book_demo",
      "description": "Book a free DYR demo via WhatsApp with the sales team",
      "url": "https://wa.me/201008515995",
      "method": "GET",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "get_product_info",
      "description": "Retrieve the complete DYR product description, features, and pricing for AI processing",
      "url": "https://dyr-app.com/llms.txt",
      "method": "GET",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "contact_support",
      "description": "Contact DYR support team via email or WhatsApp",
      "url": "https://dyr-app.com/#contact",
      "method": "GET",
      "inputSchema": {
        "type": "object",
        "properties": {
          "subject": {
            "type": "string",
            "description": "The subject of the inquiry (demo, support, pricing, training, bug)"
          }
        }
      }
    }
  ]
}
