Anatomía del Repositorio y Estructura de Archivos

Al clonar o inicializar el entorno de desarrollo de Oort3, nos encontramos con una arquitectura que sigue las convenciones estándar de los espacios de trabajo en Rust. A continuación, se detalla la distribución de los componentes principales:

.
├── Cargo.toml
├── LICENSE
├── README.md
├── src/
│   ├── lib.rs
│   └── main.rs
├── tests/
└── examples/

• Cargo.toml: Manifiesto central del workspace. Gestiona las dependencias de crates externos, metadatos del paquete y perfiles de compilación.
• LICENSE: Documento legal que rige el uso del código fuente, distribuido bajo los términos de la GPL-3.0.
• src/: Núcleo de la lógica de negocio. main.rs actúa como el binario ejecutable principal, mientras que lib.rs expone las APIs públicas y módulos reutilizables.
• tests/ y examples/: Directorios dedicados a suites de integración end-to-end y casos de uso prácticos para nuevos contribuidores.

Punto de Entrada y Ciclo de Vida de la Aplicación

La ejecución del binario comienza en src/main.rs. Este archivo orquesta la inicialización de los subsistemas críticos antes de delegar el control al bucle de eventos principal. Para mejorar la robustez, el flujo de arranque está diseñado para manejar la propagación de errores de forma explícita:

fn main() -> Result<(), Box<dyn std::error::error="">> {
    // Configurar subsistema de telemetría y trazas
    setup_telemetry()?;

    // Parsear y validar variables de entorno
    let app_settings = parse_environment_settings()?;

    // Inicializar el runtime y servicios
    bootstrap_runtime(app_settings)?;

    Ok(())
}
</dyn>

• setup_telemetry(): Prepara los suscriptores de trazas estructuradas para observabilidad en producción, reemplazando los logs tradicionales por un sistema de spans y eventos.
• parse_environment_settings(): Extrae y valida la configuración desde variables de entorno o archivos locales, retornando un objeto de configuración fuertemente tipado.
• bootstrap_runtime(settings): Construye el grafo de dependencias de la aplicación y arranca los workers o servidores asíncronos según la configuración provista.

Manifiesto de Dependencias y Compilación

La configuración del compilador y la resolución de crates se gestionan estrictamente a través de Cargo.toml. Este archivo TOML dicta cómo se construye el proyecto y qué ecosistema de librerías está disponible:

[package]
name = "oort3"
version = "0.2.0"
edition = "2021"
rust-version = "1.70"

[dependencies]
tracing = "0.1"
tracing-subscriber = "0.3"
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

[dev-dependencies]
mockall = "0.11"
test-log = "0.2"

[features]
default = []
experimental_metrics = []

• [package]: Establece la identidad del crate, incluyendo la edición del compilador y la versión mínima de Rust requerida (MSRV).
• [dependencies]: Enumera las librerías de producción. En esta iteración, se utiliza tracing para logs asíncronos y tokio para el runtime concurrente.
• [dev-dependencies]: Crates exlcusivos para el entorno de pruebas, como mockall para generar mocks automáticos y test-log para capturar trazas durante la ejecución de tests.
• [features]: Flags de compilación condicional que permiten habilitar módulos experimentales o métricas avanzadas sin inflar el binario por defecto.