Regenera G10 — Resultado G10

Esta documentação descreve o menu Resultado G10, responsável por exibir o fechamento técnico resumido da área acompanhada. O objetivo é apresentar ao produtor uma leitura clara, simples e validada pela equipe técnica.

Auth: X-APP-KEY + X-DEVICE-TOKEN Controller: apiG10 Endpoint: resultado_g10 Atualização trimestral

1) Objetivo do menu

O menu Resultado G10 deve apresentar o resultado técnico da área G10 de forma objetiva. Ele não substitui a Galeria, as Análises ou a Comparação de Índices. Ele resume o acompanhamento em uma leitura final simples para o produtor.

A proposta é exibir um percentual de evolução, datas de atualização, um parecer técnico curto e o responsável técnico pelo parecer.

2) Exemplo visual esperado

Resultado G10

Evolução da Área G10

+38,5%
melhora acumulada no acompanhamento
Última atualização 30/06/2026
Próxima atualização 30/09/2026
Parecer técnico A área acompanhada apresentou evolução positiva nos indicadores avaliados no período. Alguns pontos ainda permanecem em atenção, mas os dados sugerem avanço na condição biológica do solo e resposta favorável ao manejo proposto.
Responsável técnico Engº Agrº Dr. Rodrigo do Vale Ferreira

3) Endpoint — Resultado G10

POST https://agroecologia.grupoekos.com.br/router/action.php

Headers

X-APP-KEY: <APP_KEY_FIXA_DO_APP>
X-DEVICE-TOKEN: <DEVICE_TOKEN_SALVO_NO_APARELHO>

Body

action=apiG10
f=resultado_g10
id_g10_participacao=2

A API deve validar se a participação G10 pertence ao cliente vinculado ao device token.

4) Resposta de sucesso

{
  "success": true,
  "msg": "Resultado G10 carregado com sucesso.",
  "data": {
    "id_g10_participacao": 2,
    "cliente_id": 664,
    "disponivel": true,
    "resultado": {
      "id_resultado": 1,
      "percentual_evolucao": 38.5,
      "data_ultima_atualizacao": "2026-06-30",
      "data_proxima_atualizacao": "2026-09-30",
      "resumo_tecnico": "A área acompanhada apresentou evolução positiva nos indicadores avaliados no período. Alguns pontos ainda permanecem em atenção, mas os dados sugerem avanço na condição biológica do solo e resposta favorável ao manejo proposto.",
      "responsavel": {
        "nome": "Rodrigo do Vale Ferreira",
        "titulo": "Engº Agrº Dr.",
        "registro": ""
      },
      "atualizado_em": "2026-06-30 14:30:00"
    }
  }
}

5) Quando ainda não houver Resultado G10

Se ainda não existir parecer técnico ativo no ERP, a API deve retornar sucesso com disponivel = false. Assim o app pode exibir uma mensagem amigável.

{
  "success": true,
  "msg": "Resultado G10 ainda não disponível.",
  "data": {
    "id_g10_participacao": 2,
    "cliente_id": 664,
    "disponivel": false,
    "resultado": null
  }
}

Sugestão de mensagem no app:

Resultado G10 ainda não disponível.
A próxima atualização técnica será exibida assim que for liberada pela equipe responsável.

6) JS de referência para o app

async function carregarResultadoG10(idG10Participacao) {
    const body = new FormData();

    body.append("action", "apiG10");
    body.append("f", "resultado_g10");
    body.append("id_g10_participacao", idG10Participacao);

    const response = await fetch("https://agroecologia.grupoekos.com.br/router/action.php", {
        method: "POST",
        headers: {
            "X-APP-KEY": APP_KEY,
            "X-DEVICE-TOKEN": DEVICE_TOKEN
        },
        body: body
    });

    const json = await response.json();

    if (!json.success) {
        throw new Error(json.msg || "Erro ao carregar Resultado G10.");
    }

    return json.data;
}

7) Como exibir no app

  • Mostrar o percentual em destaque, grande e centralizado.
  • Exibir texto: melhora acumulada no acompanhamento.
  • Mostrar a última atualização realizada.
  • Mostrar a próxima atualização prevista.
  • Exibir o parecer técnico curto.
  • Exibir o responsável técnico no rodapé do card.

8) Regras importantes

  • O app apenas exibe o resultado liberado pelo ERP.
  • O percentual não deve ser calculado no app.
  • O parecer técnico deve ser cadastrado/revisado no ERP.
  • A API deve retornar somente o resultado ativo mais recente.
  • O endpoint deve validar X-APP-KEY e X-DEVICE-TOKEN.
  • A participação G10 precisa pertencer ao cliente do device.