iamge genration credits fixing - not fixed

docs/40-WORKFLOWS/CREDIT-SYSTEM.md

@@ -1,7 +1,7 @@
 # Credit System
 
-**Last Verified:** January 5, 2026  
-**Status:** ✅ Simplified (v1.5.0)
+**Last Verified:** January 10, 2026
+**Status:** ✅ Complete (v1.7.1 - Image Generation Credits)
 
 ---
 
@@ -93,7 +93,7 @@ Credits calculated from actual token usage:
 | Content Generation | gpt-4o | 1,000 |
 | Content Optimization | gpt-4o-mini | 10,000 |
 
-### Fixed-Cost Operations (Image AI)
+### Fixed-Cost Operations (Image AI) - v1.7.1 Complete
 
 Credits per image based on quality tier:
 
@@ -103,6 +103,13 @@ Credits per image based on quality tier:
 | Quality | dall-e-3 | 5 |
 | Premium | google:4@2 | 15 |
 
+**Image Generation Credit Flow (v1.7.1):**
+1. Pre-check: `CreditService.check_credits_for_image()` verifies sufficient credits
+2. Generation: Images generated via `process_image_generation_queue` Celery task
+3. Post-deduct: `CreditService.deduct_credits_for_image()` called per successful image
+4. Logging: `CreditUsageLog` + `CreditTransaction` + `AITaskLog` entries created
+5. Notifications: `NotificationService.notify_images_complete/failed()` called
+
 ### Free Operations
 
 | Operation | Cost |
@@ -452,3 +459,58 @@ All AI operations logged in `CreditUsageLog` with:
 - Model used
 - Token counts
 - Related object metadata
+
+---
+
+## Image Generation Credit System (v1.7.1)
+
+### Implementation Details
+
+**Files:**
+- `CreditService.check_credits_for_image()` - [credit_service.py:307-335](../backend/igny8_core/business/billing/services/credit_service.py#L307-L335)
+- `process_image_generation_queue` credit check - [tasks.py:290-319](../backend/igny8_core/ai/tasks.py#L290-L319)
+- `deduct_credits_for_image()` - [tasks.py:745-770](../backend/igny8_core/ai/tasks.py#L745-L770)
+- AITaskLog logging - [tasks.py:838-875](../backend/igny8_core/ai/tasks.py#L838-L875)
+- Notifications - [tasks.py:877-895](../backend/igny8_core/ai/tasks.py#L877-L895)
+
+### Credit Flow for Image Generation
+
+```
+1. User triggers image generation
+   ↓
+2. CreditService.check_credits_for_image(account, model, num_images)
+   - Calculates: credits_per_image × num_images
+   - Raises InsufficientCreditsError if balance < required
+   ↓
+3. process_image_generation_queue() processes each image
+   ↓
+4. For each successful image:
+   CreditService.deduct_credits_for_image()
+   - Creates CreditUsageLog entry
+   - Creates CreditTransaction entry
+   - Updates account.credits balance
+   ↓
+5. After all images processed:
+   - AITaskLog entry created
+   - Notification created (success or failure)
+```
+
+### Logging Locations
+
+| Table | What's Logged | When |
+|-------|---------------|------|
+| CreditTransaction | Credit deduction (financial ledger) | Per image |
+| CreditUsageLog | Usage details (model, cost, credits) | Per image |
+| AITaskLog | Task execution summary | After batch |
+| Notification | User notification | After batch |
+
+### Automation Compatibility
+
+Image generation credits work identically for:
+- Manual image generation (from UI)
+- Automation Stage 6 (scheduled/manual automation runs)
+
+Both call `process_image_generation_queue` which handles:
+- Credit checking before generation
+- Credit deduction after each successful image
+- Proper logging to all tables