🏠 Sakenny (سكنّي) – Backend

A Full-Stack Property Rental Platform built with .NET & Angular
Graduation Project – ITI Alexandria | Full Stack Development Track

---

📖 Overview

Sakenny (سكنّي), meaning "House me" in Arabic, is a property rental platform inspired by Airbnb.
It provides a dynamic, secure, and responsive experience for renting properties, managing listings, and handling payments.

The platform supports three types of accounts:

• 👤 Customer – Browse and rent properties, manage booking history, make secure payments via Stripe, and view locations on Google Maps.
• 🏡 Host – Post properties for rent (pending admin approval), manage listings, track income, and access a personalized dashboard.
• 🛡️ Admin – Review and approve property requests, manage users & data, and access an advanced analytics dashboard.

🔑 Key Highlights

• 🔐 Authentication & Authorization with JWT + Google Login
• 💳 Secure payment processing via Stripe
• 📍 Location services powered by Google Maps API
• 📊 Role-based dashboards (Customer, Host, Admin)
• 📅 Real-time booking validation (dates locked both frontend & backend)
• 🖼️ Image Storage using Azure Blob Storage (AzStorage via Azurite) – upload, manage, and retrieve property images with secure URLs.

This repository contains the Backend of Sakenny, built with .NET (N-Tier Architecture) following Clean Code principles and the Dependency Inversion Principle.

---

🎥 Demo

Check out the demo of Sakenny here:
👉 Watch on Google Drive

---

✨ Features

The Sakenny Backend provides all the core functionalities required to run a property rental platform securely and efficiently.

🔑 Authentication & Authorization

• JWT-based authentication for secure API access.
• Role-based authorization (Customer, Host, Admin).
• Login & Signup with Google OAuth.

💳 Payment Integration

• Stripe integration for safe and reliable payments.
• Transaction tracking in user booking history.

🏡 Property Management

• Hosts can submit properties for rental.
• Properties require Admin approval before being visible to customers.
• Property availability is automatically managed to prevent double-booking.

📍 Location Services

• Google Maps API integration:
  • Hosts can select property location when submitting a listing.
  • Customers can view property locations on a map.
  • Search results support nearby property suggestions.

🖼️ Image Management

• Images uploaded by hosts are stored in Azure Blob Storage (Azurite for local development).
• Each image generates a secure URL stored in the database for efficient retrieval.

📅 Booking System

• Customers can rent properties for specific dates.
• Booked dates become unavailable both in the frontend (date picker disabled) and backend (server validation).
• Rental history is stored per customer.

📊 Dashboards

• Customer Dashboard – Manage bookings & history.
• Host Dashboard – Manage properties, monitor income.
• Admin Dashboard – Manage properties, users, approvals, and overall system data.

🛠️ Clean Architecture & Best Practices

• N-Tier Architecture: Data Access Layer, Application Layer, API Layer.
• Dependency Inversion Principle & Clean Code standards.
• Generic repositories with Unit of Work pattern for reusable, maintainable code.

---

🛠️ Tech Stack

The Sakenny Backend is built with modern technologies to ensure scalability, security, and maintainability.

📦 Backend Technologies

• .NET 8.0 – API development with ASP.NET Core.
• Entity Framework Core – ORM for database operations.
• SQL Server – Relational database management system.
• AutoMapper – Object-to-object mapping for DTOs and models.
• Stripe API – Secure online payments.
• Google Maps API – Location & geospatial services.

🏗️ Architecture & Patterns

• N-Tier Architecture (Data Access, Application, API Layers).
• Repository & Unit of Work Pattern.
• Dependency Injection for better scalability and testing.
• DTOs & Services for clear separation of concerns.

---

🏗️ Architecture

The Sakenny Backend follows an N-Tier Architecture to separate concerns and improve maintainability.
This structure ensures that each layer has a single responsibility, making the project scalable and easier to test.

🔹 Layers Overview

• Data Access Layer (DAL)

  • Contains Models, Configurations, Repositories, and the Unit of Work.
  • Uses Entity Framework Core to interact with the database.
  • Implements generic repositories to avoid repetitive code.

• Application Layer

  • Contains DTOs, Services, and their Interfaces.
  • Responsible for business logic and orchestrating data between DAL and API.

• API Layer

  • Exposes RESTful Controllers for communication with the frontend.
  • Contains the Mapping Profile (AutoMapper) to map between Models and DTOs.
  • Handles Authentication & Authorization using JWT and Google OAuth.

---

📂 Folder Structure

Sakenny.Backend/
├── Sakenny.DataAccess/
│   ├── Models/
│   ├── Configurations/
│   ├── Repositories/
│   ├── Interfaces/
│   ├── UnitOfWork.cs
│   └── AppDbContext.cs
│
├── Sakenny.Application/
│   ├── DTOs/
│   ├── Services/
│   └── Interfaces/
│
├── Sakenny.API/
│   ├── Controllers/
│   └── MappingProfiles/
│
└── Sakenny.sln

---

📐 Design Principles

• ✅ Dependency Inversion Principle (DIP) – High-level modules depend on abstractions, not concrete implementations.
• ✅ Separation of Concerns – Each layer is responsible for a specific aspect of the system.
• ✅ Clean Code Practices – Generic repositories, DTO mappings, and proper layering.

---

🎨 Frontend Repository

The Sakenny Frontend is built with Angular, styled mainly with Tailwind CSS, and enhanced with PrimeNG components.
It provides a responsive, user-friendly interface that connects seamlessly with this backend API.

👉 Check it out here: Sakenny Frontend Repository

---

🖼️ Screenshots

Database Schema (SQL Server)

Swagger UI

---

📜 License

This project is licensed under the MIT License.
You are free to use, modify, and distribute this software, provided that proper attribution is given.

---

👨‍💻 Team

Meet the people behind this project:

Avatar	Name	GitHub
	Mohab Wafaie	@MohabWafaie
	Ahmed Waleed	@Ahmedabdeen15
	Nancy EL Sherbiny	@NancELSherbiny
	Marwan Fawzy Shahat Mahmoud	@ArabianHindi
	Rodina Elfeky	@RodinaElfeky
	Ahmed Aseel	@Ahmed-Aseel

---

❤️ Made With Love

This project was made with ❤️, ☕, and a passion for clean architecture.