🏛️ Rust explicado como un mercado financiero

Bienvenido al sistema económico de Rust. En la mayoría de los lenguajes de programación, la memoria funciona bajo un modelo comunal o estatal: existe un Recolector de Basura (Garbage Collector) que cobra impuestos (rendimiento de CPU) para limpiar el desastre de los ciudadanos descuidados.

Rust elimina al intermediario estatal y establece un libre mercado puro de propiedad privada. En este curso, entenderás cómo funciona la gestión de memoria utilizando conceptos del mundo financiero.

🏛️ Módulo 0: El Catastro y la Infraestructura Financiera

Antes de empezar a comerciar, debemos entender el mapa geográfico e institucional de nuestro territorio (la memoria de la computadora).

El Registro de Entidades Financieras

Entidad de Hardware	Rol en la Economía de Rust	Descripción de su Función
La Memoria RAM	El Territorio Nacional	El espacio geográfico total disponible para fundar empresas y construir proyectos.
El Sistema Operativo	El Ministerio de Territorio	El ente que asigna parcelas de tierra cruda al programa cuando este se lo solicita.
El Segmento `.rodata`	La Reserva Federal Inviolable	Monumentos nacionales históricos. Son bienes que el Estado grabó a fuego. No se pueden alterar, no se pueden demoler y cualquier ciudadano puede ir a mirarlos (`&str`), pero nadie puede poseerlos en exclusiva.
El Stack (La Pila)	La Bolsa de Valores (De Alta Velocidad)	Una oficina financiera ultraeficiente de alta velocidad. Solo maneja transacciones con contratos estandarizados y de tamaño fijo (enteros, booleanos). Todo lo que entra aquí se liquida al instante en cuanto termina la jornada (la función).
El Heap (El Montículo)	El Mercado de Bienes Raíces Libres	Un terreno gigantesco y libre. Aquí se construyen los rascacielos y centros comerciales (datos dinámicos como `String` o listas). Construir aquí requiere una solicitud formal al Ministerio y es costoso, pero el espacio es flexible.
Una Variable	El Ciudadano / Inversor	El agente económico (un nombre en el código) que registra propiedades a su nombre y firma los contratos de préstamo.
Un Puntero en el Stack	La Escritura de Propiedad	Un papel físico muy pequeño y barato que guardas en tu oficina del Stack. No es el edificio en sí, pero certifica la dirección exacta del Heap donde se encuentra tu propiedad.
El Borrow Checker	La Superintendencia de Bancos	El organismo regulador implacable. No interviene mientras el programa corre; revisa todos los contratos en la fase de planificación (compilación). Si detecta riesgo de quiebra técnica, clausura el proyecto de inmediato.

🏬 Módulo 1: Propiedad Privada (Ownership)

En la economía de Rust, el lenguaje impone un régimen estricto de propiedad privada regulado por tres leyes constitucionales:

Cada recurso en el Heap tiene un único dueño legítimo (una variable en el Stack que posee la escritura).
Solo puede haber un dueño a la vez. No existe la copropiedad de escrituras.
Cuando el dueño sale del mercado (sale de su scope), la propiedad se liquida automáticamente y el edificio se demuele de forma segura (liberación de memoria).

La Transacción de Venta: El Move (Transferencia de Propiedad)

Cuando asignas una variable del Heap a otra, no duplicas el edificio (sería demasiado caro). En su lugar, transfieres la escritura de propiedad. El dueño original pierde todo derecho sobre el recurso de inmediato.

fn main() {
    // 1. "Manzanas" nace en la Reserva Federal (.rodata).
    // String::from hace una copia en el Heap y le entrega la Escritura a 'lista_a' en el Stack.
    let lista_a = String::from("Manzanas");

    // 2. Ocurre un "Move" (Transacción de compraventa).
    // La escritura pasa por completo a manos de 'lista_b'.
    let lista_b = lista_a; 

    // 3. INTENTO DE ESTAFA: 'lista_a' ya no tiene la escritura.
    // println!("{}", lista_a); // ❌ ERROR DE COMPILACIÓN: Intentaste usar una propiedad vendida.

    // 4. Operación legal: 'lista_b' es el dueño legítimo actual.
    println!("{}", lista_b); 
} // 'lista_b' sale del scope. La escritura se destruye y el edificio del Heap se demuele.

💳 Módulo 2: Arrendamiento (Borrowing) y Referencias

Tener que vender tu propiedad cada vez que quieres que otra persona la use sería inviable para los negocios. Para solucionar esto, Rust permite arrendar o rentar recursos mediante Referencias (&).

Existen dos tipos de contratos de arrendamiento en este mercado:

A. Préstamos Inmutables (`&T`): "El Contrato de Lectura"

Permites que múltiples personas entren a tu propiedad a mirar o leer, pero nadie tiene permitido hacer remodelaciones.

fn main() {
    let lista = String::from("Manzanas");

    // Arrendamos licencias de solo lectura a dos inquilinos distintos (Referencias inmutables)
    let lector_1 = &lista; 
    let lector_2 = &lista; 

    println!("Inquilino 1 lee: {}", lector_1);
    println!("Inquilino 2 lee: {}", lector_2);
    // 'lista' sigue siendo el dueño absoluto de la escritura.
}

B. Préstamos Mutables (`&mut T`): "El Contrato de Remodelación Exclusiva"

Le das permiso a un inquilino (un constructor) para que altere la propiedad. Debido al riesgo de que rompa algo, este contrato tiene una cláusula de exclusividad absoluta.

fn main() {
    let mut lista = String::from("Manzanas"); // La propiedad debe ser declarada 'mut' (remodelable)

    // Arrendamos el derecho de remodelación a un solo "constructor"
    let escritor = &mut lista;
    escritor.push_str(", Plátanos"); // Remodelación autorizada

    println!("Lista final: {}", lista);
}

⚖️ Módulo 3: La Superintendencia de Bancos (The Borrow Checker)

Para evitar que el mercado colapse por fraude financiero, la Superintendencia evalúa tu Capacidad de Endeudamiento antes de aprobar cualquier contrato de préstamo.

🚨 La Regla de Oro del Endeudamiento (Aliasing XOR Mutability)

En un momento dado, para cualquier recurso en el Heap, puedes solicitar:

Infinitos créditos de lectura de bajo riesgo (&T).

O exactamente UN SOLO crédito hipotecario de remodelación (&mut T).

Pero NUNCA puedes mezclar ambos al mismo tiempo.

El Caso del Sobregiro Financiero (Error típico de compilación)

fn main() {
    let mut lista_compras = String::from("Manzanas");

    // 1. Solicitas un crédito de lectura. Tu capacidad de endeudamiento queda comprometida.
    let lector = &lista_compras;

    // 2. ¡RECHAZADO POR LA SUPERINTENDENCIA! 
    // Solicitas una hipoteca de remodelación mutable mientras el crédito de lectura sigue activo.
    let escritor = &mut lista_compras; // ❌ ERROR DE COMPILACIÓN: Sobregiro de capacidad de endeudamiento.
    escritor.push_str(", Plátanos");

    // 3. El crédito de lectura original pretendía cobrarse aquí.
    println!("La lista es: {}", lector);
}

¿Por qué se deniega la transacción?
Porque si el escritor decide remodelar la propiedad en el Heap y esta se tiene que mudar de dirección de memoria por falta de espacio, el lector se quedaría apuntando a una dirección vacía. Esto provocaría una quiebra técnica del sistema (un puntero colgante o dangling pointer).

💰 Módulo 4: Liquidación de Deudas (Non-Lexical Lifetimes)

Para que la economía de Rust sea fluida y ágil, la Superintendencia de Bancos es inteligente. No tienes que esperar a que termine el programa para recuperar tu capacidad de endeudamiento.

En cuanto realizas el último pago (el último uso de la variable en el código), el contrato de deuda se liquida automáticamente en ese milisegundo y recuperas todo tu cupo de crédito.

fn main() {
    let mut lista_compras = String::from("Manzanas");

    let lector = &lista_compras; // 1. Abres crédito de lectura.
    println!("La lista es: {}", lector); // 2. ¡Último pago realizado! Deuda liquidada aquí.

    // 3. Tu historial vuelve a estar en verde. El banco aprueba la hipoteca mutable de inmediato.
    let escritor = &mut lista_compras; 
    escritor.push_str(", Plátanos"); // ¡Aprobado y compilado con éxito!
}

📌 Resumen de Políticas Financieras de Rust

Un solo dueño por propiedad: Evita que dos hilos o procesos intenten demoler el mismo edificio a la vez.
El "Move" es una venta: Si entregas la escritura, pierdes todo derecho de uso.
Capacidad de endeudamiento estricta: Muchos lectores tranquilos, o un único remodelador de alto riesgo, pero jamás ambos compartiendo el espacio en el mismo instante.
Historial crediticio al día: En cuanto usas un préstamo por última vez, tu deuda queda saldada y tu capacidad de crédito vuelve al 100% para la siguiente transacción.