giles
f9d9697c67
Replace all 676 inline sexp() string calls across 7 services with render(component_name, **kwargs) calls backed by 46 external .sexpr component definition files (587 defcomps total). - Add render() function to shared/sexp/jinja_bridge.py - Add load_service_components() helper and update load_sexp_dir() for *.sexpr - Update parser keyword regex to support HTMX hx-on::event syntax - Convert remaining inline HTML in route files to render() calls - Add shared/sexp/templates/misc.sexp for cross-service utility components Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
388 lines
14 KiB
Python
388 lines
14 KiB
Python
"""
|
|
Orders service s-expression page components.
|
|
|
|
Each function renders a complete page section (full page, OOB, or pagination)
|
|
using shared s-expression components. Called from route handlers in place
|
|
of ``render_template()``.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import os
|
|
from typing import Any
|
|
|
|
from shared.sexp.jinja_bridge import render, load_service_components
|
|
from shared.sexp.helpers import (
|
|
call_url, get_asset_url, root_header_html,
|
|
search_mobile_html, search_desktop_html, full_page, oob_page,
|
|
)
|
|
from shared.infrastructure.urls import market_product_url, cart_url
|
|
|
|
# Load orders-specific .sexpr components at import time
|
|
load_service_components(os.path.dirname(os.path.dirname(__file__)))
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Header helpers (shared auth + orders-specific)
|
|
# ---------------------------------------------------------------------------
|
|
|
|
def _auth_nav_html(ctx: dict) -> str:
|
|
"""Auth section desktop nav items."""
|
|
html = render(
|
|
"nav-link",
|
|
href=call_url(ctx, "account_url", "/newsletters/"),
|
|
label="newsletters",
|
|
select_colours=ctx.get("select_colours", ""),
|
|
)
|
|
account_nav_html = ctx.get("account_nav_html", "")
|
|
if account_nav_html:
|
|
html += account_nav_html
|
|
return html
|
|
|
|
|
|
def _auth_header_html(ctx: dict, *, oob: bool = False) -> str:
|
|
"""Build the account section header row."""
|
|
return render(
|
|
"menu-row",
|
|
id="auth-row", level=1, colour="sky",
|
|
link_href=call_url(ctx, "account_url", "/"),
|
|
link_label="account", icon="fa-solid fa-user",
|
|
nav_html=_auth_nav_html(ctx),
|
|
child_id="auth-header-child", oob=oob,
|
|
)
|
|
|
|
|
|
def _orders_header_html(ctx: dict, list_url: str) -> str:
|
|
"""Build the orders section header row."""
|
|
return render(
|
|
"menu-row",
|
|
id="orders-row", level=2, colour="sky",
|
|
link_href=list_url, link_label="Orders", icon="fa fa-gbp",
|
|
child_id="orders-header-child",
|
|
)
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Orders list rendering
|
|
# ---------------------------------------------------------------------------
|
|
|
|
def _status_pill_cls(status: str) -> str:
|
|
"""Return Tailwind classes for order status pill."""
|
|
sl = status.lower()
|
|
if sl == "paid":
|
|
return "border-emerald-300 bg-emerald-50 text-emerald-700"
|
|
if sl in ("failed", "cancelled"):
|
|
return "border-rose-300 bg-rose-50 text-rose-700"
|
|
return "border-stone-300 bg-stone-50 text-stone-700"
|
|
|
|
|
|
def _order_row_html(order: Any, detail_url: str) -> str:
|
|
"""Render a single order as desktop table row + mobile card."""
|
|
status = order.status or "pending"
|
|
pill = _status_pill_cls(status)
|
|
created = order.created_at.strftime("%-d %b %Y, %H:%M") if order.created_at else "\u2014"
|
|
total = f"{order.currency or 'GBP'} {order.total_amount or 0:.2f}"
|
|
|
|
desktop = render(
|
|
"orders-row-desktop",
|
|
oid=f"#{order.id}", created=created,
|
|
desc=order.description or "", total=total,
|
|
pill=f"inline-flex items-center rounded-full border px-2 py-0.5 text-[11px] sm:text-xs {pill}",
|
|
status=status, url=detail_url,
|
|
)
|
|
|
|
mobile = render(
|
|
"orders-row-mobile",
|
|
oid=f"#{order.id}", created=created, total=total,
|
|
pill=f"inline-flex items-center rounded-full border px-2 py-0.5 text-[11px] {pill}",
|
|
status=status, url=detail_url,
|
|
)
|
|
|
|
return desktop + mobile
|
|
|
|
|
|
def _orders_rows_html(orders: list, page: int, total_pages: int,
|
|
url_for_fn: Any, qs_fn: Any) -> str:
|
|
"""Render order rows + infinite scroll sentinel."""
|
|
from shared.utils import route_prefix
|
|
pfx = route_prefix()
|
|
|
|
parts = [
|
|
_order_row_html(o, pfx + url_for_fn("orders.order.order_detail", order_id=o.id))
|
|
for o in orders
|
|
]
|
|
|
|
if page < total_pages:
|
|
next_url = pfx + url_for_fn("orders.list_orders") + qs_fn(page=page + 1)
|
|
parts.append(render(
|
|
"infinite-scroll",
|
|
url=next_url, page=page, total_pages=total_pages, id_prefix="orders", colspan=5,
|
|
))
|
|
else:
|
|
parts.append(render("orders-end-row"))
|
|
|
|
return "".join(parts)
|
|
|
|
|
|
def _orders_main_panel_html(orders: list, rows_html: str) -> str:
|
|
"""Main panel with table or empty state."""
|
|
if not orders:
|
|
return render("orders-empty-state")
|
|
return render("orders-table", rows_html=rows_html)
|
|
|
|
|
|
def _orders_summary_html(ctx: dict) -> str:
|
|
"""Filter section for orders list."""
|
|
return render("orders-summary", search_mobile_html=search_mobile_html(ctx))
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Public API: orders list
|
|
# ---------------------------------------------------------------------------
|
|
|
|
async def render_orders_page(ctx: dict, orders: list, page: int,
|
|
total_pages: int, search: str | None,
|
|
search_count: int, url_for_fn: Any,
|
|
qs_fn: Any) -> str:
|
|
"""Full page: orders list."""
|
|
from shared.utils import route_prefix
|
|
|
|
ctx["search"] = search
|
|
ctx["search_count"] = search_count
|
|
list_url = route_prefix() + url_for_fn("orders.list_orders")
|
|
|
|
rows = _orders_rows_html(orders, page, total_pages, url_for_fn, qs_fn)
|
|
main = _orders_main_panel_html(orders, rows)
|
|
|
|
hdr = root_header_html(ctx)
|
|
hdr += render(
|
|
"orders-header-child",
|
|
inner_html=_auth_header_html(ctx) + _orders_header_html(ctx, list_url),
|
|
)
|
|
|
|
return full_page(ctx, header_rows_html=hdr,
|
|
filter_html=_orders_summary_html(ctx),
|
|
aside_html=search_desktop_html(ctx),
|
|
content_html=main)
|
|
|
|
|
|
async def render_orders_rows(ctx: dict, orders: list, page: int,
|
|
total_pages: int, url_for_fn: Any,
|
|
qs_fn: Any) -> str:
|
|
"""Pagination: just the table rows."""
|
|
return _orders_rows_html(orders, page, total_pages, url_for_fn, qs_fn)
|
|
|
|
|
|
async def render_orders_oob(ctx: dict, orders: list, page: int,
|
|
total_pages: int, search: str | None,
|
|
search_count: int, url_for_fn: Any,
|
|
qs_fn: Any) -> str:
|
|
"""OOB response for HTMX navigation to orders list."""
|
|
from shared.utils import route_prefix
|
|
|
|
ctx["search"] = search
|
|
ctx["search_count"] = search_count
|
|
list_url = route_prefix() + url_for_fn("orders.list_orders")
|
|
|
|
rows = _orders_rows_html(orders, page, total_pages, url_for_fn, qs_fn)
|
|
main = _orders_main_panel_html(orders, rows)
|
|
|
|
oobs = (
|
|
_auth_header_html(ctx, oob=True)
|
|
+ render(
|
|
"orders-auth-header-child-oob",
|
|
inner_html=_orders_header_html(ctx, list_url),
|
|
)
|
|
+ root_header_html(ctx, oob=True)
|
|
)
|
|
|
|
return oob_page(ctx, oobs_html=oobs,
|
|
filter_html=_orders_summary_html(ctx),
|
|
aside_html=search_desktop_html(ctx),
|
|
content_html=main)
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Single order detail
|
|
# ---------------------------------------------------------------------------
|
|
|
|
def _order_items_html(order: Any) -> str:
|
|
"""Render order items list."""
|
|
if not order or not order.items:
|
|
return ""
|
|
items = []
|
|
for item in order.items:
|
|
prod_url = market_product_url(item.product_slug)
|
|
if item.product_image:
|
|
img = render(
|
|
"orders-item-image",
|
|
src=item.product_image, alt=item.product_title or "Product image",
|
|
)
|
|
else:
|
|
img = render("orders-item-no-image")
|
|
|
|
items.append(render(
|
|
"orders-item-row",
|
|
href=prod_url, img_html=img,
|
|
title=item.product_title or "Unknown product",
|
|
pid=str(item.product_id),
|
|
qty=str(item.quantity),
|
|
price=f"{item.currency or order.currency or 'GBP'} {item.unit_price or 0:.2f}",
|
|
))
|
|
|
|
return render("orders-items-section", items_html="".join(items))
|
|
|
|
|
|
def _calendar_items_html(calendar_entries: list | None) -> str:
|
|
"""Render calendar bookings for an order."""
|
|
if not calendar_entries:
|
|
return ""
|
|
items = []
|
|
for e in calendar_entries:
|
|
st = e.state or ""
|
|
pill = (
|
|
"bg-emerald-100 text-emerald-800" if st == "confirmed"
|
|
else "bg-amber-100 text-amber-800" if st == "provisional"
|
|
else "bg-blue-100 text-blue-800" if st == "ordered"
|
|
else "bg-stone-100 text-stone-700"
|
|
)
|
|
ds = e.start_at.strftime("%-d %b %Y, %H:%M") if e.start_at else ""
|
|
if e.end_at:
|
|
ds += f" \u2013 {e.end_at.strftime('%-d %b %Y, %H:%M')}"
|
|
items.append(render(
|
|
"orders-calendar-item",
|
|
name=e.name,
|
|
pill=f"inline-flex items-center rounded-full px-2 py-0.5 text-[11px] font-medium {pill}",
|
|
state=st.capitalize(), ds=ds,
|
|
cost=f"\u00a3{e.cost or 0:.2f}",
|
|
))
|
|
|
|
return render("orders-calendar-section", items_html="".join(items))
|
|
|
|
|
|
def _order_main_html(order: Any, calendar_entries: list | None) -> str:
|
|
"""Main panel for single order detail."""
|
|
summary = render(
|
|
"order-summary-card",
|
|
order_id=order.id,
|
|
created_at=order.created_at.strftime("%-d %b %Y, %H:%M") if order.created_at else None,
|
|
description=order.description, status=order.status, currency=order.currency,
|
|
total_amount=f"{order.total_amount:.2f}" if order.total_amount else None,
|
|
)
|
|
return render(
|
|
"orders-detail-panel",
|
|
summary_html=summary, items_html=_order_items_html(order),
|
|
calendar_html=_calendar_items_html(calendar_entries),
|
|
)
|
|
|
|
|
|
def _order_filter_html(order: Any, list_url: str, recheck_url: str,
|
|
pay_url: str, csrf_token: str) -> str:
|
|
"""Filter section for single order detail."""
|
|
created = order.created_at.strftime("%-d %b %Y, %H:%M") if order.created_at else "\u2014"
|
|
status = order.status or "pending"
|
|
|
|
pay_html = ""
|
|
if status != "paid":
|
|
pay_html = render("orders-checkout-error-pay-btn", url=pay_url)
|
|
|
|
return render(
|
|
"orders-detail-filter",
|
|
created=created, status=status,
|
|
list_url=list_url, recheck_url=recheck_url,
|
|
csrf=csrf_token, pay_html=pay_html,
|
|
)
|
|
|
|
|
|
async def render_order_page(ctx: dict, order: Any,
|
|
calendar_entries: list | None,
|
|
url_for_fn: Any) -> str:
|
|
"""Full page: single order detail."""
|
|
from shared.utils import route_prefix
|
|
from shared.browser.app.csrf import generate_csrf_token
|
|
|
|
pfx = route_prefix()
|
|
detail_url = pfx + url_for_fn("orders.order.order_detail", order_id=order.id)
|
|
list_url = pfx + url_for_fn("orders.list_orders")
|
|
recheck_url = pfx + url_for_fn("orders.order.order_recheck", order_id=order.id)
|
|
pay_url = pfx + url_for_fn("orders.order.order_pay", order_id=order.id)
|
|
|
|
main = _order_main_html(order, calendar_entries)
|
|
filt = _order_filter_html(order, list_url, recheck_url, pay_url, generate_csrf_token())
|
|
|
|
# Header stack: root -> auth -> orders -> order
|
|
hdr = root_header_html(ctx)
|
|
order_row = render(
|
|
"menu-row",
|
|
id="order-row", level=3, colour="sky", link_href=detail_url,
|
|
link_label="Order", icon="fa fa-gbp",
|
|
)
|
|
hdr += render(
|
|
"orders-detail-header-stack",
|
|
auth_html=_auth_header_html(ctx),
|
|
orders_html=_orders_header_html(ctx, list_url),
|
|
order_html=order_row,
|
|
)
|
|
|
|
return full_page(ctx, header_rows_html=hdr, filter_html=filt, content_html=main)
|
|
|
|
|
|
async def render_order_oob(ctx: dict, order: Any,
|
|
calendar_entries: list | None,
|
|
url_for_fn: Any) -> str:
|
|
"""OOB response for single order detail."""
|
|
from shared.utils import route_prefix
|
|
from shared.browser.app.csrf import generate_csrf_token
|
|
|
|
pfx = route_prefix()
|
|
detail_url = pfx + url_for_fn("orders.order.order_detail", order_id=order.id)
|
|
list_url = pfx + url_for_fn("orders.list_orders")
|
|
recheck_url = pfx + url_for_fn("orders.order.order_recheck", order_id=order.id)
|
|
pay_url = pfx + url_for_fn("orders.order.order_pay", order_id=order.id)
|
|
|
|
main = _order_main_html(order, calendar_entries)
|
|
filt = _order_filter_html(order, list_url, recheck_url, pay_url, generate_csrf_token())
|
|
|
|
order_row_oob = render(
|
|
"menu-row",
|
|
id="order-row", level=3, colour="sky", link_href=detail_url,
|
|
link_label="Order", icon="fa fa-gbp", oob=True,
|
|
)
|
|
oobs = (
|
|
render("orders-header-child-oob", inner_html=order_row_oob)
|
|
+ root_header_html(ctx, oob=True)
|
|
)
|
|
|
|
return oob_page(ctx, oobs_html=oobs, filter_html=filt, content_html=main)
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Public API: Checkout error
|
|
# ---------------------------------------------------------------------------
|
|
|
|
def _checkout_error_filter_html() -> str:
|
|
return render("orders-checkout-error-header")
|
|
|
|
|
|
def _checkout_error_content_html(error: str | None, order: Any | None) -> str:
|
|
err_msg = error or "Unexpected error while creating the hosted checkout session."
|
|
order_html = ""
|
|
if order:
|
|
order_html = render("orders-checkout-error-order-id", oid=f"#{order.id}")
|
|
back_url = cart_url("/")
|
|
return render(
|
|
"orders-checkout-error-content",
|
|
msg=err_msg, order_html=order_html, back_url=back_url,
|
|
)
|
|
|
|
|
|
async def render_checkout_error_page(ctx: dict, error: str | None = None, order: Any | None = None) -> str:
|
|
"""Full page: checkout error."""
|
|
hdr = root_header_html(ctx)
|
|
hdr += render(
|
|
"orders-header-child",
|
|
inner_html=_auth_header_html(ctx),
|
|
)
|
|
filt = _checkout_error_filter_html()
|
|
content = _checkout_error_content_html(error, order)
|
|
return full_page(ctx, header_rows_html=hdr, filter_html=filt, content_html=content)
|