# taroutn/meve architecture

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

- Interactive diagram: https://gitdiagram.com/taroutn/meve
- Repository: https://github.com/taroutn/meve

## Overview

MeVe is a hyperlocal, multitenant marketplace connecting shoppers with nearby micro-businesses. Shoppers browse a proximity-ranked catalog, select a pickup slot, and place an order that reserves stock and capacity; payment is simulated, and a confirmed order yields a pickup ticket and WhatsApp coordination link. Sellers manage products, inventory, pickup settings, and orders; SuperAdmins moderate businesses. The map follows documented capabilities and sampled calls; unsampled UI/API wiring and some controller relationships are left unverified or omitted.

Main entry points: [`backend/src/main/java/com/meve/backend/services/PedidoService.java`](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/PedidoService.java) (Order service), [`backend/src/main/java/com/meve/backend/models/Comercio.java`](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/models/Comercio.java) (Business records), [`frontend/src/pages/PanelVendedor.tsx`](https://github.com/taroutn/meve/blob/main/frontend/src/pages/PanelVendedor.tsx) (Seller panel), [`backend/src/main/java/com/meve/backend/models/Producto.java`](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/models/Producto.java) (Product records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_store["Marketplace data"]
  node_commerce["Business records<br/>[Comercio.java]"]
  node_product["Product records<br/>[Producto.java]"]
  node_orders["Order records<br/>[Pedido.java]"]
  node_mongo[("MongoDB<br/>[MongoConfig.java]")]
end

subgraph group_backend["Backend services"]
  node_commerce_api["Commerce API"]
  node_product_api["Product API"]
  node_inventory_api["Inventory API"]
  node_order_api["Order API"]
  node_commerce_service["Commerce service"]
  node_product_service["Catalog service"]
  node_inventory_service["Inventory service"]
  node_order_service["Order service<br/>[PedidoService.java]"]
  node_expiry["Reservation expiry"]
end

subgraph group_buyer["Buyer experience"]
  node_home["Marketplace home<br/>[Home.tsx]"]
  node_shops["Nearby businesses<br/>[Comercios.tsx]"]
  node_shop_detail["Business detail<br/>[ComercioDetail.tsx]"]
  node_cart["Shopping cart"]
  node_checkout["Checkout<br/>[CheckoutForm.tsx]"]
  node_ticket["Pickup ticket<br/>[TicketSuccess.tsx]"]
  node_accessibility["Accessibility controls"]
end

subgraph group_operations["Merchant operations"]
  node_seller_panel["Seller panel<br/>[PanelVendedor.tsx]"]
  node_admin_panel["Moderation panel"]
  node_join["Merchant signup<br/>[SumateMeve.tsx]"]
end

subgraph group_identity["Access and onboarding"]
  node_auth_api["Authentication API"]
  node_auth_service["Authentication service<br/>[AuthService.java]"]
  node_security["JWT security"]
end

node_shopper(("Shopper"))
node_seller(("Seller"))
node_admin(("SuperAdmin"))
node_whatsapp(("WhatsApp"))

node_commerce_api -->|"delegates to"| node_commerce_service
node_commerce_service -->|"queries and saves"| node_commerce
node_product_api -->|"delegates to"| node_product_service
node_product_service -->|"queries and saves"| node_product
node_product_service -->|"finds nearby businesses"| node_commerce
node_inventory_api -->|"delegates to"| node_inventory_service
node_inventory_service -->|"updates stock"| node_product
node_order_api -->|"delegates to"| node_order_service
node_order_service -->|"checks slot capacity"| node_commerce
node_order_service -->|"reserves stock"| node_product
node_order_service -->|"saves orders"| node_orders
node_expiry -->|"finds expired orders"| node_orders
node_expiry -->|"releases reservations"| node_order_service
node_auth_api -.->|"delegates to"| node_auth_service
node_auth_service -->|"creates businesses"| node_commerce
node_auth_service -.->|"issues JWT"| node_security
node_home -.->|"browses"| node_shops
node_shops -.->|"opens business"| node_shop_detail
node_shop_detail -.->|"adds products"| node_cart
node_cart -->|"checks out"| node_checkout
node_checkout -->|"shows success"| node_ticket
node_checkout -.->|"submits order"| node_order_api
node_seller_panel -.->|"manages catalog"| node_product_api
node_seller_panel -.->|"manages stock"| node_inventory_api
node_seller_panel -.->|"manages orders"| node_order_api
node_admin_panel -.->|"moderates businesses"| node_commerce_api
node_join -.->|"registers merchant"| node_auth_api
node_order_service -->|"builds coordination link"| node_whatsapp
node_shopper -.->|"browses"| node_home
node_seller -.->|"operates"| node_seller_panel
node_admin -.->|"reviews"| node_admin_panel
node_commerce -.->|"stored in"| node_mongo
node_product -.->|"stored in"| node_mongo
node_orders -.->|"stored in"| node_mongo
node_accessibility -.->|"sets interface options"| node_home

click node_commerce "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/models/Comercio.java"
click node_product "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/models/Producto.java"
click node_orders "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/models/Pedido.java"
click node_mongo "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/config/MongoConfig.java"
click node_commerce_api "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/controllers/ComercioController.java"
click node_product_api "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/controllers/ProductoController.java"
click node_inventory_api "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/controllers/InventarioController.java"
click node_order_api "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/controllers/PedidoController.java"
click node_commerce_service "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/ComercioService.java"
click node_product_service "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/ProductoService.java"
click node_inventory_service "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/InventarioService.java"
click node_order_service "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/PedidoService.java"
click node_expiry "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/ExpiracionPedidoService.java"
click node_auth_api "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/controllers/AuthController.java"
click node_auth_service "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/AuthService.java"
click node_security "https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/security/SecurityConfig.java"
click node_home "https://github.com/taroutn/meve/blob/main/frontend/src/pages/Home.tsx"
click node_shops "https://github.com/taroutn/meve/blob/main/frontend/src/pages/Comercios.tsx"
click node_shop_detail "https://github.com/taroutn/meve/blob/main/frontend/src/pages/ComercioDetail.tsx"
click node_cart "https://github.com/taroutn/meve/blob/main/frontend/src/context/CarritoProvider.tsx"
click node_checkout "https://github.com/taroutn/meve/blob/main/frontend/src/components/CheckoutForm.tsx"
click node_ticket "https://github.com/taroutn/meve/blob/main/frontend/src/components/TicketSuccess.tsx"
click node_accessibility "https://github.com/taroutn/meve/blob/main/frontend/src/context/AccessibilityContext.tsx"
click node_seller_panel "https://github.com/taroutn/meve/blob/main/frontend/src/pages/PanelVendedor.tsx"
click node_admin_panel "https://github.com/taroutn/meve/blob/main/frontend/src/pages/PanelSuperAdmin.tsx"
click node_join "https://github.com/taroutn/meve/blob/main/frontend/src/pages/SumateMeve.tsx"

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_commerce,node_product,node_orders,node_mongo toneBlue
class node_commerce_api,node_product_api,node_inventory_api,node_order_api,node_commerce_service,node_product_service,node_inventory_service,node_order_service,node_expiry toneAmber
class node_home,node_shops,node_shop_detail,node_cart,node_checkout,node_ticket,node_accessibility toneMint
class node_seller_panel,node_admin_panel,node_join toneRose
class node_auth_api,node_auth_service,node_security,node_shopper,node_seller,node_admin,node_whatsapp toneIndigo
```

## Components

### Marketplace data

- [Business records](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/models/Comercio.java): `backend/src/main/java/com/meve/backend/models/Comercio.java`
- [Product records](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/models/Producto.java): `backend/src/main/java/com/meve/backend/models/Producto.java`
- [Order records](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/models/Pedido.java): `backend/src/main/java/com/meve/backend/models/Pedido.java`
- [MongoDB](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/config/MongoConfig.java): `backend/src/main/java/com/meve/backend/config/MongoConfig.java`

### Backend services

- [Commerce API](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/controllers/ComercioController.java): `backend/src/main/java/com/meve/backend/controllers/ComercioController.java`
- [Product API](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/controllers/ProductoController.java): `backend/src/main/java/com/meve/backend/controllers/ProductoController.java`
- [Inventory API](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/controllers/InventarioController.java): `backend/src/main/java/com/meve/backend/controllers/InventarioController.java`
- [Order API](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/controllers/PedidoController.java): `backend/src/main/java/com/meve/backend/controllers/PedidoController.java`
- [Commerce service](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/ComercioService.java): `backend/src/main/java/com/meve/backend/services/ComercioService.java`
- [Catalog service](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/ProductoService.java): `backend/src/main/java/com/meve/backend/services/ProductoService.java`
- [Inventory service](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/InventarioService.java): `backend/src/main/java/com/meve/backend/services/InventarioService.java`
- [Order service](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/PedidoService.java): `backend/src/main/java/com/meve/backend/services/PedidoService.java`
- [Reservation expiry](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/ExpiracionPedidoService.java): `backend/src/main/java/com/meve/backend/services/ExpiracionPedidoService.java`

### Buyer experience

- [Marketplace home](https://github.com/taroutn/meve/blob/main/frontend/src/pages/Home.tsx): `frontend/src/pages/Home.tsx`
- [Nearby businesses](https://github.com/taroutn/meve/blob/main/frontend/src/pages/Comercios.tsx): `frontend/src/pages/Comercios.tsx`
- [Business detail](https://github.com/taroutn/meve/blob/main/frontend/src/pages/ComercioDetail.tsx): `frontend/src/pages/ComercioDetail.tsx`
- [Shopping cart](https://github.com/taroutn/meve/blob/main/frontend/src/context/CarritoProvider.tsx): `frontend/src/context/CarritoProvider.tsx`
- [Checkout](https://github.com/taroutn/meve/blob/main/frontend/src/components/CheckoutForm.tsx): `frontend/src/components/CheckoutForm.tsx`
- [Pickup ticket](https://github.com/taroutn/meve/blob/main/frontend/src/components/TicketSuccess.tsx): `frontend/src/components/TicketSuccess.tsx`
- [Accessibility controls](https://github.com/taroutn/meve/blob/main/frontend/src/context/AccessibilityContext.tsx): `frontend/src/context/AccessibilityContext.tsx`

### Merchant operations

- [Seller panel](https://github.com/taroutn/meve/blob/main/frontend/src/pages/PanelVendedor.tsx): `frontend/src/pages/PanelVendedor.tsx`
- [Moderation panel](https://github.com/taroutn/meve/blob/main/frontend/src/pages/PanelSuperAdmin.tsx): `frontend/src/pages/PanelSuperAdmin.tsx`
- [Merchant signup](https://github.com/taroutn/meve/blob/main/frontend/src/pages/SumateMeve.tsx): `frontend/src/pages/SumateMeve.tsx`

### Access and onboarding

- [Authentication API](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/controllers/AuthController.java): `backend/src/main/java/com/meve/backend/controllers/AuthController.java`
- [Authentication service](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/services/AuthService.java): `backend/src/main/java/com/meve/backend/services/AuthService.java`
- [JWT security](https://github.com/taroutn/meve/blob/main/backend/src/main/java/com/meve/backend/security/SecurityConfig.java): `backend/src/main/java/com/meve/backend/security/SecurityConfig.java`

### Other components

- **Shopper**
- **Seller**
- **SuperAdmin**
- **WhatsApp**

## Connections

- Commerce API → Commerce service: delegates to (evidence: `backend/src/main/java/com/meve/backend/controllers/ComercioController.java`)
- Commerce service → Business records: queries and saves (evidence: `backend/src/main/java/com/meve/backend/services/ComercioService.java`)
- Product API → Catalog service: delegates to (evidence: `backend/src/main/java/com/meve/backend/controllers/ProductoController.java`)
- Catalog service → Product records: queries and saves (evidence: `backend/src/main/java/com/meve/backend/services/ProductoService.java`)
- Catalog service → Business records: finds nearby businesses (evidence: `backend/src/main/java/com/meve/backend/services/ProductoService.java`)
- Inventory API → Inventory service: delegates to (evidence: `backend/src/main/java/com/meve/backend/controllers/InventarioController.java`)
- Inventory service → Product records: updates stock (evidence: `backend/src/main/java/com/meve/backend/services/InventarioService.java`)
- Order API → Order service: delegates to (evidence: `backend/src/main/java/com/meve/backend/controllers/PedidoController.java`)
- Order service → Business records: checks slot capacity (evidence: `backend/src/main/java/com/meve/backend/services/PedidoService.java`)
- Order service → Product records: reserves stock (evidence: `backend/src/main/java/com/meve/backend/services/PedidoService.java`)
- Order service → Order records: saves orders (evidence: `backend/src/main/java/com/meve/backend/services/PedidoService.java`)
- Reservation expiry → Order records: finds expired orders (evidence: `backend/src/main/java/com/meve/backend/services/ExpiracionPedidoService.java`)
- Reservation expiry → Order service: releases reservations (evidence: `backend/src/main/java/com/meve/backend/services/ExpiracionPedidoService.java`)
- Authentication API → Authentication service: delegates to (evidence: `backend/src/main/java/com/meve/backend/controllers/AuthController.java`)
- Authentication service → Business records: creates businesses (evidence: `backend/src/main/java/com/meve/backend/services/AuthService.java`)
- Authentication service → JWT security: issues JWT
- Marketplace home → Nearby businesses: browses
- Nearby businesses → Business detail: opens business
- Business detail → Shopping cart: adds products
- Shopping cart → Checkout: checks out (evidence: `frontend/src/components/CheckoutForm.tsx`)
- Checkout → Pickup ticket: shows success (evidence: `frontend/src/components/CheckoutForm.tsx`)
- Checkout → Order API: submits order
- Seller panel → Product API: manages catalog
- Seller panel → Inventory API: manages stock
- Seller panel → Order API: manages orders
- Moderation panel → Commerce API: moderates businesses
- Merchant signup → Authentication API: registers merchant
- Order service → WhatsApp: builds coordination link (evidence: `backend/src/main/java/com/meve/backend/services/PedidoService.java`)
- Shopper → Marketplace home: browses
- Seller → Seller panel: operates
- SuperAdmin → Moderation panel: reviews
- Business records → MongoDB: stored in
- Product records → MongoDB: stored in
- Order records → MongoDB: stored in
- Accessibility controls → Marketplace home: sets interface options
