docs updated v1.2.0

2025-12-27 23:27:07 +00:00
parent e0f3060df9
commit 28a60f8141
8 changed files with 380 additions and 29 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # IGNY8 Change Log

-**Current Version:** 1.1.8  
+**Current Version:** 1.2.0  
 **Last Updated:** December 27, 2025

 ---
@@ -9,6 +9,8 @@

 | Version | Date | Summary |
 |---------|------|---------|
+| 1.2.0 | Dec 27, 2025 | **Final Launch Release** - Notifications system, Dashboard widgets, ThreeWidgetFooter, UI polish |
+| 1.1.9 | Dec 27, 2025 | UI improvements - PageContext, SearchModal, AppHeader/Layout updates |
 | 1.1.8 | Dec 27, 2025 | Section 6 SIDEBAR restructure - Dropdowns, breadcrumbs, navigation cleanup |
 | 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 |
@@ -27,6 +29,187 @@

 ---

+## v1.2.0 - December 27, 2025
+
+### Final Launch Release - Notifications, Dashboard, UI Polish
+
+This release marks the final pre-launch state with comprehensive UI polish, real-time notifications, and dashboard overhaul.
+
+**Backend: Notifications Module**
+- **NEW MODULE**: `backend/igny8_core/business/notifications/`
+  - Models: `Notification`, `NotificationPreference`
+  - NotificationType choices: AI operations (cluster/ideas/content/images complete/failed), workflow events, WordPress sync, credits/billing, system
+  - Services: `NotificationService` for creating/managing notifications
+  - REST API: `/api/v1/notifications/` endpoints
+- Registered in `settings.py` INSTALLED_APPS
+- Added URL routing in `urls.py`
+
+**Frontend: Notification System**
+- **NEW STORE**: `notificationStore.ts` - Zustand store for notification management
+  - In-memory queue for optimistic UI
+  - API sync for persistent notifications
+  - Auto-dismissal with configurable timeout
+  - Read/unread state tracking
+  - Category-based filtering (ai_task, system, info)
+- **NEW API SERVICE**: `notifications.api.ts`
+  - `fetchNotifications()`, `fetchUnreadCount()`
+  - `markNotificationRead()`, `markAllNotificationsRead()`
+  - `deleteNotification()`
+- **UPDATED**: `NotificationDropdown.tsx` - Real notification integration
+
+**Frontend: Dashboard Home Overhaul**
+- **NEW WIDGETS** in `components/dashboard/`:
+  - `WorkflowPipelineWidget.tsx` - Visual flow: Sites → Keywords → Clusters → Ideas → Tasks → Drafts → Published
+  - `AIOperationsWidget.tsx` - Operation stats with time filter (7d/30d/90d)
+  - `RecentActivityWidget.tsx` - Activity feed with type icons
+  - `ContentVelocityWidget.tsx` - Week/Month/Total metrics table
+  - `AutomationStatusWidget.tsx` - Status, schedule, last/next run info
+  - `NeedsAttentionBar.tsx` - Alert bar for pending actions
+  - `QuickActionsWidget.tsx` - Quick action buttons
+  - `CreditAvailabilityWidget.tsx` - Credit balance display
+  - `OperationsCostsWidget.tsx` - Cost breakdown by operation type
+  - `SiteConfigWidget.tsx` - Site configuration status
+- Updated `Home.tsx` to use new dashboard widgets with real data from APIs
+
+**Frontend: ThreeWidgetFooter Component**
+- **NEW COMPONENT**: `ThreeWidgetFooter.tsx` - 3-column footer for table pages
+  - Widget 1: Page Progress (metrics + progress bar)
+  - Widget 2: Module Stats (pipeline flow with arrows)
+  - Widget 3: Completion (tree structure for both modules)
+- **NEW HOOK**: `useThreeWidgetFooter.ts` - Data preparation hook
+- **IMPLEMENTED ON**: Keywords, Clusters, Ideas, Tasks, Content pages
+
+**Frontend: Page Rename - Published → Approved**
+- **RENAMED**: `Writer/Published.tsx` → `Writer/Approved.tsx`
+- **RENAMED**: Config `published.config.tsx` → `approved.config.tsx`
+- **ROUTE**: `/writer/approved` (legacy `/writer/published` redirects)
+- Updated sidebar navigation label to "Approved"
+
+**Frontend: Site Selectors**
+- **NEW COMPONENTS**:
+  - `SingleSiteSelector.tsx` - Simple site dropdown
+  - `SiteWithAllSitesSelector.tsx` - Site selector with "All Sites" option
+- Updated `SiteAndSectorSelector.tsx` for improved UX
+- Enhanced `PageHeader.tsx` with badge props and breadcrumb support
+
+**Backend: SiteSerializer Fixes**
+- Fixed `has_integration` field to use `platform` field (not `integration_type`)
+- Added missing serializer fields for frontend consumption
+
+**Progress Modal Text Updates**
+- Fixed placeholder "X" text in image prompt steps
+- Improved step labels with actual counts when available
+
+### Files Added
+```
+backend/igny8_core/business/notifications/
+├── __init__.py
+├── admin.py
+├── apps.py
+├── models.py
+├── serializers.py
+├── services.py
+├── urls.py
+├── views.py
+└── migrations/0001_initial.py
+
+frontend/src/components/dashboard/
+├── AIOperationsWidget.tsx
+├── AutomationStatusWidget.tsx
+├── ContentVelocityWidget.tsx
+├── CreditAvailabilityWidget.tsx
+├── NeedsAttentionBar.tsx
+├── OperationsCostsWidget.tsx
+├── QuickActionsWidget.tsx
+├── RecentActivityWidget.tsx
+├── SiteConfigWidget.tsx
+├── ThreeWidgetFooter.tsx
+└── WorkflowPipelineWidget.tsx
+
+frontend/src/components/common/
+├── SingleSiteSelector.tsx
+└── SiteWithAllSitesSelector.tsx
+
+frontend/src/hooks/useThreeWidgetFooter.ts
+frontend/src/services/notifications.api.ts
+frontend/src/store/notificationStore.ts
+```
+
+### Files Modified
+- `backend/igny8_core/settings.py` - Added notifications to INSTALLED_APPS
+- `backend/igny8_core/urls.py` - Added notifications URL routing
+- `backend/igny8_core/auth/serializers.py` - Fixed SiteSerializer fields
+- `backend/igny8_core/ai/engine.py` - Progress tracking updates
+- `frontend/src/App.tsx` - Route updates for approved page
+- `frontend/src/layout/AppHeader.tsx` - Dashboard context support
+- `frontend/src/layout/AppLayout.tsx` - Layout improvements
+- `frontend/src/layout/AppSidebar.tsx` - Navigation label updates
+- `frontend/src/pages/Dashboard/Home.tsx` - Complete dashboard overhaul
+- `frontend/src/pages/Writer/*.tsx` - ThreeWidgetFooter integration
+- `frontend/src/pages/Planner/*.tsx` - ThreeWidgetFooter integration
+- `frontend/src/components/common/ProgressModal.tsx` - Text fixes
+- `frontend/src/components/common/SiteCard.tsx` - Setup checklist updates
+- `frontend/src/config/pages/*.config.tsx` - Column/action updates
+- `frontend/src/config/routes.config.ts` - Route updates
+- `frontend/src/context/PageContext.tsx` - Enhanced page context
+- `frontend/src/icons/index.ts` - New icon exports
+
+---
+
+## v1.1.9 - December 27, 2025
+
+### UI Infrastructure & Polish
+
+**PageContext System**
+- **NEW**: `PageContext.tsx` - React context for page-level state management
+  - Provides site filter, sector filter state to nested components
+  - Enables AppHeader to access current page info
+
+**Search Modal**
+- **NEW**: `SearchModal.tsx` - Global search modal component
+  - Cmd+K / Ctrl+K keyboard shortcut
+  - Search across pages, content, keywords
+
+**Header & Layout Updates**
+- Enhanced `AppHeader.tsx`:
+  - Site filter integration
+  - Breadcrumb support
+  - Search modal trigger
+  - Improved responsive behavior
+- Updated `AppLayout.tsx`:
+  - Better sidebar/content coordination
+  - Dark mode improvements
+- Updated `AppSidebar.tsx`:
+  - Module dropdown improvements
+  - Active state indicators
+
+**Table Template Improvements**
+- Enhanced `TablePageTemplate.tsx`:
+  - Better filter UI
+  - Improved empty states
+  - Column configuration updates
+- Updated page configs for consistency
+
+**Style Updates**
+- `igny8-colors.css` - Token refinements
+- Dark mode consistency improvements
+
+### Files Added
+- `frontend/src/components/common/SearchModal.tsx`
+- `frontend/src/context/PageContext.tsx`
+- `docs/30-FRONTEND/PAGE-REQUIREMENTS.md`
+
+### Files Modified
+- `frontend/src/layout/AppHeader.tsx`
+- `frontend/src/layout/AppLayout.tsx`
+- `frontend/src/layout/AppSidebar.tsx`
+- `frontend/src/templates/TablePageTemplate.tsx`
+- `frontend/src/pages/Planner/*.tsx`
+- `frontend/src/pages/Writer/*.tsx`
+- `frontend/src/styles/igny8-colors.css`
+
+---
+
 ## v1.1.8 - December 27, 2025

 ### Section 6 Sidebar & Navigation Restructure