Desarrollo de Software con IA

El mapa del proyecto: qué archivo hace qué y dónde está la configuración

Orientarse en la estructura de carpetas de un proyecto generado y ubicar la pieza correcta a modificar.

Todo proyecto tiene la misma forma

Cambian los nombres, no la lógica. Un proyecto generado por IA casi siempre separa: lo que se ve (frontend), lo que se procesa (backend/lógica), lo que se guarda (datos), lo que se ajusta (configuración) y lo que se pide prestado (dependencias). Si sabes en qué cajón vive cada comportamiento, señalas la ruta correcta en vez de describir síntomas.

[Los cinco cajones del proyecto]

Esta actividad interactiva ('Explicacion visual') requiere el motor completo de Lumbre. El contenido estatico se muestra arriba; para la experiencia interactiva, visita la version online de este objeto.

Un mapa real, leído en voz alta

Cada cajón responde una pregunta distinta
mi-crm/\n├── public/            # lo que el navegador descarga (html, css, js)\n│   └── index.html\n├── src/\n│   ├── routes/        # backend: QUÉ endpoints existen (GET /contactos)\n│   ├── services/      # lógica de negocio: CÓMO se valida y calcula\n│   └── models/        # datos: QUÉ forma tienen contacto, empresa, venta\n├── config/            # parámetros: a DÓNDE se conecta (base de datos, APIs)\n├── .env               # SECRETOS: credenciales que NUNCA se suben al repo\n├── package.json       # dependencias: QUÉ paquetes prestados se usan\n└── README.md          # el manual: para qué sirve y cómo arranca

Para reforzar

Las capas de una aplicación: frontend, backend y datos
OA publicado que explica las capas conceptuales. Aquí las bajamos al disco: cada capa es una carpeta que puedes señalar con el dedo.

Dónde vive cada cambio

Nombrar el archivo en tu prompt no es tecnicismo: es impedir que la IA reintervenga lo estable.
Quieres…Cajón correctoNo tocarías…
Cambiar un color del botónfrontend (public/src)los models ni el .env
Agregar un campo «empresa» al contactodatos (models) + backend (routes)los estilos
Mover la app a otra base de datosconfiguración (config / .env)la lógica de services
Cambiar el mensaje de error al guardarlógica (services)las dependencias

Prueba

Quieres que el teléfono se guarde sin espacios ni guiones. ¿En qué cajón debe vivir el cambio?

Un archivo .env suele contener contraseñas y claves, por eso no debe subirse al repositorio ni compartirse con la IA sin limpiar.

Detecta el cambio fuera de lugar

Pediste «validar que el email tenga formato correcto». La IA tocó cuatro puntos. Señala el cambio mal ubicado que no aporta la validación:

  1. En services/ agrega una funcion esEmailValido(texto).
  2. En public/styles.css cambia el color del boton a azul.
  3. En routes/ usa esEmailValido antes de guardar y devuelve 400 si falla.
  4. En models/ marca el campo email como obligatorio.

Identifica la linea con error.

Pide a la IA el árbol de carpetas de tu proyecto (solo nombres, no contenido). Asigna con una palabra qué hace cada carpeta. La próxima orden que des, señala el cajón exacto.

PistaUn mapa claro en la cabeza se convierte en prompts que la IA no puede malinterpretar.