imp part 5

docs/fixes/phase2-module-activation.md

@@ -0,0 +1,152 @@
+# Phase 2 Module Activation Guide
+
+> Reference document for activating disabled modules (Linker, Optimizer, SiteBuilder)
+
+## Current Status (as of December 2025)
+
+| Module | Status | Backend Flag | Migration |
+|--------|--------|--------------|-----------|
+| **SiteBuilder** | ❌ DEPRECATED | `site_builder_enabled` | Disabled via 0011 |
+| **Linker** | ⏸️ Phase 2 | `linker_enabled` | Disabled via 0011 |
+| **Optimizer** | ⏸️ Phase 2 | `optimizer_enabled` | Disabled via 0011 |
+
+---
+
+## How Module Disabling Works
+
+### 1. Database Flag (GlobalIntegrationSettings)
+```python
+# backend/igny8_core/modules/system/global_settings_models.py
+site_builder_enabled = models.BooleanField(default=False)
+linker_enabled = models.BooleanField(default=False)
+optimizer_enabled = models.BooleanField(default=False)
+```
+
+### 2. Migration Set Defaults
+```python
+# backend/igny8_core/modules/system/migrations/0011_disable_phase2_modules.py
+# Sets all three modules to disabled for existing records
+```
+
+### 3. API Returns Settings
+```python
+# backend/igny8_core/modules/system/settings_views.py
+# GET /api/module-settings/ returns enabled/disabled status
+```
+
+### 4. Frontend Checks Settings
+```typescript
+// frontend/src/store/moduleStore.ts
+// useModuleStore.isModuleEnabled('linker') → checks API response
+```
+
+### 5. Sidebar Hides Menu Items
+```tsx
+// frontend/src/layout/AppSidebar.tsx
+if (isModuleEnabled('linker')) {
+  // Add menu item
+}
+```
+
+---
+
+## Activation Steps for Phase 2
+
+### Option A: Via Django Admin (Recommended)
+
+1. Log into Django Admin (`/admin/`)
+2. Navigate to **System → Global Integration Settings**
+3. Edit the singleton record
+4. Set `linker_enabled` or `optimizer_enabled` to `True`
+5. Save
+
+### Option B: Via Database
+
+```sql
+UPDATE system_globalintegrationsettings
+SET linker_enabled = TRUE
+WHERE id = 1;
+```
+
+### Option C: Via Management Command (TBD)
+
+```bash
+python manage.py enable_module linker
+python manage.py enable_module optimizer
+```
+
+---
+
+## Pre-Activation Checklist
+
+Before enabling a Phase 2 module:
+
+### Linker Module
+- [ ] Verify `modules/linker/views.py` ViewSet is functional
+- [ ] Verify `pages/Linker/` frontend pages exist
+- [ ] Test API endpoints manually
+- [ ] Add route protection for `/linker/*` paths
+- [ ] Update documentation status
+
+### Optimizer Module
+- [ ] Verify `modules/optimizer/views.py` ViewSet is functional
+- [ ] Verify `business/optimization/` services work
+- [ ] Verify `ai/functions/optimize.py` AI function
+- [ ] Verify `pages/Optimizer/` frontend pages exist
+- [ ] Test API endpoints manually
+- [ ] Add route protection for `/optimizer/*` paths
+- [ ] Update documentation status
+
+---
+
+## Route Protection (TODO for Phase 2)
+
+Currently, direct URL access (e.g., `/linker`) still works even when module is disabled.
+
+### Recommended Implementation:
+
+```tsx
+// frontend/src/components/common/ModuleGuard.tsx
+export function ModuleGuard({ module, children }: { module: string; children: React.ReactNode }) {
+  const { isModuleEnabled } = useModuleStore();
+  
+  if (!isModuleEnabled(module)) {
+    return <Navigate to="/" replace />;
+  }
+  
+  return <>{children}</>;
+}
+
+// In routes:
+<Route path="/linker/*" element={
+  <ModuleGuard module="linker">
+    <LinkerPage />
+  </ModuleGuard>
+} />
+```
+
+---
+
+## SiteBuilder (DEPRECATED)
+
+**Do NOT activate SiteBuilder.** This module is deprecated and code is being removed.
+
+### Removed Items (Task 5.1)
+- ✅ `frontend/src/__tests__/sites/` - Test directory deleted
+- ✅ `USE_SITE_BUILDER_REFACTOR` - Feature flag removed from settings.py
+- ✅ Feature flag checks - Removed from clustering_service.py, validation_service.py, serializers.py
+- ✅ Tasks.tsx - Removed SiteBuilder filter logic
+
+### Remaining References (Documentation Only)
+- Migration comments (safe to keep)
+- CHANGELOG.md entries (historical)
+- IGNY8-APP.md (documents deprecated status)
+- Database field (kept for backward compatibility)
+
+---
+
+## Related Documentation
+
+- [LINKER.md](../10-MODULES/LINKER.md) - Full Linker module docs
+- [OPTIMIZER.md](../10-MODULES/OPTIMIZER.md) - Full Optimizer module docs
+- [SYSTEM-SETTINGS.md](../10-MODULES/SYSTEM-SETTINGS.md) - Settings model reference