DEV Community

Cover image for 🌐** Estructuras de Carpetas en Proyectos Web: Una Guía al Estilo de Los Sims**
Orli Dun
Orli Dun

Posted on

🌐** Estructuras de Carpetas en Proyectos Web: Una Guía al Estilo de Los Sims**

¡Hola Chiquis! 👋🏻 ¡Vamos a hacer un viaje por el mundo de las estructuras de carpetas en un proyecto web! Imagina que estás jugando a Los Sims, ese videojuego increíblemente adictivo donde puedes construir y personalizar tu propia casa. Ahora, imagina que cada habitación de tu casa en Los Sims es una carpeta en tu proyecto web. 🏡 Cada habitación tiene un propósito: la cocina para cocinar, el dormitorio para dormir, y así sucesivamente. En el desarrollo web, las carpetas son como las habitaciones de una casa, cada una con su propio propósito y contenido.

Image description

Imagina que tu proyecto web es una casa en Los Sims. 🏡 Cada carpeta es una habitación diseñada con un propósito específico. Al igual que no pondrías una cama en el baño, no mezclarías scripts de JavaScript con imágenes. Y al igual que una casa bien organizada te permite encontrar lo que necesitas rápidamente, una estructura de carpetas bien pensada hace que tu proyecto sea fácil de entender y mantener.

Las estructuras de carpetas en proyectos web 💻 pueden organizarse de varias maneras, pero una práctica común es la arquitectura de gritos (screaming architecture), que sugiere estructurar los proyectos de manera que las carpetas "griten" su propósito y contenido. Aquí hay algunas formas de organizar las carpetas:

🌳 Carpeta raíz
Es como el terreno donde se construye la mansión. Aquí se encuentran los archivos principales del proyecto, como el index.html y el archivo CSS principal.

📁 Por Tipo
Agrupar archivos por su tipo, como componentes, contextos y hooks. Ideal para proyectos pequeños o al inicio de uno más grande:

  • Componentes: Para componentes reutilizables. Aquí es donde se almacenan todos los componentes de la interfaz de usuario, como botones, tarjetas, barras de navegación, etc.
  • Servicios: Esta carpeta contiene todos los servicios, como las llamadas a la API, las funciones de utilidad, etc.
  • Modelos: Aquí es donde se definen los modelos de datos.

└── src/ 
    ├── components/ 
    ├── contexts/ 
    └── hooks/
Enter fullscreen mode Exit fullscreen mode

Al igual que en una casa donde separas los objetos por su tipo (cubiertos en la cocina, ropa en el armario), puedes organizar tus archivos por tipo:

  • CSS/: Para estilos.
  • JS/: Para scripts.
  • Images/: Para imágenes.
  • Pages/: Cada página con su vista principal y componentes específicos.
  • Utils/: Funciones de utilidad comunes.

Image description

Imagina que tienes una habitación para cada tipo de mueble en tu casa de Los Sims. Una habitación para sillas, otra para mesas, otra para lámparas, etc. En un proyecto web, esto sería similar a tener una carpeta para cada tipo de archivo: una para componentes, otra para servicios, otra para modelos, etc.

Es como la bodega de la mansión. Aquí se guardan todos los archivos por su tipo, como imágenes, scripts, estilos (CSS) y código fuente.

📂 Por Módulo o Funcionalidad
Organizar por páginas o módulos, con carpetas globales para contextos, hooks, etc. Perfecta para proyectos de escala mayor:
Cada módulo (como autenticación, perfil de usuario, administración, etc.) tiene su propia carpeta.

Dentro de cada carpeta de módulo, puedes tener subcarpetas para componentes, servicios, modelos, etc., según sea necesario.

└── src/ 
    ├── pages/ 
    ├── components/ 
    └── contexts/
Enter fullscreen mode Exit fullscreen mode

Si tu proyecto es como una casa grande, podrías tener una habitación para invitados, otra para juegos, etc. En un proyecto web, esto se traduce en módulos:

  • UserAuth/: Para autenticación de usuarios.
  • ProductCatalog/: Para el catálogo de productos.
  • PaymentGateway/: Para el procesamiento de pagos.
  • Billing/: Procesos de facturación y pagos.
  • Analytics/: Análisis y seguimiento de datos.

Ahora, imagina que en lugar de organizar tus muebles por tipo, los organizas por habitaciones. Tienes una habitación (módulo) para la cocina, otra para el dormitorio, otra para el baño, etc. Cada habitación tiene sus propios muebles (archivos). En un proyecto web, esto sería similar a tener una carpeta para cada módulo o funcionalidad, como autenticación, perfil de usuario, administración, etc.

Es como cada sección de la mansión, como la cocina, el baño o el gimnasio. Aquí se encuentran los archivos relacionados con un módulo específico del sitio web, como la sección de productos, la sección de contacto o la sección de blog.

Image description

📑 Por Features
Agrupar por características, colocando componentes relacionados, contextos y hooks juntos.
Cada característica (como búsqueda de usuarios, gestión de publicaciones, notificaciones, etc.) tiene su propia carpeta.
Dentro de cada carpeta de características, puedes tener subcarpetas para componentes, servicios, modelos, etc., según sea necesario.

└── src/ 
    ├── featureA/ 
    ├── featureB/ 
    └── featureC/
Enter fullscreen mode Exit fullscreen mode

En Los Sims, puedes tener una zona de entretenimiento con juegos, libros y música. En un proyecto web, organizas por características o "features":

  • Search/: Para la búsqueda en el sitio.
  • ContactForm/: Para el formulario de contacto.
  • Dashboard/: Para el panel de administración.

Esta es una evolución de la estructura por módulo. Imagina que además de tener habitaciones para la cocina, el dormitorio y el baño, también tienes habitaciones para actividades específicas, como una sala de juegos o un gimnasio en casa. En un proyecto web, esto sería similar a tener una carpeta para cada característica, como búsqueda de usuarios, gestión de posts, notificaciones, etc.

Es como cada detalle de la mansión, como la estufa en la cocina, la ducha en el baño o la máquina de pesas en el gimnasio. Aquí se encuentran los archivos relacionados con una función específica del sitio web, como el carrito de compras, el formulario de registro o el reproductor de video.

📢 Screaming Architecture
La estructura de carpetas refleja claramente el propósito y el dominio del proyecto.
Puedes tener carpetas para diferentes capas de tu aplicación, como la capa de dominio, la capa de infraestructura, la capa de aplicación, etc.

La arquitectura de gritos se enfoca en la estructuración de un proyecto basado en características, lo que facilita la localización y el mantenimiento de las partes relacionadas del código. Es especialmente útil en proyectos grandes, donde la claridad y la facilidad de navegación son esenciales.

La Screaming Architecture es como una casa diseñada específicamente para una función, como una biblioteca o una pizzería. Se nota su propósito de inmediato. En un proyecto web, la estructura de carpetas debe reflejar claramente la función del proyecto.

Image description

En Los Sims, esto sería como si tu casa gritara su propósito a los cuatro vientos. Si alguien ve tu casa, inmediatamente sabe que es una casa de playa, una mansión, un apartamento urbano, etc. En un proyecto web, una "Screaming Architecture" es una estructura de carpetas que refleja claramente el propósito y el dominio del proyecto. No importa si estás usando React, Vue, Angular o cualquier otro framework, la estructura de tu proyecto debería poder probarse (testearse) sin haber tomado aún esas decisiones.

Es como el diseño estructural de la mansión, que debe ser sólido y eficiente para soportar el peso de la construcción. Esta arquitectura define cómo se organizan los archivos y carpetas para garantizar un rendimiento óptimo del sitio web.

Aquí tienes más ejemplos de carpetas para estructurar tu proyecto web:
📑 Atomic Design
Organiza los componentes visuales en niveles atómicos:

  • Atoms/: Los elementos más pequeños, como botones.
  • Molecules/: Grupos de átomos que funcionan juntos, como formularios.
  • Organisms/: Conjuntos de moléculas que forman secciones de una interfaz.

📢 Estructura Hexagonal
Para proyectos que necesitan una clara separación entre la lógica de negocio y la interfaz:

  • Core/: La lógica de negocio central.
  • Adapters/: Conectores para diferentes tipos de entrada/salida.
  • Infrastructure/: Configuraciones y soporte técnico.

¿Por qué es importante la estructura de carpetas? 🏗️

  • Orden y claridad: Al igual que una mansión bien organizada facilita la vida de los Sims, una estructura de carpetas bien definida te permite encontrar lo que necesitas rápidamente, evitando el caos y la frustración.
  • Colaboración efectiva: Si trabajas en equipo en un proyecto web, una estructura de carpetas clara y consistente facilita la colaboración y evita confusiones. Todos sabrán dónde encontrar cada archivo y cómo encaja en el conjunto.
  • Mantenimiento sencillo: A medida que tu proyecto web crece, una buena estructura de carpetas te ayudará a mantenerlo organizado y actualizado. Agregar nuevas funciones, corregir errores o realizar cambios será mucho más fácil si todo está bien clasificado.

Image description

Consejos para crear una estructura de carpetas efectiva 🏗️🎮

  • Utiliza nombres descriptivos: Asigna nombres claros y concisos a las carpetas y archivos para que sea fácil identificar su contenido.
  • Organiza por función: Agrupa los archivos relacionados por su función en carpetas específicas.
  • Crea una jerarquía lógica: Utiliza subcarpetas para crear una estructura jerárquica que refleje la organización del sitio web.
  • Mantén la consistencia: Sigue la misma estructura de carpetas en todos los proyectos web que realices.
  • Documenta tu estructura: Crea un archivo README que describa la estructura de carpetas y explique cómo se organiza el proyecto.

Estos ejemplos te ayudarán a mantener tu proyecto web tan organizado y funcional como una ciudad bien planificada en Los Sims. ¡Espero que estos ejemplos te inspiren a crear una estructura de carpetas que haga que tu código sea tan habitable y agradable como una casa bien diseñada en tu juego favorito! 🏠💻

Así que, al igual que en Los Sims, donde puedes personalizar tu casa para que se adapte a tus necesidades y refleje tu estilo, también puedes y debes personalizar la estructura de carpetas de tu proyecto web para que se adapte a las necesidades de tu proyecto y refleje claramente su propósito. ¡Feliz construcción! 👷‍♀️👷‍♂️

Conclusión 🍀 Al igual que un buen diseño de interiores en Los Sims crea una mansión funcional y estéticamente agradable, una buena estructura de carpetas en un proyecto web crea un sitio web organizado, eficiente y escalable. ¡Sigue estos consejos y organiza tu proyecto web como un verdadero Sim Maestro!

🚀 ¿Te ha gustado? Comparte tu opinión.
Artículo completo, visita: https://lnkd.in/ewtCN2Mn
https://lnkd.in/eAjM_Smy 👩‍💻 https://lnkd.in/eKvu-BHe 
https://dev.to/orlidev ¡No te lo pierdas!

Referencias: 
Imágenes creadas con: Copilot (microsoft.com)

PorUnMillonDeAmigos #LinkedIn #Hiring #DesarrolloDeSoftware #Programacion #Networking #Tecnologia #Empleo #FolderStructure

Image description

Image description

Top comments (0)