🌐 Proinfo83.fr - Documentation Complète

📋 Table des Matières

Vue d'ensemble
Installation
Fonctionnalités Principales
Système de Rôles et Permissions
Gestion des Factures
Gestion des Devis
Gestion des Avenants
Gestion des Clients
Gestion des Produits/Services
Gestion des Dépenses
Système de Tickets
Calendrier
Codes Promo
Téléchargements
Signature Électronique
Progressive Web App (PWA)
Portail Client
API REST
Outils Professionnels
Journal d'Audit
Extension Chrome
Sécurité
Maintenance
Support

---

🎯 Vue d'ensemble

Proinfo83.fr est une plateforme complète de gestion d'entreprise informatique comprenant :

Site web public : Présentation des services, formulaires de contact
Système d'administration complet : Gestion de factures, devis, clients, calendrier, tickets
Portail client : Accès sécurisé pour les clients à leurs documents
API REST : Intégration avec d'autres systèmes
Extension Chrome : Notifications des rendez-vous et tâches
PWA : Application installable sur mobile et desktop

---

🚀 Installation

Prérequis

PHP 7.4 ou supérieur
MySQL 5.7 ou supérieur (ou MariaDB)
Serveur web (Apache avec mod_rewrite ou Nginx)
Extensions PHP :

- PDO MySQL

- GD (pour les images)

- cURL (pour les API externes)

- OpenSSL (pour HTTPS)

Étapes d'Installation

1. Télécharger les fichiers

Tous les fichiers doivent être placés dans le répertoire web de votre serveur.

2. Configuration de la base de données

Créez une base de données MySQL via votre hébergeur
Accédez à : https://votre-domaine.com/pages/admin/
Le système vous redirigera automatiquement vers l'installation
Remplissez les informations de connexion à la base de données
Le système créera automatiquement toutes les tables nécessaires

3. Connexion initiale

URL : https://votre-domaine.com/pages/admin/
Identifiant par défaut : admin
Mot de passe par défaut : admin123

⚠️ IMPORTANT : Changez immédiatement le mot de passe après la première connexion !

4. Migrations supplémentaires

Si vous avez une installation existante, exécutez ces scripts une seule fois :

add-user-roles.php - Ajouter le système de rôles
add-quotes-amendments-tables.php - Ajouter les tables devis et avenants
add-signature-column.php - Ajouter la colonne signature
add-payment-method.php - Ajouter le mode de paiement
add-downloads-table.php - Ajouter la table téléchargements
add-calendar-table.php - Ajouter la table calendrier

5. Configuration HTTPS

Pour que la PWA fonctionne, le site doit être en HTTPS. Configurez un certificat SSL sur votre serveur.

---

✨ Fonctionnalités Principales

🔐 Authentification & Sécurité

✅ Système de connexion sécurisé avec hachage bcrypt
✅ Gestion des rôles utilisateurs (Administrateur, Gestionnaire, Lecteur)
✅ Système de permissions granulaires
✅ Sessions sécurisées avec timeout automatique (30 minutes)
✅ Protection XSS et injection SQL
✅ Journal d'audit complet

📊 Tableau de Bord

✅ Vue d'ensemble des statistiques en temps réel
✅ Statistiques de facturation (totales, en attente, payées, en retard)
✅ Statistiques de devis
✅ Statistiques de clients
✅ Liste des dernières factures et devis
✅ Actions rapides

---

👑 Système de Rôles et Permissions

Les 3 Rôles Disponibles

👑 Administrateur

Accès complet au système

✅ Gérer les utilisateurs (créer, modifier, supprimer)
✅ Créer et modifier des factures, devis, avenants
✅ Gérer les clients, produits, dépenses
✅ Accéder aux paramètres
✅ Toutes les fonctionnalités

Utilisez ce rôle pour : Les responsables qui doivent gérer l'équipe

💼 Gestionnaire (par défaut)

Gestion opérationnelle

✅ Créer et modifier des factures, devis, avenants
✅ Gérer les clients, produits, dépenses
✅ Envoyer des factures par email
✅ Générer des PDF
❌ Ne peut PAS gérer les utilisateurs
❌ Ne peut PAS accéder aux paramètres système

Utilisez ce rôle pour : Les employés qui travaillent quotidiennement

👁️ Lecteur

Consultation uniquement (lecture seule)

✅ Voir les factures, devis, clients, produits
✅ Consulter les statistiques
✅ Imprimer les documents
❌ Ne peut PAS créer ou modifier
❌ Ne peut PAS supprimer
❌ Ne peut PAS envoyer d'emails

Utilisez ce rôle pour : Les comptables, superviseurs qui doivent consulter sans modifier

Permissions par Module

|--------|:--------:|:---------------:|:----------:|

| Utilisateurs | Tout | ❌ | ❌ |

| Paramètres | Tout | ❌ | ❌ |

Installation du Système de Rôles

Si vous avez déjà des utilisateurs existants :

Accédez à : www.web.proinfo83.fr/pages/admin/add-user-roles.php
Le script ajoutera la colonne role à la table users
Votre premier utilisateur sera automatiquement défini comme Administrateur
Une fois terminé, vous pouvez supprimer le fichier add-user-roles.php

---

📄 Gestion des Factures

Fonctionnalités

✅ Création et modification de factures
✅ Numérotation automatique (FAC + Date + Numéro)
✅ Ajout de lignes multiples avec calcul automatique
✅ Calcul automatique des totaux (HT, TVA, TTC)
✅ Codes promo (remise fixe ou pourcentage)
✅ Statuts : En attente, Payée, Annulée
✅ Modes de paiement multiples (Virement, Chèque, Espèces, Carte, PayPal, Stripe, Autre)
✅ Signature électronique du client
✅ Recherche et filtrage avancés
✅ Visualisation et export PDF
✅ Envoi par email
✅ Détection des factures en retard

Format de Numérotation

```

FAC + AAAAMMJJ + NNN

Exemple : FAC20251025001

```

Modes de Paiement Disponibles

| Icône | Mode | Valeur |

|-------|------|--------|

| 🏦 | Virement bancaire | bank_transfer |

| 📝 | Chèque | check |

| 💵 | Espèces | cash |

| 💳 | Carte bancaire | credit_card |

| 🔵 | PayPal | paypal |

| 🟣 | Stripe | stripe |

| 💼 | Autre | other |

Par défaut : Virement bancaire

Créer une Facture

Allez dans Factures → Nouvelle facture
Sélectionnez un client
Ajoutez des lignes (manuellement ou via le catalogue produits)
Configurez la TVA et les codes promo si nécessaire
Sélectionnez le mode de paiement
Ajoutez la signature du client (optionnel)
Enregistrez

---

📝 Gestion des Devis

Fonctionnalités

✅ Création et modification de devis
✅ Numérotation automatique (DEV + Date + Numéro)
✅ Statuts : Brouillon, En attente, Envoyé, Accepté, Refusé, Expiré
✅ Date de validité
✅ Signature électronique
✅ Envoi par email
✅ Conversion en facture
✅ Export PDF

Format de Numérotation

```

DEV + AAAAMMJJ + NNN

Exemple : DEV20251025001

```

Workflow Typique

Créer un devis (Statut: Brouillon)
Envoyer au client (Statut: Envoyé)
Client accepte → Convertir en facture
Client refuse → Marquer comme refusé
Date expirée → Statut automatique: Expiré

---

📋 Gestion des Avenants

Fonctionnalités

✅ Création d'avenants aux contrats
✅ Numérotation automatique (AVE + Date + Numéro)
✅ Types : Modification, Addition, Résiliation, Extension
✅ Suivi des changements (ancienne/nouvelle valeur)
✅ Signature électronique
✅ Export PDF

Format de Numérotation

```

AVE + AAAAMMJJ + NNN

Exemple : AVE20251025001

```

Types d'Avenants

Modification : Changement d'une clause existante
Addition : Ajout d'une nouvelle clause
Résiliation : Résiliation du contrat
Extension : Prolongation du contrat

---

👥 Gestion des Clients

Fonctionnalités

✅ Ajout et modification de clients
✅ Informations complètes (nom, société, email, téléphone, adresse)
✅ Recherche et filtrage
✅ Suppression avec confirmation
✅ Historique des factures et devis par client

Créer un Client

Allez dans Clients → Nouveau client
Remplissez les informations
Enregistrez

---

📦 Gestion des Produits/Services

Fonctionnalités

✅ Catalogue de produits et services
✅ Catégorisation
✅ Prix unitaires avec TVA personnalisée
✅ Statut actif/inactif
✅ Ajout rapide dans les factures et devis
✅ Recherche et filtrage

Catégories Suggérées

Dépannage PC : Réparations, diagnostics
Configuration : Paramétrage logiciels, systèmes
Matériel : Vente de composants, périphériques
Formation : Cours, tutoriels
Maintenance : Abonnements, contrats
Installation : Mise en place systèmes
Conseil : Prestations de conseil

Utiliser dans une Facture

Créez une nouvelle facture
Dans la section "📝 Lignes de facture"
Utilisez le sélecteur "⚡ Ajouter rapidement un produit"
Choisissez un produit → Il s'ajoute automatiquement !
Ajustez la quantité si nécessaire

---

💰 Gestion des Dépenses

Fonctionnalités

✅ Enregistrement des dépenses
✅ Catégorisation
✅ Pièces jointes
✅ Suivi des dépenses par période
✅ Recherche et filtrage

---

🎫 Système de Tickets

Fonctionnalités

✅ Création et gestion de tickets de support
✅ Priorités (Urgent, Haute, Moyenne, Basse)
✅ Statuts (Nouveau, En cours, En attente, Résolu, Fermé)
✅ Assignation aux utilisateurs
✅ Commentaires et notes
✅ Filtres et recherche
✅ Statistiques en temps réel

Priorités

🔴 Urgent : Temps de réponse < 1h
🟠 Haute : Temps de réponse < 4h
🟡 Moyenne : Temps de réponse < 24h (par défaut)
⚪ Basse : Temps de réponse < 72h

Statuts

🆕 Nouveau : Ticket créé mais pas encore pris en charge
⏳ En cours : Ticket pris en charge et en cours de traitement
⏸️ En attente : Ticket en attente d'une réponse du client
✅ Résolu : Ticket résolu, en attente de confirmation
🔒 Fermé : Ticket définitivement fermé

Format de Numérotation

```

TICK-YYYY-NNNN

Exemple : TICK-2025-0123

```

---

📅 Calendrier

Fonctionnalités

✅ Gestion des rendez-vous et événements
✅ Vue mensuelle, hebdomadaire et quotidienne
✅ Synchronisation Google Calendar (bidirectionnelle)
✅ Synchronisation Proton Calendar
✅ Export iCal
✅ Notifications des rendez-vous à venir
✅ Rappels automatiques

Synchronisation Google Calendar

Méthode 1 : Export iCal (Recommandé)

Avantages :

✅ Aucune configuration nécessaire
✅ Fonctionne immédiatement
✅ Compatible avec tous les calendriers

Instructions :

Dans le calendrier Proinfo83 : Cliquez sur "📥 Export iCal"
Sur Google Calendar : Paramètres → Importer et exporter → Sélectionner le fichier
Choisissez le fichier .ics et importez

Fréquence recommandée : 2-3 fois par semaine

Méthode 2 : API Google Calendar (Avancé)

Avantages :

✅ Synchronisation automatique
✅ Bidirectionnelle
✅ Temps réel

Configuration :

Créez un projet dans Google Cloud Console
Activez l'API Google Calendar
Créez des identifiants OAuth
Configurez dans Proinfo83 : Calendrier → 🔄 Google Calendar
Autorisez l'accès

---

🎟️ Codes Promo

Fonctionnalités

✅ Création et gestion de codes promo
✅ Types : Remise fixe ou pourcentage
✅ Dates de validité
✅ Limite d'utilisation
✅ Suivi des utilisations
✅ Application automatique dans les factures

Créer un Code Promo

Allez dans Codes promo
Cliquez sur ➕ Nouveau code promo
Remplissez :

- Code (ex: HIVER2025)

- Type (Montant fixe ou Pourcentage)

- Valeur

- Dates de validité

- Limite d'utilisation (optionnel)

Enregistrez

Utiliser dans une Facture

Créez une facture
Dans la section Totaux, saisissez le code promo
Cliquez sur Appliquer
La remise est calculée automatiquement

---

📥 Téléchargements

Fonctionnalités

✅ Ajout de fichiers à télécharger
✅ Organisation par catégories
✅ Suivi des statistiques de téléchargement
✅ Activer/Désactiver des fichiers
✅ Gestion des permissions par rôle

Catégories Suggérées

📚 Guides
💿 Drivers
💻 Logiciels
📄 Documents
🎨 Templates
🔧 Outils

Ajouter un Fichier

Allez dans Téléchargements
Cliquez sur ➕ Ajouter un fichier
Remplissez le formulaire (titre, description, catégorie)
Sélectionnez le fichier
Enregistrez

---

✍️ Signature Électronique

Fonctionnalités

✅ Signature au doigt, stylet ou souris
✅ Canvas HTML5 600x200px
✅ Support tactile (mobile, tablette)
✅ Sauvegarde en base64 (format PNG)
✅ Affichage sur les factures et devis
✅ Inclusion dans les emails
✅ Impression optimisée

Utilisation

Créez ou modifiez une facture/devis
Scrollez jusqu'à la section "✍️ Signature du client"
Le client signe directement sur l'écran
Cliquez sur 🗑️ Effacer pour recommencer si nécessaire
Le statut indique si la signature est enregistrée
Enregistrez la facture/devis

Installation

Exécutez une seule fois : add-signature-column.php

---

📱 Progressive Web App (PWA)

Fonctionnalités

✅ Installation sur mobile et desktop
✅ Mode hors-ligne avec cache intelligent
✅ Notifications push (optionnel)
✅ Raccourcis d'application
✅ Splash screen
✅ Mises à jour automatiques

Installation

Sur Android (Chrome)

Ouvrez le site dans Chrome
Un bouton "Installer l'application" apparaît
Cliquez et confirmez
L'icône apparaît sur votre écran d'accueil

Sur iOS (Safari)

Ouvrez le site dans Safari
Tapez sur l'icône Partager
Sélectionnez "Sur l'écran d'accueil"
Confirmez

Sur Desktop (Chrome/Edge)

Cliquez sur l'icône d'installation dans la barre d'adresse
Ou Menu → "Installer Proinfo83 Admin"
Confirmez

Générer les Icônes

Ouvrez : www.web.proinfo83.fr/pages/admin/generate-icons.html
Téléchargez toutes les icônes (8 tailles)
Placez-les dans pages/admin/icons/

Tailles requises :

icon-72x72.png, icon-96x96.png, icon-128x128.png
icon-144x144.png, icon-152x152.png, icon-192x192.png
icon-384x384.png, icon-512x512.png

---

👤 Portail Client

Fonctionnalités

✅ Connexion sécurisée par email et token
✅ Consultation des factures avec statut de paiement
✅ Consultation des devis avec statut d'acceptation
✅ Statistiques personnelles
✅ Interface moderne et responsive

Accès

URL : https://www.proinfo83.fr/pages/client-portal/login.php

Système de Sécurité

Session basée sur des tokens expirables (24h)
Aucun mot de passe nécessaire
Lien de connexion unique envoyé par email

---

🔌 API REST

Endpoints Disponibles

GET /api/ - Liste tous les endpoints
GET /api/invoices - Liste des factures
GET /api/invoices/:id - Détails d'une facture
GET /api/quotes - Liste des devis
GET /api/clients - Liste des clients
GET /api/products - Liste des produits actifs
GET /api/calendar/upcoming - Rendez-vous à venir
GET /api/tickets/pending - Tickets en attente
POST /api/tickets - Créer un ticket
POST /api/webhook - Traitement des webhooks

Authentification

Utilisez une clé API dans l'en-tête :

```

X-API-Key: votre-cle-api

```

---

🛠️ Outils Professionnels

Fonctionnalités

✅ Calculateur de TVA : Convertissez entre HT et TTC
✅ Calculateur de Remise : Calculez le prix après remise
✅ Calculateur de Marge : Déterminez votre marge bénéficiaire
✅ Calculateur de Coût Horaire : Estimez votre tarif horaire idéal
✅ Convertisseur de Devise : Convertissez entre différentes devises
✅ Estimateur de Projet : Estimez le coût total d'un projet

Accès

Menu Admin → Outils (🛠️)

---

📋 Journal d'Audit

Fonctionnalités

✅ Enregistrement automatique des actions
✅ Filtres par action, utilisateur, date
✅ Historique complet des modifications
✅ Consultation des détails (avant/après)
✅ Nettoyage des anciens logs

Actions Enregistrées

Création, modification, suppression d'entités
Connexions/déconnexions
Envoi d'emails
Import/Export de données
Changements de paramètres

Accès

Menu Admin → Logs (📋)

---

🌐 Extension Chrome

Fonctionnalités

✅ Notifications automatiques pour les rendez-vous à venir (dans les 2 prochaines heures)
✅ Notifications pour les tâches urgentes et importantes
✅ Badge avec le nombre de rendez-vous et tâches en attente
✅ Interface de configuration simple
✅ Tableau de bord avec vue d'ensemble
✅ Synchronisation automatique toutes les 5 minutes

Installation

Ouvrez Chrome → chrome://extensions/
Activez le mode développeur
Chargez l'extension depuis le dossier Extension/
Configurez l'URL de l'API et la clé API

---

🔒 Sécurité

Mesures Implémentées

✅ Mots de passe : Hachage avec password_hash() (bcrypt)
✅ SQL Injection : Protection via requêtes préparées PDO
✅ XSS : Protection avec htmlspecialchars()
✅ Sessions : Régénération d'ID, timeout automatique
✅ Authentification : Vérification sur toutes les pages admin
✅ Permissions : Système de rôles et permissions granulaires
✅ Audit : Journalisation de toutes les actions importantes

Recommandations

Changez le mot de passe par défaut immédiatement
Utilisez HTTPS en production (obligatoire pour PWA)
Sauvegardez régulièrement la base de données
Limitez l'accès au dossier admin par IP si possible
Mettez à jour PHP régulièrement
Protégez les fichiers sensibles avec .htaccess

---

🔧 Maintenance

Sauvegarder la Base de Données

Via l'interface : Paramètres → Télécharger la base de données
Manuellement : Export MySQL via phpMyAdmin ou ligne de commande

Restaurer une Sauvegarde

Importez le fichier SQL dans votre base de données
Vérifiez les permissions des fichiers

Mettre à Jour

Sauvegardez la base de données
Remplacez les fichiers (sauf config-db.php)
Vérifiez les migrations nécessaires dans README/

---

📁 Structure du Projet

```

Proinfo83.fr/

├── assets/ # Ressources statiques

│ ├── css/ # Feuilles de style

│ ├── js/ # Scripts JavaScript

│ └── images/ # Images du site

│

├── pages/ # Pages du site

│ ├── admin/ # Système d'administration

│ │ ├── dashboard.php # Tableau de bord

│ │ ├── invoices.php # Gestion des factures

│ │ ├── quotes.php # Gestion des devis

│ │ ├── amendments.php # Gestion des avenants

│ │ ├── clients.php # Gestion des clients

│ │ ├── products.php # Gestion des produits

│ │ ├── expenses.php # Gestion des dépenses

│ │ ├── tickets.php # Système de tickets

│ │ ├── calendar.php # Calendrier

│ │ ├── promo-codes.php # Codes promo

│ │ ├── downloads.php # Téléchargements

│ │ ├── tools.php # Outils professionnels

│ │ ├── logs.php # Journal d'audit

│ │ ├── users.php # Gestion des utilisateurs

│ │ ├── settings.php # Paramètres

│ │ ├── api/ # API REST

│ │ └── ...

│ │

│ ├── client-portal/ # Portail client

│ ├── services/ # Pages de services

│ └── ...

│

├── Extension/ # Extension Chrome

├── README/ # Documentation

└── ...

```

---

🗄️ Base de Données

Tables Principales

Utilisateurs & Sécurité

users - Utilisateurs du système avec rôles
user_permissions - Permissions par utilisateur
audit_logs - Journal d'audit

Clients & Facturation

clients - Informations clients
invoices - Factures
invoice_items - Lignes de facture
quotes - Devis
quote_items - Lignes de devis
amendments - Avenants

Produits & Services

products - Catalogue produits/services
promo_codes - Codes promo

Support & Organisation

support_tickets - Tickets de support
ticket_comments - Commentaires tickets
calendar_events - Événements calendrier
expenses - Dépenses

Autres

downloads - Fichiers téléchargeables
client_access - Accès portail client

---

🎨 Personnalisation

Modifier les Couleurs

Éditez pages/admin/admin-style.css :

```css

:root {

--primary-color: #0ea5e9;

--secondary-color: #8b5cf6;

--success-color: #10b981;

--warning-color: #f59e0b;

--danger-color: #ef4444;

}

```

Modifier les Informations de l'Entreprise

Éditez les fichiers de visualisation (view-invoice.php, view-quote.php) et modifiez la section des informations de l'entreprise.

---

📝 Changelog

Version 2.0 (2025)

✨ Système de devis et avenants
✨ Signature électronique
✨ Calendrier avec synchronisation Google
✨ Système de tickets
✨ Gestion des dépenses
✨ Codes promo
✨ Portail client
✨ API REST
✨ Extension Chrome
✨ PWA complète
✨ Système de rôles et permissions

Version 1.0 (2024)

✨ Version initiale
✨ Gestion des factures
✨ Gestion des clients
✨ Système d'authentification
✨ Tableau de bord

---

🚀 Fonctionnalités Futures

[ ] Application mobile native
[ ] Paiement en ligne intégré
[ ] Relances automatiques par email
[ ] Statistiques avancées avec graphiques
[ ] Export Excel/CSV amélioré
[ ] Multi-sociétés
[ ] Facturation récurrente
[ ] Intégration comptable
[ ] Notifications push PWA
[ ] Background sync PWA

---

📞 Support

Pour toute question ou problème :

Email : contact@proinfo83.fr
Site web : https://proinfo83.fr
Téléphone : 06.52.49.56.73

---

📄 Licence

---

Développé avec ❤️ pour Proinfo83.fr

Documentation complète - Version 2.0 - Janvier 2025