How naatiworlds/recetagram works
Identificación del proyecto
• Recetagram es una aplicación web full-stack orientada a comunidad culinaria. Aunque este repositorio contiene únicamente el frontend (Vue 3 + Vite), la README describe un backend en Spring Boot con MongoDB, autenticado vía JWT y desplegado en Vercel/Netlify (frontend) y un servidor independiente (backend).
Análisis de la estructura de archivos
• src/: contenedor principal del frontend.
• components/ y shared/: componentes Vue reutilizables (UI, modales de notificación, navegación, tarjetas de post).
• pages/: vistas por ruta (Home, Login, Perfil, Panel Admin, 404 con juego).
• plugins/axios.js y services/api.js: capa de comunicación con el API REST.
• stores/: estado global gestionado con Pinia (usuarios, autenticación, comentarios, likes, notificaciones).
• router/: configuración de rutas y guardas.
• utils/: funciones auxiliares (temas, constantes, eymovement).
• Configuración de Vite (vite.config.js), estilos globales (style.css) y assets (imágenes, íconos).
Insights del README
• Backend: Spring Boot + MongoDB, autenticación con JWT, roles (admin, moderador, verificado).
• Funcionalidades clave: CRUD de posts/comentarios, likes, notificaciones, perfiles, búsqueda/filtros, eventos/desafíos, integración de video.
• Hosting: Vercel o Netlify (frontend), servidor dedicado (backend).
Componentes principales para el diagrama
a. Cliente Web (navegador móvil/desktop)
• Carga SPA (Vue 3 + Vite)
• UI/UX responsiva (Tailwind CSS opcional)
b. Capa Frontend
• Router Vue: gestión de rutas públicas y privadas
• Componentes Vue: vistas, modales, notificaciones
• Pinia Stores: estado de usuario, posts, comentarios, notificaciones
• Plugins Axios: interceptor de tokens JWT
c. API Gateway / Backend (Spring Boot)
• Controladores REST: Auth, Users, Posts, Comments, Notifications, Admin
• Servicios: lógica de negocio, roles y permisos
• Seguridad: JWT Filter, CORS
d. Base de datos (MongoDB)
• Colecciones: users, posts, comments, notifications, roles
e. Servicios externos
• Almacenamiento de medios (Cloud Storage para imágenes/videos)
• Servicio de notificaciones push (opcional)
• CDN y hosting frontend (Vercel/Netlify)
Relaciones e Interacciones
• Cliente → Frontend SPA: interacción UI, llamadas a stores y router.
• Frontend → Backend: peticiones HTTP (GET/POST/PUT/DELETE) via Axios con JWT en Authorization header.
• Backend → MongoDB: operaciones CRUD, consultas indexadas para búsquedas y estadísticas.
• Backend → Cloud Storage: subida/descarga de imágenes y videos.
• Backend → Servicio de Notificaciones: push notifications (opcional).
Patrones y principios arquitectónicos
• Separación de responsabilidades (UI, estado, lógica de negocio, persistencia)
• Arquitectura en capas (Presentación, Aplicación, Dominio, Infraestructura)
• Uso de JWT para autenticación sin estado (stateless)
• Principio de “configuración sobre convención” con Vite y Spring Boot
Esquema de diagrama vertical (orientación top-down)
• Nivel superior: “Client Browser”
• Justo debajo: “Frontend SPA (Vue 3 + Vite)”, subdividido en Router, Components, Stores, Plugins
• Nivel medio: “API Gateway / Backend (Spring Boot)”, subdividido en Controllers, Services, Security
• Nivel inferior: “Data Layer” con MongoDB y Cloud Storage
• Footer: “Servicios externos” (CDN, Notificaciones)
Para lograr un diagrama más vertical y evitar anchura excesiva, ordena cada capa una debajo de la otra, dejando espacio horizontal mínimo para subdivisiones internas.
Directrices para el dibujo
• Utilizar formas rectangulares apiladas: una por capa principal.
• Flechas direccionales:
• Cliente → Frontend
• Frontend → Backend
• Backend → MongoDB / Cloud Storage
• Etiquetar cada flecha con el tipo de protocolo (HTTP/HTTPS, WebSocket).
• Código de colores:
• Azul: Componentes UI (Frontend)
• Verde: Lógica de negocio (Backend)
• Naranja: Base de datos / Storage
• Gris: Servicios externos
• Íconos opcionales junto a cada bloque (Vue, Spring Boot, MongoDB, AWS S3, etc.)
• Añadir leyenda para roles y protocolos.
Personalización según tipo de proyecto
• Al ser un full-stack social, resalta en el diagrama los flujos CRUD de posts/comentarios y la capa de autenticación/roles.
• Muestra módulos opcionales (mensajería privada, eventos, estadísticas) como “futuras extensiones” en una sección lateral inferior o en un “Backlog”.
Con estos pasos, tendrás un diagrama vertical, claro y completo que refleje fielmente la arquitectura de Recetagram y sirva de guía al equipo de desarrollo.