# 🚀 Vladimir Acuña | Portafolio Profesional [![CI Pipeline](https://github.com/vladimiracunadev-create/vladimiracunadev-create.github.io/actions/workflows/ci.yml/badge.svg)](https://github.com/vladimiracunadev-create/vladimiracunadev-create.github.io/actions/workflows/ci.yml) [![Wiki Sync](https://github.com/vladimiracunadev-create/vladimiracunadev-create.github.io/actions/workflows/wiki-sync.yml/badge.svg)](https://github.com/vladimiracunadev-create/vladimiracunadev-create.github.io/actions/workflows/wiki-sync.yml) [![Bilingual](https://img.shields.io/badge/Language-ES%2FEN-blue?style=flat-square)](index.html) [![Themes](https://img.shields.io/badge/Theme-Dark%2FLight-blueviolet?style=flat-square)](index.html) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT) Este repositorio alberga un **Portafolio de Alto Rendimiento** diseñado bajo la filosofía **KISS (Keep It Simple, Stupid)**. Se presenta como un núcleo estático puro, optimizado para la eficiencia extrema, que sirve de base para una arquitectura multiplataforma escalable (PWA + Mobile). --- ## 🏗️ Filosofía de Ingeniería: Minimalismo Estratégico A diferencia de las soluciones sobre-ingenierizadas con frameworks masivos, este proyecto utiliza un **Vanilla Stack** para garantizar: * **Rendimiento Imbatible**: Tiempos de carga casi instantáneos y mínima carga cognitiva para el navegador. * **Sostenibilidad Técnica**: Código agnóstico al tiempo que funcionará durante décadas sin mantenimiento de dependencias. * **Control de Payloads**: Cada línea de código tiene un propósito directo en la experiencia del usuario. > [!IMPORTANT] > El soporte **PWA** y **Capacitor** son extensiones naturales del núcleo. La arquitectura permite esta evolución multiplataforma sin comprometer el rendimiento base ni introducir complejidad innecesaria. --- ## ⚡ Rendimiento & Calidad: Lighthouse 100 | Métrica | Puntaje | Impacto | | :--- | :--- | :--- | | **Performance** | ![100](https://img.shields.io/badge/100-success?style=flat-square&logo=lighthouse&logoColor=white) | Carga instantánea (< 1s LCP) | | **Accesibilidad** | ![100](https://img.shields.io/badge/100-success?style=flat-square&logo=lighthouse&logoColor=white) | Cumplimiento total de estándares ARIA | | **Best Practices** | ![100](https://img.shields.io/badge/100-success?style=flat-square&logo=lighthouse&logoColor=white) | Código seguro y moderno | | **SEO** | ![100](https://img.shields.io/badge/100-success?style=flat-square&logo=lighthouse&logoColor=white) | Optimización semántica y metadatos | --- ## 📈 Pilares Técnicos Consolidados Este proyecto ha escalado de un portafolio personal a un **Demostrador Industrial** de ingeniería de software. La revisión de repositorios activos en GitHub y GitLab confirma 8 pilares estratégicos: 1. **Observabilidad Industrial**: Prometheus + Grafana en Docker Labs, Social Bot y Problem-Driven (puertos 9091/3001). LangGraph v4.2 expone `/health`, `/ready`, `/metrics` y LangSmith opt-in. AWS Caso O implementa X-Ray distribuido. 2. **Security Hardening**: auditoría 8 capas en LangGraph (non-root, 127.0.0.1, grype `fail-build`, nginx TLS, detect-secrets, Trojan Source, pip-compile, Dependabot). Microsistemas v3.x con Hardening 3 fases + SBOM por release. Trivy en Social Bot v4.2. TruffleHog + detect-secrets en proyectos AWS. 3. **Resiliencia & Continuidad**: idempotencia, Circuit Breakers y desvío controlado (DLQ) para fallos de terceros. Polyglot persistence en Social Bot v4.2 (9 lenguajes × 12+ DBs) con runtime isolation. Streaming + DEMO/LIVE + checkpoints SQLite en LangGraph para tolerancia a fallos LLM. 4. **DevOps & DX Reproducible**: Hub CLI multi-OS y Windows Installer firmado en Docker Labs v1.5. Tests `doctor` y `smoke`, Makefile operativo y validaciones por caso. CI/CD hardened en GitHub Actions con OIDC y matrix builds. Skills de Claude Code para flujos repetibles. 5. **Cloud Profesional + GenAI**: 14/15 casos AWS completados (incluyendo Caso I GenAI con Bedrock + Claude Haiku 4.5 + Lambda + xray-sdk; Caso O X-Ray distribuido). Infra inmutable (Terraform), seguridad OIDC y FinOps. Cobertura por certificación: ~68% SAA-C03, ~68% DVA-C02, ~50% SOA-C02. EKS v1.32 + ECS Fargate. 6. **Multiplatform Core**: un solo código fuente para Web, PWA y Apps Nativas (Capacitor). Python Data Science Program v3.8.0 con 232 clases en 9 partes incluye App Desktop Windows nativa (PySide6 + Qt + kernel Jupyter interactivo) y App Android (Expo SDK 51). ChofyAI Studio v0.5.1 corre en macOS Apple Silicon + soporte experimental Windows + NVIDIA GPU (Tauri + Rust + React, pnpm + SHA-512 lockfile). 7. **IA Agéntica & Local-First + LLM Discoverability**: LangGraph v4.15 con 25/25 backends operativos (cobertura 100%), estado tipado y rutas condicionales. MCP + Ollama Local con Security & Trust Profile (Bandit + pip-audit + Semgrep + CodeQL + SBOM) y blueprint AWS migration. Discoverability semántica vía `llm.txt`. 8. **Internacionalización Completa**: 6 idiomas (ES/EN/PT/IT/FR/ZH) con 31 PDFs generados por pipeline Python/reportlab — CVs ATS y reclutador, portafolio, carta de recomendación y declaración de logros. El selector de idioma cambia automáticamente los PDFs descargables vía `data-pdf-{lang}`. 9. **Producto comercial Windows**: RootCause Windows Inspector v0.11.0 — diagnóstico forense escrito en Rust (edition 2024) con 5 ediciones publicadas (GUI Setup.exe, Portable .zip, CLI single-binary `rootcause.exe`, módulo PowerShell `.psm1`, extensión VS Code `.vsix`), ETW · WPR, SHA256SUMS por release, 11+ releases tagueadas. Landing en `/rootcause-windows-inspector/`. --- ## 🌐 Internacionalización & UI El sistema cuenta con un motor de **i18n (Internationalization)** e **Theming** de alto rendimiento: * **6 idiomas (ES/EN/PT/IT/FR/ZH)**: Cambio de idioma instantáneo sin recarga de página; los enlaces de descarga de PDF cambian automáticamente al documento del idioma activo vía `data-pdf-{lang}`. * **3 vistas de lectura**: Reclutador, Normal y Profundo ajustan la densidad del contenido mediante `data-min-level` sin duplicar páginas. * **Temas Dinámicos**: Modo Oscuro/Claro totalmente reactivo, respetando las preferencias del sistema y del usuario. * **Layout Adaptativo**: Estructura industrial capaz de manejar contenidos densos sin colapso visual. --- ## 🤝 Freelance · Modalidades de Colaboración El sitio incluye una sección pública `#modalidades` (nav: "Freelance") para explicar formatos de trabajo profesional sin publicar precios: * proyecto acotado; * bolsa de horas o apoyo experto; * acompañamiento mensual; * diagnóstico técnico con hoja de ruta; * colaboración técnico-comercial, preventa o definición técnica. La modalidad se define según alcance real, criticidad operacional, urgencia, liderazgo esperado, integración con equipos, profundidad técnica y necesidad de continuidad o soporte evolutivo. El contenido mantiene el patrón del sitio: textos embebidos en `index.html`, traducciones por atributos `data-es`/`data-en`/`data-pt`/`data-it`/`data-fr`/`data-zh`, y detalle progresivo con `data-min-level`. ### Regla de privacidad comercial El archivo `referencia_honorarios_profesionales_vladimir_2026_detallado.pdf` es un insumo privado de negociación. No debe copiarse a `assets/`, no debe enlazarse desde `index.html`, no debe registrarse en `api/v1/artifacts.json` y no debe publicarse en GitHub Pages. Si en el futuro se crea una pieza pública descargable sobre modalidades, debe ser una versión breve sin precios, sin rangos y sin referencias comerciales sensibles. --- ## 👔 Rol adicional: Líder Tecnológico / Tech Lead Este portfolio incorpora el rol de **Líder Tecnológico / Tech Lead** como expansión natural del perfil de Arquitecto de Soluciones y Senior Full-Stack. La justificación se basa en experiencia real en modernización de plataformas, continuidad operacional, arquitectura, automatización, CI/CD, cloud, IA aplicada y documentación técnica. No reemplaza la identidad principal del perfil; la complementa para oportunidades donde se requiera guía técnica, dirección de arquitectura y acompañamiento de equipos. **Respaldo verificable:** * 14+ años en plataformas reales, con modernización progresiva sin cortar operación. * Experiencia en diseño de arquitectura, integración de sistemas y definición de estándares técnicos. * Capacidad para traducir objetivos de negocio en soluciones tecnológicas mantenibles. * Flujo asistido por IA con criterio técnico propio y validación humana. --- ## 📱 Capacidades Multiplataforma El portafolio está preparado para operar como una aplicación nativa instalable: * **Progressive Web App**: Instalación directa en Windows, macOS, Android e iOS. * **Android & iOS Ready**: Estructura compatible con Capacitor para despliegue en tiendas de aplicaciones. ### Instrucciones de Instalación (PWA) * **Desktop (Chrome/Edge):** Haz clic en el icono de instalación en la barra de direcciones. * **Android (Chrome):** Menú de tres puntos > "Instalar aplicación". * **iOS (Safari):** Botón de compartir > "Añadir a la pantalla de inicio". --- ## 🛠️ Quick Start / Inicio Rápido Si eres desarrollador y quieres explorar o extender este proyecto: ```bash # 1. Clonar el repositorio git clone https://github.com/vladimiracunadev-create/vladimiracunadev-create.github.io.git # 2. Entrar al directorio cd vladimiracunadev-create.github.io # 3. Servir localmente (opcional pero recomendado para PWA) npx http-server . ``` --- ## 📚 Documentación Especializada Explora las guías detalladas según tu interés: ### 💼 Perfiles de Negocio & Reclutamiento * [🎯 **Guía para Reclutadores**](docs/RECRUITER.md): Propuesta de valor y métricas de impacto. * [🧠 **Racional Técnico**](docs/TECHNICAL_RATIONAL.md): Justificación radical de por qué no usamos frameworks. ### 🛠️ Perfiles Técnicos & DevOps * [🛠️ **Guía de Construcción**](docs/BUILD_GUIDE.md): Pasos para generar APK, IPA y PWA Desktop. * [🚀 **Construcción Directa (Android)**](docs/MOBILE_DIRECT_BUILD.md): Flujo rápido para generar APK desde Windows. * [📱 **Manual Mobile (Android/iOS)**](docs/GUIA_MAESTRA_MOBILE.md): Configuración profunda de Capacitor. * [🩹 **Solución de Problemas iOS**](docs/IOS_TROUBLESHOOTING.md): Guía de supervivencia en Xcode. Nota mobile: el flujo directo genera `app-debug.apk` en `apps/mobile/android/app/build/outputs/apk/debug/`. Para compartir ese binario, usa una **GitHub Release**; no lo subas al árbol normal del repositorio. ### 🎨 Personalización * [🎨 **Manual para Novatos**](docs/BEGINNER_GUIDE.md): Cómo cambiar tus fotos y textos en 5 minutos. ### 🗺️ Entornos Interactivos y Visuales * [🧘 **Recorrido 3D / Experiencia Inmersiva**](experiencia-3d/docs/README.md): Galería 3D en WebGL integrada al ecosistema como Arquitectura Desvinculada. Se mantiene como prototipo experimental de código y rendimiento de Three.js puro, pero su acceso público desde la Interfaz de Usuario (UI) principal está *desactivado* por filosofía de producto (no restar atención al flujo de lectura ágil exigido por reclutadores TI). --- ## 📂 Arquitectura del Proyecto ```text ├── apps/ # Contenedores móviles nativos (Capacitor) ├── docs/ # Documentación profunda y guías de sistema ├── scripts/ # Pipeline de generación de PDFs y build │ ├── generate-all-languages.py # Genera 12 CVs (reclutador+ATS × 6 idiomas) │ ├── generate-unified-cv.py # CV unificado (reclutador pág 1 + ATS págs 3-4) │ ├── generate-portfolio.py # Portafolio × 6 idiomas │ ├── generate-achievements-statement.py # Declaración de logros × 6 idiomas │ ├── generate-recommendation-letter.py # Carta de recomendación × 6 idiomas │ ├── generate-ats-cv.py # CV ATS standalone │ ├── generate-recruiter-cv.py # CV reclutador standalone │ ├── build-zip.py # Genera ZIP de despliegue para AWS/Amplify │ └── fix-md-lint.py # Auto-corrige errores markdownlint pre-push ├── assets/ # PDFs públicos (30+ variantes en 6 idiomas) │ └── no_aplica/ # Versiones descartadas — no publicadas en la API ├── .agents/skills/ # Skills de IA para automatizar el portafolio ├── api/v1/ # CV Data API — endpoints JSON estáticos │ ├── meta.json # Metadatos y capacidades multilingüe │ ├── profile.json # Perfil profesional │ ├── experience.json # Experiencia laboral │ ├── projects.json # Proyectos del ecosistema │ ├── skills.json # Habilidades técnicas │ └── artifacts.json # Inventario de PDFs con 6 variantes c/u ├── data/ # JSON Resume canónico (resume.json) ├── sources/extracted/ # Textos extraídos de PDFs (auditoría) ├── .github/workflows/ # Pipelines CI/CD (calidad, SEO, Lighthouse) ├── index.html # SPA principal — 6 idiomas + 3 vistas + PWA ├── app.js # Lógica i18n, PDF routing multilingüe, vistas ├── robots.txt # Directivas para crawlers de búsqueda ├── sitemap.xml # Mapa del sitio para SEO ├── llm.txt # Contexto semántico para AI/LLMs (llmstxt.org) ├── CLAUDE.md # Fuente de verdad del proyecto para Claude Code ├── cv-data-api.md # Manual de la CV Data API ├── manifest.webmanifest # Configuración PWA ├── service-worker.js # Gestión de Cache & Offline └── portfolio-bundle-YYYY-MM-DD.zip # Paquete portable para despliegue (generado, no versionado) ``` --- ## Skills System (IA + Automatizacion) El repositorio incluye un sistema de **Skills de IA** para mantenimiento por capas del portafolio. | Skill | Cuando usarlo | |---|---| | [`sync-portfolio`](.agents/skills/sync-portfolio/SKILL.md) | Sincronización completa: audita repos, actualiza JSONs, READMEs, PDFs y hace push | | [`portfolio-full-update`](.agents/skills/portfolio-full-update/SKILL.md) | Cuando cambian CV, experiencia, proyectos, PDFs o quieres refrescar todo el portafolio | | [`portfolio-consistency-audit`](.agents/skills/portfolio-consistency-audit/SKILL.md) | Cuando quieres detectar contradicciones entre sitio, API, documentacion, wiki y archivos SEO | | [`portfolio-release-guard`](.agents/skills/portfolio-release-guard/SKILL.md) | Antes de commit, push o release para validar lint, build e integridad de `dist/` | | [`portfolio-doc-sync`](.agents/skills/portfolio-doc-sync/SKILL.md) | Cuando cambio codigo, build, API o arquitectura y hace falta alinear README, docs y wiki | | [`portfolio-seo-llm-maintainer`](.agents/skills/portfolio-seo-llm-maintainer/SKILL.md) | Cuando cambian rutas, metadatos, `llm.txt`, `robots.txt`, `sitemap.xml` o discoverability | | [`portfolio-mobile-wrapper-check`](.agents/skills/portfolio-mobile-wrapper-check/SKILL.md) | Cuando cambian web, PWA o assets y quieres confirmar alineacion con Android/iOS | | [`portfolio-mobile-direct-build`](https://github.com/vladimiracunadev-create/vladimiracunadev-create.github.io/blob/main/.agents/skills/portfolio-mobile-direct-build/SKILL.md) | Transformar la web en app Android y generar el APK directamente en Windows | | [`build-deploy-zip`](.agents/skills/build-deploy-zip/SKILL.md) | Generar ZIP de despliegue para AWS/S3/Amplify/Netlify con todos los archivos web publicos | | [`md-lint-fix`](.agents/skills/md-lint-fix/SKILL.md) | Auto-corregir errores MDxxx en archivos `.md` modificados antes de git push | **Uso recomendado:** * `md-lint-fix` antes de cualquier commit con archivos `.md` modificados. * `portfolio-consistency-audit` para revisar coherencia general. * `portfolio-doc-sync` o `portfolio-seo-llm-maintainer` segun el tipo de cambio. * `portfolio-mobile-wrapper-check` si tocaste manifest, PWA o assets. * `portfolio-release-guard` antes de publicar. * `portfolio-full-update` cuando el cambio afecta varias capas a la vez. * `build-deploy-zip` para empaquetar y subir a AWS u otros ambientes estaticos. --- ## 📑 CV Data API (GitHub Pages) El currículum está publicado como **API JSON estática de solo lectura**, extraída directamente desde los PDFs del repositorio. 📑 [Manual completo → `cv-data-api.md`](cv-data-api.md) Los artefactos públicos disponen de variantes en **6 idiomas (ES/EN/PT/IT/FR/ZH)** y el selector de idioma del sitio cambia automáticamente las descargas al PDF equivalente vía atributos `data-pdf-{lang}`. Además, se incorporó una **Declaración de Logros y Validación** como respaldo separado: resume logros observables y facilita validación externa sin reemplazar el CV ni el portafolio principal. Las cartas de recomendación también están disponibles en los 6 idiomas. El sitio también enlaza documentación pública de repos clave cuando existe (`README.md` y, en algunos casos, `RECRUITER.md`) para reducir fricción de evaluación técnica y de reclutamiento. ### Endpoints v1 | Endpoint | Descripción | |---|---| | [`/api/v1/profile.json`](https://vladimiracunadev-create.github.io/api/v1/profile.json) | Perfil público | | [`/api/v1/experience.json`](https://vladimiracunadev-create.github.io/api/v1/experience.json) | Experiencia laboral | | [`/api/v1/projects.json`](https://vladimiracunadev-create.github.io/api/v1/projects.json) | Proyectos | | [`/api/v1/skills.json`](https://vladimiracunadev-create.github.io/api/v1/skills.json) | Skills, educación, idiomas | | [`/api/v1/artifacts.json`](https://vladimiracunadev-create.github.io/api/v1/artifacts.json) | PDFs con URLs directas | | [`/api/v1/meta.json`](https://vladimiracunadev-create.github.io/api/v1/meta.json) | Metadatos de la API | ### CV PDF principal 📄 **[CV ATS (PDF)](https://vladimiracunadev-create.github.io/assets/cv-ats.pdf)** ### Artefacto de validación complementario 📄 **[Declaración de Logros y Validación (PDF)](https://vladimiracunadev-create.github.io/assets/declaracion-logros-validacion.pdf)** --- © 2026 Vladimir Acuña | Arquitecto de Software Senior ## 📚 Documentación del Proyecto Como parte de los estándares de este ecosistema, la documentación detallada se divide en: * [📖 Guía de Instalación y Despliegue (INSTALL.md)](INSTALL.md) * [📝 Historial de Cambios (CHANGELOG.md)](CHANGELOG.md) * [🤝 Guía de Contribución (CONTRIBUTING.md)](CONTRIBUTING.md) * [🛡️ Política de Seguridad (SECURITY.md)](SECURITY.md) * [⚖️ Código de Conducta (CODE_OF_CONDUCT.md)](CODE_OF_CONDUCT.md)