How gonzalopinheiro/homedb works
HomeDB is a self-hosted file and account management API: authenticated users can upload files and organize folders, while administrators manage users, permissions, backups, logs, and monitoring. The main request path is HTTP controller to application service, then repositories and storage, returning API responses. Additional branches provide authentication, auditing, background backup and monitoring, and asynchronous operational logging. The README contains no capability detail; those branches reflect the source tree. Unsampled controller/service links are documented here only where the supplied source index or excerpts support them.
Main entry points: Controllers API controllers · Repositories Data repositories · AuthService.cs Authentication · UploadService.cs Chunked uploads
Components 24
HTTP API
- API controllers
HomeDB/Controllers
Application services
- Authentication
HomeDB.Application/Services/AuthService.cs - File management
HomeDB.Application/Services/FilesService.cs - Folder management
HomeDB.Application/Services/FoldersService.cs - Chunked uploads
HomeDB.Application/Services/UploadService.cs - User administration
HomeDB.Application/Services/UserAdminSettingsService.cs - Module permissions
HomeDB.Application/Services/UserModulePermissionsService.cs - Backup orchestration
HomeDB.Application/Services/BackupService.cs - Audit service
HomeDB.Application/Services/AuditService.cs - Metrics service
HomeDB.Application/Services/SystemMetricsService.cs
Infrastructure
- Application logging
HomeDB.Infrastructure/Observability/Logger.cs - Operation scope
HomeDB.Infrastructure/Observability/OperationLogScope.cs - Log worker
HomeDB.Infrastructure/Observability/LogBackgroundService.cs - File storage
HomeDB.Infrastructure/Storage/FileStorageService.cs - System readers
HomeDB.Infrastructure/SystemMonitoring/LinuxSystemMetricsReader.cs - Backup process
HomeDB.Infrastructure/Backup/BackupProcessService.cs - Application database
HomeDB.Infrastructure/Data/AppDbContext.cs - Data repositories
HomeDB.Infrastructure/Repositories
Operations and admin
- Module authorization
HomeDB/Authorization/Handlers/ModuleAuthorizationHandler.cs - Error responses
HomeDB/Middlewares/ExceptionHandlerMiddleware.cs - Metrics worker
HomeDB.Infrastructure/SystemMonitoring/SystemMetricsBackgroundService.cs - Backup worker
HomeDB.Infrastructure/Backup/BackupBackgroundService.cs - Upload cleanup
HomeDB.Infrastructure/Storage/UploadCleanupBackgroundService.cs
Other components
- API client
Connections 30
- API client → API controllers: sends requests
HomeDB/Controllers/AuthController.cs - API controllers → Authentication: invokes
HomeDB/Controllers/AuthController.cs - API controllers → File management: invokes
HomeDB/Controllers/FilesController.cs - API controllers → Folder management: invokes
- API controllers → Chunked uploads: invokes
- API controllers → User administration: invokes
HomeDB/Controllers/UsersSettingsController.cs - API controllers → Module permissions: invokes
- API controllers → Backup orchestration: invokes
- API controllers → Audit service: invokes
- API controllers → Metrics service: invokes
- Authentication → Audit service: records events
HomeDB.Application/Services/AuthService.cs - Authentication → Data repositories: uses data access
HomeDB.Application/Services/AuthService.cs - Chunked uploads → File storage: stores files
HomeDB.Application/Services/UploadService.cs - Chunked uploads → Data repositories: uses data access
HomeDB.Application/Services/UploadService.cs - User administration → Data repositories: uses data access
- Module permissions → Data repositories: uses data access
- Backup orchestration → Backup process: runs process
- Backup worker → Backup process: dispatches
- Metrics worker → Metrics service: updates metrics
HomeDB.Infrastructure/SystemMonitoring/SystemMetricsBackgroundService.cs - Metrics worker → System readers: reads system
- Metrics service → Data repositories: uses data access
- Data repositories → Application database: reads and writes
HomeDB.Infrastructure/Repositories/UploadSessionRepository.cs - API controllers → Module authorization: checks access
- Module authorization → Module permissions: checks permissions
HomeDB/Authorization/Handlers/ModuleAuthorizationHandler.cs - API controllers → Error responses: handled by pipeline
- Error responses → Application logging: logs failures
HomeDB/Middlewares/ExceptionHandlerMiddleware.cs - Operation scope → Application logging: logs scope
HomeDB.Infrastructure/Observability/OperationLogScope.cs - Application logging → Log worker: enqueues entries
HomeDB.Infrastructure/Observability/Logger.cs - Log worker → Data repositories: persists entries
HomeDB.Infrastructure/Observability/LogBackgroundService.cs - Upload cleanup → Data repositories: cleans sessions