funifier-mcp 0.2.0 → 0.2.4

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

@@ -1,111 +1,111 @@
-# Folder (Pasta)
-
-**Acesso Studio:** `/studio/folder`
-**API Endpoint:** `/v3/folder`
-
-## O que é
-
-Organização de conteúdos e monitoramento do progresso em cursos ou trilhas. Permite criar pastas virtuais para agrupar conteúdos como quizzes, desafios, materiais de estudo e jogos, facilitando o acompanhamento do progresso dos jogadores em jornadas de aprendizagem ou trilhas gamificadas.
-
-## Quando usar
-
-- Para estruturar cursos online
-- Para criar trilhas de capacitação
-- Para acompanhar progresso em treinamentos
-- Para organizar conteúdos em hierarquias (módulos → aulas → conteúdos)
-
-## Checklist de Configuração no Studio
-
-- [ ] Criar estrutura hierárquica de pastas
-- [ ] Definir títulos das pastas
-- [ ] Associar conteúdos às pastas (quizzes, desafios, textos)
-- [ ] Definir tipos de conteúdo (folder_content_type)
-- [ ] Configurar pasta-pai (parent) para hierarquia
-
-## API Endpoints
-
-### Listar Pastas
-**Método:** GET
-**Endpoint:** `/v3/database/folder`
-
-### Criar Pasta
-**Método:** POST
-**Endpoint:** `/v3/folder`
-
-**Exemplo de Body:**
-```json
-{
-  "title": "CoreDrives",
-  "parent": "D0MmmNf"
-}
-```
-
-### Deletar Pasta
-**Método:** DELETE
-**Endpoint:** `/v3/folder/:id`
-
-### Obter Breadcrumb
-**Método:** POST
-**Endpoint:** `/v3/folder/breadcrumb`
-
-**Exemplo de Body:**
-```json
-{
-  "folder": "CD1"
-}
-```
-
-### Listar Tipos de Conteúdo
-**Método:** GET
-**Endpoint:** `/v3/database/folder_content_type`
-
-### Criar/Atualizar Tipo de Conteúdo
-**Método:** PUT
-**Endpoint:** `/v3/database/folder_content_type`
-
-**Exemplo de Body:**
-```json
-{
-  "_id": "text",
-  "input": "formulary",
-  "form": [
-    { "name": "title", "type": "string", "title": "Title" },
-    { "name": "content", "type": "text", "title": "Content" }
-  ],
-  "title": "Text",
-  "entity": "text__c"
-}
-```
-
-## Casos de Uso Comuns
-
-- **Curso Online:** Pasta raiz "Curso de Vendas" → Subpastas "Módulo 1", "Módulo 2" → Conteúdos (textos, vídeos, quizzes)
-- **Trilha de Capacitação:** Pastas representam etapas; cada etapa contém materiais e avaliações
-- **Catálogo de Produtos:** Pastas como categorias; conteúdos como fichas de produto
-- **Onboarding:** Pastas representam fases do onboarding; progresso monitora completude
-
-## Progresso do Jogador
-
-O Folder monitora automaticamente o progresso do jogador dentro da árvore de diretórios. Isso permite:
-
-- Saber que um jogador completou X% de um curso
-- Registrar action logs ao progredir (aciona técnicas de jogos)
-- Criar desafios vinculados à completude de um folder (ex: "Complete o curso para ganhar 500 XP")
-
-## Integração com Outras Técnicas
-
-| Técnica | Integração |
-|---------|-----------|
-| **Challenge** | Desafio completado quando jogador termina todos os itens de um folder |
-| **Quiz** | Quizzes podem ser conteúdos dentro de um folder |
-| **Point** | Pontos concedidos ao progredir no folder |
-| **Achievement** | Conquista desbloqueada ao completar 100% do folder |
-
-## Validações e Testes
-
-- [ ] Pasta aparece na lista
-- [ ] Hierarquia pai-filho funciona
-- [ ] Breadcrumb retorna caminho correto
-- [ ] Conteúdos são associados corretamente
-- [ ] Progresso do jogador é calculado corretamente
-- [ ] Action log é gerado ao progredir
+# Folder (Pasta)
+
+**Acesso Studio:** `/studio/folder`
+**API Endpoint:** `/v3/folder`
+
+## O que é
+
+Organização de conteúdos e monitoramento do progresso em cursos ou trilhas. Permite criar pastas virtuais para agrupar conteúdos como quizzes, desafios, materiais de estudo e jogos, facilitando o acompanhamento do progresso dos jogadores em jornadas de aprendizagem ou trilhas gamificadas.
+
+## Quando usar
+
+- Para estruturar cursos online
+- Para criar trilhas de capacitação
+- Para acompanhar progresso em treinamentos
+- Para organizar conteúdos em hierarquias (módulos → aulas → conteúdos)
+
+## Checklist de Configuração no Studio
+
+- [ ] Criar estrutura hierárquica de pastas
+- [ ] Definir títulos das pastas
+- [ ] Associar conteúdos às pastas (quizzes, desafios, textos)
+- [ ] Definir tipos de conteúdo (folder_content_type)
+- [ ] Configurar pasta-pai (parent) para hierarquia
+
+## API Endpoints
+
+### Listar Pastas
+**Método:** GET
+**Endpoint:** `/v3/database/folder`
+
+### Criar Pasta
+**Método:** POST
+**Endpoint:** `/v3/folder`
+
+**Exemplo de Body:**
+```json
+{
+  "title": "CoreDrives",
+  "parent": "D0MmmNf"
+}
+```
+
+### Deletar Pasta
+**Método:** DELETE
+**Endpoint:** `/v3/folder/:id`
+
+### Obter Breadcrumb
+**Método:** POST
+**Endpoint:** `/v3/folder/breadcrumb`
+
+**Exemplo de Body:**
+```json
+{
+  "folder": "CD1"
+}
+```
+
+### Listar Tipos de Conteúdo
+**Método:** GET
+**Endpoint:** `/v3/database/folder_content_type`
+
+### Criar/Atualizar Tipo de Conteúdo
+**Método:** PUT
+**Endpoint:** `/v3/database/folder_content_type`
+
+**Exemplo de Body:**
+```json
+{
+  "_id": "text",
+  "input": "formulary",
+  "form": [
+    { "name": "title", "type": "string", "title": "Title" },
+    { "name": "content", "type": "text", "title": "Content" }
+  ],
+  "title": "Text",
+  "entity": "text__c"
+}
+```
+
+## Casos de Uso Comuns
+
+- **Curso Online:** Pasta raiz "Curso de Vendas" → Subpastas "Módulo 1", "Módulo 2" → Conteúdos (textos, vídeos, quizzes)
+- **Trilha de Capacitação:** Pastas representam etapas; cada etapa contém materiais e avaliações
+- **Catálogo de Produtos:** Pastas como categorias; conteúdos como fichas de produto
+- **Onboarding:** Pastas representam fases do onboarding; progresso monitora completude
+
+## Progresso do Jogador
+
+O Folder monitora automaticamente o progresso do jogador dentro da árvore de diretórios. Isso permite:
+
+- Saber que um jogador completou X% de um curso
+- Registrar action logs ao progredir (aciona técnicas de jogos)
+- Criar desafios vinculados à completude de um folder (ex: "Complete o curso para ganhar 500 XP")
+
+## Integração com Outras Técnicas
+
+| Técnica | Integração |
+|---------|-----------|
+| **Challenge** | Desafio completado quando jogador termina todos os itens de um folder |
+| **Quiz** | Quizzes podem ser conteúdos dentro de um folder |
+| **Point** | Pontos concedidos ao progredir no folder |
+| **Achievement** | Conquista desbloqueada ao completar 100% do folder |
+
+## Validações e Testes
+
+- [ ] Pasta aparece na lista
+- [ ] Hierarquia pai-filho funciona
+- [ ] Breadcrumb retorna caminho correto
+- [ ] Conteúdos são associados corretamente
+- [ ] Progresso do jogador é calculado corretamente
+- [ ] Action log é gerado ao progredir

package/datasource-funifier-docs/knowledge/modules/kpi-formulas.md

@@ -1,23 +1,23 @@
-# KPI Formulas (Fórmulas de KPI)
-
-## O que é
-
-Configuração de regras e cálculos avançados para avaliar ações dos jogadores. Permite criar fórmulas customizadas para avaliação de desempenho e resultados, indo além das regras padrão dos outros módulos.
-
-## Quando usar
-
-- Para cálculos avançados de desempenho que os módulos padrão não atendem
-- Para fórmulas considerando múltiplos critérios (quantidade, valor, tempo)
-- Para regras avançadas de rankings
-- **Importante:** usar com critério, apenas quando recursos padrão não atendem
-
-## Checklist de Configuração
-
-- [ ] Definir a fórmula de cálculo
-- [ ] Vincular aos desafios ou rankings relevantes
-- [ ] Testar com dados reais
-
-## Validações e Testes
-
-- [ ] Fórmula retorna resultados esperados
-- [ ] Cálculo funciona com diferentes combinações de dados
+# KPI Formulas (Fórmulas de KPI)
+
+## O que é
+
+Configuração de regras e cálculos avançados para avaliar ações dos jogadores. Permite criar fórmulas customizadas para avaliação de desempenho e resultados, indo além das regras padrão dos outros módulos.
+
+## Quando usar
+
+- Para cálculos avançados de desempenho que os módulos padrão não atendem
+- Para fórmulas considerando múltiplos critérios (quantidade, valor, tempo)
+- Para regras avançadas de rankings
+- **Importante:** usar com critério, apenas quando recursos padrão não atendem
+
+## Checklist de Configuração
+
+- [ ] Definir a fórmula de cálculo
+- [ ] Vincular aos desafios ou rankings relevantes
+- [ ] Testar com dados reais
+
+## Validações e Testes
+
+- [ ] Fórmula retorna resultados esperados
+- [ ] Cálculo funciona com diferentes combinações de dados

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

@@ -1,45 +1,45 @@
-# LastMile (Última Milha)
-
-**Acesso Studio:** `/studio/lastmile`
-**API Endpoint:** `/v3/lastmile`
-
-## O que é
-
-Envio de mensagens motivacionais quando o jogador está próximo de uma meta. Permite configurar mensagens automáticas para engajar e lembrar os jogadores sobre metas e desafios que estão prestes a serem concluídos, aumentando a taxa de finalização.
-
-## Quando usar
-
-- Para lembrar jogadores que estão perto de completar desafios
-- Para aumentar taxa de conclusão de metas
-- Para enviar mensagens motivacionais personalizadas
-- Para engajar jogadores que estão a 80-90% de uma meta
-
-## Dependências
-
-- **Challenge**: desafios devem existir para monitorar progresso
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir condição de disparo (% de progresso)
-- [ ] Definir mensagem motivacional
-- [ ] Vincular ao desafio ou meta específica
-
-## API Endpoints
-
-### Listar LastMile
-**Método:** GET
-**Endpoint:** `/v3/lastmile`
-
-### Criar LastMile
-**Método:** POST
-**Endpoint:** `/v3/lastmile`
-
-### Deletar LastMile
-**Método:** DELETE
-**Endpoint:** `/v3/lastmile/:id`
-
-## Validações e Testes
-
-- [ ] Configuração de LastMile aparece na lista
-- [ ] Mensagem é disparada ao atingir % configurado
-- [ ] Jogador recebe notificação corretamente
+# LastMile (Última Milha)
+
+**Acesso Studio:** `/studio/lastmile`
+**API Endpoint:** `/v3/lastmile`
+
+## O que é
+
+Envio de mensagens motivacionais quando o jogador está próximo de uma meta. Permite configurar mensagens automáticas para engajar e lembrar os jogadores sobre metas e desafios que estão prestes a serem concluídos, aumentando a taxa de finalização.
+
+## Quando usar
+
+- Para lembrar jogadores que estão perto de completar desafios
+- Para aumentar taxa de conclusão de metas
+- Para enviar mensagens motivacionais personalizadas
+- Para engajar jogadores que estão a 80-90% de uma meta
+
+## Dependências
+
+- **Challenge**: desafios devem existir para monitorar progresso
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir condição de disparo (% de progresso)
+- [ ] Definir mensagem motivacional
+- [ ] Vincular ao desafio ou meta específica
+
+## API Endpoints
+
+### Listar LastMile
+**Método:** GET
+**Endpoint:** `/v3/lastmile`
+
+### Criar LastMile
+**Método:** POST
+**Endpoint:** `/v3/lastmile`
+
+### Deletar LastMile
+**Método:** DELETE
+**Endpoint:** `/v3/lastmile/:id`
+
+## Validações e Testes
+
+- [ ] Configuração de LastMile aparece na lista
+- [ ] Mensagem é disparada ao atingir % configurado
+- [ ] Jogador recebe notificação corretamente

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

@@ -1,98 +1,98 @@
-# Leaderboard (Ranking)
-
-**Acesso Studio:** `/studio/leaderboard`
-**API Endpoint:** `/v3/leaderboard`
-
-## O que é
-
-Criação e gestão de rankings. Permite comparar o desempenho dos jogadores utilizando diferentes critérios, como pontos, tempo, ou métricas customizadas. Rankings podem ser individuais, por equipes, por período ou por status.
-
-## Quando usar
-
-- Para criar competição saudável entre jogadores
-- Para dar visibilidade ao desempenho
-- Para motivar através de comparação social
-- Para rankings semanais, mensais ou em tempo real
-
-## Dependências
-
-- **Point** ou **Action**: o critério de ranking deve estar configurado
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir título e descrição
-- [ ] Definir tipo de principal (0 = jogador, 1 = equipe)
-- [ ] Definir operação (tipo de métrica, item, ordenação)
-- [ ] Definir período (semanal, mensal, tempo real)
-- [ ] Vincular técnicas de jogo
-
-## API Endpoints
-
-### Listar Leaderboards
-**Método:** GET
-**Endpoint:** `/v3/leaderboard`
-
-**Exemplo de Resposta:**
-```json
-[
-  {
-    "title": "Top Players",
-    "description": "Players with the most points xp in the week",
-    "principalType": 0,
-    "operation": {
-      "type": 3,
-      "achievement_type": 0,
-      "item": "xp",
-      "filters": [],
-      "sort": -1,
-      "sub": false
-    },
-    "period": {
-      "type": 0,
-      "timeAmount": 1,
-      "timeScale": 6
-    },
-    "techniques": ["GT03"],
-    "_id": "DTjTvZ5"
-  }
-]
-```
-
-### Criar Leaderboard
-**Método:** POST
-**Endpoint:** `/v3/leaderboard`
-(Body igual ao exemplo de resposta acima)
-
-### Deletar Leaderboard
-**Método:** DELETE
-**Endpoint:** `/v3/leaderboard/:id`
-
-### Obter Lista de Líderes
-**Método:** POST
-**Endpoint:** `/v3/leaderboard/:id/leader/aggregate?period=&live=true`
-
-**Exemplo de Resposta:**
-```json
-[
-  {
-    "_id": "tom_D0zCMvq",
-    "total": 30,
-    "position": 1,
-    "move": "up",
-    "player": "tom",
-    "name": "Tom",
-    "boardId": "DTjTvZ5"
-  }
-]
-```
-
-### Resetar Cache
-**Método:** GET
-**Endpoint:** `/v3/leaderboard/reset`
-
-## Validações e Testes
-
-- [ ] Leaderboard aparece na lista GET /v3/leaderboard
-- [ ] Lista de líderes retorna jogadores ordenados
-- [ ] Período está configurado corretamente
-- [ ] Cache pode ser resetado com sucesso
+# Leaderboard (Ranking)
+
+**Acesso Studio:** `/studio/leaderboard`
+**API Endpoint:** `/v3/leaderboard`
+
+## O que é
+
+Criação e gestão de rankings. Permite comparar o desempenho dos jogadores utilizando diferentes critérios, como pontos, tempo, ou métricas customizadas. Rankings podem ser individuais, por equipes, por período ou por status.
+
+## Quando usar
+
+- Para criar competição saudável entre jogadores
+- Para dar visibilidade ao desempenho
+- Para motivar através de comparação social
+- Para rankings semanais, mensais ou em tempo real
+
+## Dependências
+
+- **Point** ou **Action**: o critério de ranking deve estar configurado
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir título e descrição
+- [ ] Definir tipo de principal (0 = jogador, 1 = equipe)
+- [ ] Definir operação (tipo de métrica, item, ordenação)
+- [ ] Definir período (semanal, mensal, tempo real)
+- [ ] Vincular técnicas de jogo
+
+## API Endpoints
+
+### Listar Leaderboards
+**Método:** GET
+**Endpoint:** `/v3/leaderboard`
+
+**Exemplo de Resposta:**
+```json
+[
+  {
+    "title": "Top Players",
+    "description": "Players with the most points xp in the week",
+    "principalType": 0,
+    "operation": {
+      "type": 3,
+      "achievement_type": 0,
+      "item": "xp",
+      "filters": [],
+      "sort": -1,
+      "sub": false
+    },
+    "period": {
+      "type": 0,
+      "timeAmount": 1,
+      "timeScale": 6
+    },
+    "techniques": ["GT03"],
+    "_id": "DTjTvZ5"
+  }
+]
+```
+
+### Criar Leaderboard
+**Método:** POST
+**Endpoint:** `/v3/leaderboard`
+(Body igual ao exemplo de resposta acima)
+
+### Deletar Leaderboard
+**Método:** DELETE
+**Endpoint:** `/v3/leaderboard/:id`
+
+### Obter Lista de Líderes
+**Método:** POST
+**Endpoint:** `/v3/leaderboard/:id/leader/aggregate?period=&live=true`
+
+**Exemplo de Resposta:**
+```json
+[
+  {
+    "_id": "tom_D0zCMvq",
+    "total": 30,
+    "position": 1,
+    "move": "up",
+    "player": "tom",
+    "name": "Tom",
+    "boardId": "DTjTvZ5"
+  }
+]
+```
+
+### Resetar Cache
+**Método:** GET
+**Endpoint:** `/v3/leaderboard/reset`
+
+## Validações e Testes
+
+- [ ] Leaderboard aparece na lista GET /v3/leaderboard
+- [ ] Lista de líderes retorna jogadores ordenados
+- [ ] Período está configurado corretamente
+- [ ] Cache pode ser resetado com sucesso