📍 Mapa de construcción pública

El Primer MVP de Racoonity está completado.

De la columna vertebral mínima a una operación extensible y probada: las 10 iteraciones del Primer MVP están completamente verificadas y listas para liberación.

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

racoonity // roadmap-tree.spec
🦝 Racoonity Core
Completado Primer MVP

10 iteraciones (I0 → I9) completadas

I0
I1
I2
I3
I4
I5
I6
I7
I8
I9
En construcción Segundo MVP

I5 actual: La tienda ya puede vender de verdad

I0
I1
I2
I3
I4
I5
I6...I9
Horizonte Evolución Futura

Artifier Avanzado, Workflows, Agent

Senderos & Estaciones

El plano de construcción del Primer MVP

El primer capítulo de Racoonity está completo: de la columna vertebral mínima a una operación extensible y probada.

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 evidencias y referencias técnicas

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 evidencias y referencias técnicas

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 evidencias y referencias técnicas

Ubicaciones, balances, movimientos e inventario inmutable.

Racoonity maneja ubicaciones de inventario, existencias por almacén, entradas, salidas, ajustes físicos y transferencias atómicas entre ubicaciones, conservando un historial inmutable de movimientos y garantizando la consistencia de balances bajo concurrencia.

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 evidencias y referencias técnicas

Clientes, cajas, sesiones operativas y medios de pago.

Racoonity ya preparó la operación diaria: padrón de clientes, terminales de caja registradora, control de apertura y cierre de turnos de cajeros y configuración de métodos de pago aceptados como base previa a la primera venta real.

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
Ver evidencias y referencias técnicas

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

Racoonity ya puede vender: el corazón transaccional del sistema registrando ventas en mostrador revalidando precios, descontando inventario en tiempo real, procesando pago y emitiendo comprobantes con garantía de idempotencia y disparo de eventos.

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 evidencias y referencias técnicas

Cancelaciones, arqueo, dashboard operativo y reportes.

Racoonity ya puede cerrar el ciclo operativo: cancelación total de ventas con restitución de inventario, consolidación y cierre de caja, dashboard operativo en tiempo real y generación de reportes con exportación a CSV.

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
Ver evidencias y referencias técnicas

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

Racoonity ya demuestra extensibilidad dinámica construida desde dentro: la primera capa de Racoon Artifier permite adaptar la estructura agregando campos y modelos personalizados, relaciones simples many_to_one, vistas básicas y navegación automática con registros dinámicos sin modificar el núcleo.

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 evidencias y referencias técnicas

Racoon Courier, Observer, reintentos e idempotencia.

Racoonity ya demostró que una capacidad independiente puede reaccionar a eventos del sistema sin acoplarse al dominio productor: entrega de eventos después del commit, procesado de outbox con reintentos y consumidores idempotentes.

Resultado demostrable

Una venta se confirma, el evento queda pendiente y un módulo independiente reacciona después sin modificar Sales. Si el consumidor falla, la venta permanece confirmada, el evento reintenta y no se duplica evidencia.

⚙️ Publicación y consumo desacoplado
Confirmar venta → Commit transaccional
→ Outbox: sale.confirmed pendiente
→ Racoon Courier entrega el evento
→ Observer registra evidencia con idempotencia
Fallo en consumidor → Venta intacta + Reintento seguro
Capacidades / Dominios:
Racoon Gossip & Courier Event BrokerSales Observer ModuleAt-Least-Once Delivery GuaranteesIdempotent Consumer ProcessingFault Isolation & Retries
Ver evidencias y referencias técnicas

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

Todo lo construido en I0–I8 fue endurecido y probado como un producto coherente: camino dorado completo, instalación limpia, pruebas funcionales, integración con PostgreSQL real, validación de transacciones, idempotencia, concurrencia, outbox, cache invalidation, pruebas arquitectónicas, configuración productiva, migrations, recuperación de Courier y documentación de operación.

Resultado demostrable

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

⚙️ Golden Path End-to-End Validation
Setup → Login → Catálogo → Inventario
→ Caja → POS Venta → Ticket → Arqueo
→ Cancelación → Artifier Custom Model → Observer Event
Resultado: Suite verde + Instalación verificada
Capacidades / Dominios:
Golden Path End-to-End SuiteArchitecture Boundary VerificationZero-Intervention Clean InstallerTransaction & Outbox HardeningFirst MVP Release Readiness
Ver evidencias y referencias técnicas
🚩 El roadmap activo evoluciona. Racoonity no se detiene.
Evolución posterior

PRÓXIMO CAPÍTULO

Por definir

El alcance y las iteraciones de futuros capítulos se definirán canónicamente tras la adopción y validación operativa del Segundo 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 →