password recuperation scripts

HUGGINGFACE_PERSISTENCE.md

@@ -0,0 +1,148 @@
+# Persistencia de Datos en Hugging Face Spaces
+
+## ⚠️ Problema
+
+Hugging Face Spaces **NO soporta volúmenes persistentes**. Cuando el Space se reinicia (por inactividad, actualización, o manualmente), todos los datos en `/app/data` se pierden.
+
+## 🔄 Soluciones para Producción
+
+### Opción 1: Hugging Face Datasets (Recomendado)
+
+Usar Hugging Face Datasets como almacenamiento persistente:
+
+```python
+from datasets import Dataset, load_dataset
+import json
+
+class UserManager:
+    def __init__(self, dataset_name="tu-usuario/makerpage-users"):
+        self.dataset_name = dataset_name
+        try:
+            self.dataset = load_dataset(dataset_name, split="train")
+            self.users = self.dataset.to_dict()['data']
+        except:
+            self.users = []
+    
+    def save(self):
+        """Guarda en Hugging Face Dataset"""
+        dataset = Dataset.from_dict({"data": [self.users]})
+        dataset.push_to_hub(self.dataset_name, private=True)
+```
+
+**Ventajas:**
+- ✅ Gratuito
+- ✅ Integrado con HF
+- ✅ Persistencia garantizada
+
+**Desventajas:**
+- ❌ Requiere token de HF con permisos de escritura
+- ❌ Más lento que archivos locales
+
+**Variables de entorno adicionales:**
+- `HF_TOKEN` - Token de Hugging Face con permisos de escritura
+- `HF_DATASET_NAME` - Nombre del dataset (ej: `tu-usuario/makerpage-users`)
+
+---
+
+### Opción 2: MongoDB Atlas (Recomendado para Producción)
+
+Usar MongoDB Atlas (gratis hasta 512MB):
+
+```python
+from pymongo import MongoClient
+import os
+
+class UserManager:
+    def __init__(self):
+        mongo_uri = os.getenv("MONGODB_URI")
+        self.client = MongoClient(mongo_uri)
+        self.db = self.client.makerpage
+        self.collection = self.db.users
+    
+    def add_user(self, username, password, email, status="PENDING"):
+        user = {
+            "id": str(uuid.uuid4()),
+            "username": username,
+            "email": email,
+            "password": generate_password_hash(password),
+            "status": status,
+            "reset_token": None,
+            "reset_expiry": None
+        }
+        self.collection.insert_one(user)
+        return True
+    
+    def get_by_username(self, username):
+        return self.collection.find_one({"username": username})
+```
+
+**Ventajas:**
+- ✅ Persistencia real
+- ✅ Escalable
+- ✅ Mejor rendimiento
+- ✅ Gratis hasta 512MB
+
+**Configuración:**
+1. Crear cuenta en [MongoDB Atlas](https://www.mongodb.com/cloud/atlas)
+2. Crear cluster gratuito
+3. Obtener connection string
+4. Agregar en HF Secrets: `MONGODB_URI=mongodb+srv://...`
+
+---
+
+### Opción 3: PostgreSQL (Render/Supabase)
+
+Usar PostgreSQL gratuito:
+
+```python
+import psycopg2
+import os
+
+class UserManager:
+    def __init__(self):
+        self.conn = psycopg2.connect(os.getenv("DATABASE_URL"))
+        self._create_tables()
+    
+    def _create_tables(self):
+        with self.conn.cursor() as cur:
+            cur.execute("""
+                CREATE TABLE IF NOT EXISTS users (
+                    id VARCHAR PRIMARY KEY,
+                    username VARCHAR UNIQUE,
+                    email VARCHAR UNIQUE,
+                    password VARCHAR,
+                    status VARCHAR,
+                    reset_token VARCHAR,
+                    reset_expiry TIMESTAMP
+                )
+            """)
+            self.conn.commit()
+```
+
+**Servicios gratuitos:**
+- [Supabase](https://supabase.com) - 500MB gratis
+- [Render](https://render.com) - PostgreSQL gratis
+
+---
+
+## 🎯 Recomendación
+
+| Caso de Uso | Solución Recomendada |
+|-------------|---------------------|
+| **Desarrollo/Pruebas** | Archivos JSON (actual) |
+| **Producción Pequeña** | MongoDB Atlas |
+| **Producción Grande** | PostgreSQL + Supabase |
+| **Integración HF** | Hugging Face Datasets |
+
+## 📝 Configuración Actual
+
+El código actual usa archivos JSON en `/app/data/`:
+- ✅ Funciona para desarrollo y pruebas
+- ⚠️ Los datos son **temporales** (se pierden al reiniciar)
+
+Para producción, implementa una de las soluciones anteriores modificando las clases `UserManager` y `LoanManager` en `app/main.py`.
+
+## 🔧 Variables de Entorno en HF Spaces
+
+Configura las variables en **Settings → Repository secrets** (no necesitas archivo `.env`).
+

README.md

@@ -1,11 +1,53 @@
----
-title: makerspacepage
-emoji: 🏢
-colorFrom: green
-colorTo: yellow
-sdk: docker
-pinned: false
-short_description: Makerspace page server
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🛠️ Makerpage - Sistema de Gestión Maker Space
+
+Aplicación web para gestionar préstamos de herramientas y proyectos en un Maker Space, con integración de Telegram para notificaciones y aprobaciones.
+
+## 🌟 Características
+
+- 📝 **Registro y autenticación de usuarios** con aprobación por administrador
+- 🔐 **Recuperación de contraseña** vía email
+- 🛠️ **Sistema de préstamos** de herramientas y dispositivos
+- 📱 **Integración con Telegram** para notificaciones y aprobaciones en tiempo real
+- 📊 **Gestión de proyectos GitLab**
+- 💾 **Persistencia de datos** en archivos JSON
+
+## 🚀 Despliegue en Hugging Face Spaces
+
+### 1. Configurar Variables de Entorno
+
+En **Settings → Repository secrets**, configura las siguientes variables:
+
+| Variable | Descripción |
+|----------|-------------|
+| `TELEGRAM_TOKEN` | Token de tu bot de Telegram |
+| `TELEGRAM_CHAT_ID` | ID del chat para notificaciones |
+| `GOOGLE_PROXY_URL` | URL del proxy de Google Script |
+| `GITLAB_TOKEN` | Token de acceso personal de GitLab |
+| `GITLAB_GROUP_ID` | ID del grupo de GitLab |
+| `RESEND_API_KEY` | API key de Resend para emails |
+| `FROM_EMAIL` | Email remitente verificado en Resend |
+| `SECRET_KEY` | Clave secreta de Flask |
+
+### 2. Desplegar
+
+El Space se desplegará automáticamente al hacer push al repositorio.
+
+## ⚠️ Persistencia de Datos
+
+> **Importante:** Hugging Face Spaces NO soporta volúmenes persistentes. Los datos se guardan temporalmente en `/app/data` pero se perderán al reiniciar el Space.
+
+Para producción, considera implementar una solución de persistencia externa. Ver [HUGGINGFACE_PERSISTENCE.md](HUGGINGFACE_PERSISTENCE.md) para opciones.
+
+## 🔧 Tecnologías
+
+- **Backend:** Flask + Flask-SocketIO
+- **Autenticación:** Flask-Login
+- **Notificaciones:** Telegram Bot API
+- **Email:** Resend API
+- **Integración:** GitLab API
+- **Persistencia:** JSON (temporal en HF Spaces)
+- **Despliegue:** Docker + Gunicorn + Eventlet
+
+## 📝 Licencia
+
+Este proyecto es de código abierto.

app/main.py

@@ -45,7 +45,10 @@ class User(UserMixin):
 class UserManager:
     """Clase para manejar los usuarios en un archivo JSON."""
     def __init__(self, filename="users.json"):
-        self.filename = filename
+        # Usar directorio de datos configurable (para volúmenes Docker)
+        data_dir = os.getenv("DATA_DIR", "/app/data")
+        os.makedirs(data_dir, exist_ok=True)
+        self.filename = os.path.join(data_dir, filename)
         self.users = self._load()
 
     def _load(self):
@@ -166,7 +169,10 @@ def load_user(user_id):
 class LoanManager:
     """Clase para manejar la persistencia de préstamos en un archivo JSON."""
     def __init__(self, filename="prestamos.json"):
-        self.filename = filename
+        # Usar directorio de datos configurable (para volúmenes Docker)
+        data_dir = os.getenv("DATA_DIR", "/app/data")
+        os.makedirs(data_dir, exist_ok=True)
+        self.filename = os.path.join(data_dir, filename)
         self.loans = self._load()
 
     def _load(self):