# Változásnapló és verziószámozás

> A Haszno API verziószámozási szabályzata és a nyilvános fejlesztői előzetes dátumozott változásainak listája.

## Verziószámozási szabályzat

A Haszno API **verziószámozás nélküli fejlesztői előzetes**. Az útvonalakban ma nincs verzióelőtag (nincs `/v1/` vagy hasonló szegmens).

> [!WARNING]
> A fejlesztői előzetes ideje alatt előzetes értesítés nélkül is előfordulhatnak törésváltások. Ne építs éles integrációt erre az API-ra a Haszno csapatával való egyeztetés nélkül.

### Stabil verzió bevezetésekor

Az alábbi szerződés akkor lép érvénybe, ha az API az általános elérhetőség szintjére emelkedik. Ma még nem érvényes.

- Bevezetünk egy stabil verzióelőtagot (`/v1/`).
- Végpont vagy válaszmező eltávolítása előtt **6 hónapos leállítási ablakot** biztosítunk.
- A törésváltásokat ebben a változásnaplóban és e-mailben is bejelentjük a regisztrált fejlesztőknek.

### Mi számít törésváltásnak

Ha már létezik stabil verzió, a következők törésváltásnak minősülnek:

- Végpont vagy HTTP-metódus eltávolítása.
- Korábban mindig jelenlévő válaszmező eltávolítása.
- Válaszmező típusának megváltoztatása (pl. sztringből egész szám).
- Kötelező kérésiparaméter típusának megváltoztatása vagy érvényes tartományának szűkítése.
- HTTP-státuszkód jelentésének megváltoztatása egy adott végponton.

A következők **nem** törésváltások, és előzetes értesítés nélkül megtörténhetnek:

- Új opcionális válaszmezők hozzáadása.
- Új opcionális kérésiparaméterek hozzáadása.
- Új végpontok hozzáadása.
- Validáció lazítása (korábban `400`-at okozó értékek elfogadása).

## Változásnapló

Az alábbi változások a tároló commit-előzményéből származnak (a `docs` és `web/public/docs` útvonalak csak olvasható `git log`-ja). Az API aktív fejlesztés alatt áll; ez a lista nem teljes körű.

### 2026-11-12

- **docs redesign** (`#86`) — a `docs.haszno.com` olvasásorientált háromoszlopos elrendezéssel, teljes szöveges keresőpárbeszédablakkal és frissített navigációs szerkezettel újraépítve.
- **support hub** (`#81`) — a `support.haszno.com` és az API-n belüli támogatási chat (`POST /api/support/conversations`) elindult.
- **security hardening** (`#39`) — útvonalankénti sebességkorlátok, biztonsági fejlécek (HSTS, CSP, X-Frame-Options), Vercel Cron-védelem, CI-folyamat, jogi oldalak és SEO-metaadatok alkalmazva.

### 2026-11-10

- **English documentation** (`#49`) — az összes dokumentációs oldal teljes angol fordítása, HU/EN nyelvváltóval és IP-alapú alapértelmezett nyelvválasztással.
- **Public demo API** — a szintetikus adatokat kiszolgáló, csak olvasható nyilvános GET-végpontok aktívak a `https://haszno.com` címen. Végpontok: `/api/categories`, `/api/products`, `/api/suppliers`, `/api/stats`, `/api/settings`, `/api/impact`, `/api/orders`, `/api/proposals`, `/api/peers/invites`, `/api/peers/links`, `/api/import-list`.
- **MCP / CLI / skill** — a `haszno-mcp`, `haszno-cli` és `haszno-skill` telepítője és egészségügyi ellenőrzése (`haszno_ping`, `GET /api/health`) közzétéve.

### 2026-11-08

- **Rename Árfutár → Haszno** (`#15`) — a termék és a domain átnevezve. Az `ARFUTAR_API_KEY` és az `ARFUTAR_API_URL` néma visszamenőleges kompatibilitási alternatívaként megmarad a CLI és az MCP-szerver konfigurációfeloldásában.
- **Agent SDK** (`#10`) — MCP-szerver (`haszno-labs/haszno-mcp`), CLI (`haszno-labs/haszno-cli`) és skill (`haszno-labs/haszno-skill`) első közzététele.
- **Wave 2 features** (`#8`) — rendeléstovábbítás, csoportos vásárlás, partnerpont-számítás, hálózati betekintések, bekötések, teljesítés, számlázás, indítóprogram, bevezetési folyamat és backend biztonsági megerősítés hozzáadva.