Arquitetura do projeto e do runtime
Identifique saídas HTML e Vite, fontes e artefatos de build e os serviços hospedados dos quais o frontend pode depender.
Nesta página
Identifique o formato gerado
A saída web da Rogue tem dois caminhos de artefato. Uma página HTML direta é entregue como index.html com os assets associados. Um projeto Vite tem fontes e etapa de build; pode usar HTML e TypeScript, uma ilha React ou uma aplicação React. Inspecione package.json e os imports reais: Vite por si só não implica React. Os arquivos salvos determinam a arquitetura recebida.
| HTML direto | Projeto Vite | |
|---|---|---|
| Fontes | index.html e assets associados. | index.html, fontes em src/ e assets em public/ conforme a versão salva. |
| Exportação GitHub | Página, assets e README. | Fontes, assets, package.json, configuração Vite/TypeScript e README. |
| Build local | Nenhuma compilação obrigatória para a página. | Scripts do package.json; saída padrão em dist/. |
| Runtime | Navegador e serviços de rede usados pelo HTML. | JavaScript/CSS compilados no navegador e serviços de rede usados pelo app. |
Fontes não são o bundle publicado
Para saídas Vite, edite as fontes no seu ambiente e gere outro build; editar dist diretamente não é uma alteração durável nas fontes. Inspecione scripts e README da versão exportada. O projeto entregue ao GitHub acrescenta scripts dev, build e preview, mas não recria a aplicação de servidor da Rogue.
Para HTML direto, sirva o diretório exportado para testar assets relativos e comportamento do navegador. O exemplo abaixo exige Python 3 e atende apenas na interface local. Ele verifica entrega estática, não a presença dos serviços de backend.
python3 -m http.server 8000 --bind 127.0.0.1Mapeie a fronteira entre frontend e serviços
Um projeto pode renderizar sem backend, guardar estado local no navegador ou depender de persistência e autenticação gerenciadas. São arquiteturas diferentes. Em projetos com banco, inspecione o painel de dados e o código gerado. Não infira persistência por um formulário que apenas altera estado local.
Autenticação gerenciada e chamadas com chaves de provedores podem depender de roteamento no servidor da origem da página. Copiar os arquivos do frontend para outro host não copia essas implementações, credenciais ou configuração de origem. Levante cada dependência de rede antes de escolher um destino de deploy.
Registre o contrato de deploy
- Formato, entradas das fontes, assets, comando de build e diretório de saída.
- URLs de runtime necessárias, fluxo de autenticação, origens permitidas e premissas de sessão.
- Responsável pelos dados, schema, plano de migração/exportação e testes de autorização.
- Credenciais externas, responsável pela cobrança, cotas e tratamento de falhas.
- Revisão exata das fontes e evidências de validação do artefato publicado.