Racoonity Racoonity
📍 Mapa de construcción pública

Estamos construyendo el Primer MVP de Racoonity.

Este roadmap muestra cómo lo estamos levantando, iteración por iteración. No representa el destino final del producto: es la primera etapa de un camino mucho más grande.

“Simple por defecto. Monstruoso por elección.”

Explorar el mapa (I0 → I9) Ver horizonte futuro
racoonity // roadmap-tree.spec
🦝 Racoonity Core
En construcción Primer MVP

Iteraciones I0 → I9

I0
I1
I2
I3
I4...I9
Por definir Próximo MVP

Siguientes etapas de producto

Horizonte Evolución Futura

Artifier Avanzado, Workflows, Agent

Sin humo. Sin fechas inventadas. Solo milestones reales.
Senderos & Estaciones

El plano de construcción del Primer MVP

Recorrido paso a paso desde el primer latido del sistema hasta el paquete final del Primer MVP. Cada estación representa un avance vertical probado y utilizable.

I0

Primer latido

Completado

API, PostgreSQL, contratos, actions, queries y transactions.

Construcción de la columna vertebral mínima de ejecución de Racoonity. Garantiza que el sistema arranque de forma limpia, conecte a la base de datos y ejecute operaciones protegidas por contratos y rollback explícito.

Resultado demostrable

Runtime ejecutable con PostgreSQL, registro dinámico de capacidades, outbox transaccional y normalización de errores con Correlation ID.

Capacidades / Dominios:
Racoon Guildmaster MínimoRacoon Dispatcher MínimoRacoon Librarian MínimoRacoon Foreman (Transactions)Outbox Pattern TransaccionalIdempotency Table & PublicError
Ver referencias y bitácora de construcción

📖 Bitácora de construcción

29 de julio de 2026 · 4 min
Cómo estamos construyendo Racoonity
Leer historia →
30 de julio de 2026 · 7 min
Racoonity ya tiene pulso
Leer historia →

📐 Conocer la arquitectura

Racoon Guildmaster (Capability Registry) ↗ Racoon Dispatcher (Action Engine) ↗ Racoon Librarian (Query Engine) ↗ Racoon Foreman (Transaction Manager) ↗
I1

Abrir la tienda

Completado

Setup, login, compañía, sucursal, usuario y contexto.

Inicializar una instalación vacía desde cero y habilitar acceso seguro. Permite crear la primera compañía, definir sucursal operativa y autenticar al administrador inicial.

Resultado demostrable

Asistente de inicialización atómico e idempotente, autenticación de usuarios y contexto operativo de empresa y sucursal.

Capacidades / Dominios:
Organization & Identity DomainsPermissions Engine (Bouncer v1)Setup Wizard AtómicoSession Context ResolverDefault Location & Payment Setup
Ver referencias y bitácora de construcción

📖 Bitácora de construcción

1 de agosto de 2026 · 8 min
Abrir la tienda: Racoonity ya sabe quién eres
Leer historia →

📐 Conocer la arquitectura

Racoon Bouncer (Permission Engine) ↗
I2

Primer catálogo dinámico

Completado

Categorías y productos mediante Atlas y Painter.

Demostrar la primera ruta orientada al negocio mediante el catálogo de Categorías y Productos, consumiendo contratos de metadata e interfaces generadas dinámicamente.

Resultado demostrable

Productos y categorías administrables de extremo a extremo, con control de SKU único, precios, códigos de barra y renderizado dinámico.

Capacidades / Dominios:
Catalog DomainProducts & Categories TreeAtlas Model-View ResolverPainter UI Engine RenderingSKU & Barcode Validation
Ver referencias y bitácora de construcción

📖 Bitácora de construcción

4 de agosto de 2026 · 5 min
Racoonity ya entiende productos
Leer historia →

📐 Conocer la arquitectura

Racoon Atlas (Metadata Resolver) ↗ Racoon Painter (Schema & UI Engine) ↗
I3

La mercancía existe en algún lugar

En construcción / Iteración actual

Ubicaciones, balances, movimientos e inventario inmutable.

Racoonity aprende cuánto inventario existe, en qué bodegas o pisos se encuentra ubicado y cómo fue registrado o transferido.

Resultado demostrable

Control físico de mercancía por ubicación, balances no negativos, registro inmutable de movimientos y transferencias atómicas entre almacenes.

⚙️ Transferencia atómica de inventario
Bodega Central: 20 unidades
Piso de Venta: 0 unidades
→ Acción: inventory.transfer (8 unidades)
Bodega Central: 12 unidades
Piso de Venta: 8 unidades
Resultado: Balance actualizado + Movimientos auditables
Capacidades / Dominios:
Inventory Locations & Sales LocationStock Balances per LocationImmutable Movement LedgerAtomic Stock TransfersConcurrency Control
Ver referencias y bitácora de construcción

📐 Conocer la arquitectura

Racoon Warehouse (Persistence Abstraction) ↗
I4

Preparar la operación diaria

Planeado

Clientes, cajas, sesiones operativas y medios de pago.

Establecer las entidades comerciales previas al punto de venta: padrón de clientes, terminales de caja registradora y apertura/cierre de turnos de cajeros.

Resultado demostrable

Directorio de clientes, flujo de apertura y cierre de sesión de caja por turno y configuración de métodos de pago aceptados.

Capacidades / Dominios:
Customers DirectoryRegister Session LifecycleOperating Context ResolutionPayment Methods Configuration
I5

Primera venta real

Planeado

POS, venta atómica, pago, inventario, ticket y outbox.

El corazón transaccional de Racoonity. Registrar ventas en mostrador revalidando precios, descontando inventario en tiempo real y garantizando idempotencia.

Resultado demostrable

Venta comercial completa, atómica e idempotente con emisión de comprobante y disparo de eventos de dominio outbox.

Capacidades / Dominios:
POS Operational InterfaceAtomic Confirm Sale ActionReal-time Stock DeductionIdempotency ProtectionReceipt Generation & Outbox Events
Ver referencias y bitácora de construcción

📐 Conocer la arquitectura

Racoon Stamp (Idempotency Manager) ↗ Racoon Herald (Domain Event Engine) ↗
I6

Control y supervisión

Planeado

Cancelaciones, arqueo, dashboard operativo y reportes.

Cerrar el ciclo operacional del turno comercial mediante la posibilidad de cancelar ventas atómicamente, consolidar caja y consultar resúmenes en vivo.

Resultado demostrable

Cancelación total con restitución de inventario a la ubicación original, arqueo de turno y exportación de reportes a CSV.

Capacidades / Dominios:
Atomic Sale CancellationSession Consolidation & Force CloseReal-time Operational DashboardPublic Queries ReportingCSV Data Export
I7

Construir el monstruo

Planeado

Primera capa de Racoon Artifier: campos custom, modelos y navegación.

Demostrar la extensibilidad declarativa sin tocar código. El administrador amplía modelos existentes o crea nuevas entidades de negocio con sus vistas y menús automáticos.

Resultado demostrable

Agregar campos a productos o crear un modelo completo (ej. Reparaciones) en tiempo de ejecución sin reiniciar el sistema ni modificar código fuente.

Capacidades / Dominios:
Racoon Artifier v1 (Model & View Builder)Racoon Scribe (Dynamic Records Coordinator)Custom Fields on Core ModelsNew Custom Entities CreationAutomatic Menu & UI Generation
Ver referencias y bitácora de construcción

📖 Bitácora de construcción

2 de agosto de 2026 · 6 min
La demo que nos obligó a definir Racoon Artifier
Leer historia →

📐 Conocer la arquitectura

Racoon Artifier (Personalization Environment) ↗ Racoon Scribe (Dynamic Record Coordinator) ↗
I8

Demostrar extensibilidad

Planeado

Courier, Observer, reintentos e idempotencia.

Probar la arquitectura desacoplada orientada a eventos. Un módulo observador reacciona a la confirmación de ventas sin alterar el módulo de ventas.

Resultado demostrable

Entrega asíncrona de eventos con garantías at-least-once, consumidores resilientes y tolerancia a fallos aislados.

Capacidades / Dominios:
Racoon Courier Event BrokerSales Observer ModuleAt-Least-Once Delivery GuaranteesConsumer Fault Isolation
Ver referencias y bitácora de construcción

📐 Conocer la arquitectura

Racoon Courier (Event Broker Engine) ↗
I9

Endurecimiento y liberación

Planeado

Camino dorado, pruebas arquitectónicas e instalación limpia.

Consolidar todas las iteraciones en un paquete instalable y verificar automáticamente que no existan violaciones de fronteras entre módulos.

Resultado demostrable

Instalación limpia en minutos que ejecuta el recorrido comercial completo con suite de pruebas arquitectónicas en verde.

Capacidades / Dominios:
Golden Path End-to-End SuiteArchitecture Boundary VerificationZero-Intervention Clean InstallerFirst MVP Release Readiness
🚩 El Primer MVP termina aquí. Racoonity no.
Siguiente etapa

PRÓXIMO MVP

Por definir

El alcance, los dominios prioritarios y las iteraciones del segundo MVP serán definidos canónicamente una vez que se complete la validación del Primer MVP.

Visión de Evolución

Horizonte de Racoonity

⚠️ Horizonte, no promesa. Estas capacidades forman parte de la visión de evolución de largo plazo, pero no tienen fecha, no están asignadas a un MVP concreto y su orden puede ajustarse.
🎨 Personalización de Experiencia

Artifier Avanzado & Experience Builder

Diseñador visual libre de formularios y pantallas adaptativas para construir flujos por pasos y experiencias de usuario a la medida.

⚡ Lógica Declarativa

Action Builder & Expression Builder

Creación de acciones personalizadas y campos calculados mediante expresiones declarativas y seguras sin requerir compilación.

🗺️ Automatización de Procesos

Blueprint Builder & Workflows

Modelado de procesos operativos, aprobaciones y flujos de trabajo multi-usuario mediante reglas de transición claras.

🎭 Orquestación de Procesos

Racoon Conductor

Engine de ejecución y supervisión en tiempo real de máquinas de estado complejas y workflows distribuidos.

📦 Extensibilidad Externa

Module Builder & Ecosistema

Empaquetado, versionado y distribución de módulos completos creados por la comunidad o desarrolladores independientes.

🤖 Asistencia Inteligente

Artifier Agent

Asistente guiado integrado en la plataforma para ayudar a diseñar modelos, vistas y workflows mediante lenguaje natural.

Brújula de evolución continua

Racoonity no busca ser grande acumulando funciones innecesarias de golpe. Nace pequeño y permite que cada negocio descubra complejidad únicamente cuando la necesite.

Leer el Manifiesto en el Blog →