feat: inventory PDF export via headless and report refinements

- Add admin-only /api/orders/inventory.pdf route that 303-redirects
  the user agent to the Headless service (headless.bemisc.com) with
  a URL pointing back at the HTML inventory report, authenticated
  via the admin account's own secret key (skey query parameter).
- Expose the new export as "Inventory PDF" via a context link on
  the Order model alongside the existing "Inventory Report" entry.
- Configure via BUDY_HEADLESS_URL and BUDY_HEADLESS_KEY; use
  appier's url_for absolute mode so BASE_URL drives the public
  report URL handed to Headless.
- Polish the A4 print stylesheet: switch the line-items table to
  border-collapse: collapse so headers, footers and side rules
  repeat cleanly across page breaks; keep thead/tfoot at 1pt and
  body rows at 0.5pt; use a 2pt top rule (with no extra padding)
  to mark order boundaries so operators can spot the transition.
- Carry thumbnails into the print output with a compact 8mm cell.
- Suffix every quantity cell (inventory and order reports, body
  rows and footer totals, plus the inventory Summary total units)
  with an "x" unit for readability.

Author: joamag

CHANGELOG.md

@@ -11,6 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * Inventory HTML report for selected orders at `/api/orders/inventory`, available from the admin via the "Inventory Report" context link
 * Per-order HTML report at `/api/orders/<id>/report`, available from the admin via the "Report" link and cross-linked from the inventory report rows
+* Inventory PDF export at `/api/orders/inventory.pdf` that renders the inventory report via the Headless service and streams the resulting PDF inline; admin-only and reachable via the new "Inventory PDF" context link. Requires `BASE_URL`, `BUDY_HEADLESS_URL` and `BUDY_HEADLESS_KEY` configuration
 * Reusable `report/base.html.tpl` template with a typographic, mailog-inspired look and a dedicated `report.css` stylesheet
 * A4 portrait print stylesheet for the inventory report, with a per-row tick box column, repeating table header and `Page X of Y` numbering
 * `scripts/load_inventory_demo.py` utility for populating a local Budy instance with sample products and orders to exercise the inventory report

src/budy/controllers/api/order.py

@@ -335,6 +335,44 @@ def inventory(self):
             generated_by=generated_by,
         )
 
+    @appier.route("/api/orders/inventory.pdf", "GET")
+    @appier.ensure(token="admin")
+    def inventory_pdf(self):
+        start = self.field("start", cast=int)
+        end = self.field("end", cast=int)
+        paid = self.field("paid", True, cast=bool)
+        thumbnail = self.field("thumbnail", True, cast=bool)
+        view = self.field("view")
+        context = self.field("context")
+        headless_url = appier.conf("BUDY_HEADLESS_URL", "https://headless.bemisc.com")
+        headless_key = appier.conf("BUDY_HEADLESS_KEY", None)
+        appier.verify(not headless_key == None)
+        account = self.admin_account.from_session()
+        account = account.reload(rules=False)
+        params = dict(paid=paid, thumbnail=thumbnail, skey=account.key)
+        if start:
+            params["start"] = start
+        if end:
+            params["end"] = end
+        if view:
+            params["view"] = view
+        if context:
+            params["context"] = context
+        report_url = appier.get_app().url_for(
+            "order_api.inventory", absolute=True, **params
+        )
+        return self.redirect(
+            headless_url,
+            params=dict(
+                url=report_url,
+                format="pdf",
+                page_format="A4",
+                wait_until="networkidle0",
+                timeout=60000,
+                key=headless_key,
+            ),
+        )
+
     def _format_quantity(self, quantity):
         quantity_int = int(quantity)
         if quantity_int == quantity:

src/budy/models/order.py

@@ -236,6 +236,13 @@ def inventory_url(cls, view=None, context=None, absolute=False):
             "order_api.inventory", view=view, context=context, absolute=absolute
         )
 
+    @classmethod
+    @appier.link(name="Inventory PDF", context=True)
+    def inventory_pdf_url(cls, view=None, context=None, absolute=False):
+        return appier.get_app().url_for(
+            "order_api.inventory_pdf", view=view, context=context, absolute=absolute
+        )
+
     @classmethod
     @appier.operation(
         name="Import CTT",

src/budy/static/css/report.css

@@ -272,7 +272,6 @@ body {
 
 .report-table tbody tr.report-table-order-first td {
     border-top: 1px solid #d0d0d0;
-    padding-top: 22px;
 }
 
 .report-table .report-table-mono {
@@ -360,6 +359,8 @@ body {
 
 /* -- Print (A4 portrait, high contrast B&W) -- */
 @page {
+    size: A4 portrait;
+    margin: 10mm 10mm 10mm 10mm;
     @bottom-right {
         color: #000000;
         content: "Page " counter(page) " of " counter(pages);
@@ -460,7 +461,8 @@ body {
     }
     .report-table {
         background: transparent;
-        border: 1pt solid #000000;
+        border: none;
+        border-collapse: collapse;
         border-radius: 0px 0px 0px 0px;
         -o-border-radius: 0px 0px 0px 0px;
         -ms-border-radius: 0px 0px 0px 0px;
@@ -475,6 +477,7 @@ body {
     }
     .report-table thead th {
         background: transparent;
+        border-top: 1pt solid #000000;
         border-bottom: 1pt solid #000000;
         color: #000000;
         font-size: 9pt;
@@ -494,8 +497,7 @@ body {
         background: transparent;
     }
     .report-table tbody tr.report-table-order-first td {
-        border-top: 0.5pt solid #000000;
-        padding-top: 10pt;
+        border-top: 2pt solid #000000;
     }
     .report-table .report-table-mono {
         font-size: 10pt;
@@ -507,6 +509,7 @@ body {
     .report-table tfoot td {
         background: transparent;
         border-top: 1pt solid #000000;
+        border-bottom: 1pt solid #000000;
         color: #000000;
         font-size: 10pt;
         padding: 4pt 6pt 4pt 6pt;

src/budy/templates/report/inventory.html.tpl

@@ -20,7 +20,7 @@
         {% for entry in order_references %}<a href="{{ url_for('order_api.report', id = entry.id) }}" target="_blank">{{ entry.reference }}</a>{% if not loop.last %}, {% endif %}{% else %}-{% endfor %}
     </dd>
     <dt class="report-dt">Total Units</dt>
-    <dd class="report-dd">{{ total_units }}</dd>
+    <dd class="report-dd">{{ total_units }} x</dd>
     <dt class="report-dt">Generated By</dt>
     <dd class="report-dd">{{ generated_by or "-" }}</dd>
 {% endblock %}
@@ -56,7 +56,7 @@
                         <td>{{ row.short_description }}</td>
                         <td>{{ row.gender }}</td>
                         <td class="report-table-mono">{{ row.size }}</td>
-                        <td class="report-table-quantity">{{ row.quantity }}</td>
+                        <td class="report-table-quantity">{{ row.quantity }} x</td>
                     </tr>
                 {% endfor %}
             </tbody>
@@ -65,7 +65,7 @@
                     <td class="report-table-check"></td>
                     {% if thumbnail %}<td class="report-table-thumbnail"></td>{% endif %}
                     <td colspan="5">Total</td>
-                    <td class="report-table-quantity">{{ total_units }}</td>
+                    <td class="report-table-quantity">{{ total_units }} x</td>
                 </tr>
             </tfoot>
         </table>

src/budy/templates/report/order.html.tpl

@@ -128,15 +128,15 @@
                         <td>{{ row.gender }}</td>
                         <td class="report-table-mono">{{ row.size }}</td>
                         <td class="report-table-quantity">{{ "%.2f" % row.price }} {{ row.currency or "" }}</td>
-                        <td class="report-table-quantity">{{ row.quantity }}</td>
+                        <td class="report-table-quantity">{{ row.quantity }} x</td>
                         <td class="report-table-quantity">{{ "%.2f" % row.total }} {{ row.currency or "" }}</td>
                     </tr>
                 {% endfor %}
             </tbody>
             <tfoot>
                 <tr>
                     <td colspan="5">Total</td>
-                    <td class="report-table-quantity">{{ total_units }}</td>
+                    <td class="report-table-quantity">{{ total_units }} x</td>
                     <td class="report-table-quantity report-total-emph">{{ "%.2f" % order.total }} {{ order.currency or "" }}</td>
                 </tr>
             </tfoot>