# patrick-hoff/project-laboratorio architecture

> Architecture diagram of the GitHub repository patrick-hoff/project-laboratorio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/patrick-hoff/project-laboratorio
- Repository: https://github.com/patrick-hoff/project-laboratorio

## Overview

Sistema web para gestão de laboratório: usuários autenticados cadastram pacientes e exames, agendam consultas, montam atendimentos e registram pagamentos; administradores também gerenciam usuários e consultam logs e indicadores. O frontend React acessa uma API Express, cujos controladores operam sobre MySQL. Os recursos principais documentados no README foram preservados. Algumas ligações entre telas e endpoints são documentadas, mas seus detalhes de implementação não foram todos amostrados; essas relações são citadas como capacidades documentadas, não como inspeção do código.

Main entry points: [`front/src/services/api.js`](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/services/api.js) (Cliente HTTP), [`api/index.js`](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/index.js) (Servidor Express), [`api/db.js`](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/db.js) (MySQL), [`api/controllers/log.js`](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/log.js) (API de logs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Aplicação web"]
  node_app["Aplicação React<br/>[App.jsx]"]
  node_routing["Rotas protegidas<br/>[index.jsx]"]
  node_usercontext["Contexto do usuário<br/>[UserContext.jsx]"]
  node_api_client["Cliente HTTP<br/>[api.js]"]
end

subgraph group_clinic["Operação clínica"]
  node_patient_ui["Cadastro de pacientes<br/>[Pacientes.jsx]"]
  node_exam_ui["Cadastro de exames<br/>[Exames.jsx]"]
  node_appointment_ui["Agendar consulta"]
  node_consultations_ui["Consultas agendadas<br/>[Consultas.jsx]"]
  node_visit_ui["Atendimento clínico<br/>[Atendimento.jsx]"]
  node_payment_ui["Financeiro do atendimento"]
  node_dashboard_ui["Dashboard diário<br/>[Dashboard.jsx]"]
  node_doctor_ui["Gestão de médicos<br/>[Medico.jsx]"]
  node_insurance_ui["Convênios e exames<br/>[ExameConvenio.jsx]"]
end

subgraph group_admin["Administração"]
  node_users_ui["Gestão de usuários<br/>[Usuarios.jsx]"]
  node_profile_ui["Perfil do usuário<br/>[myUser.jsx]"]
  node_logs_ui["Logs de alterações<br/>[Logs.jsx]"]
end

subgraph group_server["API e persistência"]
  node_server["Servidor Express<br/>[index.js]"]
  node_auth["Autenticação JWT<br/>[auth.js]"]
  node_patient_api["API de pacientes<br/>[pacientes.js]"]
  node_exam_api["API de exames<br/>[exames.js]"]
  node_appointment_api["API de agendamentos<br/>[agendamento.js]"]
  node_visit_api["API de atendimentos<br/>[atendimentos.js]"]
  node_visit_exams_api["Exames do atendimento"]
  node_payment_api["API de pagamentos<br/>[pagamentos.js]"]
  node_dashboard_api["API do dashboard<br/>[dashboard.js]"]
  node_doctors_api["API de médicos<br/>[medicos.js]"]
  node_insurance_api["API de convênios<br/>[exames_convenio.js]"]
  node_users_api["API de usuários<br/>[usuarios.js]"]
  node_logs_api["API de logs<br/>[log.js]"]
  node_db[("MySQL<br/>[db.js]")]
end

node_staff(("Equipe do laboratório"))

node_staff -->|"usa"| node_app
node_app -->|"renderiza"| node_routing
node_app -->|"envolve"| node_usercontext
node_usercontext -->|"consulta usuário"| node_api_client
node_patient_ui -->|"consulta API"| node_api_client
node_exam_ui -->|"consulta API"| node_api_client
node_appointment_ui -->|"consulta API"| node_api_client
node_consultations_ui -->|"consulta API"| node_api_client
node_visit_ui -->|"consulta API"| node_api_client
node_payment_ui -->|"consulta API"| node_api_client
node_dashboard_ui -->|"consulta API"| node_api_client
node_doctor_ui -->|"consulta API"| node_api_client
node_insurance_ui -->|"consulta API"| node_api_client
node_users_ui -->|"consulta API"| node_api_client
node_profile_ui -->|"consulta API"| node_api_client
node_logs_ui -->|"consulta API"| node_api_client
node_api_client -->|"envia requisições"| node_server
node_server -->|"monta rotas"| node_patient_api
node_server -->|"monta rotas"| node_exam_api
node_server -->|"monta rotas"| node_appointment_api
node_server -->|"monta rotas"| node_visit_api
node_server -->|"monta rotas"| node_visit_exams_api
node_server -->|"monta rotas"| node_payment_api
node_server -->|"monta rotas"| node_dashboard_api
node_server -->|"monta rotas"| node_doctors_api
node_server -->|"monta rotas"| node_insurance_api
node_server -->|"monta rotas"| node_users_api
node_server -->|"monta rotas"| node_logs_api
node_patient_api -->|"consulta e grava"| node_db
node_exam_api -->|"consulta e grava"| node_db
node_appointment_api -->|"consulta e grava"| node_db
node_visit_api -->|"consulta e grava"| node_db
node_visit_exams_api -->|"consulta e grava"| node_db
node_payment_api -.->|"consulta e grava"| node_db
node_dashboard_api -.->|"consulta"| node_db
node_doctors_api -.->|"consulta e grava"| node_db
node_insurance_api -.->|"consulta e grava"| node_db
node_users_api -->|"consulta e grava"| node_db
node_logs_api -.->|"consulta"| node_db
node_patient_api -.->|"usa identidade"| node_auth
node_exam_api -->|"usa identidade"| node_auth
node_users_api -->|"protege rotas"| node_auth
node_logs_api -->|"protege rotas"| node_auth
node_patient_api -.->|"registra alterações"| node_logs_api
node_exam_api -.->|"registra alterações"| node_logs_api

click node_app "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/App.jsx"
click node_routing "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/routes/index.jsx"
click node_usercontext "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/routes/UserContext.jsx"
click node_api_client "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/services/api.js"
click node_patient_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Paciente/Pacientes.jsx"
click node_exam_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Exames/Exames.jsx"
click node_appointment_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Agendar_consulta/Agendar_consulta.jsx"
click node_consultations_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Consultas/Consultas.jsx"
click node_visit_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Atendimento/Atendimento.jsx"
click node_payment_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/AtendimentoFinanceiro/AtendimentoFinanceiro.jsx"
click node_dashboard_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Dashboard/Dashboard.jsx"
click node_doctor_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Medico/Medico.jsx"
click node_insurance_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/ExameConvenio/ExameConvenio.jsx"
click node_users_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Usuarios/Usuarios.jsx"
click node_profile_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/myUser/myUser.jsx"
click node_logs_ui "https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Log/Logs.jsx"
click node_server "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/index.js"
click node_auth "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/middlewares/auth.js"
click node_patient_api "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/pacientes.js"
click node_exam_api "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/exames.js"
click node_appointment_api "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/agendamento.js"
click node_visit_api "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/atendimentos.js"
click node_visit_exams_api "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/exames_atendimento.js"
click node_payment_api "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/pagamentos.js"
click node_dashboard_api "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/dashboard.js"
click node_doctors_api "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/medicos.js"
click node_insurance_api "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/exames_convenio.js"
click node_users_api "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/usuarios.js"
click node_logs_api "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/log.js"
click node_db "https://github.com/patrick-hoff/project-laboratorio/blob/main/api/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_app,node_routing,node_usercontext,node_api_client toneBlue
class node_patient_ui,node_exam_ui,node_appointment_ui,node_consultations_ui,node_visit_ui,node_payment_ui,node_dashboard_ui,node_doctor_ui,node_insurance_ui toneAmber
class node_users_ui,node_profile_ui,node_logs_ui toneMint
class node_server,node_auth,node_patient_api,node_exam_api,node_appointment_api,node_visit_api,node_visit_exams_api,node_payment_api,node_dashboard_api,node_doctors_api,node_insurance_api,node_users_api,node_logs_api,node_db toneRose
class node_staff toneIndigo
```

## Components

### Aplicação web

- [Aplicação React](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/App.jsx): `front/src/App.jsx`
- [Rotas protegidas](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/routes/index.jsx): `front/src/routes/index.jsx`
- [Contexto do usuário](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/routes/UserContext.jsx): `front/src/routes/UserContext.jsx`
- [Cliente HTTP](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/services/api.js): `front/src/services/api.js`

### Operação clínica

- [Cadastro de pacientes](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Paciente/Pacientes.jsx): `front/src/pages/Paciente/Pacientes.jsx`
- [Cadastro de exames](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Exames/Exames.jsx): `front/src/pages/Exames/Exames.jsx`
- [Agendar consulta](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Agendar_consulta/Agendar_consulta.jsx): `front/src/pages/Agendar_consulta/Agendar_consulta.jsx`
- [Consultas agendadas](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Consultas/Consultas.jsx): `front/src/pages/Consultas/Consultas.jsx`
- [Atendimento clínico](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Atendimento/Atendimento.jsx): `front/src/pages/Atendimento/Atendimento.jsx`
- [Financeiro do atendimento](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/AtendimentoFinanceiro/AtendimentoFinanceiro.jsx): `front/src/pages/AtendimentoFinanceiro/AtendimentoFinanceiro.jsx`
- [Dashboard diário](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Dashboard/Dashboard.jsx): `front/src/pages/Dashboard/Dashboard.jsx`
- [Gestão de médicos](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Medico/Medico.jsx): `front/src/pages/Medico/Medico.jsx`
- [Convênios e exames](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/ExameConvenio/ExameConvenio.jsx): `front/src/pages/ExameConvenio/ExameConvenio.jsx`

### Administração

- [Gestão de usuários](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Usuarios/Usuarios.jsx): `front/src/pages/Usuarios/Usuarios.jsx`
- [Perfil do usuário](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/myUser/myUser.jsx): `front/src/pages/myUser/myUser.jsx`
- [Logs de alterações](https://github.com/patrick-hoff/project-laboratorio/blob/main/front/src/pages/Log/Logs.jsx): `front/src/pages/Log/Logs.jsx`

### API e persistência

- [Servidor Express](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/index.js): `api/index.js`
- [Autenticação JWT](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/middlewares/auth.js): `api/middlewares/auth.js`
- [API de pacientes](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/pacientes.js): `api/controllers/pacientes.js`
- [API de exames](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/exames.js): `api/controllers/exames.js`
- [API de agendamentos](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/agendamento.js): `api/controllers/agendamento.js`
- [API de atendimentos](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/atendimentos.js): `api/controllers/atendimentos.js`
- [Exames do atendimento](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/exames_atendimento.js): `api/controllers/exames_atendimento.js`
- [API de pagamentos](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/pagamentos.js): `api/controllers/pagamentos.js`
- [API do dashboard](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/dashboard.js): `api/controllers/dashboard.js`
- [API de médicos](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/medicos.js): `api/controllers/medicos.js`
- [API de convênios](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/exames_convenio.js): `api/controllers/exames_convenio.js`
- [API de usuários](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/usuarios.js): `api/controllers/usuarios.js`
- [API de logs](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/controllers/log.js): `api/controllers/log.js`
- [MySQL](https://github.com/patrick-hoff/project-laboratorio/blob/main/api/db.js): `api/db.js`

### Other components

- **Equipe do laboratório**

## Connections

- Equipe do laboratório → Aplicação React: usa
- Aplicação React → Rotas protegidas: renderiza (evidence: `front/src/App.jsx`)
- Aplicação React → Contexto do usuário: envolve (evidence: `front/src/main.jsx`)
- Contexto do usuário → Cliente HTTP: consulta usuário (evidence: `front/src/routes/UserContext.jsx`)
- Cadastro de pacientes → Cliente HTTP: consulta API
- Cadastro de exames → Cliente HTTP: consulta API (evidence: `front/src/pages/Exames/Exames.jsx`)
- Agendar consulta → Cliente HTTP: consulta API (evidence: `front/src/pages/Agendar_consulta/Agendar_consulta.jsx`)
- Consultas agendadas → Cliente HTTP: consulta API (evidence: `front/src/pages/Consultas/Consultas.jsx`)
- Atendimento clínico → Cliente HTTP: consulta API (evidence: `front/src/pages/Atendimento/Atendimento.jsx`)
- Financeiro do atendimento → Cliente HTTP: consulta API
- Dashboard diário → Cliente HTTP: consulta API
- Gestão de médicos → Cliente HTTP: consulta API
- Convênios e exames → Cliente HTTP: consulta API (evidence: `front/src/pages/ExameConvenio/ExameConvenio.jsx`)
- Gestão de usuários → Cliente HTTP: consulta API (evidence: `front/src/pages/Usuarios/Usuarios.jsx`)
- Perfil do usuário → Cliente HTTP: consulta API
- Logs de alterações → Cliente HTTP: consulta API
- Cliente HTTP → Servidor Express: envia requisições
- Servidor Express → API de pacientes: monta rotas (evidence: `api/index.js`)
- Servidor Express → API de exames: monta rotas (evidence: `api/index.js`)
- Servidor Express → API de agendamentos: monta rotas (evidence: `api/index.js`)
- Servidor Express → API de atendimentos: monta rotas (evidence: `api/index.js`)
- Servidor Express → Exames do atendimento: monta rotas (evidence: `api/index.js`)
- Servidor Express → API de pagamentos: monta rotas (evidence: `api/index.js`)
- Servidor Express → API do dashboard: monta rotas (evidence: `api/index.js`)
- Servidor Express → API de médicos: monta rotas (evidence: `api/index.js`)
- Servidor Express → API de convênios: monta rotas (evidence: `api/index.js`)
- Servidor Express → API de usuários: monta rotas (evidence: `api/index.js`)
- Servidor Express → API de logs: monta rotas (evidence: `api/index.js`)
- API de pacientes → MySQL: consulta e grava (evidence: `api/controllers/pacientes.js`)
- API de exames → MySQL: consulta e grava (evidence: `api/controllers/exames.js`)
- API de agendamentos → MySQL: consulta e grava (evidence: `api/controllers/agendamento.js`)
- API de atendimentos → MySQL: consulta e grava (evidence: `api/controllers/atendimentos.js`)
- Exames do atendimento → MySQL: consulta e grava (evidence: `api/controllers/exames_atendimento.js`)
- API de pagamentos → MySQL: consulta e grava
- API do dashboard → MySQL: consulta
- API de médicos → MySQL: consulta e grava
- API de convênios → MySQL: consulta e grava
- API de usuários → MySQL: consulta e grava (evidence: `api/controllers/usuarios.js`)
- API de logs → MySQL: consulta
- API de pacientes → Autenticação JWT: usa identidade
- API de exames → Autenticação JWT: usa identidade (evidence: `api/routes/exames.js`)
- API de usuários → Autenticação JWT: protege rotas (evidence: `api/routes/usuarios.js`)
- API de logs → Autenticação JWT: protege rotas (evidence: `api/routes/log.js`)
- API de pacientes → API de logs: registra alterações
- API de exames → API de logs: registra alterações
