HackerOS Educator

Darmowa, open-source'owa aplikacja GUI do nauki cyberbezpieczeństwa, inspirowana formatem interaktywnych „pokoi” (rooms) znanym z platform typu TryHackMe — zbudowana natywnie dla ekosystemu dystrybucji Linuksa HackerOS, ale działająca na każdym Linuksie (a po drobnych poprawkach też na Windows/macOS, dzięki Tauri).

Bez limitów, bez konta, bez chmury — cały postęp zapisywany jest lokalnie na Twoim dysku.

Funkcje

• 🧭 Tryby nauki — na starcie aplikacja pyta, czego chcesz się uczyć: Cyberbezpieczeństwa, Administracji Linuksem (na razie plansza „wkrótce”) albo Programowania (HTML, CSS, JavaScript, TypeScript, Rust, Lua, Shell, Go — lista będzie rosła). Wybór jest zapamiętywany jako domyślny, ale można go dowolnie przełączać w trakcie sesji w bocznym pasku bez utraty postępu w żadnym trybie
• 📌 Moja Nauka — centralny hub (działa ponad trybami): kontynuacja rozpoczętych pokoi, zapisane pokoje, ostatnio przeglądane, ścieżki kariery w toku i cel tygodniowy XP (dokładnie to, co w TryHackMe kryje się pod „My Learning”)
• 🧩 Pokoje z zadaniami informacyjnymi, pytaniami i zadaniami praktycznymi, filtrowane wg aktywnego trybu nauki (i dodatkowo wg języka w trybie Programowanie)
• 🔖 Zakładki (bookmarks) — zapisuj pokoje na później jednym kliknięciem
• 🕓 Historia ostatnio przeglądanych pokoi
• 🖥️ Wbudowany terminal (xterm.js + PTY w Rust) — prawdziwa lokalna powłoka do ćwiczeń, bez opuszczania aplikacji
• 📖 Podpowiedzi i pełne rozwiązania (walkthrough) — walkthrough odblokowuje się po kilku nieudanych próbach albo po ukończeniu zadania
• 📝 Notatki przypisane do każdego zadania, zapisywane automatycznie
• 🔍 Wyszukiwarka i klikalne filtry pokoi (kategoria, poziom trudności, tagi — kliknij tag w pokoju, żeby przefiltrować listę)
• 🧭 Podobne pokoje — sugestie na dole pokoju na podstawie tagów/kategorii
• 🗺️ Ścieżki kariery (np. Junior Penetration Tester, SOC Analyst) grupujące pokoje w konkretnej kolejności
• 🏅 System odznak przyznawanych automatycznie za postępy
• 🎓 Certyfikat ukończenia pokoju — generowany lokalnie, do pobrania jako plik tekstowy na pamiątkę
• 🔁 Tryb powtórek — losowe pytania z już rozwiązanych zadań, do utrwalania wiedzy bez wpływu na XP czy postęp
• 🔔 Centrum powiadomień w aplikacji (odznaki, ukończone pokoje, cel tygodniowy) + opcjonalne powiadomienia systemowe
• 📊 Dashboard statystyk — XP w czasie, czas skupionej nauki, postęp wg kategorii
• 🎯 Cel tygodniowy XP z paskiem postępu i powiadomieniem po osiągnięciu
• 🔥 Streaki dni nauki z lokalnym powiadomieniem systemowym
• ⏱️ Timer fokusu (Pomodoro) zliczający czas nauki
• 🛠️ Kreator pokoi — twórz własne pokoje w UI, bez pisania kodu
• 📦 Import/eksport paczek pokoi (.json) — łatwe dzielenie się treścią ze społecznością
• 👥 Wiele lokalnych profili z prostym rankingiem XP (offline, na jednym urządzeniu — np. do rywalizacji ze znajomymi na wspólnym komputerze)
• 💾 Eksport/import całego postępu — kopia zapasowa albo przeniesienie na inną instalację HackerOS
• 👋 Onboarding z zasadami etyki i prawa przy pierwszym uruchomieniu

Stos technologiczny

• Tauri v2 — natywna powłoka desktopowa
• Rust — backend: wieloprofilowa persystencja, lokalny terminal PTY (portable-pty), powiadomienia systemowe, operacje na plikach
• TypeScript + Solid.js — reaktywny interfejs
• xterm.js (@xterm/xterm) — emulacja terminala we froncie
• Treść pokoi jako pliki JSON + Markdown w src/data/rooms/

Wymagania

• Node.js ≥ 18
• Rust ≥ 1.77.2 (Tauri v2 tego wymaga) + cargo — najpewniej przez rustup, nie przez apt, bo dystrybucyjne pakiety Rusta bywają za stare (sprawdzone: Ubuntu 24.04 apt daje Rusta 1.75, za mało)
• Zależności systemowe Tauri v2 dla Linuksa (Debian/Ubuntu/HackerOS):

  sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
    libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev

Uruchomienie w trybie deweloperskim

npm install
npm run tauri dev

Budowanie paczek (.deb / .rpm / AppImage)

npm run tauri build

Gotowe paczki pojawią się w src-tauri/target/release/bundle/.

Stan walidacji tego repozytorium

Uczciwie o tym, co zostało sprawdzone, a co nie:

• ✅ Frontend w pełni się kompiluje: npm install, npx tsc -b --force (pełne przeliczenie od zera, bez cache — zero błędów typów, tryb strict + noUnusedLocals/noUnusedParameters) i npm run build (produkcyjny bundle Vite, 51 modułów) przechodzą bez błędów w tym repozytorium — również po dodaniu systemu trybów nauki (Cyberbezpieczeństwo / Linux / Programowanie), 8 nowych pokoi programistycznych, „Mojej Nauki”, zakładek, powiadomień, certyfikatów i trybu powtórek.
• ✅ Wszystkie 12 plików JSON z treścią pokoi i ścieżek kariery zostały automatycznie zwalidowane skryptem sprawdzającym zgodność ze schematem (track/language z dozwolonego zbioru, każde zadanie ma poprawny kind, każde zadanie inne niż info ma answer itd.).
• ℹ️ Rundy funkcji od „Mojej Nauki” włącznie (zakładki, historia, cel tygodniowy, powiadomienia, certyfikaty, tryb powtórek, podobne pokoje, system trybów nauki) są w całości frontendowe — nie dodano żadnych nowych komend Rust, więc backend (src-tauri/) nie zmienił się względem wcześniejszej rundy z terminalem i wieloprofilowością.
• ⚠️ Backend Rust nie został w pełni skompilowany end-to-end — środowisko, w którym powstał ten kod, miało dostępnego Rusta tylko w wersji 1.75 (z apt), a Tauri v2 i jego zależności (m.in. indexmap) wymagają nowszego Rusta (edycja 2024, potrzebne ≥ 1.77–1.85 w zależności od wersji zależności) i nie było możliwości pobrania rustup w tamtym środowisku. Kod Rust (src-tauri/src/*.rs) został ręcznie przejrzany pod kątem poprawności API portable-pty i tauri v2 (m.in. poprawiono realny błąd: brak Clone na evencie wymaganym przez Emitter::emit, oraz porzucany uchwyt procesu potomnego przy tworzeniu terminala, co zostawiałoby procesy zombie), ale zalecane jest odpalenie cargo check / cargo build we własnym środowisku z aktualnym Rustem przed pierwszym uruchomieniem.

Ikony aplikacji

Repozytorium nie zawiera jeszcze finalnych plików ikon. Wygeneruj je z jednego pliku PNG/SVG poleceniem:

npm run tauri icon sciezka/do/logo.png

Struktura projektu

src/                     — frontend Solid.js
  components/            — komponenty UI (pokoje, terminal, kreator, dashboard...)
  data/rooms/*.json       — treść edukacyjna pokoi
  data/career-paths.json  — ścieżki kariery
  data/badges.ts          — definicje i logika odznak
  store/progress.ts       — logika profili, XP, streaków, notatek, odznak
  styles/global.css       — motyw wizualny (celowo NIE zielony)
src-tauri/               — backend Rust
  src/commands.rs         — profile, pliki, import/eksport
  src/terminal.rs         — lokalny terminal PTY (portable-pty)
  capabilities/           — model uprawnień Tauri v2

Dodawanie nowego pokoju

Opcja A — przez UI: zakładka „Kreator pokoi” → wybierz tryb nauki (i język, jeśli to Programowanie) → wypełnij formularz → „Zapisz jako pokój własny” albo „Eksportuj do pliku” (żeby udostępnić innym).

Opcja B — ręcznie:

1. Utwórz plik src/data/rooms/nazwa-pokoju.json wg schematu z src/types.ts — pamiętaj o polu "track" ("cybersecurity" / "linux-admin" / "programming") i, dla trybu programowania, "language".
2. Zaimportuj go w src/data/rooms.ts i dodaj do tablicy builtInRooms.

Format paczki pokoi (.hosroom.json)

Prosty, czytelny format do dzielenia się treścią bez rekompilacji aplikacji:

{
  "packFormatVersion": 1,
  "packName": "Nazwa paczki",
  "author": "Twój pseudonim",
  "rooms": [ /* obiekty Room, patrz src/types.ts */ ]
}

Importuje się go przez zakładkę „Kreator pokoi” → „Importuj paczkę pokoi”.

Terminal lokalny — ważna uwaga

Zadania praktyczne mogą osadzać prawdziwy terminal (PTY) podłączony do lokalnej powłoki użytkownika ($SHELL, domyślnie bash). To dokładnie ten sam dostęp, jaki użytkownik ma z poziomu dowolnego innego terminala na własnym komputerze — aplikacja nie łączy się z żadnym zdalnym systemem ani nie próbuje niczego atakować. Służy wyłącznie do ćwiczenia poleceń na własnej maszynie.

Zasady i etyka

Aplikacja uczy metodologii, teorii sieci/systemów i podstaw defensywnych oraz ofensywnych bez dystrybuowania gotowych exploitów czy narzędzi do ataków na cudze systemy. Zanim przetestujesz jakikolwiek system spoza własnej infrastruktury — zawsze potrzebujesz pisemnej zgody właściciela (Rules of Engagement).

Plan dalszego rozwoju

• Prawdziwa treść dla trybu Administracja Linuksem (usługi, systemd, sieć, użytkownicy) — obecnie sama plansza "wkrótce"
• Więcej języków programowania i bardziej rozbudowane pokoje (obecnie po jednym starterowym pokoju na język)
• Integracja z lokalnym menedżerem maszyn wirtualnych HackerOS do w pełni kontrolowanych, autorskich labów offline
• Historia sesji terminala per zadanie (zapis/odtwarzanie)
• Więcej ścieżek kariery (GRC, analiza malware, forensics, backend/DevOps)
• Podpisywanie/weryfikacja paczek pokoi społeczności

Licencja

GPL 3.0 — patrz LICENSE.