# Documentação técnica

> Formatos de projeto, ciclo de build e runtime, publicação, exportação de código, fronteiras de autenticação e integração com agentes da Rogue.

[Página canônica](https://rogueon.ai/pt-br/docs)

## Escopo do produto

A Rogue é um ambiente hospedado para gerar e revisar artefatos web por meio de pedidos estruturados. Esta documentação cobre o projeto resultante, suas dependências de build e runtime, prévias versionadas, publicação e exportação. Ela distingue capacidades do ambiente web e serviços usados pela aplicação gerada.

- [Fluxo de desenvolvimento](https://rogueon.ai/pt-br/docs/getting-started)
- [Arquitetura do projeto](https://rogueon.ai/pt-br/docs/project-architecture)

## Pedido, artefato e publicação

- Especifique saída, contrato de dados, invariantes, dependências e critérios de aceite.
- Acompanhe o estado do pedido e inspecione o artefato salvo e a prévia. Um pedido aceito não é um build concluído.
- Valide comportamento e autorização e publique a versão selecionada. Edições posteriores permanecem na prévia até outra publicação.

- [Ciclo de build e revisões](https://rogueon.ai/pt-br/docs/build-and-refine)
- [Validação de runtime](https://rogueon.ai/pt-br/docs/preview-and-testing)

## Especificações e contexto

Use especificações delimitadas com entradas, transições de estado, falhas esperadas e itens fora do escopo. Forneça arquivos ou URLs de referência com sua função declarada. Separe dados de teste e de produção e indique se o projeto precisa de persistência, identidade de usuários ou serviços externos.

- [Exemplos de especificação](https://rogueon.ai/pt-br/docs/prompting)
- [Guia de criação de sites](https://rogueon.ai/pt-br/create-website-with-ai)

## Ambiente e formatos de artefato

Sites é o fluxo para projetos web; Chat e Slides têm funções separadas. A entrada geral do app pode abrir Chat. Em Sites, um resultado salvo pode ser HTML direto ou um projeto Vite. Vite pode compilar HTML/TypeScript, uma ilha React ou uma aplicação React: inspecione `package.json`, pontos de entrada e imports em vez de assumir um framework.

- [HTML, fontes, saída de build e runtime](https://rogueon.ai/pt-br/docs/project-architecture)

## Propriedade das fontes e portabilidade

O código gerado é seu; a Rogue em si não é open source. O visualizador expõe os arquivos salvos para inspeção e cópia. Quando disponível, a exportação para GitHub entrega um projeto HTML ou Vite conforme o formato daquela versão.

Exportar código não transfere registros do banco, identidades, credenciais ou roteamento de serviços hospedados. Configure build e runtime no destino e valide antes de mover usuários. Revise o README gerado e o histórico Git antes de mudar a visibilidade do repositório.

- [Exportação e desenvolvimento externo](https://rogueon.ai/pt-br/docs/exporting)
- [Termos e Condições](https://rogueon.ai/pt-br/terms)

## Limites da publicação

Publicar seleciona o artefato revisado servido no endereço gerenciado, com hospedagem incluída. Publicar o site, enviar código ao GitHub e alterar dados no backend são operações separadas. Valide o destino em vez de inferir seu estado por uma prévia funcional.

O endereço do site na Rogue (em p.rogueon.ai) usa X-Robots-Tag: noindex. Você pode compartilhar o link público, mas esse endereço não é destinado à busca. Para aparecer na busca, ligue um domínio seu no painel do Publicar: depois que o domínio é verificado, o site nele pode ser indexado. noindex não torna uma página pública privada.

Dá para ligar um domínio que você já tem no painel do Publicar; a Rogue não vende domínios. A saída web roda no navegador; a Rogue não gera pacotes .apk ou .ipa nem publica apps nativos na App Store ou Play Store.

- [Seleção de versão e publicação](https://rogueon.ai/pt-br/docs/publishing)

## Disponibilidade e capacidade

A Rogue está em beta gratuito com limites de uso por sessão e semana. O Free é o plano em uso; o Go e o Max aparecem abaixo com preço e ainda não estão à venda. Uso da conta, limites de contexto e cotas de provedores externos são restrições distintas.

- Free: R$ 0/mês.
- Go: R$ 50/mês (em breve).
- Max 5x: R$ 250/mês (em breve).
- Max 25x: R$ 1.000/mês (em breve).

- [Capacidade e limites de pedidos](https://rogueon.ai/pt-br/docs/plans-and-limits)
- [Planos e disponibilidade](https://rogueon.ai/pt-br/pricing)

## Integração de runtime e agentes

Diferencie conectores da conta, dependências do app gerado e acesso de agentes à documentação. Um item do catálogo não estabelece uma conta conectada. Exportar o frontend não fornece autenticação hospedada ou proxies de credenciais. Valide conexão, permissões, comportamento de origem e resposta do provedor.

Os guias públicos estão disponíveis em HTML canônico e Markdown equivalente. Use a referência de integração com agentes para descoberta e interfaces de documentação suportadas; ler documentação não autoriza ações em projetos privados.

- [Fronteiras das integrações](https://rogueon.ai/pt-br/docs/integrations)
- [Autenticação e dados](https://rogueon.ai/pt-br/docs/data-and-permissions)
- [Integração com agentes](https://rogueon.ai/pt-br/docs/agent-integration)

## Diagnóstico e referências

Para relatar uma falha, inclua versão testada, ambiente, reprodução mínima, resultado esperado e observado e evidências de rede ou console sem dados sensíveis. Identifique se ocorre na prévia, no site publicado ou no projeto exportado.

- [Diagnóstico de runtime](https://rogueon.ai/pt-br/docs/troubleshooting)
- [Sobre a Rogue](https://rogueon.ai/pt-br/about)
- [Contato](https://rogueon.ai/pt-br/contact)
- [oi@rogueon.ai](mailto:oi@rogueon.ai)
- [Política de Privacidade](https://rogueon.ai/pt-br/privacy)

