Archived

This repository has been archived on 2026-02-24. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Files

giles a29612ffa4

Build and Deploy / build-and-deploy (push) Successful in 55s

Details

Rewrite README for post-decoupling architecture

Fix microservice count (4 not 3), document submodules, models,
scraper, all blueprints including bp/cart/, and cross-app integration.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-14 19:28:56 +00:00

2.6 KiB

Raw Blame History

Market App

Product browsing and marketplace service for the Rose Ash cooperative. Displays products scraped from Suma Wholesale.

Architecture

One of four Quart microservices sharing a single PostgreSQL database:

App	Port	Domain
blog (coop)	8000	Auth, blog, admin, menus, snippets
market	8001	Product browsing, Suma scraping
cart	8002	Shopping cart, checkout, orders
events	8003	Calendars, bookings, tickets

Structure

app.py                  # Application factory (create_base_app + blueprints)
path_setup.py           # Adds project root + app dir to sys.path
config/app-config.yaml  # App URLs, feature flags
models/                 # Market-domain models
  market.py             #   Product, Category, CartItem
  market_place.py       #   MarketPlace (page-scoped marketplace)
bp/                     # Blueprints
  market/               #   Market root, navigation, category listing
  browse/               #   Product browsing with filters and infinite scroll
  product/              #   Product detail pages
  cart/                 #   Page-scoped cart views
  api/                  #   Product sync API (used by scraper)
scrape/                 # Suma Wholesale scraper
  get_auth.py           #   Authentication
  listings.py           #   Product listing pages
  nav.py                #   Category navigation
  product/              #   Individual product scraping
  build_snapshot/       #   Build product snapshots
  persist_snapshot/     #   Save snapshots to DB
  persist_api/          #   Save via API
templates/              # Jinja2 templates
entrypoint.sh           # Docker entrypoint
Dockerfile
shared/                 # Submodule → git.rose-ash.com/coop/shared.git
glue/                   # Submodule → git.rose-ash.com/coop/glue.git

Cross-App Integration

Cart: "Add to cart" posts to cart app. Cart widget fetched via internal API.
Blog: Post/page data fetched via internal API for page-scoped marketplaces.
Glue: MarketPlace uses generic containers (container_type + container_id) to attach to pages without FK coupling.

Scraping

# Full scrape (Suma Wholesale catalogue)
bash scrape.sh

# Test scraping (limited)
bash scrape-test.sh

Running

export DATABASE_URL_ASYNC=postgresql+asyncpg://user:pass@localhost/coop
export REDIS_URL=redis://localhost:6379/0
export SECRET_KEY=your-secret-key
export SUMA_USER=your-suma-username
export SUMA_PASSWORD=your-suma-password

hypercorn app:app --reload --bind 0.0.0.0:8001

Docker

docker build -t market .
docker run -p 8001:8000 --env-file .env market

2.6 KiB Raw Blame History