{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Estudio (ampliado)",
  "schema_version": "2.0",
  "description": "Schema ampliado para enviar datos de un estudio de desarrollo a importar en la base de datos de DeVuego (tabla estudios). Es una versión más completa de basic_studio_import_schema.json, que cubre más aspectos del modelo de datos que un proveedor puede conocer razonablemente. Los campos internos como id, slug o los nombres de archivo del logo los genera nuestro propio sistema y no deben solicitarse aquí.",
  "type": "object",
  "properties": {
    "nombre": {
      "type": "string",
      "description": "Nombre del estudio"
    },
    "ano_fundacion": {
      "type": "integer",
      "description": "Año en que se fundó el estudio (opcional)"
    },
    "ano_cierre": {
      "type": "integer",
      "description": "Año en que el estudio cerró, si ya no está activo (opcional)"
    },
    "activo": {
      "type": "boolean",
      "description": "Si el estudio está actualmente activo (opcional)"
    },
    "ubicacion": {
      "type": "string",
      "description": "Ciudad / región donde se ubica el estudio (opcional)"
    },
    "pais": {
      "type": "string",
      "description": "País donde se ubica el estudio (opcional)"
    },
    "rango_empleados": {
      "type": "string",
      "enum": ["1", "2-5", "6-10", "11-25", "26-50", "51-150", "151-350", "351-700", "701-1000"],
      "description": "Número de empleados, como uno de nuestros rangos predefinidos. Si solo tienes una cifra aproximada, elige el rango más cercano (opcional)"
    },
    "numero_empleados": {
      "type": "integer",
      "description": "Cifra exacta de empleados, como alternativa más precisa a rango_empleados (opcional)"
    },
    "descripcion": {
      "type": "string",
      "description": "Descripción corta del estudio (opcional)"
    },
    "es_empresa": {
      "type": "boolean",
      "description": "Si el estudio está legalmente constituido como empresa, frente a un equipo informal/independiente (opcional)"
    },
    "nombre_empresa": {
      "type": "string",
      "description": "Nombre legal/comercial bajo el que opera el estudio, si es distinto de su nombre público (opcional)"
    },
    "tipo_empresa": {
      "type": "string",
      "enum": ["S.L.", "S.A.", "Cooperativa", "Autonomo/S.L.U.", "Otros"],
      "description": "Tipo legal de empresa, como una de nuestras categorías predefinidas (opcional)"
    },
    "multinacional": {
      "type": "boolean",
      "description": "Si el estudio pertenece a una multinacional (opcional)"
    },
    "nombre_empresa_matriz": {
      "type": "string",
      "description": "Nombre de la empresa matriz, si multinacional es true (opcional)"
    },
    "es_editora": {
      "type": "boolean",
      "description": "Si el estudio también actúa como editora (opcional)"
    },
    "sitio_web": {
      "type": "string",
      "format": "uri",
      "description": "Sitio web oficial del estudio (opcional)"
    },
    "areas_especializacion": {
      "type": "array",
      "description": "Áreas de especialización, en texto plano (opcional, tabla desarrollos_areas, ej. Mobile, AAA, Indie, VR, Educativo)",
      "items": { "type": "string" }
    },
    "personas_clave": {
      "type": "array",
      "description": "Personas clave asociadas al estudio y su cargo (opcional, tabla desarrolladores_empleo)",
      "items": {
        "type": "object",
        "properties": {
          "nombre": {
            "type": "string",
            "description": "Nombre completo de la persona"
          },
          "cargo": {
            "type": "string",
            "description": "Cargo en el estudio (ej. Fundador/a, Director/a creativo/a, CEO)"
          },
          "fecha_inicio": {
            "type": "string",
            "format": "date",
            "description": "Fecha en que esta persona inició este cargo (AAAA-MM-DD), si se conoce"
          },
          "fecha_fin": {
            "type": "string",
            "format": "date",
            "description": "Fecha en que esta persona dejó este cargo (AAAA-MM-DD), si aplica"
          }
        },
        "required": ["nombre", "cargo"]
      }
    },
    "datos_anuales": {
      "type": "array",
      "description": "Datos financieros/de plantilla anuales del estudio (opcional, tabla estudios_datosanuales). Puedes marcar un año como anónimo si no quieres que las cifras se atribuyan públicamente.",
      "items": {
        "type": "object",
        "properties": {
          "ano": {
            "type": "integer",
            "description": "Año al que corresponden estas cifras"
          },
          "facturacion": {
            "type": "number",
            "description": "Facturación anual"
          },
          "empleados": {
            "type": "integer",
            "description": "Número de empleados ese año"
          },
          "colaboradores_externos": {
            "type": "integer",
            "description": "Número de colaboradores externos/freelance ese año (opcional)"
          },
          "moneda": {
            "type": "string",
            "description": "Código de moneda (ej. EUR, USD)"
          },
          "anonimo": {
            "type": "boolean",
            "description": "Si es true, estas cifras solo deben usarse para informes agregados/sectoriales, sin atribuirse públicamente a este estudio"
          }
        },
        "required": ["ano"]
      }
    }
  },
  "required": ["nombre"],
  "examples": [
    {
      "nombre": "Nombre del Estudio",
      "ano_fundacion": 2010,
      "ano_cierre": null,
      "activo": true,
      "ubicacion": "Vigo",
      "pais": "España",
      "rango_empleados": "11-25",
      "numero_empleados": 18,
      "descripcion": "Descripción corta del estudio.",
      "es_empresa": true,
      "nombre_empresa": "",
      "tipo_empresa": "S.L.",
      "multinacional": false,
      "nombre_empresa_matriz": "",
      "es_editora": false,
      "sitio_web": "https://example.com",
      "areas_especializacion": ["Indie", "Mobile"],
      "personas_clave": [
        { "nombre": "Nombre Apellido", "cargo": "Fundador/a y Director/a creativo/a", "fecha_inicio": "2010-01-01", "fecha_fin": "" }
      ],
      "datos_anuales": [
        { "ano": 2023, "facturacion": 250000, "empleados": 18, "colaboradores_externos": 3, "moneda": "EUR", "anonimo": false }
      ]
    }
  ]
}
