# fer-2202/proyecto_final architecture

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

- Interactive diagram: https://gitdiagram.com/fer-2202/proyecto_final
- Repository: https://github.com/fer-2202/proyecto_final

## Overview

A continuación encontrarás una guía detallada, adaptada al proyecto “Parque Marino del Pacífico Sur”, para que elabores un diagrama de arquitectura lo más completo y preciso posible. Sigue cada paso, usa los componentes concretos de este proyecto y aplica buenas prácticas de diagramación.

##### Identificación del tipo de proyecto y su propósito
- Es una aplicación web full-stack monorepo con:
- Backend: Django REST Framework (“parque_marino” + app “api”).
- Frontend: React (Vite) con Tailwind CSS.
- Objetivo: Plataforma modular para fichas de especies, reservas de visitas, donaciones, voluntariado, transparencia y módulo educativo.

##### Principales componentes del sistema
a. Cliente (navegador web / móvil):
- React + Vite.
- Librerías: Axios (axiosInstance.js), Tailwind (estilos), Yup/Zod (validación).
- Rutas públicas y privadas (AppRouting.jsx, PrivateRoute.jsx).
- Contextos: AuthContext, LayoutTransitionContext.
b. API REST:
- Django project (“parque_marino”) + app “api”.
- Endpoints CRUD para especies, hábitats, provincias, tickets, órdenes de compra, usuarios, etc.
- Serializers, Views, URLs, permisos personalizados (permissions.py), señales (signals.py).
c. Base de datos relacional:
- Django ORM (migrations en backend/api/migrations).
- Tablas: User (con perfil extendido), Species, Habitats, ConservationStatus, Tickets, PurchaseOrders, Visits, Roles, Sections, etc.
d. Almacenamiento de archivos:
- Media local (backend/media/profile_pics) o AWS S3 (api/awsService.js sugiere integración).
e. Servicios externos:
- AWS (S3, posiblemente Cognito u otros).
- Servicio de correo (Django Email / AWS SES).
- Pasarela de pagos (para donaciones, si aplica).

##### Relaciones e interacciones
- Flujo principal:
1. El usuario abre la SPA React (assets servidos por Vite).
2. React hace peticiones HTTP al backend Django REST (axiosInstance).
3. Django procesa la lógica, accede a la BD y/o al almacenamiento de archivos.
4. Responde con JSON, React actualiza la UI.
- Autenticación:
- Login/Register –> API auth endpoints –> devuelve token JWT/session cookie –> guardado en AuthContext.
- Protected Routes (PrivateRoute) validan el contexto antes de renderizar.
- Panel Admin:
- Frontend AdminLayout hace llamadas a endpoints de administración.
- Django Admin panel (opcional) accediendo a /admin en el backend.
- Eventos asíncronos:
- Django Signals para notificaciones internas (por ejemplo, nuevas reservas).

##### Patrón arquitectónico y principios utilizados
- Frontend: SPA componentizada (Atomic + Containers), hooks personalizados, Context API para estado global.
- Backend: MVC/MTV de Django, separación clara de Models, Views, Serializers.
- API-First: todas las operaciones del frontend pasan por la REST API.
- Modularidad: cada funcionalidad (especies, voluntariado, donaciones) está encapsulada en su propio route/module.
- Buenas prácticas: validación de datos (Yup/Zod), gestión de permisos, tests unitarios (api/tests.py).

##### Cómo dibujar el diagrama paso a paso
1. Dibuja en la parte izquierda el Cliente:
- Caja “Browser / Mobile App (React + Tailwind)”
- Subcomponentes: AuthContext, AppRouting, Componentes de UI, Servicios API (axiosInstance, api/*.js).
2. En el centro, coloca el API Gateway / Backend:
- Caja “Django REST Framework”
- Subdivídela en:
- URLs & Routers (urls.py)
- Views (views.py)
- Serializers
- Models & Migrations
- Permissions & Signals
- Indica Django Admin como subcomponente opcional.
3. A la derecha, pon la Base de datos:
- Caja “PostgreSQL/MySQL”
- Lista de tablas clave (UserProfile, Species, Tickets…).
4. Debajo del backend, crea caja “Storage”:
- Media Files (Local o S3)
- Indica el flujo de subida/descarga (awsService.js).
5. Más a la derecha, dibuja “Servicios Externos”:
- AWS S3, Email Service, Payment Gateway.

##### Añade flechas y anota flujos
- Flechas “HTTP Requests/Responses” del cliente al API.
- Flechas “ORM Queries” del API a la BD.
- Flechas “PUT/GET” al Storage.
- Flechas de eventos (Signals) dentro del backend.

##### Nivel de detalle
- Etiqueta cada componente con el nombre real de la carpeta/archivo relevante (por ejemplo, “AuthContext.jsx”, “api/views.py”).
- Muestra submódulos importantes si aportan claridad (Carousel, AdminSidebar, Forms de Auth).
- No omitas los servicios AWS y medios, pues son críticos para perfil_pics y escalabilidad.

Con esta estructura y nivel de granularidad, tendrás un diagrama exhaustivo que refleje con precisión la arquitectura de “Parque Marino del Pacífico Sur”.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Client (React + Vite + Tailwind)"
        direction TB
        FE["Browser/Mobile App"]:::frontend
        ME["main.jsx"]:::frontend
        HTML["index.html"]:::frontend
        STY["index.css"]:::frontend
        API_SVC["API Services\n(axiosInstance.js,\nawsService.js,\nmodules…)"]:::frontend
        ROUTES["AppRouting.jsx\nPrivateRoute.jsx"]:::frontend
        CTX["AuthContext.jsx\nLayoutTransitionContext.jsx"]:::frontend
    end

    subgraph "Backend (Django REST Framework)"
        direction TB
        MG["manage.py"]:::backend
        DJ_PROJ["parque_marino\n(settings.py, urls.py,\nwsgi.py, asgi.py)"]:::backend
        subgraph "api (Django App)"
            direction TB
            MODELS["models.py\nmigrations/..."]:::backend
            SERS["serializers.py"]:::backend
            VIEWS["views.py"]:::backend
            URLS_B["urls.py"]:::backend
            PERM["permissions.py"]:::backend
            SIG["signals.py"]:::backend
            UTILS["utils.py"]:::backend
            ADMINPY["admin.py"]:::backend
            TESTS["tests.py"]:::backend
        end
    end

    DB["PostgreSQL/MySQL"]:::db
    Storage["Media Files\n(Local / S3)"]:::db
    subgraph "External Services"
        direction TB
        AWS["AWS S3 / SES / Cognito"]:::external
        EMAIL["Email Service"]:::external
        PAY["Payment Gateway"]:::external
    end

    %% Flows
    FE -->|"serves SPA"| ME
    ME -->|imports| HTML
    ME -->|imports| STY
    FE -->|uses| API_SVC
    FE -->|uses| ROUTES
    FE -->|uses| CTX

    API_SVC -->|"HTTP Requests"| DJ_PROJ
    DJ_PROJ -->|includes| APP
    APP -->|"ORM Queries"| DB
    APP -->|"PUT/GET Media"| Storage
    Storage -->|via awsService.js| AWS
    APP -->|"uses"| EMAIL
    APP -->|"uses"| PAY

    %% Click Events
    click FE "https://github.com/fer-2202/proyecto_final/tree/main/frontend/"
    click ME "https://github.com/fer-2202/proyecto_final/blob/main/frontend/src/main.jsx"
    click HTML "https://github.com/fer-2202/proyecto_final/blob/main/frontend/index.html"
    click STY "https://github.com/fer-2202/proyecto_final/blob/main/frontend/src/index.css"
    click API_SVC "https://github.com/fer-2202/proyecto_final/tree/main/frontend/src/api/"
    click ROUTES "https://github.com/fer-2202/proyecto_final/blob/main/frontend/src/routes/AppRouting.jsx"
    click ROUTES "https://github.com/fer-2202/proyecto_final/blob/main/frontend/src/routes/PrivateRoute.jsx"
    click CTX "https://github.com/fer-2202/proyecto_final/blob/main/frontend/src/context/AuthContext.jsx"
    click CTX "https://github.com/fer-2202/proyecto_final/blob/main/frontend/src/context/LayoutTransitionContext.jsx"
    click MG "https://github.com/fer-2202/proyecto_final/blob/main/backend/manage.py"
    click DJ_PROJ "https://github.com/fer-2202/proyecto_final/tree/main/backend/parque_marino/"
    click MODELS "https://github.com/fer-2202/proyecto_final/blob/main/backend/api/models.py"
    click URLS_B "https://github.com/fer-2202/proyecto_final/blob/main/backend/api/urls.py"
    click SERS "https://github.com/fer-2202/proyecto_final/blob/main/backend/api/serializers.py"
    click VIEWS "https://github.com/fer-2202/proyecto_final/blob/main/backend/api/views.py"
    click PERM "https://github.com/fer-2202/proyecto_final/blob/main/backend/api/permissions.py"
    click SIG "https://github.com/fer-2202/proyecto_final/blob/main/backend/api/signals.py"
    click UTILS "https://github.com/fer-2202/proyecto_final/blob/main/backend/api/utils.py"
    click ADMINPY "https://github.com/fer-2202/proyecto_final/blob/main/backend/api/admin.py"
    click TESTS "https://github.com/fer-2202/proyecto_final/blob/main/backend/api/tests.py"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef backend fill:#90EE90,stroke:#333,stroke-width:1px
    classDef db fill:#FFD580,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px
```
