# cuervo-ciclon/gimnasionatatorio architecture

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

## Overview

Corpo Natatorio y Gimnasio is a Django site combining a public landing page with member accounts, gym administration, attendance, monthly fees and medical reviews, plus activity enrollment and reservations. The principal staff workflow searches for a member or checks them in, then records attendance and reports fee, medical-clearance, or plan-limit warnings without blocking entry. Staff also manage member status and monthly records; activity enrollment validates capacity and creates reservations. Edges are limited to README statements and relationships visible in the supplied source index or excerpts; unsampled wiring is not assumed.

Main entry points: [`socios/services.py`](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/services.py) (Attendance and monthly rules), [`socios/models.py`](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/models.py) (Member records), [`actividades/views.py`](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/actividades/views.py) (Activity administration), [`socios/views.py`](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/views.py) (Member and staff views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and accounts"]
  node_landing["Public landing<br/>[views.py]"]
  node_account_views["Account flows<br/>[views.py]"]
  node_account_forms["Login and registration<br/>[forms.py]"]
  node_account_signal["User-to-member signal<br/>[signals.py]"]
end

subgraph group_members["Member operations"]
  node_member_views["Member and staff views<br/>[views.py]"]
  node_member_services["Attendance and monthly rules<br/>[services.py]"]
  node_member_command["Monthly record command"]
  node_member_signal["Member lifecycle signal<br/>[signals.py]"]
end

subgraph group_activities["Activities"]
  node_activity_views["Activity administration<br/>[views.py]"]
  node_activity_services["Enrollment and reservations<br/>[services.py]"]
end

subgraph group_records["Domain records"]
  node_member_records[("Member records<br/>[models.py]")]
  node_activity_records[("Activity records<br/>[models.py]")]
end

node_visitor(("Visitor or staff"))

node_visitor -->|"visits"| node_landing
node_visitor -->|"signs in"| node_account_views
node_account_views -->|"uses forms"| node_account_forms
node_account_signal -->|"creates profile"| node_member_records
node_member_views -->|"calls check-in"| node_member_services
node_member_views -->|"reads and updates"| node_member_records
node_member_command -->|"generates records"| node_member_services
node_member_services -->|"reads and writes"| node_member_records
node_member_signal -->|"creates profile"| node_member_records
node_member_signal -->|"ensures monthly records"| node_member_services
node_activity_views -->|"calls enrollment"| node_activity_services
node_activity_views -->|"reads records"| node_activity_records
node_activity_views -->|"looks up members"| node_member_records
node_activity_views -->|"uses month labels"| node_member_services
node_activity_services -->|"creates reservations"| node_activity_records

click node_landing "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/pagina/views.py"
click node_account_views "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/accounts/views.py"
click node_account_forms "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/accounts/forms.py"
click node_account_signal "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/accounts/signals.py"
click node_member_views "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/views.py"
click node_member_services "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/services.py"
click node_member_command "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/management/commands/crear_cuotas_y_revisiones.py"
click node_member_signal "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/signals.py"
click node_member_records "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/models.py"
click node_activity_views "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/actividades/views.py"
click node_activity_services "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/actividades/services.py"
click node_activity_records "https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/actividades/models.py"

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_landing,node_account_views,node_account_forms,node_account_signal toneBlue
class node_member_views,node_member_services,node_member_command,node_member_signal toneAmber
class node_activity_views,node_activity_services toneMint
class node_member_records,node_activity_records toneRose
class node_visitor toneIndigo
```

## Components

### Web and accounts

- [Public landing](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/pagina/views.py): `pagina/views.py`
- [Account flows](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/accounts/views.py): `accounts/views.py`
- [Login and registration](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/accounts/forms.py): `accounts/forms.py`
- [User-to-member signal](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/accounts/signals.py): `accounts/signals.py`

### Member operations

- [Member and staff views](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/views.py): `socios/views.py`
- [Attendance and monthly rules](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/services.py): `socios/services.py`
- [Monthly record command](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/management/commands/crear_cuotas_y_revisiones.py): `socios/management/commands/crear_cuotas_y_revisiones.py`
- [Member lifecycle signal](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/signals.py): `socios/signals.py`

### Activities

- [Activity administration](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/actividades/views.py): `actividades/views.py`
- [Enrollment and reservations](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/actividades/services.py): `actividades/services.py`

### Domain records

- [Member records](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/socios/models.py): `socios/models.py`
- [Activity records](https://github.com/cuervo-ciclon/gimnasionatatorio/blob/main/actividades/models.py): `actividades/models.py`

### Other components

- **Visitor or staff**

## Connections

- Visitor or staff → Public landing: visits (evidence: `README.md`)
- Visitor or staff → Account flows: signs in (evidence: `README.md`)
- Account flows → Login and registration: uses forms (evidence: `accounts/views.py`)
- User-to-member signal → Member records: creates profile (evidence: `accounts/signals.py`)
- Member and staff views → Attendance and monthly rules: calls check-in (evidence: `socios/views.py`)
- Member and staff views → Member records: reads and updates (evidence: `socios/views.py`)
- Monthly record command → Attendance and monthly rules: generates records (evidence: `socios/management/commands/crear_cuotas_y_revisiones.py`)
- Attendance and monthly rules → Member records: reads and writes (evidence: `socios/services.py`)
- Member lifecycle signal → Member records: creates profile (evidence: `socios/signals.py`)
- Member lifecycle signal → Attendance and monthly rules: ensures monthly records (evidence: `socios/signals.py`)
- Activity administration → Enrollment and reservations: calls enrollment (evidence: `actividades/views.py`)
- Activity administration → Activity records: reads records (evidence: `actividades/views.py`)
- Activity administration → Member records: looks up members (evidence: `actividades/views.py`)
- Activity administration → Attendance and monthly rules: uses month labels (evidence: `actividades/views.py`)
- Enrollment and reservations → Activity records: creates reservations (evidence: `actividades/services.py`)
