# joalissonassis/treinamentos architecture

> Architecture diagram of the GitHub repository joalissonassis/treinamentos, 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/joalissonassis/treinamentos
- Repository: https://github.com/joalissonassis/treinamentos

## Overview

This appears to be an internal training and knowledge portal: users log in, browse sector-specific manuals, and interact with training content; administrators and editors manage users, sectors, and manuals. The graph includes the evidenced route-to-model relationships, shared database layer, permission checks, and upload/HTML-sanitization support. The README is empty, and several routes and capabilities are unsampled, so their internal behavior is not expanded beyond relationships listed in the source index.

Main entry points: [`server.js`](https://github.com/joalissonassis/treinamentos/blob/main/server.js) (Express app), [`src/middlewares/permissoes.js`](https://github.com/joalissonassis/treinamentos/blob/main/src/middlewares/permissoes.js) (Permission checks), [`src/config/db.js`](https://github.com/joalissonassis/treinamentos/blob/main/src/config/db.js) (MariaDB), [`src/models/usuarios.js`](https://github.com/joalissonassis/treinamentos/blob/main/src/models/usuarios.js) (User records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and routing"]
  node_server["Express app<br/>[server.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_permissions["Permission checks<br/>[permissoes.js]"]
  node_sector_routes["Sector browsing<br/>[setores.js]"]
  node_account["Account settings<br/>[conta.js]"]
end

subgraph group_learning["Training content"]
  node_training_routes["Training access<br/>[treinamentos.js]"]
  node_manuals["Manual management<br/>[gerenciar.js]"]
  node_training_model["Training records<br/>[treinamentos.js]"]
  node_files_route["Protected files<br/>[arquivos.js]"]
  node_file_model["File records<br/>[arquivos.js]"]
end

subgraph group_community["Communication"]
  node_mural_routes["Company noticeboard<br/>[mural.js]"]
  node_mural_model["Noticeboard data<br/>[mural.js]"]
  node_recado_routes["Private messages<br/>[recados.js]"]
  node_recado_model["Message records<br/>[recados.js]"]
end

subgraph group_admin["Administration"]
  node_admin_routes["Admin console<br/>[admin.js]"]
  node_user_model["User records<br/>[usuarios.js]"]
  node_sector_model["Sector records<br/>[setores.js]"]
  node_suggestion_model["Suggestions<br/>[sugestoes.js]"]
end

subgraph group_infrastructure["Shared infrastructure"]
  node_upload["Upload validation<br/>[upload.js]"]
  node_sanitizer["HTML sanitization<br/>[sanitizar.js]"]
  node_database[("MariaDB<br/>[db.js]")]
end

node_visitor(("Portal user"))

node_visitor -->|"uses portal"| node_server
node_server -->|"mounts routes"| node_auth
node_server -->|"mounts routes"| node_sector_routes
node_server -->|"mounts routes"| node_account
node_server -->|"mounts routes"| node_training_routes
node_server -->|"mounts routes"| node_recado_routes
node_server -->|"mounts routes"| node_mural_routes
node_server -->|"mounts routes"| node_files_route
node_server -->|"mounts routes"| node_admin_routes
node_server -->|"mounts routes"| node_manuals
node_auth -->|"looks up users"| node_user_model
node_account -->|"updates account"| node_user_model
node_training_routes -->|"loads training"| node_training_model
node_training_routes -->|"loads attachments"| node_file_model
node_training_routes -->|"loads user data"| node_user_model
node_manuals -->|"manages manuals"| node_training_model
node_manuals -->|"manages attachments"| node_file_model
node_manuals -->|"cleans content"| node_sanitizer
node_manuals -->|"accepts uploads"| node_upload
node_files_route -->|"serves files"| node_file_model
node_mural_routes -->|"manages posts"| node_mural_model
node_recado_routes -->|"manages messages"| node_recado_model
node_recado_routes -->|"uses noticeboard data"| node_mural_model
node_admin_routes -->|"manages sectors"| node_sector_model
node_admin_routes -->|"manages users"| node_user_model
node_admin_routes -->|"reports training"| node_training_model
node_admin_routes -->|"handles suggestions"| node_suggestion_model
node_permissions -->|"loads identity"| node_user_model
node_permissions -->|"checks sector access"| node_sector_model
node_permissions -->|"counts pending"| node_suggestion_model
node_permissions -->|"counts unread"| node_recado_model
node_permissions -->|"counts new posts"| node_mural_model
node_permissions -->|"finds new manuals"| node_training_model
node_training_model -->|"queries records"| node_database
node_file_model -->|"queries records"| node_database
node_user_model -->|"queries records"| node_database
node_sector_model -->|"queries records"| node_database
node_mural_model -->|"queries posts"| node_database
node_recado_model -->|"queries messages"| node_database
node_suggestion_model -->|"queries records"| node_database

click node_server "https://github.com/joalissonassis/treinamentos/blob/main/server.js"
click node_auth "https://github.com/joalissonassis/treinamentos/blob/main/src/routes/auth.js"
click node_permissions "https://github.com/joalissonassis/treinamentos/blob/main/src/middlewares/permissoes.js"
click node_sector_routes "https://github.com/joalissonassis/treinamentos/blob/main/src/routes/setores.js"
click node_account "https://github.com/joalissonassis/treinamentos/blob/main/src/routes/conta.js"
click node_training_routes "https://github.com/joalissonassis/treinamentos/blob/main/src/routes/treinamentos.js"
click node_manuals "https://github.com/joalissonassis/treinamentos/blob/main/src/routes/gerenciar.js"
click node_training_model "https://github.com/joalissonassis/treinamentos/blob/main/src/models/treinamentos.js"
click node_files_route "https://github.com/joalissonassis/treinamentos/blob/main/src/routes/arquivos.js"
click node_file_model "https://github.com/joalissonassis/treinamentos/blob/main/src/models/arquivos.js"
click node_upload "https://github.com/joalissonassis/treinamentos/blob/main/src/config/upload.js"
click node_sanitizer "https://github.com/joalissonassis/treinamentos/blob/main/src/config/sanitizar.js"
click node_mural_routes "https://github.com/joalissonassis/treinamentos/blob/main/src/routes/mural.js"
click node_mural_model "https://github.com/joalissonassis/treinamentos/blob/main/src/models/mural.js"
click node_recado_routes "https://github.com/joalissonassis/treinamentos/blob/main/src/routes/recados.js"
click node_recado_model "https://github.com/joalissonassis/treinamentos/blob/main/src/models/recados.js"
click node_admin_routes "https://github.com/joalissonassis/treinamentos/blob/main/src/routes/admin.js"
click node_user_model "https://github.com/joalissonassis/treinamentos/blob/main/src/models/usuarios.js"
click node_sector_model "https://github.com/joalissonassis/treinamentos/blob/main/src/models/setores.js"
click node_suggestion_model "https://github.com/joalissonassis/treinamentos/blob/main/src/models/sugestoes.js"
click node_database "https://github.com/joalissonassis/treinamentos/blob/main/src/config/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_server,node_auth,node_permissions,node_sector_routes,node_account,node_visitor toneBlue
class node_training_routes,node_manuals,node_training_model,node_files_route,node_file_model toneAmber
class node_mural_routes,node_mural_model,node_recado_routes,node_recado_model toneMint
class node_admin_routes,node_user_model,node_sector_model,node_suggestion_model toneRose
class node_upload,node_sanitizer,node_database toneIndigo
```

## Components

### Access and routing

- [Express app](https://github.com/joalissonassis/treinamentos/blob/main/server.js): `server.js`
- [Authentication](https://github.com/joalissonassis/treinamentos/blob/main/src/routes/auth.js): `src/routes/auth.js`
- [Permission checks](https://github.com/joalissonassis/treinamentos/blob/main/src/middlewares/permissoes.js): `src/middlewares/permissoes.js`
- [Sector browsing](https://github.com/joalissonassis/treinamentos/blob/main/src/routes/setores.js): `src/routes/setores.js`
- [Account settings](https://github.com/joalissonassis/treinamentos/blob/main/src/routes/conta.js): `src/routes/conta.js`

### Training content

- [Training access](https://github.com/joalissonassis/treinamentos/blob/main/src/routes/treinamentos.js): `src/routes/treinamentos.js`
- [Manual management](https://github.com/joalissonassis/treinamentos/blob/main/src/routes/gerenciar.js): `src/routes/gerenciar.js`
- [Training records](https://github.com/joalissonassis/treinamentos/blob/main/src/models/treinamentos.js): `src/models/treinamentos.js`
- [Protected files](https://github.com/joalissonassis/treinamentos/blob/main/src/routes/arquivos.js): `src/routes/arquivos.js`
- [File records](https://github.com/joalissonassis/treinamentos/blob/main/src/models/arquivos.js): `src/models/arquivos.js`

### Communication

- [Company noticeboard](https://github.com/joalissonassis/treinamentos/blob/main/src/routes/mural.js): `src/routes/mural.js`
- [Noticeboard data](https://github.com/joalissonassis/treinamentos/blob/main/src/models/mural.js): `src/models/mural.js`
- [Private messages](https://github.com/joalissonassis/treinamentos/blob/main/src/routes/recados.js): `src/routes/recados.js`
- [Message records](https://github.com/joalissonassis/treinamentos/blob/main/src/models/recados.js): `src/models/recados.js`

### Administration

- [Admin console](https://github.com/joalissonassis/treinamentos/blob/main/src/routes/admin.js): `src/routes/admin.js`
- [User records](https://github.com/joalissonassis/treinamentos/blob/main/src/models/usuarios.js): `src/models/usuarios.js`
- [Sector records](https://github.com/joalissonassis/treinamentos/blob/main/src/models/setores.js): `src/models/setores.js`
- [Suggestions](https://github.com/joalissonassis/treinamentos/blob/main/src/models/sugestoes.js): `src/models/sugestoes.js`

### Shared infrastructure

- [Upload validation](https://github.com/joalissonassis/treinamentos/blob/main/src/config/upload.js): `src/config/upload.js`
- [HTML sanitization](https://github.com/joalissonassis/treinamentos/blob/main/src/config/sanitizar.js): `src/config/sanitizar.js`
- [MariaDB](https://github.com/joalissonassis/treinamentos/blob/main/src/config/db.js): `src/config/db.js`

### Other components

- **Portal user**

## Connections

- Portal user → Express app: uses portal
- Express app → Authentication: mounts routes (evidence: `server.js`)
- Express app → Sector browsing: mounts routes (evidence: `server.js`)
- Express app → Account settings: mounts routes (evidence: `server.js`)
- Express app → Training access: mounts routes (evidence: `server.js`)
- Express app → Private messages: mounts routes (evidence: `server.js`)
- Express app → Company noticeboard: mounts routes (evidence: `server.js`)
- Express app → Protected files: mounts routes (evidence: `server.js`)
- Express app → Admin console: mounts routes (evidence: `server.js`)
- Express app → Manual management: mounts routes (evidence: `server.js`)
- Authentication → User records: looks up users (evidence: `src/routes/auth.js`)
- Account settings → User records: updates account (evidence: `src/routes/conta.js`)
- Training access → Training records: loads training (evidence: `src/routes/treinamentos.js`)
- Training access → File records: loads attachments (evidence: `src/routes/treinamentos.js`)
- Training access → User records: loads user data (evidence: `src/routes/treinamentos.js`)
- Manual management → Training records: manages manuals (evidence: `src/routes/gerenciar.js`)
- Manual management → File records: manages attachments (evidence: `src/routes/gerenciar.js`)
- Manual management → HTML sanitization: cleans content (evidence: `src/routes/gerenciar.js`)
- Manual management → Upload validation: accepts uploads (evidence: `src/routes/gerenciar.js`)
- Protected files → File records: serves files
- Company noticeboard → Noticeboard data: manages posts (evidence: `src/routes/mural.js`)
- Private messages → Message records: manages messages (evidence: `src/routes/recados.js`)
- Private messages → Noticeboard data: uses noticeboard data (evidence: `src/routes/recados.js`)
- Admin console → Sector records: manages sectors (evidence: `src/routes/admin.js`)
- Admin console → User records: manages users (evidence: `src/routes/admin.js`)
- Admin console → Training records: reports training (evidence: `src/routes/admin.js`)
- Admin console → Suggestions: handles suggestions (evidence: `src/routes/admin.js`)
- Permission checks → User records: loads identity (evidence: `src/middlewares/permissoes.js`)
- Permission checks → Sector records: checks sector access (evidence: `src/middlewares/permissoes.js`)
- Permission checks → Suggestions: counts pending (evidence: `src/middlewares/permissoes.js`)
- Permission checks → Message records: counts unread (evidence: `src/middlewares/permissoes.js`)
- Permission checks → Noticeboard data: counts new posts (evidence: `src/middlewares/permissoes.js`)
- Permission checks → Training records: finds new manuals (evidence: `src/middlewares/permissoes.js`)
- Training records → MariaDB: queries records (evidence: `src/models/treinamentos.js`)
- File records → MariaDB: queries records (evidence: `src/models/arquivos.js`)
- User records → MariaDB: queries records (evidence: `src/models/usuarios.js`)
- Sector records → MariaDB: queries records (evidence: `src/models/setores.js`)
- Noticeboard data → MariaDB: queries posts (evidence: `src/models/mural.js`)
- Message records → MariaDB: queries messages (evidence: `src/models/recados.js`)
- Suggestions → MariaDB: queries records (evidence: `src/models/sugestoes.js`)
