Decisiones técnicas fundacionales de plataforma
Definí las decisiones fundacionales de la plataforma durante las
semanas siguientes a la apertura del repositorio en noviembre de
2025 — la separación en capas, el acceso a datos centrado en la base
de datos y el criterio de cero advertencias —, que seguían vigentes
nueve meses después.
2025

Situación. El repositorio se abrió el 25 de noviembre de 2025 sin
contenido. Lo que se decide durante las primeras semanas de un
proyecto así tiene una importancia desproporcionada: las capas,
dónde puede residir la lógica de negocio y cuál es el nivel de
calidad exigido. Esas decisiones son baratas en el tercer día y casi
imposibles de revertir al sexto mes, cuando todo lo escrito desde
entonces ya las da por supuestas.

Tarea. Había que tomar las decisiones fundacionales de forma
deliberada y temprana, y expresarlas de un modo que pudiera
sobrevivir a su traspaso a otras personas y a una base de código
mucho mayor que la existente entonces.

Acción. Tres decisiones hicieron la mayor parte del trabajo. La
arquitectura se dividió en capas para que cada parte tuviera una
sola función — un frontend Next.js, una API Go que valida y reenvía
y una capa de funciones PostgreSQL responsable de las reglas de
negocio — en lugar de situar la lógica donde resultara cómodo esa
tarde. El acceso a los datos quedó detrás de funciones almacenadas
desde el principio, la decisión de la que se deriva todo lo demás
descrito sobre la base de datos; incorporarlo después habría exigido
reescribir todos los controladores. Además, se estableció un nivel
de cero advertencias antes de que hubiera mucho código al que
aplicarlo, porque introducir un estándar en el commit 5.000 es un
proyecto de limpieza, mientras que el mismo estándar en el commit 50
es simplemente la forma de funcionar del repositorio. Ninguna de las
tres decisiones era la opción fácil entonces, y las tres restaron
impulso durante el primer mes.

Resultado. Nueve meses y varios miles de commits después, las tres
siguen vigentes: las capas no se han desdibujado, ningún controlador
accede directamente a una tabla y la compilación sigue sin
advertencias. Esa es la comprobación que merece aplicarse a una
decisión fundacional — no si sonaba bien, sino si sobrevivió al
contacto con el volumen de trabajo posterior, que es el punto en el
que las decisiones cómodas suelen abandonarse silenciosamente.

Categorías:
1Arquitectura de plataformas	/es/categories/platform-architecture/	engineer.company	70
1Arquitectura de soluciones	/es/categories/solution-architecture/	engineer.company	70
1Ingeniería de backend	/es/categories/backend/	engineer.company	70
1Ingeniería de frontend	/es/categories/frontend/	engineer.company	70
1Desarrollo integral	/es/categories/full-stack/	engineer.company	70
1Bases de datos	/es/categories/databases/	engineer.company	70
1DevOps	/es/categories/devops/	engineer.company	70
1Seguridad	/es/categories/security/	engineer.company	70
1Dirección de equipos	/es/categories/team-leadership/	engineer.company	70
1Dirección técnica	/es/categories/technical-leadership/	engineer.company	70

Servicios:
1Arquitectura de plataformas y soluciones	/es/services/platform-architecture/	engineer.company	70
1Desarrollo de backend y API	/es/services/backend-development/	engineer.company	70
1Desarrollo de frontend	/es/services/frontend-development/	engineer.company	70
1Desarrollo integral de producto	/es/services/full-stack-development/	engineer.company	70
1Dirección técnica y consultoría	/es/services/technical-leadership/	engineer.company	70

hEsta página en la web	URL:https://engineer.company/es/portfolio/set-the-platforms-founding-technical-decisions/	engineer.company	70
