Expediente del caso
casebook — base de conocimiento del portfolio
- Periodo
- 2026-08 — presente
- Estado
- active
- Visibilidad
- public
- Stack
- SvelteKit 2, Svelte 5, TypeScript, Vite, Vitest, Zod, gray-matter, Gitea Actions, Cloudflare Tunnel, systemd
Evidencias · CASEBOOK
En producción
- publicado en https://casebook.pdeandresconde.com/
Métricas
- 107 commits en la historia de main
- 16 PRs fusionados
- 28 registros en el catalogo
- 32 capitulos derivados de los dominios
- 240 tests source-only en la suite equivalente a CI
Expediente del caso
Motivación
El CV laboral cuenta lo que se hizo en cada puesto, pero deja fuera como se piensa y que se aprende al margen de el. La motivacion fue construir un portfolio que organizara y navegara ese conocimiento ausente: proyectos propios, decisiones de arquitectura y aprendizajes, presentados como un expediente trazable con una identidad transversal propia, mas alla del perfil de desarrollador Odoo.
El reto
El reto era doble. Primero, organizar y navegar el conocimiento sin que el catalogo degenerara en una lista plana: hacer que 28 registros con vocabulario normalizado se convirtieran en 32 capitulos coherentes y legibles. Segundo, sostener un esquema estricto (frontmatter validado, tags controlados, contenidos bilingues obligatorios) y desplegarlo de forma automatica para que cada cambio llegara a produccion sin intervencion manual.
Enfoque
Se definio un pipeline de contenidos: cada proyecto es un Markdown con frontmatter validado con Zod, un vocabulario controlado de tags (technology:, architecture:, domain:) del que se derivan los capitulos, y bloques bilingues obligatorios para los expedientes destacados. Sobre esa base se construyo el libro interactivo en SvelteKit 2 y Svelte 5 con TypeScript, probado con Vitest. El despliegue es automatico: mergear en main dispara un workflow de Gitea Actions que reconstruye y reinicia el servicio systemd, publicado por un Cloudflare Tunnel, con rollback si la verificacion falla.
Aprendizaje
Tres cosas. Primera: la organizacion y la navegacion son lo que transmite el conocimiento que no cabe en el CV laboral; un registro suelto no cuenta nada, pero ordenado en capitulos por dominio y con una narracion editorial, el conjunto si. Segunda: el portfolio es una identidad transversal viva: agrupa juegos, IA aplicada, pagos, documentacion y motores propios como expedientes de una misma investigacion, sin limitarse al desarrollador Odoo. Y tercera: los despliegues automaticos son magia pura: mergear y ver produccion actualizada por Gitea Actions, con rollback si algo falla, convierte publicar en parte del flujo y no en un tramite.
Estado actual
Activo. El libro esta publicado con despliegue automatico en produccion, y el catalogo sigue creciendo con nuevos registros y capitulos. Estado verificado: 107 commits en main, 16 PRs fusionados, 28 registros y 32 capitulos derivados, con 240 tests source-only en la suite equivalente a CI.