# Pontuação

Uma das funcionalidades de gamificação da Grano é a **distribuição de pontos** conforme o progresso (e respostas) dos usuários ao longo das trilhas.

* Para cards do tipo "**Quiz**": o usuário só pontua se acertar a resposta do Quiz.
* Para os demais cards: o usuário ganha pontos ao passar pelo card.

{% hint style="info" %}
Caso você opte por distribuir pontuação apenas para os cards do tipo Quiz, basta atribuir "peso 0" para os demais cards.
{% endhint %}

Dessa maneira, é possível criar diferentes desafios para o engajamento e medir a retenção de conhecimento dos usuários.

## <mark style="color:blue;">Lógica:</mark>

Está sempre relacionado a um módulo da plataforma, o qual deve ser parametrizado pelo administrador com a quantidade de pontos que serão distribuídos. Exemplo: 100 pontos.

<figure><img src="/files/WVAX8CkBOEqxT7GMC2ci" alt=""><figcaption><p>Atribuição de pontos totais de um módulo</p></figcaption></figure>

Além disso, cada card pode ter o seu peso específico dentro da plataforma. Por exemplo:

* Total de cards: 4
* Pontuação: **100**
  * Card #1: Imagem: Peso **0** (0 pontos)
  * Card #2: Vídeo: Peso **1** (25 pontos)
  * Card #3: Quiz
    * Acertou: Peso **2** (50 pontos)
    * Errou: **0**
  * Card #4: Imagem: Peso **1** (25 pontos)

Nesse caso:

* Ao usuário concluir o módulo e ter errado o quiz, ganhará apenas **50** pontos.
* Ao usuário concluir o módulo e ter acertado o quiz, ganhará **100** pontos.
* Se o usuário fechar o módulo no Card #2, ele ganhará **25** pontos, podendo retornar posteriormente para concluir (e ganhar os respectivos pontos caso acerte o quiz).

{% hint style="danger" %}
**Atenção:** cards com peso 0 (zero) não pontuam.
{% endhint %}

{% hint style="info" %}
**Importante:** o total de pontos de um treinamento é a soma de todos os módulos que compõe o treinamento. Dessa maneira, é possível estipular um valor máximo de pontos do treinamento e dividir, na proporção que melhor entender, entre os módulos específicos.
{% endhint %}

## <mark style="color:blue;">Quando usar?</mark>

* Para situações em que seja necessário distribuir [Badges e Certificados](/conteudo/estrutura-e-conteudos/badges-e-certificados.md) atrelados à performance do usuário. É possível entregar diferentes **conquistas** conforme a pontuação obtida.
* Para criar competição (e rankings) entre usuários.
* Para gerar relatórios de gestão a partir dos pontos obtidos pelos usuários, auxiliando no processo de planejamento de novos conteúdos e desafios aplicáveis.

***

> *© 2026 Grano Edtech LTDA. Todos os direitos reservados.*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.grano.app/conceitos-basicos/pontuacao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
