# samirbekjs/smb architecture

> Architecture diagram of the GitHub repository samirbekjs/smb, 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/samirbekjs/smb
- Repository: https://github.com/samirbekjs/smb

## Overview

SuperMediaBase is an offline, LAN-hosted Django file repository. Users sign in, browse and manage folders, upload or download content, and share it with teams or links; uploads are checked and stored as deduplicated blobs. The graph includes documented admin, setup, chat, quota, audit, and background-task capabilities. Several view modules were not excerpted, so edges based on the SOURCE INDEX are limited to references it records; unverified wiring is omitted.

Main entry points: [`src/uploads/views.py`](https://github.com/samirbekjs/smb/blob/master/src/uploads/views.py) (Chunked uploads), [`src/storage/backends.py`](https://github.com/samirbekjs/smb/blob/master/src/storage/backends.py) (Storage backends), [`src/tasks/runner.py`](https://github.com/samirbekjs/smb/blob/master/src/tasks/runner.py) (Background task runner), [`src/audit/services.py`](https://github.com/samirbekjs/smb/blob/master/src/audit/services.py) (Audit log)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and teams"]
  node_accounts["Accounts and sessions<br/>[models.py]"]
  node_teams["Teams and roles<br/>[models.py]"]
  node_team_views["Team management<br/>[views.py]"]
  node_permissions["Access checks<br/>[permissions.py]"]
end

subgraph group_files["File workflows"]
  node_library_views["Explorer actions<br/>[views.py]"]
  node_library_services["Library operations<br/>[services.py]"]
  node_sharing["Sharing links<br/>[views.py]"]
  node_uploads["Chunked uploads<br/>[views.py]"]
  node_upload_sessions["Upload sessions<br/>[models.py]"]
  node_chat["Chat<br/>[services.py]"]
end

subgraph group_platform["Storage and operations"]
  node_content[("File and blob records<br/>[models.py]")]
  node_storage["Storage backends<br/>[backends.py]"]
  node_physical_store[("Filesystem store")]
  node_s3[("S3 / MinIO")]
  node_worker["Background task runner<br/>[runner.py]"]
  node_quotas["Quota accounting<br/>[services.py]"]
  node_audit[("Audit log<br/>[services.py]")]
end

subgraph group_interfaces["User interfaces"]
  node_browser["Browser UI"]
  node_admin["Admin panel<br/>[views.py]"]
  node_setup["Setup wizard<br/>[views.py]"]
  node_project["Django application<br/>[urls.py]"]
end

node_user(("LAN user"))

node_user -->|"uses"| node_browser
node_browser -.->|"requests"| node_project
node_project -.->|"routes to"| node_library_views
node_project -.->|"routes to"| node_uploads
node_project -.->|"routes to"| node_team_views
node_library_views -->|"calls"| node_library_services
node_library_views -->|"checks access"| node_permissions
node_library_views -->|"uses links"| node_sharing
node_library_services -->|"checks access"| node_permissions
node_library_services -->|"updates quota"| node_quotas
node_library_services -->|"records actions"| node_audit
node_uploads -->|"tracks uploads"| node_upload_sessions
node_uploads -->|"stores content"| node_storage
node_uploads -->|"queues verification"| node_worker
node_uploads -->|"checks quota"| node_quotas
node_uploads -->|"records uploads"| node_audit
node_worker -->|"verifies blobs"| node_storage
node_worker -->|"updates status"| node_content
node_worker -->|"records outcomes"| node_audit
node_storage -.->|"reads and writes"| node_physical_store
node_storage -.->|"uses backend"| node_s3
node_team_views -->|"manages"| node_teams
node_team_views -->|"records changes"| node_audit
node_sharing -->|"checks access"| node_permissions
node_sharing -->|"records access"| node_audit
node_admin -->|"manages"| node_accounts
node_admin -->|"uses accounting"| node_quotas
node_admin -->|"uses task runner"| node_worker
node_setup -->|"configures backend"| node_storage
node_setup -->|"creates administrator"| node_accounts
node_chat -->|"uses blobs"| node_content
node_chat -->|"uses storage"| node_storage

click node_browser "https://github.com/samirbekjs/smb/tree/master/src/ui"
click node_accounts "https://github.com/samirbekjs/smb/blob/master/src/accounts/models.py"
click node_teams "https://github.com/samirbekjs/smb/blob/master/src/teams/models.py"
click node_team_views "https://github.com/samirbekjs/smb/blob/master/src/teams/views.py"
click node_library_views "https://github.com/samirbekjs/smb/blob/master/src/library/views.py"
click node_library_services "https://github.com/samirbekjs/smb/blob/master/src/library/services.py"
click node_permissions "https://github.com/samirbekjs/smb/blob/master/src/library/permissions.py"
click node_sharing "https://github.com/samirbekjs/smb/blob/master/src/sharing/views.py"
click node_uploads "https://github.com/samirbekjs/smb/blob/master/src/uploads/views.py"
click node_upload_sessions "https://github.com/samirbekjs/smb/blob/master/src/uploads/models.py"
click node_content "https://github.com/samirbekjs/smb/blob/master/src/storage/models.py"
click node_storage "https://github.com/samirbekjs/smb/blob/master/src/storage/backends.py"
click node_worker "https://github.com/samirbekjs/smb/blob/master/src/tasks/runner.py"
click node_quotas "https://github.com/samirbekjs/smb/blob/master/src/quotas/services.py"
click node_audit "https://github.com/samirbekjs/smb/blob/master/src/audit/services.py"
click node_admin "https://github.com/samirbekjs/smb/blob/master/src/adminpanel/views.py"
click node_setup "https://github.com/samirbekjs/smb/blob/master/src/setupwizard/views.py"
click node_chat "https://github.com/samirbekjs/smb/blob/master/src/chat/services.py"
click node_project "https://github.com/samirbekjs/smb/blob/master/src/smb_project/urls.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_accounts,node_teams,node_team_views,node_permissions,node_user toneBlue
class node_library_views,node_library_services,node_sharing,node_uploads,node_upload_sessions,node_chat toneAmber
class node_content,node_storage,node_physical_store,node_s3,node_worker,node_quotas,node_audit toneMint
class node_browser,node_admin,node_setup,node_project toneRose
```

## Components

### Access and teams

- [Accounts and sessions](https://github.com/samirbekjs/smb/blob/master/src/accounts/models.py): `src/accounts/models.py`
- [Teams and roles](https://github.com/samirbekjs/smb/blob/master/src/teams/models.py): `src/teams/models.py`
- [Team management](https://github.com/samirbekjs/smb/blob/master/src/teams/views.py): `src/teams/views.py`
- [Access checks](https://github.com/samirbekjs/smb/blob/master/src/library/permissions.py): `src/library/permissions.py`

### File workflows

- [Explorer actions](https://github.com/samirbekjs/smb/blob/master/src/library/views.py): `src/library/views.py`
- [Library operations](https://github.com/samirbekjs/smb/blob/master/src/library/services.py): `src/library/services.py`
- [Sharing links](https://github.com/samirbekjs/smb/blob/master/src/sharing/views.py): `src/sharing/views.py`
- [Chunked uploads](https://github.com/samirbekjs/smb/blob/master/src/uploads/views.py): `src/uploads/views.py`
- [Upload sessions](https://github.com/samirbekjs/smb/blob/master/src/uploads/models.py): `src/uploads/models.py`
- [Chat](https://github.com/samirbekjs/smb/blob/master/src/chat/services.py): `src/chat/services.py`

### Storage and operations

- [File and blob records](https://github.com/samirbekjs/smb/blob/master/src/storage/models.py): `src/storage/models.py`
- [Storage backends](https://github.com/samirbekjs/smb/blob/master/src/storage/backends.py): `src/storage/backends.py`
- **Filesystem store**
- **S3 / MinIO**
- [Background task runner](https://github.com/samirbekjs/smb/blob/master/src/tasks/runner.py): `src/tasks/runner.py`
- [Quota accounting](https://github.com/samirbekjs/smb/blob/master/src/quotas/services.py): `src/quotas/services.py`
- [Audit log](https://github.com/samirbekjs/smb/blob/master/src/audit/services.py): `src/audit/services.py`

### User interfaces

- [Browser UI](https://github.com/samirbekjs/smb/tree/master/src/ui): `src/ui`
- [Admin panel](https://github.com/samirbekjs/smb/blob/master/src/adminpanel/views.py): `src/adminpanel/views.py`
- [Setup wizard](https://github.com/samirbekjs/smb/blob/master/src/setupwizard/views.py): `src/setupwizard/views.py`
- [Django application](https://github.com/samirbekjs/smb/blob/master/src/smb_project/urls.py): `src/smb_project/urls.py`

### Other components

- **LAN user**

## Connections

- LAN user → Browser UI: uses
- Browser UI → Django application: requests
- Django application → Explorer actions: routes to
- Django application → Chunked uploads: routes to
- Django application → Team management: routes to
- Explorer actions → Library operations: calls (evidence: `src/library/views.py`)
- Explorer actions → Access checks: checks access (evidence: `src/library/views.py`)
- Explorer actions → Sharing links: uses links (evidence: `src/library/views.py`)
- Library operations → Access checks: checks access (evidence: `src/library/services.py`)
- Library operations → Quota accounting: updates quota (evidence: `src/library/services.py`)
- Library operations → Audit log: records actions (evidence: `src/library/services.py`)
- Chunked uploads → Upload sessions: tracks uploads (evidence: `src/uploads/views.py`)
- Chunked uploads → Storage backends: stores content (evidence: `src/uploads/views.py`)
- Chunked uploads → Background task runner: queues verification (evidence: `src/uploads/views.py`)
- Chunked uploads → Quota accounting: checks quota (evidence: `src/uploads/views.py`)
- Chunked uploads → Audit log: records uploads (evidence: `src/uploads/views.py`)
- Background task runner → Storage backends: verifies blobs (evidence: `src/tasks/runner.py`)
- Background task runner → File and blob records: updates status (evidence: `src/tasks/runner.py`)
- Background task runner → Audit log: records outcomes (evidence: `src/tasks/runner.py`)
- Storage backends → Filesystem store: reads and writes
- Storage backends → S3 / MinIO: uses backend
- Team management → Teams and roles: manages (evidence: `src/teams/views.py`)
- Team management → Audit log: records changes (evidence: `src/teams/views.py`)
- Sharing links → Access checks: checks access (evidence: `src/sharing/views.py`)
- Sharing links → Audit log: records access (evidence: `src/sharing/views.py`)
- Admin panel → Accounts and sessions: manages (evidence: `src/adminpanel/views.py`)
- Admin panel → Quota accounting: uses accounting (evidence: `src/adminpanel/views.py`)
- Admin panel → Background task runner: uses task runner (evidence: `src/adminpanel/views.py`)
- Setup wizard → Storage backends: configures backend (evidence: `src/setupwizard/views.py`)
- Setup wizard → Accounts and sessions: creates administrator (evidence: `src/setupwizard/views.py`)
- Chat → File and blob records: uses blobs (evidence: `src/chat/services.py`)
- Chat → Storage backends: uses storage (evidence: `src/chat/services.py`)
