Differences

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

--- tanszek:oktatas:informacios_rendszerek_integralasa:szemantikus_verziokezeles [2026/03/19 19:59] – created knehez
+++ tanszek:oktatas:informacios_rendszerek_integralasa:szemantikus_verziokezeles [2026/03/19 20:04] (current) – [Verziók összehasonlítása] knehez
@@ Line 30: / Line 30: @@
 Példa:
-.2.3 → stabil API
+.2.3 -> stabil API
-.2.4 → ugyanaz az API, csak hibajavítás
+.2.4 -> ugyanaz az API, csak hibajavítás
-.3.0 → új funkciók, de régi kód továbbra is működik
+.3.0 -> új funkciók, de régi kód továbbra is működik
-.0.0 → figyelem! régi kód eltörhet
+.0.0 -> fő verzió váltás -> régi kód eltörhet
 ===== Verziónövelés döntési folyamata =====
@@ Line 58: / Line 58: @@
 Példák:
-függvény paraméterlistájának megváltoztatása
+  * függvény paraméterlistájának megváltoztatása
+  * API endpoint törlése
-API endpoint törlése
+  * adatstruktúra módosítása
-adatstruktúra módosítása
 Ez a legkritikusabb változás, mert:
-a kliensek frissítés nélkül hibásan működhetnek
+  * a kliensek frissítés nélkül hibásan működhetnek
+  * integrációs hibák jelenhetnek meg
-integrációs hibák jelenhetnek meg
 ==== MINOR verzió ====
@@ Line 75: / 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 92: / 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 104: / 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 128: / 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 141: / 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 =====