How taroutn/meve works
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: PedidoService.java Order service · Comercio.java Business records · PanelVendedor.tsx Seller panel · Producto.java Product records
Components 30
Marketplace data
- Business records
backend/src/main/java/com/meve/backend/models/Comercio.java - Product records
backend/src/main/java/com/meve/backend/models/Producto.java - Order records
backend/src/main/java/com/meve/backend/models/Pedido.java - MongoDB
backend/src/main/java/com/meve/backend/config/MongoConfig.java
Backend services
- Commerce API
backend/src/main/java/com/meve/backend/controllers/ComercioController.java - Product API
backend/src/main/java/com/meve/backend/controllers/ProductoController.java - Inventory API
backend/src/main/java/com/meve/backend/controllers/InventarioController.java - Order API
backend/src/main/java/com/meve/backend/controllers/PedidoController.java - Commerce service
backend/src/main/java/com/meve/backend/services/ComercioService.java - Catalog service
backend/src/main/java/com/meve/backend/services/ProductoService.java - Inventory service
backend/src/main/java/com/meve/backend/services/InventarioService.java - Order service
backend/src/main/java/com/meve/backend/services/PedidoService.java - Reservation expiry
backend/src/main/java/com/meve/backend/services/ExpiracionPedidoService.java
Buyer experience
- Marketplace home
frontend/src/pages/Home.tsx - Nearby businesses
frontend/src/pages/Comercios.tsx - Business detail
frontend/src/pages/ComercioDetail.tsx - Shopping cart
frontend/src/context/CarritoProvider.tsx - Checkout
frontend/src/components/CheckoutForm.tsx - Pickup ticket
frontend/src/components/TicketSuccess.tsx - Accessibility controls
frontend/src/context/AccessibilityContext.tsx
Merchant operations
- Seller panel
frontend/src/pages/PanelVendedor.tsx - Moderation panel
frontend/src/pages/PanelSuperAdmin.tsx - Merchant signup
frontend/src/pages/SumateMeve.tsx
Access and onboarding
- Authentication API
backend/src/main/java/com/meve/backend/controllers/AuthController.java - Authentication service
backend/src/main/java/com/meve/backend/services/AuthService.java - JWT security
backend/src/main/java/com/meve/backend/security/SecurityConfig.java
Other components
- Shopper
- Seller
- SuperAdmin
Connections 35
- Commerce API → Commerce service: delegates to
backend/src/main/java/com/meve/backend/controllers/ComercioController.java - Commerce service → Business records: queries and saves
backend/src/main/java/com/meve/backend/services/ComercioService.java - Product API → Catalog service: delegates to
backend/src/main/java/com/meve/backend/controllers/ProductoController.java - Catalog service → Product records: queries and saves
backend/src/main/java/com/meve/backend/services/ProductoService.java - Catalog service → Business records: finds nearby businesses
backend/src/main/java/com/meve/backend/services/ProductoService.java - Inventory API → Inventory service: delegates to
backend/src/main/java/com/meve/backend/controllers/InventarioController.java - Inventory service → Product records: updates stock
backend/src/main/java/com/meve/backend/services/InventarioService.java - Order API → Order service: delegates to
backend/src/main/java/com/meve/backend/controllers/PedidoController.java - Order service → Business records: checks slot capacity
backend/src/main/java/com/meve/backend/services/PedidoService.java - Order service → Product records: reserves stock
backend/src/main/java/com/meve/backend/services/PedidoService.java - Order service → Order records: saves orders
backend/src/main/java/com/meve/backend/services/PedidoService.java - Reservation expiry → Order records: finds expired orders
backend/src/main/java/com/meve/backend/services/ExpiracionPedidoService.java - Reservation expiry → Order service: releases reservations
backend/src/main/java/com/meve/backend/services/ExpiracionPedidoService.java - Authentication API → Authentication service: delegates to
backend/src/main/java/com/meve/backend/controllers/AuthController.java - Authentication service → Business records: creates businesses
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
frontend/src/components/CheckoutForm.tsx - Checkout → Pickup ticket: shows success
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
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