How wayne-kiprotich/snug-co-server works
Snug & Co. is a Flask catalog API and admin backend, with a shopper wishlist/cart that requires no account. The main workflow is an admin signing in, managing catalog content and photos, and the storefront reading the resulting catalog; shoppers can separately check product availability and maintain a cookie-backed cart or wishlist. The graph also preserves authentication/security, serialization, image delivery, and setup/legacy-import capabilities. Some route and storage details are inferred only from the README or source index; those links cite that evidence rather than implying unsampled code was inspected.
Main entry points: admin.py Admin catalog API · shopper.py Wishlist and cart API · models.py Catalog and settings · auth.py Admin auth
Components 18
API and access
- Flask app
app/__init__.py - Admin auth
app/routes/auth.py - Session security
app/security.py - Public catalog API
app/routes/public.py
Catalog management
- Admin catalog API
app/routes/admin.py - Input validation
app/validation.py - Catalog serialization
app/serializers.py - Catalog and settings
app/models.py
Shopper features
- Wishlist and cart API
app/routes/shopper.py - Signed shopper state
app/routes/shopper.py
Image lifecycle
- Image processing and storage
app/images.py - Cloudinary
- Development uploads
app/images.py
Operations and data
- Seed and admin CLI
app/cli.py - Legacy image migration
app/legacy.py - SQL database
app/extensions.py
Other components
- Admin
- Storefront
Connections 30
- Admin → Admin auth: signs in
README.md - Storefront → Public catalog API: reads catalog
README.md - Storefront → Wishlist and cart API: uses shopper API
README.md - Flask app → Admin auth: registers
app/__init__.py - Flask app → Admin catalog API: registers
app/__init__.py - Flask app → Public catalog API: registers
app/__init__.py - Flask app → Wishlist and cart API: registers
app/__init__.py - Admin auth → Session security: uses sessions
app/routes/auth.py - Admin auth → Catalog and settings: reads and updates
app/routes/auth.py - Admin catalog API → Catalog and settings: manages records
app/routes/admin.py - Admin catalog API → Input validation: validates input
app/routes/admin.py - Admin catalog API → Session security: checks access
app/routes/admin.py - Admin catalog API → Image processing and storage: stores and deletes
app/routes/admin.py - Admin catalog API → Catalog serialization: builds responses
app/routes/admin.py - Public catalog API → Catalog and settings: queries catalog
app/routes/public.py - Public catalog API → Catalog serialization: formats responses
app/routes/public.py - Wishlist and cart API → Signed shopper state: loads and saves
README.md - Wishlist and cart API → Catalog and settings: checks products
app/routes/shopper.py - Wishlist and cart API → Catalog serialization: formats products
app/routes/shopper.py - Catalog serialization → Image processing and storage: builds image URLs
app/serializers.py - Image processing and storage → Cloudinary: uploads and deletes
README.md - Image processing and storage → Development uploads: uses in development
app/images.py - Admin catalog API → SQL database: persists changes
app/routes/admin.py - Admin auth → SQL database: persists account changes
app/routes/auth.py - Public catalog API → SQL database: reads catalog
app/routes/public.py - Wishlist and cart API → SQL database: reads catalog
app/routes/shopper.py - Seed and admin CLI → Catalog and settings: seeds catalog
app/cli.py - Seed and admin CLI → Legacy image migration: registers commands
app/cli.py - Legacy image migration → Catalog and settings: updates image rows
app/legacy.py - Legacy image migration → Image processing and storage: copies image assets
app/legacy.py