El vocabulario, sin humo
[Diez palabras que aparecen en todos los tutoriales y casi nunca se explican. Sin esto, el resto no se entiende. Ejemplos: qué es una app web, Git/GitHub, Vercel, migraciones, RLS, cron...]
[Término 1]
[Explicación en dos frases, con ejemplo concreto del proyecto.]
[Traducción del término a una analogía cotidiana, para el que no programa.]
El origen
[Cómo empezó: la herramienta más tonta que resolvía el problema de hoy. Un archivo, una planilla, un script. Por qué funcionó, por qué se acabó.]
Por qué funcionó
- Cero fricción. [Abrir el archivo era usarlo. Sin instalar, sin cuentas.]
- Iteración en segundos. [Cambiar y recargar, sin compilar.]
- Obligó a definir las reglas primero. [Sin framework donde esconderse, la lógica queda desnuda.]
Por qué se acabó
- [Los datos vivían en una sola computadora.] [Qué pasaba cuando el equipo los necesitaba.]
- [Una sola persona podía usarlo.] [El problema real no era registrar: era coordinar.]
- [Cada función engordaba el mismo archivo.] [Cambiar algo = miedo a romper otra cosa.]
Empezar con la herramienta más tonta que resuelva el problema de hoy no es hacerlo mal: es la forma de descubrir cuál es el problema de verdad. Se migró cuando el techo era real y evidente, no cuando alguien dijo «esto debería ser una app».
La arquitectura que quedó
[Cuatro decisiones estructurales tomadas al principio. Las cuatro siguen de pie N commits después, que es la única prueba que vale.]
1 · [Decisión estructural 1]
[Qué se decidió y por qué. El valor no es la elegancia: es que al abrir el proyecto ya sabes dónde está todo.]
2 · [Decisión estructural 2]
[Ej.: las reglas de negocio viven aparte, se prueban solas, no dependen de la cocina.]
3 · [Decisión estructural 3]
[Ej.: nada se guarda si se puede deducir. Si depende del calendario, se calcula.]
4 · [Decisión estructural 4]
[Ej.: migraciones aditivas y código que sobrevive sin ellas — «que degrade, no que reviente».]
[El aviso automático que se propuso y se descartó, y la razón que merece copiarse. Todo proceso sin supervisión tiene un fallo silencioso.]
El museo de errores
[N] trampas reales. Cada una enseña el síntoma y tres posibles causas: elige antes de leer la respuesta. Los distractores no son inventados — son los diagnósticos que de verdad se dieron primero.
[El patrón que salta a la vista leyéndolas seguidas. Casi siempre: fallaron en silencio, o dieron un síntoma que apuntaba al lugar equivocado. Los errores ruidosos son los baratos.]
Las normas que salieron de los golpes
Ninguna se decidió en una reunión. Cada una es la cicatriz de algo que salió mal, escrita para no repetirlo.
Sobre [tema 1]
- [Norma.] [Contexto: el golpe del que salió.]
- [Norma.] [Contexto.]
Sobre [tema 2]
- [Norma.] [Contexto.]
- [Norma.] [Contexto.]
Dinero y límites reales
[Todo esto corre en [planes gratuitos/presupuesto X]. Vale la pena saber exactamente dónde está el techo, porque en gratuito no llega una factura sorpresa: llega un corte.]
| # | Techo | Tipo | Cuándo |
|---|---|---|---|
| 1 | [Límite 1] | Regla, no cupo | [Ya / fecha] |
| 2 | [Límite 2] | Técnico | [Primer techo real] |
| 3 | [Límite 3] | Técnico | [Estimación] |
El techo que nadie ve venir
[El costo oculto del proyecto: tráfico vs almacenamiento, tiempo manual, deuda técnica. Lo que se creía que costaba vs lo que cuesta de verdad.]
Laboratorio: [simulador simple]
Qué haría distinto
La parte incómoda. Sin esto, lo anterior es publicidad.
Lo que salió bien y repetiría igual
- [Decisión 1]
- [Decisión 2]
- [Decisión 3]
Lo que costó caro
- [Error de proceso 1] — [qué costó, cómo se cerró para siempre.]
- [Error de proceso 2] — [qué costó, cómo se cerró para siempre.]
- [Error de proceso 3] — [qué costó, cómo se cerró para siempre.]
[La forma que comparten las tres decisiones que más valor dieron. Copiar esa forma en todo lo que viene.]
Diccionario
Los términos que aparecen en esta bitácora y en cualquier proyecto parecido. Escribe para filtrar.
- [Término]
- [Definición en una línea.]
- [Término]
- [Definición en una línea.]
- [Término]
- [Definición en una línea.]
- [Término]
- [Definición en una línea.]