# gabri1103/cral architecture

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

- Interactive diagram: https://gitdiagram.com/gabri1103/cral
- Repository: https://github.com/gabri1103/cral

## Overview

CRAL is a Sails application for member access and administration of events, reservations, messages, travel listings, and partner discounts. The principal workflow routes a browser request to a Sails action, which reads or updates domain records and returns a page or response; member login/profile and event signup are distinct parts of that workflow. Controller excerpts show selected model operations and file/email helper calls, while the route table documents request dispatch. Other controller-to-model relationships are left out where the excerpts do not establish them.

Main entry points: [`config/routes.js`](https://github.com/gabri1103/cral/blob/main/config/routes.js) (HTTP routes), [`api/controllers/EventoController.js`](https://github.com/gabri1103/cral/blob/main/api/controllers/EventoController.js) (Event management), [`api/controllers/ConvenzioneController.js`](https://github.com/gabri1103/cral/blob/main/api/controllers/ConvenzioneController.js) (Discount listings), [`api/helpers`](https://github.com/gabri1103/cral/tree/main/api/helpers) (Uploads and email)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and access"]
  node_routes["HTTP routes<br/>[routes.js]"]
  node_members["Member access and profiles<br/>[SocioController.js]"]
  node_policies["Access policies"]
end

subgraph group_events["Events and bookings"]
  node_events_controller["Event management"]
  node_bookings_controller["Reservations and attendees"]
end

subgraph group_content["Member content"]
  node_messages_controller["Announcements"]
  node_discounts_controller["Discount listings"]
  node_categories_controller["Discount categories"]
  node_trips_controller["Travel listings"]
end

subgraph group_persistence["Domain records"]
  node_member_records[("Member records<br/>[Socio.js]")]
  node_event_records[("Event records<br/>[Evento.js]")]
  node_booking_records[("Reservation records<br/>[Prenotazione.js]")]
  node_message_records[("Message records<br/>[Messaggio.js]")]
  node_discount_records[("Discount records<br/>[Convenzione.js]")]
  node_category_records[("Category records")]
end

subgraph group_support["Application support"]
  node_supporting_helpers["Uploads and email"]
  node_sails_app["Sails runtime<br/>[app.js]"]
end

node_visitor(("Member or admin"))

node_visitor -->|"sends request"| node_routes
node_routes -->|"dispatches to"| node_members
node_routes -->|"dispatches to"| node_events_controller
node_routes -->|"dispatches to"| node_bookings_controller
node_routes -->|"dispatches to"| node_messages_controller
node_routes -->|"dispatches to"| node_discounts_controller
node_routes -->|"dispatches to"| node_categories_controller
node_routes -->|"dispatches to"| node_trips_controller
node_members -->|"queries and updates"| node_member_records
node_events_controller -->|"queries and updates"| node_event_records
node_events_controller -->|"counts reservations"| node_booking_records
node_messages_controller -->|"queries and updates"| node_message_records
node_discounts_controller -->|"queries and updates"| node_discount_records
node_discounts_controller -->|"loads categories"| node_category_records
node_events_controller -->|"uploads files"| node_supporting_helpers
node_messages_controller -->|"uploads files"| node_supporting_helpers
node_discounts_controller -->|"uploads files"| node_supporting_helpers
node_members -->|"sends email"| node_supporting_helpers
node_sails_app -.->|"serves application"| node_routes
node_policies -.->|"guards requests"| node_routes

click node_routes "https://github.com/gabri1103/cral/blob/main/config/routes.js"
click node_members "https://github.com/gabri1103/cral/blob/main/api/controllers/SocioController.js"
click node_policies "https://github.com/gabri1103/cral/tree/main/api/policies"
click node_events_controller "https://github.com/gabri1103/cral/blob/main/api/controllers/EventoController.js"
click node_bookings_controller "https://github.com/gabri1103/cral/blob/main/api/controllers/PrenotazioneController.js"
click node_messages_controller "https://github.com/gabri1103/cral/blob/main/api/controllers/MessaggioController.js"
click node_discounts_controller "https://github.com/gabri1103/cral/blob/main/api/controllers/ConvenzioneController.js"
click node_categories_controller "https://github.com/gabri1103/cral/blob/main/api/controllers/CategoriaConvenzioneController.js"
click node_trips_controller "https://github.com/gabri1103/cral/blob/main/api/controllers/ViaggioController.js"
click node_member_records "https://github.com/gabri1103/cral/blob/main/api/models/Socio.js"
click node_event_records "https://github.com/gabri1103/cral/blob/main/api/models/Evento.js"
click node_booking_records "https://github.com/gabri1103/cral/blob/main/api/models/Prenotazione.js"
click node_message_records "https://github.com/gabri1103/cral/blob/main/api/models/Messaggio.js"
click node_discount_records "https://github.com/gabri1103/cral/blob/main/api/models/Convenzione.js"
click node_category_records "https://github.com/gabri1103/cral/blob/main/api/models/CategoriaConvenzione.js"
click node_supporting_helpers "https://github.com/gabri1103/cral/tree/main/api/helpers"
click node_sails_app "https://github.com/gabri1103/cral/blob/main/app.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_routes,node_members,node_policies toneBlue
class node_events_controller,node_bookings_controller toneAmber
class node_messages_controller,node_discounts_controller,node_categories_controller,node_trips_controller toneMint
class node_member_records,node_event_records,node_booking_records,node_message_records,node_discount_records,node_category_records toneRose
class node_supporting_helpers,node_sails_app,node_visitor toneIndigo
```

## Components

### Web and access

- [HTTP routes](https://github.com/gabri1103/cral/blob/main/config/routes.js): `config/routes.js`
- [Member access and profiles](https://github.com/gabri1103/cral/blob/main/api/controllers/SocioController.js): `api/controllers/SocioController.js`
- [Access policies](https://github.com/gabri1103/cral/tree/main/api/policies): `api/policies`

### Events and bookings

- [Event management](https://github.com/gabri1103/cral/blob/main/api/controllers/EventoController.js): `api/controllers/EventoController.js`
- [Reservations and attendees](https://github.com/gabri1103/cral/blob/main/api/controllers/PrenotazioneController.js): `api/controllers/PrenotazioneController.js`

### Member content

- [Announcements](https://github.com/gabri1103/cral/blob/main/api/controllers/MessaggioController.js): `api/controllers/MessaggioController.js`
- [Discount listings](https://github.com/gabri1103/cral/blob/main/api/controllers/ConvenzioneController.js): `api/controllers/ConvenzioneController.js`
- [Discount categories](https://github.com/gabri1103/cral/blob/main/api/controllers/CategoriaConvenzioneController.js): `api/controllers/CategoriaConvenzioneController.js`
- [Travel listings](https://github.com/gabri1103/cral/blob/main/api/controllers/ViaggioController.js): `api/controllers/ViaggioController.js`

### Domain records

- [Member records](https://github.com/gabri1103/cral/blob/main/api/models/Socio.js): `api/models/Socio.js`
- [Event records](https://github.com/gabri1103/cral/blob/main/api/models/Evento.js): `api/models/Evento.js`
- [Reservation records](https://github.com/gabri1103/cral/blob/main/api/models/Prenotazione.js): `api/models/Prenotazione.js`
- [Message records](https://github.com/gabri1103/cral/blob/main/api/models/Messaggio.js): `api/models/Messaggio.js`
- [Discount records](https://github.com/gabri1103/cral/blob/main/api/models/Convenzione.js): `api/models/Convenzione.js`
- [Category records](https://github.com/gabri1103/cral/blob/main/api/models/CategoriaConvenzione.js): `api/models/CategoriaConvenzione.js`

### Application support

- [Uploads and email](https://github.com/gabri1103/cral/tree/main/api/helpers): `api/helpers`
- [Sails runtime](https://github.com/gabri1103/cral/blob/main/app.js): `app.js`

### Other components

- **Member or admin**

## Connections

- Member or admin → HTTP routes: sends request (evidence: `config/routes.js`)
- HTTP routes → Member access and profiles: dispatches to (evidence: `config/routes.js`)
- HTTP routes → Event management: dispatches to (evidence: `config/routes.js`)
- HTTP routes → Reservations and attendees: dispatches to (evidence: `config/routes.js`)
- HTTP routes → Announcements: dispatches to (evidence: `config/routes.js`)
- HTTP routes → Discount listings: dispatches to (evidence: `config/routes.js`)
- HTTP routes → Discount categories: dispatches to (evidence: `config/routes.js`)
- HTTP routes → Travel listings: dispatches to (evidence: `config/routes.js`)
- Member access and profiles → Member records: queries and updates (evidence: `api/controllers/SocioController.js`)
- Event management → Event records: queries and updates (evidence: `api/controllers/EventoController.js`)
- Event management → Reservation records: counts reservations (evidence: `api/controllers/EventoController.js`)
- Announcements → Message records: queries and updates (evidence: `api/controllers/MessaggioController.js`)
- Discount listings → Discount records: queries and updates (evidence: `api/controllers/ConvenzioneController.js`)
- Discount listings → Category records: loads categories (evidence: `api/controllers/ConvenzioneController.js`)
- Event management → Uploads and email: uploads files (evidence: `api/controllers/EventoController.js`)
- Announcements → Uploads and email: uploads files (evidence: `api/controllers/MessaggioController.js`)
- Discount listings → Uploads and email: uploads files (evidence: `api/controllers/ConvenzioneController.js`)
- Member access and profiles → Uploads and email: sends email (evidence: `api/controllers/SocioController.js`)
- Sails runtime → HTTP routes: serves application
- Access policies → HTTP routes: guards requests
