Hírek

A KözKód Dokumentumkezelés közösségében konkrét igény fogalmazódott meg: szükség van egy rendszerre, amely sablonok alapján állít elő dokumentumokat. Fontos a pontosítás — nem öncélúan dokumentum-sablonokat kezelünk, hanem kész dokumentumokat generálunk előre elkészített, karbantartott sablonokból.

Ez a cikk a felvezetés: a célt és az alapokat rögzíti. A részletes koncepciót a következő lépésben dolgozzuk ki közösen.

Mit csinál a rendszer

• Sablonok kezelése — sablonokat lehet feltölteni, létrehozni és verziózni.
• Dokumentumgenerálás — a sablonokból, adatokkal kitöltve, kész dokumentumok készülnek.
• Életciklus — megtekintés, szerkesztés, generálás, archiválás.

Felépítés: backend és webes felület

A rendszernek két fő része van:

• egy backend, amely a sablonokat tárolja, verziózza és a generálást végzi,
• egy webes felület (frontend), ahol a felhasználók a sablonokkal dolgoznak.

A sablonok feltöltése, létrehozása és verziózása jogosultsághoz kötött, ezért a felület elé egy belépési (SSO) réteget építünk. Az első körben ez egy egyszerűbb megoldás lesz. Magát az SSO-réteget egy külön közösségben dolgozzuk ki és finomítjuk, azzal a céllal, hogy újrafelhasználható legyen, és integrálható az intézményi rendszerekkel.

Projektek, szerepek és jogosultságok

A rendszer projektekre tagolódik:

• minden projektnek vannak felelősei (projektgazdák) és karbantartói,
• egy felhasználó több projektet is láthat,
• a hozzáférés projektenként, differenciált jogosultságokkal szabályozott.

A sablonokat projektenként, verziózva kezeljük. A jogosultságoktól függően egy felhasználó például megtekintheti, szerkesztheti, generálhatja vagy archiválhatja a sablonokat. A jogosultsági szintek pontos készletét a koncepció kidolgozásakor, közösen véglegesítjük.

Gépi hozzáférés: nemcsak felületről

A dokumentumgenerálás nem csak a webes felületről érhető el — a rendszer ezt a szolgáltatást más rendszerek felé is biztosítja, többféle csatornán:

• SOAP (WSDL) alapon,
• REST API alapon,
• akár fájlcsere-mechanizmuson keresztül is.

Ebben az esetben a rendszer nem egy felhasználó nevében lép be. Helyette a hívó rendszer egy tanúsítvánnyal azonosítja magát, amelyet időről időre megújít vagy újragenerál.

A tanúsítványok kezelése a projektgazda hatáskörébe tartozik. Egy tanúsítvány egy adott projekthez ad hozzáférést — ha egy külső rendszernek több projektre van szüksége, ahhoz projektenként külön tanúsítvány szükséges. A projektgazda kulcsot/tanúsítványt generál, ezt átadja a külső rendszernek, amely ezzel azonosítja magát a megfelelő végpontokon, és 30 naponta megújítja.

A következő lépés

Ez a felvezetés a célt és az alapokat rögzíti. A részletes koncepción — a jogosultsági szinteken, a sablon-életcikluson, a verziózáson és a gépi hozzáférés szabályain — közösen dolgozunk tovább. Aki szívesen bekapcsolódna, ötletelne vagy kérdezne, várjuk a Dokumentumkezelés közösség felületein és a hozzá tartozó Discord-csatornán.

Örömmel jelentjük: elindult a KözKód, a magyar közszféra nyílt forráskódú platformja. A célunk, hogy a közpénzből fejlesztett szoftverek átláthatóan, megoszthatóan és újrahasználhatóan készüljenek — a párhuzamos, intézményenként újrafejlesztett megoldások helyett közös, nyílt komponensekkel.

Mit szeretnénk elérni

• Átlátható, nyílt fejlesztés a közszférában.
• Újrahasználható megoldások — amit egy intézmény megépít, abból más is építkezhet.
• Egy közösség, ahol fejlesztők, intézmények és állami szereplők együtt dolgoznak.

A következő lépések

1. Tagok gyűjtése — minél többen csatlakoznak, annál erősebb a közösség.
2. Kapcsolatfelvétel intézményi partnerekkel — önkormányzatok, hivatalok, egészségügyi és oktatási szereplők.
3. Projektek meghatározása — közösen kiválasztjuk, mely megoldások a legfontosabbak.
4. Közös munka — együtt fejlesztjük, megosztjuk és újrahasznosítjuk a kész szoftvereket.

Ajánlj ötletet

Bárki javasolhat olyan ötletet, amit szívesen látna, és amiről úgy gondolja, hogy egy intézményi, egészségügyi, oktatási vagy bármilyen más állami szereplő hasznát venné. Néhány példa:

• okosváros-megoldás,
• időpontfoglaló alkalmazás,
• önkormányzati weboldal-sablon,
• gazdálkodást segítő rendszer,
• …vagy bármi más, ami a közszférát szolgálja.

Természetesen a már meglévő közösségekhez is csatlakozhatsz, és bekapcsolódhatsz a folyamatban lévő munkába.

Köszönjük

Köszönjük, hogy csatlakoztál a KözKódhoz. Kérünk egy kis türelmet — hamarosan jelentkezünk a következő lépésekkel.

Ha kérdésed van, keress minket az info@kozkod.hu címen. Addig is használjátok aktívan a közösségekhez tartozó Discord-csatornákat — ott azonnal egyeztethettek, ötletelhettek és kérdezhettek.

A KözKód Manifesto összefoglalja azokat az értékeket, elveket és magatartási normákat, amelyekhez a KözKód minden hozzájárulója önkéntesen csatlakozik — a közérdek elsődlegességét, a szakmai kiválóságot, a biztonságot, az átláthatóságot és az együttműködés kultúráját.

1 Küldetésünk

A KözKód hisz abban, hogy a közpénzből létrejövő digitális megoldások minősége közös
ügy. A szakmai közösség bevonása nem helyettesíti az intézményi felelősséget, hanem
erősíti azt. Célunk olyan digitális közvagyon létrehozása, amely hosszú távon
fenntartható, átlátható és auditálható.

2 A közérdek elsődlegessége

Minden hozzájárulás során a közérdeket helyezzük előtérbe. Nem egyéni vagy szervezeti
érdekeket, hanem az állampolgárok számára hasznos, biztonságos és fenntartható
megoldásokat támogatunk.

3 Szakmai kiválóság

A hozzájárulók törekednek a magas szakmai színvonalra, a dokumentált megoldásokra,
a tesztelhetőségre, a karbantarthatóságra és a hosszú távú üzemeltethetőségre. A
technikai adósság tudatos csökkentése közös felelősség.

4 Biztonság és adatvédelem

A biztonság nem opcionális szempont. Tilos szándékosan sérülékeny, rosszindulatú vagy
nem megfelelően ellenőrzött kódot beküldeni. A hozzájárulók kötelesek felelősen kezelni
minden tudomásukra jutott biztonsági problémát és adatvédelmi kockázatot.

5 Átláthatóság és elszámoltathatóság

Minden változtatásnak visszakövethetőnek kell lennie. A döntések, review-k, kommentek
és fejlesztések dokumentált formában történnek. A hozzájáruló vállalja szakmai
döntéseinek indokolhatóságát.

6 Együttműködés kultúrája

A közösség alapja a kölcsönös tisztelet. A szakmai viták természetesek, a
személyeskedés, zaklatás, megalázás vagy diszkrimináció azonban elfogadhatatlan. A
kritikának mindig a munkára kell vonatkoznia, nem az emberre.

7 Tudásmegosztás

A KözKód célja nem csupán szoftverek létrehozása, hanem a szakmai tudás gyarapítása
is. A dokumentáció, a mentorálás és a tapasztalatok átadása ugyanolyan értékes
hozzájárulás, mint maga a forráskód.

8 Technológiai függetlenség

A közösség támogatja azokat a megoldásokat, amelyek csökkentik az indokolatlan
szállítói függőséget, elősegítik az interoperabilitást és biztosítják az állami rendszerek
hosszú távú fenntarthatóságát.

9 Felelős nyílt forráskód

A nyitottság nem jelent korlátlan hozzáférést. A közösség elfogadja, hogy egyes
rendszerek vagy komponensek biztonsági okokból nem nyithatók meg. A nyitottság és a
biztonság közötti egyensúly megőrzése alapelv.

10 Politikai és üzleti semlegesség

A KözKód szakmai platform. A hozzájárulások értékelése nem politikai, világnézeti vagy
üzleti szempontok alapján történik, hanem kizárólag szakmai minőség alapján.

11 Integritás

A hozzájáruló nem használhatja a platformot személyes előnyszerzésre, versenytársak
károsítására vagy a közösség megtévesztésére. A szerzői jogokat, licenceket és
harmadik felek jogait tiszteletben kell tartani.

12 A közösség védelme

A platform üzemeltetői és karbantartói jogosultak fellépni minden olyan magatartással
szemben, amely veszélyezteti a közösség működését, a projektek biztonságát vagy a
résztvevők méltóságát.

A KözKód Manifesto letöltése (PDF)