Repository navigation
Home
Oussama Elhadji edited this page Oct 25, 2026
·
8 revisions
The Association des Ambassadeurs du Bien (جمعية سفراء الخير - فرع وجدة) web platform is a modern, full-featured web application designed for a non-profit humanitarian organization based in Oujda, Morocco.
- Live Production Platform: https://a-a-b-v.netlify.app/
- Official Repository: https://github.com/Bosaj/les-ambassadeurs-web
- Lead Maintainer: Oussama ELHADJI (LinkedIn)
Production readiness, fair gamification, admin overhaul and the 2026 brand identity.
- 🏆 Fair gamification: points only for team-verified activity (event +20, donation +10, membership +50/year), 8 automatic badges, levels, leaderboard (Features)
- 🔐 Security: members can no longer change their own role, permissions or points (Security)
- 🗂️ Admin back-office: live overview, Needs attention list, Inbox for reports and suggestions (Admin Guide)
- 🎨 2026 identity: navy grid paper, red dots, torn paper and poster type on every page; Team 2026 on the home page
- 💳 Membership fee: 100 DH per year (Payments)
Full notes: Release v1.1.0 · CHANGELOG · Changelog
| Document | Key Information |
|---|---|
| 🚀 Getting Started | Node.js 20+ prerequisites, environment variables setup (.env.example), and development server scripts. |
| 🏗️ Architecture | React 19 SPA design, Vite 7, Context providers (AuthContext, DataContext, LanguageContext), Supabase PostgreSQL, and Netlify Functions. |
| ✨ Features | Public landing sections, Photo Gallery with masonry grid, multi-channel donations, member profiles, and gamification leaderboard. |
| 🛡️ Admin Guide | Back-office management across 12 tabs with granular Role-Based Access Control (RBAC) permission flags. |
| 🖼️ Gallery Management | Photo upload to Supabase Storage, trilingual JSONB captions, and infinite CSS marquee engine. |
| 💳 Payments | Stripe CardElement checkout, serverless PaymentIntent creation, PayPal Smart Buttons, and bank wire transfer instructions. |
| 🌐 Internationalization | Arabic RTL layout support, French/English LTR layout, and src/translations.js key dictionary. |
| 🚀 Deployment | Netlify hosting configuration (netlify.toml), environment variables, and GitHub Actions CI/CD workflows. |
| 🔧 Troubleshooting | Diagnostic steps for Supabase authentication, storage bucket access, UTF-8 BOM sanitization, and test runners. |
| 📜 Changelog | Full timeline from initial migration (v0.1.0) to complete production release (v1.0.0). |
| 🔒 Security | Security policy, vulnerability reporting (asosoufaraelkhir48@gmail.com), and Row Level Security (RLS) protections. |
- Association Name: Association des Ambassadeurs du Bien — Oujda
- Arabic Name: جمعية سفراء الخير - فرع وجدة
-
Official Email:
asosoufaraelkhir48@gmail.com -
Social Community:
- Facebook: jamiyat.safarat.khair.oujda
- Instagram: @goodness_ambassadors_oujda
- Twitter / X: @associationabv
- LinkedIn: jamiyat-safarat-khair-oujda
- WhatsApp Community: Join WhatsApp Group
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