funifier-mcp 0.2.0 → 0.2.3

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

@@ -1,101 +1,101 @@
-# Player (Jogador)
-
-**Acesso Studio:** `/studio/player`
-**API Endpoint:** `/v3/player`
-
-## O que é
-
-Cadastro e gerenciamento dos participantes da gamificação. Permite cadastrar e detalhar cada jogador, incluindo nome, login, email, equipes, amigos, foto, avatar e informações adicionais como telefone, integração com redes sociais e data de aniversário. Também é possível definir senha para cada jogador.
-
-## Quando usar
-
-- Em todo projeto de gamificação (obrigatório)
-- Para cadastrar participantes da gamificação
-- Para associar jogadores a equipes
-- Para armazenar informações extras (departamento, cargo, etc.)
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir o _id do jogador (login)
-- [ ] Definir nome do jogador
-- [ ] Definir email (se necessário para notificações)
-- [ ] Associar a equipes (se aplicável)
-- [ ] Definir campos extras no campo "extra" (departamento, cargo, etc.)
-- [ ] Definir senha (se autenticação for necessária)
-
-## API Endpoints
-
-### Listar Jogadores
-**Método:** GET
-**Endpoint:** `/v3/player`
-**Descrição:** Retorna todos os jogadores cadastrados.
-
-**Exemplo de Resposta:**
-```json
-[
-  {
-    "_id": "jerry",
-    "name": "Jerry",
-    "email": "jerry@yourdomain.com",
-    "extra": { "company": "Tom & Jerry Inc." },
-    "created": 1694990893810,
-    "updated": 1694990893880
-  }
-]
-```
-
-### Criar e Atualizar Jogador
-**Método:** POST
-**Endpoint:** `/v3/player`
-**Descrição:** Cria um novo jogador com atributos personalizados ou atualiza um jogador existente.
-
-**Exemplo de Body:**
-```json
-{
-  "_id": "jerry",
-  "name": "Jerry",
-  "email": "jerry@yourdomain.com",
-  "image": {
-    "small": { "url": "https://my.funifier.com/images/funny.png" },
-    "medium": { "url": "https://my.funifier.com/images/funny.png" },
-    "original": { "url": "https://my.funifier.com/images/funny.png" }
-  },
-  "teams": ["cartoon"],
-  "friends": ["tom", "spike"],
-  "extra": {
-    "country": "USA",
-    "company": "Tom & Jerry Inc."
-  }
-}
-```
-
-### Excluir Jogador
-**Método:** DELETE
-**Endpoint:** `/v3/player/:id`
-**Descrição:** Remove o jogador e todas as suas informações.
-
-### Consultar Status do Jogador
-**Método:** GET
-**Endpoint:** `/v3/player/:id/status`
-**Descrição:** Retorna estatísticas do jogador (pontos, nível, desafios, itens).
-
-**Exemplo de Resposta:**
-```json
-{
-  "name": "Jerry",
-  "total_challenges": 0,
-  "total_points": 0,
-  "level_progress": {
-    "percent_completed": 0,
-    "next_level": { "level": "Apprentice", "minPoints": 10 }
-  },
-  "_id": "jerry"
-}
-```
-
-## Validações e Testes
-
-- [ ] Jogador aparece na lista GET /v3/player
-- [ ] Status do jogador retorna dados corretos via GET /v3/player/:id/status
-- [ ] Campos extras estão acessíveis no objeto "extra"
-- [ ] Equipes do jogador estão corretas no array "teams"
+# Player (Jogador)
+
+**Acesso Studio:** `/studio/player`
+**API Endpoint:** `/v3/player`
+
+## O que é
+
+Cadastro e gerenciamento dos participantes da gamificação. Permite cadastrar e detalhar cada jogador, incluindo nome, login, email, equipes, amigos, foto, avatar e informações adicionais como telefone, integração com redes sociais e data de aniversário. Também é possível definir senha para cada jogador.
+
+## Quando usar
+
+- Em todo projeto de gamificação (obrigatório)
+- Para cadastrar participantes da gamificação
+- Para associar jogadores a equipes
+- Para armazenar informações extras (departamento, cargo, etc.)
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir o _id do jogador (login)
+- [ ] Definir nome do jogador
+- [ ] Definir email (se necessário para notificações)
+- [ ] Associar a equipes (se aplicável)
+- [ ] Definir campos extras no campo "extra" (departamento, cargo, etc.)
+- [ ] Definir senha (se autenticação for necessária)
+
+## API Endpoints
+
+### Listar Jogadores
+**Método:** GET
+**Endpoint:** `/v3/player`
+**Descrição:** Retorna todos os jogadores cadastrados.
+
+**Exemplo de Resposta:**
+```json
+[
+  {
+    "_id": "jerry",
+    "name": "Jerry",
+    "email": "jerry@yourdomain.com",
+    "extra": { "company": "Tom & Jerry Inc." },
+    "created": 1694990893810,
+    "updated": 1694990893880
+  }
+]
+```
+
+### Criar e Atualizar Jogador
+**Método:** POST
+**Endpoint:** `/v3/player`
+**Descrição:** Cria um novo jogador com atributos personalizados ou atualiza um jogador existente.
+
+**Exemplo de Body:**
+```json
+{
+  "_id": "jerry",
+  "name": "Jerry",
+  "email": "jerry@yourdomain.com",
+  "image": {
+    "small": { "url": "https://my.funifier.com/images/funny.png" },
+    "medium": { "url": "https://my.funifier.com/images/funny.png" },
+    "original": { "url": "https://my.funifier.com/images/funny.png" }
+  },
+  "teams": ["cartoon"],
+  "friends": ["tom", "spike"],
+  "extra": {
+    "country": "USA",
+    "company": "Tom & Jerry Inc."
+  }
+}
+```
+
+### Excluir Jogador
+**Método:** DELETE
+**Endpoint:** `/v3/player/:id`
+**Descrição:** Remove o jogador e todas as suas informações.
+
+### Consultar Status do Jogador
+**Método:** GET
+**Endpoint:** `/v3/player/:id/status`
+**Descrição:** Retorna estatísticas do jogador (pontos, nível, desafios, itens).
+
+**Exemplo de Resposta:**
+```json
+{
+  "name": "Jerry",
+  "total_challenges": 0,
+  "total_points": 0,
+  "level_progress": {
+    "percent_completed": 0,
+    "next_level": { "level": "Apprentice", "minPoints": 10 }
+  },
+  "_id": "jerry"
+}
+```
+
+## Validações e Testes
+
+- [ ] Jogador aparece na lista GET /v3/player
+- [ ] Status do jogador retorna dados corretos via GET /v3/player/:id/status
+- [ ] Campos extras estão acessíveis no objeto "extra"
+- [ ] Equipes do jogador estão corretas no array "teams"

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

@@ -1,67 +1,67 @@
-# Point (Ponto)
-
-**Acesso Studio:** `/studio/point`
-**API Endpoint:** `/v3/point`
-
-## O que é
-
-Configuração dos diferentes tipos de pontuação que os jogadores podem conquistar. Permite criar e personalizar unidades de medida de progresso, como XP, moedas virtuais, pontos de conhecimento ou métricas customizadas. Os pontos são fundamentais para recompensar ações, mensurar desempenho e alimentar outros módulos como rankings, lojas virtuais e desafios.
-
-## Quando usar
-
-- Em todo projeto de gamificação (obrigatório)
-- Para criar moedas virtuais de troca (ex: coins)
-- Para criar pontos de experiência (ex: XP)
-- Para criar métricas customizadas (ex: karma, conhecimento)
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir _id do ponto (letras minúsculas, ex: xp, coin, karma)
-- [ ] Definir category (nome amigável, ex: "Experience Points")
-- [ ] Definir shortName (abreviação, ex: "XP")
-- [ ] Configurar antes dos Challenges (Points são dependência)
-
-## API Endpoints
-
-### Listar Pontos
-**Método:** GET
-**Endpoint:** `/v3/point`
-
-**Exemplo de Resposta:**
-```json
-[
-  {
-    "category": "Exchangeable Coins",
-    "shortName": "Coins",
-    "extra": {},
-    "techniques": ["GT75"],
-    "_id": "coin"
-  }
-]
-```
-
-### Criar Ponto
-**Método:** POST
-**Endpoint:** `/v3/point`
-
-**Exemplo de Body:**
-```json
-{
-  "_id": "xp",
-  "category": "Experience Points",
-  "shortName": "XP",
-  "extra": {},
-  "techniques": ["GT01"]
-}
-```
-
-### Excluir Ponto
-**Método:** DELETE
-**Endpoint:** `/v3/point/:id`
-
-## Validações e Testes
-
-- [ ] Ponto aparece na lista GET /v3/point
-- [ ] _id é único e sem caracteres especiais
-- [ ] shortName está curto e representativo
-- [ ] Ponto é criado ANTES de challenges que o referenciam
+# Point (Ponto)
+
+**Acesso Studio:** `/studio/point`
+**API Endpoint:** `/v3/point`
+
+## O que é
+
+Configuração dos diferentes tipos de pontuação que os jogadores podem conquistar. Permite criar e personalizar unidades de medida de progresso, como XP, moedas virtuais, pontos de conhecimento ou métricas customizadas. Os pontos são fundamentais para recompensar ações, mensurar desempenho e alimentar outros módulos como rankings, lojas virtuais e desafios.
+
+## Quando usar
+
+- Em todo projeto de gamificação (obrigatório)
+- Para criar moedas virtuais de troca (ex: coins)
+- Para criar pontos de experiência (ex: XP)
+- Para criar métricas customizadas (ex: karma, conhecimento)
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir _id do ponto (letras minúsculas, ex: xp, coin, karma)
+- [ ] Definir category (nome amigável, ex: "Experience Points")
+- [ ] Definir shortName (abreviação, ex: "XP")
+- [ ] Configurar antes dos Challenges (Points são dependência)
+
+## API Endpoints
+
+### Listar Pontos
+**Método:** GET
+**Endpoint:** `/v3/point`
+
+**Exemplo de Resposta:**
+```json
+[
+  {
+    "category": "Exchangeable Coins",
+    "shortName": "Coins",
+    "extra": {},
+    "techniques": ["GT75"],
+    "_id": "coin"
+  }
+]
+```
+
+### Criar Ponto
+**Método:** POST
+**Endpoint:** `/v3/point`
+
+**Exemplo de Body:**
+```json
+{
+  "_id": "xp",
+  "category": "Experience Points",
+  "shortName": "XP",
+  "extra": {},
+  "techniques": ["GT01"]
+}
+```
+
+### Excluir Ponto
+**Método:** DELETE
+**Endpoint:** `/v3/point/:id`
+
+## Validações e Testes
+
+- [ ] Ponto aparece na lista GET /v3/point
+- [ ] _id é único e sem caracteres especiais
+- [ ] shortName está curto e representativo
+- [ ] Ponto é criado ANTES de challenges que o referenciam