El proyecto integrador del curso combina tres capas principales: una API REST construida con Flask que actúa como backend, MongoDB Atlas como base de datos en la nube, y un cliente HTTP (Postman o navegador) que oficia de frontend o herramienta de pruebas. Esta arquitectura simple pero completa refleja patrones reales de desarrollo web moderno.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/danielcruca/plataformas-abiertas-2026-2c/llms.txt
Use this file to discover all available pages before exploring further.
Componentes de la Arquitectura
- Flask REST API (backend) — servidor Python que expone rutas HTTP y procesa la lógica de negocio mediante controladores organizados como Blueprints.
- MongoDB Atlas (base de datos) — servicio de base de datos NoSQL en la nube donde se persisten y consultan los documentos JSON.
- Cliente HTTP (frontend / testing) — herramienta como Postman o un navegador web que envía requests a la API y visualiza las respuestas JSON.
Estructura de Carpetas
El proyecto de la API sigue una estructura modular que separa el punto de entrada, la configuración de la aplicación y los controladores de cada recurso.Descripción de cada archivo
| Archivo | Rol |
|---|---|
run.py | Punto de entrada. Importa la app factory y arranca el servidor Flask. |
app/__init__.py | App factory: crea la instancia de Flask, registra los Blueprints y habilita CORS. |
controllers/holamundo.py | Blueprint de ejemplo con los primeros endpoints del curso. |
data/ | Carpeta destinada a archivos de datos locales o fixtures de prueba. |
Ciclo de Vida de una Request
El siguiente flujo describe paso a paso qué sucede desde que el cliente envía una petición hasta que recibe la respuesta JSON.El cliente envía la request
Un cliente HTTP (Postman, navegador, o
curl) realiza una petición GET a una URL del servidor Flask, por ejemplo GET http://127.0.0.1:5000/holamundo-ejemplo/api/v1/holamundo.Flask resuelve la ruta mediante el Blueprint
El router de Flask busca entre las rutas registradas a través de los Blueprints y encuentra la función asociada al patrón de URL recibido.
El controlador ejecuta la lógica de negocio
La función controladora se ejecuta: puede leer o escribir datos en MongoDB Atlas, aplicar validaciones, o simplemente construir una respuesta estática.
Archivos Clave
run.py — Punto de entrada
app/__init__.py — App factory
controllers/holamundo.py — Blueprint de ejemplo
Recursos Relacionados
API Flask
Paso a paso para crear tu primera API con Flask: configuración, rutas y Blueprints.
Base de Datos
Cómo conectar tu API Flask a MongoDB Atlas usando PyMongo.