Kurs JavaScript i React · Moduł 4: Context API i useReducer

Projekt: Galaktyczne Centrum Dowodzenia

3 min czytania ·
W tej lekcji5

Przez cały ten moduł budowałeś wiedzę krok po kroku: Context API, reducery, łączenie tych narzędzi, optymalizacja. Teraz czas połączyć to wszystko w jeden projekt - Galaktyczne Centrum Dowodzenia (Galactic Command Center).

To nie jest kolejna lekcja teoretyczna. To projekt, który sam zbudujesz, używając wszystkiego czego się nauczyłeś.

Co zbudujesz?

Aplikację zarządzającą flotą statków kosmicznych z trzema niezależnymi systemami, z których każdy ma własny kontekst:

  • ThemeContext - przełącznik motywu (tryb dzienny "Sunrise" / nocny "Deep Space")
  • AuthContext - system autoryzacji (Kapitan zalogowany / wylogowany)
  • MissionContext - serce aplikacji: zarządzanie misjami przez useReducer

Komponenty na ekranie będą konsumować różne konteksty, zależnie od swoich potrzeb.

Wymagania projektu

1. ThemeContext

Kontekst przechowuje aktualny motyw i funkcję przełączającą. Komponent ThemeToggle zmienia motyw, a reszta aplikacji reaguje na zmianę (np. klasa CSS na głównym kontenerze).

// Oczekiwana struktura kontekstu
{
  theme: 'dark' | 'light',
  toggleTheme: () => void
}

2. AuthContext

Kontekst przechowuje dane kapitana i umożliwia logowanie/wylogowanie. Formularz logowania powinien przyjmować imię kapitana. Po zalogowaniu wyświetlaj powitanie i przycisk wylogowania.

// Oczekiwana struktura kontekstu
{
  captain: { name: string } | null,
  login: (name: string) => void,
  logout: () => void
}

3. MissionContext z useReducer

To główna część projektu. Reducer obsługuje co najmniej 4 typy akcji:

// Typy akcji do zaimplementowania
'ADD_MISSION'      // dodaje nową misję do listy
'UPDATE_STATUS'    // zmienia status istniejącej misji
'ASSIGN_SHIP'      // przypisuje statek do misji
'COMPLETE_MISSION' // oznacza misję jako zakończoną

// Przykładowy kształt stanu
{
  missions: [
    {
      id: 1,
      name: 'Eksploracja Marsa',
      status: 'planning' | 'active' | 'completed',
      assignedShip: string | null
    }
  ],
  availableShips: ['USS Nova', 'Orion-7', 'Celestia']
}

Struktura komponentów

Aplikacja powinna składać się z następujących komponentów:

function App() {
  return (
    <ThemeProvider>
      <AuthProvider>
        <MissionProvider>
          <div className="app">
            <Header />        {/* używa AuthContext + ThemeContext */}
            <MissionDashboard /> {/* używa MissionContext + AuthContext */}
            <ThemeToggle />   {/* używa ThemeContext */}
          </div>
        </MissionProvider>
      </AuthProvider>
    </ThemeProvider>
  );
}

Header - wyświetla tytuł aplikacji, status zalogowania (z AuthContext) i aktualny motyw.

MissionDashboard - lista misji, formularz dodawania nowej misji, przypisywanie statków. Dostępny tylko dla zalogowanego kapitana.

ThemeToggle - przycisk przełączający między trybem dziennym i nocnym.

Wskazówki implementacyjne

Zacznij od zbudowania każdego providera osobno i przetestowania go zanim połączysz wszystkie razem. Dobrą kolejnością jest: ThemeProvider (najprostszy) → AuthProvider → MissionProvider.

Pamiętaj o niestandardowych hookach dla każdego kontekstu:

function useTheme() {
  const ctx = useContext(ThemeContext);
  if (!ctx) throw new Error('useTheme musi być wewnątrz ThemeProvider');
  return ctx;
}

function useAuth() {
  const ctx = useContext(AuthContext);
  if (!ctx) throw new Error('useAuth musi być wewnątrz AuthProvider');
  return ctx;
}

function useMissions() {
  const ctx = useContext(MissionContext);
  if (!ctx) throw new Error('useMissions musi być wewnątrz MissionProvider');
  return ctx;
}

Dla MissionContext zastosuj wzorzec podziału na kontekst stanu i kontekst dispatch, którego nauczyłeś się w poprzedniej lekcji - to dobra praktyka przy złożonym stanie z useReducer.

Co demonstrować w projekcie

Gotowy projekt powinien pokazywać:

  1. Trzy niezależne systemy kontekstu działające równocześnie
  2. Komponent Header korzystający jednocześnie z AuthContext i ThemeContext
  3. Zmianę motywu natychmiast widoczną w całej aplikacji
  4. Dodawanie misji i zmianę ich statusu przez dispatch
  5. Blokadę panelu misji dla niezalogowanych użytkowników
  6. Przypisanie statku do misji (akcja ASSIGN_SHIP z payloadem)

Projekt jest celowo opisany ogólnie - to Twoja szansa na twórcze podejście do rozwiązania. Skorzystaj z edytora poniżej, żeby zbudować swoją wersję Galaktycznego Centrum Dowodzenia.

Kod do tej lekcji: App.jsx
import React, { createContext, useContext, useReducer, useState } from 'react';

// ============================================================
// PROJEKT: Galaktyczne Centrum Dowodzenia
// Zadanie: Uzupełnij brakujące fragmenty kodu (oznaczone TODO)
// ============================================================

// --- 1. THEME CONTEXT ---
const ThemeContext = createContext();

function ThemeProvider({ children }) {
  const [darkMode, setDarkMode] = useState(true);
  // TODO: Dodaj do value również funkcję toggleTheme
  return (
    <ThemeContext.Provider value={{ darkMode, toggleTheme: () => setDarkMode(d => !d) }}>
      {children}
    </ThemeContext.Provider>
  );
}

function useTheme() {
  // TODO: Użyj useContext aby odczytać ThemeContext
  return useContext(ThemeContext);
}

// --- 2. AUTH CONTEXT ---
const AuthContext = createContext();

const authInitialState = { user: null, isLoggedIn: false };

function authReducer(state, action) {
  switch (action.type) {
    case 'LOGIN':
      // TODO: Zwróć nowy state z user: action.user i isLoggedIn: true
      return { ...state, user: action.user, isLoggedIn: true };
    case 'LOGOUT':
      return authInitialState;
    default:
      return state;
  }
}

function AuthProvider({ children }) {
  const [state, dispatch] = useReducer(authReducer, authInitialState);
  return (
    <AuthContext.Provider value={{ ...state, dispatch }}>
      {children}
    </AuthContext.Provider>
  );
}

function useAuth() { return useContext(AuthContext); }

// --- 3. MISSION CONTEXT ---
const MissionContext = createContext();

const missionInitialState = { missions: [] };

function missionReducer(state, action) {
  switch (action.type) {
    case 'ADD_MISSION':
      // TODO: Dodaj nową misję do tablicy missions
      // Misja ma pola: id, name, status: 'pending', createdBy
      return {
        ...state,
        missions: [
          ...state.missions,
          { id: Date.now(), name: action.name, status: 'pending', createdBy: action.createdBy },
        ],
      };
    case 'UPDATE_STATUS':
      return {
        ...state,
        missions: state.missions.map(m =>
          m.id === action.id ? { ...m, status: action.status } : m
        ),
      };
    default:
      return state;
  }
}

function MissionProvider({ children }) {
  const [state, dispatch] = useReducer(missionReducer, missionInitialState);
  // TODO: Owiń children w MissionContext.Provider z value={{ ...state, dispatch }}
  return (
    <MissionContext.Provider value={{ ...state, dispatch }}>
      {children}
    </MissionContext.Provider>
  );
}

function useMission() { return useContext(MissionContext); }

// --- KOMPONENTY UI ---

function LoginPanel() {
  const { isLoggedIn, user, dispatch } = useAuth();
  const [name, setName] = useState('');
  if (isLoggedIn) {
    return (
      <div style={panel}>
        <span style={{ color: '#4fc3f7' }}>Zalogowany: <b>{user}</b></span>
        <button onClick={() => dispatch({ type: 'LOGOUT' })} style={{ ...btn, marginLeft: 12 }}>
          Wyloguj
        </button>
      </div>
    );
  }
  return (
    <div style={panel}>
      <input
        value={name} onChange={e => setName(e.target.value)}
        placeholder="Twoje imię (pilot)..." style={input}
      />
      <button
        onClick={() => { if (name.trim()) dispatch({ type: 'LOGIN', user: name.trim() }); }}
        style={{ ...btn, background: '#4fc3f7', color: '#0a0e1a' }}
      >
        Zaloguj się
      </button>
    </div>
  );
}

function MissionPanel() {
  const { isLoggedIn, user } = useAuth();
  const { missions, dispatch } = useMission();
  const [newMission, setNewMission] = useState('');
  const statusLabels = { pending: '⏳ Oczekuje', active: 'Aktywna', done: 'Ukończona' };
  const statusColors = { pending: '#ff9800', active: '#4fc3f7', done: '#4caf50' };

  if (!isLoggedIn) {
    return (
      <div style={{ ...panel, color: '#778da9', textAlign: 'center' }}>
        Zaloguj się, aby zarządzać misjami
      </div>
    );
  }

  return (
    <div style={panel}>
      <h3 style={{ color: '#4fc3f7', marginTop: 0 }}>Misje kosmiczne</h3>
      <div style={{ display: 'flex', gap: 8, marginBottom: 12 }}>
        <input
          value={newMission} onChange={e => setNewMission(e.target.value)}
          placeholder="Nazwa misji..." style={{ ...input, flex: 1 }}
        />
        <button
          onClick={() => {
            // TODO: Wywołaj dispatch z type: 'ADD_MISSION', name: newMission, createdBy: user
            if (newMission.trim()) {
              dispatch({ type: 'ADD_MISSION', name: newMission.trim(), createdBy: user });
              setNewMission('');
            }
          }}
          style={{ ...btn, background: '#4fc3f7', color: '#0a0e1a' }}
        >
          Dodaj
        </button>
      </div>
      {missions.length === 0 && (
        <p style={{ color: '#555', textAlign: 'center' }}>Brak misji. Dodaj pierwszą!</p>
      )}
      {missions.map(m => (
        <div key={m.id} style={{ ...missionRow }}>
          <div>
            <div style={{ fontWeight: 'bold' }}>{m.name}</div>
            <div style={{ fontSize: 11, color: '#778da9' }}>Pilot: {m.createdBy}</div>
          </div>
          <div style={{ display: 'flex', alignItems: 'center', gap: 6 }}>
            <span style={{ color: statusColors[m.status], fontSize: 12 }}>
              {statusLabels[m.status]}
            </span>
            {m.status === 'pending' && (
              <button onClick={() => dispatch({ type: 'UPDATE_STATUS', id: m.id, status: 'active' })} style={btn}>
                Aktywuj
              </button>
            )}
            {m.status === 'active' && (
              <button onClick={() => dispatch({ type: 'UPDATE_STATUS', id: m.id, status: 'done' })} style={btn}>
                Zakończ
              </button>
            )}
          </div>
        </div>
      ))}
    </div>
  );
}

function ThemeToggle() {
  const { darkMode, toggleTheme } = useTheme();
  return (
    <button onClick={toggleTheme} style={{ ...btn, float: 'right', marginBottom: 12 }}>
      {darkMode ? 'Jasny motyw' : 'Ciemny motyw'}
    </button>
  );
}

// --- GŁÓWNA APLIKACJA ---
// TODO: Owiń App w ThemeProvider, AuthProvider i MissionProvider (kolejność ma znaczenie!)
function App() {
  const { darkMode } = useTheme();
  const bg = darkMode ? '#0a0e1a' : '#e8f4fd';
  const fg = darkMode ? 'white' : '#0a0e1a';

  return (
    <div style={{ minHeight: '100vh', background: bg, padding: 24, fontFamily: 'Arial', color: fg, transition: 'all 0.3s' }}>
      <ThemeToggle />
      <h1 style={{ textAlign: 'center', color: '#ffd700', marginBottom: 24, clear: 'both' }}>
        Galaktyczne Centrum Dowodzenia
      </h1>
      <LoginPanel />
      <MissionPanel />
    </div>
  );
}

function WrappedApp() {
  return (
    <ThemeProvider>
      <AuthProvider>
        <MissionProvider>
          <App />
        </MissionProvider>
      </AuthProvider>
    </ThemeProvider>
  );
}

// Style
const panel = {
  background: '#1a2035', borderRadius: 10, padding: 16, marginBottom: 14,
  border: '1px solid rgba(79,195,247,0.2)',
};
const btn = {
  background: 'rgba(255,255,255,0.08)', color: 'white',
  border: '1px solid rgba(255,255,255,0.2)', borderRadius: 6,
  padding: '5px 12px', cursor: 'pointer', fontSize: 12,
};
const input = {
  background: '#0a0e1a', color: 'white',
  border: '1px solid rgba(79,195,247,0.3)', borderRadius: 6,
  padding: '6px 10px', boxSizing: 'border-box',
};
const missionRow = {
  display: 'flex', justifyContent: 'space-between', alignItems: 'center',
  padding: '8px 0', borderBottom: '1px solid rgba(255,255,255,0.07)',
};

export { WrappedApp as default };

Hasła z dokumentacji w tej lekcji

Widzisz błąd w tej lekcji?

  1. Projekt do wysłaniaProjekt do mentora: Centrum Dowodzenia Galaktycznego
  2. WideoVideo: Podsumowanie modułu

Przydatne artykuły