Repository Struktur
Quellcode auf Codeberg
Das offizielle Repository wird auf Codeberg gehostet:
👉 codeberg.org/michalefty/mistelmonitor
🌿 Branch-Strategie (2-Branch Policy)
Auf Codeberg existieren ausschließlich zwei permanente Branches:
main: Stabile Production-Branch für Releases und Play Store Uploads. Direkte Commits sind per Pre-Commit-Hook verboten.develop: Primärer Integrationsbranch für fertige Features und Bugfixes.- Lokale Feature-Branches: Entwickler arbeiten auf lokalen Zweigen (
feat/...,fix/...), die vor dem Push nachdevelopintegriert werden.
🛡️ Repository- & Verzeichnis-Hygiene
Um die Privatsphäre und Sicherheit des Projekts zu gewährleisten, erzwingen automatisierte Git-Hooks und CI-Scanner strenge Hygiene-Regeln:
- Keine IDE- oder Cache-Verzeichnisse im Git-Index (
.continue/,.vscode/,venv*/,__pycache__). - Keine sensiblen Konfigurationsdateien (
.env,key.properties,*.jks, API-Keys). - Keine absoluten oder toten Symlinks.
Verzeichnisstruktur
mistelmonitor/
├── lib/ # Flutter App (Mobil)
│ ├── controllers/ # State Management & View Models
│ ├── models/ # Datenmodelle (Report, Event, Sector, Tree...)
│ ├── screens/ # UI-Screens (Scout, Map, Admin, Team...)
│ ├── services/ # Business Logic (Sync, Database, Location...)
│ └── widgets/ # Wiederverwendbare UI-Komponenten
├── assets/ # Grafiken, Icons, ALKIS-Katasterdaten
├── syncbox/ # MistelBox Server (Rootless FastAPI & Sync-Hub)
├── docs/ # Technische Dokumentations-Suite
│ ├── ARCHITECTURE.md # Gesamtsystem- & Architektur-Spezifikation
│ └── SYNC_SPECIFICATION.md# P2P-Protokoll & Manifest v1.1.0 Spezifikation
├── scripts/ # Automation, Git-Hooks & Hygiene-Scanner
├── test/ # TDD Unit- & Integrations-Tests
├── CONTRIBUTING.md # Entwickler-Leitfaden & Contribution Guide
├── SECURITY.md # DevSecOps & Security Policy
└── GEMINI.md # Projekt-Governance & Release-Regeln