igny8/CHANGELOG.md

# IGNY8 Change Log

**Current Version:** 1.1.7  
**Last Updated:** December 27, 2025

---

## Version History

| Version | Date | Summary |
|---------|------|---------|
| 1.1.7 | Dec 27, 2025 | Section 5 HELP module - Support links, Documentation, FAQ updates |
| 1.1.6 | Dec 27, 2025 | Section 4 ACCOUNT modules - Profile API, Password Change, Billing improvements |
| 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.7 - December 27, 2025

### Section 5 HELP Module Implementation

**Support Links Fixed (CRITICAL):**
- Fixed UserDropdown links going to `/profile` (404)
  - "Edit profile" → `/account/settings`
  - "Account settings" → `/account/settings`
  - "Support" → `/help`
- Implemented Contact Support button with `mailto:support@igny8.com`
- Implemented Feature Request button with `mailto:feedback@igny8.com`

**Placeholder Pages Deleted (HIGH):**
- **DELETED** `pages/Help/Docs.tsx` - Empty placeholder
- **DELETED** `pages/Help/SystemTesting.tsx` - Empty placeholder  
- **DELETED** `pages/Help/FunctionTesting.tsx` - Empty placeholder
- Removed routes `/help/docs`, `/help/system-testing`, `/help/function-testing` from App.tsx

**Documentation Added:**
- Added comprehensive Table of Contents with new sections
- Added Dashboard documentation section
- Added Setup Module documentation:
  - Add Keywords (step-by-step guide)
  - Content Settings (3 tabs explained)
  - Sites Management (WordPress integration)
- Added Account & Billing documentation:
  - Account Settings (Account, Profile, Team tabs)
  - Plans & Billing (plan management, cancellation)
  - Usage & Limits (credit tracking, alerts)

**FAQ Expanded:**
- Added 8 new FAQ items:
  - How do credits work?
  - What uses credits?
  - How do I purchase more credits?
  - How do I change my payment method?
  - Can I cancel my subscription?
  - How do I connect WordPress?
  - Why isn't my content syncing to WordPress?
  - Can I schedule automation to run at specific times?
  - What happens if automation fails?

### Files Changed
- `frontend/src/App.tsx` - Removed placeholder help page imports/routes
- `frontend/src/components/header/UserDropdown.tsx` - Fixed all broken links
- `frontend/src/pages/Help/Help.tsx` - Added documentation sections, expanded FAQ, working support buttons

### Files Deleted
- `frontend/src/pages/Help/Docs.tsx`
- `frontend/src/pages/Help/SystemTesting.tsx`
- `frontend/src/pages/Help/FunctionTesting.tsx`

---

## v1.1.6 - December 27, 2025

### Section 4 ACCOUNT Modules Implementation

**Account Settings Page (`/account/settings`):**
- **Profile Tab**: Now loads user data from auth store (name, email, phone, timezone)
- **Password Change**: Added password change modal with validation
  - Connects to `/v1/auth/change-password/` backend endpoint
  - Validates minimum 8 characters, confirmation match
  - Shows success/error feedback via toast
- Added `getUserProfile()`, `updateUserProfile()`, `changePassword()` to billing.api.ts

**Plans & Billing Page (`/account/plans`):**
- **Cancellation Confirmation Modal**: Cancel button now shows confirmation dialog
  - Explains consequences: loss of features, 30-day credit preservation
  - Requires explicit "Yes, Cancel Subscription" confirmation
  - Prevents accidental cancellations

**Usage Analytics Page (`/account/usage`):**
- **Fixed Fake API Activity Data**: Removed hardcoded values
  - Old: Hardcoded "98.5%" success rate, 1,234/567/342 endpoint calls
  - New: Uses real `analytics?.usage_by_type` data
  - Shows "Operations by Type" with actual credits/counts from backend
  - Empty state when no operations recorded

**Cleanup:**
- **DELETED** `TeamManagementPage.tsx` - orphaned page (functionality exists in AccountSettingsPage Team tab)
- Legacy routes verified working: `/account/team` → `/account/settings`, `/settings/profile` → `/account/settings`

### Files Changed
- `frontend/src/services/billing.api.ts` - Added profile/password API functions
- `frontend/src/pages/account/AccountSettingsPage.tsx` - Password change modal, profile loading
- `frontend/src/pages/account/PlansAndBillingPage.tsx` - Cancellation confirmation modal
- `frontend/src/pages/account/UsageAnalyticsPage.tsx` - Real data for API Activity tab

### Files Deleted
- `frontend/src/pages/account/TeamManagementPage.tsx`

---

## 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.**