# Helyi staging kiadás

A staging kiadás szándékosan nem használ Gitea Actions runnert. A kiadásért felelős fejlesztő saját gépén vezérli a folyamatot; nincs állandó CI-host, runner-regisztráció vagy extra szerveroldali jogosultság.

## Egy parancsos folyamat

```bash
./scripts/deploy_to_stage_on_local.sh
```

A script rögzített sorrendben fut:

1. Ellenőrzi, hogy a helyi `main` ág és a Git munkakönyvtár tiszta-e.
2. A `proto` könyvtárban futtatja a determinisztikus `npm ci` telepítést és az unit teszteket.
3. Feltolja a `main` commitot a Gitea-ra.
4. SSH-n belép a staging hostra (`sadmin@llmdev.mozdit.hu`), a `/home/sadmin/websitedev` könyvtárban fast-forward Git frissítést végez, majd futtatja a `./deploy.sh staging` parancsot.
5. A helyi gépről a `https://stage.mozdit.hu` ellen lefuttatja az öt Playwright smoke tesztet.

Hiba esetén a script azonnal leáll. Ez különösen fontos: sikertelen unit teszt esetén nincs push vagy deploy; sikertelen szerveroldali healthcheck esetén nincs sikeres kiadás jelzés; sikertelen smoke teszt esetén a staging kiadás további ellenőrzést igényel.

## Előfeltételek a helyi gépen

- Git-hozzáférés a `origin` Gitea remote-hoz
- SSH-hozzáférés `sadmin@llmdev.mozdit.hu` célhoz
- Node.js és npm
- a Playwright Chromium böngészője. Új gépen egyszer:

```bash
cd proto
npx playwright install chromium
```

## Egyedi célok

A paraméterek szükség esetén környezeti változóval felülírhatók:

```bash
STAGE_HOST=felhasznalo@masik-stage-host \
STAGE_PATH=/srv/websitedev \
STAGE_URL=https://stage.mozdit.hu \
./scripts/deploy_to_stage_on_local.sh
```

## Gitea Actions

A `.gitea/workflows/ci.yml` workflow jelenleg szünetel, mert nincs dedikált, biztonságosan elkülönített runner. A régi Gitea Actions futásokat a Gitea felületén a `Cancel` gombbal meg kell szakítani. Ha később dedikált CI-host készül, a workflow visszaállítható és a telepítési modell újraértékelhető.