# KKN Registration System - Installation Guide

This is a complete web-based KKN (Community Service Lecture) Registration System built with CodeIgniter 4, MySQL, and Bootstrap 5.

## Prerequisites
- PHP 8.1 or higher
- MySQL/MariaDB
- Web Server (Apache/Nginx)
- Composer (optional, for dependency management)

## Installation Steps

### 1. Database Setup
1. Open **phpMyAdmin** or your preferred MySQL client.
2. Create a new database named `kkn_registration`.
3. Import the `database.sql` file provided in the root directory.

### 2. Project Configuration
1. Copy the project folder to your web server's root directory (e.g., `htdocs` for XAMPP).
2. Open the `.env` file in the project root.
3. Configure your database connection:
   ```env
   database.default.hostname = localhost
   database.default.database = kkn_registration
   database.default.username = root
   database.default.password = 
   ```
4. Set your base URL:
   ```env
   app.baseURL = 'http://localhost/kkn_registration_system/public/'
   ```

### 3. Folder Permissions
Ensure the following directories are writable by the web server:
- `writable/`
- `public/uploads/photos/`
- `public/uploads/docs/`

### 4. Accessing the System
1. Open your browser and navigate to the base URL you configured.
2. **Admin Login:**
   - Username: `admin`
   - Password: `password`
3. **Student Registration:**
   - Click on "Register here" on the login page to create a student account.

## Features
- **User Authentication:** Secure login and registration for students and admins.
- **Student Management:** Admin can validate student data and documents.
- **KKN Registration:** Students can register for KKN locations.
- **Location & Group Management:** Admin can manage KKN locations and groups.
- **Reports:** Export participant data to Excel (CSV) and printable PDF.
- **Responsive Design:** Built with Bootstrap 5 for mobile and desktop compatibility.

## System Architecture
- **Framework:** CodeIgniter 4 (MVC Architecture)
- **Frontend:** Bootstrap 5, FontAwesome 6, jQuery
- **Backend:** PHP 8.1+
- **Database:** MySQL

---
Created by Manus AI