Decisiones técnicas documentadas
Registro de decisiones tomadas en Paraguay durante el desarrollo de nuestros propios productos en validación: qué se evaluó, qué se decidió y por qué.
Un decision record no es un caso de éxito ni una guía general: es el registro de una decisión técnica puntual, con las alternativas que se evaluaron y la razón por la que se eligió una sobre otra. 13 decisiones documentadas hasta ahora, entre Pymerce y Pyae.
Decisiones de Pymerce
- Multi-tenencia preparada sin sobrediseñar
- El acceso a datos se centraliza en un contexto de tenant desde el MVP, sin depender de una base única en el código.
- Inventario por ubicación, no cantidad global de producto
- El inventario se modela de forma transaccional por ubicación y producto, con movimientos históricos.
- Separar el registro fiscal de la operación de venta
- La venta se confirma antes de ejecutar la comunicación con el ente fiscal.
- Decidir mediante prueba técnica, no supuesto
- Las decisiones de base se validan con pruebas técnicas reproducibles antes de consolidarlas.
- Autenticación propia en vez de proveedor externo
- Se implementa autenticación propia con sesiones protegidas, registro y recuperación segura.
- No crear un modo mayorista separado
- Retail y mayorista se tratan como perfiles del mismo dominio, sin duplicar lógica.
- Diferir funcionalidades hasta validar el perfil inicial
- Compras, alertas de stock y otras capacidades se posponen hasta validar el flujo base.
Decisiones de Pyae
- Aislamiento de sesión por restaurante
- El acceso y la sesión se resuelven por restaurante, identificado por su propio tenant.
- Actualizaciones en tiempo real para cocina y pedidos
- Los cambios de estado de pedidos y cocina se distribuyen en tiempo real por sucursal.
- Integración de mensajería desacoplada del dominio
- La mensajería se define mediante una capa intermedia reemplazable, con alternativa de prueba.
- Idempotencia y bloqueo para evitar pedidos y pagos duplicados
- Se aplica idempotencia persistida y bloqueo distribuido a pedidos y pagos.
- Separar el estado del pedido del estado del cobro
- La entrega se evalúa por el saldo pendiente, no por el estado general de la venta.
- Modificar un pedido en curso sin corromper el total
- Los items se agregan y el pedido se recalcula dentro de una única operación transaccional con reintento.
Preguntas frecuentes
- ¿Qué es un decision record?
- Es el registro de una decisión técnica o de producto puntual: qué alternativas se evaluaron, cuál se eligió y por qué. No es un caso de éxito ni una guía general, es evidencia de un criterio aplicado en un desarrollo real.
- ¿Por qué Flexora publica sus decisiones técnicas?
- Para mostrar el criterio detrás del desarrollo de software, no solo el resultado final. Los registros de esta sección corresponden a Pymerce y Pyae, dos productos SaaS propios de Flexora desarrollados en Paraguay y todavía en validación.
¿Necesitás decisiones técnicas así de claras para tu proyecto?
Documentamos y sostenemos decisiones técnicas con la misma rigurosidad en el software a medida que desarrollamos para empresas.