AssoVelo : une application web libre pour gérer une association de vélo

🚴‍♀️ À l’origine du projet

Pendant une discussion avec une personne qui gère une petite association de vélo, elle m’a confié les difficultés qu’elle rencontrait pour suivre les adhérents, organiser les sorties, partager des documents… sans outil adapté, et sans budget disponible. Ça m’a donné envie de challenger mes compétences de développeur et de proposer une petite solution sur mesure.

Alors ni une ni deux : je me suis lancé pour le fun, juste pour voir ce que je pouvais créer rapidement grâce à TRAE, une IA de développement.

Environ 5 à 6 heures de codage, réparties sur deux soirées, ont suffi pour obtenir une version fonctionnelle d’AssoVelo. J’ai utilisé TRAE (The Real AI Engineer), un environnement de développement IA créé par ByteDance, qui intègre des modèles puissants comme Claude 3.5 Sonnet ou GPT‑4o dans un éditeur proche de VS Code.

TRAE, c’est plus qu’un simple autocompléteur : c’est un IDE intelligent, capable de comprendre le projet global, de générer du code ciblé, de proposer des refactorisations et même d’afficher un aperçu des changements avant application. Grâce à son mode Builder, j’ai pu rapidement enchaîner les modules : gestion des membres, événements, export PDF, rôles utilisateurs, etc.

En guidant l’IA avec des instructions claires (« crée un système de participation à un événement », « intègre un calendrier mensuel », « propose une interface d’upload avec navigation »), j’ai obtenu un socle complet, clair et fonctionnel. AssoVelo était né.

Dépot Git >> https://github.com/mike37510/cyclingclubmanagement

✨ Fonctions principales

👥 Gestion des adhérents

Fiches complètes (nom, prénom, date de naissance, photo)
Tri, recherche, pagination
Export PDF / Excel
Ajout et modification sans rechargement de page (modale AJAX)

📅 Organisation d’événements

Création de sorties vélo avec date, heure et lieu (via Leaflet)
Suivi des participations : en attente, confirmé, indisponible
Vue calendrier mensuelle
Export PDF sur 3 mois

📁 Partage de documents

Upload de fichiers (PDF, images, documents Office…)
Organisation dans des dossiers
Navigation intuitive avec fil d’Ariane
Suppression, téléchargement, métadonnées

🔐 Administration

Gestion des comptes utilisateurs et rôles (admin, standard)
Personnalisation du logo de l’association
Contrôle d’accès sécurisé (sessions, rôles)
Scripts d’export / sauvegarde

💻 Stack technique

Backend : PHP 7.4+
Base de données : MySQL / MariaDB
Frontend : HTML5, CSS3, JavaScript
Framework CSS : Bootstrap 5
Icônes : Font Awesome, Bootstrap Icons
Architecture : modèle MVC simple

🚀 Installation rapide

Cloner le dépôt Git : bashCopierModifiergit clone https://github.com/mike37510/CyclingAssociationManager.git cd CyclingAssociationManager
Créer la base de données : mysql -u root -p < sql/init_database.sql
Configurer les identifiants dans includes/db_connect.php
Créer les dossiers d’upload : mkdir -p uploads/{adherents,documents,logo} chmod 755 uploads/
Accéder à l’application via votre navigateur (ex. : http://localhost/CyclingAssociationManager)

🗂️ Structure du projet

plaintextCopierModifierassovelo/
├── admin.php              # Administration interface
├── adherent.php           # Member management
├── evenement.php          # Event management
├── documents.php          # Document management
├── index.php              # Homepage
├── login.php              # Authentication
├── css/                   # Stylesheets
├── includes/              # Include files
│   ├── db_connect.php     # Database connection
│   ├── header.php         # Header
│   └── footer.php         # Footer
├── sql/                   # SQL scripts
├── uploads/               # Uploaded files
│   ├── adherents/         # Member photos
│   ├── documents/         # Shared documents
│   └── logo/              # Association logo
└── export_*.php           # PDF export scripts

🔄 Fonctionnement

Admins : peuvent tout gérer (membres, docs, événements, utilisateurs…)
Utilisateurs simples : peuvent consulter les docs et événements
Accès sécurisé par login/session
Interface responsive utilisable sur smartphone et tablette

📦 Ce que j’ai appris

Même avec une IA comme TRAE, il faut penser la logique métier, structurer les données, anticiper les cas d’usage. Mais l’IA m’a clairement fait gagner un temps précieux sur le code répétitif, le HTML/CSS et même sur certains exports PDF.
C’est un outil que je recommande chaudement pour les projets perso, DIY, ou même des POCs rapides.