iil-doc-templates 0.1.0__tar.gz

iil_doc_templates-0.1.0/.gitignore

@@ -0,0 +1,50 @@
+# Python
+__pycache__/
+*.py[cod]
+*\.class
+.venv/
+venv/
+*.egg-info/
+dist/
+build/
+# Django
+*.log
+db.sqlite3
+media/
+staticfiles/
+# Environment
+.env
+.env.local
+.env.prod
+
+# Secrets (ADR-045) — NEVER commit plaintext
+secrets.env
+!secrets.enc.env
+# IDE
+.idea/
+.vscode/
+*.swp
+# OS
+.DS_Store
+Thumbs.db
+# Large files
+*.sqlite3
+*.log
+output_batch/
+app_backup/
+docs_legacy/
+# Sphinx build output
+docs/_build/
+*:Zone.Identifier
+# Local Windsurf/MCP config — machine-specific, never commit
+.windsurf/mcp_config.json
+# Local infra plaintext secrets — NEVER commit
+infra/*.env
+infra/*.key
+# Validate-ports CI draft (not yet integrated)
+.github/workflows/validate-ports.yml
+# Markdownlint local config override
+.markdownlint.json
+# Concept review drafts (local working copies, not for VCS)
+docs/concepts/REVIEW-*
+env_loader.py

iil_doc_templates-0.1.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: iil-doc-templates
+Version: 0.1.0
+Summary: Reusable Django document template system — create, edit, fill templates with PDF extraction and LLM prefill
+Author-email: Achim Dehnert <achim.dehnert@iil.gmbh>
+License-Expression: LicenseRef-Proprietary
+Requires-Python: >=3.10
+Requires-Dist: django>=4.2
+Requires-Dist: iil-concept-templates>=0.4.0
+Provides-Extra: all
+Requires-Dist: iil-aifw>=0.5.0; extra == 'all'
+Requires-Dist: iil-django-tenancy>=0.3.0; extra == 'all'
+Requires-Dist: pdfplumber>=0.10; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-django; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: llm
+Requires-Dist: iil-aifw>=0.5.0; extra == 'llm'
+Provides-Extra: pdf
+Requires-Dist: pdfplumber>=0.10; extra == 'pdf'
+Provides-Extra: tenancy
+Requires-Dist: iil-django-tenancy>=0.3.0; extra == 'tenancy'
+Description-Content-Type: text/markdown
+
+# iil-doc-templates
+
+Reusable Django document template system — create, edit, fill templates with PDF extraction and LLM prefill.
+
+## Installation
+
+```bash
+pip install iil-doc-templates
+```
+
+With optional dependencies:
+```bash
+pip install iil-doc-templates[pdf]   # pdfplumber for PDF extraction
+pip install iil-doc-templates[llm]   # iil-aifw for LLM prefill
+pip install iil-doc-templates[all]   # everything
+```
+
+## Quick Start
+
+```python
+# settings.py
+INSTALLED_APPS = [
+    ...
+    "doc_templates",
+]
+
+# urls.py
+path("doc-templates/", include("doc_templates.urls")),
+```
+
+Then run migrations:
+```bash
+python manage.py migrate doc_templates
+```
+
+## Features
+
+- **DocumentTemplate** — Reusable document templates with JSON structure (sections + fields)
+- **DocumentInstance** — Filled-out documents based on templates
+- **PDF Upload** — Extract structure from PDF using `iil-concept-templates`
+- **Interactive Editor** — Drag & drop sections, CRUD fields, table columns
+- **LLM Prefill** — AI-powered field completion via `iil-aifw`
+- **PDF Export** — Generate PDF from filled documents via `concept_templates.document_renderer`
+- **Multi-Tenant** — All queries filter by `tenant_id`
+
+## Architecture
+
+```
+iil-concept-templates (Pure Python)      iil-doc-templates (Django)
+├── Pydantic Schemas                     ├── Django Models
+├── PDF Structure Extraction     ──►     ├── CRUD Views + URLs
+├── Analysis, Prefill, Export            ├── HTML Templates (6)
+└── No Django dependency                 ├── Admin Integration
+                                         └── Uses concept_templates internally
+```
+
+## Field Types
+
+| Type | Description |
+|------|-------------|
+| `textarea` | Multi-line text (default) |
+| `text` | Single-line text |
+| `number` | Numeric input |
+| `date` | Date picker |
+| `boolean` | Yes/No toggle |
+| `table` | Table with configurable columns |
+
+## URL Patterns
+
+| URL | View | Description |
+|-----|------|-------------|
+| `/` | `template-list` | List all templates + instances |
+| `/create/` | `template-create` | Create empty template |
+| `/upload/` | `template-upload` | Create template from PDF |
+| `/<pk>/edit/` | `template-edit` | Interactive template editor |
+| `/<pk>/delete/` | `template-delete` | Delete template |
+| `/<pk>/instance/create/` | `instance-create` | Create document from template |
+| `/instance/<pk>/edit/` | `instance-edit` | Edit document fields |
+| `/instance/<pk>/delete/` | `instance-delete` | Delete document |
+| `/instance/<pk>/prefill/` | `instance-prefill` | LLM prefill endpoint |
+| `/instance/<pk>/pdf/` | `instance-pdf` | PDF export |
+
+## Dependencies
+
+- **Required**: Django ≥ 4.2, iil-concept-templates ≥ 0.4.0
+- **Optional**: pdfplumber (PDF extraction), iil-aifw (LLM prefill)

iil_doc_templates-0.1.0/README.md

@@ -0,0 +1,86 @@
+# iil-doc-templates
+
+Reusable Django document template system — create, edit, fill templates with PDF extraction and LLM prefill.
+
+## Installation
+
+```bash
+pip install iil-doc-templates
+```
+
+With optional dependencies:
+```bash
+pip install iil-doc-templates[pdf]   # pdfplumber for PDF extraction
+pip install iil-doc-templates[llm]   # iil-aifw for LLM prefill
+pip install iil-doc-templates[all]   # everything
+```
+
+## Quick Start
+
+```python
+# settings.py
+INSTALLED_APPS = [
+    ...
+    "doc_templates",
+]
+
+# urls.py
+path("doc-templates/", include("doc_templates.urls")),
+```
+
+Then run migrations:
+```bash
+python manage.py migrate doc_templates
+```
+
+## Features
+
+- **DocumentTemplate** — Reusable document templates with JSON structure (sections + fields)
+- **DocumentInstance** — Filled-out documents based on templates
+- **PDF Upload** — Extract structure from PDF using `iil-concept-templates`
+- **Interactive Editor** — Drag & drop sections, CRUD fields, table columns
+- **LLM Prefill** — AI-powered field completion via `iil-aifw`
+- **PDF Export** — Generate PDF from filled documents via `concept_templates.document_renderer`
+- **Multi-Tenant** — All queries filter by `tenant_id`
+
+## Architecture
+
+```
+iil-concept-templates (Pure Python)      iil-doc-templates (Django)
+├── Pydantic Schemas                     ├── Django Models
+├── PDF Structure Extraction     ──►     ├── CRUD Views + URLs
+├── Analysis, Prefill, Export            ├── HTML Templates (6)
+└── No Django dependency                 ├── Admin Integration
+                                         └── Uses concept_templates internally
+```
+
+## Field Types
+
+| Type | Description |
+|------|-------------|
+| `textarea` | Multi-line text (default) |
+| `text` | Single-line text |
+| `number` | Numeric input |
+| `date` | Date picker |
+| `boolean` | Yes/No toggle |
+| `table` | Table with configurable columns |
+
+## URL Patterns
+
+| URL | View | Description |
+|-----|------|-------------|
+| `/` | `template-list` | List all templates + instances |
+| `/create/` | `template-create` | Create empty template |
+| `/upload/` | `template-upload` | Create template from PDF |
+| `/<pk>/edit/` | `template-edit` | Interactive template editor |
+| `/<pk>/delete/` | `template-delete` | Delete template |
+| `/<pk>/instance/create/` | `instance-create` | Create document from template |
+| `/instance/<pk>/edit/` | `instance-edit` | Edit document fields |
+| `/instance/<pk>/delete/` | `instance-delete` | Delete document |
+| `/instance/<pk>/prefill/` | `instance-prefill` | LLM prefill endpoint |
+| `/instance/<pk>/pdf/` | `instance-pdf` | PDF export |
+
+## Dependencies
+
+- **Required**: Django ≥ 4.2, iil-concept-templates ≥ 0.4.0
+- **Optional**: pdfplumber (PDF extraction), iil-aifw (LLM prefill)

iil_doc_templates-0.1.0/doc_templates/__init__.py

@@ -0,0 +1,11 @@
+"""iil-doc-templates — Reusable Django document template system.
+
+Provides DocumentTemplate + DocumentInstance models, CRUD views,
+interactive template editor, PDF extraction, and LLM prefill.
+
+Uses iil-concept-templates for schemas and PDF structure extraction.
+"""
+
+__version__ = "0.1.0"
+
+default_app_config = "doc_templates.apps.DocTemplatesConfig"

iil_doc_templates-0.1.0/doc_templates/admin.py

@@ -0,0 +1,22 @@
+"""Admin registration for doc_templates."""
+
+from django.contrib import admin
+
+from .models import DocumentInstance, DocumentTemplate
+
+
+@admin.register(DocumentTemplate)
+class DocumentTemplateAdmin(admin.ModelAdmin):
+    list_display = ["name", "scope", "status", "section_count", "field_count", "updated_at"]
+    list_filter = ["status", "scope"]
+    search_fields = ["name", "description"]
+    readonly_fields = ["uuid", "created_at", "updated_at"]
+
+
+@admin.register(DocumentInstance)
+class DocumentInstanceAdmin(admin.ModelAdmin):
+    list_display = ["name", "template", "status", "updated_at"]
+    list_filter = ["status"]
+    search_fields = ["name"]
+    readonly_fields = ["uuid", "created_at", "updated_at"]
+    raw_id_fields = ["template"]

iil_doc_templates-0.1.0/doc_templates/apps.py

@@ -0,0 +1,9 @@
+"""Django app config for doc_templates."""
+
+from django.apps import AppConfig
+
+
+class DocTemplatesConfig(AppConfig):
+    name = "doc_templates"
+    verbose_name = "Dokumentvorlagen"
+    default_auto_field = "django.db.models.BigAutoField"

iil_doc_templates-0.1.0/doc_templates/models.py

@@ -0,0 +1,156 @@
+"""Document template models (generalized from ExDocTemplate/ExDocInstance)."""
+
+import json
+import uuid
+
+from django.db import models
+
+# Graceful import for TenantManager
+try:
+    from django_tenancy.managers import TenantManager
+except ImportError:
+    TenantManager = models.Manager
+
+
+class DocumentTemplate(models.Model):
+    """Wiederverwendbare Dokumentvorlage (modulübergreifend).
+
+    Struktur als JSON:
+    {
+      "sections": [
+        {
+          "key": "section_1",
+          "label": "1. Allgemeines",
+          "fields": [
+            {"key": "inhalt", "label": "Inhalt", "type": "textarea"}
+          ]
+        }
+      ]
+    }
+    """
+
+    class Status(models.TextChoices):
+        DRAFT = "draft", "Entwurf"
+        ACCEPTED = "accepted", "Akzeptiert"
+        ARCHIVED = "archived", "Archiviert"
+
+    uuid = models.UUIDField(default=uuid.uuid4, unique=True, editable=False)
+    tenant_id = models.UUIDField(db_index=True)
+    name = models.CharField(max_length=255)
+    description = models.TextField(blank=True, default="")
+    scope = models.CharField(
+        max_length=50, blank=True, default="",
+        help_text="Fachbereich, z.B. explosionsschutz, brandschutz, gbu, risk",
+    )
+    structure_json = models.TextField(
+        default='{"sections": []}',
+        help_text="Template-Struktur als JSON",
+    )
+    status = models.CharField(
+        max_length=20, choices=Status.choices, default=Status.DRAFT,
+    )
+    source_filename = models.CharField(max_length=255, blank=True, default="")
+    source_text = models.TextField(blank=True, default="")
+
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    objects = TenantManager()
+
+    class Meta:
+        db_table = "doc_template"
+        verbose_name = "Dokumentvorlage"
+        verbose_name_plural = "Dokumentvorlagen"
+        ordering = ["-updated_at"]
+        indexes = [
+            models.Index(fields=["tenant_id", "status"], name="ix_doctmpl_tenant_st"),
+            models.Index(fields=["tenant_id", "scope"], name="ix_doctmpl_tenant_scope"),
+        ]
+
+    def __str__(self) -> str:
+        return f"{self.name} ({self.get_status_display()})"
+
+    @property
+    def section_count(self) -> int:
+        try:
+            data = json.loads(self.structure_json)
+            return len(data.get("sections", []))
+        except (json.JSONDecodeError, TypeError):
+            return 0
+
+    @property
+    def field_count(self) -> int:
+        try:
+            data = json.loads(self.structure_json)
+            return sum(len(s.get("fields", [])) for s in data.get("sections", []))
+        except (json.JSONDecodeError, TypeError):
+            return 0
+
+    def get_structure(self) -> dict:
+        """Parse and return structure from JSON."""
+        try:
+            return json.loads(self.structure_json)
+        except (json.JSONDecodeError, TypeError):
+            return {"sections": []}
+
+    def get_sections(self) -> list[dict]:
+        """Return sections list from structure."""
+        return self.get_structure().get("sections", [])
+
+
+class DocumentInstance(models.Model):
+    """Ausgefülltes Dokument basierend auf einem Template.
+
+    Werte als JSON:
+    {
+      "section_1": {
+        "inhalt": "Dieses Dokument..."
+      }
+    }
+    """
+
+    class Status(models.TextChoices):
+        DRAFT = "draft", "Entwurf"
+        REVIEW = "review", "In Prüfung"
+        APPROVED = "approved", "Freigegeben"
+
+    uuid = models.UUIDField(default=uuid.uuid4, unique=True, editable=False)
+    tenant_id = models.UUIDField(db_index=True)
+    template = models.ForeignKey(
+        DocumentTemplate, on_delete=models.PROTECT, related_name="instances",
+    )
+    name = models.CharField(max_length=255)
+    values_json = models.TextField(
+        default="{}", help_text="Ausgefüllte Werte als JSON",
+    )
+    status = models.CharField(
+        max_length=20, choices=Status.choices, default=Status.DRAFT,
+    )
+    source_filename = models.CharField(
+        max_length=255, blank=True, default="",
+        help_text="Dateiname des importierten Dokuments",
+    )
+
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    objects = TenantManager()
+
+    class Meta:
+        db_table = "doc_instance"
+        verbose_name = "Dokument"
+        verbose_name_plural = "Dokumente"
+        ordering = ["-updated_at"]
+        indexes = [
+            models.Index(fields=["tenant_id", "status"], name="ix_docinst_tenant_st"),
+        ]
+
+    def __str__(self) -> str:
+        return f"{self.name} ({self.get_status_display()})"
+
+    def get_values(self) -> dict:
+        """Parse and return values from JSON."""
+        try:
+            return json.loads(self.values_json)
+        except (json.JSONDecodeError, TypeError):
+            return {}

iil_doc_templates-0.1.0/doc_templates/templates/doc_templates/create.html

@@ -0,0 +1,48 @@
+{% extends "base.html" %}
+{% block title %}Leere Vorlage erstellen{% endblock %}
+
+{% block content %}
+<div class="max-w-2xl mx-auto px-4 py-8">
+
+  <div class="flex items-center space-x-4 mb-6">
+    <a href="{% url 'doc_templates:template-list' %}" class="text-gray-400 hover:text-gray-600">&larr;</a>
+    <h1 class="text-2xl font-bold text-gray-900">Leere Vorlage erstellen</h1>
+  </div>
+
+  <div class="bg-white rounded-xl border border-gray-200 p-6">
+    <form method="post" class="space-y-4">
+      {% csrf_token %}
+      <div>
+        <label class="block text-sm font-medium text-gray-700 mb-1">Name der Vorlage *</label>
+        <input type="text" name="name" required placeholder="z.B. Explosionsschutzdokument nach TRBS 2152"
+               class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500">
+      </div>
+      <div>
+        <label class="block text-sm font-medium text-gray-700 mb-1">Fachbereich</label>
+        <input type="text" name="scope" list="scope-options" placeholder="z.B. explosionsschutz, brandschutz, gbu"
+               class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500">
+        <datalist id="scope-options">
+          <option value="explosionsschutz">
+          <option value="brandschutz">
+          <option value="gbu">
+          <option value="betriebsanweisung">
+          <option value="risk">
+        </datalist>
+      </div>
+      <div>
+        <label class="block text-sm font-medium text-gray-700 mb-1">Beschreibung (optional)</label>
+        <textarea name="description" rows="2"
+                  class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500"
+                  placeholder="Kurze Beschreibung..."></textarea>
+      </div>
+      <div class="flex justify-end gap-3 pt-2">
+        <a href="{% url 'doc_templates:template-list' %}" class="px-4 py-2 text-sm text-gray-500 hover:text-gray-700">Abbrechen</a>
+        <button type="submit" class="px-5 py-2.5 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+          Vorlage erstellen
+        </button>
+      </div>
+    </form>
+  </div>
+
+</div>
+{% endblock %}