igny8/CHANGELOG.md

# IGNY8 Change Log

**Current Version:** 1.1.5  
**Last Updated:** January 2, 2025

---

## Version History

| Version | Date | Summary |
|---------|------|---------|
| 1.1.5 | Jan 2, 2025 | Section 3 WORKFLOW modules - Planner, Writer, Progress Modal fixes |
| 1.1.4 | Dec 27, 2025 | Section 2 SETUP modules - Add Keywords, Content Settings, Sites fixes |
| 1.1.3 | Dec 27, 2025 | Merged RULES.md into .rules |
| 1.1.2 | Dec 27, 2025 | Module status documentation, TODOS.md |
| 1.1.1 | Dec 27, 2025 | Simplified AI agent rules file |
| 1.1.0 | Dec 25, 2025 | UX overhaul, page consolidation, pre-launch audit |
| 1.0.5 | Dec 12, 2025 | Purchase Credits tab, UI reorganization |
| 1.0.4 | Dec 12, 2025 | Credit Activity tab, Cost Reference panel |
| 1.0.3 | Dec 12, 2025 | Usage Limits color variety, Cost Breakdown |
| 1.0.2 | Dec 12, 2025 | Usage Analytics consolidation, Design system |
| 1.0.1 | Dec 12, 2025 | Usage summary endpoint, Plan limits UI |
| 1.0.0 | Dec 12, 2025 | Initial production release |

---

## v1.1.5 - January 2, 2025

### Section 3 WORKFLOW Modules Implementation

**Planner Module:**
- **DELETED** `KeywordOpportunities.tsx` - orphaned page, Add Keywords is source of truth
- Removed route `/planner/keyword-opportunities` from App.tsx
- Updated Clusters table to show ideas count badge: "X ideas" (green) or "No ideas" (gray)
- Made cluster name clickable in Ideas table - navigates to `/planner/clusters/:id`

**Writer Module:**
- Fixed duplicate tags/categories display in ContentView template
  - Removed redundant tags/categories section that appeared below the main metadata
  - Tags and categories now display only once in the Topic section

**Progress Modals:**
- Fixed placeholder "X" text in image prompt progress modals:
  - Changed "Mapping Content for X Image Prompts" → "Mapping content for image prompts"
  - Changed "Writing X In‑article Image Prompts" → "Writing In‑article Image Prompts"
  - Changed "Featured Image and X In‑article..." → "Image prompts ready for generation"
- All step labels now show actual counts when available, clean fallbacks otherwise

### Files Changed
- `frontend/src/App.tsx` - Removed KeywordOpportunities import/route
- `frontend/src/config/pages/clusters.config.tsx` - Ideas count badge styling
- `frontend/src/config/pages/ideas.config.tsx` - Clickable cluster link
- `frontend/src/templates/ContentViewTemplate.tsx` - Removed duplicate tags/categories
- `frontend/src/components/common/ProgressModal.tsx` - Fixed placeholder texts
- `docs/30-FRONTEND/PAGES.md` - Removed KeywordOpportunities references, updated version
- `docs/20-API/ENDPOINTS.md` - Added Content Settings API documentation

### Files Deleted
- `frontend/src/pages/Planner/KeywordOpportunities.tsx`

---

## v1.1.4 - December 27, 2025

### Section 2 SETUP Modules Implementation

**Add Keywords Page (`/setup/add-keywords`):**
- Added "Not Yet Added Only" filter toggle to show only keywords not in workflow
- Added keyword count summary: "X keywords in your workflow • Y available to add"
- Added "Next: Plan Your Content →" CTA button (appears after adding keywords)
- Added "Keyword Research coming soon!" teaser text
- Sector requirement tooltip already existed - no changes needed

**Content Settings Page (`/account/content-settings`):**
- **NEW Backend API**: Created `/v1/system/settings/content/<pk>/` endpoints
  - `GET /v1/system/settings/content/content_generation/` - Retrieve settings
  - `POST /v1/system/settings/content/content_generation/save/` - Save settings
  - `GET /v1/system/settings/content/publishing/` - Retrieve settings
  - `POST /v1/system/settings/content/publishing/save/` - Save settings
- Content Generation tab now persists: append_to_prompt, default_tone, default_length
- Publishing tab now persists: auto_publish_enabled, auto_sync_enabled
- Fixed false "saved" confirmation - now actually saves to backend

**Sites Module:**
- **NEW Component**: Created `SiteSetupChecklist` component showing setup progress
  - Displays checklist: Site created, Industry/Sectors, WordPress integration, Keywords
  - Progress bar with percentage
  - "Complete Setup" button linking to first incomplete item
  - "Ready to create content!" message when all complete
- Updated Site Dashboard to use SiteSetupChecklist instead of mock stats
- Removed mock statistics that showed all zeros

**Cleanup:**
- Deleted `pages/Sites/Manage.tsx` (redundant duplicate of List.tsx)
- Removed empty `pages/Sites/Builder/` folder structure
- Removed `/sites/manage` route from App.tsx
- Removed SiteManage lazy import from App.tsx

### Files Changed
- `frontend/src/pages/Setup/IndustriesSectorsKeywords.tsx`
- `frontend/src/pages/account/ContentSettingsPage.tsx`
- `frontend/src/pages/Sites/Dashboard.tsx`
- `frontend/src/App.tsx`
- `backend/igny8_core/modules/system/settings_views.py`
- `backend/igny8_core/modules/system/urls.py`

### Files Created
- `frontend/src/components/sites/SiteSetupChecklist.tsx`

### Files Deleted
- `frontend/src/pages/Sites/Manage.tsx`
- `frontend/src/pages/Sites/Builder/` (empty directory)

---

## v1.1.3 - December 27, 2025

### Changed
- **Merged RULES.md into .rules** - Single rules file for AI agents
  - Added documentation rules section to `.rules`
  - Deleted redundant `RULES.md` file
  - Now only one rules file: `.rules`

---

## v1.1.2 - December 27, 2025

### Added
- **Module Status section** in `.rules` file showing active/inactive modules
  - Linker, Optimizer marked as ⏸️ Inactive (Phase 2)
  - SiteBuilder marked as ❌ Removed (deprecated)
- **TODOS.md** file for tracking deprecated code cleanup
  - Template for logging SiteBuilder and other deprecated code

### Changed
- Updated "Don't Do" list with warnings about inactive modules and SiteBuilder

---

## v1.1.1 - December 27, 2025

### Changed
- **Rules File Overhaul**: Simplified `.rules` file for AI agents
  - Reduced from 300+ lines to ~150 lines
  - Added clear Docker container names and correct exec commands
  - Added one-line rules format for quick reading
  - Added quick reference table pointing to INDEX.md
  - Removed verbose code examples (agents should read actual codebase)
  - Added changelog format with git reference requirement
  - **Added Data Scoping section** clarifying Global vs Account vs Site/Sector models
  - Global settings (API keys, prompts, author profiles) are platform-wide, NOT account-scoped
  - Site/Sector models (Keywords, Clusters, Content) need site+sector filtering

### Added
- **MODELS.md**: Added Data Scoping Overview table and Global Models section
  - Documents `GlobalIntegrationSettings`, `GlobalAIPrompt`, `GlobalAuthorProfile`
  - Clear distinction between Global/Account/Site scoped models

---

## v1.1.0 - December 25, 2025

### Major Changes

**Page Consolidation:**
- **AccountSettingsPage**: Consolidated into 3 tabs (Account, Profile, Team)
  - Merged separate Team and Profile pages into single Account Settings page
  - Removed redundant TeamManagement.tsx and ProfileSettings.tsx pages
- **ContentSettingsPage**: Rebuilt with 3 tabs (Content Generation, Publishing, Image Settings)
  - Content Generation: Append to prompt, default tone, default length
  - Publishing: WordPress auto-publish and sync toggles (removed Shopify/IGNY8)
  - Image Settings: Quality, style, sizes, format settings
- **PlansAndBillingPage**: Simplified to 3 tabs (Plan, Upgrade, History)
  - Removed duplicate Usage tab (Usage is separate page)

**Sidebar Navigation Cleanup:**
- Removed empty SETTINGS section label
- Moved AI Models to ACCOUNT section
- Removed version badge below logo
- Removed slogan widget from sidebar bottom
- Reduced vertical spacing between menu items
- Darkened group label colors for better visibility
- Removed Publishing menu item (moved to Content Settings tab)
- Removed Team, Profile, Import/Export menu items (consolidated)

**Route Updates:**
- Added redirects for legacy paths (/team, /profile, /import-export)
- Updated navigation to new consolidated pages

### Added
- **Pre-Launch Audit Document**: Comprehensive module-by-module audit
  - 37 issues identified (10 critical, 14 high, 13 medium)
  - Implementation phases defined
  - Quick wins listed
  - Orphaned files identified

### UX Improvements (Earlier in Dec 25)
- User-friendly text across all pages
- Improved Dashboard text per plan type
- Better descriptions in Planner, Writer, Automation modules
- Updated Sites and Add Keywords pages
- Improved Help documentation

### Fixed
- PlansAndBillingPage nested comment syntax error
- Button component consistency in Publishing settings

### Known Issues (from Audit)
- Content Generation/Publishing settings not connected to backend API
- Profile settings save is placeholder (no API)
- Password change button non-functional
- API Activity data is hardcoded
- Support buttons in Help have no handlers

## v1.0.5 - December 12, 2025

### Added
- **Purchase Credits Tab**: New dedicated tab in Plans & Billing
  - Separated credit package purchases from Credits Overview
  - Shows all available credit packages in horizontal scrollable layout
  - Payment method requirement notice for users without payment methods

### Changed
- **Plans & Billing Tab Organization**: 4 tabs instead of 3
  - Current Plan → Credits Overview → Purchase Credits → Billing History
- **Link Updates**: Purchase Credits buttons now link to correct tab

---

## v1.0.4 - December 12, 2025

### Added
- **Credit Activity Tab**: Transaction history in Usage Analytics
- **Credit Costs Reference Panel**: Shows cost per operation type

### Changed
- **Usage Analytics Reorganization**: 3 tabs (Limits & Usage, Activity, API Usage)

---

## v1.0.3 - December 12, 2025

### Added
- **Color Variety in Usage Limits**: Subtle color accents per limit type
- **Credit Cost Breakdown Panel**: Detailed cost analytics

### Changed
- **Plans & Billing Enhancement**: Cost analytics in Credits Overview tab
- **Comprehensive Color Refactoring**: All components use CSS variables

---

## v1.0.2 - December 12, 2025

### Changed
- **UI/UX Reorganization**: Consolidated Usage Analytics layout
- **Design System Enforcement**: Standardized IGNY8 brand colors

### Removed
- `frontend/src/styles/account-colors.css` - deprecated custom color file

---

## v1.0.1 - December 12, 2025

### Fixed
- Usage summary endpoint routing

### Added
- **Frontend Plan Limits Display**: Visual progress bars for all plan limits
- **IGNY8 Brand Styling**: Custom CSS design system

---

## v1.0.0 - December 12, 2025 (Initial Production Release)

### Core Features

**Multi-Tenancy System:**
- Complete account isolation with row-level security
- Multi-site management per account
- Sector-based content organization
- Role-based access control (Owner, Admin, Editor, Viewer)

**Planner Module:**
- Bulk keyword import (CSV)
- AI-powered keyword clustering (GPT-4)
- Global seed keyword database (50+ industries)
- Content idea generation from clusters

**Writer Module:**
- AI content generation (GPT-4)
- Task management and queuing
- Content taxonomy system
- Status workflow (draft, review, published)

**Image Generation:**
- DALL-E 3 and Runware providers
- Featured and in-article images
- Automatic alt text generation

**Automation Pipeline:**
- 7-stage automation (keywords → images)
- Scheduled runs (daily, weekly, monthly)
- Configurable batch sizes

**WordPress Integration:**
- One-click publishing
- Bidirectional sync
- Taxonomy synchronization

**Billing & Credits:**
- Usage-based credit system
- Plan-based limits
- Monthly usage tracking

### Tech Stack
- Django 5.x + DRF
- React 19 + TypeScript
- PostgreSQL + Redis
- Celery + Celery Beat
- Docker deployment

---

## Critical Bug Fixes - December 9, 2025

### Fixed
- **User Swapping Issue**: Redis sessions + NoCacheModelBackend + session integrity checks
- **HMR Navigation Errors**: Single top-level Suspense boundary for Routes
- **Registration Token Issue**: JWT tokens now returned on signup

---

## Pre-1.0 Development

### November-December 2025
- Initial development
- Multi-tenancy architecture
- AI integration (OpenAI, DALL-E, Runware)
- WordPress integration
- Automation pipeline
- Billing system

---

## Changelog Guidelines

When adding entries:
1. Use version format: `v{major}.{minor}.{patch}`
2. Categorize: Added, Changed, Fixed, Removed, Security
3. Include date
4. Reference related documentation if applicable
5. Note breaking changes prominently

**Update this file after every release or significant change.**