Notfallvorrats-Inventar

✨ Funktionen

Bestandsverwaltung

• Vollständige CRUD-Operationen — Artikel hinzufügen, bearbeiten und löschen mit Kategorien, Unterkategorien, Mengen, Einheiten, täglichem Verbrauch und Ablaufdaten
• Automatisch berechnete Resttage — das System berechnet, wie viele Tage jeder Artikel basierend auf dem aktuellen Bestand und dem täglichen Verbrauch je Haushaltsmitglied reicht
• Statusanzeigen — Artikel werden automatisch als Kritisch (unter Mindestbestand), Warnung (unter Ziel) oder Ausreichend markiert
• Kategoriefilter — Klicken Sie auf eine Kategorie-Pille, um die Tabelle sofort zu filtern; Pillen sind nach aggregiertem Status farbcodiert
• Sortierbare Tabelle — Klicken Sie auf eine Spaltenüberschrift für aufsteigende/absteigende Sortierung
• Suche — Echtzeitsuche über Artikelnamen, Kategorien und Unterkategorien
• Backup exportieren — Ein-Klick-JSON-Export Ihres gesamten Inventars zur Offline-Aufbewahrung

Admin-Authentifizierung

• Einzel-Admin-Modell — ein Admin-Konto wird bei der Ersteinrichtung erstellt; keine Multi-User-Konten erforderlich
• BCrypt-Passwort-Hashing (Kostenfaktor 12) — Passwörter werden niemals im Klartext gespeichert
• PHP-Sitzungsauthentifizierung — Sitzungen in einem geschützten sessions/-Verzeichnis, nicht im System-Temp-Ordner
• Betrachtermodus — nicht authentifizierte Besucher können nur lesen
• Passwortänderung — Admin kann das Passwort jederzeit in den Einstellungen ändern
• .htaccess-Schutz — direkter URL-Zugriff auf JSON-Datendateien und Sitzungen ist blockiert

Überlebensrezepte

• 16 überlebensoptimierte Rezepte — speziell für die im Inventar erfassten Zutaten entwickelt
• Prioritätsstufen — Zuerst verwenden (verderblich), Bald verwenden oder Jederzeit
• Brennstoffkosten-Indikatoren — Null (kein Kochen), Niedrig (<10 Min.) oder Mittel (10-20 Min.)
• Nur-Notfall-Rezepte — klar markiert für kritische Situationen
• Komfort-/Normalitätsrezepte — Mahlzeiten, die die Moral in längeren Notfällen stärken
• Kinderversionen — angepasste Anleitungen für junge Kinder (ab 5 Jahren)
• Überlebenstipps — Wasserspartechniken, Zutaten-Ersatzstrategien und Koch-Abkürzungen
• Druckfertig — optimiertes Druck-Stylesheet für physische Kopien oder "Als PDF speichern"

📁 Dateistruktur

Voraussetzungen

• Webserver — Apache (mit .htaccess-Unterstützung) oder Nginx
• PHP 8.x — mit json- und posix-Erweiterungen (posix ist optional, bietet aber bessere Diagnose)
• Schreibberechtigungen — der Webserver-Benutzer (typischerweise www-data) muss in data/ und sessions/ schreiben können
• Keine Datenbank — alle Daten werden in JSON-Dateien gespeichert
• Kein npm/Build-Schritt — reines HTML, CSS und JavaScript; keine Kompilierung oder Bündelung erforderlich

🛠 Installation

Wählen Sie die Installationsmethode, die zu Ihrem Betriebssystem und Setup passt.

sudo cp -r ./emergency-prep-inventory /var/www/html/tools/emergency-prep-inventory

sudo bash setup-permissions.sh /var/www/html/tools/emergency-prep-inventory

mkdir -p /var/www/html/tools/emergency-prep-inventory/data
mkdir -p /var/www/html/tools/emergency-prep-inventory/sessions
sudo chown -R www-data:www-data /var/www/html/tools/emergency-prep-inventory
find /var/www/html/tools/emergency-prep-inventory -type d -exec chmod 755 {} \;
chmod 750 /var/www/html/tools/emergency-prep-inventory/data
chmod 700 /var/www/html/tools/emergency-prep-inventory/sessions
chmod 640 /var/www/html/tools/emergency-prep-inventory/*.php
chmod 644 /var/www/html/tools/emergency-prep-inventory/*.html
chmod 644 /var/www/html/tools/emergency-prep-inventory/*.css
chmod 660 /var/www/html/tools/emergency-prep-inventory/data/*.json

location /data/ {
    deny all;
}
location /sessions/ {
    deny all;
}

cp -r ./emergency-prep-inventory /Applications/XAMPP/xamppfiles/htdocs/emergency-prep-inventory

mkdir -p /Applications/XAMPP/xamppfiles/htdocs/emergency-prep-inventory/data
mkdir -p /Applications/XAMPP/xamppfiles/htdocs/emergency-prep-inventory/sessions
sudo chown -R daemon:daemon /Applications/XAMPP/.../data
sudo chown -R daemon:daemon /Applications/XAMPP/.../sessions

cp -r ./emergency-prep-inventory /Applications/MAMP/htdocs/emergency-prep-inventory

mkdir -p /Applications/MAMP/htdocs/emergency-prep-inventory/data
mkdir -p /Applications/MAMP/htdocs/emergency-prep-inventory/sessions
chmod 777 /Applications/MAMP/htdocs/emergency-prep-inventory/data
chmod 777 /Applications/MAMP/htdocs/emergency-prep-inventory/sessions

🔌 API-Referenz

Die Backend-API (api.php) verwendet ein einfaches aktionsbasiertes Routing. Alle Anfragen geben JSON-Antworten zurück.

Öffentliche Endpunkte (Keine Authentifizierung erforderlich)

Geschützte Endpunkte (Admin-Authentifizierung erforderlich)

Anfrage-/Antwort-Beispiele

Anmeldung:

{ "action": "login", "username": "admin", "password": "your-password" }

Inventar speichern:

{ "action": "save_inventory", "data": [{ "itemName": "Rice", "category": "Grains", "currentQuantity": 5, "unit": "kg", "dailyConsumption": 0.1 }] }

📖 Anleitung

Ersteinrichtung

1. Admin-Konto erstellen — Benutzername wählen (mindestens 2 Zeichen) und Passwort wählen (mindestens 6 Zeichen)
2. Haushalt konfigurieren — Anzahl der erwachsenen Männer, erwachsenen Frauen, Kinder und Zieltage festlegen

Nach der Einrichtung werden Sie automatisch als Admin angemeldet.

Bestandsartikel verwalten

• Neuen Artikel hinzufügen — auf "Neuer Artikel" klicken (nur Admin)
• Artikel bearbeiten — auf das Stift-Symbol in der Aktionsspalte klicken (nur Admin)
• Artikel löschen — auf das Papierkorb-Symbol klicken (nur Admin)
• Neue Kategorien/Einheiten hinzufügen — jedes Dropdown hat eine "+"-Schaltfläche
• Backup exportieren — auf "Backup Export" klicken, um das Inventar als JSON-Datei herunterzuladen

Als Gast betrachten

Besucher, die nicht angemeldet sind, können das Inventar im Nur-Lese-Modus durchsuchen. Sie können:

• Alle Bestandsartikel und deren Status anzeigen
• Nach Kategorie filtern und suchen
• Sprachen wechseln
• Auf die Rezeptseite zugreifen

Sie können keine Artikel hinzufügen, bearbeiten oder löschen.

Überlebensrezepte

Klicken Sie auf "Rezepte", um die Überlebensrezeptseite zu öffnen. Jedes Rezept enthält:

• Prioritätsabzeichen — wann dieses Rezept basierend auf der Verderblichkeit der Zutaten verwenden
• Brennstoffkosten-Abzeichen — wie viel Brennstoff zum Kochen benötigt wird
• Wasserkosten — geschätzter Wasserverbrauch für das Rezept
• Zutatenliste — mit auf Ihr Inventar abgestimmten Mengen
• Schritt-für-Schritt-Anleitung — nummerierte Kochschritte
• Kinderversion — angepasste Anleitungen für die Fütterung junger Kinder
• Überlebenstipp — praktische Ratschläge zur Ressourcenschonung

Verwenden Sie die Schaltfläche "Drucken / Als PDF speichern", um ein physisches Backup aller Rezepte zu erstellen.

🔧 Fehlerbehebung

Berechtigungsfehler

Wenn Sie Fehler zum Dateischreibzugriff sehen:

1. Berechtigungsprüfungs-Endpunkt ausführen: api.php?action=check_permissions
2. Dies zeigt den PHP-Benutzer, Dateieigentümer und Berechtigungsdetails an
3. Das Einrichtungsskript erneut ausführen: sudo bash setup-permissions.sh /ihr/projektpfad
4. Wenn das Problem weiterhin besteht, Eigentümer manuell prüfen — Dateien sollten www-data:www-data mit Berechtigungen 660 für JSON-Dateien gehören

Sitzungsprobleme

Wenn die Anmeldung nicht persistent bleibt:

• Sicherstellen, dass das sessions/-Verzeichnis existiert und von www-data beschreibbar ist
• Prüfen, dass das Verzeichnis Berechtigungen 700 hat und www-data gehört
• Überprüfen, dass Ihr Browser Cookies von der Domain akzeptiert

API gibt 500 bei Einrichtung zurück

Dies bedeutet normalerweise, dass das data/-Verzeichnis oder JSON-Dateien nicht beschreibbar sind. Die API-Antwort enthält Diagnoseinformationen:

• php_user — der Benutzer, als der PHP läuft
• file_perms — aktuelle Dateiberechtigungen
• file_owner — aktueller Dateieigentümer
• fix — der genaue Befehl zur Problemlösung

🛡 Sicherheitsaspekte

• JSON-Datendateien sind über .htaccess-Regeln (Apache) oder Nginx-Location-Blöcke vor direktem HTTP-Zugriff geschützt
• Admin-Anmeldeinformationen werden mit BCrypt-Hashing (Kosten 12) gespeichert — Passwörter werden niemals im Klartext gespeichert
• Sitzungsdateien werden in einem dedizierten Verzeichnis mit restriktiven Berechtigungen (700) gespeichert, nicht im systemweiten /tmp-Verzeichnis
• PHP-Dateien haben Berechtigungen 640 — nur vom Webserver-Benutzer und der Gruppe lesbar, nicht weltweites Lesbar
• Keine CSRF-Token — diese Anwendung ist für die Verwendung durch einen einzelnen Admin in einem vertrauenswürdigen Netzwerk konzipiert. Bei öffentlichem Internetzugang CSRF-Schutz hinzufügen
• Keine Ratenbegrenzung — Brute-Force-Schutz ist nicht implementiert. Bei öffentlichem Zugriff fail2ban oder ähnliche Tools verwenden

⚙️ Technologie-Stack

Browser-Unterstützung

• Chrome / Edge (letzte 2 Versionen)
• Firefox (letzte 2 Versionen)
• Safari (letzte 2 Versionen)
• Mobile Browser (Chrome für Android, Safari für iOS)

📄 Lizenz

Dieses Projekt wird wie besehen für die persönliche Haushaltsnotfallvorsorge bereitgestellt. Kontakt: marundaliliana@gmail.com für individuelle Einsätze oder Anfragen.