{"id":22038814,"url":"https://github.com/antgom/too-red","last_synced_at":"2026-04-11T10:09:00.235Z","repository":{"id":297417897,"uuid":"891031276","full_name":"AntGom/Too-Red","owner":"AntGom","description":"Red social realizada con MERN stack. Publicaciones, subida de archivos, comentarios, etiquetas, seguimiento de usuarios, likes, chat...","archived":false,"fork":false,"pushed_at":"2025-12-30T07:33:42.000Z","size":401,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-03T12:25:13.339Z","etag":null,"topics":["cache-service","express-js","html5","javascript","jwt-authentication","lazy-loading","mern-stack","mongodb","mongoose","node-js","react","react-router","socket-io","tailwind-css","vite"],"latest_commit_sha":null,"homepage":"https://too-red.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AntGom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-11-19T15:54:10.000Z","updated_at":"2025-12-30T07:33:46.000Z","dependencies_parsed_at":"2025-06-06T18:45:37.626Z","dependency_job_id":null,"html_url":"https://github.com/AntGom/Too-Red","commit_stats":null,"previous_names":["antgom/too-red"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AntGom/Too-Red","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntGom%2FToo-Red","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntGom%2FToo-Red/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntGom%2FToo-Red/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntGom%2FToo-Red/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AntGom","download_url":"https://codeload.github.com/AntGom/Too-Red/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AntGom%2FToo-Red/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31676372,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-11T08:18:19.405Z","status":"ssl_error","status_checked_at":"2026-04-11T08:17:08.892Z","response_time":54,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cache-service","express-js","html5","javascript","jwt-authentication","lazy-loading","mern-stack","mongodb","mongoose","node-js","react","react-router","socket-io","tailwind-css","vite"],"created_at":"2024-11-30T11:08:13.325Z","updated_at":"2026-04-11T10:09:00.228Z","avatar_url":"https://github.com/AntGom.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Too-Red - Red social \n\n![Logo Too-Red](./front-too-red/public/nuevoLogoLargo.webp)\n\n## 📚 Índice\n\n- Descripción del Proyecto\n- Características Principales\n- Decisiones Técnicas\n- Funcionalidades Destacadas\n- Despliegue\n- Estructura del proyecto\n- Optimizaciones de rendimiento\n- Consideraciones de Seguridad\n- Mejoras futuras\n- Instalación y ejecución\n- Variables de entorno\n- Enlaces útiles\n\n\n## 📝 Descripción del Proyecto\n\nToo-Red es una red social completa y funcional. La plataforma permite a los usuarios conectar con amigos, compartir publicaciones, interactuar a través de comentarios, likes y etiquetas, además de chatear en tiempo real. La aplicación cuenta con un frontend en React y un backend en Node.js/Express con MongoDB.\n\n## Características Principales\n\n### Sistema de Usuarios\n- **Registro y autenticación**: Sistema completo con verificación por email\n- **Perfiles personalizables**: Imagen de perfil, biografía e intereses\n- **Sistema de seguimiento**: Seguir a otros usuarios y ver su contenido\n- **Eliminación lógica**: Período de suspensión de 30 días antes del borrado definitivo\n- **Recuperación de cuentas**: Opción para recuperar cuentas en proceso de eliminación\n\n### Publicaciones\n- **Creación de publicaciones**: Con texto e imágenes\n- **Sistema de etiquetado**: Posibilidad de etiquetar a usuarios seguidos\n- **Comentarios**: Añadir, ver, editar y eliminar comentarios en publicaciones\n- **Likes**: Sistema de \"me gusta\" en publicaciones\n- **Feed personalizado**: Contenido filtrado según seguidos e intereses similares\n\n### Mensajería en Tiempo Real\n- **Chat privado**: Comunicación en tiempo real entre usuarios\n- **Indicadores de estado**: Muestra si los usuarios están en línea\n- **Confirmación de lectura**: Doble check cuando los mensajes son leídos\n- **Compartir archivos**: Posibilidad de enviar imágenes y archivos\n\n### Moderación de Contenido\n- **Sistema de reportes**: Los usuarios pueden denunciar publicaciones inapropiadas\n- **Panel de administración**: Los administradores pueden revisar y gestionar denuncias\n- **Suspensión de cuentas**: Capacidad para banear usuarios que infringen las normas\n\n### Características Técnicas\n- **Diseño responsive**: Adaptable a todos los dispositivos\n- **Arquitectura escalable**: Separación clara de responsabilidades\n- **Seguridad**: Protección contra inyecciones y autenticación robusta\n- **Optimización de rendimiento**: Técnicas para mejorar la velocidad de carga\n\n## 🛠️ Decisiones Técnicas\n\n### 🎨 Frontend\n\n#### Interfaz de Usuario\n- **React**: Biblioteca principal para la construcción de la interfaz\n- **TailwindCSS**: Framework de CSS utilizado para estilos y responsive\n- **HeroIcons**: Biblioteca de iconos SVG para elementos visuales\n- **React Router**: Gestión de rutas en la aplicación SPA\n- **react-time-ago**: Para mostrar fechas relativas (ej. \"hace 5 minutos\")\n- **clsx**: Utilidad para combinar clases CSS condicionales\n\n#### Gestión de Estado\n- **Context API**: Para el manejo de estado global (Auth, Counters, Toast)\n- **useState/useEffect**: Hooks de React para el estado local y efectos secundarios\n- **Custom Hooks**: Hooks personalizados para reutilización de lógica\n\n#### Optimización de Rendimiento\n- **Sistema de caché personalizado**: Almacena datos en localStorage con tiempo de expiración\n- **LazyImage**: Componente personalizado para carga diferida de imágenes\n- **Scroll infinito**: Implementado con IntersectionObserver para cargar contenido\n- **Debounce**: Utilizado en búsquedas para limitar peticiones al servidor\n\n#### Comunicación en Tiempo Real\n- **Socket.io-client**: Implementación de WebSockets para chat en tiempo real\n- **Eventos personalizados**: Sistema de eventos para comunicación entre componentes\n\n#### Notificaciones\n- **Sistema de Toast**: Componente personalizado para mostrar notificaciones\n\n\n### 🧠 Backend\n\n#### Arquitectura\n- **Node.js/Express**: Plataforma y framework para el backend\n- **MongoDB**: Base de datos NoSQL para almacenamiento de datos\n- **Mongoose**: ODM para MongoDB, incluyendo paginación con mongoose-paginate-v2\n\n#### Autenticación y Seguridad\n- **JWT (jsonwebtoken)**: Tokens para autenticación\n- **bcrypt**: Cifrado de contraseñas\n- **Middleware personalizado**: Protección de rutas y verificación de roles\n\n#### Almacenamiento\n- **Cloudinary**: Servicio para almacenamiento de imágenes y archivos\n- **express-fileupload**: Gestión de subida de archivos\n\n#### Comunicación\n- **Socket.io**: Implementación de WebSockets para comunicación en tiempo real\n- **Nodemailer**: Envío de correos electrónicos transaccionales\n\n#### Optimización\n- **Filtrado de elementos eliminados**: Middleware personalizado para filtrar entidades borradas lógicamente\n\n## 🌐 Despliegue\n\nEl proyecto está desplegado en:\n\n- **Frontend**: [Vercel](https://vercel.com/)\n- **Backend**: [Render](https://render.com/)\n- **Base de datos**: [MongoDB Atlas](https://www.mongodb.com/es/atlas)\n- **App web**: [Too-Red](https://too-red.vercel.app//)\n\n\n## 🚀 Funcionalidades Destacadas\n\n### 🏷️ Sistema de etiquetado de usuarios\nPermite etiquetar a usuarios en publicaciones mediante un modal dedicado:\n\n### 🚩 Denuncias y moderación\nLos usuarios pueden denunciar contenido inapropiado, que será revisado por los administradores:\n\n\n### 🔐♻️ Eliminación lógica y recuperación de cuentas\nLas cuentas se marcan como eliminadas pero se mantienen 30 días antes de su eliminación física:\n\n\n### 🧨🗓️ Borrado físico programado\nUtilizando cron jobs para eliminar definitivamente las cuentas marcadas como borradas:\n\n\n### 👥 Gestión de usuarios\nLos administradores pueden banear usuarios que infringen las normas:\n\n\n### 📩 Mensajería en tiempo real\nImplementación de chat con indicadores de lectura y estado en línea:\n\n\n## 🏗️ Estructura del Proyecto\n\n```\nTOO-RED/\n├── api-too-red/            # Backend (Node.js/Express)\n│   ├── controllers/        # Lógica de negocio\n│   ├── database/           # Conexión a BBDD\n│   ├── helpers/            # Validación de campos\n│   ├── middlewares/        # Middlewares personalizados\n│   ├── models/             # Modelos de datos (Mongoose)\n│   ├── routes/             # Definición de rutas API\n│   ├── services/           # Servicios reutilizables\n│   └── index.js            # Punto de entrada\n│\n└── front-too-red/          # Frontend (React/Vite)\n    ├── public/             # Recursos estáticos\n    └── src/\n        ├── assets/         # Imágenes y recursos\n        ├── components/     # Componentes React\n        ├── context/        # Contextos globales\n        ├── helpers/        # Utilidades y funciones auxiliares\n        ├── hooks/          # Hooks personalizados\n        ├── router/         # Configuración de rutas\n        ├── App.jsx\n        ├── Main.jsx\n        └── index.html\n```\n\n## ⚙️ Optimizaciones de Rendimiento\n\n- **Carga diferida de imágenes**: Componente LazyImage con IntersectionObserver\n- **Caché de datos**: Sistema para almacenar respuestas API y reducir peticiones\n- **Paginación**: Implementación de scroll infinito para cargar datos bajo demanda\n- **Debounce**: Retraso en búsquedas para reducir peticiones al servidor\n- **Eliminación lógica**: Uso de flags en lugar de eliminar registros físicamente\n- **WebSockets eficientes**: Conexiones optimizadas para mensajería en tiempo real\n\n## 🔐 Consideraciones de Seguridad\n\n- **Cifrado de contraseñas**: Uso de bcrypt para almacenamiento seguro\n- **JWT con expiración**: Tokens de acceso con tiempo limitado\n- **Validación de datos**: Verificación de entradas del usuario\n- **Protección CORS**: Configuración adecuada de Cross-Origin Resource Sharing\n- **Permisos granulares**: Verificación de propiedad/rol antes de permitir acciones\n- **Protección contra XSS**: Sanitización de datos ingresados por usuarios\n\n## 🧱 Mejoras Futuras\n\n- Implementación de PWA para experiencia móvil mejorada\n- Notificaciones push que fomenten la interacción\n- Sistema de grupos/comunidades\n\n## 🔧 Instalación y Ejecución\n\n### Requisitos previos\n- Node.js \u003e= 14.x\n- MongoDB\n- Cuenta en Cloudinary (para almacenamiento de imágenes)\n- Servicio SMTP para envío de correos\n- MongoDB Atlas o una instancia local de MongoDB\n\n### 1. Clona el repositorio\n```bash\ngit clone https://github.com/AntGom/Too-Red\ncd too-red\n```\n### 2. Instalación del Backend\n```bash\ncd api-too-red\nnpm install\nnpm run dev\n```\n\u003e El backend estará disponible en `http://localhost:3900`\n---\n\n### 3. Instalación del Frontend\nEn otra terminal:\n```bash\ncd ../front-too-red\nnpm install\nnpm run dev\n```\n\u003e El frontend estará disponible en `http://localhost:3000`\n---\n\n## 📋 Variables de Entorno Requeridas\n\n### Backend (.env)\n```\nPORT=3900\nMONGO_URI=mongodb://...\nJWT_SECRET=your_secret_key\nJWT_EXP=30d\nCLIENT_URL=http://localhost:3000\nADMIN_EMAIL=admin@example.com\nSMTP_HOST=\nSMTP_PORT=\nSMTP_USER=\nSMTP_APIKEY=\nCLOUDINARY_CLOUD_NAME=\nCLOUDINARY_API_KEY=\nCLOUDINARY_API_SECRET=\n```\n### Frontend (.env)\n```\nVITE_API_URL=http://localhost:3900/api/\n```\n## 🔗 Enlaces útiles\n\n- [Too-Red](https://too-red.vercel.app//)\n- [Heroicons](https://heroicons.com/)\n- [Cloudinary](https://cloudinary.com/)\n\n## 👤 Autor\n\nDesarrollado por Antonio Gómez © 2025. Desde Andalucía, con ❤.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantgom%2Ftoo-red","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fantgom%2Ftoo-red","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantgom%2Ftoo-red/lists"}