talivia

## Visão Geral Talivia é uma plataforma de análise open-source e auto-hospedada focada na atribuição de receita para founders. Ela oferece análises web, Session Replay, recursos de colaboração em equipe, dashboards compartilhados de análise, capacidades de importação/exportação além de conexões diretas aos dados de receita dos clientes provenientes de processadores de pagamento. O projeto representa o subconjunto auto-hospedado do serviço comercialmente hospedado Talivia Cloud. O hospedagem gerenciada adiciona integrações com Google Search Console, Bing Webmaster Tools, atividade no GitHub e menções sociais de plataformas como X, Reddit e TikTok. ## Recursos - **Análise web**: rastreamento de visitas por meio de um snippet JavaScript embutível. - **Session Replay**: reprodução opcional de sessões de usuários em sites. - **Atribuição de receita**: ciclo de vida da assinatura, reembolsos, disputas, atribuição first-touch e last-touch. - **Integrações de pagamento**: Stripe, LemonSqueezy, Polar, Dodo, Yolfi e uma API de pagamento manual. - **Colaboração**: colaboradores de sites e dashboards compartilhados de análise. - **Importação/exportação**: fluxos de trabalho de migração e backup de dados. - **Conversões cripto**: conversão opcional de taxas de câmbio através do CoinGecko. - **Kit de Agente IA**: uma ferramenta open-source compatível com MCP para Codex, Claude Code, ChatGPT e outros agentes instalar snippets de rastreamento, gerar planos de configuração, verificar eventos ao vivo e conectar visitas à atribuição de pagamentos. ## Pilha Tecnológica - Runtime: Node.js 22 LTS ou 24 LTS - Gerenciador de pacotes: pnpm 10+ - Banco de dados: PostgreSQL - ORM: Prisma - Containerização: Docker Engine com Docker Compose ## Configuração ### Desenvolvimento local 1. Certifique-se de que Node.js 22/24 LTS, pnpm 10+ e uma instância PostgreSQL fresca estejam disponíveis. 2. Copie `.env.example` para `.env` e gere um segredo de 32 bytes com `openssl rand -hex 32`. 3. Defina `DATABASE_URL` e `APP_SECRET` em `.env`. 4. Instale dependências e execute migrações: ```bash pnpm install --frozen-lockfile pnpm exec prisma migrate deploy pnpm dev ``` 5. Abra `http://localhost:3000` e faça login com `admin` / `admin`. Altere imediatamente a senha de bootstrap em **Configurações → Conta**. ### Docker ```bash cp .env.example .env openssl rand -hex 32 docker compose up --build -d ``` O contêiner aplica automaticamente a migração do banco de dados OSS antes de iniciar o aplicativo. Após a inicialização, altere a senha padrão do administrador. ## Configuração | Variável | Obrigatório | Propósito | |---|---|---| | `DATABASE_URL` | Sim | String de conexão PostgreSQL | | `APP_SECRET` | Sim | Valor aleatório de 32 bytes para assinatura de sessão e criptografia de credenciais | | `COINGECKO_API_KEY` | Não | Habilita conversão de taxa de câmbio cripto; o aplicativo permanece funcional sem ele | ## Primeiro uso 1. Crie uma entrada de site no Talivia. 2. Insira o snippet de rastreamento fornecido no site-alvo. 3. Confirme que uma visita aparece no painel. 4. Habilite o Session Replay opcionalmente nas configurações do site. 5. Conecte a receita do cliente em **Configurações do site → Pagamentos**. Ao executar atrás de um proxy reverso, encaminhe os cabeçalhos originais `Host` e `X-Forwarded-Proto` para que as URLs de webhook sejam geradas corretamente. ## Backups e atualizações Faça backup do banco de dados PostgreSQL antes de atualizar. Para implantações Compose: ```bash docker compose exec -T postgres pg_dump -U talivia -d talivia_oss > talivia-backup.sql ``` Versões futuras adicionam migrações ordenadas sob `prisma/migrations`. Aplique-as com `pnpm exec prisma migrate deploy`; o contêiner oficial executa isso automaticamente na inicialização. As migrações existentes não devem ser editadas. ## Kit de Agente IA e MCP Talivia distribui um kit de agente open-source ([github.com/talivia-group/agent](https://github.com/talivia-group/agent)) compatível com clientes habilitados para MCP. Agentes podem instalar rastreamentos, gerar planos de configuração específicos do framework, verificar eventos de análise ao vivo e rastrear visitas até a atribuição de pagamentos. - Ponto de extremidade OAuth hospedado (Talivia Cloud): `https://talivia.com/mcp` - Modo stdio local: `npx -y @talivia/agent mcp` A edição auto-hospedada não expõe o ponto de extremidade OAuth do Talivia Cloud. ## Segurança e licenciamento Relatórios de vulnerabilidade e orientações de implantação estão em [SECURITY.md](SECURITY.md). Detalhes do fluxo de desenvolvimento estão em [CONTRIBUTING.md](CONTRIBUTING.md). Talivia é lançado sob a Licença MIT. ## Comparação Talivia se posiciona como alternativa ao Datafast, enfatizando a atribuição de receita integrada e integrações de pagamento multi-processador dentro de uma única implantação auto-hospedada.