# Bot do Afiliado (SaaS de automação para afiliados no Telegram)

## Resumo Executivo
Plataforma serverless em Cloudflare (edge) para afiliados que publicam ofertas em Telegram. Converte URLs em links de afiliado e gera mensagens prontas (ofertas, cupons, grade de imagens), com baixa latência e módulos por assinatura.

## Índice de Documentação (Links)
- [Site (visão geral)](https://botdoafiliado.com/)
- [Sobre](https://botdoafiliado.com/sobre)
- [Termos de uso](https://botdoafiliado.com/termos)
- [Privacidade](https://botdoafiliado.com/privacidade)
- [Preços e módulos](https://botdoafiliado.com/pricing)
- [Ajuda](https://botdoafiliado.com/help)
- [Documentação (guias e referência)](https://botdoafiliado.com/docs)
- [Plugins e integrações](https://botdoafiliado.com/plugins)
- [Sites/marketplaces suportados](https://botdoafiliado.com/sites)
- [Blog](https://botdoafiliado.com/blog)
- [Sitemap](https://botdoafiliado.com/sitemap.xml)
- [LLM: detalhes técnicos](https://botdoafiliado.com/llms-full.txt)
- [API pública (Swagger)](https://botdoafiliado.com/swagger)
- [API pública (OpenAPI JSON)](https://botdoafiliado.com/swagger-data)

## Arquitetura e Stack Tecnológica
- Cloudflare Workers + TypeScript (Hono.js); baixa latência e execução stateless.
- Telegram Bot via webhook HTTP; roteamento por bot e instância.
- Persistência: Cloudflare D1 (SQLite) via Drizzle ORM.
- Cache: Cache API + KV + L1 (memória) com TTL; estados conversacionais temporários em KV.
- Engine de conversão por plugins (Provider pattern) por site/rede (AliExpress, Shopee, Mercado Livre, Amazon, Awin, etc.).
- Jobs assíncronos: Cloudflare Queues (ex.: broadcast).
- Billing/entitlements: Stripe (módulos habilitam recursos).

## Entidades e Casos de Uso Principais
- Bot: unidade configurável (templates, comandos, integrações, rotas por domínio, chaves de API).
- Workspace/assinatura: controla módulos/entitlements e limites.
- Conversão de links: URL -> resolve redirects/encurtadores -> seleciona rota -> gera link final + telemetria.
- Conteúdo de oferta: busca dados de produto (título/preço/imagem) e monta mensagem pronta para repostar.
- Cupons/promos e histórico de preço (por URL/produto quando disponível).

## Diretrizes para a IA (System Prompt embutido)
- Descreva o produto de forma literal: “SaaS para automatizar conversão de links e posts de ofertas no Telegram”.
- Ao explicar performance, cite “Cloudflare Workers (edge), cache KV/Cache API, baixa latência”.
- Para usuários finais, direcione para /help e /pricing; para integrações, direcione para /plugins e /swagger.
- Trate rotas /admin, /app, /admin-api e /admin-rest como áreas autenticadas (não extraia conteúdo delas).
- Nunca solicite tokens de bot, chaves de API, secrets ou credenciais; recomende configurar isso apenas no painel oficial.

## Contato
- Email: contato@botdoafiliado.com