INGA Ist Nicht Genehmigungspflichtige Anschaffung.
Eine freie, schlichte Bibliotheksverwaltung für Schulen: Katalog, Ausleihe, Rückgabe, Nutzerverwaltung und Mahnwesen – als Desktop-App für Linux (KDE Plasma, GNOME), macOS und Windows 11, jeweils mit nativer Optik statt einer Web-Oberfläche in fremdem Gewand.
Bibliothekssoftware für Schulen ist meist teuer, browserbasiert oder beides. INGA ist der Gegenentwurf: eine kleine, freie Desktop-App, die genau das kann, was eine Schulbibliothek im Alltag braucht – nicht mehr, aber auch nicht weniger.
INGA gliedert sich fachlich in drei Bereiche, die sich auch in der Seitenleiste wiederfinden. Jeder hat seinen eigenen kleinen Namen:
Das Kernmodul: Katalog und Exemplare (Inventar), Schüler:innen und Lehrkräfte (Nutzer), Mahn- und Verlustgebühren (Gebühren) sowie Ausleihe/Rückgabe/Verlängerung (Ausleihe). Das Dashboard fasst alle vier Bereiche zusammen: Kennzahlen auf einen Blick, Schnellsprung zu Ausleihen und Rückgabe, die zuletzt vergessenen Rückgaben und die zehn meistausgeliehenen Bücher der Bibliothek.
Der Weg eines neuen Buchs vom Karton ins Regal: Titel im Katalog erfassen, Exemplare mit Barcode-Etikett labeln, Medienart/Systematik/Cover einstellen. Die Buchdetailseite ist genau dafür gebaut – Cover per ISBN laden oder hochladen, Exemplare anlegen, Klassifikation pflegen, alles auf einer Seite.
Das Mahnwesen: die laufend aktualisierte Liste überfälliger Ausleihen („Journal“), mehrstufige Mahnungen nach Tagen überfällig, individuell formulierbare Brieftexte mit Platzhaltern, und die Möglichkeit, Fristen kurzfristig zu verschieben (Nachfristen) – etwa für eine Ferienschließzeit.
- Kennzahlen: Titel, Exemplare, Nutzer, offene Ausleihen, überfällige Ausleihen
- Schnellsprung-Buttons zu Ausleihen, Rückgabe, neuem Titel und Mahnungen
- Vergessene Rückgaben – die dringendsten überfälligen Kinder zuerst, ein Klick öffnet direkt die Nutzerakte
- Meistausgeliehene Bücher – Top 10 über den gesamten Ausleihverlauf, mit Cover-Vorschau
- Statuszeile am unteren Rand: Programmversion, Zeitpunkt der letzten Sicherung, Hinweis bei verfügbarem Update
- Klick auf einen Titel klappt das Detail direkt unter der Zeile auf (Titel/Autor/Status je Exemplar zuerst, Katalogdaten darunter) und scrollt sich von selbst ins Bild – kein Flyout über der Liste, kein Verlust der Scrollposition, per Pfeiltasten/Escape bedienbar
- Titel anlegen, durchsuchen, filtern nach Medienart, Kategorie, Klassenstufe, Standort und Status (verfügbar / ausgeliehen / überfällig / nicht verfügbar) – echte Seitennavigation (25/50/100/250/Alle) statt einer festen Höchstzahl, aktive Filter als entfernbare Chips, Export der gefilterten Liste als CSV/Excel
- Freitextsuche deckt Titel, Autor, Verlag, ISBN/EAN, Schlagwort UND die Signatur/den Barcode einzelner Exemplare ab
- Exemplare mit Barcode/Etikett verwalten, Ausleihstatus pro Exemplar – Etiketten dafür direkt ausdrucken, siehe „Etiketten“ unten
- Buchcover: automatischer Download per ISBN/EAN, probiert dafür mehrere freie Quellen nacheinander – zuerst Open Library und Google Books (beide ohne Konto, extra für Bücher vorgesehen, über die ISBN), als Rückfallebene danach die Bildersuche von DuckDuckGo und Qwant per Titel/Autor (für Titel, die keine der beiden Buch-APIs kennt – kein offiziell dokumentiertes Interface, kann gelegentlich nichts liefern, kostet dann aber nur einen übersprungenen Versuch) – alternativ manueller Upload. Einzeln pro Titel, als Sammel-Download für den ganzen Bestand (mit Fortschrittsanzeige, unter „Import / Export“ – dort wird nach jedem Bestandsimport aktiv nachgefragt), oder automatisch beim Anlegen eines neuen Titels mit ISBN/EAN. Ohne Treffer bei keiner Quelle zeigt INGA ein generisches Platzhalterbild statt einer Lücke.
- Ausleihstatistik je Titel („insgesamt N× ausgeliehen“)
- Antolin-Klassenstufe je Titel (freies Feld) für Titel mit Antolin-Lesequiz
- Buchdaten per ISBN nachschlagen: Titel/Untertitel/Autor/Verlag/Jahr über Open Library, bei keinem Treffer zusätzlich Google Books laden. Beim Katalogisieren eines neuen Titels automatisch, sobald im ISBN-Feld eine vollständige, gültige ISBN steht (getippt oder per Scanner) – füllt dabei nur noch LEERE Felder, eine bereits eingetippte Angabe wird nie überschrieben. Für bestehende Titel oder ein erneutes Nachschlagen weiterhin auch per Knopf „Buchdaten übernehmen“ auslösbar. Füllt in jedem Fall nur das gerade offene Formular, gespeichert wird erst durch bewusstes Bestätigen (Klick auf „Speichern“)
Barcode-Etiketten für Exemplare, mit echten, physisch passenden Bogenformaten – eigener Bereich in der Seitenleiste, dazu Schnellzugriff direkt auf der Buchdetailseite (einzelnes Exemplar oder „Alle Etiketten drucken“ für den ganzen Titel).
- 4 Etikettenformate: Zweckform 3475 (70 × 36 mm, 24/Bogen), Zweckform/ Avery L7160 (63,5 × 38,1 mm, 21/Bogen), Zweckform 3651 (52,5 × 29,7 mm, 40/Bogen, kompakt) sowie Zweckform/Avery L4732REV (35,6 × 16,9 mm, 80/Bogen) – Rand und Rasterabstand aus den offiziellen Produktmaßen, nicht nur der reinen Etikettengröße, damit der Ausdruck auf einem echten Bogen sitzt
- Startposition: für angebrochene Bögen – überspringt die angegebene Anzahl bereits verbrauchter Etiketten, nur auf dem ersten Bogen
- Jedes Etikett zeigt Titel, Autor, einen Strichcode (Code 128) der Signatur/des Barcodes sowie eine kleine „Antolin“-Kennzeichnung, wenn für den Titel eine Antolin-Klassenstufe hinterlegt ist (ein eigenes, schlichtes Kennzeichen – nicht das Marken-Logo von Antolin, siehe Hinweis unten). Ausnahme das kleine L4732REV: zu wenig Platz für Titel/ Autor, zeigt nur die Etikettnummer über dem Strichcode – wie auf den bereits im Einsatz befindlichen Etiketten dieses Formats
- Auswahl mehrerer Titel gleichzeitig (Freitextsuche, „Alle Treffer auswählen“) – gedruckt wird je ausgewähltem Titel ein Etikett für jedes seiner Exemplare
- Vorschau am Bildschirm, danach Druck oder PDF-Export wie beim Mahnwesen
Da die Entwicklungsumgebung ohne Bildschirm auskommt (siehe
docs/screenshots/README.md), war ein
Testdruck hier nicht möglich – Rand-/Rastermaße sind aus offiziellen
Produktangaben und der quelloffenen glabels-Etikettendatenbank
abgeleitet und automatisiert geprüft (test/etiketten.test.mjs), aber
vor dem ersten Bogen aus dem echten Etikettenpapier lohnt sich ein
Probedruck auf normalem Papier gegen das Licht.
- Schüler:innen und Lehrkräfte, Gruppen, Zweige, Sperrungen, Ausleihberechtigung mit Ablaufdatum, freies Notizen-Feld je Nutzer:in (z. B. Sondervereinbarungen)
- Ausleihsperre je Nutzer:in direkt in der Nutzerakte: unbefristet ("Sperren", bleibt bis zum bewussten "Entsperren") oder befristet ("Für X Tage sperren", läuft danach von selbst wieder ab – Vorgabe 14 Tage, änderbar unter Einstellungen)
- Filter nach Klasse, Gruppe, Zweig, Status (aktiv / gesperrt / mit Rückstand) und Anzahl aktiver Ausleihen – echte Seitennavigation, Filter als Chips, Export als CSV/Excel
- Nutzer mit überfälligen Ausleihen sind in der Liste rot markiert
- Schuljahresende: ab einen Monat vor Beginn der eingetragenen Sommerferien erscheint auf der Übersicht ein Hinweis für die Abschlussklasse (Einstellung "Abschlussklasse", Vorgabe "4") mit Knöpfen zum Sperren bzw. – nach Sicherheitsabfrage – Verschieben in den Papierkorb
- Automatische Klassenerkennung (Einstellungen → Verschiedenes, Vorgabe: an): mehrere kommagetrennt ins Klasse/Jahrgang-Feld eingetragene Klassen (z. B. "4a,4b,4c") erscheinen in Nutzerliste, Rückstandsliste, Im-Umlauf und Papierkorb als getrennte Kürzel-Chips statt eines Komma-Klumpens – rein optisch, der gespeicherte Text bleibt unverändert
- Ausleihe per Barcode-Scanner oder Tastatur, oder per Namenssuche: die Felder "Kind"/"Buch" akzeptieren Nummer oder Klartext, mit unscharfer, tastaturbedienbarer Vorschlagsliste ab dem zweiten Zeichen ("Meier" findet auch "Meyer"/"Maier") – bereits ausgeliehene Exemplare bleiben markiert sichtbar statt ausgeblendet zu werden
- Leihfrist je Medienart, konfigurierbare Verlängerung – verlängert sich außerdem automatisch um die Länge jedes Ferien-/Schließzeit-Abschnitts, der die Ausleihspanne berührt (Kalender- oder Schultage wählbar)
- Ausleihlimit: maximale Anzahl gleichzeitig offener Ausleihen pro Person, einstellbar unter Einstellungen → Ausleihe (Vorgabe: 0 = unbegrenzt)
- Rückgabe-Liste mit einem Suchfeld für Name, Titel UND Buchnummer/ Signatur (Barcode scannen oder eintippen genügt – bei genau einem Treffer gibt Enter das Buch direkt zurück, ohne extra klicken zu müssen), dazu Filtern (nur überfällige, Überfälligkeit ab X Tagen, verlängert ja/nein, Klasse, Ausleihdatum-Zeitraum), Status-Badge pro Zeile und Export als CSV/Excel
- Vormerkungen: ein Titel lässt sich auf der Buchdetailseite für eine Person vormerken (mehrere Personen möglich, Reihenfolge nach Anmeldung). Leiht die vormerkende Person den Titel selbst aus, gilt die Vormerkung automatisch als erfüllt; leiht jemand anderes aus, erscheint ein Hinweis. Einstellung „Verlängerung gesperrt, wenn Buch vorgemerkt ist“ verhindert eine Verlängerung, solange eine andere Person wartet
- Schnelle Verlängerung per Buchnummer: eigenes Eingabefeld direkt in der Rückgabe-Ansicht ("Buchnummer zur schnellen Verlängerung") sowie ein Schnellzugriff-Knopf auf der Startseite – Nummer eintippen oder scannen, Enter oder Klick auf „Verlängern“, fertig, ohne erst die Zeile in der Liste suchen zu müssen. Es gelten dieselben Regeln wie beim normalen „Verlängern“-Knopf (max. Verlängerungen, ggf. gesperrt bei Vormerkung)
„Was ist gerade unterwegs?“ – alle offenen Ausleihen auf einen Blick: Ausleihe-Nummer, Buchtitel, Autor, Signatur/Barcode, Medienart, Kind, Klasse, Telefon privat/geschäftlich, Ausleih-/Rückgabedatum, Tage überfällig und Anzahl Verlängerungen. Filterbar per Freitext, gruppierbar nach Klasse oder nach Kind (praktisch, um die Liste klassenweise auszudrucken), Export als CSV (Excel-freundlich: Semikolon, UTF-8-BOM) und als XLSX (Kopfzeile fett, Autofilter, passende Spaltenbreiten) sowie Direktdruck/PDF im Querformat mit Briefkopf (Logo aus den Mahnungs- Einstellungen, Schulname, Datum/Uhrzeit, aktiver Filter) und Fußzeile (Seitenzahl) – Kind und Buch jeweils zweizeilig (Name/Klasse bzw. Titel/ Autor) für einen kompakten, aber vollständigen Ausdruck. Schnellzugriff über die Startseite und die Mahnliste.
- Genau zwei Stufen: Erinnerung (freundlich, ans Kind gerichtet, keine
Gebühr) und Mahnung (sachlich, an die Eltern gerichtet, mit Hinweis
auf Ersatz bei Verlust) – Vorgabe: unter 7 Tagen überfällig eine
Erinnerung, ab 7 Tagen eine Mahnung, beide Schwellen änderbar. Je Stufe
ein eigener Reiter mit einem WYSIWYG-Brieftext-Editor (fett/kursiv/
unterstrichen über eine kleine Werkzeugleiste, ein „Word-artiges“
contenteditable-Feld statt eines reinen Textfelds) samt Menü zum
Einfügen der Platzhalter (
{Vorname}{Nachname}{Titel}{Tage}{Gebuehr}{Datum}{Faellig}{Stufe}{Bibliothek}, live Vorschau direkt im Editor) – dazu 9 vorgefertigte Textvorlagen zur Auswahl in unterschiedlichen Tonlagen und Formen (freundlich, bestimmt/formell, humorvoll, sachlich-neutral, persönlich-warm, als Checkliste, ganz knapp, sowie zwei in einfacher Sprache für Kinder oder Nutzer:innen, denen der Standardtext schwerer verständlich ist). Die Formatierung erscheint im Druck/PDF; in E-Mail und Element (die kein Fett/Kursiv darstellen können) kommt automatisch die reine Textfassung an - Rückstandsliste zum Abarbeiten: einstellbare Schwelle ("überfällig seit mindestens X Tagen", Vorgabe 1), ein Eintrag pro überfälligem Buch, sortierbar nach Tagen/Name/Klasse/Einstufung. Je Fall zeigt und übersteuert eine Checkbox rechts, ob Erinnerung oder Mahnung erstellt wird (vorbelegt nach der Schwelle, änderbar); "Nur Erinnerungen erstellen"/"Nur Mahnungen erstellen" nehmen sich aus der Auswahl automatisch nur die passend markierten Fälle, "Erinnerung + Mahnung erstellen" erledigt eine gemischte Auswahl in einem Rutsch (ein gemeinsamer Bestätigungsdialog, intern zwei getrennte Schreiben-Sätze mit dem jeweils richtigen Text/Betreff). Vorschau vor dem Drucken, protokolliert je Fall welche Stufe wann verschickt wurde
- Eigener Briefkopf: Absender, E-Mail, Telefon, Betreff-Vorlage, Schlusstext, Logo
- Formeller Brief per PDF-Export, direktem Druckauftrag, per
E-Mail (öffnet das auf dem Rechner eingerichtete Mailprogramm mit
vorausgefülltem Betreff/Text – keine eigene Mailserver-Anbindung nötig,
eine Mail pro Empfänger:in mit hinterlegter Adresse) oder über
Element (Matrix-Messenger): die Adresse wird
automatisch aus Vorname.Nachname und einer einstellbaren Domain gebildet
(Vorgabe
soed.hamburg.de), Anmeldung per Benutzername/Passwort (nur das dabei ausgestellte Zugangstoken wird gespeichert, nie das Passwort) oder direkt per Zugangstoken für ein Bot-Konto – siehe Einstellungen → Mahnungen - Probe-Mahnung drucken: öffnet die gerade bearbeitete Stufe mit erfundenen Beispieldaten im echten Druckfenster, zum Prüfen von Layout/ Brieftext ohne echten Fall – speichert oder verschickt nichts
Ein Menüpunkt „Einstellungen“ mit fünf Unterpunkten – links eine schmale Liste, rechts der Inhalt des gewählten Punkts, keine verstreuten Dialoge:
- Ferien: Übersicht bündelt zusammenhängende Tage zu Abschnitten und gruppiert nach Schuljahr (Accordion, standardmäßig bis aufs laufende zugeklappt, vergangene ausblendbar, ganzes Schuljahr auf einmal löschbar) – manuell gepflegt, per ICS-Datei/URL importiert oder für Hamburg automatisch abgerufen, mit Vorschau vor der Übernahme ("Schuljahr 2027/28: 6 Abschnitte, davon 2 schon vorhanden", Dubletten werden übersprungen). Fällt eine Ausleihfrist ganz oder teilweise in Ferien oder eine Schließzeit, verschiebt sich die Fälligkeit automatisch um deren Länge (Kalender- oder Schultage wählbar) – der Grund erscheint als Hinweis in der Rückgabeliste ("+12 Ferientage wegen Herbstferien"). Zusätzlich abschaltbar: Ferientage als Verzugstage nicht mitzählen
- Mahnungen: die beiden Mahnstufen samt Fristen/Brieftexten (siehe oben), Briefkopf/Absender und der Versand über Element (Matrix)
- Aussehen und weitere App-Einstellungen: Oberfläche
(macOS/Windows/KDE/GNOME/automatisch, Hell/Dunkel), Schriftgröße,
Bibliotheksname (Platzhalter
{Bibliothek}in Mahntexten), Kopfleisten-Uhr ein-/ausblendbar, Standard-Leihfrist und maximale Verlängerungen, Standard-Sperrdauer und Abschlussklasse (siehe Nutzerverwaltung). Dort außerdem je Medienart an-/abwählbar, ob sie in Katalog-Auswahl und -Filter überhaupt zur Wahl steht (Vorbelegung: nur Buch und Hörbuch/Audio-CD, alles andere ausgeblendet – bereits katalogisierte Titel bleiben davon unberührt), samt ihrer abweichenden Leih-/Verlängerungsfristen. Außerdem Fristverschiebung (ein Tage-Offset, der sofort auf jede berechnete Fälligkeit wirkt – z. B.+14während einer kurzfristigen, noch nicht als Ferieneintrag erfassten Schließzeit), einmalige Verschiebung des Ausleihdatums aller offenen Ausleihen um X Tage, die Datensicherung: automatisches Backup einmal täglich beim BEENDEN des Programms (abschaltbar – "Backup jetzt" bleibt immer verfügbar) und vor jeder Migration (Rotation: die letzten 10 bleiben erhalten, zusätzlich eine Perpustakaan-kompatible Zip-Sicherung), dazu „Backup jetzt“ und „Sicherung einspielen“ direkt in den Einstellungen – Einspielen sichert vorher automatisch noch einmal den aktuellen Stand und startet INGA neu. Läuft bewusst beim Beenden statt beim Start (dauert es einmal länger, stört das dort weit weniger) – dafür erscheint kurz ein kleines Abschiedsfenster, aber nur an dem Tag, an dem tatsächlich noch etwas zu sichern ist. Wahlweise (Vorgabe: an, wirkt nur solange die automatische Sicherung insgesamt aktiv ist) zusätzlich dieselbe tägliche Sicherung noch einmal nachDokumente/INGA Backups– leichter zu finden/ mitzunehmen als der interne Programmdaten-Ordner. Dazu unter Wartung: wöchentliches automatisches Nachladen fehlender Cover im Hintergrund sowie automatische Updates (prüft 10 Sekunden nach dem Start und danach alle paar Stunden beim GitHub-Repository nach, fragt vor jedem Download nach – siehe „Automatische Updates“ unten). Alle drei einzeln abschaltbar. - Perpustakaan
⚠️ (früher „Experimentell“): deutlich gekennzeichnet, standardmäßig aus. Perpustakaan-Modus (ab 1.11.0-beta.1): Perpustakaan ist die Hauptdatenbank, jede Änderung in INGA wird sofort als Einzeländerung dorthin geschrieben, Änderungen aus Perpustakaan erscheinen in INGA beim Zurückkehren ins Fenster; ist Perpustakaan geöffnet, trägt INGA ausstehende Änderungen automatisch nach (Details:src/main/perpustakaan-modus.js). Außerdem: direkter Zugriff auf die echte, live verwendete Perpustakaan-Datenbank (Apache Derby) statt nur auf Zip-Sicherungen – „Jetzt aus Perpustakaan lesen“ und „Jetzt in Perpustakaan schreiben“, Ordnerauswahl per Dialog, Statusanzeige, mehrfache Sicherheitsabfrage vor dem Schreiben. Erkennt zuverlässig, ob Perpustakaan die Datenbank gerade selbst geöffnet hält, und verweigert den Zugriff in dem Fall. Sichert die Original-Datenbank vor jedem Programmstart mit aktiviertem Zugriff und vor jedem einzelnen Schreibversuch. Fehlt die mitgelieferte Java-Laufzeit auf einer echten Installation (z. B. weil ein Virenschutzprogramm sie entfernt hat), lädt ein Knopf „Java-Laufzeit reparieren“ sie ohne Neuinstallation nach. Gegen eine selbst gebaute Testdatenbank ausführlich geprüft (siehederby-bridge/README.md), aber noch nie gegen eine echte Perpustakaan-Installation – vor dem ersten Einsatz mit echten Daten unbedingt zuerst an einer Kopie ausprobieren, nicht am Original - Verschiedenes: Titelleiste einfärben – Standard (unverändert), automatisch nach Wochentag (Montag gelb, Dienstag grün, Mittwoch blau, Donnerstag rot, Freitag orange, Wochenende dezentes Grau/Rosé – angelehnt an das METACOM-Farbschema für Wochentage) oder eine frei gewählte eigene Farbe; unter Windows passen sich dabei auch die Fensterknöpfe farblich an. Dazu Automatische Klassenerkennung (siehe Nutzerverwaltung)
Schuljahreswechsel-Assistent, Inventur-Modus, Leseausweise, Ausleihgrenze je
Klassenstufe, Schäden bei der Rückgabe, Vormerkung-fertig-Zettel,
Rückstandsliste pro Klasse, Erinnerung vor Fälligkeit, Lesepass & Urkunde,
Antolin- und „Neu in der Bücherei“-Aushang, Empfehlungen, Anschaffungen &
Budget, Jahresbericht als PDF sowie Datenschutz (Historie automatisch löschen,
Auskunft je Kind). Details siehe CHANGELOG.md.
Gelöschte Nutzer:innen und Exemplare landen zunächst im Papierkorb statt endgültig verloren zu gehen – mit Wiederherstellen (dieselbe LeserNi/ MedienNi wie vor dem Löschen) oder Endgültig löschen. Ein Exemplar lässt sich nur wiederherstellen, solange der zugehörige Titel noch existiert. Kein automatisches Aufräumen – Einträge bleiben, bis sie bewusst entfernt werden. (Titel selbst haben keinen Papierkorb: Löschen eines Titels nimmt alle seine Exemplare unwiderruflich mit, siehe Warnhinweis beim Löschen.)
Ausleihen pro Monat (letzte 12 Monate, als Balken), pro Klasse und pro Kategorie; Ladenhüter (Titel, die seit einer einstellbaren Anzahl Tage nicht oder nie ausgeliehen wurden); Verlustliste (alle als „nicht verfügbar“ markierten Exemplare mit Grund). Ladenhüter und Verlustliste je als CSV exportierbar.
Ein Zip mit allen 65 Tabellen, Semikolon-getrennt, UTF-8. Tabellen, die INGA nicht selbst bearbeitet (Rechnungswesen, Beschaffung, SEPA-Mandate, Kursverwaltung, …), werden beim Import unverändert übernommen und beim Export wieder mit ausgeliefert – ein Bestand geht auf dem Weg durch INGA nicht kaputt. Buchcover sind rein INGA-intern und nicht Teil dieses Formats.
Import / Export → „INGA-Datenbank übertragen“: Datenbank sichern …
schreibt den kompletten INGA-Stand in eine Datei (INGA-Datenbank_<Datum>.zip:
Datenbank, Cover, Einstellungen), Datenbank einbinden … liest sie am
anderen Rechner wieder ein. Auch eine einzelne inga.sqlite3 aus dem
Datenordner eines anderen Rechners lässt sich einbinden (Windows:
%APPDATA%\INGA, macOS: ~/Library/Application Support/INGA, Linux:
~/.local/share/INGA). Vor dem Ersetzen zeigt INGA den Inhalt der Datei an
und sichert den bisherigen Stand automatisch.
Erkennt automatisch macOS (Liquid Glass), Windows 11 (Fluent/Mica) sowie unter Linux KDE Plasma (Breeze) und GNOME (Adwaita) und passt Fensterrahmen, Farben und Bedienelemente entsprechend an.
Dashboard mit Schnellsprung und Top-10 |
Katalog mit Filtern |
Buchdetailseite (NELE) mit Cover |
Nutzerliste, überfällig rot markiert |
Mahnliste (JÖRN) |
Mahnungseditor mit Brieftext-Vorschau |
(Die Bilddateien fehlen noch – siehe docs/screenshots/README.md
für eine Anleitung, welche Screenshots wo hinkommen.)
Electron ohne Oberflächen-Framework (kein React/Vue – reines HTML/CSS/JS),
SQLite über better-sqlite3 als
Datenhaltung. Die Tabellen, die INGA versteht, tragen exakt die Spaltennamen
des Perpustakaan-Formats – dadurch braucht es keine Übersetzungsschicht beim
Import/Export. Einzige Ausnahme vom Prinzip „keine Abhängigkeiten im
Renderer“: JsBarcode (MIT-Lizenz)
liegt als einzelne Datei unter src/renderer/js/vendor/ und wird per
<script>-Tag eingebunden – für die Strichcodes auf den Etiketten, ohne
Build-Schritt oder npm-Abhängigkeit im Renderer.
src/
main/ Hauptprozess: Fenster, Menü, Datenbank, Import/Export, Cover-Download, IPC
preload/ contextBridge-API zwischen Haupt- und Renderer-Prozess
renderer/ Oberfläche (index.html/app.js), Druckfenster für Mahnungen
schema/ Referenzschema aller 65 Perpustakaan-Tabellen (generiert)
Buchcover landen als Dateien im userData-Ordner (covers/) und werden über
eine INGA-interne Tabelle referenziert – sie sind kein Teil des
Perpustakaan-Formats und bleiben deshalb bei Import/Export unangetastet.
Mahnungen entstehen als eigenes Fenster, das einen HTML-Brief pro Nutzer:in
rendert – von dort aus entweder direkt über den System-Druckdialog
(webContents.print()) oder als PDF (webContents.printToPDF()).
Die einfachste Art, INGA zu benutzen: ein fertiges Programm für das eigene Betriebssystem aus Releases herunterladen (Windows-Installer/portable .exe, macOS .dmg, Linux AppImage/.deb/.rpm) und starten – keine weitere Installation nötig.
INGA ist nicht code-signiert – ein Zertifikat dafür kostet Geld (Apple: 99 $/Jahr, Windows: meist noch mehr) und ist für ein kostenloses Schulprojekt kaum zu rechtfertigen. Das bedeutet: beim allerersten Start einer heruntergeladenen Datei warnt das Betriebssystem, je nach Plattform unterschiedlich:
- macOS: „‚INGA' ist beschädigt und kann nicht geöffnet werden. Sie
sollten es in den Papierkorb legen." – klingt nach einem kaputten
Download, ist aber Gatekeepers reguläre Reaktion auf eine nicht
notariell beglaubigte App. Rechtsklick (bzw. bei gedrückter ctrl-Taste)
auf INGA.app → Öffnen → im Dialog noch einmal Öffnen bestätigen
– danach merkt sich macOS die Freigabe dauerhaft. Hilft das nicht,
einmalig im Terminal
xattr -cr /Applications/INGA.appausführen. - Windows: SmartScreen zeigt „Der Computer wurde durch Windows geschützt". Auf Weitere Informationen klicken, dann Trotzdem ausführen. Ein Virenschutzprogramm kann eine unsignierte .exe zudem fälschlich als Bedrohung melden (falsch positiv) – in dem Fall die Ausnahmeliste des Virenschutzes nutzen oder die portable .exe statt des Installers versuchen.
Voraussetzung: Node.js Version 22 oder neuer, auf allen drei Systemen gleich.
Windows 11: start.bat doppelklicken (oder im Explorer ausführen).
macOS / Linux: ./start.sh im Terminal ausführen (einmalig
chmod +x start.sh, falls "Permission denied").
Beide Skripte prüfen, ob Node.js in einer passenden Version vorhanden ist, installieren beim allerersten Start automatisch die Abhängigkeiten und starten dann INGA – verständliche Meldung statt kryptischem Fehler, falls etwas fehlt.
Von Hand (identisch auf allen drei Systemen):
npm install
npm start # App starten (Splashscreen 1–3 s, dann Hauptfenster)
npm test # Kernlogik prüfen (Datenbank, Import/Export, Ausleihregeln)- Datenbank, Einstellungen, Backups landen im betriebssystemüblichen
Nutzdaten-Verzeichnis, nie im Programmordner: Windows
%APPDATA%\INGA, macOS~/Library/Application Support/INGA, Linux~/.local/share/INGA(bzw.$XDG_DATA_HOME/INGA). - Alle Datei-Ein-/Ausgaben (Import/Export, Ferien-ICS, CSV/Excel-Export) erzwingen UTF-8 – Umlaute bleiben auf allen drei Systemen korrekt.
- CSV-Exporte für Menschen (Umlaufliste, Katalog, Nutzer, Rückgabe) nutzen Semikolon als Trennzeichen und eine UTF-8-BOM, damit deutsches Excel sie ohne Umweg richtig öffnet.
- Keine hartkodierten Pfade oder Backslashes im Code – durchgängig
path.join(); Zeilenenden im Repository sind über.gitattributesauf LF normiert.
npm install schlägt bei better-sqlite3 mit Compiler-Fehlern fehl
(z. B. no member named 'GetPrototype' in 'v8::Object'): Das passiert mit
sehr neuen Node-Versionen, für die better-sqlite3 kein vorgebautes Binary
hat und deshalb aus dem Quellcode kompilieren muss – das schlägt dann gegen
aktuelles V8 fehl. Ab better-sqlite3 v13 (siehe package.json) tritt das
nicht mehr auf, da die Prebuilds N-API-basiert sind. Bei älteren Checkouts:
npm install better-sqlite3@latest.
npm start bricht mit Electron failed to install correctly, please delete node_modules/electron and try installing again ab: npm install
lief zwar durch, aber Electrons eigenes postinstall-Skript hat das
~100–150 MB große Electron-Binary nicht vollständig heruntergeladen
(typisch bei instabiler Verbindung oder einem Netz/einer Firewall, die
GitHub-Release-Downloads blockiert – z. B. manche Schul- oder
Firmennetzwerke). Abhilfe:
rm -rf node_modules/electron
npm install electron --no-save # lädt das Binary erneut, zeigt den echten FehlerBricht der Download wieder ab, hilft oft ein anderes Netzwerk (z. B. Mobil-Hotspot) zum Testen, oder ein Mirror:
npm config set electron_mirror "https://npmmirror.com/mirrors/electron/"
rm -rf node_modules/electron && npm install electron --no-saveErfolg prüfen: cat node_modules/electron/path.txt muss einen Pfad wie
Electron.app/Contents/MacOS/Electron ausgeben, und diese Datei muss
existieren.
npm run dist:linux # AppImage, .deb, .rpm
npm run dist:win # NSIS-Installer + portable .exe
npm run dist:mac # .dmg (Apple Silicon + Intel)Fertige Builds für alle drei Plattformen entstehen automatisch über GitHub
Actions bei jedem Push nach main und bei jedem Release-Tag (v*) – siehe
.github/workflows/build.yml. Bei einem
Tag-Push wird zusätzlich automatisch ein GitHub Release mit allen
Build-Artefakten (AppImage, .deb, .rpm, Windows-Installer + portable .exe,
.dmg) angelegt, zusammen mit den latest*.yml-Metadatendateien, die
automatische Updates (siehe unten) brauchen.
INGA prüft zur Laufzeit selbst beim GitHub-Repository nach, ob eine
neuere Version veröffentlicht wurde (electron-updater, package.json
„build.publish“) – der Build lädt dabei NICHTS automatisch hoch
(--publish never in den dist:*-Skripten), das GitHub-Release entsteht
weiterhin ausschließlich über den bestehenden release-Job in
build.yml. Unter Windows lädt ein bestätigtes Update automatisch im
Hintergrund herunter; unter macOS/Linux öffnet sich stattdessen die
Release-Seite im Browser (INGA ist nicht code-signiert – ohne echte
Signatur kann macOS ein heruntergeladenes Update nicht zuverlässig
verifizieren, und unter Linux ist INGA auf zu unterschiedliche Arten
installierbar, um das automatisch abzudecken).
Installiert wird NIE sofort nach dem Download, sondern erst beim
nächsten Beenden von INGA (siehe unten „Automatische Sicherung") – davor
immer ein eigenes, nicht überspringbares Backup
(INGA_vor-Update-Backup_<Zeitstempel>.zip). Schlägt dieses Backup fehl,
installiert INGA nicht – das Update bleibt einfach bis zum nächsten
Beenden heruntergeladen liegen. autoInstallOnAppQuit ist bewusst
abgeschaltet: electron-updater hätte sonst einen eigenen, von diesem
Backup unabhängigen Installationsweg beim Beenden.
Eine Versionsnummer mit Vorabkennzeichnung (z. B. 1.2.0-beta.1) läuft
automatisch über einen eigenen Beta-Update-Kanal – Installationen dieser
Version werden nur über weitere …-beta.x-Releases aktualisiert, nicht
automatisch über die spätere reguläre 1.2.0.
Der Update-Dialog zeigt außerdem „Was ist neu" – denselben Text wie
der zugehörige Abschnitt in CHANGELOG.md: der
release-Job in build.yml extrahiert ihn passend zur Versionsnummer
des Tags (scripts/changelog-extract.js) und setzt ihn als Beschreibung
des GitHub-Release, electron-updater übernimmt genau diesen Text als
releaseNotes. Heißt in der Praxis: vor jedem Tag-Push muss
CHANGELOG.md bereits einen ## <Version>-Abschnitt für genau diese
Version enthalten – sonst bricht der release-Job bewusst ab, statt
eine Release-Beschreibung ohne Inhalt zu veröffentlichen.
GPL-3.0-or-later – freie Software, für Schulen ohne Genehmigungsvorbehalt.





