Sindbad~EG File Manager

# Church Conference Management Platform
## The Church of Pentecost - Madina Area

A comprehensive event management platform designed specifically for church conferences and events, featuring role-based access control, event registration, ticketing, and administrative tools.

## Features

### 🏛️ **Multi-Level Organization**
- **Area Management**: Top-level organizational structure
- **District Management**: Mid-level administrative divisions
- **Assembly Management**: Local church assemblies

### 👥 **User Management & Roles**
- **Superuser**: Full system access (nabibo2@yahoo.co.uk)
- **Area Admin**: Area-wide management capabilities
- **District Admin**: District-specific administration
- **Assembly Admin**: Assembly-level management
- **Members**: Event registration and participation
- **Non-Members**: Guest registration with tracking codes

### 🎫 **Event Management**
- Professional event pages with SEO optimization
- Multiple ticket types (Free, Paid, Donation, Tiered)
- Capacity management and registration tracking
- Early bird pricing and promo codes
- Event form builder with custom templates
- Real-time countdown timers

### 💳 **Registration & Ticketing**
- Member and non-member registration
- Automatic registration code generation
- Payment status tracking
- Event-specific custom forms
- Bulk messaging capabilities

### 📊 **Analytics & Reporting**
- Real-time dashboard statistics
- Registration analytics
- Revenue tracking
- Attendance management
- Export capabilities

### 🔔 **Communication**
- Notification system
- Email integration ready
- Event sharing (Social media, WhatsApp)
- Bulk messaging tools

### 🔒 **Security & Audit**
- Role-based access control
- Comprehensive audit logging
- Session management
- Input validation and sanitization

## Technology Stack

- **Frontend**: HTML5, Tailwind CSS, JavaScript, Vue.js 3
- **Backend**: PHP 7.4+, MySQL 8.0+
- **Server**: Apache (XAMPP compatible)
- **Design**: Gradient blue, gray, white theme with professional styling

## Installation

### Prerequisites
- XAMPP with PHP 7.4+ and MySQL 8.0+
- Web browser with JavaScript enabled

### Setup Instructions

1. **Clone/Download the project**
   ```bash
   # Place the project in your XAMPP htdocs directory
   C:\xampp\htdocs\copmadinaconf\
   ```

2. **Database Setup**
   - Start XAMPP (Apache and MySQL)
   - Open phpMyAdmin (http://localhost/phpmyadmin)
   - Create a new database named `copmadinaconf`
   - Import the schema: `database/schema.sql`
   - Import sample data: `database/sample_data.sql`

3. **Configuration**
   - Database settings are in `config/database.php`
   - Default settings work with standard XAMPP installation
   - Modify if using custom database credentials

4. **File Permissions**
   - Ensure `uploads/` directory is writable
   - Create `assets/images/` directory if not exists

5. **Access the Application**
   - Open: http://localhost/copmadinaconf/
   - Login with demo accounts (see below)

## Demo Accounts

### Superuser Account
- **Email**: nabibo2@yahoo.co.uk
- **Username**: nabibo
- **Password**: password123
- **Access**: Full system administration

### Admin Accounts
- **Area Admin**: area.admin@cop.org / password123
- **District Admin**: madina.district@cop.org / password123
- **Assembly Admin**: madina.central@cop.org / password123

### Member Accounts
- **Member 1**: john.doe@example.com / password123
- **Member 2**: jane.smith@example.com / password123

*All demo accounts use the password: **password123***

## System Architecture

### Directory Structure
```
copmadinaconf/
├── assets/
│   └── images/           # Image assets
├── config/
│   └── database.php      # Database configuration
├── database/
│   ├── schema.sql        # Database schema
│   └── sample_data.sql   # Sample data
├── includes/
│   └── functions.php     # Core functions
├── uploads/              # File uploads
├── index.php            # Landing page
├── login.php            # Authentication
├── dashboard.php        # User dashboard
├── event.php            # Event details
├── register.php         # Event registration
├── district.php         # District events
├── assembly.php         # Assembly events
└── README.md            # This file
```

### Database Schema
- **Users & Roles**: Multi-level user management
- **Organizations**: Areas, Districts, Assemblies
- **Events**: Comprehensive event management
- **Registration**: Member and non-member tracking
- **Ticketing**: Multiple ticket types and pricing
- **Forms**: Dynamic form builder
- **Audit**: Complete activity logging

## Key Features Walkthrough

### 1. **Landing Page**
- Professional gradient design
- Featured event with countdown timer
- Upcoming events grid
- Responsive navigation

### 2. **Event Registration**
- Supports both members and non-members
- Dynamic form fields based on event
- Registration code generation
- Payment tracking integration

### 3. **Role-Based Dashboard**
- Customized views per user role
- Real-time statistics
- Quick access to relevant functions
- Notification center

### 4. **Event Management**
- Rich event details pages
- Social sharing capabilities
- Capacity management
- SEO optimization

## Customization

### Theme Colors
The system uses a professional gradient theme:
- **Primary**: Blue gradients (#667eea to #764ba2)
- **Secondary**: Gray and white
- **Accents**: Green, yellow, red for status indicators

### Adding New Features
1. Create new PHP files following the existing structure
2. Use the `includes/functions.php` for common operations
3. Follow the established UI patterns with Tailwind CSS
4. Implement proper role-based access control

### Database Modifications
- Use migrations for schema changes
- Update `includes/functions.php` for new database operations
- Maintain audit logging for all changes

## Security Considerations

- All user inputs are sanitized
- Password hashing using PHP's password_hash()
- Session management with timeouts
- Role-based access control throughout
- SQL injection prevention with prepared statements
- XSS protection with htmlspecialchars()

## Support & Development

### Common Issues
1. **Database Connection**: Check XAMPP MySQL service
2. **File Permissions**: Ensure uploads directory is writable
3. **Session Issues**: Clear browser cache and cookies

### Development Guidelines
- Follow PSR coding standards
- Use prepared statements for all database queries
- Implement proper error handling
- Maintain audit trails for all actions
- Use responsive design principles

### 📋 **Attendance Management**
- Real-time check-in/check-out system
- Registration code lookup
- Attendance duration tracking
- Admin check-out capabilities
- Comprehensive attendance reports

### 🛠️ **Administrative Tools**
- Event registration management
- User role administration
- System settings configuration
- Database backup and restore
- Activity audit logs

## Recent Updates (September 2024)

### ✅ **Completed Features**
- **Event Check-Out System**: Fixed and enhanced check-out functionality for both user-facing attendance status page and admin interface
- **Admin Registration Management**: Fixed edit and delete action buttons on admin registrations page
- **Attendance Reports**: Added admin check-out capabilities directly from attendance reports
- **Database Optimization**: Enhanced queries for better performance with member and non-member registrations
- **User Experience**: Improved confirmation dialogs and success/error messaging
- **Code Cleanup**: Removed debug scripts and test files for production readiness

### 🔧 **Technical Improvements**
- Enhanced Vue.js integration for admin modals
- Improved form submission handling with proper validation
- Better error handling and user feedback
- Optimized database queries for attendance tracking
- Added comprehensive activity logging for audit trails

## Future Enhancements

- **Payment Gateway Integration**: Stripe, PayPal, Mobile Money
- **Email System**: SMTP integration for notifications
- **SMS Integration**: Bulk SMS capabilities
- **Mobile App**: React Native companion app
- **Advanced Reporting**: PDF generation, charts
- **Multi-language Support**: Internationalization
- **API Development**: RESTful API for third-party integrations

## License

This project is developed for The Church of Pentecost - Madina Area. All rights reserved.

## Contact

For support or inquiries:
- **Email**: info@copmadinaconf.org
- **Phone**: +233 XX XXX XXXX

---

**Version**: 1.1.0  
**Last Updated**: September 2024  
**Developed by**: Church Management Systems Team

## System Status

### ✅ **Production Ready Features**
- Event Management & Registration System
- User Authentication & Role Management
- Attendance Check-In/Check-Out System
- Admin Registration Management
- Attendance Reports & Analytics
- Database Schema & Sample Data

### 🔧 **System Health**
- All core functionality tested and working
- Database optimized for performance
- Security measures implemented
- Code cleaned and production-ready
- Documentation updated and comprehensive

### 📊 **Key Metrics**
- Multi-role user management (5 user types)
- Support for unlimited events and registrations
- Real-time attendance tracking
- Comprehensive audit logging
- Responsive design for all devices