Del ciclo clásico al modelo invertido
En clase vimos el SDLC. Con IA podemos reordenar sus etapas para aprender más rápido y equivocarnos más barato. En este curso trabajamos hasta el prototipo funcional y su publicación; iterar, especificar y construir en serio quedan para profundizar después.
Clásico (cascada)
Ves algo usable recién al final, cuando cambiar es caro.
Invertido (prototipo primero)
Por qué funciona
- Las personas del equipo clínico reaccionan mucho mejor a una pantalla que se puede tocar que a un documento de requisitos.
- Los errores de diseño aparecen en horas, no en meses.
- La especificación final sale de algo que ya se probó, así que es más precisa.
- Planificas (costo, plazo, riesgos) sabiendo exactamente qué construir.
No necesitas saber programar
Si has probado R, Python o Django, perfecto; y si no, también. Tu fortaleza es conocer el problema clínico y de gestión, y eso es lo difícil de reemplazar. El código real asusta menos cuando tú diriges y la IA lo escribe.
Tu rol cambia: de escribir código a dirigir y revisar
- Tú decides el problema, el diseño y qué es correcto clínicamente.
- El agente escribe el código y te lo explica cuando se lo pides.
- Tú revisas que funcione, que se vea bien y que sea seguro.
Cómo perderle el miedo
- Nada es irreversible: con Git cada cambio queda guardado y se puede deshacer. Pídele al agente que haga un commit antes de cada cambio grande.
- Pregunta todo: "explícame este archivo como si fuera mi primer día" es un prompt válido.
- Cambios pequeños: una pantalla o una función a la vez, probando después de cada una.
- Un error no es un fracaso: copia el mensaje de error completo y pégaselo al agente; casi siempre sabe qué hacer.
- No necesitas entenderlo todo, pero sí saber qué hace cada parte a grandes rasgos.
Soy profesional de la salud y tengo poca experiencia programando (he usado un poco de R y Python). Acabas de crear este proyecto. Explícame, en lenguaje simple y con analogías clínicas: 1. Qué hace cada carpeta y archivo importante (un párrafo cada uno). 2. Cuáles archivos son seguros de tocar y cuáles no. 3. Cómo corro la app en mi computador, paso a paso. 4. Cómo deshago un cambio si algo sale mal. Desde ahora, antes de cada cambio importante hazme un commit de respaldo, y al terminar dime en 3 líneas qué cambiaste y cómo lo pruebo.
¿Ya partiste con AppSheet u otra herramienta no-code?
Está bien: sirve, y el modelo de esta guía se aplica igual.
Cómo encaja con el modelo invertido
- Úsala como prototipo: lo que ya armaste sirve para mostrar el flujo al equipo clínico y aprender. Esa es la fase 2.
- No te saltes el diseño: aunque la herramienta te dé una interfaz por defecto, diseña antes las pantallas clave (fase 1); cambia mucho la experiencia de uso.
- Registra las decisiones: mantén el
SPEC.mdigual, para no perder lo aprendido.
Cuándo conviene seguir y cuándo pasar a código
- Seguir en no-code si es una herramienta interna pequeña, sobre datos simples, con pocas personas usuarias y sin lógica clínica compleja.
- Pasar a código con un agente si necesitas control fino de la interfaz, reglas clínicas complejas, integraciones (por ejemplo FHIR) o no quieres depender de una sola plataforma.
- Pregúntate siempre: ¿dónde viven los datos?, ¿quién tiene acceso?, ¿puedo exportarlos si cambio de herramienta? Para datos de pacientes, confirma que la plataforma y tu institución cumplan la normativa.
¿Qué podrías construir?
Ideas de gestión clínica según tu profesión. Parte pequeño: una herramienta que resuelva un problema de tu servicio.
En todos los casos, el prototipo se construye con datos sintéticos.
Antes de partir: tu computador y GitHub
Son dos preparativos de una sola vez. Y no tienes que hacerlos a mano: el agente puede revisar y configurar tu computador contigo.
1 · Preparar el entorno local
El "entorno local" es tu computador con las herramientas mínimas para correr y editar la app. Necesitas:
- Git: guarda el historial de tu trabajo.
- Node.js (o Python, según el proyecto): ejecuta la app en tu computador.
- Un editor: VS Code es una opción gratuita y común.
- Claude Code o Codex: el agente que escribe y configura contigo.
| Sistema | Qué considerar |
|---|---|
| Windows | La forma más estable de trabajar es con WSL (Subsistema de Windows para Linux): en una terminal de administrador, wsl --install y reiniciar. Luego instalas las herramientas dentro de WSL. Algunos agentes también funcionan directo en Windows; sigue la guía oficial del que uses. |
| Linux | Instalas con el gestor de paquetes de tu distribución (por ejemplo apt en Ubuntu). Es el entorno más directo. |
| Mac | Se instala con Homebrew o con los instaladores oficiales. |
Los pasos exactos cambian con las versiones: usa la documentación oficial de cada herramienta y deja que el agente verifique el resultado.
Soy profesional de la salud con poca experiencia técnica. Estoy en [Windows 11 / Ubuntu / macOS]. Quiero desarrollar un prototipo web en esta carpeta. 1. Revisa qué tengo instalado (Git, Node.js, editor) y dime qué falta, sin instalar nada todavía. 2. Para lo que falte, dame los pasos oficiales uno por uno, explicando qué hace cada comando en lenguaje simple. Pídeme permiso antes de ejecutar cualquier cosa. 3. Si estoy en Windows, dime si conviene usar WSL y guíame. 4. Al final verifica con un "hola mundo" que todo funciona y dime cómo abrir la app en el navegador (localhost). Si algo falla, explícame el error con calma y propón la solución más simple.
2 · Crear tu cuenta gratuita en GitHub
GitHub guarda tu proyecto en la nube con todo su historial. Desde el primer día cada cambio queda versionado, así que puedes volver atrás si algo sale mal y tu trabajo no se pierde si falla tu computador.
- Crea tu cuenta gratis en github.com.
- Crea un repositorio privado para tu proyecto.
- Pídele al agente que conecte tu carpeta con el repositorio y suba tu trabajo.
- Desde ahí, que haga un commit y un push después de cada avance.
Quiero versionar este proyecto con Git y guardarlo en GitHub. Ya tengo cuenta. 1. Inicializa Git en esta carpeta y crea un .gitignore adecuado para este tipo de proyecto. Debe excluir archivos con claves o secretos (.env), dependencias y datos. 2. Guíame para iniciar sesión en GitHub y crear un repositorio PRIVADO llamado [nombre]. Si necesitas la CLI de GitHub (gh), ayúdame a instalarla. 3. Haz el primer commit y súbelo. 4. Antes de subir, revisa que no haya claves, contraseñas ni datos de pacientes en los archivos, y avísame si encuentras algo. 5. Desde ahora, después de cada cambio que funcione, haz commit con un mensaje claro y súbelo.
.env que no se sube.
0Idea
Media página basta. No es todavía una especificación.
Qué escribir
- ¿Quién usará la herramienta (enfermería, medicina, pacientes, personal administrativo)?
- ¿Qué problema tiene hoy y qué quiere lograr?
- ¿Cuáles son las 3 pantallas o acciones más importantes?
Actúa como product manager senior de salud digital. Mi rol es [rol clínico, ej. enfermería de urgencias] y trabajo en [contexto, ej. un servicio de urgencias de un hospital público]. Problema que vivo hoy: [describe qué ocurre, con qué frecuencia y qué consecuencias tiene]. Antes de escribir nada, hazme 8 preguntas para afinar el problema (usuarios, contexto de uso, restricciones, qué se hace hoy en papel o en otros sistemas). Espera mis respuestas. Luego redacta un brief de producto de una página con: 1. Usuario principal y secundarios 2. Problema y evidencia de que importa 3. Flujo principal en 5 pasos 4. Las 3 pantallas imprescindibles 5. Qué NO hará la primera versión 6. Riesgos para el paciente y supuestos que habría que validar 7. Cómo sabríamos que funciona (2 o 3 métricas) Usa lenguaje simple, sin jerga técnica.
1Diseño de alta fidelidad
Salta directo a la interfaz real, con colores, tipografía, estados y datos de ejemplo.
Qué hacer
- Genera las pantallas principales a partir de tu brief.
- Pide variantes y elige una dirección visual.
- Incluye estados reales: vacío, cargando, error, alerta clínica.
- Usa datos sintéticos verosímiles (nunca de pacientes reales).
Diseña una app web de alta fidelidad para [nombre y propósito], usada por [usuario] en [contexto, ej. turno de noche, de pie, con guantes]. Pantallas: (1) login, (2) lista de pacientes con prioridad y estado, (3) ficha del paciente con signos vitales y alertas, (4) registro de [acción clave] en máximo 3 toques. Dirección visual: sobria, clínica y confiable. Paleta de 1 color de acento sobre fondos neutros, tipografía muy legible, alto contraste (WCAG AA), botones grandes. Debe verse bien en tablet y en escritorio. Incluye estados reales: vacío, cargando, error de red, alerta crítica (que no se pueda ignorar por accidente) y confirmación de acciones peligrosas. Usa solo datos sintéticos verosímiles (nombres y RUT ficticios), nunca datos reales. Entrégame 2 variantes visuales para elegir y explica brevemente las decisiones de diseño.
2Prototipo funcional
Entrega el diseño a un agente de código y obtén una app que se puede usar.
Qué hacer
- Pasa el diseño (capturas, export o enlace) a Claude Code o Codex y pide que lo implemente fiel al original.
- Parte con datos simulados y sin backend real; agrega lo necesario poco a poco.
- Usa Git desde el inicio para poder deshacer.
- Pídele que te explique lo que construyó: tú debes entender el proyecto.
Adjunto el diseño de alta fidelidad de [app] (capturas en /design). Implementa un prototipo web funcional, fiel al diseño en colores, tipografía, espaciado y estados. Restricciones: - Stack simple: [ej. React + Vite + TypeScript + Tailwind]. Justifica si propones otro. - Sin backend todavía: datos sintéticos en archivos JSON locales, con una capa de acceso a datos que luego pueda reemplazarse. - Navegación y formularios funcionando, con validaciones y los estados de error y alerta del diseño. - Responsive (tablet y escritorio) y accesible (teclado, contraste, etiquetas). - Inicializa Git y haz un commit por cada pantalla. Proceso: primero muéstrame tu plan en 5 pasos y espera mi OK. Luego implementa por pantallas. Al terminar, escribe un README con cómo correrlo y una lista de lo que es "de mentira" en el prototipo (datos, seguridad, integraciones). Explícame cada decisión técnica en lenguaje simple: vengo del área clínica, no del desarrollo de software.
Verla funcionando en tu computador: localhost
Localhost significa "este mismo computador". Cuando corres la app en modo desarrollo, tu computador levanta un pequeño servidor privado y la muestras en el navegador en una dirección como http://localhost:5173 (o :3000, según el proyecto). Solo tú puedes verla: no está en internet.
- Se inicia con un comando en la terminal, dentro de la carpeta del proyecto. Suele ser
npm run dev; el README o el agente te dicen el exacto. Pídele al agente que lo ejecute por ti. - La terminal muestra la dirección. Ábrela en tu navegador (o haz clic con Ctrl/Cmd).
- Cambios en tiempo real: el servidor de desarrollo vigila tus archivos. Cuando el agente modifica el código y guarda, la página se actualiza sola (suele llamarse "hot reload"), sin que repitas nada.
- Flujo típico: dejas el navegador al lado de la terminal, le pides un cambio al agente y ves el resultado en segundos. Si no te gusta, le dices qué ajustar o lo deshaces con Git.
- Para detenerla: en la terminal presiona
Ctrl + C. Si cierras la terminal, la app deja de verse en localhost. - Si no carga: revisa que el servidor siga corriendo, que la dirección y el puerto sean los que indica la terminal y, si hay error, pega el mensaje completo al agente.
Quiero ver el prototipo funcionando en mi computador y mirar los cambios en tiempo real. 1. Instala las dependencias necesarias y levanta el servidor de desarrollo. 2. Dime exactamente qué dirección abrir en mi navegador (localhost y puerto) y cómo reconocer que la app está corriendo bien. 3. Explícame en 3 líneas qué es localhost y por qué solo yo puedo ver la app. 4. Confirma que los cambios se reflejan automáticamente: haz un cambio visible y pequeño (por ejemplo el título de la página) y dime qué debería ver yo en el navegador. 5. Explícame cómo detener el servidor y cómo volver a iniciarlo otro día. 6. Si algún puerto está ocupado o hay un error, resuélvelo y explícame qué pasó.
3Llevarlo a producción
Tu prototipo corre en localhost. Para que otras personas lo usen, tiene que vivir en un servidor accesible. Dónde y cómo es una decisión que en salud pasa por tu institución.
Antes de publicar, revisa esto
- Datos: ¿el prototipo usa datos reales? Si es así, no se publica sin evaluación de privacidad y seguridad.
- Autorización: ¿quién en tu institución debe aprobarlo (jefatura clínica, informática, ciberseguridad, comité de ética)?
- Acceso: ¿quiénes lo usarán y cómo se autentican? Define perfiles, roles y qué puede ver cada uno.
- Claves: variables de entorno en el servidor, nunca en el código ni en GitHub.
- Respaldos y recuperación: qué pasa si el servidor falla; cada cuánto se respalda y quién restaura.
- HTTPS: toda conexión cifrada.
- Responsable: quién mantiene la app, actualiza y responde ante un incidente.
¿Nube o red local de la institución?
No hay una respuesta única. Depende de los datos, la normativa y la política de tu institución.
| Nube pública | Red local (intrahospitalaria, red institucional o de la red pública de salud) | |
|---|---|---|
| Dónde corre | Proveedor externo (Cloudflare, Vercel, Google Cloud, AWS, etc.) | Servidor propio de la institución, dentro de su red |
| Quién puede acceder | Cualquiera con internet, salvo que lo restrinjas con login | Solo quienes estén conectados a esa red o por VPN autorizada |
| Ventajas | Rápido de publicar, escalable, respaldos y certificados simples | Los datos no salen de la institución; mayor control |
| Desafíos | Dónde quedan los datos, contratos con el proveedor y cumplimiento normativo | Requiere equipo de TI, aprobaciones, mantenimiento y, muchas veces, plazos largos |
| Suele ser lo adecuado para | Prototipos con datos sintéticos, herramientas sin datos de pacientes, demos | Sistemas con datos de pacientes, integración con sistemas internos, políticas que exigen datos en la red local |
Dos caminos para publicar: PaaS o VPS
Si decides ir a la nube, hay dos formas muy distintas de hacerlo. Una te entrega todo armado; la otra te da un servidor para que lo configures tú.
| PaaS (ej. Firebase) | VPS (ej. OpenCloud.cl) | |
|---|---|---|
| Qué es | Plataforma que ofrece servicios listos: hosting, base de datos, login. | Un servidor virtual donde instalas y configuras lo que necesites. |
| Configuración | Muy simple; se despliega con pocos comandos. | Más trabajo: sistema operativo, firewall, certificados, respaldos. |
| Mantenimiento y seguridad | Gran parte la asume el proveedor. | Es tu responsabilidad (o la de tu equipo de TI). |
| Costo | Plan gratuito para partir; paga por uso al crecer. | Mensualidad fija y predecible. |
| Ideal para | Prototipos, pilotos y apps pequeñas sin datos de pacientes. | Proyectos con backend y base de datos propios, y cuando necesitas más control. |
Firebase: PaaS de Google, fácil de partir
Firebase reúne en un solo lugar lo que una app suele necesitar: Hosting (publicar el sitio), Authentication (login), Firestore (base de datos) y más. Lo conectas con tu repositorio y el agente puede configurarlo contigo.
- Plan gratuito (Spark): sin tarjeta de crédito. Al revisar su página de precios incluye, con límites, Hosting (10 GB de almacenamiento y 360 MB de transferencia al día), Firestore (1 GiB almacenado, 50 mil lecturas y 20 mil escrituras al día) y Authentication (hasta 50 mil usuarios activos al mes).
- Fácil de configurar: con la herramienta de línea de comandos de Firebase,
firebase initprepara el proyecto yfirebase deploylo publica. Te entrega una dirección gratuita y también acepta tu dominio propio. - Qué requiere el plan de pago (Blaze, pago por uso): en esa misma página, Cloud Functions, Cloud Storage y App Hosting no están disponibles en el plan gratuito. Si los necesitas, configura alertas de presupuesto para evitar sorpresas.
- Los límites cambian: confirma las cuotas y condiciones vigentes en firebase.google.com/pricing.
- Datos de pacientes: el plan gratuito es para prototipos con datos sintéticos. Antes de usar datos reales, revisa dónde se almacenan, el contrato con el proveedor y la normativa de tu institución.
Quiero publicar mi prototipo web en Firebase Hosting con el plan gratuito (Spark). Mi proyecto usa [React + Vite / otro] y datos sintéticos. 1. Instala la CLI de Firebase y guíame para iniciar sesión y crear el proyecto. Explica qué hace cada comando. 2. Configura Hosting para publicar la carpeta de salida correcta (build) y verifica que las rutas de la app funcionen al recargar la página. 3. Despliega y dame la URL pública. Confirma que carga correctamente. 4. Si mi app necesita login o base de datos, propón cómo usar Authentication y Firestore dentro de los límites gratuitos y con reglas de seguridad que no dejen los datos abiertos. 5. Dime cuáles servicios que podría necesitar requieren el plan de pago, y cómo configurar una alerta de presupuesto. 6. No subas claves al repositorio; usa variables de entorno.
OpenCloud.cl: VPS a bajo costo
Un VPS (servidor privado virtual) es un computador en la nube que arriendas por mes. Tú decides qué instalar: tu app, un servidor web, tu base de datos. OpenCloud.cl es una opción chilena de bajo costo para partir.
- Precios de referencia (según su sitio, más IVA por mes): $2.500 CLP por 1 GB de RAM, 1 vCPU y 20 GB de disco; $6.000 CLP por 2 GB, 1 vCPU y 50 GB; $12.000 CLP por 4 GB y 2 vCPU. Los valores pueden cambiar: confírmalos en su sitio.
- Pago: tarjetas, dinero electrónico y transferencia bancaria.
- Dónde está el servidor: en Chile, lo que puede ser una ventaja si necesitas que los datos permanezcan en el país. Aun así, para datos de salud confirma con tu institución qué exige la normativa y qué respaldos y medidas de seguridad corresponden.
- Lo que implica: eres responsable de actualizaciones, firewall, certificados HTTPS y respaldos. Es más trabajo que un PaaS, pero con el agente es abordable.
- Ideal para pilotos con backend y base de datos propios, o cuando quieres costo fijo y control.
Contraté un VPS Linux (Ubuntu) con 1 GB de RAM y quiero desplegar mi app [descripción] de forma segura. Soy profesional de la salud con poca experiencia en servidores, así que explícame cada paso y pídeme confirmación antes de ejecutar comandos. 1. Cómo conectarme por SSH de forma segura (con llave en vez de contraseña) y deshabilitar el acceso como root. 2. Configurar el firewall para abrir solo lo necesario (SSH, HTTP y HTTPS). 3. Instalar y configurar lo que necesita mi app (Node.js o Python, un servidor web como Nginx y, si hace falta, la base de datos). 4. Desplegar el código desde mi repositorio de GitHub y que se reinicie solo si el servidor se reinicia. 5. Configurar mi dominio y un certificado HTTPS gratuito. 6. Respaldos automáticos de la base de datos y actualizaciones de seguridad. 7. Un checklist final de seguridad y qué debo revisar mensualmente. Si algo puede poner en riesgo datos de pacientes, avísame antes de continuar.
Arquitectura de red, en simple
Así viaja una petición desde el usuario hasta los datos.
- La base de datos no se expone a internet. Solo la app puede hablar con ella, en una red privada o con reglas de acceso estrictas.
- El firewall filtra qué tráfico entra y a qué puertos; en una red hospitalaria lo gestiona TI.
- Las personas usuarias solo ven la app, nunca los servidores internos.
- En red local el acceso puede limitarse a la red interna o a una VPN; en nube, a personas autenticadas.
- Registros (logs) y monitoreo: para saber quién accedió y detectar fallas o ataques.
DNS: ponerle nombre a tu app
Los servidores se encuentran por una dirección numérica (IP). El DNS es la "agenda telefónica" de internet: traduce un nombre fácil como mim.natiriquel.me a esa dirección.
- Dominio y subdominio: compras o usas un dominio y creas subdominios para cada app (por ejemplo
agenda.tudominio.cl). - Registros DNS habituales:
A(nombre → IP),CNAME(nombre → otro nombre, típico al usar un hosting) yTXT(verificaciones). - Propagación: un cambio de DNS puede tardar desde minutos hasta horas en verse en todas partes.
- Certificado HTTPS: el hosting suele generarlo automáticamente cuando el dominio apunta bien.
- En redes internas el nombre lo resuelve un DNS interno de la institución, y puede no ser visible desde fuera. Lo gestiona TI.
Tengo un prototipo web en GitHub que corre bien en localhost, con datos sintéticos. Quiero publicarlo para que otras personas lo prueben. 1. Recomiéndame 2 opciones de hosting en la nube adecuadas para este stack, con pros y contras, y cuál es la más simple para empezar. 2. Guíame para desplegarlo conectando mi repositorio de GitHub, de modo que cada push actualice el sitio. 3. Explícame cómo asociar un subdominio mío (por ejemplo app.midominio.cl): qué registro DNS debo crear (A o CNAME), dónde, y cómo verificar que ya funciona con HTTPS. 4. Hazme un diagrama simple de cómo viaja una petición desde el usuario hasta la app y la base de datos. 5. Hazme un checklist de seguridad previo a la publicación: claves, acceso con login, datos de prueba y HTTPS. 6. Dime qué preguntas debo hacerle al área de informática de mi institución si esta app debiera correr en la red interna en vez de la nube.
Cloudflare: gestionar tu DNS gratis
Cloudflare es un servicio que administra el DNS de tu dominio, con un plan gratuito. Funciona con dominios comprados en cualquier otro lugar, incluidos los .cl, y suele ser la forma más simple de gestionar los registros.
- Qué ofrece el plan gratuito: panel para administrar registros DNS, certificados HTTPS y protección básica. Revisa las condiciones vigentes en cloudflare.com.
- Cómo se usa: creas una cuenta, agregas tu dominio y Cloudflare te entrega dos nameservers. Luego los cambias en el sitio donde compraste el dominio (el registrador) y esperas la propagación.
- Después: creas los registros
AoCNAMEpara tus subdominios desde el panel de Cloudflare. - Ojo: gestionar el DNS en Cloudflare es distinto de comprar el dominio. Son dos cosas, y puedes hacer una sin la otra.
¿Dónde comprar un dominio?
El registrador es quien te vende y renueva el dominio. Los precios son aproximados y cambian; confirma el valor vigente antes de comprar.
| Registrador | Para qué sirve | Precio aproximado |
|---|---|---|
| NIC Chile (nic.cl) | Registro oficial de dominios .cl. Es el punto de partida si quieres un dominio chileno. | Unos $9.990 CLP al año (tarifa anunciada por NIC Chile desde noviembre de 2023; confirma si incluye IVA y el valor actual). |
| Cloudflare Registrar | Vende dominios a costo, sin recargo sobre lo que cobra el registro, y los gestiona junto a su DNS. No ofrece .cl en su lista de dominios soportados. | Para un .com, del orden de US$10 al año; varía por extensión. |
| Otros registradores (GoDaddy, Namecheap, Dynadot, etc.) | Venden .com, .cl y muchas otras extensiones, a veces con descuento el primer año. | Varía. Revisa el precio de renovación, que suele ser mayor al del primer año. |
Para tu proyecto del curso
- No necesitas comprar un dominio. Los hostings entregan una dirección gratuita (por ejemplo, terminada en
.pages.deven Cloudflare Pages) suficiente para mostrar tu prototipo. - Si es para tu institución, pregunta primero a TI: lo habitual es pedir un subdominio del dominio institucional (como
app.hospital.cl) en vez de comprar uno aparte. - Si compras uno propio, hazlo a tu nombre y con tu correo, y guarda bien el acceso: quien tiene la cuenta del registrador controla el dominio.
Dónde vive tu app y tus datos
La misma app existe en distintos "entornos". La base de datos es lo más delicado, así que tiene su propio cuidado en cada uno.
| Entorno | La app vive en | La base de datos vive en | Datos |
|---|---|---|---|
| Desarrollo | Tu computador (localhost) | Local en tu computador, o un proyecto de desarrollo en la nube | Solo sintéticos |
| Pruebas (staging) | Un servidor en la nube, privado | Una base de datos de pruebas en la nube | Sintéticos o anonimizados |
| Producción | Un servidor o hosting en la nube, con dominio propio | Una base de datos en la nube, separada de las otras | Reales, con toda la protección |
Ideas clave
- Misma app, distinta configuración: el código es el mismo; lo que cambia es a qué base de datos se conecta, definido por variables de entorno.
- Una base de datos por entorno. Nunca desarrolles apuntando a la base de producción: un error podría borrar o alterar datos reales.
- Nunca copies datos reales a desarrollo. Si necesitas datos parecidos, genera sintéticos o anonimiza.
- Cambios en la estructura (agregar una tabla o campo) se hacen con migraciones versionadas en Git, primero en desarrollo y luego en producción.
- En producción: respaldos automáticos, acceso por roles, registro de accesos (auditoría), conexión cifrada y claves fuera del código.
- Dónde están los datos importa: región del servidor, quién es el proveedor y qué normativa aplica (Ley 19.628 y 20.584 en Chile, HIPAA o GDPR según el caso).
Mi prototipo hoy corre en mi computador con datos sintéticos en archivos locales. Quiero prepararlo para tener entornos separados. Propón y explícame en lenguaje simple una arquitectura con 3 entornos (desarrollo, pruebas, producción) usando [Firebase / Supabase / otro]: 1. Cómo se configura cada entorno con variables de entorno, sin claves en el código. 2. Cómo tener una base de datos distinta por entorno y cómo aplicar cambios de estructura con migraciones versionadas. 3. Dónde se despliega la app en pruebas y en producción, y cómo se conecta con GitHub para desplegar al hacer push. 4. Qué respaldos, roles de acceso y auditoría necesito en producción. 5. Qué riesgos hay para datos de pacientes y qué debo validar con mi institución antes de usar datos reales. Impleméntalo solo para desarrollo por ahora y déjame listas las instrucciones para los otros entornos.
Para profundizar, después del curso
El curso llega hasta el prototipo funcional y su publicación. Si quieres seguir con ese proyecto, o empezar otro, estas son las etapas que siguen.
AIterar diseño y especificación
Aquí ocurre el aprendizaje. Muestra el prototipo y deja que quienes la usarán te corrijan.
El ciclo
- Muéstralo a 3–5 personas reales del equipo clínico y observa cómo lo usan sin explicarles.
- Anota: qué les confundió, qué faltó, qué sobró.
- Ajusta el diseño y vuelve a pedir el cambio al agente de código.
- Registra cada decisión en un
SPEC.mdvivo (qué se decidió y por qué).
Probé el prototipo con 4 personas del equipo clínico. Hallazgos: - [Observación 1, ej. no encontraron el botón de alta] - [Observación 2, ej. la alerta de alergia pasó desapercibida] - [Observación 3, ej. pidieron ver el último valor de creatinina en la lista] Para cada hallazgo: 1. Dime la causa probable (diseño, texto, flujo o dato faltante). 2. Propón el cambio mínimo de diseño y una alternativa. 3. Indica si el cambio afecta la seguridad del paciente. Después aplica los cambios aprobados al prototipo en commits separados, y actualiza SPEC.md agregando en "Decisiones": la fecha, el hallazgo, qué se cambió y por qué. Si un hallazgo contradice algo ya decidido, avísame antes de tocar nada.
BEspecificar, ahora sí
Con un prototipo validado, la especificación se escribe casi sola y es mucho más precisa.
Qué obtener del prototipo
- Historias de usuario y casos de uso con criterios de aceptación.
- Modelo de datos y reglas de negocio reales.
- Lista de lo que es "de mentira" en el prototipo (datos simulados, sin seguridad, sin integraciones).
- Análisis de riesgos clínicos (FMEA simple): qué puede salir mal y cómo se mitiga.
Lee todo el código del prototipo y SPEC.md. Genera una especificación formal en SPEC-v1.md con:
1. Historias de usuario ("Como [rol] quiero [acción] para [beneficio]") con criterios de aceptación verificables en formato Dado/Cuando/Entonces.
2. Casos de uso con flujo principal, flujos alternativos y errores.
3. Modelo de datos (entidades, campos, tipos, relaciones) e identificadores clínicos relevantes; indica dónde aplicaría un estándar como HL7 FHIR.
4. Reglas de negocio y cálculos clínicos, marcando cuáles requieren validación de una persona con formación clínica y fuente primaria.
5. Roles y permisos (RBAC) y qué se audita.
6. Tabla "Simulado vs. real": todo lo falso del prototipo y qué se necesita para hacerlo real.
7. Análisis de riesgos tipo FMEA: modo de falla, efecto en el paciente, severidad, mitigación.
8. Preguntas abiertas y supuestos sin validar.
No inventes requisitos que no estén en el prototipo ni en SPEC.md; si falta información, anótalo en el punto 8.CPlanificar y construir en serio
Aquí vuelve el SDLC clásico, pero partiendo de una especificación validada.
| Etapa | Qué se hace ahora |
|---|---|
| Factibilidad | Estimar costo, plazo e integraciones con la especificación ya clara. |
| Desarrollo | Decidir qué del prototipo se conserva y qué se reescribe; backend, base de datos, autenticación y RBAC reales; revisión entre pares. |
| Pruebas | Casos de prueba desde las historias de usuario; resultado OK, Advertencia o Crítico; lo crítico bloquea. |
| Lanzamiento | Staging y producción separados; despliegue desde Git. |
| Mantenimiento | Evolutivo, correctivo y preventivo; canal simple para reportar fallas. |
Seguridad y calidad en salud
Lo que distingue a una app de salud de cualquier otra.
Buenas prácticas de clase, aplicadas a este modelo
- Riesgos desde el diseño: pregunta a la IA "¿cómo podría esto dañar a un paciente?" ya en el prototipo.
- Validación clínica: los cálculos (dosis, scores) los verifica una persona con formación clínica, con fuente primaria, no la IA.
- Ciberseguridad: sin claves en el repositorio; variables de entorno y control de acceso por roles.
- Transparencia de IA: documenta qué hace cada algoritmo y busca sesgos.
- Interoperabilidad: si integras sistemas, considera HL7 FHIR.
- Documentación: versiona la especificación, los cambios y el manual de usuario.
Cuándo se vuelve dispositivo médico
Si el software diagnostica, trata o recomienda decisiones clínicas, puede ser SaMD y requerir regulación (FDA, ISO 13485, IEC 62304). Un prototipo académico no es un producto clínico: no lo uses con pacientes reales sin esa evaluación.
Stack recomendado para empezar
Simple, barato y suficiente para un proyecto del máster.
| Necesidad | Herramienta |
|---|---|
| Pensar el brief | Claude, ChatGPT, Gemini o Grok |
| Diseño de alta fidelidad | Stitch o Claude Design |
| Prototipo y código | Claude Code o Codex |
| Versiones y tablero | GitHub o GitLab |
| Base de datos y login | Firebase o Supabase |
| Publicar | Cloudflare Pages o Vercel |
Las herramientas de IA cambian rápido; revisa planes y precios vigentes antes de elegir.