# brunogfv/mapa-da-saude architecture

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

- Interactive diagram: https://gitdiagram.com/brunogfv/mapa-da-saude
- Repository: https://github.com/brunogfv/mapa-da-saude

## Overview

Mapa da Saúde is a medical directory with public doctor and specialty discovery, search, filtering, profiles, and contact submission, plus authenticated administration. The public workflow is browser discovery through the medical listing API, which queries SQLite and returns JSON; admins also sign in and manage records. The README documents frontend/API HTTP communication and product capabilities. Backend routes, controllers, middleware, and database behavior are shown in excerpts; some frontend-to-endpoint details and the documented contact-file behavior are not confirmed by sampled source.

Main entry points: [`back-end/src/routes/medicos.routes.js`](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/routes/medicos.routes.js) (Doctor routes), [`back-end/src/middleware/auth.js`](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/middleware/auth.js) (Token validation), [`back-end/src/app.js`](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/app.js) (HTTP application), [`back-end/src/routes/contatos.routes.js`](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/routes/contatos.routes.js) (Contact routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Public discovery"]
  node_doctor_search["Doctor search<br/>[medicos.js]"]
  node_specialty_browse["Specialty browsing<br/>[especialidades.js]"]
  node_doctor_profile["Doctor details<br/>[medico-detalhe.js]"]
  node_contact_form["Contact form<br/>[contato.html]"]
end

subgraph group_admin["Admin experience"]
  node_admin_ui["Admin interface<br/>[admin.js]"]
  node_login_page["Admin login<br/>[login.html]"]
end

subgraph group_api["REST API"]
  node_medicos_routes["Doctor routes<br/>[medicos.routes.js]"]
  node_medicos_controller["Doctor operations"]
  node_specialty_routes["Specialty routes"]
  node_specialty_controller["Specialty operations"]
  node_contact_routes["Contact routes<br/>[contatos.routes.js]"]
  node_contact_controller["Contact operations"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_auth_controller["Authentication<br/>[auth.controller.js]"]
  node_app["HTTP application<br/>[app.js]"]
end

subgraph group_core["Data and security"]
  node_auth_middleware["Token validation<br/>[auth.js]"]
  node_upload_middleware["Photo upload<br/>[upload.js]"]
  node_sqlite[("SQLite database<br/>[db.js]")]
end

node_visitor(("Site visitor"))

node_visitor -->|"searches"| node_doctor_search
node_doctor_search -->|"requests listing"| node_medicos_routes
node_visitor -->|"browses"| node_specialty_browse
node_visitor -->|"views details"| node_doctor_profile
node_visitor -->|"sends message"| node_contact_form
node_contact_form -.->|"submits contact"| node_contact_routes
node_medicos_routes -->|"dispatches"| node_medicos_controller
node_medicos_controller -->|"queries and updates"| node_sqlite
node_specialty_routes -->|"dispatches"| node_specialty_controller
node_specialty_controller -->|"reads and writes"| node_sqlite
node_contact_routes -->|"dispatches"| node_contact_controller
node_contact_controller -->|"reads and writes"| node_sqlite
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"checks credentials"| node_sqlite
node_auth_controller -->|"creates token"| node_auth_middleware
node_medicos_routes -->|"guards changes"| node_auth_middleware
node_specialty_routes -->|"guards changes"| node_auth_middleware
node_contact_routes -->|"guards listing"| node_auth_middleware
node_auth_routes -->|"guards verification"| node_auth_middleware
node_medicos_routes -->|"accepts photos"| node_upload_middleware
node_app -->|"mounts"| node_medicos_routes
node_app -->|"mounts"| node_specialty_routes
node_app -->|"mounts"| node_contact_routes
node_app -->|"mounts"| node_auth_routes
node_admin_ui -.->|"uses authentication"| node_auth_routes
node_login_page -.->|"supports login"| node_admin_ui

click node_doctor_search "https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/js/medicos.js"
click node_specialty_browse "https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/js/especialidades.js"
click node_doctor_profile "https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/js/medico-detalhe.js"
click node_contact_form "https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/contato.html"
click node_admin_ui "https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/js/admin.js"
click node_login_page "https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/admin/login.html"
click node_medicos_routes "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/routes/medicos.routes.js"
click node_medicos_controller "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/controllers/medicos.controller.js"
click node_specialty_routes "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/routes/especialidades.routes.js"
click node_specialty_controller "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/controllers/especialidades.controller.js"
click node_contact_routes "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/routes/contatos.routes.js"
click node_contact_controller "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/controllers/contatos.controller.js"
click node_auth_routes "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/routes/auth.routes.js"
click node_auth_controller "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/controllers/auth.controller.js"
click node_app "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/app.js"
click node_auth_middleware "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/middleware/auth.js"
click node_upload_middleware "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/middleware/upload.js"
click node_sqlite "https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/database/db.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_doctor_search,node_specialty_browse,node_doctor_profile,node_contact_form toneBlue
class node_admin_ui,node_login_page toneAmber
class node_medicos_routes,node_medicos_controller,node_specialty_routes,node_specialty_controller,node_contact_routes,node_contact_controller,node_auth_routes,node_auth_controller,node_app toneMint
class node_auth_middleware,node_upload_middleware,node_sqlite toneRose
class node_visitor toneIndigo
```

## Components

### Public discovery

- [Doctor search](https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/js/medicos.js): `front-end/js/medicos.js`
- [Specialty browsing](https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/js/especialidades.js): `front-end/js/especialidades.js`
- [Doctor details](https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/js/medico-detalhe.js): `front-end/js/medico-detalhe.js`
- [Contact form](https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/contato.html): `front-end/contato.html`

### Admin experience

- [Admin interface](https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/js/admin.js): `front-end/js/admin.js`
- [Admin login](https://github.com/brunogfv/mapa-da-saude/blob/main/front-end/admin/login.html): `front-end/admin/login.html`

### REST API

- [Doctor routes](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/routes/medicos.routes.js): `back-end/src/routes/medicos.routes.js`
- [Doctor operations](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/controllers/medicos.controller.js): `back-end/src/controllers/medicos.controller.js`
- [Specialty routes](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/routes/especialidades.routes.js): `back-end/src/routes/especialidades.routes.js`
- [Specialty operations](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/controllers/especialidades.controller.js): `back-end/src/controllers/especialidades.controller.js`
- [Contact routes](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/routes/contatos.routes.js): `back-end/src/routes/contatos.routes.js`
- [Contact operations](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/controllers/contatos.controller.js): `back-end/src/controllers/contatos.controller.js`
- [Auth routes](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/routes/auth.routes.js): `back-end/src/routes/auth.routes.js`
- [Authentication](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/controllers/auth.controller.js): `back-end/src/controllers/auth.controller.js`
- [HTTP application](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/app.js): `back-end/src/app.js`

### Data and security

- [Token validation](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/middleware/auth.js): `back-end/src/middleware/auth.js`
- [Photo upload](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/middleware/upload.js): `back-end/src/middleware/upload.js`
- [SQLite database](https://github.com/brunogfv/mapa-da-saude/blob/main/back-end/src/database/db.js): `back-end/src/database/db.js`

### Other components

- **Site visitor**

## Connections

- Site visitor → Doctor search: searches (evidence: `README.md`)
- Doctor search → Doctor routes: requests listing (evidence: `README.md`)
- Site visitor → Specialty browsing: browses (evidence: `README.md`)
- Site visitor → Doctor details: views details (evidence: `README.md`)
- Site visitor → Contact form: sends message (evidence: `README.md`)
- Contact form → Contact routes: submits contact
- Doctor routes → Doctor operations: dispatches (evidence: `back-end/src/routes/medicos.routes.js`)
- Doctor operations → SQLite database: queries and updates (evidence: `back-end/src/controllers/medicos.controller.js`)
- Specialty routes → Specialty operations: dispatches (evidence: `back-end/src/routes/especialidades.routes.js`)
- Specialty operations → SQLite database: reads and writes (evidence: `back-end/src/controllers/especialidades.controller.js`)
- Contact routes → Contact operations: dispatches (evidence: `back-end/src/routes/contatos.routes.js`)
- Contact operations → SQLite database: reads and writes (evidence: `back-end/src/controllers/contatos.controller.js`)
- Auth routes → Authentication: dispatches (evidence: `back-end/src/routes/auth.routes.js`)
- Authentication → SQLite database: checks credentials (evidence: `back-end/src/controllers/auth.controller.js`)
- Authentication → Token validation: creates token (evidence: `back-end/src/controllers/auth.controller.js`)
- Doctor routes → Token validation: guards changes (evidence: `back-end/src/routes/medicos.routes.js`)
- Specialty routes → Token validation: guards changes (evidence: `back-end/src/routes/especialidades.routes.js`)
- Contact routes → Token validation: guards listing (evidence: `back-end/src/routes/contatos.routes.js`)
- Auth routes → Token validation: guards verification (evidence: `back-end/src/routes/auth.routes.js`)
- Doctor routes → Photo upload: accepts photos (evidence: `back-end/src/routes/medicos.routes.js`)
- HTTP application → Doctor routes: mounts (evidence: `back-end/src/app.js`)
- HTTP application → Specialty routes: mounts (evidence: `back-end/src/app.js`)
- HTTP application → Contact routes: mounts (evidence: `back-end/src/app.js`)
- HTTP application → Auth routes: mounts (evidence: `back-end/src/app.js`)
- Admin interface → Auth routes: uses authentication
- Admin login → Admin interface: supports login
