jamey 51d9504f6b docs: add admin provider setup task and update project guidelines

- add detailed task spec for /admin/providers UI with webhook integration
- add product sync strategy with manual, webhook, and scheduled sync
- update PROGRESS.md to prioritise admin provider UI as next task
- add writing style guidelines (british english, sentence case, concise)
- add commit guidelines (atomic, imperative, suggest at checkpoints)
- add pragmatic testing guidelines (test boundaries, skip trivial)

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

2026-01-31 14:25:06 +00:00

3.3 KiB

Raw Blame History

SimpleShop Progress

Single source of truth for project status and task tracking.

Current Status

Working:

Theme editor with 8 presets, instant switching, full customization
Image optimization pipeline (AVIF/WebP/JPEG responsive variants)
Shop pages (home, collections, products, cart, about, contact)
Mobile-first design with bottom navigation
100% PageSpeed score

In Progress:

Products context with provider integration (Phase 1 complete)

Next Up

Admin Provider Setup UI (/admin/providers) - Add/edit/test provider connections
Product Sync Strategy:
- ProductSyncWorker (Oban) for manual/scheduled sync
- Webhook endpoint for real-time updates from Printify
Wire Products context to shop LiveViews (replace PreviewData)
Session-based cart with real variants

Feature Areas

Theme System

Status: Complete

8 theme presets (Gallery, Studio, Boutique, etc.)
Three-layer CSS architecture (primitives, attributes, semantic)
Instant theme switching via CSS custom property injection
Logo/header image uploads with SVG recoloring
Self-hosted fonts (10 typefaces, GDPR compliant)
ETS-cached CSS generation

Image Optimization

Status: Complete

Oban background job processing
Responsive <picture> element (AVIF/WebP/JPEG)
Only generates sizes <= source dimensions
Disk cache for variants (regenerable from DB)
mix optimize_images task for mockups
On-demand JPEG fallback generation

See: docs/plans/image-optimization.md for implementation details

Products & Provider Integration

Status: In Progress

Completed

Products context with schemas (c5c06d9)
Provider abstraction layer
Printify client integration
Product/variant/image schemas

Remaining Tasks

Admin Provider Setup UI - /admin/providers for managing connections (~2hr) ← NEXT
Create ProductSyncWorker (Oban) for manual/scheduled sync (~1hr)
Printify webhook endpoint for real-time product updates (~1.5hr)
Wire shop LiveViews to Products context (~2hr)
Add variant selector component (~2hr)

See: docs/plans/products-context.md for implementation details

Cart & Checkout

Status: Planned

Session-based cart module
Cart LiveView with real variants
Stripe Checkout integration
Order creation and persistence

See: ROADMAP.md for design notes

Orders & Fulfillment

Status: Planned

Orders context with schemas
Order submission to Printify
Order status tracking
Customer notifications

See: docs/plans/products-context.md for schema design

Page Builder

Status: Future

Database-driven pages with drag-and-drop sections.

See: docs/plans/page-builder.md for design

Completed Work Reference

Feature	Commit	Notes
Products context Phase 1	`c5c06d9`	Schemas, provider abstraction
Oban Lifeline plugin	`c1e1988`	Rescue orphaned jobs
Image optimization	Multiple	Full pipeline complete
Self-hosted fonts	-	10 typefaces, 728KB
Mobile bottom nav	-	Fixed tab bar
PageSpeed 100%	-	All optimizations
Theme presets (8)	-	Gallery, Studio, etc.

3.3 KiB Raw Blame History