# daniel-2010/curso-basico-mern architecture

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

- Interactive diagram: https://gitdiagram.com/daniel-2010/curso-basico-mern
- Repository: https://github.com/daniel-2010/curso-basico-mern

## Overview

This repository is a MERN-style product and user management application: a React client serves public product pages and a protected admin area, while an Express API exposes product and user operations. The main admin workflow is login, token verification for protected routes, then managing users or products through API requests. User authentication and CRUD handling are visible in the excerpts; product routes and controller/model responsibilities are also visible, though several product-page implementations are minimal or unsampled. The database implementation is represented by model nodes; storage details are not established by the excerpts.

Main entry points: [`client/src/routes.js`](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/routes.js) (Client routes), [`client/src/services/api.js`](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/services/api.js) (HTTP API client), [`client/src/pages/admin/login/index.js`](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/pages/admin/login/index.js) (Admin login), [`client/src/services/wAuth.js`](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/services/wAuth.js) (Token route guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Client app<br/>[App.js]"]
  node_client_routes["Client routes<br/>[routes.js]"]
  node_public_pages["Public product pages"]
  node_client_api["HTTP API client<br/>[api.js]"]
end

subgraph group_admin["Admin workflows"]
  node_login["Admin login<br/>[index.js]"]
  node_auth_guard["Token route guard<br/>[wAuth.js]"]
  node_auth_state["Browser auth state<br/>[auth.js]"]
  node_admin_dashboard["Admin dashboard"]
  node_admin_menu["Admin navigation<br/>[menu-admin.js]"]
  node_menu_items["Navigation items<br/>[list-menu-admin.js]"]
  node_user_list["User listing<br/>[index.js]"]
  node_user_create["User creation"]
  node_user_edit["User editing<br/>[usuarios.editar.js]"]
  node_product_admin["Product administration"]
end

subgraph group_api["Express API"]
  node_server["HTTP server<br/>[server.js]"]
  node_api_routes["API routes<br/>[routes.js]"]
  node_user_controller["User controller"]
  node_product_controller["Product controller"]
end

subgraph group_data["Domain models"]
  node_user_model["User model<br/>[usuario.model.js]"]
  node_product_model["Product model<br/>[produto.model.js]"]
end

node_visitor(("Visitor"))
node_database[("Database")]

node_visitor -->|"opens"| node_app
node_app -->|"renders"| node_client_routes
node_client_routes -->|"routes to"| node_public_pages
node_client_routes -->|"routes to"| node_login
node_client_routes -->|"protects routes"| node_auth_guard
node_client_routes -->|"routes to"| node_admin_dashboard
node_client_routes -->|"routes to"| node_user_list
node_client_routes -->|"routes to"| node_user_create
node_client_routes -->|"routes to"| node_user_edit
node_client_routes -->|"routes to"| node_product_admin
node_login -->|"submits credentials"| node_client_api
node_login -->|"stores session"| node_auth_state
node_auth_guard -->|"checks token"| node_client_api
node_auth_guard -->|"reads or clears"| node_auth_state
node_admin_dashboard -->|"renders"| node_admin_menu
node_admin_menu -->|"renders"| node_menu_items
node_user_list -->|"loads and changes"| node_client_api
node_user_create -->|"submits user"| node_client_api
node_user_edit -->|"updates user"| node_client_api
node_product_admin -.->|"uses API"| node_client_api
node_client_api -->|"HTTP requests"| node_server
node_server -->|"mounts routes"| node_api_routes
node_api_routes -->|"dispatches user routes"| node_user_controller
node_api_routes -->|"dispatches product routes"| node_product_controller
node_user_controller -->|"queries"| node_user_model
node_product_controller -->|"queries"| node_product_model
node_user_model -.->|"persists user data"| node_database
node_product_model -.->|"persists product data"| node_database

click node_app "https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/App.js"
click node_client_routes "https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/routes.js"
click node_public_pages "https://github.com/daniel-2010/curso-basico-mern/tree/master/client/src/pages/client"
click node_login "https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/pages/admin/login/index.js"
click node_auth_guard "https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/services/wAuth.js"
click node_auth_state "https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/services/auth.js"
click node_admin_dashboard "https://github.com/daniel-2010/curso-basico-mern/tree/master/client/src/pages/admin/dashboard"
click node_admin_menu "https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/components/menu-admin.js"
click node_menu_items "https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/components/list-menu-admin.js"
click node_user_list "https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/pages/admin/usuarios/index.js"
click node_user_create "https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/pages/admin/usuarios/usuarios.cadastrar.js"
click node_user_edit "https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/pages/admin/usuarios/usuarios.editar.js"
click node_product_admin "https://github.com/daniel-2010/curso-basico-mern/tree/master/client/src/pages/admin/produtos"
click node_client_api "https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/services/api.js"
click node_server "https://github.com/daniel-2010/curso-basico-mern/blob/master/server.js"
click node_api_routes "https://github.com/daniel-2010/curso-basico-mern/blob/master/src/routes.js"
click node_user_controller "https://github.com/daniel-2010/curso-basico-mern/blob/master/src/controllers/usuarios.controller.js"
click node_product_controller "https://github.com/daniel-2010/curso-basico-mern/blob/master/src/controllers/produtos.controller.js"
click node_user_model "https://github.com/daniel-2010/curso-basico-mern/blob/master/src/models/usuario.model.js"
click node_product_model "https://github.com/daniel-2010/curso-basico-mern/blob/master/src/models/produto.model.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_app,node_client_routes,node_public_pages,node_client_api toneBlue
class node_login,node_auth_guard,node_auth_state,node_admin_dashboard,node_admin_menu,node_menu_items,node_user_list,node_user_create,node_user_edit,node_product_admin,node_database toneAmber
class node_server,node_api_routes,node_user_controller,node_product_controller toneMint
class node_user_model,node_product_model toneRose
class node_visitor toneIndigo
```

## Components

### React client

- [Client app](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/App.js): `client/src/App.js`
- [Client routes](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/routes.js): `client/src/routes.js`
- [Public product pages](https://github.com/daniel-2010/curso-basico-mern/tree/master/client/src/pages/client): `client/src/pages/client`
- [HTTP API client](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/services/api.js): `client/src/services/api.js`

### Admin workflows

- [Admin login](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/pages/admin/login/index.js): `client/src/pages/admin/login/index.js`
- [Token route guard](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/services/wAuth.js): `client/src/services/wAuth.js`
- [Browser auth state](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/services/auth.js): `client/src/services/auth.js`
- [Admin dashboard](https://github.com/daniel-2010/curso-basico-mern/tree/master/client/src/pages/admin/dashboard): `client/src/pages/admin/dashboard`
- [Admin navigation](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/components/menu-admin.js): `client/src/components/menu-admin.js`
- [Navigation items](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/components/list-menu-admin.js): `client/src/components/list-menu-admin.js`
- [User listing](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/pages/admin/usuarios/index.js): `client/src/pages/admin/usuarios/index.js`
- [User creation](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/pages/admin/usuarios/usuarios.cadastrar.js): `client/src/pages/admin/usuarios/usuarios.cadastrar.js`
- [User editing](https://github.com/daniel-2010/curso-basico-mern/blob/master/client/src/pages/admin/usuarios/usuarios.editar.js): `client/src/pages/admin/usuarios/usuarios.editar.js`
- [Product administration](https://github.com/daniel-2010/curso-basico-mern/tree/master/client/src/pages/admin/produtos): `client/src/pages/admin/produtos`

### Express API

- [HTTP server](https://github.com/daniel-2010/curso-basico-mern/blob/master/server.js): `server.js`
- [API routes](https://github.com/daniel-2010/curso-basico-mern/blob/master/src/routes.js): `src/routes.js`
- [User controller](https://github.com/daniel-2010/curso-basico-mern/blob/master/src/controllers/usuarios.controller.js): `src/controllers/usuarios.controller.js`
- [Product controller](https://github.com/daniel-2010/curso-basico-mern/blob/master/src/controllers/produtos.controller.js): `src/controllers/produtos.controller.js`

### Domain models

- [User model](https://github.com/daniel-2010/curso-basico-mern/blob/master/src/models/usuario.model.js): `src/models/usuario.model.js`
- [Product model](https://github.com/daniel-2010/curso-basico-mern/blob/master/src/models/produto.model.js): `src/models/produto.model.js`

### Other components

- **Visitor**
- **Database**

## Connections

- Visitor → Client app: opens (evidence: `client/src/App.js`)
- Client app → Client routes: renders (evidence: `client/src/App.js`)
- Client routes → Public product pages: routes to (evidence: `client/src/routes.js`)
- Client routes → Admin login: routes to (evidence: `client/src/routes.js`)
- Client routes → Token route guard: protects routes (evidence: `client/src/routes.js`)
- Client routes → Admin dashboard: routes to (evidence: `client/src/routes.js`)
- Client routes → User listing: routes to (evidence: `client/src/routes.js`)
- Client routes → User creation: routes to (evidence: `client/src/routes.js`)
- Client routes → User editing: routes to (evidence: `client/src/routes.js`)
- Client routes → Product administration: routes to (evidence: `client/src/routes.js`)
- Admin login → HTTP API client: submits credentials (evidence: `client/src/pages/admin/login/index.js`)
- Admin login → Browser auth state: stores session (evidence: `client/src/pages/admin/login/index.js`)
- Token route guard → HTTP API client: checks token (evidence: `client/src/services/wAuth.js`)
- Token route guard → Browser auth state: reads or clears (evidence: `client/src/services/wAuth.js`)
- Admin dashboard → Admin navigation: renders (evidence: `client/src/pages/admin/dashboard/index.js`)
- Admin navigation → Navigation items: renders (evidence: `client/src/components/menu-admin.js`)
- User listing → HTTP API client: loads and changes (evidence: `client/src/pages/admin/usuarios/index.js`)
- User creation → HTTP API client: submits user (evidence: `client/src/pages/admin/usuarios/usuarios.cadastrar.js`)
- User editing → HTTP API client: updates user (evidence: `client/src/pages/admin/usuarios/usuarios.editar.js`)
- Product administration → HTTP API client: uses API
- HTTP API client → HTTP server: HTTP requests (evidence: `client/src/services/api.js`)
- HTTP server → API routes: mounts routes (evidence: `server.js`)
- API routes → User controller: dispatches user routes (evidence: `src/routes.js`)
- API routes → Product controller: dispatches product routes (evidence: `src/routes.js`)
- User controller → User model: queries (evidence: `src/controllers/usuarios.controller.js`)
- Product controller → Product model: queries (evidence: `src/controllers/produtos.controller.js`)
- User model → Database: persists user data
- Product model → Database: persists product data
