Este repositorio es mi espacio de trabajo y estudio personal sobre infraestructura descentralizada (DLT — Distributed Ledger Technology) aplicada a la Administración Pública. Reúne código, documentación, diseños y notas mientras exploro cómo tecnologías como blockchain, la identidad digital descentralizada o los espacios de datos pueden encajar en el contexto normativo y técnico de las Administraciones Públicas españolas y europeas.
Este repositorio está licenciado bajo Creative Commons Zero v1.0 Universal, dedicando el trabajo al dominio público y asegurando la máxima libertad para usar, modificar y distribuir el contenido sin restricciones.
Hago lo posible por enlazar solo a recursos abiertos y de libre acceso, pero no puedo garantizar el estado actual de cada enlace externo. Si encuentras un enlace roto, con muro de pago o fraudulento, por favor abre un issue. Consulta el DISCLAIMER.md completo para más detalles.
Si detectas una vulnerabilidad de seguridad, no abras un issue público: consulta la Política de Seguridad para saber cómo reportarla en privado.
En este repositorio, cada apunte o pieza de código tiene un propósito concreto. Está pensado para:
- Declarar el propósito: explicar el objetivo detrás de cada tema o experimento antes de profundizar en él.
- Crear instrucciones claras: documentar los pasos con el detalle suficiente para poder replicarlos o partir de ahí más adelante.
- Favorecer la reutilización: dejar constancia de los aprendizajes para poder retomarlos o aplicarlos en otro contexto.
Este enfoque orientado al propósito es lo que hace de este repositorio algo más que una colección de notas: el proceso y la intención detrás de cada tema importan tanto como el resultado.
Ahora que nos vamos conociendo, dejo claros unos cuantos términos:
-
Todo lo que hago aquí son soluciones abiertas. No solo el contenido es abierto, como puedes ver en el archivo de licencia, sino que cualquier solución que comparto debe ser replicable usando herramientas y tecnologías abiertas, o al menos lo más abiertas posible.
-
Intento usar —y sí, incluso copiar— lo que funciona bien para la mayoría. Prefiero no reinventar la rueda. No creo que haya una regla de oro; hay excepciones. Pero si sientes la necesidad de satisfacer tu ego, adelante, solo házmelo saber.
-
Creo en la necesidad de sistemas resilientes que aguanten el paso del tiempo. Dependemos los unos de los otros y eso no va a cambiar, pero siempre que sea posible intento evitar soluciones fáciles que sean demasiado centralizadas o propietarias.
-
Nada será perfecto desde el principio. Adopto un enfoque de mejora continua, iterativo o kaizen. La idea es que si me quedo atascado intentando que todo sea perfecto desde el principio, simplemente no haré nada. ¿No crees?
-
Este repositorio combina explicaciones teóricas o educativas con un enfoque práctico. Todo lo que comparto aquí tiene un propósito y es funcional. Si no funciona o no tiene una aplicación real, simplemente no tiene sitio aquí. Compartir soluciones que no aportan valor real es frustrante para todos.
-
Documentación viva y desarrollo guiado por documentación (DDD): creo que la documentación debe evolucionar junto con los propios proyectos. Mis guías no son archivos estáticos que acumulan polvo, son documentos vivos que mejoran con el tiempo. Practico un desarrollo guiado por documentación, es decir, documento mis intenciones y procesos mientras construyo, no como algo posterior. Este enfoque asegura que cada tema se mantenga accesible, comprensible y mantenible, tanto para mí como para quien lo lea.
-
El repositorio como fuente única de verdad (SSOT, Single Source of Truth): el código, la documentación, los issues y el historial de commits son el único punto de encuentro y de conocimiento del proyecto. No hay una wiki paralela, ni notas sueltas en otro sitio, ni una verdad que solo vive en mi cabeza: si algo no está aquí, no ha pasado. Esto obliga a que cada decisión, cada duda y cada cambio de rumbo quede documentado donde cualquiera —incluido yo mismo dentro de un año— pueda encontrarlo y entenderlo, sin depender de la memoria ni de conversaciones que se pierden.
-
Cada afirmación necesita una referencia: los agentes de IA son alucinantes por naturaleza, pero a mí no me sirve un texto que simplemente "suena bien". Cada argumento de este repositorio —por ejemplo, en pae-news— debe apoyarse en una fuente explorada y citada, ya sea un repositorio, una web como ethereum.org, o una norma publicada; no doy nada por cierto solo porque sea plausible o esté bien escrito. Esto no es una idea nueva: es el mismo principio de verificabilidad de Wikipedia ("verificabilidad, no verdad"), donde el listón para incluir algo es que se pueda rastrear hasta una fuente, no que a alguien le parezca cierto. Lo aplico también pensando en la IA: una referencia no es solo para que el lector humano la compruebe, es contexto real y recuperable para cualquier agente que trabaje sobre este repositorio, en la línea de lo que propone llms.txt: dar a los modelos algo verificable en lo que apoyarse, en vez de dejar que generen a partir de lo que "les suena".
Después de un tiempo estudiando Web3 en general, decidí centrar ese aprendizaje en un terreno que ya conozco bien: la Administración Pública, y en concreto, en dónde una arquitectura descentralizada puede aportar valor real a problemas concretos. No porque la administración necesite "Web3", ni porque haya una subvención de por medio, ni porque sea lo que toca, sino porque en ciertos casos es la forma más óptima de abordar el problema.
Si quieres el porqué completo, con más contexto personal sobre cómo llegué hasta aquí, puedes leer el MANIFESTO.md.
Repasa las notas, noticias y documentos del repositorio para:
- Aprender sobre infraestructura descentralizada aplicada a la administración.
- Seguir la actualidad del Portal de Administración Electrónica (PAe) y normativa relacionada, como el ENS.
- Ver cómo evolucionan las ideas a medida que las voy documentando.
No acepto contribuciones de código ni pull requests externos — ver CONTRIBUTING.md, que en realidad es la guía de cómo trabajo yo mismo. Pero sí son bienvenidos los comentarios y los issues: si detectas un error, un enlace roto, o quieres apuntar algo, abre un issue.
Este repositorio cubre un espectro de temas relacionados con infraestructura descentralizada y administración pública, entre otros:
- Infraestructura descentralizada (DLT): blockchain, registros distribuidos y su aplicación a procesos administrativos.
- Identidad digital: identidad descentralizada, credenciales verificables y su encaje con los sistemas de identidad de las Administraciones Públicas.
- Interoperabilidad y espacios de datos: estándares de interoperabilidad, gobernanza del dato y espacios de datos europeos.
- Seguridad: el Esquema Nacional de Seguridad (ENS) y su relación con arquitecturas descentralizadas.
- Actualidad del sector: seguimiento de noticias y publicaciones del PAe relevantes para este estudio.
Para preguntas, sugerencias o dejar un comentario:
- Buzón público: mypublicinbox.com/jesusmnuin
- Issues: abre un issue en el repositorio.
Gracias por pasarte por kayzen-gob-dlt. Es un cuaderno de trabajo en evolución constante.