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