# yash-14-web/aetherspace architecture

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

- Interactive diagram: https://gitdiagram.com/yash-14-web/aetherspace
- Repository: https://github.com/yash-14-web/aetherspace

## Overview

AetherSpace is a Django monolith for small-team collaboration. The principal workflow is a user entering a workspace, managing work (tasks and bugs), coordinating through calendars, chat, and meetings, and receiving notifications; files and workspace administration support that work. The graph includes documented product areas even where view implementations were not sampled. Edges are limited to relationships visible in excerpts or the README; unsampled view routing and cross-app orchestration are not inferred.

Main entry points: [`admin_panel/backup_service.py`](https://github.com/yash-14-web/aetherspace/blob/main/admin_panel/backup_service.py) (Backup and restore), [`accounts/services.py`](https://github.com/yash-14-web/aetherspace/blob/main/accounts/services.py) (Account services), [`notifications/services.py`](https://github.com/yash-14-web/aetherspace/blob/main/notifications/services.py) (Notification service), [`bugs/services.py`](https://github.com/yash-14-web/aetherspace/blob/main/bugs/services.py) (Bug services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Accounts and workspaces"]
  node_account_views["Account flows<br/>[views.py]"]
  node_account_service["Account services<br/>[services.py]"]
  node_account_data[("Account records<br/>[models.py]")]
  node_workspace_views["Workspace flows<br/>[views.py]"]
  node_workspace_service["Workspace services<br/>[services.py]"]
  node_workspace_data[("Workspace records<br/>[models.py]")]
end

subgraph group_work["Work management"]
  node_task_views["Task workflows<br/>[views.py]"]
  node_task_service["Task services<br/>[services.py]"]
  node_task_data[("Task records<br/>[models.py]")]
  node_bug_views["Bug workflows<br/>[views.py]"]
  node_bug_service["Bug services<br/>[services.py]"]
  node_bug_data[("Bug records<br/>[models.py]")]
end

subgraph group_collab["Team collaboration"]
  node_calendar_views["Calendar views<br/>[views.py]"]
  node_calendar_service["Calendar services<br/>[services.py]"]
  node_calendar_data[("Calendar records<br/>[models.py]")]
  node_chat_views["Chat views<br/>[views.py]"]
  node_chat_service["Chat services<br/>[services.py]"]
  node_chat_data[("Chat records<br/>[models.py]")]
  node_meeting_views["Meeting views<br/>[views.py]"]
  node_meeting_service["Meeting services<br/>[services.py]"]
  node_meeting_socket["Meeting realtime<br/>[consumers.py]"]
  node_meeting_data[("Meeting records<br/>[models.py]")]
end

subgraph group_support["Files and notifications"]
  node_file_views["File workflows<br/>[views.py]"]
  node_file_service["File storage service<br/>[services.py]"]
  node_file_data[("File metadata<br/>[models.py]")]
  node_notification_service["Notification service<br/>[services.py]"]
  node_notification_email["Email delivery<br/>[email_service.py]"]
  node_notification_data[("Notification records<br/>[models.py]")]
end

subgraph group_admin["Platform administration"]
  node_admin_views["Admin workflows<br/>[views.py]"]
  node_admin_service["Admin services<br/>[services.py]"]
  node_admin_backup["Backup and restore<br/>[backup_service.py]"]
  node_admin_data[("Admin records<br/>[models.py]")]
end

node_member(("Team member"))
node_storage[("Supabase Storage")]

node_member -.->|"uses account flows"| node_account_views
node_member -.->|"selects workspace"| node_workspace_views
node_member -.->|"manages tasks"| node_task_views
node_member -.->|"tracks bugs"| node_bug_views
node_member -.->|"uses calendar"| node_calendar_views
node_member -.->|"uses chat"| node_chat_views
node_member -.->|"joins meetings"| node_meeting_views
node_member -.->|"manages files"| node_file_views
node_member -.->|"administers platform"| node_admin_views
node_account_service -->|"uses records"| node_account_data
node_account_service -->|"uses records"| node_workspace_data
node_account_service -->|"uses records"| node_task_data
node_account_service -->|"uses records"| node_bug_data
node_account_service -->|"uses records"| node_file_data
node_workspace_service -->|"uses storage service"| node_file_service
node_task_service -->|"updates tasks"| node_task_data
node_task_service -->|"notifies"| node_notification_service
node_bug_service -->|"updates bugs"| node_bug_data
node_bug_service -->|"uses task services"| node_task_service
node_bug_service -->|"notifies"| node_notification_service
node_bug_service -->|"sends assignment email"| node_notification_email
node_calendar_service -->|"reads tasks"| node_task_data
node_calendar_service -->|"reads bugs"| node_bug_data
node_calendar_service -->|"creates meetings"| node_meeting_data
node_calendar_service -->|"uses calendar records"| node_calendar_data
node_chat_service -->|"uses chat records"| node_chat_data
node_chat_service -->|"notifies"| node_notification_service
node_meeting_service -->|"uses meeting records"| node_meeting_data
node_meeting_service -->|"uses chat records"| node_chat_data
node_meeting_service -->|"notifies"| node_notification_service
node_meeting_service -->|"sends email"| node_notification_email
node_meeting_socket -->|"uses meeting records"| node_meeting_data
node_file_service -->|"uses file metadata"| node_file_data
node_file_service -->|"uploads and downloads"| node_storage
node_notification_service -->|"creates and queries"| node_notification_data
node_notification_email -->|"checks preferences"| node_notification_data
node_admin_service -->|"uses storage service"| node_file_service
node_admin_service -->|"uses admin records"| node_admin_data
node_admin_backup -->|"restores records"| node_admin_data
node_admin_backup -->|"restores records"| node_workspace_data
node_admin_backup -->|"restores records"| node_task_data
node_admin_backup -->|"restores records"| node_bug_data
node_admin_backup -->|"restores records"| node_calendar_data
node_admin_backup -->|"restores records"| node_meeting_data
node_admin_backup -->|"restores records"| node_notification_data
node_admin_backup -->|"restores metadata"| node_file_data

click node_account_views "https://github.com/yash-14-web/aetherspace/blob/main/accounts/views.py"
click node_account_service "https://github.com/yash-14-web/aetherspace/blob/main/accounts/services.py"
click node_account_data "https://github.com/yash-14-web/aetherspace/blob/main/accounts/models.py"
click node_workspace_views "https://github.com/yash-14-web/aetherspace/blob/main/workspaces/views.py"
click node_workspace_service "https://github.com/yash-14-web/aetherspace/blob/main/workspaces/services.py"
click node_workspace_data "https://github.com/yash-14-web/aetherspace/blob/main/workspaces/models.py"
click node_task_views "https://github.com/yash-14-web/aetherspace/blob/main/tasks/views.py"
click node_task_service "https://github.com/yash-14-web/aetherspace/blob/main/tasks/services.py"
click node_task_data "https://github.com/yash-14-web/aetherspace/blob/main/tasks/models.py"
click node_bug_views "https://github.com/yash-14-web/aetherspace/blob/main/bugs/views.py"
click node_bug_service "https://github.com/yash-14-web/aetherspace/blob/main/bugs/services.py"
click node_bug_data "https://github.com/yash-14-web/aetherspace/blob/main/bugs/models.py"
click node_calendar_views "https://github.com/yash-14-web/aetherspace/blob/main/calendars/views.py"
click node_calendar_service "https://github.com/yash-14-web/aetherspace/blob/main/calendars/services.py"
click node_calendar_data "https://github.com/yash-14-web/aetherspace/blob/main/calendars/models.py"
click node_chat_views "https://github.com/yash-14-web/aetherspace/blob/main/chat/views.py"
click node_chat_service "https://github.com/yash-14-web/aetherspace/blob/main/chat/services.py"
click node_chat_data "https://github.com/yash-14-web/aetherspace/blob/main/chat/models.py"
click node_meeting_views "https://github.com/yash-14-web/aetherspace/blob/main/meetings/views.py"
click node_meeting_service "https://github.com/yash-14-web/aetherspace/blob/main/meetings/services.py"
click node_meeting_socket "https://github.com/yash-14-web/aetherspace/blob/main/meetings/consumers.py"
click node_meeting_data "https://github.com/yash-14-web/aetherspace/blob/main/meetings/models.py"
click node_file_views "https://github.com/yash-14-web/aetherspace/blob/main/files/views.py"
click node_file_service "https://github.com/yash-14-web/aetherspace/blob/main/files/services.py"
click node_file_data "https://github.com/yash-14-web/aetherspace/blob/main/files/models.py"
click node_notification_service "https://github.com/yash-14-web/aetherspace/blob/main/notifications/services.py"
click node_notification_email "https://github.com/yash-14-web/aetherspace/blob/main/notifications/email_service.py"
click node_notification_data "https://github.com/yash-14-web/aetherspace/blob/main/notifications/models.py"
click node_admin_views "https://github.com/yash-14-web/aetherspace/blob/main/admin_panel/views.py"
click node_admin_service "https://github.com/yash-14-web/aetherspace/blob/main/admin_panel/services.py"
click node_admin_backup "https://github.com/yash-14-web/aetherspace/blob/main/admin_panel/backup_service.py"
click node_admin_data "https://github.com/yash-14-web/aetherspace/blob/main/admin_panel/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_account_views,node_account_service,node_account_data,node_workspace_views,node_workspace_service,node_workspace_data toneBlue
class node_task_views,node_task_service,node_task_data,node_bug_views,node_bug_service,node_bug_data,node_storage toneAmber
class node_calendar_views,node_calendar_service,node_calendar_data,node_chat_views,node_chat_service,node_chat_data,node_meeting_views,node_meeting_service,node_meeting_socket,node_meeting_data toneMint
class node_file_views,node_file_service,node_file_data,node_notification_service,node_notification_email,node_notification_data toneRose
class node_admin_views,node_admin_service,node_admin_backup,node_admin_data,node_member toneIndigo
```

## Components

### Accounts and workspaces

- [Account flows](https://github.com/yash-14-web/aetherspace/blob/main/accounts/views.py): `accounts/views.py`
- [Account services](https://github.com/yash-14-web/aetherspace/blob/main/accounts/services.py): `accounts/services.py`
- [Account records](https://github.com/yash-14-web/aetherspace/blob/main/accounts/models.py): `accounts/models.py`
- [Workspace flows](https://github.com/yash-14-web/aetherspace/blob/main/workspaces/views.py): `workspaces/views.py`
- [Workspace services](https://github.com/yash-14-web/aetherspace/blob/main/workspaces/services.py): `workspaces/services.py`
- [Workspace records](https://github.com/yash-14-web/aetherspace/blob/main/workspaces/models.py): `workspaces/models.py`

### Work management

- [Task workflows](https://github.com/yash-14-web/aetherspace/blob/main/tasks/views.py): `tasks/views.py`
- [Task services](https://github.com/yash-14-web/aetherspace/blob/main/tasks/services.py): `tasks/services.py`
- [Task records](https://github.com/yash-14-web/aetherspace/blob/main/tasks/models.py): `tasks/models.py`
- [Bug workflows](https://github.com/yash-14-web/aetherspace/blob/main/bugs/views.py): `bugs/views.py`
- [Bug services](https://github.com/yash-14-web/aetherspace/blob/main/bugs/services.py): `bugs/services.py`
- [Bug records](https://github.com/yash-14-web/aetherspace/blob/main/bugs/models.py): `bugs/models.py`

### Team collaboration

- [Calendar views](https://github.com/yash-14-web/aetherspace/blob/main/calendars/views.py): `calendars/views.py`
- [Calendar services](https://github.com/yash-14-web/aetherspace/blob/main/calendars/services.py): `calendars/services.py`
- [Calendar records](https://github.com/yash-14-web/aetherspace/blob/main/calendars/models.py): `calendars/models.py`
- [Chat views](https://github.com/yash-14-web/aetherspace/blob/main/chat/views.py): `chat/views.py`
- [Chat services](https://github.com/yash-14-web/aetherspace/blob/main/chat/services.py): `chat/services.py`
- [Chat records](https://github.com/yash-14-web/aetherspace/blob/main/chat/models.py): `chat/models.py`
- [Meeting views](https://github.com/yash-14-web/aetherspace/blob/main/meetings/views.py): `meetings/views.py`
- [Meeting services](https://github.com/yash-14-web/aetherspace/blob/main/meetings/services.py): `meetings/services.py`
- [Meeting realtime](https://github.com/yash-14-web/aetherspace/blob/main/meetings/consumers.py): `meetings/consumers.py`
- [Meeting records](https://github.com/yash-14-web/aetherspace/blob/main/meetings/models.py): `meetings/models.py`

### Files and notifications

- [File workflows](https://github.com/yash-14-web/aetherspace/blob/main/files/views.py): `files/views.py`
- [File storage service](https://github.com/yash-14-web/aetherspace/blob/main/files/services.py): `files/services.py`
- [File metadata](https://github.com/yash-14-web/aetherspace/blob/main/files/models.py): `files/models.py`
- [Notification service](https://github.com/yash-14-web/aetherspace/blob/main/notifications/services.py): `notifications/services.py`
- [Email delivery](https://github.com/yash-14-web/aetherspace/blob/main/notifications/email_service.py): `notifications/email_service.py`
- [Notification records](https://github.com/yash-14-web/aetherspace/blob/main/notifications/models.py): `notifications/models.py`

### Platform administration

- [Admin workflows](https://github.com/yash-14-web/aetherspace/blob/main/admin_panel/views.py): `admin_panel/views.py`
- [Admin services](https://github.com/yash-14-web/aetherspace/blob/main/admin_panel/services.py): `admin_panel/services.py`
- [Backup and restore](https://github.com/yash-14-web/aetherspace/blob/main/admin_panel/backup_service.py): `admin_panel/backup_service.py`
- [Admin records](https://github.com/yash-14-web/aetherspace/blob/main/admin_panel/models.py): `admin_panel/models.py`

### Other components

- **Team member**
- **Supabase Storage**

## Connections

- Team member → Account flows: uses account flows
- Team member → Workspace flows: selects workspace
- Team member → Task workflows: manages tasks
- Team member → Bug workflows: tracks bugs
- Team member → Calendar views: uses calendar
- Team member → Chat views: uses chat
- Team member → Meeting views: joins meetings
- Team member → File workflows: manages files
- Team member → Admin workflows: administers platform
- Account services → Account records: uses records (evidence: `accounts/services.py`)
- Account services → Workspace records: uses records (evidence: `accounts/services.py`)
- Account services → Task records: uses records (evidence: `accounts/services.py`)
- Account services → Bug records: uses records (evidence: `accounts/services.py`)
- Account services → File metadata: uses records (evidence: `accounts/services.py`)
- Workspace services → File storage service: uses storage service (evidence: `workspaces/services.py`)
- Task services → Task records: updates tasks (evidence: `tasks/services.py`)
- Task services → Notification service: notifies (evidence: `tasks/services.py`)
- Bug services → Bug records: updates bugs (evidence: `bugs/services.py`)
- Bug services → Task services: uses task services (evidence: `bugs/services.py`)
- Bug services → Notification service: notifies (evidence: `bugs/services.py`)
- Bug services → Email delivery: sends assignment email (evidence: `bugs/services.py`)
- Calendar services → Task records: reads tasks (evidence: `calendars/services.py`)
- Calendar services → Bug records: reads bugs (evidence: `calendars/services.py`)
- Calendar services → Meeting records: creates meetings (evidence: `calendars/services.py`)
- Calendar services → Calendar records: uses calendar records (evidence: `calendars/services.py`)
- Chat services → Chat records: uses chat records (evidence: `chat/services.py`)
- Chat services → Notification service: notifies (evidence: `chat/services.py`)
- Meeting services → Meeting records: uses meeting records (evidence: `meetings/services.py`)
- Meeting services → Chat records: uses chat records (evidence: `meetings/services.py`)
- Meeting services → Notification service: notifies (evidence: `meetings/services.py`)
- Meeting services → Email delivery: sends email (evidence: `meetings/services.py`)
- Meeting realtime → Meeting records: uses meeting records (evidence: `meetings/consumers.py`)
- File storage service → File metadata: uses file metadata (evidence: `files/services.py`)
- File storage service → Supabase Storage: uploads and downloads (evidence: `files/services.py`)
- Notification service → Notification records: creates and queries (evidence: `notifications/services.py`)
- Email delivery → Notification records: checks preferences (evidence: `notifications/email_service.py`)
- Admin services → File storage service: uses storage service (evidence: `admin_panel/services.py`)
- Admin services → Admin records: uses admin records (evidence: `admin_panel/services.py`)
- Backup and restore → Admin records: restores records (evidence: `admin_panel/backup_service.py`)
- Backup and restore → Workspace records: restores records (evidence: `admin_panel/backup_service.py`)
- Backup and restore → Task records: restores records (evidence: `admin_panel/backup_service.py`)
- Backup and restore → Bug records: restores records (evidence: `admin_panel/backup_service.py`)
- Backup and restore → Calendar records: restores records (evidence: `admin_panel/backup_service.py`)
- Backup and restore → Meeting records: restores records (evidence: `admin_panel/backup_service.py`)
- Backup and restore → Notification records: restores records (evidence: `admin_panel/backup_service.py`)
- Backup and restore → File metadata: restores metadata (evidence: `admin_panel/backup_service.py`)
