Browse Source

FNZCM2: ideas update

HOME 7 months ago
parent
commit
ebba71c8e3

+ 41 - 0
FNZCM2/FNZCM2.Abstractions/ideas/AlbumMetadataJson.md

@@ -0,0 +1,41 @@
+# FNZCM2: Album Metadata Json
+
+## Album: Object
+
+| name | type  | example  | remark |
+|----------------------------------|
+| Id | string | 6aa977f03314e4b4 | HEX Tick Stamp |
+| Name | string | Brrr |
+| ReleaseDate | string  | YYYYMMDD
+
+## Discs: Array
+
+| name | type  | example  | remark |
+|----------------------------------|
+| Id | string | 6aa977f03314e4b4 | HEX Tick Stamp |
+| FolderName | string | disc-01-Brr |
+| DiscNumber | int | 1 | 1 based | 
+| CatalogNumber | string | VVXX-01253 | From file tag or vgmdb
+| AudioEncoding | string | FLAC/AAC/MP3 |  Just Codec, Don't mix up with container
+
+## Tracks: Array
+
+| name | type  | example  | remark |
+|----------------------------------|
+| Id | string | 6aa977f03314e4b4 | HEX Tick Stamp |
+| DiscId | string | 6aa977f03314e4b4 | It's own disc |
+| TrackNumber | int | 1 | 1 based | 
+| Title | string | song name | From tag or filename |
+| FileName | string | 01.Brrr.flac | |
+| Duration | double | | ms |
+| Artist | Array of string | | |
+| Size    | int | | bytes |
+| BitRate | int | | bps |
+| Tags | Dic<string,string> | ... | From tag|
+
+## AdditionalFiles: Array
+
+| name | type  | example  | remark |
+|----------------------------------|
+| FileName | string | log/accurip |
+| Size | int | | bytes

+ 46 - 0
FNZCM2/FNZCM2.Abstractions/ideas/CacheMetaJson.md

@@ -0,0 +1,46 @@
+# FNZCM2: Cache Metadata Json
+
+## Albums: Array
+
+Inherit from `AlbumMetadataJson`
+
+| name | type  | example  | remark |
+|----------------------------------|
+| Icon | string | album-xx/pics/icon.webp |
+| SearchTags | Array of string | ["ar:aa","ar:bb","gen:game"] | For quick search
+
+## Discs: Array
+
+Inherit from `AlbumMetadataJson` / Disc
+
+| name | type  | example  | remark |
+|----------------------------------|
+| AlbumId | string | 6aa977f03314e4b4 | For invert nav|
+| Picture | string | album-xx/pics/disc/disc-xx.webp |
+| SearchTags | Array of string |  |
+
+## Tracks: Array
+
+Inherit from `AlbumMetadataJson` / Track
+
+| name | type  | example  | remark |
+|----------------------------------|
+| Url | string | album-xx/disc-xx/xx.flac |
+| SearchTags | Array of string | |
+
+## Pics: Array
+
+| name | type  | example  | remark |
+|----------------------------------|
+| AlbumId | string | 6aa977f03314e4b4 |
+| Url | string | album-xx/pics/booklet/page-001.webp |  |
+| Kind | string | one of booklet/pack/disc/icon/default |  |
+
+## AdditionalFiles: Array
+
+Inherit from `AlbumMetadataJson` / AdditionalFiles
+
+| name | type  | example  | remark |
+|----------------------------------|
+| AlbumId | string | 6aa977f03314e4b4 |
+| Url | string | album-xx/files/disc-01.log |

+ 31 - 16
FNZCM2/FNZCM2.Abstractions/ideas/LibraryFolderStructure.md

@@ -3,23 +3,38 @@
 ```
 📁$LibraryRoot/
     📝fnzcm2-metadata-cache.json.br
-    📁album-1/
+    📁album-SafeIzeNameBrrr/
         📝fnzcm2-metadata.json
         📁pics/
-            🖼️booklet1.webp
-            🖼️booklet2.webp
-        📁disc-1-flac/
-            🎼Track1.flac
-            🎼Track2.flac
-        📁disc-1-aac-q1/
-            🎼Track1.m4a
-            🎼Track2.m4a
-        📁disc-2-flac/
-            🎼Track1.flac
-            🎼Track2.flac
-        📁disc-2-aac-q1/
-            🎼Track1.m4a
-            🎼Track2.m4a
-    📁album-2/
+            🖼️icon.webp
+            📁default/
+                🖼️01.webp
+                🖼️02.webp
+            📁pack/
+                🖼️front.webp
+                🖼️back.webp
+            📁booklet/
+                🖼️page-01.webp
+                🖼️page-02.webp
+            📁disc/
+                🖼️disc-01.webp
+                🖼️disc-02.webp
+        📁files/
+            📝eac-disc-01.log
+            📝DVD.ISO
+            📝DVD.MDS
+        📁disc-01-cat-num-flac/
+            🎼001.TrackNameBrrr.flac
+            🎼002.TrackNameBrrr.flac
+        📁disc-01-cat-num-aac-q1/
+            🎼001.TrackNameBrrr.m4a
+            🎼002.TrackNameBrrr.m4a
+        📁disc-02-cat-num-flac/
+            🎼001.TrackNameBrrr.flac
+            🎼002.TrackNameBrrr.flac
+        📁disc-02-cat-num-aac-q1/
+            🎼001.TrackNameBrrr.m4a
+            🎼002.TrackNameBrrr.m4a
+    📁album-NameBrr2/
         ...
 ```