diff --git a/CHANGELOG.md b/CHANGELOG.md index 29ba0d44..4be0ed17 100644 --- a/CHANGELOG.md +++ b/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 diff --git a/docs/10-MODULES/BILLING.md b/docs/10-MODULES/BILLING.md index cb1706b5..4a40b049 100644 --- a/docs/10-MODULES/BILLING.md +++ b/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 | diff --git a/docs/90-REFERENCE/AI-FUNCTIONS.md b/docs/90-REFERENCE/AI-FUNCTIONS.md index 4d9a6bd0..2dda5e77 100644 --- a/docs/90-REFERENCE/AI-FUNCTIONS.md +++ b/docs/90-REFERENCE/AI-FUNCTIONS.md @@ -1,6 +1,6 @@ # AI Functions Reference -**Last Verified:** January 5, 2026 +**Last Verified:** January 6, 2026 --- diff --git a/docs/90-REFERENCE/MODELS.md b/docs/90-REFERENCE/MODELS.md index 394e16f8..45ff802f 100644 --- a/docs/90-REFERENCE/MODELS.md +++ b/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 diff --git a/docs/INDEX.md b/docs/INDEX.md index c0778a56..9ad9211f 100644 --- a/docs/INDEX.md +++ b/docs/INDEX.md @@ -1,7 +1,7 @@ # IGNY8 Technical Documentation -**Version:** 1.3.2 -**Last Updated:** January 3, 2026 +**Version:** 1.4.0 +**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} diff --git a/docs/plans/FINAL-PRELAUNCH.md b/docs/plans/FINAL-PRELAUNCH.md index 3fa972fc..c7458b05 100644 --- a/docs/plans/FINAL-PRELAUNCH.md +++ b/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)