motorbike/README.md

MOTORBiKE

Application web de gestion commerciale pour une entreprise de vente et maintenance de motos, developpee avec CodeIgniter 4.

Fonctionnalites

• Gestion des ventes / commandes - creation, modification, suivi et impression de bons de livraison
• Avances - gestion des acomptes clients avec conversion automatique en commande et alertes d'echeance
• Recouvrement - suivi des paiements et creances
• Caisse / Sortie caisse - gestion des encaissements et decaissements avec export Excel/CSV
• Produits - catalogue avec attributs, categories, marques, images et import depuis Excel
• Stocks - affectation des produits par magasin/point de vente
• Mecaniciens - suivi des performances des techniciens
• Utilisateurs & Groupes - gestion des acces par roles et groupes de permissions
• Magasins - gestion multi-points de vente
• Statistiques & Rapports - tableaux de bord, rapports de ventes, de stock et de performances
• Historique - traçabilite des actions avec export
• Notifications - alertes en temps reel (echeances, etc.)
• QR Code - generation de QR codes produits
• Securite - validation de securite avec historique

Stack technique

• Framework : CodeIgniter 4 (PHP 8.2+)
• Base de donnees : MySQL (via MySQLi)
• Authentification : JWT (firebase/php-jwt)
• Export : PhpSpreadsheet (phpoffice/phpspreadsheet)
• Tests : PHPUnit 9

Prerequis

• PHP >= 8.2 avec les extensions : curl, intl, json, mbstring, mysqli
• MySQL >= 5.7 / MariaDB
• Composer

Installation

# Cloner le depot
git clone <url-du-depot> motorbike
cd motorbike

# Installer les dependances
composer install

# Configurer l'environnement
cp .env.example .env
# Editer .env avec vos parametres de base de donnees et URL

# Executer les migrations
php spark migrate

# Lancer le serveur de developpement
php spark serve

Configuration (.env)

CI_ENVIRONMENT = development

app.baseURL = 'http://localhost:8080/'

database.default.hostname = localhost
database.default.database = motorbike
database.default.username = <votre_utilisateur>
database.default.password = <votre_mot_de_passe>
database.default.DBDriver = MySQLi
database.default.port = 3306

Structure du projet

app/
  Config/        - Configuration (routes, filtres, base de donnees...)
  Controllers/   - Controleurs de l'application
  Database/      - Migrations et seeds
  Filters/       - Filtres d'authentification (auth, loggedIn, publicCheck)
  Models/        - Modeles de donnees
  Views/         - Templates (dashboard, commandes, produits, rapports...)
public/
  assets/        - CSS, JS, images

Routes principales

Chemin	Description
/	Tableau de bord
/login	Authentification
/orders	Commandes / Ventes
/avances	Gestion des avances
/products	Catalogue produits
/stores	Magasins
/recouvrement	Recouvrement
/sortieCaisse	Sortie de caisse
/reports	Rapports
/statistic	Statistiques
/users	Utilisateurs
/groups	Groupes / Roles
/brands	Marques
/category	Categories
/mecanicien	Mecaniciens
/historique	Historique

Tests

composer test
# ou
php spark test

Licence

MIT