# olegbondarua/django_movies architecture

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

- Interactive diagram: https://gitdiagram.com/olegbondarua/django_movies
- Repository: https://github.com/olegbondarua/django_movies

## Overview

Beetroot_django is a Django film-catalog website with account activation and a contact form. Visitors browse recommendations, categories, film details, and ranked search results; they can also submit reviews. Separate management commands scrape film metadata and fetch film backgrounds. The source excerpts show these workflows’ model and helper calls, but not URL routing or templates, so those connections are omitted. The README names no additional product capabilities.

Main entry points: [`users/views.py`](https://github.com/olegbondarua/django_movies/blob/main/users/views.py) (Account views), [`kinozal/scrape_background.py`](https://github.com/olegbondarua/django_movies/blob/main/kinozal/scrape_background.py) (Background scraper), [`kinozal/models.py`](https://github.com/olegbondarua/django_movies/blob/main/kinozal/models.py) (Film data), [`kinozal/views.py`](https://github.com/olegbondarua/django_movies/blob/main/kinozal/views.py) (Catalog views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Film catalog"]
  node_film_views["Catalog views<br/>[views.py]"]
  node_film_selectors["Film selectors<br/>[selectors.py]"]
  node_film_data[("Film data<br/>[models.py]")]
  node_review_form["Review form<br/>[forms.py]"]
  node_admin_actions["Catalog actions<br/>[actions.py]"]
end

subgraph group_ingestion["Catalog ingestion"]
  node_scrape_command["Scrape command<br/>[scrape.py]"]
  node_film_scraper["Film scraper<br/>[scrapper.py]"]
  node_background_command["Background command<br/>[get_background.py]"]
  node_background_scraper["Background scraper"]
end

subgraph group_accounts["Accounts"]
  node_user_views["Account views<br/>[views.py]"]
  node_user_forms["Signup form<br/>[forms.py]"]
  node_user_data[("User data<br/>[models.py]")]
  node_activation_tokens["Activation tokens<br/>[tokens.py]"]
end

subgraph group_contact["Contact"]
  node_contact_views["Contact view<br/>[views.py]"]
  node_contact_form["Contact form<br/>[forms.py]"]
  node_contact_data[("Contact records<br/>[models.py]")]
  node_email_helper["HTML email<br/>[email.py]"]
end

node_visitor(("Visitor"))
node_donor_site(("Film donor"))
node_image_search(("Image search"))
node_mail_service(("Mail service"))

node_film_views -->|"queries"| node_film_data
node_film_views -->|"calls"| node_film_selectors
node_film_views -->|"validates with"| node_review_form
node_film_scraper -->|"writes films"| node_film_data
node_film_scraper -->|"fetches pages"| node_donor_site
node_scrape_command -->|"runs"| node_film_scraper
node_background_command -->|"runs"| node_background_scraper
node_background_scraper -->|"reads films"| node_film_data
node_background_scraper -->|"saves backgrounds"| node_film_data
node_background_scraper -->|"searches images"| node_image_search
node_user_views -->|"uses"| node_user_forms
node_user_views -->|"creates and activates"| node_user_data
node_user_views -->|"checks tokens"| node_activation_tokens
node_user_views -->|"sends activation"| node_email_helper
node_contact_views -->|"uses"| node_contact_form
node_contact_views -->|"creates records"| node_contact_data
node_contact_views -->|"sends confirmation"| node_email_helper
node_email_helper -->|"sends mail"| node_mail_service

click node_film_views "https://github.com/olegbondarua/django_movies/blob/main/kinozal/views.py"
click node_film_selectors "https://github.com/olegbondarua/django_movies/blob/main/kinozal/selectors.py"
click node_film_data "https://github.com/olegbondarua/django_movies/blob/main/kinozal/models.py"
click node_review_form "https://github.com/olegbondarua/django_movies/blob/main/kinozal/forms.py"
click node_admin_actions "https://github.com/olegbondarua/django_movies/blob/main/kinozal/actions.py"
click node_scrape_command "https://github.com/olegbondarua/django_movies/blob/main/kinozal/management/commands/scrape.py"
click node_film_scraper "https://github.com/olegbondarua/django_movies/blob/main/kinozal/scrapper.py"
click node_background_command "https://github.com/olegbondarua/django_movies/blob/main/kinozal/management/commands/get_background.py"
click node_background_scraper "https://github.com/olegbondarua/django_movies/blob/main/kinozal/scrape_background.py"
click node_user_views "https://github.com/olegbondarua/django_movies/blob/main/users/views.py"
click node_user_forms "https://github.com/olegbondarua/django_movies/blob/main/users/forms.py"
click node_user_data "https://github.com/olegbondarua/django_movies/blob/main/users/models.py"
click node_activation_tokens "https://github.com/olegbondarua/django_movies/blob/main/users/tokens.py"
click node_contact_views "https://github.com/olegbondarua/django_movies/blob/main/website/views.py"
click node_contact_form "https://github.com/olegbondarua/django_movies/blob/main/website/forms.py"
click node_contact_data "https://github.com/olegbondarua/django_movies/blob/main/website/models.py"
click node_email_helper "https://github.com/olegbondarua/django_movies/blob/main/utils/email.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_film_views,node_film_selectors,node_film_data,node_review_form,node_admin_actions toneBlue
class node_scrape_command,node_film_scraper,node_background_command,node_background_scraper toneAmber
class node_user_views,node_user_forms,node_user_data,node_activation_tokens toneMint
class node_contact_views,node_contact_form,node_contact_data,node_email_helper toneRose
class node_visitor,node_donor_site,node_image_search,node_mail_service toneIndigo
```

## Components

### Film catalog

- [Catalog views](https://github.com/olegbondarua/django_movies/blob/main/kinozal/views.py): `kinozal/views.py`
- [Film selectors](https://github.com/olegbondarua/django_movies/blob/main/kinozal/selectors.py): `kinozal/selectors.py`
- [Film data](https://github.com/olegbondarua/django_movies/blob/main/kinozal/models.py): `kinozal/models.py`
- [Review form](https://github.com/olegbondarua/django_movies/blob/main/kinozal/forms.py): `kinozal/forms.py`
- [Catalog actions](https://github.com/olegbondarua/django_movies/blob/main/kinozal/actions.py): `kinozal/actions.py`

### Catalog ingestion

- [Scrape command](https://github.com/olegbondarua/django_movies/blob/main/kinozal/management/commands/scrape.py): `kinozal/management/commands/scrape.py`
- [Film scraper](https://github.com/olegbondarua/django_movies/blob/main/kinozal/scrapper.py): `kinozal/scrapper.py`
- [Background command](https://github.com/olegbondarua/django_movies/blob/main/kinozal/management/commands/get_background.py): `kinozal/management/commands/get_background.py`
- [Background scraper](https://github.com/olegbondarua/django_movies/blob/main/kinozal/scrape_background.py): `kinozal/scrape_background.py`

### Accounts

- [Account views](https://github.com/olegbondarua/django_movies/blob/main/users/views.py): `users/views.py`
- [Signup form](https://github.com/olegbondarua/django_movies/blob/main/users/forms.py): `users/forms.py`
- [User data](https://github.com/olegbondarua/django_movies/blob/main/users/models.py): `users/models.py`
- [Activation tokens](https://github.com/olegbondarua/django_movies/blob/main/users/tokens.py): `users/tokens.py`

### Contact

- [Contact view](https://github.com/olegbondarua/django_movies/blob/main/website/views.py): `website/views.py`
- [Contact form](https://github.com/olegbondarua/django_movies/blob/main/website/forms.py): `website/forms.py`
- [Contact records](https://github.com/olegbondarua/django_movies/blob/main/website/models.py): `website/models.py`
- [HTML email](https://github.com/olegbondarua/django_movies/blob/main/utils/email.py): `utils/email.py`

### Other components

- **Visitor**
- **Film donor**
- **Image search**
- **Mail service**

## Connections

- Catalog views → Film data: queries (evidence: `kinozal/views.py`)
- Catalog views → Film selectors: calls (evidence: `kinozal/views.py`)
- Catalog views → Review form: validates with (evidence: `kinozal/views.py`)
- Film scraper → Film data: writes films (evidence: `kinozal/scrapper.py`)
- Film scraper → Film donor: fetches pages (evidence: `kinozal/scrapper.py`)
- Scrape command → Film scraper: runs (evidence: `kinozal/management/commands/scrape.py`)
- Background command → Background scraper: runs (evidence: `kinozal/management/commands/get_background.py`)
- Background scraper → Film data: reads films (evidence: `kinozal/scrape_background.py`)
- Background scraper → Film data: saves backgrounds (evidence: `kinozal/scrape_background.py`)
- Background scraper → Image search: searches images (evidence: `kinozal/scrape_background.py`)
- Account views → Signup form: uses (evidence: `users/views.py`)
- Account views → User data: creates and activates (evidence: `users/views.py`)
- Account views → Activation tokens: checks tokens (evidence: `users/views.py`)
- Account views → HTML email: sends activation (evidence: `users/views.py`)
- Contact view → Contact form: uses (evidence: `website/views.py`)
- Contact view → Contact records: creates records (evidence: `website/views.py`)
- Contact view → HTML email: sends confirmation (evidence: `website/views.py`)
- HTML email → Mail service: sends mail (evidence: `utils/email.py`)
