Differences

This shows you the differences between two versions of the page.

--- tanszek:oktatas:informacios_rendszerek_integralasa:szemantikus_verziokezeles [2026/03/19 20:00] – [MAJOR verzió] knehez
+++ tanszek:oktatas:informacios_rendszerek_integralasa:szemantikus_verziokezeles [2026/03/19 20:04] (current) – [Verziók összehasonlítása] knehez
@@ Line 72: / Line 72: @@
 Példák:
-új API endpoint hozzáadása
+  * új API endpoint hozzáadása
+  * opcionális paraméter bevezetése
-opcionális paraméter bevezetése
+  * új szolgáltatás modul
-új szolgáltatás modul
 Fontos:
-a régi kliensek továbbra is működnek
+  * a régi kliensek továbbra is működnek
+  * a PATCH érték ilyenkor nullázódik
-a PATCH érték ilyenkor nullázódik
 ==== PATCH verzió ====
@@ Line 89: / Line 86: @@
 Példák:
-bug fix
+  * bug fix
+  * teljesítmény javítás
-teljesítmény javítás
+  * dokumentáció pontosítása (ha nem érinti az API-t)
-dokumentáció pontosítása (ha nem érinti az API-t)
 Ez a legbiztonságosabb frissítés típus.
@@ Line 101: / Line 96: @@
 ==== 0.x.x – fejlesztési fázis ====
-nincs stabil API
+  * nincs stabil API
+  * bármilyen változás történhet
-bármilyen változás történhet
+  * nem ajánlott éles rendszerben használni
-nem ajánlott éles rendszerben használni
 ==== 1.0.0 – stabil kiadás ====
 Ez az a pont, ahol:
+  * az API stabilnak tekinthető
-az API stabilnak tekinthető
+  * a SemVer szabályokat kötelező betartani
-a SemVer szabályokat kötelező betartani
 ===== Előkiadások és metaadatok =====
@@ Line 125: / Line 116: @@
 Jelentés:
-még nem stabil verzió
+  * még nem stabil verzió
+  * tesztelésre szolgál
-tesztelésre szolgál
+  * alacsonyabb prioritású, mint a végleges verzió
-alacsonyabb prioritású, mint a végleges verzió
 ==== Build metaadat ====
@@ Line 138: / Line 127: @@
 Jellemzők:
-csak információ (pl. build szám)
+  * csak információ (pl. build szám)
+  * nem befolyásolja a verziók sorrendjét
-nem befolyásolja a verziók sorrendjét
 ===== Verziók összehasonlítása =====
 A verziók sorrendje a következő logika szerint történik:
-MAJOR → MINOR → PATCH
+  - MAJOR → MINOR → PATCH
+  - majd pre-release
-majd pre-release
 Fontos:
+  * a build metaadat nem számít
-a build metaadat nem számít
+  * az előkiadás mindig "gyengébb", mint a normál verzió
-az előkiadás mindig "gyengébb", mint a normál verzió
 ===== Fontos szabályok =====
-Egy kiadott verzió nem módosítható
+  * Egy kiadott verzió nem módosítható
+  * Minden változtatás új verziót igényel
-Minden változtatás új verziót igényel
+  * Kötelező a publikus API definiálása
+  * A verziószámok növekedése monoton
-Kötelező a publikus API definiálása
-A verziószámok növekedése monoton
 ===== Gyakorlati jelentőség az integrációban =====
 A szemantikus verziókezelés különösen fontos az alábbi esetekben:
-mikroszolgáltatások közötti kommunikáció
+  * mikroszolgáltatások közötti kommunikáció
+  * REST / GraphQL API-k használata
-REST / GraphQL API-k használata
+  * külső könyvtárak integrációja
+  * CI/CD pipeline-ok
-külső könyvtárak integrációja
-CI/CD pipeline-ok
 Előnyök:
-automatikus dependency frissítés biztonságosan
+  * automatikus dependency frissítés biztonságosan
+  * kompatibilitási hibák csökkentése
-kompatibilitási hibák csökkentése
+  * jobb verziókövethetőség
-jobb verziókövethetőség
 ===== Példa verziók alakulására =====