Kurs JavaScript i React · Moduł 3: Stan i zdarzenia

Projekt: Marsjański Dashboard Kolonii

4 min czytania ·
W tej lekcji5

Gratulacje - dotarłeś do finałowego projektu modułu "Stan i zdarzenia"! W poprzednich lekcjach poznałeś useState, obsługę zdarzeń, przepływ danych, podnoszenie stanu (lifting state up) i kontrolowane formularze. Teraz połączysz całą tę wiedzę w jedną spójną aplikację.

Twoim zadaniem jest zbudowanie Marsjańskiego Dashboardu Kolonii - interaktywnego panelu zarządzania bazą na Marsie. Ra, twój kosmiczny przewodnik, zebrał wymagania od centrum dowodzenia. Misja: napisać aplikację React, która monitoruje i kontroluje kluczowe systemy kolonii.

Co budujesz

Dashboard składa się z czterech połączonych sekcji:

  1. Panel systemów kolonii - monitory atmosfery, zasilania, wody i temperatury
  2. Centrum sterowania - przyciski do ręcznej regulacji parametrów
  3. Formularz rejestracji astronautów - kontrolowany formularz do dodawania załogi
  4. Dziennik zdarzeń - log, do którego każdy panel dopisuje wpisy przez funkcję addLogEntry z props

Wszystkie sekcje muszą ze sobą współpracować - zmiany w jednym panelu wpływają na inne.

Wymagania techniczne

1. Wiele stanów (useState)

Każdy system kolonii ma własny stan:

const [atmosphere, setAtmosphere] = useState(78);
const [power, setPower] = useState(85);
const [water, setWater] = useState(62);
const [temperature, setTemperature] = useState(-10);
const [crew, setCrew] = useState([
  { id: 1, name: 'Anna Kowalska', role: 'Komandor' },
  { id: 2, name: 'Jan Wiśniewski', role: 'Inżynier' }
]);

2. Obsługa zdarzeń

Każdy system ma przyciski do regulacji. Pamiętaj o zakresach bezpiecznych:

const handleAtmosphereBoost = () => {
  setAtmosphere(prev => Math.min(100, prev + 5));
  addLogEntry('Zwiększono poziom O2 o 5%');
};

3. Kontrolowany formularz rejestracji

Formularz do dodawania nowych astronautów do załogi:

const [newCrew, setNewCrew] = useState({ name: '', role: '' });

const handleCrewChange = (event) => {
  const { name, value } = event.target;
  setNewCrew(prev => ({ ...prev, [name]: value }));
};

const handleCrewSubmit = (event) => {
  event.preventDefault();
  if (!newCrew.name.trim()) return;
  setCrew(prev => [...prev, { id: Date.now(), ...newCrew }]);
  setNewCrew({ name: '', role: '' });
};

4. Alarmy w obsłudze zdarzeń

Stan krytyczny sprawdzaj w handlerze, który zmienia wartość - alarm pojawi się dokładnie w chwili zmiany:

const changePower = (delta) => {
  const next = Math.min(100, Math.max(0, power + delta));
  setPower(next);
  if (next < 20) {
    addLogEntry('ALARM: Krytycznie niski poziom zasilania!');
  }
};

Zmiany w czasie (np. zużycie wody co 5 sekund) wymagają hooka useEffect ze sprzątaniem - poznasz go w module o efektach i wtedy rozbudujesz ten dashboard.

5. Lifting state up - wspólny dziennik zdarzeń

Stan dziennika i funkcja addLogEntry żyją w komponencie głównym i są przekazywane w dół:

function MarsColonyDashboard() {
  const [log, setLog] = useState([]);

  const addLogEntry = (message) => {
    setLog(prev => [
      { id: Date.now(), time: new Date().toLocaleTimeString(), message },
      ...prev
    ].slice(0, 20));
  };

  return (
    <div>
      <SystemsPanel onLog={addLogEntry} />
      <CrewPanel onLog={addLogEntry} />
      <EventLog entries={log} />
    </div>
  );
}

Struktura komponentów

Tak może wyglądać drzewo komponentów - stan żyje na górze, a panele dostają go przez props:

MarsColonyDashboard (stan główny)
├── SystemsPanel (props: wartości + callbacki)
│   └── SystemGauge × 4
├── CrewPanel (props: crew, formularz, callbacki)
│   ├── CrewList
│   └── CrewForm
└── EventLog (props: entries)

Dane płyną w dół przez props, zdarzenia w górę przez callbacki - serce jednokierunkowego przepływu danych w React!

Kryteria oceny

  1. useState - minimum 4 stany (atmosfera, zasilanie, woda, temperatura) + stan załogi + stan formularza
  2. Obsługa zdarzeń - przyciski regulujące parametry z zabezpieczeniami (min/max)
  3. Kontrolowany formularz - dodawanie nowych astronautów z walidacją
  4. Alarmy - sprawdzanie stanu krytycznego w handlerach i wpis do dziennika
  5. Lifting state up - wspólny dziennik zdarzeń dostępny z wielu komponentów
  6. Komponentyzacja - minimum 3 osobne komponenty komunikujące się przez props

Szkielet startowy

Na start dostajesz szkielet aplikacji zgodny z powyższą strukturą: MarsColonyDashboard trzyma stany i dziennik, a panele dostają dane i funkcje przez props. Przyciski atmosfery i zasilania już działają i dopisują wpisy do dziennika - uzupełnij miejsca oznaczone TODO: stany wody i temperatury, limity 0-100, alarm niskiego zasilania i formularz rejestracji astronautów.

Kod do tej lekcji: App.jsx
import { useState } from 'react';

// Szkielet projektu "Marsjański Dashboard Kolonii" (lekcja 3_7).
// Stany i dziennik żyją w MarsColonyDashboard, a panele dostają dane i funkcje przez props.
// Uzupełnij miejsca oznaczone TODO.

let nextLogId = 1;

function SystemGauge({ label, value, unit, onAdjust }) {
  return (
    <div style={styles.gauge}>
      <h3 style={styles.gaugeLabel}>{label}</h3>
      <p style={styles.gaugeValue}>{value}{unit}</p>
      <button style={styles.button} onClick={() => onAdjust(-5)}>-5</button>
      <button style={styles.button} onClick={() => onAdjust(5)}>+5</button>
    </div>
  );
}

function SystemsPanel({ atmosphere, power, onAtmosphereChange, onPowerChange }) {
  return (
    <section style={styles.panel}>
      <h2 style={styles.title}>Systemy kolonii</h2>
      <div style={styles.gauges}>
        <SystemGauge label="Atmosfera (O2)" value={atmosphere} unit="%" onAdjust={onAtmosphereChange} />
        <SystemGauge label="Zasilanie" value={power} unit="%" onAdjust={onPowerChange} />
        {/* TODO: wskaźniki wody (%) i temperatury (°C) */}
      </div>
    </section>
  );
}

function CrewPanel({ crew }) {
  // TODO: kontrolowany formularz { name, role } z e.preventDefault() i walidacją.
  // Nowego astronautę dodaje funkcja z props, bo stan załogi żyje w rodzicu.
  return (
    <section style={styles.panel}>
      <h2 style={styles.title}>Załoga ({crew.length})</h2>
      <ul style={styles.list}>
        {crew.map((member) => (
          <li key={member.id}>{member.name} - {member.role}</li>
        ))}
      </ul>
    </section>
  );
}

function EventLog({ entries }) {
  return (
    <section style={styles.panel}>
      <h2 style={styles.title}>Dziennik zdarzeń</h2>
      {entries.length === 0 ? (
        <p style={styles.muted}>Brak wpisów - użyj przycisków w panelu systemów.</p>
      ) : (
        <ul style={styles.list}>
          {entries.map((entry) => (
            <li key={entry.id}>[{entry.time}] {entry.message}</li>
          ))}
        </ul>
      )}
    </section>
  );
}

function MarsColonyDashboard() {
  const [atmosphere, setAtmosphere] = useState(78);
  const [power, setPower] = useState(85);
  // TODO: stany water (62) i temperature (-10)
  const [crew, setCrew] = useState([
    { id: 1, name: 'Anna Kowalska', role: 'Komandor' },
    { id: 2, name: 'Jan Wiśniewski', role: 'Inżynier' },
  ]);
  const [log, setLog] = useState([]);

  // Wspólny dziennik: panele dopisują wpisy przez tę funkcję przekazaną w props
  const addLogEntry = (message) => {
    const entry = { id: nextLogId++, time: new Date().toLocaleTimeString(), message };
    setLog((prev) => [entry, ...prev].slice(0, 20));
  };

  const changeAtmosphere = (delta) => {
    // TODO: pilnuj zakresu 0-100 (Math.min i Math.max)
    setAtmosphere(atmosphere + delta);
    addLogEntry('Atmosfera: ' + (delta > 0 ? '+' : '') + delta + '%');
  };

  const changePower = (delta) => {
    // TODO: zakres 0-100 i alarm w dzienniku, gdy zasilanie spadnie poniżej 20%
    setPower(power + delta);
    addLogEntry('Zasilanie: ' + (delta > 0 ? '+' : '') + delta + '%');
  };

  // TODO: funkcja addCrewMember(member), która przez setCrew doda astronautę
  // i dopisze wpis do dziennika; przekaż ją do CrewPanel

  return (
    <div style={styles.app}>
      <h1 style={styles.header}>Marsjański Dashboard Kolonii</h1>
      <SystemsPanel
        atmosphere={atmosphere}
        power={power}
        onAtmosphereChange={changeAtmosphere}
        onPowerChange={changePower}
      />
      <CrewPanel crew={crew} />
      <EventLog entries={log} />
    </div>
  );
}

const styles = {
  app: { fontFamily: 'Arial, sans-serif', background: '#0b1020', color: '#e6ecff', minHeight: '100vh', padding: '20px' },
  header: { color: '#ff8c42', textAlign: 'center', marginTop: 0 },
  panel: { background: '#151c33', borderRadius: '12px', padding: '16px', marginBottom: '16px' },
  title: { marginTop: 0, color: '#7fd1ff' },
  gauges: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(160px, 1fr))', gap: '12px' },
  gauge: { background: '#1e2747', borderRadius: '10px', padding: '12px', textAlign: 'center' },
  gaugeLabel: { margin: '0 0 6px', fontSize: '15px' },
  gaugeValue: { margin: '0 0 10px', fontSize: '28px', fontWeight: 'bold' },
  button: { margin: '0 4px', padding: '6px 12px', border: 'none', borderRadius: '6px', background: '#3a4f9a', color: 'white', cursor: 'pointer' },
  list: { margin: 0, paddingLeft: '20px', lineHeight: 1.7 },
  muted: { color: '#8f9bbf', margin: 0 },
};

export default function App() {
  return <MarsColonyDashboard />;
}

Powodzenia, pilocie! Ten projekt to twoja pierwsza prawdziwa misja w świecie React - pokaż, że potrafisz zarządzać kolonią na Marsie. Pamiętaj: każdy panel to osobny moduł statku, ale dane i decyzje płyną przez jednego dowódcę - komponent główny.

Hasła z dokumentacji w tej lekcji

Widzisz błąd w tej lekcji?

  1. Projekt do wysłaniaProjekt: Kompleksowa marsjańska kolonia React
  2. WideoVideo: Podsumowanie modułu

Przydatne artykuły