Merge pull request #6 from H1ghSyst3m/feature/batch-processing

feat: Batch Feature Implementation - Complete (v2.0.0)

Author: H1ghSyst3m

CHANGELOG.md

@@ -1,10 +1,50 @@
 # Changelog
-All notable changes to this project will be documented in this file.
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## v2.0.0
+
+### What's New in v2.0
+
+**Multi-Build Workspace**
+Work on several builds at once instead of one at a time. Create Build 01, 02, 03... and manage them together in a single session.
+
+**Batch Operations**
+- Package multiple builds together
+- Track progress for each build and overall completion
+- Get a summary report showing successes and failures
+- Check/uncheck builds to control which ones get processed
+
+**Archive Extraction Upgrades**
+- Process multiple archive files in one operation
+- Sort archives into three categories: templates, content to extract, and files to skip
+- Let the app detect templates automatically based on your preferences
+- Assign archives to specific build numbers
+
+**Workspace Changes**
+Your files now live in `Builds/Build001/Content/`, `Build002/Content/`, etc. instead of a single `DIMBuild/` folder.
+
+**Field Inheritance**
+Build 01 is the source for common fields. Build 02 and higher copy these values automatically. You can override any field in child builds when needed.
+
+**Synchronization Tools**
+- Push updates from Build 01 to all other builds
+- Pull latest values from Build 01 into a specific build
+- Sync individual fields (store, SKU, tags) or everything at once
+
+**Session Saves**
+All your builds save to `session.json` automatically. The app keeps 5 backup copies. When you reopen the app, everything comes back.
+
+**New UI Elements**
+- Visual status badges: ✅ ready, ⚠️ needs info, 📭 empty
+- Delete button on each build row
+- Drag builds to reorder them
+- "New Session" button to start over
+
+### Important Changes
+
+**Settings**: "Copy Template Archives" renamed to "Enable Template Detection" (clearer meaning)
 
 ---
+
 ## v1.2.1
 ### Changed
 - Updated dependencies in `requirements.txt` and `requirements-build.txt` to separate build-time and runtime packages.

README.md

@@ -43,14 +43,22 @@ DAZ Studio users, creators, and vendors who want fast, repeatable, and tidy DIM
 
 ## Features
 
-- **Make DIM packages in seconds** — just point to your files or an archive and click Generate.
-- **Drag & drop file management** — organize your content without leaving the app.
-- **Automatic folder detection** — files are placed where DIM expects them.
-- **Cover art made easy** — drop an image and it’s formatted for DIM automatically.
-- **Warnings before mistakes** — get notified about layout problems before packaging.
-- **Store & tag presets** — save time with one-click product metadata.
-- **Keeps your presets across updates** — your custom stores and tags won’t vanish after upgrading.
-- **Works without Python** — available as a ready-to-run Windows `.exe`.
+- **Multi-Build Workflow** — Manage unlimited builds (Build 01, 02, 03...) in one session with automatic field inheritance
+- **Batch Operations** — Package multiple builds at once with progress tracking and summary reports
+- **Smart Extraction** — Three-column dialog intelligently sorts templates, content, and ignored items
+- **Session Persistence** — All builds auto-save to disk and restore on next launch
+- **Drag-Drop Reordering** — Rearrange builds by dragging them, with automatic part number updates
+- **Field Synchronization** — Build 1 acts as parent; children inherit metadata with selective overrides
+- **Build Status Indicators** — Visual feedback showing which builds are ready (✅), incomplete (⚠️), or empty (📭)
+- **Quick Actions** — Per-build delete buttons, context menus, and keyboard shortcuts
+- **Make DIM packages in seconds** — just point to your files or an archive and click Package All
+- **Drag & drop file management** — organize your content without leaving the app
+- **Automatic folder detection** — files are placed where DIM expects them
+- **Cover art made easy** — drop an image and it's formatted for DIM automatically
+- **Warnings before mistakes** — get notified about layout problems before packaging
+- **Store & tag presets** — save time with one-click product metadata
+- **Keeps your presets across updates** — your custom stores and tags won't vanish after upgrading
+- **Works without Python** — available as a ready-to-run Windows `.exe`
 
 ---
 
@@ -89,10 +97,14 @@ python app.py
 
 ## Quick Start
 
-1. Launch the app — your workspace is `Documents/DIMCreator/DIMBuild/Content`.
-2. Pick your store, fill in product name/SKU, and (optional) add a cover image.
-3. Add content by dragging it in or importing an archive.
-4. Click **Generate** to create your DIM-ready `.zip`.
+1. Launch the app — your workspace is organized under `Documents/DIMCreator/Builds/`.
+2. Build001 is created automatically with its own `Content` folder.
+3. Pick your store, fill in product name/SKU, and (optional) add a cover image.
+4. Add content by dragging it in or importing an archive to the current build's Content folder.
+5. Click **Package All** to create your DIM-ready `.zip`.
+6. Use **+ Add Build** to create additional builds (Build 02, 03, etc.) that inherit metadata from Build 01.
+7. Rearrange builds by dragging them in the list, or use the trash icon for quick deletion.
+8. Click **Package All** to process all builds at once or select specific builds and click **Package Selected** to process only those.
 
 ---
 
@@ -107,40 +119,85 @@ python app.py
 
 ## Workflows
 
+### Single-Build Workflow (Traditional)
+1. Work in Build001 folder shown in File Explorer panel.
+2. Fill in all metadata fields (store, product name, SKU, tags, image).
+3. Add your DAZ content to the Content folder (drag files or extract archives).
+4. Click **Package All** when ready.
+
+### Multi-Build Workflow (Batch Processing)
+1. Start with Build001 — fill in all metadata that will be shared across builds.
+2. Click **+ Add Build** to create Build002 — it automatically inherits metadata from Build 001.
+3. Add content to Build002's folder (File Explorer switches automatically when you select different builds).
+4. Override specific fields in Build002 if needed (e.g., different SKU, image, or Product Name).
+5. Create more builds (Build003, Build004...) as needed — each inherits from Build001 by default.
+6. Check the boxes next to builds you want to package.
+7. Click **Package All** to process all checked builds with progress tracking.
+8. Review the summary dialog showing which packages succeeded or failed.
+
+### Smart Extraction for Multi-Build Setup
+1. Collect all your archives (.zip, .rar, .7z) in one location.
+2. Click **Extract Archive** and select multiple files.
+3. The extraction dialog shows three columns:
+   - **Template**: Archives detected as templates (based on settings)
+   - **Extract**: Content archives you want to process
+   - **Ignored**: Archives you don't need
+4. Move items between columns by dragging or using arrow buttons.
+5. Assign each content archive to a build number (creates builds if needed).
+6. Click Extract — all content goes to the correct build folders automatically.
+
+### Synchronization Examples
+**Updating All Builds from Build 1:**
+1. Edit metadata in Build001 (e.g., change store or tags).
+2. Click the **Sync to All Builds** dropdown.
+3. Choose "Sync All Fields" or select specific fields (Store, SKU, Tags, etc.).
+4. All child builds update instantly.
+
+**Pulling Updates to a Specific Build:**
+1. Select Build002 (or any child build).
+2. Click **Sync from Build 1** button.
+3. All field overrides are cleared and Build002 inherits fresh values from Build001.
+
+### Reordering Builds
+1. Drag Build003 above Build002 in the list.
+2. Part numbers automatically renumber (old Build003 becomes new Build002).
+3. If you move a build to position 1, it becomes the new parent and transfers its metadata.
+
 ### From a folder
-1. Put your DAZ content into `DIMBuild/Content`.
-2. Fill in details → Generate.
+1. Put your DAZ content into the current build's `Content` folder (shown in File Explorer).
+2. Fill in details → Package All.
 
 ### From an archive
-1. Import `.zip`, `.rar`, or `.7z`.
+1. Import `.zip`, `.rar`, or `.7z` into the current build.
 2. The app extracts only the correct DAZ folders.
-3. Fill in details → Generate.
+3. Fill in details → Package All.
 
 ---
 
 ## Configuration & Data Paths
 
-- **Workspace:** `Documents/DIMCreator/DIMBuild/Content`
+- **Build Workspaces:** `Documents/DIMCreator/Builds/Build001/Content`, `Build002/Content`, etc.
+- **Session Data:** `Documents/DIMCreator/Sessions/session.json` (auto-saved with 5 backups)
 - **Logs:** `Documents/DIMCreator/Logs`
 - **Config Files:** `Documents/DIMCreator/Config/` (stores, tags, DAZ folder list)
 
-Your custom settings and presets are preserved after updates.
+Your custom settings, presets, and build sessions are preserved after updates.
 
 ---
 
 ## Keyboard Shortcuts
 
 ### Main window
 - `Ctrl+G` — Generate GUID
-- `Ctrl+Enter` — Generate DIM package
-- `Ctrl+N` — Clear fields and clean workspace
+- `Ctrl+Enter` — Generate DIM package for current build
+- `Ctrl+N` — Clear fields and clean current build folder (deletes Manifest, Supplement, and all content)
 
 ### File Explorer
-- `Ctrl+E` — Open in Explorer
-- `Delete` — Delete selected item
-- `Ctrl+C` / `Ctrl+X` / `Ctrl+V` — Copy / Cut / Paste
-- `F2` — Rename
-- `F5` — Refresh
+- `Ctrl+E` — Open current folder in Windows Explorer
+- `Delete` — Delete selected file or folder
+- `Ctrl+C` / `Ctrl+X` / `Ctrl+V` — Copy / Cut / Paste files
+- `F2` — Rename selected item
+- `F5` — Refresh file tree
 
 ---
 
@@ -155,7 +212,7 @@ Your custom settings and presets are preserved after updates.
 ## Screenshots
 
 <p align="center">
-  <img width="781" height="721" alt="DIM-Creator main window" src="https://github.com/user-attachments/assets/3df3069e-211c-45e9-b3fa-51bc27bf31bb" />
+  <img width="781" height="721" alt="DIM-Creator main window" src="https://github.com/user-attachments/assets/efc12e42-251d-441b-a236-d99befa5759b" />
 </p>
 
 ---