re org

docs/10-MODULES/PUBLISHER.md

@@ -1,8 +1,8 @@
 # Publisher Module
 
-**Last Verified:** January 3, 2026  
+**Last Verified:** January 17, 2026  
 **Status:** ✅ Active  
-**Version:** 1.3.2
+**Version:** 1.8.0
 **Backend Path:** `backend/igny8_core/modules/publisher/` + `backend/igny8_core/business/publishing/`  
 **Frontend Path:** `frontend/src/pages/Publisher/`
 
@@ -15,10 +15,12 @@
 | Views | `modules/publisher/views.py` | `PublishingRecordViewSet`, `DeploymentViewSet`, `PublishContentViewSet` |
 | Models | `business/publishing/models.py` | `PublishingRecord`, `DeploymentRecord` |
 | Integration Models | `modules/integration/models.py` | `PublishingSettings` |
+| **Unified Settings** | `modules/integration/views/unified_settings.py` | **v1.8.0** Consolidated settings API |
 | Services | `business/publishing/services/*.py` | Publishing orchestration |
 | Scheduler Tasks | `igny8_core/tasks/publishing_scheduler.py` | Celery beat tasks |
 | URLs | `modules/publisher/urls.py` | Publisher endpoints |
 | Frontend | `pages/Publisher/ContentCalendar.tsx` | Content calendar view |
+| **Site Settings** | `pages/Sites/AIAutomationSettings.tsx` | **v1.8.0** Unified settings UI |
 
 ---
 
@@ -32,6 +34,10 @@ The Publisher module manages:
 - Multi-destination publishing
 - **Content calendar visualization**
 
+**Settings Location (v1.8.0):** Site Settings → Automation tab
+
+> ⚠️ **v1.8.0 Change:** The standalone `/publisher/settings` page has been removed. Publishing settings are now configured in Site Settings → Automation tab under "Capacity" and "Schedule" sections.
+
 ---
 
 ## Data Models
@@ -65,7 +71,7 @@ The Publisher module manages:
 | error_log | TextField | Errors encountered |
 | metadata | JSON | Deployment details |
 
-### PublishingSettings (v1.3.2)
+### PublishingSettings (v1.3.2, updated v1.8.0)
 
 Site-level publishing configuration:
 
@@ -79,6 +85,7 @@ Site-level publishing configuration:
 | monthly_publish_limit | Integer | Max publications per month |
 | publish_days | JSON | Days of week for publishing ["mon","wed","fri"] |
 | publish_time_slots | JSON | Time slots for publishing [{"start":"09:00","end":"17:00"}] |
+| **total_items_per_run** | Integer | **v1.8.0** Computed capacity display |
 
 ### Content Site Status Fields (v1.3.2)
 
@@ -94,6 +101,13 @@ Added to Content model for scheduling:
 
 ## API Endpoints
 
+### Unified Settings API (v1.8.0)
+
+| Method | Path | Purpose |
+|--------|------|---------|
+| **GET** | `/api/v1/integration/sites/{site_id}/unified-settings/` | Get all automation + publishing settings |
+| **PATCH** | `/api/v1/integration/sites/{site_id}/unified-settings/` | Update settings |
+
 ### Publishing & Records
 
 | Method | Path | Handler | Purpose |
@@ -115,12 +129,14 @@ Added to Content model for scheduling:
 | **POST** | `/api/v1/writer/content/bulk_schedule/` | Bulk schedule with site defaults | `{ "content_ids": [1,2,3], "use_site_defaults": true, "site_id": 5 }` | `{ "success": true, "scheduled_count": 3, "schedule_preview": [...] }` |
 | **POST** | `/api/v1/writer/content/bulk_schedule_preview/` | Preview bulk schedule times | `{ "content_ids": [1,2,3], "site_id": 5 }` | `{ "schedule_preview": [...], "site_settings": {...} }` |
 
-### Publishing Settings
+### Legacy Publishing Settings (deprecated)
+
+> ⚠️ **Deprecated in v1.8.0:** Use unified-settings API instead
 
 | Method | Path | Purpose |
 |--------|------|---------|
-| **GET** | `/api/v1/sites/{site_id}/settings?tab=publishing` | Get site publishing settings (default schedule, stagger, limits) |
-| **PUT** | `/api/v1/sites/{site_id}/publishing-settings/` | Update publishing settings |
+| ~~GET~~ | ~~`/api/v1/sites/{site_id}/settings?tab=publishing`~~ | ~~Get site publishing settings~~ |
+| ~~PUT~~ | ~~`/api/v1/sites/{site_id}/publishing-settings/`~~ | ~~Update publishing settings~~ |
 
 ---