029b02ff18
All checks were successful
Build and Deploy / build-and-deploy (push) Successful in 1m46s
Phases 1-3 split models by domain ownership, but cross-app imports still exist (e.g. cart imports market.models.CartItem). In Docker each app only has its own code. The CI step now copies sibling app model packages into the build context before docker build. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Cart App
Shopping cart, checkout, and order management service for the Rose Ash cooperative marketplace.
Overview
This is the cart microservice, split from the Rose Ash monolith. It handles:
- Shopping cart - Add/remove products, view cart, cart summary API
- Checkout - SumUp payment integration with hosted checkout
- Orders - Order listing, detail view, payment status tracking
- Calendar bookings - Calendar entry cart items and checkout integration
Architecture
- Framework: Quart (async Flask)
- Database: PostgreSQL 16 via SQLAlchemy 2.0 (async)
- Payments: SumUp Hosted Checkout
- Frontend: HTMX + Jinja2 templates + Tailwind CSS
Directory Structure
app.py # Quart application factory
bp/
cart/ # Cart blueprint (add, view, checkout, webhooks)
routes.py
api.py # Internal API (server-to-server, CSRF-exempt)
login_helper.py # Cart merge on login
services/ # Business logic layer
order/ # Single order detail blueprint
routes.py
filters/qs.py # Query string helpers
orders/ # Order listing blueprint
routes.py
filters/qs.py
templates/
_types/cart/ # Cart templates
_types/order/ # Single order templates
_types/orders/ # Order listing templates
entrypoint.sh # Docker entrypoint (migrations + server start)
Dockerfile # Container build
.gitea/workflows/ci.yml # CI/CD pipeline
Running
# Set environment variables
export APP_MODULE=app:app
export DATABASE_URL_ASYNC=postgresql+asyncpg://user:pass@localhost/coop
export REDIS_URL=redis://localhost:6379/0
export SECRET_KEY=your-secret-key
# Run the server
hypercorn app:app --reload --bind 0.0.0.0:8002
Cross-App Communication
The cart app exposes internal API endpoints at /internal/cart/ for other services:
GET /internal/cart/summary- Cart count and total for the current session/userPOST /internal/cart/adopt- Adopt anonymous cart items after user login
Docker
docker build -t cart:latest .
docker run -p 8002:8000 --env-file .env cart:latest