Files
mono/cart
giles ab75e505a8 Add macros, declarative handlers (defhandler), and convert all fragment routes to sx
Phase 1 — Macros: defmacro + quasiquote syntax (`, ,, ,@) in parser,
evaluator, HTML renderer, and JS mirror. Macro type, expansion, and
round-trip serialization.

Phase 2 — Expanded primitives: app-url, url-for, asset-url, config,
format-date, parse-int (pure); service, request-arg, request-path,
nav-tree, get-children (I/O); jinja-global, relations-from (pure).
Updated _io_service to accept (service "registry-name" "method" :kwargs)
with auto kebab→snake conversion. DTO-to-dict now expands datetime fields
into year/month/day convenience keys. Tuple returns converted to lists.

Phase 3 — Declarative handlers: HandlerDef type, defhandler special form,
handler registry (service → name → HandlerDef), async evaluator+renderer
(async_eval.py) that awaits I/O primitives inline within control flow.
Handler loading from .sx files, execute_handler, blueprint factory.

Phase 4 — Convert all fragment routes: 13 Python fragment handlers across
8 services replaced with declarative .sx handler files. All routes.py
simplified to uniform sx dispatch pattern. Two Jinja HTML handlers
(events/container-cards, events/account-page) kept as Python.

New files: shared/sx/async_eval.py, shared/sx/handlers.py,
shared/sx/tests/test_handlers.py, plus 13 handler .sx files under
{service}/sx/handlers/. MarketService.product_by_slug() added.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 00:22:18 +00:00
..
2026-02-24 20:13:00 +00:00

Cart App

Shopping cart, checkout, and order management service for the Rose Ash cooperative. Integrates with SumUp for payment processing.

Structure

app.py                  # Application factory (create_base_app + blueprints)
path_setup.py           # Adds project root + app dir to sys.path
entrypoint.sh           # Container entrypoint (Redis flush, start)
bp/
  cart/                 # Cart blueprint
    global_routes.py    #   Add to cart, checkout, webhooks, return page
    page_routes.py      #   Page-scoped cart and checkout
    overview_routes.py  #   Cart overview / summary page
    services/           #   Business logic
      checkout.py       #     Order creation, SumUp integration
      check_sumup_status.py  #  Payment status polling
      calendar_cart.py  #     Calendar entry cart queries
      page_cart.py      #     Page-scoped cart queries
      get_cart.py       #     Cart item queries
      identity.py       #     Cart identity (user_id / session_id)
      total.py          #     Price calculations
      clear_cart_for_order.py  # Soft-delete cart after checkout
  order/                # Single order detail view
  orders/               # Order listing view
  fragments/            # cart-mini fragment, account-nav-item fragment
models/                 # Re-export stubs (Order, OrderItem, PageConfig)
services/               # register_domain_services() — wires cart + calendar + market
templates/              # Cart-specific templates (override shared/)

Cart identity

Cart items are keyed by user_id (logged in) or session_id (anonymous). On login, anonymous cart items are adopted to the user's account.

Cross-domain communication

  • services.calendar.* — claim/confirm entries for orders, adopt on login
  • services.market.* — marketplace queries for page-scoped carts
  • services.blog.* — post lookup for page context

Fragments served

  • cart-mini — cart icon + badge count
  • account-nav-item — orders link for account nav

Checkout flow

  1. User clicks "Checkout"
  2. create_order_from_cart() creates Order + OrderItems
  3. services.calendar.claim_entries_for_order() marks entries as "ordered"
  4. Emits Create / rose:Order activity
  5. SumUp hosted checkout created, user redirected
  6. SumUp webhook / return page triggers check_sumup_status()
  7. If PAID: services.calendar.confirm_entries_for_order(), emits rose:OrderPaid