🏢 Syndico App

A modern platform for managing residential syndicates
Built with Spring Boot • Thymeleaf • MySQL

---

🌟 Overview

Syndico App is a full-stack web application designed to simplify the management of residential buildings.

It connects:

• 🏠 Residents
• 👨‍💼 Administrators

Into one unified platform for:

• Payments 💳
• Complaints 🛠️
• Communication 📢
• Governance 🗳️

---

🚀 Features

✨ Core Features

• 🔐 Secure Authentication (Spring Security)
• 💳 Payment & Charges Management
• 📢 Notifications & Messaging
• 🛠️ Complaint & Maintenance Tracking
• 📅 Reservations System

🤖 Smart Assistant

• Chatbot based on database (Q&A system)
• Helps users navigate the platform

🌍 Internationalization

• Multi-language support (FR / EN / AR ready)

---

📸 Screenshots (Main Features)

🏠 Home

📊 Admin Dashboard

👤 Resident Dashboard

🤖 Chatbot

---

🖼️ More Screens (Full Platform)

👉 All platform screenshots are available here:

/screenSyn/

Examples you can include:

• complaints.png
• payments.png
• reservations.png
• messages.png
• documents.png

---

🧠 Architecture (Clean & Scalable)

The application follows a modular Clean MVC architecture:

                ┌────────────────────┐
                │   Presentation     │
                │ (Thymeleaf Views)  │
                └─────────┬──────────┘
                          │
                ┌─────────▼──────────┐
                │    Controllers     │
                │ (Admin / Resident) │
                └─────────┬──────────┘
                          │
                ┌─────────▼──────────┐
                │     Services       │
                │  Business Logic    │
                └─────────┬──────────┘
                          │
                ┌─────────▼──────────┐
                │   Repositories     │
                │   (Spring Data)    │
                └─────────┬──────────┘
                          │
                ┌─────────▼──────────┐
                │     Database       │
                │      MySQL         │
                └────────────────────┘

🔹 Key Points

• ✔ Feature-based controllers (admin/, resident/)
• ✔ Separation of concerns (Controller → Service → Repository)
• ✔ Thymeleaf for server-side rendering
• ✔ Refactored from monolithic to modular architecture

---

⚙️ Tech Stack

Layer	Technology
🧠 Backend	Spring Boot, Spring MVC, Spring Security
🎨 Frontend	Thymeleaf, HTML5, CSS3, Bootstrap, JS
🗄️ Database	MySQL
🔄 ORM	Hibernate / JPA
🛠️ Build	Maven

---

🚀 Getting Started

git clone https://github.com/msabr/Syndico-app.git
cd syndico-app
mvn spring-boot:run

👉 Open: http://localhost:8080

---

👨‍💻 Team

👤 Name	🌐 GitHub	💼 LinkedIn	📧 Email
Soufiane Zekaoui	https://github.com/soufianezekaoui	https://linkedin.com/in/soufiane-zekaoui-445b1b352/	soufiane.zekaoui@gmail.com
SABR Mohamed	https://github.com/msabr	https://www.linkedin.com/in/sabr-mohamed/	email
AbdelkrimZidouh	https://github.com/AbdelkrimZidouh	link	email

---

🚧 Future Work

• 🐳 Docker deployment
• ☁️ Cloud hosting
• 📊 Advanced analytics
• 📱 Mobile optimization

---

⭐ If you like this project, don't forget to star it!

Built with ❤️ by Syndico Team