Repository navigation
Features
A full directory of all features across the public portal, volunteer dashboard, and administrative back-office.
- Hero Section: Call-to-actions for donations, volunteering, and mission discovery.
- Mission & Values: Overview of solidarity, youth empowerment, and humanitarian aid in Oujda.
- Programs & Projects: Filterable project cards with progress bars and registration modals.
- Impact Metrics: Real-time animated counters for volunteers, activities, and beneficiaries.
- Branches Map: Leaflet interactive map with pins for association chapters across Morocco.
- News & Announcements: Articles with search, category filtering, and pinned updates.
- Team Showcase: Interactive carousel highlighting association leaders and coordinators.
- Partners & Sponsors: Partner logo wall with external links.
- Testimonials: Community feedback and beneficiary reviews with 1β5 star ratings.
- Photo Gallery: Masonry photo grid, category filters, full-screen lightbox, and home page marquee.
-
Multi-Gateway Donation (
/donate): Stripe card payment, PayPal buttons, and direct bank wire details (RIB / IBAN). - Contact & Social Community: Direct inquiry form and links to Facebook, Instagram, Twitter, LinkedIn, and WhatsApp.
-
User Profile (
/profile): Update Latin/Arabic names, avatar upload to Supabase Storage, view membership status, and delete account. -
Volunteer Dashboard (
/dashboard/volunteer): Track registered activities, personal impact stats, and download digital membership cards. -
Gamification Hub (
/gamification): Volunteer score points, activity badges, and community leaderboard. -
Membership Renewal (
/membership): Digital commitment signing and online/offline renewal workflows. Annual membership fee: 100 DH (defined insrc/lib/membership.js).
- 12 Dedicated control tabs for news, events, programs, projects, gallery, partners, users, memberships, donations, testimonials, branches, and admins.
- Granular Role-Based Access Control enforcing strict permission checks before write operations.
Points are earned automatically, once per activity, and only after the team verifies it:
| Activity | Points |
|---|---|
| Event participation confirmed by an admin | +20 |
| Donation verified by an admin | +10 (flat, the amount does not buy rank) |
| Annual membership paid | +50 per year |
| Special recognition by an admin (with a reason, never to oneself) | 10β100 |
Levels: Newcomer (0), Helper (50), Volunteer (100), Active Volunteer (200), Ambassador (500), Champion (1000).
Badges (earned automatically, with a notification): First Step (1 event), Regular Volunteer (5), Community Pillar (20), Supporter (1 verified donation), Official Member (1 paid year), Loyal Member (3 years), Rising Star (200 pts), Ambassador of Good (1000 pts).
The leaderboard (all-time and this month) lists volunteers and members only (admins are excluded) and shows names as "Firstname L.". Undoing a verification removes the points it granted.
The home page shows the 9-member 2026 team introduced on Instagram (@goodness_ambassadors_oujda): Marouane (President), Hanae (Social Media Manager), Israe (Visual Artist / Designer), Mohammed and Aymen (Multimedia), Oussama (AI / Web Engineer), Saadia (Regional Coordinator), Anas (Operations Coordinator), Abderrazzak (Logistics Manager). A switch shows the previous team.
Admins also appear on the gamification leaderboard with an Admin tag, and the volunteer dashboard shows a progress card (level, points, rank, next badge).
Production Web App: https://a-a-b-v.netlify.app/
Official Email: asosoufaraelkhir48@gmail.com | GitHub Repo: Bosaj/les-ambassadeurs-web
Facebook β’ Instagram β’ X (Twitter) β’ LinkedIn β’ WhatsApp
Platform developed & maintained by Oussama ELHADJI β All Rights Reserved Β© 2026