Cian-OS Playbooks Preparar para crecer
¿Está su software listo para crecer?
En corto
Un software está listo para crecer cuando puede sumar usuarios, datos, personas y cambios sin que cada paso lo vuelva más frágil. Se revisa en seis dimensiones —arquitectura, seguridad, mantenibilidad, datos, operación y preparación para IA— y cada una se lee por separado: una sola en rojo pesa más que cinco en verde.
Crecer pone a prueba al software de una forma que el uso diario no muestra. Lo que funciona con cien usuarios y un desarrollador puede romperse con diez mil usuarios y cinco desarrolladores, y casi nunca por falta de servidores. Un software está listo para crecer cuando puede sumar usuarios, datos, personas y cambios sin que cada paso lo vuelva más frágil. Esta guía explica qué significa eso en seis dimensiones concretas, las mismas que usa nuestro Readiness Check.
Qué significa crecer para un software
«Escalar» suele entenderse como soportar más tráfico. Es solo una de cuatro formas de crecer, y rara vez la primera que falla:
| Cuando crece… | Lo que se pone a prueba | Dimensiones que más lo resienten |
|---|---|---|
| La cantidad de usuarios | Permisos, rendimiento, soporte | Seguridad, operación |
| El volumen de datos | Respaldos, consistencia, reportes | Datos, arquitectura |
| El equipo que lo desarrolla | Conocimiento compartido, pruebas, convenciones | Mantenibilidad, preparación para IA |
| El ritmo de cambio | Que lo nuevo no rompa lo anterior | Arquitectura, mantenibilidad, operación |
Por eso «listo para crecer» no es un estado general: es estar listo para el tipo de crecimiento que viene.
Las seis dimensiones
Cada dimensión se revisa con dos preguntas. Las respuestas no se suman: cada una dice algo distinto.
1. Arquitectura: ¿se puede cambiar sin miedo?
Una arquitectura está lista para crecer cuando otra persona puede entender sus componentes, sus datos y sus integraciones, y cuando agregar una funcionalidad no rompe las anteriores. Las preguntas: ¿existe una arquitectura documentada que alguien más pueda entender?, y cuando se agrega algo, ¿qué pasa con lo que ya funcionaba?
2. Seguridad: ¿lo que hoy es un riesgo pequeño seguirá siéndolo?
Con pocos usuarios, una contraseña en el código o un permiso que solo se valida en el navegador parecen detalles. Con más usuarios, más datos y más personas con acceso, se convierten en una puerta abierta a información que no debería estar expuesta. Las preguntas: ¿dónde viven las llaves de API y contraseñas?, y ¿dónde se valida quién puede ver o modificar cada dato?
3. Mantenibilidad: ¿puede continuar sin la persona que lo escribió?
Crecer casi siempre significa que más gente toca el código. Sin pruebas automáticas sobre los flujos críticos, cada cambio es una apuesta; si el conocimiento vive en una sola persona, el crecimiento depende de su agenda. Las preguntas: ¿hay pruebas automáticas sobre los flujos críticos?, y si la persona que más conoce el código no estuviera, ¿alguien podría continuarlo?
4. Datos: ¿sobrevivirían a un mal día?
Unos respaldos que nunca se probaron no son respaldos: son una suposición. Y los datos repartidos entre el sistema y hojas de cálculo paralelas se vuelven inconsistentes más rápido cuanto más crecen. Las preguntas: ¿hay respaldos automáticos y se ha probado restaurarlos?, y ¿los datos importantes viven en un modelo claro, sin copias paralelas?
5. Operación: ¿quién se entera primero cuando algo falla?
Si los usuarios avisan antes que el monitoreo, cada nuevo usuario es también un nuevo reportero de incidentes. Y un despliegue manual que depende de una persona limita cuántas veces —y con qué seguridad— se puede cambiar el sistema. Las preguntas: ¿cómo se entera de que algo falló en producción?, y ¿cómo se despliega una nueva versión?
6. Preparación para IA: ¿el código generado se revisa y se entiende?
Esta dimensión no pregunta si el producto usa IA. Pregunta si el equipo puede usarla para construir sin acumular riesgo: si cada cambio generado con IA lo revisa un ingeniero y si existe contexto documentado —reglas, convenciones, decisiones— que un agente o una persona nueva pueda seguir.
Por qué no hay un puntaje
Un porcentaje de «salud» promediaría lo que no se puede promediar. Unos respaldos que nunca se probaron no se compensan con una arquitectura impecable; un secreto expuesto no se diluye entre cinco dimensiones sanas. Por eso la lectura es cualitativa —Sólido, Revisar o Atención— y por dimensión.
Una sola dimensión en «Atención» pesa más que cinco en «Sólido».
Un caso frecuente: software construido rápido
Construir una primera versión con herramientas de IA o sin código es una forma legítima —y a veces la mejor— de llegar rápido a usuarios reales. El riesgo no está en la herramienta, sino en lo que suele faltar alrededor: nadie definió la arquitectura, nadie revisó la seguridad, nadie escribió las pruebas, nadie documentó las decisiones. Mientras la aplicación es un experimento, esas ausencias no se notan. Cuando empieza a sostener el negocio, se convierten en lo primero que hay que revisar antes de crecer.
Un ejemplo ilustrativo
Una empresa de servicios (ejemplo ilustrativo, no un cliente) tiene una aplicación de reservas construida en pocas semanas, con trescientos clientes, y se prepara para abrir dos ciudades más. Su lectura por dimensión:
| Dimensión | Lo que encontraron | Lectura |
|---|---|---|
| Arquitectura | Nadie la documentó, pero los cambios rara vez rompen algo | Revisar |
| Seguridad | Los permisos se validan en el navegador | Atención |
| Mantenibilidad | Sin pruebas; una sola persona entiende el código | Atención |
| Datos | Respaldos automáticos, nunca restaurados | Revisar |
| Operación | Se enteran de las fallas por los clientes | Atención |
| Preparación para IA | Parte del código se generó con IA y se revisa a veces | Revisar |
Tres dimensiones en «Atención» y ninguna se resuelve con más servidores. Antes de abrir las nuevas ciudades, lo que corresponde es confirmar con una revisión del código si esas señales son lo que parecen y en qué orden atenderlas.
Cuándo un cuestionario no basta
Estas preguntas dan una lectura orientativa, no un diagnóstico. Un cuestionario no puede confirmar el estado real del código: solo puede mostrar dónde mirar. Cuando aparecen dimensiones en «Atención», el paso siguiente es una revisión técnica sobre el código y la infraestructura, con hallazgos verificados y prioridades de remediación.
Errores comunes
- Confundir crecer con tráfico y revisar solo los servidores.
- Promediar dimensiones y concluir que «estamos bien en general».
- Dar por buenos los respaldos sin haber restaurado nunca uno.
- Sumar desarrolladores a un código sin pruebas ni contexto documentado.
- Enterarse de las fallas por los clientes y tratarlo como normal.
- Acelerar con IA sin revisión humana de cada cambio.
- Posponer la revisión hasta después de crecer, cuando corregir cuesta más y afecta a más gente.
Herramienta práctica · Checklist
Checklist de preparación para crecer
Las mismas seis dimensiones y doce preguntas del Readiness Check. En cada fila, marque la columna que describe su situación hoy. No sume ni promedie: cada dimensión se lee por separado.
01 · Arquitectura
| Pregunta | Sólido | Revisar | Atención |
|---|---|---|---|
| ¿Existe una arquitectura documentada (componentes, datos, integraciones) que otra persona pueda entender? | Sí, documentada y vigente | Parcial o desactualizada | No, o no lo sé |
| Cuando se agrega una funcionalidad, ¿qué pasa con lo que ya funcionaba? | Rara vez se rompe algo | A veces hay efectos inesperados | Con frecuencia se rompen otras partes |
| Siguiente paso | Mantenga las decisiones de arquitectura documentadas a medida que el producto crece. | Documente componentes, datos e integraciones antes de acelerar el desarrollo. | Defina una arquitectura objetivo antes de seguir agregando funcionalidades. |
02 · Seguridad
| Pregunta | Sólido | Revisar | Atención |
|---|---|---|---|
| ¿Dónde viven las llaves de API y contraseñas? | En variables de entorno o un gestor de secretos, fuera del código | Mezclado: algunas podrían estar en el código | En el código, o no lo sé |
| ¿Dónde se valida quién puede ver o modificar cada dato? | En el servidor, en cada operación | Parte en el servidor, parte en el navegador | En el navegador, o no lo sé |
| Siguiente paso | Incluya revisiones de seguridad periódicas en su proceso de entrega. | Revise el manejo de secretos y permisos antes de sumar usuarios. | Priorice una revisión de seguridad: secretos y permisos son el riesgo más común en apps construidas rápido. |
03 · Mantenibilidad
| Pregunta | Sólido | Revisar | Atención |
|---|---|---|---|
| ¿Tiene pruebas automáticas sobre los flujos críticos? | Sí, y corren en cada cambio | Algunas, sin cobertura clara | No |
| Si la persona que más conoce el código no estuviera, ¿alguien podría continuarlo? | Sí, sin problema | Con dificultad | No |
| Siguiente paso | Proteja la cobertura de pruebas en los flujos que más cambian. | Agregue pruebas a los flujos críticos y documente el conocimiento que hoy vive en una persona. | Reduzca la dependencia de una sola persona y cree una red mínima de pruebas antes de cambiar más código. |
04 · Datos
| Pregunta | Sólido | Revisar | Atención |
|---|---|---|---|
| ¿Tiene respaldos automáticos y ha probado restaurarlos? | Sí, automáticos y con restauración probada | Automáticos, pero nunca probamos restaurar | No, o no lo sé |
| ¿Los datos importantes viven en un modelo claro, sin copias ni hojas de cálculo paralelas? | Sí, un modelo claro | Parcial: hay duplicación o procesos manuales | No, los datos están dispersos |
| Siguiente paso | Programe pruebas periódicas de restauración de respaldos. | Pruebe una restauración completa y consolide los datos duplicados. | Asegure respaldos automáticos probados antes de cualquier otro cambio. |
05 · Operación
| Pregunta | Sólido | Revisar | Atención |
|---|---|---|---|
| ¿Cómo se entera de que algo falló en producción? | Monitoreo y alertas automáticas | Revisamos logs cuando alguien reporta algo | Nos avisan los usuarios |
| ¿Cómo se despliega una nueva versión? | Automatizado, con posibilidad de revertir | Proceso manual documentado | Manual, y depende de una persona |
| Siguiente paso | Revise que las alertas lleguen a quien puede actuar, y a tiempo. | Automatice el despliegue y agregue monitoreo de los flujos críticos. | Implemente monitoreo y un despliegue repetible: hoy los problemas los detectan sus usuarios. |
06 · Preparación para IA
| Pregunta | Sólido | Revisar | Atención |
|---|---|---|---|
| Si parte del código se generó con IA, ¿un ingeniero revisa cada cambio? | Sí, todo cambio se revisa | Parcialmente | No, o no lo sabemos |
| ¿Existe contexto documentado (reglas, convenciones, decisiones) que un agente de IA o un nuevo ingeniero pueda seguir? | Sí, vive en el repositorio | Parcial | No |
| Siguiente paso | Su base permite acelerar con IA; mantenga la revisión humana de cada cambio. | Documente reglas y convenciones antes de acelerar con agentes de IA. | Establezca revisión humana y contexto documentado antes de seguir generando código con IA. |
Cómo leer el resultado
- Alguna dimensión en «Atención»
- Son señales, no un diagnóstico, pero merecen una revisión técnica antes de seguir invirtiendo en crecer. Un cuestionario no puede confirmar el estado real del código; una revisión sí.
- Solo «Revisar»
- No hay un problema serio a la vista, pero tampoco se puede descartar. Aclare esas dimensiones antes de sumar usuarios, datos o personas.
- Todo «Sólido»
- El siguiente paso depende menos de corregir la plataforma y más de lo que quiere lograr con ella.
- Por qué no hay puntaje
- Una sola dimensión en «Atención» pesa más que cinco en «Sólido»: unos respaldos que nunca se probaron no se compensan con buena arquitectura.
Relación con Cian-OS
Las seis dimensiones cruzan tres sistemas de Cian-OS: Foundation (arquitectura, datos y seguridad decididas antes de acelerar), Verify (pruebas, revisión y evidencia de que lo construido cumple) y Operate (observar, proteger y evolucionar el sistema en producción). Son las mismas que usa el Readiness Check.
Readiness Check
Las mismas seis dimensiones, en un cuestionario de pocos minutos con una lectura por dimensión. Si aparecen señales de atención, el Software Readiness Assessment las confirma revisando su código.