UI element added

- Add new "alle-kommentare" (all comments) view for staff users only
  - Allows staff to view and manage all user comments across the system
  - Grouped by document with user information displayed
  - Staff can delete any comment via the dedicated delete button
  - Restricts access via user_passes_test decorator

- Create all_comments.html template
  - Based on user_comments template with added username field
  - Shows comment author, creation time, and edit time
  - Provides delete functionality for comment management

- Update navigation menu
  - Add "Alle Kommentare" link in user dropdown menu
  - Link only visible to staff members

- Add URL route for alle-kommentare page
  - Path: /dokumente/alle-kommentare/
  - URL name: all_comments

- Bump application versions
  - Update footer version from 0.965 to 0.966
  - Update K8s deployment version from 0.917 to 0.918
  - ArgoCD deployment already at 0.966

All existing tests pass (148 tests total)

.gitea/workflows/build-containers-on-demand.yml

@@ -0,0 +1,287 @@
+name: Build containers when image tags change
+
+on:
+  push:
+    # Uncomment/adjust once working:
+    # branches: [ main ]
+    paths:
+      - "argocd/deployment.yaml"
+      - "Dockerfile"
+      - "data-loader/**"
+      - ".gitea/workflows/build-containers-on-demand.yml"
+
+jobs:
+  build-if-image-changed:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - container_name: web
+            expected_repo: git.baumann.gr/adebaumann/vui
+            build_context: .
+            container_type: containers
+            description: main container
+          - container_name: loader
+            expected_repo: git.baumann.gr/adebaumann/vui-data-loader
+            build_context: data-loader
+            container_type: initContainers
+            description: init-container
+
+    env:
+      DEPLOY_FILE: "argocd/deployment.yaml"
+      CONTAINER_NAME: ${{ matrix.container_name }}
+      EXPECTED_REPO: ${{ matrix.expected_repo }}
+      CONTAINER_TYPE: ${{ matrix.container_type }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - name: Determine base commit
+        id: base
+        shell: bash
+        run: |
+          set -euo pipefail
+          if git rev-parse --verify -q HEAD~1 >/dev/null; then
+            echo "base=$(git rev-parse HEAD~1)" >> "$GITHUB_OUTPUT"
+          else
+            echo "base=$(git hash-object -t tree /dev/null)" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Install yq
+        shell: bash
+        run: |
+          set -euo pipefail
+          YQ_VER=v4.44.3
+          curl -sL "https://github.com/mikefarah/yq/releases/download/${YQ_VER}/yq_linux_amd64" -o /usr/local/bin/yq
+          chmod +x /usr/local/bin/yq
+          yq --version
+
+      - name: Read ${{ matrix.description }} image from deployment (old vs new)
+        id: img
+        shell: bash
+        run: |
+          set -euo pipefail
+          file="${DEPLOY_FILE:-argocd/deployment.yaml}"
+          cname="${CONTAINER_NAME}"
+          expected_repo="${EXPECTED_REPO}"
+          ctype="${CONTAINER_TYPE}"
+
+          export cname
+          export expected_repo
+          export ctype
+
+          echo "========================================"
+          echo "Checking: $ctype / $cname"
+          echo "Expected repo: $expected_repo"
+          echo "========================================"
+
+          # --- functions ------------------------------------------------------
+          have_yq() { command -v yq >/dev/null 2>&1; }
+
+          # yq-based extractor (multi-doc aware; Deployment only; container name match)
+          yq_extract() {
+            if [[ "$ctype" == "initContainers" ]]; then
+              yq -r '
+                select(.kind == "Deployment") |
+                .spec.template.spec.initContainers // [] |
+                map(select(.name == env(cname))) |
+                .[]?.image
+              ' "$1" 2>/dev/null | tail -n 1
+            else
+              yq -r '
+                select(.kind == "Deployment") |
+                .spec.template.spec.containers // [] |
+                map(select(.name == env(cname))) |
+                .[]?.image
+              ' "$1" 2>/dev/null | tail -n 1
+            fi
+          }
+
+          # ultra-tolerant fallback: grep around the appropriate block
+          fallback_extract() {
+            local block_pattern
+            local end_pattern
+
+            if [[ "$ctype" == "initContainers" ]]; then
+              block_pattern="^[[:space:]]*initContainers:"
+              end_pattern="^[[:space:]]*containers:|^[[:alpha:]][[:alnum:]_:-]*:"
+            else
+              block_pattern="^[[:space:]]*containers:"
+              end_pattern="^[[:alpha:]][[:alnum:]_:-]*:|^[[:space:]]*initContainers:"
+            fi
+
+            awk -v cname="$cname" -v block="$block_pattern" -v endp="$end_pattern" '
+              BEGIN{ in_cont=0; name=""; image="" }
+              $0 ~ block {in_cont=1; next}
+              in_cont {
+                # end of block when we hit the end pattern
+                if ($0 ~ endp) { in_cont=0 }
+                # capture name and image lines
+                if ($0 ~ /^[[:space:]]*-?[[:space:]]*name:[[:space:]]*/) {
+                  name=$0; sub(/^.*name:[[:space:]]*/,"",name); gsub(/^[ "\047]+|[ "\047]+$/,"",name)
+                }
+                if ($0 ~ /^[[:space:]]*image:[[:space:]]*/) {
+                  image=$0; sub(/^.*image:[[:space:]]*/,"",image); gsub(/^[ "\047]+|[ "\047]+$/,"",image)
+                  if (name==cname) { print image; exit }
+                }
+              }
+            ' "$1"
+          }
+
+          list_workload_images() {
+            echo "== workload $ctype in $1 ==" >&2
+            if have_yq; then
+              if [[ "$ctype" == "initContainers" ]]; then
+                yq -r '
+                  select(.kind == "Deployment") |
+                  .spec.template.spec.initContainers // [] |
+                  .[] | "\(.name): \(.image)"
+                ' "$1" 2>/dev/null | nl -ba >&2 || true
+              else
+                yq -r '
+                  select(.kind == "Deployment") |
+                  .spec.template.spec.containers // [] |
+                  .[] | "\(.name): \(.image)"
+                ' "$1" 2>/dev/null | nl -ba >&2 || true
+              fi
+            else
+              # coarse list for visibility
+              if [[ "$ctype" == "initContainers" ]]; then
+                awk '
+                  /^ *initContainers:/, /^ *containers:/ { if ($0 ~ /name:|image:/) print }
+                ' "$1" | nl -ba >&2 || true
+              else
+                awk '
+                  /^ *containers:/, /^[^ ]/ { if ($0 ~ /name:|image:/) print }
+                ' "$1" | nl -ba >&2 || true
+              fi
+            fi
+          }
+          # --------------------------------------------------------------------
+
+          # Ensure yq is present; if install failed earlier, try once more
+          if ! have_yq; then
+            echo "yq missing; attempting quick install..." >&2
+            curl -fsSL https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 -o /usr/local/bin/yq || true
+            chmod +x /usr/local/bin/yq || true
+          fi
+
+          # Prepare old file (previous commit) if exists
+          if git cat-file -e "${{ steps.base.outputs.base }}":"$file" 2>/dev/null; then
+            git show "${{ steps.base.outputs.base }}:$file" > /tmp/old.yaml
+          else
+            : > /tmp/old.yaml
+          fi
+
+          list_workload_images /tmp/old.yaml || true
+          list_workload_images "$file" || true
+
+          if have_yq; then
+            old_image="$(yq_extract /tmp/old.yaml || true)"
+            new_image="$(yq_extract "$file" || true)"
+          else
+            old_image="$(fallback_extract /tmp/old.yaml || true)"
+            new_image="$(fallback_extract "$file" || true)"
+          fi
+
+          # If yq path failed to find it, try fallback once more as safety
+          if [ -z "${new_image:-}" ]; then
+            new_image="$(fallback_extract "$file" || true)"
+          fi
+          if [ -z "${old_image:-}" ]; then
+            old_image="$(fallback_extract /tmp/old.yaml || true)"
+          fi
+
+          echo "Old $ctype image: ${old_image:-<none>}"
+          echo "New $ctype image: ${new_image:-<none>}"
+
+          if [ -z "${new_image:-}" ]; then
+            echo "ERROR: Could not find $ctype[].name == \"$cname\" image in $file"
+            exit 1
+          fi
+
+          # Split repo and tag
+          new_repo="${new_image%:*}"
+          new_tag="${new_image##*:}"
+          if [[ "$new_repo" != "$expected_repo" ]]; then
+            echo "ERROR: Found $ctype \"$cname\" image repo is \"$new_repo\" but expected \"$expected_repo\""
+            exit 1
+          fi
+
+          registry="$(echo "$new_repo" | awk -F/ '{print $1}')"
+
+          {
+            echo "new_image=$new_image"
+            echo "new_repo=$new_repo"
+            echo "new_tag=$new_tag"
+            echo "registry=$registry"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Check if image exists on registry
+        id: check_image
+        shell: bash
+        run: |
+          set -euo pipefail
+          new_repo="${{ steps.img.outputs.new_repo }}"
+          new_tag="${{ steps.img.outputs.new_tag }}"
+          registry_user="${{ secrets.REGISTRY_USER }}"
+          registry_password="${{ secrets.REGISTRY_PASSWORD }}"
+
+          # Extract registry host and image name
+          registry_host=$(echo "$new_repo" | cut -d/ -f1)
+          image_path=$(echo "$new_repo" | cut -d/ -f2-)
+
+          echo "Checking if $new_repo:$new_tag exists on registry $registry_host"
+
+          # Use Docker Registry API v2 to check manifest
+          # Format: https://registry/v2/{image_path}/manifests/{tag}
+          manifest_url="https://${registry_host}/v2/${image_path}/manifests/${new_tag}"
+
+          # Check with authentication
+          http_code=$(curl -s -o /dev/null -w "%{http_code}" \
+            -u "${registry_user}:${registry_password}" \
+            -H "Accept: application/vnd.docker.distribution.manifest.v2+json,application/vnd.docker.distribution.manifest.list.v2+json" \
+            "$manifest_url" || echo "000")
+
+          if [ "$http_code" = "200" ]; then
+            echo "Image already exists on registry (HTTP $http_code)"
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "Image does not exist on registry (HTTP $http_code)"
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Skip if image already exists
+        if: steps.check_image.outputs.exists == 'true'
+        run: echo "${{ matrix.description }} image ${{ steps.img.outputs.new_image }} already exists on registry; skipping build."
+
+      - name: Set up Buildx
+        if: steps.check_image.outputs.exists == 'false'
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to registry
+        if: steps.check_image.outputs.exists == 'false'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ steps.img.outputs.registry }}
+          username: ${{ secrets.REGISTRY_USER }}
+          password: ${{ secrets.REGISTRY_PASSWORD }}
+
+      - name: Build and push ${{ matrix.description }} (exact tag from deployment)
+        if: steps.check_image.outputs.exists == 'false'
+        uses: docker/build-push-action@v6
+        with:
+          context: ${{ matrix.build_context }}
+          push: true
+          tags: |
+            ${{ steps.img.outputs.new_image }}
+            ${{ steps.img.outputs.new_repo }}:latest
+          labels: |
+            org.opencontainers.image.source=${{ gitea.repository }}
+            org.opencontainers.image.revision=${{ gitea.sha }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.gitea/workflows/check_code_in_sonarqube.yaml

@@ -0,0 +1,67 @@
+on:
+  push:
+    # branches:
+      # - main
+      # - development
+  pull_request:
+      types: [opened, synchronize, reopened]
+
+name: SonarQube Scan
+jobs:
+  sonarqube:
+    name: SonarQube Trigger
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checking out
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+
+    - name: Install dependencies
+      run: |
+        pip install -r requirements.txt
+
+    - name: Run tests with coverage
+      run: |
+        coverage run --source='.' manage.py test
+        coverage xml
+
+    - name: Set up JDK 17
+      uses: actions/setup-java@v3
+      with:
+        java-version: '17'
+        distribution: 'temurin'
+
+    - name: Cache SonarQube packages
+      uses: actions/cache@v3
+      with:
+        path: ~/.sonar/cache
+        key: ${{ runner.os }}-sonar
+        restore-keys: ${{ runner.os }}-sonar
+
+    - name: Download and setup SonarScanner
+      run: |
+        mkdir -p $HOME/.sonar
+        wget -q https://binaries.sonarsource.com/Distribution/sonar-scanner-cli/sonar-scanner-cli-5.0.1.3006-linux.zip
+        unzip -q sonar-scanner-cli-5.0.1.3006-linux.zip -d $HOME/.sonar/
+        echo "$HOME/.sonar/sonar-scanner-5.0.1.3006-linux/bin" >> $GITHUB_PATH
+
+    - name: Verify Java version
+      run: java -version
+
+    - name: SonarQube Scan
+      env:
+        SONAR_HOST_URL: ${{ secrets.SONARQUBE_HOST }}
+        SONAR_TOKEN: ${{ secrets.SONARQUBE_TOKEN }}
+      run: |
+        sonar-scanner \
+          -Dsonar.projectKey=${{ github.event.repository.name }} \
+          -Dsonar.sources=. \
+          -Dsonar.host.url=${SONAR_HOST_URL} \
+          -Dsonar.token=${SONAR_TOKEN} \
+          -Dsonar.python.coverage.reportPaths=coverage.xml

.gitignore

@@ -1,4 +1,3 @@
-r0126.txt
 __pycache__/
 **/*.pyc
 lib/
@@ -7,5 +6,14 @@ bin/
 pyvenv.cfg
 include/
 keys/
-
+.venv/
+.idea/
 *.kate-swp
+node_modules/
+package-lock.json
+package.json
+AGENT*.md
+# Diagram cache directory
+media/diagram_cache/
+.env
+data/db.sqlite3

Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.13-slim AS baustelle
+FROM python:3.14 AS baustelle
 RUN mkdir /app
 WORKDIR /app
 ENV PYTHONDONTWRITEBYTECODE=1
@@ -7,20 +7,30 @@ RUN pip install  --upgrade pip
 COPY requirements.txt /app/
 RUN pip install --no-cache-dir -r requirements.txt
 
-FROM python:3.13-slim
+FROM python:3.14-slim
 RUN useradd -m -r appuser && \
     mkdir /app && \
     chown -R appuser /app
 
-COPY --from=baustelle /usr/local/lib/python3.13/site-packages/ /usr/local/lib/python3.13/site-packages/
+COPY --from=baustelle /usr/local/lib/python3.14/site-packages/ /usr/local/lib/python3.14/site-packages/
 COPY --from=baustelle /usr/local/bin/ /usr/local/bin/
-RUN rm /usr/bin/tar
-RUN rm /usr/lib/x86_64-linux-gnu/libncur*
+RUN rm /usr/bin/tar /usr/lib/x86_64-linux-gnu/libncur*
 WORKDIR /app
 COPY --chown=appuser:appuser . .
 ENV PYTHONDONTWRITEBYTECODE=1
 ENV PYTHONUNBUFFERED=1
 USER appuser
 EXPOSE 8000
+RUN rm -rvf /app/Dockerfile* \
+           /app/README.md \
+           /app/argocd \
+           /app/k8s \
+           /app/data-loader \
+           /app/keys \
+           /app/requirements.txt \
+           /app/node_modules \
+           /app/*.json \
+           /app/test_*.py && \
+       python3 /app/manage.py collectstatic --noinput
 CMD ["gunicorn","--bind","0.0.0.0:8000","--workers","3","VorgabenUI.wsgi:application"]
 

Documentation/ArgoCD.md

@@ -0,0 +1,241 @@
+# ArgoCD Configuration Documentation
+
+## Overview
+This directory contains the ArgoCD application manifests for deploying the VorgabenUI application and its dependencies to Kubernetes.
+
+## Files
+
+### Application Manifests
+
+#### `001_pvc.yaml`
+- **Purpose**: PersistentVolumeClaim for Django application data
+- **Storage**: 2Gi storage with ReadWriteMany access mode
+- **Storage Class**: Uses NFS storage class for shared storage across multiple pods
+- **Namespace**: vorgabenui
+
+#### `deployment.yaml`
+- **Purpose**: Main application deployment configuration
+- **Contains**: Django application container, environment variables, resource limits
+- **Replicas**: Configurable replica count for high availability
+
+#### `ingress.yaml`
+- **Purpose**: External access configuration
+- **Host**: Configurable hostname for the application
+- **TLS**: SSL/TLS termination configuration
+- **Backend**: Routes traffic to the Django application service
+
+#### `nfs-pv.yaml`
+- **Purpose**: PersistentVolume definition for NFS storage
+- **Server**: 192.168.17.199
+- **Path**: /mnt/user/vorgabenui
+- **Access**: ReadWriteMany for multi-pod access
+- **Reclaim Policy**: Retain (data preserved after PVC deletion)
+
+#### `nfs-storageclass.yaml`
+- **Purpose**: StorageClass definition for NFS volumes
+- **Provisioner**: kubernetes.io/no-provisioner (static provisioning)
+- **Volume Expansion**: Enabled for growing storage capacity
+- **Binding Mode**: Immediate (binds PV to PVC as soon as possible)
+
+#### `diagrammer.yaml`
+- **Purpose**: Deployment configuration for the diagram generation service
+- **Function**: Handles diagram creation and caching for the application
+
+## NFS Storage Configuration
+
+### Prerequisites
+1. NFS server must be running at 192.168.17.199
+2. The directory `/mnt/user/vorgabenui` must exist and be exported
+3. Kubernetes nodes must have NFS client utilities installed
+4. For MicroK8s: `microk8s enable nfs`
+
+## MicroK8s Addons Required
+
+### Required Addons
+Enable the following MicroK8s addons before deployment:
+
+```bash
+# Enable storage and NFS support
+sudo microk8s enable storage
+sudo microk8s enable nfs
+
+# Enable ingress for external access
+sudo microk8s enable ingress
+
+# Enable DNS for service discovery
+sudo microk8s enable dns
+
+# Optional: Enable metrics for monitoring
+sudo microk8s enable metrics-server
+```
+
+### Addon Descriptions
+
+#### `storage`
+- **Purpose**: Provides default storage class for persistent volumes
+- **Required for**: Basic PVC functionality
+- **Note**: Works alongside our custom NFS storage class
+
+#### `nfs`
+- **Purpose**: Installs NFS client utilities on all MicroK8s nodes
+- **Required for**: Mounting NFS volumes in pods
+- **Components**: Installs `nfs-common` package with mount helpers
+
+#### `ingress`
+- **Purpose**: Provides Ingress controller for external HTTP/HTTPS access
+- **Required for**: `ingress.yaml` to function properly
+- **Implementation**: Uses NGINX Ingress Controller
+
+#### `dns`
+- **Purpose**: Provides DNS service for service discovery within cluster
+- **Required for**: Inter-service communication
+- **Note**: Usually enabled by default in MicroK8s
+
+#### `metrics-server` (Optional)
+- **Purpose**: Enables resource usage monitoring
+- **Required for**: `kubectl top` commands and HPA (Horizontal Pod Autoscaling)
+- **Recommended for**: Production monitoring
+
+### Addon Verification
+After enabling addons, verify they are running:
+
+```bash
+# Check addon status
+microk8s status
+
+# Check pods in kube-system namespace
+microk8s kubectl get pods -n kube-system
+
+# Check storage classes
+microk8s kubectl get storageclass
+
+# Check ingress controller
+microk8s kubectl get pods -n ingress
+```
+
+### Troubleshooting Addons
+
+#### NFS Addon Issues
+```bash
+# Check if NFS utilities are installed
+which mount.nfs
+
+# Manually install if addon fails
+sudo apt update && sudo apt install nfs-common
+
+# Restart MicroK8s after manual installation
+sudo microk8s restart
+```
+
+#### Ingress Issues
+```bash
+# Check ingress controller pods
+microk8s kubectl get pods -n ingress
+
+# Check ingress services
+microk8s kubectl get svc -n ingress
+
+# Test ingress connectivity
+curl -k https://your-domain.com
+```
+
+#### Storage Issues
+```bash
+# List available storage classes
+microk8s kubectl get storageclass
+
+# Check default storage class
+microk8s kubectl get storageclass -o yaml
+```
+
+### Storage Architecture
+- **Storage Class**: `nfs` - Static provisioning for NFS shares
+- **Persistent Volume**: Pre-provisioned PV pointing to NFS server
+- **Persistent Volume Claim**: Claims the NFS storage for application use
+- **Access Mode**: ReadWriteMany allows multiple pods to access the same data
+
+### NFS Server Setup
+On the NFS server (192.168.17.199), ensure the following:
+
+```bash
+# Create the shared directory
+sudo mkdir -p /mnt/user/vorgabenui
+sudo chmod 755 /mnt/user/vorgabenui
+
+# Add to /etc/exports
+echo "/mnt/user/vorgabenui *(rw,sync,no_subtree_check,no_root_squash)" | sudo tee -a /etc/exports
+
+# Export the directory
+sudo exportfs -a
+sudo systemctl restart nfs-kernel-server
+```
+
+## Deployment Order
+
+1. **StorageClass** (`nfs-storageclass.yaml`) - Defines NFS storage class
+2. **PersistentVolume** (`nfs-pv.yaml`) - Creates the NFS volume
+3. **PersistentVolumeClaim** (`001_pvc.yaml`) - Claims storage for application
+4. **Application Deployments** (`deployment.yaml`, `diagrammer.yaml`) - Deploy application services
+5. **Ingress** (`ingress.yaml`) - Configure external access
+
+## Configuration Notes
+
+### Namespace
+All resources are deployed to the `vorgabenui` namespace.
+
+### Storage Sizing
+- Current allocation: 2Gi
+- Volume expansion is enabled through the StorageClass
+- Monitor usage and adjust PVC size as needed
+
+### Access Control
+- NFS export uses `no_root_squash` for container root access
+- Ensure proper network security between Kubernetes nodes and NFS server
+- Consider implementing network policies for additional security
+
+## Troubleshooting
+
+### Common Issues
+
+#### Mount Failures
+- **Error**: "bad option; for several filesystems you might need a /sbin/mount.<type> helper program"
+- **Solution**: Install NFS client utilities or enable NFS addon in MicroK8s
+
+#### Permission Issues
+- **Error**: Permission denied when accessing mounted volume
+- **Solution**: Check NFS export permissions and ensure `no_root_squash` is set
+
+#### Network Connectivity
+- **Error**: Connection timeout to NFS server
+- **Solution**: Verify network connectivity and firewall rules between nodes and NFS server
+
+### Debug Commands
+```bash
+# Check PVC status
+kubectl get pvc -n vorgabenui
+
+# Check PV status
+kubectl get pv
+
+# Describe PVC for detailed information
+kubectl describe pvc django-data-pvc -n vorgabenui
+
+# Check pod mount status
+kubectl describe pod <pod-name> -n vorgabenui
+```
+
+## Maintenance
+
+### Backup Strategy
+- The NFS server should have regular backups of `/mnt/user/vorgabenui`
+- Consider snapshot capabilities if using enterprise NFS solutions
+
+### Monitoring
+- Monitor NFS server performance and connectivity
+- Track storage usage and plan capacity upgrades
+- Monitor pod restarts related to storage issues
+
+### Updates
+- When updating storage configuration, update PV first, then PVC
+- Test changes in non-production environment first
+- Ensure backward compatibility when modifying NFS exports

Documentation/DIAGRAM_CACHING.md

@@ -0,0 +1,105 @@
+# Diagram POST Caching Implementation
+
+This feature replaces the URL-encoded GET approach for diagram generation with POST requests and local filesystem caching.
+
+## Changes Overview
+
+### New Files
+- `diagramm_proxy/__init__.py` - Module initialization
+- `diagramm_proxy/diagram_cache.py` - Caching logic and POST request handling
+- `abschnitte/management/commands/clear_diagram_cache.py` - Management command for cache clearing
+
+### Modified Files
+- `abschnitte/utils.py` - Updated `render_textabschnitte()` to use caching
+- `.gitignore` - Added cache directory exclusion
+
+## Configuration Required
+
+Add to your Django settings file (e.g., `VorgabenUI/settings.py`):
+
+```python
+# Diagram cache settings
+DIAGRAM_CACHE_DIR = 'diagram_cache'  # relative to MEDIA_ROOT
+
+# Ensure MEDIA_ROOT and MEDIA_URL are configured
+MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
+MEDIA_URL = '/media/'
+```
+
+### URL Configuration
+
+Ensure media files are served in development. In your main `urls.py`:
+
+```python
+from django.conf import settings
+from django.conf.urls.static import static
+
+# ... existing urlpatterns ...
+
+# Serve media files in development
+if settings.DEBUG:
+    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
+```
+
+## How It Works
+
+1. When a diagram is rendered, the system computes a SHA256 hash of the diagram content
+2. It checks if a cached SVG exists for that hash
+3. If cached: serves the existing file
+4. If not cached: POSTs content to Kroki server, saves the response, and serves it
+5. Diagrams are served from `MEDIA_URL/diagram_cache/{type}/{hash}.svg`
+
+## Benefits
+
+- **No URL length limitations** - Content is POSTed instead of URL-encoded
+- **Improved performance** - Cached diagrams are served directly from filesystem
+- **Reduced server load** - Kroki server is only called once per unique diagram
+- **Persistent cache** - Survives application restarts
+- **Better error handling** - Graceful fallback on generation failures
+
+## Usage
+
+### Viewing Diagrams
+No changes required - diagrams will be automatically cached on first render.
+
+### Clearing Cache
+
+Clear all cached diagrams:
+```bash
+python manage.py clear_diagram_cache
+```
+
+Clear diagrams of a specific type:
+```bash
+python manage.py clear_diagram_cache --type plantuml
+python manage.py clear_diagram_cache --type mermaid
+```
+
+## Testing
+
+1. Create or view a page with diagrams
+2. Verify diagrams render correctly
+3. Check that `media/diagram_cache/` directory is created with cached SVGs
+4. Refresh the page - second load should be faster (cache hit)
+5. Check logs for cache hit/miss messages
+6. Test cache clearing command
+
+## Migration Notes
+
+- Existing diagrams will be regenerated on first view after deployment
+- The old URL-based approach is completely replaced
+- No database migrations needed
+- Ensure `requests` library is installed (already in requirements.txt)
+
+## Troubleshooting
+
+### Diagrams not rendering
+- Check that MEDIA_ROOT and MEDIA_URL are configured correctly
+- Verify Kroki server is accessible at `http://svckroki:8000`
+- Check application logs for error messages
+- Ensure media directory is writable
+
+### Cache not working
+- Verify Django storage configuration
+- Check file permissions on media/diagram_cache directory
+- Review logs for cache-related errors

Documentation/Datei-importieren.md

@@ -0,0 +1,491 @@
+# Dokumenten-Import: Anleitung
+
+Diese Anleitung beschreibt, wie Dokumente und Vorgaben mittels des `import-document` Management Commands in die VorgabenUI importiert werden können.
+
+## Übersicht
+
+Der `import-document` Command ermöglicht es, strukturierte Textdateien zu importieren, die Dokumente mit Einleitung, Geltungsbereich und Vorgaben enthalten. Das Format ist speziell für die einfache Erfassung und Pflege von IT-Sicherheitsstandards konzipiert.
+
+## Grundlegende Verwendung
+
+### Minimaler Aufruf
+
+```bash
+python manage.py import-document <dateipfad> \
+  --nummer <dokumentnummer> \
+  --name "<dokumentname>" \
+  --dokumententyp "<typ>"
+```
+
+### Beispiel
+
+```bash
+python manage.py import-document Documentation/import\ formats/r009.txt \
+  --nummer "R0009" \
+  --name "Serversysteme" \
+  --dokumententyp "Standard IT-Sicherheit"
+```
+
+## Parameter
+
+### Pflichtparameter
+
+| Parameter | Beschreibung | Beispiel |
+|-----------|--------------|----------|
+| `file_path` | Pfad zur Importdatei | `Documentation/import formats/r009.txt` |
+| `--nummer` | Dokumentnummer (eindeutig) | `R0009`, `R0066` |
+| `--name` | Dokumentname | `"Logging"`, `"Serversysteme"` |
+| `--dokumententyp` | Dokumententyp (muss bereits existieren) | `"Standard IT-Sicherheit"` |
+
+### Optionale Parameter
+
+| Parameter | Beschreibung | Verwendung |
+|-----------|--------------|------------|
+| `--gueltigkeit_von` | Startdatum der Gültigkeit | `--gueltigkeit_von 2024-01-01` |
+| `--gueltigkeit_bis` | Enddatum der Gültigkeit | `--gueltigkeit_bis 2025-12-31` |
+| `--dry-run` | Testlauf ohne Datenbankänderungen | `--dry-run` |
+| `--verbose` | Ausführliche Ausgabe (mit `--dry-run`) | `--dry-run --verbose` |
+| `--purge` | Löscht bestehende Einleitung/Geltungsbereich/Vorgaben vor Import | `--purge` |
+
+### Dry-Run Modus
+
+Der Dry-Run Modus ist besonders nützlich zum Testen:
+
+```bash
+python manage.py import-document r009.txt \
+  --nummer "R0009" \
+  --name "Serversysteme" \
+  --dokumententyp "Standard IT-Sicherheit" \
+  --dry-run --verbose
+```
+
+Dies zeigt an, was importiert würde, ohne die Datenbank zu ändern.
+
+### Purge Modus
+
+**Achtung:** Der Purge-Modus löscht alle bestehenden Vorgaben des Dokuments!
+
+```bash
+python manage.py import-document r009.txt \
+  --nummer "R0009" \
+  --name "Serversysteme" \
+  --dokumententyp "Standard IT-Sicherheit" \
+  --purge
+```
+
+Nutzen Sie `--dry-run --purge` zuerst, um zu sehen, was gelöscht würde.
+
+## Dateiformat
+
+### Grundstruktur
+
+Die Importdatei ist eine Textdatei (UTF-8 kodiert) mit speziellen Trennzeichen `>>>` am Zeilenanfang.
+
+### Aufbau
+
+```
+>>>Einleitung
+>>>text
+[Einleitungstext]
+
+>>>Geltungsbereich
+>>>text
+[Geltungsbereichstext]
+
+>>>Vorgabe [Thema]
+>>>Nummer [nummer]
+>>>Titel
+[Titel der Vorgabe]
+>>>Kurztext
+>>>Text
+[Kurztext-Inhalt]
+>>>Langtext
+>>>Text
+[Langtext-Inhalt]
+>>>Stichworte
+[Stichwort1, Stichwort2, ...]
+>>>Checkliste
+[Frage 1]
+[Frage 2]
+```
+
+### Abschnitt-Trenner
+
+Jeder Abschnitt beginnt mit `>>>` gefolgt vom Abschnittstyp:
+
+- `>>>Einleitung` - Startet den Einleitungsbereich
+- `>>>Geltungsbereich` - Startet den Geltungsbereichsbereich
+- `>>>Vorgabe [Thema]` - Startet eine neue Vorgabe mit angegebenem Thema
+
+### Abschnitttypen für Textinhalte
+
+Nach `>>>Einleitung`, `>>>Geltungsbereich`, `>>>Kurztext` oder `>>>Langtext` folgt ein Abschnitttyp:
+
+| Typ | Verwendung | Beispiel |
+|-----|------------|----------|
+| `>>>text` oder `>>>Text` | Normaler Fliesstext | `>>>text` |
+| `>>>liste geordnet` oder `>>>Liste geordnet` | Nummerierte Liste | `>>>Liste geordnet` |
+| `>>>liste ungeordnet` oder `>>>Liste ungeordnet` | Aufzählungsliste | `>>>liste ungeordnet` |
+
+**Hinweis:** Gross-/Kleinschreibung und Bindestriche (`liste-ungeordnet`) werden normalisiert.
+
+## Beispiele
+
+### Beispiel 1: Einfaches Dokument mit einer Vorgabe
+
+```
+>>>Einleitung
+>>>text
+Dieser Standard definiert Anforderungen für XYZ.
+
+>>>Geltungsbereich
+>>>text
+Dieser Standard gilt für alle Systeme im BIT.
+
+>>>Vorgabe Technik
+>>>Nummer 1
+>>>Titel
+Verschlüsselung verwenden
+>>>Kurztext
+>>>Text
+Alle Verbindungen müssen verschlüsselt sein.
+>>>Langtext
+>>>Text
+Die Verschlüsselung muss mindestens TLS 1.2 verwenden.
+Es sind folgende Cipher Suites erlaubt:
+>>>Liste ungeordnet
+TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
+TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
+>>>Stichworte
+Verschlüsselung, TLS, Kryptographie
+>>>Checkliste
+TLS 1.2 oder höher ist konfiguriert
+Schwache Cipher Suites sind deaktiviert
+```
+
+### Beispiel 2: Mehrere Vorgaben mit gleichem Thema
+
+```
+>>>Vorgabe Organisation
+>>>Nummer 1
+>>>Titel
+CMDB-Erfassung
+>>>Kurztext
+>>>Text
+Alle Assets müssen in der CMDB erfasst sein.
+>>>Langtext
+>>>Text
+Jedes Asset muss dokumentiert werden...
+
+>>>Vorgabe Organisation
+>>>Nummer 2
+>>>Titel
+Verantwortlichkeiten
+>>>Kurztext
+>>>Text
+Verantwortlichkeiten müssen definiert sein.
+>>>Langtext
+>>>Text
+Für jedes System muss ein Verantwortlicher...
+```
+
+### Beispiel 3: Verschiedene Themen
+
+```
+>>>Vorgabe Technik
+>>>Nummer 1
+>>>Titel
+Firewall-Konfiguration
+>>>Kurztext
+>>>Text
+Lokale Firewall muss aktiviert sein.
+>>>Langtext
+>>>Text
+Details zur Firewall-Konfiguration...
+
+>>>Vorgabe Organisation
+>>>Nummer 1
+>>>Titel
+Dokumentation
+>>>Kurztext
+>>>Text
+Konfiguration muss dokumentiert sein.
+>>>Langtext
+>>>Text
+Die Firewall-Regeln müssen...
+
+>>>Vorgabe Informationen
+>>>Nummer 1
+>>>Titel
+Datenklassifizierung
+>>>Kurztext
+>>>Text
+Daten müssen klassifiziert werden.
+>>>Langtext
+>>>Text
+Klassifizierungsstufen sind...
+```
+
+### Beispiel 4: Mehrere Textabschnitte
+
+```
+>>>Vorgabe Technik
+>>>Nummer 1
+>>>Titel
+Komplexe Anforderung
+>>>Kurztext
+>>>Text
+Erste Zusammenfassung.
+>>>Langtext
+>>>Text
+Erster Absatz mit Details.
+>>>Text
+Zweiter Absatz mit weiteren Informationen.
+>>>Liste ungeordnet
+Punkt 1
+Punkt 2
+Punkt 3
+>>>Text
+Abschliessender Text nach der Liste.
+```
+
+## Vorgaben-Struktur
+
+### Vorgabe-Header
+
+```
+>>>Vorgabe [Thema]
+```
+
+Das Thema muss in der Datenbank bereits als `Thema`-Objekt existieren. Übliche Themen:
+- Organisation
+- Technik
+- Informationen
+- Systeme
+- Anwendungen
+- Zonen
+
+### Vorgabe-Felder
+
+#### Nummer (Pflicht)
+
+```
+>>>Nummer 1
+```
+
+oder inline:
+
+```
+>>>Nummer: 1
+```
+
+Die Nummer wird als Integer gespeichert. Sie ist eindeutig innerhalb eines Dokuments und Themas.
+
+#### Titel (Pflicht)
+
+```
+>>>Titel
+Titel der Vorgabe
+```
+
+oder inline:
+
+```
+>>>Titel: Titel der Vorgabe
+```
+
+#### Kurztext (Optional)
+
+```
+>>>Kurztext
+>>>Text
+Kurze Zusammenfassung der Vorgabe.
+```
+
+#### Langtext (Optional)
+
+```
+>>>Langtext
+>>>Text
+Ausführliche Beschreibung der Vorgabe.
+>>>Liste ungeordnet
+Punkt 1
+Punkt 2
+```
+
+#### Stichworte (Optional)
+
+Komma-getrennte Liste:
+
+```
+>>>Stichworte
+Firewall, Netzwerk, Sicherheit
+```
+
+oder als Block:
+
+```
+>>>Stichworte
+>>>Text
+Firewall, Netzwerk, Sicherheit
+```
+
+**Hinweis:** Stichworte werden automatisch in der Datenbank angelegt, falls sie noch nicht existieren.
+
+#### Checkliste (Optional)
+
+```
+>>>Checkliste
+Ist die Firewall aktiviert?
+Sind alle unnötigen Ports geschlossen?
+Wurde die Konfiguration dokumentiert?
+```
+
+Jede Zeile wird als separate Checklistenfrage gespeichert.
+
+## Tipps und Best Practices
+
+### 1. Dry-Run vor Import
+
+Führen Sie immer zuerst einen Dry-Run durch:
+
+```bash
+python manage.py import-document datei.txt \
+  --nummer "R0XXX" \
+  --name "Test" \
+  --dokumententyp "Standard IT-Sicherheit" \
+  --dry-run --verbose
+```
+
+### 2. Themen vorab erstellen
+
+Stellen Sie sicher, dass alle verwendeten Themen in der Datenbank existieren:
+
+```python
+python manage.py shell
+>>> from dokumente.models import Thema
+>>> Thema.objects.get_or_create(name="Organisation")
+>>> Thema.objects.get_or_create(name="Technik")
+>>> Thema.objects.get_or_create(name="Informationen")
+```
+
+### 3. Dokumententyp vorab erstellen
+
+Der Dokumententyp muss existieren:
+
+```python
+python manage.py shell
+>>> from dokumente.models import Dokumententyp
+>>> Dokumententyp.objects.get_or_create(
+...     name="Standard IT-Sicherheit",
+...     defaults={"verantwortliche_ve": "SR-SUR-SEC"}
+... )
+```
+
+### 4. Abschnitttypen prüfen
+
+Folgende Abschnitttypen müssen in der Datenbank existieren:
+- `text`
+- `liste geordnet`
+- `liste ungeordnet`
+- `code`
+- `diagramm`
+
+Prüfen Sie diese in der Autorenumgebung unter "Abschnitttypen".
+
+### 5. UTF-8 Kodierung
+
+Stellen Sie sicher, dass Ihre Importdatei UTF-8 kodiert ist, besonders bei Umlauten (ä, ö, ü) und Sonderzeichen.
+
+### 6. Versionierung mit Purge
+
+Beim Re-Import mit `--purge`:
+
+```bash
+# 1. Backup erstellen
+python manage.py dumpdata dokumente.Dokument dokumente.Vorgabe > backup.json
+
+# 2. Import mit Purge
+python manage.py import-document datei.txt \
+  --nummer "R0009" \
+  --name "Serversysteme" \
+  --dokumententyp "Standard IT-Sicherheit" \
+  --purge
+```
+
+### 7. Mehrzeilige Inhalte
+
+Mehrzeiliger Text wird automatisch erkannt:
+
+```
+>>>Langtext
+>>>Text
+Dies ist Zeile 1.
+Dies ist Zeile 2.
+
+Dies ist ein neuer Absatz.
+```
+
+### 8. Leerzeilen
+
+Leerzeilen innerhalb eines Abschnitts werden beibehalten. Eine Leerzeile nach einem `>>>`-Trenner wird ignoriert.
+
+## Fehlerbehebung
+
+### "Dokumententyp does not exist"
+
+Der angegebene Dokumententyp existiert nicht in der Datenbank.
+
+**Lösung:** Erstellen Sie den Dokumententyp in der Autorenumgebung oder per Shell.
+
+### "Thema not found, skipping Vorgabe"
+
+Das in der Vorgabe verwendete Thema existiert nicht.
+
+**Lösung:** Erstellen Sie das Thema in der Autorenumgebung oder passen Sie die Importdatei an.
+
+### "AbschnittTyp not found"
+
+Ein verwendeter Abschnitttyp existiert nicht.
+
+**Lösung:**
+- Prüfen Sie die Schreibweise (Gross-/Kleinschreibung wird normalisiert)
+- Erstellen Sie den Abschnitttyp in der Autorenumgebung
+- Standardtypen: `text`, `liste geordnet`, `liste ungeordnet`
+
+### Vorgabe wird nicht importiert
+
+Prüfen Sie:
+- Ist `>>>Nummer` gesetzt?
+- Ist `>>>Titel` gesetzt?
+- Existiert das Thema?
+
+Verwenden Sie `--dry-run --verbose` für detaillierte Informationen.
+
+## Weitere Informationen
+
+### Beispieldateien
+
+Beispieldateien finden Sie in:
+- `Documentation/import formats/r009.txt`
+- `Documentation/import formats/r0126.txt`
+
+### Export-Format
+
+Der Export verwendet JSON statt Textformat. Für JSON-Export siehe:
+
+```bash
+python manage.py export_json --output dokumente.json
+```
+
+Oder über die Web-Oberfläche: `/dokumente/R0066/?format=json`
+
+### Verwandte Commands
+
+- `export_json` - Exportiert Dokumente als JSON
+- `sanity_check_vorgaben` - Prüft Vorgaben auf Konflikte
+- `clear_diagram_cache` - Löscht Diagramm-Cache
+
+## Kontakt
+
+Bei Fragen oder Problemen wenden Sie sich an das Information Security Management BIT.

Documentation/diagramm.md

@@ -0,0 +1,544 @@
+# Diagramme in VorgabenUI
+
+Diese Anleitung beschreibt, wie Diagramme in Textabschnitten verwendet werden können. VorgabenUI nutzt [Kroki](https://kroki.io/) zur Generierung von Diagrammen aus Textbeschreibungen.
+
+## Übersicht
+
+Der Abschnitttyp **"diagramm"** ermöglicht es, verschiedene Diagrammtypen direkt in Vorgaben, Einleitungen und Geltungsbereichen einzubinden. Die Diagramme werden aus Textbeschreibungen automatisch als SVG-Grafiken generiert und gecacht.
+
+## Grundlegende Verwendung
+
+### Format
+
+```
+[Diagrammtyp]
+option: [HTML-Attribute] (optional)
+[Diagramm-Code]
+```
+
+**Zeile 1:** Diagrammtyp (z.B. `plantuml`, `mermaid`, `graphviz`)
+**Zeile 2 (optional):** `option:` gefolgt von HTML-Attributen für die Bildgrösse
+**Zeile 3+:** Der eigentliche Diagramm-Quellcode
+
+### Standard-Einstellungen
+
+Wenn keine `option:`-Zeile angegeben wird, wird das Diagramm mit `width="100%"` dargestellt.
+
+### Grösse anpassen
+
+Um die Grösse des Diagramms anzupassen, verwenden Sie die `option:`-Zeile:
+
+```
+plantuml
+option: width="50%"
+@startuml
+...
+@enduml
+```
+
+Weitere Beispiele für Optionen:
+
+```
+option: width="800px"
+option: width="60%" style="max-width: 600px;"
+option: height="400px"
+option: width="100%" class="img-fluid"
+```
+
+## Unterstützte Diagrammtypen
+
+Kroki unterstützt über 20 verschiedene Diagrammtypen. Die wichtigsten sind:
+
+| Typ | Beschreibung | Verwendung |
+|-----|--------------|------------|
+| `plantuml` | UML-Diagramme, Sequenzdiagramme, Aktivitätsdiagramme | Prozesse, Architekturen |
+| `mermaid` | Flussdiagramme, Sequenzdiagramme, Gantt-Charts | Prozessabläufe, Zeitpläne |
+| `graphviz` | Gerichtete/ungerichtete Graphen | Abhängigkeiten, Netzwerke |
+| `blockdiag` | Block-Diagramme | Systemübersichten |
+| `nwdiag` | Netzwerk-Diagramme | Netzwerktopologien |
+| `seqdiag` | Sequenz-Diagramme | Kommunikationsabläufe |
+| `c4plantuml` | C4-Modell Diagramme | Software-Architektur |
+| `ditaa` | ASCII-Art zu Diagrammen | Einfache Skizzen |
+| `excalidraw` | Hand-gezeichnete Diagramme | Präsentationen |
+| `bpmn` | Business Process Model Notation | Geschäftsprozesse |
+
+Vollständige Liste: https://kroki.io/
+
+## Beispiele
+
+### PlantUML: Sequenzdiagramm
+
+```
+plantuml
+option: width="80%"
+@startuml
+Alice -> Bob: Authentifizierungsanfrage
+Bob --> Alice: Authentifizierungsantwort
+
+Alice -> Bob: Weitere Anfrage
+Alice <-- Bob: Weitere Antwort
+@enduml
+```
+
+**Verwendung:** Darstellung von Kommunikationsabläufen, API-Interaktionen
+
+### PlantUML: Aktivitätsdiagramm
+
+```
+plantuml
+@startuml
+start
+:Sicherheitsrichtlinie prüfen;
+if (Richtlinie erfüllt?) then (ja)
+  :Zugriff gewähren;
+else (nein)
+  :Zugriff verweigern;
+  :Incident loggen;
+endif
+stop
+@enduml
+```
+
+**Verwendung:** Prozesse, Entscheidungsabläufe, Workflows
+
+### PlantUML: Komponentendiagramm
+
+```
+plantuml
+option: width="70%"
+@startuml
+package "Web-Tier" {
+  [Web-Server]
+  [Load Balancer]
+}
+
+package "App-Tier" {
+  [Application Server]
+  [Cache]
+}
+
+package "Data-Tier" {
+  [Datenbank]
+}
+
+[Load Balancer] --> [Web-Server]
+[Web-Server] --> [Application Server]
+[Application Server] --> [Cache]
+[Application Server] --> [Datenbank]
+@enduml
+```
+
+**Verwendung:** System-Architekturen, Komponenten-Übersicht
+
+### Mermaid: Flussdiagramm
+
+```
+mermaid
+option: width="75%"
+flowchart TD
+    Start[Log-Event empfangen] --> Check{Schweregrad?}
+    Check -->|CRITICAL| Alert[Alert auslösen]
+    Check -->|WARNING| Log[In Log-System speichern]
+    Check -->|INFO| Archive[Archivieren]
+    Alert --> SIEM[An SIEM weiterleiten]
+    Log --> SIEM
+    SIEM --> End[Fertig]
+    Archive --> End
+```
+
+**Verwendung:** Prozessabläufe, Entscheidungsbäume
+
+### Mermaid: Sequenzdiagramm
+
+```
+mermaid
+sequenceDiagram
+    participant Benutzer
+    participant Firewall
+    participant Server
+
+    Benutzer->>Firewall: Verbindungsanfrage
+    Firewall->>Firewall: Regel-Prüfung
+    alt Regel erlaubt
+        Firewall->>Server: Weiterleitung
+        Server-->>Firewall: Antwort
+        Firewall-->>Benutzer: Antwort
+    else Regel blockiert
+        Firewall-->>Benutzer: Verbindung abgelehnt
+    end
+```
+
+**Verwendung:** Kommunikationsabläufe mit Bedingungen
+
+### GraphViz: Abhängigkeitsgraph
+
+```
+graphviz
+digraph G {
+    rankdir=LR;
+    node [shape=box, style=rounded];
+
+    "R0066\nLogging" -> "R0009\nServersysteme";
+    "R0066\nLogging" -> "R0126\nNetzwerksicherheit";
+    "R0009\nServersysteme" -> "R0135\nInformationssicherheit";
+    "R0126\nNetzwerksicherheit" -> "R0135\nInformationssicherheit";
+
+    "R0135\nInformationssicherheit" [style="rounded,filled", fillcolor=lightblue];
+}
+```
+
+**Verwendung:** Abhängigkeiten zwischen Dokumenten/Standards
+
+### GraphViz: Netzwerk-Topologie
+
+```
+graphviz
+option: width="100%"
+graph G {
+    layout=neato;
+
+    Internet [shape=cloud];
+    Firewall [shape=box, style=filled, fillcolor=red];
+    DMZ [shape=box, style=filled, fillcolor=yellow];
+    LAN [shape=box, style=filled, fillcolor=green];
+
+    Internet -- Firewall [label="WAN"];
+    Firewall -- DMZ [label="DMZ-Segment"];
+    Firewall -- LAN [label="Internes Netz"];
+}
+```
+
+**Verwendung:** Netzwerk-Segmentierung, Zonen-Modelle
+
+### BlockDiag: System-Übersicht
+
+```
+blockdiag
+blockdiag {
+    orientation = portrait;
+
+    Client -> "Load Balancer" -> "Web-Server 1", "Web-Server 2";
+    "Web-Server 1", "Web-Server 2" -> "App-Server";
+    "App-Server" -> "Datenbank Primary";
+    "Datenbank Primary" -> "Datenbank Replica";
+
+    "Load Balancer" [color = "lightblue"];
+    "App-Server" [color = "lightgreen"];
+    "Datenbank Primary" [color = "pink"];
+}
+```
+
+**Verwendung:** Einfache System-Diagramme, Datenflüsse
+
+### NwDiag: Netzwerk-Diagramm
+
+```
+nwdiag
+nwdiag {
+    network dmz {
+        address = "192.168.1.0/24";
+
+        web01 [address = "192.168.1.10"];
+        web02 [address = "192.168.1.11"];
+    }
+
+    network internal {
+        address = "10.0.0.0/8";
+
+        web01 [address = "10.0.1.10"];
+        web02 [address = "10.0.1.11"];
+        app01 [address = "10.0.2.10"];
+        db01 [address = "10.0.3.10"];
+    }
+}
+```
+
+**Verwendung:** Netzwerk-Topologien mit IP-Adressen
+
+### SeqDiag: Authentifizierungsablauf
+
+```
+seqdiag
+seqdiag {
+    Benutzer -> System: Benutzername + Passwort;
+    System -> LDAP: Authentifizierung prüfen;
+    LDAP --> System: Erfolgreich;
+    System -> 2FA: 2FA-Code anfordern;
+    2FA --> Benutzer: Code per SMS;
+    Benutzer -> System: 2FA-Code eingeben;
+    System --> Benutzer: Zugriff gewährt;
+}
+```
+
+**Verwendung:** Authentifizierungs- und Autorisierungsabläufe
+
+### C4 PlantUML: System-Kontext
+
+```
+c4plantuml
+@startuml
+!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
+
+Person(admin, "Administrator", "BIT System-Administrator")
+System(vorgaben, "VorgabenUI", "IT-Sicherheits-Vorgaben Portal")
+System_Ext(ldap, "LDAP", "Authentifizierung")
+
+Rel(admin, vorgaben, "Verwaltet Vorgaben")
+Rel(vorgaben, ldap, "Authentifiziert über")
+@enduml
+```
+
+**Verwendung:** Software-Architektur nach C4-Modell
+
+## Best Practices
+
+### 1. Diagramm-Grösse anpassen
+
+Verwenden Sie die `option:`-Zeile, um die Grösse für bessere Lesbarkeit anzupassen:
+
+```
+plantuml
+option: width="60%"
+...
+```
+
+Für sehr detaillierte Diagramme:
+```
+plantuml
+option: width="100%" style="max-width: 1200px;"
+...
+```
+
+### 2. Einfachheit bevorzugen
+
+Halten Sie Diagramme einfach und fokussiert. Zu komplexe Diagramme sind schwer zu lesen.
+
+**Gut:**
+```
+mermaid
+flowchart LR
+    A[Start] --> B{Prüfung}
+    B -->|OK| C[Weiter]
+    B -->|Fehler| D[Abbruch]
+```
+
+**Zu komplex:** Vermeiden Sie Diagramme mit mehr als 15-20 Elementen.
+
+### 3. Konsistente Stil-Wahl
+
+Verwenden Sie für ähnliche Konzepte den gleichen Diagrammtyp:
+- **Prozesse:** Mermaid Flowchart oder PlantUML Activity
+- **Kommunikation:** Mermaid/PlantUML Sequence
+- **Architektur:** PlantUML Component oder C4
+- **Netzwerke:** NwDiag oder GraphViz
+
+### 4. Beschriftungen auf Deutsch
+
+Verwenden Sie deutsche Beschriftungen für bessere Verständlichkeit:
+
+```
+mermaid
+flowchart TD
+    Start[Anfrage empfangen] --> Prüfung{Berechtigung?}
+    Prüfung -->|Ja| Zugriff[Zugriff gewähren]
+    Prüfung -->|Nein| Ablehnung[Zugriff verweigern]
+```
+
+### 5. Farben sparsam einsetzen
+
+Nutzen Sie Farben zur Hervorhebung wichtiger Elemente:
+
+```
+graphviz
+digraph {
+    node [shape=box];
+
+    Kritisch [style=filled, fillcolor=red, fontcolor=white];
+    Wichtig [style=filled, fillcolor=orange];
+    Normal [style=filled, fillcolor=lightgreen];
+
+    Kritisch -> Wichtig -> Normal;
+}
+```
+
+### 6. Lesbarkeit testen
+
+Nach dem Speichern prüfen, ob das Diagramm in der Webansicht gut lesbar ist. Bei Bedarf:
+- Grösse anpassen (`option: width="..."`)
+- Diagramm vereinfachen
+- Anderen Diagrammtyp wählen
+
+## Fehlerbehandlung
+
+### Diagramm wird nicht angezeigt
+
+**Mögliche Ursachen:**
+
+1. **Syntaxfehler im Diagramm-Code**
+   - Prüfen Sie die Syntax gemäss Dokumentation des Diagrammtyps
+   - Testen Sie den Code auf https://kroki.io/
+
+2. **Falscher Diagrammtyp**
+   - Erste Zeile muss genau dem Kroki-Typ entsprechen
+   - Beispiel: `plantuml` (nicht `PlantUML` oder `plant-uml`)
+
+3. **Kroki-Server nicht erreichbar**
+   - Bei Fehlermeldung "Error generating diagram" Server prüfen
+
+### Fehlersuche
+
+1. **Code auf kroki.io testen:**
+   ```
+   https://kroki.io/
+   ```
+   Geben Sie dort den Code ein und testen Sie die Generierung.
+
+2. **Diagramm-Cache leeren:**
+   ```bash
+   python manage.py clear_diagram_cache
+   ```
+
+3. **Logs prüfen:**
+   Fehler werden im Application-Log ausgegeben.
+
+## Häufig verwendete Diagramm-Szenarien
+
+### IT-Sicherheit: Bedrohungsmodell
+
+```
+mermaid
+flowchart TB
+    Asset[Schützenswertes Asset]
+    Threat[Bedrohung]
+    Vuln[Schwachstelle]
+    Control[Sicherheitsmassnahme]
+
+    Threat -->|nutzt aus| Vuln
+    Vuln -->|betrifft| Asset
+    Control -->|schliesst| Vuln
+    Control -->|schützt| Asset
+```
+
+### Netzwerk-Segmentierung
+
+```
+nwdiag
+nwdiag {
+    network internet {
+        address = "Internet";
+        internet [shape = cloud];
+    }
+    network dmz {
+        address = "DMZ (192.168.1.0/24)";
+        fw [address = "192.168.1.1"];
+        web [address = "192.168.1.10"];
+    }
+    network internal {
+        address = "Intern (10.0.0.0/8)";
+        fw [address = "10.0.0.1"];
+        app [address = "10.0.1.10"];
+        db [address = "10.0.2.10"];
+    }
+
+    internet -- fw;
+}
+```
+
+### Patch-Management Prozess
+
+```
+plantuml
+@startuml
+start
+:Patch-Benachrichtigung empfangen;
+:Schweregrad bewerten;
+if (Kritischer Patch?) then (ja)
+  :Sofort in Test-Umgebung testen;
+  if (Test erfolgreich?) then (ja)
+    :Notfall-Change erstellen;
+    :In Produktion ausrollen;
+  else (nein)
+    :Vendor kontaktieren;
+  endif
+else (nein)
+  :In regulären Patch-Zyklus einplanen;
+  :Testen im Change-Window;
+  :Reguläres Rollout;
+endif
+:Dokumentation aktualisieren;
+stop
+@enduml
+```
+
+### Zugriffskontrolle
+
+```
+plantuml
+@startuml
+skinparam actorStyle awesome
+
+actor Benutzer
+actor Administrator
+actor "Security Team" as ST
+
+rectangle "VorgabenUI" {
+    usecase "Vorgaben lesen" as UC1
+    usecase "Vorgaben bearbeiten" as UC2
+    usecase "Vorgaben publizieren" as UC3
+    usecase "Sicherheitsreview" as UC4
+}
+
+Benutzer --> UC1
+Administrator --> UC1
+Administrator --> UC2
+ST --> UC4
+UC2 .> UC4 : <<extends>>
+UC4 --> UC3
+@enduml
+```
+
+## Weiterführende Ressourcen
+
+- **Kroki Dokumentation:** https://kroki.io/
+- **PlantUML Dokumentation:** https://plantuml.com/
+- **Mermaid Dokumentation:** https://mermaid.js.org/
+- **GraphViz Dokumentation:** https://graphviz.org/
+- **Live-Editor zum Testen:** https://kroki.io/
+
+## Tipps für spezifische Diagrammtypen
+
+### PlantUML Tipps
+
+```
+@startuml
+' Kommentare mit Apostroph
+skinparam backgroundColor transparent
+skinparam defaultFontName Arial
+@enduml
+```
+
+### Mermaid Tipps
+
+```
+%%{ init: { 'theme': 'base' } }%%
+flowchart LR
+    %% Kommentare mit doppeltem Prozent
+```
+
+### GraphViz Tipps
+
+```
+digraph {
+    // Kommentare mit doppeltem Slash
+    rankdir=LR;  // Links nach Rechts
+    // rankdir=TB;  // Top nach Bottom
+}
+```
+
+## Support
+
+Bei Fragen oder Problemen mit Diagrammen:
+1. Code auf https://kroki.io/ testen
+2. Syntax-Dokumentation des jeweiligen Diagrammtyps konsultieren
+3. Diagramm-Cache leeren: `python manage.py clear_diagram_cache`
+4. Bei technischen Problemen: Information Security Management BIT kontaktieren

Documentation/import formats/r009.txt

@@ -0,0 +1,337 @@
+>>>Einleitung
+>>>text
+Dieser Standard unterliegt den Definitionen vom Zentraldokument für Standard IT-Sicherheit. Ziel & Zweck, Änderungswesen etc. sind da definiert und werden hier nicht ein zweites Mal aufgeführt.
+
+
+>>>geltungsbereich
+>>>text
+Dieser Standard dient als Umsetzungsanforderung für Richtlinien IT-Sicherheit zu Serversystemen im BIT. Betroffen sind von diesem Standard grundsätzlich alle Serversysteme . Einzelne, explizite Ausschlüsse werden in den Anforderungen spezifiziert
+
+>>>Vorgabe Organisation
+>>>Nummer 1
+>>>Titel
+R0009.2.1	CMDB-Erfassung
+>>>Kurztext
+>>>Text
+Die Konfigurationsmanagement-Datenbank stellt die integrierte Informationsgrundlage für das Service-Management BIT sicher und ist das IT-Repository fürs IT-Sicherheitsmanagement.
+>>>Langtext
+>>>Text
+Jedes Asset (Server, Gateway, Router, Switch usw.), dass sich im BIT-Netz befindet, muss in einer möglichst standardisierten Form dokumentiert sein. Ist die Betriebsverantwortung bei einem anderen Leistungserbringer, ist dies entsprechend zu dokumentieren und einzufordern.
+
+
+>>>Vorgabe Technik
+>>>Nummer 1
+>>>Titel
+Dienste und Protokolle
+>>>Kurztext
+>>>Text
+Nicht benötigte Dienste und Protokolle deaktivieren
+>>>Langtext
+>>>Text
+Nach einer Standardinstallation von Systemen und Softwareprodukten sind typischerweise lokale oder aus dem Netz erreichbare Dienste und Protokolle aktiv, die für den Betreib und die Funktionalität des Systems nicht notwendig sind. Hierzu gehören auch Dienste und Protokolle, die aufgrund ihrer bekannten Sicherheits-Schwachstellen, die gegebenen falls für die Verletzung von Schutzzielen wie Vertraulichkeit, Integrität und Verfügbarkeit genutzt werden können. Solche Dienste (wie z.B. SSL anstatt TLS) und Protokolle müssen auf einem System vollständig deaktiviert sein (System-Härtung). Dabei ist es wichtig zu beachten, dass die Deaktivierung auch nach einem Neustart des Systems bestehen bleibt.
+
+Als Referenz für System-Härtung sollen die spezifischen Hersteller Sicherheits-Konfigurationen und weitere Referenzen wie CIS-Workbench angewendet werden.
+
+>>>Vorgabe Technik
+>>>Nummer 2
+>>>Titel
+Einschränkungen Tools auf Serversystemen
+>>>Kurztext
+>>>Text
+Es dürfen keine Entwicklungstools, wie Compiler und Debugger, sowie Source Code Repositories auf einem produktiven Server vorhanden sein.
+>>>Langtext
+>>>Text
+Es dürfen keine Entwicklungstools, wie Compiler und Debugger, sowie Source Code Repositories auf einem produktiven Server vorhanden sein. Falls diese temporär benötigt werden (z.B. in einer krisenbedingten Restore-Situation) dürfen sie nur punktuell und so lange wie nötig auf den Systemen installiert werden.
+
+>>>Vorgabe Technik
+>>>Nummer 3
+>>>Titel
+Erreichbarkeit von Diensten
+>>>Kurztext
+>>>Text
+Dienste können nur eingeschränkt erreichbar sein und die Konfiguration darf nur autorisiert erfolgen.
+>>>Langtext
+>>>Text
+In der Regel sind aktivierte Dienste in der Grundkonfiguration über alle verfügbaren Schnittstellen eines Systems erreichbar und können von anderen Systemen in den angeschlossenen Netzen erreicht werden. Diese Erreichbarkeit ist funktional weder notwendig noch sinnvoll. Daher dürfen auf einem System die Dienste nur auf Schnittstellen aktiviert werden, auf denen deren Nutzung erforderlich ist. Auf den Schnittstellen, auf denen einen Dienst aktiv ist, muss dessen Erreichbarkeit auf legitime Kommunikationspartner eingeschränkt werden. Diese Einschränkung muss lokal, also ohne zusätzliche netzseitige Massnahmen, wie z. B. eine Firewall, erfolgen
+
+Dies kann zum Beispiel durch gegenseitige Authentisierung der Serversysteme mittels Zertifikats oder Key-Austausch erreicht werden.
+
+
+>>>Vorgabe Technik
+>>>Nummer 4
+>>>Titel
+Lokale Firewalls anwenden
+>>>Kurztext
+>>>Text
+Vorgeschaltete Firewwalls bieten keinen umfassenden Schutz.
+>>>Langtext
+>>>Text
+Zonen Übergreifende Firewall oder Netz-Segmentierung sind keine Garantie für eine effiziente Einschränkung an nur berechtigte Zugriffe.
+Ein lokaler Paketfilter (Firewall) stellt sicher, dass Dienste, insbesondere Management-Dienste, nur an den erforderlichen Schnittstellen erreichbar sind.
+
+Ist auch Teil der Grund-Konfiguration durch System-Härtung (R0009.T.1).
+
+
+>>>Vorgabe Informationen
+>>>Nummer 1
+>>>Titel
+BIT-Externer Betrieb
+>>>Kurztext
+>>>Text
+Die Verschlüsselung der Datenträger soll wo immer möglich verwendet werden. Es ist ein MUSS wo keine angepasste physische Zugriff Sicherheit gesichert werden kann.
+>>>Langtext
+>>>Text
+Falls sich das System nicht in einem BIT betriebenen RZ oder in einem abgesicherten Raum mit mindestens «Sehr hohem Schutzbedarf» befindet, müssen verwendete Datenträger vollständig verschlüsselt sein.
+
+Der Schutzbedarf oder auch die Schutzklassen (SK) sind in der (Richtlinie Informationssicherheit)[https://community.bit.admin.ch/team/eabit/Private/iktvorgaben/IKTVorgaben%20genehmigt/R0135_V5.2.pdf] BIT definiert.
+
+>>>Vorgabe Informationen
+>>>Nummer 2
+>>>Titel
+Vermeiden von Überlastsituationen
+>>>Kurztext
+>>>Text
+Das System muss sich gegen Überlastsituationen schützen
+>>>Langtext
+>>>Text
+Ein System muss über Schutzmechanismen verfügen, die Überlastsituationen soweit wie möglich verhindern. Insbesondere ist eine partielle oder komplette Beeinträchtigung der Verfügbarkeit des Systems zu vermeiden. Beispiele für mögliche Schutzmassnahmen sind:
+>>>Liste-ungeordnet
+Begrenzung auf Netzwerkzonen
+Begrenzung des pro Anwendung verfügbaren Arbeitsspeichers
+Begrenzung der maximalen Sessions einer Web-Anwendung
+Festlegen der maximalen Grösse eines Datensatzes
+Begrenzung von CPU-Ressourcen pro Prozess
+Priorisieren von Prozessen
+>>>Text
+Begrenzung der Anzahl oder der Grösse von Transaktionen eines Benutzers oder von einer IP-Adresse in einem bestimmten Zeitraum.
+
+
+>>>Vorgabe Informationen
+>>>Nummer 3
+>>>Titel
+Reaktion auf Überlastsituationen
+>>>Kurztext
+>>>Text
+Falls eine Überlastsituation nicht verhindert werden kann muss sich das System berechenbar verhalten.
+>>>Langtext
+>>>Text
+Ein System muss so konzipiert sein, dass es mit Überlastsituationen in kontrollierter Weise umgeht. Trotzdem kann es zu Situationen kommen, bei denen die Schutzmassnahmen gegen Überlastungen nicht mehr 
+ausreichend sind.
+
+In einem solchen Fall muss sichergestellt sein, dass das System nicht in einen undefinierten und möglicherweise unsicheren Zustand gerät. Dies kann im Extremfall bedeuten, dass ein kontrolliertes Herunterfahren des Systems eher hinnehmbar ist als ein unkontrolliertes Versagen der Sicherheitsfunktionen und somit ein Verlust des 
+Systemschutzes.
+
+
+>>>Vorgabe Informationen
+>>>Nummer 4
+>>>Titel
+Dynamische Inhalte
+>>>Kurztext
+>>>Text
+Zunehmende (dynamische) Inhalte dürfen Systemfunktionen nicht beeinträchtigen.
+>>>Langtext
+>>>Text
+Zunehmende Logdaten oder Uploads dürfen die Funktionalität des Systems nicht beeinträchtigen.
+
+>>>Vorgabe Informationen
+>>>Nummer 5
+>>>Titel
+IP-Schnittstellen
+>>>Kurztext
+>>>Text
+Das System darf keine IP-Pakete verarbeiten, deren Absenderadresse nicht über die Schnittstelle erreicht wird, an der das Paket eingegangen ist.
+>>>Langtext
+>>>Text
+Es muss darauf geachtet werden, dass Systeme nicht über unnötige Default-Routen verfügen, was z. B. der Fall ist, wenn Systeme nur intern verwendet werden.
+>>>Text
+In einer solchen Konstellation handelt es sich i. d. R. um Pakete mit gefälschten Absenderadressen oder einen Fehler im Routing. Das eintreffende Paket muss als nicht vertrauenswürdig verworfen werden, Ein Umsetzungsbeispiel: Die Verwendung der Funktion «Reverse Path Filter» (RPF), die dafür sorgt, dass genau solche Pakete verworfen werden.
+
+>>>Vorgabe Informationen
+>>>Nummer 6
+>>>Titel
+Disaster Recovery Plan
+>>>Kurztext
+>>>Text
+Ein Wiederanlaufplan / Disaster Revovery Plan muss beschrieben und sichergestellt sein.
+>>>Langtext
+>>>Text
+Wiederaufsetz- und Neustart Prozeduren im Fehlerfall, sowie Notfallpläne müssen dokumentiert sein. Die Vorbereitung und das Testen von Routine-Betriebsabläufen müssen nach festgelegten Standards erfolgen. Definierte Sicherheitsmassnahmen müssen nachweislich wirksam implementiert sein. Verfahren zur Sicherstellung des Geschäftsbetriebs müssen definiert und geregelt sein.
+
+>>>Vorgabe Informationen
+>>>Nummer 7
+>>>Titel
+Partitionierung
+>>>Kurztext
+>>>Text
+Partitionen müssen, wenn möglich, getrennt werden.
+>>>Langtext
+>>>Text
+Daten-, Applikations- und Systempartitionen müssen, wenn möglich, getrennt werden. Eine Trennung der Daten liefert einen zusätzlichen Sicherheitslayer, sollte es zu Systemausfällen oder Malware-Befall kommen.
+Abhängig vom Schutzbedarf sollte auch entsprechend sichergestellt werden, dass die einzelnen Partitionen mit einer RAID-Funktionalität geschützt werden.
+
+
+>>>Vorgabe Systeme
+>>>Nummer 1
+>>>Titel
+Softwareinstallation
+>>>Kurztext
+>>>Text
+Nicht benötigte (autorisierte) Software darf nicht installiert oder muss deinstalliert werden
+>>>Langtext
+>>>Text
+Bei der Installation eines Systems werden oftmals Software-Komponenten installiert oder auch einzelne Teile einer Software aktiviert, die für den Betrieb und die Funktion des Systems nicht notwendig sind. Hierzu zählen auch Teile einer Software, die als Anwendungsbeispiele (z. B. Default-Web-Seiten, Beispieldatenbanken, Testdaten) installiert werden, aber typischerweise nicht verwendet werden. Solche Komponenten dürfen entweder bei der Installation nicht mit installiert werden oder müssen im Anschluss an die Installation gelöscht werden. Des Weiteren ist es nicht erlaubt Software auf einem System zu installieren, die nicht für den Betrieb, die Wartung oder Funktion des Systems notwendig ist
+
+
+>>>Vorgabe Systeme
+>>>Nummer 2
+>>>Titel
+Softwarefunktionen
+>>>Kurztext
+>>>Text
+Nicht benötigte Funktionen der eingesetzten Software und Hardware müssen deaktiviert werden
+>>>Langtext
+>>>Text
+Bei der Installation von Software und Hardware werden oftmals Funktionen aktiviert, die nicht für den Betrieb und die Funktionalität des Systems notwendig sind. Funktionen der Software sind meistens ein fester Bestandteil, der nicht einzeln gelöscht oder deinstalliert werden kann. Solche Funktionen müssen über die Konfiguration oder Einstellungen dauerhaft deaktiviert werden
+
+Neben Funktionen der Software sind nach der Systeminstallation oftmals Hardware-Funktionen aktiviert, die nicht für den Einsatz des Systems benötigt werden. Solche Funktionen, wie beispielsweise nicht benötigte Schnittstellen, müssen dauerhaft deaktiviert werden, so dass sie auch nach einem Neustart deaktiviert bleiben.
+
+
+>>>Vorgabe Systeme
+>>>Nummer 3
+>>>Titel
+Netzwerkprotokolle
+>>>Kurztext
+>>>Text
+Die IPv4-/IPv6-Adressen aller Schnittstellen eines Servers müssen fest konfiguriert werden
+>>>Langtext
+>>>Text
+IP-Adressen, auf denen Dienste angeboten werden, dürfen nicht durch äussere Einflüsse verändert werden können, auch nicht bei einem erzwungenen Reboot. Eine automatische Zuweisung von IP-Adressen, z. B. mittels DHCPv4/v6 oder IPv6-Autokonfiguration, ist nur dann zulässig, wenn sie nach initialer Vergabe der Adresse(n) abgeschaltet oder anderweitig abgesichert wird. IPv6 Router Advertisements müssen ignoriert werden.
+Es wird empfohlen den Host-Anteil der IPv6-Adressen zufällig zu bilden, da auf Grund des sehr grossen Adressbereiches von IPv6 ein Auffinden von Systemen für einen Angreifer durch Scans sehr aufwändig ist.
+
+Nicht benutzte Protokolle (z.B. IPv6) können komplett abgeschaltet werden.
+
+
+>>>Vorgabe Systeme
+>>>Nummer 4
+>>>Titel
+Netzwerkfunktionen
+>>>Kurztext
+>>>Text
+Netzfunktionen im Betriebssystemkern, die für den Betrieb als Server nicht benötigt werden, müssen abgeschaltet werden (Kernel Parameter).
+>>>Langtext
+>>>Text
+Ein Server braucht nicht zu routen, daher muss die Routing-Funktion abgeschaltet sein. Ebenso muss das 
+Antworten auf Broadcast-ICMP-Pakete abgeschaltet sein. Diese und weitere Netzfunktionen sind normalerweise bereits im Auslieferungszustand korrekt gesetzt.
+
+
+>>>Vorgabe Systeme
+>>>Nummer 5
+>>>Titel
+Autorun-Funktionen
+>>>Kurztext
+>>>Text
+Das automatische Starten von Anwendungen auf Wechseldatenträgern muss abgeschaltet werden.
+>>>Langtext
+>>>Text
+Wechseldatenträger – etwa CD-, DVD-, USB-Sticks oder USB-Laufwerke – dürfen darauf enthaltene Anwendungen nicht automatisch starten.
+
+>>>Vorgabe Systeme
+>>>Nummer 6
+>>>Titel
+Verarbeitung von transferierten Daten
+>>>Kurztext
+>>>Text
+Die Verarbeitung von ICMPv4-/ICMPv6-Paketen, die für den Betrieb nicht benötigt werden, muss deaktiviert werden.
+>>>Langtext
+>>>Text
+Es gibt verschiedene Typen von ICMPv4 und ICMPv6, die in den meisten Netzen nicht verwendet werden, aber ein potentielles Risiko darstellen. Diese Typen müssen deaktiviert oder gefiltert werden.
+>>>text
+Folgende ICMP-Typen sind erlaubt und dürfen genutzt werden:
+>>>Liste ungeordnet
+Echo Request [Type 8 (v4), Type 128 (v6)]
+Echo Reply [Type 0 (v4), Type 129 (v6) ]
+Destination Unreachable [Type 3 (v4), Type 1 (v6)]
+Time Exceeded [Type 11 (v4), Type 3 (v6)]
+Parameter Problem [Type 12 (v4), Type 4 (v6)]
+Packet Too Big [Type 2 (nur v6)]
+Neighbor Solicitation [Type 135 (nur v6)]
+Neighbor Advertisement [Type 136 (nur v6)]
+>>>text
+Es besteht die Möglichkeit, dass weitere Typen notwendig sind. Dies ist im Einzelfall zu prüfen.
+
+In *keinem Fall* dürfen beantwortet oder verarbeitet werden:
+>>>Liste ungeordnet
+Timestamp Reply [Type 14 (v4)]
+Netmask Reply [Type 18 (v4)]
+Information Reply [Type 16 (v4)]
+Redirect [Type 5 (v4), Type 137 (v6)]
+Router Solicitation [Type 133 (v6)]
+Router Advertisement [Type 134 (v6)]
+
+
+>>>Vorgabe Systeme
+>>>Nummer 7
+>>>Titel
+IP-Headers
+>>>Kurztext
+>>>Text
+IP-Pakete mit nicht benötigten Optionen oder Erweiterungs-Headern dürfen nicht bearbeitet werden.
+>>>Langtext
+>>>Text
+IP Optionen und Erweiterungs-Header (z. B. Source Routing) werden nur in seltenen Ausnahmefällen benötigt. Somit sind alle Pakete mit gesetzten IP-Optionen und Erweiterungs-Headern auf Standard-Servern zu filtern.
+
+>>>Vorgabe Systeme
+>>>Nummer 8
+>>>Titel
+Default-Konten
+>>>Kurztext
+>>>Text
+Vordefinierte Konten müssen gelöscht oder deaktiviert werden.
+>>>Langtext
+>>>Text
+Auf vielen Systemen existieren vordefinierte Konten (z. B. Gast, Admin) die teilweise ohne oder mit bekannten Passwörtern vorkonfiguriert sind. Diese Standardbenutzer müssen gelöscht oder deaktiviert werden. Sollten diese Massnahmen nicht umsetzbar sein, so sind solche Konten für einen Fernzugriff zu sperren. In jedem Fall müssen gesperrte und deaktivierte Konten mit einem möglichst komplexen Passwort (12 Zeichen und mehr, Nutzung von Gross-/ Kleinbuchstaben, Zahlen und Sonderzeichen) versehen werden, so dass auch im Falle eine Fehlkonfiguration die unberechtigte Nutzung eines solchen Kontos verhindert wird.
+
+Ausgenommen von der Anforderung, Konten zu löschen oder zu deaktivieren, sind Konten, die ausschliesslich der internen Nutzung auf dem entsprechenden System dienen und die für die Funktionalität einer oder mehrerer Anwendungen des Systems notwendig sind. Auch für ein solches Konto muss sichergestellt werden, dass ein Fernzugriff oder eine lokale Anmeldung nicht möglich ist und dass ein Benutzer des Systems ein solches Konto nicht missbräuchlich nutzen kann.
+
+
+>>>Vorgabe Anwendungen
+>>>Nummer 1
+>>>Titel
+Wartung und Pflege
+>>>Kurztext
+>>>Text
+Software- und Hardware-Komponenten, für die es keine Wartung oder Pflege durch den Lieferanten, Hersteller oder Entwickler gibt, dürfen nicht verwendet werden
+>>>Langtext
+>>>Text
+Es dürfen auf einem System nur Betriebssystem-, Middleware- und Anwendungs-Software sowie Hardware- Komponenten eingesetzt werden, für die ein Support durch Lieferanten, Hersteller, Entwickler oder anderen Vertragspartner besteht. Komponenten die End-of-Life oder End-of-Support sind dürfen nicht eingesetzt werden. Ausgenommen hiervon sind Komponenten für die ein spezieller Support-Vertrag abgeschlossen wurde, durch den auch über den Lebendzyklus des Produkts hinaus die Behebung von Sicherheitsschwachstellen gewährleistet ist und von SI-SUR so genehmigt wurdeWeiterführende Informationen
+
+
+>>>Vorgabe Anwendungen
+>>>Nummer 2
+>>>Titel
+Schwachstellen
+>>>Kurztext
+>>>Text
+Bekannt gewordene Schwachstellen in der Software oder Hardware des Systems müssen behoben oder abgesichert werden
+>>>Langtext
+>>>Text
+Vor der Installation einer Software- oder auch Hardware-Komponente muss überprüft werden, ob bereits Schwachstellen in der einzusetzenden Version gefunden und veröffentlicht wurden. Sollte die entsprechende Komponente von einer Schwachstelle betroffen sein, darf sie nicht installiert oder verwendet werden. Eine Ausnahme hiervon sind Komponenten, für die bereits eine Massnahme zum Beheben der Schwachstelle wie z. B. ein Patch, ein Update oder ein Workaround vom Hersteller zur Verfügung gestellt wurde. In diesem Fall muss die zusätzliche Massnahme auf dem System umgesetzt werden. Zudem ist dies ein fortlaufender Prozess während des kompletten Life-Cycles des Systems, um auftretende Schwachstellen zeitnah zu beheben.
+
+Zeitvorgaben für das beheben von entsprechenden Schwachstellen werden vom SI-SUR-CSIRT vorgegeben
+
+
+>>>Vorgabe Zonen
+>>>Nummer 1
+>>>Titel
+Abgesicherte Räume
+>>>Kurztext
+>>>Text
+Falls sich das System nicht in einem BIT-betriebenen abgesicherten Raum (RZ) befindet, muss der Schutzbedarf «sehr hoher Schutzbedarf (SN3)» gewährleistet werden. Das BIOS muss vor nicht autorisierten Veränderungen geschützt werden.
+>>>Langtext
+>>>Text
+Server, die öffentlich oder in Räumlichkeiten von Kunden installiert sind, müssen besonders vor unautorisiertem Zugriff und Veränderungen geschützt werden: Es müssen die Einstellungen des BIOS gegen Auslesen und 
+Manipulation geschützt werden. Bei Verwendung eines Passworts muss dieses exklusiv für den einzelnen Server sein und darf keine Rückschlüsse auf ein Unterscheidungsmerkmal des Servers ermöglichen.
+Das BIOS muss so konfiguriert sein, dass sich darüber ausschliesslich das vorgesehene Betriebssystem von der dafür vorgesehenen Partition starten lässt
+
+
+

Documentation/import formats/r0126.txt

@@ -0,0 +1,629 @@
+>>>Einleitung
+>>>text
+Hier ist die Einleitung
+>>>geltungsbereich
+>>>text
+Container-Sicherheit startet bei fundamentalen Themen wie dem Härten der Systeme, wobei der gesamte Container-Stack hierzu sinnvollerweise in Schichten
+zu betrachten ist. Ausgehend von einer Planungsphase müssen alle vorhandenen Schichten des Container-Stacks betrachtet und gehärtet werden.
+>>>text
+Wir unterscheiden die untenstehenden Schichten:
+>>>liste geordnet
+Container Host
+Container Runtime
+Container Registry
+Container Images
+Container Orchestrator
+Persistent Storage
+>>>text
+In diesem Standard geht es ausschliesslich um die Sicherheitsanforderung zur Einrichtung und Betrieb von Containern (Schicht 2-5). Er konkretisiert den IT-Grundschutz und ergänzt den Standard IT-Sicherheit Serversysteme und die jeweiligen Richtlinien der IT-Sicherheit um Spezifika von Containern. Die Anforderungen der erwähnten Richtlinien sollten von den Container-Hosts (Schicht 1) erfüllt werden, unabhängig davon, ob diese selbst auf physischen Servern ausgeführt werden oder virtualisiert sind. Sicherheitsanforderungen möglicher Server-Funktionen wie Webserver oder Groupware usw. sind Gegenstand eigener Sicherheitsrichtlinien. Der Schwerpunkt des Standards IT-Sicherheit Container liegt auf dem Betrieb von Container-Virtualisierung. Die Installation von Anwendungen innerhalb von Containern wird darin nicht vollständig abgedeckt.
+
+
+>>>Vorgabe Organisation
+>>>Titel
+Resilienz
+>>>Nummer 1
+>>>Kurztext
+>>>Text
+Es muss davon ausgegangen werden, dass nicht immer alle Kommunikationspartner zur Verfügung stehen. Dies muss bereits im Design eines Microservices berücksichtigt werden.
+>>>Langtext
+>>>Text
+In einem verteilten System können Netzwerkprobleme auftreten, z. B. Verzögerungen, Paketverluste oder temporäre Verbindungsabbrüche. Ein Microservice sollte daher darauf vorbereitet sein, dass andere Services zeitweise nicht erreichbar sind oder langsamer reagieren. Wenn jeder Service darauf angewiesen ist, dass alle anderen ständig verfügbar sind, entsteht eine starke Kopplung, die den Vorteil der Microservices-Architektur untergräbt. Services sollten unabhängig voneinander laufen und auch dann ihre Kernfunktionen erfüllen können, wenn andere Teile des Systems ausfallen.
+
+Indem man von vornherein davon ausgeht, dass nicht alle Services jederzeit verfügbar sind, wird die Gesamtarchitektur stabiler, flexibler und besser auf reale Betriebsbedingungen vorbereitet. Für jeden Microservice mit Abhängigkeiten muss daher festgelegt werden, wie er auf Nichterreichbarkeit der Abhängigkeiten reagiert (z.B. "Läuft weiter", "arbeitet die Queue ab und nimmt keine neuen Aufträge entgegen", "stoppt sofort alle Prozesse" oder ähnlich).
+
+
+>>>Vorgabe Organisation
+>>>Nummer 2
+>>>Titel
+Service Discovery
+>>>Kurztext
+>>>Text
+Der Netzwerkstandort einer Microservice-Instanz ist verfügbar und aktuell.
+
+Ein Schlüsselelement bei Service Discovery ist die Service Registry. Weiterhin kennt das Service Discovery alle laufenden Microservices und führt nach, auf welcher IP/Port Kombination diese gerade laufen.
+>>>Langtext
+>>>Text
+Die Verfügbarkeit und Aktualität des Netzwerkstandorts eines Microservices ist ein zentrales Element in Microservices-Architekturen. Mithilfe einer Service Registry und einem effizienten Service Discovery-Mechanismus wird sichergestellt, dass alle Microservices zuverlässig miteinander kommunizieren können, auch in dynamischen und skalierbaren Umgebungen. Dies fördert Resilienz, Flexibilität und Skalierbarkeit des gesamten Systems.
+
+Die Microservices stellen sicher, dass die Service Discovery die entsprechenden Informationen aus den Microservices herauslesen kann.
+
+>>>Vorgabe Organisation
+>>>Nummer 3
+>>>Titel
+Deployment in Container
+>>>Kurztext
+>>>Text
+Als Best Practice gilt ein Microservice pro Container.
+>>>Langtext
+>>>Text
+Das Deployment der Microservices erfolgt in Containern, welche dynamisch bereitgestellt und abgebaut werden, je nach Skalierungsanforderung. Daher gilt als Grundsatz, dass pro Microservice ein eigener Container aufgebaut wird und vice versa in jedem Container ein Microservice läuft. So wird das Deployment neuer Microservices und Microservice Updates vereinfacht.
+
+Zusätzlich reduziert diese Isolation Konflikte zwischen Abhängigkeiten verschiedener Microservices und vereinfacht die Verwaltung.
+>>>Stichworte
+Deployment, Microservice, Isolation
+
+>>>Vorgabe Technik
+>>>Nummer 1
+>>>Titel
+Implementation
+>>>Kurztext
+>>>Text
+Technologien, die bedingen, dass interne Details exponiert werden, müssen vermieden werden.
+>>>Langtext
+>>>Text
+Wie ein Microservice implementiert ist, darf gegen aussen keine Rolle spielen und sollte als Grundsatz nicht offengelegt werden. Die API muss dokumentiert sein, sollte aber nach Möglichkeit keine Rückschlüsse auf die Implementation zulassen.
+
+>>>Vorgabe Technik
+>>>Nummer 2
+>>>Titel
+Microservice-Aufrufe
+>>>Kurztext
+>>>Text
+Microservices kommunizieren über APIs und benutzen, je nach Anwendungs-Scope, den API-Gateway für die Kommunikation.
+>>>Langtext
+>>>Text
+Microservice-zu-Microservice Aufrufe im Kontext derselben Fachanwendung erfolgen direkt von Microservice zu Microservice und gehen nicht über den API Gateway. Microservice Aufrufe, die den Kontext einer Fachanwendung verlassen, gehen über den API Gateway. Dazu bietet jeder Microservice eine Schnittstelle, die nach Bedarf über einen API Microgateway angeboten werden kann. Die Schnittstellen müssen so realisiert sein, dass ein Microservice nicht direkt von den Implementierungsdetails eines anderen Microservice abhängt, wie z. B. dem Datenmodell in der Datenbank (lose Kopplung). Die Kommunikation zwischen Microservices (auch über API Gateway) muss auf einige Protokolle wie REST oder Messaging begrenzt sein.
+
+>>>Vorgabe Technik
+>>>Nummer 3
+>>>Titel
+Identity Provider
+>>>Kurztext
+>>>Text
+Die Authentisierung erfolgt über den Identity Provider.
+>>>Langtext
+>>>Text
+Benutzer-Anfragen werden via IAM Infrastruktur authentifiziert. Benutzer-Identitäten und -Rollen werden zentral in der IAM-Infrastruktur verwaltet.
+
+>>>Vorgabe Technik
+>>>Nummer 4
+>>>Titel
+Authentisierungs-Token
+>>>Kurztext
+>>>Text
+Bei erfolgreicher Authentisierung wird ein Authentisierungs-Token erstellt und signiert, das den Anfrager bei allen folgenden Serviceaufrufen authentisiert.
+>>>Langtext
+>>>Text
+Bei erfolgreicher Authentisierung wird ein Authentisierungs-Token erstellt und signiert, welches den Anfrager bei allen folgenden Serviceaufrufen authentisiert.
+>>>Text
+Die Authentisierungs-Tokens haben mindestens folgende Merkmale:
+>>>Liste-ungeordnet
+Sie müssen eine lokale Validierung durch den Empfänger unterstützen
+Sie müssen leichtgewichtig sein (einfach zu parsen, …)
+Sie müssen klein sein (und können Teil jeder Anfrage sein)
+>>>Text
+Die Authentisierungs-Tokens sollten über eine möglichst kurze Lebensdauer verfügen, damit eine regelmässige Re-Authentisierung forciert wird.
+
+>>>Vorgabe Technik
+>>>Nummer 5
+>>>Titel
+Service-zu-Service-Kommunikation
+>>>Kurztext
+>>>Text
+Service-zu-Service-Kommunikation wird mittels technischem User und Client-Zertifikaten authentisiert.
+>>>Langtext
+>>>Text
+Service-zu-Service-Kommunikation wird mittels technischem User und Client-Zertifikaten authentisiert.
+
+Bei Service zu Service Kommunikation kann die Authentisierung und Autorisierung delegiert werden. Welche Service zu Service Kommunikation mittels Delegation erfolgt, muss fallweise bestimmt werden.
+
+
+>>>Vorgabe Technik
+>>>Nummer 26
+>>>Titel
+Autorisierung durch Microservice und Autorisierungsmechanismen
+>>>Kurztext
+>>>Text
+>>>Langtext
+>>>Text
+Jeder Microservice muss jeden Request autorisieren (anhand AuthToken), da nur der Microservice selbst die Autorisierung auf die Daten vornehmen kann. Diese Aufgabe kann weder an einen API-Gateway noch an ein Service Mesh delegiert werden.
+>>>Liste-ungeordnet
+Die Autorisierungsmechanismen haben folgende Merkmale:
+Sie müssen Rollenbasiert sein
+Sie müssen Genehmigungen / Claims unterstützen
+Sie müssen die unabhängige Entwicklung der Microservices unterstützen
+Es gibt eine zentrale Übersicht und Verwaltung der Rollen und Genehmigungen / Claims
+Sie müssen eine Delegation der Autorisierung unterstützen
+
+
+>>>Vorgabe Technik
+>>>Nummer  7
+>>>Titel
+Persistenz
+>>>Kurztext
+>>>Text
+Microservices sollen ihre Daten selbst führen.
+>>>Langtext
+>>>Text
+In der Regel wird ein Data Store pro Microservice geführt. Mit welcher Art von Datenspeicherung (Relationale Datenbank, Distributed Datenbank, In-Memory Data Store) die Persistenz realisiert wird, ist abhängig von den Anforderungen der Microservices sowie den Technologievorgaben des BIT. Die Abläufe, die diese Data Stores verwalten, sind separate Services.
+
+>>>Vorgabe Technik
+>>>Nummer 8 
+>>>Titel
+Message Oriented Middleware / Event Broker Services
+>>>Kurztext
+>>>Text
+Die Kommunikation zwischen Microservices erfolgt über die MOM. Events werden mit dedizierten Event Broker Services abgefangen und propagiert.
+>>>Langtext
+>>>Text
+Die Message Oriented Middleware (MOM) muss hochverfügbar sein und einen hohen Durchsatz bieten. Einen Datenabgleich zwischen den verschiedenen Microservices und ihren Data Stores erfolgt Event basiert über die MOM.
+
+Eine Event-basierende Kollaboration führt dazu, dass Geschäftslogik nicht zentralisiert, sondern verteilt ist. In einer Event-basierenden Kollaboration sind die Microservices in hohem Masse voneinander entkoppelt. Der Event Broker übernimmt somit die Rolle eines Vermittlers.
+
+
+>>>Vorgabe Technik
+>>>Nummer 9
+>>>Titel
+Correlation IDs
+>>>Kurztext
+>>>Text
+Standardisierte Correlation IDs werden verwendet, damit Microservices-Aufruf-Ketten ausgewertet werden können.
+>>>Langtext
+>>>Text
+In einer Microservice Architektur interagieren in der Regel immer mehrere Microservices, um eine Geschäftsfunktion zu erfüllen. Correlation-IDs werden beim ersten Anruf generiert, in der Kette entlang weitergegeben und jeweils geloggt.
+
+>>>Vorgabe Technik
+>>>Nummer 10 
+>>>Titel
+Monitoring und Logging
+>>>Kurztext
+>>>Text
+Alle Services müssen Monitoring-Metriken und Logs in einer einheitlichen Art und Weise (wenn möglich in Standardformaten) abgeben oder zugänglich machen.
+>>>Langtext
+>>>Text
+Alle Services müssen Monitoring-Metriken und Logs in einer einheitlichen Art und Weise (wenn möglich in Standardformaten) abgeben oder zugänglich machen. Das Monitoring greift dabei auf standardisierte Messpunkte in den Elementen der inneren Architektur (Microservices, APIs) zu. Logs müssen standardisiert erfasst werden. Zusammen mit dem Service Mesh (mit Service Discovery / Registry) wird eine dynamische Übersicht der aktuell instanziierten Microservices geliefert. Auch Metadaten, z. B. zur Authentifizierung müssen standardisiert sein.
+
+Das Monitoring muss ein Synthetic (Semantic) Monitoring unterstützen. Das bedeutet, es muss regelmässig eine Submenge der automatisierten Fachanwendungstests in der Produktionsumgebung durchgeführt werden können. Die Resultate daraus werden in das Monitoring und Event Management eingespielt, welches bei Fehlerfall Alerts ausführt.
+>>>Text
+Folgende weitere Punkte müssen minimal berücksichtigt werden:
+>>>Liste-ungeordnet
+Antwortzeiten und Fehlerraten von Service-Aufrufen werden aufgezeichnet.
+Antworten von Downstream-Aufrufen (weiterführende Service-Aufrufe) werden aufgezeichnet. Im Minimum die Antwortzeiten der weiterführenden Service-Aufrufe.
+Das darunterliegende OS und dessen Prozesse müssen überwacht werden (Host), damit eine Kapazitätsplanung möglich wird.
+Host-Level, Microservices-Level und System-Level-Metriken können aggregiert werden.
+Die Metriken müssen lange genug verfügbar bleiben, damit Trends erkannt werden können.
+>>>Text
+Logs müssen gespeichert und ausgewertet resp. aggregiert werden können. Dabei sind die entsprechenden Vorgaben betreffend die zentrale Logging-Infrastruktur und die übrigen zu protokollierenden Daten zu berücksichtigen.
+
+
+>>>Vorgabe Technik
+>>>Nummer 11 
+>>>Titel
+Sicherheit des Basis-Images
+>>>Kurztext
+>>>Text
+Alle nicht benötigten Bestandteile der Software, die im Container ausgeführt wird, müssen deinstalliert werden. Die Konfiguration der Software muss gehärtet werden. Images externer Lieferanten müssen einen staging-Prozess durchlaufen.
+>>>Langtext
+>>>Text
+Die für den Container verwendeten Basis-Images müssen bekannt sein und dessen Sicherheits- und Schwachstellenstatus bewertet werden.
+
+Basis-Images müssen aus für das BIT vertrauenswürdigen Quellen stammen und regelmässig aktualisiert und mit den aktuellsten Sicherheits-Patches versehen werden.
+
+Das Image darf nur die für die Lösung/Anforderungen erforderlichen Package-Komponenten/Bibliotheken/Hilfsprogramme enthalten.
+
+_Hinweis:_ Aus Gründen der Unterstützung (Support-Verträge) durch Red Hat empfehlen wir, nur Red Hat UBI-Images als Basis-Images für selbst entwickelte Anwendungen zu verwenden. Es gibt kleinere Versionen von UBI, und es gibt UBI-Images, die Middleware-Pakete und von Red Hat unterstützte Sprachframeworks enthalten. Es gibt keine allgemeine Sicherheitsempfehlung für oder gegen UBI; entscheidend ist die Reduzierung der Angriffsfläche. Ein weiterer Vorteil eines Einsatzes von RedHat Images ist, dass sie VEX Files und die entsprechende Analyse mitliefern, was die Beurteilung von Vulnerabilities stark beschleunigt und unterstützt: https://www.cisa.gov/sites/default/files/2023-01/VEX_Use_Cases_Aprill2022.pdf
+
+Für die Anlieferung von Container Images externer Lieferanten muss ein dedizierter Staging Prozess verwendet werden, damit potentielle Schwachstellen frühzeitig erkannt und behoben werden können. Erst nach erfolgreichem Durchlaufen dieses Prozesses dürfen solche externe Container Images in den BIT internen Entwicklungsprozess und in produktive Umgebungen eingefügt werden.
+
+
+>>>Vorgabe Technik
+>>>Nummer 12
+>>>Titel
+Orchestrator-Installation nur aus offiziellen und vertrauten Quellen
+>>>Kurztext
+>>>Text
+Die Software des Orchestrators muss von einer offiziellen und vertrauten Quelle stammen.
+>>>Langtext
+>>>Text
+Die Software des Orchestrators muss von einer offiziellen und vertrauten Quelle stammen. Dies muss mit einer geeigneten Checksumme oder einem geeigneten Hash mit dem Softwarelieferanten gegengeprüft werden.
+
+>>>Vorgabe Technik
+>>>Nummer 13
+>>>Titel
+Hochverfügbarkeit (HA)
+>>>Kurztext
+>>>Text
+Der Container Orchestrator soll die Verfügbarkeit der Container ihrem Schutzbedarf entsprechend sicherstellen.
+>>>Langtext
+>>>Text
+Der Container Orchestrator sollte alle Container mit hohen oder sehr hohen Anforderungen an die Verfügbarkeit bei Ausfall von einem oder mehrere Knoten automatisch auf noch verfügbaren Knoten neu starten
+
+Der Orchestrator muss für HA, bzw. automatisches Failover konzipiert, bzw. konfiguriert sein.
+
+
+>>>Vorgabe Technik
+>>>Nummer  14
+>>>Titel
+Integritätsschutz für Container Images
+>>>Kurztext
+>>>Text
+Die Integrität der Container-Images muss gewährleistet und überprüfbar sein.
+>>>Langtext
+>>>Text
+Alle angelieferten Container Images müssen entweder signiert (nicht self-signed) sein oder der Hashwert des Container Images muss separat mitgeliefert oder auf der Webseite des Herstellers abrufbar sein.
+
+Wenn eine digitale Signatur vorhanden ist, muss diese geprüft werden, um seine Integrität und Authentizität sicherzustellen. Wenn der Container statt nach Tag nach Hash gezogen wird, ist eine Prüfung nicht erforderlich.
+
+
+>>>Vorgabe Technik
+>>>Nummer 15
+>>>Titel
+Durchführung von Image Rebuilds
+>>>Kurztext
+>>>Text
+Updates von Packages innerhalb eines Containers sind nicht erlaubt.
+>>>Langtext
+>>>Text
+Es ist nicht erlaubt, Updates von Packages durchzuführen, wenn diese Packages Bestandteil des Container Images sind. Der Grund liegt darin, dass falls eine Update Instruktion in einem Dockerfile vorhanden ist, derselbe Update Layer verwendet wird, der sich im Cache befindet. Dies verhindert, dass ein neueres Update nicht Bestandteil von nachfolgenden Builds wird. Dies gilt ebenso für applikatorische Build Images, diese müssen neu gebildet werden und dürfen nicht in einem laufenden Container gepatched werden.
+
+>>>Vorgabe Technik
+>>>Nummer 16
+>>>Titel
+Verwendung von expliziten Versionen bei Basis-Images
+>>>Kurztext
+>>>Text
+Images sollen mit expliziten Versionen geführt werden.
+>>>Langtext
+>>>Text
+Es muss jederzeit verifizierbar sein, welche Versionen der Images im Einsatz sind, dies um die Nachvollziehbarkeit und Reproduzierbarkeit der Images sicher zu stellen. Es muss eine explizite Version angegeben werden. Z. B. ist die Verwendung von Tags wie "latest" nicht zulässig.
+
+Von einer Verwendung des "Stable"-Tags wird ebenfalls abgeraten, da die Absenz einer expliziten Versionsnummern potenzielle Inkompatibilitäten zur Folge hat, und da eine Inventarisierung nach Versionsnummern so erschwert wird.
+
+
+>>>Vorgabe Technik
+>>>Nummer 17
+>>>Titel
+Container-Konfiguration
+>>>Kurztext
+>>>Text
+Die Konfiguration des Containers mit den Sicherheitsanforderungen der Applikation übereinstimmen.
+>>>Langtext
+>>>Text
+Die Konfiguration des Containers muss auf offene Ports, Volume-Mounts, Umgebungsvariablen, Einstiegspunkt, etc. geprüft werden und ob diese mit der beabsichtigten Funktionalität und den Sicherheitsanforderungen übereinstimmen.
+>>>text
+Folgende Vorgaben müssen immer umgesetzt sein:
+>>>Liste-geordnet
+Um potentielle Attacken zu minimieren dürfen nicht verwendete Ports nicht exponiert werden. Es dürfen nur Ports exponiert werden, die auch von der Anwendung gebraucht werden.
+Der Port 22 darf nicht verwendet werden. Auch ist die interaktive Verwendung von SSH in der Produktion nur mit einer Ausnahmebewilligung erlaubt.
+Unter 1024 dürfen nur die Standard-Ports verwendet werden. Über 1024 sollten Standard-Ports verwendet werden (siehe Service Name and Transport Protocol Port Number Registry (iana.org)).
+Die Default Security Context Constraints (SCC) unter RedHat dürfen nicht verändert werden (Creating security context constraints).
+
+
+>>>Vorgabe Technik
+>>>Nummer 18
+>>>Titel
+Health-Check
+>>>Kurztext
+>>>Text
+Die Anweisung "HEALTHCHECK" oder ähnliche Funktionalität muss jedem Container-Image hinzugefügt sein.
+>>>Langtext
+>>>Text
+Jeder Container muss über eine Funktionalität verfügen, über welche die aktuelle "Gesundheit" des Containers abgefragt werden kann. Diese Funktionalität muss von der Orchestrierungsinfrastruktur gelesen und ausgewertet werden können. Idealerweise ist die Funktionalität über die Infrastruktur so standardisiert wie möglich.
+
+>>>Vorgabe Technik
+>>>Nummer 19
+>>>Titel
+Konfiguration der Netzwerke
+>>>Kurztext
+>>>Text
+Container-Netzwerkverkehr muss segmentiert werden.
+>>>Langtext
+>>>Text
+Container-Netzwerkverkehr muss mittels Netzwerk Policies beschränkt werden (ein- und ausgehend). Der Ost-West und Nord-Süd-Verkehr muss segmentiert werden, um die Angriffsfläche zu minimieren und den Informationsfluss zu kontrollieren.
+
+Der Datenverkehr innerhalb der Namespaces muss mittels Netzwerk Policies gesteuert werden, um die Kommunikation zwischen Pods auf ein notwendiges Minimum zu beschränken.
+
+
+>>>Vorgabe Anwendungen
+>>>Nummer 1
+>>>Titel
+Persistenz von Zwischenergebnissen
+>>>Kurztext
+>>>Text
+Zwischenergebnisse, auf die die Anwendungen im Container zugreifen, müssen persistent ausserhalb des Containers gespeichert werden.
+>>>Langtext
+>>>Text
+Zwischenergebnisse, auf die die Anwendungen im Container zugreifen, müssen persistent ausserhalb des Containers gespeichert werden.
+
+Nutzdaten der Anwendung werden in der Regel auf einem Persistenten Volume ausserhalb des Containers abgelegt und angehängt und entsprechend gesichert. Zwischenergebnisse oder dateibasierten Protokolldaten, der Verarbeitung fällt eine fehlende Datensicherung oft nur dann auf, wenn ein Container beendet und entfernt ist und die enthaltenen Daten unwiderruflich verloren sind. Sind die Protokolldaten oder Zwischenergebnisse verloren, kann die Verarbeitung nicht lückenlos dokumentiert und somit deren Ergebnisse nicht mehr nachvollzogen werden.
+
+
+>>>Vorgabe Anwendungen
+>>>Nummer 2
+>>>Titel
+Kontinuierliche Container-Laufzeit-Überwachung
+>>>Kurztext
+>>>Text
+Das Laufzeitverhalten der Container muss auf Anomalien hin überwacht werden.
+>>>Langtext
+>>>Text
+Das Laufzeitverhalten der Container muss auf Anomalien hin überwacht werden. Dies umfasst beispielsweise Punkte wie:
+>>>Liste-ungeordnet
+Container kann nicht gestartet werden
+Container starten nicht wie erwartet
+Fehler bei liveness probes
+Überschreitung von Limiten (z.B. Ressourcen)
+
+
+>>>Vorgabe Anwendungen
+>>>Nummer 3
+>>>Titel
+Lizenzen
+>>>Kurztext
+>>>Text
+Die auf den Containern laufende Software muss lizenziert sein.
+>>>Langtext
+>>>Text
+Eine Übersicht der Lizenzbedingungen der eingesetzten Softwarekomponenten muss vorhanden sein und die Bestätigung, dass die Komponenten in der Bundesverwaltung eingesetzt werden dürfen (kommerzielles Einsatzgebiet).
+
+Eine nach Möglichkeit automatisierte Lizenzverwaltung für sämtliche im Container Image enthaltenen Software- Komponenten muss geführt werden.
+
+
+>>>Vorgabe Informationen
+>>>Nummer 1
+>>>Titel
+Container-Image-Metadaten
+>>>Kurztext
+>>>Text
+Die Metadaten der Container Images müssen in aktueller Version vorliegen und gepflegt werden.
+>>>Langtext
+>>>Text
+Die Metadaten des Container Images müssen geprüft werden (z. B. den Namen, die Version und die Beschreibung), um sicher zu stellen, dass die Metadaten den Zweck und den Inhalt des Containers genau wiedergeben.
+
+Für die Nachverfolgung (Nachvollziehbarkeit) und für die Behebung von Schwachstellen ist es notwendig die Images mit folgenden Informationen (Labels) zu ergänzen: Besitzer, Entwicklerteam, Lizenzinformation, Herleitung, Abhängigkeiten.
+
+
+>>>Vorgabe Informationen
+>>>Nummer 2
+>>>Titel
+Umgang mit Secrets
+>>>Kurztext
+>>>Text
+Container müssen auf Secrets gescannt werden.
+>>>Langtext
+>>>Text
+Container Images müssen regelmässig auf offengelegte Geheimnisse (Secrets, Passwörter, Schlüssel, etc.) gescannt werden. Secrets, Passwörter und Schlüssel dürfen nicht in Dockerfiles geschrieben werden.
+
+
+>>>Vorgabe Systeme
+>>>Nummer 1
+>>>Titel
+Identitätsmanagement der Administratoren
+>>>Kurztext
+>>>Text
+Alle administrativen Zugänge zum Container-Diensten muss durch personenbezogene Accounts und starke Authentisierung geschützt sein.
+>>>Langtext
+>>>Text
+Alle administrativen Zugänge zum Container-Diensten muss durch personenbezogene Accounts und starke Authentisierung geschützt sein. Zugänge, die von der Verwaltungssoftware genutzt werden, sollten ebenfalls durch separate Accounts und starke Authentisierung geschützt sein.
+
+Benutzerkonten und die zugehörigen Berechtigungen werden im BIT auf zentralen Systemen für das Identity-Management verwaltet. Damit diese Berechtigungsinformationen provisioniert werden können, muss das System entweder zentrale Schnittstellen (z. B. EIAM zur Autorisierung, Kerberos zur Authentisierung, Sperrlisteninformation bei Zertifikaten) oder dezentrale Mechanismen (z. B. Public-Key-Authentifizierung) unterstützen. Eine zentrale Lösung für das Identity-Management ist vorrangig zu nutzen.
+
+
+>>>Vorgabe Systeme
+>>>Nummer 2
+>>>Titel
+Accounts der Anwendungsdienste
+>>>Kurztext
+>>>Text
+Die Accounts innerhalb der Container dürfen keine Berechtigungen auf den Container-Host haben.
+>>>Langtext
+>>>Text
+Die Accounts innerhalb der Container dürfen keine Berechtigungen auf den Container-Host haben. Idealerweise sind die Accounts auf den Containern komplett auf die Container isoliert. Wenn es technisch notwendig ist, können Accounts über Container im gleichen Namespace geteilt werden.
+
+>>>Vorgabe Systeme
+>>>Nummer 3
+>>>Titel
+Verwendung einer Trusted Registry
+>>>Kurztext
+>>>Text
+Es muss sichergestellt sein, dass Images nur aus vertrauenswürdigen Quellen stammen.
+>>>Langtext
+>>>Text
+Die Container Images müssen in die Private Registry des BIT eingebunden werden können. Der Lieferant/Entwickler/Hersteller muss bestätigen, dass für alle im Container Image enthaltenen Software-Komponenten dies rechtlich in Ordnung ist. Alle Images werden vor der Aufnahme in die Private Registry auf Schwachstellen gescannt, bei schwerwiegenden Schwachstellen müssen die Container-Images vor der Aufnahme überarbeitet werden.
+
+Es dürfen keine Images von unbekannten Registries verwendet werden.
+
+
+>>>Vorgabe Systeme
+>>>Nummer 4
+>>>Titel
+Speicherung von Zugangsdaten für die Repositories
+>>>Kurztext
+>>>Text
+Zugangsdaten müssen so gespeichert und verwaltet werden, dass nur berechtigte Personen hierauf zugreifen können.
+>>>Langtext
+>>>Text
+Zugangsdaten müssen so gespeichert und verwaltet werden, dass nur berechtigte Personen hierauf zugreifen können. Insbesondere muss bei der Verwaltung der Images und der in den Images betriebenen Anwendungen darauf geachtet werden, dass die Zugangsdaten nur an zugangsgeschützten Orten gespeichert werden. Die von der Container-Software bereitgestellten Verwaltungsmechanismen für Zugangsdaten sollten eingesetzt werden.
+>>>Text
+Folgende Zugangsdaten müssen mindestens berücksichtigt werden:
+>>>Liste-ungeordnet
+Passwörter jeglicher Accounts,
+API-Keys für von der Anwendung genutzte Dienste sowie Private Schlüssel bei Public-Key Authentisierung
+
+
+>>>Vorgabe Systeme
+>>>Nummer 5
+>>>Titel
+Freigabe von Images (Containerfile)
+>>>Kurztext
+>>>Text
+Alle Containerfiles für den produktiven Betrieb müssen einen geeigneten Freigabeprozess durchlaufen.
+>>>Langtext
+>>>Text
+Alle Containerfiles für den produktiven Betrieb müssen einen geeigneten Freigabeprozess durchlaufen.
+
+Containerfiles enthalten die Bauanleitung für ein Image. D.h. enthält die notwendigen Anweisungen zum Erstellen eines Images und stellt so die Reproduzierbarkeit eines Images bei jeder neuen Erstellung sicher. Images sollten stets nur ein absolutes Minimum an Code beinhalten, gerade so viel, wie zwingend erforderlich ist, um den Service oder die Applikation auszuführen, für den das Image gedacht ist.
+
+
+>>>Vorgabe Systeme
+>>>Nummer 6
+>>>Titel
+Updates von Containern
+>>>Kurztext
+>>>Text
+Wenn sicherheitsrelevante Updates der zugrundeliegenden Images oder der betriebenen Software des Anwendungsdienstes erscheinen, müssen die Images für die Container neu erstellt und daraus neue Container instanziiert werden.
+>>>Langtext
+>>>Text
+Wenn sicherheitsrelevante Updates der zugrundeliegenden Images oder der betriebenen Software des Anwendungsdienstes erscheinen, müssen die Images für die Container neu erstellt und daraus neue Container instanziiert werden.
+
+Von extern bezogene Images sollten nur dann eingesetzt werden, wenn der Anbieter für diese Images auch regelmässig und bei sicherheitsrelevanten Änderungen schnell neue Versionen bereitstellt. Besser ist, wenn eine eigene Trusted Registry (z.B. Docker Trusted Registry DTR) bereitgestellt wird. Diese erweitert die klassische Registry um ein rollenbasiertes Zugangsmodell (RBAC), die Möglichkeit, Images digital zu signieren, und einen eingebauten Image-Scanner. Dabei sollte nebst den technische Massnahmen sichergestellt sein, dass nur Images aus dieser Registry eingesetzt werden.
+
+Hierbei hilft der Image-Scanner, die bekannten Verwundbarkeiten in Container-Images zu finden.
+
+
+>>>Vorgabe Systeme
+>>>Nummer 7
+>>>Titel
+Einbinden von Volumes
+>>>Kurztext
+>>>Text
+Die Container dürfen nur auf die für den Betrieb notwendigen Volumes und Verzeichnisse zugreifen können.
+>>>Langtext
+>>>Text
+Die Container dürfen nur auf die für den Betrieb notwendigen Volumes und Verzeichnisse zugreifen können. Wenn Schreibrechte nicht benötigt werden, müssen diese eingeschränkt werden. Der private Modus von Volumes muss genutzt werden, sofern es keine Notwendigkeit für den Shared-Modus gibt. Meist benötigen Container gar keinen Schreib-Zugriff auf ein Container-Directory im Shared-Storage-Modus. Gut ist es auch, wenn das verwendete Dateisystem Roll-Backs unterstützt.
+
+>>>Vorgabe Systeme
+>>>Nummer 8
+>>>Titel
+Sicherer Zugang zur Registry
+>>>Kurztext
+>>>Text
+Der Zugriff auf die Registry muss abgesichert werden.
+>>>Langtext
+>>>Text
+Der Zugriff auf die Registry muss zusätzlich zu den weiteren relevanten Vorgaben (z. B. IT-Grundschutz) wie folgt abgesichert werden:
+>>>Liste-ungeordnet
+Admin Zugriffe müssen via Privileged Access Management (PAM) erfolgen.
+RBAC (Role Based Access Management)
+
+
+>>>Vorgabe Systeme
+>>>Nummer 9
+>>>Titel
+Mengengerüst
+>>>Kurztext
+>>>Text
+Requests und Limits müssen entsprechend den Anforderungen der Anwendungen definiert sein.
+>>>Langtext
+>>>Text
+Requests und Limits müssen entsprechend den Anforderungen der Anwendungen definiert sein.
+>>>text
+Bedeutung:
+>>>Liste-ungeordnet
+Angemessene CPU- und Speicheranforderungen und Grenzwerte für Pods auf der Grundlage der erwarteten Last müssen definiert sein.
+Es muss ein Kapazitätsmanagement-/Rechte-Sizing-Prozess definiert und angewandt werden. Der Ressourcenverbrauch der Pods muss regelmässig überprüft und an die Anforderungen/Limits angepasst werden.
+Ein Leistungstest kann definiert und durchgeführt werden, um zu verstehen, wo die Grenzen der Anwendung liegen und wie hoch die durchschnittliche Arbeitslast ist.
+Deployments müssen über mindestens zwei RZ bereitgestellt sein.
+>>>text
+Mehr Information: [RedHat OpenShift](https://docs.openshift.com/container-platform/4.12/applications/quotas/quotas-setting-per-project.html)
+
+
+>>>Vorgabe Systeme
+>>>Nummer 10
+>>>Titel
+Externe Libraries
+>>>Kurztext
+>>>Text
+Externe Libraries müssen sicherheitsüberprüft sein
+>>>Langtext
+>>>Text
+Externe Libraries müssen sicherheitsüberprüft sein
+>>>Liste-ungeordnet
+Ein automatisiertes Dependency Scanning der im Container Image enthaltenen Third Party Libraries muss durchgeführt werden.
+Es muss geprüft werden, ob es veraltete oder anfällige Komponenten gibt. Für diese Pakete müssen die neuesten Sicherheitspatches eingepflegt werden, bevor sie in Produktion gehen.
+
+
+>>>Vorgabe Systeme
+>>>Nummer 11
+>>>Titel
+Schwachstellenanalyse für Container Images
+>>>Kurztext
+>>>Text
+Container-Images müssen auf Schwachstellen gescannt werden.
+>>>Langtext
+>>>Text
+Container Images sollten zum Zeitpunkt der Erstellung, in der Registrierung, bei der Bereitstellung und während der Laufzeit regelmässig gescannt werden, um neue Schwachstellen im Laufe der Zeit (Drift) erkennen zu können.
+
+>>>Vorgabe Systeme
+>>>Nummer 12
+>>>Titel
+Bekannte Schwachstellen
+>>>Kurztext
+>>>Text
+Deployment aktualisierter Container Images mit bekannten Schwachstellen wird eingeschränkt
+>>>Langtext
+>>>Text
+Eine aktualisierte Version eines Container Images mit bekannten Schwachstellen, welches heute bereits in Produktion ist, darf nur eingespielt werden, wenn die aktualisierte Version nur die gleichen Schwachstellen oder (besser) weniger Schwachstellen aufweist. Dies muss durch den ISBO des Data Owners abgenommen sein.
+
+>>>Vorgabe Systeme
+>>>Nummer 13
+>>>Titel
+Registries / Partitionen für die Bereitstellung
+>>>Kurztext
+>>>Text
+Produktive und nicht-produktive Umgebungen müssen getrennt werden.
+>>>Langtext
+>>>Text
+Produktionsumgebungen müssen von Entwicklungs- und/oder nicht-Produktiven Umgebungen getrennt werden, das heisst es müssen separate Registries oder Partitionen verwendet werden.
+
+>>>Vorgabe Systeme
+>>>Nummer 14
+>>>Titel
+Privilegien / Zugriffsrechte
+>>>Kurztext
+>>>Text
+Das "Least Privilege"-Prinzip muss auf Containern umgesetzt werden.
+>>>Langtext
+>>>Text
+Container müssen als Nicht-Root-Benutzer ausgeführt werden (z.B. USER ${UID} for OpenShift "mustRunAsNonRoot"). Container werden standardmäßig als "root" ausgeführt, dies ist ein Risiko, insbesondere wenn der Container mit erhöhten Privilegien ausgeführt wird.
+
+Container müssen immer mit so wenig Privilegien wie möglich ausgestattet sein. Es dürfen nur ein minimales Set an privilegierten Zugriffen vorhanden sein und diese sind nur für die Behandlung von Notfällen vorgesehen. Namespaces müssen als "read-only" laufen.
+
+Für die Definition von Rollen darf nur das notwendige Set an Ressourcen und Manipulationen verwendet werden.
+
+
+
+>>>Vorgabe Zonen
+>>>Nummer 1
+>>>Titel
+Separierung der Netze
+>>>Kurztext
+>>>Text
+Die Netze müssen der jeweiligen Zonen-Policy der Bundesverwaltung entsprechen.
+>>>Langtext
+>>>Text
+Die Netze für die Administration des Hosts, die Administration der Container- und die einzelnen Netze der Anwendungsdienste müssen den jeweiligen Zonenpolicies entsprechen. Wenn Unbefugte auf das Datennetz oder auf den Containern-Hosts zugreifen, können sie nicht über ungeschützte administrative Zugänge Befehle ausführen, die der Verfügbarkeit, Vertraulichkeit und Integrität der verarbeitenden Daten schaden.
+
+>>>Vorgabe Zonen
+>>>Nummer 2
+>>>Titel
+Verschlüsselung der Netzkommunikation
+>>>Kurztext
+>>>Text
+Daten, die über virtuelle oder physische Netze zwischen den Containern übertragen werden, müssen verschlüsselt sein.
+>>>Langtext
+>>>Text
+Mechanismen zur Authentisierung und Verschlüsselung der Zugänge sind häufig vorhanden, aber nicht standardmässig aktiviert. Entwickler müssen sich auf das „Absichern” der Applikation konzentrieren, als sich auf physische Netzwerk-Security-Tools zu verlassen. Physische Firewalls und andere Arten von Perimeter-Netzwerken/DMZs funktionieren nämlich in einer Container-basierten Umgebung meist nicht.
+>>>Stichworte Netzwerkkommunikation, Verschlüsselung
+>>>Checkliste
+Die Netzkommunikation ist verschlüsselt.

Documentation/modelle.md

@@ -0,0 +1,544 @@
+# Alle Modelle der vgui-cicd Django-Anwendung
+
+Dieses Dokument beschreibt alle Datenmodelle in der vgui-cicd Anwendung mit ihren Eigenschaften, Beziehungen und Verwendungszwecken.
+
+---
+
+## App: dokumente
+
+Die Hauptmodelle für die Verwaltung von Dokumenten, Vorgaben und deren Metadaten.
+
+### Dokumententyp
+
+**Zweck**: Kategorisierung von Dokumenten (z. B. Richtlinie, Standard).
+
+**Wichtige Felder**:
+- `name` (CharField, max_length=100, **PRIMARY KEY**)
+- `verantwortliche_ve` (CharField, max_length=255): Die verantwortliche Verwaltungseinheit
+
+**Besonderheiten**:
+- `__str__()` gibt den Namen zurück
+- Dient als Klassifizierungskategorie für Dokumente
+
+**Meta**:
+- `verbose_name = "Dokumententyp"`
+- `verbose_name_plural = "Dokumententypen"`
+
+---
+
+### Person
+
+**Zweck**: Repräsentiert Personen, die als Autoren, Prüfer oder in anderen Rollen tätig sind.
+
+**Wichtige Felder**:
+- `name` (CharField, max_length=100, **PRIMARY KEY**)
+- `funktion` (CharField, max_length=255): Funktionsbezeichnung der Person
+
+**Beziehungen**:
+- Many-to-Many mit `Dokument` über `verfasste_dokumente` (Autoren)
+- Many-to-Many mit `Dokument` über `gepruefte_dokumente` (Prüfer)
+
+**Besonderheiten**:
+- `__str__()` gibt den Namen zurück
+- `ordering = ['name']`: Alphabetische Sortierung
+
+**Meta**:
+- `verbose_name_plural = "Personen"`
+
+---
+
+### Thema
+
+**Zweck**: Thematische Einordnung und Kategorisierung von Vorgaben innerhalb von Dokumenten.
+
+**Wichtige Felder**:
+- `name` (CharField, max_length=100, **PRIMARY KEY**)
+- `erklaerung` (TextField, blank=True): Optionale Erklärung des Themas
+
+**Besonderheiten**:
+- `__str__()` gibt den Namen zurück
+- Der erste Buchstabe des Themas wird in Vorgabennummern verwendet
+
+**Meta**:
+- `verbose_name_plural = "Themen"`
+
+---
+
+### Dokument
+
+**Zweck**: Hauptmodell für ein einzelnes Dokument mit allen zugehörigen Metadaten und Inhalten.
+
+**Wichtige Felder**:
+- `nummer` (CharField, max_length=50, **PRIMARY KEY**): Eindeutige Dokumentennummer
+- `dokumententyp` (ForeignKey → Dokumententyp, on_delete=PROTECT): Klassifizierung
+- `name` (CharField, max_length=255): Dokumenttitel
+- `autoren` (ManyToManyField → Person, related_name='verfasste_dokumente')
+- `pruefende` (ManyToManyField → Person, related_name='gepruefte_dokumente')
+- `gueltigkeit_von` (DateField, null=True, blank=True): Gültig ab Datum
+- `gueltigkeit_bis` (DateField, null=True, blank=True): Gültig bis Datum
+- `signatur_cso` (CharField, max_length=255, blank=True): CSO-Signatur
+- `anhaenge` (TextField, blank=True): Beschreibung von Anhängen
+- `aktiv` (BooleanField, blank=True): Aktivierungsstatus
+
+**Beziehungen**:
+- 1-to-Many mit `Vorgabe` (über related_name='vorgaben')
+- 1-to-Many mit `Geltungsbereich`
+- 1-to-Many mit `Einleitung`
+- 1-to-Many mit `Changelog`
+
+**Besonderheiten**:
+- `__str__()` formatiert als "nummer – name"
+
+**Meta**:
+- `verbose_name = "Dokument"`
+- `verbose_name_plural = "Dokumente"`
+
+---
+
+### Vorgabe
+
+**Zweck**: Repräsentiert eine einzelne Vorgabe oder Anforderung innerhalb eines Dokuments.
+
+**Wichtige Felder**:
+- `order` (IntegerField): Sortierreihenfolge für die Darstellung
+- `nummer` (IntegerField): Nummer innerhalb eines Themas/Dokuments. Muss nicht eindeutig sein (z.B. für geänderte Vorgaben)
+- `dokument` (ForeignKey → Dokument, on_delete=CASCADE, related_name='vorgaben')
+- `thema` (ForeignKey → Thema, on_delete=PROTECT): Thematische Einordnung
+- `titel` (CharField, max_length=255): Titel der Vorgabe
+- `referenzen` (ManyToManyField → Referenz, blank=True): Verweise auf externe Referenzen
+- `gueltigkeit_von` (DateField): Gültig ab Datum
+- `gueltigkeit_bis` (DateField, blank=True, null=True): Gültig bis Datum (offen = unbegrenzt)
+- `stichworte` (ManyToManyField → Stichwort, blank=True): Tags zur Kategorisierung
+- `relevanz` (ManyToManyField → Rolle, blank=True): Relevante Rollen
+
+**Beziehungen**:
+- Foreign Key zu `Dokument` und `Thema`
+- Many-to-Many zu `Referenz`, `Stichwort`, `Rolle`
+- 1-to-Many zu `VorgabeLangtext`, `VorgabeKurztext`
+- 1-to-Many zu `Checklistenfrage`
+
+**Wichtige Methoden**:
+
+- `Vorgabennummer()` → str
+  - Generiert eine eindeutige, lesbare Kennummer
+  - Format: "{dokument.nummer}.{thema.name[0]}.{nummer}"
+  - Beispiel: "R0066.A.1"
+
+- `get_status(check_date=None, verbose=False)` → str
+  - Bestimmt den Status einer Vorgabe zu einem gegebenen Datum
+  - Parameter: `check_date` (Default: heute), `verbose` (Deutsche Beschreibung ja/nein)
+  - Rückgabewerte:
+    - "future": Vorgabe ist noch nicht gültig
+    - "active": Vorgabe ist aktuell gültig
+    - "expired": Vorgabe ist nicht mehr gültig
+  - Verbose-Ausgaben enthalten Datumsangaben
+
+- `sanity_check_vorgaben()` (statisch) → list
+  - Findet zeitliche Konflikte zwischen Vorgaben mit gleicher Nummer/Thema/Dokument
+  - Überprüft, ob sich Geltungszeiträume überschneiden
+  - Gibt Liste mit Konflikt-Dictionaries zurück
+
+- `clean()`
+  - Validiert die Vorgabe vor dem Speichern
+  - Ruft `find_conflicts()` auf
+  - Wirft `ValidationError` bei erkannten Konflikten
+
+- `find_conflicts()` → list
+  - Findet Konflikte mit bestehenden Vorgaben (ausgenommen self)
+  - Überprüft auf zeitliche Überschneidungen
+  - Gibt Liste mit Konflikt-Details zurück
+
+- `_date_ranges_intersect(start1, end1, start2, end2)` (statisch) → bool
+  - Prüft, ob zwei Datumsbereiche sich überschneiden
+  - `None` als Enddatum = unbegrenzter Bereich
+  - Gibt `True` bei Überschneidung zurück
+
+**Besonderheiten**:
+- `__str__()` gibt "Vorgabennummer: titel" zurück
+- Validierung von Gültigkeitszeiträumen ist implementiert
+- Sehr wichtiges Modell im Geschäftslogik-Kontext
+
+**Meta**:
+- `ordering = ['order']`
+- `verbose_name_plural = "Vorgaben"`
+
+---
+
+### VorgabeLangtext
+
+**Zweck**: Speichert ausführliche Textinhalte (Langtext) einer Vorgabe.
+
+**Wichtige Felder**:
+- `abschnitt` (ForeignKey → Vorgabe, on_delete=CASCADE): Referenz zur Vorgabe
+- Erbt von `Textabschnitt` (siehe App: abschnitte):
+  - `abschnitttyp` (ForeignKey → AbschnittTyp, optional)
+  - `inhalt` (TextField, blank=True, null=True)
+  - `order` (PositiveIntegerField, default=0)
+
+**Meta**:
+- `verbose_name = "Langtext-Abschnitt"`
+- `verbose_name_plural = "Langtext"`
+
+---
+
+### VorgabeKurztext
+
+**Zweck**: Speichert kurze Textinhalte (Kurztext) einer Vorgabe.
+
+**Wichtige Felder**:
+- `abschnitt` (ForeignKey → Vorgabe, on_delete=CASCADE): Referenz zur Vorgabe
+- Erbt von `Textabschnitt` (siehe App: abschnitte):
+  - `abschnitttyp` (ForeignKey → AbschnittTyp, optional)
+  - `inhalt` (TextField, blank=True, null=True)
+  - `order` (PositiveIntegerField, default=0)
+
+**Meta**:
+- `verbose_name = "Kurztext-Abschnitt"`
+- `verbose_name_plural = "Kurztext"`
+
+---
+
+### Geltungsbereich
+
+**Zweck**: Speichert den Geltungsbereich-Abschnitt eines Dokuments.
+
+**Wichtige Felder**:
+- `geltungsbereich` (ForeignKey → Dokument, on_delete=CASCADE): Referenz zum Dokument
+- Erbt von `Textabschnitt` (siehe App: abschnitte):
+  - `abschnitttyp` (ForeignKey → AbschnittTyp, optional)
+  - `inhalt` (TextField, blank=True, null=True)
+  - `order` (PositiveIntegerField, default=0)
+
+**Meta**:
+- `verbose_name = "Geltungsbereichs-Abschnitt"`
+- `verbose_name_plural = "Geltungsbereich"`
+
+---
+
+### Einleitung
+
+**Zweck**: Speichert die Einleitungs-Abschnitte eines Dokuments.
+
+**Wichtige Felder**:
+- `einleitung` (ForeignKey → Dokument, on_delete=CASCADE): Referenz zum Dokument
+- Erbt von `Textabschnitt` (siehe App: abschnitte):
+  - `abschnitttyp` (ForeignKey → AbschnittTyp, optional)
+  - `inhalt` (TextField, blank=True, null=True)
+  - `order` (PositiveIntegerField, default=0)
+
+**Meta**:
+- `verbose_name = "Einleitungs-Abschnitt"`
+- `verbose_name_plural = "Einleitung"`
+
+---
+
+### Checklistenfrage
+
+**Zweck**: Repräsentiert eine Frage für die Checkliste zu einer Vorgabe.
+
+**Wichtige Felder**:
+- `vorgabe` (ForeignKey → Vorgabe, on_delete=CASCADE, related_name='checklistenfragen')
+- `frage` (CharField, max_length=255): Text der Checklistenfrage
+
+**Besonderheiten**:
+- `__str__()` gibt den Fragetext zurück
+
+**Meta**:
+- `verbose_name = "Frage für Checkliste"`
+- `verbose_name_plural = "Fragen für Checkliste"`
+
+---
+
+### VorgabenTable
+
+**Zweck**: Proxy-Modell für `Vorgabe` für die Darstellung von Vorgaben in Tabellenform.
+
+**Besonderheiten**:
+- Proxy-Modell (kein eigenes Datenbankschema)
+- Ermöglicht alternative Django-Admin-Ansicht
+- Erbt alle Felder und Methoden von `Vorgabe`
+
+**Meta**:
+- `proxy = True`
+- `verbose_name = "Vorgabe (Tabellenansicht)"`
+- `verbose_name_plural = "Vorgaben (Tabellenansicht)"`
+
+---
+
+### Changelog
+
+**Zweck**: Dokumentiert Änderungen und Versionshistorie für Dokumente.
+
+**Wichtige Felder**:
+- `dokument` (ForeignKey → Dokument, on_delete=CASCADE, related_name='changelog'): Referenz zum Dokument
+- `autoren` (ManyToManyField → Person): Personen, die die Änderung vorgenommen haben
+- `datum` (DateField): Datum der Änderung
+- `aenderung` (TextField): Beschreibung der Änderung
+
+**Beziehungen**:
+- Foreign Key zu `Dokument`
+- Many-to-Many zu `Person`
+
+**Besonderheiten**:
+- `__str__()` formatiert als "datum – dokumentnummer"
+
+**Meta**:
+- `verbose_name = "Changelog-Eintrag"`
+- `verbose_name_plural = "Changelog"`
+
+---
+
+## App: abschnitte
+
+Modelle für die Verwaltung von Textabschnitten, die von mehreren Modellen geerbt werden.
+
+### AbschnittTyp
+
+**Zweck**: Klassifizierung von Textabschnitten (z. B. "Beschreibung", "Erklärung", "Anleitung").
+
+**Wichtige Felder**:
+- `abschnitttyp` (CharField, max_length=100, **PRIMARY KEY**): Name des Abschnitttyps
+
+**Besonderheiten**:
+- `__str__()` gibt den Namen zurück
+
+**Meta**:
+- `verbose_name_plural = "Abschnitttypen"`
+
+---
+
+### Textabschnitt (abstrakt)
+
+**Zweck**: Abstrakte Basisklasse für Textinhalte, die mit anderen Modellen verknüpft sind.
+
+**Wichtige Felder**:
+- `abschnitttyp` (ForeignKey → AbschnittTyp, on_delete=PROTECT, optional)
+- `inhalt` (TextField, blank=True, null=True): Der Textinhalt
+- `order` (PositiveIntegerField, default=0): Sortierreihenfolge
+
+**Besonderheiten**:
+- Abstrakte Klasse (wird nicht direkt in der Datenbank gespeichert)
+- Wird von anderen Modellen geerbt: `VorgabeLangtext`, `VorgabeKurztext`, `Geltungsbereich`, `Einleitung`, `Referenzerklaerung`, `Stichworterklaerung`, `RollenBeschreibung`
+
+**Meta**:
+- `abstract = True`
+- `verbose_name = "Abschnitt"`
+- `verbose_name_plural = "Abschnitte"`
+
+---
+
+## App: referenzen
+
+Modelle für die Verwaltung von Referenzen und Verweisen auf externe Standards.
+
+### Referenz (MPTT-Tree)
+
+**Zweck**: Hierarchische Verwaltung von Referenzen und externen Normen (z. B. ISO-Standards, Gesetze, übergeordnete Vorgaben).
+
+**Wichtige Felder**:
+- `id` (AutoField, **PRIMARY KEY**)
+- `name_nummer` (CharField, max_length=100): Nummer/Kennung der Referenz (z. B. "ISO 27001")
+- `name_text` (CharField, max_length=255, blank=True): Ausführlicher Name/Beschreibung
+- `oberreferenz` (TreeForeignKey zu self, optional): Parent-Referenz für Hierarchien
+- `url` (URLField, blank=True): Link zur Referenz
+
+**Beziehungen**:
+- Many-to-Many mit `Vorgabe`
+- MPTT Tree-Struktur für hierarchische Referenzen
+
+**Wichtige Methoden**:
+
+- `Path()` → str
+  - Gibt die vollständige Pfad-Hierarchie als String zurück
+  - Format: "Referenz → Subreferenz → Unterreferenz (Beschreibung)"
+  - Beispiel: "ISO → 27000 → 27001 (Information Security Management)"
+
+**Besonderheiten**:
+- Verwendet MPPT (Modified Preorder Tree Traversal) für Baumoperationen
+- `get_ancestors(include_self=True)`: Gibt alle Vorfahren zurück
+- `unterreferenzen`: Related_name für Kindreferenzen
+- Sortierung: Nach `name_nummer`
+
+**Meta**:
+- `verbose_name_plural = "Referenzen"`
+- **MPTTMeta**:
+  - `parent_attr = 'oberreferenz'`
+  - `order_insertion_by = ['name_nummer']`
+
+---
+
+### Referenzerklaerung
+
+**Zweck**: Speichert Erklärungen und zusätzliche Informationen zu einer Referenz.
+
+**Wichtige Felder**:
+- `erklaerung` (ForeignKey → Referenz, on_delete=CASCADE): Referenz zur Referenz
+- Erbt von `Textabschnitt`:
+  - `abschnitttyp` (ForeignKey → AbschnittTyp, optional)
+  - `inhalt` (TextField, blank=True, null=True)
+  - `order` (PositiveIntegerField, default=0)
+
+**Meta**:
+- `verbose_name = "Erklärung"`
+- `verbose_name_plural = "Erklärungen"`
+
+---
+
+## App: stichworte
+
+Modelle für die Verwaltung von Stichworte und Tags.
+
+### Stichwort
+
+**Zweck**: Einfache Tag/Keyword-Modell zur Kategorisierung von Vorgaben.
+
+**Wichtige Felder**:
+- `stichwort` (CharField, max_length=50, **PRIMARY KEY**): Das Stichwort
+
+**Beziehungen**:
+- Many-to-Many mit `Vorgabe`
+
+**Besonderheiten**:
+- `__str__()` gibt das Stichwort zurück
+
+**Meta**:
+- `verbose_name_plural = "Stichworte"`
+
+---
+
+### Stichworterklaerung
+
+**Zweck**: Speichert Erklärungen zu Stichworten.
+
+**Wichtige Felder**:
+- `erklaerung` (ForeignKey → Stichwort, on_delete=CASCADE): Referenz zum Stichwort
+- Erbt von `Textabschnitt`:
+  - `abschnitttyp` (ForeignKey → AbschnittTyp, optional)
+  - `inhalt` (TextField, blank=True, null=True)
+  - `order` (PositiveIntegerField, default=0)
+
+**Meta**:
+- `verbose_name = "Erklärung"`
+- `verbose_name_plural = "Erklärungen"`
+
+---
+
+## App: rollen
+
+Modelle für die Verwaltung von Rollen und deren Beschreibungen.
+
+### Rolle
+
+**Zweck**: Definiert Rollen/Positionen im Unternehmen (z. B. "Geschäftsleiter", "IT-Sicherheit", "Datenschutzbeauftragter").
+
+**Wichtige Felder**:
+- `name` (CharField, max_length=100, **PRIMARY KEY**): Name der Rolle
+
+**Beziehungen**:
+- Many-to-Many mit `Vorgabe` (über `relevanz`)
+
+**Besonderheiten**:
+- `__str__()` gibt den Namen zurück
+- Wird verwendet, um Rollen zu markieren, die von einer Vorgabe betroffen sind
+
+**Meta**:
+- `verbose_name_plural = "Rollen"`
+
+---
+
+### RollenBeschreibung
+
+**Zweck**: Speichert detaillierte Beschreibungen und Informationen zu einer Rolle.
+
+**Wichtige Felder**:
+- `abschnitt` (ForeignKey → Rolle, on_delete=CASCADE): Referenz zur Rolle
+- Erbt von `Textabschnitt`:
+  - `abschnitttyp` (ForeignKey → AbschnittTyp, optional)
+  - `inhalt` (TextField, blank=True, null=True)
+  - `order` (PositiveIntegerField, default=0)
+
+**Meta**:
+- `verbose_name = "Rollenbeschreibungs-Abschnitt"`
+- `verbose_name_plural = "Rollenbeschreibung"`
+
+---
+
+## Allgemeine Hinweise zur Modellverwaltung
+
+### Primärschlüssel-Strategie
+- Viele Modelle verwenden CharField-basierte Primärschlüssel (`name`, `nummer`, `stichwort`)
+- Dies ermöglicht direkte Verwendung von Strings als Identifikatoren
+- Vorteil: Lesbarkeit; Nachteil: Umbenennungen sind kritisch
+
+### On-Delete-Strategien
+- **PROTECT**: Verwendet für wichtige Beziehungen (z. B. Dokumententyp, Thema, AbschnittTyp)
+  - Verhindert versehentliches Löschen von Daten, auf die verwiesen wird
+- **CASCADE**: Verwendet für Unterkomponenten (z. B. Vorgabe → Dokument)
+  - Löscht abhängige Datensätze automatisch
+- **SET_NULL**: Nur bei optionalen Referenzen (z. B. Oberreferenz in Referenz-Tree)
+
+### Validierungsmechanismen
+- **Vorgabe.clean()**: Validiert Gültigkeitszeiträume
+- **Vorgabe.find_conflicts()**: Prüft zeitliche Überschneidungen
+- Wird von Django-Admin automatisch aufgerufen vor dem Speichern
+
+### MPTT (Modified Preorder Tree Traversal)
+- Verwendet in `Referenz` für hierarchische Strukturen
+- Ermöglicht effiziente Abfragen von Vorfahren und Nachkommen
+- Zusätzliche Datenbank-Felder für Tree-Management (automatisch verwaltet)
+
+### Textabschnitt-Vererbung
+- Mehrere Modelle erben von `Textabschnitt`
+- Wird verwendet für Lang-/Kurztexte, Erklärungen, Beschreibungen
+- `order`-Feld ermöglicht Sortierung mehrerer Abschnitte
+
+### Datumsverwaltung
+- `gueltigkeit_von`: Immer erforderlich für Vorgaben
+- `gueltigkeit_bis`: Optional; `None` bedeutet unbegrenzte Gültigkeit
+- `_date_ranges_intersect()` prüft korrekt auf Überschneidungen mit None-Werten
+
+### Many-to-Many-Beziehungen
+- Vielfach verwendet für flexible Zuordnungen (Autoren, Stichworte, Rollen, Referenzen)
+- `related_name`-Attribute ermöglichen rückwärts Zugriff
+- Beispiel: `dokument.vorgaben.all()`, `person.verfasste_dokumente.all()`
+
+---
+
+## Zusammenfassung der Beziehungen
+
+```
+Dokumententyp ← Dokument
+Person ← Dokument (Autoren/Prüfer)
+Dokument → Vorgabe (1-to-Many)
+Dokument → Geltungsbereich (1-to-Many)
+Dokument → Einleitung (1-to-Many)
+Dokument → Changelog (1-to-Many)
+
+Thema ← Vorgabe
+Vorgabe → VorgabeLangtext (1-to-Many)
+Vorgabe → VorgabeKurztext (1-to-Many)
+Vorgabe → Checklistenfrage (1-to-Many)
+Vorgabe ← Referenz (Many-to-Many)
+Vorgabe ← Stichwort (Many-to-Many)
+Vorgabe ← Rolle (Many-to-Many)
+
+Referenz → Referenz (Hierarchie via MPPT)
+Referenz → Referenzerklaerung (1-to-Many)
+
+Stichwort → Stichworterklaerung (1-to-Many)
+
+Rolle → RollenBeschreibung (1-to-Many)
+
+AbschnittTyp ← Textabschnitt (von verschiedenen Modellen geerbt)
+```
+
+---
+
+## Entwicklungsrichtlinien
+
+- Alle Modelle sollten aussagekräftige `__str__()`-Methoden haben
+- `verbose_name` und `verbose_name_plural` sollten auf Deutsch sein (für Django-Admin)
+- Validierungslogik (z. B. `clean()`) sollte implementiert werden für komplexe Business-Logic
+- Related-Names sollten aussagekräftig und konsistent sein
+- Textinhalte sollten die `Textabschnitt`-Basisklasse erben
+- Datumsverwaltung: Immer auf None-Werte bei `gueltigkeit_bis` achten, wenn Vorgaben noch aktiv sind.

Documentation/modelle_dokumente.md

@@ -0,0 +1,92 @@
+# Modelle (App: dokumente)
+
+Kurzbeschreibungen der Modelle in dokumente/models.py. 
+
+## Dokumententyp
+- Zweck: Kategorisierung von Dokumenten (z. B. Richtlinie, Verfahren).
+- Wichtige Felder: `name` (CharField, PK), `verantwortliche_ve` (CharField).
+- Besonderheiten: `__str__()` gibt `name` zurück.
+- Meta: `verbose_name` und `verbose_name_plural` gesetzt.
+
+## Person
+- Zweck: Repräsentiert Personen (Autoren, Prüfer).
+- Wichtige Felder: `name` (CharField, PK), `funktion` (CharField).
+- Beziehungen: Many-to-many mit Dokument über `autoren` und `pruefende`.
+- Besonderheiten: `__str__()` gibt `name` zurück; `ordering = ['name']`.
+- Meta: `verbose_name_plural = "Personen"`.
+
+## Thema
+- Zweck: Thematische Einordnung von Vorgaben.
+- Wichtige Felder: `name` (CharField, PK), `erklaerung` (TextField, optional).
+- Besonderheiten: `__str__()` gibt `name` zurück.
+
+## Dokument
+- Zweck: Hauptobjekt; ein einzelnes Dokument mit Metadaten.
+- Wichtige Felder:
+  - `nummer` (CharField, PK)
+  - `dokumententyp` (FK → Dokumententyp, on_delete=PROTECT)
+  - `name` (CharField)
+  - `autoren`, `pruefende` (ManyToManyField → Person)
+  - `gueltigkeit_von`, `gueltigkeit_bis` (DateField, optional)
+  - `aktiv` (BooleanField)
+  - `signatur_cso`, `anhaenge` (Metadaten)
+- Besonderheiten: `__str__()` formatiert als "nummer – name".
+- Meta: `verbose_name` / `verbose_name_plural`.
+
+## Vorgabe
+- Zweck: Einzelne Vorgabe / Anforderung innerhalb eines Dokuments.
+- Wichtige Felder:
+  - `order` (IntegerField) — Sortierreihenfolge
+  - `nummer` (IntegerField) — Nummer innerhalb Thema/Dokument
+  - `dokument` (FK → Dokument, CASCADE, related_name='vorgaben')
+  - `thema` (FK → Thema, PROTECT)
+  - `titel` (CharField)
+  - `referenzen` (M2M → Referenz, optional)
+  - `stichworte` (M2M → Stichwort, optional)
+  - `relevanz` (M2M → Rolle, optional)
+  - `gueltigkeit_von`, `gueltigkeit_bis` (Datum/Felder)
+- Beziehungen: zu Dokument, Thema, Referenzen, Stichworte, Rollen.
+- Wichtige Methoden:
+  - `Vorgabennummer()` — generiert eine lesbare Kennung (z. B. "DOK. T. N").
+  - `get_status(check_date, verbose)` — liefert "future", "active" oder "expired" oder eine deutsche Statusbeschreibung, abhängig von Gültigkeitsdaten.
+  - `sanity_check_vorgaben()` (static) — findet Konflikte zwischen Vorgaben mit gleicher Nummer/Thema/Dokument, deren Zeiträume sich überschneiden.
+  - `clean()` — ruft `find_conflicts()` auf und wirft ValidationError bei Konflikten.
+  - `find_conflicts()` — prüft Konflikte mit bestehenden Vorgaben (ohne sich selbst).
+  - `_date_ranges_intersect(...)` (static) — prüft, ob sich zwei Datumsbereiche überschneiden (None = offen).
+- Besonderheiten: `__str__()` gibt "Vorgabennummer: titel" zurück.
+- Meta: `ordering = ['order']`, `verbose_name_plural = "Vorgaben"`.
+
+## VorgabeLangtext, VorgabeKurztext
+- Zweck: Textabschnitts-Modelle, erben von `Textabschnitt` (aus abschnitte.models).
+- Wichtige Felder: je ein FK `abschnitt` → Vorgabe.
+- Besonderheit: konkrete Untertypen für Lang- und Kurztexte; Meta-`verbose_name` gesetzt.
+
+## Geltungsbereich, Einleitung
+- Zweck: Dokumentbezogene Textabschnitte (erben von `Textabschnitt`).
+- Wichtige Felder: FK zum `Dokument` (`geltungsbereich` bzw. `einleitung`).
+- Meta: `verbose_name`/`verbose_name_plural` gesetzt.
+
+## Checklistenfrage
+- Zweck: Einzelne Frage für Checklisten zu einer Vorgabe.
+- Wichtige Felder: `vorgabe` (FK → Vorgabe, related_name="checklistenfragen"), `frage` (CharField).
+- Besonderheiten: `__str__()` gibt `frage` zurück.
+
+## VorgabenTable
+- Zweck: Proxy-Modell für Vorgabe zur Darstellung (Tabellenansicht).
+- Besonderheiten: kein eigenes Schema; nur Meta-Attribute (`proxy = True`, `verbose_name`).
+
+## Changelog
+- Zweck: Änderungsverzeichnis-Eintrag für ein Dokument.
+- Wichtige Felder:
+  - `dokument` (FK → Dokument, related_name='changelog')
+  - `autoren` (M2M → Person)
+  - `datum` (DateField)
+  - `aenderung` (TextField)
+- Besonderheiten: `__str__()` formatiert als "datum – dokumentnummer".
+- Meta: `verbose_name` / `verbose_name_plural`.
+
+Hinweise zur Pflege
+- Wichtige Relationen nutzen häufig on_delete=PROTECT, um versehentliche Löschungen zu vermeiden.
+- Viele Modelle haben CharField-Primärschlüssel (z. B. `nummer`, `name`).
+- Validierungslogik für zeitliche Konflikte ist in Vorgabe implementiert (clean / find_conflicts).
+- Textabschnitt-Modelle erben Verhalten aus `abschnitte.models.Textabschnitt` — dort sind Anzeige- und Inhaltsregeln definiert.

README.md

@@ -1 +1,6 @@
-# VDeployment2
+# vgui-cicd
+
+There are examples for importing text in the "Documentation"-directory. Actual documentation follows.
+
+Documentation on Confluence so far.
+This commit should be signed.

Test Suite-DE.md

@@ -0,0 +1,431 @@
+# Test-Suite Dokumentation
+
+Dieses Dokument bietet einen umfassenden Überblick über alle Tests im vgui-cicd Django-Projekt und beschreibt, was jeder Test tut und wie er funktioniert.
+
+## Inhaltsverzeichnis
+
+- [abschnitte App Tests](#abschnitte-app-tests)
+- [dokumente App Tests](#dokumente-app-tests)
+- [pages App Tests](#pages-app-tests)
+- [referenzen App Tests](#referenzen-app-tests)
+- [rollen App Tests](#rollen-app-tests)
+- [stichworte App Tests](#stichworte-app-tests)
+
+---
+
+## abschnitte App Tests
+
+Die abschnitte App enthält 33 Tests, die Modelle, Utility-Funktionen, Diagram-Caching, Management-Befehle und Sicherheit abdecken.
+
+### Modell-Tests
+
+#### AbschnittTypModelTest
+- **test_abschnitttyp_creation**: Überprüft, dass AbschnittTyp-Objekte korrekt mit den erwarteten Feldwerten erstellt werden
+- **test_abschnitttyp_primary_key**: Bestätigt, dass das `abschnitttyp`-Feld als Primärschlüssel dient
+- **test_abschnitttyp_str**: Testet die String-Repräsentation, die den `abschnitttyp`-Wert zurückgibt
+- **test_abschnitttyp_verbose_name_plural**: Validiert den korrekt gesetzten verbose_name_plural
+- **test_create_multiple_abschnitttypen**: Stellt sicher, dass mehrere AbschnittTyp-Objekte mit verschiedenen Typen erstellt werden können
+
+#### TextabschnittModelTest
+- **test_textabschnitt_creation**: Testet, dass Textabschnitt über das konkrete Modell instanziiert werden kann
+- **test_textabschnitt_default_order**: Überprüft, dass das `order`-Feld standardmäßig 0 ist
+- **test_textabschnitt_ordering**: Testet, dass Textabschnitt-Objekte nach dem `order`-Feld sortiert werden können
+- **test_textabschnitt_blank_fields**: Bestätigt, dass `abschnitttyp`- und `inhalt`-Felder leer/null sein können
+- **test_textabschnitt_foreign_key_protection**: Testet, dass AbschnittTyp-Objekte vor Löschung geschützt sind, wenn sie von Textabschnitt referenziert werden
+
+### Utility-Funktions-Tests
+
+#### MdTableToHtmlTest
+- **test_simple_table**: Konvertiert eine einfache Markdown-Tabelle mit Überschriften und einer Zeile nach HTML
+- **test_table_with_multiple_rows**: Testet die Konvertierung von Tabellen mit mehreren Datenzeilen
+- **test_table_with_empty_cells**: Verarbeitet Tabellen mit leeren Zellen in den Daten
+- **test_table_with_spaces**: Verarbeitet Tabellen mit zusätzlichen Leerzeichen in Zellen
+- **test_table_empty_string**: Löst ValueError für leere Eingabe-Strings aus
+- **test_table_only_whitespace**: Löst ValueError für Strings aus, die nur Leerzeichen enthalten
+- **test_table_insufficient_lines**: Löst ValueError aus, wenn die Eingabe weniger als 2 Zeilen hat
+
+#### RenderTextabschnitteTest
+- **test_render_empty_queryset**: Gibt leeren String für leere Querysets zurück
+- **test_render_multiple_abschnitte**: Rendert mehrere Textabschnitte in korrekter Reihenfolge
+- **test_render_text_markdown**: Konvertiert Klartext mit Markdown-Formatierung
+- **test_render_ordered_list**: Rendert geordnete Listen korrekt
+- **test_render_unordered_list**: Rendert ungeordnete Listen korrekt
+- **test_render_code_block**: Rendert Code-Blöcke mit korrekter Syntax-Hervorhebung
+- **test_render_table**: Konvertiert Markdown-Tabellen mit md_table_to_html nach HTML
+- **test_render_diagram_success**: Testet die Diagramm-Generierung mit erfolgreichem Caching
+- **test_render_diagram_error**: Behandelt Diagramm-Generierungsfehler angemessen
+- **test_render_diagram_with_options**: Testet das Diagramm-Rendering mit benutzerdefinierten Optionen
+- **test_render_text_with_footnotes**: Verarbeitet Text, der Fußnoten enthält
+- **test_render_abschnitt_without_type**: Behandelt Textabschnitte ohne AbschnittTyp
+- **test_render_abschnitt_with_empty_content**: Behandelt Textabschnitte mit leerem Inhalt
+- **test_render_textabschnitte_xss_prevention**: Überprüft, dass bösartiger HTML-Code und Skript-Tags aus gerenderten Inhalten bereinigt werden, um XSS-Angriffe zu verhindern
+
+### Diagram-Caching-Tests
+
+#### DiagramCacheTest
+- **test_compute_hash**: Generiert konsistente SHA256-Hashes für dieselbe Eingabe
+- **test_get_cache_path**: Erstellt korrekte Cache-Dateipfade basierend auf Hash und Typ
+- **test_get_cached_diagram_hit**: Gibt zwischengespeichertes Diagramm zurück bei Cache-Treffer
+- **test_get_cached_diagram_miss**: Generiert neues Diagramm bei Cache-Fehltreffer
+- **test_get_cached_diagram_request_error**: Behandelt und löst Request-Fehler korrekt aus
+- **test_clear_cache_specific_type**: Löscht Cache-Dateien für spezifische Diagrammtypen
+- **test_clear_cache_all_types**: Löscht alle Cache-Dateien, wenn kein Typ angegeben ist
+
+### Management-Befehl-Tests
+
+#### ClearDiagramCacheCommandTest
+- **test_command_without_type**: Testet die Ausführung des Management-Befehls ohne Angabe des Typs
+- **test_command_with_type**: Testet die Ausführung des Management-Befehls mit spezifischem Diagrammtyp
+
+### Integrations-Tests
+
+#### IntegrationTest
+- **test_textabschnitt_inheritance**: Überprüft, dass VorgabeLangtext Textabschnitt-Felder korrekt erbt
+- **test_render_vorgabe_langtext**: Testet das Rendern von VorgabeLangtext durch render_textabschnitte
+
+---
+
+## dokumente App Tests
+
+Die dokumente App enthält 121 Tests und ist damit die umfassendste Test-Suite, die alle Modelle, Views, URLs, Geschäftslogik und Kommentarfunktionalität mit XSS-Schutz abdeckt.
+
+### Modell-Tests
+
+#### DokumententypModelTest
+- **test_dokumententyp_creation**: Überprüft die Erstellung von Dokumententyp mit korrekten Feldwerten
+- **test_dokumententyp_str**: Testet die String-Repräsentation, die das `typ`-Feld zurückgibt
+- **test_dokumententyp_verbose_name**: Validiert den korrekt gesetzten verbose_name
+
+#### PersonModelTest
+- **test_person_creation**: Testet die Erstellung von Person-Objekten mit Name und optionalem Titel
+- **test_person_str**: Überprüft, dass die String-Repräsentation Titel und Namen enthält
+- **test_person_verbose_name_plural**: Testet die Konfiguration von verbose_name_plural
+
+#### ThemaModelTest
+- **test_thema_creation**: Testet die Erstellung von Thema mit Name und optionaler Erklärung
+- **test_thema_str**: Überprüft, dass die String-Repräsentation den Themennamen zurückgibt
+- **test_thema_blank_erklaerung**: Bestätigt, dass das `erklaerung`-Feld leer sein kann
+
+#### DokumentModelTest
+- **test_dokument_creation**: Testet die Erstellung von Dokument mit erforderlichen und optionalen Feldern
+- **test_dokument_str**: Überprüft, dass die String-Repräsentation den Dokumenttitel zurückgibt
+- **test_dokument_optional_fields**: Testet, dass optionale Felder None oder leer sein können
+- **test_dokument_many_to_many_relationships**: Überprüft Many-to-Many-Beziehungen mit Personen und Themen
+
+#### VorgabeModelTest
+- **test_vorgabe_creation**: Testet die Erstellung von Vorgabe mit allen erforderlichen Feldern
+- **test_vorgabe_str**: Überprüft, dass die String-Repräsentation die Vorgabennummer zurückgibt
+- **test_vorgabennummer**: Testet die automatische Generierung des Vorgabennummer-Formats
+- **test_get_status_active**: Testet die Statusbestimmung für aktuelle aktive Vorgaben
+- **test_get_status_expired**: Testet die Statusbestimmung für abgelaufene Vorgaben
+- **test_get_status_future**: Testet die Statusbestimmung für zukünftige Vorgaben
+- **test_get_status_with_custom_check_date**: Testet den Status mit benutzerdefiniertem Prüfdatum
+- **test_get_status_verbose**: Testet die ausführliche Statusausgabe
+
+#### ChangelogModelTest
+- **test_changelog_creation**: Testet die Erstellung von Changelog mit Version, Datum und Beschreibung
+- **test_changelog_str**: Überprüft, dass die String-Repräsentation Version und Datum enthält
+
+#### ChecklistenfrageModelTest
+- **test_checklistenfrage_creation**: Testet die Erstellung von Checklistenfrage mit Frage und optionaler Antwort
+- **test_checklistenfrage_str**: Überprüft, dass die String-Repräsentation lange Fragen kürzt
+- **test_checklistenfrage_related_name**: Testet die umgekehrte Beziehung von Vorgabe
+
+#### VorgabeCommentModelTest
+- **test_comment_creation**: Testet die Erstellung von VorgabeComment mit Vorgabe, Benutzer und Text
+- **test_comment_str**: Überprüft, dass die String-Repräsentation Benutzername und Vorgabennummer enthält
+- **test_comment_related_name**: Testet die umgekehrte Beziehung von Vorgabe
+- **test_comment_ordering**: Testet, dass Kommentare nach created_at absteigend sortiert sind (neueste zuerst)
+- **test_comment_timestamps_auto_update**: Testet, dass sich updated_at ändert, wenn ein Kommentar geändert wird
+- **test_multiple_users_can_comment**: Testet, dass mehrere Benutzer zur selben Vorgabe kommentieren können
+
+### Text-Abschnitt-Tests
+
+#### DokumentTextAbschnitteTest
+- **test_einleitung_creation**: Testet die Erstellung von Einleitung und Vererbung von Textabschnitt
+- **test_geltungsbereich_creation**: Testet die Erstellung von Geltungsbereich und Vererbung
+
+#### VorgabeTextAbschnitteTest
+- **test_vorgabe_kurztext_creation**: Testet die Erstellung von VorgabeKurztext und Vererbung
+- **test_vorgabe_langtext_creation**: Testet die Erstellung von VorgabeLangtext und Vererbung
+
+### Sanity-Check-Tests
+
+#### VorgabeSanityCheckTest
+- **test_date_ranges_intersect_no_overlap**: Testet Datumsüberschneidung mit nicht überlappenden Bereichen
+- **test_date_ranges_intersect_with_overlap**: Testet Datumsüberschneidung mit überlappenden Bereichen
+- **test_date_ranges_intersect_identical_ranges**: Testet Datumsüberschneidung mit identischen Bereichen
+- **test_date_ranges_intersect_with_none_end_date**: Testet Überschneidung mit offenen Endbereichen
+- **test_date_ranges_intersect_both_none_end_dates**: Testet Überschneidung mit zwei offenen Endbereichen
+- **test_check_vorgabe_conflicts_utility**: Testet die Utility-Funktion zur Konflikterkennung
+- **test_find_conflicts_no_conflicts**: Testet die Konflikterkennung bei Vorgabe ohne Konflikte
+- **test_find_conflicts_with_conflicts**: Testet die Konflikterkennung mit konfliktbehafteten Vorgaben
+- **test_format_conflict_report_no_conflicts**: Testet die Konfliktbericht-Formatierung ohne Konflikte
+- **test_format_conflict_report_with_conflicts**: Testet die Konfliktbericht-Formatierung mit Konflikten
+- **test_sanity_check_vorgaben_no_conflicts**: Testet vollständigen Sanity-Check ohne Konflikte
+- **test_sanity_check_vorgaben_with_conflicts**: Testet vollständigen Sanity-Check mit Konflikten
+- **test_sanity_check_vorgaben_multiple_conflicts**: Testet Sanity-Check mit mehreren Konfliktgruppen
+- **test_vorgabe_clean_no_conflicts**: Testet Vorgabe.clean()-Methode ohne Konflikte
+- **test_vorgabe_clean_with_conflicts**: Testet, dass Vorgabe.clean() ValidationError bei Konflikten auslöst
+
+### Management-Befehl-Tests
+
+#### SanityCheckManagementCommandTest
+- **test_sanity_check_command_no_conflicts**: Testet Management-Befehlsausgabe ohne Konflikte
+- **test_sanity_check_command_with_conflicts**: Testet Management-Befehlsausgabe mit Konflikten
+
+### URL-Pattern-Tests
+
+#### URLPatternsTest
+- **test_standard_list_url_resolves**: Überprüft, dass standard_list URL zur korrekten View aufgelöst wird
+- **test_standard_detail_url_resolves**: Überprüft, dass standard_detail URL mit pk-Parameter aufgelöst wird
+- **test_standard_history_url_resolves**: Überprüft, dass standard_history URL mit check_date aufgelöst wird
+- **test_standard_checkliste_url_resolves**: Überprüft, dass standard_checkliste URL mit pk aufgelöst wird
+
+### View-Tests
+
+#### ViewsTestCase
+- **test_standard_list_view**: Testet, dass die Standard-Listen-View 200 zurückgibt und erwartete Inhalte enthält
+- **test_standard_detail_view**: Testet die Standard-Detail-View mit existierendem Dokument
+- **test_standard_detail_view_404**: Testet, dass die Standard-Detail-View 404 für nicht existierendes Dokument zurückgibt
+- **test_standard_history_view**: Testet die Standard-Detail-View mit historischem check_date-Parameter
+- **test_standard_checkliste_view**: Testet die Funktionalität der Checklisten-View
+
+### JSON-Export-Tests
+
+#### JSONExportManagementCommandTest
+- **test_export_json_command_to_file**: Testet, dass der export_json-Befehl JSON in die angegebene Datei ausgibt
+- **test_export_json_command_stdout**: Testet, dass der export_json-Befehl JSON an stdout ausgibt, wenn keine Datei angegeben ist
+- **test_export_json_command_inactive_documents**: Testet, dass der export_json-Befehl inaktive Dokumente herausfiltert
+- **test_export_json_command_empty_database**: Testet, dass der export_json-Befehl leere Datenbank angemessen behandelt
+
+#### StandardJSONViewTest
+- **test_standard_json_view_success**: Testet, dass die standard_json-View korrektes JSON für existierendes Dokument zurückgibt
+- **test_standard_json_view_not_found**: Testet, dass die standard_json-View 404 für nicht existierendes Dokument zurückgibt
+- **test_standard_json_view_json_formatting**: Testet, dass die standard_json-View korrekt formatiertes JSON zurückgibt
+- **test_standard_json_view_null_dates**: Testet, dass die standard_json-View null-Datumfelder korrekt behandelt
+- **test_standard_json_view_empty_sections**: Testet, dass die standard_json-View leere Dokumentabschnitte behandelt
+
+### Unvollständige Vorgaben Tests
+
+#### IncompleteVorgabenTest
+- **test_incomplete_vorgaben_page_status**: Testet, dass die Seite erfolgreich lädt (200-Status)
+- **test_incomplete_vorgaben_staff_only**: Testet, dass Nicht-Staff-Benutzer zum Login weitergeleitet werden
+- **test_incomplete_vorgaben_page_content**: Testet, dass die Seite erwartete Überschriften und Struktur enthält
+- **test_navigation_link**: Testet, dass die Navigation einen Link zur unvollständigen Vorgaben-Seite enthält
+- **test_no_references_list**: Testet, dass Vorgaben ohne Referenzen korrekt aufgelistet werden
+- **test_no_stichworte_list**: Testet, dass Vorgaben ohne Stichworte korrekt aufgelistet werden
+- **test_no_text_list**: Testet, dass Vorgaben ohne Kurz- oder Langtext korrekt aufgelistet werden
+- **test_no_checklistenfragen_list**: Testet, dass Vorgaben ohne Checklistenfragen korrekt aufgelistet werden
+- **test_vorgabe_with_both_text_types**: Testet, dass Vorgabe mit beiden Texttypen als vollständig betrachtet wird
+- **test_vorgabe_with_langtext_only**: Testet, dass Vorgabe mit nur Langtext immer noch unvollständig für Text ist
+- **test_empty_lists_message**: Testet angemessene Nachrichten, wenn Listen leer sind
+- **test_badge_counts**: Testet, dass Badge-Zähler korrekt berechnet werden
+- **test_summary_section**: Testet, dass die Zusammenfassungssektion korrekte Zähler anzeigt
+- **test_vorgabe_links**: Testet, dass Vorgaben zu korrekten Admin-Seiten verlinken
+- **test_back_link**: Testet, dass der Zurück-Link zur Standardübersicht existiert
+
+### Kommentar-Funktionalität Tests
+
+#### GetVorgabeCommentsViewTest
+- **test_get_comments_requires_login**: Testet, dass anonyme Benutzer keine Kommentare sehen können und weitergeleitet werden
+- **test_regular_user_sees_only_own_comments**: Testet, dass normale Benutzer nur ihre eigenen Kommentare sehen
+- **test_staff_user_sees_all_comments**: Testet, dass Staff-Benutzer alle Kommentare sehen können
+- **test_get_comments_returns_404_for_nonexistent_vorgabe**: Testet 404-Antwort für nicht existierende Vorgabe
+- **test_comments_are_html_escaped**: Testet HTML-Escaping zur Verhinderung von XSS-Angriffen (z.B. `<script>`-Tags)
+- **test_line_breaks_preserved**: Testet, dass Zeilenumbrüche in `<br>`-Tags umgewandelt werden
+- **test_security_headers_present**: Testet, dass Content-Security-Policy und X-Content-Type-Options Header gesetzt sind
+
+#### AddVorgabeCommentViewTest
+- **test_add_comment_requires_login**: Testet, dass anonyme Benutzer keine Kommentare hinzufügen können
+- **test_add_comment_requires_post**: Testet, dass nur POST-Methode erlaubt ist (405 für GET)
+- **test_add_comment_success**: Testet erfolgreiche Kommentarerstellung mit gültigen Daten
+- **test_add_empty_comment_fails**: Testet, dass leere Kommentare mit 400-Fehler abgelehnt werden
+- **test_add_whitespace_only_comment_fails**: Testet, dass Kommentare nur mit Leerzeichen abgelehnt werden
+- **test_add_too_long_comment_fails**: Testet, dass Kommentare über 2000 Zeichen abgelehnt werden
+- **test_add_comment_xss_script_tag_blocked**: Testet, dass Kommentare mit `<script>`-Tags blockiert werden
+- **test_add_comment_xss_javascript_protocol_blocked**: Testet, dass `javascript:`-Protokoll blockiert wird
+- **test_add_comment_xss_event_handlers_blocked**: Testet, dass Event-Handler (onload, onerror, onclick, onmouseover) blockiert werden
+- **test_add_comment_invalid_json_fails**: Testet, dass ungültige JSON-Payloads abgelehnt werden
+- **test_add_comment_nonexistent_vorgabe_fails**: Testet 404-Antwort für nicht existierende Vorgabe
+- **test_add_comment_security_headers**: Testet, dass Sicherheits-Header in Antworten vorhanden sind
+
+#### DeleteVorgabeCommentViewTest
+- **test_delete_comment_requires_login**: Testet, dass anonyme Benutzer keine Kommentare löschen können
+- **test_delete_comment_requires_post**: Testet, dass nur POST-Methode erlaubt ist (405 für GET)
+- **test_user_can_delete_own_comment**: Testet, dass Benutzer ihre eigenen Kommentare löschen können
+- **test_user_cannot_delete_other_users_comment**: Testet, dass Benutzer keine Kommentare anderer löschen können (403 Forbidden)
+- **test_staff_can_delete_any_comment**: Testet, dass Staff-Benutzer jeden Kommentar löschen können
+- **test_delete_nonexistent_comment_returns_404**: Testet 404-Antwort für nicht existierenden Kommentar
+- **test_delete_comment_security_headers**: Testet, dass Sicherheits-Header in Antworten vorhanden sind
+
+---
+
+## pages App Tests
+
+Die pages App enthält 4 Tests, die sich auf die Suchfunktionalität und Validierung konzentrieren.
+
+### ViewsTestCase
+- **test_search_view_get**: Testet GET-Anfrage an die Search-View gibt 200-Status zurück
+- **test_search_view_post_with_query**: Testet POST-Anfrage mit Query gibt Ergebnisse zurück
+- **test_search_view_post_empty_query**: Testet POST-Anfrage mit leerer Query zeigt Validierungsfehler
+- **test_search_view_post_no_query**: Testet POST-Anfrage ohne Query-Parameter zeigt Validierungsfehler
+
+---
+
+## referenzen App Tests
+
+Die referenzen App enthält 18 Tests, die sich auf MPTT-Hierarchiefunktionalität und Modellbeziehungen konzentrieren.
+
+### Modell-Tests
+
+#### ReferenzModelTest
+- **test_referenz_creation**: Testet die Erstellung von Referenz mit erforderlichen Feldern
+- **test_referenz_str**: Testet die String-Repräsentation gibt den Referenztext zurück
+- **test_referenz_ordering**: Testet die Standard-Sortierung nach `order`-Feld
+- **test_referenz_optional_fields**: Testet, dass optionale Felder leer sein können
+
+#### ReferenzerklaerungModelTest
+- **test_referenzerklaerung_creation**: Testet die Erstellung von Referenzerklaerung mit Referenz und Erklärung
+- **test_referenzerklaerung_str**: Testet die String-Repräsentation enthält Referenz und Erklärungsvorschau
+- **test_referenzerklaerung_ordering**: Testet die Standard-Sortierung nach `order`-Feld
+- **test_referenzerklaerung_optional_explanation**: Testet, dass das Erklärungsfeld leer sein kann
+
+### Hierarchie-Tests
+
+#### ReferenzHierarchyTest
+- **test_hierarchy_relationships**: Testet Eltern-Kind-Beziehungen im MPTT-Baum
+- **test_get_root**: Testet das Abrufen des Wurzelknotens einer Hierarchie
+- **test_get_children**: Testet das Abrufen direkter Kinder eines Knotens
+- **test_get_descendants**: Testet das Abrufen aller Nachkommen eines Knotens
+- **test_get_ancestors**: Testet das Abrufen aller Vorfahren eines Knotens
+- **test_get_ancestors_include_self**: Testet das Abrufen von Vorfahren einschließlich des Knotens selbst
+- **test_is_leaf_node**: Testet die Erkennung von Blattknoten
+- **test_is_root_node**: Testet die Erkennung von Wurzelknoten
+- **test_tree_ordering**: Testet die Baum-Sortierung mit mehreren Ebenen
+- **test_move_node**: Testet das Verschieben von Knoten innerhalb der Baumstruktur
+
+---
+
+## rollen App Tests
+
+Die rollen App enthält 18 Tests, die Rollenmodelle und ihre Beziehungen zu Dokumentabschnitten abdecken.
+
+### Modell-Tests
+
+#### RolleModelTest
+- **test_rolle_creation**: Testet die Erstellung von Rolle mit Name und optionaler Beschreibung
+- **test_rolle_str**: Testet die String-Repräsentation gibt den Rollennamen zurück
+- **test_rolle_ordering**: Testet die Standard-Sortierung nach `order`-Feld
+- **test_rolle_unique_name**: Testet, dass Rollennamen einzigartig sein müssen
+- **test_rolle_optional_beschreibung**: Testet, dass das Beschreibungsfeld leer sein kann
+
+#### RollenBeschreibungModelTest
+- **test_rollenbeschreibung_creation**: Testet die Erstellung von RollenBeschreibung mit Rolle und Abschnittstyp
+- **test_rollenbeschreibung_str**: Testet die String-Repräsentation enthält Rolle und Abschnittstyp
+- **test_rollenbeschreibung_ordering**: Testet die Standard-Sortierung nach `order`-Feld
+- **test_rollenbeschreibung_unique_combination**: Testet die Unique-Constraint auf Rolle und Abschnittstyp
+- **test_rollenbeschreibung_optional_beschreibung**: Testet, dass das Beschreibungsfeld leer sein kann
+
+### Beziehungs-Tests
+
+#### RelationshipTest
+- **test_rolle_rollenbeschreibung_relationship**: Testet die Eins-zu-viele-Beziehung zwischen Rolle und RollenBeschreibung
+- **test_abschnitttyp_rollenbeschreibung_relationship**: Testet die Beziehung zwischen AbschnittTyp und RollenBeschreibung
+- **test_cascade_delete**: Testet das Cascade-Delete-Verhalten beim Löschen einer Rolle
+- **test_protected_delete**: Testet das Protected-Delete-Verhalten, wenn Abschnittstyp referenziert wird
+- **test_query_related_objects**: Testet das effiziente Abfragen verwandter Objekte
+- **test_string_representations**: Testet, dass alle String-Repräsentationen korrekt funktionieren
+- **test_ordering_consistency**: Testet, dass die Sortierung über Abfragen hinweg konsistent ist
+
+---
+
+## stichworte App Tests
+
+Die stichworte App enthält 18 Tests, die Schlüsselwortmodelle und ihre Sortierung abdecken.
+
+### Modell-Tests
+
+#### StichwortModelTest
+- **test_stichwort_creation**: Testet die Erstellung von Stichwort mit Schlüsselworttext
+- **test_stichwort_str**: Testet die String-Repräsentation gibt den Schlüsselworttext zurück
+- **test_stichwort_ordering**: Testet die Standard-Sortierung nach `stichwort`-Feld
+- **test_stichwort_unique**: Testet, dass Schlüsselwörter einzigartig sein müssen
+- **test_stichwort_case_insensitive**: Testet die Groß-/Kleinschreibungs-unabhängige Eindeutigkeit
+
+#### StichworterklaerungModelTest
+- **test_stichworterklaerung_creation**: Testet die Erstellung von Stichworterklaerung mit Schlüsselwort und Erklärung
+- **test_stichworterklaerung_str**: Testet die String-Repräsentation enthält Schlüsselwort und Erklärungsvorschau
+- **test_stichworterklaerung_ordering**: Testet die Standard-Sortierung nach `order`-Feld
+- **test_stichworterklaerung_optional_erklaerung**: Testet, dass das Erklärungsfeld leer sein kann
+- **test_stichworterklaerung_unique_stichwort**: Testet den Unique-Constraint auf das Schlüsselwort
+
+### Beziehungs-Tests
+
+#### RelationshipTest
+- **test_stichwort_stichworterklaerung_relationship**: Testet die Eins-zu-eins-Beziehung zwischen Stichwort und Stichworterklaerung
+- **test_cascade_delete**: Testet das Cascade-Delete-Verhalten beim Löschen eines Schlüsselworts
+- **test_protected_delete**: Testet das Protected-Delete-Verhalten, wenn Erklärung referenziert wird
+- **test_query_related_objects**: Testet das effiziente Abfragen verwandter Objekte
+- **test_string_representations**: Testet, dass alle String-Repräsentationen korrekt funktionieren
+- **test_ordering_consistency**: Testet, dass die Sortierung über Abfragen hinweg konsistent ist
+- **test_reverse_relationship**: Testet die umgekehrte Beziehung von Erklärung zu Schlüsselwort
+
+---
+
+## Test-Statistiken
+
+- **Gesamt-Tests**: 230
+- **abschnitte**: 33 Tests (einschließlich XSS-Prävention)
+- **dokumente**: 121 Tests (einschließlich Kommentarfunktionalität mit XSS-Schutz)
+  - Modell-Tests: 44 Tests
+  - View-Tests: 7 Tests
+  - URL-Pattern-Tests: 4 Tests
+  - Sanity-Check-Tests: 16 Tests
+  - Management-Befehl-Tests: 2 Tests
+  - JSON-Export-Tests: 9 Tests
+  - Unvollständige-Vorgaben-Tests: 15 Tests
+  - Kommentar-Tests: 24 Tests (6 Modell + 18 View-Tests)
+- **pages**: 4 Tests
+- **referenzen**: 18 Tests
+- **rollen**: 18 Tests
+- **stichworte**: 18 Tests
+
+## Test-Abdeckungsbereiche
+
+1. **Modell-Validierung**: Feldvalidierung, Constraints und Beziehungen
+2. **Geschäftslogik**: Statusbestimmung, Konflikterkennung, Hierarchieverwaltung
+3. **View-Funktionalität**: HTTP-Antworten, Template-Rendering, URL-Auflösung
+4. **Utility-Funktionen**: Textverarbeitung, Caching, Formatierung
+5. **Management-Befehle**: CLI-Schnittstelle und Ausgabeverarbeitung
+6. **Integration**: App-übergreifende Funktionalität und Datenfluss
+7. **Sicherheit**: 
+   - XSS-Prävention durch HTML-Bereinigung beim Rendern von Inhalten
+   - XSS-Angriffsverhinderung im Kommentarsystem (Script-Tags, javascript:-Protokoll, Event-Handler)
+   - Eingabevalidierung und -bereinigung
+   - Autorisierungsprüfungen (Staff vs. normale Benutzer)
+   - Sicherheits-Header (Content-Security-Policy, X-Content-Type-Options)
+8. **Kommentar-Funktionalität**:
+   - CRUD-Operationen (Create, Read, Delete)
+   - Benutzerberechtigungen und -besitz
+   - HTML-Escaping und Erhalt von Zeilenumbrüchen
+   - Verhinderung mehrerer XSS-Angriffsvektoren
+
+## Ausführen der Tests
+
+Um alle Tests auszuführen:
+```bash
+python manage.py test
+```
+
+Um Tests für eine spezifische App auszuführen:
+```bash
+python manage.py test app_name
+```
+
+Um mit ausführlicher Ausgabe auszuführen:
+```bash
+python manage.py test --verbosity=2
+```
+
+Alle Tests laufen derzeit erfolgreich und bieten umfassende Abdeckung der Funktionalität der Anwendung.

Test suite.md

@@ -0,0 +1,431 @@
+# Test Suite Documentation
+
+This document provides a comprehensive overview of all tests in the vgui-cicd Django project, describing what each test does and how it works.
+
+## Table of Contents
+
+- [abschnitte App Tests](#abschnitte-app-tests)
+- [dokumente App Tests](#dokumente-app-tests)
+- [pages App Tests](#pages-app-tests)
+- [referenzen App Tests](#referenzen-app-tests)
+- [rollen App Tests](#rollen-app-tests)
+- [stichworte App Tests](#stichworte-app-tests)
+
+---
+
+## abschnitte App Tests
+
+The abschnitte app contains 33 tests covering models, utility functions, diagram caching, management commands, and security.
+
+### Model Tests
+
+#### AbschnittTypModelTest
+- **test_abschnitttyp_creation**: Verifies that AbschnittTyp objects are created correctly with the expected field values
+- **test_abschnitttyp_primary_key**: Confirms that the `abschnitttyp` field serves as the primary key
+- **test_abschnitttyp_str**: Tests the string representation returns the `abschnitttyp` value
+- **test_abschnitttyp_verbose_name_plural**: Validates the verbose name plural is set correctly
+- **test_create_multiple_abschnitttypen**: Ensures multiple AbschnittTyp objects can be created with different types
+
+#### TextabschnittModelTest
+- **test_textabschnitt_creation**: Tests that Textabschnitt can be instantiated through the concrete model
+- **test_textabschnitt_default_order**: Verifies the `order` field defaults to 0
+- **test_textabschnitt_ordering**: Tests that Textabschnitt objects can be ordered by the `order` field
+- **test_textabschnitt_blank_fields**: Confirms that `abschnitttyp` and `inhalt` fields can be blank/null
+- **test_textabschnitt_foreign_key_protection**: Tests that AbschnittTyp objects are protected from deletion when referenced by Textabschnitt
+
+### Utility Function Tests
+
+#### MdTableToHtmlTest
+- **test_simple_table**: Converts a basic markdown table with headers and one row to HTML
+- **test_table_with_multiple_rows**: Tests conversion of tables with multiple data rows
+- **test_table_with_empty_cells**: Handles tables with empty cells in the data
+- **test_table_with_spaces**: Processes tables with extra spaces in cells
+- **test_table_empty_string**: Raises ValueError for empty input strings
+- **test_table_only_whitespace**: Raises ValueError for strings containing only whitespace
+- **test_table_insufficient_lines**: Raises ValueError when input has fewer than 2 lines
+
+#### RenderTextabschnitteTest
+- **test_render_empty_queryset**: Returns empty string for empty querysets
+- **test_render_multiple_abschnitte**: Renders multiple Textabschnitte in correct order
+- **test_render_text_markdown**: Converts plain text with markdown formatting
+- **test_render_ordered_list**: Renders ordered lists correctly
+- **test_render_unordered_list**: Renders unordered lists correctly
+- **test_render_code_block**: Renders code blocks with proper syntax highlighting
+- **test_render_table**: Converts markdown tables to HTML using md_table_to_html
+- **test_render_diagram_success**: Tests diagram generation with successful caching
+- **test_render_diagram_error**: Handles diagram generation errors gracefully
+- **test_render_diagram_with_options**: Tests diagram rendering with custom options
+- **test_render_text_with_footnotes**: Processes text containing footnotes
+- **test_render_abschnitt_without_type**: Handles Textabschnitte without AbschnittTyp
+- **test_render_abschnitt_with_empty_content**: Handles Textabschnitte with empty content
+- **test_render_textabschnitte_xss_prevention**: Verifies that malicious HTML and script tags are sanitized from rendered content to prevent XSS attacks
+
+### Diagram Caching Tests
+
+#### DiagramCacheTest
+- **test_compute_hash**: Generates consistent SHA256 hashes for the same input
+- **test_get_cache_path**: Creates correct cache file paths based on hash and type
+- **test_get_cached_diagram_hit**: Returns cached diagram when cache hit occurs
+- **test_get_cached_diagram_miss**: Generates new diagram when cache miss occurs
+- **test_get_cached_diagram_request_error**: Properly handles and raises request errors
+- **test_clear_cache_specific_type**: Clears cache files for specific diagram types
+- **test_clear_cache_all_types**: Clears all cache files when no type specified
+
+### Management Command Tests
+
+#### ClearDiagramCacheCommandTest
+- **test_command_without_type**: Tests management command execution without specifying type
+- **test_command_with_type**: Tests management command execution with specific diagram type
+
+### Integration Tests
+
+#### IntegrationTest
+- **test_textabschnitt_inheritance**: Verifies VorgabeLangtext properly inherits Textabschnitt fields
+- **test_render_vorgabe_langtext**: Tests rendering VorgabeLangtext through render_textabschnitte
+
+---
+
+## dokumente App Tests
+
+The dokumente app contains 121 tests, making it the most comprehensive test suite, covering all models, views, URLs, business logic, and comment functionality with XSS protection.
+
+### Model Tests
+
+#### DokumententypModelTest
+- **test_dokumententyp_creation**: Verifies Dokumententyp creation with correct field values
+- **test_dokumententyp_str**: Tests string representation returns the `typ` field
+- **test_dokumententyp_verbose_name**: Validates verbose name is set correctly
+
+#### PersonModelTest
+- **test_person_creation**: Tests Person object creation with name and optional title
+- **test_person_str**: Verifies string representation includes title and name
+- **test_person_verbose_name_plural**: Tests verbose name plural configuration
+
+#### ThemaModelTest
+- **test_thema_creation**: Tests Thema creation with name and optional explanation
+- **test_thema_str**: Verifies string representation returns the theme name
+- **test_thema_blank_erklaerung**: Confirms `erklaerung` field can be blank
+
+#### DokumentModelTest
+- **test_dokument_creation**: Tests Dokument creation with required and optional fields
+- **test_dokument_str**: Verifies string representation returns the document title
+- **test_dokument_optional_fields**: Tests that optional fields can be None or blank
+- **test_dokument_many_to_many_relationships**: Verifies many-to-many relationships with Personen and Themen
+
+#### VorgabeModelTest
+- **test_vorgabe_creation**: Tests Vorgabe creation with all required fields
+- **test_vorgabe_str**: Verifies string representation returns the Vorgabennummer
+- **test_vorgabennummer**: Tests automatic generation of Vorgabennummer format
+- **test_get_status_active**: Tests status determination for current active Vorgaben
+- **test_get_status_expired**: Tests status determination for expired Vorgaben
+- **test_get_status_future**: Tests status determination for future Vorgaben
+- **test_get_status_with_custom_check_date**: Tests status with custom check date
+- **test_get_status_verbose**: Tests verbose status output
+
+#### ChangelogModelTest
+- **test_changelog_creation**: Tests Changelog creation with version, date, and description
+- **test_changelog_str**: Verifies string representation includes version and date
+
+#### ChecklistenfrageModelTest
+- **test_checklistenfrage_creation**: Tests Checklistenfrage creation with question and optional answer
+- **test_checklistenfrage_str**: Verifies string representation truncates long questions
+- **test_checklistenfrage_related_name**: Tests the reverse relationship from Vorgabe
+
+#### VorgabeCommentModelTest
+- **test_comment_creation**: Tests VorgabeComment creation with vorgabe, user, and text
+- **test_comment_str**: Verifies string representation includes username and Vorgabennummer
+- **test_comment_related_name**: Tests the reverse relationship from Vorgabe
+- **test_comment_ordering**: Tests comments are ordered by created_at descending (newest first)
+- **test_comment_timestamps_auto_update**: Tests that updated_at changes when comment is modified
+- **test_multiple_users_can_comment**: Tests multiple users can comment on same Vorgabe
+
+### Text Abschnitt Tests
+
+#### DokumentTextAbschnitteTest
+- **test_einleitung_creation**: Tests Einleitung creation and inheritance from Textabschnitt
+- **test_geltungsbereich_creation**: Tests Geltungsbereich creation and inheritance
+
+#### VorgabeTextAbschnitteTest
+- **test_vorgabe_kurztext_creation**: Tests VorgabeKurztext creation and inheritance
+- **test_vorgabe_langtext_creation**: Tests VorgabeLangtext creation and inheritance
+
+### Sanity Check Tests
+
+#### VorgabeSanityCheckTest
+- **test_date_ranges_intersect_no_overlap**: Tests date intersection with non-overlapping ranges
+- **test_date_ranges_intersect_with_overlap**: Tests date intersection with overlapping ranges
+- **test_date_ranges_intersect_identical_ranges**: Tests date intersection with identical ranges
+- **test_date_ranges_intersect_with_none_end_date**: Tests intersection with open-ended ranges
+- **test_date_ranges_intersect_both_none_end_dates**: Tests intersection with two open-ended ranges
+- **test_check_vorgabe_conflicts_utility**: Tests the utility function for conflict detection
+- **test_find_conflicts_no_conflicts**: Tests conflict detection on Vorgabe without conflicts
+- **test_find_conflicts_with_conflicts**: Tests conflict detection with conflicting Vorgaben
+- **test_format_conflict_report_no_conflicts**: Tests conflict report formatting with no conflicts
+- **test_format_conflict_report_with_conflicts**: Tests conflict report formatting with conflicts
+- **test_sanity_check_vorgaben_no_conflicts**: Tests full sanity check with no conflicts
+- **test_sanity_check_vorgaben_with_conflicts**: Tests full sanity check with conflicts
+- **test_sanity_check_vorgaben_multiple_conflicts**: Tests sanity check with multiple conflict groups
+- **test_vorgabe_clean_no_conflicts**: Tests Vorgabe.clean() method without conflicts
+- **test_vorgabe_clean_with_conflicts**: Tests Vorgabe.clean() raises ValidationError with conflicts
+
+### Management Command Tests
+
+#### SanityCheckManagementCommandTest
+- **test_sanity_check_command_no_conflicts**: Tests management command output with no conflicts
+- **test_sanity_check_command_with_conflicts**: Tests management command output with conflicts
+
+### URL Pattern Tests
+
+#### URLPatternsTest
+- **test_standard_list_url_resolves**: Verifies standard_list URL resolves to correct view
+- **test_standard_detail_url_resolves**: Verifies standard_detail URL resolves with pk parameter
+- **test_standard_history_url_resolves**: Verifies standard_history URL resolves with check_date
+- **test_standard_checkliste_url_resolves**: Verifies standard_checkliste URL resolves with pk
+
+### View Tests
+
+#### ViewsTestCase
+- **test_standard_list_view**: Tests standard list view returns 200 and contains expected content
+- **test_standard_detail_view**: Tests standard detail view with existing document
+- **test_standard_detail_view_404**: Tests standard detail view returns 404 for non-existent document
+- **test_standard_history_view**: Tests standard detail view with historical check_date parameter
+- **test_standard_checkliste_view**: Tests checklist view functionality
+
+### JSON Export Tests
+
+#### JSONExportManagementCommandTest
+- **test_export_json_command_to_file**: Tests export_json command outputs JSON to specified file
+- **test_export_json_command_stdout**: Tests export_json command outputs JSON to stdout when no file specified
+- **test_export_json_command_inactive_documents**: Tests export_json command filters out inactive documents
+- **test_export_json_command_empty_database**: Tests export_json command handles empty database gracefully
+
+#### StandardJSONViewTest
+- **test_standard_json_view_success**: Tests standard_json view returns correct JSON for existing document
+- **test_standard_json_view_not_found**: Tests standard_json view returns 404 for non-existent document
+- **test_standard_json_view_json_formatting**: Tests standard_json view returns properly formatted JSON
+- **test_standard_json_view_null_dates**: Tests standard_json view handles null date fields correctly
+- **test_standard_json_view_empty_sections**: Tests standard_json view handles empty document sections
+
+### Incomplete Vorgaben Tests
+
+#### IncompleteVorgabenTest
+- **test_incomplete_vorgaben_page_status**: Tests page loads successfully (200 status)
+- **test_incomplete_vorgaben_staff_only**: Tests non-staff users are redirected to login
+- **test_incomplete_vorgaben_page_content**: Tests page contains expected headings and structure
+- **test_navigation_link**: Tests navigation includes link to incomplete Vorgaben page
+- **test_no_references_list**: Tests Vorgaben without references are listed correctly
+- **test_no_stichworte_list**: Tests Vorgaben without Stichworte are listed correctly
+- **test_no_text_list**: Tests Vorgaben without Kurz- or Langtext are listed correctly
+- **test_no_checklistenfragen_list**: Tests Vorgaben without Checklistenfragen are listed correctly
+- **test_vorgabe_with_both_text_types**: Tests Vorgabe with both text types is considered complete
+- **test_vorgabe_with_langtext_only**: Tests Vorgabe with only Langtext is still incomplete for text
+- **test_empty_lists_message**: Tests appropriate messages when lists are empty
+- **test_badge_counts**: Tests badge counts are calculated correctly
+- **test_summary_section**: Tests summary section shows correct counts
+- **test_vorgabe_links**: Tests Vorgaben link to correct admin pages
+- **test_back_link**: Tests back link to standard list exists
+
+### Comment Functionality Tests
+
+#### GetVorgabeCommentsViewTest
+- **test_get_comments_requires_login**: Tests anonymous users cannot view comments and are redirected
+- **test_regular_user_sees_only_own_comments**: Tests regular users only see their own comments
+- **test_staff_user_sees_all_comments**: Tests staff users can see all comments
+- **test_get_comments_returns_404_for_nonexistent_vorgabe**: Tests 404 response for non-existent Vorgabe
+- **test_comments_are_html_escaped**: Tests HTML escaping prevents XSS attacks (e.g., `<script>` tags)
+- **test_line_breaks_preserved**: Tests line breaks are converted to `<br>` tags
+- **test_security_headers_present**: Tests Content-Security-Policy and X-Content-Type-Options headers are set
+
+#### AddVorgabeCommentViewTest
+- **test_add_comment_requires_login**: Tests anonymous users cannot add comments
+- **test_add_comment_requires_post**: Tests only POST method is allowed (405 for GET)
+- **test_add_comment_success**: Tests successful comment creation with valid data
+- **test_add_empty_comment_fails**: Tests empty comments are rejected with 400 error
+- **test_add_whitespace_only_comment_fails**: Tests whitespace-only comments are rejected
+- **test_add_too_long_comment_fails**: Tests comments exceeding 2000 characters are rejected
+- **test_add_comment_xss_script_tag_blocked**: Tests comments with `<script>` tags are blocked
+- **test_add_comment_xss_javascript_protocol_blocked**: Tests `javascript:` protocol is blocked
+- **test_add_comment_xss_event_handlers_blocked**: Tests event handlers (onload, onerror, onclick, onmouseover) are blocked
+- **test_add_comment_invalid_json_fails**: Tests invalid JSON payloads are rejected
+- **test_add_comment_nonexistent_vorgabe_fails**: Tests 404 response for non-existent Vorgabe
+- **test_add_comment_security_headers**: Tests security headers are present in responses
+
+#### DeleteVorgabeCommentViewTest
+- **test_delete_comment_requires_login**: Tests anonymous users cannot delete comments
+- **test_delete_comment_requires_post**: Tests only POST method is allowed (405 for GET)
+- **test_user_can_delete_own_comment**: Tests users can delete their own comments
+- **test_user_cannot_delete_other_users_comment**: Tests users cannot delete others' comments (403 Forbidden)
+- **test_staff_can_delete_any_comment**: Tests staff users can delete any comment
+- **test_delete_nonexistent_comment_returns_404**: Tests 404 response for non-existent comment
+- **test_delete_comment_security_headers**: Tests security headers are present in responses
+
+---
+
+## pages App Tests
+
+The pages app contains 4 tests focusing on search functionality and validation.
+
+### ViewsTestCase
+- **test_search_view_get**: Tests GET request to search view returns 200 status
+- **test_search_view_post_with_query**: Tests POST request with query returns results
+- **test_search_view_post_empty_query**: Tests POST request with empty query shows validation error
+- **test_search_view_post_no_query**: Tests POST request without query parameter shows validation error
+
+---
+
+## referenzen App Tests
+
+The referenzen app contains 18 tests focusing on MPTT hierarchy functionality and model relationships.
+
+### Model Tests
+
+#### ReferenzModelTest
+- **test_referenz_creation**: Tests Referenz creation with required fields
+- **test_referenz_str**: Tests string representation returns the reference text
+- **test_referenz_ordering**: Tests default ordering by `order` field
+- **test_referenz_optional_fields**: Tests optional fields can be blank
+
+#### ReferenzerklaerungModelTest
+- **test_referenzerklaerung_creation**: Tests Referenzerklaerung creation with reference and explanation
+- **test_referenzerklaerung_str**: Tests string representation includes reference and explanation preview
+- **test_referenzerklaerung_ordering**: Tests default ordering by `order` field
+- **test_referenzerklaerung_optional_explanation**: Tests explanation field can be blank
+
+### Hierarchy Tests
+
+#### ReferenzHierarchyTest
+- **test_hierarchy_relationships**: Tests parent-child relationships in MPTT tree
+- **test_get_root**: Tests getting the root node of a hierarchy
+- **test_get_children**: Tests getting direct children of a node
+- **test_get_descendants**: Tests getting all descendants of a node
+- **test_get_ancestors**: Tests getting all ancestors of a node
+- **test_get_ancestors_include_self**: Tests getting ancestors including the node itself
+- **test_is_leaf_node**: Tests leaf node detection
+- **test_is_root_node**: Tests root node detection
+- **test_tree_ordering**: Tests tree ordering with multiple levels
+- **test_move_node**: Tests moving nodes within the tree structure
+
+---
+
+## rollen App Tests
+
+The rollen app contains 18 tests covering role models and their relationships with document sections.
+
+### Model Tests
+
+#### RolleModelTest
+- **test_rolle_creation**: Tests Rolle creation with name and optional description
+- **test_rolle_str**: Tests string representation returns the role name
+- **test_rolle_ordering**: Tests default ordering by `order` field
+- **test_rolle_unique_name**: Tests that role names must be unique
+- **test_rolle_optional_beschreibung**: Tests description field can be blank
+
+#### RollenBeschreibungModelTest
+- **test_rollenbeschreibung_creation**: Tests RollenBeschreibung creation with role and section type
+- **test_rollenbeschreibung_str**: Tests string representation includes role and section type
+- **test_rollenbeschreibung_ordering**: Tests default ordering by `order` field
+- **test_rollenbeschreibung_unique_combination**: Tests unique constraint on role and section type
+- **test_rollenbeschreibung_optional_beschreibung**: Tests description field can be blank
+
+### Relationship Tests
+
+#### RelationshipTest
+- **test_rolle_rollenbeschreibung_relationship**: Tests one-to-many relationship between Rolle and RollenBeschreibung
+- **test_abschnitttyp_rollenbeschreibung_relationship**: Tests relationship between AbschnittTyp and RollenBeschreibung
+- **test_cascade_delete**: Tests cascade delete behavior when role is deleted
+- **test_protected_delete**: Tests protected delete behavior when section type is referenced
+- **test_query_related_objects**: Tests querying related objects efficiently
+- **test_string_representations**: Tests all string representations work correctly
+- **test_ordering_consistency**: Tests ordering is consistent across queries
+
+---
+
+## stichworte App Tests
+
+The stichworte app contains 18 tests covering keyword models and their ordering.
+
+### Model Tests
+
+#### StichwortModelTest
+- **test_stichwort_creation**: Tests Stichwort creation with keyword text
+- **test_stichwort_str**: Tests string representation returns the keyword text
+- **test_stichwort_ordering**: Tests default ordering by `stichwort` field
+- **test_stichwort_unique**: Tests that keywords must be unique
+- **test_stichwort_case_insensitive**: Tests case-insensitive uniqueness
+
+#### StichworterklaerungModelTest
+- **test_stichworterklaerung_creation**: Tests Stichworterklaerung creation with keyword and explanation
+- **test_stichworterklaerung_str**: Tests string representation includes keyword and explanation preview
+- **test_stichworterklaerung_ordering**: Tests default ordering by `order` field
+- **test_stichworterklaerung_optional_erklaerung**: Tests explanation field can be blank
+- **test_stichworterklaerung_unique_stichwort**: Tests unique constraint on keyword
+
+### Relationship Tests
+
+#### RelationshipTest
+- **test_stichwort_stichworterklaerung_relationship**: Tests one-to-one relationship between Stichwort and Stichworterklaerung
+- **test_cascade_delete**: Tests cascade delete behavior when keyword is deleted
+- **test_protected_delete**: Tests protected delete behavior when explanation is referenced
+- **test_query_related_objects**: Tests querying related objects efficiently
+- **test_string_representations**: Tests all string representations work correctly
+- **test_ordering_consistency**: Tests ordering is consistent across queries
+- **test_reverse_relationship**: Tests reverse relationship from explanation to keyword
+
+---
+
+## Test Statistics
+
+- **Total Tests**: 230
+- **abschnitte**: 33 tests (including XSS prevention)
+- **dokumente**: 121 tests (including comment functionality with XSS protection)
+  - Model tests: 44 tests
+  - View tests: 7 tests
+  - URL pattern tests: 4 tests
+  - Sanity check tests: 16 tests
+  - Management command tests: 2 tests
+  - JSON export tests: 9 tests
+  - Incomplete Vorgaben tests: 15 tests
+  - Comment tests: 24 tests (6 model + 18 view tests)
+- **pages**: 4 tests
+- **referenzen**: 18 tests
+- **rollen**: 18 tests
+- **stichworte**: 18 tests
+
+## Test Coverage Areas
+
+1. **Model Validation**: Field validation, constraints, and relationships
+2. **Business Logic**: Status determination, conflict detection, hierarchy management
+3. **View Functionality**: HTTP responses, template rendering, URL resolution
+4. **Utility Functions**: Text processing, caching, formatting
+5. **Management Commands**: CLI interface and output handling
+6. **Integration**: Cross-app functionality and data flow
+7. **Security**: 
+   - XSS prevention through HTML sanitization in content rendering
+   - XSS attack prevention in comment system (script tags, javascript: protocol, event handlers)
+   - Input validation and sanitization
+   - Authorization checks (staff vs. regular users)
+   - Security headers (Content-Security-Policy, X-Content-Type-Options)
+8. **Comment Functionality**:
+   - CRUD operations (Create, Read, Delete)
+   - User permissions and ownership
+   - HTML escaping and line break preservation
+   - Multiple XSS attack vector prevention
+
+## Running the Tests
+
+To run all tests:
+```bash
+python manage.py test
+```
+
+To run tests for a specific app:
+```bash
+python manage.py test app_name
+```
+
+To run with verbose output:
+```bash
+python manage.py test --verbosity=2
+```
+
+All tests are currently passing and provide comprehensive coverage of the application's functionality.

VorgabenUI/settings-docker.py

@@ -24,7 +24,7 @@ BASE_DIR = Path(__file__).resolve().parent.parent
 SECRET_KEY = os.environ.get("SECRET_KEY")
 
 # SECURITY WARNING: don't run with debug turned on in production!
-DEBUG = bool(os.environ.get("DEBUG", default=0)
+DEBUG = bool(os.environ.get("DEBUG", default=0))
 
 ALLOWED_HOSTS = os.environ.get("DJANGO_ALLOWED_HOSTS","127.0.0.1").split(",")
 
@@ -38,7 +38,7 @@ INSTALLED_APPS = [
     'django.contrib.sessions',
     'django.contrib.messages',
     'django.contrib.staticfiles',
-    'standards',
+    'dokumente',
     'abschnitte',
     'stichworte',
     'mptt',
@@ -126,6 +126,13 @@ STATICFILES_DIRS= (
     os.path.join(BASE_DIR,"static"),
     )
 
+# Media files (User-uploaded content)
+MEDIA_URL = '/media/'
+MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
+
+# Diagram cache settings
+DIAGRAM_CACHE_DIR = 'diagram_cache'  # relative to MEDIA_ROOT
+
 # Default primary key field type
 # https://docs.djangoproject.com/en/5.2/ref/settings/#default-auto-field
 

VorgabenUI/settings.py

@@ -28,12 +28,6 @@ DEBUG = True
 
 ALLOWED_HOSTS = ["10.128.128.144","localhost","127.0.0.1","*"]
 
-TEMPLATES = [
-        {"BACKEND": "django.template.backends.django.DjangoTemplates",
-        "APP_DIRS": True,
-        }
-]
-
 # Application definition
 
 INSTALLED_APPS = [
@@ -43,7 +37,7 @@ INSTALLED_APPS = [
     'django.contrib.sessions',
     'django.contrib.messages',
     'django.contrib.staticfiles',
-    'standards',
+    'dokumente',
     'abschnitte',
     'stichworte',
     'referenzen',
@@ -51,12 +45,9 @@ INSTALLED_APPS = [
     'mptt',
     'pages',
     'nested_admin',
-    'revproxy.apps.RevProxyConfig',
-    'debug_toolbar',
 ]
 
 MIDDLEWARE = [
-    'debug_toolbar.middleware.DebugToolbarMiddleware',
     'django.middleware.security.SecurityMiddleware',
     'django.contrib.sessions.middleware.SessionMiddleware',
     'django.middleware.common.CommonMiddleware',
@@ -136,11 +127,18 @@ USE_TZ = True
 
 STATIC_URL = '/static/'
 #STATIC_ROOT="/home/adebaumann/VorgabenUI/staticfiles/"
-STATIC_ROOT="/app/staticfiles/"
+STATIC_ROOT="staticfiles/"
 STATICFILES_DIRS= (
     os.path.join(BASE_DIR,"static"),
     )
 
+# Media files (User-uploaded content)
+MEDIA_URL = '/media/'
+MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
+
+# Diagram cache settings
+DIAGRAM_CACHE_DIR = 'diagram_cache'  # relative to MEDIA_ROOT
+
 # Default primary key field type
 # https://docs.djangoproject.com/en/5.2/ref/settings/#default-auto-field
 
@@ -148,6 +146,11 @@ DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
 DATA_UPLOAD_MAX_NUMBER_FIELDS=10250
 NESTED_ADMIN_LAZY_INLINES = True
 
+# Authentication settings
+LOGIN_URL = 'login'
+LOGIN_REDIRECT_URL = '/'
+LOGOUT_REDIRECT_URL = 'login'
+
 #LOGGING = {
 #    "version": 1,
 #    "handlers"  :{

VorgabenUI/urls.py

@@ -18,9 +18,8 @@ from django.contrib import admin
 from django.urls import include, path, re_path
 from django.conf import settings
 from django.conf.urls.static import static
-from debug_toolbar.toolbar import debug_toolbar_urls
-from diagramm_proxy.views import DiagrammProxyView
-import standards.views
+from django.contrib.auth import views as auth_views
+import dokumente.views
 import pages.views
 import referenzen.views
 
@@ -29,11 +28,21 @@ admin.site.site_header="Autorenumgebung"
 urlpatterns = [
     path('',pages.views.startseite),
     path('search/',pages.views.search),
-    path('standards/', include("standards.urls")),
+    path('dokumente/', include("dokumente.urls")),
     path('autorenumgebung/', admin.site.urls),
     path('stichworte/', include("stichworte.urls")),
     path('referenzen/', referenzen.views.tree, name="referenz_tree"),
     path('referenzen/<str:refid>/', referenzen.views.detail, name="referenz_detail"),
-    re_path(r'^diagramm/(?P<path>.*)$', DiagrammProxyView.as_view()),
-] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) +debug_toolbar_urls()
+    # Authentication URLs
+    path('login/', auth_views.LoginView.as_view(template_name='registration/login.html'), name='login'),
+    path('logout/', auth_views.LogoutView.as_view(next_page='/'), name='logout'),
+    path('password_change/', auth_views.PasswordChangeView.as_view(template_name='registration/password_change.html', success_url='/'), name='password_change'),
+    path('password_change/done/', auth_views.PasswordChangeDoneView.as_view(template_name='registration/password_change_done.html'), name='password_change_done'),
+]
 
+# Serve static files
+urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
+
+# Serve media files (including cached diagrams)
+if settings.DEBUG:
+    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

abschnitte/management/__init__.py

@@ -0,0 +1 @@
+# Management commands

abschnitte/management/commands/__init__.py

@@ -0,0 +1 @@
+# Commands package

abschnitte/management/commands/clear_diagram_cache.py

@@ -0,0 +1,23 @@
+from django.core.management.base import BaseCommand
+from diagramm_proxy.diagram_cache import clear_cache
+
+
+class Command(BaseCommand):
+    help = 'Clear cached diagrams'
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            '--type',
+            type=str,
+            help='Diagram type to clear (e.g., plantuml, mermaid)',
+        )
+
+    def handle(self, *args, **options):
+        diagram_type = options.get('type')
+        if diagram_type:
+            self.stdout.write(f'Clearing cache for {diagram_type}...')
+            clear_cache(diagram_type)
+        else:
+            self.stdout.write('Clearing all diagram caches...')
+            clear_cache()
+        self.stdout.write(self.style.SUCCESS('Cache cleared successfully'))

abschnitte/tests.py

@@ -1,3 +1,846 @@
-from django.test import TestCase
+from django.test import TestCase, TransactionTestCase
+from django.core.management import call_command
+from django.conf import settings
+from django.core.files.storage import default_storage
+from unittest.mock import patch, Mock, MagicMock
+from io import StringIO
+import os
+import hashlib
+import tempfile
+import shutil
 
-# Create your tests here.
+from .models import AbschnittTyp, Textabschnitt
+from .utils import render_textabschnitte, md_table_to_html
+from diagramm_proxy.diagram_cache import (
+    get_cached_diagram, compute_hash, get_cache_path, clear_cache
+)
+
+
+class AbschnittTypModelTest(TestCase):
+    """Test cases for AbschnittTyp model"""
+
+    def setUp(self):
+        """Set up test data"""
+        self.abschnitttyp = AbschnittTyp.objects.create(
+            abschnitttyp="text"
+        )
+
+    def test_abschnitttyp_creation(self):
+        """Test that AbschnittTyp is created correctly"""
+        self.assertEqual(self.abschnitttyp.abschnitttyp, "text")
+
+    def test_abschnitttyp_str(self):
+        """Test string representation of AbschnittTyp"""
+        self.assertEqual(str(self.abschnitttyp), "text")
+
+    def test_abschnitttyp_verbose_name_plural(self):
+        """Test verbose name plural"""
+        self.assertEqual(
+            AbschnittTyp._meta.verbose_name_plural,
+            "Abschnitttypen"
+        )
+
+    def test_abschnitttyp_primary_key(self):
+        """Test that abschnitttyp field is the primary key"""
+        pk_field = AbschnittTyp._meta.pk
+        self.assertEqual(pk_field.name, 'abschnitttyp')
+
+    def test_create_multiple_abschnitttypen(self):
+        """Test creating multiple AbschnittTyp objects"""
+        types = ['liste ungeordnet', 'liste geordnet', 'tabelle', 'diagramm', 'code']
+        for typ in types:
+            AbschnittTyp.objects.create(abschnitttyp=typ)
+
+        self.assertEqual(AbschnittTyp.objects.count(), 6)  # Including setUp type
+
+
+class TextabschnittModelTest(TestCase):
+    """Test cases for Textabschnitt abstract model using VorgabeLangtext"""
+
+    def setUp(self):
+        """Set up test data"""
+        from dokumente.models import Dokumententyp, Dokument, Vorgabe, VorgabeLangtext, Thema
+        from datetime import date
+
+        self.typ_text = AbschnittTyp.objects.create(abschnitttyp="text")
+        self.typ_code = AbschnittTyp.objects.create(abschnitttyp="code")
+
+        # Create required dokumente objects
+        self.dokumententyp = Dokumententyp.objects.create(
+            name="Test Type", verantwortliche_ve="TEST"
+        )
+        self.dokument = Dokument.objects.create(
+            nummer="TEST-001",
+            name="Test Doc",
+            dokumententyp=self.dokumententyp,
+            aktiv=True
+        )
+        self.thema = Thema.objects.create(name="Test Thema")
+        self.vorgabe = Vorgabe.objects.create(
+            dokument=self.dokument,
+            nummer=1,
+            order=1,
+            thema=self.thema,
+            titel="Test Vorgabe",
+            gueltigkeit_von=date.today()
+        )
+
+    def test_textabschnitt_creation(self):
+        """Test that Textabschnitt can be instantiated via concrete model"""
+        from dokumente.models import VorgabeLangtext
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt="Test content",
+            order=1
+        )
+        self.assertEqual(abschnitt.abschnitttyp, self.typ_text)
+        self.assertEqual(abschnitt.inhalt, "Test content")
+        self.assertEqual(abschnitt.order, 1)
+
+    def test_textabschnitt_default_order(self):
+        """Test that order defaults to 0"""
+        from dokumente.models import VorgabeLangtext
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt="Test"
+        )
+        self.assertEqual(abschnitt.order, 0)
+
+    def test_textabschnitt_blank_fields(self):
+        """Test that abschnitttyp and inhalt can be blank/null"""
+        from dokumente.models import VorgabeLangtext
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe
+        )
+        self.assertIsNone(abschnitt.abschnitttyp)
+        self.assertIsNone(abschnitt.inhalt)
+
+    def test_textabschnitt_ordering(self):
+        """Test that Textabschnitte can be ordered"""
+        from dokumente.models import VorgabeLangtext
+
+        abschnitt1 = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt="First",
+            order=2
+        )
+        abschnitt2 = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt="Second",
+            order=1
+        )
+        abschnitt3 = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt="Third",
+            order=3
+        )
+
+        ordered = VorgabeLangtext.objects.filter(abschnitt=self.vorgabe).order_by('order')
+        self.assertEqual(list(ordered), [abschnitt2, abschnitt1, abschnitt3])
+
+    def test_textabschnitt_foreign_key_protection(self):
+        """Test that AbschnittTyp is protected from deletion"""
+        from dokumente.models import VorgabeLangtext
+        from django.db.models import ProtectedError
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt="Test"
+        )
+
+        # Try to delete the AbschnittTyp
+        with self.assertRaises(ProtectedError):
+            self.typ_text.delete()
+
+
+class RenderTextabschnitteTest(TestCase):
+    """Test cases for render_textabschnitte function"""
+
+    def setUp(self):
+        """Set up test data"""
+        from dokumente.models import Dokumententyp, Dokument, Vorgabe, VorgabeLangtext, Thema
+        from datetime import date
+
+        self.typ_text = AbschnittTyp.objects.create(abschnitttyp="text")
+        self.typ_unordered = AbschnittTyp.objects.create(abschnitttyp="liste ungeordnet")
+        self.typ_ordered = AbschnittTyp.objects.create(abschnitttyp="liste geordnet")
+        self.typ_table = AbschnittTyp.objects.create(abschnitttyp="tabelle")
+        self.typ_code = AbschnittTyp.objects.create(abschnitttyp="code")
+        self.typ_diagram = AbschnittTyp.objects.create(abschnitttyp="diagramm")
+
+        # Create required dokumente objects
+        self.dokumententyp = Dokumententyp.objects.create(
+            name="Test Type", verantwortliche_ve="TEST"
+        )
+        self.dokument = Dokument.objects.create(
+            nummer="TEST-001",
+            name="Test Doc",
+            dokumententyp=self.dokumententyp,
+            aktiv=True
+        )
+        self.thema = Thema.objects.create(name="Test Thema")
+        self.vorgabe = Vorgabe.objects.create(
+            dokument=self.dokument,
+            nummer=1,
+            order=1,
+            thema=self.thema,
+            titel="Test Vorgabe",
+            gueltigkeit_von=date.today()
+        )
+
+    def test_render_empty_queryset(self):
+        """Test rendering an empty queryset"""
+        from dokumente.models import VorgabeLangtext
+
+        result = render_textabschnitte(VorgabeLangtext.objects.none())
+        self.assertEqual(result, [])
+
+    def test_render_text_markdown(self):
+        """Test rendering plain text with markdown"""
+        from dokumente.models import VorgabeLangtext
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt="# Heading\n\nThis is **bold** text.",
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(abschnitt=self.vorgabe))
+        self.assertEqual(len(result), 1)
+        typ, html = result[0]
+        self.assertEqual(typ, "text")
+        self.assertIn("<h1>Heading</h1>", html)
+        self.assertIn("<strong>bold</strong>", html)
+
+    def test_render_text_with_footnotes(self):
+        """Test rendering text with footnotes"""
+        from dokumente.models import VorgabeLangtext
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt="This is text[^1].\n\n[^1]: This is a footnote.",
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(abschnitt=self.vorgabe))
+        typ, html = result[0]
+        self.assertIn("footnote", html.lower())
+
+    def test_render_unordered_list(self):
+        """Test rendering unordered list"""
+        from dokumente.models import VorgabeLangtext
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_unordered,
+            inhalt="Item 1\nItem 2\nItem 3",
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(abschnitt=self.vorgabe))
+        typ, html = result[0]
+        self.assertEqual(typ, "liste ungeordnet")
+        self.assertIn("<ul>", html)
+        self.assertIn("<li>Item 1</li>", html)
+        self.assertIn("<li>Item 2</li>", html)
+        self.assertIn("<li>Item 3</li>", html)
+
+    def test_render_ordered_list(self):
+        """Test rendering ordered list"""
+        from dokumente.models import VorgabeLangtext
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_ordered,
+            inhalt="First item\nSecond item\nThird item",
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(abschnitt=self.vorgabe))
+        typ, html = result[0]
+        self.assertEqual(typ, "liste geordnet")
+        self.assertIn("<ol>", html)
+        self.assertIn("<li>First item</li>", html)
+        self.assertIn("<li>Second item</li>", html)
+        self.assertIn("<li>Third item</li>", html)
+
+    def test_render_table(self):
+        """Test rendering table"""
+        from dokumente.models import VorgabeLangtext
+
+        table_content = """| Header 1 | Header 2 |
+|----------|----------|
+| Cell 1   | Cell 2   |
+| Cell 3   | Cell 4   |"""
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_table,
+            inhalt=table_content,
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(abschnitt=self.vorgabe))
+        typ, html = result[0]
+        self.assertEqual(typ, "tabelle")
+        self.assertIn('<table class="table table-bordered table-hover">', html)
+        self.assertIn("<thead>", html)
+        self.assertIn("<th>Header 1</th>", html)
+        self.assertIn("<th>Header 2</th>", html)
+        self.assertIn("<tbody>", html)
+        self.assertIn("<td>Cell 1</td>", html)
+        self.assertIn("<td>Cell 2</td>", html)
+
+    def test_render_code_block(self):
+        """Test rendering code block"""
+        from dokumente.models import VorgabeLangtext
+
+        code_content = "def hello():\n    print('Hello, World!')"
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_code,
+            inhalt=code_content,
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(abschnitt=self.vorgabe))
+        typ, html = result[0]
+        self.assertEqual(typ, "code")
+        self.assertIn("<pre><code>", html)
+        self.assertIn("</code></pre>", html)
+        self.assertIn("hello", html)
+
+    @patch('abschnitte.utils.get_cached_diagram')
+    def test_render_diagram_success(self, mock_get_cached):
+        """Test rendering diagram with successful caching"""
+        from dokumente.models import VorgabeLangtext
+
+        mock_get_cached.return_value = "diagram_cache/plantuml/abc123.svg"
+
+        diagram_content = """plantuml
+@startuml
+Alice -> Bob: Hello
+@enduml"""
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_diagram,
+            inhalt=diagram_content,
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(abschnitt=self.vorgabe))
+        typ, html = result[0]
+        self.assertEqual(typ, "diagramm")
+        self.assertIn('<img', html)
+        self.assertIn('width="100%"', html)
+        self.assertIn('diagram_cache/plantuml/abc123.svg', html)
+
+        # Verify get_cached_diagram was called correctly
+        mock_get_cached.assert_called_once()
+        args = mock_get_cached.call_args[0]
+        self.assertEqual(args[0], "plantuml")
+        self.assertIn("Alice -> Bob", args[1])
+
+    @patch('abschnitte.utils.get_cached_diagram')
+    def test_render_diagram_with_options(self, mock_get_cached):
+        """Test rendering diagram with custom options"""
+        from dokumente.models import VorgabeLangtext
+
+        mock_get_cached.return_value = "diagram_cache/mermaid/xyz789.svg"
+
+        diagram_content = """mermaid
+option: width="50%" height="300px"
+graph TD
+    A-->B"""
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_diagram,
+            inhalt=diagram_content,
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(abschnitt=self.vorgabe))
+        typ, html = result[0]
+        self.assertIn('width="50%"', html)
+        self.assertIn('height="300px"', html)
+
+    @patch('abschnitte.utils.get_cached_diagram')
+    def test_render_diagram_error(self, mock_get_cached):
+        """Test rendering diagram when caching fails"""
+        from dokumente.models import VorgabeLangtext
+
+        mock_get_cached.side_effect = Exception("Connection error")
+
+        diagram_content = """plantuml
+@startuml
+A -> B
+@enduml"""
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_diagram,
+            inhalt=diagram_content,
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(abschnitt=self.vorgabe))
+        typ, html = result[0]
+        self.assertIn("Error generating diagram", html)
+        self.assertIn("Connection error", html)
+        self.assertIn('class="text-danger"', html)
+
+    def test_render_multiple_abschnitte(self):
+        """Test rendering multiple Textabschnitte in order"""
+        from dokumente.models import VorgabeLangtext
+
+        abschnitt1 = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt="First section",
+            order=1
+        )
+        abschnitt2 = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_unordered,
+            inhalt="Item 1\nItem 2",
+            order=2
+        )
+        abschnitt3 = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_code,
+            inhalt="print('hello')",
+            order=3
+        )
+
+        result = render_textabschnitte(
+            VorgabeLangtext.objects.filter(abschnitt=self.vorgabe).order_by('order')
+        )
+
+        self.assertEqual(len(result), 3)
+        self.assertEqual(result[0][0], "text")
+        self.assertEqual(result[1][0], "liste ungeordnet")
+        self.assertEqual(result[2][0], "code")
+
+    def test_render_abschnitt_without_type(self):
+        """Test rendering Textabschnitt without AbschnittTyp"""
+        from dokumente.models import VorgabeLangtext
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=None,
+            inhalt="Content without type",
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(abschnitt=self.vorgabe))
+        typ, html = result[0]
+        self.assertEqual(typ, '')
+        self.assertIn("Content without type", html)
+
+    def test_render_abschnitt_with_empty_content(self):
+        """Test rendering Textabschnitt with empty content"""
+        from dokumente.models import VorgabeLangtext
+
+        abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt=None,
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(abschnitt=self.vorgabe))
+        self.assertEqual(len(result), 1)
+        typ, html = result[0]
+        self.assertEqual(typ, "text")
+
+    def test_render_textabschnitte_xss_prevention(self):
+        """Test that malicious HTML is sanitized in rendered content"""
+        from dokumente.models import VorgabeLangtext
+
+        # Create content with malicious HTML
+        malicious_abschnitt = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt='<script>alert("xss")</script><img src=x onerror=alert(1)>Normal text',
+            order=1
+        )
+
+        result = render_textabschnitte(VorgabeLangtext.objects.filter(pk=malicious_abschnitt.pk))
+
+        self.assertEqual(len(result), 1)
+        typ, html = result[0]
+        self.assertEqual(typ, "text")
+
+        # Dangerous tags and attributes should be removed or sanitized
+        self.assertNotIn('<script>', html)  # Script tags should not be present unescaped
+        self.assertNotIn('onerror', html)   # Dangerous attributes removed
+        # Note: 'alert' may still be present in escaped script tags, which is safe
+
+        # Safe content should remain
+        self.assertIn('Normal text', html)
+
+
+class MdTableToHtmlTest(TestCase):
+    """Test cases for md_table_to_html function"""
+
+    def test_simple_table(self):
+        """Test converting a simple markdown table to HTML"""
+        md = """| Name | Age |
+|------|-----|
+| John | 30  |
+| Jane | 25  |"""
+
+        html = md_table_to_html(md)
+
+        self.assertIn('<table class="table table-bordered table-hover">', html)
+        self.assertIn("<thead>", html)
+        self.assertIn("<th>Name</th>", html)
+        self.assertIn("<th>Age</th>", html)
+        self.assertIn("<tbody>", html)
+        self.assertIn("<td>John</td>", html)
+        self.assertIn("<td>30</td>", html)
+        self.assertIn("<td>Jane</td>", html)
+        self.assertIn("<td>25</td>", html)
+
+    def test_table_with_multiple_rows(self):
+        """Test table with multiple rows"""
+        md = """| A | B | C |
+|---|---|---|
+| 1 | 2 | 3 |
+| 4 | 5 | 6 |
+| 7 | 8 | 9 |"""
+
+        html = md_table_to_html(md)
+
+        self.assertEqual(html.count("<tr>"), 4)  # 1 header + 3 body rows
+        self.assertEqual(html.count("<td>"), 9)  # 3x3 cells
+        self.assertEqual(html.count("<th>"), 3)  # 3 headers
+
+    def test_table_with_spaces(self):
+        """Test table with extra spaces"""
+        md = """  |  Header 1  |  Header 2  |
+  | --------- | ---------- |
+  |  Value 1  |  Value 2   |  """
+
+        html = md_table_to_html(md)
+
+        self.assertIn("<th>Header 1</th>", html)
+        self.assertIn("<th>Header 2</th>", html)
+        self.assertIn("<td>Value 1</td>", html)
+        self.assertIn("<td>Value 2</td>", html)
+
+    def test_table_with_empty_cells(self):
+        """Test table with empty cells"""
+        md = """| Col1 | Col2 | Col3 |
+|------|------|------|
+| A    |      | C    |
+|      | B    |      |"""
+
+        html = md_table_to_html(md)
+
+        self.assertIn("<td>A</td>", html)
+        self.assertIn("<td></td>", html)
+        self.assertIn("<td>C</td>", html)
+        self.assertIn("<td>B</td>", html)
+
+    def test_table_insufficient_lines(self):
+        """Test that ValueError is raised for insufficient lines"""
+        md = """| Header |"""
+
+        with self.assertRaises(ValueError) as context:
+            md_table_to_html(md)
+
+        self.assertIn("at least header + separator", str(context.exception))
+
+    def test_table_empty_string(self):
+        """Test that ValueError is raised for empty string"""
+        with self.assertRaises(ValueError):
+            md_table_to_html("")
+
+    def test_table_only_whitespace(self):
+        """Test that ValueError is raised for only whitespace"""
+        with self.assertRaises(ValueError):
+            md_table_to_html("   \n   \n   ")
+
+
+class DiagramCacheTest(TestCase):
+    """Test cases for diagram caching functionality"""
+
+    def setUp(self):
+        """Set up test environment"""
+        # Create a temporary directory for testing
+        self.test_media_root = tempfile.mkdtemp()
+        self.original_media_root = settings.MEDIA_ROOT
+        settings.MEDIA_ROOT = self.test_media_root
+
+    def tearDown(self):
+        """Clean up test environment"""
+        # Restore original settings
+        settings.MEDIA_ROOT = self.original_media_root
+        # Remove test directory
+        if os.path.exists(self.test_media_root):
+            shutil.rmtree(self.test_media_root)
+
+    def test_compute_hash(self):
+        """Test that compute_hash generates consistent SHA256 hashes"""
+        content1 = "test content"
+        content2 = "test content"
+        content3 = "different content"
+
+        hash1 = compute_hash(content1)
+        hash2 = compute_hash(content2)
+        hash3 = compute_hash(content3)
+
+        # Same content should produce same hash
+        self.assertEqual(hash1, hash2)
+        # Different content should produce different hash
+        self.assertNotEqual(hash1, hash3)
+        # Hash should be 64 characters (SHA256 hex)
+        self.assertEqual(len(hash1), 64)
+
+    def test_get_cache_path(self):
+        """Test that get_cache_path generates correct paths"""
+        diagram_type = "plantuml"
+        content_hash = "abc123"
+
+        path = get_cache_path(diagram_type, content_hash)
+
+        self.assertIn("diagram_cache", path)
+        self.assertIn("plantuml", path)
+        self.assertIn("abc123.svg", path)
+
+    @patch('diagramm_proxy.diagram_cache.requests.post')
+    @patch('diagramm_proxy.diagram_cache.default_storage')
+    def test_get_cached_diagram_miss(self, mock_storage, mock_post):
+        """Test diagram generation on cache miss"""
+        # Setup mocks
+        mock_storage.exists.return_value = False
+        mock_storage.path.return_value = os.path.join(
+            self.test_media_root, 'diagram_cache/plantuml/test.svg'
+        )
+        mock_response = Mock()
+        mock_response.content = b'<svg>test</svg>'
+        mock_post.return_value = mock_response
+
+        diagram_content = "@startuml\nA -> B\n@enduml"
+
+        # Call function
+        result = get_cached_diagram("plantuml", diagram_content)
+
+        # Verify POST request was made
+        mock_post.assert_called_once()
+        call_args = mock_post.call_args
+        # Check URL in positional args (first argument)
+        self.assertIn("plantuml/svg", call_args[0][0])
+
+        # Verify storage.save was called
+        mock_storage.save.assert_called_once()
+
+    @patch('diagramm_proxy.diagram_cache.default_storage')
+    def test_get_cached_diagram_hit(self, mock_storage):
+        """Test diagram retrieval on cache hit"""
+        # Setup mock - diagram exists in cache
+        mock_storage.exists.return_value = True
+
+        diagram_content = "@startuml\nA -> B\n@enduml"
+
+        # Call function
+        result = get_cached_diagram("plantuml", diagram_content)
+
+        # Verify no save was attempted (cache hit)
+        mock_storage.save.assert_not_called()
+
+        # Verify result contains expected path elements
+        self.assertIn("diagram_cache", result)
+        self.assertIn("plantuml", result)
+        self.assertIn(".svg", result)
+
+    @patch('diagramm_proxy.diagram_cache.requests.post')
+    @patch('diagramm_proxy.diagram_cache.default_storage')
+    def test_get_cached_diagram_request_error(self, mock_storage, mock_post):
+        """Test that request errors are properly raised"""
+        import requests
+
+        mock_storage.exists.return_value = False
+        mock_storage.path.return_value = os.path.join(
+            self.test_media_root, 'diagram_cache/plantuml/test.svg'
+        )
+        mock_post.side_effect = requests.RequestException("Connection error")
+
+        with self.assertRaises(requests.RequestException):
+            get_cached_diagram("plantuml", "@startuml\nA -> B\n@enduml")
+
+    @patch('diagramm_proxy.diagram_cache.default_storage')
+    def test_clear_cache_specific_type(self, mock_storage):
+        """Test clearing cache for specific diagram type"""
+        # Create real test cache structure for this test
+        cache_dir = os.path.join(self.test_media_root, 'diagram_cache', 'plantuml')
+        os.makedirs(cache_dir, exist_ok=True)
+
+        # Create test files
+        test_file1 = os.path.join(cache_dir, 'test1.svg')
+        test_file2 = os.path.join(cache_dir, 'test2.svg')
+        open(test_file1, 'w').close()
+        open(test_file2, 'w').close()
+
+        # Mock storage methods
+        mock_storage.exists.return_value = True
+        mock_storage.path.return_value = cache_dir
+
+        # Clear cache
+        clear_cache('plantuml')
+
+        # Verify files are deleted
+        self.assertFalse(os.path.exists(test_file1))
+        self.assertFalse(os.path.exists(test_file2))
+
+    @patch('diagramm_proxy.diagram_cache.default_storage')
+    def test_clear_cache_all_types(self, mock_storage):
+        """Test clearing cache for all diagram types"""
+        # Create real test cache structure with multiple types
+        cache_root = os.path.join(self.test_media_root, 'diagram_cache')
+        for diagram_type in ['plantuml', 'mermaid', 'graphviz']:
+            cache_dir = os.path.join(cache_root, diagram_type)
+            os.makedirs(cache_dir, exist_ok=True)
+            test_file = os.path.join(cache_dir, 'test.svg')
+            open(test_file, 'w').close()
+
+        # Mock storage methods
+        mock_storage.exists.return_value = True
+        mock_storage.path.return_value = cache_root
+
+        # Clear all cache
+        clear_cache()
+
+        # Verify all files are deleted
+        for diagram_type in ['plantuml', 'mermaid', 'graphviz']:
+            test_file = os.path.join(cache_root, diagram_type, 'test.svg')
+            self.assertFalse(os.path.exists(test_file))
+
+
+class ClearDiagramCacheCommandTest(TestCase):
+    """Test cases for clear_diagram_cache management command"""
+
+    def setUp(self):
+        """Set up test environment"""
+        self.test_media_root = tempfile.mkdtemp()
+        self.original_media_root = settings.MEDIA_ROOT
+        settings.MEDIA_ROOT = self.test_media_root
+
+    def tearDown(self):
+        """Clean up test environment"""
+        settings.MEDIA_ROOT = self.original_media_root
+        if os.path.exists(self.test_media_root):
+            shutil.rmtree(self.test_media_root)
+
+    def test_command_without_type(self):
+        """Test running command without specifying type"""
+        # Create test cache
+        cache_dir = os.path.join(self.test_media_root, 'diagram_cache', 'plantuml')
+        os.makedirs(cache_dir, exist_ok=True)
+        test_file = os.path.join(cache_dir, 'test.svg')
+        open(test_file, 'w').close()
+
+        # Run command
+        out = StringIO()
+        call_command('clear_diagram_cache', stdout=out)
+
+        # Check output
+        self.assertIn('Clearing all diagram caches', out.getvalue())
+        self.assertIn('Cache cleared successfully', out.getvalue())
+
+    def test_command_with_type(self):
+        """Test running command with specific diagram type"""
+        # Create test cache
+        cache_dir = os.path.join(self.test_media_root, 'diagram_cache', 'mermaid')
+        os.makedirs(cache_dir, exist_ok=True)
+        test_file = os.path.join(cache_dir, 'test.svg')
+        open(test_file, 'w').close()
+
+        # Run command
+        out = StringIO()
+        call_command('clear_diagram_cache', type='mermaid', stdout=out)
+
+        # Check output
+        self.assertIn('Clearing cache for mermaid', out.getvalue())
+        self.assertIn('Cache cleared successfully', out.getvalue())
+
+
+class IntegrationTest(TestCase):
+    """Integration tests with actual dokumente models"""
+
+    def setUp(self):
+        """Set up test data using dokumente models"""
+        from dokumente.models import (
+            Dokumententyp, Dokument, Vorgabe, VorgabeLangtext, Thema
+        )
+        from datetime import date
+
+        # Create required objects
+        self.dokumententyp = Dokumententyp.objects.create(
+            name="Test Policy",
+            verantwortliche_ve="TEST"
+        )
+
+        self.dokument = Dokument.objects.create(
+            nummer="TEST-001",
+            name="Test Document",
+            dokumententyp=self.dokumententyp,
+            aktiv=True
+        )
+
+        self.thema = Thema.objects.create(name="Test Thema")
+        self.vorgabe = Vorgabe.objects.create(
+            dokument=self.dokument,
+            nummer=1,
+            order=1,
+            thema=self.thema,
+            titel="Test Vorgabe",
+            gueltigkeit_von=date.today()
+        )
+
+        # Create AbschnittTypen
+        self.typ_text = AbschnittTyp.objects.create(abschnitttyp="text")
+
+        # Create VorgabeLangtext (which inherits from Textabschnitt)
+        self.langtext = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.typ_text,
+            inhalt="# Test\n\nThis is a **test** vorgabe.",
+            order=1
+        )
+
+    def test_render_vorgabe_langtext(self):
+        """Test rendering VorgabeLangtext through render_textabschnitte"""
+        from dokumente.models import VorgabeLangtext
+
+        result = render_textabschnitte(
+            VorgabeLangtext.objects.filter(abschnitt=self.vorgabe).order_by('order')
+        )
+
+        self.assertEqual(len(result), 1)
+        typ, html = result[0]
+        self.assertEqual(typ, "text")
+        self.assertIn("<h1>Test</h1>", html)
+        self.assertIn("<strong>test</strong>", html)
+        self.assertIn("vorgabe", html)
+
+    def test_textabschnitt_inheritance(self):
+        """Test that VorgabeLangtext properly inherits Textabschnitt fields"""
+        self.assertEqual(self.langtext.abschnitttyp, self.typ_text)
+        self.assertIn("test", self.langtext.inhalt)
+        self.assertEqual(self.langtext.order, 1)

abschnitte/utils.py

@@ -3,9 +3,35 @@ import base64
 import zlib
 import re
 from textwrap import dedent
+from django.conf import settings
+import bleach
+
+# Import the caching function
+from diagramm_proxy.diagram_cache import get_cached_diagram
 
 DIAGRAMMSERVER="/diagramm"
 
+# Allowed HTML tags for bleach sanitization
+ALLOWED_TAGS = [
+    'p', 'br', 'strong', 'em', 'u', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6',
+    'ul', 'ol', 'li', 'blockquote', 'code', 'pre', 'hr',
+    'table', 'thead', 'tbody', 'tr', 'th', 'td',
+    'img', 'a', 'sup', 'sub', 'span', 'div'
+]
+
+ALLOWED_ATTRIBUTES = {
+    'img': ['src', 'alt', 'width', 'height'],
+    'a': ['href', 'title'],
+    'span': ['class'],
+    'div': ['class'],
+    'p': ['class'],
+    'table': ['class'],
+    'th': ['colspan', 'rowspan', 'class'],
+    'td': ['colspan', 'rowspan', 'class'],
+    'pre': ['class'],
+    'code': ['class'],
+}
+
 def render_textabschnitte(queryset):
     """
     Converts a queryset of Textabschnitt-like models into a list of (typ, html) tuples.
@@ -25,21 +51,31 @@ def render_textabschnitte(queryset):
         elif typ == "tabelle":
             html = md_table_to_html(inhalt)
         elif typ == "diagramm":
-            temp=inhalt.splitlines()
-            diagramtype=temp.pop(0)
-            diagramoptions='width="100%"'
-            if temp[0][0:6].lower() == "option":
-                diagramoptions=temp.pop(0).split(":",1)[1]
-            rest="\n".join(temp)
-            html = '<p><img '+diagramoptions+' src="'+DIAGRAMMSERVER+"/"+diagramtype+"/svg/"
-            html += base64.urlsafe_b64encode(zlib.compress(rest.encode("utf-8"),9)).decode()
-            html += '"></p>'
+            temp = inhalt.splitlines()
+            diagramtype = temp.pop(0)
+            diagramoptions = 'width="100%"'
+            if temp and temp[0][0:6].lower() == "option":
+                diagramoptions = temp.pop(0).split(":", 1)[1]
+            rest = "\n".join(temp)
+            
+            # Use caching instead of URL encoding
+            try:
+                cache_path = get_cached_diagram(diagramtype, rest)
+                # Generate URL to serve from media/static
+                diagram_url = settings.MEDIA_URL + cache_path
+                html = f'<p><img {diagramoptions} src="{diagram_url}"></p>'
+            except Exception as e:
+                # Fallback to error message
+                html = f'<p class="text-danger">Error generating diagram: {str(e)}</p>'
+                
         elif typ == "code":
             html = "<pre><code>"
             html += markdown(inhalt, extensions=['tables', 'attr_list'])
             html += "</code></pre>"
         else:
             html = markdown(inhalt, extensions=['tables', 'attr_list','footnotes'])
+        # Sanitize HTML to prevent XSS
+        html = bleach.clean(html, tags=ALLOWED_TAGS, attributes=ALLOWED_ATTRIBUTES)
         output.append((typ, html))
     return output
 

admin/css/vorgabe_border.css

@@ -0,0 +1,102 @@
+/* Better visual separation for Vorgaben inlines */
+.inline-group[data-inline-model="vorgabe"] {
+    border: 2px solid #ddd;
+    border-radius: 8px;
+    margin-bottom: 20px;
+    padding: 15px;
+    background-color: #f9f9f9;
+    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+}
+
+.inline-group[data-inline-model="vorgabe"] .inline-related {
+    border: 1px solid #ccc;
+    border-radius: 6px;
+    margin-bottom: 10px;
+    background-color: white;
+    padding: 10px;
+}
+
+.inline-group[data-inline-model="vorgabe"] h3 {
+    background-color: #007cba;
+    color: white;
+    padding: 8px 12px;
+    margin: -15px -15px 10px -15px;
+    border-radius: 6px 6px 0 0;
+    font-weight: bold;
+}
+
+.inline-group[data-inline-model="vorgabe"] .collapse .inline-related {
+    border-left: 3px solid #007cba;
+}
+
+/* Better spacing for nested inlines */
+.inline-group[data-inline-model="vorgabe"] .inline-group {
+    margin-top: 10px;
+}
+
+.inline-group[data-inline-model="vorgabe"] .inline-group h3 {
+    background-color: #f0f8ff;
+    color: #333;
+    padding: 6px 10px;
+    margin: 0 0 8px 0;
+    border-left: 3px solid #007cba;
+}
+
+/* Highlight active/expanded vorgabe */
+.inline-group[data-inline-model="vorgabe"] .inline-related:not(.collapsed) {
+    border-color: #007cba;
+    box-shadow: 0 0 8px rgba(0,124,186,0.2);
+}
+
+/* Highlight actively edited vorgabe */
+.inline-group[data-inline-model="vorgabe"] .inline-related.active-edit {
+    border-color: #28a745;
+    box-shadow: 0 0 12px rgba(40,167,69,0.3);
+    background-color: #f8fff9;
+}
+
+/* Toggle hint styling */
+.toggle-hint {
+    font-size: 0.8em;
+    color: #666;
+    font-weight: normal;
+}
+
+/* Better fieldset styling for vorgabe inlines */
+.inline-group[data-inline-model="vorgabe"] .fieldset {
+    border: 1px solid #e0e0e0;
+    border-radius: 4px;
+    padding: 10px;
+    margin-bottom: 10px;
+    background-color: #fafafa;
+}
+
+.inline-group[data-inline-model="vorgabe"] .fieldset h2 {
+    background-color: #e3f2fd;
+    color: #1565c0;
+    padding: 5px 10px;
+    margin: -10px -10px 10px -10px;
+    border-radius: 4px 4px 0 0;
+    font-size: 0.9em;
+    font-weight: bold;
+}
+
+/* Better form layout */
+.inline-group[data-inline-model="vorgabe"] .form-row {
+    border-bottom: 1px solid #eee;
+    padding: 8px 0;
+}
+
+.inline-group[data-inline-model="vorgabe"] .form-row:last-child {
+    border-bottom: none;
+}
+
+/* Wide fields styling */
+.inline-group[data-inline-model="vorgabe"] .wide .form-row > div {
+    width: 100%;
+}
+
+.inline-group[data-inline-model="vorgabe"] .wide textarea {
+    width: 100%;
+    min-height: 80px;
+}

admin/js/vorgabe_toggle.js

@@ -0,0 +1,25 @@
+(function($) {
+    'use strict';
+    
+    $(document).ready(function() {
+        // Add toggle buttons for each vorgabe inline
+        $('.inline-group[data-inline-model="vorgabe"]').each(function() {
+            var $group = $(this);
+            var $headers = $group.find('h3');
+            
+            $headers.css('cursor', 'pointer').append(' <span class="toggle-hint">(klicken zum umschalten)</span>');
+            
+            $headers.on('click', function(e) {
+                e.preventDefault();
+                var $inline = $(this).closest('.inline-related');
+                $inline.find('.collapse').toggleClass('collapsed');
+            });
+        });
+        
+        // Highlight active vorgabe when editing
+        $('.inline-group[data-inline-model="vorgabe"] .inline-related').on('click', function() {
+            $('.inline-group[data-inline-model="vorgabe"] .inline-related').removeClass('active-edit');
+            $(this).addClass('active-edit');
+        });
+    });
+})(django.jQuery);

argocd/001_pvc.yaml

@@ -0,0 +1,13 @@
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: django-data-pvc
+  namespace: vorgabenui
+spec:
+  accessModes:
+    - ReadWriteMany
+  storageClassName: nfs
+  resources:
+    requests:
+      storage: 2Gi
+

argocd/deployment.yaml

@@ -16,9 +16,16 @@ spec:
       securityContext:
         fsGroup: 999
         fsGroupChangePolicy: "OnRootMismatch"
+      initContainers:
+        - name: loader
+          image: git.baumann.gr/adebaumann/vui-data-loader:0.10
+          command: [ "sh","-c","cp -n preload/preload.sqlite3 /data/db.sqlite3; chown -R 999:999 /data; ls -la /data; sleep 10; exit 0" ]
+          volumeMounts:
+            - name: data
+              mountPath: /data
       containers:
         - name: web
-          image: git.baumann.gr/adebaumann/vgui:khronos
+          image: git.baumann.gr/adebaumann/vui:0.968
           imagePullPolicy: Always
           ports:
             - containerPort: 8000
@@ -56,6 +63,8 @@ spec:
   selector:
     app: django
   ports:
-    - port: 8000
+    - name: http
+      protocol: TCP
+      port: 8000
       targetPort: 8000
 

argocd/diagrammer.yaml

@@ -15,7 +15,7 @@ spec:
     spec:
       containers:
         - name: kroki
-          image: docker.io/yuzutech/kroki:latest
+          image: git.baumann.gr/adebaumann/kroki:0.026
           ports:
             - containerPort: 8000
           readinessProbe:
@@ -35,15 +35,15 @@ spec:
             timeoutSeconds: 2
             failureThreshold: 3
         - name: mermaid
-          image: docker.io/yuzutech/kroki-mermaid:latest
+          image: git.baumann.gr/adebaumann/kroki-mermaid:0.026
           ports:
             - containerPort: 8002
         - name: bpmn
-          image: docker.io/yuzutech/kroki-bpmn:latest
+          image: git.baumann.gr/adebaumann/kroki-bpmn:0.026
           ports:
             - containerPort: 8003
         - name: excalidraw
-          image: docker.io/yuzutech/kroki-excalidraw:latest
+          image: git.baumann.gr/adebaumann/kroki-excalidraw:0.026
           ports:
             - containerPort: 8004
 ---

argocd/ingress.yaml

@@ -4,10 +4,11 @@ metadata:
   name: django
   namespace: vorgabenui
   annotations:
-    nginx.ingress.kubernetes.io/rewrite-target: /
+    argocd.argoproj.io/ignore-healthcheck: "true"
 spec:
+  ingressClassName: traefik
   rules:
-    - host: vorgabenui.adebaumann.com
+    - host: vorgabenportal.knowyoursecurity.com
       http:
         paths:
           - path: /

argocd/nfs-pv.yaml

@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: PersistentVolume
+metadata:
+  name: django-data-pv
+  namespace: vorgabenui
+spec:
+  capacity:
+    storage: 2Gi
+  accessModes:
+    - ReadWriteMany
+  persistentVolumeReclaimPolicy: Retain
+  storageClassName: nfs
+  nfs:
+    server: 192.168.17.199
+    path: /mnt/user/vorgabenui

argocd/nfs-storageclass.yaml

@@ -0,0 +1,8 @@
+apiVersion: storage.k8s.io/v1
+kind: StorageClass
+metadata:
+  name: nfs
+provisioner: kubernetes.io/no-provisioner
+allowVolumeExpansion: true
+reclaimPolicy: Retain
+volumeBindingMode: Immediate

data-loader/Dockerfile

@@ -8,5 +8,4 @@ RUN chown appuser:appuser /preload/preload.sqlite3
 RUN mkdir /data
 RUN chown appuser:appuser /data
 USER root
-CMD ["sh"]
 

diagramm_proxy/diagram_cache.py

@@ -0,0 +1,91 @@
+import hashlib
+import os
+import requests
+from pathlib import Path
+from django.conf import settings
+from django.core.files.storage import default_storage
+from django.core.files.base import ContentFile
+import logging
+
+logger = logging.getLogger(__name__)
+
+# Configure cache directory
+CACHE_DIR = getattr(settings, 'DIAGRAM_CACHE_DIR', 'diagram_cache')
+KROKI_UPSTREAM = "http://svckroki:8000"
+
+def get_cache_path(diagram_type, content_hash):
+    """Generate cache file path for a diagram."""
+    return os.path.join(CACHE_DIR, diagram_type, f"{content_hash}.svg")
+
+def compute_hash(content):
+    """Compute SHA256 hash of diagram content."""
+    return hashlib.sha256(content.encode('utf-8')).hexdigest()
+
+def get_cached_diagram(diagram_type, diagram_content):
+    """
+    Retrieve diagram from cache or generate it via POST.
+    
+    Args:
+        diagram_type: Type of diagram (e.g., 'plantuml', 'mermaid')
+        diagram_content: Raw diagram content
+        
+    Returns:
+        Path to cached diagram file (relative to MEDIA_ROOT)
+    """
+    content_hash = compute_hash(diagram_content)
+    cache_path = get_cache_path(diagram_type, content_hash)
+    
+    # Check if diagram exists in cache
+    if default_storage.exists(cache_path):
+        logger.debug(f"Cache hit for {diagram_type} diagram: {content_hash[:8]}")
+        return cache_path
+    
+    # Generate diagram via POST request
+    logger.info(f"Cache miss for {diagram_type} diagram: {content_hash[:8]}, generating...")
+    try:
+        url = f"{KROKI_UPSTREAM}/{diagram_type}/svg"
+        response = requests.post(
+            url,
+            data=diagram_content.encode('utf-8'),
+            headers={'Content-Type': 'text/plain'},
+            timeout=30
+        )
+        response.raise_for_status()
+        
+        # Ensure cache directory exists
+        cache_dir = os.path.dirname(default_storage.path(cache_path))
+        os.makedirs(cache_dir, exist_ok=True)
+        
+        # Save to cache
+        default_storage.save(cache_path, ContentFile(response.content))
+        logger.info(f"Diagram cached successfully: {cache_path}")
+        
+        return cache_path
+        
+    except requests.RequestException as e:
+        logger.error(f"Error generating diagram: {e}")
+        raise
+
+def clear_cache(diagram_type=None):
+    """
+    Clear cached diagrams.
+    
+    Args:
+        diagram_type: If specified, only clear diagrams of this type
+    """
+    if diagram_type:
+        cache_path = os.path.join(CACHE_DIR, diagram_type)
+    else:
+        cache_path = CACHE_DIR
+        
+    if default_storage.exists(cache_path):
+        full_path = default_storage.path(cache_path)
+        # Walk through and delete files
+        for root, dirs, files in os.walk(full_path):
+            for file in files:
+                file_path = os.path.join(root, file)
+                try:
+                    os.remove(file_path)
+                    logger.info(f"Deleted cached diagram: {file_path}")
+                except OSError as e:
+                    logger.error(f"Error deleting {file_path}: {e}")

diagramm_proxy/views.py

@@ -1,4 +0,0 @@
-from revproxy.views import ProxyView
-
-class DiagrammProxyView(ProxyView):
-    upstream = "http://svckroki:8000/"

dokumente/admin.py

@@ -0,0 +1,298 @@
+from django.contrib import admin
+#from nested_inline.admin import NestedStackedInline, NestedModelAdmin
+from nested_admin import NestedStackedInline, NestedModelAdmin, NestedTabularInline
+from django import forms
+from django.utils.html import format_html
+from mptt.forms import TreeNodeMultipleChoiceField
+from mptt.admin import DraggableMPTTAdmin
+from adminsortable2.admin import SortableInlineAdminMixin, SortableAdminBase
+
+# Register your models here.
+from .models import *
+from stichworte.models import Stichwort, Stichworterklaerung
+from referenzen.models import Referenz
+
+
+
+#class ChecklistenForm(forms.ModelForm):
+#    class Meta:
+#        model=Checklistenfrage
+#        fields="__all__"
+#        widgets = {
+#            'frage': forms.Textarea(attrs={'rows': 1, 'cols': 100}),
+#        }
+
+class ChecklistenfragenInline(NestedStackedInline):
+    model=Checklistenfrage
+    extra=0
+    fk_name="vorgabe"
+    classes = ['collapse']
+    verbose_name_plural = "Checklistenfragen"
+    fieldsets = (
+        (None, {
+            'fields': ('frage',),
+            'classes': ('wide',),
+        }),
+    )
+
+
+class VorgabeKurztextInline(NestedStackedInline):
+    model=VorgabeKurztext
+    extra=0
+    sortable_field_name = "order"
+    show_change_link=True
+    classes = ['collapse']
+    verbose_name_plural = "Kurztext-Abschnitte"
+    fieldsets = (
+        (None, {
+            'fields': ('abschnitttyp', 'inhalt', 'order'),
+            'classes': ('wide',),
+        }),
+    )
+
+class VorgabeLangtextInline(NestedStackedInline):
+    model=VorgabeLangtext
+    extra=0
+    sortable_field_name = "order"
+    show_change_link=True
+    classes = ['collapse']
+    verbose_name_plural = "Langtext-Abschnitte"
+    fieldsets = (
+        (None, {
+            'fields': ('abschnitttyp', 'inhalt', 'order'),
+            'classes': ('wide',),
+        }),
+    )
+
+class GeltungsbereichInline(NestedStackedInline):
+    model=Geltungsbereich
+    extra=0
+    sortable_field_name = "order"
+    show_change_link=True
+    classes = ['collapse']
+    verbose_name_plural = "Geltungsbereich-Abschnitte"
+    fieldsets = (
+        (None, {
+            'fields': ('abschnitttyp', 'inhalt', 'order'),
+            'classes': ('wide',),
+        }),
+    )
+
+class EinleitungInline(NestedStackedInline):
+    model = Einleitung
+    extra = 0
+    sortable_field_name = "order"
+    show_change_link = True
+    classes = ['collapse']
+    verbose_name_plural = "Einleitungs-Abschnitte"
+    fieldsets = (
+        (None, {
+            'fields': ('abschnitttyp', 'inhalt', 'order'),
+            'classes': ('wide',),
+        }),
+    )
+
+class VorgabeForm(forms.ModelForm):
+    referenzen = TreeNodeMultipleChoiceField(queryset=Referenz.objects.all(), required=False)
+    class Meta:
+        model = Vorgabe
+        fields = '__all__'
+
+class VorgabeInline(SortableInlineAdminMixin, NestedStackedInline):
+    model = Vorgabe
+    form = VorgabeForm
+    extra = 0
+    sortable_field_name = "order"
+    show_change_link = False
+    can_delete = False
+    inlines = [VorgabeKurztextInline, VorgabeLangtextInline, ChecklistenfragenInline]
+    autocomplete_fields = ['stichworte','referenzen','relevanz']
+    # Remove collapse class so Vorgaben show by default
+    
+    fieldsets = (
+        ('Grunddaten', {
+            'fields': (('order', 'nummer'), ('thema', 'titel')),
+            'classes': ('wide',),
+        }),
+        ('Gültigkeit', {
+            'fields': (('gueltigkeit_von', 'gueltigkeit_bis'),),
+            'classes': ('wide',),
+        }),
+        ('Verknüpfungen', {
+            'fields': (('referenzen', 'stichworte', 'relevanz'),),
+            'classes': ('wide',),
+        }),
+    )
+
+class StichworterklaerungInline(NestedTabularInline):
+    model=Stichworterklaerung
+    extra=0
+    sortable_field_name = "order"
+    ordering=("order",)
+    show_change_link = True
+
+@admin.register(Stichwort)
+class StichwortAdmin(NestedModelAdmin):
+    list_display = ('stichwort', 'vorgaben_count')
+    search_fields = ('stichwort',)
+    ordering=('stichwort',)
+    inlines=[StichworterklaerungInline]
+    readonly_fields = ('vorgaben_list',)
+    fieldsets = (
+        (None, {
+            'fields': ('stichwort', 'vorgaben_list')
+        }),
+    )
+    
+    def vorgaben_count(self, obj):
+        """Count the number of Vorgaben that have this Stichwort"""
+        count = obj.vorgabe_set.count()
+        return f"{count} Vorgabe{'n' if count != 1 else ''}"
+    vorgaben_count.short_description = "Anzahl Vorgaben"
+    
+    def vorgaben_list(self, obj):
+        """Display list of Vorgaben that use this Stichwort"""
+        vorgaben = obj.vorgabe_set.select_related('dokument', 'thema').order_by('dokument__nummer', 'nummer')
+        vorgaben_list = list(vorgaben)  # Evaluate queryset once
+        count = len(vorgaben_list)
+        
+        if count == 0:
+            return format_html("<em>Keine Vorgaben gefunden</em><p><strong>Gesamt: 0 Vorgaben</strong></p>")
+        
+        html = "<div style='max-height: 300px; overflow-y: auto;'>"
+        html += "<table style='width: 100%; border-collapse: collapse;'>"
+        html += "<thead><tr style='background-color: #f5f5f5;'>"
+        html += "<th style='padding: 8px; border: 1px solid #ddd; text-align: left;'>Vorgabe</th>"
+        html += "<th style='padding: 8px; border: 1px solid #ddd; text-align: left;'>Titel</th>"
+        html += "<th style='padding: 8px; border: 1px solid #ddd; text-align: left;'>Dokument</th>"
+        html += "</tr></thead>"
+        html += "<tbody>"
+        
+        for vorgabe in vorgaben_list:
+            html += "<tr>"
+            html += f"<td style='padding: 6px; border: 1px solid #ddd;'>{vorgabe.Vorgabennummer()}</td>"
+            html += f"<td style='padding: 6px; border: 1px solid #ddd;'>{vorgabe.titel}</td>"
+            html += f"<td style='padding: 6px; border: 1px solid #ddd;'>{vorgabe.dokument.nummer} – {vorgabe.dokument.name}</td>"
+            html += "</tr>"
+        
+        html += "</tbody></table>"
+        html += f"</div><p><strong>Gesamt: {count} Vorgabe{'n' if count != 1 else ''}</strong></p>"
+        
+        return format_html(html)
+    vorgaben_list.short_description = "Zugeordnete Vorgaben"
+    
+    def get_queryset(self, request):
+        """Optimize queryset with related data"""
+        return super().get_queryset(request).prefetch_related('vorgabe_set')
+
+@admin.register(Person)
+class PersonAdmin(admin.ModelAdmin):    
+    class Media:
+        js = ['admin/js/jquery.init.js', 'custom/js/inline_toggle.js']
+        css = {'all': ['custom/css/admin_extras.css']}
+    list_display=['name']
+    ordering = ['name']
+    
+
+
+@admin.register(Dokument)
+class DokumentAdmin(SortableAdminBase, NestedModelAdmin):
+    actions_on_top=True
+    inlines = [EinleitungInline, GeltungsbereichInline, VorgabeInline]
+    filter_horizontal=['autoren','pruefende']
+    list_display=['nummer','name','dokumententyp','gueltigkeit_von','gueltigkeit_bis','aktiv']
+    search_fields=['nummer','name']
+    list_filter=['dokumententyp','aktiv','gueltigkeit_von']
+    
+    fieldsets = (
+        ('Grunddaten', {
+            'fields': ('nummer', 'name', 'dokumententyp', 'aktiv'),
+            'classes': ('wide',),
+        }),
+        ('Verantwortlichkeiten', {
+            'fields': ('autoren', 'pruefende'),
+            'classes': ('wide', 'collapse'),
+        }),
+        ('Gültigkeit & Metadaten', {
+            'fields': ('gueltigkeit_von', 'gueltigkeit_bis', 'signatur_cso', 'anhaenge'),
+            'classes': ('wide', 'collapse'),
+        }),
+    )
+    
+    class Media:
+        js = ('admin/js/vorgabe_collapse.js',)
+        css = {
+            'all': ('admin/css/vorgabe_border.css',)
+        }
+
+
+#admin.site.register(Stichwort)
+
+@admin.register(VorgabenTable)
+class VorgabenTableAdmin(admin.ModelAdmin):
+    list_display = ['order', 'nummer', 'dokument', 'thema', 'titel', 'gueltigkeit_von', 'gueltigkeit_bis']
+    list_display_links = ['dokument']
+    list_editable = ['order', 'nummer', 'thema', 'titel', 'gueltigkeit_von', 'gueltigkeit_bis']
+    list_filter = ['dokument', 'thema', 'gueltigkeit_von', 'gueltigkeit_bis']
+    search_fields = ['nummer', 'titel', 'dokument__nummer', 'dokument__name']
+    autocomplete_fields = ['dokument', 'thema', 'stichworte', 'referenzen', 'relevanz']
+    ordering = ['order']
+    list_per_page = 100
+
+    fieldsets = (
+        ('Grunddaten', {
+            'fields': ('order', 'nummer', 'dokument', 'thema', 'titel')
+        }),
+        ('Gültigkeit', {
+            'fields': ('gueltigkeit_von', 'gueltigkeit_bis')
+        }),
+        ('Verknüpfungen', {
+            'fields': ('referenzen', 'stichworte', 'relevanz'),
+            'classes': ('collapse',)
+        }),
+    )
+
+@admin.register(Thema)
+class ThemaAdmin(admin.ModelAdmin):
+    search_fields = ['name']
+    ordering = ['name']
+
+@admin.register(Vorgabe)
+class VorgabeAdmin(NestedModelAdmin):
+    form = VorgabeForm
+    list_display = ['vorgabe_nummer', 'titel', 'dokument', 'thema', 'gueltigkeit_von', 'gueltigkeit_bis']
+    list_filter = ['dokument', 'thema', 'gueltigkeit_von', 'gueltigkeit_bis']
+    search_fields = ['nummer', 'titel', 'dokument__nummer', 'dokument__name']
+    autocomplete_fields = ['stichworte', 'referenzen', 'relevanz']
+    ordering = ['dokument', 'order']
+    
+    inlines = [
+        VorgabeKurztextInline, 
+        VorgabeLangtextInline, 
+        ChecklistenfragenInline
+    ]
+    
+    fieldsets = (
+        ('Grunddaten', {
+            'fields': (('order', 'nummer'), ('dokument', 'thema'), 'titel'),
+            'classes': ('wide',),
+        }),
+        ('Gültigkeit', {
+            'fields': (('gueltigkeit_von', 'gueltigkeit_bis'),),
+            'classes': ('wide',),
+        }),
+        ('Verknüpfungen', {
+            'fields': (('referenzen', 'stichworte', 'relevanz'),),
+            'classes': ('wide',),
+        }),
+    )
+    
+    def vorgabe_nummer(self, obj):
+        return obj.Vorgabennummer()
+    vorgabe_nummer.short_description = 'Vorgabennummer'
+
+admin.site.register(Checklistenfrage)
+admin.site.register(Dokumententyp)
+admin.site.register(VorgabeComment)
+
+#admin.site.register(Changelog)

dokumente/apps.py

@@ -3,4 +3,4 @@ from django.apps import AppConfig
 
 class standardsConfig(AppConfig):
     default_auto_field = 'django.db.models.BigAutoField'
-    name = 'standards'
+    name = 'dokumente'

dokumente/management/commands/export_json.py

@@ -0,0 +1,174 @@
+from django.core.management.base import BaseCommand
+from django.core.serializers.json import DjangoJSONEncoder
+import json
+from datetime import datetime
+from dokumente.models import Dokument, Vorgabe, VorgabeKurztext, VorgabeLangtext, Checklistenfrage
+
+
+class Command(BaseCommand):
+    help = 'Export all dokumente as JSON using R0066.json format as reference'
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            '--output',
+            type=str,
+            help='Output file path (default: stdout)',
+        )
+
+    def handle(self, *args, **options):
+        # Get all active documents
+        dokumente = Dokument.objects.filter(aktiv=True).prefetch_related(
+            'autoren', 'pruefende', 'vorgaben__thema', 
+            'vorgaben__referenzen', 'vorgaben__stichworte',
+            'vorgaben__checklistenfragen', 'vorgaben__vorgabekurztext_set',
+            'vorgaben__vorgabelangtext_set', 'geltungsbereich_set',
+            'einleitung_set', 'changelog__autoren'
+        ).order_by('nummer')
+
+        result = {
+            "Vorgabendokument": {
+                "Typ": "Standard IT-Sicherheit",
+                "Nummer": "",  # Will be set per document
+                "Name": "",  # Will be set per document  
+                "Autoren": [],  # Will be set per document
+                "Pruefende": [],  # Will be set per document
+                "Geltungsbereich": {
+                    "Abschnitt": []
+                },
+                "Ziel": "",
+                "Grundlagen": "",
+                "Changelog": [],
+                "Anhänge": [],
+                "Verantwortlich": "Information Security Management BIT",
+                "Klassifizierung": None,
+                "Glossar": {},
+                "Vorgaben": []
+            }
+        }
+
+        output_data = []
+
+        for dokument in dokumente:
+            # Build document structure
+            doc_data = {
+                "Typ": dokument.dokumententyp.name if dokument.dokumententyp else "",
+                "Nummer": dokument.nummer,
+                "Name": dokument.name,
+                "Autoren": [autor.name for autor in dokument.autoren.all()],
+                "Pruefende": [pruefender.name for pruefender in dokument.pruefende.all()],
+                "Gueltigkeit": {
+                    "Von": dokument.gueltigkeit_von.strftime("%Y-%m-%d") if dokument.gueltigkeit_von else "",
+                    "Bis": dokument.gueltigkeit_bis.strftime("%Y-%m-%d") if dokument.gueltigkeit_bis else None
+                },
+                "SignaturCSO": dokument.signatur_cso,
+                "Geltungsbereich": {},
+                "Einleitung": {},
+                "Ziel": "",
+                "Grundlagen": "",
+                "Changelog": [],
+                "Anhänge": dokument.anhaenge,
+                "Verantwortlich": "Information Security Management BIT",
+                "Klassifizierung": None,
+                "Glossar": {},
+                "Vorgaben": []
+            }
+
+            # Process Geltungsbereich sections
+            geltungsbereich_sections = []
+            for gb in dokument.geltungsbereich_set.all().order_by('order'):
+                geltungsbereich_sections.append({
+                    "typ": gb.abschnitttyp.abschnitttyp if gb.abschnitttyp else "text",
+                    "inhalt": gb.inhalt
+                })
+            
+            if geltungsbereich_sections:
+                doc_data["Geltungsbereich"] = {
+                    "Abschnitt": geltungsbereich_sections
+                }
+
+            # Process Einleitung sections
+            einleitung_sections = []
+            for ei in dokument.einleitung_set.all().order_by('order'):
+                einleitung_sections.append({
+                    "typ": ei.abschnitttyp.abschnitttyp if ei.abschnitttyp else "text",
+                    "inhalt": ei.inhalt
+                })
+            
+            if einleitung_sections:
+                doc_data["Einleitung"] = {
+                    "Abschnitt": einleitung_sections
+                }
+
+            # Process Changelog entries
+            changelog_entries = []
+            for cl in dokument.changelog.all().order_by('-datum'):
+                changelog_entries.append({
+                    "Datum": cl.datum.strftime("%Y-%m-%d"),
+                    "Autoren": [autor.name for autor in cl.autoren.all()],
+                    "Aenderung": cl.aenderung
+                })
+            
+            doc_data["Changelog"] = changelog_entries
+
+            # Process Vorgaben for this document
+            vorgaben = dokument.vorgaben.all().order_by('order')
+            
+            for vorgabe in vorgaben:
+                # Get Kurztext and Langtext
+                kurztext_sections = []
+                for kt in vorgabe.vorgabekurztext_set.all().order_by('order'):
+                    kurztext_sections.append({
+                        "typ": kt.abschnitttyp.abschnitttyp if kt.abschnitttyp else "text",
+                        "inhalt": kt.inhalt
+                    })
+                
+                langtext_sections = []
+                for lt in vorgabe.vorgabelangtext_set.all().order_by('order'):
+                    langtext_sections.append({
+                        "typ": lt.abschnitttyp.abschnitttyp if lt.abschnitttyp else "text", 
+                        "inhalt": lt.inhalt
+                    })
+
+                # Build text structures following Langtext pattern
+                kurztext = {
+                    "Abschnitt": kurztext_sections if kurztext_sections else []
+                } if kurztext_sections else {}
+                langtext = {
+                    "Abschnitt": langtext_sections if langtext_sections else []
+                } if langtext_sections else {}
+
+                # Get references and keywords
+                referenzen = [f"{ref.name_nummer}: {ref.name_text}" if ref.name_text else ref.name_nummer for ref in vorgabe.referenzen.all()]
+                stichworte = [stw.stichwort for stw in vorgabe.stichworte.all()]
+                
+                # Get checklist questions
+                checklistenfragen = [cf.frage for cf in vorgabe.checklistenfragen.all()]
+
+                vorgabe_data = {
+                    "Nummer": str(vorgabe.nummer),
+                    "Titel": vorgabe.titel,
+                    "Thema": vorgabe.thema.name if vorgabe.thema else "",
+                    "Kurztext": kurztext,
+                    "Langtext": langtext,
+                    "Referenz": referenzen,
+                    "Gueltigkeit": {
+                        "Von": vorgabe.gueltigkeit_von.strftime("%Y-%m-%d") if vorgabe.gueltigkeit_von else "",
+                        "Bis": vorgabe.gueltigkeit_bis.strftime("%Y-%m-%d") if vorgabe.gueltigkeit_bis else None
+                    },
+                    "Checklistenfragen": checklistenfragen,
+                    "Stichworte": stichworte
+                }
+                
+                doc_data["Vorgaben"].append(vorgabe_data)
+
+            output_data.append(doc_data)
+
+        # Output the data
+        json_output = json.dumps(output_data, cls=DjangoJSONEncoder, indent=2, ensure_ascii=False)
+        
+        if options['output']:
+            with open(options['output'], 'w', encoding='utf-8') as f:
+                f.write(json_output)
+            self.stdout.write(self.style.SUCCESS(f'JSON exported to {options["output"]}'))
+        else:
+            self.stdout.write(json_output)

dokumente/management/commands/import-document.py

@@ -1,11 +1,11 @@
-# Standards/management/commands/import_standard.py
+# Document/management/commands/import_standard.py
 import re
 from pathlib import Path
 from django.core.management.base import BaseCommand, CommandError
 from django.utils import timezone
 
-from standards.models import (
-    Standard,
+from dokumente.models import (
+    Dokument,
     Dokumententyp,
     Thema,
     Vorgabe,
@@ -21,15 +21,15 @@ from stichworte.models import Stichwort
 
 class Command(BaseCommand):
     help = (
-        "Import a security standard from a structured text file.\n"
+        "Import a policy document from a structured text file.\n"
         "Supports Einleitung, Geltungsbereich, Vorgaben (Kurztext/Langtext with AbschnittTyp), "
         "Stichworte (comma-separated), Checklistenfragen, dry-run, verbose, and purge."
     )
 
     def add_arguments(self, parser):
         parser.add_argument("file_path", type=str, help="Path to the plaintext file")
-        parser.add_argument("--nummer", required=True, help="Standard number (e.g., STD-001)")
-        parser.add_argument("--name", required=True, help='Standard name (e.g., "IT-Sicherheit Container")')
+        parser.add_argument("--nummer", required=True, help="Document number (e.g., STD-001)")
+        parser.add_argument("--name", required=True, help='Document name (e.g., "IT-Sicherheit Container")')
         parser.add_argument("--dokumententyp", required=True, help='Dokumententyp name (e.g., "IT-Sicherheit")')
         parser.add_argument("--gueltigkeit_von", default=None, help="Start date (YYYY-MM-DD)")
         parser.add_argument("--gueltigkeit_bis", default=None, help="End date (YYYY-MM-DD)")
@@ -63,8 +63,8 @@ class Command(BaseCommand):
         if dry_run:
             self.stdout.write(self.style.WARNING("Dry run: no database changes will be made."))
 
-        # get or create Standard (we want a real instance even in purge to count existing rows)
-        standard, created = Standard.objects.get_or_create(
+        # get or create Document (we want a real instance even in purge to count existing rows)
+        standard, created = Dokument.objects.get_or_create(
             nummer=nummer,
             defaults={
                 "dokumententyp": dokumententyp,
@@ -74,9 +74,9 @@ class Command(BaseCommand):
             },
         )
         if created:
-            self.stdout.write(self.style.SUCCESS(f"Created Standard {nummer} – {name}"))
+            self.stdout.write(self.style.SUCCESS(f"Created Document {nummer} – {name}"))
         else:
-            self.stdout.write(self.style.WARNING(f"Standard {nummer} already exists; content may be updated."))
+            self.stdout.write(self.style.WARNING(f"Document {nummer} already exists; content may be updated."))
 
         # purge (Einleitung + Geltungsbereich + Vorgaben cascade)
         if purge:
@@ -347,6 +347,6 @@ class Command(BaseCommand):
                     )
 
         self.stdout.write(self.style.SUCCESS(
-            "Dry run complete" if dry_run else f"Imported standard {nummer} – {name} with {len(vorgaben_data)} Vorgaben"
+            "Dry run complete" if dry_run else f"Imported document {nummer} – {name} with {len(vorgaben_data)} Vorgaben"
         ))
 

dokumente/management/commands/sanity_check_vorgaben.py

@@ -0,0 +1,70 @@
+from django.core.management.base import BaseCommand
+from django.db import transaction
+from dokumente.models import Vorgabe
+import datetime
+
+
+class Command(BaseCommand):
+    help = 'Run sanity checks on Vorgaben to detect conflicts'
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            '--fix',
+            action='store_true',
+            help='Attempt to fix conflicts (not implemented yet)',
+        )
+        parser.add_argument(
+            '--verbose',
+            action='store_true',
+            help='Show detailed output',
+        )
+
+    def handle(self, *args, **options):
+        self.verbose = options['verbose']
+        
+        self.stdout.write(self.style.SUCCESS('Starting Vorgaben sanity check...'))
+        
+        # Run the sanity check
+        conflicts = Vorgabe.sanity_check_vorgaben()
+        
+        if not conflicts:
+            self.stdout.write(self.style.SUCCESS('✓ No conflicts found in Vorgaben'))
+            return
+        
+        self.stdout.write(
+            self.style.WARNING(f'Found {len(conflicts)} conflicts:')
+        )
+        
+        for i, conflict in enumerate(conflicts, 1):
+            self._display_conflict(i, conflict)
+        
+        if options['fix']:
+            self.stdout.write(self.style.ERROR('Auto-fix not implemented yet'))
+
+    def _display_conflict(self, index, conflict):
+        """Display a single conflict"""
+        v1 = conflict['vorgabe1']
+        v2 = conflict['vorgabe2']
+        
+        self.stdout.write(f"\n{index}. {conflict['message']}")
+        
+        if self.verbose:
+            self.stdout.write(f"   Vorgabe 1: {v1.Vorgabennummer()}")
+            self.stdout.write(f"   Valid from: {v1.gueltigkeit_von} to {v1.gueltigkeit_bis or 'unlimited'}")
+            self.stdout.write(f"   Title: {v1.titel}")
+            
+            self.stdout.write(f"   Vorgabe 2: {v2.Vorgabennummer()}")
+            self.stdout.write(f"   Valid from: {v2.gueltigkeit_von} to {v2.gueltigkeit_bis or 'unlimited'}")
+            self.stdout.write(f"   Title: {v2.titel}")
+        
+        # Show the overlapping period
+        overlap_start = max(v1.gueltigkeit_von, v2.gueltigkeit_von)
+        overlap_end = min(
+            v1.gueltigkeit_bis or datetime.date.max,
+            v2.gueltigkeit_bis or datetime.date.max
+        )
+        
+        if overlap_end != datetime.date.max:
+            self.stdout.write(f"   Overlap: {overlap_start} to {overlap_end}")
+        else:
+            self.stdout.write(f"   Overlap starts: {overlap_start} (no end)")

dokumente/migrations/0001_initial.py

@@ -53,7 +53,7 @@ class Migration(migrations.Migration):
                 ('rght', models.PositiveIntegerField(editable=False)),
                 ('tree_id', models.PositiveIntegerField(db_index=True, editable=False)),
                 ('level', models.PositiveIntegerField(editable=False)),
-                ('oberreferenz', mptt.fields.TreeForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='unterreferenzen', to='standards.referenz')),
+                ('oberreferenz', mptt.fields.TreeForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='unterreferenzen', to='dokumente.referenz')),
             ],
             options={
                 'verbose_name_plural': 'Referenzen',
@@ -65,7 +65,7 @@ class Migration(migrations.Migration):
                 ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                 ('inhalt', models.TextField(blank=True, null=True)),
                 ('abschnitttyp', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, to='abschnitte.abschnitttyp')),
-                ('erklaerung', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='standards.referenz')),
+                ('erklaerung', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='dokumente.referenz')),
             ],
             options={
                 'verbose_name': 'Erklärung',
@@ -80,9 +80,9 @@ class Migration(migrations.Migration):
                 ('gueltigkeit_bis', models.DateField(blank=True, null=True)),
                 ('signatur_cso', models.CharField(blank=True, max_length=255)),
                 ('anhaenge', models.TextField(blank=True)),
-                ('autoren', models.ManyToManyField(related_name='verfasste_dokumente', to='standards.person')),
-                ('dokumententyp', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, to='standards.dokumententyp')),
-                ('pruefende', models.ManyToManyField(related_name='gepruefte_dokumente', to='standards.person')),
+                ('autoren', models.ManyToManyField(related_name='verfasste_dokumente', to='dokumente.person')),
+                ('dokumententyp', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, to='dokumente.dokumententyp')),
+                ('pruefende', models.ManyToManyField(related_name='gepruefte_dokumente', to='dokumente.person')),
             ],
             options={
                 'verbose_name': 'Standard',
@@ -95,7 +95,7 @@ class Migration(migrations.Migration):
                 ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                 ('inhalt', models.TextField(blank=True, null=True)),
                 ('abschnitttyp', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, to='abschnitte.abschnitttyp')),
-                ('geltungsbereich', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='standards.standard')),
+                ('geltungsbereich', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='dokumente.standard')),
             ],
             options={
                 'verbose_name': 'Geltungsbereichs-Abschnitt',
@@ -108,8 +108,8 @@ class Migration(migrations.Migration):
                 ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                 ('datum', models.DateField()),
                 ('aenderung', models.TextField()),
-                ('autoren', models.ManyToManyField(to='standards.person')),
-                ('dokument', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='changelog', to='standards.standard')),
+                ('autoren', models.ManyToManyField(to='dokumente.person')),
+                ('dokument', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='changelog', to='dokumente.standard')),
             ],
         ),
         migrations.CreateModel(
@@ -120,10 +120,10 @@ class Migration(migrations.Migration):
                 ('titel', models.CharField(max_length=255)),
                 ('gueltigkeit_von', models.DateField()),
                 ('gueltigkeit_bis', models.DateField(blank=True, null=True)),
-                ('dokument', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='vorgaben', to='standards.standard')),
-                ('referenzen', models.ManyToManyField(blank=True, to='standards.referenz')),
+                ('dokument', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='vorgaben', to='dokumente.standard')),
+                ('referenzen', models.ManyToManyField(blank=True, to='dokumente.referenz')),
                 ('stichworte', models.ManyToManyField(blank=True, to='stichworte.stichwort')),
-                ('thema', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, to='standards.thema')),
+                ('thema', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, to='dokumente.thema')),
             ],
             options={
                 'verbose_name_plural': 'Vorgaben',
@@ -134,7 +134,7 @@ class Migration(migrations.Migration):
             fields=[
                 ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                 ('frage', models.CharField(max_length=255)),
-                ('vorgabe', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='checklistenfragen', to='standards.vorgabe')),
+                ('vorgabe', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='checklistenfragen', to='dokumente.vorgabe')),
             ],
             options={
                 'verbose_name_plural': 'Fragen für Checkliste',
@@ -145,7 +145,7 @@ class Migration(migrations.Migration):
             fields=[
                 ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                 ('inhalt', models.TextField(blank=True, null=True)),
-                ('abschnitt', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='standards.vorgabe')),
+                ('abschnitt', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='dokumente.vorgabe')),
                 ('abschnitttyp', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, to='abschnitte.abschnitttyp')),
             ],
             options={
@@ -158,7 +158,7 @@ class Migration(migrations.Migration):
             fields=[
                 ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                 ('inhalt', models.TextField(blank=True, null=True)),
-                ('abschnitt', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='standards.vorgabe')),
+                ('abschnitt', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='dokumente.vorgabe')),
                 ('abschnitttyp', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, to='abschnitte.abschnitttyp')),
             ],
             options={

dokumente/migrations/0002_einleitung.py

@@ -8,7 +8,7 @@ class Migration(migrations.Migration):
 
     dependencies = [
         ('abschnitte', '0001_initial'),
-        ('standards', '0001_initial'),
+        ('dokumente', '0001_initial'),
     ]
 
     operations = [
@@ -18,7 +18,7 @@ class Migration(migrations.Migration):
                 ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                 ('inhalt', models.TextField(blank=True, null=True)),
                 ('abschnitttyp', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, to='abschnitte.abschnitttyp')),
-                ('einleitung', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='standards.standard')),
+                ('einleitung', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='dokumente.standard')),
             ],
             options={
                 'verbose_name': 'Einleitungs-Abschnitt',

dokumente/migrations/0003_einleitung_order_geltungsbereich_order_and_more.py

@@ -6,7 +6,7 @@ from django.db import migrations, models
 class Migration(migrations.Migration):
 
     dependencies = [
-        ('standards', '0002_einleitung'),
+        ('dokumente', '0002_einleitung'),
     ]
 
     operations = [

dokumente/migrations/0004_remove_referenzerklaerung_erklaerung_and_more.py

@@ -7,7 +7,7 @@ class Migration(migrations.Migration):
 
     dependencies = [
         ('referenzen', '0001_initial'),
-        ('standards', '0003_einleitung_order_geltungsbereich_order_and_more'),
+        ('dokumente', '0003_einleitung_order_geltungsbereich_order_and_more'),
     ]
 
     operations = [

dokumente/migrations/0005_vorgabe_relevanz.py

@@ -7,7 +7,7 @@ class Migration(migrations.Migration):
 
     dependencies = [
         ('rollen', '0001_initial'),
-        ('standards', '0004_remove_referenzerklaerung_erklaerung_and_more'),
+        ('dokumente', '0004_remove_referenzerklaerung_erklaerung_and_more'),
     ]
 
     operations = [

dokumente/migrations/0006_rename_standard_dokument_alter_dokument_options.py

@@ -0,0 +1,21 @@
+# Generated by Django 5.2.5 on 2025-10-02 12:13
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('dokumente', '0005_vorgabe_relevanz'),
+    ]
+
+    operations = [
+        migrations.RenameModel(
+            old_name='Standard',
+            new_name='Dokument',
+        ),
+        migrations.AlterModelOptions(
+            name='dokument',
+            options={'verbose_name': 'Dokument', 'verbose_name_plural': 'Dokumente'},
+        ),
+    ]

dokumente/migrations/0007_alter_changelog_options_and_more.py

@@ -0,0 +1,29 @@
+# Generated by Django 5.2.5 on 2025-10-06 11:29
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('dokumente', '0006_rename_standard_dokument_alter_dokument_options'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='changelog',
+            options={'verbose_name': 'Changelog-Eintrag', 'verbose_name_plural': 'Changelog'},
+        ),
+        migrations.AlterModelOptions(
+            name='checklistenfrage',
+            options={'verbose_name': 'Frage für Checkliste', 'verbose_name_plural': 'Fragen für Checkliste'},
+        ),
+        migrations.AlterModelOptions(
+            name='dokumententyp',
+            options={'verbose_name': 'Dokumententyp', 'verbose_name_plural': 'Dokumententypen'},
+        ),
+        migrations.AlterModelOptions(
+            name='vorgabelangtext',
+            options={'verbose_name': 'Langtext-Abschnitt', 'verbose_name_plural': 'Langtext'},
+        ),
+    ]

dokumente/migrations/0008_dokument_aktiv.py

@@ -0,0 +1,19 @@
+# Generated by Django 5.2.5 on 2025-10-27 19:48
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('dokumente', '0007_alter_changelog_options_and_more'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='dokument',
+            name='aktiv',
+            field=models.BooleanField(blank=True, default=False),
+            preserve_default=False,
+        ),
+    ]

dokumente/migrations/0009_alter_vorgabe_options_vorgabe_order.py

@@ -0,0 +1,23 @@
+# Generated by Django 5.2.5 on 2025-10-28 14:51
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('dokumente', '0008_dokument_aktiv'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='vorgabe',
+            options={'ordering': ['order'], 'verbose_name_plural': 'Vorgaben'},
+        ),
+        migrations.AddField(
+            model_name='vorgabe',
+            name='order',
+            field=models.IntegerField(default=0),
+            preserve_default=False,
+        ),
+    ]

dokumente/migrations/0010_vorgabentable_alter_person_options_vorgabecomment.py

@@ -0,0 +1,49 @@
+# Generated by Django 5.2.5 on 2025-11-27 22:02
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('dokumente', '0009_alter_vorgabe_options_vorgabe_order'),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='VorgabenTable',
+            fields=[
+            ],
+            options={
+                'verbose_name': 'Vorgabe (Tabellenansicht)',
+                'verbose_name_plural': 'Vorgaben (Tabellenansicht)',
+                'proxy': True,
+                'indexes': [],
+                'constraints': [],
+            },
+            bases=('dokumente.vorgabe',),
+        ),
+        migrations.AlterModelOptions(
+            name='person',
+            options={'ordering': ['name'], 'verbose_name_plural': 'Personen'},
+        ),
+        migrations.CreateModel(
+            name='VorgabeComment',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('text', models.TextField()),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL)),
+                ('vorgabe', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='comments', to='dokumente.vorgabe')),
+            ],
+            options={
+                'verbose_name': 'Vorgabe-Kommentar',
+                'verbose_name_plural': 'Vorgabe-Kommentare',
+                'ordering': ['-created_at'],
+            },
+        ),
+    ]

dokumente/models.py

@@ -0,0 +1,308 @@
+from django.db import models
+from mptt.models import MPTTModel, TreeForeignKey
+from django.contrib.auth.models import User
+from abschnitte.models import Textabschnitt
+from stichworte.models import Stichwort
+from referenzen.models import Referenz
+from rollen.models import Rolle
+import datetime
+
+class Dokumententyp(models.Model):
+    name = models.CharField(max_length=100, primary_key=True)
+    verantwortliche_ve = models.CharField(max_length=255)
+
+    def __str__(self):
+        return self.name
+
+    class Meta:
+        verbose_name="Dokumententyp"
+        verbose_name_plural="Dokumententypen"
+
+
+class Person(models.Model):
+    name = models.CharField(max_length=100, primary_key=True)
+    funktion = models.CharField(max_length=255)
+
+    def __str__(self):
+        return self.name
+    class Meta:
+        verbose_name_plural="Personen"
+        ordering = ['name']
+
+class Thema(models.Model):
+    name = models.CharField(max_length=100, primary_key=True)
+    erklaerung = models.TextField(blank=True)
+
+    def __str__(self):
+        return self.name
+    class Meta:
+        verbose_name_plural="Themen"
+
+
+class Dokument(models.Model):
+    nummer = models.CharField(max_length=50, primary_key=True)
+    dokumententyp = models.ForeignKey(Dokumententyp, on_delete=models.PROTECT)
+    name = models.CharField(max_length=255)
+    autoren = models.ManyToManyField(Person, related_name='verfasste_dokumente')
+    pruefende = models.ManyToManyField(Person, related_name='gepruefte_dokumente')
+    gueltigkeit_von = models.DateField(null=True, blank=True)
+    gueltigkeit_bis = models.DateField(null=True, blank=True)
+    signatur_cso = models.CharField(max_length=255, blank=True)
+    anhaenge = models.TextField(blank=True)
+    aktiv = models.BooleanField(blank=True)
+
+    def __str__(self):
+        return f"{self.nummer} – {self.name}"
+
+    @property
+    def dates(self):
+        """
+        Returns an array of unique, chronologically sorted dates representing
+        state-change dates from all Vorgaben in this document.
+        
+        These are dates where Vorgaben become active (gueltigkeit_von) or change state
+        (the day after gueltigkeit_bis). The very last date in the list is excluded
+        as it has no relevance (nothing changes after it).
+        """
+        dates_set = set()
+        
+        # Get all vorgaben for this document
+        for vorgabe in self.vorgaben.all():
+            # Add gueltigkeit_von (when vorgabe becomes active)
+            if vorgabe.gueltigkeit_von:
+                dates_set.add(vorgabe.gueltigkeit_von)
+            
+            # Add the day after gueltigkeit_bis (when vorgabe expires/changes state)
+            # Only if gueltigkeit_bis is defined (not None)
+            if vorgabe.gueltigkeit_bis:
+                dates_set.add(vorgabe.gueltigkeit_bis + datetime.timedelta(days=1))
+        
+        # Return sorted unique dates from oldest to newest, excluding the last date
+        # (but only if there are multiple dates; single dates are kept)
+        sorted_dates = sorted(list(dates_set))
+        return sorted_dates[:-1] if len(sorted_dates) > 1 else sorted_dates
+
+    class Meta:
+        verbose_name_plural="Dokumente"
+        verbose_name="Dokument"
+
+class Vorgabe(models.Model):
+    order = models.IntegerField()
+    nummer = models.IntegerField()
+    dokument = models.ForeignKey(Dokument, on_delete=models.CASCADE, related_name='vorgaben')
+    thema = models.ForeignKey(Thema, on_delete=models.PROTECT, blank=False)
+    titel = models.CharField(max_length=255)
+    referenzen = models.ManyToManyField(Referenz, blank=True)
+    gueltigkeit_von = models.DateField()
+    gueltigkeit_bis = models.DateField(blank=True,null=True)
+    stichworte = models.ManyToManyField(Stichwort, blank=True)
+    relevanz = models.ManyToManyField(Rolle,blank=True)
+
+    def Vorgabennummer(self):
+        return str(self.dokument.nummer)+"."+self.thema.name[0]+"."+str(self.nummer)
+
+    def get_status(self, check_date: datetime.date = datetime.date.today(), verbose: bool = False) -> str:
+        if self.gueltigkeit_von > check_date:
+            return "future" if not verbose else "Ist erst ab dem "+self.gueltigkeit_von.strftime('%d.%m.%Y')+" in Kraft."
+
+        if not self.gueltigkeit_bis:
+            return "active"
+
+        if self.gueltigkeit_bis >= check_date:
+            return "active"
+
+        return "expired" if not verbose else "Ist seit dem "+self.gueltigkeit_bis.strftime('%d.%m.%Y')+" nicht mehr in Kraft."
+
+    def __str__(self):
+        return f"{self.Vorgabennummer()}: {self.titel}"
+
+    @staticmethod
+    def sanity_check_vorgaben():
+        """
+        Sanity check for Vorgaben:
+        If there are two Vorgaben with the same number, Thema and Dokument,
+        their valid_from and valid_to date ranges shouldn't intersect.
+        
+        Returns:
+            list: List of dictionaries containing conflicts found
+        """
+        conflicts = []
+        
+        # Group Vorgaben by dokument, thema, and nummer
+        from django.db.models import Count
+        from itertools import combinations
+        
+        # Find Vorgaben with same dokument, thema, and nummer
+        duplicate_groups = (
+            Vorgabe.objects.values('dokument', 'thema', 'nummer')
+            .annotate(count=Count('id'))
+            .filter(count__gt=1)
+        )
+        
+        for group in duplicate_groups:
+            # Get all Vorgaben in this group
+            vorgaben = Vorgabe.objects.filter(
+                dokument=group['dokument'],
+                thema=group['thema'], 
+                nummer=group['nummer']
+            )
+            
+            # Check all pairs for date range intersections
+            for vorgabe1, vorgabe2 in combinations(vorgaben, 2):
+                if Vorgabe._date_ranges_intersect(
+                    vorgabe1.gueltigkeit_von, vorgabe1.gueltigkeit_bis,
+                    vorgabe2.gueltigkeit_von, vorgabe2.gueltigkeit_bis
+                ):
+                    conflicts.append({
+                        'vorgabe1': vorgabe1,
+                        'vorgabe2': vorgabe2,
+                        'conflict_type': 'date_range_intersection',
+                        'message': f"Vorgaben {vorgabe1.Vorgabennummer()} and {vorgabe2.Vorgabennummer()} "
+                                  f"überschneiden sich in der Geltungsdauer"
+                    })
+        
+        return conflicts
+
+    def clean(self):
+        """
+        Validate the Vorgabe before saving.
+        """
+        from django.core.exceptions import ValidationError
+
+        # Check for conflicts with existing Vorgaben
+        conflicts = self.find_conflicts()
+        if conflicts:
+            conflict_messages = [c['message'] for c in conflicts]
+            raise ValidationError({
+                '__all__': conflict_messages
+            })
+    
+    def find_conflicts(self):
+        """
+        Find conflicts with existing Vorgaben.
+        
+        Returns:
+            list: List of conflict dictionaries
+        """
+        conflicts = []
+        
+        # Find Vorgaben with same dokument, thema, and nummer (excluding self)
+        existing_vorgaben = Vorgabe.objects.filter(
+            dokument=self.dokument,
+            thema=self.thema,
+            nummer=self.nummer
+        ).exclude(pk=self.pk)
+        
+        for other_vorgabe in existing_vorgaben:
+            if self._date_ranges_intersect(
+                self.gueltigkeit_von, self.gueltigkeit_bis,
+                other_vorgabe.gueltigkeit_von, other_vorgabe.gueltigkeit_bis
+            ):
+                conflicts.append({
+                    'vorgabe1': self,
+                    'vorgabe2': other_vorgabe,
+                    'conflict_type': 'date_range_intersection',
+                    'message': f"Vorgabe {self.Vorgabennummer()} in Konflikt mit "
+                              f"bestehender {other_vorgabe.Vorgabennummer()} "
+                              f" - Geltungsdauer übeschneidet sich"
+                })
+        
+        return conflicts
+
+    @staticmethod
+    def _date_ranges_intersect(start1, end1, start2, end2):
+        """
+        Check if two date ranges intersect.
+        None end date means open-ended range.
+        
+        Args:
+            start1, start2: Start dates
+            end1, end2: End dates (can be None for open-ended)
+            
+        Returns:
+            bool: True if ranges intersect
+        """
+        # If either start date is None, treat it as invalid case
+        if not start1 or not start2:
+            return False
+            
+        # If end date is None, treat it as far future
+        end1 = end1 or datetime.date.max
+        end2 = end2 or datetime.date.max
+        
+        # Ranges intersect if start1 <= end2 and start2 <= end1
+        return start1 <= end2 and start2 <= end1
+
+    class Meta:
+        verbose_name_plural="Vorgaben"
+        ordering = ['order']
+
+class VorgabeLangtext(Textabschnitt):
+    abschnitt=models.ForeignKey(Vorgabe,on_delete=models.CASCADE)
+    class Meta:
+        verbose_name_plural="Langtext"
+        verbose_name="Langtext-Abschnitt"
+
+class VorgabeKurztext(Textabschnitt):
+    abschnitt=models.ForeignKey(Vorgabe,on_delete=models.CASCADE)
+    class Meta:
+        verbose_name_plural="Kurztext"
+        verbose_name="Kurztext-Abschnitt"
+
+class Geltungsbereich(Textabschnitt):
+    geltungsbereich=models.ForeignKey(Dokument,on_delete=models.CASCADE)
+    class Meta:
+        verbose_name_plural="Geltungsbereich"
+        verbose_name="Geltungsbereichs-Abschnitt"
+
+class Einleitung(Textabschnitt):
+    einleitung=models.ForeignKey(Dokument,on_delete=models.CASCADE)
+    class Meta:
+        verbose_name_plural="Einleitung"
+        verbose_name="Einleitungs-Abschnitt"
+
+class Checklistenfrage(models.Model):
+    vorgabe=models.ForeignKey(Vorgabe, on_delete=models.CASCADE, related_name="checklistenfragen")
+    frage = models.CharField(max_length=255)
+
+    def __str__(self):
+        return self.frage
+
+    class Meta:
+        verbose_name_plural="Fragen für Checkliste"
+        verbose_name="Frage für Checkliste"
+
+class VorgabenTable(Vorgabe):
+    class Meta:
+        proxy = True
+        verbose_name = "Vorgabe (Tabellenansicht)"
+        verbose_name_plural = "Vorgaben (Tabellenansicht)"
+
+class Changelog(models.Model):
+    dokument = models.ForeignKey(Dokument, on_delete=models.CASCADE, related_name='changelog')
+    autoren = models.ManyToManyField(Person)
+    datum = models.DateField()
+    aenderung = models.TextField()
+
+    def __str__(self):
+        return f"{self.datum} – {self.dokument.nummer}"
+
+    class Meta:
+        verbose_name_plural="Changelog"
+        verbose_name="Changelog-Eintrag"
+
+
+class VorgabeComment(models.Model):
+    vorgabe = models.ForeignKey(Vorgabe, on_delete=models.CASCADE, related_name='comments')
+    user = models.ForeignKey(User, on_delete=models.CASCADE)
+    text = models.TextField()
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        verbose_name = "Vorgabe-Kommentar"
+        verbose_name_plural = "Vorgabe-Kommentare"
+        ordering = ['-created_at']
+
+    def __str__(self):
+        return f"Kommentar von {self.user.username} zu {self.vorgabe.Vorgabennummer()}"

dokumente/templates/standards/all_comments.html

@@ -0,0 +1,67 @@
+{% extends "base.html" %}
+
+{% block content %}
+<h1>Alle Kommentare</h1>
+
+{% if total_comments == 0 %}
+  <div class="alert alert-info">
+    <p>Es gibt noch keine Kommentare zu Vorgaben.</p>
+    <p><a href="{% url 'standard_list' %}">Zu den Standards</a></p>
+  </div>
+{% else %}
+  <p class="text-muted">Insgesamt {{ total_comments }} Kommentar{{ total_comments|pluralize:"e" }}</p>
+
+  {% for dokument, comments in comments_by_document.items %}
+  <div class="panel panel-default" style="margin-top: 2rem;">
+    <div class="panel-heading">
+      <h2 style="margin: 0;">
+        <a href="{% url 'standard_detail' nummer=dokument.nummer %}">
+          {{ dokument.nummer }} – {{ dokument.name }}
+        </a>
+      </h2>
+      <p style="margin: 0; color: #666; font-size: 0.9rem;">
+        {{ comments|length }} Kommentar{{ comments|length|pluralize:"e" }}
+      </p>
+    </div>
+    <div class="panel-body">
+      <div class="list-group">
+        {% for comment in comments %}
+        <div class="list-group-item" style="border-left: 3px solid #007bff; padding: 1rem;">
+          <div style="display: flex; justify-content: space-between; align-items: flex-start;">
+            <div style="flex: 1;">
+              <h4 style="margin: 0 0 0.5rem 0;">
+                <a href="{% url 'standard_detail' nummer=comment.vorgabe.dokument.nummer %}#{{ comment.vorgabe.Vorgabennummer }}">
+                  {{ comment.vorgabe.Vorgabennummer }}
+                </a> {{ comment.vorgabe.titel }}
+              </h4>
+              <p style="margin: 0 0 0.75rem 0; color: #666; font-size: 0.9rem;">
+                <strong>Benutzer:</strong> {{ comment.user.first_name }} {{ comment.user.last_name }}<br>
+                <strong>Erstellt:</strong> {{ comment.created_at|date:"d.m.Y H:i" }}
+                {% if comment.updated_at != comment.created_at %}
+                  <br>
+                  <strong>Bearbeitet:</strong> {{ comment.updated_at|date:"d.m.Y H:i" }}
+                {% endif %}
+              </p>
+            </div>
+            <form method="POST" action="{% url 'delete_vorgabe_comment' comment.id %}" 
+                  style="display: inline; margin-left: 1rem;"
+                  onsubmit="return confirm('Sind Sie sicher, dass Sie diesen Kommentar löschen möchten?');">
+              {% csrf_token %}
+              <button type="submit" class="btn btn-sm btn-danger">Löschen</button>
+            </form>
+          </div>
+          <div style="background: #f8f9fa; padding: 0.75rem; border-radius: 4px; margin-top: 0.5rem; white-space: pre-wrap; word-wrap: break-word;">
+            {{ comment.text }}
+          </div>
+        </div>
+        {% endfor %}
+      </div>
+    </div>
+  </div>
+  {% endfor %}
+{% endif %}
+
+<div style="margin-top: 2rem; padding-top: 2rem; border-top: 1px solid #ddd;">
+  <a href="{% url 'standard_list' %}" class="btn btn-default">Zu den Standards</a>
+</div>
+{% endblock %}

dokumente/templates/standards/incomplete_vorgaben.html

@@ -0,0 +1,151 @@
+{% extends "base.html" %}
+{% block content %}
+<h1 class="mb-4">Unvollständige Vorgaben</h1>
+
+{% if vorgaben_data %}
+    <div class="table-responsive">
+        <table class="table table-striped table-hover">
+            <thead class="table-dark">
+                <tr>
+                    <th>Vorgabe</th>
+                    <th class="text-center">Referenzen</th>
+                    <th class="text-center">Stichworte</th>
+                    <th class="text-center">Text</th>
+                    <th class="text-center">Checklistenfragen</th>
+                </tr>
+            </thead>
+            <tbody>
+                {% for item in vorgaben_data %}
+                <tr>
+                    <td>
+                        <a href="/autorenumgebung/dokumente/vorgabe/{{ item.vorgabe.id }}/change/" 
+                           class="text-decoration-none" target="_blank">
+                            <strong>{{ item.vorgabe.Vorgabennummer }}</strong><br>
+                            <small class="text-muted">{{ item.vorgabe.titel }}</small><br>
+                            <small class="text-muted">{{ item.vorgabe.dokument.nummer }} – {{ item.vorgabe.dokument.name }}</small>
+                        </a>
+                    </td>
+                    <td class="text-center align-middle">
+                        {% if item.has_references %}
+                            <span class="text-success fs-4">✓</span>
+                        {% else %}
+                            <span class="text-danger fs-4">✗</span>
+                        {% endif %}
+                    </td>
+                    <td class="text-center align-middle">
+                        {% if item.has_stichworte %}
+                            <span class="text-success fs-4">✓</span>
+                        {% else %}
+                            <span class="text-danger fs-4">✗</span>
+                        {% endif %}
+                    </td>
+                    <td class="text-center align-middle">
+                        {% if item.has_text %}
+                            <span class="text-success fs-4">✓</span>
+                        {% else %}
+                            <span class="text-danger fs-4">✗</span>
+                        {% endif %}
+                    </td>
+                    <td class="text-center align-middle">
+                        {% if item.has_checklistenfragen %}
+                            <span class="text-success fs-4">✓</span>
+                        {% else %}
+                            <span class="text-danger fs-4">✗</span>
+                        {% endif %}
+                    </td>
+                </tr>
+                {% endfor %}
+            </tbody>
+        </table>
+    </div>
+
+    <!-- Summary -->
+    <div class="row mt-4">
+        <div class="col-12">
+            <div class="card">
+                <div class="card-header">
+                    <h5 class="mb-0">Zusammenfassung</h5>
+                </div>
+                <div class="card-body">
+                    <div class="row text-center">
+                        <div class="col-md-3">
+                            <div class="p-3">
+                                <h4 class="text-danger" id="no-references-count">0</h4>
+                                <p class="mb-0">Ohne Referenzen</p>
+                            </div>
+                        </div>
+                        <div class="col-md-3">
+                            <div class="p-3">
+                                <h4 class="text-danger" id="no-stichworte-count">0</h4>
+                                <p class="mb-0">Ohne Stichworte</p>
+                            </div>
+                        </div>
+                        <div class="col-md-3">
+                            <div class="p-3">
+                                <h4 class="text-danger" id="no-text-count">0</h4>
+                                <p class="mb-0">Ohne Text</p>
+                            </div>
+                        </div>
+                        <div class="col-md-3">
+                            <div class="p-3">
+                                <h4 class="text-danger" id="no-checklistenfragen-count">0</h4>
+                                <p class="mb-0">Ohne Checklistenfragen</p>
+                            </div>
+                        </div>
+                    </div>
+                    <div class="row mt-3">
+                        <div class="col-12 text-center">
+                            <h4 class="text-primary">Gesamt: {{ vorgaben_data|length }} unvollständige Vorgaben</h4>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+{% else %}
+    <div class="alert alert-success" role="alert">
+        <h4 class="alert-heading">
+            <span class="emoji-icon">✅</span> Alle Vorgaben sind vollständig!
+        </h4>
+        <p>Alle Vorgaben haben Referenzen, Stichworte, Text und Checklistenfragen.</p>
+        <hr>
+        <p class="mb-0">
+            <a href="{% url 'standard_list' %}" class="btn btn-primary">
+                <span class="emoji-icon">📋</span> Zurück zur Übersicht
+            </a>
+        </p>
+    </div>
+{% endif %}
+
+<div class="mt-3">
+    <a href="{% url 'standard_list' %}" class="btn btn-secondary">
+        <span class="emoji-icon">←</span> Zurück zur Übersicht
+    </a>
+</div>
+
+<script>
+// Update summary counts
+document.addEventListener('DOMContentLoaded', function() {
+    let noReferences = 0;
+    let noStichworte = 0;
+    let noText = 0;
+    let noChecklistenfragen = 0;
+    
+    const rows = document.querySelectorAll('tbody tr');
+    rows.forEach(function(row) {
+        const cells = row.querySelectorAll('td');
+        if (cells.length >= 5) {
+            if (cells[1].textContent.trim() === '✗') noReferences++;
+            if (cells[2].textContent.trim() === '✗') noStichworte++;
+            if (cells[3].textContent.trim() === '✗') noText++;
+            if (cells[4].textContent.trim() === '✗') noChecklistenfragen++;
+        }
+    });
+    
+    document.getElementById('no-references-count').textContent = noReferences;
+    document.getElementById('no-stichworte-count').textContent = noStichworte;
+    document.getElementById('no-text-count').textContent = noText;
+    document.getElementById('no-checklistenfragen-count').textContent = noChecklistenfragen;
+});
+</script>
+{% endblock %}

dokumente/templates/standards/standard_detail.html

@@ -0,0 +1,418 @@
+{% extends "base.html" %}
+
+{% block title %}{{ standard.nummer }} – {{ standard.name }}{% endblock %}
+
+{% block content %}
+<div class="container-fluid">
+  <nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+      <li class="breadcrumb-item"><a href="/">Startseite</a></li>
+      <li class="breadcrumb-item"><a href="/dokumente">Standards</a></li>
+      <li class="breadcrumb-item active" aria-current="page">{{ standard.nummer }}</li>
+    </ol>
+  </nav>
+
+  <h1>{{ standard.nummer }} – {{ standard.name }}</h1>
+
+  {% if standard.history == True %}
+  <div class="alert alert-warning" role="alert">
+    <strong>Historische Version vom {{ standard.check_date }}</strong>
+  </div>
+  {% endif %}
+
+  <!-- History Dates Dropdown -->
+  {% if standard.dates %}
+  <div class="mb-3">
+    <div class="dropdown">
+      <a href="#" class="dropdown-toggle" data-toggle="dropdown" style="text-decoration: none;">
+        📅 Historische Versionen
+      </a>
+      <ul class="dropdown-menu" role="menu">
+        <li><a href="/dokumente/{{ standard.nummer }}/">Aktuelle Version</a></li>
+        <li class="divider"></li>
+        {% for date in standard.dates %}
+        <li><a href="/dokumente/{{ standard.nummer }}/history/{{ date|date:'Y-m-d' }}/">{{ date|date:'d.m.Y' }}</a></li>
+        {% endfor %}
+      </ul>
+    </div>
+  </div>
+  {% endif %}
+
+  <!-- Einleitung -->
+  {% if standard.einleitung_html %}
+  <div class="row mb-4">
+    <div class="col-md-12">
+      <div class="card">
+        <div class="card-header">
+          <h2>Einleitung</h2>
+        </div>
+        <div class="card-body">
+          {% for typ, html in standard.einleitung_html %}
+          <div class="mb-2">{{ html|safe }}</div>
+          {% endfor %}
+        </div>
+      </div>
+    </div>
+  </div>
+  {% endif %}
+
+  <!-- Geltungsbereich -->
+  {% if standard.geltungsbereich_html %}
+  <div class="row mb-4">
+    <div class="col-md-12">
+      <div class="card">
+        <div class="card-header">
+          <h2>Geltungsbereich</h2>
+        </div>
+        <div class="card-body">
+          {% for typ, html in standard.geltungsbereich_html %}
+          <div class="mb-2">{{ html|safe }}</div>
+          {% endfor %}
+        </div>
+      </div>
+    </div>
+  </div>
+  {% endif %}
+
+  <!-- Vorgaben -->
+  <div class="row">
+    <div class="col-md-12">
+      <h2>Vorgaben</h2>
+    </div>
+  </div>
+  {% for vorgabe in vorgaben %}
+  {% if standard.history == True or vorgabe.long_status == "active" %}
+  <!-- Vorgabe {{ vorgabe.Vorgabennummer }} -->
+  <div class="row">
+    <div class="col-md-12">
+      {% if not forloop.first %}
+      <hr style="border: 0; border-top: 1px solid #d3d3d3; margin: 2rem 0;">
+      {% endif %}
+
+      <a id="{{ vorgabe.Vorgabennummer }}"></a>
+      <div class="card mb-4">
+        <div class="card-header" style="display: flex; justify-content: space-between; align-items: center;">
+          <h3>
+            {{ vorgabe.Vorgabennummer }} – {{ vorgabe.titel }}
+            {% if vorgabe.long_status != "active" and standard.history == True %}
+            <span class="badge badge-danger">{{ vorgabe.long_status }}</span>
+            {% endif %}
+          </h3>
+          <div style="display: flex; align-items: center; gap: 0.5rem; flex-shrink: 0; white-space: nowrap;">
+            <span class="badge badge-info">{{ vorgabe.thema }}</span>
+            {% if vorgabe.relevanzset %}
+            <span class="badge badge-secondary">
+              Relevanz: {{ vorgabe.relevanzset|join:", " }}
+            </span>
+            {% endif %}
+          </div>
+        </div>
+
+        <div class="card-body">
+          <!-- Kurztext -->
+          {% if vorgabe.kurztext_html.0.1 %}
+          <div class="alert alert-info">
+            {% for typ, html in vorgabe.kurztext_html %}
+            {% if html %}
+            <div class="mb-2">{{ html|safe }}</div>
+            {% endif %}
+            {% endfor %}
+          </div>
+          {% endif %}
+
+          <!-- Langtext -->
+          <div class="mb-3">
+            {% for typ, html in vorgabe.langtext_html %}
+            {% if html %}
+            <div class="mb-3">{{ html|safe }}</div>
+            {% endif %}
+            {% endfor %}
+          </div>
+
+          <!-- Checklistenfragen -->
+          <h4 class="h6">Checklistenfragen</h4>
+          {% if vorgabe.checklistenfragen.all %}
+          <ul class="list-group mb-3">
+            {% for frage in vorgabe.checklistenfragen.all %}
+            <li class="list-group-item">{{ frage.frage }}</li>
+            {% endfor %}
+          </ul>
+          {% else %}
+          <p class="text-muted"><em>Keine Checklistenfragen</em></p>
+          {% endif %}
+
+          <!-- Stichworte und Referenzen -->
+          <div class="mt-4 p-3" style="background-color: #f8f9fa; border-left: 3px solid #dee2e6; padding-left: 0.5en;">
+            <p class="mb-2">
+              <strong>Stichworte:</strong>
+              {% if vorgabe.stichworte.all %}
+              {% for s in vorgabe.stichworte.all %}
+              <a href="{% url 'stichwort_detail' stichwort=s %}" class="badge badge-secondary">{{ s }}</a>{% if not forloop.last %} {% endif %}
+              {% endfor %}
+              {% else %}
+              <span class="text-muted">Keine</span>
+              {% endif %}
+            </p>
+            <p class="mb-0">
+              <strong>Referenzen:</strong>
+              {% if vorgabe.referenzpfade %}
+              {% for ref in vorgabe.referenzpfade %}
+              {{ ref|safe }}{% if not forloop.last %}, {% endif %}
+              {% endfor %}
+              {% else %}
+              <span class="text-muted">Keine</span>
+              {% endif %}
+            </p>
+          </div>
+
+          <!-- Comment Button -->
+          {% if user.is_authenticated %}
+          <div class="mt-3 text-right">
+            <button class="btn btn-sm btn-outline-primary comment-btn" 
+                    data-vorgabe-id="{{ vorgabe.id }}" 
+                    data-vorgabe-nummer="{{ vorgabe.Vorgabennummer }}">
+              <span class="emoji-icon">💬</span> Kommentare
+              {% if vorgabe.comment_count > 0 %}
+              <span class="comment-count">{{ vorgabe.comment_count }}</span>
+              {% endif %}
+            </button>
+          </div>
+          {% endif %}
+        </div>
+      </div>
+    </div>
+  </div>
+  {% endif %}
+  {% endfor %}
+  <!-- Metadata -->
+
+  <h2>Metadaten</h2>
+  <div class="row mb-4">
+    <div class="col-md-12">
+      <dl class="row">
+        <dt class="col-sm-3">Autoren:</dt>
+        <dd class="col-sm-9">{{ standard.autoren.all|join:", " }}</dd>
+
+        <dt class="col-sm-3">Prüfende:</dt>
+        <dd class="col-sm-9">{{ standard.pruefende.all|join:", " }}</dd>
+
+        <dt class="col-sm-3">Gültigkeit:</dt>
+        <dd class="col-sm-9">{{ standard.gueltigkeit_von }} bis {{ standard.gueltigkeit_bis|default_if_none:"auf weiteres" }}</dd>
+      </dl>
+      <p>
+        <a href="{% url 'standard_json' standard.nummer %}"
+           class="btn btn-secondary icon icon--before icon--download"
+           download="{{ standard.nummer }}.json">
+          JSON herunterladen
+        </a>
+      </p>
+    </div>
+  </div>
+</div>
+
+<!-- Comment Modal -->
+<div class="modal fade" id="commentModal" tabindex="-1" role="dialog" aria-labelledby="commentModalLabel" aria-hidden="true">
+  <div class="modal-dialog modal-lg" role="document">
+    <div class="modal-content">
+      <div class="modal-header">
+        <h5 class="modal-title" id="commentModalLabel">Kommentare für <span id="modalVorgabeNummer"></span></h5>
+        <button type="button" class="close" data-dismiss="modal" aria-label="Close">
+          <span aria-hidden="true">&times;</span>
+        </button>
+      </div>
+      <div class="modal-body">
+        <div id="commentsContainer">
+          <!-- Comments will be loaded here -->
+        </div>
+        
+        <!-- Add Comment Form -->
+        <div class="mt-4">
+          <h6>Neuen Kommentar hinzufügen:</h6>
+          <textarea id="newCommentText" class="form-control" rows="3" placeholder="Ihr Kommentar..."></textarea>
+          <button id="addCommentBtn" class="btn btn-primary btn-sm mt-2">Kommentar hinzufügen</button>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+
+<!-- JavaScript for Comments -->
+<script>
+// Content Security Policy for comment system
+document.addEventListener('DOMContentLoaded', function() {
+  // Prevent inline script execution in dynamically loaded content
+  const commentsContainer = document.getElementById('commentsContainer');
+  if (commentsContainer) {
+    // Use DOMPurify-like approach - only allow safe HTML
+    const allowedTags = ['br', 'small', 'div', 'span', 'button'];
+    const allowedAttributes = ['class', 'data-comment-id', 'aria-hidden'];
+    
+    // Monitor for any script injection attempts
+    const observer = new MutationObserver(function(mutations) {
+      mutations.forEach(function(mutation) {
+        mutation.addedNodes.forEach(function(node) {
+          if (node.nodeType === 1) { // Element node
+            const tagName = node.tagName.toLowerCase();
+            if (tagName === 'script') {
+              console.warn('Script injection attempt blocked');
+              node.parentNode.removeChild(node);
+            }
+          }
+        });
+      });
+    });
+    
+    observer.observe(commentsContainer, {
+      childList: true,
+      subtree: true
+    });
+  }
+});
+document.addEventListener('DOMContentLoaded', function() {
+  let currentVorgabeId = null;
+  let currentVorgabeNummer = null;
+  
+  // Comment button click handler
+  document.querySelectorAll('.comment-btn').forEach(btn => {
+    btn.addEventListener('click', function() {
+      currentVorgabeId = this.dataset.vorgabeId;
+      currentVorgabeNummer = this.dataset.vorgabeNummer;
+      
+      document.getElementById('modalVorgabeNummer').textContent = currentVorgabeNummer;
+      document.getElementById('newCommentText').value = '';
+      
+      loadComments();
+      $('#commentModal').modal('show');
+    });
+  });
+  
+  // Load comments function
+  function loadComments() {
+    fetch(`/dokumente/comments/${currentVorgabeId}/`)
+      .then(response => response.json())
+      .then(data => {
+        renderComments(data.comments);
+      })
+      .catch(error => {
+        console.error('Error loading comments:', error);
+        document.getElementById('commentsContainer').innerHTML = 
+          '<div class="alert alert-danger">Fehler beim Laden der Kommentare</div>';
+      });
+  }
+  
+  // Render comments function
+  function renderComments(comments) {
+    const container = document.getElementById('commentsContainer');
+    
+    if (comments.length === 0) {
+      container.innerHTML = '<p class="text-muted">Noch keine Kommentare vorhanden.</p>';
+      return;
+    }
+    
+    let html = '';
+    comments.forEach(comment => {
+      const canDelete = comment.is_own || {% if user.is_authenticated %}'{{ user.is_staff|yesno:"true,false" }}'{% else %}'false'{% endif %} === 'true';
+      html += `
+        <div class="comment-item border-bottom pb-2 mb-2">
+          <div class="d-flex justify-content-between align-items-start">
+            <div class="flex-grow-1">
+              <strong>${comment.user}</strong>
+              <small class="text-muted">(${comment.created_at})</small>
+              ${comment.updated_at !== comment.created_at ? `<small class="text-muted">(bearbeitet: ${comment.updated_at})</small>` : ''}
+              <div class="mt-1">${comment.text}</div>
+            </div>
+            ${canDelete ? `
+              <button class="btn btn-sm btn-outline-danger ml-2 delete-comment-btn" data-comment-id="${comment.id}">
+<span aria-hidden="true">&times;</span>
+              </button>
+            ` : ''}
+          </div>
+        </div>
+      `;
+    });
+    
+    container.innerHTML = html;
+    
+    // Add delete handlers
+    document.querySelectorAll('.delete-comment-btn').forEach(btn => {
+      btn.addEventListener('click', function() {
+        if (confirm('Möchten Sie diesen Kommentar wirklich löschen?')) {
+          deleteComment(this.dataset.commentId);
+        }
+      });
+    });
+  }
+  
+  // Add comment function
+  document.getElementById('addCommentBtn').addEventListener('click', function() {
+    const text = document.getElementById('newCommentText').value.trim();
+    
+    if (!text) {
+      alert('Bitte geben Sie einen Kommentar ein.');
+      return;
+    }
+    
+    fetch(`/dokumente/comments/${currentVorgabeId}/add/`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-CSRFToken': getCookie('csrftoken')
+      },
+      body: JSON.stringify({ text: text })
+    })
+    .then(response => response.json())
+    .then(data => {
+      if (data.success) {
+        document.getElementById('newCommentText').value = '';
+        loadComments();
+      } else {
+        alert('Fehler: ' + (data.error || 'Unbekannter Fehler'));
+      }
+    })
+    .catch(error => {
+      console.error('Error adding comment:', error);
+      alert('Fehler beim Hinzufügen des Kommentars');
+    });
+  });
+  
+  // Delete comment function
+  function deleteComment(commentId) {
+    fetch(`/dokumente/comments/delete/${commentId}/`, {
+      method: 'POST',
+      headers: {
+        'X-CSRFToken': getCookie('csrftoken')
+      }
+    })
+    .then(response => response.json())
+    .then(data => {
+      if (data.success) {
+        loadComments();
+      } else {
+        alert('Fehler: ' + (data.error || 'Unbekannter Fehler'));
+      }
+    })
+    .catch(error => {
+      console.error('Error deleting comment:', error);
+      alert('Fehler beim Löschen des Kommentars');
+    });
+  }
+  
+  // CSRF token helper
+  function getCookie(name) {
+    let cookieValue = null;
+    if (document.cookie && document.cookie !== '') {
+      const cookies = document.cookie.split(';');
+      for (let i = 0; i < cookies.length; i++) {
+        const cookie = cookies[i].trim();
+        if (cookie.substring(0, name.length + 1) === (name + '=')) {
+          cookieValue = decodeURIComponent(cookie.substring(name.length + 1));
+          break;
+        }
+      }
+    }
+    return cookieValue;
+  }
+});
+</script>
+
+{% endblock %}

dokumente/templates/standards/standard_list.html

@@ -2,10 +2,10 @@
 {% block content %}
 <h1>Standards Informatiksicherheit</h1>
 <ul>
-  {% for standard in standards %}
+  {% for dokument in dokumente %}
     <li>
-      <a href="{% url 'standard_detail' nummer=standard.nummer %}">
-        {{ standard.nummer }} – {{ standard.name }}
+      <a href="{% url 'standard_detail' nummer=dokument.nummer %}">
+        {{ dokument.nummer }} – {{ dokument.name }}
       </a>
     </li>
   {% endfor %}

dokumente/templates/standards/user_comments.html

@@ -0,0 +1,66 @@
+{% extends "base.html" %}
+
+{% block content %}
+<h1>Meine Kommentare</h1>
+
+{% if total_comments == 0 %}
+  <div class="alert alert-info">
+    <p>Sie haben noch keine Kommentare zu Vorgaben hinterlassen.</p>
+    <p><a href="{% url 'standard_list' %}">Zu den Standards</a></p>
+  </div>
+{% else %}
+  <p class="text-muted">Insgesamt {{ total_comments }} Kommentar{{ total_comments|pluralize:"e" }}</p>
+
+  {% for dokument, comments in comments_by_document.items %}
+  <div class="panel panel-default" style="margin-top: 2rem;">
+    <div class="panel-heading">
+      <h2 style="margin: 0;">
+        <a href="{% url 'standard_detail' nummer=dokument.nummer %}">
+          {{ dokument.nummer }} – {{ dokument.name }}
+        </a>
+      </h2>
+      <p style="margin: 0; color: #666; font-size: 0.9rem;">
+        {{ comments|length }} Kommentar{{ comments|length|pluralize:"e" }}
+      </p>
+    </div>
+    <div class="panel-body">
+      <div class="list-group">
+        {% for comment in comments %}
+        <div class="list-group-item" style="border-left: 3px solid #007bff; padding: 1rem;">
+          <div style="display: flex; justify-content: space-between; align-items: flex-start;">
+            <div style="flex: 1;">
+              <h4 style="margin: 0 0 0.5rem 0;">
+                <a href="{% url 'standard_detail' nummer=comment.vorgabe.dokument.nummer %}#{{ comment.vorgabe.Vorgabennummer }}">
+                  {{ comment.vorgabe.Vorgabennummer }}
+                </a> {{ comment.vorgabe.titel }}
+              </h4>
+              <p style="margin: 0 0 0.75rem 0; color: #666; font-size: 0.9rem;">
+                <strong>Erstellt:</strong> {{ comment.created_at|date:"d.m.Y H:i" }}
+                {% if comment.updated_at != comment.created_at %}
+                  <br>
+                  <strong>Bearbeitet:</strong> {{ comment.updated_at|date:"d.m.Y H:i" }}
+                {% endif %}
+              </p>
+            </div>
+            <form method="POST" action="{% url 'delete_vorgabe_comment' comment.id %}" 
+                  style="display: inline; margin-left: 1rem;"
+                  onsubmit="return confirm('Sind Sie sicher, dass Sie diesen Kommentar löschen möchten?');">
+              {% csrf_token %}
+              <button type="submit" class="btn btn-sm btn-danger">Löschen</button>
+            </form>
+          </div>
+          <div style="background: #f8f9fa; padding: 0.75rem; border-radius: 4px; margin-top: 0.5rem; white-space: pre-wrap; word-wrap: break-word;">
+            {{ comment.text }}
+          </div>
+        </div>
+        {% endfor %}
+      </div>
+    </div>
+  </div>
+  {% endfor %}
+{% endif %}
+
+<div style="margin-top: 2rem; padding-top: 2rem; border-top: 1px solid #ddd;">
+  <a href="{% url 'standard_list' %}" class="btn btn-default">Zu den Standards</a>
+</div>
+{% endblock %}

dokumente/test_json.py

@@ -0,0 +1,385 @@
+from django.test import TestCase, Client
+from django.urls import reverse
+from django.core.management import call_command
+from datetime import date
+from io import StringIO
+import tempfile
+import os
+import json
+
+from dokumente.models import (
+    Dokumententyp, Person, Thema, Dokument, Vorgabe,
+    VorgabeLangtext, VorgabeKurztext, Geltungsbereich,
+    Einleitung, Checklistenfrage, Changelog
+)
+from abschnitte.models import AbschnittTyp
+
+
+class JSONExportManagementCommandTest(TestCase):
+    """Test cases for export_json management command"""
+    
+    def setUp(self):
+        """Set up test data for JSON export"""
+        # Create test data
+        self.dokumententyp = Dokumententyp.objects.create(
+            name="Standard IT-Sicherheit",
+            verantwortliche_ve="SR-SUR-SEC"
+        )
+        
+        self.autor1 = Person.objects.create(
+            name="Max Mustermann",
+            funktion="Security Analyst"
+        )
+        self.autor2 = Person.objects.create(
+            name="Erika Mustermann", 
+            funktion="Security Manager"
+        )
+        
+        self.thema = Thema.objects.create(
+            name="Access Control",
+            erklaerung="Zugangskontrolle"
+        )
+        
+        self.dokument = Dokument.objects.create(
+            nummer="TEST-001",
+            dokumententyp=self.dokumententyp,
+            name="Test Standard",
+            gueltigkeit_von=date(2023, 1, 1),
+            gueltigkeit_bis=date(2025, 12, 31),
+            signatur_cso="CSO-123",
+            anhaenge="Anhang1.pdf, Anhang2.pdf",
+            aktiv=True
+        )
+        self.dokument.autoren.add(self.autor1, self.autor2)
+        
+        self.vorgabe = Vorgabe.objects.create(
+            order=1,
+            nummer=1,
+            dokument=self.dokument,
+            thema=self.thema,
+            titel="Test Vorgabe",
+            gueltigkeit_von=date(2023, 1, 1),
+            gueltigkeit_bis=date(2025, 12, 31)
+        )
+        
+        # Create text sections
+        self.abschnitttyp_text = AbschnittTyp.objects.create(abschnitttyp="text")
+        self.abschnitttyp_table = AbschnittTyp.objects.create(abschnitttyp="table")
+        
+        self.geltungsbereich = Geltungsbereich.objects.create(
+            geltungsbereich=self.dokument,
+            abschnitttyp=self.abschnitttyp_text,
+            inhalt="Dies ist der Geltungsbereich",
+            order=1
+        )
+        
+        self.einleitung = Einleitung.objects.create(
+            einleitung=self.dokument,
+            abschnitttyp=self.abschnitttyp_text,
+            inhalt="Dies ist die Einleitung",
+            order=1
+        )
+        
+        self.kurztext = VorgabeKurztext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.abschnitttyp_text,
+            inhalt="Dies ist der Kurztext",
+            order=1
+        )
+        
+        self.langtext = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.abschnitttyp_table,
+            inhalt="Spalte1|Spalte2\nWert1|Wert2",
+            order=1
+        )
+        
+        self.checklistenfrage = Checklistenfrage.objects.create(
+            vorgabe=self.vorgabe,
+            frage="Ist die Zugriffskontrolle implementiert?"
+        )
+        
+        self.changelog = Changelog.objects.create(
+            dokument=self.dokument,
+            datum=date(2023, 6, 1),
+            aenderung="Erste Version erstellt"
+        )
+        self.changelog.autoren.add(self.autor1)
+    
+    def test_export_json_command_stdout(self):
+        """Test export_json command output to stdout"""
+        out = StringIO()
+        call_command('export_json', stdout=out)
+        
+        output = out.getvalue()
+        
+        # Check that output contains expected JSON structure
+        self.assertIn('"Typ": "Standard IT-Sicherheit"', output)
+        self.assertIn('"Nummer": "TEST-001"', output)
+        self.assertIn('"Name": "Test Standard"', output)
+        self.assertIn('"Max Mustermann"', output)
+        self.assertIn('"Erika Mustermann"', output)
+        self.assertIn('"Von": "2023-01-01"', output)
+        self.assertIn('"Bis": "2025-12-31"', output)
+        self.assertIn('"SignaturCSO": "CSO-123"', output)
+        self.assertIn('"Dies ist der Geltungsbereich"', output)
+        self.assertIn('"Dies ist die Einleitung"', output)
+        self.assertIn('"Dies ist der Kurztext"', output)
+        self.assertIn('"Ist die Zugriffskontrolle implementiert?"', output)
+        self.assertIn('"Erste Version erstellt"', output)
+    
+    def test_export_json_command_to_file(self):
+        """Test export_json command output to file"""
+        with tempfile.NamedTemporaryFile(mode='w', delete=False, suffix='.json') as tmp_file:
+            tmp_filename = tmp_file.name
+        
+        try:
+            call_command('export_json', output=tmp_filename)
+            
+            # Read file content
+            with open(tmp_filename, 'r', encoding='utf-8') as f:
+                content = f.read()
+            
+            # Parse JSON to ensure it's valid
+            data = json.loads(content)
+            
+            # Verify structure
+            self.assertIsInstance(data, list)
+            self.assertEqual(len(data), 1)
+            
+            doc_data = data[0]
+            self.assertEqual(doc_data['Nummer'], 'TEST-001')
+            self.assertEqual(doc_data['Name'], 'Test Standard')
+            self.assertEqual(doc_data['Typ'], 'Standard IT-Sicherheit')
+            self.assertEqual(len(doc_data['Autoren']), 2)
+            self.assertIn('Max Mustermann', doc_data['Autoren'])
+            self.assertIn('Erika Mustermann', doc_data['Autoren'])
+            
+        finally:
+            # Clean up temporary file
+            if os.path.exists(tmp_filename):
+                os.unlink(tmp_filename)
+    
+    def test_export_json_command_empty_database(self):
+        """Test export_json command with no documents"""
+        # Delete all documents
+        Dokument.objects.all().delete()
+        
+        out = StringIO()
+        call_command('export_json', stdout=out)
+        
+        output = out.getvalue()
+        
+        # Should output empty array
+        self.assertEqual(output.strip(), '[]')
+    
+    def test_export_json_command_inactive_documents(self):
+        """Test export_json command filters inactive documents"""
+        # Create inactive document
+        inactive_doc = Dokument.objects.create(
+            nummer="INACTIVE-001",
+            dokumententyp=self.dokumententyp,
+            name="Inactive Document",
+            aktiv=False
+        )
+        
+        out = StringIO()
+        call_command('export_json', stdout=out)
+        
+        output = out.getvalue()
+        
+        # Should not contain inactive document
+        self.assertNotIn('"INACTIVE-001"', output)
+        self.assertNotIn('"Inactive Document"', output)
+        
+        # Should still contain active document
+        self.assertIn('"TEST-001"', output)
+        self.assertIn('"Test Standard"', output)
+
+
+class StandardJSONViewTest(TestCase):
+    """Test cases for standard_json view"""
+    
+    def setUp(self):
+        """Set up test data for JSON view"""
+        self.client = Client()
+        
+        # Create test data
+        self.dokumententyp = Dokumententyp.objects.create(
+            name="Standard IT-Sicherheit",
+            verantwortliche_ve="SR-SUR-SEC"
+        )
+        
+        self.autor = Person.objects.create(
+            name="Test Autor",
+            funktion="Security Analyst"
+        )
+        
+        self.pruefender = Person.objects.create(
+            name="Test Pruefender",
+            funktion="Security Manager"
+        )
+        
+        self.thema = Thema.objects.create(
+            name="Access Control",
+            erklaerung="Zugangskontrolle"
+        )
+        
+        self.dokument = Dokument.objects.create(
+            nummer="JSON-001",
+            dokumententyp=self.dokumententyp,
+            name="JSON Test Standard",
+            gueltigkeit_von=date(2023, 1, 1),
+            gueltigkeit_bis=date(2025, 12, 31),
+            signatur_cso="CSO-456",
+            anhaenge="test.pdf",
+            aktiv=True
+        )
+        self.dokument.autoren.add(self.autor)
+        self.dokument.pruefende.add(self.pruefender)
+        
+        self.vorgabe = Vorgabe.objects.create(
+            order=1,
+            nummer=1,
+            dokument=self.dokument,
+            thema=self.thema,
+            titel="JSON Test Vorgabe",
+            gueltigkeit_von=date(2023, 1, 1),
+            gueltigkeit_bis=date(2025, 12, 31)
+        )
+        
+        # Create text sections
+        self.abschnitttyp_text = AbschnittTyp.objects.create(abschnitttyp="text")
+        
+        self.geltungsbereich = Geltungsbereich.objects.create(
+            geltungsbereich=self.dokument,
+            abschnitttyp=self.abschnitttyp_text,
+            inhalt="Dies ist der Geltungsbereich",
+            order=1
+        )
+        
+        self.einleitung = Einleitung.objects.create(
+            einleitung=self.dokument,
+            abschnitttyp=self.abschnitttyp_text,
+            inhalt="Dies ist die Einleitung",
+            order=1
+        )
+        
+        self.kurztext = VorgabeKurztext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.abschnitttyp_text,
+            inhalt="JSON Kurztext",
+            order=1
+        )
+        
+        self.langtext = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            abschnitttyp=self.abschnitttyp_text,
+            inhalt="JSON Langtext",
+            order=1
+        )
+        
+        self.checklistenfrage = Checklistenfrage.objects.create(
+            vorgabe=self.vorgabe,
+            frage="JSON Checklistenfrage?"
+        )
+        
+        self.changelog = Changelog.objects.create(
+            dokument=self.dokument,
+            datum=date(2023, 6, 1),
+            aenderung="JSON Changelog Eintrag"
+        )
+        self.changelog.autoren.add(self.autor)
+    
+    def test_standard_json_view_success(self):
+        """Test standard_json view returns correct JSON"""
+        url = reverse('standard_json', kwargs={'nummer': 'JSON-001'})
+        response = self.client.get(url)
+        
+        self.assertEqual(response.status_code, 200)
+        self.assertEqual(response['Content-Type'], 'application/json')
+        
+        # Parse JSON response
+        data = json.loads(response.content)
+        
+        # Verify document structure
+        self.assertEqual(data['Nummer'], 'JSON-001')
+        self.assertEqual(data['Name'], 'JSON Test Standard')
+        self.assertEqual(data['Typ'], 'Standard IT-Sicherheit')
+        self.assertEqual(len(data['Autoren']), 1)
+        self.assertEqual(data['Autoren'][0], 'Test Autor')
+        self.assertEqual(len(data['Pruefende']), 1)
+        self.assertEqual(data['Pruefende'][0], 'Test Pruefender')
+        self.assertEqual(data['Gueltigkeit']['Von'], '2023-01-01')
+        self.assertEqual(data['Gueltigkeit']['Bis'], '2025-12-31')
+        self.assertEqual(data['SignaturCSO'], 'CSO-456')
+        self.assertEqual(data['Anhänge'], 'test.pdf')
+        self.assertEqual(data['Verantwortlich'], 'Information Security Management BIT')
+        self.assertIsNone(data['Klassifizierung'])
+    
+    def test_standard_json_view_not_found(self):
+        """Test standard_json view returns 404 for non-existent document"""
+        url = reverse('standard_json', kwargs={'nummer': 'NONEXISTENT'})
+        response = self.client.get(url)
+        
+        self.assertEqual(response.status_code, 404)
+    
+    def test_standard_json_view_empty_sections(self):
+        """Test standard_json view handles empty sections correctly"""
+        # Create document without sections
+        empty_doc = Dokument.objects.create(
+            nummer="EMPTY-001",
+            dokumententyp=self.dokumententyp,
+            name="Empty Document",
+            aktiv=True
+        )
+        
+        url = reverse('standard_json', kwargs={'nummer': 'EMPTY-001'})
+        response = self.client.get(url)
+        
+        data = json.loads(response.content)
+        
+        # Verify empty sections are handled correctly
+        self.assertEqual(data['Geltungsbereich'], {})
+        self.assertEqual(data['Einleitung'], {})
+        self.assertEqual(data['Vorgaben'], [])
+        self.assertEqual(data['Changelog'], [])
+    
+    def test_standard_json_view_null_dates(self):
+        """Test standard_json view handles null dates correctly"""
+        # Create document with null dates
+        null_doc = Dokument.objects.create(
+            nummer="NULL-001",
+            dokumententyp=self.dokumententyp,
+            name="Null Dates Document",
+            gueltigkeit_von=None,
+            gueltigkeit_bis=None,
+            aktiv=True
+        )
+        
+        url = reverse('standard_json', kwargs={'nummer': 'NULL-001'})
+        response = self.client.get(url)
+        
+        data = json.loads(response.content)
+        
+        # Verify null dates are handled correctly
+        self.assertEqual(data['Gueltigkeit']['Von'], '')
+        self.assertIsNone(data['Gueltigkeit']['Bis'])
+    
+    def test_standard_json_view_json_formatting(self):
+        """Test standard_json view returns properly formatted JSON"""
+        url = reverse('standard_json', kwargs={'nummer': 'JSON-001'})
+        response = self.client.get(url)
+        
+        # Check that response is valid JSON
+        try:
+            data = json.loads(response.content)
+            json_valid = True
+        except json.JSONDecodeError:
+            json_valid = False
+        
+        self.assertTrue(json_valid)
+        
+        # Check that JSON is properly indented (should be formatted)
+        self.assertIn('\n', response.content.decode())
+        self.assertIn('  ', response.content.decode())  # Check for indentation

dokumente/urls.py

@@ -0,0 +1,18 @@
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('', views.standard_list, name='standard_list'),
+    path('unvollstaendig/', views.incomplete_vorgaben, name='incomplete_vorgaben'),
+    path('meine-kommentare/', views.user_comments, name='user_comments'),
+    path('alle-kommentare/', views.all_comments, name='all_comments'),
+    path('<str:nummer>/', views.standard_detail, name='standard_detail'),
+    path('<str:nummer>/history/<str:check_date>/', views.standard_detail),
+    path('<str:nummer>/history/', views.standard_detail, {"check_date":"today"}, name='standard_history'),
+    path('<str:nummer>/checkliste/', views.standard_checkliste, name='standard_checkliste'),
+    path('<str:nummer>/json/', views.standard_json, name='standard_json'),
+    path('comments/<int:vorgabe_id>/', views.get_vorgabe_comments, name='get_vorgabe_comments'),
+    path('comments/<int:vorgabe_id>/add/', views.add_vorgabe_comment, name='add_vorgabe_comment'),
+    path('comments/delete/<int:comment_id>/', views.delete_vorgabe_comment, name='delete_vorgabe_comment'),
+]
+

dokumente/utils.py

@@ -0,0 +1,123 @@
+"""
+Utility functions for Vorgaben sanity checking
+"""
+import datetime
+from django.db.models import Count
+from itertools import combinations
+from dokumente.models import Vorgabe
+
+
+def check_vorgabe_conflicts():
+    """
+    Check for conflicts in Vorgaben.
+    
+    Main rule: If there are two Vorgaben with the same number, Thema and Dokument,
+    their valid_from and valid_to date ranges shouldn't intersect.
+    
+    Returns:
+        list: List of conflict dictionaries
+    """
+    conflicts = []
+    
+    # Find Vorgaben with same dokument, thema, and nummer
+    duplicate_groups = (
+        Vorgabe.objects.values('dokument', 'thema', 'nummer')
+        .annotate(count=Count('id'))
+        .filter(count__gt=1)
+    )
+    
+    for group in duplicate_groups:
+        # Get all Vorgaben in this group
+        vorgaben = Vorgabe.objects.filter(
+            dokument=group['dokument'],
+            thema=group['thema'], 
+            nummer=group['nummer']
+        )
+        
+        # Check all pairs for date range intersections
+        for vorgabe1, vorgabe2 in combinations(vorgaben, 2):
+            if date_ranges_intersect(
+                vorgabe1.gueltigkeit_von, vorgabe1.gueltigkeit_bis,
+                vorgabe2.gueltigkeit_von, vorgabe2.gueltigkeit_bis
+            ):
+                conflicts.append({
+                    'vorgabe1': vorgabe1,
+                    'vorgabe2': vorgabe2,
+                    'conflict_type': 'date_range_intersection',
+                    'message': f"Vorgaben {vorgabe1.Vorgabennummer()} and {vorgabe2.Vorgabennummer()} "
+                              f"have intersecting validity periods"
+                })
+    
+    return conflicts
+
+
+def date_ranges_intersect(start1, end1, start2, end2):
+    """
+    Check if two date ranges intersect.
+    None end date means open-ended range.
+    
+    Args:
+        start1, start2: Start dates
+        end1, end2: End dates (can be None for open-ended)
+        
+    Returns:
+        bool: True if ranges intersect
+    """
+    # If either start date is None, treat it as invalid case
+    if not start1 or not start2:
+        return False
+        
+    # If end date is None, treat it as far future
+    end1 = end1 or datetime.date.max
+    end2 = end2 or datetime.date.max
+    
+    # Ranges intersect if start1 <= end2 and start2 <= end1
+    return start1 <= end2 and start2 <= end1
+
+
+def format_conflict_report(conflicts, verbose=False):
+    """
+    Format conflicts into a readable report.
+    
+    Args:
+        conflicts: List of conflict dictionaries
+        verbose: Whether to show detailed information
+        
+    Returns:
+        str: Formatted report
+    """
+    if not conflicts:
+        return "✓ No conflicts found in Vorgaben"
+    
+    lines = [f"Found {len(conflicts)} conflicts:"]
+    
+    for i, conflict in enumerate(conflicts, 1):
+        lines.append(f"\n{i}. {conflict['message']}")
+        
+        if verbose:
+            v1 = conflict['vorgabe1']
+            v2 = conflict['vorgabe2']
+            
+            lines.append(f"   Vorgabe 1: {v1.Vorgabennummer()}")
+            lines.append(f"   Valid from: {v1.gueltigkeit_von} to {v1.gueltigkeit_bis or 'unlimited'}")
+            lines.append(f"   Title: {v1.titel}")
+            
+            lines.append(f"   Vorgabe 2: {v2.Vorgabennummer()}")
+            lines.append(f"   Valid from: {v2.gueltigkeit_von} to {v2.gueltigkeit_bis or 'unlimited'}")
+            lines.append(f"   Title: {v2.titel}")
+        
+        # Show the overlapping period
+        v1 = conflict['vorgabe1']
+        v2 = conflict['vorgabe2']
+        overlap_start = max(v1.gueltigkeit_von, v2.gueltigkeit_von)
+        overlap_end = min(
+            v1.gueltigkeit_bis or datetime.date.max,
+            v2.gueltigkeit_bis or datetime.date.max
+        )
+        
+        if overlap_end != datetime.date.max:
+            lines.append(f"   Overlap: {overlap_start} to {overlap_end}")
+        else:
+            lines.append(f"   Overlap starts: {overlap_start} (no end)")
+    
+    return "\n".join(lines)

dokumente/views.py

@@ -0,0 +1,422 @@
+from django.shortcuts import render, get_object_or_404
+from django.contrib.auth.decorators import login_required, user_passes_test
+from django.http import JsonResponse
+from django.core.serializers.json import DjangoJSONEncoder
+from django.views.decorators.http import require_POST
+from django.views.decorators.csrf import csrf_exempt
+from django.utils.html import escape, mark_safe
+from django.utils.safestring import SafeString
+import json
+from .models import Dokument, Vorgabe, VorgabeKurztext, VorgabeLangtext, Checklistenfrage, VorgabeComment
+from abschnitte.utils import render_textabschnitte
+
+from datetime import date
+import parsedatetime
+
+calendar=parsedatetime.Calendar()
+
+
+def standard_list(request):
+    dokumente = Dokument.objects.all()
+    return render(request, 'standards/standard_list.html',
+                  {'dokumente': dokumente}
+                  )
+
+
+def standard_detail(request, nummer,check_date=""):
+    standard = get_object_or_404(Dokument, nummer=nummer)
+
+    if check_date:
+        check_date = calendar.parseDT(check_date)[0].date()
+        standard.history = True
+    else:
+        check_date = date.today()
+        standard.history = False
+    standard.check_date=check_date
+    vorgaben = list(standard.vorgaben.order_by("thema","nummer").select_related("thema","dokument"))  # convert queryset to list so we can attach attributes
+
+    standard.geltungsbereich_html = render_textabschnitte(standard.geltungsbereich_set.order_by("order").select_related("abschnitttyp"))
+    standard.einleitung_html=render_textabschnitte(standard.einleitung_set.order_by("order"))
+    for vorgabe in vorgaben:
+        # Prepare Kurztext HTML
+        vorgabe.kurztext_html = render_textabschnitte(vorgabe.vorgabekurztext_set.order_by("order").select_related("abschnitttyp","abschnitt"))
+        vorgabe.langtext_html = render_textabschnitte(vorgabe.vorgabelangtext_set.order_by("order").select_related("abschnitttyp","abschnitt"))
+        vorgabe.long_status=vorgabe.get_status(check_date,verbose=True)
+        vorgabe.relevanzset=list(vorgabe.relevanz.all())
+
+        referenz_items = []
+        for r in vorgabe.referenzen.all():
+            referenz_items.append(r.Path())
+        vorgabe.referenzpfade = referenz_items
+        
+        # Add comment count
+        if request.user.is_authenticated:
+            if request.user.is_staff:
+                vorgabe.comment_count = vorgabe.comments.count()
+            else:
+                vorgabe.comment_count = vorgabe.comments.filter(user=request.user).count()
+        else:
+            vorgabe.comment_count = 0
+
+    return render(request, 'standards/standard_detail.html', {
+        'standard': standard,
+        'vorgaben': vorgaben,
+    })
+
+
+def standard_checkliste(request, nummer):
+    standard = get_object_or_404(Dokument, nummer=nummer)
+    vorgaben = list(standard.vorgaben.all())
+    return render(request, 'standards/standard_checkliste.html', {
+        'standard': standard,
+        'vorgaben': vorgaben,
+    })
+
+
+def is_staff_user(user):
+    return user.is_staff
+
+@login_required
+@user_passes_test(is_staff_user)
+def incomplete_vorgaben(request):
+    """
+    Show table of all Vorgaben with completeness status:
+    - References (✓ or ✗)
+    - Stichworte (✓ or ✗)
+    - Text (✓ or ✗)
+    - Checklistenfragen (✓ or ✗)
+    """
+    # Get all active Vorgaben
+    all_vorgaben = Vorgabe.objects.all().select_related('dokument', 'thema').prefetch_related(
+        'referenzen', 'stichworte', 'checklistenfragen', 'vorgabekurztext_set', 'vorgabelangtext_set'
+    )
+    
+    # Build table data
+    vorgaben_data = []
+    for vorgabe in all_vorgaben:
+        has_references = vorgabe.referenzen.exists()
+        has_stichworte = vorgabe.stichworte.exists()
+        has_kurztext = vorgabe.vorgabekurztext_set.exists()
+        has_langtext = vorgabe.vorgabelangtext_set.exists()
+        has_text = has_kurztext or has_langtext
+        has_checklistenfragen = vorgabe.checklistenfragen.exists()
+        
+        # Only include Vorgaben that are incomplete in at least one way
+        if not (has_references and has_stichworte and has_text and has_checklistenfragen):
+            vorgaben_data.append({
+                'vorgabe': vorgabe,
+                'has_references': has_references,
+                'has_stichworte': has_stichworte,
+                'has_text': has_text,
+                'has_checklistenfragen': has_checklistenfragen,
+                'is_complete': has_references and has_stichworte and has_text and has_checklistenfragen
+            })
+    
+    # Sort by document number and Vorgabe number
+    vorgaben_data.sort(key=lambda x: (x['vorgabe'].dokument.nummer, x['vorgabe'].Vorgabennummer()))
+    
+    return render(request, 'standards/incomplete_vorgaben.html', {
+        'vorgaben_data': vorgaben_data,
+    })
+
+
+def standard_json(request, nummer):
+    """
+    Export a single Dokument as JSON
+    """
+    # Get the document with all related data
+    dokument = get_object_or_404(
+        Dokument.objects.prefetch_related(
+            'autoren', 'pruefende', 'vorgaben__thema', 
+            'vorgaben__referenzen', 'vorgaben__stichworte',
+            'vorgaben__checklistenfragen', 'vorgaben__vorgabekurztext_set',
+            'vorgaben__vorgabelangtext_set', 'geltungsbereich_set',
+            'einleitung_set', 'changelog__autoren'
+        ),
+        nummer=nummer
+    )
+
+    # Build document structure (reusing logic from export_json command)
+    doc_data = {
+        "Typ": dokument.dokumententyp.name if dokument.dokumententyp else "",
+        "Nummer": dokument.nummer,
+        "Name": dokument.name,
+        "Autoren": [autor.name for autor in dokument.autoren.all()],
+        "Pruefende": [pruefender.name for pruefender in dokument.pruefende.all()],
+        "Gueltigkeit": {
+            "Von": dokument.gueltigkeit_von.strftime("%Y-%m-%d") if dokument.gueltigkeit_von else "",
+            "Bis": dokument.gueltigkeit_bis.strftime("%Y-%m-%d") if dokument.gueltigkeit_bis else None
+        },
+        "SignaturCSO": dokument.signatur_cso,
+        "Geltungsbereich": {},
+        "Einleitung": {},
+        "Ziel": "",
+        "Grundlagen": "",
+        "Changelog": [],
+        "Anhänge": dokument.anhaenge,
+        "Verantwortlich": "Information Security Management BIT",
+        "Klassifizierung": None,
+        "Glossar": {},
+        "Vorgaben": []
+    }
+
+    # Process Geltungsbereich sections
+    geltungsbereich_sections = []
+    for gb in dokument.geltungsbereich_set.all().order_by('order'):
+        geltungsbereich_sections.append({
+            "typ": gb.abschnitttyp.abschnitttyp if gb.abschnitttyp else "text",
+            "inhalt": gb.inhalt
+        })
+    
+    if geltungsbereich_sections:
+        doc_data["Geltungsbereich"] = {
+            "Abschnitt": geltungsbereich_sections
+        }
+
+    # Process Einleitung sections
+    einleitung_sections = []
+    for ei in dokument.einleitung_set.all().order_by('order'):
+        einleitung_sections.append({
+            "typ": ei.abschnitttyp.abschnitttyp if ei.abschnitttyp else "text",
+            "inhalt": ei.inhalt
+        })
+    
+    if einleitung_sections:
+        doc_data["Einleitung"] = {
+            "Abschnitt": einleitung_sections
+        }
+
+    # Process Changelog entries
+    changelog_entries = []
+    for cl in dokument.changelog.all().order_by('-datum'):
+        changelog_entries.append({
+            "Datum": cl.datum.strftime("%Y-%m-%d"),
+            "Autoren": [autor.name for autor in cl.autoren.all()],
+            "Aenderung": cl.aenderung
+        })
+    
+    doc_data["Changelog"] = changelog_entries
+
+    # Process Vorgaben for this document
+    vorgaben = dokument.vorgaben.all().order_by('order')
+    
+    for vorgabe in vorgaben:
+        # Get Kurztext and Langtext sections
+        kurztext_sections = []
+        for kt in vorgabe.vorgabekurztext_set.all().order_by('order'):
+            kurztext_sections.append({
+                "typ": kt.abschnitttyp.abschnitttyp if kt.abschnitttyp else "text",
+                "inhalt": kt.inhalt
+            })
+        
+        langtext_sections = []
+        for lt in vorgabe.vorgabelangtext_set.all().order_by('order'):
+            langtext_sections.append({
+                "typ": lt.abschnitttyp.abschnitttyp if lt.abschnitttyp else "text", 
+                "inhalt": lt.inhalt
+            })
+
+        # Build text structures following Langtext pattern
+        kurztext = {
+            "Abschnitt": kurztext_sections if kurztext_sections else []
+        } if kurztext_sections else {}
+        langtext = {
+            "Abschnitt": langtext_sections if langtext_sections else []
+        } if langtext_sections else {}
+
+        # Get references and keywords
+        referenzen = [f"{ref.name_nummer}: {ref.name_text}" if ref.name_text else ref.name_nummer for ref in vorgabe.referenzen.all()]
+        stichworte = [stw.stichwort for stw in vorgabe.stichworte.all()]
+        
+        # Get checklist questions
+        checklistenfragen = [cf.frage for cf in vorgabe.checklistenfragen.all()]
+
+        vorgabe_data = {
+            "Nummer": str(vorgabe.nummer),
+            "Titel": vorgabe.titel,
+            "Thema": vorgabe.thema.name if vorgabe.thema else "",
+            "Kurztext": kurztext,
+            "Langtext": langtext,
+            "Referenz": referenzen,
+            "Gueltigkeit": {
+                "Von": vorgabe.gueltigkeit_von.strftime("%Y-%m-%d") if vorgabe.gueltigkeit_von else "",
+                "Bis": vorgabe.gueltigkeit_bis.strftime("%Y-%m-%d") if vorgabe.gueltigkeit_bis else None
+            },
+            "Checklistenfragen": checklistenfragen,
+            "Stichworte": stichworte
+        }
+        
+        doc_data["Vorgaben"].append(vorgabe_data)
+
+    # Return JSON response
+    return JsonResponse(doc_data, json_dumps_params={'indent': 2, 'ensure_ascii': False}, encoder=DjangoJSONEncoder)
+
+
+@login_required
+def get_vorgabe_comments(request, vorgabe_id):
+    """Get comments for a specific Vorgabe"""
+    vorgabe = get_object_or_404(Vorgabe, id=vorgabe_id)
+    
+    if request.user.is_staff:
+        # Staff can see all comments
+        comments = vorgabe.comments.all().select_related('user').order_by('created_at')
+    else:
+        # Regular users can only see their own comments
+        comments = vorgabe.comments.filter(user=request.user).select_related('user').order_by('created_at')
+    
+    comments_data = []
+    for comment in comments:
+        # Escape HTML but preserve line breaks
+        escaped_text = escape(comment.text).replace('\n', '<br>')
+        comments_data.append({
+            'id': comment.id,
+            'text': escaped_text,
+            'user': escape(comment.user.first_name+" "+comment.user.last_name),
+            'created_at': comment.created_at.strftime('%d.%m.%Y %H:%M'),
+            'updated_at': comment.updated_at.strftime('%d.%m.%Y %H:%M'),
+            'is_own': comment.user == request.user
+        })
+    
+    response = JsonResponse({'comments': comments_data})
+    response['Content-Security-Policy'] = "default-src 'self'"
+    response['X-Content-Type-Options'] = 'nosniff'
+    return response
+
+
+@require_POST
+@login_required
+def add_vorgabe_comment(request, vorgabe_id):
+    """Add a new comment to a Vorgabe"""
+    vorgabe = get_object_or_404(Vorgabe, id=vorgabe_id)
+    
+    try:
+        data = json.loads(request.body)
+        text = data.get('text', '').strip()
+        
+        # Validate input
+        if not text:
+            return JsonResponse({'error': 'Kommentar darf nicht leer sein'}, status=400)
+        
+        if len(text) > 2000:  # Reasonable length limit
+            return JsonResponse({'error': 'Kommentar ist zu lang (max 2000 Zeichen)'}, status=400)
+        
+        # Additional XSS prevention - check for dangerous patterns
+        dangerous_patterns = ['<script', 'javascript:', 'onload=', 'onerror=', 'onclick=', 'onmouseover=']
+        text_lower = text.lower()
+        for pattern in dangerous_patterns:
+            if pattern in text_lower:
+                return JsonResponse({'error': 'Kommentar enthält ungültige Zeichen'}, status=400)
+        
+        comment = VorgabeComment.objects.create(
+            vorgabe=vorgabe,
+            user=request.user,
+            text=text
+        )
+        
+        # Escape HTML but preserve line breaks
+        escaped_text = escape(comment.text).replace('\n', '<br>')
+        response = JsonResponse({
+            'success': True,
+            'comment': {
+                'id': comment.id,
+                'text': escaped_text,
+                'user': escape(comment.user.username),
+                'created_at': comment.created_at.strftime('%d.%m.%Y %H:%M'),
+                'updated_at': comment.updated_at.strftime('%d.%m.%Y %H:%M'),
+                'is_own': True
+            }
+        })
+        response['Content-Security-Policy'] = "default-src 'self'"
+        response['X-Content-Type-Options'] = 'nosniff'
+        return response
+        
+    except json.JSONDecodeError:
+        response = JsonResponse({'error': 'Ungültige Daten'}, status=400)
+        response['Content-Security-Policy'] = "default-src 'self'"
+        response['X-Content-Type-Options'] = 'nosniff'
+        return response
+    except Exception as e:
+        response = JsonResponse({'error': 'Serverfehler'}, status=500)
+        response['Content-Security-Policy'] = "default-src 'self'"
+        response['X-Content-Type-Options'] = 'nosniff'
+        return response
+
+
+@require_POST
+@login_required
+def delete_vorgabe_comment(request, comment_id):
+    """Delete a comment (only own comments or staff can delete)"""
+    comment = get_object_or_404(VorgabeComment, id=comment_id)
+    
+    # Check if user can delete this comment
+    if comment.user != request.user and not request.user.is_staff:
+        response = JsonResponse({'error': 'Keine Berechtigung zum Löschen dieses Kommentars'}, status=403)
+        response['Content-Security-Policy'] = "default-src 'self'"
+        response['X-Content-Type-Options'] = 'nosniff'
+        return response
+    
+    try:
+        comment.delete()
+        response = JsonResponse({'success': True})
+        response['Content-Security-Policy'] = "default-src 'self'"
+        response['X-Content-Type-Options'] = 'nosniff'
+        return response
+    except Exception as e:
+        response = JsonResponse({'error': 'Serverfehler'}, status=500)
+        response['Content-Security-Policy'] = "default-src 'self'"
+        response['X-Content-Type-Options'] = 'nosniff'
+        return response
+
+
+@login_required
+def user_comments(request):
+    """
+    Display all comments made by the logged-in user, grouped by document.
+    """
+    # Get all comments by the current user
+    user_comments = VorgabeComment.objects.filter(
+        user=request.user
+    ).select_related('vorgabe', 'vorgabe__dokument').order_by(
+        'vorgabe__dokument__nummer', '-created_at'
+    )
+    
+    # Group comments by document
+    comments_by_document = {}
+    for comment in user_comments:
+        dokument = comment.vorgabe.dokument
+        if dokument not in comments_by_document:
+            comments_by_document[dokument] = []
+        comments_by_document[dokument].append(comment)
+    
+    return render(request, 'standards/user_comments.html', {
+        'comments_by_document': comments_by_document,
+        'total_comments': user_comments.count(),
+    })
+
+
+@login_required
+@user_passes_test(is_staff_user)
+def all_comments(request):
+    """
+    Display all comments from all users, grouped by document.
+    Staff only.
+    """
+    # Get all comments
+    all_comments_qs = VorgabeComment.objects.select_related(
+        'vorgabe', 'vorgabe__dokument', 'user'
+    ).order_by(
+        'vorgabe__dokument__nummer', '-created_at'
+    )
+    
+    # Group comments by document
+    comments_by_document = {}
+    for comment in all_comments_qs:
+        dokument = comment.vorgabe.dokument
+        if dokument not in comments_by_document:
+            comments_by_document[dokument] = []
+        comments_by_document[dokument].append(comment)
+    
+    return render(request, 'standards/all_comments.html', {
+        'comments_by_document': comments_by_document,
+        'total_comments': all_comments_qs.count(),
+    })

k8s/data-loader-pod.yaml

@@ -7,8 +7,8 @@ spec:
   restartPolicy: Never
   containers:
     - name: loader
-      image: adebaumann/vgui-preloader:0.4
-      command: ["sh","-c","cp -v /preload/preload.sqlite3 /data/db.sqlite3; chown -R 999:999 /data; ls -la /data"]
+      image: adebaumann/vgui-preloader:0.5
+      command: ["sh","-c","cp -v --debug --update=none /preload/preload.sqlite3 /data/db.sqlite3; chown -R 999:999 /data; ls -la /data; exit 0"]
       volumeMounts:
         - name: data
           mountPath: /data

k8s/deployment.yaml

@@ -16,9 +16,16 @@ spec:
       securityContext:
         fsGroup: 999
         fsGroupChangePolicy: "OnRootMismatch"
+      initContainers:
+        - name: loader
+          image: adebaumann/vgui-preloader:0.5
+          command: [ "sh","-c","cp -v --debug --update=none /preload/preload.sqlite3 /data/db.sqlite3; chown -R 999:999 /data; ls -la /data; exit 0" ]
+          volumeMounts:
+            - name: data
+              mountPath: /data
       containers:
-        - name: web
-          image: docker.io/adebaumann/vui:0.917
+         - name: web
+           image: docker.io/adebaumann/vui:0.918
           imagePullPolicy: Always
           ports:
             - containerPort: 8000

k8s/ingress.yaml

@@ -4,7 +4,7 @@ metadata:
   name: django
   namespace: vorgabenui
   annotations:
-    nginx.ingress.kubernetes.io/rewrite-target: /
+    traefik.ingress.kubernetes.io/router.middlewares: "vorgabenui-vorgabenui-rewrite@kubernetescrd"
 spec:
   rules:
     - host: vorgabenui.adebaumann.com

k8s/nfs-pv.yaml

@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: PersistentVolume
+metadata:
+  name: django-data-pv
+  namespace: vorgabenui
+spec:
+  capacity:
+    storage: 2Gi
+  accessModes:
+    - ReadWriteMany
+  persistentVolumeReclaimPolicy: Retain
+  storageClassName: nfs
+  nfs:
+    server: 192.168.17.199
+    path: /mnt/user/vorgabenui

k8s/nfs-storageclass.yaml

@@ -0,0 +1,8 @@
+apiVersion: storage.k8s.io/v1
+kind: StorageClass
+metadata:
+  name: nfs
+provisioner: kubernetes.io/no-provisioner
+allowVolumeExpansion: true
+reclaimPolicy: Retain
+volumeBindingMode: Immediate

k8s/pvc.yaml

@@ -5,7 +5,8 @@ metadata:
   namespace: vorgabenui
 spec:
   accessModes:
-    - ReadWriteOnce
+    - ReadWriteMany
+  storageClassName: nfs
   resources:
     requests:
       storage: 2Gi

k8s/traefik-middleware.yaml

@@ -0,0 +1,9 @@
+apiVersion: traefik.containo.us/v1alpha1
+kind: Middleware
+metadata:
+  name: vorgabenui-rewrite
+  namespace: vorgabenui
+spec:
+  stripPrefix:
+    prefixes:
+      - "/"

openspec/changes/archive/2025-11-24-add-login/tasks.md

@@ -0,0 +1,5 @@
+## 1. Add user login functionality
+- [x] add a login screen for users
+- [x] add an icon for logged in user on the top right corner of all page
+- [x] add a menu to log out and change password on the user icon
+- [x] all functions should go back to the main page, not the django admin page

openspec/project.md

@@ -0,0 +1,63 @@
+# Project Context
+
+## Purpose
+This is a Django-based document management system for regulatory documents (Dokumente) and their provisions (Vorgaben). It manages validity periods, conflicts between overlapping provisions, references, keywords, and roles. The system supports importing documents, checking for compliance, and maintaining changelogs.
+
+## Tech Stack
+- Python 3.x
+- Django 5.2.5
+- SQLite (development), PostgreSQL (production)
+- Django MPTT for tree structures
+- Django Nested Admin for inline editing
+- Kubernetes for deployment
+- ArgoCD for continuous deployment
+- Traefik for ingress
+- Gunicorn for WSGI server
+
+## Project Conventions
+
+### Code Style
+- Language: German for user-facing strings and model names, English for code comments and internal naming
+- Imports: Standard library first, then Django, then third-party, then local apps
+- Model naming: German nouns (Dokument, Vorgabe, Person)
+- Field naming: German for field names, English Django conventions
+- Class naming: PascalCase for models, snake_case for functions/variables
+- All models have __str__ methods returning meaningful German strings
+- Use verbose_name and verbose_name_plural in Meta classes (German)
+
+### Architecture Patterns
+- Django apps: abschnitte, dokumente, referenzen, rollen, stichworte, pages
+- MPTT for hierarchical text sections
+- Foreign keys with on_delete=models.PROTECT for important relationships
+- Many-to-many with descriptive related_name
+- Proxy models for different views (e.g., VorgabenTable)
+- Management commands for data operations
+
+### Testing Strategy
+- Django test framework
+- Test class names in English, methods in English
+- Comprehensive model tests
+- Test both success and error cases
+- Run with `python manage.py test`
+
+### Git Workflow
+- Standard Git workflow
+- Commits in English
+- Use Gitea workflows for CI/CD
+
+## Domain Context
+The system manages regulatory documents with numbered provisions that have validity dates. Provisions can conflict if they have overlapping date ranges for the same document, theme, and number. The system includes sanity checks for conflicts, diagram caching for visualization, and JSON export functionality.
+
+## Important Constraints
+- German language for all user interfaces and data
+- Strict validation of date ranges to prevent overlapping provisions
+- Documents have types, authors, reviewers, and validity periods
+- Provisions linked to themes, references, keywords, and relevant roles
+- Active/inactive status for documents
+
+## External Dependencies
+- Django ecosystem: MPTT, nested-admin, revproxy
+- Kubernetes cluster for deployment
+- ArgoCD for GitOps
+- Traefik for load balancing
+- External diagram services (diagramm_proxy)

pages/templates/base.html

@@ -1,33 +1,236 @@
-
+{% load static %}
 <!DOCTYPE html>
-<html>
+<html lang="de-CH" class="no-js no-ie" itemscope itemtype="http://schema.org/WebPage">
 <head>
   <meta charset="utf-8">
-  <title>{% block title %}{% endblock %}</title>
-  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
-  {% load static %}
+  <meta http-equiv="x-ua-compatible" content="ie=edge">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+
+  <title>{% block title %}Vorgaben Informatiksicherheit{% endblock %} - Schweizerische Eidgenossenschaft</title>
+
+  <!-- Swiss Design System CSS -->
+  <link rel="stylesheet" href="{% static 'swiss/css/vendors.css' %}">
+  <link rel="stylesheet" href="{% static 'swiss/css/admin.css' %}">
+  <link rel="stylesheet" href="{% static 'swiss/css/print.css' %}" media="print">
+
+  <!-- Custom CSS -->
+  <link rel="stylesheet" href="{% static 'custom/css/admin_extras.css' %}">
+
+  <!-- Favicons -->
+  <link rel="shortcut icon" href="{% static 'swiss/img/ico/favicon.ico' %}">
+  <link rel="apple-touch-icon" sizes="57x57" href="{% static 'swiss/img/ico/apple-touch-icon-57x57.png' %}">
+  <link rel="apple-touch-icon" sizes="114x114" href="{% static 'swiss/img/ico/apple-touch-icon-114x114.png' %}">
+  <link rel="icon" type="image/png" href="{% static 'swiss/img/ico/favicon-96x96.png' %}" sizes="96x96">
+  <link rel="icon" type="image/png" href="{% static 'swiss/img/ico/favicon-32x32.png' %}" sizes="32x32">
+  <meta name="msapplication-TileColor" content="#ffffff">
 </head>
 <body>
 
-<nav class="navbar navbar-expand-lg navbar-light bg-light">
-  <a class="navbar-brand" href="#">Vorgaben</a>
-  <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNavAltMarkup" aria-controls="navbarNavAltMarkup" aria-expanded="false" aria-label="Toggle navigation">
-    <span class="navbar-toggler-icon"></span>
-  </button>
-  <div class="collapse navbar-collapse" id="navbarNavAltMarkup">
-    <div class="navbar-nav">
-      <a class="nav-item nav-link active" href="/standards">Standards</a>
-      <a class="nav-item nav-link" href="/referenzen">Referenzen</a>
-      <a class="nav-item nav-link" href="/stichworte">Stichworte</a>
-      <a class="nav-item nav-link" href="/search">Suche</a>
+  <!-- Accessibility skip links -->
+  <ul class="access-keys">
+    <li><a href="/" accesskey="0">Startseite</a></li>
+    <li><a href="#main-navigation" accesskey="1">Hauptnavigation</a></li>
+    <li><a href="#content" accesskey="2">Inhalt</a></li>
+  </ul>
+
+  <!-- Header with Swiss Logo -->
+  <header>
+    <a href="/" class="brand hidden-xs" title="Zur Startseite">
+      <img src="{% static 'swiss/img/logo-CH.svg' %}"
+           onerror="this.onerror=null; this.src='{% static 'swiss/img/logo-CH.png' %}'"
+           alt="Zur Startseite" />
+      <h1>Vorgaben Informatiksicherheit BIT</h1>
+    </a>
+    
+    <!-- User Menu -->
+    {% if user.is_authenticated %}
+    <div class="user-menu" style="position: absolute; top: 20px; right: 20px; z-index: 1000;">
+      <div class="dropdown">
+        <a href="#" class="dropdown-toggle" data-toggle="dropdown" style="text-decoration: none; color: #000; display: flex; align-items: center;">
+          <span style="font-size: 24px; margin-right: 8px;">👤</span>
+	  <span class="hidden-xs" style="margin-left: 0;">{{ user.first_name }} {{ user.last_name }}</span>
+          <span class="caret" style="margin-left: 8px;"></span>
+        </a>
+         <ul class="dropdown-menu dropdown-menu-right" role="menu">
+            <li><a href="{% url 'user_comments' %}">Meine Kommentare</a></li>
+            {% if user.is_staff %}
+            <li><a href="{% url 'all_comments' %}">Alle Kommentare</a></li>
+            {% endif %}
+            <li><a href="{% url 'password_change' %}">Passwort ändern</a></li>
+            <li class="divider"></li>
+            <li>
+              <form method="post" action="{% url 'logout' %}" style="display: inline;">
+                {% csrf_token %}
+                <button type="submit" style="background: none; border: none; color: inherit; padding: 3px 20px; width: 100%; text-align: left; cursor: pointer;">
+                  Abmelden
+                </button>
+              </form>
+            </li>
+          </ul>
+      </div>
+    </div>
+    {% else %}
+    <div class="user-menu" style="position: absolute; top: 20px; right: 20px; z-index: 1000;">
+      <a href="{% url 'login' %}" class="btn btn-sm btn-primary" style="text-decoration: none;">
+        Anmelden
+      </a>
+    </div>
+    {% endif %}
+  </header>
+
+  <!-- Main Navigation -->
+  <nav class="nav-main yamm navbar" id="main-navigation">
+    <h2 class="sr-only">Navigation</h2>
+
+    <!-- Mobile Navigation -->
+    <section class="nav-mobile">
+      <div class="table-row">
+        <div class="nav-mobile-header">
+          <div class="table-row">
+            <span class="nav-mobile-logo">
+              <img src="{% static 'swiss/img/swiss.svg' %}"
+                   onerror="this.onerror=null; this.src='{% static 'swiss/img/swiss.png' %}'"
+                   alt="Schweizerische Eidgenossenschaft" />
+            </span>
+            <h1><a href="/">Vorgaben Informatiksicherheit</a></h1>
+          </div>
+        </div>
+        <div class="table-cell dropdown">
+          <a href="#" class="nav-mobile-menu dropdown-toggle" data-toggle="dropdown">
+            <span class="icon icon--menu"></span>
+          </a>
+          <div class="drilldown dropdown-menu" role="menu">
+            <div class="drilldown-container">
+              <nav class="nav-page-list">
+                <ul>
+                  <li><a href="/dokumente">Standards</a></li>
+                  {% if user.is_staff %}
+                  <li><a href="/dokumente/unvollstaendig/">Unvollständig</a></li>
+                  <li><a href="/autorenumgebung/">Autor</a></li>
+                  {% endif %}
+                  <li><a href="/referenzen">Referenzen</a></li>
+                  <li><a href="/stichworte">Stichworte</a></li>
+                  <li><a href="/search">Suche</a></li>
+                </ul>
+                <a href="#" class="yamm-close-bottom">
+                  <span class="icon icon--top" aria-hidden="true"></span>
+                </a>
+              </nav>
+            </div>
+          </div>
+        </div>
+        <div class="table-cell dropdown">
+          <a href="/search" class="nav-mobile-menu">
+            <span class="icon icon--search"></span>
+          </a>
+        </div>
+      </div>
+    </section>
+
+    <!-- Desktop Tab Navigation -->
+    <ul class="nav navbar-nav">
+      <li class="dropdown {% if request.resolver_match.url_name == 'standard_list' or 'standard' in request.resolver_match.url_name %}current{% endif %}">
+        <a href="/dokumente">Standards</a>
+      </li>
+      {% if user.is_staff %}
+      <li class="dropdown {% if 'unvollstaendig' in request.path %}current{% endif %}">
+        <a href="/dokumente/unvollstaendig/">Unvollständig</a>
+      </li>
+      <li class="dropdown {% if 'autorenumgebung' in request.path %}current{% endif %}">
+        <a href="/autorenumgebung/">Autor</a>
+      </li>
+      {% endif %}
+      <li class="dropdown {% if 'referenzen' in request.path %}current{% endif %}">
+        <a href="/referenzen">Referenzen</a>
+      </li>
+      <li class="dropdown {% if 'stichworte' in request.path %}current{% endif %}">
+        <a href="/stichworte">Stichworte</a>
+      </li>
+      <li class="dropdown {% if 'search' in request.path %}current{% endif %}">
+        <a href="/search">Suche</a>
+      </li>
+    </ul>
+  </nav>
+
+  <!-- Main Content -->
+  <div class="container container-main" id="content" style="padding: 2rem 3rem;">
+    {% if messages %}
+      <div class="row">
+        <div class="col-md-12">
+          {% for message in messages %}
+            <div class="alert alert-{{ message.tags }} alert-dismissible fade show" role="alert">
+              {{ message }}
+              <button type="button" class="close" data-dismiss="alert" aria-label="Schliessen">
+                <span aria-hidden="true">&times;</span>
+              </button>
+            </div>
+          {% endfor %}
+        </div>
+      </div>
+    {% endif %}
+
+    <div class="row">
+      {% block sidebar_left %}
+      {% if block.super or sidebar_left_content %}
+      <div class="col-md-3">
+        <nav class="nav-page-list" aria-label="Seitennavigation">
+          {{ block.super }}
+        </nav>
+      </div>
+      {% endif %}
+      {% endblock %}
+
+      <div class="{% if sidebar_left_content or block.super %}col-md-{% if sidebar_right_content %}6{% else %}9{% endif %}{% else %}col-md-{% if sidebar_right_content %}9{% else %}12{% endif %}{% endif %}">
+        {% block content %}
+        <h2>Inhalt</h2>
+        <p>Hauptinhalt der Seite</p>
+        {% endblock %}
+      </div>
+
+      {% block sidebar_right %}
+      {% if block.super or sidebar_right_content %}
+      <div class="col-md-3">
+        <aside>
+          {{ block.super }}
+        </aside>
+      </div>
+      {% endif %}
+      {% endblock %}
     </div>
   </div>
-</nav>
-<div class="d-flex">
-	<div class="col-md-2">{% block sidebar_left %}{% endblock %}</div>
-    <div class="flex-fill">{% block content %}Main Content{% endblock %}</div>
-    <div class="col-md-2">{% block sidebar_right %}{% endblock %}</div>
-</div>
-<div>VorgabenUI v0.8</div>
+
+  <!-- Footer -->
+  <footer>
+    <div class="container-fluid footer-service">
+      <div class="row">
+        <div class="col-sm-12">
+          <h2 class="sr-only">Fussbereich</h2>
+        </div>
+      </div>
+    </div>
+
+    <div class="container-fluid footer-address">
+      <div class="row">
+        <div class="col-sm-6">
+          <h3>Vorgaben Informatiksicherheit</h3>
+          <p>
+            Bundesamt für Informatik und Telekommunikation BIT<br>
+            <a href="https://www.bit.admin.ch" target="_blank" rel="noopener">www.bit.admin.ch</a>
+          </p>
+        </div>
+        <div class="col-sm-6 text-right">
+           <p class="text-muted">Version {{ version|default:"0.968" }}</p>
+         </div>
+      </div>
+    </div>
+  </footer>
+
+  <!-- Swiss Design System Scripts -->
+  <script src="{% static 'swiss/js/vendors.min.js' %}"></script>
+  <script src="{% static 'swiss/js/main.min.js' %}"></script>
+
+  <!-- Custom Scripts -->
+  {% block extra_js %}{% endblock %}
+
 </body>
 </html>

pages/templates/registration/login.html

@@ -0,0 +1,43 @@
+{% extends "base.html" %}
+{% load static %}
+
+{% block title %}Anmelden{% endblock %}
+
+{% block content %}
+<div class="row">
+  <div class="col-md-4 col-md-offset-4">
+    <div class="panel panel-default">
+      <div class="panel-heading">
+        <h3 class="panel-title">Anmelden</h3>
+      </div>
+      <div class="panel-body">
+        <form method="post">
+          {% csrf_token %}
+          
+          {% if form.errors %}
+            <div class="alert alert-danger">
+              <p>Ihr Benutzername und Passwort stimmen nicht überein. Bitte versuchen Sie es erneut.</p>
+            </div>
+          {% endif %}
+          
+          <div class="form-group">
+            <label for="id_username">Benutzername:</label>
+            <input type="text" name="username" class="form-control" id="id_username" required autofocus>
+          </div>
+          
+          <div class="form-group">
+            <label for="id_password">Passwort:</label>
+            <input type="password" name="password" class="form-control" id="id_password" required>
+          </div>
+          
+          <div class="form-group">
+            <button type="submit" class="btn btn-primary">Anmelden</button>
+          </div>
+          
+          <input type="hidden" name="next" value="{{ next }}">
+        </form>
+      </div>
+    </div>
+  </div>
+</div>
+{% endblock %}

pages/templates/registration/password_change.html

@@ -0,0 +1,56 @@
+{% extends "base.html" %}
+{% load static %}
+
+{% block title %}Passwort ändern{% endblock %}
+
+{% block content %}
+<div class="row">
+  <div class="col-md-6 col-md-offset-3">
+    <div class="panel panel-default">
+      <div class="panel-heading">
+        <h3 class="panel-title">Passwort ändern</h3>
+      </div>
+      <div class="panel-body">
+        <form method="post">
+          {% csrf_token %}
+          
+          {% if form.errors %}
+            <div class="alert alert-danger">
+              <p>Bitte korrigieren Sie die Fehler unten.</p>
+            </div>
+          {% endif %}
+          
+          <div class="form-group">
+            <label for="id_old_password">Aktuelles Passwort:</label>
+            <input type="password" name="old_password" class="form-control" id="id_old_password" required>
+            {% if form.old_password.errors %}
+              <div class="text-danger">{{ form.old_password.errors }}</div>
+            {% endif %}
+          </div>
+          
+          <div class="form-group">
+            <label for="id_new_password1">Neues Passwort:</label>
+            <input type="password" name="new_password1" class="form-control" id="id_new_password1" required>
+            {% if form.new_password1.errors %}
+              <div class="text-danger">{{ form.new_password1.errors }}</div>
+            {% endif %}
+          </div>
+          
+          <div class="form-group">
+            <label for="id_new_password2">Neues Passwort bestätigen:</label>
+            <input type="password" name="new_password2" class="form-control" id="id_new_password2" required>
+            {% if form.new_password2.errors %}
+              <div class="text-danger">{{ form.new_password2.errors }}</div>
+            {% endif %}
+          </div>
+          
+          <div class="form-group">
+            <button type="submit" class="btn btn-primary">Passwort ändern</button>
+            <a href="/" class="btn btn-default">Abbrechen</a>
+          </div>
+        </form>
+      </div>
+    </div>
+  </div>
+</div>
+{% endblock %}

pages/templates/registration/password_change_done.html

@@ -0,0 +1,24 @@
+{% extends "base.html" %}
+{% load static %}
+
+{% block title %}Passwort geändert{% endblock %}
+
+{% block content %}
+<div class="row">
+  <div class="col-md-6 col-md-offset-3">
+    <div class="panel panel-default">
+      <div class="panel-heading">
+        <h3 class="panel-title">Passwort erfolgreich geändert</h3>
+      </div>
+      <div class="panel-body">
+        <div class="alert alert-success">
+          <p>Ihr Passwort wurde erfolgreich geändert.</p>
+        </div>
+        <p>
+          <a href="/" class="btn btn-primary">Zurück zur Startseite</a>
+        </p>
+      </div>
+    </div>
+  </div>
+</div>
+{% endblock %}

pages/templates/results.html

@@ -1,41 +1,80 @@
 {% extends "base.html" %}
 {% load page_extras %}
+
+{% block title %}Suchergebnisse für "{{ suchbegriff }}" - Vorgaben Informatiksicherheit{% endblock %}
+
 {% block content %}
-<h1 class="mb-4">Suchresultate für {{ suchbegriff }}</h1>
-{% if resultat.geltungsbereich %}
-<h2>Standards mit "{{suchbegriff}}" im Geltungsbereich</h2>
-{% for standard,geltungsbereich in resultat.geltungsbereich.items %}
-<h4>{{ standard }}</h4>
-{% for typ, html in geltungsbereich %}
-<div>{{ html|highlighttext:suchbegriff|safe }}</div>
-{% endfor %}
-{% endfor %}
-{% endif %}
+<div class="container-fluid">
+  <h1>Suchergebnisse für "{{ suchbegriff }}"</h1>
 
-{% if resultat.kurztext %}
-    <h2>Vorgaben mit "{{ suchbegriff }}" im Kurztext</h2>
-    {% for standard, vorgaben in resultat.kurztext.items %}
-        <h4>{{ standard }}</h4>
-        <ul>
-            {% for vorgabe in vorgaben %}
-            <li><a href="{% url 'standard_detail' nummer=vorgabe.dokument.nummer %}#{{vorgabe.Vorgabennummer}}">{{vorgabe}}</a></li>
-        {% endfor %}
-        </ul>
-    {% endfor %}
-{% endif %}
+  <div class="row">
+    <div class="col-md-12">
+      <p class="text-muted">
+        <a href="/search" class="icon icon--before icon--less">Neue Suche starten</a>
+      </p>
+    </div>
+  </div>
 
-{% if resultat.langtext %}
-    <h2>Vorgaben mit "{{ suchbegriff }}" im Langtext</h2>
-    {% for standard, vorgaben in resultat.langtext.items %}
-        <h4>{{ standard }}</h4>
-        <ul>
+  {% if resultat.geltungsbereich %}
+  <div class="row">
+    <div class="col-md-12">
+      <h2>Standards mit "{{ suchbegriff }}" im Geltungsbereich</h2>
+
+      {% for standard, geltungsbereich in resultat.geltungsbereich.items %}
+      <div class="card mb-3">
+        <div class="card-header">
+          <h3 class="h4 mb-0">{{ standard }}</h3>
+        </div>
+        <div class="card-body">
+          {% for typ, html in geltungsbereich %}
+          <div class="mb-2">{{ html|highlighttext:suchbegriff|safe }}</div>
+          {% endfor %}
+        </div>
+      </div>
+      {% endfor %}
+    </div>
+  </div>
+  {% endif %}
+
+  {% if resultat.all %}
+  <div class="row">
+    <div class="col-md-12">
+      <h2>Vorgaben mit "{{ suchbegriff }}"</h2>
+
+      {% for standard, vorgaben in resultat.all.items %}
+      <div class="card mb-3">
+        <div class="card-header">
+          <h3 class="h4 mb-0">{{ standard }}</h3>
+        </div>
+        <div class="card-body">
+          <ul class="list-unstyled">
             {% for vorgabe in vorgaben %}
-            <li><a href="{% url 'standard_detail' nummer=vorgabe.dokument.nummer %}#{{vorgabe.Vorgabennummer}}">{{vorgabe}}</a></li>
-        {% endfor %}
-        </ul>
-    {% endfor %}
-{% endif %}
-{% if not resultat.langtext and not resultat.kurztext and not resultat.geltungsbereich %}
-    <h2>Keine Resultate für "{{suchbegriff}}"</h2>
-{% endif %}
+            <li class="mb-2">
+              <a href="{% url 'standard_detail' nummer=vorgabe.dokument.nummer %}#{{ vorgabe.Vorgabennummer }}"
+                 class="icon icon--before icon--external">
+                {{ vorgabe }}
+              </a>
+            </li>
+            {% endfor %}
+          </ul>
+        </div>
+      </div>
+      {% endfor %}
+    </div>
+  </div>
+  {% endif %}
+
+  {% if not resultat.all and not resultat.geltungsbereich %}
+  <div class="row">
+    <div class="col-md-12">
+      <div class="alert alert-warning" role="alert">
+        <span class="icon icon--warning" aria-hidden="true"></span>
+        <strong>Keine Ergebnisse gefunden</strong>
+        <p>Für den Suchbegriff "{{ suchbegriff }}" wurden keine Resultate gefunden.</p>
+        <p>Versuchen Sie es mit einem anderen Suchbegriff oder verwenden Sie weniger spezifische Begriffe.</p>
+      </div>
+    </div>
+  </div>
+  {% endif %}
+</div>
 {% endblock %}

pages/templates/search.html

@@ -1,41 +1,60 @@
 {% extends "base.html" %}
+
+{% block title %}Suche - Vorgaben Informatiksicherheit{% endblock %}
+
 {% block content %}
- <h1 class="mb-4">Suche</h1>
+<div class="container-fluid">
+  <h1>Suche in den Vorgaben</h1>
 
-    <!--  Search form  -->
-    <form action="." method="post">
-      {% csrf_token %}
-      <!-- Search field -->
-      <div class="mb-3">
-        <label for="query" class="form-label">Suchbegriff</label>
-        <input type="text"
-               class="form-control"
-               id="query"
-               name="q"
-               placeholder="Suchbegriff eingeben …"
-               required>
+  {% if error_message %}
+  <div class="alert alert-danger" role="alert">
+    <span class="icon icon--error" aria-hidden="true"></span>
+    <strong>Fehler:</strong> {{ error_message }}
+  </div>
+  {% endif %}
+
+  <div class="row">
+    <div class="col-md-8">
+      <!-- Search form -->
+      <form action="." method="post" class="form-horizontal">
+        {% csrf_token %}
+
+        <div class="form-group">
+          <label for="query" class="control-label">Suchbegriff</label>
+          <div class="input-group">
+            <input type="text"
+                   class="form-control"
+                   id="query"
+                   name="q"
+                   placeholder="Suchbegriff eingeben …"
+                   value="{{ search_term|default:'' }}"
+                   required
+                   maxlength="200"
+                   aria-describedby="search-help">
+            <span class="input-group-btn">
+              <button type="submit" class="btn btn-primary">
+                <span class="icon icon--search" aria-hidden="true"></span>
+                Suchen
+              </button>
+            </span>
+          </div>
+          <small id="search-help" class="form-text text-muted">
+            Durchsuchen Sie Standards, Vorgaben und Referenzen nach Stichworten.
+          </small>
+        </div>
+      </form>
+    </div>
+
+    <div class="col-md-4">
+      <div class="alert alert-info" role="alert">
+        <h3 class="h4">Suchtipps</h3>
+        <ul>
+          <li>Verwenden Sie spezifische Begriffe für bessere Ergebnisse</li>
+          <li>Die Suche erfasst Titel, Beschreibungen und Inhalte</li>
+          <li>Groß-/Kleinschreibung wird nicht berücksichtigt</li>
+        </ul>
       </div>
-
-      <!-- Check-box group -->
-      <fieldset class="mb-4">
-        <legend class="h6 mb-2">In folgenden Bereichen suchen:</legend>
-
-        <div class="form-check">
-          <input class="form-check-input" type="checkbox" value="kurztext" id="kurztext" name="suchbereich[]" checked>
-          <label class="form-check-label" for="kurztext">Kurztext</label>
-        </div>
-
-        <div class="form-check">
-          <input class="form-check-input" type="checkbox" value="langtext" id="langtext" name="suchbereich[]" checked>
-          <label class="form-check-label" for="langtext">Langtext</label>
-        </div>
-
-        <div class="form-check">
-          <input class="form-check-input" type="checkbox" value="geltungsbereich" id="geltungsbereich" name="suchbereich[]">
-          <label class="form-check-label" for="geltungsbereich">Geltungsbereich</label>
-        </div>
-      </fieldset>
-
-      <button type="submit" class="btn btn-primary">Suchen</button>
-    </form>
-   {% endblock %}
+    </div>
+  </div>
+</div>
+{% endblock %}

pages/templates/startseite.html

@@ -1,10 +1,77 @@
 {% extends "base.html" %}
+
+{% block title %}Startseite - Vorgaben Informatiksicherheit{% endblock %}
+
 {% block content %}
-<h1>Vorgaben Informatiksicherheit BIT</h1>
-<h2>Aktuell erfasste Standards</h2>
-<ul>
-    {% for standard in standards %}
-    <li><a href="{% url 'standard_detail' nummer=standard.nummer %}">{{ standard }}</a></li>
-    {% endfor %}
-</ul>
+<div class="container-fluid">
+  <h1>Vorgaben Informatiksicherheit BIT</h1>
+
+  <div class="row">
+    <div class="col-md-12">
+      <p class="lead">
+        Willkommen bei den Vorgaben zur Informatiksicherheit des Bundesamts für Informatik und Telekommunikation (BIT).
+        Diese Plattform bietet Ihnen Zugang zu allen aktuellen IT-Sicherheitsstandards der Bundesverwaltung.
+      </p>
+    </div>
+  </div>
+
+  <div class="row">
+    <div class="col-md-12">
+      <h2>Aktuell erfasste Standards</h2>
+
+      <div class="list-group">
+        {% for standard in dokumente %}
+        <a href="{% url 'standard_detail' nummer=standard.nummer %}"
+           class="list-group-item list-group-item-action">
+          <div class="d-flex w-100 justify-content-between">
+            <h3 class="h5 mb-1">{{ standard.nummer }} - {{ standard.name }}</h3>
+            {% if standard.status %}
+            <small class="text-muted">{{ standard.status }}</small>
+            {% endif %}
+          </div>
+          {% if standard.kurzbeschreibung %}
+          <p class="mb-1">{{ standard.kurzbeschreibung|truncatewords:30 }}</p>
+          {% endif %}
+        </a>
+        {% empty %}
+        <div class="alert alert-info" role="alert">
+          <p class="icon icon--info">Aktuell sind keine Standards erfasst.</p>
+        </div>
+        {% endfor %}
+      </div>
+    </div>
+  </div>
+
+  <div class="row mt-4">
+    <div class="col-md-4">
+      <div class="card">
+        <div class="card-body">
+          <h3 class="card-title h4">Standards durchsuchen</h3>
+          <p class="card-text">Durchsuchen Sie alle Vorgaben nach Stichworten und Inhalten.</p>
+          <a href="/search" class="btn btn-primary">Zur Suche</a>
+        </div>
+      </div>
+    </div>
+
+    <div class="col-md-4">
+      <div class="card">
+        <div class="card-body">
+          <h3 class="card-title h4">Referenzen</h3>
+          <p class="card-text">Übersicht über externe Referenzen und Normen.</p>
+          <a href="/referenzen" class="btn btn-secondary">Referenzen anzeigen</a>
+        </div>
+      </div>
+    </div>
+
+    <div class="col-md-4">
+      <div class="card">
+        <div class="card-body">
+          <h3 class="card-title h4">Stichworte</h3>
+          <p class="card-text">Alphabetische Übersicht aller Schlagworte und Kategorien.</p>
+          <a href="/stichworte" class="btn btn-secondary">Stichworte durchsuchen</a>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
 {% endblock %}

pages/test_auth.py

@@ -0,0 +1,266 @@
+from django.test import TestCase, Client
+from django.contrib.auth.models import User
+from django.urls import reverse
+from django.core.exceptions import ValidationError
+
+
+class AuthenticationTest(TestCase):
+    """Test login, logout, and password change functionality"""
+    
+    def setUp(self):
+        self.client = Client()
+        self.test_user = User.objects.create_user(
+            username='testuser',
+            password='testpass123',
+            email='test@example.com'
+        )
+        self.staff_user = User.objects.create_user(
+            username='staffuser',
+            password='staffpass123',
+            email='staff@example.com'
+        )
+        self.staff_user.is_staff = True
+        self.staff_user.save()
+    
+    def test_login_page_loads(self):
+        """Test that login page loads correctly"""
+        response = self.client.get(reverse('login'))
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Anmelden')
+        self.assertContains(response, 'Benutzername:')
+        self.assertContains(response, 'Passwort:')
+    
+    def test_login_valid_credentials(self):
+        """Test successful login with valid credentials"""
+        response = self.client.post(reverse('login'), {
+            'username': 'testuser',
+            'password': 'testpass123'
+        })
+        self.assertEqual(response.status_code, 302)  # Redirect after login
+        self.assertRedirects(response, '/')  # Should redirect to main page
+        
+        # Check user is logged in
+        response = self.client.get('/')
+        self.assertContains(response, 'testuser')  # Username should appear in header
+    
+    def test_login_invalid_credentials(self):
+        """Test login with invalid credentials shows error"""
+        response = self.client.post(reverse('login'), {
+            'username': 'testuser',
+            'password': 'wrongpassword'
+        })
+        self.assertEqual(response.status_code, 200)  # Stay on login page
+        self.assertContains(response, 'Ihr Benutzername und Passwort stimmen nicht überein')
+    
+    def test_login_empty_credentials(self):
+        """Test login with empty credentials"""
+        response = self.client.post(reverse('login'), {
+            'username': '',
+            'password': ''
+        })
+        self.assertEqual(response.status_code, 200)  # Stay on login page
+        # Django's form validation should handle this
+    
+    def test_logout_functionality(self):
+        """Test logout functionality"""
+        # First login
+        self.client.login(username='testuser', password='testpass123')
+        
+        # Verify user is logged in
+        response = self.client.get('/')
+        self.assertContains(response, 'testuser')
+        
+        # Logout using POST
+        response = self.client.post(reverse('logout'))
+        self.assertEqual(response.status_code, 302)  # Redirect after logout
+        self.assertRedirects(response, '/')  # Should redirect to main page
+        
+        # Verify user is logged out
+        response = self.client.get('/')
+        self.assertNotContains(response, 'testuser')
+        self.assertContains(response, 'Anmelden')  # Should show login link
+    
+    def test_logout_requires_post(self):
+        """Test that logout requires POST method"""
+        # Login first
+        self.client.login(username='testuser', password='testpass123')
+        
+        # Try GET logout (should fail with 405)
+        response = self.client.get(reverse('logout'))
+        self.assertEqual(response.status_code, 405)  # Method Not Allowed
+        
+        # User should still be logged in
+        response = self.client.get('/')
+        self.assertContains(response, 'testuser')
+    
+    def test_password_change_page_loads(self):
+        """Test that password change page loads for authenticated users"""
+        self.client.login(username='testuser', password='testpass123')
+        
+        response = self.client.get(reverse('password_change'))
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Passwort ändern')
+        self.assertContains(response, 'Aktuelles Passwort:')
+        self.assertContains(response, 'Neues Passwort:')
+        self.assertContains(response, 'Neues Passwort bestätigen:')
+    
+    def test_password_change_requires_authentication(self):
+        """Test that password change page requires authentication"""
+        response = self.client.get(reverse('password_change'))
+        self.assertEqual(response.status_code, 302)  # Redirect to login
+        
+        # Should redirect to login page
+        self.assertIn(reverse('login'), response.url)
+    
+    def test_password_change_valid(self):
+        """Test successful password change"""
+        self.client.login(username='testuser', password='testpass123')
+        
+        response = self.client.post(reverse('password_change'), {
+            'old_password': 'testpass123',
+            'new_password1': 'newpass456',
+            'new_password2': 'newpass456'
+        })
+        self.assertEqual(response.status_code, 302)  # Redirect after success
+        self.assertRedirects(response, '/')  # Should redirect to main page
+        
+        # Verify new password works
+        self.client.logout()
+        response = self.client.post(reverse('login'), {
+            'username': 'testuser',
+            'password': 'newpass456'
+        })
+        self.assertEqual(response.status_code, 302)  # Successful login
+    
+    def test_password_change_wrong_old_password(self):
+        """Test password change with wrong old password"""
+        self.client.login(username='testuser', password='testpass123')
+        
+        response = self.client.post(reverse('password_change'), {
+            'old_password': 'wrongpassword',
+            'new_password1': 'newpass456',
+            'new_password2': 'newpass456'
+        })
+        self.assertEqual(response.status_code, 200)  # Stay on form page
+        self.assertContains(response, 'Bitte korrigieren Sie die Fehler unten')
+    
+    def test_password_change_mismatched_new_passwords(self):
+        """Test password change with mismatched new passwords"""
+        self.client.login(username='testuser', password='testpass123')
+        
+        response = self.client.post(reverse('password_change'), {
+            'old_password': 'testpass123',
+            'new_password1': 'newpass456',
+            'new_password2': 'differentpass789'
+        })
+        self.assertEqual(response.status_code, 200)  # Stay on form page
+        self.assertContains(response, 'Bitte korrigieren Sie die Fehler unten')
+    
+    def test_password_change_same_as_old_password(self):
+        """Test password change with same password as old"""
+        self.client.login(username='testuser', password='testpass123')
+        
+        response = self.client.post(reverse('password_change'), {
+            'old_password': 'testpass123',
+            'new_password1': 'testpass123',
+            'new_password2': 'testpass123'
+        })
+        # Django's default validators don't prevent same password, so it should succeed
+        self.assertEqual(response.status_code, 302)  # Redirect after success
+        self.assertRedirects(response, '/')  # Should redirect to main page
+    
+    def test_password_change_cancel_button(self):
+        """Test password change cancel button"""
+        self.client.login(username='testuser', password='testpass123')
+        
+        response = self.client.get(reverse('password_change'))
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Abbrechen')
+        # The cancel button should link to main page
+        self.assertContains(response, 'href="/"')
+    
+    def test_user_menu_display_for_authenticated_user(self):
+        """Test that user menu displays correctly for authenticated users"""
+        self.client.login(username='testuser', password='testpass123')
+        
+        response = self.client.get('/')
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'testuser')  # Username in menu
+        self.assertContains(response, 'Passwort ändern')  # Password change link
+        self.assertContains(response, 'Abmelden')  # Logout link
+        self.assertNotContains(response, 'Anmelden')  # Should not show login link
+    
+    def test_login_link_display_for_anonymous_user(self):
+        """Test that login link displays for anonymous users"""
+        response = self.client.get('/')
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Anmelden')  # Should show login link
+        self.assertNotContains(response, 'testuser')  # Should not show username
+        self.assertNotContains(response, 'Passwort ändern')  # Should not show password change
+        self.assertNotContains(response, 'Abmelden')  # Should not show logout
+    
+    def test_staff_user_menu(self):
+        """Test that staff users see appropriate menu"""
+        self.client.login(username='staffuser', password='staffpass123')
+        
+        response = self.client.get('/')
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'staffuser')  # Username in menu
+        self.assertContains(response, 'Passwort ändern')  # Password change link
+        self.assertContains(response, 'Abmelden')  # Logout link
+    
+    def test_login_redirect_to_main_page(self):
+        """Test that successful login redirects to main page"""
+        response = self.client.post(reverse('login'), {
+            'username': 'testuser',
+            'password': 'testpass123'
+        }, follow=True)
+        self.assertEqual(response.status_code, 200)
+        # Should end up on main page
+        self.assertContains(response, 'Vorgaben Informatiksicherheit')
+    
+    def test_logout_redirect_to_main_page(self):
+        """Test that logout redirects to main page"""
+        self.client.login(username='testuser', password='testpass123')
+        
+        response = self.client.post(reverse('logout'), follow=True)
+        self.assertEqual(response.status_code, 200)
+        # Should end up on main page
+        self.assertContains(response, 'Vorgaben Informatiksicherheit')
+        # Should show login link for anonymous users
+        self.assertContains(response, 'Anmelden')
+    
+    def test_password_change_redirect_to_main_page(self):
+        """Test that successful password change redirects to main page"""
+        self.client.login(username='testuser', password='testpass123')
+        
+        response = self.client.post(reverse('password_change'), {
+            'old_password': 'testpass123',
+            'new_password1': 'newpass456',
+            'new_password2': 'newpass456'
+        }, follow=True)
+        self.assertEqual(response.status_code, 200)
+        # Should end up on main page
+        self.assertContains(response, 'Vorgaben Informatiksicherheit')
+    
+    def test_csrf_token_present_in_forms(self):
+        """Test that CSRF tokens are present in authentication forms"""
+        # Login form
+        response = self.client.get(reverse('login'))
+        self.assertContains(response, 'csrfmiddlewaretoken')
+        
+        # Password change form
+        self.client.login(username='testuser', password='testpass123')
+        response = self.client.get(reverse('password_change'))
+        self.assertContains(response, 'csrfmiddlewaretoken')
+    
+    def test_login_with_next_parameter(self):
+        """Test login with next parameter for redirect"""
+        response = self.client.post(reverse('login'), {
+            'username': 'testuser',
+            'password': 'testpass123',
+            'next': '/dokumente/'
+        })
+        self.assertEqual(response.status_code, 302)
+        # Should redirect to the specified next page
+        self.assertRedirects(response, '/dokumente/')

pages/tests.py

@@ -0,0 +1,310 @@
+from django.test import TestCase, Client
+from django.core.exceptions import ValidationError
+from django.utils import timezone
+from datetime import date, timedelta
+from dokumente.models import Dokument, Vorgabe, VorgabeKurztext, VorgabeLangtext, Geltungsbereich, Dokumententyp, Thema
+from stichworte.models import Stichwort
+import re
+
+
+class SearchViewTest(TestCase):
+    def setUp(self):
+        self.client = Client()
+        
+        # Create test data
+        self.dokumententyp = Dokumententyp.objects.create(
+            name="Test Typ",
+            verantwortliche_ve="Test VE"
+        )
+        
+        self.thema = Thema.objects.create(
+            name="Test Thema",
+            erklaerung="Test Erklärung"
+        )
+        
+        self.dokument = Dokument.objects.create(
+            nummer="TEST-001",
+            dokumententyp=self.dokumententyp,
+            name="Test Dokument",
+            gueltigkeit_von=date.today(),
+            aktiv=True
+        )
+        
+        self.vorgabe = Vorgabe.objects.create(
+            order=1,
+            nummer=1,
+            dokument=self.dokument,
+            thema=self.thema,
+            titel="Test Vorgabe Titel",
+            gueltigkeit_von=date.today()
+        )
+        
+        # Create text content
+        self.kurztext = VorgabeKurztext.objects.create(
+            abschnitt=self.vorgabe,
+            inhalt="Dies ist ein Test Kurztext mit Suchbegriff"
+        )
+        
+        self.langtext = VorgabeLangtext.objects.create(
+            abschnitt=self.vorgabe,
+            inhalt="Dies ist ein Test Langtext mit anderem Suchbegriff"
+        )
+        
+        self.geltungsbereich = Geltungsbereich.objects.create(
+            geltungsbereich=self.dokument,
+            inhalt="Test Geltungsbereich mit Suchbegriff"
+        )
+    
+    def test_search_get_request(self):
+        """Test GET request returns search form"""
+        response = self.client.get('/search/')
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Suche')
+        self.assertContains(response, 'Suchbegriff')
+    
+    def test_search_post_valid_term(self):
+        """Test POST request with valid search term"""
+        response = self.client.post('/search/', {'q': 'Test'})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Suchergebnisse')
+    
+    def test_search_case_insensitive(self):
+        """Test that search is case insensitive"""
+        # Search for lowercase
+        response = self.client.post('/search/', {'q': 'test'})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Suchergebnisse für "test"')
+        
+        # Search for uppercase
+        response = self.client.post('/search/', {'q': 'TEST'})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Suchergebnisse für "TEST"')
+        
+        # Search for mixed case
+        response = self.client.post('/search/', {'q': 'TeSt'})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Suchergebnisse für "TeSt"')
+    
+    def test_search_in_kurztext(self):
+        """Test search in Kurztext content"""
+        response = self.client.post('/search/', {'q': 'Suchbegriff'})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'TEST-001')
+    
+    def test_search_in_langtext(self):
+        """Test search in Langtext content"""
+        response = self.client.post('/search/', {'q': 'anderem'})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'TEST-001')
+    
+    def test_search_in_titel(self):
+        """Test search in Vorgabe title"""
+        response = self.client.post('/search/', {'q': 'Titel'})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'TEST-001')
+    
+    def test_search_in_geltungsbereich(self):
+        """Test search in Geltungsbereich content"""
+        response = self.client.post('/search/', {'q': 'Geltungsbereich'})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Standards mit')
+    
+    def test_search_no_results(self):
+        """Test search with no results"""
+        response = self.client.post('/search/', {'q': 'NichtVorhanden'})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Keine Ergebnisse gefunden')
+    
+    def test_search_expired_vorgabe_not_included(self):
+        """Test that expired Vorgaben are not included in results"""
+        # Create expired Vorgabe
+        expired_vorgabe = Vorgabe.objects.create(
+            order=2,
+            nummer=2,
+            dokument=self.dokument,
+            thema=self.thema,
+            titel="Abgelaufene Vorgabe",
+            gueltigkeit_von=date.today() - timedelta(days=10),
+            gueltigkeit_bis=date.today() - timedelta(days=1)
+        )
+        
+        VorgabeKurztext.objects.create(
+            abschnitt=expired_vorgabe,
+            inhalt="Abgelaufener Inhalt mit Test"
+        )
+        
+        response = self.client.post('/search/', {'q': 'Test'})
+        self.assertEqual(response.status_code, 200)
+        
+        # Should only find the active Vorgabe, not the expired one
+        self.assertContains(response, 'Test Vorgabe Titel')
+        # The expired vorgabe should not appear in results
+        self.assertNotContains(response, 'Abgelaufene Vorgabe')
+    
+    def test_search_empty_term_validation(self):
+        """Test validation for empty search term"""
+        response = self.client.post('/search/', {'q': ''})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Fehler:')
+        self.assertContains(response, 'Suchbegriff darf nicht leer sein')
+    
+    def test_search_no_term_validation(self):
+        """Test validation when no search term is provided"""
+        response = self.client.post('/search/', {})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Fehler:')
+        self.assertContains(response, 'Suchbegriff darf nicht leer sein')
+    
+    def test_search_html_tags_stripped(self):
+        """Test that HTML tags are stripped from search input"""
+        response = self.client.post('/search/', {'q': '<script>alert("xss")</script>Test'})
+        self.assertEqual(response.status_code, 200)
+        # Should search for "alert("xss")Test" after HTML tag removal
+        self.assertContains(response, 'Suchergebnisse für "alert')
+    
+    def test_search_invalid_characters_validation(self):
+        """Test validation for invalid characters"""
+        response = self.client.post('/search/', {'q': 'Test| DROP TABLE users'})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Fehler:')
+        self.assertContains(response, 'Ungültige Zeichen im Suchbegriff')
+    
+    def test_search_too_long_validation(self):
+        """Test validation for overly long search terms"""
+        long_term = 'a' * 201  # 201 characters, exceeds limit of 200
+        response = self.client.post('/search/', {'q': long_term})
+        self.assertEqual(response.status_code, 200)
+        self.assertContains(response, 'Fehler:')
+        self.assertContains(response, 'Suchbegriff ist zu lang')
+    
+    def test_search_max_length_allowed(self):
+        """Test that exactly 200 characters are allowed"""
+        max_term = 'a' * 200  # Exactly 200 characters
+        response = self.client.post('/search/', {'q': max_term})
+        self.assertEqual(response.status_code, 200)
+        # Should not show validation error
+        self.assertNotContains(response, 'Fehler:')
+    
+    def test_search_german_umlauts_allowed(self):
+        """Test that German umlauts are allowed in search"""
+        response = self.client.post('/search/', {'q': 'Test Müller äöü ÄÖÜ ß'})
+        self.assertEqual(response.status_code, 200)
+        # Should not show validation error
+        self.assertNotContains(response, 'Fehler:')
+    
+    def test_search_special_characters_allowed(self):
+        """Test that allowed special characters work"""
+        response = self.client.post('/search/', {'q': 'Test-Test, Test: Test; Test! Test? (Test) [Test] {Test} "Test" \'Test\''})
+        self.assertEqual(response.status_code, 200)
+        # Should not show validation error
+        self.assertNotContains(response, 'Fehler:')
+    
+    def test_search_input_preserved_on_error(self):
+        """Test that search input is preserved on validation errors"""
+        response = self.client.post('/search/', {'q': '<script>Test</script>'})
+        self.assertEqual(response.status_code, 200)
+        # The input should be preserved (escaped) in the form
+        # Since HTML tags are stripped, we expect "Test" to be searched
+        self.assertContains(response, 'Suchergebnisse für "Test"')
+    
+    def test_search_xss_prevention_in_results(self):
+        """Test that search terms are escaped in results to prevent XSS"""
+        # Create content with potential XSS
+        self.kurztext.inhalt = "Content with <script>alert('xss')</script> term"
+        self.kurztext.save()
+        
+        response = self.client.post('/search/', {'q': 'term'})
+        self.assertEqual(response.status_code, 200)
+        # The script tag should be escaped in the output
+        # Note: This depends on how the template renders the content
+        self.assertContains(response, 'Suchergebnisse für "term"')
+    
+    def test_search_result_structure(self):
+        """Test that search results have expected structure"""
+        response = self.client.post('/search/', {'q': 'Test'})
+        self.assertEqual(response.status_code, 200)
+        # Verify the results page is rendered with correct structure
+        self.assertContains(response, 'Suchergebnisse für "Test"')
+    
+    def test_search_multiple_documents(self):
+        """Test search across multiple documents"""
+        # Create second document
+        dokument2 = Dokument.objects.create(
+            nummer="TEST-002",
+            dokumententyp=self.dokumententyp,
+            name="Zweites Test Dokument",
+            gueltigkeit_von=date.today(),
+            aktiv=True
+        )
+        
+        vorgabe2 = Vorgabe.objects.create(
+            order=1,
+            nummer=1,
+            dokument=dokument2,
+            thema=self.thema,
+            titel="Zweite Test Vorgabe",
+            gueltigkeit_von=date.today()
+        )
+        
+        VorgabeKurztext.objects.create(
+            abschnitt=vorgabe2,
+            inhalt="Zweiter Test Inhalt"
+        )
+        
+        response = self.client.post('/search/', {'q': 'Test'})
+        self.assertEqual(response.status_code, 200)
+        # Should find results from both documents
+        self.assertContains(response, 'TEST-001')
+        self.assertContains(response, 'TEST-002')
+
+
+class SearchValidationTest(TestCase):
+    """Test the validate_search_input function directly"""
+    
+    def test_validate_search_input_valid(self):
+        """Test valid search input"""
+        from pages.views import validate_search_input
+        
+        result = validate_search_input("Test Suchbegriff")
+        self.assertEqual(result, "Test Suchbegriff")
+    
+    def test_validate_search_input_empty(self):
+        """Test empty search input"""
+        from pages.views import validate_search_input
+        
+        with self.assertRaises(ValidationError) as context:
+            validate_search_input("")
+        
+        self.assertIn("Suchbegriff darf nicht leer sein", str(context.exception))
+    
+    def test_validate_search_input_html_stripped(self):
+        """Test that HTML tags are stripped"""
+        from pages.views import validate_search_input
+        
+        result = validate_search_input("<script>alert('xss')</script>Test")
+        self.assertEqual(result, "alert('xss')Test")
+    
+    def test_validate_search_input_invalid_chars(self):
+        """Test validation of invalid characters"""
+        from pages.views import validate_search_input
+        
+        with self.assertRaises(ValidationError) as context:
+            validate_search_input("Test| DROP TABLE users")
+        
+        self.assertIn("Ungültige Zeichen im Suchbegriff", str(context.exception))
+    
+    def test_validate_search_input_too_long(self):
+        """Test length validation"""
+        from pages.views import validate_search_input
+        
+        with self.assertRaises(ValidationError) as context:
+            validate_search_input("a" * 201)
+        
+        self.assertIn("Suchbegriff ist zu lang", str(context.exception))
+    
+    def test_validate_search_input_whitespace_stripped(self):
+        """Test that whitespace is stripped"""
+        from pages.views import validate_search_input
+        
+        result = validate_search_input("  Test Suchbegriff  ")
+        self.assertEqual(result, "Test Suchbegriff")

pages/views.py

@@ -1,34 +1,71 @@
 from django.shortcuts import render
+from django.core.exceptions import ValidationError
+from django.utils.html import escape
+import re
 from abschnitte.utils import render_textabschnitte
-from standards.models import Standard, VorgabeLangtext, VorgabeKurztext, Geltungsbereich
+from dokumente.models import Dokument, VorgabeLangtext, VorgabeKurztext, Geltungsbereich, Vorgabe
 from itertools import groupby
 import datetime
 
+
 def startseite(request):
-    standards=list(Standard.objects.all())
-    return render(request, 'startseite.html', {"standards":standards,})
+    standards=list(Dokument.objects.filter(aktiv=True))
+    return render(request, 'startseite.html', {"dokumente":standards,})
+
+def validate_search_input(search_term):
+    """
+    Validate search input to prevent SQL injection and XSS
+    """
+    if not search_term:
+        raise ValidationError("Suchbegriff darf nicht leer sein")
+    
+    # Remove any HTML tags to prevent XSS
+    search_term = re.sub(r'<[^>]*>', '', search_term)
+    
+    # Allow only alphanumeric characters, spaces, and basic punctuation
+    # This prevents SQL injection and other malicious input while allowing useful characters
+    if not re.match(r'^[a-zA-Z0-9äöüÄÖÜß\s\-\.\,\:\;\!\?\(\)\[\]\{\}\"\']+$', search_term):
+        raise ValidationError("Ungültige Zeichen im Suchbegriff")
+    
+    # Limit length to prevent DoS attacks
+    if len(search_term) > 200:
+        raise ValidationError("Suchbegriff ist zu lang")
+    
+    return search_term.strip()
 
 def search(request):
     if request.method == "GET":
         return render(request, 'search.html')
     elif request.method == "POST":
-        suchbegriff=request.POST.get("q")
-        areas=request.POST.getlist("suchbereich[]")
-        result= {}
-        geltungsbereich=set()
-        if "kurztext" in areas:
-            qs = VorgabeKurztext.objects.filter(inhalt__contains=suchbegriff).exclude(abschnitt__gueltigkeit_bis__lt=datetime.date.today())
-            result["kurztext"] = {k: [o.abschnitt for o in g] for k, g in groupby(qs, key=lambda o: o.abschnitt.dokument)}
-        if "langtext" in areas:
-            qs = VorgabeLangtext.objects.filter(inhalt__contains=suchbegriff).exclude(abschnitt__gueltigkeit_bis__lt=datetime.date.today())
-            result['langtext']=  {k: [o.abschnitt for o in g] for k, g in groupby(qs, key=lambda o: o.abschnitt.dokument)}
-        if "geltungsbereich" in areas:
-            result["geltungsbereich"]={}
-            geltungsbereich=set(list([x.geltungsbereich for x in Geltungsbereich.objects.filter(inhalt__contains=suchbegriff)]))
-        for s in geltungsbereich:
-            result["geltungsbereich"][s]=render_textabschnitte(s.geltungsbereich_set.order_by("order"))
+        raw_search_term = request.POST.get("q", "")
+        
+        try:
+            suchbegriff = validate_search_input(raw_search_term)
+        except ValidationError as e:
+            return render(request, 'search.html', {
+                'error_message': str(e),
+                'search_term': escape(raw_search_term)
+            })
+        
+        # Escape the search term for display in templates
+        safe_search_term = escape(suchbegriff)
+        result= {"all": {}}
+        qs = VorgabeKurztext.objects.filter(inhalt__icontains=suchbegriff).exclude(abschnitt__gueltigkeit_bis__lt=datetime.date.today())
+        result["kurztext"] = {k: [o.abschnitt for o in g] for k, g in groupby(qs, key=lambda o: o.abschnitt.dokument)}
+        qs = VorgabeLangtext.objects.filter(inhalt__icontains=suchbegriff).exclude(abschnitt__gueltigkeit_bis__lt=datetime.date.today())
+        result['langtext']=  {k: [o.abschnitt for o in g] for k, g in groupby(qs, key=lambda o: o.abschnitt.dokument)}
+        qs = Vorgabe.objects.filter(titel__icontains=suchbegriff).exclude(gueltigkeit_bis__lt=datetime.date.today())
+        result['titel']= {k: list(g) for k, g in groupby(qs, key=lambda o: o.dokument)}
         for r in result.keys():
             for s in result[r].keys():
-                result[r][s]=set(result[r][s])
-        return render(request,"results.html",{"suchbegriff":suchbegriff,"resultat":result})
+                if r == 'titel':
+                    result["all"][s] = set(result["all"].get(s, set()) | set(result[r][s]))
+                else:
+                    result["all"][s] = set(result["all"].get(s, set()) | set(result[r][s]))
+        result["geltungsbereich"]={}
+        geltungsbereich=set(list([x.geltungsbereich for x in Geltungsbereich.objects.filter(inhalt__icontains=suchbegriff)]))
+        for s in geltungsbereich:
+            result["geltungsbereich"][s]=render_textabschnitte(s.geltungsbereich_set.order_by("order"))
+
+        return render(request,"results.html",{"suchbegriff":safe_search_term,"resultat":result})
 

referenzen/admin.py

@@ -1,4 +1,5 @@
 from django.contrib import admin
+from django.utils.html import format_html
 from nested_admin import NestedStackedInline, NestedModelAdmin, NestedTabularInline
 from .models import *
 
@@ -11,6 +12,50 @@ class ReferenzerklaerungInline(NestedStackedInline):
 
 @admin.register(Referenz)
 class ReferenzAdmin(NestedModelAdmin):
+    list_display = ('Path', 'vorgaben_count')
     inlines=[ReferenzerklaerungInline]
-    list_display =['Path']
-    search_fields=("referenz",)
+    search_fields=("name_nummer","Path")
+    readonly_fields=("vorgaben_list",)
+    fieldsets = (
+        (None, {
+            'fields': ('name_nummer','name_text','oberreferenz','url', 'vorgaben_list')
+        }),
+    )
+
+    def vorgaben_count(self, obj):
+        """Count the number of Vorgaben that have this Stichwort"""
+        count = obj.vorgabe_set.count()
+        return f"{count} Vorgabe{'n' if count != 1 else ''}"
+    vorgaben_count.short_description = "Anzahl Vorgaben"
+
+    def vorgaben_list(self, obj):
+        """Display list of Vorgaben that use this Stichwort"""
+        vorgaben = obj.vorgabe_set.order_by('dokument__nummer', 'nummer')
+        vorgaben_list = list(vorgaben)  # Evaluate queryset once
+        count = len(vorgaben_list)
+        if count == 0:
+            return format_html("<em>Keine Vorgaben gefunden</em><p><strong>Gesamt: 0 Vorgaben</strong></p>")
+
+        html = "<div style='max-height: 300px; overflow-y: auto;'>"
+        html += "<table style='width: 100%; border-collapse: collapse;'>"
+        html += "<thead><tr style='background-color: #f5f5f5;'>"
+        html += "<th style='padding: 8px; border: 1px solid #ddd; text-align: left;'>Vorgabe</th>"
+        html += "<th style='padding: 8px; border: 1px solid #ddd; text-align: left;'>Titel</th>"
+        html += "<th style='padding: 8px; border: 1px solid #ddd; text-align: left;'>Dokument</th>"
+        html += "</tr></thead>"
+        html += "<tbody>"
+
+        for vorgabe in vorgaben_list:
+            html += "<tr>"
+            html += f"<td style='padding: 6px; border: 1px solid #ddd;'>{vorgabe.Vorgabennummer()}</td>"
+            html += f"<td style='padding: 6px; border: 1px solid #ddd;'>{vorgabe.titel}</td>"
+            html += f"<td style='padding: 6px; border: 1px solid #ddd;'>{vorgabe.dokument.nummer} – {vorgabe.dokument.name}</td>"
+            html += "</tr>"
+
+        html += "</tbody></table>"
+        html += f"</div><p><strong>Gesamt: {count} Vorgabe{'n' if count != 1 else ''}</strong></p>"
+
+        return format_html(html)
+
+    vorgaben_list.short_description = "Zugeordnete Vorgaben"
+

referenzen/migrations/0003_alter_referenzerklaerung_options.py

@@ -0,0 +1,17 @@
+# Generated by Django 5.2.5 on 2025-11-27 22:02
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('referenzen', '0002_alter_referenz_table_alter_referenzerklaerung_table'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='referenzerklaerung',
+            options={'verbose_name': 'Erklärung', 'verbose_name_plural': 'Erklärungen'},
+        ),
+    ]

referenzen/models.py

@@ -31,3 +31,4 @@ class Referenzerklaerung (Textabschnitt):
 
     class Meta:
         verbose_name="Erklärung"
+        verbose_name_plural="Erklärungen"

referenzen/templates/referenz_detail.html

@@ -1,51 +1,92 @@
 {% extends "base.html" %}
 {% load mptt_tags %}
+
+{% block title %}{{ referenz.Path }} - Referenzen{% endblock %}
+
 {% block content %}
-<h1><a href="../{{ referenz.ParentID }}">⭡</a>{{ referenz.Path }}</h1>
-{% if referenz.erklaerung %}
-  <div class="card mb-4">
-    <div class="card-header d-flex justify-content-between align-items-center bg-secondary text-light">
-      <h3 class="h5 m-0">Beschreibung</h3>
-      {% if referenz.url %}
-      <span class="badge bg-light text-black">
-        <a href="{{ referenz.url }}">Link</a>
-      </span>{% endif %}
-    </div>
+<div class="container-fluid">
+  <nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+      <li class="breadcrumb-item"><a href="/">Startseite</a></li>
+      <li class="breadcrumb-item"><a href="/referenzen">Referenzen</a></li>
+      {% if referenz.ParentID %}
+      <li class="breadcrumb-item"><a href="../{{ referenz.ParentID }}">Übergeordnet</a></li>
+      {% endif %}
+      <li class="breadcrumb-item active" aria-current="page">{{ referenz.name_nummer }}</li>
+    </ol>
+  </nav>
 
-    <div class="card-body p-2">
-        {% for typ, html in referenz.erklaerung %}
-        {% if html %}<div>{{ html|safe }}</div>{% endif %}{% endfor %}
+  <h1>{{ referenz.Path }}</h1>
+
+  {% if referenz.url %}
+  <p>
+    <a href="{{ referenz.url }}" class="btn btn-secondary icon icon--before icon--external" target="_blank" rel="noopener">
+      Externe Referenz öffnen
+    </a>
+  </p>
+  {% endif %}
+
+  {% if referenz.erklaerung %}
+  <div class="row">
+    <div class="col-md-12">
+      <div class="card mb-4">
+        <div class="card-header">
+          <h2 class="h4 mb-0">Beschreibung</h2>
+        </div>
+        <div class="card-body">
+          {% for typ, html in referenz.erklaerung %}
+          {% if html %}
+          <div class="mb-2">{{ html|safe }}</div>
+          {% endif %}
+          {% endfor %}
+        </div>
+      </div>
     </div>
   </div>
-{% endif %}
+  {% endif %}
 
- <div class="card mb-4">
-    <div class="card-header d-flex justify-content-between align-items-center bg-secondary text-light">
-      <h3 class="h5 m-0">Referenzierte Vorgaben</h3>
-    </div>
-
-    <div class="card-body p-2">
-      {% recursetree referenz.children %}
-            {% if not node == referenz %}
-                {#<a href="../{{node.id}}">#}
-                    {{ node.Path }}
-                {#</a>#}
-            {% else %}
+  <div class="row">
+    <div class="col-md-12">
+      <div class="card mb-4">
+        <div class="card-header">
+          <h2 class="h4 mb-0">Referenzierte Vorgaben</h2>
+        </div>
+        <div class="card-body">
+          <div class="referenz-tree">
+            {% recursetree referenz.children %}
+            <div class="mb-3">
+              <strong>
+                {% if not node == referenz %}
+                <a href="../{{ node.id }}">{{ node.Path }}</a>
+                {% else %}
                 {{ node.Path }}
-            {% endif %}
-        <br>
-            {% if node.referenziertvon %}
-                <ul>
+                {% endif %}
+              </strong>
+
+              {% if node.referenziertvon %}
+              <ul class="list-unstyled mt-2 ml-3">
                 {% for ref in node.referenziertvon %}
-                    <li><a href="{% url 'standard_detail' nummer=ref.dokument.nummer %}#{{ref.Vorgabennummer}}">{{ref}}</a></li>
+                <li class="mb-1">
+                  <a href="{% url 'standard_detail' nummer=ref.dokument.nummer %}#{{ ref.Vorgabennummer }}"
+                     class="icon icon--before icon--external">
+                    {{ ref }}
+                  </a>
+                </li>
                 {% endfor %}
-                </ul>
-                <br>
-            {% endif %}
-            {% if not node.is_leaf_node %}
+              </ul>
+              {% endif %}
+
+              {% if not node.is_leaf_node %}
+              <div class="ml-4 mt-2">
                 {{ children }}
-            {% endif %}
-    {% endrecursetree %}
+              </div>
+              {% endif %}
+            </div>
+            {% endrecursetree %}
+          </div>
+        </div>
+      </div>
     </div>
   </div>
+</div>
 {% endblock %}

referenzen/templates/referenz_tree.html

@@ -1,21 +1,39 @@
 {% extends "base.html" %}
+{% load mptt_tags %}
+
+{% block title %}Referenzen - Vorgaben Informatiksicherheit{% endblock %}
 
 {% block content %}
-<h1>Referenzen</h1>
+<div class="container-fluid">
+  <h1>Referenzen</h1>
+  <p class="lead">Hierarchische Übersicht externer Referenzen und Normen</p>
 
-<div>
-{% load mptt_tags %}
-<ul class="tree">
-    {% recursetree referenzen %}
-        <li>
-            <a href="{{node.id}}">{{ node.name_nummer }}{% if node.name_text %} ({{node.name_text}}){% endif %}</a>
-            {% if not node.is_leaf_node %}
-                <ul class="children">
-                    {{ children }}
+  <div class="row">
+    <div class="col-md-12">
+      <div class="card">
+        <div class="card-body">
+          <nav aria-label="Referenzen-Hierarchie">
+            <ul class="nav nav-page-list">
+              {% recursetree referenzen %}
+              <li>
+                <a href="{{ node.id }}">
+                  <strong>{{ node.name_nummer }}</strong>
+                  {% if node.name_text %}
+                  <span class="text-muted"> - {{ node.name_text }}</span>
+                  {% endif %}
+                </a>
+                {% if not node.is_leaf_node %}
+                <ul class="nav nav-page-list">
+                  {{ children }}
                 </ul>
-            {% endif %}
-        </li>
-    {% endrecursetree %}
-</ul>
+                {% endif %}
+              </li>
+              {% endrecursetree %}
+            </ul>
+          </nav>
+        </div>
+      </div>
+    </div>
+  </div>
 </div>
 {% endblock %}

referenzen/tests.py

@@ -1,3 +1,398 @@
 from django.test import TestCase
+from django.core.exceptions import ValidationError
+from .models import Referenz, Referenzerklaerung
+from abschnitte.models import AbschnittTyp
 
-# Create your tests here.
+
+class ReferenzModelTest(TestCase):
+    """Test cases for Referenz model"""
+    
+    def setUp(self):
+        """Set up test data"""
+        self.referenz = Referenz.objects.create(
+            name_nummer="ISO-27001",
+            name_text="Information Security Management",
+            url="https://www.iso.org/isoiec-27001-information-security.html"
+        )
+    
+    def test_referenz_creation(self):
+        """Test that Referenz is created correctly"""
+        self.assertEqual(self.referenz.name_nummer, "ISO-27001")
+        self.assertEqual(self.referenz.name_text, "Information Security Management")
+        self.assertEqual(self.referenz.url, "https://www.iso.org/isoiec-27001-information-security.html")
+        self.assertIsNone(self.referenz.oberreferenz)
+    
+    def test_referenz_str(self):
+        """Test string representation of Referenz"""
+        self.assertEqual(str(self.referenz), "ISO-27001")
+    
+    def test_referenz_verbose_name_plural(self):
+        """Test verbose name plural"""
+        self.assertEqual(
+            Referenz._meta.verbose_name_plural,
+            "Referenzen"
+        )
+    
+    def test_referenz_path_method(self):
+        """Test Path method for root reference"""
+        path = self.referenz.Path()
+        self.assertEqual(path, "ISO-27001 (Information Security Management)")
+    
+    def test_referenz_path_without_name_text(self):
+        """Test Path method when name_text is empty"""
+        referenz_no_text = Referenz.objects.create(
+            name_nummer="NIST-800-53"
+        )
+        path = referenz_no_text.Path()
+        self.assertEqual(path, "NIST-800-53")
+    
+    def test_referenz_blank_fields(self):
+        """Test that optional fields can be blank"""
+        referenz_minimal = Referenz.objects.create(
+            name_nummer="TEST-001"
+        )
+        self.assertEqual(referenz_minimal.name_text, "")
+        self.assertEqual(referenz_minimal.url, "")
+        self.assertIsNone(referenz_minimal.oberreferenz)
+    
+    def test_referenz_max_lengths(self):
+        """Test max_length constraints"""
+        max_name_nummer = "a" * 100
+        max_name_text = "b" * 255
+        
+        referenz = Referenz.objects.create(
+            name_nummer=max_name_nummer,
+            name_text=max_name_text
+        )
+        
+        self.assertEqual(referenz.name_nummer, max_name_nummer)
+        self.assertEqual(referenz.name_text, max_name_text)
+    
+    def test_create_multiple_references(self):
+        """Test creating multiple Referenz objects"""
+        references = [
+            ("ISO-9001", "Quality Management"),
+            ("ISO-14001", "Environmental Management"),
+            ("ISO-45001", "Occupational Health and Safety")
+        ]
+        
+        for name_nummer, name_text in references:
+            Referenz.objects.create(
+                name_nummer=name_nummer,
+                name_text=name_text
+            )
+        
+        self.assertEqual(Referenz.objects.count(), 4)  # Including setUp referenz
+
+
+class ReferenzHierarchyTest(TestCase):
+    """Test cases for Referenz hierarchy using MPTT"""
+    
+    def setUp(self):
+        """Set up hierarchical test data"""
+        # Create root references
+        self.iso_root = Referenz.objects.create(
+            name_nummer="ISO",
+            name_text="International Organization for Standardization"
+        )
+        
+        self.iso_27000_series = Referenz.objects.create(
+            name_nummer="ISO-27000",
+            name_text="Information Security Management System Family",
+            oberreferenz=self.iso_root
+        )
+        
+        self.iso_27001 = Referenz.objects.create(
+            name_nummer="ISO-27001",
+            name_text="Information Security Management",
+            oberreferenz=self.iso_27000_series
+        )
+        
+        self.iso_27002 = Referenz.objects.create(
+            name_nummer="ISO-27002",
+            name_text="Code of Practice for Information Security Controls",
+            oberreferenz=self.iso_27000_series
+        )
+    
+    def test_hierarchy_relationships(self):
+        """Test parent-child relationships"""
+        self.assertEqual(self.iso_27000_series.oberreferenz, self.iso_root)
+        self.assertEqual(self.iso_27001.oberreferenz, self.iso_27000_series)
+        self.assertEqual(self.iso_27002.oberreferenz, self.iso_27000_series)
+    
+    def test_get_ancestors(self):
+        """Test getting ancestors"""
+        ancestors = self.iso_27001.get_ancestors()
+        expected_ancestors = [self.iso_root, self.iso_27000_series]
+        self.assertEqual(list(ancestors), expected_ancestors)
+    
+    def test_get_ancestors_include_self(self):
+        """Test getting ancestors including self"""
+        ancestors = self.iso_27001.get_ancestors(include_self=True)
+        expected_ancestors = [self.iso_root, self.iso_27000_series, self.iso_27001]
+        self.assertEqual(list(ancestors), expected_ancestors)
+    
+    def test_get_descendants(self):
+        """Test getting descendants"""
+        descendants = self.iso_27000_series.get_descendants()
+        expected_descendants = [self.iso_27001, self.iso_27002]
+        self.assertEqual(list(descendants), expected_descendants)
+    
+    def test_get_children(self):
+        """Test getting direct children"""
+        children = self.iso_27000_series.get_children()
+        expected_children = [self.iso_27001, self.iso_27002]
+        self.assertEqual(list(children), expected_children)
+    
+    def test_get_root(self):
+        """Test getting root of hierarchy"""
+        root = self.iso_27001.get_root()
+        self.assertEqual(root, self.iso_root)
+    
+    def test_is_root(self):
+        """Test is_root method"""
+        self.assertTrue(self.iso_root.is_root_node())
+        self.assertFalse(self.iso_27001.is_root_node())
+    
+    def test_is_leaf(self):
+        """Test is_leaf method"""
+        self.assertFalse(self.iso_root.is_leaf_node())
+        self.assertFalse(self.iso_27000_series.is_leaf_node())
+        self.assertTrue(self.iso_27001.is_leaf_node())
+        self.assertTrue(self.iso_27002.is_leaf_node())
+    
+    def test_level_property(self):
+        """Test level property"""
+        self.assertEqual(self.iso_root.level, 0)
+        self.assertEqual(self.iso_27000_series.level, 1)
+        self.assertEqual(self.iso_27001.level, 2)
+        self.assertEqual(self.iso_27002.level, 2)
+    
+    def test_path_method_with_hierarchy(self):
+        """Test Path method with hierarchical references"""
+        path = self.iso_27001.Path()
+        expected_path = "ISO → ISO-27000 → ISO-27001 (Information Security Management)"
+        self.assertEqual(path, expected_path)
+    
+    def test_path_method_without_name_text_in_hierarchy(self):
+        """Test Path method when intermediate nodes have no name_text"""
+        # Create reference without name_text
+        ref_no_text = Referenz.objects.create(
+            name_nummer="NO-TEXT",
+            oberreferenz=self.iso_root
+        )
+        
+        child_ref = Referenz.objects.create(
+            name_nummer="CHILD",
+            name_text="Child Reference",
+            oberreferenz=ref_no_text
+        )
+        
+        path = child_ref.Path()
+        expected_path = "ISO → NO-TEXT → CHILD (Child Reference)"
+        self.assertEqual(path, expected_path)
+    
+    def test_order_insertion_by(self):
+        """Test that references are ordered by name_nummer"""
+        # Create more children in different order
+        ref_c = Referenz.objects.create(
+            name_nummer="C-REF",
+            oberreferenz=self.iso_root
+        )
+        ref_a = Referenz.objects.create(
+            name_nummer="A-REF", 
+            oberreferenz=self.iso_root
+        )
+        ref_b = Referenz.objects.create(
+            name_nummer="B-REF",
+            oberreferenz=self.iso_root
+        )
+        
+        children = list(self.iso_root.get_children())
+        # Should be ordered alphabetically by name_nummer
+        expected_order = [ref_a, ref_b, ref_c, self.iso_27000_series]
+        self.assertEqual(children, expected_order)
+
+
+class ReferenzerklaerungModelTest(TestCase):
+    """Test cases for Referenzerklaerung model"""
+    
+    def setUp(self):
+        """Set up test data"""
+        self.referenz = Referenz.objects.create(
+            name_nummer="ISO-27001",
+            name_text="Information Security Management"
+        )
+        self.abschnitttyp = AbschnittTyp.objects.create(
+            abschnitttyp="text"
+        )
+        self.erklaerung = Referenzerklaerung.objects.create(
+            erklaerung=self.referenz,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Dies ist eine Erklärung für ISO-27001.",
+            order=1
+        )
+    
+    def test_referenzerklaerung_creation(self):
+        """Test that Referenzerklaerung is created correctly"""
+        self.assertEqual(self.erklaerung.erklaerung, self.referenz)
+        self.assertEqual(self.erklaerung.abschnitttyp, self.abschnitttyp)
+        self.assertEqual(self.erklaerung.inhalt, "Dies ist eine Erklärung für ISO-27001.")
+        self.assertEqual(self.erklaerung.order, 1)
+    
+    def test_referenzerklaerung_foreign_key_relationship(self):
+        """Test foreign key relationship to Referenz"""
+        self.assertEqual(self.erklaerung.erklaerung.name_nummer, "ISO-27001")
+        self.assertEqual(self.erklaerung.erklaerung.name_text, "Information Security Management")
+    
+    def test_referenzerklaerung_cascade_delete(self):
+        """Test that deleting Referenz cascades to Referenzerklaerung"""
+        referenz_count = Referenz.objects.count()
+        erklaerung_count = Referenzerklaerung.objects.count()
+        
+        self.referenz.delete()
+        
+        self.assertEqual(Referenz.objects.count(), referenz_count - 1)
+        self.assertEqual(Referenzerklaerung.objects.count(), erklaerung_count - 1)
+    
+    def test_referenzerklaerung_verbose_name(self):
+        """Test verbose name"""
+        self.assertEqual(
+            Referenzerklaerung._meta.verbose_name,
+            "Erklärung"
+        )
+    
+    def test_referenzerklaerung_multiple_explanations(self):
+        """Test creating multiple explanations for one Referenz"""
+        abschnitttyp2 = AbschnittTyp.objects.create(abschnitttyp="liste ungeordnet")
+        erklaerung2 = Referenzerklaerung.objects.create(
+            erklaerung=self.referenz,
+            abschnitttyp=abschnitttyp2,
+            inhalt="Zweite Erklärung für ISO-27001.",
+            order=2
+        )
+        
+        explanations = Referenzerklaerung.objects.filter(erklaerung=self.referenz)
+        self.assertEqual(explanations.count(), 2)
+        self.assertIn(self.erklaerung, explanations)
+        self.assertIn(erklaerung2, explanations)
+    
+    def test_referenzerklaerung_ordering(self):
+        """Test that explanations can be ordered"""
+        erklaerung2 = Referenzerklaerung.objects.create(
+            erklaerung=self.referenz,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Zweite Erklärung",
+            order=3
+        )
+        erklaerung3 = Referenzerklaerung.objects.create(
+            erklaerung=self.referenz,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Erste Erklärung",
+            order=2
+        )
+        
+        ordered = Referenzerklaerung.objects.filter(erklaerung=self.referenz).order_by('order')
+        expected_order = [self.erklaerung, erklaerung3, erklaerung2]
+        self.assertEqual(list(ordered), expected_order)
+    
+    def test_referenzerklaerung_blank_fields(self):
+        """Test that optional fields can be blank/null"""
+        referenz2 = Referenz.objects.create(name_nummer="TEST-001")
+        erklaerung_blank = Referenzerklaerung.objects.create(
+            erklaerung=referenz2
+        )
+        
+        self.assertIsNone(erklaerung_blank.abschnitttyp)
+        self.assertIsNone(erklaerung_blank.inhalt)
+        self.assertEqual(erklaerung_blank.order, 0)
+    
+    def test_referenzerklaerung_inheritance(self):
+        """Test that Referenzerklaerung inherits from Textabschnitt"""
+        # Check that it has the expected fields from Textabschnitt
+        self.assertTrue(hasattr(self.erklaerung, 'abschnitttyp'))
+        self.assertTrue(hasattr(self.erklaerung, 'inhalt'))
+        self.assertTrue(hasattr(self.erklaerung, 'order'))
+        
+        # Check that the fields work as expected
+        self.assertIsInstance(self.erklaerung.abschnitttyp, AbschnittTyp)
+        self.assertIsInstance(self.erklaerung.inhalt, str)
+        self.assertIsInstance(self.erklaerung.order, int)
+
+
+class ReferenzIntegrationTest(TestCase):
+    """Integration tests for Referenz app"""
+    
+    def setUp(self):
+        """Set up test data"""
+        self.root_ref = Referenz.objects.create(
+            name_nummer="ROOT",
+            name_text="Root Reference"
+        )
+        
+        self.child_ref = Referenz.objects.create(
+            name_nummer="CHILD",
+            name_text="Child Reference",
+            oberreferenz=self.root_ref
+        )
+        
+        self.abschnitttyp = AbschnittTyp.objects.create(abschnitttyp="text")
+        
+        self.erklaerung = Referenzerklaerung.objects.create(
+            erklaerung=self.child_ref,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Explanation for child reference",
+            order=1
+        )
+    
+    def test_reference_with_explanations_query(self):
+        """Test querying references with their explanations"""
+        references_with_explanations = Referenz.objects.filter(
+            referenzerklaerung__isnull=False
+        ).distinct()
+        
+        self.assertEqual(references_with_explanations.count(), 1)
+        self.assertIn(self.child_ref, references_with_explanations)
+        self.assertNotIn(self.root_ref, references_with_explanations)
+    
+    def test_reference_without_explanations(self):
+        """Test finding references without explanations"""
+        references_without_explanations = Referenz.objects.filter(
+            referenzerklaerung__isnull=True
+        )
+        
+        self.assertEqual(references_without_explanations.count(), 1)
+        self.assertEqual(references_without_explanations.first(), self.root_ref)
+    
+    def test_explanation_count_annotation(self):
+        """Test annotating references with explanation count"""
+        from django.db.models import Count
+        
+        references_with_count = Referenz.objects.annotate(
+            explanation_count=Count('referenzerklaerung')
+        )
+        
+        for reference in references_with_count:
+            if reference == self.child_ref:
+                self.assertEqual(reference.explanation_count, 1)
+            else:
+                self.assertEqual(reference.explanation_count, 0)
+    
+    def test_hierarchy_with_explanations(self):
+        """Test that explanations work correctly with hierarchical references"""
+        # Add explanation to root reference
+        root_erklaerung = Referenzerklaerung.objects.create(
+            erklaerung=self.root_ref,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Explanation for root reference",
+            order=1
+        )
+        
+        # Both references should now have explanations
+        references_with_explanations = Referenz.objects.filter(
+            referenzerklaerung__isnull=False
+        ).distinct()
+        
+        self.assertEqual(references_with_explanations.count(), 2)
+        self.assertIn(self.root_ref, references_with_explanations)
+        self.assertIn(self.child_ref, references_with_explanations)

requirements.txt

@@ -5,8 +5,8 @@ certifi==2025.8.3
 charset-normalizer==3.4.3
 curtsies==0.4.3
 cwcwidth==0.1.10
-Django==5.2.5
-django-debug-toolbar==6.0.0
+Django==5.2.8
+django-admin-sortable2==2.2.8
 django-js-asset==3.1.2
 django-mptt==0.17.0
 django-mptt-admin==2.8.0
@@ -32,3 +32,5 @@ six==1.17.0
 sqlparse==0.5.3
 urllib3==2.5.0
 wcwidth==0.2.13
+bleach==6.1.0
+coverage==7.6.1

rollen/tests.py

@@ -1,3 +1,367 @@
 from django.test import TestCase
+from django.core.exceptions import ValidationError
+from django.db.models import Count
+from .models import Rolle, RollenBeschreibung
+from abschnitte.models import AbschnittTyp
 
-# Create your tests here.
+
+class RolleModelTest(TestCase):
+    """Test cases for Rolle model"""
+    
+    def setUp(self):
+        """Set up test data"""
+        self.rolle = Rolle.objects.create(
+            name="Systemadministrator"
+        )
+    
+    def test_rolle_creation(self):
+        """Test that Rolle is created correctly"""
+        self.assertEqual(self.rolle.name, "Systemadministrator")
+    
+    def test_rolle_str(self):
+        """Test string representation of Rolle"""
+        self.assertEqual(str(self.rolle), "Systemadministrator")
+    
+    def test_rolle_primary_key(self):
+        """Test that name field is the primary key"""
+        pk_field = Rolle._meta.pk
+        self.assertEqual(pk_field.name, 'name')
+        self.assertEqual(pk_field.max_length, 100)
+    
+    def test_rolle_verbose_name_plural(self):
+        """Test verbose name plural"""
+        self.assertEqual(
+            Rolle._meta.verbose_name_plural,
+            "Rollen"
+        )
+    
+    def test_rolle_max_length(self):
+        """Test max_length constraint"""
+        max_length_rolle = "a" * 100
+        rolle = Rolle.objects.create(name=max_length_rolle)
+        self.assertEqual(rolle.name, max_length_rolle)
+    
+    def test_rolle_unique(self):
+        """Test that name must be unique"""
+        with self.assertRaises(Exception):
+            Rolle.objects.create(name="Systemadministrator")
+    
+    def test_create_multiple_rollen(self):
+        """Test creating multiple Rolle objects"""
+        rollen = [
+            "Datenschutzbeauftragter",
+            "IT-Sicherheitsbeauftragter", 
+            "Risikomanager",
+            "Compliance-Officer"
+        ]
+        for rolle_name in rollen:
+            Rolle.objects.create(name=rolle_name)
+        
+        self.assertEqual(Rolle.objects.count(), 5)  # Including setUp rolle
+    
+    def test_rolle_case_sensitivity(self):
+        """Test that role name is case sensitive"""
+        rolle_lower = Rolle.objects.create(name="systemadministrator")
+        self.assertNotEqual(self.rolle.pk, rolle_lower.pk)
+        self.assertEqual(Rolle.objects.count(), 2)
+    
+    def test_rolle_with_special_characters(self):
+        """Test creating roles with special characters"""
+        special_roles = [
+            "IT-Administrator",
+            "CISO (Chief Information Security Officer)",
+            "Datenschutz-Beauftragter/-in",
+            "Sicherheitsbeauftragter"
+        ]
+        
+        for role_name in special_roles:
+            rolle = Rolle.objects.create(name=role_name)
+            self.assertEqual(rolle.name, role_name)
+        
+        self.assertEqual(Rolle.objects.count(), 5)  # Including setUp rolle
+
+
+class RollenBeschreibungModelTest(TestCase):
+    """Test cases for RollenBeschreibung model"""
+    
+    def setUp(self):
+        """Set up test data"""
+        self.rolle = Rolle.objects.create(
+            name="Systemadministrator"
+        )
+        self.abschnitttyp = AbschnittTyp.objects.create(
+            abschnitttyp="text"
+        )
+        self.beschreibung = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Der Systemadministrator ist für die Verwaltung und Wartung der IT-Systeme verantwortlich.",
+            order=1
+        )
+    
+    def test_rollenbeschreibung_creation(self):
+        """Test that RollenBeschreibung is created correctly"""
+        self.assertEqual(self.beschreibung.abschnitt, self.rolle)
+        self.assertEqual(self.beschreibung.abschnitttyp, self.abschnitttyp)
+        self.assertEqual(self.beschreibung.inhalt, "Der Systemadministrator ist für die Verwaltung und Wartung der IT-Systeme verantwortlich.")
+        self.assertEqual(self.beschreibung.order, 1)
+    
+    def test_rollenbeschreibung_foreign_key_relationship(self):
+        """Test foreign key relationship to Rolle"""
+        self.assertEqual(self.beschreibung.abschnitt.name, "Systemadministrator")
+    
+    def test_rollenbeschreibung_cascade_delete(self):
+        """Test that deleting Rolle cascades to RollenBeschreibung"""
+        rolle_count = Rolle.objects.count()
+        beschreibung_count = RollenBeschreibung.objects.count()
+        
+        self.rolle.delete()
+        
+        self.assertEqual(Rolle.objects.count(), rolle_count - 1)
+        self.assertEqual(RollenBeschreibung.objects.count(), beschreibung_count - 1)
+    
+    def test_rollenbeschreibung_verbose_names(self):
+        """Test verbose names"""
+        self.assertEqual(
+            RollenBeschreibung._meta.verbose_name,
+            "Rollenbeschreibungs-Abschnitt"
+        )
+        self.assertEqual(
+            RollenBeschreibung._meta.verbose_name_plural,
+            "Rollenbeschreibung"
+        )
+    
+    def test_rollenbeschreibung_multiple_descriptions(self):
+        """Test creating multiple descriptions for one Rolle"""
+        abschnitttyp2 = AbschnittTyp.objects.create(abschnitttyp="liste ungeordnet")
+        beschreibung2 = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle,
+            abschnitttyp=abschnitttyp2,
+            inhalt="Aufgaben:\n- Systemüberwachung\n- Backup-Management\n- Benutzeradministration",
+            order=2
+        )
+        
+        descriptions = RollenBeschreibung.objects.filter(abschnitt=self.rolle)
+        self.assertEqual(descriptions.count(), 2)
+        self.assertIn(self.beschreibung, descriptions)
+        self.assertIn(beschreibung2, descriptions)
+    
+    def test_rollenbeschreibung_ordering(self):
+        """Test that descriptions can be ordered"""
+        beschreibung2 = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Zweite Beschreibung",
+            order=3
+        )
+        beschreibung3 = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Erste Beschreibung",
+            order=2
+        )
+        
+        ordered = RollenBeschreibung.objects.filter(abschnitt=self.rolle).order_by('order')
+        expected_order = [self.beschreibung, beschreibung3, beschreibung2]
+        self.assertEqual(list(ordered), expected_order)
+    
+    def test_rollenbeschreibung_blank_fields(self):
+        """Test that optional fields can be blank/null"""
+        rolle2 = Rolle.objects.create(name="Testrolle")
+        beschreibung_blank = RollenBeschreibung.objects.create(
+            abschnitt=rolle2
+        )
+        
+        self.assertIsNone(beschreibung_blank.abschnitttyp)
+        self.assertIsNone(beschreibung_blank.inhalt)
+        self.assertEqual(beschreibung_blank.order, 0)
+    
+    def test_rollenbeschreibung_inheritance(self):
+        """Test that RollenBeschreibung inherits from Textabschnitt"""
+        # Check that it has the expected fields from Textabschnitt
+        self.assertTrue(hasattr(self.beschreibung, 'abschnitttyp'))
+        self.assertTrue(hasattr(self.beschreibung, 'inhalt'))
+        self.assertTrue(hasattr(self.beschreibung, 'order'))
+        
+        # Check that the fields work as expected
+        self.assertIsInstance(self.beschreibung.abschnitttyp, AbschnittTyp)
+        self.assertIsInstance(self.beschreibung.inhalt, str)
+        self.assertIsInstance(self.beschreibung.order, int)
+    
+    def test_rollenbeschreibung_different_types(self):
+        """Test creating descriptions with different section types"""
+        # Create different section types
+        typ_list = AbschnittTyp.objects.create(abschnitttyp="liste ungeordnet")
+        typ_table = AbschnittTyp.objects.create(abschnitttyp="tabelle")
+        
+        # Create descriptions with different types
+        beschreibung_text = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Textbeschreibung der Rolle",
+            order=1
+        )
+        
+        beschreibung_list = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle,
+            abschnitttyp=typ_list,
+            inhalt="Aufgabe 1\nAufgabe 2\nAufgabe 3",
+            order=2
+        )
+        
+        beschreibung_table = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle,
+            abschnitttyp=typ_table,
+            inhalt="| Verantwortung | Priorität |\n|--------------|------------|\n| Systemwartung | Hoch |",
+            order=3
+        )
+        
+        # Verify all descriptions are created
+        descriptions = RollenBeschreibung.objects.filter(abschnitt=self.rolle)
+        self.assertEqual(descriptions.count(), 4)  # Including setUp beschreibung
+        
+        # Verify types are correct
+        self.assertEqual(beschreibung_text.abschnitttyp, self.abschnitttyp)
+        self.assertEqual(beschreibung_list.abschnitttyp, typ_list)
+        self.assertEqual(beschreibung_table.abschnitttyp, typ_table)
+
+
+class RolleIntegrationTest(TestCase):
+    """Integration tests for Rolle app"""
+    
+    def setUp(self):
+        """Set up test data"""
+        self.rolle1 = Rolle.objects.create(name="IT-Sicherheitsbeauftragter")
+        self.rolle2 = Rolle.objects.create(name="Datenschutzbeauftragter")
+        
+        self.abschnitttyp = AbschnittTyp.objects.create(abschnitttyp="text")
+        
+        self.beschreibung1 = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle1,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Beschreibung für IT-Sicherheitsbeauftragten",
+            order=1
+        )
+        
+        self.beschreibung2 = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle2,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Beschreibung für Datenschutzbeauftragten",
+            order=1
+        )
+    
+    def test_rolle_with_descriptions_query(self):
+        """Test querying Rollen with their descriptions"""
+        rollen_with_descriptions = Rolle.objects.filter(
+            rollenbeschreibung__isnull=False
+        ).distinct()
+        
+        self.assertEqual(rollen_with_descriptions.count(), 2)
+        self.assertIn(self.rolle1, rollen_with_descriptions)
+        self.assertIn(self.rolle2, rollen_with_descriptions)
+    
+    def test_rolle_without_descriptions(self):
+        """Test finding Rollen without descriptions"""
+        rolle3 = Rolle.objects.create(name="Compliance-Officer")
+        
+        rollen_without_descriptions = Rolle.objects.filter(
+            rollenbeschreibung__isnull=True
+        )
+        
+        self.assertEqual(rollen_without_descriptions.count(), 1)
+        self.assertEqual(rollen_without_descriptions.first(), rolle3)
+    
+    def test_description_count_annotation(self):
+        """Test annotating Rollen with description count"""
+        from django.db.models import Count
+        
+        rollen_with_count = Rolle.objects.annotate(
+            description_count=Count('rollenbeschreibung')
+        )
+        
+        for rolle in rollen_with_count:
+            if rolle.name in ["IT-Sicherheitsbeauftragter", "Datenschutzbeauftragter"]:
+                self.assertEqual(rolle.description_count, 1)
+            else:
+                self.assertEqual(rolle.description_count, 0)
+    
+    def test_multiple_descriptions_per_rolle(self):
+        """Test multiple descriptions for a single role"""
+        # Add more descriptions to rolle1
+        abschnitttyp2 = AbschnittTyp.objects.create(abschnitttyp="liste ungeordnet")
+        
+        beschreibung2 = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle1,
+            abschnitttyp=abschnitttyp2,
+            inhalt="Zusätzliche Aufgaben:\n- Überwachung\n- Berichterstattung",
+            order=2
+        )
+        
+        # Check that rolle1 now has 2 descriptions
+        descriptions = RollenBeschreibung.objects.filter(abschnitt=self.rolle1)
+        self.assertEqual(descriptions.count(), 2)
+        
+        # Check annotation
+        rolle_with_count = Rolle.objects.annotate(
+            description_count=Count('rollenbeschreibung')
+        ).get(pk=self.rolle1.pk)
+        self.assertEqual(rolle_with_count.description_count, 2)
+    
+    def test_role_descriptions_ordered(self):
+        """Test that role descriptions are returned in correct order"""
+        # Add more descriptions in random order
+        beschreibung2 = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle1,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Dritte Beschreibung",
+            order=3
+        )
+        
+        beschreibung3 = RollenBeschreibung.objects.create(
+            abschnitt=self.rolle1,
+            abschnitttyp=self.abschnitttyp,
+            inhalt="Zweite Beschreibung",
+            order=2
+        )
+        
+        # Get descriptions in order
+        ordered_descriptions = RollenBeschreibung.objects.filter(
+            abschnitt=self.rolle1
+        ).order_by('order')
+        
+        expected_order = [self.beschreibung1, beschreibung3, beschreibung2]
+        self.assertEqual(list(ordered_descriptions), expected_order)
+    
+    def test_role_search_by_name(self):
+        """Test searching roles by name"""
+        # Test exact match
+        exact_match = Rolle.objects.filter(name="IT-Sicherheitsbeauftragter")
+        self.assertEqual(exact_match.count(), 1)
+        self.assertEqual(exact_match.first(), self.rolle1)
+        
+        # Test case-sensitive contains
+        contains_match = Rolle.objects.filter(name__contains="Sicherheits")
+        self.assertEqual(contains_match.count(), 1)
+        self.assertEqual(contains_match.first(), self.rolle1)
+        
+        # Test case-insensitive contains
+        icontains_match = Rolle.objects.filter(name__icontains="sicherheits")
+        self.assertEqual(icontains_match.count(), 1)
+        self.assertEqual(icontains_match.first(), self.rolle1)
+    
+    def test_role_with_long_descriptions(self):
+        """Test roles with long description content"""
+        long_content = "Dies ist eine sehr lange Beschreibung " * 50  # Repeat to make it long
+        
+        rolle_long = Rolle.objects.create(name="Rolle mit langer Beschreibung")
+        beschreibung_long = RollenBeschreibung.objects.create(
+            abschnitt=rolle_long,
+            abschnitttyp=self.abschnitttyp,
+            inhalt=long_content,
+            order=1
+        )
+        
+        # Verify the long content is stored correctly
+        retrieved = RollenBeschreibung.objects.get(pk=beschreibung_long.pk)
+        self.assertEqual(retrieved.inhalt, long_content)
+        self.assertGreater(len(retrieved.inhalt), 1000)  # Should be quite long

standards/admin.py

@@ -1,127 +0,0 @@
-from django.contrib import admin
-#from nested_inline.admin import NestedStackedInline, NestedModelAdmin
-from nested_admin import NestedStackedInline, NestedModelAdmin, NestedTabularInline
-from django import forms
-from mptt.forms import TreeNodeMultipleChoiceField
-from mptt.admin import DraggableMPTTAdmin
-
-# Register your models here.
-from .models import *
-from stichworte.models import Stichwort, Stichworterklaerung
-from referenzen.models import Referenz
-
-
-
-#class ChecklistenForm(forms.ModelForm):
-#    class Meta:
-#        model=Checklistenfrage
-#        fields="__all__"
-#        widgets = {
-#            'frage': forms.Textarea(attrs={'rows': 1, 'cols': 100}),
-#        }
-
-class ChecklistenfragenInline(NestedTabularInline):
-    model=Checklistenfrage
-    extra=0
-    fk_name="vorgabe"
-#    form=ChecklistenForm
-    classes = ['collapse']
-
-
-class VorgabeKurztextInline(NestedTabularInline):
-    model=VorgabeKurztext
-    extra=0
-    sortable_field_name = "order"
-    show_change_link=True
-    classes = ['collapse']
-    #inline=inhalt
-
-class VorgabeLangtextInline(NestedStackedInline):
-    model=VorgabeLangtext
-    extra=0
-    sortable_field_name = "order"
-    show_change_link=True
-    classes = ['collapse']
-    #inline=inhalt
-
-class GeltungsbereichInline(NestedTabularInline):
-    model=Geltungsbereich
-    extra=0
-    sortable_field_name = "order"
-    show_change_link=True
-    classes = ['collapse']
-    classes = ['collapse']
-    #inline=inhalt
-
-class EinleitungInline(NestedTabularInline):
-        model = Einleitung
-        extra = 0
-        sortable_field_name = "order"
-        show_change_link = True
-        classes = ['collapse']
-
-class VorgabeForm(forms.ModelForm):
-    # referenzen = TreeNodeMultipleChoiceField(queryset=Referenz.objects.all(), required=False)
-    class Meta:
-        model = Vorgabe
-        fields = '__all__'
-
-class VorgabeInline(NestedTabularInline):  # or StackedInline for more vertical layout
-    model = Vorgabe
-    form = VorgabeForm
-    extra = 0
-    #show_change_link = True
-    inlines = [VorgabeKurztextInline,VorgabeLangtextInline,ChecklistenfragenInline]
-    autocomplete_fields = ['stichworte','referenzen','relevanz']
-    #search_fields=['nummer','name']ModelAdmin.
-    list_filter=['stichworte']
-    #classes=["collapse"]
-
-class StichworterklaerungInline(NestedStackedInline):
-    model=Stichworterklaerung
-    extra=0
-    sortable_field_name = "order"
-    ordering=("order",)
-    show_change_link = True
-
-@admin.register(Stichwort)
-class StichwortAdmin(NestedModelAdmin):
-    search_fields = ('stichwort',)
-    ordering=('stichwort',)
-    inlines=[StichworterklaerungInline]
-
-@admin.register(Person)
-class PersonAdmin(admin.ModelAdmin):    
-    class Media:
-        js = ['admin/js/jquery.init.js', 'custom/js/inline_toggle.js']
-        css = {'all': ['custom/css/admin_extras.css']}
-    list_display=['name']
-    
-
-
-@admin.register(Standard)
-class StandardAdmin(NestedModelAdmin):
-    actions_on_top=True
-    inlines = [EinleitungInline,GeltungsbereichInline,VorgabeInline]
-    #filter_horizontal=['autoren','pruefende']
-    list_display=['nummer','name','dokumententyp']
-    search_fields=['nummer','name']
-    class Media:
-#        js = ('admin/js/vorgabe_collapse.js',)
-        css = {
-            'all': ('admin/css/vorgabe_border.css',
-#                    'admin/css/vorgabe_collapse.css',
-                    )
-        }
-
-
-#admin.site.register(Stichwort)
-
-admin.site.register(Checklistenfrage)
-#admin.site.register(Dokumententyp)
-#admin.site.register(Person)
-admin.site.register(Thema)
-#admin.site.register(Referenz, DraggableM§PTTAdmin)
-admin.site.register(Vorgabe)
-    
-#admin.site.register(Changelog)

standards/management/commands/import-standard1.py

@@ -1,177 +0,0 @@
-# Standards/management/commands/import_standard.py
-import re
-from pathlib import Path
-from django.core.management.base import BaseCommand, CommandError
-from django.utils import timezone
-
-from standards.models import (
-    Standard,
-    Vorgabe,
-    VorgabeKurztext,
-    VorgabeLangtext,
-    Geltungsbereich,
-    Dokumententyp,
-    Thema,
-)
-from abschnitte.models import AbschnittTyp
-
-
-class Command(BaseCommand):
-    help = "Import a security standard from a structured text file"
-
-    def add_arguments(self, parser):
-        parser.add_argument("file_path", type=str, help="Path to the plaintext file")
-        parser.add_argument("--nummer", required=True, help="Standard number (e.g., STD-001)")
-        parser.add_argument("--name", required=True, help="Standard name (e.g., IT-Sicherheit Container)")
-        parser.add_argument("--dokumententyp", required=True, help="Dokumententyp name")
-        parser.add_argument("--gueltigkeit_von", default=None, help="Start date (YYYY-MM-DD)")
-        parser.add_argument("--gueltigkeit_bis", default=None, help="End date (YYYY-MM-DD)")
-        parser.add_argument("--dry-run", action="store_true", help="Perform a dry run without saving to the database")
-        parser.add_argument("--verbose", action="store_true", help="Verbose output for dry run")
-
-    def handle(self, *args, **options):
-        dry_run = options["dry_run"]
-        verbose = options["verbose"]
-        file_path = Path(options["file_path"])
-        if not file_path.exists():
-            raise CommandError(f"File {file_path} does not exist")
-
-        nummer = options["nummer"]
-        name = options["name"]
-        dokumententyp_name = options["dokumententyp"]
-
-        try:
-            dokumententyp = Dokumententyp.objects.get(name=dokumententyp_name)
-        except Dokumententyp.DoesNotExist:
-            raise CommandError(f"Dokumententyp '{dokumententyp_name}' does not exist")
-
-        if dry_run:
-            self.stdout.write(self.style.WARNING("Dry run: no database changes will be made"))
-
-        # Create or get the Standard
-        if dry_run:
-            standard = {"nummer": nummer, "name": name, "dokumententyp": dokumententyp}
-        else:
-            standard, created = Standard.objects.get_or_create(
-                nummer=nummer,
-                defaults={
-                    "dokumententyp": dokumententyp,
-                    "name": name,
-                    "gueltigkeit_von": options["gueltigkeit_von"],
-                    "gueltigkeit_bis": options["gueltigkeit_bis"],
-                },
-            )
-            if not created:
-                self.stdout.write(self.style.WARNING(f"Standard {nummer} already exists, updating content"))
-
-        # Read and parse the file
-        content = file_path.read_text(encoding="utf-8")
-        blocks = re.split(r"^>>>", content, flags=re.MULTILINE)
-        blocks = [b.strip() for b in blocks if b.strip()]
-
-        geltungsbereich_sections = []
-        current_vorgabe = None
-        vorgaben_data = []
-        current_context = "geltungsbereich"
-        abschnittstyp_headers = ["text", "liste geordnet", "liste ungeordnet"]
-
-        for block in blocks:
-            lines = block.splitlines()
-            header = lines[0].strip()
-            text = "\n".join(lines[1:]).strip()
-            header_lower = header.lower()
-
-            # Determine AbschnittTyp if applicable
-            abschnitt_typ = None
-            if header_lower in abschnittstyp_headers:
-                try:
-                    abschnitt_typ = AbschnittTyp.objects.get(abschnitttyp=header_lower)
-                except AbschnittTyp.DoesNotExist:
-                    self.stdout.write(self.style.WARNING(f"AbschnittTyp '{header_lower}' not found, defaulting to 'text'"))
-                    abschnitt_typ = AbschnittTyp.objects.get(abschnitttyp="text")
-
-            if header_lower == "geltungsbereich":
-                current_context = "geltungsbereich"
-
-            elif header_lower.startswith("vorgabe"):
-                if current_vorgabe:
-                    vorgaben_data.append(current_vorgabe)
-                thema_name = header.split(" ", 1)[1].strip()
-                current_vorgabe = {"thema": thema_name, "titel": "", "nummer": None, "kurztext": [], "langtext": []}
-                current_context = "vorgabe_none"
-
-            elif header_lower.startswith("titel") and current_vorgabe:
-                current_vorgabe["titel"] = text
-
-            elif header_lower.startswith("nummer") and current_vorgabe:
-                nummer_match = re.search(r"\d+", header)
-                if nummer_match:
-                    current_vorgabe["nummer"] = int(nummer_match.group())
-                current_context = "vorgabe_none"
-
-            elif header_lower == "kurztext":
-                current_context = "vorgabe_kurztext"
-
-            elif header_lower == "langtext":
-                current_context = "vorgabe_langtext"
-
-            elif header_lower in abschnittstyp_headers:
-                abschnitt = {"inhalt": text, "typ": abschnitt_typ}
-                if current_context == "geltungsbereich":
-                    geltungsbereich_sections.append(abschnitt)
-                    if dry_run and verbose:
-                        self.stdout.write(self.style.SUCCESS(f"[DRY RUN] Geltungsbereich Abschnitt (Abschnittstyp: {abschnitt_typ}): {text[:50]}..."))
-                elif current_context == "vorgabe_kurztext" and current_vorgabe:
-                    current_vorgabe["kurztext"].append(abschnitt)
-                    if dry_run and verbose:
-                        self.stdout.write(self.style.SUCCESS(f"[DRY RUN] Vorgabe {current_vorgabe['nummer']} Kurztext Abschnitt (Abschnittstyp: {abschnitt_typ}): {text[:50]}..."))
-                elif current_context == "vorgabe_langtext" and current_vorgabe:
-                    current_vorgabe["langtext"].append(abschnitt)
-                    if dry_run and verbose:
-                        self.stdout.write(self.style.SUCCESS(f"[DRY RUN] Vorgabe {current_vorgabe['nummer']} Langtext Abschnitt (Abschnittstyp: {abschnitt_typ}): {text[:50]}..."))
-
-        if current_vorgabe:
-            vorgaben_data.append(current_vorgabe)
-
-        # Save Geltungsbereich
-        for sektion in geltungsbereich_sections:
-            if dry_run:
-                self.stdout.write(self.style.SUCCESS(f"[DRY RUN] Would create Geltungsbereich Abschnitt (Abschnittstyp: {sektion['typ']}): {sektion['inhalt'][:50]}..."))
-            else:
-                Geltungsbereich.objects.create(
-                    geltungsbereich=standard,
-                    abschnitttyp=sektion["typ"],
-                    inhalt=sektion["inhalt"],
-                )
-
-        # Save Vorgaben
-        for v in vorgaben_data:
-            try:
-                thema = Thema.objects.get(name=v["thema"])
-            except Thema.DoesNotExist:
-                self.stdout.write(self.style.WARNING(f"Thema '{v['thema']}' not found, skipping Vorgabe {v['nummer']}"))
-                continue
-
-            if dry_run:
-                self.stdout.write(self.style.SUCCESS(f"[DRY RUN] Would create Vorgabe {v['nummer']}: '{v['titel']}' (Thema: {v['thema']})"))
-                for sektion in v["kurztext"]:
-                    self.stdout.write(self.style.SUCCESS(f"[DRY RUN]   Kurztext Abschnitt (Abschnittstyp: {sektion['typ']}): {sektion['inhalt'][:50]}..."))
-                for sektion in v["langtext"]:
-                    self.stdout.write(self.style.SUCCESS(f"[DRY RUN]   Langtext Abschnitt (Abschnittstyp: {sektion['typ']}): {sektion['inhalt'][:50]}..."))
-            else:
-                vorgabe = Vorgabe.objects.create(
-                    nummer=v["nummer"],
-                    dokument=standard,
-                    thema=thema,
-                    titel=v["titel"],
-                    gueltigkeit_von=timezone.now().date(),
-                )
-                for sektion in v["kurztext"]:
-                    VorgabeKurztext.objects.create(abschnitt=vorgabe, abschnitttyp=sektion["typ"], inhalt=sektion["inhalt"])
-                for sektion in v["langtext"]:
-                    VorgabeLangtext.objects.create(abschnitt=vorgabe, abschnitttyp=sektion["typ"], inhalt=sektion["inhalt"])
-
-        self.stdout.write(self.style.SUCCESS(
-            f"{'Dry run complete' if dry_run else f'Imported standard {standard} with {len(vorgaben_data)} Vorgaben'}"
-        ))
-

standards/models.py

@@ -1,128 +0,0 @@
-from django.db import models
-from mptt.models import MPTTModel, TreeForeignKey
-from abschnitte.models import Textabschnitt
-from stichworte.models import Stichwort
-from referenzen.models import Referenz
-from rollen.models import Rolle
-import datetime
-
-class Dokumententyp(models.Model):
-    name = models.CharField(max_length=100, primary_key=True)
-    verantwortliche_ve = models.CharField(max_length=255)
-
-    def __str__(self):
-        return self.name
-
-
-class Person(models.Model):
-    name = models.CharField(max_length=100, primary_key=True)
-    funktion = models.CharField(max_length=255)
-
-    def __str__(self):
-        return self.name
-    class Meta:
-        verbose_name_plural="Personen"
-
-class Thema(models.Model):
-    name = models.CharField(max_length=100, primary_key=True)
-    erklaerung = models.TextField(blank=True)
-
-    def __str__(self):
-        return self.name
-    class Meta:
-        verbose_name_plural="Themen"
-
-
-class Standard(models.Model):
-    nummer = models.CharField(max_length=50, primary_key=True)
-    dokumententyp = models.ForeignKey(Dokumententyp, on_delete=models.PROTECT)
-    name = models.CharField(max_length=255)
-    autoren = models.ManyToManyField(Person, related_name='verfasste_dokumente')
-    pruefende = models.ManyToManyField(Person, related_name='gepruefte_dokumente')
-    gueltigkeit_von = models.DateField(null=True, blank=True)
-    gueltigkeit_bis = models.DateField(null=True, blank=True)
-    signatur_cso = models.CharField(max_length=255, blank=True)
-    anhaenge = models.TextField(blank=True)
-
-    def __str__(self):
-        return f"{self.nummer} – {self.name}"
-
-    class Meta:
-        verbose_name_plural="Standards"
-        verbose_name="Standard"
-
-class Vorgabe(models.Model):
-    nummer = models.IntegerField()
-    dokument = models.ForeignKey(Standard, on_delete=models.CASCADE, related_name='vorgaben')
-    thema = models.ForeignKey(Thema, on_delete=models.PROTECT)
-    titel = models.CharField(max_length=255)
-    referenzen = models.ManyToManyField(Referenz, blank=True)
-    gueltigkeit_von = models.DateField()
-    gueltigkeit_bis = models.DateField(blank=True,null=True)
-    stichworte = models.ManyToManyField(Stichwort, blank=True)
-    relevanz = models.ManyToManyField(Rolle,blank=True)
-
-    def Vorgabennummer(self):
-        return str(self.dokument.nummer)+"."+self.thema.name[0]+"."+str(self.nummer)
-
-    def get_status(self, check_date: datetime.date = datetime.date.today(), verbose: bool = False) -> str:
-        if self.gueltigkeit_von > check_date:
-            return "future" if not verbose else "Ist erst ab dem "+self.gueltigkeit_von.strftime('%d.%m.%Y')+" in Kraft."
-
-        if not self.gueltigkeit_bis:
-            return "active"
-
-        if self.gueltigkeit_bis > check_date:
-            return "active"
-
-        return "expired" if not verbose else "Ist seit dem "+self.gueltigkeit_bis.strftime('%d.%m.%Y')+" nicht mehr in Kraft."
-
-
-    class Meta:
-        verbose_name_plural="Vorgaben"
-
-    def __str__(self):
-        return f"{self.Vorgabennummer()}: {self.titel}"
-
-class VorgabeLangtext(Textabschnitt):
-    abschnitt=models.ForeignKey(Vorgabe,on_delete=models.CASCADE)
-    class Meta:
-        verbose_name_plural="Langtext-Abschnitte"
-        verbose_name="Langtext-Abschnitt"
-
-class VorgabeKurztext(Textabschnitt):
-    abschnitt=models.ForeignKey(Vorgabe,on_delete=models.CASCADE)
-    class Meta:
-        verbose_name_plural="Kurztext"
-        verbose_name="Kurztext-Abschnitt"
-
-class Geltungsbereich(Textabschnitt):
-    geltungsbereich=models.ForeignKey(Standard,on_delete=models.CASCADE)
-    class Meta:
-        verbose_name_plural="Geltungsbereich"
-        verbose_name="Geltungsbereichs-Abschnitt"
-
-class Einleitung(Textabschnitt):
-    einleitung=models.ForeignKey(Standard,on_delete=models.CASCADE)
-    class Meta:
-        verbose_name_plural="Einleitung"
-        verbose_name="Einleitungs-Abschnitt"
-
-class Checklistenfrage(models.Model):
-    vorgabe=models.ForeignKey(Vorgabe, on_delete=models.CASCADE, related_name="checklistenfragen")
-    frage = models.CharField(max_length=255)
-
-    def __str__(self):
-        return self.frage
-
-    class Meta:
-        verbose_name_plural="Fragen für Checkliste"
-
-class Changelog(models.Model):
-    dokument = models.ForeignKey(Standard, on_delete=models.CASCADE, related_name='changelog')
-    autoren = models.ManyToManyField(Person)
-    datum = models.DateField()
-    aenderung = models.TextField()
-
-    def __str__(self):
-        return f"{self.datum} – {self.dokument.nummer}"

standards/templates/standards/standard_detail.html

@@ -1,103 +0,0 @@
-{% extends "base.html" %}
-{% block title %}{{ standard }}{% endblock %}
-{% block content %}
-<h1>{{ standard.nummer }} – {{ standard.name }}</h1>
-{% if standard.history == True %}
-<h2>Version vom {{ standard.check_date }}</h2>
-{% endif %}
-
-<p><strong>Autoren:</strong> {{ standard.autoren.all|join:", " }}</p>
-<p><strong>Prüfende:</strong> {{ standard.pruefende.all|join:", " }}</p>
-<p><strong>Gültigkeit:</strong> {{ standard.gueltigkeit_von }} bis {{ standard.gueltigkeit_bis }}</p>
-
-{% if standard.einleitung_html %}
-<h2>Einleitung</h2>
-{% for typ, html in standard.einleitung_html %}
-<div>{{ html|safe }}</div>
-{% endfor %}
-{% endif %}
-
-{% if standard.geltungsbereich_html %}
-<h2>Geltungsbereich</h2>
-{% for typ, html in standard.geltungsbereich_html %}
-<div>{{ html|safe }}</div>
-{% endfor %}
-{% endif %}
-
-<h2>Vorgaben</h2>
-{% for vorgabe in vorgaben %}
-{% if standard.history == True or vorgabe.long_status == "active" %}
-  <a id="{{ vorgabe.Vorgabennummer }}"></a><div class="card mb-4">
-    {% if vorgabe.long_status == "active"%}
-    <div class="card-header d-flex justify-content-between align-items-center bg-secondary text-light">
-    {% elif standard.history == True %}
-    <div class="card-header d-flex justify-content-between align-items-center bg-danger-subtle">
-    {% endif %}
-     <h3 class="h5 m-0">{{ vorgabe.Vorgabennummer }} – {{ vorgabe.titel }}
-        {% if vorgabe.long_status != "active"  and standard.history == True %}<span class="text-danger"> ({{ vorgabe.long_status}})</span>{% endif %}
-      </h3>
-      {% if vorgabe.relevanzset %}
-      <span class="badge bg-light text-black"> Relevanz:
-	 {{ vorgabe.relevanzset|join:", " }}
-      </span>
-      {% endif %}
-
-      <span class="badge bg-light text-black">{{ vorgabe.thema }}</span>
-    </div>
-
-    <div class="card-body p-0">
-
-      {% comment %} KURZTEXT BLOCK {% endcomment %}
-      {% if vorgabe.kurztext_html.0.1 %}
-      <div class="p-3 mb-3 bg-light border-3" style="width: 100%;">
-        {% for typ, html in vorgabe.kurztext_html %}
-          {% if html %}
-            <div class="mb-2">{{ html|safe }}</div>
-          {% endif %}
-        {% endfor %}
-      </div>
-      {% endif %}
-      <div class="p-3 mb-3">
-      {% comment %} LANGTEXT BLOCK {% endcomment %}
-      {# <h5>Langtext</h5> #}
-      {% for typ, html in vorgabe.langtext_html %}
-        {% if html %}<div class="mb-3">{{ html|safe }}</div>{% endif %}
-      {% endfor %}
-
-      {% comment %} CHECKLISTENFRAGEN BLOCK {% endcomment %}
-      <h5>Checklistenfragen</h5>
-      {% if vorgabe.checklistenfragen.all %}
-        <ul class="list-group">
-          {% for frage in vorgabe.checklistenfragen.all %}
-            <li class="list-group-item">{{ frage.frage }}</li>
-          {% endfor %}
-        </ul>
-      {% else %}
-        <p><em>Keine Checklistenfragen</em></p>
-      {% endif %}
-      {% comment %} STICHWORTE + REFERENZEN AT BOTTOM {% endcomment %}
-      <div class="mt-4 small text-muted">
-        <strong>Stichworte:</strong>
-        {% if vorgabe.stichworte.all %}
-          {% for s in vorgabe.stichworte.all %}
-            <a href="{% url 'stichwort_detail' stichwort=s %}">{{ s }}</a>{% if not forloop.last %}, {% endif %}
-          {% endfor %}
-        {% else %}
-          <em>Keine</em>
-        {% endif %}
-        <br>
-        <strong>Referenzen:</strong>
-        {% if vorgabe.referenzpfade %}
-          {% for ref in vorgabe.referenzpfade %}
-            {{ ref|safe }}{% if not forloop.last %}, {% endif %}
-          {% endfor %}
-        {% else %}
-          <em>Keine</em>
-        {% endif %}
-      </div>
-      </div>
-    </div>
-  </div>
-  {% endif %}
-{% endfor %}
-{% endblock %}

standards/tests.py

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