CoHabit - Gestion de Colocation Simplifiée 🏠

📝 À propos de CoHabit

CoHabit est une plateforme moderne et intuitive conçue pour harmoniser la vie en communauté. Que vous soyez une petite colocation d'étudiants ou une grande maison partagée, CoHabit vous aide à garder une trace de tout ce qui compte : des finances aux membres de l'équipe, tout en automatisant les tâches répétitives.

Initialement conçu comme un projet académique (HETIC MT5), CoHabit a été entièrement raffiné pour offrir une expérience plus robuste, sécurisée et facile à déployer.

✨ Fonctionnalités Clés

• Tableau de Bord Commun : Une vue d'ensemble instantanée de l'état de votre colocation.
• Gestion Intelligente des Dépenses : Ajoutez des dépenses en un clic. Le système calcule automatiquement qui doit quoi, assurant une équité totale.
• Automatisation des Frais Récurrents : Configurez vos frais mensuels (Loyer, WiFi, Électricité) une seule fois. CoHabit s'occupe de les générer chaque mois pour vous.
• Gestion des Membres : Invitez facilement vos colocataires par email pour rejoindre votre espace partagé.
• Sécurité & Confidentialité : Gestion robuste des comptes utilisateurs avec hachage de mots de passe et sessions sécurisées.

🛠️ Stack Technologique

• Core Backend : PHP 8.x avec un moteur de routage et de gestion d'entités sur mesure.
• Frontend Dynamique : React 18 & Redux pour une interface fluide et réactive.
• Design System : Material UI & Bootstrap pour un rendu premium et responsive.
• Base de Données : MariaDB optimisée pour les relations complexes.
• Infrastructure Moderne : Entièrement containerisé avec Docker.

🚀 Démarrage Rapide

Installation via Docker

1. Clonage du projet :

   git clone <repository-url>
   cd cohabit

2. Lancement de l'environnement :

   docker-compose up -d --build

3. Accès :

   • Application : http://localhost:3000
   • API : http://localhost:1414
   • Console DB : http://localhost:8080

📁 Organisation du Code

.
├── app/                    # Moteur Backend (PHP)
│   ├── src/                # Cœur de la logique
│   │   ├── Controllers/    # Gestionnaires de requêtes API
│   │   ├── Managers/       # Couche d'accès aux données
│   │   └── Routes/         # Routage personnalisé
├── frontend/               # Interface Utilisateur (React)
│   └── src/
│       ├── components/     # Composants UI
│       └── pages/          # Vues applicatives
└── docker-compose.yaml     # Orchestration Docker

🔒 Configuration

Personnalisez votre instance via les variables d'environnement (voir .env.example) :

• DB_HOST, DB_NAME, DB_USER, DB_PASSWORD

---

Projet d'étude HETIC refiné en 2026.