Existe una gran diferencia entre aprender tecnología como un tema abstracto y usarla para construir una solución que resuelva un problema real. Fue con esta idea que nació la aplicación. Inteligencia de Mercado, una herramienta web creada para apoyar estudios regionales de competencia, oportunidades y posicionamiento comercial.
El proyecto se desarrolló como una demostración práctica de los conceptos trabajados en los cursos. Desarrollador de aplicaciones e Inteligencia artificial, por My Robot Barra da Tijuca.
La solicitud está publicada en:
https://gray-glacier-0dc52610f.7.azurestaticapps.net/
Y el código fuente está disponible en:
https://github.com/ussantos/inteligencia-de-mercado
La idea: transformar las cuestiones empresariales en una experiencia digital
La pregunta inicial era sencilla:
¿Cómo se puede ayudar a alguien a comprender mejor una región antes de abrir, posicionar o ajustar un negocio?
En la práctica, esta cuestión implica varias otras:
- ¿Quiénes son los competidores cercanos?
- ¿Qué tipos de alternativas encuentra el cliente en la región?
- ¿La dirección elegida parece tener sentido?
- ¿El radio de operación es pequeño, amplio o saturado?
- ¿Existen barreras, oportunidades o puntos de atención?
- ¿Qué acciones comerciales se podrían priorizar?
Responder esto manualmente requiere investigación, lectura de mapas, comparación de datos y algo de pensamiento estratégico. La propuesta de la aplicación fue transformar ese proceso en un flujo guiado: el usuario ingresa el campo de actividad, una localidad de referencia, el radio de análisis y, si ya tiene una empresa existente, también puede ingresar el código postal del CNPJ y del cliente.
A partir de ahí, el sistema organiza datos públicos, consulta API externas, crea un mapa regional, identifica competidores y genera un informe con recomendaciones.
Lo que surgió del curso de desarrollador de aplicaciones
El curso de Desarrollador de Aplicaciones trabaja sobre una idea esencial: las aplicaciones no son sólo pantallas bonitas. Una app necesita tener lógica, flujo, interfaz, datos, pruebas, correcciones y mejora continua.
Este proyecto siguió exactamente esta lógica.
Antes de escribir código, era necesario pensar en el recorrido del usuario. La primera versión era más compleja: requería un login, colocaba al CNPJ como punto central y mostraba mucha información técnica. Con el tiempo, la experiencia se perfeccionó para volverla más sencilla de usar:
- iniciar sesión ya no es obligatorio;
- el CNPJ pasó a ser opcional;
- el usuario puede analizar una empresa existente o estudiar un nuevo negocio;
- el campo principal pasó a ser la rama de actividad;
- los códigos postales de los clientes sólo aparecen cuando tienen sentido;
- el informe se volvió más directo y más fácil de imprimir.
Este proceso representa una práctica de desarrollo importante: construir, probar, escuchar el comportamiento real de la aplicación y mejorar.
En el aspecto técnico, el proyecto utiliza Next.js, reaccionar, mecanografiado e Viento de cola CSS para crear la interfaz. La aplicación también cuenta con rutas API, validaciones de formularios, componentes reutilizables, un mapa interactivo, gráficos y un informe preparado para imprimir en PDF.
En otras palabras, no es sólo una página estática. Es una aplicación web completa, con entrada de datos, procesamiento, integración con servicios externos y salida estructurada para el usuario.
Lo que surgió del curso de Inteligencia Artificial
El curso de Inteligencia Artificial My Robot trabaja conceptos como IA generativa, Python, APIs, chatbots, agentes, datos, contexto y sistemas web. La aplicación de la inteligencia de mercado utiliza esta misma mentalidad: la IA no aparece como un adorno, sino como parte de un flujo mayor.
Un punto importante es que el sistema no depende simplemente de una pregunta vaga formulada a una IA. Antes de llamar a cualquier modelo, la aplicación estructura el contexto:
- rama de actividad informada por el usuario;
- dirección de referencia o código postal;
- radio de análisis;
- tipos de competidores elegidos;
- competidores encontrados en fuentes públicas;
- barreras y oportunidades observadas;
- Códigos postales del cliente, cuando se envían;
- limitaciones de las API utilizadas.
En este contexto, la IA puede ayudar a mejorar las recomendaciones, los planes de acción, el posicionamiento y la lectura estratégica. El objetivo es generar algo más útil que una respuesta genérica.
Esta es una lección central para cualquier proyecto de IA: la calidad de la respuesta depende en gran medida de la calidad del contexto. La inteligencia artificial funciona mejor cuando se le proporcionan datos organizados, una tarea bien definida y límites claros.
Datos públicos, API y automatización
El proyecto también muestra cómo las aplicaciones modernas a menudo nacen de la combinación de múltiples fuentes y servicios.
Entre los recursos utilizados se encuentran:
- API de Google Places, para buscar competidores y ubicaciones relevantes;
- API de Google Maps JavaScript, para mostrar el mapa de la región;
- UbicaciónIQ y respaldo de geocodificación, para transformar direcciones y códigos postales en coordenadas;
- Servicio de ruta abierta, cuando esté configurado, para soporte en rutas y distancias;
- PostgreSQL con Prisma, para caché, historial y uso compartido;
- Almacenamiento de blobs de Azure, para carga de archivos temporales;
- Azure Static Web Apps, para publicar la solicitud;
- OpenAIAPI, opcionalmente, para enriquecer las recomendaciones.
El usuario no necesita ver toda esta complejidad. Para él, la experiencia debería parecer sencilla: rellenar datos, iniciar el análisis y recibir un informe.
Pero detrás de esto hay automatización: validación, normalización, consulta externa, manejo de errores, organización de datos, generación de recomendaciones y preparación de un diseño para impresión.
LGPD y cuidado de datos
Aunque se trata de un proyecto educativo, la aplicación fue diseñada prestando atención a la privacidad.
El envío de códigos postales de clientes es opcional y solo aparece cuando el usuario informa que ya tiene una empresa. La pauta es enviar únicamente códigos postales, sin nombres, números de teléfono, correos electrónicos, CPF ni ningún dato personal innecesario. Cuando una hoja de cálculo contiene otras columnas, el sistema solo debe considerar la información necesaria para el análisis regional.
Además, los archivos enviados para procesamiento temporal pueden eliminarse del almacenamiento después del análisis. Esta decisión refuerza una idea importante: la tecnología útil también debe ser responsable.
El informe: menos ruido, más interpretación
Una parte importante del proyecto fue darme cuenta de que un buen informe no es el informe con más información. Es el informe el que ayuda al usuario a decidir.
Por lo tanto, el resultado de la aplicación se ajustó para reducir las redundancias y explicar mejor cada sección. El informe presenta:
- resumen de la región analizada;
- competidores relevantes alrededor;
- barreras y oportunidades de lectura;
- recomendaciones prácticas;
- mapas y gráficos;
- Lienzo Estratégico Empresarial;
- plan de acción;
- observaciones sobre fuentes públicas y limitaciones.
Cuando el usuario no envía los códigos postales de los clientes, la aplicación no fuerza un análisis de afinidad o vecindarios de clientes. En este caso, se centra en lo que realmente existe: los competidores y las señales del mercado en torno al lugar informado.
Esta elección es importante porque evita confundir la competencia con una base de clientes. Los datos sólo deben utilizarse cuando representan lo que dicen representar.
el mayor aprendizaje
Este proyecto muestra que el desarrollo del aprendizaje y la IA no significa memorizar herramientas. Significa entender cómo transformar una necesidad en una solución.
Desde el punto de vista del desarrollo, fue necesario pensar en la interfaz, la validación, la capacidad de respuesta, el backend, la base de datos, la implementación, la impresión y el mantenimiento.
Por el lado de la inteligencia artificial, era necesario pensar en el contexto, la calidad de los datos, las indicaciones, las API, los límites, el costo y la responsabilidad.
Al final, la herramienta es un puente entre los dos cursos:
- o Desarrollador de aplicaciones aparece en la construcción de la experiencia, en la lógica del sistema y en la entrega de una aplicación funcional;
- el curso de Inteligencia artificial Se muestra en el uso de datos, API, contexto y recomendaciones asistidas por IA.
El resultado es una aplicación educativa, abierta al estudio, la adaptación y la mejora.
Enlaces de proyectos
- Solicitud publicada: https://gray-glacier-0dc52610f.7.azurestaticapps.net/
- Repositorio en GitHub: https://github.com/ussantos/inteligencia-de-mercado
- Curso de desarrollador de aplicaciones: https://www.myrobotbarra.com.br/app-developer.html
- Curso de Inteligencia Artificial: https://www.myrobotbarra.com.br/inteligencia-artificial.html
Observación final
Este proyecto tiene un carácter educativo. No sustituye al análisis profesional, ni a la validación jurídica, contable, laboral, fiscal, técnica o de protección de datos. Cualquier organización que desee utilizar, adaptar o implementar la aplicación debe revisar el código, las configuraciones, las fuentes de datos, los costos de API y las responsabilidades involucradas.
Sin embargo, como ejercicio de aprendizaje, muestra algo poderoso: cuando el desarrollo de aplicaciones y la inteligencia artificial se enseñan de manera práctica, los estudiantes dejan de ser meros usuarios de tecnología y comienzan a comprender cómo se diseñan, construyen, prueban y publican las soluciones digitales.
Cursos que aparecen en este proyecto
Este ejemplo conecta el desarrollo de aplicaciones, la inteligencia artificial, los datos, las API y la publicación web. Por lo tanto, habla directamente con dos pistas de My Robot Barra da Tijuca.
APP Developer
Para jóvenes que quieran crear aplicaciones, interfaces, lógica en Python y soluciones digitales con inicio, desarrollo y entrega.
Descubre el curso
Inteligencia artificial
Para que los adolescentes aprendan IA generativa, datos, API, contexto y cómo crear soluciones con pensamiento crítico.
Descubre el cursoAccede a la demo y al código
El proyecto se publica para pruebas y también se puede estudiar en el repositorio en GitHub.
¿Quieres ver la tecnología aplicada así?
En My Robot Barra da Tijuca, cursos como APP Developer e Inteligencia Artificial ayudan a los adolescentes a comprender cómo se diseñan, construyen, prueban y publican las soluciones digitales.