# manupa16/paddlesurftime architecture

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

- Interactive diagram: https://gitdiagram.com/manupa16/paddlesurftime
- Repository: https://github.com/manupa16/paddlesurftime

## Overview

PaddleSurfTime is a planned paddle-surf beach suitability aid; the current runtime is a small data model, not a complete forecast or recommendation workflow. The README describes users consulting beach conditions for an arrival time, but the shown class only stores beach orientation and time-indexed sea conditions. The graph preserves the documented use and the implemented domain types; no data sources or suitability calculation are shown in the sampled code.

Main entry points: [`src/paddlesurf_time/condiciones_mar.py`](https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/condiciones_mar.py) (Sea conditions), [`src/paddlesurf_time/playas_de_la_costa.py`](https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/playas_de_la_costa.py) (Coastal beaches), [`src/paddlesurf_time/viento.py`](https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/viento.py) (Wind), [`src/paddlesurf_time/bandera.py`](https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/bandera.py) (Beach flag)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_beach_data["Beach data"]
  node_beaches[("Coastal beaches")]
end

subgraph group_sea_conditions["Sea conditions"]
  node_conditions["Sea conditions<br/>[condiciones_mar.py]"]
  node_wind["Wind<br/>[viento.py]"]
  node_flag["Beach flag<br/>[bandera.py]"]
end

node_user(("Paddle-surf user"))

node_user -->|"consults conditions"| node_beaches
node_beaches -->|"stores by time"| node_conditions
node_conditions -->|"contains"| node_wind
node_conditions -->|"contains"| node_flag

click node_beaches "https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/playas_de_la_costa.py"
click node_conditions "https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/condiciones_mar.py"
click node_wind "https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/viento.py"
click node_flag "https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/bandera.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_beaches,node_user toneBlue
class node_conditions,node_wind,node_flag toneAmber
```

## Components

### Beach data

- [Coastal beaches](https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/playas_de_la_costa.py): `src/paddlesurf_time/playas_de_la_costa.py`

### Sea conditions

- [Sea conditions](https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/condiciones_mar.py): `src/paddlesurf_time/condiciones_mar.py`
- [Wind](https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/viento.py): `src/paddlesurf_time/viento.py`
- [Beach flag](https://github.com/manupa16/paddlesurftime/blob/master/src/paddlesurf_time/bandera.py): `src/paddlesurf_time/bandera.py`

### Other components

- **Paddle-surf user**

## Connections

- Paddle-surf user → Coastal beaches: consults conditions (evidence: `README.md`)
- Coastal beaches → Sea conditions: stores by time (evidence: `src/paddlesurf_time/playas_de_la_costa.py`)
- Sea conditions → Wind: contains (evidence: `src/paddlesurf_time/condiciones_mar.py`)
- Sea conditions → Beach flag: contains (evidence: `src/paddlesurf_time/condiciones_mar.py`)
