Pirmin Hinderling (fedora)
129 lines
3.5 KiB
Markdown
129 lines
3.5 KiB
Markdown
# Faktenkompass – Wissensdatenbank für überprüfbare Behauptungen
|
||
|
||
Eine Django-Webplattform zum schnellen Nachschlagen von Fakten, Quellen und Gegenargumenten zu häufigen Aussagen in Diskussionen.
|
||
|
||
## Voraussetzungen
|
||
|
||
- Python 3.10 oder höher
|
||
- pip
|
||
|
||
## Installation
|
||
|
||
### 1. Virtuelle Umgebung erstellen
|
||
|
||
```bash
|
||
cd /pfad/zu/ArgumentAtlas
|
||
python3 -m venv .venv
|
||
source .venv/bin/activate # Linux/macOS
|
||
# .venv\Scripts\activate # Windows
|
||
```
|
||
|
||
Falls `python3 -m venv` fehlschlägt, nutzen Sie explizit den System-Python:
|
||
|
||
```bash
|
||
/usr/bin/python3 -m venv .venv
|
||
```
|
||
|
||
### 2. Abhängigkeiten installieren
|
||
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 3. Datenbank migrieren
|
||
|
||
```bash
|
||
python manage.py migrate
|
||
```
|
||
|
||
### 4. Beispieldaten laden
|
||
|
||
```bash
|
||
python manage.py load_sample_data
|
||
```
|
||
|
||
Dies erstellt 7 Kategorien mit insgesamt 15 Behauptungen, Quellen und Gegenargumenten.
|
||
|
||
### 5. Admin-Zugang einrichten
|
||
|
||
```bash
|
||
python manage.py createsuperuser
|
||
```
|
||
|
||
### 6. Entwicklungsserver starten
|
||
|
||
```bash
|
||
python manage.py runserver
|
||
```
|
||
|
||
Die Anwendung ist unter [http://127.0.0.1:8000/](http://127.0.0.1:8000/) erreichbar.
|
||
Das Django-Admin-Interface liegt unter [http://127.0.0.1:8000/admin/](http://127.0.0.1:8000/admin/).
|
||
|
||
Falls `runserver` mit einem Python-Pfadfehler abbricht, starten Sie mit:
|
||
|
||
```bash
|
||
python manage.py runserver --noreload
|
||
```
|
||
|
||
## PostgreSQL (Produktion)
|
||
|
||
Setzen Sie folgende Umgebungsvariablen:
|
||
|
||
```bash
|
||
export DB_ENGINE=django.db.backends.postgresql
|
||
export DB_NAME=faktenkompass
|
||
export DB_USER=ihr_benutzer
|
||
export DB_PASSWORD=ihr_passwort
|
||
export DB_HOST=localhost
|
||
export DB_PORT=5432
|
||
```
|
||
|
||
Installieren Sie zusätzlich `psycopg2-binary` und führen Sie `migrate` erneut aus.
|
||
|
||
## Projektstruktur
|
||
|
||
```
|
||
ArgumentAtlas/
|
||
├── faktenkompass/ # Django-Projektkonfiguration
|
||
│ ├── settings.py
|
||
│ └── urls.py
|
||
├── claims/ # Haupt-App
|
||
│ ├── models.py # Category, Claim, Source, EvidenceFile, CounterArgument, Tag
|
||
│ ├── views.py
|
||
│ ├── urls.py
|
||
│ ├── admin.py
|
||
│ └── management/commands/load_sample_data.py
|
||
├── templates/ # Django-Templates (Bootstrap 5)
|
||
├── static/css/custom.css # Minimales Custom-Styling
|
||
├── requirements.txt
|
||
└── manage.py
|
||
```
|
||
|
||
## Funktionen
|
||
|
||
- **Startseite:** Kategorien als Karten mit Behauptungsanzahl
|
||
- **Kategorieseite:** Behauptungen filtern und durchsuchen
|
||
- **Behauptungsdetail:** Status, Kurzantwort, Nachweise (Bilder/PDFs), Evidenzlevel, Quellen, Gegenargumente, Tags
|
||
- **Globale Suche:** Behauptungen über alle Kategorien hinweg
|
||
- **Admin:** Alle Inhalte über Django Admin pflegen
|
||
- **SEO:** Sprechende URLs (`/kategorie/klimawandel/`, `/behauptung/...`)
|
||
|
||
## Inhalte verwalten
|
||
|
||
Melden Sie sich im Django-Admin an, um Kategorien, Behauptungen, Quellen, Gegenargumente und Schlagwörter anzulegen oder zu bearbeiten. Slugs werden automatisch aus Titeln generiert.
|
||
|
||
### Nachweise hochladen
|
||
|
||
Bei jeder Behauptung können im Admin unter **Nachweise** Dateien hochgeladen werden:
|
||
|
||
- **Bilder:** JPG, PNG, GIF, WebP, SVG (z. B. Grafiken, Screenshots, Diagramme)
|
||
- **PDFs:** Studien, Berichte, Faktenblätter
|
||
|
||
Optional: Titel, Bildunterschrift und Reihenfolge. Hochgeladene Dateien erscheinen auf der Behauptungsdetailseite im Abschnitt „Nachweise“.
|
||
|
||
Dateien werden unter `media/evidence/` gespeichert. In der Produktion muss der Webserver Medien-Dateien ausliefern (z. B. über Nginx).
|
||
|
||
## Lizenz
|
||
|
||
Projekt für den internen Gebrauch / Bildungszwecke.
|