# yad-n-yesh/replate architecture

> Architecture diagram of the GitHub repository yad-n-yesh/replate, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yad-n-yesh/replate
- Repository: https://github.com/yad-n-yesh/replate

## Overview

RePlate is a Django surplus-food marketplace. Sellers register and manage discounted, expiry-dated listings; customers browse or search, then place an order only after accepting the expiry-risk disclaimer. Seller dashboards expose sales and commission-adjusted earnings, while customers see order history and customer-facing prices. The graph preserves separate role workflows and shared listing/order stages. Source excerpts show the main view, form, model, and route relationships; some feature details are documented only in the README, so those links cite it.

Main entry points: [`core/views.py`](https://github.com/yad-n-yesh/replate/blob/main/core/views.py) (Marketplace views), [`core/models.py`](https://github.com/yad-n-yesh/replate/blob/main/core/models.py) (Order and commission records), [`core/templates/core`](https://github.com/yad-n-yesh/replate/tree/main/core/templates/core) (Marketplace pages), [`core/urls.py`](https://github.com/yad-n-yesh/replate/blob/main/core/urls.py) (URL routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Accounts and access"]
  node_auth["Role authentication<br/>[views.py]"]
  node_role_guards["Role guards<br/>[decorators.py]"]
  node_forms["Input forms<br/>[forms.py]"]
  node_profiles["Customer and seller profiles<br/>[models.py]"]
end

subgraph group_market["Marketplace and orders"]
  node_browse["Home and product search<br/>[views.py]"]
  node_order_flow["Disclaimer-gated ordering<br/>[views.py]"]
  node_order_records["Order and commission records<br/>[models.py]"]
end

subgraph group_seller["Seller operations"]
  node_listing["Listing management<br/>[views.py]"]
  node_dashboards["Role dashboards and history<br/>[views.py]"]
end

subgraph group_platform["Platform services"]
  node_routes["URL routes<br/>[urls.py]"]
  node_views["Marketplace views<br/>[views.py]"]
  node_templates["Marketplace pages"]
  node_admin["Django admin<br/>[admin.py]"]
  node_settings["Django settings<br/>[settings.py]"]
  node_database[("SQLite database")]
end

node_customer(("Customer"))
node_seller_actor(("Seller"))

node_customer -->|"requests pages"| node_routes
node_seller_actor -->|"requests pages"| node_routes
node_routes -->|"routes requests"| node_views
node_views -->|"handles login"| node_auth
node_views -->|"guards views"| node_role_guards
node_views -->|"validates input"| node_forms
node_views -->|"creates profiles"| node_profiles
node_customer -->|"registers or logs in"| node_auth
node_seller_actor -->|"registers or logs in"| node_auth
node_views -->|"serves browsing"| node_browse
node_views -->|"serves management"| node_listing
node_views -->|"handles ordering"| node_order_flow
node_views -->|"serves dashboards"| node_dashboards
node_browse -->|"renders pages"| node_templates
node_listing -->|"renders forms"| node_templates
node_order_flow -->|"renders order page"| node_templates
node_dashboards -->|"renders dashboards"| node_templates
node_order_flow -->|"creates order"| node_order_records
node_order_flow -->|"checks disclaimer"| node_forms
node_listing -->|"assigns seller"| node_profiles
node_dashboards -->|"reads sales and orders"| node_order_records
node_browse -.->|"queries listings"| node_database
node_order_records -.->|"persists records"| node_database
node_settings -->|"configures SQLite"| node_database
node_admin -->|"manages records"| node_order_records
node_settings -->|"provides commission setting"| node_views

click node_routes "https://github.com/yad-n-yesh/replate/blob/main/core/urls.py"
click node_views "https://github.com/yad-n-yesh/replate/blob/main/core/views.py"
click node_auth "https://github.com/yad-n-yesh/replate/blob/main/core/views.py"
click node_role_guards "https://github.com/yad-n-yesh/replate/blob/main/core/decorators.py"
click node_forms "https://github.com/yad-n-yesh/replate/blob/main/core/forms.py"
click node_profiles "https://github.com/yad-n-yesh/replate/blob/main/core/models.py"
click node_browse "https://github.com/yad-n-yesh/replate/blob/main/core/views.py"
click node_listing "https://github.com/yad-n-yesh/replate/blob/main/core/views.py"
click node_order_flow "https://github.com/yad-n-yesh/replate/blob/main/core/views.py"
click node_order_records "https://github.com/yad-n-yesh/replate/blob/main/core/models.py"
click node_dashboards "https://github.com/yad-n-yesh/replate/blob/main/core/views.py"
click node_templates "https://github.com/yad-n-yesh/replate/tree/main/core/templates/core"
click node_admin "https://github.com/yad-n-yesh/replate/blob/main/core/admin.py"
click node_settings "https://github.com/yad-n-yesh/replate/blob/main/toogoodtoosave/settings.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_auth,node_role_guards,node_forms,node_profiles toneBlue
class node_browse,node_order_flow,node_order_records toneAmber
class node_listing,node_dashboards toneMint
class node_routes,node_views,node_templates,node_admin,node_settings,node_database toneRose
class node_customer,node_seller_actor toneIndigo
```

## Components

### Accounts and access

- [Role authentication](https://github.com/yad-n-yesh/replate/blob/main/core/views.py): `core/views.py`
- [Role guards](https://github.com/yad-n-yesh/replate/blob/main/core/decorators.py): `core/decorators.py`
- [Input forms](https://github.com/yad-n-yesh/replate/blob/main/core/forms.py): `core/forms.py`
- [Customer and seller profiles](https://github.com/yad-n-yesh/replate/blob/main/core/models.py): `core/models.py`

### Marketplace and orders

- [Home and product search](https://github.com/yad-n-yesh/replate/blob/main/core/views.py): `core/views.py`
- [Disclaimer-gated ordering](https://github.com/yad-n-yesh/replate/blob/main/core/views.py): `core/views.py`
- [Order and commission records](https://github.com/yad-n-yesh/replate/blob/main/core/models.py): `core/models.py`

### Seller operations

- [Listing management](https://github.com/yad-n-yesh/replate/blob/main/core/views.py): `core/views.py`
- [Role dashboards and history](https://github.com/yad-n-yesh/replate/blob/main/core/views.py): `core/views.py`

### Platform services

- [URL routes](https://github.com/yad-n-yesh/replate/blob/main/core/urls.py): `core/urls.py`
- [Marketplace views](https://github.com/yad-n-yesh/replate/blob/main/core/views.py): `core/views.py`
- [Marketplace pages](https://github.com/yad-n-yesh/replate/tree/main/core/templates/core): `core/templates/core`
- [Django admin](https://github.com/yad-n-yesh/replate/blob/main/core/admin.py): `core/admin.py`
- [Django settings](https://github.com/yad-n-yesh/replate/blob/main/toogoodtoosave/settings.py): `toogoodtoosave/settings.py`
- **SQLite database**

### Other components

- **Customer**
- **Seller**

## Connections

- Customer → URL routes: requests pages (evidence: `README.md`)
- Seller → URL routes: requests pages (evidence: `README.md`)
- URL routes → Marketplace views: routes requests (evidence: `core/urls.py`)
- Marketplace views → Role authentication: handles login (evidence: `core/views.py`)
- Marketplace views → Role guards: guards views (evidence: `core/views.py`)
- Marketplace views → Input forms: validates input (evidence: `core/views.py`)
- Marketplace views → Customer and seller profiles: creates profiles (evidence: `core/views.py`)
- Customer → Role authentication: registers or logs in (evidence: `README.md`)
- Seller → Role authentication: registers or logs in (evidence: `README.md`)
- Marketplace views → Home and product search: serves browsing (evidence: `core/views.py`)
- Marketplace views → Listing management: serves management (evidence: `core/views.py`)
- Marketplace views → Disclaimer-gated ordering: handles ordering (evidence: `core/views.py`)
- Marketplace views → Role dashboards and history: serves dashboards (evidence: `core/views.py`)
- Home and product search → Marketplace pages: renders pages (evidence: `core/views.py`)
- Listing management → Marketplace pages: renders forms (evidence: `core/views.py`)
- Disclaimer-gated ordering → Marketplace pages: renders order page (evidence: `core/views.py`)
- Role dashboards and history → Marketplace pages: renders dashboards (evidence: `core/views.py`)
- Disclaimer-gated ordering → Order and commission records: creates order (evidence: `core/views.py`)
- Disclaimer-gated ordering → Input forms: checks disclaimer (evidence: `core/views.py`)
- Listing management → Customer and seller profiles: assigns seller (evidence: `core/views.py`)
- Role dashboards and history → Order and commission records: reads sales and orders (evidence: `core/views.py`)
- Home and product search → SQLite database: queries listings
- Order and commission records → SQLite database: persists records
- Django settings → SQLite database: configures SQLite (evidence: `toogoodtoosave/settings.py`)
- Django admin → Order and commission records: manages records (evidence: `core/admin.py`)
- Django settings → Marketplace views: provides commission setting (evidence: `core/views.py`)
