# jangili9/filerise architecture

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

- Interactive diagram: https://gitdiagram.com/jangili9/filerise
- Repository: https://github.com/jangili9/filerise

## Overview

FileRise is a self-hosted PHP file manager and storage hub. Users browse and manage files through the web app, with authentication and per-folder ACLs governing operations across storage sources; uploads, sharing, previews, trash, and optional encryption extend that workflow. The repository also exposes WebDAV and optional OnlyOffice integration, plus Pro capabilities for portals, automation, search, audit, gateways, and AI. Some Pro implementations are not sampled, so those branches are represented at their existing API-directory paths; edges reflect documented capabilities or visible source references.

Main entry points: [`public/index.php`](https://github.com/jangili9/filerise/blob/master/public/index.php) (Web interface), [`src/FileRise/Http/Controllers/FolderController.php`](https://github.com/jangili9/filerise/blob/master/src/FileRise/Http/Controllers/FolderController.php) (Folder operations), [`src/FileRise/Http/Controllers/FileController.php`](https://github.com/jangili9/filerise/blob/master/src/FileRise/Http/Controllers/FileController.php) (File operations), [`src/FileRise/Support/ACL.php`](https://github.com/jangili9/filerise/blob/master/src/FileRise/Support/ACL.php) (Access control)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and UI"]
  node_web["Web interface<br/>[index.php]"]
  node_auth["Authentication<br/>[AuthModel.php]"]
  node_users["User management<br/>[UserModel.php]"]
end

subgraph group_files["File workflows"]
  node_file_api["File operations<br/>[FileController.php]"]
  node_folder_api["Folder operations"]
  node_uploads["Uploads<br/>[UploadModel.php]"]
  node_media["Media progress<br/>[MediaModel.php]"]
end

subgraph group_storage["Storage and policy"]
  node_acl["Access control<br/>[ACL.php]"]
  node_folder_crypto["Folder encryption<br/>[FolderCrypto.php]"]
  node_sources["Storage sources<br/>[SourceContext.php]"]
  node_source_config["Source configuration<br/>[SourcesConfig.php]"]
  node_storage_registry["Storage registry"]
  node_storage_factory["Adapter factory<br/>[StorageFactory.php]"]
  node_adapter["Storage adapter"]
  node_local_storage["Local storage<br/>[LocalFsAdapter.php]"]
end

subgraph group_integration["External access"]
  node_webdav["WebDAV access"]
  node_office["OnlyOffice integration"]
end

subgraph group_pro["Pro capabilities"]
  node_portals["Client portals"]
  node_automation["Automation"]
  node_search_audit["Search and audit"]
  node_ai["AI workspace"]
  node_gateways["Gateway shares"]
  node_groups["User groups"]
end

node_user(("User"))

node_user -->|"browses"| node_web
node_web -->|"authenticates"| node_auth
node_web -->|"manages files"| node_file_api
node_web -->|"manages folders"| node_folder_api
node_web -->|"uploads files"| node_uploads
node_web -->|"tracks playback"| node_media
node_file_api -->|"checks access"| node_acl
node_folder_api -->|"checks access"| node_acl
node_file_api -->|"delegates moves"| node_folder_api
node_file_api -->|"uses storage"| node_storage_registry
node_folder_api -->|"uses storage"| node_storage_registry
node_folder_api -->|"sets encryption"| node_folder_crypto
node_storage_registry -->|"creates adapters"| node_storage_factory
node_storage_factory -->|"returns adapter"| node_adapter
node_storage_factory -->|"instantiates"| node_local_storage
node_sources -->|"loads sources"| node_source_config
node_webdav -->|"honors permissions"| node_acl
node_user -->|"mounts drive"| node_webdav
node_web -.->|"edits documents"| node_office
node_user -->|"submits files"| node_portals
node_automation -.->|"runs workflows"| node_user
node_user -->|"searches and reviews"| node_search_audit
node_user -->|"uses copilots"| node_ai
node_user -->|"shares sources"| node_gateways
node_groups -.->|"informs permissions"| node_acl
node_auth -->|"uses accounts"| node_users

click node_web "https://github.com/jangili9/filerise/blob/master/public/index.php"
click node_auth "https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/AuthModel.php"
click node_users "https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/UserModel.php"
click node_file_api "https://github.com/jangili9/filerise/blob/master/src/FileRise/Http/Controllers/FileController.php"
click node_folder_api "https://github.com/jangili9/filerise/blob/master/src/FileRise/Http/Controllers/FolderController.php"
click node_uploads "https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/UploadModel.php"
click node_media "https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/MediaModel.php"
click node_acl "https://github.com/jangili9/filerise/blob/master/src/FileRise/Support/ACL.php"
click node_folder_crypto "https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/FolderCrypto.php"
click node_sources "https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/SourceContext.php"
click node_source_config "https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/SourcesConfig.php"
click node_storage_registry "https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/StorageRegistry.php"
click node_storage_factory "https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/StorageFactory.php"
click node_adapter "https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/StorageAdapterInterface.php"
click node_local_storage "https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/LocalFsAdapter.php"
click node_webdav "https://github.com/jangili9/filerise/blob/master/src/FileRise/WebDAV/FileRiseDirectory.php"
click node_office "https://github.com/jangili9/filerise/blob/master/src/FileRise/Http/Controllers/OnlyOfficeController.php"
click node_portals "https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/ProPortalsApiService.php"
click node_automation "https://github.com/jangili9/filerise/tree/master/public/api/pro/automation"
click node_search_audit "https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/ProSearchApiService.php"
click node_ai "https://github.com/jangili9/filerise/tree/master/public/api/pro/ai"
click node_gateways "https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/ProGatewayApiService.php"
click node_groups "https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/ProGroupsApiService.php"

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_web,node_auth,node_users,node_user toneBlue
class node_file_api,node_folder_api,node_uploads,node_media toneAmber
class node_acl,node_folder_crypto,node_sources,node_source_config,node_storage_registry,node_storage_factory,node_adapter,node_local_storage toneMint
class node_webdav,node_office toneRose
class node_portals,node_automation,node_search_audit,node_ai,node_gateways,node_groups toneIndigo
```

## Components

### Access and UI

- [Web interface](https://github.com/jangili9/filerise/blob/master/public/index.php): `public/index.php`
- [Authentication](https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/AuthModel.php): `src/FileRise/Domain/AuthModel.php`
- [User management](https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/UserModel.php): `src/FileRise/Domain/UserModel.php`

### File workflows

- [File operations](https://github.com/jangili9/filerise/blob/master/src/FileRise/Http/Controllers/FileController.php): `src/FileRise/Http/Controllers/FileController.php`
- [Folder operations](https://github.com/jangili9/filerise/blob/master/src/FileRise/Http/Controllers/FolderController.php): `src/FileRise/Http/Controllers/FolderController.php`
- [Uploads](https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/UploadModel.php): `src/FileRise/Domain/UploadModel.php`
- [Media progress](https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/MediaModel.php): `src/FileRise/Domain/MediaModel.php`

### Storage and policy

- [Access control](https://github.com/jangili9/filerise/blob/master/src/FileRise/Support/ACL.php): `src/FileRise/Support/ACL.php`
- [Folder encryption](https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/FolderCrypto.php): `src/FileRise/Domain/FolderCrypto.php`
- [Storage sources](https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/SourceContext.php): `src/FileRise/Storage/SourceContext.php`
- [Source configuration](https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/SourcesConfig.php): `src/FileRise/Storage/SourcesConfig.php`
- [Storage registry](https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/StorageRegistry.php): `src/FileRise/Storage/StorageRegistry.php`
- [Adapter factory](https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/StorageFactory.php): `src/FileRise/Storage/StorageFactory.php`
- [Storage adapter](https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/StorageAdapterInterface.php): `src/FileRise/Storage/StorageAdapterInterface.php`
- [Local storage](https://github.com/jangili9/filerise/blob/master/src/FileRise/Storage/LocalFsAdapter.php): `src/FileRise/Storage/LocalFsAdapter.php`

### External access

- [WebDAV access](https://github.com/jangili9/filerise/blob/master/src/FileRise/WebDAV/FileRiseDirectory.php): `src/FileRise/WebDAV/FileRiseDirectory.php`
- [OnlyOffice integration](https://github.com/jangili9/filerise/blob/master/src/FileRise/Http/Controllers/OnlyOfficeController.php): `src/FileRise/Http/Controllers/OnlyOfficeController.php`

### Pro capabilities

- [Client portals](https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/ProPortalsApiService.php): `src/FileRise/Domain/ProPortalsApiService.php`
- [Automation](https://github.com/jangili9/filerise/tree/master/public/api/pro/automation): `public/api/pro/automation`
- [Search and audit](https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/ProSearchApiService.php): `src/FileRise/Domain/ProSearchApiService.php`
- [AI workspace](https://github.com/jangili9/filerise/tree/master/public/api/pro/ai): `public/api/pro/ai`
- [Gateway shares](https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/ProGatewayApiService.php): `src/FileRise/Domain/ProGatewayApiService.php`
- [User groups](https://github.com/jangili9/filerise/blob/master/src/FileRise/Domain/ProGroupsApiService.php): `src/FileRise/Domain/ProGroupsApiService.php`

### Other components

- **User**

## Connections

- User → Web interface: browses (evidence: `README.md`)
- Web interface → Authentication: authenticates (evidence: `README.md`)
- Web interface → File operations: manages files (evidence: `README.md`)
- Web interface → Folder operations: manages folders (evidence: `README.md`)
- Web interface → Uploads: uploads files (evidence: `README.md`)
- Web interface → Media progress: tracks playback (evidence: `README.md`)
- File operations → Access control: checks access (evidence: `src/FileRise/Http/Controllers/FileController.php`)
- Folder operations → Access control: checks access (evidence: `src/FileRise/Http/Controllers/FolderController.php`)
- File operations → Folder operations: delegates moves (evidence: `src/FileRise/Http/Controllers/FileController.php`)
- File operations → Storage registry: uses storage (evidence: `src/FileRise/Http/Controllers/FileController.php`)
- Folder operations → Storage registry: uses storage (evidence: `src/FileRise/Http/Controllers/FolderController.php`)
- Folder operations → Folder encryption: sets encryption (evidence: `src/FileRise/Http/Controllers/FolderController.php`)
- Storage registry → Adapter factory: creates adapters (evidence: `src/FileRise/Storage/StorageRegistry.php`)
- Adapter factory → Storage adapter: returns adapter (evidence: `src/FileRise/Storage/StorageFactory.php`)
- Adapter factory → Local storage: instantiates (evidence: `src/FileRise/Storage/StorageFactory.php`)
- Storage sources → Source configuration: loads sources (evidence: `src/FileRise/Storage/SourceContext.php`)
- WebDAV access → Access control: honors permissions (evidence: `README.md`)
- User → WebDAV access: mounts drive (evidence: `README.md`)
- Web interface → OnlyOffice integration: edits documents (evidence: `README.md`)
- User → Client portals: submits files (evidence: `README.md`)
- Automation → User: runs workflows (evidence: `README.md`)
- User → Search and audit: searches and reviews (evidence: `README.md`)
- User → AI workspace: uses copilots (evidence: `README.md`)
- User → Gateway shares: shares sources (evidence: `README.md`)
- User groups → Access control: informs permissions (evidence: `README.md`)
- Authentication → User management: uses accounts (evidence: `src/FileRise/Domain/AuthModel.php`)
