# Valu-Basic — Installationsanleitung

**Version:** 2.0 | **Letzte Aktualisierung:** Juli 2026

---

## Warum Valu-Basic?

Valu-Basic speichert alle Daten in einer einzigen SQLite-Datei — **du brauchst keine MySQL-Datenbank und kein Datenbank-Control-Panel**. Das macht Valu-Basic ideal für Webspace-Pakete ohne Datenbankunterstützung sowie für alle, die eine schlanke, schnelle Einzelnutzer-Inventarverwaltung suchen.

---

## Voraussetzungen

- Webhosting mit PHP 8.0 oder höher
- PHP-Erweiterung `pdo_sqlite` (bei den meisten Hostern standardmäßig aktiv)
- FTP-Zugang (z. B. FileZilla)
- Ein modernes Browser
- **Keine MySQL/MariaDB-Datenbank nötig**

---

## Installation in 4 Schritten

### Schritt 1 — Dateien hochladen

1. Entpacke das heruntergeladene Valu-Basic-Paket auf deinem Computer
2. Verbinde dich per FTP mit deinem Webspace
3. Lade **alle Dateien und Ordner** in ein leeres Verzeichnis hoch, z. B. `inventar/`

💡 **Tipp:** Bei den meisten Hostern erreichst du deine Dateien unter `public_html/` oder `httpdocs/`

⚠️ Der Ordner `data/` muss beschreibbar sein (chmod 755). Dort legt Valu-Basic die SQLite-Datenbank sowie einen individuellen Sicherheits-Token an.

---

### Schritt 2 — Setup-Assistent ausführen

1. Öffne deinen Browser
2. Rufe die URL deiner Installation auf, z. B.: `https://deine-domain.de/inventar/init_sqlite.php`
3. Lege einen Admin-Benutzernamen und ein Passwort (mind. 8 Zeichen) fest und klicke auf **🚀 Installieren**

Der Assistent legt automatisch an:
- die SQLite-Datenbank mit allen benötigten Tabellen
- dein Admin-Konto
- ein paar Standard-Orte und -Kategorien (Wohnzimmer, Küche, Elektronik, Möbel, …)
- 3 Beispiel-Gegenstände zum Kennenlernen der Oberfläche (können jederzeit gelöscht werden)

Optional kannst du dich direkt im Anschluss für den Update-Mailingliste-Hinweis eintragen — das ist freiwillig und jederzeit abbestellbar.

---

### Schritt 3 — init_sqlite.php löschen

⚠️ **Wichtig — bitte nicht überspringen!**

Nach erfolgreicher Installation **lösche die Datei `init_sqlite.php`** von deinem Server. Solange die Datei vorhanden ist, könnte jemand die Datenbank erneut überschreiben.

Per FTP: Verbinde dich, navigiere in den Installationsordner, lösche `init_sqlite.php`.

---

### Schritt 4 — Anmelden und loslegen

1. Rufe deine Valu-Basic-URL auf: `https://deine-domain.de/inventar/login.php`
2. Melde dich mit dem im Setup angelegten Admin-Konto an
3. Passe unter **Einstellungen → Orte** und **Einstellungen → Kategorien** die Vorgaben an deine Bedürfnisse an
4. Klicke auf **＋ Neu** und füge deinen ersten eigenen Gegenstand hinzu

---

## Gut zu wissen: das Item-Limit

Valu-Basic ist auf **25 Gegenstände** ausgelegt — für die meisten privaten Haushalte völlig ausreichend. Ab dem 25. Eintrag zeigt dir die App einen Hinweis auf ValuSafe, die Vollversion mit unbegrenzten Einträgen, Mehrbenutzer-Verwaltung und weiteren Funktionen. ValuSafe ist **ab Oktober 2026** verfügbar — über den Hinweis kannst du dich unverbindlich in die Mailingliste eintragen, um informiert zu werden.

Einen ausführlichen Vergleich der beiden Versionen findest du in der App unter **Versionsvergleich**.

---

## Häufige Probleme

| Problem | Lösung |
| :---- | :---- |
| Seite zeigt 500-Fehler | Prüfe ob alle Dateien vollständig hochgeladen wurden und PHP 8.0+ aktiv ist |
| "PDOException: could not find driver" | Die PHP-Erweiterung `pdo_sqlite` ist nicht aktiv — beim Hoster aktivieren lassen |
| Bilder werden nicht angezeigt | Ordner `upload/` muss Schreibrechte haben (chmod 755) |
| Datenbank kann nicht angelegt werden | Ordner `data/` muss beschreibbar sein (chmod 755) |
| init_sqlite.php zeigt das Formular erneut nach der Installation | Datenbank wurde ggf. nicht geschrieben — Schreibrechte für `data/` prüfen |

---

## Systemanforderungen

| Komponente | Minimum | Empfohlen |
| :---- | :---- | :---- |
| PHP | 8.0 | 8.1+ |
| Datenbank | SQLite (integriert, keine Installation nötig) | — |
| PHP-Erweiterungen | pdo_sqlite | pdo_sqlite, gd, zip |
| Webspace | 30 MB | 200 MB+ |

---

## Enthaltene Dokumentation

Im Ordner `service/` findest du zusätzlich:

- `Benutzerhandbuch_Valu-Basic.pdf` — die vollständige Bedienungsanleitung
- `erste_schritte.md` — Kurzanleitung für den Einstieg
- `about.md` — Informationen zur Anwendung
- `Rueckmeldung.md` — wie du Feedback oder Fehler melden kannst

---

## Support

Bei Fragen oder Problemen:

- 📖 Lies das Benutzerhandbuch unter `service/Benutzerhandbuch_Valu-Basic.pdf`
- 🌐 Live-Demo von ValuSafe (Vollversion): [https://valusafe.2ix.de](https://valusafe.2ix.de)
- 📬 Interesse an der Vollversion? Trage dich über die App (**Versionsvergleich**) in die Mailingliste ein

---

*Valu-Basic — Kostenlose Inventarverwaltung für Privatnutzer*
