1. Rejestracja i przygotowanie zadania

• Źródło: Jira, GitHub Issues, ClickUp
• Rodzaje: feature, bugfix, spike, refactor, tech debt
• Etapy:
  • Grooming – doprecyzowanie zakresu
  • Estymacja (np. story points)
  • Opis zadania + Acceptance Criteria
  • Przypisanie developera

2. Praca z repozytorium (GitHub)

Branching

• main – gałąź produkcyjna
• develop – gałąź testowa
• feature/ – nowe funkcje
• release/ – przygotowanie wersji
• hotfix/ – szybkie poprawki

Zasady pracy

• Branch z develop lub release
• Commity atomiczne, zrozumiałe
• Konwencja: feature/nazwa-zadania-ID

3. Środowisko deweloperskie (DEV)

• Lokalne: Docker, Laravel Sail, DDEV
• Izolacja środowiska (env, kontenery)
• Mocki, seedery, fabryki danych
• Narzędzia: Xdebug, Telescope, PHPStan, Psalm

4. Review App (RA)

• Automatyczne środowisko z PR (GitHub Actions, Heroku)
• Dostępne dla QA, PM, testów funkcjonalnych
• Usuwane po zamknięciu PR

5. Code Review (PR)

• PR z feature do develop lub release
• Opis zmian + link do zadania
• Checklist:
  • Pokrycie testami
  • Dokumentacja
  • Zgodność ze standardem
• Min. 1–2 reviewerów

6. RC (Release Candidate)

• Środowisko z gałęzi release/X.Y.Z
• Weryfikacja przedprodukcyjna
• Testy regresyjne i integracyjne
• Użytkownicy: QA, testerzy, PM
• Deploy manualny lub automatyczny z brancha release

7. Testy automatyczne

• Push do branch:
  • Unit + lint + analiza
• PR do develop/release:
  • Unit + integracyjne + CI
• Merge release:
  • Testy E2E + deploy preview

Narzędzia: PHPUnit, Pest, Dusk, Cypress, GitHub Actions

8. Deploy na produkcję

• Merge do main
• Tag release (np. v1.0.0)
• Deploy: automatyczny lub manualny
• Monitoring: logi, błędy, metryki
• Opcje: blue-green, canary release, feature flags

9. Po wdrożeniu

• Smoke testy produkcyjne
• Monitoring aplikacji
• Aktualizacja changeloga i dokumentacji

10. Środowiska – Podsumowanie

Środowisko	Cel	Dostęp	Deploy z	Uwagi
DEV	Praca lokalna	Developerzy	Branch lokalny	Docker, mocki, seedery
RA (Review App)	Test funkcjonalny brancha	QA, PM	Pull Request	Automatyczny, efemeryczny
RC (Release Candidate)	Weryfikacja wydania	QA, PM	release/X.Y.Z	Kopia prod
PROD	Użytkownicy	Użytkownicy końcowi	main + tag	Monitoring, rollback

1. Automatyczne generowanie branchy

• Cel: standaryzacja nazewnictwa i eliminacja błędów
• Narzędzia: GitHub CLI, aliasy bashowe, szablony Issue
• Przykład:

gh issue create --title "Dodaj rejestrację użytkownika" --label feature
    git checkout -b feature/register-user-123

2. Continuous Integration (CI)

• Cel: automatyczne testy i analiza kodu przy push/PR
• Typowe kroki:
  • Linting (PHPStan, ESLint)
  • Testy jednostkowe i integracyjne
  • Budowa i deploy Review App
• Narzędzia: GitHub Actions, GitLab CI, CircleCI

Przykład CI (GitHub Actions):

    name: CI
    
    on:
      push:
        branches: [ develop, feature/**, hotfix/** ]
      pull_request:
    
    jobs:
      tests:
        runs-on: ubuntu-latest
        services:
          mysql:
            image: mysql:8.0
            env:
              MYSQL_ROOT_PASSWORD: root
              MYSQL_DATABASE: app_test
            ports: [3306:3306]
        steps:
          - uses: actions/checkout@v3
          - uses: shivammathur/setup-php@v2
            with:
              php-version: '8.3'
          - run: composer install
          - run: php artisan migrate --env=testing
          - run: php artisan test
        

3. Review Apps (RA)

• Cel: izolowane środowisko z kodem z PR
• Narzędzia: Heroku, GitHub Actions, Docker
• Opis: PR → build → deploy do subdomeny (np. ra.domain.dev/PR-123)

4. Automatyzacja Release Candidate (RC)

• Cel: weryfikacja kodu przed wypuszczeniem na produkcję
• Proces: PR do release/X.Y.Z uruchamia:
  • Build
  • Testy regresyjne
  • Deploy na środowisko RC
• Dodatkowo: import danych testowych, smoke testy

5. Automatyzacja Code Review

• Cel: szybka weryfikacja jakości kodu
• Narzędzia: Laravel Pint, PHPStan, Danger.js, Dependabot

6. Automatyczne wersjonowanie i changelog

• Cel: eliminacja ręcznego tagowania i opisu zmian
• Commit style: Conventional Commits (feat:, fix:, chore: itd.)
• Narzędzia: Commitizen, semantic-release
• Efekt: Commit → Release → tag vX.Y.Z + changelog + publikacja

7. Continuous Deployment (CD)

• Cel: automatyczne wdrażanie aplikacji
• Środowiska: dev, rc, prod
• Narzędzia: Laravel Envoyer, Deployer, GitHub Actions + SSH

Przykład deploy z tagu:

    on:
      push:
        tags:
          - 'v*'
    
    jobs:
      deploy:
        runs-on: ubuntu-latest
        steps:
          - uses: actions/checkout@v3
          - run: ssh user@server "cd /app && git pull && php artisan migrate --force"
        

8. Monitoring i rollback

• Cel: natychmiastowe wykrycie błędów po deploymencie
• Narzędzia: Sentry, Bugsnag, NewRelic, Laravel Log Viewer
• Rollback: ręcznie lub automatycznie po błędzie krytycznym
• Przykład rollbacku: git checkout tags/v1.2.3

9. Słownik pojęć (cheat sheet)

Termin	Znaczenie
CI	Continuous Integration – automatyczne testowanie kodu przy każdej zmianie
CD	Continuous Deployment / Delivery – ciągłe wdrażanie lub przygotowanie do wdrożenia
Review App (RA)	Środowisko testowe na potrzeby PR
RC	Release Candidate – kandydat do wydania, ostatni etap testów
Deploy	Publikacja kodu aplikacji na środowisko
Pipeline	Ciąg kroków automatyzacji (build, test, deploy)
Tag	Wersja kodu, np. v1.2.3
Semantic Release	System automatycznego tagowania wersji
Feature Flag	Przełącznik funkcjonalności bez deployu
Blue-Green deploy	Przełączalne środowiska produkcyjne
Rollback	Cofnięcie wdrożenia do poprzedniej wersji