Skip to content

Latest commit

 

History

30 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Rezk – Bridging Local Businesses & Job Seekers

Rezk is a web platform designed to connect small businesses with local job seekers. It simplifies recruitment, promotes digital inclusion, and strengthens community economies by making employment opportunities more accessible.


Key Features

UI/UX

  • Clean, minimalist design with an intuitive flow.
  • User-friendly layouts tailored for applicants and businesses.

Frontend

  • Developed using React.js.
  • Reusable components and modular design.
  • Dynamic job listing pages with search and filtering.
  • Form validation for job posting and applicant registration.
  • Integrated with backend APIs for real-time updates.

Backend

  • Built with ASP.NET Core 8 (C#).
  • Entity Framework Core for ORM and database operations.
  • ASP.NET Identity for authentication and role-based access (Applicant, Business, Admin).
  • Secure JWT authentication for API endpoints.
  • Logging and exception handling with Serilog.
  • RESTful APIs following best practices.
  • OOP and SOLID principles applied to ensure maintainability and scalability.

Database

  • SQL Server used as the primary relational database.
  • Code-First Migrations with EF Core.
  • Relationships enforced between Applicants, Applications, and Businesses.
  • Initial seeding with sample applicants and job listings.

System Architecture

Rezk
│── frontend/                # React.js client-side app
│   ├── components/          # Reusable UI components
│   ├── context/             # Global context/state management
│   ├── api/                 # API service layer
│   ├── assets/              # Static assets (icons, images, styles)
│   ├── hooks/               # Custom React hooks
│   ├── pages/               # Page-level views (Home, Login, Dashboard, etc.)
│   ├── App.jsx              # Root React component
│   ├── index.js             # Entry point
│   └── main.js              # Main app bootstrap
│
│── backend/                 # ASP.NET Core API
│   ├── Controllers/         # API endpoints (Applicants, Jobs, Businesses)
│   ├── Models/              # EF Core entity models
│   ├── Services/            # Business logic layer (SOLID applied)
│   ├── Data/                # DbContext + configurations
│   ├── Helpers/             # Utilities (JWT, mapping, etc.)
│   ├── Properties/          # App settings & metadata
│   └── Migrations/          # Database migrations
│
│── UI/UX.md/                # Figma Link
│── README.md                # Project overview

Tech Stack

Frontend

  • React.js + TypeScript
  • Axios for API requests
  • Tailwind CSS

Backend

  • ASP.NET Core 8
  • Entity Framework Core
  • ASP.NET Identity + JWT
  • Serilog (logging)

Database

  • SQL Server

Version Control & Tools

  • Git & GitHub
  • Visual Studio 2022
  • Postman for API testing

Screenshots

image image image image image image image image image

Getting Started

Clone the repository

git clone https://github.com/your-saraanbih/Rezk.git

Setup Backend (ASP.NET Core)

cd backend
dotnet restore
dotnet ef database update   # apply migrations
dotnet run

Setup Frontend (React.js)

cd frontend
npm install
npm start

Core Modules

Applicant Management

  • Register and manage applicant profile.
  • Apply for job opportunities.
  • Track application status.

Business Management

  • Register as a business owner.
  • Post new job opportunities.
  • Manage and review applicants.

Job Search

  • Browse jobs by category, location, and type.
  • Smart filtering and keyword-based search.

Future Enhancements

  • Mobile app (React Native / Flutter).
  • AI-powered job recommendations based on applicant skills.
  • Advanced analytics for businesses.
  • Multi-language support.

Contributors

  • Mohamed Kardosha – Data Scientist
  • Sara Nabih – Backend Developer
  • Shahd Ayman – Backend Developer
  • Romaisa Fetouh – UI/UX Designer
  • Yomna Aly – UI/UX Designer
  • Engy Alaa – Frontend Developer

Why This Project Stands Out

  • End-to-End Solution covering UI/UX, Frontend, and Backend.
  • Clean architecture with OOP and SOLID principles.
  • Scalable database with enforced relationships.
  • Built with industry-standard technologies.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages