Sindbad~EG File Manager

================================================================================
 MODULE MANAGEMENT - QUICK START GUIDE
================================================================================

WHAT IS THIS?
-------------
Module Management lets superusers control which modules (features) are visible
to different admin levels:
- Assembly Admins (single church)
- District Admins (multiple churches)
- Area Admins (multiple districts)
- Superusers (all access)

================================================================================
 INSTALLATION (ONE-TIME SETUP)
================================================================================

1. Visit: http://localhost/copmadinaarea/install_module_management.php
2. Click through the installation
3. Done! Module Management is now available in your sidebar

================================================================================
 HOW TO USE
================================================================================

STEP 1: Access the Module
--------------------------
From your dashboard sidebar:
  System → Module Management

STEP 2: Understand the Interface
---------------------------------
You'll see a table with:
- Module Name (left column)
- 4 Toggle Columns: Assembly | District | Area | Superuser
- Status Column: Active/Inactive
- Actions Column: Power button

STEP 3: Control Module Access
------------------------------
For each module, you can:

✓ Enable/Disable for Assembly Admins:
  - Toggle under "Assembly" column
  - Green = They can see it
  - Gray = They cannot see it

✓ Enable/Disable for District Admins:
  - Toggle under "District" column

✓ Enable/Disable for Area Admins:
  - Toggle under "Area" column

✓ Superuser column is always enabled (cannot be disabled)

STEP 4: Activate/Deactivate Entire Modules
-------------------------------------------
Use the power button in Actions column:
- Deactivated modules are hidden from EVERYONE
- Critical modules (Dashboard, Settings, etc.) cannot be deactivated

================================================================================
 EXAMPLES
================================================================================

Example 1: Hide "Member Accounts" from Assembly Admins
-------------------------------------------------------
1. Find "Member Accounts" row in the table
2. Click the toggle under "Assembly" column (turn it OFF)
3. That's it! Assembly admins won't see it anymore

Example 2: Make "Events" Available to All Levels
-------------------------------------------------
1. Find "Events" row
2. Make sure all toggles are ON:
   - Assembly: ON
   - District: ON
   - Area: ON
   - Superuser: ON (always ON)
3. All admin levels can now access Events

Example 3: Create District-Only Module
---------------------------------------
1. Find the module you want to restrict
2. Set toggles:
   - Assembly: OFF (turn OFF)
   - District: ON
   - Area: ON
   - Superuser: ON
3. Now only District admins and above can access

================================================================================
 IMPORTANT RULES
================================================================================

✓ CAN DO:
  - Enable/disable for Assembly, District, Area levels
  - Deactivate non-critical modules
  - View change history

✗ CANNOT DO:
  - Disable critical modules (Dashboard, Settings, Users, Notifications)
  - Disable superuser access (always has full access)
  - Delete modules (can only deactivate)

================================================================================
 CATEGORIES
================================================================================

Modules are organized into categories:
  
  Navigation: Home, Dashboard
  Core Management: Membership, Events, Programs, Ministries
  Event Management: Event Attendance, Forms, Reports
  User Management: Users, Member Accounts, Member Codes
  System: Settings, Email Management, Module Management
  Reports: Notifications, Audit Logs, Reports

================================================================================
 ACCESS LEVEL HIERARCHY
================================================================================

  Superuser 👑
      ↓ (Sees everything)
  Area Admin 🗺️
      ↓ (Sees area + district + assembly modules)
  District Admin 📍
      ↓ (Sees district + assembly modules)
  Assembly Admin ⛪
      ↓ (Sees only assembly modules)

Higher levels automatically see what lower levels see (if enabled).

================================================================================
 TESTING YOUR CHANGES
================================================================================

1. Make changes in Module Management
2. Log out from superuser account
3. Log in as test user (assembly_admin, district_admin, etc.)
4. Check their sidebar menu
5. Verify they can/cannot see the module

TIP: Use create_test_users.php to create test accounts at each level.

================================================================================
 VIEWING CHANGE HISTORY
================================================================================

Scroll to bottom of Module Management page to see:
  "Recent Access Changes"

This shows:
  - What module was changed
  - What access level was affected
  - Who made the change
  - When it was made
  - Action (enabled or disabled)

================================================================================
 TROUBLESHOOTING
================================================================================

Problem: Changes not showing for users
Solution: Ask users to log out and log back in

Problem: Cannot disable a module
Solution: It's a critical module - these cannot be disabled

Problem: Module not in list
Solution: Module may need to be added to database first

Problem: Lost access to Module Management
Solution: Only superusers can access this - log in as superuser

================================================================================
 QUICK ACTIONS
================================================================================

Disable module for Assembly level only:
  [Find module] → [Toggle Assembly OFF] → Done

Enable module for all levels:
  [Find module] → [All toggles ON] → Done

Deactivate entire module:
  [Find module] → [Click power button] → Confirm → Done

View who changed what:
  [Scroll to bottom] → View "Recent Access Changes"

================================================================================
 ACCESS THE SYSTEM
================================================================================

URL: modules/module-management/index.php
Menu: Sidebar → System → Module Management
Access: Superuser only
Status: Active

================================================================================
 NEXT STEPS
================================================================================

1. Review current module access settings
2. Decide which modules each level should see
3. Make your changes using the toggles
4. Test with different user accounts
5. Monitor the audit log
6. Adjust as needed

================================================================================

REMEMBER:
- Changes take effect immediately
- Users must log out and back in to see menu changes
- Critical modules cannot be disabled
- All changes are logged in audit trail

FOR HELP: Read MODULE_MANAGEMENT_GUIDE.md for detailed documentation

================================================================================