Version 1.5.0

CHANGELOG.md

@@ -1,7 +1,7 @@
 # IGNY8 Change Log
 
 **Current Version:** 1.4.0  
-**Last Updated:** January 5, 2026
+**Last Updated:** January 6, 2026
 
 ---
 
@@ -9,6 +9,7 @@
 
 | Version | Date | Summary |
 |---------|------|---------|
+| 1.5.0 | *Planned* | Image Generation System Overhaul, Quality Tier Refinements, Credit Service Enhancements |
 | 1.4.0 | Jan 5, 2026 | **Major** - AI Model Architecture Overhaul, IntegrationProvider Model, AIModelConfig with Credit System, SystemAISettings, Django Admin Reorganization |
 | 1.3.2 | Jan 3, 2026 | **Major** - Publishing Scheduler, Onboarding Wizard, Content Calendar, Design System Consolidation, Site Dashboard redesign |
 | 1.3.1 | Jan 2, 2026 | **Design System Consolidation** - Updated .rules with comprehensive design system & component rules, ESLint enforcement |
@@ -35,6 +36,62 @@
 
 ---
 
+## v1.5.0 - Planned
+
+### Upcoming Release: Image Generation System Overhaul
+
+This release will focus on improving the image generation system with better model support, fixed aspect ratios, and enhanced quality tier selection.
+
+---
+
+### 🖼️ Image Generation Improvements (PLANNED)
+
+**Quality Tier Models:**
+- **Basic (1 credit):** Hi Dream Full (`runware:97@1`) - Fast, general-purpose diffusion
+- **Quality (5 credits):** Bria 3.2 (`bria:10@1`) - Balanced quality
+- **Premium (15 credits):** Nano Banana (`google:4@2`) - Highest quality
+
+**Fixed Image Sizes:**
+- Featured Image: 1792×1024 (landscape, prominent)
+- In-Article Square: 1024×1024
+- In-Article Landscape: Model-dependent (1280×768 or 1344×768)
+
+**In-Article Image Pattern:**
+- Position 0: Square 1024×1024
+- Position 1: Landscape (model-specific)
+- Position 2: Square 1024×1024
+- Position 3: Landscape (model-specific)
+
+**UI Changes:**
+- Removed mobile image options from settings
+- Image progress modal width increased
+- Unique position constraints for in-article images
+
+---
+
+### 💰 Credit Service Enhancements (PLANNED)
+
+**New Methods:**
+- `CreditService.calculate_credits_for_image()` - Model-specific image credit calculation
+- `CreditService.calculate_credits_from_tokens_by_model()` - Model-specific token-to-credit conversion
+
+**Improvements:**
+- Better fallback to global defaults when model lacks configuration
+- Enhanced logging for credit calculations
+- Validation for missing `credits_per_image` or `tokens_per_credit`
+
+---
+
+### 📋 Planning Documentation
+
+**New Files:**
+- `docs/plans/4th-jan-refactor/IMAGE_MODELS_IMPLEMENTATION_PLAN.md` - Detailed image system implementation plan
+- `docs/plans/4th-jan-refactor/REFACTOR-OVERVIEW.md` - Architecture refactor overview
+- `docs/plans/4th-jan-refactor/implementation-plan-for-ai-models-and-cost.md` - AI models and cost plan
+- `docs/plans/4th-jan-refactor/safe-migration-and-testing-plan.md` - Migration and testing strategy
+
+---
+
 ## v1.4.0 - January 5, 2026
 
 ### Major Release: AI Architecture Overhaul & Model Configuration System

docs/10-MODULES/BILLING.md

@@ -1,6 +1,6 @@
 # Billing Module
 
-**Last Verified:** January 5, 2026  
+**Last Verified:** January 6, 2026  
 **Status:** ✅ Active (Simplified January 2026)  
 **Backend Path:** `backend/igny8_core/modules/billing/` + `backend/igny8_core/business/billing/`  
 **Frontend Path:** `frontend/src/pages/Billing/` + `frontend/src/pages/Account/`
@@ -195,6 +195,28 @@ CreditService.add_credits(
 )
 ```
 
+### Calculate Credits for Images (NEW v1.4.0)
+
+```python
+# Calculate credits needed for image generation based on model
+credits = CreditService.calculate_credits_for_image(
+    model_name='dall-e-3',  # Model with credits_per_image = 5
+    num_images=3
+)
+# Returns: 15 (3 images × 5 credits)
+```
+
+### Calculate Credits from Tokens by Model (NEW v1.4.0)
+
+```python
+# Calculate credits from token usage based on model's tokens_per_credit
+credits = CreditService.calculate_credits_from_tokens_by_model(
+    model_name='gpt-4o-mini',  # Model with tokens_per_credit = 10000
+    total_tokens=15000
+)
+# Returns: 2 (ceil(15000 / 10000))
+```
+
 ---
 
 ## Plan Limits
@@ -303,3 +325,5 @@ Displays:
 | Feature | Status | Description |
 |---------|--------|-------------|
 | ~~AI Model Config database~~ | ✅ v1.4.0 | Model pricing moved to AIModelConfig |
+| Image model quality tiers | ✅ v1.4.0 | credits_per_image per quality tier |
+| Credit service enhancements | 🔄 v1.5.0 | Model-specific calculation methods |

docs/90-REFERENCE/AI-FUNCTIONS.md

@@ -1,6 +1,6 @@
 # AI Functions Reference
 
-**Last Verified:** January 5, 2026
+**Last Verified:** January 6, 2026
 
 ---
 

docs/90-REFERENCE/MODELS.md

@@ -1,6 +1,6 @@
 # Database Models Reference
 
-**Last Verified:** January 5, 2026
+**Last Verified:** January 6, 2026
 
 ---
 
@@ -105,6 +105,14 @@ class AIModelConfig(models.Model):
 | dall-e-3 | image | - | 5 | quality |
 | google:4@2 | image | - | 15 | premium |
 
+**Image Model Reference (v1.5.0 Planned):**
+
+| Model | AIR ID | Tier | Supported Dimensions |
+|-------|--------|------|---------------------|
+| Hi Dream Full | `runware:97@1` | Basic | 1024×1024, 1280×768 |
+| Bria 3.2 | `bria:10@1` | Quality | 1024×1024, 1344×768 |
+| Nano Banana | `google:4@2` | Premium | 1024×1024, 1376×768 |
+
 **Helper Methods:**
 - `AIModelConfig.get_default_text_model()` - Get default text model
 - `AIModelConfig.get_default_image_model()` - Get default image model

docs/INDEX.md

@@ -1,7 +1,7 @@
 # IGNY8 Technical Documentation
 
-**Version:** 1.3.2  
+**Version:** 1.4.0  
-**Last Updated:** January 3, 2026  
+**Last Updated:** January 6, 2026  
 **Purpose:** Complete technical reference for the IGNY8 AI content platform
 
 ---
@@ -22,6 +22,7 @@
 | Look up model fields | [90-REFERENCE/MODELS.md](90-REFERENCE/MODELS.md) |
 | See prelaunch checklist | [plans/FINAL-PRELAUNCH.md](plans/FINAL-PRELAUNCH.md) |
 | **Understand publishing flow** | [50-DEPLOYMENT/WORDPRESS-INTEGRATION-FLOW.md](50-DEPLOYMENT/WORDPRESS-INTEGRATION-FLOW.md) |
+| **AI model architecture (v1.4.0)** | [plans/4th-jan-refactor/final-model-schemas.md](plans/4th-jan-refactor/final-model-schemas.md) |
 
 ---
 
@@ -73,17 +74,18 @@
 | [PAGE-REQUIREMENTS.md](30-FRONTEND/PAGE-REQUIREMENTS.md) | Site/sector selector requirements |
 | [STORES.md](30-FRONTEND/STORES.md) | Zustand state management |
 
-### Current Page Structure (v1.3.2)
+### Current Page Structure (v1.4.0)
 
 ```
 /                           → Dashboard (Home.tsx) - with workflow widgets
 ├── SETUP
-│   /setup/wizard           → Onboarding Wizard (SetupWizard.tsx) [NEW v1.3.2]
+│   /setup/wizard           → Onboarding Wizard (SetupWizard.tsx)
 │   /setup/add-keywords     → Add Keywords (AddKeywords.tsx)
 │   /account/content-settings → Content Settings (ContentSettingsPage.tsx)
 │   /sites                  → Sites List (List.tsx)
 │   /sites/:id              → Site Dashboard (Dashboard.tsx)
-│   /sites/:id/settings     → Site Settings (Settings.tsx) - with Publishing tab
+│   /sites/:id/settings     → Site Settings (Settings.tsx)
+│                             - Tabs: General, AI Settings (v1.4.0), Integrations, Publishing, Content Types
 │   /thinker/prompts        → Thinker Prompts (Prompts.tsx) [Admin]
 │   /thinker/author-profiles → Author Profiles (AuthorProfiles.tsx) [Admin]
 ├── WORKFLOW
@@ -96,7 +98,7 @@
 │   /writer/review          → Review (Review.tsx)
 │   /writer/approved        → Approved (Approved.tsx)
 │   /automation             → Automation Dashboard (AutomationPage.tsx)
-├── PUBLISHER [NEW v1.3.2]
+├── PUBLISHER
 │   /publisher/content-calendar → Content Calendar (ContentCalendar.tsx)
 ├── OPTIONAL MODULES
 │   /linker/content         → Linker [if enabled]
@@ -109,13 +111,16 @@
 │                             - Tabs: Plan, Upgrade, History
 │   /account/usage          → Usage Analytics (UsageAnalyticsPage.tsx)
 │                             - Tabs: Limits, Credit History, API Activity
-│   /settings/integration   → AI Models (IntegrationPage.tsx) [Admin]
+│   /settings/integration   → Integration Settings (IntegrationPage.tsx) [Admin]
 ├── HELP
 │   /help                   → Help Center (HelpCenter.tsx)
 └── INTERNAL
     /ui-elements            → UI Elements (UIElements.tsx) [Design System Ref]
 ```
 
+**Removed in v1.4.0:**
+- `/settings/ai` - AI Settings page merged into Site Settings AI tab
+
 ---
 
 ## 40-WORKFLOWS - Cross-Module Flows {#workflows}

docs/plans/FINAL-PRELAUNCH.md

@@ -189,19 +189,19 @@ Display the following account-related information:
 
 # PHASE 3: Credits, Pricing & Payments
 
-## 3.1 - Credits Structure
+## 3.1 - Credits Structure ✅
 
-### 3.1.1 - Token Costing
+### 3.1.1 - Token Costing ✅
 - Finalize credits token costing
 - Define limits per plan
 - Document per-plan structure
 
-### 3.1.2 - Pricing Display
+### 3.1.2 - Pricing Display ✅
 - Finalize what to show in pricing plans on frontend
 - Finalize what to show in pricing plans in-app
 - Ensure consistency between both
 
-### 3.1.3 - Subscription Verification
+### 3.1.3 - Subscription Verification ✅
 - Verify correct renewal date logic
 - Verify correct reset of credits date
 - Test edge cases (upgrades, downgrades, mid-cycle changes)