# Market App

Product browsing and marketplace application for the Rose Ash cooperative.

## Overview

The Market app is one of three microservices split from the original coop monolith:

- **coop** (:8000) - Blog, calendar, auth, settings
- **market** (:8001) - Product browsing, categories, product detail
- **cart** (:8002) - Shopping cart, orders, payments

## Architecture

- **Framework:** Quart (async Flask)
- **Database:** PostgreSQL 16 with SQLAlchemy 2.0 (async)
- **Cache:** Redis (tag-based page cache)
- **Frontend:** HTMX + Jinja2 + Tailwind CSS
- **Data:** Products scraped from Suma Wholesale

## Blueprints

- `bp/market/` - Market root (navigation, category listing)
- `bp/browse/` - Product browsing with filters and infinite scroll
- `bp/product/` - Product detail pages
- `bp/api/` - Product sync API (used by scraper)

## Development

    # Install dependencies
    pip install -r requirements.txt

    # Set environment variables
    export $(grep -v '^#' .env | xargs)

    # Run migrations
    alembic upgrade head

    # Scrape products
    bash scrape.sh

    # Run the dev server
    hypercorn app:app --reload --bind 0.0.0.0:8001

## Scraping

    # Full scrape (max 50 pages, 200k products, 8 concurrent)
    bash scrape.sh

    # Test scraping
    bash scrape-test.sh

## Docker

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

## Environment Variables

    DATABASE_URL_ASYNC=postgresql+asyncpg://user:pass@localhost/coop
    REDIS_URL=redis://localhost:6379/0
    SECRET_KEY=your-secret-key
    SUMA_USER=your-suma-username
    SUMA_PASSWORD=your-suma-password
    APP_URL_COOP=http://localhost:8000
    APP_URL_MARKET=http://localhost:8001
    APP_URL_CART=http://localhost:8002