StockPilot

Vue d'ensemble

StockPilot est un tableau de bord de gestion d'entreprise complet, conçu pour le marché marocain.

25

Fichiers

12,314

Lignes de code

14

Pages

12

Tables DB

Fonctionnalités

Toutes les fonctionnalités incluses dans StockPilot v1.0

📊 Dashboard Core

Vue d'ensemble: revenus, profit/perte, commandes, factures impayées. Graphique revenus vs dépenses. Alertes stock bas. Top produits. Actions rapides.

📦 Produits Core

Double tarification: Prix Maroc (achat/vente) + Prix Chine (achat/vente). Stock unique. Profit par unité en temps réel. CRUD complet avec recherche.

👥 Clients Core

Classement par chiffre d'affaires. Historique d'achats. Sélection multiple + suppression en masse. Recherche, tri par CA/commandes/nom.

🛒 Ventes Core

Avec facture / Sans facture (Compte Noir). Recherche client et produit. Lignes multiples illimitées. Calcul automatique TVA 20%. 3 modes paiement: Cash, Chèque, Arkodna.

📄 Double Facturation Unique

1 vente = 2 factures automatiques. Facture Maroc (prix MAD Maroc) + Facture Chine (prix MAD Chine). Séparées dans le sidebar. Téléchargeable/imprimable.

📓 Compte Noir Unique

Vente sans facture → produits stockés en Compte Noir. Créer facture depuis le Compte Noir quand nécessaire. Ne touche pas l'inventaire (déjà déduit).

📋 Devis Finance

Créer devis HT (Hors Taxe). Statuts: Brouillon, Envoyé, Accepté, Refusé, Converti. Convertir en vente. Téléchargeable.

🚚 Bon de Livraison Finance

Bon de livraison HT automatique. Modifier → met à jour la facture TTC liée. Vue, édition, suppression, téléchargement.

📦 Inventaire Stock

Vue complète du stock. Valeur stock achat/vente. Restockage + ajustement avec historique. Filtres (OK, Bas, Rupture). Export CSV.

💰 Trésorerie Finance

Solde Cash vs Banque. Revenus et dépenses par source. Résumé mensuel. Derniers mouvements.

💳 Dépenses Finance

Catégorisation (Loyer, Fournisseur, etc.). Payé par Cash ou Banque. Résumé mensuel. CRUD complet.

🔔 Rappels Unique

Chèques en attente de dépôt. 4 niveaux: En retard, Aujourd'hui, Bientôt, Plus tard. Badge notification dans le sidebar. Marquer comme déposé.

📊 Rapports Analytics

4 onglets: Ventes, Produits, Clients, Bénéfices. Graphiques Chart.js. Export CSV. Filtres par date. P&L mensuel avec totaux.

⚙️ Paramètres System

Infos entreprise. Devise (MAD). Taux TVA. Gestion utilisateurs (Admin, Manager, Staff). Changement mot de passe.

Navigation (Sidebar)

Structure complète du menu latéral

Base de Données

12 tables MySQL — Structure complète

Table	Description	Colonnes clés
`users`	Utilisateurs du système	username, password, full_name, role (admin/manager/staff)
`products`	Catalogue produits	name, sku, buy_price, sell_price, buy_price_china, sell_price_china, stock_qty
`clients`	Base clients	name, email, phone, company, city, address
`sales`	Ventes / Commandes	reference, client_id, subtotal, tax_amount, total, payment_method, tarif, cheque_deposit_date
`sale_items`	Lignes de vente	sale_id, product_id, quantity, unit_price, total
`invoices`	Factures (Maroc + Chine)	invoice_number, sale_id, amount, tarif (maroc/chine), status, due_date
`devis`	Devis (HT)	devis_number, client_id, total_ht, status, valid_until
`devis_items`	Lignes de devis	devis_id, product_id, quantity, unit_price, total
`expenses`	Dépenses	category, amount, expense_date, vendor, paid_by (cash/banque)
`compte_noir`	Ventes sans facture	product_id, quantity, remaining_qty, unit_price, client_name
`stock_movements`	Mouvements de stock	product_id, type (in/out), quantity, note
`settings`	Paramètres app	setting_key, setting_value

Flux Métier

Comment les données circulent dans le système

Vente Avec Facture

Créer Vente → Stock -qty → Facture 🇲🇦 créée + Facture 🇨🇳 créée + Bon de Livraison

Vente Sans Facture (Compte Noir)

Créer Vente → Stock -qty → Compte Noir +qty → Bon de Livraison uniquement

Facture depuis Compte Noir

Compte Noir → Sélectionner produits → Facture créée → Compte Noir -qty → Stock PAS touché

Paiement par Chèque

Vente (chèque) → Date dépôt définie → Rappel dans sidebar → Marquer déposé

Trésorerie

Vente Cash → Cash + | Vente Chèque/Arkodna → Banque + | Dépense Cash → Cash - | Dépense Banque → Banque -

Rôles Utilisateurs

3 niveaux d'accès prévus

👑 Admin

Tout accès
Voir les prix d'achat
Dépenses & Trésorerie
Rapports bénéfices
Compte Noir
Paramètres & Utilisateurs
Supprimer des données

👔 Manager

Ventes & Clients
Produits & Inventaire
Devis & Factures
Bon de Livraison
Dépenses & Trésorerie
Rapports bénéfices
Paramètres

👤 Staff

Créer ventes
Voir produits (sans prix achat)
Voir clients
Supprimer quoi que ce soit
Dépenses & Trésorerie
Rapports
Paramètres

Structure des Fichiers

Architecture complète du projet — 25 fichiers

stockpilot/ ├── index.php ← Page de connexion (split screen animée) ├── install.php ← Assistant d'installation ├── logout.php ← Déconnexion ├── .htaccess ← Sécurité & redirections │ ├── config/ │ ├── database.php ← Connexion DB + helpers (money, clean, auth) │ └── .htaccess ← Bloquer accès direct │ ├── includes/ │ ├── header.php ← Sidebar + layout wrapper │ └── footer.php ← Fermeture layout + JS │ ├── assets/ │ ├── css/ │ │ └── style.css ← 4,800+ lignes — thème light complet │ └── js/ │ └── main.js ← 700+ lignes — sidebar, modals, toasts, charts │ ├── pages/ ← 14 pages du dashboard │ ├── dashboard.php ← Tableau de bord principal │ ├── products.php ← Gestion produits (double prix) │ ├── inventory.php ← Inventaire + mouvements stock │ ├── clients.php ← Gestion clients + classement CA │ ├── sales.php ← Ventes (avec/sans facture) │ ├── comptenoir.php ← Ventes sans facture │ ├── devis.php ← Devis HT │ ├── delivery.php ← Bon de livraison HT │ ├── invoices.php ← Factures Maroc 🇲🇦 / Chine 🇨🇳 │ ├── expenses.php ← Dépenses (Cash/Banque) │ ├── reports.php ← Rapports (Ventes/Produits/Clients/P&L) │ ├── status.php ← Trésorerie (Cash vs Banque) │ ├── reminders.php ← Rappels chèques │ └── settings.php ← Paramètres + utilisateurs │ └── api/ └── export.php ← Export CSV (produits, clients, ventes, etc.)

Stack Technique

Technologies utilisées

Composant	Technologie	Détails
Backend	PHP 8.x	Pure PHP, pas de framework. PDO pour la base de données.
Base de données	MySQL 8.x	12 tables, InnoDB, clés étrangères, UTF8MB4
Frontend CSS	CSS custom	4,800+ lignes, thème light, responsive, variables CSS
Frontend JS	Vanilla JavaScript	700+ lignes, zéro dépendance (sauf Chart.js)
Graphiques	Chart.js 4.x	CDN, graphiques bar/line, tooltips MAD
Police	Inter (Google Fonts)	Weights: 300-800
Sécurité	Sessions PHP + password_hash	Prepared statements, CSRF safe, .htaccess
Devise	MAD (Dirham Marocain)	TVA 20%

Roadmap

Ce qui a été fait et ce qui est prévu

v1.0 — Core Terminé

Dashboard, Produits, Clients, Ventes, Factures, Dépenses, Rapports, Paramètres, Login animé, Installation wizard

v1.1 — Double Tarification Terminé

Prix Maroc + Chine, double facturation automatique, factures séparées dans sidebar

v1.2 — Compte Noir & Trésorerie Terminé

Vente sans facture, Compte Noir, Trésorerie Cash/Banque, Rappels chèques, Devis HT

v1.3 — Inventaire & Améliorations Terminé

Inventaire complet, mouvements stock, recherche dans ventes, bulk delete clients, mobile responsive

v2.0 — Rôles & Permissions Planifié

Admin / Manager / Staff avec accès limité par rôle. Prix achat masqué pour Staff.

v2.1 — Agent IA Planifié

Assistant IA intégré (Claude API). Poser des questions sur le business. Générer rapports automatiques. Créer produits/ventes par chat.

v2.2 — Système de Licence Planifié

Licence par client (1 an). Vérification à chaque connexion. Panel admin pour gérer les clients SaaS.

v3.0 — Multi-tenant Planifié

Une seule installation, plusieurs entreprises. Chaque client voit uniquement ses données. Facturation automatique.