speak-prod-checklist

Skill do weryfikacji gotowości produkcyjnej integracji Speak dla platform nauki języków. Obejmuje konfigurację uwierzytelniania, walidację potoku audio (konwersja do WAV 16kHz, limit 25MB), rate limiting z exponential backoff, monitoring czasu odpowiedzi API i zgodności z COPPA/FERPA/GDPR. Użyj przed wdrożeniem do produkcji, przygotowaniem go-live lub rozwiązywaniem problemów z integracją.

1. Upewnij się, że masz ukończoną konfigurację uwierzytelniania (speak-install-auth) oraz ważne poświadczenia API. Zainstaluj ffmpeg na swoim systemie do przetwarzania audio.

2. Przejrzyj sekcję Authentication: sprawdź, czy klucze API są przechowywane w menedżerze sekretów, ustal harmonogram rotacji kluczy (co 90 dni), użyj oddzielnych kluczy dla środowisk dev/staging/production i zaimplementuj obsługę błędów dla wygasłych kluczy.

3. Skonfiguruj potok audio: upewnij się, że preprocesor konwertuje pliki do formatu WAV 16kHz mono, dodaj walidację rozmiaru pliku (poniżej 25MB) i czasu trwania (0,5–60 sekund), włącz detekcję szumu w tle oraz fallback dla nieobsługiwanych formatów.

4. Wdrożyć rate limiting i wydajność: zaimplementuj wrapper klienta z ograniczeniem szybkości, dodaj logikę ponownych prób z exponential backoff dla błędów 429, skonfiguruj kolejkę żądań do ocen wsadowych i cache'owanie odpowiedzi gdzie to uzasadnione.

5. Skonfiguruj monitoring: śledź czas odpowiedzi API, ustaw alert dla wskaźnika błędów (cel poniżej 1%), monitoruj trafienia rate limit, rozkład wyników oceny i wskaźnik ukończenia sesji.

6. Weryfikuj compliance: dokumentuj politykę prywatności danych uczniów, wdrożyć politykę przechowywania danych audio, potwierdź zgodność z COPPA (jeśli dotyczy), FERPA (dla platform edukacyjnych) i GDPR.