{
  "openapi": "3.1.0",
  "info": {
    "title": "Naveen Guru — Public Developer & Portfolio API",
    "version": "1.0.0",
    "description": "Public read-only REST API providing structured, machine-readable access to Naveen Guru's professional background, data engineering expertise, live projects, categorized skills, and system health status. Adheres to modern agentic web standards and the Ora specification.",
    "contact": {
      "name": "Naveen Guru",
      "email": "singhnaveen360@gmail.com",
      "url": "https://naveensingh.guru"
    },
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/licenses/MIT"
    }
  },
  "servers": [
    {
      "url": "https://naveensingh.guru",
      "description": "Production API Server"
    },
    {
      "url": "http://localhost:3000",
      "description": "Local Development Server"
    }
  ],
  "tags": [
    {
      "name": "Profile",
      "description": "Developer biography, professional experience, and verified social profiles"
    },
    {
      "name": "Projects",
      "description": "Catalog of deployed web applications, AI developer tooling, and live products"
    },
    {
      "name": "Skills",
      "description": "Categorized technical proficiencies across ETL, databases, BI, and AI"
    },
    {
      "name": "System",
      "description": "System health check and OpenAPI documentation discovery"
    }
  ],
  "paths": {
    "/api/profile": {
      "get": {
        "tags": ["Profile"],
        "summary": "Get Developer Profile",
        "description": "Returns Naveen Guru's complete developer profile, career background, contact details, and verified social anchors.",
        "operationId": "getProfile",
        "responses": {
          "200": {
            "description": "Developer profile retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Profile"
                },
                "example": {
                  "name": "Naveen Guru",
                  "title": "Senior Data Analyst & Data Engineer",
                  "experienceYears": 6,
                  "startedCareer": "2019-12",
                  "location": "Bangalore, India",
                  "email": "singhnaveen360@gmail.com",
                  "bio": "Senior Data Analyst & Data Engineer with 6+ years of experience building enterprise ETL pipelines (Informatica, Airflow), advanced SQL query optimization across multi-terabyte databases (PostgreSQL, Clickhouse, DB2 Mainframe), Power BI analytics, and autonomous AI developer tooling.",
                  "headline": "DATA & PIPELINES",
                  "canonicalUrl": "https://naveenguru.vercel.app",
                  "socials": {
                    "linkedin": "https://www.linkedin.com/in/naveen-guru-b23a7816a/",
                    "github": "https://github.com/Naveen071110",
                    "medium": "https://medium.com/@singhnaveen360",
                    "x": "https://x.com/NaveenBale",
                    "benable": "https://benable.com/naveentrovert",
                    "audionique": "https://audionique.xyz"
                  },
                  "status": "Available for enterprise consulting & senior technical roles"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/projects": {
      "get": {
        "tags": ["Projects"],
        "summary": "Get Public Projects & Products",
        "description": "Returns the complete catalog of live products, enterprise data tools, and AI applications built and deployed by Naveen.",
        "operationId": "getProjects",
        "responses": {
          "200": {
            "description": "Project catalog retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Project"
                  }
                },
                "example": [
                  {
                    "id": "datamaster-pro",
                    "name": "DataMaster Pro",
                    "category": "Enterprise Data Analytics",
                    "description": "Full-stack enterprise dataset profiler and anomaly detection engine providing instant automated insights, SQL generation, and KPI dashboards.",
                    "url": "https://datamaster-pro-78m4.onrender.com/",
                    "platform": "Render Web Services",
                    "techStack": ["Python", "FastAPI", "React", "PostgreSQL", "Pandas", "Tailwind CSS"],
                    "live": true,
                    "role": "Creator & Full-Stack Architect"
                  },
                  {
                    "id": "gitcontextgen",
                    "name": "GitContextGen (RepoPulse AI)",
                    "category": "AI Developer Tooling",
                    "description": "High-performance edge worker that tokenizes code repositories and compiles optimized Markdown context payloads for feeding large codebases into LLMs.",
                    "url": "https://repopulse-ai.singhnaveen360.workers.dev/",
                    "platform": "Cloudflare Workers",
                    "techStack": ["TypeScript", "Cloudflare Workers", "GitHub API", "Token Algorithms"],
                    "live": true,
                    "role": "Creator & Architect"
                  },
                  {
                    "id": "cvgenie-ats",
                    "name": "CVGenie ATS",
                    "category": "AI Resume Optimizer",
                    "description": "AI-powered resume optimization platform that scores applicant resumes against target job descriptions and generates STAR-formatted bullet points.",
                    "url": "https://cvgenieats.com/",
                    "platform": "Vercel & Supabase",
                    "techStack": ["React", "TypeScript", "Tailwind CSS", "OpenAI API", "Supabase"],
                    "live": true,
                    "role": "Solo Builder"
                  },
                  {
                    "id": "driftguard-api",
                    "name": "DriftGuard API",
                    "category": "Schema Drift Security",
                    "description": "Real-time schema drift monitor and security API that detects breaking column alterations and upstream data anomalies before ETL jobs execute.",
                    "url": "https://bb4fd5a7.driftguard-alp.pages.dev/",
                    "platform": "Cloudflare Pages & Workers",
                    "techStack": ["Python", "SQLite", "Cloudflare D1", "REST API", "JSON Schema"],
                    "live": true,
                    "role": "Creator & Pipeline Engineer"
                  },
                  {
                    "id": "audionique",
                    "name": "Audionique Platform",
                    "category": "Electronic Music Brand",
                    "description": "Independent music studio and streaming showcase for original electronic, synthwave, and cinematic music compositions created by Naveen.",
                    "url": "https://audionique.xyz/",
                    "platform": "Custom Cloud",
                    "techStack": ["Web Audio API", "HTML5", "CSS3", "Streaming Integrations"],
                    "live": true,
                    "role": "Founder & Music Producer"
                  },
                  {
                    "id": "cosmic-channeling",
                    "name": "Cosmic Channeling",
                    "category": "WebGL & Interactive Canvas",
                    "description": "GPU-accelerated 3D particle simulation and cosmic visual synthesizer built with Three.js and custom GLSL shaders.",
                    "url": "https://cosmic-channeling.vercel.app/",
                    "platform": "Vercel",
                    "techStack": ["Three.js", "React Three Fiber", "GLSL Shaders", "Framer Motion"],
                    "live": true,
                    "role": "Creative Coder"
                  }
                ]
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/skills": {
      "get": {
        "tags": ["Skills"],
        "summary": "Get Technical Skills & Stack",
        "description": "Returns Naveen Guru's complete categorized technical skill matrix including data engineering, query engines, BI, and AI tooling.",
        "operationId": "getSkills",
        "responses": {
          "200": {
            "description": "Skills matrix retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SkillsResponse"
                },
                "example": {
                  "totalExperience": "6+ Years",
                  "categories": [
                    {
                      "name": "Data Engineering & ETL",
                      "skills": [
                        "Informatica PowerCenter (10.5, CDI-PC, IICS)",
                        "Apache Airflow",
                        "Hadoop / Apache Spark",
                        "Data Pipeline Architecture",
                        "ETL / ELT Workflow Optimization",
                        "Checkpoint Recovery & Error Handling"
                      ]
                    },
                    {
                      "name": "Databases & Query Engines",
                      "skills": [
                        "PostgreSQL",
                        "Clickhouse (Columnar Analytics)",
                        "MySQL",
                        "IBM DB2 Mainframe",
                        "MS Access",
                        "Advanced SQL (Window Functions, CTEs, Index Tuning)"
                      ]
                    },
                    {
                      "name": "Business Intelligence & Visualization",
                      "skills": [
                        "Power BI (DAX, Power Query)",
                        "Advanced Excel (VBA, Power Pivot)",
                        "Matplotlib / Seaborn",
                        "Dimensional Data Modeling (Star / Snowflake)",
                        "Executive Reporting Dashboards"
                      ]
                    },
                    {
                      "name": "Programming, Cloud & DevOps",
                      "skills": [
                        "Python (Pandas, NumPy, FastAPI)",
                        "TypeScript & React 19",
                        "Tailwind CSS & Framer Motion",
                        "Cloudflare Workers & Pages",
                        "Vercel & Render",
                        "Postman Automation",
                        "Linux (Ubuntu/Debian) & Bash"
                      ]
                    },
                    {
                      "name": "AI & Autonomous Workflows",
                      "skills": [
                        "Claude Code & Agentic Architecture",
                        "OpenAI / Anthropic APIs",
                        "LLM Context Optimization & Tokenization",
                        "Prompt Engineering & Automated Feedback Loops",
                        "OpenAPI 3.1 & Agentic Web Protocols"
                      ]
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/health": {
      "get": {
        "tags": ["System"],
        "summary": "Health Check",
        "description": "Returns the operational status, version, and uptime of the portfolio application and API endpoints.",
        "operationId": "getHealth",
        "responses": {
          "200": {
            "description": "System is healthy and fully operational",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HealthResponse"
                },
                "example": {
                  "status": "healthy",
                  "timestamp": "2026-08-24T00:15:00.000Z",
                  "version": "1.0.0",
                  "uptime": 86400,
                  "protocol": "Agentic Web Ready (Ora 100/100)"
                }
              }
            }
          }
        }
      }
    },
    "/api/openapi.json": {
      "get": {
        "tags": ["System"],
        "summary": "OpenAPI Specification",
        "description": "Serves this OpenAPI 3.1.0 specification in JSON format.",
        "operationId": "getOpenApiSpec",
        "responses": {
          "200": {
            "description": "OpenAPI 3.1.0 specification document",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Profile": {
        "type": "object",
        "required": ["name", "title", "experienceYears", "location", "email", "bio", "socials"],
        "properties": {
          "name": { "type": "string", "example": "Naveen Guru" },
          "title": { "type": "string", "example": "Senior Data Analyst & Data Engineer" },
          "experienceYears": { "type": "integer", "example": 6 },
          "startedCareer": { "type": "string", "example": "2019-12" },
          "location": { "type": "string", "example": "Bangalore, India" },
          "email": { "type": "string", "format": "email", "example": "singhnaveen360@gmail.com" },
          "bio": { "type": "string" },
          "headline": { "type": "string", "example": "DATA & PIPELINES" },
          "canonicalUrl": { "type": "string", "format": "uri", "example": "https://naveenguru.vercel.app" },
          "socials": {
            "type": "object",
            "properties": {
              "linkedin": { "type": "string", "format": "uri" },
              "github": { "type": "string", "format": "uri" },
              "medium": { "type": "string", "format": "uri" },
              "x": { "type": "string", "format": "uri" },
              "benable": { "type": "string", "format": "uri" },
              "audionique": { "type": "string", "format": "uri" }
            }
          },
          "status": { "type": "string" }
        }
      },
      "Project": {
        "type": "object",
        "required": ["id", "name", "category", "description", "url", "platform", "techStack", "live", "role"],
        "properties": {
          "id": { "type": "string", "example": "datamaster-pro" },
          "name": { "type": "string", "example": "DataMaster Pro" },
          "category": { "type": "string", "example": "Enterprise Data Analytics" },
          "description": { "type": "string" },
          "url": { "type": "string", "format": "uri", "example": "https://datamaster-pro-78m4.onrender.com/" },
          "platform": { "type": "string", "example": "Render Web Services" },
          "techStack": {
            "type": "array",
            "items": { "type": "string" }
          },
          "live": { "type": "boolean", "example": true },
          "role": { "type": "string", "example": "Creator & Full-Stack Architect" }
        }
      },
      "SkillCategory": {
        "type": "object",
        "required": ["name", "skills"],
        "properties": {
          "name": { "type": "string", "example": "Data Engineering & ETL" },
          "skills": {
            "type": "array",
            "items": { "type": "string" }
          }
        }
      },
      "SkillsResponse": {
        "type": "object",
        "required": ["totalExperience", "categories"],
        "properties": {
          "totalExperience": { "type": "string", "example": "6+ Years" },
          "categories": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/SkillCategory" }
          }
        }
      },
      "HealthResponse": {
        "type": "object",
        "required": ["status", "timestamp", "version", "uptime"],
        "properties": {
          "status": { "type": "string", "example": "healthy" },
          "timestamp": { "type": "string", "format": "date-time" },
          "version": { "type": "string", "example": "1.0.0" },
          "uptime": { "type": "number", "example": 86400 },
          "protocol": { "type": "string", "example": "Agentic Web Ready (Ora 100/100)" }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "required": ["error"],
        "properties": {
          "error": {
            "type": "object",
            "required": ["code", "message", "resolution"],
            "properties": {
              "code": { "type": "string", "example": "RESOURCE_NOT_FOUND" },
              "message": { "type": "string", "example": "The requested resource does not exist." },
              "resolution": { "type": "string", "example": "Check /openapi.json for valid endpoints." }
            }
          }
        }
      }
    }
  }
}