maple-observability

# Maple — Open-Source Observability Platform ## Descripción Plataforma de observabilidad open-source para traces, logs y métricas, construida sobre OpenTelemetry y ClickHouse. Monorepo con frontend SPA (TanStack Router + Vite), backend Effect, OTLP ingest gateway, y múltiples apps. ## Por qué importa para David - **ClickHouse + OTel**: Patrón de almacenamiento de series temporales de alta performance - **Effect framework**: Patrón functional para backend robusto con manejo de errores - **Monorepo pattern**: Estructura de workspace con Bun para proyectos grandes - **Real-time dashboard**: Pattern de dashboard observable en tiempo real ## Arquitectura ``` apps/web → TanStack Router SPA (Vite) apps/api → Effect HTTP API + MCP server apps/ingest → OTLP ingest gateway + collector forwarding apps/alerting → Alert evaluation worker apps/cli → CLI utilities apps/mobile → Expo mobile app packages/domain → Shared Effect contracts packages/query-engine → Query & observability logic packages/ui → Shared UI primitives ``` ## Instalación local ```bash # Homebrew (recomendado) brew install Makisuo/tap/maple maple start # Manual con Bun bun install bun run dev # Docker docker compose up ``` ## Integración con proyectos de David - **Control Center**: Usar ClickHouse como backend de métricas - **Dashboards**: Pattern de real-time observability reusable - **Alerting**: Worker pattern para evaluaciones de alertas ## Pitfalls - Requiere Bun runtime (no Node) - ClickHouse embedded consume RAM (mínimo 2-4GB) - Effect framework tiene curva de aprendizaje - No es trivial migrar de otro stack a Effect ## Referencias - GitHub: https://github.com/MapleTechLabs/maple - Docs: Monorepo README con instrucciones detalladas