20 changed files with 481 additions and 206 deletions
@ -0,0 +1,117 @@ |
|||||
|
# 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 |
||||
|
|
||||
|
```bash |
||||
|
# 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) |
||||
|
|
||||
|
```ini |
||||
|
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 |
||||
|
|
||||
|
```bash |
||||
|
composer test |
||||
|
# ou |
||||
|
php spark test |
||||
|
``` |
||||
|
|
||||
|
## Licence |
||||
|
|
||||
|
MIT |
||||
Loading…
Reference in new issue