funifier-mcp 0.2.0 → 0.2.4

package/datasource-funifier-docs/knowledge/modules/level.md

@@ -1,83 +1,83 @@
-# Level (Nível)
-
-**Acesso Studio:** `/studio/level`
-**API Endpoint:** `/v3/level`
-
-## O que é
-
-Sistema de progressão por níveis. Permite definir a progressão dos jogadores com base em pontos acumulados ou outros critérios, atribuindo títulos ou benefícios a cada nível. Pode-se exigir desafios específicos para desbloquear certos níveis.
-
-## Quando usar
-
-- Para criar senso de progressão e conquista
-- Para desbloquear funcionalidades por nível
-- Para segmentar jogadores por experiência
-- Exemplos: Júnior → Pleno → Sênior; faixas coloridas
-
-## Dependências
-
-- **Point**: a categoria de ponto usada para progressão deve existir antes
-- **Configuração global**: definir qual ponto controla os níveis via `/v3/database/level_config`
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir _id do nível (ex: L0, L1, L2)
-- [ ] Definir nome do nível (ex: "Apprentice", "Master")
-- [ ] Definir descrição motivadora
-- [ ] Definir minPoints (pontuação mínima crescente)
-- [ ] Definir position (ordem sequencial, iniciando em 0)
-- [ ] Configurar categoria de ponto global (level_config)
-
-## API Endpoints
-
-### Listar Níveis
-**Método:** GET
-**Endpoint:** `/v3/level`
-
-### Criar Nível
-**Método:** POST
-**Endpoint:** `/v3/level`
-
-**Exemplo de Body:**
-```json
-{
-  "level": "Apprentice",
-  "position": 0,
-  "description": "It indicates that you are learning and growing.",
-  "minPoints": 10,
-  "notifications": [],
-  "requirements": [],
-  "i18n": {},
-  "extra": {},
-  "techniques": ["GT85"],
-  "_id": "L0"
-}
-```
-
-### Excluir Nível
-**Método:** DELETE
-**Endpoint:** `/v3/level/:id`
-
-### Configurar Ponto Global para Níveis
-**Método:** PUT
-**Endpoint:** `/v3/database/level_config`
-
-**Exemplo de Body:**
-```json
-{
-  "_id": "global",
-  "pointCategory": "xp"
-}
-```
-
-### Atualizar Posições dos Níveis
-**Método:** PUT
-**Endpoint:** `/v3/level/position`
-**Descrição:** Recalcula posições com base no minPoints.
-
-## Validações e Testes
-
-- [ ] Níveis aparecem na lista GET /v3/level
-- [ ] minPoints é crescente entre níveis
-- [ ] level_config aponta para o ponto correto
-- [ ] Ao ganhar pontos suficientes, jogador sobe de nível automaticamente
+# Level (Nível)
+
+**Acesso Studio:** `/studio/level`
+**API Endpoint:** `/v3/level`
+
+## O que é
+
+Sistema de progressão por níveis. Permite definir a progressão dos jogadores com base em pontos acumulados ou outros critérios, atribuindo títulos ou benefícios a cada nível. Pode-se exigir desafios específicos para desbloquear certos níveis.
+
+## Quando usar
+
+- Para criar senso de progressão e conquista
+- Para desbloquear funcionalidades por nível
+- Para segmentar jogadores por experiência
+- Exemplos: Júnior → Pleno → Sênior; faixas coloridas
+
+## Dependências
+
+- **Point**: a categoria de ponto usada para progressão deve existir antes
+- **Configuração global**: definir qual ponto controla os níveis via `/v3/database/level_config`
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir _id do nível (ex: L0, L1, L2)
+- [ ] Definir nome do nível (ex: "Apprentice", "Master")
+- [ ] Definir descrição motivadora
+- [ ] Definir minPoints (pontuação mínima crescente)
+- [ ] Definir position (ordem sequencial, iniciando em 0)
+- [ ] Configurar categoria de ponto global (level_config)
+
+## API Endpoints
+
+### Listar Níveis
+**Método:** GET
+**Endpoint:** `/v3/level`
+
+### Criar Nível
+**Método:** POST
+**Endpoint:** `/v3/level`
+
+**Exemplo de Body:**
+```json
+{
+  "level": "Apprentice",
+  "position": 0,
+  "description": "It indicates that you are learning and growing.",
+  "minPoints": 10,
+  "notifications": [],
+  "requirements": [],
+  "i18n": {},
+  "extra": {},
+  "techniques": ["GT85"],
+  "_id": "L0"
+}
+```
+
+### Excluir Nível
+**Método:** DELETE
+**Endpoint:** `/v3/level/:id`
+
+### Configurar Ponto Global para Níveis
+**Método:** PUT
+**Endpoint:** `/v3/database/level_config`
+
+**Exemplo de Body:**
+```json
+{
+  "_id": "global",
+  "pointCategory": "xp"
+}
+```
+
+### Atualizar Posições dos Níveis
+**Método:** PUT
+**Endpoint:** `/v3/level/position`
+**Descrição:** Recalcula posições com base no minPoints.
+
+## Validações e Testes
+
+- [ ] Níveis aparecem na lista GET /v3/level
+- [ ] minPoints é crescente entre níveis
+- [ ] level_config aponta para o ponto correto
+- [ ] Ao ganhar pontos suficientes, jogador sobe de nível automaticamente

package/datasource-funifier-docs/knowledge/modules/lottery.md

@@ -1,112 +1,112 @@
-# Lottery (Sorteio)
-
-**Acesso Studio:** `/studio/lottery`
-**API Endpoint:** `/v3/lottery`
-
-## O que é
-
-Configuração de sorteios e concursos. Permite criar sorteios nos quais os jogadores participam com cupons obtidos em outras mecânicas, como desafios. É possível definir datas, limites de ganhadores e prêmios para os sorteados.
-
-## Quando usar
-
-- Para criar campanhas promocionais com prêmios
-- Para sorteios de viagens, produtos ou experiências
-- Para incentivar participação em desafios (cupons como recompensa)
-
-## Dependências
-
-- **Virtual Good** (opcional): itens podem ser usados como prêmio do sorteio
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir título e descrição do sorteio
-- [ ] Definir data do sorteio (drawDate)
-- [ ] Definir método de escolha (random_ticket)
-- [ ] Definir número máximo de ganhadores (maxWinners)
-- [ ] Definir limite por jogador (maxPerPlayer)
-- [ ] Configurar recompensas (rewards)
-- [ ] Definir se executa automaticamente (autoExecute)
-
-## API Endpoints
-
-### Listar Sorteios
-**Método:** GET
-**Endpoint:** `/v3/lottery`
-
-**Exemplo de Resposta:**
-```json
-[
-  {
-    "title": "Travel to Cancun",
-    "description": "Travel with a companion to Cancun, with airfare and accommodation, for 7 days.",
-    "drawDate": 1690824650503,
-    "autoExecute": true,
-    "choiceMethod": "random_ticket",
-    "maxWinners": 1,
-    "maxPerPlayer": 1,
-    "techniques": ["GT74"],
-    "rewards": [
-      {
-        "total": 1,
-        "type": 2,
-        "item": "flight_ticket"
-      }
-    ],
-    "_id": "DTj0x5z"
-  }
-]
-```
-
-### Criar Sorteio
-**Método:** POST
-**Endpoint:** `/v3/lottery`
-(Body igual ao exemplo de resposta acima)
-
-### Deletar Sorteio
-**Método:** DELETE
-**Endpoint:** `/v3/lottery/:id`
-
-### Listar Cupons
-**Método:** GET
-**Endpoint:** `/v3/lottery/ticket?lottery=:id`
-
-### Criar Cupom
-**Método:** POST
-**Endpoint:** `/v3/lottery/ticket`
-
-**Exemplo de Body:**
-```json
-{
-  "lottery": "DTj0x5z",
-  "player": "tom"
-}
-```
-
-### Deletar Cupom
-**Método:** DELETE
-**Endpoint:** `/v3/lottery/ticket/:id`
-
-### Executar Sorteio
-**Método:** GET
-**Endpoint:** `/v3/lottery/:id/execute`
-**Descrição:** Executa o sorteio e seleciona os vencedores aleatoriamente.
-
-### Reverter Execução do Sorteio
-**Método:** DELETE
-**Endpoint:** `/v3/lottery/:id/execute`
-
-### Listar Vencedores
-**Método:** GET
-**Endpoint:** `/v3/lottery/winner?lottery=:id`
-
-### Listar Participantes
-**Método:** GET
-**Endpoint:** `/v3/lottery/participants?lottery=:id`
-
-## Validações e Testes
-
-- [ ] Sorteio aparece na lista GET /v3/lottery
-- [ ] Cupom é criado corretamente para jogador
-- [ ] Ao executar sorteio, vencedor é selecionado
-- [ ] Lista de vencedores retorna dados corretos
-- [ ] Reverter execução funciona
+# Lottery (Sorteio)
+
+**Acesso Studio:** `/studio/lottery`
+**API Endpoint:** `/v3/lottery`
+
+## O que é
+
+Configuração de sorteios e concursos. Permite criar sorteios nos quais os jogadores participam com cupons obtidos em outras mecânicas, como desafios. É possível definir datas, limites de ganhadores e prêmios para os sorteados.
+
+## Quando usar
+
+- Para criar campanhas promocionais com prêmios
+- Para sorteios de viagens, produtos ou experiências
+- Para incentivar participação em desafios (cupons como recompensa)
+
+## Dependências
+
+- **Virtual Good** (opcional): itens podem ser usados como prêmio do sorteio
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir título e descrição do sorteio
+- [ ] Definir data do sorteio (drawDate)
+- [ ] Definir método de escolha (random_ticket)
+- [ ] Definir número máximo de ganhadores (maxWinners)
+- [ ] Definir limite por jogador (maxPerPlayer)
+- [ ] Configurar recompensas (rewards)
+- [ ] Definir se executa automaticamente (autoExecute)
+
+## API Endpoints
+
+### Listar Sorteios
+**Método:** GET
+**Endpoint:** `/v3/lottery`
+
+**Exemplo de Resposta:**
+```json
+[
+  {
+    "title": "Travel to Cancun",
+    "description": "Travel with a companion to Cancun, with airfare and accommodation, for 7 days.",
+    "drawDate": 1690824650503,
+    "autoExecute": true,
+    "choiceMethod": "random_ticket",
+    "maxWinners": 1,
+    "maxPerPlayer": 1,
+    "techniques": ["GT74"],
+    "rewards": [
+      {
+        "total": 1,
+        "type": 2,
+        "item": "flight_ticket"
+      }
+    ],
+    "_id": "DTj0x5z"
+  }
+]
+```
+
+### Criar Sorteio
+**Método:** POST
+**Endpoint:** `/v3/lottery`
+(Body igual ao exemplo de resposta acima)
+
+### Deletar Sorteio
+**Método:** DELETE
+**Endpoint:** `/v3/lottery/:id`
+
+### Listar Cupons
+**Método:** GET
+**Endpoint:** `/v3/lottery/ticket?lottery=:id`
+
+### Criar Cupom
+**Método:** POST
+**Endpoint:** `/v3/lottery/ticket`
+
+**Exemplo de Body:**
+```json
+{
+  "lottery": "DTj0x5z",
+  "player": "tom"
+}
+```
+
+### Deletar Cupom
+**Método:** DELETE
+**Endpoint:** `/v3/lottery/ticket/:id`
+
+### Executar Sorteio
+**Método:** GET
+**Endpoint:** `/v3/lottery/:id/execute`
+**Descrição:** Executa o sorteio e seleciona os vencedores aleatoriamente.
+
+### Reverter Execução do Sorteio
+**Método:** DELETE
+**Endpoint:** `/v3/lottery/:id/execute`
+
+### Listar Vencedores
+**Método:** GET
+**Endpoint:** `/v3/lottery/winner?lottery=:id`
+
+### Listar Participantes
+**Método:** GET
+**Endpoint:** `/v3/lottery/participants?lottery=:id`
+
+## Validações e Testes
+
+- [ ] Sorteio aparece na lista GET /v3/lottery
+- [ ] Cupom é criado corretamente para jogador
+- [ ] Ao executar sorteio, vencedor é selecionado
+- [ ] Lista de vencedores retorna dados corretos
+- [ ] Reverter execução funciona

package/datasource-funifier-docs/knowledge/modules/marketplace.md

@@ -1,27 +1,27 @@
-# Marketplace (Mercado)
-
-**Acesso Studio:** `/market`
-
-## O que é
-
-Compartilhamento e reutilização de componentes prontos para gamificações. Disponibiliza um catálogo de componentes já configurados — como desafios, rankings, widgets, modelos de gamificação — que podem ser reutilizados em diferentes projetos, acelerando a implementação.
-
-## Quando usar
-
-- Para reutilizar modelos de gamificação validados
-- Para compartilhar componentes entre departamentos
-- Para acelerar implementação com templates prontos
-- Para padronizar gamificações na organização
-
-## Checklist de Configuração
-
-- [ ] Acessar o marketplace via /market
-- [ ] Selecionar componente desejado
-- [ ] Importar para a gamificação atual
-- [ ] Customizar conforme necessidade
-
-## Validações e Testes
-
-- [ ] Componente é importado com sucesso
-- [ ] Configurações importadas estão corretas
-- [ ] Componente funciona na gamificação atual
+# Marketplace (Mercado)
+
+**Acesso Studio:** `/market`
+
+## O que é
+
+Compartilhamento e reutilização de componentes prontos para gamificações. Disponibiliza um catálogo de componentes já configurados — como desafios, rankings, widgets, modelos de gamificação — que podem ser reutilizados em diferentes projetos, acelerando a implementação.
+
+## Quando usar
+
+- Para reutilizar modelos de gamificação validados
+- Para compartilhar componentes entre departamentos
+- Para acelerar implementação com templates prontos
+- Para padronizar gamificações na organização
+
+## Checklist de Configuração
+
+- [ ] Acessar o marketplace via /market
+- [ ] Selecionar componente desejado
+- [ ] Importar para a gamificação atual
+- [ ] Customizar conforme necessidade
+
+## Validações e Testes
+
+- [ ] Componente é importado com sucesso
+- [ ] Configurações importadas estão corretas
+- [ ] Componente funciona na gamificação atual

package/datasource-funifier-docs/knowledge/modules/mystery.md

@@ -1,82 +1,82 @@
-# Mystery (Mistério / Caixa Surpresa)
-
-**Acesso Studio:** `/studio/mystery`
-**API Endpoint:** `/v3/mystery`
-
-## O que é
-
-Jogos de probabilidade e recompensas aleatórias. Permite criar experiências como caixas surpresa, rodas da fortuna, raspadinhas e outros jogos baseados em sorte, definindo as chances e prêmios disponíveis.
-
-## Quando usar
-
-- Para criar rodas da fortuna
-- Para raspadinhas premiadas
-- Para jogos de cara ou coroa
-- Para recompensas aleatórias com probabilidades definidas
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir título da mystery box
-- [ ] Definir opções com probabilidades (devem somar 1.0)
-- [ ] Definir número de colunas para exibição
-- [ ] Configurar combinações vencedoras (win_chart)
-- [ ] Definir recompensas para cada combinação
-- [ ] Configurar requisitos para jogar (requirements)
-
-## API Endpoints
-
-### Listar Mystery Boxes
-**Método:** GET
-**Endpoint:** `/v3/mystery`
-
-### Criar Mystery Box
-**Método:** POST
-**Endpoint:** `/v3/mystery`
-
-**Exemplo de Body:**
-```json
-{
-  "title": "Heads or Tails",
-  "options": [
-    { "title": "Heads", "value": "heads", "probability": 0.5 },
-    { "title": "Tails", "value": "tails", "probability": 0.5 }
-  ],
-  "columns": 1,
-  "requirements": [],
-  "win_chart": [
-    {
-      "combination": ["heads"],
-      "orderSensitive": false,
-      "reward": {
-        "total": 1,
-        "type": 0,
-        "item": "coin"
-      }
-    }
-  ],
-  "techniques": ["GT72"],
-  "_id": "64a5b464d8dcca49bcf7edd0"
-}
-```
-
-### Deletar Mystery Box
-**Método:** DELETE
-**Endpoint:** `/v3/mystery/:id`
-
-### Avaliar Condições
-**Método:** GET
-**Endpoint:** `/v3/mystery/evaluate/:id?player=:player_id`
-**Descrição:** Verifica se o jogador está apto a executar a Mystery Box.
-
-### Executar Mystery Box
-**Método:** GET
-**Endpoint:** `/v3/mystery/execute/:id?player=:player_id`
-**Descrição:** Executa o sorteio e retorna o resultado.
-
-## Validações e Testes
-
-- [ ] Mystery Box aparece na lista
-- [ ] Soma das probabilidades é 1.0
-- [ ] Jogador consegue executar a mystery box
-- [ ] Combinação vencedora entrega recompensa corretamente
-- [ ] Requisitos são validados antes da execução
+# Mystery (Mistério / Caixa Surpresa)
+
+**Acesso Studio:** `/studio/mystery`
+**API Endpoint:** `/v3/mystery`
+
+## O que é
+
+Jogos de probabilidade e recompensas aleatórias. Permite criar experiências como caixas surpresa, rodas da fortuna, raspadinhas e outros jogos baseados em sorte, definindo as chances e prêmios disponíveis.
+
+## Quando usar
+
+- Para criar rodas da fortuna
+- Para raspadinhas premiadas
+- Para jogos de cara ou coroa
+- Para recompensas aleatórias com probabilidades definidas
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir título da mystery box
+- [ ] Definir opções com probabilidades (devem somar 1.0)
+- [ ] Definir número de colunas para exibição
+- [ ] Configurar combinações vencedoras (win_chart)
+- [ ] Definir recompensas para cada combinação
+- [ ] Configurar requisitos para jogar (requirements)
+
+## API Endpoints
+
+### Listar Mystery Boxes
+**Método:** GET
+**Endpoint:** `/v3/mystery`
+
+### Criar Mystery Box
+**Método:** POST
+**Endpoint:** `/v3/mystery`
+
+**Exemplo de Body:**
+```json
+{
+  "title": "Heads or Tails",
+  "options": [
+    { "title": "Heads", "value": "heads", "probability": 0.5 },
+    { "title": "Tails", "value": "tails", "probability": 0.5 }
+  ],
+  "columns": 1,
+  "requirements": [],
+  "win_chart": [
+    {
+      "combination": ["heads"],
+      "orderSensitive": false,
+      "reward": {
+        "total": 1,
+        "type": 0,
+        "item": "coin"
+      }
+    }
+  ],
+  "techniques": ["GT72"],
+  "_id": "64a5b464d8dcca49bcf7edd0"
+}
+```
+
+### Deletar Mystery Box
+**Método:** DELETE
+**Endpoint:** `/v3/mystery/:id`
+
+### Avaliar Condições
+**Método:** GET
+**Endpoint:** `/v3/mystery/evaluate/:id?player=:player_id`
+**Descrição:** Verifica se o jogador está apto a executar a Mystery Box.
+
+### Executar Mystery Box
+**Método:** GET
+**Endpoint:** `/v3/mystery/execute/:id?player=:player_id`
+**Descrição:** Executa o sorteio e retorna o resultado.
+
+## Validações e Testes
+
+- [ ] Mystery Box aparece na lista
+- [ ] Soma das probabilidades é 1.0
+- [ ] Jogador consegue executar a mystery box
+- [ ] Combinação vencedora entrega recompensa corretamente
+- [ ] Requisitos são validados antes da execução