Місія 6: «Архітектура Ворога»

🥾 Першокурсник (рівень 1 → оцінка «3»)

У enemy_architecture/src/main.rs:

enum NodeState {
    Idle,
    Alert(u8),
    Locked(String),
}

struct GuardNode {
    id: String,
    state: NodeState,
}

fn describe(node: &GuardNode) -> String {
    match &node.state {
        NodeState::Idle => format!("Вузол {} неактивний.", node.id),
        NodeState::Alert(level) => format!("Вузол {} у тривозі, рівень {level}.", node.id),
        NodeState::Locked(code) => format!("Вузол {} заблокований, код {code}.", node.id),
    }
}

fn main() {
    let node = GuardNode { id: "PX-01".into(), state: NodeState::Idle };
    println!("{}", describe(&node));
}

Тест:

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn describe_reports_state() {
        let idle = GuardNode { id: "PX-01".into(), state: NodeState::Idle };
        assert_eq!(describe(&idle), "Вузол PX-01 неактивний.");

        let alert = GuardNode { id: "PX-02".into(), state: NodeState::Alert(42) };
        assert_eq!(describe(&alert), "Вузол PX-02 у тривозі, рівень 42.");

        let locked = GuardNode { id: "PX-03".into(), state: NodeState::Locked("L-9".into()) };
        assert_eq!(describe(&locked), "Вузол PX-03 заблокований, код L-9.");
    }
}

Точне відтворення цих сигнатур і поведінки — весь обсяг рівня 1.

⚙️ Магістр (рівень 2 → оцінка «4», захист)

Додай impl GuardNode з методами, що коректно обробляють усі варіанти вхідного стану через match, без unreachable!() як основної логіки:

impl GuardNode {
    fn escalate(&mut self) {
        self.state = match &self.state {
            NodeState::Idle => NodeState::Alert(10),
            NodeState::Alert(level) => NodeState::Alert((*level + 20).min(100)),
            NodeState::Locked(code) => NodeState::Locked(code.clone()),
        };
    }

    fn lock(&mut self, code: String) {
        self.state = NodeState::Locked(code);
    }
}

І продемонструй перехід у main, узявши стартовий рівень тривоги за таблицею варіантів (підстав своє число замість 10):

fn main() {
    // стартовий рівень тривоги — за таблицею варіантів (N % 4)
    let mut node = GuardNode { id: "PX-01".into(), state: NodeState::Alert(10) }; // підстав свій варіант
    node.escalate();
    println!("{}", describe(&node)); // рівень підвищився на 20 (з обмеженням 100)
}

Захист: усно поясни, чому escalate() з уже заблокованого вузла лишає його заблокованим (а не "розблоковує" непомітно), і чому рівень тривоги обмежений .min(100).

🏆 Легенда Коледжу (рівень 3 → оцінка «5», розширення)

Додай вкладену структуру сенсора й безпечно обробляй два рівні вкладеного Option без unwrap(). Спершу оголоси нові структури:

struct SensorReading {
    value: f64,
    ts: u64,
    // Другий рівень відсутності: показник є, а дані калібрування можуть бути відсутні.
    calibration: Option<Calibration>,
}

struct Calibration {
    offset: f64,
}

Потім додай поле до вже наявної структури GuardNode (НЕ оголошуй її вдруге — другий struct GuardNode дасть помилку E0428 "defined multiple times"):

struct GuardNode {
    id: String,
    state: NodeState,
    sensor: Option<SensorReading>, // <-- нове поле
}

⚠️ Щойно ти додаси поле sensor, усі наявні літерали GuardNode { ... } перестануть компілюватися з помилкою E0063 "missing field sensor". Онови кожен із них, дописавши sensor: None — це три конструктори в тесті describe_reports_state (idle, alert, locked) і твій демонстраційний GuardNode у main з рівня 2. Наприклад:

let idle = GuardNode { id: "PX-01".into(), state: NodeState::Idle, sensor: None };

Тепер обробляй обидва рівні Option явно, кожен своїм match:

fn sensor_summary(node: &GuardNode) -> String {
    match &node.sensor {
        // перший рівень: чи є взагалі показник сенсора
        Some(reading) => {
            // другий рівень: чи є дані калібрування — теж без unwrap()
            let calib = match &reading.calibration {
                Some(c) => format!(", калібр {:+.1}", c.offset),
                None => String::new(),
            };
            if reading.value > 90.0 {
                format!("КРИТИЧНО: {:.1} о {}{}", reading.value, reading.ts, calib)
            } else {
                format!("Показник {:.1} о {}{}", reading.value, reading.ts, calib)
            }
        }
        None => "Сенсор не підключений".to_string(),
    }
}

Пастка: unwrap() на кожному рівні вкладеного Option компілюється й навіть іноді "працює" на тестових даних — але це та сама "порожнеча", яку миттєво ловить ТехНова. Обробляй кожен рівень явно, включно з граничним випадком (наприклад, value за межами фізично можливого діапазону).