From Ssl-wiki

Contents 1 Use cases 1.1 Short Description (Priority 1 (lowest) - 3 (highest)) 1.2 Sync folders to crates (Prio 3) 1.3 Find lost files (Prio 2) 1.4 Export crates to txt / xml / html files (Prio 1) 1.5 Rename files (Prio 3) 1.6 Delete Orphaned Tracks (Prio 2) 1.7 Reset all columns (Prio 2) 1.8 Export crate to folder (Prio 2) 1.9 Export iTunes XML to Crates (Prio 2) 1.10 Intelligent Crates (Prio 1) 1.11 Transfer library (Prio 2) 1.12 Synchronise library to a backup library (Prio 1) 1.13 Backup Folders (Prio 2) 1.14 Sort crates alphabetically (Prio 1) 1.15 Sync iTunes Rating to colors (prio 1) 1.16 Convert TTM57 Settings from Mac to PC (Prio 1)

Use cases

Short Description (Priority 1 (lowest) - 3 (highest))

1. Brief description
2. Presentation Layer (user input):
   1. Options for the user
3. Business Logic Layer
4. Possible exceptions
   1. exception 1: file not found
   2. exception 2: user entered value out of range

Sync folders to crates (Prio 3)

1. Upon start: automatical sync of folders to crates
2. Presentation Layer (user input):
   1. Possible to choose to a given crate to sync to 'which folders' (one or many)
   2. Choose to whether completely re-build crate or just to add new tracks (default)
   3. Choose whether to add subfolders as subcrates
   4. What about the sort order of subfolders? Should they be alphabetically? Should they stick? Should new folders be added at the end?
   5. Should new added tracks get as import date the date of the file import? Or should they get the file modification date?
3. Business Logic Layer
   1. Read for each crate, which is linked to one or multipls folders (done)
      1. Read names+location of all files with audio-file extensions underneath the folder given by the user (done)
      2. Check whether already track in crate (done)
      3. For each subfolder create a subcrate (done)
      4. If not, then add to crate (optionally add to DB) (done, optional DB-add not yet implemented, not necessary yet)
4. Possible exceptions

Find lost files (Prio 2)

1. Find lost tracks: it will scan all crates from a certain drive and check it for files which are not on the drive, then it will scan a folder recursively and will try to identify the file. If it finds multiple files with the same filename it will try to identify it by the given size and give the user the option to choose which file
2. Presentation Layer (user input):
   1. Which drive should be checked
   2. Which folder should be used as a start point to check for missing tracks
   3. Which identifying heuristic should be used if tracks with same names are found
      1. trackname
      2. size
      3. ID3 tags
   4. What should happen if in one crate the same filename (not pathes, just filenames) exist and if a match is found later? Resolving all to the same file+path will result in duplicate crate entries. So should the mutliple tracknames be consolidated into one entry? Or should only one entry be altered and the other files be kept?
3. Business Logic Layer
   1. Read in one datastructure
      1. Tracks from all crates (done)
      2. Tracks from DB (done)
   2. Read names+location of all files with audio-file extensions underneath the folder given by the user (done)
   3. Check for each track in the list whether the file exists
      1. if not existing, then check if a file with the same name exists in the list of all read names+location on the HD (done)
         1. if multiple file exists, then compare sizes or ID3 tags
            1. if still matching, change location in DB, and in all crates
         2. if one exist, then compare size or ID3 tags (compare size+ID3tag not yet)
            1. if still matching, change location in DB, and in all crates
   4. Write out crates+DB (done)
4. Possible exceptions

Export crates to txt / xml / html files (Prio 1)

1. Export crate files to a text formatted file. This should also include all the available ID3 tags from the DB file
2. Presentation Layer (user input):
   1. Select a crate file using JFileChooser
   2. Select a directory and specify a file name using a SaveFileDialog
   3. Specify the output format
   4. Specify columns and order of columns
3. Business Logic Layer
   1. Read the information (and put it into a JTable (uneditable))
   2. Depending on the output format, write the correct information to the selected file (done)
   3. Adjustable columns (done)
4. Possible exceptions:
   1. FileNotFoundException
   2. Invalid characters for file name

Rename files (Prio 3)

1. Description: Import crate file, edit track info and save changes to the DB file
2. Presentation Layer (user input):
   1. Select a crate file using JFileChooser
3. Business Logic Layer
   1. Read the information and put it into a JTable (editable)
   2. After changes have been made, rename the files and save the information in the DB file (so SSL will still be able to locate the files). (done)
4. Possible exceptions:
   1. FileNotFoundException
   2. Invalid input for track information
   3. Invalid characters for file name

Delete Orphaned Tracks (Prio 2)

1. This function should delete all orphaned tracks. A track is orphaned when it is in the library but not used in any crate.
2. Presentation Layer (user input):
   1. Options for the user
3. Business Logic Layer
   1. Go through the whole library and check if each track is in a crate, if not delete it from the library (done)
4. Possible exceptions
   1. exception 1:
   2. exception 2:

Reset all columns (Prio 2)

1. Description: Resets all columns in your library to one distinct order and view
2. Presentation Layer (user input):
   1. List of columns, each column has a "visible" tick-box
   2. column order can be changed via drag and drop or move up and down (this should be save automatically into preferences)
   3. Click a button to reset columns
3. Business Logic Layer:
   1. List of columns (read from preferences)
   2. Apply changes to all crates (done)
4. Possible exceptions

Export crate to folder (Prio 2)

1. This function should copy all tracks which belong to one crate to one folder, and create the crate file for it, so that someone could copy this folder and the crate for "take-away" (copy on a USB stick)
2. Presentation Layer (user input):
   1. Choose which crate
   2. Choose new crate name
   3. Choose which folder to export to
3. Business Logic Layer
   1. create new crate (done)
   2. For each track in one crate, copy the track to the export-folder and add it to the new crate (done)
4. Possible exceptions
   1. exception 1: file not found
   2. exception 2: user entered value out of range

Export iTunes XML to Crates (Prio 2)

Intelligent Crates (Prio 1)

Transfer library (Prio 2)

1. Description: Transfer your library including audio files to a different drive
2. Presentation Layer (user input):
   1. A list of possible drives/location
3. Business Logic Layer:
   1. Check for "my music" path stuff
   2. Copy db+crate+audio files over to specified path (done)
4. Possible exceptions

Synchronise library to a backup library (Prio 1)

Backup Folders (Prio 2)

1. Description: Copies your database and crate files to a different location for backup purpose
2. Presentation Layer (user input):
   1. Backup path
3. Business Logic Layer:
   1. Copy db+crate files over to specified path (done)
4. Possible exceptions

Sort crates alphabetically (Prio 1)

Sync iTunes Rating to colors (prio 1)

Scraped.

Makes no sense as colors can only be changed in DB so far, anything else takes too much time to read+write ... Hm why not... it should be basically just changing one byte in the mp3 file

Convert TTM57 Settings from Mac to PC (Prio 1)

1. Copy TTM57 group settings and layout from one computer to another
2. Presentation Layer (user input):
   1. Options for the user
3. Business Logic Layer
4. Possible exceptions
   1. exception 1: file not found
   2. exception 2: user entered value out of range