# pablohsgc/back-end-clinica architecture

> Architecture diagram of the GitHub repository pablohsgc/back-end-clinica, 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/pablohsgc/back-end-clinica
- Repository: https://github.com/pablohsgc/back-end-clinica

## Overview

This is a Portuguese clinic-management backend: an external client sends HTTP requests to an Express server, which dispatches routes for appointments, people, staff, doctors, addresses, and login; domain registration logic and database access produce responses. The README documents listing and registering patients, employees, and doctors, plus appointment listing, booking, and availability queries. Sampled route files show some handlers calling domain/database modules and JWT middleware; other links follow explicit imports in the source index. Several route and registration implementations were not excerpted, so their internal behavior is not expanded.

Main entry points: [`TP2-Typescript/src/server.ts`](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/server.ts) (Express server), [`TP2-Typescript/src/Routes/agendamentosRoute.ts`](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/agendamentosRoute.ts) (Appointment routes), [`TP2-Typescript/src/Models/CadastraMedico.ts`](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraMedico.ts) (Register doctor), [`TP2-Typescript/src/Models/CadastraFuncionario.ts`](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraFuncionario.ts) (Register employee)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["HTTP entry"]
  node_server["Express server<br/>[server.ts]"]
  node_login_routes["Login routes<br/>[loginRoute.ts]"]
end

subgraph group_appointments["Appointments"]
  node_appt_routes["Appointment routes"]
  node_appt_registration["Book consultation"]
  node_agenda_model["Appointment data<br/>[Agenda.ts]"]
  node_agenda_db["Appointment queries<br/>[AgendaBD.ts]"]
end

subgraph group_people["People and staff"]
  node_staff_routes["Employee routes"]
  node_staff_registration["Register employee"]
  node_staff_model["Employee model<br/>[Funcionario.ts]"]
  node_staff_db["Employee queries<br/>[FuncionarioBD.ts]"]
  node_doctor_routes["Doctor routes<br/>[medicosRoute.ts]"]
  node_doctor_registration["Register doctor<br/>[CadastraMedico.ts]"]
  node_doctor_model["Doctor model<br/>[Medico.ts]"]
  node_doctor_db["Doctor queries<br/>[MedicoBD.ts]"]
  node_patient_routes["Patient routes<br/>[pacientesRoute.ts]"]
  node_patient_registration["Register patient"]
  node_patient_model["Patient model<br/>[Paciente.ts]"]
  node_patient_db["Patient queries<br/>[PacienteBD.ts]"]
  node_person_registration["Register person<br/>[CadastraPessoa.ts]"]
  node_person_model["Person model<br/>[Pessoa.ts]"]
  node_person_db["Person queries<br/>[PessoaBD.ts]"]
  node_address_routes["Address routes<br/>[enderecosRoute.ts]"]
  node_address_registration["Register address"]
  node_address_model["Address model<br/>[Endereco.ts]"]
  node_address_db["Address queries<br/>[EnderecoBD.ts]"]
end

subgraph group_persistence["Persistence and auth"]
  node_jwt["JWT verification<br/>[verificaJWT.ts]"]
  node_db_pool["Postgres pool<br/>[db.ts]"]
  node_database[("Postgres database")]
end

node_client(("Frontend client"))

node_client -->|"sends HTTP requests"| node_server
node_server -->|"mounts routes"| node_appt_routes
node_server -->|"mounts routes"| node_staff_routes
node_server -->|"mounts routes"| node_doctor_routes
node_server -->|"mounts routes"| node_patient_routes
node_server -->|"mounts routes"| node_address_routes
node_server -->|"mounts routes"| node_login_routes
node_appt_routes -->|"calls registration"| node_appt_registration
node_appt_routes -->|"queries appointments"| node_agenda_db
node_appt_routes -->|"constructs appointment"| node_agenda_model
node_appt_registration -->|"registers booking"| node_agenda_db
node_agenda_db -->|"reads appointment fields"| node_agenda_model
node_staff_routes -->|"calls registration"| node_staff_registration
node_staff_routes -->|"queries employees"| node_staff_db
node_staff_registration -->|"builds employee"| node_staff_model
node_staff_registration -->|"registers person"| node_person_registration
node_staff_registration -->|"persists employee"| node_staff_db
node_staff_model -->|"extends person"| node_person_model
node_doctor_routes -->|"calls registration"| node_doctor_registration
node_doctor_routes -->|"queries doctors"| node_doctor_db
node_doctor_registration -->|"registers employee"| node_staff_registration
node_doctor_registration -->|"uses employee"| node_staff_model
node_doctor_registration -->|"builds doctor"| node_doctor_model
node_doctor_registration -->|"persists doctor"| node_doctor_db
node_doctor_model -->|"extends employee"| node_staff_model
node_patient_routes -->|"calls registration"| node_patient_registration
node_patient_routes -->|"queries patients"| node_patient_db
node_patient_registration -->|"registers person"| node_person_registration
node_patient_registration -->|"builds patient"| node_patient_model
node_patient_registration -->|"persists patient"| node_patient_db
node_patient_model -->|"extends person"| node_person_model
node_person_registration -->|"builds person"| node_person_model
node_person_registration -->|"persists person"| node_person_db
node_address_routes -->|"calls registration"| node_address_registration
node_address_routes -->|"queries addresses"| node_address_db
node_address_registration -->|"builds address"| node_address_model
node_address_registration -->|"persists address"| node_address_db
node_login_routes -->|"looks up employees"| node_staff_db
node_login_routes -->|"looks up doctors"| node_doctor_db
node_appt_routes -->|"guards requests"| node_jwt
node_staff_routes -->|"guards requests"| node_jwt
node_doctor_routes -->|"guards requests"| node_jwt
node_patient_routes -->|"guards requests"| node_jwt
node_agenda_db -->|"queries database"| node_db_pool
node_doctor_db -->|"queries database"| node_db_pool
node_staff_db -->|"queries database"| node_db_pool
node_address_db -->|"queries database"| node_db_pool
node_person_db -->|"queries database"| node_db_pool

click node_server "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/server.ts"
click node_appt_routes "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/agendamentosRoute.ts"
click node_appt_registration "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraConsulta.ts"
click node_agenda_model "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Agenda.ts"
click node_agenda_db "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/AgendaBD.ts"
click node_staff_routes "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/funcionariosRoute.ts"
click node_staff_registration "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraFuncionario.ts"
click node_staff_model "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Funcionario.ts"
click node_staff_db "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/FuncionarioBD.ts"
click node_doctor_routes "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/medicosRoute.ts"
click node_doctor_registration "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraMedico.ts"
click node_doctor_model "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Medico.ts"
click node_doctor_db "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/MedicoBD.ts"
click node_patient_routes "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/pacientesRoute.ts"
click node_patient_registration "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraPaciente.ts"
click node_patient_model "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Paciente.ts"
click node_patient_db "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/PacienteBD.ts"
click node_person_registration "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraPessoa.ts"
click node_person_model "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Pessoa.ts"
click node_person_db "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/PessoaBD.ts"
click node_address_routes "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/enderecosRoute.ts"
click node_address_registration "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraEndereco.ts"
click node_address_model "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Endereco.ts"
click node_address_db "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/EnderecoBD.ts"
click node_login_routes "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/loginRoute.ts"
click node_jwt "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/middleware/verificaJWT.ts"
click node_db_pool "https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/db.ts"

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_server,node_login_routes,node_client toneBlue
class node_appt_routes,node_appt_registration,node_agenda_model,node_agenda_db toneAmber
class node_staff_routes,node_staff_registration,node_staff_model,node_staff_db,node_doctor_routes,node_doctor_registration,node_doctor_model,node_doctor_db,node_patient_routes,node_patient_registration,node_patient_model,node_patient_db,node_person_registration,node_person_model,node_person_db,node_address_routes,node_address_registration,node_address_model,node_address_db toneMint
class node_jwt,node_db_pool,node_database toneRose
```

## Components

### HTTP entry

- [Express server](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/server.ts): `TP2-Typescript/src/server.ts`
- [Login routes](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/loginRoute.ts): `TP2-Typescript/src/Routes/loginRoute.ts`

### Appointments

- [Appointment routes](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/agendamentosRoute.ts): `TP2-Typescript/src/Routes/agendamentosRoute.ts`
- [Book consultation](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraConsulta.ts): `TP2-Typescript/src/Models/CadastraConsulta.ts`
- [Appointment data](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Agenda.ts): `TP2-Typescript/src/Models/Agenda.ts`
- [Appointment queries](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/AgendaBD.ts): `TP2-Typescript/src/Models/AgendaBD.ts`

### People and staff

- [Employee routes](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/funcionariosRoute.ts): `TP2-Typescript/src/Routes/funcionariosRoute.ts`
- [Register employee](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraFuncionario.ts): `TP2-Typescript/src/Models/CadastraFuncionario.ts`
- [Employee model](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Funcionario.ts): `TP2-Typescript/src/Models/Funcionario.ts`
- [Employee queries](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/FuncionarioBD.ts): `TP2-Typescript/src/Models/FuncionarioBD.ts`
- [Doctor routes](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/medicosRoute.ts): `TP2-Typescript/src/Routes/medicosRoute.ts`
- [Register doctor](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraMedico.ts): `TP2-Typescript/src/Models/CadastraMedico.ts`
- [Doctor model](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Medico.ts): `TP2-Typescript/src/Models/Medico.ts`
- [Doctor queries](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/MedicoBD.ts): `TP2-Typescript/src/Models/MedicoBD.ts`
- [Patient routes](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/pacientesRoute.ts): `TP2-Typescript/src/Routes/pacientesRoute.ts`
- [Register patient](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraPaciente.ts): `TP2-Typescript/src/Models/CadastraPaciente.ts`
- [Patient model](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Paciente.ts): `TP2-Typescript/src/Models/Paciente.ts`
- [Patient queries](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/PacienteBD.ts): `TP2-Typescript/src/Models/PacienteBD.ts`
- [Register person](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraPessoa.ts): `TP2-Typescript/src/Models/CadastraPessoa.ts`
- [Person model](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Pessoa.ts): `TP2-Typescript/src/Models/Pessoa.ts`
- [Person queries](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/PessoaBD.ts): `TP2-Typescript/src/Models/PessoaBD.ts`
- [Address routes](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Routes/enderecosRoute.ts): `TP2-Typescript/src/Routes/enderecosRoute.ts`
- [Register address](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/CadastraEndereco.ts): `TP2-Typescript/src/Models/CadastraEndereco.ts`
- [Address model](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/Endereco.ts): `TP2-Typescript/src/Models/Endereco.ts`
- [Address queries](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/Models/EnderecoBD.ts): `TP2-Typescript/src/Models/EnderecoBD.ts`

### Persistence and auth

- [JWT verification](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/middleware/verificaJWT.ts): `TP2-Typescript/src/middleware/verificaJWT.ts`
- [Postgres pool](https://github.com/pablohsgc/back-end-clinica/blob/main/TP2-Typescript/src/db.ts): `TP2-Typescript/src/db.ts`
- **Postgres database**

### Other components

- **Frontend client**

## Connections

- Frontend client → Express server: sends HTTP requests (evidence: `README.md`)
- Express server → Appointment routes: mounts routes (evidence: `TP2-Typescript/src/server.ts`)
- Express server → Employee routes: mounts routes (evidence: `TP2-Typescript/src/server.ts`)
- Express server → Doctor routes: mounts routes (evidence: `TP2-Typescript/src/server.ts`)
- Express server → Patient routes: mounts routes (evidence: `TP2-Typescript/src/server.ts`)
- Express server → Address routes: mounts routes (evidence: `TP2-Typescript/src/server.ts`)
- Express server → Login routes: mounts routes (evidence: `TP2-Typescript/src/server.ts`)
- Appointment routes → Book consultation: calls registration (evidence: `TP2-Typescript/src/Routes/agendamentosRoute.ts`)
- Appointment routes → Appointment queries: queries appointments (evidence: `TP2-Typescript/src/Routes/agendamentosRoute.ts`)
- Appointment routes → Appointment data: constructs appointment (evidence: `TP2-Typescript/src/Routes/agendamentosRoute.ts`)
- Book consultation → Appointment queries: registers booking (evidence: `TP2-Typescript/src/Models/CadastraConsulta.ts`)
- Appointment queries → Appointment data: reads appointment fields (evidence: `TP2-Typescript/src/Models/AgendaBD.ts`)
- Employee routes → Register employee: calls registration (evidence: `TP2-Typescript/src/Routes/funcionariosRoute.ts`)
- Employee routes → Employee queries: queries employees (evidence: `TP2-Typescript/src/Routes/funcionariosRoute.ts`)
- Register employee → Employee model: builds employee (evidence: `TP2-Typescript/src/Models/CadastraFuncionario.ts`)
- Register employee → Register person: registers person (evidence: `TP2-Typescript/src/Models/CadastraFuncionario.ts`)
- Register employee → Employee queries: persists employee (evidence: `TP2-Typescript/src/Models/CadastraFuncionario.ts`)
- Employee model → Person model: extends person (evidence: `TP2-Typescript/src/Models/Funcionario.ts`)
- Doctor routes → Register doctor: calls registration (evidence: `TP2-Typescript/src/Routes/medicosRoute.ts`)
- Doctor routes → Doctor queries: queries doctors (evidence: `TP2-Typescript/src/Routes/medicosRoute.ts`)
- Register doctor → Register employee: registers employee (evidence: `TP2-Typescript/src/Models/CadastraMedico.ts`)
- Register doctor → Employee model: uses employee (evidence: `TP2-Typescript/src/Models/CadastraMedico.ts`)
- Register doctor → Doctor model: builds doctor (evidence: `TP2-Typescript/src/Models/CadastraMedico.ts`)
- Register doctor → Doctor queries: persists doctor (evidence: `TP2-Typescript/src/Models/CadastraMedico.ts`)
- Doctor model → Employee model: extends employee (evidence: `TP2-Typescript/src/Models/Medico.ts`)
- Patient routes → Register patient: calls registration (evidence: `TP2-Typescript/src/Routes/pacientesRoute.ts`)
- Patient routes → Patient queries: queries patients (evidence: `TP2-Typescript/src/Routes/pacientesRoute.ts`)
- Register patient → Register person: registers person (evidence: `TP2-Typescript/src/Models/CadastraPaciente.ts`)
- Register patient → Patient model: builds patient (evidence: `TP2-Typescript/src/Models/CadastraPaciente.ts`)
- Register patient → Patient queries: persists patient (evidence: `TP2-Typescript/src/Models/CadastraPaciente.ts`)
- Patient model → Person model: extends person (evidence: `TP2-Typescript/src/Models/Paciente.ts`)
- Register person → Person model: builds person (evidence: `TP2-Typescript/src/Models/CadastraPessoa.ts`)
- Register person → Person queries: persists person (evidence: `TP2-Typescript/src/Models/CadastraPessoa.ts`)
- Address routes → Register address: calls registration (evidence: `TP2-Typescript/src/Routes/enderecosRoute.ts`)
- Address routes → Address queries: queries addresses (evidence: `TP2-Typescript/src/Routes/enderecosRoute.ts`)
- Register address → Address model: builds address (evidence: `TP2-Typescript/src/Models/CadastraEndereco.ts`)
- Register address → Address queries: persists address (evidence: `TP2-Typescript/src/Models/CadastraEndereco.ts`)
- Login routes → Employee queries: looks up employees (evidence: `TP2-Typescript/src/Routes/loginRoute.ts`)
- Login routes → Doctor queries: looks up doctors (evidence: `TP2-Typescript/src/Routes/loginRoute.ts`)
- Appointment routes → JWT verification: guards requests (evidence: `TP2-Typescript/src/Routes/agendamentosRoute.ts`)
- Employee routes → JWT verification: guards requests (evidence: `TP2-Typescript/src/Routes/funcionariosRoute.ts`)
- Doctor routes → JWT verification: guards requests (evidence: `TP2-Typescript/src/Routes/medicosRoute.ts`)
- Patient routes → JWT verification: guards requests (evidence: `TP2-Typescript/src/Routes/pacientesRoute.ts`)
- Appointment queries → Postgres pool: queries database (evidence: `TP2-Typescript/src/Models/AgendaBD.ts`)
- Doctor queries → Postgres pool: queries database (evidence: `TP2-Typescript/src/Models/MedicoBD.ts`)
- Employee queries → Postgres pool: queries database (evidence: `TP2-Typescript/src/Models/FuncionarioBD.ts`)
- Address queries → Postgres pool: queries database (evidence: `TP2-Typescript/src/Models/EnderecoBD.ts`)
- Person queries → Postgres pool: queries database (evidence: `TP2-Typescript/src/Models/PessoaBD.ts`)
