# Scorpia Batch Image Studio SaaS

> **Status:** Previously live on production VPS (decommissioned 2026-08)  
> **Repository:** Private Internal Repository  
> **Tech Stack:** Next.js, React 19, Tailwind CSS, Prisma ORM, Pluggable AI Endpoints (FLUX, Qwen, Gemini), Stripe / Usage Credits

---

## 1. Overview & Introduction
**Scorpia Image Generator (Catalog Studio)** is a high-throughput generative AI platform built specifically for eCommerce and product catalog workflows. It allows photographers and digital retailers to upload an entire photoshoot and apply a single visual instruction (such as lighting adjustment, virtual apparel try-on, background transformation, or stylistic consistency) across every image in the batch.

## 2. The Operational Problem
Originating from commercial product photography for retail clients (e.g. Classic Home Furniture):
- Editing hundreds of product shots in Photoshop requires repetitive, labor-intensive manual work.
- Existing consumer AI image tools only accept one image at a time with inconsistent outputs across a full catalog.
- APIs can fail or produce flawed frames, leading to wasted billing when charged per click.

## 3. System Architecture
```
[Catalog Shoot Upload (Multiple High-Res Photos)]
       │
       ▼
[Studio Dashboard: Mode Selection (Prompt-Edit, Try-On, Generation)]
       │
       ▼
[Task Fan-Out & Rate-Limited Batch Runner]
       │
   ┌───┴────────────────────────┐
   ▼                            ▼
[Qwen Image Edit / FLUX]   [Google Gemini 2.5]
   │                            │
   └───────────┬────────────────┘
               ▼
[Frame Validation & Credit Debit] (Auto-refund on generation failure)
               │
               ▼
[Cohesive Catalog Export (Zip / Cloud Download)]
```

## 4. Key Engineering Highlights
- **Pluggable Multi-Model Adapter:** Seamlessly routes between Qwen Image Edit, FLUX, and Gemini backends depending on the fidelity required.
- **Fail-Safe Credit Accounting:** Credits debit strictly upon confirmed generation of a high-quality frame; failed or dropped API calls trigger immediate automatic credit refunds.
- **Unified Workspace:** Operators can inspect individual frames, tweak instructions for specific outliers, and export the entire processed collection in one click.
