Glosario de sistemas para principiantes

Para dirigir a una IA (o a un programador) hay que hablar su idioma. Aquí van 34 conceptos explicados sin jerga: primero una analogía de la vida diaria, luego el nombre técnico y un ejemplo real de chzr.llc, una plataforma para negocios mexicanos. Cada uno cierra con lo que confunde, lo que hace mal una IA si tú no lo sabes y un mini reto.

La idea de fondo: la IA amplifica lo que ya sabes. Con este vocabulario puedes darle órdenes precisas, revisar lo que entrega y notar cuándo se equivoca; sin él, solo aceptas lo que salga.

🧭 Para empezar

Las dos ideas que hacen que todo lo demás tenga sentido.

Sistema (entrada → proceso → salida)

Algo que recibe datos, les hace algo y devuelve un resultado. Todo software es eso, aunque sea de tres pasos.

🍽️ Analogía: Una taquería: llega la comanda (entrada), el taquero prepara (proceso) y sale el plato (salida).
🏢 En chzr.llc: En Quote Link la entrada es el cliente, los conceptos y los precios; el proceso suma, calcula el IVA y asigna un folio; la salida es una cotización lista para mandar por WhatsApp.
😵 Lo que confunde: Creer que «sistema» significa «complicado». Un sistema útil puede ser pequeñísimo.
🤖 Si no lo sabes, la IA…: Si le pides «hazme un sistema de todo» te entrega una masa sin forma. Si le pides la entrada, el proceso y la salida de UNA cosa concreta, te entrega algo que puedes revisar.

Mini reto: ¿Cuál es la entrada, el proceso y la salida de tu libreta de fiado?

Excel contra base de datos

Una base de datos es como un Excel al que le pusieron reglas y que aguanta que muchas personas lo usen a la vez sin desordenarse.

🍽️ Analogía: Una hoja de cálculo es una libreta; la base de datos es una oficina con archiveros, etiquetas y una recepcionista que no deja guardar cosas mal hechas.
🏢 En chzr.llc: En vez de una sola hoja «Cotizaciones» con todo revuelto, hay tablas separadas (la cotización y sus conceptos) que se relacionan por el número de la cotización.
😵 Lo que confunde: Pensar «¿para qué, si tengo Excel?». Se nota cuando dos personas editan a la vez o cuando un dato aparece en cinco hojas y se desactualiza en cuatro.
🤖 Si no lo sabes, la IA…: Si no lo sabes, la IA te arma «una hoja grande» que funciona en la demostración y se rompe el día que hay dos usuarios.

Mini reto: ¿Qué pasa en tu Excel si dos personas escriben al mismo cliente con distinto nombre?

🗄️ Los datos

Dónde vive la información y cómo se mantiene ordenada y confiable.

Base de datos

El lugar donde el sistema guarda sus datos de forma ordenada y permanente, aunque apagues la computadora.

🍽️ Analogía: El archivero de la oficina: no es el escritorio (la pantalla) ni la persona (el programa); es donde vive la información.
🏢 En chzr.llc: chzr.llc usa varias bases con propósitos distintos: una de usuarios y negocios, una de catálogos compartidos y una de herramientas.
😵 Lo que confunde: Creer que la base de datos «es» el sistema. El sistema es el programa; la base guarda lo que el programa necesita recordar.
🤖 Si no lo sabes, la IA…: Puede guardar datos en un archivo suelto o en el navegador, y se pierden al cambiar de computadora. Quien sabe, exige que vayan a la base.

Mini reto: Si el programa se apaga, ¿qué se pierde: los datos o el programa?

Tabla, fila y columna

Una tabla es una lista de cosas del mismo tipo. Cada fila es una cosa; cada columna es un dato de esa cosa.

🍽️ Analogía: La lista de asistencia del salón: una fila por alumno; columnas: nombre, grupo, teléfono.
🏢 En chzr.llc: En la tabla de cotizaciones, cada fila es una cotización; las columnas son folio, cliente, fecha, subtotal, IVA, total y estado.
😵 Lo que confunde: Meter en una misma tabla cosas de distinto tipo «por comodidad».
🤖 Si no lo sabes, la IA…: A veces crea una columna «datos» donde mete todo junto en texto: después no se puede buscar, sumar ni filtrar.

Mini reto: En una tabla de productos, ¿el precio es una fila o una columna?

Llave primaria (el id)

Un número único que identifica a cada fila y que nunca se repite.

🍽️ Analogía: El número de folio de un recibo, o la CURP: dos personas pueden llamarse igual; su identificador no.
🏢 En chzr.llc: Cada cotización tiene un identificador interno y, además, un folio legible para el cliente (por ejemplo COT-0003).
😵 Lo que confunde: Usar el nombre como identificador: «Juan Pérez» hay muchos.
🤖 Si no lo sabes, la IA…: Puede usar el nombre o el correo como «identificador» y todo se rompe con el primer duplicado.

Mini reto: ¿Por qué el nombre de una persona no sirve como identificador?

Relaciones y llave foránea

La forma en que se conectan las tablas: una cotización tiene muchos conceptos, y cada concepto pertenece a una sola cotización. Ese «a cuál pertenece» es la llave foránea.

🍽️ Analogía: Una cuenta de restaurante (una) y sus renglones (muchos): cada renglón dice a qué cuenta pertenece. Cuando muchos se relacionan con muchos (un proveedor ofrece varios servicios y cada servicio lo ofrecen varios proveedores) se usa una tabla intermedia, como la lista de «quién sabe hacer qué» en un taller.
🏢 En chzr.llc: Todo dato de negocio en chzr.llc lleva la identificación del negocio dueño; así una sola plataforma sirve a muchos negocios sin mezclarlos. En Citas, los servicios que ofrece cada proveedor viven en una tabla intermedia.
😵 Lo que confunde: Querer meter «muchos» en una sola celda («producto1, producto2, producto3»).
🤖 Si no lo sabes, la IA…: Puede proponer guardar los renglones dentro de la cotización como texto: imposible sumar, buscar o corregir uno solo.

Mini reto: ¿Cuántas cotizaciones tiene un concepto? ¿Y cuántos conceptos, una cotización?

Integridad referencial

La base de datos no te deja guardar un renglón que apunta a algo que no existe, ni borrar algo sin decidir qué pasa con lo que depende de él.

🍽️ Analogía: El cajero del restaurante: no cobra un renglón «huérfano» que no pertenece a ninguna mesa.
🏢 En chzr.llc: En Citas, si un proveedor no existe, la base no permite asignarle horarios ni servicios.
😵 Lo que confunde: Creer que «con que la pantalla lo valide, basta». La base es la última defensa; la pantalla se puede saltar.
🤖 Si no lo sabes, la IA…: Puede crear tablas sin reglas de unión y, meses después, aparecen renglones huérfanos por todos lados.

Mini reto: ¿Qué sería un «registro huérfano» en tu negocio?

Cascada (borrado en cascada)

Lo que pasa con lo «hijo» cuando borras al «padre»: se borra con él (cascada), se prohíbe borrar (restringir) o solo se marca como borrado.

🍽️ Analogía: Cerrar un expediente: ¿tiras todos los papeles adentro (cascada), no te dejan cerrarlo mientras tenga papeles (restringir) o lo archivas (borrado suave)?
🏢 En chzr.llc: En InfoScope, borrar un formulario borra también sus campos y respuestas, y borrar un campo borra las respuestas capturadas en él. Por eso el sistema lo advierte y no se puede deshacer. En Citas, borrar un proveedor borra sus horarios, servicios y bloqueos.
😵 Lo que confunde: Creer que la cascada es «mala». Es útil, pero peligrosa si no se le avisa claramente a quien borra.
🤖 Si no lo sabes, la IA…: Puede activar la cascada por defecto sin avisar a nadie; alguien borra un campo y pierde trescientas respuestas.

Mini reto: Si borras a un cliente, ¿deberían borrarse también sus cotizaciones antiguas? ¿Por qué sí o por qué no?

CRUD y borrado suave

Las cuatro cosas que se le hacen a cualquier dato: Crear, Leer, Actualizar y Borrar. Casi todo el software es CRUD con adornos. El borrado suave es marcar como borrado sin quitar la fila.

🍽️ Analogía: Una libreta de contactos: agregas, consultas, corriges y tachas. Tachar es borrado suave; arrancar la hoja es borrado real.
🏢 En chzr.llc: Una cotización «eliminada» en Quote Link sigue en la base con estado «eliminado»: se conserva el rastro y se puede revisar.
😵 Lo que confunde: Creer que «borrar» siempre significa quitar de verdad. En sistemas con dinero casi nunca conviene.
🤖 Si no lo sabes, la IA…: A veces hace un borrado real sin preguntar; se pierde el rastro para siempre y no queda auditoría.

Mini reto: ¿Por qué un contador prefiere «anular» un recibo en lugar de arrancarlo?

Consulta (query) y SQL

Una pregunta que se le hace a la base de datos: «dame las cotizaciones de este mes de más de $5,000». SQL es el idioma en que se escribe esa pregunta.

🍽️ Analogía: Pedirle a la recepcionista del archivero: «tráeme todos los folios de marzo».
🏢 En chzr.llc: El tablero de Finanzas es, por debajo, preguntas como «suma los gastos de gasolina de este mes de este negocio».
😵 Lo que confunde: Creer que hay que saber SQL para dirigir a una IA. Basta con saber pedir bien la pregunta.
🤖 Si no lo sabes, la IA…: Puede hacer consultas que traen datos de otros negocios porque nadie le dijo «siempre limita por negocio».

Mini reto: Escribe en español la pregunta para «los gastos de gasolina de septiembre».

Índice

Un atajo que hace que buscar sea rápido cuando hay muchísimos datos.

🍽️ Analogía: El índice del libro: no lees todas las páginas para encontrar «IVA».
🏢 En chzr.llc: Las tablas donde se guardan bitácoras tienen índices por usuario y fecha para que los límites diarios se calculen rápido.
😵 Lo que confunde: Creer que más índices siempre es mejor: cada uno hace un poco más lento el guardar.
🤖 Si no lo sabes, la IA…: Suele olvidarlos, y todo funciona «bien» hasta que la tabla crece y la pantalla tarda segundos.

Mini reto: ¿En qué momento notarías que a tu sistema le falta un índice?

Normalización («no repitas datos»)

Guarda cada dato una sola vez y refiérete a él por su identificador.

🍽️ Analogía: En la libreta de fiado no escribes la dirección de la señora Lupe en cada renglón: escribes «Lupe» y su ficha vive en otra página.
🏢 En chzr.llc: El sistema universal de contactos: una persona es una sola ficha que usan todas las apps, en lugar de que cada app tenga su propia lista.
😵 Lo que confunde: Creer que repetir «es más fácil». Lo es, hasta que el dato cambia.
🤖 Si no lo sabes, la IA…: Puede duplicar el nombre y el teléfono del cliente en seis tablas distintas.

Mini reto: Si Lupe cambia de teléfono, ¿en cuántos lugares tienes que corregirlo?

Transacción (todo o nada)

Un grupo de pasos que se guardan todos juntos o ninguno.

🍽️ Analogía: Una transferencia bancaria: si el dinero salió de tu cuenta pero no llegó a la otra, se revierte todo.
🏢 En chzr.llc: Al agendar una cita, el sistema guarda la cita y sus servicios dentro de una transacción y vuelve a verificar que el horario siga libre, para que dos clientes no tomen el mismo horario.
😵 Lo que confunde: Creer que «a la vez» no pasa. Pasa, y es la causa de errores raros que no se repiten cuando los buscas.
🤖 Si no lo sabes, la IA…: Puede guardar la cita y luego los servicios en dos pasos separados; si el segundo falla, queda una cita a medias.

Mini reto: ¿Qué pasaría si dos clientes reservan el mismo horario en el mismo segundo?

⚙️ La lógica

Cómo se piensan los procesos antes de programarlos.

Algoritmo

Una receta: pasos claros, en orden, que siempre dan el mismo resultado.

🍽️ Analogía: La receta del arroz: si sigues los pasos, sale arroz.
🏢 En chzr.llc: El «¿cabe esta cita?» de Citas: ¿el servicio existe?, ¿el proveedor lo ofrece?, ¿cae dentro de su horario?, ¿no está bloqueado ese día?, ¿no choca con otra cita? Si un paso falla, se dice cuál.
😵 Lo que confunde: Creer que «algoritmo» es cosa de matemáticos. Es una receta con reglas, y conviene pensarla con «¿y si…?».
🤖 Si no lo sabes, la IA…: Escribe recetas que funcionan en la demostración y fallan con los casos raros; solo los encuentras si preguntas «¿y si dos lo hacen a la vez?».

Mini reto: Escribe en cinco pasos cómo decides si aceptas o no un fiado.

Los cuatro ladrillos: variable, condición, ciclo, función

Variable: una cajita con nombre donde guardas un dato. Condición: «si pasa esto, haz aquello». Ciclo: «repite esto para cada uno». Función: una receta con nombre que puedes llamar cuando quieras.

🍽️ Analogía: Cocinar: cajitas de ingredientes; «si está frío, calienta»; «para cada tortilla, voltea»; y «receta de salsa» que reutilizas.
🏢 En chzr.llc: Calcular el total de una cotización usa los cuatro: un ciclo por cada concepto, una variable de subtotal, una condición «si hay descuento» y una función «calcular IVA».
😵 Lo que confunde: Creer que hay que memorizar la sintaxis. Lo importante es reconocer los cuatro ladrillos al leer lo que escribe la IA.
🤖 Si no lo sabes, la IA…: Suele repetir el mismo código copiado diez veces en lugar de crear una función; el día que cambia una regla hay que corregir diez lugares.

Mini reto: ¿Qué ladrillo usarías para «ponerle IVA a cada renglón»?

Pseudocódigo y diagrama de flujo

Escribir o dibujar la receta en español y con cajas antes de programar.

🍽️ Analogía: El croquis antes de construir la casa.
🏢 En chzr.llc: El flujo de la mascota de chzr.llc (proponer → validar → confirmar → ejecutar → deshacer) es un diagrama de cinco cajas.
😵 Lo que confunde: Pensar que dibujar es perder tiempo. Es lo más barato que existe para encontrar un error.
🤖 Si no lo sabes, la IA…: Programa lo que entendió, no lo que querías. Un dibujo de cinco cajas evita dos horas de malentendido.

Mini reto: Dibuja «cobrar en la tienda» con un rombo de decisión.

Máquina de estados

Algo que solo puede estar en un estado a la vez y solo puede pasar a ciertos otros.

🍽️ Analogía: Un semáforo, o un paquete: «preparado → enviado → entregado»; no salta de «preparado» a «entregado».
🏢 En chzr.llc: Una cotización pasa de borrador a enviada y luego a aceptada, rechazada o vencida (y puede quedar eliminada). Los botones de la pantalla solo muestran el siguiente paso posible.
😵 Lo que confunde: Permitir cualquier salto («aceptada → borrador»). Rompe la historia de lo que pasó.
🤖 Si no lo sabes, la IA…: Suele dejar cambiar el estado desde cualquier lado y sin reglas.

Mini reto: ¿Se puede pasar de «rechazada» a «enviada»? ¿Debería?

Pruebas y casos que deben fallar

Comprobar que el sistema hace lo correcto y también que rechaza lo incorrecto.

🍽️ Analogía: Probar la sopa antes de servirla y, además, intentar servirla sin sal a propósito para ver si te das cuenta.
🏢 En chzr.llc: La mascota de chzr.llc se probó con casos malos a propósito: monto cero, categoría de otro negocio, fecha imposible, herramienta inventada. Todos deben ser rechazados.
😵 Lo que confunde: Probar solo el «camino feliz».
🤖 Si no lo sabes, la IA…: Suele decir «listo» porque el código compiló, sin haberlo probado nunca con una petición real.

Mini reto: Escribe tres datos «malos» para un campo de teléfono.

🧱 Objetos y piezas

Cómo se organiza el código para no escribir lo mismo mil veces.

Clase y objeto

La clase es el molde (el plano); el objeto es una pieza hecha con ese molde (la casa).

🍽️ Analogía: El molde de galletas y las galletas.
🏢 En chzr.llc: La clase que sabe hablar con la base de datos es un molde; el sistema crea un objeto y todas las pantallas lo usan. Otro molde sirve para leer y escribir cualquier tabla; se crea una pieza por tabla.
😵 Lo que confunde: Mezclar «clase» y «objeto». Clase es la idea; objeto es la cosa concreta.
🤖 Si no lo sabes, la IA…: Suele crear veinte versiones casi iguales del mismo código en lugar de un molde reutilizable.

Mini reto: En «Persona», ¿Juan es la clase o el objeto?

Propiedades y métodos

Las propiedades son lo que el objeto tiene (datos); los métodos son lo que sabe hacer (acciones).

🍽️ Analogía: Un perro: tiene nombre y edad (propiedades); sabe ladrar y sentarse (métodos).
🏢 En chzr.llc: La mascota de la plataforma tiene propiedades (tamaño, posición, pose) y métodos (mostrar una pose, brincar, decir algo, abrir el chat).
😵 Lo que confunde: Creer que las propiedades son «cosas raras». Son solo los datos del objeto; los métodos son sus verbos.
🤖 Si no lo sabes, la IA…: Se equivoca de nombre: en un caso real el sistema guardaba la sesión con un nombre y el código buscaba otro; la mascota no aparecía hasta que se encontró la diferencia.

Mini reto: «Ocultar», ¿es una propiedad o un método de la mascota?

Herencia y encapsulamiento

Herencia: una versión especial que aprovecha lo de la general. Encapsulamiento: lo de adentro se maneja con botones, no metiendo la mano.

🍽️ Analogía: El control remoto: usas botones sin abrir la tele. Un «control de aire» hereda lo básico de «control remoto».
🏢 En chzr.llc: La mascota es un elemento web propio que hereda de los elementos básicos de HTML, y sus partes internas se manejan por métodos.
😵 Lo que confunde: Creer que son obligatorias en todo proyecto. Muchos proyectos (como este) usan poca herencia y funcionan muy bien.
🤖 Si no lo sabes, la IA…: Le encanta crear árboles de herencia complicados donde un par de funciones sencillas bastaban.

Mini reto: ¿Qué ganas con no tener que abrir la tele para cambiar de canal?

Módulo, biblioteca y framework

Módulo: una pieza que hace una cosa. Biblioteca: una caja de herramientas que tú usas. Framework: la estructura ya armada donde pones tus cuartos.

🍽️ Analogía: La biblioteca es el martillo y los clavos; el framework, una casa prefabricada; el módulo, un cuarto.
🏢 En chzr.llc: chzr.llc no usa framework a propósito (control y costo); tiene sus bibliotecas propias en un solo lugar y cada app es un módulo.
😵 Lo que confunde: Pensar que «sin framework» es «mal». Es una decisión con costos y ventajas, no un defecto.
🤖 Si no lo sabes, la IA…: Suele meter una biblioteca nueva para cada problema pequeño; con el tiempo el proyecto depende de veinte cosas que nadie vigila.

Mini reto: ¿Una tabla de precios que ya tienes es una biblioteca o un framework?

API y endpoint

La ventanilla por la que un programa le pide cosas a otro programa, con reglas.

🍽️ Analogía: El mesero: pides del menú, él lleva a la cocina y te trae el plato. Tú no entras a la cocina.
🏢 En chzr.llc: La mascota le pide al servidor «pregunta», «confirma» o «deshaz»; la IA que la hace hablar también se usa a través de su API.
😵 Lo que confunde: Creer que la API es «una app». Es la ventanilla, no la cocina.
🤖 Si no lo sabes, la IA…: Puede dejar la ventanilla abierta sin revisar quién pide, es decir, sin permisos.

Mini reto: ¿Qué le pedirías «al mesero» para crear una cotización?

🌐 La web y la seguridad

Cómo se comunican tu pantalla y el servidor, y cómo se protege todo.

Cliente y servidor (frontend y backend)

El cliente es tu pantalla (el navegador); el servidor es la computadora que guarda y decide. Lo que ves es el frontend; lo que pasa detrás, el backend.

🍽️ Analogía: El salón del restaurante (frontend) y la cocina (backend).
🏢 En chzr.llc: El navegador muestra el formulario; el servidor recibe, valida y guarda. Los totales de una cotización los recalcula siempre el servidor.
😵 Lo que confunde: Confiar en lo que calcula el navegador: cualquiera puede alterarlo.
🤖 Si no lo sabes, la IA…: Suele validar solo en la pantalla, que es justo la parte que un curioso puede saltarse.

Mini reto: ¿Quién debe decidir si un precio es válido: el salón o la cocina?

Petición, respuesta, sesión y cookie

El navegador pide, el servidor responde. El servidor no te recuerda entre pedidos, salvo que te dé una «pulsera» (cookie) que lo identifica: eso es la sesión.

🍽️ Analogía: Un antro con pulsera: entras, te ponen pulsera y en cada puerta la revisan.
🏢 En chzr.llc: Al iniciar sesión se guarda quién eres y cuál es tu negocio por defecto; cada pantalla lo consulta.
😵 Lo que confunde: Creer que la cookie es la contraseña. Es solo la pulsera, y por eso hay que cuidarla.
🤖 Si no lo sabes, la IA…: Puede confiar en un dato que viaja por la petición en lugar de leerlo de la sesión.

Mini reto: ¿Qué pasa si alguien te copia la pulsera?

Autenticación y autorización

Autenticación: ¿quién eres? Autorización: ¿qué puedes hacer?

🍽️ Analogía: La credencial en la puerta (quién eres) y las llaves de cada cuarto (qué puedes abrir).
🏢 En chzr.llc: El dueño del negocio puede todo; el personal solo lo que se le concede por app (crear, editar, borrar).
😵 Lo que confunde: Creer que estar «dentro» basta. Cada acción se revisa.
🤖 Si no lo sabes, la IA…: Revisa que hayas iniciado sesión, pero no que tengas permiso para lo que pides.

Mini reto: ¿Un empleado que ya entró debería poder borrar todas las cotizaciones?

Cifrado, hash y secretos

Cifrar: guardar de forma que solo con la llave se puede leer. Hash: convertir algo (una contraseña) en una «huella» de la que no se puede volver atrás. Secreto: una llave que nunca va escrita en el código.

🍽️ Analogía: Cifrar es una caja fuerte; el hash es una licuadora (no puedes des-licuar); el secreto es la llave de la caja, guardada aparte.
🏢 En chzr.llc: Las contraseñas se guardan como hash, no como texto; las llaves de servicios viven en un archivo de configuración fuera del código y protegido.
😵 Lo que confunde: Creer que «encriptar» y «hashear» son lo mismo.
🤖 Si no lo sabes, la IA…: Puede dejar una llave escrita dentro del código, o guardar un respaldo en una carpeta pública. Por eso hay que pedirle auditorías.

Mini reto: ¿Por qué un sistema bien hecho no puede «recordarte» tu contraseña, solo cambiarla?

Token de un solo uso (CSRF)

Un boleto que el servidor te da con cada formulario y que solo sirve una vez; así nadie puede mandar un formulario «en tu nombre» desde otra página.

🍽️ Analogía: El boleto del cine con talón: se rompe al entrar.
🏢 En chzr.llc: Cada respuesta del servidor a la mascota trae un token nuevo; el anterior ya no sirve.
😵 Lo que confunde: Creer que una contraseña bastaría. El token protege otra cosa: que la petición venga realmente de tu pantalla.
🤖 Si no lo sabes, la IA…: Suele olvidar verificar el token en un formulario nuevo, o aceptar peticiones que ni lo traen.

Mini reto: ¿Qué pasa si alguien reutiliza un boleto que ya se rompió?

Multi-negocio (multi-tenant)

Un mismo sistema sirve a muchos negocios sin que se vean entre sí.

🍽️ Analogía: Un edificio de departamentos: la misma estructura, cada quien con su llave.
🏢 En chzr.llc: Todo dato de negocio lleva la identificación de su negocio y toda consulta lo filtra.
😵 Lo que confunde: Creer que basta con «esconder» los datos de otros en pantalla.
🤖 Si no lo sabes, la IA…: Puede escribir una consulta sin el filtro de negocio y traer datos de todos: es la falla más grave en este tipo de sistema.

Mini reto: Si una consulta olvida el filtro de negocio, ¿qué ve el cliente?

Entornos y despliegue

Local es tu mesa de pruebas; producción es la tienda abierta con clientes; desplegar es pasar lo probado a la tienda.

🍽️ Analogía: Ensayar la obra en casa y luego el estreno.
🏢 En chzr.llc: Se programa en la computadora local, se sube al servidor y se verifica cada dirección; los datos de prueba se borran al terminar.
😵 Lo que confunde: Probar directamente en la tienda con clientes reales.
🤖 Si no lo sabes, la IA…: Suele «arreglar» directo en producción y romper algo sin avisar.

Mini reto: ¿Por qué es peligroso probar con datos reales de clientes?

📐 Modelar y documentar

Cómo se deja escrito lo que se construye, para que otros (y tú mismo) lo entiendan.

Qué diagrama sirve para qué

Cada diagrama responde una pregunta distinta. Flujo: ¿cuál es el proceso? Entidad-relación: ¿qué datos hay y cómo se conectan? Casos de uso: ¿quién hace qué? Secuencia: ¿quién habla con quién y en qué orden? Estados: ¿por qué situaciones pasa algo?

🍽️ Analogía: El croquis del camino (flujo), el organigrama de los archiveros (datos), el reparto de una obra (casos de uso), el guion de una llamada (secuencia), el semáforo (estados).
🏢 En chzr.llc: El flujo de la mascota es un diagrama de secuencia; los estados de una cotización, un diagrama de estados; cotización y conceptos, un diagrama de datos.
😵 Lo que confunde: Querer un diagrama de doscientas cajas. Uno útil responde una sola pregunta.
🤖 Si no lo sabes, la IA…: Programa sin haber acordado el dibujo: cada quien entendió otra cosa. Con un diagrama en texto se le puede dar el plano exacto.

Mini reto: ¿Qué diagrama usarías para explicar quién puede aprobar un gasto?

UML (sin miedo)

Un idioma común para dibujar sistemas: los mismos símbolos para que dos personas (o una persona y una IA) se entiendan. De todos sus diagramas, cuatro bastan: casos de uso, clases, secuencia y estados.

🍽️ Analogía: La notación musical: cualquiera que la lea toca la misma canción. Una clase se dibuja como una caja con tres partes: nombre, propiedades y métodos.
🏢 En chzr.llc: Una caja «Cotización» con propiedades (folio, cliente, total, estado) y métodos (calcular totales, cambiar estado).
😵 Lo que confunde: Creer que UML es «solo para ingenieros». Es para poner de acuerdo a la gente.
🤖 Si no lo sabes, la IA…: A una IA le sirve muchísimo que le pases el diagrama, o su versión en texto, en lugar de un párrafo ambiguo.

Mini reto: Dibuja la caja de «Cliente» con tres propiedades y dos métodos.

Documentación

Escribir lo que hiciste y por qué, para quien venga después: incluido tú dentro de seis meses y la IA en su próxima sesión.

🍽️ Analogía: El manual del coche, el cuaderno de mantenimiento y la hoja de emergencias.
🏢 En chzr.llc: chzr.llc usa cuatro tipos: un archivo de referencia estable (qué es, reglas, trampas), una bitácora (qué se hizo y qué no se probó), manuales de usuario y un archivo de planes y decisiones.
😵 Lo que confunde: Creer que documentar es «para después». Sin documentación, cada sesión con la IA empieza de cero.
🤖 Si no lo sabes, la IA…: Sin documentación estuvo a punto de construir algo que ya existía: un constructor de formularios que ya estaba hecho.

Mini reto: ¿Qué le dirías a alguien que hereda tu negocio para que no tire lo que sí funciona?

Requisitos y alcance

Lo que el sistema debe hacer y también lo que no hará.

🍽️ Analogía: La lista del súper y el límite del presupuesto.
🏢 En chzr.llc: Cada módulo de chzr.llc se define primero con una ficha: datos, estados, permisos, pantallas y casos que deben fallar.
😵 Lo que confunde: Creer que más funciones es mejor. Lo que NO se hace es la mitad del plan.
🤖 Si no lo sabes, la IA…: Si no le pones límites, agrega funciones que nadie pidió y complica lo que ya funcionaba.

Mini reto: Escribe tres cosas que tu sistema NO va a hacer.

Ojo: las analogías simplifican a propósito. Sirven para entender la idea y empezar a hablar el idioma; los detalles técnicos finos los verás cuando los necesites. Los ejemplos de chzr.llc son reales, pero se resumen sin datos internos.

¿Quieres verlo en video?

Estamos preparando una serie donde cada concepto se explica en una cápsula corta y se aplica construyendo una plataforma real con IA, incluidos los errores. Mientras tanto, revisa también la guía de prompts.

Guía de prompts