funifier-mcp 0.1.0 → 0.2.0

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

@@ -0,0 +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

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

@@ -0,0 +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

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

@@ -0,0 +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

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

@@ -0,0 +1,40 @@
+# Notification (Notificação)
+
+**API Endpoint:** `/v3/notification`
+
+## O que é
+
+Envio de mensagens automáticas e feedback instantâneo aos jogadores. Permite configurar e disparar notificações personalizadas quando eventos importantes acontecem, como a conclusão de um desafio, o ganho de uma competição ou uma compra na loja virtual. Notificações podem ser configuradas diretamente em diferentes módulos (Challenge, Competition, etc.).
+
+## Quando usar
+
+- Para parabenizar jogadores por conquistas
+- Para informar sobre prêmios ganhos
+- Para enviar lembretes e feedbacks
+- Para comunicar mudanças de nível
+
+## Checklist de Configuração
+
+- [ ] Definir mensagem da notificação
+- [ ] Vincular ao módulo que dispara a notificação (challenge, competition, etc.)
+- [ ] Definir tipo de notificação (push, in-app, email)
+
+## API Endpoints
+
+### Listar Notificações
+**Método:** GET
+**Endpoint:** `/v3/notification`
+
+### Criar Notificação
+**Método:** POST
+**Endpoint:** `/v3/notification`
+
+### Deletar Notificação
+**Método:** DELETE
+**Endpoint:** `/v3/notification/:id`
+
+## Validações e Testes
+
+- [ ] Notificação é disparada ao completar evento
+- [ ] Mensagem chega corretamente ao jogador
+- [ ] Variáveis dinâmicas são substituídas (nome, pontos, etc.)