|
|
--- |
|
|
title: Makerpage |
|
|
emoji: 🛠️ |
|
|
colorFrom: blue |
|
|
colorTo: purple |
|
|
sdk: docker |
|
|
app_file: app/main.py |
|
|
pinned: false |
|
|
--- |
|
|
|
|
|
# 🛠️ 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** con Hugging Face Datasets |
|
|
|
|
|
## 🚀 Configuración |
|
|
|
|
|
### 1. Configurar Variables de Entorno |
|
|
|
|
|
En **Settings → Repository secrets**, configura las siguientes variables: |
|
|
|
|
|
#### Variables Obligatorias |
|
|
|
|
|
| Variable | Descripción | |
|
|
|----------|-------------| |
|
|
| `SECRET_KEY` | Clave secreta de Flask (genera con: `python3 -c "import secrets; print(secrets.token_hex(32))"`) | |
|
|
|
|
|
#### Variables para Persistencia (Hugging Face Datasets) |
|
|
|
|
|
| Variable | Descripción | |
|
|
|----------|-------------| |
|
|
| `HF_TOKEN` | Token de Hugging Face con permisos de escritura ([crear aquí](https://huggingface.co/settings/tokens)) | |
|
|
| `HF_DATASET_USERS` | Nombre del dataset para usuarios (ej: `tu-usuario/makerpage-users`) | |
|
|
| `HF_DATASET_LOANS` | Nombre del dataset para préstamos (ej: `tu-usuario/makerpage-loans`) | |
|
|
|
|
|
> **Nota:** Los datasets deben ser **privados** (contienen contraseñas hasheadas). Se crearán automáticamente al guardar el primer registro. |
|
|
|
|
|
#### Variables Opcionales (Funcionalidades Adicionales) |
|
|
|
|
|
| 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 | |
|
|
|
|
|
### 2. Desplegar |
|
|
|
|
|
El Space se desplegará automáticamente al hacer push al repositorio. |
|
|
|
|
|
## 💾 Persistencia de Datos |
|
|
|
|
|
La aplicación usa **Hugging Face Datasets** para almacenamiento persistente: |
|
|
|
|
|
- ✅ **Con HF_TOKEN configurado:** Los datos se guardan en datasets privados de HF y persisten permanentemente |
|
|
- ⚠️ **Sin HF_TOKEN:** Los datos se guardan localmente en `/app/data` (temporales, se pierden al reiniciar) |
|
|
|
|
|
**Recomendación:** Configura `HF_TOKEN`, `HF_DATASET_USERS` y `HF_DATASET_LOANS` para garantizar persistencia en producción. |
|
|
|
|
|
## 🔧 Tecnologías |
|
|
|
|
|
- **Backend:** Flask + Flask-SocketIO |
|
|
- **Autenticación:** Flask-Login |
|
|
- **Notificaciones:** Telegram Bot API |
|
|
- **Email:** Resend API |
|
|
- **Integración:** GitLab API |
|
|
- **Persistencia:** Hugging Face Datasets (con fallback a JSON local) |
|
|
- **Despliegue:** Docker + Gunicorn + Eventlet |
|
|
|
|
|
## 📝 Licencia |
|
|
|
|
|
Este proyecto es de código abierto. |
|
|
|
