Sindbad~EG File Manager

# Leadership Module Implementation Summary

## Overview
Added a new **Leadership** tab to the Demography 1 module for tracking church leadership statistics.

---

## Database Changes

### New Table: `leadership_data`

**Location:** `database/leadership_table.sql`

**Fields:**
- `id` - Primary key
- `area_id` - Foreign key to areas table
- `district_id` - Foreign key to districts table
- `assembly_id` - Foreign key to assemblies table
- `elders` - Number of elders
- `deacons` - Number of deacons
- `deaconesses` - Number of deaconesses
- `leaders` - Number of leaders
- `ministers` - Number of ministers
- `ministers_wives` - Number of ministers' wives
- `total_leadership` - Auto-calculated total (generated column)
- `created_by` - User who created the record
- `updated_by` - User who last updated the record
- `created_at` - Timestamp
- `updated_at` - Timestamp

**Constraints:**
- Unique constraint per assembly (one leadership record per assembly)
- Foreign keys to areas, districts, assemblies, and users tables
- Indexes on area_id, district_id, assembly_id, and created_at

---

## Data Entry Form Updates

**File:** `dashboard/demography-entry.php`

### Changes Made:

1. **New Tab Added:**
   - Added "Leadership" tab button to navigation
   - Tab appears after Membership, Souls, and Transfers tabs

2. **Leadership Form Section:**
   - 6 input fields for leadership categories:
     - Elders
     - Deacons
     - Deaconesses
     - Leaders
     - Ministers
     - Ministers Wives
   - Auto-calculated "Total Leadership" field (read-only)
   - Purple-themed section (bg-purple-50) for visual distinction

3. **Form Submission Handling:**
   - Added `submit_leadership` handler
   - Validates location selection (area, district, assembly)
   - Checks for duplicate entries per assembly
   - Inserts data into `leadership_data` table
   - Creates audit log entry
   - Sends success notification to user

4. **JavaScript Functions:**
   - `calculateLeadershipTotal()` - Auto-calculates total leadership count
   - `resetLeadershipForm()` - Resets all leadership fields with confirmation
   - Event listeners for real-time calculation on input change
   - Form validation before submission

---

## Features

✅ **Real-time Calculations:** Total leadership count updates automatically as values are entered

✅ **Form Validation:** Ensures area, district, and assembly are selected before submission

✅ **Duplicate Prevention:** Prevents multiple leadership records for the same assembly

✅ **Audit Logging:** All data entries are logged for accountability

✅ **User Notifications:** Success/error messages displayed to users

✅ **Responsive Design:** Mobile-friendly layout with proper grid structure

✅ **Access Control:** Respects user level permissions (area, district, assembly)

---

## Next Steps

### Pending Implementation:

1. **Demography Reports Form** (`dashboard/demography-reports.php`)
   - Add Leadership data to report generation
   - Include leadership statistics in summary reports
   - Add leadership columns to export formats (PDF, Excel, CSV)

2. **Demography Edit Form** (`dashboard/demography-edit.php`)
   - Add Leadership tab for editing existing records
   - Enable CRUD operations for leadership data
   - Apply same access control filters

3. **Testing:**
   - Test data entry for all leadership fields
   - Verify calculations are accurate
   - Test duplicate prevention
   - Verify access control filtering
   - Test on mobile devices

---

## Database Setup Instructions

Run the following command to create the leadership_data table:

```bash
mysql -u copmadinaarea_nabibo -p copmadinaarea_copreports < database/leadership_table.sql
```

Or via phpMyAdmin:
1. Select database: `copmadinaarea_copreports`
2. Go to Import tab
3. Choose file: `database/leadership_table.sql`
4. Click "Go"

---

## Usage Guide

### For Data Entry Users:

1. Navigate to **Data Entry → Demography 1**
2. Select Area, District, and Assembly
3. Click on the **Leadership** tab
4. Enter values for each leadership category:
   - Elders
   - Deacons
   - Deaconesses
   - Leaders
   - Ministers
   - Ministers Wives
5. The "Total Leadership" field will automatically calculate
6. Click **Save Leadership Data**
7. Success message will confirm the data has been saved

### Notes:
- All fields accept numeric values (0 or greater)
- Total is calculated automatically
- One leadership record per assembly
- Use Data Edit page to update existing records

---

## Technical Details

### Auto-Calculation Logic:
```javascript
total_leadership = elders + deacons + deaconesses + leaders + ministers + ministers_wives
```

### Database Generated Column:
```sql
total_leadership INT GENERATED ALWAYS AS (
    elders + deacons + deaconesses + leaders + ministers + ministers_wives
) STORED
```

### Color Scheme:
- Background: `bg-purple-50` (light purple)
- Consistent with other tabs (blue for membership, green for souls, orange for transfers)

---

## Status: ✅ Partially Complete

**Completed:**
- ✅ Database table created
- ✅ Data entry form with Leadership tab
- ✅ Form submission handling
- ✅ JavaScript calculations
- ✅ Audit logging
- ✅ Notifications

**Pending:**
- ⏳ Reports integration
- ⏳ Edit form integration
- ⏳ Testing

---

**Last Updated:** December 21, 2025
**Version:** 1.0.0