HumaniMap

Dossier de présentation du projet — généré le 20/04/2026

Plateforme solidaire open-source reliant besoins, maraudes et projets caritatifs.

1. Résumé exécutif

HumaniMap est une PWA (Progressive Web App) qui permet à toute personne ou association de signaler un besoin (sans-abri, personne en difficulté), d'organiser ou rejoindre des maraudes, et de financer des projets solidaires (sadaqa jariya). Elle est pensée pour être fluide, mobile-first, et fiable, avec des mécanismes anti-abus (modération, pertinence, rate-limiting, bannissement).

2. Chiffres clés (au 20/04/2026)

121

Signalements

Membres

Helpers

Associations

3. Stack technique

Front : HTML/CSS/JS vanilla single-page, Leaflet + MarkerClusterGroup, Lucide icons inline, PWA (Service Worker, manifest, offline assets).
Back : PHP 8 + PDO MySQL, sessions natives, endpoints REST (api/*.php).
Infra : hébergement web classique, auto-déploiement Git.
Sécurité : rate-limiting par IP, bannissement, modération manuelle + automatique (trust level), 2FA, CAPTCHA côté inscription.
Cache client : Service Worker (version actuelle : humanimap-v120).

4. Utilisateurs et rôles

Visiteur — Consultation seule. Pas d'itinéraire Maps/Waze.

Membre — Peut soumettre (modéré), aider, voter.

Helper ⭐ — Vérifié (email+tel) + 3 aides confirmées. Publication directe avec photo.

Modérateur — Approuve/refuse, résout, bloque.

Administrateur — Accès complet : utilisateurs, SEO, maintenance, sauvegardes, bannissement IP.

5. Cas d'usage principaux

5.1 Signaler une personne en difficulté

Visiteur/Membre → formulaire Ajouter → type Besoin → géolocalisation (≤ 500 m) → adresse précise (autocomplete ou clic carte) → profil + besoins cochés → photos (recommandées) → envoi.
→ Publication immédiate si Helper+photo ; sinon file de modération.

5.2 Aider sur place

Popup signalement → Je suis en route → timeout 2h → arrivée ≤ 2 km → Confirmer mon aide (+ photo preuve optionnelle) → notification résolution.

5.3 Organiser / rejoindre une maraude

Créateur : date, lieu, ce qu'il apporte, liens contact → publication.
Bénévoles : bouton Je participe + rôle optionnel → notification à l'organisateur.

5.4 Financer un projet solidaire

Point Donation → objectif chiffré + lien de don (externe ou Stripe) → partage universel (Web Share API) → comptage des soutiens.

6. Fonctionnalités implémentées (V1)

Carte interactive + cluster, filtres par type & zone, géolocalisation live.
Ajout/édition de points 3-étapes (wizard) + photos (max 4) + autocomplete adresse.
Modération (pending, rejected, trust-downgrade automatique).
Système d'aide (en_route / done / failed) + historique enrichi.
Maraudes avec liste de participants publique.
Système de pertinence (vote ±) + niveaux Élevée/Normale/Basse.
Notifications push (Web Push + VAPID).
Auth email/PIN + 2FA + vérification email/téléphone.
Messagerie staff (admin/modérateur).
Panneau admin : Statistiques, Membres, Maintenance, Référencement, Sauvegarde.
Onboarding 3 slides + activation push + partage universel (Web Share).
Design animé (micro-interactions, popup scale-in, hover cards) + dark mode + prefers-reduced-motion.
Deep link ?point=UID pour partager un signalement.

7. Sécurité & conformité

Rate-limiting par IP sur soumissions et votes.
Bannissement IP (table banned_ips).
Blocage compte (blocked_at).
Geofencing 500 m à la soumission d'un besoin.
Photos en uploads isolés, nettoyage orphelins.
Auth session cookie HttpOnly, SameSite lax.
HTTPS exigé pour push + géoloc.

8. Administration

Statistiques — points, membres, helpers, top pays, activité 30 jours.
Membres — recherche, pagination, changement de rôle, blocage, suppression (protection dernier admin).
Maintenance — santé DB, purges (logs, rate-limits, points refusés, notifs lues, uploads orphelins), vidage cache SW.
Référencement — meta (title/desc/keywords/OG), toggle indexation Google, éditeur robots.txt, régénération sitemap.xml.
Sauvegarde — backup quotidien automatique (rotation 7 jours), téléchargement ZIP (dump SQL + uploads).

9. Roadmap envisagée

SSO (Google, Apple) + SMS OTP natif.
Intégration Stripe complète + reçus fiscaux.
Tableau de bord association avec campagnes.
Notifications email automatiques (hebdo/urgence).
Apps natives via Capacitor (iOS/Android) partageant le même backend.