# danamos-star/eco_store architecture

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

- Interactive diagram: https://gitdiagram.com/danamos-star/eco_store
- Repository: https://github.com/danamos-star/eco_store

## Overview

EcoStore is a Flask e-commerce app with a customer storefront and a password-protected seller dashboard. Customers browse, search, and filter a Firestore-backed catalog, build a client-side basket, then submit checkout to create a Stripe Checkout session. Sellers authenticate before managing product metadata and uploaded images. The main implementation is concentrated in app.py, with both storefront experiences in templates/index.html. README documents the UI capabilities and cloud services; sampled code confirms the server-side calls and rendering, but not the template’s internal behavior.

Main entry points: [`templates/index.html`](https://github.com/danamos-star/eco_store/blob/main/templates/index.html) (Storefront and dashboard UI), [`app.py`](https://github.com/danamos-star/eco_store/blob/main/app.py) (Product management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Storefront experiences"]
  node_storefront["Storefront and dashboard UI<br/>[index.html]"]
end

subgraph group_backend["Flask application"]
  node_catalog["Catalog browsing<br/>[app.py]"]
  node_admin_auth["Seller authentication<br/>[app.py]"]
  node_product_admin["Product management<br/>[app.py]"]
  node_checkout["Checkout handler<br/>[app.py]"]
end

subgraph group_cloud["Cloud services"]
  node_firestore[("Product metadata")]
  node_storage[("Product images")]
  node_stripe["Stripe Checkout"]
end

node_browser(("Web browser"))

node_browser -->|"uses"| node_storefront
node_catalog -->|"reads catalog"| node_firestore
node_catalog -->|"renders"| node_storefront
node_storefront -->|"requests catalog"| node_catalog
node_storefront -->|"submits login"| node_admin_auth
node_storefront -->|"submits changes"| node_product_admin
node_admin_auth -->|"redirects"| node_storefront
node_product_admin -->|"reads and writes"| node_firestore
node_product_admin -->|"uploads and deletes"| node_storage
node_storefront -->|"submits order"| node_checkout
node_checkout -->|"creates session"| node_stripe
node_checkout -->|"redirects"| node_browser

click node_storefront "https://github.com/danamos-star/eco_store/blob/main/templates/index.html"
click node_catalog "https://github.com/danamos-star/eco_store/blob/main/app.py"
click node_admin_auth "https://github.com/danamos-star/eco_store/blob/main/app.py"
click node_product_admin "https://github.com/danamos-star/eco_store/blob/main/app.py"
click node_checkout "https://github.com/danamos-star/eco_store/blob/main/app.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_storefront,node_browser toneBlue
class node_catalog,node_admin_auth,node_product_admin,node_checkout toneAmber
class node_firestore,node_storage,node_stripe toneMint
```

## Components

### Storefront experiences

- [Storefront and dashboard UI](https://github.com/danamos-star/eco_store/blob/main/templates/index.html): `templates/index.html`

### Flask application

- [Catalog browsing](https://github.com/danamos-star/eco_store/blob/main/app.py): `app.py`
- [Seller authentication](https://github.com/danamos-star/eco_store/blob/main/app.py): `app.py`
- [Product management](https://github.com/danamos-star/eco_store/blob/main/app.py): `app.py`
- [Checkout handler](https://github.com/danamos-star/eco_store/blob/main/app.py): `app.py`

### Cloud services

- **Product metadata**
- **Product images**
- **Stripe Checkout**

### Other components

- **Web browser**

## Connections

- Web browser → Storefront and dashboard UI: uses (evidence: `README.md`)
- Catalog browsing → Product metadata: reads catalog (evidence: `app.py`)
- Catalog browsing → Storefront and dashboard UI: renders (evidence: `app.py`)
- Storefront and dashboard UI → Catalog browsing: requests catalog (evidence: `README.md`)
- Storefront and dashboard UI → Seller authentication: submits login (evidence: `README.md`)
- Storefront and dashboard UI → Product management: submits changes (evidence: `README.md`)
- Seller authentication → Storefront and dashboard UI: redirects (evidence: `app.py`)
- Product management → Product metadata: reads and writes (evidence: `app.py`)
- Product management → Product images: uploads and deletes (evidence: `app.py`)
- Storefront and dashboard UI → Checkout handler: submits order (evidence: `README.md`)
- Checkout handler → Stripe Checkout: creates session (evidence: `app.py`)
- Checkout handler → Web browser: redirects (evidence: `app.py`)
