feat(openapi): upgrade code to gnerate openapi on all path

src/application/dtos/i18n_dto.rs

@@ -1,8 +1,9 @@
 use crate::domain::services::i18n_service::Locale;
 use serde::{Deserialize, Serialize};
+use utoipa::ToSchema;
 
 /// DTO for locale information
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct LocaleDto {
     /// Locale code (e.g., "en", "es")
     pub code: String,
@@ -29,7 +30,7 @@ impl From<Locale> for LocaleDto {
 }
 
 /// DTO for translation request
-#[derive(Debug, Deserialize)]
+#[derive(Debug, Deserialize, ToSchema)]
 pub struct TranslationRequestDto {
     /// The translation key
     pub key: String,
@@ -39,7 +40,7 @@ pub struct TranslationRequestDto {
 }
 
 /// DTO for translation response
-#[derive(Debug, Serialize)]
+#[derive(Debug, Serialize, ToSchema)]
 pub struct TranslationResponseDto {
     /// The translation key
     pub key: String,
@@ -52,7 +53,7 @@ pub struct TranslationResponseDto {
 }
 
 /// DTO for translation error
-#[derive(Debug, Serialize)]
+#[derive(Debug, Serialize, ToSchema)]
 pub struct TranslationErrorDto {
     /// The translation key that was not found
     pub key: String,

src/application/dtos/playlist_dto.rs

@@ -1,8 +1,9 @@
 use crate::domain::entities::playlist::{AudioFileMetadata, Playlist, PlaylistItem};
 use chrono::{DateTime, Utc};
 use serde::{Deserialize, Serialize};
+use utoipa::ToSchema;
 
-#[derive(Debug, Serialize, Deserialize, Clone)]
+#[derive(Debug, Serialize, Deserialize, Clone, ToSchema)]
 pub struct PlaylistDto {
     pub id: String,
     pub name: String,
@@ -58,7 +59,7 @@ impl PlaylistDto {
     }
 }
 
-#[derive(Debug, Serialize, Deserialize, Clone)]
+#[derive(Debug, Serialize, Deserialize, Clone, ToSchema)]
 pub struct PlaylistItemDto {
     pub id: String,
     pub playlist_id: String,
@@ -112,14 +113,14 @@ impl From<PlaylistItem> for PlaylistItemDto {
     }
 }
 
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct CreatePlaylistDto {
     pub name: String,
     pub description: Option<String>,
     pub is_public: Option<bool>,
 }
 
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct UpdatePlaylistDto {
     pub name: Option<String>,
     pub description: Option<String>,
@@ -127,17 +128,17 @@ pub struct UpdatePlaylistDto {
     pub cover_file_id: Option<String>,
 }
 
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct AddTracksDto {
     pub file_ids: Vec<String>,
 }
 
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct ReorderTracksDto {
     pub item_ids: Vec<String>,
 }
 
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct SharePlaylistDto {
     pub user_id: String,
     pub can_write: Option<bool>,

src/application/dtos/settings_dto.rs

@@ -1,4 +1,5 @@
 use serde::{Deserialize, Serialize};
+use utoipa::ToSchema;
 
 // ============================================================================
 // OIDC Settings DTOs (Admin Panel)
@@ -24,7 +25,7 @@ pub struct OidcSettingsDto {
 }
 
 /// Request body for saving OIDC settings from the admin panel
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct SaveOidcSettingsDto {
     pub enabled: bool,
     pub issuer_url: String,
@@ -62,26 +63,26 @@ pub struct OidcTestResultDto {
 // ============================================================================
 
 /// Request body for updating a user's role
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct UpdateUserRoleDto {
     pub role: String,
 }
 
 /// Request body for updating a user's active status
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct UpdateUserActiveDto {
     pub active: bool,
 }
 
 /// Request body for updating a user's storage quota
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct UpdateUserQuotaDto {
     /// Quota in bytes. Use 0 for unlimited.
     pub quota_bytes: i64,
 }
 
 /// Request body for admin-created users
-#[derive(Debug, Serialize, Deserialize, Clone)]
+#[derive(Debug, Serialize, Deserialize, Clone, ToSchema)]
 pub struct AdminCreateUserDto {
     pub username: String,
     pub password: String,
@@ -96,7 +97,7 @@ pub struct AdminCreateUserDto {
 }
 
 /// Request body for admin password reset
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct AdminResetPasswordDto {
     pub new_password: String,
 }
@@ -156,7 +157,7 @@ pub struct StorageSettingsDto {
 }
 
 /// Request body for saving storage settings from the admin panel
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct SaveStorageSettingsDto {
     pub backend: String,
     pub s3_endpoint_url: Option<String>,
@@ -210,14 +211,14 @@ pub struct MigrationStateDto {
 }
 
 /// Request body for `POST /api/admin/storage/migration/start`.
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct StartMigrationDto {
     /// How many blobs to copy in parallel (default: 4).
     pub concurrency: Option<usize>,
 }
 
 /// Request body (empty) for `POST /api/admin/storage/migration/verify`.
-#[derive(Debug, Serialize, Deserialize)]
+#[derive(Debug, Serialize, Deserialize, ToSchema)]
 pub struct VerifyMigrationDto {
     /// Number of random blobs to sample-check (default: 100).
     pub sample_size: Option<usize>,

src/application/ports/chunked_upload_ports.rs

@@ -8,6 +8,7 @@ use crate::common::errors::DomainError;
 use bytes::Bytes;
 use serde::Serialize;
 use std::path::PathBuf;
+use utoipa::ToSchema;
 use uuid::Uuid;
 
 /// Default chunk size (5 MB) — optimised for parallel transfers.
@@ -17,7 +18,7 @@ pub const DEFAULT_CHUNK_SIZE: usize = 5 * 1024 * 1024;
 pub const CHUNKED_UPLOAD_THRESHOLD: usize = 10 * 1024 * 1024;
 
 /// Response returned when a new upload session is created.
-#[derive(Debug, Clone, Serialize)]
+#[derive(Debug, Clone, Serialize, ToSchema)]
 pub struct CreateUploadResponseDto {
     pub upload_id: String,
     pub chunk_size: usize,
@@ -26,7 +27,7 @@ pub struct CreateUploadResponseDto {
 }
 
 /// Response returned after a single chunk is uploaded.
-#[derive(Debug, Clone, Serialize)]
+#[derive(Debug, Clone, Serialize, ToSchema)]
 pub struct ChunkUploadResponseDto {
     pub chunk_index: usize,
     pub bytes_received: u64,
@@ -35,7 +36,7 @@ pub struct ChunkUploadResponseDto {
 }
 
 /// Response for querying upload session status.
-#[derive(Debug, Clone, Serialize)]
+#[derive(Debug, Clone, Serialize, ToSchema)]
 pub struct UploadStatusResponseDto {
     pub upload_id: String,
     pub filename: String,