|
|
1 month ago | |
|---|---|---|
| chartacapsa | 1 month ago | |
| .gitignore | 1 month ago | |
| README.md | 1 month ago | |
| requirements.txt | 1 month ago | |
README.md
🗂️ ChartaCapsa (KartenKiste)
Eine moderne, cleane Django-Web-App zur effizienten Verwaltung, Zuweisung und zum Druck von analogen DIN-A6-Gebietskarten.
✨ Features
- 🗺️ Gebietsverwaltung: Übersichtliche digitale Karteikiste für alle Predigtdienst- oder Vertriebsgebiete.
- 🔄 Dynamische Zuweisung: Gebiete per Klick an Personen herausgeben und unkompliziert wieder zurücknehmen.
- ⏳ Status-Tracking: Automatische Erfassung des Eigenschaften-Feldes
zuletzt bearbeitet. - 🖨️ DIN-A6 Print-Ready: Optimierte Druckansichten via CSS-Media-Queries, um Karten direkt im perfekten A6-Querformat als PDF zu exportieren oder zu drucken.
- 🎨 Modern UI: Ein minimalistisches, augenschonendes Pastell-Design (Salbeigrün, Soft-Mint, Schieferblau).
📁 Repository-Struktur
Das Projekt folgt einer strikten Trennung von Konfiguration, App-Logik und virtueller Umgebung:
chartacapsa-repo/
├── .gitignore # Ignoriert venv, lokale DBs und Geheimnisse
├── README.md # Diese Dokumentation
├── requirements.txt # Python-Abhängigkeiten
├── venv/ # Virtuelle Umgebung (lokal)
└── chartacapsa/ # Django-Projekt-Wurzelverzeichnis
├── manage.py # Django CLI-Tool
├── config/ # Zentrales Konfigurationsverzeichnis (Settings, URLs)
├── gebiete/ # Die Haupt-App (Models, Views, Templates)
└── static/ # Globale CSS-Styles (Farbvariablen), JS und Assets
🚀 Schnellstart (Lokal aufsetzen)
Folgen Sie diesen Schritten, um das Projekt auf Ihrem lokalen Rechner zu starten:
1. Repository klonen & Verzeichnis betreten
git clone https://github.com
cd chartacapsa-repo
2. Virtuelle Umgebung einrichten & aktivieren
# Umgebung erstellen
python -m venv venv
# Aktivieren (Mac/Linux)
source venv/bin/activate
# Aktivieren (Windows CMD)
# venv\Scripts\activate
3. Abhängigkeiten installieren
pip install -r requirements.txt
(Hinweis: Falls die Datei noch leer ist, installieren Sie Django via pip install django)
4. Datenbank-Migrationen ausführen
cd chartacapsa
python manage.py migrate
5. Admin-Konto (Superuser) erstellen
python manage.py createsuperuser
6. Entwicklungsserver starten
python manage.py runserver
Öffnen Sie nun http://127.0.0.1:8000 im Browser. Unter /admin können Sie sich mit Ihren Admin-Daten einloggen.
🎨 Design- & Farbrichtlinien
Die App nutzt ein Pastel-Clean Farbschema, das über CSS-Variablen gesteuert wird:
- 🟢 Primärfarbe: Salbeigrün (
#FBDFA2) - 🔵 Hintergrund: Weiches Mint-Weiß (
#F3E2C6) - 🔴 Status Vergeben: Melonen-Pastell (
#FA9DA6) - 🟢 Status Frei: Soft-Mint (
#8EB694)
Drucklayouts erzwingen über @page { size: A6 landscape; } das korrekte Kartenformat im Browser-Druckdialog.
📝 Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Details finden Sie in der LICENSE-Datei (falls vorhanden).