# orangethewell/site-de-empregos architecture

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

- Interactive diagram: https://gitdiagram.com/orangethewell/site-de-empregos
- Repository: https://github.com/orangethewell/site-de-empregos

## Overview

This is a Leptos web application for Araxá job listings, with account registration and login, email confirmation, profiles, and role-gated administration. The principal workflow routes visitors to job listings and details; authenticated users can manage profiles, while authorized editors manage jobs and user roles. Server functions provide the pages’ data and mutations, backed by SeaORM entities and services for email and payment links. The README describes a generic Leptos starter template, so product capabilities here are taken from the source tree and excerpts. Relationships involving unsampled pages are limited to documented routes and module references.

Main entry points: [`src/functions/mod.rs`](https://github.com/orangethewell/site-de-empregos/blob/main/src/functions/mod.rs) (Server functions), [`src/app.rs`](https://github.com/orangethewell/site-de-empregos/blob/main/src/app.rs) (Router and app shell), [`src/components/navbar.rs`](https://github.com/orangethewell/site-de-empregos/blob/main/src/components/navbar.rs) (Navigation), [`src/pages/homepage.rs`](https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/homepage.rs) (Homepage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_app["Router and app shell<br/>[app.rs]"]
  node_navigation["Navigation<br/>[navbar.rs]"]
  node_home["Homepage<br/>[homepage.rs]"]
end

subgraph group_account["Accounts and access"]
  node_login["Login<br/>[login.rs]"]
  node_registration["Registration<br/>[register.rs]"]
  node_email_confirmation["Email confirmation<br/>[mail_confirm.rs]"]
  node_profile["User profile<br/>[profile.rs]"]
  node_user_editor["User administration<br/>[users.rs]"]
end

subgraph group_jobs["Job listings"]
  node_job_list["Job listings<br/>[jobspage.rs]"]
  node_job_detail["Job details<br/>[jobinfo.rs]"]
  node_job_editor["Job editor<br/>[jobs.rs]"]
end

subgraph group_server["Server services"]
  node_server_functions["Server functions<br/>[mod.rs]"]
  node_payment_link["Payment link helper<br/>[embed.rs]"]
  node_mailer["Email service"]
end

subgraph group_data["Persistence"]
  node_sql[("SQL database")]
  node_jobs_entity["Job records<br/>[job.rs]"]
  node_users_entity["User records<br/>[user.rs]"]
  node_confirmation_entity["Confirmation requests"]
  node_membership_entity["Memberships<br/>[membership.rs]"]
  node_roles_entity["Roles<br/>[role.rs]"]
  node_permissions_entity["Permissions<br/>[permission.rs]"]
  node_user_roles_entity["User-role links<br/>[user_roles.rs]"]
  node_role_permissions_entity["Role permissions"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_app
node_app -->|"renders"| node_navigation
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_job_list
node_app -->|"routes to"| node_job_detail
node_app -->|"routes to"| node_job_editor
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_registration
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_email_confirmation
node_job_list -->|"calls"| node_server_functions
node_job_detail -->|"calls"| node_server_functions
node_job_editor -->|"calls"| node_server_functions
node_profile -->|"calls"| node_server_functions
node_home -->|"uses"| node_server_functions
node_email_confirmation -->|"calls"| node_server_functions
node_navigation -->|"checks login"| node_server_functions
node_server_functions -->|"reads and writes"| node_sql
node_server_functions -->|"generates payment link"| node_payment_link
node_server_functions -->|"sends email"| node_mailer
node_jobs_entity -.->|"models records"| node_sql
node_users_entity -.->|"models records"| node_sql
node_confirmation_entity -.->|"models records"| node_sql
node_membership_entity -.->|"models records"| node_sql
node_roles_entity -.->|"models records"| node_sql
node_permissions_entity -.->|"models records"| node_sql
node_user_roles_entity -.->|"models links"| node_sql
node_role_permissions_entity -.->|"models links"| node_sql
node_server_functions -.->|"uses"| node_jobs_entity
node_server_functions -.->|"uses"| node_users_entity
node_server_functions -.->|"uses"| node_confirmation_entity
node_server_functions -.->|"uses"| node_membership_entity
node_server_functions -.->|"uses"| node_roles_entity
node_server_functions -.->|"uses"| node_permissions_entity
node_server_functions -.->|"uses"| node_user_roles_entity
node_server_functions -.->|"uses"| node_role_permissions_entity

click node_app "https://github.com/orangethewell/site-de-empregos/blob/main/src/app.rs"
click node_navigation "https://github.com/orangethewell/site-de-empregos/blob/main/src/components/navbar.rs"
click node_home "https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/homepage.rs"
click node_job_list "https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/jobspage.rs"
click node_job_detail "https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/jobinfo.rs"
click node_job_editor "https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/editors/jobs.rs"
click node_login "https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/handlers/login.rs"
click node_registration "https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/handlers/register.rs"
click node_email_confirmation "https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/handlers/mail_confirm.rs"
click node_profile "https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/profile.rs"
click node_user_editor "https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/editors/users.rs"
click node_server_functions "https://github.com/orangethewell/site-de-empregos/blob/main/src/functions/mod.rs"
click node_payment_link "https://github.com/orangethewell/site-de-empregos/blob/main/src/functions/embed.rs"
click node_jobs_entity "https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/job.rs"
click node_users_entity "https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/user.rs"
click node_confirmation_entity "https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/confirmation_request.rs"
click node_membership_entity "https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/membership.rs"
click node_roles_entity "https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/role.rs"
click node_permissions_entity "https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/permission.rs"
click node_user_roles_entity "https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/user_roles.rs"
click node_role_permissions_entity "https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/role_permissions.rs"

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_navigation,node_home toneBlue
class node_login,node_registration,node_email_confirmation,node_profile,node_user_editor toneAmber
class node_job_list,node_job_detail,node_job_editor toneMint
class node_server_functions,node_payment_link,node_mailer toneRose
class node_sql,node_jobs_entity,node_users_entity,node_confirmation_entity,node_membership_entity,node_roles_entity,node_permissions_entity,node_user_roles_entity,node_role_permissions_entity,node_visitor toneIndigo
```

## Components

### Web interface

- [Router and app shell](https://github.com/orangethewell/site-de-empregos/blob/main/src/app.rs): `src/app.rs`
- [Navigation](https://github.com/orangethewell/site-de-empregos/blob/main/src/components/navbar.rs): `src/components/navbar.rs`
- [Homepage](https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/homepage.rs): `src/pages/homepage.rs`

### Accounts and access

- [Login](https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/handlers/login.rs): `src/pages/handlers/login.rs`
- [Registration](https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/handlers/register.rs): `src/pages/handlers/register.rs`
- [Email confirmation](https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/handlers/mail_confirm.rs): `src/pages/handlers/mail_confirm.rs`
- [User profile](https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/profile.rs): `src/pages/profile.rs`
- [User administration](https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/editors/users.rs): `src/pages/editors/users.rs`

### Job listings

- [Job listings](https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/jobspage.rs): `src/pages/jobspage.rs`
- [Job details](https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/jobinfo.rs): `src/pages/jobinfo.rs`
- [Job editor](https://github.com/orangethewell/site-de-empregos/blob/main/src/pages/editors/jobs.rs): `src/pages/editors/jobs.rs`

### Server services

- [Server functions](https://github.com/orangethewell/site-de-empregos/blob/main/src/functions/mod.rs): `src/functions/mod.rs`
- [Payment link helper](https://github.com/orangethewell/site-de-empregos/blob/main/src/functions/embed.rs): `src/functions/embed.rs`
- **Email service**

### Persistence

- **SQL database**
- [Job records](https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/job.rs): `entities/src/job.rs`
- [User records](https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/user.rs): `entities/src/user.rs`
- [Confirmation requests](https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/confirmation_request.rs): `entities/src/confirmation_request.rs`
- [Memberships](https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/membership.rs): `entities/src/membership.rs`
- [Roles](https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/role.rs): `entities/src/role.rs`
- [Permissions](https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/permission.rs): `entities/src/permission.rs`
- [User-role links](https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/user_roles.rs): `entities/src/user_roles.rs`
- [Role permissions](https://github.com/orangethewell/site-de-empregos/blob/main/entities/src/role_permissions.rs): `entities/src/role_permissions.rs`

### Other components

- **Visitor**

## Connections

- Visitor → Router and app shell: opens (evidence: `src/app.rs`)
- Router and app shell → Navigation: renders (evidence: `src/app.rs`)
- Router and app shell → Homepage: routes to (evidence: `src/app.rs`)
- Router and app shell → Job listings: routes to (evidence: `src/app.rs`)
- Router and app shell → Job details: routes to (evidence: `src/app.rs`)
- Router and app shell → Job editor: routes to (evidence: `src/app.rs`)
- Router and app shell → Login: routes to (evidence: `src/app.rs`)
- Router and app shell → Registration: routes to (evidence: `src/app.rs`)
- Router and app shell → User profile: routes to (evidence: `src/app.rs`)
- Router and app shell → Email confirmation: routes to (evidence: `src/app.rs`)
- Job listings → Server functions: calls (evidence: `src/pages/jobspage.rs`)
- Job details → Server functions: calls (evidence: `src/pages/jobinfo.rs`)
- Job editor → Server functions: calls (evidence: `src/pages/editors/jobs.rs`)
- User profile → Server functions: calls (evidence: `src/pages/profile.rs`)
- Homepage → Server functions: uses (evidence: `src/pages/homepage.rs`)
- Email confirmation → Server functions: calls (evidence: `src/pages/handlers/mail_confirm.rs`)
- Navigation → Server functions: checks login (evidence: `src/components/navbar.rs`)
- Server functions → SQL database: reads and writes (evidence: `src/functions/mod.rs`)
- Server functions → Payment link helper: generates payment link (evidence: `src/functions/mod.rs`)
- Server functions → Email service: sends email (evidence: `src/functions/mod.rs`)
- Job records → SQL database: models records
- User records → SQL database: models records
- Confirmation requests → SQL database: models records
- Memberships → SQL database: models records
- Roles → SQL database: models records
- Permissions → SQL database: models records
- User-role links → SQL database: models links
- Role permissions → SQL database: models links
- Server functions → Job records: uses
- Server functions → User records: uses
- Server functions → Confirmation requests: uses
- Server functions → Memberships: uses
- Server functions → Roles: uses
- Server functions → Permissions: uses
- Server functions → User-role links: uses
- Server functions → Role permissions: uses
