funifier-mcp 0.1.0 → 0.2.0

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

@@ -0,0 +1,163 @@
+# Quiz (Quiz)
+
+**Acesso Studio:** `/studio/quiz`
+**API Endpoint:** `/v3/quiz`
+
+## O que é
+
+Agrupamento de perguntas em formato de prova ou simulado. Permite criar provas compostas por perguntas, definir nota total, controlar tentativas e embaralhar questões para cada jogador. Os quizzes podem ser apresentados como mini games.
+
+## Quando usar
+
+- Para criar provas e avaliações
+- Para simulados com nota
+- Para treinamentos com pontuação
+- Para concursos de conhecimento
+
+## Dependências
+
+- **Question**: perguntas devem ser criadas para compor o quiz
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir título e descrição do quiz
+- [ ] Definir nota total (grade)
+- [ ] Criar perguntas associadas ao quiz
+- [ ] Configurar embaralhamento (shuffle)
+- [ ] Definir se mostra nota antes de finalizar (showGradeBeforeFinish)
+- [ ] Configurar numeração das questões (questionNumbering)
+
+## API Endpoints
+
+### Listar Quizzes
+**Método:** GET
+**Endpoint:** `/v3/database/quiz`
+
+### Criar Quiz
+**Método:** POST
+**Endpoint:** `/v3/quiz`
+
+**Exemplo de Body:**
+```json
+{
+  "_id": "650c82fe832",
+  "title": "Funifier Exam",
+  "description": "Test your knowledge about the best gamification platform in the world.",
+  "grade": 10,
+  "i18n": {},
+  "extra": {},
+  "feedbacks": [],
+  "questionNumbering": "uppercase_letters",
+  "showGradeBeforeFinish": false,
+  "shuffle": false
+}
+```
+
+### Deletar Quiz
+**Método:** DELETE
+**Endpoint:** `/v3/quiz/:id`
+
+### Listar Perguntas de um Quiz
+**Método:** GET
+**Endpoint:** `/v3/quiz/:id/question`
+
+### Criar Pergunta para um Quiz
+**Método:** POST
+**Endpoint:** `/v3/question`
+
+**Exemplo de Body:**
+```json
+{
+  "quiz": "650c82fe832",
+  "type": "MULTIPLE_CHOICE",
+  "title": "Best Platform",
+  "question": "What is the best gamification platform?",
+  "grade": 1,
+  "choices": [
+    { "answer": "1", "label": "Funifier", "grade": 1, "extra": {}, "gradePercent": 100, "gradeCheck": true },
+    { "answer": "2", "label": "Points", "grade": 0, "extra": {}, "gradePercent": 0 },
+    { "answer": "3", "label": "Badges", "grade": 0, "extra": {}, "gradePercent": 0 },
+    { "answer": "4", "label": "Leaderboards", "grade": 0, "extra": {}, "gradePercent": 0 }
+  ],
+  "i18n": {},
+  "select": "one_answer",
+  "shuffle": false
+}
+```
+
+### Iniciar Quiz
+**Método:** POST
+**Endpoint:** `/v3/quiz/start`
+
+**Exemplo de Body:**
+```json
+{
+  "quiz": "650c82fe832",
+  "player": "tom"
+}
+```
+
+### Registrar Respostas em Lote
+**Método:** POST
+**Endpoint:** `/v3/question/log/bulk`
+
+**Exemplo de Body:**
+```json
+[
+  {
+    "quiz": "650c82fe832",
+    "quiz_log": "650dc6168325771ffaa94098",
+    "question": "650dc4d98325771ffaa93e5e",
+    "answer": ["1"],
+    "player": "tom"
+  }
+]
+```
+
+### Finalizar Quiz
+**Método:** POST
+**Endpoint:** `/v3/quiz/finish`
+
+**Exemplo de Body:**
+```json
+{
+  "quiz_log": "650dc6168325771ffaa94098"
+}
+```
+
+## Fluxo Completo do Quiz
+
+```
+1. Admin cria Quiz (POST /v3/quiz)
+2. Admin cria Questions vinculadas ao Quiz (POST /v3/question com "quiz": "quiz_id")
+3. Jogador inicia Quiz (POST /v3/quiz/start → retorna quiz_log_id)
+4. Jogador responde questões (POST /v3/question/log/bulk com quiz_log_id)
+5. Jogador finaliza Quiz (POST /v3/quiz/finish → calcula nota)
+```
+
+## Campos Importantes
+
+| Campo | Tipo | Descrição |
+|-------|------|-----------|
+| `grade` | Number | Nota total do quiz (ex: 10) |
+| `shuffle` | Boolean | Embaralhar ordem das perguntas |
+| `showGradeBeforeFinish` | Boolean | Mostrar nota parcial antes de finalizar |
+| `questionNumbering` | String | Formato numeração (`uppercase_letters`, `numbers`, etc.) |
+| `feedbacks` | Array | Mensagens de feedback por faixa de nota |
+
+## Apresentação como Mini Game
+
+Quizzes podem ser apresentados em formatos de mini games:
+- Corrida espacial
+- Quiz tradicional com timer
+- Formato personalizado via widget/frontend
+
+## Validações e Testes
+
+- [ ] Quiz aparece na lista GET /v3/database/quiz
+- [ ] Perguntas estão associadas ao quiz
+- [ ] Jogador consegue iniciar quiz (POST /v3/quiz/start)
+- [ ] Respostas são registradas corretamente (POST /v3/question/log/bulk)
+- [ ] Ao finalizar, nota é calculada (POST /v3/quiz/finish)
+- [ ] Embaralhamento funciona (se ativado)
+- [ ] Feedbacks aparecem conforme faixa de nota

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

@@ -0,0 +1,58 @@
+# Scheduler (Scheduler)
+
+**Acesso Studio:** `/studio/scheduler`
+**API Endpoint:** `/v3/scheduler`
+
+## O que é
+
+Execução de códigos JAVA em datas e horários agendados (expressões CRON). Permite agendar tarefas e automações para rodar em horários ou intervalos pré-definidos.
+
+## Quando usar
+
+- Para gerar relatórios automatizados (ex: toda sexta às 10h)
+- Para debitar pontos de jogadores inativos
+- Para enviar lembretes automáticos de metas
+- Para campanhas temporais com início/fim automático
+
+## Script Runtime Environment (Wrapper Class)
+
+O script do scheduler **não é standalone** — ele é inserido dentro de uma classe Java wrapper gerada pelo Funifier, idêntica à do Public Endpoint (ver `public.md` para a lista completa de imports).
+
+### Regras
+
+1. **NÃO use `import`** — todos os imports já estão no wrapper (Unirest, Groovy JSON, Funifier entities/utils, Apache HTTP, Simple Java Mail, etc.)
+2. Se precisar de uma classe não importada, use o nome completo: `com.example.MinhaClasse`
+3. **`manager`** (ManagerFactory) está disponível como campo da classe
+4. **Método principal:** `void execute()` (sem parâmetros)
+5. **Timeout padrão de 10 segundos** — pode ser customizado via campo `timeout` (em **segundos**) na API: `POST /v3/scheduler` com `{"_id": "scheduler_id", "timeout": 30}`. Este campo não aparece no Studio.
+6. Scripts rodam em **Groovy** — cuidado com `$` em GStrings
+7. Use apenas **ASCII em comentários**
+
+> 📖 Ver `public.md` → **Script Runtime Environment** para a lista completa de imports e bibliotecas disponíveis.
+
+## Checklist de Configuração no Studio
+
+- [ ] Definir nome e descrição do scheduler
+- [ ] Definir expressão CRON
+- [ ] Escrever script Java
+- [ ] Testar em ambiente de homologação
+
+## API Endpoints
+
+### Listar Schedulers
+**Método:** GET
+**Endpoint:** `/v3/scheduler`
+
+### Criar Scheduler
+**Método:** POST
+**Endpoint:** `/v3/scheduler`
+
+### Deletar Scheduler
+**Método:** DELETE
+**Endpoint:** `/v3/scheduler/:id`
+
+## Validações e Testes
+
+- [ ] Scheduler aparece na lista
+- [ ] Expressão CRON é válida
+- [ ] Script executa no horário configurado

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

@@ -0,0 +1,169 @@
+# Security (Segurança)
+
+**Acesso Studio:** Gamification Settings → "Mais" → Security → "Change your gamification security settings"
+**Armazenamento:** Coleção `security`, documento com `_id` = API Key da gamificação
+
+## Estrutura do Documento
+
+```json
+{
+  "_id": "API_KEY_DA_GAMIFICACAO",
+  "roles": [
+    { "name": "public", "scope": "read_all", "timeout": "" },
+    { "name": "player", "scope": "read_all, write_all, delete_all, database", "timeout": "" }
+  ],
+  "apps": [
+    { "name": "Nome do App", "app_secret": "GUID_GERADO", "scope": "read_all, write_all, delete_all, database" }
+  ]
+}
+```
+
+## Roles
+
+Definem o nível de acesso dos tokens Bearer (jogadores logados) e Basic (acesso público).
+
+### Campos
+- `name` — Identificador da role (ex: `public`, `player`, `admin`)
+- `scope` — Permissões separadas por vírgula
+- `timeout` — Tempo de expiração do token (ex: `7d`, `1h`). **⚠️ NÃO usar string vazia `""`** — causa NPE no auth. Omitir o campo ou usar `null` para timeout padrão (7 dias).
+
+### Scopes Disponíveis
+| Scope | Descrição |
+|-------|-----------|
+| `read_all` | Leitura em todas as coleções |
+| `write_all` | Escrita em todas as coleções |
+| `delete_all` | Exclusão em todas as coleções |
+| `database` | **Obrigatório** para acessar `/v3/database`. Sem ele, POST retorna 201 mas não persiste |
+
+### Roles Comuns
+- **`public`** — `read_all, write_database_signup__c` — Para acesso não autenticado (signup, landing page). Usa token Basic. Precisa de `write_database_signup__c` para o signup pattern funcionar.
+- **`player`** — `read_all, write_all, delete_all, database` — Para usuários logados. Usa token Bearer.
+
+### ⚠️ Lição Crítica
+A palavra **`database`** deve estar literalmente no scope para que `/v3/database` funcione. Mesmo com `write_all` e `read_all`, sem `database` as operações falham silenciosamente.
+
+## Apps
+
+Apps geram tokens Basic não-expirantes para uso em triggers, endpoints públicos e integrações server-side.
+
+### Campos
+- `name` — Nome descritivo do app
+- `app_secret` — GUID gerado pelo Funifier (via `/v3/util/guid/new`)
+- `scope` — Permissões (mesmo formato das roles)
+
+### Token Basic do App
+```
+Basic base64(API_KEY + ":" + APP_SECRET)
+```
+
+Exemplo:
+```javascript
+var basicToken = 'Basic ' + btoa('69ab1a9a607db81962b92cd2:69ab3566607db81962b9686e');
+```
+
+## Como Criar via API (sem Studio UI)
+
+### 1. Obter token de autenticação do Studio
+O Studio armazena o token em `localStorage` com a chave `marketplace_authorization`:
+```javascript
+var auth = localStorage.getItem('marketplace_authorization');
+// Retorna: "Bearer eyJ..."
+```
+
+### 2. Gerar GUID para App Secret
+```
+GET https://service2.funifier.com/v3/util/guid/new
+Authorization: Bearer <studio_token>
+```
+Retorna: `{ "guid": "69ab3566607db81962b9686e" }`
+
+### 3. Criar/Atualizar Security Document
+```
+PUT https://service2.funifier.com/v3/database/security
+Authorization: Bearer <studio_token>
+Content-Type: application/json
+
+{
+  "_id": "API_KEY",
+  "roles": [...],
+  "apps": [...]
+}
+```
+
+**⚠️ PUT é upsert** — substitui o documento inteiro. Sempre incluir roles E apps existentes.
+
+### 4. Verificar
+```
+GET https://service2.funifier.com/v3/database/security/API_KEY?strict=true
+Authorization: Bearer <studio_token>
+```
+
+## Navegação no Studio (Browser Automation)
+
+1. Abrir `https://my.funifier.com`
+2. Selecionar a gamificação desejada (botão "Select")
+3. Se gamificação nova, clicar "Começar do Zero" para inicializar
+4. Clicar no nome da gamificação na sidebar (link para `/studio/gamification/me`)
+5. Expandir seção "Mais"
+6. Clicar "Change your gamification security settings"
+7. Na página Security: botão "Apps" expande a seção de Apps, botão "Roles" expande Roles
+
+**⚠️ SPA Redirect:** Se a gamificação não foi inicializada (wizard "Escolha o melhor caminho"), qualquer navegação para `/studio/security` redireciona para o wizard. Primeiro clicar "Começar do Zero".
+
+## Token Basic da Gamificação (público)
+Para acesso público sem App (signup, leitura):
+```
+Basic base64(API_KEY + ":")
+```
+Nota: dois-pontos no final, sem app_secret. Usa a role `public` se existir.
+
+## Auth Token (`/v3/auth/token`)
+
+### Request (JSON body)
+```json
+{
+  "grant_type": "password",
+  "apiKey": "API_KEY",
+  "username": "player_email",
+  "password": "plain_text_password"
+}
+```
+
+**⚠️ Campos obrigatórios:**
+- `grant_type` — DEVE ser `"password"` (sem isso, retorna `invalid_grant`)
+- `username` — NÃO `login` (campo frontend pode usar `login` mas API espera `username`)
+- A senha do Player no banco DEVE ser BCrypt hash (`$2a$...`). Senha em texto plano causa `"Invalid salt version"`
+
+### Response
+```json
+{
+  "access_token": "eyJ...",
+  "token_type": "Bearer",
+  "expires_in": "1772..."
+}
+```
+
+### Campos da Security que afetam auth
+| Campo | Tipo | Descrição |
+|-------|------|-----------|
+| `requirePassword` | boolean | Se `true`, valida senha BCrypt. **NÃO** é `passwordRequired` |
+| `createPlayerIfDontExist` | boolean | Se `true`, cria player automaticamente no login. **NÃO** é `autoCreatePlayer` |
+
+### ⚠️ Role timeout NUNCA string vazia
+```json
+// ❌ ERRADO — causa NPE no auth (DateUtil.fromKeyword("+") falha)
+{ "name": "player", "scope": "...", "timeout": "" }
+
+// ✅ CORRETO — omitir campo para timeout padrão (7 dias)
+{ "name": "player", "scope": "..." }
+
+// ✅ CORRETO — valor explícito
+{ "name": "player", "scope": "...", "timeout": "7d" }
+```
+
+## Validações e Testes
+- [ ] Role `public` criada com scope `read_all`
+- [ ] Role `player` criada com scope incluindo `database`
+- [ ] App criada com secret gerado
+- [ ] Token Basic do App acessa `/v3/database/collections`
+- [ ] Token Basic público (sem app) acessa endpoints de leitura

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

@@ -0,0 +1,28 @@
+# Staging (Staging)
+
+**Acesso Studio:** `/studio/integration/staging`
+
+## O que é
+
+Gerenciamento de ambientes de homologação e produção, com clonagem e migração de dados. Permite criar e gerenciar ambientes de homologação (staging) separados do ambiente de produção. Possibilita clonar o ambiente produtivo para testes e migrar dados entre servidores.
+
+## Quando usar
+
+- Para testar novas funcionalidades sem impactar produção
+- Para validar atualizações antes do go-live
+- Para migrar dados entre servidores de diferentes regiões
+- Para criar ambientes espelho de produção
+
+## Checklist de Configuração no Studio
+
+- [ ] Criar ambiente de staging
+- [ ] Clonar dados de produção para staging
+- [ ] Testar novas funcionalidades em staging
+- [ ] Migrar alterações aprovadas para produção
+
+## Validações e Testes
+
+- [ ] Ambiente de staging é criado corretamente
+- [ ] Dados são clonados sem perda
+- [ ] Alterações em staging não afetam produção
+- [ ] Migração para produção funciona

package/datasource-funifier-docs/knowledge/modules/static-repo.md

@@ -0,0 +1,41 @@
+# Static Repo (Repositório Estático)
+
+**Acesso Studio:** `/studio/static`
+**API Endpoint:** `/v3/static`
+
+## O que é
+
+Hospedagem de interfaces e conteúdos estáticos em subdomínios Funifier. Permite criar repositórios públicos nos servidores da Funifier para hospedar interfaces gráficas customizadas. Os conteúdos podem ser enviados manualmente, sincronizados via Git ou upload de arquivos.
+
+## Quando usar
+
+- Para hospedar interface exclusiva da gamificação
+- Para criar páginas personalizadas em subdomínio (ex: seugame.funifier.app)
+- Para deploy de frontends customizados
+
+## Checklist de Configuração no Studio
+
+- [ ] Criar repositório estático
+- [ ] Fazer upload dos arquivos (HTML, CSS, JS)
+- [ ] Configurar subdomínio
+- [ ] Testar acesso público
+
+## API Endpoints
+
+### Listar Repositórios
+**Método:** GET
+**Endpoint:** `/v3/static`
+
+### Criar Repositório
+**Método:** POST
+**Endpoint:** `/v3/static`
+
+### Deletar Repositório
+**Método:** DELETE
+**Endpoint:** `/v3/static/:id`
+
+## Validações e Testes
+
+- [ ] Repositório é criado com sucesso
+- [ ] Arquivos são acessíveis via URL pública
+- [ ] Subdomínio funciona corretamente

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

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

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

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