speak-reference-architecture
Architektura produkcyjna dla aplikacji do nauki języków z API, assessment engine i progress store.
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
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.
Jak używać
Upewnij się, że wcześniej uruchomiłeś skill speak-install-auth i masz skonfigurowane zmienne środowiskowe SPEAK_API_KEY i SPEAK_APP_ID.
Skonfiguruj architekturę referencyjną tworząc plik speak_reference_architecture_config.ts z kluczem API, identyfikatorem aplikacji i środowiskiem (development lub production).
Zaimportuj SpeakClient z pakietu @speak/language-sdk i zainicjuj klienta przy użyciu konfiguracji z kroku 2.
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.
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.
Przejrzyj wygenerowaną architekturę pod kątem obsługi błędów i monitorowania, aby upewnić się, że spełnia standardy produkcyjne dla aplikacji edukacyjnych.