Strip comments from backend and frontend source

Remove Go doc comments, TS/Svelte scaffold comments and explanatory
notes left over from the initial scaffold, plus a few leftover Spanish
notes in the compose file, SQL scripts and env template. Also drops
frontend/src/lib/index.ts, which only held the SvelteKit placeholder
comment and was never imported.
This commit is contained in:
2026-09-21 19:45:42 +02:00
parent a455302b80
commit 570c4acdaa
12 changed files with 2 additions and 53 deletions
-7
View File
@@ -1,4 +1,3 @@
// Package config carga la configuración del backend desde variables de entorno.
package config
import (
@@ -7,14 +6,10 @@ import (
"github.com/caarlos0/env/v11"
)
// Config agrupa toda la configuración del servidor. Los campos de Zitadel/S3
// ya están definidos aunque todavía no se usen: se conectan en las siguientes
// fases sin tener que tocar esta struct de nuevo.
type Config struct {
Env string `env:"APP_ENV" envDefault:"development"`
Port int `env:"PORT" envDefault:"8080"`
// Orígenes permitidos para CORS en desarrollo (el frontend en Vite corre en otro puerto).
CORSAllowedOrigins []string `env:"CORS_ALLOWED_ORIGINS" envSeparator:"," envDefault:"http://localhost:5173"`
DatabaseURL string `env:"DATABASE_URL" envDefault:"postgres://dockermanager:dockermanager@localhost:5432/dockermanager?sslmode=disable"`
@@ -29,11 +24,9 @@ type Config struct {
S3AccessKey string `env:"S3_ACCESS_KEY"`
S3SecretKey string `env:"S3_SECRET_KEY"`
// DockerHost vacío = usar el socket por defecto del sistema (DOCKER_HOST estándar del SDK).
DockerHost string `env:"DOCKER_HOST"`
}
// Load lee la configuración desde el entorno del proceso.
func Load() (Config, error) {
cfg := Config{}
if err := env.Parse(&cfg); err != nil {
-16
View File
@@ -1,7 +1,3 @@
// Package docker define la abstracción HostConnector: la interfaz que el
// resto del backend usa para hablar con "un host Docker", sin importarle si
// es el socket local (LocalConnector, fase 1) o un agente remoto
// (AgentConnector, cuando se añada un segundo host más adelante).
package docker
import (
@@ -13,8 +9,6 @@ import (
"github.com/docker/docker/client"
)
// Container es la representación simplificada que expone la API HTTP,
// desacoplada del tipo interno del SDK de Docker.
type Container struct {
ID string `json:"id"`
Names []string `json:"names"`
@@ -24,22 +18,15 @@ type Container struct {
Created int64 `json:"created"`
}
// HostConnector es el contrato que debe cumplir cualquier forma de hablar con
// un host Docker (local o remoto vía agente).
type HostConnector interface {
ListContainers(ctx context.Context) ([]Container, error)
Close() error
}
// LocalConnector implementa HostConnector hablando directamente con el
// socket Docker del host donde corre el backend.
type LocalConnector struct {
cli *client.Client
}
// NewLocalConnector crea un conector contra el Docker Engine local.
// Si dockerHost está vacío, usa la configuración por defecto del SDK
// (respeta la variable de entorno DOCKER_HOST si está definida).
func NewLocalConnector(dockerHost string) (*LocalConnector, error) {
opts := []client.Opt{client.FromEnv, client.WithAPIVersionNegotiation()}
if dockerHost != "" {
@@ -53,8 +40,6 @@ func NewLocalConnector(dockerHost string) (*LocalConnector, error) {
return &LocalConnector{cli: cli}, nil
}
// ListContainers devuelve todos los contenedores del host, incluidos los
// detenidos (equivalente a `docker ps -a`).
func (l *LocalConnector) ListContainers(ctx context.Context) ([]Container, error) {
list, err := l.cli.ContainerList(ctx, container.ListOptions{All: true})
if err != nil {
@@ -75,7 +60,6 @@ func (l *LocalConnector) ListContainers(ctx context.Context) ([]Container, error
return out, nil
}
// Close libera los recursos del cliente Docker subyacente.
func (l *LocalConnector) Close() error {
return l.cli.Close()
}
-4
View File
@@ -1,4 +1,3 @@
// Package httpserver contiene el router HTTP y los handlers de la API.
package httpserver
import (
@@ -13,14 +12,12 @@ import (
dockerconn "dockermanager/backend/internal/docker"
)
// Deps son las dependencias que necesitan los handlers.
type Deps struct {
Logger *slog.Logger
Docker dockerconn.HostConnector
Origins []string
}
// NewRouter construye el router HTTP con todas las rutas de la Fase 1.
func NewRouter(deps Deps) http.Handler {
r := chi.NewRouter()
@@ -47,7 +44,6 @@ func NewRouter(deps Deps) http.Handler {
return r
}
// slogRequestLogger es un middleware mínimo que registra cada request con slog.
func slogRequestLogger(logger *slog.Logger) func(http.Handler) http.Handler {
return func(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {