Történeti adatbázis

A Történeti adatbázis egy böngészőben futó eszköz, amellyel különféle történeti forrásokból strukturált adatbázist lehet felépíteni, az adatokat harmonizálni (egységesíteni), és vizuálisan elemezni (hálózat, statisztikák, idősor, térkép).

Az első indításkor a Sémaválasztó jelenik meg a főoldalon. Kattints a kívánt sémakártyára. Ez határozza meg, milyen mezők lesznek elérhetők az adatbevitelnél. Bármikor megváltoztatható a ⚙ Beállításokban — a már bevitt adatokat nem törli.

Az ✏ Adatbevitel → Egyéni bevitel lapon adhatsz hozzá rekordokat.

A séma által meghatározott mezők (a csillaggal jelölt mező kötelező). Szerkesztéshez: a Rekordok főoldalon kattints a kártyára → ✏ Szerkesztés.

• Típus — pl. Foglalkozás, Vallás, Lakóhely (Beállításokban bővíthető)
• Nyers érték — pontosan ahogy a forrásban szerepel, pl. „ÜGYVÉD dr."
• Harmonizált érték — egységesített forma, pl. „Ügyvéd"
• Időpont — ha az adat időhöz kötött, pl. „1885–1910"

✏ Adatbevitel → CSV-import — ha már van táblázatban tárolt adatod.

• Mentsd el az adatokat .csv formátumban, az első sornak fejlécnek kell lennie.
• Karakter kódolás: UTF-8 vagy UTF-8 BOM (Excelből: Fájl → Mentés másként → CSV UTF-8 BOM-tal).
• Minden oszlophoz megadhatod, melyik mezőnek feleljen meg: séma-mező, attribútum (nyers / harmonizált), vagy → Új attribútum típusként… (menet közben is létrehozhatsz új típust).
• Az eszköz automatikusan próbálja felismerni az oszlopokat nevük alapján.
• A Duplikátum-szűrés a név + születési év kombinációt vagy egy külső azonosítót (FactGrid / Wikidata / VIAF) nézi — két azonos nevű, különböző születési évű (vagy különböző Q-id-jű) személy önálló rekordot kap.

A ⚖ Harmonizálás fülön az eltérő forrásszövegeket egységesíted egy közös formára.

Példa: „ÜGYVÉD", „ügyvéd dr.", „jogi praxis" → mind „Ügyvéd" harmonizált érték.

• Válaszd ki az attribútum típust (pl. Foglalkozás).
• A táblázatban látod az összes egyedi nyers értéket és előfordulási számukat.
• Több sor kijelölhető egyszerre → Alkalmazás kijelöltekre gomb.
• Az Önkitöltés gomb az üres harmonizált mezőkbe másolja a nyers értéket (gyors előkészítéshez).

A 🔗 Kapcsolatok fülön rögzítheted a rekordok közötti viszonyokat.

• Válaszd ki az 1. rekordot, a kapcsolat típusát és a 2. rekordot.
• Az → Új kapcsolattípusként… opcióval menet közben is felvehetsz új típust.
• Opcionálisan adj meg forrást (pl. melyik dokumentumból tudod a kapcsolatot).
• A lista szűrhető a felső szövegmezővel.

Erő-gráf: csomópontok = rekordok, élek = kapcsolatok. A csomópontok húzhatók, a grafikon görgetéssel nagyítható, kattintásra megnyílik a rekord profilja. A Csomópont-szín legördülővel szín szerint ábrázolhatsz egy mezőt vagy attribútumot.

Sávdiagramok a séma lista-típusú mezőinek megoszlásáról, az attribútumok értékgyakoriságáról és a dátummező évtizedes eloszlásáról.

Vízszintes sávdiagram az 1. és 2. dátummező alapján (pl. születési–halálozási év). A sávok kattinthatók. Ha csak 1 dátummező van, egypontos jelölőként jelenik meg.

Interaktív Leaflet-térkép. Elfogadott formátumok: városnév (pl. Budapest, Kolozsvár, kb. 80 beépített hely) vagy koordináta (47.49, 19.04). Az ismeretlen helyneveket a térkép alatt listázza.

• 📗 Excel (XLSX) — ajánlott elsődleges formátum. Többlapos fájl: _meta (konfiguráció), a séma szerinti lap (pl. szemelyek), attributumok, kapcsolatok. Megnyitható Excelben vagy LibreOffice Calcban, a cellák közvetlenül szerkeszthetők, majd visszatölthető.
• 🌐 HTML — teljes, böngészőben megnyitható riport a rekordok listájával és a főbb statisztikákkal. Publikáláshoz, megosztáshoz jó.
• 📄 JSON — nyers mentés (a régi alapértelmezett formátum). Emberi szemmel is olvasható, de a kézi szerkesztéshez az Excel kényelmesebb.
• 📊 CSV — csak a rekordok (attribútumok és kapcsolatok nélkül). Gyors egyszerű táblázatexport.

Az ↑ Betöltés gombbal JSON, strukturált Excel, egyszerű CSV/TSV vagy Excel-táblázat is megnyitható. A program a tartalom alapján automatikusan felismeri, melyikről van szó.

Ha az Excel-fájl a Mentés funkcióból származik (tartalmazza a _meta lapot), egy párbeszéd kérdezi, hogyan integráld az aktuális adatbázisba:

• Teljes csere — az aktuális adatbázis kicserélődik az Excelben lévőre. Backup-visszaállításhoz vagy üresből induláshoz.
• Frissítés-bővítés — az ID alapján összeveti a rekordokat. Az Excelben módosított, nem üres cellák felülírják a meglévőt; új sorok hozzáadódnak. Akkor hasznos, ha tömegesen szerkesztettél Excelben (pl. egységes szakmanevek bevitele), és a változásokat visszaimportálod. Az ID oszlopot NE töröld és NE írd át.
• Hozzáfűzés (merge) — kollaboráció: ha egy munkatársad ugyanazon sémán dolgozott egy másik adatbázisban, a bejövő rekordoknak új ID-prefix generálódik, így a két adatbázis biztonságosan összefésülhető duplikátum-ütközés nélkül.

• Nyisd meg a letöltött .xlsx fájlt Excelben vagy LibreOffice Calcban.
• Módosítsd a cellákat a rekordok, attribútumok és kapcsolatok lapokon. Új sort is szabadon beszúrhatsz (az ID üresen maradhat — generálódik).
• Mentsd el ugyanabban a formátumban (xlsx).
• Töltsd vissza az ↑ Betöltés gombbal, válaszd a Frissítés-bővítés módot a változások átvezetéséhez.

Több kutató párhuzamosan dolgozhat ugyanazon a sémán: mindenki saját másolatot kap, Excelbe mentve elküldi egymásnak, majd a Hozzáfűzés módban egy valaki összefésüli az Excel-fájlokat. A prefixelt ID-k miatt nincs ütközés, és a kapcsolatok is helyesen átkerülnek.

Az adatbázist olvasható módra zárolhatod, vagy végleg publikálhatod – ez utóbbi visszavonhatatlan.

A fejlécen a 🔒 Zárolás gombra kattintva az adatbázis szerkesztési módja letiltódik:

• A rekordok, attribútumok és kapcsolatok nézhetők, kereshetők, de nem módosíthatók.
• A szerkesztési fülek (Adatbevitel, Harmonizálás, Kapcsolatok) nem érhetők el.
• A 🔓 Szerkesztés gombbal bármikor feloldható (Beállítások gombbal is).
• Az adatbázis továbbra is szerkesztésmódban tárolódik.

A 📢 Publikálás gomb megnyitja a publikálási párbeszédot:

• Megadhatod a készítő nevét és intézményi affiliációját (pl. ELTE BTK).
• A publikálás véglegesen lezárja az adatbázist – később nem szerkeszthető, nem oldhető fel.
• A főoldalon megjelenik az „Publikált adatbázis" banner a készítő adataival és a publikálás dátumával.
• Ha szerkeszteni szeretnél, az Excel- vagy JSON-exporttal hozz létre egy új másolatot (importálás útján).

Ha az adataid Microsoft Access (.mdb / .accdb) formátumban vannak, az access_to_csv.py Python szkripttel exportálhatod CSV-be.

Nyisd meg a táblát Accessben → Külső adatok → Exportálás → Szöveges fájl → CSV UTF-8.

A fejléc ⚙ Beállítások gombjára kattintva érhető el.

• Sablon — gyorsan válthatsz a beépített sémák között (a már bevitt adatokat nem törli).
• Projekt neve — a fejlécben megjelenő cím.
• Rekord típus és mezők — mezők átnevezése, törlése, új mező hozzáadása (szöveg / szám / lista / hosszú szöveg típusban). A speciális mezőknél jelölhető meg a cím-mező, az 1–2. dátummező (idősorhoz) és a helyszín mező (térképhez).
• Attribútum típusok — szabadon bővíthető lista (pl. Foglalkozás, Vallás, Lakóhely).
• Kapcsolat típusok — a rekordok közötti kapcsolatok elnevezései.

A böngésző cache törlése törli az adatokat. Mindig exportálj Excel- (vagy JSON-) fájlba a ↓ Mentés gombbal, különösen hosszabb munka után.

Nézd meg a térkép alatti „Nem azonosított helyek" listát. Próbálj koordinátát beírni (pl. 47.49, 19.04). A geocoder kb. 80 Kárpát-medencei és európai helyet ismer.

A Harmonizálás fülön jelöld be a sorokat → írd be az egységesített értéket → Alkalmazás kijelöltekre.

A „Csomópont-szín alapja" legördülőben válassz egy mezőt vagy attribútum-típust — de csak akkor működik, ha a rekordoknál van ilyen adat.

Kattints a rekord kártyájára → ✏ Szerkesztés → Törlés. A törlés visszavonhatatlan.

Bármely modern böngészőben (Chrome, Firefox, Edge, Safari). Az adatok böngészőnként külön tárolódnak — váltásnál Excel- vagy JSON-exportot használj.

Igen — pl. Lakóhely: „Pest" (1840) és Lakóhely: „Bécs" (1848) egymás mellett élnek, különböző időponttal.

500–2000 rekord gond nélkül. 5000 felett a hálózatvizualizáció lassulhat; a térkép és a statisztikák jól skálázódnak. A localStorage határ kb. 5 MB.