funifier-mcp 0.2.0 → 0.2.4

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

@@ -1,42 +1,42 @@
-# Story (História)
-
-**Acesso Studio:** `/studio/story`
-**API Endpoint:** `/v3/story`
-
-## O que é
-
-Criação de histórias interativas com múltiplos caminhos e finais. Permite criar narrativas gamificadas nas quais o jogador faz escolhas que afetam o desenrolar da trama. Cenários, personagens, imagens e vídeos podem ser utilizados para enriquecer a experiência.
-
-## Quando usar
-
-- Para treinamentos baseados em storytelling
-- Para campanhas de marketing com desfechos alternativos
-- Para jogos educacionais interativos
-- Para experiências de role-playing
-
-## Checklist de Configuração no Studio
-
-- [ ] Definir título e descrição da história
-- [ ] Criar cenários/cenas com textos e mídias
-- [ ] Definir ramificações e escolhas
-- [ ] Configurar finais alternativos
-
-## API Endpoints
-
-### Listar Stories
-**Método:** GET
-**Endpoint:** `/v3/story`
-
-### Criar Story
-**Método:** POST
-**Endpoint:** `/v3/story`
-
-### Deletar Story
-**Método:** DELETE
-**Endpoint:** `/v3/story/:id`
-
-## Validações e Testes
-
-- [ ] História aparece na lista
-- [ ] Navegação entre cenários funciona
-- [ ] Escolhas do jogador são registradas
+# Story (História)
+
+**Acesso Studio:** `/studio/story`
+**API Endpoint:** `/v3/story`
+
+## O que é
+
+Criação de histórias interativas com múltiplos caminhos e finais. Permite criar narrativas gamificadas nas quais o jogador faz escolhas que afetam o desenrolar da trama. Cenários, personagens, imagens e vídeos podem ser utilizados para enriquecer a experiência.
+
+## Quando usar
+
+- Para treinamentos baseados em storytelling
+- Para campanhas de marketing com desfechos alternativos
+- Para jogos educacionais interativos
+- Para experiências de role-playing
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir título e descrição da história
+- [ ] Criar cenários/cenas com textos e mídias
+- [ ] Definir ramificações e escolhas
+- [ ] Configurar finais alternativos
+
+## API Endpoints
+
+### Listar Stories
+**Método:** GET
+**Endpoint:** `/v3/story`
+
+### Criar Story
+**Método:** POST
+**Endpoint:** `/v3/story`
+
+### Deletar Story
+**Método:** DELETE
+**Endpoint:** `/v3/story/:id`
+
+## Validações e Testes
+
+- [ ] História aparece na lista
+- [ ] Navegação entre cenários funciona
+- [ ] Escolhas do jogador são registradas

package/datasource-funifier-docs/knowledge/modules/studio-page.md

@@ -1,180 +1,180 @@
-# Studio Page (Página Customizada do Studio)
-
-**Acesso Studio:** `/studio/page`
-
-## O que é
-
-Páginas customizadas dentro do Funifier Studio para atender necessidades específicas dos administradores. Permitem criar dashboards, CRUDs, gráficos, relatórios — tudo com AngularJS + Bootstrap.
-
-## Configuração
-
-Cada página é um JSON com:
-- `_id` — Identificador único (auto-gerado se omitido)
-- `display` — `true` para aparecer no menu do Studio, `false` para páginas internas
-- `title` — Nome exibido no menu
-- `slug` — Caminho relativo (ex: `studio/custom/hello`). Suporta parâmetros: `studio/custom/car/form/:id`
-- `html` — Código HTML (usa Bootstrap CSS)
-- `script` — Código JavaScript (roda no contexto AngularJS)
-
-## Contexto JavaScript
-
-Dentro do `script`, você tem acesso a:
-- `$scope` — Scope do AngularJS
-- `$http` — Para requisições HTTP
-- `$location` — Para navegação entre páginas (`$location.path("/studio/custom/...")`)
-- `$routeParams` — Para ler parâmetros do slug (ex: `$routeParams.id`)
-- `Marketplace` — Objeto utilitário (ver abaixo)
-
-### Marketplace API
-
-| Método | Descrição | Exemplo de retorno |
-|--------|-----------|-------------------|
-| `Marketplace.auth.getService()` | URL da API Funifier | `https://service2.funifier.com` |
-| `Marketplace.auth.getAuthorization()` | Token de acesso do usuário logado no Studio | Bearer token |
-| `Marketplace.range.parse(content_range)` | Analisa header `content-range` para paginação | `{page, pages, count, ...}` |
-| `Marketplace.range.paginate(page, content_range)` | Gera header `Range` para ir a uma página | `items=0-100` |
-
-## Diretivas Disponíveis
-
-- `<image-picker>` — Seletor de imagem (URL, local, galeria). Atributos: `on-change`, `show-picker-url`, `show-picker-local`, `show-picker-gallery`, `upload-max-size`, `transform`
-- `<principal-picker>` — Seletor de jogadores/equipes. Atributos: `title`, `model`, `show-picker-player`, `black-list`, `max`
-- `<input-extra>` — Campos extras dinâmicos. Atributos: `title`, `show-inline`, `model`
-
-## Bibliotecas Disponíveis
-
-- **Highcharts** — Gráficos (pizza, barra, linhas, etc.)
-- **Bootstrap** — CSS framework (classes `btn`, `table`, `form-control`, etc.)
-- **Glyphicons** — Ícones via `glyphicon glyphicon-*`
-- Traduções: `{{'SAVE'|translate}}`, `{{'CANCEL'|translate}}`, `{{'BACK'|translate}}`, `{{'NEW'|translate}}`, `{{'SEARCH_FOR'|translate}}`
-
-## Exemplos
-
-### 1. Hello World
-```json
-{
-    "_id": "hello1",
-    "display": true,
-    "title": "Hello World!",
-    "slug": "studio/custom/hello",
-    "html": "<button ng-click=\"hello()\" class=\"btn btn-warning\">Hello</button>",
-    "script": "$scope.hello = function(){ alert('Hello World!'); }"
-}
-```
-
-### 2. Lista Simples (Desafios)
-```javascript
-/* "display": true, "title": "Quest List", "slug": "studio/custom/challenge" */
-$scope.all = [];
-$scope.list = function () {
-  $http({method: 'GET', url:Marketplace.auth.getService() + '/v3/database/challenge',
-         headers: {"Authorization": Marketplace.auth.getAuthorization(), "content-type": "application/json"}
-  }).then(function(data){
-    $scope.all = data.data;
-  });
-};
-$scope.list();
-```
-
-### 3. Lista Paginada (Players)
-```javascript
-/* "display": true, "title": "Player List", "slug": "studio/custom/player" */
-$scope.range = { request: "items=0-100" };
-$scope.gotopage = function(page){
-  $scope.range.request = Marketplace.range.paginate(page, $scope.range.response);
-  $scope.list();
-};
-$scope.paginate = function (total) {
-  var to = $scope.range.page + total;
-  $scope.range.request = Marketplace.range.paginate(to, $scope.range.response);
-  $scope.list();
-};
-$scope.all = [];
-$scope.list = function () {
-  $http({method: 'GET', url:Marketplace.auth.getService() + '/v3/database/player',
-    headers: {"Authorization": Marketplace.auth.getAuthorization(), "Range": $scope.range.request, "content-type": "application/json"}
-  }).then(function(data){
-    $scope.all = data.data;
-    $scope.range = Marketplace.range.parse(data.headers(["content-range"]));
-  });
-};
-$scope.list();
-```
-HTML de paginação:
-```html
-<div>
-  Page <input type="number" ng-model="range.page" ng-change="gotopage(range.page)" style="width:40px;" /> of {{range.pages}}
-  <button ng-click="paginate(-1)" class="btn btn-default"><span class="glyphicon glyphicon-chevron-left"></span></button>
-  <button ng-click="paginate(+1)" class="btn btn-default"><span class="glyphicon glyphicon-chevron-right"></span></button>
-</div>
-```
-
-### 4. CRUD Completo (Carros)
-**Lista** (`display: true`, slug: `studio/custom/car/list`): Lista + busca + paginação + botões editar/excluir + botão "NEW"
-- DELETE: `$http({method: 'DELETE', url: API + "/v3/database/car__c?q=_id:'" + id + "'", ...})`
-- Navegação: `$location.path("/studio/custom/car/form/" + id)` ou `"/studio/custom/car/form/new"`
-
-**Formulário** (`display: false`, slug: `studio/custom/car/form/:id`):
-- Carrega via GET: `/v3/database/car__c?strict=true&q=_id:'ID'`
-- Salva via PUT: `/v3/database/car__c`
-- Usa `$routeParams.id` para saber se é edição ou criação (`"new"` = novo)
-- `<image-picker on-change="setImage" ...>` para upload de imagem
-
-### 5. Gráfico Highcharts (Active Players)
-```javascript
-/* "display": true, "title": "Daily Active Players", "slug": "studio/custom/kpi/players" */
-$scope.load = function () {
-    $http({
-        method: 'POST', url: Marketplace.auth.getService() + '/v3/database/action_log/aggregate',
-        headers: { Authorization: Marketplace.auth.getAuthorization(), 'content-type': 'application/json'},
-        data: [
-            {"$match": { "time": { "$gte": { "$date": "-1y" } } } },
-            {"$addFields": { "day": { "$dayOfYear": "$time" } } },
-            {"$group": { "_id": { "player": "$userId", "day": "$day" }, "time": { "$max": "$time" }}},
-            {"$group": { "_id": "$_id.day", "total_users": { "$sum": 1 }, "time": { "$max": "$time" }}},
-            {"$project": { "_id": 0, "day_of_year": '$_id', "total": '$total_users', "time": 1}},
-            {"$sort": { "day_of_year": 1 } }
-        ]
-    }).then(function (data) {
-        var transformedData = data.data.map(function (d) { return [d.time, d.total]; });
-        new Highcharts.Chart({
-            chart: { renderTo: 'chart', type: 'line' },
-            title: { text: 'Daily Active Players' },
-            xAxis: { type: 'datetime' },
-            yAxis: { title: { text: 'Total' } },
-            series: [{ name: 'Total over time', data: transformedData }],
-            credits: { enabled: false }
-        });
-    });
-};
-$scope.load();
-```
-
-## API REST para Gerenciar Páginas
-
-**IMPORTANTE:** As páginas customizadas ficam na collection `studio_page` (NÃO `page`).
-
-```bash
-# Criar/atualizar página
-curl -X PUT "https://service2.funifier.com/v3/database/studio_page" \
-  -H "Authorization: Bearer TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{"_id":"minha_pagina", "display":true, "title":"Minha Página", "slug":"studio/custom/minha-pagina", "html":"<h1>Oi</h1>", "script":"/* js */"}'
-
-# Listar páginas
-curl "https://service2.funifier.com/v3/database/studio_page" \
-  -H "Authorization: Bearer TOKEN"
-
-# Deletar página
-curl -X DELETE "https://service2.funifier.com/v3/database/studio_page?q=_id:'ID'" \
-  -H "Authorization: Bearer TOKEN"
-```
-
-## Checklist
-
-- [ ] Definir `_id`, `title`, `slug`, `display`
-- [ ] Escrever `html` com Bootstrap
-- [ ] Escrever `script` com AngularJS
-- [ ] Usar `Marketplace.auth.*` para autenticação
-- [ ] Usar `?strict=true` em GETs para preservar tipos BSON
-- [ ] Testar no Studio (navegar até a URL do slug)
-- [ ] Para CRUDs: criar página de lista (display:true) + formulário (display:false)
+# Studio Page (Página Customizada do Studio)
+
+**Acesso Studio:** `/studio/page`
+
+## O que é
+
+Páginas customizadas dentro do Funifier Studio para atender necessidades específicas dos administradores. Permitem criar dashboards, CRUDs, gráficos, relatórios — tudo com AngularJS + Bootstrap.
+
+## Configuração
+
+Cada página é um JSON com:
+- `_id` — Identificador único (auto-gerado se omitido)
+- `display` — `true` para aparecer no menu do Studio, `false` para páginas internas
+- `title` — Nome exibido no menu
+- `slug` — Caminho relativo (ex: `studio/custom/hello`). Suporta parâmetros: `studio/custom/car/form/:id`
+- `html` — Código HTML (usa Bootstrap CSS)
+- `script` — Código JavaScript (roda no contexto AngularJS)
+
+## Contexto JavaScript
+
+Dentro do `script`, você tem acesso a:
+- `$scope` — Scope do AngularJS
+- `$http` — Para requisições HTTP
+- `$location` — Para navegação entre páginas (`$location.path("/studio/custom/...")`)
+- `$routeParams` — Para ler parâmetros do slug (ex: `$routeParams.id`)
+- `Marketplace` — Objeto utilitário (ver abaixo)
+
+### Marketplace API
+
+| Método | Descrição | Exemplo de retorno |
+|--------|-----------|-------------------|
+| `Marketplace.auth.getService()` | URL da API Funifier | `https://service2.funifier.com` |
+| `Marketplace.auth.getAuthorization()` | Token de acesso do usuário logado no Studio | Bearer token |
+| `Marketplace.range.parse(content_range)` | Analisa header `content-range` para paginação | `{page, pages, count, ...}` |
+| `Marketplace.range.paginate(page, content_range)` | Gera header `Range` para ir a uma página | `items=0-100` |
+
+## Diretivas Disponíveis
+
+- `<image-picker>` — Seletor de imagem (URL, local, galeria). Atributos: `on-change`, `show-picker-url`, `show-picker-local`, `show-picker-gallery`, `upload-max-size`, `transform`
+- `<principal-picker>` — Seletor de jogadores/equipes. Atributos: `title`, `model`, `show-picker-player`, `black-list`, `max`
+- `<input-extra>` — Campos extras dinâmicos. Atributos: `title`, `show-inline`, `model`
+
+## Bibliotecas Disponíveis
+
+- **Highcharts** — Gráficos (pizza, barra, linhas, etc.)
+- **Bootstrap** — CSS framework (classes `btn`, `table`, `form-control`, etc.)
+- **Glyphicons** — Ícones via `glyphicon glyphicon-*`
+- Traduções: `{{'SAVE'|translate}}`, `{{'CANCEL'|translate}}`, `{{'BACK'|translate}}`, `{{'NEW'|translate}}`, `{{'SEARCH_FOR'|translate}}`
+
+## Exemplos
+
+### 1. Hello World
+```json
+{
+    "_id": "hello1",
+    "display": true,
+    "title": "Hello World!",
+    "slug": "studio/custom/hello",
+    "html": "<button ng-click=\"hello()\" class=\"btn btn-warning\">Hello</button>",
+    "script": "$scope.hello = function(){ alert('Hello World!'); }"
+}
+```
+
+### 2. Lista Simples (Desafios)
+```javascript
+/* "display": true, "title": "Quest List", "slug": "studio/custom/challenge" */
+$scope.all = [];
+$scope.list = function () {
+  $http({method: 'GET', url:Marketplace.auth.getService() + '/v3/database/challenge',
+         headers: {"Authorization": Marketplace.auth.getAuthorization(), "content-type": "application/json"}
+  }).then(function(data){
+    $scope.all = data.data;
+  });
+};
+$scope.list();
+```
+
+### 3. Lista Paginada (Players)
+```javascript
+/* "display": true, "title": "Player List", "slug": "studio/custom/player" */
+$scope.range = { request: "items=0-100" };
+$scope.gotopage = function(page){
+  $scope.range.request = Marketplace.range.paginate(page, $scope.range.response);
+  $scope.list();
+};
+$scope.paginate = function (total) {
+  var to = $scope.range.page + total;
+  $scope.range.request = Marketplace.range.paginate(to, $scope.range.response);
+  $scope.list();
+};
+$scope.all = [];
+$scope.list = function () {
+  $http({method: 'GET', url:Marketplace.auth.getService() + '/v3/database/player',
+    headers: {"Authorization": Marketplace.auth.getAuthorization(), "Range": $scope.range.request, "content-type": "application/json"}
+  }).then(function(data){
+    $scope.all = data.data;
+    $scope.range = Marketplace.range.parse(data.headers(["content-range"]));
+  });
+};
+$scope.list();
+```
+HTML de paginação:
+```html
+<div>
+  Page <input type="number" ng-model="range.page" ng-change="gotopage(range.page)" style="width:40px;" /> of {{range.pages}}
+  <button ng-click="paginate(-1)" class="btn btn-default"><span class="glyphicon glyphicon-chevron-left"></span></button>
+  <button ng-click="paginate(+1)" class="btn btn-default"><span class="glyphicon glyphicon-chevron-right"></span></button>
+</div>
+```
+
+### 4. CRUD Completo (Carros)
+**Lista** (`display: true`, slug: `studio/custom/car/list`): Lista + busca + paginação + botões editar/excluir + botão "NEW"
+- DELETE: `$http({method: 'DELETE', url: API + "/v3/database/car__c?q=_id:'" + id + "'", ...})`
+- Navegação: `$location.path("/studio/custom/car/form/" + id)` ou `"/studio/custom/car/form/new"`
+
+**Formulário** (`display: false`, slug: `studio/custom/car/form/:id`):
+- Carrega via GET: `/v3/database/car__c?strict=true&q=_id:'ID'`
+- Salva via PUT: `/v3/database/car__c`
+- Usa `$routeParams.id` para saber se é edição ou criação (`"new"` = novo)
+- `<image-picker on-change="setImage" ...>` para upload de imagem
+
+### 5. Gráfico Highcharts (Active Players)
+```javascript
+/* "display": true, "title": "Daily Active Players", "slug": "studio/custom/kpi/players" */
+$scope.load = function () {
+    $http({
+        method: 'POST', url: Marketplace.auth.getService() + '/v3/database/action_log/aggregate',
+        headers: { Authorization: Marketplace.auth.getAuthorization(), 'content-type': 'application/json'},
+        data: [
+            {"$match": { "time": { "$gte": { "$date": "-1y" } } } },
+            {"$addFields": { "day": { "$dayOfYear": "$time" } } },
+            {"$group": { "_id": { "player": "$userId", "day": "$day" }, "time": { "$max": "$time" }}},
+            {"$group": { "_id": "$_id.day", "total_users": { "$sum": 1 }, "time": { "$max": "$time" }}},
+            {"$project": { "_id": 0, "day_of_year": '$_id', "total": '$total_users', "time": 1}},
+            {"$sort": { "day_of_year": 1 } }
+        ]
+    }).then(function (data) {
+        var transformedData = data.data.map(function (d) { return [d.time, d.total]; });
+        new Highcharts.Chart({
+            chart: { renderTo: 'chart', type: 'line' },
+            title: { text: 'Daily Active Players' },
+            xAxis: { type: 'datetime' },
+            yAxis: { title: { text: 'Total' } },
+            series: [{ name: 'Total over time', data: transformedData }],
+            credits: { enabled: false }
+        });
+    });
+};
+$scope.load();
+```
+
+## API REST para Gerenciar Páginas
+
+**IMPORTANTE:** As páginas customizadas ficam na collection `studio_page` (NÃO `page`).
+
+```bash
+# Criar/atualizar página
+curl -X PUT "https://service2.funifier.com/v3/database/studio_page" \
+  -H "Authorization: Bearer TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"_id":"minha_pagina", "display":true, "title":"Minha Página", "slug":"studio/custom/minha-pagina", "html":"<h1>Oi</h1>", "script":"/* js */"}'
+
+# Listar páginas
+curl "https://service2.funifier.com/v3/database/studio_page" \
+  -H "Authorization: Bearer TOKEN"
+
+# Deletar página
+curl -X DELETE "https://service2.funifier.com/v3/database/studio_page?q=_id:'ID'" \
+  -H "Authorization: Bearer TOKEN"
+```
+
+## Checklist
+
+- [ ] Definir `_id`, `title`, `slug`, `display`
+- [ ] Escrever `html` com Bootstrap
+- [ ] Escrever `script` com AngularJS
+- [ ] Usar `Marketplace.auth.*` para autenticação
+- [ ] Usar `?strict=true` em GETs para preservar tipos BSON
+- [ ] Testar no Studio (navegar até a URL do slug)
+- [ ] Para CRUDs: criar página de lista (display:true) + formulário (display:false)