Skip to main content

🚀 Docs Speed

Selamat datang di dokumentasi Docs Speed - solusi QA automation lengkap untuk testing API dan UI menggunakan Playwright dan TypeScript.

Apa itu Docs Speed?​

Docs Speed adalah suite QA automation yang komprehensif dirancang untuk menguji sistem dengan cakupan lengkap:

  • ✅ API Testing - Validasi endpoint, response schema, dan business logic
  • 🎨 UI Testing - Automasi browser testing dengan semantic locators
  • 🔐 Multi-Domain - Support untuk moneysite, admin, auth, dan central services
  • 📊 Enterprise Grade - Reusable helpers, fixtures, dan schema validation

Teknologi yang Digunakan​

  • Playwright - Modern testing framework untuk cross-browser automation
  • TypeScript - Type-safe test development dengan strict mode
  • pnpm - Fast package manager untuk dependency management
  • AJV - JSON schema validation untuk API responses

Quick Start​

1. Setup Environment​

# Install dependencies
pnpm install

# Setup environment variables
# Konfigurasi BASE_URL, credentials, dan API endpoints

2. Menjalankan Tests​

# Jalankan semua tests
pnpm test

# UI mode - visual test runner
pnpm test:ui

# Lihat detailed report
pnpm report

3. Linting & Formatting​

# Check linting
pnpm lint:check

# Check formatting
pnpm prettier:check

Struktur Project​

tests/
├── api/              # API tests per domain
│   ├── moneysite/    # Player/Front-end API
│   ├── admin/        # Admin/Backoffice API
│   ├── auth/         # Authentication
│   └── central/      # Central services
└── ui/               # UI tests per domain

helpers/
├── apiClient.ts      # API request factory
├── loginHelper.ts    # Authentication helpers
├── schemaValidator.ts # JSON schema validation
└── fnHelpers.ts      # Utility functions

schemas/             # JSON schemas untuk API responses
fixtures/            # Test data & fixtures
output/              # API response snapshots

Fitur Utama​

🔑 Authentication​

  • loginAsPlayer() - Login sebagai player dengan credentials
  • loginAsAdmin() - Login sebagai admin user

📋 API Testing​

  • Centralized API client dengan apiClient(baseURL)
  • Built-in schema validation dengan schemaValidator()
  • Response snapshot comparison
  • Support untuk berbagai content types

🎯 Custom Assertions​

  • shouldBeOneOf() - Custom matcher untuk enum values
  • shouldMatch() - Pattern matching untuk responses
  • Advanced filtering dan sorting dengan fnHelpers

📈 Test Data Generation​

  • Dynamic test data generation dengan generatorData
  • Reusable fixtures untuk common scenarios
  • Data-driven testing support

Dokumentasi Selanjutnya​

Jelajahi dokumentasi kami untuk informasi lebih detail:

Kontribusi & Standards​

Kami mengikuti standar kode yang ketat:

  • TypeScript Strict Mode - Type safety adalah prioritas
  • Semantic Locators - Prefer getByRole, getByLabel, getByText
  • Test Naming - ✅ untuk positive cases, ❌ untuk negative cases
  • DRY Principle - Extract reusable helpers jika ada duplication

Dukungan​

Untuk pertanyaan atau issues:

  1. Cek dokumentasi yang tersedia
  2. Review test examples di folder tests/
  3. Lihat existing helpers di folder helpers/

Happy Testing! 🧪
Mari kita pastikan setiap feature bekerja sempurna dengan automation testing yang solid.