Bedienungsanleitung

Überblick

Das Spyra Rocks Stallbuch Geflügel dient zur digitalen Dokumentation und Verwaltung eines Geflügelbestands. Die App unterstützt bei Bestand, Legeleistung, Arzneimitteln, Ereignissen, Wetterdaten, Stammdaten und wichtigen Erinnerungen wie der Newcastle-Impfung.

Die Daten werden lokal auf dem Server gespeichert und können über die integrierte Backupverwaltung gesichert werden.

Demo-Version

Für einen ersten Eindruck gibt es eine Demo-Version des Stallbuchs. In der Demo können Funktionen ausprobiert werden, ohne produktive Daten zu verändern.

Demo öffnen

Ersteinrichtung

Beim ersten Start ist noch kein Passwort hinterlegt. Die App zeigt deshalb automatisch eine Ersteinrichtungsseite an.

1. Stallbuch im Browser öffnen.
2. Ein eigenes Passwort vergeben.
3. Passwort wiederholen.
4. Speichern.

Das Passwort wird als Hash gespeichert. Es gibt kein Standardpasswort, kein Masterpasswort und keine Hintertür im Code.

Anmeldung

Nach der Ersteinrichtung erscheint beim Aufruf der App die Loginseite.

1. Passwort eingeben.
2. Auf Anmelden klicken.
3. Nach erfolgreicher Anmeldung wird das Dashboard geöffnet.

Über Abmelden kann die Sitzung beendet werden.

Dashboard

Das Dashboard zeigt die wichtigsten Informationen zum aktuellen Stallbuchjahr auf einen Blick. Dazu gehören je nach Datenbestand Bestandszahlen, Legeleistung, Auswertungen und Hinweise.

Die Newcastle-Impfung wird als eigene breite Kachel angezeigt. Dort sieht man den nächsten Impftermin, den Status und den Button Heute geimpft.

Die Zeitraum-Auswahl für Auswertungen bleibt erhalten. Eine reine Tage-Kachel wie „Ganzes Jahr / 156 Tage“ wird nicht mehr angezeigt, weil diese Information für das Dashboard keinen eigenen Mehrwert hat.

Legeleistung

Im Bereich Legeleistung werden Eier nach Datum, Legeliste und Tierart erfasst.

Die App ist besonders auf Legehennen und Hühnereier ausgerichtet. Weitere Tierarten können bei Bedarf frei angelegt und separat geführt werden.

Typische Angaben sind:

• Datum
• Legeliste oder Tierart
• Anzahl Eier
• Bemerkung

Durch die Trennung nach Legelisten und Tierarten bleiben Auswertungen nachvollziehbar. Eier verschiedener Gruppen werden nicht ungewollt vermischt.

Bestand

Im Bereich Bestand wird der Geflügelbestand gepflegt.

Hier können Bestandsänderungen dokumentiert werden, zum Beispiel:

• Zugänge
• Abgänge
• Verluste
• Umsetzungen
• Korrekturen

Die Bestandsführung hilft dabei, den tatsächlichen Tierbestand je Tierart und Jahr nachvollziehbar zu dokumentieren.

Bestand aus Vorjahr übernehmen

Das Stallbuch arbeitet jahresbezogen. Damit ein neues Jahr nicht komplett neu eingerichtet werden muss, kann der Bestand aus dem Vorjahr übernommen werden.

Die Funktion ist dafür gedacht, den Anfangsbestand für das neue Jahr vorzubereiten.

1. Neues Stallbuchjahr auswählen oder anlegen.
2. Funktion Bestand aus Vorjahr übernehmen aufrufen.
3. Die übernommenen Werte prüfen.
4. Falls nötig, Bestandszahlen im neuen Jahr korrigieren.

Arzneimittel

Im Bereich Arzneimittel können Behandlungen und Medikamentengaben dokumentiert werden.

Typische Angaben sind:

• Datum
• Tierart oder Gruppe
• Arzneimittel
• Dosierung
• Wartezeit
• behandelnde Person
• Bemerkungen

Dieser Bereich dient der nachvollziehbaren Dokumentation von Behandlungen.

Ereignisse

Im Bereich Ereignisse können besondere Vorkommnisse festgehalten werden.

Beispiele sind:

• Krankheiten
• Verluste
• Umstallungen
• Auffälligkeiten
• Kontrolltermine
• sonstige Beobachtungen

Wetter

Das Stallbuch kann Wetterdaten anzeigen. Diese Informationen helfen dabei, Ereignisse, Legeleistung oder Auffälligkeiten besser einzuordnen.

Wetterdaten können zum Beispiel bei Hitze, Frost oder starken Wetterumschwüngen für die Dokumentation hilfreich sein.

Newcastle-Impfung

Hühner müssen regelmäßig gegen die Newcastle-Krankheit geimpft werden. Der genaue Turnus hängt vom verwendeten Impfstoff und den Vorgaben ab.

Im Stallbuch kann unter Stammdaten der letzte Impftermin hinterlegt und der passende Turnus ausgewählt werden.

Mögliche Turnusse sind:

• alle 6 Wochen
• alle 3 Monate
• alle 6 Monate
• einmal im Jahr

Die App berechnet daraus den nächsten Impftermin und zeigt den Status im Dashboard an.

Über den Button Heute geimpft wird der letzte Impftermin auf das aktuelle Datum gesetzt. Danach beginnt der gewählte Turnus neu.

Tierarten

Die Tierarten im Stallbuch sind frei verwaltbar. Es sollen keine Test-Tierarten oder festen Sondergruppen hart im Code erzwungen werden.

Bei einer neuen Installation wird nur Legehennen als Grund-Tierart angelegt. Diese Tierart ist geschützt, weil Dashboard und Legeleistung darauf aufbauen.

Weitere Tierarten können selbst angelegt werden, zum Beispiel Enten, Erpel, Gänse, Wachteln oder andere Gruppen.

Tierart löschen

Tierarten außer Legehennen können gelöscht werden. Beim Löschen verschwinden auch die zugehörigen Daten dieser Tierart.

Dazu gehören insbesondere:

• Anfangsbestände
• Bestandsbewegungen
• Leistungs- beziehungsweise Legedaten

Stammdaten

Im Bereich Stammdaten werden wichtige betriebliche Angaben gepflegt.

Dazu gehören zum Beispiel:

• Tierhalterdaten
• Tierseuchenkasse
• Veterinäramt
• Tierkörperbeseitigung
• Newcastle-Impfung
• weitere betriebliche Angaben

Stammdaten können jahresbezogen geführt werden. Dadurch bleiben Angaben und Bestände je Stallbuchjahr nachvollziehbar.

Drucken und PDF

Im Bereich Drucken können Auswertungen und Listen für Ablage, Kontrolle oder Weitergabe erstellt werden.

Typische Druckbereiche sind:

• Legelisten
• Bestandsübersichten
• Arzneimittel
• Ereignisse
• Stammdaten

Die Druckansichten sind für DIN A4 optimiert. Je nach Liste kann Hoch- oder Querformat sinnvoll sein.

Passwort ändern

Das Passwort kann in den Stammdaten beziehungsweise Einstellungen geändert werden.

1. Aktuelles Passwort eingeben.
2. Neues Passwort eingeben.
3. Neues Passwort wiederholen.
4. Änderung speichern.

Passwort zurücksetzen

Wenn das Passwort vergessen wurde, kann es über eine Reset-Datei zurückgesetzt werden. Diese Funktion ist bewusst an FTP-Zugriff gebunden.

1. Per FTP im App-Ordner die Datei data/passwort-reset.txt anlegen.
2. Der Inhalt der Datei ist egal, zum Beispiel RESET.
3. Im Browser die Reset-Seite öffnen: /stallbuch/?page=passwort_reset
4. Neues Passwort setzen.

Nach erfolgreichem Zurücksetzen wird die Reset-Datei automatisch entfernt.

Backups verwalten

Unter Stammdaten → Wartung → Backups verwalten können Sicherungen erstellt und verwaltet werden.

Mögliche Aktionen:

• neues Backup erstellen
• Backup herunterladen
• einzelnes Backup löschen
• Backup wiederherstellen
• alle Backups nach Sicherheitsabfrage löschen

Vor einer Wiederherstellung wird automatisch eine Sicherheitskopie erstellt.

Systemcheck

Der Systemcheck prüft, ob die App korrekt eingerichtet ist.

Geprüft werden unter anderem:

• benötigte Ordner
• Schreibrechte
• Schutzdateien
• Datenbankzugriff
• wichtige PHP-Funktionen

Über Zurück zur App gelangt man wieder ins Stallbuch.

Hinweise zur Nutzung

Das Stallbuch sollte regelmäßig gepflegt werden. Besonders Bestandsänderungen, Arzneimittel, Ereignisse und Impfungen sollten zeitnah eingetragen werden, damit die Dokumentation nachvollziehbar bleibt.

Vor dem Löschen von Tierarten sollte geprüft werden, ob die dazugehörigen Daten wirklich entfernt werden sollen.