docs(openapi): add descriptions to OpenAPI specification (#25185)

* faces

* add openapi descriptions

* remove dto descriptions

* gen openapi

* dtos

* fix dtos

* fix more

* fix build

* more

* complete dtos

* descriptions on rebase

* gen rebase

* revert correct integer type conversion

* gen after revert

* revert correct nullables

* regen after revert

* actually incorrect adding default here

* revert correct number type conversion

* regen after revert

* revert nullable usage

* regen fully

* readd some comments

* one more

* one more

* use enum

* add missing

* add missing controllers

* add missing dtos

* complete it

* more

* describe global key and slug

* add remaining body and param descriptions

* lint and format

* cleanup

* response and schema descriptions

* test patch according to suggestion

* revert added api response objects

* revert added api body objects

* revert added api param object

* revert added api query objects

* revert reorganized http code objects

* revert reorganize ApiOkResponse objects

* revert added api response objects (2)

* revert added api tag object

* revert added api schema objects

* migrate missing asset.dto.ts

* regenerate openapi builds

* delete generated mustache files

* remove descriptions from properties that are schemas

* lint

* revert nullable type changes

* revert int/num type changes

* remove explicit default

* readd comment

* lint

* pr fixes

* last bits and pieces

* lint and format

* chore: remove rejected patches

* fix: deleting asset from asset-viewer on search results (#25596)

* fix: escape handling in search asset viewer (#25621)

* fix: correctly show owner in album options modal (#25618)

* fix: validation issues

* fix: validation issues

---------

Co-authored-by: Jason Rasmussen <jason@rasm.me>
Co-authored-by: Min Idzelis <min123@gmail.com>
Co-authored-by: Daniel Dietzler <36593685+danieldietzler@users.noreply.github.com>
Co-authored-by: Paul Makles <me@insrt.uk>

mobile/openapi/lib/model/asset_response_dto.dart

@@ -50,18 +50,22 @@ class AssetResponseDto {
     required this.width,
   });
 
-  /// base64 encoded sha1 hash
+  /// Base64 encoded SHA1 hash
   String checksum;
 
   /// The UTC timestamp when the asset was originally uploaded to Immich.
   DateTime createdAt;
 
+  /// Device asset ID
   String deviceAssetId;
 
+  /// Device ID
   String deviceId;
 
+  /// Duplicate group ID
   String? duplicateId;
 
+  /// Video duration (for videos)
   String duration;
 
   ///
@@ -78,31 +82,43 @@ class AssetResponseDto {
   /// The UTC timestamp when the file was last modified on the filesystem. This reflects the last time the physical file was changed, which may be different from when the photo was originally taken.
   DateTime fileModifiedAt;
 
+  /// Whether asset has metadata
   bool hasMetadata;
 
+  /// Asset height
   num? height;
 
+  /// Asset ID
   String id;
 
+  /// Is archived
   bool isArchived;
 
+  /// Is edited
   bool isEdited;
 
+  /// Is favorite
   bool isFavorite;
 
+  /// Is offline
   bool isOffline;
 
+  /// Is trashed
   bool isTrashed;
 
+  /// Library ID
   String? libraryId;
 
+  /// Live photo video ID
   String? livePhotoVideoId;
 
   /// The local date and time when the photo/video was taken, derived from EXIF metadata. This represents the photographer's local time regardless of timezone, stored as a timezone-agnostic timestamp. Used for timeline grouping by \"local\" days and months.
   DateTime localDateTime;
 
+  /// Original file name
   String originalFileName;
 
+  /// Original MIME type
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -111,6 +127,7 @@ class AssetResponseDto {
   ///
   String? originalMimeType;
 
+  /// Original file path
   String originalPath;
 
   ///
@@ -121,10 +138,12 @@ class AssetResponseDto {
   ///
   UserResponseDto? owner;
 
+  /// Owner user ID
   String ownerId;
 
   List<PersonWithFacesResponseDto> people;
 
+  /// Is resized
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -137,8 +156,10 @@ class AssetResponseDto {
 
   List<TagResponseDto> tags;
 
+  /// Thumbhash for thumbnail generation
   String? thumbhash;
 
+  /// Asset type
   AssetTypeEnum type;
 
   List<AssetFaceWithoutPersonResponseDto> unassignedFaces;
@@ -146,8 +167,10 @@ class AssetResponseDto {
   /// The UTC timestamp when the asset record was last updated in the database. This is automatically maintained by the database and reflects when any field in the asset was last modified.
   DateTime updatedAt;
 
+  /// Asset visibility
   AssetVisibility visibility;
 
+  /// Asset width
   num? width;
 
   @override