forked from MxOS/mirrors
Rénich Bon Ćirić
0397fc8cc4
Establish community mirror network on IPFS for Fedora and CentOS Stream 10: - Modular documentation and specifications under docs/ - Master canonical guide under README.rst with client and node operator workflows - Ingestion, upstream sync, and Cloudflare DNSLink automation scripts in bin/ - Reverse proxy configs (Nginx/Caddy) and systemd timer units in etc/ and systemd/ Signed-off-by: Rénich Bon Ćirić <renich@evalinux.com> Co-authored-by: Gemini AI <renich+gemini@evalinux.com>
26 lines
1.8 KiB
ReStructuredText
26 lines
1.8 KiB
ReStructuredText
========================
|
|
Especificación Funcional
|
|
========================
|
|
|
|
Visión General
|
|
==============
|
|
Este documento define los requisitos funcionales del sistema de espejos comunitarios sobre IPFS. El sistema debe permitir la ingesta programada de paquetes desde fuentes oficiales, su publicación bajo un esquema de direccionamiento canónico, el pineo selectivo por parte de la comunidad y el consumo transparente desde clientes convencionales de Linux.
|
|
|
|
Requisitos Funcionales del Sistema
|
|
==================================
|
|
|
|
* **[FUNC-001] Ingesta y Catálogo Modular de Repositorios:** El sistema debe sincronizar y catalogar periódicamente los repositorios oficiales de Fedora y CentOS Stream 10 sin alterar sus metadatos ni firmas GPG.
|
|
* **[FUNC-002] Pineo Granular por Niveles:** El sistema debe permitir a los colaboradores almacenar y respaldar subárboles específicos según su disponibilidad de almacenamiento, sin obligar la descarga de la totalidad del espejo.
|
|
* **[FUNC-003] Publicación Canónica con DNSLink:** El sistema debe mantener una referencia mutable controlada bajo el dominio ``mirrors.mx-os.mx`` que apunte al identificador de contenido (CID) raíz más reciente.
|
|
* **[FUNC-004] Tablero de Métricas Públicas:** El sistema debe presentar un portal web público con estadísticas en tiempo real sobre nodos activos, volumen distribuido y mapa de distribución geográfica sin recolectar telemetría en el cliente.
|
|
* **[FUNC-005] Consumo Nativo en Clientes DNF:** El sistema debe posibilitar que cualquier instalación estándar de Fedora o CentOS Stream configure repositorios locales apuntando al gateway HTTP de IPFS.
|
|
|
|
Documentos del Dominio
|
|
======================
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
specs/catalogo-modular
|
|
specs/pineo-granular
|
|
specs/tablero-metricas
|