You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

3.1 KiB

🗂️ 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).

Powered by TurnKey Linux.