Oxicloud/doc/storage-quotas.md

11 - Storage Quotas

Per-user storage quotas track disk usage and can limit how much storage each user consumes. Controlled by the feature flag OXICLOUD_ENABLE_USER_STORAGE_QUOTAS (default: false).

Architecture

Layer	Component	File
Application Port	StorageUsagePort trait	src/application/ports/storage_ports.rs
Application Service	StorageUsageService	src/application/services/storage_usage_service.rs
Admin API	/api/admin/users/{id}/quota	src/interfaces/api/handlers/admin_handler.rs

Port Trait

#[async_trait]
pub trait StorageUsagePort: Send + Sync + 'static {
    async fn update_user_storage_usage(&self, user_id: &str) -> Result<i64, DomainError>;
    async fn update_all_users_storage_usage(&self) -> Result<(), DomainError>;
}

How Usage is Calculated

1. Look up the user's username by ID.
2. Find the user's home folder: "Mi Carpeta - {username}" (naming convention).
3. Recursively traverse all subfolders, summing file sizes.
4. Skip directory entries (mime_type = "directory" or "application/directory").
5. Update auth.users.storage_used via UserStoragePort.

update_all_users_storage_usage() processes all users concurrently via tokio::spawn.

Admin Quota Management

Admins set per-user quotas through the admin API:

# Set 10 GB quota for a user
curl -X PUT -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"quota_bytes": 10737418240}' \
  "https://oxicloud.example.com/api/admin/users/{user_id}/quota"

Dashboard Stats

The admin dashboard (GET /api/admin/dashboard) includes quota-related metrics:

{
  "quotas_enabled": true,
  "total_quota_bytes": 107374182400,
  "total_used_bytes": 53687091200,
  "storage_usage_percent": 50.0,
  "users_over_80_percent": 5,
  "users_over_quota": 1
}

Configuration

# Enable storage quotas (default: false)
OXICLOUD_ENABLE_USER_STORAGE_QUOTAS=true

Part of FeaturesConfig in src/common/config.rs:

pub struct FeaturesConfig {
    pub enable_user_storage_quotas: bool,  // default: false
    // ...
}