En este capítulo, examinaremos más de cerca la estructura del proyecto. Mantener una estructura bien organizada se vuelve crucial a medida que construimos toda la aplicación. A continuación, describiremos los directorios y archivos clave que encontraremos en nuestro proyecto:

Archivos iniciales del proyecto

Puedes acceder a los archivos y carpetas iniciales del proyecto en Github Si eres nuevo en GitHub, sigue el sencillo proceso de dos pasos ilustrado a continuación para descargar el proyecto.

Descripción general de la estructura del proyecto

Exploración del propósito de cada directorio y archivo. La imagen a continuación proporciona una representación visual de la estructura del proyecto:

A continuación, análisis del propósito de cada directorio y archivo:

1. index.js: Punto de entrada principal de la aplicación. En este archivo se configura el servidor Express, se establecen los middleware, se definen las rutas y se inicia el servidor;

   • Inicialización de la aplicación Express;
   • Configuración de middleware, como express.json(), para el análisis de solicitudes JSON;
   • Definición de rutas y middleware para el manejo de errores;
   • Inicio del servidor Express en un puerto específico (por ejemplo, 3000).

2. routes/: Directorio que contiene las definiciones de rutas para los distintos endpoints de la API. La organización de rutas en módulos separados ayuda a mantener el código ordenado;

   • Creación de archivos de rutas independientes para diferentes funcionalidades (por ejemplo, gestión de usuarios, tweets, publicaciones, autenticación);
   • Organización y modularización del código de manejo de rutas.

3. routes/postsRoutes.js: Encargado específicamente de las rutas relacionadas con publicaciones (tweets) dentro de la aplicación;

   • Definición de rutas para crear, obtener, actualizar y eliminar publicaciones (tweets);
   • Gestión de las interacciones con el archivo de datos posts.json.

4. middlewares/: Funciones middleware almacenadas en este directorio, esenciales para tareas como validación, autenticación y autorización. Fomentan la reutilización de código;

   • Separación de funciones middleware en módulos individuales;
   • Uso de middleware para tareas como validación de datos, autenticación de usuarios y manejo de errores.

5. middlewares/validateData.js: Función middleware centrada en la validación de datos en las solicitudes entrantes. Garantiza que los datos enviados cumplan con los criterios requeridos;

   • Revisión de los datos entrantes para verificar su corrección antes del procesamiento;
   • Respuestas de error adecuadas en caso de datos inválidos o faltantes.

6. database/: Directorio que contiene el almacenamiento de datos de la aplicación;

7. database/posts.json: Archivo donde se almacenan los datos, en este caso, publicaciones, en formato JSON;

8. node_modules/: Generado automáticamente al ejecutar npm i express, este directorio contiene todas las bibliotecas y módulos externos utilizados en el proyecto;

9. package.json y package-lock.json: Archivos que enumeran todos los paquetes de los que depende el proyecto.