{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://jpsis.com.br/desenvolvedores/schema/produto.json",
  "title": "JPSIS — arquivo do produto (jpsis-product.json)",
  "description": "Cadastro de um sistema no JPSIS Hub: dados de vitrine, esquema de limites, planos e add-ons. Importe em Admin → Produtos → Importar arquivo do produto. Convenção: número -1 = ilimitado.",
  "type": "object",
  "required": ["product", "configSchema", "plans"],
  "additionalProperties": false,
  "properties": {
    "$schema": { "type": "string" },
    "$comment": { "type": "string" },
    "product": {
      "type": "object",
      "required": ["slug", "name"],
      "additionalProperties": false,
      "properties": {
        "slug": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{1,40}$", "description": "Identificador fixo do produto (URL e licenças). Não mude depois de publicado." },
        "name": { "type": "string", "minLength": 2, "description": "Nome exibido na vitrine." },
        "tagline": { "type": "string", "maxLength": 200, "description": "Frase curta exibida nos cards e no topo da página do produto." },
        "description": { "type": "string", "maxLength": 4000, "description": "Texto da seção 'Sobre' da página do produto." },
        "kind": { "enum": ["SAAS", "SERVICE"], "default": "SAAS", "description": "SAAS = sistema com cloud dedicada; SERVICE = serviço sem servidor." },
        "provisionInstance": { "type": "boolean", "default": true, "description": "Criar uma cloud dedicada (DigitalOcean) para cada licença." },
        "doRegion": { "type": "string", "default": "nyc3", "description": "Região DigitalOcean das clouds." },
        "doSize": { "type": "string", "default": "s-1vcpu-1gb", "description": "Tamanho do droplet (ex.: s-1vcpu-2gb)." },
        "appUrlTemplate": { "type": "string", "default": "https://{host}", "description": "Endereço do botão 'Abrir sistema'. Variáveis: {host} (domínio próprio ou IP), {hostname}, {ip}." },
        "sortOrder": { "type": "integer", "description": "Ordem na vitrine (menor aparece primeiro)." }
      }
    },
    "configSchema": {
      "type": "array",
      "description": "Limites e recursos que o SISTEMA aplica. As chaves são livres para cada produto; o formato é fixo.",
      "items": {
        "type": "object",
        "required": ["key", "label", "type"],
        "additionalProperties": false,
        "properties": {
          "key": { "type": "string", "pattern": "^[a-zA-Z][a-zA-Z0-9_]*$", "description": "Nome da chave em camelCase. Convenções: maxX para quantidades, allowX/hasX para recursos." },
          "label": { "type": "string", "description": "Rótulo exibido no painel, na comparação de planos e na Minha área." },
          "type": { "enum": ["number", "boolean", "string"] },
          "default": { "type": ["number", "boolean", "string"], "description": "Valor usado quando o plano não define a chave. Para number, -1 = ilimitado." },
          "help": { "type": "string", "description": "Explicação para o admin (o que conta neste limite)." }
        }
      }
    },
    "plans": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["name", "price", "interval"],
        "additionalProperties": false,
        "properties": {
          "name": { "type": "string", "description": "Nome do plano. É a chave de atualização: renomear cria um plano novo." },
          "price": { "type": ["string", "number"], "description": "Preço em reais: \"149,90\" (texto) ou 149.9 (número)." },
          "currency": { "type": "string", "default": "brl" },
          "interval": { "enum": ["MONTH", "YEAR", "ONE_TIME"] },
          "highlight": { "type": "boolean", "default": false, "description": "Marca como 'Mais escolhido'." },
          "active": { "type": "boolean", "default": true },
          "config": {
            "type": "object",
            "description": "Valores das chaves do configSchema para este plano. Chaves desconhecidas são recusadas. -1 = ilimitado.",
            "additionalProperties": { "type": ["number", "boolean", "string"] }
          },
          "features": { "type": "array", "items": { "type": "string" }, "description": "Itens exibidos no card do plano (texto de venda)." }
        }
      }
    },
    "addons": {
      "type": "array",
      "description": "Ampliações vendidas à parte, como itens da mesma assinatura do plano.",
      "items": {
        "type": "object",
        "required": ["name", "key", "amount", "price"],
        "additionalProperties": false,
        "properties": {
          "name": { "type": "string", "description": "Ex.: \"+5 usuários\". É a chave de atualização." },
          "key": { "type": "string", "description": "Chave NUMÉRICA do configSchema que este add-on amplia." },
          "amount": { "type": "integer", "minimum": 1, "description": "Quanto cada unidade soma ao limite." },
          "price": { "type": ["string", "number"], "description": "Preço por unidade, por período." },
          "currency": { "type": "string", "default": "brl" },
          "interval": { "enum": ["MONTH", "YEAR"], "default": "MONTH", "description": "Precisa ser igual ao intervalo do plano do cliente." },
          "maxQuantity": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 10, "description": "Máximo de unidades por licença." },
          "description": { "type": "string", "maxLength": 300 },
          "active": { "type": "boolean", "default": true }
        }
      }
    }
  }
}
