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.
98 lines
3.1 KiB
98 lines
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:
|
|
|
|
```text
|
|
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
|
|
```bash
|
|
git clone https://github.com
|
|
cd chartacapsa-repo
|
|
```
|
|
|
|
### 2. Virtuelle Umgebung einrichten & aktivieren
|
|
```bash
|
|
# Umgebung erstellen
|
|
python -m venv venv
|
|
|
|
# Aktivieren (Mac/Linux)
|
|
source venv/bin/activate
|
|
|
|
# Aktivieren (Windows CMD)
|
|
# venv\Scripts\activate
|
|
```
|
|
|
|
### 3. Abhängigkeiten installieren
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
*(Hinweis: Falls die Datei noch leer ist, installieren Sie Django via `pip install django`)*
|
|
|
|
### 4. Datenbank-Migrationen ausführen
|
|
```bash
|
|
cd chartacapsa
|
|
python manage.py migrate
|
|
```
|
|
|
|
### 5. Admin-Konto (Superuser) erstellen
|
|
```bash
|
|
python manage.py createsuperuser
|
|
```
|
|
|
|
### 6. Entwicklungsserver starten
|
|
```bash
|
|
python manage.py runserver
|
|
```
|
|
Öffnen Sie nun [http://127.0.0.1:8000](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 (`#A8C3B6`)
|
|
* 🔵 **Hintergrund:** Weiches Mint-Weiß (`#F4F7F6`)
|
|
* 🔴 **Status Vergeben:** Melonen-Pastell (`#FAD2E1`)
|
|
* 🟢 **Status Frei:** Soft-Mint (`#D0E7DE`)
|
|
|
|
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).
|