# crustycrusader/zeta architecture

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

- Interactive diagram: https://gitdiagram.com/crustycrusader/zeta
- Repository: https://github.com/crustycrusader/zeta

## Overview

Artemis is a Django social publishing application centered on a feed of videos and articles, with user profiles, follows, comments, likes, notifications, and direct messaging. A typical journey is browsing the feed, opening or creating content, interacting with it, and seeing social updates; profiles and messaging provide parallel social workflows. The graph separates request handlers, domain data, and real-time messaging. Source evidence is limited to the supplied excerpts and SOURCE INDEX; several subsystems, including products, are represented only where that index establishes their modules and references.

Main entry points: [`Video/views.py`](https://github.com/crustycrusader/zeta/blob/main/Video/views.py) (Video handlers), [`blog/views.py`](https://github.com/crustycrusader/zeta/blob/main/blog/views.py) (Article handlers), [`notifications/utils.py`](https://github.com/crustycrusader/zeta/blob/main/notifications/utils.py) (Notification dispatch), [`accounts/models.py`](https://github.com/crustycrusader/zeta/blob/main/accounts/models.py) (Users and follows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Publishing and discovery"]
  node_home["Activity feed<br/>[views.py]"]
  node_video_handlers["Video handlers<br/>[views.py]"]
  node_video_forms["Video forms<br/>[forms.py]"]
  node_video_data[("Videos and likes<br/>[models.py]")]
  node_article_handlers["Article handlers<br/>[views.py]"]
  node_article_forms["Article forms<br/>[forms.py]"]
  node_article_data[("Articles<br/>[models.py]")]
end

subgraph group_identity["Accounts and profiles"]
  node_account_handlers["Account handlers<br/>[views.py]"]
  node_account_forms["Account forms<br/>[forms.py]"]
  node_account_data[("Users and follows<br/>[models.py]")]
  node_profile_handlers["Profile handlers<br/>[views.py]"]
  node_profile_data[("Profiles<br/>[models.py]")]
  node_profile_signals["Profile signals<br/>[signals.py]"]
end

subgraph group_interaction["Social interactions"]
  node_comment_forms["Comment forms<br/>[forms.py]"]
  node_comment_data[("Comments<br/>[models.py]")]
end

subgraph group_realtime["Messaging and alerts"]
  node_message_handlers["Messaging handlers<br/>[views.py]"]
  node_message_forms["Message forms<br/>[forms.py]"]
  node_message_data[("Conversations<br/>[models.py]")]
  node_chat_consumers["WebSocket consumers<br/>[consumers.py]"]
  node_socket_routes["WebSocket routes<br/>[routing.py]"]
  node_notification_handlers["Notification handlers<br/>[views.py]"]
  node_notification_consumers["Notification consumer<br/>[consumers.py]"]
  node_notification_utils["Notification dispatch<br/>[utils.py]"]
  node_notification_data[("Notifications<br/>[models.py]")]
end

subgraph group_commerce["Products"]
  node_product_handlers["Product handlers<br/>[views.py]"]
  node_product_forms["Product forms<br/>[forms.py]"]
  node_product_data[("Products<br/>[models.py]")]
end

node_visitor(("Visitor"))
node_channel_layer["Django channel layer"]

node_visitor -->|"requests feed"| node_home
node_visitor -->|"requests video"| node_video_handlers
node_visitor -->|"requests article"| node_article_handlers
node_home -->|"queries follows"| node_account_data
node_home -->|"queries videos"| node_video_data
node_home -->|"queries articles"| node_article_data
node_video_handlers -->|"uses form"| node_video_forms
node_video_forms -->|"models fields"| node_video_data
node_video_handlers -->|"reads and writes"| node_video_data
node_video_handlers -->|"loads comments"| node_comment_data
node_video_handlers -->|"creates form"| node_comment_forms
node_video_handlers -->|"sends like alert"| node_notification_utils
node_article_handlers -->|"uses form"| node_article_forms
node_article_handlers -->|"reads and writes"| node_article_data
node_article_handlers -->|"loads comments"| node_comment_data
node_article_handlers -->|"creates form"| node_comment_forms
node_article_forms -->|"models fields"| node_article_data
node_account_handlers -->|"uses form"| node_account_forms
node_account_forms -->|"models fields"| node_account_data
node_profile_handlers -->|"queries follows"| node_account_data
node_profile_handlers -->|"reads and writes"| node_profile_data
node_profile_handlers -->|"sends follow alert"| node_notification_utils
node_profile_signals -->|"uses profile model"| node_profile_data
node_comment_forms -->|"models fields"| node_comment_data
node_message_handlers -->|"uses form"| node_message_forms
node_message_handlers -->|"reads and writes"| node_message_data
node_message_handlers -->|"queries users"| node_account_data
node_message_forms -->|"references model"| node_message_data
node_message_forms -->|"references users"| node_account_data
node_socket_routes -->|"routes sockets"| node_chat_consumers
node_chat_consumers -->|"uses conversations"| node_message_data
node_chat_consumers -->|"uses notifications"| node_notification_utils
node_socket_routes -->|"routes sockets"| node_notification_consumers
node_notification_handlers -->|"queries notifications"| node_notification_data
node_notification_utils -->|"creates and counts"| node_notification_data
node_notification_utils -->|"dispatches event"| node_channel_layer
node_product_handlers -->|"uses form"| node_product_forms
node_product_handlers -->|"reads and writes"| node_product_data
node_product_forms -->|"models fields"| node_product_data

click node_home "https://github.com/crustycrusader/zeta/blob/main/pages/views.py"
click node_video_handlers "https://github.com/crustycrusader/zeta/blob/main/Video/views.py"
click node_video_forms "https://github.com/crustycrusader/zeta/blob/main/Video/forms.py"
click node_video_data "https://github.com/crustycrusader/zeta/blob/main/Video/models.py"
click node_article_handlers "https://github.com/crustycrusader/zeta/blob/main/blog/views.py"
click node_article_forms "https://github.com/crustycrusader/zeta/blob/main/blog/forms.py"
click node_article_data "https://github.com/crustycrusader/zeta/blob/main/blog/models.py"
click node_account_handlers "https://github.com/crustycrusader/zeta/blob/main/accounts/views.py"
click node_account_forms "https://github.com/crustycrusader/zeta/blob/main/accounts/forms.py"
click node_account_data "https://github.com/crustycrusader/zeta/blob/main/accounts/models.py"
click node_profile_handlers "https://github.com/crustycrusader/zeta/blob/main/profiles/views.py"
click node_profile_data "https://github.com/crustycrusader/zeta/blob/main/profiles/models.py"
click node_profile_signals "https://github.com/crustycrusader/zeta/blob/main/profiles/signals.py"
click node_comment_forms "https://github.com/crustycrusader/zeta/blob/main/comments/forms.py"
click node_comment_data "https://github.com/crustycrusader/zeta/blob/main/comments/models.py"
click node_message_handlers "https://github.com/crustycrusader/zeta/blob/main/messaging/views.py"
click node_message_forms "https://github.com/crustycrusader/zeta/blob/main/messaging/forms.py"
click node_message_data "https://github.com/crustycrusader/zeta/blob/main/messaging/models.py"
click node_chat_consumers "https://github.com/crustycrusader/zeta/blob/main/messaging/consumers.py"
click node_socket_routes "https://github.com/crustycrusader/zeta/blob/main/messaging/routing.py"
click node_notification_handlers "https://github.com/crustycrusader/zeta/blob/main/notifications/views.py"
click node_notification_consumers "https://github.com/crustycrusader/zeta/blob/main/notifications/consumers.py"
click node_notification_utils "https://github.com/crustycrusader/zeta/blob/main/notifications/utils.py"
click node_notification_data "https://github.com/crustycrusader/zeta/blob/main/notifications/models.py"
click node_product_handlers "https://github.com/crustycrusader/zeta/blob/main/products/views.py"
click node_product_forms "https://github.com/crustycrusader/zeta/blob/main/products/forms.py"
click node_product_data "https://github.com/crustycrusader/zeta/blob/main/products/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_home,node_video_handlers,node_video_forms,node_video_data,node_article_handlers,node_article_forms,node_article_data toneBlue
class node_account_handlers,node_account_forms,node_account_data,node_profile_handlers,node_profile_data,node_profile_signals toneAmber
class node_comment_forms,node_comment_data toneMint
class node_message_handlers,node_message_forms,node_message_data,node_chat_consumers,node_socket_routes,node_notification_handlers,node_notification_consumers,node_notification_utils,node_notification_data toneRose
class node_product_handlers,node_product_forms,node_product_data,node_visitor,node_channel_layer toneIndigo
```

## Components

### Publishing and discovery

- [Activity feed](https://github.com/crustycrusader/zeta/blob/main/pages/views.py): `pages/views.py`
- [Video handlers](https://github.com/crustycrusader/zeta/blob/main/Video/views.py): `Video/views.py`
- [Video forms](https://github.com/crustycrusader/zeta/blob/main/Video/forms.py): `Video/forms.py`
- [Videos and likes](https://github.com/crustycrusader/zeta/blob/main/Video/models.py): `Video/models.py`
- [Article handlers](https://github.com/crustycrusader/zeta/blob/main/blog/views.py): `blog/views.py`
- [Article forms](https://github.com/crustycrusader/zeta/blob/main/blog/forms.py): `blog/forms.py`
- [Articles](https://github.com/crustycrusader/zeta/blob/main/blog/models.py): `blog/models.py`

### Accounts and profiles

- [Account handlers](https://github.com/crustycrusader/zeta/blob/main/accounts/views.py): `accounts/views.py`
- [Account forms](https://github.com/crustycrusader/zeta/blob/main/accounts/forms.py): `accounts/forms.py`
- [Users and follows](https://github.com/crustycrusader/zeta/blob/main/accounts/models.py): `accounts/models.py`
- [Profile handlers](https://github.com/crustycrusader/zeta/blob/main/profiles/views.py): `profiles/views.py`
- [Profiles](https://github.com/crustycrusader/zeta/blob/main/profiles/models.py): `profiles/models.py`
- [Profile signals](https://github.com/crustycrusader/zeta/blob/main/profiles/signals.py): `profiles/signals.py`

### Social interactions

- [Comment forms](https://github.com/crustycrusader/zeta/blob/main/comments/forms.py): `comments/forms.py`
- [Comments](https://github.com/crustycrusader/zeta/blob/main/comments/models.py): `comments/models.py`

### Messaging and alerts

- [Messaging handlers](https://github.com/crustycrusader/zeta/blob/main/messaging/views.py): `messaging/views.py`
- [Message forms](https://github.com/crustycrusader/zeta/blob/main/messaging/forms.py): `messaging/forms.py`
- [Conversations](https://github.com/crustycrusader/zeta/blob/main/messaging/models.py): `messaging/models.py`
- [WebSocket consumers](https://github.com/crustycrusader/zeta/blob/main/messaging/consumers.py): `messaging/consumers.py`
- [WebSocket routes](https://github.com/crustycrusader/zeta/blob/main/messaging/routing.py): `messaging/routing.py`
- [Notification handlers](https://github.com/crustycrusader/zeta/blob/main/notifications/views.py): `notifications/views.py`
- [Notification consumer](https://github.com/crustycrusader/zeta/blob/main/notifications/consumers.py): `notifications/consumers.py`
- [Notification dispatch](https://github.com/crustycrusader/zeta/blob/main/notifications/utils.py): `notifications/utils.py`
- [Notifications](https://github.com/crustycrusader/zeta/blob/main/notifications/models.py): `notifications/models.py`

### Products

- [Product handlers](https://github.com/crustycrusader/zeta/blob/main/products/views.py): `products/views.py`
- [Product forms](https://github.com/crustycrusader/zeta/blob/main/products/forms.py): `products/forms.py`
- [Products](https://github.com/crustycrusader/zeta/blob/main/products/models.py): `products/models.py`

### Other components

- **Visitor**
- **Django channel layer**

## Connections

- Visitor → Activity feed: requests feed (evidence: `pages/views.py`)
- Visitor → Video handlers: requests video (evidence: `Video/views.py`)
- Visitor → Article handlers: requests article (evidence: `blog/views.py`)
- Activity feed → Users and follows: queries follows (evidence: `pages/views.py`)
- Activity feed → Videos and likes: queries videos (evidence: `pages/views.py`)
- Activity feed → Articles: queries articles (evidence: `pages/views.py`)
- Video handlers → Video forms: uses form (evidence: `Video/views.py`)
- Video forms → Videos and likes: models fields (evidence: `Video/forms.py`)
- Video handlers → Videos and likes: reads and writes (evidence: `Video/views.py`)
- Video handlers → Comments: loads comments (evidence: `Video/views.py`)
- Video handlers → Comment forms: creates form (evidence: `Video/views.py`)
- Video handlers → Notification dispatch: sends like alert (evidence: `Video/views.py`)
- Article handlers → Article forms: uses form (evidence: `blog/views.py`)
- Article handlers → Articles: reads and writes (evidence: `blog/views.py`)
- Article handlers → Comments: loads comments (evidence: `blog/views.py`)
- Article handlers → Comment forms: creates form (evidence: `blog/views.py`)
- Article forms → Articles: models fields (evidence: `blog/forms.py`)
- Account handlers → Account forms: uses form (evidence: `accounts/views.py`)
- Account forms → Users and follows: models fields (evidence: `accounts/forms.py`)
- Profile handlers → Users and follows: queries follows (evidence: `profiles/views.py`)
- Profile handlers → Profiles: reads and writes (evidence: `profiles/views.py`)
- Profile handlers → Notification dispatch: sends follow alert (evidence: `profiles/views.py`)
- Profile signals → Profiles: uses profile model (evidence: `profiles/signals.py`)
- Comment forms → Comments: models fields (evidence: `comments/forms.py`)
- Messaging handlers → Message forms: uses form (evidence: `messaging/views.py`)
- Messaging handlers → Conversations: reads and writes (evidence: `messaging/views.py`)
- Messaging handlers → Users and follows: queries users (evidence: `messaging/views.py`)
- Message forms → Conversations: references model (evidence: `messaging/forms.py`)
- Message forms → Users and follows: references users (evidence: `messaging/forms.py`)
- WebSocket routes → WebSocket consumers: routes sockets (evidence: `messaging/routing.py`)
- WebSocket consumers → Conversations: uses conversations (evidence: `messaging/consumers.py`)
- WebSocket consumers → Notification dispatch: uses notifications (evidence: `messaging/consumers.py`)
- WebSocket routes → Notification consumer: routes sockets (evidence: `messaging/routing.py`)
- Notification handlers → Notifications: queries notifications (evidence: `notifications/views.py`)
- Notification dispatch → Notifications: creates and counts (evidence: `notifications/utils.py`)
- Notification dispatch → Django channel layer: dispatches event (evidence: `notifications/utils.py`)
- Product handlers → Product forms: uses form (evidence: `products/views.py`)
- Product handlers → Products: reads and writes (evidence: `products/views.py`)
- Product forms → Products: models fields (evidence: `products/forms.py`)
