How rederici/cloud-storage-api works
Cloud Storage API provides authenticated, user-scoped file and directory operations over S3-compatible storage. The principal workflow is an HTTP request through storage routes and service validation/operations to the S3 repository; authentication routes establish sessions used to authorize user requests. The graph also preserves account/session persistence, infrastructure wiring, health routing, and S3 initialization. Source excerpts show key calls, but several adapters and health handlers were not sampled, so uncertain links are omitted.
Main entry points: bootstrap.py App Bootstrap · service.py Auth Service · provider.py Storage Wiring · routes.py Storage Routes
Components 21
HTTP API
- Storage Routes
src/cloud_storage/storage/http/routes.py - Auth Routes
src/cloud_storage/auth/http/routes.py - Auth Dependencies
src/cloud_storage/auth/http/dependencies.py - Health Router
src/cloud_storage/health/http/router.py - HTTP Error Mapping
src/cloud_storage/api/http/exception_handler.py
Domain Services
- Storage Service
src/cloud_storage/storage/service.py - Storage Paths & Types
src/cloud_storage/storage/types.py - Auth Service
src/cloud_storage/auth/service.py - Accounts & Sessions
src/cloud_storage/auth/entities.py
Storage Adapters
- S3 Storage Repository
src/cloud_storage/storage/infrastructure/s3/repository.py - Bucket Initializer
src/cloud_storage/storage/infrastructure/s3/initializer.py - Storage Wiring
src/cloud_storage/storage/infrastructure/s3/provider.py - Account Repository
src/cloud_storage/auth/infrastructure/sqlalchemy/repository.py - Session Repository
src/cloud_storage/auth/infrastructure/redis/repository.py - Password Hasher
src/cloud_storage/auth/infrastructure/argon2/hasher.py
Infrastructure
- App Bootstrap
src/cloud_storage/app/bootstrap.py - Application Config
src/cloud_storage/config/models.py - S3-Compatible Store
- PostgreSQL
- Redis
Other components
- API Client
Connections 23
- API Client → App Bootstrap: requests app
src/cloud_storage/app/bootstrap.py - App Bootstrap → Storage Routes: registers
src/cloud_storage/app/bootstrap.py - App Bootstrap → Auth Routes: registers
src/cloud_storage/app/bootstrap.py - App Bootstrap → Health Router: registers
src/cloud_storage/app/bootstrap.py - App Bootstrap → HTTP Error Mapping: registers handlers
src/cloud_storage/app/bootstrap.py - Storage Routes → Auth Dependencies: uses identity
src/cloud_storage/storage/http/routes.py - Storage Routes → Storage Service: calls operations
src/cloud_storage/storage/http/routes.py - Auth Routes → Auth Service: calls auth
src/cloud_storage/auth/http/routes.py - Auth Dependencies → Auth Service: resolves sessions
src/cloud_storage/auth/http/dependencies.py - Storage Service → S3 Storage Repository: delegates storage
src/cloud_storage/storage/service.py - Storage Service → Storage Paths & Types: scopes paths
src/cloud_storage/storage/service.py - S3 Storage Repository → S3-Compatible Store: reads and writes
src/cloud_storage/storage/infrastructure/s3/repository.py - Storage Wiring → S3 Storage Repository: provides repository
src/cloud_storage/storage/infrastructure/s3/provider.py - Storage Wiring → Bucket Initializer: configures initializer
src/cloud_storage/storage/infrastructure/s3/provider.py - Bucket Initializer → S3-Compatible Store: initializes bucket
src/cloud_storage/storage/infrastructure/s3/initializer.py - Auth Service → Account Repository: uses accounts
src/cloud_storage/auth/service.py - Auth Service → Session Repository: uses sessions
src/cloud_storage/auth/service.py - Auth Service → Password Hasher: hashes passwords
src/cloud_storage/auth/service.py - Account Repository → PostgreSQL: persists accounts
- Session Repository → Redis: persists sessions
- App Bootstrap → Application Config: loads settings
src/cloud_storage/app/bootstrap.py - Storage Wiring → Application Config: reads settings
src/cloud_storage/storage/infrastructure/s3/provider.py - Auth Service → Accounts & Sessions: uses domain records
src/cloud_storage/auth/service.py