# wayne-kiprotich/snug-co-server architecture

> Architecture diagram of the GitHub repository wayne-kiprotich/snug-co-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wayne-kiprotich/snug-co-server
- Repository: https://github.com/wayne-kiprotich/snug-co-server

## Overview

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: [`app/routes/admin.py`](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/admin.py) (Admin catalog API), [`app/routes/shopper.py`](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/shopper.py) (Wishlist and cart API), [`app/models.py`](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/models.py) (Catalog and settings), [`app/routes/auth.py`](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/auth.py) (Admin auth)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["API and access"]
  node_flask_app["Flask app<br/>[__init__.py]"]
  node_auth_routes["Admin auth<br/>[auth.py]"]
  node_security["Session security<br/>[security.py]"]
  node_public_routes["Public catalog API<br/>[public.py]"]
end

subgraph group_catalog["Catalog management"]
  node_admin_routes["Admin catalog API<br/>[admin.py]"]
  node_validation["Input validation<br/>[validation.py]"]
  node_serializers["Catalog serialization<br/>[serializers.py]"]
  node_catalog_data[("Catalog and settings<br/>[models.py]")]
end

subgraph group_shopper["Shopper features"]
  node_shopper_routes["Wishlist and cart API<br/>[shopper.py]"]
  node_shopper_cookie["Signed shopper state<br/>[shopper.py]"]
end

subgraph group_media["Image lifecycle"]
  node_image_service["Image processing and storage<br/>[images.py]"]
  node_cloudinary["Cloudinary"]
  node_local_uploads["Development uploads<br/>[images.py]"]
end

subgraph group_operations["Operations and data"]
  node_cli["Seed and admin CLI<br/>[cli.py]"]
  node_legacy_import["Legacy image migration<br/>[legacy.py]"]
  node_database[("SQL database<br/>[extensions.py]")]
end

node_admin_user(("Admin"))
node_storefront(("Storefront"))

node_admin_user -->|"signs in"| node_auth_routes
node_storefront -->|"reads catalog"| node_public_routes
node_storefront -->|"uses shopper API"| node_shopper_routes
node_flask_app -->|"registers"| node_auth_routes
node_flask_app -->|"registers"| node_admin_routes
node_flask_app -->|"registers"| node_public_routes
node_flask_app -->|"registers"| node_shopper_routes
node_auth_routes -->|"uses sessions"| node_security
node_auth_routes -->|"reads and updates"| node_catalog_data
node_admin_routes -->|"manages records"| node_catalog_data
node_admin_routes -->|"validates input"| node_validation
node_admin_routes -->|"checks access"| node_security
node_admin_routes -->|"stores and deletes"| node_image_service
node_admin_routes -->|"builds responses"| node_serializers
node_public_routes -->|"queries catalog"| node_catalog_data
node_public_routes -->|"formats responses"| node_serializers
node_shopper_routes -->|"loads and saves"| node_shopper_cookie
node_shopper_routes -->|"checks products"| node_catalog_data
node_shopper_routes -->|"formats products"| node_serializers
node_serializers -->|"builds image URLs"| node_image_service
node_image_service -->|"uploads and deletes"| node_cloudinary
node_image_service -->|"uses in development"| node_local_uploads
node_admin_routes -->|"persists changes"| node_database
node_auth_routes -->|"persists account changes"| node_database
node_public_routes -->|"reads catalog"| node_database
node_shopper_routes -->|"reads catalog"| node_database
node_cli -->|"seeds catalog"| node_catalog_data
node_cli -->|"registers commands"| node_legacy_import
node_legacy_import -->|"updates image rows"| node_catalog_data
node_legacy_import -->|"copies image assets"| node_image_service

click node_flask_app "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/__init__.py"
click node_auth_routes "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/auth.py"
click node_security "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/security.py"
click node_public_routes "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/public.py"
click node_admin_routes "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/admin.py"
click node_validation "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/validation.py"
click node_serializers "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/serializers.py"
click node_catalog_data "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/models.py"
click node_shopper_routes "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/shopper.py"
click node_shopper_cookie "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/shopper.py"
click node_image_service "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/images.py"
click node_local_uploads "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/images.py"
click node_cli "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/cli.py"
click node_legacy_import "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/legacy.py"
click node_database "https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/extensions.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_flask_app,node_auth_routes,node_security,node_public_routes toneBlue
class node_admin_routes,node_validation,node_serializers,node_catalog_data toneAmber
class node_shopper_routes,node_shopper_cookie toneMint
class node_image_service,node_cloudinary,node_local_uploads toneRose
class node_cli,node_legacy_import,node_database,node_admin_user,node_storefront toneIndigo
```

## Components

### API and access

- [Flask app](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/__init__.py): `app/__init__.py`
- [Admin auth](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/auth.py): `app/routes/auth.py`
- [Session security](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/security.py): `app/security.py`
- [Public catalog API](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/public.py): `app/routes/public.py`

### Catalog management

- [Admin catalog API](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/admin.py): `app/routes/admin.py`
- [Input validation](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/validation.py): `app/validation.py`
- [Catalog serialization](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/serializers.py): `app/serializers.py`
- [Catalog and settings](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/models.py): `app/models.py`

### Shopper features

- [Wishlist and cart API](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/shopper.py): `app/routes/shopper.py`
- [Signed shopper state](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/routes/shopper.py): `app/routes/shopper.py`

### Image lifecycle

- [Image processing and storage](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/images.py): `app/images.py`
- **Cloudinary**
- [Development uploads](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/images.py): `app/images.py`

### Operations and data

- [Seed and admin CLI](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/cli.py): `app/cli.py`
- [Legacy image migration](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/legacy.py): `app/legacy.py`
- [SQL database](https://github.com/wayne-kiprotich/snug-co-server/blob/main/app/extensions.py): `app/extensions.py`

### Other components

- **Admin**
- **Storefront**

## Connections

- Admin → Admin auth: signs in (evidence: `README.md`)
- Storefront → Public catalog API: reads catalog (evidence: `README.md`)
- Storefront → Wishlist and cart API: uses shopper API (evidence: `README.md`)
- Flask app → Admin auth: registers (evidence: `app/__init__.py`)
- Flask app → Admin catalog API: registers (evidence: `app/__init__.py`)
- Flask app → Public catalog API: registers (evidence: `app/__init__.py`)
- Flask app → Wishlist and cart API: registers (evidence: `app/__init__.py`)
- Admin auth → Session security: uses sessions (evidence: `app/routes/auth.py`)
- Admin auth → Catalog and settings: reads and updates (evidence: `app/routes/auth.py`)
- Admin catalog API → Catalog and settings: manages records (evidence: `app/routes/admin.py`)
- Admin catalog API → Input validation: validates input (evidence: `app/routes/admin.py`)
- Admin catalog API → Session security: checks access (evidence: `app/routes/admin.py`)
- Admin catalog API → Image processing and storage: stores and deletes (evidence: `app/routes/admin.py`)
- Admin catalog API → Catalog serialization: builds responses (evidence: `app/routes/admin.py`)
- Public catalog API → Catalog and settings: queries catalog (evidence: `app/routes/public.py`)
- Public catalog API → Catalog serialization: formats responses (evidence: `app/routes/public.py`)
- Wishlist and cart API → Signed shopper state: loads and saves (evidence: `README.md`)
- Wishlist and cart API → Catalog and settings: checks products (evidence: `app/routes/shopper.py`)
- Wishlist and cart API → Catalog serialization: formats products (evidence: `app/routes/shopper.py`)
- Catalog serialization → Image processing and storage: builds image URLs (evidence: `app/serializers.py`)
- Image processing and storage → Cloudinary: uploads and deletes (evidence: `README.md`)
- Image processing and storage → Development uploads: uses in development (evidence: `app/images.py`)
- Admin catalog API → SQL database: persists changes (evidence: `app/routes/admin.py`)
- Admin auth → SQL database: persists account changes (evidence: `app/routes/auth.py`)
- Public catalog API → SQL database: reads catalog (evidence: `app/routes/public.py`)
- Wishlist and cart API → SQL database: reads catalog (evidence: `app/routes/shopper.py`)
- Seed and admin CLI → Catalog and settings: seeds catalog (evidence: `app/cli.py`)
- Seed and admin CLI → Legacy image migration: registers commands (evidence: `app/cli.py`)
- Legacy image migration → Catalog and settings: updates image rows (evidence: `app/legacy.py`)
- Legacy image migration → Image processing and storage: copies image assets (evidence: `app/legacy.py`)
