manual del desarrollador

Este manual está dirigido a dos audiencias: contribuyentes al código gitrust (central o mediante fork rustwarden) y desarrolladores externos que crean integraciones en la API pública. Proporciona todo lo necesario para comprender la arquitectura de las 6 cajas, contribuir con código que se ajuste a los estándares del proyecto o crear un cliente que se comunique con la API de gitrust. No cubre la instalación de una instancia de producción ni el uso diario de la fragua.

Ruta de aprendizaje: colaborador principal

El curso para colaboradores representa aproximadamente 4 horas en total, con soporte decreciente: el primer tutorial es completamente guiado, el tercero (capstone) requiere resolución sin guía paso a paso.

graph LR
    A[Utilisateur autonome] --> B[01-getting-started
45 min] B --> C[02-premiere-contribution
90 min] C --> D[03-creer-un-worker-async
capstone 120 min] D --> E[Core contributor]

Checkpoint de parcours : avant de passer au tutoriel 02, vous devez avoir compilé gitrust localement, lancé les tests unitaires et obtenu une instance de développement fonctionnelle. Si ce n'est pas le cas, relisez le tutoriel 01.

Checkpoint de parcours : avant le tutoriel 03 (capstone), vous devez avoir soumis une PR complète avec tests, passé la gate QA et reçu une review. Si ce n'est pas le cas, relisez le tutoriel 02.


Tutoriales: aprende haciendo

Los tutoriales se guían paso a paso con el resultado palabra por palabra esperado. Síguelos en orden; cada uno asume que el anterior está completo.


Procedimientos: recetas para tareas comunes

Los instructivos responden "cómo hacer X" sin ninguna explicación sustancial. Véalos en cualquier orden según sea necesario.


Referencia — información técnica exacta

La referencia documenta de forma exhaustiva la arquitectura, las API internas, el esquema de datos y las reglas de control de calidad. Destinado a consultas ocasionales.


Explicación: comprenda el por qué

Las explicaciones construyen los modelos mentales necesarios para contribuir de manera informada. Léalos cuando quiera comprender las decisiones arquitectónicas, no sólo aplicarlas.