e1f9c964f5
All checks were successful
Build and Deploy / build-and-deploy (push) Successful in 2m56s
Remove stale submodule references, port numbers, and Running sections. Add fragment composition details. Create READMEs for federation and account. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
57 lines
2.4 KiB
Markdown
57 lines
2.4 KiB
Markdown
# 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`
|