🎓 Parlence English Camp — UKM Web Platform

🇬🇧 Empowering Campus English Communities

A modern, elegant, and fully-featured web platform for UKM Parlence English Camp

---

🌟 About

UKM Parlence English Camp is a comprehensive web application designed to foster English language learning within campus communities. Built with modern web technologies, this platform provides a seamless experience for students, instructors, and administrators to connect, learn, and grow together.

✨ Key Features

🎯 Core Functionality

• 📝 Dynamic Content Management — Effortless content updates via intuitive Filament admin panel
• 👥 Member Management — Streamlined registration and profile management system
• 🗓️ Event Scheduling — Comprehensive event planning and calendar integration
• 📚 Learning Resources — Centralized hub for English learning materials and articles

🎨 User Experience

• 📱 Responsive Design — Perfect experience across all devices
• 🎭 Modern UI/UX — Clean, intuitive interface built with Tailwind CSS
• 📸 Rich Media Gallery — Beautiful showcase of activities and achievements
• 💬 Interactive Features — Enhanced community engagement tools

🔧 Administration

• 🛠️ Powerful Admin Panel — Full control via Filament dashboard
• 📊 Analytics & Reporting — Insights into member engagement and activity
• 🔐 Role-Based Access — Secure permission system for different user levels

---

🚀 Technology Stack

Technology	Purpose	Version
Laravel	Backend Framework	10.x
Filament	Admin Panel	3.x
Tailwind CSS	Styling Framework	3.x
MySQL	Database	8.x
PHP	Server Language	8.1+

---

🔧 Installation & Setup

📋 Prerequisites

Before you begin, ensure you have the following installed:

• PHP >= 8.1
• Composer (latest version)
• Node.js & npm (latest LTS)
• MySQL or compatible database
• Git for version control

🚀 Getting Started

1. Clone the Repository

   git clone https://github.com/ardiansyah663/UKM-Web.git
   cd UKM-Web

2. Install Dependencies

   # Install PHP dependencies
   composer install
   
   # Install Node.js dependencies
   npm install

3. Environment Setup

   # Create environment file
   cp .env.example .env
   
   # Generate application key
   php artisan key:generate

4. Database Configuration

   # Update your .env file with database credentials
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=ukm_web
   DB_USERNAME=your_username
   DB_PASSWORD=your_password

5. Database Migration & Seeding

   # Run migrations and seed data
   php artisan migrate --seed

6. Build Assets

   # Build frontend assets
   npm run build
   
   # For development
   npm run dev

7. Launch Application

   # Start the development server
   php artisan serve

🎉 Success! Your application is now running at http://localhost:8000

---

🔑 Admin Access

Access the powerful Filament admin panel at:

http://localhost:8000/admin

Default Admin Credentials (if seeded):

• Email: admin@ukm.com
• Password: password

🔐 Security Note: Change default credentials immediately in production!

---

📁 Project Structure

UKM-Web/
├── app/
│   ├── Filament/           # Filament admin resources
│   ├── Http/               # Controllers and middleware
│   ├── Models/             # Eloquent models
│   └── Providers/          # Service providers
├── database/
│   ├── migrations/         # Database migrations
│   └── seeders/            # Database seeders
├── resources/
│   ├── views/              # Blade templates
│   ├── js/                 # JavaScript assets
│   └── css/                # CSS assets
├── routes/                 # Route definitions
└── public/                 # Public assets

---

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

🔄 Development Workflow

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 Contribution Guidelines

• Follow PSR-12 coding standards
• Write meaningful commit messages
• Include tests for new features
• Update documentation as needed
• Respect existing code style and patterns

---

🐛 Bug Reports & Feature Requests

Found a bug or have an idea for improvement? We'd love to hear from you!

• 🐛 Bug Reports: Create an Issue
• 💡 Feature Requests: Start a Discussion

---

📄 License

This project is open-source and available under the MIT License.

---

👥 Team & Contact

💬 Get in Touch

Platform	Link
🌐 Website	parlence.com
📧 Email	ardiansyah663@gmail.com
🐙 GitHub	@ardiansyah663

---

🇬🇧 "Building bridges through language, one student at a time"

Made with ❤️ by the Parlence English Camp community

---

🚀 Quick Deploy

Ready to deploy? Check out our deployment guides:

• Deploy to Heroku
• Deploy to DigitalOcean
• Deploy to AWS

💡 Pro Tip: Don't forget to set up your production environment variables and configure your web server properly!