fix: PDF page-break polish + drop redundant Stage column in inbox

PDF:
- Removed :nth-child(even) zebra striping from both single and bulk PDFs.
  The alternating background looked odd next to half/third/quarter-width
  rows that render as one wide colspan row containing inline columns.
- Added page-break-after: avoid / break-after: avoid on section
  dividers (.section-row, .step-section-header, .step-field-section-row)
  and on the .step-meta line so headers stay attached to the content
  they introduce. Added a dedicated .step-field-section-row class on
  the in-table divider <tr> so we don't depend on :has() selector
  support in WeasyPrint.

Approval inbox:
- Dropped the "Stage" column entirely. The Step label already carries
  the full context after the 0.71.0 naming standardisation
  ("Payment 1: Step 2: HR Processing" or "Step 2: HR Approval"), so
  the numeric stage column was redundant. Removed the <th>, the
  DataTables column spec, the "stage" key in the AJAX payload, and
  shifted default_sort_col down one to match.

Bumps version to 0.72.2.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: matteius

CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.72.2] - 2026-04-16
+
+### Changed
+- **PDF exports no longer zebra-stripe data rows.** The alternating
+  `:nth-child(even)` tint looked inconsistent when combined with
+  half / third / quarter-width rows (which render as a single wide
+  colspan row containing inline columns). Both
+  `submission_pdf.html` and `submission_bulk_pdf.html` now use a
+  uniform white data-row background.
+- **Approval inbox: dropped the redundant "Stage" column.** The Step
+  label now carries the full context (`"Payment 1: Step 2: HR Processing"`
+  or `"Step 2: HR Approval"`), so a separate numeric stage column is no
+  longer useful. Removed the `<th>`, the DataTables column spec, the
+  `"stage"` key from the AJAX payload, and shifted the default sort
+  column index down one.
+
+### Fixed
+- **PDF page breaks keep section headers attached to their content.**
+  Section dividers (`.section-row`, `.step-section-header`,
+  `.step-field-section-row`) and the per-step meta line (`.step-meta`)
+  now set `page-break-after: avoid` / `break-after: avoid` so a
+  section header no longer orphans at the bottom of one page with its
+  fields starting on the next. Applies to both single-submission and
+  bulk PDFs.
+
 ## [0.72.1] - 2026-04-16
 
 ### Fixed

django_forms_workflows/templates/django_forms_workflows/approval_inbox.html

@@ -253,7 +253,6 @@ <h5 class="modal-title fw-bold" id="bulkPdfModeModalLabel">
             <th>Actions</th>
             <th>Form</th>
             <th>Submitter</th>
-            <th>Stage</th>
             <th>Step</th>
             <th>Assigned</th>
             <th>Submitted</th>
@@ -346,7 +345,6 @@ <h5 class="modal-title fw-bold" id="bulkPdfModeModalLabel">
                 { data: 'actions', name: '', orderable: false },
                 { data: 'form', name: 'submission__form_definition__name' },
                 { data: 'submitter', name: 'submission__submitter__last_name' },
-                { data: 'stage', name: 'stage_number' },
                 { data: 'step_num', name: 'workflow_stage__name' },
                 { data: 'assigned', name: 'assigned_group__name' },
                 { data: 'submitted_at', name: 'submission__submitted_at' },

django_forms_workflows/templates/django_forms_workflows/submission_bulk_pdf.html

@@ -51,11 +51,20 @@
         .data-table th { background-color: #f0f0f0; font-weight: bold; font-size: 8pt; color: #333; border: 1px solid #d0d0d0; padding: 3pt 6pt; text-align: left; vertical-align: top; }
         .data-table td { font-size: 9pt; border: 1px solid #d0d0d0; padding: 3pt 6pt; vertical-align: top; }
         .data-table tr { page-break-inside: avoid; break-inside: avoid; }
-        .data-table tr:nth-child(even) th,
-        .data-table tr:nth-child(even) td { background-color: #f9f9f9; }
         .section-row td { background-color: #e8f0f7 !important; color: #1a3a52; font-weight: bold; font-size: 8pt; letter-spacing: 0.3pt; text-transform: uppercase; padding: 4pt 6pt; border: 1px solid #b8ccd8; }
-        .step-section-header { background-color: #1a3a52; color: #fff; font-weight: bold; font-size: 9pt; padding: 4pt 6pt; margin-top: 10pt; border: 1px solid #0f2538; }
-        .step-meta { font-size: 7.5pt; color: #555; margin: 2pt 0 4pt 0; }
+        /* Keep each section header attached to the content that follows it. */
+        .section-row { page-break-after: avoid; break-after: avoid; page-break-inside: avoid; break-inside: avoid; }
+        .step-section-header {
+            background-color: #1a3a52; color: #fff; font-weight: bold; font-size: 9pt;
+            padding: 4pt 6pt; margin-top: 10pt; border: 1px solid #0f2538;
+            page-break-after: avoid; break-after: avoid;
+            page-break-inside: avoid; break-inside: avoid;
+        }
+        .step-meta {
+            font-size: 7.5pt; color: #555; margin: 2pt 0 4pt 0;
+            page-break-before: avoid; break-before: avoid;
+            page-break-after: avoid; break-after: avoid;
+        }
     </style>
 </head>
 <body>

django_forms_workflows/templates/django_forms_workflows/submission_pdf.html

@@ -106,11 +106,10 @@
             break-inside: avoid;
         }
 
-        /* Alternating row tint — WeasyPrint supports :nth-child fully */
-        .data-table tr:nth-child(even) th,
-        .data-table tr:nth-child(even) td { background-color: #f9f9f9; }
-
-        /* Section rows always keep their own colour regardless of position */
+        /* Section rows always keep their own colour regardless of position.
+           Also keep each section header with the content that follows it —
+           prevents the ugly case where a header renders at the bottom of one
+           page and its fields start on the next. */
         .section-row td {
             background-color: #e8f0f7 !important;
             color: #1a3a52;
@@ -121,6 +120,12 @@
             padding: 4pt 6pt;
             border: 1px solid #b8ccd8;
         }
+        .section-row {
+            page-break-after: avoid;
+            break-after: avoid;
+            page-break-inside: avoid;
+            break-inside: avoid;
+        }
 
         /* Approval-step section header */
         .step-section-header {
@@ -134,6 +139,11 @@
             display: table;
             width: 100%;
             box-sizing: border-box;
+            /* Keep the step header with its meta line / following table */
+            page-break-after: avoid;
+            break-after: avoid;
+            page-break-inside: avoid;
+            break-inside: avoid;
         }
         .step-section-header .step-name-cell { display: table-cell; vertical-align: middle; }
         .step-section-header .step-badge-cell {
@@ -152,6 +162,22 @@
             font-size: 9pt;
             padding: 4pt 8pt;
         }
+        /* Section divider row inside the step table: stay attached to the
+           following field row rather than orphaning at the bottom of a page. */
+        tr.step-field-section-row {
+            page-break-after: avoid;
+            break-after: avoid;
+            page-break-inside: avoid;
+            break-inside: avoid;
+        }
+        /* Meta line (completed by / date / comment) belongs with its header
+           and the following table. */
+        .step-meta {
+            page-break-before: avoid;
+            break-before: avoid;
+            page-break-after: avoid;
+            break-after: avoid;
+        }
         .step-badge {
             display: inline-block;
             padding: 2pt 7pt;
@@ -300,7 +326,7 @@ <h3 style="margin-top: 20px;">Attachments</h3>
     <tbody>
     {% for row in section.fields %}
     {% if row.type == 'section' %}
-    <tr>
+    <tr class="step-field-section-row">
         <td colspan="4" class="step-field-section">{{ row.label }}</td>
     </tr>
     {% elif row.type == 'display_text' %}

django_forms_workflows/views.py

@@ -1456,8 +1456,8 @@ def approval_inbox(request):
     # Compute default sort column index for DataTables (submitted_at)
     _exp_off = 1 if (any_exportable or any_pdf_exportable) else 0
     _cat_off = 0 if category_slug else 1
-    # columns: [checkbox?] [category?] actions form submitter stage step_num assigned submitted_at
-    default_sort_col = _exp_off + _cat_off + 1 + 5  # index of submitted_at
+    # columns: [checkbox?] [category?] actions form submitter step_num assigned submitted_at
+    default_sort_col = _exp_off + _cat_off + 1 + 4  # index of submitted_at
 
     return render(
         request,
@@ -4215,7 +4215,6 @@ def approval_inbox_ajax(request):
             "submitter": escape(
                 sub.submitter.get_full_name() or sub.submitter.username
             ),
-            "stage": f"Stage {task.stage_number}" if task.stage_number else "—",
             "step_num": escape(stage_name),
             "assigned": escape(
                 task.assigned_group.name

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "django-forms-workflows"
-version = "0.72.1"
+version = "0.72.2"
 description = "Enterprise-grade, database-driven form builder with approval workflows and external data integration"
 license = "LGPL-3.0-only"
 readme = "README.md"