# drenbuqa/barnatoremeldpharm architecture

> Architecture diagram of the GitHub repository drenbuqa/barnatoremeldpharm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/drenbuqa/barnatoremeldpharm
- Repository: https://github.com/drenbuqa/barnatoremeldpharm

## Overview

Barnatore Meld Pharm is a Flask pharmacy e-commerce platform. Customers browse and search products, manage a cart, check out, and receive order emails; administrators manage orders, products, promotions, users, banners, analytics, and newsletters. The graph separates customer shopping, account access, administration, and shared domain/data services. The sampled routes and source index support the principal relationships shown; unsampled implementations are represented only at their known paths, and uncertain wiring is omitted.

Main entry points: [`routes/main.py`](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/main.py) (Catalog & Search), [`routes/admin.py`](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/admin.py) (Admin Management), [`routes/cart.py`](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/cart.py) (Cart & Checkout), [`app.py`](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/app.py) (Flask Application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shopping["Customer Shopping"]
  node_catalog_routes["Catalog &amp; Search<br/>[main.py]"]
  node_cart_routes["Cart &amp; Checkout<br/>[cart.py]"]
  node_storefront["Storefront UI"]
  node_cart_ui["Cart Browser Logic<br/>[cart-page.js]"]
end

subgraph group_accounts["Accounts &amp; Orders"]
  node_auth_routes["Authentication<br/>[auth.py]"]
  node_orders["Order Domain<br/>[order.py]"]
  node_user_domain["User Domain<br/>[user.py]"]
end

subgraph group_admin["Administration"]
  node_admin_routes["Admin Management<br/>[admin.py]"]
  node_analytics_routes["Analytics<br/>[analytics.py]"]
end

subgraph group_services["Domain Services"]
  node_app["Flask Application<br/>[app.py]"]
  node_promo["Promotions<br/>[promo.py]"]
  node_feeds["Product Feeds<br/>[feed.py]"]
  node_capi["Conversion API<br/>[capi.py]"]
  node_conversation["Chat Conversations<br/>[conversation.py]"]
  node_banner_domain["Banner Domain<br/>[banner.py]"]
  node_categories["Product Categories<br/>[categories.py]"]
  node_email["Email Notifications<br/>[email_utils.py]"]
  node_image_utils["Image Utilities<br/>[image_utils.py]"]
  node_image_import["Product Image Import"]
end

subgraph group_data["Persistence &amp; Integrations"]
  node_product_domain["Product Domain<br/>[product.py]"]
  node_db[("MongoDB Access<br/>[db.py]")]
end

node_customer(("Customer"))
node_admin_actor(("Administrator"))
node_mongodb[("MongoDB")]
node_google["Google OAuth"]
node_smtp["SMTP Email"]
node_r2[("Cloudflare R2")]

node_customer -->|"uses"| node_app
node_admin_actor -->|"uses"| node_app
node_app -->|"registers"| node_catalog_routes
node_app -->|"registers"| node_auth_routes
node_app -->|"registers"| node_cart_routes
node_app -->|"registers"| node_admin_routes
node_app -->|"registers"| node_feeds
node_catalog_routes -->|"renders"| node_storefront
node_cart_routes -.->|"renders"| node_storefront
node_cart_ui -.->|"enhances"| node_storefront
node_catalog_routes -->|"queries"| node_product_domain
node_catalog_routes -->|"queries"| node_orders
node_catalog_routes -->|"queries"| node_user_domain
node_catalog_routes -->|"uses"| node_categories
node_catalog_routes -->|"queries"| node_banner_domain
node_catalog_routes -->|"uses"| node_conversation
node_catalog_routes -->|"uses"| node_promo
node_cart_routes -->|"queries"| node_product_domain
node_cart_routes -->|"creates"| node_orders
node_cart_routes -->|"uses"| node_user_domain
node_cart_routes -->|"logs events"| node_analytics_routes
node_cart_routes -->|"prices with"| node_promo
node_auth_routes -->|"authenticates"| node_user_domain
node_auth_routes -->|"sends mail"| node_email
node_auth_routes -.->|"authenticates via"| node_google
node_admin_routes -->|"manages"| node_product_domain
node_admin_routes -->|"manages"| node_orders
node_admin_routes -->|"manages"| node_user_domain
node_admin_routes -->|"manages"| node_banner_domain
node_admin_routes -->|"uses"| node_promo
node_admin_routes -->|"imports images"| node_image_import
node_admin_routes -->|"sends campaigns"| node_email
node_admin_routes -.->|"queries"| node_analytics_routes
node_feeds -->|"uses"| node_promo
node_catalog_routes -.->|"uses"| node_capi
node_product_domain -->|"reads/writes"| node_db
node_orders -->|"reads/writes"| node_db
node_user_domain -->|"reads/writes"| node_db
node_analytics_routes -->|"queries"| node_db
node_banner_domain -->|"reads/writes"| node_db
node_conversation -->|"reads/writes"| node_db
node_db -->|"connects"| node_mongodb
node_email -.->|"sends mail"| node_smtp
node_image_import -->|"uploads images"| node_r2
node_email -->|"uses"| node_image_utils

click node_app "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/app.py"
click node_catalog_routes "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/main.py"
click node_cart_routes "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/cart.py"
click node_storefront "https://github.com/drenbuqa/barnatoremeldpharm/tree/main/templates"
click node_cart_ui "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/static/js/cart-page.js"
click node_auth_routes "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/auth.py"
click node_orders "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/order.py"
click node_user_domain "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/user.py"
click node_admin_routes "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/admin.py"
click node_analytics_routes "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/analytics.py"
click node_promo "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/promo.py"
click node_feeds "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/feed.py"
click node_capi "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/capi.py"
click node_conversation "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/conversation.py"
click node_banner_domain "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/banner.py"
click node_categories "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/categories.py"
click node_email "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/email_utils.py"
click node_image_utils "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/image_utils.py"
click node_image_import "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/cloudinary_import.py"
click node_product_domain "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/product.py"
click node_db "https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/db.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_catalog_routes,node_cart_routes,node_storefront,node_cart_ui toneBlue
class node_auth_routes,node_orders,node_user_domain,node_mongodb,node_r2 toneAmber
class node_admin_routes,node_analytics_routes toneMint
class node_app,node_promo,node_feeds,node_capi,node_conversation,node_banner_domain,node_categories,node_email,node_image_utils,node_image_import toneRose
class node_product_domain,node_db,node_customer,node_admin_actor,node_google,node_smtp toneIndigo
```

## Components

### Customer Shopping

- [Catalog & Search](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/main.py): `routes/main.py`
- [Cart & Checkout](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/cart.py): `routes/cart.py`
- [Storefront UI](https://github.com/drenbuqa/barnatoremeldpharm/tree/main/templates): `templates`
- [Cart Browser Logic](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/static/js/cart-page.js): `static/js/cart-page.js`

### Accounts & Orders

- [Authentication](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/auth.py): `routes/auth.py`
- [Order Domain](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/order.py): `models/order.py`
- [User Domain](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/user.py): `models/user.py`

### Administration

- [Admin Management](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/admin.py): `routes/admin.py`
- [Analytics](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/analytics.py): `models/analytics.py`

### Domain Services

- [Flask Application](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/app.py): `app.py`
- [Promotions](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/promo.py): `routes/promo.py`
- [Product Feeds](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/feed.py): `routes/feed.py`
- [Conversion API](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/routes/capi.py): `routes/capi.py`
- [Chat Conversations](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/conversation.py): `models/conversation.py`
- [Banner Domain](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/banner.py): `models/banner.py`
- [Product Categories](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/categories.py): `models/categories.py`
- [Email Notifications](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/email_utils.py): `models/email_utils.py`
- [Image Utilities](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/image_utils.py): `models/image_utils.py`
- [Product Image Import](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/cloudinary_import.py): `models/cloudinary_import.py`

### Persistence & Integrations

- [Product Domain](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/product.py): `models/product.py`
- [MongoDB Access](https://github.com/drenbuqa/barnatoremeldpharm/blob/main/models/db.py): `models/db.py`

### Other components

- **Customer**
- **Administrator**
- **MongoDB**
- **Google OAuth**
- **SMTP Email**
- **Cloudflare R2**

## Connections

- Customer → Flask Application: uses (evidence: `README.md`)
- Administrator → Flask Application: uses (evidence: `README.md`)
- Flask Application → Catalog & Search: registers (evidence: `app.py`)
- Flask Application → Authentication: registers (evidence: `app.py`)
- Flask Application → Cart & Checkout: registers (evidence: `app.py`)
- Flask Application → Admin Management: registers (evidence: `app.py`)
- Flask Application → Product Feeds: registers (evidence: `app.py`)
- Catalog & Search → Storefront UI: renders (evidence: `routes/main.py`)
- Cart & Checkout → Storefront UI: renders
- Cart Browser Logic → Storefront UI: enhances
- Catalog & Search → Product Domain: queries (evidence: `routes/main.py`)
- Catalog & Search → Order Domain: queries (evidence: `routes/main.py`)
- Catalog & Search → User Domain: queries (evidence: `routes/main.py`)
- Catalog & Search → Product Categories: uses (evidence: `routes/main.py`)
- Catalog & Search → Banner Domain: queries (evidence: `routes/main.py`)
- Catalog & Search → Chat Conversations: uses (evidence: `routes/main.py`)
- Catalog & Search → Promotions: uses (evidence: `routes/main.py`)
- Cart & Checkout → Product Domain: queries (evidence: `routes/cart.py`)
- Cart & Checkout → Order Domain: creates (evidence: `routes/cart.py`)
- Cart & Checkout → User Domain: uses (evidence: `routes/cart.py`)
- Cart & Checkout → Analytics: logs events (evidence: `routes/cart.py`)
- Cart & Checkout → Promotions: prices with (evidence: `routes/cart.py`)
- Authentication → User Domain: authenticates (evidence: `routes/auth.py`)
- Authentication → Email Notifications: sends mail (evidence: `routes/auth.py`)
- Authentication → Google OAuth: authenticates via
- Admin Management → Product Domain: manages (evidence: `routes/admin.py`)
- Admin Management → Order Domain: manages (evidence: `routes/admin.py`)
- Admin Management → User Domain: manages (evidence: `routes/admin.py`)
- Admin Management → Banner Domain: manages (evidence: `routes/admin.py`)
- Admin Management → Promotions: uses (evidence: `routes/admin.py`)
- Admin Management → Product Image Import: imports images (evidence: `routes/admin.py`)
- Admin Management → Email Notifications: sends campaigns (evidence: `routes/admin.py`)
- Admin Management → Analytics: queries
- Product Feeds → Promotions: uses (evidence: `routes/feed.py`)
- Catalog & Search → Conversion API: uses (evidence: `routes/main.py`)
- Product Domain → MongoDB Access: reads/writes (evidence: `models/product.py`)
- Order Domain → MongoDB Access: reads/writes (evidence: `models/order.py`)
- User Domain → MongoDB Access: reads/writes (evidence: `models/user.py`)
- Analytics → MongoDB Access: queries (evidence: `models/analytics.py`)
- Banner Domain → MongoDB Access: reads/writes (evidence: `models/banner.py`)
- Chat Conversations → MongoDB Access: reads/writes (evidence: `models/conversation.py`)
- MongoDB Access → MongoDB: connects (evidence: `models/db.py`)
- Email Notifications → SMTP Email: sends mail
- Product Image Import → Cloudflare R2: uploads images (evidence: `models/cloudinary_import.py`)
- Email Notifications → Image Utilities: uses (evidence: `models/email_utils.py`)
