Struktury Danych - Przegląd

Wprowadzenie

Ta sekcja dokumentacji zawiera szczegółowe struktury danych (JSON schemas) dla wszystkich kluczowych obiektów w Lumos Islands.

---

Główne Struktury Danych

1. Activity Assets

Szczegółowe schematy JSON dla wszystkich typów aktywności edukacyjnych - Zobacz: systems/activities.md

Typy aktywności:

• Quiz
• Video
• Audio
• Minigame
• Creative Task
• Reading
• Interactive Story
• Coding Challenge

---

2. Locations

Struktura danych dla lokacji w mieście (POI - Points of Interest) - Zobacz: systems/city-locations.md

---

3. Tasks

Struktura dla zadań (questy, daily challenges, group quests) - Do dodania w przyszłości

---

4. Items & Resources

Definicje wszystkich przedmiotów, surowców i bloków buildowlanych - Zobacz: systems/resources.md

---

5. Users & Groups

Schematy dla użytkowników i grup - Zobacz: systems/user-roles.md i systems/groups.md

---

Format

Wszystkie struktury używają JSON Schema lub TypeScript interfaces dla klarowności.

Przykład

interface Activity {
  activity_id: string;
  type: ActivityType;
  metadata: ActivityMetadata;
  content: ActivityContent;
  rewards: Rewards;
}

---

Pełne Schematy

Szczegółowe schematy znajdują się w kolejnych dokumentach tej sekcji. Każdy dokument zawiera:

• JSON Schema - formalna definicja
• TypeScript Interface - dla developer-friendly format
• Przykłady - rzeczywiste przykłady JSON
• Validation rules - zasady walidacji

---

Użycie

Te schematy są używane przez:

1. Backend API - walidacja danych
2. Mobile App - deserializacja z API
3. Web App (Creator Tools) - tworzenie nowych activities przez nauczycieli/rodziców
4. Database - struktura dokumentów w MongoDB/PostgreSQL

---

📄 Przejdź do: Activity Assets w sekcji Systems aby zobaczyć pełne schematy aktywności.