# rajshekharbind/cloudvault architecture

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

- Interactive diagram: https://gitdiagram.com/rajshekharbind/cloudvault
- Repository: https://github.com/rajshekharbind/cloudvault

## Overview

CloudVault Sentinel is a Django file-storage and collaboration application. Users authenticate, manage files and folders, and receive file lifecycle and security operations through the storage views; sharing, account management, and activity monitoring are related product branches. File metadata, versions, security scans, sharing records, and activity are represented by Django models. README capabilities such as organizations, OAuth, and semantic search are not treated as implemented components because the supplied tree and excerpts do not establish them. Relationships below are limited to cited source references and explicit documentation; substantial unsampled modules are represented at their exact paths.

Main entry points: [`storage/views.py`](https://github.com/rajshekharbind/cloudvault/blob/main/storage/views.py) (File operations), [`sharing/views.py`](https://github.com/rajshekharbind/cloudvault/blob/main/sharing/views.py) (Sharing flows), [`accounts/views.py`](https://github.com/rajshekharbind/cloudvault/blob/main/accounts/views.py) (Account flows), [`storage/models.py`](https://github.com/rajshekharbind/cloudvault/blob/main/storage/models.py) (File records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts"]
  node_account_views["Account flows<br/>[views.py]"]
  node_account_data[("Account records<br/>[models.py]")]
  node_account_serializers["Account serializers<br/>[serializers.py]"]
end

subgraph group_storage["File Storage"]
  node_storage_views["File operations<br/>[views.py]"]
  node_file_data[("File records<br/>[models.py]")]
  node_file_serializers["File serializers<br/>[serializers.py]"]
  node_file_utils["File utilities<br/>[utils.py]"]
  node_security_rag["Security analysis<br/>[security_rag.py]"]
end

subgraph group_sharing["Sharing"]
  node_sharing_views["Sharing flows<br/>[views.py]"]
  node_sharing_data[("Share records<br/>[models.py]")]
  node_sharing_serializers["Share serializers<br/>[serializers.py]"]
end

subgraph group_analytics["Activity &amp; Security"]
  node_activity_views["Activity APIs<br/>[views.py]"]
  node_activity_data[("Activity records<br/>[models.py]")]
  node_activity_socket["Activity websocket<br/>[consumers.py]"]
  node_socket_routes["Websocket routes<br/>[routing.py]"]
end

node_user(("User"))
node_file_objects[("File object storage")]

node_user -->|"authenticates"| node_account_views
node_account_views -->|"creates users"| node_account_data
node_account_views -->|"serializes users"| node_account_serializers
node_user -.->|"manages files"| node_storage_views
node_storage_views -->|"reads and writes"| node_file_data
node_storage_views -->|"serializes files"| node_file_serializers
node_file_data -->|"uses helpers"| node_file_utils
node_storage_views -->|"requests reports"| node_security_rag
node_storage_views -.->|"stores file data"| node_file_objects
node_user -.->|"shares files"| node_sharing_views
node_sharing_views -->|"reads and writes"| node_sharing_data
node_sharing_views -->|"selects shared files"| node_file_data
node_sharing_views -->|"serializes shares"| node_sharing_serializers
node_sharing_serializers -->|"embeds file details"| node_file_serializers
node_user -.->|"reviews activity"| node_activity_views
node_activity_views -->|"reads activity"| node_activity_data
node_activity_data -->|"publishes events"| node_activity_socket
node_socket_routes -->|"routes websocket"| node_activity_socket

click node_account_views "https://github.com/rajshekharbind/cloudvault/blob/main/accounts/views.py"
click node_account_data "https://github.com/rajshekharbind/cloudvault/blob/main/accounts/models.py"
click node_account_serializers "https://github.com/rajshekharbind/cloudvault/blob/main/accounts/serializers.py"
click node_storage_views "https://github.com/rajshekharbind/cloudvault/blob/main/storage/views.py"
click node_file_data "https://github.com/rajshekharbind/cloudvault/blob/main/storage/models.py"
click node_file_serializers "https://github.com/rajshekharbind/cloudvault/blob/main/storage/serializers.py"
click node_file_utils "https://github.com/rajshekharbind/cloudvault/blob/main/storage/utils.py"
click node_security_rag "https://github.com/rajshekharbind/cloudvault/blob/main/storage/security_rag.py"
click node_sharing_views "https://github.com/rajshekharbind/cloudvault/blob/main/sharing/views.py"
click node_sharing_data "https://github.com/rajshekharbind/cloudvault/blob/main/sharing/models.py"
click node_sharing_serializers "https://github.com/rajshekharbind/cloudvault/blob/main/sharing/serializers.py"
click node_activity_views "https://github.com/rajshekharbind/cloudvault/blob/main/analytics/views.py"
click node_activity_data "https://github.com/rajshekharbind/cloudvault/blob/main/analytics/models.py"
click node_activity_socket "https://github.com/rajshekharbind/cloudvault/blob/main/analytics/consumers.py"
click node_socket_routes "https://github.com/rajshekharbind/cloudvault/blob/main/analytics/routing.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_data,node_account_serializers,node_user toneBlue
class node_storage_views,node_file_data,node_file_serializers,node_file_utils,node_security_rag,node_file_objects toneAmber
class node_sharing_views,node_sharing_data,node_sharing_serializers toneMint
class node_activity_views,node_activity_data,node_activity_socket,node_socket_routes toneRose
```

## Components

### Accounts

- [Account flows](https://github.com/rajshekharbind/cloudvault/blob/main/accounts/views.py): `accounts/views.py`
- [Account records](https://github.com/rajshekharbind/cloudvault/blob/main/accounts/models.py): `accounts/models.py`
- [Account serializers](https://github.com/rajshekharbind/cloudvault/blob/main/accounts/serializers.py): `accounts/serializers.py`

### File Storage

- [File operations](https://github.com/rajshekharbind/cloudvault/blob/main/storage/views.py): `storage/views.py`
- [File records](https://github.com/rajshekharbind/cloudvault/blob/main/storage/models.py): `storage/models.py`
- [File serializers](https://github.com/rajshekharbind/cloudvault/blob/main/storage/serializers.py): `storage/serializers.py`
- [File utilities](https://github.com/rajshekharbind/cloudvault/blob/main/storage/utils.py): `storage/utils.py`
- [Security analysis](https://github.com/rajshekharbind/cloudvault/blob/main/storage/security_rag.py): `storage/security_rag.py`

### Sharing

- [Sharing flows](https://github.com/rajshekharbind/cloudvault/blob/main/sharing/views.py): `sharing/views.py`
- [Share records](https://github.com/rajshekharbind/cloudvault/blob/main/sharing/models.py): `sharing/models.py`
- [Share serializers](https://github.com/rajshekharbind/cloudvault/blob/main/sharing/serializers.py): `sharing/serializers.py`

### Activity & Security

- [Activity APIs](https://github.com/rajshekharbind/cloudvault/blob/main/analytics/views.py): `analytics/views.py`
- [Activity records](https://github.com/rajshekharbind/cloudvault/blob/main/analytics/models.py): `analytics/models.py`
- [Activity websocket](https://github.com/rajshekharbind/cloudvault/blob/main/analytics/consumers.py): `analytics/consumers.py`
- [Websocket routes](https://github.com/rajshekharbind/cloudvault/blob/main/analytics/routing.py): `analytics/routing.py`

### Other components

- **User**
- **File object storage**

## Connections

- User → Account flows: authenticates (evidence: `accounts/views.py`)
- Account flows → Account records: creates users (evidence: `accounts/views.py`)
- Account flows → Account serializers: serializes users (evidence: `accounts/views.py`)
- User → File operations: manages files
- File operations → File records: reads and writes (evidence: `storage/views.py`)
- File operations → File serializers: serializes files (evidence: `storage/views.py`)
- File records → File utilities: uses helpers (evidence: `storage/models.py`)
- File operations → Security analysis: requests reports (evidence: `storage/views.py`)
- File operations → File object storage: stores file data
- User → Sharing flows: shares files
- Sharing flows → Share records: reads and writes (evidence: `sharing/views.py`)
- Sharing flows → File records: selects shared files (evidence: `sharing/views.py`)
- Sharing flows → Share serializers: serializes shares (evidence: `sharing/views.py`)
- Share serializers → File serializers: embeds file details (evidence: `sharing/serializers.py`)
- User → Activity APIs: reviews activity
- Activity APIs → Activity records: reads activity (evidence: `analytics/views.py`)
- Activity records → Activity websocket: publishes events (evidence: `analytics/models.py`)
- Websocket routes → Activity websocket: routes websocket (evidence: `analytics/routing.py`)
