Skip to content

Repository files navigation

KIPP Logo

KIPP

La caisse ultra-légère et instantanée
Application PWA de point de vente (POS) — Simple, rapide, hors-ligne

FonctionnalitésStackDéploiementDéveloppement

React Vite Tailwind CSS Dexie PWA Cloudflare Pages


✨ Fonctionnalités

  • 🛒 Caisse enregistreuse — Interface POS intuitive pour gérer vos ventes
  • 📋 Catalogue produits — Gestion complète des articles avec catégories et prix
  • 🧮 Panier intelligent — Ajout, modification, suppression d'articles en temps réel
  • 💳 Paiement — Mode de paiement flexible avec calcul automatique de la monnaie
  • 🧾 Tickets de caisse — Génération et impression de tickets de vente
  • 📊 Dashboard — Statistiques et analyse des ventes
  • 🔒 Écran de verrouillage — Sécurisation de la caisse avec code PIN employé
  • 👥 Mode multi-employés — Gestion des sessions et accès par utilisateur
  • 🌙 Thème sombre/clair — Interface adaptative
  • 📱 PWA — Installation sur mobile et tablette, utilisation hors-ligne
  • 💾 Hors-ligne — Données stockées en local avec IndexedDB (Dexie)
  • 🌐 Synchronisation — Fonctionnalités cloud disponibles avec connexion réseau

🖼️ Pages et Composants

Composant Description
Catalogue Parcourir et sélectionner des produits par catégorie
Panier Gestion du panier avec quantités et totaux
Paiement Interface de paiement avec calcul de la monnaie
Ticket Récapitulatif de la vente après paiement
Dashboard Tableau de bord avec statistiques de ventes
LockScreen Écran de verrouillage avec code PIN
NetworkStatus Indicateur de connexion réseau
Paramètres Configuration de la devise et des préférences

🛠️ Stack Technique

Technologie Usage
React 18 UI — Architecture composants
Vite 5 Bundler — Build rapide avec HMR
Tailwind CSS 3 Styles — Design utilitaire responsive
Dexie.js Base de données — IndexedDB pour le stockage local hors-ligne
Lucide React Icônes — Bibliothèque d'icônes moderne
react-hot-toast Notifications — Toasts légers et élégants
Vite PWA Service Worker — Installation mobile et cache offline
Workbox Stratégies de cache avancées

🚀 Déploiement

Application déployée sur Cloudflare Pages — statique, rapide et disponible mondialement.

# Build de production
npm run build

# Aperçu local
npm run preview

Paramètres Cloudflare Pages

Champ Valeur
Framework None
Build command npm run build
Build output directory dist
Deploy command (vide)

💻 Développement

# Cloner le projet
git clone https://github.com/idhem85/kipp.git
cd kipp

# Installer les dépendances
npm install

# Lancer le serveur de développement
npm run dev

# Build de production
npm run build

Structure du projet

src/
├── App.jsx                # Composant principal avec routage
├── main.jsx               # Point d'entrée
├── index.css              # Styles globaux
├── db.js                  # Configuration Dexie (IndexedDB)
├── components/            # Composants UI
│   ├── Catalogue.jsx     # Catalogue produits
│   ├── Panier.jsx        # Panier d'achat
│   ├── PaiementModal.jsx # Modal de paiement
│   ├── TicketModal.jsx   # Modal ticket de caisse
│   ├── Dashboard.jsx     # Tableau de bord
│   ├── LockScreen.jsx    # Écran de verrouillage
│   ├── NetworkStatus.jsx # Statut réseau
│   └── ...
├── context/               # Contextes React
│   ├── CurrencyContext.jsx # Gestion de la devise
│   └── EmployeeContext.jsx # Gestion des employés
└── data/                  # Données statiques
    └── products.js       # Produits par défaut et catégories

📄 Licence

Projet privé — Tous droits réservés.


Développé par idhem85
KIPP — La caisse ultra-légère et instantanée

About

KIPP — Application PWA de caisse enregistreuse instantanée : catalogue, panier, paiement, tickets et dashboard. Hors-ligne avec IndexedDB.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages