This is an interactive Laravel-based Ugadan-job-platform designed to combat youth unemployment in Uganda by connecting job seekers, employers, and entrepreneurs.
# Konnections - Bridging the Ugandan Employment Gap
**Konnections** is an interactive online platform designed to partially address the pressing issue of **youth unemployment in Uganda** by creating a reliable market for job announcements and linking job seekers, employers, and small-scale entrepreneurs. Built on the **Laravel** framework, it aims to be the leading solution for job matching and opportunity creation.
---
## Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
### Prerequisites
You need to have the following software installed on your system:
* **PHP** (Version 8.1+)
* **Composer**
* **MySQL** (or another supported database like PostgreSQL)
* **Node.js & npm** (for front-end assets via Laravel Mix/Vite)
### Installation Steps
1. **Clone the Repository:**
```bash
git clone konnections
cd konnections
```
2. **Install PHP Dependencies:**
```bash
composer install
```
3. **Install JavaScript Dependencies:**
```bash
npm install
# Compile assets (for development)
npm run dev
# Or use 'npm run watch' for live compilation
```
4. **Configure Environment:**
```bash
cp .env.example .env
php artisan key:generate
```
* **Edit the `.env` file** to set your `DB_DATABASE`, `DB_USERNAME`, and `DB_PASSWORD`.
* Create the database konnections in MySQL:sql
```sql
CREATE DATABASE konnections;
```
5. **Run Migrations:**
```bash
php artisan migrate --seed
```
*(The `--seed` command is important if we add default users or initial data later.)*
6. **Start the Local Server:**
```bash
php artisan serve
```
The application should now be accessible at `
127.0.0.1`.
---
## Key Features
Konnections is structured around three core user roles:
| Role | Core Feature | Goal |
| :--- | :--- | :--- |
| **Job Seeker** | Search, Profile Management, CV Upload | Find verified employment opportunities. |
| **Employer/Creator** | Job Posting, Applicant Tracking | Post jo …