How fer-2202/proyecto_final works
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”.