feat: implementar webapp app_compartir con visor universal, auth y purga 24h para guest

.agente/proyecto_estructura.md

@@ -9,27 +9,71 @@
 
 ```
 app_compartir/
+├── .agente/
+│   ├── ideas.md
+│   ├── infraestructura.md
+│   ├── objetivos.md
+│   ├── proyecto_errores.md
+│   ├── proyecto_estructura.md
+│   └── proyecto_memoria.md
+├── internal/
+│   ├── auth/
+│   │   └── auth.go          # Manejo de sesiones, WebControl y Google OAuth2
+│   ├── cleaner/
+│   │   └── cleaner.go       # Worker periódico de purga (24h para guest)
+│   ├── config/
+│   │   └── config.go        # Carga de configuración y .env
+│   ├── db/
+│   │   └── db.go            # SQLite DAL, esquema y consultas
+│   ├── handlers/
+│   │   └── handlers.go      # Rutas HTTP, endpoints API y renderizado HTML
+│   ├── models/
+│   │   └── models.go        # Estructuras de datos (Share, User, Session)
+│   └── storage/
+│       └── storage.go       # Slugs aleatorios, sniffing MIME y guardado en disco
+├── web/
+│   └── templates/
+│       ├── base.html        # Layout común con Tailwind CSS y FontAwesome
+│       ├── expired.html     # Mensaje informativo de archivo guest caducado (24h)
+│       ├── index.html       # Drag & Drop, pegar portapapeles y compartir texto
+│       ├── login.html       # Login con WebControl y Google OAuth
+│       ├── my_shares.html   # Panel de usuario con sus archivos permanentes
+│       └── viewer.html      # Visor universal (imágenes, video, audio, PDF, código)
+├── .env.example
+├── .gitignore
+├── go.mod
+├── go.sum
+├── main.go                  # Punto de entrada y servidor HTTP Go
+├── main_test.go             # Tests unitarios/integración (purga 24h vs permanencia)
 ├── README.md
-├── agents.md
-└── .agente/
-    ├── infraestructura.md
-    ├── proyecto_estructura.md
-    ├── proyecto_memoria.md
-    ├── proyecto_errores.md
-    ├── objetivos.md
-    └── ideas.md
+└── agents.md                # Punto de entrada del agente
 ```
 
 ---
 
-## Rutas (HTTP / CLI / eventos)
+## Rutas HTTP / Endpoints
 
 | Método | Ruta | Handler | Descripción |
 |---|---|---|---|
-| [COMPLETAR] | [COMPLETAR] | [COMPLETAR] | [COMPLETAR] |
+| `GET` | `/` | `h.Index` | Página principal de subida (drag & drop, portapapeles, texto) |
+| `POST` | `/api/upload` | `h.Upload` | Subida de archivos multipart |
+| `POST` | `/api/share-text` | `h.ShareText` | Subida rápida de notas, textos o código |
+| `GET` | `/v/{id}` | `h.View` | Visor universal de contenidos compartidos |
+| `GET` | `/d/{id}` | `h.Download` | Descarga directa forzada (`attachment`) |
+| `GET` | `/raw/{id}` | `h.Raw` | Visualización directa (`inline`) |
+| `GET` | `/qr/{id}` | `h.QR` | Generador dinámico de código QR en PNG |
+| `DELETE`| `/api/shares/{id}` | `h.DeleteShare` | Eliminación de archivo (usuario propietario) |
+| `GET` | `/login` | `h.LoginView` | Pantalla de inicio de sesión |
+| `POST` | `/login/webcontrol`| `h.WebControlLogin` | Autenticación con credenciales WebControl |
+| `GET` | `/auth/google` | `h.GoogleLogin` | Redirección OAuth a Google |
+| `GET` | `/auth/google/callback` | `h.GoogleCallback` | Retorno de autenticación OAuth Google |
+| `GET` | `/logout` | `h.Logout` | Cierre de sesión y limpieza de cookie |
+| `GET` | `/mis-archivos` | `h.MyShares` | Panel con archivos permanentes del usuario |
 
 ---
 
 ## Dependencias entre módulos
 
-[COMPLETAR]
+- `main.go` orquesta `config`, `db`, `cleaner`, `auth` y `handlers`.
+- `handlers` utiliza `storage` para guardar archivos y `qrcode` para generar códigos de acceso móvil.
+- `cleaner` consulta periódicamente `db` y elimina archivos físicos de `data/uploads/` para shares `is_guest = true` con `expires_at <= NOW()`. Las cuentas registradas son ignoradas por el cleaner.