Fixed the READMEs and small fix around the project

2026-08-19 17:36:34 +01:00
parent 121f788c28
commit a2f36b6fac
14 changed files with 495 additions and 1004 deletions
@@ -0,0 +1,94 @@
+# 📝 sld-blocknotes - Système Moderne de Notes par Blocs et Gestion de Commandes
+
+> **🌐 Langues disponibles**: [🇬🇧 English](README.md) | [🇮🇹 Italiano](README.it.md) | [🇪🇸 Español](README.es.md) | [🇫🇷 Français](README.fr.md)
+
+![PHP](https://img.shields.io/badge/PHP-7.4%20%7C%208.x-777BB4?style=for-the-badge&logo=php&logoColor=white)
+![Database](https://img.shields.io/badge/Database-MySQL%20%2F%20MariaDB-4479A1?style=for-the-badge&logo=mysql&logoColor=white)
+![Frontend](https://img.shields.io/badge/Frontend-Vanilla%20CSS%20%26%20JS-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black)
+![Framework](https://img.shields.io/badge/Framework-Zero%20Dependencies-22c55e?style=for-the-badge)
+
+Une application Web moderne et puissante, sans dépendance externe, pour organiser des notes structurées en blocs, des commandes de terminal, des extraits de code et des instructions. Développée en **Pure PHP**, **Vanilla CSS**, **Vanilla JS** et **MySQL/MariaDB**.
+
+URL du Dépôt: [https://gitea.sld-server.org/sld-admin/sld-blocknotes](https://gitea.sld-server.org/sld-admin/sld-blocknotes)
+
+---
+
+## ✨ Fonctionnalités Principales
+
+- 📑 **Notes en Blocs et Sous-notes Structurées**:
+  - Organisez vos notes au sein de blocknotes personnalisés.
+  - Les notes contiennent un titre, une description et plusieurs sous-notes.
+  - **Notes Repliables**: Les notes sont réduites par défaut pour optimiser l'espace vertical, avec des boutons globaux **Tout Développer / Tout Réduire**.
+
+- ⚡ **Sous-notes de Type Commande de Terminal**:
+  - Rendu différencié entre sous-notes de texte générique et commandes de terminal.
+  - **Bouton Copier en 1 Clic**: Copiez instantanément les commandes dans le presse-papiers avec retour visuel (`✓ Copié!`).
+  - Cadre style IDE/Terminal à haut contraste avec barre de défilement verticale.
+
+- 🔍 **Recherche en Temps Réel**:
+  - Filtrez les titres des notes, descriptions, sous-notes et contenus des commandes en temps réel au sein du blocknote ouvert.
+  - Développe automatiquement les blocs correspondants pendant la recherche.
+
+- 📥 / 💾 **Importation et Exportation JSON**:
+  - Téléchargez le fichier JSON de chaque blocknote en un clic (`export_blocknote.php`).
+  - Importateur JSON interactif compatible avec le format standard et l'ancien format tableau.
+
+- 🌐 **Interface Multilingue (IT, EN, ES, FR)**:
+  - Localisation complète en **Italien 🇮🇹, Anglais 🇬🇧, Espagnol 🇪🇸 et Français 🇫🇷**.
+  - Sélecteur de langue rapide dans la barre de navigation pour les visiteurs et utilisateurs connectés.
+  - La langue préférée de chaque utilisateur est enregistrée dans son profil pour les futures connexions.
+
+- 🏠 **Page d'Accueil Personnalisable**:
+  - Choisissez entre accéder directement au **Panneau Principal (Tous les Blocknotes)** ou ouvrir un **Blocknote par Défaut spécifique** lors de la connexion.
+
+- 👑 **Rôle Unique de Propriétaire et Hiérarchie Avancée (`owner` > `admin` > `user`)**:
+  - **Compte Propriétaire Protégé**: Le compte Propriétaire initial (`owner`) ne peut être supprimé ni par un administrateur ni par lui-même.
+  - Les administrateurs standard ne peuvent ni rétrograder ni modifier le rôle du Propriétaire.
+
+- ⚙️ **Personnalisation du Site (Exclusif Propriétaire)**:
+  - Modifiez le **Titre Global de l'Application**.
+  - Téléversez et validez un **Favicon Haute Résolution** (minimum 64x64px) avec aperçu en temps réel.
+
+- 🚀 **Assistant de Configuration Initiale (`first_start.php`)**:
+  - Installateur automatique pour configurer les identifiants MySQL, créer les tables et enregistrer les premiers utilisateurs privilégiés (`owner` et `admin`).
+  - Entièrement multilingue dans les 4 langues.
+
+---
+
+## 🚀 Guide d'Installation
+
+### Prérequis
+- Serveur Web (Apache, Nginx, ou serveur CLI intégré de PHP)
+- PHP 7.4 ou 8.x (avec extension `mysqli` activée)
+- MySQL 5.7+ or MariaDB 10.x+
+
+### Installation Étape par Étape
+
+1. **Cloner le Dépôt**:
+   ```bash
+   git clone https://gitea.sld-server.org/sld-admin/sld-blocknotes.git
+   cd sld-blocknotes
+   ```
+
+2. **Démarrer le Serveur Web**:
+   Vous pouvez utiliser le serveur CLI intégré de PHP:
+   ```bash
+   php -S localhost:8000
+   ```
+
+3. **Exécuter l'Assistant de Configuration**:
+   Ouvrez votre navigateur sur `http://localhost:8000/`.
+   Le système détectera le premier démarrage et ouvrira automatiquement `first_start.php`:
+   - Entrez les informations de votre **Base de Données MySQL** (Hôte, Nom, Utilisateur, Mot de passe).
+   - Configurez les identifiants du **Compte Propriétaire**.
+   - Configurez les identifiants du **Premier Compte Admin**.
+   - Cliquez sur **⚡ Terminer l'Installation et Configurer le Système**.
+
+4. **Se Connecter**:
+   Une fois terminé, vous serez redirigé vers la page de connexion `index.php?page=login`.
+
+---
+
+## 📄 Licence
+
+Ce projet est distribué sous licence open-source [MIT License](LICENSE).