# tomasf05/do-campo-a-mesa architecture

> Architecture diagram of the GitHub repository tomasf05/do-campo-a-mesa, 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/tomasf05/do-campo-a-mesa
- Repository: https://github.com/tomasf05/do-campo-a-mesa

## Overview

Do Campo à Mesa is a local-produce marketplace: visitors browse producers, products and auctions; buyers place and track orders, review delivered purchases and bid live; producers manage profiles, stock and auctions; administrators validate producers and moderate reviews. The SPA uses REST for durable data and Socket.io for live updates, while the Express API applies business rules and persists through MongoDB. The README documents Cloudinary image storage. Some route implementations were not sampled, so their internal calls are not inferred.

Main entry points: [`api/src/app.js`](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/app.js) (REST routes), [`web/src/App.jsx`](https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/App.jsx) (Web application), [`api/src/services/cicloLeiloes.js`](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/services/cicloLeiloes.js) (Auction lifecycle), [`web/src/api/client.js`](https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/api/client.js) (REST client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_spa["Web application<br/>[App.jsx]"]
  node_catalog["Catalog and profiles<br/>[Catalogo.jsx]"]
  node_buyer["Cart and orders<br/>[Carrinho.jsx]"]
  node_auctionui["Auction experience<br/>[SalaLeilao.jsx]"]
  node_rolesui["Producer and admin<br/>[Painel.jsx]"]
  node_session["Session context<br/>[AuthContext.jsx]"]
  node_cartstate["Cart context"]
  node_httpclient["REST client<br/>[client.js]"]
end

subgraph group_api["API and business services"]
  node_apiserver["HTTP API server<br/>[server.js]"]
  node_routing["REST routes<br/>[app.js]"]
  node_auth["JWT access control<br/>[auth.js]"]
  node_productroutes["Product routes<br/>[products.js]"]
  node_produceroutes["Producer routes<br/>[producers.js]"]
  node_orderroutes["Order routes<br/>[orders.js]"]
  node_auctionroutes["Auction routes<br/>[auctions.js]"]
  node_reviewroutes["Review routes<br/>[reviews.js]"]
  node_adminroutes["Admin routes<br/>[admin.js]"]
  node_auctioncycle["Auction lifecycle<br/>[cicloLeiloes.js]"]
  node_imagestore["Image storage<br/>[imagens.js]"]
end

subgraph group_data["Domain data"]
  node_models["Domain models"]
  node_auctionmodel["Auction model<br/>[Auction.js]"]
  node_ordermodel["Order model<br/>[Order.js]"]
  node_usermodel["User model<br/>[User.js]"]
  node_bidmodel["Bid model<br/>[Bid.js]"]
  node_productmodel["Product model<br/>[Product.js]"]
  node_reviewmodel["Review model<br/>[Review.js]"]
end

subgraph group_realtime["Live events"]
  node_socketcontext["Socket connection<br/>[SocketContext.jsx]"]
  node_socketserver["Socket server<br/>[index.js]"]
  node_auctionevents["Auction events<br/>[leiloes.js]"]
  node_notifier["Notifications<br/>[notificacoes.js]"]
end

node_visitor(("Visitor / user"))
node_mongo[("MongoDB")]
node_cloudinary[("Cloudinary")]

node_visitor -->|"uses"| node_spa
node_spa -->|"routes to"| node_catalog
node_spa -->|"routes to"| node_buyer
node_spa -->|"routes to"| node_auctionui
node_spa -->|"routes to"| node_rolesui
node_catalog -->|"requests data"| node_httpclient
node_buyer -.->|"requests data"| node_httpclient
node_rolesui -.->|"requests data"| node_httpclient
node_auctionui -.->|"uses live events"| node_socketcontext
node_httpclient -->|"calls REST"| node_routing
node_session -->|"validates session"| node_httpclient
node_spa -->|"provides session"| node_session
node_spa -->|"provides cart"| node_cartstate
node_apiserver -->|"serves"| node_routing
node_apiserver -->|"registers sockets"| node_socketserver
node_apiserver -->|"starts cycle"| node_auctioncycle
node_routing -->|"mounts"| node_productroutes
node_routing -->|"mounts"| node_produceroutes
node_routing -->|"mounts"| node_orderroutes
node_routing -->|"mounts"| node_auctionroutes
node_routing -->|"mounts"| node_reviewroutes
node_routing -->|"mounts"| node_adminroutes
node_orderroutes -->|"checks access"| node_auth
node_reviewroutes -->|"checks access"| node_auth
node_reviewroutes -->|"checks delivery"| node_ordermodel
node_reviewroutes -->|"creates reviews"| node_reviewmodel
node_orderroutes -->|"persists orders"| node_mongo
node_productroutes -->|"persists products"| node_mongo
node_auctionroutes -->|"persists bids"| node_mongo
node_adminroutes -->|"updates records"| node_mongo
node_auctioncycle -->|"updates auctions"| node_mongo
node_auctioncycle -->|"uses"| node_auctionmodel
node_auctioncycle -->|"creates winner order"| node_ordermodel
node_socketserver -->|"registers"| node_auctionevents
node_auctionevents -->|"reads and updates"| node_auctionmodel
node_auctionevents -->|"records bids"| node_bidmodel
node_socketcontext -->|"connects by Socket.io"| node_apiserver
node_orderroutes -->|"notifies"| node_notifier
node_auctioncycle -->|"notifies"| node_notifier
node_auctionevents -->|"notifies"| node_notifier
node_imagestore -->|"uploads images"| node_cloudinary
node_imagestore -->|"stores image URL"| node_mongo

click node_spa "https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/App.jsx"
click node_catalog "https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/pages/Catalogo.jsx"
click node_buyer "https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/pages/Carrinho.jsx"
click node_auctionui "https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/pages/SalaLeilao.jsx"
click node_rolesui "https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/pages/produtor/Painel.jsx"
click node_session "https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/context/AuthContext.jsx"
click node_cartstate "https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/context/CarrinhoContext.jsx"
click node_httpclient "https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/api/client.js"
click node_apiserver "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/server.js"
click node_routing "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/app.js"
click node_auth "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/middleware/auth.js"
click node_productroutes "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/products.js"
click node_produceroutes "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/producers.js"
click node_orderroutes "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/orders.js"
click node_auctionroutes "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/auctions.js"
click node_reviewroutes "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/reviews.js"
click node_adminroutes "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/admin.js"
click node_auctioncycle "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/services/cicloLeiloes.js"
click node_imagestore "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/services/imagens.js"
click node_models "https://github.com/tomasf05/do-campo-a-mesa/tree/main/api/src/models"
click node_auctionmodel "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/Auction.js"
click node_ordermodel "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/Order.js"
click node_usermodel "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/User.js"
click node_bidmodel "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/Bid.js"
click node_productmodel "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/Product.js"
click node_reviewmodel "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/Review.js"
click node_socketcontext "https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/context/SocketContext.jsx"
click node_socketserver "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/sockets/index.js"
click node_auctionevents "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/sockets/leiloes.js"
click node_notifier "https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/services/notificacoes.js"

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_spa,node_catalog,node_buyer,node_auctionui,node_rolesui,node_session,node_cartstate,node_httpclient,node_visitor toneBlue
class node_apiserver,node_routing,node_auth,node_productroutes,node_produceroutes,node_orderroutes,node_auctionroutes,node_reviewroutes,node_adminroutes,node_auctioncycle,node_imagestore,node_mongo,node_cloudinary toneAmber
class node_models,node_auctionmodel,node_ordermodel,node_usermodel,node_bidmodel,node_productmodel,node_reviewmodel toneMint
class node_socketcontext,node_socketserver,node_auctionevents,node_notifier toneRose
```

## Components

### Web application

- [Web application](https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/App.jsx): `web/src/App.jsx`
- [Catalog and profiles](https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/pages/Catalogo.jsx): `web/src/pages/Catalogo.jsx`
- [Cart and orders](https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/pages/Carrinho.jsx): `web/src/pages/Carrinho.jsx`
- [Auction experience](https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/pages/SalaLeilao.jsx): `web/src/pages/SalaLeilao.jsx`
- [Producer and admin](https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/pages/produtor/Painel.jsx): `web/src/pages/produtor/Painel.jsx`
- [Session context](https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/context/AuthContext.jsx): `web/src/context/AuthContext.jsx`
- [Cart context](https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/context/CarrinhoContext.jsx): `web/src/context/CarrinhoContext.jsx`
- [REST client](https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/api/client.js): `web/src/api/client.js`

### API and business services

- [HTTP API server](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/server.js): `api/src/server.js`
- [REST routes](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/app.js): `api/src/app.js`
- [JWT access control](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/middleware/auth.js): `api/src/middleware/auth.js`
- [Product routes](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/products.js): `api/src/routes/products.js`
- [Producer routes](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/producers.js): `api/src/routes/producers.js`
- [Order routes](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/orders.js): `api/src/routes/orders.js`
- [Auction routes](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/auctions.js): `api/src/routes/auctions.js`
- [Review routes](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/reviews.js): `api/src/routes/reviews.js`
- [Admin routes](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/routes/admin.js): `api/src/routes/admin.js`
- [Auction lifecycle](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/services/cicloLeiloes.js): `api/src/services/cicloLeiloes.js`
- [Image storage](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/services/imagens.js): `api/src/services/imagens.js`

### Domain data

- [Domain models](https://github.com/tomasf05/do-campo-a-mesa/tree/main/api/src/models): `api/src/models`
- [Auction model](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/Auction.js): `api/src/models/Auction.js`
- [Order model](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/Order.js): `api/src/models/Order.js`
- [User model](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/User.js): `api/src/models/User.js`
- [Bid model](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/Bid.js): `api/src/models/Bid.js`
- [Product model](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/Product.js): `api/src/models/Product.js`
- [Review model](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/models/Review.js): `api/src/models/Review.js`

### Live events

- [Socket connection](https://github.com/tomasf05/do-campo-a-mesa/blob/main/web/src/context/SocketContext.jsx): `web/src/context/SocketContext.jsx`
- [Socket server](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/sockets/index.js): `api/src/sockets/index.js`
- [Auction events](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/sockets/leiloes.js): `api/src/sockets/leiloes.js`
- [Notifications](https://github.com/tomasf05/do-campo-a-mesa/blob/main/api/src/services/notificacoes.js): `api/src/services/notificacoes.js`

### Other components

- **Visitor / user**
- **MongoDB**
- **Cloudinary**

## Connections

- Visitor / user → Web application: uses (evidence: `README.md`)
- Web application → Catalog and profiles: routes to (evidence: `web/src/App.jsx`)
- Web application → Cart and orders: routes to (evidence: `web/src/App.jsx`)
- Web application → Auction experience: routes to (evidence: `web/src/App.jsx`)
- Web application → Producer and admin: routes to (evidence: `web/src/App.jsx`)
- Catalog and profiles → REST client: requests data (evidence: `web/src/pages/Catalogo.jsx`)
- Cart and orders → REST client: requests data
- Producer and admin → REST client: requests data (evidence: `web/src/pages/produtor/Painel.jsx`)
- Auction experience → Socket connection: uses live events
- REST client → REST routes: calls REST (evidence: `README.md`)
- Session context → REST client: validates session (evidence: `web/src/context/AuthContext.jsx`)
- Web application → Session context: provides session (evidence: `web/src/main.jsx`)
- Web application → Cart context: provides cart (evidence: `web/src/main.jsx`)
- HTTP API server → REST routes: serves (evidence: `api/src/server.js`)
- HTTP API server → Socket server: registers sockets (evidence: `api/src/server.js`)
- HTTP API server → Auction lifecycle: starts cycle (evidence: `api/src/server.js`)
- REST routes → Product routes: mounts (evidence: `api/src/app.js`)
- REST routes → Producer routes: mounts (evidence: `api/src/app.js`)
- REST routes → Order routes: mounts (evidence: `api/src/app.js`)
- REST routes → Auction routes: mounts (evidence: `api/src/app.js`)
- REST routes → Review routes: mounts (evidence: `api/src/app.js`)
- REST routes → Admin routes: mounts (evidence: `api/src/app.js`)
- Order routes → JWT access control: checks access (evidence: `api/src/routes/orders.js`)
- Review routes → JWT access control: checks access (evidence: `api/src/routes/reviews.js`)
- Review routes → Order model: checks delivery (evidence: `api/src/routes/reviews.js`)
- Review routes → Review model: creates reviews (evidence: `api/src/routes/reviews.js`)
- Order routes → MongoDB: persists orders (evidence: `README.md`)
- Product routes → MongoDB: persists products (evidence: `README.md`)
- Auction routes → MongoDB: persists bids (evidence: `README.md`)
- Admin routes → MongoDB: updates records (evidence: `README.md`)
- Auction lifecycle → MongoDB: updates auctions (evidence: `README.md`)
- Auction lifecycle → Auction model: uses (evidence: `api/src/services/cicloLeiloes.js`)
- Auction lifecycle → Order model: creates winner order (evidence: `api/src/services/cicloLeiloes.js`)
- Socket server → Auction events: registers (evidence: `api/src/sockets/index.js`)
- Auction events → Auction model: reads and updates (evidence: `api/src/sockets/leiloes.js`)
- Auction events → Bid model: records bids (evidence: `api/src/sockets/leiloes.js`)
- Socket connection → HTTP API server: connects by Socket.io (evidence: `README.md`)
- Order routes → Notifications: notifies (evidence: `api/src/routes/orders.js`)
- Auction lifecycle → Notifications: notifies (evidence: `api/src/services/cicloLeiloes.js`)
- Auction events → Notifications: notifies (evidence: `api/src/sockets/leiloes.js`)
- Image storage → Cloudinary: uploads images (evidence: `README.md`)
- Image storage → MongoDB: stores image URL (evidence: `README.md`)
