Fyso - ERP Agent-Native

Vision del Proyecto

Sistema ERP diseñado desde cero para ser consumido por agentes de IA (Agent-Native). Combina:

• Metadata-Driven Architecture: Entidades y campos definidos como metadata, no código hardcodeado
• Multi-Tenant: Aislamiento completo por tenant (schema-per-tenant)
• MCP Server Auto-Generado: Herramientas para agentes generadas automáticamente desde metadata
• AI UI Engine: Generación de componentes UI mediante IA
• Sistema de Features/Plugins: Extensibilidad mediante features instalables

Documentacion Original

Los documentos de diseño original se encuentran en /docs/original/:

Archivo	Descripcion
01-simulacion-ejecucion.md	Simulacion completa de como funcionaria el sistema con "Cafe Cosmos"
02-blueprint-arquitectonico.md	Arquitectura de 3 capas, DDD, EIP patterns, multi-tenancy
03-ui-engine-arquitectura.md	Sistema de generacion de UI mediante IA (Intent-to-Code)
04-simulacion-facturador.md	Ejemplo completo de generacion de sistema de facturacion
05-paper-academico.md	Paper de investigacion sobre AI UI Engine
DEPLOYMENT.md	Guía de despliegue para MVPs

Plan de Desarrollo

El desarrollo se divide en fases incrementales:

Fase	Nombre	Objetivo
MVP	Core Foundation	Sistema funcional minimo con metadata-driven CRUD
Fase 1	Multi-Tenancy & Auth	Aislamiento de tenants y autenticacion
Fase 2	MCP Server	Integracion con agentes IA
Fase 3	Feature System	Sistema de plugins/extensiones
Fase 4	AI UI Engine	Generacion de UI mediante IA

Ver detalles en /docs/phases/

Stack Tecnologico Propuesto

Backend

• Runtime: Node.js / Bun
• Framework: Hono / Express
• Database: PostgreSQL (Supabase)
• ORM: Drizzle / Prisma
• Validacion: Zod

Frontend

• Framework: React 19 / Next.js 15
• Styling: Tailwind CSS
• Components: shadcn/ui
• State: TanStack Query

Infraestructura

• Hosting: Vercel / Railway
• Database: Supabase
• Auth: Supabase Auth / Clerk
• Realtime: Supabase Realtime

Principios Arquitectonicos

1. AGENT-FIRST PRINCIPLE
   "Every system decision optimizes for AI consumption"

2. METADATA-DRIVEN PRINCIPLE
   "UI and behavior emerge from schema, never hardcoded"

3. EVENT-DRIVEN PRINCIPLE
   "Loose coupling through async messaging"

4. TENANT ISOLATION PRINCIPLE
   "Complete isolation at every layer"

Estructura del Proyecto (Propuesta)

fyso/
├── docs/                    # Documentacion
│   ├── original/           # Docs de diseño original
│   ├── phases/             # Plan por fases
│   └── architecture/       # Decisiones arquitectonicas
├── packages/
│   ├── core/               # Metadata engine
│   ├── api/                # REST/GraphQL API
│   ├── mcp-server/         # MCP Server
│   ├── web/                # Frontend web
│   └── shared/             # Tipos compartidos
├── features/               # Features/Plugins
└── migrations/             # Database migrations