go-embed-frontend

name	go-embed-frontend
description	Gerencia a integração do build estático do React dentro do binário Go usando a diretiva embed.

O que eu faço

• Contratos e Interfaces: Exijo o uso da diretiva //go:embed para incluir a pasta web/dist (output do build do React) em uma variável do tipo embed.FS. O handler HTTP deve implementar fallback para index.html em todas as rotas não encontradas (SPA routing).
• Tratamento de Erros: Trato erros de filesystem com http.NotFound para arquivos inexistentes e http.InternalServerError para falhas na leitura do embed. Nunca servir arquivos fora da pasta embedada (prevenção de path traversal).
• Exemplo de Implementação:

  // internal/web/server.go
  package web
  
  import (
      "embed"
      "net/http"
      "path"
  )
  
  //go:embed dist/*
  var frontendFS embed.FS
  
  func NewFileServer() http.Handler {
      fs := http.FS(frontendFS)
      staticHandler := http.FileServer(fs)
  
      return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
          // Trata rotas da API separadamente
          if path.Clean(r.URL.Path).StartsWith("/api/") {
              // delegate to API handler (not shown)
              return
          }
  
          // Para SPA: tenta servir arquivo estático, senão serve index.html
          if _, err := fs.Open(path.Clean(r.URL.Path)); err != nil {
              http.ServeFile(w, r, path.Join("dist", "index.html"))
              return
          }
          staticHandler.ServeHTTP(w, r)
      })
  }
  

  // main.go (exemplo de uso)
  func main() {
      mux := http.NewServeMux()
      mux.Handle("/", web.NewFileServer())
      // ... outros handlers
      http.ListenAndServe(":8080", mux)
  }