📱 San3a

Services You Can Trust

🚀 Overview

San3a is a mobile application that connects clients with skilled craftsmen for home services and maintenance. The app makes it easy to find, book, and chat with trusted service providers in just a few steps.

✨ Features

• 🔐 Authentication: Firebase Auth for Clients & Craftsman (Phone/Password).

• 🏠 Role-based Experience: Different flows for Clients and Craftsman.

• 🔍 Browse & Search: Explore Craftsman by categories (plumbing, electrical, carpentry, etc).

• 📝 Service Requests: Clients can send requests, Craftsman can accept/decline.

• 💬 In-app Chat: Real-time messaging powered by Firebase Firestore.

• 📋 Request Management: View all requests with statuses (Pending, Accepted, Completed).

• 👤 Profile Management: Update user info & service details with Firebase Storage for images.

• 🌙 Dark/Light Mode support.

• 🌐 English/Arabic Language support.

🛠️ Tech Stack

• Android (Kotlin)

• Jetpack Compose (UI)

• MVVM Architecture

• Firebase

• Authentication

• Firestore Database

• Cloud Storage

🏗️ Project Structure

app/
 ├── data/          # Firebase data sources & repositories
 ├── di/            # Dependency Injection modules
 ├── domain/        # UseCases & business logic
 └── presentation/  # Jetpack Compose screens & components

🎨 Figma UI Design Prototype

Design Here

📸 UI Preview

Customer Flow - Light Theme - English

Onboarding	Auth	Customer Registration	Request Service

Craftsman Flow - Dark Theme - Arabic

Craftsman Registration	Profile	Add Offer	Chating

👨‍💻 Contributors

Name	GitHub
Mohamed Elhanafy	@Mohamed-Elhanafy
Muhammed Wael	@MuhammedWael9991
Mahmoud Abdelnaby	@M-Abdelnabi
Joseph Sameh Fouad	@Joseph-Sameh-0
Ahmed Abdelnasser	@ahmedNaser7
Renad Alalfy	@Renad-Alalfy
Zeinab	@Zeinab979
Mustafa Ibrahim	@MustafaIbrahim96
Dina Othman	@DinaOthman21
Ahmed Salah	@itsahmedsalah
Mohammed Al-Akkad	@mohammed-akkad
Asmaa karam	@Asmaa7071

📜 License

This project is licensed under the MIT License.

▶️ How to Run

• Clone the repository:

git clone https://github.com/Paris-Squad-S2/San3a.git

• Open in Android Studio (latest version).

• Create a Firebase project and connect the app.

• Add your google-services.json file inside app/.

• Sync Gradle and Run on emulator/device.

---

• 🐞 Report Bug • ✨ Request Feature