WIP Quellen

.gitignore

@@ -136,6 +136,7 @@ venv/
 ENV/
 env.bak/
 venv.bak/
+pyvenv.cfg
 
 # Spyder project settings
 .spyderproject
@@ -173,4 +174,3 @@ cython_debug/
 
 # PyPI configuration file
 .pypirc
-

README.md

@@ -1,3 +1,18 @@
 # liederquelle
 
-Django-Backend für die Liederquelle 2.0
+Django-Backend für die Liederquelle 2.0
+
+Hier sammelt der Notenbund die Hintergrundinformationen für den Liederpool
+und für die öffentliche Rechercheplattform.
+
+- Liederbücher
+- Lieder
+- Urheber*innen
+- Verlage
+- Nutzungsrechte und ihre Inhaber*innen
+
+# Abhängigkeiten
+
+- Python 3.14 (funktioniert wahrscheinlich auch mit anderen Versionen)
+- Django 6.0
+- django-taggit

liederquelle/liederquelle/asgi.py

@@ -0,0 +1,24 @@
+"""
+ASGI config for quellen project.
+
+It exposes the ASGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/6.0/howto/deployment/asgi/
+"""
+
+import os
+import logging
+logging.captureWarnings(True)
+
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'liederquelle.settings')
+
+import dotenv
+current_dir = os.path.abspath(os.path.dirname(__file__))
+# try to load .env file from current directory or look upwards
+while current_dir and current_dir != "/" and not os.path.isfile(os.path.join(current_dir, '.env')):
+    current_dir = "/".join(os.path.split(current_dir)[:-1])
+
+application = get_asgi_application()

liederquelle/liederquelle/settings/__init__.py

@@ -0,0 +1,5 @@
+from .base import *
+try:
+    from .local import *
+except:
+    pass

liederquelle/liederquelle/settings/base.py

@@ -0,0 +1,122 @@
+"""
+Django settings for quellen project.
+
+see https://docs.djangoproject.com/en/6.0/ref/settings/
+"""
+import os
+from pathlib import Path
+
+# Build paths inside the project like this: BASE_DIR / 'subdir'.
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+
+def get_env_variable(var_name):
+    """Get the environment variable or return exception."""
+    try:
+        return os.environ[var_name]
+    except KeyError:
+        error_msg = 'Set the %s environment variable.' % var_name
+        raise ImproperlyConfigured(error_msg)
+
+
+# Quick-start development settings - unsuitable for production
+# See https://docs.djangoproject.com/en/6.0/howto/deployment/checklist/
+
+# SECURITY WARNING: keep the secret key used in production secret!
+SECRET_KEY = get_env_variable('SECRET_KEY')
+
+# SECURITY WARNING: don't run with debug turned on in production!
+DEBUG = False
+
+ALLOWED_HOSTS = []
+
+
+# Application definition
+
+INSTALLED_APPS = [
+    'quellen.apps.QuellenConfig',
+    'taggit',
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+]
+
+MIDDLEWARE = [
+    'django.middleware.security.SecurityMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+    'django.middleware.common.CommonMiddleware',
+    'django.middleware.csrf.CsrfViewMiddleware',
+    'django.contrib.auth.middleware.AuthenticationMiddleware',
+    'django.contrib.messages.middleware.MessageMiddleware',
+    'django.middleware.clickjacking.XFrameOptionsMiddleware',
+]
+
+ROOT_URLCONF = 'liederquelle.urls'
+
+TEMPLATES = [
+    {
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
+        'DIRS': [],
+        'APP_DIRS': True,
+        'OPTIONS': {
+            'context_processors': [
+                'django.template.context_processors.request',
+                'django.contrib.auth.context_processors.auth',
+                'django.contrib.messages.context_processors.messages',
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = 'liederquelle.wsgi.application'
+
+
+# Database
+# https://docs.djangoproject.com/en/6.0/ref/settings/#databases
+
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': BASE_DIR / 'db.sqlite3',
+    }
+}
+
+
+# Password validation
+# https://docs.djangoproject.com/en/6.0/ref/settings/#auth-password-validators
+
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
+    },
+]
+
+
+# Internationalization
+# https://docs.djangoproject.com/en/6.0/topics/i18n/
+
+LANGUAGE_CODE = 'de-de'
+
+TIME_ZONE = 'Europe/Berlin'
+
+USE_I18N = True
+
+USE_TZ = True
+
+
+# Static files (CSS, JavaScript, Images)
+# https://docs.djangoproject.com/en/6.0/howto/static-files/
+
+STATIC_URL = 'static/'

liederquelle/liederquelle/settings/local.py

@@ -0,0 +1,9 @@
+import os
+from .base import *
+
+PROJECT_ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), '../..'))
+
+def rootrel(p):
+    return os.path.abspath(os.path.join(PROJECT_ROOT, p))
+
+DEBUG = True

liederquelle/liederquelle/urls.py

@@ -0,0 +1,23 @@
+"""
+URL configuration for quellen project.
+
+The `urlpatterns` list routes URLs to views. For more information please see:
+    https://docs.djangoproject.com/en/6.0/topics/http/urls/
+Examples:
+Function views
+    1. Add an import:  from my_app import views
+    2. Add a URL to urlpatterns:  path('', views.home, name='home')
+Class-based views
+    1. Add an import:  from other_app.views import Home
+    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
+Including another URLconf
+    1. Import the include() function: from django.urls import include, path
+    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    #path("quellen/", include("quellen.urls")),
+    path('admin/', admin.site.urls),
+]

liederquelle/liederquelle/wsgi.py

@@ -0,0 +1,24 @@
+"""
+WSGI config for quellen project.
+
+It exposes the WSGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/6.0/howto/deployment/wsgi/
+"""
+
+import os
+import logging
+logging.captureWarnings(True)
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'liederquelle.settings')
+
+import dotenv
+current_dir = os.path.abspath(os.path.dirname(__file__))
+# try to load .env file from current directory or look upwards
+while current_dir and current_dir != "/" and not os.path.isfile(os.path.join(current_dir, '.env')):
+    current_dir = "/".join(os.path.split(current_dir)[:-1])
+
+application = get_wsgi_application()

liederquelle/manage.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+import dotenv
+import logging
+logging.captureWarnings(True)
+
+
+def main():
+    """Run administrative tasks."""
+    env = '.env' #os.path.join(current_dir, '.env')
+    if not os.path.isfile(env):
+        print("Configuration environment file (.env) not found!")
+        sys.exit(1)
+    dotenv.load_dotenv(env)
+
+    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'liederquelle.settings')
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == '__main__':
+    main()

liederquelle/quellen/admin.py

@@ -0,0 +1,28 @@
+from django.contrib import admin
+from .models import Person, Identity, AuthorID, Contact, Medium
+
+
+@admin.register(Person)
+class PersonAdmin(admin.ModelAdmin):
+    list_display = ['name',]
+
+
+@admin.register(Identity)
+class IdentityAdmin(admin.ModelAdmin):
+    list_display = ['person','author_id','alias']
+
+
+@admin.register(AuthorID)
+class AuthorIDAdmin(admin.ModelAdmin):
+    list_display = ['person','key','value']
+
+
+@admin.register(Contact)
+class ContactAdmin(admin.ModelAdmin):
+    date_hierarchy = 'last_try'
+    list_display = ['reference',]
+
+
+@admin.register(Medium)
+class MediumAdmin(admin.ModelAdmin):
+    list_display = ['contact','key','value']

liederquelle/quellen/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+
+class QuellenConfig(AppConfig):
+    name = 'quellen'

liederquelle/quellen/migrations/0001_initial.py

@@ -0,0 +1,73 @@
+# Generated by Django 6.0.1 on 2026-01-24 23:09
+
+import django.db.models.deletion
+import taggit.managers
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('contenttypes', '0002_remove_content_type_name'),
+        ('taggit', '0006_rename_taggeditem_content_type_object_id_taggit_tagg_content_8fc721_idx'),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Person',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(help_text='Klarname, wie er beim Lied angezeigt werden soll. Normalerweise "Vorname Nachname".', max_length=127, verbose_name='Name')),
+                ('full_name', models.CharField(blank=True, help_text='Name mit zusätzlichen Vornamen, Titeln usw.', max_length=255, verbose_name='Vollständiger Name')),
+                ('birth_name', models.CharField(blank=True, help_text='Name vor einer Namensänderung, z.B. durch Ehe.', max_length=127, verbose_name='Geburtsname')),
+                ('details_secret', models.BooleanField(default=False, help_text='Beim Lied soll nur der Alias angezeigt werden, kein Klarname und keine Lebensdaten.', verbose_name='Details geheim')),
+                ('birth_year', models.CharField(blank=True, help_text='Auch ungefähre Angaben sind erlaubt.', max_length=15, verbose_name='Geburtsjahr')),
+                ('death_year', models.CharField(blank=True, help_text='Auch ungefähre Angaben sind erlaubt.', max_length=15, verbose_name='Todesjahr')),
+                ('remarks', models.TextField(blank=True, verbose_name='Anmerkungen')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Contact',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('address', models.TextField(blank=True, help_text='Postadresse', verbose_name='Adresse')),
+                ('last_try', models.DateField(blank=True, null=True, verbose_name='letzter Kontaktversuch')),
+                ('success', models.BooleanField(blank=True, default=None, help_text='War der Kontaktversuch erfolgreich?', null=True, verbose_name='Kontakt erfolgreich?')),
+                ('remarks', models.TextField(blank=True, verbose_name='Anmerkungen')),
+                ('reference', models.ForeignKey(help_text='Person oder Verlag', on_delete=django.db.models.deletion.CASCADE, to='contenttypes.contenttype')),
+                ('user', models.ForeignKey(blank=True, help_text='Kontakt durch Projektmitarbeiter*in', null=True, on_delete=django.db.models.deletion.SET_NULL, to=settings.AUTH_USER_MODEL, verbose_name='User')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Medium',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('key', models.CharField(choices=[('Email', 'E-Mail'), ('Phone', 'Telefon'), ('Signal', 'Signal-ID')], default='Email', max_length=15, verbose_name='Art')),
+                ('value', models.CharField(help_text='Adresse bzw. Handle', max_length=127, verbose_name='Wert')),
+                ('contact', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='quellen.contact')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Identity',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('author_id', models.CharField(help_text='Wie in der LilyPond-Datei und der `authors.yml` verwendet.', max_length=127, verbose_name='Autoren-ID')),
+                ('alias', models.CharField(blank=True, help_text='Fahrtenname, Künstlername o.ä.; Spitznamen nur, wenn sie mehr sind als eine Vornamensvariante.', max_length=127, verbose_name='Alias')),
+                ('tags', taggit.managers.TaggableManager(help_text='A comma-separated list of tags.', through='taggit.TaggedItem', to='taggit.Tag', verbose_name='Tags')),
+                ('person', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='quellen.person')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='AuthorID',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('key', models.CharField(choices=[('DISCOGS', 'Discogs'), ('GND', 'DNB GND'), ('ISNI', 'ISNI'), ('LIED', 'LiederNet author'), ('BRAINZ', 'MusicBrainz'), ('ORCID', 'ORCID'), ('VIAF', 'VIAF'), ('WIKI', 'Wikidata')], default='VIAF', max_length=7, verbose_name='ID-Typ')),
+                ('value', models.CharField(help_text='ID in der Schreibweise der jeweiligen Datenbank', max_length=127, verbose_name='Wert')),
+                ('person', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='quellen.person')),
+            ],
+        ),
+    ]

liederquelle/quellen/models.py

@@ -0,0 +1,189 @@
+from django.db import models
+from taggit.managers import TaggableManager
+from django.contrib.contenttypes.fields import GenericForeignKey
+from django.contrib.contenttypes.models import ContentType
+from django.contrib.auth.models import User
+
+
+class Person(models.Model):
+    name = models.CharField(
+        verbose_name='Name',
+        max_length=127,
+        help_text='Klarname, wie er beim Lied angezeigt werden soll. Normalerweise "Vorname Nachname".',
+    )
+    full_name = models.CharField(
+        verbose_name='Vollständiger Name',
+        max_length=255, blank=True,
+        help_text='Name mit zusätzlichen Vornamen, Titeln usw.',
+    )
+    birth_name = models.CharField(
+        verbose_name='Geburtsname',
+        max_length=127, blank=True,
+        help_text='Name vor einer Namensänderung, z.B. durch Ehe.',
+    )
+    details_secret = models.BooleanField(
+        verbose_name='Details geheim',
+        default=False,
+        help_text='Beim Lied soll nur der Alias angezeigt werden, kein Klarname und keine Lebensdaten.',
+    )
+    birth_year = models.CharField(
+        verbose_name='Geburtsjahr',
+        max_length=15, blank=True,
+        help_text='Auch ungefähre Angaben sind erlaubt.',
+    )
+    death_year = models.CharField(
+        verbose_name='Todesjahr',
+        max_length=15, blank=True,
+        help_text='Auch ungefähre Angaben sind erlaubt.',
+    )
+    remarks = models.TextField(
+        verbose_name='Anmerkungen',
+        blank=True,
+        #help_text='',
+    )
+
+    class Meta:
+        verbose_name = 'Person'
+        verbose_name_plural = 'Personen'
+        ordering = ['name','birth_year']
+
+    list_display = ['name']
+
+    def __str__(self):
+        return self.name
+
+
+class Identity(models.Model):
+    person = models.ForeignKey(Person,
+        blank=False,
+        on_delete=models.CASCADE,
+    )
+    author_id = models.CharField(
+        verbose_name='Autoren-ID',
+        max_length=127,
+        help_text='Wie in der LilyPond-Datei und der `authors.yml` verwendet.',
+    )
+    alias = models.CharField(
+        verbose_name='Alias',
+        max_length=127,
+        blank=True,
+        help_text='Fahrtenname, Künstlername o.ä.; Spitznamen nur, wenn sie mehr sind als eine Vornamensvariante.',
+    )
+    tags = TaggableManager()
+
+    class Meta:
+        verbose_name = 'Identität'
+        verbose_name_plural = 'Identitäten'
+        ordering = ['author_id']
+
+    list_display = ['author_id', 'alias']
+
+    def __str__(self):
+        return "{} ({})".format(self.author_id, self.alias)
+
+
+class AuthorID(models.Model):
+    person = models.ForeignKey(Person,
+        blank=False,
+        on_delete=models.CASCADE,
+    )
+    class IDs(models.TextChoices):
+        DISCOGS = "DISCOGS", 'Discogs'
+        GND = "GND", 'DNB GND'
+        ISNI = "ISNI", 'ISNI'
+        LIED = "LIED", 'LiederNet author'
+        BRAINZ = "BRAINZ", 'MusicBrainz'
+        ORCID = "ORCID", 'ORCID'
+        VIAF = "VIAF", 'VIAF'
+        WIKI = "WIKI", 'Wikidata'
+    key = models.CharField(
+        verbose_name='ID-Typ',
+        max_length=7,
+        choices=IDs,
+        default=IDs.VIAF,
+    )
+    value = models.CharField(
+        verbose_name='Wert',
+        max_length=127,
+        blank=False,
+        help_text='ID in der Schreibweise der jeweiligen Datenbank',
+    )
+
+    class Meta:
+        verbose_name = 'Autor-ID'
+        verbose_name_plural = 'Autor-IDs'
+        ordering = ['person', 'key', 'value']
+
+    list_display = ['person', 'key', 'value']
+
+
+class Contact(models.Model):
+    reference = models.ForeignKey(ContentType,
+        on_delete = models.CASCADE,
+        help_text = 'Person oder Verlag'
+    )
+    address = models.TextField(
+        verbose_name = 'Adresse',
+        blank=True,
+        help_text = 'Postadresse',
+    )
+    last_try = models.DateField(
+        verbose_name = 'letzter Kontaktversuch',
+        blank=True,null=True,
+    )
+    user = models.ForeignKey(User,
+        verbose_name = 'User',
+        blank=True,null=True,
+        on_delete = models.SET_NULL,
+        help_text = 'Kontakt durch Projektmitarbeiter*in'
+    )
+    success = models.BooleanField(
+        verbose_name = 'Kontakt erfolgreich?',
+        blank=True,null=True,default=None,
+        help_text = 'War der Kontaktversuch erfolgreich?'
+    )
+    remarks = models.TextField(
+        verbose_name='Anmerkungen',
+        blank=True,
+        #help_text='',
+    )
+
+    class Meta:
+        verbose_name = 'Kontakt'
+        verbose_name_plural = 'Kontakte'
+        ordering = ['reference', 'last_try']
+
+    list_display = ['reference', 'last_try', 'user', 'success']
+
+
+class Medium(models.Model):
+    contact = models.ForeignKey(Contact,
+        blank=False,
+        on_delete=models.CASCADE,
+    )
+    class IDs(models.TextChoices):
+        Email = "Email", 'E-Mail'
+        Phone = "Phone", 'Telefon'
+        Signal = "Signal", 'Signal-ID'
+        Fedi = "Fedi", 'Fediverse-Handle'
+        Matrix = "Matrix", 'Matrix-ID'
+        XMPP = "XMPP", 'XMPP-ID'
+    key = models.CharField(
+        verbose_name='Art',
+        max_length=15,
+        choices=IDs,
+        default=IDs.Email,
+    )
+    value = models.CharField(
+        verbose_name='Wert',
+        max_length=127,
+        blank=False,
+        help_text='Adresse bzw. Handle',
+    )
+
+    class Meta:
+        verbose_name = 'Medium'
+        verbose_name_plural = 'Medien'
+        ordering = ['contact','key']
+
+    list_display = ['contact', 'key', 'value']

liederquelle/quellen/tests.py

@@ -0,0 +1,3 @@
+from django.test import TestCase
+
+# Create your tests here.

liederquelle/quellen/urls.py

@@ -0,0 +1,7 @@
+from django.urls import path
+
+from . import views
+
+urlpatterns = [
+    path("", views.index, name="index"),
+]

liederquelle/quellen/views.py

@@ -0,0 +1,6 @@
+from django.shortcuts import render
+from django.http import HttpResponse
+
+
+def index(request):
+    return HttpResponse("Hello, world. You're at the polls index.")

requirements.txt

@@ -0,0 +1,5 @@
+django>6,<7
+Pillow
+
+django-dotenv
+django-taggit