New Volume Checklist

Flag: ⭐️ Modified: February 14, 2026 7:58 PM Created: September 17, 2025 3:27 PM Master Type: Notes Hide: No Starred: Yes Status: Unassigned

🗂️ NEW VOLUME SANDBOX WORKFLOW
──────────────────────────────

1️⃣ Confirm volume structure
📌 Check that these exist:

<Volume>/
├─ config.sh ⚙️
└─ <Folder>/ (Binders/Boxes/Bins/Enclosures…)
    ├─ Collection/
    │   └─ Verso Positives/
    │       ├─ TIFF/
    │       └─ JPG/
    ├─ Processed/  ← Phase 3 reads files from here
    ├─ Exports/    ← Phase 1 outputs PSD
    │   └─ Redo/
    ├─ Positives/  ← Phase 2 outputs
    └─ Negatives/  ← Phase 2 outputs

✅ Nothing else required yet. Processed internal structure doesn’t matter.

──────────────────────────────

2️⃣ Confirm config.sh
⚡ Check variables:
- TOP_BASE
- PHASE3_IDLE_SECONDS
- PHASE3_SLEEP_INTERVAL
- PROCESSED_DIRS
…and any others your scripts need.

──────────────────────────────

3️⃣ Phase 1 — Crop & Adjust
🎨 /Exports/*.psd → Phase 1 edits → /Exports/*.psd  
📝 Verify:
- PSDs cropped/adjusted
- Filenames/extensions untouched
- No duplicate folders created

──────────────────────────────

4️⃣ Phase 2 — Convert & Export
🔄 Take Phase 1 PSD → Phase 2 → generates derivatives:
- /Positives/ (TIFF/JPG)
- /Negatives/ (TIFF/JPG)
- /Processed/ (TIFF, JPG, PSD)

📝 Verify:
- Derivatives in correct folders
- Filenames remain consistent
- No duplicate folders
- Spot-check file types

──────────────────────────────

5️⃣ Phase 3 — Sort & Filter
📂 /Processed/* → Phase 3 → /Collection/

- TIFF → Collection/<Enclosure>/<ShortFolder> TIFF  
- JPG → Collection/<Enclosure>/<ShortFolder> JPG  
- PSD → Collection/<Enclosure>/<ShortFolder> PSD  
- v-A/p-A → Collection/Verso Positives/TIFF or JPG  
- Unparsed → Collection/unparsed/_manual_check

📝 Verify:
- Correct sorting into Collection
- No duplicates
- Filenames intact

──────────────────────────────

6️⃣ Manual sanity checks
👀 Spot-check:
- Subfolders exist for each enclosure
- No leftover files in /Processed or /Exports
- Naming schema respected (long → short → type)

──────────────────────────────

7️⃣ Clean up / Ready for next volume
🧹 Remove test PSDs
🧹 Ensure /Exports and /Processed are tidy
💾 Volume ready for next batch

──────────────────────────────

1. Confirm the volume structure

On your new drive, confirm the following essential folders exist:

/<Volume>/
    config.sh
    Enclosure/ (or Boxes/Bins/Binders…)
        Collection/
            Verso Positives/
                TIFF/
                JPG/
        Processed/
            JPGs/
            TIFFs/
            PSDs/
            Editing/
        Exports/
            Redo/
        Negatives/
        Positives/

Make sure config.sh is present at the root.
Make sure Collection exists with Verso Positives containing only TIFF and JPG.
/Processed just needs to exist — the internal organization is not required.

2. Confirm config.sh is valid

Verify config.sh has variables like TOP_BASE, PHASE3_IDLE_SECONDS, PHASE3_SLEEP_INTERVAL, PROCESSED_DIRS, etc., correctly set.

3. Test Phase 1 — Crop and Adjust

Export a test PSD into /Exports.
Run Phase 1 using your AppleScript .app or Terminal:

bash /Users/<user>/Scripts/phase1.sh "/Volumes/<Volume>/<Folder>"

Verify:

Cropped/adjusted PSD created back in /Exports or wherever Phase 1 outputs them.
File names and extensions are unchanged.
No duplicate folders created.

4. Test Phase 2 — Convert and Export

Take the PSD from Phase 1 output.
Run Phase 2:

bash /Users/<user>/Scripts/phase2.sh "/Volumes/<Volume>/<Folder>"

Verify:

Derivatives (JPG, TIFF, PSD) are correctly generated.
Positives derivatives are generated in /Positives and Negatives derivatives in /Negatives.
After generation, all derivatives are moved into /Processed (or the appropriate subfolder under /Processed if your workflow has subfolders).
File names remain consistent with the originals.
No duplicate folders are created.
Spot-check that the derivative files match the intended file type (JPG, TIFF, PSD).

5. Test Phase 3 — Sort and Filter

Make sure /Processed contains test files (PSDs, JPGs, TIFFs) — Phase 3 uses these as sources.
Run Phase 3:

bash /Users/<user>/Scripts/phase3.sh "/Volumes/<Volume>/<Folder>"

Verify:

Files are sorted into /Collection/<Enclosure>/<ShortFolder> <FileType>/.
- Example: Collection/B022/B22 TIFF/file.tif
Verso Positives handled correctly: only v-A or p-A files, into Collection/Verso Positives/JPG or TIFF.
No duplicate folders are created.
Files retain full original names and extensions.
Unparsed files go to /Collection/unparsed/_manual_check.

6. Manual sanity checks

Check that each enclosure folder in /Collection contains all expected subfolders (JPG, TIFF, PSD, Processing).
Confirm no files remain floating in /Processed or /Exports that should have moved.
Spot-check a few files to ensure naming schema is respected (long folder → short folder → file type).

7. Clean up / ready for next volume

Remove test PSDs if needed.
Ensure /Exports and /Processed are tidy.

New Volume Setup / Sandbox Workflow
────────────────────────────────────

<Volume>/
│
├─ config.sh
└─ <Folder>/        (Binders, Boxes, Bins, Enclosures…)
    │
    ├─ Collection/
    │   ├─ Verso Positives/
    │   │   ├─ TIFF
    │   │   └─ JPG
    │   │
    │   └─ <Enclosure>/  e.g., B022, FL05, GP10
    │       ├─ <ShortFolder> TIFF
    │       ├─ <ShortFolder> JPG
    │       ├─ <ShortFolder> PSD
    │       └─ <ShortFolder> Processing
    │
    ├─ Processed/      ← Phase 3 reads files from here
    ├─ Exports/        ← Phase 1 outputs PSD here
    │   └─ Redo/
    ├─ Positives/      ← Phase 2 outputs
    └─ Negatives/      ← Phase 2 outputs

────────────────────────────────────
Phase Workflow
────────────────────────────────────

Step 1: Confirm volume structure & folders exist
   │
   ▼
Step 2: Confirm config.sh variables (TOP_BASE, PHASE3_IDLE_SECONDS, PROCESSED_DIRS, etc.)
   │
   ▼
Step 3: Phase 1 – Crop & Adjust
   /Exports/*.psd ──> [Phase 1 edits] ──> /Exports/*.psd
   │
   ▼
Step 4: Phase 2 – Convert & Export
   /Exports/*.psd ──> Phase 2 generates derivatives
       ├─> /Positives/*.tif / *.jpg
       ├─> /Negatives/*.tif / *.jpg
       └─> /Processed/*.tif / *.jpg / *.psd
   │
   ▼
Step 5: Phase 3 – Sort & Filter
   /Processed/* ──> Collection/<Enclosure>/<ShortFolder> <FileType>/
       ├─ TIFFs → Collection/<Enclosure>/<ShortFolder> TIFF
       ├─ JPGs → Collection/<Enclosure>/<ShortFolder> JPG
       ├─ PSDs → Collection/<Enclosure>/<ShortFolder> PSD
       └─ v-A / p-A → Collection/Verso Positives/TIFF or JPG
   │
   ▼
Step 6: Manual sanity checks
   - Check subfolders & file placement
   - Confirm no files floating in /Processed or /Exports
   - Spot-check naming schema
   │
   ▼
Step 7: Clean up & ready for next volume
   - Remove test PSDs
   - Ensure /Exports and /Processed are tidy