Initial FarmCal MVP

README.md

@@ -0,0 +1,97 @@
+# FarmCal
+
+FarmCal ist eine schlanke Web-App zur Ingame-Planung fuer Farming Simulator:
+- Felder verwalten (Feldnummer + optionaler Name)
+- Aussaat- und Ernteplanung pro Feld
+- Ingame-Zeitmodell mit konfigurierbaren `Tagen pro Monat`
+- Tagesansicht mit konkreten Aufgaben (Aussaat/Ernte)
+
+Die App ist fuer Desktop und Smartphone ausgelegt (responsive UI) und nutzt MariaDB.
+
+## Tech-Stack
+
+- Backend: Go (net/http + html/template)
+- Datenbank: MariaDB (auch externe DB im Netzwerk)
+- Deployment: Docker (ein Container fuer die App)
+
+## Voraussetzungen
+
+- MariaDB erreichbar im Netzwerk
+- Datenbank und Benutzer vorhanden, z. B.:
+  - DB: `farmcal`
+  - User: `farmcal`
+  - Rechte auf `farmcal.*`
+
+## Konfiguration
+
+1. `.env.example` nach `.env` kopieren
+2. `DB_DSN` auf deine Netzwerk-MariaDB anpassen
+
+Beispiel:
+
+```env
+APP_PORT=8080
+DB_DSN=farmcal:SEHR_SICHERES_PASSWORT@tcp(192.168.1.40:3306)/farmcal?parseTime=true
+```
+
+## Start mit Docker Compose
+
+```bash
+docker compose --env-file .env up -d --build
+```
+
+Danach ist FarmCal unter `http://<host>:8080` erreichbar.
+
+## Als Image bauen und verteilen
+
+Image lokal bauen:
+
+```bash
+docker build -t farmcal:latest .
+```
+
+Tag fuer Registry:
+
+```bash
+docker tag farmcal:latest <deine-registry>/<dein-user>/farmcal:latest
+```
+
+Push:
+
+```bash
+docker push <deine-registry>/<dein-user>/farmcal:latest
+```
+
+## Datenmodell
+
+- `settings`: globale Spielparameter (`days_per_month`)
+- `fields`: Feldliste
+- `crops`: Feldfruechte + Aussaatfenster + Wachstumsdauer
+- `plans`: geplanter Anbau je Feld mit berechnetem Erntetermin
+
+Beim ersten Start werden Tabellen automatisch erstellt und Standardfruechte vorgeladen.
+
+## Lokale Entwicklung (ohne Docker)
+
+```bash
+set DB_DSN=farmcal:PASS@tcp(127.0.0.1:3306)/farmcal?parseTime=true
+go run ./cmd/server
+```
+
+## Neues Gitea-Repo anbinden
+
+```bash
+git init
+git add .
+git commit -m "Initial FarmCal MVP"
+git branch -M main
+git remote add origin <DEIN_GITEA_REPO_URL>
+git push -u origin main
+```
+
+## Nächste sinnvolle Ausbaustufen
+
+- Bearbeiten/Loeschen von Feldern und Plaenen
+- Kalenderansicht fuer mehrere Monate
+- Mehrspieler-/Benutzerverwaltung
+- Import/Export fuer bestehende Tabellen