speak-reference-architecture

Skill do wdrażania referencyjnej architektury Speak dla aplikacji edukacyjnych. Zawiera gotowe schematy dla klienta, bramy API, silnika oceny i magazynu postępów. Używaj przy projektowaniu nowych integracji Speak, przeglądaniu struktury projektu lub ustalaniu standardów architektonicznych. Wymaga wcześniejszego skonfigurowania autentykacji poprzez skill speak-install-auth oraz ważnych danych dostępowych do API Speak.

1. Upewnij się, że wcześniej uruchomiłeś skill speak-install-auth i masz skonfigurowane zmienne środowiskowe SPEAK_API_KEY i SPEAK_APP_ID.

2. Skonfiguruj architekturę referencyjną tworząc plik speak_reference_architecture_config.ts z kluczem API, identyfikatorem aplikacji i środowiskiem (development lub production).

3. Zaimportuj SpeakClient z pakietu @speak/language-sdk i zainicjuj klienta przy użyciu konfiguracji z kroku 2.

4. Wdrożyć funkcję setup() która wywołuje client.health.check() w celu weryfikacji połączenia z platformą Speak i potwierdzenia, że integracja jest gotowa do produkcji.

5. Zweryfikuj działanie architektury uruchamiając zapytanie curl z tokenem Bearer do endpointu https://api.speak.com/v1/health — odpowiedź powinna zwrócić status połączenia.

6. Przejrzyj wygenerowaną architekturę pod kątem obsługi błędów i monitorowania, aby upewnić się, że spełnia standardy produkcyjne dla aplikacji edukacyjnych.