👋 Para el recruiter / hiring manager#

Estado: activo Audiencia: reclutadores, hiring managers técnicos, headhunters senior, CTOs de empresas pequeñas Este documento te ahorra leer el repo completo. Pensado para evaluación en 90 segundos, verificación en 5 minutos.

TL;DR (30 segundos)#

• 5+ años de experiencia traducidos en evidencia operativa: 20 problemas reales × 7 stacks de producción = 140 endpoints verificables.
• No es un repo de "hola mundo" en 5 lenguajes. Cada caso reproduce un fallo de producción (N+1 real con SQLite embebido, breaker con CAS, leak de memoria con LRU, retry storm con AbortController, etc.) y la solución idiomática del stack.
• Honestidad técnica explícita: lo que es DB real, lo que está simulado, lo que falta — todo documentado, nada vendido.
• docker compose up y verificás vos mismo. No tenés que confiar en mi palabra.

¿Por qué este repo prueba algo que los portfolios típicos no?#

Cómo evaluarlo en 5 minutos (literal)#

1 — Lee el README.md raíz (2 min)#

Vas a ver: tabla de estado actual (7 stacks operativos, 140 endpoints), catálogo de los 20 casos con links, tabla de honestidad de fidelidad, los 7 hubs disponibles.

2 — Levantá un hub (1 min)#

# Elegí cualquiera de los 5
docker compose -f compose.dotnet.yml up -d --build   # .NET 8
docker compose -f compose.java.yml   up -d --build   # Java 21
docker compose -f compose.nodejs.yml up -d --build   # Node 20
docker compose -f compose.python.yml up -d --build   # Python 3.12
docker compose -f compose.root.yml   up -d --build   # PHP 8.3 + portal + Prometheus + Grafana

3 — Verificá un caso end-to-end (1 min)#

# Caso 02 en .NET — N+1 contra SQLite REAL embebido
curl "http://localhost:8500/02/orders-legacy?limit=5"
# → { "orders": [...], "db_hits": 6, "db_time_ms": ~, ... }

curl "http://localhost:8500/02/orders-optimized?limit=5"
# → { "orders": [...], "db_hits": 2, "db_time_ms": ~, ... }

db_hits es un contador real de ejecuciones contra el motor SQLite, no un número decorativo.

4 — Mirá un comparison.md (1 min)#

Abrí cases/02-n-plus-one-and-db-bottlenecks/comparison.md — vas a ver cómo los 7 stacks resuelven el mismo problema con primitivas idiomáticas distintas. Same problem, 7 idiomatic solutions, same observable metric.

Qué prueba sobre mi criterio de ingeniería#

1. Diagnóstico antes que solución#

Cada caso parte de síntoma observable → causa raíz → trade-offs → solución idiomática, no de "qué cool sería implementar X". El formato problem-driven está sostenido en cases/<caso>/README.md con esa estructura.

2. Honestidad técnica como política, no como excepción#

El repo tiene secciones explícitas que la mayoría de portfolios evita:

• "Honestidad de fidelidad" en el README raíz — qué casos usan DB real, cuáles simulan.
• "Lo que NO garantiza" en SECURITY.md — auth, rate limiting, TLS ausentes por diseño.
• "Lo que esta guía no resuelve" en AWS_MIGRATION.md — backups drills, multi-región, compliance.
• "Lo que este repo no vende" al final del README.

Un senior reviewer detecta gaps en 30 segundos. Vale más declararlos primero que ser pillado.

3. Multi-stack sin religión#

Demuestra que entiendo que ConcurrentHashMap (Java), ConcurrentDictionary (.NET), Map (JS) y dict (Python) resuelven el mismo problema con primitivas distintas — y que sé cuál es la idiomática en cada uno. Sin tribalismo de stack.

4. Operación, no solo código#

Cada caso corre en Docker con compose.yml, expone /health, devuelve métricas reales en el JSON de respuesta (db_hits, latency_ms, breaker_state, event_loop_lag_ms), y se levanta en <30s. Es operacionable, no decorativo.

5. Roadmap pensado, no acumulado#

El ROADMAP.md está organizado en 3 ejes (casos nuevos 13-20, mejoras de plataforma, compromisos de honestidad) con criterios de aceptación por entrada. No es una lista de deseos.

6. Criterio sobre frameworks#

Los stacks no-PHP usan exclusivamente librería estándar — HttpServer JDK, HttpListener BCL, node:http, http.server Python. Si trabajamos juntos y te preocupa que sea de los que tiran 200 MB de node_modules para un endpoint trivial, este repo te tranquiliza.

7. Pensamiento sistémico#

ARCHITECTURE.md tiene los diagramas Mermaid del lab completo. AWS_MIGRATION.md tiene 3 rutas alternativas con trade-offs reales. SECURITY.md tiene modelo de amenaza por escenario de despliegue. El criterio cruza capas: código, arquitectura, despliegue, seguridad, costo.

Highlights por caso (lectura rápida)#

Preguntas de entrevista que este lab te ayuda a responder#

Detalle de capacidades demostradas#

Diagnóstico de performance (casos 01, 02, 11)#

• N+1 detectado y resuelto con batch IN(?, ?, ?) — el contador db_hits baja de O(N) a O(1) y la métrica está en el JSON de respuesta.
• Latencia bajo carga resuelta con worker concurrente + cache + readers no bloqueados. Patrón aplicable a cualquier stack — demostrado en los 5.
• Reportes pesados aislados del path crítico con primitiva idiomática del runtime: ConcurrentExclusiveSchedulerPair en .NET, scheduler dedicado en Java, monitorEventLoopDelay para verificar que el event loop no se bloquea en Node.

Resiliencia distribuida (casos 04, 09)#

• Circuit breaker implementado con CAS atómico (Interlocked.CompareExchange en .NET, AtomicReference en Java) — no synchronized, no lock. Estado del breaker observable en cada response (breaker_state: closed|open|half_open).
• Cancellation cooperativa con AbortController (Node), CompletableFuture.orTimeout (Java), CancellationTokenSource (.NET) — propaga la cancelación al pipeline completo, sin requests huérfanos.
• Adapter pattern con cache de fallback para integraciones inestables — cuando el upstream cae, el lab degrada en lugar de quebrar.

Memoria y leaks (caso 05)#

• LRU manual implementado con primitivas del lenguaje: LinkedHashMap.removeEldestEntry (Java), Dictionary + LinkedList doblemente enlazado (.NET), Map con timestamps (Node), OrderedDict (Python).
• Métricas reales reportadas: Runtime.totalMemory() (Java), Process.WorkingSet64 (.NET), process.memoryUsage().rss (Node), tracemalloc (Python).
• Patrón legacy vs optimized — el lector compara las dos curvas en vivo.

Modernización legacy (casos 07, 08)#

• Strangler fig: routing mutable consumidor por consumidor con ConcurrentHashMap<String,Function> (Java), ConcurrentDictionary<string,Func<Request,Response>> (.NET), Map<consumer,handler> (Node).
• Extract-and-proxy: módulo crítico extraído con Proxy + EventEmitter (Node), Function proxy + CopyOnWriteArrayList event bus (Java), Func<Old,New> + ImmutableList<Action<string>> (.NET). Cutover gradual observable por porcentaje.

Observabilidad real (caso 03)#

• correlation_id propagado en pipeline async sin ensuciar la firma de los métodos: ThreadLocal<RequestContext> en Java, AsyncLocal<RequestContext> en .NET, contexto explícito en Node/Python/PHP.
• Logs estructurados con shape consistente entre stacks ({timestamp, correlation_id, level, msg, ...attrs}).
• Stack PHP además exporta Prometheus + Grafana real (casos 01 y 02).

Continuidad operacional (caso 12)#

• Runbooks codificados en el sistema de tipos: Optional<T> en Java, Nullable Reference Types con ?./?? en .NET. El compilador no deja que el código tenga null no manejado.
• Bus factor abordado con redundancia de conocimiento explícita en el código, no solo en docs.

Postmortems narrativos#

12 postmortems (uno por caso) en formato incidente real: severidad SEV-1/2/3, timeline minuto a minuto, causa raíz técnica, lo que funcionó vs lo que no, action items con dueño, métrica antes/después. Ver docs/executive-summary.md. Muestra cómo se piensa el incidente, no solo cómo se resuelve.

Señales profesionales que el repo deja#

Disponibilidad y contacto#

• Email: vladimir.acuna.dev@gmail.com
• Sitio profesional: vladimiracunadev-create.github.io
• GitHub: github.com/vladimiracunadev-create
• GitLab: gitlab.com/vladimir.acuna.dev-group
• Stack al que aplico: senior developer / tech lead / staff engineer en cualquiera de los 7 stacks demostrados (preferencia PHP, Python, .NET).
• Modalidad: remoto / híbrido (Argentina) / relocation a evaluar.

Lo que este repo NO prueba (honestamente)#

• Frontend complejo / UX / diseño visual. Mi foco está en backend y operación. La UI nativa de PHP es funcional, no premiada.
• Conocimiento profundo de un framework específico de moda. La idea es justamente lo opuesto: BCL/stdlib donde se puede. Si tu posición es "expertise en Next.js + tRPC + Prisma + Tailwind", este no es el repo que te va a convencer.
• Liderazgo de equipos de 50+ personas. Mi experiencia de liderazgo es a nivel squad técnico, no organizacional.
• Paridad sintáctica universal de los 20 casos en los 7 stacks. Es paridad funcional con criterio idiomático por runtime — no traducción literal. El caso 11 es el ejemplo explícito: Go y Rust no tienen pool de threads que agotar, así que el aislamiento se modela con un semáforo de concurrencia, no con un ExecutorService traducido.
• Benchmarks absolutos entre lenguajes. Las métricas reportadas son operativas (db_hits, latency_ms), no comparativas marketing.

📚 Documentos recomendados después de éste#