Guia do Usuário

O Dashboard é a sua tela inicial. Mostra um resumo das tarefas atribuídas a você com filtros por período (Hoje / Semana / Tudo) e por espaço.

O que cada métrica significa

• Concluídas — tarefas que entraram em status done dentro do período selecionado.
• Criadas — tarefas criadas para você (assignee) no período.
• Ativas — total de tarefas suas ainda não concluídas (independente do período).
• Atrasadas — tarefas com data de entrega vencida e não concluídas.

O dashboard atualiza automaticamente quando você (ou outra pessoa do time) mexe em qualquer tarefa atribuída a você — não precisa recarregar a página.

Um espaço representa um cliente, projeto ou área. Cada espaço tem seu próprio quadro Kanban, pastas, listas, documentos, vault de credenciais, identidade visual, links rápidos e relatórios.

Lifecycle

Espaços têm status (lead → mensal) que ajuda a separar prospects de clientes ativos. Use a aba Visão Geral para ver tudo do espaço em um lugar.

Tarefas vivem dentro de listas (que vivem dentro de pastas, que vivem dentro de espaços). Cada tarefa tem título, descrição, prioridade, assignee, data, anexos, comentários, checklist e tags.

Visualizações

• Kanban — drag & drop entre colunas customizáveis.
• Lista — visão tabular para edição rápida.
• Cronograma — Gantt-lite com escala dia/semana/mês.
• Carga — distribuição de horas por responsável e dia (preencha estimated_hours para usar).

Time tracking

Cada tarefa tem um botão de play/pause. Quando há um timer rodando, aparece um badge laranja no header (qualquer página) mostrando o tempo corrente — clique no badge para parar.

Repositório de arquivos do cliente. Faça upload de PDFs, contratos, briefings, planilhas. Os arquivos ficam em bucket privado do Supabase e são acessados via URL assinada (válida por algumas horas).

Categorize por tipo (contrato, briefing, criativo, etc.) para encontrar mais rápido. O upload é múltiplo — arraste vários arquivos de uma vez.

Cofre criptografado para credenciais do cliente: hospedagem, DNS, e-mail, redes sociais, APIs. Senhas e notas são cifradas com pgcrypto usando uma chave que só fica no servidor (env var VAULT_ENCRYPTION_KEY).

Segurança

• Você precisa clicar em "Revelar" para ver uma senha — toda revelação é registrada em vault_access_log.
• A API pública não expõe senhas. Apenas metadata (nome, URL, username, categoria).
• Se a chave de criptografia for perdida, as credenciais ficam irrecuperáveis. Faça backup.

Centraliza a identidade do cliente em 5 seções:

• Logos — arquivos SVG/PNG com preview.
• Cores — paleta com swatches; clique numa cor para copiar o HEX.
• Tipografia — fontes com sample text renderizado na própria fonte.
• Imagens — fotos auxiliares, mockups, banners.
• Guidelines — PDFs de manual de marca.

Atalhos para sites externos relacionados ao cliente: redes sociais, painéis, dashboards, intranets. Cada link tem favicon automático (via Google s2), título, URL, descrição e categoria.

Use a busca para encontrar pelo título, URL, descrição ou categoria.

Na Visão Geral do espaço, clique em Gerar relatório e escolha o período. Abre uma nova aba com o relatório formatado para impressão (A4):

• Header com logo do cliente e período.
• KPIs: total, concluídas, taxa de conclusão, horas estimadas concluídas.
• Lista de tarefas concluídas no período (com responsável, prioridade, horas).
• Distribuição por status (barras horizontais).

Para salvar como PDF, use o botão Imprimir / Salvar como PDF no topo do relatório e selecione "Salvar como PDF" no diálogo do navegador.

Cada geração é registrada na tabela client_reports com as métricas calculadas — útil para histórico.

O Zark CRM expõe uma REST API em /api/v1 para integração com agentes de IA, automações (n8n, Zapier) e aplicações externas.

Autenticação

Crie uma chave em Configurações → API Keys. Use o header:

Authorization: Bearer zk_xxxxxxxxxxxxxxxxxxxxxxxx

Rate limit

60 requests por minuto por chave (configurável). Excesso retorna 429 com header Retry-After.

Documentação interativa

Veja a referência completa em /docs/api (renderizada com Scalar + OpenAPI 3.1).

Endpoints principais

• GET /api/v1/spaces
• GET /api/v1/spaces/:id/tasks · POST para criar
• GET /api/v1/spaces/:id/documents
• GET /api/v1/spaces/:id/credentials (metadata only)
• GET /api/v1/spaces/:id/brand-assets
• GET /api/v1/spaces/:id/links
• GET /api/v1/spaces/:id/reports · POST /reports/generate