documenso-ci-integration

Skill do automatyzacji testowania i wdrażania projektów Documenso. Pozwala ci skonfigurować GitHub Actions z testami jednostkowymi, testami integracyjnymi na środowisku staging oraz bezpiecznym zarządzaniem kluczami API. Obejmuje mockowanie danych, czyszczenie dokumentów testowych i wyzwalanie pipelinów na push i pull request. Idealne dla zespołów pracujących nad integracjami Documenso, które chcą zautomatyzować cały proces od testów do produkcji.

1. Upewnij się, że masz GitHub repository z włączonymi Actions, klucz API Documenso do środowiska staging oraz skonfigurowane środowisko testowe (patrz skill documenso-local-dev-loop).

2. Utwórz plik workflow w katalogu .github/workflows/documenso-ci.yml w swoim repozytorium. Workflow powinien być wyzwalany na push do gałęzi main i develop oraz na pull requesty do main.

3. Skonfiguruj job dla testów jednostkowych, który uruchamia się na ubuntu-latest, instaluje Node.js w wersji 20, pobiera zależności npm ci i wykonuje npm test. Testy jednostkowe używają mocków, więc nie wymagają klucza API.

4. Dodaj job dla testów integracyjnych, który uruchamia się tylko na push (nie na pull requesty), zależy od ukończenia testów jednostkowych i używa zmiennej środowiskowej DOCUMENSO_STAGING_API_KEY z GitHub Secrets. Po testach uruchom npm run test:cleanup, aby usunąć dokumenty testowe.

5. Przechowuj klucz API Documenso w GitHub Secrets jako DOCUMENSO_STAGING_API_KEY — nigdy nie umieszczaj go bezpośrednio w pliku workflow.

6. Wyzwól skill frazami takimi jak "documenso CI", "documenso GitHub Actions", "documenso pipeline" lub "documenso automated testing", aby uzyskać pomoc w konfiguracji lub rozbudowie pipeline'u.