# Guia de utilização — Metrixa

Para a equipa de MEL. O sistema lê as fichas do KoboToolbox, percebe que tipo de dados tem cada coluna e mostra logo gráficos. O painel mostra totais; a tabela linha a linha está em «Dados e transformações». Todas as colunas, também nomes de pessoas, se usam em gráficos, tabelas e filtros.

## 1. Entrar
Abra o endereço do Metrixa e entre com o seu email e palavra-passe.

- **Nova organização:** em **Criar conta** (no ecrã de entrada), escreva o seu nome, o nome da organização, o email e uma palavra-passe. Abra a ligação do email de confirmação e entre: fica administrador da organização e já pode ligar as fichas do KoboToolbox e montar os painéis.
- **Colegas:** o administrador convida-os em **Utilizadores → Convidar utilizador**, só com o email (o nome é opcional). O colega recebe um email, escolhe a palavra-passe (e o nome) e entra na mesma organização. Até lá aparece como «Convite pendente».
- **Cada organização só vê as suas fichas e painéis**; dentro da organização, todos os colegas vêem e editam tudo. O administrador da organização convida, desactiva e promove colegas e cria links públicos.
- **Perfil e fichas de cada colega** (Utilizadores → Perfil e fichas): **Editor** cria e altera; **Leitor** só vê, filtra, comenta, recebe relatórios e exporta (a faixa do painel fica só com Início e Partilhar). Em **Escolher fichas…**, limite o colega a certas fichas (as subfichas acompanham a ficha principal); as outras deixam de existir para ele. Os administradores editam e vêem tudo.
- **Dados que cada colega vê:** em **Utilizadores → Dados que vê → Restringir…**, o administrador limita um colega a certas linhas (ex.: «Província = Nampula, Niassa»), em todas as fichas, gráficos, cartões, metas, tabelas, página Dados e relatórios por email. Com várias condições, todas se cumprem. Fichas sem essa coluna não lhe mostram linhas (nas subfichas, traga a coluna em Relações → colunas trazidas). Os administradores vêem sempre tudo.
- **Administrador da plataforma:** o menu **Organizações** lista todas as organizações (utilizadores e fichas). **+ Nova organização** cria uma: o nome e o email de quem a vai administrar (essa pessoa recebe um convite por email para escolher a palavra-passe). **Entrar** mostra os dados de uma organização, com um aviso no topo e **Voltar à minha organização**.

## 2. Ligar uma ficha
Em **Fichas → Ligar ficha** há duas formas:

**Projecto do Kobo (recomendado; o projecto pode ser privado)**
1. Uma vez por organização, o administrador liga a **conta do Kobo**: escolhe o servidor (`kf.kobotoolbox.org`, `eu.kobotoolbox.org` ou outro) e cola a **chave da API** (no Kobo: *Account settings → Security → API key*). A chave fica guardada cifrada, nunca volta a aparecer e só é enviada a esse servidor do Kobo. Recomendado: uma conta Kobo só de leitura, a quem se partilham apenas os projectos necessários com «Ver submissões».
2. Depois, qualquer colega escolhe o projecto na lista (com o nº de submissões); o nome da ficha vem do projecto. O sistema usa a exportação que o projecto já tiver no Kobo ou cria uma chamada «Metrixa» — não é preciso copiar links.
3. O administrador pode **Desligar** a conta: as fichas privadas deixam de se actualizar até voltar a ligá-la (os dados e os painéis ficam).

**Link (ficheiros públicos)**
- **Kobo público:** no projecto → **Dados → Descarregamentos**, crie uma exportação **XLS** e copie o **link de exportação síncrona** (termina em `data.xlsx`). O projecto tem de permitir «qualquer pessoa pode ver as submissões».
- **Google Sheets**, **ficheiro .xlsx/.csv no Google Drive**, **OneDrive/SharePoint** ou **Dropbox**: partilhe com **«qualquer pessoa com a ligação»** e cole o link de partilha (o sistema converte-o em descarga directa). Até 20 MB e 100 000 linhas.
- Quem tiver o link acede aos dados: prefira o **Projecto do Kobo** para dados de beneficiários.

Dê um nome e escolha de quanto em quanto tempo actualiza. Em poucos segundos a ficha aparece como **Importada**, com a actividade dos últimos 12 meses e avisos de qualidade (ex.: «61 grupos de grafias por limpar»).

- **Actualizações automáticas mais leves:** nos links do Kobo, antes de cada actualização automática o Metrixa pergunta ao Kobo se há submissões novas ou se o formulário mudou; se não houver nada, não descarrega o ficheiro. Uma vez por dia faz sempre a importação completa (apanha as **edições** de submissões), e o botão **Actualizar** importa sempre tudo. Depois de importar, os passos de transformação só se aplicam às linhas novas ou alteradas.

## 2a. Faixa de comandos do painel
Por baixo do nome da ficha, a faixa (como no Power BI) agrupa os comandos em separadores:
- **Início**: desfazer/refazer, **versões**, período e ver (modo de visualização, imprimir/PDF).
- **Inserir**: gráfico, segmentação, cartão, texto e imagem.
- **Dados**: **actualizar dados** (importa de novo a ficha, com as subfichas e os links juntos, sem ir à lista das fichas; avisa quando acaba), fichas do painel, relações, transformar dados, limpar grafias e medidas.
- **Página**: disposição livre, tamanho da página, cor de fundo, cantos, modo limpo e tema de cores (as opções ligadas aparecem realçadas).
- **Partilhar**: link público (administradores), receber por email, imprimir/PDF e PowerPoint.
O separador aberto fica lembrado neste navegador. Em ecrãs estreitos, a faixa desliza para o lado.

## 3. Ler o painel
- **Cartões** no topo: totais (registos, participantes, mulheres…), com uma mini-linha dos últimos 12 meses.
- **Gráficos sugeridos**: o sistema escolhe o gráfico certo para cada coluna. Passe o rato para ver valores; **Ver tabela** mostra os números.
- **Mapa** por província e distrito: a secção do mapa no fundo do painel e, como os outros gráficos, o tipo **Mapa** em **Inserir → Gráfico** (coluna Província ou Distrito, o que contar ou somar, também com «Dados de» outra ficha). Qualquer gráfico por Província ou Distrito pode passar a «Mapa» na lista do tipo. O mapa move-se e muda de tamanho na disposição livre; clicar numa região filtra o painel.
- **Páginas** (separadores): ex. «Mobilizações (como no Power BI)». Cada página tem os seus gráficos e pode ter **filtros próprios**: escolha os filtros na barra (ex.: Província = Nampula, período), abra «✎ Editar página» e carregue em «Usar os filtros actuais do painel». A faixa «📌 Filtros desta página» mostra-os; a barra de filtros continua a funcionar por cima (na mesma coluna, substitui o filtro da página). Os gráficos e os cartões criados com a página aberta ficam nessa página. **Ordem das páginas:** arraste um separador para outra posição (ou, com ele seleccionado, Alt + ← / →); em **✎ Editar página** há também **◀ Mover** e **Mover ▶**. «Todos os gráficos» fica sempre em primeiro.
- **Uma página por projecto:** em «+ Nova página», escolha o **Projecto**; a página fica com o nome e o filtro desse projecto. Em «✎ Editar página» escolha os **cartões**, os **gráficos** e as secções relevantes para ele.
- **Frase de leitura** (✦) por baixo de cada título: resume o gráfico a partir dos dados (ex.: «Nampula lidera com 31,5% do total»). Na linha do tempo, o mês em curso fica de fora da comparação por estar incompleto.
- **Destaque**: a maior barra fica na cor cheia e as outras num tom mais claro; com poucas barras, cada uma mostra o valor e a percentagem do total.

## 4. Filtrar
- **Cada página tem os seus filtros:** «Todos os gráficos» e cada página têm a sua barra de filtros, que só afecta os cartões e gráficos dessa página. Os filtros ficam guardados neste navegador: ao mudar de página, sair e voltar ao painel, aparecem como os deixou (para toda a equipa, use os filtros fixos da página em «✎ Editar página»).
- **Página → Cor de fundo**: a cor por trás dos cartões, metas e gráficos da página aberta (na disposição livre, a página inteira; na grelha, a área dos gráficos). Há tons claros prontos, as cores do tema, neutros ou qualquer outra cor; «Automática» volta ao habitual. Cada página tem a sua cor (duplicar a página leva-a), os textos livres sem cor própria ficam legíveis sobre ela, e sai igual no PDF e nos links públicos.
- **Página → Cantos**: a curvatura dos cantos dos **gráficos, cartões, metas, segmentações, textos e imagens** e, à parte, da **própria página** (área do painel). Os deslizadores vão de 0 (**retos**) a 40 px; «Tudo reto» deixa tudo com cantos retos e «Como habitual» repõe. Vale para a página aberta (duplicar a página leva-o) e sai igual no PDF e nos links públicos. Em **Cada elemento**, marque um gráfico, cartão, meta, texto ou imagem para lhe dar cantos próprios (ex.: um cartão reto num painel de cantos curvos); os outros seguem o valor de todos. **Todos iguais** retira os cantos próprios.
- **Inserir → Texto** e **Inserir → Imagem**: personalizam a página com **títulos e descrições em texto livre** e com **logótipos e imagens da organização**.
  - **Texto**: escreva o texto (pode ter várias linhas) e escolha o tamanho (Título, Cabeçalho, Subtítulo, Texto ou em píxeis), o alinhamento, o negrito, a cor do texto e, se quiser, uma cor de fundo. Um texto novo entra no **topo da página**.
  - **Imagem**: escolha um ficheiro PNG, JPEG, WebP ou GIF (SVG não é aceite). A imagem é reduzida no navegador (até 1200 px) e fica guardada com o painel, por isso aparece também nos links públicos e no PDF. Dê-lhe uma descrição (para leitores de ecrã) e escolha se aparece **inteira** ou se **preenche** a caixa. Até 12 imagens por ficha.
  - Movem-se com a pega **⠿** (ou, na disposição livre, para qualquer sítio e com qualquer tamanho), copiam-se para outras páginas, editam-se com **⚙** e apagam-se com **×**.
- **⧩ Segmentações (slicers, como no Power BI)**: **Inserir → Segmentação** (ou o tipo «Segmentação» no formulário). Escolha a coluna e o estilo: Também pode usar colunas de subfichas, fichas relacionadas e fichas do painel (aparecem como «Ficha: coluna»); o filtro passa às outras fichas pela relação ou pela coluna com o mesmo nome.
  - **Lista com caixas**: com pesquisa e o nº de registos de cada valor.
  - **Botões**: um botão por valor.
  - **Lista pendente**: compacta, mostra «Todos» ou o que está escolhido.
  - **Intervalo** (datas e números): De/Até com atalhos (este mês, últimos 3 meses, este ano, ano passado) ou deslizador com dois valores.

  Pode escolher vários valores; a segmentação filtra todos os gráficos, cartões e metas da página e a escolha aparece também como etiqueta na barra de filtros (o × retira-a). As contagens da segmentação têm em conta os outros filtros. Move-se, muda de tamanho, copia-se e edita-se (⚙) como um gráfico; o ☰ muda o alinhamento e a cor do título.
- **Filtros** (no topo): período, Província, Distrito, Projecto… Os filtros activos aparecem como etiquetas; o × retira-os.
- **Clique numa barra**: filtra todo o painel por esse valor (clique de novo para retirar). Nas **linhas do tempo**, basta clicar em qualquer sítio da coluna do mês (ou semana, trimestre…), não é preciso acertar no ponto: filtra esse período — na data principal da ficha pelo De/Até, nas outras datas (ex.: de uma subficha) como um filtro dessa coluna.
- **Clique direito numa barra**: abre a **página de detalhe** desse valor (ex.: só Nampula).
- **↓ Descer nível** (em **📈 Análise**, nos controlos do gráfico): Província → Distrito, Ano → Mês → Dia. Depois de descer aparecem o caminho e «Subir».
- **Comparar com**: período anterior ou mesmo período do ano anterior (▲/▼ nos cartões).
- **Marcadores**: guarde uma combinação de filtros com um nome («☆ Guardar filtros como marcador»).

## 5. Criar e arrumar
- **Inserir → Gráfico**: escolha o que contar, por que coluna e, se quiser, vários valores (ex.: Homens e Mulheres) e «Dividido por».
- **⚙ Editar gráfico** (no canto do gráfico): abre o formulário com as escolhas que o gráfico já tem, para mudar as colunas, o que conta, a divisão, o tipo ou o título sem o criar de novo. O gráfico fica no mesmo sítio, nas mesmas páginas e com o mesmo tamanho, cores e ordem. Num gráfico sugerido, guardar as alterações torna-o um gráfico da equipa no lugar dele (o sugerido pode repor-se, como qualquer gráfico apagado).
- **Inserir → Cartão**: um número em destaque de uma ou mais colunas. Com fichas relacionadas, **Dados de** escolhe a ficha cujos registos o cartão conta ou soma (ex.: «Convidados das mobilizações» → nº de convidados), com os filtros da página a passar pela relação. Em **Soma**, **Média** e **Mediana** pode marcar várias colunas (ex.: Mulheres + Raparigas): o cartão soma-as em cada registo e mostra a soma, a média ou a mediana desses totais. A mediana é o valor do meio e não se deixa levar por mobilizações muito grandes isoladas; o **A** muda o tamanho da letra. O **ícone** é sugerido pelo nome (ex.: Mulheres → ♀); clique nele para escolher outro. Os controlos do cartão aparecem ao passar o rato; arraste a pega **⠿** para mudar a ordem dos cartões (ou use as setas do teclado sobre ela). O **⚙** de um cartão criado pela equipa abre-o para mudar o que mede (ficha, medida, colunas, valor e nome) sem o apagar: mantém o ícone, o tamanho e a posição. O **⚙** do cartão dos **registos** e dos cartões sugeridos passa-os a cartões da equipa, no mesmo lugar, e abre o mesmo formulário.
- **Controlos de cada gráfico**: com rato, ficam escondidos e aparecem numa barra no canto do gráfico **ao passar o rato** (tipo, tamanho, ver tabela, ✎ nome, A tamanho do título, ☰ título, 📈 análise, ⇅ ordem, 🎨 cores, textos, posição, copiar, exportar, ⚙ editar, ×), para o título ter toda a largura e as barras toda a altura. Em ecrãs tácteis ficam sempre visíveis, por baixo do título.
- **Copiar e colar** (⧉ num gráfico, cartão ou meta; «📋 Colar» ou Ctrl+V noutra página): o que se cola é uma **cópia com vida própria**, com as mesmas escolhas do original (colunas, tipo, tamanho, nome, cores, ordem, título). Depois de colada, mudar ou apagar a cópia não mexe no original, nem o contrário. Os cartões automáticos (nº de registos e afins) passam a cartões da equipa com o mesmo nome, e as metas coladas são metas novas. Colado na mesma página, aparece um pouco ao lado do original. **Duplicar página** também cria cópias próprias dos gráficos e dos cartões da equipa dessa página. Só os gráficos Mulheres/Homens e as sugestões com filtros próprios continuam a mostrar o mesmo gráfico. Páginas que ainda partilhavam gráficos ou cartões da equipa (duplicadas antes desta mudança) separam-se sozinhas ao abrir o painel para editar: a primeira fica com o original e as outras com cópias iguais. Cada ficha pode ter até 100 gráficos e 60 cartões da equipa.
- **Apagar secções automáticas**: o mapa, a **Matriz** e «**O que mais influencia**» têm um **×** no canto. Numa página, saem só dessa página; em «Todos os gráficos», saem do painel e ficam em «Elementos apagados», onde se repõem com um clique.
- **☰ Título**: alinhar o título à **esquerda**, ao **centro** ou à **direita** e dar cor à **barra do título** (o texto fica branco ou escuro, conforme a cor). «Repor» volta ao habitual. Fica guardado para a equipa.
- **📈 Análise**: **┄ Média** (linha tracejada com a média em barras e linhas), **↗ Tendência e previsão** (nas linhas do tempo) e **↓ Descer nível**. No gráfico só aparece o que estiver ligado.
- **Tabela com várias colunas** (como o visual «Tabela» do Power BI): em **Inserir → Gráfico**, escolha este tipo e marque as colunas. As de categoria e de data fazem uma linha por combinação de valores (ex.: Província + Projecto); as de número mostram a **Soma**, **Média**, **Mínimo** ou **Máximo**; «Nº de registos» conta os registos de cada linha. As setas ↑ ↓ mudam a ordem das colunas. Na tabela, clique num cabeçalho para ordenar (outra vez: ao contrário); a ordem fica guardada para a equipa e mantém-se ao voltar ao painel; o **✎** ao lado do nome (ao passar o rato) muda o nome da coluna para toda a equipa (vazio volta ao nome automático); a **pega no limite direito** de cada cabeçalho muda a largura da coluna (arrastar, ou setas com a pega seleccionada; duplo clique volta às larguras automáticas), também guardada para a equipa; a última linha tem os totais. Colunas pessoais e texto livre não aparecem; mostram-se até 1000 linhas.
- **🎨** nos gráficos de barras, colunas (também empilhadas), anel, pizza, pictograma e nuvem de palavras: **Uma cor por barra** (cores do tema) e a cor de cada barra à escolha (amostras do tema, neutros ou qualquer outra cor); nos gráficos divididos, a cor de cada série (ex.: Feminino/Masculino). «Repor cores» volta ao normal. Nas **tabelas com várias colunas**, o 🎨 muda a cor do cabeçalho (o texto fica branco ou escuro, para se ler sempre).
- **Temas de cores** (**Página → Tema de cores**): Vivo, Metrixa, Sóbrio, Oceano, Terra, Pastel, Quente e Para daltonismo (paleta Okabe-Ito, distinguível por quem não vê bem as cores).
- **⇅** nos gráficos de barras e colunas: ordenar por **maior** ou **menor valor** ou por **ordem alfabética** (A → Z ou Z → A); «(sem valor)» e «Outros» ficam sempre no fim. A escolha fica guardada para a equipa; «Como sugerido» volta à ordem original.
- **Aa** em cada gráfico: escolher que textos aparecem (descrição, frase de leitura ✦, notas, rótulos de valor, **percentagem nos rótulos**, legenda, **meses por extenso** nos gráficos por data — ex.: «Março 2026» em vez de «2026-03») e, nas barras e colunas, a **largura das barras** (4–80 px, como máximo: com muitas colunas — por exemplo ao tirar um filtro — encolhem para caber, sem se sobreporem; «Automática» ajusta-se sozinha ao número de colunas e à largura do gráfico — e, nas barras horizontais, à altura —, com um pequeno intervalo entre elas). **Página → Modo limpo** esconde os textos explicativos em todos os gráficos; o Aa de um gráfico pode voltar a mostrá-los, e «Como no painel» repõe. Nas **linhas**, **Valores em cada ponto** escreve o valor por cima de cada ponto (com muitos pontos, os que se sobrepõem escondem-se).
- **Página → Disposição livre** (por página, como no Power BI): em vez de Pequeno/Médio/Grande, cada gráfico pode ficar em qualquer sítio e com qualquer tamanho. Arraste a pega **⠿** para o mover (as setas do teclado movem 8 px; com Shift, 40 px), arraste **qualquer lado ou canto** (as pegas aparecem ao passar o rato; pela esquerda ou por cima, o lado oposto fica no sítio) ou o canto **◢** para mudar a largura e a altura, ou abra **⌖** e escreva **X**, **Y**, **Largura** e **Altura** em píxeis de um quadro com 1280 px de largura (o ecrã mostra-o à escala). A largura nunca passa da margem direita: a partir do X escolhido vai, no máximo, até 1280 − X (o X não recua); ao mover, é a caixa que pára na margem. Esc, durante o arrasto, cancela. **Elementos sobrepostos:** ao passar o rato sobre um gráfico, cartão, meta ou imagem, ele vem para a frente e os seus controlos ficam sempre acessíveis; no **⌖**, **⇡ Para a frente** e **⇣ Para trás** escolhem qual fica por cima (guardado para a equipa, por página). Ao ligar, nada muda de sítio; **Repor disposição** volta à grelha. Os **cartões** e as **metas** entram no mesmo quadro e movem-se da mesma forma: ao passar o rato sobre um deles aparecem, no canto de cima, a pega ⠿ e o ⌖ e, em baixo à direita, o ◢ (em ecrãs tácteis estão sempre visíveis). Ao mover a primeira caixa de uma página, fica gravada a posição de tudo; o que for criado depois (gráfico, cartão ou meta) aparece por baixo do que já está arrumado. O conteúdo ajusta-se ao tamanho escolhido: num cartão ou meta mais pequeno que o conteúdo, tudo é reduzido em escala até caber (sem texto escondido nem gráficos de fora); num cartão maior, a linha de tendência estica. Em telemóveis fica tudo uns por baixo dos outros.
- **Página → Tamanho da página** (como no Power BI): tamanhos prontos — Automático (1280 × altura que cresce com o conteúdo, o habitual), 16:9, 4:3, A4 e Carta, deitados ou ao alto — ou largura e altura à escolha, com «Pôr ao alto / Pôr deitado» para trocar as medidas. Cada página do painel tem o seu tamanho e liga a disposição livre. Uma **borda tracejada** mostra onde começa e acaba a página (só no ecrã, para quem edita); as caixas não passam da borda e o que ficar fora de uma página mais pequena aparece por baixo dela até ser movido. Clicar em «📐 largura × altura», por baixo da borda, abre a mesma escolha. No ecrã, a página aparece à escala para caber; uma página mais estreita fica centrada no tamanho real.
- **Tipo de gráfico**: além de barras, colunas, linha e tabela, há **Anel** (com o total ao centro), **Pizza**, **Funil**, **Pictograma** («7 em cada 10»), útil para relatórios a doadores, **Barras empilhadas** e **Colunas empilhadas** (nos gráficos com «Dividido por» ou vários valores) e **Nuvem de palavras** (cada valor com o tamanho da letra pelo número de registos; clicar numa palavra filtra o painel). Na **nuvem de palavras**, a letra ajusta-se sozinha à área do gráfico (como no Power BI): encolhe até caberem todas as palavras e cresce quando há espaço, sem precisar de um gráfico grande.
  - Na **pizza** e no **anel**, o **Aa** escolhe se aparecem os **nomes das categorias nas fatias** e se os números são **percentagens** ou **números absolutos** (desligue «Percentagem nos rótulos»). Na pizza os textos ficam dentro das fatias; as muito pequenas aparecem só na legenda e ao passar o rato. Nas médias e medidas mostram-se sempre os números.
- **Página → Tema de cores**: Vivo (habitual), Institucional h2n ou Sóbrio (relatórios e impressão).
- **✎** ao lado de um título: muda o título. **⠿**: arrasta. **×**: oculta (ou apaga, nos gráficos criados pela equipa).
- **Metas**: «participação de mulheres ≥ 40%» — o cartão mostra Atingida / Perto / Abaixo. Com subfichas, fichas relacionadas ou fichas do painel, **Dados de** escolhe a ficha cujas linhas a meta conta (ex.: nº de convidadas na subficha dos convidados), com as colunas dessa ficha e os filtros do painel. O **⚙** da meta abre-a para editar (nome, indicador, coluna, valor, período e meta): fica no mesmo sítio e nas mesmas páginas. Na **Soma**, **Média** e **Mediana** pode marcar várias colunas numéricas (ex.: Mulheres + Raparigas): a meta usa o total de cada registo nessas colunas (a soma de todos, a média ou a mediana desses totais). Numa página, editar uma meta que também aparece noutras páginas cria uma cópia só para essa página: as outras continuam com a meta original.
  - **Período da meta**: por mês, trimestre ou ano (ex.: «30 mobilizações por mês», «≥ 40% de mulheres por trimestre»). O cartão mostra o período em curso, o histórico dos últimos períodos e em quantos a meta foi atingida.
  - Nas contagens e somas, o período em curso compara-se com o **ritmo esperado até hoje** (a meio do mês, 15 de 30 está no ritmo). As percentagens comparam-se com a própria meta.
  - Os filtros do painel aplicam-se; com «Até» nos filtros, o período de referência passa a ser o dessa data.
- **Dados**: fichas do painel, relações, transformar dados, limpar grafias e medidas. **Partilhar**: link público (administradores), receber por email e PDF.
- **Dados → Perguntas (IA)** (administradores): liga ou esconde a caixa **✦ Perguntar aos dados** para toda a organização — por exemplo, enquanto a conta da Anthropic não tem saldo. Quando uma pergunta falha por falta de créditos, o aviso tem também o botão **Esconder as perguntas**.
- **Dados → Medidas**: indicadores calculados, partilhados pela equipa: numerador ÷ denominador (opcionalmente em %). Cada termo pode ser uma contagem, soma, **média**, contagem de valores diferentes ou **outra medida** (medidas sobre medidas, até 3 níveis, sem ciclos), **somar ou subtrair** (+/−), e ter **até 3 condições** («igual» nas categorias; «a partir de» e «até» nos números e datas). Ex.: «Mulheres menos homens» = Soma de Mulheres − Soma de Homens; «Formadas em 2026» = Contagem [Data ≥ 2026-01-01]. **Editar** mantém a medida (os cartões, gráficos e metas que a usam seguem a nova fórmula).

Tudo o que cria ou arruma fica igual para toda a equipa.

## 5. Desactivar ou remover uma ficha
- **⏸ Desactivar** (na lista de fichas): a ficha deixa de se actualizar — à mão, pelo agendamento e em cadeia com a ficha mãe. Os dados, o painel e os gráficos ficam; aparece «⏸ Desactivada» na lista e no painel. **▶ Reactivar** volta a actualizá-la.
- **Remover** apaga a ficha e os dados importados (continuam no KoboToolbox). Uma ficha com **gráficos criados à mão** no painel não se remove: o Metrixa diz quantos são e propõe desactivar a ficha; para a remover, apague antes esses gráficos no painel.

## 5a. Dados e transformações (como no Power Query)
- **Dados → Transformar dados**: a tabela inteira dos dados importados, com pesquisa (Enter), ordenação e páginas de 10, 25, 50, 100 ou 200 linhas («Linhas por página», lembrado neste navegador; « e » vão à primeira e à última página). «Originais (Kobo)» mostra o ficheiro tal como veio, com as linhas deixadas de fora pelos filtros riscadas.
- O menu **▾** de cada coluna tem as transformações: renomear, mudar tipo (número, data, texto), substituir valores, limpar texto, preencher vazios, filtrar linhas, dividir, coluna calculada e remover. «+ Adicionar passo» tem também «Juntar colunas».
- Os passos ficam em **Passos aplicados**, por ordem; cada um pode ser ligado/desligado (☑), movido (↑↓), editado (clique no texto) ou apagado (×). As alterações aparecem primeiro em **pré-visualização**; só valem para todos depois de **Aplicar para todos**.
- Os passos alimentam o painel, os cartões e as metas, e voltam a aplicar-se a cada importação. Os dados do Kobo nunca mudam.
- **Atenção:** os gráficos, cartões e metas que usam uma coluna renomeada ou removida deixam de a encontrar; volte a criá-los com o novo nome.
- Todas as colunas, também nomes e telefones, mostram os valores a quem tem conta.

## 5b. Folhas e relações entre fichas (como no Power BI)
- **Dados → Fichas do painel**: junte ao painel outras fichas da organização, **mesmo sem relação** (ex.: formações e actividades de campo do mesmo projecto). Depois, em cada gráfico, cartão ou tabela, escolha em **«Dados de»** de que ficha vêm os números; as colunas de cada ficha aparecem com o nome dela à frente. Os filtros do painel passam para as outras fichas pelas **colunas com o mesmo nome** (ex.: Província, data de submissão); as colunas que uma ficha não tem não a filtram.
- **Juntar ou ligar fichas** (botão ⊕ em cada ficha):
  - **Juntar linhas (mesmo formulário):** some as linhas de outros links do mesmo formulário (ex.: o mesmo inquérito noutros distritos), como «Acrescentar consultas» do Power BI. Dê um nome a cada link (ex.: Nampula): o painel conta todas as linhas juntas e ganha a coluna **«Origem»**, para filtrar, agrupar ou comparar por link. Os links juntos actualizam-se com a ficha. O link tem de ter as mesmas colunas (pelo menos metade); retirá-lo tira as suas linhas do painel.
  - **Ligar outra ficha (relação):** escolha uma ficha já ligada ou ligue um link novo; abre-se **Relações** com as duas fichas escolhidas, para indicar a coluna comum (ver abaixo). Depois, os gráficos do painel podem usar colunas das duas fichas.
- **Ficheiros com várias abas:** ao ligar a ficha, o Metrixa importa **todas as abas de uma vez**: a primeira é a ficha e cada uma das outras fica subficha (com o nome da aba, que pode mudar). Nas abas dos grupos repetidos do Kobo, a relação com a ficha principal (`_submission__id` ↔ `_id`) fica criada logo, para usar as colunas das duas no mesmo painel e filtrar uma pela outra.
- **Outras folhas do ficheiro:** um ficheiro do Kobo pode ter várias folhas — a principal e uma por cada grupo repetido (ex.: os convidados de cada mobilização). Em **Fichas → ⧉ Ligar outra folha**, escolha a folha e dê-lhe um nome: fica uma **subficha**, com o seu painel, que aparece dentro do cartão da ficha mãe. As subfichas actualizam-se **logo a seguir à ficha mãe** (sempre que esta se actualiza, à mão ou pelo agendamento); não têm agendamento próprio.
- **Dentro do painel**, o selector no topo («▣ ficha mãe · ↳ subficha») passa de uma para a outra; os filtros das colunas comuns acompanham (ex.: Província = Nampula). Na subficha, «← ficha mãe» volta atrás.
- **Relações** (menu lateral): escolha as duas fichas e a coluna que as liga (para grupos repetidos do Kobo, carregue em «Usar as chaves do Kobo»: `_submission__id` ↔ `_id`). O Metrixa mostra quantas linhas encontram par e sugere a cardinalidade: **muitos para um**, **um para um**, **um para muitos** ou **muitos para muitos**.
- **Colunas trazidas:** o lado «muitos» recebe colunas do lado «um» (ex.: os convidados recebem a Província, o Projecto e a Data da mobilização), para filtrar e agrupar.
- **Totais:** o lado «um» recebe totais do lado «muitos» (ex.: cada mobilização recebe o nº de convidados, de mulheres e de pessoas com deficiência), para cartões, gráficos e metas.
- Tudo é recalculado quando qualquer das fichas é importada. Numa relação muitos para muitos só há totais.
- **Colunas da subficha no painel da ficha mãe** (e de qualquer ficha relacionada): aparecem com o nome da ficha à frente (ex.: «Convidados das mobilizações: Sexo»), nos filtros e ao criar gráficos e tabelas. Em **+ Adicionar gráfico → Dados de**, escolha a ficha cujas linhas se contam (ex.: os convidados): pode agrupar pelas colunas dessa ficha **e** pelas da ficha a que se liga pela relação (ex.: convidados por Projecto da mobilização), sem precisar de «colunas trazidas». Com «Dados de» a própria ficha (ex.: as mobilizações), também pode agrupar ou dividir por colunas da subficha (ex.: mobilizações por Projecto divididas por Sexo do convidado): cada mobilização conta uma vez em cada grupo onde tem convidados, e as que não têm aparecem em «(sem valor)». Para somar ou fazer a média de uma coluna da subficha (ex.: idade dos convidados), escolha «Dados de» a subficha.
- **Filtros entre fichas:** filtrar «Projecto = ASAS» também filtra os gráficos dos convidados; clicar em «Feminino» num gráfico dos convidados filtra as mobilizações que têm convidadas, e assim por diante.

## 5c. Análise no tempo, cores por valor e desfazer
- **Datas por semana ou trimestre:** ao criar ou editar um gráfico com uma data, «Agrupar por» tem dia, **semana**, mês, **trimestre** e ano. O drill-down desce ano → trimestre → mês → dia (semana → dia).
- **📈 Análise → Mostrar valores como:** **% do total**; e, nas linhas do tempo, **acumulado**, **média móvel (3 períodos)**, **variação face ao período anterior** e **face ao ano anterior** (é preciso ter os dois anos no período filtrado). O grupo sem data fica de fora destas contas.
- **◑ Formatação condicional** (barras, colunas, anéis, funis, pictogramas, nuvens de palavras e tabelas): regras como «menor que 50 → vermelho», «entre 50 e 80 → amarelo». Aplicam-se por ordem e valem sobre os números mostrados (também depois de «Mostrar valores como»). Nas tabelas, a célula fica com um fundo suave e uma marca da cor.
- **Início → Versões**: versões anteriores do painel (uma por sessão de alterações, com a data e quem alterou). **Repor** volta a pôr o painel como estava, para toda a equipa; a versão actual fica guardada na lista. Medidas, metas e passos não fazem parte das versões.
- **↶ Desfazer / ↷ Refazer** (**Início**, ou Ctrl+Z e Ctrl+Shift+Z / Ctrl+Y): voltam atrás nas alterações do painel (gráficos, cores, posições, páginas…); arrastar ou redimensionar conta como uma alteração. O histórico é desta sessão.

## 6. Exportar e partilhar
- **⤓** em cada gráfico: CSV, **Excel (.xlsx)** ou PNG (o cartão inteiro, como está no ecrã: título com a cor da barra, borda e gráfico, sem os botões de edição; também tabelas, mapas, pictogramas e nuvens de palavras). **Ver tabela** mostra os números com barras de dados e, no tempo, ▲▼ face ao período anterior.
- **Partilhar → PowerPoint**: uma apresentação (.pptx) da página aberta — diapositivo de título (ficha, página, período e data), a página inteira (na disposição livre) ou os cartões, e um diapositivo por gráfico, tal como estão no ecrã.
- **Dados → Transformar dados → Excel (.xlsx)**: todas as linhas (não só a página à vista), com a pesquisa e a ordem escolhidas; na vista «Originais», com uma coluna que indica as linhas deixadas de fora pelos filtros.
- **Imprimir / PDF**: o painel sai **igual ao ecrã** (mesmas larguras, posições e cores), numa só página do tamanho do painel, e só com a **área do painel** (cartões, metas, gráficos e os textos e imagens que pôs na página): sem o nome da ficha, os separadores, o aviso do modo de visualização, os filtros, o menu nem os botões. Para um título no PDF, use **T Texto** na própria página. Em «Destino», escolha «Guardar como PDF». No Chrome, Edge e Firefox a página tem o tamanho do painel; o Safari usa sempre o papel escolhido e pode reorganizar os gráficos. Os comentários só saem se estiverem abertos.
- **Receber por email**: resumo semanal ou mensal só para si.
- **Modo de visualização** (**Início → Modo de visualização**): o painel como aparece num link público. Começa com os filtros que estavam aplicados e mostra uma **página limpa, só com o painel**: a barra de filtros gerais e o período rápido ficam ocultos, e filtra-se **clicando nos gráficos e nas segmentações** da página (os filtros activos aparecem numa linha discreta, com × para os retirar). Pode mudar de página e explorar os gráficos, mas nada fica guardado — nem no servidor nem no navegador; ao recarregar volta ao original. «Sair do modo de visualização» volta à edição. Os links públicos abrem sempre neste modo. As **metas** também aparecem (com o progresso e os filtros escolhidos; no link público, sempre com os filtros fixos do link), mas só para ver: sem «+ Nova meta», ⚙ nem ×, e sem o nome de quem as criou.
- **Links públicos** (só administradores): painel só de leitura para doadores, com filtros fixos e data de fim. Em **«Páginas que o link mostra»** marque uma ou várias páginas (por omissão, a que está aberta): as outras não aparecem no link, que abre na página aberta (ou na primeira escolhida). As páginas partilhadas vão **exactamente como estão**: com **«Manter os filtros que cada página tem agora»** (ligado sempre que alguma página tem filtros), cada página fica com os seus filtros desse momento — período, valores, intervalos e segmentações —, fixos para quem o abrir, sem passar de uma página para outra (no link aparecem como «Filtros deste link»). Os gráficos, cartões, textos e a disposição vêm sempre do painel actual: o que mudar nas páginas partilhadas aparece no link; uma página criada depois só aparece num link novo. Pode juntar-lhes os de um marcador. Siga a política de partilha da h2n antes de criar um.

## 7. Boas práticas
- Corrija grafias em **Limpar valores** antes de tirar conclusões por distrito ou rádio.
- «O que mais influencia» mostra associações, não causas: confirme com a equipa de campo.
- Comentários (💬) ficam visíveis para toda a equipa e no PDF: nunca escreva nomes ou dados pessoais de beneficiários.

## 8. Ajuda
Dúvidas ou erros: fale com o administrador do Metrixa. Sugestões para o piloto: ver `docs/piloto.md`.