Kuusor

A platform connecting students with internship opportunities.

Overview

Kuusor is an internship platform designed to help students discover and apply for internship opportunities.

The platform is a deployed production product with real users. This repository is a public portfolio and technical case study. The production application source code remains private because it contains production infrastructure, application logic, configuration, and user-related data.

---

Product Screenshots

Screenshots are included in the screenshots/ directory.

Home

Internship Listings

Posts

User Profile

Students

---

Problem

Students often have difficulty finding relevant internship opportunities, while organizations may struggle to reach students who are actively looking for interns.

Kuusor provides a centralized platform where:

• Students can discover internship opportunities.
• Students can view internship details.
• Students can apply for opportunities.
• Organizations can publish internship opportunities.
• Users can manage their accounts and application activity.

---

Features

For Students

• Create an account
• Complete their profile
• Discover internship opportunities
• Search and browse available internships
• View internship details
• Apply for internships
• Track application activity

For Organizations

• Create and manage internship opportunities
• Publish internship listings
• Receive applications from students
• Manage internship-related information

Platform

• User authentication
• Role-based functionality
• Internship management
• Application management
• Responsive interface
• API-driven architecture
• Database-backed application
• Production deployment

---

Tech Stack

Frontend

• React
• TypeScript
• Redux Toolkit
• RTK Query

Backend

• Node.js
• Express
• TypeScript

Database & Data Layer

• Supabase
• PostgreSQL
• Prisma

Development Tools

• Git
• GitHub
• REST APIs

---

Architecture

Kuusor follows a client-server architecture.

                         ┌────────────────────┐
                         │      Kuusor        │
                         │     Frontend       │
                         │                    │
                         │ React + TypeScript │
                         │ Redux Toolkit      │
                         │ RTK Query          │
                         └─────────┬──────────┘
                                   │
                                   │ REST API
                                   ▼
                         ┌────────────────────┐
                         │   Kuusor Server    │
                         │                    │
                         │ Node.js + Express  │
                         │ TypeScript         │
                         └─────────┬──────────┘
                                   │
                                   │ Prisma
                                   ▼
                         ┌────────────────────┐
                         │     Supabase       │
                         │    PostgreSQL      │
                         └────────────────────┘

The frontend communicates with the backend through API endpoints. The backend handles business logic, authentication, authorization, internship operations, and application-related operations.

Prisma provides the database access layer, while Supabase provides the PostgreSQL database infrastructure.

---

Authentication & Authorization

Kuusor includes user authentication and role-based functionality.

Authentication protects account-specific operations and ensures that users can only perform actions permitted by their account.

Examples include:

• Account registration and login
• Protected routes
• Authenticated API requests
• Role-based functionality
• User-specific application data

Production authentication configuration and secrets are intentionally not included in this public repository.

---

Application Flow

A simplified internship application flow looks like this:

Student
   │
   │ Browse internships
   ▼
Internship Listing
   │
   │ View details
   ▼
Internship Details
   │
   │ Apply
   ▼
Kuusor API
   │
   │ Validate request
   ▼
Database
   │
   │ Store application
   ▼
Application Created

---

Engineering Highlights

Building Kuusor provided practical experience with:

• Designing a full-stack application
• Separating frontend and backend responsibilities
• Building REST APIs
• Managing server state with RTK Query
• Managing application state with Redux Toolkit
• Designing database models with Prisma
• Working with PostgreSQL
• Implementing authentication and protected operations
• Handling user roles and permissions
• Deploying and maintaining a production application
• Working with real users and real-world application requirements

---

Why the Production Source Code Is Private

The production Kuusor application contains private application code, production configuration, infrastructure details, and user-related information.

For security and privacy reasons, the production repositories are not publicly accessible.

This repository therefore serves as a public technical overview of the project rather than a copy of the production source code.

Selected architecture, engineering decisions, product screenshots, and technical documentation are provided to demonstrate the development work behind the platform.

---

Technical Documentation

Additional technical documentation is available in the docs/ directory.

• Architecture

---

Project Status

Production

Kuusor has been launched and is being used by real users.

The platform continues to evolve based on product requirements, user feedback, and ongoing development.

---

Developer

Abubakarr Marah

Full-Stack Developer

• GitHub: https://github.com/gitmarah
• LinkedIn: https://www.linkedin.com/in/abubakarr-marah-638648377/
• Portfolio: https://bokari.netlify.app/

---

Repository Note

This repository is maintained as a public portfolio and technical case study.

The production Kuusor source code is maintained separately in private repositories.