Skip to content
View juanisidoro's full-sized avatar

Block or report juanisidoro

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
juanisidoro/README.md

Juan Isidoro (Isi)

Full Stack Engineer specialized in:
→ Scalable event-driven architectures
→ Real-time e-commerce data synchronization
→ AI-powered application optimization

I build systems that simplify technical complexity and improve developer experience.


Currently Working On

🏗️ Building CTY — multi-tenant e-commerce platform with event-driven architecture
🔬 Evolving MAKO — specification for LLM content optimization
🧠 Integrating AI into automation workflows and content generation


Featured Projects

CTY (CommerToYou) — Multi-CMS E-commerce Platform

Status

Problem: Online store owners manually manage catalogs across multiple platforms (WooCommerce, PrestaShop) without technical expertise.

Solution: Centralized product management system with automatic bidirectional multi-CMS synchronization.

Architecture: Clean Architecture + DDD + CQRS + Event Sourcing

Product Catalog (Central Source)
   ↓ Domain Events
Event Bus (Firebase)
   ↓ Event Handlers
Sync Workers
   ↓ Bidirectional Webhooks
WooCommerce | PrestaShop | Shopify
   ↓ Real-time updates
Observability Layer (Grafana Cloud)

Tech Stack:

  • Frontend: Next.js, React, TypeScript, Tailwind CSS
  • Backend: Node.js, Firebase Functions, Firestore
  • Observability: Grafana Cloud, distributed tracing
  • Integrations: WooCommerce REST API, PrestaShop WebService, custom webhooks

Key Features:

  • Zero-friction interface for non-technical users
  • Bidirectional real-time synchronization
  • Event system with replay capability
  • Multi-tenant with per-tenant data isolation
  • Complete observability: traces, logs, metrics
  • Robust error handling and automatic retries

AI Integrations (in progress):

  • Automatic product description generation
  • AI-assisted SEO optimization
  • Intelligent catalog categorization

Actively in development - sync architecture operational


MAKO — Markdown Agent Knowledge Optimization

Spec npm

Problem: Traditional HTML is inefficient for LLMs — high token consumption, semantic noise, unoptimized structure.

Solution: Open specification based on HTTP content negotiation that delivers structured content for AI agents.

Result: ~93% fewer tokens compared to standard HTML.

Client (LLM Agent)
   ↓ Accept: text/mako+markdown
Server
   ↓ YAML frontmatter + Clean Markdown
Response
   → 93% token reduction
   → Structured metadata
   → Actionable navigation
Repository Description
mako-spec Complete specification
mako-js TypeScript SDK
mako-cli CLI tool
mako-site Analyzer, Score & Directory
mako-wp WordPress plugin

Impact: Reduces API costs in RAG applications and improves response accuracy by eliminating HTML noise.


FireSchema — Firebase Schema Viewer

Demo

Problem: Firestore lacks visual schema documentation, making team collaboration difficult.

Solution: Open-source visualizer that auto-discovers .schema.json files and renders interactive documentation.

Features:

  • Static SPA, zero-backend, deployable on any CDN
  • JSON Schema 2020-12 standard
  • Automatic mapping of folder structure to Firestore collections
  • Schema generation via LLM prompts

Tech Stack

Frontend
Next.js · React · TypeScript · Tailwind CSS

Backend & APIs
Node.js · Firebase (Auth, Firestore, Functions, Storage) · PostgreSQL

Architecture & Patterns
Clean Architecture · DDD · CQRS · Event Sourcing · Multi-tenant · Webhooks

Observability
Grafana Cloud · Distributed Tracing · Structured Logging

E-commerce Integrations
WooCommerce REST API · PrestaShop WebService · Custom Webhooks

AI & Optimization
LLM Content Optimization · RAG Pipelines · Prompt Engineering


Philosophy

I build systems that:

  • Reduce entropy — Clear interfaces over unnecessary complexity
  • Scale cognitively — Architectures teams can understand
  • Prioritize experience — For both developers and end users

Additional Background

Digital Marketing & Product
Experience in multi-channel campaigns and web analytics — I understand the business behind the code

Industrial Automation
STEP7 (Siemens) · SCADA · Process control — background in mission-critical systems

Hardware & IoT
Arduino · Circuit design · Hardware-software integration


Beyond Code

CrossFit · Continuous learning · Intentional building

I combine technical rigor with product vision. I care about both system architecture and real user impact.


Connect

LinkedIn Email GitHub


💡 Open to collaborations in Event-Driven Architecture, E-commerce Solutions, and LLM Optimization

```

Commit message:

docs: restructure README with English and professional focus

Extended description:

- Translate entire README to English for broader reach
- Shift focus from personal narrative to technical expertise
- Highlight CTY as flagship project with detailed architecture
- Add problem-solution-result format for all projects
- Reorganize tech stack by layers and domains
- Include ASCII diagrams for visual clarity
- Add badges for specs, npm packages, and project status
- Compress background sections to reduce noise
- Improve professional positioning and SEO keywords

Pinned Loading

  1. Guía paso a paso para desplegar un p... Guía paso a paso para desplegar un proyecto backend con Node.js en un servidor VPS de Clouding.io, incluyendo instalación de dependencias, configuración de PM2, Nginx, dominio personalizado, HTTPS con Certbot y solución de errores comunes.
    1
    # 📦 Despliegue de Proyecto Node.js en Clouding.io (Resumen Completo)
    2
    
                  
    3
    Este documento resume todos los pasos, comandos y decisiones tomadas para desplegar exitosamente un backend Node.js en un servidor VPS de Clouding.io con HTTPS y dominio personalizado.
    4
    
                  
    5
    ---
  2. How to Use Custom SSL Certificates i... How to Use Custom SSL Certificates in Node.js with Bright Data (Guía en Español + English Guide)
    1
    # ✅ Cómo usar certificados SSL personalizados en Node.js para conexiones seguras con proxies (Bright Data)
    2
    
                  
    3
    ## 📝 Contexto
    4
    
                  
    5
    Al hacer peticiones HTTPS usando proxies como los de **Bright Data**, es necesario que Node.js confíe en los certificados SSL utilizados por esos proxies. En muchos casos, obtendrás errores como: