# naatiworlds/recetagram architecture

> Architecture diagram of the GitHub repository naatiworlds/recetagram, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/naatiworlds/recetagram
- Repository: https://github.com/naatiworlds/recetagram

## Overview

##### 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.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    Client["Client Browser"]:::external
    Client -->|"HTTP/HTTPS"| Frontend

    %% Frontend Layer
    subgraph "Frontend SPA (Vue 3 + Vite)"
        direction TB
        Entry["index.html"]:::frontend
        Main["src/main.js"]:::frontend
        ViteConfig["vite.config.js"]:::frontend
        Router["Vue Router"]:::frontend
        Components["Vue Components"]:::frontend
        Stores["Pinia Stores"]:::frontend
        Plugins["Axios Plugin"]:::frontend
        Services["API Services"]:::frontend

        Entry --> Main
        Main --> Router
        Main --> Components
        Main --> Stores
        Main --> Plugins
        Main --> Services
    end
    Frontend["Frontend SPA (Vue 3 + Vite)"]:::frontend

    %% Backend Layer
    subgraph "API Gateway / Backend (Spring Boot)"
        direction TB
        Controllers["Controllers (Auth, Users, Posts, Comments, Notifications, Admin)"]:::backend
        ServicesBE["Business Services"]:::backend
        Security["Security (JWT Filter, CORS)"]:::backend

        Controllers --> ServicesBE
        ServicesBE --> Security
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        MongoDB["MongoDB"]:::database
        CloudStorage["Cloud Storage (Images/Videos)"]:::database
        Controllers --> MongoDB
        Controllers --> CloudStorage
    end

    %% External Services
    subgraph "External Services"
        direction TB
        CDN["CDN / Frontend Hosting"]:::external
        Push["Push Notification Service"]:::external
        Frontend --> CDN
        Controllers --> Push
    end

    %% Connections
    Client --> Frontend
    Frontend -->|"REST API (JWT Auth)"| Controllers
    Controllers -->|"CRUD Operations"| MongoDB
    Controllers -->|"Upload/Download"| CloudStorage
    Controllers -->|"Push Notifications"| Push

    %% Click Events
    click Entry "https://github.com/naatiworlds/recetagram/blob/main/index.html"
    click Main "https://github.com/naatiworlds/recetagram/blob/main/src/main.js"
    click ViteConfig "https://github.com/naatiworlds/recetagram/blob/main/vite.config.js"
    click Router "https://github.com/naatiworlds/recetagram/blob/main/src/router/index.js"
    click Router "https://github.com/naatiworlds/recetagram/blob/main/src/router/router.js"
    click Components "https://github.com/naatiworlds/recetagram/tree/main/src/components/"
    click Components "https://github.com/naatiworlds/recetagram/tree/main/src/components/shared/"
    click Stores "https://github.com/naatiworlds/recetagram/tree/main/src/stores/"
    click Plugins "https://github.com/naatiworlds/recetagram/blob/main/src/plugins/axios.js"
    click Services "https://github.com/naatiworlds/recetagram/blob/main/src/services/api.js"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#3399ff,color:#003366
    classDef backend fill:#d4edda,stroke:#28a745,color:#155724
    classDef database fill:#fff3cd,stroke:#ffc107,color:#856404
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#343a40
```
