funifier-mcp 0.2.0 → 0.2.3

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

@@ -1,91 +1,91 @@
-# Challenge (Desafio)
-
-**Acesso Studio:** `/studio/challenge`
-**API Endpoint:** `/v3/challenge`
-
-## O que é
-
-Configuração de desafios a serem completados por jogadores ou equipes. Permite criar desafios personalizados, definindo ações que o jogador precisa realizar e recompensas que receberá. Os desafios podem variar de simples tarefas a missões complexas compostas por múltiplas ações ou etapas.
-
-## Quando usar
-
-- Em quase todo projeto de gamificação
-- Para definir missões e objetivos para jogadores
-- Para vincular ações a recompensas (pontos, itens, etc.)
-- Para criar progressão e senso de conquista
-
-## Dependências
-
-- **Point**: tipos de ponto devem existir antes de criar challenges que os recompensam
-- **Action**: ações devem existir antes de criar challenges que as referenciam
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir título e descrição do desafio
-- [ ] Definir regras (rules): qual ação, quantas vezes, filtros por atributo
-- [ ] Definir recompensas (points): tipo de ponto e quantidade
-- [ ] Definir frequência (uma vez, diário, semanal, ilimitado)
-- [ ] Definir desbloqueio (quando fica disponível)
-- [ ] Configurar notificações de conclusão
-- [ ] Vincular técnicas de jogo (techniques)
-
-## API Endpoints
-
-### Listar Desafios
-**Método:** GET
-**Endpoint:** `/v3/challenge`
-
-**Exemplo de Resposta:**
-```json
-[
-  {
-    "challenge": "Sell 10 books",
-    "description": "Sell 10 books to earn 25 xp and 5 coins",
-    "rules": [
-      {
-        "actionId": "sell",
-        "filters": [
-          { "value": "book", "operator": 1, "param": "product" }
-        ],
-        "total": 10
-      }
-    ],
-    "points": [
-      { "total": 25, "category": "xp" },
-      { "total": 5, "category": "coin" }
-    ],
-    "_id": "DTkhJHV"
-  }
-]
-```
-
-### Criar Desafio
-**Método:** POST
-**Endpoint:** `/v3/challenge`
-
-**Exemplo de Body:**
-```json
-{
-  "challenge": "Watch Video",
-  "description": "Complete this challenge by watching a video, and earn 10 xp",
-  "rules": [
-    { "actionId": "watch_video", "operator": 5, "total": 0 }
-  ],
-  "points": [
-    { "total": 10.0, "category": "xp", "operation": 0 }
-  ],
-  "techniques": ["GT35"]
-}
-```
-
-### Excluir Desafio
-**Método:** DELETE
-**Endpoint:** `/v3/challenge/:id`
-
-## Validações e Testes
-
-- [ ] Desafio aparece na lista GET /v3/challenge
-- [ ] Ações referenciadas nas rules existem (GET /v3/action)
-- [ ] Pontos referenciados nas recompensas existem (GET /v3/point)
-- [ ] Ao registrar ação (POST /v3/action/log), o desafio progride corretamente
-- [ ] Ao completar o desafio, jogador recebe os pontos definidos
+# Challenge (Desafio)
+
+**Acesso Studio:** `/studio/challenge`
+**API Endpoint:** `/v3/challenge`
+
+## O que é
+
+Configuração de desafios a serem completados por jogadores ou equipes. Permite criar desafios personalizados, definindo ações que o jogador precisa realizar e recompensas que receberá. Os desafios podem variar de simples tarefas a missões complexas compostas por múltiplas ações ou etapas.
+
+## Quando usar
+
+- Em quase todo projeto de gamificação
+- Para definir missões e objetivos para jogadores
+- Para vincular ações a recompensas (pontos, itens, etc.)
+- Para criar progressão e senso de conquista
+
+## Dependências
+
+- **Point**: tipos de ponto devem existir antes de criar challenges que os recompensam
+- **Action**: ações devem existir antes de criar challenges que as referenciam
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir título e descrição do desafio
+- [ ] Definir regras (rules): qual ação, quantas vezes, filtros por atributo
+- [ ] Definir recompensas (points): tipo de ponto e quantidade
+- [ ] Definir frequência (uma vez, diário, semanal, ilimitado)
+- [ ] Definir desbloqueio (quando fica disponível)
+- [ ] Configurar notificações de conclusão
+- [ ] Vincular técnicas de jogo (techniques)
+
+## API Endpoints
+
+### Listar Desafios
+**Método:** GET
+**Endpoint:** `/v3/challenge`
+
+**Exemplo de Resposta:**
+```json
+[
+  {
+    "challenge": "Sell 10 books",
+    "description": "Sell 10 books to earn 25 xp and 5 coins",
+    "rules": [
+      {
+        "actionId": "sell",
+        "filters": [
+          { "value": "book", "operator": 1, "param": "product" }
+        ],
+        "total": 10
+      }
+    ],
+    "points": [
+      { "total": 25, "category": "xp" },
+      { "total": 5, "category": "coin" }
+    ],
+    "_id": "DTkhJHV"
+  }
+]
+```
+
+### Criar Desafio
+**Método:** POST
+**Endpoint:** `/v3/challenge`
+
+**Exemplo de Body:**
+```json
+{
+  "challenge": "Watch Video",
+  "description": "Complete this challenge by watching a video, and earn 10 xp",
+  "rules": [
+    { "actionId": "watch_video", "operator": 5, "total": 0 }
+  ],
+  "points": [
+    { "total": 10.0, "category": "xp", "operation": 0 }
+  ],
+  "techniques": ["GT35"]
+}
+```
+
+### Excluir Desafio
+**Método:** DELETE
+**Endpoint:** `/v3/challenge/:id`
+
+## Validações e Testes
+
+- [ ] Desafio aparece na lista GET /v3/challenge
+- [ ] Ações referenciadas nas rules existem (GET /v3/action)
+- [ ] Pontos referenciados nas recompensas existem (GET /v3/point)
+- [ ] Ao registrar ação (POST /v3/action/log), o desafio progride corretamente
+- [ ] Ao completar o desafio, jogador recebe os pontos definidos

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

@@ -1,40 +1,40 @@
-# Compact (Compactação)
-
-**Acesso Studio:** `/studio/compact`
-**API Endpoint:** `/v3/compact`
-
-## O que é
-
-Compactação e otimização do armazenamento de dados. Configura rotinas para agrupar registros e reduzir o espaço ocupado por dados históricos, como achievements ou logs, melhorando o tempo de resposta das consultas e a performance geral.
-
-## Quando usar
-
-- Para compactar registros de achievements acumulados
-- Para otimizar coleções de acesso rápido
-- Para reduzir volume de dados históricos
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir coleções a compactar
-- [ ] Configurar critérios de agrupamento
-- [ ] Testar impacto na performance
-
-## API Endpoints
-
-### Listar Compactações
-**Método:** GET
-**Endpoint:** `/v3/compact`
-
-### Criar Compactação
-**Método:** POST
-**Endpoint:** `/v3/compact`
-
-### Deletar Compactação
-**Método:** DELETE
-**Endpoint:** `/v3/compact/:id`
-
-## Validações e Testes
-
-- [ ] Compactação é executada sem perda de dados
-- [ ] Volume de dados é reduzido
-- [ ] Consultas mantêm resultados corretos após compactação
+# Compact (Compactação)
+
+**Acesso Studio:** `/studio/compact`
+**API Endpoint:** `/v3/compact`
+
+## O que é
+
+Compactação e otimização do armazenamento de dados. Configura rotinas para agrupar registros e reduzir o espaço ocupado por dados históricos, como achievements ou logs, melhorando o tempo de resposta das consultas e a performance geral.
+
+## Quando usar
+
+- Para compactar registros de achievements acumulados
+- Para otimizar coleções de acesso rápido
+- Para reduzir volume de dados históricos
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir coleções a compactar
+- [ ] Configurar critérios de agrupamento
+- [ ] Testar impacto na performance
+
+## API Endpoints
+
+### Listar Compactações
+**Método:** GET
+**Endpoint:** `/v3/compact`
+
+### Criar Compactação
+**Método:** POST
+**Endpoint:** `/v3/compact`
+
+### Deletar Compactação
+**Método:** DELETE
+**Endpoint:** `/v3/compact/:id`
+
+## Validações e Testes
+
+- [ ] Compactação é executada sem perda de dados
+- [ ] Volume de dados é reduzido
+- [ ] Consultas mantêm resultados corretos após compactação

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

@@ -1,149 +1,149 @@
-# Competition (Competição)
-
-**Acesso Studio:** `/studio/competition`
-**API Endpoint:** `/v3/competition`
-
-## O que é
-
-Configuração de disputas diretas entre jogadores ou equipes. Permite criar competições com regras próprias, prêmios para diferentes posições e critérios de apuração customizáveis. Geralmente, o jogador ou equipe precisa se inscrever para participar.
-
-## Quando usar
-
-- Para criar disputas temporais (ex: competição de vendas mensal)
-- Para premiar os melhores colocados em um período
-- Para engajar equipes com competições internas
-
-## Dependências
-
-- **Point** ou **Action**: métrica de avaliação deve existir
-- **Player** ou **Team**: participantes devem existir
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir título e descrição
-- [ ] Definir período de apuração (period.expression)
-- [ ] Definir número máximo de vencedores (maxWinners)
-- [ ] Definir número máximo de participantes (maxPlayers)
-- [ ] Definir critério de ranking (operation: tipo, item, ordenação)
-- [ ] Definir custo de inscrição (requires) se aplicável
-- [ ] Definir recompensas por posição (rewards com position_start/position_ends)
-- [ ] Definir se é competição de equipes (teamCompetition)
-- [ ] Ativar competição (active: true)
-- [ ] Definir execução automática (autoExecute)
-
-## API Endpoints
-
-### Listar Competições
-**Método:** GET
-**Endpoint:** `/v3/competition`
-
-### Criar Competição
-**Método:** POST
-**Endpoint:** `/v3/competition`
-
-**Exemplo de Body:**
-```json
-{
-  "title": "Sales Race",
-  "description": "Leads the competition who has the highest amount of closed sales in the month.",
-  "period": {
-    "expression": "-0M-;+1M+"
-  },
-  "maxWinners": 1,
-  "maxPlayers": 100,
-  "minScore": 0,
-  "operation": {
-    "type": 1,
-    "achievement_type": 0,
-    "item": "sell",
-    "filters": [],
-    "sort": -1,
-    "sub": false
-  },
-  "requires": [
-    {
-      "total": 10,
-      "type": 0,
-      "item": "coin",
-      "operation": 1,
-      "extra": {},
-      "restrict": false,
-      "perPlayer": false
-    }
-  ],
-  "rewards": [
-    {
-      "total": 100,
-      "type": 0,
-      "item": "xp",
-      "operation": 0,
-      "extra": {
-        "position_start": 1,
-        "position_ends": 3
-      },
-      "restrict": false,
-      "perPlayer": false
-    }
-  ],
-  "notifications": [],
-  "active": true,
-  "teamCompetition": false,
-  "autoExecute": true,
-  "extra": {},
-  "techniques": ["GT26"],
-  "_id": "race"
-}
-```
-
-### Deletar Competição
-**Método:** DELETE
-**Endpoint:** `/v3/competition/:id`
-
-### Listar Participações (Joins)
-**Método:** GET
-**Endpoint:** `/v3/competition/join?competition=:id`
-
-### Criar Participação (Join)
-**Método:** POST
-**Endpoint:** `/v3/competition/join`
-
-**Exemplo de Body:**
-```json
-{
-  "competition": "race",
-  "player": "jerry"
-}
-```
-
-### Deletar Participação
-**Método:** DELETE
-**Endpoint:** `/v3/competition/join`
-
-**Exemplo de Body:**
-```json
-{
-  "competition": "race",
-  "player": "tom"
-}
-```
-
-### Listar Líderes da Competição
-**Método:** POST
-**Endpoint:** `/v3/competition/leader/aggregate?id=:id`
-
-### Executar Competição
-**Método:** GET
-**Endpoint:** `/v3/competition/:id/execute`
-**Descrição:** Finaliza a competição, calcula resultados e premia os vencedores.
-
-### Reverter Execução
-**Método:** DELETE
-**Endpoint:** `/v3/competition/:id/execute`
-
-## Validações e Testes
-
-- [ ] Competição aparece na lista GET /v3/competition
-- [ ] Jogador consegue se inscrever (join)
-- [ ] Lista de líderes retorna dados ordenados
-- [ ] Ao executar, vencedores recebem recompensas
-- [ ] Custo de inscrição é debitado corretamente
+# Competition (Competição)
+
+**Acesso Studio:** `/studio/competition`
+**API Endpoint:** `/v3/competition`
+
+## O que é
+
+Configuração de disputas diretas entre jogadores ou equipes. Permite criar competições com regras próprias, prêmios para diferentes posições e critérios de apuração customizáveis. Geralmente, o jogador ou equipe precisa se inscrever para participar.
+
+## Quando usar
+
+- Para criar disputas temporais (ex: competição de vendas mensal)
+- Para premiar os melhores colocados em um período
+- Para engajar equipes com competições internas
+
+## Dependências
+
+- **Point** ou **Action**: métrica de avaliação deve existir
+- **Player** ou **Team**: participantes devem existir
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir título e descrição
+- [ ] Definir período de apuração (period.expression)
+- [ ] Definir número máximo de vencedores (maxWinners)
+- [ ] Definir número máximo de participantes (maxPlayers)
+- [ ] Definir critério de ranking (operation: tipo, item, ordenação)
+- [ ] Definir custo de inscrição (requires) se aplicável
+- [ ] Definir recompensas por posição (rewards com position_start/position_ends)
+- [ ] Definir se é competição de equipes (teamCompetition)
+- [ ] Ativar competição (active: true)
+- [ ] Definir execução automática (autoExecute)
+
+## API Endpoints
+
+### Listar Competições
+**Método:** GET
+**Endpoint:** `/v3/competition`
+
+### Criar Competição
+**Método:** POST
+**Endpoint:** `/v3/competition`
+
+**Exemplo de Body:**
+```json
+{
+  "title": "Sales Race",
+  "description": "Leads the competition who has the highest amount of closed sales in the month.",
+  "period": {
+    "expression": "-0M-;+1M+"
+  },
+  "maxWinners": 1,
+  "maxPlayers": 100,
+  "minScore": 0,
+  "operation": {
+    "type": 1,
+    "achievement_type": 0,
+    "item": "sell",
+    "filters": [],
+    "sort": -1,
+    "sub": false
+  },
+  "requires": [
+    {
+      "total": 10,
+      "type": 0,
+      "item": "coin",
+      "operation": 1,
+      "extra": {},
+      "restrict": false,
+      "perPlayer": false
+    }
+  ],
+  "rewards": [
+    {
+      "total": 100,
+      "type": 0,
+      "item": "xp",
+      "operation": 0,
+      "extra": {
+        "position_start": 1,
+        "position_ends": 3
+      },
+      "restrict": false,
+      "perPlayer": false
+    }
+  ],
+  "notifications": [],
+  "active": true,
+  "teamCompetition": false,
+  "autoExecute": true,
+  "extra": {},
+  "techniques": ["GT26"],
+  "_id": "race"
+}
+```
+
+### Deletar Competição
+**Método:** DELETE
+**Endpoint:** `/v3/competition/:id`
+
+### Listar Participações (Joins)
+**Método:** GET
+**Endpoint:** `/v3/competition/join?competition=:id`
+
+### Criar Participação (Join)
+**Método:** POST
+**Endpoint:** `/v3/competition/join`
+
+**Exemplo de Body:**
+```json
+{
+  "competition": "race",
+  "player": "jerry"
+}
+```
+
+### Deletar Participação
+**Método:** DELETE
+**Endpoint:** `/v3/competition/join`
+
+**Exemplo de Body:**
+```json
+{
+  "competition": "race",
+  "player": "tom"
+}
+```
+
+### Listar Líderes da Competição
+**Método:** POST
+**Endpoint:** `/v3/competition/leader/aggregate?id=:id`
+
+### Executar Competição
+**Método:** GET
+**Endpoint:** `/v3/competition/:id/execute`
+**Descrição:** Finaliza a competição, calcula resultados e premia os vencedores.
+
+### Reverter Execução
+**Método:** DELETE
+**Endpoint:** `/v3/competition/:id/execute`
+
+## Validações e Testes
+
+- [ ] Competição aparece na lista GET /v3/competition
+- [ ] Jogador consegue se inscrever (join)
+- [ ] Lista de líderes retorna dados ordenados
+- [ ] Ao executar, vencedores recebem recompensas
+- [ ] Custo de inscrição é debitado corretamente

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

@@ -1,41 +1,41 @@
-# Crossword (Palavras Cruzadas)
-
-**Acesso Studio:** `/studio/crossword`
-**API Endpoint:** `/v3/crossword`
-
-## O que é
-
-Configuração de jogos de palavras cruzadas. Permite criar jogos customizados, com dicas, posições e temas específicos para diferentes objetivos educacionais ou promocionais.
-
-## Quando usar
-
-- Para onboarding de funcionários com termos técnicos
-- Para campanhas de marketing temáticas
-- Para jogos educacionais
-- Para engajamento com vocabulário específico
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir título do jogo
-- [ ] Criar palavras com dicas e posições
-- [ ] Configurar tema visual
-
-## API Endpoints
-
-### Listar Crosswords
-**Método:** GET
-**Endpoint:** `/v3/crossword`
-
-### Criar Crossword
-**Método:** POST
-**Endpoint:** `/v3/crossword`
-
-### Deletar Crossword
-**Método:** DELETE
-**Endpoint:** `/v3/crossword/:id`
-
-## Validações e Testes
-
-- [ ] Crossword aparece na lista
-- [ ] Palavras e dicas estão corretas
-- [ ] Jogador consegue interagir com o jogo
+# Crossword (Palavras Cruzadas)
+
+**Acesso Studio:** `/studio/crossword`
+**API Endpoint:** `/v3/crossword`
+
+## O que é
+
+Configuração de jogos de palavras cruzadas. Permite criar jogos customizados, com dicas, posições e temas específicos para diferentes objetivos educacionais ou promocionais.
+
+## Quando usar
+
+- Para onboarding de funcionários com termos técnicos
+- Para campanhas de marketing temáticas
+- Para jogos educacionais
+- Para engajamento com vocabulário específico
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir título do jogo
+- [ ] Criar palavras com dicas e posições
+- [ ] Configurar tema visual
+
+## API Endpoints
+
+### Listar Crosswords
+**Método:** GET
+**Endpoint:** `/v3/crossword`
+
+### Criar Crossword
+**Método:** POST
+**Endpoint:** `/v3/crossword`
+
+### Deletar Crossword
+**Método:** DELETE
+**Endpoint:** `/v3/crossword/:id`
+
+## Validações e Testes
+
+- [ ] Crossword aparece na lista
+- [ ] Palavras e dicas estão corretas
+- [ ] Jogador consegue interagir com o jogo