# mgurnett/fishinglog architecture

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

- Interactive diagram: https://gitdiagram.com/mgurnett/fishinglog
- Repository: https://github.com/mgurnett/fishinglog

## Overview

FishingLog is a Django application for recording and exploring fishing activity and Alberta stillwater information. Anglers enter catch and hatch observations, then browse lake, temperature, seasonal insect, and stocking information; catch views also expose weather and fishing-plan features. User profiles and community posts are separate supporting capabilities. The graph follows documented URL routing and sampled imports/calls; unsampled views and scripts limit certainty about some feature links and data-import flows.

Main entry points: [`catches/views.py`](https://github.com/mgurnett/fishinglog/blob/master/catches/views.py) (Fishing views), [`FishingLog/urls.py`](https://github.com/mgurnett/fishinglog/blob/master/FishingLog/urls.py) (URL routing), [`catches/models.py`](https://github.com/mgurnett/fishinglog/blob/master/catches/models.py) (Fishing records), [`users/signals.py`](https://github.com/mgurnett/fishinglog/blob/master/users/signals.py) (Account signals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_router["URL routing<br/>[urls.py]"]
  node_catch_views["Fishing views<br/>[views.py]"]
  node_blog_views["Blog views<br/>[views.py]"]
  node_account_views["Account views<br/>[views.py]"]
end

subgraph group_fishing["Fishing domain"]
  node_forms["Catch forms<br/>[forms.py]"]
  node_domain_models[("Fishing records<br/>[models.py]")]
  node_fish_reference["Fish reference<br/>[fish_data.py]"]
  node_season_queries["Seasonal queries<br/>[queries.py]"]
  node_recommendations["Fly recommendations<br/>[num_array.py]"]
  node_distance["Lake distance<br/>[distance.py]"]
  node_plan["AI fishing plan<br/>[ai_plan.py]"]
end

subgraph group_accounts["Accounts and community"]
  node_profiles[("User profiles<br/>[models.py]")]
  node_user_signals["Account signals<br/>[signals.py]"]
  node_posts[("Community posts<br/>[models.py]")]
  node_post_views["Post browsing<br/>[views.py]"]
end

subgraph group_data["Data and integrations"]
  node_weather["Weather service<br/>[Open_Weather.py]"]
  node_weather_helpers["Weather helpers<br/>[weather_stuff.py]"]
  node_media["Media handling<br/>[download_media.py]"]
end

node_angler(("Angler"))
node_external_weather{{"OpenWeather API"}}

node_angler -->|"requests pages"| node_router
node_router -->|"routes catches"| node_catch_views
node_router -->|"routes accounts"| node_account_views
node_router -->|"routes blog"| node_blog_views
node_catch_views -->|"uses forms"| node_forms
node_forms -->|"validates records"| node_domain_models
node_catch_views -->|"reads and writes"| node_domain_models
node_catch_views -->|"queries seasons"| node_season_queries
node_catch_views -->|"builds suggestions"| node_recommendations
node_catch_views -->|"uses distances"| node_distance
node_catch_views -->|"requests plans"| node_plan
node_catch_views -->|"gets weather"| node_weather
node_catch_views -->|"uses weather helpers"| node_weather_helpers
node_catch_views -->|"handles media"| node_media
node_catch_views -->|"uses fish data"| node_fish_reference
node_weather -->|"requests forecasts"| node_external_weather
node_account_views -->|"manages profiles"| node_profiles
node_user_signals -->|"creates profiles"| node_profiles
node_user_signals -->|"creates regions"| node_domain_models
node_post_views -->|"reads and edits"| node_posts
node_router -->|"routes posts"| node_post_views

click node_router "https://github.com/mgurnett/fishinglog/blob/master/FishingLog/urls.py"
click node_catch_views "https://github.com/mgurnett/fishinglog/blob/master/catches/views.py"
click node_blog_views "https://github.com/mgurnett/fishinglog/blob/master/blog/views.py"
click node_account_views "https://github.com/mgurnett/fishinglog/blob/master/users/views.py"
click node_forms "https://github.com/mgurnett/fishinglog/blob/master/catches/forms.py"
click node_domain_models "https://github.com/mgurnett/fishinglog/blob/master/catches/models.py"
click node_fish_reference "https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/fish_data.py"
click node_season_queries "https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/queries.py"
click node_recommendations "https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/num_array.py"
click node_distance "https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/distance.py"
click node_plan "https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/ai_plan.py"
click node_weather "https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/Open_Weather.py"
click node_weather_helpers "https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/weather_stuff.py"
click node_media "https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/download_media.py"
click node_profiles "https://github.com/mgurnett/fishinglog/blob/master/users/models.py"
click node_user_signals "https://github.com/mgurnett/fishinglog/blob/master/users/signals.py"
click node_posts "https://github.com/mgurnett/fishinglog/blob/master/blog/models.py"
click node_post_views "https://github.com/mgurnett/fishinglog/blob/master/blog/views.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_router,node_catch_views,node_blog_views,node_account_views toneBlue
class node_forms,node_domain_models,node_fish_reference,node_season_queries,node_recommendations,node_distance,node_plan toneAmber
class node_profiles,node_user_signals,node_posts,node_post_views,node_external_weather toneMint
class node_weather,node_weather_helpers,node_media toneRose
class node_angler toneIndigo
```

## Components

### Web application

- [URL routing](https://github.com/mgurnett/fishinglog/blob/master/FishingLog/urls.py): `FishingLog/urls.py`
- [Fishing views](https://github.com/mgurnett/fishinglog/blob/master/catches/views.py): `catches/views.py`
- [Blog views](https://github.com/mgurnett/fishinglog/blob/master/blog/views.py): `blog/views.py`
- [Account views](https://github.com/mgurnett/fishinglog/blob/master/users/views.py): `users/views.py`

### Fishing domain

- [Catch forms](https://github.com/mgurnett/fishinglog/blob/master/catches/forms.py): `catches/forms.py`
- [Fishing records](https://github.com/mgurnett/fishinglog/blob/master/catches/models.py): `catches/models.py`
- [Fish reference](https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/fish_data.py): `catches/helpers/fish_data.py`
- [Seasonal queries](https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/queries.py): `catches/helpers/queries.py`
- [Fly recommendations](https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/num_array.py): `catches/helpers/num_array.py`
- [Lake distance](https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/distance.py): `catches/helpers/distance.py`
- [AI fishing plan](https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/ai_plan.py): `catches/helpers/ai_plan.py`

### Accounts and community

- [User profiles](https://github.com/mgurnett/fishinglog/blob/master/users/models.py): `users/models.py`
- [Account signals](https://github.com/mgurnett/fishinglog/blob/master/users/signals.py): `users/signals.py`
- [Community posts](https://github.com/mgurnett/fishinglog/blob/master/blog/models.py): `blog/models.py`
- [Post browsing](https://github.com/mgurnett/fishinglog/blob/master/blog/views.py): `blog/views.py`

### Data and integrations

- [Weather service](https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/Open_Weather.py): `catches/helpers/Open_Weather.py`
- [Weather helpers](https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/weather_stuff.py): `catches/helpers/weather_stuff.py`
- [Media handling](https://github.com/mgurnett/fishinglog/blob/master/catches/helpers/download_media.py): `catches/helpers/download_media.py`

### Other components

- **Angler**
- **OpenWeather API**

## Connections

- Angler → URL routing: requests pages (evidence: `FishingLog/urls.py`)
- URL routing → Fishing views: routes catches (evidence: `FishingLog/urls.py`)
- URL routing → Account views: routes accounts (evidence: `FishingLog/urls.py`)
- URL routing → Blog views: routes blog
- Fishing views → Catch forms: uses forms (evidence: `catches/views.py`)
- Catch forms → Fishing records: validates records (evidence: `catches/forms.py`)
- Fishing views → Fishing records: reads and writes (evidence: `catches/views.py`)
- Fishing views → Seasonal queries: queries seasons (evidence: `catches/views.py`)
- Fishing views → Fly recommendations: builds suggestions (evidence: `catches/views.py`)
- Fishing views → Lake distance: uses distances (evidence: `catches/views.py`)
- Fishing views → AI fishing plan: requests plans (evidence: `catches/views.py`)
- Fishing views → Weather service: gets weather (evidence: `catches/views.py`)
- Fishing views → Weather helpers: uses weather helpers (evidence: `catches/views.py`)
- Fishing views → Media handling: handles media (evidence: `catches/views.py`)
- Fishing views → Fish reference: uses fish data (evidence: `catches/urls.py`)
- Weather service → OpenWeather API: requests forecasts (evidence: `catches/helpers/Open_Weather.py`)
- Account views → User profiles: manages profiles (evidence: `users/views.py`)
- Account signals → User profiles: creates profiles (evidence: `users/signals.py`)
- Account signals → Fishing records: creates regions (evidence: `users/signals.py`)
- Post browsing → Community posts: reads and edits (evidence: `blog/views.py`)
- URL routing → Post browsing: routes posts
