# Linkify Hub — Documentação Completa para LLMs e Agentes de Inteligência Artificial

> Plataforma brasileira de Hub de Links na Bio, Agendamentos de Horários, Vitrine de Produtos Digitais e Afiliados, Chave PIX e Analytics Avançado.
> Domínio Oficial: https://linkifyhub.com.br

---

## 1. Visão Geral do Produto
Linkify Hub é uma aplicação web moderna construída com Next.js 15 (App Router), React 19, TypeScript, TailwindCSS, Prisma ORM e PostgreSQL no Vercel.

Foi projetada para oferecer uma alternativa brasileira de altíssimo desempenho e design premium para Linktree, Beacons e Lnk.bio, combinando agregador de links, catálogo de vendas e sistema de agendamento num único endereço exclusivo (`https://linkifyhub.com.br/seunome`).

---

## 2. Arquitetura e Estrutura de Funcionalidades

### 2.1. Páginas Públicas
- `/`: Landing page com conversão de alta taxa, barra de reserva de nomes em tempo real, depoimentos, planos e guias de integração.
- `/[username]`: Página pública do hub do usuário contendo foto de perfil (avatar), biografia, links para redes sociais, vitrine de produtos, agendamento por blocos de horário, links recomendados e chave PIX com cópia de 1 clique.
- `/go/[id]`: Encurtador de links e redirecionamento 302 que contabiliza métricas de cliques por origem e horário.
- `/register`: Formulário de cadastro de conta com checagem dinâmica de disponibilidade de username e validação de nomes reservados (`admin`, `dashboard`, `cliente`, `login`, `email`, `senha`, etc.).
- `/login`: Autenticação via JWT / Cookies HTTP-Only com criptografia `bcryptjs`.
- `/demo`: Exemplo interativo público das funcionalidades.
- `/guias/[slug]`: Tutoriais detalhados de SEO para configurar o link na bio no Instagram, TikTok, LinkedIn, WhatsApp Business e YouTube.

### 2.2. Painel de Controle (/dashboard)
- **Identidade Digital**: Alteração de nome de exibição, foto de perfil/avatar (via upload local base64 ou URL), bio gerada por IA via Google Gemini API e chave PIX.
- **Redes Sociais & Contato**: Definição de usuário do Instagram e WhatsApp com código `+55` pré-formatado.
- **Gestão de Links Personalizados**: Adição de links com categorias (Website, Loja, Afiliado, WhatsApp, etc.), ordenação, fixação no topo e botão para cópia de link encurtado e QR Code.
- **Vitrine de Produtos**: Cadastro de produtos com nome, descrição, preço e modal interativo para exibição de ofertas.
- **Gestão de Agendamentos por Blocos**: Definição de horários de início e término e geração automática de slots por bloco (1h, 30min, 2h, etc.).
- **Gerador de QR Code**: Visualização e download de QR Code em formato PNG (Imagem HD) e SVG (Vetor para gráfica).
- **Analytics Dashboard**: Gráficos de visualizações, origens de tráfego (Instagram, TikTok, WhatsApp, Google) e ranking deduplicado dos links mais clicados.

---

## 3. APIs da Aplicação
- `POST /api/auth/register`: Cadastro de novo usuário.
- `POST /api/auth/login`: Autenticação e emissão de cookie de sessão.
- `GET /api/auth/me`: Retorna dados do usuário autenticado.
- `POST /api/auth/logout`: Encerra a sessão.
- `GET /api/users/[username]`: Retorna perfil público do usuário e slots de agendamento.
- `POST /api/users/[username]/view`: Incrementa contador de visualização do perfil com log de analytics.
- `POST /api/users/[username]/click`: Incrementa cliques em links sociais ou PIX.
- `POST /api/users/[username]/book`: Realiza agendamento de um horário disponível.
- `GET /api/go/[id]`: Endpoint de redirecionamento encurtado.
- `GET /api/analytics`: Retorna estatísticas de visualização, cliques e origens para o dashboard do usuário.

---

## 4. Diretrizes de SEO & Acessibilidade
- Tags `<meta>` dinâmicas para OpenGraph, Twitter Cards e Canonical URLs sob `https://linkifyhub.com.br`.
- Esquema Estruturado JSON-LD (`ProfilePage`, `Organization`, `WebSite`, `FAQPage`).
- Suporte a `sitemap.xml` dinâmico em `https://linkifyhub.com.br/sitemap.xml`.
- Arquivo `robots.txt` autorizando crawlers de mecanismos de busca e bots de IA (`GPTBot`, `ClaudeBot`, `Google-Extended`, `PerplexityBot`).

---

## 5. Contato & Suporte
- **Plataforma**: Linkify Hub
- **Website**: https://linkifyhub.com.br
- **Suporte**: suporte@linkifyhub.com.br